@gyral/core 0.2.0 → 0.3.1

package/dist/focus.js

@@ -1,8 +1,17 @@
-/** Marker driver: `define()` handles focus commands itself. */
+import { afterRender, POST_FOCUS } from './scheduler.js';
+import { message } from './view/index.js';
+/** Marker driver: the host runs focus commands itself (`local`). */
 export const FOCUS = {
     name: '@gyral/focus',
     run: () => undefined,
+    local: (host, input) => {
+        queueFocus(host.el, host.root, host.tag, input);
+    },
 };
+// How long `focus(selector, { wait: true })` waits for its target to appear.
+const FOCUS_WAIT_MS = 1000;
+// A component's waiting focus request, so the next focus() can cancel it.
+const waiting = new WeakMap();
 /**
  * A command that focuses the first element matching `selector` inside this component (its
  * shadow root, or its own children in light-DOM mode) once the current update has rendered:
@@ -15,11 +24,11 @@ export function focus(selector, options = {}) {
     const input = { selector, ...options };
     return { driver: FOCUS, input, onSuccess: () => undefined };
 }
-/** Runs a focus command against `root` (called by define() after the update completes). */
+/** Runs a focus command against `root` (the scheduler calls it after the render). */
 export function runFocus(root, tag, input) {
     const target = root.querySelector(input.selector);
     if (!(target instanceof HTMLElement || target instanceof SVGElement)) {
-        console.warn(`<${tag}> focus("${input.selector}") matched no focusable element.`);
+        console.warn(message(13, tag, input.selector));
         return;
     }
     target.focus({ preventScroll: input.preventScroll ?? false });
@@ -28,15 +37,39 @@ export function runFocus(root, tag, input) {
     }
 }
 /**
- * Runs a focus command after the render the same update caused, view transition included:
- * define() runs commands before #dispatch registers that update's view transition, so wait a
- * microtask first, then for updateComplete, which waits for the transition (gyral-6zz).
+ * Runs a focus command after the flush that renders the same update, view transition
+ * included: it is post-render work, so the DOM already shows the new state.
  */
-export function focusAfterUpdate(host, tag, input) {
-    void Promise.resolve().then(async () => {
-        await host.updateComplete;
-        if (host.isConnected)
-            runFocus(host.renderRoot, tag, input);
+export function queueFocus(host, root, tag, input) {
+    afterRender(POST_FOCUS, () => {
+        waiting.get(host)?.();
+        const target = root();
+        if (!host.isConnected || target === undefined)
+            return;
+        if (input.wait !== true || target.querySelector(input.selector) !== null) {
+            runFocus(target, tag, input);
+            return;
+        }
+        // Not rendered yet: watch the component's own DOM (renders are the only writers) until the
+        // target appears, a newer focus() cancels, or time runs out. settled() doesn't wait for it.
+        const stop = () => {
+            observer.disconnect();
+            clearTimeout(timer);
+            waiting.delete(host);
+        };
+        const observer = new MutationObserver(() => {
+            if (target.querySelector(input.selector) !== null) {
+                stop();
+                if (host.isConnected)
+                    runFocus(target, tag, input);
+            }
+        });
+        const timer = setTimeout(() => {
+            stop();
+            runFocus(target, tag, input);
+        }, FOCUS_WAIT_MS);
+        observer.observe(target, { childList: true, subtree: true, attributes: true });
+        waiting.set(host, stop);
     });
 }
 //# sourceMappingURL=focus.js.map

package/dist/focus.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus.js","sourceRoot":"","sources":["../src/focus.ts"],"names":[],"mappings":"AAKA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,cAAc;IACpB,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;CACZ,CAAC;AAcX;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,QAAgB,EAAE,UAAwB,EAAE;IAChE,MAAM,KAAK,GAAe,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IACnD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;AAC9D,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,QAAQ,CAAC,IAAgB,EAAE,GAAW,EAAE,KAAiB;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,MAAM,YAAY,WAAW,IAAI,MAAM,YAAY,UAAU,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,YAAY,KAAK,CAAC,QAAQ,kCAAkC,CAAC,CAAC;QAClF,OAAO;IACT,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,QAAQ,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACtF,MAA2B,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;AACH,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,GAAW,EAAE,KAAiB;IAC9E,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;QACrC,MAAM,IAAI,CAAC,cAAc,CAAC;QAC1B,IAAI,IAAI,CAAC,WAAW;YAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["// Focus management from the model (gyral-czi.28). Moving focus is a side effect, so the model\n// asks for it with a command; define() runs it against the component's own render root after\n// the render that the same reducer caused, so the element to focus already exists.\nimport type { Command } from './command.js';\n\n/** Marker driver: `define()` handles focus commands itself. */\nexport const FOCUS = {\n  name: '@gyral/focus',\n  run: () => undefined,\n} as const;\n\nexport interface FocusOptions {\n  /** Don't scroll the element into view (default `false`: the browser scrolls if needed). */\n  readonly preventScroll?: boolean;\n  /** Also select the text of an input or textarea. */\n  readonly select?: boolean;\n}\n\n/** The input of a `focus()` command. */\nexport interface FocusInput extends FocusOptions {\n  readonly selector: string;\n}\n\n/**\n * A command that focuses the first element matching `selector` inside this component (its\n * shadow root, or its own children in light-DOM mode) once the current update has rendered:\n *\n *   NextPage: (s, m) => [{ ...s, page: m.page }, [focus('h2', { preventScroll: true })]]\n *\n * Non-focusable targets (a heading) need `tabindex=\"-1\"` in the view.\n */\nexport function focus(selector: string, options: FocusOptions = {}): Command<never> {\n  const input: FocusInput = { selector, ...options };\n  return { driver: FOCUS, input, onSuccess: () => undefined };\n}\n\n/** Runs a focus command against `root` (called by define() after the update completes). */\nexport function runFocus(root: ParentNode, tag: string, input: FocusInput): void {\n  const target = root.querySelector(input.selector);\n  if (!(target instanceof HTMLElement || target instanceof SVGElement)) {\n    console.warn(`<${tag}> focus(\"${input.selector}\") matched no focusable element.`);\n    return;\n  }\n  target.focus({ preventScroll: input.preventScroll ?? false });\n  if (input.select === true && 'select' in target && typeof target.select === 'function') {\n    (target as HTMLInputElement).select();\n  }\n}\n\n/** What focusAfterUpdate needs from a component: Lit's update promise and its render root. */\nexport interface FocusHost {\n  readonly updateComplete: Promise<boolean>;\n  readonly isConnected: boolean;\n  readonly renderRoot: ParentNode;\n}\n\n/**\n * Runs a focus command after the render the same update caused, view transition included:\n * define() runs commands before #dispatch registers that update's view transition, so wait a\n * microtask first, then for updateComplete, which waits for the transition (gyral-6zz).\n */\nexport function focusAfterUpdate(host: FocusHost, tag: string, input: FocusInput): void {\n  void Promise.resolve().then(async () => {\n    await host.updateComplete;\n    if (host.isConnected) runFocus(host.renderRoot, tag, input);\n  });\n}\n"]}
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../src/focus.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,oEAAoE;AACpE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,cAAc;IACpB,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;IACpB,KAAK,EAAE,CAAC,IAAe,EAAE,KAAc,EAAE,EAAE;QACzC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,KAAmB,CAAC,CAAC;IAChE,CAAC;CACO,CAAC;AAeX,6EAA6E;AAC7E,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,0EAA0E;AAC1E,MAAM,OAAO,GAAG,IAAI,OAAO,EAAuB,CAAC;AAOnD;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,QAAgB,EAAE,UAAwB,EAAE;IAChE,MAAM,KAAK,GAAe,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;IACnD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;AAC9D,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,QAAQ,CAAC,IAAgB,EAAE,GAAW,EAAE,KAAiB;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,CAAC,CAAC,MAAM,YAAY,WAAW,IAAI,MAAM,YAAY,UAAU,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,KAAK,EAAE,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,QAAQ,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACtF,MAA2B,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAAa,EACb,IAAkC,EAClC,GAAW,EACX,KAAiB;IAEjB,WAAW,CAAC,UAAU,EAAE,GAAG,EAAE;QAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACtD,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;YACzE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,2FAA2F;QAC3F,4FAA4F;QAC5F,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;YACzC,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;gBAClD,IAAI,EAAE,CAAC;gBACP,IAAI,IAAI,CAAC,WAAW;oBAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,EAAE,CAAC;YACP,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC,EAAE,aAAa,CAAC,CAAC;QAClB,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["// Focus management from the model (gyral-czi.28). Moving focus is a side effect, so the model\n// asks for it with a command; define() queues it as the scheduler's first post-render work\n// (view/04-scheduler.md \"Post-render queue\"), against the component's own root, so the element\n// to focus already exists.\nimport type { Command } from './command.js';\nimport type { LocalHost } from './features.js';\nimport { afterRender, POST_FOCUS } from './scheduler.js';\nimport { message } from './view/index.js';\n\n/** Marker driver: the host runs focus commands itself (`local`). */\nexport const FOCUS = {\n  name: '@gyral/focus',\n  run: () => undefined,\n  local: (host: LocalHost, input: unknown) => {\n    queueFocus(host.el, host.root, host.tag, input as FocusInput);\n  },\n} as const;\n\nexport interface FocusOptions {\n  /** Don't scroll the element into view (default `false`: the browser scrolls if needed). */\n  readonly preventScroll?: boolean;\n  /** Also select the text of an input or textarea. */\n  readonly select?: boolean;\n  /**\n   * If nothing matches after this render, keep the request and focus the target as soon as a\n   * later render of this component produces it; a newer `focus()` from the component replaces\n   * it, and after one second it gives up with the usual warning. `settled()` doesn't wait for it.\n   */\n  readonly wait?: boolean;\n}\n\n// How long `focus(selector, { wait: true })` waits for its target to appear.\nconst FOCUS_WAIT_MS = 1000;\n\n// A component's waiting focus request, so the next focus() can cancel it.\nconst waiting = new WeakMap<Element, () => void>();\n\n/** The input of a `focus()` command. */\nexport interface FocusInput extends FocusOptions {\n  readonly selector: string;\n}\n\n/**\n * A command that focuses the first element matching `selector` inside this component (its\n * shadow root, or its own children in light-DOM mode) once the current update has rendered:\n *\n *   NextPage: (s, m) => [{ ...s, page: m.page }, [focus('h2', { preventScroll: true })]]\n *\n * Non-focusable targets (a heading) need `tabindex=\"-1\"` in the view.\n */\nexport function focus(selector: string, options: FocusOptions = {}): Command<never> {\n  const input: FocusInput = { selector, ...options };\n  return { driver: FOCUS, input, onSuccess: () => undefined };\n}\n\n/** Runs a focus command against `root` (the scheduler calls it after the render). */\nexport function runFocus(root: ParentNode, tag: string, input: FocusInput): void {\n  const target = root.querySelector(input.selector);\n  if (!(target instanceof HTMLElement || target instanceof SVGElement)) {\n    console.warn(message(13, tag, input.selector));\n    return;\n  }\n  target.focus({ preventScroll: input.preventScroll ?? false });\n  if (input.select === true && 'select' in target && typeof target.select === 'function') {\n    (target as HTMLInputElement).select();\n  }\n}\n\n/**\n * Runs a focus command after the flush that renders the same update, view transition\n * included: it is post-render work, so the DOM already shows the new state.\n */\nexport function queueFocus(\n  host: Element,\n  root: () => ParentNode | undefined,\n  tag: string,\n  input: FocusInput,\n): void {\n  afterRender(POST_FOCUS, () => {\n    waiting.get(host)?.();\n    const target = root();\n    if (!host.isConnected || target === undefined) return;\n    if (input.wait !== true || target.querySelector(input.selector) !== null) {\n      runFocus(target, tag, input);\n      return;\n    }\n    // Not rendered yet: watch the component's own DOM (renders are the only writers) until the\n    // target appears, a newer focus() cancels, or time runs out. settled() doesn't wait for it.\n    const stop = (): void => {\n      observer.disconnect();\n      clearTimeout(timer);\n      waiting.delete(host);\n    };\n    const observer = new MutationObserver(() => {\n      if (target.querySelector(input.selector) !== null) {\n        stop();\n        if (host.isConnected) runFocus(target, tag, input);\n      }\n    });\n    const timer = setTimeout(() => {\n      stop();\n      runFocus(target, tag, input);\n    }, FOCUS_WAIT_MS);\n    observer.observe(target, { childList: true, subtree: true, attributes: true });\n    waiting.set(host, stop);\n  });\n}\n"]}

package/dist/form-associated.d.ts

@@ -0,0 +1,46 @@
+import type { Ctx } from './types.js';
+import type { HostModel } from './host-model.js';
+/** A native submitted value, or null to omit this component from the submission. */
+export type FormControlValue = string | File | FormData | null;
+/** Native constraint flags and a validation bubble anchor in the component's render root. */
+export interface FormControlValidity {
+    readonly flags: ValidityStateFlags;
+    readonly message: string;
+    readonly anchor?: string;
+}
+/** Pure model projections applied by Gyral to the host's ElementInternals (ADR 0008). */
+export interface FormAssociation<S, P> {
+    readonly value: (state: S, ctx: Ctx<P>) => FormControlValue;
+    readonly state?: (state: S, ctx: Ctx<P>) => FormControlValue;
+    readonly validity?: (state: S, ctx: Ctx<P>) => FormControlValidity | undefined;
+}
+/** Framework message: the owning native form was reset. */
+export interface FormReset {
+    readonly _tag: 'FormReset';
+}
+/** Framework message: the host or its fieldset changed the effective disabled state. */
+export interface FormDisabled {
+    readonly _tag: 'FormDisabled';
+    readonly disabled: boolean;
+}
+/** Framework message: native session restoration or autofill supplied control state. */
+export interface FormStateRestore {
+    readonly _tag: 'FormStateRestore';
+    readonly state: FormControlValue;
+    readonly mode: 'restore' | 'autocomplete';
+}
+export type FormMessage = FormReset | FormDisabled | FormStateRestore;
+export interface FormControl {
+    receive(msg: FormMessage): void;
+    sync<S, P>(projection: FormAssociation<S, P>, state: S, ctx: Ctx<P>, root: ParentNode): void;
+}
+/** Native reactions must be installed before customElements.define() reads the prototype. */
+declare function installFormCallbacks(Element: CustomElementConstructor, enabled: boolean): void;
+/** Attach once in the constructor; defer pre-render reactions until hydration has committed. */
+export declare function createFormControl(host: HTMLElement, model: Pick<HostModel<unknown, unknown>, 'hasReducer' | 'dispatch'>): FormControl;
+export declare const formFeature: {
+    create<S, P>(host: HTMLElement, model: Pick<HostModel<unknown, unknown>, "hasReducer" | "dispatch">, projection: FormAssociation<S, P> | undefined): void;
+    sync(host: HTMLElement, state: unknown, ctx: Ctx<unknown>, root: ParentNode): void;
+    install: typeof installFormCallbacks;
+};
+export {};

package/dist/form-associated.js

@@ -0,0 +1,77 @@
+import { internalsOf } from './element-internals.js';
+import { afterRender, POST_HYDRATED } from './scheduler.js';
+const controls = new WeakMap();
+const projections = new WeakMap();
+/** Native reactions must be installed before customElements.define() reads the prototype. */
+function installFormCallbacks(Element, enabled) {
+    if (!enabled)
+        return;
+    Object.defineProperty(Element, 'formAssociated', { value: true });
+    Object.assign(Element.prototype, {
+        formResetCallback() {
+            controls.get(this)?.receive({ _tag: 'FormReset' });
+        },
+        formDisabledCallback(disabled) {
+            controls.get(this)?.receive({ _tag: 'FormDisabled', disabled });
+        },
+        formStateRestoreCallback(state, mode) {
+            controls.get(this)?.receive({ _tag: 'FormStateRestore', state, mode });
+        },
+    });
+}
+/** Attach once in the constructor; defer pre-render reactions until hydration has committed. */
+export function createFormControl(host, model) {
+    const dispatch = (msg) => {
+        if (model.hasReducer(msg._tag))
+            model.dispatch(msg);
+    };
+    const internals = internalsOf(host);
+    let live = false;
+    const pending = [];
+    const control = {
+        receive(msg) {
+            if (live)
+                dispatch(msg);
+            else
+                pending.push(msg);
+        },
+        sync(projection, state, ctx, root) {
+            const value = projection.value(state, ctx);
+            if (projection.state === undefined)
+                internals.setFormValue(value);
+            else
+                internals.setFormValue(value, projection.state(state, ctx));
+            const validity = projection.validity?.(state, ctx);
+            const anchor = validity?.anchor === undefined ? undefined : root.querySelector(validity.anchor);
+            if (anchor != null && !(anchor instanceof HTMLElement)) {
+                throw new TypeError('The form validity anchor must select an HTMLElement.');
+            }
+            internals.setValidity(validity?.flags ?? {}, validity?.message ?? '', anchor ?? undefined);
+            live = true;
+            if (pending.length > 0) {
+                const messages = pending.splice(0);
+                afterRender(POST_HYDRATED, () => {
+                    for (const msg of messages)
+                        dispatch(msg);
+                });
+            }
+        },
+    };
+    controls.set(host, control);
+    return control;
+}
+export const formFeature = {
+    create(host, model, projection) {
+        if (projection === undefined)
+            return;
+        projections.set(host, projection);
+        createFormControl(host, model);
+    },
+    sync(host, state, ctx, root) {
+        const projection = projections.get(host);
+        if (projection !== undefined)
+            controls.get(host)?.sync(projection, state, ctx, root);
+    },
+    install: installFormCallbacks,
+};
+//# sourceMappingURL=form-associated.js.map

package/dist/form-associated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-associated.js","sourceRoot":"","sources":["../src/form-associated.ts"],"names":[],"mappings":"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","sourcesContent":["import { internalsOf } from './element-internals.js';\nimport { afterRender, POST_HYDRATED } from './scheduler.js';\nimport type { Ctx } from './types.js';\nimport type { HostModel } from './host-model.js';\n\n/** A native submitted value, or null to omit this component from the submission. */\nexport type FormControlValue = string | File | FormData | null;\n\n/** Native constraint flags and a validation bubble anchor in the component's render root. */\nexport interface FormControlValidity {\n  readonly flags: ValidityStateFlags;\n  readonly message: string;\n  readonly anchor?: string;\n}\n\n/** Pure model projections applied by Gyral to the host's ElementInternals (ADR 0008). */\nexport interface FormAssociation<S, P> {\n  readonly value: (state: S, ctx: Ctx<P>) => FormControlValue;\n  readonly state?: (state: S, ctx: Ctx<P>) => FormControlValue;\n  readonly validity?: (state: S, ctx: Ctx<P>) => FormControlValidity | undefined;\n}\n\n/** Framework message: the owning native form was reset. */\nexport interface FormReset {\n  readonly _tag: 'FormReset';\n}\n\n/** Framework message: the host or its fieldset changed the effective disabled state. */\nexport interface FormDisabled {\n  readonly _tag: 'FormDisabled';\n  readonly disabled: boolean;\n}\n\n/** Framework message: native session restoration or autofill supplied control state. */\nexport interface FormStateRestore {\n  readonly _tag: 'FormStateRestore';\n  readonly state: FormControlValue;\n  readonly mode: 'restore' | 'autocomplete';\n}\n\nexport type FormMessage = FormReset | FormDisabled | FormStateRestore;\n\nexport interface FormControl {\n  receive(msg: FormMessage): void;\n  sync<S, P>(projection: FormAssociation<S, P>, state: S, ctx: Ctx<P>, root: ParentNode): void;\n}\n\nconst controls = new WeakMap<HTMLElement, FormControl>();\nconst projections = new WeakMap<HTMLElement, FormAssociation<unknown, unknown>>();\n\n/** Native reactions must be installed before customElements.define() reads the prototype. */\nfunction installFormCallbacks(Element: CustomElementConstructor, enabled: boolean): void {\n  if (!enabled) return;\n  Object.defineProperty(Element, 'formAssociated', { value: true });\n  Object.assign(Element.prototype, {\n    formResetCallback(this: HTMLElement): void {\n      controls.get(this)?.receive({ _tag: 'FormReset' });\n    },\n    formDisabledCallback(this: HTMLElement, disabled: boolean): void {\n      controls.get(this)?.receive({ _tag: 'FormDisabled', disabled });\n    },\n    formStateRestoreCallback(\n      this: HTMLElement,\n      state: FormControlValue,\n      mode: 'restore' | 'autocomplete',\n    ): void {\n      controls.get(this)?.receive({ _tag: 'FormStateRestore', state, mode });\n    },\n  });\n}\n\n/** Attach once in the constructor; defer pre-render reactions until hydration has committed. */\nexport function createFormControl(\n  host: HTMLElement,\n  model: Pick<HostModel<unknown, unknown>, 'hasReducer' | 'dispatch'>,\n): FormControl {\n  const dispatch = (msg: FormMessage): void => {\n    if (model.hasReducer(msg._tag)) model.dispatch(msg);\n  };\n  const internals = internalsOf(host);\n  let live = false;\n  const pending: FormMessage[] = [];\n  const control: FormControl = {\n    receive(msg) {\n      if (live) dispatch(msg);\n      else pending.push(msg);\n    },\n    sync(projection, state, ctx, root) {\n      const value = projection.value(state, ctx);\n      if (projection.state === undefined) internals.setFormValue(value);\n      else internals.setFormValue(value, projection.state(state, ctx));\n      const validity = projection.validity?.(state, ctx);\n      const anchor =\n        validity?.anchor === undefined ? undefined : root.querySelector(validity.anchor);\n      if (anchor != null && !(anchor instanceof HTMLElement)) {\n        throw new TypeError('The form validity anchor must select an HTMLElement.');\n      }\n      internals.setValidity(validity?.flags ?? {}, validity?.message ?? '', anchor ?? undefined);\n      live = true;\n      if (pending.length > 0) {\n        const messages = pending.splice(0);\n        afterRender(POST_HYDRATED, () => {\n          for (const msg of messages) dispatch(msg);\n        });\n      }\n    },\n  };\n  controls.set(host, control);\n  return control;\n}\n\nexport const formFeature = {\n  create<S, P>(\n    host: HTMLElement,\n    model: Pick<HostModel<unknown, unknown>, 'hasReducer' | 'dispatch'>,\n    projection: FormAssociation<S, P> | undefined,\n  ): void {\n    if (projection === undefined) return;\n    projections.set(host, projection as unknown as FormAssociation<unknown, unknown>);\n    createFormControl(host, model);\n  },\n  sync(host: HTMLElement, state: unknown, ctx: Ctx<unknown>, root: ParentNode): void {\n    const projection = projections.get(host);\n    if (projection !== undefined) controls.get(host)?.sync(projection, state, ctx, root);\n  },\n  install: installFormCallbacks,\n};\n"]}

package/dist/forms.d.ts

@@ -1,21 +1,27 @@
 import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { FieldIssue, FormFields, IntentParser, IntentRejected } from './types.js';
-/** A form's schema, shared by the client component and (with @gyral/ssr) the server route. */
-export interface FormDefinition<Schema extends StandardSchemaV1> {
-    readonly _tag: 'FormDefinition';
-    readonly schema: Schema;
+import type { FieldIssue, FormFields, IntentInput, IntentParser, IntentRejected } from './types.js';
+type In<Schema extends StandardSchemaV1> = StandardSchemaV1.InferInput<Schema>;
+type Out<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
+/** The definition's field names, when its input is an object; otherwise any string. */
+export type FieldName<Schema extends StandardSchemaV1> = In<Schema> extends Readonly<Record<string, unknown>> ? keyof In<Schema> & string : string;
+export interface FormOptions<Schema extends StandardSchemaV1> {
+    /**
+     * Fields whose submitted values are never sent back: not in `IntentRejected.values`, not in
+     * `values()`, not in the devtools timeline. Any posted field name may be listed, including
+     * fields outside the schema. Names containing `password`, `passcode`, `csrf` or `xsrf` are
+     * secret without being listed (the browser never restores a password field either, and a
+     * CSRF token must come fresh from the server, not from the echo).
+     */
+    readonly secret?: readonly (FieldName<Schema> | (string & {}))[];
 }
-export declare function defineForm<Schema extends StandardSchemaV1>(schema: Schema): FormDefinition<Schema>;
-export type FormValue = FormDataEntryValue | readonly FormDataEntryValue[];
 /**
- * FormData to a plain object. The same function runs on the server, so both sides agree.
- * Repeated names become arrays; a `name[]` suffix always yields an array (named `name`).
- * Values stay strings (or Files): the schema coerces them.
+ * A form's submitted text values, keyed by the definition's fields, for re-rendering the form
+ * with what was typed (sticky fields). The same shape as `IntentRejected.values`: repeated names
+ * (and `name[]`) are arrays; `File`s and secret fields are left out.
  */
-export declare function formDataToObject(data: FormData): Readonly<Record<string, FormValue>>;
-type Out<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
-/** The text fields of a parsed form, for re-filling it after a rejection. */
-export declare function formFields(data: Readonly<Record<string, FormValue>>): FormFields;
+export type FormValues<Schema extends StandardSchemaV1> = In<Schema> extends Readonly<Record<string, unknown>> ? {
+    readonly [K in keyof In<Schema> & string]?: string | readonly string[];
+} : FormFields;
 export type FormResult<T> = {
     readonly ok: true;
     readonly data: T;
@@ -23,22 +29,35 @@ export type FormResult<T> = {
     readonly ok: false;
     readonly rejected: IntentRejected;
 };
-/**
- * Validates submitted form data exactly as `form()` does. The no-JS server path
- * (`formAction` in @gyral/ssr) uses it, so both paths produce the same `IntentRejected`.
- */
-export declare function validateForm<Schema extends StandardSchemaV1>(definition: FormDefinition<Schema> | Schema, intent: string, data: FormData): FormResult<Out<Schema>> | Promise<FormResult<Out<Schema>>>;
+/** A form's schema, shared by the client component and (with `@gyral/ssr`) the server route. */
+export interface FormDefinition<Schema extends StandardSchemaV1> {
+    readonly _tag: 'FormDefinition';
+    readonly schema: Schema;
+    /** The fields listed as secret (names containing `password`, `passcode`, `csrf` or `xsrf` are secret too). */
+    readonly secret: readonly string[];
+    /**
+     * Validates submitted form data exactly as `form()` does; the server's `formAction` uses it,
+     * so both paths produce the same `IntentRejected` (`intent` defaults to `''`).
+     */
+    readonly validate: (data: FormData, intent?: string) => FormResult<Out<Schema>> | Promise<FormResult<Out<Schema>>>;
+    /** The submitted text values without secrets: what a re-rendered form may show again. */
+    readonly values: (data: FormData) => FormValues<Schema>;
+}
+/** Whether `name` is never echoed: declared secret by a form, or a password-like name. */
+export declare function isSecretField(name: string): boolean;
+export declare function defineForm<Schema extends StandardSchemaV1>(schema: Schema, options?: FormOptions<Schema>): FormDefinition<Schema>;
+export type FormValue = FormDataEntryValue | readonly FormDataEntryValue[];
 /**
  * Intent parser for a `<form data-intent>` submission, validated by a schema. `toMsg` also
  * gets the raw `FormData`, for sending the submission to the server (`submitForm` in
- * @gyral/http) after it passed client-side validation.
+ * `@gyral/http`) after it passed client-side validation.
  */
-export declare function form<Schema extends StandardSchemaV1, M>(definition: FormDefinition<Schema> | Schema, toMsg: (data: Out<Schema>, formData: FormData) => M | undefined): IntentParser<M>;
+export declare function form<Schema extends StandardSchemaV1, M>(definition: FormDefinition<Schema> | Schema, toMsg: (data: Out<Schema>, formData: FormData) => M | undefined): (input: IntentInput) => ReturnType<IntentParser<M>>;
 /**
  * Intent parser for one control (pair with `data-intent-on="input"` for live checks).
  * Validates `checked` for checkboxes and radios, otherwise `value`.
  */
-export declare function field<Schema extends StandardSchemaV1, M>(schema: Schema, toMsg: (value: Out<Schema>) => M | undefined): IntentParser<M>;
+export declare function field<Schema extends StandardSchemaV1, M>(schema: Schema, toMsg: (value: Out<Schema>) => M | undefined): (input: IntentInput) => ReturnType<IntentParser<M>>;
 /**
  * Groups issues by field name. Call it in the `IntentRejected` reducer and keep the result in
  * state: `invalid()` re-applies an error only when it gets a new array.
@@ -46,14 +65,7 @@ export declare function field<Schema extends StandardSchemaV1, M>(schema: Schema
 export declare function fieldErrors(issues: readonly FieldIssue[]): Readonly<Record<string, readonly string[]>>;
 /**
  * A Standard Schema for `IntentRejected` as a server sends it (`formAction` answering JSON).
- * Used by `submitForm` in @gyral/http to recognise a 422 rejection; usable with any decoder.
+ * Used by `submitForm` in `@gyral/http` to recognise a 422 rejection; usable with any decoder.
  */
 export declare const intentRejectedSchema: StandardSchemaV1<unknown, IntentRejected>;
-/** A server's JSON answer to a valid form post that would have redirected without JS. */
-export interface FormRedirected {
-    readonly _tag: 'Redirected';
-    readonly location: string;
-}
-/** The `location` of a `FormRedirected` answer (from `formAction` in @gyral/ssr), if it is one. */
-export declare function redirectedTo(body: unknown): string | undefined;
 export {};

package/dist/forms.js

@@ -1,12 +1,91 @@
-export function defineForm(schema) {
-    return { _tag: 'FormDefinition', schema };
+import { DEV } from '#view-dev';
+// Every secret name a definition declared, for redacting previews (the devtools timeline).
+const declaredSecrets = /* @__PURE__ */ new Set();
+const DEFAULT_SECRET = /password|passcode|csrf|xsrf/i;
+/** Whether `name` is never echoed: declared secret by a form, or a password-like name. */
+export function isSecretField(name) {
+    return DEFAULT_SECRET.test(name) || declaredSecrets.has(name);
+}
+// Words that suggest a secret; an unlisted field named with one gets a development warning.
+const SUSPECT = /* @__PURE__ */ new Set([
+    'password',
+    'passcode',
+    'token',
+    'secret',
+    'card',
+    'cvc',
+    'cvv',
+    'ssn',
+    'pin',
+]);
+const warned = /* @__PURE__ */ new Set();
+function warnUnmarked(key) {
+    if (warned.has(key))
+        return;
+    const words = key
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/);
+    if (!words.some((w) => SUSPECT.has(w)))
+        return;
+    warned.add(key);
+    console.warn(`Gyral: form field "${key}" looks secret but isn't listed in defineForm(schema, { secret }); ` +
+        'its value is echoed back after a rejection.');
+}
+/**
+ * The text values of a parsed submission, for re-filling the form after a rejection: Files and
+ * the fields `secret` names (or that look like passwords) are left out.
+ */
+function stickyValues(data, secret) {
+    const out = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (DEFAULT_SECRET.test(key) || secret.includes(key))
+            continue;
+        if (DEV)
+            warnUnmarked(key);
+        if (typeof value === 'string')
+            out[key] = value;
+        else if (Array.isArray(value))
+            out[key] = value.filter((v) => typeof v === 'string');
+    }
+    return out;
+}
+function validate(schema, secret, intent, data) {
+    const raw = formDataToObject(data);
+    const settle = (result) => result.issues === undefined
+        ? { ok: true, data: result.value }
+        : {
+            ok: false,
+            rejected: {
+                _tag: 'IntentRejected',
+                intent,
+                issues: toIssues(result.issues, ''),
+                values: stickyValues(raw, secret),
+            },
+        };
+    const result = schema['~standard'].validate(raw);
+    return result instanceof Promise ? result.then(settle) : settle(result);
+}
+export function defineForm(schema, options = {}) {
+    const secret = options.secret ?? [];
+    // Only the devtools timeline reads these, and it only runs in development.
+    if (DEV)
+        for (const name of secret)
+            declaredSecrets.add(name);
+    return {
+        _tag: 'FormDefinition',
+        schema,
+        secret,
+        validate: (data, intent = '') => validate(schema, secret, intent, data),
+        values: (data) => stickyValues(formDataToObject(data), secret),
+    };
 }
 /**
  * FormData to a plain object. The same function runs on the server, so both sides agree.
  * Repeated names become arrays; a `name[]` suffix always yields an array (named `name`).
  * Values stay strings (or Files): the schema coerces them.
  */
-export function formDataToObject(data) {
+function formDataToObject(data) {
     const out = {};
     for (const key of new Set(data.keys())) {
         const values = data.getAll(key);
@@ -34,39 +113,10 @@ function parse(schema, value, intent, fallbackPath, toMsg) {
     const result = schema['~standard'].validate(value);
     return result instanceof Promise ? result.then(settle) : settle(result);
 }
-/** The text fields of a parsed form, for re-filling it after a rejection. */
-export function formFields(data) {
-    const out = {};
-    for (const [key, value] of Object.entries(data)) {
-        if (typeof value === 'string')
-            out[key] = value;
-        else if (Array.isArray(value))
-            out[key] = value.filter((v) => typeof v === 'string');
-    }
-    return out;
-}
-const schemaOf = (definition) => ('_tag' in definition ? definition.schema : definition);
-/**
- * Validates submitted form data exactly as `form()` does. The no-JS server path
- * (`formAction` in @gyral/ssr) uses it, so both paths produce the same `IntentRejected`.
- */
-export function validateForm(definition, intent, data) {
-    const raw = formDataToObject(data);
-    const values = formFields(raw);
-    const rejected = (issues) => ({
-        ok: false,
-        rejected: { _tag: 'IntentRejected', intent, issues, values },
-    });
-    const settle = (result) => result.issues === undefined
-        ? { ok: true, data: result.value }
-        : rejected(toIssues(result.issues, ''));
-    const result = schemaOf(definition)['~standard'].validate(raw);
-    return result instanceof Promise ? result.then(settle) : settle(result);
-}
 /**
  * Intent parser for a `<form data-intent>` submission, validated by a schema. `toMsg` also
  * gets the raw `FormData`, for sending the submission to the server (`submitForm` in
- * @gyral/http) after it passed client-side validation.
+ * `@gyral/http`) after it passed client-side validation.
  */
 export function form(definition, toMsg) {
     return (input) => {
@@ -74,7 +124,7 @@ export function form(definition, toMsg) {
         if (formData === undefined)
             return undefined;
         const toParsed = (r) => r.ok ? toMsg(r.data, formData) : r.rejected;
-        const result = validateForm(definition, input.name, formData);
+        const result = ('_tag' in definition ? definition : defineForm(definition)).validate(formData, input.name);
         return result instanceof Promise ? result.then(toParsed) : toParsed(result);
     };
 }
@@ -104,7 +154,7 @@ const isFields = (value) => isRecord(value) &&
     Object.values(value).every((v) => typeof v === 'string' || (Array.isArray(v) && v.every((x) => typeof x === 'string')));
 /**
  * A Standard Schema for `IntentRejected` as a server sends it (`formAction` answering JSON).
- * Used by `submitForm` in @gyral/http to recognise a 422 rejection; usable with any decoder.
+ * Used by `submitForm` in `@gyral/http` to recognise a 422 rejection; usable with any decoder.
  */
 export const intentRejectedSchema = {
     '~standard': {
@@ -129,10 +179,4 @@ export const intentRejectedSchema = {
         },
     },
 };
-/** The `location` of a `FormRedirected` answer (from `formAction` in @gyral/ssr), if it is one. */
-export function redirectedTo(body) {
-    return isRecord(body) && body['_tag'] === 'Redirected' && typeof body['location'] === 'string'
-        ? body['location']
-        : undefined;
-}
 //# sourceMappingURL=forms.js.map

package/dist/forms.js.map

@@ -1 +1 @@
-{"version":3,"file":"forms.js","sourceRoot":"","sources":["../src/forms.ts"],"names":[],"mappings":"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","sourcesContent":["// Forms, client half (docs/design-docs/0008-forms.md). Schemas are any Standard Schema v1.\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { FieldIssue, FormFields, IntentInput, IntentParser, IntentRejected } from './types.js';\n\n/** A form's schema, shared by the client component and (with @gyral/ssr) the server route. */\nexport interface FormDefinition<Schema extends StandardSchemaV1> {\n  readonly _tag: 'FormDefinition';\n  readonly schema: Schema;\n}\n\nexport function defineForm<Schema extends StandardSchemaV1>(\n  schema: Schema,\n): FormDefinition<Schema> {\n  return { _tag: 'FormDefinition', schema };\n}\n\nexport type FormValue = FormDataEntryValue | readonly FormDataEntryValue[];\n\n/**\n * FormData to a plain object. The same function runs on the server, so both sides agree.\n * Repeated names become arrays; a `name[]` suffix always yields an array (named `name`).\n * Values stay strings (or Files): the schema coerces them.\n */\nexport function formDataToObject(data: FormData): Readonly<Record<string, FormValue>> {\n  const out: Record<string, FormValue> = {};\n  for (const key of new Set(data.keys())) {\n    const values = data.getAll(key);\n    const [first] = values;\n    if (key.endsWith('[]')) out[key.slice(0, -2)] = values;\n    else if (values.length === 1 && first !== undefined) out[key] = first;\n    else out[key] = values;\n  }\n  return out;\n}\n\nconst segment = (s: PropertyKey | StandardSchemaV1.PathSegment): string =>\n  String(typeof s === 'object' ? s.key : s);\n\nfunction toIssues(\n  issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  fallbackPath: string,\n): FieldIssue[] {\n  return issues.map((issue) => {\n    const path = issue.path?.map(segment).join('.') ?? '';\n    return { path: path === '' ? fallbackPath : path, message: issue.message };\n  });\n}\n\ntype Out<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;\ntype Parsed<M> = M | IntentRejected | undefined;\n\nfunction parse<Schema extends StandardSchemaV1, M>(\n  schema: Schema,\n  value: unknown,\n  intent: string,\n  fallbackPath: string,\n  toMsg: (data: Out<Schema>) => M | undefined,\n): Parsed<M> | Promise<Parsed<M>> {\n  const settle = (result: StandardSchemaV1.Result<Out<Schema>>): Parsed<M> =>\n    result.issues === undefined\n      ? toMsg(result.value)\n      : { _tag: 'IntentRejected', intent, issues: toIssues(result.issues, fallbackPath) };\n  const result = schema['~standard'].validate(value);\n  return result instanceof Promise ? result.then(settle) : settle(result);\n}\n\n/** The text fields of a parsed form, for re-filling it after a rejection. */\nexport function formFields(data: Readonly<Record<string, FormValue>>): FormFields {\n  const out: Record<string, string | readonly string[]> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (typeof value === 'string') out[key] = value;\n    else if (Array.isArray(value)) out[key] = value.filter((v) => typeof v === 'string');\n  }\n  return out;\n}\n\nconst schemaOf = <Schema extends StandardSchemaV1>(\n  definition: FormDefinition<Schema> | Schema,\n): Schema => ('_tag' in definition ? definition.schema : definition);\n\nexport type FormResult<T> =\n  | { readonly ok: true; readonly data: T }\n  | { readonly ok: false; readonly rejected: IntentRejected };\n\n/**\n * Validates submitted form data exactly as `form()` does. The no-JS server path\n * (`formAction` in @gyral/ssr) uses it, so both paths produce the same `IntentRejected`.\n */\nexport function validateForm<Schema extends StandardSchemaV1>(\n  definition: FormDefinition<Schema> | Schema,\n  intent: string,\n  data: FormData,\n): FormResult<Out<Schema>> | Promise<FormResult<Out<Schema>>> {\n  const raw = formDataToObject(data);\n  const values = formFields(raw);\n  const rejected = (issues: readonly FieldIssue[]): FormResult<Out<Schema>> => ({\n    ok: false,\n    rejected: { _tag: 'IntentRejected', intent, issues, values },\n  });\n  const settle = (result: StandardSchemaV1.Result<Out<Schema>>): FormResult<Out<Schema>> =>\n    result.issues === undefined\n      ? { ok: true, data: result.value }\n      : rejected(toIssues(result.issues, ''));\n  const result = schemaOf(definition)['~standard'].validate(raw);\n  return result instanceof Promise ? result.then(settle) : settle(result);\n}\n\n/**\n * Intent parser for a `<form data-intent>` submission, validated by a schema. `toMsg` also\n * gets the raw `FormData`, for sending the submission to the server (`submitForm` in\n * @gyral/http) after it passed client-side validation.\n */\nexport function form<Schema extends StandardSchemaV1, M>(\n  definition: FormDefinition<Schema> | Schema,\n  toMsg: (data: Out<Schema>, formData: FormData) => M | undefined,\n): IntentParser<M> {\n  return (input: IntentInput) => {\n    const { formData } = input;\n    if (formData === undefined) return undefined;\n    const toParsed = (r: FormResult<Out<Schema>>): Parsed<M> =>\n      r.ok ? toMsg(r.data, formData) : r.rejected;\n    const result = validateForm(definition, input.name, formData);\n    return result instanceof Promise ? result.then(toParsed) : toParsed(result);\n  };\n}\n\n/**\n * Intent parser for one control (pair with `data-intent-on=\"input\"` for live checks).\n * Validates `checked` for checkboxes and radios, otherwise `value`.\n */\nexport function field<Schema extends StandardSchemaV1, M>(\n  schema: Schema,\n  toMsg: (value: Out<Schema>) => M | undefined,\n): IntentParser<M> {\n  return (input: IntentInput) => {\n    const name = input.target.getAttribute('name') ?? input.name;\n    return parse(schema, input.checked ?? input.value, input.name, name, toMsg);\n  };\n}\n\n/**\n * Groups issues by field name. Call it in the `IntentRejected` reducer and keep the result in\n * state: `invalid()` re-applies an error only when it gets a new array.\n */\nexport function fieldErrors(\n  issues: readonly FieldIssue[],\n): Readonly<Record<string, readonly string[]>> {\n  const out: Record<string, string[]> = {};\n  for (const { path, message } of issues) (out[path] ??= []).push(message);\n  return out;\n}\n\nconst isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>\n  typeof value === 'object' && value !== null;\n\nconst isIssue = (value: unknown): value is FieldIssue =>\n  isRecord(value) && typeof value['path'] === 'string' && typeof value['message'] === 'string';\n\nconst isFields = (value: unknown): value is FormFields =>\n  isRecord(value) &&\n  Object.values(value).every(\n    (v) => typeof v === 'string' || (Array.isArray(v) && v.every((x) => typeof x === 'string')),\n  );\n\n/**\n * A Standard Schema for `IntentRejected` as a server sends it (`formAction` answering JSON).\n * Used by `submitForm` in @gyral/http to recognise a 422 rejection; usable with any decoder.\n */\nexport const intentRejectedSchema: StandardSchemaV1<unknown, IntentRejected> = {\n  '~standard': {\n    version: 1,\n    vendor: 'gyral',\n    validate: (value) => {\n      if (\n        !isRecord(value) ||\n        value['_tag'] !== 'IntentRejected' ||\n        typeof value['intent'] !== 'string' ||\n        !Array.isArray(value['issues']) ||\n        !value['issues'].every(isIssue) ||\n        (value['values'] !== undefined && !isFields(value['values']))\n      ) {\n        return { issues: [{ message: 'Expected an IntentRejected message' }] };\n      }\n      const rejected: IntentRejected = {\n        _tag: 'IntentRejected',\n        intent: value['intent'],\n        issues: value['issues'],\n        ...(value['values'] === undefined ? {} : { values: value['values'] }),\n      };\n      return { value: rejected };\n    },\n  },\n};\n\n/** A server's JSON answer to a valid form post that would have redirected without JS. */\nexport interface FormRedirected {\n  readonly _tag: 'Redirected';\n  readonly location: string;\n}\n\n/** The `location` of a `FormRedirected` answer (from `formAction` in @gyral/ssr), if it is one. */\nexport function redirectedTo(body: unknown): string | undefined {\n  return isRecord(body) && body['_tag'] === 'Redirected' && typeof body['location'] === 'string'\n    ? body['location']\n    : undefined;\n}\n"]}
+{"version":3,"file":"forms.js","sourceRoot":"","sources":["../src/forms.ts"],"names":[],"mappings":"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","sourcesContent":["// Forms, client half (docs/design-docs/0008-forms.md). Schemas are any Standard Schema v1.\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { DEV } from '#view-dev';\nimport type { FieldIssue, FormFields, IntentInput, IntentParser, IntentRejected } from './types.js';\n\ntype In<Schema extends StandardSchemaV1> = StandardSchemaV1.InferInput<Schema>;\ntype Out<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;\n\n/** The definition's field names, when its input is an object; otherwise any string. */\nexport type FieldName<Schema extends StandardSchemaV1> =\n  In<Schema> extends Readonly<Record<string, unknown>> ? keyof In<Schema> & string : string;\n\nexport interface FormOptions<Schema extends StandardSchemaV1> {\n  /**\n   * Fields whose submitted values are never sent back: not in `IntentRejected.values`, not in\n   * `values()`, not in the devtools timeline. Any posted field name may be listed, including\n   * fields outside the schema. Names containing `password`, `passcode`, `csrf` or `xsrf` are\n   * secret without being listed (the browser never restores a password field either, and a\n   * CSRF token must come fresh from the server, not from the echo).\n   */\n  readonly secret?: readonly (FieldName<Schema> | (string & {}))[];\n}\n\n/**\n * A form's submitted text values, keyed by the definition's fields, for re-rendering the form\n * with what was typed (sticky fields). The same shape as `IntentRejected.values`: repeated names\n * (and `name[]`) are arrays; `File`s and secret fields are left out.\n */\nexport type FormValues<Schema extends StandardSchemaV1> =\n  In<Schema> extends Readonly<Record<string, unknown>>\n    ? { readonly [K in keyof In<Schema> & string]?: string | readonly string[] }\n    : FormFields;\n\nexport type FormResult<T> =\n  | { readonly ok: true; readonly data: T }\n  | { readonly ok: false; readonly rejected: IntentRejected };\n\n/** A form's schema, shared by the client component and (with `@gyral/ssr`) the server route. */\nexport interface FormDefinition<Schema extends StandardSchemaV1> {\n  readonly _tag: 'FormDefinition';\n  readonly schema: Schema;\n  /** The fields listed as secret (names containing `password`, `passcode`, `csrf` or `xsrf` are secret too). */\n  readonly secret: readonly string[];\n  /**\n   * Validates submitted form data exactly as `form()` does; the server's `formAction` uses it,\n   * so both paths produce the same `IntentRejected` (`intent` defaults to `''`).\n   */\n  readonly validate: (\n    data: FormData,\n    intent?: string,\n  ) => FormResult<Out<Schema>> | Promise<FormResult<Out<Schema>>>;\n  /** The submitted text values without secrets: what a re-rendered form may show again. */\n  readonly values: (data: FormData) => FormValues<Schema>;\n}\n\n// Every secret name a definition declared, for redacting previews (the devtools timeline).\nconst declaredSecrets = /* @__PURE__ */ new Set<string>();\n\nconst DEFAULT_SECRET = /password|passcode|csrf|xsrf/i;\n\n/** Whether `name` is never echoed: declared secret by a form, or a password-like name. */\nexport function isSecretField(name: string): boolean {\n  return DEFAULT_SECRET.test(name) || declaredSecrets.has(name);\n}\n\n// Words that suggest a secret; an unlisted field named with one gets a development warning.\nconst SUSPECT = /* @__PURE__ */ new Set([\n  'password',\n  'passcode',\n  'token',\n  'secret',\n  'card',\n  'cvc',\n  'cvv',\n  'ssn',\n  'pin',\n]);\nconst warned = /* @__PURE__ */ new Set<string>();\n\nfunction warnUnmarked(key: string): void {\n  if (warned.has(key)) return;\n  const words = key\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .toLowerCase()\n    .split(/[^a-z0-9]+/);\n  if (!words.some((w) => SUSPECT.has(w))) return;\n  warned.add(key);\n  console.warn(\n    `Gyral: form field \"${key}\" looks secret but isn't listed in defineForm(schema, { secret }); ` +\n      'its value is echoed back after a rejection.',\n  );\n}\n\n/**\n * The text values of a parsed submission, for re-filling the form after a rejection: Files and\n * the fields `secret` names (or that look like passwords) are left out.\n */\nfunction stickyValues(\n  data: Readonly<Record<string, FormValue>>,\n  secret: readonly string[],\n): FormFields {\n  const out: Record<string, string | readonly string[]> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (DEFAULT_SECRET.test(key) || secret.includes(key)) continue;\n    if (DEV) warnUnmarked(key);\n    if (typeof value === 'string') out[key] = value;\n    else if (Array.isArray(value)) out[key] = value.filter((v) => typeof v === 'string');\n  }\n  return out;\n}\n\nfunction validate<Schema extends StandardSchemaV1>(\n  schema: Schema,\n  secret: readonly string[],\n  intent: string,\n  data: FormData,\n): FormResult<Out<Schema>> | Promise<FormResult<Out<Schema>>> {\n  const raw = formDataToObject(data);\n  const settle = (result: StandardSchemaV1.Result<Out<Schema>>): FormResult<Out<Schema>> =>\n    result.issues === undefined\n      ? { ok: true, data: result.value }\n      : {\n          ok: false,\n          rejected: {\n            _tag: 'IntentRejected',\n            intent,\n            issues: toIssues(result.issues, ''),\n            values: stickyValues(raw, secret),\n          },\n        };\n  const result = schema['~standard'].validate(raw);\n  return result instanceof Promise ? result.then(settle) : settle(result);\n}\n\nexport function defineForm<Schema extends StandardSchemaV1>(\n  schema: Schema,\n  options: FormOptions<Schema> = {},\n): FormDefinition<Schema> {\n  const secret: readonly string[] = options.secret ?? [];\n  // Only the devtools timeline reads these, and it only runs in development.\n  if (DEV) for (const name of secret) declaredSecrets.add(name);\n  return {\n    _tag: 'FormDefinition',\n    schema,\n    secret,\n    validate: (data, intent = '') => validate(schema, secret, intent, data),\n    values: (data) => stickyValues(formDataToObject(data), secret) as FormValues<Schema>,\n  };\n}\n\nexport type FormValue = FormDataEntryValue | readonly FormDataEntryValue[];\n\n/**\n * FormData to a plain object. The same function runs on the server, so both sides agree.\n * Repeated names become arrays; a `name[]` suffix always yields an array (named `name`).\n * Values stay strings (or Files): the schema coerces them.\n */\nfunction formDataToObject(data: FormData): Readonly<Record<string, FormValue>> {\n  const out: Record<string, FormValue> = {};\n  for (const key of new Set(data.keys())) {\n    const values = data.getAll(key);\n    const [first] = values;\n    if (key.endsWith('[]')) out[key.slice(0, -2)] = values;\n    else if (values.length === 1 && first !== undefined) out[key] = first;\n    else out[key] = values;\n  }\n  return out;\n}\n\nconst segment = (s: PropertyKey | StandardSchemaV1.PathSegment): string =>\n  String(typeof s === 'object' ? s.key : s);\n\nfunction toIssues(\n  issues: ReadonlyArray<StandardSchemaV1.Issue>,\n  fallbackPath: string,\n): FieldIssue[] {\n  return issues.map((issue) => {\n    const path = issue.path?.map(segment).join('.') ?? '';\n    return { path: path === '' ? fallbackPath : path, message: issue.message };\n  });\n}\n\ntype Parsed<M> = M | IntentRejected | undefined;\n\nfunction parse<Schema extends StandardSchemaV1, M>(\n  schema: Schema,\n  value: unknown,\n  intent: string,\n  fallbackPath: string,\n  toMsg: (data: Out<Schema>) => M | undefined,\n): Parsed<M> | Promise<Parsed<M>> {\n  const settle = (result: StandardSchemaV1.Result<Out<Schema>>): Parsed<M> =>\n    result.issues === undefined\n      ? toMsg(result.value)\n      : { _tag: 'IntentRejected', intent, issues: toIssues(result.issues, fallbackPath) };\n  const result = schema['~standard'].validate(value);\n  return result instanceof Promise ? result.then(settle) : settle(result);\n}\n\n/**\n * Intent parser for a `<form data-intent>` submission, validated by a schema. `toMsg` also\n * gets the raw `FormData`, for sending the submission to the server (`submitForm` in\n * `@gyral/http`) after it passed client-side validation.\n */\nexport function form<Schema extends StandardSchemaV1, M>(\n  definition: FormDefinition<Schema> | Schema,\n  toMsg: (data: Out<Schema>, formData: FormData) => M | undefined,\n): (input: IntentInput) => ReturnType<IntentParser<M>> {\n  return (input: IntentInput) => {\n    const { formData } = input;\n    if (formData === undefined) return undefined;\n    const toParsed = (r: FormResult<Out<Schema>>): Parsed<M> =>\n      r.ok ? toMsg(r.data, formData) : r.rejected;\n    const result = ('_tag' in definition ? definition : defineForm(definition)).validate(\n      formData,\n      input.name,\n    );\n    return result instanceof Promise ? result.then(toParsed) : toParsed(result);\n  };\n}\n\n/**\n * Intent parser for one control (pair with `data-intent-on=\"input\"` for live checks).\n * Validates `checked` for checkboxes and radios, otherwise `value`.\n */\nexport function field<Schema extends StandardSchemaV1, M>(\n  schema: Schema,\n  toMsg: (value: Out<Schema>) => M | undefined,\n): (input: IntentInput) => ReturnType<IntentParser<M>> {\n  return (input: IntentInput) => {\n    const name = input.target.getAttribute('name') ?? input.name;\n    return parse(schema, input.checked ?? input.value, input.name, name, toMsg);\n  };\n}\n\n/**\n * Groups issues by field name. Call it in the `IntentRejected` reducer and keep the result in\n * state: `invalid()` re-applies an error only when it gets a new array.\n */\nexport function fieldErrors(\n  issues: readonly FieldIssue[],\n): Readonly<Record<string, readonly string[]>> {\n  const out: Record<string, string[]> = {};\n  for (const { path, message } of issues) (out[path] ??= []).push(message);\n  return out;\n}\n\nconst isRecord = (value: unknown): value is Readonly<Record<string, unknown>> =>\n  typeof value === 'object' && value !== null;\n\nconst isIssue = (value: unknown): value is FieldIssue =>\n  isRecord(value) && typeof value['path'] === 'string' && typeof value['message'] === 'string';\n\nconst isFields = (value: unknown): value is FormFields =>\n  isRecord(value) &&\n  Object.values(value).every(\n    (v) => typeof v === 'string' || (Array.isArray(v) && v.every((x) => typeof x === 'string')),\n  );\n\n/**\n * A Standard Schema for `IntentRejected` as a server sends it (`formAction` answering JSON).\n * Used by `submitForm` in `@gyral/http` to recognise a 422 rejection; usable with any decoder.\n */\nexport const intentRejectedSchema: StandardSchemaV1<unknown, IntentRejected> = {\n  '~standard': {\n    version: 1,\n    vendor: 'gyral',\n    validate: (value) => {\n      if (\n        !isRecord(value) ||\n        value['_tag'] !== 'IntentRejected' ||\n        typeof value['intent'] !== 'string' ||\n        !Array.isArray(value['issues']) ||\n        !value['issues'].every(isIssue) ||\n        (value['values'] !== undefined && !isFields(value['values']))\n      ) {\n        return { issues: [{ message: 'Expected an IntentRejected message' }] };\n      }\n      const rejected: IntentRejected = {\n        _tag: 'IntentRejected',\n        intent: value['intent'],\n        issues: value['issues'],\n        ...(value['values'] === undefined ? {} : { values: value['values'] }),\n      };\n      return { value: rejected };\n    },\n  },\n};\n"]}

package/dist/frame-lane.d.ts

@@ -0,0 +1,11 @@
+import type { HostTask } from './scheduler.js';
+/** The frame lane as the scheduler uses it. */
+export interface FrameLane {
+    /** Marks `task` for the next frame; then `mark` moves each waiting host to a microtask flush. */
+    add(task: HostTask, mark: (task: HostTask) => void): void;
+    /** A microtask mark took `task` out of the frame lane. */
+    drop(task: HostTask): void;
+    /** Hosts are waiting for a frame (settled() waits for them). */
+    pending(): boolean;
+}
+export declare const frameLane: FrameLane;