@formspec/runtime 0.1.0-alpha.0 → 0.1.0-alpha.11

package/README.md

@@ -0,0 +1,127 @@
+# @formspec/runtime
+
+Runtime helpers for FormSpec - resolvers and data fetching.
+
+## Installation
+
+```bash
+npm install @formspec/runtime
+# or
+pnpm add @formspec/runtime
+```
+
+> **Note:** Most users should install the `formspec` umbrella package instead, which re-exports everything from this package.
+
+## Requirements
+
+This package is ESM-only and requires:
+
+```json
+// package.json
+{
+  "type": "module"
+}
+```
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext"
+  }
+}
+```
+
+## Usage
+
+### Define Resolvers for Dynamic Enums
+
+```typescript
+import { defineResolvers } from "@formspec/runtime";
+import { formspec, field } from "@formspec/dsl";
+
+// Define a form with dynamic enum fields
+const OrderForm = formspec(
+  field.dynamicEnum("country", "fetch_countries", { label: "Country" }),
+  field.dynamicEnum("state", "fetch_states", { label: "State" })
+);
+
+// Define type-safe resolvers
+const resolvers = defineResolvers(OrderForm, {
+  fetch_countries: async () => ({
+    options: [
+      { value: "us", label: "United States" },
+      { value: "ca", label: "Canada" },
+      { value: "uk", label: "United Kingdom" },
+    ],
+    validity: "valid",
+  }),
+
+  fetch_states: async (params) => {
+    // Params can include any context needed for the lookup (e.g. form data)
+    const response = await fetch(`/api/states?country=${params?.country}`);
+    const states = await response.json();
+    return {
+      options: states.map((s: { code: string; name: string }) => ({
+        value: s.code,
+        label: s.name,
+      })),
+      validity: "valid",
+    };
+  },
+});
+
+// Use the resolver
+const countries = await resolvers.get("fetch_countries")();
+console.log(countries.options);
+// [{ value: "us", label: "United States" }, ...]
+```
+
+### Resolver Response Format
+
+```typescript
+interface FetchOptionsResponse {
+  options: Array<{
+    value: string;
+    label: string;
+  }>;
+  validity: "valid" | "invalid" | "unknown";
+}
+```
+
+## API Reference
+
+### Functions
+
+| Function                           | Description                          |
+| ---------------------------------- | ------------------------------------ |
+| `defineResolvers(form, resolvers)` | Create a type-safe resolver registry |
+
+### Types
+
+| Type                  | Description                           |
+| --------------------- | ------------------------------------- |
+| `Resolver`            | Async function that fetches options   |
+| `ResolverMap<F>`      | Map of data source names to resolvers |
+| `ResolverRegistry<F>` | Registry with `get()` method          |
+
+## Type Safety
+
+The `defineResolvers` function enforces that:
+
+1. All data sources referenced in the form have corresponding resolvers
+2. Resolver names match the data source IDs in the form
+3. Return types match the expected `FetchOptionsResponse` format
+
+```typescript
+// TypeScript error: Missing resolver for "fetch_states"
+const resolvers = defineResolvers(OrderForm, {
+  fetch_countries: async () => ({ ... }),
+  // Error: 'fetch_states' is required
+});
+```
+
+## License
+
+UNLICENSED

package/dist/index.cjs

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  defineResolvers: () => defineResolvers
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/resolvers.ts
+function extractSources(elements) {
+  const sources = /* @__PURE__ */ new Set();
+  function visit(el) {
+    if (el._type === "field" && el._field === "dynamic_enum") {
+      const dynamicField = el;
+      sources.add(dynamicField.source);
+    } else if (el._type === "group") {
+      el.elements.forEach(visit);
+    } else if (el._type === "conditional") {
+      el.elements.forEach(visit);
+    }
+  }
+  elements.forEach(visit);
+  return sources;
+}
+function defineResolvers(form, resolvers) {
+  const sourceSet = extractSources(form.elements);
+  const resolverMap = new Map(
+    Object.entries(resolvers)
+  );
+  for (const source of sourceSet) {
+    if (!resolverMap.has(source)) {
+      console.warn(`Missing resolver for data source: ${source}`);
+    }
+  }
+  return {
+    get(source) {
+      const resolver = resolverMap.get(source);
+      if (resolver === void 0) {
+        throw new Error(`No resolver found for data source: ${source}`);
+      }
+      return resolver;
+    },
+    has(source) {
+      return resolverMap.has(source);
+    },
+    sources() {
+      return Array.from(resolverMap.keys());
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineResolvers
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/resolvers.ts"],"sourcesContent":["/**\n * `@formspec/runtime` - Runtime helpers for FormSpec\n *\n * This package provides utilities for working with FormSpec forms at runtime:\n * - `defineResolvers()` - Type-safe resolver definitions for dynamic enum fields\n *\n * @example\n * ```typescript\n * import { defineResolvers } from \"@formspec/runtime\";\n * import { formspec, field } from \"@formspec/dsl\";\n *\n * // Define a form with dynamic enum fields\n * const form = formspec(\n *   field.dynamicEnum(\"country\", \"countries\", { label: \"Country\" }),\n * );\n *\n * // Define resolvers for the form's data sources\n * const resolvers = defineResolvers(form, {\n *   countries: async () => ({\n *     options: [\n *       { value: \"us\", label: \"United States\" },\n *       { value: \"ca\", label: \"Canada\" },\n *     ],\n *     validity: \"valid\",\n *   }),\n * });\n *\n * // Use the resolver\n * const result = await resolvers.get(\"countries\")();\n * console.log(result.options); // [{ value: \"us\", ... }, { value: \"ca\", ... }]\n * ```\n *\n * @packageDocumentation\n */\n\nexport {\n  defineResolvers,\n  type Resolver,\n  type ResolverMap,\n  type ResolverRegistry,\n} from \"./resolvers.js\";\n","/**\n * Resolver helpers for dynamic FormSpec data.\n *\n * Resolvers are functions that fetch options for dynamic enum fields\n * at runtime. This module provides type-safe utilities for defining\n * and using resolvers.\n */\n\nimport type {\n  DataSourceRegistry,\n  FetchOptionsResponse,\n  FormElement,\n  FormSpec,\n  DynamicEnumField,\n  Group,\n  Conditional,\n} from \"@formspec/core\";\n\n/**\n * A resolver function that fetches options for a data source.\n *\n * @typeParam Source - The data source key from DataSourceRegistry\n * @typeParam T - The data type for options (from DataSourceRegistry)\n */\nexport type Resolver<Source extends keyof DataSourceRegistry, T = DataSourceRegistry[Source]> = (\n  params?: Record<string, unknown>\n) => Promise<FetchOptionsResponse<T>>;\n\n/**\n * Extracts all dynamic enum source keys from a form's elements.\n */\ntype ExtractDynamicSources<E> =\n  E extends DynamicEnumField<string, infer S>\n    ? S\n    : E extends Group<infer Elements>\n      ? ExtractDynamicSourcesFromArray<Elements>\n      : E extends Conditional<string, unknown, infer Elements>\n        ? ExtractDynamicSourcesFromArray<Elements>\n        : never;\n\ntype ExtractDynamicSourcesFromArray<Elements> = Elements extends readonly [\n  infer First,\n  ...infer Rest,\n]\n  ? ExtractDynamicSources<First> | ExtractDynamicSourcesFromArray<Rest>\n  : never;\n\n/**\n * Map of resolver functions for a form's dynamic data sources.\n */\nexport type ResolverMap<Sources extends string> = {\n  [S in Sources]: S extends keyof DataSourceRegistry\n    ? Resolver<S>\n    : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;\n};\n\n/**\n * A resolver registry that provides type-safe access to resolvers.\n */\nexport interface ResolverRegistry<Sources extends string> {\n  /**\n   * Gets a resolver by data source name.\n   */\n  get<S extends Sources>(\n    source: S\n  ): S extends keyof DataSourceRegistry\n    ? Resolver<S>\n    : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;\n\n  /**\n   * Checks if a resolver exists for a data source.\n   */\n  has(source: string): boolean;\n\n  /**\n   * Gets all registered data source names.\n   */\n  sources(): Sources[];\n}\n\n/**\n * Extracts all dynamic enum field sources from form elements.\n */\nfunction extractSources(elements: readonly FormElement[]): Set<string> {\n  const sources = new Set<string>();\n\n  function visit(el: FormElement): void {\n    if (el._type === \"field\" && el._field === \"dynamic_enum\") {\n      // After checking _field, we know this is a DynamicEnumField\n      const dynamicField: DynamicEnumField<string, string> = el;\n      sources.add(dynamicField.source);\n    } else if (el._type === \"group\") {\n      (el as Group<readonly FormElement[]>).elements.forEach(visit);\n    } else if (el._type === \"conditional\") {\n      (el as Conditional<string, unknown, readonly FormElement[]>).elements.forEach(visit);\n    }\n  }\n\n  elements.forEach(visit);\n  return sources;\n}\n\n/**\n * Defines resolvers for a form's dynamic data sources.\n *\n * This function provides type-safe resolver definitions that match\n * the form's dynamic enum fields.\n *\n * @example\n * ```typescript\n * declare module \"@formspec/core\" {\n *   interface DataSourceRegistry {\n *     countries: { id: string; code: string; name: string };\n *   }\n * }\n *\n * const form = formspec(\n *   field.dynamicEnum(\"country\", \"countries\", { label: \"Country\" }),\n * );\n *\n * const resolvers = defineResolvers(form, {\n *   countries: async () => ({\n *     options: [\n *       { value: \"us\", label: \"United States\", data: { id: \"us\", code: \"US\", name: \"United States\" } },\n *       { value: \"ca\", label: \"Canada\", data: { id: \"ca\", code: \"CA\", name: \"Canada\" } },\n *     ],\n *     validity: \"valid\",\n *   }),\n * });\n *\n * // Use the resolver\n * const result = await resolvers.get(\"countries\")();\n * ```\n *\n * @param form - The FormSpec containing dynamic enum fields\n * @param resolvers - Map of resolver functions for each data source\n * @returns A ResolverRegistry for type-safe access to resolvers\n */\nexport function defineResolvers<\n  E extends readonly FormElement[],\n  Sources extends string = ExtractDynamicSourcesFromArray<E> & string,\n>(form: FormSpec<E>, resolvers: ResolverMap<Sources>): ResolverRegistry<Sources> {\n  const sourceSet = extractSources(form.elements);\n  const resolverMap = new Map<string, Resolver<keyof DataSourceRegistry>>(\n    Object.entries(resolvers) as [string, Resolver<keyof DataSourceRegistry>][]\n  );\n\n  // Validate that all sources have resolvers\n  for (const source of sourceSet) {\n    if (!resolverMap.has(source)) {\n      console.warn(`Missing resolver for data source: ${source}`);\n    }\n  }\n\n  return {\n    get<S extends Sources>(source: S) {\n      const resolver = resolverMap.get(source);\n      if (resolver === undefined) {\n        throw new Error(`No resolver found for data source: ${source}`);\n      }\n      return resolver as S extends keyof DataSourceRegistry\n        ? Resolver<S>\n        : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;\n    },\n\n    has(source: string): boolean {\n      return resolverMap.has(source);\n    },\n\n    sources(): Sources[] {\n      return Array.from(resolverMap.keys()) as Sources[];\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmFA,SAAS,eAAe,UAA+C;AACrE,QAAM,UAAU,oBAAI,IAAY;AAEhC,WAAS,MAAM,IAAuB;AACpC,QAAI,GAAG,UAAU,WAAW,GAAG,WAAW,gBAAgB;AAExD,YAAM,eAAiD;AACvD,cAAQ,IAAI,aAAa,MAAM;AAAA,IACjC,WAAW,GAAG,UAAU,SAAS;AAC/B,MAAC,GAAqC,SAAS,QAAQ,KAAK;AAAA,IAC9D,WAAW,GAAG,UAAU,eAAe;AACrC,MAAC,GAA4D,SAAS,QAAQ,KAAK;AAAA,IACrF;AAAA,EACF;AAEA,WAAS,QAAQ,KAAK;AACtB,SAAO;AACT;AAsCO,SAAS,gBAGd,MAAmB,WAA4D;AAC/E,QAAM,YAAY,eAAe,KAAK,QAAQ;AAC9C,QAAM,cAAc,IAAI;AAAA,IACtB,OAAO,QAAQ,SAAS;AAAA,EAC1B;AAGA,aAAW,UAAU,WAAW;AAC9B,QAAI,CAAC,YAAY,IAAI,MAAM,GAAG;AAC5B,cAAQ,KAAK,qCAAqC,MAAM,EAAE;AAAA,IAC5D;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAuB,QAAW;AAChC,YAAM,WAAW,YAAY,IAAI,MAAM;AACvC,UAAI,aAAa,QAAW;AAC1B,cAAM,IAAI,MAAM,sCAAsC,MAAM,EAAE;AAAA,MAChE;AACA,aAAO;AAAA,IAGT;AAAA,IAEA,IAAI,QAAyB;AAC3B,aAAO,YAAY,IAAI,MAAM;AAAA,IAC/B;AAAA,IAEA,UAAqB;AACnB,aAAO,MAAM,KAAK,YAAY,KAAK,CAAC;AAAA,IACtC;AAAA,EACF;AACF;","names":[]}

package/dist/index.js

@@ -1,36 +1,46 @@
-/**
- * `@formspec/runtime` - Runtime helpers for FormSpec
- *
- * This package provides utilities for working with FormSpec forms at runtime:
- * - `defineResolvers()` - Type-safe resolver definitions for dynamic enum fields
- *
- * @example
- * ```typescript
- * import { defineResolvers } from "@formspec/runtime";
- * import { formspec, field } from "@formspec/dsl";
- *
- * // Define a form with dynamic enum fields
- * const form = formspec(
- *   field.dynamicEnum("country", "countries", { label: "Country" }),
- * );
- *
- * // Define resolvers for the form's data sources
- * const resolvers = defineResolvers(form, {
- *   countries: async () => ({
- *     options: [
- *       { value: "us", label: "United States" },
- *       { value: "ca", label: "Canada" },
- *     ],
- *     validity: "valid",
- *   }),
- * });
- *
- * // Use the resolver
- * const result = await resolvers.get("countries")();
- * console.log(result.options); // [{ value: "us", ... }, { value: "ca", ... }]
- * ```
- *
- * @packageDocumentation
- */
-export { defineResolvers, } from "./resolvers.js";
+// src/resolvers.ts
+function extractSources(elements) {
+  const sources = /* @__PURE__ */ new Set();
+  function visit(el) {
+    if (el._type === "field" && el._field === "dynamic_enum") {
+      const dynamicField = el;
+      sources.add(dynamicField.source);
+    } else if (el._type === "group") {
+      el.elements.forEach(visit);
+    } else if (el._type === "conditional") {
+      el.elements.forEach(visit);
+    }
+  }
+  elements.forEach(visit);
+  return sources;
+}
+function defineResolvers(form, resolvers) {
+  const sourceSet = extractSources(form.elements);
+  const resolverMap = new Map(
+    Object.entries(resolvers)
+  );
+  for (const source of sourceSet) {
+    if (!resolverMap.has(source)) {
+      console.warn(`Missing resolver for data source: ${source}`);
+    }
+  }
+  return {
+    get(source) {
+      const resolver = resolverMap.get(source);
+      if (resolver === void 0) {
+        throw new Error(`No resolver found for data source: ${source}`);
+      }
+      return resolver;
+    },
+    has(source) {
+      return resolverMap.has(source);
+    },
+    sources() {
+      return Array.from(resolverMap.keys());
+    }
+  };
+}
+export {
+  defineResolvers
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,eAAe,GAIhB,MAAM,gBAAgB,CAAC"}
+{"version":3,"sources":["../src/resolvers.ts"],"sourcesContent":["/**\n * Resolver helpers for dynamic FormSpec data.\n *\n * Resolvers are functions that fetch options for dynamic enum fields\n * at runtime. This module provides type-safe utilities for defining\n * and using resolvers.\n */\n\nimport type {\n  DataSourceRegistry,\n  FetchOptionsResponse,\n  FormElement,\n  FormSpec,\n  DynamicEnumField,\n  Group,\n  Conditional,\n} from \"@formspec/core\";\n\n/**\n * A resolver function that fetches options for a data source.\n *\n * @typeParam Source - The data source key from DataSourceRegistry\n * @typeParam T - The data type for options (from DataSourceRegistry)\n */\nexport type Resolver<Source extends keyof DataSourceRegistry, T = DataSourceRegistry[Source]> = (\n  params?: Record<string, unknown>\n) => Promise<FetchOptionsResponse<T>>;\n\n/**\n * Extracts all dynamic enum source keys from a form's elements.\n */\ntype ExtractDynamicSources<E> =\n  E extends DynamicEnumField<string, infer S>\n    ? S\n    : E extends Group<infer Elements>\n      ? ExtractDynamicSourcesFromArray<Elements>\n      : E extends Conditional<string, unknown, infer Elements>\n        ? ExtractDynamicSourcesFromArray<Elements>\n        : never;\n\ntype ExtractDynamicSourcesFromArray<Elements> = Elements extends readonly [\n  infer First,\n  ...infer Rest,\n]\n  ? ExtractDynamicSources<First> | ExtractDynamicSourcesFromArray<Rest>\n  : never;\n\n/**\n * Map of resolver functions for a form's dynamic data sources.\n */\nexport type ResolverMap<Sources extends string> = {\n  [S in Sources]: S extends keyof DataSourceRegistry\n    ? Resolver<S>\n    : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;\n};\n\n/**\n * A resolver registry that provides type-safe access to resolvers.\n */\nexport interface ResolverRegistry<Sources extends string> {\n  /**\n   * Gets a resolver by data source name.\n   */\n  get<S extends Sources>(\n    source: S\n  ): S extends keyof DataSourceRegistry\n    ? Resolver<S>\n    : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;\n\n  /**\n   * Checks if a resolver exists for a data source.\n   */\n  has(source: string): boolean;\n\n  /**\n   * Gets all registered data source names.\n   */\n  sources(): Sources[];\n}\n\n/**\n * Extracts all dynamic enum field sources from form elements.\n */\nfunction extractSources(elements: readonly FormElement[]): Set<string> {\n  const sources = new Set<string>();\n\n  function visit(el: FormElement): void {\n    if (el._type === \"field\" && el._field === \"dynamic_enum\") {\n      // After checking _field, we know this is a DynamicEnumField\n      const dynamicField: DynamicEnumField<string, string> = el;\n      sources.add(dynamicField.source);\n    } else if (el._type === \"group\") {\n      (el as Group<readonly FormElement[]>).elements.forEach(visit);\n    } else if (el._type === \"conditional\") {\n      (el as Conditional<string, unknown, readonly FormElement[]>).elements.forEach(visit);\n    }\n  }\n\n  elements.forEach(visit);\n  return sources;\n}\n\n/**\n * Defines resolvers for a form's dynamic data sources.\n *\n * This function provides type-safe resolver definitions that match\n * the form's dynamic enum fields.\n *\n * @example\n * ```typescript\n * declare module \"@formspec/core\" {\n *   interface DataSourceRegistry {\n *     countries: { id: string; code: string; name: string };\n *   }\n * }\n *\n * const form = formspec(\n *   field.dynamicEnum(\"country\", \"countries\", { label: \"Country\" }),\n * );\n *\n * const resolvers = defineResolvers(form, {\n *   countries: async () => ({\n *     options: [\n *       { value: \"us\", label: \"United States\", data: { id: \"us\", code: \"US\", name: \"United States\" } },\n *       { value: \"ca\", label: \"Canada\", data: { id: \"ca\", code: \"CA\", name: \"Canada\" } },\n *     ],\n *     validity: \"valid\",\n *   }),\n * });\n *\n * // Use the resolver\n * const result = await resolvers.get(\"countries\")();\n * ```\n *\n * @param form - The FormSpec containing dynamic enum fields\n * @param resolvers - Map of resolver functions for each data source\n * @returns A ResolverRegistry for type-safe access to resolvers\n */\nexport function defineResolvers<\n  E extends readonly FormElement[],\n  Sources extends string = ExtractDynamicSourcesFromArray<E> & string,\n>(form: FormSpec<E>, resolvers: ResolverMap<Sources>): ResolverRegistry<Sources> {\n  const sourceSet = extractSources(form.elements);\n  const resolverMap = new Map<string, Resolver<keyof DataSourceRegistry>>(\n    Object.entries(resolvers) as [string, Resolver<keyof DataSourceRegistry>][]\n  );\n\n  // Validate that all sources have resolvers\n  for (const source of sourceSet) {\n    if (!resolverMap.has(source)) {\n      console.warn(`Missing resolver for data source: ${source}`);\n    }\n  }\n\n  return {\n    get<S extends Sources>(source: S) {\n      const resolver = resolverMap.get(source);\n      if (resolver === undefined) {\n        throw new Error(`No resolver found for data source: ${source}`);\n      }\n      return resolver as S extends keyof DataSourceRegistry\n        ? Resolver<S>\n        : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;\n    },\n\n    has(source: string): boolean {\n      return resolverMap.has(source);\n    },\n\n    sources(): Sources[] {\n      return Array.from(resolverMap.keys()) as Sources[];\n    },\n  };\n}\n"],"mappings":";AAmFA,SAAS,eAAe,UAA+C;AACrE,QAAM,UAAU,oBAAI,IAAY;AAEhC,WAAS,MAAM,IAAuB;AACpC,QAAI,GAAG,UAAU,WAAW,GAAG,WAAW,gBAAgB;AAExD,YAAM,eAAiD;AACvD,cAAQ,IAAI,aAAa,MAAM;AAAA,IACjC,WAAW,GAAG,UAAU,SAAS;AAC/B,MAAC,GAAqC,SAAS,QAAQ,KAAK;AAAA,IAC9D,WAAW,GAAG,UAAU,eAAe;AACrC,MAAC,GAA4D,SAAS,QAAQ,KAAK;AAAA,IACrF;AAAA,EACF;AAEA,WAAS,QAAQ,KAAK;AACtB,SAAO;AACT;AAsCO,SAAS,gBAGd,MAAmB,WAA4D;AAC/E,QAAM,YAAY,eAAe,KAAK,QAAQ;AAC9C,QAAM,cAAc,IAAI;AAAA,IACtB,OAAO,QAAQ,SAAS;AAAA,EAC1B;AAGA,aAAW,UAAU,WAAW;AAC9B,QAAI,CAAC,YAAY,IAAI,MAAM,GAAG;AAC5B,cAAQ,KAAK,qCAAqC,MAAM,EAAE;AAAA,IAC5D;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAuB,QAAW;AAChC,YAAM,WAAW,YAAY,IAAI,MAAM;AACvC,UAAI,aAAa,QAAW;AAC1B,cAAM,IAAI,MAAM,sCAAsC,MAAM,EAAE;AAAA,MAChE;AACA,aAAO;AAAA,IAGT;AAAA,IAEA,IAAI,QAAyB;AAC3B,aAAO,YAAY,IAAI,MAAM;AAAA,IAC/B;AAAA,IAEA,UAAqB;AACnB,aAAO,MAAM,KAAK,YAAY,KAAK,CAAC;AAAA,IACtC;AAAA,EACF;AACF;","names":[]}

package/dist/resolvers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../src/resolvers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAClB,MAAM,SAAS,MAAM,kBAAkB,EACvC,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAC5B,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3E;;GAEG;AACH,KAAK,qBAAqB,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvE,CAAC,GACD,CAAC,SAAS,KAAK,CAAC,MAAM,QAAQ,CAAC,GAC7B,8BAA8B,CAAC,QAAQ,CAAC,GACxC,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC,GACpD,8BAA8B,CAAC,QAAQ,CAAC,GACxC,KAAK,CAAC;AAEd,KAAK,8BAA8B,CAAC,QAAQ,IAAI,QAAQ,SAAS,SAAS;IACxE,MAAM,KAAK;IACX,GAAG,MAAM,IAAI;CACd,GACG,qBAAqB,CAAC,KAAK,CAAC,GAAG,8BAA8B,CAAC,IAAI,CAAC,GACnE,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,MAAM,IAAI;KAC/C,CAAC,IAAI,OAAO,GAAG,CAAC,SAAS,MAAM,kBAAkB,GAC9C,QAAQ,CAAC,CAAC,CAAC,GACX,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC;CACxE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM;IACtD;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EACnB,MAAM,EAAE,CAAC,GACR,CAAC,SAAS,MAAM,kBAAkB,GACjC,QAAQ,CAAC,CAAC,CAAC,GACX,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAExE;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;OAEG;IACH,OAAO,IAAI,OAAO,EAAE,CAAC;CACtB;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,SAAS,WAAW,EAAE,EAChC,OAAO,SAAS,MAAM,GAAG,8BAA8B,CAAC,CAAC,CAAC,GAAG,MAAM,EAEnE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,GAC9B,gBAAgB,CAAC,OAAO,CAAC,CAgC3B"}
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../src/resolvers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAAC,MAAM,SAAS,MAAM,kBAAkB,EAAE,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAC9F,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtC;;GAEG;AACH,KAAK,qBAAqB,CAAC,CAAC,IAC1B,CAAC,SAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,CAAC,GACD,CAAC,SAAS,KAAK,CAAC,MAAM,QAAQ,CAAC,GAC7B,8BAA8B,CAAC,QAAQ,CAAC,GACxC,CAAC,SAAS,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC,GACpD,8BAA8B,CAAC,QAAQ,CAAC,GACxC,KAAK,CAAC;AAEhB,KAAK,8BAA8B,CAAC,QAAQ,IAAI,QAAQ,SAAS,SAAS;IACxE,MAAM,KAAK;IACX,GAAG,MAAM,IAAI;CACd,GACG,qBAAqB,CAAC,KAAK,CAAC,GAAG,8BAA8B,CAAC,IAAI,CAAC,GACnE,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,MAAM,IAAI;KAC/C,CAAC,IAAI,OAAO,GAAG,CAAC,SAAS,MAAM,kBAAkB,GAC9C,QAAQ,CAAC,CAAC,CAAC,GACX,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC;CACxE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,MAAM;IACtD;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,EACnB,MAAM,EAAE,CAAC,GACR,CAAC,SAAS,MAAM,kBAAkB,GACjC,QAAQ,CAAC,CAAC,CAAC,GACX,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAExE;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;OAEG;IACH,OAAO,IAAI,OAAO,EAAE,CAAC;CACtB;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,SAAS,WAAW,EAAE,EAChC,OAAO,SAAS,MAAM,GAAG,8BAA8B,CAAC,CAAC,CAAC,GAAG,MAAM,EACnE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAgC/E"}

package/dist/runtime.d.ts

@@ -0,0 +1,125 @@
+/**
+ * `@formspec/runtime` - Runtime helpers for FormSpec
+ *
+ * This package provides utilities for working with FormSpec forms at runtime:
+ * - `defineResolvers()` - Type-safe resolver definitions for dynamic enum fields
+ *
+ * @example
+ * ```typescript
+ * import { defineResolvers } from "@formspec/runtime";
+ * import { formspec, field } from "@formspec/dsl";
+ *
+ * // Define a form with dynamic enum fields
+ * const form = formspec(
+ *   field.dynamicEnum("country", "countries", { label: "Country" }),
+ * );
+ *
+ * // Define resolvers for the form's data sources
+ * const resolvers = defineResolvers(form, {
+ *   countries: async () => ({
+ *     options: [
+ *       { value: "us", label: "United States" },
+ *       { value: "ca", label: "Canada" },
+ *     ],
+ *     validity: "valid",
+ *   }),
+ * });
+ *
+ * // Use the resolver
+ * const result = await resolvers.get("countries")();
+ * console.log(result.options); // [{ value: "us", ... }, { value: "ca", ... }]
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+import type { Conditional } from '@formspec/core';
+import type { DataSourceRegistry } from '@formspec/core';
+import type { DynamicEnumField } from '@formspec/core';
+import type { FetchOptionsResponse } from '@formspec/core';
+import type { FormElement } from '@formspec/core';
+import type { FormSpec } from '@formspec/core';
+import type { Group } from '@formspec/core';
+
+/**
+ * Defines resolvers for a form's dynamic data sources.
+ *
+ * This function provides type-safe resolver definitions that match
+ * the form's dynamic enum fields.
+ *
+ * @example
+ * ```typescript
+ * declare module "@formspec/core" {
+ *   interface DataSourceRegistry {
+ *     countries: { id: string; code: string; name: string };
+ *   }
+ * }
+ *
+ * const form = formspec(
+ *   field.dynamicEnum("country", "countries", { label: "Country" }),
+ * );
+ *
+ * const resolvers = defineResolvers(form, {
+ *   countries: async () => ({
+ *     options: [
+ *       { value: "us", label: "United States", data: { id: "us", code: "US", name: "United States" } },
+ *       { value: "ca", label: "Canada", data: { id: "ca", code: "CA", name: "Canada" } },
+ *     ],
+ *     validity: "valid",
+ *   }),
+ * });
+ *
+ * // Use the resolver
+ * const result = await resolvers.get("countries")();
+ * ```
+ *
+ * @param form - The FormSpec containing dynamic enum fields
+ * @param resolvers - Map of resolver functions for each data source
+ * @returns A ResolverRegistry for type-safe access to resolvers
+ */
+export declare function defineResolvers<E extends readonly FormElement[], Sources extends string = ExtractDynamicSourcesFromArray<E> & string>(form: FormSpec<E>, resolvers: ResolverMap<Sources>): ResolverRegistry<Sources>;
+
+/**
+ * Extracts all dynamic enum source keys from a form's elements.
+ */
+declare type ExtractDynamicSources<E> = E extends DynamicEnumField<string, infer S> ? S : E extends Group<infer Elements> ? ExtractDynamicSourcesFromArray<Elements> : E extends Conditional<string, unknown, infer Elements> ? ExtractDynamicSourcesFromArray<Elements> : never;
+
+declare type ExtractDynamicSourcesFromArray<Elements> = Elements extends readonly [
+infer First,
+...infer Rest
+] ? ExtractDynamicSources<First> | ExtractDynamicSourcesFromArray<Rest> : never;
+
+/**
+ * A resolver function that fetches options for a data source.
+ *
+ * @typeParam Source - The data source key from DataSourceRegistry
+ * @typeParam T - The data type for options (from DataSourceRegistry)
+ */
+export declare type Resolver<Source extends keyof DataSourceRegistry, T = DataSourceRegistry[Source]> = (params?: Record<string, unknown>) => Promise<FetchOptionsResponse<T>>;
+
+/**
+ * Map of resolver functions for a form's dynamic data sources.
+ */
+export declare type ResolverMap<Sources extends string> = {
+    [S in Sources]: S extends keyof DataSourceRegistry ? Resolver<S> : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;
+};
+
+/**
+ * A resolver registry that provides type-safe access to resolvers.
+ */
+export declare interface ResolverRegistry<Sources extends string> {
+    /**
+     * Gets a resolver by data source name.
+     */
+    get<S extends Sources>(source: S): S extends keyof DataSourceRegistry ? Resolver<S> : (params?: Record<string, unknown>) => Promise<FetchOptionsResponse>;
+    /**
+     * Checks if a resolver exists for a data source.
+     */
+    has(source: string): boolean;
+    /**
+     * Gets all registered data source names.
+     */
+    sources(): Sources[];
+}
+
+export { }

package/package.json

@@ -1,25 +1,28 @@
 {
   "name": "@formspec/runtime",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.11",
   "description": "Runtime helpers for FormSpec - resolvers and data fetching",
   "type": "module",
-  "main": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/runtime.d.ts",
   "exports": {
     ".": {
       "types": "./dist/runtime.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "dependencies": {
-    "@formspec/core": "0.1.0-alpha.0"
+    "@formspec/core": "0.1.0-alpha.11"
   },
   "devDependencies": {
     "vitest": "^3.0.0",
-    "@formspec/dsl": "0.1.0-alpha.0"
+    "@formspec/dsl": "0.1.0-alpha.11"
   },
   "publishConfig": {
     "access": "public"
@@ -27,7 +30,7 @@
   "keywords": [],
   "license": "UNLICENSED",
   "scripts": {
-    "build": "tsc",
+    "build": "tsup && tsc --emitDeclarationOnly && api-extractor run --local",
     "clean": "rm -rf dist temp",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/dist/__tests__/resolvers.test.js

@@ -1,71 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { defineResolvers } from "../index.js";
-import { formspec, field, group, when, is } from "@formspec/dsl";
-// Note: In real usage, you would augment DataSourceRegistry.
-// For tests, we work with the generic types.
-describe("defineResolvers", () => {
-    it("should create a resolver registry", () => {
-        const form = formspec(field.dynamicEnum("country", "countries", { label: "Country" }));
-        const resolvers = defineResolvers(form, {
-            countries: async () => ({
-                options: [
-                    { value: "us", label: "United States" },
-                    { value: "ca", label: "Canada" },
-                ],
-                validity: "valid",
-            }),
-        });
-        expect(resolvers.has("countries")).toBe(true);
-        expect(resolvers.sources()).toEqual(["countries"]);
-    });
-    it("should fetch options from resolver", async () => {
-        const form = formspec(field.dynamicEnum("country", "countries"));
-        const resolvers = defineResolvers(form, {
-            countries: async () => ({
-                options: [
-                    { value: "us", label: "United States" },
-                ],
-                validity: "valid",
-            }),
-        });
-        const result = await resolvers.get("countries")();
-        expect(result.validity).toBe("valid");
-        expect(result.options).toHaveLength(1);
-        expect(result.options[0]?.value).toBe("us");
-    });
-    it("should extract sources from nested groups", () => {
-        const form = formspec(group("Location", field.dynamicEnum("country", "countries"), field.dynamicEnum("city", "cities")));
-        const resolvers = defineResolvers(form, {
-            countries: async () => ({ options: [], validity: "valid" }),
-            cities: async () => ({ options: [], validity: "valid" }),
-        });
-        expect(resolvers.sources().sort()).toEqual(["cities", "countries"]);
-    });
-    it("should extract sources from conditionals", () => {
-        const form = formspec(field.enum("type", ["a", "b"]), when(is("type", "a"), field.dynamicEnum("extra", "extras")));
-        const resolvers = defineResolvers(form, {
-            extras: async () => ({ options: [], validity: "valid" }),
-        });
-        expect(resolvers.has("extras")).toBe(true);
-    });
-    it("should throw when getting unknown resolver", () => {
-        const form = formspec(field.dynamicEnum("country", "countries"));
-        const resolvers = defineResolvers(form, {
-            countries: async () => ({ options: [], validity: "valid" }),
-        });
-        expect(() => resolvers.get("unknown")).toThrow("No resolver found for data source: unknown");
-    });
-    it("should pass params to resolver", async () => {
-        const form = formspec(field.dynamicEnum("product", "products", { params: ["merchantId"] }));
-        let receivedParams;
-        const resolvers = defineResolvers(form, {
-            products: async (params) => {
-                receivedParams = params;
-                return { options: [], validity: "valid" };
-            },
-        });
-        await resolvers.get("products")({ merchantId: "123" });
-        expect(receivedParams).toEqual({ merchantId: "123" });
-    });
-});
-//# sourceMappingURL=resolvers.test.js.map

package/dist/__tests__/resolvers.test.js.map

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

package/dist/resolvers.js

@@ -1,88 +0,0 @@
-/**
- * Resolver helpers for dynamic FormSpec data.
- *
- * Resolvers are functions that fetch options for dynamic enum fields
- * at runtime. This module provides type-safe utilities for defining
- * and using resolvers.
- */
-/**
- * Extracts all dynamic enum field sources from form elements.
- */
-function extractSources(elements) {
-    const sources = new Set();
-    function visit(el) {
-        if (el._type === "field" && el._field === "dynamic_enum") {
-            sources.add(el.source);
-        }
-        else if (el._type === "group") {
-            el.elements.forEach(visit);
-        }
-        else if (el._type === "conditional") {
-            el.elements.forEach(visit);
-        }
-    }
-    elements.forEach(visit);
-    return sources;
-}
-/**
- * Defines resolvers for a form's dynamic data sources.
- *
- * This function provides type-safe resolver definitions that match
- * the form's dynamic enum fields.
- *
- * @example
- * ```typescript
- * declare module "@formspec/core" {
- *   interface DataSourceRegistry {
- *     countries: { id: string; code: string; name: string };
- *   }
- * }
- *
- * const form = formspec(
- *   field.dynamicEnum("country", "countries", { label: "Country" }),
- * );
- *
- * const resolvers = defineResolvers(form, {
- *   countries: async () => ({
- *     options: [
- *       { value: "us", label: "United States", data: { id: "us", code: "US", name: "United States" } },
- *       { value: "ca", label: "Canada", data: { id: "ca", code: "CA", name: "Canada" } },
- *     ],
- *     validity: "valid",
- *   }),
- * });
- *
- * // Use the resolver
- * const result = await resolvers.get("countries")();
- * ```
- *
- * @param form - The FormSpec containing dynamic enum fields
- * @param resolvers - Map of resolver functions for each data source
- * @returns A ResolverRegistry for type-safe access to resolvers
- */
-export function defineResolvers(form, resolvers) {
-    const sourceSet = extractSources(form.elements);
-    const resolverMap = new Map(Object.entries(resolvers));
-    // Validate that all sources have resolvers
-    for (const source of sourceSet) {
-        if (!resolverMap.has(source)) {
-            console.warn(`Missing resolver for data source: ${source}`);
-        }
-    }
-    return {
-        get(source) {
-            const resolver = resolverMap.get(source);
-            if (resolver === undefined) {
-                throw new Error(`No resolver found for data source: ${source}`);
-            }
-            return resolver;
-        },
-        has(source) {
-            return resolverMap.has(source);
-        },
-        sources() {
-            return Array.from(resolverMap.keys());
-        },
-    };
-}
-//# sourceMappingURL=resolvers.js.map

package/dist/resolvers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolvers.js","sourceRoot":"","sources":["../src/resolvers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0EH;;GAEG;AACH,SAAS,cAAc,CAAC,QAAgC;IACtD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,SAAS,KAAK,CAAC,EAAe;QAC5B,IAAI,EAAE,CAAC,KAAK,KAAK,OAAO,IAAI,EAAE,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;YACzD,OAAO,CAAC,GAAG,CAAE,EAAuC,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;aAAM,IAAI,EAAE,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC/B,EAAoC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,EAAE,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;YACrC,EAA2D,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,eAAe,CAI7B,IAAiB,EACjB,SAA+B;IAE/B,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAwD,CACjF,CAAC;IAEF,2CAA2C;IAC3C,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,CAAoB,MAAS;YAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,QAEgE,CAAC;QAC1E,CAAC;QAED,GAAG,CAAC,MAAc;YAChB,OAAO,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QAED,OAAO;YACL,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAc,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}