@kubuild/schema 0.1.0 → 0.3.0

package/dist/document.d.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+import { ActionPipeline } from './actions';
+import { FormConfig } from './form';
 export declare const SCHEMA_NAME: "stora.page";
 export declare const CURRENT_SCHEMA_VERSION: "1.0.0";
 /**
@@ -33,14 +35,63 @@ export declare const ActionBindingSchema: z.ZodObject<{
 }, 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 declare const StyleDefinitionSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>;
-export type StyleDefinition = Record<string, string | number | boolean | null | undefined>;
+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;
+    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.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>>;
+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
@@ -48,11 +99,11 @@ export type PseudoStateStyles = Record<string, StyleDefinition>;
  * Optionally carries `states` — pseudo-class style layers (e.g. `:hover`).
  */
 export declare const ResponsiveStylesSchema: z.ZodDefault<z.ZodObject<{
-    base: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>>;
-    desktop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>>;
-    tablet: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>>;
-    mobile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>>;
-    states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>>>;
+    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>;
 /**
@@ -80,6 +131,8 @@ export type Node = {
     props?: Record<string, unknown>;
     styles?: ResponsiveStyles;
     animation?: AnimationConfig;
+    actions?: ActionPipeline[];
+    formConfig?: FormConfig;
     children?: Node[];
 };
 /**
@@ -137,6 +190,133 @@ export declare const PageDocumentSchema: z.ZodObject<{
     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>>;
+        }, 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>>;
+    }, 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>>;
+            }, 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
  */
@@ -144,6 +324,18 @@ export declare function isAssetReference(value: unknown): value is AssetReferenc
 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).

package/dist/document.d.ts.map

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

package/dist/form.d.ts

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+/**
+ * Validation Rule Types
+ * Supported validation primitives for form inputs in KUBUILD.
+ */
+export declare const ValidationRuleTypeSchema: z.ZodEnum<{
+    required: "required";
+    url: "url";
+    pattern: "pattern";
+    email: "email";
+    max_length: "max_length";
+    min_length: "min_length";
+    numeric_min: "numeric_min";
+    numeric_max: "numeric_max";
+    match_field: "match_field";
+    custom_regex: "custom_regex";
+}>;
+export type ValidationRuleType = z.infer<typeof ValidationRuleTypeSchema>;
+/**
+ * Validation Trigger Timing
+ * Controls when field validation is evaluated.
+ */
+export declare const ValidateOnEventSchema: z.ZodEnum<{
+    change: "change";
+    blur: "blur";
+    submit: "submit";
+}>;
+export type ValidateOnEvent = z.infer<typeof ValidateOnEventSchema>;
+/**
+ * Validation Rule Schema
+ * Defines an individual validation condition and its custom error message.
+ */
+export declare const ValidationRuleSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        required: "required";
+        url: "url";
+        pattern: "pattern";
+        email: "email";
+        max_length: "max_length";
+        min_length: "min_length";
+        numeric_min: "numeric_min";
+        numeric_max: "numeric_max";
+        match_field: "match_field";
+        custom_regex: "custom_regex";
+    }>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type ValidationRule = z.infer<typeof ValidationRuleSchema>;
+/**
+ * Form Field Binding Schema
+ * Connects an input component to the form state runtime with validation rules and initial values.
+ */
+export declare const FormFieldBindingSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    defaultValue: z.ZodOptional<z.ZodUnknown>;
+    rules: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            required: "required";
+            url: "url";
+            pattern: "pattern";
+            email: "email";
+            max_length: "max_length";
+            min_length: "min_length";
+            numeric_min: "numeric_min";
+            numeric_max: "numeric_max";
+            match_field: "match_field";
+            custom_regex: "custom_regex";
+        }>;
+        value: z.ZodOptional<z.ZodUnknown>;
+        message: z.ZodString;
+    }, z.core.$strip>>>>;
+    validateOn: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        change: "change";
+        blur: "blur";
+        submit: "submit";
+    }>>>;
+    transform: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        trim: "trim";
+        lowercase: "lowercase";
+        uppercase: "uppercase";
+    }>>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    required: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FormFieldBinding = z.infer<typeof FormFieldBindingSchema>;
+/**
+ * Form Container Configuration Schema
+ * Configuration for form boundaries, submission behavior, and error focus.
+ */
+export declare const FormConfigSchema: z.ZodObject<{
+    formId: z.ZodString;
+    resetOnSubmit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    scrollToFirstError: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    validateOn: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        change: "change";
+        blur: "blur";
+        submit: "submit";
+    }>>>;
+    initialValues: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            required: "required";
+            url: "url";
+            pattern: "pattern";
+            email: "email";
+            max_length: "max_length";
+            min_length: "min_length";
+            numeric_min: "numeric_min";
+            numeric_max: "numeric_max";
+            match_field: "match_field";
+            custom_regex: "custom_regex";
+        }>;
+        value: z.ZodOptional<z.ZodUnknown>;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type FormConfig = z.infer<typeof FormConfigSchema>;
+/**
+ * Type Guards
+ */
+export declare function isValidationRuleType(value: unknown): value is ValidationRuleType;
+export declare function isValidationRule(value: unknown): value is ValidationRule;
+export declare function isValidateOnEvent(value: unknown): value is ValidateOnEvent;
+export declare function isFormFieldBinding(value: unknown): value is FormFieldBinding;
+export declare function isFormConfig(value: unknown): value is FormConfig;
+//# sourceMappingURL=form.d.ts.map

package/dist/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;EAWnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;EAAuC,CAAC;AAC1E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;iBAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE"}