@lssm/lib.contracts 1.41.1 → 1.42.2

package/dist/capabilities/docs/capabilities.docblock.js

@@ -1 +1,21 @@
-import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.capabilities`,title:`CapabilitySpec Overview`,summary:"Capability specs provide a canonical, versioned contract for what a module offers (`provides`) and what it depends on (`requires`). They enable safe composition across features, automated validation during `installFeature`, and consistent documentation for shared surfaces (APIs, events, workflows, UI, resources).",kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/capabilities`,tags:[`tech`,`contracts`,`capabilities`],body:"# CapabilitySpec Overview\n\n## Purpose\n\nCapability specs provide a canonical, versioned contract for what a module offers (`provides`) and what it depends on (`requires`). They enable safe composition across features, automated validation during `installFeature`, and consistent documentation for shared surfaces (APIs, events, workflows, UI, resources).\n\n## Schema\n\nDefined in `@lssm/lib.contracts/src/capabilities.ts`.\n\n```ts\nexport interface CapabilitySpec {\n  meta: CapabilityMeta;              // ownership metadata + { key, version, kind }\n  provides?: CapabilitySurfaceRef[]; // what concrete surfaces this capability exposes\n  requires?: CapabilityRequirement[];// capabilities that must already exist\n}\n```\n\n- **CapabilityMeta**\n  - `key`: stable slug (e.g., `payments.stripe`)\n  - `version`: bump on breaking changes\n  - `kind`: `'api' | 'event' | 'data' | 'ui' | 'integration'`\n  - ownership fields (`title`, `description`, `domain`, `owners`, `tags`, `stability`)\n- **CapabilitySurfaceRef**\n  - `surface`: `'operation' | 'event' | 'workflow' | 'presentation' | 'resource'`\n  - `name` / `version`: points to the declared contract (operation name, event name, etc.)\n  - optional `description`\n- **CapabilityRequirement**\n  - `key`: capability slug to satisfy\n  - `version?`: pin to an exact version when required (defaults to highest registered)\n  - `kind?`: extra guard if the same key hosts multiple kinds\n  - `optional?`: skip strict enforcement (informational requirement)\n  - `reason?`: why this dependency exists (docs + tooling)\n\n## Registry\n\n`CapabilityRegistry` provides:\n\n- `register(spec)`: register a capability (`key + version` must be unique)\n- `get(key, version?)`: retrieve the exact or highest version\n- `list()`: inspect all capabilities\n- `satisfies(requirement, additional?)`: check if a requirement is met (includes locally provided capabilities passed via `additional`)\n\n## Feature Integration\n\n`FeatureModuleSpec` now accepts:\n\n```ts\ncapabilities?: {\n  provides?: CapabilityRef[];    // capabilities this feature exposes\n  requires?: CapabilityRequirement[]; // capabilities the feature needs\n};\n```\n\nDuring `installFeature`:\n\n1. `provides` entries must exist in the `CapabilityRegistry`.\n2. `requires` entries must be satisfied either by:\n   - the same feature’s `provides`,\n   - or existing capabilities already registered in the global registry.\n\nErrors are thrown when dependencies cannot be satisfied, preventing unsafe module composition.\n\n## Authoring Guidelines\n\n1. **Register capability specs** in a shared package (e.g., `packages/.../capabilities`) before referencing them in features.\n2. **Version consciously**: bump capability versions when the provided surfaces or contract semantics change.\n3. **Document dependencies** via `reason` strings to help operators understand why a capability is required.\n4. **Prefer stable keys** that map to business/technical domains (`billing.invoices`, `payments.stripe`, `cms.assets`).\n5. When introducing new capability kinds, update the `CapabilityKind` union and accompanying docs/tests.\n\n## Tooling (Roadmap)\n\n- CLI validation warns when feature specs reference missing capabilities.\n- Future build steps will leverage capability data to scaffold adapters and enforce policy in generated code.\n- Capability metadata will surface in docs/LLM guides to describe module marketplaces and installation flows.\n\n"}];e(t);export{t as tech_contracts_capabilities_DocBlocks};
+import { registerDocBlocks } from "../../docs/registry.js";
+
+//#region src/capabilities/docs/capabilities.docblock.ts
+const tech_contracts_capabilities_DocBlocks = [{
+	id: "docs.tech.contracts.capabilities",
+	title: "CapabilitySpec Overview",
+	summary: "Capability specs provide a canonical, versioned contract for what a module offers (`provides`) and what it depends on (`requires`). They enable safe composition across features, automated validation during `installFeature`, and consistent documentation for shared surfaces (APIs, events, workflows, UI, resources).",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/capabilities",
+	tags: [
+		"tech",
+		"contracts",
+		"capabilities"
+	],
+	body: "# CapabilitySpec Overview\n\n## Purpose\n\nCapability specs provide a canonical, versioned contract for what a module offers (`provides`) and what it depends on (`requires`). They enable safe composition across features, automated validation during `installFeature`, and consistent documentation for shared surfaces (APIs, events, workflows, UI, resources).\n\n## Schema\n\nDefined in `@lssm/lib.contracts/src/capabilities.ts`.\n\n```ts\nexport interface CapabilitySpec {\n  meta: CapabilityMeta;              // ownership metadata + { key, version, kind }\n  provides?: CapabilitySurfaceRef[]; // what concrete surfaces this capability exposes\n  requires?: CapabilityRequirement[];// capabilities that must already exist\n}\n```\n\n- **CapabilityMeta**\n  - `key`: stable slug (e.g., `payments.stripe`)\n  - `version`: bump on breaking changes\n  - `kind`: `'api' | 'event' | 'data' | 'ui' | 'integration'`\n  - ownership fields (`title`, `description`, `domain`, `owners`, `tags`, `stability`)\n- **CapabilitySurfaceRef**\n  - `surface`: `'operation' | 'event' | 'workflow' | 'presentation' | 'resource'`\n  - `name` / `version`: points to the declared contract (operation name, event name, etc.)\n  - optional `description`\n- **CapabilityRequirement**\n  - `key`: capability slug to satisfy\n  - `version?`: pin to an exact version when required (defaults to highest registered)\n  - `kind?`: extra guard if the same key hosts multiple kinds\n  - `optional?`: skip strict enforcement (informational requirement)\n  - `reason?`: why this dependency exists (docs + tooling)\n\n## Registry\n\n`CapabilityRegistry` provides:\n\n- `register(spec)`: register a capability (`key + version` must be unique)\n- `get(key, version?)`: retrieve the exact or highest version\n- `list()`: inspect all capabilities\n- `satisfies(requirement, additional?)`: check if a requirement is met (includes locally provided capabilities passed via `additional`)\n\n## Feature Integration\n\n`FeatureModuleSpec` now accepts:\n\n```ts\ncapabilities?: {\n  provides?: CapabilityRef[];    // capabilities this feature exposes\n  requires?: CapabilityRequirement[]; // capabilities the feature needs\n};\n```\n\nDuring `installFeature`:\n\n1. `provides` entries must exist in the `CapabilityRegistry`.\n2. `requires` entries must be satisfied either by:\n   - the same feature’s `provides`,\n   - or existing capabilities already registered in the global registry.\n\nErrors are thrown when dependencies cannot be satisfied, preventing unsafe module composition.\n\n## Authoring Guidelines\n\n1. **Register capability specs** in a shared package (e.g., `packages/.../capabilities`) before referencing them in features.\n2. **Version consciously**: bump capability versions when the provided surfaces or contract semantics change.\n3. **Document dependencies** via `reason` strings to help operators understand why a capability is required.\n4. **Prefer stable keys** that map to business/technical domains (`billing.invoices`, `payments.stripe`, `cms.assets`).\n5. When introducing new capability kinds, update the `CapabilityKind` union and accompanying docs/tests.\n\n## Tooling (Roadmap)\n\n- CLI validation warns when feature specs reference missing capabilities.\n- Future build steps will leverage capability data to scaffold adapters and enforce policy in generated code.\n- Capability metadata will surface in docs/LLM guides to describe module marketplaces and installation flows.\n\n"
+}];
+registerDocBlocks(tech_contracts_capabilities_DocBlocks);
+
+//#endregion
+export { tech_contracts_capabilities_DocBlocks };

package/dist/capabilities/index.d.ts

@@ -0,0 +1,3 @@
+import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability } from "./capabilities.js";
+import { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities } from "./openbanking.js";
+export { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability, openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };

package/dist/capabilities/index.js

@@ -0,0 +1,4 @@
+import { CapabilityRegistry, capabilityKey, defineCapability } from "./capabilities.js";
+import { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities } from "./openbanking.js";
+
+export { CapabilityRegistry, capabilityKey, defineCapability, openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };

package/dist/capabilities/openbanking.d.ts

@@ -0,0 +1,10 @@
+import { CapabilityRegistry, CapabilitySpec } from "./capabilities.js";
+import "./index.js";
+
+//#region src/capabilities/openbanking.d.ts
+declare const openBankingAccountsReadCapability: CapabilitySpec;
+declare const openBankingTransactionsReadCapability: CapabilitySpec;
+declare const openBankingBalancesReadCapability: CapabilitySpec;
+declare function registerOpenBankingCapabilities(registry: CapabilityRegistry): CapabilityRegistry;
+//#endregion
+export { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };

package/dist/capabilities/openbanking.js

@@ -1 +1,92 @@
-import{StabilityEnum as e}from"../ownership.js";const t=[`platform.finance`],n=[`open-banking`,`finance`],r={meta:{key:`openbanking.accounts.read`,version:1,kind:`integration`,title:`Open Banking Accounts (Read)`,description:`Provides read-only access to linked bank accounts, including account summaries and metadata.`,domain:`finance`,owners:[...t],tags:[...n],stability:e.Experimental},provides:[{surface:`operation`,name:`openbanking.accounts.list`,version:1,description:`List bank accounts linked to a Powens open banking connection.`},{surface:`operation`,name:`openbanking.accounts.get`,version:1,description:`Retrieve the canonical bank account record for a specific account.`},{surface:`operation`,name:`openbanking.accounts.sync`,version:1,description:`Trigger a refresh of bank account metadata from the open banking provider.`}]},i={meta:{key:`openbanking.transactions.read`,version:1,kind:`integration`,title:`Open Banking Transactions (Read)`,description:`Enables retrieval of transaction history for linked bank accounts via open banking providers.`,domain:`finance`,owners:[...t],tags:[...n,`transactions`],stability:e.Experimental},provides:[{surface:`operation`,name:`openbanking.transactions.list`,version:1,description:`List transactions for a given bank account with optional date filtering.`},{surface:`operation`,name:`openbanking.transactions.sync`,version:1,description:`Synchronise transactions from the open banking provider into the canonical ledger.`}]},a={meta:{key:`openbanking.balances.read`,version:1,kind:`integration`,title:`Open Banking Balances (Read)`,description:`Allows querying of current and available balances for linked bank accounts via open banking providers.`,domain:`finance`,owners:[...t],tags:[...n,`balances`],stability:e.Experimental},provides:[{surface:`operation`,name:`openbanking.balances.get`,version:1,description:`Retrieve the latest known balances for a specified bank account.`},{surface:`operation`,name:`openbanking.balances.refresh`,version:1,description:`Force a balance refresh from the open banking provider.`}]};function o(e){return e.register(r).register(i).register(a)}export{r as openBankingAccountsReadCapability,a as openBankingBalancesReadCapability,i as openBankingTransactionsReadCapability,o as registerOpenBankingCapabilities};
+import { StabilityEnum } from "../ownership.js";
+
+//#region src/capabilities/openbanking.ts
+const OWNERS = ["platform.finance"];
+const TAGS = ["open-banking", "finance"];
+const openBankingAccountsReadCapability = {
+	meta: {
+		key: "openbanking.accounts.read",
+		version: 1,
+		kind: "integration",
+		title: "Open Banking Accounts (Read)",
+		description: "Provides read-only access to linked bank accounts, including account summaries and metadata.",
+		domain: "finance",
+		owners: [...OWNERS],
+		tags: [...TAGS],
+		stability: StabilityEnum.Experimental
+	},
+	provides: [
+		{
+			surface: "operation",
+			key: "openbanking.accounts.list",
+			version: 1,
+			description: "List bank accounts linked to a Powens open banking connection."
+		},
+		{
+			surface: "operation",
+			key: "openbanking.accounts.get",
+			version: 1,
+			description: "Retrieve the canonical bank account record for a specific account."
+		},
+		{
+			surface: "operation",
+			key: "openbanking.accounts.sync",
+			version: 1,
+			description: "Trigger a refresh of bank account metadata from the open banking provider."
+		}
+	]
+};
+const openBankingTransactionsReadCapability = {
+	meta: {
+		key: "openbanking.transactions.read",
+		version: 1,
+		kind: "integration",
+		title: "Open Banking Transactions (Read)",
+		description: "Enables retrieval of transaction history for linked bank accounts via open banking providers.",
+		domain: "finance",
+		owners: [...OWNERS],
+		tags: [...TAGS, "transactions"],
+		stability: StabilityEnum.Experimental
+	},
+	provides: [{
+		surface: "operation",
+		key: "openbanking.transactions.list",
+		version: 1,
+		description: "List transactions for a given bank account with optional date filtering."
+	}, {
+		surface: "operation",
+		key: "openbanking.transactions.sync",
+		version: 1,
+		description: "Synchronise transactions from the open banking provider into the canonical ledger."
+	}]
+};
+const openBankingBalancesReadCapability = {
+	meta: {
+		key: "openbanking.balances.read",
+		version: 1,
+		kind: "integration",
+		title: "Open Banking Balances (Read)",
+		description: "Allows querying of current and available balances for linked bank accounts via open banking providers.",
+		domain: "finance",
+		owners: [...OWNERS],
+		tags: [...TAGS, "balances"],
+		stability: StabilityEnum.Experimental
+	},
+	provides: [{
+		surface: "operation",
+		key: "openbanking.balances.get",
+		version: 1,
+		description: "Retrieve the latest known balances for a specified bank account."
+	}, {
+		surface: "operation",
+		key: "openbanking.balances.refresh",
+		version: 1,
+		description: "Force a balance refresh from the open banking provider."
+	}]
+};
+function registerOpenBankingCapabilities(registry) {
+	return registry.register(openBankingAccountsReadCapability).register(openBankingTransactionsReadCapability).register(openBankingBalancesReadCapability);
+}
+
+//#endregion
+export { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };

package/dist/client/index.d.ts

@@ -0,0 +1,6 @@
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./react/feature-render.js";
+import { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, createFormRenderer } from "./react/form-render.js";
+import { ShadcnDriver, shadcnDriver } from "./react/drivers/shadcn.js";
+import { RnReusablesDriver, rnReusablesDriver } from "./react/drivers/rn-reusables.js";
+import "./react/index.js";
+export { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, RnReusablesDriver, ShadcnDriver, createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };

package/dist/client/index.js

@@ -1 +1,9 @@
-"use client";import{createEngineWithDefaults as e,createFeatureModule as t,registerFeature as n,renderFeaturePresentation as r}from"./react/feature-render.js";import{createFormRenderer as i}from"./react/form-render.js";import{shadcnDriver as a}from"./react/drivers/shadcn.js";import{rnReusablesDriver as o}from"./react/drivers/rn-reusables.js";import"./react/index.js";export{e as createEngineWithDefaults,t as createFeatureModule,i as createFormRenderer,n as registerFeature,r as renderFeaturePresentation,o as rnReusablesDriver,a as shadcnDriver};
+'use client';
+
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./react/feature-render.js";
+import { createFormRenderer } from "./react/form-render.js";
+import { shadcnDriver } from "./react/drivers/shadcn.js";
+import { rnReusablesDriver } from "./react/drivers/rn-reusables.js";
+import "./react/index.js";
+
+export { createEngineWithDefaults, createFeatureModule, createFormRenderer, registerFeature, renderFeaturePresentation, rnReusablesDriver, shadcnDriver };

package/dist/client/react/drivers/rn-reusables.d.ts

@@ -0,0 +1,22 @@
+import { DriverSlots } from "../form-render.js";
+
+//#region src/client/react/drivers/rn-reusables.d.ts
+
+/**
+ * Create a React Native UI-kit driver by mapping required slots to components.
+ * Host apps should import their UI-kit primitives and pass them here.
+ *
+ * Example usage:
+ * ```tsx
+ * import { rnReusablesDriver } from '@lssm/lib.contracts/client/react/drivers/rn-reusables';
+ * import { Input, Textarea, Button } from '@lssm/lib.ui-kit/ui';
+ *
+ * const driver = rnReusablesDriver({
+ *   Input, Textarea, Button, // ... other components
+ * });
+ * ```
+ */
+declare function rnReusablesDriver(slots: DriverSlots): DriverSlots;
+type RnReusablesDriver = ReturnType<typeof rnReusablesDriver>;
+//#endregion
+export { RnReusablesDriver, rnReusablesDriver };

package/dist/client/react/drivers/rn-reusables.js

@@ -1 +1,21 @@
-function e(e){return e}export{e as rnReusablesDriver};
+//#region src/client/react/drivers/rn-reusables.ts
+/**
+* Create a React Native UI-kit driver by mapping required slots to components.
+* Host apps should import their UI-kit primitives and pass them here.
+*
+* Example usage:
+* ```tsx
+* import { rnReusablesDriver } from '@lssm/lib.contracts/client/react/drivers/rn-reusables';
+* import { Input, Textarea, Button } from '@lssm/lib.ui-kit/ui';
+*
+* const driver = rnReusablesDriver({
+*   Input, Textarea, Button, // ... other components
+* });
+* ```
+*/
+function rnReusablesDriver(slots) {
+	return slots;
+}
+
+//#endregion
+export { rnReusablesDriver };

package/dist/client/react/drivers/shadcn.d.ts

@@ -0,0 +1,12 @@
+import { DriverSlots } from "../form-render.js";
+
+//#region src/client/react/drivers/shadcn.d.ts
+
+/**
+ * Create a shadcn/ui driver by mapping required slots to components.
+ * Host apps should import their shadcn primitives and pass them here.
+ */
+declare function shadcnDriver(slots: DriverSlots): DriverSlots;
+type ShadcnDriver = ReturnType<typeof shadcnDriver>;
+//#endregion
+export { ShadcnDriver, shadcnDriver };

package/dist/client/react/drivers/shadcn.js

@@ -1 +1,11 @@
-function e(e){return e}export{e as shadcnDriver};
+//#region src/client/react/drivers/shadcn.ts
+/**
+* Create a shadcn/ui driver by mapping required slots to components.
+* Host apps should import their shadcn primitives and pass them here.
+*/
+function shadcnDriver(slots) {
+	return slots;
+}
+
+//#endregion
+export { shadcnDriver };

package/dist/client/react/feature-render.d.ts

@@ -0,0 +1,21 @@
+import { PresentationSpec, PresentationTarget } from "../../presentations/presentations.js";
+import { ComponentMap, TransformEngine } from "../../presentations/transform-engine.js";
+import "../../presentations/index.js";
+import { FeatureModuleSpec, FeatureRegistry } from "../../features.js";
+import React from "react";
+import { BlockConfig } from "@blocknote/core";
+
+//#region src/client/react/feature-render.d.ts
+declare function createEngineWithDefaults(): TransformEngine;
+declare function renderFeaturePresentation(engine: TransformEngine, target: PresentationTarget, desc: PresentationSpec, options?: {
+  componentMap?: ComponentMap;
+  reactProps?: Record<string, unknown>;
+  renderBlockNote?: (docJson: unknown, blockConfig?: BlockConfig) => React.ReactElement;
+}): Promise<React.ReactElement | {
+  mimeType: string;
+  body: string;
+} | null>;
+declare function createFeatureModule(meta: FeatureModuleSpec['meta'], refs: Partial<Pick<FeatureModuleSpec, 'operations' | 'events' | 'presentations' | 'presentationsTargets'>>): FeatureModuleSpec;
+declare function registerFeature(registry: FeatureRegistry, feature: FeatureModuleSpec): FeatureRegistry;
+//#endregion
+export { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation };

package/dist/client/react/feature-render.js

@@ -1 +1,44 @@
-import{createDefaultTransformEngine as e,registerBasicValidation as t,registerDefaultReactRenderer as n}from"../../presentations.v2.js";import r from"react";function i(){return t(n(e()))}async function a(e,t,n,i){if(t===`react`){let t=await e.render(`react`,n);if(t.kind===`react_component`){let e=(i?.componentMap??{})[t.componentKey];if(!e)return null;let n={...t.props??{},...i?.reactProps??{}};return r.createElement(e,n)}return t.kind===`blocknotejs`?i?.renderBlockNote?i.renderBlockNote(t.docJson,t.blockConfig):r.createElement(`div`,{},`[BlockNote renderer not configured]`):null}return t===`markdown`||t===`application/json`||t===`application/xml`?e.render(t,n):null}function o(e,t){return{meta:e,...t}}function s(e,t){return e.register(t),e}export{i as createEngineWithDefaults,o as createFeatureModule,s as registerFeature,a as renderFeaturePresentation};
+import { createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer } from "../../presentations/transform-engine.js";
+import "../../presentations/index.js";
+import React from "react";
+
+//#region src/client/react/feature-render.ts
+function createEngineWithDefaults() {
+	return registerBasicValidation(registerDefaultReactRenderer(createDefaultTransformEngine()));
+}
+async function renderFeaturePresentation(engine, target, desc, options) {
+	if (target === "react") {
+		const rd = await engine.render("react", desc);
+		if (rd.kind === "react_component") {
+			const C = (options?.componentMap ?? {})[rd.componentKey];
+			if (!C) return null;
+			const merged = {
+				...rd.props ?? {},
+				...options?.reactProps ?? {}
+			};
+			return React.createElement(C, merged);
+		}
+		if (rd.kind === "blocknotejs") {
+			if (options?.renderBlockNote) return options.renderBlockNote(rd.docJson, rd.blockConfig);
+			return React.createElement("div", {}, "[BlockNote renderer not configured]");
+		}
+		return null;
+	}
+	if (target === "markdown") return engine.render(target, desc);
+	if (target === "application/json") return engine.render(target, desc);
+	if (target === "application/xml") return engine.render(target, desc);
+	return null;
+}
+function createFeatureModule(meta, refs) {
+	return {
+		meta,
+		...refs
+	};
+}
+function registerFeature(registry, feature) {
+	registry.register(feature);
+	return registry;
+}
+
+//#endregion
+export { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation };

package/dist/client/react/form-render.d.ts

@@ -0,0 +1,92 @@
+import { FormOption, FormSpec, FormValuesFor } from "../../forms/forms.js";
+import "../../forms/index.js";
+import { AnySchemaModel } from "@lssm/lib.schema";
+import React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/client/react/form-render.d.ts
+interface DriverSlots {
+  Field: React.ComponentType<React.PropsWithChildren<{
+    'data-invalid'?: boolean;
+    hidden?: boolean;
+    disabled?: boolean;
+  }>>;
+  FieldLabel: React.ComponentType<React.PropsWithChildren<{
+    htmlFor?: string;
+  }>>;
+  FieldDescription: React.ComponentType<React.PropsWithChildren<{}>>;
+  FieldError: React.ComponentType<{
+    errors: {
+      message?: string;
+    }[];
+  }>;
+  FieldGroup?: React.ComponentType<React.PropsWithChildren<{
+    className?: string;
+  }>>;
+  FieldSet?: React.ComponentType<React.PropsWithChildren<{
+    className?: string;
+  }>>;
+  FieldLegend?: React.ComponentType<React.PropsWithChildren<{
+    variant?: 'label' | 'default';
+  }>>;
+  Input: React.ComponentType<React.InputHTMLAttributes<HTMLInputElement>>;
+  Textarea: React.ComponentType<React.TextareaHTMLAttributes<HTMLTextAreaElement>>;
+  Select: React.ComponentType<{
+    id?: string;
+    name?: string;
+    value?: unknown;
+    onChange?: (v: unknown) => void;
+    disabled?: boolean;
+    'aria-invalid'?: boolean;
+    options: FormOption[];
+  } & Record<string, unknown>>;
+  Checkbox: React.ComponentType<{
+    id?: string;
+    name?: string;
+    checked?: boolean;
+    onCheckedChange?: (v: boolean) => void;
+    disabled?: boolean;
+  } & Record<string, unknown>>;
+  RadioGroup: React.ComponentType<{
+    id?: string;
+    name?: string;
+    value?: unknown;
+    onValueChange?: (v: unknown) => void;
+    disabled?: boolean;
+    options: FormOption[];
+  } & Record<string, unknown>>;
+  Switch: React.ComponentType<{
+    id?: string;
+    name?: string;
+    checked?: boolean;
+    onCheckedChange?: (v: boolean) => void;
+    disabled?: boolean;
+  } & Record<string, unknown>>;
+  Button: React.ComponentType<React.PropsWithChildren<{
+    type?: 'button' | 'submit' | 'reset';
+    variant?: string;
+    size?: string;
+    onClick?: () => void;
+    disabled?: boolean;
+  }>>;
+}
+type ResolverMap<TValues> = Record<string, (values: TValues, args?: unknown) => Promise<FormOption[]> | FormOption[]>;
+type ComputationMap<TValues> = Record<string, (values: TValues) => unknown>;
+interface CreateRendererOptions<TValues = Record<string, unknown>> {
+  driver: DriverSlots;
+  formOptions?: Record<string, unknown>;
+  onSubmitOverride?: (values: TValues, actionKey: string) => Promise<void> | void;
+  activeFlags?: string[];
+  resolvers?: ResolverMap<TValues>;
+  computations?: ComputationMap<TValues>;
+  unmountStrategy?: 'keep' | 'clear';
+}
+interface RenderOptions<TValues = Record<string, unknown>> {
+  defaultValues?: Partial<TValues>;
+  overrides?: Partial<CreateRendererOptions<TValues>>;
+}
+declare function createFormRenderer<M extends AnySchemaModel = AnySchemaModel>(base: CreateRendererOptions<FormValuesFor<M>>): {
+  render: (spec: FormSpec<M>, options?: RenderOptions<FormValuesFor<M>>) => react_jsx_runtime0.JSX.Element;
+};
+//#endregion
+export { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, createFormRenderer };