@prenta/core 0.118.0

package/dist/sections/embed.js

@@ -0,0 +1,78 @@
+/**
+ * Embed/video provider allowlist + URL parsing for the `embed` section.
+ *
+ * Only YouTube, Vimeo, and Loom are allowed; each source URL is mapped to its
+ * privacy-friendly iframe `src`. Parsing is deterministic and pure (no network)
+ * so the section validator (cms-core) and the public renderer (sections-react)
+ * agree on exactly what is embeddable — an arbitrary URL can never reach an
+ * `<iframe>`.
+ */
+export const EMBED_PROVIDER_LABEL = {
+    youtube: 'YouTube',
+    vimeo: 'Vimeo',
+    loom: 'Loom',
+};
+function host(u) {
+    return u.hostname.replace(/^www\./, '').toLowerCase();
+}
+function youtubeId(u) {
+    const h = host(u);
+    if (h === 'youtu.be')
+        return u.pathname.slice(1).split('/')[0] || null;
+    if (h === 'youtube.com' || h === 'm.youtube.com' || h === 'youtube-nocookie.com') {
+        if (u.pathname === '/watch')
+            return u.searchParams.get('v');
+        const m = u.pathname.match(/^\/(?:embed|shorts|v)\/([^/?#]+)/);
+        if (m)
+            return m[1] ?? null;
+    }
+    return null;
+}
+function vimeoId(u) {
+    const h = host(u);
+    if (h !== 'vimeo.com' && h !== 'player.vimeo.com')
+        return null;
+    const m = u.pathname.match(/(?:^|\/)(\d+)(?:$|[/?#])/);
+    return m?.[1] ?? null;
+}
+function loomId(u) {
+    if (host(u) !== 'loom.com')
+        return null;
+    const m = u.pathname.match(/^\/(?:share|embed)\/([0-9a-f]{8,})/i);
+    return m?.[1] ?? null;
+}
+/** True when `id` is a safe id token to interpolate into an embed URL. */
+function safeId(id) {
+    return !!id && /^[\w-]+$/.test(id);
+}
+/**
+ * Resolve a pasted video URL to a provider + iframe `src`, or `null` when the
+ * URL is not an allowed provider (or is malformed).
+ */
+export function parseEmbed(raw) {
+    if (typeof raw !== 'string' || raw.trim() === '')
+        return null;
+    let u;
+    try {
+        u = new URL(raw.trim());
+    }
+    catch {
+        return null;
+    }
+    if (u.protocol !== 'https:' && u.protocol !== 'http:')
+        return null;
+    const yt = youtubeId(u);
+    if (safeId(yt)) {
+        return { provider: 'youtube', id: yt, embedUrl: `https://www.youtube-nocookie.com/embed/${yt}` };
+    }
+    const vimeo = vimeoId(u);
+    if (safeId(vimeo)) {
+        return { provider: 'vimeo', id: vimeo, embedUrl: `https://player.vimeo.com/video/${vimeo}` };
+    }
+    const loom = loomId(u);
+    if (safeId(loom)) {
+        return { provider: 'loom', id: loom, embedUrl: `https://www.loom.com/embed/${loom}` };
+    }
+    return null;
+}
+//# sourceMappingURL=embed.js.map

package/dist/sections/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../src/sections/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IACjE,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACb,CAAA;AAED,SAAS,IAAI,CAAC,CAAM;IAClB,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,CAAM;IACvB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,IAAI,CAAC,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IACtE,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,eAAe,IAAI,CAAC,KAAK,sBAAsB,EAAE,CAAC;QACjF,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3D,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAA;QAC9D,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC5B,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,OAAO,CAAC,CAAM;IACrB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,kBAAkB;QAAE,OAAO,IAAI,CAAA;IAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;IACtD,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACvB,CAAC;AAED,SAAS,MAAM,CAAC,CAAM;IACpB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IACvC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACjE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACvB,CAAC;AAED,0EAA0E;AAC1E,SAAS,MAAM,CAAC,EAAiB;IAC/B,OAAO,CAAC,CAAC,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAC7D,IAAI,CAAM,CAAA;IACV,IAAI,CAAC;QACH,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAA;IAElE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IACvB,IAAI,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,0CAA0C,EAAE,EAAE,EAAE,CAAA;IAClG,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,kCAAkC,KAAK,EAAE,EAAE,CAAA;IAC9F,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACtB,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,8BAA8B,IAAI,EAAE,EAAE,CAAA;IACvF,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/sections/fields.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Repeater field helpers — the single source of truth for "structured array"
+ * fields shared by the admin inspector (rendering) and the validator
+ * (publish-time checks), so both treat the generic `repeater` type and the
+ * `stats` / `gallery` shorthands identically.
+ *
+ * Isomorphic (no DOM/React/Node APIs) — it runs in the browser editor, the
+ * REST API, and the MCP server.
+ */
+import type { SectionFieldDef } from './types.js';
+/** Sub-field schema for the legacy `stats` shorthand ({value,label,description}). */
+export declare const STATS_ROW_FIELDS: SectionFieldDef[];
+/** Sub-field schema for the legacy `gallery` shorthand ({url,alt,caption}). */
+export declare const GALLERY_ROW_FIELDS: SectionFieldDef[];
+/** A repeater field resolved to its row model. */
+export interface ResolvedRepeater {
+    /** singular noun for one row (e.g. "Stat", "Image", "Plan") */
+    rowLabel: string;
+    /** ordered sub-field schema for each row */
+    fields: SectionFieldDef[];
+    minRows?: number;
+    maxRows?: number;
+}
+/**
+ * Resolve a field into its repeater configuration, or `null` when it isn't a
+ * repeater-like field. Handles the generic `repeater` type plus the `stats`
+ * and `gallery` shorthands (kept as presets over the same row model) so the
+ * inspector and validator share ONE path.
+ */
+export declare function resolveRepeaterField(field: SectionFieldDef): ResolvedRepeater | null;
+/** True when a field renders/validates as a repeatable group of rows. */
+export declare function isRepeaterField(field: SectionFieldDef): boolean;
+/** One repeater row: an object keyed by the repeater's sub-field keys. */
+export type RepeaterRow = Record<string, unknown>;
+/** Build a blank row seeded with empty values for each sub-field. */
+export declare function blankRepeaterRow(fields: SectionFieldDef[]): RepeaterRow;
+//# sourceMappingURL=fields.d.ts.map

package/dist/sections/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/sections/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAI7C,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAS/C,CAAA;AAED,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAYpF;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE/D;AAED,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEjD,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,WAAW,CAIvE"}

package/dist/sections/fields.js

@@ -0,0 +1,50 @@
+/** Sub-field schema for the legacy `stats` shorthand ({value,label,description}). */
+export const STATS_ROW_FIELDS = [
+    { key: 'value', label: 'Value', type: 'text', placeholder: 'e.g. 99.99%' },
+    { key: 'label', label: 'Label', type: 'text', placeholder: 'e.g. Uptime' },
+    { key: 'description', label: 'Description', type: 'text' },
+];
+/** Sub-field schema for the legacy `gallery` shorthand ({url,alt,caption}). */
+export const GALLERY_ROW_FIELDS = [
+    { key: 'url', label: 'Image', type: 'media' },
+    {
+        key: 'alt',
+        label: 'Alt text',
+        type: 'text',
+        help: 'Describe the image for screen readers.',
+    },
+    { key: 'caption', label: 'Caption', type: 'text' },
+];
+/**
+ * Resolve a field into its repeater configuration, or `null` when it isn't a
+ * repeater-like field. Handles the generic `repeater` type plus the `stats`
+ * and `gallery` shorthands (kept as presets over the same row model) so the
+ * inspector and validator share ONE path.
+ */
+export function resolveRepeaterField(field) {
+    if (field.type === 'repeater') {
+        return {
+            rowLabel: field.rowLabel?.trim() || 'Item',
+            fields: Array.isArray(field.fields) ? field.fields : [],
+            minRows: field.minRows,
+            maxRows: field.maxRows,
+        };
+    }
+    if (field.type === 'stats')
+        return { rowLabel: 'Stat', fields: STATS_ROW_FIELDS };
+    if (field.type === 'gallery')
+        return { rowLabel: 'Image', fields: GALLERY_ROW_FIELDS };
+    return null;
+}
+/** True when a field renders/validates as a repeatable group of rows. */
+export function isRepeaterField(field) {
+    return resolveRepeaterField(field) !== null;
+}
+/** Build a blank row seeded with empty values for each sub-field. */
+export function blankRepeaterRow(fields) {
+    const row = {};
+    for (const f of fields)
+        row[f.key] = f.type === 'boolean' ? false : '';
+    return row;
+}
+//# sourceMappingURL=fields.js.map

package/dist/sections/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/sections/fields.ts"],"names":[],"mappings":"AAWA,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE;IAC1E,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE;IAC1E,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE;CAC3D,CAAA;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;IAC7C;QACE,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,wCAAwC;KAC/C;IACD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;CACnD,CAAA;AAYD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAsB;IACzD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,MAAM;YAC1C,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACvD,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAA;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAA;IACjF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;IACtF,OAAO,IAAI,CAAA;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,OAAO,oBAAoB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;AAC7C,CAAC;AAKD,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,MAAyB;IACxD,MAAM,GAAG,GAAgB,EAAE,CAAA;IAC3B,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACtE,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/sections/helpers.d.ts

@@ -0,0 +1,149 @@
+import type { PageSection, PostHeaderConfig, PostTemplate, SectionSettings } from './types.js';
+/** Generate a unique section id (UUID when available, monotonic fallback). */
+export declare function generateSectionId(): string;
+/** Create a fresh section of the given type, seeded with registry defaults. */
+export declare function createSection(type: string): PageSection;
+/** Insert a section at `index` (defaults to the end). Returns a new array. */
+export declare function addSection(sections: PageSection[], section: PageSection, index?: number): PageSection[];
+export declare function removeSection(sections: PageSection[], id: string): PageSection[];
+/** Duplicate a section (new id, "(Copy)" suffix), inserted right after the original. */
+export declare function duplicateSection(sections: PageSection[], id: string): PageSection[];
+export declare function toggleSectionVisibility(sections: PageSection[], id: string): PageSection[];
+/** Explicitly set a section's visibility (used by the API toggle endpoint). */
+export declare function setSectionVisibility(sections: PageSection[], id: string, visible: boolean): PageSection[];
+/** Move the section with `id` to a new index (clamped). Returns a new array. */
+export declare function moveSection(sections: PageSection[], id: string, toIndex: number): PageSection[];
+/** Reorder to an explicit id order (used by drag-and-drop drop handlers). */
+export declare function reorderSections(sections: PageSection[], orderedIds: string[]): PageSection[];
+export declare function updateSectionContent(sections: PageSection[], id: string, patch: Record<string, unknown>): PageSection[];
+/**
+ * Read a value from section content via a dotted path (`lead`, `stats.0.num`).
+ * Numeric path segments index arrays; missing segments return `undefined`.
+ */
+export declare function getContentAtPath(content: Record<string, unknown>, path: string): unknown;
+/**
+ * Immutable deep set at a dotted path. Creates objects/arrays along the path
+ * when missing. Numeric segments treat the parent as an array.
+ */
+export declare function setContentAtPath(content: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;
+/**
+ * Path-aware content update for visual-editing Stage 3. Unlike
+ * {@link updateSectionContent} (shallow top-level merge), this writes a single
+ * dotted path into `content` so repeater fields like `stats.0.num` work.
+ */
+export declare function updateSectionContentAtPath(sections: PageSection[], id: string, path: string, value: unknown): PageSection[];
+export declare function updateSectionSettings(sections: PageSection[], id: string, patch: Partial<SectionSettings>): PageSection[];
+export declare function updateSectionMeta(sections: PageSection[], id: string, patch: {
+    name?: string;
+    internalLabel?: string;
+}): PageSection[];
+/** How {@link coerceSections} handles an entry with an unregistered type. */
+export type UnknownSectionStrategy = 'drop' | 'preserve' | 'error';
+/** A section whose `sectionType` has no registered definition. */
+export interface UnknownSectionRef {
+    sectionType: string;
+    /** original index in the input array */
+    index: number;
+}
+/**
+ * Thrown by {@link coerceSections} / {@link coerceSectionsWithReport} when
+ * `onUnknown: 'error'` and the input contains unregistered section types.
+ * Use it to block a publish/import rather than silently dropping content.
+ */
+export declare class UnknownSectionTypeError extends Error {
+    readonly sectionTypes: string[];
+    constructor(sectionTypes: string[]);
+}
+export interface CoerceSectionsOptions {
+    /**
+     * What to do with an entry whose `sectionType` has no registered definition
+     * (neither a built-in nor a config-declared custom type):
+     *  - `'drop'` (default): omit it. In development a single `console.warn`
+     *    summarizes what was dropped so a forgotten `sections.types` registration
+     *    is visible instead of silent.
+     *  - `'preserve'`: keep it verbatim (content/settings/position intact),
+     *    flagged `unmanaged: true`, so externally-managed sections (seed/code-
+     *    owned, e.g. `opal-hero`) round-trip through read/save without data loss.
+     *  - `'error'`: throw {@link UnknownSectionTypeError}. Use at a publish/import
+     *    boundary to block rather than drop.
+     */
+    onUnknown?: UnknownSectionStrategy;
+    /**
+     * @deprecated Use `onUnknown: 'preserve'`. When `true` (and `onUnknown` is
+     * unset) unknown entries are preserved as `unmanaged`.
+     */
+    preserveUnknown?: boolean;
+    /**
+     * Invoked once per dropped section (only in `'drop'` mode). Provide it to
+     * record observability/telemetry; supplying it suppresses the default dev
+     * `console.warn` since the caller is handling the signal.
+     */
+    onDrop?: (ref: UnknownSectionRef) => void;
+}
+export interface CoerceSectionsReport {
+    /** the normalized, kept sections (managed + any preserved unmanaged) */
+    sections: PageSection[];
+    /** entries that were dropped because their type is unknown (`'drop'` mode) */
+    dropped: UnknownSectionRef[];
+    /** entries kept verbatim as `unmanaged` (`'preserve'` mode) */
+    preserved: UnknownSectionRef[];
+}
+/**
+ * Normalize arbitrary JSON into a clean `PageSection[]` and report what
+ * happened to entries with an unknown `sectionType`. See
+ * {@link CoerceSectionsOptions} for the unknown-type strategy.
+ *
+ * Used when reading `data.sections` from the DB and when accepting an AI/agent
+ * payload that may be partially shaped.
+ */
+export declare function coerceSectionsWithReport(raw: unknown, opts?: CoerceSectionsOptions): CoerceSectionsReport;
+/**
+ * Normalize arbitrary JSON into a clean `PageSection[]`.
+ *
+ * Thin wrapper over {@link coerceSectionsWithReport} that returns just the
+ * sections. Backfills missing ids/names and coerces visibility; unknown types
+ * are dropped by default (with a dev warning) — pass `{ onUnknown: 'preserve' }`
+ * at a persistence boundary to keep them as `unmanaged`, or `{ onUnknown:
+ * 'error' }` to block.
+ */
+export declare function coerceSections(raw: unknown, opts?: CoerceSectionsOptions): PageSection[];
+/**
+ * Build a fully-formed section from a (possibly partial) AI/agent payload:
+ * start from the registry defaults for `type`, then shallow-merge the
+ * provided `content` / `settings` and apply an optional display name.
+ * The returned section always has a fresh id + valid shape.
+ */
+export declare function buildSection(type: string, input?: {
+    name?: string;
+    internalLabel?: string;
+    visible?: boolean;
+    content?: Record<string, unknown>;
+    settings?: Partial<SectionSettings>;
+}): PageSection;
+/**
+ * Estimate reading time in whole minutes from a body of text. HTML tags are
+ * stripped first (post bodies are stored as sanitized HTML) and the word
+ * count is divided by an average adult reading speed of 200 wpm. Always
+ * returns at least 1 so the header never shows "0 min read".
+ *
+ * Shared by the admin post header preview and the public site header so both
+ * surfaces show the same figure.
+ */
+export declare function computeReadingTime(text: string | null | undefined): number;
+/** Sensible default header layout for a brand-new post type template. */
+export declare function defaultPostHeader(): PostHeaderConfig;
+/**
+ * Normalize arbitrary JSON into a clean {@link PostHeaderConfig}, falling
+ * back to {@link defaultPostHeader} for any missing/invalid keys. Used when
+ * reading a `post-templates` document or accepting an agent payload.
+ */
+export declare function coercePostHeader(raw: unknown): PostHeaderConfig;
+/**
+ * Build a default template for a post type: a centered header plus an
+ * article body and a related-posts block — a usable starting point an
+ * author or AI agent can then alter.
+ */
+export declare function createPostTemplate(postType: string): PostTemplate;
+/** Normalize a raw `post-templates` document's data into a {@link PostTemplate}. */
+export declare function coercePostTemplate(postType: string, raw: unknown): PostTemplate;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/sections/helpers.d.ts.map

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