@glw907/cairn-cms 0.60.0 → 0.62.1

package/dist/components/TidyReview.svelte

@@ -17,256 +17,148 @@ the model made and never a count of the author's own usage. A normalization name
 setting that authorized it; counting the author's own habit is the harmonize-to-author judgment cairn
 must never make, so no such count exists.
 -->
-<script lang="ts">
-  import SparklesIcon from '@lucide/svelte/icons/sparkles';
-  import CheckIcon from '@lucide/svelte/icons/check';
-  import XIcon from '@lucide/svelte/icons/x';
-  import TriangleAlertIcon from '@lucide/svelte/icons/triangle-alert';
-  import LightbulbIcon from '@lucide/svelte/icons/lightbulb';
-  import EyeIcon from '@lucide/svelte/icons/eye';
-  import type { Change } from './tidy-diff.js';
-  import { lineLabel } from './tidy-diff.js';
-  import {
-    categorize,
-    isObjective,
-    buildBecause,
-    categoryLabel,
-    type TidyCategory,
-  } from './tidy-categorize.js';
-  import type { TidyConventions } from '../nav/site-config.js';
-
-  interface Props {
-    /** The validated change set (Task 13 output), the unit the surface accepts and rejects. */
-    changes: Change[];
-    /** The captured original the diff was computed against; the source of every line label and the
-     *  before/after rows. Positions index this string. */
-    original: string;
-    /** The resolved tidy conventions, the ONLY data source for a normalization's because-line and the
-     *  category inference. Never the buffer's usage. */
-    conventions: TidyConventions;
-    /** The model that produced the result, for the head pill (e.g. "claude-sonnet-4-6"). */
-    model: string;
-    /** The document's display title, for the head. */
-    title: string;
-    /** The apply seam from MarkdownEditor: the surface drives the in-buffer decorations and the batched
-     *  apply through it. Typed with an inline `import(...)` so no static editor-module edge sits in this
-     *  component (the editor-boundary test bars that edge by a textual scan). */
-    api: import('./editor-tidy.js').TidyApi;
-    /** Called when the review closes (apply or cancel), so the host clears tidy mode and re-enables the
-     *  editor. `applied` is true when the author applied changes, false on cancel/reject-all. */
-    onclose: (applied: boolean) => void;
-    /** Called to scroll the editor underneath to a hunk's source line; the host drives the editor's
-     *  selectRange seam. */
-    onshow: (from: number, to: number) => void;
-  }
-
-  let { changes, original, conventions, model, title, api, onclose, onshow }: Props = $props();
-
-  // One hunk per change, with its locally-inferred category, line label, diff rows, and because-line.
-  // Computed once from the immutable inputs; the disposition lives in its own reactive array so the
-  // rows do not recompute on every toggle.
-  interface Hunk {
-    index: number;
-    category: TidyCategory;
-    objective: boolean;
-    line: number;
-    contextBefore: string;
-    contextAfter: string;
-    delText: string;
-    addText: string;
-    delRun: { pre: string; mid: string; post: string };
-    addRun: { pre: string; mid: string; post: string };
-    because: ReturnType<typeof buildBecause>;
-    label: string;
-  }
-
-  const hunks: Hunk[] = $derived(changes.map((c) => {
-    const category = categorize(c, original, conventions);
-    const objective = isObjective(category);
-    const removed = original.slice(c.from, c.to);
-    const added = c.replacement;
-    // The line containing the change, and the one line of context above and below it (graft 4).
-    const line = lineLabel(original, c.from);
-    const lines = original.split('\n');
-    const contextBefore = line >= 2 ? lines[line - 2] ?? '' : '';
-    const contextAfter = line < lines.length ? lines[line] ?? '' : '';
-    // The changed line, split around the changed run so the diff can underline/strike just the run.
-    const lineStart = original.lastIndexOf('\n', c.from - 1) + 1;
-    const nextNewline = original.indexOf('\n', c.from);
-    const lineEnd = nextNewline === -1 ? original.length : nextNewline;
-    const fullLine = original.slice(lineStart, lineEnd);
-    const pre = original.slice(lineStart, c.from);
-    const post = original.slice(c.to, lineEnd);
-    const because =
-      category.kind === 'normalization' ? buildBecause(category.convention, conventions) : null;
-    return {
-      index: c.index,
-      category,
-      objective,
-      line,
-      contextBefore,
-      contextAfter,
-      delText: fullLine,
-      addText: pre + added + post,
-      delRun: { pre, mid: removed, post },
-      addRun: { pre, mid: added, post },
-      because,
-      label: categoryLabel(category),
-    };
-  }));
-
-  // The per-hunk disposition. Objective hunks open pre-kept; judgment hunks open undecided. The defaults
-  // come from the hunks (their safety rank); the author's per-hunk and bulk choices land in `overrides`,
-  // and `dispositions` is the merged effective map keyed by the stable change index. Splitting the two
-  // keeps the default reactive to the derived hunks without capturing only their initial value.
-  type Disposition = 'kept' | 'rejected' | 'undecided';
-  let overrides = $state<Record<number, Disposition>>({});
-
-  // The disposition a hunk takes under a given override map: the author's choice if present, else the
-  // safety-rank default (objective hunks pre-kept, judgment hunks undecided). One source for the default.
-  function effectiveDisposition(h: Hunk, map: Record<number, Disposition>): Disposition {
-    return map[h.index] ?? (h.objective ? 'kept' : 'undecided');
-  }
-
-  const dispositions = $derived<Record<number, Disposition>>(
-    Object.fromEntries(hunks.map((h) => [h.index, effectiveDisposition(h, overrides)] as const)),
-  );
-
-  // The keyboard step-through cursor: the focused hunk's array position. j/k move; a/r act on it.
-  let focusedPos = $state(0);
-
-  // The two live regions (the MediaPicker discipline). The tally region (role=status) speaks only on a
-  // bulk action; the action region (aria-live=polite) narrates the single per-hunk action and each
-  // cursor move. A live region re-announces only when its text changes, so a deterministic message
-  // (the same hunk, the same verb) would go silent on a repeat. Each writer appends an invisible
-  // incrementing nonce so the region text always mutates and the screen reader always speaks it.
-  let tallyMessage = $state('');
-  let actionMessage = $state('');
-  let announceNonce = 0;
-
-  // An invisible suffix that flips on every call, so a repeated identical announcement still changes
-  // the region text and re-fires the live region. It is a zero-width space, never voiced, so the heard
-  // sentence is unchanged. Each region keeps its own parity through the shared counter.
-  function nonce(): string {
-    return announceNonce++ % 2 === 0 ? '' : '​';
-  }
-
-  const keptCount = $derived(hunks.filter((h) => dispositions[h.index] === 'kept').length);
-  const reviewCount = $derived(hunks.filter((h) => dispositions[h.index] === 'undecided').length);
-  const skipCount = $derived(hunks.filter((h) => dispositions[h.index] === 'rejected').length);
-
-  let dialog = $state<HTMLDialogElement | null>(null);
-
-  $effect(() => {
-    // Open the dialog once on mount; showModal supplies the focus trap and Escape.
-    dialog?.showModal();
-  });
-
-  function setDisposition(index: number, next: Disposition) {
-    overrides = { ...overrides, [index]: next };
-  }
-
-  // Narrate one hunk in the polite region. The verb says what just happened to it ("Kept", "Skipped",
-  // or "Focused" as the cursor lands on it). The sentence carries the kind and the before/after text,
-  // and for a normalization appends the config-named rationale (never a usage count). The trailing
-  // nonce keeps a repeated identical action audible.
-  function narrate(h: Hunk, verb: string) {
-    const where = `Hunk ${hunks.indexOf(h) + 1} of ${hunks.length}`;
-    const what = h.delRun.mid && h.addRun.mid ? `${h.delRun.mid.trim()} becomes ${h.addRun.mid.trim()}` : h.label;
-    const why = h.because ? `, your ${h.because.label} setting is ${h.because.variant}` : '';
-    actionMessage = `${where}. ${h.label}. ${what}${why}. ${verb}.${nonce()}`;
-  }
-
-  function acceptHunk(h: Hunk) {
-    setDisposition(h.index, 'kept');
-    narrate(h, 'Kept');
-  }
-  function rejectHunk(h: Hunk) {
-    setDisposition(h.index, 'rejected');
-    narrate(h, 'Skipped');
-  }
-
-  // Accept fixes (the bulk action): mark EVERY OBJECTIVE hunk kept and nothing else. A judgment hunk is
-  // never touched here, so it stays undecided and is never swept. The tally region announces the result.
-  function acceptFixes() {
-    const next = { ...overrides };
-    for (const h of hunks) if (h.objective) next[h.index] = 'kept';
-    overrides = next;
-    const n = hunks.filter((h) => h.objective).length;
-    const stillReview = hunks.filter((h) => effectiveDisposition(h, next) === 'undecided').length;
-    tallyMessage = `${n} fixes kept. ${stillReview} still to review.${nonce()}`;
-  }
-
-  // Reject all: mark every hunk rejected; no text is written. The tally region announces it.
-  function rejectAll() {
-    overrides = Object.fromEntries(hunks.map((h) => [h.index, 'rejected'] as const));
-    tallyMessage = `All ${hunks.length} changes skipping.${nonce()}`;
-  }
-
-  // Apply: write the kept hunks in ONE batched transaction through the apply seam, then close. The
-  // seam's acceptMany dispatches a single view.dispatch({ changes }), so the whole tidy is one undoable
-  // step. ONLY the kept indexes are passed, so an undecided judgment hunk is never written.
-  function apply() {
-    const keptIndexes = hunks.filter((h) => dispositions[h.index] === 'kept').map((h) => h.index);
-    api.acceptMany(keptIndexes);
-    api.exit();
-    dialog?.close();
-    onclose(true);
-  }
-
-  // Cancel: write nothing, clear the decorations, leave the document byte-identical.
-  function cancel() {
-    api.exit();
-    dialog?.close();
-    onclose(false);
-  }
-
-  function showInText(h: Hunk) {
-    const c = changes.find((ch) => ch.index === h.index);
-    if (c) onshow(c.from, c.to);
-  }
-
-  // Move the step-through cursor and announce the hunk it lands on. A screen-reader user pressing j/k
-  // hears the newly-focused hunk (kind plus before/after text, plus the because-line for a judgment
-  // hunk), the same spec invariant the per-hunk action narration holds. Without this a move was silent.
-  function moveFocus(next: number) {
-    focusedPos = next;
-    const h = hunks[focusedPos];
-    if (h) narrate(h, 'Focused');
-  }
-
-  // Keyboard step-through on the hunk list (graft 3): j/k or n/p move; a/r accept/reject the focused
-  // hunk; A accepts all objective; Escape cancels (the native dialog supplies Escape, handled below).
-  function onListKeydown(e: KeyboardEvent) {
-    const h = hunks[focusedPos];
-    if (e.key === 'j' || e.key === 'n') {
-      moveFocus(Math.min(focusedPos + 1, hunks.length - 1));
-      e.preventDefault();
-    } else if (e.key === 'k' || e.key === 'p') {
-      moveFocus(Math.max(focusedPos - 1, 0));
-      e.preventDefault();
-    } else if (e.key === 'a' && !e.shiftKey) {
-      if (h) acceptHunk(h);
-      e.preventDefault();
-    } else if (e.key === 'r' && !e.shiftKey) {
-      if (h) rejectHunk(h);
-      e.preventDefault();
-    } else if (e.key === 'A' || (e.key === 'a' && e.shiftKey)) {
-      acceptFixes();
-      e.preventDefault();
-    }
-  }
-
-  // The native dialog raises a cancel event on Escape; map it to the surface's cancel so the buffer is
-  // left untouched and the host clears tidy mode.
-  function onDialogCancel(e: Event) {
+<script lang="ts">import SparklesIcon from "@lucide/svelte/icons/sparkles";
+import CheckIcon from "@lucide/svelte/icons/check";
+import XIcon from "@lucide/svelte/icons/x";
+import TriangleAlertIcon from "@lucide/svelte/icons/triangle-alert";
+import LightbulbIcon from "@lucide/svelte/icons/lightbulb";
+import EyeIcon from "@lucide/svelte/icons/eye";
+import { lineLabel } from "./tidy-diff.js";
+import {
+  categorize,
+  isObjective,
+  buildBecause,
+  categoryLabel
+} from "./tidy-categorize.js";
+let { changes, original, conventions, model, title, api, onclose, onshow } = $props();
+const hunks = $derived(changes.map((c) => {
+  const category = categorize(c, original, conventions);
+  const objective = isObjective(category);
+  const removed = original.slice(c.from, c.to);
+  const added = c.replacement;
+  const line = lineLabel(original, c.from);
+  const lines = original.split("\n");
+  const contextBefore = line >= 2 ? lines[line - 2] ?? "" : "";
+  const contextAfter = line < lines.length ? lines[line] ?? "" : "";
+  const lineStart = original.lastIndexOf("\n", c.from - 1) + 1;
+  const nextNewline = original.indexOf("\n", c.from);
+  const lineEnd = nextNewline === -1 ? original.length : nextNewline;
+  const fullLine = original.slice(lineStart, lineEnd);
+  const pre = original.slice(lineStart, c.from);
+  const post = original.slice(c.to, lineEnd);
+  const because = category.kind === "normalization" ? buildBecause(category.convention, conventions) : null;
+  return {
+    index: c.index,
+    category,
+    objective,
+    line,
+    contextBefore,
+    contextAfter,
+    delText: fullLine,
+    addText: pre + added + post,
+    delRun: { pre, mid: removed, post },
+    addRun: { pre, mid: added, post },
+    because,
+    label: categoryLabel(category)
+  };
+}));
+let overrides = $state({});
+function effectiveDisposition(h, map) {
+  return map[h.index] ?? (h.objective ? "kept" : "undecided");
+}
+const dispositions = $derived(
+  Object.fromEntries(hunks.map((h) => [h.index, effectiveDisposition(h, overrides)]))
+);
+let focusedPos = $state(0);
+let tallyMessage = $state("");
+let actionMessage = $state("");
+let announceNonce = 0;
+function nonce() {
+  return announceNonce++ % 2 === 0 ? "" : "​";
+}
+const keptCount = $derived(hunks.filter((h) => dispositions[h.index] === "kept").length);
+const reviewCount = $derived(hunks.filter((h) => dispositions[h.index] === "undecided").length);
+const skipCount = $derived(hunks.filter((h) => dispositions[h.index] === "rejected").length);
+let dialog = $state(null);
+$effect(() => {
+  dialog?.showModal();
+});
+function setDisposition(index, next) {
+  overrides = { ...overrides, [index]: next };
+}
+function narrate(h, verb) {
+  const where = `Hunk ${hunks.indexOf(h) + 1} of ${hunks.length}`;
+  const what = h.delRun.mid && h.addRun.mid ? `${h.delRun.mid.trim()} becomes ${h.addRun.mid.trim()}` : h.label;
+  const why = h.because ? `, your ${h.because.label} setting is ${h.because.variant}` : "";
+  actionMessage = `${where}. ${h.label}. ${what}${why}. ${verb}.${nonce()}`;
+}
+function acceptHunk(h) {
+  setDisposition(h.index, "kept");
+  narrate(h, "Kept");
+}
+function rejectHunk(h) {
+  setDisposition(h.index, "rejected");
+  narrate(h, "Skipped");
+}
+function acceptFixes() {
+  const next = { ...overrides };
+  for (const h of hunks) if (h.objective) next[h.index] = "kept";
+  overrides = next;
+  const n = hunks.filter((h) => h.objective).length;
+  const stillReview = hunks.filter((h) => effectiveDisposition(h, next) === "undecided").length;
+  tallyMessage = `${n} fixes kept. ${stillReview} still to review.${nonce()}`;
+}
+function rejectAll() {
+  overrides = Object.fromEntries(hunks.map((h) => [h.index, "rejected"]));
+  tallyMessage = `All ${hunks.length} changes skipping.${nonce()}`;
+}
+function apply() {
+  const keptIndexes = hunks.filter((h) => dispositions[h.index] === "kept").map((h) => h.index);
+  api.acceptMany(keptIndexes);
+  api.exit();
+  dialog?.close();
+  onclose(true);
+}
+function cancel() {
+  api.exit();
+  dialog?.close();
+  onclose(false);
+}
+function showInText(h) {
+  const c = changes.find((ch) => ch.index === h.index);
+  if (c) onshow(c.from, c.to);
+}
+function moveFocus(next) {
+  focusedPos = next;
+  const h = hunks[focusedPos];
+  if (h) narrate(h, "Focused");
+}
+function onListKeydown(e) {
+  const h = hunks[focusedPos];
+  if (e.key === "j" || e.key === "n") {
+    moveFocus(Math.min(focusedPos + 1, hunks.length - 1));
+    e.preventDefault();
+  } else if (e.key === "k" || e.key === "p") {
+    moveFocus(Math.max(focusedPos - 1, 0));
+    e.preventDefault();
+  } else if (e.key === "a" && !e.shiftKey) {
+    if (h) acceptHunk(h);
+    e.preventDefault();
+  } else if (e.key === "r" && !e.shiftKey) {
+    if (h) rejectHunk(h);
+    e.preventDefault();
+  } else if (e.key === "A" || e.key === "a" && e.shiftKey) {
+    acceptFixes();
     e.preventDefault();
-    cancel();
-  }
-
-  function actsLabel(h: Hunk): string {
-    return h.objective ? 'Accept or reject this fix' : 'Accept or reject this change';
   }
+}
+function onDialogCancel(e) {
+  e.preventDefault();
+  cancel();
+}
+function actsLabel(h) {
+  return h.objective ? "Accept or reject this fix" : "Accept or reject this change";
+}
 </script>
 
 <dialog

package/dist/components/WebLinkDialog.svelte

@@ -6,46 +6,25 @@ text; when the editor holds a selection it arrives as the default text, and the
 that selection either way. Built on a native <dialog>, following the LinkPicker a11y conventions,
 and opened by the host's Ctrl/Cmd+K shortcut through the exported open().
 -->
-<script lang="ts">
-  interface Props {
-    /** Insert an inline link at the editor cursor; the editor's registerInsertLink seam. */
-    insert: (href: string, title: string) => void;
-    /** Read the editor's current selection, for the Text field's default. */
-    selection?: () => string;
-    /** Disable the trigger; the host sets it while Preview shows. */
-    disabled?: boolean;
-    /** Render the built-in Web link trigger. False mounts only the dialog, for a host that
-     *  supplies its own trigger and opens the dialog through the exported open(). */
-    trigger?: boolean;
-  }
-
-  let { insert, selection, disabled = false, trigger = true }: Props = $props();
-
-  let dialog = $state<HTMLDialogElement | null>(null);
-  let hrefInput = $state<HTMLInputElement | null>(null);
-  let href = $state('');
-  let text = $state('');
-
-  /** Open the dialog with fresh fields; the edit page's Ctrl/Cmd+K shortcut calls it too. */
-  export function open() {
-    href = '';
-    text = selection?.() ?? '';
-    dialog?.showModal();
-    // showModal() lands focus on the first focusable element (the header Close button), so move
-    // it to the address input the dialog exists for (WCAG 2.4.3). A microtask defers past the
-    // dialog's own focus handling, the RenameDialog recipe.
-    queueMicrotask(() => hrefInput?.focus());
-  }
-  function close() {
-    dialog?.close();
-  }
-  function submit(e: SubmitEvent) {
-    e.preventDefault();
-    // With no text and no selection the address itself becomes the display text, so the link
-    // never renders as an invisible pair of brackets.
-    insert(href, text.trim() || href);
-    close();
-  }
+<script lang="ts">let { insert, selection, disabled = false, trigger = true } = $props();
+let dialog = $state(null);
+let hrefInput = $state(null);
+let href = $state("");
+let text = $state("");
+export function open() {
+  href = "";
+  text = selection?.() ?? "";
+  dialog?.showModal();
+  queueMicrotask(() => hrefInput?.focus());
+}
+function close() {
+  dialog?.close();
+}
+function submit(e) {
+  e.preventDefault();
+  insert(href, text.trim() || href);
+  close();
+}
 </script>
 
 {#if trigger}

package/dist/components/cairn-admin.css

@@ -7135,6 +7135,10 @@
     user-select: none;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .\[builtin\:vite-dynamic-import-vars\] {
+    builtin: vite-dynamic-import-vars;
+  }
+
   @media (hover: hover) {
     :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .group-hover\/sec\:opacity-90:is(:where(.group\/sec):hover *) {
       opacity: .9;

package/dist/components/client-ingest.d.ts

@@ -44,11 +44,15 @@ export declare function firstImageFile(dt: {
     files?: ArrayLike<File>;
     items?: ArrayLike<DataTransferItem>;
 }): File | null;
-/** The conservative canvas area budget, about 16.7M px (4096 x 4096). A source over this is scaled
- *  down before any `drawImage`, never clipped. */
+/**
+ * The conservative canvas area budget, about 16.7M px (4096 x 4096). A source over this is scaled
+ *  down before any `drawImage`, never clipped.
+ */
 export declare const MAX_AREA = 16777216;
-/** The conservative short-side budget. A source whose smaller dimension exceeds this is scaled down so
- *  the short side lands at the cap, even when its area is within MAX_AREA. */
+/**
+ * The conservative short-side budget. A source whose smaller dimension exceeds this is scaled down so
+ *  the short side lands at the cap, even when its area is within MAX_AREA.
+ */
 export declare const MAX_SHORT_SIDE = 4096;
 /**
  * The canvas budget for a source of the given dimensions. When the source area exceeds MAX_AREA or its
@@ -60,9 +64,11 @@ export declare function budgetForDimensions(width: number, height: number): {
     width: number;
     height: number;
 };
-/** The ingest failure taxonomy. `decode-unsupported` is a format the browser and the HEIC decoder both
+/**
+ * The ingest failure taxonomy. `decode-unsupported` is a format the browser and the HEIC decoder both
  *  refuse; `transcode-failed` is a HEIC decode or a canvas re-encode that threw; `too-large` is a
- *  source still over budget after a transcode; `network` is the upload fetch rejecting. */
+ *  source still over budget after a transcode; `network` is the upload fetch rejecting.
+ */
 export type IngestFailureKind = 'decode-unsupported' | 'transcode-failed' | 'too-large' | 'network';
 /** A failed ingest card: a stable discriminant plus a human message the capture card renders. */
 export interface IngestFailureCard {
@@ -136,7 +142,9 @@ export declare function ingestFailureKind(error: unknown): IngestFailureKind;
  * `fetch`.
  */
 export declare function sendUpload(url: string, init: RequestInit): Promise<Response>;
-/** Guard a drop target: cancel the browser's default open-the-file behavior on `dragover` and `drop`
- *  so a dropped image stays inside the editor rather than navigating the page to the file. */
+/**
+ * Guard a drop target: cancel the browser's default open-the-file behavior on `dragover` and `drop`
+ *  so a dropped image stays inside the editor rather than navigating the page to the file.
+ */
 export declare function guardDropTarget(event: DragEvent): void;
 export {};

package/dist/components/client-ingest.js

@@ -109,11 +109,15 @@ export function normalizeDataTransfer(dt) {
 export function firstImageFile(dt) {
     return normalizeDataTransfer(dt)[0] ?? null;
 }
-/** The conservative canvas area budget, about 16.7M px (4096 x 4096). A source over this is scaled
- *  down before any `drawImage`, never clipped. */
+/**
+ * The conservative canvas area budget, about 16.7M px (4096 x 4096). A source over this is scaled
+ *  down before any `drawImage`, never clipped.
+ */
 export const MAX_AREA = 16_777_216;
-/** The conservative short-side budget. A source whose smaller dimension exceeds this is scaled down so
- *  the short side lands at the cap, even when its area is within MAX_AREA. */
+/**
+ * The conservative short-side budget. A source whose smaller dimension exceeds this is scaled down so
+ *  the short side lands at the cap, even when its area is within MAX_AREA.
+ */
 export const MAX_SHORT_SIDE = 4096;
 /**
  * The canvas budget for a source of the given dimensions. When the source area exceeds MAX_AREA or its
@@ -290,8 +294,10 @@ export async function sendUpload(url, init) {
         throw new IngestError('network');
     }
 }
-/** Guard a drop target: cancel the browser's default open-the-file behavior on `dragover` and `drop`
- *  so a dropped image stays inside the editor rather than navigating the page to the file. */
+/**
+ * Guard a drop target: cancel the browser's default open-the-file behavior on `dragover` and `drop`
+ *  so a dropped image stays inside the editor rather than navigating the page to the file.
+ */
 export function guardDropTarget(event) {
     event.preventDefault();
 }

package/dist/components/editor-media.js

@@ -103,8 +103,10 @@ class MediaChipWidget extends WidgetType {
         return false;
     }
 }
-/** Scan one line's text for media image tokens, mapping each to its document offsets and resolving its
- *  library entry. lineFrom is the line's document start, so the match offsets become absolute. */
+/**
+ * Scan one line's text for media image tokens, mapping each to its document offsets and resolving its
+ *  library entry. lineFrom is the line's document start, so the match offsets become absolute.
+ */
 function matchesInLine(text, lineFrom, library) {
     const out = [];
     MEDIA_IMAGE.lastIndex = 0;
@@ -133,10 +135,12 @@ function matchesInLine(text, lineFrom, library) {
     }
     return out;
 }
-/** Every media image match across the editor's visible ranges, in document order, each carrying its
+/**
+ * Every media image match across the editor's visible ranges, in document order, each carrying its
  *  enclosing figure role. One {@link fenceScan} over the whole document feeds the cheap per-token
  *  figure detection (no remark parse on the per-rebuild chip path); the visible lines are scanned
- *  for tokens, then each token's line index drives {@link figureRoleAtLine}. */
+ *  for tokens, then each token's line index drives {@link figureRoleAtLine}.
+ */
 function visibleMatches(view, library) {
     const lines = view.state.doc.toString().split('\n');
     const scan = fenceScan(lines);
@@ -153,8 +157,10 @@ function visibleMatches(view, library) {
     }
     return out;
 }
-/** Replace decorations for each visible media image's reference token: the chip widget over the URL
- *  token, the alt left untouched. The same spans seed the atomic-range set. */
+/**
+ * Replace decorations for each visible media image's reference token: the chip widget over the URL
+ *  token, the alt left untouched. The same spans seed the atomic-range set.
+ */
 function buildMediaDecorations(view, library) {
     const builder = new RangeSetBuilder();
     for (const match of visibleMatches(view, library)) {
@@ -162,9 +168,11 @@ function buildMediaDecorations(view, library) {
     }
     return builder.finish();
 }
-/** The atomic ranges for the visible media reference tokens: a caret or selection edit treats each
+/**
+ * The atomic ranges for the visible media reference tokens: a caret or selection edit treats each
  *  token as one unit, so a stray keystroke replaces the whole reference rather than corrupting a hex
- *  digit. Built from the same matches the decorations use, so the two never disagree. */
+ *  digit. Built from the same matches the decorations use, so the two never disagree.
+ */
 function buildAtomicRanges(view, library) {
     const ranges = [];
     for (const match of visibleMatches(view, library)) {

package/dist/components/editor-placeholder.d.ts

@@ -1,8 +1,10 @@
 import { EditorView } from '@codemirror/view';
 import { type Extension } from '@codemirror/state';
-/** The seam the host drives: begin lands a placeholder and returns its id; progress moves its bar;
+/**
+ * The seam the host drives: begin lands a placeholder and returns its id; progress moves its bar;
  *  resolveTo swaps it for the committed image text; cancel removes it leaving the source untouched.
- *  Mirrors the register-callback idiom MarkdownEditor uses for its other editor ops. */
+ *  Mirrors the register-callback idiom MarkdownEditor uses for its other editor ops.
+ */
 export interface ImagePlaceholderApi {
     /** Land an optimistic placeholder at the current caret from a local object URL; returns its id. */
     begin(objectUrl: string): number;