@prenta/admin 0.92.0 → 0.94.0

package/dist/hooks/usePageAudit.d.ts

@@ -0,0 +1,41 @@
+import type { PageSection } from '@prenta/core/page-sections';
+import { type PageAuditResult } from '@prenta/core/seo/page-audit';
+import { type SeoContentRecord } from '../lib/seo-service.js';
+export interface UsePageAuditArgs {
+    entityType: 'page' | 'post';
+    /** Null for an unsaved document — there is no record to audit against yet. */
+    entityId: string | null;
+    sections: PageSection[];
+    slug: string;
+    /**
+     * The document's own meta, used when no SEO record exists yet. A page that
+     * has never had SEO edited still has a title, a description and sections —
+     * it is scoreable, and refusing to score it leaves the header chip blank on
+     * exactly the pages that most need the nudge.
+     */
+    fallback?: {
+        title?: string;
+        description?: string;
+    };
+}
+/**
+ * The page's audit, from its saved SEO record — or from the document's own
+ * fields when no record exists yet, so every page has a number.
+ *
+ * This exists so the header chip and the rail's tab dot have a score from first
+ * paint. Previously the audit was computed inside the SEO pane, which mounts
+ * only when its tab is opened — so before that the chip showed a number from a
+ * different scorer with different bands, and the header read 53 beside rings
+ * reading 0 and 57.
+ *
+ * While the SEO pane is open it reports a LIVE audit built from unsaved form
+ * state, which supersedes this one. Both go through `buildPageAuditInput`, so
+ * they differ only in saved-versus-unsaved metadata — the difference an editor
+ * expects to see — and never in how a check is decided.
+ */
+export declare function usePageAudit({ entityType, entityId, sections, slug, fallback, }: UsePageAuditArgs): {
+    audit: PageAuditResult;
+    record: SeoContentRecord | null;
+    reload: () => void;
+};
+//# sourceMappingURL=usePageAudit.d.ts.map

package/dist/hooks/usePageAudit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageAudit.d.ts","sourceRoot":"","sources":["../../src/hooks/usePageAudit.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7E,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAGpF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACpD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,EAC3B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,GACT,EAAE,gBAAgB,GAAG;IACpB,KAAK,EAAE,eAAe,CAAA;IACtB,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB,CAiDA"}

package/dist/hooks/usePageAudit.js

@@ -0,0 +1,68 @@
+'use client';
+import { useCallback, useEffect, useState } from 'react';
+import { auditPage } from '@prenta/core/seo/page-audit';
+import { fetchSeoContentRecord } from '../lib/seo-service.js';
+import { buildPageAuditInput, metaFromRecord } from '../lib/page-audit-input.js';
+/**
+ * The page's audit, from its saved SEO record — or from the document's own
+ * fields when no record exists yet, so every page has a number.
+ *
+ * This exists so the header chip and the rail's tab dot have a score from first
+ * paint. Previously the audit was computed inside the SEO pane, which mounts
+ * only when its tab is opened — so before that the chip showed a number from a
+ * different scorer with different bands, and the header read 53 beside rings
+ * reading 0 and 57.
+ *
+ * While the SEO pane is open it reports a LIVE audit built from unsaved form
+ * state, which supersedes this one. Both go through `buildPageAuditInput`, so
+ * they differ only in saved-versus-unsaved metadata — the difference an editor
+ * expects to see — and never in how a check is decided.
+ */
+export function usePageAudit({ entityType, entityId, sections, slug, fallback, }) {
+    const [record, setRecord] = useState(null);
+    const [nonce, setNonce] = useState(0);
+    useEffect(() => {
+        if (!entityId) {
+            setRecord(null);
+            return;
+        }
+        let alive = true;
+        fetchSeoContentRecord(entityType, entityId)
+            .then((rec) => {
+            if (alive)
+                setRecord(rec);
+        })
+            .catch(() => {
+            // A page that has never had SEO saved has no record. That is not an
+            // error worth surfacing here — the audit simply reports what it can,
+            // and the SEO pane shows its own error state if the user opens it.
+            if (alive)
+                setRecord(null);
+        });
+        return () => {
+            alive = false;
+        };
+    }, [entityType, entityId, nonce]);
+    /**
+     * With a record, audit the saved SEO. Without one, audit the document's own
+     * fields and treat the record-only inputs as unset — which is honest: no
+     * focus keyword has been chosen, no schema has been bound, and nothing has
+     * set noindex. The score is real, and it improves the moment SEO is filled in.
+     */
+    const meta = record
+        ? metaFromRecord(record)
+        : {
+            metaTitle: fallback?.title ?? '',
+            metaDescription: fallback?.description ?? '',
+            focusKeyword: '',
+            structuredDataType: '',
+            noindex: false,
+            nosnippet: false,
+            llmsInclude: 'AUTO',
+            hasOgImage: false,
+        };
+    const audit = auditPage(buildPageAuditInput({ sections, meta, slug, record }));
+    const reload = useCallback(() => setNonce((n) => n + 1), []);
+    return { audit, record, reload };
+}
+//# sourceMappingURL=usePageAudit.js.map

package/dist/hooks/usePageAudit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageAudit.js","sourceRoot":"","sources":["../../src/hooks/usePageAudit.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAExD,OAAO,EAAE,SAAS,EAAwB,MAAM,6BAA6B,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAyB,MAAM,uBAAuB,CAAA;AACpF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAiBhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,EAC3B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,GACS;IAKjB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA0B,IAAI,CAAC,CAAA;IACnE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS,CAAC,IAAI,CAAC,CAAA;YACf,OAAM;QACR,CAAC;QACD,IAAI,KAAK,GAAG,IAAI,CAAA;QAChB,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC;aACxC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,KAAK;gBAAE,SAAS,CAAC,GAAG,CAAC,CAAA;QAC3B,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,oEAAoE;YACpE,qEAAqE;YACrE,mEAAmE;YACnE,IAAI,KAAK;gBAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QACJ,OAAO,GAAG,EAAE;YACV,KAAK,GAAG,KAAK,CAAA;QACf,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;IAEjC;;;;;OAKG;IACH,MAAM,IAAI,GAAG,MAAM;QACjB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC;QACxB,CAAC,CAAC;YACE,SAAS,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE;YAChC,eAAe,EAAE,QAAQ,EAAE,WAAW,IAAI,EAAE;YAC5C,YAAY,EAAE,EAAE;YAChB,kBAAkB,EAAE,EAAE;YACtB,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE,KAAK;SAClB,CAAA;IAEL,MAAM,KAAK,GAAG,SAAS,CAAC,mBAAmB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAE9E,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAE5D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAClC,CAAC"}

package/dist/hooks/useReflowGuard.d.ts

@@ -0,0 +1,47 @@
+import type { BreakpointId } from '../lib/breakpoints.js';
+import { type FieldLineCount, type ReflowSeverity } from '../lib/reflow-probe.js';
+export interface ReflowRow extends FieldLineCount {
+    /** Lines this field ran to in the published version. */
+    was: number;
+    /** `lines - was`. Only growth is treated as a problem. */
+    diff: number;
+    state: ReflowSeverity;
+}
+export interface ReflowGuardResult {
+    rows: ReflowRow[];
+    /** Breakpoints where the field now wraps to more lines than published. */
+    grown: ReflowRow[];
+    /** The one worth proofing on, or `null` when nothing grew. */
+    worst: BreakpointId | null;
+    /** Character delta against the published string; 0 when there is no baseline. */
+    delta: number;
+}
+/**
+ * Measures how one field wraps at every breakpoint, and how that compares to
+ * what is published.
+ *
+ * ── Why it runs on a delay ────────────────────────────────────────────────
+ *
+ * A pass clones the canvas and lays it out twelve times (six widths, current
+ * and published). That is far too much to do per keystroke, and it is also
+ * pointless — mid-word text tells an editor nothing. So it settles first.
+ *
+ * `null` from the probe means the field is not measurable: the section may be
+ * rendered by a consumer's own component that carries no `data-cms-field`
+ * markers. The guard then reports nothing rather than a number read off the
+ * wrong element — an editor treats a line count as a fact, and a confident
+ * wrong one is worse than a blank.
+ */
+export declare function useReflowGuard(options: {
+    canvas: HTMLElement | null;
+    sectionId: string;
+    fieldPath: string;
+    /** Current field text. Only used to retrigger — the probe reads the DOM. */
+    value: string;
+    /** Published text, or `undefined` when the field has never been published. */
+    baseline: string | undefined;
+    /** Skip measuring entirely (field type isn't guarded, panel is collapsed). */
+    enabled?: boolean;
+    delayMs?: number;
+}): ReflowGuardResult;
+//# sourceMappingURL=useReflowGuard.d.ts.map

package/dist/hooks/useReflowGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReflowGuard.d.ts","sourceRoot":"","sources":["../../src/hooks/useReflowGuard.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,cAAc,CAAA;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,0EAA0E;IAC1E,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,8DAA8D;IAC9D,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAC1B,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;CACd;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,iBAAiB,CAoCpB"}

package/dist/hooks/useReflowGuard.js

@@ -0,0 +1,52 @@
+'use client';
+import { useEffect, useState } from 'react';
+import { probeFieldReflow, reflowSeverity, worstBreakpoint, } from '../lib/reflow-probe.js';
+const EMPTY = { rows: [], grown: [], worst: null, delta: 0 };
+/**
+ * Measures how one field wraps at every breakpoint, and how that compares to
+ * what is published.
+ *
+ * ── Why it runs on a delay ────────────────────────────────────────────────
+ *
+ * A pass clones the canvas and lays it out twelve times (six widths, current
+ * and published). That is far too much to do per keystroke, and it is also
+ * pointless — mid-word text tells an editor nothing. So it settles first.
+ *
+ * `null` from the probe means the field is not measurable: the section may be
+ * rendered by a consumer's own component that carries no `data-cms-field`
+ * markers. The guard then reports nothing rather than a number read off the
+ * wrong element — an editor treats a line count as a fact, and a confident
+ * wrong one is worse than a blank.
+ */
+export function useReflowGuard(options) {
+    const { canvas, sectionId, fieldPath, value, baseline, enabled = true, delayMs = 200 } = options;
+    const [result, setResult] = useState(EMPTY);
+    useEffect(() => {
+        if (!enabled || !canvas) {
+            setResult(EMPTY);
+            return;
+        }
+        const timer = setTimeout(() => {
+            const probed = probeFieldReflow({ canvas, sectionId, fieldPath, baselineText: baseline });
+            if (!probed) {
+                setResult(EMPTY);
+                return;
+            }
+            const rows = probed.current.map((row) => {
+                const was = probed.baseline.find((b) => b.id === row.id)?.lines ?? row.lines;
+                return { ...row, was, diff: row.lines - was, state: reflowSeverity(row.lines, was) };
+            });
+            setResult({
+                rows,
+                grown: rows.filter((r) => r.diff > 0),
+                worst: worstBreakpoint(probed.current, probed.baseline),
+                delta: baseline === undefined ? 0 : value.length - baseline.length,
+            });
+        }, delayMs);
+        return () => clearTimeout(timer);
+        // `value` is a dependency because the canvas re-renders as it changes —
+        // the probe reads the resulting DOM rather than the string itself.
+    }, [canvas, sectionId, fieldPath, value, baseline, enabled, delayMs]);
+    return result;
+}
+//# sourceMappingURL=useReflowGuard.js.map

package/dist/hooks/useReflowGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReflowGuard.js","sourceRoot":"","sources":["../../src/hooks/useReflowGuard.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,GAGhB,MAAM,wBAAwB,CAAA;AAoB/B,MAAM,KAAK,GAAsB,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,OAW9B;IACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAA;IAChG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAoB,KAAK,CAAC,CAAA;IAE9D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,SAAS,CAAC,KAAK,CAAC,CAAA;YAChB,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAA;YACzF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,SAAS,CAAC,KAAK,CAAC,CAAA;gBAChB,OAAM;YACR,CAAC;YAED,MAAM,IAAI,GAAgB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACnD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC,KAAK,CAAA;gBAC5E,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAA;YACtF,CAAC,CAAC,CAAA;YAEF,SAAS,CAAC;gBACR,IAAI;gBACJ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBACrC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;gBACvD,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;aACnE,CAAC,CAAA;QACJ,CAAC,EAAE,OAAO,CAAC,CAAA;QAEX,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;QAChC,wEAAwE;QACxE,mEAAmE;IACrE,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IAErE,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/layout/primitives/AdminShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdminShell.d.ts","sourceRoot":"","sources":["../../../src/layout/primitives/AdminShell.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,OAAO,EAAE,SAAS,CAAA;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,0DAA0D;IAC1D,QAAQ,EAAE,SAAS,CAAA;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAA;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,MAAM,EACN,WAAW,EACX,QAAQ,EACR,iBAAyB,EACzB,oBAAoB,EACpB,iBAAuB,GACxB,EAAE,eAAe,2CAiEjB"}
+{"version":3,"file":"AdminShell.d.ts","sourceRoot":"","sources":["../../../src/layout/primitives/AdminShell.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,OAAO,EAAE,SAAS,CAAA;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,CAAA;IACvB,0DAA0D;IAC1D,QAAQ,EAAE,SAAS,CAAA;IACnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAA;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,MAAM,EACN,WAAW,EACX,QAAQ,EACR,iBAAyB,EACzB,oBAAoB,EACpB,iBAAuB,GACxB,EAAE,eAAe,2CA6EjB"}

package/dist/layout/primitives/AdminShell.js

@@ -31,7 +31,7 @@ export function AdminShell({ sidebar, header, breadcrumbs, children, mobileSideb
     }, [desktopBreakpoint]);
     return (_jsxs("div", { className: "bg-background text-foreground h-screen overflow-hidden", style: isDesktop
             ? { display: 'grid', gridTemplateColumns: 'auto minmax(0, 1fr)' }
-            : { display: 'block', position: 'relative' }, children: [!isDesktop && mobileSidebarOpen && (_jsx("div", { "aria-hidden": true, className: "fixed inset-0 z-40 bg-black/30 backdrop-blur-sm", onClick: onMobileSidebarClose })), _jsx("div", { className: "z-50", style: isDesktop
+            : { display: 'block', position: 'relative' }, children: [_jsx("a", { className: "prenta-skip-link", href: "#prenta-main", children: "Skip to content" }), !isDesktop && mobileSidebarOpen && (_jsx("div", { "aria-hidden": true, className: "fixed inset-0 z-40 bg-black/30 backdrop-blur-sm", onClick: onMobileSidebarClose })), _jsx("div", { className: "z-50", style: isDesktop
                     ? {
                         gridColumn: '1 / 2',
                         height: '100vh',
@@ -46,6 +46,6 @@ export function AdminShell({ sidebar, header, breadcrumbs, children, mobileSideb
                         transition: 'transform 300ms ease',
                     }, children: sidebar }), _jsxs("div", { className: "flex flex-col overflow-hidden", style: isDesktop
                     ? { gridColumn: '2 / 3', height: '100vh', minWidth: 0 }
-                    : { height: '100vh', minWidth: 0 }, children: [header, breadcrumbs, _jsx("main", { className: "min-h-0 flex-1 overflow-y-auto", children: children })] })] }));
+                    : { height: '100vh', minWidth: 0 }, children: [header, breadcrumbs, _jsx("main", { id: "prenta-main", className: "min-h-0 flex-1 overflow-y-auto", children: children })] })] }));
 }
 //# sourceMappingURL=AdminShell.js.map

package/dist/layout/primitives/AdminShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdminShell.js","sourceRoot":"","sources":["../../../src/layout/primitives/AdminShell.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AA0B3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,OAAO,EACP,MAAM,EACN,WAAW,EACX,QAAQ,EACR,iBAAiB,GAAG,KAAK,EACzB,oBAAoB,EACpB,iBAAiB,GAAG,GAAG,GACP;IAChB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAM;QACzC,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,iBAAiB,KAAK,CAAC,CAAA;QACnE,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;QAC9C,OAAO,EAAE,CAAA;QACT,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACtC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACxD,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEvB,OAAO,CACL,eACE,SAAS,EAAC,wDAAwD,EAClE,KAAK,EACH,SAAS;YACP,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,qBAAqB,EAAE;YACjE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAG/C,CAAC,SAAS,IAAI,iBAAiB,IAAI,CAClC,mCAEE,SAAS,EAAC,iDAAiD,EAC3D,OAAO,EAAE,oBAAoB,GAC7B,CACH,EAED,cACE,SAAS,EAAC,MAAM,EAChB,KAAK,EACH,SAAS;oBACP,CAAC,CAAC;wBACE,UAAU,EAAE,OAAO;wBACnB,MAAM,EAAE,OAAO;wBACf,QAAQ,EAAE,QAAQ;qBACnB;oBACH,CAAC,CAAC;wBACE,QAAQ,EAAE,OAAO;wBACjB,GAAG,EAAE,CAAC;wBACN,MAAM,EAAE,CAAC;wBACT,IAAI,EAAE,CAAC;wBACP,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB;wBACpE,UAAU,EAAE,sBAAsB;qBACnC,YAGN,OAAO,GACJ,EAEN,eACE,SAAS,EAAC,+BAA+B,EACzC,KAAK,EACH,SAAS;oBACP,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;oBACvD,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,aAGrC,MAAM,EACN,WAAW,EACZ,eAAM,SAAS,EAAC,gCAAgC,YAAE,QAAQ,GAAQ,IAC9D,IACF,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"AdminShell.js","sourceRoot":"","sources":["../../../src/layout/primitives/AdminShell.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AA0B3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,OAAO,EACP,MAAM,EACN,WAAW,EACX,QAAQ,EACR,iBAAiB,GAAG,KAAK,EACzB,oBAAoB,EACpB,iBAAiB,GAAG,GAAG,GACP;IAChB,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAM;QACzC,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,iBAAiB,KAAK,CAAC,CAAA;QACnE,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;QAC9C,OAAO,EAAE,CAAA;QACT,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACtC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACxD,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEvB,OAAO,CACL,eACE,SAAS,EAAC,wDAAwD,EAClE,KAAK,EACH,SAAS;YACP,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,qBAAqB,EAAE;YACjE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAShD,YAAG,SAAS,EAAC,kBAAkB,EAAC,IAAI,EAAC,cAAc,gCAE/C,EAEH,CAAC,SAAS,IAAI,iBAAiB,IAAI,CAClC,mCAEE,SAAS,EAAC,iDAAiD,EAC3D,OAAO,EAAE,oBAAoB,GAC7B,CACH,EAED,cACE,SAAS,EAAC,MAAM,EAChB,KAAK,EACH,SAAS;oBACP,CAAC,CAAC;wBACE,UAAU,EAAE,OAAO;wBACnB,MAAM,EAAE,OAAO;wBACf,QAAQ,EAAE,QAAQ;qBACnB;oBACH,CAAC,CAAC;wBACE,QAAQ,EAAE,OAAO;wBACjB,GAAG,EAAE,CAAC;wBACN,MAAM,EAAE,CAAC;wBACT,IAAI,EAAE,CAAC;wBACP,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB;wBACpE,UAAU,EAAE,sBAAsB;qBACnC,YAGN,OAAO,GACJ,EAEN,eACE,SAAS,EAAC,+BAA+B,EACzC,KAAK,EACH,SAAS;oBACP,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;oBACvD,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,aAGrC,MAAM,EACN,WAAW,EACZ,eAAM,EAAE,EAAC,aAAa,EAAC,SAAS,EAAC,gCAAgC,YAC9D,QAAQ,GACJ,IACH,IACF,CACP,CAAA;AACH,CAAC"}

package/dist/lib/breakpoints.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Breakpoint presets for the editor canvas — shared by the page editor, the
+ * post editor, and the site-preview frame.
+ *
+ * Each entry's `width` is the **real CSS width** the canvas renders at. The
+ * canvas is then scaled down with a transform to fit the available column, so
+ * the page reflows against its own width via container queries rather than
+ * being squeezed by a max-width clamp. A clamp does not reflow: it produces a
+ * narrow desktop layout, not the mobile layout.
+ *
+ * `4k` is 2560, not 3840. 2560 is the CSS width a 4K/Retina display reports
+ * once device-pixel-ratio is applied; 3840 is the physical pixel count and no
+ * stylesheet ever sees it. It is also the only preset above the canvas's
+ * `min-width: 2000px` container step, so it is the only one that exercises
+ * that branch.
+ */
+export type BreakpointId = '4k' | 'wide' | 'laptop' | 'tabletL' | 'tabletP' | 'mobile';
+export type BreakpointGroup = 'DESKTOP' | 'TABLET' | 'MOBILE';
+export interface Breakpoint {
+    id: BreakpointId;
+    /** Full name, shown in the picker menu. */
+    name: string;
+    /** Two-letter form for the collapsed trigger. */
+    abbr: string;
+    /** lucide-react icon name */
+    icon: string;
+    /** Real CSS width of the preview surface, in px. */
+    width: number;
+    group: BreakpointGroup;
+}
+export declare const BREAKPOINTS: readonly Breakpoint[];
+/** Menu order. Groups render as labelled sections in the breakpoint picker. */
+export declare const BREAKPOINT_GROUPS: readonly BreakpointGroup[];
+export declare const DEFAULT_BREAKPOINT: BreakpointId;
+export declare function getBreakpoint(id: BreakpointId): Breakpoint;
+export declare function breakpointsInGroup(group: BreakpointGroup): Breakpoint[];
+export declare function coerceBreakpointId(value: unknown): BreakpointId;
+export type Zoom = 'fit' | 1;
+/**
+ * Scale factor for the canvas transform.
+ *
+ * `available` must come from a zero-height sentinel measured inside the canvas
+ * panel — NOT from `panel.clientWidth - padding`. The two disagree whenever the
+ * host scales the preview or a scrollbar appears, and the padding arithmetic is
+ * the kind that silently rots when the gutter changes.
+ *
+ * Never scales above 1: a 390px mobile canvas blown up to fill a 1200px column
+ * would show text at 3× the size the visitor sees.
+ */
+export declare function fitScale(available: number, width: number, zoom?: Zoom): number;
+//# sourceMappingURL=breakpoints.d.ts.map

package/dist/lib/breakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.d.ts","sourceRoot":"","sources":["../../src/lib/breakpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEtF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,YAAY,CAAA;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EAqB5C,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAAoC,CAAA;AAE5F,eAAO,MAAM,kBAAkB,EAAE,YAAqB,CAAA;AAItD,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,UAAU,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,EAAE,CAEvE;AAaD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAI/D;AAED,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAA;AAE5B;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAY,GAAG,MAAM,CAIrF"}

package/dist/lib/breakpoints.js

@@ -0,0 +1,84 @@
+/**
+ * Breakpoint presets for the editor canvas — shared by the page editor, the
+ * post editor, and the site-preview frame.
+ *
+ * Each entry's `width` is the **real CSS width** the canvas renders at. The
+ * canvas is then scaled down with a transform to fit the available column, so
+ * the page reflows against its own width via container queries rather than
+ * being squeezed by a max-width clamp. A clamp does not reflow: it produces a
+ * narrow desktop layout, not the mobile layout.
+ *
+ * `4k` is 2560, not 3840. 2560 is the CSS width a 4K/Retina display reports
+ * once device-pixel-ratio is applied; 3840 is the physical pixel count and no
+ * stylesheet ever sees it. It is also the only preset above the canvas's
+ * `min-width: 2000px` container step, so it is the only one that exercises
+ * that branch.
+ */
+export const BREAKPOINTS = [
+    { id: '4k', name: '4K / Retina', abbr: '4K', icon: 'monitor', width: 2560, group: 'DESKTOP' },
+    { id: 'wide', name: 'Wide Screen', abbr: 'WS', icon: 'monitor', width: 1920, group: 'DESKTOP' },
+    { id: 'laptop', name: 'Laptop', abbr: 'LT', icon: 'laptop', width: 1440, group: 'DESKTOP' },
+    {
+        id: 'tabletL',
+        name: 'Tablet Landscape',
+        abbr: 'TL',
+        icon: 'tablet',
+        width: 1024,
+        group: 'TABLET',
+    },
+    {
+        id: 'tabletP',
+        name: 'Tablet Portrait',
+        abbr: 'TP',
+        icon: 'tablet',
+        width: 768,
+        group: 'TABLET',
+    },
+    { id: 'mobile', name: 'Mobile', abbr: 'M', icon: 'smartphone', width: 390, group: 'MOBILE' },
+];
+/** Menu order. Groups render as labelled sections in the breakpoint picker. */
+export const BREAKPOINT_GROUPS = ['DESKTOP', 'TABLET', 'MOBILE'];
+export const DEFAULT_BREAKPOINT = 'wide';
+const BY_ID = new Map(BREAKPOINTS.map((b) => [b.id, b]));
+export function getBreakpoint(id) {
+    return BY_ID.get(id) ?? BY_ID.get(DEFAULT_BREAKPOINT);
+}
+export function breakpointsInGroup(group) {
+    return BREAKPOINTS.filter((b) => b.group === group);
+}
+/**
+ * Narrows arbitrary input (persisted state, a URL param, a stale prop) to a
+ * known id. The v0.92 preset ids — `1080p` and `tablet` — map onto their
+ * closest current equivalents so an editor open across the upgrade doesn't
+ * land on the default.
+ */
+const LEGACY_IDS = {
+    '1080p': 'laptop', // was 1440 — same width, renamed
+    tablet: 'tabletP', // was 768 — same width, split into landscape/portrait
+};
+export function coerceBreakpointId(value) {
+    if (typeof value !== 'string')
+        return DEFAULT_BREAKPOINT;
+    if (BY_ID.has(value))
+        return value;
+    return LEGACY_IDS[value] ?? DEFAULT_BREAKPOINT;
+}
+/**
+ * Scale factor for the canvas transform.
+ *
+ * `available` must come from a zero-height sentinel measured inside the canvas
+ * panel — NOT from `panel.clientWidth - padding`. The two disagree whenever the
+ * host scales the preview or a scrollbar appears, and the padding arithmetic is
+ * the kind that silently rots when the gutter changes.
+ *
+ * Never scales above 1: a 390px mobile canvas blown up to fill a 1200px column
+ * would show text at 3× the size the visitor sees.
+ */
+export function fitScale(available, width, zoom = 'fit') {
+    if (zoom !== 'fit')
+        return 1;
+    if (!Number.isFinite(available) || available <= 0 || width <= 0)
+        return 1;
+    return Math.min(1, available / width);
+}
+//# sourceMappingURL=breakpoints.js.map

package/dist/lib/breakpoints.js.map

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

package/dist/lib/canvas-edit-chrome.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared edit affordances for the page/post canvas and Site preview iframe.
+ *
+ * Structure canvas: section hover is styled in `theme.css` under `.prenta-canvas`.
+ * Site preview: the same field chrome is injected into the iframe document when
+ * same-origin (CMS-host preview) so consumers get hover borders without shipping CSS.
+ */
+/** localStorage key for the dismissible canvas tip. */
+export declare const CANVAS_EDIT_TIP_STORAGE_KEY = "prenta.canvasEditTip.dismissed";
+/**
+ * CSS injected into the Site preview iframe while editing is enabled.
+ * Uses system colors so it works without admin theme tokens in the iframe.
+ */
+export declare const PREVIEW_EDITABLE_FIELD_CHROME_CSS: string;
+/**
+ * Inject (or refresh) editable-field hover chrome into a same-origin preview
+ * iframe. No-ops on cross-origin frames (browser blocks contentDocument).
+ */
+export declare function injectPreviewEditChrome(iframe: HTMLIFrameElement | null): boolean;
+export declare function isCanvasEditTipDismissed(): boolean;
+export declare function dismissCanvasEditTip(): void;
+//# sourceMappingURL=canvas-edit-chrome.d.ts.map

package/dist/lib/canvas-edit-chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-edit-chrome.d.ts","sourceRoot":"","sources":["../../src/lib/canvas-edit-chrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,eAAO,MAAM,2BAA2B,mCAAmC,CAAA;AAE3E;;;GAGG;AACH,eAAO,MAAM,iCAAiC,QA0BtC,CAAA;AAIR;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAgBjF;AAED,wBAAgB,wBAAwB,IAAI,OAAO,CAMlD;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C"}

package/dist/lib/canvas-edit-chrome.js

@@ -0,0 +1,81 @@
+/**
+ * Shared edit affordances for the page/post canvas and Site preview iframe.
+ *
+ * Structure canvas: section hover is styled in `theme.css` under `.prenta-canvas`.
+ * Site preview: the same field chrome is injected into the iframe document when
+ * same-origin (CMS-host preview) so consumers get hover borders without shipping CSS.
+ */
+/** localStorage key for the dismissible canvas tip. */
+export const CANVAS_EDIT_TIP_STORAGE_KEY = 'prenta.canvasEditTip.dismissed';
+/**
+ * CSS injected into the Site preview iframe while editing is enabled.
+ * Uses system colors so it works without admin theme tokens in the iframe.
+ */
+export const PREVIEW_EDITABLE_FIELD_CHROME_CSS = `
+/* Prenta Site preview — editable field hover chrome (injected by @prenta/admin) */
+[data-cms-field] {
+  outline: 1px solid transparent;
+  outline-offset: 2px;
+  border-radius: 2px;
+  transition: outline-color 120ms ease;
+  cursor: text;
+}
+[data-cms-field]:hover,
+[data-cms-field]:focus,
+[data-cms-field]:focus-within {
+  outline-color: color-mix(in oklab, CanvasText 24%, transparent);
+}
+[data-cms-field][data-cms-field-kind="media"] {
+  cursor: pointer;
+}
+[data-cms-field][data-cms-field-kind="media"]:hover,
+[data-cms-field][data-cms-field-kind="media"]:focus {
+  outline-color: color-mix(in oklab, CanvasText 32%, transparent);
+}
+@media (prefers-reduced-motion: reduce) {
+  [data-cms-field] {
+    transition: none;
+  }
+}
+`.trim();
+const STYLE_ATTR = 'data-prenta-edit-chrome';
+/**
+ * Inject (or refresh) editable-field hover chrome into a same-origin preview
+ * iframe. No-ops on cross-origin frames (browser blocks contentDocument).
+ */
+export function injectPreviewEditChrome(iframe) {
+    try {
+        const doc = iframe?.contentDocument;
+        if (!doc?.head)
+            return false;
+        let style = doc.head.querySelector(`style[${STYLE_ATTR}]`);
+        if (!style) {
+            style = doc.createElement('style');
+            style.setAttribute(STYLE_ATTR, '1');
+            doc.head.appendChild(style);
+        }
+        style.textContent = PREVIEW_EDITABLE_FIELD_CHROME_CSS;
+        doc.documentElement.setAttribute('data-prenta-preview-editing', 'true');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isCanvasEditTipDismissed() {
+    try {
+        return localStorage.getItem(CANVAS_EDIT_TIP_STORAGE_KEY) === '1';
+    }
+    catch {
+        return false;
+    }
+}
+export function dismissCanvasEditTip() {
+    try {
+        localStorage.setItem(CANVAS_EDIT_TIP_STORAGE_KEY, '1');
+    }
+    catch {
+        /* private mode — tip will reappear next session */
+    }
+}
+//# sourceMappingURL=canvas-edit-chrome.js.map

package/dist/lib/canvas-edit-chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-edit-chrome.js","sourceRoot":"","sources":["../../src/lib/canvas-edit-chrome.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,gCAAgC,CAAA;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BhD,CAAC,IAAI,EAAE,CAAA;AAER,MAAM,UAAU,GAAG,yBAAyB,CAAA;AAE5C;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAgC;IACtE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,eAAe,CAAA;QACnC,IAAI,CAAC,GAAG,EAAE,IAAI;YAAE,OAAO,KAAK,CAAA;QAC5B,IAAI,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,CAAmB,SAAS,UAAU,GAAG,CAAC,CAAA;QAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;YAClC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;YACnC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;QACD,KAAK,CAAC,WAAW,GAAG,iCAAiC,CAAA;QACrD,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAA;QACvE,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,2BAA2B,CAAC,KAAK,GAAG,CAAA;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;AACH,CAAC"}

package/dist/lib/media-format.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Presentation helpers for the media block.
+ *
+ * Pure, because these are the parts with real logic — the rest of the block is
+ * layout. Ported from the design prototype so the labels an editor reads match
+ * the ones the design specifies.
+ */
+/** The crop the template renders an image at. Drives the frame's aspect ratio. */
+export type MediaCrop = 'section' | 'social';
+/**
+ * Aspect ratio per crop, as a CSS `aspect-ratio` value.
+ *
+ * The frame shows the crop the TEMPLATE renders, not the asset's own ratio.
+ * Showing the asset's ratio would tell an editor their portrait photo is fine
+ * and then crop its subject out on the page.
+ */
+export declare const CROP_RATIO: Record<MediaCrop, string>;
+/**
+ * Human ratio for an asset's intrinsic dimensions.
+ *
+ * Snaps to a named ratio when within 0.05, else reports the number. The
+ * tolerance matters: a 2400×1600 photo is 1.5 exactly, but a 2401×1600 scan is
+ * 1.5006 and an editor should still read "3:2" rather than "1.50:1".
+ *
+ * Returns null when dimensions are unknown — the library does not always have
+ * them, and inventing "1.00:1" would be worse than saying nothing.
+ */
+export declare function ratioLabel(width?: number, height?: number): string | null;
+/**
+ * Short format badge — the file extension, uppercased.
+ *
+ * Falls back to the MIME subtype so a URL with no extension (a signed CDN link,
+ * an upload route) still shows something meaningful rather than a blank chip.
+ */
+export declare function formatBadge(filenameOrUrl: string, mimeType?: string): string;
+/**
+ * Filename for display, from a filename or a URL.
+ *
+ * Query strings are dropped — a signed URL's token is noise in a 200px-wide
+ * toolbar, and it is never what an editor is trying to read.
+ */
+export declare function displayName(filenameOrUrl: string): string;
+/**
+ * A stable background tint for an asset.
+ *
+ * The design fills the frame with a wash derived from the asset's dominant
+ * colour. The media library stores no such value, so it is derived from the
+ * name instead: the same asset is always the same colour, which is the property
+ * that actually matters for recognising a thumbnail, and it costs no storage
+ * and no extra request.
+ *
+ * Returned as a 135° gradient to the design's `color-mix(tint 45%, #fff)`.
+ */
+export declare function assetWash(seed: string): string;
+//# sourceMappingURL=media-format.d.ts.map

package/dist/lib/media-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-format.d.ts","sourceRoot":"","sources":["../../src/lib/media-format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAGhD,CAAA;AAaD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C"}