@kubuild/schema 0.0.1

package/dist/document.d.ts

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+export declare const SCHEMA_NAME: "stora.page";
+export declare const CURRENT_SCHEMA_VERSION: "1.0.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 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>;
+/**
+ * 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 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.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]>>>>;
+}, z.core.$catchall<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodUndefined]>>>>>;
+export type ResponsiveStyles = z.infer<typeof ResponsiveStylesSchema>;
+/**
+ * Recursive Node Type Definition
+ */
+export type Node = {
+    id: string;
+    type: string;
+    props?: Record<string, unknown>;
+    styles?: ResponsiveStyles;
+    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>>;
+}, 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
+ */
+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>>;
+    }, z.core.$strip>>;
+    document: z.ZodType<RootPageNode, unknown, z.core.$ZodTypeInternals<RootPageNode, unknown>>;
+}, z.core.$strip>;
+export type PageDocument = z.infer<typeof PageDocumentSchema>;
+/**
+ * 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;
+/**
+ * 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.ts.map

package/dist/document.d.ts.map

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

package/dist/fixtures.d.ts

@@ -0,0 +1,3 @@
+import { PageDocument } from './document';
+export declare const starterPageFixture: PageDocument;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,kBAAkB,EAAE,YAAyD,CAAC"}