@prenta/sections-react 0.15.0

package/dist/sizes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizes.d.ts","sourceRoot":"","sources":["../src/sizes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,oCAAoC,CAAA;AAEpE;;;GAGG;AACH,eAAO,MAAM,aAAa,mCAAmC,CAAA;AAE7D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/sizes.js

@@ -0,0 +1,34 @@
+/**
+ * Responsive `sizes` helpers.
+ *
+ * The `sizes` attribute tells the browser how wide an image will render at each
+ * breakpoint so it can pick the smallest sufficient `srcset` candidate. Getting
+ * it wrong (or omitting it) makes mobile silently over-download the desktop-
+ * sized image — one of the most common, invisible LCP regressions.
+ *
+ * These constants/helpers encode the layout each built-in section renders at, so
+ * the right `sizes` ships by default without each renderer hand-rolling it.
+ */
+/** Full-bleed image (hero, overlay header): one column at every width. */
+export const FULL_WIDTH_SIZES = '100vw';
+/**
+ * Centered content image capped at a max width (e.g. the standard post header
+ * featured image, rendered inside `max-w-4xl` = 896px).
+ */
+export const CONTENT_WIDTH_SIZES = '(max-width: 896px) 100vw, 896px';
+/**
+ * Feature section image: stacks full-width on mobile, ~half the row on `md+`
+ * (two-column grid).
+ */
+export const FEATURE_SIZES = '(max-width: 768px) 100vw, 50vw';
+/**
+ * Gallery cell `sizes` for a given column count: full-width on small screens,
+ * an even fraction of the viewport at the grid breakpoint. Clamps the column
+ * count to a sane range so a bad value can't produce a nonsense hint.
+ */
+export function gallerySizes(columns) {
+    const cols = Number.isFinite(columns) ? Math.min(Math.max(Math.round(columns), 1), 6) : 3;
+    const pct = Math.round(100 / cols);
+    return `(max-width: 640px) 100vw, ${pct}vw`;
+}
+//# sourceMappingURL=sizes.js.map

package/dist/sizes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sizes.js","sourceRoot":"","sources":["../src/sizes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iCAAiC,CAAA;AAEpE;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,gCAAgC,CAAA;AAE7D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAA;IAClC,OAAO,6BAA6B,GAAG,IAAI,CAAA;AAC7C,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,95 @@
+import type { PostContext, PublicSection, RenderImage, RenderOptions, SectionRendererMap } from './types.js';
+/**
+ * Render options that mirror cms-admin `ADMIN_RENDER_OPTIONS`: identity
+ * sanitizer (rich text is sanitized on write) and a plain lazy `<img>` (no
+ * next/image pipeline inside the editor canvas).
+ */
+export declare const CANVAS_RENDER_OPTIONS: RenderOptions;
+/**
+ * Normalize SSR HTML for stable equality across public vs canvas image
+ * pipelines. Strips whitespace and attributes that legitimately differ between
+ * `defaultRenderImage` and canvas plain `<img>` (loading / fetchpriority /
+ * decoding / sizes / LCP preload imageSizes) so structural drift still fails.
+ */
+export declare function normalizeSectionHtml(html: string): string;
+export interface SectionRenderParityOptions {
+    /** Per-request post context (post-oriented sections). */
+    ctx?: PostContext;
+    /** Shared renderer map (the same map AdminRoot + PageSections must use). */
+    renderers?: SectionRendererMap;
+    /** Extra / override options for the public orchestrator path. */
+    publicOptions?: RenderOptions;
+    /** Extra / override options for the canvas orchestrator path. */
+    canvasOptions?: RenderOptions;
+    /** Custom normalizer; defaults to {@link normalizeSectionHtml}. */
+    normalize?: (html: string) => string;
+}
+/** Public orchestrator path — Astro/Next site via `<Sections>`. */
+export declare function renderPublicSectionsHtml(sections: PublicSection[], opts?: {
+    ctx?: PostContext;
+    renderers?: SectionRendererMap;
+    options?: RenderOptions;
+}): string;
+/**
+ * Canvas orchestrator path — same `<Sections>` tree with canvas-equivalent
+ * options (mirrors how custom kits receive `ADMIN_RENDER_OPTIONS`).
+ */
+export declare function renderCanvasSectionsHtml(sections: PublicSection[], opts?: {
+    ctx?: PostContext;
+    renderers?: SectionRendererMap;
+    options?: RenderOptions;
+}): string;
+/**
+ * Assert that public and canvas orchestrators emit the same normalized tree
+ * for the given sections (+ optional shared renderer map).
+ *
+ * Throws with both HTML snippets on mismatch so CI failures are actionable.
+ */
+export declare function assertSectionRenderParity(sections: PublicSection[], opts?: SectionRenderParityOptions): void;
+export interface SectionCoverageOptions {
+    /**
+     * Declared section types — the `sections.types` array from `prenta.config.ts`
+     * (objects with an `id`) or bare id strings.
+     */
+    declared: ReadonlyArray<string | {
+        id: string;
+    }>;
+    /** The shared renderer map (public `<Sections>` + `<AdminRoot sectionRenderers>`). */
+    renderers: SectionRendererMap;
+    /**
+     * Ids that intentionally have no renderer — data-only types whose content is
+     * consumed by a code-owned template. Every entry must exist in `declared`
+     * and must NOT have a renderer; a stale entry fails so the opt-out list
+     * stays honest instead of silently masking real gaps.
+     */
+    allowDataOnly?: readonly string[];
+}
+/**
+ * Assert the three-layer section contract agrees: every declared `sectionType`
+ * has a renderer (or is an explicit data-only opt-out), and every renderer
+ * corresponds to a declared type — so renaming a schema id and leaving the old
+ * renderer behind fails instead of shipping Structure view placeholders.
+ *
+ * This is the check the docs call `verify:sections`. Wire it as a one-line
+ * test against the SAME map you pass to both `<Sections>` and
+ * `<AdminRoot sectionRenderers>`:
+ *
+ * @example
+ * ```ts
+ * import { assertSectionCoverage } from '@prenta/sections-react/testing'
+ * import { marketingSectionTypes } from '../sections/types'
+ * import { sectionRenderers } from '../sections/register'
+ *
+ * assertSectionCoverage({
+ *   declared: marketingSectionTypes,
+ *   renderers: sectionRenderers,
+ *   allowDataOnly: ['careers-listing'], // consumed by a code-owned template
+ * })
+ * ```
+ *
+ * @throws Error listing every problem at once so CI failures are actionable.
+ */
+export declare function assertSectionCoverage(options: SectionCoverageOptions): void;
+/** Re-export for consumers that want to pin both sides to one image renderer. */
+export type { RenderImage };
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAcnC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,iEAAiE;IACjE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,iEAAiE;IACjE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,mEAAmE;IACnE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CACrC;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,CAAC,EAAE;IACL,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB,GACA,MAAM,CASR;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,CAAC,EAAE;IACL,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB,GACA,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,CAAC,EAAE,0BAA0B,GAChC,IAAI,CA6BN;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,EAAE,aAAa,CAAC,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChD,sFAAsF;IACtF,SAAS,EAAE,kBAAkB,CAAA;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAsD3E;AAED,iFAAiF;AACjF,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/dist/testing.js

@@ -0,0 +1,159 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Canvas ↔ public section-render parity helpers for Astro-split sites.
+ *
+ * In 100% Next, the editing canvas and the public page share one renderer →
+ * WYSIWYG is free. In the Astro split, the canvas (Next admin) and the public
+ * site (Astro) both orchestrate the same `sectionRenderers` map through
+ * `<Sections>` / `<AdminRoot sectionRenderers>` — this module is the contract
+ * test so those two paths can't drift into a WYSIWYG lie.
+ *
+ * Built-in admin chrome in cms-admin (HeroBannerSection, etc.) is intentionally
+ * out of scope — the harness covers the shared custom-kit path that both
+ * surfaces must keep identical.
+ *
+ * @example
+ * ```ts
+ * import { assertSectionRenderParity } from '@prenta/sections-react/testing'
+ * import { sectionRenderers } from '../register'
+ *
+ * assertSectionRenderParity(
+ *   [{ id: '1', sectionType: 'pricing', content: { heading: 'Plans', plans: [] } }],
+ *   { renderers: sectionRenderers },
+ * )
+ * ```
+ */
+import { renderToStaticMarkup } from 'react-dom/server';
+import { Sections } from './Sections.js';
+/**
+ * Render options that mirror cms-admin `ADMIN_RENDER_OPTIONS`: identity
+ * sanitizer (rich text is sanitized on write) and a plain lazy `<img>` (no
+ * next/image pipeline inside the editor canvas).
+ */
+export const CANVAS_RENDER_OPTIONS = {
+    sanitizeHtml: (html) => html,
+    baseUrl: '',
+    renderImage: ({ src, alt, className, priority, width, height }) => (
+    // eslint-disable-next-line @next/next/no-img-element
+    _jsx("img", { src: src, alt: alt, className: className, width: width ?? undefined, height: height ?? undefined, loading: priority ? undefined : 'lazy' })),
+};
+/**
+ * Normalize SSR HTML for stable equality across public vs canvas image
+ * pipelines. Strips whitespace and attributes that legitimately differ between
+ * `defaultRenderImage` and canvas plain `<img>` (loading / fetchpriority /
+ * decoding / sizes / LCP preload imageSizes) so structural drift still fails.
+ */
+export function normalizeSectionHtml(html) {
+    return html
+        .replace(/\s+/g, ' ')
+        .replace(/\s(loading|fetchpriority|decoding|sizes|imagesizes|imagesrcset)="[^"]*"/gi, '')
+        .trim();
+}
+/** Public orchestrator path — Astro/Next site via `<Sections>`. */
+export function renderPublicSectionsHtml(sections, opts) {
+    return renderToStaticMarkup(_jsx(Sections, { sections: sections, ctx: opts?.ctx, renderers: opts?.renderers, options: opts?.options }));
+}
+/**
+ * Canvas orchestrator path — same `<Sections>` tree with canvas-equivalent
+ * options (mirrors how custom kits receive `ADMIN_RENDER_OPTIONS`).
+ */
+export function renderCanvasSectionsHtml(sections, opts) {
+    return renderToStaticMarkup(_jsx(Sections, { sections: sections, ctx: opts?.ctx, renderers: opts?.renderers, options: { ...CANVAS_RENDER_OPTIONS, ...opts?.options } }));
+}
+/**
+ * Assert that public and canvas orchestrators emit the same normalized tree
+ * for the given sections (+ optional shared renderer map).
+ *
+ * Throws with both HTML snippets on mismatch so CI failures are actionable.
+ */
+export function assertSectionRenderParity(sections, opts) {
+    const normalize = opts?.normalize ?? normalizeSectionHtml;
+    const publicHtml = normalize(renderPublicSectionsHtml(sections, {
+        ctx: opts?.ctx,
+        renderers: opts?.renderers,
+        options: opts?.publicOptions,
+    }));
+    const canvasHtml = normalize(renderCanvasSectionsHtml(sections, {
+        ctx: opts?.ctx,
+        renderers: opts?.renderers,
+        options: opts?.canvasOptions,
+    }));
+    if (publicHtml !== canvasHtml) {
+        throw new Error([
+            'Section render parity failed: public and canvas trees differ.',
+            '',
+            '--- public (normalized) ---',
+            publicHtml,
+            '',
+            '--- canvas (normalized) ---',
+            canvasHtml,
+        ].join('\n'));
+    }
+}
+/**
+ * Assert the three-layer section contract agrees: every declared `sectionType`
+ * has a renderer (or is an explicit data-only opt-out), and every renderer
+ * corresponds to a declared type — so renaming a schema id and leaving the old
+ * renderer behind fails instead of shipping Structure view placeholders.
+ *
+ * This is the check the docs call `verify:sections`. Wire it as a one-line
+ * test against the SAME map you pass to both `<Sections>` and
+ * `<AdminRoot sectionRenderers>`:
+ *
+ * @example
+ * ```ts
+ * import { assertSectionCoverage } from '@prenta/sections-react/testing'
+ * import { marketingSectionTypes } from '../sections/types'
+ * import { sectionRenderers } from '../sections/register'
+ *
+ * assertSectionCoverage({
+ *   declared: marketingSectionTypes,
+ *   renderers: sectionRenderers,
+ *   allowDataOnly: ['careers-listing'], // consumed by a code-owned template
+ * })
+ * ```
+ *
+ * @throws Error listing every problem at once so CI failures are actionable.
+ */
+export function assertSectionCoverage(options) {
+    const declaredIds = options.declared.map((t) => (typeof t === 'string' ? t : t.id));
+    const declared = new Set(declaredIds);
+    const rendererIds = Object.keys(options.renderers);
+    const renderers = new Set(rendererIds);
+    const allowDataOnly = new Set(options.allowDataOnly ?? []);
+    const problems = [];
+    const seen = new Set();
+    for (const id of declaredIds) {
+        if (seen.has(id))
+            problems.push(`"${id}" is declared more than once in sections.types.`);
+        seen.add(id);
+    }
+    for (const id of declared) {
+        if (!renderers.has(id) && !allowDataOnly.has(id)) {
+            problems.push(`"${id}" is declared in sections.types but has no renderer — editors will see a ` +
+                `Structure view placeholder. Add it to the shared renderer map, or list it in ` +
+                `allowDataOnly if it is intentionally data-only.`);
+        }
+    }
+    for (const id of rendererIds) {
+        if (!declared.has(id)) {
+            problems.push(`the renderer map has "${id}" but sections.types does not declare it — a schema id ` +
+                `was renamed or removed while the old renderer stayed behind.`);
+        }
+    }
+    for (const id of allowDataOnly) {
+        if (!declared.has(id)) {
+            problems.push(`allowDataOnly lists "${id}" which is not declared in sections.types — remove it or fix the typo.`);
+        }
+        else if (renderers.has(id)) {
+            problems.push(`allowDataOnly lists "${id}" but the renderer map covers it — remove the stale opt-out.`);
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error([
+            `Section coverage failed (${problems.length} problem${problems.length > 1 ? 's' : ''}):`,
+            ...problems.map((p) => `  - ${p}`),
+        ].join('\n'));
+    }
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Public types for the Prenta section renderer.
+ *
+ * A page/post's renderable content is the ordered `PageSection[]` stored on a
+ * document's `data.sections` JSON (the canonical content contract — see
+ * ADR 0001). This package turns that array into server-rendered React.
+ *
+ * The wire shape here is intentionally permissive (`content`/`settings` are
+ * open records) because it comes off the network as JSON. The authoritative
+ * field schemas live in `@prenta/core/page-sections`.
+ */
+import type { ReactNode } from 'react';
+import type { PublicForm } from '@prenta/core';
+import type { LcpController } from './lcp.js';
+/** A single section as delivered by the CMS (`data.sections[]`). */
+export interface PublicSection {
+    id: string;
+    /** Keys into the section registry; unknown types render via the fallback. */
+    sectionType: string;
+    name?: string;
+    /** Hidden sections are skipped by `<Sections>`. Absent means visible. */
+    visible?: boolean;
+    content?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+}
+/**
+ * Per-request context for post-oriented sections (article body, author bio,
+ * related posts) and the post header. Supplied by the consumer's data layer;
+ * never trusted for HTML unless sanitized (see {@link RenderOptions}).
+ */
+export interface PostContext {
+    title?: string;
+    excerpt?: string;
+    /** Post body HTML — used by the `article-body` section in `source: 'field'` mode. */
+    body?: string;
+    featuredImageUrl?: string;
+    /** Intrinsic featured-image dimensions (from `/resolve` enrichment) — avoids CLS. */
+    featuredImageWidth?: number | null;
+    featuredImageHeight?: number | null;
+    publishDate?: string | null;
+    category?: string;
+    author?: {
+        name?: string;
+        bio?: string;
+        avatarUrl?: string;
+    };
+    relatedPosts?: Array<{
+        title: string;
+        url?: string;
+        excerpt?: string;
+    }>;
+}
+/**
+ * Options threaded to every section renderer.
+ *
+ * `sanitizeHtml` is applied to author-supplied HTML (e.g. the `article-body`
+ * section) before it is injected via `dangerouslySetInnerHTML`.
+ *
+ * SECURITY: the default is the identity function because Prenta sanitizes
+ * rich text on **write** (cms-core `sanitizeHtml`, the allow-list source of
+ * truth). If you render HTML from an untrusted or third-party source, OR want
+ * defense-in-depth, pass a sanitizer here — e.g.
+ * `import { sanitizeHtml } from '@prenta/core'` in a server
+ * component, or any DOMPurify-style function.
+ */
+/** Props passed to a {@link RenderImage} renderer. */
+export interface RenderImageProps {
+    src: string;
+    alt: string;
+    /** Intrinsic dimensions from the media library, when known (helps avoid CLS). */
+    width?: number | null;
+    height?: number | null;
+    className?: string;
+    /** Above-the-fold images opt out of lazy-loading. */
+    priority?: boolean;
+    /** Responsive `sizes` hint, forwarded to image components that support it. */
+    sizes?: string;
+}
+/**
+ * Pluggable image renderer. The default emits a plain `<img>` with native
+ * lazy-loading; a Next.js consumer can pass a `next/image`-backed renderer to
+ * get responsive `srcset` + optimization without coupling this package to Next.
+ */
+export type RenderImage = (props: RenderImageProps) => ReactNode;
+export interface RenderOptions {
+    sanitizeHtml?: (html: string) => string;
+    /**
+     * Origin of the CMS API used by data-driven sections (e.g. the `form`
+     * section's `<PrentaForm>`). Defaults to `''` (same-origin relative URLs),
+     * correct for a Next.js app mounting the Prenta API at `/api/cms`.
+     */
+    baseUrl?: string;
+    /** Custom image renderer (e.g. `next/image`). Defaults to a lazy `<img>`. */
+    renderImage?: RenderImage;
+    /** Shared LCP (priority-image) budget. Pass ONE controller to both
+     * `PostHeader` and `Sections` so a post's featured image and its body
+     * sections compete for the same single priority slot. When omitted, each
+     * component creates its own (correct when only one is rendered).
+     */
+    lcp?: LcpController;
+    /**
+     * Pre-fetched public form schemas keyed by slug. When a `form` section
+     * references a slug present here, the server renders {@link PrentaFormHtml}
+     * (zero-JS + WebMCP) instead of the client {@link PrentaForm} island.
+     */
+    prefetchedForms?: Record<string, PublicForm>;
+}
+/** Internal: options with all defaults resolved. */
+export interface ResolvedRenderOptions {
+    sanitizeHtml: (html: string) => string;
+    baseUrl: string;
+    renderImage: RenderImage;
+    lcp: LcpController;
+    prefetchedForms: Record<string, PublicForm>;
+}
+/** Props every section renderer receives. */
+export interface SectionRendererProps {
+    section: PublicSection;
+    ctx?: PostContext;
+    options: ResolvedRenderOptions;
+}
+/**
+ * A section renderer: maps one section's content to React. Renderers must be
+ * SSR-safe (no browser-only APIs at module/render time) so they work in React
+ * Server Components.
+ */
+export type SectionRenderer = (props: SectionRendererProps) => ReactNode;
+/** A map of section-type id → renderer (used for overrides + the defaults). */
+export type SectionRendererMap = Record<string, SectionRenderer>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Small, pure helpers shared by the default section renderers. No DOM or
+ * browser APIs — these run in React Server Components.
+ */
+/** Read a string field from a section's content, with a fallback. */
+export declare function str(content: Record<string, unknown> | undefined, key: string, fallback?: string): string;
+/** Read a boolean field from a section's content, with a fallback. */
+export declare function bool(content: Record<string, unknown> | undefined, key: string, fallback?: boolean): boolean;
+/** Read a finite number field from a section's content, else `null`. */
+export declare function num(content: Record<string, unknown> | undefined, key: string): number | null;
+/** Read an array-of-records field (e.g. `stats`, `images`) defensively. */
+export declare function rows(content: Record<string, unknown> | undefined, key: string): Array<Record<string, unknown>>;
+/** Vertical padding utility class from a section's `paddingY` setting. */
+export declare function paddingClass(settings: Record<string, unknown> | undefined): string;
+/** Background + text-color utility classes from a section's background settings. */
+export declare function backgroundClass(settings: Record<string, unknown> | undefined): string;
+/** True when a section uses a dark (purple) background — drives button tone. */
+export declare function isDark(settings: Record<string, unknown> | undefined): boolean;
+/** Format an ISO date for a post header; empty string when missing/invalid. */
+export declare function formatHeaderDate(value?: string | null): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AACrE,wBAAgB,GAAG,CACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,GAAG,EAAE,MAAM,EACX,QAAQ,SAAK,GACZ,MAAM,CAGR;AAED,sEAAsE;AACtE,wBAAgB,IAAI,CAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,GAAG,EAAE,MAAM,EACX,QAAQ,UAAQ,GACf,OAAO,CAGT;AAED,wEAAwE;AACxE,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5F;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,GAAG,EAAE,MAAM,GACV,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAGhC;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAWlF;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CASrF;AAED,gFAAgF;AAChF,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAK7E;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAK9D"}

package/dist/utils.js

@@ -0,0 +1,65 @@
+/**
+ * Small, pure helpers shared by the default section renderers. No DOM or
+ * browser APIs — these run in React Server Components.
+ */
+/** Read a string field from a section's content, with a fallback. */
+export function str(content, key, fallback = '') {
+    const v = content?.[key];
+    return typeof v === 'string' ? v : fallback;
+}
+/** Read a boolean field from a section's content, with a fallback. */
+export function bool(content, key, fallback = false) {
+    const v = content?.[key];
+    return typeof v === 'boolean' ? v : fallback;
+}
+/** Read a finite number field from a section's content, else `null`. */
+export function num(content, key) {
+    const v = content?.[key];
+    return typeof v === 'number' && Number.isFinite(v) ? v : null;
+}
+/** Read an array-of-records field (e.g. `stats`, `images`) defensively. */
+export function rows(content, key) {
+    const v = content?.[key];
+    return Array.isArray(v) ? v : [];
+}
+/** Vertical padding utility class from a section's `paddingY` setting. */
+export function paddingClass(settings) {
+    switch (settings?.paddingY) {
+        case 'sm':
+            return 'py-8';
+        case 'md':
+            return 'py-12';
+        case 'xl':
+            return 'py-20 sm:py-28';
+        default:
+            return 'py-16 sm:py-20';
+    }
+}
+/** Background + text-color utility classes from a section's background settings. */
+export function backgroundClass(settings) {
+    const type = settings?.backgroundType;
+    const color = settings?.backgroundColor;
+    if (type === 'gradient' && color === 'purple') {
+        return 'bg-gradient-to-br from-violet-600 to-violet-700 text-white';
+    }
+    if (type === 'solid' && color === 'purple')
+        return 'bg-violet-600 text-white';
+    if (type === 'solid' && color === 'muted')
+        return 'bg-zinc-50 text-zinc-900';
+    return 'bg-white text-zinc-900';
+}
+/** True when a section uses a dark (purple) background — drives button tone. */
+export function isDark(settings) {
+    return ((settings?.backgroundType === 'solid' || settings?.backgroundType === 'gradient') &&
+        settings?.backgroundColor === 'purple');
+}
+/** Format an ISO date for a post header; empty string when missing/invalid. */
+export function formatHeaderDate(value) {
+    if (!value)
+        return '';
+    const d = new Date(value);
+    if (Number.isNaN(d.getTime()))
+        return '';
+    return d.toLocaleDateString(undefined, { year: 'numeric', month: 'long', day: 'numeric' });
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/webmcp.d.ts

@@ -0,0 +1,6 @@
+import type { PublicForm, PublicFormField } from './forms.js';
+/** Lowercase WebMCP declarative attributes for a `<form>` element. */
+export declare function webMcpFormAttributes(form: PublicForm): Record<string, string | boolean>;
+/** `toolparamdescription` for a single field when WebMCP is enabled. */
+export declare function webMcpFieldAttribute(form: PublicForm, field: PublicFormField): Record<string, string>;
+//# sourceMappingURL=webmcp.d.ts.map

package/dist/webmcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.d.ts","sourceRoot":"","sources":["../src/webmcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE7D,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAQvF;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,GACrB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGxB"}

package/dist/webmcp.js

@@ -0,0 +1,18 @@
+/** Lowercase WebMCP declarative attributes for a `<form>` element. */
+export function webMcpFormAttributes(form) {
+    if (!form.webmcp?.enabled)
+        return {};
+    const attrs = {
+        toolname: form.webmcp.toolName,
+        tooldescription: form.webmcp.toolDescription,
+    };
+    if (form.webmcp.autoSubmit)
+        attrs.toolautosubmit = true;
+    return attrs;
+}
+/** `toolparamdescription` for a single field when WebMCP is enabled. */
+export function webMcpFieldAttribute(form, field) {
+    const desc = form.webmcp?.fieldParams[field.key];
+    return desc ? { toolparamdescription: desc } : {};
+}
+//# sourceMappingURL=webmcp.js.map

package/dist/webmcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.js","sourceRoot":"","sources":["../src/webmcp.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO,EAAE,CAAA;IACpC,MAAM,KAAK,GAAqC;QAC9C,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;QAC9B,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe;KAC7C,CAAA;IACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAAA;IACvD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAClC,IAAgB,EAChB,KAAsB;IAEtB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACnD,CAAC"}