@kubuild/schema 0.7.0 → 0.8.1

package/dist/json-schema.d.ts

@@ -20,7 +20,7 @@ export declare const PAGE_DOCUMENT_JSON_SCHEMA_V1: {
             readonly type: "string";
             readonly pattern: "^\\d+(\\.\\d+)*$";
             readonly description: "Schema version of the document";
-            readonly default: "1.1.0";
+            readonly default: "1.2.0";
         };
         readonly metadata: {
             readonly $ref: "#/definitions/documentMetadata";
@@ -31,8 +31,42 @@ export declare const PAGE_DOCUMENT_JSON_SCHEMA_V1: {
         readonly tracking: {
             readonly $ref: "#/definitions/trackingConfig";
         };
+        readonly theme: {
+            readonly $ref: "#/definitions/theme";
+        };
     };
     readonly definitions: {
+        readonly themeTokenMap: {
+            readonly type: "object";
+            readonly propertyNames: {
+                readonly pattern: "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$";
+            };
+            readonly additionalProperties: {
+                readonly type: readonly ["string", "number"];
+                readonly maxLength: 512;
+                readonly pattern: "^[^;{}<>\\\\]*$";
+            };
+            readonly description: "Design tokens keyed by name. Values must not contain ; { } < > or backslashes.";
+        };
+        readonly theme: {
+            readonly type: "object";
+            readonly description: "Document design tokens, emitted as CSS custom properties (--kb-color-*, --kb-font-*, --kb-radius-*, --kb-space-*) and referenced from styles as var(--kb-color-<key>).";
+            readonly properties: {
+                readonly colors: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+                readonly fonts: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+                readonly radii: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+                readonly spacing: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+            };
+            readonly additionalProperties: false;
+        };
         readonly trackingConfig: {
             readonly type: "object";
             readonly description: "Tracking configuration. Contains only public ids, flags and opaque credential ids — secrets are host-owned.";
@@ -342,7 +376,7 @@ export declare const PAGE_DOCUMENT_JSON_SCHEMA_V1: {
                 };
                 readonly trigger: {
                     readonly type: "string";
-                    readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load"];
+                    readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load", "expire"];
                 };
                 readonly label: {
                     readonly type: "string";
@@ -521,7 +555,7 @@ export declare function getPageDocumentJsonSchema(): {
             readonly type: "string";
             readonly pattern: "^\\d+(\\.\\d+)*$";
             readonly description: "Schema version of the document";
-            readonly default: "1.1.0";
+            readonly default: "1.2.0";
         };
         readonly metadata: {
             readonly $ref: "#/definitions/documentMetadata";
@@ -532,8 +566,42 @@ export declare function getPageDocumentJsonSchema(): {
         readonly tracking: {
             readonly $ref: "#/definitions/trackingConfig";
         };
+        readonly theme: {
+            readonly $ref: "#/definitions/theme";
+        };
     };
     readonly definitions: {
+        readonly themeTokenMap: {
+            readonly type: "object";
+            readonly propertyNames: {
+                readonly pattern: "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$";
+            };
+            readonly additionalProperties: {
+                readonly type: readonly ["string", "number"];
+                readonly maxLength: 512;
+                readonly pattern: "^[^;{}<>\\\\]*$";
+            };
+            readonly description: "Design tokens keyed by name. Values must not contain ; { } < > or backslashes.";
+        };
+        readonly theme: {
+            readonly type: "object";
+            readonly description: "Document design tokens, emitted as CSS custom properties (--kb-color-*, --kb-font-*, --kb-radius-*, --kb-space-*) and referenced from styles as var(--kb-color-<key>).";
+            readonly properties: {
+                readonly colors: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+                readonly fonts: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+                readonly radii: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+                readonly spacing: {
+                    readonly $ref: "#/definitions/themeTokenMap";
+                };
+            };
+            readonly additionalProperties: false;
+        };
         readonly trackingConfig: {
             readonly type: "object";
             readonly description: "Tracking configuration. Contains only public ids, flags and opaque credential ids — secrets are host-owned.";
@@ -843,7 +911,7 @@ export declare function getPageDocumentJsonSchema(): {
                 };
                 readonly trigger: {
                     readonly type: "string";
-                    readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load"];
+                    readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load", "expire"];
                 };
                 readonly label: {
                     readonly type: "string";
@@ -1574,7 +1642,7 @@ export declare const ACTION_PIPELINE_JSON_SCHEMA_V1: {
         };
         readonly trigger: {
             readonly type: "string";
-            readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load"];
+            readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load", "expire"];
             readonly description: "DOM or component event that triggers the action pipeline";
         };
         readonly label: {
@@ -1679,7 +1747,7 @@ export declare function getActionPipelineJsonSchema(): {
         };
         readonly trigger: {
             readonly type: "string";
-            readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load"];
+            readonly enum: readonly ["click", "submit", "change", "blur", "focus", "load", "expire"];
             readonly description: "DOM or component event that triggers the action pipeline";
         };
         readonly label: {

package/dist/json-schema.d.ts.map

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

package/dist/template.d.ts

@@ -176,6 +176,12 @@ export declare const TemplateRecordSchema: z.ZodObject<{
                 }, 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<import("./document").RootPageNode, unknown, z.core.$ZodTypeInternals<import("./document").RootPageNode, unknown>>;
     }, z.core.$strip>>;
     packageReference: z.ZodOptional<z.ZodObject<{

package/dist/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4C,KAAK,cAAc,EAAqB,MAAM,YAAY,CAAC;AAS9G;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;gCAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBAKnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4C,KAAK,cAAc,EAAqB,MAAM,YAAY,CAAC;AAS9G;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMvD;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,aAGlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;gCAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;iBAKnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE"}

package/dist/theme.d.ts

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+/**
+ * Document Theme / Design Tokens (STORA-551)
+ *
+ * A theme is a small, portable set of named design tokens stored on the document
+ * (`PageDocument.theme`). The renderer emits every token as a CSS custom property on
+ * the page root, and node styles reference tokens with a plain CSS `var()` string:
+ *
+ *   styles.base.backgroundColor = 'var(--kb-color-primary)'
+ *
+ * Because the reference is an ordinary CSS value it passes the existing style
+ * validation, renders unchanged in inline styles, generated CSS and exported HTML,
+ * and falls back gracefully (to the property's initial value) when a token is absent.
+ *
+ * Token groups map to custom-property prefixes:
+ *   colors  -> --kb-color-<key>
+ *   fonts   -> --kb-font-<key>
+ *   radii   -> --kb-radius-<key>
+ *   spacing -> --kb-space-<key>
+ *
+ * Security: token keys are restricted to a safe identifier alphabet and token values
+ * are screened like style values, and additionally may not contain characters that can
+ * terminate a CSS declaration/rule or open markup (`; { } < > \`), since values end up
+ * inside a `<style>` block in generated HTML.
+ */
+export declare const THEME_TOKEN_GROUPS: readonly ["colors", "fonts", "radii", "spacing"];
+export type ThemeTokenGroup = (typeof THEME_TOKEN_GROUPS)[number];
+/** CSS custom-property prefix per token group. */
+export declare const THEME_TOKEN_CSS_PREFIX: Readonly<Record<ThemeTokenGroup, string>>;
+/** True when `key` can be used as a theme token key (and custom-property suffix). */
+export declare function isSafeThemeTokenKey(key: unknown): key is string;
+/**
+ * True when `value` is safe to emit as a CSS custom-property value. Numbers are allowed
+ * (finite only); strings must be short and free of injection vectors.
+ */
+export declare function isSafeThemeTokenValue(value: unknown): value is string | number;
+export declare const ThemeTokenKeySchema: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+export declare const ThemeTokenValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+export type ThemeTokenValue = z.infer<typeof ThemeTokenValueSchema>;
+export declare const ThemeTokenMapSchema: z.ZodRecord<z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+export type ThemeTokenMap = Record<string, ThemeTokenValue>;
+export declare const ThemeSchema: 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>;
+export type Theme = z.infer<typeof ThemeSchema>;
+/**
+ * Builds the custom-property name for a token, e.g. `('colors', 'primary')` ->
+ * `--kb-color-primary`. Returns `null` for unsafe keys.
+ */
+export declare function themeTokenCssVarName(group: ThemeTokenGroup, key: string): string | null;
+/**
+ * Builds the style value that references a token, e.g. `var(--kb-color-primary)`.
+ * This is the canonical token reference format stored in node styles.
+ */
+export declare function themeTokenRef(group: ThemeTokenGroup, key: string): string;
+/**
+ * Parses a token reference style value back into `{ group, key }`, or `null` when the
+ * value is not a theme token reference.
+ */
+export declare function parseThemeTokenRef(value: unknown): {
+    group: ThemeTokenGroup;
+    key: string;
+} | null;
+/**
+ * Merges theme layers left-to-right (later layers win per token). Used to apply a host
+ * runtime override on top of the document theme without mutating either. Unsafe tokens in
+ * any layer are skipped, so an invalid override never clobbers a valid lower-layer value.
+ */
+export declare function mergeThemes(...layers: Array<Partial<Theme> | undefined | null>): Theme;
+/**
+ * Flattens a theme into `[customPropertyName, value]` pairs, silently dropping any
+ * token whose key or value is unsafe. Safe to call on unvalidated input (e.g. a host
+ * runtime override), which is why it re-checks every entry.
+ */
+export declare function themeToCssVariables(theme: Partial<Theme> | undefined | null): Array<[string, string]>;
+export declare function isTheme(value: unknown): value is Theme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,kBAAkB,kDAAmD,CAAC;AAEnF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAK3E,CAAC;AAQH,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,GAAG,MAAM,CAO9E;AAED,eAAO,MAAM,mBAAmB,mFAG9B,CAAC;AAEH,eAAO,MAAM,qBAAqB,iDAOhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,mBAAmB,iJAAuD,CAAC;AAExF,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE5D,eAAO,MAAM,WAAW;;;;;iBAKtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMzE;AAWD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKjG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,KAAK,CActF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,GAAG,IAAI,GACvC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkBzB;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD"}

package/dist/types.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * `@kubuild/schema/types` — pure TypeScript interfaces for the portable document format\n * (STORA-552).\n *\n * This module MUST NOT import zod (or any module that does). Its emitted `.d.ts` is what\n * hosts on a different zod major (e.g. a zod v3 backend) import to type `PageDocument`,\n * `Node`, etc. without pulling zod v4's core namespace into their compilation.\n *\n * Every type here mirrors the *parsed output* (`z.infer<...>`) of the matching schema in\n * the main entry, i.e. fields with a schema default are required. The equality is\n * enforced by `tests/types.test.ts` (`expectTypeOf(...).toEqualTypeOf(...)`), so a schema\n * change that is not reflected here fails `pnpm run typecheck`.\n */\n\n/* ----------------------------------------------------------------------------------------\n * Bindings & styles\n * -------------------------------------------------------------------------------------- */\n\nexport interface AssetReference {\n  type: 'asset';\n  assetId: string;\n  filename?: string;\n  mimeType?: string;\n  fallbackUrl?: string;\n}\n\nexport interface VariableBinding {\n  type: 'variable';\n  key: string;\n  fallback?: unknown;\n}\n\nexport interface ActionBinding {\n  type: string;\n  payload?: Record<string, unknown>;\n}\n\nexport type StyleValue = string | number | boolean | null | undefined;\n\n/**\n * Standard CSS style definition supporting Flexbox, sizing constraints, effects,\n * CSS Grid, and arbitrary CSS properties / design-token references.\n */\nexport interface StyleDefinition extends Record<string, StyleValue> {\n  display?: string;\n  flexDirection?: 'row' | 'row-reverse' | 'column' | 'column-reverse' | (string & {});\n  flexWrap?: 'nowrap' | 'wrap' | 'wrap-reverse' | (string & {});\n  justifyContent?:\n    | 'flex-start'\n    | 'flex-end'\n    | 'center'\n    | 'space-between'\n    | 'space-around'\n    | 'space-evenly'\n    | 'start'\n    | 'end'\n    | 'left'\n    | 'right'\n    | (string & {});\n  alignItems?:\n    | 'stretch'\n    | 'flex-start'\n    | 'flex-end'\n    | 'center'\n    | 'baseline'\n    | 'start'\n    | 'end'\n    | 'self-start'\n    | 'self-end'\n    | (string & {});\n  alignContent?:\n    | 'flex-start'\n    | 'flex-end'\n    | 'center'\n    | 'space-between'\n    | 'space-around'\n    | 'space-evenly'\n    | 'stretch'\n    | 'start'\n    | 'end'\n    | (string & {});\n  gap?: string | number;\n  rowGap?: string | number;\n  columnGap?: string | number;\n  flexGrow?: number | string;\n  flexShrink?: number | string;\n  flexBasis?: string | number;\n  alignSelf?:\n    'auto' | 'flex-start' | 'flex-end' | 'center' | 'baseline' | 'stretch' | (string & {});\n  width?: string | number;\n  height?: string | number;\n  minWidth?: string | number;\n  maxWidth?: string | number;\n  minHeight?: string | number;\n  maxHeight?: string | number;\n  objectFit?: 'fill' | 'contain' | 'cover' | 'none' | 'scale-down' | (string & {});\n  objectPosition?: string;\n  borderRadius?: string | number;\n  borderTopLeftRadius?: string | number;\n  borderTopRightRadius?: string | number;\n  borderBottomRightRadius?: string | number;\n  borderBottomLeftRadius?: string | number;\n  backdropFilter?: string;\n  filter?: string;\n  boxShadow?: string;\n  backgroundColor?: string;\n  backgroundImage?: string;\n  backgroundSize?: 'cover' | 'contain' | 'auto' | (string & {});\n  backgroundPosition?: string;\n  backgroundRepeat?: 'no-repeat' | 'repeat' | 'repeat-x' | 'repeat-y' | (string & {});\n  backgroundAttachment?: 'scroll' | 'fixed' | 'local' | (string & {});\n  gridTemplateColumns?: string;\n  gridTemplateRows?: string;\n  gridAutoFlow?: string;\n  gridAutoColumns?: string;\n  gridAutoRows?: string;\n  gridColumn?: string | number;\n  gridRow?: string | number;\n  gridColumnStart?: string | number;\n  gridColumnEnd?: string | number;\n  gridRowStart?: string | number;\n  gridRowEnd?: string | number;\n  colSpan?: number | string;\n  rowSpan?: number | string;\n  justifySelf?: string;\n}\n\nexport type PseudoStateStyles = Record<string, StyleDefinition>;\n\n/** Breakpoint style layers (`base` applies to every viewport) plus pseudo-state layers. */\nexport interface ResponsiveStyles {\n  [key: string]: unknown;\n  base?: StyleDefinition;\n  desktop?: StyleDefinition;\n  tablet?: StyleDefinition;\n  mobile?: StyleDefinition;\n  states?: Record<string, StyleDefinition>;\n}\n\nexport interface AnimationConfig {\n  type: string;\n  duration: number;\n  delay: number;\n  easing: string;\n  once: boolean;\n  hoverEffect: string;\n  loopEffect: string;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Theme (STORA-551)\n * -------------------------------------------------------------------------------------- */\n\nexport type ThemeTokenValue = string | number;\n\n/** Design tokens; referenced from styles as `var(--kb-color-<key>)` etc. */\nexport interface Theme {\n  colors?: Record<string, ThemeTokenValue>;\n  fonts?: Record<string, ThemeTokenValue>;\n  radii?: Record<string, ThemeTokenValue>;\n  spacing?: Record<string, ThemeTokenValue>;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Forms\n * -------------------------------------------------------------------------------------- */\n\nexport type ValidationRuleType =\n  | 'required'\n  | 'email'\n  | 'url'\n  | 'min_length'\n  | 'max_length'\n  | 'numeric_min'\n  | 'numeric_max'\n  | 'pattern'\n  | 'match_field'\n  | 'custom_regex';\n\nexport type ValidateOnEvent = 'blur' | 'change' | 'submit';\n\nexport interface ValidationRule {\n  type: ValidationRuleType;\n  value?: unknown;\n  message: string;\n}\n\nexport interface FormFieldBinding {\n  name: string;\n  label?: string;\n  defaultValue?: unknown;\n  rules: ValidationRule[];\n  validateOn: ValidateOnEvent;\n  transform?: 'trim' | 'lowercase' | 'uppercase' | 'number';\n  disabled?: boolean;\n  required?: boolean;\n}\n\nexport interface FormConfig {\n  formId: string;\n  resetOnSubmit: boolean;\n  scrollToFirstError: boolean;\n  validateOn: ValidateOnEvent;\n  initialValues?: Record<string, unknown>;\n  rules?: ValidationRule[];\n}\n\n/* ----------------------------------------------------------------------------------------\n * Actions\n * -------------------------------------------------------------------------------------- */\n\nexport type ActionTriggerType =\n  'click' | 'submit' | 'change' | 'blur' | 'focus' | 'load' | 'expire';\n\nexport type ActionStepType =\n  | 'api_request'\n  | 'navigate'\n  | 'set_state'\n  | 'reset_form'\n  | 'show_toast'\n  | 'open_modal'\n  | 'close_modal'\n  | 'toggle_modal'\n  | 'copy_clipboard'\n  | 'custom_event'\n  | 'track_event';\n\nexport type ConditionOperator =\n  | 'equals'\n  | 'not_equals'\n  | 'contains'\n  | 'not_contains'\n  | 'is_truthy'\n  | 'is_falsy'\n  | 'gt'\n  | 'gte'\n  | 'lt'\n  | 'lte'\n  | 'regex';\n\nexport interface ActionStepCondition {\n  field: string;\n  operator: ConditionOperator;\n  value?: unknown;\n}\n\nexport interface ActionStep {\n  id: string;\n  type: ActionStepType;\n  label?: string;\n  payload?: Record<string, unknown>;\n  condition?: ActionStepCondition;\n  timeout?: number;\n  continueOnError?: boolean;\n  onSuccess?: ActionStep[];\n  onError?: ActionStep[];\n}\n\nexport interface ActionPipeline {\n  id: string;\n  trigger: ActionTriggerType;\n  label?: string;\n  debounceMs?: number;\n  preventDuplicate?: boolean;\n  enabled: boolean;\n  steps: ActionStep[];\n}\n\n/* ----------------------------------------------------------------------------------------\n * Tracking (public ids only — secrets are host-owned)\n * -------------------------------------------------------------------------------------- */\n\nexport type TrackingProviderType = 'meta' | 'google' | 'gtm' | 'tiktok' | 'custom';\n\nexport type TrackingDelivery = 'both' | 'client_only' | 'server_only';\n\nexport interface MetaTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  pixelId: string;\n  capiEnabled: boolean;\n  testEventCode: string;\n}\n\nexport interface GoogleTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  measurementId: string;\n}\n\nexport interface GtmTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  containerId: string;\n}\n\nexport interface TikTokTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n  pixelId: string;\n  eventsApiEnabled: boolean;\n  testEventCode: string;\n}\n\nexport interface CustomTrackingProviderConfig {\n  enabled: boolean;\n  credentialId?: string;\n}\n\nexport interface TrackingConfig {\n  enabled: boolean;\n  debugMode: boolean;\n  autoPageView: boolean;\n  defaultDelivery: TrackingDelivery;\n  providers: {\n    meta?: MetaTrackingProviderConfig;\n    google?: GoogleTrackingProviderConfig;\n    gtm?: GtmTrackingProviderConfig;\n    tiktok?: TikTokTrackingProviderConfig;\n    custom?: CustomTrackingProviderConfig;\n  };\n}\n\n/* ----------------------------------------------------------------------------------------\n * Document\n * -------------------------------------------------------------------------------------- */\n\nexport interface Node {\n  id: string;\n  type: string;\n  props?: Record<string, unknown>;\n  styles?: ResponsiveStyles;\n  animation?: AnimationConfig;\n  actions?: ActionPipeline[];\n  formConfig?: FormConfig;\n  children?: Node[];\n}\n\nexport type RootPageNode = Node & { type: 'page' };\n\nexport interface DocumentMetadata {\n  title: string;\n  description: string;\n  author: string;\n  createdAt?: string;\n  updatedAt?: string;\n  tags: string[];\n  category: string;\n  version: string;\n  custom?: Record<string, unknown>;\n  tracking?: TrackingConfig;\n}\n\nexport interface PageDocument {\n  schema: 'stora.page';\n  version: string;\n  metadata?: DocumentMetadata;\n  tracking?: TrackingConfig;\n  theme?: Theme;\n  document: RootPageNode;\n}\n\nexport type ArtboardType = 'page' | 'component';\n\nexport interface Artboard {\n  id: string;\n  name: string;\n  artboardType: ArtboardType;\n  slug?: string;\n  triggerId?: string;\n  viewport?: 'desktop' | 'tablet' | 'mobile';\n  width?: number;\n  position?: { x: number; y: number };\n  document: PageDocument;\n}\n\nexport interface ProjectDocument {\n  schema: 'stora.project';\n  version: string;\n  metadata?: DocumentMetadata;\n  tracking?: TrackingConfig;\n  artboards: Artboard[];\n  activeArtboardId?: string;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Package manifest & templates\n * -------------------------------------------------------------------------------------- */\n\nexport interface ManifestAssetItem {\n  id: string;\n  path: string;\n  mimeType: string;\n  size: number;\n  checksum?: string;\n}\n\nexport interface Manifest {\n  schema: 'stora.page';\n  schemaVersion: string;\n  packageVersion: string;\n  builderCompatibility: string;\n  requiredComponents: string[];\n  requiredCapabilities: string[];\n  assets: ManifestAssetItem[];\n  createdAt?: string;\n}\n\nexport interface SafeThumbnailObject {\n  url: string;\n  alt?: string;\n  width?: number;\n  height?: number;\n}\n\nexport type SafeThumbnail = AssetReference | SafeThumbnailObject | string;\n\nexport interface TemplatePackageRef {\n  path?: string;\n  url?: string;\n  checksum?: string;\n  format: 'stora' | 'json';\n}\n\nexport interface TemplateRequirements {\n  requiredComponents: string[];\n  requiredCapabilities: string[];\n}\n\nexport interface TemplateRecord {\n  id: string;\n  name: string;\n  description: string;\n  category: string;\n  tags: string[];\n  thumbnail?: SafeThumbnail;\n  author: string;\n  version: string;\n  document?: PageDocument;\n  packageReference?: TemplatePackageRef;\n  requirements: TemplateRequirements;\n  createdAt?: string;\n  updatedAt?: string;\n  custom?: Record<string, unknown>;\n}\n\n/* ----------------------------------------------------------------------------------------\n * Zod-free validation results (see `@kubuild/schema/validate`)\n * -------------------------------------------------------------------------------------- */\n\nexport interface SchemaValidationIssue {\n  /** Dotted path to the offending value, e.g. `document.children.0.id` (empty for root). */\n  path: string;\n  message: string;\n  /** Validator issue code (e.g. `invalid_type`, `custom`). */\n  code: string;\n}\n\nexport type SchemaValidationResult<T> =\n  | { success: true; data: T; issues: [] }\n  | { success: false; data?: undefined; issues: SchemaValidationIssue[] };\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,331 @@
+/**
+ * `@kubuild/schema/types` — pure TypeScript interfaces for the portable document format
+ * (STORA-552).
+ *
+ * This module MUST NOT import zod (or any module that does). Its emitted `.d.ts` is what
+ * hosts on a different zod major (e.g. a zod v3 backend) import to type `PageDocument`,
+ * `Node`, etc. without pulling zod v4's core namespace into their compilation.
+ *
+ * Every type here mirrors the *parsed output* (`z.infer<...>`) of the matching schema in
+ * the main entry, i.e. fields with a schema default are required. The equality is
+ * enforced by `tests/types.test.ts` (`expectTypeOf(...).toEqualTypeOf(...)`), so a schema
+ * change that is not reflected here fails `pnpm run typecheck`.
+ */
+export interface AssetReference {
+    type: 'asset';
+    assetId: string;
+    filename?: string;
+    mimeType?: string;
+    fallbackUrl?: string;
+}
+export interface VariableBinding {
+    type: 'variable';
+    key: string;
+    fallback?: unknown;
+}
+export interface ActionBinding {
+    type: string;
+    payload?: Record<string, unknown>;
+}
+export type StyleValue = string | number | boolean | null | undefined;
+/**
+ * Standard CSS style definition supporting Flexbox, sizing constraints, effects,
+ * CSS Grid, and arbitrary CSS properties / design-token references.
+ */
+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 type PseudoStateStyles = Record<string, StyleDefinition>;
+/** Breakpoint style layers (`base` applies to every viewport) plus pseudo-state layers. */
+export interface ResponsiveStyles {
+    [key: string]: unknown;
+    base?: StyleDefinition;
+    desktop?: StyleDefinition;
+    tablet?: StyleDefinition;
+    mobile?: StyleDefinition;
+    states?: Record<string, StyleDefinition>;
+}
+export interface AnimationConfig {
+    type: string;
+    duration: number;
+    delay: number;
+    easing: string;
+    once: boolean;
+    hoverEffect: string;
+    loopEffect: string;
+}
+export type ThemeTokenValue = string | number;
+/** Design tokens; referenced from styles as `var(--kb-color-<key>)` etc. */
+export interface Theme {
+    colors?: Record<string, ThemeTokenValue>;
+    fonts?: Record<string, ThemeTokenValue>;
+    radii?: Record<string, ThemeTokenValue>;
+    spacing?: Record<string, ThemeTokenValue>;
+}
+export type ValidationRuleType = 'required' | 'email' | 'url' | 'min_length' | 'max_length' | 'numeric_min' | 'numeric_max' | 'pattern' | 'match_field' | 'custom_regex';
+export type ValidateOnEvent = 'blur' | 'change' | 'submit';
+export interface ValidationRule {
+    type: ValidationRuleType;
+    value?: unknown;
+    message: string;
+}
+export interface FormFieldBinding {
+    name: string;
+    label?: string;
+    defaultValue?: unknown;
+    rules: ValidationRule[];
+    validateOn: ValidateOnEvent;
+    transform?: 'trim' | 'lowercase' | 'uppercase' | 'number';
+    disabled?: boolean;
+    required?: boolean;
+}
+export interface FormConfig {
+    formId: string;
+    resetOnSubmit: boolean;
+    scrollToFirstError: boolean;
+    validateOn: ValidateOnEvent;
+    initialValues?: Record<string, unknown>;
+    rules?: ValidationRule[];
+}
+export type ActionTriggerType = 'click' | 'submit' | 'change' | 'blur' | 'focus' | 'load' | 'expire';
+export type ActionStepType = 'api_request' | 'navigate' | 'set_state' | 'reset_form' | 'show_toast' | 'open_modal' | 'close_modal' | 'toggle_modal' | 'copy_clipboard' | 'custom_event' | 'track_event';
+export type ConditionOperator = 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'is_truthy' | 'is_falsy' | 'gt' | 'gte' | 'lt' | 'lte' | 'regex';
+export interface ActionStepCondition {
+    field: string;
+    operator: ConditionOperator;
+    value?: unknown;
+}
+export interface ActionStep {
+    id: string;
+    type: ActionStepType;
+    label?: string;
+    payload?: Record<string, unknown>;
+    condition?: ActionStepCondition;
+    timeout?: number;
+    continueOnError?: boolean;
+    onSuccess?: ActionStep[];
+    onError?: ActionStep[];
+}
+export interface ActionPipeline {
+    id: string;
+    trigger: ActionTriggerType;
+    label?: string;
+    debounceMs?: number;
+    preventDuplicate?: boolean;
+    enabled: boolean;
+    steps: ActionStep[];
+}
+export type TrackingProviderType = 'meta' | 'google' | 'gtm' | 'tiktok' | 'custom';
+export type TrackingDelivery = 'both' | 'client_only' | 'server_only';
+export interface MetaTrackingProviderConfig {
+    enabled: boolean;
+    credentialId?: string;
+    pixelId: string;
+    capiEnabled: boolean;
+    testEventCode: string;
+}
+export interface GoogleTrackingProviderConfig {
+    enabled: boolean;
+    credentialId?: string;
+    measurementId: string;
+}
+export interface GtmTrackingProviderConfig {
+    enabled: boolean;
+    credentialId?: string;
+    containerId: string;
+}
+export interface TikTokTrackingProviderConfig {
+    enabled: boolean;
+    credentialId?: string;
+    pixelId: string;
+    eventsApiEnabled: boolean;
+    testEventCode: string;
+}
+export interface CustomTrackingProviderConfig {
+    enabled: boolean;
+    credentialId?: string;
+}
+export interface TrackingConfig {
+    enabled: boolean;
+    debugMode: boolean;
+    autoPageView: boolean;
+    defaultDelivery: TrackingDelivery;
+    providers: {
+        meta?: MetaTrackingProviderConfig;
+        google?: GoogleTrackingProviderConfig;
+        gtm?: GtmTrackingProviderConfig;
+        tiktok?: TikTokTrackingProviderConfig;
+        custom?: CustomTrackingProviderConfig;
+    };
+}
+export interface Node {
+    id: string;
+    type: string;
+    props?: Record<string, unknown>;
+    styles?: ResponsiveStyles;
+    animation?: AnimationConfig;
+    actions?: ActionPipeline[];
+    formConfig?: FormConfig;
+    children?: Node[];
+}
+export type RootPageNode = Node & {
+    type: 'page';
+};
+export interface DocumentMetadata {
+    title: string;
+    description: string;
+    author: string;
+    createdAt?: string;
+    updatedAt?: string;
+    tags: string[];
+    category: string;
+    version: string;
+    custom?: Record<string, unknown>;
+    tracking?: TrackingConfig;
+}
+export interface PageDocument {
+    schema: 'stora.page';
+    version: string;
+    metadata?: DocumentMetadata;
+    tracking?: TrackingConfig;
+    theme?: Theme;
+    document: RootPageNode;
+}
+export type ArtboardType = 'page' | 'component';
+export interface Artboard {
+    id: string;
+    name: string;
+    artboardType: ArtboardType;
+    slug?: string;
+    triggerId?: string;
+    viewport?: 'desktop' | 'tablet' | 'mobile';
+    width?: number;
+    position?: {
+        x: number;
+        y: number;
+    };
+    document: PageDocument;
+}
+export interface ProjectDocument {
+    schema: 'stora.project';
+    version: string;
+    metadata?: DocumentMetadata;
+    tracking?: TrackingConfig;
+    artboards: Artboard[];
+    activeArtboardId?: string;
+}
+export interface ManifestAssetItem {
+    id: string;
+    path: string;
+    mimeType: string;
+    size: number;
+    checksum?: string;
+}
+export interface Manifest {
+    schema: 'stora.page';
+    schemaVersion: string;
+    packageVersion: string;
+    builderCompatibility: string;
+    requiredComponents: string[];
+    requiredCapabilities: string[];
+    assets: ManifestAssetItem[];
+    createdAt?: string;
+}
+export interface SafeThumbnailObject {
+    url: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+}
+export type SafeThumbnail = AssetReference | SafeThumbnailObject | string;
+export interface TemplatePackageRef {
+    path?: string;
+    url?: string;
+    checksum?: string;
+    format: 'stora' | 'json';
+}
+export interface TemplateRequirements {
+    requiredComponents: string[];
+    requiredCapabilities: string[];
+}
+export interface TemplateRecord {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+    tags: string[];
+    thumbnail?: SafeThumbnail;
+    author: string;
+    version: string;
+    document?: PageDocument;
+    packageReference?: TemplatePackageRef;
+    requirements: TemplateRequirements;
+    createdAt?: string;
+    updatedAt?: string;
+    custom?: Record<string, unknown>;
+}
+export interface SchemaValidationIssue {
+    /** Dotted path to the offending value, e.g. `document.children.0.id` (empty for root). */
+    path: string;
+    message: string;
+    /** Validator issue code (e.g. `invalid_type`, `custom`). */
+    code: string;
+}
+export type SchemaValidationResult<T> = {
+    success: true;
+    data: T;
+    issues: [];
+} | {
+    success: false;
+    data?: undefined;
+    issues: SchemaValidationIssue[];
+};
+//# sourceMappingURL=types.d.ts.map