fix(vue): accept a parsed document in a defined component

packages/comark-angular/src/components/markdown.component.ts

@@ -44,7 +44,7 @@ export class Markdown implements OnChanges {
   @Input() value?: string | MarkdownDocumentType
 
   /** Parser options (excluding plugins) */
-  @Input() options: Exclude<ParserOptions, 'plugins'> = {}
+  @Input() options: Omit<ParserOptions, 'plugins'> = {}
 
   /** Additional plugins to use */
   @Input() plugins: ParserOptions['plugins'] = []

packages/comark-react/src/components/Markdown.tsx

@@ -20,7 +20,7 @@ export interface MarkdownProps {
   /**
    * Parser options (excluding plugins)
    */
-  options?: Exclude<ParserOptions, 'plugins'>
+  options?: Omit<ParserOptions, 'plugins'>
 
   /**
    * Parser to use instead of one resolved from `options` and `plugins`

packages/comark-react/src/index.ts

@@ -60,7 +60,7 @@ export function defineMarkdownComponent(config: DefineMarkdownComponentOptions =
   } = config
 
   const MarkdownComponent: React.FC<MarkdownProps> = (props) => {
-    const mergedOptions: Exclude<ParserOptions, 'plugins'> = {
+    const mergedOptions: Omit<ParserOptions, 'plugins'> = {
       ...parseOptions,
       ...props.options,
     }

packages/comark-svelte/src/types.ts

@@ -37,7 +37,7 @@ export interface MarkdownDocumentProps {
 export interface MarkdownProps {
   /** The markdown content to parse and render, or a pre-parsed MarkdownDocument */
   value?: string | MarkdownDocument
-  options?: Exclude<ParserOptions, 'plugins'>
+  options?: Omit<ParserOptions, 'plugins'>
   plugins?: ComarkPlugin[]
 
   /**

packages/comark-vue/src/components/Markdown.ts

@@ -17,7 +17,7 @@ export interface MarkdownProps {
   /**
    * Parser options (excluding plugins)
    */
-  options?: Exclude<ParserOptions, 'plugins'>
+  options?: Omit<ParserOptions, 'plugins'>
 
   /**
    * Additional plugins to use
@@ -68,10 +68,125 @@ export interface MarkdownProps {
    * Additional data to pass to the renderer
    */
   data?: Record<string, unknown>
+
+  /**
+   * Document key used to subscribe to live updates via `globalThis.comarkContext`
+   */
+  documentKey?: string
 }
 
 type MarkdownComponent = ReturnType<typeof defineComponent<MarkdownProps>>
 
+/**
+ * Runtime prop declarations for `<Markdown>`.
+ *
+ * Exported so `defineMarkdownComponent` can reuse them verbatim instead of
+ * hand-copying the table, which had drifted: `value` was declared `String`
+ * only, and `data` and `documentKey` were missing entirely.
+ */
+export const markdownProps = {
+  /**
+   * The markdown content to parse and render, or a pre-parsed MarkdownDocument
+   */
+  value: {
+    type: [String, Object] as PropType<string | MarkdownDocumentType>,
+    default: undefined,
+  },
+
+  /**
+   * Parser options
+   */
+  options: {
+    type: Object as PropType<Omit<ParserOptions, 'plugins'>>,
+    default: () => ({}),
+  },
+
+  /**
+   * Additional plugins to use
+   */
+  plugins: {
+    type: Array as PropType<ParserOptions['plugins']>,
+    default: () => [],
+  },
+
+  /**
+   * Parser to use instead of one resolved from `options` and `plugins`
+   */
+  parser: {
+    type: Function as PropType<ComarkParseFn>,
+    default: undefined,
+  },
+
+  /**
+   * Strip wrapper tags from the top level of the document — shorthand for
+   * `options.unwrap`. `true` unwraps `<p>`; a space-separated string or array
+   * unwraps the listed tags.
+   */
+  unwrap: {
+    type: [Boolean, String, Array] as PropType<boolean | string | string[]>,
+    default: false,
+  },
+
+  /**
+   * Custom component mappings for element tags
+   * Key: tag name (e.g., 'h1', 'p', 'MyComponent')
+   * Value: Vue component
+   */
+  components: {
+    type: Object as PropType<Record<string, any>>,
+    default: () => ({}),
+  },
+
+  /**
+   * Dynamic component resolver function
+   * Used to resolve components that aren't in the components map
+   */
+  componentsManifest: {
+    type: Function as PropType<ComponentManifest>,
+    default: undefined,
+  },
+
+  /**
+   * Enable streaming mode with stream-specific components
+   */
+  streaming: {
+    type: Boolean as PropType<boolean>,
+    default: false,
+  },
+
+  /**
+   * If document has a <!-- more --> comment, only render the content before the comment
+   */
+  summary: {
+    type: Boolean as PropType<boolean>,
+    default: false,
+  },
+
+  /**
+   * If caret is true, a caret will be appended to the document's last text node
+   */
+  caret: {
+    type: [Boolean, Object] as PropType<boolean | { class: string }>,
+    default: false,
+  },
+
+  /**
+   * Additional data to pass to the renderer
+   */
+  data: {
+    type: Object as PropType<Record<string, unknown>>,
+    default: () => ({}),
+  },
+
+  /**
+   * Document key used to subscribe to live updates via `globalThis.comarkContext`
+   */
+  documentKey: {
+    type: String as PropType<string>,
+    default: undefined,
+  },
+} as const
+
 /**
  * Markdown component
  *
@@ -107,100 +222,7 @@ type MarkdownComponent = ReturnType<typeof defineComponent<MarkdownProps>>
 export const Markdown: MarkdownComponent = defineComponent({
   name: 'Markdown',
 
-  props: {
-    /**
-     * The markdown content to parse and render, or a pre-parsed MarkdownDocument
-     */
-    value: {
-      type: [String, Object] as PropType<string | MarkdownDocumentType>,
-      default: undefined,
-    },
-
-    /**
-     * Parser options
-     */
-    options: {
-      type: Object as PropType<Exclude<ParserOptions, 'plugins'>>,
-      default: () => ({}),
-    },
-
-    /**
-     * Additional plugins to use
-     */
-    plugins: {
-      type: Array as PropType<ParserOptions['plugins']>,
-      default: () => [],
-    },
-
-    /**
-     * Parser to use instead of one resolved from `options` and `plugins`
-     */
-    parser: {
-      type: Function as PropType<ComarkParseFn>,
-      default: undefined,
-    },
-
-    /**
-     * Strip wrapper tags from the top level of the document — shorthand for
-     * `options.unwrap`. `true` unwraps `<p>`; a space-separated string or array
-     * unwraps the listed tags.
-     */
-    unwrap: {
-      type: [Boolean, String, Array] as PropType<boolean | string | string[]>,
-      default: false,
-    },
-
-    /**
-     * Custom component mappings for element tags
-     * Key: tag name (e.g., 'h1', 'p', 'MyComponent')
-     * Value: Vue component
-     */
-    components: {
-      type: Object as PropType<Record<string, any>>,
-      default: () => ({}),
-    },
-
-    /**
-     * Dynamic component resolver function
-     * Used to resolve components that aren't in the components map
-     */
-    componentsManifest: {
-      type: Function as PropType<ComponentManifest>,
-      default: undefined,
-    },
-
-    /**
-     * Enable streaming mode with stream-specific components
-     */
-    streaming: {
-      type: Boolean as PropType<boolean>,
-      default: false,
-    },
-
-    /**
-     * If document has a <!-- more --> comment, only render the content before the comment
-     */
-    summary: {
-      type: Boolean as PropType<boolean>,
-      default: false,
-    },
-
-    /**
-     * If caret is true, a caret will be appended to the document's last text node
-     */
-    caret: {
-      type: [Boolean, Object] as PropType<boolean | { class: string }>,
-      default: false,
-    },
-
-    /**
-     * Additional data to pass to the renderer
-     */
-    data: {
-      type: Object as PropType<Record<string, unknown>>,
-      default: () => ({}),
-    },
-  },
+  props: markdownProps,
 
   async setup(props, ctx) {
     const markdown = computed(() => {
@@ -269,6 +291,7 @@ export const Markdown: MarkdownComponent = defineComponent({
           class: props.streaming ? 'comark-stream' : '',
           caret: props.caret,
           data: props.data,
+          documentKey: props.documentKey,
         })
       }
 
@@ -281,6 +304,7 @@ export const Markdown: MarkdownComponent = defineComponent({
         class: props.streaming ? 'comark-stream' : '',
         caret: props.caret,
         data: props.data,
+        documentKey: props.documentKey,
       })
     }
   },