@beechcms/core 0.8.0 → 0.9.0

package/dist/dashboard-layout/seed-layout.d.ts

@@ -33,36 +33,6 @@ export declare const kanbanCardConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type KanbanCardConfig = z.infer<typeof kanbanCardConfigSchema>;
-export declare const seedViewConfigSchema: z.ZodObject<{
-    kanban: z.ZodOptional<z.ZodObject<{
-        axisBranchId: z.ZodNullable<z.ZodString>;
-        sort: z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-            dir: z.ZodEnum<{
-                ASC: "ASC";
-                DESC: "DESC";
-            }>;
-        }, z.core.$strip>>;
-        hiddenColumnValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        collapsedColumnValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    card: z.ZodOptional<z.ZodObject<{
-        version: z.ZodLiteral<1>;
-        media: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-        header: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-        subtitle: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-        metadata: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-}, z.core.$loose>;
-export type SeedViewConfig = z.infer<typeof seedViewConfigSchema>;
 /** Reference to a Seed branch by its stable id (e.g. 'br_03').
  *  Aliases can be renamed — ids cannot. When the id does not match any
  *  branch on the Seed at read time, the field is silently stripped (auto-cleanup). */
@@ -108,6 +78,12 @@ export declare function isFullWidthBranch(branch: Branch): boolean;
 export declare function isSeoBranch(branch: Branch): boolean;
 export declare const METADATA_SLOT_CAP = 6;
 export declare function isCardEligibleBranch(branch: Branch): boolean;
+/** Gallery cover: a single-file branch that accepts images (a multi-file/asset-list branch has no single cover). */
+export declare function isImageMediaBranch(branch: Branch): boolean;
+export interface ValidateCardConfigOptions {
+    /** Gallery cards only render an image cover: a non-image `media` slot is dropped. */
+    mediaImageOnly?: boolean;
+}
 export type ValidateCardConfigResult = {
     ok: true;
     cleaned: KanbanCardConfig;
@@ -116,7 +92,9 @@ export type ValidateCardConfigResult = {
     errors: string[];
     cleaned: KanbanCardConfig;
 };
-export declare function validateCardConfigAgainstSeed(config: KanbanCardConfig, seed: Seed): ValidateCardConfigResult;
+export declare function validateCardConfigAgainstSeed(config: KanbanCardConfig, seed: Seed, options?: ValidateCardConfigOptions): ValidateCardConfigResult;
+/** Max serialized size of a form layout. Keeps the `seed_layouts` row far below D1's per-row limit. */
+export declare const MAX_LAYOUT_BYTES: number;
 export declare const layoutFieldSchema: z.ZodObject<{
     branchId: z.ZodString;
 }, z.core.$strip>;
@@ -176,6 +154,12 @@ export declare const formLayoutSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * Builds the default editor layout for a Seed with no custom `layout`: full-width branches
+ * (richtext, json, galleries) each get their own dedicated section, the remaining branches are
+ * packed three per section in seed order, and a single main non-gallery image file branch
+ * (`fileOptions.accept === 'image'`) leads the Data tab alone in its own full-width section.
+ */
 export declare function generateDefaultLayout(seed: Seed, opts?: {
     newId: () => string;
 }): FormLayout;
@@ -188,4 +172,11 @@ export type ValidateLayoutResult = {
     cleaned: FormLayout;
 };
 export declare function validateLayoutAgainstSeed(layout: FormLayout, seed: Seed): ValidateLayoutResult;
+/**
+ * Makes a stored layout safe to serve after the Seed changed. A layout that breaks the
+ * full-width rules falls back to the generated default; otherwise layoutable branches the
+ * layout never placed (added to the Seed later) are appended as trailing sections of the
+ * first tab, so the editor can always render and fill them.
+ */
+export declare function reconcileLayoutWithSeed(layout: FormLayout, seed: Seed): FormLayout;
 //# sourceMappingURL=seed-layout.d.ts.map

package/dist/dashboard-layout/seed-layout.d.ts.map

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

package/dist/dashboard-layout/seed-layout.js

@@ -1,9 +1,9 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2024–2026 Flavio De Musso
 import { z } from 'zod';
-import { findBranchById } from '../engine/seed-registry.js';
+import { findBranchById } from '../engine/seeds/seed-registry.js';
 // ---------------------------------------------------------------------------
-// View config — per-seed, per-view dashboard preferences (KB-S02)
+// Kanban view config — embedded in ContentViewConfig.kanban (seed_views)
 // ---------------------------------------------------------------------------
 export const kanbanViewConfigSchema = z.object({
     axisBranchId: z.string().nullable(),
@@ -12,7 +12,7 @@ export const kanbanViewConfigSchema = z.object({
     collapsedColumnValues: z.array(z.string()).optional(),
 });
 // ---------------------------------------------------------------------------
-// Kanban card layout (view_config.card)
+// Kanban card layout — embedded in ContentViewConfig.card (seed_views)
 // ---------------------------------------------------------------------------
 export const cardSlotFieldSchema = z.object({
     branchId: z.string().regex(/^br_[A-Za-z0-9]+$/),
@@ -28,10 +28,6 @@ export const kanbanCardConfigSchema = z.object({
     /** 2-column grid. Hard cap enforced by validator (see METADATA_SLOT_CAP). */
     metadata: z.array(cardSlotFieldSchema).max(6).default([]),
 });
-export const seedViewConfigSchema = z.object({
-    kanban: kanbanViewConfigSchema.optional(),
-    card: kanbanCardConfigSchema.optional(),
-}).passthrough();
 // ---------------------------------------------------------------------------
 // Branch-type rules used by both the default generator and the validator.
 // ---------------------------------------------------------------------------
@@ -42,6 +38,12 @@ export function isGalleryBranch(branch) {
     return branch.type === 'file'
         && (branch.multiple === true || branch.format === 'asset-list');
 }
+/** True for a single-file image branch: the candidate cover of the default editor layout. */
+function isCoverImageBranch(branch) {
+    return branch.type === 'file'
+        && !isGalleryBranch(branch)
+        && branch.fileOptions?.accept === 'image';
+}
 /** Branch types currently unsupported in the Layout Builder. */
 export const UNSUPPORTED_BRANCH_TYPES = new Set([]);
 /** Aliases that are NEVER included in the editor form (handled by other UI). */
@@ -80,7 +82,14 @@ export function isCardEligibleBranch(branch) {
         return false;
     return true;
 }
-export function validateCardConfigAgainstSeed(config, seed) {
+/** Gallery cover: a single-file branch that accepts images (a multi-file/asset-list branch has no single cover). */
+export function isImageMediaBranch(branch) {
+    return isCardEligibleBranch(branch)
+        && branch.type === 'file'
+        && !isGalleryBranch(branch)
+        && branch.fileOptions?.accept === 'image';
+}
+export function validateCardConfigAgainstSeed(config, seed, options = {}) {
     const errors = [];
     const seen = new Set();
     const keepSingle = (f) => {
@@ -96,7 +105,9 @@ export function validateCardConfigAgainstSeed(config, seed) {
         seen.add(f.branchId);
         return { branchId: f.branchId };
     };
-    const media = keepSingle(config.media);
+    const mediaBranch = config.media ? findBranchById(seed, config.media.branchId) : null;
+    const mediaAllowed = !options.mediaImageOnly || (mediaBranch !== null && isImageMediaBranch(mediaBranch));
+    const media = mediaAllowed ? keepSingle(config.media) : null;
     const header = keepSingle(config.header);
     const subtitle = keepSingle(config.subtitle);
     const metadata = [];
@@ -121,27 +132,37 @@ export function validateCardConfigAgainstSeed(config, seed) {
 // ---------------------------------------------------------------------------
 // Zod schema for shape validation
 // ---------------------------------------------------------------------------
+/** Max serialized size of a form layout. Keeps the `seed_layouts` row far below D1's per-row limit. */
+export const MAX_LAYOUT_BYTES = 256 * 1024;
+const LAYOUT_ID_MAX = 64;
+const LAYOUT_LABEL_MAX = 120;
+const MAX_SECTIONS_PER_TAB = 50;
+const MAX_FIELDS_PER_COLUMN = 100;
 export const layoutFieldSchema = z.object({ branchId: z.string().regex(/^br_[A-Za-z0-9]+$/) });
 export const layoutColumnSchema = z.object({
-    id: z.string().min(1),
-    fields: z.array(layoutFieldSchema),
+    id: z.string().min(1).max(LAYOUT_ID_MAX),
+    fields: z.array(layoutFieldSchema).max(MAX_FIELDS_PER_COLUMN),
 });
 export const layoutSectionSchema = z.object({
-    id: z.string().min(1),
-    label: z.string().optional(),
+    id: z.string().min(1).max(LAYOUT_ID_MAX),
+    label: z.string().max(LAYOUT_LABEL_MAX).optional(),
     hideLabel: z.boolean().optional(),
     hideBorder: z.boolean().optional(),
     collapsible: z.boolean().optional(),
     columns: z.array(layoutColumnSchema).min(1).max(4),
 });
 export const layoutTabSchema = z.object({
-    id: z.string().min(1),
+    id: z.string().min(1).max(LAYOUT_ID_MAX),
     label: z.string().min(1).max(60),
-    sections: z.array(layoutSectionSchema).min(1),
+    sections: z.array(layoutSectionSchema).min(1).max(MAX_SECTIONS_PER_TAB),
 });
-export const formLayoutSchema = z.object({
+export const formLayoutSchema = z
+    .object({
     version: z.literal(1),
     tabs: z.array(layoutTabSchema).min(1).max(8),
+})
+    .refine((layout) => new TextEncoder().encode(JSON.stringify(layout)).length <= MAX_LAYOUT_BYTES, {
+    message: `Layout exceeds the ${MAX_LAYOUT_BYTES / 1024} KB size limit.`,
 });
 // ---------------------------------------------------------------------------
 // Default layout generator
@@ -180,15 +201,40 @@ function buildSectionsForBranches(branches, newId) {
     }
     return sections;
 }
+/**
+ * Builds the default editor layout for a Seed with no custom `layout`: full-width branches
+ * (richtext, json, galleries) each get their own dedicated section, the remaining branches are
+ * packed three per section in seed order, and a single main non-gallery image file branch
+ * (`fileOptions.accept === 'image'`) leads the Data tab alone in its own full-width section.
+ */
 export function generateDefaultLayout(seed, opts) {
     const newId = opts?.newId ?? defaultIdFactory;
     const layoutable = seed.branches.filter(isLayoutableBranch);
     const seo = layoutable.filter(isSeoBranch);
     const main = layoutable.filter((b) => !isSeoBranch(b));
+    const coverCandidates = main.filter(isCoverImageBranch);
+    const cover = coverCandidates.length === 1 ? coverCandidates[0] : null;
+    const dataTabId = newId();
+    let dataSections;
+    if (cover) {
+        const coverSection = {
+            id: newId(),
+            label: cover.label,
+            hideLabel: true,
+            columns: [{ id: newId(), fields: [{ branchId: cover.id }] }],
+        };
+        const rest = main.filter((b) => b.id !== cover.id);
+        dataSections = rest.length === 0
+            ? [coverSection]
+            : [coverSection, ...buildSectionsForBranches(rest, newId)];
+    }
+    else {
+        dataSections = buildSectionsForBranches(main, newId);
+    }
     const dataTab = {
-        id: newId(),
+        id: dataTabId,
         label: 'Data',
-        sections: buildSectionsForBranches(main, newId),
+        sections: dataSections,
     };
     const seoTab = {
         id: newId(),
@@ -267,3 +313,32 @@ export function validateLayoutAgainstSeed(layout, seed) {
         return { ok: false, errors, cleaned };
     return { ok: true, cleaned };
 }
+/**
+ * Makes a stored layout safe to serve after the Seed changed. A layout that breaks the
+ * full-width rules falls back to the generated default; otherwise layoutable branches the
+ * layout never placed (added to the Seed later) are appended as trailing sections of the
+ * first tab, so the editor can always render and fill them.
+ */
+export function reconcileLayoutWithSeed(layout, seed) {
+    const result = validateLayoutAgainstSeed(layout, seed);
+    if (!result.ok)
+        return generateDefaultLayout(seed);
+    const placed = new Set();
+    for (const tab of result.cleaned.tabs) {
+        for (const section of tab.sections) {
+            for (const column of section.columns) {
+                for (const field of column.fields)
+                    placed.add(field.branchId);
+            }
+        }
+    }
+    const unplaced = seed.branches.filter((b) => isLayoutableBranch(b) && !placed.has(b.id));
+    if (unplaced.length === 0)
+        return result.cleaned;
+    const [firstTab, ...otherTabs] = result.cleaned.tabs;
+    const extended = {
+        ...firstTab,
+        sections: [...firstTab.sections, ...buildSectionsForBranches(unplaced, defaultIdFactory)],
+    };
+    return { ...result.cleaned, tabs: [extended, ...otherTabs] };
+}

package/dist/dashboard-layout/seed-layout.repository.d.ts

@@ -1,4 +1,4 @@
-import type { FormLayout, SeedViewConfig } from './seed-layout.js';
+import type { FormLayout } from './seed-layout.js';
 export interface SeedLayoutRecord {
     slug: string;
     layout: FormLayout;
@@ -14,9 +14,5 @@ export interface ISeedLayoutRepository {
     upsert(slug: string, layout: FormLayout, updatedBy: string): Promise<void>;
     /** Remove the stored row — used by the "Reset" action. */
     remove(slug: string): Promise<void>;
-    /** Return the per-view config blob for a seed, or null if none was stored. */
-    getViewConfig(slug: string): Promise<SeedViewConfig | null>;
-    /** Upsert the per-view config for a seed. */
-    setViewConfig(slug: string, config: SeedViewConfig, updatedBy: string): Promise<void>;
 }
 //# sourceMappingURL=seed-layout.repository.d.ts.map

package/dist/dashboard-layout/seed-layout.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed-layout.repository.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/seed-layout.repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAElE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACnD,oFAAoF;IACpF,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IAC/C,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,8EAA8E;IAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC3D,6CAA6C;IAC7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtF"}
+{"version":3,"file":"seed-layout.repository.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/seed-layout.repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACnD,oFAAoF;IACpF,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IAC/C,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC"}

package/dist/dashboard-layout.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import type { Seed } from './types.js';
+/** A placed widget. `type` is namespaced ('core/stat', '@acme/weather').
+ *  `config` is opaque to core/API except for the optional `seedSlug` key,
+ *  which enables auto-cleanup when the referenced seed disappears. */
+export interface DashboardWidgetInstance {
+    id: string;
+    type: string;
+    title?: string;
+    config: Record<string, unknown>;
+}
+export interface DashboardColumn {
+    id: string;
+    widgets: DashboardWidgetInstance[];
+}
+export interface DashboardSection {
+    id: string;
+    label?: string;
+    hideLabel?: boolean;
+    collapsible?: boolean;
+    /** 1–4 columns. Enforced by validator. */
+    columns: DashboardColumn[];
+    /** Optional spans on a 12-unit grid, parallel to `columns`, must sum to 12.
+     *  Absent = equal split. */
+    columnSpans?: number[];
+}
+export interface DashboardPageLayout {
+    id: string;
+    /** URL identity (?page=<slug>). Unique within the layout. */
+    slug: string;
+    label: string;
+    /** Lucide icon name, same convention as DashboardSeedConfig.icon. */
+    icon?: string;
+    sections: DashboardSection[];
+}
+export interface DashboardLayout {
+    /** Format version — bump when introducing breaking changes. */
+    version: 1;
+    pages: DashboardPageLayout[];
+}
+/** Namespaced widget type — lowercase npm-name-compatible.
+ *  Built-ins use the 'core/' prefix; custom widgets '@scope/name'. */
+export declare const WIDGET_TYPE_REGEX: RegExp;
+/** Max serialized size of a single widget `config`
+ *  (`JSON.stringify(widget.config).length`) — guards D1 row bloat. */
+export declare const MAX_WIDGET_CONFIG_BYTES = 8192;
+export declare const dashboardWidgetInstanceSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const dashboardColumnSchema: z.ZodObject<{
+    id: z.ZodString;
+    widgets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const dashboardSectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    hideLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    columns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        widgets: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    columnSpans: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const dashboardPageSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        hideLabel: z.ZodOptional<z.ZodBoolean>;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        columns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            widgets: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        columnSpans: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const dashboardLayoutSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    pages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        sections: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            hideLabel: z.ZodOptional<z.ZodBoolean>;
+            collapsible: z.ZodOptional<z.ZodBoolean>;
+            columns: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                widgets: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    type: z.ZodString;
+                    title: z.ZodOptional<z.ZodString>;
+                    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            columnSpans: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Structural port of the legacy hardcoded dashboard config into a single
+ *  'Overview' page. Widgets fetch their own data: configs carry only the
+ *  variant and (where relevant) the default seed binding. */
+export declare function generateDefaultDashboardLayout(seeds: Seed[], opts?: {
+    newId: () => string;
+}): DashboardLayout;
+export interface DashboardLayoutContext {
+    /** Slugs of currently registered seeds (from ISeedRegistry.all()). */
+    seedSlugs: ReadonlySet<string>;
+    /** Optional: widget types known to the caller (frontend registry).
+     *  When provided, unknown types produce WARNINGS, never strips. */
+    knownWidgetTypes?: ReadonlySet<string>;
+}
+export type ValidateDashboardLayoutResult = {
+    ok: true;
+    cleaned: DashboardLayout;
+    warnings: string[];
+} | {
+    ok: false;
+    errors: string[];
+    cleaned: DashboardLayout;
+    warnings: string[];
+};
+/** Semantic validation on top of the Zod shape check (the caller's job).
+ *  Widgets bound to a seed that no longer exists are silently stripped
+ *  (auto-cleanup, recorded as a warning). Unknown widget types only warn —
+ *  custom widgets are invisible to the Worker and must never be stripped.
+ *  `cleaned` is always returned, errors or not. */
+export declare function validateDashboardLayout(layout: DashboardLayout, ctx: DashboardLayoutContext): ValidateDashboardLayoutResult;
+//# sourceMappingURL=dashboard-layout.d.ts.map

package/dist/dashboard-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-layout.d.ts","sourceRoot":"","sources":["../src/dashboard-layout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAMtC;;sEAEsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,uBAAuB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B;gCAC4B;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAA;IACV,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAMD;sEACsE;AACtE,eAAO,MAAM,iBAAiB,QAA6B,CAAA;AAE3D;sEACsE;AACtE,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAM3C,eAAO,MAAM,6BAA6B;;;;;iBAKxC,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;iBAGhC,CAAA;AACF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAOjC,CAAA;AACF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAA;AAQF;;6DAE6D;AAC7D,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,GAC7B,eAAe,CA2EjB;AAMD,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9B;uEACmE;IACnE,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEjF;;;;mDAImD;AACnD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,sBAAsB,GAC1B,6BAA6B,CA2E/B"}

package/dist/dashboard-layout.js

@@ -0,0 +1,186 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Shared rules used by both the Zod schemas and the semantic validator.
+// ---------------------------------------------------------------------------
+/** Namespaced widget type — lowercase npm-name-compatible.
+ *  Built-ins use the 'core/' prefix; custom widgets '@scope/name'. */
+export const WIDGET_TYPE_REGEX = /^[a-z0-9@][a-z0-9@/_-]*$/;
+/** Max serialized size of a single widget `config`
+ *  (`JSON.stringify(widget.config).length`) — guards D1 row bloat. */
+export const MAX_WIDGET_CONFIG_BYTES = 8192;
+// ---------------------------------------------------------------------------
+// Zod schemas for shape validation
+// ---------------------------------------------------------------------------
+export const dashboardWidgetInstanceSchema = z.object({
+    id: z.string().min(1),
+    type: z.string().regex(WIDGET_TYPE_REGEX),
+    title: z.string().max(80).optional(),
+    config: z.record(z.string(), z.unknown()),
+});
+export const dashboardColumnSchema = z.object({
+    id: z.string().min(1),
+    widgets: z.array(dashboardWidgetInstanceSchema),
+});
+export const dashboardSectionSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().max(60).optional(),
+    hideLabel: z.boolean().optional(),
+    collapsible: z.boolean().optional(),
+    columns: z.array(dashboardColumnSchema).min(1).max(4),
+    columnSpans: z.array(z.number().int().min(1).max(12)).optional(),
+});
+export const dashboardPageSchema = z.object({
+    id: z.string().min(1),
+    slug: z.string().regex(/^[a-z0-9][a-z0-9-]*$/).max(40),
+    label: z.string().min(1).max(60),
+    icon: z.string().max(40).optional(),
+    sections: z.array(dashboardSectionSchema).min(1),
+});
+export const dashboardLayoutSchema = z.object({
+    version: z.literal(1),
+    pages: z.array(dashboardPageSchema).min(1).max(8),
+});
+// ---------------------------------------------------------------------------
+// Default dashboard layout generator
+// ---------------------------------------------------------------------------
+const defaultIdFactory = () => crypto.randomUUID();
+/** Structural port of the legacy hardcoded dashboard config into a single
+ *  'Overview' page. Widgets fetch their own data: configs carry only the
+ *  variant and (where relevant) the default seed binding. */
+export function generateDefaultDashboardLayout(seeds, opts) {
+    const newId = opts?.newId ?? defaultIdFactory;
+    const widget = (type, config) => ({ id: newId(), type, config });
+    const singleWidgetColumn = (w) => ({
+        id: newId(),
+        widgets: [w],
+    });
+    const sections = [];
+    // Setup checklist, full width.
+    sections.push({
+        id: newId(),
+        hideLabel: true,
+        columns: [singleWidgetColumn(widget('core/setup-checklist', { variant: 'full' }))],
+    });
+    // Status row: equal columns; quick-draft needs at least one seed to target.
+    const statusWidgets = [
+        widget('core/site-status', { variant: 'badge' }),
+        widget('core/storage', { variant: 'gauge' }),
+        widget('core/publication-stats', { variant: 'trio' }),
+    ];
+    if (seeds.length > 0) {
+        statusWidgets.push(widget('core/quick-draft', { variant: 'minimal' }));
+    }
+    sections.push({
+        id: newId(),
+        hideLabel: true,
+        columns: statusWidgets.map(singleWidgetColumn),
+    });
+    if (seeds.length > 0) {
+        const seedSlug = seeds.find((s) => s.slug === 'articoli')?.slug ?? seeds[0].slug;
+        // Content row: recent content | pending drafts.
+        sections.push({
+            id: newId(),
+            hideLabel: true,
+            columns: [
+                singleWidgetColumn(widget('core/recent-content', { seedSlug, variant: 'list' })),
+                singleWidgetColumn(widget('core/pending-drafts', { seedSlug, variant: 'list' })),
+            ],
+            columnSpans: [6, 6],
+        });
+        // Media & activity row: media gallery | activity feed.
+        sections.push({
+            id: newId(),
+            hideLabel: true,
+            columns: [
+                singleWidgetColumn(widget('core/media-gallery', { seedSlug, variant: 'grid' })),
+                singleWidgetColumn(widget('core/activity-feed', { seedSlug, variant: 'feed' })),
+            ],
+            columnSpans: [6, 6],
+        });
+    }
+    return {
+        version: 1,
+        pages: [
+            {
+                id: newId(),
+                slug: 'overview',
+                label: 'Overview',
+                icon: 'LayoutDashboard',
+                sections,
+            },
+        ],
+    };
+}
+/** Semantic validation on top of the Zod shape check (the caller's job).
+ *  Widgets bound to a seed that no longer exists are silently stripped
+ *  (auto-cleanup, recorded as a warning). Unknown widget types only warn —
+ *  custom widgets are invisible to the Worker and must never be stripped.
+ *  `cleaned` is always returned, errors or not. */
+export function validateDashboardLayout(layout, ctx) {
+    const errors = [];
+    const warnings = [];
+    // Auto-cleanup: drop widgets whose config.seedSlug references a missing seed.
+    const cleanedPages = layout.pages.map((page) => ({
+        ...page,
+        sections: page.sections.map((section) => ({
+            ...section,
+            columns: section.columns.map((col) => ({
+                ...col,
+                widgets: (col.widgets ?? []).filter((w) => {
+                    const seedSlug = (w.config ?? {})['seedSlug'];
+                    if (typeof seedSlug === 'string' && !ctx.seedSlugs.has(seedSlug)) {
+                        warnings.push(`Widget '${w.type}' (id=${w.id}) removed: seed '${seedSlug}' is not registered.`);
+                        return false;
+                    }
+                    return true;
+                }),
+            })),
+        })),
+    }));
+    // Semantic checks on the cleaned layout
+    const seenWidgetIds = new Set();
+    const seenPageSlugs = new Set();
+    for (const page of cleanedPages) {
+        if (seenPageSlugs.has(page.slug)) {
+            errors.push(`Page slug '${page.slug}' appears more than once in the layout.`);
+        }
+        else {
+            seenPageSlugs.add(page.slug);
+        }
+        for (const section of page.sections) {
+            if (section.columnSpans !== undefined) {
+                if (section.columnSpans.length !== section.columns.length) {
+                    errors.push(`Section ${section.id}: columnSpans has ${section.columnSpans.length} entries for ${section.columns.length} columns.`);
+                }
+                else {
+                    const sum = section.columnSpans.reduce((acc, span) => acc + span, 0);
+                    if (sum !== 12) {
+                        errors.push(`Section ${section.id}: columnSpans must sum to 12, got ${sum}.`);
+                    }
+                }
+            }
+            for (const col of section.columns) {
+                for (const w of col.widgets) {
+                    if (seenWidgetIds.has(w.id)) {
+                        errors.push(`Widget id '${w.id}' appears more than once in the layout.`);
+                    }
+                    else {
+                        seenWidgetIds.add(w.id);
+                    }
+                    if (JSON.stringify(w.config ?? {}).length > MAX_WIDGET_CONFIG_BYTES) {
+                        errors.push(`Widget '${w.type}' (id=${w.id}): config exceeds ${MAX_WIDGET_CONFIG_BYTES} bytes when serialized.`);
+                    }
+                    if (ctx.knownWidgetTypes !== undefined && !ctx.knownWidgetTypes.has(w.type)) {
+                        warnings.push(`Widget '${w.type}' (id=${w.id}) is not a known widget type.`);
+                    }
+                }
+            }
+        }
+    }
+    const cleaned = { ...layout, pages: cleanedPages };
+    if (errors.length > 0)
+        return { ok: false, errors, cleaned, warnings };
+    return { ok: true, cleaned, warnings };
+}