From 2c099c9ac6d5d83f0b5bba1ba00104a41b3a26c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Wed, 18 Nov 2026 12:50:28 -0500 Subject: [PATCH 01/11] feat(angular)!: return config providers from define helpers Factory-created component classes cannot be resolved statically in standalone imports under Angular AOT (NG1010). Return providers for the new MARKDOWN_CONFIG and MARKDOWN_DOCUMENT_CONFIG tokens instead. Static Markdown and MarkdownDocument components consume the tokens and merge config with per-instance inputs. --- AGENTS.md | 3 +- docs/content/3.rendering/7.angular.md | 57 +++--- docs/content/5.reference/3.reference.md | 2 + .../comark/references/rendering-angular.md | 50 ++--- .../angular/src/app/pages/syntax.component.ts | 29 ++- .../components/markdown-document.component.ts | 21 ++- .../src/components/markdown.component.ts | 35 +++- packages/comark-angular/src/config.ts | 28 +++ packages/comark-angular/src/define.ts | 177 ++++++------------ packages/comark-angular/src/index.ts | 2 + .../test/define-component.test.ts | 93 ++++----- .../test/provider-config.test.ts | 123 ++++++++++++ packages/comark-angular/test/reparse.test.ts | 11 +- 13 files changed, 380 insertions(+), 251 deletions(-) create mode 100644 packages/comark-angular/src/config.ts create mode 100644 packages/comark-angular/test/provider-config.test.ts diff --git a/AGENTS.md b/AGENTS.md index 4af0f2e98..c53cedfa0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -154,6 +154,7 @@ Svelte 5 renderer (`Markdown`, `MarkdownDocument`, `MarkdownNode`) plus experime Angular 21+ renderer (peer range `>=21 <23`) with standalone components (`Markdown` selector `comark-markdown`, `MarkdownDocument`, `defineMarkdownComponent`, `defineMarkdownDocumentComponent`). +- `defineMarkdownComponent` / `defineMarkdownDocumentComponent` return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG` (`src/config.ts`). The static `Markdown` / `MarkdownDocument` components inject those tokens optionally. Never return a component class from a factory: AOT cannot resolve it in `imports` (NG1010 / ngtsc -991010). - Built with `ng-packagr` (`ng build`), then `scripts/strip-sourcemaps.mjs` removes emitted source maps and `scripts/sync-plugins.mjs` writes plain plugin re-exports and `./plugins/*` export map entries into `dist/package.json`. - Plugin entry points use **named exports** because the Angular Package Format strips `export default` (`import { math, Math } from '@comark/angular/plugins/math'`, `import { security } from '@comark/angular/plugins/security'`). - Publishes from `dist/` via `publishConfig.directory`; `test/bundle.test.ts` packs from `dist/` too. @@ -217,7 +218,7 @@ import { createAnsiRenderer, createAnsiPrinter, printAnsi, renderAnsi, renderAns import { Markdown, MarkdownDocument, defineMarkdownComponent } from '@comark/vue' // also @comark/react import { Markdown, MarkdownDocument } from '@comark/svelte' import { MarkdownAsync } from '@comark/svelte/async' -import { Markdown, MarkdownDocument, defineMarkdownComponent } from '@comark/angular' +import { Markdown, MarkdownDocument, defineMarkdownComponent, MARKDOWN_CONFIG } from '@comark/angular' import math, { Math } from '@comark/vue/plugins/math' // same shape in html, react, svelte (`{ math, Math }` in angular) import mermaid, { Mermaid } from '@comark/vue/plugins/mermaid' import binding, { Binding, If } from '@comark/vue/plugins/binding' diff --git a/docs/content/3.rendering/7.angular.md b/docs/content/3.rendering/7.angular.md index 52a88da51..6f8931657 100644 --- a/docs/content/3.rendering/7.angular.md +++ b/docs/content/3.rendering/7.angular.md @@ -544,54 +544,61 @@ export class HeadingComponent { ## Pre-configured components -Use `defineMarkdownComponent` and `defineMarkdownDocumentComponent` to create pre-configured wrappers with default plugins, components, and styling. +Use `defineMarkdownComponent` and `defineMarkdownDocumentComponent` to pre-configure plugins, component mappings, styling, and node transforms. Both helpers return an Angular `Provider`, not a component class. Import the static `Markdown` or `MarkdownDocument` component in `imports`, then add the provider in `providers`. This keeps the component statically analyzable: factory-created component classes in `imports` fail AOT compilation with NG1010 (ngtsc error -991010). ### `defineMarkdownComponent` -```typescript [components/docs-markdown.ts] -import { defineMarkdownComponent } from '@comark/angular' +```typescript [page.component.ts] +import { Component } from '@angular/core' +import { Markdown, defineMarkdownComponent } from '@comark/angular' import shiki from '@comark/angular/plugins/shiki' import { math, Math } from '@comark/angular/plugins/math' import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' -export const DocsMarkdown = defineMarkdownComponent({ - plugins: [shiki(), math(), mermaid()], - components: { Math, Mermaid }, - class: 'prose dark:prose-invert', -}) -``` - -Then use it like any other component. The returned component always uses the `comark-markdown-defined` selector: - -```typescript [page.component.ts] -import { Component } from '@angular/core' -import { DocsMarkdown } from './components/docs-markdown' - @Component({ selector: 'app-page', standalone: true, - imports: [DocsMarkdown], - template: ``, + imports: [Markdown], + providers: [ + defineMarkdownComponent({ + plugins: [shiki(), math(), mermaid()], + components: { Math, Mermaid }, + class: 'prose dark:prose-invert', + }), + ], + template: ``, }) export class PageComponent { content = '# Hello\n\n$E = mc^2$' } ``` -Instance-level `[plugins]` and `[components]` inputs are merged with (and override) the config-level defaults. Both `defineMarkdownComponent` and `defineMarkdownDocumentComponent` also accept `transformNode`, which runs before the instance's `[transformNode]` input. +The provider can also be scoped to a route or an ancestor component. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the provider config and win on conflict. Config plugins run before instance plugins and are deduplicated by name. `transformNode` from the config runs before the instance's own `transformNode`. ### `defineMarkdownDocumentComponent` -Creates a pre-configured `` component. The returned component always uses the `comark-markdown-document-defined` selector: +Pre-configure the low-level renderer the same way: -```typescript [components/docs-markdown-document.ts] -import { defineMarkdownDocumentComponent } from '@comark/angular' +```typescript [page.component.ts] +import { Component } from '@angular/core' +import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' -export const DocsMarkdownDocument = defineMarkdownDocumentComponent({ - components: { Math }, - class: 'prose', +@Component({ + selector: 'app-page', + standalone: true, + imports: [MarkdownDocument], + providers: [ + defineMarkdownDocumentComponent({ + components: { Math }, + class: 'prose', + }), + ], + template: ``, }) +export class PageComponent {} ``` +The underlying `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG` tokens are exported for custom providers and overrides. + --- diff --git a/docs/content/5.reference/3.reference.md b/docs/content/5.reference/3.reference.md index 0be0e498c..9ed3c5d3b 100644 --- a/docs/content/5.reference/3.reference.md +++ b/docs/content/5.reference/3.reference.md @@ -251,6 +251,8 @@ export const AppMarkdown = defineMarkdownComponent({ }) ``` +> In `@comark/angular`, both helpers return a config `Provider` instead of a component class. Import the static `Markdown` or `MarkdownDocument` component in `imports` and put the helper result in `providers`. See the [Angular renderer guide](/rendering/angular#pre-configured-components). + ## Transforming nodes before render `transformNode` lets you change the tag or props of an element node right before it renders, based on its props and the render context. Use it when a value is only known at render time, such as runtime `data`, and `components` alone can't express the change. diff --git a/docs/skills/comark/references/rendering-angular.md b/docs/skills/comark/references/rendering-angular.md index 3fa55117f..c6625eb05 100644 --- a/docs/skills/comark/references/rendering-angular.md +++ b/docs/skills/comark/references/rendering-angular.md @@ -479,53 +479,55 @@ export class AppComponent { ## Pre-configured components -Use `defineMarkdownComponent` or `defineMarkdownDocumentComponent` to create pre-configured components with default plugins and component mappings: +Use `defineMarkdownComponent` or `defineMarkdownDocumentComponent` to pre-configure plugins, component mappings, styling, and node transforms. Each helper returns an Angular `Provider`. Import the static `Markdown` or `MarkdownDocument` component in `imports`; a component class made by a runtime factory cannot be statically resolved in `imports` and fails AOT builds with NG1010. ### defineMarkdownComponent ```typescript -// docs-markdown.component.ts -import { defineMarkdownComponent } from '@comark/angular' +import { Component } from '@angular/core' +import { Markdown, defineMarkdownComponent } from '@comark/angular' import { math, Math } from '@comark/angular/plugins/math' import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' -export const DocsMarkdown = defineMarkdownComponent({ - plugins: [math(), mermaid()], - components: { Math, Mermaid }, - class: 'prose dark:prose-invert', -}) -``` - -Use the pre-configured component: - -```typescript -import { Component } from '@angular/core' -import { DocsMarkdown } from './docs-markdown.component' - @Component({ selector: 'app-docs', standalone: true, - imports: [DocsMarkdown], - template: ` - - `, + imports: [Markdown], + providers: [ + defineMarkdownComponent({ + plugins: [math(), mermaid()], + components: { Math, Mermaid }, + class: 'prose dark:prose-invert', + }), + ], + template: ``, }) export class DocsComponent { content = '# Math: $E = mc^2$' } ``` -Instance-level `components` and `plugins` are merged with the config-level defaults at runtime. +Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the provider config and win on conflict. Config plugins run first and are deduplicated by name. Config `transformNode` runs before the instance's own transform. ### defineMarkdownDocumentComponent ```typescript -import { defineMarkdownDocumentComponent } from '@comark/angular' +import { Component } from '@angular/core' +import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' -export const DocsMarkdownDocument = defineMarkdownDocumentComponent({ - components: { Math }, +@Component({ + selector: 'app-docs', + standalone: true, + imports: [MarkdownDocument], + providers: [ + defineMarkdownDocumentComponent({ + components: { Math }, + }), + ], + template: ``, }) +export class DocsComponent {} ``` --- diff --git a/examples/2.vite/angular/src/app/pages/syntax.component.ts b/examples/2.vite/angular/src/app/pages/syntax.component.ts index f94f93a07..33c190887 100644 --- a/examples/2.vite/angular/src/app/pages/syntax.component.ts +++ b/examples/2.vite/angular/src/app/pages/syntax.component.ts @@ -1,5 +1,5 @@ import { Component } from '@angular/core' -import { Markdown } from '@comark/angular' +import { Markdown, defineMarkdownComponent } from '@comark/angular' import shiki from 'comark/plugins/shiki' import alert from 'comark/plugins/alert' import { AlertComponent } from '../components/alert.component' @@ -10,23 +10,20 @@ import python from '@shikijs/langs/python' selector: 'app-syntax', standalone: true, imports: [Markdown], - template: ` - - `, + providers: [ + defineMarkdownComponent({ + plugins: [ + shiki({ + languages: [python], + }), + alert(), + ], + components: { alert: AlertComponent, 'feature-card': FeatureCardComponent }, + }), + ], + template: ``, }) export class SyntaxComponent { - components = { alert: AlertComponent, 'feature-card': FeatureCardComponent } - plugins = [ - shiki({ - languages: [python], - }), - alert(), - ] - markdown = ` # Comark Syntax Showcase diff --git a/packages/comark-angular/src/components/markdown-document.component.ts b/packages/comark-angular/src/components/markdown-document.component.ts index 89acb4f5a..8ae6566d5 100644 --- a/packages/comark-angular/src/components/markdown-document.component.ts +++ b/packages/comark-angular/src/components/markdown-document.component.ts @@ -3,12 +3,16 @@ import { ChangeDetectionStrategy, ChangeDetectorRef, Type, + computed, inject, type OnInit, type OnDestroy, input, } from '@angular/core' import type { ElementNode, Node, MarkdownDocument as MarkdownDocumentType, NodeRenderData, NodeTransform } from 'comark' +import { mergeNodeTransforms } from 'comark/utils' +import { MARKDOWN_DOCUMENT_CONFIG } from '../config' +import type { MarkdownDocumentConfig } from '../config' import { MarkdownNode } from './markdown-node.component' import { findLastTextNodeAndAppendNode, getCaret } from '../utils/caret' @@ -31,20 +35,25 @@ const EMPTY_DOCUMENT: MarkdownDocumentType = { nodes: [], frontmatter: {}, meta: standalone: true, imports: [MarkdownNode], changeDetection: ChangeDetectionStrategy.OnPush, + host: { + '[class]': 'config?.class ?? ""', + }, template: `
@for (node of renderedNodes; track $index) { }
`, }) export class MarkdownDocument implements OnInit, OnDestroy { + protected readonly config: MarkdownDocumentConfig | null = inject(MARKDOWN_DOCUMENT_CONFIG, { optional: true }) + /** The parsed Markdown document to render */ readonly value = input() @@ -63,6 +72,14 @@ export class MarkdownDocument implements OnInit, OnDestroy { /** Change the tag or props of element nodes just before they render */ readonly transformNode = input() + /** Config-level and instance-level components merged, instance wins. */ + protected readonly mergedComponents = computed(() => ({ ...(this.config?.components ?? {}), ...this.components() })) + + /** Config-level transforms run before the instance's own transforms. */ + protected readonly mergedTransforms = computed(() => + mergeNodeTransforms(this.config?.transformNode, this.transformNode()) + ) + /** * Document key used to subscribe to live updates via `globalThis.comarkContext`. * Falls back to the document's own `meta.key` when set by a plugin. diff --git a/packages/comark-angular/src/components/markdown.component.ts b/packages/comark-angular/src/components/markdown.component.ts index 134465319..68c75382f 100644 --- a/packages/comark-angular/src/components/markdown.component.ts +++ b/packages/comark-angular/src/components/markdown.component.ts @@ -11,7 +11,9 @@ import { } from '@angular/core' import { createSerializedMarkdownParser } from 'comark' import type { ParserOptions, MarkdownDocument as MarkdownDocumentType, NodeTransform } from 'comark' -import { isMarkdownDocument } from 'comark/utils' +import { isMarkdownDocument, mergeNodeTransforms } from 'comark/utils' +import { MARKDOWN_CONFIG } from '../config' +import type { MarkdownConfig } from '../config' import { MarkdownDocument } from './markdown-document.component' /** @@ -28,20 +30,25 @@ import { MarkdownDocument } from './markdown-document.component' standalone: true, imports: [MarkdownDocument], changeDetection: ChangeDetectionStrategy.OnPush, + host: { + '[class]': 'config?.class ?? ""', + }, template: ` @if (document) { } `, }) export class Markdown { + protected readonly config: MarkdownConfig | null = inject(MARKDOWN_CONFIG, { optional: true }) + /** The markdown content to parse and render, or a pre-parsed MarkdownDocument */ readonly value = input() @@ -76,6 +83,14 @@ export class Markdown { /** Change the tag or props of element nodes just before they render */ readonly transformNode = input() + /** Config-level and instance-level components merged, instance wins. */ + protected readonly mergedComponents = computed(() => ({ ...(this.config?.components ?? {}), ...this.components() })) + + /** Config-level transforms run before the instance's own transforms. */ + protected readonly mergedTransforms = computed(() => + mergeNodeTransforms(this.config?.transformNode, this.transformNode()) + ) + document: MarkdownDocumentType | null = null private cdr = inject(ChangeDetectorRef) @@ -83,14 +98,22 @@ export class Markdown { /** * Compose the parse options consumed by the serialized parser. * - * Subclasses (e.g. `defineMarkdownComponent`) override this to merge - * config-level defaults without mutating the `options`/`plugins` inputs. + * Config defaults are merged under the instance inputs so instance values + * win without mutating the input signals. Plugins are deduplicated by name. */ protected getParserOptions(): ParserOptions { + const names = new Set() + const plugins = [...(this.config?.plugins ?? []), ...(this.plugins() ?? [])].filter((plugin) => { + if (names.has(plugin.name)) return false + names.add(plugin.name) + return true + }) + return { + ...(this.config?.options ?? {}), ...this.options(), ...(this.unwrap() ? { unwrap: this.unwrap() } : {}), - plugins: this.plugins(), + plugins, } } diff --git a/packages/comark-angular/src/config.ts b/packages/comark-angular/src/config.ts new file mode 100644 index 000000000..22220b910 --- /dev/null +++ b/packages/comark-angular/src/config.ts @@ -0,0 +1,28 @@ +import { InjectionToken } from '@angular/core' +import type { Type } from '@angular/core' +import type { NodeTransform, ParserOptions } from 'comark' + +export interface MarkdownConfig { + /** Parser options, excluding plugins. */ + options?: Omit + /** Parser plugins. */ + plugins?: ParserOptions['plugins'] + /** Pre-configured component mappings. */ + components?: Record> + /** Node transforms that run before the instance's own `transformNode`. */ + transformNode?: NodeTransform | readonly NodeTransform[] + /** Additional CSS class for the wrapper. */ + class?: string +} + +export interface MarkdownDocumentConfig { + /** Pre-configured component mappings. */ + components?: Record> + /** Node transforms that run before the instance's own `transformNode`. */ + transformNode?: NodeTransform | readonly NodeTransform[] + /** Additional CSS class for the wrapper. */ + class?: string +} + +export const MARKDOWN_CONFIG = new InjectionToken('comark.MARKDOWN_CONFIG') +export const MARKDOWN_DOCUMENT_CONFIG = new InjectionToken('comark.MARKDOWN_DOCUMENT_CONFIG') diff --git a/packages/comark-angular/src/define.ts b/packages/comark-angular/src/define.ts index 79a2c18a1..2115eb478 100644 --- a/packages/comark-angular/src/define.ts +++ b/packages/comark-angular/src/define.ts @@ -1,8 +1,7 @@ -import { Component, ChangeDetectionStrategy, Type, input, computed } from '@angular/core' +import type { Provider, Type } from '@angular/core' import type { NodeTransform, ParserOptions } from 'comark' -import { mergeNodeTransforms } from 'comark/utils' -import { Markdown } from './components/markdown.component' -import { MarkdownDocument } from './components/markdown-document.component' +import { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from './config' +import type { MarkdownConfig, MarkdownDocumentConfig } from './config' export interface DefineMarkdownComponentOptions extends ParserOptions { /** Pre-configured component mappings. */ @@ -23,24 +22,38 @@ export interface DefineMarkdownDocumentOptions { } /** - * Create a pre-configured Markdown component with default options, plugins, and components. + * Configure the static `Markdown` component through Angular DI. * - * The returned class extends `Markdown` and merges the config-level - * defaults with any per-instance `@Input()` values at runtime. + * Returns a config Provider for `MARKDOWN_CONFIG`. The `Markdown` component is + * declared statically, so it stays analyzable by the Angular AOT compiler and + * can be used in `imports`. AOT cannot statically resolve a component class + * created by a factory function (ngtsc error -991010 / NG1010). * * @example * ```typescript - * import { defineMarkdownComponent } from '@comark/angular' + * import { Component } from '@angular/core' + * import { Markdown, defineMarkdownComponent } from '@comark/angular' * import { math, Math } from '@comark/angular/plugins/math' * - * export const DocsMarkdown = defineMarkdownComponent({ - * plugins: [math()], - * components: { Math }, - * class: 'prose dark:prose-invert', + * @Component({ + * selector: 'app-docs', + * standalone: true, + * imports: [Markdown], + * providers: [ + * defineMarkdownComponent({ + * plugins: [math()], + * components: { Math }, + * class: 'prose dark:prose-invert', + * }), + * ], + * template: ``, * }) + * export class DocsComponent { + * content = '# Hello' + * } * ``` */ -export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = {}): Type { +export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = {}): Provider { const { components: configComponents = {}, class: configClass, @@ -49,119 +62,53 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = ...parseOptions } = config - @Component({ - selector: 'comark-markdown-defined', - standalone: true, - imports: [MarkdownDocument], - changeDetection: ChangeDetectionStrategy.OnPush, - template: ` - @if (document) { - - } - `, - host: { - '[class]': 'hostClass', - }, - }) - class DefinedMarkdownComponent extends Markdown { - /** Instance-level components that are merged with config-level components. */ - override readonly components = input>>({}) - - protected readonly mergedComponents = computed(() => ({ ...configComponents, ...this.components() })) - - protected readonly mergedTransforms = computed(() => mergeNodeTransforms(configTransforms, this.transformNode())) - - get hostClass(): string { - return configClass || '' - } - - /** - * Effective plugins: config-level plugins first, then instance plugins, - * deduplicated by plugin name so a plugin supplied by both runs once. - */ - private readonly effectivePlugins = computed(() => { - const names = new Set() - return [...configPlugins, ...(this.plugins() ?? [])].filter((plugin) => { - if (names.has(plugin.name)) return false - names.add(plugin.name) - return true - }) - }) - - /** - * Merge config-level parse options under the instance `options` input so - * instance values override config defaults, without writing back to the - * input signal (the parser consumes the derived value instead). - */ - protected override getParserOptions(): ParserOptions { - return { - ...parseOptions, - ...this.options(), - ...(this.unwrap() ? { unwrap: this.unwrap() } : {}), - plugins: this.effectivePlugins(), - } - } + return { + provide: MARKDOWN_CONFIG, + useValue: { + options: parseOptions, + plugins: configPlugins, + components: configComponents, + transformNode: configTransforms, + class: configClass, + } satisfies MarkdownConfig, } - - return DefinedMarkdownComponent as any } /** - * Create a pre-configured MarkdownDocument component with default component mappings. + * Configure the static `MarkdownDocument` component through Angular DI. + * + * Returns a config Provider for `MARKDOWN_DOCUMENT_CONFIG`, which the static + * `MarkdownDocument` component reads to pre-configure components and styling. * * @example * ```typescript - * import { defineMarkdownDocumentComponent } from '@comark/angular' + * import { Component } from '@angular/core' + * import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' * import { Math } from '@comark/angular/plugins/math' * - * export const DocsRenderer = defineMarkdownDocumentComponent({ - * components: { Math }, + * @Component({ + * selector: 'app-docs', + * standalone: true, + * imports: [MarkdownDocument], + * providers: [ + * defineMarkdownDocumentComponent({ + * components: { Math }, + * }), + * ], + * template: ``, * }) + * export class DocsComponent {} * ``` */ -export function defineMarkdownDocumentComponent(config: DefineMarkdownDocumentOptions = {}): Type { - const { components: configComponents = {}, class: configClass } = config - - @Component({ - selector: 'comark-markdown-document-defined', - standalone: true, - imports: [MarkdownDocument], - changeDetection: ChangeDetectionStrategy.OnPush, - template: ` - - `, - host: { - '[class]': 'hostClass', - }, - }) - class DefinedMarkdownDocumentComponent extends MarkdownDocument { - /** Instance-level components that are merged with config-level components. */ - override readonly components = input>>({}) - - protected readonly mergedComponents = computed(() => ({ ...configComponents, ...this.components() })) - - protected readonly mergedTransforms = computed(() => - mergeNodeTransforms(config.transformNode, this.transformNode()) - ) - - get hostClass(): string { - return configClass || '' - } +export function defineMarkdownDocumentComponent(config: DefineMarkdownDocumentOptions = {}): Provider { + const { components: configComponents = {}, class: configClass, transformNode: configTransforms } = config + + return { + provide: MARKDOWN_DOCUMENT_CONFIG, + useValue: { + components: configComponents, + transformNode: configTransforms, + class: configClass, + } satisfies MarkdownDocumentConfig, } - - return DefinedMarkdownDocumentComponent as any } diff --git a/packages/comark-angular/src/index.ts b/packages/comark-angular/src/index.ts index 8761a72bd..d4cc40bb5 100644 --- a/packages/comark-angular/src/index.ts +++ b/packages/comark-angular/src/index.ts @@ -3,5 +3,7 @@ export { MarkdownDocument } from './components/markdown-document.component' export { MarkdownNode } from './components/markdown-node.component' export { defineMarkdownComponent, defineMarkdownDocumentComponent } from './define' export type { DefineMarkdownComponentOptions, DefineMarkdownDocumentOptions } from './define' +export { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from './config' +export type { MarkdownConfig, MarkdownDocumentConfig } from './config' export type * from 'comark' diff --git a/packages/comark-angular/test/define-component.test.ts b/packages/comark-angular/test/define-component.test.ts index 8ef18c54b..57ff7b50a 100644 --- a/packages/comark-angular/test/define-component.test.ts +++ b/packages/comark-angular/test/define-component.test.ts @@ -1,75 +1,56 @@ import { describe, expect, it } from 'vitest' +import type { ValueProvider } from '@angular/core' +import type { NodeTransform } from 'comark' import { defineMarkdownComponent, defineMarkdownDocumentComponent } from '../src/define.ts' +import { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from '../src/config.ts' describe('defineMarkdownComponent', () => { - it('returns a component class', () => { - const Defined = defineMarkdownComponent({}) - expect(Defined).toBeDefined() - expect(typeof Defined).toBe('function') - }) - - it('returns a component class with default config', () => { - const Defined = defineMarkdownComponent() - expect(Defined).toBeDefined() - expect(typeof Defined).toBe('function') - }) - - it('accepts plugins in config', () => { - const fakePlugin = { name: 'test', setup: () => {} } - const Defined = defineMarkdownComponent({ - plugins: [fakePlugin as any], - }) - expect(Defined).toBeDefined() - }) + it('returns a MARKDOWN_CONFIG provider with defaults and overrides', () => { + const empty = defineMarkdownComponent() as ValueProvider + expect(empty.provide).toBe(MARKDOWN_CONFIG) + expect(empty.useValue).toMatchObject({ options: {}, plugins: [], components: {} }) - it('accepts components in config', () => { + const plugin = { name: 'test', setup: () => {} } + const transformNode: NodeTransform = () => undefined class FakeComponent {} - const Defined = defineMarkdownComponent({ - components: { alert: FakeComponent as any }, - }) - expect(Defined).toBeDefined() - }) - - it('accepts class in config', () => { - const Defined = defineMarkdownComponent({ - class: 'prose dark:prose-invert', - }) - expect(Defined).toBeDefined() - }) - - it('accepts parse options in config', () => { - const Defined = defineMarkdownComponent({ + const provider = defineMarkdownComponent({ + plugins: [plugin as any], + components: { alert: FakeComponent }, + class: 'prose', autoClose: true, - autoUnwrap: false, + transformNode, + }) as ValueProvider + + expect(provider.provide).toBe(MARKDOWN_CONFIG) + expect(provider.useValue).toEqual({ + options: { autoClose: true }, + plugins: [plugin], + components: { alert: FakeComponent }, + transformNode, + class: 'prose', }) - expect(Defined).toBeDefined() }) }) describe('defineMarkdownDocumentComponent', () => { - it('returns a component class', () => { - const Defined = defineMarkdownDocumentComponent({}) - expect(Defined).toBeDefined() - expect(typeof Defined).toBe('function') - }) + it('returns a MARKDOWN_DOCUMENT_CONFIG provider with defaults and overrides', () => { + const empty = defineMarkdownDocumentComponent() as ValueProvider + expect(empty.provide).toBe(MARKDOWN_DOCUMENT_CONFIG) + expect(empty.useValue.components).toEqual({}) - it('returns a component class with default config', () => { - const Defined = defineMarkdownDocumentComponent() - expect(Defined).toBeDefined() - }) - - it('accepts components in config', () => { + const transformNode: NodeTransform = () => undefined class FakeComponent {} - const Defined = defineMarkdownDocumentComponent({ - components: { Math: FakeComponent as any }, - }) - expect(Defined).toBeDefined() - }) + const provider = defineMarkdownDocumentComponent({ + components: { Math: FakeComponent }, + class: 'prose', + transformNode, + }) as ValueProvider - it('accepts class in config', () => { - const Defined = defineMarkdownDocumentComponent({ + expect(provider.provide).toBe(MARKDOWN_DOCUMENT_CONFIG) + expect(provider.useValue).toEqual({ + components: { Math: FakeComponent }, class: 'prose', + transformNode, }) - expect(Defined).toBeDefined() }) }) diff --git a/packages/comark-angular/test/provider-config.test.ts b/packages/comark-angular/test/provider-config.test.ts new file mode 100644 index 000000000..1eb5e3389 --- /dev/null +++ b/packages/comark-angular/test/provider-config.test.ts @@ -0,0 +1,123 @@ +import '@angular/compiler' +import { beforeEach, describe, expect, it, vi } from 'vitest' +import { Component, provideZonelessChangeDetection, type Provider, type Type } from '@angular/core' +import { TestBed } from '@angular/core/testing' +import { bootstrapApplication } from '@angular/platform-browser' +import { renderApplication } from '@angular/platform-server' +import { parseMarkdown, type NodeTransform } from 'comark' +import emoji from 'comark/plugins/emoji' +import { Markdown } from '../src/components/markdown.component.ts' +import { MarkdownDocument } from '../src/components/markdown-document.component.ts' +import { defineMarkdownComponent, defineMarkdownDocumentComponent } from '../src/define.ts' + +@Component({ + selector: 'app-config-alert', + standalone: true, + template: '', +}) +class ConfigAlert {} + +@Component({ + selector: 'app-instance-alert', + standalone: true, + template: '', +}) +class InstanceAlert {} + +function renderApp(App: Type): Promise { + return renderApplication( + (context) => bootstrapApplication(App, { providers: [provideZonelessChangeDetection()] }, context), + { document: '' } + ) +} + +function app(options: { imports: Type[]; providers?: Provider[]; template: string }): any { + class App {} + Component({ + selector: 'app-root', + standalone: true, + imports: options.imports, + providers: options.providers, + template: options.template, + })(App) + return App +} + +async function renderMarkdown( + value: string, + providers: Provider[], + components?: Record> +): Promise { + await TestBed.configureTestingModule({ imports: [Markdown], providers }).compileComponents() + const fixture = TestBed.createComponent(Markdown) + fixture.componentRef.setInput('value', value) + if (components) fixture.componentRef.setInput('components', components) + fixture.detectChanges() + await vi.waitFor(() => { + expect(fixture.componentInstance.document).not.toBeNull() + fixture.detectChanges() + }) + return fixture.nativeElement.outerHTML as string +} + +describe('Markdown config providers', () => { + beforeEach(() => TestBed.resetTestingModule()) + + it('applies config plugins, components, and class to static Markdown', async () => { + const html = await renderMarkdown('::alert\n:smile:\n::', [ + defineMarkdownComponent({ + plugins: [emoji()], + components: { alert: ConfigAlert }, + class: 'config-class', + }), + ]) + + expect(html).toContain('config-class') + expect(html).toContain('config-alert') + expect(html).toContain('😄') + }) + + it('lets instance inputs override config components', async () => { + const html = await renderMarkdown( + '::alert\nHello\n::', + [defineMarkdownComponent({ components: { alert: ConfigAlert } })], + { alert: InstanceAlert } + ) + + expect(html).toContain('instance-alert') + expect(html).not.toContain('config-alert') + }) + + it('runs config transformNode before the instance transformNode', async () => { + const document = await parseMarkdown('Hello') + const App = app({ + imports: [MarkdownDocument], + providers: [ + defineMarkdownDocumentComponent({ + class: 'document-class', + transformNode: ({ tag }) => (tag === 'p' ? { tag: 'section' } : undefined), + }), + ], + template: '', + }) + const instanceTransform: NodeTransform = ({ tag }) => (tag === 'section' ? { tag: 'article' } : undefined) + App.prototype.document = document + App.prototype.transformNode = instanceTransform + + const html = await renderApp(App) + expect(html).toContain('document-class') + expect(html).toContain('
Hello
') + }) + + it('works without a provider', async () => { + const document = await parseMarkdown('Hello') + const App = app({ + imports: [MarkdownDocument], + template: '', + }) + App.prototype.document = document + + const html = await renderApp(App) + expect(html).toContain('

Hello

') + }) +}) diff --git a/packages/comark-angular/test/reparse.test.ts b/packages/comark-angular/test/reparse.test.ts index 594ee8ad3..5435a7fb2 100644 --- a/packages/comark-angular/test/reparse.test.ts +++ b/packages/comark-angular/test/reparse.test.ts @@ -1,6 +1,6 @@ import { describe, expect, it, vi, beforeEach } from 'vitest' import { TestBed } from '@angular/core/testing' -import type { Type } from '@angular/core' +import type { Provider, Type } from '@angular/core' import { Markdown } from '../src/components/markdown.component.ts' import { defineMarkdownComponent } from '../src/define.ts' @@ -9,8 +9,8 @@ describe('Markdown re-parses when parser inputs change', () => { TestBed.resetTestingModule() }) - async function render(component: Type) { - await TestBed.configureTestingModule({ imports: [component] }).compileComponents() + async function render(component: Type, providers: Provider[] = []) { + await TestBed.configureTestingModule({ imports: [component], providers }).compileComponents() const fixture = TestBed.createComponent(component) fixture.componentRef.setInput('value', 'Hello **world**') fixture.detectChanges() @@ -49,9 +49,8 @@ describe('Markdown re-parses when parser inputs change', () => { }) }) - it('re-parses a defineMarkdownComponent when `unwrap` changes', async () => { - const Defined = defineMarkdownComponent({}) - const fixture = await render(Defined) + it('re-parses with a defineMarkdownComponent config provider when `unwrap` changes', async () => { + const fixture = await render(Markdown, [defineMarkdownComponent({})]) expect(fixture.nativeElement.querySelector('p')).not.toBeNull() fixture.componentRef.setInput('unwrap', true) From f88fc68592b3f88f91b318eaaf57358e7006fceb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:06:11 -0500 Subject: [PATCH 02/11] test: update angular bundle size snapshot --- test/bundle.test.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/bundle.test.ts b/test/bundle.test.ts index 8f1c90112..6bfd9af56 100644 --- a/test/bundle.test.ts +++ b/test/bundle.test.ts @@ -70,7 +70,7 @@ describe('package bundle size', { timeout: 60_000 }, () => { expect(report).toMatchInlineSnapshot(` { - "@comark/angular": "70.1k (63 files)", + "@comark/angular": "68.9k (63 files)", "@comark/ansi": "42.1k (109 files)", "@comark/html": "17.7k (69 files)", "@comark/nuxt": "11.0k (69 files)", From c29c1ca91375dde3057e732346963cc13e892761 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:28:25 -0500 Subject: [PATCH 03/11] fix(angular): honor instance overrides in provider config --- docs/content/3.rendering/7.angular.md | 11 +++-- .../comark/references/rendering-angular.md | 7 ++- .../src/components/markdown.component.ts | 26 ++++++---- packages/comark-angular/src/define.ts | 5 +- .../test/provider-config.test.ts | 49 ++++++++++++++++++- test/bundle.test.ts | 2 +- 6 files changed, 80 insertions(+), 20 deletions(-) diff --git a/docs/content/3.rendering/7.angular.md b/docs/content/3.rendering/7.angular.md index 6f8931657..d5fdeec33 100644 --- a/docs/content/3.rendering/7.angular.md +++ b/docs/content/3.rendering/7.angular.md @@ -110,7 +110,7 @@ See [ComarkPlugin](/plugins) for available plugins. ```typescript [app.component.ts] import { Component } from '@angular/core' import { Markdown } from '@comark/angular' -import shiki from '@comark/angular/plugins/shiki' +import { shiki } from '@comark/angular/plugins/shiki' import githubLight from '@shikijs/themes/github-light' import githubDark from '@shikijs/themes/github-dark' @@ -551,7 +551,7 @@ Use `defineMarkdownComponent` and `defineMarkdownDocumentComponent` to pre-confi ```typescript [page.component.ts] import { Component } from '@angular/core' import { Markdown, defineMarkdownComponent } from '@comark/angular' -import shiki from '@comark/angular/plugins/shiki' +import { shiki } from '@comark/angular/plugins/shiki' import { math, Math } from '@comark/angular/plugins/math' import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' @@ -573,7 +573,7 @@ export class PageComponent { } ``` -The provider can also be scoped to a route or an ancestor component. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the provider config and win on conflict. Config plugins run before instance plugins and are deduplicated by name. `transformNode` from the config runs before the instance's own `transformNode`. +The provider can also be scoped to a route or an ancestor component. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the provider config and win on conflict. Config plugins run before instance plugins. An instance plugin with the same name replaces the config plugin and runs in the instance order. `transformNode` from the config runs before the instance's own `transformNode`. ### `defineMarkdownDocumentComponent` @@ -581,6 +581,7 @@ Pre-configure the low-level renderer the same way: ```typescript [page.component.ts] import { Component } from '@angular/core' +import { parseMarkdown } from 'comark' import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' @@ -596,7 +597,9 @@ import { Math } from '@comark/angular/plugins/math' ], template: ``, }) -export class PageComponent {} +export class PageComponent { + document = await parseMarkdown('# Hello') +} ``` The underlying `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG` tokens are exported for custom providers and overrides. diff --git a/docs/skills/comark/references/rendering-angular.md b/docs/skills/comark/references/rendering-angular.md index c6625eb05..ece459b73 100644 --- a/docs/skills/comark/references/rendering-angular.md +++ b/docs/skills/comark/references/rendering-angular.md @@ -507,12 +507,13 @@ export class DocsComponent { } ``` -Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the provider config and win on conflict. Config plugins run first and are deduplicated by name. Config `transformNode` runs before the instance's own transform. +Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the provider config and win on conflict. Config plugins run first. An instance plugin with the same name replaces the config plugin and runs in the instance order. Config `transformNode` runs before the instance's own transform. ### defineMarkdownDocumentComponent ```typescript import { Component } from '@angular/core' +import { parseMarkdown } from 'comark' import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' @@ -527,7 +528,9 @@ import { Math } from '@comark/angular/plugins/math' ], template: ``, }) -export class DocsComponent {} +export class DocsComponent { + document = await parseMarkdown('# Hello') +} ``` --- diff --git a/packages/comark-angular/src/components/markdown.component.ts b/packages/comark-angular/src/components/markdown.component.ts index 68c75382f..cae9591ba 100644 --- a/packages/comark-angular/src/components/markdown.component.ts +++ b/packages/comark-angular/src/components/markdown.component.ts @@ -63,7 +63,7 @@ export class Markdown { * `options.unwrap`. `true` unwraps `

`; a space-separated string or array * unwraps the listed tags. */ - readonly unwrap = input(false) + readonly unwrap = input() /** Custom component mappings for element tags */ readonly components = input>>({}) @@ -99,21 +99,27 @@ export class Markdown { * Compose the parse options consumed by the serialized parser. * * Config defaults are merged under the instance inputs so instance values - * win without mutating the input signals. Plugins are deduplicated by name. + * win without mutating the input signals. Instance plugins replace config + * plugins with the same name. An omitted `unwrap` inherits the config + * default, while an explicit `false` overrides it. */ protected getParserOptions(): ParserOptions { - const names = new Set() - const plugins = [...(this.config?.plugins ?? []), ...(this.plugins() ?? [])].filter((plugin) => { - if (names.has(plugin.name)) return false - names.add(plugin.name) - return true - }) + const plugins = new Map[number]>() + + for (const plugin of this.config?.plugins ?? []) { + plugins.set(plugin.name, plugin) + } + for (const plugin of this.plugins() ?? []) { + plugins.delete(plugin.name) + plugins.set(plugin.name, plugin) + } + const unwrap = this.unwrap() return { ...(this.config?.options ?? {}), ...this.options(), - ...(this.unwrap() ? { unwrap: this.unwrap() } : {}), - plugins, + ...(unwrap === undefined ? {} : { unwrap }), + plugins: [...plugins.values()], } } diff --git a/packages/comark-angular/src/define.ts b/packages/comark-angular/src/define.ts index 2115eb478..3b31eef05 100644 --- a/packages/comark-angular/src/define.ts +++ b/packages/comark-angular/src/define.ts @@ -83,6 +83,7 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = * @example * ```typescript * import { Component } from '@angular/core' + * import { parseMarkdown } from 'comark' * import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' * import { Math } from '@comark/angular/plugins/math' * @@ -97,7 +98,9 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = * ], * template: ``, * }) - * export class DocsComponent {} + * export class DocsComponent { + * document = await parseMarkdown('# Hello') + * } * ``` */ export function defineMarkdownDocumentComponent(config: DefineMarkdownDocumentOptions = {}): Provider { diff --git a/packages/comark-angular/test/provider-config.test.ts b/packages/comark-angular/test/provider-config.test.ts index 1eb5e3389..d0dba37d9 100644 --- a/packages/comark-angular/test/provider-config.test.ts +++ b/packages/comark-angular/test/provider-config.test.ts @@ -4,7 +4,7 @@ import { Component, provideZonelessChangeDetection, type Provider, type Type } f import { TestBed } from '@angular/core/testing' import { bootstrapApplication } from '@angular/platform-browser' import { renderApplication } from '@angular/platform-server' -import { parseMarkdown, type NodeTransform } from 'comark' +import { parseMarkdown, type NodeTransform, type ParserOptions } from 'comark' import emoji from 'comark/plugins/emoji' import { Markdown } from '../src/components/markdown.component.ts' import { MarkdownDocument } from '../src/components/markdown-document.component.ts' @@ -46,12 +46,15 @@ function app(options: { imports: Type[]; providers?: Provider[]; templa async function renderMarkdown( value: string, providers: Provider[], - components?: Record> + components?: Record>, + plugins?: ParserOptions['plugins'] ): Promise { + TestBed.resetTestingModule() await TestBed.configureTestingModule({ imports: [Markdown], providers }).compileComponents() const fixture = TestBed.createComponent(Markdown) fixture.componentRef.setInput('value', value) if (components) fixture.componentRef.setInput('components', components) + if (plugins) fixture.componentRef.setInput('plugins', plugins) fixture.detectChanges() await vi.waitFor(() => { expect(fixture.componentInstance.document).not.toBeNull() @@ -88,6 +91,48 @@ describe('Markdown config providers', () => { expect(html).not.toContain('config-alert') }) + it('lets instance plugins replace config plugins with the same name', async () => { + const provider = defineMarkdownComponent({ plugins: [emoji()] }) + const withConfig = await renderMarkdown(':smile:', [provider]) + const withOverride = await renderMarkdown(':smile:', [provider], undefined, [{ name: 'emoji' }]) + + expect(withConfig).toContain('😄') + expect(withOverride).not.toContain('😄') + }) + + it('inherits a config unwrap default when the input is omitted', async () => { + await TestBed.configureTestingModule({ + imports: [Markdown], + providers: [defineMarkdownComponent({ unwrap: true })], + }).compileComponents() + const fixture = TestBed.createComponent(Markdown) + fixture.componentRef.setInput('value', 'Hello') + fixture.detectChanges() + await vi.waitFor(() => { + fixture.detectChanges() + expect(fixture.componentInstance.document).not.toBeNull() + }) + + expect(fixture.nativeElement.querySelector('p')).toBeNull() + }) + + it('lets an explicit unwrap=false override a config default', async () => { + await TestBed.configureTestingModule({ + imports: [Markdown], + providers: [defineMarkdownComponent({ unwrap: true })], + }).compileComponents() + const fixture = TestBed.createComponent(Markdown) + fixture.componentRef.setInput('value', 'Hello') + fixture.componentRef.setInput('unwrap', false) + fixture.detectChanges() + await vi.waitFor(() => { + fixture.detectChanges() + expect(fixture.componentInstance.document).not.toBeNull() + }) + + expect(fixture.nativeElement.querySelector('p')).not.toBeNull() + }) + it('runs config transformNode before the instance transformNode', async () => { const document = await parseMarkdown('Hello') const App = app({ diff --git a/test/bundle.test.ts b/test/bundle.test.ts index 6bfd9af56..63466bd3c 100644 --- a/test/bundle.test.ts +++ b/test/bundle.test.ts @@ -70,7 +70,7 @@ describe('package bundle size', { timeout: 60_000 }, () => { expect(report).toMatchInlineSnapshot(` { - "@comark/angular": "68.9k (63 files)", + "@comark/angular": "69.1k (63 files)", "@comark/ansi": "42.1k (109 files)", "@comark/html": "17.7k (69 files)", "@comark/nuxt": "11.0k (69 files)", From cd089291971ad0b9bac60d260199e1f2cb78f73b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:21:05 -0500 Subject: [PATCH 04/11] feat(examples): add Angular framework blog example --- AGENTS.md | 4 +- examples/1.frameworks/angular/.gitignore | 44 +++ examples/1.frameworks/angular/.postcssrc.json | 5 + examples/1.frameworks/angular/README.md | 23 ++ examples/1.frameworks/angular/angular.json | 95 ++++++ examples/1.frameworks/angular/package.json | 33 ++ .../1.frameworks/angular/public/favicon.ico | Bin 0 -> 15086 bytes .../public/posts/angular-integration.md | 53 ++++ .../angular/public/posts/comark-syntax.md | 64 ++++ .../angular/public/posts/hello-world.md | 32 ++ .../angular/src/app/app.config.ts | 8 + .../angular/src/app/app.routes.ts | 8 + examples/1.frameworks/angular/src/app/app.ts | 41 +++ .../src/app/components/alert.component.ts | 27 ++ .../app/components/code-block.component.ts | 53 ++++ .../app/components/feature-card.component.ts | 39 +++ .../1.frameworks/angular/src/app/lib/posts.ts | 61 ++++ .../src/app/pages/blog-post.component.ts | 77 +++++ .../angular/src/app/pages/home.component.ts | 78 +++++ examples/1.frameworks/angular/src/index.html | 24 ++ examples/1.frameworks/angular/src/main.ts | 5 + examples/1.frameworks/angular/src/styles.css | 84 ++++++ .../1.frameworks/angular/tsconfig.app.json | 13 + examples/1.frameworks/angular/tsconfig.json | 28 ++ package.json | 1 + pnpm-lock.yaml | 281 ++++++++++++++++-- 26 files changed, 1150 insertions(+), 31 deletions(-) create mode 100644 examples/1.frameworks/angular/.gitignore create mode 100644 examples/1.frameworks/angular/.postcssrc.json create mode 100644 examples/1.frameworks/angular/README.md create mode 100644 examples/1.frameworks/angular/angular.json create mode 100644 examples/1.frameworks/angular/package.json create mode 100644 examples/1.frameworks/angular/public/favicon.ico create mode 100644 examples/1.frameworks/angular/public/posts/angular-integration.md create mode 100644 examples/1.frameworks/angular/public/posts/comark-syntax.md create mode 100644 examples/1.frameworks/angular/public/posts/hello-world.md create mode 100644 examples/1.frameworks/angular/src/app/app.config.ts create mode 100644 examples/1.frameworks/angular/src/app/app.routes.ts create mode 100644 examples/1.frameworks/angular/src/app/app.ts create mode 100644 examples/1.frameworks/angular/src/app/components/alert.component.ts create mode 100644 examples/1.frameworks/angular/src/app/components/code-block.component.ts create mode 100644 examples/1.frameworks/angular/src/app/components/feature-card.component.ts create mode 100644 examples/1.frameworks/angular/src/app/lib/posts.ts create mode 100644 examples/1.frameworks/angular/src/app/pages/blog-post.component.ts create mode 100644 examples/1.frameworks/angular/src/app/pages/home.component.ts create mode 100644 examples/1.frameworks/angular/src/index.html create mode 100644 examples/1.frameworks/angular/src/main.ts create mode 100644 examples/1.frameworks/angular/src/styles.css create mode 100644 examples/1.frameworks/angular/tsconfig.app.json create mode 100644 examples/1.frameworks/angular/tsconfig.json diff --git a/AGENTS.md b/AGENTS.md index c53cedfa0..4859be5fb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -25,7 +25,7 @@ Comark (`comark`) parses CommonMark and GitHub Flavored Markdown (GFM) into a co │ ├── comark-angular/ # Angular 21+ renderer (@comark/angular) │ └── comark-nuxt/ # Deprecated @comark/nuxt wrapper around @comark/vue/nuxt ├── examples/ -│ ├── 1.frameworks/ # Nuxt, Next.js, Astro, SvelteKit, VitePress +│ ├── 1.frameworks/ # Angular, Astro, Next.js, Nuxt, SvelteKit, VitePress │ ├── 2.vite/ # Vue, Vue streaming, React, Svelte, Angular, HTML, ANSI │ ├── 3.cli/ # ANSI output, prompts, OpenTelemetry tracing │ ├── 3.plugins/ # math, mermaid, highlight, rangi, punctuation, twoslash, binding, json-render @@ -305,7 +305,7 @@ pnpm lint:fix # oxlint --fix + oxfmt pnpm typecheck # Root `tsc --noEmit` pnpm verify # lint + test + typecheck pnpm docs # Start the documentation site (`docs/`) -pnpm dev: # Start an example app (vue, react, svelte, angular, html, ansi, nuxt, nextjs, astro, ...) +pnpm dev: # Start an example app (vue, react, angular, angular-blog, html, ansi, nuxt, nextjs, astro, ...) ``` ## CI, benchmarks, and releases diff --git a/examples/1.frameworks/angular/.gitignore b/examples/1.frameworks/angular/.gitignore new file mode 100644 index 000000000..854acd5fc --- /dev/null +++ b/examples/1.frameworks/angular/.gitignore @@ -0,0 +1,44 @@ +# See https://docs.github.com/get-started/getting-started-with-git/ignoring-files for more about ignoring files. + +# Compiled output +/dist +/tmp +/out-tsc +/bazel-out + +# Node +/node_modules +npm-debug.log +yarn-error.log + +# IDEs and editors +.idea/ +.project +.classpath +.c9/ +*.launch +.settings/ +*.sublime-workspace + +# Visual Studio Code +.vscode/* +!.vscode/settings.json +!.vscode/tasks.json +!.vscode/launch.json +!.vscode/extensions.json +!.vscode/mcp.json +.history/* + +# Miscellaneous +/.angular/cache +.sass-cache/ +/connect.lock +/coverage +/libpeerconnection.log +testem.log +/typings +__screenshots__/ + +# System files +.DS_Store +Thumbs.db diff --git a/examples/1.frameworks/angular/.postcssrc.json b/examples/1.frameworks/angular/.postcssrc.json new file mode 100644 index 000000000..e092dc7c1 --- /dev/null +++ b/examples/1.frameworks/angular/.postcssrc.json @@ -0,0 +1,5 @@ +{ + "plugins": { + "@tailwindcss/postcss": {} + } +} diff --git a/examples/1.frameworks/angular/README.md b/examples/1.frameworks/angular/README.md new file mode 100644 index 000000000..2347b7455 --- /dev/null +++ b/examples/1.frameworks/angular/README.md @@ -0,0 +1,23 @@ +# Angular blog with Comark + +This example renders a Markdown blog with Angular CLI and Comark. Posts live as `.md` files in `public/posts/`, parse with `parseMarkdown()` from `comark`, and render with `MarkdownDocument` from `@comark/angular`. + +## How it works + +- **File-based content**: `.md` files in `public/posts/` store post bodies and YAML frontmatter (`title`, `description`, `pubDate`, and `tags`). Angular CLI copies them to the site root, so the posts load with `fetch`. +- **Comark parsing**: `src/app/lib/posts.ts` calls `parseMarkdown()` with `shiki()` to build the `MarkdownDocument` and read frontmatter in one step, instead of chaining `gray-matter`, `remark`, and `rehype`. +- **Config providers**: `defineMarkdownDocumentComponent()` returns a provider for `MARKDOWN_DOCUMENT_CONFIG`. The static `MarkdownDocument` component stays in `imports`, so Angular AOT compiles it without NG1010. +- **Custom components**: `Alert`, the slot-aware `FeatureCard`, and `CodeBlock` map from Markdown tags to Angular components. The copy button is the only interactive part. + +## Run locally + +From the monorepo root: + +```bash +pnpm dev:angular-blog +``` + +## Documentation + +- [Comark documentation](https://comark.dev) +- [Angular rendering](https://comark.dev/rendering/angular) diff --git a/examples/1.frameworks/angular/angular.json b/examples/1.frameworks/angular/angular.json new file mode 100644 index 000000000..61401929f --- /dev/null +++ b/examples/1.frameworks/angular/angular.json @@ -0,0 +1,95 @@ +{ + "$schema": "./node_modules/@angular/cli/lib/config/schema.json", + "version": 1, + "cli": { + "packageManager": "pnpm" + }, + "newProjectRoot": "projects", + "projects": { + "angular": { + "projectType": "application", + "schematics": { + "@schematics/angular:component": { + "inlineTemplate": true, + "inlineStyle": true, + "skipTests": true + }, + "@schematics/angular:class": { + "skipTests": true + }, + "@schematics/angular:directive": { + "skipTests": true + }, + "@schematics/angular:guard": { + "skipTests": true + }, + "@schematics/angular:interceptor": { + "skipTests": true + }, + "@schematics/angular:pipe": { + "skipTests": true + }, + "@schematics/angular:resolver": { + "skipTests": true + }, + "@schematics/angular:service": { + "skipTests": true + } + }, + "root": "", + "sourceRoot": "src", + "prefix": "app", + "architect": { + "build": { + "builder": "@angular/build:application", + "options": { + "browser": "src/main.ts", + "tsConfig": "tsconfig.app.json", + "assets": [ + { + "glob": "**/*", + "input": "public" + } + ], + "styles": ["src/styles.css"] + }, + "configurations": { + "production": { + "budgets": [ + { + "type": "initial", + "maximumWarning": "1MB", + "maximumError": "2MB" + }, + { + "type": "anyComponentStyle", + "maximumWarning": "4kB", + "maximumError": "8kB" + } + ], + "outputHashing": "all" + }, + "development": { + "optimization": false, + "extractLicenses": false, + "sourceMap": true + } + }, + "defaultConfiguration": "production" + }, + "serve": { + "builder": "@angular/build:dev-server", + "configurations": { + "production": { + "buildTarget": "angular:build:production" + }, + "development": { + "buildTarget": "angular:build:development" + } + }, + "defaultConfiguration": "development" + } + } + } + } +} diff --git a/examples/1.frameworks/angular/package.json b/examples/1.frameworks/angular/package.json new file mode 100644 index 000000000..b3c4bb3fd --- /dev/null +++ b/examples/1.frameworks/angular/package.json @@ -0,0 +1,33 @@ +{ + "name": "comark-angular-blog", + "version": "0.0.1", + "private": true, + "scripts": { + "ng": "ng", + "dev": "ng serve", + "start": "ng serve", + "build": "ng build", + "watch": "ng build --watch --configuration development" + }, + "dependencies": { + "@angular/common": "^22.2.0", + "@angular/compiler": "^22.2.0", + "@angular/core": "^22.2.0", + "@angular/platform-browser": "^22.2.0", + "@angular/router": "^22.2.0", + "@comark/angular": "workspace:*", + "comark": "workspace:*", + "rxjs": "~7.8.0", + "shiki": "catalog:", + "tslib": "^2.3.0" + }, + "devDependencies": { + "@angular/build": "^22.2.7", + "@angular/cli": "^22.2.7", + "@angular/compiler-cli": "^22.2.0", + "@tailwindcss/postcss": "^4.1.12", + "postcss": "^8.5.3", + "tailwindcss": "^4.1.12", + "typescript": "~6.0.2" + } +} diff --git a/examples/1.frameworks/angular/public/favicon.ico b/examples/1.frameworks/angular/public/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..57614f9c967596fad0a3989bec2b1deff33034f6 GIT binary patch literal 15086 zcmd^G33O9Omi+`8$@{|M-I6TH3wzF-p5CV8o}7f~KxR60LK+ApEFB<$bcciv%@SmA zV{n>g85YMFFeU*Uvl=i4v)C*qgnb;$GQ=3XTe9{Y%c`mO%su)noNCCQ*@t1WXn|B(hQ7i~ zrUK8|pUkD6#lNo!bt$6)jR!&C?`P5G(`e((P($RaLeq+o0Vd~f11;qB05kdbAOm?r zXv~GYr_sibQO9NGTCdT;+G(!{4Xs@4fPak8#L8PjgJwcs-Mm#nR_Z0s&u?nDX5^~@ z+A6?}g0|=4e_LoE69pPFO`yCD@BCjgKpzMH0O4Xs{Ahc?K3HC5;l=f zg>}alhBXX&);z$E-wai+9TTRtBX-bWYY@cl$@YN#gMd~tM_5lj6W%8ah4;uZ;jP@Q zVbuel1rPA?2@x9Y+u?e`l{Z4ngfG5q5BLH5QsEu4GVpt{KIp1?U)=3+KQ;%7ec8l* zdV=zZgN5>O3G(3L2fqj3;oBbZZw$Ij@`Juz@?+yy#OPw)>#wsTewVgTK9BGt5AbZ&?K&B3GVF&yu?@(Xj3fR3n+ZP0%+wo)D9_xp>Z$`A4 zfV>}NWjO#3lqumR0`gvnffd9Ka}JJMuHS&|55-*mCD#8e^anA<+sFZVaJe7{=p*oX zE_Uv?1>e~ga=seYzh{9P+n5<+7&9}&(kwqSaz;1aD|YM3HBiy<))4~QJSIryyqp| z8nGc(8>3(_nEI4n)n7j(&d4idW1tVLjZ7QbNLXg;LB ziHsS5pXHEjGJZb59KcvS~wv;uZR-+4qEqow`;JCfB*+b^UL^3!?;-^F%yt=VjU|v z39SSqKcRu_NVvz!zJzL0CceJaS6%!(eMshPv_0U5G`~!a#I$qI5Ic(>IONej@aH=f z)($TAT#1I{iCS4f{D2+ApS=$3E7}5=+y(rA9mM#;Cky%b*Gi0KfFA`ofKTzu`AV-9 znW|y@19rrZ*!N2AvDi<_ZeR3O2R{#dh1#3-d%$k${Rx42h+i&GZo5!C^dSL34*AKp z27mTd>k>?V&X;Nl%GZ(>0s`1UN~Hfyj>KPjtnc|)xM@{H_B9rNr~LuH`Gr5_am&Ep zTjZA8hljNj5H1Ipm-uD9rC}U{-vR!eay5&6x6FkfupdpT*84MVwGpdd(}ib)zZ3Ky z7C$pnjc82(W_y_F{PhYj?o!@3__UUvpX)v69aBSzYj3 zdi}YQkKs^SyXyFG2LTRz9{(w}y~!`{EuAaUr6G1M{*%c+kP1olW9z23dSH!G4_HSK zzae-DF$OGR{ofP*!$a(r^5Go>I3SObVI6FLY)N@o<*gl0&kLo-OT{Tl*7nCz>Iq=? zcigIDHtj|H;6sR?or8Wd_a4996GI*CXGU}o;D9`^FM!AT1pBY~?|4h^61BY#_yIfO zKO?E0 zJ{Pc`9rVEI&$xxXu`<5E)&+m(7zX^v0rqofLs&bnQT(1baQkAr^kEsk)15vlzAZ-l z@OO9RF<+IiJ*O@HE256gCt!bF=NM*vh|WVWmjVawcNoksRTMvR03H{p@cjwKh(CL4 z7_PB(dM=kO)!s4fW!1p0f93YN@?ZSG` z$B!JaAJCtW$B97}HNO9(x-t30&E}Mo1UPi@Av%uHj~?T|!4JLwV;KCx8xO#b9IlUW zI6+{a@Wj|<2Y=U;a@vXbxqZNngH8^}LleE_4*0&O7#3iGxfJ%Id>+sb;7{L=aIic8 z|EW|{{S)J-wr@;3PmlxRXU8!e2gm_%s|ReH!reFcY8%$Hl4M5>;6^UDUUae?kOy#h zk~6Ee_@ZAn48Bab__^bNmQ~+k=02jz)e0d9Z3>G?RGG!65?d1>9}7iG17?P*=GUV-#SbLRw)Hu{zx*azHxWkGNTWl@HeWjA?39Ia|sCi{e;!^`1Oec zb>Z|b65OM*;eC=ZLSy?_fg$&^2xI>qSLA2G*$nA3GEnp3$N-)46`|36m*sc#4%C|h zBN<2U;7k>&G_wL4=Ve5z`ubVD&*Hxi)r@{4RCDw7U_D`lbC(9&pG5C*z#W>8>HU)h z!h3g?2UL&sS!oY5$3?VlA0Me9W5e~V;2jds*fz^updz#AJ%G8w2V}AEE?E^=MK%Xt z__Bx1cr7+DQmuHmzn*|hh%~eEc9@m05@clWfpEFcr+06%0&dZJH&@8^&@*$qR@}o3 z@Tuuh2FsLz^zH+dN&T&?0G3I?MpmYJ;GP$J!EzjeM#YLJ!W$}MVNb0^HfOA>5Fe~UNn%Zk(PT@~9}1dt)1UQ zU*B5K?Dl#G74qmg|2>^>0WtLX#Jz{lO4NT`NYB*(L#D|5IpXr9v&7a@YsGp3vLR7L zHYGHZg7{ie6n~2p$6Yz>=^cEg7tEgk-1YRl%-s7^cbqFb(U7&Dp78+&ut5!Tn(hER z|Gp4Ed@CnOPeAe|N>U(dB;SZ?NU^AzoD^UAH_vamp6Ws}{|mSq`^+VP1g~2B{%N-!mWz<`)G)>V-<`9`L4?3dM%Qh6<@kba+m`JS{Ya@9Fq*m6$$ zA1%Ogc~VRH33|S9l%CNb4zM%k^EIpqY}@h{w(aBcJ9c05oiZx#SK9t->5lSI`=&l~ z+-Ic)a{FbBhXV$Xt!WRd`R#Jk-$+_Z52rS>?Vpt2IK<84|E-SBEoIw>cs=a{BlQ7O z-?{Fy_M&84&9|KM5wt~)*!~i~E=(6m8(uCO)I=)M?)&sRbzH$9Rovzd?ZEY}GqX+~ zFbEbLz`BZ49=2Yh-|<`waK-_4!7`ro@zlC|r&I4fc4oyb+m=|c8)8%tZ-z5FwhzDt zL5kB@u53`d@%nHl0Sp)Dw`(QU&>vujEn?GPEXUW!Wi<+4e%BORl&BIH+SwRcbS}X@ z01Pk|vA%OdJKAs17zSXtO55k!;%m9>1eW9LnyAX4uj7@${O6cfii`49qTNItzny5J zH&Gj`e}o}?xjQ}r?LrI%FjUd@xflT3|7LA|ka%Q3i}a8gVm<`HIWoJGH=$EGClX^C0lysQJ>UO(q&;`T#8txuoQ_{l^kEV9CAdXuU1Ghg8 zN_6hHFuy&1x24q5-(Z7;!poYdt*`UTdrQOIQ!2O7_+AHV2hgXaEz7)>$LEdG z<8vE^Tw$|YwZHZDPM!SNOAWG$?J)MdmEk{U!!$M#fp7*Wo}jJ$Q(=8>R`Ats?e|VU?Zt7Cdh%AdnfyN3MBWw{ z$OnREvPf7%z6`#2##_7id|H%Y{vV^vWXb?5d5?a_y&t3@p9t$ncHj-NBdo&X{wrfJ zamN)VMYROYh_SvjJ=Xd!Ga?PY_$;*L=SxFte!4O6%0HEh%iZ4=gvns7IWIyJHa|hT z2;1+e)`TvbNb3-0z&DD_)Jomsg-7p_Uh`wjGnU1urmv1_oVqRg#=C?e?!7DgtqojU zWoAB($&53;TsXu^@2;8M`#z{=rPy?JqgYM0CDf4v@z=ZD|ItJ&8%_7A#K?S{wjxgd z?xA6JdJojrWpB7fr2p_MSsU4(R7=XGS0+Eg#xR=j>`H@R9{XjwBmqAiOxOL` zt?XK-iTEOWV}f>Pz3H-s*>W z4~8C&Xq25UQ^xH6H9kY_RM1$ch+%YLF72AA7^b{~VNTG}Tj#qZltz5Q=qxR`&oIlW Nr__JTFzvMr^FKp4S3v*( literal 0 HcmV?d00001 diff --git a/examples/1.frameworks/angular/public/posts/angular-integration.md b/examples/1.frameworks/angular/public/posts/angular-integration.md new file mode 100644 index 000000000..283f505e1 --- /dev/null +++ b/examples/1.frameworks/angular/public/posts/angular-integration.md @@ -0,0 +1,53 @@ +--- +title: Integrating Comark with Angular +description: How this blog renders Markdown with Comark and Angular standalone components. +pubDate: 2026-01-10 +tags: [comark, angular, integration] +--- + +This example pairs Angular CLI with `parseMarkdown()` and `@comark/angular`. + +## How it works + +Instead of chaining `gray-matter`, `remark`, and `rehype`, `src/app/lib/posts.ts` parses Markdown and frontmatter in a single call: + +1. **Load Markdown files**: fetch `.md` files from `public/posts/` at runtime. +2. **Parse with Comark**: call `parseMarkdown()` with `shiki()` to build the `MarkdownDocument` and read `tree.frontmatter`. +3. **Render in a component**: pass the document to `MarkdownDocument` and register custom components through a config provider. + +```ts +import { parseMarkdown } from 'comark' +import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' +import shiki from 'comark/plugins/shiki' +import { AlertComponent } from './components/alert.component' + +const document = await parseMarkdown(markdown, { + plugins: [shiki()], +}) + +// providers: [defineMarkdownDocumentComponent({ components: { alert: AlertComponent } })] +``` + +::alert{type="info"} +`defineMarkdownDocumentComponent()` returns a `Provider` for `MARKDOWN_DOCUMENT_CONFIG`. The static `MarkdownDocument` component stays in `imports`, which keeps Angular AOT happy (NG1010). +:: + +## Custom components + +Register custom components in `defineMarkdownDocumentComponent()`. Each component receives resolved attributes as inputs and nested Markdown through ``: + +```ts +@Component({ + selector: 'app-alert', + template: ` +

+ +
+ `, +}) +export class AlertComponent { + readonly type = input('info') +} +``` + +Instance-level inputs merge with the provider config and win on conflict. `transformNode` from the config runs before the instance transform. diff --git a/examples/1.frameworks/angular/public/posts/comark-syntax.md b/examples/1.frameworks/angular/public/posts/comark-syntax.md new file mode 100644 index 000000000..8ca84afb1 --- /dev/null +++ b/examples/1.frameworks/angular/public/posts/comark-syntax.md @@ -0,0 +1,64 @@ +--- +title: Comark syntax guide +description: A tour of standard Markdown, custom components, and named slots in Comark. +pubDate: 2025-12-15 +tags: [comark, syntax, components] +--- + +Comark adds block and inline component syntax to CommonMark and GFM. + +## Inline formatting + +Standard Markdown formatting works everywhere: **bold**, *italic*, `code`, and [links](https://comark.dev). + +## Components + +Block components open and close with `::` and accept props in `{...}`: + +::alert{type="warning"} +Double colons open a block component, and props inside curly braces pass directly to the rendered Angular component. +:: + +## Component slots + +Angular components project default content with `` and named `#slot` sections with ``: + +::feature-card +#header +Slot-aware Angular component + +#default +This body renders in the default slot. It can contain **Markdown**, links, lists, or nested Comark components. + +#footer +Rendered through the footer slot in `FeatureCardComponent`. +:: + +## Lists + +Unordered and ordered lists support nested inline formatting: + +- First item +- Second item with **bold** text +- Third item with `inline code` + +1. Numbered items +2. Nested Markdown inside each item + +## Code blocks + +Fenced code blocks highlight through the `shiki` plugin: + +```js +function greet(name) { + return `Hello, ${name}!` +} +``` + +## Block quotes + +> Standard block quotes, lists, and code blocks can sit outside or inside custom components. + +::alert{type="danger"} +Close block components with `::`. During streaming, `autoClose` closes unfinished blocks until the closing marker arrives. +:: diff --git a/examples/1.frameworks/angular/public/posts/hello-world.md b/examples/1.frameworks/angular/public/posts/hello-world.md new file mode 100644 index 000000000..9c1ef474c --- /dev/null +++ b/examples/1.frameworks/angular/public/posts/hello-world.md @@ -0,0 +1,32 @@ +--- +title: Hello world +description: Getting started with Comark and Angular. +pubDate: 2025-12-01 +tags: [comark, angular] +--- + +Welcome to this blog built with **Comark** and Angular. + +Comark adds component and attribute syntax to Markdown and renders through Angular components. The Markdown files load with `fetch`, parse with `parseMarkdown()`, and render with `MarkdownDocument` from `@comark/angular`. + +::alert{type="info"} +This alert renders through a custom Angular component. Parser code stays out of the template. +:: + +## Why pair Comark with Angular + +- **Standalone components**: `MarkdownDocument` drops into any standalone component's `imports`. +- **Config providers**: `defineMarkdownDocumentComponent()` registers plugins and component mappings through Angular DI. +- **Component syntax**: write `::alert` and `::feature-card` blocks directly in `.md` files. + +```ts +import { parseMarkdown } from 'comark' +import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' + +const document = await parseMarkdown(markdown) +// providers: [defineMarkdownDocumentComponent({ components: { Alert } })] +``` + +::alert{type="success"} +Angular handles routing and the build while Comark parses frontmatter, highlights code, and renders custom components. +:: diff --git a/examples/1.frameworks/angular/src/app/app.config.ts b/examples/1.frameworks/angular/src/app/app.config.ts new file mode 100644 index 000000000..70ea96156 --- /dev/null +++ b/examples/1.frameworks/angular/src/app/app.config.ts @@ -0,0 +1,8 @@ +import type { ApplicationConfig } from '@angular/core' +import { provideBrowserGlobalErrorListeners } from '@angular/core' +import { provideRouter } from '@angular/router' +import { routes } from './app.routes' + +export const appConfig: ApplicationConfig = { + providers: [provideBrowserGlobalErrorListeners(), provideRouter(routes)], +} diff --git a/examples/1.frameworks/angular/src/app/app.routes.ts b/examples/1.frameworks/angular/src/app/app.routes.ts new file mode 100644 index 000000000..c45da76e6 --- /dev/null +++ b/examples/1.frameworks/angular/src/app/app.routes.ts @@ -0,0 +1,8 @@ +import type { Routes } from '@angular/router' +import { HomeComponent } from './pages/home.component' +import { BlogPostComponent } from './pages/blog-post.component' + +export const routes: Routes = [ + { path: '', component: HomeComponent }, + { path: 'blog/:slug', component: BlogPostComponent }, +] diff --git a/examples/1.frameworks/angular/src/app/app.ts b/examples/1.frameworks/angular/src/app/app.ts new file mode 100644 index 000000000..982251381 --- /dev/null +++ b/examples/1.frameworks/angular/src/app/app.ts @@ -0,0 +1,41 @@ +import { Component } from '@angular/core' +import { RouterLink, RouterOutlet } from '@angular/router' + +@Component({ + selector: 'app-root', + imports: [RouterLink, RouterOutlet], + template: ` +
+
+ +
+
+ +
+ +
+ `, +}) +export class App {} diff --git a/examples/1.frameworks/angular/src/app/components/alert.component.ts b/examples/1.frameworks/angular/src/app/components/alert.component.ts new file mode 100644 index 000000000..e4a0737b6 --- /dev/null +++ b/examples/1.frameworks/angular/src/app/components/alert.component.ts @@ -0,0 +1,27 @@ +import { Component, input } from '@angular/core' + +@Component({ + selector: 'app-alert', + template: ` +
+ +
+ `, +}) +export class AlertComponent { + readonly type = input<'info' | 'warning' | 'success' | 'danger'>('info') + + readonly baseClass = 'my-4 rounded-lg border-l-4 px-4 py-3 text-sm leading-relaxed' + + readonly styles: Record = { + info: 'bg-blue-50 border-blue-400 text-blue-900 dark:bg-blue-950/50 dark:border-blue-500/50 dark:text-blue-200', + warning: + 'bg-amber-50 border-amber-400 text-amber-900 dark:bg-amber-950/50 dark:border-amber-500/50 dark:text-amber-200', + success: + 'bg-emerald-50 border-emerald-400 text-emerald-900 dark:bg-emerald-950/50 dark:border-emerald-500/50 dark:text-emerald-200', + danger: 'bg-red-50 border-red-400 text-red-900 dark:bg-red-950/50 dark:border-red-500/50 dark:text-red-200', + } +} diff --git a/examples/1.frameworks/angular/src/app/components/code-block.component.ts b/examples/1.frameworks/angular/src/app/components/code-block.component.ts new file mode 100644 index 000000000..e36aa342a --- /dev/null +++ b/examples/1.frameworks/angular/src/app/components/code-block.component.ts @@ -0,0 +1,53 @@ +import { Component, DestroyRef, computed, inject, input, signal } from '@angular/core' +import type { ElementNode } from 'comark' +import { textContent } from 'comark/utils' + +@Component({ + selector: 'app-code-block', + template: ` +
+
+ {{ label() }} + +
+
+
+ `, +}) +export class CodeBlockComponent { + readonly __node = input() + readonly filename = input() + readonly language = input() + + readonly code = computed(() => (this.__node() ? textContent(this.__node()!) : '')) + readonly label = computed(() => this.filename() || this.language()?.toUpperCase() || 'Code') + readonly copied = signal(false) + + private resetTimer?: ReturnType + + constructor() { + inject(DestroyRef).onDestroy(() => clearTimeout(this.resetTimer)) + } + + async copy(): Promise { + try { + await navigator.clipboard.writeText(this.code()) + this.copied.set(true) + clearTimeout(this.resetTimer) + this.resetTimer = setTimeout(() => this.copied.set(false), 2000) + } catch { + this.copied.set(false) + } + } +} diff --git a/examples/1.frameworks/angular/src/app/components/feature-card.component.ts b/examples/1.frameworks/angular/src/app/components/feature-card.component.ts new file mode 100644 index 000000000..95accb59a --- /dev/null +++ b/examples/1.frameworks/angular/src/app/components/feature-card.component.ts @@ -0,0 +1,39 @@ +import { AfterViewInit, Component, ElementRef, ViewChild, inject } from '@angular/core' + +@Component({ + selector: 'app-feature-card', + template: ` +
+
+
+ +
+
+
+ `, +}) +export class FeatureCardComponent implements AfterViewInit { + private readonly host = inject>(ElementRef) + + @ViewChild('header') private header?: ElementRef + @ViewChild('footer') private footer?: ElementRef + + ngAfterViewInit(): void { + this.moveSlot('header', this.header?.nativeElement) + this.moveSlot('footer', this.footer?.nativeElement) + } + + private moveSlot(name: string, container?: HTMLElement): void { + if (!container) return + const slot = this.host.nativeElement.querySelector(`:scope > div[slot="${name}"]`) + if (slot) container.appendChild(slot) + } +} diff --git a/examples/1.frameworks/angular/src/app/lib/posts.ts b/examples/1.frameworks/angular/src/app/lib/posts.ts new file mode 100644 index 000000000..41e65b529 --- /dev/null +++ b/examples/1.frameworks/angular/src/app/lib/posts.ts @@ -0,0 +1,61 @@ +import { parseMarkdown, type MarkdownDocument } from 'comark' +import shiki from 'comark/plugins/shiki' + +const slugs = ['hello-world', 'comark-syntax', 'angular-integration'] + +export interface PostMeta { + slug: string + title: string + description: string + pubDate: string + tags: string[] +} + +export interface Post extends PostMeta { + tree: MarkdownDocument +} + +interface Frontmatter { + title?: unknown + description?: unknown + pubDate?: unknown + tags?: unknown +} + +function text(value: unknown): string { + return value == null ? '' : String(value) +} + +async function readPost(slug: string): Promise { + const url = new URL(`posts/${slug}.md`, document.baseURI) + const response = await fetch(url) + if (!response.ok) throw new Error(`Post not found: ${slug}`) + return response.text() +} + +function metadata(slug: string, frontmatter: Frontmatter): PostMeta { + return { + slug, + title: text(frontmatter.title), + description: text(frontmatter.description), + pubDate: text(frontmatter.pubDate), + tags: Array.isArray(frontmatter.tags) ? frontmatter.tags.map(text) : [], + } +} + +export async function getAllPosts(): Promise { + const posts = await Promise.all( + slugs.map(async (slug) => { + const tree = await parseMarkdown(await readPost(slug)) + return metadata(slug, tree.frontmatter as Frontmatter) + }) + ) + return posts.sort((a, b) => new Date(b.pubDate).valueOf() - new Date(a.pubDate).valueOf()) +} + +export async function getPost(slug: string): Promise { + if (!slugs.includes(slug)) throw new Error(`Post not found: ${slug}`) + + const tree = await parseMarkdown(await readPost(slug), { plugins: [shiki()] }) + return { ...metadata(slug, tree.frontmatter as Frontmatter), tree } +} diff --git a/examples/1.frameworks/angular/src/app/pages/blog-post.component.ts b/examples/1.frameworks/angular/src/app/pages/blog-post.component.ts new file mode 100644 index 000000000..9f38a8291 --- /dev/null +++ b/examples/1.frameworks/angular/src/app/pages/blog-post.component.ts @@ -0,0 +1,77 @@ +import { Component, inject, signal } from '@angular/core' +import { Title } from '@angular/platform-browser' +import { ActivatedRoute, RouterLink } from '@angular/router' +import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' +import { AlertComponent } from '../components/alert.component' +import { CodeBlockComponent } from '../components/code-block.component' +import { FeatureCardComponent } from '../components/feature-card.component' +import { getPost, type Post } from '../lib/posts' + +@Component({ + selector: 'app-blog-post', + imports: [MarkdownDocument, RouterLink], + providers: [ + defineMarkdownDocumentComponent({ + components: { + alert: AlertComponent, + 'feature-card': FeatureCardComponent, + pre: CodeBlockComponent, + }, + class: 'prose', + }), + ], + template: ` + @if (post(); as current) { +
+
+ + ← Back to all posts + +

{{ current.title }}

+
+ +
+ @for (tag of current.tags; track tag) { + + {{ tag }} + + } +
+
+
+ +
+ } + `, +}) +export class BlogPostComponent { + private readonly route = inject(ActivatedRoute) + private readonly title = inject(Title) + readonly post = signal(null) + + constructor() { + this.route.params.subscribe((params) => { + const slug = params['slug'] + if (slug) { + getPost(slug).then((post) => { + this.post.set(post) + this.title.setTitle(`${post.title} | Comark Blog`) + }) + } + }) + } + + formatDate(date: string): string { + return new Date(date).toLocaleDateString('en-US', { + year: 'numeric', + month: 'long', + day: 'numeric', + timeZone: 'UTC', + }) + } +} diff --git a/examples/1.frameworks/angular/src/app/pages/home.component.ts b/examples/1.frameworks/angular/src/app/pages/home.component.ts new file mode 100644 index 000000000..f65cd24a7 --- /dev/null +++ b/examples/1.frameworks/angular/src/app/pages/home.component.ts @@ -0,0 +1,78 @@ +import { Component, inject, signal } from '@angular/core' +import { Title } from '@angular/platform-browser' +import { RouterLink } from '@angular/router' +import { getAllPosts, type PostMeta } from '../lib/posts' + +@Component({ + selector: 'app-home', + imports: [RouterLink], + template: ` +
+

Comark Blog

+

+ A blog built with + Angular + and + Comark + rendering. +

+ @if (posts().length === 0) { +

Loading posts...

+ } + +
+ `, +}) +export class HomeComponent { + readonly posts = signal([]) + + constructor() { + inject(Title).setTitle('Comark Blog') + getAllPosts().then((posts) => this.posts.set(posts)) + } + + formatDate(date: string): string { + return new Date(date).toLocaleDateString('en-US', { + year: 'numeric', + month: 'long', + day: 'numeric', + timeZone: 'UTC', + }) + } +} diff --git a/examples/1.frameworks/angular/src/index.html b/examples/1.frameworks/angular/src/index.html new file mode 100644 index 000000000..83c505f11 --- /dev/null +++ b/examples/1.frameworks/angular/src/index.html @@ -0,0 +1,24 @@ + + + + + Comark Blog + + + + + + + + + diff --git a/examples/1.frameworks/angular/src/main.ts b/examples/1.frameworks/angular/src/main.ts new file mode 100644 index 000000000..8192dca69 --- /dev/null +++ b/examples/1.frameworks/angular/src/main.ts @@ -0,0 +1,5 @@ +import { bootstrapApplication } from '@angular/platform-browser' +import { appConfig } from './app/app.config' +import { App } from './app/app' + +bootstrapApplication(App, appConfig).catch((err) => console.error(err)) diff --git a/examples/1.frameworks/angular/src/styles.css b/examples/1.frameworks/angular/src/styles.css new file mode 100644 index 000000000..2c6b73da9 --- /dev/null +++ b/examples/1.frameworks/angular/src/styles.css @@ -0,0 +1,84 @@ +@import 'tailwindcss'; + +body { + @apply bg-neutral-50 dark:bg-neutral-950 text-neutral-900 dark:text-neutral-50 min-h-screen flex flex-col; +} + +header { + @apply border-b border-neutral-200 dark:border-neutral-800; +} + +header nav { + @apply max-w-2xl mx-auto px-6 py-4; +} + +header nav a { + @apply text-lg font-semibold text-neutral-900 dark:text-neutral-50 no-underline; +} + +main { + @apply max-w-2xl mx-auto px-6 py-8 flex-1 w-full; +} + +footer { + @apply border-t border-neutral-200 dark:border-neutral-800 text-center text-sm text-neutral-500 dark:text-neutral-400 py-6; +} + +footer a { + @apply text-neutral-700 dark:text-neutral-300 underline; +} + +/* Prose styles for rendered Comark content */ +.prose h1 { + @apply text-3xl font-bold mb-4 mt-0; +} +.prose h2 { + @apply text-2xl font-semibold mt-8 mb-3; +} +.prose h3 { + @apply text-xl font-semibold mt-6 mb-2; +} +.prose p { + @apply mb-4 leading-relaxed; +} +.prose a { + @apply text-blue-600 dark:text-blue-400 underline; +} +.prose strong { + @apply font-semibold; +} +.prose ul { + @apply list-disc pl-6 mb-4 space-y-1; +} +.prose ol { + @apply list-decimal pl-6 mb-4 space-y-1; +} +.prose li { + @apply leading-relaxed; +} +.prose blockquote { + @apply border-l-4 border-neutral-300 dark:border-neutral-700 pl-4 italic text-neutral-600 dark:text-neutral-400 my-4; +} +.prose code { + @apply bg-neutral-200 dark:bg-neutral-800 px-1.5 py-0.5 rounded text-sm font-mono; +} +.prose pre { + @apply bg-neutral-100 dark:bg-neutral-800 dark:text-neutral-100 text-neutral-800 rounded-lg p-4 overflow-x-auto mb-4; +} +.prose pre code { + @apply bg-transparent p-0 text-inherit; +} + +.prose .code-block { + @apply mb-4 overflow-hidden rounded-lg border border-neutral-200 dark:border-neutral-700; +} +.prose .code-block-header { + @apply flex items-center justify-between bg-neutral-100 px-3 py-1.5 text-xs text-neutral-500 dark:bg-neutral-800 dark:text-neutral-400; +} +.prose .code-block pre { + @apply mb-0 rounded-none; +} + +.shiki span.line { + display: block; +} diff --git a/examples/1.frameworks/angular/tsconfig.app.json b/examples/1.frameworks/angular/tsconfig.app.json new file mode 100644 index 000000000..811c7fae4 --- /dev/null +++ b/examples/1.frameworks/angular/tsconfig.app.json @@ -0,0 +1,13 @@ +/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */ +/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */ +{ + "extends": "./tsconfig.json", + "compilerOptions": { + "types": [], + "allowImportingTsExtensions": true, + "rewriteRelativeImportExtensions": true, + "noPropertyAccessFromIndexSignature": false + }, + "include": ["src/**/*.ts"], + "exclude": ["src/**/*.spec.ts"] +} diff --git a/examples/1.frameworks/angular/tsconfig.json b/examples/1.frameworks/angular/tsconfig.json new file mode 100644 index 000000000..30d64cea3 --- /dev/null +++ b/examples/1.frameworks/angular/tsconfig.json @@ -0,0 +1,28 @@ +/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */ +/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */ +{ + "compileOnSave": false, + "compilerOptions": { + "noImplicitOverride": true, + "noPropertyAccessFromIndexSignature": true, + "noImplicitReturns": true, + "noFallthroughCasesInSwitch": true, + "skipLibCheck": true, + "isolatedModules": true, + "experimentalDecorators": true, + "importHelpers": true, + "target": "ES2022", + "module": "preserve" + }, + "angularCompilerOptions": { + "enableI18nLegacyMessageIdFormat": false, + "strictInjectionParameters": true, + "strictInputAccessModifiers": true + }, + "files": [], + "references": [ + { + "path": "./tsconfig.app.json" + } + ] +} diff --git a/package.json b/package.json index c7c56bf0f..fa5fad6ae 100644 --- a/package.json +++ b/package.json @@ -14,6 +14,7 @@ "dev:react": "pnpm --filter comark-react run dev", "dev:svelte": "pnpm --filter comark-svelte run dev", "dev:angular": "pnpm --filter comark-angular run dev", + "dev:angular-blog": "pnpm --filter comark-angular-blog run dev", "dev:ansi": "pnpm --filter comark-ansi run dev", "dev:vue": "pnpm --filter comark-vue run dev", "dev:vue:mermaid": "pnpm --filter comark-vue-vite-mermaid run dev", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index b4e1f6809..b2c0c97a9 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -500,7 +500,7 @@ importers: devDependencies: '@codspeed/vitest-plugin': specifier: 'catalog:' - version: 6.1.1(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 6.1.1(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) '@comark/ansi': specifier: workspace:* version: link:packages/comark-ansi @@ -647,6 +647,61 @@ importers: specifier: 'catalog:' version: 4.23.15 + examples/1.frameworks/angular: + dependencies: + '@angular/common': + specifier: ^22.2.0 + version: 22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2) + '@angular/compiler': + specifier: ^22.2.0 + version: 22.2.6 + '@angular/core': + specifier: ^22.2.0 + version: 22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3) + '@angular/platform-browser': + specifier: ^22.2.0 + version: 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)) + '@angular/router': + specifier: ^22.2.0 + version: 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(@angular/platform-browser@22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)))(rxjs@7.8.2) + '@comark/angular': + specifier: workspace:* + version: link:../../../packages/comark-angular/dist + comark: + specifier: workspace:* + version: link:../../../packages/comark + rxjs: + specifier: ~7.8.0 + version: 7.8.2 + shiki: + specifier: 'catalog:' + version: 4.6.0 + tslib: + specifier: ^2.3.0 + version: 2.9.1 + devDependencies: + '@angular/build': + specifier: ^22.2.7 + version: 22.2.7(5e8e06c5932a5ec96fb4c913c9d03d25) + '@angular/cli': + specifier: ^22.2.7 + version: 22.2.7(@types/node@26.6.6)(chokidar@5.0.0) + '@angular/compiler-cli': + specifier: ^22.2.0 + version: 22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3) + '@tailwindcss/postcss': + specifier: ^4.1.12 + version: 4.3.5 + postcss: + specifier: ^8.5.3 + version: 8.5.33 + tailwindcss: + specifier: ^4.1.12 + version: 4.3.5 + typescript: + specifier: ~6.0.2 + version: 6.0.3 + examples/1.frameworks/astro: dependencies: '@astrojs/react': @@ -824,10 +879,10 @@ importers: devDependencies: '@analogjs/vite-plugin-angular': specifier: 'catalog:' - version: 3.0.0-beta.42(@angular/build@22.2.7(b1461d7cd9e3185ee679e7bd0f346a68))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + version: 3.0.0-beta.42(@angular/build@22.2.7(8f1b78d10abefeadf4529127eb65e9b0))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) '@angular/build': specifier: 'catalog:' - version: 22.2.7(b1461d7cd9e3185ee679e7bd0f346a68) + version: 22.2.7(8f1b78d10abefeadf4529127eb65e9b0) '@angular/compiler': specifier: 'catalog:' version: 22.2.6 @@ -1524,7 +1579,7 @@ importers: devDependencies: '@angular-devkit/build-angular': specifier: 'catalog:' - version: 22.2.7(a7e89f390549dab65d4104706cc03aeb) + version: 22.2.7(2e10e11537ae0fb9f8142eed00228c3f) '@angular/cli': specifier: 'catalog:' version: 22.2.7(@types/node@26.6.6)(chokidar@5.0.0) @@ -1661,7 +1716,7 @@ importers: version: 19.3.0(@types/react@19.3.0) '@vitest/browser-playwright': specifier: 'catalog:' - version: 5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) react: specifier: 'catalog:' version: 19.3.1 @@ -1695,10 +1750,10 @@ importers: version: 7.3.1(svelte@5.58.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) '@vitest/browser': specifier: 'catalog:' - version: 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) '@vitest/browser-playwright': specifier: 'catalog:' - version: 5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) svelte: specifier: ^5.58.0 version: 5.58.0 @@ -1710,7 +1765,7 @@ importers: version: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) vitest-browser-svelte: specifier: 'catalog:' - version: 3.1.0(svelte@5.58.0)(vitest@5.1.0) + version: 3.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(svelte@5.58.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) packages/comark-vue: dependencies: @@ -12696,7 +12751,7 @@ snapshots: '@jridgewell/gen-mapping': 0.3.13 '@jridgewell/trace-mapping': 0.3.31 - '@analogjs/vite-plugin-angular@3.0.0-beta.42(@angular/build@22.2.7(b1461d7cd9e3185ee679e7bd0f346a68))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': + '@analogjs/vite-plugin-angular@3.0.0-beta.42(@angular/build@22.2.7(8f1b78d10abefeadf4529127eb65e9b0))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': dependencies: es-toolkit: 1.52.0 magic-string: 0.30.21 @@ -12706,7 +12761,7 @@ snapshots: rolldown: 1.3.1 tinyglobby: 0.2.17 optionalDependencies: - '@angular/build': 22.2.7(b1461d7cd9e3185ee679e7bd0f346a68) + '@angular/build': 22.2.7(8f1b78d10abefeadf4529127eb65e9b0) vite: 8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) transitivePeerDependencies: - '@emnapi/core' @@ -12719,13 +12774,13 @@ snapshots: transitivePeerDependencies: - chokidar - '@angular-devkit/build-angular@22.2.7(a7e89f390549dab65d4104706cc03aeb)': + '@angular-devkit/build-angular@22.2.7(2e10e11537ae0fb9f8142eed00228c3f)': dependencies: '@ampproject/remapping': 2.3.0 '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) '@angular-devkit/build-webpack': 0.2202.7(chokidar@5.0.0)(webpack-dev-server@6.0.0(supports-color@10.2.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.33))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.28)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.33))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.28)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) '@angular-devkit/core': 22.2.7(chokidar@5.0.0) - '@angular/build': 22.2.7(d340a406dc22e6aebac2615013ad35e6) + '@angular/build': 22.2.7(1608556e09e6c425da111e5e30ff0d49) '@angular/compiler-cli': 22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3) '@babel/core': 8.0.5 '@babel/generator': 8.0.5 @@ -12793,6 +12848,8 @@ snapshots: - '@swc/html' - '@types/node' - '@vitejs/devtools' + - '@vitest/browser-playwright' + - '@vitest/ui' - bufferutil - chokidar - clean-css @@ -12815,6 +12872,7 @@ snapshots: - tsx - uglify-js - utf-8-validate + - vite - vitest - webpack-cli - yaml @@ -12849,7 +12907,68 @@ snapshots: transitivePeerDependencies: - chokidar - '@angular/build@22.2.7(b1461d7cd9e3185ee679e7bd0f346a68)': + '@angular/build@22.2.7(1608556e09e6c425da111e5e30ff0d49)': + dependencies: + '@ampproject/remapping': 2.3.0 + '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) + '@angular/compiler': 22.2.6 + '@angular/compiler-cli': 22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3) + '@babel/core': 8.0.5 + '@inquirer/confirm': 6.3.2(@types/node@26.6.6) + '@parcel/watcher': 2.6.0 + '@vitejs/plugin-basic-ssl': 2.3.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + beasties: 0.5.4 + browserslist: 4.29.3 + chokidar: 5.0.0 + esbuild: 0.28.2 + https-proxy-agent: 9.1.0(supports-color@10.2.2) + jsonc-parser: 3.3.1 + listr2: 11.1.0 + magic-string: 1.4.1 + mrmime: 2.0.1 + oxc-parser: 0.156.0 + parse5-html-rewriting-stream: 8.0.1 + picomatch: 4.0.7 + piscina: 5.3.2 + rolldown: 1.2.16 + sass: 1.104.1 + sass-embedded: 1.104.1 + semver: 7.8.5 + source-map-support: 0.5.21 + tinyglobby: 0.2.17 + tslib: 2.8.1 + typescript: 6.0.3 + vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) + xxhash-wasm: 1.1.0 + optionalDependencies: + '@angular/core': 22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3) + '@angular/platform-browser': 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)) + '@angular/platform-server': 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/compiler@22.2.6)(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(@angular/platform-browser@22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)))(rxjs@7.8.2) + '@oxc-parser/binding-wasm32-wasi': 0.156.0 + istanbul-lib-instrument: 6.0.3(supports-color@10.2.2) + less: 4.9.1(supports-color@10.2.2) + lmdb: 3.5.6 + ng-packagr: 22.2.6(@angular/compiler-cli@22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3))(@volar/typescript@2.4.30(typescript@6.0.3))(@vue/language-core@3.3.14)(oxc-resolver@11.24.2)(supports-color@10.2.2)(tailwindcss@4.3.5)(tslib@2.9.1)(typescript@6.0.3)(vue-tsc@3.3.14(typescript@6.0.3)) + postcss: 8.5.28 + rollup: 4.67.4 + tailwindcss: 4.3.5 + vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + transitivePeerDependencies: + - '@types/node' + - '@vitejs/devtools' + - '@vitest/browser-playwright' + - '@vitest/ui' + - jiti + - kerberos + - stylus + - sugarss + - supports-color + - terser + - tsx + - vite + - yaml + + '@angular/build@22.2.7(5e8e06c5932a5ec96fb4c913c9d03d25)': dependencies: '@ampproject/remapping': 2.3.0 '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) @@ -12894,10 +13013,12 @@ snapshots: postcss: 8.5.33 rollup: 4.67.4 tailwindcss: 4.3.5 - vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: - '@types/node' - '@vitejs/devtools' + - '@vitest/browser-playwright' + - '@vitest/ui' - jiti - kerberos - stylus @@ -12905,9 +13026,10 @@ snapshots: - supports-color - terser - tsx + - vite - yaml - '@angular/build@22.2.7(d340a406dc22e6aebac2615013ad35e6)': + '@angular/build@22.2.7(8f1b78d10abefeadf4529127eb65e9b0)': dependencies: '@ampproject/remapping': 2.3.0 '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) @@ -12936,7 +13058,7 @@ snapshots: semver: 7.8.5 source-map-support: 0.5.21 tinyglobby: 0.2.17 - tslib: 2.8.1 + tslib: 2.9.1 typescript: 6.0.3 vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) xxhash-wasm: 1.1.0 @@ -12949,13 +13071,15 @@ snapshots: less: 4.9.1(supports-color@10.2.2) lmdb: 3.5.6 ng-packagr: 22.2.6(@angular/compiler-cli@22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3))(@volar/typescript@2.4.30(typescript@6.0.3))(@vue/language-core@3.3.14)(oxc-resolver@11.24.2)(supports-color@10.2.2)(tailwindcss@4.3.5)(tslib@2.9.1)(typescript@6.0.3)(vue-tsc@3.3.14(typescript@6.0.3)) - postcss: 8.5.28 + postcss: 8.5.33 rollup: 4.67.4 tailwindcss: 4.3.5 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: - '@types/node' - '@vitejs/devtools' + - '@vitest/browser-playwright' + - '@vitest/ui' - jiti - kerberos - stylus @@ -12963,6 +13087,7 @@ snapshots: - supports-color - terser - tsx + - vite - yaml '@angular/cli@22.2.7(@types/node@26.6.6)(chokidar@5.0.0)': @@ -14019,13 +14144,15 @@ snapshots: - debug - supports-color - '@codspeed/vitest-plugin@6.1.1(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + '@codspeed/vitest-plugin@6.1.1(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': dependencies: '@codspeed/core': 6.1.1(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2) tinybench: 6.2.3 vite: 8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: + - '@vitest/browser-playwright' + - '@vitest/ui' - debug - supports-color @@ -14903,7 +15030,7 @@ snapshots: '@modelcontextprotocol/core@2.3.1': dependencies: - zod: 4.6.7 + zod: 4.6.6 '@modelcontextprotocol/sdk@1.32.2(supports-color@10.2.2)(zod@4.6.7)': dependencies: @@ -14930,7 +15057,7 @@ snapshots: '@modelcontextprotocol/server@2.3.1': dependencies: '@modelcontextprotocol/core': 2.3.1 - zod: 4.6.7 + zod: 4.6.6 '@monaco-editor/loader@1.7.0': dependencies: @@ -18393,24 +18520,61 @@ snapshots: vite: 8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) vue: 3.5.45(typescript@6.0.3) - '@vitest/browser-playwright@5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + '@vitest/browser-playwright@5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + dependencies: + '@vitest/browser': 5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/mocker': 5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + playwright: 1.65.1 + tinyrainbow: 3.2.0 + vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + transitivePeerDependencies: + - '@vitest/ui' + - bufferutil + - msw + - utf-8-validate + - vite + optional: true + + '@vitest/browser-playwright@5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': dependencies: - '@vitest/browser': 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/browser': 5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) '@vitest/mocker': 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) playwright: 1.65.1 tinyrainbow: 3.2.0 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: + - '@vitest/ui' - bufferutil - msw - utf-8-validate - vite - '@vitest/browser@5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + '@vitest/browser@5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + dependencies: + '@blazediff/core': 1.10.0 + '@vitest/mocker': 5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/utils': 5.1.0 + magic-string: 1.4.5 + pngjs: 7.0.0 + sirv: 3.0.2 + tinyrainbow: 3.2.0 + vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + ws: 8.23.0 + transitivePeerDependencies: + - '@vitest/browser-playwright' + - '@vitest/ui' + - bufferutil + - msw + - utf-8-validate + - vite + optional: true + + '@vitest/browser@5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': dependencies: '@blazediff/core': 1.10.0 '@vitest/mocker': 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - '@vitest/ui': 5.1.0(vitest@5.1.0) + '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) '@vitest/utils': 5.1.0 magic-string: 1.4.5 pngjs: 7.0.0 @@ -18419,11 +18583,23 @@ snapshots: vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) ws: 8.23.0 transitivePeerDependencies: + - '@vitest/browser-playwright' + - '@vitest/ui' - bufferutil - msw - utf-8-validate - vite + '@vitest/mocker@5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': + dependencies: + '@jridgewell/trace-mapping': 0.3.31 + '@vitest/spy': 5.1.0 + estree-walker: 3.0.3 + magic-string: 1.4.5 + optionalDependencies: + vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) + optional: true + '@vitest/mocker@5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': dependencies: '@jridgewell/trace-mapping': 0.3.31 @@ -18439,7 +18615,21 @@ snapshots: '@vitest/spy@5.1.0': {} - '@vitest/ui@5.1.0(vitest@5.1.0)': + '@vitest/ui@5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + dependencies: + '@vitest/utils': 5.1.0 + fflate: 0.8.3 + flatted: 3.4.4 + pathe: 2.0.3 + sirv: 3.0.2 + tinyrainbow: 3.2.0 + vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + transitivePeerDependencies: + - '@vitest/browser-playwright' + - vite + optional: true + + '@vitest/ui@5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': dependencies: '@vitest/utils': 5.1.0 fflate: 0.8.3 @@ -18448,6 +18638,9 @@ snapshots: sirv: 3.0.2 tinyrainbow: 3.2.0 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + transitivePeerDependencies: + - '@vitest/browser-playwright' + - vite '@vitest/utils@5.1.0': dependencies: @@ -23223,7 +23416,7 @@ snapshots: rolldown@1.2.16: dependencies: '@oxc-project/types': 0.156.0 - '@rolldown/pluginutils': 1.0.1 + '@rolldown/pluginutils': 1.1.1 optionalDependencies: '@rolldown/binding-android-arm-eabi': 1.2.16 '@rolldown/binding-android-arm64': 1.2.16 @@ -24770,11 +24963,41 @@ snapshots: - typescript - universal-cookie - vitest-browser-svelte@3.1.0(svelte@5.58.0)(vitest@5.1.0): + vitest-browser-svelte@3.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(svelte@5.58.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0): dependencies: '@testing-library/svelte-core': 1.1.3(svelte@5.58.0) svelte: 5.58.0 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + transitivePeerDependencies: + - '@vitest/browser-playwright' + - '@vitest/ui' + - vite + + vitest@5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)): + dependencies: + '@types/chai': 5.2.3 + '@vitest/mocker': 5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + chai: 6.3.0 + es-module-lexer: 2.3.2 + expect-type: 1.4.0 + magic-string: 1.4.5 + obug: 3.0.0 + picomatch: 4.0.7 + std-env: 4.3.0 + tinybench: 6.2.3 + tinyexec: 1.3.1 + tinyglobby: 0.2.17 + vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) + why-is-node-running: 3.2.1 + optionalDependencies: + '@opentelemetry/api': 1.10.0 + '@types/node': 26.6.6 + '@vitest/browser-playwright': 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + happy-dom: 21.0.4 + transitivePeerDependencies: + - msw + optional: true vitest@5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)): dependencies: @@ -24795,8 +25018,8 @@ snapshots: optionalDependencies: '@opentelemetry/api': 1.10.0 '@types/node': 26.6.6 - '@vitest/browser-playwright': 5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) - '@vitest/ui': 5.1.0(vitest@5.1.0) + '@vitest/browser-playwright': 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) happy-dom: 21.0.4 transitivePeerDependencies: - msw From b1444f5b33d4450b556376582a3df45997357c60 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:40:59 -0500 Subject: [PATCH 05/11] docs(angular): initialize parsed document in ngOnInit --- docs/content/3.rendering/7.angular.md | 14 +++++++++----- docs/skills/comark/references/rendering-angular.md | 14 +++++++++----- packages/comark-angular/src/define.ts | 14 +++++++++----- 3 files changed, 27 insertions(+), 15 deletions(-) diff --git a/docs/content/3.rendering/7.angular.md b/docs/content/3.rendering/7.angular.md index d5fdeec33..363edaa26 100644 --- a/docs/content/3.rendering/7.angular.md +++ b/docs/content/3.rendering/7.angular.md @@ -580,8 +580,8 @@ The provider can also be scoped to a route or an ancestor component. Instance-le Pre-configure the low-level renderer the same way: ```typescript [page.component.ts] -import { Component } from '@angular/core' -import { parseMarkdown } from 'comark' +import { Component, OnInit } from '@angular/core' +import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' @@ -595,10 +595,14 @@ import { Math } from '@comark/angular/plugins/math' class: 'prose', }), ], - template: ``, + template: `@if (document) { }`, }) -export class PageComponent { - document = await parseMarkdown('# Hello') +export class PageComponent implements OnInit { + document?: MarkdownDocumentType + + async ngOnInit(): Promise { + this.document = await parseMarkdown('# Hello') + } } ``` diff --git a/docs/skills/comark/references/rendering-angular.md b/docs/skills/comark/references/rendering-angular.md index ece459b73..c73bbe7c7 100644 --- a/docs/skills/comark/references/rendering-angular.md +++ b/docs/skills/comark/references/rendering-angular.md @@ -512,8 +512,8 @@ Instance-level `options`, `plugins`, `components`, and `transformNode` inputs me ### defineMarkdownDocumentComponent ```typescript -import { Component } from '@angular/core' -import { parseMarkdown } from 'comark' +import { Component, OnInit } from '@angular/core' +import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' @@ -526,10 +526,14 @@ import { Math } from '@comark/angular/plugins/math' components: { Math }, }), ], - template: ``, + template: `@if (document) { }`, }) -export class DocsComponent { - document = await parseMarkdown('# Hello') +export class DocsComponent implements OnInit { + document?: MarkdownDocumentType + + async ngOnInit(): Promise { + this.document = await parseMarkdown('# Hello') + } } ``` diff --git a/packages/comark-angular/src/define.ts b/packages/comark-angular/src/define.ts index 3b31eef05..665f6d45f 100644 --- a/packages/comark-angular/src/define.ts +++ b/packages/comark-angular/src/define.ts @@ -82,8 +82,8 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = * * @example * ```typescript - * import { Component } from '@angular/core' - * import { parseMarkdown } from 'comark' + * import { Component, OnInit } from '@angular/core' + * import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' * import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' * import { Math } from '@comark/angular/plugins/math' * @@ -96,10 +96,14 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = * components: { Math }, * }), * ], - * template: ``, + * template: `@if (document) { }`, * }) - * export class DocsComponent { - * document = await parseMarkdown('# Hello') + * export class DocsComponent implements OnInit { + * document?: MarkdownDocumentType + * + * async ngOnInit(): Promise { + * this.document = await parseMarkdown('# Hello') + * } * } * ``` */ From a926222b00d18b5b5061546719bf65047358f2fd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:54:48 -0500 Subject: [PATCH 06/11] test: update angular bundle snapshot after deps upgrade --- test/bundle.test.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/test/bundle.test.ts b/test/bundle.test.ts index 63466bd3c..1fe7568a3 100644 --- a/test/bundle.test.ts +++ b/test/bundle.test.ts @@ -70,7 +70,7 @@ describe('package bundle size', { timeout: 60_000 }, () => { expect(report).toMatchInlineSnapshot(` { - "@comark/angular": "69.1k (63 files)", + "@comark/angular": "69.3k (63 files)", "@comark/ansi": "42.1k (109 files)", "@comark/html": "17.7k (69 files)", "@comark/nuxt": "11.0k (69 files)", From 5d6b21fda0d8a0b869ba7495017a6e864d908dcc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:56:22 -0500 Subject: [PATCH 07/11] Revert "feat(examples): add Angular framework blog example" This reverts commit cd089291971ad0b9bac60d260199e1f2cb78f73b. --- AGENTS.md | 4 +- examples/1.frameworks/angular/.gitignore | 44 --- examples/1.frameworks/angular/.postcssrc.json | 5 - examples/1.frameworks/angular/README.md | 23 -- examples/1.frameworks/angular/angular.json | 95 ------ examples/1.frameworks/angular/package.json | 33 -- .../1.frameworks/angular/public/favicon.ico | Bin 15086 -> 0 bytes .../public/posts/angular-integration.md | 53 ---- .../angular/public/posts/comark-syntax.md | 64 ---- .../angular/public/posts/hello-world.md | 32 -- .../angular/src/app/app.config.ts | 8 - .../angular/src/app/app.routes.ts | 8 - examples/1.frameworks/angular/src/app/app.ts | 41 --- .../src/app/components/alert.component.ts | 27 -- .../app/components/code-block.component.ts | 53 ---- .../app/components/feature-card.component.ts | 39 --- .../1.frameworks/angular/src/app/lib/posts.ts | 61 ---- .../src/app/pages/blog-post.component.ts | 77 ----- .../angular/src/app/pages/home.component.ts | 78 ----- examples/1.frameworks/angular/src/index.html | 24 -- examples/1.frameworks/angular/src/main.ts | 5 - examples/1.frameworks/angular/src/styles.css | 84 ------ .../1.frameworks/angular/tsconfig.app.json | 13 - examples/1.frameworks/angular/tsconfig.json | 28 -- package.json | 1 - pnpm-lock.yaml | 281 ++---------------- 26 files changed, 31 insertions(+), 1150 deletions(-) delete mode 100644 examples/1.frameworks/angular/.gitignore delete mode 100644 examples/1.frameworks/angular/.postcssrc.json delete mode 100644 examples/1.frameworks/angular/README.md delete mode 100644 examples/1.frameworks/angular/angular.json delete mode 100644 examples/1.frameworks/angular/package.json delete mode 100644 examples/1.frameworks/angular/public/favicon.ico delete mode 100644 examples/1.frameworks/angular/public/posts/angular-integration.md delete mode 100644 examples/1.frameworks/angular/public/posts/comark-syntax.md delete mode 100644 examples/1.frameworks/angular/public/posts/hello-world.md delete mode 100644 examples/1.frameworks/angular/src/app/app.config.ts delete mode 100644 examples/1.frameworks/angular/src/app/app.routes.ts delete mode 100644 examples/1.frameworks/angular/src/app/app.ts delete mode 100644 examples/1.frameworks/angular/src/app/components/alert.component.ts delete mode 100644 examples/1.frameworks/angular/src/app/components/code-block.component.ts delete mode 100644 examples/1.frameworks/angular/src/app/components/feature-card.component.ts delete mode 100644 examples/1.frameworks/angular/src/app/lib/posts.ts delete mode 100644 examples/1.frameworks/angular/src/app/pages/blog-post.component.ts delete mode 100644 examples/1.frameworks/angular/src/app/pages/home.component.ts delete mode 100644 examples/1.frameworks/angular/src/index.html delete mode 100644 examples/1.frameworks/angular/src/main.ts delete mode 100644 examples/1.frameworks/angular/src/styles.css delete mode 100644 examples/1.frameworks/angular/tsconfig.app.json delete mode 100644 examples/1.frameworks/angular/tsconfig.json diff --git a/AGENTS.md b/AGENTS.md index 4859be5fb..c53cedfa0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -25,7 +25,7 @@ Comark (`comark`) parses CommonMark and GitHub Flavored Markdown (GFM) into a co │ ├── comark-angular/ # Angular 21+ renderer (@comark/angular) │ └── comark-nuxt/ # Deprecated @comark/nuxt wrapper around @comark/vue/nuxt ├── examples/ -│ ├── 1.frameworks/ # Angular, Astro, Next.js, Nuxt, SvelteKit, VitePress +│ ├── 1.frameworks/ # Nuxt, Next.js, Astro, SvelteKit, VitePress │ ├── 2.vite/ # Vue, Vue streaming, React, Svelte, Angular, HTML, ANSI │ ├── 3.cli/ # ANSI output, prompts, OpenTelemetry tracing │ ├── 3.plugins/ # math, mermaid, highlight, rangi, punctuation, twoslash, binding, json-render @@ -305,7 +305,7 @@ pnpm lint:fix # oxlint --fix + oxfmt pnpm typecheck # Root `tsc --noEmit` pnpm verify # lint + test + typecheck pnpm docs # Start the documentation site (`docs/`) -pnpm dev: # Start an example app (vue, react, angular, angular-blog, html, ansi, nuxt, nextjs, astro, ...) +pnpm dev: # Start an example app (vue, react, svelte, angular, html, ansi, nuxt, nextjs, astro, ...) ``` ## CI, benchmarks, and releases diff --git a/examples/1.frameworks/angular/.gitignore b/examples/1.frameworks/angular/.gitignore deleted file mode 100644 index 854acd5fc..000000000 --- a/examples/1.frameworks/angular/.gitignore +++ /dev/null @@ -1,44 +0,0 @@ -# See https://docs.github.com/get-started/getting-started-with-git/ignoring-files for more about ignoring files. - -# Compiled output -/dist -/tmp -/out-tsc -/bazel-out - -# Node -/node_modules -npm-debug.log -yarn-error.log - -# IDEs and editors -.idea/ -.project -.classpath -.c9/ -*.launch -.settings/ -*.sublime-workspace - -# Visual Studio Code -.vscode/* -!.vscode/settings.json -!.vscode/tasks.json -!.vscode/launch.json -!.vscode/extensions.json -!.vscode/mcp.json -.history/* - -# Miscellaneous -/.angular/cache -.sass-cache/ -/connect.lock -/coverage -/libpeerconnection.log -testem.log -/typings -__screenshots__/ - -# System files -.DS_Store -Thumbs.db diff --git a/examples/1.frameworks/angular/.postcssrc.json b/examples/1.frameworks/angular/.postcssrc.json deleted file mode 100644 index e092dc7c1..000000000 --- a/examples/1.frameworks/angular/.postcssrc.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "plugins": { - "@tailwindcss/postcss": {} - } -} diff --git a/examples/1.frameworks/angular/README.md b/examples/1.frameworks/angular/README.md deleted file mode 100644 index 2347b7455..000000000 --- a/examples/1.frameworks/angular/README.md +++ /dev/null @@ -1,23 +0,0 @@ -# Angular blog with Comark - -This example renders a Markdown blog with Angular CLI and Comark. Posts live as `.md` files in `public/posts/`, parse with `parseMarkdown()` from `comark`, and render with `MarkdownDocument` from `@comark/angular`. - -## How it works - -- **File-based content**: `.md` files in `public/posts/` store post bodies and YAML frontmatter (`title`, `description`, `pubDate`, and `tags`). Angular CLI copies them to the site root, so the posts load with `fetch`. -- **Comark parsing**: `src/app/lib/posts.ts` calls `parseMarkdown()` with `shiki()` to build the `MarkdownDocument` and read frontmatter in one step, instead of chaining `gray-matter`, `remark`, and `rehype`. -- **Config providers**: `defineMarkdownDocumentComponent()` returns a provider for `MARKDOWN_DOCUMENT_CONFIG`. The static `MarkdownDocument` component stays in `imports`, so Angular AOT compiles it without NG1010. -- **Custom components**: `Alert`, the slot-aware `FeatureCard`, and `CodeBlock` map from Markdown tags to Angular components. The copy button is the only interactive part. - -## Run locally - -From the monorepo root: - -```bash -pnpm dev:angular-blog -``` - -## Documentation - -- [Comark documentation](https://comark.dev) -- [Angular rendering](https://comark.dev/rendering/angular) diff --git a/examples/1.frameworks/angular/angular.json b/examples/1.frameworks/angular/angular.json deleted file mode 100644 index 61401929f..000000000 --- a/examples/1.frameworks/angular/angular.json +++ /dev/null @@ -1,95 +0,0 @@ -{ - "$schema": "./node_modules/@angular/cli/lib/config/schema.json", - "version": 1, - "cli": { - "packageManager": "pnpm" - }, - "newProjectRoot": "projects", - "projects": { - "angular": { - "projectType": "application", - "schematics": { - "@schematics/angular:component": { - "inlineTemplate": true, - "inlineStyle": true, - "skipTests": true - }, - "@schematics/angular:class": { - "skipTests": true - }, - "@schematics/angular:directive": { - "skipTests": true - }, - "@schematics/angular:guard": { - "skipTests": true - }, - "@schematics/angular:interceptor": { - "skipTests": true - }, - "@schematics/angular:pipe": { - "skipTests": true - }, - "@schematics/angular:resolver": { - "skipTests": true - }, - "@schematics/angular:service": { - "skipTests": true - } - }, - "root": "", - "sourceRoot": "src", - "prefix": "app", - "architect": { - "build": { - "builder": "@angular/build:application", - "options": { - "browser": "src/main.ts", - "tsConfig": "tsconfig.app.json", - "assets": [ - { - "glob": "**/*", - "input": "public" - } - ], - "styles": ["src/styles.css"] - }, - "configurations": { - "production": { - "budgets": [ - { - "type": "initial", - "maximumWarning": "1MB", - "maximumError": "2MB" - }, - { - "type": "anyComponentStyle", - "maximumWarning": "4kB", - "maximumError": "8kB" - } - ], - "outputHashing": "all" - }, - "development": { - "optimization": false, - "extractLicenses": false, - "sourceMap": true - } - }, - "defaultConfiguration": "production" - }, - "serve": { - "builder": "@angular/build:dev-server", - "configurations": { - "production": { - "buildTarget": "angular:build:production" - }, - "development": { - "buildTarget": "angular:build:development" - } - }, - "defaultConfiguration": "development" - } - } - } - } -} diff --git a/examples/1.frameworks/angular/package.json b/examples/1.frameworks/angular/package.json deleted file mode 100644 index b3c4bb3fd..000000000 --- a/examples/1.frameworks/angular/package.json +++ /dev/null @@ -1,33 +0,0 @@ -{ - "name": "comark-angular-blog", - "version": "0.0.1", - "private": true, - "scripts": { - "ng": "ng", - "dev": "ng serve", - "start": "ng serve", - "build": "ng build", - "watch": "ng build --watch --configuration development" - }, - "dependencies": { - "@angular/common": "^22.2.0", - "@angular/compiler": "^22.2.0", - "@angular/core": "^22.2.0", - "@angular/platform-browser": "^22.2.0", - "@angular/router": "^22.2.0", - "@comark/angular": "workspace:*", - "comark": "workspace:*", - "rxjs": "~7.8.0", - "shiki": "catalog:", - "tslib": "^2.3.0" - }, - "devDependencies": { - "@angular/build": "^22.2.7", - "@angular/cli": "^22.2.7", - "@angular/compiler-cli": "^22.2.0", - "@tailwindcss/postcss": "^4.1.12", - "postcss": "^8.5.3", - "tailwindcss": "^4.1.12", - "typescript": "~6.0.2" - } -} diff --git a/examples/1.frameworks/angular/public/favicon.ico b/examples/1.frameworks/angular/public/favicon.ico deleted file mode 100644 index 57614f9c967596fad0a3989bec2b1deff33034f6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15086 zcmd^G33O9Omi+`8$@{|M-I6TH3wzF-p5CV8o}7f~KxR60LK+ApEFB<$bcciv%@SmA zV{n>g85YMFFeU*Uvl=i4v)C*qgnb;$GQ=3XTe9{Y%c`mO%su)noNCCQ*@t1WXn|B(hQ7i~ zrUK8|pUkD6#lNo!bt$6)jR!&C?`P5G(`e((P($RaLeq+o0Vd~f11;qB05kdbAOm?r zXv~GYr_sibQO9NGTCdT;+G(!{4Xs@4fPak8#L8PjgJwcs-Mm#nR_Z0s&u?nDX5^~@ z+A6?}g0|=4e_LoE69pPFO`yCD@BCjgKpzMH0O4Xs{Ahc?K3HC5;l=f zg>}alhBXX&);z$E-wai+9TTRtBX-bWYY@cl$@YN#gMd~tM_5lj6W%8ah4;uZ;jP@Q zVbuel1rPA?2@x9Y+u?e`l{Z4ngfG5q5BLH5QsEu4GVpt{KIp1?U)=3+KQ;%7ec8l* zdV=zZgN5>O3G(3L2fqj3;oBbZZw$Ij@`Juz@?+yy#OPw)>#wsTewVgTK9BGt5AbZ&?K&B3GVF&yu?@(Xj3fR3n+ZP0%+wo)D9_xp>Z$`A4 zfV>}NWjO#3lqumR0`gvnffd9Ka}JJMuHS&|55-*mCD#8e^anA<+sFZVaJe7{=p*oX zE_Uv?1>e~ga=seYzh{9P+n5<+7&9}&(kwqSaz;1aD|YM3HBiy<))4~QJSIryyqp| z8nGc(8>3(_nEI4n)n7j(&d4idW1tVLjZ7QbNLXg;LB ziHsS5pXHEjGJZb59KcvS~wv;uZR-+4qEqow`;JCfB*+b^UL^3!?;-^F%yt=VjU|v z39SSqKcRu_NVvz!zJzL0CceJaS6%!(eMshPv_0U5G`~!a#I$qI5Ic(>IONej@aH=f z)($TAT#1I{iCS4f{D2+ApS=$3E7}5=+y(rA9mM#;Cky%b*Gi0KfFA`ofKTzu`AV-9 znW|y@19rrZ*!N2AvDi<_ZeR3O2R{#dh1#3-d%$k${Rx42h+i&GZo5!C^dSL34*AKp z27mTd>k>?V&X;Nl%GZ(>0s`1UN~Hfyj>KPjtnc|)xM@{H_B9rNr~LuH`Gr5_am&Ep zTjZA8hljNj5H1Ipm-uD9rC}U{-vR!eay5&6x6FkfupdpT*84MVwGpdd(}ib)zZ3Ky z7C$pnjc82(W_y_F{PhYj?o!@3__UUvpX)v69aBSzYj3 zdi}YQkKs^SyXyFG2LTRz9{(w}y~!`{EuAaUr6G1M{*%c+kP1olW9z23dSH!G4_HSK zzae-DF$OGR{ofP*!$a(r^5Go>I3SObVI6FLY)N@o<*gl0&kLo-OT{Tl*7nCz>Iq=? zcigIDHtj|H;6sR?or8Wd_a4996GI*CXGU}o;D9`^FM!AT1pBY~?|4h^61BY#_yIfO zKO?E0 zJ{Pc`9rVEI&$xxXu`<5E)&+m(7zX^v0rqofLs&bnQT(1baQkAr^kEsk)15vlzAZ-l z@OO9RF<+IiJ*O@HE256gCt!bF=NM*vh|WVWmjVawcNoksRTMvR03H{p@cjwKh(CL4 z7_PB(dM=kO)!s4fW!1p0f93YN@?ZSG` z$B!JaAJCtW$B97}HNO9(x-t30&E}Mo1UPi@Av%uHj~?T|!4JLwV;KCx8xO#b9IlUW zI6+{a@Wj|<2Y=U;a@vXbxqZNngH8^}LleE_4*0&O7#3iGxfJ%Id>+sb;7{L=aIic8 z|EW|{{S)J-wr@;3PmlxRXU8!e2gm_%s|ReH!reFcY8%$Hl4M5>;6^UDUUae?kOy#h zk~6Ee_@ZAn48Bab__^bNmQ~+k=02jz)e0d9Z3>G?RGG!65?d1>9}7iG17?P*=GUV-#SbLRw)Hu{zx*azHxWkGNTWl@HeWjA?39Ia|sCi{e;!^`1Oec zb>Z|b65OM*;eC=ZLSy?_fg$&^2xI>qSLA2G*$nA3GEnp3$N-)46`|36m*sc#4%C|h zBN<2U;7k>&G_wL4=Ve5z`ubVD&*Hxi)r@{4RCDw7U_D`lbC(9&pG5C*z#W>8>HU)h z!h3g?2UL&sS!oY5$3?VlA0Me9W5e~V;2jds*fz^updz#AJ%G8w2V}AEE?E^=MK%Xt z__Bx1cr7+DQmuHmzn*|hh%~eEc9@m05@clWfpEFcr+06%0&dZJH&@8^&@*$qR@}o3 z@Tuuh2FsLz^zH+dN&T&?0G3I?MpmYJ;GP$J!EzjeM#YLJ!W$}MVNb0^HfOA>5Fe~UNn%Zk(PT@~9}1dt)1UQ zU*B5K?Dl#G74qmg|2>^>0WtLX#Jz{lO4NT`NYB*(L#D|5IpXr9v&7a@YsGp3vLR7L zHYGHZg7{ie6n~2p$6Yz>=^cEg7tEgk-1YRl%-s7^cbqFb(U7&Dp78+&ut5!Tn(hER z|Gp4Ed@CnOPeAe|N>U(dB;SZ?NU^AzoD^UAH_vamp6Ws}{|mSq`^+VP1g~2B{%N-!mWz<`)G)>V-<`9`L4?3dM%Qh6<@kba+m`JS{Ya@9Fq*m6$$ zA1%Ogc~VRH33|S9l%CNb4zM%k^EIpqY}@h{w(aBcJ9c05oiZx#SK9t->5lSI`=&l~ z+-Ic)a{FbBhXV$Xt!WRd`R#Jk-$+_Z52rS>?Vpt2IK<84|E-SBEoIw>cs=a{BlQ7O z-?{Fy_M&84&9|KM5wt~)*!~i~E=(6m8(uCO)I=)M?)&sRbzH$9Rovzd?ZEY}GqX+~ zFbEbLz`BZ49=2Yh-|<`waK-_4!7`ro@zlC|r&I4fc4oyb+m=|c8)8%tZ-z5FwhzDt zL5kB@u53`d@%nHl0Sp)Dw`(QU&>vujEn?GPEXUW!Wi<+4e%BORl&BIH+SwRcbS}X@ z01Pk|vA%OdJKAs17zSXtO55k!;%m9>1eW9LnyAX4uj7@${O6cfii`49qTNItzny5J zH&Gj`e}o}?xjQ}r?LrI%FjUd@xflT3|7LA|ka%Q3i}a8gVm<`HIWoJGH=$EGClX^C0lysQJ>UO(q&;`T#8txuoQ_{l^kEV9CAdXuU1Ghg8 zN_6hHFuy&1x24q5-(Z7;!poYdt*`UTdrQOIQ!2O7_+AHV2hgXaEz7)>$LEdG z<8vE^Tw$|YwZHZDPM!SNOAWG$?J)MdmEk{U!!$M#fp7*Wo}jJ$Q(=8>R`Ats?e|VU?Zt7Cdh%AdnfyN3MBWw{ z$OnREvPf7%z6`#2##_7id|H%Y{vV^vWXb?5d5?a_y&t3@p9t$ncHj-NBdo&X{wrfJ zamN)VMYROYh_SvjJ=Xd!Ga?PY_$;*L=SxFte!4O6%0HEh%iZ4=gvns7IWIyJHa|hT z2;1+e)`TvbNb3-0z&DD_)Jomsg-7p_Uh`wjGnU1urmv1_oVqRg#=C?e?!7DgtqojU zWoAB($&53;TsXu^@2;8M`#z{=rPy?JqgYM0CDf4v@z=ZD|ItJ&8%_7A#K?S{wjxgd z?xA6JdJojrWpB7fr2p_MSsU4(R7=XGS0+Eg#xR=j>`H@R9{XjwBmqAiOxOL` zt?XK-iTEOWV}f>Pz3H-s*>W z4~8C&Xq25UQ^xH6H9kY_RM1$ch+%YLF72AA7^b{~VNTG}Tj#qZltz5Q=qxR`&oIlW Nr__JTFzvMr^FKp4S3v*( diff --git a/examples/1.frameworks/angular/public/posts/angular-integration.md b/examples/1.frameworks/angular/public/posts/angular-integration.md deleted file mode 100644 index 283f505e1..000000000 --- a/examples/1.frameworks/angular/public/posts/angular-integration.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Integrating Comark with Angular -description: How this blog renders Markdown with Comark and Angular standalone components. -pubDate: 2026-01-10 -tags: [comark, angular, integration] ---- - -This example pairs Angular CLI with `parseMarkdown()` and `@comark/angular`. - -## How it works - -Instead of chaining `gray-matter`, `remark`, and `rehype`, `src/app/lib/posts.ts` parses Markdown and frontmatter in a single call: - -1. **Load Markdown files**: fetch `.md` files from `public/posts/` at runtime. -2. **Parse with Comark**: call `parseMarkdown()` with `shiki()` to build the `MarkdownDocument` and read `tree.frontmatter`. -3. **Render in a component**: pass the document to `MarkdownDocument` and register custom components through a config provider. - -```ts -import { parseMarkdown } from 'comark' -import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' -import shiki from 'comark/plugins/shiki' -import { AlertComponent } from './components/alert.component' - -const document = await parseMarkdown(markdown, { - plugins: [shiki()], -}) - -// providers: [defineMarkdownDocumentComponent({ components: { alert: AlertComponent } })] -``` - -::alert{type="info"} -`defineMarkdownDocumentComponent()` returns a `Provider` for `MARKDOWN_DOCUMENT_CONFIG`. The static `MarkdownDocument` component stays in `imports`, which keeps Angular AOT happy (NG1010). -:: - -## Custom components - -Register custom components in `defineMarkdownDocumentComponent()`. Each component receives resolved attributes as inputs and nested Markdown through ``: - -```ts -@Component({ - selector: 'app-alert', - template: ` -
- -
- `, -}) -export class AlertComponent { - readonly type = input('info') -} -``` - -Instance-level inputs merge with the provider config and win on conflict. `transformNode` from the config runs before the instance transform. diff --git a/examples/1.frameworks/angular/public/posts/comark-syntax.md b/examples/1.frameworks/angular/public/posts/comark-syntax.md deleted file mode 100644 index 8ca84afb1..000000000 --- a/examples/1.frameworks/angular/public/posts/comark-syntax.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Comark syntax guide -description: A tour of standard Markdown, custom components, and named slots in Comark. -pubDate: 2025-12-15 -tags: [comark, syntax, components] ---- - -Comark adds block and inline component syntax to CommonMark and GFM. - -## Inline formatting - -Standard Markdown formatting works everywhere: **bold**, *italic*, `code`, and [links](https://comark.dev). - -## Components - -Block components open and close with `::` and accept props in `{...}`: - -::alert{type="warning"} -Double colons open a block component, and props inside curly braces pass directly to the rendered Angular component. -:: - -## Component slots - -Angular components project default content with `` and named `#slot` sections with ``: - -::feature-card -#header -Slot-aware Angular component - -#default -This body renders in the default slot. It can contain **Markdown**, links, lists, or nested Comark components. - -#footer -Rendered through the footer slot in `FeatureCardComponent`. -:: - -## Lists - -Unordered and ordered lists support nested inline formatting: - -- First item -- Second item with **bold** text -- Third item with `inline code` - -1. Numbered items -2. Nested Markdown inside each item - -## Code blocks - -Fenced code blocks highlight through the `shiki` plugin: - -```js -function greet(name) { - return `Hello, ${name}!` -} -``` - -## Block quotes - -> Standard block quotes, lists, and code blocks can sit outside or inside custom components. - -::alert{type="danger"} -Close block components with `::`. During streaming, `autoClose` closes unfinished blocks until the closing marker arrives. -:: diff --git a/examples/1.frameworks/angular/public/posts/hello-world.md b/examples/1.frameworks/angular/public/posts/hello-world.md deleted file mode 100644 index 9c1ef474c..000000000 --- a/examples/1.frameworks/angular/public/posts/hello-world.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Hello world -description: Getting started with Comark and Angular. -pubDate: 2025-12-01 -tags: [comark, angular] ---- - -Welcome to this blog built with **Comark** and Angular. - -Comark adds component and attribute syntax to Markdown and renders through Angular components. The Markdown files load with `fetch`, parse with `parseMarkdown()`, and render with `MarkdownDocument` from `@comark/angular`. - -::alert{type="info"} -This alert renders through a custom Angular component. Parser code stays out of the template. -:: - -## Why pair Comark with Angular - -- **Standalone components**: `MarkdownDocument` drops into any standalone component's `imports`. -- **Config providers**: `defineMarkdownDocumentComponent()` registers plugins and component mappings through Angular DI. -- **Component syntax**: write `::alert` and `::feature-card` blocks directly in `.md` files. - -```ts -import { parseMarkdown } from 'comark' -import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' - -const document = await parseMarkdown(markdown) -// providers: [defineMarkdownDocumentComponent({ components: { Alert } })] -``` - -::alert{type="success"} -Angular handles routing and the build while Comark parses frontmatter, highlights code, and renders custom components. -:: diff --git a/examples/1.frameworks/angular/src/app/app.config.ts b/examples/1.frameworks/angular/src/app/app.config.ts deleted file mode 100644 index 70ea96156..000000000 --- a/examples/1.frameworks/angular/src/app/app.config.ts +++ /dev/null @@ -1,8 +0,0 @@ -import type { ApplicationConfig } from '@angular/core' -import { provideBrowserGlobalErrorListeners } from '@angular/core' -import { provideRouter } from '@angular/router' -import { routes } from './app.routes' - -export const appConfig: ApplicationConfig = { - providers: [provideBrowserGlobalErrorListeners(), provideRouter(routes)], -} diff --git a/examples/1.frameworks/angular/src/app/app.routes.ts b/examples/1.frameworks/angular/src/app/app.routes.ts deleted file mode 100644 index c45da76e6..000000000 --- a/examples/1.frameworks/angular/src/app/app.routes.ts +++ /dev/null @@ -1,8 +0,0 @@ -import type { Routes } from '@angular/router' -import { HomeComponent } from './pages/home.component' -import { BlogPostComponent } from './pages/blog-post.component' - -export const routes: Routes = [ - { path: '', component: HomeComponent }, - { path: 'blog/:slug', component: BlogPostComponent }, -] diff --git a/examples/1.frameworks/angular/src/app/app.ts b/examples/1.frameworks/angular/src/app/app.ts deleted file mode 100644 index 982251381..000000000 --- a/examples/1.frameworks/angular/src/app/app.ts +++ /dev/null @@ -1,41 +0,0 @@ -import { Component } from '@angular/core' -import { RouterLink, RouterOutlet } from '@angular/router' - -@Component({ - selector: 'app-root', - imports: [RouterLink, RouterOutlet], - template: ` -
-
- -
-
- -
- -
- `, -}) -export class App {} diff --git a/examples/1.frameworks/angular/src/app/components/alert.component.ts b/examples/1.frameworks/angular/src/app/components/alert.component.ts deleted file mode 100644 index e4a0737b6..000000000 --- a/examples/1.frameworks/angular/src/app/components/alert.component.ts +++ /dev/null @@ -1,27 +0,0 @@ -import { Component, input } from '@angular/core' - -@Component({ - selector: 'app-alert', - template: ` -
- -
- `, -}) -export class AlertComponent { - readonly type = input<'info' | 'warning' | 'success' | 'danger'>('info') - - readonly baseClass = 'my-4 rounded-lg border-l-4 px-4 py-3 text-sm leading-relaxed' - - readonly styles: Record = { - info: 'bg-blue-50 border-blue-400 text-blue-900 dark:bg-blue-950/50 dark:border-blue-500/50 dark:text-blue-200', - warning: - 'bg-amber-50 border-amber-400 text-amber-900 dark:bg-amber-950/50 dark:border-amber-500/50 dark:text-amber-200', - success: - 'bg-emerald-50 border-emerald-400 text-emerald-900 dark:bg-emerald-950/50 dark:border-emerald-500/50 dark:text-emerald-200', - danger: 'bg-red-50 border-red-400 text-red-900 dark:bg-red-950/50 dark:border-red-500/50 dark:text-red-200', - } -} diff --git a/examples/1.frameworks/angular/src/app/components/code-block.component.ts b/examples/1.frameworks/angular/src/app/components/code-block.component.ts deleted file mode 100644 index e36aa342a..000000000 --- a/examples/1.frameworks/angular/src/app/components/code-block.component.ts +++ /dev/null @@ -1,53 +0,0 @@ -import { Component, DestroyRef, computed, inject, input, signal } from '@angular/core' -import type { ElementNode } from 'comark' -import { textContent } from 'comark/utils' - -@Component({ - selector: 'app-code-block', - template: ` -
-
- {{ label() }} - -
-
-
- `, -}) -export class CodeBlockComponent { - readonly __node = input() - readonly filename = input() - readonly language = input() - - readonly code = computed(() => (this.__node() ? textContent(this.__node()!) : '')) - readonly label = computed(() => this.filename() || this.language()?.toUpperCase() || 'Code') - readonly copied = signal(false) - - private resetTimer?: ReturnType - - constructor() { - inject(DestroyRef).onDestroy(() => clearTimeout(this.resetTimer)) - } - - async copy(): Promise { - try { - await navigator.clipboard.writeText(this.code()) - this.copied.set(true) - clearTimeout(this.resetTimer) - this.resetTimer = setTimeout(() => this.copied.set(false), 2000) - } catch { - this.copied.set(false) - } - } -} diff --git a/examples/1.frameworks/angular/src/app/components/feature-card.component.ts b/examples/1.frameworks/angular/src/app/components/feature-card.component.ts deleted file mode 100644 index 95accb59a..000000000 --- a/examples/1.frameworks/angular/src/app/components/feature-card.component.ts +++ /dev/null @@ -1,39 +0,0 @@ -import { AfterViewInit, Component, ElementRef, ViewChild, inject } from '@angular/core' - -@Component({ - selector: 'app-feature-card', - template: ` -
-
-
- -
-
-
- `, -}) -export class FeatureCardComponent implements AfterViewInit { - private readonly host = inject>(ElementRef) - - @ViewChild('header') private header?: ElementRef - @ViewChild('footer') private footer?: ElementRef - - ngAfterViewInit(): void { - this.moveSlot('header', this.header?.nativeElement) - this.moveSlot('footer', this.footer?.nativeElement) - } - - private moveSlot(name: string, container?: HTMLElement): void { - if (!container) return - const slot = this.host.nativeElement.querySelector(`:scope > div[slot="${name}"]`) - if (slot) container.appendChild(slot) - } -} diff --git a/examples/1.frameworks/angular/src/app/lib/posts.ts b/examples/1.frameworks/angular/src/app/lib/posts.ts deleted file mode 100644 index 41e65b529..000000000 --- a/examples/1.frameworks/angular/src/app/lib/posts.ts +++ /dev/null @@ -1,61 +0,0 @@ -import { parseMarkdown, type MarkdownDocument } from 'comark' -import shiki from 'comark/plugins/shiki' - -const slugs = ['hello-world', 'comark-syntax', 'angular-integration'] - -export interface PostMeta { - slug: string - title: string - description: string - pubDate: string - tags: string[] -} - -export interface Post extends PostMeta { - tree: MarkdownDocument -} - -interface Frontmatter { - title?: unknown - description?: unknown - pubDate?: unknown - tags?: unknown -} - -function text(value: unknown): string { - return value == null ? '' : String(value) -} - -async function readPost(slug: string): Promise { - const url = new URL(`posts/${slug}.md`, document.baseURI) - const response = await fetch(url) - if (!response.ok) throw new Error(`Post not found: ${slug}`) - return response.text() -} - -function metadata(slug: string, frontmatter: Frontmatter): PostMeta { - return { - slug, - title: text(frontmatter.title), - description: text(frontmatter.description), - pubDate: text(frontmatter.pubDate), - tags: Array.isArray(frontmatter.tags) ? frontmatter.tags.map(text) : [], - } -} - -export async function getAllPosts(): Promise { - const posts = await Promise.all( - slugs.map(async (slug) => { - const tree = await parseMarkdown(await readPost(slug)) - return metadata(slug, tree.frontmatter as Frontmatter) - }) - ) - return posts.sort((a, b) => new Date(b.pubDate).valueOf() - new Date(a.pubDate).valueOf()) -} - -export async function getPost(slug: string): Promise { - if (!slugs.includes(slug)) throw new Error(`Post not found: ${slug}`) - - const tree = await parseMarkdown(await readPost(slug), { plugins: [shiki()] }) - return { ...metadata(slug, tree.frontmatter as Frontmatter), tree } -} diff --git a/examples/1.frameworks/angular/src/app/pages/blog-post.component.ts b/examples/1.frameworks/angular/src/app/pages/blog-post.component.ts deleted file mode 100644 index 9f38a8291..000000000 --- a/examples/1.frameworks/angular/src/app/pages/blog-post.component.ts +++ /dev/null @@ -1,77 +0,0 @@ -import { Component, inject, signal } from '@angular/core' -import { Title } from '@angular/platform-browser' -import { ActivatedRoute, RouterLink } from '@angular/router' -import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' -import { AlertComponent } from '../components/alert.component' -import { CodeBlockComponent } from '../components/code-block.component' -import { FeatureCardComponent } from '../components/feature-card.component' -import { getPost, type Post } from '../lib/posts' - -@Component({ - selector: 'app-blog-post', - imports: [MarkdownDocument, RouterLink], - providers: [ - defineMarkdownDocumentComponent({ - components: { - alert: AlertComponent, - 'feature-card': FeatureCardComponent, - pre: CodeBlockComponent, - }, - class: 'prose', - }), - ], - template: ` - @if (post(); as current) { -
-
- - ← Back to all posts - -

{{ current.title }}

-
- -
- @for (tag of current.tags; track tag) { - - {{ tag }} - - } -
-
-
- -
- } - `, -}) -export class BlogPostComponent { - private readonly route = inject(ActivatedRoute) - private readonly title = inject(Title) - readonly post = signal(null) - - constructor() { - this.route.params.subscribe((params) => { - const slug = params['slug'] - if (slug) { - getPost(slug).then((post) => { - this.post.set(post) - this.title.setTitle(`${post.title} | Comark Blog`) - }) - } - }) - } - - formatDate(date: string): string { - return new Date(date).toLocaleDateString('en-US', { - year: 'numeric', - month: 'long', - day: 'numeric', - timeZone: 'UTC', - }) - } -} diff --git a/examples/1.frameworks/angular/src/app/pages/home.component.ts b/examples/1.frameworks/angular/src/app/pages/home.component.ts deleted file mode 100644 index f65cd24a7..000000000 --- a/examples/1.frameworks/angular/src/app/pages/home.component.ts +++ /dev/null @@ -1,78 +0,0 @@ -import { Component, inject, signal } from '@angular/core' -import { Title } from '@angular/platform-browser' -import { RouterLink } from '@angular/router' -import { getAllPosts, type PostMeta } from '../lib/posts' - -@Component({ - selector: 'app-home', - imports: [RouterLink], - template: ` -
-

Comark Blog

-

- A blog built with - Angular - and - Comark - rendering. -

- @if (posts().length === 0) { -

Loading posts...

- } - -
- `, -}) -export class HomeComponent { - readonly posts = signal([]) - - constructor() { - inject(Title).setTitle('Comark Blog') - getAllPosts().then((posts) => this.posts.set(posts)) - } - - formatDate(date: string): string { - return new Date(date).toLocaleDateString('en-US', { - year: 'numeric', - month: 'long', - day: 'numeric', - timeZone: 'UTC', - }) - } -} diff --git a/examples/1.frameworks/angular/src/index.html b/examples/1.frameworks/angular/src/index.html deleted file mode 100644 index 83c505f11..000000000 --- a/examples/1.frameworks/angular/src/index.html +++ /dev/null @@ -1,24 +0,0 @@ - - - - - Comark Blog - - - - - - - - - diff --git a/examples/1.frameworks/angular/src/main.ts b/examples/1.frameworks/angular/src/main.ts deleted file mode 100644 index 8192dca69..000000000 --- a/examples/1.frameworks/angular/src/main.ts +++ /dev/null @@ -1,5 +0,0 @@ -import { bootstrapApplication } from '@angular/platform-browser' -import { appConfig } from './app/app.config' -import { App } from './app/app' - -bootstrapApplication(App, appConfig).catch((err) => console.error(err)) diff --git a/examples/1.frameworks/angular/src/styles.css b/examples/1.frameworks/angular/src/styles.css deleted file mode 100644 index 2c6b73da9..000000000 --- a/examples/1.frameworks/angular/src/styles.css +++ /dev/null @@ -1,84 +0,0 @@ -@import 'tailwindcss'; - -body { - @apply bg-neutral-50 dark:bg-neutral-950 text-neutral-900 dark:text-neutral-50 min-h-screen flex flex-col; -} - -header { - @apply border-b border-neutral-200 dark:border-neutral-800; -} - -header nav { - @apply max-w-2xl mx-auto px-6 py-4; -} - -header nav a { - @apply text-lg font-semibold text-neutral-900 dark:text-neutral-50 no-underline; -} - -main { - @apply max-w-2xl mx-auto px-6 py-8 flex-1 w-full; -} - -footer { - @apply border-t border-neutral-200 dark:border-neutral-800 text-center text-sm text-neutral-500 dark:text-neutral-400 py-6; -} - -footer a { - @apply text-neutral-700 dark:text-neutral-300 underline; -} - -/* Prose styles for rendered Comark content */ -.prose h1 { - @apply text-3xl font-bold mb-4 mt-0; -} -.prose h2 { - @apply text-2xl font-semibold mt-8 mb-3; -} -.prose h3 { - @apply text-xl font-semibold mt-6 mb-2; -} -.prose p { - @apply mb-4 leading-relaxed; -} -.prose a { - @apply text-blue-600 dark:text-blue-400 underline; -} -.prose strong { - @apply font-semibold; -} -.prose ul { - @apply list-disc pl-6 mb-4 space-y-1; -} -.prose ol { - @apply list-decimal pl-6 mb-4 space-y-1; -} -.prose li { - @apply leading-relaxed; -} -.prose blockquote { - @apply border-l-4 border-neutral-300 dark:border-neutral-700 pl-4 italic text-neutral-600 dark:text-neutral-400 my-4; -} -.prose code { - @apply bg-neutral-200 dark:bg-neutral-800 px-1.5 py-0.5 rounded text-sm font-mono; -} -.prose pre { - @apply bg-neutral-100 dark:bg-neutral-800 dark:text-neutral-100 text-neutral-800 rounded-lg p-4 overflow-x-auto mb-4; -} -.prose pre code { - @apply bg-transparent p-0 text-inherit; -} - -.prose .code-block { - @apply mb-4 overflow-hidden rounded-lg border border-neutral-200 dark:border-neutral-700; -} -.prose .code-block-header { - @apply flex items-center justify-between bg-neutral-100 px-3 py-1.5 text-xs text-neutral-500 dark:bg-neutral-800 dark:text-neutral-400; -} -.prose .code-block pre { - @apply mb-0 rounded-none; -} - -.shiki span.line { - display: block; -} diff --git a/examples/1.frameworks/angular/tsconfig.app.json b/examples/1.frameworks/angular/tsconfig.app.json deleted file mode 100644 index 811c7fae4..000000000 --- a/examples/1.frameworks/angular/tsconfig.app.json +++ /dev/null @@ -1,13 +0,0 @@ -/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */ -/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */ -{ - "extends": "./tsconfig.json", - "compilerOptions": { - "types": [], - "allowImportingTsExtensions": true, - "rewriteRelativeImportExtensions": true, - "noPropertyAccessFromIndexSignature": false - }, - "include": ["src/**/*.ts"], - "exclude": ["src/**/*.spec.ts"] -} diff --git a/examples/1.frameworks/angular/tsconfig.json b/examples/1.frameworks/angular/tsconfig.json deleted file mode 100644 index 30d64cea3..000000000 --- a/examples/1.frameworks/angular/tsconfig.json +++ /dev/null @@ -1,28 +0,0 @@ -/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */ -/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */ -{ - "compileOnSave": false, - "compilerOptions": { - "noImplicitOverride": true, - "noPropertyAccessFromIndexSignature": true, - "noImplicitReturns": true, - "noFallthroughCasesInSwitch": true, - "skipLibCheck": true, - "isolatedModules": true, - "experimentalDecorators": true, - "importHelpers": true, - "target": "ES2022", - "module": "preserve" - }, - "angularCompilerOptions": { - "enableI18nLegacyMessageIdFormat": false, - "strictInjectionParameters": true, - "strictInputAccessModifiers": true - }, - "files": [], - "references": [ - { - "path": "./tsconfig.app.json" - } - ] -} diff --git a/package.json b/package.json index fa5fad6ae..c7c56bf0f 100644 --- a/package.json +++ b/package.json @@ -14,7 +14,6 @@ "dev:react": "pnpm --filter comark-react run dev", "dev:svelte": "pnpm --filter comark-svelte run dev", "dev:angular": "pnpm --filter comark-angular run dev", - "dev:angular-blog": "pnpm --filter comark-angular-blog run dev", "dev:ansi": "pnpm --filter comark-ansi run dev", "dev:vue": "pnpm --filter comark-vue run dev", "dev:vue:mermaid": "pnpm --filter comark-vue-vite-mermaid run dev", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index b2c0c97a9..b4e1f6809 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -500,7 +500,7 @@ importers: devDependencies: '@codspeed/vitest-plugin': specifier: 'catalog:' - version: 6.1.1(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 6.1.1(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) '@comark/ansi': specifier: workspace:* version: link:packages/comark-ansi @@ -647,61 +647,6 @@ importers: specifier: 'catalog:' version: 4.23.15 - examples/1.frameworks/angular: - dependencies: - '@angular/common': - specifier: ^22.2.0 - version: 22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2) - '@angular/compiler': - specifier: ^22.2.0 - version: 22.2.6 - '@angular/core': - specifier: ^22.2.0 - version: 22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3) - '@angular/platform-browser': - specifier: ^22.2.0 - version: 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)) - '@angular/router': - specifier: ^22.2.0 - version: 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(@angular/platform-browser@22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)))(rxjs@7.8.2) - '@comark/angular': - specifier: workspace:* - version: link:../../../packages/comark-angular/dist - comark: - specifier: workspace:* - version: link:../../../packages/comark - rxjs: - specifier: ~7.8.0 - version: 7.8.2 - shiki: - specifier: 'catalog:' - version: 4.6.0 - tslib: - specifier: ^2.3.0 - version: 2.9.1 - devDependencies: - '@angular/build': - specifier: ^22.2.7 - version: 22.2.7(5e8e06c5932a5ec96fb4c913c9d03d25) - '@angular/cli': - specifier: ^22.2.7 - version: 22.2.7(@types/node@26.6.6)(chokidar@5.0.0) - '@angular/compiler-cli': - specifier: ^22.2.0 - version: 22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3) - '@tailwindcss/postcss': - specifier: ^4.1.12 - version: 4.3.5 - postcss: - specifier: ^8.5.3 - version: 8.5.33 - tailwindcss: - specifier: ^4.1.12 - version: 4.3.5 - typescript: - specifier: ~6.0.2 - version: 6.0.3 - examples/1.frameworks/astro: dependencies: '@astrojs/react': @@ -879,10 +824,10 @@ importers: devDependencies: '@analogjs/vite-plugin-angular': specifier: 'catalog:' - version: 3.0.0-beta.42(@angular/build@22.2.7(8f1b78d10abefeadf4529127eb65e9b0))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + version: 3.0.0-beta.42(@angular/build@22.2.7(b1461d7cd9e3185ee679e7bd0f346a68))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) '@angular/build': specifier: 'catalog:' - version: 22.2.7(8f1b78d10abefeadf4529127eb65e9b0) + version: 22.2.7(b1461d7cd9e3185ee679e7bd0f346a68) '@angular/compiler': specifier: 'catalog:' version: 22.2.6 @@ -1579,7 +1524,7 @@ importers: devDependencies: '@angular-devkit/build-angular': specifier: 'catalog:' - version: 22.2.7(2e10e11537ae0fb9f8142eed00228c3f) + version: 22.2.7(a7e89f390549dab65d4104706cc03aeb) '@angular/cli': specifier: 'catalog:' version: 22.2.7(@types/node@26.6.6)(chokidar@5.0.0) @@ -1716,7 +1661,7 @@ importers: version: 19.3.0(@types/react@19.3.0) '@vitest/browser-playwright': specifier: 'catalog:' - version: 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) react: specifier: 'catalog:' version: 19.3.1 @@ -1750,10 +1695,10 @@ importers: version: 7.3.1(svelte@5.58.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) '@vitest/browser': specifier: 'catalog:' - version: 5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) '@vitest/browser-playwright': specifier: 'catalog:' - version: 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) svelte: specifier: ^5.58.0 version: 5.58.0 @@ -1765,7 +1710,7 @@ importers: version: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) vitest-browser-svelte: specifier: 'catalog:' - version: 3.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(svelte@5.58.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + version: 3.1.0(svelte@5.58.0)(vitest@5.1.0) packages/comark-vue: dependencies: @@ -12751,7 +12696,7 @@ snapshots: '@jridgewell/gen-mapping': 0.3.13 '@jridgewell/trace-mapping': 0.3.31 - '@analogjs/vite-plugin-angular@3.0.0-beta.42(@angular/build@22.2.7(8f1b78d10abefeadf4529127eb65e9b0))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': + '@analogjs/vite-plugin-angular@3.0.0-beta.42(@angular/build@22.2.7(b1461d7cd9e3185ee679e7bd0f346a68))(@emnapi/core@2.0.0-beta.2)(@emnapi/runtime@2.0.0-beta.2)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': dependencies: es-toolkit: 1.52.0 magic-string: 0.30.21 @@ -12761,7 +12706,7 @@ snapshots: rolldown: 1.3.1 tinyglobby: 0.2.17 optionalDependencies: - '@angular/build': 22.2.7(8f1b78d10abefeadf4529127eb65e9b0) + '@angular/build': 22.2.7(b1461d7cd9e3185ee679e7bd0f346a68) vite: 8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) transitivePeerDependencies: - '@emnapi/core' @@ -12774,13 +12719,13 @@ snapshots: transitivePeerDependencies: - chokidar - '@angular-devkit/build-angular@22.2.7(2e10e11537ae0fb9f8142eed00228c3f)': + '@angular-devkit/build-angular@22.2.7(a7e89f390549dab65d4104706cc03aeb)': dependencies: '@ampproject/remapping': 2.3.0 '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) '@angular-devkit/build-webpack': 0.2202.7(chokidar@5.0.0)(webpack-dev-server@6.0.0(supports-color@10.2.2)(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.33))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.28)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)))(webpack@5.112.0(cssnano@9.9.0(postcss@8.5.33))(csso@5.0.5)(esbuild@0.28.2)(lightningcss@1.33.0)(postcss@8.5.28)(sharp@0.35.5(@types/node@26.6.6))(svgo@4.1.0)) '@angular-devkit/core': 22.2.7(chokidar@5.0.0) - '@angular/build': 22.2.7(1608556e09e6c425da111e5e30ff0d49) + '@angular/build': 22.2.7(d340a406dc22e6aebac2615013ad35e6) '@angular/compiler-cli': 22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3) '@babel/core': 8.0.5 '@babel/generator': 8.0.5 @@ -12848,8 +12793,6 @@ snapshots: - '@swc/html' - '@types/node' - '@vitejs/devtools' - - '@vitest/browser-playwright' - - '@vitest/ui' - bufferutil - chokidar - clean-css @@ -12872,7 +12815,6 @@ snapshots: - tsx - uglify-js - utf-8-validate - - vite - vitest - webpack-cli - yaml @@ -12907,68 +12849,7 @@ snapshots: transitivePeerDependencies: - chokidar - '@angular/build@22.2.7(1608556e09e6c425da111e5e30ff0d49)': - dependencies: - '@ampproject/remapping': 2.3.0 - '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) - '@angular/compiler': 22.2.6 - '@angular/compiler-cli': 22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3) - '@babel/core': 8.0.5 - '@inquirer/confirm': 6.3.2(@types/node@26.6.6) - '@parcel/watcher': 2.6.0 - '@vitejs/plugin-basic-ssl': 2.3.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - beasties: 0.5.4 - browserslist: 4.29.3 - chokidar: 5.0.0 - esbuild: 0.28.2 - https-proxy-agent: 9.1.0(supports-color@10.2.2) - jsonc-parser: 3.3.1 - listr2: 11.1.0 - magic-string: 1.4.1 - mrmime: 2.0.1 - oxc-parser: 0.156.0 - parse5-html-rewriting-stream: 8.0.1 - picomatch: 4.0.7 - piscina: 5.3.2 - rolldown: 1.2.16 - sass: 1.104.1 - sass-embedded: 1.104.1 - semver: 7.8.5 - source-map-support: 0.5.21 - tinyglobby: 0.2.17 - tslib: 2.8.1 - typescript: 6.0.3 - vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) - xxhash-wasm: 1.1.0 - optionalDependencies: - '@angular/core': 22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3) - '@angular/platform-browser': 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)) - '@angular/platform-server': 22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/compiler@22.2.6)(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(@angular/platform-browser@22.2.6(@angular/common@22.2.6(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3))(rxjs@7.8.2))(@angular/core@22.2.6(@angular/compiler@22.2.6)(rxjs@7.8.2)(zone.js@0.16.3)))(rxjs@7.8.2) - '@oxc-parser/binding-wasm32-wasi': 0.156.0 - istanbul-lib-instrument: 6.0.3(supports-color@10.2.2) - less: 4.9.1(supports-color@10.2.2) - lmdb: 3.5.6 - ng-packagr: 22.2.6(@angular/compiler-cli@22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3))(@volar/typescript@2.4.30(typescript@6.0.3))(@vue/language-core@3.3.14)(oxc-resolver@11.24.2)(supports-color@10.2.2)(tailwindcss@4.3.5)(tslib@2.9.1)(typescript@6.0.3)(vue-tsc@3.3.14(typescript@6.0.3)) - postcss: 8.5.28 - rollup: 4.67.4 - tailwindcss: 4.3.5 - vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - transitivePeerDependencies: - - '@types/node' - - '@vitejs/devtools' - - '@vitest/browser-playwright' - - '@vitest/ui' - - jiti - - kerberos - - stylus - - sugarss - - supports-color - - terser - - tsx - - vite - - yaml - - '@angular/build@22.2.7(5e8e06c5932a5ec96fb4c913c9d03d25)': + '@angular/build@22.2.7(b1461d7cd9e3185ee679e7bd0f346a68)': dependencies: '@ampproject/remapping': 2.3.0 '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) @@ -13013,12 +12894,10 @@ snapshots: postcss: 8.5.33 rollup: 4.67.4 tailwindcss: 4.3.5 - vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) + vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: - '@types/node' - '@vitejs/devtools' - - '@vitest/browser-playwright' - - '@vitest/ui' - jiti - kerberos - stylus @@ -13026,10 +12905,9 @@ snapshots: - supports-color - terser - tsx - - vite - yaml - '@angular/build@22.2.7(8f1b78d10abefeadf4529127eb65e9b0)': + '@angular/build@22.2.7(d340a406dc22e6aebac2615013ad35e6)': dependencies: '@ampproject/remapping': 2.3.0 '@angular-devkit/architect': 0.2202.7(chokidar@5.0.0) @@ -13058,7 +12936,7 @@ snapshots: semver: 7.8.5 source-map-support: 0.5.21 tinyglobby: 0.2.17 - tslib: 2.9.1 + tslib: 2.8.1 typescript: 6.0.3 vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) xxhash-wasm: 1.1.0 @@ -13071,15 +12949,13 @@ snapshots: less: 4.9.1(supports-color@10.2.2) lmdb: 3.5.6 ng-packagr: 22.2.6(@angular/compiler-cli@22.2.6(@angular/compiler@22.2.6)(typescript@6.0.3))(@volar/typescript@2.4.30(typescript@6.0.3))(@vue/language-core@3.3.14)(oxc-resolver@11.24.2)(supports-color@10.2.2)(tailwindcss@4.3.5)(tslib@2.9.1)(typescript@6.0.3)(vue-tsc@3.3.14(typescript@6.0.3)) - postcss: 8.5.33 + postcss: 8.5.28 rollup: 4.67.4 tailwindcss: 4.3.5 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: - '@types/node' - '@vitejs/devtools' - - '@vitest/browser-playwright' - - '@vitest/ui' - jiti - kerberos - stylus @@ -13087,7 +12963,6 @@ snapshots: - supports-color - terser - tsx - - vite - yaml '@angular/cli@22.2.7(@types/node@26.6.6)(chokidar@5.0.0)': @@ -14144,15 +14019,13 @@ snapshots: - debug - supports-color - '@codspeed/vitest-plugin@6.1.1(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + '@codspeed/vitest-plugin@6.1.1(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2)(tinybench@6.2.3)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': dependencies: '@codspeed/core': 6.1.1(debug@4.4.3(supports-color@10.2.2))(supports-color@10.2.2) tinybench: 6.2.3 vite: 8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: - - '@vitest/browser-playwright' - - '@vitest/ui' - debug - supports-color @@ -15030,7 +14903,7 @@ snapshots: '@modelcontextprotocol/core@2.3.1': dependencies: - zod: 4.6.6 + zod: 4.6.7 '@modelcontextprotocol/sdk@1.32.2(supports-color@10.2.2)(zod@4.6.7)': dependencies: @@ -15057,7 +14930,7 @@ snapshots: '@modelcontextprotocol/server@2.3.1': dependencies: '@modelcontextprotocol/core': 2.3.1 - zod: 4.6.6 + zod: 4.6.7 '@monaco-editor/loader@1.7.0': dependencies: @@ -18520,61 +18393,24 @@ snapshots: vite: 8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) vue: 3.5.45(typescript@6.0.3) - '@vitest/browser-playwright@5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': - dependencies: - '@vitest/browser': 5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) - '@vitest/mocker': 5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - playwright: 1.65.1 - tinyrainbow: 3.2.0 - vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - transitivePeerDependencies: - - '@vitest/ui' - - bufferutil - - msw - - utf-8-validate - - vite - optional: true - - '@vitest/browser-playwright@5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + '@vitest/browser-playwright@5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': dependencies: - '@vitest/browser': 5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/browser': 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) '@vitest/mocker': 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) playwright: 1.65.1 tinyrainbow: 3.2.0 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) transitivePeerDependencies: - - '@vitest/ui' - bufferutil - msw - utf-8-validate - vite - '@vitest/browser@5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': - dependencies: - '@blazediff/core': 1.10.0 - '@vitest/mocker': 5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) - '@vitest/utils': 5.1.0 - magic-string: 1.4.5 - pngjs: 7.0.0 - sirv: 3.0.2 - tinyrainbow: 3.2.0 - vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - ws: 8.23.0 - transitivePeerDependencies: - - '@vitest/browser-playwright' - - '@vitest/ui' - - bufferutil - - msw - - utf-8-validate - - vite - optional: true - - '@vitest/browser@5.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + '@vitest/browser@5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': dependencies: '@blazediff/core': 1.10.0 '@vitest/mocker': 5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/ui': 5.1.0(vitest@5.1.0) '@vitest/utils': 5.1.0 magic-string: 1.4.5 pngjs: 7.0.0 @@ -18583,23 +18419,11 @@ snapshots: vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) ws: 8.23.0 transitivePeerDependencies: - - '@vitest/browser-playwright' - - '@vitest/ui' - bufferutil - msw - utf-8-validate - vite - '@vitest/mocker@5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': - dependencies: - '@jridgewell/trace-mapping': 0.3.31 - '@vitest/spy': 5.1.0 - estree-walker: 3.0.3 - magic-string: 1.4.5 - optionalDependencies: - vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) - optional: true - '@vitest/mocker@5.1.0(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))': dependencies: '@jridgewell/trace-mapping': 0.3.31 @@ -18615,21 +18439,7 @@ snapshots: '@vitest/spy@5.1.0': {} - '@vitest/ui@5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': - dependencies: - '@vitest/utils': 5.1.0 - fflate: 0.8.3 - flatted: 3.4.4 - pathe: 2.0.3 - sirv: 3.0.2 - tinyrainbow: 3.2.0 - vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - transitivePeerDependencies: - - '@vitest/browser-playwright' - - vite - optional: true - - '@vitest/ui@5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0)': + '@vitest/ui@5.1.0(vitest@5.1.0)': dependencies: '@vitest/utils': 5.1.0 fflate: 0.8.3 @@ -18638,9 +18448,6 @@ snapshots: sirv: 3.0.2 tinyrainbow: 3.2.0 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - transitivePeerDependencies: - - '@vitest/browser-playwright' - - vite '@vitest/utils@5.1.0': dependencies: @@ -23416,7 +23223,7 @@ snapshots: rolldown@1.2.16: dependencies: '@oxc-project/types': 0.156.0 - '@rolldown/pluginutils': 1.1.1 + '@rolldown/pluginutils': 1.0.1 optionalDependencies: '@rolldown/binding-android-arm-eabi': 1.2.16 '@rolldown/binding-android-arm64': 1.2.16 @@ -24963,41 +24770,11 @@ snapshots: - typescript - universal-cookie - vitest-browser-svelte@3.1.0(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(svelte@5.58.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0): + vitest-browser-svelte@3.1.0(svelte@5.58.0)(vitest@5.1.0): dependencies: '@testing-library/svelte-core': 1.1.3(svelte@5.58.0) svelte: 5.58.0 vitest: 5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - transitivePeerDependencies: - - '@vitest/browser-playwright' - - '@vitest/ui' - - vite - - vitest@5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)): - dependencies: - '@types/chai': 5.2.3 - '@vitest/mocker': 5.1.0(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)) - chai: 6.3.0 - es-module-lexer: 2.3.2 - expect-type: 1.4.0 - magic-string: 1.4.5 - obug: 3.0.0 - picomatch: 4.0.7 - std-env: 4.3.0 - tinybench: 6.2.3 - tinyexec: 1.3.1 - tinyglobby: 0.2.17 - vite: 8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1) - why-is-node-running: 3.2.1 - optionalDependencies: - '@opentelemetry/api': 1.10.0 - '@types/node': 26.6.6 - '@vitest/browser-playwright': 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) - '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.5(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) - happy-dom: 21.0.4 - transitivePeerDependencies: - - msw - optional: true vitest@5.1.0(@opentelemetry/api@1.10.0)(@types/node@26.6.6)(@vitest/browser-playwright@5.1.0)(@vitest/ui@5.1.0)(happy-dom@21.0.4)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1)): dependencies: @@ -25018,8 +24795,8 @@ snapshots: optionalDependencies: '@opentelemetry/api': 1.10.0 '@types/node': 26.6.6 - '@vitest/browser-playwright': 5.1.0(@vitest/ui@5.1.0)(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) - '@vitest/ui': 5.1.0(@vitest/browser-playwright@5.1.0)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/browser-playwright': 5.1.0(playwright@1.65.1)(vite@8.3.8(@types/node@26.6.6)(esbuild@0.28.2)(jiti@2.7.0)(less@4.9.1(supports-color@10.2.2))(sass-embedded@1.104.1)(sass@1.104.1)(terser@5.51.2)(tsx@4.23.15)(yaml@2.9.1))(vitest@5.1.0) + '@vitest/ui': 5.1.0(vitest@5.1.0) happy-dom: 21.0.4 transitivePeerDependencies: - msw From 3d4c122fa364abdc7b5d29216a45ab97215818c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Thu, 19 Nov 2026 08:25:52 -0500 Subject: [PATCH 08/11] feat(angular): add provideMarkdown config providers --- AGENTS.md | 6 +- docs/content/3.rendering/7.angular.md | 14 +- docs/content/5.reference/3.reference.md | 2 +- .../comark/references/rendering-angular.md | 14 +- .../angular/src/app/pages/syntax.component.ts | 4 +- packages/comark-angular/src/define.ts | 198 ++++++++++++------ packages/comark-angular/src/index.ts | 2 + packages/comark-angular/src/provider.ts | 109 ++++++++++ packages/comark-angular/test/aot.test.ts | 40 ++++ .../test/define-component.test.ts | 98 ++++++--- .../test/fixtures/aot/app.component.ts | 27 +++ .../fixtures/aot/factory-imports.component.ts | 12 ++ .../test/fixtures/aot/tsconfig.factory.json | 10 + .../test/fixtures/aot/tsconfig.json | 10 + .../test/fixtures/defined/defined.ts | 32 +++ .../test/provider-config.test.ts | 20 +- packages/comark-angular/test/provider.test.ts | 56 +++++ packages/comark-angular/test/reparse.test.ts | 6 +- packages/comark-angular/tsconfig.spec.json | 2 +- test/bundle.test.ts | 2 +- 20 files changed, 532 insertions(+), 132 deletions(-) create mode 100644 packages/comark-angular/src/provider.ts create mode 100644 packages/comark-angular/test/aot.test.ts create mode 100644 packages/comark-angular/test/fixtures/aot/app.component.ts create mode 100644 packages/comark-angular/test/fixtures/aot/factory-imports.component.ts create mode 100644 packages/comark-angular/test/fixtures/aot/tsconfig.factory.json create mode 100644 packages/comark-angular/test/fixtures/aot/tsconfig.json create mode 100644 packages/comark-angular/test/fixtures/defined/defined.ts create mode 100644 packages/comark-angular/test/provider.test.ts diff --git a/AGENTS.md b/AGENTS.md index c53cedfa0..9cc4d1a63 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -152,9 +152,9 @@ Svelte 5 renderer (`Markdown`, `MarkdownDocument`, `MarkdownNode`) plus experime ### `@comark/angular` (`packages/comark-angular/`) -Angular 21+ renderer (peer range `>=21 <23`) with standalone components (`Markdown` selector `comark-markdown`, `MarkdownDocument`, `defineMarkdownComponent`, `defineMarkdownDocumentComponent`). +Angular 21+ renderer (peer range `>=21 <23`) with standalone components (`Markdown` selector `comark-markdown`, `MarkdownDocument`, `provideMarkdown`, `provideMarkdownDocument`). -- `defineMarkdownComponent` / `defineMarkdownDocumentComponent` return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG` (`src/config.ts`). The static `Markdown` / `MarkdownDocument` components inject those tokens optionally. Never return a component class from a factory: AOT cannot resolve it in `imports` (NG1010 / ngtsc -991010). +- `provideMarkdown` / `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG` (`src/config.ts`). The static `Markdown` / `MarkdownDocument` components inject those tokens optionally. Use these in AOT builds: a component class returned from a factory cannot be resolved in `imports` (NG1010 / ngtsc -991010). `defineMarkdownComponent` / `defineMarkdownDocumentComponent` remain as component-class factories for JIT builds. - Built with `ng-packagr` (`ng build`), then `scripts/strip-sourcemaps.mjs` removes emitted source maps and `scripts/sync-plugins.mjs` writes plain plugin re-exports and `./plugins/*` export map entries into `dist/package.json`. - Plugin entry points use **named exports** because the Angular Package Format strips `export default` (`import { math, Math } from '@comark/angular/plugins/math'`, `import { security } from '@comark/angular/plugins/security'`). - Publishes from `dist/` via `publishConfig.directory`; `test/bundle.test.ts` packs from `dist/` too. @@ -218,7 +218,7 @@ import { createAnsiRenderer, createAnsiPrinter, printAnsi, renderAnsi, renderAns import { Markdown, MarkdownDocument, defineMarkdownComponent } from '@comark/vue' // also @comark/react import { Markdown, MarkdownDocument } from '@comark/svelte' import { MarkdownAsync } from '@comark/svelte/async' -import { Markdown, MarkdownDocument, defineMarkdownComponent, MARKDOWN_CONFIG } from '@comark/angular' +import { Markdown, MarkdownDocument, provideMarkdown, MARKDOWN_CONFIG } from '@comark/angular' import math, { Math } from '@comark/vue/plugins/math' // same shape in html, react, svelte (`{ math, Math }` in angular) import mermaid, { Mermaid } from '@comark/vue/plugins/mermaid' import binding, { Binding, If } from '@comark/vue/plugins/binding' diff --git a/docs/content/3.rendering/7.angular.md b/docs/content/3.rendering/7.angular.md index 363edaa26..18adf858b 100644 --- a/docs/content/3.rendering/7.angular.md +++ b/docs/content/3.rendering/7.angular.md @@ -544,13 +544,13 @@ export class HeadingComponent { ## Pre-configured components -Use `defineMarkdownComponent` and `defineMarkdownDocumentComponent` to pre-configure plugins, component mappings, styling, and node transforms. Both helpers return an Angular `Provider`, not a component class. Import the static `Markdown` or `MarkdownDocument` component in `imports`, then add the provider in `providers`. This keeps the component statically analyzable: factory-created component classes in `imports` fail AOT compilation with NG1010 (ngtsc error -991010). +Use `provideMarkdown` and `provideMarkdownDocument` to pre-configure plugins, component mappings, styling, and node transforms. Both helpers return an Angular `Provider`, not a component class. Import the static `Markdown` or `MarkdownDocument` component in `imports`, then add the provider in `providers`. This keeps the component statically analyzable: factory-created component classes in `imports` fail AOT compilation with NG1010 (ngtsc error -991010). -### `defineMarkdownComponent` +### `provideMarkdown` ```typescript [page.component.ts] import { Component } from '@angular/core' -import { Markdown, defineMarkdownComponent } from '@comark/angular' +import { Markdown, provideMarkdown } from '@comark/angular' import { shiki } from '@comark/angular/plugins/shiki' import { math, Math } from '@comark/angular/plugins/math' import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' @@ -560,7 +560,7 @@ import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' standalone: true, imports: [Markdown], providers: [ - defineMarkdownComponent({ + provideMarkdown({ plugins: [shiki(), math(), mermaid()], components: { Math, Mermaid }, class: 'prose dark:prose-invert', @@ -575,14 +575,14 @@ export class PageComponent { The provider can also be scoped to a route or an ancestor component. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the provider config and win on conflict. Config plugins run before instance plugins. An instance plugin with the same name replaces the config plugin and runs in the instance order. `transformNode` from the config runs before the instance's own `transformNode`. -### `defineMarkdownDocumentComponent` +### `provideMarkdownDocument` Pre-configure the low-level renderer the same way: ```typescript [page.component.ts] import { Component, OnInit } from '@angular/core' import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' -import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' +import { MarkdownDocument, provideMarkdownDocument } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' @Component({ @@ -590,7 +590,7 @@ import { Math } from '@comark/angular/plugins/math' standalone: true, imports: [MarkdownDocument], providers: [ - defineMarkdownDocumentComponent({ + provideMarkdownDocument({ components: { Math }, class: 'prose', }), diff --git a/docs/content/5.reference/3.reference.md b/docs/content/5.reference/3.reference.md index 9ed3c5d3b..ff0cf5878 100644 --- a/docs/content/5.reference/3.reference.md +++ b/docs/content/5.reference/3.reference.md @@ -251,7 +251,7 @@ export const AppMarkdown = defineMarkdownComponent({ }) ``` -> In `@comark/angular`, both helpers return a config `Provider` instead of a component class. Import the static `Markdown` or `MarkdownDocument` component in `imports` and put the helper result in `providers`. See the [Angular renderer guide](/rendering/angular#pre-configured-components). +> In `@comark/angular`, use `provideMarkdown` and `provideMarkdownDocument` in AOT builds. They return a config `Provider`: import the static `Markdown` or `MarkdownDocument` component in `imports` and put the provider in `providers`. The `defineMarkdownComponent` / `defineMarkdownDocumentComponent` factories still return component classes for JIT builds. See the [Angular renderer guide](/rendering/angular#pre-configured-components). ## Transforming nodes before render diff --git a/docs/skills/comark/references/rendering-angular.md b/docs/skills/comark/references/rendering-angular.md index c73bbe7c7..9ff503467 100644 --- a/docs/skills/comark/references/rendering-angular.md +++ b/docs/skills/comark/references/rendering-angular.md @@ -479,13 +479,13 @@ export class AppComponent { ## Pre-configured components -Use `defineMarkdownComponent` or `defineMarkdownDocumentComponent` to pre-configure plugins, component mappings, styling, and node transforms. Each helper returns an Angular `Provider`. Import the static `Markdown` or `MarkdownDocument` component in `imports`; a component class made by a runtime factory cannot be statically resolved in `imports` and fails AOT builds with NG1010. +Use `provideMarkdown` or `provideMarkdownDocument` to pre-configure plugins, component mappings, styling, and node transforms. Each helper returns an Angular `Provider`. Import the static `Markdown` or `MarkdownDocument` component in `imports`; a component class made by a runtime factory cannot be statically resolved in `imports` and fails AOT builds with NG1010. -### defineMarkdownComponent +### provideMarkdown ```typescript import { Component } from '@angular/core' -import { Markdown, defineMarkdownComponent } from '@comark/angular' +import { Markdown, provideMarkdown } from '@comark/angular' import { math, Math } from '@comark/angular/plugins/math' import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' @@ -494,7 +494,7 @@ import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' standalone: true, imports: [Markdown], providers: [ - defineMarkdownComponent({ + provideMarkdown({ plugins: [math(), mermaid()], components: { Math, Mermaid }, class: 'prose dark:prose-invert', @@ -509,12 +509,12 @@ export class DocsComponent { Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the provider config and win on conflict. Config plugins run first. An instance plugin with the same name replaces the config plugin and runs in the instance order. Config `transformNode` runs before the instance's own transform. -### defineMarkdownDocumentComponent +### provideMarkdownDocument ```typescript import { Component, OnInit } from '@angular/core' import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' -import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' +import { MarkdownDocument, provideMarkdownDocument } from '@comark/angular' import { Math } from '@comark/angular/plugins/math' @Component({ @@ -522,7 +522,7 @@ import { Math } from '@comark/angular/plugins/math' standalone: true, imports: [MarkdownDocument], providers: [ - defineMarkdownDocumentComponent({ + provideMarkdownDocument({ components: { Math }, }), ], diff --git a/examples/2.vite/angular/src/app/pages/syntax.component.ts b/examples/2.vite/angular/src/app/pages/syntax.component.ts index 33c190887..aa6a844a9 100644 --- a/examples/2.vite/angular/src/app/pages/syntax.component.ts +++ b/examples/2.vite/angular/src/app/pages/syntax.component.ts @@ -1,5 +1,5 @@ import { Component } from '@angular/core' -import { Markdown, defineMarkdownComponent } from '@comark/angular' +import { Markdown, provideMarkdown } from '@comark/angular' import shiki from 'comark/plugins/shiki' import alert from 'comark/plugins/alert' import { AlertComponent } from '../components/alert.component' @@ -11,7 +11,7 @@ import python from '@shikijs/langs/python' standalone: true, imports: [Markdown], providers: [ - defineMarkdownComponent({ + provideMarkdown({ plugins: [ shiki({ languages: [python], diff --git a/packages/comark-angular/src/define.ts b/packages/comark-angular/src/define.ts index 665f6d45f..9ccb565f5 100644 --- a/packages/comark-angular/src/define.ts +++ b/packages/comark-angular/src/define.ts @@ -1,7 +1,8 @@ -import type { Provider, Type } from '@angular/core' +import { Component, ChangeDetectionStrategy, Type, input, computed } from '@angular/core' import type { NodeTransform, ParserOptions } from 'comark' -import { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from './config' -import type { MarkdownConfig, MarkdownDocumentConfig } from './config' +import { mergeNodeTransforms } from 'comark/utils' +import { Markdown } from './components/markdown.component' +import { MarkdownDocument } from './components/markdown-document.component' export interface DefineMarkdownComponentOptions extends ParserOptions { /** Pre-configured component mappings. */ @@ -22,38 +23,28 @@ export interface DefineMarkdownDocumentOptions { } /** - * Configure the static `Markdown` component through Angular DI. + * Create a pre-configured Markdown component with default options, plugins, and components. * - * Returns a config Provider for `MARKDOWN_CONFIG`. The `Markdown` component is - * declared statically, so it stays analyzable by the Angular AOT compiler and - * can be used in `imports`. AOT cannot statically resolve a component class - * created by a factory function (ngtsc error -991010 / NG1010). + * The returned class extends `Markdown` and merges the config-level + * defaults with any per-instance `@Input()` values at runtime. + * + * Angular AOT cannot statically resolve a component class produced by a factory + * in `imports` (ngtsc error -991010 / NG1010). Prefer `provideMarkdown` + * in AOT builds; this factory remains for JIT applications. * * @example * ```typescript - * import { Component } from '@angular/core' - * import { Markdown, defineMarkdownComponent } from '@comark/angular' + * import { defineMarkdownComponent } from '@comark/angular' * import { math, Math } from '@comark/angular/plugins/math' * - * @Component({ - * selector: 'app-docs', - * standalone: true, - * imports: [Markdown], - * providers: [ - * defineMarkdownComponent({ - * plugins: [math()], - * components: { Math }, - * class: 'prose dark:prose-invert', - * }), - * ], - * template: ``, + * export const DocsMarkdown = defineMarkdownComponent({ + * plugins: [math()], + * components: { Math }, + * class: 'prose dark:prose-invert', * }) - * export class DocsComponent { - * content = '# Hello' - * } * ``` */ -export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = {}): Provider { +export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = {}): Type { const { components: configComponents = {}, class: configClass, @@ -62,60 +53,131 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = ...parseOptions } = config - return { - provide: MARKDOWN_CONFIG, - useValue: { - options: parseOptions, - plugins: configPlugins, - components: configComponents, - transformNode: configTransforms, - class: configClass, - } satisfies MarkdownConfig, + @Component({ + selector: 'comark-markdown-defined', + standalone: true, + imports: [MarkdownDocument], + changeDetection: ChangeDetectionStrategy.OnPush, + template: ` + @if (document) { + + } + `, + host: { + '[class]': 'hostClass', + }, + }) + class DefinedMarkdownComponent extends Markdown { + /** Instance-level components that are merged with config-level components. */ + override readonly components = input>>({}) + + protected override readonly mergedComponents = computed(() => ({ ...configComponents, ...this.components() })) + + protected override readonly mergedTransforms = computed(() => + mergeNodeTransforms(configTransforms, this.transformNode()) + ) + + get hostClass(): string { + return configClass || '' + } + + /** + * Effective plugins: config-level plugins first, then instance plugins. + * An instance plugin with the same name replaces the config plugin. + */ + private readonly effectivePlugins = computed(() => { + const plugins = new Map[number]>() + + for (const plugin of configPlugins) { + plugins.set(plugin.name, plugin) + } + for (const plugin of this.plugins() ?? []) { + plugins.delete(plugin.name) + plugins.set(plugin.name, plugin) + } + + return [...plugins.values()] + }) + + /** + * Merge config-level parse options under the instance `options` input so + * instance values override config defaults, without writing back to the + * input signal (the parser consumes the derived value instead). + */ + protected override getParserOptions(): ParserOptions { + const unwrap = this.unwrap() + return { + ...parseOptions, + ...this.options(), + ...(unwrap === undefined ? {} : { unwrap }), + plugins: this.effectivePlugins(), + } + } } + + return DefinedMarkdownComponent as any } /** - * Configure the static `MarkdownDocument` component through Angular DI. + * Create a pre-configured MarkdownDocument component with default component mappings. * - * Returns a config Provider for `MARKDOWN_DOCUMENT_CONFIG`, which the static - * `MarkdownDocument` component reads to pre-configure components and styling. + * Angular AOT cannot statically resolve a component class produced by a factory + * in `imports` (ngtsc error -991010 / NG1010). Prefer `provideMarkdownDocument` + * in AOT builds; this factory remains for JIT applications. * * @example * ```typescript - * import { Component, OnInit } from '@angular/core' - * import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' - * import { MarkdownDocument, defineMarkdownDocumentComponent } from '@comark/angular' + * import { defineMarkdownDocumentComponent } from '@comark/angular' * import { Math } from '@comark/angular/plugins/math' * - * @Component({ - * selector: 'app-docs', - * standalone: true, - * imports: [MarkdownDocument], - * providers: [ - * defineMarkdownDocumentComponent({ - * components: { Math }, - * }), - * ], - * template: `@if (document) { }`, + * export const DocsRenderer = defineMarkdownDocumentComponent({ + * components: { Math }, * }) - * export class DocsComponent implements OnInit { - * document?: MarkdownDocumentType - * - * async ngOnInit(): Promise { - * this.document = await parseMarkdown('# Hello') - * } - * } * ``` */ -export function defineMarkdownDocumentComponent(config: DefineMarkdownDocumentOptions = {}): Provider { - const { components: configComponents = {}, class: configClass, transformNode: configTransforms } = config - - return { - provide: MARKDOWN_DOCUMENT_CONFIG, - useValue: { - components: configComponents, - transformNode: configTransforms, - class: configClass, - } satisfies MarkdownDocumentConfig, +export function defineMarkdownDocumentComponent(config: DefineMarkdownDocumentOptions = {}): Type { + const { components: configComponents = {}, class: configClass } = config + + @Component({ + selector: 'comark-markdown-document-defined', + standalone: true, + imports: [MarkdownDocument], + changeDetection: ChangeDetectionStrategy.OnPush, + template: ` + + `, + host: { + '[class]': 'hostClass', + }, + }) + class DefinedMarkdownDocumentComponent extends MarkdownDocument { + /** Instance-level components that are merged with config-level components. */ + override readonly components = input>>({}) + + protected override readonly mergedComponents = computed(() => ({ ...configComponents, ...this.components() })) + + protected override readonly mergedTransforms = computed(() => + mergeNodeTransforms(config.transformNode, this.transformNode()) + ) + + get hostClass(): string { + return configClass || '' + } } + + return DefinedMarkdownDocumentComponent as any } diff --git a/packages/comark-angular/src/index.ts b/packages/comark-angular/src/index.ts index d4cc40bb5..f2523de11 100644 --- a/packages/comark-angular/src/index.ts +++ b/packages/comark-angular/src/index.ts @@ -3,6 +3,8 @@ export { MarkdownDocument } from './components/markdown-document.component' export { MarkdownNode } from './components/markdown-node.component' export { defineMarkdownComponent, defineMarkdownDocumentComponent } from './define' export type { DefineMarkdownComponentOptions, DefineMarkdownDocumentOptions } from './define' +export { provideMarkdown, provideMarkdownDocument } from './provider' +export type { MarkdownProviderOptions, MarkdownDocumentProviderOptions } from './provider' export { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from './config' export type { MarkdownConfig, MarkdownDocumentConfig } from './config' diff --git a/packages/comark-angular/src/provider.ts b/packages/comark-angular/src/provider.ts new file mode 100644 index 000000000..44af22998 --- /dev/null +++ b/packages/comark-angular/src/provider.ts @@ -0,0 +1,109 @@ +import type { Provider } from '@angular/core' +import { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from './config' +import type { MarkdownConfig, MarkdownDocumentConfig } from './config' +import type { DefineMarkdownComponentOptions, DefineMarkdownDocumentOptions } from './define' + +/** Options for {@link provideMarkdown}. */ +export type MarkdownProviderOptions = DefineMarkdownComponentOptions + +/** Options for {@link provideMarkdownDocument}. */ +export type MarkdownDocumentProviderOptions = DefineMarkdownDocumentOptions + +/** + * Configure the static `Markdown` component through Angular DI. + * + * Returns a config Provider for `MARKDOWN_CONFIG`. The `Markdown` component is + * declared statically, so it stays analyzable by the Angular AOT compiler and + * can be used in `imports`. AOT cannot statically resolve a component class + * created by a factory function (ngtsc error -991010 / NG1010). + * + * @example + * ```typescript + * import { Component } from '@angular/core' + * import { Markdown, provideMarkdown } from '@comark/angular' + * import { math, Math } from '@comark/angular/plugins/math' + * + * @Component({ + * selector: 'app-docs', + * standalone: true, + * imports: [Markdown], + * providers: [ + * provideMarkdown({ + * plugins: [math()], + * components: { Math }, + * class: 'prose dark:prose-invert', + * }), + * ], + * template: ``, + * }) + * export class DocsComponent { + * content = '# Hello' + * } + * ``` + */ +export function provideMarkdown(config: MarkdownProviderOptions = {}): Provider { + const { + components: configComponents = {}, + class: configClass, + plugins: configPlugins = [], + transformNode: configTransforms, + ...parseOptions + } = config + + return { + provide: MARKDOWN_CONFIG, + useValue: { + options: parseOptions, + plugins: configPlugins, + components: configComponents, + transformNode: configTransforms, + class: configClass, + } satisfies MarkdownConfig, + } +} + +/** + * Configure the static `MarkdownDocument` component through Angular DI. + * + * Returns a config Provider for `MARKDOWN_DOCUMENT_CONFIG`, which the static + * `MarkdownDocument` component reads to pre-configure components and styling. + * + * @example + * ```typescript + * import { Component, OnInit } from '@angular/core' + * import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' + * import { MarkdownDocument, provideMarkdownDocument } from '@comark/angular' + * import { Math } from '@comark/angular/plugins/math' + * + * @Component({ + * selector: 'app-docs', + * standalone: true, + * imports: [MarkdownDocument], + * providers: [ + * provideMarkdownDocument({ + * components: { Math }, + * }), + * ], + * template: `@if (document) { }`, + * }) + * export class DocsComponent implements OnInit { + * document?: MarkdownDocumentType + * + * async ngOnInit(): Promise { + * this.document = await parseMarkdown('# Hello') + * } + * } + * ``` + */ +export function provideMarkdownDocument(config: MarkdownDocumentProviderOptions = {}): Provider { + const { components: configComponents = {}, class: configClass, transformNode: configTransforms } = config + + return { + provide: MARKDOWN_DOCUMENT_CONFIG, + useValue: { + components: configComponents, + transformNode: configTransforms, + class: configClass, + } satisfies MarkdownDocumentConfig, + } +} diff --git a/packages/comark-angular/test/aot.test.ts b/packages/comark-angular/test/aot.test.ts new file mode 100644 index 000000000..2b6f278bf --- /dev/null +++ b/packages/comark-angular/test/aot.test.ts @@ -0,0 +1,40 @@ +import { execFileSync } from 'node:child_process' +import { fileURLToPath } from 'node:url' +import { dirname, join } from 'node:path' +import { describe, expect, it } from 'vitest' + +const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..') +const ngc = join(packageRoot, 'node_modules', '.bin', 'ngc') + +function compile(project: string): { status: number; output: string } { + try { + const output = execFileSync(ngc, ['-p', join(packageRoot, 'test', 'fixtures', 'aot', project)], { + cwd: packageRoot, + encoding: 'utf8', + stdio: ['ignore', 'pipe', 'pipe'], + }) + return { status: 0, output } + } catch (error) { + const failure = error as { status?: number; stdout?: string; stderr?: string } + return { + status: failure.status ?? 1, + output: `${failure.stdout ?? ''}${failure.stderr ?? ''}`, + } + } +} + +describe('Angular AOT compilation', () => { + it('compiles a consumer that imports the static components and registers providers', () => { + const { status, output } = compile('tsconfig.json') + + expect(output).toBe('') + expect(status).toBe(0) + }) + + it('rejects a factory-created component class in imports', () => { + const { status, output } = compile('tsconfig.factory.json') + + expect(status).not.toBe(0) + expect(output).toContain('NG1010') + }) +}) diff --git a/packages/comark-angular/test/define-component.test.ts b/packages/comark-angular/test/define-component.test.ts index 57ff7b50a..9a0ddf26f 100644 --- a/packages/comark-angular/test/define-component.test.ts +++ b/packages/comark-angular/test/define-component.test.ts @@ -1,56 +1,98 @@ -import { describe, expect, it } from 'vitest' -import type { ValueProvider } from '@angular/core' +import '@angular/compiler' +import { beforeEach, describe, expect, it, vi } from 'vitest' +import { TestBed } from '@angular/core/testing' import type { NodeTransform } from 'comark' +import { parseMarkdown } from 'comark' import { defineMarkdownComponent, defineMarkdownDocumentComponent } from '../src/define.ts' -import { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from '../src/config.ts' +import { ConfiguredMarkdown, ConfiguredMarkdownDocument, InstanceAlert } from './fixtures/defined/defined.ts' describe('defineMarkdownComponent', () => { - it('returns a MARKDOWN_CONFIG provider with defaults and overrides', () => { - const empty = defineMarkdownComponent() as ValueProvider - expect(empty.provide).toBe(MARKDOWN_CONFIG) - expect(empty.useValue).toMatchObject({ options: {}, plugins: [], components: {} }) + beforeEach(() => TestBed.resetTestingModule()) + it('returns a component class', () => { + const Defined = defineMarkdownComponent() + expect(typeof Defined).toBe('function') + }) + + it('accepts plugins, components, class, and parse options', () => { const plugin = { name: 'test', setup: () => {} } const transformNode: NodeTransform = () => undefined class FakeComponent {} - const provider = defineMarkdownComponent({ + const Defined = defineMarkdownComponent({ plugins: [plugin as any], components: { alert: FakeComponent }, class: 'prose', autoClose: true, transformNode, - }) as ValueProvider + }) - expect(provider.provide).toBe(MARKDOWN_CONFIG) - expect(provider.useValue).toEqual({ - options: { autoClose: true }, - plugins: [plugin], - components: { alert: FakeComponent }, - transformNode, - class: 'prose', + expect(typeof Defined).toBe('function') + }) + + it('renders an imported factory component with its config', async () => { + await TestBed.configureTestingModule({ imports: [ConfiguredMarkdown] }).compileComponents() + const fixture = TestBed.createComponent(ConfiguredMarkdown) + fixture.componentRef.setInput('value', '::alert\n:smile:\n::') + fixture.detectChanges() + + await vi.waitFor(() => { + fixture.detectChanges() + expect(fixture.nativeElement.textContent).toContain('😄') }) + + const html = fixture.nativeElement.outerHTML as string + expect(html).toContain('factory-class') + expect(html).toContain('config-alert') + }) + + it('lets instance components override the factory config', async () => { + await TestBed.configureTestingModule({ imports: [ConfiguredMarkdown] }).compileComponents() + const fixture = TestBed.createComponent(ConfiguredMarkdown) + fixture.componentRef.setInput('value', '::alert\nHello\n::') + fixture.componentRef.setInput('components', { alert: InstanceAlert }) + fixture.detectChanges() + + await vi.waitFor(() => { + fixture.detectChanges() + expect(fixture.nativeElement.textContent).toContain('Hello') + }) + + const html = fixture.nativeElement.outerHTML as string + expect(html).toContain('instance-alert') + expect(html).not.toContain('config-alert') }) }) describe('defineMarkdownDocumentComponent', () => { - it('returns a MARKDOWN_DOCUMENT_CONFIG provider with defaults and overrides', () => { - const empty = defineMarkdownDocumentComponent() as ValueProvider - expect(empty.provide).toBe(MARKDOWN_DOCUMENT_CONFIG) - expect(empty.useValue.components).toEqual({}) + beforeEach(() => TestBed.resetTestingModule()) + + it('returns a component class', () => { + const Defined = defineMarkdownDocumentComponent() + expect(typeof Defined).toBe('function') + }) + it('accepts components, class, and transforms', () => { const transformNode: NodeTransform = () => undefined class FakeComponent {} - const provider = defineMarkdownDocumentComponent({ - components: { Math: FakeComponent }, - class: 'prose', - transformNode, - }) as ValueProvider - - expect(provider.provide).toBe(MARKDOWN_DOCUMENT_CONFIG) - expect(provider.useValue).toEqual({ + const Defined = defineMarkdownDocumentComponent({ components: { Math: FakeComponent }, class: 'prose', transformNode, }) + + expect(typeof Defined).toBe('function') + }) + + it('renders an imported factory component with its config', async () => { + const document = await parseMarkdown('Hello\n\n::alert\nAlert\n::') + await TestBed.configureTestingModule({ imports: [ConfiguredMarkdownDocument] }).compileComponents() + const fixture = TestBed.createComponent(ConfiguredMarkdownDocument) + fixture.componentRef.setInput('value', document) + fixture.detectChanges() + + const html = fixture.nativeElement.outerHTML as string + expect(html).toContain('factory-document-class') + expect(html).toContain('config-alert') + expect(html).toContain('
Hello
') }) }) diff --git a/packages/comark-angular/test/fixtures/aot/app.component.ts b/packages/comark-angular/test/fixtures/aot/app.component.ts new file mode 100644 index 000000000..5d2931f21 --- /dev/null +++ b/packages/comark-angular/test/fixtures/aot/app.component.ts @@ -0,0 +1,27 @@ +import { Component } from '@angular/core' +import type { MarkdownDocument as MarkdownDocumentType } from 'comark' +import { Markdown, MarkdownDocument, provideMarkdown, provideMarkdownDocument } from '../../../src/index.ts' + +@Component({ + selector: 'app-markdown', + standalone: true, + imports: [Markdown], + providers: [provideMarkdown({ class: 'prose' })], + template: ``, +}) +export class AppMarkdownComponent { + content = '# Hello' +} + +@Component({ + selector: 'app-document', + standalone: true, + imports: [MarkdownDocument], + providers: [provideMarkdownDocument({ class: 'prose' })], + template: `@if (document) { + + }`, +}) +export class AppDocumentComponent { + document?: MarkdownDocumentType +} diff --git a/packages/comark-angular/test/fixtures/aot/factory-imports.component.ts b/packages/comark-angular/test/fixtures/aot/factory-imports.component.ts new file mode 100644 index 000000000..cdbc3af8e --- /dev/null +++ b/packages/comark-angular/test/fixtures/aot/factory-imports.component.ts @@ -0,0 +1,12 @@ +import { Component } from '@angular/core' +import { defineMarkdownComponent } from '../../../src/index.ts' + +@Component({ + selector: 'app-factory-markdown', + standalone: true, + imports: [defineMarkdownComponent()], + template: ``, +}) +export class AppFactoryMarkdownComponent { + content = '# Hello' +} diff --git a/packages/comark-angular/test/fixtures/aot/tsconfig.factory.json b/packages/comark-angular/test/fixtures/aot/tsconfig.factory.json new file mode 100644 index 000000000..a8cab127b --- /dev/null +++ b/packages/comark-angular/test/fixtures/aot/tsconfig.factory.json @@ -0,0 +1,10 @@ +{ + "extends": "../../../tsconfig.json", + "compilerOptions": { + "outDir": "../../../out-tsc/aot-fixture-factory", + "noEmit": true, + "types": [], + "rootDir": "../../.." + }, + "files": ["factory-imports.component.ts"] +} diff --git a/packages/comark-angular/test/fixtures/aot/tsconfig.json b/packages/comark-angular/test/fixtures/aot/tsconfig.json new file mode 100644 index 000000000..8c4eecea0 --- /dev/null +++ b/packages/comark-angular/test/fixtures/aot/tsconfig.json @@ -0,0 +1,10 @@ +{ + "extends": "../../../tsconfig.json", + "compilerOptions": { + "outDir": "../../../out-tsc/aot-fixture", + "noEmit": true, + "types": [], + "rootDir": "../../.." + }, + "files": ["app.component.ts"] +} diff --git a/packages/comark-angular/test/fixtures/defined/defined.ts b/packages/comark-angular/test/fixtures/defined/defined.ts new file mode 100644 index 000000000..7f64079ac --- /dev/null +++ b/packages/comark-angular/test/fixtures/defined/defined.ts @@ -0,0 +1,32 @@ +import { Component } from '@angular/core' +import type { NodeTransform } from 'comark' +import emoji from 'comark/plugins/emoji' +import { defineMarkdownComponent, defineMarkdownDocumentComponent } from '../../../src/define.ts' + +@Component({ + selector: 'app-config-alert', + standalone: true, + template: '', +}) +export class ConfigAlert {} + +@Component({ + selector: 'app-instance-alert', + standalone: true, + template: '', +}) +export class InstanceAlert {} + +export const ConfiguredMarkdown = defineMarkdownComponent({ + plugins: [emoji()], + components: { alert: ConfigAlert }, + class: 'factory-class', +}) + +const documentTransform: NodeTransform = ({ tag }) => (tag === 'p' ? { tag: 'section' } : undefined) + +export const ConfiguredMarkdownDocument = defineMarkdownDocumentComponent({ + components: { alert: ConfigAlert }, + class: 'factory-document-class', + transformNode: documentTransform, +}) diff --git a/packages/comark-angular/test/provider-config.test.ts b/packages/comark-angular/test/provider-config.test.ts index d0dba37d9..a588a81d5 100644 --- a/packages/comark-angular/test/provider-config.test.ts +++ b/packages/comark-angular/test/provider-config.test.ts @@ -8,7 +8,7 @@ import { parseMarkdown, type NodeTransform, type ParserOptions } from 'comark' import emoji from 'comark/plugins/emoji' import { Markdown } from '../src/components/markdown.component.ts' import { MarkdownDocument } from '../src/components/markdown-document.component.ts' -import { defineMarkdownComponent, defineMarkdownDocumentComponent } from '../src/define.ts' +import { provideMarkdown, provideMarkdownDocument } from '../src/provider.ts' @Component({ selector: 'app-config-alert', @@ -68,7 +68,7 @@ describe('Markdown config providers', () => { it('applies config plugins, components, and class to static Markdown', async () => { const html = await renderMarkdown('::alert\n:smile:\n::', [ - defineMarkdownComponent({ + provideMarkdown({ plugins: [emoji()], components: { alert: ConfigAlert }, class: 'config-class', @@ -81,18 +81,16 @@ describe('Markdown config providers', () => { }) it('lets instance inputs override config components', async () => { - const html = await renderMarkdown( - '::alert\nHello\n::', - [defineMarkdownComponent({ components: { alert: ConfigAlert } })], - { alert: InstanceAlert } - ) + const html = await renderMarkdown('::alert\nHello\n::', [provideMarkdown({ components: { alert: ConfigAlert } })], { + alert: InstanceAlert, + }) expect(html).toContain('instance-alert') expect(html).not.toContain('config-alert') }) it('lets instance plugins replace config plugins with the same name', async () => { - const provider = defineMarkdownComponent({ plugins: [emoji()] }) + const provider = provideMarkdown({ plugins: [emoji()] }) const withConfig = await renderMarkdown(':smile:', [provider]) const withOverride = await renderMarkdown(':smile:', [provider], undefined, [{ name: 'emoji' }]) @@ -103,7 +101,7 @@ describe('Markdown config providers', () => { it('inherits a config unwrap default when the input is omitted', async () => { await TestBed.configureTestingModule({ imports: [Markdown], - providers: [defineMarkdownComponent({ unwrap: true })], + providers: [provideMarkdown({ unwrap: true })], }).compileComponents() const fixture = TestBed.createComponent(Markdown) fixture.componentRef.setInput('value', 'Hello') @@ -119,7 +117,7 @@ describe('Markdown config providers', () => { it('lets an explicit unwrap=false override a config default', async () => { await TestBed.configureTestingModule({ imports: [Markdown], - providers: [defineMarkdownComponent({ unwrap: true })], + providers: [provideMarkdown({ unwrap: true })], }).compileComponents() const fixture = TestBed.createComponent(Markdown) fixture.componentRef.setInput('value', 'Hello') @@ -138,7 +136,7 @@ describe('Markdown config providers', () => { const App = app({ imports: [MarkdownDocument], providers: [ - defineMarkdownDocumentComponent({ + provideMarkdownDocument({ class: 'document-class', transformNode: ({ tag }) => (tag === 'p' ? { tag: 'section' } : undefined), }), diff --git a/packages/comark-angular/test/provider.test.ts b/packages/comark-angular/test/provider.test.ts new file mode 100644 index 000000000..b59f26472 --- /dev/null +++ b/packages/comark-angular/test/provider.test.ts @@ -0,0 +1,56 @@ +import { describe, expect, it } from 'vitest' +import type { ValueProvider } from '@angular/core' +import type { NodeTransform } from 'comark' +import { provideMarkdown, provideMarkdownDocument } from '../src/provider.ts' +import { MARKDOWN_CONFIG, MARKDOWN_DOCUMENT_CONFIG } from '../src/config.ts' + +describe('provideMarkdown', () => { + it('returns a MARKDOWN_CONFIG provider with defaults and overrides', () => { + const empty = provideMarkdown() as ValueProvider + expect(empty.provide).toBe(MARKDOWN_CONFIG) + expect(empty.useValue).toMatchObject({ options: {}, plugins: [], components: {} }) + + const plugin = { name: 'test', setup: () => {} } + const transformNode: NodeTransform = () => undefined + class FakeComponent {} + const provider = provideMarkdown({ + plugins: [plugin as any], + components: { alert: FakeComponent }, + class: 'prose', + autoClose: true, + transformNode, + }) as ValueProvider + + expect(provider.provide).toBe(MARKDOWN_CONFIG) + expect(provider.useValue).toEqual({ + options: { autoClose: true }, + plugins: [plugin], + components: { alert: FakeComponent }, + transformNode, + class: 'prose', + }) + }) +}) + +describe('provideMarkdownDocument', () => { + it('returns a MARKDOWN_DOCUMENT_CONFIG provider with defaults and overrides', () => { + const empty = provideMarkdownDocument() as ValueProvider + expect(empty.provide).toBe(MARKDOWN_DOCUMENT_CONFIG) + expect(empty.useValue.components).toEqual({}) + + const transformNode: NodeTransform = () => undefined + class FakeComponent {} + const provider = provideMarkdownDocument({ + components: { Math: FakeComponent }, + class: 'prose', + transformNode, + }) as ValueProvider + + expect(provider.provide).toBe(MARKDOWN_DOCUMENT_CONFIG) + expect(provider.useValue).toEqual({ + components: { Math: FakeComponent }, + class: 'prose', + transformNode, + }) + }) +}) diff --git a/packages/comark-angular/test/reparse.test.ts b/packages/comark-angular/test/reparse.test.ts index 5435a7fb2..5a9c4c5de 100644 --- a/packages/comark-angular/test/reparse.test.ts +++ b/packages/comark-angular/test/reparse.test.ts @@ -2,7 +2,7 @@ import { describe, expect, it, vi, beforeEach } from 'vitest' import { TestBed } from '@angular/core/testing' import type { Provider, Type } from '@angular/core' import { Markdown } from '../src/components/markdown.component.ts' -import { defineMarkdownComponent } from '../src/define.ts' +import { provideMarkdown } from '../src/provider.ts' describe('Markdown re-parses when parser inputs change', () => { beforeEach(async () => { @@ -49,8 +49,8 @@ describe('Markdown re-parses when parser inputs change', () => { }) }) - it('re-parses with a defineMarkdownComponent config provider when `unwrap` changes', async () => { - const fixture = await render(Markdown, [defineMarkdownComponent({})]) + it('re-parses with a provideMarkdown config provider when `unwrap` changes', async () => { + const fixture = await render(Markdown, [provideMarkdown({})]) expect(fixture.nativeElement.querySelector('p')).not.toBeNull() fixture.componentRef.setInput('unwrap', true) diff --git a/packages/comark-angular/tsconfig.spec.json b/packages/comark-angular/tsconfig.spec.json index 9c50ca465..156e6ae17 100644 --- a/packages/comark-angular/tsconfig.spec.json +++ b/packages/comark-angular/tsconfig.spec.json @@ -4,7 +4,7 @@ "extends": "./tsconfig.json", "compilerOptions": { "outDir": "./out-tsc/spec", - "types": ["vitest/globals"] + "types": ["node", "vitest/globals"] }, "include": ["test/**/*.d.ts", "test/**/*.test.ts"] } diff --git a/test/bundle.test.ts b/test/bundle.test.ts index 1fe7568a3..24379a11e 100644 --- a/test/bundle.test.ts +++ b/test/bundle.test.ts @@ -70,7 +70,7 @@ describe('package bundle size', { timeout: 60_000 }, () => { expect(report).toMatchInlineSnapshot(` { - "@comark/angular": "69.3k (63 files)", + "@comark/angular": "77.4k (63 files)", "@comark/ansi": "42.1k (109 files)", "@comark/html": "17.7k (69 files)", "@comark/nuxt": "11.0k (69 files)", From bcc3e23208e40e5ead5de23e5a58bfb40e3c6ff3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Thu, 19 Nov 2026 08:43:47 -0500 Subject: [PATCH 09/11] docs(angular): restore factory docs and add provider section --- AGENTS.md | 6 +- docs/content/3.rendering/7.angular.md | 69 +++++++++++++++---- docs/content/5.reference/3.reference.md | 2 +- .../comark/references/rendering-angular.md | 65 ++++++++++++++--- 4 files changed, 114 insertions(+), 28 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9cc4d1a63..1d58600b5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -152,9 +152,9 @@ Svelte 5 renderer (`Markdown`, `MarkdownDocument`, `MarkdownNode`) plus experime ### `@comark/angular` (`packages/comark-angular/`) -Angular 21+ renderer (peer range `>=21 <23`) with standalone components (`Markdown` selector `comark-markdown`, `MarkdownDocument`, `provideMarkdown`, `provideMarkdownDocument`). +Angular 21+ renderer (peer range `>=21 <23`) with standalone components (`Markdown` selector `comark-markdown`, `MarkdownDocument`, `defineMarkdownComponent`, `defineMarkdownDocumentComponent`, `provideMarkdown`, `provideMarkdownDocument`). -- `provideMarkdown` / `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG` (`src/config.ts`). The static `Markdown` / `MarkdownDocument` components inject those tokens optionally. Use these in AOT builds: a component class returned from a factory cannot be resolved in `imports` (NG1010 / ngtsc -991010). `defineMarkdownComponent` / `defineMarkdownDocumentComponent` remain as component-class factories for JIT builds. +- `provideMarkdown` / `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG` (`src/config.ts`). The static `Markdown` / `MarkdownDocument` components inject those tokens optionally. Use these in AOT builds: a component class returned by a factory cannot be resolved in `imports` (NG1010 / ngtsc -991010). `defineMarkdownComponent` / `defineMarkdownDocumentComponent` remain as component-class factories for JIT builds. - Built with `ng-packagr` (`ng build`), then `scripts/strip-sourcemaps.mjs` removes emitted source maps and `scripts/sync-plugins.mjs` writes plain plugin re-exports and `./plugins/*` export map entries into `dist/package.json`. - Plugin entry points use **named exports** because the Angular Package Format strips `export default` (`import { math, Math } from '@comark/angular/plugins/math'`, `import { security } from '@comark/angular/plugins/security'`). - Publishes from `dist/` via `publishConfig.directory`; `test/bundle.test.ts` packs from `dist/` too. @@ -218,7 +218,7 @@ import { createAnsiRenderer, createAnsiPrinter, printAnsi, renderAnsi, renderAns import { Markdown, MarkdownDocument, defineMarkdownComponent } from '@comark/vue' // also @comark/react import { Markdown, MarkdownDocument } from '@comark/svelte' import { MarkdownAsync } from '@comark/svelte/async' -import { Markdown, MarkdownDocument, provideMarkdown, MARKDOWN_CONFIG } from '@comark/angular' +import { Markdown, MarkdownDocument, defineMarkdownComponent, provideMarkdown, MARKDOWN_CONFIG } from '@comark/angular' import math, { Math } from '@comark/vue/plugins/math' // same shape in html, react, svelte (`{ math, Math }` in angular) import mermaid, { Mermaid } from '@comark/vue/plugins/mermaid' import binding, { Binding, If } from '@comark/vue/plugins/binding' diff --git a/docs/content/3.rendering/7.angular.md b/docs/content/3.rendering/7.angular.md index 18adf858b..ad6743a94 100644 --- a/docs/content/3.rendering/7.angular.md +++ b/docs/content/3.rendering/7.angular.md @@ -544,9 +544,59 @@ export class HeadingComponent { ## Pre-configured components -Use `provideMarkdown` and `provideMarkdownDocument` to pre-configure plugins, component mappings, styling, and node transforms. Both helpers return an Angular `Provider`, not a component class. Import the static `Markdown` or `MarkdownDocument` component in `imports`, then add the provider in `providers`. This keeps the component statically analyzable: factory-created component classes in `imports` fail AOT compilation with NG1010 (ngtsc error -991010). +Use `defineMarkdownComponent` and `defineMarkdownDocumentComponent` to create pre-configured wrappers with default plugins, components, and styling. -### `provideMarkdown` +### `defineMarkdownComponent` + +```typescript [components/docs-markdown.ts] +import { defineMarkdownComponent } from '@comark/angular' +import { shiki } from '@comark/angular/plugins/shiki' +import { math, Math } from '@comark/angular/plugins/math' +import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' + +export const DocsMarkdown = defineMarkdownComponent({ + plugins: [shiki(), math(), mermaid()], + components: { Math, Mermaid }, + class: 'prose dark:prose-invert', +}) +``` + +Then use it like any other component. The returned component always uses the `comark-markdown-defined` selector: + +```typescript [page.component.ts] +import { Component } from '@angular/core' +import { DocsMarkdown } from './components/docs-markdown' + +@Component({ + selector: 'app-page', + standalone: true, + imports: [DocsMarkdown], + template: ``, +}) +export class PageComponent { + content = '# Hello\n\n$E = mc^2$' +} +``` + +Instance-level `[plugins]` and `[components]` inputs are merged with (and override) the config-level defaults. Both `defineMarkdownComponent` and `defineMarkdownDocumentComponent` also accept `transformNode`, which runs before the instance's `[transformNode]` input. + +### `defineMarkdownDocumentComponent` + +Creates a pre-configured `` component. The returned component always uses the `comark-markdown-document-defined` selector: + +```typescript [components/docs-markdown-document.ts] +import { defineMarkdownDocumentComponent } from '@comark/angular' +import { Math } from '@comark/angular/plugins/math' + +export const DocsMarkdownDocument = defineMarkdownDocumentComponent({ + components: { Math }, + class: 'prose', +}) +``` + +### `provideMarkdown` and `provideMarkdownDocument` (AOT-safe) + +Angular AOT cannot statically resolve a component class returned by a factory in `imports` (NG1010 / ngtsc error -991010). For AOT builds, keep the static components in `imports` and register config providers instead: ```typescript [page.component.ts] import { Component } from '@angular/core' @@ -573,11 +623,7 @@ export class PageComponent { } ``` -The provider can also be scoped to a route or an ancestor component. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the provider config and win on conflict. Config plugins run before instance plugins. An instance plugin with the same name replaces the config plugin and runs in the instance order. `transformNode` from the config runs before the instance's own `transformNode`. - -### `provideMarkdownDocument` - -Pre-configure the low-level renderer the same way: +For the low-level renderer: ```typescript [page.component.ts] import { Component, OnInit } from '@angular/core' @@ -589,12 +635,7 @@ import { Math } from '@comark/angular/plugins/math' selector: 'app-page', standalone: true, imports: [MarkdownDocument], - providers: [ - provideMarkdownDocument({ - components: { Math }, - class: 'prose', - }), - ], + providers: [provideMarkdownDocument({ components: { Math }, class: 'prose' })], template: `@if (document) { }`, }) export class PageComponent implements OnInit { @@ -606,6 +647,6 @@ export class PageComponent implements OnInit { } ``` -The underlying `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG` tokens are exported for custom providers and overrides. +`provideMarkdown` and `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Both tokens and their config interfaces are exported. The provider can be scoped to a route or an ancestor component. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the provider config and win on conflict. Config plugins run before instance plugins; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above still return component classes for JIT apps that disable AOT and import `@angular/compiler`. --- diff --git a/docs/content/5.reference/3.reference.md b/docs/content/5.reference/3.reference.md index ff0cf5878..a86f3f5d8 100644 --- a/docs/content/5.reference/3.reference.md +++ b/docs/content/5.reference/3.reference.md @@ -251,7 +251,7 @@ export const AppMarkdown = defineMarkdownComponent({ }) ``` -> In `@comark/angular`, use `provideMarkdown` and `provideMarkdownDocument` in AOT builds. They return a config `Provider`: import the static `Markdown` or `MarkdownDocument` component in `imports` and put the provider in `providers`. The `defineMarkdownComponent` / `defineMarkdownDocumentComponent` factories still return component classes for JIT builds. See the [Angular renderer guide](/rendering/angular#pre-configured-components). +> In `@comark/angular`, `provideMarkdown` and `provideMarkdownDocument` are the AOT-safe alternatives. They return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG`: import the static `Markdown` or `MarkdownDocument` component in `imports` and put the provider in `providers`. The `defineMarkdownComponent` / `defineMarkdownDocumentComponent` factories still return component classes for JIT builds. See the [Angular renderer guide](/rendering/angular#pre-configured-components). ## Transforming nodes before render diff --git a/docs/skills/comark/references/rendering-angular.md b/docs/skills/comark/references/rendering-angular.md index 9ff503467..05690a1f4 100644 --- a/docs/skills/comark/references/rendering-angular.md +++ b/docs/skills/comark/references/rendering-angular.md @@ -479,9 +479,58 @@ export class AppComponent { ## Pre-configured components -Use `provideMarkdown` or `provideMarkdownDocument` to pre-configure plugins, component mappings, styling, and node transforms. Each helper returns an Angular `Provider`. Import the static `Markdown` or `MarkdownDocument` component in `imports`; a component class made by a runtime factory cannot be statically resolved in `imports` and fails AOT builds with NG1010. +Use `defineMarkdownComponent` or `defineMarkdownDocumentComponent` to create pre-configured components with default plugins and component mappings: -### provideMarkdown +### defineMarkdownComponent + +```typescript +// docs-markdown.component.ts +import { defineMarkdownComponent } from '@comark/angular' +import { math, Math } from '@comark/angular/plugins/math' +import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' + +export const DocsMarkdown = defineMarkdownComponent({ + plugins: [math(), mermaid()], + components: { Math, Mermaid }, + class: 'prose dark:prose-invert', +}) +``` + +Use the pre-configured component: + +```typescript +import { Component } from '@angular/core' +import { DocsMarkdown } from './docs-markdown.component' + +@Component({ + selector: 'app-docs', + standalone: true, + imports: [DocsMarkdown], + template: ` + + `, +}) +export class DocsComponent { + content = '# Math: $E = mc^2$' +} +``` + +Instance-level `components` and `plugins` are merged with the config-level defaults at runtime. + +### defineMarkdownDocumentComponent + +```typescript +import { defineMarkdownDocumentComponent } from '@comark/angular' +import { Math } from '@comark/angular/plugins/math' + +export const DocsMarkdownDocument = defineMarkdownDocumentComponent({ + components: { Math }, +}) +``` + +### provideMarkdown and provideMarkdownDocument (AOT-safe) + +Factory-created component classes cannot be resolved in `imports` under AOT (NG1010). For AOT builds, import the static components and register config providers: ```typescript import { Component } from '@angular/core' @@ -507,9 +556,7 @@ export class DocsComponent { } ``` -Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the provider config and win on conflict. Config plugins run first. An instance plugin with the same name replaces the config plugin and runs in the instance order. Config `transformNode` runs before the instance's own transform. - -### provideMarkdownDocument +For the low-level renderer: ```typescript import { Component, OnInit } from '@angular/core' @@ -521,11 +568,7 @@ import { Math } from '@comark/angular/plugins/math' selector: 'app-docs', standalone: true, imports: [MarkdownDocument], - providers: [ - provideMarkdownDocument({ - components: { Math }, - }), - ], + providers: [provideMarkdownDocument({ components: { Math } })], template: `@if (document) { }`, }) export class DocsComponent implements OnInit { @@ -537,6 +580,8 @@ export class DocsComponent implements OnInit { } ``` +Both helpers return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the provider config and win on conflict. Config plugins run first; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above remain for JIT apps that disable AOT and import `@angular/compiler`. + --- ## Plugins From 166377d227e0834ab32061186360e7c4138af1e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Thu, 19 Nov 2026 08:47:46 -0500 Subject: [PATCH 10/11] docs(angular): register providers globally in examples --- AGENTS.md | 2 +- docs/content/3.rendering/7.angular.md | 47 ++++++++----------- docs/content/5.reference/3.reference.md | 2 +- .../comark/references/rendering-angular.md | 42 +++++++---------- 4 files changed, 38 insertions(+), 55 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 1d58600b5..8cbf12877 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -154,7 +154,7 @@ Svelte 5 renderer (`Markdown`, `MarkdownDocument`, `MarkdownNode`) plus experime Angular 21+ renderer (peer range `>=21 <23`) with standalone components (`Markdown` selector `comark-markdown`, `MarkdownDocument`, `defineMarkdownComponent`, `defineMarkdownDocumentComponent`, `provideMarkdown`, `provideMarkdownDocument`). -- `provideMarkdown` / `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG` (`src/config.ts`). The static `Markdown` / `MarkdownDocument` components inject those tokens optionally. Use these in AOT builds: a component class returned by a factory cannot be resolved in `imports` (NG1010 / ngtsc -991010). `defineMarkdownComponent` / `defineMarkdownDocumentComponent` remain as component-class factories for JIT builds. +- `provideMarkdown` / `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG` (`src/config.ts`). Register them at bootstrap to configure every instance, or scope them to a route or ancestor injector. The static `Markdown` / `MarkdownDocument` components inject those tokens optionally. Use these in AOT builds: a component class returned by a factory cannot be resolved in `imports` (NG1010 / ngtsc -991010). `defineMarkdownComponent` / `defineMarkdownDocumentComponent` remain as component-class factories for JIT builds. - Built with `ng-packagr` (`ng build`), then `scripts/strip-sourcemaps.mjs` removes emitted source maps and `scripts/sync-plugins.mjs` writes plain plugin re-exports and `./plugins/*` export map entries into `dist/package.json`. - Plugin entry points use **named exports** because the Angular Package Format strips `export default` (`import { math, Math } from '@comark/angular/plugins/math'`, `import { security } from '@comark/angular/plugins/security'`). - Publishes from `dist/` via `publishConfig.directory`; `test/bundle.test.ts` packs from `dist/` too. diff --git a/docs/content/3.rendering/7.angular.md b/docs/content/3.rendering/7.angular.md index ad6743a94..85a909beb 100644 --- a/docs/content/3.rendering/7.angular.md +++ b/docs/content/3.rendering/7.angular.md @@ -596,57 +596,50 @@ export const DocsMarkdownDocument = defineMarkdownDocumentComponent({ ### `provideMarkdown` and `provideMarkdownDocument` (AOT-safe) -Angular AOT cannot statically resolve a component class returned by a factory in `imports` (NG1010 / ngtsc error -991010). For AOT builds, keep the static components in `imports` and register config providers instead: +Angular AOT cannot statically resolve a component class returned by a factory in `imports` (NG1010 / ngtsc error -991010). For AOT builds, keep the static components in `imports` and register the config providers once at bootstrap. Every Markdown component in the app then uses that config. -```typescript [page.component.ts] -import { Component } from '@angular/core' -import { Markdown, provideMarkdown } from '@comark/angular' +```typescript [main.ts] +import { bootstrapApplication } from '@angular/platform-browser' +import { AppComponent } from './app.component' +import { provideMarkdown, provideMarkdownDocument } from '@comark/angular' import { shiki } from '@comark/angular/plugins/shiki' import { math, Math } from '@comark/angular/plugins/math' import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' -@Component({ - selector: 'app-page', - standalone: true, - imports: [Markdown], +bootstrapApplication(AppComponent, { providers: [ provideMarkdown({ plugins: [shiki(), math(), mermaid()], components: { Math, Mermaid }, class: 'prose dark:prose-invert', }), + provideMarkdownDocument({ + components: { Math }, + class: 'prose', + }), ], - template: ``, }) -export class PageComponent { - content = '# Hello\n\n$E = mc^2$' -} ``` -For the low-level renderer: +Components only import the static component. No provider or wrapper is needed in each component: ```typescript [page.component.ts] -import { Component, OnInit } from '@angular/core' -import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' -import { MarkdownDocument, provideMarkdownDocument } from '@comark/angular' -import { Math } from '@comark/angular/plugins/math' +import { Component } from '@angular/core' +import { Markdown } from '@comark/angular' @Component({ selector: 'app-page', standalone: true, - imports: [MarkdownDocument], - providers: [provideMarkdownDocument({ components: { Math }, class: 'prose' })], - template: `@if (document) { }`, + imports: [Markdown], + template: ``, }) -export class PageComponent implements OnInit { - document?: MarkdownDocumentType - - async ngOnInit(): Promise { - this.document = await parseMarkdown('# Hello') - } +export class PageComponent { + content = '# Hello\n\n$E = mc^2$' } ``` -`provideMarkdown` and `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Both tokens and their config interfaces are exported. The provider can be scoped to a route or an ancestor component. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the provider config and win on conflict. Config plugins run before instance plugins; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above still return component classes for JIT apps that disable AOT and import `@angular/compiler`. +The same applies to ``: import `MarkdownDocument` and it picks up `provideMarkdownDocument` from the root injector. + +`provideMarkdown` and `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Both tokens and their config interfaces are exported. Providers can also be scoped to a route or an ancestor component; the closest injector wins. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the global config and win on conflict. Config plugins run before instance plugins; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above still return component classes for JIT apps that disable AOT and import `@angular/compiler`. --- diff --git a/docs/content/5.reference/3.reference.md b/docs/content/5.reference/3.reference.md index a86f3f5d8..8146dbdb0 100644 --- a/docs/content/5.reference/3.reference.md +++ b/docs/content/5.reference/3.reference.md @@ -251,7 +251,7 @@ export const AppMarkdown = defineMarkdownComponent({ }) ``` -> In `@comark/angular`, `provideMarkdown` and `provideMarkdownDocument` are the AOT-safe alternatives. They return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG`: import the static `Markdown` or `MarkdownDocument` component in `imports` and put the provider in `providers`. The `defineMarkdownComponent` / `defineMarkdownDocumentComponent` factories still return component classes for JIT builds. See the [Angular renderer guide](/rendering/angular#pre-configured-components). +> In `@comark/angular`, `provideMarkdown` and `provideMarkdownDocument` are the AOT-safe alternatives. They return config `Provider` objects for `MARKDOWN_CONFIG` / `MARKDOWN_DOCUMENT_CONFIG`: register them once at bootstrap (or in a route or ancestor injector) and every static `Markdown` / `MarkdownDocument` component inherits the config. The `defineMarkdownComponent` / `defineMarkdownDocumentComponent` factories still return component classes for JIT builds. See the [Angular renderer guide](/rendering/angular#pre-configured-components). ## Transforming nodes before render diff --git a/docs/skills/comark/references/rendering-angular.md b/docs/skills/comark/references/rendering-angular.md index 05690a1f4..b1a36bda8 100644 --- a/docs/skills/comark/references/rendering-angular.md +++ b/docs/skills/comark/references/rendering-angular.md @@ -530,57 +530,47 @@ export const DocsMarkdownDocument = defineMarkdownDocumentComponent({ ### provideMarkdown and provideMarkdownDocument (AOT-safe) -Factory-created component classes cannot be resolved in `imports` under AOT (NG1010). For AOT builds, import the static components and register config providers: +Factory-created component classes cannot be resolved in `imports` under AOT (NG1010). For AOT builds, import the static components and register the config providers once at bootstrap. Every Markdown component in the app inherits that config: ```typescript -import { Component } from '@angular/core' -import { Markdown, provideMarkdown } from '@comark/angular' +import { bootstrapApplication } from '@angular/platform-browser' +import { AppComponent } from './app.component' +import { provideMarkdown, provideMarkdownDocument } from '@comark/angular' import { math, Math } from '@comark/angular/plugins/math' import { mermaid, Mermaid } from '@comark/angular/plugins/mermaid' -@Component({ - selector: 'app-docs', - standalone: true, - imports: [Markdown], +bootstrapApplication(AppComponent, { providers: [ provideMarkdown({ plugins: [math(), mermaid()], components: { Math, Mermaid }, class: 'prose dark:prose-invert', }), + provideMarkdownDocument({ components: { Math } }), ], - template: ``, }) -export class DocsComponent { - content = '# Math: $E = mc^2$' -} ``` -For the low-level renderer: +Components only import the static component. No provider or wrapper is needed in each component: ```typescript -import { Component, OnInit } from '@angular/core' -import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' -import { MarkdownDocument, provideMarkdownDocument } from '@comark/angular' -import { Math } from '@comark/angular/plugins/math' +import { Component } from '@angular/core' +import { Markdown } from '@comark/angular' @Component({ selector: 'app-docs', standalone: true, - imports: [MarkdownDocument], - providers: [provideMarkdownDocument({ components: { Math } })], - template: `@if (document) { }`, + imports: [Markdown], + template: ``, }) -export class DocsComponent implements OnInit { - document?: MarkdownDocumentType - - async ngOnInit(): Promise { - this.document = await parseMarkdown('# Hello') - } +export class DocsComponent { + content = '# Math: $E = mc^2$' } ``` -Both helpers return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the provider config and win on conflict. Config plugins run first; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above remain for JIT apps that disable AOT and import `@angular/compiler`. +The same applies to ``: import `MarkdownDocument` and it picks up `provideMarkdownDocument` from the root injector. + +Both helpers return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Providers can also be scoped to a route or an ancestor component; the closest injector wins. Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the global config and win on conflict. Config plugins run first; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above remain for JIT apps that disable AOT and import `@angular/compiler`. --- From 2dd522f060f272017544adb622c489fb712bcbb3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Adri=C3=A1n=20UB?= <22903142+adrian-ub@users.noreply.github.com> Date: Thu, 19 Nov 2026 08:54:16 -0500 Subject: [PATCH 11/11] fix(angular): keep first duplicate plugin and use signal in docs --- docs/content/3.rendering/7.angular.md | 22 ++++++++++++++++++- .../comark/references/rendering-angular.md | 22 ++++++++++++++++++- .../src/components/markdown.component.ts | 14 ++---------- packages/comark-angular/src/config.ts | 22 +++++++++++++++++++ packages/comark-angular/src/define.ts | 21 ++---------------- .../test/define-component.test.ts | 14 ++++++++++++ .../test/provider-config.test.ts | 14 ++++++++++++ test/bundle.test.ts | 2 +- 8 files changed, 97 insertions(+), 34 deletions(-) diff --git a/docs/content/3.rendering/7.angular.md b/docs/content/3.rendering/7.angular.md index 85a909beb..3cddf8937 100644 --- a/docs/content/3.rendering/7.angular.md +++ b/docs/content/3.rendering/7.angular.md @@ -638,7 +638,27 @@ export class PageComponent { } ``` -The same applies to ``: import `MarkdownDocument` and it picks up `provideMarkdownDocument` from the root injector. +The same applies to ``: import `MarkdownDocument` and it picks up `provideMarkdownDocument` from the root injector. Use a signal for an asynchronously parsed document so zoneless change detection sees the update: + +```typescript [page.component.ts] +import { Component, OnInit, signal } from '@angular/core' +import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' +import { MarkdownDocument } from '@comark/angular' + +@Component({ + selector: 'app-page', + standalone: true, + imports: [MarkdownDocument], + template: `@if (document(); as document) { }`, +}) +export class PageComponent implements OnInit { + readonly document = signal(undefined) + + async ngOnInit(): Promise { + this.document.set(await parseMarkdown('# Hello')) + } +} +``` `provideMarkdown` and `provideMarkdownDocument` return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Both tokens and their config interfaces are exported. Providers can also be scoped to a route or an ancestor component; the closest injector wins. Instance-level `[options]`, `[plugins]`, `[components]`, and `[transformNode]` inputs merge with the global config and win on conflict. Config plugins run before instance plugins; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above still return component classes for JIT apps that disable AOT and import `@angular/compiler`. diff --git a/docs/skills/comark/references/rendering-angular.md b/docs/skills/comark/references/rendering-angular.md index b1a36bda8..c5320294a 100644 --- a/docs/skills/comark/references/rendering-angular.md +++ b/docs/skills/comark/references/rendering-angular.md @@ -568,7 +568,27 @@ export class DocsComponent { } ``` -The same applies to ``: import `MarkdownDocument` and it picks up `provideMarkdownDocument` from the root injector. +The same applies to ``: import `MarkdownDocument` and it picks up `provideMarkdownDocument` from the root injector. Use a signal for an asynchronously parsed document so zoneless change detection sees the update: + +```typescript +import { Component, OnInit, signal } from '@angular/core' +import { parseMarkdown, type MarkdownDocument as MarkdownDocumentType } from 'comark' +import { MarkdownDocument } from '@comark/angular' + +@Component({ + selector: 'app-docs', + standalone: true, + imports: [MarkdownDocument], + template: `@if (document(); as document) { }`, +}) +export class DocsComponent implements OnInit { + readonly document = signal(undefined) + + async ngOnInit(): Promise { + this.document.set(await parseMarkdown('# Hello')) + } +} +``` Both helpers return config `Provider` objects for `MARKDOWN_CONFIG` and `MARKDOWN_DOCUMENT_CONFIG`. Providers can also be scoped to a route or an ancestor component; the closest injector wins. Instance-level `options`, `plugins`, `components`, and `transformNode` inputs merge with the global config and win on conflict. Config plugins run first; a same-name instance plugin replaces the config plugin. Config `transformNode` runs before the instance's own transform. The `defineMarkdown*` factories above remain for JIT apps that disable AOT and import `@angular/compiler`. diff --git a/packages/comark-angular/src/components/markdown.component.ts b/packages/comark-angular/src/components/markdown.component.ts index cae9591ba..d55aab984 100644 --- a/packages/comark-angular/src/components/markdown.component.ts +++ b/packages/comark-angular/src/components/markdown.component.ts @@ -12,7 +12,7 @@ import { import { createSerializedMarkdownParser } from 'comark' import type { ParserOptions, MarkdownDocument as MarkdownDocumentType, NodeTransform } from 'comark' import { isMarkdownDocument, mergeNodeTransforms } from 'comark/utils' -import { MARKDOWN_CONFIG } from '../config' +import { MARKDOWN_CONFIG, mergeConfigPlugins } from '../config' import type { MarkdownConfig } from '../config' import { MarkdownDocument } from './markdown-document.component' @@ -104,22 +104,12 @@ export class Markdown { * default, while an explicit `false` overrides it. */ protected getParserOptions(): ParserOptions { - const plugins = new Map[number]>() - - for (const plugin of this.config?.plugins ?? []) { - plugins.set(plugin.name, plugin) - } - for (const plugin of this.plugins() ?? []) { - plugins.delete(plugin.name) - plugins.set(plugin.name, plugin) - } - const unwrap = this.unwrap() return { ...(this.config?.options ?? {}), ...this.options(), ...(unwrap === undefined ? {} : { unwrap }), - plugins: [...plugins.values()], + plugins: mergeConfigPlugins(this.config?.plugins, this.plugins()), } } diff --git a/packages/comark-angular/src/config.ts b/packages/comark-angular/src/config.ts index 22220b910..c669e2d3d 100644 --- a/packages/comark-angular/src/config.ts +++ b/packages/comark-angular/src/config.ts @@ -26,3 +26,25 @@ export interface MarkdownDocumentConfig { export const MARKDOWN_CONFIG = new InjectionToken('comark.MARKDOWN_CONFIG') export const MARKDOWN_DOCUMENT_CONFIG = new InjectionToken('comark.MARKDOWN_DOCUMENT_CONFIG') + +type ConfigPlugin = NonNullable[number] + +/** Keep the first plugin per name in each list, then let instance plugins replace config plugins. */ +export function mergeConfigPlugins( + configPlugins: ParserOptions['plugins'], + instancePlugins: ParserOptions['plugins'] +): ConfigPlugin[] { + const plugins = new Map() + + for (const list of [configPlugins, instancePlugins]) { + const seen = new Set() + for (const plugin of list ?? []) { + if (seen.has(plugin.name)) continue + seen.add(plugin.name) + plugins.delete(plugin.name) + plugins.set(plugin.name, plugin) + } + } + + return [...plugins.values()] +} diff --git a/packages/comark-angular/src/define.ts b/packages/comark-angular/src/define.ts index 9ccb565f5..ef091f785 100644 --- a/packages/comark-angular/src/define.ts +++ b/packages/comark-angular/src/define.ts @@ -3,6 +3,7 @@ import type { NodeTransform, ParserOptions } from 'comark' import { mergeNodeTransforms } from 'comark/utils' import { Markdown } from './components/markdown.component' import { MarkdownDocument } from './components/markdown-document.component' +import { mergeConfigPlugins } from './config' export interface DefineMarkdownComponentOptions extends ParserOptions { /** Pre-configured component mappings. */ @@ -88,24 +89,6 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = return configClass || '' } - /** - * Effective plugins: config-level plugins first, then instance plugins. - * An instance plugin with the same name replaces the config plugin. - */ - private readonly effectivePlugins = computed(() => { - const plugins = new Map[number]>() - - for (const plugin of configPlugins) { - plugins.set(plugin.name, plugin) - } - for (const plugin of this.plugins() ?? []) { - plugins.delete(plugin.name) - plugins.set(plugin.name, plugin) - } - - return [...plugins.values()] - }) - /** * Merge config-level parse options under the instance `options` input so * instance values override config defaults, without writing back to the @@ -117,7 +100,7 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions = ...parseOptions, ...this.options(), ...(unwrap === undefined ? {} : { unwrap }), - plugins: this.effectivePlugins(), + plugins: mergeConfigPlugins(configPlugins, this.plugins()), } } } diff --git a/packages/comark-angular/test/define-component.test.ts b/packages/comark-angular/test/define-component.test.ts index 9a0ddf26f..ac676bbd9 100644 --- a/packages/comark-angular/test/define-component.test.ts +++ b/packages/comark-angular/test/define-component.test.ts @@ -3,6 +3,7 @@ import { beforeEach, describe, expect, it, vi } from 'vitest' import { TestBed } from '@angular/core/testing' import type { NodeTransform } from 'comark' import { parseMarkdown } from 'comark' +import emoji from 'comark/plugins/emoji' import { defineMarkdownComponent, defineMarkdownDocumentComponent } from '../src/define.ts' import { ConfiguredMarkdown, ConfiguredMarkdownDocument, InstanceAlert } from './fixtures/defined/defined.ts' @@ -45,6 +46,19 @@ describe('defineMarkdownComponent', () => { expect(html).toContain('config-alert') }) + it('keeps the first duplicate plugin from the factory config', async () => { + const Defined = defineMarkdownComponent({ plugins: [emoji({ extend: { project: '🚀' } }), emoji()] }) + await TestBed.configureTestingModule({ imports: [Defined] }).compileComponents() + const fixture = TestBed.createComponent(Defined) + fixture.componentRef.setInput('value', ':project:') + fixture.detectChanges() + + await vi.waitFor(() => { + fixture.detectChanges() + expect(fixture.nativeElement.textContent).toContain('🚀') + }) + }) + it('lets instance components override the factory config', async () => { await TestBed.configureTestingModule({ imports: [ConfiguredMarkdown] }).compileComponents() const fixture = TestBed.createComponent(ConfiguredMarkdown) diff --git a/packages/comark-angular/test/provider-config.test.ts b/packages/comark-angular/test/provider-config.test.ts index a588a81d5..c305f8e58 100644 --- a/packages/comark-angular/test/provider-config.test.ts +++ b/packages/comark-angular/test/provider-config.test.ts @@ -98,6 +98,20 @@ describe('Markdown config providers', () => { expect(withOverride).not.toContain('😄') }) + it('keeps the first duplicate in the config plugin list', async () => { + const html = await renderMarkdown(':project:', [ + provideMarkdown({ plugins: [emoji({ extend: { project: '🚀' } }), emoji()] }), + ]) + + expect(html).toContain('🚀') + }) + + it('keeps the first duplicate in the instance plugin list', async () => { + const html = await renderMarkdown(':project:', [], undefined, [emoji({ extend: { project: '🚀' } }), emoji()]) + + expect(html).toContain('🚀') + }) + it('inherits a config unwrap default when the input is omitted', async () => { await TestBed.configureTestingModule({ imports: [Markdown], diff --git a/test/bundle.test.ts b/test/bundle.test.ts index 24379a11e..32b31fd8f 100644 --- a/test/bundle.test.ts +++ b/test/bundle.test.ts @@ -70,7 +70,7 @@ describe('package bundle size', { timeout: 60_000 }, () => { expect(report).toMatchInlineSnapshot(` { - "@comark/angular": "77.4k (63 files)", + "@comark/angular": "77.2k (63 files)", "@comark/ansi": "42.1k (109 files)", "@comark/html": "17.7k (69 files)", "@comark/nuxt": "11.0k (69 files)",