basalt-ui 1.27.0 → 1.29.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 "../common/errors.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

@@ -1,7 +1,7 @@
 /**
  * ./guard — headless policy core. Mantine-free, dependency-free.
  *
- * GUARD_RULES: the closed registry of all 27 violation kinds.
+ * GUARD_RULES: the closed registry of all 26 violation kinds.
  * checkSource:  pure (text, relPath, cfg) → Finding[]. No FS, no walk, no console.
  */
 import type { Finding, GuardConfig, GuardKind, GuardSeverity } from './types.js';
@@ -115,7 +115,7 @@ export declare const GENERATED_HEADER_LINE = "/* @generated basalt-ui \u2014 do
  */
 export declare const TOKENS_ONLY_DISABLED_KINDS: ReadonlySet<GuardKind>;
 /**
- * The closed registry of all 27 guard kinds. The triad test asserts
+ * The closed registry of all 26 guard kinds. The triad test asserts
  * `surface.guardKinds ⊆ keyof GUARD_RULES` at runtime.
  *
  * raw-surface, raw-html-layout, and sub-16-input-font are handled inline in checkSource
@@ -229,13 +229,6 @@ export declare const GUARD_RULES: {
         readonly appliesTo: (relPath: string) => boolean;
         readonly message: "Route animation timing through MOTION_DURATION / MOTION_SPRING / MOTION_EASE_STANDARD (basalt-ui motion tokens) instead of a hardcoded duration/spring/ease.";
     };
-    readonly 'unframed-chart': {
-        readonly kind: "unframed-chart";
-        readonly pattern: RegExp;
-        readonly enabled: (cfg: GuardConfig) => boolean;
-        readonly appliesTo: (relPath: string) => boolean;
-        readonly message: "Hand-rolled ChartLegend built from an inline array literal — pass a derived legend (deriveLegend(series)), or compose ChartFrame, which derives it for you.";
-    };
     readonly 'chart-missing-aria-label': {
         readonly kind: "chart-missing-aria-label";
         readonly pattern: RegExp;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guard/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE7E,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,CAAA;AA8jB9D,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,EAAE,WAoBlC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAerE,CAAA;AA0GD,sGAAsG;AACtG,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAAA;CAC7C,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,WAAW,EAChB,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,sBAAsB,EAAE,CAc1B;AAID;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CA4B9C,CAAA;AAgeF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,gGACwD,CAAA;AA8F1F;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,SAAS,CA0B5D,CAAA;AA2NF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;gCA0BL,WAAW;;;;;;;gCAcX,WAAW;;;;;gCAMX,WAAW;;;;;;;gCAaX,WAAW;;;;;;;gCAQX,WAAW;;;;;;gCAOX,WAAW;;;;;;;gCASX,WAAW;;;;;;gCAOX,WAAW;;;;;;;gCAaX,WAAW;;;;;;gCAMX,WAAW;;;;;;;gCAaX,WAAW;;;;;;;gCAUX,WAAW;;;;;;;gCAUX,WAAW;;;;;;;gCASX,WAAW;;;;;;;gCASX,WAAW;;;;;;;gCAUX,WAAW;;;;;;;;;;;;gCAgBX,WAAW;;;;;;gCAOX,WAAW;;;;;;;gCASX,WAAW;;;;;;;;;;;;;;;;;;;;;CA2BmB,CAAA;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEvD;AAKD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAUD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,EAAE,CAictF;AAID;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/B,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IACzC,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,oGAAoG;IACpG,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,qGAAqG;IACrG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,WAAW,GACf,mBAAmB,EAAE,CAuBvB;AAED,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,6BAA6B,CAAA;AAEjE;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAM9F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guard/index.ts"],"names":[],"mappings":"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"}

package/dist/guard/index.js

@@ -107,7 +107,6 @@ const AXIS_WRAPPER_FILE = /(?:^|\/)Axes\.tsx$/;
 const RADIUS_PROP_RE = /\bradius=(?:\{[0-9]+\}|"[0-9]+")/g;
 const MOTION_TRANSITION_NUMERIC = /\btransition\s*=\s*\{\{[^}]*\b(?:duration|stiffness|damping|mass)\s*:\s*-?\d/g;
 const MOTION_TRANSITION_EASE_ARRAY = /\btransition\s*=\s*\{\{[^}]*\bease\s*:\s*\[/g;
-const RAW_CHART_LEGEND_ARRAY = /<ChartLegend\b[^>]*?\bitems\s*=\s*\{\s*\[/g;
 const CHART_ENTRY_POINT_TAG = /<(MultiLine|Bars|BandStrip|Donut|DualPanel|Heatmap|MirroredBars|ZonedLine|StackedArea|LineSparkline|BarSparkline)\b(?:<[^<>]*>)?(?:=>|[^>])*?>/g;
 const HAS_ARIA_LABEL_PROP = /\bariaLabel\s*=/;
 const LOCAL_COMPONENT_DEF = /(?:^|[\n;}])\s*(?:export\s+)?(?:default\s+)?(?:async\s+)?(?:function|class|const|let|var)\s+([A-Z]\w*)/g;
@@ -136,10 +135,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 OVERLAY_CONVENTION_FILE = /(?:^|\/)[^/]*-(?:modal|drawer|popover|panel|form)\.[jt]sx$/;
-const CONTROL_OWNER_DEF = /\b(?:function|const|class)\s+(?:RangeFilter|CompareFilter|SelectFilter|MultiSelectFilter|NumberFilter|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;
@@ -158,7 +163,6 @@ const DEFAULT_GUARD_CONFIG = {
   inlineDisplay: true,
   rawVisxAxis: true,
   rawMotionValue: true,
-  unframedChart: true,
   chartMissingAriaLabel: true,
   rawFormControl: true,
   sub16InputFont: true,
@@ -169,8 +173,8 @@ const DEFAULT_GUARD_CONFIG = {
 const GRACE_PERIOD_KINDS = {
   "raw-selection-control": {
     since: "1.26.0",
-    promote: "1.28.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.28.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. `OVERLAY_CONVENTION_FILE` (this file, and the same regex in the plugin) exempts that declared naming convention in both lanes; 1.28.0 is when the remainder is re-measured. One law, two lanes, one promotion.'
+    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) {
@@ -249,22 +253,45 @@ 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 three remaining 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",
+  "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.
   "visx-boundary",
   "visx-tooltip",
   "token-layer-boundary",
+  "no-import-meta-env",
   // These three honour `basalt-agent-allow`, never `theme-allow` — but they are still REAL ids, so
   // a `theme-allow ai-sdk-major` must parse as a (useless) scoped annotation rather than as prose.
   "agent-resume-guard",
   "agent-no-raw-usechat",
-  "ai-sdk-major"
+  "ai-sdk-major",
+  // Retired guard kinds — `unframed-chart`'s only case (`<ChartLegend items={[...]}>`) is fully
+  // subsumed by `basalt/chart-legend-literal`. Kept here (mirrored by the plugin's own
+  // `RETIRED_RULE_IDS`) so an existing `theme-allow unframed-chart` reads as a dead waiver via
+  // `--audit-allows`, never as an unknown-id typo.
+  "unframed-chart",
+  // Retired plugin rule — `<BasaltNotifications />` mounted beside `<BasaltOverlays
+  // notifications>` is unreachable now that `BasaltNotifications` no longer exists as a
+  // standalone export. Mirrored by the plugin's own `RETIRED_RULE_IDS`.
+  "duplicate-notifications-mount"
 ]);
 const MIN_ALLOW_REASON_LENGTH = 4;
 function parseAllowAnnotation(rest, scope) {
@@ -459,7 +486,6 @@ const TOKENS_ONLY_DISABLED_KINDS = /* @__PURE__ */ new Set([
   "inline-display",
   "raw-visx-axis",
   "raw-motion-value",
-  "unframed-chart",
   "chart-missing-aria-label",
   "raw-form-control",
   "sub-16-input-font",
@@ -750,15 +776,6 @@ const GUARD_RULES = {
     appliesTo: (relPath) => !relPath.endsWith(".css"),
     message: "Route animation timing through MOTION_DURATION / MOTION_SPRING / MOTION_EASE_STANDARD (basalt-ui motion tokens) instead of a hardcoded duration/spring/ease."
   },
-  "unframed-chart": {
-    kind: "unframed-chart",
-    pattern: RAW_CHART_LEGEND_ARRAY,
-    // handled inline (full-text tag-scoped scan); entry keeps registry complete
-    enabled: (cfg) => cfg.unframedChart,
-    // JSX-tag-shaped (`<ChartLegend items={[…]}>`) — never appears in CSS text.
-    appliesTo: (relPath) => !relPath.endsWith(".css"),
-    message: "Hand-rolled ChartLegend built from an inline array literal \u2014 pass a derived legend (deriveLegend(series)), or compose ChartFrame, which derives it for you."
-  },
   "chart-missing-aria-label": {
     kind: "chart-missing-aria-label",
     pattern: CHART_ENTRY_POINT_TAG,
@@ -1039,17 +1056,10 @@ function checkSource(text, relPath, cfg) {
       });
     }
   }
-  const unframedChartRuns = GUARD_RULES["unframed-chart"].enabled(cfg) && ruleApplies("unframed-chart", relPath);
   const ariaLabelRuns = GUARD_RULES["chart-missing-aria-label"].enabled(cfg) && ruleApplies("chart-missing-aria-label", relPath);
-  const localNames = unframedChartRuns || ariaLabelRuns ? localComponentNames(codeText) : /* @__PURE__ */ new Set();
-  const basaltNames = unframedChartRuns || ariaLabelRuns ? basaltImportedNames(codeText) : /* @__PURE__ */ new Set();
+  const localNames = ariaLabelRuns ? localComponentNames(codeText) : /* @__PURE__ */ new Set();
+  const basaltNames = ariaLabelRuns ? basaltImportedNames(codeText) : /* @__PURE__ */ new Set();
   const isShippedTag = (tag) => basaltNames.has(tag) || !localNames.has(tag);
-  if (unframedChartRuns && isShippedTag("ChartLegend")) {
-    for (const m of codeText.matchAll(RAW_CHART_LEGEND_ARRAY)) {
-      const lineNo = codeText.slice(0, (m.index ?? 0) + m[0].length).split("\n").length;
-      push("unframed-chart", lineNo, "items={[");
-    }
-  }
   if (ariaLabelRuns) {
     for (const m of codeText.matchAll(CHART_ENTRY_POINT_TAG)) {
       const tagText = m[0];
@@ -1089,7 +1099,7 @@ function checkSource(text, relPath, cfg) {
       });
     }
   }
-  if (ruleApplies("raw-selection-control", relPath) && !OVERLAY_CONVENTION_FILE.test(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/guard/types.d.ts

@@ -1,12 +1,17 @@
 /**
  * Guard types — Mantine-free, dependency-free (zero imports beyond TS types).
  *
- * GuardKind is the closed set of 27 violation kinds the theme guard can emit.
+ * GuardKind is the closed set of 26 violation kinds the theme guard can emit — `unframed-chart`
+ * retired at the C2 consolidation wave: its only case (a hand-authored `<ChartLegend items={[...]}>`
+ * array literal) is fully subsumed by the oxlint plugin's `basalt/chart-legend-literal`, which also
+ * catches the `.map()`-over-a-non-series form the regex never could. `'unframed-chart'` stays a
+ * recognized id in `PLUGIN_RULE_IDS`/`KNOWN_RULE_IDS` so an existing `theme-allow unframed-chart`
+ * reads as a dead waiver, not a typo.
  * Finding is the structured result per violation, replacing the old `Violation` shape.
  * GuardConfig is the per-run configuration that drives checkSource.
  */
-/** The 27 theme-guard violation kinds. */
-export type GuardKind = 'raw-hex' | 'raw-color-fn' | 'localstorage-theme' | 'off-identity-accent' | 'mantine-shade-index' | 'raw-spacing' | 'raw-radius' | 'raw-surface' | 'card-with-border' | 'off-system-surface-var' | 'raw-html-layout' | 'inline-spacing' | 'inline-display' | 'raw-visx-axis' | 'raw-motion-value' | 'unframed-chart' | 'chart-missing-aria-label' | 'raw-form-control' | 'sub-16-input-font' | 'raw-font-family' | 'theme-allow-unscoped' | 'surface-shadow-override' | 'css-raw-surface' | 'inline-font-size' | 'hidden-inline-style' | 'in-body-page-title' | 'raw-selection-control';
+/** The 26 theme-guard violation kinds. */
+export type GuardKind = 'raw-hex' | 'raw-color-fn' | 'localstorage-theme' | 'off-identity-accent' | 'mantine-shade-index' | 'raw-spacing' | 'raw-radius' | 'raw-surface' | 'card-with-border' | 'off-system-surface-var' | 'raw-html-layout' | 'inline-spacing' | 'inline-display' | 'raw-visx-axis' | 'raw-motion-value' | 'chart-missing-aria-label' | 'raw-form-control' | 'sub-16-input-font' | 'raw-font-family' | 'theme-allow-unscoped' | 'surface-shadow-override' | 'css-raw-surface' | 'inline-font-size' | 'hidden-inline-style' | 'in-body-page-title' | 'raw-selection-control';
 /**
  * How hard a finding lands. `error` fails the build; `warn` reports and passes.
  *
@@ -96,13 +101,6 @@ export type GuardConfig = {
     readonly rawVisxAxis: boolean;
     /** Flag a hardcoded duration/spring/ease literal in a `transition={{...}}` prop. Default true. */
     readonly rawMotionValue: boolean;
-    /**
-     * Flag a hand-rolled `<ChartLegend items={[...]}>` array literal — legend entries must be
-     * derived (e.g. `items={deriveLegend(series)}`), never authored inline, so a bespoke chart
-     * can't silently drift from the shared legend. Default `true` (ON). Set `false` to disable the
-     * `unframed-chart` check.
-     */
-    readonly unframedChart: boolean;
     /**
      * Flag a chart-kind JSX usage (`<MultiLine>`, `<Bars>`, `<Donut>`, `<DualPanel>`, `<Heatmap>`,
      * `<ZonedLine>`, `<StackedArea>`, `<LineSparkline>`, `<BarSparkline>`) missing an `ariaLabel`

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guard/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,0BAA0B,GAC1B,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,GACtB,yBAAyB,GACzB,iBAAiB,GACjB,kBAAkB,GAClB,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAAA;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5C;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACjC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,iGAAiG;IACjG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,sGAAsG;IACtG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAA;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;IAC5C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;CAC7D,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guard/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,0BAA0B,GAC1B,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,GACtB,yBAAyB,GACzB,iBAAiB,GACjB,kBAAkB,GAClB,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAAA;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5C;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACjC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,iGAAiG;IACjG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,sGAAsG;IACtG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAA;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;IAC5C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;CAC7D,CAAA"}

package/dist/index.d.ts

@@ -5,31 +5,38 @@
  * `basalt-ui/tokens` and `basalt-ui/charts` subpath exports (see package.json), NOT re-exported
  * here, so a tokens/charts-only consumer never pulls in `@mantine/*`.
  */
-export { BasaltProvider, type BasaltProviderProps, BasaltErrorBoundary, type BasaltErrorContext, } from './provider/index.js';
+export { BasaltProvider, type BasaltProviderProps, BasaltErrorBoundary, type BasaltErrorBoundaryProps, type BasaltErrorContext, } from './provider/index.js';
+export { type BasaltProps, type SlotClassNames, type SlotStylesProps, type Tone, type ToneWithNeutral, type Tier, cx, 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';
+export { ThemeToggle, type ThemeToggleProps } from './theme/theme-toggle.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 { 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 { ActionGroup, type BarAction, type ActionGroupProps, type GlobalAction, } from './controls/actions.js';
+export { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from './common/motion.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, useBreakpoint, type BreakpointName, PageTitle, type PageTitleProps, type PageTitleSlot, 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 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 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 StatCardBreakdownRow, 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 { ConnectivityProvider, ConnectivityIndicator, useConnectivity } from './connectivity/index.js';
-export type { ConnectivityStatus, ConnectivitySnapshot, ConnectivityProviderProps, ConnectivityOverride, } from './connectivity/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, Section, type SectionProps, type SectionSlot, 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 QueryEmptyCopy, LoadingState, type LoadingStateProps, ErrorState, type ErrorStateProps, } from './dashboard/index.js';
+export { ConnectivityProvider } from './provider/connectivity-provider.js';
+export { ConnectivityIndicator } from './provider/connectivity-indicator.js';
+export { useConnectivity } from './provider/use-connectivity.js';
+export type { ConnectivityStatus, ConnectivitySnapshot, ConnectivityProviderProps, ConnectivityOverride, } from './provider/connectivity-types.js';
+export type { ConnectivityIndicatorProps } from './provider/connectivity-indicator.js';
+export { createBasaltQueryClient, unwrap } from './query-client.js';
+export { BasaltQueryDevtools } from './query-devtools.js';
+export { toErrorMessage, errorStatus } from './common/errors.js';
+export { BasaltDevDock, type BasaltDevDockProps, type BasaltDevDockTool } from './dev-dock.js';
 export type { SurfaceSpec, RuleName, SkillName } from './surfaces.js';
 export type { GuardKind } from './guard/types.js';
 export { ThreadWorkspace, ThreadFeed, ThreadFeedRow, ThreadOutcomeCard, ThreadDetailPanel, Composer, threadPartRenderers, ThreadTranscript, ToolChip, } from './agent-chat/index.js';
-export type { ThreadWorkspaceProps, ThreadFeedProps, ThreadFeedRowProps, ThreadOutcomeCardProps, ThreadDetailPanelProps, ComposerProps, ComposerSubmit, ComposerAttachment, ComposerHandle, ThreadTranscriptProps, MessageAffordances, VirtualizeOptions, VirtualizeProps, ToolChipProps, } from './agent-chat/index.js';
+export type { ThreadWorkspaceProps, ThreadFeedProps, ThreadFeedRowProps, ThreadOutcomeCardProps, ThreadDetailPanelProps, ComposerProps, ComposerSubmit, ComposerAttachment, ComposerHandle, ThreadTranscriptProps, MessageAffordances, VirtualizeOptions, VirtualizeProps, RowHeightProps, ToolChipProps, } from './agent-chat/index.js';
 export { createAdapterThreadsStore, createThreadsStore, heuristicOutcome, threadsStoreAdapterContract, useAgentThreadRuns, } from './agent/index.js';
 export type { AdapterThreadsStoreOptions, AgentThread, AgentOutcome, ThreadStatus, ThreadsStore, ThreadsStoreAdapter, ThreadsStoreAdapterContractCase, ThreadsStoreOptions, OutcomeResolver, ChatMessage, AgentPart, AgentTransport, } from './agent/index.js';
 //# sourceMappingURL=index.d.ts.map