@kubuild/core 0.0.1

package/dist/binding-resolver.d.ts

@@ -0,0 +1,16 @@
+import type { VariableBinding } from '@kubuild/schema';
+import type { RuntimeContext } from './interfaces';
+export type ResolveOutcome = {
+    status: 'resolved';
+    value: unknown;
+} | {
+    status: 'fallback';
+    value: unknown;
+} | {
+    status: 'empty';
+    value: '';
+};
+export declare function resolveBinding(binding: Pick<VariableBinding, 'key' | 'fallback'>, context: RuntimeContext | undefined): ResolveOutcome;
+/** Convenience wrapper returning just the resolved/fallback/empty value. */
+export declare function resolveBindingValue(binding: Pick<VariableBinding, 'key' | 'fallback'>, context: RuntimeContext | undefined): unknown;
+//# sourceMappingURL=binding-resolver.d.ts.map

package/dist/binding-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-resolver.d.ts","sourceRoot":"","sources":["../src/binding-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,EAAE,CAAA;CAAE,CAAC;AAInC,wBAAgB,cAAc,CAC5B,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,UAAU,CAAC,EAClD,OAAO,EAAE,cAAc,GAAG,SAAS,GAClC,cAAc,CAsBhB;AASD,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,UAAU,CAAC,EAClD,OAAO,EAAE,cAAc,GAAG,SAAS,GAClC,OAAO,CAET"}

package/dist/command-tree-utils.d.ts

@@ -0,0 +1,60 @@
+import { Node } from '@kubuild/schema';
+/**
+ * Deep clone an object immutably (JSON-safe).
+ */
+export declare function deepClone<T>(val: T): T;
+export interface NodeLocation {
+    node: Node;
+    parent: Node | null;
+    index: number;
+}
+/**
+ * Find a node, its parent, and index within the parent's children array.
+ */
+export declare function findNodeLocation(root: Node, targetId: string): NodeLocation | null;
+export type NavigationDirection = 'parent' | 'child' | 'previous-sibling' | 'next-sibling';
+/**
+ * Resolve the node id reached by moving from `nodeId` in a tree-navigation direction.
+ * Returns null when there is nowhere to go (e.g. root has no parent, a leaf has no child,
+ * or the node sits at the start/end of its sibling list).
+ */
+export declare function getNavigationTarget(root: Node, nodeId: string, direction: NavigationDirection): string | null;
+/**
+ * Returns the chain of ancestor node ids from the root down to (but excluding)
+ * `targetId`, root first. Returns [] if targetId is the root or is not found.
+ */
+export declare function getAncestorChain(root: Node, targetId: string): string[];
+/**
+ * STORA-232: Find the direct parent node of `targetId` in a single O(N) traversal.
+ * Returns null when the target is the root or is not found in the tree.
+ */
+export declare function getParentNodeId(root: Node, targetId: string): string | null;
+/**
+ * STORA-232: Return the full ancestor path of `targetId` as an array of nodes,
+ * ordered from the root down to (and including) the target node itself.
+ * Single O(N) traversal: the path is tracked during descent, so no re-walks.
+ * Returns [] when the target is not found.
+ */
+export declare function getNodeAncestors(root: Node, targetId: string): Node[];
+/**
+ * Check whether `targetId` is a descendant of `ancestorNode` (or equal to ancestorNode.id).
+ */
+export declare function isDescendantOf(ancestorNode: Node, targetId: string): boolean;
+/**
+ * Collect all node IDs present in a node subtree as a Set.
+ */
+export declare function collectNodeIdSet(root: Node): Set<string>;
+/**
+ * Default unique ID generator function for node duplication.
+ */
+export declare function defaultIdGenerator(oldId: string, existingIds?: Set<string>): string;
+export interface ClonedSubtreeResult {
+    clonedNode: Node;
+    idMap: Map<string, string>;
+}
+/**
+ * Recursively clone a node and its entire subtree, generating fresh unique IDs
+ * for every node while preserving types, props, and responsive styles.
+ */
+export declare function cloneTreeWithNewIds(root: Node, idGenerator?: (oldId: string) => string, existingIds?: Set<string>): ClonedSubtreeResult;
+//# sourceMappingURL=command-tree-utils.d.ts.map

package/dist/command-tree-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-tree-utils.d.ts","sourceRoot":"","sources":["../src/command-tree-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAkB,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEtC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAUlF;AA0BD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,mBAAmB,GAC7B,MAAM,GAAG,IAAI,CAkBf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc3E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAgBrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgB5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAenF;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EACvC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,mBAAmB,CAyBrB"}

package/dist/commands.d.ts

@@ -0,0 +1,99 @@
+import { PageDocument, Node, ResponsiveStyles, StyleDefinition } from '@kubuild/schema';
+export type DocumentChangeType = 'NODE_INSERTED' | 'NODE_MOVED' | 'PROPS_UPDATED' | 'STYLE_UPDATED' | 'NODE_REMOVED' | 'NODE_DUPLICATED';
+export interface DocumentChangeEvent {
+    type: DocumentChangeType;
+    timestamp: string;
+    nodeId: string;
+    parentId?: string;
+    previousParentId?: string;
+    index?: number;
+    previousIndex?: number;
+    payload?: Record<string, unknown>;
+}
+export interface CommandResult {
+    document: PageDocument;
+    event: DocumentChangeEvent;
+}
+export interface InsertNodeParams {
+    parentId: string;
+    node: Node;
+    index?: number;
+}
+export interface MoveNodeParams {
+    nodeId: string;
+    targetParentId: string;
+    index?: number;
+}
+export interface UpdatePropsParams {
+    nodeId: string;
+    props: Record<string, unknown>;
+    /**
+     * If true (default), shallow merges new props with existing props.
+     * If false, replaces the entire props object.
+     */
+    merge?: boolean;
+}
+export interface UpdateStyleParams {
+    nodeId: string;
+    styles: ResponsiveStyles | StyleDefinition;
+    /**
+     * Target breakpoint to update directly, or if omitted, applies to whole ResponsiveStyles structure.
+     */
+    breakpoint?: 'base' | 'desktop' | 'tablet' | 'mobile';
+    /**
+     * Target pseudo-state layer (e.g. ':hover', ':active', ':focus') — STORA-221.
+     * When set, `styles` is written to `node.styles.states[state]` instead of a
+     * breakpoint layer, leaving default (breakpoint) values untouched.
+     */
+    state?: string;
+    /**
+     * If true (default), shallow merges style definitions at target breakpoint.
+     * If false, replaces the style definition object.
+     */
+    merge?: boolean;
+}
+export interface RemoveNodeParams {
+    nodeId: string;
+}
+export interface DuplicateNodeParams {
+    nodeId: string;
+    targetParentId?: string;
+    index?: number;
+    idGenerator?: (oldId: string) => string;
+}
+/**
+ * 1. Insert a node into a target parent node.
+ * Returns a new PageDocument and a NODE_INSERTED event.
+ */
+export declare function insertNode(document: PageDocument, params: InsertNodeParams): CommandResult;
+/**
+ * 2. Move a node from its current location to a new parent location.
+ * Prevents moving the root node or moving a node into its own descendant tree.
+ * Returns a new PageDocument and a NODE_MOVED event.
+ */
+export declare function moveNode(document: PageDocument, params: MoveNodeParams): CommandResult;
+/**
+ * 3. Update the props of an existing node.
+ * Returns a new PageDocument and a PROPS_UPDATED event.
+ */
+export declare function updateProps(document: PageDocument, params: UpdatePropsParams): CommandResult;
+/**
+ * 4. Update the responsive styles of an existing node.
+ * Supports updating a specific breakpoint ('base', 'desktop', etc.) or the whole ResponsiveStyles object.
+ * Returns a new PageDocument and a STYLE_UPDATED event.
+ */
+export declare function updateStyle(document: PageDocument, params: UpdateStyleParams): CommandResult;
+/**
+ * 5. Remove a node from the document tree.
+ * Prevents removing the root page node.
+ * Returns a new PageDocument and a NODE_REMOVED event.
+ */
+export declare function removeNode(document: PageDocument, params: RemoveNodeParams): CommandResult;
+/**
+ * 6. Duplicate a node and its entire subtree.
+ * Generates fresh unique IDs for all cloned nodes in the subtree, preserves props/styles,
+ * and inserts the duplicate right after the original node (or at specified targetParentId/index).
+ * Returns a new PageDocument and a NODE_DUPLICATED event.
+ */
+export declare function duplicateNode(document: PageDocument, params: DuplicateNodeParams): CommandResult;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,gBAAgB,EAChB,eAAe,EAGhB,MAAM,iBAAiB,CAAC;AASzB,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,YAAY,GACZ,eAAe,GACf,eAAe,GACf,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAAC;IAC3C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,gBAAgB,GACvB,aAAa,CAgDf;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,cAAc,GACrB,aAAa,CAyDf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,iBAAiB,GACxB,aAAa,CAsCf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,iBAAiB,GACxB,aAAa,CAgHf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,gBAAgB,GACvB,aAAa,CA+Bf;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,mBAAmB,GAC1B,aAAa,CAqDf"}

package/dist/document-utils.d.ts

@@ -0,0 +1,51 @@
+import { PageDocument, Node } from '@kubuild/schema';
+import type { ComponentRegistryLike } from './validator';
+export { validateDocument } from './validator';
+export type { DocumentValidationResult, DocumentValidationError, DocumentValidationErrorCode, ValidationOptions, ComponentDefinitionLike, ComponentRegistryLike, } from './validator';
+export declare function createBlankDocument(title?: string): PageDocument;
+export declare function findNodeById(rootNode: Node, targetId: string): Node | null;
+export interface CollectedAssetReference {
+    assetId: string;
+    reference: {
+        type: 'asset';
+        assetId: string;
+        filename?: string;
+        mimeType?: string;
+        fallbackUrl?: string;
+    };
+    nodeId: string;
+    propPath: string;
+}
+/**
+ * Collect all AssetReference objects throughout a document tree.
+ */
+export declare function collectAssetReferences(rootNode: Node): CollectedAssetReference[];
+export interface TreeRequirements {
+    requiredComponents: string[];
+    requiredCapabilities: string[];
+}
+/**
+ * Extracts custom component types and capabilities required by a node tree.
+ */
+export declare function extractRequirementsFromTree(rootNode: Node, registry?: ComponentRegistryLike): TreeRequirements;
+/**
+ * Remap asset references in a node tree based on an ID mapping dictionary.
+ * Mutates the node props in place and returns the number of references updated.
+ */
+export declare function remapAssetReferences(rootNode: Node, idMap: Record<string, string> | Map<string, string>): number;
+/**
+ * Remaps all asset references throughout a PageDocument.
+ */
+export declare function remapDocumentAssetReferences(doc: PageDocument, idMap: Record<string, string> | Map<string, string>): PageDocument;
+export interface MissingComponentNodeInfo {
+    nodeId: string;
+    componentType: string;
+    props: Record<string, unknown>;
+    node: Node;
+}
+/**
+ * Finds all nodes in a node tree that reference component types not registered in the host.
+ * This is useful in placeholder mode to inspect missing nodes and their preserved props.
+ */
+export declare function findMissingComponentNodes(rootNode: Node, registry?: ComponentRegistryLike, knownTypes?: string[] | Set<string>): MissingComponentNodeInfo[];
+//# sourceMappingURL=document-utils.d.ts.map

package/dist/document-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-utils.d.ts","sourceRoot":"","sources":["../src/document-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAe,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,wBAAgB,mBAAmB,CAAC,KAAK,SAAkB,GAAG,YAAY,CAsBzE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAQ1E;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QACT,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,IAAI,GAAG,uBAAuB,EAAE,CAkDhF;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,IAAI,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,gBAAgB,CA8BlB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,IAAI,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClD,MAAM,CA+CR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClD,YAAY,CAKd;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,IAAI,EACd,QAAQ,CAAC,EAAE,qBAAqB,EAChC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAClC,wBAAwB,EAAE,CA6C5B"}

package/dist/exporter.d.ts

@@ -0,0 +1,89 @@
+import { PageDocument, DocumentMetadata, Manifest } from '@kubuild/schema';
+import { DocumentValidationError, ValidationOptions, ComponentRegistryLike } from './validator';
+import { CollectedAssetReference } from './document-utils';
+import type { AssetProvider } from './interfaces';
+export interface ExportAssetData {
+    data: Uint8Array | ArrayBuffer | Blob | string;
+    mimeType?: string;
+    filename?: string;
+}
+export type AssetBytesProvider = (assetId: string, assetRef: CollectedAssetReference) => Promise<Uint8Array | ArrayBuffer | Blob | string | ExportAssetData | null | undefined> | Uint8Array | ArrayBuffer | Blob | string | ExportAssetData | null | undefined;
+export interface ExportPackageOptions {
+    /**
+     * Component registry to validate document components and extract requirements.
+     */
+    componentRegistry?: ComponentRegistryLike;
+    /**
+     * Known component types if registry is not passed.
+     */
+    knownComponentTypes?: string[] | Set<string>;
+    /**
+     * Directly supplied asset binary map (keyed by assetId).
+     */
+    assets?: Record<string, Uint8Array | ArrayBuffer | Blob | string | ExportAssetData> | Map<string, Uint8Array | ArrayBuffer | Blob | string | ExportAssetData>;
+    /**
+     * Host function to retrieve asset binary data dynamically.
+     */
+    getAssetBytes?: AssetBytesProvider;
+    /**
+     * Host AssetProvider instance to resolve assets if bytes provider is not present.
+     */
+    assetProvider?: AssetProvider;
+    /**
+     * Package version to write in manifest (defaults to "1.0.0").
+     */
+    packageVersion?: string;
+    /**
+     * Builder compatibility semver range (defaults to ">=0.1.0").
+     */
+    builderCompatibility?: string;
+    /**
+     * If true, assets that have a fallbackUrl or are externally hosted will not cause export failure if local bytes are missing.
+     * If false and a referenced asset has no bytes available, export fails.
+     */
+    allowExternalFallback?: boolean;
+    /**
+     * Additional validation options passed to validateDocument.
+     */
+    validationOptions?: ValidationOptions;
+    /**
+     * Optional metadata overrides (e.g. author, tags).
+     */
+    metadata?: Partial<DocumentMetadata>;
+}
+export interface ExportPackageSuccess {
+    success: true;
+    archive: Uint8Array;
+    manifest: Manifest;
+    page: PageDocument;
+    metadata: DocumentMetadata;
+    assetCount: number;
+}
+export interface ExportPackageFailure {
+    success: false;
+    errors: DocumentValidationError[];
+    diagnosticMessage: string;
+}
+export type ExportPackageResult = ExportPackageSuccess | ExportPackageFailure;
+/**
+ * Pure TypeScript SHA-256 implementation (zero native dependencies, deterministic).
+ */
+export declare function sha256Sync(data: Uint8Array): string;
+/**
+ * Compute SHA-256 checksum with "sha256:" prefix.
+ */
+export declare function calculateChecksum(data: Uint8Array): Promise<string>;
+/**
+ * Sanitize asset file names to prevent zip-slip or directory traversal vulnerabilities.
+ */
+export declare function sanitizeFilename(filename: string | undefined, assetId: string, mimeType?: string): string;
+/**
+ * Validates document, collects asset references, resolves local asset bytes,
+ * writes manifest.json, page.json, metadata.json, and packages everything into a .stora archive.
+ */
+export declare function exportPackage(document: unknown, options?: ExportPackageOptions): Promise<ExportPackageResult>;
+/**
+ * Alias for exportPackage.
+ */
+export declare const exportStoraPackage: typeof exportPackage;
+//# sourceMappingURL=exporter.d.ts.map

package/dist/exporter.d.ts.map

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

package/dist/history.d.ts

@@ -0,0 +1,107 @@
+import { PageDocument } from '@kubuild/schema';
+import { DocumentChangeEvent, CommandResult } from './commands';
+export interface HistoryOptions {
+    /**
+     * Maximum number of historical states stored in the undo stack.
+     * Defaults to 50.
+     */
+    maxHistory?: number;
+}
+export interface HistoryEntry<T> {
+    state: T;
+    event?: DocumentChangeEvent;
+    timestamp: string;
+}
+export interface HistoryState<T> {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoCount: number;
+    redoCount: number;
+    present: T;
+}
+export declare const DEFAULT_MAX_HISTORY = 50;
+/**
+ * Generic History Engine for immutable state transitions.
+ * Maintains undo/redo stacks, enforces maximum history limit,
+ * clears redo stack on new actions, and supports resetting state.
+ */
+export declare class HistoryEngine<T = PageDocument> {
+    private past;
+    private current;
+    private future;
+    private readonly maxHistory;
+    constructor(initialState: T, options?: HistoryOptions);
+    /**
+     * Get the current active state (returns an immutable clone).
+     */
+    get present(): T;
+    /**
+     * Check if undo is available.
+     */
+    canUndo(): boolean;
+    /**
+     * Check if redo is available.
+     */
+    canRedo(): boolean;
+    /**
+     * Get total number of states in undo stack.
+     */
+    get undoCount(): number;
+    /**
+     * Get total number of states in redo stack.
+     */
+    get redoCount(): number;
+    /**
+     * Get max history limit.
+     */
+    get limit(): number;
+    /**
+     * Push a new state.
+     * Clears the redo stack and shifts oldest past entries if maxHistory is exceeded.
+     */
+    push(nextState: T, event?: DocumentChangeEvent): void;
+    /**
+     * Undo to the previous state.
+     * Returns the restored state, or undefined if undo is not possible.
+     */
+    undo(): T | undefined;
+    /**
+     * Redo to the next state in future stack.
+     * Returns the restored state, or undefined if redo is not possible.
+     */
+    redo(): T | undefined;
+    /**
+     * Reset the history engine with a new initial state.
+     * Clears both undo and redo stacks (e.g. when loading a new document).
+     */
+    reset(newState: T): void;
+    /**
+     * Clear both past and future stacks without changing the current state.
+     */
+    clear(): void;
+    /**
+     * Get a snapshot of current history status.
+     */
+    getState(): HistoryState<T>;
+}
+/**
+ * Document History Manager for PageDocument.
+ * Connects HistoryEngine with core command execution.
+ */
+export declare class DocumentHistoryManager {
+    private history;
+    constructor(initialDocument: PageDocument, options?: HistoryOptions);
+    get document(): PageDocument;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    /**
+     * Execute a mutation command immutably and record the resulting state and change event in history.
+     */
+    execute(executor: (currentDoc: PageDocument) => CommandResult): CommandResult;
+    undo(): PageDocument | undefined;
+    redo(): PageDocument | undefined;
+    reset(newDocument: PageDocument): void;
+    clear(): void;
+    getState(): HistoryState<PageDocument>;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhE,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,YAAY;IACzC,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,YAAY,EAAE,CAAC,EAAE,OAAO,GAAE,cAAmB;IAiBzD;;OAEG;IACH,IAAI,OAAO,IAAI,CAAC,CAEf;IAED;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAwBrD;;;OAGG;IACH,IAAI,IAAI,CAAC,GAAG,SAAS;IAYrB;;;OAGG;IACH,IAAI,IAAI,CAAC,GAAG,SAAS;IAYrB;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI;IAaxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC;CAS5B;AAED;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAA8B;gBAEjC,eAAe,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc;IAInE,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,KAAK,aAAa,GAAG,aAAa;IAO7E,IAAI,IAAI,YAAY,GAAG,SAAS;IAIhC,IAAI,IAAI,YAAY,GAAG,SAAS;IAIhC,KAAK,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI;IAItC,KAAK,IAAI,IAAI;IAIb,QAAQ,IAAI,YAAY,CAAC,YAAY,CAAC;CAGvC"}