basalt-ui 1.26.0 → 1.27.0

package/configs/oxlint-plugin.test.ts

@@ -1731,6 +1731,46 @@ describe('basalt/control-outside-home', () => {
     )
     expect(rules).not.toContain('control-outside-home')
   })
+
+  /**
+   * The CROSS-FILE case, exempted by a naming convention rather than by ancestry — argo carried 9 of
+   * these, each a control in a modal/form module whose `<Modal>` is rendered by the parent route.
+   * Nothing in the flagged file can see the host, so the ancestry walk never could have.
+   */
+  describe('the overlay filename convention', () => {
+    const SOURCE = `${MANTINE_IMPORT}export const C = () => <div><Select data={[]} /></div>\n`
+
+    it.each([
+      'src/edit-session-modal.tsx',
+      'src/filters-drawer.tsx',
+      'src/column-popover.tsx',
+      'src/detail-panel.tsx',
+      'src/booking-form.tsx',
+    ])('does NOT flag %s — its host lives in the parent', (filename) => {
+      const { code, rules } = run(SOURCE, filename)
+      expect(code).toBe(0)
+      expect(rules).not.toContain('control-outside-home')
+    })
+
+    it('still flags a plain page module beside them', () => {
+      const { rules } = run(SOURCE, 'src/bookings-page.tsx')
+      expect(rules).toContain('control-outside-home')
+    })
+
+    // Basename only: a directory of modals holds the page pieces around them too, so a whole
+    // `modal/` tree going silent is the version of this exemption that WOULD switch the rule off.
+    it('is a BASENAME convention, not a directory one', () => {
+      const { rules } = run(SOURCE, 'src/modal/session.tsx')
+      expect(rules).toContain('control-outside-home')
+    })
+
+    // `modal.tsx` with no leading segment is a page module in every consumer that has one; the
+    // convention is `<subject>-modal.tsx`, and the regex says so.
+    it('needs the leading subject — a bare modal.tsx is not the convention', () => {
+      const { rules } = run(SOURCE, 'src/modal.tsx')
+      expect(rules).toContain('control-outside-home')
+    })
+  })
 })
 
 describe('basalt/control-size-literal', () => {
@@ -1761,6 +1801,82 @@ describe('basalt/control-size-literal', () => {
     expect(rules).not.toContain('control-size-literal')
   })
 
+  /**
+   * `ChartCard` is the one slot owner whose slot cannot mount the tier theme — it lives inside the
+   * Mantine-free chart layer, so it writes `data-basalt-tier` by hand and the control there really
+   * does have to state its own size. The rule fires on the `size` ATTRIBUTE and cannot tell a
+   * correct `ctl` from the `xs` it exists to catch, so this is an exemption, not a waiver.
+   */
+  describe('ChartCard.actions — the one slot with no tier theme', () => {
+    it('does NOT flag a size prop there', () => {
+      const { code, rules } = run(
+        `${BASALT_IMPORT}${MANTINE_IMPORT}export const C = () => <ChartCard title="T" actions={<Button size="ctl">Go</Button>} />
+`,
+      )
+      expect(code).toBe(0)
+      expect(rules).not.toContain('control-size-literal')
+    })
+
+    // The owner test reads the IMPORTED name, so the alias every wrapper writes still resolves.
+    it('does NOT flag it under an aliased ChartCard import', () => {
+      const { rules } = run(
+        `import { ChartCard as Card } from 'basalt-ui'
+${MANTINE_IMPORT}` +
+          `export const C = () => <Card title="T" actions={<Button size="xs">Go</Button>} />
+`,
+      )
+      expect(rules).not.toContain('control-size-literal')
+    })
+
+    // The positive control: every OTHER home does mount the theme, so the rule still fires there.
+    it('STILL flags the same prop in a Section slot', () => {
+      const { code, rules } = run(
+        `${BASALT_IMPORT}${MANTINE_IMPORT}export const C = () => <Section title="T" actions={<Button size="xs">Go</Button>} />
+`,
+      )
+      expect(code).toBe(1)
+      expect(rules).toContain('control-size-literal')
+    })
+
+    // The exemption is keyed on the OWNER, and one hoisted binding can be handed to several — so it
+    // holds only when EVERY home it reached is tierless. A last-writer-wins owner map made the
+    // verdict depend on which attribute came later in the file: same code, opposite answer.
+    it('STILL flags a hoisted binding shared with a Section slot — ChartCard last', () => {
+      const { rules } = run(
+        `${BASALT_IMPORT}${MANTINE_IMPORT}const acts = <Button size="xs">Go</Button>\n` +
+          `export const C = () => (\n  <>\n    <Section title="S" actions={acts} />\n    <ChartCard title="T" actions={acts} />\n  </>\n)\n`,
+      )
+      expect(rules).toContain('control-size-literal')
+    })
+
+    it('STILL flags a hoisted binding shared with a Section slot — ChartCard first', () => {
+      const { rules } = run(
+        `${BASALT_IMPORT}${MANTINE_IMPORT}const acts = <Button size="xs">Go</Button>\n` +
+          `export const C = () => (\n  <>\n    <ChartCard title="T" actions={acts} />\n    <Section title="S" actions={acts} />\n  </>\n)\n`,
+      )
+      expect(rules).toContain('control-size-literal')
+    })
+
+    it('does NOT flag a hoisted binding handed only to ChartCard', () => {
+      const { code, rules } = run(
+        `${BASALT_IMPORT}${MANTINE_IMPORT}const acts = <Button size="ctl">Go</Button>\n` +
+          `export const C = () => <ChartCard title="T" actions={acts} />\n`,
+      )
+      expect(code).toBe(0)
+      expect(rules).not.toContain('control-size-literal')
+    })
+
+    // A consumer's OWN `ChartCard` is not basalt's, so it is not a home at all and nothing fires —
+    // the same provenance rule every other home tag follows.
+    it('hand-rolled-filter is NOT exempted there — the tier is not what makes a filter wrong', () => {
+      const { rules } = run(
+        `${BASALT_IMPORT}${MANTINE_IMPORT}export const C = () => <ChartCard title="T" actions={<Select data={[]} />} />
+`,
+      )
+      expect(rules).toContain('hand-rolled-filter')
+    })
+  })
+
   it('does NOT flag a size prop on the HOME itself', () => {
     const { code, rules } = run(
       `${BASALT_IMPORT}${MANTINE_IMPORT}export const C = () => <PageBar w={200} actions={<Button>Go</Button>} />\n`,
@@ -2232,6 +2348,133 @@ describe('basalt/shadow-basalt-export — SHADOW_ALIASES', () => {
   })
 })
 
+/**
+ * The provenance half of the alias table: a file that COMPOSES the export it renames is a wrapper,
+ * not a fork. argo's three hero cards each imported `StatCard`, wrapped it, and each took a warn
+ * telling them to import the thing they were already importing.
+ *
+ * Both directions are asserted, because the exemption is only worth having if the rule still fires
+ * WITHOUT the import — a wrapper is evidence, and silence on every `HeroCard` in the repo would be
+ * the rule switching itself off.
+ */
+describe('basalt/shadow-basalt-export — an alias that composes what it renames', () => {
+  it('fires on a HeroCard that does not import StatCard', () => {
+    const { rules, output } = run(
+      `export function HeroCard() {\n  return null\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(rules).toContain('shadow-basalt-export')
+    expect(output).toContain('StatCard')
+  })
+
+  it('is silent on a HeroCard that composes the imported StatCard', () => {
+    const { code, rules } = run(
+      `import { StatCard } from 'basalt-ui'\n` +
+        `export function HeroCard() {\n  return <StatCard title="x" value="1" />\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(code).toBe(0)
+    expect(rules).not.toContain('shadow-basalt-export')
+  })
+
+  // The provenance test reads the IMPORTED name, not the local one — `StatCard as BaseStatCard` is
+  // the canonical way a wrapper avoids shadowing its own import, and a local-name set would answer
+  // `BaseStatCard` and miss it.
+  it('is silent when the composed export is imported under an alias', () => {
+    const { rules } = run(
+      `import { StatCard as BaseStatCard } from 'basalt-ui'\n` +
+        `export function HeroCard() {\n  return <BaseStatCard title="x" value="1" />\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(rules).not.toContain('shadow-basalt-export')
+  })
+
+  it('is silent from a basalt SUBPATH too, not just the root barrel', () => {
+    const { rules } = run(
+      `import { RangeFilter } from 'basalt-ui/controls'\n` +
+        `export function WindowSelector() {\n  return <RangeFilter field={{}} />\n}\n`,
+      'src/window-selector.tsx',
+    )
+    expect(rules).not.toContain('shadow-basalt-export')
+  })
+
+  // Importing SOMETHING from basalt is not the exemption — importing the thing you renamed is.
+  it('still fires when the file imports a DIFFERENT basalt export', () => {
+    const { rules } = run(
+      `import { Section } from 'basalt-ui'\n` +
+        `export function HeroCard() {\n  return <Section title="x" />\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(rules).toContain('shadow-basalt-export')
+  })
+
+  // The COLLISION half is deliberately not exempted: a local `StatCard` beside an
+  // `import { StatCard as Base }` kept the name AND a piece of the original, which is the fork
+  // shape this rule most wants to see.
+  it('still fires on a name COLLISION even when the export is imported under an alias', () => {
+    const { rules } = run(
+      `import { StatCard as Base } from 'basalt-ui'\n` +
+        `export function StatCard() {\n  return <Base title="x" value="1" />\n}\n`,
+      'src/stat-card.tsx',
+    )
+    expect(rules).toContain('shadow-basalt-export')
+  })
+
+  // COMPOSITION, not import. A type-only import is erased at compile time, so the shape a
+  // props-copying fork actually writes — `ComponentProps<typeof StatCard>` off an
+  // `import type` — composes nothing and used to exempt the whole file.
+  it('still fires on a type-only import of the export it renames', () => {
+    const { rules } = run(
+      `import type { StatCard } from 'basalt-ui'\n` +
+        `export function HeroCard() {\n  return <div />\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(rules).toContain('shadow-basalt-export')
+  })
+
+  it('still fires on an inline `type` specifier', () => {
+    const { rules } = run(
+      `import { type StatCard } from 'basalt-ui'\n` +
+        `export function HeroCard() {\n  return <div />\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(rules).toContain('shadow-basalt-export')
+  })
+
+  // `typeof StatCard` is a `TSTypeQuery` around a plain Identifier, so a VALUE import used only in
+  // a type position has to be rejected too — otherwise the props-copying fork just drops `type`.
+  it('still fires when a value import is only used in a type position', () => {
+    const { rules } = run(
+      `import { StatCard } from 'basalt-ui'\n` +
+        `type P = { card: typeof StatCard }\n` +
+        `export function HeroCard(props: P) {\n  return <div>{String(props)}</div>\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(rules).toContain('shadow-basalt-export')
+  })
+
+  it('still fires on a dead import left behind after the body was re-rolled', () => {
+    const { rules } = run(
+      `import { StatCard } from 'basalt-ui'\n` +
+        `export function HeroCard() {\n  return <div />\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(rules).toContain('shadow-basalt-export')
+  })
+
+  // A JSX tag is not the only way to compose: a wrapper that hands the component on as a prop or to
+  // `createElement` composes it just as much, and a JSX-only test would report both.
+  it('is silent when the import is passed on as a prop rather than rendered', () => {
+    const { code, rules } = run(
+      `import { StatCard } from 'basalt-ui'\n` +
+        `export function HeroCard() {\n  return <Slot component={StatCard} />\n}\n`,
+      'src/hero-card.tsx',
+    )
+    expect(code).toBe(0)
+    expect(rules).not.toContain('shadow-basalt-export')
+  })
+})
+
 // ── SURFACES ↔ the plugin registry ───────────────────────────────────────────
 
 describe('PLUGIN_RULE_ID_LIST ↔ the plugin', () => {

package/configs/oxlint.json

@@ -34,12 +34,12 @@
     "basalt/raw-scroll-container": "error",
     "basalt/hand-rolled-filter": "error",
     "basalt/control-outside-home": "warn",
-    "basalt/control-size-literal": "warn",
+    "basalt/control-size-literal": "error",
     "basalt/page-bar-budget": "error",
-    "basalt/in-body-page-title": "warn",
-    "basalt/responsive-twin": "warn",
-    "basalt/search-literal-link": "warn",
-    "basalt/use-search-from-literal": "warn",
+    "basalt/in-body-page-title": "error",
+    "basalt/responsive-twin": "error",
+    "basalt/search-literal-link": "error",
+    "basalt/use-search-from-literal": "error",
     "basalt/visx-boundary": "error",
     "basalt/visx-tooltip": "error",
     "basalt/agent-resume-guard": "error",

package/dist/controls/enum-filter.d.ts

@@ -12,12 +12,15 @@ export type ChoiceHandle<T extends string> = {
     readonly options: readonly FieldOption[];
     use(): readonly [T, (next: T) => void];
     isDefault(v: T): boolean;
+    /** Removes the value on whichever lane the field is on — what both reset paths call, never a write
+     * of the fallback back over it. See `useFilterRegistration`'s doc for why. */
+    clear(): void;
 };
 export type EnumFilterProps<T extends string> = {
     readonly field: ChoiceHandle<T>;
     readonly label: string;
     readonly icon?: ReactNode;
-    /** Adds a `Clear` action that writes the field back to its fallback. */
+    /** Adds a `Clear` action that clears the field — the same `field.clear()` `Reset all` calls. */
     readonly clearable?: boolean;
     /**
      * Overrides `field.options` at render — a runtime catalogue whose labels carry live data, or the
@@ -25,6 +28,12 @@ export type EnumFilterProps<T extends string> = {
      * into, and `exactOptionalPropertyTypes` rejects a possibly-undefined member on a bare optional.
      */
     readonly options?: readonly FilterOption[] | undefined;
+    /**
+     * Mono pill label — forwarded to `FilterPill.numeric`. Set by `NumberFilter`, whose values ARE
+     * numbers (`1` / `2` / `7`), and by nothing else: the same law `[data-numeric]` applies to a
+     * numeric SegmentedControl label. A word-valued filter never sets it.
+     */
+    readonly numeric?: boolean | undefined;
 };
-export declare function EnumFilter<T extends string>({ field, label, icon, clearable, options: optionsProp, }: EnumFilterProps<T>): ReactNode;
+export declare function EnumFilter<T extends string>({ field, label, icon, clearable, numeric, options: optionsProp, }: EnumFilterProps<T>): ReactNode;
 //# sourceMappingURL=enum-filter.d.ts.map

package/dist/controls/enum-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enum-filter.d.ts","sourceRoot":"","sources":["../../src/controls/enum-filter.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAK3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,GAAG,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAAA;IACtC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,IAAI;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAA;CACvD,CAAA;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,EAC3C,KAAK,EACL,KAAK,EACL,IAAI,EACJ,SAAS,EACT,OAAO,EAAE,WAAW,GACrB,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAwFhC"}
+{"version":3,"file":"enum-filter.d.ts","sourceRoot":"","sources":["../../src/controls/enum-filter.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAK3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,GAAG,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAAA;IACtC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAA;IACxB;kFAC8E;IAC9E,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,IAAI;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,gGAAgG;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAA;IACtD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvC,CAAA;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,EAC3C,KAAK,EACL,KAAK,EACL,IAAI,EACJ,SAAS,EACT,OAAO,EACP,OAAO,EAAE,WAAW,GACrB,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAyFhC"}

package/dist/controls/enum-filter.js

@@ -9,13 +9,14 @@ function EnumFilter({
   label,
   icon,
   clearable,
+  numeric,
   options: optionsProp
 }) {
   const [value, setValue] = field.use();
   const surface = useFilterSurface();
   const isDefault = field.isDefault(value);
   useFilterRegistration(!isDefault, () => {
-    setValue(field.fallback);
+    field.clear();
   });
   const options = optionsProp ?? field.options;
   const selected = options.find((option) => option.value === value);
@@ -67,7 +68,7 @@ function EnumFilter({
               variant: "subtle",
               size: "ctl",
               onClick: () => {
-                setValue(field.fallback);
+                field.clear();
               },
               children: "Clear"
             }
@@ -81,6 +82,7 @@ function EnumFilter({
     {
       label: selected?.label ?? label,
       active: !isDefault,
+      ...numeric === true && { numeric: true },
       ...icon !== void 0 && { icon },
       children: /* @__PURE__ */ jsx("div", { className: classes.optionList, children: body })
     }

package/dist/controls/filter-context.d.ts

@@ -33,9 +33,14 @@ export declare function FilterSetScope({ surface, registry, children }: FilterSe
  * it no-ops outside a registering scope (a bare filter with no `FilterSet`, the fold dropdown, the
  * sheet), which is what keeps it hook-safe in every control.
  *
+ * The reset is `field.clear()`, never `setValue(field.fallback)`: writing the fallback back is a
+ * WRITE, so it persists the default as if the user had chosen it — the URL keeps `?window=7d`, the
+ * localStorage mirror keeps its key, and a later change to the field's fallback no longer reaches
+ * either. `clear()` removes the value instead, on whichever lane the field is on.
+ *
  * @example
- * const [value, setValue] = field.use()
- * useFilterRegistration(!field.isDefault(value), () => setValue(field.fallback))
+ * const [value] = field.use()
+ * useFilterRegistration(!field.isDefault(value), () => field.clear())
  */
 export declare function useFilterRegistration(isActive: boolean, reset: () => void): void;
 export type FilterCensus = {

package/dist/controls/filter-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter-context.d.ts","sourceRoot":"","sources":["../../src/controls/filter-context.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,oGAAoG;AACpG,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAA;AAI5C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC7D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA;AAID,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC7B,CAAA;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,SAAS,CAM9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAkBhF;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAiC9C"}
+{"version":3,"file":"filter-context.d.ts","sourceRoot":"","sources":["../../src/controls/filter-context.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,oGAAoG;AACpG,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAA;AAI5C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAC7D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B,CAAA;AAID,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC7B,CAAA;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,SAAS,CAM9F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,CAkBhF;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,mEAAmE;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAC9B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAiC9C"}

package/dist/controls/index.d.ts

@@ -13,6 +13,7 @@ export { RangeFilter, type RangeCustomPickerProps, type RangeFilterProps } from
 export { CompareFilter, COMPARE_VALUES, type CompareFilterProps, type CompareValue, } from './compare-filter.js';
 export { SelectFilter, type FilterOption, type SelectFilterEnumProps, type SelectFilterProps, type SelectFilterStringProps, } from './select-filter.js';
 export { MultiSelectFilter, type MultiSelectFilterProps } from './multi-select-filter.js';
+export { NumberFilter, type NumberFilterOption, type NumberFilterProps } from './number-filter.js';
 export { SearchFilter, type SearchFilterProps } from './search-filter.js';
 export { ToggleFilter, type ToggleFilterProps } from './toggle-filter.js';
 export { ViewTabs, type ViewTabsOption, type ViewTabsProps } from './view-tabs.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAMtE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAChG,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controls/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAMtE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,KAAK,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAChG,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC/F,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/controls/index.js

@@ -18,6 +18,7 @@ import {
   SelectFilter
 } from "./select-filter.js";
 import { MultiSelectFilter } from "./multi-select-filter.js";
+import { NumberFilter } from "./number-filter.js";
 import { SearchFilter } from "./search-filter.js";
 import { ToggleFilter } from "./toggle-filter.js";
 import { ViewTabs } from "./view-tabs.js";
@@ -31,6 +32,7 @@ export {
   FilterSet,
   MOBILE_GLOBAL_BAR_MAX,
   MultiSelectFilter,
+  NumberFilter,
   OverflowMenu,
   RangeFilter,
   SearchFilter,

package/dist/controls/multi-select-filter.js

@@ -15,7 +15,7 @@ function MultiSelectFilter({
   const surface = useFilterSurface();
   const isDefault = field.isDefault(value);
   useFilterRegistration(!isDefault, () => {
-    setValue(field.fallback);
+    field.clear();
   });
   const options = optionsProp ?? field.options;
   const inSheet = surface === "sheet";
@@ -65,7 +65,7 @@ function MultiSelectFilter({
               variant: "subtle",
               size: "ctl",
               onClick: () => {
-                setValue(field.fallback);
+                field.clear();
               },
               children: "Clear"
             }

package/dist/controls/number-filter.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react';
+import type { FieldHandle, NumberField } from '../state.js';
+/** One row of a numeric preset set. Narrower than `FilterOption` — a preset is never `disabled`:
+ *  the set is declared at the call site, so a row that should not be offered is left out. */
+export type NumberFilterOption = {
+    readonly value: number;
+    readonly label: string;
+};
+export type NumberFilterProps = {
+    readonly field: FieldHandle<NumberField>;
+    /** The popover/sheet heading and the accessible name — never the pill text, which reads the
+     *  VALUE (see `EnumFilter`'s doc for why a pill may only print what is selected). */
+    readonly label: string;
+    readonly icon?: ReactNode;
+    /** Present → the radio-list form. Absent → the stepper form. */
+    readonly options?: readonly NumberFilterOption[];
+    /**
+     * The stepper's increment. Ignored in the `options` form, which has no stepper.
+     *
+     * @default 1 — and for an `int: true` field that is also the only sane grain, so it is what the
+     * field's own declaration produces without this prop.
+     */
+    readonly step?: number;
+};
+export declare function NumberFilter({ field, label, icon, options, step }: NumberFilterProps): ReactNode;
+//# sourceMappingURL=number-filter.d.ts.map

package/dist/controls/number-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-filter.d.ts","sourceRoot":"","sources":["../../src/controls/number-filter.tsx"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAQxD;6FAC6F;AAC7F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;IACxC;yFACqF;IACrF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,iBAAiB,GAAG,SAAS,CAsBhG"}

package/dist/controls/number-filter.js

@@ -0,0 +1,143 @@
+import { jsx } from "react/jsx-runtime";
+import { NumberInput } from "@mantine/core";
+import { useEffect, useRef, useState } from "react";
+import classes from "./controls.module.css";
+import { EnumFilter } from "./enum-filter.js";
+import { useFilterRegistration, useFilterSurface } from "./filter-context.js";
+import { FilterPill } from "./filter-pill.js";
+import { SheetField, useControlName } from "./filter-sheet.js";
+function NumberFilter({ field, label, icon, options, step }) {
+  if (options !== void 0) {
+    return /* @__PURE__ */ jsx(
+      NumberChoice,
+      {
+        field,
+        label,
+        options,
+        ...icon !== void 0 && { icon }
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    NumberStepper,
+    {
+      field,
+      label,
+      ...icon !== void 0 && { icon },
+      ...step !== void 0 && { step }
+    }
+  );
+}
+function NumberChoice({
+  field,
+  label,
+  icon,
+  options
+}) {
+  const [value, setValue] = field.use();
+  const rows = options.map((option) => ({ value: String(option.value), label: option.label }));
+  const choice = {
+    fallback: String(field.fallback),
+    options: rows,
+    use: () => [
+      String(value),
+      (next) => {
+        setValue(Number(next));
+      }
+    ],
+    isDefault: (v) => field.isDefault(Number(v)),
+    clear: () => {
+      field.clear();
+    }
+  };
+  return /* @__PURE__ */ jsx(
+    EnumFilter,
+    {
+      field: choice,
+      label,
+      numeric: true,
+      options: rows,
+      ...icon !== void 0 && { icon }
+    }
+  );
+}
+function NumberStepper({
+  field,
+  label,
+  icon,
+  step
+}) {
+  const [value, setValue] = field.use();
+  const surface = useFilterSurface();
+  const inSheet = surface === "sheet";
+  const isDefault = field.isDefault(value);
+  useFilterRegistration(!isDefault, () => {
+    field.clear();
+  });
+  const { labelId, nameProps } = useControlName(label, inSheet);
+  const draft = useCommittedNumber(value, setValue, { min: field.min, max: field.max });
+  const input = /* @__PURE__ */ jsx(
+    NumberInput,
+    {
+      ...nameProps,
+      size: "ctl",
+      ...field.min !== void 0 && { min: field.min },
+      ...field.max !== void 0 && { max: field.max },
+      ...field.int && { allowDecimal: false },
+      ...step !== void 0 ? { step } : field.int && { step: 1 },
+      value: draft.value,
+      onChange: draft.set,
+      onBlur: draft.commit,
+      onKeyDown: (event) => {
+        if (event.key !== "Enter") return;
+        event.preventDefault();
+        draft.commit();
+      }
+    }
+  );
+  if (inSheet) {
+    return /* @__PURE__ */ jsx(SheetField, { label, labelId, children: input });
+  }
+  return /* @__PURE__ */ jsx(
+    FilterPill,
+    {
+      label: String(value),
+      numeric: true,
+      active: !isDefault,
+      ...icon !== void 0 && { icon },
+      children: /* @__PURE__ */ jsx("div", { className: classes.optionList, children: input })
+    }
+  );
+}
+function useCommittedNumber(value, setValue, bounds) {
+  const [draft, setDraft] = useState(value);
+  const seen = useRef(value);
+  const commitRef = useRef(setValue);
+  commitRef.current = setValue;
+  useEffect(() => {
+    if (seen.current === value) return;
+    seen.current = value;
+    setDraft(value);
+  }, [value]);
+  return {
+    value: draft,
+    set: setDraft,
+    commit: () => {
+      const parsed = typeof draft === "number" ? draft : Number.parseFloat(draft);
+      if (!Number.isFinite(parsed)) {
+        setDraft(value);
+        return;
+      }
+      let next = parsed;
+      if (bounds.min !== void 0 && next < bounds.min) next = bounds.min;
+      if (bounds.max !== void 0 && next > bounds.max) next = bounds.max;
+      setDraft(next);
+      if (next === value) return;
+      seen.current = next;
+      commitRef.current(next);
+    }
+  };
+}
+export {
+  NumberFilter
+};

package/dist/controls/range-filter.d.ts

@@ -15,15 +15,29 @@ export type RangeCustomPickerProps = {
         to: string;
     }) => void;
 };
-export type RangeFilterProps<P extends string> = {
-    readonly field: FieldHandle<RangeField<P>>;
+/** Everything about the props that does not depend on the field's `custom` flag. */
+type RangeFilterBase<P extends string, C extends boolean> = {
+    /**
+     * A range handle from either store factory. Generic over the field's `custom` flag so a
+     * `field.range({ ... })` WITHOUT `custom` (whose handle is `RangeField<P, false>`, and whose
+     * values therefore never include `'custom'`) binds with no cast — pinning `C` to its default
+     * `boolean` here made the setter contravariantly incompatible and forced one at every call site.
+     */
+    readonly field: FieldHandle<RangeField<P, C>>;
     /** Leading pill icon. Defaults to a calendar glyph — a range filter reads as a date control, so
      *  the glyph is part of the control's identity, not a per-call-site decision. */
     readonly icon?: ReactNode;
-    /** Rendered when the field declares `custom: true`. Omitted → presets only. */
-    readonly customPicker?: ComponentType<RangeCustomPickerProps>;
     /** Sheet-form heading. The pill's own label is the VALUE, which is what a bar reads. @default 'Range' */
     readonly label?: string;
 };
-export declare function RangeFilter<P extends string>({ field, icon, customPicker, label, }: RangeFilterProps<P>): ReactNode;
+export type RangeFilterProps<P extends string, C extends boolean = boolean> = RangeFilterBase<P, C> & {
+    /**
+     * Rendered when the field declares `custom: true`. Omitted → presets only, which stays LEGAL
+     * (a range that only ever shows presets is a real configuration) but warns once in dev when the
+     * field allows a custom window: the affordance is then unreachable, and nothing else says so.
+     */
+    readonly customPicker?: ComponentType<RangeCustomPickerProps>;
+};
+export declare function RangeFilter<P extends string, C extends boolean = boolean>(props: RangeFilterProps<P, C>): ReactNode;
+export {};
 //# sourceMappingURL=range-filter.d.ts.map

package/dist/controls/range-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"range-filter.d.ts","sourceRoot":"","sources":["../../src/controls/range-filter.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAc,MAAM,UAAU,CAAA;AAYnE;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACxF,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CAChE,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI;IAC/C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1C;qFACiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;IAC7D,yGAAyG;IACzG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,EAC5C,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,KAAe,GAChB,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,CA8FjC"}
+{"version":3,"file":"range-filter.d.ts","sourceRoot":"","sources":["../../src/controls/range-filter.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAc,MAAM,UAAU,CAAA;AAwCnE;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;IACxF,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CAChE,CAAA;AAED,oFAAoF;AACpF,KAAK,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,IAAI;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7C;qFACiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,yGAAyG;IACzG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,eAAe,CAC3F,CAAC,EACD,CAAC,CACF,GAAG;IACF;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAA;CAC9D,CAAA;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,GAAG,OAAO,EACvE,KAAK,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,SAAS,CAyGX"}