@timeax/form-palette 0.0.3 → 0.0.4

package/dist/core/bound/observe-bound-field.js

@@ -0,0 +1,116 @@
+// src/core/bound/observe-bound-field.ts
+/** Get the live bound field (if mounted and present). */
+export function getBoundField(host, bindId) {
+    return host.getBind(bindId);
+}
+export function hasBoundField(host, bindId) {
+    return !!getBoundField(host, bindId);
+}
+export function readBoundValue(host, bindId) {
+    return getBoundField(host, bindId)?.value;
+}
+export function setBoundValue(host, bindId, value, variant = "util") {
+    const f = getBoundField(host, bindId);
+    if (!f)
+        return false;
+    f.value = value;
+    // optional: dirty/enable logic if host supports it
+    try {
+        host.controlButton?.();
+    }
+    catch {
+        // ignore
+    }
+    f.onChange?.(value, undefined, variant);
+    return true;
+}
+export function setBoundError(_host, // host not strictly needed here
+bindId, msg) {
+    const f = _host.getBind(bindId);
+    if (!f)
+        return false;
+    f.error = msg ?? "";
+    return true;
+}
+export function validateBoundField(host, bindId, report = true) {
+    const f = getBoundField(host, bindId);
+    if (!f)
+        return false;
+    return !!f.validate?.(report);
+}
+/**
+ * Observe a bound field for value/error + liveness.
+ */
+export function observeBoundField(host, bindId, handler, pollMs = 300) {
+    let current = getBoundField(host, bindId);
+    let restoreOnChange;
+    const fire = () => {
+        if (!current) {
+            handler({ exists: false });
+            return;
+        }
+        handler({
+            exists: true,
+            field: current,
+            value: current.value,
+            error: current.error,
+        });
+    };
+    const wire = () => {
+        const f = getBoundField(host, bindId);
+        if (f === current)
+            return;
+        if (current && restoreOnChange) {
+            current.onChange = restoreOnChange;
+            restoreOnChange = undefined;
+        }
+        current = f;
+        if (current) {
+            restoreOnChange = current.onChange;
+            current.onChange = (next, prev, variant) => {
+                restoreOnChange?.(next, prev, variant);
+                handler({
+                    exists: true,
+                    field: current,
+                    value: next,
+                    error: current.error,
+                });
+            };
+        }
+        fire();
+    };
+    // initial
+    wire();
+    let intervalId;
+    if (typeof window !== "undefined") {
+        intervalId = window.setInterval(wire, pollMs);
+    }
+    let mo;
+    if (typeof MutationObserver !== "undefined" &&
+        typeof document !== "undefined") {
+        try {
+            mo = new MutationObserver(wire);
+            mo.observe(document.body, {
+                childList: true,
+                subtree: true,
+            });
+        }
+        catch {
+            // ignore
+        }
+    }
+    return () => {
+        if (typeof window !== "undefined" && typeof intervalId === "number") {
+            window.clearInterval(intervalId);
+        }
+        if (mo) {
+            mo.disconnect();
+            mo = undefined;
+        }
+        if (current && restoreOnChange) {
+            current.onChange = restoreOnChange;
+            restoreOnChange = undefined;
+        }
+    };
+}
+//# sourceMappingURL=observe-bound-field.js.map

package/dist/core/bound/observe-bound-field.js.map

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

package/dist/core/bound/wait-for-bound-field.d.ts

@@ -0,0 +1,5 @@
+import type { Dict } from "@/schema/core";
+import type { Field } from "@/schema/field";
+import type { BindHost } from "@/core/bound/bind-host";
+export declare function waitForBoundField<V extends Dict>(host: BindHost<V>, bindId: string, timeoutMs?: number): Promise<Field>;
+//# sourceMappingURL=wait-for-bound-field.d.ts.map

package/dist/core/bound/wait-for-bound-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-bound-field.d.ts","sourceRoot":"","sources":["../../../src/core/bound/wait-for-bound-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAMvD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,IAAI,EAC5C,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,SAAO,GACjB,OAAO,CAAC,KAAK,CAAC,CA0ChB"}

package/dist/core/bound/wait-for-bound-field.js

@@ -0,0 +1,35 @@
+// src/core/bound/wait-for-bound-field.ts
+import { getBoundField, observeBoundField, } from "@/core/bound/observe-bound-field";
+export function waitForBoundField(host, bindId, timeoutMs = 5000) {
+    const existing = getBoundField(host, bindId);
+    if (existing)
+        return Promise.resolve(existing);
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const settleResolve = (field) => {
+            if (settled)
+                return;
+            settled = true;
+            stop();
+            clearTimeout(to);
+            resolve(field);
+        };
+        const settleReject = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            stop();
+            clearTimeout(to);
+            reject(error);
+        };
+        const stop = observeBoundField(host, bindId, (e) => {
+            if (e.exists && e.field) {
+                settleResolve(e.field);
+            }
+        }, 150);
+        const to = setTimeout(() => {
+            settleReject(new Error(`waitForBoundField('${bindId}') timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+}
+//# sourceMappingURL=wait-for-bound-field.js.map

package/dist/core/bound/wait-for-bound-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-bound-field.js","sourceRoot":"","sources":["../../../src/core/bound/wait-for-bound-field.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAKzC,OAAO,EACH,aAAa,EACb,iBAAiB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,MAAM,UAAU,iBAAiB,CAC7B,IAAiB,EACjB,MAAc,EACd,SAAS,GAAG,IAAI;IAEhB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE/C,OAAO,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,aAAa,GAAG,CAAC,KAAY,EAAE,EAAE;YACnC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,EAAE,CAAC;YACP,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,EAAE;YAClC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,EAAE,CAAC;YACP,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,MAAM,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,IAAI,GAAG,iBAAiB,CAC1B,IAAI,EACJ,MAAM,EACN,CAAC,CAAC,EAAE,EAAE;YACF,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACtB,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC,EACD,GAAG,CACN,CAAC;QAEF,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;YACvB,YAAY,CACR,IAAI,KAAK,CACL,sBAAsB,MAAM,sBAAsB,SAAS,IAAI,CAClE,CACJ,CAAC;QACN,CAAC,EAAE,SAAS,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/{src/core/context.ts → dist/core/context.d.ts}

@@ -1,7 +1,5 @@
-// src/core/context.ts
 import React from "react";
 import type { CoreContext, Dict } from "@/schema/core";
-
 /**
  * Non-generic alias for the core context type used at runtime.
  *
@@ -10,7 +8,6 @@ import type { CoreContext, Dict } from "@/schema/core";
  * to a more specific generic shape when needed.
  */
 export type AnyCoreContext = CoreContext<Dict>;
-
 /**
  * React context carrying the current form/core instance.
  *
@@ -18,6 +15,5 @@ export type AnyCoreContext = CoreContext<Dict>;
  * - Consumers should generally use the typed hook in
  *   hooks/use-core-context.ts instead of reading this directly.
  */
-export const CoreContextReact = React.createContext<AnyCoreContext | null>(
-    null
-);
+export declare const CoreContextReact: React.Context<AnyCoreContext | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,sCAE5B,CAAC"}

package/dist/core/context.js

@@ -0,0 +1,11 @@
+// src/core/context.ts
+import React from "react";
+/**
+ * React context carrying the current form/core instance.
+ *
+ * - Provider is set up in core-provider.tsx.
+ * - Consumers should generally use the typed hook in
+ *   hooks/use-core-context.ts instead of reading this directly.
+ */
+export const CoreContextReact = React.createContext(null);
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAC/C,IAAI,CACP,CAAC"}

package/dist/core/core-provider.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+import type { z } from "zod";
+import type { AdapterKey } from "@/schema/adapter";
+import type { CoreProps, Dict } from "@/schema/core";
+type Props<V extends Dict, S extends z.ZodType | undefined, K extends AdapterKey> = CoreProps<V, S, K> & {
+    children?: React.ReactNode;
+};
+/**
+ * CoreProvider: owns the form/core runtime state and implements CoreContext.
+ *
+ * - Tracks all inputs in a single store (inputsRef)
+ * - Supports:
+ *   - named inputs via `name`
+ *   - bound inputs via `bindId`
+ *   - grouped inputs via `groupId`
+ * - Manages errors + uncaught messages
+ * - Builds values snapshots (including bucket values)
+ * - Orchestrates submission via the adapter registry
+ */
+export declare function CoreProvider<V extends Dict, S extends z.ZodType | undefined, K extends AdapterKey = "local">(props: Props<V, S, K>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=core-provider.d.ts.map

package/dist/core/core-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-provider.d.ts","sourceRoot":"","sources":["../../src/core/core-provider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAER,SAAS,EACT,IAAI,EAIP,MAAM,eAAe,CAAC;AAGvB,KAAK,KAAK,CACN,CAAC,SAAS,IAAI,EACd,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,EAC/B,CAAC,SAAS,UAAU,IACpB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B,CAAC;AA0CF;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CACxB,CAAC,SAAS,IAAI,EACd,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,EAC/B,CAAC,SAAS,UAAU,GAAG,OAAO,EAChC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,2CA0tBtB"}