@lab206/ui 0.1.0

package/dist/density.js

@@ -0,0 +1,31 @@
+import { effect, signal } from "@lab206/core";
+/**
+ * Control spacing / control height density via CSS tokens.
+ *
+ * @example
+ * ```ts
+ * const density = createDensity("comfortable");
+ * density.bind();
+ * density.setDensity("compact");
+ * ```
+ */
+export function createDensity(initial = "comfortable") {
+    const density = signal(initial);
+    function setDensity(next) {
+        density.set(next);
+    }
+    function toggle() {
+        density.update((d) => (d === "comfortable" ? "compact" : "comfortable"));
+    }
+    function bind(target) {
+        const el = target ??
+            (typeof document !== "undefined" ? document.documentElement : null);
+        if (!el)
+            return () => { };
+        return effect(() => {
+            el.setAttribute("data-pu-density", density());
+        });
+    }
+    return { density, setDensity, toggle, bind };
+}
+//# sourceMappingURL=density.js.map

package/dist/density.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.js","sourceRoot":"","sources":["../src/density.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAe,MAAM,cAAc,CAAC;AAY3D;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,UAAmB,aAAa;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAU,OAAO,CAAC,CAAC;IAEzC,SAAS,UAAU,CAAC,IAAa;QAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,SAAS,MAAM;QACb,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,IAAI,CAAC,MAAgB;QAC5B,MAAM,EAAE,GACN,MAAM;YACN,CAAC,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtE,IAAI,CAAC,EAAE;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAEzB,OAAO,MAAM,CAAC,GAAG,EAAE;YACjB,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC/C,CAAC"}

package/dist/dev.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Lightweight development warnings for common Powers mistakes.
+ * No-ops when `NODE_ENV === "production"` or when disabled.
+ *
+ * Call `installDevWarnings()` once from your app bootstrap (demos do this).
+ */
+/** Log a unique warning once per key (console.warn). */
+export declare function devWarnOnce(key: string, message: string): void;
+/**
+ * After first paint, check that design tokens exist (theme.css imported).
+ * Safe to call multiple times.
+ */
+export declare function warnIfThemeMissing(doc?: Document): void;
+/**
+ * Heuristic: plain-string `value` on a named control often means the author
+ * wrote `value={email()}` (snapshot) instead of `bind={email}` / `value={email}`.
+ * Only warns when `bound` is not used.
+ */
+export declare function warnPossibleSnapshotValue(control: string, opts: {
+    hasBind?: boolean;
+    valueIsPlainString?: boolean;
+}): void;
+/** Enable/disable all Powers dev warnings. */
+export declare function setDevWarnings(enabled: boolean): void;
+/** Install theme check (call once from demo / template main). */
+export declare function installDevWarnings(): void;
+//# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAO9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,QAAmB,GAAG,IAAI,CAgBjE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD,IAAI,CAMN;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAErD;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,IAAI,IAAI,CAKzC"}

package/dist/dev.js

@@ -0,0 +1,77 @@
+/**
+ * Lightweight development warnings for common Powers mistakes.
+ * No-ops when `NODE_ENV === "production"` or when disabled.
+ *
+ * Call `installDevWarnings()` once from your app bootstrap (demos do this).
+ */
+const g = globalThis;
+function isDev() {
+    if (g.__POWER_UI_DEV__ === false)
+        return false;
+    if (g.__POWER_UI_DEV__ === true)
+        return true;
+    const env = g.process?.env?.NODE_ENV;
+    if (env === "production")
+        return false;
+    // Browser demos / Vite: treat as dev unless explicitly production
+    return true;
+}
+function warnedSet() {
+    if (!g.__POWER_UI_WARNED__)
+        g.__POWER_UI_WARNED__ = new Set();
+    return g.__POWER_UI_WARNED__;
+}
+/** Log a unique warning once per key (console.warn). */
+export function devWarnOnce(key, message) {
+    if (!isDev())
+        return;
+    const set = warnedSet();
+    if (set.has(key))
+        return;
+    set.add(key);
+    // eslint-disable-next-line no-console
+    console.warn(`[Powers] ${message}`);
+}
+/**
+ * After first paint, check that design tokens exist (theme.css imported).
+ * Safe to call multiple times.
+ */
+export function warnIfThemeMissing(doc = document) {
+    if (!isDev() || typeof doc === "undefined")
+        return;
+    queueMicrotask(() => {
+        try {
+            const cs = doc.defaultView?.getComputedStyle(doc.documentElement);
+            const accent = cs?.getPropertyValue("--pu-color-accent")?.trim();
+            if (!accent) {
+                devWarnOnce("theme-css", 'Missing design tokens. Import once at the app root: import "@lab206/ui/theme.css"; then createTheme().bind().');
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    });
+}
+/**
+ * Heuristic: plain-string `value` on a named control often means the author
+ * wrote `value={email()}` (snapshot) instead of `bind={email}` / `value={email}`.
+ * Only warns when `bound` is not used.
+ */
+export function warnPossibleSnapshotValue(control, opts) {
+    if (!isDev() || opts.hasBind || !opts.valueIsPlainString)
+        return;
+    devWarnOnce(`snapshot-${control}`, `${control}: value is a plain string. If you meant a live signal, pass the signal itself: bind={email} or value={email} — not value={email()}.`);
+}
+/** Enable/disable all Powers dev warnings. */
+export function setDevWarnings(enabled) {
+    g.__POWER_UI_DEV__ = enabled;
+}
+/** Install theme check (call once from demo / template main). */
+export function installDevWarnings() {
+    if (!isDev())
+        return;
+    if (typeof document !== "undefined") {
+        warnIfThemeMissing(document);
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,GAAG,UAIT,CAAC;AAEF,SAAS,KAAK;IACZ,IAAI,CAAC,CAAC,gBAAgB,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,CAAC,CAAC,gBAAgB,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC;IACrC,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IACvC,kEAAkE;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC,CAAC,CAAC,mBAAmB;QAAE,CAAC,CAAC,mBAAmB,GAAG,IAAI,GAAG,EAAE,CAAC;IAC9D,OAAO,CAAC,CAAC,mBAAmB,CAAC;AAC/B,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAAe;IACtD,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO;IACrB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IACzB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACb,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgB,QAAQ;IACzD,IAAI,CAAC,KAAK,EAAE,IAAI,OAAO,GAAG,KAAK,WAAW;QAAE,OAAO;IACnD,cAAc,CAAC,GAAG,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,EAAE,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC;YACjE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,WAAW,CACT,WAAW,EACX,+GAA+G,CAChH,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,IAAyD;IAEzD,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB;QAAE,OAAO;IACjE,WAAW,CACT,YAAY,OAAO,EAAE,EACrB,GAAG,OAAO,qIAAqI,CAChJ,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,CAAC,CAAC,gBAAgB,GAAG,OAAO,CAAC;AAC/B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO;IACrB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/focusTrap.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Trap Tab focus inside `root` (for Dialog / Command / Drawer).
+ * Returns a dispose that removes the listener and restores prior focus.
+ */
+export declare function trapFocus(root: HTMLElement): () => void;
+//# sourceMappingURL=focusTrap.d.ts.map

package/dist/focusTrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.d.ts","sourceRoot":"","sources":["../src/focusTrap.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,IAAI,CA+CvD"}

package/dist/focusTrap.js

@@ -0,0 +1,55 @@
+const FOCUSABLE = 'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex="-1"])';
+function listFocusable(root) {
+    return [...root.querySelectorAll(FOCUSABLE)].filter((el) => !el.hasAttribute("disabled") && el.offsetParent !== null);
+}
+/**
+ * Trap Tab focus inside `root` (for Dialog / Command / Drawer).
+ * Returns a dispose that removes the listener and restores prior focus.
+ */
+export function trapFocus(root) {
+    const doc = root.ownerDocument;
+    const prev = doc.activeElement;
+    const focusFirst = () => {
+        const items = listFocusable(root);
+        (items[0] ?? root).focus?.();
+    };
+    // Defer so open animation / mount finishes
+    const win = doc.defaultView ?? window;
+    const t = win.setTimeout(focusFirst, 0);
+    const onKey = (e) => {
+        if (e.key !== "Tab")
+            return;
+        const items = listFocusable(root);
+        if (items.length === 0) {
+            e.preventDefault();
+            return;
+        }
+        const first = items[0];
+        const last = items[items.length - 1];
+        const active = doc.activeElement;
+        if (e.shiftKey) {
+            if (active === first || !root.contains(active)) {
+                e.preventDefault();
+                last.focus();
+            }
+        }
+        else if (active === last) {
+            e.preventDefault();
+            first.focus();
+        }
+    };
+    doc.addEventListener("keydown", onKey, true);
+    return () => {
+        win.clearTimeout(t);
+        doc.removeEventListener("keydown", onKey, true);
+        if (prev && typeof prev.focus === "function") {
+            try {
+                prev.focus();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    };
+}
+//# sourceMappingURL=focusTrap.js.map

package/dist/focusTrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.js","sourceRoot":"","sources":["../src/focusTrap.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GACb,sIAAsI,CAAC;AAEzI,SAAS,aAAa,CAAC,IAAiB;IACtC,OAAO,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAc,SAAS,CAAC,CAAC,CAAC,MAAM,CAC9D,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,YAAY,KAAK,IAAI,CACjE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAiB;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,aAAmC,CAAC;IAErD,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IAC/B,CAAC,CAAC;IAEF,2CAA2C;IAC3C,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC;IACtC,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAE,EAAE;QACjC,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK;YAAE,OAAO;QAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,aAAmC,CAAC;QACvD,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,MAAM,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IAEF,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAE7C,OAAO,GAAG,EAAE;QACV,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpB,GAAG,CAAC,mBAAmB,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/form.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Lightweight form helpers — pure functions for Field `error` props,
+ * two-way bind helpers, and a small `createField` pattern.
+ *
+ * No schema DSL. Keep validation next to signals.
+ *
+ * @example Preferred control wiring
+ * ```tsx
+ * const email = signal("");
+ * <Input bind={email} />
+ * // or spread: <Input {...bindText(email)} />
+ * ```
+ *
+ * @example Validation
+ * ```tsx
+ * const emailError = () => firstError(required(email()), emailFormat(email()));
+ * <Field label="Email" error={emailError}><Input bind={email} /></Field>
+ * ```
+ */
+import { type Signal } from "@lab206/core";
+export type FieldError = string | undefined | null | false;
+/** Anything that behaves like a writable signal (Powers signal). */
+export type Bindable<T> = {
+    (): T;
+    set: (value: T) => void;
+};
+/** First truthy message wins (empty string / false / null skipped). */
+export declare function firstError(...msgs: Array<FieldError | (() => FieldError)>): string;
+export declare function required(value: unknown, message?: string): FieldError;
+export declare function minLength(value: string, min: number, message?: string): FieldError;
+export declare function maxLength(value: string, max: number, message?: string): FieldError;
+export declare function emailFormat(value: string, message?: string): FieldError;
+export declare function matches(value: string, other: string, message?: string): FieldError;
+/**
+ * Run a map of field → error string. Returns `{ ok, errors }`.
+ * Use after submit or whenever you want a full-form snapshot.
+ */
+export declare function validateForm<K extends string>(fields: Record<K, () => FieldError>): {
+    ok: boolean;
+    errors: Partial<Record<K, string>>;
+};
+/** Read string value from an input / textarea / select event. */
+export declare function eventValue(e: Event): string;
+/** Read checked state from a checkbox / switch-like event. */
+export declare function eventChecked(e: Event): boolean;
+/**
+ * Props to spread onto `Input` / `Textarea` for two-way signal binding.
+ *
+ * Prefer the control’s `bind={signal}` prop when available.
+ * Named `bindInput` (not `bindText`) so it doesn’t clash with `@lab206/dom`’s
+ * DOM `bindText` helper.
+ */
+export declare function bindInput(sig: Bindable<string>): {
+    value: Bindable<string>;
+    onInput: (e: Event) => void;
+};
+/** Alias of bindInput. */
+export declare const bindString: typeof bindInput;
+/**
+ * Props to spread onto `Select` for two-way signal binding.
+ * Prefer `bind={signal}` on Select when available.
+ */
+export declare function bindSelect(sig: Bindable<string>): {
+    value: Bindable<string>;
+    onChange: (e: Event) => void;
+};
+/**
+ * Adapt a typed string-union signal (`Signal<"a" | "b">`) for `<Select bind={…} />`.
+ */
+export declare function asSelectBind<T extends string>(sig: {
+    (): T;
+    set: (value: T) => void;
+}): Bindable<string>;
+/**
+ * Props for checkbox / switch patterns that use `checked` + `onChange(boolean)`.
+ */
+export declare function bindChecked(sig: Bindable<boolean>): {
+    checked: Bindable<boolean>;
+    onChange: (checked: boolean) => void;
+};
+export type CreateFieldOptions = {
+    /** Initial string value */
+    initial?: string;
+    /**
+     * Validate when touched (or always if `validateWhen: "always"`).
+     * Return a message or falsy.
+     */
+    validate?: (value: string) => FieldError;
+    /** Default `"touched"` — only show errors after blur/submit. */
+    validateWhen?: "touched" | "always";
+};
+export type FieldHandle = {
+    /** Writable signal — pass to `bind={field.value}` or `value={field.value}` */
+    value: Signal<string>;
+    touched: Signal<boolean>;
+    /** Accessor for Field `error={field.error}` */
+    error: () => string;
+    /** Mark touched (call on blur or before submit) */
+    touch: () => void;
+    /** Reset value + untouched */
+    reset: (next?: string) => void;
+    /** Current string (sugar for value()) */
+    get: () => string;
+    set: (v: string) => void;
+};
+/**
+ * One field’s state: value signal + touched + error accessor.
+ *
+ * @example
+ * ```tsx
+ * const name = createField({
+ *   validate: (v) => required(v, "Name required"),
+ * });
+ *
+ * <Field label="Name" required error={name.error}>
+ *   <Input bind={name.value} onBlur={name.touch} />
+ * </Field>
+ *
+ * // on submit:
+ * name.touch();
+ * if (name.error()) return;
+ * ```
+ */
+export declare function createField(options?: CreateFieldOptions): FieldHandle;
+//# sourceMappingURL=form.d.ts.map

package/dist/form.d.ts.map

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

package/dist/form.js

@@ -0,0 +1,192 @@
+/**
+ * Lightweight form helpers — pure functions for Field `error` props,
+ * two-way bind helpers, and a small `createField` pattern.
+ *
+ * No schema DSL. Keep validation next to signals.
+ *
+ * @example Preferred control wiring
+ * ```tsx
+ * const email = signal("");
+ * <Input bind={email} />
+ * // or spread: <Input {...bindText(email)} />
+ * ```
+ *
+ * @example Validation
+ * ```tsx
+ * const emailError = () => firstError(required(email()), emailFormat(email()));
+ * <Field label="Email" error={emailError}><Input bind={email} /></Field>
+ * ```
+ */
+import { signal } from "@lab206/core";
+/** First truthy message wins (empty string / false / null skipped). */
+export function firstError(...msgs) {
+    for (const m of msgs) {
+        const v = typeof m === "function" ? m() : m;
+        if (v)
+            return String(v);
+    }
+    return "";
+}
+export function required(value, message = "Required") {
+    if (value == null)
+        return message;
+    if (typeof value === "string" && value.trim() === "")
+        return message;
+    if (Array.isArray(value) && value.length === 0)
+        return message;
+    return "";
+}
+export function minLength(value, min, message) {
+    if (!value)
+        return "";
+    if (value.length < min) {
+        return message ?? `At least ${min} characters`;
+    }
+    return "";
+}
+export function maxLength(value, max, message) {
+    if (!value)
+        return "";
+    if (value.length > max) {
+        return message ?? `At most ${max} characters`;
+    }
+    return "";
+}
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export function emailFormat(value, message = "Enter a valid email") {
+    if (!value || !value.trim())
+        return "";
+    return EMAIL_RE.test(value.trim()) ? "" : message;
+}
+export function matches(value, other, message = "Does not match") {
+    if (!value && !other)
+        return "";
+    return value === other ? "" : message;
+}
+/**
+ * Run a map of field → error string. Returns `{ ok, errors }`.
+ * Use after submit or whenever you want a full-form snapshot.
+ */
+export function validateForm(fields) {
+    const errors = {};
+    let ok = true;
+    for (const key of Object.keys(fields)) {
+        const msg = fields[key]();
+        if (msg) {
+            errors[key] = String(msg);
+            ok = false;
+        }
+    }
+    return { ok, errors };
+}
+/** Read string value from an input / textarea / select event. */
+export function eventValue(e) {
+    const t = e.currentTarget ?? e.target;
+    // Duck-type (works in happy-dom / SSR stubs without instanceof globals)
+    if (t && typeof t === "object" && "value" in t) {
+        return String(t.value ?? "");
+    }
+    return "";
+}
+/** Read checked state from a checkbox / switch-like event. */
+export function eventChecked(e) {
+    const t = e.currentTarget ?? e.target;
+    if (t && typeof t === "object" && "checked" in t) {
+        return !!t.checked;
+    }
+    return false;
+}
+/**
+ * Props to spread onto `Input` / `Textarea` for two-way signal binding.
+ *
+ * Prefer the control’s `bind={signal}` prop when available.
+ * Named `bindInput` (not `bindText`) so it doesn’t clash with `@lab206/dom`’s
+ * DOM `bindText` helper.
+ */
+export function bindInput(sig) {
+    return {
+        value: sig,
+        onInput: (e) => {
+            sig.set(eventValue(e));
+        },
+    };
+}
+/** Alias of bindInput. */
+export const bindString = bindInput;
+/**
+ * Props to spread onto `Select` for two-way signal binding.
+ * Prefer `bind={signal}` on Select when available.
+ */
+export function bindSelect(sig) {
+    return {
+        value: sig,
+        onChange: (e) => {
+            sig.set(eventValue(e));
+        },
+    };
+}
+/**
+ * Adapt a typed string-union signal (`Signal<"a" | "b">`) for `<Select bind={…} />`.
+ */
+export function asSelectBind(sig) {
+    const bound = (() => sig());
+    bound.set = (value) => {
+        sig.set(value);
+    };
+    return bound;
+}
+/**
+ * Props for checkbox / switch patterns that use `checked` + `onChange(boolean)`.
+ */
+export function bindChecked(sig) {
+    return {
+        checked: sig,
+        onChange: (checked) => {
+            sig.set(checked);
+        },
+    };
+}
+/**
+ * One field’s state: value signal + touched + error accessor.
+ *
+ * @example
+ * ```tsx
+ * const name = createField({
+ *   validate: (v) => required(v, "Name required"),
+ * });
+ *
+ * <Field label="Name" required error={name.error}>
+ *   <Input bind={name.value} onBlur={name.touch} />
+ * </Field>
+ *
+ * // on submit:
+ * name.touch();
+ * if (name.error()) return;
+ * ```
+ */
+export function createField(options = {}) {
+    const initial = options.initial ?? "";
+    const value = signal(initial);
+    const touched = signal(false);
+    const when = options.validateWhen ?? "touched";
+    const error = () => {
+        if (when === "touched" && !touched())
+            return "";
+        if (!options.validate)
+            return "";
+        return firstError(options.validate(value()));
+    };
+    return {
+        value,
+        touched,
+        error,
+        touch: () => touched.set(true),
+        reset: (next = initial) => {
+            value.set(next);
+            touched.set(false);
+        },
+        get: () => value(),
+        set: (v) => value.set(v),
+    };
+}
+//# sourceMappingURL=form.js.map

package/dist/form.js.map

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