basalt-ui 1.26.0 → 1.28.0

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

@@ -12,7 +12,26 @@ export type UseFormDraftOptions<Values> = {
     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. */
@@ -29,15 +48,13 @@ export type UseFormDraftReturn = {
  * 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 wire into useBasaltForm's `onValuesChange`).
- *
- * AUTOSAVE: @mantine/form has no whole-form change subscription on an existing form.
- * The cleanest path is to pass `saveDraft` to `useBasaltForm({ onValuesChange: () => saveDraft() })`.
- * For forms not created via useBasaltForm, call `saveDraft` manually on blur.
+ * - `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, field, FormErrorSummary, useFormDraft } from 'basalt-ui/forms'
+ * 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>
@@ -45,13 +62,11 @@ export type UseFormDraftReturn = {
  *
  * function MyForm() {
  *   const form = useBasaltForm({ initialValues: INITIAL, schema: Schema, mode: 'uncontrolled' })
- *   const { clearDraft, saveDraft, hasDraft } = useFormDraft(form, { key: 'my-form', version: 1 })
- *   // Wire saveDraft into onValuesChange after form creation via a ref or external callback:
- *   // form is created above; wire via onBlur as the safe fallback shown here.
+ *   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 {...field(form, 'name')} onBlur={saveDraft} />
+ *       <TextInput key={fieldKey(form, 'name')} {...inputProps(form, 'name')} />
  *       {hasDraft && <Button onClick={clearDraft}>Clear draft</Button>}
  *     </form>
  *   )

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

@@ -1 +1 @@
-{"version":3,"file":"use-form-draft.d.ts","sourceRoot":"","sources":["../../src/forms/use-form-draft.ts"],"names":[],"mappings":"AA0BA,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;CAC3C,CAAA;AAED,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;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,CAyEpB"}
+{"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,28 +1,18 @@
-import { useEffect, useRef } from "react";
+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 } = opts;
-  const storeRef = useRef(null);
+  const { key, version, schema, autosave } = opts;
+  const storeRef = useRef(
+    null
+  );
   if (storeRef.current === null) {
-    const envelopeSchema = schema !== void 0 ? {
-      "~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 } };
-        }
-      }
-    } : void 0;
+    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 }
     });
   }
@@ -48,8 +38,55 @@ function useFormDraft(form, opts) {
   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

@@ -0,0 +1,88 @@
+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`
+     * (`basalt-ui/query`), 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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,63 @@
+import { useCallback, useRef, useState } from "react";
+import { toErrorMessage } from "../query/error-message.js";
+function isFieldErrorEnvelope(err) {
+  if (err === null || typeof err !== "object") return false;
+  const fieldErrors = err.fieldErrors;
+  if (fieldErrors === null || typeof fieldErrors !== "object" || Array.isArray(fieldErrors)) {
+    return false;
+  }
+  return Object.values(fieldErrors).every((message) => typeof message === "string");
+}
+function focusFirstError(form, errors) {
+  if (typeof document === "undefined") return;
+  for (const [path, message] of Object.entries(errors)) {
+    if (message === null || message === void 0 || message === false) continue;
+    const node = form.getInputNode(path) ?? document.querySelector(`[name="${path}"]`);
+    if (node !== null) {
+      node.focus();
+      return;
+    }
+  }
+}
+function useFormSubmit(form, handler, options = {}) {
+  const [submitError, setSubmitError] = useState(null);
+  const handlerRef = useRef(handler);
+  handlerRef.current = handler;
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const formRef = useRef(form);
+  formRef.current = form;
+  const submit = form.onSubmit(
+    async (values) => {
+      const { onSuccess, onError, mapError, validateAsync } = optionsRef.current;
+      setSubmitError(null);
+      try {
+        const fieldErrors = await validateAsync?.(values);
+        if (fieldErrors !== void 0 && fieldErrors !== null && hasEntries(fieldErrors)) {
+          applyFieldErrors(formRef.current, fieldErrors);
+          return;
+        }
+        await handlerRef.current(values);
+        onSuccess?.(values);
+      } catch (err) {
+        if (isFieldErrorEnvelope(err)) applyFieldErrors(formRef.current, err.fieldErrors);
+        setSubmitError(mapError === void 0 ? toErrorMessage(err) : mapError(err));
+        onError?.(err);
+      }
+    },
+    (errors) => focusFirstError(formRef.current, errors)
+  );
+  const reset = useCallback(() => setSubmitError(null), []);
+  return { submit, isSubmitting: form.submitting, submitError, reset };
+}
+function hasEntries(errors) {
+  return Object.keys(errors).length > 0;
+}
+function applyFieldErrors(form, fieldErrors) {
+  form.setErrors(fieldErrors);
+  focusFirstError(form, fieldErrors);
+}
+export {
+  isFieldErrorEnvelope,
+  useFormSubmit
+};

package/dist/guard/index.d.ts

@@ -280,7 +280,7 @@ export declare const GUARD_RULES: {
         readonly pattern: RegExp;
         readonly enabled: (cfg: GuardConfig) => boolean;
         readonly appliesTo: (relPath: string) => boolean;
-        readonly message: "Raw HTML element with inline layout/surface styling that the line scan cannot see — the tag is formatted across lines, or the style object is hoisted to a const. Same violation as raw-html-layout: use a Mantine layout primitive (Box/Flex/Grid/Stack/Group). Promoted to error in the Unreleased minor (C16) with severity only — the kind stayed standalone rather than folding into raw-html-layout as originally planned; the merge is still open, tracked as a follow-up, not done here.";
+        readonly message: "Raw HTML element with inline layout/surface styling that the line scan cannot see — the tag is formatted across lines, or the style object is hoisted to a const. Same violation as raw-html-layout: use a Mantine layout primitive (Box/Flex/Grid/Stack/Group). Promoted to error at 1.26.0 (C16) with severity only — the kind stayed standalone rather than folding into raw-html-layout as originally planned; the merge is still open, tracked as a follow-up, not done here.";
     };
     readonly 'in-body-page-title': {
         readonly kind: "in-body-page-title";

package/dist/guard/index.d.ts.map

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

package/dist/guard/index.js

@@ -136,9 +136,16 @@ const PAGE_TITLE_TAG = /<Title(?![\w.])(?:=>|[^>])*?>/g;
 const PAGE_TITLE_ORDER_PROP = /\border\s*=\s*\{\s*([12])\s*\}/;
 const RAW_SELECTION_CONTROL_TAG = /<(SegmentedControl|Select|MultiSelect|NativeSelect|DatePickerInput|DateInput|TagsInput|Chip\.Group)(?![\w])(?:=>|[^>])*?>/g;
 const PROSE_CONTEXT_TAG = /<(?:Prose|ArticleLayout|Modal|Drawer)(?![\w])/;
-const CONTROL_HOST_TAG = /<(?:SettingsRow|Modal|Drawer|Popover\.Dropdown|Menu\.Dropdown|Composer)(?![\w])/;
+const CONTROL_HOST_TAG = /<(?:SettingsRow|Modal|Drawer|Popover\.Dropdown|Menu\.Dropdown|Composer|FilterSet|PageAside|PanelRow)(?![\w])/;
 const CONTROL_HOST_WINDOW_LINES = 12;
-const CONTROL_OWNER_DEF = /\b(?:function|const|class)\s+(?:RangeFilter|CompareFilter|SelectFilter|MultiSelectFilter|SearchFilter|ToggleFilter|ViewTabs|FilterSet|FilterPill|SyncButton|ActionGroup|OverflowMenu|CtlSlot)(?![\w])/;
+const OVERLAY_CONVENTION_KEBAB = /^[^/]*-(?:modal|drawer|popover|panel|form)\.[jt]sx$/;
+const OVERLAY_CONVENTION_PASCAL = /^[A-Z]\w*(?:Modal|Drawer|Popover|Panel|Form)\.[jt]sx$/;
+function isOverlayConventionFile(relPath) {
+  const basename = relPath.slice(relPath.lastIndexOf("/") + 1);
+  return OVERLAY_CONVENTION_KEBAB.test(basename) || OVERLAY_CONVENTION_PASCAL.test(basename);
+}
+const CONTROL_OWNER_DEF = /\b(?:function|const|class)\s+(?:RangeFilter|CompareFilter|SelectFilter|MultiSelectFilter|NumberFilter|SearchFilter|ToggleFilter|ViewTabs|FilterSet|FilterPill|EnumFilter|PanelRow|SliderControl|SyncButton|ActionGroup|OverflowMenu|CtlSlot)(?![\w])/;
+const BASALT_ANY_IMPORT = /\b(?:from|import)\s+['"]basalt-ui(?:\/[^'"]*)?['"]/;
 const MANTINE_FORM_IMPORT = /from\s+['"]@mantine\/form['"]/;
 const STYLES_INPUT_PART = /\bstyles\s*=\s*\{\{\s*input\s*:\s*\{([^}]*)\}/g;
 const SUB_16_FONT_SIZE = /font-?[Ss]ize\s*:\s*['"]?(-?\d+(?:\.\d+)?)(?:px)?['"]?(?=[,\s}]|$)/g;
@@ -166,15 +173,10 @@ const DEFAULT_GUARD_CONFIG = {
   severity: {}
 };
 const GRACE_PERIOD_KINDS = {
-  "in-body-page-title": {
-    since: "1.26.0",
-    promote: "1.27.0",
-    why: "new in the wave-6 control guards (docs/CONTROLS-SPEC.md \xA76, law C8). Its AST twin is the oxlint rule of the SAME id, whose PLUGIN_RULE_GRACE entry carries the same dates \u2014 one law, two lanes, one promotion. Warn for a minor because the fix is a route/breadcrumb change (the page is named by staticData.title), not a prop edit, so a consumer needs to schedule it."
-  },
   "raw-selection-control": {
     since: "1.26.0",
-    promote: "1.27.0",
-    why: 'new in the wave-6 control guards (docs/CONTROLS-SPEC.md \xA76, law C1). The text lane cannot see ancestry, so "no home" is approximated by a 12-line host-tag window \u2014 the loosest reading in the guard, and the reason this one lands warn rather than error even though its law is settled. Promotion is gated with the plugin half on the wave-7 consumer run (\u22643 waivers), and `scripts/check-grace.ts` refuses the 1.27.0 release while the entry is still here.'
+    promote: "1.30.0",
+    why: 'new in the wave-6 control guards (docs/CONTROLS-SPEC.md \xA76, law C1). The text lane cannot see ancestry, so "no home" is approximated by a 12-line host-tag window \u2014 the loosest reading in the guard, and the reason this one lands warn rather than error even though its law is settled. It moved from 1.27.0 to 1.30.0 with its AST twin, `basalt/control-outside-home`, whose PLUGIN_RULE_GRACE entry carries the measurement: the wave-7 run left 9 warns in argo, all of them a control in a modal/form module whose `<Modal>` is rendered by the PARENT \u2014 law C1 cross-file, which neither lane can see. `isOverlayConventionFile` (this file, and the same regex in the plugin) exempts that declared naming convention in both lanes. Re-dated 2026-08-28 \u2014 the argo wave-7 migration has not run; the PascalCase overlay convention (this change) is expected to clear most of the 9. 1.30.0 is when the remainder is re-measured. One law, two lanes, one promotion.'
   }
 };
 function severityOf(kind, cfg) {
@@ -253,11 +255,25 @@ const PLUGIN_RULE_IDS = /* @__PURE__ */ new Set([
   "raw-scroll-container",
   "hand-rolled-filter",
   "control-outside-home",
+  // No text-lane twin, by design: a bound control's NAME says nothing without the import graph
+  // and the ancestry, which a 12-line regex window has neither of. See the rule's own JSDoc.
+  "bound-control-outside-home",
   "control-size-literal",
   "page-bar-budget",
   "responsive-twin",
   "search-literal-link",
   "use-search-from-literal",
+  // The four F5 rules and the B4 deprecation rule — all AST-only, all outside `checkSource`'s
+  // reach: provenance here is an import graph and a JSX ancestry, neither of which a 12-line
+  // regex window has. Same reason `bound-control-outside-home` has no text-lane twin.
+  "provider-above-router",
+  "duplicate-notifications-mount",
+  "query-dual-import",
+  "query-fn-unwrap",
+  "deprecated-export",
+  // Same lane: `{...inputProps(…)}` without a sibling `key` is a JSX-ancestry claim (does this
+  // ELEMENT carry a `key` attribute?) over an import-resolved callee — neither is text.
+  "forms-field-key",
   // `in-body-page-title` is deliberately ABSENT: it is a plugin rule AND a guard kind under one id
   // (one law, two lanes, one annotation), and this set is the ids OUTSIDE `checkSource`'s reach.
   // `check-source.test.ts` asserts the two registries stay disjoint.
@@ -819,7 +835,7 @@ const GUARD_RULES = {
     // handled inline (full-text tag-scoped scan + hoisted-const lookup)
     enabled: (cfg) => cfg.rawHtmlLayout,
     appliesTo: (relPath) => !isChartFile(relPath) && !relPath.endsWith(".css"),
-    message: "Raw HTML element with inline layout/surface styling that the line scan cannot see \u2014 the tag is formatted across lines, or the style object is hoisted to a const. Same violation as raw-html-layout: use a Mantine layout primitive (Box/Flex/Grid/Stack/Group). Promoted to error in the Unreleased minor (C16) with severity only \u2014 the kind stayed standalone rather than folding into raw-html-layout as originally planned; the merge is still open, tracked as a follow-up, not done here."
+    message: "Raw HTML element with inline layout/surface styling that the line scan cannot see \u2014 the tag is formatted across lines, or the style object is hoisted to a const. Same violation as raw-html-layout: use a Mantine layout primitive (Box/Flex/Grid/Stack/Group). Promoted to error at 1.26.0 (C16) with severity only \u2014 the kind stayed standalone rather than folding into raw-html-layout as originally planned; the merge is still open, tracked as a follow-up, not done here."
   },
   "in-body-page-title": {
     kind: "in-body-page-title",
@@ -1093,7 +1109,7 @@ function checkSource(text, relPath, cfg) {
       });
     }
   }
-  if (ruleApplies("raw-selection-control", relPath) && !CONTROL_OWNER_DEF.test(codeText) && !MANTINE_FORM_IMPORT.test(codeText)) {
+  if (ruleApplies("raw-selection-control", relPath) && !isOverlayConventionFile(relPath) && !(CONTROL_OWNER_DEF.test(codeText) && !BASALT_ANY_IMPORT.test(codeText)) && !MANTINE_FORM_IMPORT.test(codeText)) {
     for (const m of codeText.matchAll(RAW_SELECTION_CONTROL_TAG)) {
       const startLine = codeText.slice(0, m.index ?? 0).split("\n").length;
       const windowStart = Math.max(0, startLine - 1 - CONTROL_HOST_WINDOW_LINES);

package/dist/index.d.ts

@@ -6,24 +6,26 @@
  * here, so a tokens/charts-only consumer never pulls in `@mantine/*`.
  */
 export { BasaltProvider, type BasaltProviderProps, BasaltErrorBoundary, type BasaltErrorContext, } from './provider/index.js';
+export { type BasaltProps, type SlotClassNames, type SlotStylesProps, type Tone, type ToneWithNeutral, type Tier, cx, assignRef, mergeRefs, BASALT_PREFIX, requiredProp, oneOf, deprecatedProp, duplicateMount, missingLayer, useValidateProps, assertRequiredProps, scrollParentOf, SCROLLPORT_ATTRIBUTE, } from './common/index.js';
 export { createBasaltTheme, baseTheme, cssVariablesResolver } from './theme/index.js';
 export type { BasaltFontsConfig, CreateBasaltThemeOptions } from './theme/index.js';
 export { CTL_THEME, CtlSlot } from './theme/index.js';
 export type { CtlSlotProps } from './theme/index.js';
 /**
  * The action vocabulary every home's `actions` slot takes (`docs/CONTROLS-SPEC.md` §2.1). The
- * COMPONENTS that project it (`ActionGroup`, `OverflowMenu`, `SyncButton`, and the filter family)
- * live on `basalt-ui/controls` — only the types a `PageBar`/`BasaltShell` prop mentions are here.
+ * OTHER components that project it (`OverflowMenu`, `SyncButton`, and the filter family) live on
+ * `basalt-ui/controls`; `ActionGroup` is re-exported here alongside its own types so a typed
+ * `PageBar`/`BasaltShell` `actions` wrapper needs only this one subpath.
  */
-export type { BarAction, ActionGroupProps, GlobalAction } from './controls/actions.js';
+export { ActionGroup, type BarAction, type ActionGroupProps, type GlobalAction, } from './controls/actions.js';
 export { ThemeToggle, type ThemeToggleProps } from './theme-toggle/index.js';
 export { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from './motion/index.js';
-export { BasaltShell, NavCountBadge, AppSidebar, SidebarSearch, type SidebarSearchConfig, type SidebarSearchActions, SidebarAccount, MobileNav, type MobileNavProps, projectMobileNav, type ProjectMobileNavOptions, MOBILE_MAX_TABS_DEFAULT, MOBILE_MENU_MAX_DEFAULT, MOBILE_MORE_KEY, AppBreadcrumbs, PageBar, type PageBarProps, type SidebarSection, type SidebarItem, type SidebarBlock, type SidebarBlockItem, type SidebarBlockTone, type SidebarListBlock, type SidebarProgressBlock, type SidebarCustomBlock, type NavAnchor, type NavAnchorProps, type NavMobilePlacement, type NavSectionMobile, type MobileNavConfig, type MobileNavGroup, type MobileNavModel, type MobileNavSlot, type MobileNavSurface, type BasaltShellProps, type BrandConfig, type SettingsMenuItem, type AppSidebarProps, type AccountBadgeTone, type BasaltIdentity, type BasaltRole, type BasaltPlan, type AccountMenuItem, type BasaltAccountState, type BasaltAccountActions, type BasaltAccountProps, } from './shell/index.js';
+export { BasaltShell, NavCountBadge, type NavCountBadgeProps, AppSidebar, SidebarSearch, type SidebarSearchProps, type SidebarSearchConfig, type SidebarSearchActions, SidebarAccount, MobileNav, type MobileNavProps, projectMobileNav, type ProjectMobileNavOptions, MOBILE_MAX_TABS_DEFAULT, MOBILE_MENU_MAX_DEFAULT, MOBILE_MORE_KEY, AppBreadcrumbs, type AppBreadcrumbsProps, PageBar, type PageBarProps, type PageBarSlot, PageAside, type PageAsideProps, type PageAsideSlot, type SidebarSection, type SidebarItem, type SidebarBlock, type SidebarBlockItem, type SidebarBlockTone, type SidebarListBlock, type SidebarProgressBlock, type SidebarCustomBlock, type NavAnchor, type NavAnchorProps, type NavMobilePlacement, type NavSectionMobile, type MobileNavConfig, type MobileNavGroup, type MobileNavModel, type MobileNavSlot, type MobileNavSurface, type BasaltShellProps, type BrandConfig, type SettingsMenuItem, type AppSidebarProps, type AccountBadgeTone, type BasaltIdentity, type BasaltRole, type BasaltPlan, type AccountMenuItem, type BasaltAccountState, type BasaltAccountActions, type BasaltAccountProps, } from './shell/index.js';
 export { type BasaltRegister, type Slot, type Series, type SeriesKey, type AsyncState, assertNever, type StandardSchemaV1, } from './register.js';
-export { createPersistedState, type PersistedStateOptions, readPersistedValue, createLocalStore, type LocalStore, type AnyField, type BooleanField, type EnumField, type FieldHandle, type FieldLane, type FieldOption, type FieldValue, type MultiField, type NumberField, type RangeField, type RangeParams, type RangePresets, type RangeValue, type ResolvedLane, type SearchValues, type StoredValues, type StringField, } from './state.js';
-export { WidgetHeader, type WidgetHeaderProps } from './widget-header/index.js';
-export { Section, type SectionProps } from './section/index.js';
-export { DeltaBadge, type DeltaBadgeProps, StatCard, type StatCardProps, type StatCardTone, EmptyState, type EmptyStateProps, SettingsSection, type SettingsSectionProps, SettingsRow, type SettingsRowProps, DangerZone, type DangerZoneProps, QueryState, type QueryStateProps, type QueryStateLike, type QueryStateVariant, type QueryEmptyCopy, LoadingState, type LoadingStateProps, ErrorState, type ErrorStateProps, } from './dashboard/index.js';
+export { createPersistedState, type PersistedStateOptions, readPersistedValue, createLocalStore, type LocalStore, type AnyField, type BooleanField, type EnumField, type FieldFallback, type FieldHandle, type FieldLane, type FieldOption, type FieldSetOptions, type FieldValue, type MultiField, type NumberField, type RangeField, type RangeParams, type RangePresets, type RangeValue, type RangeWindow, type RangeWindows, type ResolvedLane, type ResolveLane, type SearchValues, type StoredValues, type StringField, } from './state.js';
+export { WidgetHeader, type WidgetHeaderDeltaProps, type WidgetHeaderMetricProps, type WidgetHeaderProps, type WidgetHeaderSlot, type WidgetHeaderTier, type WidgetHeaderTitleProps, DeltaBadge, type DeltaBadgeProps, type DeltaPolarity, } from './widget-header/index.js';
+export { Section, type SectionProps, type SectionSlot } from './section/index.js';
+export { StatCard, type StatCardBreakdownRow, type StatCardProps, type StatCardSlot, type StatCardTone, WidgetGrid, type WidgetGridCols, type WidgetGridItemProps, type WidgetGridProps, StatGroup, type StatGroupCols, type StatGroupProps, EmptyState, type EmptyStateProps, type EmptyStateSlot, SettingsSection, type SettingsSectionProps, type SettingsSectionSlot, SettingsRow, type SettingsRowProps, type SettingsRowSlot, DangerZone, type DangerZoneProps, QueryState, type QueryStateProps, type QueryStateLike, type QueryStateSlot, type QueryStateTier, type QueryStateVariant, type QueryEmptyCopy, LoadingState, type LoadingStateProps, ErrorState, type ErrorStateProps, } from './dashboard/index.js';
 export { ConnectivityProvider, ConnectivityIndicator, useConnectivity } from './connectivity/index.js';
 export type { ConnectivityStatus, ConnectivitySnapshot, ConnectivityProviderProps, ConnectivityOverride, } from './connectivity/index.js';
 export type { SurfaceSpec, RuleName, SkillName } from './surfaces.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -2,8 +2,26 @@ import {
   BasaltProvider,
   BasaltErrorBoundary
 } from "./provider/index.js";
+import {
+  cx,
+  assignRef,
+  mergeRefs,
+  BASALT_PREFIX,
+  requiredProp,
+  oneOf,
+  deprecatedProp,
+  duplicateMount,
+  missingLayer,
+  useValidateProps,
+  assertRequiredProps,
+  scrollParentOf,
+  SCROLLPORT_ATTRIBUTE
+} from "./common/index.js";
 import { createBasaltTheme, baseTheme, cssVariablesResolver } from "./theme/index.js";
 import { CTL_THEME, CtlSlot } from "./theme/index.js";
+import {
+  ActionGroup
+} from "./controls/actions.js";
 import { ThemeToggle } from "./theme-toggle/index.js";
 import { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from "./motion/index.js";
 import {
@@ -18,7 +36,8 @@ import {
   MOBILE_MENU_MAX_DEFAULT,
   MOBILE_MORE_KEY,
   AppBreadcrumbs,
-  PageBar
+  PageBar,
+  PageAside
 } from "./shell/index.js";
 import {
   assertNever
@@ -28,11 +47,15 @@ import {
   readPersistedValue,
   createLocalStore
 } from "./state.js";
-import { WidgetHeader } from "./widget-header/index.js";
+import {
+  WidgetHeader,
+  DeltaBadge
+} from "./widget-header/index.js";
 import { Section } from "./section/index.js";
 import {
-  DeltaBadge,
   StatCard,
+  WidgetGrid,
+  StatGroup,
   EmptyState,
   SettingsSection,
   SettingsRow,
@@ -61,8 +84,10 @@ import {
   useAgentThreadRuns
 } from "./agent/index.js";
 export {
+  ActionGroup,
   AppBreadcrumbs,
   AppSidebar,
+  BASALT_PREFIX,
   BasaltErrorBoundary,
   BasaltProvider,
   BasaltShell,
@@ -84,14 +109,17 @@ export {
   MOTION_SPRING,
   MobileNav,
   NavCountBadge,
+  PageAside,
   PageBar,
   QueryState,
+  SCROLLPORT_ATTRIBUTE,
   Section,
   SettingsRow,
   SettingsSection,
   SidebarAccount,
   SidebarSearch,
   StatCard,
+  StatGroup,
   ThemeToggle,
   ThreadDetailPanel,
   ThreadFeed,
@@ -100,8 +128,11 @@ export {
   ThreadTranscript,
   ThreadWorkspace,
   ToolChip,
+  WidgetGrid,
   WidgetHeader,
   assertNever,
+  assertRequiredProps,
+  assignRef,
   baseTheme,
   createAdapterThreadsStore,
   createBasaltTheme,
@@ -109,11 +140,20 @@ export {
   createPersistedState,
   createThreadsStore,
   cssVariablesResolver,
+  cx,
+  deprecatedProp,
+  duplicateMount,
   heuristicOutcome,
+  mergeRefs,
+  missingLayer,
+  oneOf,
   projectMobileNav,
   readPersistedValue,
+  requiredProp,
+  scrollParentOf,
   threadPartRenderers,
   threadsStoreAdapterContract,
   useAgentThreadRuns,
-  useConnectivity
+  useConnectivity,
+  useValidateProps
 };