@glw907/cairn-cms 0.5.1 → 0.6.0-rc.0

package/dist/components/index.js

@@ -1,10 +1,11 @@
-// cairn-cms admin UI shell. Consumers import from 'cairn-cms/components'; each site's
-// admin route `.svelte` files are one-line shims around these.
+// Admin Svelte components (Plan 05). The Warm Stone theme ships as a CSS side effect imported
+// by the components that set `data-theme="cairn-admin"`.
 export { default as AdminLayout } from './AdminLayout.svelte';
-export { default as CollectionList } from './CollectionList.svelte';
 export { default as LoginPage } from './LoginPage.svelte';
 export { default as ConfirmPage } from './ConfirmPage.svelte';
+export { default as ConceptList } from './ConceptList.svelte';
 export { default as EditPage } from './EditPage.svelte';
-export { default as ManageAdmins } from './ManageAdmins.svelte';
+export { default as ManageEditors } from './ManageEditors.svelte';
+export { default as MarkdownEditor } from './MarkdownEditor.svelte';
 export { default as ComponentPalette } from './ComponentPalette.svelte';
 export { default as NavTree } from './NavTree.svelte';

package/dist/content/compose.d.ts

@@ -0,0 +1,7 @@
+import type { CairnAdapter, CairnExtension, CairnRuntime } from './types.js';
+/**
+ * Fold an adapter and any extensions into the composed runtime (seam 2). Extension concepts
+ * merge after the adapter's. The asset slot (seam 4) passes through untouched.
+ */
+export declare function composeRuntime(adapter: CairnAdapter, extensions?: CairnExtension[]): CairnRuntime;
+//# sourceMappingURL=compose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/lib/content/compose.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,YAAY,EAAE,cAAc,EAAE,YAAY,EAA+B,MAAM,YAAY,CAAC;AAGtH;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,cAAc,EAAO,GAChC,YAAY,CAuBd"}

package/dist/content/compose.js

@@ -0,0 +1,32 @@
+import { normalizeConcepts } from './concepts.js';
+/**
+ * Fold an adapter and any extensions into the composed runtime (seam 2). Extension concepts
+ * merge after the adapter's. The asset slot (seam 4) passes through untouched.
+ */
+export function composeRuntime(adapter, extensions = []) {
+    const content = { ...adapter.content };
+    const adminPanels = [];
+    const fieldTypes = [];
+    for (const extension of extensions) {
+        // An extension adds concepts; a key that collides with the adapter is last-write-wins.
+        // Reserved seam, unused today, so the collision policy is deliberately left simple.
+        if (extension.content)
+            Object.assign(content, extension.content);
+        if (extension.adminPanels)
+            adminPanels.push(...extension.adminPanels);
+        if (extension.fieldTypes)
+            fieldTypes.push(...extension.fieldTypes);
+    }
+    return {
+        siteName: adapter.siteName,
+        concepts: normalizeConcepts(content),
+        backend: adapter.backend,
+        sender: adapter.sender,
+        renderPreview: adapter.renderPreview,
+        registry: adapter.registry,
+        navMenu: adapter.navMenu,
+        assets: adapter.assets,
+        adminPanels,
+        fieldTypes,
+    };
+}

package/dist/content/concepts.d.ts

@@ -0,0 +1,17 @@
+import type { ConceptConfig, ConceptDescriptor, RoutingRule } from './types.js';
+/**
+ * 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`.
+ */
+export declare const CONCEPT_ROUTING: Readonly<Record<string, RoutingRule>>;
+/**
+ * Normalize an adapter's declared concepts into uniform descriptors (seam 1). Each declared
+ * key under `content` becomes one descriptor; an undeclared (`undefined`) concept is
+ * skipped. `routing` is injectable so a contract test can prove a new concept attaches
+ * additively; production passes the default `CONCEPT_ROUTING`.
+ */
+export declare function normalizeConcepts(content: Record<string, ConceptConfig | undefined>, routing?: Readonly<Record<string, RoutingRule>>): 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;
+//# sourceMappingURL=concepts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concepts.d.ts","sourceRoot":"","sources":["../../src/lib/content/concepts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAGjE,CAAC;AAUF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC,EAClD,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAmB,GAC/D,iBAAiB,EAAE,CAcrB;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CACzB,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,EAAE,EAAE,MAAM,GACT,iBAAiB,GAAG,SAAS,CAE/B"}

package/dist/content/concepts.js

@@ -0,0 +1,41 @@
+/**
+ * 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`.
+ */
+export const CONCEPT_ROUTING = {
+    posts: { routable: true, dated: true, inFeeds: true },
+    pages: { routable: true, dated: false, inFeeds: false },
+};
+/** Routing for a concept with no table entry: a plain, non-feed, routable page. */
+const DEFAULT_ROUTING = { routable: true, dated: false, inFeeds: false };
+/** Title-case a concept id for the default sidebar label, e.g. "posts" to "Posts". */
+function defaultLabel(id) {
+    return id.charAt(0).toUpperCase() + id.slice(1);
+}
+/**
+ * Normalize an adapter's declared concepts into uniform descriptors (seam 1). Each declared
+ * key under `content` becomes one descriptor; an undeclared (`undefined`) concept is
+ * skipped. `routing` is injectable so a contract test can prove a new concept attaches
+ * additively; production passes the default `CONCEPT_ROUTING`.
+ */
+export function normalizeConcepts(content, routing = CONCEPT_ROUTING) {
+    const descriptors = [];
+    for (const [id, config] of Object.entries(content)) {
+        if (!config)
+            continue;
+        descriptors.push({
+            id,
+            label: config.label ?? defaultLabel(id),
+            dir: config.dir,
+            routing: routing[id] ?? DEFAULT_ROUTING,
+            fields: config.fields,
+            validate: config.validate,
+        });
+    }
+    return descriptors;
+}
+/** Look up a normalized concept by id, or undefined when the site does not enable it. */
+export function findConcept(concepts, id) {
+    return concepts.find((concept) => concept.id === id);
+}

package/dist/content/frontmatter.d.ts

@@ -0,0 +1,18 @@
+import type { FrontmatterField } from './types.js';
+/** Decode submitted form data into raw frontmatter, one rule per field type. */
+export declare function frontmatterFromForm(fields: FrontmatterField[], form: FormData): Record<string, unknown>;
+/**
+ * Coerce a frontmatter date value to the `YYYY-MM-DD` an `<input type="date">` wants.
+ * gray-matter parses an unquoted YAML date into a JS Date, so a string-only read would
+ * leave the input empty and drop the date on save. A parsed YAML date is UTC midnight, so
+ * slicing the ISO string avoids a local-timezone shift.
+ */
+export declare function dateInputValue(value: unknown): string;
+/** Reassemble a markdown file from frontmatter and body for committing. */
+export declare function serializeMarkdown(frontmatter: object, body: string): string;
+/** Parse a markdown file into its frontmatter and body: the read-side inverse of serialize. */
+export declare function parseMarkdown(source: string): {
+    frontmatter: Record<string, unknown>;
+    body: string;
+};
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/content/frontmatter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,IAAI,EAAE,QAAQ,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASrD;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAGA"}

package/dist/content/frontmatter.js

@@ -0,0 +1,58 @@
+// cairn-cms: frontmatter form decoding and on-disk serialization. `frontmatterFromForm`
+// is the form-to-data half of the edit loop; `serializeMarkdown`/`parseMarkdown` are the
+// on-disk write/read pair. Kept as one seam so a site owns its serialization contract
+// (quoting, key order) without the save endpoint reaching for gray-matter directly.
+import matter from 'gray-matter';
+/** Decode submitted form data into raw frontmatter, one rule per field type. */
+export function frontmatterFromForm(fields, form) {
+    const data = {};
+    for (const field of fields) {
+        switch (field.type) {
+            case 'boolean':
+                data[field.name] = form.get(field.name) === 'on';
+                break;
+            case 'tags':
+                data[field.name] = form.getAll(field.name).map(String);
+                break;
+            case 'freetags':
+                // One comma-separated input to trimmed, de-duplicated, non-empty tags.
+                data[field.name] = [
+                    ...new Set(String(form.get(field.name) ?? '')
+                        .split(',')
+                        .map((tag) => tag.trim())
+                        .filter(Boolean)),
+                ];
+                break;
+            default:
+                // FormData.get returns null for an absent field; normalize to an empty string so
+                // a caller reading a text value never gets null.
+                data[field.name] = form.get(field.name) ?? '';
+        }
+    }
+    return data;
+}
+/**
+ * Coerce a frontmatter date value to the `YYYY-MM-DD` an `<input type="date">` wants.
+ * gray-matter parses an unquoted YAML date into a JS Date, so a string-only read would
+ * leave the input empty and drop the date on save. A parsed YAML date is UTC midnight, so
+ * slicing the ISO string avoids a local-timezone shift.
+ */
+export function dateInputValue(value) {
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? '' : value.toISOString().slice(0, 10);
+    }
+    if (typeof value === 'string') {
+        const match = value.match(/^\d{4}-\d{2}-\d{2}/);
+        return match ? match[0] : '';
+    }
+    return '';
+}
+/** Reassemble a markdown file from frontmatter and body for committing. */
+export function serializeMarkdown(frontmatter, body) {
+    return matter.stringify(body, frontmatter);
+}
+/** Parse a markdown file into its frontmatter and body: the read-side inverse of serialize. */
+export function parseMarkdown(source) {
+    const parsed = matter(source);
+    return { frontmatter: parsed.data, body: parsed.content };
+}

package/dist/content/ids.d.ts

@@ -0,0 +1,17 @@
+/** True when `id` is a valid filename stem: lowercase, no slashes, no leading or trailing hyphen. */
+export declare function isValidId(id: string): boolean;
+/**
+ * A content entry's id from its filename: the basename without the `.md` suffix. Pass a
+ * basename, not a path; the caller strips any directory prefix first (Plan 03's Git Trees
+ * listing yields basenames directly).
+ */
+export declare function idFromFilename(filename: string): string;
+/** The on-disk filename for an id: the id plus `.md`. */
+export declare function filenameFromId(id: string): string;
+/**
+ * Lowercase a title into a filename-safe slug stem. Apostrophes are dropped so "Geoff's"
+ * becomes "geoffs" (no spurious hyphen). All other non-alphanumeric runs collapse to a
+ * single hyphen; leading and trailing hyphens are trimmed.
+ */
+export declare function slugify(title: string): string;
+//# sourceMappingURL=ids.d.ts.map

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

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

package/dist/content/ids.js

@@ -0,0 +1,33 @@
+// cairn-cms: filename-based content ids (spec §7.2). An entry's id is its markdown filename
+// without `.md`, so there is no slug codec. `slugify` derives a filename-safe stem from a
+// title for the create-entry form.
+/** Lowercase alphanumerics with single internal hyphens: the on-disk filename stem rule. */
+const ID_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** True when `id` is a valid filename stem: lowercase, no slashes, no leading or trailing hyphen. */
+export function isValidId(id) {
+    return ID_RE.test(id);
+}
+/**
+ * A content entry's id from its filename: the basename without the `.md` suffix. Pass a
+ * basename, not a path; the caller strips any directory prefix first (Plan 03's Git Trees
+ * listing yields basenames directly).
+ */
+export function idFromFilename(filename) {
+    return filename.replace(/\.md$/, '');
+}
+/** The on-disk filename for an id: the id plus `.md`. */
+export function filenameFromId(id) {
+    return `${id}.md`;
+}
+/**
+ * Lowercase a title into a filename-safe slug stem. Apostrophes are dropped so "Geoff's"
+ * becomes "geoffs" (no spurious hyphen). All other non-alphanumeric runs collapse to a
+ * single hyphen; leading and trailing hyphens are trimmed.
+ */
+export function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/'/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}

package/dist/content/types.d.ts

@@ -0,0 +1,210 @@
+import type { ComponentRegistry } from '../render/registry.js';
+/** Common to every frontmatter field: the frontmatter key, the form label, and whether it is required. */
+interface FieldBase {
+    /** Frontmatter key and form input name. */
+    name: string;
+    /** Form label. */
+    label: string;
+    /** A required field fails validation when empty (spec §7.4). */
+    required?: boolean;
+}
+/** A single-line text input. */
+export interface TextField extends FieldBase {
+    type: 'text';
+}
+/** A multi-line text input. */
+export interface TextareaField extends FieldBase {
+    type: 'textarea';
+    /** Visible rows; the editor picks a default when omitted. */
+    rows?: number;
+}
+/** A `YYYY-MM-DD` date input. */
+export interface DateField extends FieldBase {
+    type: 'date';
+}
+/** A checkbox; absent means false. */
+export interface BooleanField extends FieldBase {
+    type: 'boolean';
+}
+/** A closed-vocabulary tag set, rendered as checkboxes (ecnordic). */
+export interface TagsField extends FieldBase {
+    type: 'tags';
+    /** The controlled vocabulary. */
+    options: readonly string[];
+}
+/** Free-form tags, edited as one comma-separated input (907). */
+export interface FreeTagsField extends FieldBase {
+    type: 'freetags';
+    placeholder?: string;
+}
+/**
+ * The discriminated union the per-concept frontmatter form is generated from. Adding a
+ * field type is one variant here plus one decode arm in `frontmatterFromForm` and one in
+ * `validateFields`.
+ */
+export type FrontmatterField = TextField | TextareaField | DateField | BooleanField | TagsField | FreeTagsField;
+/**
+ * A validator's verdict. On success it carries the normalized frontmatter to commit; on
+ * failure it carries field-keyed error messages (the empty key is a form-level error).
+ * Invalid input bounces to the form and never reaches git (spec §7.4).
+ */
+export type ValidationResult = {
+    ok: true;
+    data: Record<string, unknown>;
+} | {
+    ok: false;
+    errors: Record<string, string>;
+};
+/**
+ * Per-site configuration for one content concept (spec §8). Concept-fixed behavior such as
+ * routability is not here; it lives in the engine's routing table (`CONCEPT_ROUTING`).
+ */
+export interface ConceptConfig {
+    /** Repo-relative content directory, e.g. "src/content/posts". */
+    dir: string;
+    /** Sidebar label; defaults from the concept id when omitted. */
+    label?: string;
+    /** Drives the per-concept frontmatter form, in order. */
+    fields: FrontmatterField[];
+    /** Validate submitted frontmatter before any commit. */
+    validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
+}
+/** The GitHub App backend a site reads from and commits to (spec §8). Plain data the GitHub engine (Plan 03) consumes. */
+export interface BackendConfig {
+    owner: string;
+    repo: string;
+    /** Commit target, e.g. "main". */
+    branch: string;
+    appId: string;
+    installationId: string;
+}
+/** Magic-link sender identity for Cloudflare Email Sending. */
+export interface SenderConfig {
+    from: string;
+    replyTo?: string;
+}
+/** A git-committed YAML menu this site's nav editor manages (Plan 06). */
+export interface NavMenuConfig {
+    /** Repo-relative path to the site-config YAML, e.g. "src/lib/site.config.yaml". */
+    configPath: string;
+    /** Key within the file's menus map, e.g. "primary". */
+    menuName: string;
+    /** Sidebar label for the menu. */
+    label: string;
+    /** Max nesting depth allowed in the editor; defaults to 2. */
+    maxDepth?: number;
+}
+/** Reserved asset slot (seam 4). Typed and unused in the rebuild; R7/R9 read it later with no contract change. */
+export interface AssetConfig {
+    /** Repo-relative asset roots, e.g. ["static/images"]. */
+    roots: string[];
+    /** Public URL base, e.g. "/images". */
+    publicBase: string;
+}
+/** The single seam the engine consumes. A site implements this at `src/lib/cairn.config.ts`. */
+export interface CairnAdapter {
+    siteName: string;
+    /**
+     * Which content concepts this site enables. A future `fragments?` key attaches here with
+     * no reshape of the contract (seam 1). A site never has two of the same concept.
+     */
+    content: {
+        posts?: ConceptConfig;
+        pages?: ConceptConfig;
+    };
+    backend: BackendConfig;
+    sender: SenderConfig;
+    /** Design-accurate preview: the same render pipeline the site ships. */
+    renderPreview(md: string): string | Promise<string>;
+    /** Directive component registry; the renderer and the future palette derive from it (seam 3). */
+    registry?: ComponentRegistry;
+    navMenu?: NavMenuConfig;
+    assets?: AssetConfig;
+}
+/**
+ * Concept-fixed routing for a normalized concept (spec §7.2). Posts are dated feed entries;
+ * pages are plain navigable structure. Not in adapter config.
+ */
+export interface RoutingRule {
+    /** Routable as a standalone URL. A future Fragments concept is embedded, not routable. */
+    routable: boolean;
+    /** Carries a date (posts). */
+    dated: boolean;
+    /** Appears in feeds and the sitemap (posts). */
+    inFeeds: boolean;
+}
+/**
+ * The engine-internal, uniform view of one concept after normalization (seam 1). The admin
+ * nav, the list views, and the editor all read this, never the raw config.
+ */
+export interface ConceptDescriptor {
+    /** Concept id, the key under `content`, e.g. "posts". */
+    id: string;
+    label: string;
+    dir: string;
+    routing: RoutingRule;
+    fields: FrontmatterField[];
+    validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
+}
+/**
+ * A site-defined admin screen contributed by an extension (Mode 2). It gains a sidebar entry, the
+ * `/admin` guard, and the session, and may commit through the same GitHub pipeline. The dispatch
+ * route is built in Plan 09; the `load`/`actions`/`component` members are typed loosely here and
+ * tightened when the machinery lands.
+ */
+export interface AdminPanel {
+    /** Routes under `/admin/<id>`; also the sidebar key. */
+    id: string;
+    /** Sidebar label. */
+    label: string;
+    /** Owner-gated, like editor management. */
+    owner?: boolean;
+    /** Server load, behind the guard. Typed in Plan 09. */
+    load?: (event: unknown) => unknown;
+    /** Named form actions, which may use the commit pipeline. Typed in Plan 09. */
+    actions?: Record<string, (event: unknown) => Promise<unknown>>;
+    /** The panel UI, rendered inside the admin shell. Typed as a component in Plan 09. */
+    component: unknown;
+}
+/**
+ * A custom frontmatter field type contributed by an extension (Mode 2): a renderer plus a validator
+ * dispatched alongside the built-in field union. The renderer and validator are typed in Plan 09
+ * when the form dispatch becomes a registry; the `type` key reserves the discriminator now.
+ */
+export interface FieldTypeDef {
+    /** The field-type discriminator, e.g. "color". */
+    type: string;
+}
+/**
+ * A future build-time extension (seam 2). It folds in the same way the adapter does and
+ * contributes the same kinds of things. Reserved and unused in the rebuild; the shape is
+ * fixed now so the extension contract is additive later.
+ */
+export interface CairnExtension {
+    /** Additional concepts, merged after the adapter's. */
+    content?: Record<string, ConceptConfig>;
+    /** Site-defined admin panels (Mode 2). Carried onto the runtime now; dispatched in Plan 09. */
+    adminPanels?: AdminPanel[];
+    /** Custom field types (Mode 2). Carried onto the runtime now; dispatched in Plan 09. */
+    fieldTypes?: FieldTypeDef[];
+}
+/**
+ * The composed runtime the engine serves from (seam 2 output). The single aggregation point
+ * (`composeRuntime`) folds the adapter and any extensions into this shape.
+ */
+export interface CairnRuntime {
+    siteName: string;
+    concepts: ConceptDescriptor[];
+    backend: BackendConfig;
+    sender: SenderConfig;
+    renderPreview(md: string): string | Promise<string>;
+    registry?: ComponentRegistry;
+    navMenu?: NavMenuConfig;
+    assets?: AssetConfig;
+    /** Admin panels contributed by extensions (Mode 2). Empty until Plan 09 wires the dispatch route. */
+    adminPanels?: AdminPanel[];
+    /** Field types contributed by extensions (Mode 2). Empty until Plan 09 wires the form dispatch. */
+    fieldTypes?: FieldTypeDef[];
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/content/types.ts"],"names":[],"mappings":"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"}

package/dist/content/types.js

@@ -0,0 +1 @@
+export {};

package/dist/content/validate.d.ts

@@ -0,0 +1,13 @@
+import type { FrontmatterField, ValidationResult } from './types.js';
+/**
+ * Validate raw frontmatter against a field list. Required text and date fields must be
+ * non-empty; required tag fields must be non-empty lists. Booleans coerce to `true`/`false`
+ * and tag fields to string arrays. Returns the normalized data, or field-keyed errors when
+ * any required field is empty.
+ *
+ * Frontmatter may arrive from the edit form (all string values) or from `parseMarkdown`,
+ * where gray-matter turns an unquoted YAML date into a JS `Date`. The `date` case coerces a
+ * `Date` to `YYYY-MM-DD` so a valid parsed date is not mistaken for an empty one.
+ */
+export declare function validateFields(fields: FrontmatterField[], frontmatter: Record<string, unknown>): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/lib/content/validate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGrE;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EAAE,EAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,gBAAgB,CA8BlB"}

package/dist/content/validate.js

@@ -0,0 +1,45 @@
+import { dateInputValue } from './frontmatter.js';
+/**
+ * Validate raw frontmatter against a field list. Required text and date fields must be
+ * non-empty; required tag fields must be non-empty lists. Booleans coerce to `true`/`false`
+ * and tag fields to string arrays. Returns the normalized data, or field-keyed errors when
+ * any required field is empty.
+ *
+ * Frontmatter may arrive from the edit form (all string values) or from `parseMarkdown`,
+ * where gray-matter turns an unquoted YAML date into a JS `Date`. The `date` case coerces a
+ * `Date` to `YYYY-MM-DD` so a valid parsed date is not mistaken for an empty one.
+ */
+export function validateFields(fields, frontmatter) {
+    const data = {};
+    const errors = {};
+    for (const field of fields) {
+        const value = frontmatter[field.name];
+        switch (field.type) {
+            case 'boolean':
+                data[field.name] = value === true;
+                break;
+            case 'tags':
+            case 'freetags': {
+                const list = Array.isArray(value) ? value.map(String) : [];
+                if (field.required && list.length === 0)
+                    errors[field.name] = `${field.label} is required`;
+                data[field.name] = list;
+                break;
+            }
+            case 'date': {
+                const text = value instanceof Date ? dateInputValue(value) : typeof value === 'string' ? value.trim() : '';
+                if (field.required && text === '')
+                    errors[field.name] = `${field.label} is required`;
+                data[field.name] = text;
+                break;
+            }
+            default: {
+                const text = typeof value === 'string' ? value.trim() : '';
+                if (field.required && text === '')
+                    errors[field.name] = `${field.label} is required`;
+                data[field.name] = text;
+            }
+        }
+    }
+    return Object.keys(errors).length > 0 ? { ok: false, errors } : { ok: true, data };
+}

package/dist/email.d.ts

@@ -1,14 +1,27 @@
-/** Cloudflare Email Sending binding surface (the object-form `send`, not the MIME form). */
-export interface EmailSender {
-    send(message: {
-        to: string;
-        from: string;
-        subject: string;
-        text?: string;
-        html?: string;
-    }): Promise<{
-        messageId: string;
-    }>;
+import type { AuthEnv } from './auth/types.js';
+export type { AuthEnv };
+/** The message a built magic-link email carries. */
+export interface MagicLinkMessage {
+    to: string;
+    from: string;
+    subject: string;
+    html: string;
+    text: string;
 }
-export declare function sendMagicLink(sender: EmailSender, to: string, link: string, siteName: string, from: string): Promise<void>;
+/** Per-site identity for the magic-link email, sourced from the adapter. */
+export interface AuthBranding {
+    siteName: string;
+    from: string;
+    replyTo?: string;
+}
+/** The injected send. Production uses `cloudflareSend`; tests pass a sink. */
+export type SendMagicLink = (env: AuthEnv, message: MagicLinkMessage) => Promise<void>;
+/** Build the confirmation email. The link is the only action; the copy stays plain. */
+export declare function buildMagicLinkMessage(input: {
+    to: string;
+    branding: AuthBranding;
+    link: string;
+}): MagicLinkMessage;
+/** The production send: Cloudflare Email Sending through the EMAIL binding. */
+export declare const cloudflareSend: SendMagicLink;
 //# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/lib/email.ts"],"names":[],"mappings":"AAQA,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,OAAO,EAAE;QACZ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpC;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/lib/email.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,OAAO,EAAE,CAAC;AAExB,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAYvF,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,gBAAgB,CAQnB;AAED,+EAA+E;AAC/E,eAAO,MAAM,cAAc,EAAE,aAG5B,CAAC"}