@procedures/client 0.0.0-stage → 0.1.0

package/dist/components/define.js

@@ -0,0 +1,486 @@
+/**
+ * Component Definition Helpers
+ *
+ * Utilities for defining components as procedures.
+ * Components are procedures with special handling for UI rendering.
+ */
+import { PROCEDURE_REGISTRY } from "../procedures/registry.js";
+import { invokeProcedure, isAsyncIterable } from "../procedures/invoke.js";
+import { isStreamingFactory } from "./types.js";
+/**
+ * Default component input schema.
+ * Validates the standard { data, size, path } structure.
+ */
+export const componentInputSchema = {
+    parse(value) {
+        const result = this.safeParse(value);
+        if (!result.success) {
+            throw new Error(result.error.message);
+        }
+        return result.data;
+    },
+    safeParse(value) {
+        if (!value || typeof value !== "object") {
+            return {
+                success: false,
+                error: { message: "Expected object", errors: [{ path: [], message: "Expected object" }] },
+            };
+        }
+        const input = value;
+        if (!("data" in input)) {
+            return {
+                success: false,
+                error: { message: "Missing required field: data", errors: [{ path: ["data"], message: "Missing required field: data" }] },
+            };
+        }
+        if (!("size" in input) || typeof input["size"] !== "object") {
+            return {
+                success: false,
+                error: { message: "Missing or invalid field: size", errors: [{ path: ["size"], message: "Missing or invalid field: size" }] },
+            };
+        }
+        const size = input["size"];
+        if (typeof size["width"] !== "number" || typeof size["height"] !== "number") {
+            return {
+                success: false,
+                error: { message: "Size must have numeric width and height", errors: [{ path: ["size"], message: "Size must have numeric width and height" }] },
+            };
+        }
+        if (!("path" in input) || typeof input["path"] !== "string") {
+            return {
+                success: false,
+                error: { message: "Missing or invalid field: path", errors: [{ path: ["path"], message: "Missing or invalid field: path" }] },
+            };
+        }
+        return {
+            success: true,
+            data: input,
+        };
+    },
+};
+/**
+ * Component output schema.
+ * Validates that output is a serializable ComponentOutput.
+ */
+export const componentOutputSchema = {
+    parse(value) {
+        const result = this.safeParse(value);
+        if (!result.success) {
+            throw new Error(result.error.message);
+        }
+        return result.data;
+    },
+    safeParse(value) {
+        if (!value || typeof value !== "object") {
+            return {
+                success: false,
+                error: { message: "Expected object", errors: [{ path: [], message: "Expected object" }] },
+            };
+        }
+        const output = value;
+        if (typeof output["type"] !== "string") {
+            return {
+                success: false,
+                error: { message: "Missing or invalid field: type", errors: [{ path: ["type"], message: "Missing or invalid field: type" }] },
+            };
+        }
+        if (!("props" in output) || typeof output["props"] !== "object") {
+            return {
+                success: false,
+                error: { message: "Missing or invalid field: props", errors: [{ path: ["props"], message: "Missing or invalid field: props" }] },
+            };
+        }
+        return {
+            success: true,
+            data: output,
+        };
+    },
+};
+// =============================================================================
+// defineComponent
+// =============================================================================
+/**
+ * Define a component and convert it to a procedure.
+ *
+ * Components are registered under ["components", namespace?, type].
+ *
+ * @param definition - Component definition
+ * @returns The component definition (for chaining)
+ *
+ * @example
+ * ```typescript
+ * // Simple component
+ * const userCard = defineComponent({
+ *   type: "user-card",
+ *   namespace: "ui",
+ *   input: userSchema,
+ *   factory: (ctx) => ({
+ *     type: "user-card",
+ *     props: { user: ctx.data },
+ *   }),
+ * });
+ *
+ * // Streaming component
+ * const liveDashboard = defineComponent({
+ *   type: "live-dashboard",
+ *   streaming: true,
+ *   factory: async function* (ctx) {
+ *     yield { type: "dashboard", props: { loading: true } };
+ *     for await (const data of ctx.bus.stream("updates")) {
+ *       yield { type: "dashboard", props: { data } };
+ *     }
+ *   },
+ * });
+ * ```
+ */
+export function defineComponent(definition) {
+    // Build the procedure path
+    const path = definition.namespace
+        ? ["components", definition.namespace, definition.type]
+        : ["components", definition.type];
+    // Create the procedure from the component
+    const procedure = componentToProcedure(definition, path);
+    // Register the procedure
+    PROCEDURE_REGISTRY.register(procedure);
+    return definition;
+}
+/**
+ * Convert a component definition to a procedure.
+ *
+ * @param definition - Component definition
+ * @param path - Procedure path
+ * @returns Procedure that wraps the component
+ */
+export function componentToProcedure(definition, path) {
+    const { factory, streaming, metadata } = definition;
+    // Build procedure metadata
+    const procedureMetadata = {
+        ...metadata,
+        streaming: streaming ?? isStreamingFactory(factory),
+        tags: [...(metadata?.tags ?? []), "component"],
+    };
+    // Create handler based on factory type. With no `streaming` flag and a plain function, the
+    // handler gives the factory's result: one output, or the items of a generator that it returns.
+    const handler = streaming === true || (streaming === undefined && isStreamingFactory(factory))
+        ? createStreamingHandler(factory)
+        : streaming === false
+            ? createStandardHandler(factory)
+            : createAdaptiveHandler(factory);
+    return {
+        path,
+        input: definition.input
+            ? createWrappedInputSchema(definition.input)
+            : componentInputSchema,
+        output: componentOutputSchema,
+        metadata: procedureMetadata,
+        streaming: procedureMetadata.streaming ?? false,
+        handler,
+    };
+}
+/**
+ * Create a wrapped input schema that validates both structure and data.
+ */
+function createWrappedInputSchema(dataSchema) {
+    return {
+        parse(value) {
+            const result = this.safeParse(value);
+            if (!result.success) {
+                throw new Error(result.error.message);
+            }
+            return result.data;
+        },
+        safeParse(value) {
+            // First validate the structure
+            const structureResult = componentInputSchema.safeParse(value);
+            if (!structureResult.success) {
+                return structureResult;
+            }
+            // Then validate the data field
+            const input = structureResult.data;
+            const dataResult = dataSchema.safeParse(input.data);
+            if (!dataResult.success) {
+                return {
+                    success: false,
+                    error: {
+                        message: `Invalid data: ${dataResult.error.message}`,
+                        errors: (dataResult.error.issues ?? dataResult.error.errors ?? []).map((e) => ({
+                            path: ["data", ...(e.path ?? [])],
+                            message: e.message,
+                        })),
+                    },
+                };
+            }
+            return {
+                success: true,
+                data: { ...input, data: dataResult.data },
+            };
+        },
+    };
+}
+/**
+ * Create a standard (non-streaming) handler from a component factory.
+ */
+function createStandardHandler(factory) {
+    return async (input, ctx) => {
+        const componentCtx = procedureToComponentContext(input, ctx);
+        const result = factory(componentCtx);
+        // Handle both sync and async returns
+        if (result instanceof Promise) {
+            return await result;
+        }
+        // Handle generator (shouldn't happen for standard, but just in case)
+        if (isAsyncGenerator(result)) {
+            // Take only the first yield, then end the generator so its finally blocks run
+            // (BUGS-2026-07 L3: it was left suspended)
+            try {
+                const { value, done } = await result.next();
+                if (done || value === undefined) {
+                    throw new Error("Component factory yielded no output");
+                }
+                return value;
+            }
+            finally {
+                await result.return?.(undefined);
+            }
+        }
+        return result;
+    };
+}
+/**
+ * Create a handler that gives what the factory gives: one output, or a stream when the factory
+ * returns an async generator. `invokeProcedure` reads a returned generator as a stream.
+ */
+function createAdaptiveHandler(factory) {
+    return async (input, ctx) => {
+        const result = factory(procedureToComponentContext(input, ctx));
+        if (isAsyncIterable(result)) {
+            // The handler type has no "maybe a stream" form: invokeProcedure tests the result
+            return result;
+        }
+        return await result;
+    };
+}
+/**
+ * Create a streaming handler from a component factory.
+ */
+function createStreamingHandler(factory) {
+    return async function* (input, ctx) {
+        const componentCtx = procedureToComponentContext(input, ctx);
+        const result = factory(componentCtx);
+        if (isAsyncGenerator(result)) {
+            yield* result;
+        }
+        else {
+            // Convert single result to single yield
+            const output = result instanceof Promise ? await result : result;
+            yield output;
+        }
+    };
+}
+/**
+ * Convert procedure context to component context.
+ */
+function procedureToComponentContext(input, ctx) {
+    const result = {
+        data: input.data,
+        size: input.size,
+        path: input.path,
+        depth: input.depth ?? 0,
+        metadata: ctx.metadata,
+        render: createRenderFunction(ctx),
+    };
+    if (ctx.bus) {
+        result.bus = ctx.bus;
+    }
+    return result;
+}
+/**
+ * Create a render function for child components.
+ * This delegates to the procedure registry.
+ */
+function createRenderFunction(ctx) {
+    return async (data, size, path) => {
+        // Determine component type from data
+        // This is a simple heuristic - in practice, the renderer would decide
+        const type = inferComponentType(data);
+        if (!type) {
+            // Return a passthrough if we can't determine the type
+            return {
+                type: "raw",
+                props: { data },
+            };
+        }
+        // Find the component procedure: in the namespace of the component that renders, then
+        // the global one (BUGS-2026-07 L3: namespaced components were never found). A context
+        // that names its registry is searched first.
+        const registry = ctx.registry ?? PROCEDURE_REGISTRY;
+        const namespace = ctx.path?.length === 3 ? ctx.path[1] : undefined;
+        const procedure = (namespace !== undefined ? registry.get(["components", namespace, type]) : undefined) ??
+            registry.get(["components", type]);
+        if (!procedure || !procedure.handler) {
+            return {
+                type: "unknown",
+                props: { type, data },
+            };
+        }
+        // Call the procedure
+        const input = {
+            data,
+            size,
+            path,
+            depth: (path.match(/\./g) || []).length,
+        };
+        // The child runs through the invocation path: its input and output are validated, and its
+        // context has its own path. (Before, the parent called the handler directly, with no
+        // validation and with the parent's context.)
+        const options = { metadata: ctx.metadata, client: ctx.client };
+        if (ctx.signal)
+            options.signal = ctx.signal;
+        if (ctx.bus)
+            options.bus = ctx.bus;
+        if (ctx.repository)
+            options.repository = ctx.repository;
+        const output = await invokeProcedure(procedure, input, options);
+        if (output.kind === "value") {
+            return output.value;
+        }
+        // A streaming child: take the first output, then end the stream so its finally blocks run
+        try {
+            const { value, done } = await output.items.next();
+            if (done || value === undefined) {
+                throw new Error("Child component yielded no output");
+            }
+            return value;
+        }
+        finally {
+            await output.items.return(undefined);
+        }
+    };
+}
+/**
+ * Infer component type from data.
+ * This is a placeholder - real apps would use a type field or registry lookup.
+ */
+function inferComponentType(data) {
+    if (!data || typeof data !== "object") {
+        return null;
+    }
+    const obj = data;
+    // Check for explicit __component field
+    if (typeof obj["__component"] === "string") {
+        return obj["__component"];
+    }
+    // Check for type field
+    if (typeof obj["type"] === "string") {
+        return obj["type"];
+    }
+    return null;
+}
+/**
+ * Check if a value is an async generator.
+ */
+function isAsyncGenerator(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        Symbol.asyncIterator in value &&
+        typeof value.next === "function");
+}
+// =============================================================================
+// Bundle Registration
+// =============================================================================
+/**
+ * Register a bundle of components.
+ *
+ * @param bundle - Component bundle
+ * @returns The registered components
+ *
+ * @example
+ * ```typescript
+ * const registered = registerBundle({
+ *   namespace: "ui",
+ *   components: [buttonComponent, cardComponent],
+ * });
+ * ```
+ */
+export function registerBundle(bundle) {
+    const registered = [];
+    for (const component of bundle.components) {
+        // Apply bundle namespace if component doesn't have one
+        const withNamespace = {
+            ...component,
+            namespace: component.namespace ?? bundle.namespace,
+        };
+        defineComponent(withNamespace);
+        registered.push(withNamespace);
+    }
+    return registered;
+}
+/**
+ * Create a component bundle.
+ *
+ * @param namespace - Shared namespace
+ * @param components - Component definitions
+ * @param metadata - Optional bundle metadata
+ * @returns ComponentBundle
+ */
+export function createBundle(namespace, components, metadata) {
+    const result = { namespace, components };
+    if (metadata) {
+        result.metadata = metadata;
+    }
+    return result;
+}
+// =============================================================================
+// Quick Define Helpers
+// =============================================================================
+/**
+ * Define a simple component with minimal boilerplate.
+ *
+ * @param type - Component type
+ * @param factory - Factory function
+ * @returns ComponentDefinition
+ *
+ * @example
+ * ```typescript
+ * const badge = simpleComponent("badge", (ctx) => ({
+ *   type: "badge",
+ *   props: { label: ctx.data.label },
+ * }));
+ * ```
+ */
+export function simpleComponent(type, factory) {
+    return defineComponent({
+        type,
+        factory,
+    });
+}
+/**
+ * Define a namespaced component with minimal boilerplate.
+ *
+ * @param namespace - Component namespace
+ * @param type - Component type
+ * @param factory - Factory function
+ * @returns ComponentDefinition
+ */
+export function namespacedComponent(namespace, type, factory) {
+    return defineComponent({
+        type,
+        namespace,
+        factory,
+    });
+}
+/**
+ * Define a streaming component.
+ *
+ * @param type - Component type
+ * @param factory - Generator factory function
+ * @returns ComponentDefinition
+ */
+export function streamingComponent(type, factory) {
+    return defineComponent({
+        type,
+        streaming: true,
+        factory,
+    });
+}
+//# sourceMappingURL=define.js.map

package/dist/components/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/components/define.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,kBAAkB,EAA0B,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAqBhD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA4B;IAC3D,KAAK,CAAC,KAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,EAAE;aAC1F,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,KAAgC,CAAC;QAE/C,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,EAAE;aAC1H,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,EAAE;aAC9H,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAA4B,CAAC;QACtD,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC,EAAE;aAChJ,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,EAAE;aAC9H,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAa;YACtB,IAAI,EAAE,KAAkC;SACzC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA6B;IAC7D,KAAK,CAAC,KAAc;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,SAAS,CAAC,KAAc;QACtB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,EAAE;aAC1F,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,KAAgC,CAAC;QAEhD,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,EAAE;aAC9H,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,KAAc;gBACvB,KAAK,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,EAAE;aACjI,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAa;YACtB,IAAI,EAAE,MAAoC;SAC3C,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAsC;IAEtC,2BAA2B;IAC3B,MAAM,IAAI,GAAkB,UAAU,CAAC,SAAS;QAC9C,CAAC,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC;QACvD,CAAC,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAEpC,0CAA0C;IAC1C,MAAM,SAAS,GAAG,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEzD,yBAAyB;IACzB,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAsC,EACtC,IAAmB;IAEnB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC;IAEpD,2BAA2B;IAC3B,MAAM,iBAAiB,GAAsB;QAC3C,GAAG,QAAQ;QACX,SAAS,EAAE,SAAS,IAAI,kBAAkB,CAAC,OAAO,CAAC;QACnD,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC;KAC/C,CAAC;IAEF,2FAA2F;IAC3F,+FAA+F;IAC/F,MAAM,OAAO,GAAG,SAAS,KAAK,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5F,CAAC,CAAC,sBAAsB,CAAC,OAAqC,CAAC;QAC/D,CAAC,CAAC,SAAS,KAAK,KAAK;YACnB,CAAC,CAAC,qBAAqB,CAAC,OAAqC,CAAC;YAC9D,CAAC,CAAC,qBAAqB,CAAC,OAAqC,CAAC,CAAC;IAEnE,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,UAAU,CAAC,KAAK;YACrB,CAAC,CAAC,wBAAwB,CAAC,UAAU,CAAC,KAAK,CAAC;YAC5C,CAAC,CAAC,oBAAsD;QAC1D,MAAM,EAAE,qBAAqB;QAC7B,QAAQ,EAAE,iBAAiB;QAC3B,SAAS,EAAE,iBAAiB,CAAC,SAAS,IAAI,KAAK;QAC/C,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAC/B,UAA0B;IAE1B,OAAO;QACL,KAAK,CAAC,KAAc;YAClB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,SAAS,CAAC,KAAc;YACtB,+BAA+B;YAC/B,MAAM,eAAe,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9D,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC7B,OAAO,eAAe,CAAC;YACzB,CAAC;YAED,+BAA+B;YAC/B,MAAM,KAAK,GAAG,eAAe,CAAC,IAA+B,CAAC;YAC9D,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE,KAAc;oBACvB,KAAK,EAAE;wBACL,OAAO,EAAE,iBAAiB,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE;wBACpD,MAAM,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC7E,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;4BACjC,OAAO,EAAE,CAAC,CAAC,OAAO;yBACnB,CAAC,CAAC;qBACJ;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAa;gBACtB,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAA2B;aACnE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,OAAmC;IAEnC,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,YAAY,GAAG,2BAA2B,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAErC,qCAAqC;QACrC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,MAAM,CAAC;QACtB,CAAC;QAED,qEAAqE;QACrE,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,8EAA8E;YAC9E,2CAA2C;YAC3C,IAAI,CAAC;gBACH,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;gBACzD,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;oBAAS,CAAC;gBACT,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,MAAyB,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,OAAmC;IAEnC,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAChE,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,kFAAkF;YAClF,OAAO,MAAoC,CAAC;QAC9C,CAAC;QACD,OAAO,MAAO,MAAqD,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAC7B,OAAmC;IAEnC,OAAO,KAAK,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG;QAChC,MAAM,YAAY,GAAG,2BAA2B,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAErC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,CAAC,MAAM,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,MAAM,MAAM,GAAG,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YACjE,MAAM,MAAyB,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAClC,KAA4B,EAC5B,GAAqB;IAErB,MAAM,MAAM,GAA4B;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;QACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,oBAAoB,CAAC,GAAG,CAAC;KAClC,CAAC;IACF,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAC3B,GAAqB;IAErB,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAChC,qCAAqC;QACrC,sEAAsE;QACtE,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,sDAAsD;YACtD,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,EAAE,IAAI,EAAE;aAChB,CAAC;QACJ,CAAC;QAED,qFAAqF;QACrF,sFAAsF;QACtF,6CAA6C;QAC7C,MAAM,QAAQ,GAAI,GAA2D,CAAC,QAAQ,IAAI,kBAAkB,CAAC;QAC7G,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,MAAM,SAAS,GACb,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACrF,QAAQ,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;aACtB,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,MAAM,KAAK,GAAmB;YAC5B,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM;SACxC,CAAC;QAEF,0FAA0F;QAC1F,qFAAqF;QACrF,6CAA6C;QAC7C,MAAM,OAAO,GAA0C,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QACtG,IAAI,GAAG,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC5C,IAAI,GAAG,CAAC,GAAG;YAAE,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QACnC,IAAI,GAAG,CAAC,UAAU;YAAE,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAkB,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjF,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,0FAA0F;QAC1F,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAClD,IAAI,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,IAAa;IACvC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,IAA+B,CAAC;IAE5C,uCAAuC;IACvC,IAAI,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,MAAM,CAAC,aAAa,IAAI,KAAK;QAC7B,OAAQ,KAAa,CAAC,IAAI,KAAK,UAAU,CAC1C,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,MAAM,UAAU,GAA6B,EAAE,CAAC;IAEhD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,uDAAuD;QACvD,MAAM,aAAa,GAA2B;YAC5C,GAAG,SAAS;YACZ,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS;SACnD,CAAC;QAEF,eAAe,CAAC,aAAa,CAAC,CAAC;QAC/B,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,UAAoC,EACpC,QAAsC;IAEtC,MAAM,MAAM,GAAoB,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAC1D,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,OAA0D;IAE1D,OAAO,eAAe,CAAC;QACrB,IAAI;QACJ,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,IAAY,EACZ,OAA0D;IAE1D,OAAO,eAAe,CAAC;QACrB,IAAI;QACJ,SAAS;QACT,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,OAAyF;IAEzF,OAAO,eAAe,CAAC;QACrB,IAAI;QACJ,SAAS,EAAE,IAAI;QACf,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/components/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Components Module
+ *
+ * Components are procedures that return serializable UI descriptors.
+ * This enables SSR, caching, and transport over wire.
+ *
+ * @example
+ * ```typescript
+ * import { defineComponent, simpleComponent, registerBundle } from "client/components";
+ *
+ * // Define a component
+ * const userCard = defineComponent({
+ *   type: "user-card",
+ *   namespace: "ui",
+ *   input: userSchema,
+ *   factory: (ctx) => ({
+ *     type: "user-card",
+ *     props: { user: ctx.data },
+ *   }),
+ * });
+ *
+ * // Simple shorthand
+ * const badge = simpleComponent("badge", (ctx) => ({
+ *   type: "badge",
+ *   props: { label: ctx.data.label },
+ * }));
+ *
+ * // Register a bundle
+ * registerBundle({
+ *   namespace: "ui",
+ *   components: [buttonComponent, cardComponent],
+ * });
+ * ```
+ */
+export type { ComponentOutput, FragmentOutput, NullOutput, AnyComponentOutput, Size, ComponentContext, ComponentFactory, StreamingComponentFactory, AnyComponentFactory, ComponentMetadata, ComponentDefinition, AnyComponentDefinition, RegisteredComponent, ComponentBundle, InferComponentInput, IsStreamingComponent, } from "./types.js";
+export { nullOutput, fragment, isFragment, isNullOutput, isStreamingFactory, } from "./types.js";
+export type { ComponentInput } from "./define.js";
+export { defineComponent, componentToProcedure, registerBundle, createBundle, simpleComponent, namespacedComponent, streamingComponent, componentInputSchema, componentOutputSchema, } from "./define.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,YAAY,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,38 @@
+/**
+ * Components Module
+ *
+ * Components are procedures that return serializable UI descriptors.
+ * This enables SSR, caching, and transport over wire.
+ *
+ * @example
+ * ```typescript
+ * import { defineComponent, simpleComponent, registerBundle } from "client/components";
+ *
+ * // Define a component
+ * const userCard = defineComponent({
+ *   type: "user-card",
+ *   namespace: "ui",
+ *   input: userSchema,
+ *   factory: (ctx) => ({
+ *     type: "user-card",
+ *     props: { user: ctx.data },
+ *   }),
+ * });
+ *
+ * // Simple shorthand
+ * const badge = simpleComponent("badge", (ctx) => ({
+ *   type: "badge",
+ *   props: { label: ctx.data.label },
+ * }));
+ *
+ * // Register a bundle
+ * registerBundle({
+ *   namespace: "ui",
+ *   components: [buttonComponent, cardComponent],
+ * });
+ * ```
+ */
+// Type utilities
+export { nullOutput, fragment, isFragment, isNullOutput, isStreamingFactory, } from "./types.js";
+export { defineComponent, componentToProcedure, registerBundle, createBundle, simpleComponent, namespacedComponent, streamingComponent, componentInputSchema, componentOutputSchema, } from "./define.js";
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAsBH,iBAAiB;AACjB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC"}