basalt-ui 1.41.0 → 2.0.0

package/dist/data/virtual-list.js

@@ -1,157 +0,0 @@
-import { jsx } from "react/jsx-runtime";
-import { Box, Skeleton } from "@mantine/core";
-import { useVirtualizer } from "@tanstack/react-virtual";
-import { useImperativeHandle, useRef } from "react";
-import { cx } from "../common/props.js";
-import { BASALT_PREFIX } from "../common/errors.js";
-import { HIT_COARSE } from "../common/hit-floor.js";
-import { assertRequiredProps, useValidateProps } from "../common/validate.js";
-import { readMediaQuery } from "../common/use-media-query.js";
-import { ErrorState } from "../dashboard/query-state.js";
-import { dataQueryBranch } from "./query-branch.js";
-function shortRowHeightMessage(estimateSize) {
-  return `${BASALT_PREFIX} BasaltVirtualList: "estimateSize" is ${estimateSize}px under a coarse (touch) pointer \u2014 every row renders at this height, below the \`--vx-hit\` floor (44px, WCAG 2.5.5). Raise "estimateSize" to at least 44, or pad the row content so it clears the floor.`;
-}
-function BasaltVirtualList(props) {
-  assertRequiredProps("BasaltVirtualList", props, ["items", "renderItem", "getItemKey"]);
-  const {
-    items,
-    height,
-    estimateSize = 40,
-    overscan = 5,
-    renderItem,
-    getItemKey,
-    isLoading = false,
-    query,
-    emptyState,
-    skeletonRows = 5,
-    ref,
-    className,
-    style,
-    classNames
-  } = props;
-  useValidateProps(
-    "BasaltVirtualList",
-    () => query === void 0 || props.isLoading === void 0 ? null : `${BASALT_PREFIX} BasaltVirtualList: props "query" and "isLoading" are both set \u2014 "query" wins and "isLoading" is ignored. Drop "isLoading".`,
-    [query === void 0, props.isLoading === void 0]
-  );
-  useValidateProps(
-    "BasaltVirtualList",
-    () => props.estimateSize !== void 0 && props.estimateSize < HIT_COARSE && readMediaQuery("(pointer: coarse)", false) ? shortRowHeightMessage(props.estimateSize) : null,
-    [props.estimateSize]
-  );
-  const parentRef = useRef(null);
-  const rowVirtualizer = useVirtualizer({
-    count: items.length,
-    getScrollElement: () => parentRef.current,
-    estimateSize: () => estimateSize,
-    overscan,
-    // Silences a React 19 deprecation warning: TanStack Virtual calls flushSync on scroll;
-    // setting this to false opts out of that path entirely.
-    useFlushSync: false,
-    getItemKey: (index) => {
-      const item = items[index];
-      return item !== void 0 ? getItemKey(item, index) : index;
-    }
-  });
-  useImperativeHandle(
-    ref,
-    () => ({
-      scrollToIndex: (index, opts) => rowVirtualizer.scrollToIndex(index, opts),
-      scrollToOffset: (offset, opts) => rowVirtualizer.scrollToOffset(offset, opts),
-      scrollToEnd: (opts) => rowVirtualizer.scrollToEnd(opts),
-      getVirtualizer: () => rowVirtualizer
-    }),
-    [rowVirtualizer]
-  );
-  const branch = query === void 0 ? void 0 : dataQueryBranch("BasaltVirtualList", query);
-  const showSkeleton = branch === void 0 ? isLoading : branch === "pending";
-  const boxProps = {
-    className: cx(classNames?.root, className),
-    style: {
-      height,
-      // theme-allow raw-scroll-container — matches the virtualizer's own scroll box below, so a
-      // placeholder branch doesn't reflow.
-      overflow: "auto",
-      ...style
-    }
-  };
-  if (branch === "error" && query !== void 0) {
-    return /* @__PURE__ */ jsx(Box, { ...boxProps, children: /* @__PURE__ */ jsx(
-      ErrorState,
-      {
-        error: query.error,
-        title: "Could not load",
-        tier: "section",
-        retrying: query.fetchStatus === "fetching",
-        onRetry: () => void query.refetch()
-      }
-    ) });
-  }
-  if (showSkeleton) {
-    return /* @__PURE__ */ jsx(Box, { ...boxProps, children: Array.from({ length: skeletonRows }, (_, i) => /* @__PURE__ */ jsx(
-      Box,
-      {
-        style: {
-          height: estimateSize,
-          padding: "var(--vx-space-virtual-row-inset-y) var(--vx-space-virtual-row-inset-x)",
-          boxSizing: "border-box"
-        },
-        children: /* @__PURE__ */ jsx(
-          Skeleton,
-          {
-            height: `calc(${estimateSize}px - 2 * var(--vx-space-virtual-row-inset-y))`,
-            radius: "sm"
-          }
-        )
-      },
-      `skeleton-${i}`
-    )) });
-  }
-  if (items.length === 0 && emptyState !== void 0) return /* @__PURE__ */ jsx(Box, { ...boxProps, children: emptyState });
-  return /* @__PURE__ */ jsx(
-    Box,
-    {
-      ref: parentRef,
-      className: cx(classNames?.root, className),
-      style: {
-        height,
-        // theme-allow raw-scroll-container — TanStack Virtual measures this element as the scroll container.
-        overflow: "auto",
-        ...style
-      },
-      children: /* @__PURE__ */ jsx(
-        Box,
-        {
-          style: {
-            height: rowVirtualizer.getTotalSize(),
-            position: "relative"
-          },
-          children: rowVirtualizer.getVirtualItems().map((virtualItem) => {
-            const item = items[virtualItem.index];
-            if (item === void 0) return null;
-            return /* @__PURE__ */ jsx(
-              Box,
-              {
-                className: cx(classNames?.row),
-                style: {
-                  position: "absolute",
-                  top: 0,
-                  left: 0,
-                  width: "100%",
-                  height: virtualItem.size,
-                  transform: `translateY(${virtualItem.start}px)`
-                },
-                children: renderItem(item, virtualItem.index)
-              },
-              virtualItem.key
-            );
-          })
-        }
-      )
-    }
-  );
-}
-export {
-  BasaltVirtualList
-};

package/dist/data/virtual.d.ts

@@ -1,21 +0,0 @@
-/**
- * ./data/virtual — BasaltVirtualList: a windowed virtual list over @tanstack/react-virtual,
- * rendered with a Mantine Box scroll container.
- *
- * Optional peer: @tanstack/react-virtual >=3.13.26 <4. This list works on any 3.x — the floor is
- * set by ./agent-chat's virtualize mode, so do not lower it.
- *
- * This subpath does NOT value-import @tanstack/react-table, so the data-table peer is never
- * required — use `./data/table` when your app only needs the table.
- *
- * Install with:
- *   bun add @tanstack/react-virtual
- *
- * @example
- * import { BasaltVirtualList } from 'basalt-ui/data/virtual'
- * const items = Array.from({ length: 10_000 }, (_, i) => ({ id: i, label: `Row ${i}` }))
- * <BasaltVirtualList items={items} height={400} renderItem={(item) => <div>{item.label}</div>} />
- */
-export { BasaltVirtualList } from './virtual-list.js';
-export type { BasaltVirtualListHandle, BasaltVirtualListProps, BasaltVirtualListSlot, } from './virtual-list.js';
-//# sourceMappingURL=virtual.d.ts.map

package/dist/data/virtual.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"virtual.d.ts","sourceRoot":"","sources":["../../src/data/virtual.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA"}

package/dist/data/virtual.js

@@ -1,4 +0,0 @@
-import { BasaltVirtualList } from "./virtual-list.js";
-export {
-  BasaltVirtualList
-};

package/dist/forms/FormErrorSummary.d.ts

@@ -1,30 +0,0 @@
-import type { UseFormReturnType } from '@mantine/form';
-import type { BasaltProps } from '../common/props.js';
-/** Props for FormErrorSummary. */
-export type FormErrorSummaryProps<Values extends Record<string, unknown>> = BasaltProps & {
-    form: UseFormReturnType<Values>;
-    /** Accessible heading shown above the error list. Defaults to "Please fix the following errors". */
-    title?: string;
-};
-/**
- * Renders an accessible error summary list for long forms and screen readers.
- * Follows the WCAG error-summary pattern — a single `role="alert"` container that
- * lists all field errors, placed at the top of the form so AT announces it on submit.
- *
- * Returns `null` when the form has no errors (renders nothing when the form is clean).
- *
- * @example
- * import { FormErrorSummary, useBasaltForm } from 'basalt-ui/forms'
- *
- * function MyForm() {
- *   const form = useBasaltForm({ initialValues: { email: '' } })
- *   return (
- *     <form onSubmit={form.onSubmit(console.log)}>
- *       <FormErrorSummary form={form} title="Fix these before submitting" />
- *       <TextInput key={fieldKey(form, 'email')} {...inputProps(form, 'email')} label="Email" />
- *     </form>
- *   )
- * }
- */
-export declare function FormErrorSummary<Values extends Record<string, unknown>>(props: FormErrorSummaryProps<Values>): import("react").JSX.Element | null;
-//# sourceMappingURL=FormErrorSummary.d.ts.map

package/dist/forms/FormErrorSummary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FormErrorSummary.d.ts","sourceRoot":"","sources":["../../src/forms/FormErrorSummary.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAMlD,kCAAkC;AAClC,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,WAAW,GAAG;IACxF,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC/B,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC,sCA8BrC"}

package/dist/forms/FormErrorSummary.js

@@ -1,30 +0,0 @@
-import { jsx } from "react/jsx-runtime";
-import { Alert, List, Text } from "@mantine/core";
-import { assertRequiredProps } from "../common/validate.js";
-import { alpha, VX } from "../tokens/index.js";
-function FormErrorSummary(props) {
-  assertRequiredProps("FormErrorSummary", props, ["form"]);
-  const { form, title = "Please fix the following errors", className, style } = props;
-  const errorEntries = Object.entries(form.errors);
-  if (errorEntries.length === 0) return null;
-  return /* @__PURE__ */ jsx(
-    Alert,
-    {
-      role: "alert",
-      title: /* @__PURE__ */ jsx(Text, { fw: 600, children: title }),
-      ...className !== void 0 && { className },
-      ...style !== void 0 && { style },
-      styles: {
-        root: {
-          backgroundColor: alpha(VX.status.bad, 0.13),
-          color: VX.status.bad,
-          borderRadius: "var(--vx-radius-ctrl)"
-        }
-      },
-      children: /* @__PURE__ */ jsx(List, { size: "sm", mt: 4, children: errorEntries.map(([path, message]) => /* @__PURE__ */ jsx(List.Item, { children: String(message) }, path)) })
-    }
-  );
-}
-export {
-  FormErrorSummary
-};

package/dist/forms/use-field-array.d.ts

@@ -1,60 +0,0 @@
-/**
- * ./forms — useFieldArray: the list-field surface over Mantine's four list actions.
- * Mantine-coupled. Optional peer: @mantine/form.
- *
- * The gap (audit B §4): `insertListItem` / `removeListItem` / `reorderListItem` are all reachable
- * off the raw form object, but they are unexported by name, undocumented in the forms doctrine, and
- * each takes a different argument shape (`(path, item, index?)`, `(path, index)`,
- * `(path, { from, to })`). The list ALSO has to be read back out of the values by dotted path, and
- * every row needs `form.key(\`${path}.${i}\`)` or the uncontrolled reconciler reuses the wrong DOM
- * node when a row is removed from the middle — which is the defect this hook exists to make
- * unwritable.
- */
-import type { FormArrayElement, LooseKeys, UseFormReturnType } from '@mantine/form';
-export type UseFieldArrayReturn<Item> = {
-    /** The live list. `[]` when the path holds nothing, so a call site never guards before mapping. */
-    items: Item[];
-    /** Push one item onto the end. */
-    append: (value: Item) => void;
-    /** Drop the item at `index`. Mantine re-indexes the field errors with it. */
-    remove: (index: number) => void;
-    /** Move one item, e.g. from a drag handle or a pair of arrow buttons. */
-    move: (from: number, to: number) => void;
-    /**
-     * Mantine's reconciler key for row `index` (`form.key('<path>.<index>')`) — pass it as the row's
-     * JSX `key`, never spread it.
-     *
-     * **Positional, and that is a real limit worth stating**: it identifies the SLOT, not the item.
-     * Mantine's list actions write values through `$values` directly and never bump the form-level
-     * key generation (verified in 9.3.2's use-form-list), so removing row 0 does not change row 0's
-     * key — it changes which item sits there. That is correct for an append/remove list, where the
-     * uncontrolled inputs below re-read their `defaultValue` from the new values anyway. A list the
-     * USER reorders wants an identity key instead: put a `randomId()` on the item and key the row on
-     * that.
-     */
-    key: (index: number) => string;
-};
-/**
- * Reads and edits a list field as one object.
- *
- * **`items` is read from `form.getValues()`, not from `form.values`**, so it is correct under the
- * `mode: 'uncontrolled'` default `useBasaltForm` sets: the list actions all re-render the form
- * (they call `setValues` with `updateState: true`), so the snapshot this returns is the one the
- * caller just produced.
- *
- * @example
- * const items = useFieldArray(form, 'contacts')
- *
- * {items.items.map((_, index) => (
- *   <FormRow key={items.key(index)} label={`Contact ${index + 1}`}>
- *     <TextInput
- *       key={fieldKey(form, `contacts.${index}.email`)}
- *       {...inputProps(form, `contacts.${index}.email`)}
- *     />
- *     <Button onClick={() => items.remove(index)}>Remove</Button>
- *   </FormRow>
- * ))}
- * <Button onClick={() => items.append({ email: '' })}>Add contact</Button>
- */
-export declare function useFieldArray<Values extends Record<string, unknown>, Path extends LooseKeys<Values>>(form: UseFormReturnType<Values>, path: Path): UseFieldArrayReturn<FormArrayElement<Values, Path & string>>;
-//# sourceMappingURL=use-field-array.d.ts.map

package/dist/forms/use-field-array.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-field-array.d.ts","sourceRoot":"","sources":["../../src/forms/use-field-array.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEnF,MAAM,MAAM,mBAAmB,CAAC,IAAI,IAAI;IACtC,mGAAmG;IACnG,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,kCAAkC;IAClC,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAA;IAC7B,6EAA6E;IAC7E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,yEAAyE;IACzE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC;;;;;;;;;;;OAWG;IACH,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAC/B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,IAAI,SAAS,SAAS,CAAC,MAAM,CAAC,EAE9B,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,IAAI,EAAE,IAAI,GACT,mBAAmB,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAU9D"}

package/dist/forms/use-field-array.js

@@ -1,20 +0,0 @@
-function useFieldArray(form, path) {
-  return {
-    items: readList(form.getValues(), String(path)),
-    append: (value) => form.insertListItem(path, value),
-    remove: (index) => form.removeListItem(path, index),
-    move: (from, to) => form.reorderListItem(path, { from, to }),
-    key: (index) => form.key(`${String(path)}.${index}`)
-  };
-}
-function readList(values, path) {
-  let current = values;
-  for (const segment of path.split(".")) {
-    if (current === null || typeof current !== "object") return [];
-    current = current[segment];
-  }
-  return Array.isArray(current) ? current : [];
-}
-export {
-  useFieldArray
-};

package/dist/forms/use-form-draft.d.ts

@@ -1,76 +0,0 @@
-import type { UseFormReturnType } from '@mantine/form';
-import type { StandardSchemaV1 } from '../register.js';
-/** Options for useFormDraft. */
-export type UseFormDraftOptions<Values> = {
-    /**
-     * Stable localStorage key for the draft. Must not change between renders —
-     * changing the key recreates the storage instance and loses the draft.
-     * Will be stored under `basalt:form:<key>`.
-     */
-    key: string;
-    /** Envelope version — increment when the values shape changes to discard stale drafts. */
-    version: number;
-    /** Optional Standard Schema to validate the persisted draft before restoring. */
-    schema?: StandardSchemaV1<unknown, Values>;
-    /**
-     * Persist on every value change, debounced. `true` uses {@link DEFAULT_AUTOSAVE_DEBOUNCE_MS};
-     * pass `{ debounceMs }` to tune it (`0` saves on the next macrotask).
-     *
-     * **The on/off decision and the watched key set are read ONCE, on mount.** The subscription is
-     * `form.watch` per top-level key, and `watch` calls `useEffect` internally, so both are a hook
-     * count and neither may move between renders. Flipping this prop later therefore neither starts
-     * nor stops autosaving; a form whose top-level SHAPE changes after mount needs `saveDraft` called
-     * by hand for the new keys. `debounceMs` is the exception — it is read at FIRE time, so a form
-     * that widens its window mid-edit gets the new one.
-     *
-     * Nested edits are covered: Mantine notifies a parent-path subscriber for a `a.b.c` change, so
-     * watching the top level watches the whole tree.
-     */
-    autosave?: boolean | {
-        debounceMs?: number;
-    };
-};
-/** Long enough that a typed word is one write, short enough that a closed tab keeps the sentence. */
-export declare const DEFAULT_AUTOSAVE_DEBOUNCE_MS = 500;
-/** Return value of useFormDraft. */
-export type UseFormDraftReturn = {
-    /** True when a draft different from the initial values is persisted. */
-    hasDraft: boolean;
-    /** Persist the current form values to localStorage. Call on blur, onValuesChange, or submit failure. */
-    saveDraft: () => void;
-    /** Clear the persisted draft (call in onSubmit success). */
-    clearDraft: () => void;
-};
-/**
- * Autosave/restore/clear-on-submit draft persistence for Mantine forms.
- * Backed by `createPersistedState` (versioned, SSR-safe, cross-tab).
- *
- * MUST-HAVES:
- * - Restores the draft once on mount if a draft is persisted.
- * - `clearDraft()` removes the persisted draft (call in onSubmit success).
- * - `saveDraft()` snapshots current form values (call onBlur, or leave it to `autosave`).
- * - `autosave: true` subscribes for you — see {@link UseFormDraftOptions.autosave} for the two
- *   properties that are frozen at mount, and why.
- *
- * @example
- * import * as v from 'valibot'
- * import { useBasaltForm, inputProps, fieldKey, FormErrorSummary, useFormDraft } from 'basalt-ui/forms'
- *
- * const Schema = v.object({ name: v.pipe(v.string(), v.minLength(2)), amount: v.number() })
- * type Values = v.InferOutput<typeof Schema>
- * const INITIAL: Values = { name: '', amount: 0 }
- *
- * function MyForm() {
- *   const form = useBasaltForm({ initialValues: INITIAL, schema: Schema, mode: 'uncontrolled' })
- *   const { clearDraft, hasDraft } = useFormDraft(form, { key: 'my-form', version: 1, autosave: true })
- *   return (
- *     <form onSubmit={form.onSubmit((values) => { submit(values); clearDraft() })}>
- *       <FormErrorSummary form={form} />
- *       <TextInput key={fieldKey(form, 'name')} {...inputProps(form, 'name')} />
- *       {hasDraft && <Button onClick={clearDraft}>Clear draft</Button>}
- *     </form>
- *   )
- * }
- */
-export declare function useFormDraft<Values extends Record<string, unknown>>(form: UseFormReturnType<Values>, opts: UseFormDraftOptions<Values>): UseFormDraftReturn;
-//# sourceMappingURL=use-form-draft.d.ts.map

package/dist/forms/use-form-draft.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-form-draft.d.ts","sourceRoot":"","sources":["../../src/forms/use-form-draft.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAInD,gCAAgC;AAChC,MAAM,MAAM,mBAAmB,CAAC,MAAM,IAAI;IACxC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7C,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C,oCAAoC;AACpC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAA;IACjB,wGAAwG;IACxG,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,GAChC,kBAAkB,CAwDpB"}

package/dist/forms/use-form-draft.js

@@ -1,92 +0,0 @@
-import { useCallback, useEffect, useRef } from "react";
-import { createPersistedState } from "../state.js";
-const DEFAULT_AUTOSAVE_DEBOUNCE_MS = 500;
-function useFormDraft(form, opts) {
-  const { key, version, schema, autosave } = opts;
-  const storeRef = useRef(
-    null
-  );
-  if (storeRef.current === null) {
-    const envelopeSchema = wrapEnvelopeSchema(schema);
-    storeRef.current = createPersistedState({
-      key: `form:${key}`,
-      version,
-      initial: null,
-      // exactOptionalPropertyTypes forbids `schema: undefined`, so it is spread or omitted.
-      ...envelopeSchema !== void 0 && { schema: envelopeSchema }
-    });
-  }
-  const useDraft = storeRef.current;
-  const [draft, setDraft] = useDraft();
-  const hasDraft = draft !== null;
-  const restoredRef = useRef(false);
-  const formRef = useRef(form);
-  formRef.current = form;
-  const draftOnMountRef = useRef(draft);
-  useEffect(() => {
-    if (restoredRef.current) return;
-    restoredRef.current = true;
-    const mountDraft = draftOnMountRef.current;
-    if (mountDraft !== null) {
-      formRef.current.setValues(mountDraft.values);
-    }
-  }, []);
-  const saveDraft = () => {
-    const values = formRef.current.getValues();
-    setDraft({ values });
-  };
-  const clearDraft = () => {
-    setDraft(null);
-  };
-  useAutosave(form, autosave, saveDraft);
-  return { hasDraft, saveDraft, clearDraft };
-}
-function wrapEnvelopeSchema(schema) {
-  if (schema === void 0) return void 0;
-  return {
-    "~standard": {
-      version: 1,
-      vendor: "basalt-form-draft",
-      validate: (raw) => {
-        if (typeof raw !== "object" || raw === null || !("values" in raw)) return { value: null };
-        const result = schema["~standard"].validate(raw.values);
-        if (result instanceof Promise) return { value: null };
-        if (result.issues !== void 0) return { value: null };
-        return { value: { values: result.value } };
-      }
-    }
-  };
-}
-function useAutosave(form, autosave, saveDraft) {
-  const watchedPathsRef = useRef(null);
-  if (watchedPathsRef.current === null) {
-    watchedPathsRef.current = autosave === void 0 || autosave === false ? [] : Object.keys(form.getValues());
-  }
-  const debounceRef = useRef(DEFAULT_AUTOSAVE_DEBOUNCE_MS);
-  debounceRef.current = typeof autosave === "object" ? autosave.debounceMs ?? DEFAULT_AUTOSAVE_DEBOUNCE_MS : DEFAULT_AUTOSAVE_DEBOUNCE_MS;
-  const saveRef = useRef(saveDraft);
-  saveRef.current = saveDraft;
-  const timerRef = useRef(null);
-  const scheduleSave = useCallback(() => {
-    if (timerRef.current !== null) clearTimeout(timerRef.current);
-    timerRef.current = setTimeout(() => {
-      timerRef.current = null;
-      saveRef.current();
-    }, debounceRef.current);
-  }, []);
-  useEffect(
-    () => () => {
-      if (timerRef.current !== null) {
-        clearTimeout(timerRef.current);
-        timerRef.current = null;
-        saveRef.current();
-      }
-    },
-    []
-  );
-  for (const path of watchedPathsRef.current) form.watch(path, scheduleSave);
-}
-export {
-  DEFAULT_AUTOSAVE_DEBOUNCE_MS,
-  useFormDraft
-};

package/dist/forms/use-form-submit.d.ts

@@ -1,88 +0,0 @@
-import type { SyntheticEvent } from 'react';
-import type { UseFormReturnType } from '@mantine/form';
-/**
- * Per-field messages keyed by the same dotted paths `inputProps(form, path)` uses
- * (`'email'`, `'addresses.0.city'`). The shape a server returns for a 422, and the shape
- * `validateAsync` returns for a uniqueness check.
- */
-export type FormFieldErrors = Record<string, string>;
-/**
- * Whether a thrown value carries `{ fieldErrors }` — the envelope `useFormSubmit` routes back onto
- * the fields instead of into one form-level message.
- *
- * Structural, not `instanceof`: the throw crosses a transport (Eden, `fetch`, a mutation wrapper)
- * and arrives as a plain object, so an `Error` subclass would only match the one shape basalt
- * itself constructed. The keys are checked to be STRINGS — a `{ fieldErrors: { email: 422 } }`
- * would otherwise reach `form.setErrors` and render a number under an input.
- *
- * @example
- * throw Object.assign(new Error('Validation failed'), { fieldErrors: { email: 'Already taken' } })
- */
-export declare function isFieldErrorEnvelope(err: unknown): err is {
-    fieldErrors: FormFieldErrors;
-};
-export type UseFormSubmitOptions<Values extends Record<string, unknown>> = {
-    /** Ran after the handler resolves. The success path — close the modal, clear the draft, navigate. */
-    onSuccess?: (values: Values) => void;
-    /** Ran on any throw, after `submitError` is set. For telemetry or a toast; not required for either. */
-    onError?: (err: unknown) => void;
-    /**
-     * Turns a thrown value into the message `submitError` carries. Defaults to `toErrorMessage`
-     * (root barrel), which already unwraps `Error`, `{ message }` and Eden's `{ status, value }`.
-     * Override it to brand the copy or to branch on `errorStatus(err)`.
-     */
-    mapError?: (err: unknown) => string;
-    /**
-     * The async half of validation, run AFTER the schema passes and BEFORE the handler — a uniqueness
-     * check, a server-side cross-field rule, anything that needs the network.
-     *
-     * It lives here rather than on `useBasaltForm` because that hook hard-codes
-     * `schemaResolver(schema, { sync: true })` so `validate()`/`isValid()` stay synchronous for every
-     * field-level read. Moving the async rule to submit time keeps that property AND gives the rule a
-     * home; the cost, stated plainly, is that it does not run on blur.
-     *
-     * Return `null` (or an empty record) for "valid". Anything else is set on the fields, the first
-     * one is focused, and the handler never runs.
-     */
-    validateAsync?: (values: Values) => Promise<FormFieldErrors | null>;
-};
-export type UseFormSubmitReturn = {
-    /** Hand straight to `<form onSubmit={submit}>`, or call it from a button's `onClick`. */
-    submit: (event?: SyntheticEvent<HTMLFormElement>) => void;
-    /** True from the moment a submit starts until the handler settles. Mantine's own `form.submitting`. */
-    isSubmitting: boolean;
-    /** The form-level failure message, or `null`. Cleared at the start of every submit. */
-    submitError: string | null;
-    /** Clears `submitError` without submitting — for a "dismiss" on the error banner. */
-    reset: () => void;
-};
-/**
- * Wraps `form.onSubmit` with the four things a real submit needs: a busy flag, a caught and decoded
- * error, a server field-error envelope routed back onto the fields, and focus on the first thing
- * that is wrong.
- *
- * **`isSubmitting` IS `form.submitting`**, not a second piece of state beside it. Mantine already
- * flips that flag around a handler returning a promise, and this handler always does; duplicating it
- * would give a form two busy flags that can disagree, which is the failure a `FormStateProvider`
- * reading the wrong one produces.
- *
- * **Focus moves on BOTH failure paths** — a schema failure (through `onSubmit`'s own
- * `handleValidationFailure`) and a thrown `{ fieldErrors }` envelope. A server's 422 lands exactly
- * where a client-side error does.
- *
- * @example
- * const { submit, isSubmitting, submitError } = useFormSubmit(
- *   form,
- *   async (values) => { await unwrap(api.users.post({ body: values })) },
- *   { onSuccess: () => { clearDraft(); close() }, validateAsync: checkHandleFree },
- * )
- *
- * <form onSubmit={submit}>
- *   <FormStateProvider submitting={isSubmitting}>
- *     {submitError !== null && <Alert color="red">{submitError}</Alert>}
- *     …
- *   </FormStateProvider>
- * </form>
- */
-export declare function useFormSubmit<Values extends Record<string, unknown>>(form: UseFormReturnType<Values>, handler: (values: Values) => void | Promise<void>, options?: UseFormSubmitOptions<Values>): UseFormSubmitReturn;
-//# sourceMappingURL=use-form-submit.d.ts.map

package/dist/forms/use-form-submit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-form-submit.d.ts","sourceRoot":"","sources":["../../src/forms/use-form-submit.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAKtD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAAE,WAAW,EAAE,eAAe,CAAA;CAAE,CAO1F;AAmCD,MAAM,MAAM,oBAAoB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACzE,qGAAqG;IACrG,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,uGAAuG;IACvG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAA;IACnC;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;CACpE,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,yFAAyF;IACzF,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IACzD,uGAAuG;IACvG,YAAY,EAAE,OAAO,CAAA;IACrB,uFAAuF;IACvF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,qFAAqF;IACrF,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACjD,OAAO,GAAE,oBAAoB,CAAC,MAAM,CAAM,GACzC,mBAAmB,CAwCrB"}