@glw907/cairn-cms 0.60.0 → 0.62.1

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

@@ -1,31 +1,43 @@
 import { EditorView } from '@codemirror/view';
 import { type Extension } from '@codemirror/state';
 import type { Change } from './tidy-diff.js';
-/** The api the host drives over one editor view (spec 2.5). Mirrors imagePlaceholderApi: the host
+/**
+ * The api the host drives over one editor view (spec 2.5). Mirrors imagePlaceholderApi: the host
  *  registers it through registerTidy, and the review surface calls it as the author works the list.
- *  Every accept lands as a CodeMirror transaction; reject and reject-all write no text. */
+ *  Every accept lands as a CodeMirror transaction; reject and reject-all write no text.
+ */
 export interface TidyApi {
-    /** Open tidy with the validated change set: seed the field, show the decorations. The buffer is
-     *  untouched; the originals stay until an accept writes. */
+    /**
+     * Open tidy with the validated change set: seed the field, show the decorations. The buffer is
+     *  untouched; the originals stay until an accept writes.
+     */
     enter(changes: Change[]): void;
-    /** Accept one change: dispatch its replacement over its current span in one transaction and mark it
-     *  accepted. The other pending changes map across the edit. */
+    /**
+     * Accept one change: dispatch its replacement over its current span in one transaction and mark it
+     *  accepted. The other pending changes map across the edit.
+     */
     acceptOne(index: number): void;
     /** Reject one change: mark it rejected so its decorations clear, leaving the original untouched. */
     rejectOne(index: number): void;
-    /** Accept many changes (the bulk action) in ONE transaction: the whole edit is one undoable step.
+    /**
+     * Accept many changes (the bulk action) in ONE transaction: the whole edit is one undoable step.
      *  The caller passes ONLY the indexes it has decided to keep; this never sweeps an index the caller
-     *  did not name, which is how Accept-fixes confines itself to objective hunks. */
+     *  did not name, which is how Accept-fixes confines itself to objective hunks.
+     */
     acceptMany(indexes: number[]): void;
     /** Reject every remaining pending change, leaving the document byte-identical. */
     rejectAll(): void;
     /** Close tidy: clear the field and the decorations. The buffer holds whatever the accepts wrote. */
     exit(): void;
 }
-/** The tidy extension: the StateField holding the change set and its decorations. The host adds it to
+/**
+ * The tidy extension: the StateField holding the change set and its decorations. The host adds it to
  *  the initial editor state (in its own compartment beside media and folding), then builds the driving
- *  api with tidyApi once the view exists. */
+ *  api with tidyApi once the view exists.
+ */
 export declare function cairnTidy(): Extension;
-/** Build the api that drives tidy against one editor view. The host registers it through registerTidy;
- *  the review surface calls enter, the per-hunk and bulk accept/reject, and exit. */
+/**
+ * Build the api that drives tidy against one editor view. The host registers it through registerTidy;
+ *  the review surface calls enter, the per-hunk and bulk accept/reject, and exit.
+ */
 export declare function tidyApi(view: EditorView): TidyApi;

package/dist/components/editor-tidy.js

@@ -152,14 +152,18 @@ const tidyField = StateField.define({
     },
     provide: (f) => EditorView.decorations.from(f, (v) => buildDecorations(v)),
 });
-/** The tidy extension: the StateField holding the change set and its decorations. The host adds it to
+/**
+ * The tidy extension: the StateField holding the change set and its decorations. The host adds it to
  *  the initial editor state (in its own compartment beside media and folding), then builds the driving
- *  api with tidyApi once the view exists. */
+ *  api with tidyApi once the view exists.
+ */
 export function cairnTidy() {
     return tidyField;
 }
-/** Build the api that drives tidy against one editor view. The host registers it through registerTidy;
- *  the review surface calls enter, the per-hunk and bulk accept/reject, and exit. */
+/**
+ * Build the api that drives tidy against one editor view. The host registers it through registerTidy;
+ *  the review surface calls enter, the per-hunk and bulk accept/reject, and exit.
+ */
 export function tidyApi(view) {
     // Dispatch the named changes' replacements over their CURRENT mapped spans in one transaction, mark
     // them accepted, and let the field map any remaining pending entries. The changes are read from the

package/dist/components/index.d.ts

@@ -6,6 +6,7 @@ export { default as CsrfField } from './CsrfField.svelte';
 export { default as ConceptList } from './ConceptList.svelte';
 export { default as CairnMediaLibrary } from './CairnMediaLibrary.svelte';
 export { default as CairnTidySettings } from './CairnTidySettings.svelte';
+export { default as HelpHome } from './HelpHome.svelte';
 export { default as EditPage } from './EditPage.svelte';
 export { default as ManageEditors } from './ManageEditors.svelte';
 export { default as MarkdownEditor } from './MarkdownEditor.svelte';

package/dist/components/index.js

@@ -8,6 +8,7 @@ export { default as CsrfField } from './CsrfField.svelte';
 export { default as ConceptList } from './ConceptList.svelte';
 export { default as CairnMediaLibrary } from './CairnMediaLibrary.svelte';
 export { default as CairnTidySettings } from './CairnTidySettings.svelte';
+export { default as HelpHome } from './HelpHome.svelte';
 export { default as EditPage } from './EditPage.svelte';
 export { default as ManageEditors } from './ManageEditors.svelte';
 export { default as MarkdownEditor } from './MarkdownEditor.svelte';

package/dist/components/link-completion.d.ts

@@ -1,15 +1,21 @@
 import type { Completion, CompletionSource } from '@codemirror/autocomplete';
 import type { LinkTarget } from '../content/manifest.js';
-/** The open `[[query` before the cursor, or null. The query stops at a closing bracket or a newline,
- *  so a finished `[[x]]` link and ordinary prose never trigger. `from` is the index of the `[[`. */
+/**
+ * The open `[[query` before the cursor, or null. The query stops at a closing bracket or a newline,
+ *  so a finished `[[x]]` link and ordinary prose never trigger. `from` is the index of the `[[`.
+ */
 export declare function matchCairnTrigger(before: string): {
     query: string;
     from: number;
 } | null;
-/** The completion options for a query: a case-insensitive title substring match, each option grouped
- *  by concept, a draft marked and a post date shown in the detail, and the apply text the full link. */
+/**
+ * The completion options for a query: a case-insensitive title substring match, each option grouped
+ *  by concept, a draft marked and a post date shown in the detail, and the apply text the full link.
+ */
 export declare function linkCompletions(targets: LinkTarget[], query: string): Completion[];
-/** A CodeMirror CompletionSource over the site's link targets, triggered by `[[`. It replaces the
+/**
+ * A CodeMirror CompletionSource over the site's link targets, triggered by `[[`. It replaces the
  *  whole `[[query` with the chosen link, and sets filter:false because linkCompletions already
- *  filtered by the query (CodeMirror would otherwise re-filter against the literal `[[query`). */
+ *  filtered by the query (CodeMirror would otherwise re-filter against the literal `[[query`).
+ */
 export declare function cairnLinkCompletionSource(targets: LinkTarget[]): CompletionSource;

package/dist/components/link-completion.js

@@ -11,14 +11,18 @@ const CONCEPT_SECTIONS = {
 function sectionFor(concept) {
     return CONCEPT_SECTIONS[concept] ?? { name: concept.charAt(0).toUpperCase() + concept.slice(1), rank: 2 };
 }
-/** The open `[[query` before the cursor, or null. The query stops at a closing bracket or a newline,
- *  so a finished `[[x]]` link and ordinary prose never trigger. `from` is the index of the `[[`. */
+/**
+ * The open `[[query` before the cursor, or null. The query stops at a closing bracket or a newline,
+ *  so a finished `[[x]]` link and ordinary prose never trigger. `from` is the index of the `[[`.
+ */
 export function matchCairnTrigger(before) {
     const match = /\[\[([^[\]\n]*)$/.exec(before);
     return match ? { query: match[1], from: match.index } : null;
 }
-/** The completion options for a query: a case-insensitive title substring match, each option grouped
- *  by concept, a draft marked and a post date shown in the detail, and the apply text the full link. */
+/**
+ * The completion options for a query: a case-insensitive title substring match, each option grouped
+ *  by concept, a draft marked and a post date shown in the detail, and the apply text the full link.
+ */
 export function linkCompletions(targets, query) {
     const q = query.trim().toLowerCase();
     const matched = q ? targets.filter((t) => t.title.toLowerCase().includes(q)) : targets;
@@ -29,9 +33,11 @@ export function linkCompletions(targets, query) {
         apply: `[${escapeLinkText(t.title)}](${formatCairnToken(t)})`,
     }));
 }
-/** A CodeMirror CompletionSource over the site's link targets, triggered by `[[`. It replaces the
+/**
+ * A CodeMirror CompletionSource over the site's link targets, triggered by `[[`. It replaces the
  *  whole `[[query` with the chosen link, and sets filter:false because linkCompletions already
- *  filtered by the query (CodeMirror would otherwise re-filter against the literal `[[query`). */
+ *  filtered by the query (CodeMirror would otherwise re-filter against the literal `[[query`).
+ */
 export function cairnLinkCompletionSource(targets) {
     return async (context) => {
         const line = context.state.doc.lineAt(context.pos);

package/dist/components/markdown-directives.d.ts

@@ -1,6 +1,6 @@
 /**
- * The directive name from a container opener line (`:::callout{...}` -> `callout`,
- * `::::cta[Book]` -> `cta`), or null when the line is not a named container opener. Reads the
+ * The directive name from a container opener line (`:::callout{...}` gives `callout`,
+ * `::::cta[Book]` gives `cta`), or null when the line is not a named container opener. Reads the
  * same FENCE match the scan uses: group 2 is the name, empty on a bare closer, so a closer or a
  * non-fence line returns null.
  */
@@ -11,9 +11,11 @@ export declare function directiveLineKind(line: string): 'fence' | 'leaf' | null
 export interface FenceScan {
     /** The 1-based container depth per line, or null outside any container. */
     depths: (number | null)[];
-    /** Whether a line opened or closed a container, or null for everything else. A fence-shaped
+    /**
+     * Whether a line opened or closed a container, or null for everything else. A fence-shaped
      *  line the code-block tracking disowned is null too, so the role array is the one source of
-     *  truth for pairing and no caller re-parses a line the scan already judged. */
+     *  truth for pairing and no caller re-parses a line the scan already judged.
+     */
     roles: ('opener' | 'closer' | null)[];
 }
 /**
@@ -56,7 +58,8 @@ export declare function caretContainerRange(scan: FenceScan, caretLine: number):
  * example can neither open nor close a range. This is the sole source of fold ranges.
  */
 export declare function containerRanges(scan: FenceScan): ContainerRange[];
-/** The figure placement role for a media token sitting on `lineIndex`, derived from the editor's
+/**
+ * The figure placement role for a media token sitting on `lineIndex`, derived from the editor's
  *  line scan without a remark parse (the chip rebuild runs on every doc and viewport change).
  *
  *  Returns the closed-set role (`center`/`wide`/`full`) when the innermost container holding the
@@ -76,7 +79,7 @@ export interface FenceToken {
 }
 /**
  * Split a fence line into machinery and meaning. The colon run, the label's brackets, and the
- * whole {attrs} group are machinery; the directive name and the label text are meaning, the
+ * whole `{attrs}` group are machinery; the directive name and the label text are meaning, the
  * parts an editor reads. A bare closer is a single machinery span, and a non-fence line yields
  * no spans at all.
  */

package/dist/components/markdown-directives.js

@@ -15,8 +15,8 @@ const INLINE = /(?<![:\w]):[\w-]+\[[^\]]*\](\{[^}]*\})?/g;
 // never opens a real container.
 const CODE_FENCE = /^\s{0,3}(`{3,}|~{3,})/;
 /**
- * The directive name from a container opener line (`:::callout{...}` -> `callout`,
- * `::::cta[Book]` -> `cta`), or null when the line is not a named container opener. Reads the
+ * The directive name from a container opener line (`:::callout{...}` gives `callout`,
+ * `::::cta[Book]` gives `cta`), or null when the line is not a named container opener. Reads the
  * same FENCE match the scan uses: group 2 is the name, empty on a bare closer, so a closer or a
  * non-fence line returns null.
  */
@@ -145,8 +145,10 @@ export function containerRanges(scan) {
     }
     return out;
 }
-/** The closed placement-role set for the reserved `figure` directive, mirroring remark-figure.ts.
- *  A class outside this set is the measure default, never passed through as a role. */
+/**
+ * The closed placement-role set for the reserved `figure` directive, mirroring remark-figure.ts.
+ *  A class outside this set is the measure default, never passed through as a role.
+ */
 const FIGURE_ROLES = new Set(['center', 'wide', 'full']);
 // The directive `{attrs}` brace, and the `.class` shorthands inside it. mdast-util-directive folds
 // every `.class` into a space-joined node.attributes.class, and remark-figure honors a role only when
@@ -156,7 +158,8 @@ const FIGURE_ROLES = new Set(['center', 'wide', 'full']);
 const ATTR_BRACE = /\{([^}]*)\}/;
 const CLASS_SHORTHAND = /\.([\w-]+)/g;
 const CLASS_ATTR = /class\s*=\s*"([^"]*)"/;
-/** The figure placement role for a media token sitting on `lineIndex`, derived from the editor's
+/**
+ * The figure placement role for a media token sitting on `lineIndex`, derived from the editor's
  *  line scan without a remark parse (the chip rebuild runs on every doc and viewport change).
  *
  *  Returns the closed-set role (`center`/`wide`/`full`) when the innermost container holding the
@@ -189,7 +192,7 @@ export function figureRoleAtLine(scan, lines, lineIndex) {
 }
 /**
  * Split a fence line into machinery and meaning. The colon run, the label's brackets, and the
- * whole {attrs} group are machinery; the directive name and the label text are meaning, the
+ * whole `{attrs}` group are machinery; the directive name and the label text are meaning, the
  * parts an editor reads. A bare closer is a single machinery span, and a non-fence line yields
  * no spans at all.
  */

package/dist/components/markdown-format.d.ts

@@ -4,6 +4,9 @@ export interface FormatResult {
     from: number;
     to: number;
 }
+/**
+ *
+ */
 export declare function applyMarkdownFormat(doc: string, from: number, to: number, kind: FormatKind): FormatResult;
 /**
  * Insert an inline markdown link at the selection. With a non-empty selection the selected text
@@ -50,8 +53,10 @@ export declare function findMediaImagesNeedingAlt(doc: string): MediaImageNeedin
  * is left in place.
  */
 export declare function unwrapCairnLink(doc: string, href: string): string;
-/** The closed placement role set the figure render step honors. A role outside it is the measure
- *  default (null), so the control never writes one. Mirrors the set in render/remark-figure.ts. */
+/**
+ * The closed placement role set the figure render step honors. A role outside it is the measure
+ *  default (null), so the control never writes one. Mirrors the set in render/remark-figure.ts.
+ */
 export type FigureRole = 'center' | 'wide' | 'full';
 /**
  * The media image at a caret, with the enclosing `:::figure` block when there is one. `imageFrom`

package/dist/components/markdown-format.js

@@ -27,8 +27,10 @@ const LINE = {
     task: { prefix: () => '- [ ] ', exact: /^- \[[ xX]\] /, strip: /^- \[[ xX]\] / },
 };
 const TABLE_GRID = '| Column 1 | Column 2 |\n| -------- | -------- |\n|          |          |\n|          |          |';
-/** Wrap the selection in `marker`, or unwrap when the markers are already there (inside or just
- *  outside the selection). The returned range covers the text without its markers either way. */
+/**
+ * Wrap the selection in `marker`, or unwrap when the markers are already there (inside or just
+ *  outside the selection). The returned range covers the text without its markers either way.
+ */
 function toggleWrap(doc, from, to, marker) {
     const m = marker.length;
     const sel = doc.slice(from, to);
@@ -42,10 +44,12 @@ function toggleWrap(doc, from, to, marker) {
     const next = doc.slice(0, from) + marker + sel + marker + doc.slice(to);
     return { doc: next, from: from + m, to: to + m };
 }
-/** Apply a line-prefix kind to every selected line. When the kind toggles and every line already
+/**
+ * Apply a line-prefix kind to every selected line. When the kind toggles and every line already
  *  carries its marker, the markers come off; otherwise competing markers are replaced and each
  *  line gains the kind's prefix. The selection shifts with the first line's edit and stretches
- *  by the total length change, the same mechanics the original single-prefix version had. */
+ *  by the total length change, the same mechanics the original single-prefix version had.
+ */
 function applyLinePrefix(doc, from, to, kind) {
     const { prefix, exact, strip } = LINE[kind];
     const lineStart = doc.lastIndexOf('\n', from - 1) + 1; // 0 when the selection is on the first line
@@ -62,8 +66,10 @@ function applyLinePrefix(doc, from, to, kind) {
         to: to + totalDelta,
     };
 }
-/** Fence the selected lines in triple backticks on their own lines, or remove the fences when the
- *  lines just above and below the selection already are fences. */
+/**
+ * Fence the selected lines in triple backticks on their own lines, or remove the fences when the
+ *  lines just above and below the selection already are fences.
+ */
 function toggleCodeFence(doc, from, to) {
     const lineStart = doc.lastIndexOf('\n', from - 1) + 1;
     const lineEndRaw = doc.indexOf('\n', to);
@@ -82,6 +88,9 @@ function toggleCodeFence(doc, from, to) {
     const next = doc.slice(0, lineStart) + open + doc.slice(lineStart, lineEnd) + '\n```' + doc.slice(lineEnd);
     return { doc: next, from: from + open.length, to: to + open.length };
 }
+/**
+ *
+ */
 export function applyMarkdownFormat(doc, from, to, kind) {
     if (kind === 'bold' || kind === 'italic' || kind === 'code' || kind === 'strike') {
         return toggleWrap(doc, from, to, WRAP[kind]);
@@ -165,10 +174,12 @@ export function findMediaImagesNeedingAlt(doc) {
     hits.sort((a, b) => a.from - b.from);
     return hits;
 }
-/** Concatenate a link node's text-child values. The parser has already unescaped them, so a source
+/**
+ * Concatenate a link node's text-child values. The parser has already unescaped them, so a source
  *  `Notes \[draft\]` yields `Notes [draft]`. Used instead of mdast-util-to-string, which is not a
  *  direct dependency. Non-text children (a nested emphasis, say) contribute no value, which is fine
- *  for the picker-produced links this fix targets. */
+ *  for the picker-produced links this fix targets.
+ */
 function linkText(node) {
     return node.children.map((c) => ('value' in c ? c.value : '')).join('');
 }
@@ -201,14 +212,18 @@ export function unwrapCairnLink(doc, href) {
     return out;
 }
 const FIGURE_ROLES = new Set(['center', 'wide', 'full']);
-/** Parse a doc with the figure-aware pipeline (the render step's grammar), so the editor transforms
- *  agree with what renders. Container directives need remark-directive on top of the markdown base. */
+/**
+ * Parse a doc with the figure-aware pipeline (the render step's grammar), so the editor transforms
+ *  agree with what renders. Container directives need remark-directive on top of the markdown base.
+ */
 function parseFigureDoc(doc) {
     return unified().use(remarkParse).use(remarkGfm).use(remarkDirective).parse(doc);
 }
-/** Find the media `image` node whose source range contains `pos`, or whose enclosing figure contains
+/**
+ * Find the media `image` node whose source range contains `pos`, or whose enclosing figure contains
  *  `pos`, along with its enclosing `figure` directive when there is one. Returns null when `pos` is
- *  not on a media image nor inside a figure that wraps one. */
+ *  not on a media image nor inside a figure that wraps one.
+ */
 function locateMediaImage(tree, pos) {
     let bareHit = null;
     let figureHit = null;
@@ -241,8 +256,10 @@ function locateMediaImage(tree, pos) {
     // A figure hit (the caret on the image or anywhere in its block) wins over a bare hit.
     return figureHit ?? bareHit;
 }
-/** The `figure`-named container directive that encloses `node`, or null. Walks the tree to find the
- *  ancestor, since unist-util-visit's per-call ancestors are not retained across the traversal. */
+/**
+ * The `figure`-named container directive that encloses `node`, or null. Walks the tree to find the
+ *  ancestor, since unist-util-visit's per-call ancestors are not retained across the traversal.
+ */
 function enclosingFigure(tree, target) {
     let found = null;
     visit(tree, 'containerDirective', (dir) => {
@@ -258,24 +275,30 @@ function enclosingFigure(tree, target) {
     });
     return found;
 }
-/** Strip one leading backslash sitting immediately before a colon, the inverse of the fence-escape
+/**
+ * Strip one leading backslash sitting immediately before a colon, the inverse of the fence-escape
  *  wrapImageInFigure/updateFigure apply, so a caption that began with a directive-opening colon run
- *  round-trips to the author's original text. */
+ *  round-trips to the author's original text.
+ */
 function unescapeCaption(raw) {
     return raw.replace(/^\\(?=:)/, '');
 }
-/** Collapse a raw caption source span to the single-line value the control edits: internal newlines
- *  to single spaces, trimmed, with the leading-colon fence escape stripped. */
+/**
+ * Collapse a raw caption source span to the single-line value the control edits: internal newlines
+ *  to single spaces, trimmed, with the leading-colon fence escape stripped.
+ */
 function finishCaption(raw) {
     return unescapeCaption(raw.replace(/\s*\n\s*/g, ' ').trim());
 }
-/** Read the raw caption source from a figure directive, mirroring the render step's caption: the first
+/**
+ * Read the raw caption source from a figure directive, mirroring the render step's caption: the first
  *  text-bearing content after the image. The render step (remark-figure.ts) handles both caption
  *  forms, so the read must too. In the no-blank-line form the caption shares the image's paragraph,
  *  trailing the token, so it is read from the token end to that block's end; in the blank-line form it
  *  is the first text-bearing block after the image's paragraph. Only the first such content is the
  *  caption (a later block is a stray paragraph the render leaves outside the figcaption). Empty when
- *  the figure has no caption. */
+ *  the figure has no caption.
+ */
 function readCaption(doc, figure, image) {
     const imageStart = image.position?.start?.offset;
     const imageEnd = image.position?.end?.offset;
@@ -307,8 +330,10 @@ function readCaption(doc, figure, image) {
     }
     return '';
 }
-/** Whether a block's subtree carries any non-whitespace text, the caption-candidate test the render
- *  step uses (a bare image paragraph has no text node, so it is never read as a caption). */
+/**
+ * Whether a block's subtree carries any non-whitespace text, the caption-candidate test the render
+ *  step uses (a bare image paragraph has no text node, so it is never read as a caption).
+ */
 function blockHasText(node) {
     let found = false;
     visit(node, 'text', (text) => {
@@ -343,18 +368,22 @@ export function figureAtImage(doc, pos) {
     const role = className && FIGURE_ROLES.has(className) ? className : null;
     return { imageFrom, imageTo, figure: { from, to, caption: readCaption(doc, dir, hit.image), role } };
 }
-/** Sanitize a caption into a single safe body line: collapse internal newlines to single spaces,
+/**
+ * Sanitize a caption into a single safe body line: collapse internal newlines to single spaces,
  *  trim, and neutralize ONLY the directive-fence hazard (a leading colon would open a directive at
  *  line start) by prefixing one backslash. The author's inline markdown is preserved otherwise, so
- *  emphasis and links survive. figureAtImage strips the backslash on read for a clean round-trip. */
+ *  emphasis and links survive. figureAtImage strips the backslash on read for a clean round-trip.
+ */
 function sanitizeCaption(caption) {
     const line = caption.replace(/\s*\n\s*/g, ' ').trim();
     return line.startsWith(':') ? '\\' + line : line;
 }
-/** Build the canonical figure block source: the opener (with the role brace only for a non-null
+/**
+ * Build the canonical figure block source: the opener (with the role brace only for a non-null
  *  role), the image token verbatim on its own line, then a blank line and the sanitized caption when
  *  the caption is non-empty, and the closing fence. This is the blank-line form remarkFigure reads as
- *  its primary path, and it reads cleanly when hand-edited. */
+ *  its primary path, and it reads cleanly when hand-edited.
+ */
 function buildFigureBlock(imageSrc, caption, role) {
     const opener = role ? `:::figure{.${role}}` : ':::figure';
     const cap = sanitizeCaption(caption);
@@ -382,9 +411,11 @@ export function wrapImageInFigure(doc, imageFrom, imageTo, caption, role) {
     const end = blockStart + block.length;
     return { doc: before + inserted + after, from: end, to: end };
 }
-/** The inner image token of the figure at `figureRange.from`, sliced verbatim from the source so it
+/**
+ * The inner image token of the figure at `figureRange.from`, sliced verbatim from the source so it
  *  is reused byte-for-byte (open risk 3). Empty when no media image is found there, which leaves the
- *  rebuild image-less rather than throwing. Shared by updateFigure and unwrapFigure. */
+ *  rebuild image-less rather than throwing. Shared by updateFigure and unwrapFigure.
+ */
 function figureImageSrc(doc, figureRange) {
     const info = figureAtImage(doc, figureRange.from);
     return info ? doc.slice(info.imageFrom, info.imageTo) : '';

package/dist/components/markdown-reference.d.ts

@@ -0,0 +1,8 @@
+/** One cheat-sheet row: the literal syntax, a plain gloss, and the group it belongs to. */
+export interface MarkdownReferenceRow {
+    syntax: string;
+    makes: string;
+    group: 'text' | 'links' | 'blocks';
+}
+/** The cheat-sheet vocabulary, everyday rows first: the five text, the four links, then the blocks. */
+export declare const markdownReference: MarkdownReferenceRow[];

package/dist/components/markdown-reference.js

@@ -0,0 +1,22 @@
+// The one Markdown cheat-sheet table, the single source the editor's Markdown help dialog and the
+// Help home both render, so the two surfaces cannot drift. Each row pairs the literal syntax an
+// author types with a plain gloss of what it makes, grouped so the Help home can show the everyday
+// rows (text and links) and the dialog can show every group. Mirrors editor-shortcuts.ts.
+/** The cheat-sheet vocabulary, everyday rows first: the five text, the four links, then the blocks. */
+export const markdownReference = [
+    { syntax: '## Heading', makes: 'A heading', group: 'text' },
+    { syntax: '**bold**', makes: 'Bold text', group: 'text' },
+    { syntax: '*italic*', makes: 'Italic text', group: 'text' },
+    { syntax: '> quote', makes: 'A quote', group: 'text' },
+    { syntax: '`code`', makes: 'Inline code', group: 'text' },
+    { syntax: '[text](url)', makes: 'A link', group: 'links' },
+    { syntax: '[[page-name]]', makes: 'A link to one of your pages', group: 'links' },
+    { syntax: '- item', makes: 'A bulleted list', group: 'links' },
+    { syntax: '1. item', makes: 'A numbered list', group: 'links' },
+    { syntax: '### Heading', makes: 'A smaller heading', group: 'blocks' },
+    { syntax: '#### Heading', makes: 'A fourth-level heading', group: 'blocks' },
+    { syntax: '~~text~~', makes: 'Crossed-out text', group: 'blocks' },
+    { syntax: '- [ ] item', makes: 'A checklist', group: 'blocks' },
+    { syntax: 'Table', makes: 'The Table button in the toolbar inserts one', group: 'blocks' },
+    { syntax: '---', makes: 'A horizontal rule', group: 'blocks' },
+];

package/dist/components/media-upload-outcome.d.ts

@@ -1,12 +1,16 @@
 import type { MediaEntry } from '../media/manifest.js';
 import type { UploadResult } from '../sveltekit/content-routes.js';
 import type { IngestFailureKind } from './client-ingest.js';
-/** A failure the card surfaces. The ingest taxonomy plus a `generic` catch-all for a refuse reason
- *  with no specific author-facing card (a binding-missing, a length-required, a parse miss). */
+/**
+ * A failure the card surfaces. The ingest taxonomy plus a `generic` catch-all for a refuse reason
+ *  with no specific author-facing card (a binding-missing, a length-required, a parse miss).
+ */
 export type UploadFailureKind = IngestFailureKind | 'generic';
-/** The outcome the popover acts on. `inserted` swaps the placeholder for the reference and records
+/**
+ * The outcome the popover acts on. `inserted` swaps the placeholder for the reference and records
  *  the entry; `failed` cancels the placeholder and shows the typed card; `session-expired` cancels
- *  the placeholder and tells the author to sign in again. */
+ *  the placeholder and tells the author to sign in again.
+ */
 export type UploadOutcome = {
     kind: 'inserted';
     reference: string;
@@ -18,10 +22,12 @@ export type UploadOutcome = {
 } | {
     kind: 'session-expired';
 };
-/** The shape the popover hands in: either a parsed SvelteKit action result (success or failure) or a
+/**
+ * The shape the popover hands in: either a parsed SvelteKit action result (success or failure) or a
  *  bare response signal for the redirect and network-error cases. The popover deserializes the body
  *  for the success and failure cases and passes the raw `response.type`/`response.status` for the
- *  redirect case, so this one mapper covers every branch. */
+ *  redirect case, so this one mapper covers every branch.
+ */
 export type UploadEnvelope = {
     type: 'success';
     status?: number;

package/dist/components/objective-errors.d.ts

@@ -1,15 +1,19 @@
 import type { Range } from './spellcheck.js';
 /** The three objective-error kinds, each its own check. */
 export type ObjectiveErrorKind = 'doubled-word' | 'double-space' | 'repeated-punct';
-/** A single deterministic edit that resolves one finding: replace [from, to) with `insert`. The lint
- *  source turns this into the diagnostic's quick-fix action. */
+/**
+ * A single deterministic edit that resolves one finding: replace [from, to) with `insert`. The lint
+ *  source turns this into the diagnostic's quick-fix action.
+ */
 export interface ObjectiveFix {
     from: number;
     to: number;
     insert: string;
 }
-/** One objective-error finding: the flagged range a reader sees underlined, the error kind, a plain
- *  message, and the one-edit fix. */
+/**
+ * One objective-error finding: the flagged range a reader sees underlined, the error kind, a plain
+ *  message, and the one-edit fix.
+ */
 export interface ObjectiveError {
     kind: ObjectiveErrorKind;
     /** The flagged range (absolute document offsets), the span the underline covers. */

package/dist/components/objective-errors.js

@@ -20,14 +20,18 @@ const DOUBLE_SPACE = /[^\s] ( +)/g;
 // a single mark is correct, two or more of these three is plainly a typo. A mixed run ("?!") is not
 // flagged because it is a legitimate construction; only a run of one identical mark counts.
 const REPEATED_PUNCT = /([!?,])\1+/g;
-/** Whether two matched word strings are the same word, case-insensitively. Both are already plain
- *  word runs from the same WORD pattern, so a locale-insensitive lowercase compare is enough. */
+/**
+ * Whether two matched word strings are the same word, case-insensitively. Both are already plain
+ *  word runs from the same WORD pattern, so a locale-insensitive lowercase compare is enough.
+ */
 function sameWord(a, b) {
     return a.toLowerCase() === b.toLowerCase();
 }
-/** Run the three objective checks over one prose span [from, to), returning every finding with an
+/**
+ * Run the three objective checks over one prose span [from, to), returning every finding with an
  *  absolute range and fix. The doubled-word check is bounded to this span so a repeat that straddles
- *  a skipped region is never matched. */
+ *  a skipped region is never matched.
+ */
 function checkSpan(text, from, to) {
     const out = [];
     const slice = text.slice(from, to);

package/dist/components/preview-doc.d.ts

@@ -13,8 +13,10 @@ export type PreviewDeviceId = PreviewDevice['id'];
 export declare const previewDevices: PreviewDevice[];
 /** The table row for a device id. The id type makes a miss impossible; the fallback satisfies find. */
 export declare function previewDevice(id: PreviewDeviceId): PreviewDevice;
-/** A device's user-facing text, shared by the toolbar's menu items and the frame caption: the
- *  label with its width when one is fixed, so the value reaches assistive tech at pick time. */
+/**
+ * A device's user-facing text, shared by the toolbar's menu items and the frame caption: the
+ *  label with its width when one is fixed, so the value reaches assistive tech at pick time.
+ */
 export declare function deviceLabel(d: PreviewDevice): string;
 /**
  * Build the preview iframe's srcdoc: a complete document linking the site's stylesheets around

package/dist/components/preview-doc.js

@@ -15,8 +15,10 @@ export const previewDevices = [
 export function previewDevice(id) {
     return previewDevices.find((d) => d.id === id) ?? previewDevices[0];
 }
-/** A device's user-facing text, shared by the toolbar's menu items and the frame caption: the
- *  label with its width when one is fixed, so the value reaches assistive tech at pick time. */
+/**
+ * A device's user-facing text, shared by the toolbar's menu items and the frame caption: the
+ *  label with its width when one is fixed, so the value reaches assistive tech at pick time.
+ */
 export function deviceLabel(d) {
     return d.width === null ? d.label : `${d.label} · ${d.width} px`;
 }