@glw907/cairn-cms 0.17.0 → 0.21.0

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

@@ -0,0 +1,20 @@
+interface Props {
+    /** The concept this entry belongs to, e.g. "posts". Posted with the confirm. */
+    conceptId: string;
+    /** The entry id within its concept. Posted with the confirm. */
+    id: string;
+    /** A human label for the concept, e.g. "Post", used in the prompts. */
+    label: string;
+    /** The current slug, prefilled into the input. */
+    slug: string;
+}
+/**
+ * The Change URL control and its modal. The author edits the URL slug; on submit the ?/rename action
+ * moves the entry and rewrites every inbound cairn link in one commit, so no internal link breaks. A
+ * dated post keeps its date; only the slug changes. Built on a native <dialog>, following the
+ * DeleteDialog a11y conventions.
+ */
+declare const RenameDialog: import("svelte").Component<Props, {}, "">;
+type RenameDialog = ReturnType<typeof RenameDialog>;
+export default RenameDialog;
+//# sourceMappingURL=RenameDialog.svelte.d.ts.map

package/dist/components/RenameDialog.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenameDialog.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/RenameDialog.svelte.ts"],"names":[],"mappings":"AAGE,UAAU,KAAK;IACb,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AA6DH;;;;;GAKG;AACH,QAAA,MAAM,YAAY,2CAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/components/index.d.ts

@@ -9,4 +9,7 @@ export { default as ComponentInsertDialog } from './ComponentInsertDialog.svelte
 export { default as ComponentForm } from './ComponentForm.svelte';
 export { default as IconPicker } from './IconPicker.svelte';
 export { default as NavTree } from './NavTree.svelte';
+export { default as LinkPicker } from './LinkPicker.svelte';
+export { default as DeleteDialog } from './DeleteDialog.svelte';
+export { default as RenameDialog } from './RenameDialog.svelte';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/components/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/components/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/index.js

@@ -11,3 +11,6 @@ export { default as ComponentInsertDialog } from './ComponentInsertDialog.svelte
 export { default as ComponentForm } from './ComponentForm.svelte';
 export { default as IconPicker } from './IconPicker.svelte';
 export { default as NavTree } from './NavTree.svelte';
+export { default as LinkPicker } from './LinkPicker.svelte';
+export { default as DeleteDialog } from './DeleteDialog.svelte';
+export { default as RenameDialog } from './RenameDialog.svelte';

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

@@ -0,0 +1,16 @@
+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 `[[`. */
+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. */
+export declare function linkCompletions(targets: LinkTarget[], query: string): Completion[];
+/** 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`). */
+export declare function cairnLinkCompletionSource(targets: LinkTarget[]): CompletionSource;
+//# sourceMappingURL=link-completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link-completion.d.ts","sourceRoot":"","sources":["../../src/lib/components/link-completion.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAuC,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAElH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAazD;oGACoG;AACpG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGxF;AAED;wGACwG;AACxG,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CASlF;AAED;;kGAEkG;AAClG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAcjF"}

package/dist/components/link-completion.js

@@ -0,0 +1,48 @@
+import { syntaxTree } from '@codemirror/language';
+import { formatCairnToken, escapeLinkText } from '../content/links.js';
+/** The known concepts in display order; an unlisted concept sorts after these under its own name. */
+const CONCEPT_SECTIONS = {
+    pages: { name: 'Pages', rank: 0 },
+    posts: { name: 'Posts', rank: 1 },
+};
+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 `[[`. */
+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. */
+export function linkCompletions(targets, query) {
+    const q = query.trim().toLowerCase();
+    const matched = q ? targets.filter((t) => t.title.toLowerCase().includes(q)) : targets;
+    return matched.map((t) => ({
+        label: t.title,
+        section: sectionFor(t.concept),
+        detail: t.draft ? 'Draft' : t.date,
+        apply: `[${escapeLinkText(t.title)}](${formatCairnToken(t)})`,
+    }));
+}
+/** 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`). */
+export function cairnLinkCompletionSource(targets) {
+    return (context) => {
+        const line = context.state.doc.lineAt(context.pos);
+        const before = context.state.sliceDoc(line.from, context.pos);
+        const trigger = matchCairnTrigger(before);
+        if (!trigger)
+            return null;
+        // Skip a [[ inside a fenced or inline code node: a cairn link there would be literal text, and
+        // the build resolver does not look inside code. The node name carries "Code" for both forms.
+        const node = syntaxTree(context.state).resolveInner(context.pos, -1);
+        for (let n = node; n; n = n.parent) {
+            if (/Code/.test(n.name))
+                return null;
+        }
+        return { from: line.from + trigger.from, options: linkCompletions(targets, trigger.query), filter: false };
+    };
+}

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

@@ -1,8 +1,3 @@
-/**
- * Pure markdown selection transforms for the editor toolbar. Each call maps a document and a
- * selection range to a new document and a new selection, with no DOM. The MarkdownEditor view
- * dispatches the result; keeping the logic here lets it unit-test without a browser.
- */
 export type FormatKind = 'bold' | 'italic' | 'code' | 'heading' | 'quote' | 'ul' | 'link';
 export interface FormatResult {
     doc: string;
@@ -10,4 +5,29 @@ export interface FormatResult {
     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
+ * becomes the display text; with an empty selection the title is the display text. The cursor
+ * collapses just after the inserted link. Unlike the block insert, this adds no surrounding
+ * blank lines, since a link is inline. Pure, so the editor dispatches the result.
+ */
+export declare function insertInlineLink(doc: string, from: number, to: number, href: string, title: string): FormatResult;
+/**
+ * Unwrap every cairn: link whose href is exactly `href`, replacing it with its plain display text.
+ * The save guard's one-click fix calls this to drop a broken link while keeping the words. The
+ * document is parsed with the same remark pipeline extractCairnLinks uses, so the two agree on what
+ * a link is. Each matching link node is located by its source offsets and spliced out from last to
+ * first, which leaves the rest of the document exact and unescapes the display text. A token inside
+ * a code span or fence is not a link node, so it is never touched, and a link with a different url
+ * is left in place.
+ */
+export declare function unwrapCairnLink(doc: string, href: string): string;
+/**
+ * Rewrite every cairn: link whose href is exactly `oldHref` so its href becomes `newHref`, keeping
+ * the display text and any link title byte-for-byte. Rename calls this to repoint a renamed entry's
+ * inbound tokens. Parsed with the same remark pipeline as extractCairnLinks, so a token inside a code
+ * span is not a link node and is never touched. Each matching node's source span is rewritten from
+ * last to first, replacing only the `](oldHref` run so the label and title stay exact.
+ */
+export declare function rewriteCairnLink(doc: string, oldHref: string, newHref: string): string;
 //# sourceMappingURL=markdown-format.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"markdown-format.d.ts","sourceRoot":"","sources":["../../src/lib/components/markdown-format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAE1F,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAKD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAsBzG"}
+{"version":3,"file":"markdown-format.d.ts","sourceRoot":"","sources":["../../src/lib/components/markdown-format.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAE1F,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAKD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAsBzG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAKjH;AAUD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBtF"}

package/dist/components/markdown-format.js

@@ -1,3 +1,13 @@
+/**
+ * Pure markdown selection transforms for the editor toolbar. Each call maps a document and a
+ * selection range to a new document and a new selection, with no DOM. The MarkdownEditor view
+ * dispatches the result; keeping the logic here lets it unit-test without a browser.
+ */
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import { visit } from 'unist-util-visit';
+import { escapeLinkText } from '../content/links.js';
 const WRAP = { bold: '**', italic: '_', code: '`' };
 const LINE_PREFIX = { heading: '# ', quote: '> ', ul: '- ' };
 export function applyMarkdownFormat(doc, from, to, kind) {
@@ -21,3 +31,78 @@ export function applyMarkdownFormat(doc, from, to, kind) {
     const added = prefixed.length - region.length;
     return { doc: doc.slice(0, lineStart) + prefixed + doc.slice(to), from: from + prefix.length, to: to + added };
 }
+/**
+ * Insert an inline markdown link at the selection. With a non-empty selection the selected text
+ * becomes the display text; with an empty selection the title is the display text. The cursor
+ * collapses just after the inserted link. Unlike the block insert, this adds no surrounding
+ * blank lines, since a link is inline. Pure, so the editor dispatches the result.
+ */
+export function insertInlineLink(doc, from, to, href, title) {
+    const text = from < to ? doc.slice(from, to) : escapeLinkText(title);
+    const inserted = `[${text}](${href})`;
+    const end = from + inserted.length;
+    return { doc: doc.slice(0, from) + inserted + doc.slice(to), from: end, to: end };
+}
+/** 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. */
+function linkText(node) {
+    return node.children.map((c) => ('value' in c ? c.value : '')).join('');
+}
+/**
+ * Unwrap every cairn: link whose href is exactly `href`, replacing it with its plain display text.
+ * The save guard's one-click fix calls this to drop a broken link while keeping the words. The
+ * document is parsed with the same remark pipeline extractCairnLinks uses, so the two agree on what
+ * a link is. Each matching link node is located by its source offsets and spliced out from last to
+ * first, which leaves the rest of the document exact and unescapes the display text. A token inside
+ * a code span or fence is not a link node, so it is never touched, and a link with a different url
+ * is left in place.
+ */
+export function unwrapCairnLink(doc, href) {
+    const tree = unified().use(remarkParse).use(remarkGfm).parse(doc);
+    const spans = [];
+    visit(tree, 'link', (node) => {
+        if (node.url !== href)
+            return;
+        const start = node.position?.start?.offset;
+        const end = node.position?.end?.offset;
+        if (start == null || end == null)
+            return;
+        spans.push({ start, end, text: linkText(node) });
+    });
+    spans.sort((a, b) => b.start - a.start);
+    let out = doc;
+    for (const span of spans) {
+        out = out.slice(0, span.start) + span.text + out.slice(span.end);
+    }
+    return out;
+}
+/**
+ * Rewrite every cairn: link whose href is exactly `oldHref` so its href becomes `newHref`, keeping
+ * the display text and any link title byte-for-byte. Rename calls this to repoint a renamed entry's
+ * inbound tokens. Parsed with the same remark pipeline as extractCairnLinks, so a token inside a code
+ * span is not a link node and is never touched. Each matching node's source span is rewritten from
+ * last to first, replacing only the `](oldHref` run so the label and title stay exact.
+ */
+export function rewriteCairnLink(doc, oldHref, newHref) {
+    const tree = unified().use(remarkParse).use(remarkGfm).parse(doc);
+    const spans = [];
+    visit(tree, 'link', (node) => {
+        if (node.url !== oldHref)
+            return;
+        const start = node.position?.start?.offset;
+        const end = node.position?.end?.offset;
+        if (start == null || end == null)
+            return;
+        spans.push({ start, end });
+    });
+    spans.sort((a, b) => b.start - a.start);
+    let out = doc;
+    for (const span of spans) {
+        const src = out.slice(span.start, span.end);
+        const rewritten = src.replace(`](${oldHref}`, `](${newHref}`);
+        out = out.slice(0, span.start) + rewritten + out.slice(span.end);
+    }
+    return out;
+}

package/dist/content/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/lib/content/compose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,YAAY,EAAE,cAAc,EAAE,YAAY,EAAiB,gBAAgB,EAAgB,MAAM,YAAY,CAAC;AAGxI;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,cAAc,EAAO,EACjC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAM,GAC3D,YAAY,CAwBd"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/lib/content/compose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,YAAY,EAAE,cAAc,EAAE,YAAY,EAAiB,gBAAgB,EAAgB,MAAM,YAAY,CAAC;AAGxI;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,cAAc,EAAO,EACjC,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAM,GAC3D,YAAY,CAyBd"}

package/dist/content/compose.js

@@ -23,6 +23,7 @@ export function composeRuntime(adapter, extensions = [], urlPolicy = {}) {
         backend: adapter.backend,
         sender: adapter.sender,
         render: adapter.render,
+        manifestPath: adapter.manifestPath ?? 'src/content/.cairn/index.json',
         registry: adapter.registry,
         icons: adapter.icons,
         navMenu: adapter.navMenu,

package/dist/content/ids.d.ts

@@ -28,4 +28,11 @@ export declare function slugFromId(id: string, datePrefix: DatePrefix | null): s
  * malformed date so a bad create fails before touching git.
  */
 export declare function composeDatedId(date: string, slug: string, datePrefix: DatePrefix): string;
+/**
+ * Rename an id by swapping its slug, keeping any date prefix. slugFromId strips only the leading
+ * date prefix, so the id is exactly its prefix followed by its slug; this replaces the slug suffix
+ * with newSlug. A non-dated concept passes null, so the whole id is the slug and the id becomes
+ * newSlug. The caller validates newSlug with isValidId first.
+ */
+export declare function renameId(oldId: string, newSlug: string, datePrefix: DatePrefix | null): string;
 //# sourceMappingURL=ids.d.ts.map

package/dist/content/ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/lib/content/ids.ts"],"names":[],"mappings":"AAOA,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,uGAAuG;AACvG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AASlD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAG5E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAiBzF"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/lib/content/ids.ts"],"names":[],"mappings":"AAOA,qGAAqG;AACrG,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,uGAAuG;AACvG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AASlD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAG5E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAiBzF;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAI9F"}

package/dist/content/ids.js

@@ -71,3 +71,14 @@ export function composeDatedId(date, slug, datePrefix) {
     }
     return `${prefix}-${slug}`;
 }
+/**
+ * Rename an id by swapping its slug, keeping any date prefix. slugFromId strips only the leading
+ * date prefix, so the id is exactly its prefix followed by its slug; this replaces the slug suffix
+ * with newSlug. A non-dated concept passes null, so the whole id is the slug and the id becomes
+ * newSlug. The caller validates newSlug with isValidId first.
+ */
+export function renameId(oldId, newSlug, datePrefix) {
+    const oldSlug = slugFromId(oldId, datePrefix);
+    const prefix = oldId.slice(0, oldId.length - oldSlug.length);
+    return prefix + newSlug;
+}

package/dist/content/links.d.ts

@@ -0,0 +1,21 @@
+/** A resolved reference to a content entry by its concept and permanent id. */
+export interface CairnRef {
+    concept: string;
+    id: string;
+}
+/** Resolve a reference to its live permalink. Returns undefined when the target is missing (the
+ *  preview marks it); the build resolver throws instead, so a dangling token fails the build. */
+export type LinkResolve = (ref: CairnRef) => string | undefined;
+/** Parse a `cairn:<concept>/<id>` href, or null for any other href or a malformed token. */
+export declare function parseCairnToken(href: string): CairnRef | null;
+/** Write the `cairn:<concept>/<id>` token for a ref. The inverse of parseCairnToken, so the editor
+ *  link picker and the autocomplete write exactly the form the resolver reads back. */
+export declare function formatCairnToken(ref: CairnRef): string;
+/** Escape the characters that would break a markdown link's display text: a backslash and the
+ *  square brackets that delimit the text. Used where a content title becomes link display text,
+ *  so an unbalanced bracket in a title cannot truncate the generated link. */
+export declare function escapeLinkText(text: string): string;
+/** The cairn links a markdown body points at, in first-occurrence order, deduped by concept/id.
+ *  Parses the body as mdast, so a token inside a code span or fence is never matched. */
+export declare function extractCairnLinks(body: string): CairnRef[];
+//# sourceMappingURL=links.d.ts.map

package/dist/content/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/lib/content/links.ts"],"names":[],"mappings":"AAUA,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;iGACiG;AACjG,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,QAAQ,KAAK,MAAM,GAAG,SAAS,CAAC;AAEhE,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAS7D;AAED;uFACuF;AACvF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEtD;AAED;;8EAE8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;yFACyF;AACzF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAa1D"}

package/dist/content/links.js

@@ -0,0 +1,52 @@
+// cairn-cms: the cairn: internal-link token. An internal link is a standard CommonMark link
+// whose href is `cairn:<concept>/<id>`, keyed to the target's permanent filename stem so it
+// survives a slug, date, or permalink change (content-graph design). This module owns the
+// grammar; the render resolver (resolve-links.ts) reuses parseCairnToken.
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import { visit } from 'unist-util-visit';
+import { isValidId } from './ids.js';
+/** Parse a `cairn:<concept>/<id>` href, or null for any other href or a malformed token. */
+export function parseCairnToken(href) {
+    if (!href.startsWith('cairn:'))
+        return null;
+    const rest = href.slice('cairn:'.length);
+    const slash = rest.indexOf('/');
+    if (slash <= 0)
+        return null;
+    const concept = rest.slice(0, slash);
+    const id = rest.slice(slash + 1);
+    if (!concept || !isValidId(id))
+        return null;
+    return { concept, id };
+}
+/** Write the `cairn:<concept>/<id>` token for a ref. The inverse of parseCairnToken, so the editor
+ *  link picker and the autocomplete write exactly the form the resolver reads back. */
+export function formatCairnToken(ref) {
+    return `cairn:${ref.concept}/${ref.id}`;
+}
+/** Escape the characters that would break a markdown link's display text: a backslash and the
+ *  square brackets that delimit the text. Used where a content title becomes link display text,
+ *  so an unbalanced bracket in a title cannot truncate the generated link. */
+export function escapeLinkText(text) {
+    return text.replace(/[\\[\]]/g, (ch) => `\\${ch}`);
+}
+/** The cairn links a markdown body points at, in first-occurrence order, deduped by concept/id.
+ *  Parses the body as mdast, so a token inside a code span or fence is never matched. */
+export function extractCairnLinks(body) {
+    const tree = unified().use(remarkParse).use(remarkGfm).parse(body);
+    const seen = new Set();
+    const refs = [];
+    visit(tree, 'link', (node) => {
+        const ref = node.url ? parseCairnToken(node.url) : null;
+        if (!ref)
+            return;
+        const key = `${ref.concept}/${ref.id}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        refs.push(ref);
+    });
+    return refs;
+}

package/dist/content/manifest.d.ts

@@ -0,0 +1,69 @@
+import { type CairnRef, type LinkResolve } from './links.js';
+import type { ConceptDescriptor } from './types.js';
+/** One entry's projection: its identity, routing, draft flag, and outbound cairn: edges. */
+export interface ManifestEntry {
+    id: string;
+    concept: string;
+    title: string;
+    date?: string;
+    permalink: string;
+    draft: boolean;
+    links: CairnRef[];
+}
+/** The whole corpus as one committed file. `version` guards a future shape migration. */
+export interface Manifest {
+    version: 1;
+    entries: ManifestEntry[];
+}
+/** The minimal entry view the preview resolver and (later) the picker read. */
+export interface LinkTarget {
+    concept: string;
+    id: string;
+    permalink: string;
+    title: string;
+    date?: string;
+    draft: boolean;
+}
+/** Build one manifest entry from a content file. Drafts are included and flagged. */
+export declare function manifestEntryFromFile(descriptor: ConceptDescriptor, file: {
+    path: string;
+    raw: string;
+}): ManifestEntry;
+/** An empty manifest, the starting point when no committed file exists yet. */
+export declare function emptyManifest(): Manifest;
+/** Serialize canonically: entries sorted by concept then id, links sorted and deduped, a fixed key
+ *  order, two-space pretty, and a trailing newline, so the committed file diffs cleanly in a PR. */
+export declare function serializeManifest(manifest: Manifest): string;
+/** Parse a committed manifest. Throws on malformed JSON, a wrong version, or a malformed entry, so
+ *  every reader (the save guard, the delete path, the preview) sees a well-formed graph or a clear
+ *  error. The build regenerates the manifest, so a real file is always canonical; this guards a
+ *  hand-edited or truncated one. */
+export declare function parseManifest(raw: string): Manifest;
+/** Throw if the committed manifest drifts from what the corpus says. Both sides are compared in the
+ *  canonical serialized form, so semantic equality never spuriously fails. The build calls this so a
+ *  raw-git content edit, which leaves the committed manifest stale, fails the build loudly. */
+export declare function verifyManifest(built: Manifest, committedRaw: string): void;
+/** Replace the entry with the same concept and id, or add it. Order does not matter, since
+ *  serializeManifest sorts. This is the save path's incremental patch. */
+export declare function upsertEntry(manifest: Manifest, entry: ManifestEntry): Manifest;
+/** Drop the entry with the given concept and id, if present. The delete path's patch. */
+export declare function removeEntry(manifest: Manifest, concept: string, id: string): Manifest;
+/** One inbound linker: enough to name it and link to its edit page in the delete guard. */
+export interface InboundLink {
+    concept: string;
+    id: string;
+    title: string;
+    permalink: string;
+}
+/** Every entry whose outbound edges point at the target, excluding the target itself. The delete
+ *  guard reads this to name "what links here"; the backlinks panel will reuse it. Pure over the
+ *  manifest, so the request-time delete path and a unit test call it the same way. */
+export declare function inboundLinks(manifest: Manifest, concept: string, id: string): InboundLink[];
+/** A resolver backed by manifest targets, for the admin preview. A miss returns undefined, so the
+ *  render step marks the link broken rather than throwing. The build resolver throws instead. */
+export declare function manifestLinkResolver(targets: {
+    concept: string;
+    id: string;
+    permalink: string;
+}[]): LinkResolve;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/content/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/lib/content/manifest.ts"],"names":[],"mappings":"AAQA,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,yFAAyF;AACzF,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAmBD,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAiBvH;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAMD;oGACoG;AACpG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAW5D;AAED;;;oCAGoC;AACpC,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAqCnD;AAED;;+FAE+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAM1E;AAED;0EAC0E;AAC1E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,QAAQ,CAI9E;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAErF;AAED,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;sFAEsF;AACtF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,EAAE,CAK3F;AAED;iGACiG;AACjG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,WAAW,CAG/G"}

package/dist/content/manifest.js

@@ -0,0 +1,140 @@
+// cairn-cms: the content manifest, a committed JSON projection of the corpus (content-graph
+// design). The files in git stay the source of truth; the manifest exists so request-time admin
+// code reads the content graph without an N+1 GitHub crawl. The build regenerates and verifies
+// it; the save path patches one entry and commits it with the content in one commit. Each entry
+// carries its identity and its outbound cairn: edges, so the manifest is the link graph.
+import { idFromFilename, slugFromId } from './ids.js';
+import { parseMarkdown } from './frontmatter.js';
+import { permalink } from './permalink.js';
+import { extractCairnLinks } from './links.js';
+function basename(path) {
+    const slash = path.lastIndexOf('/');
+    return slash >= 0 ? path.slice(slash + 1) : path;
+}
+/** Mirror content-index's frontmatter coercion: a present non-empty string, else undefined. */
+function asString(value) {
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+/** Mirror content-index's date coercion: an unquoted YAML date is a JS Date, a string is sliced. */
+function asDate(value) {
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? undefined : value.toISOString().slice(0, 10);
+    if (typeof value === 'string')
+        return value.match(/^\d{4}-\d{2}-\d{2}/)?.[0];
+    return undefined;
+}
+/** Build one manifest entry from a content file. Drafts are included and flagged. */
+export function manifestEntryFromFile(descriptor, file) {
+    const id = idFromFilename(basename(file.path));
+    // Use the same slug rule content-index uses, so the manifest's permalink for an entry always
+    // equals content-index's permalink for it. A cairn link must resolve to one URL whether the
+    // admin preview reads the manifest or the public build reads the content index.
+    const slug = slugFromId(id, descriptor.routing.dated ? descriptor.datePrefix : null);
+    const { frontmatter, body } = parseMarkdown(file.raw);
+    const date = asDate(frontmatter.date);
+    return {
+        id,
+        concept: descriptor.id,
+        title: asString(frontmatter.title) ?? id,
+        date,
+        permalink: permalink(descriptor, { id, slug, date }),
+        draft: frontmatter.draft === true,
+        links: extractCairnLinks(body),
+    };
+}
+/** An empty manifest, the starting point when no committed file exists yet. */
+export function emptyManifest() {
+    return { version: 1, entries: [] };
+}
+function compareRef(a, b) {
+    return a.concept.localeCompare(b.concept) || a.id.localeCompare(b.id);
+}
+/** Serialize canonically: entries sorted by concept then id, links sorted and deduped, a fixed key
+ *  order, two-space pretty, and a trailing newline, so the committed file diffs cleanly in a PR. */
+export function serializeManifest(manifest) {
+    const entries = [...manifest.entries].sort(compareRef).map((e) => ({
+        id: e.id,
+        concept: e.concept,
+        title: e.title,
+        ...(e.date ? { date: e.date } : {}),
+        permalink: e.permalink,
+        draft: e.draft,
+        links: [...e.links].sort(compareRef).map((r) => ({ concept: r.concept, id: r.id })),
+    }));
+    return `${JSON.stringify({ version: 1, entries }, null, 2)}\n`;
+}
+/** Parse a committed manifest. Throws on malformed JSON, a wrong version, or a malformed entry, so
+ *  every reader (the save guard, the delete path, the preview) sees a well-formed graph or a clear
+ *  error. The build regenerates the manifest, so a real file is always canonical; this guards a
+ *  hand-edited or truncated one. */
+export function parseManifest(raw) {
+    const data = JSON.parse(raw);
+    if (!data || typeof data !== 'object') {
+        throw new Error('content manifest: malformed file, expected { version, entries: [] }');
+    }
+    const obj = data;
+    if (obj.version !== 1) {
+        throw new Error(`content manifest: unsupported version ${String(obj.version)}, expected 1`);
+    }
+    if (!Array.isArray(obj.entries)) {
+        throw new Error('content manifest: malformed file, expected { version, entries: [] }');
+    }
+    for (const entry of obj.entries) {
+        const e = entry;
+        const ok = e &&
+            typeof e.id === 'string' &&
+            typeof e.concept === 'string' &&
+            typeof e.title === 'string' &&
+            typeof e.permalink === 'string' &&
+            typeof e.draft === 'boolean' &&
+            (e.date === undefined || typeof e.date === 'string') &&
+            Array.isArray(e.links);
+        if (!ok) {
+            throw new Error(`content manifest: malformed entry ${JSON.stringify(e)}`);
+        }
+        // Validate each link element's shape, not just that links is an array. inboundLinks and the
+        // delete guard read l.concept and l.id, so a string, null, or id-less element would read as
+        // undefined and silently drop a real inbound linker. Reject it here instead.
+        for (const link of e.links) {
+            const l = link;
+            if (!l || typeof l !== 'object' || typeof l.concept !== 'string' || typeof l.id !== 'string') {
+                throw new Error(`content manifest: malformed link ${JSON.stringify(link)} in entry ${JSON.stringify(e)}`);
+            }
+        }
+    }
+    return { version: 1, entries: obj.entries };
+}
+/** Throw if the committed manifest drifts from what the corpus says. Both sides are compared in the
+ *  canonical serialized form, so semantic equality never spuriously fails. The build calls this so a
+ *  raw-git content edit, which leaves the committed manifest stale, fails the build loudly. */
+export function verifyManifest(built, committedRaw) {
+    if (committedRaw !== serializeManifest(built)) {
+        throw new Error('content manifest is stale: the committed file does not match the corpus. Regenerate it (npm run cairn:manifest) and commit the result.');
+    }
+}
+/** Replace the entry with the same concept and id, or add it. Order does not matter, since
+ *  serializeManifest sorts. This is the save path's incremental patch. */
+export function upsertEntry(manifest, entry) {
+    const entries = manifest.entries.filter((e) => !(e.concept === entry.concept && e.id === entry.id));
+    entries.push(entry);
+    return { version: 1, entries };
+}
+/** Drop the entry with the given concept and id, if present. The delete path's patch. */
+export function removeEntry(manifest, concept, id) {
+    return { version: 1, entries: manifest.entries.filter((e) => !(e.concept === concept && e.id === id)) };
+}
+/** Every entry whose outbound edges point at the target, excluding the target itself. The delete
+ *  guard reads this to name "what links here"; the backlinks panel will reuse it. Pure over the
+ *  manifest, so the request-time delete path and a unit test call it the same way. */
+export function inboundLinks(manifest, concept, id) {
+    return manifest.entries
+        .filter((e) => !(e.concept === concept && e.id === id))
+        .filter((e) => e.links.some((l) => l.concept === concept && l.id === id))
+        .map((e) => ({ concept: e.concept, id: e.id, title: e.title, permalink: e.permalink }));
+}
+/** A resolver backed by manifest targets, for the admin preview. A miss returns undefined, so the
+ *  render step marks the link broken rather than throwing. The build resolver throws instead. */
+export function manifestLinkResolver(targets) {
+    const byKey = new Map(targets.map((t) => [`${t.concept}/${t.id}`, t.permalink]));
+    return (ref) => byKey.get(`${ref.concept}/${ref.id}`);
+}

package/dist/content/types.d.ts

@@ -2,6 +2,7 @@ import type { ComponentRegistry } from '../render/registry.js';
 import type { IconSet } from '../render/glyph.js';
 import type { DatePrefix } from './ids.js';
 import type { ConceptSchema } from './schema.js';
+import type { LinkResolve } from './links.js';
 /** Common to every frontmatter field: the frontmatter key, the form label, and whether it is required. */
 interface FieldBase {
     /** Frontmatter key and form input name. */
@@ -149,10 +150,16 @@ export interface CairnAdapter {
     };
     backend: BackendConfig;
     sender: SenderConfig;
-    /** The site's one renderer: the editor preview and every public page call it (design decision 4). */
+    /** The site's one renderer: the editor preview and every public page call it (design decision 4).
+     *  `resolve` rewrites cairn: links to live permalinks; the build passes a site-index resolver, the
+     *  preview a manifest one. */
     render(md: string, opts?: {
         stagger?: boolean;
+        resolve?: LinkResolve;
     }): string | Promise<string>;
+    /** Repo-relative path to the committed content manifest. Defaults to src/content/.cairn/index.json
+     *  in composeRuntime. It sits outside any concept directory, so content enumeration never globs it. */
+    manifestPath?: string;
     /** Directive component registry; the renderer and the future palette derive from it (seam 3). */
     registry?: ComponentRegistry;
     /** The site's glyph name to SVG path-data map, for the admin icon picker and the renderer. */
@@ -243,7 +250,9 @@ export interface CairnRuntime {
     /** The site's one renderer: the editor preview and every public page call it (design decision 4). */
     render(md: string, opts?: {
         stagger?: boolean;
+        resolve?: LinkResolve;
     }): string | Promise<string>;
+    manifestPath: string;
     registry?: ComponentRegistry;
     /** The site's glyph name to SVG path-data map, for the admin icon picker and the renderer. */
     icons?: IconSet;