@timeax/form-palette 0.0.1

package/src/core/registry/field-registry.ts

@@ -0,0 +1,187 @@
+// src/core/registry/field-registry.ts
+
+import type { Field } from "@/schema/field";
+import { BinderRegistry } from "@/core/registry/binder-registry";
+
+/**
+ * Runtime helper: check if a DOM node is currently attached.
+ *
+ * Guards against SSR or test environments where document may not exist.
+ */
+export function isInDom(node: Element | null | undefined): boolean {
+    if (!node) return false;
+    if (typeof document === "undefined") return false;
+    return document.body.contains(node);
+}
+
+/**
+ * Central store for all fields registered with the core runtime.
+ *
+ * Responsibilities:
+ * - Keep a stable list of Field instances (no duplicates).
+ * - Only track fields that have at least one identifier:
+ *   - name (non-empty, trimmed)
+ *   - bindId
+ *   - groupId
+ * - Provide convenient lookup methods:
+ *   - all / getAllNamed / getAllBound / getAllGrouped
+ *   - getByName / getAllByName
+ *   - getByGroupId / getAllByGroupId
+ *   - getByBind / getAllByBind (binder semantics, prefer mounted)
+ */
+export class FieldRegistry {
+    private list: Field[] = [];
+    #binding: BinderRegistry | undefined;
+
+    /**
+     * Whether this field should be tracked at all.
+     *
+     * We require at least one of: name, bindId, groupId.
+     */
+    hasIdentifier(field: Field): boolean {
+        const anyField = field as any;
+        const name = (field.name ?? "").trim();
+        return !!(name || anyField.bindId || anyField.groupId);
+    }
+
+    /**
+     * Add a field to the registry if it has an identifier.
+     * Duplicate instances are ignored.
+     */
+    add(field: Field): void {
+        if (!this.hasIdentifier(field)) return;
+        if (this.list.includes(field)) return;
+        this.list.push(field);
+    }
+
+    /**
+     * Remove a field from the registry.
+     */
+    remove(field: Field): void {
+        const idx = this.list.indexOf(field);
+        if (idx === -1) return;
+        this.list.splice(idx, 1);
+    }
+
+    /**
+     * Clear all tracked fields.
+     */
+    clear(): void {
+        this.list = [];
+    }
+
+    /**
+     * All fields tracked by this registry.
+     */
+    all(): Field[] {
+        return this.list;
+    }
+
+    // ─────────────────────────────────────────────────────────
+    // “views” over the list
+    // ─────────────────────────────────────────────────────────
+
+    /** All fields that have a non-empty name. */
+    getAllNamed(): Field[] {
+        return this.list.filter((f) => !!(f.name && f.name.trim().length > 0));
+    }
+
+    /** All fields that have a bindId. */
+    getAllBound(): Field[] {
+        return this.list.filter((f) => (f as any).bindId);
+    }
+
+    /** All fields that have a groupId. */
+    getAllGrouped(): Field[] {
+        return this.list.filter((f) => (f as any).groupId);
+    }
+
+    // ─────────────────────────────────────────────────────────
+    // name-based lookups
+    // ─────────────────────────────────────────────────────────
+
+    /**
+     * First field with a given name (exact, trimmed match).
+     *
+     * Note: expects the raw name used by the field, e.g.:
+     *   "email"  or  "tags[]"
+     */
+    getByName(name: string): Field | undefined {
+        if (!name) return undefined;
+        const target = name.trim();
+        if (!target) return undefined;
+
+        return this.list.find((f) => (f.name ?? "").trim() === target);
+    }
+
+    /**
+     * All fields with a given name (exact, trimmed match).
+     */
+    getAllByName(name: string): Field[] {
+        if (!name) return [];
+        const target = name.trim();
+        if (!target) return [];
+
+        return this.list.filter((f) => (f.name ?? "").trim() === target);
+    }
+
+    // ─────────────────────────────────────────────────────────
+    // groupId-based lookups
+    // ─────────────────────────────────────────────────────────
+
+    /** First field with the given groupId. */
+    getByGroupId(id: string): Field | undefined {
+        if (!id) return undefined;
+        return this.list.find((f) => (f as any).groupId === id);
+    }
+
+    /** All fields with the given groupId. */
+    getAllByGroupId(id: string): Field[] {
+        if (!id) return [];
+        return this.list.filter((f) => (f as any).groupId === id);
+    }
+
+    // ─────────────────────────────────────────────────────────
+    // bindId-based lookups (binder semantics)
+    // ─────────────────────────────────────────────────────────
+
+    /**
+     * All fields that share the given bindId.
+     */
+    getAllByBind(id: string): Field[] {
+        if (!id) return [];
+        return this.list.filter((f) => (f as any).bindId === id);
+    }
+
+    /**
+     * First field with the given bindId.
+     *
+     * Behaviour:
+     * - Prefer a field whose ref is currently in the DOM.
+     * - If none are mounted, fall back to the first matching field.
+     */
+    getByBind(id: string): Field | undefined {
+        if (!id) return undefined;
+
+        const candidates = this.getAllByBind(id);
+        if (!candidates.length) return undefined;
+
+        const mounted = candidates.find((f) => {
+            const anyField = f as any;
+            const el = anyField.ref?.current as Element | null | undefined;
+            return isInDom(el ?? null);
+        });
+
+        return mounted ?? candidates[0];
+    }
+
+    getBind(id: string): Field | undefined {
+        return this.getByBind(id);
+    }
+
+    get binding(): BinderRegistry {
+        if (!(this.#binding instanceof BinderRegistry))
+            this.#binding = new BinderRegistry(this);
+        return this.#binding;
+    }
+}

package/src/core/test.tsx

@@ -0,0 +1,17 @@
+import { InputField } from "@/index";
+import { Form } from "@/index";
+
+const Test = () => {
+    return (
+        <Form adapter="inertia">
+            <InputField
+                variant={"select"}
+                options={[{ label: 'name', value: 'string' }] as const}
+                optionValue='label'
+                onChange={e => {
+                    e.detail.raw
+                }}
+            />
+        </Form>
+    )
+}

package/src/global.d.ts

@@ -0,0 +1,14 @@
+import { PasswordDefinitionMap } from './presets/shadcn-variants/password';
+// src/global.d.ts
+import { PhoneCountry } from "./presets/shadcn-variants/phone";
+
+declare global {
+   interface Window {
+      'form-palette'?: {
+         countries: PhoneCountry[];
+         ruleDefinition: PasswordDefinitionMap;
+      };
+   }
+}
+
+export { };

package/src/index.ts

@@ -0,0 +1,68 @@
+// src/index.ts
+
+// ─────────────────────────────────────────────────────────────
+// Schema exports (types only)
+// ─────────────────────────────────────────────────────────────
+
+// TS 5.x+ — keep these as type-only to avoid runtime cycles & noise.
+export type * from "@/schema/core";
+export type * from "@/schema/adapter";
+export type * from "@/schema/field";
+export type * from "@/schema/input-field";
+export type * from "@/schema/variant";
+
+// ─────────────────────────────────────────────────────────────
+// Core runtime: provider + shell/root
+// ─────────────────────────────────────────────────────────────
+
+export { CoreProvider } from "@/core/core-provider";
+
+// Export with aliases directly to keep type info intact
+export { CoreShell, CoreShell as Form } from "@/core/core-shell";
+
+export { CoreRoot, CoreRoot as FormRoot } from "@/core/core-root";
+
+// ─────────────────────────────────────────────────────────────
+// Core hooks
+// ─────────────────────────────────────────────────────────────
+
+export { useCore } from "@/core/hooks/use-core";
+export { useCoreContext } from "@/core/hooks/use-core-context";
+export { useField } from "@/core/hooks/use-field";
+export { useOptionalField } from "@/core/hooks/use-optional-field";
+export { useButton } from "@/core/hooks/use-button";
+
+// ─────────────────────────────────────────────────────────────
+// Errors / helpers
+// ─────────────────────────────────────────────────────────────
+
+export { ErrorStrip } from "@/core/errors/error-strip";
+export { mapZodError } from "@/core/errors/map-zod";
+export { mapErrorBag } from "@/core/errors/map-error-bag";
+
+// ─────────────────────────────────────────────────────────────
+// Input layer
+// ─────────────────────────────────────────────────────────────
+
+export { InputField } from "@/input/input-field";
+export type { InputFieldProps, InputFieldBaseProps } from "@/input/input-props";
+
+// ─────────────────────────────────────────────────────────────
+// Variants & registry
+// ─────────────────────────────────────────────────────────────
+
+export { registerVariant, getVariant, listVariants } from "@/variants/registry";
+
+export { registerCoreVariants } from "@/variants"; // if you have a convenience registrar there
+
+export { Textarea } from "@/presets/ui/textarea";
+export { Input } from '@/presets/ui/input';
+// If you want to surface specific core variants:
+export { textVariant } from "@/variants/core/text";
+// (and similarly for others as you add them)
+
+// ─────────────────────────────────────────────────────────────
+// Adapters
+// ─────────────────────────────────────────────────────────────
+
+export * from "@/adapters";

package/src/input/index.ts

@@ -0,0 +1,4 @@
+// src/input/index.ts
+
+export type { InputFieldProps, InputFieldBaseProps } from "@/input/input-props";
+export { InputField } from "@/input/input-field";