@formspec/runtime 0.1.0-alpha.10 → 0.1.0-alpha.12

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/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@formspec/runtime",
-  "version": "0.1.0-alpha.10",
+  "version": "0.1.0-alpha.12",
   "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": [
@@ -16,11 +18,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@formspec/core": "0.1.0-alpha.10"
+    "@formspec/core": "0.1.0-alpha.12"
   },
   "devDependencies": {
     "vitest": "^3.0.0",
-    "@formspec/dsl": "0.1.0-alpha.10"
+    "@formspec/dsl": "0.1.0-alpha.12"
   },
   "publishConfig": {
     "access": "public"
@@ -28,7 +30,7 @@
   "keywords": [],
   "license": "UNLICENSED",
   "scripts": {
-    "build": "tsc && api-extractor run --local",
+    "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,88 +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 () => {
-                await Promise.resolve(); // Needed for async interface compliance
-                return {
-                    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 () => {
-                await Promise.resolve(); // Needed for async interface compliance
-                return {
-                    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 () => {
-                await Promise.resolve(); // Needed for async interface compliance
-                return { options: [], validity: "valid" };
-            },
-            cities: async () => {
-                await Promise.resolve(); // Needed for async interface compliance
-                return { 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 () => {
-                await Promise.resolve(); // Needed for async interface compliance
-                return { 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 () => {
-                await Promise.resolve(); // Needed for async interface compliance
-                return { 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) => {
-                await Promise.resolve(); // Needed for async interface compliance
-                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,90 +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") {
-            // After checking _field, we know this is a DynamicEnumField
-            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;
-}
-/**
- * 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,4DAA4D;YAC5D,MAAM,YAAY,GAAqC,EAAE,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACnC,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,CAG7B,IAAiB,EAAE,SAA+B;IAClD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAmD,CAC5E,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"}