@kubuild/schema 0.8.0 → 0.8.2

package/dist/document.d.cts

@@ -0,0 +1,742 @@
+import { z } from 'zod';
+import { ActionPipeline } from './actions.cjs';
+import { FormConfig } from './form.cjs';
+export declare const SCHEMA_NAME: "stora.page";
+export declare const CURRENT_SCHEMA_VERSION: "1.2.0";
+/**
+ * Asset Reference Schema
+ * Represents a reference to an asset stored either locally within the .stora package or hosted externally.
+ */
+export declare const AssetReferenceSchema: z.ZodObject<{
+    type: z.ZodLiteral<"asset">;
+    assetId: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    fallbackUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AssetReference = z.infer<typeof AssetReferenceSchema>;
+/**
+ * Variable Binding Schema
+ * Represents a dynamic runtime variable replacement (e.g. {{ site.name }}).
+ */
+export declare const VariableBindingSchema: z.ZodObject<{
+    type: z.ZodLiteral<"variable">;
+    key: z.ZodString;
+    fallback: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type VariableBinding = z.infer<typeof VariableBindingSchema>;
+/**
+ * Action Binding Schema
+ * Represents an interactive action triggerable by UI components (e.g. navigation, modal, custom event).
+ */
+export declare const ActionBindingSchema: z.ZodObject<{
+    type: z.ZodString;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ActionBinding = z.infer<typeof ActionBindingSchema>;
+export declare const StyleValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>;
+export type StyleValue = z.infer<typeof StyleValueSchema>;
+/**
+ * Standard CSS style definition supporting Flexbox (STORA-101), Sizing constraints (STORA-101),
+ * Effects & rounded corners (STORA-101), CSS Grid (STORA-110), and arbitrary CSS properties/tokens.
+ */
+export interface StyleDefinition extends Record<string, StyleValue> {
+    display?: string;
+    flexDirection?: 'row' | 'row-reverse' | 'column' | 'column-reverse' | (string & {});
+    flexWrap?: 'nowrap' | 'wrap' | 'wrap-reverse' | (string & {});
+    justifyContent?: 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly' | 'start' | 'end' | 'left' | 'right' | (string & {});
+    alignItems?: 'stretch' | 'flex-start' | 'flex-end' | 'center' | 'baseline' | 'start' | 'end' | 'self-start' | 'self-end' | (string & {});
+    alignContent?: 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly' | 'stretch' | 'start' | 'end' | (string & {});
+    gap?: string | number;
+    rowGap?: string | number;
+    columnGap?: string | number;
+    flexGrow?: number | string;
+    flexShrink?: number | string;
+    flexBasis?: string | number;
+    alignSelf?: 'auto' | 'flex-start' | 'flex-end' | 'center' | 'baseline' | 'stretch' | (string & {});
+    width?: string | number;
+    height?: string | number;
+    minWidth?: string | number;
+    maxWidth?: string | number;
+    minHeight?: string | number;
+    maxHeight?: string | number;
+    objectFit?: 'fill' | 'contain' | 'cover' | 'none' | 'scale-down' | (string & {});
+    objectPosition?: string;
+    borderRadius?: string | number;
+    borderTopLeftRadius?: string | number;
+    borderTopRightRadius?: string | number;
+    borderBottomRightRadius?: string | number;
+    borderBottomLeftRadius?: string | number;
+    backdropFilter?: string;
+    filter?: string;
+    boxShadow?: string;
+    backgroundColor?: string;
+    backgroundImage?: string;
+    backgroundSize?: 'cover' | 'contain' | 'auto' | (string & {});
+    backgroundPosition?: string;
+    backgroundRepeat?: 'no-repeat' | 'repeat' | 'repeat-x' | 'repeat-y' | (string & {});
+    backgroundAttachment?: 'scroll' | 'fixed' | 'local' | (string & {});
+    gridTemplateColumns?: string;
+    gridTemplateRows?: string;
+    gridAutoFlow?: string;
+    gridAutoColumns?: string;
+    gridAutoRows?: string;
+    gridColumn?: string | number;
+    gridRow?: string | number;
+    gridColumnStart?: string | number;
+    gridColumnEnd?: string | number;
+    gridRowStart?: string | number;
+    gridRowEnd?: string | number;
+    colSpan?: number | string;
+    rowSpan?: number | string;
+    justifySelf?: string;
+}
+export declare const StyleDefinitionSchema: z.ZodType<StyleDefinition>;
+/**
+ * Pseudo-state style definitions keyed by CSS pseudo-class selector
+ * (e.g. `:hover`, `:focus`, `:active`). Each entry is a style layer applied
+ * on top of the resolved breakpoint styles when the state is active.
+ */
+export declare const PseudoStateStylesSchema: z.ZodRecord<z.ZodString, z.ZodType<StyleDefinition, unknown, z.core.$ZodTypeInternals<StyleDefinition, unknown>>>;
+export type PseudoStateStyles = Record<string, StyleDefinition>;
+/**
+ * Responsive Styles Schema
+ * Breakpoint-specific style definitions: base (all viewports), desktop, tablet, and mobile.
+ * Optionally carries `states` — pseudo-class style layers (e.g. `:hover`).
+ */
+export declare const ResponsiveStylesSchema: z.ZodDefault<z.ZodObject<{
+    base: z.ZodOptional<z.ZodType<StyleDefinition, unknown, z.core.$ZodTypeInternals<StyleDefinition, unknown>>>;
+    desktop: z.ZodOptional<z.ZodType<StyleDefinition, unknown, z.core.$ZodTypeInternals<StyleDefinition, unknown>>>;
+    tablet: z.ZodOptional<z.ZodType<StyleDefinition, unknown, z.core.$ZodTypeInternals<StyleDefinition, unknown>>>;
+    mobile: z.ZodOptional<z.ZodType<StyleDefinition, unknown, z.core.$ZodTypeInternals<StyleDefinition, unknown>>>;
+    states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<StyleDefinition, unknown, z.core.$ZodTypeInternals<StyleDefinition, unknown>>>>;
+}, z.core.$loose>>;
+export type ResponsiveStyles = z.infer<typeof ResponsiveStylesSchema>;
+/**
+ * Animation Configuration Schema
+ * Defines scroll entrance animations (AOS), duration, delay, easing curve,
+ * trigger behavior (once), hover micro-interactions, and continuous loop effects.
+ */
+export declare const AnimationConfigSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    duration: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    delay: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    easing: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    once: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    hoverEffect: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    loopEffect: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type AnimationConfig = z.infer<typeof AnimationConfigSchema>;
+export declare const DEFAULT_ANIMATION_CONFIG: AnimationConfig;
+/**
+ * Recursive Node Type Definition
+ */
+export type Node = {
+    id: string;
+    type: string;
+    props?: Record<string, unknown>;
+    styles?: ResponsiveStyles;
+    animation?: AnimationConfig;
+    actions?: ActionPipeline[];
+    formConfig?: FormConfig;
+    children?: Node[];
+};
+/**
+ * Recursive Node Schema
+ * Represents any element/node in the document tree.
+ * Node IDs are deterministic, independent of React keys, and unique across the document.
+ */
+export declare const NodeSchema: z.ZodType<Node>;
+export type RootPageNode = Node & {
+    type: 'page';
+};
+/**
+ * Root Page Node Schema
+ * The root node of a PageDocument must be of type 'page'.
+ */
+export declare const RootPageNodeSchema: z.ZodType<RootPageNode>;
+/**
+ * Document Metadata Schema
+ * Pure serializable metadata for the document.
+ */
+export declare const DocumentMetadataSchema: z.ZodObject<{
+    title: z.ZodDefault<z.ZodString>;
+    description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    tracking: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            both: "both";
+            client_only: "client_only";
+            server_only: "server_only";
+        }>>>;
+        providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            meta: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            google: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            gtm: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            tiktok: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            custom: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DocumentMetadata = z.infer<typeof DocumentMetadataSchema>;
+/**
+ * Page Document Schema v1
+ * Root portable document structure:
+ * - schema: strictly "stora.page"
+ * - version: schema version string (e.g. "1.0.0")
+ * - metadata: serializable metadata
+ * - document: root page node
+ * - tracking: optional dynamic pixel & CAPI tracking configuration
+ * - theme: optional design tokens (colors/fonts/radii/spacing), emitted as CSS custom
+ *   properties and referenced from node styles as `var(--kb-color-<key>)` (STORA-551)
+ */
+export declare const PageDocumentSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"stora.page">;
+    version: z.ZodDefault<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        title: z.ZodDefault<z.ZodString>;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        tracking: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                both: "both";
+                client_only: "client_only";
+                server_only: "server_only";
+            }>>>;
+            providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                meta: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                google: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                gtm: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                tiktok: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                custom: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    tracking: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            both: "both";
+            client_only: "client_only";
+            server_only: "server_only";
+        }>>>;
+        providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            meta: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            google: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            gtm: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            tiktok: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            custom: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    theme: z.ZodOptional<z.ZodObject<{
+        colors: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        fonts: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        radii: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        spacing: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    }, z.core.$strip>>;
+    document: z.ZodType<RootPageNode, unknown, z.core.$ZodTypeInternals<RootPageNode, unknown>>;
+}, z.core.$strip>;
+export type PageDocument = z.infer<typeof PageDocumentSchema>;
+export declare const PROJECT_SCHEMA_NAME: "stora.project";
+export declare const CURRENT_PROJECT_SCHEMA_VERSION: "1.0.0";
+/**
+ * Node type used as the in-tree placeholder left behind when a subtree is detached
+ * into its own artboard. It carries no children — the real content lives in the
+ * artboard named by `props.artboardId`.
+ */
+export declare const ARTBOARD_REFERENCE_NODE_TYPE: "artboard-reference";
+/**
+ * Artboard Type Schema
+ * - 'page': a routable page surface (has a slug)
+ * - 'component': a detached surface rendered as an overlay/portal at runtime
+ *   (modal, drawer, collapsible, or any block the author detached), reached by `triggerId`
+ */
+export declare const ArtboardTypeSchema: z.ZodEnum<{
+    page: "page";
+    component: "component";
+}>;
+export type ArtboardType = z.infer<typeof ArtboardTypeSchema>;
+/**
+ * Artboard Schema
+ * One top-level surface on the builder canvas. Each artboard embeds a complete
+ * PageDocument so that every existing document command, tree utility, validator,
+ * and history engine keeps operating on exactly the shape it already understands.
+ *
+ * Component artboards always wrap their detached node as the sole child of a
+ * synthetic `type: 'page'` root, so the root-type constraint never has to be relaxed.
+ */
+export declare const ArtboardSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    artboardType: z.ZodEnum<{
+        page: "page";
+        component: "component";
+    }>;
+    slug: z.ZodOptional<z.ZodString>;
+    triggerId: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodOptional<z.ZodEnum<{
+        mobile: "mobile";
+        desktop: "desktop";
+        tablet: "tablet";
+    }>>;
+    width: z.ZodOptional<z.ZodNumber>;
+    position: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>;
+    document: z.ZodObject<{
+        schema: z.ZodLiteral<"stora.page">;
+        version: z.ZodDefault<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            title: z.ZodDefault<z.ZodString>;
+            description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            createdAt: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            tracking: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                    both: "both";
+                    client_only: "client_only";
+                    server_only: "server_only";
+                }>>>;
+                providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                    meta: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                        testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    google: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    gtm: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    tiktok: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                        testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    custom: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        tracking: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                both: "both";
+                client_only: "client_only";
+                server_only: "server_only";
+            }>>>;
+            providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                meta: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                google: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                gtm: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                tiktok: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                custom: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        theme: z.ZodOptional<z.ZodObject<{
+            colors: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            fonts: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            radii: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            spacing: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+        }, z.core.$strip>>;
+        document: z.ZodType<RootPageNode, unknown, z.core.$ZodTypeInternals<RootPageNode, unknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Artboard = z.infer<typeof ArtboardSchema>;
+/**
+ * Project Document Schema
+ * Root portable structure holding many artboards:
+ * - schema: strictly "stora.project" (distinct from the single-page "stora.page")
+ * - version: project schema version string
+ * - metadata: serializable metadata
+ * - artboards: one or more page/component surfaces
+ * - activeArtboardId: which artboard the editor should open
+ */
+export declare const ProjectDocumentSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"stora.project">;
+    version: z.ZodDefault<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        title: z.ZodDefault<z.ZodString>;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        tracking: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                both: "both";
+                client_only: "client_only";
+                server_only: "server_only";
+            }>>>;
+            providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                meta: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                google: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                gtm: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                tiktok: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                    pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                }, z.core.$strip>>;
+                custom: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    credentialId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    tracking: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            both: "both";
+            client_only: "client_only";
+            server_only: "server_only";
+        }>>>;
+        providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            meta: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            google: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            gtm: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            tiktok: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+                pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            }, z.core.$strip>>;
+            custom: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                credentialId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    artboards: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        artboardType: z.ZodEnum<{
+            page: "page";
+            component: "component";
+        }>;
+        slug: z.ZodOptional<z.ZodString>;
+        triggerId: z.ZodOptional<z.ZodString>;
+        viewport: z.ZodOptional<z.ZodEnum<{
+            mobile: "mobile";
+            desktop: "desktop";
+            tablet: "tablet";
+        }>>;
+        width: z.ZodOptional<z.ZodNumber>;
+        position: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>>;
+        document: z.ZodObject<{
+            schema: z.ZodLiteral<"stora.page">;
+            version: z.ZodDefault<z.ZodString>;
+            metadata: z.ZodOptional<z.ZodObject<{
+                title: z.ZodDefault<z.ZodString>;
+                description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                createdAt: z.ZodOptional<z.ZodString>;
+                updatedAt: z.ZodOptional<z.ZodString>;
+                tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+                category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                version: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                tracking: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                        both: "both";
+                        client_only: "client_only";
+                        server_only: "server_only";
+                    }>>>;
+                    providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                        meta: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodDefault<z.ZodBoolean>;
+                            credentialId: z.ZodOptional<z.ZodString>;
+                            pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                            capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                            testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        }, z.core.$strip>>;
+                        google: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodDefault<z.ZodBoolean>;
+                            credentialId: z.ZodOptional<z.ZodString>;
+                            measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        }, z.core.$strip>>;
+                        gtm: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodDefault<z.ZodBoolean>;
+                            credentialId: z.ZodOptional<z.ZodString>;
+                            containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        }, z.core.$strip>>;
+                        tiktok: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodDefault<z.ZodBoolean>;
+                            credentialId: z.ZodOptional<z.ZodString>;
+                            pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                            eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                            testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        }, z.core.$strip>>;
+                        custom: z.ZodOptional<z.ZodObject<{
+                            enabled: z.ZodDefault<z.ZodBoolean>;
+                            credentialId: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            tracking: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                debugMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                autoPageView: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                defaultDelivery: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+                    both: "both";
+                    client_only: "client_only";
+                    server_only: "server_only";
+                }>>>;
+                providers: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                    meta: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        capiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                        testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    google: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        measurementId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    gtm: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        containerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    tiktok: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                        pixelId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                        eventsApiEnabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                        testEventCode: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    }, z.core.$strip>>;
+                    custom: z.ZodOptional<z.ZodObject<{
+                        enabled: z.ZodDefault<z.ZodBoolean>;
+                        credentialId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            theme: z.ZodOptional<z.ZodObject<{
+                colors: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                fonts: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                radii: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+                spacing: z.ZodOptional<z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+            }, z.core.$strip>>;
+            document: z.ZodType<RootPageNode, unknown, z.core.$ZodTypeInternals<RootPageNode, unknown>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    activeArtboardId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectDocument = z.infer<typeof ProjectDocumentSchema>;
+/**
+ * Type guards
+ */
+export declare function isAssetReference(value: unknown): value is AssetReference;
+export declare function isVariableBinding(value: unknown): value is VariableBinding;
+export declare function isActionBinding(value: unknown): value is ActionBinding;
+export declare function isAnimationConfig(value: unknown): value is AnimationConfig;
+export declare function isProjectDocument(value: unknown): value is ProjectDocument;
+/**
+ * Cheap structural sniff used by the loader to route a raw payload to either the
+ * project pipeline or the legacy single-page pipeline, before any parsing happens.
+ * Intentionally does not validate — a malformed project must still be routed to the
+ * project parser so its own errors surface, rather than being silently treated as a page.
+ */
+export declare function looksLikeProjectDocument(value: unknown): boolean;
+/**
+ * Node type guard for the in-tree placeholder that points at a detached artboard.
+ */
+export declare function isArtboardReferenceNode(node: Node): boolean;
+/**
+ * Deterministic Node ID Generator
+ * Generates predictable IDs based on prefix and an index/identifier (not bound to React keys).
+ */
+export declare function generateDeterministicNodeId(prefix: string, indexOrKey: number | string): string;
+/**
+ * Collect all Node IDs in a node tree
+ */
+export declare function collectNodeIds(node: Node): string[];
+/**
+ * Validate Node ID uniqueness across a node tree or document
+ */
+export declare function validateNodeIdUniqueness(node: Node): {
+    valid: boolean;
+    duplicateIds: string[];
+};
+//# sourceMappingURL=document.d.cts.map