@commonpub/schema 0.16.0 → 0.17.0

package/dist/layout.js

@@ -0,0 +1,148 @@
+/**
+ * Layout engine schema — four tables for the page composition system.
+ * Spec: `docs/plans/layout-and-pages.md` §3.3 + §4.
+ *
+ * Layered shape: zone → row → section.
+ *   - A `layouts` row exists per route, virtual key, or custom page.
+ *   - Each layout has rows grouped by zone; each row has sections.
+ *   - On publish, the entire layout is snapshotted into `layout_versions`.
+ *
+ * Why normalised tables (vs JSON-in-settings): reorders + section-level
+ * RLS + per-section-type schema migrations are all cheap. See §4.2.
+ */
+import { pgTable, uuid, varchar, integer, boolean, jsonb, timestamp, index, unique, check } from 'drizzle-orm/pg-core';
+import { sql } from 'drizzle-orm';
+import { relations } from 'drizzle-orm';
+import { users } from './auth.js';
+// --- Tables --------------------------------------------------------------
+/**
+ * One layout per scope. `scope_type + scope_key` is the unique addressing
+ * key — e.g. `('route', '/')` for the homepage, `('custom-page', '/about')`
+ * for a DB-stored page, `('virtual', '__footer')` for the site footer.
+ */
+export const layouts = pgTable('layouts', {
+    id: uuid('id').defaultRandom().primaryKey(),
+    /** 'route' | 'virtual' | 'custom-page' — enforced in Zod, kept flexible at SQL layer */
+    scopeType: varchar('scope_type', { length: 32 }).notNull(),
+    /** Path for route/custom-page, virtual key for virtual */
+    scopeKey: varchar('scope_key', { length: 512 }).notNull(),
+    name: varchar('name', { length: 256 }).notNull(),
+    /** PageMeta — title, description, ogImage, frame, access, etc. Required for custom-page. */
+    pageMeta: jsonb('page_meta'),
+    /** 'draft' | 'published' — drafts are still resolvable for preview, only published serve public traffic */
+    state: varchar('state', { length: 16 }).notNull().default('draft'),
+    /**
+     * Pointer to the version snapshot currently serving traffic. null = no
+     * published version yet.
+     *
+     * **Soft FK by design**: a real FK to `layout_versions(id)` would create
+     * a circular dependency (layouts.published_version_id → layout_versions →
+     * layouts), forcing deferred constraints + chicken-and-egg inserts. The
+     * server CRUD validates this id exists at write time + tolerates a stale
+     * id at read time (treats it as "no published version" and falls back
+     * to the latest version row).
+     */
+    publishedVersionId: uuid('published_version_id'),
+    createdBy: uuid('created_by').references(() => users.id, { onDelete: 'set null' }),
+    updatedBy: uuid('updated_by').references(() => users.id, { onDelete: 'set null' }),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
+}, (t) => [
+    unique('layouts_scope_unique').on(t.scopeType, t.scopeKey),
+    index('idx_layouts_scope').on(t.scopeType, t.scopeKey),
+]);
+/**
+ * A row groups sections horizontally inside a zone. The 12-column grid
+ * (see plan §3.6) divides the row's width; each section's `colSpan`
+ * determines how many of the 12 it occupies. Row-level styling (gap,
+ * align, background, padding) lives in `config`.
+ */
+export const layoutRows = pgTable('layout_rows', {
+    id: uuid('id').defaultRandom().primaryKey(),
+    layoutId: uuid('layout_id')
+        .notNull()
+        .references(() => layouts.id, { onDelete: 'cascade' }),
+    /** Zone slug — must match a `<LayoutSlot zone>` declared by the page */
+    zone: varchar('zone', { length: 64 }).notNull(),
+    /** Order within zone; renumbered to {0..n} on every write */
+    position: integer('position').notNull(),
+    /** Row config — { gap?, align?, background?, paddingY? } */
+    config: jsonb('config'),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
+}, (t) => [
+    unique('layout_rows_position_unique').on(t.layoutId, t.zone, t.position),
+    index('idx_layout_rows_layout').on(t.layoutId, t.zone, t.position),
+]);
+/**
+ * A section lives in exactly one row. `col_span` is the design-time width
+ * (1–12); `responsive` overrides per breakpoint. `schema_version` drives
+ * lazy per-type config migrations on read (see plan §10.6.1).
+ */
+export const layoutSections = pgTable('layout_sections', {
+    id: uuid('id').defaultRandom().primaryKey(),
+    rowId: uuid('row_id')
+        .notNull()
+        .references(() => layoutRows.id, { onDelete: 'cascade' }),
+    /** Position within row, left-to-right; renumbered on write */
+    position: integer('position').notNull(),
+    /** Admin can disable a section without deleting (preserves config) */
+    enabled: boolean('enabled').notNull().default(true),
+    /** Section-type slug — resolves in the SECTION_REGISTRY */
+    type: varchar('type', { length: 128 }).notNull(),
+    /** Per-type config blob — validated against the section's Zod schema before save */
+    config: jsonb('config').notNull().default({}),
+    /** 1–12; check constraint mirrors the Zod invariant for defence-in-depth */
+    colSpan: integer('col_span').notNull().default(12),
+    /** { sm?: 1-12, md?: 1-12, lg?: 1-12 } — falls through lg ↦ md ↦ sm ↦ colSpan */
+    responsive: jsonb('responsive'),
+    /** { roles?, features?, hideAt? } */
+    visibility: jsonb('visibility'),
+    /** Per-section-type config schema version; bumped when the type changes shape */
+    schemaVersion: integer('schema_version').notNull().default(1),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
+}, (t) => [
+    unique('layout_sections_position_unique').on(t.rowId, t.position),
+    index('idx_layout_sections_row').on(t.rowId, t.position),
+    index('idx_layout_sections_type').on(t.type),
+    check('layout_sections_col_span_check', sql `${t.colSpan} between 1 and 12`),
+]);
+/**
+ * Immutable snapshot — published once, never updated. Revert restores the
+ * snapshot's data into the draft, leaving the original version row intact.
+ */
+export const layoutVersions = pgTable('layout_versions', {
+    id: uuid('id').defaultRandom().primaryKey(),
+    layoutId: uuid('layout_id')
+        .notNull()
+        .references(() => layouts.id, { onDelete: 'cascade' }),
+    /** Monotonically increasing version number per layout */
+    version: integer('version').notNull(),
+    /** Full nested Layout object captured at publish time */
+    snapshot: jsonb('snapshot').notNull(),
+    publishedBy: uuid('published_by').references(() => users.id, { onDelete: 'set null' }),
+    publishedAt: timestamp('published_at', { withTimezone: true }).defaultNow().notNull(),
+}, (t) => [
+    unique('layout_versions_version_unique').on(t.layoutId, t.version),
+    index('idx_layout_versions_layout').on(t.layoutId, t.version),
+]);
+// --- Relations -----------------------------------------------------------
+export const layoutsRelations = relations(layouts, ({ many, one }) => ({
+    rows: many(layoutRows),
+    versions: many(layoutVersions),
+    creator: one(users, { fields: [layouts.createdBy], references: [users.id], relationName: 'layoutCreator' }),
+    updater: one(users, { fields: [layouts.updatedBy], references: [users.id], relationName: 'layoutUpdater' }),
+}));
+export const layoutRowsRelations = relations(layoutRows, ({ one, many }) => ({
+    layout: one(layouts, { fields: [layoutRows.layoutId], references: [layouts.id] }),
+    sections: many(layoutSections),
+}));
+export const layoutSectionsRelations = relations(layoutSections, ({ one }) => ({
+    row: one(layoutRows, { fields: [layoutSections.rowId], references: [layoutRows.id] }),
+}));
+export const layoutVersionsRelations = relations(layoutVersions, ({ one }) => ({
+    layout: one(layouts, { fields: [layoutVersions.layoutId], references: [layouts.id] }),
+    publisher: one(users, { fields: [layoutVersions.publishedBy], references: [users.id] }),
+}));
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/validators.d.ts

@@ -925,4 +925,511 @@ export declare const createApiKeySchema: z.ZodObject<{
     allowedOrigins: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type CreateApiKeyInput = z.infer<typeof createApiKeySchema>;
+/** Slug for a custom theme ID — kebab/snake, lowercase, used in data-theme attr. */
+export declare const customThemeIdSchema: z.ZodString;
+/** Token name (without leading `--`). Permissive — we accept any kebab key
+ *  so custom themes can introduce brand tokens (e.g. `deveco-portal-purple`)
+ *  on top of the canonical TOKEN_NAMES list. */
+export declare const themeTokenKeySchema: z.ZodString;
+/** Token value — any CSS value, length-capped to keep the JSON sane. */
+export declare const themeTokenValueSchema: z.ZodString;
+export declare const themeTokenMapSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export type ThemeTokenMap = z.infer<typeof themeTokenMapSchema>;
+export declare const customThemeSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    family: z.ZodString;
+    isDark: z.ZodBoolean;
+    pairId: z.ZodOptional<z.ZodString>;
+    parentTheme: z.ZodDefault<z.ZodString>;
+    tokens: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CustomThemeInput = z.infer<typeof customThemeSchema>;
+/** PUT body — accepts partial updates. */
+export declare const customThemeUpdateSchema: z.ZodObject<{
+    id: z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodString>>>;
+    family: z.ZodOptional<z.ZodString>;
+    isDark: z.ZodOptional<z.ZodBoolean>;
+    pairId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    parentTheme: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    tokens: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    createdAt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    updatedAt: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+/** Exported theme file format. Version bumped when the schema breaks. */
+export declare const themeExportSchema: z.ZodObject<{
+    formatVersion: z.ZodLiteral<1>;
+    exportedAt: z.ZodString;
+    theme: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        family: z.ZodString;
+        isDark: z.ZodBoolean;
+        pairId: z.ZodOptional<z.ZodString>;
+        parentTheme: z.ZodDefault<z.ZodString>;
+        tokens: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ThemeExport = z.infer<typeof themeExportSchema>;
+/** Layout scope — one row per scope key. */
+export declare const layoutScopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"route">;
+    path: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"virtual">;
+    key: z.ZodEnum<{
+        __footer: "__footer";
+        "__not-found": "__not-found";
+        __error: "__error";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"custom-page">;
+    path: z.ZodString;
+}, z.core.$strip>], "type">;
+export type LayoutScope = z.infer<typeof layoutScopeSchema>;
+/** Per-page SEO + access metadata. Required for custom-page scope. */
+export declare const pageMetaSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    ogImage: z.ZodOptional<z.ZodString>;
+    noindex: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    ogType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        article: "article";
+        website: "website";
+        profile: "profile";
+    }>>>;
+    access: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        admin: "admin";
+        public: "public";
+        members: "members";
+    }>>>;
+    frame: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        narrow: "narrow";
+        wide: "wide";
+        "two-column": "two-column";
+        "three-column": "three-column";
+        "sidebar-left": "sidebar-left";
+        "sidebar-right": "sidebar-right";
+    }>>>;
+}, z.core.$strip>;
+export type PageMetaInput = z.infer<typeof pageMetaSchema>;
+/** Per-section conditional visibility. */
+export declare const sectionVisibilitySchema: z.ZodObject<{
+    roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        member: "member";
+        pro: "pro";
+        verified: "verified";
+        staff: "staff";
+        admin: "admin";
+        anonymous: "anonymous";
+    }>>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hideAt: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+    }>>>;
+}, z.core.$strip>;
+export type SectionVisibility = z.infer<typeof sectionVisibilitySchema>;
+/** Responsive colSpan overrides — lg ↦ md ↦ sm ↦ base colSpan. */
+export declare const sectionResponsiveSchema: z.ZodObject<{
+    sm: z.ZodOptional<z.ZodNumber>;
+    md: z.ZodOptional<z.ZodNumber>;
+    lg: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SectionResponsive = z.infer<typeof sectionResponsiveSchema>;
+/** A single section — placed in a row, occupies `colSpan` of 12. */
+export declare const layoutSectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodNumber;
+    type: z.ZodString;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    colSpan: z.ZodDefault<z.ZodNumber>;
+    responsive: z.ZodOptional<z.ZodObject<{
+        sm: z.ZodOptional<z.ZodNumber>;
+        md: z.ZodOptional<z.ZodNumber>;
+        lg: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    visibility: z.ZodOptional<z.ZodObject<{
+        roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            member: "member";
+            pro: "pro";
+            verified: "verified";
+            staff: "staff";
+            admin: "admin";
+            anonymous: "anonymous";
+        }>>>;
+        features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        hideAt: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+        }>>>;
+    }, z.core.$strip>>;
+    schemaVersion: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type LayoutSectionInput = z.infer<typeof layoutSectionSchema>;
+/** Row-level styling (gap, alignment, background, vertical padding). */
+export declare const layoutRowConfigSchema: z.ZodObject<{
+    gap: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+    }>>;
+    align: z.ZodOptional<z.ZodEnum<{
+        start: "start";
+        center: "center";
+        stretch: "stretch";
+    }>>;
+    background: z.ZodOptional<z.ZodString>;
+    paddingY: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+    }>>;
+}, z.core.$strip>;
+export type LayoutRowConfig = z.infer<typeof layoutRowConfigSchema>;
+/** A row groups sections horizontally; sum of colSpans must be ≤ 12. */
+export declare const layoutRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    order: z.ZodNumber;
+    config: z.ZodOptional<z.ZodObject<{
+        gap: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+        }>>;
+        align: z.ZodOptional<z.ZodEnum<{
+            start: "start";
+            center: "center";
+            stretch: "stretch";
+        }>>;
+        background: z.ZodOptional<z.ZodString>;
+        paddingY: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            xl: "xl";
+        }>>;
+    }, z.core.$strip>>;
+    sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        order: z.ZodNumber;
+        type: z.ZodString;
+        config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        colSpan: z.ZodDefault<z.ZodNumber>;
+        responsive: z.ZodOptional<z.ZodObject<{
+            sm: z.ZodOptional<z.ZodNumber>;
+            md: z.ZodOptional<z.ZodNumber>;
+            lg: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        visibility: z.ZodOptional<z.ZodObject<{
+            roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                member: "member";
+                pro: "pro";
+                verified: "verified";
+                staff: "staff";
+                admin: "admin";
+                anonymous: "anonymous";
+            }>>>;
+            features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            hideAt: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+            }>>>;
+        }, z.core.$strip>>;
+        schemaVersion: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LayoutRowInput = z.infer<typeof layoutRowSchema>;
+/** A zone holds an ordered list of rows. */
+export declare const layoutZoneSchema: z.ZodObject<{
+    zone: z.ZodString;
+    rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        order: z.ZodNumber;
+        config: z.ZodOptional<z.ZodObject<{
+            gap: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+            }>>;
+            align: z.ZodOptional<z.ZodEnum<{
+                start: "start";
+                center: "center";
+                stretch: "stretch";
+            }>>;
+            background: z.ZodOptional<z.ZodString>;
+            paddingY: z.ZodOptional<z.ZodEnum<{
+                none: "none";
+                sm: "sm";
+                md: "md";
+                lg: "lg";
+                xl: "xl";
+            }>>;
+        }, z.core.$strip>>;
+        sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            order: z.ZodNumber;
+            type: z.ZodString;
+            config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            colSpan: z.ZodDefault<z.ZodNumber>;
+            responsive: z.ZodOptional<z.ZodObject<{
+                sm: z.ZodOptional<z.ZodNumber>;
+                md: z.ZodOptional<z.ZodNumber>;
+                lg: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            visibility: z.ZodOptional<z.ZodObject<{
+                roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    member: "member";
+                    pro: "pro";
+                    verified: "verified";
+                    staff: "staff";
+                    admin: "admin";
+                    anonymous: "anonymous";
+                }>>>;
+                features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                hideAt: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                }>>>;
+            }, z.core.$strip>>;
+            schemaVersion: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LayoutZoneInput = z.infer<typeof layoutZoneSchema>;
+/** The full layout payload (read-side — includes server fields). */
+export declare const layoutSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"route">;
+        path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"virtual">;
+        key: z.ZodEnum<{
+            __footer: "__footer";
+            "__not-found": "__not-found";
+            __error: "__error";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"custom-page">;
+        path: z.ZodString;
+    }, z.core.$strip>], "type">;
+    name: z.ZodString;
+    pageMeta: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        ogImage: z.ZodOptional<z.ZodString>;
+        noindex: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        ogType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            article: "article";
+            website: "website";
+            profile: "profile";
+        }>>>;
+        access: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            admin: "admin";
+            public: "public";
+            members: "members";
+        }>>>;
+        frame: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            narrow: "narrow";
+            wide: "wide";
+            "two-column": "two-column";
+            "three-column": "three-column";
+            "sidebar-left": "sidebar-left";
+            "sidebar-right": "sidebar-right";
+        }>>>;
+    }, z.core.$strip>>;
+    zones: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        zone: z.ZodString;
+        rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            order: z.ZodNumber;
+            config: z.ZodOptional<z.ZodObject<{
+                gap: z.ZodOptional<z.ZodEnum<{
+                    none: "none";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                }>>;
+                align: z.ZodOptional<z.ZodEnum<{
+                    start: "start";
+                    center: "center";
+                    stretch: "stretch";
+                }>>;
+                background: z.ZodOptional<z.ZodString>;
+                paddingY: z.ZodOptional<z.ZodEnum<{
+                    none: "none";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                    xl: "xl";
+                }>>;
+            }, z.core.$strip>>;
+            sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                order: z.ZodNumber;
+                type: z.ZodString;
+                config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                colSpan: z.ZodDefault<z.ZodNumber>;
+                responsive: z.ZodOptional<z.ZodObject<{
+                    sm: z.ZodOptional<z.ZodNumber>;
+                    md: z.ZodOptional<z.ZodNumber>;
+                    lg: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                visibility: z.ZodOptional<z.ZodObject<{
+                    roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        member: "member";
+                        pro: "pro";
+                        verified: "verified";
+                        staff: "staff";
+                        admin: "admin";
+                        anonymous: "anonymous";
+                    }>>>;
+                    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    hideAt: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        sm: "sm";
+                        md: "md";
+                        lg: "lg";
+                    }>>>;
+                }, z.core.$strip>>;
+                schemaVersion: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    state: z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>;
+    publishedVersionId: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LayoutInput = z.infer<typeof layoutSchema>;
+/** Body shape for POST/PUT — server generates UUIDs + renumbers positions + sets timestamps. */
+export declare const layoutCreateSchema: z.ZodObject<{
+    name: z.ZodString;
+    pageMeta: z.ZodOptional<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        ogImage: z.ZodOptional<z.ZodString>;
+        noindex: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        ogType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            article: "article";
+            website: "website";
+            profile: "profile";
+        }>>>;
+        access: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            admin: "admin";
+            public: "public";
+            members: "members";
+        }>>>;
+        frame: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            narrow: "narrow";
+            wide: "wide";
+            "two-column": "two-column";
+            "three-column": "three-column";
+            "sidebar-left": "sidebar-left";
+            "sidebar-right": "sidebar-right";
+        }>>>;
+    }, z.core.$strip>>;
+    state: z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>>;
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"route">;
+        path: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"virtual">;
+        key: z.ZodEnum<{
+            __footer: "__footer";
+            "__not-found": "__not-found";
+            __error: "__error";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"custom-page">;
+        path: z.ZodString;
+    }, z.core.$strip>], "type">;
+    zones: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        zone: z.ZodString;
+        rows: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            order: z.ZodNumber;
+            config: z.ZodOptional<z.ZodObject<{
+                gap: z.ZodOptional<z.ZodEnum<{
+                    none: "none";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                }>>;
+                align: z.ZodOptional<z.ZodEnum<{
+                    start: "start";
+                    center: "center";
+                    stretch: "stretch";
+                }>>;
+                background: z.ZodOptional<z.ZodString>;
+                paddingY: z.ZodOptional<z.ZodEnum<{
+                    none: "none";
+                    sm: "sm";
+                    md: "md";
+                    lg: "lg";
+                    xl: "xl";
+                }>>;
+            }, z.core.$strip>>;
+            sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                order: z.ZodNumber;
+                type: z.ZodString;
+                config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                colSpan: z.ZodDefault<z.ZodNumber>;
+                responsive: z.ZodOptional<z.ZodObject<{
+                    sm: z.ZodOptional<z.ZodNumber>;
+                    md: z.ZodOptional<z.ZodNumber>;
+                    lg: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                visibility: z.ZodOptional<z.ZodObject<{
+                    roles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        member: "member";
+                        pro: "pro";
+                        verified: "verified";
+                        staff: "staff";
+                        admin: "admin";
+                        anonymous: "anonymous";
+                    }>>>;
+                    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    hideAt: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                        sm: "sm";
+                        md: "md";
+                        lg: "lg";
+                    }>>>;
+                }, z.core.$strip>>;
+                schemaVersion: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type LayoutCreateInput = z.infer<typeof layoutCreateSchema>;
 //# sourceMappingURL=validators.d.ts.map