@kubuild/core 0.8.1 → 0.8.2

package/dist/io/round-trip-comparator.d.cts

@@ -0,0 +1,38 @@
+import { PageDocument, Manifest } from '@kubuild/schema';
+export type SemanticDifferenceKind = 'METADATA_MISMATCH' | 'NODE_MISSING' | 'NODE_EXTRA' | 'NODE_ORDER' | 'NODE_TYPE' | 'PROP_MISMATCH' | 'STYLE_MISMATCH' | 'BINDING_MISMATCH' | 'ACTION_MISMATCH' | 'ASSET_MISMATCH' | 'DEPENDENCY_MISMATCH';
+export interface SemanticDifference {
+    path: string;
+    kind: SemanticDifferenceKind;
+    message: string;
+    expected?: unknown;
+    actual?: unknown;
+}
+export interface SemanticCompareOptions {
+    /**
+     * Optional map of original asset IDs to host-remapped asset IDs.
+     * Used when host renamed colliding assets during import.
+     */
+    assetIdMap?: Record<string, string> | Map<string, string>;
+    /**
+     * Whether to ignore transient timestamp fields (e.g. createdAt/updatedAt).
+     * Default: true.
+     */
+    ignoreTimestamps?: boolean;
+}
+export interface SemanticComparisonResult {
+    equivalent: boolean;
+    differences: SemanticDifference[];
+}
+/**
+ * Semantically compares two PageDocuments, checking metadata, tree structure,
+ * node order, props, responsive styles, bindings, action references, and asset mappings.
+ *
+ * Only documented transient fields (e.g. transient timestamps, host-generated asset IDs)
+ * are ignored or normalized per options.
+ */
+export declare function compareDocumentsSemantically(expected: PageDocument, actual: PageDocument, options?: SemanticCompareOptions): SemanticComparisonResult;
+/**
+ * Semantically compares exported and imported package manifests.
+ */
+export declare function compareManifestsSemantically(expected: Manifest, actual: Manifest, options?: SemanticCompareOptions): SemanticComparisonResult;
+//# sourceMappingURL=round-trip-comparator.d.cts.map

package/dist/io/round-trip-comparator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-trip-comparator.d.cts","sourceRoot":"","sources":["../../src/io/round-trip-comparator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAIZ,QAAQ,EAIT,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,sBAAsB,GAC9B,mBAAmB,GACnB,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1D;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAiYD;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,sBAA2B,GACnC,wBAAwB,CA2D1B;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,EAChB,OAAO,GAAE,sBAA2B,GACnC,wBAAwB,CAuF1B"}

package/dist/io/template-utils.d.cts

@@ -0,0 +1,129 @@
+import { type TemplateRecord, type TemplateRequirements, type PageDocument, type Node } from '@kubuild/schema';
+/**
+ * Built-in component types (everything `createDefaultComponentRegistry()` registers).
+ * Derived from the canonical `BUILTIN_COMPONENT_TYPES` in `@kubuild/schema`; a test in
+ * `@kubuild/components` asserts this set equals the default registry's types.
+ */
+export declare const CORE_BUILTIN_COMPONENTS: ReadonlySet<string>;
+/**
+ * Structured validation error entry
+ */
+export interface TemplateValidationError {
+    code: string;
+    message: string;
+    path: string;
+}
+/**
+ * Result of template record validation
+ */
+export interface TemplateValidationResult {
+    valid: boolean;
+    data?: TemplateRecord;
+    errors?: TemplateValidationError[];
+}
+/**
+ * Validates a template record value against TemplateRecordSchema and returns structured errors.
+ */
+export declare function validateTemplate(value: unknown): TemplateValidationResult;
+/**
+ * Extracts required components and capabilities from a PageDocument.
+ * Detects any custom/non-core component types used in the document tree.
+ */
+export declare function extractTemplateRequirements(doc: PageDocument, builtinComponents?: ReadonlySet<string>): TemplateRequirements;
+/**
+ * Parameters for creating a TemplateRecord
+ */
+export interface CreateTemplateParams {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    thumbnail?: TemplateRecord['thumbnail'];
+    author?: string;
+    version?: string;
+    document?: PageDocument;
+    packageReference?: TemplateRecord['packageReference'];
+    requirements?: TemplateRequirements;
+    createdAt?: string;
+    updatedAt?: string;
+    custom?: Record<string, unknown>;
+}
+/**
+ * Creates and validates a TemplateRecord.
+ * Automatically extracts requirements from the embedded document if requirements are not explicitly supplied.
+ */
+export declare function createTemplateRecord(params: CreateTemplateParams): TemplateRecord;
+/**
+ * Required metadata parameters for saving a draft as a template.
+ * id and name are strictly required and non-empty.
+ */
+export interface SaveTemplateMetadata {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    thumbnail?: TemplateRecord['thumbnail'];
+    author?: string;
+    version?: string;
+    custom?: Record<string, unknown>;
+}
+export interface SaveDraftAsTemplateOptions {
+    validateDraft?: boolean;
+    requirements?: TemplateRequirements;
+}
+/**
+ * Exports a draft document snapshot as an immutable reusable TemplateRecord.
+ * - Requires mandatory metadata (id, name).
+ * - Validates draft document structure.
+ * - Extracts component/capability requirements.
+ * - Creates a deep-cloned immutable snapshot completely decoupled from the active draft.
+ */
+export declare function saveDraftAsTemplate(draft: PageDocument, metadata: SaveTemplateMetadata, options?: SaveDraftAsTemplateOptions): TemplateRecord;
+/**
+ * Options for cloning/instantiating a template into a new page document.
+ */
+export interface CloneTemplateOptions {
+    /**
+     * Title for the newly created page document. Defaults to template name or document title.
+     */
+    title?: string;
+    /**
+     * Author for the newly created page document.
+     */
+    author?: string;
+    /**
+     * Optional custom ID generator function for node duplication.
+     */
+    idGenerator?: (oldId: string, node: Node) => string;
+    /**
+     * Custom ID prefix for freshly generated node IDs. Defaults to random string / timestamp.
+     */
+    idPrefix?: string;
+    /**
+     * Whether to record origin template metadata in metadata.custom.originTemplate (defaults to true).
+     */
+    recordOrigin?: boolean;
+    /**
+     * Additional custom metadata for the new document.
+     */
+    customMetadata?: Record<string, unknown>;
+}
+/**
+ * Clones a template (or existing document) into a brand new PageDocument.
+ * - Generates ALL NEW node IDs across the entire tree (root page node and all children).
+ * - Deep-copies every other node field (props, styles, animation, actions, formConfig) and
+ *   remaps node-id references inside the tree (e.g. `modalNodeId`, `formId`) to the new ids;
+ *   references to ids outside the tree are left untouched.
+ * - Ensures 100% ID difference from the source template.
+ * - Sets fresh creation/update timestamps.
+ * - Preserves origin template version/id in custom metadata.
+ * - Guarantees full memory and reference isolation from the template source.
+ */
+export declare function cloneTemplateAsPage(templateOrDoc: TemplateRecord | PageDocument, options?: CloneTemplateOptions): PageDocument;
+/**
+ * Helper to verify that two PageDocuments share ZERO overlapping node IDs.
+ */
+export declare function areNodeIdsCompletelyDistinct(docA: PageDocument, docB: PageDocument): boolean;
+//# sourceMappingURL=template-utils.d.cts.map

package/dist/io/template-utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-utils.d.cts","sourceRoot":"","sources":["../../src/io/template-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,IAAI,EACV,MAAM,iBAAiB,CAAC;AAIzB;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAA4C,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAoBzE;AAgBD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,YAAY,EACjB,iBAAiB,GAAE,WAAW,CAAC,MAAM,CAA2B,GAC/D,oBAAoB,CAiBtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,gBAAgB,CAAC,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACtD,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAgCjF;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,0BAA+B,GACvC,cAAc,CA2ChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IACpD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,cAAc,GAAG,YAAY,EAC5C,OAAO,GAAE,oBAAyB,GACjC,YAAY,CAmFd;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAW5F"}

package/dist/io/tracking-sanitizer.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Removes host-owned secret / destination fields (e.g. Meta `capiAccessToken`, TikTok
+ * `accessToken`, GA4 `measurementProtocolSecret`, `serverRelayUrl`, custom `endpointUrl` /
+ * `headers`) from a tracking config object IN PLACE.
+ *
+ * Returns the dotted paths (relative to the tracking object) of every field removed.
+ * Safe on untrusted input: non-object values are ignored.
+ */
+export declare function stripTrackingSecretsInPlace(tracking: unknown, basePath?: string): string[];
+/**
+ * Strips tracking secrets from every place a document (page or project) can carry a
+ * tracking config: `tracking`, `metadata.tracking`, and each `artboards[i].document.tracking`.
+ * Mutates `doc` in place; pass a clone if the original must be preserved.
+ */
+export declare function stripDocumentTrackingSecretsInPlace(doc: unknown): string[];
+/**
+ * Non-mutating variant: returns a sanitized deep copy plus the removed field paths.
+ */
+export declare function sanitizeDocumentTracking<T>(doc: T): {
+    document: T;
+    removed: string[];
+};
+//# sourceMappingURL=tracking-sanitizer.d.cts.map

package/dist/io/tracking-sanitizer.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-sanitizer.d.cts","sourceRoot":"","sources":["../../src/io/tracking-sanitizer.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,SAAa,GAAG,MAAM,EAAE,CAkB9F;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CA0B1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG;IAAE,QAAQ,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAKtF"}

package/dist/runtime/binding-resolver.d.cts

@@ -0,0 +1,16 @@
+import type { VariableBinding } from '@kubuild/schema';
+import type { RuntimeContext } from '../types/interfaces.cjs';
+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.cts.map

package/dist/runtime/binding-resolver.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-resolver.d.cts","sourceRoot":"","sources":["../../src/runtime/binding-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQ7D,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,CAsChB;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/runtime/binding-resolver.d.ts

@@ -1,5 +1,5 @@
 import type { VariableBinding } from '@kubuild/schema';
-import type { RuntimeContext } from '../types/interfaces';
+import type { RuntimeContext } from '../types/interfaces.js';
 export type ResolveOutcome = {
     status: 'resolved';
     value: unknown;

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

@@ -1 +1 @@
-{"version":3,"file":"binding-resolver.d.ts","sourceRoot":"","sources":["../../src/runtime/binding-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQ1D,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,CAsChB;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"}
+{"version":3,"file":"binding-resolver.d.ts","sourceRoot":"","sources":["../../src/runtime/binding-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQ7D,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,CAsChB;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/runtime/conditional-resolver.d.cts

@@ -0,0 +1,45 @@
+import type { ActionStepCondition, ConditionOperator } from '@kubuild/schema';
+/**
+ * Extended condition operators supported by the evaluator.
+ */
+export type ExtendedConditionOperator = ConditionOperator | 'starts_with' | 'ends_with' | 'is_empty' | 'is_not_empty' | 'in' | 'not_in';
+/**
+ * Options for fine-tuning condition evaluation.
+ */
+export interface ConditionEvaluationOptions {
+    caseInsensitive?: boolean;
+    trimStrings?: boolean;
+}
+/**
+ * Represents a group of conditions evaluated together using AND / OR combinators.
+ */
+export interface ConditionGroup {
+    combinator: 'and' | 'or';
+    conditions: (ActionStepCondition | ConditionGroup)[];
+}
+/**
+ * Type guard to check if a condition item is a ConditionGroup.
+ */
+export declare function isConditionGroup(item: ActionStepCondition | ConditionGroup): item is ConditionGroup;
+/**
+ * Checks whether a given value is considered empty.
+ * Returns true for undefined, null, empty string, empty array, or empty object.
+ */
+export declare function isValueEmpty(value: unknown): boolean;
+/**
+ * Evaluates an operator against an actual value and an optional expected value.
+ */
+export declare function evaluateOperator(operator: ExtendedConditionOperator | string, actual: unknown, expected?: unknown, options?: ConditionEvaluationOptions): boolean;
+/**
+ * Resolves a field value from context and evaluates a single ActionStepCondition.
+ */
+export declare function evaluateCondition(condition: ActionStepCondition | undefined, context: Record<string, unknown>, options?: ConditionEvaluationOptions): boolean;
+/**
+ * Evaluates a ConditionGroup (AND / OR group with nested conditions).
+ */
+export declare function evaluateConditionGroup(group: ConditionGroup, context: Record<string, unknown>, options?: ConditionEvaluationOptions): boolean;
+/**
+ * Evaluates a list of conditions and/or condition groups using a given combinator ('and' | 'or').
+ */
+export declare function evaluateConditions(conditions: (ActionStepCondition | ConditionGroup)[], context: Record<string, unknown>, combinator?: 'and' | 'or', options?: ConditionEvaluationOptions): boolean;
+//# sourceMappingURL=conditional-resolver.d.cts.map

package/dist/runtime/conditional-resolver.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-resolver.d.cts","sourceRoot":"","sources":["../../src/runtime/conditional-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAG9E;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACjC,iBAAiB,GACjB,aAAa,GACb,WAAW,GACX,UAAU,GACV,cAAc,GACd,IAAI,GACJ,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,CAAC,mBAAmB,GAAG,cAAc,CAAC,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,mBAAmB,GAAG,cAAc,GACzC,IAAI,IAAI,cAAc,CAExB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAcpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,yBAAyB,GAAG,MAAM,EAC5C,MAAM,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CA+IT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,mBAAmB,GAAG,SAAS,EAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAsBT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,CAAC,mBAAmB,GAAG,cAAc,CAAC,EAAE,EACpD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,GAAE,KAAK,GAAG,IAAY,EAChC,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAET"}

package/dist/runtime/index.d.cts

@@ -0,0 +1,9 @@
+export * from './binding-resolver.cjs';
+export * from './variable-catalog.cjs';
+export * from './interpolator.cjs';
+export * from './conditional-resolver.cjs';
+export * from './pipeline-executor.cjs';
+export * from './state-store.cjs';
+export * from './server-tracking.cjs';
+export * from './tracking-relay.cjs';
+//# sourceMappingURL=index.d.cts.map

package/dist/runtime/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AAErC,cAAc,qBAAqB,CAAC"}

package/dist/runtime/index.d.ts

@@ -1,9 +1,9 @@
-export * from './binding-resolver';
-export * from './variable-catalog';
-export * from './interpolator';
-export * from './conditional-resolver';
-export * from './pipeline-executor';
-export * from './state-store';
-export * from './server-tracking';
-export * from './tracking-relay';
+export * from './binding-resolver.js';
+export * from './variable-catalog.js';
+export * from './interpolator.js';
+export * from './conditional-resolver.js';
+export * from './pipeline-executor.js';
+export * from './state-store.js';
+export * from './server-tracking.js';
+export * from './tracking-relay.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AAErC,cAAc,qBAAqB,CAAC"}

package/dist/runtime/interpolator.d.cts

@@ -0,0 +1,50 @@
+/**
+ * Template and Expression Variable Interpolator
+ *
+ * Provides safe, deterministic resolution and interpolation of template strings
+ * like `{{form.email}}`, `{{variables.token}}`, and `{{response.data.id}}` into
+ * targets without using eval() or Function().
+ */
+/**
+ * Standard structured runtime context for interpolations.
+ */
+export interface InterpolationContext {
+    form?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+    response?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Checks if a string contains one or more `{{ ... }}` template expressions.
+ */
+export declare function hasTemplateExpressions(text: unknown): boolean;
+/**
+ * Extracts all unique property keys / variable paths referenced inside `{{ ... }}`.
+ */
+export declare function extractTemplateVariables(text: string): string[];
+/**
+ * Safely traverses a nested data source to resolve a dot/bracket path
+ * (e.g. `form.user.profile.name`, `response.data[0].id`, `items.0.title`).
+ *
+ * Returns `fallback` if any segment is missing, undefined, null, or points to
+ * a function or forbidden prototype property.
+ */
+export declare function resolvePropertyPath(source: unknown, path: string, fallback?: unknown): unknown;
+/**
+ * Interpolates all `{{ path }}` placeholders in a template string using values
+ * from the provided context object.
+ *
+ * If a variable cannot be resolved, it replaces it with `fallback` (default: `""`).
+ */
+export declare function interpolateTemplateString(template: string, context?: Record<string, unknown>, fallback?: string): string;
+/**
+ * Recursively interpolates any value (string, object, array, primitive).
+ *
+ * - If string is exactly `{{ path }}`, returns the raw resolved value (retaining type: number, boolean, object, array).
+ * - If string contains embedded templates (e.g. `Bearer {{token}}`), returns the interpolated string.
+ * - If array, interpolates every element.
+ * - If object, interpolates every property value while stripping forbidden prototype keys.
+ */
+export declare function interpolateValue(value: unknown, context?: Record<string, unknown>): unknown;
+//# sourceMappingURL=interpolator.d.cts.map

package/dist/runtime/interpolator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolator.d.cts","sourceRoot":"","sources":["../../src/runtime/interpolator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB/D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,OAAO,GACjB,OAAO,CA6CT;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,GAAE,MAAW,GACpB,MAAM,CAqBR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA8B3F"}

package/dist/runtime/pipeline-executor.d.cts

@@ -0,0 +1,136 @@
+import type { ActionPipeline, ActionStep, ActionStepCondition, ActionStepType } from '@kubuild/schema';
+/**
+ * Execution context shared across action steps in a pipeline.
+ */
+export interface PipelineExecutionContext {
+    form?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+    response?: unknown;
+    stepResults?: Record<string, StepExecutionResult>;
+    error?: unknown;
+    lastError?: unknown;
+    nodeId?: string;
+    document?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Status of an individual step execution.
+ */
+export type StepExecutionStatus = 'success' | 'error' | 'skipped' | 'cancelled';
+/**
+ * Result of executing an individual action step.
+ */
+export interface StepExecutionResult {
+    stepId: string;
+    stepType: ActionStepType | string;
+    status: StepExecutionStatus;
+    data?: unknown;
+    error?: Error | unknown;
+    durationMs: number;
+    subResults?: StepExecutionResult[];
+}
+/**
+ * Overall result of executing an action pipeline.
+ */
+export interface PipelineExecutionResult {
+    pipelineId: string;
+    success: boolean;
+    status: 'completed' | 'failed' | 'cancelled';
+    stepResults: StepExecutionResult[];
+    context: PipelineExecutionContext;
+    error?: Error | unknown;
+    durationMs: number;
+}
+/**
+ * Handler function signature for an individual step type.
+ */
+export type PipelineStepHandler<TContext = PipelineExecutionContext> = (step: ActionStep, context: TContext, signal: AbortSignal) => Promise<unknown> | unknown;
+/**
+ * Options for configuring the execution of an action pipeline.
+ */
+export interface ExecutePipelineOptions {
+    context?: PipelineExecutionContext;
+    signal?: AbortSignal;
+    timeout?: number;
+    throwOnError?: boolean;
+    handlers?: Record<string, PipelineStepHandler>;
+    onStepStart?: (step: ActionStep, context: PipelineExecutionContext) => void;
+    onStepComplete?: (step: ActionStep, result: StepExecutionResult, context: PipelineExecutionContext) => void;
+}
+/**
+ * Configuration options for creating an ActionPipelineExecutor instance.
+ */
+export interface ActionPipelineExecutorOptions {
+    handlers?: Record<string, PipelineStepHandler>;
+    defaultTimeout?: number;
+    throwOnError?: boolean;
+}
+/**
+ * Custom error thrown when a step or pipeline times out.
+ */
+export declare class ActionTimeoutError extends Error {
+    readonly stepId?: string;
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, stepId?: string);
+}
+/**
+ * Custom error thrown when an action execution is aborted/cancelled.
+ */
+export declare class ActionCancellationError extends Error {
+    readonly stepId?: string;
+    constructor(message?: string, stepId?: string);
+}
+/**
+ * Evaluates an ActionStepCondition against a pipeline execution context.
+ */
+export declare function evaluateActionCondition(condition: ActionStepCondition | undefined, context: PipelineExecutionContext): boolean;
+/**
+ * ActionPipelineExecutor manages step handlers, sequential execution of action pipelines,
+ * timeouts, cancellation, conditional evaluation, and onSuccess / onError branching.
+ */
+export declare class ActionPipelineExecutor {
+    private handlers;
+    private defaultTimeout?;
+    private throwOnError;
+    constructor(options?: ActionPipelineExecutorOptions);
+    /**
+     * Registers default built-in handlers for core step types like `set_state` and `reset_form`.
+     */
+    private registerBuiltInHandlers;
+    /**
+     * Registers a handler for a step type.
+     */
+    registerHandler(type: ActionStepType | string, handler: PipelineStepHandler): this;
+    /**
+     * Unregisters a handler for a step type.
+     */
+    unregisterHandler(type: ActionStepType | string): this;
+    /**
+     * Checks if a handler exists for a step type.
+     */
+    hasHandler(type: ActionStepType | string): boolean;
+    /**
+     * Gets the registered handler for a step type.
+     */
+    getHandler(type: ActionStepType | string): PipelineStepHandler | undefined;
+    /**
+     * Executes a full ActionPipeline sequentially with support for timeouts, cancellation,
+     * condition evaluation, and branching.
+     */
+    execute(pipeline: ActionPipeline, options?: ExecutePipelineOptions): Promise<PipelineExecutionResult>;
+    /**
+     * Executes an ordered list of ActionSteps sequentially.
+     */
+    private executeSteps;
+    /**
+     * Executes a single ActionStep with condition checking, payload interpolation, timeout,
+     * handler execution, response context passing, and branch execution.
+     */
+    executeSingleStep(step: ActionStep, context: PipelineExecutionContext, parentSignal: AbortSignal, options?: ExecutePipelineOptions): Promise<StepExecutionResult>;
+}
+/**
+ * Convenience helper to execute an action pipeline using default or custom executor settings.
+ */
+export declare function executeActionPipeline(pipeline: ActionPipeline, options?: ExecutePipelineOptions): Promise<PipelineExecutionResult>;
+//# sourceMappingURL=pipeline-executor.d.cts.map

package/dist/runtime/pipeline-executor.d.cts.map

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