@threadlabs/looma 0.28.15 → 0.28.17

package/editor/extensions/callout.d.ts

@@ -1,11 +1,6 @@
 import { Node } from "@tiptap/core";
-/**
- * Canonical tone values that may be persisted in a Looma callout node: the shared block
- * vocabulary of Callout, Markdown `:::` containers and GitHub alerts.
- */
-export declare const LOOMA_CALLOUT_TONES: readonly ["note", "tip", "info", "important", "warning", "danger"];
-/** A serialized callout tone; unsupported input is normalized to `note`. */
-export type LoomaCalloutTone = (typeof LOOMA_CALLOUT_TONES)[number];
+import { LOOMA_CALLOUT_TONES, normalizeLoomaCalloutTone, type LoomaCalloutTone } from "../../markdown/index.js";
+export { LOOMA_CALLOUT_TONES, normalizeLoomaCalloutTone, type LoomaCalloutTone };
 declare module "@tiptap/core" {
     interface Commands<ReturnType> {
         loomaCallout: {
@@ -14,8 +9,6 @@ declare module "@tiptap/core" {
         };
     }
 }
-/** Maps a tone name, alias, or unknown value onto a persisted tone. */
-export declare function normalizeLoomaCalloutTone(value: unknown): LoomaCalloutTone;
 /**
  * A durable block container for informational editor content, saved as Looma's Callout.
  *

package/editor/extensions/chip.d.ts

@@ -1,8 +1,9 @@
 import { Node } from "@tiptap/core";
-/** The six palette values a chip may persist; other values fall back to neutral. */
+import { type LoomaChipTone } from "../../markdown/index.js";
+/** The six palette values a chip may persist, Looma Markdown's chip tones; other values fall back to neutral. */
 export declare const LOOMA_CHIP_COLORS: readonly ["neutral", "blue", "green", "yellow", "red", "purple"];
 /** A persisted chip color shared by the headless extension and its editor UI. */
-export type LoomaChipColor = typeof LOOMA_CHIP_COLORS[number];
+export type LoomaChipColor = LoomaChipTone;
 /** Keep imported or programmatic colors within the supported palette. */
 export declare function normalizeLoomaChipColor(value: unknown): LoomaChipColor;
 declare module "@tiptap/core" {

package/editor/extensions/figure.d.ts

@@ -0,0 +1,12 @@
+import { Node } from "@tiptap/core";
+/**
+ * An image with a caption, saved as `<figure><img><figcaption>` and written in Looma Markdown as
+ * `::: figure Caption`. The caption is inline content the author edits in place.
+ * @invariant A figure holds exactly one block image and one caption; an empty caption stays empty.
+ */
+export declare const LoomaFigure: Node<any, any>;
+/**
+ * A figure's caption: inline content under its image.
+ * @invariant It exists only as the second child of `LoomaFigure`.
+ */
+export declare const LoomaFigcaption: Node<any, any>;

package/editor/extensions/index.d.ts

@@ -10,6 +10,8 @@ export { LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, LOOMA_ACTIVE_BLOCK_CLASS, LOOMA_ACTIV
 export { LoomaCallout, LOOMA_CALLOUT_TONES, type LoomaCalloutTone, } from "./callout.js";
 export { LoomaChip, LOOMA_CHIP_COLORS, normalizeLoomaChipColor, type LoomaChipColor } from "./chip.js";
 export { LoomaExpand, revealLoomaExpandAt, type LoomaExpandAttributes } from "./expand.js";
+export { LoomaFigcaption, LoomaFigure } from "./figure.js";
+export { LoomaTab, LoomaTabs } from "./tabs.js";
 export { LoomaTableOfContents, getTableOfContentsEntries, normalizeTableOfContentsConfig, type LoomaTableOfContentsConfig, type LoomaTableOfContentsEntry, type LoomaTableOfContentsFormat, } from "./table-of-contents.js";
 export { getDefaultEditorExtensions, getLoomaTableExtensions, LoomaTableKit, type DefaultEditorExtensionsOptions, type LoomaCodeLanguages, } from "./preset.js";
 export { LoomaSmartPaste } from "./smart-paste.js";

package/editor/extensions/index.js

@@ -1,3 +1,3 @@
 import { n as TABLE_CELL_BACKGROUND_PRESETS } from "../chunks/table-backgrounds.js";
-import { A as filterLoomaMentionItems, B as LOOMA_CHIP_COLORS, C as loomaMarkdownToHtml, D as createLoomaMentionExtension, E as LoomaMentionSuggestionPluginKey, F as LoomaTableOfContents, G as LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, H as normalizeLoomaChipColor, I as getTableOfContentsEntries, J as LoomaActiveBlock, K as LOOMA_ACTIVE_BLOCK_CLASS, L as normalizeTableOfContentsConfig, M as LoomaImage, N as normalizeImageDimension, O as DEFAULT_MENTION_RESULT_LIMIT, P as normalizeImagePlacement, R as LoomaExpand, S as loomaMarkdownFromDoc, T as siteRelativeHref, U as LOOMA_CALLOUT_TONES, V as LoomaChip, W as LoomaCallout, Y as LoomaActiveBlockPluginKey, _ as getActiveTableCellAlignment, a as getActiveTableUiState, b as setActiveTableCellBackground, c as insertTableAtRange, d as LoomaTableKit, f as getDefaultEditorExtensions, g as LoomaTableHeader, h as LoomaTableCell, i as getDefaultSlashCommands, j as normalizeMentionResultLimit, k as MAX_MENTION_RESULT_LIMIT, l as normalizeActiveTableColumnWidths, m as LoomaTable, n as createLoomaSlashCommandExtension, o as handleTableAction, p as getLoomaTableExtensions, q as LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, r as filterLoomaSlashCommands, s as handleTableOverlayAction, t as LoomaSlashCommand, u as shouldShowTextFormattingToolbar, v as getActiveTableCellBackground, w as createSiteRelativeLinks, x as LoomaSmartPaste, y as setActiveTableCellAlignment, z as revealLoomaExpandAt } from "../chunks/extensions.js";
-export { DEFAULT_MENTION_RESULT_LIMIT, LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, LOOMA_ACTIVE_BLOCK_CLASS, LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, LOOMA_CALLOUT_TONES, LOOMA_CHIP_COLORS, LoomaActiveBlock, LoomaActiveBlockPluginKey, LoomaCallout, LoomaChip, LoomaExpand, LoomaImage, LoomaMentionSuggestionPluginKey, LoomaSlashCommand, LoomaSmartPaste, LoomaTable, LoomaTableCell, LoomaTableHeader, LoomaTableKit, LoomaTableOfContents, MAX_MENTION_RESULT_LIMIT, TABLE_CELL_BACKGROUND_PRESETS, createLoomaMentionExtension, createLoomaSlashCommandExtension, createSiteRelativeLinks, filterLoomaMentionItems, filterLoomaSlashCommands, getActiveTableCellAlignment, getActiveTableCellBackground, getActiveTableUiState, getDefaultEditorExtensions, getDefaultSlashCommands, getLoomaTableExtensions, getTableOfContentsEntries, handleTableAction, handleTableOverlayAction, insertTableAtRange, loomaMarkdownFromDoc, loomaMarkdownToHtml, normalizeActiveTableColumnWidths, normalizeImageDimension, normalizeImagePlacement, normalizeLoomaChipColor, normalizeMentionResultLimit, normalizeTableOfContentsConfig, revealLoomaExpandAt, setActiveTableCellAlignment, setActiveTableCellBackground, shouldShowTextFormattingToolbar, siteRelativeHref };
+import { $ as LoomaActiveBlockPluginKey, A as filterLoomaMentionItems, B as LoomaFigcaption, C as loomaMarkdownToHtml, D as createLoomaMentionExtension, E as LoomaMentionSuggestionPluginKey, F as LoomaTableOfContents, G as LoomaChip, H as LoomaExpand, I as getTableOfContentsEntries, J as LOOMA_CALLOUT_TONES, K as normalizeLoomaChipColor, L as normalizeTableOfContentsConfig, M as LoomaImage, N as normalizeImageDimension, O as DEFAULT_MENTION_RESULT_LIMIT, P as normalizeImagePlacement, Q as LoomaActiveBlock, R as LoomaTab, S as loomaMarkdownFromDoc, T as siteRelativeHref, U as revealLoomaExpandAt, V as LoomaFigure, W as LOOMA_CHIP_COLORS, X as LOOMA_ACTIVE_BLOCK_CLASS, Y as LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, Z as LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, _ as getActiveTableCellAlignment, a as getActiveTableUiState, b as setActiveTableCellBackground, c as insertTableAtRange, d as LoomaTableKit, f as getDefaultEditorExtensions, g as LoomaTableHeader, h as LoomaTableCell, i as getDefaultSlashCommands, j as normalizeMentionResultLimit, k as MAX_MENTION_RESULT_LIMIT, l as normalizeActiveTableColumnWidths, m as LoomaTable, n as createLoomaSlashCommandExtension, o as handleTableAction, p as getLoomaTableExtensions, q as LoomaCallout, r as filterLoomaSlashCommands, s as handleTableOverlayAction, t as LoomaSlashCommand, u as shouldShowTextFormattingToolbar, v as getActiveTableCellBackground, w as createSiteRelativeLinks, x as LoomaSmartPaste, y as setActiveTableCellAlignment, z as LoomaTabs } from "../chunks/extensions.js";
+export { DEFAULT_MENTION_RESULT_LIMIT, LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, LOOMA_ACTIVE_BLOCK_CLASS, LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, LOOMA_CALLOUT_TONES, LOOMA_CHIP_COLORS, LoomaActiveBlock, LoomaActiveBlockPluginKey, LoomaCallout, LoomaChip, LoomaExpand, LoomaFigcaption, LoomaFigure, LoomaImage, LoomaMentionSuggestionPluginKey, LoomaSlashCommand, LoomaSmartPaste, LoomaTab, LoomaTable, LoomaTableCell, LoomaTableHeader, LoomaTableKit, LoomaTableOfContents, LoomaTabs, MAX_MENTION_RESULT_LIMIT, TABLE_CELL_BACKGROUND_PRESETS, createLoomaMentionExtension, createLoomaSlashCommandExtension, createSiteRelativeLinks, filterLoomaMentionItems, filterLoomaSlashCommands, getActiveTableCellAlignment, getActiveTableCellBackground, getActiveTableUiState, getDefaultEditorExtensions, getDefaultSlashCommands, getLoomaTableExtensions, getTableOfContentsEntries, handleTableAction, handleTableOverlayAction, insertTableAtRange, loomaMarkdownFromDoc, loomaMarkdownToHtml, normalizeActiveTableColumnWidths, normalizeImageDimension, normalizeImagePlacement, normalizeLoomaChipColor, normalizeMentionResultLimit, normalizeTableOfContentsConfig, revealLoomaExpandAt, setActiveTableCellAlignment, setActiveTableCellBackground, shouldShowTextFormattingToolbar, siteRelativeHref };

package/editor/extensions/markdown.d.ts

@@ -1,18 +1,16 @@
-import MarkdownIt from "markdown-it";
 import { type Node as ProseMirrorNode } from "@tiptap/pm/model";
-/** The markdown-it instance LoomaEditor imports Markdown with, shared block vocabulary included. */
-export declare const loomaMarkdown: MarkdownIt;
+/** The markdown-it instance LoomaEditor reads Looma Markdown with. */
+export declare const loomaMarkdown: import("markdown-it").default;
 /**
- * Renders Markdown, including the shared block vocabulary, as HTML the editor parses.
+ * Renders Looma Markdown as the HTML the editor parses.
  * @contract The result is not sanitized; pass it to the editor's `setContent`, whose schema
- * keeps only content it knows.
+ * keeps only content it knows. Front matter renders nothing.
  */
 export declare function loomaMarkdownToHtml(source: string): string;
 /**
- * Writes an editor document as Markdown, with callouts and expand sections in the shared
- * `:::` syntax that `loomaMarkdownToHtml` and Markupress read.
- * @contract Content Markdown has no syntax for (tables, task lists, images, chips, mentions,
- * the table of contents) is written as its saved HTML, which Markdown carries unchanged.
- * Marks without a Markdown form other than underline and highlight are dropped.
+ * Writes an editor document as Looma Markdown, the form `loomaMarkdownToHtml` and Markupress read.
+ * @contract Every node in the default preset has a Markdown form. A table that fits GFM is a GFM
+ * table and any other is HTML. Content from extensions outside the preset is written as its saved
+ * HTML, and marks without a Markdown form other than underline and highlight are dropped.
  */
 export declare function loomaMarkdownFromDoc(doc: ProseMirrorNode): string;

package/editor/extensions/table-of-contents.d.ts

@@ -10,7 +10,7 @@ export interface LoomaTableOfContentsConfig {
 /**
  * One current heading for navigation or host projections.
  * @lifecycle Positions belong to the supplied document; recompute after edits.
- * IDs stay with headings across renames and moves once a TOC assigns anchors.
+ * An ID derived from a heading's text follows the text; a custom ID stays with its heading.
  */
 export interface LoomaTableOfContentsEntry {
     id: string;

package/editor/extensions/tabs.d.ts

@@ -0,0 +1,13 @@
+import { Node } from "@tiptap/core";
+/**
+ * Tabs or a code group, kept whole so Looma Markdown's `::: tabs` and `::: code-group` survive
+ * editing. Saved as `<ui-tabs group>` with a `<section aria-label>` per panel.
+ * @contract While editing, panels show one after another under their labels; the Tabs component
+ * draws them only where the saved HTML renders.
+ */
+export declare const LoomaTabs: Node<any, any>;
+/**
+ * One panel of `LoomaTabs`, labelled by `label`.
+ * @invariant It exists only inside `LoomaTabs`; its label is the tab Tabs shows and the `== Label` line Markdown writes.
+ */
+export declare const LoomaTab: Node<any, any>;

package/editor/index.js

@@ -1,6 +1,6 @@
 import { n as TABLE_CELL_BACKGROUND_PRESETS, t as TABLE_CELL_BACKGROUND_OPTIONS } from "./chunks/table-backgrounds.js";
 import { n as resolveTableCellAt, t as measureTableOverlayGeometry } from "./chunks/ui.js";
-import { A as filterLoomaMentionItems, B as LOOMA_CHIP_COLORS, C as loomaMarkdownToHtml, D as createLoomaMentionExtension, E as LoomaMentionSuggestionPluginKey, F as LoomaTableOfContents, G as LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, H as normalizeLoomaChipColor, I as getTableOfContentsEntries, J as LoomaActiveBlock, K as LOOMA_ACTIVE_BLOCK_CLASS, L as normalizeTableOfContentsConfig, M as LoomaImage, N as normalizeImageDimension, O as DEFAULT_MENTION_RESULT_LIMIT, P as normalizeImagePlacement, R as LoomaExpand, S as loomaMarkdownFromDoc, T as siteRelativeHref, U as LOOMA_CALLOUT_TONES, V as LoomaChip, W as LoomaCallout, Y as LoomaActiveBlockPluginKey, _ as getActiveTableCellAlignment, a as getActiveTableUiState, b as setActiveTableCellBackground, c as insertTableAtRange, d as LoomaTableKit, f as getDefaultEditorExtensions, g as LoomaTableHeader, h as LoomaTableCell, i as getDefaultSlashCommands, j as normalizeMentionResultLimit, k as MAX_MENTION_RESULT_LIMIT, l as normalizeActiveTableColumnWidths, m as LoomaTable, n as createLoomaSlashCommandExtension, o as handleTableAction, p as getLoomaTableExtensions, q as LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, r as filterLoomaSlashCommands, s as handleTableOverlayAction, t as LoomaSlashCommand, u as shouldShowTextFormattingToolbar, v as getActiveTableCellBackground, w as createSiteRelativeLinks, x as LoomaSmartPaste, y as setActiveTableCellAlignment, z as revealLoomaExpandAt } from "./chunks/extensions.js";
+import { $ as LoomaActiveBlockPluginKey, A as filterLoomaMentionItems, B as LoomaFigcaption, C as loomaMarkdownToHtml, D as createLoomaMentionExtension, E as LoomaMentionSuggestionPluginKey, F as LoomaTableOfContents, G as LoomaChip, H as LoomaExpand, I as getTableOfContentsEntries, J as LOOMA_CALLOUT_TONES, K as normalizeLoomaChipColor, L as normalizeTableOfContentsConfig, M as LoomaImage, N as normalizeImageDimension, O as DEFAULT_MENTION_RESULT_LIMIT, P as normalizeImagePlacement, Q as LoomaActiveBlock, R as LoomaTab, S as loomaMarkdownFromDoc, T as siteRelativeHref, U as revealLoomaExpandAt, V as LoomaFigure, W as LOOMA_CHIP_COLORS, X as LOOMA_ACTIVE_BLOCK_CLASS, Y as LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, Z as LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, _ as getActiveTableCellAlignment, a as getActiveTableUiState, b as setActiveTableCellBackground, c as insertTableAtRange, d as LoomaTableKit, f as getDefaultEditorExtensions, g as LoomaTableHeader, h as LoomaTableCell, i as getDefaultSlashCommands, j as normalizeMentionResultLimit, k as MAX_MENTION_RESULT_LIMIT, l as normalizeActiveTableColumnWidths, m as LoomaTable, n as createLoomaSlashCommandExtension, o as handleTableAction, p as getLoomaTableExtensions, q as LoomaCallout, r as filterLoomaSlashCommands, s as handleTableOverlayAction, t as LoomaSlashCommand, u as shouldShowTextFormattingToolbar, v as getActiveTableCellBackground, w as createSiteRelativeLinks, x as LoomaSmartPaste, y as setActiveTableCellAlignment, z as LoomaTabs } from "./chunks/extensions.js";
 import { AlignCenter, AlignLeft, AlignRight, ArrowLeft, Bell, Bold, BookUser, Braces, Calculator, Check, ChevronDown, ChevronLeft, ChevronRight, CircleCheck, CircleDot, CircleQuestionMark, CircleX, CodeXml, Columns3, Compass, CreditCard, Ellipsis, Eraser, ExternalLink, FileText, Folder, GripHorizontal, GripVertical, Heading1, Heading2, Heading3, Highlighter, History, Image, Info, Italic, LayoutDashboard, Lightbulb, Link, List, ListOrdered, ListTodo, LoaderCircle, Merge, MessageSquareWarning, Minus, NotebookPen, PaintBucket, PanelBottom, PanelLeft, PanelRight, PanelTop, Pencil, Pilcrow, Plus, Quote, Receipt, Redo2, Rows3, Search, Settings, Split, Strikethrough, Table2, Tag, Trash2, TriangleAlert, Truck, Underline, Undo2, Unlink, UserRound, Users, X } from "lucide";
 //#region src/editor/icons.ts
 /** The opinionated Lucide set used by Looma's shipped interaction surfaces. */
@@ -123,4 +123,4 @@ function getVisualViewportRect(owner = window) {
 	};
 }
 //#endregion
-export { DEFAULT_MENTION_RESULT_LIMIT, LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, LOOMA_ACTIVE_BLOCK_CLASS, LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, LOOMA_CALLOUT_TONES, LOOMA_CHIP_COLORS, LOOMA_ICONS, LoomaActiveBlock, LoomaActiveBlockPluginKey, LoomaCallout, LoomaChip, LoomaExpand, LoomaImage, LoomaMentionSuggestionPluginKey, LoomaSlashCommand, LoomaSmartPaste, LoomaTable, LoomaTableCell, LoomaTableHeader, LoomaTableKit, LoomaTableOfContents, MAX_MENTION_RESULT_LIMIT, TABLE_CELL_BACKGROUND_OPTIONS, TABLE_CELL_BACKGROUND_PRESETS, createLoomaMentionExtension, createLoomaSlashCommandExtension, createSiteRelativeLinks, filterLoomaMentionItems, filterLoomaSlashCommands, getActiveTableCellAlignment, getActiveTableCellBackground, getActiveTableUiState, getDefaultEditorExtensions, getDefaultSlashCommands, getLoomaTableExtensions, getTableOfContentsEntries, getVisualViewportRect, handleTableAction, handleTableOverlayAction, insertTableAtRange, loomaIconMarkup, loomaMarkdownFromDoc, loomaMarkdownToHtml, measureTableOverlayGeometry, normalizeActiveTableColumnWidths, normalizeImageDimension, normalizeImagePlacement, normalizeLoomaChipColor, normalizeMentionResultLimit, normalizeTableOfContentsConfig, resolveTableCellAt, revealLoomaExpandAt, setActiveTableCellAlignment, setActiveTableCellBackground, shouldShowTextFormattingToolbar, siteRelativeHref };
+export { DEFAULT_MENTION_RESULT_LIMIT, LOOMA_ACTIVE_BLOCK_BLUR_GRACE_MS, LOOMA_ACTIVE_BLOCK_CLASS, LOOMA_ACTIVE_BLOCK_TYPING_IDLE_MS, LOOMA_CALLOUT_TONES, LOOMA_CHIP_COLORS, LOOMA_ICONS, LoomaActiveBlock, LoomaActiveBlockPluginKey, LoomaCallout, LoomaChip, LoomaExpand, LoomaFigcaption, LoomaFigure, LoomaImage, LoomaMentionSuggestionPluginKey, LoomaSlashCommand, LoomaSmartPaste, LoomaTab, LoomaTable, LoomaTableCell, LoomaTableHeader, LoomaTableKit, LoomaTableOfContents, LoomaTabs, MAX_MENTION_RESULT_LIMIT, TABLE_CELL_BACKGROUND_OPTIONS, TABLE_CELL_BACKGROUND_PRESETS, createLoomaMentionExtension, createLoomaSlashCommandExtension, createSiteRelativeLinks, filterLoomaMentionItems, filterLoomaSlashCommands, getActiveTableCellAlignment, getActiveTableCellBackground, getActiveTableUiState, getDefaultEditorExtensions, getDefaultSlashCommands, getLoomaTableExtensions, getTableOfContentsEntries, getVisualViewportRect, handleTableAction, handleTableOverlayAction, insertTableAtRange, loomaIconMarkup, loomaMarkdownFromDoc, loomaMarkdownToHtml, measureTableOverlayGeometry, normalizeActiveTableColumnWidths, normalizeImageDimension, normalizeImagePlacement, normalizeLoomaChipColor, normalizeMentionResultLimit, normalizeTableOfContentsConfig, resolveTableCellAt, revealLoomaExpandAt, setActiveTableCellAlignment, setActiveTableCellBackground, shouldShowTextFormattingToolbar, siteRelativeHref };

package/markdown/fixtures.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Looma Markdown's conformance fixtures and the HTML normalizer that compares renderings of them.
+ * Every reader and writer runs the same cases: LoomaEditor's round-trip suite, renderers and
+ * applications that store Looma Markdown.
+ */
+/** One conformance case: Markdown in, canonical HTML out, and the Markdown a writer produces. */
+export interface LoomaMarkdownFixture {
+    /** The folder, named after a row of the spec's Support table. */
+    feature: string;
+    name: string;
+    markdown: string;
+    /** The canonical HTML: what LoomaEditor saves and the markdown-it plugin renders. */
+    html: string;
+    /** What a writer produces from the document; the input itself when the case has no `case.canonical.md`. */
+    canonical: string;
+}
+/** Every conformance case, ordered by feature and name. */
+export declare const LOOMA_MARKDOWN_FIXTURES: readonly LoomaMarkdownFixture[];
+/**
+ * Normalizes HTML so two renderings of a fixture compare as strings.
+ * @contract Sorts attributes, writes empty attributes bare, collapses whitespace outside `pre` and
+ * drops it at block edges, and unwraps renderer presentation (heading self-links, the code
+ * `figure.code` wrapper and its actions, markup inside code).
+ * @ownership Uses the supplied document, or the global one when a DOM is present; it never reads
+ * the DOM at import.
+ */
+export declare function normalizeLoomaHtml(html: string, document?: Document): string;

package/markdown/fixtures.js

@@ -0,0 +1,224 @@
+//#endregion
+//#region src/markdown/fixtures.ts
+var files = /* #__PURE__ */ Object.assign({
+	"../../markdown-fixtures/autolinks/bare.canonical.md": "Read <https://example.com/docs> and [www.example.com](http://www.example.com), or <https://example.com/start>.\n",
+	"../../markdown-fixtures/autolinks/bare.html": "<p>Read <a href=\"https://example.com/docs\">https://example.com/docs</a> and <a href=\"http://www.example.com\">www.example.com</a>, or <a href=\"https://example.com/start\">https://example.com/start</a>.</p>\n",
+	"../../markdown-fixtures/autolinks/bare.md": "Read https://example.com/docs and www.example.com, or <https://example.com/start>.\n",
+	"../../markdown-fixtures/callouts/alert.canonical.md": "::: warning\nDeletes data.\n:::\n",
+	"../../markdown-fixtures/callouts/alert.html": "<ui-callout tone=\"warning\">\n<p>Deletes data.</p>\n</ui-callout>\n",
+	"../../markdown-fixtures/callouts/alert.md": "> [!WARNING]\n> Deletes data.\n",
+	"../../markdown-fixtures/callouts/caution-alias.canonical.md": "::: danger Stop\nThis cannot be undone.\n:::\n",
+	"../../markdown-fixtures/callouts/caution-alias.html": "<ui-callout tone=\"danger\" heading=\"Stop\">\n<p>This cannot be undone.</p>\n</ui-callout>\n",
+	"../../markdown-fixtures/callouts/caution-alias.md": "::: CAUTION Stop\nThis cannot be undone.\n:::\n",
+	"../../markdown-fixtures/callouts/open-in-title.html": "<ui-callout tone=\"tip\" heading=\"Keep {open}\">\n<p>A callout title keeps its braces.</p>\n</ui-callout>\n",
+	"../../markdown-fixtures/callouts/open-in-title.md": "::: tip Keep {open}\nA callout title keeps its braces.\n:::\n",
+	"../../markdown-fixtures/callouts/titled.html": "<ui-callout tone=\"tip\" heading=\"Before you start\">\n<p>Install <strong>first</strong>.</p>\n</ui-callout>\n",
+	"../../markdown-fixtures/callouts/titled.md": "::: tip Before you start\nInstall **first**.\n:::\n",
+	"../../markdown-fixtures/chips/escaped-label.html": "<p><span data-looma-chip data-label=\"Draft ] v2\" data-color=\"red\">Draft ] v2</span></p>\n",
+	"../../markdown-fixtures/chips/escaped-label.md": ":chip[Draft \\] v2]{tone=red}\n",
+	"../../markdown-fixtures/chips/tones.html": "<p>Status <span data-looma-chip data-label=\"Ready\" data-color=\"green\">Ready</span> and <span data-looma-chip data-label=\"Draft\" data-color=\"neutral\">Draft</span>.</p>\n",
+	"../../markdown-fixtures/chips/tones.md": "Status :chip[Ready]{tone=green} and :chip[Draft].\n",
+	"../../markdown-fixtures/code-blocks/fences.canonical.md": "```ts\nconst answer = 42;\n```\n\n```\nplain text\n```\n\n```\nindented\n```\n",
+	"../../markdown-fixtures/code-blocks/fences.html": "<pre><code class=\"language-ts\">const answer = 42;</code></pre>\n<pre><code>plain text</code></pre>\n<pre><code>indented</code></pre>\n",
+	"../../markdown-fixtures/code-blocks/fences.md": "```ts\nconst answer = 42;\n```\n\n```\nplain text\n```\n\n    indented\n",
+	"../../markdown-fixtures/code-blocks/long-fence.html": "<pre><code class=\"language-md\">```ts\nconst a = 1;\n```</code></pre>\n",
+	"../../markdown-fixtures/code-blocks/long-fence.md": "````md\n```ts\nconst a = 1;\n```\n````\n",
+	"../../markdown-fixtures/code-meta/notation.html": "<pre><code class=\"language-ts\">const port = 8080; // [!code highlight]</code></pre>\n",
+	"../../markdown-fixtures/code-meta/notation.md": "```ts\nconst port = 8080; // [!code highlight]\n```\n",
+	"../../markdown-fixtures/code-meta/title-lines.html": "<pre><code class=\"language-ts\" data-meta=\"title=&quot;config.ts&quot; {1,3-4} :line-numbers\">export default {\n  name: &quot;docs&quot;,\n  base: &quot;/docs/&quot;,\n};</code></pre>\n",
+	"../../markdown-fixtures/code-meta/title-lines.md": "```ts title=\"config.ts\" {1,3-4} :line-numbers\nexport default {\n  name: \"docs\",\n  base: \"/docs/\",\n};\n```\n",
+	"../../markdown-fixtures/containers/escaped-marker.html": "<p>::: tip is text here</p>\n",
+	"../../markdown-fixtures/containers/escaped-marker.md": "\\::: tip is text here\n",
+	"../../markdown-fixtures/containers/fence-inside.html": "<ui-callout tone=\"tip\">\n<pre><code class=\"language-md\">:::</code></pre>\n</ui-callout>\n",
+	"../../markdown-fixtures/containers/fence-inside.md": "::: tip\n```md\n:::\n```\n:::\n",
+	"../../markdown-fixtures/containers/nesting.canonical.md": ":::: details More\n::: warning\nNested.\n:::\n::::\n",
+	"../../markdown-fixtures/containers/nesting.html": "<details><summary>More</summary>\n<ui-callout tone=\"warning\">\n<p>Nested.</p>\n</ui-callout>\n</details>\n",
+	"../../markdown-fixtures/containers/nesting.md": "::: details More\n::: warning\nNested.\n:::\n:::\n",
+	"../../markdown-fixtures/containers/unclosed.canonical.md": "::: note\nNo closing line.\n:::\n",
+	"../../markdown-fixtures/containers/unclosed.html": "<ui-callout tone=\"note\">\n<p>No closing line.</p>\n</ui-callout>\n",
+	"../../markdown-fixtures/containers/unclosed.md": "::: note\nNo closing line.\n",
+	"../../markdown-fixtures/containers/unknown-name.canonical.md": "::: aside Text :::\n",
+	"../../markdown-fixtures/containers/unknown-name.html": "<p>::: aside\nText\n:::</p>\n",
+	"../../markdown-fixtures/containers/unknown-name.md": "::: aside\nText\n:::\n",
+	"../../markdown-fixtures/details/default-summary.canonical.md": "::: details Details\nHidden until opened.\n:::\n",
+	"../../markdown-fixtures/details/default-summary.html": "<details><summary>Details</summary>\n<p>Hidden until opened.</p>\n</details>\n",
+	"../../markdown-fixtures/details/default-summary.md": "::: details\nHidden until opened.\n:::\n",
+	"../../markdown-fixtures/details/open.html": "<details open><summary>Show the full log</summary>\n<p>The build finished in 42 seconds.</p>\n</details>\n",
+	"../../markdown-fixtures/details/open.md": "::: details Show the full log {open}\nThe build finished in 42 seconds.\n:::\n",
+	"../../markdown-fixtures/figures/caption.html": "<figure>\n<img src=\"./pipeline.svg\" alt=\"The build pipeline\">\n<figcaption>The build, from <em>source</em> to release</figcaption>\n</figure>\n",
+	"../../markdown-fixtures/figures/caption.md": "::: figure The build, from *source* to release\n![The build pipeline](./pipeline.svg)\n:::\n",
+	"../../markdown-fixtures/front-matter/metadata.canonical.md": "# Notes\n",
+	"../../markdown-fixtures/front-matter/metadata.html": "<h1 id=\"notes\">Notes</h1>\n",
+	"../../markdown-fixtures/front-matter/metadata.md": "---\ntitle: Release notes\n---\n\n# Notes\n",
+	"../../markdown-fixtures/heading-ids/accented.html": "<h2 id=\"über-uns\">Über uns</h2>\n<h2 id=\"café-crème\">Café crème</h2>\n",
+	"../../markdown-fixtures/heading-ids/accented.md": "## Über uns\n\n## Café crème\n",
+	"../../markdown-fixtures/heading-ids/cjk.html": "<h2 id=\"はじめに\">はじめに</h2>\n<h2 id=\"設定-と-使い方\">設定 と 使い方</h2>\n",
+	"../../markdown-fixtures/heading-ids/cjk.md": "## はじめに\n\n## 設定 と 使い方\n",
+	"../../markdown-fixtures/heading-ids/custom.html": "<h2 id=\"setup\">Install</h2>\n<h2 id=\"install\">Install</h2>\n<h2 id=\"setup-1\">Setup</h2>\n",
+	"../../markdown-fixtures/heading-ids/custom.md": "## Install {#setup}\n\n## Install\n\n## Setup\n",
+	"../../markdown-fixtures/heading-ids/duplicates.html": "<h2 id=\"setup\">Setup</h2>\n<h2 id=\"setup-1\">Setup</h2>\n<h2 id=\"setup-1-1\">Setup 1</h2>\n",
+	"../../markdown-fixtures/heading-ids/duplicates.md": "## Setup\n\n## Setup\n\n## Setup 1\n",
+	"../../markdown-fixtures/heading-ids/emoji-only.html": "<h2 id=\"heading\">🚀</h2>\n<h2 id=\"heading-1\">🎉 🎉</h2>\n",
+	"../../markdown-fixtures/heading-ids/emoji-only.md": "## 🚀\n\n## 🎉 🎉\n",
+	"../../markdown-fixtures/heading-ids/generated.html": "<h2 id=\"getting-started\">Getting started</h2>\n<h2 id=\"getting-started-1\">Getting started</h2>\n<h2 id=\"über-code-more\">Über <code>code</code> &amp; more</h2>\n",
+	"../../markdown-fixtures/heading-ids/generated.md": "## Getting started\n\n## Getting started\n\n## Über `code` & more\n",
+	"../../markdown-fixtures/heading-ids/literal-braces.html": "<h2 id=\"price-usd\">Price {#usd}</h2>\n",
+	"../../markdown-fixtures/heading-ids/literal-braces.md": "## Price \\{#usd}\n",
+	"../../markdown-fixtures/headings/levels.html": "<h1 id=\"one\">One</h1>\n<h2 id=\"two\">Two</h2>\n<h3 id=\"three\">Three</h3>\n<h4 id=\"four\">Four</h4>\n<h5 id=\"five\">Five</h5>\n<h6 id=\"six\">Six</h6>\n",
+	"../../markdown-fixtures/headings/levels.md": "# One\n\n## Two\n\n### Three\n\n#### Four\n\n##### Five\n\n###### Six\n",
+	"../../markdown-fixtures/image-attributes/placed.html": "<img src=\"./pipeline.svg\" alt=\"Pipeline\" width=\"640\" height=\"360\" data-placement=\"wrap-left\" data-looma-responsive>\n",
+	"../../markdown-fixtures/image-attributes/placed.md": "![Pipeline](./pipeline.svg){width=640 height=360 placement=wrap-left responsive}\n",
+	"../../markdown-fixtures/images/block.html": "<img src=\"./pipeline.svg\" alt=\"The build pipeline\" title=\"Build pipeline\">\n",
+	"../../markdown-fixtures/images/block.md": "![The build pipeline](./pipeline.svg \"Build pipeline\")\n",
+	"../../markdown-fixtures/lists/blocks.html": "<ul>\n<li>One\n<ul>\n<li>Nested</li>\n</ul>\n</li>\n<li>Two</li>\n</ul>\n<ol start=\"3\">\n<li>Three</li>\n<li>Four</li>\n</ol>\n<blockquote>\n<p>Quoted</p>\n</blockquote>\n<hr>\n",
+	"../../markdown-fixtures/lists/blocks.md": "- One\n  - Nested\n- Two\n\n3. Three\n4. Four\n\n> Quoted\n\n---\n",
+	"../../markdown-fixtures/mentions/person.html": "<p>Thanks, <span data-type=\"mention\" class=\"looma-mention\" data-id=\"u1\" data-label=\"Ada Lovelace\">@Ada Lovelace</span>.</p>\n",
+	"../../markdown-fixtures/mentions/person.md": "Thanks, :mention[Ada Lovelace]{id=u1}.\n",
+	"../../markdown-fixtures/tables/gfm.html": "<table>\n<thead>\n<tr>\n<th>Package</th>\n<th style=\"text-align:right\">Version</th>\n<th style=\"text-align:center\">Notes</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>looma</td>\n<td style=\"text-align:right\">0.28</td>\n<td style=\"text-align:center\">Components</td>\n</tr>\n</tbody>\n</table>\n",
+	"../../markdown-fixtures/tables/gfm.md": "| Package | Version | Notes |\n| --- | ---: | :---: |\n| looma | 0.28 | Components |\n",
+	"../../markdown-fixtures/tables/left-aligned.html": "<table>\n<thead>\n<tr>\n<th style=\"text-align:left\">Name</th>\n<th>Notes</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"text-align:left\">a | b</td>\n<td><code>x | y</code></td>\n</tr>\n</tbody>\n</table>\n",
+	"../../markdown-fixtures/tables/left-aligned.md": "| Name | Notes |\n| :--- | --- |\n| a \\| b | `x \\| y` |\n",
+	"../../markdown-fixtures/tables/rich.canonical.md": "<table><tbody><tr><th><p>Status</p></th><th><p>Owner</p></th></tr><tr><td style=\"background-color: rgb(220, 252, 231);\"><p>Done</p><ul><li><p>Shipped</p></li></ul></td><td style=\"text-align: center;\"><p>Ada</p></td></tr></tbody></table>\n",
+	"../../markdown-fixtures/tables/rich.html": "<table><tbody><tr><th><p>Status</p></th><th><p>Owner</p></th></tr><tr><td style=\"background-color: #dcfce7\"><p>Done</p><ul><li><p>Shipped</p></li></ul></td><td colspan=\"1\" rowspan=\"1\" style=\"text-align: center\"><p>Ada</p></td></tr></tbody></table>\n",
+	"../../markdown-fixtures/tables/rich.md": "<table><tbody><tr><th><p>Status</p></th><th><p>Owner</p></th></tr><tr><td style=\"background-color: #dcfce7\"><p>Done</p><ul><li><p>Shipped</p></li></ul></td><td colspan=\"1\" rowspan=\"1\" style=\"text-align: center\"><p>Ada</p></td></tr></tbody></table>\n",
+	"../../markdown-fixtures/tabs/code-group.html": "<ui-tabs class=\"code-group\" group=\"code-group\">\n<section aria-label=\"looma.config.js\">\n<pre><code class=\"language-js\" data-meta=\"title=&quot;looma.config.js&quot;\">export default { theme: &quot;light&quot; };</code></pre>\n</section>\n<section aria-label=\"ts\">\n<pre><code class=\"language-ts\">export default { theme: &quot;light&quot; } satisfies Config;</code></pre>\n</section>\n</ui-tabs>\n",
+	"../../markdown-fixtures/tabs/code-group.md": "::: code-group\n```js title=\"looma.config.js\"\nexport default { theme: \"light\" };\n```\n```ts\nexport default { theme: \"light\" } satisfies Config;\n```\n:::\n",
+	"../../markdown-fixtures/tabs/labelled.html": "<ui-tabs group=\"install\">\n<section aria-label=\"npm\">\n<pre><code class=\"language-sh\">npm install @threadlabs/looma</code></pre>\n</section>\n<section aria-label=\"pnpm\">\n<pre><code class=\"language-sh\">pnpm add @threadlabs/looma</code></pre>\n</section>\n</ui-tabs>\n",
+	"../../markdown-fixtures/tabs/labelled.md": "::: tabs install\n== npm\n```sh\nnpm install @threadlabs/looma\n```\n== pnpm\n```sh\npnpm add @threadlabs/looma\n```\n:::\n",
+	"../../markdown-fixtures/task-lists/checked.html": "<ul data-type=\"taskList\">\n<li data-type=\"taskItem\" data-checked=\"true\"><input type=\"checkbox\" disabled checked>Read the changelog</li>\n<li data-type=\"taskItem\" data-checked=\"false\"><input type=\"checkbox\" disabled>Run the migration</li>\n</ul>\n",
+	"../../markdown-fixtures/task-lists/checked.md": "- [x] Read the changelog\n- [ ] Run the migration\n",
+	"../../markdown-fixtures/task-lists/mixed.canonical.md": "- \\[x\\] Done\n- Not a task\n",
+	"../../markdown-fixtures/task-lists/mixed.html": "<ul>\n<li>[x] Done</li>\n<li>Not a task</li>\n</ul>\n",
+	"../../markdown-fixtures/task-lists/mixed.md": "- [x] Done\n- Not a task\n",
+	"../../markdown-fixtures/text/marks.html": "<p><strong>bold</strong> <em>italic</em> <s>struck</s> <code>code</code> <u>underlined</u> <mark>highlighted</mark></p>\n<p><a href=\"https://example.com/looma\">Looma</a> ends a line<br>\nhere.</p>\n",
+	"../../markdown-fixtures/text/marks.md": "**bold** *italic* ~~struck~~ `code` <u>underlined</u> <mark>highlighted</mark>\n\n[Looma](https://example.com/looma) ends a line\\\nhere.\n",
+	"../../markdown-fixtures/toc/default.html": "<nav data-looma-toc data-format=\"plain\" data-depth=\"3\" aria-label=\"Table of contents\"><strong>Table of contents</strong><div role=\"list\"><div role=\"listitem\"><a href=\"#guide\">Guide</a><div role=\"list\"><div role=\"listitem\"><a href=\"#install\">Install</a></div></div></div></div></nav>\n<h1 id=\"guide\">Guide</h1>\n<h2 id=\"install\">Install</h2>\n",
+	"../../markdown-fixtures/toc/default.md": "::toc\n\n# Guide\n\n## Install\n",
+	"../../markdown-fixtures/toc/numbered.html": "<nav data-looma-toc data-format=\"numbered\" data-depth=\"2\" aria-label=\"Table of contents\"><strong>Table of contents</strong><ol role=\"list\"><li role=\"listitem\"><a href=\"#install\">Install</a></li><li role=\"listitem\"><a href=\"#use\">Use</a></li></ol></nav>\n<h2 id=\"install\">Install</h2>\n<h3 id=\"options\">Options</h3>\n<h2 id=\"use\">Use</h2>\n",
+	"../../markdown-fixtures/toc/numbered.md": "::toc{depth=2 format=numbered}\n\n## Install\n\n### Options\n\n## Use\n"
+});
+function fixtures() {
+	const cases = /* @__PURE__ */ new Map();
+	for (const [path, content] of Object.entries(files)) {
+		const [, feature, name, kind] = /\/markdown-fixtures\/([^/]+)\/([^/.]+)\.(md|html|canonical\.md)$/.exec(path);
+		const fixture = cases.get(`${feature}/${name}`) ?? {
+			feature,
+			name
+		};
+		cases.set(`${feature}/${name}`, fixture);
+		if (kind === "md") fixture.markdown = content;
+		else if (kind === "html") fixture.html = content;
+		else fixture.canonical = content;
+	}
+	return [...cases.values()].map((fixture) => {
+		if (fixture.markdown === void 0 || fixture.html === void 0) throw new Error(`${fixture.feature}/${fixture.name} needs case.md and case.html`);
+		return {
+			...fixture,
+			canonical: fixture.canonical ?? fixture.markdown
+		};
+	}).sort((a, b) => `${a.feature}/${a.name}`.localeCompare(`${b.feature}/${b.name}`, "en"));
+}
+/** Every conformance case, ordered by feature and name. */
+var LOOMA_MARKDOWN_FIXTURES = Object.freeze(fixtures());
+var BLOCKS = /* @__PURE__ */ new Set([
+	"address",
+	"article",
+	"aside",
+	"blockquote",
+	"details",
+	"div",
+	"dl",
+	"dd",
+	"dt",
+	"figcaption",
+	"figure",
+	"footer",
+	"h1",
+	"h2",
+	"h3",
+	"h4",
+	"h5",
+	"h6",
+	"header",
+	"hr",
+	"li",
+	"main",
+	"nav",
+	"ol",
+	"p",
+	"pre",
+	"section",
+	"summary",
+	"table",
+	"tbody",
+	"td",
+	"tfoot",
+	"th",
+	"thead",
+	"tr",
+	"ul",
+	"ui-callout",
+	"ui-disclosure",
+	"ui-tabs"
+]);
+var VOID = /* @__PURE__ */ new Set([
+	"br",
+	"hr",
+	"img",
+	"input",
+	"col",
+	"wbr"
+]);
+var escapeText = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+function unwrapPresentation(root) {
+	for (const link of root.querySelectorAll(":is(h1, h2, h3, h4, h5, h6) > a[href^='#']:only-child")) link.replaceWith(...link.childNodes);
+	for (const figure of root.querySelectorAll("figure.code")) {
+		const pre = figure.querySelector("pre");
+		if (pre) figure.replaceWith(pre);
+		else figure.remove();
+	}
+	for (const pre of root.querySelectorAll("pre")) {
+		for (const name of pre.getAttributeNames()) pre.removeAttribute(name);
+		const code = pre.querySelector("code");
+		if (code) code.textContent = code.textContent;
+	}
+}
+function serialize(node, inPre) {
+	if (node.nodeType === 3) {
+		const text = node.textContent ?? "";
+		if (inPre) return escapeText(text);
+		const parent = node.parentNode;
+		let value = text.replace(/\s+/g, " ");
+		const isBlockEdge = (sibling) => sibling === null || sibling.nodeType === 1 && BLOCKS.has(sibling.localName);
+		if (!parent || parent.nodeType !== 1 || BLOCKS.has(parent.localName)) {
+			if (isBlockEdge(node.previousSibling)) value = value.trimStart();
+			if (isBlockEdge(node.nextSibling)) value = value.trimEnd();
+		}
+		return escapeText(value);
+	}
+	if (node.nodeType !== 1) return [...node.childNodes].map((child) => serialize(child, inPre)).join("");
+	const element = node;
+	const name = element.localName;
+	const attributes = element.getAttributeNames().sort().map((attribute) => {
+		const value = element.getAttribute(attribute) ?? "";
+		return value ? ` ${attribute}="${value.replace(/&/g, "&amp;").replace(/"/g, "&quot;")}"` : ` ${attribute}`;
+	}).join("");
+	if (VOID.has(name)) return `<${name}${attributes}>`;
+	return `<${name}${attributes}>${[...element.childNodes].map((child) => serialize(child, inPre || name === "pre")).join("")}</${name}>`;
+}
+/**
+* Normalizes HTML so two renderings of a fixture compare as strings.
+* @contract Sorts attributes, writes empty attributes bare, collapses whitespace outside `pre` and
+* drops it at block edges, and unwraps renderer presentation (heading self-links, the code
+* `figure.code` wrapper and its actions, markup inside code).
+* @ownership Uses the supplied document, or the global one when a DOM is present; it never reads
+* the DOM at import.
+*/
+function normalizeLoomaHtml(html, document = globalThis.document) {
+	const template = document.createElement("template");
+	template.innerHTML = html;
+	unwrapPresentation(template.content);
+	return serialize(template.content, false).trim();
+}
+//#endregion
+export { LOOMA_MARKDOWN_FIXTURES, normalizeLoomaHtml };

package/markdown/index.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Looma Markdown's vocabulary and pure rules, shared by every reader and writer.
+ *
+ * Nothing here touches the DOM or a Markdown parser, so it is safe to import during SSR. The
+ * markdown-it plugin is `@threadlabs/looma/markdown/markdown-it`; conformance fixtures are
+ * `@threadlabs/looma/markdown/fixtures`.
+ */
+/** The meanings Callout and Badge share. Callout adds `note`, `tip` and `important`; Badge adds `accent`. */
+export declare const LOOMA_MEANING_TONES: readonly ["neutral", "info", "success", "warning", "danger"];
+/** Badge's tones: the shared meanings and `accent`. */
+export declare const LOOMA_BADGE_TONES: readonly ["neutral", "accent", "info", "success", "warning", "danger"];
+/**
+ * Callout tones a document stores, in the order the editor offers them. The Callout component also
+ * takes `neutral` and `success`, which Markdown and the editor store as `note`.
+ */
+export declare const LOOMA_CALLOUT_TONES: readonly ["note", "tip", "info", "important", "warning", "danger"];
+/** A stored callout tone. */
+export type LoomaCalloutTone = (typeof LOOMA_CALLOUT_TONES)[number];
+/** Names that read as a stored tone: `caution` is `danger`, and `neutral` is the same muted aside as `note`. */
+export declare const LOOMA_CALLOUT_TONE_ALIASES: Readonly<Record<string, LoomaCalloutTone>>;
+/**
+ * Maps a tone name or alias, in any case, onto a stored tone.
+ * @failure Unknown and non-string values become `note`.
+ */
+export declare function normalizeLoomaCalloutTone(value: unknown): LoomaCalloutTone;
+/** The hues chips and swatches take as their tone, written `:chip[Label]{tone=green}`. */
+export declare const LOOMA_CHIP_TONES: readonly ["neutral", "blue", "green", "yellow", "red", "purple"];
+/** A stored chip tone. */
+export type LoomaChipTone = (typeof LOOMA_CHIP_TONES)[number];
+/**
+ * Keeps a chip tone within the palette.
+ * @failure Unknown values become `neutral`.
+ */
+export declare function normalizeLoomaChipTone(value: unknown): LoomaChipTone;
+/**
+ * Names that open a `:::` container, matched without regard to case. A container with any other
+ * name is ordinary text.
+ */
+export declare const LOOMA_CONTAINER_NAMES: ReadonlySet<string>;
+/** Brace attributes: `{#id}` sets `id`, `key=value` and `key="quoted value"` set values, and a bare key is `true`. */
+export type LoomaAttributes = Record<string, string | true>;
+/**
+ * Reads a brace attribute list starting at `source[start]`, which must be `{`.
+ * @contract Returns the attributes and the index just past the closing brace.
+ * @failure Returns null for anything that is not a complete, well-formed list, so the text stays literal.
+ */
+export declare function readLoomaAttributes(source: string, start?: number): {
+    attributes: LoomaAttributes;
+    end: number;
+} | null;
+/**
+ * Reads a whole string as one brace attribute list.
+ * @failure Returns null unless the string is exactly one well-formed list.
+ */
+export declare function parseLoomaAttributes(source: string): LoomaAttributes | null;
+/**
+ * Writes attributes as a brace list, `id` first as `#id`, then the rest in order.
+ * @contract `true` writes a bare key; values are quoted only when they need it. `false`, null and
+ * undefined values are left out, and an empty set writes an empty string. An ID that `#` cannot
+ * carry, or any ID when `hashId` is false, is written `id=…`.
+ */
+export declare function formatLoomaAttributes(attributes: Readonly<Record<string, string | number | boolean | null | undefined>>, { hashId }?: {
+    hashId?: boolean | undefined;
+}): string;
+/**
+ * The anchor a heading's text derives: NFC, lowercase, keeping letters, numbers and combining
+ * marks, with every other run of characters one hyphen.
+ * @failure Text with no letters or numbers, such as only emoji, derives `heading`.
+ */
+export declare function loomaHeadingSlug(text: string): string;
+/**
+ * Gives every heading of a document its anchor, in document order.
+ * @contract A custom ID is kept unless an earlier heading already has it. Any other heading takes
+ * its slug, or the slug's first free suffix (`-1`, `-2`…), never one a later custom ID reserves.
+ */
+export declare function assignLoomaHeadingIds(headings: ReadonlyArray<{
+    readonly text: string;
+    readonly id?: string | null;
+}>): string[];
+/** A code fence's info string, read into its parts. */
+export interface LoomaFenceInfo {
+    /** The first word, up to a space, `{` or `:`. */
+    language?: string;
+    /** Everything after the language, as written. */
+    meta: string;
+    /** `title="…"`. */
+    title?: string;
+    /** Lines `{1,3-5}` highlights, ascending. */
+    lines: number[];
+    /** `:line-numbers` is true and `:no-line-numbers` false; absent means the site default. */
+    lineNumbers?: boolean;
+}
+/** Reads a fence's info string: ```` ```ts title="a.ts" {1,3-5} :line-numbers ````. */
+export declare function parseLoomaFenceInfo(info: string): LoomaFenceInfo;
+/**
+ * Splits YAML front matter from the start of a document.
+ * @contract Front matter opens with a `---` line at the very start, holds at least one `key: value`
+ * line, and closes at a `---` or `...` line. `source` is the block as written, delimiters included.
+ * @failure Returns null when the document has none.
+ */
+export declare function splitLoomaFrontmatter(document: string): {
+    source: string;
+    yaml: string;
+    body: string;
+} | null;
+/** The colons a container opens and closes with, given how deeply containers nest inside it. */
+export declare function loomaContainerMarker(nestedDepth: number): string;
+/** A backtick fence longer than any run of backticks in the code, and at least three long. */
+export declare function loomaCodeFence(code: string): string;