@estiva-app/ui 0.13.1 → 0.15.0

package/README.md

@@ -63,6 +63,34 @@ export default {
 }
 ```
 
+### The lint rules — `@estiva-app/ui/eslint`
+
+The UI Guardrails' rules ship with the package, as an ESLint plugin, so an app
+gets a new rule with a version bump. Each rule names the component to use
+instead. Today there is one: `estiva/no-raw-button`.
+
+```js
+// eslint.config.js — alongside your own rules
+import estiva from '@estiva-app/ui/eslint'
+export default [
+  // …your config, with a parser that reads TSX
+  { files: ['src/**/*.tsx'], ignores: ['**/*.test.tsx'], ...estiva.configs.recommended },
+]
+```
+
+A place that keeps a raw element on purpose says why, on the line above:
+
+```tsx
+// @estiva-escape: the reason, at least ten characters
+<button …>
+```
+
+or, as a JSX child, `{/* @estiva-escape: the reason */}`. Not `eslint-disable`:
+it switches the rule off without saying why, and the gate counts it as a
+failure. `countGates(results)` counts errors and escapes for
+`.gates-count.json`; lint with `settings: { estiva: { reportEscapes: true } }`
+for the escapes to be counted.
+
 ## The rules
 
 ### Forking is allowed

package/dist/Avatar.d.ts

@@ -7,7 +7,7 @@ export declare const hueFor: (key: string) => string;
  */
 export declare const initialsFor: (name: string) => string;
 export interface AvatarProps {
-    /** The picture URL, resolved by the caller. A picture that fails to load falls back to the initials. */
+    /** The picture URL, resolved by the caller. Until it arrives, and if it fails, the initials show. */
     src?: string;
     /** The person's name — where the initials and the colour come from. */
     name?: string;

package/dist/Avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../src/Avatar.tsx"],"names":[],"mappings":"AA2BA,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,WAIjC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,WAIvC,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,wGAAwG;IACxG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uGAAuG;IACvG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAQ,EAAE,IAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,WAAW,+BAiD/F"}
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../src/Avatar.tsx"],"names":[],"mappings":"AA+BA,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,WAIjC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,WAIvC,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,qGAAqG;IACrG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uGAAuG;IACvG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAQ,EAAE,IAAS,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,WAAW,+BAiF/F"}

package/dist/AvatarGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarGroup.d.ts","sourceRoot":"","sources":["../src/AvatarGroup.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,IAAS,EAAE,EAAE,gBAAgB,+BAiCnE"}
+{"version":3,"file":"AvatarGroup.d.ts","sourceRoot":"","sources":["../src/AvatarGroup.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,IAAS,EAAE,EAAE,gBAAgB,+BAkCnE"}

package/dist/ChipInput.d.ts

@@ -16,9 +16,22 @@ export interface InputChipProps {
     leading?: ReactNode;
     /** Draws the ✕; absent, the chip is display-only. */
     onRemove?: () => void;
+    /**
+     * The ✕'s name for a screen reader. `Remove <label>` when not given. A chip
+     * whose ✕ does something other than remove it names what it does — a
+     * launcher's scope chip leaves the scope ("Leave Ship").
+     */
+    removeLabel?: string;
+    /**
+     * Cut a long label with an ellipsis once the chip is capped, by a
+     * `max-w-*` on `className`. Off unless asked: cutting clips up to 4px of a
+     * letter's soft edge at 1x even when the label fits (measured 2026-09-15),
+     * so a chip that is never capped keeps every pixel.
+     */
+    truncate?: boolean;
     className?: string;
 }
-export declare function InputChip({ label, leading, onRemove, className }: InputChipProps): import("react").JSX.Element;
+export declare function InputChip({ label, leading, onRemove, removeLabel, truncate, className }: InputChipProps): import("react").JSX.Element;
 /**
  * A multi-select input: chips for the chosen, a typeahead for the rest —
  * Peek's PersonChipInput (2026-09-01), generalised on the way in, and on Base

package/dist/ChipInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChipInput.d.ts","sourceRoot":"","sources":["../src/ChipInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAuB7E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,cAAc,+BAwBhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IACzE,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,qDAAqD;IACrD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAA;IACtC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAA;IACrC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IAC5C;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EACrE,KAAK,EACL,QAAQ,EACR,OAAO,EACP,WAAuB,EACvB,SAAS,EACT,UAAe,EACf,WAAW,EACX,UAAU,EACV,GAAG,IAAI,EACR,EAAE,cAAc,CAAC,CAAC,CAAC,+BAkJnB"}
+{"version":3,"file":"ChipInput.d.ts","sourceRoot":"","sources":["../src/ChipInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAuB7E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,cAAc,+BAyBvG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IACzE,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,qDAAqD;IACrD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAA;IACtC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAA;IACrC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;IAC5C;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EACrE,KAAK,EACL,QAAQ,EACR,OAAO,EACP,WAAuB,EACvB,SAAS,EACT,UAAe,EACf,WAAW,EACX,UAAU,EACV,GAAG,IAAI,EACR,EAAE,cAAc,CAAC,CAAC,CAAC,+BAkJnB"}

package/dist/Divider.d.ts

@@ -1,8 +1,11 @@
 /**
  * Peek's Divider (2026-08-28): a hairline in `border-subtle`, inset 12px each
  * side. Plus what Ship added: `orientation="vertical"` — the same hairline
- * standing up, stretching to its row's height, no inset — and the separator
- * role for assistive tech.
+ * standing up, stretching to its row's height, no inset.
+ *
+ * On Base UI's `Separator` since stage 6 of the migration (2026-09-14). It
+ * writes the `separator` role and `aria-orientation` this component used to
+ * write by hand, and adds `data-orientation`. Nothing it draws changed.
  */
 export interface DividerProps {
     orientation?: 'horizontal' | 'vertical';

package/dist/Divider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Divider.d.ts","sourceRoot":"","sources":["../src/Divider.tsx"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EAAE,WAA0B,EAAE,KAAK,EAAE,IAAgB,EAAE,SAAS,EAAE,EAAE,YAAY,+BA2BvG"}
+{"version":3,"file":"Divider.d.ts","sourceRoot":"","sources":["../src/Divider.tsx"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EAAE,WAA0B,EAAE,KAAK,EAAE,IAAgB,EAAE,SAAS,EAAE,EAAE,YAAY,+BAyBvG"}

package/dist/EmptyState.d.ts

@@ -12,6 +12,9 @@ import type { ReactNode } from 'react';
  * - `section` — one section of a page is empty, and the page has other
  *   things on it: the line alone, left-aligned, no icon. A section's
  *   emptiness is a line among the page's content, not a stage of its own.
+ *   It is the quiet line — caption size in the muted colour, as a Field's
+ *   helper line is — so beside rows it reads as "nothing here", not as one
+ *   more row (Katerina, 2026-09-15: "not that intense", "smaller font").
  *
  * The message is the caller's — a shared component has no words of its own
  * for what is missing.

package/dist/EmptyState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../src/EmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAc,EAAE,SAAS,EAAE,EAAE,eAAe,+BAUvF"}
+{"version":3,"file":"EmptyState.d.ts","sourceRoot":"","sources":["../src/EmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAc,EAAE,SAAS,EAAE,EAAE,eAAe,+BAUvF"}

package/dist/Property.d.ts

@@ -13,6 +13,13 @@ import type { ReactNode } from 'react';
  *   is the `menu` token (9px / 115% / 500), uppercase and letter-spaced —
  *   its own voice, deliberately not SectionLabel's (unmerged, Katerina
  *   2026-09-01). A literal string, not merged, so the token size survives.
+ *
+ * **A name and its value, in the markup made for it** (stage 6 of the
+ * migration, 2026-09-14). Base UI has no part for this, so it is HTML's own:
+ * a `<dl>` holding one `<dt>` (the label) and one `<dd>` (the value), so a
+ * screen reader hears the label as the name of what follows rather than as a
+ * loose word beside it. Each property is a list of one, which needs no
+ * wrapper from the caller.
  */
 export interface PropertyProps {
     label: string;

package/dist/Property.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Property.d.ts","sourceRoot":"","sources":["../src/Property.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,aAAa,+BAkBrF"}
+{"version":3,"file":"Property.d.ts","sourceRoot":"","sources":["../src/Property.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAUD,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,aAAa,+BAkBrF"}

package/dist/Reaction.d.ts

@@ -20,8 +20,10 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react';
  * 1px hairline against no border at all — which is legible and is not the
  * signal Peek's accent fill gives.
  *
- * It is a real `<button>` with `aria-pressed`, so the state reaches assistive
- * tech as a toggle rather than as a colour.
+ * On Base UI's `Toggle` since stage 6 of the migration (2026-09-14): a native
+ * `<button>` with `aria-pressed` and `data-pressed`, so the state reaches
+ * assistive tech as a toggle rather than as a colour. Base UI writes both;
+ * this component used to write the first by hand.
  *
  * ## `aria-label` is required, and the reason is specific
  *
@@ -37,12 +39,16 @@ import type { ButtonHTMLAttributes, ReactNode } from 'react';
  * `small`, the same 8px horizontal padding, the `chip` type token for the
  * count so it sits at 11px/500 like every other count in the system.
  */
-export interface ReactionProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> {
+export interface ReactionProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'type' | 'value'> {
     /** The emoji, drawn decoratively — name the control with `aria-label`. */
     emoji: ReactNode;
-    /** How many people reacted. Drawn as-is; `0` is not a reaction and is not drawn. */
+    /** How many people reacted. Drawn as it is. A count of `0` is not a reaction: do not render one. */
     count: number;
-    /** You are one of them: the accent tint and edge, and `aria-pressed`. */
+    /**
+     * You are one of them: the accent tint and edge, and `aria-pressed`. The
+     * caller owns it — a press calls `onClick` and the pill keeps showing this
+     * value until the caller changes it.
+     */
     pressed?: boolean;
     /**
      * Names the control. **Required** — the emoji is decorative and the count is
@@ -50,5 +56,5 @@ export interface ReactionProps extends Omit<ButtonHTMLAttributes<HTMLButtonEleme
      */
     'aria-label': string;
 }
-export declare function Reaction({ emoji, count, pressed, className, type, ...props }: ReactionProps): import("react").JSX.Element;
+export declare function Reaction({ emoji, count, pressed, className, ...props }: ReactionProps): import("react").JSX.Element;
 //# sourceMappingURL=Reaction.d.ts.map

package/dist/Reaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Reaction.d.ts","sourceRoot":"","sources":["../src/Reaction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAG5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC9F,0EAA0E;IAC1E,KAAK,EAAE,SAAS,CAAA;IAChB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAe,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BAqCnG"}
+{"version":3,"file":"Reaction.d.ts","sourceRoot":"","sources":["../src/Reaction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAI5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACjH,0EAA0E;IAC1E,KAAK,EAAE,SAAS,CAAA;IAChB,oGAAoG;IACpG,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAe,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,+BAuC7F"}

package/dist/TextInput.d.ts

@@ -12,6 +12,15 @@ import { type InputHTMLAttributes } from 'react';
  * context behind it — is gone. Outside a `Field` it behaves as before: the
  * field context has a default, so nothing has to be wrapped.
  */
-export type TextInputProps = InputHTMLAttributes<HTMLInputElement>;
+export interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
+    /**
+     * `small` is 24px tall with 12px text — the small `Select`'s size, so a
+     * field can share a dense row with small selects (D67, 2026-09-13: Peek's
+     * reference widget hand-built one because this was 38px). Replaces the
+     * native `size` attribute, which counts characters and which no caller
+     * used; set a width with the layout instead.
+     */
+    size?: 'default' | 'small';
+}
 export declare const TextInput: import("react").ForwardRefExoticComponent<TextInputProps & import("react").RefAttributes<HTMLInputElement>>;
 //# sourceMappingURL=TextInput.d.ts.map

package/dist/TextInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../src/TextInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAI5D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,CAAA;AAElE,eAAO,MAAM,SAAS,6GAgBpB,CAAA"}
+{"version":3,"file":"TextInput.d.ts","sourceRoot":"","sources":["../src/TextInput.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAI5D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACzF;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,SAAS,6GAmBpB,CAAA"}

package/dist/Toast.d.ts

@@ -8,9 +8,12 @@ import { type ReactNode } from 'react';
  * the same dark overlay pill; the type lives in the icon's colour and glow,
  * not the surface.
  *
- * The provider owns positioning (bottom-left), the portal, and auto-dismiss
- * (5 s; pass `durationMs: 0` to keep one up). One toast at a time — a new
- * one replaces the standing one, it does not queue.
+ * The provider sits on Base UI's `Toast` since stage 6 of the migration
+ * (2026-09-14). Base UI owns the portal, the timers, the stack and what a
+ * screen reader hears; this file owns how a toast looks and where the stack
+ * stands (bottom-left). **Up to three show at once** (D7): the newest nearest
+ * the corner, a fourth hides the oldest until one of the three closes. Before
+ * stage 6 a new toast replaced the standing one, and nothing announced either.
  */
 export type ToastType = 'success' | 'brand' | 'neutral' | 'warning' | 'error';
 export interface ToastProps {
@@ -33,12 +36,20 @@ export interface ToastProps {
     onAction?: () => void;
     className?: string;
 }
+/**
+ * One toast, drawn in place. What the provider shows is this pill; draw it
+ * yourself only where a page needs a toast's look without its timing — a
+ * story, a picture of the set.
+ */
 export declare function Toast({ label, type, leadingIcon, actionLabel, onAction, className }: ToastProps): import("react").JSX.Element;
 export interface ToastOptions {
     label: string;
     /** Which of the five this is — it decides the surface and the leading icon. Defaults to 'neutral'. */
     type?: ToastType;
-    /** When set, renders a clickable action on the right side. */
+    /**
+     * Renders an action on the right side. Pressing it runs `onAction`, if
+     * given, and closes this toast — so a Dismiss needs only its label.
+     */
     actionLabel?: string;
     onAction?: () => void;
     /** Show the leading icon — a check, a `!` or an `×`, per `type`. Defaults to true. */
@@ -47,8 +58,10 @@ export interface ToastOptions {
     durationMs?: number;
 }
 interface ToastValue {
-    showToast: (opts: ToastOptions) => void;
-    dismissToast: () => void;
+    /** Shows a toast and returns its id, for `dismissToast`. */
+    showToast: (opts: ToastOptions) => string;
+    /** Closes the toast with this id; with no id, closes every toast on screen. */
+    dismissToast: (id?: string) => void;
 }
 export declare function ToastProvider({ children }: {
     children: ReactNode;

package/dist/Toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../src/Toast.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAK5G;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA8CD,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,IAAgB,EAAE,WAAkB,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,UAAU,+BAiClH;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,sGAAsG;IACtG,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAMD,UAAU,UAAU;IAClB,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;IACvC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAMD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAiDlE;AAED,wBAAgB,QAAQ,IAAI,UAAU,CAIrC"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../src/Toast.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAK1E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAwED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,KAAK,EAAE,IAAgB,EAAE,WAAkB,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,UAAU,+BAelH;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,sGAAsG;IACtG,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,sFAAsF;IACtF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,UAAU,UAAU;IAClB,4DAA4D;IAC5D,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAA;IACzC,+EAA+E;IAC/E,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAcD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAgClE;AAsCD,wBAAgB,QAAQ,IAAI,UAAU,CAIrC"}

package/dist/Toolbar.d.ts

@@ -83,7 +83,7 @@ export declare function ToolbarButton({ ref, disabled, disabledReason, ...props
  * a `TextInput` dropped in the row.
  */
 export type ToolbarInputProps = TextInputProps;
-export declare function ToolbarInput(props: ToolbarInputProps): import("react").JSX.Element;
+export declare function ToolbarInput({ size, ...props }: ToolbarInputProps): import("react").JSX.Element;
 /**
  * The hairline between two groups of controls. It is `Divider`'s rule and
  * `Toolbar.Separator`'s role, so a screen reader hears the grouping a sighted

package/dist/Toolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../src/Toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAG3C,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAE/D,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,SAAS,CAAA;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,WAA0B,EAAE,SAAgB,EAAE,OAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,YAAY,+BAwBnJ;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAC7B;AAED,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,+BAqB5F;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BAEpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BASrE"}
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../src/Toolbar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAG3C,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAE/D,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,SAAS,CAAA;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,OAAO,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,WAA0B,EAAE,SAAgB,EAAE,OAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,YAAY,+BAwBnJ;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAC7B;AAED,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,+BAqB5F;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,+BAIjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BASrE"}

package/dist/eslint/escape.d.ts

@@ -0,0 +1,61 @@
+import type { AST, Rule } from 'eslint';
+/**
+ * The escape marker (UIG-3, seam S4 in docs/GATES.md §16): one written reason
+ * why one element stays as it is.
+ *
+ * A line comment directly above the element,
+ *
+ *     // @estiva-escape: <reason>
+ *
+ * or, where the element is a JSX child, the JSX comment on the line above,
+ *
+ *     {/* @estiva-escape: <reason> *\/}
+ *
+ * with at least ten characters of reason, spaces not counted.
+ *
+ * Not `eslint-disable`. A directive switches a rule off without saying it was
+ * meant, and the count of escapes (`.gates-count.json`) could not see it. A
+ * marker written inside a directive that switches one of these rules off is
+ * reported for that reason.
+ *
+ * The token lint's older notes (`eslint-disable-next-line <rule> -- @estiva-escape:
+ * <reason>`, Katerina's ruling A2 of 15 September) are not read here: they
+ * escape the token lint's rules, which are not this plugin's, and they stay as
+ * they are (Katerina, 15 September).
+ */
+export declare const ESCAPE_MARKER = "@estiva-escape";
+/** Characters of reason, spaces not counted. */
+export declare const MIN_REASON = 10;
+/** The key under ESLint's `settings` this plugin reads. */
+export declare const SETTINGS_KEY = "estiva";
+/**
+ * Every rule spreads these into its `meta.messages`, because `isEscaped`
+ * reports through the rule that called it.
+ */
+export declare const ESCAPE_MESSAGES: {
+    readonly escapeWithoutReason: "An escape needs its reason, at least 10 characters: `// @estiva-escape: <why this stays>`. An escape with no reason hides nothing.";
+    readonly escapeInDirective: "Write the escape as its own comment on the line above: `// @estiva-escape: <reason>`. Inside an eslint-disable comment it switches the rule off instead of recording why.";
+    readonly escaped: "Escaped: {{reason}}";
+};
+export interface EstivaSettings {
+    /**
+     * Report every sanctioned escape as a message with the id `escaped`, so a
+     * count can read them. Off in the lint anyone runs; on only in the count.
+     */
+    reportEscapes?: boolean;
+}
+interface Located {
+    loc?: AST.SourceLocation | null;
+    range?: [number, number];
+}
+/**
+ * Whether the element at `node` carries a valid escape on the line above.
+ *
+ * Every rule of this plugin calls it before it reports. It reports, through
+ * that rule, a marker with too short a reason and a marker inside an
+ * eslint-disable directive for this rule; either way the element is not
+ * escaped, so the rule reports it too.
+ */
+export declare function isEscaped(context: Rule.RuleContext, node: Located): boolean;
+export {};
+//# sourceMappingURL=escape.d.ts.map

package/dist/eslint/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../src/eslint/escape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,aAAa,mBAAmB,CAAA;AAE7C,gDAAgD;AAChD,eAAO,MAAM,UAAU,KAAK,CAAA;AAE5B,2DAA2D;AAC3D,eAAO,MAAM,YAAY,WAAW,CAAA;AAEpC;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;CAIlB,CAAA;AAEV,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,UAAU,OAAO;IACf,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,GAAG,IAAI,CAAA;IAC/B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACzB;AAaD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAmC3E"}

package/dist/eslint/index.d.ts

@@ -0,0 +1,45 @@
+import type { ESLint, Linter } from 'eslint';
+export { ESCAPE_MARKER, MIN_REASON, SETTINGS_KEY, isEscaped, type EstivaSettings } from './escape';
+/** The name the configs register the plugin under, so every rule id is `estiva/<rule>`. */
+export declare const PLUGIN_KEY = "estiva";
+declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: {
+        'no-raw-button': import("eslint").Rule.RuleModule;
+    };
+    configs: {
+        recommended: Linter.Config;
+        strict: Linter.Config;
+    };
+};
+export default plugin;
+export interface GateRuleCount {
+    errors: number;
+    warnings: number;
+    escapes: number;
+}
+export interface GateCount {
+    /** Per rule id, including rules with nothing to report. */
+    rules: Record<string, GateRuleCount>;
+    /**
+     * Reports of these rules that an `eslint-disable` directive silenced. Not
+     * an escape: a gate fails on any of these (docs/GATES.md §16, S4).
+     */
+    disabled: {
+        filePath: string;
+        line: number;
+        ruleId: string;
+    }[];
+}
+/**
+ * Count what a lint of these rules found, for `.gates-count.json` (seam S3).
+ *
+ * Run the lint with `settings: { estiva: { reportEscapes: true } }` for the
+ * escapes to be counted; without it they are silent and count 0. A marker
+ * with no reason, or inside a directive, counts as an error of its rule.
+ */
+export declare function countGates(results: ESLint.LintResult[]): GateCount;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eslint/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG5C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAA;AAIlG,2FAA2F;AAC3F,eAAO,MAAM,UAAU,WAAW,CAAA;AAMlC,QAAA,MAAM,MAAM;;;;;;;;aAGK;QAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAA;KAAE;CAC7C,CAAA;AAqBzB,eAAe,MAAM,CAAA;AAErB,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC;;;OAGG;IACH,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC/D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,SAAS,CAgBlE"}

package/dist/eslint/index.js

@@ -0,0 +1,118 @@
+// src/eslint/index.ts
+import { createRequire } from "node:module";
+
+// src/eslint/escape.ts
+var ESCAPE_MARKER = "@estiva-escape";
+var MIN_REASON = 10;
+var SETTINGS_KEY = "estiva";
+var ESCAPE_MESSAGES = {
+  escapeWithoutReason: `An escape needs its reason, at least ${MIN_REASON} characters: \`// ${ESCAPE_MARKER}: <why this stays>\`. An escape with no reason hides nothing.`,
+  escapeInDirective: `Write the escape as its own comment on the line above: \`// ${ESCAPE_MARKER}: <reason>\`. Inside an eslint-disable comment it switches the rule off instead of recording why.`,
+  escaped: "Escaped: {{reason}}"
+};
+var DIRECTIVE = /^\s*eslint-disable(?:-next-line|-line)?(?=\s|$)([^]*)$/;
+function directiveRules(rest) {
+  const dashes = rest.search(/(?:^|\s)--(?:\s|$)/);
+  return (dashes === -1 ? rest : rest.slice(0, dashes)).split(/[\s,]+/).filter(Boolean);
+}
+var BETWEEN = /^[\s}]*$/;
+function isEscaped(context, node) {
+  const { sourceCode } = context;
+  if (!node.loc || !node.range) return false;
+  const line = node.loc.start.line;
+  const nodeStart = node.range[0];
+  const comment = sourceCode.getAllComments().find((c) => c.loc && c.range && c.loc.end.line === line - 1 && BETWEEN.test(sourceCode.text.slice(c.range[1], nodeStart)));
+  if (!comment?.loc) return false;
+  const at = comment.value.indexOf(ESCAPE_MARKER);
+  if (at === -1) return false;
+  const directive = DIRECTIVE.exec(comment.value);
+  if (directive) {
+    const rules2 = directiveRules(directive[1]);
+    if (rules2.length > 0 && !rules2.includes(context.id)) return false;
+    context.report({ loc: comment.loc, messageId: "escapeInDirective" });
+    return false;
+  }
+  const reason = comment.value.slice(at + ESCAPE_MARKER.length).replace(/^:/, "").trim();
+  if (reason.replace(/\s/g, "").length < MIN_REASON) {
+    context.report({ loc: comment.loc, messageId: "escapeWithoutReason" });
+    return false;
+  }
+  const settings = context.settings[SETTINGS_KEY];
+  if (settings?.reportEscapes) context.report({ loc: comment.loc, messageId: "escaped", data: { reason } });
+  return true;
+}
+
+// src/eslint/no-raw-button.ts
+var noRawButton = {
+  meta: {
+    type: "problem",
+    docs: { description: "A raw <button> where @estiva-app/ui has one" },
+    schema: [],
+    messages: {
+      raw: "Use `Button` from @estiva-app/ui instead of a raw <button>.",
+      ...ESCAPE_MESSAGES
+    }
+  },
+  create(context) {
+    return {
+      // ESLint's types know ESTree's nodes, not JSX's; the parser hands this one over.
+      JSXOpeningElement(node) {
+        const element = node;
+        if (element.name.type !== "JSXIdentifier" || element.name.name !== "button") return;
+        if (isEscaped(context, element)) return;
+        context.report({ loc: element.loc, messageId: "raw" });
+      }
+    };
+  }
+};
+
+// src/eslint/index.ts
+var { version } = createRequire(import.meta.url)("../../package.json");
+var PLUGIN_KEY = "estiva";
+var rules = {
+  "no-raw-button": noRawButton
+};
+var plugin = {
+  meta: { name: "@estiva-app/ui/eslint", version },
+  rules,
+  configs: {}
+};
+var ruleIds = Object.keys(rules).map((name) => `${PLUGIN_KEY}/${name}`);
+plugin.configs.recommended = {
+  name: "@estiva-app/ui/recommended",
+  plugins: { [PLUGIN_KEY]: plugin },
+  rules: { [`${PLUGIN_KEY}/no-raw-button`]: "error" }
+};
+plugin.configs.strict = {
+  name: "@estiva-app/ui/strict",
+  plugins: { [PLUGIN_KEY]: plugin },
+  rules: Object.fromEntries(ruleIds.map((id) => [id, "error"]))
+};
+var index_default = plugin;
+function countGates(results) {
+  const counts = Object.fromEntries(ruleIds.map((id) => [id, { errors: 0, warnings: 0, escapes: 0 }]));
+  const disabled = [];
+  for (const result of results) {
+    for (const message of result.messages) {
+      const count = message.ruleId ? counts[message.ruleId] : void 0;
+      if (!count) continue;
+      if (message.messageId === "escaped") count.escapes += 1;
+      else if (message.severity === 2) count.errors += 1;
+      else count.warnings += 1;
+    }
+    for (const message of result.suppressedMessages ?? []) {
+      if (message.ruleId && counts[message.ruleId]) disabled.push({ filePath: result.filePath, line: message.line, ruleId: message.ruleId });
+    }
+  }
+  return { rules: counts, disabled };
+}
+export {
+  ESCAPE_MARKER,
+  MIN_REASON,
+  PLUGIN_KEY,
+  SETTINGS_KEY,
+  countGates,
+  index_default as default,
+  isEscaped
+};
+//# sourceMappingURL=index.js.map

package/dist/eslint/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/eslint/index.ts", "../../src/eslint/escape.ts", "../../src/eslint/no-raw-button.ts"],
+  "sourcesContent": ["/// <reference types=\"node\" />\n/**\n * `@estiva-app/ui/eslint` \u2014 the UI Guardrails' lint rules, as a plugin (UIG-3,\n * seam S1 in docs/GATES.md \u00A716).\n *\n * A plugin rather than config, so every app \u2014 Peek, Ship, Leaf \u2014 gets a new\n * rule through an ordinary version bump, and an app's editor hook runs the\n * very rule code its CI runs.\n *\n *     import estiva from '@estiva-app/ui/eslint'\n *     export default [{ files: ['src/**\\/*.tsx'], ...estiva.configs.recommended }]\n *\n * Register it under `estiva` (the configs do): the rule ids are\n * `estiva/<rule>`, and `countGates` counts those ids.\n *\n * Built on its own by build.mjs, for Node, into `dist/eslint/`; nothing here\n * reaches the components' browser bundle.\n */\nimport { createRequire } from 'node:module'\nimport type { ESLint, Linter } from 'eslint'\nimport { noRawButton } from './no-raw-button'\n\nexport { ESCAPE_MARKER, MIN_REASON, SETTINGS_KEY, isEscaped, type EstivaSettings } from './escape'\n\nconst { version } = createRequire(import.meta.url)('../../package.json') as { version: string }\n\n/** The name the configs register the plugin under, so every rule id is `estiva/<rule>`. */\nexport const PLUGIN_KEY = 'estiva'\n\nconst rules = {\n  'no-raw-button': noRawButton,\n}\n\nconst plugin = {\n  meta: { name: '@estiva-app/ui/eslint', version },\n  rules,\n  configs: {} as { recommended: Linter.Config; strict: Linter.Config },\n} satisfies ESLint.Plugin\n\nconst ruleIds = Object.keys(rules).map((name) => `${PLUGIN_KEY}/${name}`)\n\n/**\n * `recommended` switches every rule on at the level it was ruled at: an error\n * blocks, a warning is reported and never blocks. `strict` makes every rule an\n * error. With one rule, an error, the two are the same today; they part when\n * the first warning-level rule arrives (UIG-25).\n */\nplugin.configs.recommended = {\n  name: '@estiva-app/ui/recommended',\n  plugins: { [PLUGIN_KEY]: plugin },\n  rules: { [`${PLUGIN_KEY}/no-raw-button`]: 'error' },\n}\nplugin.configs.strict = {\n  name: '@estiva-app/ui/strict',\n  plugins: { [PLUGIN_KEY]: plugin },\n  rules: Object.fromEntries(ruleIds.map((id) => [id, 'error'])),\n}\n\nexport default plugin\n\nexport interface GateRuleCount {\n  errors: number\n  warnings: number\n  escapes: number\n}\n\nexport interface GateCount {\n  /** Per rule id, including rules with nothing to report. */\n  rules: Record<string, GateRuleCount>\n  /**\n   * Reports of these rules that an `eslint-disable` directive silenced. Not\n   * an escape: a gate fails on any of these (docs/GATES.md \u00A716, S4).\n   */\n  disabled: { filePath: string; line: number; ruleId: string }[]\n}\n\n/**\n * Count what a lint of these rules found, for `.gates-count.json` (seam S3).\n *\n * Run the lint with `settings: { estiva: { reportEscapes: true } }` for the\n * escapes to be counted; without it they are silent and count 0. A marker\n * with no reason, or inside a directive, counts as an error of its rule.\n */\nexport function countGates(results: ESLint.LintResult[]): GateCount {\n  const counts: Record<string, GateRuleCount> = Object.fromEntries(ruleIds.map((id) => [id, { errors: 0, warnings: 0, escapes: 0 }]))\n  const disabled: GateCount['disabled'] = []\n  for (const result of results) {\n    for (const message of result.messages) {\n      const count = message.ruleId ? counts[message.ruleId] : undefined\n      if (!count) continue\n      if (message.messageId === 'escaped') count.escapes += 1\n      else if (message.severity === 2) count.errors += 1\n      else count.warnings += 1\n    }\n    for (const message of result.suppressedMessages ?? []) {\n      if (message.ruleId && counts[message.ruleId]) disabled.push({ filePath: result.filePath, line: message.line, ruleId: message.ruleId })\n    }\n  }\n  return { rules: counts, disabled }\n}\n", "import type { AST, Rule } from 'eslint'\n\n/**\n * The escape marker (UIG-3, seam S4 in docs/GATES.md \u00A716): one written reason\n * why one element stays as it is.\n *\n * A line comment directly above the element,\n *\n *     // @estiva-escape: <reason>\n *\n * or, where the element is a JSX child, the JSX comment on the line above,\n *\n *     {/* @estiva-escape: <reason> *\\/}\n *\n * with at least ten characters of reason, spaces not counted.\n *\n * Not `eslint-disable`. A directive switches a rule off without saying it was\n * meant, and the count of escapes (`.gates-count.json`) could not see it. A\n * marker written inside a directive that switches one of these rules off is\n * reported for that reason.\n *\n * The token lint's older notes (`eslint-disable-next-line <rule> -- @estiva-escape:\n * <reason>`, Katerina's ruling A2 of 15 September) are not read here: they\n * escape the token lint's rules, which are not this plugin's, and they stay as\n * they are (Katerina, 15 September).\n */\nexport const ESCAPE_MARKER = '@estiva-escape'\n\n/** Characters of reason, spaces not counted. */\nexport const MIN_REASON = 10\n\n/** The key under ESLint's `settings` this plugin reads. */\nexport const SETTINGS_KEY = 'estiva'\n\n/**\n * Every rule spreads these into its `meta.messages`, because `isEscaped`\n * reports through the rule that called it.\n */\nexport const ESCAPE_MESSAGES = {\n  escapeWithoutReason: `An escape needs its reason, at least ${MIN_REASON} characters: \\`// ${ESCAPE_MARKER}: <why this stays>\\`. An escape with no reason hides nothing.`,\n  escapeInDirective: `Write the escape as its own comment on the line above: \\`// ${ESCAPE_MARKER}: <reason>\\`. Inside an eslint-disable comment it switches the rule off instead of recording why.`,\n  escaped: 'Escaped: {{reason}}',\n} as const\n\nexport interface EstivaSettings {\n  /**\n   * Report every sanctioned escape as a message with the id `escaped`, so a\n   * count can read them. Off in the lint anyone runs; on only in the count.\n   */\n  reportEscapes?: boolean\n}\n\ninterface Located {\n  loc?: AST.SourceLocation | null\n  range?: [number, number]\n}\n\nconst DIRECTIVE = /^\\s*eslint-disable(?:-next-line|-line)?(?=\\s|$)([^]*)$/\n\n/** The rules a directive names: what comes before its ` -- ` description. None means every rule. */\nfunction directiveRules(rest: string): string[] {\n  const dashes = rest.search(/(?:^|\\s)--(?:\\s|$)/)\n  return (dashes === -1 ? rest : rest.slice(0, dashes)).split(/[\\s,]+/).filter(Boolean)\n}\n\n/** Only spaces and a JSX expression's closing brace between the marker and the element. */\nconst BETWEEN = /^[\\s}]*$/\n\n/**\n * Whether the element at `node` carries a valid escape on the line above.\n *\n * Every rule of this plugin calls it before it reports. It reports, through\n * that rule, a marker with too short a reason and a marker inside an\n * eslint-disable directive for this rule; either way the element is not\n * escaped, so the rule reports it too.\n */\nexport function isEscaped(context: Rule.RuleContext, node: Located): boolean {\n  const { sourceCode } = context\n  if (!node.loc || !node.range) return false\n  const line = node.loc.start.line\n  const nodeStart = node.range[0]\n\n  const comment = sourceCode\n    .getAllComments()\n    .find((c) => c.loc && c.range && c.loc.end.line === line - 1 && BETWEEN.test(sourceCode.text.slice(c.range[1], nodeStart)))\n  if (!comment?.loc) return false\n\n  const at = comment.value.indexOf(ESCAPE_MARKER)\n  if (at === -1) return false\n\n  const directive = DIRECTIVE.exec(comment.value)\n  if (directive) {\n    const rules = directiveRules(directive[1])\n    // A directive for other rules (the token lint's notes) is not an escape of this one.\n    if (rules.length > 0 && !rules.includes(context.id)) return false\n    context.report({ loc: comment.loc, messageId: 'escapeInDirective' })\n    return false\n  }\n\n  const reason = comment.value\n    .slice(at + ESCAPE_MARKER.length)\n    .replace(/^:/, '')\n    .trim()\n  if (reason.replace(/\\s/g, '').length < MIN_REASON) {\n    context.report({ loc: comment.loc, messageId: 'escapeWithoutReason' })\n    return false\n  }\n\n  const settings = context.settings[SETTINGS_KEY] as EstivaSettings | undefined\n  if (settings?.reportEscapes) context.report({ loc: comment.loc, messageId: 'escaped', data: { reason } })\n  return true\n}\n", "import type { Rule } from 'eslint'\nimport { ESCAPE_MESSAGES, isEscaped } from './escape'\n\ninterface JSXOpeningElement {\n  name: { type: string; name?: string }\n  loc: NonNullable<Rule.Node['loc']>\n  range: [number, number]\n}\n\n/**\n * A raw `<button>` in an app (UIG-3, the tracer). The package's `Button`,\n * `IconButton`, `MenuItem` and chips are buttons already; an app that writes\n * its own has a look and a behaviour nobody else keeps in step with.\n *\n * Only the JSX element named `button`. `<Button>`, `<Foo.button>` and\n * `createElement('button')` are not this rule's business.\n */\nexport const noRawButton: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: { description: 'A raw <button> where @estiva-app/ui has one' },\n    schema: [],\n    messages: {\n      raw: 'Use `Button` from @estiva-app/ui instead of a raw <button>.',\n      ...ESCAPE_MESSAGES,\n    },\n  },\n  create(context) {\n    return {\n      // ESLint's types know ESTree's nodes, not JSX's; the parser hands this one over.\n      JSXOpeningElement(node: Rule.Node) {\n        const element = node as unknown as JSXOpeningElement\n        if (element.name.type !== 'JSXIdentifier' || element.name.name !== 'button') return\n        if (isEscaped(context, element)) return\n        context.report({ loc: element.loc, messageId: 'raw' })\n      },\n    }\n  },\n}\n"],
+  "mappings": "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",
+  "names": ["rules"]
+}

package/dist/eslint/no-raw-button.d.ts

@@ -0,0 +1,11 @@
+import type { Rule } from 'eslint';
+/**
+ * A raw `<button>` in an app (UIG-3, the tracer). The package's `Button`,
+ * `IconButton`, `MenuItem` and chips are buttons already; an app that writes
+ * its own has a look and a behaviour nobody else keeps in step with.
+ *
+ * Only the JSX element named `button`. `<Button>`, `<Foo.button>` and
+ * `createElement('button')` are not this rule's business.
+ */
+export declare const noRawButton: Rule.RuleModule;
+//# sourceMappingURL=no-raw-button.d.ts.map

package/dist/eslint/no-raw-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-raw-button.d.ts","sourceRoot":"","sources":["../../src/eslint/no-raw-button.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AASlC;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,IAAI,CAAC,UAqB9B,CAAA"}