@glw907/cairn-cms 0.62.2 → 0.76.0

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

@@ -0,0 +1,53 @@
+import type { NamedField } from '../content/types.js';
+import type { ArrayField } from '../content/fields.js';
+import type { LinkTarget } from '../content/manifest.js';
+import type { MediaEntry } from '../media/manifest.js';
+import type { MediaLibraryEntry } from '../media/library-entry.js';
+import type { IconSet } from '../render/glyph.js';
+import type MediaHeroField from './MediaHeroField.svelte';
+interface Props {
+    /** The array descriptor to render; its `item` is the per-row leaf or flat object. */
+    field: NamedField & ArrayField;
+    /** The form name prefix for this list; each row renders at `${name}.${i}`. */
+    name: string;
+    /** The seed rows: a list of leaf values, or a list of object slices for an object item. */
+    rows: unknown[];
+    /** The site link targets the reference arm offers (threaded through to each row). */
+    targets: LinkTarget[];
+    /** Mark the edit form dirty; called on add, remove, and reorder (these skip the form's oninput). */
+    markFieldsDirty: () => void;
+    /** The merged committed-plus-uploaded media library, keyed by content hash. */
+    mediaLibrary: Record<string, MediaLibraryEntry>;
+    /** The concept the entry belongs to (the upload action's route param). */
+    conceptId: string;
+    /** The entry id (the upload action's route param). */
+    id: string;
+    /** The host's hero-field refs, keyed by the prefixed `name` so two rows do not collide. */
+    heroFieldRefs: Record<string, MediaHeroField>;
+    /** Called with the server-owned record on a successful upload, so the host merges it. */
+    onuploaded: (record: MediaEntry) => void;
+    /** Called when a hero's needs-alt status changes, keyed by the prefixed `name`. */
+    onheroneedsalt: (name: string, needsAlt: boolean) => void;
+    /** The site's icon set, forwarded to each row's icon arm. */
+    icons?: IconSet;
+}
+/**
+ * The repeatable-row editor, the arm for a non-reference `array` container. It renders a list of rows,
+ * each row either a single leaf (`array(text)`, `array(image)`) or a flat object group
+ * (`array(object({...}))`), with keyboard-operable add, remove, and reorder. Each row collapses to its
+ * `itemLabel` summary and expands to edit, the same buries-fewer-fields move the Details panel makes.
+ *
+ * Rows are wrapped in a `{ id, value }` envelope so node identity follows a row through a reorder or a
+ * remove and an in-progress edit (or the keyboard focus) never jumps to the wrong row. The id is a
+ * seed-time counter, not a random uuid, so the server and client agree at hydration. The envelope is
+ * UI-only; the form names derive from each row's CURRENT position (`${name}.${i}`), so the Task 3
+ * decoder reads a compact, ordered set. The component seeds once from `rows`; the `{#key entryKey}`
+ * wrapper in EditPage remounts it on an entry change, so it adds no re-seed effect.
+ *
+ * A structural mutation (add, remove, reorder) marks the form dirty, because those do not fire the
+ * form's `oninput`; a leaf edit inside a row does not, because the row inputs sit inside the edit form
+ * whose `oninput` bubbles. An always-mounted polite live region announces add and remove.
+ */
+declare const RepeatableField: import("svelte").Component<Props, {}, "">;
+type RepeatableField = ReturnType<typeof RepeatableField>;
+export default RepeatableField;

package/dist/components/cairn-admin.css

@@ -3361,6 +3361,10 @@
     top: calc(var(--spacing) * 16);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .top-\[-3rem\] {
+    top: -3rem;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .top-\[0\.875rem\] {
     top: .875rem;
   }
@@ -3389,6 +3393,10 @@
     left: calc(var(--spacing) * 2);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .left-\[var\(--cairn-space-s\)\] {
+    left: var(--cairn-space-s);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .join {
     --join-ss: 0;
     --join-se: 0;
@@ -3703,6 +3711,10 @@
     z-index: 40;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .z-50 {
+    z-index: 50;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .order-1 {
     order: 1;
   }
@@ -4075,6 +4087,10 @@
     margin-top: calc(var(--spacing) * 16);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mt-\[var\(--cairn-space-2xl\)\] {
+    margin-top: var(--cairn-space-2xl);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mt-auto {
     margin-top: auto;
   }
@@ -4083,6 +4099,10 @@
     margin-top: 1px;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .-mr-1 {
+    margin-right: calc(var(--spacing) * -1);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mr-0\.5 {
     margin-right: calc(var(--spacing) * .5);
   }
@@ -4144,6 +4164,10 @@
     margin-bottom: calc(var(--spacing) * 7);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .mb-\[var\(--cairn-space-s\)\] {
+    margin-bottom: var(--cairn-space-s);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .-ml-px {
     margin-left: -1px;
   }
@@ -4702,6 +4726,14 @@
     height: .6875rem;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .h-\[1\.4rem\] {
+    height: 1.4rem;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .h-\[1\.55rem\] {
+    height: 1.55rem;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .h-\[26px\] {
     height: 26px;
   }
@@ -4758,6 +4790,10 @@
     max-height: 100%;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .min-h-0 {
+    min-height: calc(var(--spacing) * 0);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .min-h-6 {
     min-height: calc(var(--spacing) * 6);
   }
@@ -4916,6 +4952,14 @@
     width: .6875rem;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .w-\[1\.4rem\] {
+    width: 1.4rem;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .w-\[1\.55rem\] {
+    width: 1.55rem;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .w-\[3\.25rem\] {
     width: 3.25rem;
   }
@@ -4968,6 +5012,10 @@
     max-width: 30%;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .max-w-\[38rem\] {
+    max-width: 38rem;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .max-w-\[40ch\] {
     max-width: 40ch;
   }
@@ -4992,6 +5040,14 @@
     max-width: 640px;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .max-w-\[var\(--cairn-measure\)\] {
+    max-width: var(--cairn-measure);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .max-w-\[var\(--cairn-measure-wide\)\] {
+    max-width: var(--cairn-measure-wide);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .max-w-full {
     max-width: 100%;
   }
@@ -5040,7 +5096,7 @@
     flex: none;
   }
 
-  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .shrink {
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .flex-shrink, :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .shrink {
     flex-shrink: 1;
   }
 
@@ -5250,6 +5306,18 @@
     gap: calc(var(--spacing) * 6);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .gap-\[0\.55rem\] {
+    gap: .55rem;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .gap-\[var\(--cairn-space-m\)\] {
+    gap: var(--cairn-space-m);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .gap-\[var\(--cairn-space-s\)\] {
+    gap: var(--cairn-space-s);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .gap-px {
     gap: 1px;
   }
@@ -5476,6 +5544,15 @@
     }
   }
 
+  @layer daisyui.l1.l2 {
+    :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .badge-outline {
+      color: var(--badge-color);
+      --badge-bg: #0000;
+      background-image: none;
+      border-color: currentColor;
+    }
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[color-mix\(in_oklab\,var\(--cairn-card-border\)_70\%\,transparent\)\] {
     border-color: var(--cairn-card-border);
   }
@@ -5546,7 +5623,7 @@
     }
   }
 
-  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[var\(--cairn-card-border\)\] {
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[color\:var\(--cairn-card-border\)\], :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[var\(--cairn-card-border\)\] {
     border-color: var(--cairn-card-border);
   }
 
@@ -5564,6 +5641,10 @@
     border-color: var(--cairn-error-border);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[var\(--color-base-300\)\] {
+    border-color: var(--color-base-300);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .border-\[var\(--color-positive-ink\)\]\/\[0\.22\] {
     border-color: var(--color-positive-ink);
   }
@@ -6245,6 +6326,18 @@
     padding-inline: calc(var(--spacing) * 7);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .px-\[0\.1rem\] {
+    padding-inline: .1rem;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .px-\[0\.9rem\] {
+    padding-inline: .9rem;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .px-\[var\(--cairn-space-m\)\] {
+    padding-inline: var(--cairn-space-m);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .px-px {
     padding-inline: 1px;
   }
@@ -6313,10 +6406,26 @@
     padding-block: calc(var(--spacing) * 16);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .py-\[0\.3rem\] {
+    padding-block: .3rem;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .py-\[0\.5rem\] {
+    padding-block: .5rem;
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .py-\[5px\] {
     padding-block: 5px;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .py-\[var\(--cairn-space-xl\)\] {
+    padding-block: var(--cairn-space-xl);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .py-\[var\(--cairn-space-xs\)\] {
+    padding-block: var(--cairn-space-xs);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .py-px {
     padding-block: 1px;
   }
@@ -6341,6 +6450,18 @@
     padding-top: calc(var(--spacing) * 4);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pt-\[var\(--cairn-space-l\)\] {
+    padding-top: var(--cairn-space-l);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pt-\[var\(--cairn-space-s\)\] {
+    padding-top: var(--cairn-space-s);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pr-1 {
+    padding-right: calc(var(--spacing) * 1);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pr-3 {
     padding-right: calc(var(--spacing) * 3);
   }
@@ -6353,6 +6474,10 @@
     padding-bottom: calc(var(--spacing) * 1.5);
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pb-\[var\(--cairn-space-xl\)\] {
+    padding-bottom: var(--cairn-space-xl);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .pl-3 {
     padding-left: calc(var(--spacing) * 3);
   }
@@ -6377,6 +6502,10 @@
     text-align: right;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .font-\[family-name\:var\(--font-body\)\] {
+    font-family: var(--font-body);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .font-\[family-name\:var\(--font-display\)\] {
     font-family: var(--font-display);
   }
@@ -6482,12 +6611,34 @@
     font-size: 1.0625rem;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .text-\[length\:var\(--cairn-step--1\)\] {
+    font-size: var(--cairn-step--1);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .text-\[length\:var\(--cairn-step-1\)\] {
+    font-size: var(--cairn-step-1);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .text-\[length\:var\(--cairn-step-5\)\] {
+    font-size: var(--cairn-step-5);
+  }
+
   @layer daisyui.l1.l2 {
     :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .textarea-sm {
       font-size: max(var(--font-size, .75rem), .75rem);
     }
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .leading-\[var\(--cairn-leading-snug\)\] {
+    --tw-leading: var(--cairn-leading-snug);
+    line-height: var(--cairn-leading-snug);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .leading-\[var\(--cairn-leading-tight\)\] {
+    --tw-leading: var(--cairn-leading-tight);
+    line-height: var(--cairn-leading-tight);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .leading-relaxed {
     --tw-leading: var(--leading-relaxed);
     line-height: var(--leading-relaxed);
@@ -6548,6 +6699,16 @@
     letter-spacing: .12em;
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .tracking-\[var\(--cairn-tracking-eyebrow\)\] {
+    --tw-tracking: var(--cairn-tracking-eyebrow);
+    letter-spacing: var(--cairn-tracking-eyebrow);
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .tracking-\[var\(--cairn-tracking-tight\)\] {
+    --tw-tracking: var(--cairn-tracking-tight);
+    letter-spacing: var(--cairn-tracking-tight);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .tracking-tight {
     --tw-tracking: var(--tracking-tight);
     letter-spacing: var(--tracking-tight);
@@ -6598,6 +6759,18 @@
     }
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .text-\[Npx\] {
+    color: Npx;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .text-\[Nrem\] {
+    color: Nrem;
+  }
+
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .text-\[color\:var\(--cairn-muted\)\] {
+    color: var(--cairn-muted);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .text-\[var\(--cairn-error-ink\)\] {
     color: var(--cairn-error-ink);
   }
@@ -7358,6 +7531,10 @@
     }
   }
 
+  :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .focus\:top-\[var\(--cairn-space-s\)\]:focus {
+    top: var(--cairn-space-s);
+  }
+
   :where([data-theme='cairn-admin'], [data-theme='cairn-admin-dark']) .focus-visible\:border-\[color-mix\(in_oklab\,var\(--color-primary\)_70\%\,transparent\)\]:focus-visible {
     border-color: var(--color-primary);
   }

package/dist/components/preview-doc.js

@@ -46,9 +46,13 @@ export function buildPreviewDoc(html, preview) {
     // parent's base URL, so a clicked fragment or root link could render the admin login inside
     // the frame. Targeting every link at a new tab turns each click into a popup, and the sandbox
     // (which grants no allow-popups) blocks it, so a proofing click goes nowhere.
+    // The marker on the root lets a site scope an entrance animation (driven off [data-rise]) away
+    // from the preview, which shows the resting state of content and runs the same pipeline; without
+    // it, content would re-animate on every debounced render. cairn provides the hook; the site owns
+    // its animation and decides what to suppress under [data-cairn-preview].
     return [
         '<!doctype html>',
-        '<html>',
+        '<html data-cairn-preview>',
         '<head>',
         '<meta charset="utf-8">',
         '<meta name="viewport" content="width=device-width, initial-scale=1">',

package/dist/components/tidy-validate.js

@@ -36,7 +36,7 @@ const DIVERGENCE_FRACTION = 0.5;
 // text rather than going through extractMediaRefs for two reasons. First, a true MULTISET is the
 // invariant a backstop wants: extractMediaRefs dedups by hash, so a doubled token collapsing to one
 // would read as equal, and the validator must catch a dropped duplicate. Second, the raw scan covers
-// the whole text including frontmatter without threading the concept's FrontmatterField[] to the call
+// the whole text including frontmatter without threading the concept's NamedField[] to the call
 // site, which the validator otherwise has no reason to know. A token mangled inside a code fence is
 // caught here too, redundantly with the code check, which is the right posture for a backstop.
 const MEDIA_TOKEN = /media:[A-Za-z0-9.-]+/g;

package/dist/content/adapter.js

@@ -1,4 +1,22 @@
+// Fail closed on an inconsistent island registry: a hydrate component with no live component, or a
+// registered island with no hydrate component. Either is a wiring mistake the site author should see at
+// build time, not a silent forever-fallback. Read-only over the rendering group; imports no runtime.
+function assertIslandsConsistent(rendering) {
+    const islands = rendering.islands ?? {};
+    const hydrated = new Set((rendering.components?.defs ?? []).filter((d) => d.hydrate).map((d) => d.name));
+    for (const name of hydrated) {
+        if (!(name in islands)) {
+            throw new Error(`cairn: component '${name}' declares hydrate but rendering.islands has no entry for it.`);
+        }
+    }
+    for (const name of Object.keys(islands)) {
+        if (!hydrated.has(name)) {
+            throw new Error(`cairn: rendering.islands has '${name}' but no component declares hydrate for it.`);
+        }
+    }
+}
 /** Declare a site's adapter while preserving each concept's concrete schema type for typed reads. */
 export function defineAdapter(adapter) {
+    assertIslandsConsistent(adapter.rendering);
     return adapter;
 }

package/dist/content/advisories.d.ts

@@ -1,5 +1,5 @@
 import type { ConceptDescriptor } from './types.js';
-import type { RepoRef } from '../github/types.js';
+import type { Backend } from '../github/backend.js';
 import type { Manifest } from './manifest.js';
 /** One action an advisory offers, as a label and an optional link target. */
 export interface AdvisoryAction {
@@ -45,7 +45,7 @@ export declare function mainAddressIndex(manifest: Manifest): AddressIndex;
  * and skipped, so a transient failure degrades to a thinner index, never a thrown editor or a blocked
  * publish. The branches are read in one Promise.all, the way buildUsageIndex reads them.
  */
-export declare function buildAddressIndex(repo: RepoRef, token: string, concepts: ConceptDescriptor[], manifest: Manifest): Promise<AddressIndex>;
+export declare function buildAddressIndex(backend: Backend, concepts: ConceptDescriptor[], manifest: Manifest): Promise<AddressIndex>;
 /**
  * Find the first other entry that already resolves to an address, or null when the address is free
  * or holds only the entry itself. The self entry is identified by its concept and id together.

package/dist/content/advisories.js

@@ -1,5 +1,3 @@
-import { listBranches } from '../github/branches.js';
-import { readRaw } from '../github/repo.js';
 import { PENDING_PREFIX, parsePendingBranch } from './pending.js';
 import { findConcept } from './concepts.js';
 import { isValidId, filenameFromId } from './ids.js';
@@ -37,13 +35,13 @@ export function mainAddressIndex(manifest) {
  * and skipped, so a transient failure degrades to a thinner index, never a thrown editor or a blocked
  * publish. The branches are read in one Promise.all, the way buildUsageIndex reads them.
  */
-export async function buildAddressIndex(repo, token, concepts, manifest) {
+export async function buildAddressIndex(backend, concepts, manifest) {
     // The main arm: the manifest already carries each entry's resolved permalink, so seed from the
     // synchronous main-only index and union the branch arm on top.
     const index = mainAddressIndex(manifest);
     // The branch arm: read each open cairn/* branch's one edited file and resolve its permalink. The
     // path is derivable from the branch name, so no tree-listing is needed.
-    const names = await listBranches(repo, PENDING_PREFIX, token);
+    const names = await backend.listBranches(PENDING_PREFIX);
     const perBranch = await Promise.all(names.map(async (name) => {
         // Resolve the branch name with the branch tooling's guard: a malformed name, an id that fails
         // the slug rule, or an unconfigured concept is skipped with no read attempted.
@@ -55,7 +53,7 @@ export async function buildAddressIndex(repo, token, concepts, manifest) {
             return null;
         const path = `${concept.dir}/${filenameFromId(ref.id)}`;
         try {
-            const raw = await readRaw({ ...repo, branch: name }, path, token);
+            const raw = await backend.readFile(path, name);
             if (raw === null)
                 return null; // The file is absent on the branch: nothing to resolve.
             const { frontmatter } = parseMarkdown(raw);

package/dist/content/compose.d.ts

@@ -1,9 +1,9 @@
 import type { CairnAdapter, CairnExtension, CairnRuntime } from './types.js';
 import { type SiteConfig } from '../nav/site-config.js';
 /**
- * The input to {@link composeRuntime}. `siteConfig` is required so the per-concept URL policy is
- *  always derived from one source and can never be silently dropped. `extensions` fold in after the
- *  adapter's concepts.
+ * The input to {@link composeRuntime}. `siteConfig` is required: it is the canonical home for the
+ *  site name, the spellcheck dialect, and the tidy block, so they can never be silently dropped.
+ *  `extensions` fold in after the adapter's concepts.
  */
 export interface ComposeInput {
     adapter: CairnAdapter;
@@ -11,9 +11,10 @@ export interface ComposeInput {
     extensions?: CairnExtension[];
 }
 /**
- * Fold an adapter and any extensions into the composed runtime (seam 2). The per-concept URL policy
- * is derived from the site config, the same source the delivery path uses, so the runtime and
- * delivery permalinks cannot diverge. Extension concepts merge after the adapter's. The asset slot
+ * Fold an adapter and any extensions into the composed runtime (seam 2). This is the one place the
+ * grouped adapter maps onto the flat runtime, and the one place the internal manifest and dictionary
+ * paths default by convention. Each concept declares its own routing and URL policy, so the runtime
+ * and delivery permalinks cannot diverge. Extension concepts merge after the adapter's. The media slot
  * (seam 4) passes through untouched.
  */
 export declare function composeRuntime({ adapter, siteConfig, extensions }: ComposeInput): CairnRuntime;

package/dist/content/compose.js

@@ -1,15 +1,23 @@
 import { resolveConcepts } from './concepts.js';
 import { normalizeAssets } from '../media/config.js';
 import { dictionaryFileForDialect } from '../nav/site-config.js';
+// The internal artifact paths the adapter does not carry. They share the `.cairn/` content root the
+// manifests use, so `composeRuntime` defaults them by convention rather than reading them off config.
+// The personal dictionary sits beside the manifests, so the spec's `content/.cairn/dictionary.txt`
+// resolves the same configurable way the manifest paths do.
+const CONTENT_MANIFEST_PATH = 'src/content/.cairn/index.json';
+const MEDIA_MANIFEST_PATH = 'src/content/.cairn/media.json';
+const DICTIONARY_PATH = 'src/content/.cairn/dictionary.txt';
 /**
- * Fold an adapter and any extensions into the composed runtime (seam 2). The per-concept URL policy
- * is derived from the site config, the same source the delivery path uses, so the runtime and
- * delivery permalinks cannot diverge. Extension concepts merge after the adapter's. The asset slot
+ * Fold an adapter and any extensions into the composed runtime (seam 2). This is the one place the
+ * grouped adapter maps onto the flat runtime, and the one place the internal manifest and dictionary
+ * paths default by convention. Each concept declares its own routing and URL policy, so the runtime
+ * and delivery permalinks cannot diverge. Extension concepts merge after the adapter's. The media slot
  * (seam 4) passes through untouched.
  */
 export function composeRuntime({ adapter, siteConfig, extensions = [] }) {
     if (!siteConfig)
-        throw new Error('composeRuntime needs a site config to derive the URL policy');
+        throw new Error('composeRuntime needs a site config for the site name and editor settings');
     const content = { ...adapter.content };
     const adminPanels = [];
     const fieldTypes = [];
@@ -24,23 +32,21 @@ export function composeRuntime({ adapter, siteConfig, extensions = [] }) {
             fieldTypes.push(...extension.fieldTypes);
     }
     return {
-        siteName: adapter.siteName,
-        concepts: resolveConcepts(content, siteConfig),
+        siteName: siteConfig.siteName,
+        concepts: resolveConcepts(content),
         backend: adapter.backend,
-        sender: adapter.sender,
-        supportContact: adapter.supportContact,
-        render: adapter.render,
-        manifestPath: adapter.manifestPath ?? 'src/content/.cairn/index.json',
-        registry: adapter.registry,
-        icons: adapter.icons,
-        navMenu: adapter.navMenu,
-        preview: adapter.preview,
-        assets: adapter.assets,
-        resolvedAssets: normalizeAssets(adapter.assets),
-        mediaManifestPath: adapter.mediaManifestPath ?? 'src/content/.cairn/media.json',
-        // The personal dictionary sits beside the manifests under the same `.cairn/` content root, so the
-        // spec's `content/.cairn/dictionary.txt` resolves the same configurable way the manifest paths do.
-        dictionaryPath: adapter.dictionaryPath ?? 'src/content/.cairn/dictionary.txt',
+        sender: adapter.email,
+        supportContact: adapter.editor?.supportContact,
+        render: adapter.rendering.render,
+        manifestPath: CONTENT_MANIFEST_PATH,
+        registry: adapter.rendering.components,
+        icons: adapter.rendering.icons,
+        navMenu: adapter.editor?.nav,
+        preview: adapter.editor?.preview,
+        assets: adapter.media,
+        resolvedAssets: normalizeAssets(adapter.media),
+        mediaManifestPath: MEDIA_MANIFEST_PATH,
+        dictionaryPath: DICTIONARY_PATH,
         // The spellcheck dictionary is resolved once here from the site config's dialect (default US),
         // so the runtime and the editor never re-derive it. The site config is the one home for the
         // dialect; the editor resolves this filename to a real asset URL on the main thread.

package/dist/content/concepts.d.ts

@@ -1,24 +1,30 @@
 import type { ConceptConfig, ConceptDescriptor, ConceptUrlPolicy, RoutingRule } from './types.js';
-import { type SiteConfig } from '../nav/site-config.js';
+/** Expand a concept's routing shorthand to a concrete rule. The single resolution point: omitted is `page`. */
+export declare function resolveRouting(routing: ConceptConfig['routing']): RoutingRule;
 /**
- * Concept-fixed routing, keyed by concept id (spec §7.2). Posts are dated feed entries;
- * pages are plain navigable structure. Not in adapter config. A future Fragments adds one
- * entry here and one key under `content`.
+ * Declare a concept while preserving its fieldset type for typed reads, and validate its URL policy at
+ * declaration so a bad permalink or datePrefix fails at module load rather than at a defaulted render.
+ * Mirrors {@link defineAdapter}; the validation is the build-independent net for a concept with no entries.
  */
-export declare const CONCEPT_ROUTING: Readonly<Record<string, RoutingRule>>;
+export declare function defineConcept<const C extends ConceptConfig>(concept: C): C;
 /**
- * Normalize an adapter's declared concepts into uniform descriptors (seam 1). URL policy
- * (`permalink`, `datePrefix`) comes from the YAML site-config, passed here as `urlPolicy` keyed by
- * concept id; each value defaults when the YAML omits it (`/:slug` for Pages, `/<id>/:slug`
- * otherwise; `datePrefix` defaults to `day`). `routing` is injectable so a contract test can prove
- * a new concept attaches additively; production passes the default `CONCEPT_ROUTING`.
+ * Validate one concept's URL policy at build, so a misconfigured permalink or datePrefix fails loudly
+ * here rather than emitting a wrong or defaulted URL at render. The permalink must be root-relative and
+ * use only known tokens, a date token requires a dated concept, and the datePrefix must be in range.
  */
-export declare function normalizeConcepts(content: Record<string, ConceptConfig | undefined>, urlPolicy?: Record<string, ConceptUrlPolicy | undefined>, routing?: Readonly<Record<string, RoutingRule>>): ConceptDescriptor[];
+export declare function validateUrlPolicy(id: string, policy: ConceptUrlPolicy, dated: boolean): void;
 /**
- * Resolve a site's concept descriptors from its content map and parsed site config. The admin runtime
- * (composeRuntime) and the delivery layer (siteDescriptors) both call this, so the per-concept URL
- * policy is derived once from the YAML and the runtime and delivery permalinks cannot diverge.
+ * Normalize an adapter's declared concepts into uniform descriptors (seam 1). Each concept declares its
+ * own routing (a shorthand or an explicit rule, resolved by `resolveRouting`) and URL policy
+ * (`permalink`, `datePrefix`) on the config; both default when omitted (`/:slug` for Pages, `/<id>/:slug`
+ * otherwise; `datePrefix` defaults to `day`). A new concept attaches by adding one key under `content`.
  */
-export declare function resolveConcepts(content: Record<string, ConceptConfig | undefined>, siteConfig: SiteConfig): ConceptDescriptor[];
+export declare function normalizeConcepts(content: Record<string, ConceptConfig | undefined>): ConceptDescriptor[];
+/**
+ * Resolve a site's concept descriptors from its content map. The admin runtime (composeRuntime) and the
+ * delivery layer (siteDescriptors) both call this, so the per-concept routing and URL policy are derived
+ * once from the concept declarations and the runtime and delivery permalinks cannot diverge.
+ */
+export declare function resolveConcepts(content: Record<string, ConceptConfig | undefined>): ConceptDescriptor[];
 /** Look up a normalized concept by id, or undefined when the site does not enable it. */
 export declare function findConcept(concepts: ConceptDescriptor[], id: string): ConceptDescriptor | undefined;