@glw907/cairn-cms 0.60.0 → 0.62.1

package/dist/render/registry.d.ts

@@ -20,14 +20,18 @@ export interface AttributeField {
         source: string;
         message: string;
     };
-    /** A pure, browser-safe cross-field validator. Returns an error string, or null when valid.
+    /**
+     * A pure, browser-safe cross-field validator. Returns an error string, or null when valid.
      *  Receives the field's value and the full {@link ComponentValues} so a rule can read sibling
-     *  fields. The picker wraps the call in try/catch so an author's throw never crashes the form. */
+     *  fields. The picker wraps the call in try/catch so an author's throw never crashes the form.
+     */
     validate?: (value: string | boolean, all: ComponentValues) => string | null;
 }
 export type SlotKind = 'markdown' | 'inline' | 'repeatable';
-/** One named content region of a component. The slots named `title` and `body` are special: `title`
- *  serializes to the directive `[label]` and `body` to the unmarked content (see the canonical grammar). */
+/**
+ * One named content region of a component. The slots named `title` and `body` are special: `title`
+ *  serializes to the directive `[label]` and `body` to the unmarked content (see the canonical grammar).
+ */
 export interface SlotDef {
     name: string;
     label: string;
@@ -36,14 +40,18 @@ export interface SlotDef {
     help?: string;
     /** For `kind: 'repeatable'`: the fields composing each list item (v1 uses the first field). */
     itemFields?: AttributeField[];
-    /** For `kind: 'repeatable'`: derives a row's label from its item values and zero-based index.
-     *  When it returns nothing, the picker falls back to `${label} ${index + 1}`. */
+    /**
+     * For `kind: 'repeatable'`: derives a row's label from its item values and zero-based index.
+     *  When it returns nothing, the picker falls back to `${label} ${index + 1}`.
+     */
     itemLabel?: (item: Record<string, string | boolean>, index: number) => string;
 }
-/** The structured input a component's `build` receives. The engine stamps the component's
+/**
+ * The structured input a component's `build` receives. The engine stamps the component's
  *  attributes and partitions its slots from the rendered hast, so `build` arranges hast and
  *  never walks the tree. `slot(name)` returns a slot's rendered children (title, body, or any
- *  named slot); `items(name)` returns a repeatable slot's items, one child list per item. */
+ *  named slot); `items(name)` returns a repeatable slot's items, one child list per item.
+ */
 export interface ComponentContext {
     /** Declared attribute values, keyed by attribute key. Booleans are real booleans. */
     attributes: Record<string, string | boolean>;
@@ -64,9 +72,11 @@ export interface ComponentDef {
     description: string;
     /** Markdown scaffold inserted at the cursor by the editor palette. */
     insertTemplate?: string;
-    /** Build the final hast element from the component context (attributes plus partitioned
+    /**
+     * Build the final hast element from the component context (attributes plus partitioned
      *  slots). The engine stamps the entrance-stagger ordinal (`data-rise`) on the top-level
-     *  result, so a build fn stays free of any motion concern. */
+     *  result, so a build fn stays free of any motion concern.
+     */
     build: (ctx: ComponentContext) => Element;
     /** Optional role-to-default-icon, e.g. `{ caution: 'warning' }`. */
     defaultIconByRole?: Record<string, string>;
@@ -82,8 +92,10 @@ export interface ComponentDef {
     group?: string;
     /** Omit from the top-level picker (for a nested or round-trip-only component). */
     hidden?: boolean;
-    /** A structured sample the picker seeds the form with and renders through the same path a real
-     *  insert takes. Declaring `preview` is what opts the component into the two-pane configure layout. */
+    /**
+     * A structured sample the picker seeds the form with and renders through the same path a real
+     *  insert takes. Declaring `preview` is what opts the component into the two-pane configure layout.
+     */
     preview?: {
         attributes?: Record<string, string | boolean>;
         slots?: Record<string, string | string[]>;
@@ -97,9 +109,11 @@ export interface ComponentRegistry {
     /** The component's first `type:'icon'` attribute, or undefined when it declares none. */
     iconField(name: string): AttributeField | undefined;
 }
-/** The hast property name carrying one declared attribute from stamp to dispatch, e.g. `tone`
+/**
+ * The hast property name carrying one declared attribute from stamp to dispatch, e.g. `tone`
  *  becomes `dataAttrTone`. The directive stamp writes it and the rehype dispatch reads it, so both
- *  sides derive the name from this one helper rather than spelling the capitalize twice. */
+ *  sides derive the name from this one helper rather than spelling the capitalize twice.
+ */
 export declare function dataAttrProp(key: string): string;
 /**
  * Build a registry from a site's component definitions. The single source the render
@@ -108,16 +122,22 @@ export declare function dataAttrProp(key: string): string;
 export declare function defineRegistry({ components }: {
     components: ComponentDef[];
 }): ComponentRegistry;
-/** Guided-form values for one component: attribute values keyed by attribute key, slot values keyed
- *  by slot name (a string, or a string list for a repeatable slot). */
+/**
+ * Guided-form values for one component: attribute values keyed by attribute key, slot values keyed
+ *  by slot name (a string, or a string list for a repeatable slot).
+ */
 export interface ComponentValues {
     attributes: Record<string, string | boolean>;
     slots: Record<string, string | string[]>;
 }
-/** Seed an empty {@link ComponentValues} from a component's schema: attribute defaults (or '' / false)
- *  and empty slot values ([] for repeatable, '' otherwise). */
+/**
+ * Seed an empty {@link ComponentValues} from a component's schema: attribute defaults (or '' / false)
+ *  and empty slot values ([] for repeatable, '' otherwise).
+ */
 export declare function emptyValues(def: ComponentDef): ComponentValues;
-/** Seed {@link ComponentValues} from a component's `preview` sample: the {@link emptyValues} base
+/**
+ * Seed {@link ComponentValues} from a component's `preview` sample: the {@link emptyValues} base
  *  with `def.preview.attributes` and `def.preview.slots` overlaid (a shallow merge per side). When
- *  the def declares no `preview`, returns exactly the {@link emptyValues} output. */
+ *  the def declares no `preview`, returns exactly the {@link emptyValues} output.
+ */
 export declare function previewValues(def: ComponentDef): ComponentValues;

package/dist/render/registry.js

@@ -1,12 +1,16 @@
-/** The hast property name carrying one declared attribute from stamp to dispatch, e.g. `tone`
+/**
+ * The hast property name carrying one declared attribute from stamp to dispatch, e.g. `tone`
  *  becomes `dataAttrTone`. The directive stamp writes it and the rehype dispatch reads it, so both
- *  sides derive the name from this one helper rather than spelling the capitalize twice. */
+ *  sides derive the name from this one helper rather than spelling the capitalize twice.
+ */
 export function dataAttrProp(key) {
     return `dataAttr${key.charAt(0).toUpperCase()}${key.slice(1)}`;
 }
-/** A component's first `type:'icon'` attribute, or undefined when it declares none. Both the
+/**
+ * A component's first `type:'icon'` attribute, or undefined when it declares none. Both the
  *  construction-time guard and the registry's `iconField` derive the icon field from this one
- *  predicate rather than spelling the `type === 'icon'` find twice. */
+ *  predicate rather than spelling the `type === 'icon'` find twice.
+ */
 function findIconField(def) {
     return def.attributes?.find((field) => field.type === 'icon');
 }
@@ -35,8 +39,10 @@ export function defineRegistry({ components }) {
         },
     };
 }
-/** Seed an empty {@link ComponentValues} from a component's schema: attribute defaults (or '' / false)
- *  and empty slot values ([] for repeatable, '' otherwise). */
+/**
+ * Seed an empty {@link ComponentValues} from a component's schema: attribute defaults (or '' / false)
+ *  and empty slot values ([] for repeatable, '' otherwise).
+ */
 export function emptyValues(def) {
     const attributes = {};
     for (const field of def.attributes ?? []) {
@@ -48,9 +54,11 @@ export function emptyValues(def) {
     }
     return { attributes, slots };
 }
-/** Seed {@link ComponentValues} from a component's `preview` sample: the {@link emptyValues} base
+/**
+ * Seed {@link ComponentValues} from a component's `preview` sample: the {@link emptyValues} base
  *  with `def.preview.attributes` and `def.preview.slots` overlaid (a shallow merge per side). When
- *  the def declares no `preview`, returns exactly the {@link emptyValues} output. */
+ *  the def declares no `preview`, returns exactly the {@link emptyValues} output.
+ */
 export function previewValues(def) {
     const base = emptyValues(def);
     if (!def.preview)

package/dist/render/rehype-dispatch.d.ts

@@ -1,9 +1,17 @@
 import type { Root, Element, ElementContent } from 'hast';
 import { type ComponentContext, type ComponentRegistry } from './registry.js';
+/**
+ *
+ */
 export declare function isElement(node: ElementContent | undefined): node is Element;
-/** Read a declared string attribute off the component context, returning undefined for a boolean or
- *  absent value. Replaces the `typeof ctx.attributes[key] === 'string'` narrowing a build repeats. */
+/**
+ * Read a declared string attribute off the component context, returning undefined for a boolean or
+ *  absent value. Replaces the `typeof ctx.attributes[key] === 'string'` narrowing a build repeats.
+ */
 export declare function strAttr(ctx: ComponentContext, key: string): string | undefined;
+/**
+ *
+ */
 export declare function strProp(node: Element, name: string): string | undefined;
 /** Wrap a pre-built glyph in an ec-icon span; secondary role adds the modifier. */
 export declare function iconSpan(glyphEl: Element, role?: string): Element;
@@ -11,18 +19,24 @@ export declare function iconSpan(glyphEl: Element, role?: string): Element;
 export type MakeIcon = (name: string, role?: string) => Element;
 /** Section wrapper: `<section class=…><div class="card-body">…</div></section>`. */
 export declare function cardShell(classes: string[], body: ElementContent[]): Element;
-/** Card head row: `<div class="ec-head">[icon]<hN class="card-title">{title}</hN></div>`.
+/**
+ * Card head row: `<div class="ec-head">[icon]<hN class="card-title">{title}</hN></div>`.
  *  Pass the title's inline children, an optional pre-built icon element, and an optional heading
  *  level (default 2). This factors the icon-plus-heading head that a titled component build would
- *  otherwise rebuild by hand (the shape the removed `splitHead` produced). */
+ *  otherwise rebuild by hand (the shape the removed `splitHead` produced).
+ */
 export declare function headRow(title: ElementContent[], icon?: Element, level?: number): Element;
-/** Tag the first <ul> among children with `ec-grid` and strip its whitespace-only
- *  text nodes so the bare list serializes without newlines. Returns that <ul>. */
+/**
+ * Tag the first <ul> among children with `ec-grid` and strip its whitespace-only
+ *  text nodes so the bare list serializes without newlines. Returns that <ul>.
+ */
 export declare function markFirstList(children: ElementContent[]): Element | undefined;
-/** Rehype transformer: dispatch each stamped element through its registry `build`
+/**
+ * Rehype transformer: dispatch each stamped element through its registry `build`
  *  fn. When `stagger` is on, each top-level primitive gets a `data-rise` attribute
  *  carrying its document-order index (0, 1, 2, …); the site's CSS maps that ordinal
  *  to an entrance delay. The index is inert, so a consumer's sanitize floor can keep
  *  `data-rise` while dropping `style`. Nested primitives never get it. Non-primitive
- *  content (lede, intro paragraphs, the page-toc nav) passes through untouched. */
+ *  content (lede, intro paragraphs, the page-toc nav) passes through untouched.
+ */
 export declare function rehypeDispatch(registry: ComponentRegistry, stagger?: boolean): (tree: Root) => void;

package/dist/render/rehype-dispatch.js

@@ -1,10 +1,15 @@
 import { h } from 'hastscript';
 import { dataAttrProp } from './registry.js';
+/**
+ *
+ */
 export function isElement(node) {
     return !!node && node.type === 'element';
 }
-/** Read a declared string attribute off the component context, returning undefined for a boolean or
- *  absent value. Replaces the `typeof ctx.attributes[key] === 'string'` narrowing a build repeats. */
+/**
+ * Read a declared string attribute off the component context, returning undefined for a boolean or
+ *  absent value. Replaces the `typeof ctx.attributes[key] === 'string'` narrowing a build repeats.
+ */
 export function strAttr(ctx, key) {
     const value = ctx.attributes[key];
     return typeof value === 'string' ? value : undefined;
@@ -12,6 +17,9 @@ export function strAttr(ctx, key) {
 // hast Properties values are PropertyValue (string | number | boolean | array | null).
 // Directive markers (dataPrimitive/dataRole/dataAttr<Key>) are always stamped as strings;
 // this reads them back with that guarantee instead of casting at each call site.
+/**
+ *
+ */
 export function strProp(node, name) {
     const value = node.properties?.[name];
     return typeof value === 'string' ? value : undefined;
@@ -25,10 +33,12 @@ export function iconSpan(glyphEl, role) {
 export function cardShell(classes, body) {
     return h('section', { className: classes }, [h('div', { className: ['card-body'] }, body)]);
 }
-/** Card head row: `<div class="ec-head">[icon]<hN class="card-title">{title}</hN></div>`.
+/**
+ * Card head row: `<div class="ec-head">[icon]<hN class="card-title">{title}</hN></div>`.
  *  Pass the title's inline children, an optional pre-built icon element, and an optional heading
  *  level (default 2). This factors the icon-plus-heading head that a titled component build would
- *  otherwise rebuild by hand (the shape the removed `splitHead` produced). */
+ *  otherwise rebuild by hand (the shape the removed `splitHead` produced).
+ */
 export function headRow(title, icon, level = 2) {
     const children = [];
     if (icon)
@@ -36,8 +46,10 @@ export function headRow(title, icon, level = 2) {
     children.push(h(`h${level}`, { className: ['card-title'] }, title));
     return h('div', { className: ['ec-head'] }, children);
 }
-/** Tag the first <ul> among children with `ec-grid` and strip its whitespace-only
- *  text nodes so the bare list serializes without newlines. Returns that <ul>. */
+/**
+ * Tag the first <ul> among children with `ec-grid` and strip its whitespace-only
+ *  text nodes so the bare list serializes without newlines. Returns that <ul>.
+ */
 export function markFirstList(children) {
     const ul = children.find((c) => isElement(c) && c.tagName === 'ul');
     if (ul) {
@@ -133,12 +145,14 @@ function transformNode(node, registry) {
     };
     return def.build(ctx);
 }
-/** Rehype transformer: dispatch each stamped element through its registry `build`
+/**
+ * Rehype transformer: dispatch each stamped element through its registry `build`
  *  fn. When `stagger` is on, each top-level primitive gets a `data-rise` attribute
  *  carrying its document-order index (0, 1, 2, …); the site's CSS maps that ordinal
  *  to an entrance delay. The index is inert, so a consumer's sanitize floor can keep
  *  `data-rise` while dropping `style`. Nested primitives never get it. Non-primitive
- *  content (lede, intro paragraphs, the page-toc nav) passes through untouched. */
+ *  content (lede, intro paragraphs, the page-toc nav) passes through untouched.
+ */
 export function rehypeDispatch(registry, stagger) {
     return (tree) => {
         let idx = 0;

package/dist/render/remark-directives.d.ts

@@ -1,3 +1,6 @@
 import type { Root } from 'mdast';
 import { type ComponentRegistry } from './registry.js';
+/**
+ *
+ */
 export declare function remarkDirectiveStamp(registry: ComponentRegistry): (tree: Root) => void;

package/dist/render/remark-directives.js

@@ -51,6 +51,9 @@ function restoreLiteral(node) {
 // component name, icon, and role. No structure is built here; the rehype
 // dispatcher rewrites the marked elements once their children are hast.
 // Text and leaf directives are restored to literal text (accidental prose colons).
+/**
+ *
+ */
 export function remarkDirectiveStamp(registry) {
     const known = new Set(registry.names);
     return (tree) => {

package/dist/render/remark-figure.d.ts

@@ -1,4 +1,6 @@
 import type { Root } from 'mdast';
-/** Rewrite the reserved `figure` container directive into a placed <figure>. Every other directive
- *  is left to remarkDirectiveStamp, which already skips unregistered names. */
+/**
+ * Rewrite the reserved `figure` container directive into a placed <figure>. Every other directive
+ *  is left to remarkDirectiveStamp, which already skips unregistered names.
+ */
 export declare function remarkFigure(): (tree: Root) => void;

package/dist/render/remark-figure.js

@@ -42,8 +42,10 @@ function trimLeadingNewline(children) {
     }
     return children;
 }
-/** Rewrite the reserved `figure` container directive into a placed <figure>. Every other directive
- *  is left to remarkDirectiveStamp, which already skips unregistered names. */
+/**
+ * Rewrite the reserved `figure` container directive into a placed <figure>. Every other directive
+ *  is left to remarkDirectiveStamp, which already skips unregistered names.
+ */
 export function remarkFigure() {
     return (tree) => {
         visit(tree, 'containerDirective', (node) => {

package/dist/render/resolve-links.d.ts

@@ -1,7 +1,9 @@
 import type { VFile } from 'vfile';
 /** The VFile data key the renderer sets the per-call resolver under. */
 export declare const CAIRN_RESOLVE = "cairnResolve";
-/** Resolve cairn: link nodes against the VFile's resolver. A non-cairn href and a malformed token
+/**
+ * Resolve cairn: link nodes against the VFile's resolver. A non-cairn href and a malformed token
  *  pass through. A missing target is marked with the cairn-broken-link class (the resolver returns
- *  undefined) or, when the resolver throws, the error propagates and fails the build. */
+ *  undefined) or, when the resolver throws, the error propagates and fails the build.
+ */
 export declare function remarkResolveCairnLinks(): (tree: unknown, file: VFile) => void;

package/dist/render/resolve-links.js

@@ -7,9 +7,11 @@ import { visit } from 'unist-util-visit';
 import { parseCairnToken } from '../content/links.js';
 /** The VFile data key the renderer sets the per-call resolver under. */
 export const CAIRN_RESOLVE = 'cairnResolve';
-/** Resolve cairn: link nodes against the VFile's resolver. A non-cairn href and a malformed token
+/**
+ * Resolve cairn: link nodes against the VFile's resolver. A non-cairn href and a malformed token
  *  pass through. A missing target is marked with the cairn-broken-link class (the resolver returns
- *  undefined) or, when the resolver throws, the error propagates and fails the build. */
+ *  undefined) or, when the resolver throws, the error propagates and fails the build.
+ */
 export function remarkResolveCairnLinks() {
     return (tree, file) => {
         const resolve = file.data[CAIRN_RESOLVE];

package/dist/render/resolve-media.d.ts

@@ -4,31 +4,39 @@ import { type MediaManifest } from '../media/manifest.js';
 import type { ResolvedAssetConfig } from '../media/config.js';
 /** The VFile data key the renderer sets the per-call media resolver under. */
 export declare const MEDIA_RESOLVE = "mediaResolve";
-/** Resolve a media reference to its delivery URL. `undefined` is a preview miss (the plugin marks
+/**
+ * Resolve a media reference to its delivery URL. `undefined` is a preview miss (the plugin marks
  *  the image broken); a resolver that throws is the build backstop (the error propagates out of
- *  render and fails the build), exactly like LinkResolve. */
+ *  render and fails the build), exactly like LinkResolve.
+ */
 export type MediaResolve = (ref: MediaRef) => string | undefined;
-/** Build the per-call media resolver, closing over the manifest and the resolved config. The
+/**
+ * Build the per-call media resolver, closing over the manifest and the resolved config. The
  *  returned resolver looks a ref's content hash up in the manifest and builds the canonical delivery
  *  path from the manifest entry's slug and ext, not the token's, so a rename never breaks the
  *  reference. With a preset and zone transformations on it returns the variant URL; without a preset,
  *  or when transformations are off, it returns the bare full-size path so a fresh zone with Image
  *  Transformations disabled serves correct thumbnails rather than dead /cdn-cgi/image URLs. It returns
- *  undefined when media is off or no entry carries the hash (the preview-miss backstop). */
+ *  undefined when media is off or no entry carries the hash (the preview-miss backstop).
+ */
 export declare function makeMediaResolver(manifest: MediaManifest, resolved: ResolvedAssetConfig, opts?: {
     preset?: string;
 }): MediaResolve;
-/** A resolver backed by the lean `mediaTargets` projection, for the admin preview. It mirrors
+/**
+ * A resolver backed by the lean `mediaTargets` projection, for the admin preview. It mirrors
  *  manifestLinkResolver: a hash present in the projection builds the slug delivery path
  *  (`/media/<slug>.<hash>.<ext>`); a miss returns undefined, so the render step marks the image
  *  broken rather than throwing. Pure over the projection, with no manifest and no config, so the
- *  edit page reaches it with the data it actually has. */
+ *  edit page reaches it with the data it actually has.
+ */
 export declare function manifestMediaResolver(targets: Record<string, {
     slug: string;
     ext: string;
     contentType: string;
 }>): MediaResolve;
-/** Resolve media: image nodes against the VFile's resolver. A non-media src and a malformed token
+/**
+ * Resolve media: image nodes against the VFile's resolver. A non-media src and a malformed token
  *  pass through. A missing target is marked with the cairn-broken-media class (the resolver returns
- *  undefined) or, when the resolver throws, the error propagates and fails the build. */
+ *  undefined) or, when the resolver throws, the error propagates and fails the build.
+ */
 export declare function remarkResolveMedia(): (tree: unknown, file: VFile) => void;

package/dist/render/resolve-media.js

@@ -11,13 +11,15 @@ import { presetUrl } from '../media/transform-url.js';
 import { log } from '../log/index.js';
 /** The VFile data key the renderer sets the per-call media resolver under. */
 export const MEDIA_RESOLVE = 'mediaResolve';
-/** Build the per-call media resolver, closing over the manifest and the resolved config. The
+/**
+ * Build the per-call media resolver, closing over the manifest and the resolved config. The
  *  returned resolver looks a ref's content hash up in the manifest and builds the canonical delivery
  *  path from the manifest entry's slug and ext, not the token's, so a rename never breaks the
  *  reference. With a preset and zone transformations on it returns the variant URL; without a preset,
  *  or when transformations are off, it returns the bare full-size path so a fresh zone with Image
  *  Transformations disabled serves correct thumbnails rather than dead /cdn-cgi/image URLs. It returns
- *  undefined when media is off or no entry carries the hash (the preview-miss backstop). */
+ *  undefined when media is off or no entry carries the hash (the preview-miss backstop).
+ */
 export function makeMediaResolver(manifest, resolved, opts) {
     return (ref) => {
         if (!resolved.enabled)
@@ -36,11 +38,13 @@ export function makeMediaResolver(manifest, resolved, opts) {
         return path;
     };
 }
-/** A resolver backed by the lean `mediaTargets` projection, for the admin preview. It mirrors
+/**
+ * A resolver backed by the lean `mediaTargets` projection, for the admin preview. It mirrors
  *  manifestLinkResolver: a hash present in the projection builds the slug delivery path
  *  (`/media/<slug>.<hash>.<ext>`); a miss returns undefined, so the render step marks the image
  *  broken rather than throwing. Pure over the projection, with no manifest and no config, so the
- *  edit page reaches it with the data it actually has. */
+ *  edit page reaches it with the data it actually has.
+ */
 export function manifestMediaResolver(targets) {
     return (ref) => {
         const entry = targets[ref.hash];
@@ -49,9 +53,11 @@ export function manifestMediaResolver(targets) {
         return publicPath(entry.slug, ref.hash, entry.ext, 'slug');
     };
 }
-/** Resolve media: image nodes against the VFile's resolver. A non-media src and a malformed token
+/**
+ * Resolve media: image nodes against the VFile's resolver. A non-media src and a malformed token
  *  pass through. A missing target is marked with the cairn-broken-media class (the resolver returns
- *  undefined) or, when the resolver throws, the error propagates and fails the build. */
+ *  undefined) or, when the resolver throws, the error propagates and fails the build.
+ */
 export function remarkResolveMedia() {
     return (tree, file) => {
         const resolve = file.data[MEDIA_RESOLVE];

package/dist/sveltekit/admin-dispatch.d.ts

@@ -21,6 +21,8 @@ export type AdminView = {
     view: 'media';
 } | {
     view: 'settings';
+} | {
+    view: 'help';
 };
 /**
  * Parse a raw `URL.pathname` (the caller passes `event.url.pathname`, never a SvelteKit rest

package/dist/sveltekit/admin-dispatch.js

@@ -3,10 +3,12 @@ import { isValidId } from '../content/ids.js';
 /**
  * Fixed first segments that never resolve as concepts. The engine only allows posts and pages
  * today, so no collision is possible, but the parser does not depend on that: a reserved
- * segment wins before concept lookup. `settings`, `nav`, and `media` are decided as views below,
- * so they are not in this no-view set.
+ * segment wins before concept lookup. `nav` and `media` are decided as views below, so they are
+ * not in this no-view set. `settings` and `help` are decided as views below AND kept here, so a
+ * deeper path (or a future concept claiming the segment) can never reach the two-segment edit
+ * branch through them.
  */
-const RESERVED_SEGMENTS = new Set(['login', 'auth', 'editors', 'nav', 'settings']);
+const RESERVED_SEGMENTS = new Set(['login', 'auth', 'editors', 'nav', 'settings', 'help']);
 /**
  * Parse a raw `URL.pathname` (the caller passes `event.url.pathname`, never a SvelteKit rest
  * param) into the admin view it names. A single trailing slash is tolerated everywhere; empty
@@ -51,6 +53,10 @@ export function parseAdminPath(pathname, concepts) {
         // (the two-segment branch never matches settings), which is the correct shape.
         if (head === 'settings')
             return { view: 'settings' };
+        // help is its own view (the Help home, editor-help Pass 2), decided here like settings. It is
+        // also in the reserved set so /admin/help/<anything> 404s and no concept can claim the segment.
+        if (head === 'help')
+            return { view: 'help' };
         if (RESERVED_SEGMENTS.has(head))
             return null;
         const concept = findConcept(concepts, head);

package/dist/sveltekit/auth-routes.d.ts

@@ -19,6 +19,9 @@ export type RequestResult = {
     status: 'throttled';
     sent: false;
 };
+/**
+ *
+ */
 export declare function createAuthRoutes(config: AuthRoutesConfig): {
     loginLoad: (event: RequestContext) => {
         siteName: string;

package/dist/sveltekit/auth-routes.js

@@ -19,6 +19,9 @@ function scrubSendError(err) {
         .replace(/([?&]token=)[^&\s"'<]+/g, '$1[redacted]')
         .slice(0, 300);
 }
+/**
+ *
+ */
 export function createAuthRoutes(config) {
     const send = config.send ?? cloudflareSend;
     /**

package/dist/sveltekit/cairn-admin.d.ts

@@ -1,4 +1,4 @@
-import { type ContentRoutesDeps, type LayoutData, type ListData, type EditData, type MediaLibraryData, type SettingsData } from './content-routes.js';
+import { type ContentRoutesDeps, type LayoutData, type ListData, type EditData, type MediaLibraryData, type SettingsData, type HelpData } from './content-routes.js';
 import { type NavLoadData } from './nav-routes.js';
 import type { AuthBranding, SendMagicLink } from '../email.js';
 import type { AuthEnv, Editor } from '../auth/types.js';
@@ -14,15 +14,19 @@ export interface AdminEvent extends EventBase<GithubKeyEnv & AuthEnv> {
     cookies: CookieJar;
     setHeaders(headers: Record<string, string>): void;
 }
-/** Injectable dependencies. Branding defaults from the runtime's siteName and sender, so a
+/**
+ * Injectable dependencies. Branding defaults from the runtime's siteName and sender, so a
  *  site overrides it only to change the magic-link email identity; `send` and `mintToken`
- *  are the same seams the underlying factories take. */
+ *  are the same seams the underlying factories take.
+ */
 export interface CairnAdminDeps {
     branding?: AuthBranding;
     send?: SendMagicLink;
     mintToken?: ContentRoutesDeps['mintToken'];
-    /** Build the Anthropic client for the tidy action. Forwarded to the content routes; a site that
-     *  enables tidy injects a stub here to avoid a real network call. Defaults to the real SDK client. */
+    /**
+     * Build the Anthropic client for the tidy action. Forwarded to the content routes; a site that
+     *  enables tidy injects a stub here to avoid a real network call. Defaults to the real SDK client.
+     */
     anthropic?: ContentRoutesDeps['anthropic'];
     /** The tidy action's own request deadline in milliseconds. Forwarded to the content routes. */
     tidyTimeoutMs?: ContentRoutesDeps['tidyTimeoutMs'];
@@ -74,7 +78,14 @@ export type AdminData = {
     view: 'settings';
     layout: LayoutData;
     page: SettingsData;
+} | {
+    view: 'help';
+    layout: LayoutData;
+    page: HelpData;
 };
+/**
+ *
+ */
 export declare function createCairnAdmin(runtime: CairnRuntime, deps?: CairnAdminDeps): {
     load: (event: AdminEvent) => Promise<AdminData>;
     actions: {