@xmachines/play-xstate 1.0.0-beta.2 → 1.0.0-beta.21

package/dist/catalog/validate-binding.d.ts

@@ -1,21 +0,0 @@
-import type { Catalog, ViewMetadata } from "./types.js";
-/**
- * Validate component binding against catalog
- *
- * Per CONTEXT.md:
- * - "Component references: String keys"
- * - "Mismatch detection: Both compile-time (TypeScript) and runtime validation"
- *
- * @example
- * ```typescript
- * const view = { component: 'Dashboard', userId: '123' };
- * validateComponentBinding(view, catalog);
- * // Throws if 'Dashboard' not in catalog
- * ```
- *
- * @param view - View metadata from meta.view
- * @param catalog - Component catalog
- * @throws Error if component not found in catalog
- */
-export declare const validateComponentBinding: (view: ViewMetadata, catalog: Catalog) => void;
-//# sourceMappingURL=validate-binding.d.ts.map

package/dist/catalog/validate-binding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-binding.d.ts","sourceRoot":"","sources":["../../src/catalog/validate-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,YAAY,EAAE,SAAS,OAAO,KAAG,IAc/E,CAAC"}

package/dist/catalog/validate-binding.js

@@ -1,30 +0,0 @@
-/**
- * Validate component binding against catalog
- *
- * Per CONTEXT.md:
- * - "Component references: String keys"
- * - "Mismatch detection: Both compile-time (TypeScript) and runtime validation"
- *
- * @example
- * ```typescript
- * const view = { component: 'Dashboard', userId: '123' };
- * validateComponentBinding(view, catalog);
- * // Throws if 'Dashboard' not in catalog
- * ```
- *
- * @param view - View metadata from meta.view
- * @param catalog - Component catalog
- * @throws Error if component not found in catalog
- */
-export const validateComponentBinding = (view, catalog) => {
-    if (!view || !view.component) {
-        throw new Error("Invalid view metadata: missing 'component' property");
-    }
-    const { component } = view;
-    // Runtime validation
-    if (!(component in catalog)) {
-        const available = Object.keys(catalog).join(", ");
-        throw new Error(`Component "${component}" not found in catalog. Available components: ${available || "(none)"}`);
-    }
-};
-//# sourceMappingURL=validate-binding.js.map

package/dist/catalog/validate-binding.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-binding.js","sourceRoot":"","sources":["../../src/catalog/validate-binding.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAkB,EAAE,OAAgB,EAAQ,EAAE;IACtF,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAE3B,qBAAqB;IACrB,IAAI,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CACd,cAAc,SAAS,iDAAiD,SAAS,IAAI,QAAQ,EAAE,CAC/F,CAAC;IACH,CAAC;AACF,CAAC,CAAC"}

package/dist/catalog/validate-props.d.ts

@@ -1,41 +0,0 @@
-import type { z } from "zod";
-import type { Catalog, ViewMetadata } from "./types.js";
-/**
- * Validate view props against Zod schema
- *
- * Per CONTEXT.md:
- * - "Prop validation: At state entry"
- * - "currentView derivation: Merge meta.view with relevant context data"
- *
- * Per RESEARCH.md Pattern 4: Use safeParse() for validation
- *
- * @example
- * ```typescript
- * const props = { userId: '123', stats: { logins: 5 } };
- * const result = validateViewProps('Dashboard', props, catalog);
- * if (!result.success) {
- *   console.error(result.error);
- * }
- * ```
- *
- * @param componentName - Component name from catalog
- * @param props - Props to validate
- * @param catalog - Component catalog with schemas
- * @returns Zod parse result
- */
-export declare const validateViewProps: (componentName: string, props: any, catalog: Catalog) => {
-    success: boolean;
-    data?: any;
-    error?: z.ZodError | Error;
-};
-/**
- * Merge view metadata with context for props
- *
- * Per CONTEXT.md: "Merge meta.view with relevant context data for component props"
- *
- * @param view - View metadata from meta.view
- * @param context - Machine context
- * @returns Merged props object
- */
-export declare const mergeViewProps: (view: ViewMetadata, context: any) => Record<string, any>;
-//# sourceMappingURL=validate-props.d.ts.map

package/dist/catalog/validate-props.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-props.d.ts","sourceRoot":"","sources":["../../src/catalog/validate-props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,GAC7B,eAAe,MAAM,EACrB,OAAO,GAAG,EACV,SAAS,OAAO,KACd;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAA;CA2B5D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,YAAY,EAAE,SAAS,GAAG,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAwCnF,CAAC"}

package/dist/catalog/validate-props.js

@@ -1,95 +0,0 @@
-/**
- * Validate view props against Zod schema
- *
- * Per CONTEXT.md:
- * - "Prop validation: At state entry"
- * - "currentView derivation: Merge meta.view with relevant context data"
- *
- * Per RESEARCH.md Pattern 4: Use safeParse() for validation
- *
- * @example
- * ```typescript
- * const props = { userId: '123', stats: { logins: 5 } };
- * const result = validateViewProps('Dashboard', props, catalog);
- * if (!result.success) {
- *   console.error(result.error);
- * }
- * ```
- *
- * @param componentName - Component name from catalog
- * @param props - Props to validate
- * @param catalog - Component catalog with schemas
- * @returns Zod parse result
- */
-export const validateViewProps = (componentName, props, catalog) => {
-    const entry = catalog[componentName];
-    if (!entry) {
-        return {
-            success: false,
-            error: new Error(`Component "${componentName}" not found in catalog`),
-        };
-    }
-    // Handle both CatalogEntry format and direct Zod schema
-    const schema = typeof entry === "object" && "schema" in entry ? entry.schema : entry;
-    // Use safeParse to avoid throwing
-    const result = schema.safeParse(props);
-    if (!result.success) {
-        return {
-            success: false,
-            error: result.error,
-        };
-    }
-    return {
-        success: true,
-        data: result.data,
-    };
-};
-/**
- * Merge view metadata with context for props
- *
- * Per CONTEXT.md: "Merge meta.view with relevant context data for component props"
- *
- * @param view - View metadata from meta.view
- * @param context - Machine context
- * @returns Merged props object
- */
-export const mergeViewProps = (view, context) => {
-    // Extract component and props from view metadata
-    const { component: _component, props, ...rest } = view;
-    // Determine view props based on structure
-    let viewProps;
-    if (typeof props === "function") {
-        // Case 0: props is a factory function — call it with { context }
-        // e.g. props: ({ context }) => ({ welcome: true, username: context.username })
-        viewProps = props({ context });
-    }
-    else if (props && typeof props === "object" && !Array.isArray(props)) {
-        // Case 1: view has explicit props object: { component: 'X', props: { a: 1 } }
-        viewProps = props;
-    }
-    else if (Object.keys(rest).length > 0) {
-        // Case 2: props are flat on view: { component: 'X', a: 1, b: 2 }
-        viewProps = rest;
-    }
-    else {
-        // Case 3: no props at all
-        viewProps = {};
-    }
-    // Extract infrastructure props that should bypass catalog validation
-    // These are reserved keys that components receive but aren't in catalog schemas
-    const { routeParams, queryParams, ...catalogContext } = context;
-    // Merge catalog-validated context with viewProps
-    const mergedProps = {
-        ...catalogContext,
-        ...viewProps,
-    };
-    // Add infrastructure props back (these bypass Zod validation)
-    // Spread routeParams so they become top-level props (e.g., section: "profile")
-    // Components receive route params as direct props, not nested
-    return {
-        ...mergedProps,
-        ...routeParams, // Spread route params as top-level props
-        ...(queryParams && { queryParams }), // Add queryParams as nested object if present
-    };
-};
-//# sourceMappingURL=validate-props.js.map

package/dist/catalog/validate-props.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-props.js","sourceRoot":"","sources":["../../src/catalog/validate-props.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,aAAqB,EACrB,KAAU,EACV,OAAgB,EAC+C,EAAE;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO;YACN,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,IAAI,KAAK,CAAC,cAAc,aAAa,wBAAwB,CAAC;SACrE,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IAErF,kCAAkC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO;YACN,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,MAAM,CAAC,KAAK;SACnB,CAAC;IACH,CAAC;IAED,OAAO;QACN,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;KACjB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAkB,EAAE,OAAY,EAAuB,EAAE;IACvF,iDAAiD;IACjD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IAE9D,0CAA0C;IAC1C,IAAI,SAA8B,CAAC;IAEnC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QACjC,iEAAiE;QACjE,+EAA+E;QAC/E,SAAS,GAAG,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,8EAA8E;QAC9E,SAAS,GAAG,KAAK,CAAC;IACnB,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,iEAAiE;QACjE,SAAS,GAAG,IAAI,CAAC;IAClB,CAAC;SAAM,CAAC;QACP,0BAA0B;QAC1B,SAAS,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,qEAAqE;IACrE,gFAAgF;IAChF,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IAEhE,iDAAiD;IACjD,MAAM,WAAW,GAAG;QACnB,GAAG,cAAc;QACjB,GAAG,SAAS;KACZ,CAAC;IAEF,8DAA8D;IAC9D,+EAA+E;IAC/E,8DAA8D;IAC9D,OAAO;QACN,GAAG,WAAW;QACd,GAAG,WAAW,EAAE,yCAAyC;QACzD,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,8CAA8C;KACnF,CAAC;AACH,CAAC,CAAC"}