@glw907/cairn-cms 0.60.1 → 0.62.1

package/dist/components/HelpHome.svelte.d.ts

@@ -0,0 +1,22 @@
+import type { HelpData } from '../sveltekit/content-routes.js';
+type $$ComponentProps = {
+    data: HelpData;
+};
+/**
+ * The Help home admin screen, the standing place an author comes to get their bearings and look up
+ * how things work. It renders inside `AdminLayout` (the office shell), so it carries no `data-theme`
+ * wrapper and imports no CSS: the layout owns the theme and `cairn-admin.css`, and this component
+ * consumes the Warm Stone tokens through its scoped `<style>` block.
+ *
+ * The content is one calm column: a masthead, then three co-equal eyebrow-plus-display sections.
+ *
+ * - Getting started reads `data.gettingStarted`, the count derived from the committed manifest and
+ *   the open edit branches (never a stored count). At 3 of 3 the whole section is omitted, never
+ *   shown as a done checklist. A per-device localStorage flag hides it on request.
+ * - Formatting renders `data.reference` (the everyday text and links rows) as a real semantic table.
+ * - Get help reads the optional `data.supportContact`. Unset is the canonical self-serve default,
+ *   with no control; set renders the hand-off shaped by the contact (email, URL, or a note).
+ */
+declare const HelpHome: import("svelte").Component<$$ComponentProps, {}, "">;
+type HelpHome = ReturnType<typeof HelpHome>;
+export default HelpHome;

package/dist/components/MarkdownHelpDialog.svelte

@@ -6,6 +6,7 @@ Built on a native <dialog>, the DeleteDialog recipe; the host drives it through
 open(), so the component renders no trigger of its own.
 -->
 <script lang="ts">import ShortcutsGrid from "./ShortcutsGrid.svelte";
+import { markdownReference } from "./markdown-reference.js";
 let dialog = $state(null);
 export function open() {
   dialog?.showModal();
@@ -29,21 +30,9 @@ function close() {
         </tr>
       </thead>
       <tbody>
-        <tr><td><code>## Heading</code></td><td>A heading</td></tr>
-        <tr><td><code>### Heading</code></td><td>A smaller heading</td></tr>
-        <tr><td><code>#### Heading</code></td><td>A fourth-level heading</td></tr>
-        <tr><td><code>**bold**</code></td><td>Bold text</td></tr>
-        <tr><td><code>*italic*</code></td><td>Italic text</td></tr>
-        <tr><td><code>~~text~~</code></td><td>Crossed-out text</td></tr>
-        <tr><td><code>[text](url)</code></td><td>A link</td></tr>
-        <tr><td><code>[[page-name]]</code></td><td>A link to one of your pages</td></tr>
-        <tr><td><code>- item</code></td><td>A bulleted list</td></tr>
-        <tr><td><code>1. item</code></td><td>A numbered list</td></tr>
-        <tr><td><code>- [ ] item</code></td><td>A checklist</td></tr>
-        <tr><td><code>&gt; quote</code></td><td>A quote</td></tr>
-        <tr><td><code>`code`</code></td><td>Code</td></tr>
-        <tr><td>Table</td><td>The Table button in the toolbar inserts one</td></tr>
-        <tr><td><code>---</code></td><td>A horizontal rule</td></tr>
+        {#each markdownReference as row (row.syntax)}
+          <tr><td><code>{row.syntax}</code></td><td>{row.makes}</td></tr>
+        {/each}
       </tbody>
     </table>
     <h3 class="mt-4 mb-2 text-sm font-semibold">Keyboard shortcuts</h3>

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;

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`