@eifi1/ui-kit 0.51.7 → 0.53.0

package/dist/demo/demo-countdown.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/demo/demo-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useEffectEvent, useSyncExternalStore } from \"react\";\n\n/**\n * The demo's countdown (docs/landing-demo-harmonization.md §5.3, §5.4): the time left to\n * the demo account's end, from `expires_at` (the `TokenResponse`) or `demo_expires_at`\n * (`/auth/me`). The client never decodes the JWT.\n */\n\n/** When the demo ends: an ISO timestamp from the server, epoch milliseconds, or a\n *  `Date`. */\nexport type DemoExpiry = string | number | Date;\n\n/** The last stretch, in minutes, in which the banner turns to the warning tone (§5.4). */\nexport const DEMO_WARNING_MINUTES = 10;\n/** Below this many minutes the countdown shows minutes only (§5.4). */\nexport const DEMO_MINUTES_ONLY = 60;\n\nconst MINUTE = 60_000;\n\nexport interface DemoCountdown {\n  /**\n   * Whole minutes left, ROUNDED UP — 30 s left is \"1 min\", and 0 only once the demo has\n   * ended. `null` when `expiresAt` cannot be read: the countdown then shows no time and\n   * never ends by itself (a parse slip must not throw a visitor out).\n   */\n  minutesLeft: number | null;\n  /** The display split: whole hours, and the minutes past them. In the last hour\n   *  (`lastHour`) `hours` is 0 and `minutes` is `minutesLeft`. */\n  hours: number;\n  minutes: number;\n  /** `minutesLeft <= 60`: show minutes only. */\n  lastHour: boolean;\n  /** `minutesLeft <= 10`: the warning tone. */\n  warning: boolean;\n  /** The demo's time is up. */\n  ended: boolean;\n}\n\n/** `expiresAt` as epoch milliseconds, or NaN. */\nfunction expiryMs(expiresAt: DemoExpiry | null | undefined): number {\n  if (expiresAt === null || expiresAt === undefined) return Number.NaN;\n  if (typeof expiresAt === \"number\") return expiresAt;\n  if (expiresAt instanceof Date) return expiresAt.getTime();\n  return Date.parse(expiresAt);\n}\n\n/** Whole minutes left at `now`, rounded up, never below 0; null for an unreadable end. */\nfunction minutesAt(expiry: number, now: number): number | null {\n  if (!Number.isFinite(expiry)) return null;\n  return Math.max(0, Math.ceil((expiry - now) / MINUTE));\n}\n\n/**\n * The countdown at `now` — pure, for a test or a server-rendered value. See\n * {@link DemoCountdown} for the rounding and the thresholds.\n */\nexport function demoCountdown(expiresAt: DemoExpiry | null | undefined, now: number): DemoCountdown {\n  return countdownOf(minutesAt(expiryMs(expiresAt), now));\n}\n\nfunction countdownOf(minutesLeft: number | null): DemoCountdown {\n  if (minutesLeft === null) {\n    return { minutesLeft, hours: 0, minutes: 0, lastHour: false, warning: false, ended: false };\n  }\n  const lastHour = minutesLeft <= DEMO_MINUTES_ONLY;\n  return {\n    minutesLeft,\n    hours: lastHour ? 0 : Math.floor(minutesLeft / 60),\n    minutes: lastHour ? minutesLeft : minutesLeft % 60,\n    lastHour,\n    warning: minutesLeft <= DEMO_WARNING_MINUTES,\n    ended: minutesLeft === 0,\n  };\n}\n\nexport interface DemoCountdownOptions {\n  /**\n   * The clock, in epoch milliseconds. Default `Date.now`. A test passes its own (or uses\n   * fake timers, which move `Date.now` too). Keep it a stable function — a new one each\n   * render re-arms the timer each render.\n   */\n  now?: () => number;\n  /** Called once when the countdown reaches zero — also on mount, if it already has.\n   *  The app clears the session and replaces to `/demo/ended` (§5.5). */\n  onEnded?: () => void;\n}\n\n/**\n * The time left to `expiresAt`, re-rendering when the shown minute changes — one timer\n * to the next minute boundary, not a tick a second — and once more when the tab comes\n * back from the background (a hidden tab's timers are throttled).\n *\n * `onEnded` fires at zero (§5.5). The countdown is the client's, from `expires_at`; the\n * server's answer to a request after the end (a 401) ends the demo as well — the app's\n * 401 handler, not this hook.\n */\nexport function useDemoCountdown(\n  expiresAt: DemoExpiry | null | undefined,\n  { now = Date.now, onEnded }: DemoCountdownOptions = {},\n): DemoCountdown {\n  const expiry = expiryMs(expiresAt);\n  const subscribe = useCallback(\n    (notify: () => void) => {\n      if (!Number.isFinite(expiry)) return () => {};\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const arm = () => {\n        const left = expiry - now();\n        if (left <= 0) return;\n        // The rounded-up minute changes when `left` crosses the next whole minute below.\n        const delay = left - (Math.ceil(left / MINUTE) - 1) * MINUTE;\n        timer = setTimeout(() => {\n          notify();\n          arm();\n        }, delay);\n      };\n      const onVisible = () => {\n        if (document.visibilityState !== \"visible\") return;\n        clearTimeout(timer);\n        notify();\n        arm();\n      };\n      arm();\n      document.addEventListener(\"visibilitychange\", onVisible);\n      return () => {\n        clearTimeout(timer);\n        document.removeEventListener(\"visibilitychange\", onVisible);\n      };\n    },\n    [expiry, now],\n  );\n  const snapshot = () => minutesAt(expiry, now());\n  const minutesLeft = useSyncExternalStore(subscribe, snapshot, snapshot);\n  const countdown = countdownOf(minutesLeft);\n\n  const fireEnded = useEffectEvent(() => onEnded?.());\n  useEffect(() => {\n    if (countdown.ended) fireEnded();\n  }, [countdown.ended]);\n\n  return countdown;\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,gBAAgB,4BAA4B;AAatE,MAAM,uBAAuB;AAE7B,MAAM,oBAAoB;AAEjC,MAAM,SAAS;AAsBf,SAAS,SAAS,WAAkD;AAClE,MAAI,cAAc,QAAQ,cAAc,OAAW,QAAO,OAAO;AACjE,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,MAAI,qBAAqB,KAAM,QAAO,UAAU,QAAQ;AACxD,SAAO,KAAK,MAAM,SAAS;AAC7B;AAGA,SAAS,UAAU,QAAgB,KAA4B;AAC7D,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO;AACrC,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,SAAS,OAAO,MAAM,CAAC;AACvD;AAMO,SAAS,cAAc,WAA0C,KAA4B;AAClG,SAAO,YAAY,UAAU,SAAS,SAAS,GAAG,GAAG,CAAC;AACxD;AAEA,SAAS,YAAY,aAA2C;AAC9D,MAAI,gBAAgB,MAAM;AACxB,WAAO,EAAE,aAAa,OAAO,GAAG,SAAS,GAAG,UAAU,OAAO,SAAS,OAAO,OAAO,MAAM;AAAA,EAC5F;AACA,QAAM,WAAW,eAAe;AAChC,SAAO;AAAA,IACL;AAAA,IACA,OAAO,WAAW,IAAI,KAAK,MAAM,cAAc,EAAE;AAAA,IACjD,SAAS,WAAW,cAAc,cAAc;AAAA,IAChD;AAAA,IACA,SAAS,eAAe;AAAA,IACxB,OAAO,gBAAgB;AAAA,EACzB;AACF;AAuBO,SAAS,iBACd,WACA,EAAE,MAAM,KAAK,KAAK,QAAQ,IAA0B,CAAC,GACtC;AACf,QAAM,SAAS,SAAS,SAAS;AACjC,QAAM,YAAY;AAAA,IAChB,CAAC,WAAuB;AACtB,UAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO,MAAM;AAAA,MAAC;AAC5C,UAAI;AACJ,YAAM,MAAM,MAAM;AAChB,cAAM,OAAO,SAAS,IAAI;AAC1B,YAAI,QAAQ,EAAG;AAEf,cAAM,QAAQ,QAAQ,KAAK,KAAK,OAAO,MAAM,IAAI,KAAK;AACtD,gBAAQ,WAAW,MAAM;AACvB,iBAAO;AACP,cAAI;AAAA,QACN,GAAG,KAAK;AAAA,MACV;AACA,YAAM,YAAY,MAAM;AACtB,YAAI,SAAS,oBAAoB,UAAW;AAC5C,qBAAa,KAAK;AAClB,eAAO;AACP,YAAI;AAAA,MACN;AACA,UAAI;AACJ,eAAS,iBAAiB,oBAAoB,SAAS;AACvD,aAAO,MAAM;AACX,qBAAa,KAAK;AAClB,iBAAS,oBAAoB,oBAAoB,SAAS;AAAA,MAC5D;AAAA,IACF;AAAA,IACA,CAAC,QAAQ,GAAG;AAAA,EACd;AACA,QAAM,WAAW,MAAM,UAAU,QAAQ,IAAI,CAAC;AAC9C,QAAM,cAAc,qBAAqB,WAAW,UAAU,QAAQ;AACtE,QAAM,YAAY,YAAY,WAAW;AAEzC,QAAM,YAAY,eAAe,MAAM,UAAU,CAAC;AAClD,YAAU,MAAM;AACd,QAAI,UAAU,MAAO,WAAU;AAAA,EACjC,GAAG,CAAC,UAAU,KAAK,CAAC;AAEpB,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/demo/demo-countdown.ts"],"sourcesContent":["import { useCallback, useEffect, useEffectEvent, useSyncExternalStore } from \"react\";\n\n/**\n * The demo's countdown (docs/landing-demo-harmonization.md §5.3, §5.4): the time left to\n * the demo account's end, from `expires_at` (the `TokenResponse`) or `demo_expires_at`\n * (`/auth/me`). The client never decodes the JWT.\n */\n\n/** When the demo ends: an ISO timestamp from the server, epoch milliseconds, or a\n *  `Date`. */\nexport type DemoExpiry = string | number | Date;\n\n/** The last stretch, in minutes, in which the banner turns to the warning tone (§5.4). */\nexport const DEMO_WARNING_MINUTES = 10;\n/** Below this many minutes the countdown shows minutes only (§5.4). */\nexport const DEMO_MINUTES_ONLY = 60;\n\nconst MINUTE = 60_000;\n\nexport interface DemoCountdown {\n  /**\n   * Whole minutes left, ROUNDED UP — 30 s left is \"1 min\", and 0 only once the demo has\n   * ended. `null` when `expiresAt` cannot be read: the countdown then shows no time and\n   * never ends by itself (a parse slip must not throw a visitor out).\n   */\n  minutesLeft: number | null;\n  /** The display split: whole hours, and the minutes past them. In the last hour\n   *  (`lastHour`) `hours` is 0 and `minutes` is `minutesLeft`. */\n  hours: number;\n  minutes: number;\n  /** `minutesLeft <= 60`: show minutes only. */\n  lastHour: boolean;\n  /** `minutesLeft <= 10`: the warning tone. */\n  warning: boolean;\n  /** The demo's time is up. */\n  ended: boolean;\n}\n\n/** `expiresAt` as epoch milliseconds, or NaN. */\nfunction expiryMs(expiresAt: DemoExpiry | null | undefined): number {\n  if (expiresAt === null || expiresAt === undefined) return Number.NaN;\n  if (typeof expiresAt === \"number\") return expiresAt;\n  if (expiresAt instanceof Date) return expiresAt.getTime();\n  return Date.parse(expiresAt);\n}\n\n/** Whole minutes left at `now`, rounded up, never below 0; null for an unreadable end. */\nfunction minutesAt(expiry: number, now: number): number | null {\n  if (!Number.isFinite(expiry)) return null;\n  return Math.max(0, Math.ceil((expiry - now) / MINUTE));\n}\n\n/** The countdown for `minutesLeft` — see {@link DemoCountdown} for the rounding and the\n *  thresholds. (Public as `demoCountdown(expiresAt, now)` until 0.53, deprecated in 0.52,\n *  API-4: `useDemoCountdown` with its `now` option is the same countdown.) */\nfunction countdownOf(minutesLeft: number | null): DemoCountdown {\n  if (minutesLeft === null) {\n    return { minutesLeft, hours: 0, minutes: 0, lastHour: false, warning: false, ended: false };\n  }\n  const lastHour = minutesLeft <= DEMO_MINUTES_ONLY;\n  return {\n    minutesLeft,\n    hours: lastHour ? 0 : Math.floor(minutesLeft / 60),\n    minutes: lastHour ? minutesLeft : minutesLeft % 60,\n    lastHour,\n    warning: minutesLeft <= DEMO_WARNING_MINUTES,\n    ended: minutesLeft === 0,\n  };\n}\n\nexport interface DemoCountdownOptions {\n  /**\n   * The clock, in epoch milliseconds. Default `Date.now`. A test passes its own (or uses\n   * fake timers, which move `Date.now` too). Keep it a stable function — a new one each\n   * render re-arms the timer each render.\n   */\n  now?: () => number;\n  /** Called once when the countdown reaches zero — also on mount, if it already has.\n   *  The app clears the session and replaces to `/demo/ended` (§5.5). */\n  onEnded?: () => void;\n}\n\n/**\n * The time left to `expiresAt`, re-rendering when the shown minute changes — one timer\n * to the next minute boundary, not a tick a second — and once more when the tab comes\n * back from the background (a hidden tab's timers are throttled).\n *\n * `onEnded` fires at zero (§5.5). The countdown is the client's, from `expires_at`; the\n * server's answer to a request after the end (a 401) ends the demo as well — the app's\n * 401 handler, not this hook.\n */\nexport function useDemoCountdown(\n  expiresAt: DemoExpiry | null | undefined,\n  { now = Date.now, onEnded }: DemoCountdownOptions = {},\n): DemoCountdown {\n  const expiry = expiryMs(expiresAt);\n  const subscribe = useCallback(\n    (notify: () => void) => {\n      if (!Number.isFinite(expiry)) return () => {};\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      const arm = () => {\n        const left = expiry - now();\n        if (left <= 0) return;\n        // The rounded-up minute changes when `left` crosses the next whole minute below.\n        const delay = left - (Math.ceil(left / MINUTE) - 1) * MINUTE;\n        timer = setTimeout(() => {\n          notify();\n          arm();\n        }, delay);\n      };\n      const onVisible = () => {\n        if (document.visibilityState !== \"visible\") return;\n        clearTimeout(timer);\n        notify();\n        arm();\n      };\n      arm();\n      document.addEventListener(\"visibilitychange\", onVisible);\n      return () => {\n        clearTimeout(timer);\n        document.removeEventListener(\"visibilitychange\", onVisible);\n      };\n    },\n    [expiry, now],\n  );\n  const snapshot = () => minutesAt(expiry, now());\n  const minutesLeft = useSyncExternalStore(subscribe, snapshot, snapshot);\n  const countdown = countdownOf(minutesLeft);\n\n  const fireEnded = useEffectEvent(() => onEnded?.());\n  useEffect(() => {\n    if (countdown.ended) fireEnded();\n  }, [countdown.ended]);\n\n  return countdown;\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,gBAAgB,4BAA4B;AAatE,MAAM,uBAAuB;AAE7B,MAAM,oBAAoB;AAEjC,MAAM,SAAS;AAsBf,SAAS,SAAS,WAAkD;AAClE,MAAI,cAAc,QAAQ,cAAc,OAAW,QAAO,OAAO;AACjE,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,MAAI,qBAAqB,KAAM,QAAO,UAAU,QAAQ;AACxD,SAAO,KAAK,MAAM,SAAS;AAC7B;AAGA,SAAS,UAAU,QAAgB,KAA4B;AAC7D,MAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO;AACrC,SAAO,KAAK,IAAI,GAAG,KAAK,MAAM,SAAS,OAAO,MAAM,CAAC;AACvD;AAKA,SAAS,YAAY,aAA2C;AAC9D,MAAI,gBAAgB,MAAM;AACxB,WAAO,EAAE,aAAa,OAAO,GAAG,SAAS,GAAG,UAAU,OAAO,SAAS,OAAO,OAAO,MAAM;AAAA,EAC5F;AACA,QAAM,WAAW,eAAe;AAChC,SAAO;AAAA,IACL;AAAA,IACA,OAAO,WAAW,IAAI,KAAK,MAAM,cAAc,EAAE;AAAA,IACjD,SAAS,WAAW,cAAc,cAAc;AAAA,IAChD;AAAA,IACA,SAAS,eAAe;AAAA,IACxB,OAAO,gBAAgB;AAAA,EACzB;AACF;AAuBO,SAAS,iBACd,WACA,EAAE,MAAM,KAAK,KAAK,QAAQ,IAA0B,CAAC,GACtC;AACf,QAAM,SAAS,SAAS,SAAS;AACjC,QAAM,YAAY;AAAA,IAChB,CAAC,WAAuB;AACtB,UAAI,CAAC,OAAO,SAAS,MAAM,EAAG,QAAO,MAAM;AAAA,MAAC;AAC5C,UAAI;AACJ,YAAM,MAAM,MAAM;AAChB,cAAM,OAAO,SAAS,IAAI;AAC1B,YAAI,QAAQ,EAAG;AAEf,cAAM,QAAQ,QAAQ,KAAK,KAAK,OAAO,MAAM,IAAI,KAAK;AACtD,gBAAQ,WAAW,MAAM;AACvB,iBAAO;AACP,cAAI;AAAA,QACN,GAAG,KAAK;AAAA,MACV;AACA,YAAM,YAAY,MAAM;AACtB,YAAI,SAAS,oBAAoB,UAAW;AAC5C,qBAAa,KAAK;AAClB,eAAO;AACP,YAAI;AAAA,MACN;AACA,UAAI;AACJ,eAAS,iBAAiB,oBAAoB,SAAS;AACvD,aAAO,MAAM;AACX,qBAAa,KAAK;AAClB,iBAAS,oBAAoB,oBAAoB,SAAS;AAAA,MAC5D;AAAA,IACF;AAAA,IACA,CAAC,QAAQ,GAAG;AAAA,EACd;AACA,QAAM,WAAW,MAAM,UAAU,QAAQ,IAAI,CAAC;AAC9C,QAAM,cAAc,qBAAqB,WAAW,UAAU,QAAQ;AACtE,QAAM,YAAY,YAAY,WAAW;AAEzC,QAAM,YAAY,eAAe,MAAM,UAAU,CAAC;AAClD,YAAU,MAAM;AACd,QAAI,UAAU,MAAO,WAAU;AAAA,EACjC,GAAG,CAAC,UAAU,KAAK,CAAC;AAEpB,SAAO;AACT;","names":[]}

package/dist/eslint/index.js

@@ -47,7 +47,7 @@ const roleUtilities = {
     };
   }
 };
-const VERSION = true ? "0.51.7" : "0.0.0-source";
+const VERSION = true ? "0.53.0" : "0.0.0-source";
 const recommended = {
   name: "@eifi1/ui-kit/recommended",
   // Not the tests, as check:tokens skips the kit's: a test names the old class to assert it

package/dist/eslint/role-utilities.d.ts

@@ -43,19 +43,47 @@ export interface ThemeInlineDeclaration {
 }
 /** The `@theme inline` block: where it stands, and every declaration in it in block order. */
 export interface ThemeInlineBlock {
-    /** Its first and one-past-last offset in `stripCssComments(css)`, not in `css`. */
+    /** Its first and one-past-last offset in `stripCssComments(css)`, not in `css`. With
+     *  several `@theme inline` blocks, the first one's; `ranges` holds each. */
     start: number;
     end: number;
+    ranges: {
+        start: number;
+        end: number;
+    }[];
+    /** Every block's, in stylesheet order. */
     declarations: ThemeInlineDeclaration[];
 }
 /** `css` without its comments: a declaration commented out is not one. */
 export declare function stripCssComments(css: string): string;
+/** One `@theme … { … }` block: its first and one-past-last offset, and what its braces hold. */
+export interface ThemeBlock {
+    start: number;
+    end: number;
+    body: string;
+}
+/**
+ * Every `@theme` block of `css` (comments already stripped) whose prelude names `inline`
+ * (`@theme inline`, `@theme inline reference`) — or, with `inline: false`, every other
+ * one (`@theme {`, Tailwind's `@theme default {`). Counted brace by brace, so a nested
+ * block does not end it early.
+ *
+ * The one block finder (refactor audit 2026-10-30, DUP-13): this parser read only the
+ * first `@theme inline {…}` up to its first `}`, the testing guard's
+ * `declaredCustomProperties` every inline block brace-aware, and the README's inventory a
+ * plain `@theme {` by a regex of its own — three readers that disagreed on what one block
+ * is. It lives here because this module imports nothing, so the scripts load it from
+ * source under Node.
+ */
+export declare function themeBlocks(css: string, { inline }: {
+    inline: boolean;
+}): ThemeBlock[];
 /**
- * tokens.css's `@theme inline` block, read once for every reader: the table below, and
- * the README's (scripts/gen-styling-inventory.mjs), which fails on a `property: null`
- * where the table leaves it out. `null` when there is no such block — the role utilities
- * are gone, or this parser is. Theme blocks hold only declarations, so the first `}`
- * closes it; no namespace is another's prefix, so the first that fits is the one.
+ * tokens.css's `@theme inline` block (every one, should there be several), read once for
+ * every reader: the table below, and the README's (scripts/gen-styling-inventory.mjs),
+ * which fails on a `property: null` where the table leaves it out. `null` when there is
+ * no such block — the role utilities are gone, or this parser is. No namespace is
+ * another's prefix, so the first that fits is the one.
  */
 export declare function parseThemeInline(css: string): ThemeInlineBlock | null;
 /**
@@ -73,7 +101,8 @@ export interface RoleClassHit {
     utilities: string[];
 }
 /**
- * Every `[var(--token)]` class in `text` whose token has a role utility on that property.
+ * Every `[var(--token)]` class in `text` (or one of v4's spellings of it, above) whose
+ * token has a role utility on that property.
  * A token with no utility there (`text-[var(--chart-1)]`, `--status-*`,
  * `bg-[var(--border)]` as a divider's fill) is not a hit: `[var(--…)]` is right for it.
  */

package/dist/eslint/role-utilities.js

@@ -14,11 +14,28 @@ const ROLE_NAMESPACES = {
 function stripCssComments(css) {
   return css.replace(/\/\*[\s\S]*?\*\//g, "");
 }
+function themeBlocks(css, { inline }) {
+  const blocks = [];
+  for (const m of css.matchAll(/@theme\b([^{;]*)\{/g)) {
+    if (/\binline\b/.test(m[1]) !== inline) continue;
+    const open = m.index + m[0].length - 1;
+    let depth = 0;
+    let close = open;
+    for (; close < css.length; close++) {
+      if (css[close] === "{") depth++;
+      else if (css[close] === "}" && --depth === 0) break;
+    }
+    blocks.push({ start: m.index, end: close + 1, body: css.slice(open + 1, close) });
+  }
+  return blocks;
+}
 const PROPERTIES = Object.keys(ROLE_NAMESPACES);
 function parseThemeInline(css) {
-  const block = /@theme\s+inline\s*\{([^}]*)\}/.exec(stripCssComments(css));
-  if (!block) return null;
-  const declarations = [...block[1].matchAll(/--([a-z0-9-]+)\s*:\s*([^;]+);/g)].map(([, variable, raw]) => {
+  const blocks = themeBlocks(stripCssComments(css), { inline: true });
+  if (blocks.length === 0) return null;
+  const declarations = [
+    ...blocks.map((b) => b.body).join("\n").matchAll(/--([a-z0-9-]+)\s*:\s*([^;]+);/g)
+  ].map(([, variable, raw]) => {
     const value = raw.trim();
     const property = PROPERTIES.find((p) => variable.startsWith(`${ROLE_NAMESPACES[p]}-`)) ?? null;
     const name = property && variable.slice(ROLE_NAMESPACES[property].length + 1);
@@ -31,7 +48,8 @@ function parseThemeInline(css) {
       value
     };
   });
-  return { start: block.index, end: block.index + block[0].length, declarations };
+  const ranges = blocks.map(({ start, end }) => ({ start, end }));
+  return { start: ranges[0].start, end: ranges[0].end, ranges, declarations };
 }
 function roleUtilitiesFromCss(css) {
   const block = parseThemeInline(css);
@@ -42,13 +60,27 @@ function roleUtilitiesFromCss(css) {
   }
   return table;
 }
-const ROLE_CLASS = /(?<=^|[\s"'`:])(text|bg|border(?:-[xytrblse])?|divide|ring-offset|ring|outline|fill|stroke)-\[(length:)?var\((--[a-zA-Z0-9-]+)\)\]/g;
+const TOKEN = "(--[a-zA-Z0-9-]+)";
+const ROLE_CLASS = new RegExp(
+  `(?<=^|[\\s"'\`:])(?:(text|bg|border(?:-[xytrblse])?|divide|ring-offset|ring|outline|fill|stroke)-(?:\\[(?:(length|color):)?var\\(${TOKEN}\\)\\]|\\((?:(length|color):)?${TOKEN}\\))|\\[(color|background-color|border-color|outline-color|fill|stroke):var\\(${TOKEN}\\)\\])`,
+  "g"
+);
+const ARBITRARY_PROPERTY = {
+  color: "text",
+  "background-color": "bg",
+  "border-color": "border",
+  "outline-color": "outline",
+  fill: "fill",
+  stroke: "stroke"
+};
 function findRoleClasses(text, table) {
-  if (!text.includes("var(--")) return [];
+  if (!text.includes("--")) return [];
   const hits = [];
   for (const m of text.matchAll(ROLE_CLASS)) {
-    const [found, prop, length, token] = m;
-    const key = length ? `${prop}-width` : prop.startsWith("border-") || prop === "divide" ? "border" : prop;
+    const [found, utility, bracketHint, bracketToken, parenHint, parenToken, cssProperty, propertyToken] = m;
+    const prop = utility ?? ARBITRARY_PROPERTY[cssProperty];
+    const token = bracketToken ?? parenToken ?? propertyToken;
+    const key = (bracketHint ?? parenHint) === "length" ? `${prop}-width` : prop.startsWith("border-") || prop === "divide" ? "border" : prop;
     const names = table[key]?.[token];
     if (names?.length) hits.push({ index: m.index, found, utilities: names.map((name) => `${prop}-${name}`) });
   }
@@ -59,6 +91,7 @@ export {
   findRoleClasses,
   parseThemeInline,
   roleUtilitiesFromCss,
-  stripCssComments
+  stripCssComments,
+  themeBlocks
 };
 //# sourceMappingURL=role-utilities.js.map

package/dist/eslint/role-utilities.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/eslint/role-utilities.ts"],"sourcesContent":["// Which `[var(--token)]` classes have a role utility, and what it is called — the one\n// definition `@eifi1/ui-kit/eslint`'s `role-utilities` rule and `npm run check:tokens`\n// (scripts/check-token-discipline.mjs) both read (round 0.35 R5, Kurvenschmiede's Q6).\n//\n// The table itself is role-utilities.generated.ts, re-rendered from tokens.css's\n// `@theme inline` block by scripts/gen-role-utilities.mjs with the parser below; the\n// check fails while it is stale. So tokens.css stays the source: a role that gains a\n// utility there is flagged in the kit and in the apps from the next release on. The\n// README's role-utility table (scripts/gen-styling-inventory.mjs) reads the block with\n// the same parser since 0.37, so the README, the check and the plugin cannot disagree.\n//\n// This module imports NOTHING, and its TypeScript is erasable only (no enum, no\n// namespace, no parameter property): the check imports it from source under Node's type\n// stripping, before any build, and the plugin ships it to an app's ESLint, which is\n// plain Node with no React and no stylesheet.\n\n/**\n * The properties a role utility exists for, each with the Tailwind theme namespace it is\n * declared in. `ring-width` and `outline-width` are a width typed `length:` —\n * `ring-[length:var(--focus-ring-width)]` is `ring-focus`. `divide-*` and the side borders\n * (`border-t-*`, `border-x-*` …) read `border`'s, as Tailwind does.\n */\nexport const ROLE_NAMESPACES = {\n  text: \"text-color\",\n  bg: \"background-color\",\n  border: \"border-color\",\n  ring: \"ring-color\",\n  \"ring-offset\": \"ring-offset-color\",\n  outline: \"outline-color\",\n  fill: \"fill\",\n  stroke: \"stroke\",\n  \"ring-width\": \"ring-width\",\n  \"outline-width\": \"outline-width\",\n} as const;\n\nexport type RoleProperty = keyof typeof ROLE_NAMESPACES;\n\n/**\n * Per property, each token that has a role utility → the utility's name after the\n * property's prefix: `border: { \"--border\": [\"subtle\"] }` is `border-subtle`. A list,\n * because nothing stops two names from reading one token; one name is a fix, several a\n * choice.\n */\nexport type RoleUtilityTable = {\n  readonly [P in RoleProperty]: Readonly<Record<string, readonly string[]>>;\n};\n\n/** One `--<namespace>-<name>: <value>;` of the `@theme inline` block. */\nexport interface ThemeInlineDeclaration {\n  /** The theme variable without its dashes: `text-color-muted`, `ring-width-focus`. */\n  variable: string;\n  /** The property whose namespace it is in; `null` for a namespace ROLE_NAMESPACES lacks. */\n  property: RoleProperty | null;\n  /** The name after the namespace, `muted`; `null` with `property`. */\n  name: string | null;\n  /** The utility it makes: `text-muted`, `ring-focus` (a width is `ring-*` like a colour). */\n  utility: string | null;\n  /** The token the value reads, `--text-muted`; `null` unless the value is a bare `var()`. */\n  token: string | null;\n  /** The value as written, trimmed. */\n  value: string;\n}\n\n/** The `@theme inline` block: where it stands, and every declaration in it in block order. */\nexport interface ThemeInlineBlock {\n  /** Its first and one-past-last offset in `stripCssComments(css)`, not in `css`. */\n  start: number;\n  end: number;\n  declarations: ThemeInlineDeclaration[];\n}\n\n/** `css` without its comments: a declaration commented out is not one. */\nexport function stripCssComments(css: string): string {\n  return css.replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\");\n}\n\nconst PROPERTIES = Object.keys(ROLE_NAMESPACES) as RoleProperty[];\n\n/**\n * tokens.css's `@theme inline` block, read once for every reader: the table below, and\n * the README's (scripts/gen-styling-inventory.mjs), which fails on a `property: null`\n * where the table leaves it out. `null` when there is no such block — the role utilities\n * are gone, or this parser is. Theme blocks hold only declarations, so the first `}`\n * closes it; no namespace is another's prefix, so the first that fits is the one.\n */\nexport function parseThemeInline(css: string): ThemeInlineBlock | null {\n  const block = /@theme\\s+inline\\s*\\{([^}]*)\\}/.exec(stripCssComments(css));\n  if (!block) return null;\n  const declarations = [...block[1].matchAll(/--([a-z0-9-]+)\\s*:\\s*([^;]+);/g)].map(([, variable, raw]) => {\n    const value = raw.trim();\n    const property = PROPERTIES.find((p) => variable.startsWith(`${ROLE_NAMESPACES[p]}-`)) ?? null;\n    const name = property && variable.slice(ROLE_NAMESPACES[property].length + 1);\n    return {\n      variable,\n      property,\n      name,\n      utility: property && `${property.replace(/-width$/, \"\")}-${name}`,\n      token: /^var\\((--[a-z0-9-]+)\\)$/.exec(value)?.[1] ?? null,\n      value,\n    };\n  });\n  return { start: block.index, end: block.index + block[0].length, declarations };\n}\n\n/**\n * The table `tokens.css` declares: every `--<namespace>-<name>: var(--<token>)` in its\n * `@theme inline` block, in block order, each property present (in ROLE_NAMESPACES' order)\n * even when it has none. `null` when there is no such block.\n */\nexport function roleUtilitiesFromCss(css: string): RoleUtilityTable | null {\n  const block = parseThemeInline(css);\n  if (!block) return null;\n  const table = Object.fromEntries(PROPERTIES.map((p) => [p, {}])) as Record<RoleProperty, Record<string, string[]>>;\n  for (const { property, name, token } of block.declarations) {\n    if (property && name && token) (table[property][token] ??= []).push(name);\n  }\n  return table;\n}\n\n/**\n * `text-[var(--text-muted)]`, `hover:bg-[var(--bg-hover)]`, `border-t-[var(--border)]`,\n * `focus-visible:ring-[var(--brand)]/40`, `ring-offset-[var(--bg-surface)]`,\n * `ring-[length:var(--focus-ring-width)]`. Preceded by a start, a space, a quote or a\n * variant's colon, which the match does not include — nor the variants before it or an\n * opacity or `!` after it — so replacing the match keeps all of them.\n */\nconst ROLE_CLASS =\n  /(?<=^|[\\s\"'`:])(text|bg|border(?:-[xytrblse])?|divide|ring-offset|ring|outline|fill|stroke)-\\[(length:)?var\\((--[a-zA-Z0-9-]+)\\)\\]/g;\n\nexport interface RoleClassHit {\n  /** Where the class starts in the scanned text, after its variants. */\n  index: number;\n  /** The class as written, without variants or opacity: `border-t-[var(--border)]`. */\n  found: string;\n  /** The role utilities that paint the same: `[\"border-t-subtle\"]`. */\n  utilities: string[];\n}\n\n/**\n * Every `[var(--token)]` class in `text` whose token has a role utility on that property.\n * A token with no utility there (`text-[var(--chart-1)]`, `--status-*`,\n * `bg-[var(--border)]` as a divider's fill) is not a hit: `[var(--…)]` is right for it.\n */\nexport function findRoleClasses(text: string, table: RoleUtilityTable): RoleClassHit[] {\n  if (!text.includes(\"var(--\")) return [];\n  const hits: RoleClassHit[] = [];\n  for (const m of text.matchAll(ROLE_CLASS)) {\n    const [found, prop, length, token] = m;\n    // `border-t` and `divide` read `border`'s names; a `length:` hint reads the widths.\n    const key = length ? `${prop}-width` : prop.startsWith(\"border-\") || prop === \"divide\" ? \"border\" : prop;\n    const names = (table as Partial<Record<string, Readonly<Record<string, readonly string[]>>>>)[key]?.[token];\n    if (names?.length) hits.push({ index: m.index, found, utilities: names.map((name) => `${prop}-${name}`) });\n  }\n  return hits;\n}\n"],"mappings":";AAsBO,MAAM,kBAAkB;AAAA,EAC7B,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,eAAe;AAAA,EACf,SAAS;AAAA,EACT,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,iBAAiB;AACnB;AAuCO,SAAS,iBAAiB,KAAqB;AACpD,SAAO,IAAI,QAAQ,qBAAqB,EAAE;AAC5C;AAEA,MAAM,aAAa,OAAO,KAAK,eAAe;AASvC,SAAS,iBAAiB,KAAsC;AACrE,QAAM,QAAQ,gCAAgC,KAAK,iBAAiB,GAAG,CAAC;AACxE,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,eAAe,CAAC,GAAG,MAAM,CAAC,EAAE,SAAS,gCAAgC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM;AACvG,UAAM,QAAQ,IAAI,KAAK;AACvB,UAAM,WAAW,WAAW,KAAK,CAAC,MAAM,SAAS,WAAW,GAAG,gBAAgB,CAAC,CAAC,GAAG,CAAC,KAAK;AAC1F,UAAM,OAAO,YAAY,SAAS,MAAM,gBAAgB,QAAQ,EAAE,SAAS,CAAC;AAC5E,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS,YAAY,GAAG,SAAS,QAAQ,WAAW,EAAE,CAAC,IAAI,IAAI;AAAA,MAC/D,OAAO,0BAA0B,KAAK,KAAK,IAAI,CAAC,KAAK;AAAA,MACrD;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO,EAAE,OAAO,MAAM,OAAO,KAAK,MAAM,QAAQ,MAAM,CAAC,EAAE,QAAQ,aAAa;AAChF;AAOO,SAAS,qBAAqB,KAAsC;AACzE,QAAM,QAAQ,iBAAiB,GAAG;AAClC,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,QAAQ,OAAO,YAAY,WAAW,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/D,aAAW,EAAE,UAAU,MAAM,MAAM,KAAK,MAAM,cAAc;AAC1D,QAAI,YAAY,QAAQ,MAAO,EAAC,MAAM,QAAQ,EAAE,KAAK,MAAM,CAAC,GAAG,KAAK,IAAI;AAAA,EAC1E;AACA,SAAO;AACT;AASA,MAAM,aACJ;AAgBK,SAAS,gBAAgB,MAAc,OAAyC;AACrF,MAAI,CAAC,KAAK,SAAS,QAAQ,EAAG,QAAO,CAAC;AACtC,QAAM,OAAuB,CAAC;AAC9B,aAAW,KAAK,KAAK,SAAS,UAAU,GAAG;AACzC,UAAM,CAAC,OAAO,MAAM,QAAQ,KAAK,IAAI;AAErC,UAAM,MAAM,SAAS,GAAG,IAAI,WAAW,KAAK,WAAW,SAAS,KAAK,SAAS,WAAW,WAAW;AACpG,UAAM,QAAS,MAA+E,GAAG,IAAI,KAAK;AAC1G,QAAI,OAAO,OAAQ,MAAK,KAAK,EAAE,OAAO,EAAE,OAAO,OAAO,WAAW,MAAM,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;AAAA,EAC3G;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/eslint/role-utilities.ts"],"sourcesContent":["// Which `[var(--token)]` classes have a role utility, and what it is called — the one\n// definition `@eifi1/ui-kit/eslint`'s `role-utilities` rule and `npm run check:tokens`\n// (scripts/check-token-discipline.mjs) both read (round 0.35 R5, Kurvenschmiede's Q6).\n//\n// The table itself is role-utilities.generated.ts, re-rendered from tokens.css's\n// `@theme inline` block by scripts/gen-role-utilities.mjs with the parser below; the\n// check fails while it is stale. So tokens.css stays the source: a role that gains a\n// utility there is flagged in the kit and in the apps from the next release on. The\n// README's role-utility table (scripts/gen-styling-inventory.mjs) reads the block with\n// the same parser since 0.37, so the README, the check and the plugin cannot disagree.\n//\n// This module imports NOTHING, and its TypeScript is erasable only (no enum, no\n// namespace, no parameter property): the check imports it from source under Node's type\n// stripping, before any build, and the plugin ships it to an app's ESLint, which is\n// plain Node with no React and no stylesheet.\n\n/**\n * The properties a role utility exists for, each with the Tailwind theme namespace it is\n * declared in. `ring-width` and `outline-width` are a width typed `length:` —\n * `ring-[length:var(--focus-ring-width)]` is `ring-focus`. `divide-*` and the side borders\n * (`border-t-*`, `border-x-*` …) read `border`'s, as Tailwind does.\n */\nexport const ROLE_NAMESPACES = {\n  text: \"text-color\",\n  bg: \"background-color\",\n  border: \"border-color\",\n  ring: \"ring-color\",\n  \"ring-offset\": \"ring-offset-color\",\n  outline: \"outline-color\",\n  fill: \"fill\",\n  stroke: \"stroke\",\n  \"ring-width\": \"ring-width\",\n  \"outline-width\": \"outline-width\",\n} as const;\n\nexport type RoleProperty = keyof typeof ROLE_NAMESPACES;\n\n/**\n * Per property, each token that has a role utility → the utility's name after the\n * property's prefix: `border: { \"--border\": [\"subtle\"] }` is `border-subtle`. A list,\n * because nothing stops two names from reading one token; one name is a fix, several a\n * choice.\n */\nexport type RoleUtilityTable = {\n  readonly [P in RoleProperty]: Readonly<Record<string, readonly string[]>>;\n};\n\n/** One `--<namespace>-<name>: <value>;` of the `@theme inline` block. */\nexport interface ThemeInlineDeclaration {\n  /** The theme variable without its dashes: `text-color-muted`, `ring-width-focus`. */\n  variable: string;\n  /** The property whose namespace it is in; `null` for a namespace ROLE_NAMESPACES lacks. */\n  property: RoleProperty | null;\n  /** The name after the namespace, `muted`; `null` with `property`. */\n  name: string | null;\n  /** The utility it makes: `text-muted`, `ring-focus` (a width is `ring-*` like a colour). */\n  utility: string | null;\n  /** The token the value reads, `--text-muted`; `null` unless the value is a bare `var()`. */\n  token: string | null;\n  /** The value as written, trimmed. */\n  value: string;\n}\n\n/** The `@theme inline` block: where it stands, and every declaration in it in block order. */\nexport interface ThemeInlineBlock {\n  /** Its first and one-past-last offset in `stripCssComments(css)`, not in `css`. With\n   *  several `@theme inline` blocks, the first one's; `ranges` holds each. */\n  start: number;\n  end: number;\n  ranges: { start: number; end: number }[];\n  /** Every block's, in stylesheet order. */\n  declarations: ThemeInlineDeclaration[];\n}\n\n/** `css` without its comments: a declaration commented out is not one. */\nexport function stripCssComments(css: string): string {\n  return css.replace(/\\/\\*[\\s\\S]*?\\*\\//g, \"\");\n}\n\n/** One `@theme … { … }` block: its first and one-past-last offset, and what its braces hold. */\nexport interface ThemeBlock {\n  start: number;\n  end: number;\n  body: string;\n}\n\n/**\n * Every `@theme` block of `css` (comments already stripped) whose prelude names `inline`\n * (`@theme inline`, `@theme inline reference`) — or, with `inline: false`, every other\n * one (`@theme {`, Tailwind's `@theme default {`). Counted brace by brace, so a nested\n * block does not end it early.\n *\n * The one block finder (refactor audit 2026-10-30, DUP-13): this parser read only the\n * first `@theme inline {…}` up to its first `}`, the testing guard's\n * `declaredCustomProperties` every inline block brace-aware, and the README's inventory a\n * plain `@theme {` by a regex of its own — three readers that disagreed on what one block\n * is. It lives here because this module imports nothing, so the scripts load it from\n * source under Node.\n */\nexport function themeBlocks(css: string, { inline }: { inline: boolean }): ThemeBlock[] {\n  const blocks: ThemeBlock[] = [];\n  for (const m of css.matchAll(/@theme\\b([^{;]*)\\{/g)) {\n    if (/\\binline\\b/.test(m[1]) !== inline) continue;\n    const open = m.index + m[0].length - 1;\n    let depth = 0;\n    let close = open;\n    for (; close < css.length; close++) {\n      if (css[close] === \"{\") depth++;\n      else if (css[close] === \"}\" && --depth === 0) break;\n    }\n    blocks.push({ start: m.index, end: close + 1, body: css.slice(open + 1, close) });\n  }\n  return blocks;\n}\n\nconst PROPERTIES = Object.keys(ROLE_NAMESPACES) as RoleProperty[];\n\n/**\n * tokens.css's `@theme inline` block (every one, should there be several), read once for\n * every reader: the table below, and the README's (scripts/gen-styling-inventory.mjs),\n * which fails on a `property: null` where the table leaves it out. `null` when there is\n * no such block — the role utilities are gone, or this parser is. No namespace is\n * another's prefix, so the first that fits is the one.\n */\nexport function parseThemeInline(css: string): ThemeInlineBlock | null {\n  const blocks = themeBlocks(stripCssComments(css), { inline: true });\n  if (blocks.length === 0) return null;\n  const declarations = [\n    ...blocks\n      .map((b) => b.body)\n      .join(\"\\n\")\n      .matchAll(/--([a-z0-9-]+)\\s*:\\s*([^;]+);/g),\n  ].map(([, variable, raw]) => {\n    const value = raw.trim();\n    const property = PROPERTIES.find((p) => variable.startsWith(`${ROLE_NAMESPACES[p]}-`)) ?? null;\n    const name = property && variable.slice(ROLE_NAMESPACES[property].length + 1);\n    return {\n      variable,\n      property,\n      name,\n      utility: property && `${property.replace(/-width$/, \"\")}-${name}`,\n      token: /^var\\((--[a-z0-9-]+)\\)$/.exec(value)?.[1] ?? null,\n      value,\n    };\n  });\n  const ranges = blocks.map(({ start, end }) => ({ start, end }));\n  return { start: ranges[0].start, end: ranges[0].end, ranges, declarations };\n}\n\n/**\n * The table `tokens.css` declares: every `--<namespace>-<name>: var(--<token>)` in its\n * `@theme inline` block, in block order, each property present (in ROLE_NAMESPACES' order)\n * even when it has none. `null` when there is no such block.\n */\nexport function roleUtilitiesFromCss(css: string): RoleUtilityTable | null {\n  const block = parseThemeInline(css);\n  if (!block) return null;\n  const table = Object.fromEntries(PROPERTIES.map((p) => [p, {}])) as Record<RoleProperty, Record<string, string[]>>;\n  for (const { property, name, token } of block.declarations) {\n    if (property && name && token) (table[property][token] ??= []).push(name);\n  }\n  return table;\n}\n\n/**\n * `text-[var(--text-muted)]`, `hover:bg-[var(--bg-hover)]`, `border-t-[var(--border)]`,\n * `focus-visible:ring-[var(--brand)]/40`, `ring-offset-[var(--bg-surface)]`,\n * `ring-[length:var(--focus-ring-width)]` — and, since 0.52, Tailwind v4's own spellings\n * of the same: the shorthand `text-(--text-muted)`, a type hint `text-[color:var(--x)]` /\n * `text-(color:--x)` / `ring-(length:--x)`, and the arbitrary property\n * `[color:var(--text-muted)]`, which is `text-muted` (refactor audit 2026-10-30, DOC-1:\n * all of them passed the check and every app's lint). Preceded by a start, a space, a\n * quote or a variant's colon, which the match does not include — nor the variants before\n * it or an opacity or `!` after it — so replacing the match keeps all of them.\n *\n * Groups: 1 the property; then 2 the hint and 3 the token of `-[…var()]`, or 4 and 5 of\n * `-(…)`; or 6 the CSS property and 7 the token of `[property:var()]`.\n */\nconst TOKEN = \"(--[a-zA-Z0-9-]+)\";\nconst ROLE_CLASS = new RegExp(\n  \"(?<=^|[\\\\s\\\"'`:])(?:\" +\n    \"(text|bg|border(?:-[xytrblse])?|divide|ring-offset|ring|outline|fill|stroke)-\" +\n    `(?:\\\\[(?:(length|color):)?var\\\\(${TOKEN}\\\\)\\\\]|\\\\((?:(length|color):)?${TOKEN}\\\\))` +\n    `|\\\\[(color|background-color|border-color|outline-color|fill|stroke):var\\\\(${TOKEN}\\\\)\\\\]` +\n    \")\",\n  \"g\",\n);\n\n/** The utility prefix an arbitrary property `[property:var(--x)]` is written as. */\nconst ARBITRARY_PROPERTY: Record<string, string> = {\n  color: \"text\",\n  \"background-color\": \"bg\",\n  \"border-color\": \"border\",\n  \"outline-color\": \"outline\",\n  fill: \"fill\",\n  stroke: \"stroke\",\n};\n\nexport interface RoleClassHit {\n  /** Where the class starts in the scanned text, after its variants. */\n  index: number;\n  /** The class as written, without variants or opacity: `border-t-[var(--border)]`. */\n  found: string;\n  /** The role utilities that paint the same: `[\"border-t-subtle\"]`. */\n  utilities: string[];\n}\n\n/**\n * Every `[var(--token)]` class in `text` (or one of v4's spellings of it, above) whose\n * token has a role utility on that property.\n * A token with no utility there (`text-[var(--chart-1)]`, `--status-*`,\n * `bg-[var(--border)]` as a divider's fill) is not a hit: `[var(--…)]` is right for it.\n */\nexport function findRoleClasses(text: string, table: RoleUtilityTable): RoleClassHit[] {\n  // Every form names a token: `var(--x)`, or `(--x)` in v4's shorthand.\n  if (!text.includes(\"--\")) return [];\n  const hits: RoleClassHit[] = [];\n  for (const m of text.matchAll(ROLE_CLASS)) {\n    const [found, utility, bracketHint, bracketToken, parenHint, parenToken, cssProperty, propertyToken] = m;\n    const prop = utility ?? ARBITRARY_PROPERTY[cssProperty];\n    const token = bracketToken ?? parenToken ?? propertyToken;\n    // `border-t` and `divide` read `border`'s names; a `length:` hint reads the widths.\n    const key =\n      (bracketHint ?? parenHint) === \"length\"\n        ? `${prop}-width`\n        : prop.startsWith(\"border-\") || prop === \"divide\"\n          ? \"border\"\n          : prop;\n    const names = (table as Partial<Record<string, Readonly<Record<string, readonly string[]>>>>)[key]?.[token];\n    if (names?.length) hits.push({ index: m.index, found, utilities: names.map((name) => `${prop}-${name}`) });\n  }\n  return hits;\n}\n"],"mappings":"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","names":[]}

package/dist/feedback/feedback-dialog.d.ts

@@ -3,8 +3,10 @@ import type { ButtonSize, ButtonVariant } from "../components/button-look.js";
 import { type LabelOverride } from "../i18n/kit-labels.js";
 import { type FeedbackAttachmentError, type FeedbackAttachmentErrorInfo } from "./feedback-attachment.js";
 import { DEFAULT_FEEDBACK_DIALOG_LABELS } from "./feedback-dialog-labels.js";
-export interface FeedbackCategoryOption {
-    value: string;
+/** One category the dialog offers. `C` (0.52): the app's category type — the kit's
+ *  `FeedbackCategory`, or `string` (the default) for a vocabulary of the app's own. */
+export interface FeedbackCategoryOption<C extends string = string> {
+    value: C;
     label: string;
 }
 export interface FeedbackAttachmentLabels {
@@ -80,10 +82,10 @@ export interface FeedbackDialogTextLabels {
     publicNotice?: string;
 }
 export { DEFAULT_FEEDBACK_DIALOG_LABELS };
-export interface FeedbackSubmission {
+export interface FeedbackSubmission<C extends string = string> {
     title: string;
     body: string;
-    category: string;
+    category: C;
     attachment: File | null;
 }
 /**
@@ -92,21 +94,28 @@ export interface FeedbackSubmission {
  * attaches the screenshot to the report and the photos as its evidence list. No
  * `attachment`: there is no one file it could name.
  */
-export interface FeedbackMultipleSubmission {
+export interface FeedbackMultipleSubmission<C extends string = string> {
     title: string;
     body: string;
-    category: string;
+    category: C;
     /** What `onCaptureScreenshot` returned, or `null` — at most one. */
     screenshot: File | null;
     /** Picked and pasted files, in the order they were added; at most `maxAttachments`. */
     attachments: File[];
 }
-interface FeedbackDialogBaseProps {
+/**
+ * `C` (0.52, refactor audit 2026-10-30, API-7): the category type, inferred from
+ * `categories` and `category` — `FeedbackCategory` hands `onCategoryChange` and
+ * `onSubmit` a `FeedbackCategory` back, where a plain `string` had to be cast (the kit's
+ * own `useFeedbackSubmit` did). `string` by default, so an app's own vocabulary fits.
+ */
+interface FeedbackDialogBaseProps<C extends string = string> {
     open: boolean;
     onClose: () => void;
-    categories: FeedbackCategoryOption[];
-    category: string;
-    onCategoryChange: (value: string) => void;
+    /** `readonly` since 0.52: the dialog never changes it. */
+    categories: readonly FeedbackCategoryOption<C>[];
+    category: C;
+    onCategoryChange: (value: C) => void;
     /** Prop > `<UiKitProvider labels={{ feedbackDialog, feedbackAttachment }}>` >
      *  English. Optional since 0.12.0; a whole `FeedbackDialogLabels` still fits. */
     labels?: LabelOverride<FeedbackDialogLabels>;
@@ -152,9 +161,9 @@ interface FeedbackDialogBaseProps {
 }
 /** One attachment — a screenshot, a picked or a pasted image; a second replaces
  *  nothing, it has to wait for the first to be removed. The default. */
-export interface FeedbackDialogSingleProps extends FeedbackDialogBaseProps {
+export interface FeedbackDialogSingleProps<C extends string = string> extends FeedbackDialogBaseProps<C> {
     attachments?: "single";
-    onSubmit: (data: FeedbackSubmission) => void | Promise<void>;
+    onSubmit: (data: FeedbackSubmission<C>) => void | Promise<void>;
     /** `info` (0.23.0) names the refused file and the limit — see
      *  {@link FeedbackAttachmentErrorInfo}. */
     onAttachmentError?: (kind: "type" | "size", info: FeedbackAttachmentErrorInfo) => void;
@@ -166,16 +175,16 @@ export interface FeedbackDialogSingleProps extends FeedbackDialogBaseProps {
  * dev#578: "pasted two photos, the second overwrote the first"). The capture button is
  * offered while there is no screenshot yet; the add button while there is room.
  */
-export interface FeedbackDialogMultipleProps extends FeedbackDialogBaseProps {
+export interface FeedbackDialogMultipleProps<C extends string = string> extends FeedbackDialogBaseProps<C> {
     attachments: "multiple";
     /** Default `DEFAULT_MAX_ATTACHMENTS` (5). The screenshot does not count. */
     maxAttachments?: number;
-    onSubmit: (data: FeedbackMultipleSubmission) => void | Promise<void>;
+    onSubmit: (data: FeedbackMultipleSubmission<C>) => void | Promise<void>;
     /** `"count"`: more files arrived at once than there was room for; the surplus was
      *  dropped. `info` (0.23.0) names the refused file(s) and the limit. */
     onAttachmentError?: (kind: FeedbackAttachmentError, info: FeedbackAttachmentErrorInfo) => void;
 }
-export type FeedbackDialogProps = FeedbackDialogSingleProps | FeedbackDialogMultipleProps;
+export type FeedbackDialogProps<C extends string = string> = FeedbackDialogSingleProps<C> | FeedbackDialogMultipleProps<C>;
 /**
  * The generic feedback form dialog: category + subject + body + an optional image
  * attachment, with Ctrl/Cmd+Enter to submit. Domain-free — the app supplies the
@@ -196,4 +205,4 @@ export type FeedbackDialogProps = FeedbackDialogSingleProps | FeedbackDialogMult
  * FeedbackMultipleSubmission}) instead of `attachment`. Opt-in, so a caller typed
  * against the one-file submission keeps compiling and behaving as before.
  */
-export declare function FeedbackDialog(props: FeedbackDialogProps): import("react").JSX.Element | null;
+export declare function FeedbackDialog<C extends string = string>(props: FeedbackDialogProps<C>): import("react").JSX.Element | null;

package/dist/feedback/feedback-dialog.js

@@ -9,6 +9,7 @@ import { Modal } from "../components/modal.js";
 import { isApplePlatform } from "../hooks/use-hotkey.js";
 import { usePhoneLayout } from "../hooks/use-breakpoint.js";
 import { useKitLabels } from "../i18n/kit-labels.js";
+import { hasContent } from "../lib/presence.js";
 import {
   DEFAULT_ATTACHMENT_ACCEPT,
   DEFAULT_FEEDBACK_ATTACHMENT_LABELS,
@@ -41,7 +42,7 @@ function FeedbackDialog(props) {
   const [files, setFiles] = useState([]);
   const isMobile = usePhoneLayout();
   const noticeId = useId();
-  const hasNotice = publicNotice !== void 0 && publicNotice !== null && publicNotice !== false && publicNotice !== "";
+  const hasNotice = hasContent(publicNotice);
   const labels = useKitLabels("feedbackDialog", DEFAULT_FEEDBACK_DIALOG_LABELS, labelsProp);
   const attachmentText = useKitLabels("feedbackAttachment", DEFAULT_FEEDBACK_ATTACHMENT_LABELS, labelsProp);
   const listHeading = labelsProp?.attachmentList ?? attachmentText.attachmentList ?? DEFAULT_FEEDBACK_ATTACHMENT_LABELS.attachmentList;
@@ -67,7 +68,10 @@ function FeedbackDialog(props) {
     }
   };
   if (!open) return null;
-  const categoryField = /* @__PURE__ */ jsx(Select, { label: labels.category, value: category, onChange: (e) => onCategoryChange(e.target.value), children: categories.map((c) => /* @__PURE__ */ jsx("option", { value: c.value, children: c.label }, c.value)) });
+  const categoryField = (
+    // The select offers exactly `categories`' values, so what it answers is one of them.
+    /* @__PURE__ */ jsx(Select, { label: labels.category, value: category, onChange: (e) => onCategoryChange(e.target.value), children: categories.map((c) => /* @__PURE__ */ jsx("option", { value: c.value, children: c.label }, c.value)) })
+  );
   const subjectField = /* @__PURE__ */ jsx(Input, { label: labels.subject, value: title, onChange: (e) => setTitle(e.target.value), variant: "display" });
   const bodyTextarea = /* @__PURE__ */ jsx(
     Textarea,

package/dist/feedback/feedback-dialog.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/feedback-dialog.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { Button } from \"../components/button\";\nimport { Input } from \"../components/input\";\nimport { Select } from \"../components/select\";\nimport { Textarea } from \"../components/textarea\";\nimport type { ButtonSize, ButtonVariant } from \"../components/button-look\";\nimport { Modal } from \"../components/modal\";\nimport { isApplePlatform } from \"../hooks/use-hotkey\";\nimport { usePhoneLayout } from \"../hooks/use-breakpoint\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport {\n  DEFAULT_ATTACHMENT_ACCEPT,\n  DEFAULT_FEEDBACK_ATTACHMENT_LABELS,\n  DEFAULT_MAX_ATTACHMENT_BYTES,\n  FeedbackAttachmentField,\n  type FeedbackAttachmentError,\n  type FeedbackAttachmentErrorInfo,\n} from \"./feedback-attachment\";\nimport { DEFAULT_FEEDBACK_DIALOG_LABELS } from \"./feedback-dialog-labels\";\n\nexport interface FeedbackCategoryOption {\n  value: string;\n  label: string;\n}\n\nexport interface FeedbackAttachmentLabels {\n  /** The heading over the field. Optional: a note editor puts the buttons\n   *  straight under its textarea, where a second heading is noise. */\n  attachment?: string;\n  attachmentAdd: string;\n  /** Label for the \"capture screenshot\" button. Optional — falls back to the provider's\n   *  `feedbackAttachment.attachmentCapture`, then English. */\n  attachmentCapture?: string;\n  /** The line under the attachment buttons saying a screenshot can be pasted\n   *  straight in. Optional — falls back to the provider's `feedbackAttachment`, then English. */\n  attachmentPaste?: string;\n  attachmentRemove: string;\n  /** `multiple` mode (0.15.5): the chip list's accessible name — and, in\n   *  `<FeedbackDialog attachments=\"multiple\">`, the heading over it (0.16.0). Optional,\n   *  as are the keys below — they fall back to the provider's `feedbackAttachment`,\n   *  then English. */\n  attachmentList?: string;\n  /** `multiple` mode (0.16.0): the screenshot slot's chip title, in place of its file name. */\n  attachmentScreenshot?: string;\n  /** `multiple` mode: one chip's remove button, given the file's name. */\n  attachmentRemoveFile?: (name: string) => string;\n  /** `multiple` mode: the line shown once `max` files are attached. */\n  attachmentLimit?: (max: number) => string;\n  /** `refs` mode (0.22.0): the second line of a chip whose upload is still running. */\n  attachmentUploading?: string;\n}\n\nexport interface FeedbackDialogLabels extends FeedbackAttachmentLabels {\n  title: string;\n  category: string;\n  subject: string;\n  body: string;\n  attachment: string;\n  /** See {@link FeedbackDialogTextLabels.submitHint}. */\n  submitHint: FeedbackSubmitHint;\n  cancel: string;\n  save: string;\n}\n\n/** The submit hint: a string, or the line for the platform (`apple`: Mac, iPhone, iPad). */\nexport type FeedbackSubmitHint = string | ((apple: boolean) => string);\n\n/**\n * The dialog's own strings — the `feedbackDialog` namespace of `<UiKitProvider\n * labels>` (0.12.0). The attachment keys are not repeated here: they are the\n * `feedbackAttachment` namespace's, which the field inside already reads.\n *\n * Before, every key was required at the call site, so each app restated ten strings\n * wherever it mounted the dialog (kastlan feedback-button.tsx built the object inline).\n */\nexport interface FeedbackDialogTextLabels {\n  title: string;\n  category: string;\n  subject: string;\n  body: string;\n  /** The body's label when `requireBody={false}`: \"What happened? (optional)\".\n   *  Optional, so a complete `UiKitLabels` typed before 0.14.2 still compiles. */\n  bodyOptional?: string;\n  /** The heading over the attachment buttons. */\n  attachment: string;\n  /**\n   * The line beside the buttons naming the shortcut. Since 0.27.0 a function of the\n   * platform, like `form.submitShortcut`: `apple` is true on a Mac, iPhone or iPad, where\n   * the key is Cmd — \"⌘ Enter to send\" there, keksdose's \"Ctrl+Enter to send\" elsewhere\n   * (§7.12). A plain string is still taken and shown everywhere, as before 0.27.0.\n   */\n  submitHint: FeedbackSubmitHint;\n  cancel: string;\n  save: string;\n  /** 0.38 (docs/feedback-harmonization.md §9.2 decision 6): the line under the body when\n   *  reports are public — `useFeedbackSubmit({ publicNotice: true })` shows it. Optional,\n   *  so a complete `UiKitLabels` typed before 0.38 still compiles. de-CH \"Andere Personen\n   *  sehen Titel und Text (nie Ihre Screenshots oder Dateien).\" */\n  publicNotice?: string;\n}\n\n// Defined in ./feedback-dialog-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_FEEDBACK_DIALOG_LABELS };\n\nexport interface FeedbackSubmission {\n  title: string;\n  body: string;\n  category: string;\n  attachment: File | null;\n}\n\n/**\n * What `onSubmit` gets under `attachments=\"multiple\"` (0.15.5): the screenshot and\n * the picked/pasted files apart, because an app files them differently — keksdose\n * attaches the screenshot to the report and the photos as its evidence list. No\n * `attachment`: there is no one file it could name.\n */\nexport interface FeedbackMultipleSubmission {\n  title: string;\n  body: string;\n  category: string;\n  /** What `onCaptureScreenshot` returned, or `null` — at most one. */\n  screenshot: File | null;\n  /** Picked and pasted files, in the order they were added; at most `maxAttachments`. */\n  attachments: File[];\n}\n\ninterface FeedbackDialogBaseProps {\n  open: boolean;\n  onClose: () => void;\n  categories: FeedbackCategoryOption[];\n  category: string;\n  onCategoryChange: (value: string) => void;\n  /** Prop > `<UiKitProvider labels={{ feedbackDialog, feedbackAttachment }}>` >\n   *  English. Optional since 0.12.0; a whole `FeedbackDialogLabels` still fits. */\n  labels?: LabelOverride<FeedbackDialogLabels>;\n  submitting?: boolean;\n  contextSlot?: ReactNode;\n  attachmentAccept?: string[];\n  maxAttachmentBytes?: number;\n  /**\n   * Optional: capture a screenshot of the underlying app view and return it as a\n   * File. When provided, a \"Capture screenshot\" button is shown next to \"Add\n   * attachment\"; the returned file is fed through the same validation + preview.\n   */\n  onCaptureScreenshot?: () => Promise<File | null>;\n  /**\n   * `false`: a report with only a subject can be sent, and the body's label says it is\n   * optional (`bodyOptional`, unless `labels.body` is passed). Default `true`, the\n   * dialog's behaviour until 0.14.2 (keksdose K1: its backend takes title-only reports).\n   */\n  requireBody?: boolean;\n  /**\n   * The attachment field's add and capture buttons: its `buttonVariant` (0.25.0),\n   * Button's own `variant`. Default `\"secondary\"`, the look they always had.\n   *\n   * The field took `buttonVariant` / `buttonSize` in 0.24.0 (keksdose's support chat),\n   * but the dialog builds its field itself and passed neither, so a host that wanted\n   * quieter buttons here — a dialog that already ends in a row of Cancel / Send — had\n   * no way to say so short of rebuilding the dialog. Named after the dialog's other\n   * attachment options (`attachmentAccept`, `onAttachmentError`) and handed through\n   * unchanged, in both `attachments` modes.\n   */\n  attachmentButtonVariant?: ButtonVariant;\n  /** The attachment field's `buttonSize` (0.25.0) — with {@link attachmentButtonVariant}.\n   *  Default `\"md\"`; `\"sm\"` draws the paperclip and camera at 14px. */\n  attachmentButtonSize?: ButtonSize;\n  /**\n   * A muted line under the body saying who will read it (0.38, docs/feedback-harmonization.md\n   * §9.2 decision 6) — the kit's sentence is `feedbackDialog.publicNotice`, \"Other users\n   * will see the title and text (never your screenshots or files)\", which\n   * `useFeedbackSubmit({ publicNotice: true })` passes. Attached to the body field with\n   * `aria-describedby`, so it is heard where the text is written. Left out: no line.\n   */\n  publicNotice?: ReactNode;\n}\n\n/** One attachment — a screenshot, a picked or a pasted image; a second replaces\n *  nothing, it has to wait for the first to be removed. The default. */\nexport interface FeedbackDialogSingleProps extends FeedbackDialogBaseProps {\n  attachments?: \"single\";\n  onSubmit: (data: FeedbackSubmission) => void | Promise<void>;\n  /** `info` (0.23.0) names the refused file and the limit — see\n   *  {@link FeedbackAttachmentErrorInfo}. */\n  onAttachmentError?: (kind: \"type\" | \"size\", info: FeedbackAttachmentErrorInfo) => void;\n  /** Multiple mode only — refused here rather than silently ignored. */\n  maxAttachments?: never;\n}\n\n/**\n * One screenshot plus up to `maxAttachments` picked or pasted files (0.15.5, keksdose\n * dev#578: \"pasted two photos, the second overwrote the first\"). The capture button is\n * offered while there is no screenshot yet; the add button while there is room.\n */\nexport interface FeedbackDialogMultipleProps extends FeedbackDialogBaseProps {\n  attachments: \"multiple\";\n  /** Default `DEFAULT_MAX_ATTACHMENTS` (5). The screenshot does not count. */\n  maxAttachments?: number;\n  onSubmit: (data: FeedbackMultipleSubmission) => void | Promise<void>;\n  /** `\"count\"`: more files arrived at once than there was room for; the surplus was\n   *  dropped. `info` (0.23.0) names the refused file(s) and the limit. */\n  onAttachmentError?: (kind: FeedbackAttachmentError, info: FeedbackAttachmentErrorInfo) => void;\n}\n\nexport type FeedbackDialogProps = FeedbackDialogSingleProps | FeedbackDialogMultipleProps;\n\n/**\n * The generic feedback form dialog: category + subject + body + an optional image\n * attachment, with Ctrl/Cmd+Enter to submit. Domain-free — the app supplies the\n * category options, labels and an `onSubmit` that talks to its own backend, plus\n * an optional `contextSlot` for app-specific context (user, current URL, …).\n *\n * **A screenshot can be pasted straight in.** Ctrl/Cmd+V anywhere in the dialog\n * takes an image off the clipboard and makes it the attachment, through the same\n * validation and the same preview as the file picker. It is the gesture the two\n * ways in did not cover: `onCaptureScreenshot` snapshots the *whole* app view,\n * and the file picker needs a file — so somebody who wanted to show one panel,\n * or one region of one, had to save a crop to disk first and then find it again\n * (Steering Design feedback #39). The clipboard is where a region snip already\n * is on every platform.\n *\n * **`attachments=\"multiple\"`** (0.15.5) takes several: every paste and pick adds a\n * chip, and `onSubmit` gets `{ screenshot, attachments }` ({@link\n * FeedbackMultipleSubmission}) instead of `attachment`. Opt-in, so a caller typed\n * against the one-file submission keeps compiling and behaving as before.\n */\nexport function FeedbackDialog(props: FeedbackDialogProps) {\n  const {\n    open,\n    onClose,\n    categories,\n    category,\n    onCategoryChange,\n    labels: labelsProp,\n    submitting = false,\n    contextSlot,\n    attachmentAccept = DEFAULT_ATTACHMENT_ACCEPT,\n    maxAttachmentBytes = DEFAULT_MAX_ATTACHMENT_BYTES,\n    onCaptureScreenshot,\n    requireBody = true,\n    attachmentButtonVariant,\n    attachmentButtonSize,\n    publicNotice,\n  } = props;\n  const [title, setTitle] = useState(\"\");\n  const [body, setBody] = useState(\"\");\n  const [attachment, setAttachment] = useState<File | null>(null);\n  // `attachments=\"multiple\"` only: the capture, apart from the picked/pasted files.\n  const [screenshot, setScreenshot] = useState<File | null>(null);\n  const [files, setFiles] = useState<File[]>([]);\n  const isMobile = usePhoneLayout();\n  const noticeId = useId();\n  const hasNotice =\n    publicNotice !== undefined && publicNotice !== null && publicNotice !== false && publicNotice !== \"\";\n  const labels = useKitLabels(\"feedbackDialog\", DEFAULT_FEEDBACK_DIALOG_LABELS, labelsProp);\n  const attachmentText = useKitLabels(\"feedbackAttachment\", DEFAULT_FEEDBACK_ATTACHMENT_LABELS, labelsProp);\n  // Under `multiple` the heading is `attachmentList` — a screenshot AND photos — which\n  // also names the chip list beneath it: one string, so the two cannot disagree. Its old\n  // second name, `feedbackDialog.attachments`, went in 0.34.\n  const listHeading =\n    labelsProp?.attachmentList ?? attachmentText.attachmentList ?? DEFAULT_FEEDBACK_ATTACHMENT_LABELS.attachmentList!;\n  // The attachment field resolves its own keys from `feedbackAttachment`; it gets the\n  // prop's (so a caller's `attachmentAdd` still wins) plus the resolved heading.\n  const attachmentLabels =\n    props.attachments === \"multiple\"\n      ? { ...labelsProp, attachment: listHeading, attachmentList: listHeading }\n      : { ...labelsProp, attachment: labels.attachment };\n\n  // Reset the form whenever the dialog is (re)opened — during render, on the\n  // closed-to-open transition, so the old draft never paints for a frame.\n  const [wasOpen, setWasOpen] = useState(open);\n  if (open !== wasOpen) {\n    setWasOpen(open);\n    if (open) {\n      setTitle(\"\");\n      setBody(\"\");\n      setAttachment(null);\n      setScreenshot(null);\n      setFiles([]);\n    }\n  }\n\n  // Trimmed: a subject or body of spaces is empty (keksdose's API answers a blank title\n  // with a 422, and a blank report is no report).\n  const canSubmit = !!title.trim() && (!requireBody || !!body.trim()) && !submitting;\n  const trySubmit = () => {\n    if (!canSubmit) return;\n    if (props.attachments === \"multiple\") {\n      void props.onSubmit({ title, body, category, screenshot, attachments: files });\n    } else {\n      void props.onSubmit({ title, body, category, attachment });\n    }\n  };\n\n  if (!open) return null;\n\n  const categoryField = (\n    <Select label={labels.category} value={category} onChange={(e) => onCategoryChange(e.target.value)}>\n      {categories.map((c) => (\n        <option key={c.value} value={c.value}>\n          {c.label}\n        </option>\n      ))}\n    </Select>\n  );\n  // On a phone the subject leads as a heading rather than as the second of two\n  // identical boxes under a select (Keksdose feedback #179). `variant=\"display\"`\n  // is a no-op above the phone breakpoint, so the desktop dialog is unchanged.\n  const subjectField = (\n    <Input label={labels.subject} value={title} onChange={(e) => setTitle(e.target.value)} variant=\"display\" />\n  );\n  const bodyTextarea = (\n    <Textarea\n      rows={5}\n      label={requireBody ? labels.body : (labelsProp?.body ?? labels.bodyOptional ?? labels.body)}\n      value={body}\n      onChange={(e) => setBody(e.target.value)}\n      aria-describedby={hasNotice ? noticeId : undefined}\n    />\n  );\n  // 0.38: who will read it, right under what they are writing (§9.2 decision 6).\n  const bodyField = hasNotice ? (\n    <div className=\"space-y-1\">\n      {bodyTextarea}\n      <p id={noticeId} className=\"text-xs text-muted\" data-feedback-public-notice=\"\">\n        {publicNotice}\n      </p>\n    </div>\n  ) : (\n    bodyTextarea\n  );\n  const fieldProps = {\n    labels: attachmentLabels,\n    accept: attachmentAccept,\n    maxBytes: maxAttachmentBytes,\n    onCaptureScreenshot,\n    // Left undefined they are the field's own defaults (secondary / md).\n    buttonVariant: attachmentButtonVariant,\n    buttonSize: attachmentButtonSize,\n    // On `document`, not on the panel: the Modal focuses its own panel on open\n    // and traps Tab inside it, so while this dialog is up every paste in the\n    // page is meant for it — including the one made with nothing in\n    // particular focused, which never reaches a React `onPaste` on a child.\n    documentPaste: open,\n  };\n  const attachmentField =\n    props.attachments === \"multiple\" ? (\n      <FeedbackAttachmentField\n        {...fieldProps}\n        multiple\n        value={files}\n        onChange={setFiles}\n        max={props.maxAttachments}\n        // The capture goes to its own slot, so it is offered once and never crowds\n        // out a photo; a paste is a photo (a region snip is chosen evidence, not \"the\n        // screenshot\").\n        screenshot={screenshot}\n        onScreenshotChange={setScreenshot}\n        onError={props.onAttachmentError}\n      />\n    ) : (\n      <FeedbackAttachmentField\n        {...fieldProps}\n        value={attachment}\n        onChange={setAttachment}\n        onError={props.onAttachmentError}\n      />\n    );\n\n  return (\n    <Modal\n      onClose={onClose}\n      // The one dialog whose subject is the page behind it (Keksdose dev#460: \"Make\n      // the feedback dialog draggable so I can see behind it if it blocks\n      // something\") — you are describing what is under it while you type.\n      draggable\n      onKeyDown={(e) => {\n        if ((e.ctrlKey || e.metaKey) && e.key === \"Enter\") {\n          e.preventDefault();\n          trySubmit();\n        }\n      }}\n    >\n      {/* Also the drag handle: pressing anywhere on the panel's own chrome moves it,\n          and the heading is the strip a user reaches for. */}\n      <h2 className=\"mb-3 text-lg font-semibold\">{labels.title}</h2>\n      <div className=\"space-y-3\">\n        {isMobile ? (\n          // Phone shape, the same reasoning as the transaction editor's (#177):\n          // the desktop order is the DATA MODEL's order — category, then subject,\n          // then body — but nobody opens this dialog to pick a category. What they\n          // came to do is say the thing, so that leads; the classification and the\n          // evidence follow, a tier down.\n          <>\n            {subjectField}\n            {bodyField}\n            <div className=\"space-y-3 border-t border-subtle pt-3\">\n              {categoryField}\n              {attachmentField}\n              {contextSlot}\n            </div>\n          </>\n        ) : (\n          <>\n            {categoryField}\n            {subjectField}\n            {bodyField}\n            {attachmentField}\n            {contextSlot}\n          </>\n        )}\n        <div className=\"flex items-center justify-between gap-2\">\n          <div className=\"text-xs text-placeholder\">\n            {typeof labels.submitHint === \"function\" ? labels.submitHint(isApplePlatform()) : labels.submitHint}\n          </div>\n          <div className=\"flex gap-2\">\n            <Button variant=\"ghost\" onClick={onClose}>\n              {labels.cancel}\n            </Button>\n            <Button onClick={trySubmit} disabled={!canSubmit}>\n              {labels.save}\n            </Button>\n          </div>\n        </div>\n      </div>\n    </Modal>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/feedback/feedback-dialog.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { Button } from \"../components/button\";\nimport { Input } from \"../components/input\";\nimport { Select } from \"../components/select\";\nimport { Textarea } from \"../components/textarea\";\nimport type { ButtonSize, ButtonVariant } from \"../components/button-look\";\nimport { Modal } from \"../components/modal\";\nimport { isApplePlatform } from \"../hooks/use-hotkey\";\nimport { usePhoneLayout } from \"../hooks/use-breakpoint\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { hasContent } from \"../lib/presence\";\nimport {\n  DEFAULT_ATTACHMENT_ACCEPT,\n  DEFAULT_FEEDBACK_ATTACHMENT_LABELS,\n  DEFAULT_MAX_ATTACHMENT_BYTES,\n  FeedbackAttachmentField,\n  type FeedbackAttachmentError,\n  type FeedbackAttachmentErrorInfo,\n} from \"./feedback-attachment\";\nimport { DEFAULT_FEEDBACK_DIALOG_LABELS } from \"./feedback-dialog-labels\";\n\n/** One category the dialog offers. `C` (0.52): the app's category type — the kit's\n *  `FeedbackCategory`, or `string` (the default) for a vocabulary of the app's own. */\nexport interface FeedbackCategoryOption<C extends string = string> {\n  value: C;\n  label: string;\n}\n\nexport interface FeedbackAttachmentLabels {\n  /** The heading over the field. Optional: a note editor puts the buttons\n   *  straight under its textarea, where a second heading is noise. */\n  attachment?: string;\n  attachmentAdd: string;\n  /** Label for the \"capture screenshot\" button. Optional — falls back to the provider's\n   *  `feedbackAttachment.attachmentCapture`, then English. */\n  attachmentCapture?: string;\n  /** The line under the attachment buttons saying a screenshot can be pasted\n   *  straight in. Optional — falls back to the provider's `feedbackAttachment`, then English. */\n  attachmentPaste?: string;\n  attachmentRemove: string;\n  /** `multiple` mode (0.15.5): the chip list's accessible name — and, in\n   *  `<FeedbackDialog attachments=\"multiple\">`, the heading over it (0.16.0). Optional,\n   *  as are the keys below — they fall back to the provider's `feedbackAttachment`,\n   *  then English. */\n  attachmentList?: string;\n  /** `multiple` mode (0.16.0): the screenshot slot's chip title, in place of its file name. */\n  attachmentScreenshot?: string;\n  /** `multiple` mode: one chip's remove button, given the file's name. */\n  attachmentRemoveFile?: (name: string) => string;\n  /** `multiple` mode: the line shown once `max` files are attached. */\n  attachmentLimit?: (max: number) => string;\n  /** `refs` mode (0.22.0): the second line of a chip whose upload is still running. */\n  attachmentUploading?: string;\n}\n\nexport interface FeedbackDialogLabels extends FeedbackAttachmentLabels {\n  title: string;\n  category: string;\n  subject: string;\n  body: string;\n  attachment: string;\n  /** See {@link FeedbackDialogTextLabels.submitHint}. */\n  submitHint: FeedbackSubmitHint;\n  cancel: string;\n  save: string;\n}\n\n/** The submit hint: a string, or the line for the platform (`apple`: Mac, iPhone, iPad). */\nexport type FeedbackSubmitHint = string | ((apple: boolean) => string);\n\n/**\n * The dialog's own strings — the `feedbackDialog` namespace of `<UiKitProvider\n * labels>` (0.12.0). The attachment keys are not repeated here: they are the\n * `feedbackAttachment` namespace's, which the field inside already reads.\n *\n * Before, every key was required at the call site, so each app restated ten strings\n * wherever it mounted the dialog (kastlan feedback-button.tsx built the object inline).\n */\nexport interface FeedbackDialogTextLabels {\n  title: string;\n  category: string;\n  subject: string;\n  body: string;\n  /** The body's label when `requireBody={false}`: \"What happened? (optional)\".\n   *  Optional, so a complete `UiKitLabels` typed before 0.14.2 still compiles. */\n  bodyOptional?: string;\n  /** The heading over the attachment buttons. */\n  attachment: string;\n  /**\n   * The line beside the buttons naming the shortcut. Since 0.27.0 a function of the\n   * platform, like `form.submitShortcut`: `apple` is true on a Mac, iPhone or iPad, where\n   * the key is Cmd — \"⌘ Enter to send\" there, keksdose's \"Ctrl+Enter to send\" elsewhere\n   * (§7.12). A plain string is still taken and shown everywhere, as before 0.27.0.\n   */\n  submitHint: FeedbackSubmitHint;\n  cancel: string;\n  save: string;\n  /** 0.38 (docs/feedback-harmonization.md §9.2 decision 6): the line under the body when\n   *  reports are public — `useFeedbackSubmit({ publicNotice: true })` shows it. Optional,\n   *  so a complete `UiKitLabels` typed before 0.38 still compiles. de-CH \"Andere Personen\n   *  sehen Titel und Text (nie Ihre Screenshots oder Dateien).\" */\n  publicNotice?: string;\n}\n\n// Defined in ./feedback-dialog-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_FEEDBACK_DIALOG_LABELS };\n\nexport interface FeedbackSubmission<C extends string = string> {\n  title: string;\n  body: string;\n  category: C;\n  attachment: File | null;\n}\n\n/**\n * What `onSubmit` gets under `attachments=\"multiple\"` (0.15.5): the screenshot and\n * the picked/pasted files apart, because an app files them differently — keksdose\n * attaches the screenshot to the report and the photos as its evidence list. No\n * `attachment`: there is no one file it could name.\n */\nexport interface FeedbackMultipleSubmission<C extends string = string> {\n  title: string;\n  body: string;\n  category: C;\n  /** What `onCaptureScreenshot` returned, or `null` — at most one. */\n  screenshot: File | null;\n  /** Picked and pasted files, in the order they were added; at most `maxAttachments`. */\n  attachments: File[];\n}\n\n/**\n * `C` (0.52, refactor audit 2026-10-30, API-7): the category type, inferred from\n * `categories` and `category` — `FeedbackCategory` hands `onCategoryChange` and\n * `onSubmit` a `FeedbackCategory` back, where a plain `string` had to be cast (the kit's\n * own `useFeedbackSubmit` did). `string` by default, so an app's own vocabulary fits.\n */\ninterface FeedbackDialogBaseProps<C extends string = string> {\n  open: boolean;\n  onClose: () => void;\n  /** `readonly` since 0.52: the dialog never changes it. */\n  categories: readonly FeedbackCategoryOption<C>[];\n  category: C;\n  onCategoryChange: (value: C) => void;\n  /** Prop > `<UiKitProvider labels={{ feedbackDialog, feedbackAttachment }}>` >\n   *  English. Optional since 0.12.0; a whole `FeedbackDialogLabels` still fits. */\n  labels?: LabelOverride<FeedbackDialogLabels>;\n  submitting?: boolean;\n  contextSlot?: ReactNode;\n  attachmentAccept?: string[];\n  maxAttachmentBytes?: number;\n  /**\n   * Optional: capture a screenshot of the underlying app view and return it as a\n   * File. When provided, a \"Capture screenshot\" button is shown next to \"Add\n   * attachment\"; the returned file is fed through the same validation + preview.\n   */\n  onCaptureScreenshot?: () => Promise<File | null>;\n  /**\n   * `false`: a report with only a subject can be sent, and the body's label says it is\n   * optional (`bodyOptional`, unless `labels.body` is passed). Default `true`, the\n   * dialog's behaviour until 0.14.2 (keksdose K1: its backend takes title-only reports).\n   */\n  requireBody?: boolean;\n  /**\n   * The attachment field's add and capture buttons: its `buttonVariant` (0.25.0),\n   * Button's own `variant`. Default `\"secondary\"`, the look they always had.\n   *\n   * The field took `buttonVariant` / `buttonSize` in 0.24.0 (keksdose's support chat),\n   * but the dialog builds its field itself and passed neither, so a host that wanted\n   * quieter buttons here — a dialog that already ends in a row of Cancel / Send — had\n   * no way to say so short of rebuilding the dialog. Named after the dialog's other\n   * attachment options (`attachmentAccept`, `onAttachmentError`) and handed through\n   * unchanged, in both `attachments` modes.\n   */\n  attachmentButtonVariant?: ButtonVariant;\n  /** The attachment field's `buttonSize` (0.25.0) — with {@link attachmentButtonVariant}.\n   *  Default `\"md\"`; `\"sm\"` draws the paperclip and camera at 14px. */\n  attachmentButtonSize?: ButtonSize;\n  /**\n   * A muted line under the body saying who will read it (0.38, docs/feedback-harmonization.md\n   * §9.2 decision 6) — the kit's sentence is `feedbackDialog.publicNotice`, \"Other users\n   * will see the title and text (never your screenshots or files)\", which\n   * `useFeedbackSubmit({ publicNotice: true })` passes. Attached to the body field with\n   * `aria-describedby`, so it is heard where the text is written. Left out: no line.\n   */\n  publicNotice?: ReactNode;\n}\n\n/** One attachment — a screenshot, a picked or a pasted image; a second replaces\n *  nothing, it has to wait for the first to be removed. The default. */\nexport interface FeedbackDialogSingleProps<C extends string = string> extends FeedbackDialogBaseProps<C> {\n  attachments?: \"single\";\n  onSubmit: (data: FeedbackSubmission<C>) => void | Promise<void>;\n  /** `info` (0.23.0) names the refused file and the limit — see\n   *  {@link FeedbackAttachmentErrorInfo}. */\n  onAttachmentError?: (kind: \"type\" | \"size\", info: FeedbackAttachmentErrorInfo) => void;\n  /** Multiple mode only — refused here rather than silently ignored. */\n  maxAttachments?: never;\n}\n\n/**\n * One screenshot plus up to `maxAttachments` picked or pasted files (0.15.5, keksdose\n * dev#578: \"pasted two photos, the second overwrote the first\"). The capture button is\n * offered while there is no screenshot yet; the add button while there is room.\n */\nexport interface FeedbackDialogMultipleProps<C extends string = string> extends FeedbackDialogBaseProps<C> {\n  attachments: \"multiple\";\n  /** Default `DEFAULT_MAX_ATTACHMENTS` (5). The screenshot does not count. */\n  maxAttachments?: number;\n  onSubmit: (data: FeedbackMultipleSubmission<C>) => void | Promise<void>;\n  /** `\"count\"`: more files arrived at once than there was room for; the surplus was\n   *  dropped. `info` (0.23.0) names the refused file(s) and the limit. */\n  onAttachmentError?: (kind: FeedbackAttachmentError, info: FeedbackAttachmentErrorInfo) => void;\n}\n\nexport type FeedbackDialogProps<C extends string = string> =\n  FeedbackDialogSingleProps<C> | FeedbackDialogMultipleProps<C>;\n\n/**\n * The generic feedback form dialog: category + subject + body + an optional image\n * attachment, with Ctrl/Cmd+Enter to submit. Domain-free — the app supplies the\n * category options, labels and an `onSubmit` that talks to its own backend, plus\n * an optional `contextSlot` for app-specific context (user, current URL, …).\n *\n * **A screenshot can be pasted straight in.** Ctrl/Cmd+V anywhere in the dialog\n * takes an image off the clipboard and makes it the attachment, through the same\n * validation and the same preview as the file picker. It is the gesture the two\n * ways in did not cover: `onCaptureScreenshot` snapshots the *whole* app view,\n * and the file picker needs a file — so somebody who wanted to show one panel,\n * or one region of one, had to save a crop to disk first and then find it again\n * (Steering Design feedback #39). The clipboard is where a region snip already\n * is on every platform.\n *\n * **`attachments=\"multiple\"`** (0.15.5) takes several: every paste and pick adds a\n * chip, and `onSubmit` gets `{ screenshot, attachments }` ({@link\n * FeedbackMultipleSubmission}) instead of `attachment`. Opt-in, so a caller typed\n * against the one-file submission keeps compiling and behaving as before.\n */\nexport function FeedbackDialog<C extends string = string>(props: FeedbackDialogProps<C>) {\n  const {\n    open,\n    onClose,\n    categories,\n    category,\n    onCategoryChange,\n    labels: labelsProp,\n    submitting = false,\n    contextSlot,\n    attachmentAccept = DEFAULT_ATTACHMENT_ACCEPT,\n    maxAttachmentBytes = DEFAULT_MAX_ATTACHMENT_BYTES,\n    onCaptureScreenshot,\n    requireBody = true,\n    attachmentButtonVariant,\n    attachmentButtonSize,\n    publicNotice,\n  } = props;\n  const [title, setTitle] = useState(\"\");\n  const [body, setBody] = useState(\"\");\n  const [attachment, setAttachment] = useState<File | null>(null);\n  // `attachments=\"multiple\"` only: the capture, apart from the picked/pasted files.\n  const [screenshot, setScreenshot] = useState<File | null>(null);\n  const [files, setFiles] = useState<File[]>([]);\n  const isMobile = usePhoneLayout();\n  const noticeId = useId();\n  const hasNotice = hasContent(publicNotice);\n  const labels = useKitLabels(\"feedbackDialog\", DEFAULT_FEEDBACK_DIALOG_LABELS, labelsProp);\n  const attachmentText = useKitLabels(\"feedbackAttachment\", DEFAULT_FEEDBACK_ATTACHMENT_LABELS, labelsProp);\n  // Under `multiple` the heading is `attachmentList` — a screenshot AND photos — which\n  // also names the chip list beneath it: one string, so the two cannot disagree. Its old\n  // second name, `feedbackDialog.attachments`, went in 0.34.\n  const listHeading =\n    labelsProp?.attachmentList ?? attachmentText.attachmentList ?? DEFAULT_FEEDBACK_ATTACHMENT_LABELS.attachmentList!;\n  // The attachment field resolves its own keys from `feedbackAttachment`; it gets the\n  // prop's (so a caller's `attachmentAdd` still wins) plus the resolved heading.\n  const attachmentLabels =\n    props.attachments === \"multiple\"\n      ? { ...labelsProp, attachment: listHeading, attachmentList: listHeading }\n      : { ...labelsProp, attachment: labels.attachment };\n\n  // Reset the form whenever the dialog is (re)opened — during render, on the\n  // closed-to-open transition, so the old draft never paints for a frame.\n  const [wasOpen, setWasOpen] = useState(open);\n  if (open !== wasOpen) {\n    setWasOpen(open);\n    if (open) {\n      setTitle(\"\");\n      setBody(\"\");\n      setAttachment(null);\n      setScreenshot(null);\n      setFiles([]);\n    }\n  }\n\n  // Trimmed: a subject or body of spaces is empty (keksdose's API answers a blank title\n  // with a 422, and a blank report is no report).\n  const canSubmit = !!title.trim() && (!requireBody || !!body.trim()) && !submitting;\n  const trySubmit = () => {\n    if (!canSubmit) return;\n    if (props.attachments === \"multiple\") {\n      void props.onSubmit({ title, body, category, screenshot, attachments: files });\n    } else {\n      void props.onSubmit({ title, body, category, attachment });\n    }\n  };\n\n  if (!open) return null;\n\n  const categoryField = (\n    // The select offers exactly `categories`' values, so what it answers is one of them.\n    <Select label={labels.category} value={category} onChange={(e) => onCategoryChange(e.target.value as C)}>\n      {categories.map((c) => (\n        <option key={c.value} value={c.value}>\n          {c.label}\n        </option>\n      ))}\n    </Select>\n  );\n  // On a phone the subject leads as a heading rather than as the second of two\n  // identical boxes under a select (Keksdose feedback #179). `variant=\"display\"`\n  // is a no-op above the phone breakpoint, so the desktop dialog is unchanged.\n  const subjectField = (\n    <Input label={labels.subject} value={title} onChange={(e) => setTitle(e.target.value)} variant=\"display\" />\n  );\n  const bodyTextarea = (\n    <Textarea\n      rows={5}\n      label={requireBody ? labels.body : (labelsProp?.body ?? labels.bodyOptional ?? labels.body)}\n      value={body}\n      onChange={(e) => setBody(e.target.value)}\n      aria-describedby={hasNotice ? noticeId : undefined}\n    />\n  );\n  // 0.38: who will read it, right under what they are writing (§9.2 decision 6).\n  const bodyField = hasNotice ? (\n    <div className=\"space-y-1\">\n      {bodyTextarea}\n      <p id={noticeId} className=\"text-xs text-muted\" data-feedback-public-notice=\"\">\n        {publicNotice}\n      </p>\n    </div>\n  ) : (\n    bodyTextarea\n  );\n  const fieldProps = {\n    labels: attachmentLabels,\n    accept: attachmentAccept,\n    maxBytes: maxAttachmentBytes,\n    onCaptureScreenshot,\n    // Left undefined they are the field's own defaults (secondary / md).\n    buttonVariant: attachmentButtonVariant,\n    buttonSize: attachmentButtonSize,\n    // On `document`, not on the panel: the Modal focuses its own panel on open\n    // and traps Tab inside it, so while this dialog is up every paste in the\n    // page is meant for it — including the one made with nothing in\n    // particular focused, which never reaches a React `onPaste` on a child.\n    documentPaste: open,\n  };\n  const attachmentField =\n    props.attachments === \"multiple\" ? (\n      <FeedbackAttachmentField\n        {...fieldProps}\n        multiple\n        value={files}\n        onChange={setFiles}\n        max={props.maxAttachments}\n        // The capture goes to its own slot, so it is offered once and never crowds\n        // out a photo; a paste is a photo (a region snip is chosen evidence, not \"the\n        // screenshot\").\n        screenshot={screenshot}\n        onScreenshotChange={setScreenshot}\n        onError={props.onAttachmentError}\n      />\n    ) : (\n      <FeedbackAttachmentField\n        {...fieldProps}\n        value={attachment}\n        onChange={setAttachment}\n        onError={props.onAttachmentError}\n      />\n    );\n\n  return (\n    <Modal\n      onClose={onClose}\n      // The one dialog whose subject is the page behind it (Keksdose dev#460: \"Make\n      // the feedback dialog draggable so I can see behind it if it blocks\n      // something\") — you are describing what is under it while you type.\n      draggable\n      onKeyDown={(e) => {\n        if ((e.ctrlKey || e.metaKey) && e.key === \"Enter\") {\n          e.preventDefault();\n          trySubmit();\n        }\n      }}\n    >\n      {/* Also the drag handle: pressing anywhere on the panel's own chrome moves it,\n          and the heading is the strip a user reaches for. */}\n      <h2 className=\"mb-3 text-lg font-semibold\">{labels.title}</h2>\n      <div className=\"space-y-3\">\n        {isMobile ? (\n          // Phone shape, the same reasoning as the transaction editor's (#177):\n          // the desktop order is the DATA MODEL's order — category, then subject,\n          // then body — but nobody opens this dialog to pick a category. What they\n          // came to do is say the thing, so that leads; the classification and the\n          // evidence follow, a tier down.\n          <>\n            {subjectField}\n            {bodyField}\n            <div className=\"space-y-3 border-t border-subtle pt-3\">\n              {categoryField}\n              {attachmentField}\n              {contextSlot}\n            </div>\n          </>\n        ) : (\n          <>\n            {categoryField}\n            {subjectField}\n            {bodyField}\n            {attachmentField}\n            {contextSlot}\n          </>\n        )}\n        <div className=\"flex items-center justify-between gap-2\">\n          <div className=\"text-xs text-placeholder\">\n            {typeof labels.submitHint === \"function\" ? labels.submitHint(isApplePlatform()) : labels.submitHint}\n          </div>\n          <div className=\"flex gap-2\">\n            <Button variant=\"ghost\" onClick={onClose}>\n              {labels.cancel}\n            </Button>\n            <Button onClick={trySubmit} disabled={!canSubmit}>\n              {labels.save}\n            </Button>\n          </div>\n        </div>\n      </div>\n    </Modal>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/feedback/feedback-mutation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A page's mutation, run once (refactor audit 2026-10-30, FLW-3): TanStack Query's
+ * `mutateAsync`, or any `(patch) => Promise` that resolves once the PATCH has landed.
+ *
+ * The parts took TanStack Query's `mutate` with a per-call `onSuccess` until 0.53
+ * (deprecated in 0.52). TanStack v5 calls per-call callbacks for the LATEST `mutate()` on
+ * an observer only — it overwrites the options and detaches from the earlier mutation —
+ * so a second change sent before the first PATCH answered (another swipe, another pill,
+ * the Undo itself) lost the first change's Undo toast, and the detail's editor stayed
+ * open. The promise `mutateAsync` returns settles for every call, whatever the observer
+ * does next.
+ *
+ * A rejected promise is the mutation's own to report (its `onError`), so it is caught here
+ * and nothing more happens.
+ *
+ * @internal Not part of `/feedback` or the barrel.
+ */
+export declare function runMutation<P>(call: (patch: P) => Promise<unknown>, patch: P, landed: () => void): void;

package/dist/feedback/feedback-mutation.js

@@ -0,0 +1,8 @@
+"use client";
+function runMutation(call, patch, landed) {
+  call(patch).then(landed, () => void 0);
+}
+export {
+  runMutation
+};
+//# sourceMappingURL=feedback-mutation.js.map

package/dist/feedback/feedback-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-mutation.ts"],"sourcesContent":["/**\n * A page's mutation, run once (refactor audit 2026-10-30, FLW-3): TanStack Query's\n * `mutateAsync`, or any `(patch) => Promise` that resolves once the PATCH has landed.\n *\n * The parts took TanStack Query's `mutate` with a per-call `onSuccess` until 0.53\n * (deprecated in 0.52). TanStack v5 calls per-call callbacks for the LATEST `mutate()` on\n * an observer only — it overwrites the options and detaches from the earlier mutation —\n * so a second change sent before the first PATCH answered (another swipe, another pill,\n * the Undo itself) lost the first change's Undo toast, and the detail's editor stayed\n * open. The promise `mutateAsync` returns settles for every call, whatever the observer\n * does next.\n *\n * A rejected promise is the mutation's own to report (its `onError`), so it is caught here\n * and nothing more happens.\n *\n * @internal Not part of `/feedback` or the barrel.\n */\nexport function runMutation<P>(call: (patch: P) => Promise<unknown>, patch: P, landed: () => void): void {\n  call(patch).then(landed, () => undefined);\n}\n"],"mappings":";AAiBO,SAAS,YAAe,MAAsC,OAAU,QAA0B;AACvG,OAAK,KAAK,EAAE,KAAK,QAAQ,MAAM,MAAS;AAC1C;","names":[]}

package/dist/feedback/feedback-page-link.d.ts

@@ -0,0 +1,53 @@
+import type { PathPattern } from "../landing/routing.js";
+import type { FeedbackContext } from "./feedback-record.js";
+/**
+ * The page a report was filed on, and which of it the feedback parts link (refactor audit
+ * 2026-10-30, FLW-7).
+ *
+ * The page comes from the REPORTER's client context: its origin is always this app's
+ * (only the path is ever linked), but its path and query are whatever the row says. A
+ * signed-in user could file a report whose link takes the admin to a route that acts on
+ * load — keksdose's `/join?token=` accepts an invitation through `AcceptInvitation`,
+ * kastlan's and Kurvenschmiede's `/register?invite=` likewise.
+ *
+ * **Only the PATH is linked** (0.52 code review, this file). The tokens and the forward
+ * targets travel in the query: a guard on the path alone let `/login?next=%2Fjoin%3Ftoken%3D…`
+ * through as a link, and `RedirectIfAuthed` sent the signed-in admin on to the invitation —
+ * as `/forgot-password`, `/demo` and `/welcome` would, and whatever forwarder an app adds
+ * next (`?returnTo=`, a share target). No list of forwarders can know them all; a link
+ * without a query reaches none. The query and hash are shown as text beside it, and "Copy
+ * URL" copies the whole address, for whoever wants that exact state and opens it knowingly.
+ *
+ * **A one-shot PATH is not linked at all** — the kit's `/join`, `/register`,
+ * `/verify-email`, `/reset-password` (`/reset-password/<token>` carries it in the path),
+ * and the app's `pageLinkExclude` on top: shown as text with Copy.
+ *
+ * @internal Not part of `/feedback` or the barrel.
+ */
+/** The kit's one-shot routes: the invitation accepts and the two token pages. */
+export declare const FEEDBACK_ONE_SHOT_PAGES: readonly PathPattern[];
+/** Whether `href` (a path, with or without its query) names a one-shot route — the kit's,
+ *  or one of the app's `exclude` on top. Read as the ROUTER reads it, decoded and
+ *  case-insensitive: `/Join?token=` and `/j%6Fin?token=` render `/join` too (0.52 code
+ *  review, this file). */
+export declare function isOneShotPage(href: string, exclude?: readonly PathPattern[]): boolean;
+/** The page a report was filed on, read once — the URL cell and the detail each parsed it
+ *  three times, once per part (0.52 code review, feedback-table.tsx: 810 `URL`s per render
+ *  of a 270-row inbox, for one column). */
+export interface FeedbackPage {
+    /** The path: what the URL column shows, and the only part ever linked. */
+    path: string;
+    /** Path + query + hash: the page as the reporter had it (keksdose `localHref`: the query
+     *  and hash carry the state, `?tab=import`, a drill-down) — shown, never followed. */
+    href: string;
+    /** What "Copy URL" copies: the FULL `context.url` as the reporter's browser had it —
+     *  origin included, the one part that says which copy of the app it was (feedback
+     *  #278) — else `context.route`. */
+    url: string;
+}
+/** `context.url`, else `context.route`, parsed — or null when neither is set or the value
+ *  is no http(s) address or path (a `javascript:` value is not a page). */
+export declare function feedbackPage(context: FeedbackContext | null | undefined): FeedbackPage | null;
+/** Where a click on the page goes: its path, or `null` — show it as text — when that path
+ *  is one-shot. */
+export declare function feedbackPageLinkTarget(page: FeedbackPage, exclude?: readonly PathPattern[]): string | null;