@estiva-app/ui 0.14.0 → 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/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/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"}

package/dist/index.js

@@ -604,7 +604,7 @@ function Avatar({ src, name, alt = "", size = 36, label: spoken, className }) {
             render: /* @__PURE__ */ jsx10("div", {}),
             className: "w-full h-full flex items-center justify-center font-semibold leading-none",
             style: {
-              /* eslint-disable no-restricted-syntax -- the per-person palette (the note at
+              /* eslint-disable no-restricted-syntax -- @estiva-escape: the per-person palette (the note at
                  the top): eight hues picked from the name, the one ink that reads on all
                  of them, and a size that follows `size`. None of it can be a token. */
               // The one ink colour that reads on all eight hues, which are a
@@ -1043,10 +1043,10 @@ var CHIP_BOX = (
 var CHIP_LABEL = "text-caption font-medium text-text-primary";
 var CHIP_REMOVE = "size-4 flex items-center justify-center rounded-full hover:bg-bg-hover text-text-secondary";
 var chipPadding = (leading, removable) => cn(leading ? "pl-[2px]" : "pl-2", removable ? "pr-1" : "pr-2");
-function InputChip({ label, leading, onRemove, className }) {
+function InputChip({ label, leading, onRemove, removeLabel, truncate, className }) {
   return /* @__PURE__ */ jsxs11("div", { className: cn(CHIP_BOX, chipPadding(!!leading, !!onRemove), className), children: [
     leading && /* @__PURE__ */ jsx18("span", { className: "flex shrink-0 items-center", children: leading }),
-    /* @__PURE__ */ jsx18("span", { className: CHIP_LABEL, children: label }),
+    /* @__PURE__ */ jsx18("span", { className: cn(CHIP_LABEL, truncate && "min-w-0 truncate"), children: label }),
     onRemove && /* @__PURE__ */ jsx18(
       BaseButton4,
       {
@@ -1055,8 +1055,8 @@ function InputChip({ label, leading, onRemove, className }) {
           e.stopPropagation();
           onRemove();
         },
-        className: CHIP_REMOVE,
-        "aria-label": `Remove ${label}`,
+        className: cn(CHIP_REMOVE, truncate && "shrink-0"),
+        "aria-label": removeLabel ?? `Remove ${label}`,
         children: /* @__PURE__ */ jsx18(IconX3, { size: 10, stroke: 1.5 })
       }
     )