@avocadostudio-ai/shared 0.1.0

package/dist/schemas.d.ts

@@ -0,0 +1,321 @@
+import { z } from "zod";
+import { type BlockInstance } from "./blocks/_registry.ts";
+export declare const siteConfigSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodString>;
+    purpose: z.ZodOptional<z.ZodString>;
+    tone: z.ZodOptional<z.ZodString>;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    navLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    navGroups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    themeOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type SiteConfig = z.infer<typeof siteConfigSchema>;
+export type PageMeta = {
+    title?: string;
+    description?: string;
+    ogImage?: string;
+};
+export type PageDoc = {
+    id: string;
+    slug: string;
+    title: string;
+    updatedAt: string;
+    blocks: BlockInstance[];
+    meta?: PageMeta;
+};
+export declare const pageMetaSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    ogImage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Lenient — accepts any block type (for ingesting content from sites with custom blocks). */
+export declare const pageDocSchemaLenient: z.ZodType<PageDoc>;
+/** Strict — rejects block types not in the shared registry. */
+export declare const pageDocSchema: z.ZodType<PageDoc>;
+export declare const operationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"create_page">;
+    page: z.ZodType<PageDoc, unknown, z.core.$ZodTypeInternals<PageDoc, unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"add_block">;
+    pageSlug: z.ZodString;
+    afterBlockId: z.ZodOptional<z.ZodString>;
+    block: z.ZodObject<{
+        id: z.ZodString;
+        props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        type: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"update_props">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"remove_block">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"move_block">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    afterBlockId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"duplicate_block">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    toPageSlug: z.ZodOptional<z.ZodString>;
+    newBlockId: z.ZodOptional<z.ZodString>;
+    afterBlockId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"add_item">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    listKey: z.ZodString;
+    item: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    afterItemId: z.ZodOptional<z.ZodString>;
+    afterIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"update_item">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    listKey: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+    patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"remove_item">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    listKey: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"move_item">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    listKey: z.ZodString;
+    itemId: z.ZodOptional<z.ZodString>;
+    index: z.ZodOptional<z.ZodNumber>;
+    afterItemId: z.ZodOptional<z.ZodString>;
+    afterIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"reorder_items">;
+    pageSlug: z.ZodString;
+    blockId: z.ZodString;
+    listKey: z.ZodString;
+    order: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"reorder_blocks">;
+    pageSlug: z.ZodString;
+    order: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"rename_page">;
+    pageSlug: z.ZodString;
+    newPageSlug: z.ZodOptional<z.ZodString>;
+    newTitle: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"remove_page">;
+    pageSlug: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"move_page">;
+    pageSlug: z.ZodString;
+    afterPageSlug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"duplicate_page">;
+    pageSlug: z.ZodString;
+    newPageSlug: z.ZodOptional<z.ZodString>;
+    newTitle: z.ZodOptional<z.ZodString>;
+    afterPageSlug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"update_page_meta">;
+    pageSlug: z.ZodString;
+    patch: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        ogImage: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"update_site_config">;
+    patch: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        logo: z.ZodOptional<z.ZodString>;
+        navLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        navGroups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    op: z.ZodLiteral<"update_theme">;
+    patch: z.ZodObject<{
+        brandColor: z.ZodOptional<z.ZodString>;
+        accentColor: z.ZodOptional<z.ZodString>;
+        backgroundColor: z.ZodOptional<z.ZodString>;
+        surfaceColor: z.ZodOptional<z.ZodString>;
+        headingColor: z.ZodOptional<z.ZodString>;
+        textColor: z.ZodOptional<z.ZodString>;
+        mutedTextColor: z.ZodOptional<z.ZodString>;
+        headingFont: z.ZodOptional<z.ZodString>;
+        bodyFont: z.ZodOptional<z.ZodString>;
+        radius: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    cssVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>], "op">;
+export type Operation = z.infer<typeof operationSchema>;
+export declare const editPlanSchema: z.ZodObject<{
+    intent: z.ZodEnum<{
+        edit_plan: "edit_plan";
+        needs_clarification: "needs_clarification";
+        content_answer: "content_answer";
+    }>;
+    summary_for_user: z.ZodString;
+    change_log: z.ZodArray<z.ZodString>;
+    ops: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        op: z.ZodLiteral<"create_page">;
+        page: z.ZodType<PageDoc, unknown, z.core.$ZodTypeInternals<PageDoc, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"add_block">;
+        pageSlug: z.ZodString;
+        afterBlockId: z.ZodOptional<z.ZodString>;
+        block: z.ZodObject<{
+            id: z.ZodString;
+            props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            type: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"update_props">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"remove_block">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"move_block">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        afterBlockId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"duplicate_block">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        toPageSlug: z.ZodOptional<z.ZodString>;
+        newBlockId: z.ZodOptional<z.ZodString>;
+        afterBlockId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"add_item">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        listKey: z.ZodString;
+        item: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        afterItemId: z.ZodOptional<z.ZodString>;
+        afterIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"update_item">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        listKey: z.ZodString;
+        itemId: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+        patch: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"remove_item">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        listKey: z.ZodString;
+        itemId: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"move_item">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        listKey: z.ZodString;
+        itemId: z.ZodOptional<z.ZodString>;
+        index: z.ZodOptional<z.ZodNumber>;
+        afterItemId: z.ZodOptional<z.ZodString>;
+        afterIndex: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"reorder_items">;
+        pageSlug: z.ZodString;
+        blockId: z.ZodString;
+        listKey: z.ZodString;
+        order: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"reorder_blocks">;
+        pageSlug: z.ZodString;
+        order: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"rename_page">;
+        pageSlug: z.ZodString;
+        newPageSlug: z.ZodOptional<z.ZodString>;
+        newTitle: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"remove_page">;
+        pageSlug: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"move_page">;
+        pageSlug: z.ZodString;
+        afterPageSlug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"duplicate_page">;
+        pageSlug: z.ZodString;
+        newPageSlug: z.ZodOptional<z.ZodString>;
+        newTitle: z.ZodOptional<z.ZodString>;
+        afterPageSlug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"update_page_meta">;
+        pageSlug: z.ZodString;
+        patch: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            ogImage: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"update_site_config">;
+        patch: z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            logo: z.ZodOptional<z.ZodString>;
+            navLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            navGroups: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"update_theme">;
+        patch: z.ZodObject<{
+            brandColor: z.ZodOptional<z.ZodString>;
+            accentColor: z.ZodOptional<z.ZodString>;
+            backgroundColor: z.ZodOptional<z.ZodString>;
+            surfaceColor: z.ZodOptional<z.ZodString>;
+            headingColor: z.ZodOptional<z.ZodString>;
+            textColor: z.ZodOptional<z.ZodString>;
+            mutedTextColor: z.ZodOptional<z.ZodString>;
+            headingFont: z.ZodOptional<z.ZodString>;
+            bodyFont: z.ZodOptional<z.ZodString>;
+            radius: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        cssVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>], "op">>;
+    suggested_next_actions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type EditPlan = z.infer<typeof editPlanSchema>;
+export type PatchRejectReason = "version_mismatch" | "apply_error" | "unknown_op";
+export type ApplyPatchMessage = {
+    type: "applyPatch";
+    txId: string;
+    op: Operation;
+    fromVersion: number;
+    toVersion: number;
+    focusBlockId?: string;
+};
+export type PatchAckMessage = {
+    type: "patchAck";
+    txId: string;
+    accepted: boolean;
+    reason?: PatchRejectReason;
+};
+export type ResetToServerMessage = {
+    type: "resetToServer";
+    toVersion: number;
+    focusBlockId?: string;
+};
+export declare function demoPublishedPages(): PageDoc[];
+/** Demo site header config (name, logo, nav groups/labels) — paired with
+ * `demoPublishedPages()` so the editor's demo header matches the live site. */
+export declare function demoSiteConfig(): SiteConfig;

package/dist/schemas.js

@@ -0,0 +1,238 @@
+import { z } from "zod";
+import { blockInstanceSchema, blockInstanceSchemaLenient } from "./blocks/_registry.js";
+import { semanticThemeTokensSchema } from "./ops/theme-tokens.js";
+import { DEMO_SEED_PAGES, DEMO_SEED_SITE_CONFIG } from "./demo-seed-content.js";
+// ---------------------------------------------------------------------------
+// Site config
+// ---------------------------------------------------------------------------
+export const siteConfigSchema = z.object({
+    name: z.string().optional(),
+    logo: z.string().optional(),
+    purpose: z.string().optional(), // What the site is about — used as AI context for editing
+    tone: z.string().optional(), // Voice/tone guide for AI-generated content
+    constraints: z.array(z.string()).optional(), // Content rules the AI must follow (e.g. "Never mention competitor X")
+    navLabels: z.record(z.string(), z.string()).optional(), // slug → custom label, e.g. { "/pricing": "Plans & Pricing" }
+    navGroups: z.record(z.string(), z.array(z.string())).optional(), // parent label → child slugs, e.g. { "Products": ["/bananas", "/cherries"] }
+    themeOverrides: z.record(z.string(), z.string()).optional(), // CSS variable overrides, e.g. { "--brand": "#2563eb" }
+});
+export const pageMetaSchema = z.object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    ogImage: z.string().optional()
+});
+const pageDocFields = {
+    id: z.string().min(1),
+    slug: z.string().min(1),
+    title: z.string().min(1),
+    updatedAt: z.string().min(1),
+    meta: pageMetaSchema.optional()
+};
+/** Lenient — accepts any block type (for ingesting content from sites with custom blocks). */
+export const pageDocSchemaLenient = z.object({
+    ...pageDocFields,
+    blocks: z.array(blockInstanceSchemaLenient),
+});
+/** Strict — rejects block types not in the shared registry. */
+export const pageDocSchema = z.object({
+    ...pageDocFields,
+    blocks: z.array(blockInstanceSchema),
+});
+// ---------------------------------------------------------------------------
+// Operation schemas
+// ---------------------------------------------------------------------------
+const createPageSchema = z.object({
+    op: z.literal("create_page"),
+    page: pageDocSchema
+});
+const addBlockSchema = z.object({
+    op: z.literal("add_block"),
+    pageSlug: z.string().min(1),
+    afterBlockId: z.string().min(1).optional(),
+    block: blockInstanceSchema
+});
+const updatePropsSchema = z.object({
+    op: z.literal("update_props"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    patch: z.record(z.string(), z.unknown())
+});
+const removeBlockSchema = z.object({
+    op: z.literal("remove_block"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1)
+});
+const moveBlockSchema = z.object({
+    op: z.literal("move_block"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    afterBlockId: z.string().min(1).optional()
+});
+const duplicateBlockSchema = z.object({
+    op: z.literal("duplicate_block"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    toPageSlug: z.string().min(1).optional(),
+    newBlockId: z.string().min(1).optional(),
+    afterBlockId: z.string().min(1).optional()
+});
+// Item ops address a list entry by its stable `itemId` (preferred — every list
+// item carries an `id`, backfilled on load like block ids) or by positional
+// `index` (fallback for direct-manipulation clients like the editor's preview
+// bridge, where a single rendered element's position is reliable). The engine
+// requires at least one — and prefers itemId, which is robust across compound
+// plans where a numeric index reindexes mid-plan. `afterItemId`/`afterIndex`
+// anchor inserts/moves the same way (omit ⇒ append). At-least-one is enforced in
+// ops-engine.ts (a discriminated-union member can't carry a .refine()).
+const addItemSchema = z.object({
+    op: z.literal("add_item"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    listKey: z.string().min(1),
+    item: z.record(z.string(), z.unknown()),
+    afterItemId: z.string().min(1).optional(),
+    afterIndex: z.number().int().min(0).optional()
+});
+const updateItemSchema = z.object({
+    op: z.literal("update_item"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    listKey: z.string().min(1),
+    itemId: z.string().min(1).optional(),
+    index: z.number().int().min(0).optional(),
+    patch: z.record(z.string(), z.unknown())
+});
+const removeItemSchema = z.object({
+    op: z.literal("remove_item"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    listKey: z.string().min(1),
+    itemId: z.string().min(1).optional(),
+    index: z.number().int().min(0).optional()
+});
+const moveItemSchema = z.object({
+    op: z.literal("move_item"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    listKey: z.string().min(1),
+    itemId: z.string().min(1).optional(),
+    index: z.number().int().min(0).optional(),
+    afterItemId: z.string().min(1).optional(),
+    afterIndex: z.number().int().min(0).optional()
+});
+// Declarative reorders: the caller states the FINAL order and the engine
+// computes the moves — one atomic op instead of N move ops with shifting
+// anchors (which planners reliably get wrong). `order` must cover the whole
+// list exactly once. reorder_items entries are stable item ids (strings) or
+// current 0-based indexes (numbers — the only option for lists whose entries
+// can't carry ids, e.g. Table rows). reorder_blocks entries are block ids;
+// chrome blocks (SiteHeader/Footer) are pinned and must be omitted.
+const reorderItemsSchema = z.object({
+    op: z.literal("reorder_items"),
+    pageSlug: z.string().min(1),
+    blockId: z.string().min(1),
+    listKey: z.string().min(1),
+    order: z.array(z.union([z.string().min(1), z.number().int().min(0)])).min(1)
+});
+const reorderBlocksSchema = z.object({
+    op: z.literal("reorder_blocks"),
+    pageSlug: z.string().min(1),
+    order: z.array(z.string().min(1)).min(1)
+});
+// newPageSlug and newTitle are both optional here, but the ops-engine handler
+// requires at least one of them to produce an effective change. Enforcing that
+// with .refine() would turn this into ZodEffects and break the discriminated
+// union below, so the check lives in ops-engine.ts alongside the value-level
+// comparisons (current vs incoming).
+const renamePageSchema = z.object({
+    op: z.literal("rename_page"),
+    pageSlug: z.string().min(1),
+    newPageSlug: z.string().min(1).optional(),
+    newTitle: z.string().min(1).optional()
+});
+const removePageSchema = z.object({
+    op: z.literal("remove_page"),
+    pageSlug: z.string().min(1)
+});
+const movePageSchema = z.object({
+    op: z.literal("move_page"),
+    pageSlug: z.string().min(1),
+    afterPageSlug: z.string().min(1).optional()
+});
+const duplicatePageSchema = z.object({
+    op: z.literal("duplicate_page"),
+    pageSlug: z.string().min(1),
+    newPageSlug: z.string().min(1).optional(),
+    newTitle: z.string().min(1).optional(),
+    afterPageSlug: z.string().min(1).optional()
+});
+const updatePageMetaSchema = z.object({
+    op: z.literal("update_page_meta"),
+    pageSlug: z.string().min(1),
+    patch: z.object({
+        title: z.string().optional(),
+        description: z.string().optional(),
+        ogImage: z.string().optional()
+    })
+});
+const updateSiteConfigSchema = z.object({
+    op: z.literal("update_site_config"),
+    patch: z.object({
+        name: z.string().optional(),
+        logo: z.string().optional(),
+        navLabels: z.record(z.string(), z.string()).optional(),
+        navGroups: z.record(z.string(), z.array(z.string())).optional(),
+    })
+});
+// Visual theme changes (colors, fonts, corner radius). `patch` is a semantic
+// token map (brandColor, headingFont, radius, …) expanded to CSS custom
+// properties by the ops engine; `cssVars` is a raw `--var` → value escape hatch
+// merged after the semantic expansion (raw wins). Both are merge-patches over
+// the site's existing themeOverrides; set any value to "" to clear that override.
+const updateThemeSchema = z.object({
+    op: z.literal("update_theme"),
+    patch: semanticThemeTokensSchema,
+    cssVars: z.record(z.string(), z.string()).optional()
+});
+export const operationSchema = z.discriminatedUnion("op", [
+    createPageSchema,
+    addBlockSchema,
+    updatePropsSchema,
+    removeBlockSchema,
+    moveBlockSchema,
+    duplicateBlockSchema,
+    addItemSchema,
+    updateItemSchema,
+    removeItemSchema,
+    moveItemSchema,
+    reorderItemsSchema,
+    reorderBlocksSchema,
+    renamePageSchema,
+    removePageSchema,
+    movePageSchema,
+    duplicatePageSchema,
+    updatePageMetaSchema,
+    updateSiteConfigSchema,
+    updateThemeSchema
+]);
+export const editPlanSchema = z.object({
+    intent: z.enum(["edit_plan", "needs_clarification", "content_answer"]),
+    summary_for_user: z.string().min(1),
+    change_log: z.array(z.string()),
+    ops: z.array(operationSchema),
+    suggested_next_actions: z.array(z.string()).max(5).optional()
+});
+// ---------------------------------------------------------------------------
+// Demo data
+// ---------------------------------------------------------------------------
+export function demoPublishedPages() {
+    const now = new Date().toISOString();
+    // Seed every fresh editor demo session with a deep copy of the live
+    // avocado-site.vercel.app content (see demo-seed-content.ts), stamping a fresh
+    // `updatedAt` so version/freshness logic behaves like a brand-new draft.
+    return DEMO_SEED_PAGES.map((page) => ({ ...structuredClone(page), updatedAt: now }));
+}
+/** Demo site header config (name, logo, nav groups/labels) — paired with
+ * `demoPublishedPages()` so the editor's demo header matches the live site. */
+export function demoSiteConfig() {
+    return structuredClone(DEMO_SEED_SITE_CONFIG);
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@avocadostudio-ai/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/avocadostudio-ai/avocado.git",
+    "directory": "packages/shared"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "contract"
+  ],
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.3"
+  },
+  "description": "Shared Zod schemas, block registry, and operation types for Avocado Studio",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/avocadostudio-ai/avocado/tree/main/packages/shared#readme",
+  "bugs": {
+    "url": "https://github.com/avocadostudio-ai/avocado/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./contract/*": "./contract/*",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "NODE_ENV=test tsx --test src/**/*.test.ts",
+    "gen:contract": "tsx scripts/gen-contract.ts",
+    "gen:contract:check": "tsx scripts/gen-contract.ts --check"
+  }
+}