@mieweb/ui 0.10.0-dev.4 → 0.10.0-dev.41

package/dist/kerebron.cjs

@@ -6,37 +6,65 @@ var react = require('react');
 var editor = require('@kerebron/editor');
 var web = require('@kerebron/wasm/web');
 var AdvancedEditorKit = require('@kerebron/editor-kits/AdvancedEditorKit');
+var ExtensionMediaUpload = require('@kerebron/extension-basic-editor/ExtensionMediaUpload');
 var jsxRuntime = require('react/jsx-runtime');
 var CodeEditorKit = require('@kerebron/editor-kits/CodeEditorKit');
 
 var unsafeExtensions = ["autocomplete", "hover"];
 var SafeAdvancedEditorKit = class {
-  constructor(forCollab) {
+  constructor(forCollab, mediaUpload) {
     this.forCollab = forCollab;
+    this.mediaUpload = mediaUpload;
   }
   forCollab;
+  mediaUpload;
   name = "advanced-editor";
   getExtensions() {
     const dropped = [...unsafeExtensions];
     if (this.forCollab) dropped.push("history");
-    return new AdvancedEditorKit.AdvancedEditorKit().getExtensions().filter(
+    if (this.mediaUpload) dropped.push("mediaUpload");
+    const extensions = new AdvancedEditorKit.AdvancedEditorKit().getExtensions().filter(
       (extension) => !("name" in extension && dropped.includes(extension.name))
     );
+    if (this.mediaUpload) {
+      extensions.push(new ExtensionMediaUpload.ExtensionMediaUpload(this.mediaUpload));
+    }
+    return extensions;
   }
 };
-async function createEditorKits(config) {
-  if (!config) return [new SafeAdvancedEditorKit(false)];
-  const { HuddleYjsKit, defaultWsUrl } = await import('./collabKit-GCRHP25F.cjs');
-  const url = config.wsUrl ?? defaultWsUrl();
-  return [
-    new SafeAdvancedEditorKit(true),
-    new HuddleYjsKit(
-      url,
-      config.params ?? {},
-      config.WebSocketPolyfill,
-      config.user
-    )
-  ];
+async function createEditorKits(config, mediaUpload) {
+  if (!config) {
+    return {
+      kits: [new SafeAdvancedEditorKit(false, mediaUpload)],
+      collaborative: false
+    };
+  }
+  try {
+    const { HuddleYjsKit, defaultWsUrl } = await import('./collabKit-GCRHP25F.cjs');
+    const url = config.wsUrl ?? defaultWsUrl();
+    return {
+      kits: [
+        new SafeAdvancedEditorKit(true, mediaUpload),
+        new HuddleYjsKit(
+          url,
+          config.params ?? {},
+          config.WebSocketPolyfill,
+          config.user
+        )
+      ],
+      collaborative: true
+    };
+  } catch (error) {
+    console.warn(
+      "[RichEditor] Collaborative editing unavailable \u2014 the Yjs kit failed to load. Continuing as a local editor.",
+      error
+    );
+    config.onUnavailable?.(error);
+    return {
+      kits: [new SafeAdvancedEditorKit(false, mediaUpload)],
+      collaborative: false
+    };
+  }
 }
 var MARKDOWN_TYPE = "text/x-markdown";
 var initialLoadQueue = Promise.resolve();
@@ -56,7 +84,8 @@ var RichEditor = react.forwardRef(
     className,
     "aria-label": ariaLabel,
     "aria-labelledby": ariaLabelledBy,
-    assetLoad
+    assetLoad,
+    mediaUpload
   }, ref) {
     const isDark = chunkNMBYU7D7_cjs.useIsDarkMode();
     const hostRef = react.useRef(null);
@@ -68,6 +97,9 @@ var RichEditor = react.forwardRef(
     const loadingRef = react.useRef(false);
     const disabledRef = react.useRef(disabled);
     const [md, setMd] = react.useState("");
+    const lastSerializedDoc = react.useRef(null);
+    const showPreviewRef = react.useRef(showPreview);
+    showPreviewRef.current = showPreview;
     react.useEffect(() => {
       disabledRef.current = disabled;
       editorInstance.current?.view.setProps({
@@ -93,19 +125,26 @@ var RichEditor = react.forwardRef(
       host.appendChild(mount);
       const onTransaction = async () => {
         if (loadingRef.current || !editorInstance.current) return;
+        const { doc } = editorInstance.current.view.state;
+        if (doc === lastSerializedDoc.current) return;
+        lastSerializedDoc.current = doc;
         try {
           const buffer = await editorInstance.current.saveDocument(MARKDOWN_TYPE);
           const markdown = new globalThis.TextDecoder().decode(buffer);
           if (disposed) return;
           valueRef.current = markdown;
-          setMd(markdown);
+          if (showPreviewRef.current) setMd(markdown);
           onChangeRef.current?.(markdown);
         } catch (err) {
+          lastSerializedDoc.current = null;
           console.error("Failed to save markdown:", err);
         }
       };
       const setup = async () => {
-        const editorKits = await createEditorKits(collab);
+        const { kits: editorKits, collaborative } = await createEditorKits(
+          collab,
+          mediaUpload
+        );
         if (disposed) return;
         editor$1 = editor.CoreEditor.create({
           element: mount,
@@ -127,7 +166,7 @@ var RichEditor = react.forwardRef(
         });
         editor$1.addEventListener("transaction", onTransaction);
         const joinRoom = () => {
-          if (collab && editor$1 && !disposed) {
+          if (collaborative && collab && editor$1 && !disposed) {
             editor$1.run.changeRoom?.(collab.room);
             reseedWhenRoomStaysEmpty();
           }

package/dist/kerebron.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/RichEditor/editorKits.ts","../src/components/RichEditor/RichEditor.tsx","../src/components/RichEditor/CodeEditor.tsx"],"names":["AdvancedEditorKit","forwardRef","RichEditor","useIsDarkMode","useRef","useState","useEffect","editor","CoreEditor","createAssetLoad","useImperativeHandle","jsx","jsxs","CodeEditorKit"],"mappings":"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","file":"kerebron.cjs","sourcesContent":["/**\n * Editor kit assembly for {@link RichEditor}, for both plain and collaborative\n * (Yjs) mode.\n *\n * Both modes start from {@link AdvancedEditorKit} and drop the extensions that\n * are unsafe for our usage — see {@link unsafeExtensions} — then collaborative\n * mode adds the Yjs pieces on top.\n *\n * The Yjs pieces live in `collabKit.ts` behind a dynamic `import()`, so\n * `@kerebron/extension-yjs`, `yjs` and `y-protocols` remain truly optional\n * peers — plain-mode consumers never load them.\n */\nimport type { EditorKit } from '@kerebron/editor';\nimport { AdvancedEditorKit } from '@kerebron/editor-kits/AdvancedEditorKit';\n\nexport interface CollabConfig {\n  /** Room id — one shared document per room (e.g. a post id). */\n  room: string;\n  /**\n   * WebSocket base URL for the Yjs relay. Defaults to\n   * `<ws|wss>://<location.host>/yjs`. The room id is appended by the provider.\n   */\n  wsUrl?: string;\n  /** Extra query params for the socket (e.g. `{ token }` for auth). */\n  params?: Record<string, string>;\n  /**\n   * Who this editor is, published on awareness (`kerebron:user`) so peers see\n   * a named, coloured cursor. Without it remote cursors do not render — the\n   * position plugin skips awareness states that carry no user — and the\n   * `id` is what the cursor colour is derived from (kerebron's `User` shape).\n   */\n  user?: { id: string; name: string; color?: string };\n  /**\n   * Custom WebSocket implementation handed to the Yjs provider — e.g. a\n   * loopback socket for demos/tests, or a polyfill outside the browser.\n   * Defaults to `globalThis.WebSocket`.\n   */\n  WebSocketPolyfill?: typeof globalThis.WebSocket;\n}\n\n/**\n * Extensions dropped from {@link AdvancedEditorKit}, and why.\n *\n * `autocomplete` and `hover` debounce their DOM handlers (200ms) and then call\n * `dispatchMeta`, which reads `this.editor.state` with no guard that the editor\n * is still alive. Any teardown or document swap inside that debounce window\n * lands the deferred call on a dead view and throws\n * `null.matchesNode()` inside ProseMirror's `EditorView.updateStateInner`,\n * leaving the view permanently broken. Two ways to hit it:\n *   - remount (e.g. a `key` change) while the pointer is over the editor, which\n *     fires the debounced `onMouseLeave` after the view is destroyed;\n *   - a Yjs remote update replacing the document tree under a pending callback.\n * The first applies to *every* editor, so both extensions come out in both\n * modes. No functional cost — autocomplete popups and node-hover tooltips are\n * compositor conveniences, not required for editing.\n *\n * `history` is collab-only: ExtensionYjs supplies its own CRDT-aware undo/redo\n * and the editor throws `Extension conflict: yjs vs history` if both are\n * present. Plain mode keeps it, so undo/redo still works there.\n */\nconst unsafeExtensions = ['autocomplete', 'hover'] as const;\n\n/** {@link AdvancedEditorKit} minus {@link unsafeExtensions} (and, for collab\n * mode, minus `history`). */\nclass SafeAdvancedEditorKit implements EditorKit {\n  name = 'advanced-editor';\n  constructor(private readonly forCollab: boolean) {}\n\n  getExtensions() {\n    const dropped: string[] = [...unsafeExtensions];\n    if (this.forCollab) dropped.push('history');\n\n    return new AdvancedEditorKit()\n      .getExtensions()\n      .filter(\n        (extension) =>\n          !('name' in extension && dropped.includes(extension.name))\n      );\n  }\n}\n\n/** MarkYChange + ExtensionYjs live in `collabKit.ts` (lazy-loaded). */\n\n/**\n * Build the editor kits for a session. Pass `config` to join a collaborative\n * room; omit it for a plain local editor.\n *\n * Async because collaborative mode lazy-loads the Yjs kit (and its optional\n * peer deps) on first use; plain mode resolves immediately.\n */\nexport async function createEditorKits(\n  config?: CollabConfig\n): Promise<EditorKit[]> {\n  if (!config) return [new SafeAdvancedEditorKit(false)];\n\n  const { HuddleYjsKit, defaultWsUrl } = await import('./collabKit');\n  const url = config.wsUrl ?? defaultWsUrl();\n  return [\n    new SafeAdvancedEditorKit(true),\n    new HuddleYjsKit(\n      url,\n      config.params ?? {},\n      config.WebSocketPolyfill,\n      config.user\n    ),\n  ];\n}\n","'use client';\n\nimport {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\n\nimport { CoreEditor, type AssetLoad } from '@kerebron/editor';\nimport { createAssetLoad } from '@kerebron/wasm/web';\n\nimport { useIsDarkMode } from '../../hooks/useIsDarkMode';\nimport { createEditorKits, type CollabConfig } from './editorKits';\n\nexport type { CollabConfig } from './editorKits';\n\nconst MARKDOWN_TYPE = 'text/x-markdown';\n\n/**\n * The markdown converter's tree-sitter WASM init is not concurrency-safe, so\n * every editor's *first* load queues behind the previous one. Later loads (a\n * `value` change) are free — by then the grammars are warm.\n */\nlet initialLoadQueue: Promise<unknown> = Promise.resolve();\n\nfunction queueInitialLoad(load: () => Promise<void>): Promise<void> {\n  const queued = initialLoadQueue.catch(() => undefined).then(load);\n  initialLoadQueue = queued.catch(() => undefined);\n  return queued;\n}\n\nexport interface RichEditorProps {\n  /** Markdown to load. Changing it reloads the editor unless `collab` is set. */\n  value?: string;\n  /** Called with the editor's markdown content whenever it changes. */\n  onChange?: (value: string) => void;\n  /** Whether to render the live markdown output preview. Defaults to `false`. */\n  showPreview?: boolean;\n  /**\n   * Enable live collaborative editing (Yjs) for the given room. When set, the\n   * editor connects to the `/yjs` websocket relay and every peer in the same\n   * `room` co-edits one shared document. Uncontrolled like `value` — remount via\n   * `key` to switch rooms.\n   */\n  collab?: CollabConfig;\n  /** Read-only surface: no typing, and the content dims. */\n  disabled?: boolean;\n  /**\n   * Id for the editor host element — an `aria-labelledby`/`aria-describedby`\n   * anchor. The host is a `div`, not a labelable control, so a\n   * `<label htmlFor>` will not associate; name the editor with `aria-label`\n   * or `aria-labelledby` instead.\n   */\n  id?: string;\n  /** Extra classes on the editor surface, beside `kb-component`. */\n  className?: string;\n  'aria-label'?: string;\n  'aria-labelledby'?: string;\n  /**\n   * Where the tree-sitter WASM grammars load from. Defaults to\n   * `createAssetLoad('/kerebron-wasm')`; supply your own when the host serves\n   * `@kerebron/wasm`'s `assets/` somewhere else.\n   */\n  assetLoad?: AssetLoad;\n}\n\nexport interface RichEditorHandle {\n  /**\n   * The editor's markdown, awaiting the initial load. `onChange` can lag the\n   * last keystroke, so read this on submit rather than trusting mirrored state.\n   */\n  getContent: () => Promise<string>;\n  /** Focus the editor, restoring the caret where the writer left it. */\n  focus: () => void;\n}\n\n/**\n * Markdown editor over Kerebron's `CoreEditor`.\n *\n * The editor mounts into a **disposable child div**: `CoreEditor.destroy()`\n * replaces its host element with a clone, which would strand React's ref (and,\n * under StrictMode's double-mount, leave the live editor detached behind a\n * dead clone).\n */\nconst RichEditor = forwardRef<RichEditorHandle, RichEditorProps>(\n  function RichEditor(\n    {\n      value = '',\n      onChange,\n      showPreview = false,\n      collab,\n      disabled = false,\n      id,\n      className,\n      'aria-label': ariaLabel,\n      'aria-labelledby': ariaLabelledBy,\n      assetLoad,\n    },\n    ref\n  ) {\n    const isDark = useIsDarkMode();\n    const hostRef = useRef<HTMLDivElement>(null);\n    const editorInstance = useRef<CoreEditor | null>(null);\n    const onChangeRef = useRef(onChange);\n    onChangeRef.current = onChange;\n    // Mirrors what the editor last held, so an echo of our own `onChange`\n    // doesn't reload the document out from under the caret.\n    const valueRef = useRef(value);\n    const readyRef = useRef<Promise<void> | null>(null);\n    const loadingRef = useRef(false);\n    const disabledRef = useRef(disabled);\n\n    const [md, setMd] = useState<string>('');\n\n    useEffect(() => {\n      disabledRef.current = disabled;\n      editorInstance.current?.view.setProps({\n        editable: () => !disabledRef.current,\n      });\n    }, [disabled]);\n\n    useEffect(() => {\n      // In collab mode the CRDT owns the content; reloading would fight it.\n      if (collab || value === valueRef.current) return;\n      valueRef.current = value;\n      const editor = editorInstance.current;\n      if (!editor) return;\n\n      loadingRef.current = true;\n      void editor\n        .loadDocumentText(MARKDOWN_TYPE, value)\n        .catch(() => undefined)\n        .finally(() => {\n          if (editorInstance.current === editor) loadingRef.current = false;\n        });\n      // `collab` is fixed for the lifetime of the instance.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [value]);\n\n    useEffect(() => {\n      if (!hostRef.current) return;\n      const host = hostRef.current;\n\n      // Set on cleanup so async continuations (kit loading and the\n      // `loadDocumentText` chain) don't touch the editor after `destroy()`.\n      let disposed = false;\n      let editor: CoreEditor | null = null;\n\n      const mount = document.createElement('div');\n      host.appendChild(mount);\n\n      // Listen to transactions and update markdown preview\n      const onTransaction = async () => {\n        // Programmatic loads are not edits — reporting them would echo the\n        // caller's own `value` back through `onChange`.\n        if (loadingRef.current || !editorInstance.current) return;\n\n        try {\n          const buffer =\n            await editorInstance.current.saveDocument(MARKDOWN_TYPE);\n          const markdown = new globalThis.TextDecoder().decode(buffer);\n          if (disposed) return;\n          valueRef.current = markdown;\n          setMd(markdown);\n          onChangeRef.current?.(markdown);\n        } catch (err) {\n          console.error('Failed to save markdown:', err);\n        }\n      };\n\n      // Initialize the editor. Both modes drop the teardown-unsafe extensions;\n      // collaborative mode additionally swaps `history` for the Yjs CRDT sync\n      // and lazy-loads the Yjs kit (see `editorKits.ts` for why).\n      const setup = async () => {\n        const editorKits = await createEditorKits(collab);\n        if (disposed) return;\n\n        editor = CoreEditor.create({\n          element: mount,\n          uri: 'file:///untitled.md',\n          assetLoad: assetLoad ?? createAssetLoad('/kerebron-wasm'),\n          editorKits,\n          readOnly: disabledRef.current,\n        });\n\n        editorInstance.current = editor;\n        // The contenteditable surface has no implicit ARIA role, so labeling\n        // attributes are only permitted alongside an explicit textbox role.\n        const surfaceAttributes =\n          ariaLabel || ariaLabelledBy\n            ? {\n                role: 'textbox',\n                'aria-multiline': 'true',\n                ...(ariaLabel ? { 'aria-label': ariaLabel } : {}),\n                ...(ariaLabelledBy\n                  ? { 'aria-labelledby': ariaLabelledBy }\n                  : {}),\n              }\n            : null;\n        editor.view.setProps({\n          editable: () => !disabledRef.current,\n          ...(surfaceAttributes ? { attributes: surfaceAttributes } : {}),\n        });\n        editor.addEventListener('transaction', onTransaction);\n\n        // Seed initial content, then populate the preview once on mount.\n        //\n        // In collaborative mode we still load the local markdown first, then\n        // join the room: the Yjs binding seeds an *empty* shared document from\n        // this content on the first join, and overwrites the editor with the\n        // shared content when the room already has edits — so the stored\n        // markdown is the starting point without ever double-inserting.\n        const joinRoom = () => {\n          if (collab && editor && !disposed) {\n            (\n              editor.run as Record<string, (...args: unknown[]) => boolean>\n            ).changeRoom?.(collab.room);\n            reseedWhenRoomStaysEmpty();\n          }\n        };\n\n        // The Yjs binding is supposed to seed an empty room from the local\n        // content, but the sync import can land as an overwrite that blanks\n        // the just-loaded seed (observed with extension-yjs 0.8.x). Heal it:\n        // once the join settles, an empty document with a non-empty seed\n        // means nobody's content won — reload the seed, which the binding\n        // then pushes into the room. Joiners pass no value, so exactly one\n        // participant ever does this.\n        const seed = valueRef.current;\n        const reseedWhenRoomStaysEmpty = () => {\n          if (!seed) return;\n          const check = async (attempt: number) => {\n            if (disposed || !editorInstance.current) return;\n            try {\n              const buffer =\n                await editorInstance.current.saveDocument(MARKDOWN_TYPE);\n              const current = new globalThis.TextDecoder()\n                .decode(buffer)\n                .trim();\n              if (disposed || !editorInstance.current) return;\n              if (current) return; // somebody's content arrived — done\n              if (attempt >= 2) {\n                await editorInstance.current.loadDocumentText(\n                  MARKDOWN_TYPE,\n                  seed\n                );\n                return;\n              }\n              setTimeout(() => void check(attempt + 1), 300);\n            } catch {\n              // A failed probe must not break the editor; the room stays as-is.\n            }\n          };\n          setTimeout(() => void check(0), 300);\n        };\n\n        if (valueRef.current) {\n          await queueInitialLoad(() =>\n            editor!.loadDocumentText(MARKDOWN_TYPE, valueRef.current)\n          );\n          await onTransaction();\n          joinRoom();\n        } else {\n          void onTransaction();\n          joinRoom();\n        }\n      };\n\n      readyRef.current = setup().catch((err) =>\n        console.error('Failed to set up editor:', err)\n      );\n\n      // Cleanup on unmount\n      return () => {\n        disposed = true;\n        editorInstance.current = null; // makes onTransaction's guard effective\n        editor?.removeEventListener('transaction', onTransaction);\n        editor?.destroy();\n        readyRef.current = null;\n        host.replaceChildren();\n      };\n      // Initial `value`/`collab` are intentionally only applied on mount\n      // (uncontrolled). Remount via `key` to switch rooms.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    useImperativeHandle(\n      ref,\n      () => ({\n        getContent: async (): Promise<string> => {\n          await readyRef.current;\n          const editor = editorInstance.current;\n          if (!editor) return valueRef.current;\n          const buffer = await editor.saveDocument(MARKDOWN_TYPE);\n          const markdown = new globalThis.TextDecoder().decode(buffer);\n          valueRef.current = markdown;\n          return markdown;\n        },\n        focus: (): void => {\n          const apply = (): void => {\n            const view = editorInstance.current?.view as\n              | { focus?: () => void }\n              | undefined;\n            if (view?.focus) {\n              view.focus();\n              return;\n            }\n            hostRef.current\n              ?.querySelector<HTMLElement>('[contenteditable=\"true\"], textarea')\n              ?.focus();\n          };\n          // Callers focus on mount; the editor may still be loading its kits.\n          if (editorInstance.current) apply();\n          else void readyRef.current?.then(apply);\n        },\n      }),\n      []\n    );\n\n    return (\n      <div>\n        <div>\n          <div\n            ref={hostRef}\n            id={id}\n            className={[\n              'kb-component',\n              isDark ? 'kb-component--dark' : '',\n              className ?? '',\n            ]\n              .filter(Boolean)\n              .join(' ')}\n            aria-label={ariaLabel}\n            aria-labelledby={ariaLabelledBy}\n            aria-disabled={disabled || undefined}\n            style={{\n              isolation: 'isolate',\n              opacity: disabled ? 0.65 : undefined,\n              pointerEvents: disabled ? 'none' : undefined,\n            }}\n          />\n        </div>\n\n        {showPreview && (\n          <div>\n            <div>\n              <h5>Markdown Output</h5>\n              <pre>{md}</pre>\n            </div>\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nRichEditor.displayName = 'RichEditor';\n\nexport { RichEditor };\n","import React, { useEffect, useRef } from 'react';\n\nimport { CoreEditor } from '@kerebron/editor';\nimport { CodeEditorKit } from '@kerebron/editor-kits/CodeEditorKit';\nimport { createAssetLoad } from '@kerebron/wasm/web';\n\nexport interface CodeEditorProps {\n  /** Initial source code to load into the editor. */\n  value?: string;\n  /** Called with the editor's contents whenever they change. */\n  onChange?: (value: string) => void;\n  /** Language/grammar to use for syntax highlighting. Defaults to `typescript`. */\n  lang?: string;\n}\n\nconst CodeEditor: React.FC<CodeEditorProps> = ({\n  value = '',\n  onChange,\n  lang = 'typescript',\n}) => {\n  const editorRef = useRef<HTMLDivElement>(null);\n  const editorInstance = useRef<CoreEditor | null>(null);\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  useEffect(() => {\n    const root = editorRef.current;\n    if (!root) return;\n\n    const applySelectLabel = () => {\n      root.querySelectorAll('select.codejar-select').forEach((element) => {\n        if (!element.getAttribute('aria-label')) {\n          element.setAttribute('aria-label', 'Code editor language');\n        }\n      });\n    };\n\n    applySelectLabel();\n    const observer = new MutationObserver(() => applySelectLabel());\n    observer.observe(root, { childList: true, subtree: true });\n    return () => observer.disconnect();\n  }, []);\n\n  useEffect(() => {\n    if (!editorRef.current) return;\n\n    // Initialize the editor\n    const editor = CoreEditor.create({\n      element: editorRef.current,\n      uri: 'file:///untitled.ts',\n      assetLoad: createAssetLoad('/kerebron-wasm'),\n      editorKits: [new CodeEditorKit(lang)],\n    });\n\n    editorInstance.current = editor;\n\n    // Surface edits to callers.\n    const onTransaction = async () => {\n      if (!editorInstance.current) return;\n\n      try {\n        const buffer = await editorInstance.current.saveDocument('text/plain');\n        onChangeRef.current?.(new globalThis.TextDecoder().decode(buffer));\n      } catch (err) {\n        console.error('Failed to read code:', err);\n      }\n    };\n\n    editor.addEventListener('transaction', onTransaction);\n\n    // Seed initial content on mount.\n    if (value) {\n      editor\n        .loadDocumentText('text/plain', value)\n        .catch((err) => console.error('Failed to load code:', err));\n    }\n\n    // Cleanup on unmount\n    return () => {\n      editor.removeEventListener('transaction', onTransaction);\n      editor.destroy();\n    };\n    // Initial `value`/`lang` are intentionally only applied on mount.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return (\n    <div>\n      <div>\n        <div ref={editorRef} className=\"kb-component\" />\n      </div>\n    </div>\n  );\n};\n\nCodeEditor.displayName = 'CodeEditor';\n\nexport { CodeEditor };\n"]}
+{"version":3,"sources":["../src/components/RichEditor/editorKits.ts","../src/components/RichEditor/RichEditor.tsx","../src/components/RichEditor/CodeEditor.tsx"],"names":["AdvancedEditorKit","ExtensionMediaUpload","forwardRef","RichEditor","useIsDarkMode","useRef","useState","useEffect","editor","CoreEditor","createAssetLoad","useImperativeHandle","jsx","jsxs","CodeEditorKit"],"mappings":"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","file":"kerebron.cjs","sourcesContent":["/**\n * Editor kit assembly for {@link RichEditor}, for both plain and collaborative\n * (Yjs) mode.\n *\n * Both modes start from {@link AdvancedEditorKit} and drop the extensions that\n * are unsafe for our usage — see {@link unsafeExtensions} — then collaborative\n * mode adds the Yjs pieces on top.\n *\n * The Yjs pieces live in `collabKit.ts` behind a dynamic `import()`, so\n * `@kerebron/extension-yjs`, `yjs` and `y-protocols` remain truly optional\n * peers — plain-mode consumers never load them.\n */\nimport type { EditorKit } from '@kerebron/editor';\nimport { AdvancedEditorKit } from '@kerebron/editor-kits/AdvancedEditorKit';\nimport {\n  ExtensionMediaUpload,\n  type MediaUploadOptions,\n} from '@kerebron/extension-basic-editor/ExtensionMediaUpload';\n\nexport type { MediaUploadOptions };\n\nexport interface CollabConfig {\n  /** Room id — one shared document per room (e.g. a post id). */\n  room: string;\n  /**\n   * WebSocket base URL for the Yjs relay. Defaults to\n   * `<ws|wss>://<location.host>/yjs`. The room id is appended by the provider.\n   */\n  wsUrl?: string;\n  /** Extra query params for the socket (e.g. `{ token }` for auth). */\n  params?: Record<string, string>;\n  /**\n   * Who this editor is, published on awareness (`kerebron:user`) so peers see\n   * a named, coloured cursor. Without it remote cursors do not render — the\n   * position plugin skips awareness states that carry no user — and the\n   * `id` is what the cursor colour is derived from (kerebron's `User` shape).\n   */\n  user?: { id: string; name: string; color?: string };\n  /**\n   * Custom WebSocket implementation handed to the Yjs provider — e.g. a\n   * loopback socket for demos/tests, or a polyfill outside the browser.\n   * Defaults to `globalThis.WebSocket`.\n   */\n  WebSocketPolyfill?: typeof globalThis.WebSocket;\n  /**\n   * Called when collaborative editing could not be started at all — the Yjs\n   * kit failed to load (see {@link createEditorKits}). The editor mounts\n   * anyway, as a local one; this is how the host finds out that edits are no\n   * longer shared, so it can say so, or tear its own editor down if unshared\n   * editing would be unsafe.\n   *\n   * Not for connection trouble: a room that is reachable but currently\n   * disconnected still has the Yjs kit loaded, and the provider retries on its\n   * own. This fires once, before the editor is created.\n   */\n  onUnavailable?: (error: unknown) => void;\n}\n\n/** What {@link createEditorKits} resolves to. */\nexport interface EditorKits {\n  kits: EditorKit[];\n  /**\n   * Whether the returned kits can actually collaborate. False when `config`\n   * asked for a room but the Yjs kit could not be loaded, so callers know not\n   * to join one.\n   */\n  collaborative: boolean;\n}\n\n/**\n * Extensions dropped from {@link AdvancedEditorKit}, and why.\n *\n * `autocomplete` and `hover` debounce their DOM handlers (200ms) and then call\n * `dispatchMeta`, which reads `this.editor.state` with no guard that the editor\n * is still alive. Any teardown or document swap inside that debounce window\n * lands the deferred call on a dead view and throws\n * `null.matchesNode()` inside ProseMirror's `EditorView.updateStateInner`,\n * leaving the view permanently broken. Two ways to hit it:\n *   - remount (e.g. a `key` change) while the pointer is over the editor, which\n *     fires the debounced `onMouseLeave` after the view is destroyed;\n *   - a Yjs remote update replacing the document tree under a pending callback.\n * The first applies to *every* editor, so both extensions come out in both\n * modes. No functional cost — autocomplete popups and node-hover tooltips are\n * compositor conveniences, not required for editing.\n *\n * `history` is collab-only: ExtensionYjs supplies its own CRDT-aware undo/redo\n * and the editor throws `Extension conflict: yjs vs history` if both are\n * present. Plain mode keeps it, so undo/redo still works there.\n */\nconst unsafeExtensions = ['autocomplete', 'hover'] as const;\n\n/**\n * {@link AdvancedEditorKit} minus {@link unsafeExtensions} (and, for collab\n * mode, minus `history`), with `mediaUpload` reconfigured when the host asks.\n *\n * `AdvancedEditorKit` constructs `ExtensionMediaUpload` with no options, and an\n * extension's options are fixed at construction — so the only way to configure\n * it is to drop that instance and append one of our own.\n */\nclass SafeAdvancedEditorKit implements EditorKit {\n  name = 'advanced-editor';\n  constructor(\n    private readonly forCollab: boolean,\n    private readonly mediaUpload?: MediaUploadOptions\n  ) {}\n\n  getExtensions() {\n    const dropped: string[] = [...unsafeExtensions];\n    if (this.forCollab) dropped.push('history');\n    if (this.mediaUpload) dropped.push('mediaUpload');\n\n    const extensions = new AdvancedEditorKit()\n      .getExtensions()\n      .filter(\n        (extension) =>\n          !('name' in extension && dropped.includes(extension.name))\n      );\n\n    if (this.mediaUpload) {\n      extensions.push(new ExtensionMediaUpload(this.mediaUpload));\n    }\n    return extensions;\n  }\n}\n\n/** MarkYChange + ExtensionYjs live in `collabKit.ts` (lazy-loaded). */\n\n/**\n * Build the editor kits for a session. Pass `config` to join a collaborative\n * room; omit it for a plain local editor. Pass `mediaUpload` to configure how\n * pasted/dropped files are handled — most importantly `uploadHandler`, without\n * which every image is embedded in the document as a base64 `data:` URL.\n *\n * Async because collaborative mode lazy-loads the Yjs kit (and its optional\n * peer deps) on first use; plain mode resolves immediately.\n *\n * That lazy load is allowed to fail. `@kerebron/extension-yjs`, `yjs` and\n * `y-protocols` are optional peers, so the chunk can be absent (peers never\n * installed), stale (a dev server's dependency hash moved under a running\n * page) or simply unreachable (a partial deploy, an offline client). None of\n * that is a reason to leave the caller without an editor: collaboration is an\n * enhancement, editing is the feature. So a failed load degrades to the local\n * kit and reports itself through {@link CollabConfig.onUnavailable} rather\n * than rejecting.\n */\nexport async function createEditorKits(\n  config?: CollabConfig,\n  mediaUpload?: MediaUploadOptions\n): Promise<EditorKits> {\n  if (!config) {\n    return {\n      kits: [new SafeAdvancedEditorKit(false, mediaUpload)],\n      collaborative: false,\n    };\n  }\n\n  try {\n    const { HuddleYjsKit, defaultWsUrl } = await import('./collabKit');\n    const url = config.wsUrl ?? defaultWsUrl();\n    return {\n      kits: [\n        new SafeAdvancedEditorKit(true, mediaUpload),\n        new HuddleYjsKit(\n          url,\n          config.params ?? {},\n          config.WebSocketPolyfill,\n          config.user\n        ),\n      ],\n      collaborative: true,\n    };\n  } catch (error) {\n    console.warn(\n      '[RichEditor] Collaborative editing unavailable — the Yjs kit failed to load. Continuing as a local editor.',\n      error\n    );\n    config.onUnavailable?.(error);\n    // Degrading to a local editor must not also drop `mediaUpload`: without it\n    // the stock extension comes back and pasted files are embedded as base64.\n    return {\n      kits: [new SafeAdvancedEditorKit(false, mediaUpload)],\n      collaborative: false,\n    };\n  }\n}\n","'use client';\n\nimport {\n  forwardRef,\n  useEffect,\n  useImperativeHandle,\n  useRef,\n  useState,\n} from 'react';\n\nimport { CoreEditor, type AssetLoad } from '@kerebron/editor';\nimport { createAssetLoad } from '@kerebron/wasm/web';\n\nimport { useIsDarkMode } from '../../hooks/useIsDarkMode';\nimport {\n  createEditorKits,\n  type CollabConfig,\n  type MediaUploadOptions,\n} from './editorKits';\n\nexport type { CollabConfig, MediaUploadOptions } from './editorKits';\n\nconst MARKDOWN_TYPE = 'text/x-markdown';\n\n/**\n * The markdown converter's tree-sitter WASM init is not concurrency-safe, so\n * every editor's *first* load queues behind the previous one. Later loads (a\n * `value` change) are free — by then the grammars are warm.\n */\nlet initialLoadQueue: Promise<unknown> = Promise.resolve();\n\nfunction queueInitialLoad(load: () => Promise<void>): Promise<void> {\n  const queued = initialLoadQueue.catch(() => undefined).then(load);\n  initialLoadQueue = queued.catch(() => undefined);\n  return queued;\n}\n\nexport interface RichEditorProps {\n  /** Markdown to load. Changing it reloads the editor unless `collab` is set. */\n  value?: string;\n  /** Called with the editor's markdown content whenever it changes. */\n  onChange?: (value: string) => void;\n  /** Whether to render the live markdown output preview. Defaults to `false`. */\n  showPreview?: boolean;\n  /**\n   * Enable live collaborative editing (Yjs) for the given room. When set, the\n   * editor connects to the `/yjs` websocket relay and every peer in the same\n   * `room` co-edits one shared document. Uncontrolled like `value` — remount via\n   * `key` to switch rooms.\n   *\n   * Best-effort: if the Yjs kit cannot be loaded the editor still mounts, as a\n   * local one, and `collab.onUnavailable` is called. Pass that callback if\n   * unshared editing is something your users need to be told about.\n   */\n  collab?: CollabConfig;\n  /** Read-only surface: no typing, and the content dims. */\n  disabled?: boolean;\n  /**\n   * Id for the editor host element — an `aria-labelledby`/`aria-describedby`\n   * anchor. The host is a `div`, not a labelable control, so a\n   * `<label htmlFor>` will not associate; name the editor with `aria-label`\n   * or `aria-labelledby` instead.\n   */\n  id?: string;\n  /** Extra classes on the editor surface, beside `kb-component`. */\n  className?: string;\n  'aria-label'?: string;\n  'aria-labelledby'?: string;\n  /**\n   * Where the tree-sitter WASM grammars load from. Defaults to\n   * `createAssetLoad('/kerebron-wasm')`; supply your own when the host serves\n   * `@kerebron/wasm`'s `assets/` somewhere else.\n   */\n  assetLoad?: AssetLoad;\n  /**\n   * How files pasted or dropped into the editor are handled.\n   *\n   * **Set `uploadHandler` if your documents are persisted anywhere.** Without\n   * it, a pasted image is embedded in the document as a base64 `data:` URL and\n   * a video as a blob object URL: a 4 MB screenshot becomes ~5.8 MB of\n   * markdown, which most APIs will refuse, and an object URL is dead as soon as\n   * the page reloads. `uploadHandler` receives the file and returns the URL to\n   * reference it by, so the document carries a link instead of the bytes.\n   *\n   * ```tsx\n   * <RichEditor\n   *   mediaUpload={{ uploadHandler: (file) => uploadToMyMediaStore(file) }}\n   * />\n   * ```\n   *\n   * Read once, when the editor mounts — like {@link collab}, remount via `key`\n   * to change it.\n   */\n  mediaUpload?: MediaUploadOptions;\n}\n\nexport interface RichEditorHandle {\n  /**\n   * The editor's markdown, awaiting the initial load. `onChange` can lag the\n   * last keystroke, so read this on submit rather than trusting mirrored state.\n   */\n  getContent: () => Promise<string>;\n  /** Focus the editor, restoring the caret where the writer left it. */\n  focus: () => void;\n}\n\n/**\n * Markdown editor over Kerebron's `CoreEditor`.\n *\n * The editor mounts into a **disposable child div**: `CoreEditor.destroy()`\n * replaces its host element with a clone, which would strand React's ref (and,\n * under StrictMode's double-mount, leave the live editor detached behind a\n * dead clone).\n */\nconst RichEditor = forwardRef<RichEditorHandle, RichEditorProps>(\n  function RichEditor(\n    {\n      value = '',\n      onChange,\n      showPreview = false,\n      collab,\n      disabled = false,\n      id,\n      className,\n      'aria-label': ariaLabel,\n      'aria-labelledby': ariaLabelledBy,\n      assetLoad,\n      mediaUpload,\n    },\n    ref\n  ) {\n    const isDark = useIsDarkMode();\n    const hostRef = useRef<HTMLDivElement>(null);\n    const editorInstance = useRef<CoreEditor | null>(null);\n    const onChangeRef = useRef(onChange);\n    onChangeRef.current = onChange;\n    // Mirrors what the editor last held, so an echo of our own `onChange`\n    // doesn't reload the document out from under the caret.\n    const valueRef = useRef(value);\n    const readyRef = useRef<Promise<void> | null>(null);\n    const loadingRef = useRef(false);\n    const disabledRef = useRef(disabled);\n\n    const [md, setMd] = useState<string>('');\n    // Serializing the document is the expensive part of a transaction, so the\n    // last doc that was serialized is kept to recognise the transactions that\n    // did not change it. ProseMirror documents are immutable, so identity is an\n    // exact test.\n    const lastSerializedDoc = useRef<unknown>(null);\n    // Read inside the transaction handler, which is created once on mount.\n    const showPreviewRef = useRef(showPreview);\n    showPreviewRef.current = showPreview;\n\n    useEffect(() => {\n      disabledRef.current = disabled;\n      editorInstance.current?.view.setProps({\n        editable: () => !disabledRef.current,\n      });\n    }, [disabled]);\n\n    useEffect(() => {\n      // In collab mode the CRDT owns the content; reloading would fight it.\n      if (collab || value === valueRef.current) return;\n      valueRef.current = value;\n      const editor = editorInstance.current;\n      if (!editor) return;\n\n      loadingRef.current = true;\n      void editor\n        .loadDocumentText(MARKDOWN_TYPE, value)\n        .catch(() => undefined)\n        .finally(() => {\n          if (editorInstance.current === editor) loadingRef.current = false;\n        });\n      // `collab` is fixed for the lifetime of the instance.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [value]);\n\n    useEffect(() => {\n      if (!hostRef.current) return;\n      const host = hostRef.current;\n\n      // Set on cleanup so async continuations (kit loading and the\n      // `loadDocumentText` chain) don't touch the editor after `destroy()`.\n      let disposed = false;\n      let editor: CoreEditor | null = null;\n\n      const mount = document.createElement('div');\n      host.appendChild(mount);\n\n      // Listen to transactions and update markdown preview\n      const onTransaction = async () => {\n        // Programmatic loads are not edits — reporting them would echo the\n        // caller's own `value` back through `onChange`.\n        if (loadingRef.current || !editorInstance.current) return;\n\n        // ProseMirror fires a transaction for every selection change too —\n        // arrow keys, clicks, a blur. Serializing the whole document to\n        // markdown for those costs a full tree-sitter pass and two React\n        // renders for a caret move, so only a changed document is re-read.\n        const { doc } = editorInstance.current.view.state;\n        if (doc === lastSerializedDoc.current) return;\n        lastSerializedDoc.current = doc;\n\n        try {\n          const buffer =\n            await editorInstance.current.saveDocument(MARKDOWN_TYPE);\n          const markdown = new globalThis.TextDecoder().decode(buffer);\n          if (disposed) return;\n          valueRef.current = markdown;\n          // `md` only feeds the preview pane; setting it with the preview off\n          // re-renders the editor on every keystroke for nothing.\n          if (showPreviewRef.current) setMd(markdown);\n          onChangeRef.current?.(markdown);\n        } catch (err) {\n          // The document was marked as serialized before the attempt, to keep\n          // selection-only transactions arriving mid-save from re-entering.\n          // A failure has to undo that, or this document is never retried.\n          lastSerializedDoc.current = null;\n          console.error('Failed to save markdown:', err);\n        }\n      };\n\n      // Initialize the editor. Both modes drop the teardown-unsafe extensions;\n      // collaborative mode additionally swaps `history` for the Yjs CRDT sync\n      // and lazy-loads the Yjs kit (see `editorKits.ts` for why).\n      const setup = async () => {\n        // `collaborative` is false when a room was asked for but the Yjs kit\n        // could not be loaded — the editor is still created, just a local one,\n        // so there is no room to join below.\n        const { kits: editorKits, collaborative } = await createEditorKits(\n          collab,\n          mediaUpload\n        );\n        if (disposed) return;\n\n        editor = CoreEditor.create({\n          element: mount,\n          uri: 'file:///untitled.md',\n          assetLoad: assetLoad ?? createAssetLoad('/kerebron-wasm'),\n          editorKits,\n          readOnly: disabledRef.current,\n        });\n\n        editorInstance.current = editor;\n        // The contenteditable surface has no implicit ARIA role, so labeling\n        // attributes are only permitted alongside an explicit textbox role.\n        const surfaceAttributes =\n          ariaLabel || ariaLabelledBy\n            ? {\n                role: 'textbox',\n                'aria-multiline': 'true',\n                ...(ariaLabel ? { 'aria-label': ariaLabel } : {}),\n                ...(ariaLabelledBy\n                  ? { 'aria-labelledby': ariaLabelledBy }\n                  : {}),\n              }\n            : null;\n        editor.view.setProps({\n          editable: () => !disabledRef.current,\n          ...(surfaceAttributes ? { attributes: surfaceAttributes } : {}),\n        });\n        editor.addEventListener('transaction', onTransaction);\n\n        // Seed initial content, then populate the preview once on mount.\n        //\n        // In collaborative mode we still load the local markdown first, then\n        // join the room: the Yjs binding seeds an *empty* shared document from\n        // this content on the first join, and overwrites the editor with the\n        // shared content when the room already has edits — so the stored\n        // markdown is the starting point without ever double-inserting.\n        const joinRoom = () => {\n          if (collaborative && collab && editor && !disposed) {\n            (\n              editor.run as Record<string, (...args: unknown[]) => boolean>\n            ).changeRoom?.(collab.room);\n            reseedWhenRoomStaysEmpty();\n          }\n        };\n\n        // The Yjs binding is supposed to seed an empty room from the local\n        // content, but the sync import can land as an overwrite that blanks\n        // the just-loaded seed (observed with extension-yjs 0.8.x). Heal it:\n        // once the join settles, an empty document with a non-empty seed\n        // means nobody's content won — reload the seed, which the binding\n        // then pushes into the room. Joiners pass no value, so exactly one\n        // participant ever does this.\n        const seed = valueRef.current;\n        const reseedWhenRoomStaysEmpty = () => {\n          if (!seed) return;\n          const check = async (attempt: number) => {\n            if (disposed || !editorInstance.current) return;\n            try {\n              const buffer =\n                await editorInstance.current.saveDocument(MARKDOWN_TYPE);\n              const current = new globalThis.TextDecoder()\n                .decode(buffer)\n                .trim();\n              if (disposed || !editorInstance.current) return;\n              if (current) return; // somebody's content arrived — done\n              if (attempt >= 2) {\n                await editorInstance.current.loadDocumentText(\n                  MARKDOWN_TYPE,\n                  seed\n                );\n                return;\n              }\n              setTimeout(() => void check(attempt + 1), 300);\n            } catch {\n              // A failed probe must not break the editor; the room stays as-is.\n            }\n          };\n          setTimeout(() => void check(0), 300);\n        };\n\n        if (valueRef.current) {\n          await queueInitialLoad(() =>\n            editor!.loadDocumentText(MARKDOWN_TYPE, valueRef.current)\n          );\n          await onTransaction();\n          joinRoom();\n        } else {\n          void onTransaction();\n          joinRoom();\n        }\n      };\n\n      readyRef.current = setup().catch((err) =>\n        console.error('Failed to set up editor:', err)\n      );\n\n      // Cleanup on unmount\n      return () => {\n        disposed = true;\n        editorInstance.current = null; // makes onTransaction's guard effective\n        editor?.removeEventListener('transaction', onTransaction);\n        editor?.destroy();\n        readyRef.current = null;\n        host.replaceChildren();\n      };\n      // Initial `value`/`collab` are intentionally only applied on mount\n      // (uncontrolled). Remount via `key` to switch rooms.\n      // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    useImperativeHandle(\n      ref,\n      () => ({\n        getContent: async (): Promise<string> => {\n          await readyRef.current;\n          const editor = editorInstance.current;\n          if (!editor) return valueRef.current;\n          const buffer = await editor.saveDocument(MARKDOWN_TYPE);\n          const markdown = new globalThis.TextDecoder().decode(buffer);\n          valueRef.current = markdown;\n          return markdown;\n        },\n        focus: (): void => {\n          const apply = (): void => {\n            const view = editorInstance.current?.view as\n              | { focus?: () => void }\n              | undefined;\n            if (view?.focus) {\n              view.focus();\n              return;\n            }\n            hostRef.current\n              ?.querySelector<HTMLElement>('[contenteditable=\"true\"], textarea')\n              ?.focus();\n          };\n          // Callers focus on mount; the editor may still be loading its kits.\n          if (editorInstance.current) apply();\n          else void readyRef.current?.then(apply);\n        },\n      }),\n      []\n    );\n\n    return (\n      <div>\n        <div>\n          <div\n            ref={hostRef}\n            id={id}\n            className={[\n              'kb-component',\n              isDark ? 'kb-component--dark' : '',\n              className ?? '',\n            ]\n              .filter(Boolean)\n              .join(' ')}\n            aria-label={ariaLabel}\n            aria-labelledby={ariaLabelledBy}\n            aria-disabled={disabled || undefined}\n            style={{\n              isolation: 'isolate',\n              opacity: disabled ? 0.65 : undefined,\n              pointerEvents: disabled ? 'none' : undefined,\n            }}\n          />\n        </div>\n\n        {showPreview && (\n          <div>\n            <div>\n              <h5>Markdown Output</h5>\n              <pre>{md}</pre>\n            </div>\n          </div>\n        )}\n      </div>\n    );\n  }\n);\n\nRichEditor.displayName = 'RichEditor';\n\nexport { RichEditor };\n","import React, { useEffect, useRef } from 'react';\n\nimport { CoreEditor } from '@kerebron/editor';\nimport { CodeEditorKit } from '@kerebron/editor-kits/CodeEditorKit';\nimport { createAssetLoad } from '@kerebron/wasm/web';\n\nexport interface CodeEditorProps {\n  /** Initial source code to load into the editor. */\n  value?: string;\n  /** Called with the editor's contents whenever they change. */\n  onChange?: (value: string) => void;\n  /** Language/grammar to use for syntax highlighting. Defaults to `typescript`. */\n  lang?: string;\n}\n\nconst CodeEditor: React.FC<CodeEditorProps> = ({\n  value = '',\n  onChange,\n  lang = 'typescript',\n}) => {\n  const editorRef = useRef<HTMLDivElement>(null);\n  const editorInstance = useRef<CoreEditor | null>(null);\n  const onChangeRef = useRef(onChange);\n  onChangeRef.current = onChange;\n\n  useEffect(() => {\n    const root = editorRef.current;\n    if (!root) return;\n\n    const applySelectLabel = () => {\n      root.querySelectorAll('select.codejar-select').forEach((element) => {\n        if (!element.getAttribute('aria-label')) {\n          element.setAttribute('aria-label', 'Code editor language');\n        }\n      });\n    };\n\n    applySelectLabel();\n    const observer = new MutationObserver(() => applySelectLabel());\n    observer.observe(root, { childList: true, subtree: true });\n    return () => observer.disconnect();\n  }, []);\n\n  useEffect(() => {\n    if (!editorRef.current) return;\n\n    // Initialize the editor\n    const editor = CoreEditor.create({\n      element: editorRef.current,\n      uri: 'file:///untitled.ts',\n      assetLoad: createAssetLoad('/kerebron-wasm'),\n      editorKits: [new CodeEditorKit(lang)],\n    });\n\n    editorInstance.current = editor;\n\n    // Surface edits to callers.\n    const onTransaction = async () => {\n      if (!editorInstance.current) return;\n\n      try {\n        const buffer = await editorInstance.current.saveDocument('text/plain');\n        onChangeRef.current?.(new globalThis.TextDecoder().decode(buffer));\n      } catch (err) {\n        console.error('Failed to read code:', err);\n      }\n    };\n\n    editor.addEventListener('transaction', onTransaction);\n\n    // Seed initial content on mount.\n    if (value) {\n      editor\n        .loadDocumentText('text/plain', value)\n        .catch((err) => console.error('Failed to load code:', err));\n    }\n\n    // Cleanup on unmount\n    return () => {\n      editor.removeEventListener('transaction', onTransaction);\n      editor.destroy();\n    };\n    // Initial `value`/`lang` are intentionally only applied on mount.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return (\n    <div>\n      <div>\n        <div ref={editorRef} className=\"kb-component\" />\n      </div>\n    </div>\n  );\n};\n\nCodeEditor.displayName = 'CodeEditor';\n\nexport { CodeEditor };\n"]}

package/dist/kerebron.css

@@ -119,6 +119,34 @@
   color: var(--kb-menu-dropdown-text) !important;
 }
 
+/*
+ * Kerebron leaves headings, lists, links and code to browser defaults, which
+ * Tailwind's preflight strips (headings `inherit`, lists `list-style: none`,
+ * links `color: inherit`) — so "# " and "- " produced real h1/ul nodes that
+ * rendered as plain text while editing. `revert` hands these back to the
+ * browser. (Adapted from mieweb/timehuddle#620.)
+ *
+ * Deliberately NOT in `@layer base`: @mieweb/q ships an *unlayered* preflight
+ * copy, and unlayered author rules beat any layered rule. Unlayered here with
+ * `:where()` keeps specificity at 0,1,0 — above preflight's bare element
+ * selectors (0,0,1) but below Kerebron's own `.kb-editor pre` / `.kb-editor
+ * ul` rules (0,1,1), so its pre-wrap and list padding stay in charge.
+ */
+.kb-editor :where(h1, h2, h3, h4, h5, h6, ol, ul, a, code, pre) {
+  all: revert;
+}
+/* The browser's default link blue is unreadable on the dark editor surface,
+   and the brand blue fails 4.5:1 on white, so each theme gets its own shade.
+   Dark uses primary-400: primary-500 (#64748b) is only ~3.9:1 on the default
+   brand's #0f172a background, while primary-400 (#94a3b8) is ~7:1. */
+.kb-editor :where(a) {
+  color: var(--mieweb-primary-800, #0f749c);
+}
+[data-theme='dark'] .kb-editor :where(a),
+.dark .kb-editor :where(a) {
+  color: var(--mieweb-primary-400, #94a3b8);
+}
+
 /*
  * Kerebron's base.css paints inline shortcode pills green without setting a
  * text color, so the inherited foreground fails WCAG AA contrast. Pin an
@@ -129,6 +157,93 @@
   color: #ffffff;
 }
 
+/*
+ * codecrock's light syntax palette fails WCAG AA on white: keyword #d73 is
+ * 3.1:1, number #099 3.5:1, string #690 3.4:1, comment #998 2.9:1, etc.
+ * (axe color-contrast, caught by the Storybook a11y CI job). Darken each
+ * failing token to a hue-preserving shade ≥4.5:1; tokens already passing
+ * (property, function, type, variable, tag) are left to upstream.
+ */
+.kb-editor .ts-keyword,
+.kb-editor .ts-keyword_operator,
+.kb-editor .ts-function_builtin {
+  color: #b03a00; /* was #d73 (3.1:1) → 6.1:1 */
+}
+.kb-editor .ts-number {
+  color: #007272; /* was #099 (3.5:1) → 5.8:1 */
+}
+.kb-editor .ts-string {
+  color: #557700; /* was #690 (3.4:1) → 5.2:1 */
+}
+.kb-editor .ts-string_special {
+  color: #c22f2f; /* was #d44 (4.2:1) → 5.6:1 */
+}
+.kb-editor .ts-comment {
+  color: #716d5e; /* was #998 (2.9:1) → 5.2:1 */
+}
+.kb-editor .ts-operator {
+  color: #637226; /* upstream #9a6 (2.5:1, misspelt .ts-perator) → 5.3:1 */
+}
+.kb-editor .ts-punctuation,
+.kb-editor .ts-punctuation_bracket {
+  color: #707070; /* was #999 (2.9:1) → 5.0:1 */
+}
+.kb-editor .ts-attribute {
+  color: #8a5c00; /* was #e90 (2.3:1) → 5.8:1 */
+}
+.kb-editor .ts-constant,
+.kb-editor .ts-constant_builtin {
+  color: #006a8e; /* was #0086b3 (4.2:1) → 6.1:1 */
+}
+/*
+ * Dark: codecrock only switches its palette via prefers-color-scheme, which
+ * a class-based dark toggle never matches — so dark surfaces were showing
+ * the light tokens. Re-assert codecrock's own dark (VS Code) palette for
+ * the tokens overridden above under the app's dark selectors.
+ */
+[data-theme='dark'] .kb-editor .ts-keyword,
+[data-theme='dark'] .kb-editor .ts-keyword_operator,
+.dark .kb-editor .ts-keyword,
+.dark .kb-editor .ts-keyword_operator {
+  color: #c586c0;
+}
+[data-theme='dark'] .kb-editor .ts-function_builtin,
+.dark .kb-editor .ts-function_builtin {
+  color: #dcdcaa;
+}
+[data-theme='dark'] .kb-editor .ts-number,
+.dark .kb-editor .ts-number {
+  color: #b5cea8;
+}
+[data-theme='dark'] .kb-editor .ts-string,
+[data-theme='dark'] .kb-editor .ts-string_special,
+.dark .kb-editor .ts-string,
+.dark .kb-editor .ts-string_special {
+  color: #ce9178;
+}
+[data-theme='dark'] .kb-editor .ts-comment,
+.dark .kb-editor .ts-comment {
+  color: #6a9955;
+}
+[data-theme='dark'] .kb-editor .ts-operator,
+[data-theme='dark'] .kb-editor .ts-punctuation,
+[data-theme='dark'] .kb-editor .ts-punctuation_bracket,
+.dark .kb-editor .ts-operator,
+.dark .kb-editor .ts-punctuation,
+.dark .kb-editor .ts-punctuation_bracket {
+  color: #d4d4d4;
+}
+[data-theme='dark'] .kb-editor .ts-attribute,
+.dark .kb-editor .ts-attribute {
+  color: #9cdcfe;
+}
+[data-theme='dark'] .kb-editor .ts-constant,
+[data-theme='dark'] .kb-editor .ts-constant_builtin,
+.dark .kb-editor .ts-constant,
+.dark .kb-editor .ts-constant_builtin {
+  color: #4fc1ff;
+}
+
 /* Overflow-menu icons declare min sizes that burst their compact buttons. */
 .kb-custom-menu__overflow-menu .kb-icon {
   display: inline-flex !important;

package/dist/kerebron.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import React__default from 'react';
 import { AssetLoad } from '@kerebron/editor';
+import { MediaUploadOptions } from '@kerebron/extension-basic-editor/ExtensionMediaUpload';
 
 /**
  * Editor kit assembly for {@link RichEditor}, for both plain and collaborative
@@ -42,6 +43,18 @@ interface CollabConfig {
      * Defaults to `globalThis.WebSocket`.
      */
     WebSocketPolyfill?: typeof globalThis.WebSocket;
+    /**
+     * Called when collaborative editing could not be started at all — the Yjs
+     * kit failed to load (see {@link createEditorKits}). The editor mounts
+     * anyway, as a local one; this is how the host finds out that edits are no
+     * longer shared, so it can say so, or tear its own editor down if unshared
+     * editing would be unsafe.
+     *
+     * Not for connection trouble: a room that is reachable but currently
+     * disconnected still has the Yjs kit loaded, and the provider retries on its
+     * own. This fires once, before the editor is created.
+     */
+    onUnavailable?: (error: unknown) => void;
 }
 
 interface RichEditorProps {
@@ -56,6 +69,10 @@ interface RichEditorProps {
      * editor connects to the `/yjs` websocket relay and every peer in the same
      * `room` co-edits one shared document. Uncontrolled like `value` — remount via
      * `key` to switch rooms.
+     *
+     * Best-effort: if the Yjs kit cannot be loaded the editor still mounts, as a
+     * local one, and `collab.onUnavailable` is called. Pass that callback if
+     * unshared editing is something your users need to be told about.
      */
     collab?: CollabConfig;
     /** Read-only surface: no typing, and the content dims. */
@@ -77,6 +94,26 @@ interface RichEditorProps {
      * `@kerebron/wasm`'s `assets/` somewhere else.
      */
     assetLoad?: AssetLoad;
+    /**
+     * How files pasted or dropped into the editor are handled.
+     *
+     * **Set `uploadHandler` if your documents are persisted anywhere.** Without
+     * it, a pasted image is embedded in the document as a base64 `data:` URL and
+     * a video as a blob object URL: a 4 MB screenshot becomes ~5.8 MB of
+     * markdown, which most APIs will refuse, and an object URL is dead as soon as
+     * the page reloads. `uploadHandler` receives the file and returns the URL to
+     * reference it by, so the document carries a link instead of the bytes.
+     *
+     * ```tsx
+     * <RichEditor
+     *   mediaUpload={{ uploadHandler: (file) => uploadToMyMediaStore(file) }}
+     * />
+     * ```
+     *
+     * Read once, when the editor mounts — like {@link collab}, remount via `key`
+     * to change it.
+     */
+    mediaUpload?: MediaUploadOptions;
 }
 interface RichEditorHandle {
     /**

package/dist/kerebron.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import React__default from 'react';
 import { AssetLoad } from '@kerebron/editor';
+import { MediaUploadOptions } from '@kerebron/extension-basic-editor/ExtensionMediaUpload';
 
 /**
  * Editor kit assembly for {@link RichEditor}, for both plain and collaborative
@@ -42,6 +43,18 @@ interface CollabConfig {
      * Defaults to `globalThis.WebSocket`.
      */
     WebSocketPolyfill?: typeof globalThis.WebSocket;
+    /**
+     * Called when collaborative editing could not be started at all — the Yjs
+     * kit failed to load (see {@link createEditorKits}). The editor mounts
+     * anyway, as a local one; this is how the host finds out that edits are no
+     * longer shared, so it can say so, or tear its own editor down if unshared
+     * editing would be unsafe.
+     *
+     * Not for connection trouble: a room that is reachable but currently
+     * disconnected still has the Yjs kit loaded, and the provider retries on its
+     * own. This fires once, before the editor is created.
+     */
+    onUnavailable?: (error: unknown) => void;
 }
 
 interface RichEditorProps {
@@ -56,6 +69,10 @@ interface RichEditorProps {
      * editor connects to the `/yjs` websocket relay and every peer in the same
      * `room` co-edits one shared document. Uncontrolled like `value` — remount via
      * `key` to switch rooms.
+     *
+     * Best-effort: if the Yjs kit cannot be loaded the editor still mounts, as a
+     * local one, and `collab.onUnavailable` is called. Pass that callback if
+     * unshared editing is something your users need to be told about.
      */
     collab?: CollabConfig;
     /** Read-only surface: no typing, and the content dims. */
@@ -77,6 +94,26 @@ interface RichEditorProps {
      * `@kerebron/wasm`'s `assets/` somewhere else.
      */
     assetLoad?: AssetLoad;
+    /**
+     * How files pasted or dropped into the editor are handled.
+     *
+     * **Set `uploadHandler` if your documents are persisted anywhere.** Without
+     * it, a pasted image is embedded in the document as a base64 `data:` URL and
+     * a video as a blob object URL: a 4 MB screenshot becomes ~5.8 MB of
+     * markdown, which most APIs will refuse, and an object URL is dead as soon as
+     * the page reloads. `uploadHandler` receives the file and returns the URL to
+     * reference it by, so the document carries a link instead of the bytes.
+     *
+     * ```tsx
+     * <RichEditor
+     *   mediaUpload={{ uploadHandler: (file) => uploadToMyMediaStore(file) }}
+     * />
+     * ```
+     *
+     * Read once, when the editor mounts — like {@link collab}, remount via `key`
+     * to change it.
+     */
+    mediaUpload?: MediaUploadOptions;
 }
 interface RichEditorHandle {
     /**