@formspec/runtime 0.1.0-alpha.0

package/dist/__tests__/resolvers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolvers.test.d.ts.map

package/dist/__tests__/resolvers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/resolvers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/resolvers.test.js

@@ -0,0 +1,71 @@
+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

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `@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, type Resolver, type ResolverMap, type ResolverRegistry, } from "./resolvers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * `@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";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EACL,eAAe,GAIhB,MAAM,gBAAgB,CAAC"}

package/dist/resolvers.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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.
+ */
+import type { DataSourceRegistry, FetchOptionsResponse, FormElement, FormSpec, DynamicEnumField, Group, Conditional } from "@formspec/core";
+/**
+ * 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 type Resolver<Source extends keyof DataSourceRegistry, T = DataSourceRegistry[Source]> = (params?: Record<string, unknown>) => Promise<FetchOptionsResponse<T>>;
+/**
+ * Extracts all dynamic enum source keys from a form's elements.
+ */
+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;
+type ExtractDynamicSourcesFromArray<Elements> = Elements extends readonly [
+    infer First,
+    ...infer Rest
+] ? ExtractDynamicSources<First> | ExtractDynamicSourcesFromArray<Rest> : never;
+/**
+ * Map of resolver functions for a form's dynamic data sources.
+ */
+export 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 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[];
+}
+/**
+ * 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>;
+export {};
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/resolvers.d.ts.map

@@ -0,0 +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"}

package/dist/resolvers.js

@@ -0,0 +1,88 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@formspec/runtime",
+  "version": "0.1.0-alpha.0",
+  "description": "Runtime helpers for FormSpec - resolvers and data fetching",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/runtime.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@formspec/core": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0",
+    "@formspec/dsl": "0.1.0-alpha.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [],
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist temp",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "api-extractor": "api-extractor run",
+    "api-extractor:local": "api-extractor run --local",
+    "api-documenter": "api-documenter markdown -i temp -o docs"
+  }
+}