@glw907/cairn-cms 0.60.1 → 0.62.1

package/dist/content/site-dictionary.js

@@ -16,11 +16,13 @@ const HEADER = '# cairn personal dictionary: one word per line, sorted, kept in
 // the test is for whitespace and control bytes rather than an allow-list of letters. The action runs
 // inbound words through this before a merge.
 const WORD_RE = /^[^\s\p{Cc}]+$/u;
-/** True when a word is a single valid dictionary line (no whitespace, no control characters, non-empty
+/**
+ * True when a word is a single valid dictionary line (no whitespace, no control characters, non-empty
  *  and within the length bound). A leading "#" is rejected: parseDictionary re-reads such a line as a
  *  comment, so committing it would silently drop the word on the next read. The action uses this to
  *  reject untrusted input before the merge, so a newline or a control byte can never inject an extra
- *  line into the committed file. */
+ *  line into the committed file.
+ */
 export function isValidDictionaryWord(word, maxLength = 64) {
     if (word.startsWith('#'))
         return false;
@@ -45,8 +47,10 @@ export function parseDictionary(text) {
     }
     return words;
 }
-/** Case-insensitive, locale-stable comparator for the canonical sort. Words are compared lowercased
- *  so "Cairn" and "cairn" collapse to one entry, the same case-folding the Worker's merged set uses. */
+/**
+ * Case-insensitive, locale-stable comparator for the canonical sort. Words are compared lowercased
+ *  so "Cairn" and "cairn" collapse to one entry, the same case-folding the Worker's merged set uses.
+ */
 function byWord(a, b) {
     return a.toLowerCase().localeCompare(b.toLowerCase());
 }

package/dist/content/types.d.ts

@@ -12,6 +12,11 @@ interface FieldBase {
     label: string;
     /** A required field fails validation when empty (spec §7.4). */
     required?: boolean;
+    /**
+     * One author-facing sentence shown under the field in the editor, in plain end-user language.
+     * Optional; render nothing when absent. Not a validation rule.
+     */
+    description?: string;
 }
 /** A single-line text input. */
 export interface TextField extends FieldBase {
@@ -22,8 +27,10 @@ export interface TextField extends FieldBase {
     max?: number;
     /** Exact required character length. */
     length?: number;
-    /** A regular-expression source string the value must match. Stored as a string so the field
-     *  list stays plain serializable data; the validator compiles it. */
+    /**
+     * A regular-expression source string the value must match. Stored as a string so the field
+     *  list stays plain serializable data; the validator compiles it.
+     */
     pattern?: string;
 }
 /** A multi-line text input. */
@@ -83,8 +90,10 @@ export interface ImageField extends FieldBase {
  * arm in `schema.ts`, since its value is a nested object rather than a single string.
  */
 export type FrontmatterField = TextField | TextareaField | DateField | BooleanField | TagsField | FreeTagsField | ImageField;
-/** The stored value of an `image` field: a `media:` reference, a screen-reader description, and an
- *  optional caption. */
+/**
+ * The stored value of an `image` field: a `media:` reference, a screen-reader description, and an
+ *  optional caption.
+ */
 export interface ImageValue {
     src: string;
     alt: string;
@@ -120,8 +129,10 @@ export interface ConceptConfig<S extends ConceptSchema = ConceptSchema> {
     singular?: string;
     /** The concept's schema: the form projection, the generated validator, and the inferred type. */
     schema: S;
-    /** Frontmatter keys to surface on each `ContentSummary.fields`, so a list card reads an authored
-     *  field without a per-entry detail read. Each key should also be declared in `schema`. */
+    /**
+     * Frontmatter keys to surface on each `ContentSummary.fields`, so a list card reads an authored
+     *  field without a per-entry detail read. Each key should also be declared in `schema`.
+     */
     summaryFields?: string[];
 }
 /**
@@ -168,29 +179,39 @@ export interface NavMenuConfig {
  * stylesheet.
  */
 export interface PreviewConfig {
-    /** Absolute or root-relative URLs of the site's compiled stylesheets, linked inside the
-     *  preview document. A Vite `?url` import of the site's CSS resolves the hashed asset URL. */
+    /**
+     * Absolute or root-relative URLs of the site's compiled stylesheets, linked inside the
+     *  preview document. A Vite `?url` import of the site's CSS resolves the hashed asset URL.
+     */
     stylesheets: string[];
     /** Class list applied to the preview document's body, for theme or typography roots. */
     bodyClass?: string;
-    /** Class list for a wrapper element around the rendered content, reproducing the site's
-     *  content container (a prose or measure class). Omitted renders the content bare. */
+    /**
+     * Class list for a wrapper element around the rendered content, reproducing the site's
+     *  content container (a prose or measure class). Omitted renders the content bare.
+     */
     containerClass?: string;
-    /** Per-concept overrides of bodyClass and containerClass, keyed by concept id. An entry's
+    /**
+     * Per-concept overrides of bodyClass and containerClass, keyed by concept id. An entry's
      *  preview resolves the override for its concept over the top-level values; stylesheets are
-     *  always shared. */
+     *  always shared.
+     */
     byConcept?: Record<string, {
         bodyClass?: string;
         containerClass?: string;
     }>;
 }
-/** The flat preview shape `editLoad` ships to the edit page: the top-level `PreviewConfig`
- *  values with the entry's concept override applied, and no `byConcept` map. */
+/**
+ * The flat preview shape `editLoad` ships to the edit page: the top-level `PreviewConfig`
+ *  values with the entry's concept override applied, and no `byConcept` map.
+ */
 export type ResolvedPreview = Omit<PreviewConfig, 'byConcept'>;
-/** A site's media configuration (seam 4). A site sets this to turn on R2-backed media: uploads,
+/**
+ * A site's media configuration (seam 4). A site sets this to turn on R2-backed media: uploads,
  *  content-addressed storage, and Cloudflare Images variants. Omitting it leaves media off. The
  *  engine normalizes this into a `ResolvedAssetConfig` and merges the named variants over the
- *  built-in thumb, inline, card, and hero presets. */
+ *  built-in thumb, inline, card, and hero presets.
+ */
 export interface AssetConfig {
     /** The R2 bucket binding name on the Worker, e.g. "MEDIA_BUCKET". Required when a site declares media. */
     bucketBinding: string;
@@ -204,10 +225,12 @@ export interface AssetConfig {
     allowedTypes?: string[];
     /** Named transform presets, merged over the built-in thumb/inline/card/hero presets. */
     variants?: Record<string, VariantSpec>;
-    /** Whether Cloudflare Image Transformations are enabled for the zone (default false). The feature
+    /**
+     * Whether Cloudflare Image Transformations are enabled for the zone (default false). The feature
      *  is a per-zone setting that the dashboard or API turns on; it cannot be flipped from a Worker. With
      *  it off, the media resolver serves the bare full-size delivery path and ignores any preset, so
-     *  thumbnails stay correct (full-size-but-correct) rather than pointing at a dead /cdn-cgi/image URL. */
+     *  thumbnails stay correct (full-size-but-correct) rather than pointing at a dead /cdn-cgi/image URL.
+     */
     transformations?: boolean;
 }
 /** The single seam the engine consumes. A site implements this at `src/lib/cairn.config.ts`. */
@@ -223,33 +246,49 @@ export interface CairnAdapter {
     };
     backend: BackendConfig;
     sender: SenderConfig;
-    /** The site's one renderer: the editor preview and every public page call it (design decision 4).
+    /**
+     * Optional contact a stuck editor is pointed to from the in-admin help (an email address, a URL,
+     *  or a name and instruction). The help renders the hand-off only when this is set. Plain string,
+     *  passed through verbatim.
+     */
+    supportContact?: string;
+    /**
+     * 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-resolver-backed
      *  one, the preview a manifest one. The trailing `resolveMedia` is additive and optional: the build
-     *  passes a site-resolver-backed media resolver, the preview a manifest-backed one. */
+     *  passes a site-resolver-backed media resolver, the preview a manifest-backed one.
+     */
     render(md: string, opts?: {
         stagger?: boolean;
         resolve?: LinkResolve;
         resolveMedia?: import('../render/resolve-media.js').MediaResolve;
     }): 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. */
+    /**
+     * 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;
-    /** Repo-relative path to the committed media manifest. Defaults to src/content/.cairn/media.json,
-     *  applied in composeRuntime. Sits outside any concept directory, like the content manifest. */
+    /**
+     * Repo-relative path to the committed media manifest. Defaults to src/content/.cairn/media.json,
+     *  applied in composeRuntime. Sits outside any concept directory, like the content manifest.
+     */
     mediaManifestPath?: string;
-    /** Repo-relative path to the committed personal dictionary file. Defaults to
+    /**
+     * Repo-relative path to the committed personal dictionary file. Defaults to
      *  src/content/.cairn/dictionary.txt, applied in composeRuntime: the same `.cairn/` content root the
      *  manifests use, so the spec's `content/.cairn/dictionary.txt` resolves the same configurable way the
-     *  manifest paths do. One word per line, sorted, comment lines allowed (see site-dictionary.ts). */
+     *  manifest paths do. One word per line, sorted, comment lines allowed (see site-dictionary.ts).
+     */
     dictionaryPath?: 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. */
     icons?: IconSet;
     navMenu?: NavMenuConfig;
-    /** The live site's content styling for the preview frame. The admin's chrome isolation keeps
-     *  the site's CSS out of the admin document, so the preview frame links these instead. */
+    /**
+     * The live site's content styling for the preview frame. The admin's chrome isolation keeps
+     *  the site's CSS out of the admin document, so the preview frame links these instead.
+     */
     preview?: PreviewConfig;
     assets?: AssetConfig;
 }
@@ -273,8 +312,10 @@ export interface ConceptDescriptor {
     /** Concept id, the key under `content`, e.g. "posts". */
     id: string;
     label: string;
-    /** The singular noun for the create affordances ("New post"); resolved from `ConceptConfig.singular`,
-     *  defaulting to `label` when the config omits it. */
+    /**
+     * The singular noun for the create affordances ("New post"); resolved from `ConceptConfig.singular`,
+     *  defaulting to `label` when the config omits it.
+     */
     singular: string;
     dir: string;
     routing: RoutingRule;
@@ -283,8 +324,10 @@ export interface ConceptDescriptor {
     /** Filename date-prefix granularity for a dated concept; resolved by `normalizeConcepts`. */
     datePrefix: DatePrefix;
     fields: FrontmatterField[];
-    /** Frontmatter keys the index copies onto each summary's `fields` record. `normalizeConcepts`
-     *  resolves it to `[]` when a concept omits `summaryFields`. */
+    /**
+     * Frontmatter keys the index copies onto each summary's `fields` record. `normalizeConcepts`
+     *  resolves it to `[]` when a concept omits `summaryFields`.
+     */
     summaryFields: string[];
     validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
 }
@@ -339,9 +382,13 @@ export interface CairnRuntime {
     concepts: ConceptDescriptor[];
     backend: BackendConfig;
     sender: SenderConfig;
-    /** The site's one renderer: the editor preview and every public page call it (design decision 4).
+    /** The support contact passed through from the adapter; the in-admin help reads it. Optional. */
+    supportContact?: string;
+    /**
+     * The site's one renderer: the editor preview and every public page call it (design decision 4).
      *  The trailing `resolveMedia` is additive and optional: the build passes a site-resolver-backed
-     *  media resolver, the preview a manifest-backed one. */
+     *  media resolver, the preview a manifest-backed one.
+     */
     render(md: string, opts?: {
         stagger?: boolean;
         resolve?: LinkResolve;
@@ -350,15 +397,19 @@ export interface CairnRuntime {
     manifestPath: string;
     /** The repo-relative path to the committed media manifest, defaulted in composeRuntime. */
     mediaManifestPath: string;
-    /** The repo-relative path to the committed personal dictionary file (one word per line, sorted),
+    /**
+     * The repo-relative path to the committed personal dictionary file (one word per line, sorted),
      *  defaulted in composeRuntime to src/content/.cairn/dictionary.txt: the same `.cairn/` content root
      *  the manifests use. The edit load reads it and threads its words onto EditData; the
      *  addDictionaryWord action reads, merges, and commits it. Optional on the runtime so a hand-built
      *  runtime need not set it; composeRuntime always fills it, and the edit load and the action default
-     *  a missing value to the same content-root path. */
+     *  a missing value to the same content-root path.
+     */
     dictionaryPath?: string;
-    /** The adapter's asset config resolved once at compose: `{ enabled: false }` for a no-media site,
-     *  otherwise the filled config the upload, storage, delivery, and resolver paths read. */
+    /**
+     * The adapter's asset config resolved once at compose: `{ enabled: false }` for a no-media site,
+     *  otherwise the filled config the upload, storage, delivery, and resolver paths read.
+     */
     resolvedAssets: import('../media/config.js').ResolvedAssetConfig;
     registry?: ComponentRegistry;
     /** The site's glyph name to SVG path-data map, for the admin icon picker and the renderer. */
@@ -367,18 +418,22 @@ export interface CairnRuntime {
     /** The live site's content styling for the preview frame; passed through from the adapter. */
     preview?: PreviewConfig;
     assets?: AssetConfig;
-    /** The editor's spellcheck dictionary file, resolved once at compose from the site config's
+    /**
+     * The editor's spellcheck dictionary file, resolved once at compose from the site config's
      *  `spellcheck.dialect` (defaulting to US English). The edit load threads it onto EditData and the
      *  editor resolves it to a real asset URL on the main thread, so the Worker receives the URL and
      *  never reads config. Just the filename, e.g. "dictionary-en-us.txt". Optional on the runtime so a
      *  hand-built runtime need not set it; composeRuntime always fills it, and the edit load defaults a
-     *  missing value to the US English dictionary. */
+     *  missing value to the US English dictionary.
+     */
     spellcheckDictionary?: string;
-    /** The editor tidy (LLM copy-edit) settings, passed through from the site config. Optional on the
+    /**
+     * The editor tidy (LLM copy-edit) settings, passed through from the site config. Optional on the
      *  runtime so a hand-built runtime need not set it; composeRuntime threads it from
      *  `siteConfig.tidy`. The tidy action reads `enabled` and `model` at call time, and builds its prompt
      *  from `conventions`. Absent (or `enabled` false) means tidy is off, and the action refuses with a
-     *  fail(503) before any model call. */
+     *  fail(503) before any model call.
+     */
     tidy?: import('../nav/site-config.js').TidyConfig;
     /** Admin panels contributed by extensions (Mode 2). Empty until Plan 09 wires the dispatch route. */
     adminPanels?: AdminPanel[];

package/dist/delivery/content-index.d.ts

@@ -6,8 +6,10 @@ export interface RawFile {
 }
 /** The cheap, plain-data view of one entry, for lists, feeds, and the sitemap. */
 export interface ContentSummary {
-    /** The descriptor id this entry belongs to, e.g. "posts". Lets a list or page branch per
-     *  concept without re-deriving it from a proxy like `entry.date`. */
+    /**
+     * The descriptor id this entry belongs to, e.g. "posts". Lets a list or page branch per
+     *  concept without re-deriving it from a proxy like `entry.date`.
+     */
     concept: string;
     id: string;
     slug: string;
@@ -15,22 +17,28 @@ export interface ContentSummary {
     title: string;
     date?: string;
     updated?: string;
-    /** The entry's tags, always present as an array and empty when the file declares none. This is the
+    /**
+     * The entry's tags, always present as an array and empty when the file declares none. This is the
      *  read-model normalization. It differs on purpose from the validated `frontmatter.tags`, which the
      *  validator omits when empty, so a published file carries no `tags: []` noise. Read `tags` here for
-     *  a list; read `frontmatter.tags` only when you need the validated, possibly-absent value. */
+     *  a list; read `frontmatter.tags` only when you need the validated, possibly-absent value.
+     */
     tags: string[];
     excerpt: string;
     wordCount: number;
     draft: boolean;
-    /** The frontmatter keys the descriptor nominated via `summaryFields`, read off the validated,
+    /**
+     * The frontmatter keys the descriptor nominated via `summaryFields`, read off the validated,
      *  normalized frontmatter. Held in a separate record so a nominated key cannot collide with a
-     *  typed summary field. Empty when the concept declares no `summaryFields`. */
+     *  typed summary field. Empty when the concept declares no `summaryFields`.
+     */
     fields: Record<string, unknown>;
 }
-/** The detail view: a summary plus the frontmatter and the body to render. The frontmatter
+/**
+ * The detail view: a summary plus the frontmatter and the body to render. The frontmatter
  *  type defaults to `Record<string, unknown>`; the typed-reads pass infers it from the concept
- *  fields. Generic now so that change does not break this signature. */
+ *  fields. Generic now so that change does not break this signature.
+ */
 export interface ContentEntry<F = Record<string, unknown>> extends ContentSummary {
     frontmatter: F;
     body: string;

package/dist/delivery/feeds.js

@@ -7,8 +7,10 @@ import { escapeXml } from './xml.js';
 function cdataSafe(value) {
     return value.replace(/]]>/g, ']]]]><![CDATA[>');
 }
-/** Parse a YYYY-MM-DD (or ISO) string as a UTC instant. Returns undefined for an absent or
- *  unparseable date, so a feed omits the date field rather than emit Invalid Date or throw. */
+/**
+ * Parse a YYYY-MM-DD (or ISO) string as a UTC instant. Returns undefined for an absent or
+ *  unparseable date, so a feed omits the date field rather than emit Invalid Date or throw.
+ */
 function parseFeedDate(date) {
     if (!date)
         return undefined;

package/dist/delivery/json-ld.d.ts

@@ -1 +1,4 @@
+/**
+ *
+ */
 export declare function jsonLdScript(data: Record<string, unknown>): string;

package/dist/delivery/json-ld.js

@@ -5,6 +5,9 @@
 // The line separator U+2028 and paragraph separator U+2029 get the same treatment: they are
 // legal inside a JSON string but unsafe in inline script text, where some parsers read them as
 // line terminators, so an author pasting one into frontmatter would corrupt the JSON-LD block.
+/**
+ *
+ */
 export function jsonLdScript(data) {
     const json = JSON.stringify(data)
         .replace(/</g, '\\u003c')

package/dist/delivery/manifest.d.ts

@@ -2,6 +2,8 @@ import type { Manifest } from '../content/manifest.js';
 import type { SiteConfig } from '../nav/site-config.js';
 import type { CairnAdapter } from '../content/types.js';
 import type { SiteGlobs } from './site-indexes.js';
-/** Build the whole-corpus manifest from a site's adapter, config, and per-concept globs. Drafts are
- *  included and flagged, so the admin picker and the guards see the full graph. */
+/**
+ * Build the whole-corpus manifest from a site's adapter, config, and per-concept globs. Drafts are
+ *  included and flagged, so the admin picker and the guards see the full graph.
+ */
 export declare function buildSiteManifest<A extends CairnAdapter>(adapter: A, config: SiteConfig, globs: SiteGlobs<A>): Manifest;

package/dist/delivery/manifest.js

@@ -6,8 +6,10 @@ import { siteDescriptors } from './site-descriptors.js';
 import { fromGlob } from './content-index.js';
 import { parseMarkdown } from '../content/frontmatter.js';
 import { emptyManifest, manifestEntryFromFile } from '../content/manifest.js';
-/** Build the whole-corpus manifest from a site's adapter, config, and per-concept globs. Drafts are
- *  included and flagged, so the admin picker and the guards see the full graph. */
+/**
+ * Build the whole-corpus manifest from a site's adapter, config, and per-concept globs. Drafts are
+ *  included and flagged, so the admin picker and the guards see the full graph.
+ */
 export function buildSiteManifest(adapter, config, globs) {
     const globRecord = globs;
     const manifest = emptyManifest();

package/dist/delivery/public-routes.d.ts

@@ -20,12 +20,16 @@ export interface PublicRoutesDeps {
         rss?: string;
         json?: string;
     };
-    /** A site-wide default OG image, used when an entry declares none. Resolved to absolute like the
-     *  canonical URL, so a relative path such as "/og/default.png" works. */
+    /**
+     * A site-wide default OG image, used when an entry declares none. Resolved to absolute like the
+     *  canonical URL, so a relative path such as "/og/default.png" works.
+     */
     defaultImage?: string;
-    /** Resolve a frontmatter `media:` hero reference to its delivery path. The site builds this from its
+    /**
+     * Resolve a frontmatter `media:` hero reference to its delivery path. The site builds this from its
      *  committed `media.json` exactly as it builds the body resolver (`makeMediaResolver`). When absent,
-     *  media is off and no `heroImage` projection is derived. */
+     *  media is off and no `heroImage` projection is derived.
+     */
     resolveMedia?: MediaResolve;
 }
 /** The archive and tag list data: summaries the template renders. */
@@ -52,11 +56,13 @@ export interface EntryData {
     seo: SeoMeta;
     newer?: ContentSummary;
     older?: ContentSummary;
-    /** The resolved hero image, a derived projection of the frontmatter `image` field. `url` is the
+    /**
+     * The resolved hero image, a derived projection of the frontmatter `image` field. `url` is the
      *  root-relative delivery path for an `<img>`, `absoluteUrl` the origin-anchored form for the
      *  og:image, and `alt`/`caption` carry from the stored object. The canonical token is untouched:
      *  `entry.frontmatter.image.src` stays the `media:` token. Undefined when no hero is set, media is
-     *  off, the reference does not parse, or the resolver finds no asset. */
+     *  off, the reference does not parse, or the resolver finds no asset.
+     */
     heroImage?: {
         url: string;
         absoluteUrl?: string;

package/dist/delivery/public-routes.js

@@ -11,7 +11,8 @@ import { parseMediaToken } from '../media/reference.js';
 /** Build the public loaders for a site's unified index. */
 export function createPublicRoutes(deps) {
     const { site, render, origin, siteName, description, feeds, defaultImage, resolveMedia } = deps;
-    /** Derive the hero projection from an entry's frontmatter, without mutating it (locked decision 5).
+    /**
+     * Derive the hero projection from an entry's frontmatter, without mutating it (locked decision 5).
      *  The hero lives at the conventional `image` key as the validated nested object `{ src, alt, caption }`;
      *  only an image field's validate arm produces an object-with-string-`src` shape, so detecting that
      *  structure is enough (a text field stores a string, a tags field an array). Returns undefined when
@@ -22,7 +23,8 @@ export function createPublicRoutes(deps) {
      *  and renders in the editor, but its delivery resolution is not wired here yet, since the field
      *  declarations are not reachable in the delivery read path. Honoring a renamed `seo`-flagged field
      *  (and a second image field per concept) at delivery is a carried follow-up; every consumer today
-     *  uses `image`. */
+     *  uses `image`.
+     */
     function deriveHeroImage(frontmatter) {
         if (!resolveMedia)
             return undefined;

package/dist/delivery/seo-fields.d.ts

@@ -1,21 +1,27 @@
-/** The head fields a concept can carry in frontmatter. Each is optional and omitted when absent.
+/**
+ * The head fields a concept can carry in frontmatter. Each is optional and omitted when absent.
  *  `author` is article-scoped downstream: the head builder emits `article:author` only for a dated
- *  entry, so an `author` on an undated Page is read here but not rendered. */
+ *  entry, so an `author` on an undated Page is read here but not rendered.
+ */
 export interface SeoFields {
     description?: string;
     image?: string;
     robots?: string;
     author?: string;
 }
-/** Read the known SEO head fields off an entry's normalized frontmatter. Keeps a present string,
+/**
+ * Read the known SEO head fields off an entry's normalized frontmatter. Keeps a present string,
  *  trimmed, and omits an absent, empty, or non-string value. Trimming the stored value keeps a stray
  *  `robots: "  noindex  "` from reaching the head tag with surrounding whitespace. The field must be
  *  declared in the concept's schema to survive the validate-once read; an undeclared key is not on the
- *  normalized frontmatter. */
+ *  normalized frontmatter.
+ */
 export declare function readSeoFields(frontmatter: Record<string, unknown>): SeoFields;
-/** Resolve an author-supplied image path to an absolute URL against the site origin. An absolute or
+/**
+ * Resolve an author-supplied image path to an absolute URL against the site origin. An absolute or
  *  protocol-relative URL passes through; a root-relative path anchors to the origin; a malformed
  *  string returns undefined rather than throwing at build. The sites use a bare-domain origin, so a
  *  bare path also anchors to the origin root; against a sub-path origin it would resolve relative to
- *  that path, per the WHATWG URL rules. */
+ *  that path, per the WHATWG URL rules.
+ */
 export declare function resolveImageUrl(image: string, origin: string): string | undefined;

package/dist/delivery/seo-fields.js

@@ -3,11 +3,13 @@
 // typed Record<string, unknown>; this reads the known head fields by name and coerces. Kept apart
 // from seo.ts (the head builder) so reading frontmatter and building the head stay distinct concerns.
 const KEYS = ['description', 'image', 'robots', 'author'];
-/** Read the known SEO head fields off an entry's normalized frontmatter. Keeps a present string,
+/**
+ * Read the known SEO head fields off an entry's normalized frontmatter. Keeps a present string,
  *  trimmed, and omits an absent, empty, or non-string value. Trimming the stored value keeps a stray
  *  `robots: "  noindex  "` from reaching the head tag with surrounding whitespace. The field must be
  *  declared in the concept's schema to survive the validate-once read; an undeclared key is not on the
- *  normalized frontmatter. */
+ *  normalized frontmatter.
+ */
 export function readSeoFields(frontmatter) {
     const fields = {};
     for (const key of KEYS) {
@@ -17,11 +19,13 @@ export function readSeoFields(frontmatter) {
     }
     return fields;
 }
-/** Resolve an author-supplied image path to an absolute URL against the site origin. An absolute or
+/**
+ * Resolve an author-supplied image path to an absolute URL against the site origin. An absolute or
  *  protocol-relative URL passes through; a root-relative path anchors to the origin; a malformed
  *  string returns undefined rather than throwing at build. The sites use a bare-domain origin, so a
  *  bare path also anchors to the origin root; against a sub-path origin it would resolve relative to
- *  that path, per the WHATWG URL rules. */
+ *  that path, per the WHATWG URL rules.
+ */
 export function resolveImageUrl(image, origin) {
     try {
         const url = new URL(image, origin);

package/dist/delivery/site-indexes.d.ts

@@ -7,8 +7,10 @@ import type { SiteResolver } from './site-resolver.js';
 export type SiteGlobs<A extends CairnAdapter> = {
     [K in keyof A['content']]?: Record<string, string>;
 };
-/** The typed per-concept indexes plus the cross-concept `site` resolver. A concept literally named
- *  `site` is not supported, since `site` is the reserved resolver key. */
+/**
+ * The typed per-concept indexes plus the cross-concept `site` resolver. A concept literally named
+ *  `site` is not supported, since `site` is the reserved resolver key.
+ */
 export type SiteIndexes<A extends CairnAdapter> = {
     [K in keyof A['content']]: ContentIndex<NonNullable<A['content'][K]> extends ConceptConfig<infer S> ? Infer<S> : Record<string, unknown>>;
 } & {

package/dist/delivery/site-resolver.d.ts

@@ -32,6 +32,8 @@ export interface SiteResolver {
 export declare function createSiteResolver(concepts: ConceptIndex[], opts?: {
     validate?: boolean;
 }): SiteResolver;
-/** A resolver backed by the site resolver, for the build. A miss throws, so a dangling cairn: token
- *  fails the prerender (the build backstop). The preview uses manifestLinkResolver, which marks. */
+/**
+ * A resolver backed by the site resolver, for the build. A miss throws, so a dangling cairn: token
+ *  fails the prerender (the build backstop). The preview uses manifestLinkResolver, which marks.
+ */
 export declare function buildLinkResolver(site: SiteResolver): LinkResolve;

package/dist/delivery/site-resolver.js

@@ -60,8 +60,10 @@ export function createSiteResolver(concepts, opts = {}) {
         },
     };
 }
-/** A resolver backed by the site resolver, for the build. A miss throws, so a dangling cairn: token
- *  fails the prerender (the build backstop). The preview uses manifestLinkResolver, which marks. */
+/**
+ * A resolver backed by the site resolver, for the build. A miss throws, so a dangling cairn: token
+ *  fails the prerender (the build backstop). The preview uses manifestLinkResolver, which marks.
+ */
 export function buildLinkResolver(site) {
     return (ref) => {
         const url = site.concept(ref.concept)?.byId(ref.id)?.permalink;

package/dist/doctor/cloudflare-api.d.ts

@@ -3,5 +3,11 @@ export declare const CF_API = "https://api.cloudflare.com/client/v4";
 export declare const NO_TOKEN: CheckResult;
 export declare const NO_FROM: CheckResult;
 export declare const NO_ACCOUNT: CheckResult;
+/**
+ *
+ */
 export declare function cfGet(ctx: DoctorContext, path: string): Promise<Response>;
+/**
+ *
+ */
 export declare function cfPost(ctx: DoctorContext, path: string, body: unknown): Promise<Response>;

package/dist/doctor/cloudflare-api.js

@@ -7,11 +7,17 @@ export const CF_API = 'https://api.cloudflare.com/client/v4';
 export const NO_TOKEN = skip('set CLOUDFLARE_API_TOKEN to run this check');
 export const NO_FROM = skip('pass --from, set CAIRN_FROM, or configure the cairnManifest plugin so the doctor can read the adapter');
 export const NO_ACCOUNT = skip('set CLOUDFLARE_API_TOKEN, and CLOUDFLARE_ACCOUNT_ID or a wrangler account_id, to run this check');
+/**
+ *
+ */
 export function cfGet(ctx, path) {
     return ctx.fetch(`${CF_API}${path}`, {
         headers: { authorization: `Bearer ${ctx.cfToken}` },
     });
 }
+/**
+ *
+ */
 export function cfPost(ctx, path, body) {
     return ctx.fetch(`${CF_API}${path}`, {
         method: 'POST',