@boost33/ui 0.4.1 → 0.5.0

package/dist/components/ProductMark/ProductMark.js

@@ -1,44 +1,47 @@
-import { jsxs as o, jsx as r, Fragment as l } from "react/jsx-runtime";
-import { useId as a } from "react";
+import { jsxs as t, jsx as r, Fragment as n } from "react/jsx-runtime";
+import { useId as k } from "react";
 import i from "./ProductMark.module.css.js";
-const k = 20, x = ["wallet", "boostscore", "boostvoice", "boostoutbound"], f = {
+const x = 20, f = ["wallet", "boostscore", "boostvoice", "boostoutbound"], y = {
   // A credit card with its magnetic stripe: an outline card (fill none, so the
   // tile shows through) plus a filled stripe across it.
-  wallet: /* @__PURE__ */ o(l, { children: [
+  wallet: /* @__PURE__ */ t(n, { children: [
     /* @__PURE__ */ r("rect", { x: "5", y: "10", width: "30", height: "20", rx: "4", fill: "none", stroke: "currentColor", strokeWidth: "3" }),
     /* @__PURE__ */ r("rect", { x: "5", y: "16", width: "30", height: "5", fill: "currentColor" })
   ] }),
   // A gauge with the needle swung high: an arc, the needle, and the hub it
   // pivots on. Arc and needle stroke at width 4 with round caps.
-  boostscore: /* @__PURE__ */ o(l, { children: [
+  boostscore: /* @__PURE__ */ t(n, { children: [
     /* @__PURE__ */ r("path", { d: "M6 26 A14 14 0 0 1 34 26", fill: "none", stroke: "currentColor", strokeWidth: "4", strokeLinecap: "round" }),
     /* @__PURE__ */ r("line", { x1: "20", y1: "26", x2: "28", y2: "14", stroke: "currentColor", strokeWidth: "4", strokeLinecap: "round" }),
     /* @__PURE__ */ r("circle", { cx: "20", cy: "26", r: "3", fill: "currentColor" })
   ] }),
   // A soundwave, tall in the middle: three pill bars, all centred on y=20.
-  boostvoice: /* @__PURE__ */ o(l, { children: [
+  boostvoice: /* @__PURE__ */ t(n, { children: [
     /* @__PURE__ */ r("rect", { x: "6", y: "14", width: "7", height: "12", rx: "3.5", fill: "currentColor" }),
     /* @__PURE__ */ r("rect", { x: "16.5", y: "4", width: "7", height: "32", rx: "3.5", fill: "currentColor" }),
     /* @__PURE__ */ r("rect", { x: "27", y: "14", width: "7", height: "12", rx: "3.5", fill: "currentColor" })
   ] }),
   // An arrow leaving through the top-right: the shaft and the elbow of its head,
   // both stroke width 4 with round caps and joins.
-  boostoutbound: /* @__PURE__ */ o(l, { children: [
+  boostoutbound: /* @__PURE__ */ t(n, { children: [
     /* @__PURE__ */ r("line", { x1: "8", y1: "32", x2: "32", y2: "8", stroke: "currentColor", strokeWidth: "4", strokeLinecap: "round", strokeLinejoin: "round" }),
     /* @__PURE__ */ r("path", { d: "M16 8 H32 V24", fill: "none", stroke: "currentColor", strokeWidth: "4", strokeLinecap: "round", strokeLinejoin: "round" })
   ] })
 };
-function y(t) {
-  return x.includes(t);
+function h(o) {
+  return f.includes(o);
 }
-function v({ slug: t, size: n = k, muted: u, title: c, className: d }) {
-  const s = a(), e = c == null, h = y(t) ? f[t] : null;
-  return /* @__PURE__ */ o(
+function v(o) {
+  return h(o);
+}
+function C({ slug: o, size: l = x, muted: a, title: c, className: d }) {
+  const s = k(), e = c == null, u = h(o) ? y[o] : null;
+  return /* @__PURE__ */ t(
     "svg",
     {
       className: d != null ? `${i.mark} ${d}` : i.mark,
-      width: n,
-      height: n,
+      width: l,
+      height: l,
       viewBox: "0 0 40 40",
       role: e ? void 0 : "img",
       "aria-hidden": e ? "true" : void 0,
@@ -51,15 +54,15 @@ function v({ slug: t, size: n = k, muted: u, title: c, className: d }) {
             className: i.ground,
             width: "40",
             height: "40",
-            style: { fill: u ? "var(--color-neutral-300)" : "var(--color-neutral-950)" }
+            style: { fill: a ? "var(--color-neutral-300)" : "var(--color-neutral-950)" }
           }
         ),
-        h && /* @__PURE__ */ r(
+        u && /* @__PURE__ */ r(
           "g",
           {
             transform: "translate(10 10) scale(0.5)",
             style: { color: "var(--color-primary-foreground)" },
-            children: h
+            children: u
           }
         )
       ]
@@ -67,7 +70,8 @@ function v({ slug: t, size: n = k, muted: u, title: c, className: d }) {
   );
 }
 export {
-  x as PRODUCT_SLUGS,
-  v as ProductMark
+  f as PRODUCT_SLUGS,
+  C as ProductMark,
+  v as hasProductMark
 };
 //# sourceMappingURL=ProductMark.js.map

package/dist/components/ProductMark/ProductMark.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProductMark.js","sources":["../../../src/components/ProductMark/ProductMark.tsx"],"sourcesContent":["import { useId, type ReactNode } from 'react'\nimport styles from './ProductMark.module.css'\n\n/**\n * The size the mark renders at unless a caller says otherwise. 20px is the\n * Wallet's own default at its call sites, and the size the four\n * tests/baselines/productmark-*.png were captured at: a 20px tile in the 24px\n * gutter the specimen crop uses either side -> 68px CSS -> 136 device px at\n * deviceScaleFactor 2. Changing it moves four apps.\n *\n * There is deliberately no minimum-legible floor here, unlike Boost33Mark. That\n * floor is the monogram's alone -- the bowls of the B close up below ~20px. The\n * product marks have the opposite property: each is one path on a 40-unit grid\n * with a quarter-side corner, chosen so it renders correctly from Paper's 96px\n * down to 20px. Do not generalise Boost33Mark's floor into a shared rule.\n */\nconst DEFAULT_SIZE = 20\n\n/**\n * The slugs this package draws a product mark for, as one list. Everything else\n * keys off it: ProductSlug is derived from it, and GLYPHS is typed against it so\n * adding a slug without artwork is a compile error rather than a mark that\n * silently draws nothing.\n *\n * **It is no longer the whole of Identity's registry, and the difference is\n * deliberate.** Identity serves five slugs: these four plus `brokers` (B33-1158,\n * \"Boost Brokers\"). This package has no `brokers` glyph, so that row draws the\n * bare tile through the safe degrade below -- see \"The fifth slug\" underneath.\n *\n * **Transcribed from `boost33-identity/src/lib/productRegistry.ts`** -- its\n * `REGISTRY_SLUGS`, which is `PRODUCTS` from `src/config/products.ts` plus\n * `WALLET_SLUG`. That file is the source of truth and this is a copy of it in\n * another repository, which is a thing that drifts. It already did: until\n * B33-1043 this list read `wallet | score | voice | outbound` while this comment\n * asserted it was Identity's, so three of the four rows of a switcher fed\n * straight from `GET /api/v1/products` drew the bare tile (see `slug` below) and\n * nothing anywhere failed.\n *\n * Identity is not the side that renames. ADR-0003 records the shorter slugs as\n * considered and rejected: these match the `?app=` keys live campaign URLs\n * already carry, so renaming them means those links grant nothing on sign-up.\n *\n * `tests/product-mark.test.tsx` pins this list against a second transcription of\n * the same source, so the two repositories cannot part company in silence again.\n * That pin is what the old comment's assertion was standing in for, and it now\n * pins the gap as well as the overlap: it names `brokers` as the one served slug\n * with no glyph here, so a *sixth* product, or artwork landing for this one,\n * fails rather than passing quietly.\n *\n * The *order* is this package's own and not Identity's -- `REGISTRY_SLUGS` ends\n * with `wallet` where this begins with it. Nothing reads a render order off this\n * list: a switcher draws the order its consumer was served (`AppSwitcher`), and\n * the only thing this order sets is the left-to-right run of frames in the\n * ProductMark specimen.\n *\n * ── The fifth slug ───────────────────────────────────────────────────────────\n *\n * **`brokers` is absent because no Brokers artwork exists to lift, not because\n * nobody got to it.** The four glyphs below were taken verbatim out of\n * `boostledger/src/ui/primitives/icons.tsx`, whose own `GLYPHS` is typed\n * `Record<ProductName, ReactNode>` over exactly four display names. There is no\n * Brokers mark in that file, none in `boost33-brand-hub`, and none in this\n * repository. The hub renders the product as a text quick-link and no mark at\n * all.\n *\n * So drawing one here would not be transcribing a mark, it would be inventing\n * one -- and the comment on GLYPHS below records what that costs: PR #4 redrew\n * all four from a written description, got all four wrong, and reintroduced the\n * retired one-orange-element construction. An invented fifth mark is worse than\n * that was, because it has nothing to be caught against. A human captures the\n * first baseline at the fidelity gate, which would make the invention the\n * referent, and it looks equally settled either way afterwards (CLAUDE.md, \"an\n * agent that picks one and builds it has invented a referent\").\n *\n * The degrade is also the mildest it will ever be. Identity serves `brokers` as\n * `live: false` -- the space is still being built -- so the switcher row carries\n * the \"Soon\" tag beside the bare tile, which reads as a product that has not\n * arrived rather than as a drawing that failed to load. That stops being true\n * the day Brokers ships.\n *\n * **To close it:** get the mark drawn where the other four live\n * (`boostledger/src/ui/primitives/icons.tsx`), lift it here verbatim, add\n * `brokers` to this list, and let a human approve `productmark-brokers.png` at a\n * gate. Not in that order optional: this list is what GLYPHS is typed against,\n * so adding the slug without the artwork stops the build, which is the one part\n * of this that cannot go wrong quietly.\n */\nexport const PRODUCT_SLUGS = ['wallet', 'boostscore', 'boostvoice', 'boostoutbound'] as const\n\n/** One of the slugs this package draws a mark for. Not every slug Identity serves -- see above. */\nexport type ProductSlug = (typeof PRODUCT_SLUGS)[number]\n\n/**\n * The four product glyphs, lifted verbatim from `boostledger`'s\n * `src/ui/primitives/icons.tsx` (the `GLYPHS` record, as of `837d85d`) rather\n * than redrawn from any written description. Redrawing them from\n * `docs/mintlify/system/product-marks.mdx` is how PR #4 got all four wrong and\n * reintroduced the retired one-orange-element construction; if any document\n * disagrees with that file, that file wins. See B33-562.\n *\n * Each glyph is drawn on its own full 40-unit grid and inset into the middle 20\n * of the tile by the `translate(10 10) scale(0.5)` group below. The stroke\n * widths are right on that grid -- do not \"correct\" them to compensate for the\n * scale, the scale is what puts the stroke at the weight Paper draws. Every\n * element paints in `currentColor` (the tile's white glyph ink) or `none`;\n * there is no colour of any kind in here, which is what tells the four marks\n * apart by shape and never by hue.\n *\n * Typing this `Record<ProductSlug, ReactNode>` is load-bearing: a fifth slug\n * added to PRODUCT_SLUGS without a glyph here stops the build.\n */\nconst GLYPHS: Record<ProductSlug, ReactNode> = {\n  // A credit card with its magnetic stripe: an outline card (fill none, so the\n  // tile shows through) plus a filled stripe across it.\n  wallet: (\n    <>\n      <rect x=\"5\" y=\"10\" width=\"30\" height=\"20\" rx=\"4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"3\" />\n      <rect x=\"5\" y=\"16\" width=\"30\" height=\"5\" fill=\"currentColor\" />\n    </>\n  ),\n  // A gauge with the needle swung high: an arc, the needle, and the hub it\n  // pivots on. Arc and needle stroke at width 4 with round caps.\n  boostscore: (\n    <>\n      <path d=\"M6 26 A14 14 0 0 1 34 26\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" />\n      <line x1=\"20\" y1=\"26\" x2=\"28\" y2=\"14\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" />\n      <circle cx=\"20\" cy=\"26\" r=\"3\" fill=\"currentColor\" />\n    </>\n  ),\n  // A soundwave, tall in the middle: three pill bars, all centred on y=20.\n  boostvoice: (\n    <>\n      <rect x=\"6\" y=\"14\" width=\"7\" height=\"12\" rx=\"3.5\" fill=\"currentColor\" />\n      <rect x=\"16.5\" y=\"4\" width=\"7\" height=\"32\" rx=\"3.5\" fill=\"currentColor\" />\n      <rect x=\"27\" y=\"14\" width=\"7\" height=\"12\" rx=\"3.5\" fill=\"currentColor\" />\n    </>\n  ),\n  // An arrow leaving through the top-right: the shaft and the elbow of its head,\n  // both stroke width 4 with round caps and joins.\n  boostoutbound: (\n    <>\n      <line x1=\"8\" y1=\"32\" x2=\"32\" y2=\"8\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n      <path d=\"M16 8 H32 V24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n    </>\n  ),\n}\n\nfunction isProductSlug(slug: string): slug is ProductSlug {\n  return (PRODUCT_SLUGS as readonly string[]).includes(slug)\n}\n\nexport interface ProductMarkProps {\n  /**\n   * Identity's product slug. An unknown one -- a product the served registry\n   * carries but this package has no artwork for yet -- draws the bare tile\n   * rather than throwing (ADR-0003's safe degrade), so the registry can run\n   * ahead of a mark release.\n   */\n  slug: string\n  /** Rendered width and height in px. Defaults to 20, the Wallet's own default. */\n  size?: number\n  /**\n   * Dims the tile for a product the account is not entitled to -- the switcher's\n   * unowned rows need it. It swaps the **ground only**, to --color-neutral-300;\n   * the glyph stays white. Fading the glyph too would cost the shape the one\n   * thing telling the four marks apart, and it is a prop rather than a wrapper\n   * `opacity-40 grayscale` filter because that lands on a mid-grey visibly\n   * darker than the grey Paper draws.\n   *\n   * **Only use this where the mark is decorative.** White on --color-neutral-300\n   * is 1.41:1, well under WCAG 1.4.11's 3:1, and the reason that is not a defect\n   * is that the criterion covers graphics *required to understand the content* --\n   * which this is not, while the mark is `aria-hidden`, the product's name sits\n   * beside it as text, and entitlement is additionally stated in words (the\n   * switcher's \"Not on plan\" tag). Combining `muted` with `title`, so the mark\n   * stands alone as the sole carrier of a product's identity, removes every one\n   * of those and makes the ratio bite. That combination is out of contract; no\n   * call site in this package uses it. See ADR-0012, which also records why the\n   * ground is not darkened and what to reach for if this is ever revisited.\n   */\n  muted?: boolean\n  /**\n   * An accessible name. Omit it -- the default -- and the mark is decorative:\n   * `aria-hidden`, contributing nothing to the accessibility tree. That is the\n   * right answer in the switcher, where the product's name sits beside it and a\n   * name here would only make a screen reader say it twice. Pass one only where\n   * the mark stands alone as the sole carrier of meaning.\n   *\n   * Passing this is what takes the mark out of `muted`'s contract -- see the\n   * note there. A mark that carries meaning on its own has to be legible on its\n   * own, and the muted ground is not.\n   */\n  title?: string\n  /** Escape hatch for a consumer that needs to position the mark. */\n  className?: string\n}\n\n/**\n * The tile-and-glyph mark for one Boost33 product -- a rounded --color-neutral-950\n * square with the product's glyph in --color-primary-foreground. The four marks\n * share one palette and are told apart by shape alone; there is zero brand\n * orange in any of them.\n */\nexport function ProductMark({ slug, size = DEFAULT_SIZE, muted, title, className }: ProductMarkProps) {\n  const titleId = useId()\n  const decorative = title == null\n  const glyph = isProductSlug(slug) ? GLYPHS[slug] : null\n\n  return (\n    <svg\n      className={className != null ? `${styles.mark} ${className}` : styles.mark}\n      width={size}\n      height={size}\n      viewBox=\"0 0 40 40\"\n      role={decorative ? undefined : 'img'}\n      aria-hidden={decorative ? 'true' : undefined}\n      aria-labelledby={decorative ? undefined : titleId}\n    >\n      {!decorative && <title id={titleId}>{title}</title>}\n      {/* The tile. Fill set inline, next to the muted decision that chooses it;\n          the corner radius comes from the class (see ProductMark.module.css). */}\n      <rect\n        className={styles.ground}\n        width=\"40\"\n        height=\"40\"\n        style={{ fill: muted ? 'var(--color-neutral-300)' : 'var(--color-neutral-950)' }}\n      />\n      {glyph && (\n        <g\n          transform=\"translate(10 10) scale(0.5)\"\n          style={{ color: 'var(--color-primary-foreground)' }}\n        >\n          {glyph}\n        </g>\n      )}\n    </svg>\n  )\n}\n"],"names":["DEFAULT_SIZE","PRODUCT_SLUGS","GLYPHS","jsxs","Fragment","jsx","isProductSlug","slug","ProductMark","size","muted","title","className","titleId","useId","decorative","glyph","styles"],"mappings":"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"}
+{"version":3,"file":"ProductMark.js","sources":["../../../src/components/ProductMark/ProductMark.tsx"],"sourcesContent":["import { useId, type ReactNode } from 'react'\nimport styles from './ProductMark.module.css'\n\n/**\n * The size the mark renders at unless a caller says otherwise. 20px is the\n * Wallet's own default at its call sites, and the size the four\n * tests/baselines/productmark-*.png were captured at: a 20px tile in the 24px\n * gutter the specimen crop uses either side -> 68px CSS -> 136 device px at\n * deviceScaleFactor 2. Changing it moves four apps.\n *\n * There is deliberately no minimum-legible floor here, unlike Boost33Mark. That\n * floor is the monogram's alone -- the bowls of the B close up below ~20px. The\n * product marks have the opposite property: each is one path on a 40-unit grid\n * with a quarter-side corner, chosen so it renders correctly from Paper's 96px\n * down to 20px. Do not generalise Boost33Mark's floor into a shared rule.\n */\nconst DEFAULT_SIZE = 20\n\n/**\n * The slugs this package draws a product mark for, as one list. Everything else\n * keys off it: ProductSlug is derived from it, and GLYPHS is typed against it so\n * adding a slug without artwork is a compile error rather than a mark that\n * silently draws nothing.\n *\n * **Module-internal since B33-1269, and it has to stay that way.** `src/index.ts`\n * publishes `hasProductMark` below and neither this list nor `ProductSlug`. A\n * `const` assertion over four strings made an artwork inventory part of the\n * published type contract: a consumer could write `Record<ProductSlug, ...>` or\n * switch exhaustively over it, and then artwork landing for a fifth product --\n * the thing this package exists to ship -- would be a breaking change for them.\n * Nothing published is typed `ProductSlug` anyway; every slug prop is `string` on\n * purpose, so Identity's registry may run ahead of a mark release (ADR-0003, and\n * `slug` below). So the union's only real job was answering \"which slugs have\n * artwork\", and `hasProductMark` answers that without freezing the list.\n *\n * The tests and the specimen read both names by deep import, which is how\n * everything in this repo reaches into `src/`. A consumer cannot: `package.json`\n * exports `.`, `./style.css` and `./theme.css`, and nothing else.\n *\n * **It is no longer the whole of Identity's registry, and the difference is\n * deliberate.** Identity serves five slugs: these four plus `brokers` (B33-1158,\n * \"Boost Brokers\"). This package has no `brokers` glyph, so that row draws the\n * bare tile through the safe degrade below -- see \"The fifth slug\" underneath.\n *\n * **Transcribed from `boost33-identity/src/lib/productRegistry.ts`** -- its\n * `REGISTRY_SLUGS`, which is `PRODUCTS` from `src/config/products.ts` plus\n * `WALLET_SLUG`. That file is the source of truth and this is a copy of it in\n * another repository, which is a thing that drifts. It already did: until\n * B33-1043 this list read `wallet | score | voice | outbound` while this comment\n * asserted it was Identity's, so three of the four rows of a switcher fed\n * straight from `GET /api/v1/products` drew the bare tile (see `slug` below) and\n * nothing anywhere failed.\n *\n * Identity is not the side that renames. ADR-0003 records the shorter slugs as\n * considered and rejected: these match the `?app=` keys live campaign URLs\n * already carry, so renaming them means those links grant nothing on sign-up.\n *\n * `tests/product-mark.test.tsx` pins this list against a second transcription of\n * the same source, so the two repositories cannot part company in silence again.\n * That pin is what the old comment's assertion was standing in for, and it now\n * pins the gap as well as the overlap: it names `brokers` as the one served slug\n * with no glyph here, so a *sixth* product, or artwork landing for this one,\n * fails rather than passing quietly.\n *\n * The *order* is this package's own and not Identity's -- `REGISTRY_SLUGS` ends\n * with `wallet` where this begins with it. Nothing reads a render order off this\n * list: a switcher draws the order its consumer was served (`AppSwitcher`), and\n * the only thing this order sets is the left-to-right run of frames in the\n * ProductMark specimen.\n *\n * ── The fifth slug ───────────────────────────────────────────────────────────\n *\n * **`brokers` is absent because no Brokers artwork exists to lift, not because\n * nobody got to it.** The four glyphs below were taken verbatim out of\n * `boostledger/src/ui/primitives/icons.tsx`, whose own `GLYPHS` is typed\n * `Record<ProductName, ReactNode>` over exactly four display names. There is no\n * Brokers mark in that file, none in `boost33-brand-hub`, and none in this\n * repository. The hub renders the product as a text quick-link and no mark at\n * all.\n *\n * So drawing one here would not be transcribing a mark, it would be inventing\n * one -- and the comment on GLYPHS below records what that costs: PR #4 redrew\n * all four from a written description, got all four wrong, and reintroduced the\n * retired one-orange-element construction. An invented fifth mark is worse than\n * that was, because it has nothing to be caught against. A human captures the\n * first baseline at the fidelity gate, which would make the invention the\n * referent, and it looks equally settled either way afterwards (CLAUDE.md, \"an\n * agent that picks one and builds it has invented a referent\").\n *\n * The degrade is also the mildest it will ever be. Identity serves `brokers` as\n * `live: false` -- the space is still being built -- so the switcher row carries\n * the \"Soon\" tag beside the bare tile, which reads as a product that has not\n * arrived rather than as a drawing that failed to load. That stops being true\n * the day Brokers ships.\n *\n * **To close it:** get the mark drawn where the other four live\n * (`boostledger/src/ui/primitives/icons.tsx`), lift it here verbatim, add\n * `brokers` to this list, and let a human approve `productmark-brokers.png` at a\n * gate. Not in that order optional: this list is what GLYPHS is typed against,\n * so adding the slug without the artwork stops the build, which is the one part\n * of this that cannot go wrong quietly.\n *\n * **And since B33-1269 that is an ordinary addition rather than a breaking\n * change.** This list is not published, so widening it widens nothing a consumer\n * has typed against: a fifth entry adds a drawing where there was a bare tile and\n * flips `hasProductMark('brokers')` from false to true. Until then it was a\n * major-bump-shaped change to ship a picture, which is the wrong price for the\n * thing this package is for.\n */\nexport const PRODUCT_SLUGS = ['wallet', 'boostscore', 'boostvoice', 'boostoutbound'] as const\n\n/**\n * One of the slugs this package draws a mark for. Not every slug Identity serves\n * -- see above -- and not published either, for the reason recorded there. What\n * this type is for is typing GLYPHS, so the list and the artwork cannot part\n * company.\n */\nexport type ProductSlug = (typeof PRODUCT_SLUGS)[number]\n\n/**\n * The four product glyphs, lifted verbatim from `boostledger`'s\n * `src/ui/primitives/icons.tsx` (the `GLYPHS` record, as of `837d85d`) rather\n * than redrawn from any written description. Redrawing them from\n * `docs/mintlify/system/product-marks.mdx` is how PR #4 got all four wrong and\n * reintroduced the retired one-orange-element construction; if any document\n * disagrees with that file, that file wins. See B33-562.\n *\n * Each glyph is drawn on its own full 40-unit grid and inset into the middle 20\n * of the tile by the `translate(10 10) scale(0.5)` group below. The stroke\n * widths are right on that grid -- do not \"correct\" them to compensate for the\n * scale, the scale is what puts the stroke at the weight Paper draws. Every\n * element paints in `currentColor` (the tile's white glyph ink) or `none`;\n * there is no colour of any kind in here, which is what tells the four marks\n * apart by shape and never by hue.\n *\n * Typing this `Record<ProductSlug, ReactNode>` is load-bearing: a fifth slug\n * added to PRODUCT_SLUGS without a glyph here stops the build. That is why the\n * list stays a `const` assertion with a union derived from it even though\n * B33-1269 stopped publishing both -- the union moved off the package surface,\n * it did not stop existing, and `tsc --noEmit` is the check that a slug and its\n * drawing arrive together.\n */\nconst GLYPHS: Record<ProductSlug, ReactNode> = {\n  // A credit card with its magnetic stripe: an outline card (fill none, so the\n  // tile shows through) plus a filled stripe across it.\n  wallet: (\n    <>\n      <rect x=\"5\" y=\"10\" width=\"30\" height=\"20\" rx=\"4\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"3\" />\n      <rect x=\"5\" y=\"16\" width=\"30\" height=\"5\" fill=\"currentColor\" />\n    </>\n  ),\n  // A gauge with the needle swung high: an arc, the needle, and the hub it\n  // pivots on. Arc and needle stroke at width 4 with round caps.\n  boostscore: (\n    <>\n      <path d=\"M6 26 A14 14 0 0 1 34 26\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" />\n      <line x1=\"20\" y1=\"26\" x2=\"28\" y2=\"14\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" />\n      <circle cx=\"20\" cy=\"26\" r=\"3\" fill=\"currentColor\" />\n    </>\n  ),\n  // A soundwave, tall in the middle: three pill bars, all centred on y=20.\n  boostvoice: (\n    <>\n      <rect x=\"6\" y=\"14\" width=\"7\" height=\"12\" rx=\"3.5\" fill=\"currentColor\" />\n      <rect x=\"16.5\" y=\"4\" width=\"7\" height=\"32\" rx=\"3.5\" fill=\"currentColor\" />\n      <rect x=\"27\" y=\"14\" width=\"7\" height=\"12\" rx=\"3.5\" fill=\"currentColor\" />\n    </>\n  ),\n  // An arrow leaving through the top-right: the shaft and the elbow of its head,\n  // both stroke width 4 with round caps and joins.\n  boostoutbound: (\n    <>\n      <line x1=\"8\" y1=\"32\" x2=\"32\" y2=\"8\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n      <path d=\"M16 8 H32 V24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" strokeLinejoin=\"round\" />\n    </>\n  ),\n}\n\n/*\n * The narrowing half of the same question, deliberately separate from the\n * published `hasProductMark` below. A type predicate -- `slug is ProductSlug` --\n * is what lets `GLYPHS[slug]` index safely, and it is also a signature that\n * names `ProductSlug` in the emitted `.d.ts`. Publishing this one would put the\n * union back on the package surface through the back door, which is exactly what\n * B33-1269 took off it.\n */\nfunction isProductSlug(slug: string): slug is ProductSlug {\n  return (PRODUCT_SLUGS as readonly string[]).includes(slug)\n}\n\n/**\n * Does this package draw a mark for `slug`? The supported way to ask, and the\n * only thing about the artwork inventory the package publishes (B33-1269).\n *\n * **Ask this rather than matching a slug against a union of known slugs.** The\n * set of slugs with artwork is this package's inventory, not a vocabulary:\n * Identity owns which products exist (ADR-0003) and this list grows whenever a\n * drawing lands. `brokers` is the one slug Identity serves today that there is no\n * glyph here for -- see \"The fifth slug\" above. A caller that pattern-matches a\n * union is pinned to whichever inventory it compiled against; a caller that asks\n * this gets the installed version's answer, and keeps working when the next mark\n * ships.\n *\n * **A `false` is not an error and needs no guard around it.** `ProductMark`\n * renders a slug it has no glyph for as the bare tile rather than throwing\n * (ADR-0003's safe degrade), and in a switcher that row is still named, still\n * linked and still clickable -- only the glyph is missing. So do not use this to\n * filter a served registry, to hide a product's row, or to decide to substitute a\n * drawing of your own: every one of those turns a missing glyph into a missing\n * product, and the registry running ahead of the artwork is the supported state.\n *\n * It is here for a caller that needs to *know* rather than to branch on\n * rendering -- a consumer test asserting its own hardcoded fixtures still draw\n * something, or a report of which served slugs have artwork yet.\n */\nexport function hasProductMark(slug: string): boolean {\n  return isProductSlug(slug)\n}\n\nexport interface ProductMarkProps {\n  /**\n   * Identity's product slug. An unknown one -- a product the served registry\n   * carries but this package has no artwork for yet -- draws the bare tile\n   * rather than throwing (ADR-0003's safe degrade), so the registry can run\n   * ahead of a mark release.\n   */\n  slug: string\n  /** Rendered width and height in px. Defaults to 20, the Wallet's own default. */\n  size?: number\n  /**\n   * Dims the tile for a product the account is not entitled to -- the switcher's\n   * unowned rows need it. It swaps the **ground only**, to --color-neutral-300;\n   * the glyph stays white. Fading the glyph too would cost the shape the one\n   * thing telling the four marks apart, and it is a prop rather than a wrapper\n   * `opacity-40 grayscale` filter because that lands on a mid-grey visibly\n   * darker than the grey Paper draws.\n   *\n   * **Only use this where the mark is decorative.** White on --color-neutral-300\n   * is 1.41:1, well under WCAG 1.4.11's 3:1, and the reason that is not a defect\n   * is that the criterion covers graphics *required to understand the content* --\n   * which this is not, while the mark is `aria-hidden`, the product's name sits\n   * beside it as text, and entitlement is additionally stated in words (the\n   * switcher's \"Not on plan\" tag). Combining `muted` with `title`, so the mark\n   * stands alone as the sole carrier of a product's identity, removes every one\n   * of those and makes the ratio bite. That combination is out of contract; no\n   * call site in this package uses it. See ADR-0012, which also records why the\n   * ground is not darkened and what to reach for if this is ever revisited.\n   */\n  muted?: boolean\n  /**\n   * An accessible name. Omit it -- the default -- and the mark is decorative:\n   * `aria-hidden`, contributing nothing to the accessibility tree. That is the\n   * right answer in the switcher, where the product's name sits beside it and a\n   * name here would only make a screen reader say it twice. Pass one only where\n   * the mark stands alone as the sole carrier of meaning.\n   *\n   * Passing this is what takes the mark out of `muted`'s contract -- see the\n   * note there. A mark that carries meaning on its own has to be legible on its\n   * own, and the muted ground is not.\n   */\n  title?: string\n  /** Escape hatch for a consumer that needs to position the mark. */\n  className?: string\n}\n\n/**\n * The tile-and-glyph mark for one Boost33 product -- a rounded --color-neutral-950\n * square with the product's glyph in --color-primary-foreground. The four marks\n * share one palette and are told apart by shape alone; there is zero brand\n * orange in any of them.\n */\nexport function ProductMark({ slug, size = DEFAULT_SIZE, muted, title, className }: ProductMarkProps) {\n  const titleId = useId()\n  const decorative = title == null\n  const glyph = isProductSlug(slug) ? GLYPHS[slug] : null\n\n  return (\n    <svg\n      className={className != null ? `${styles.mark} ${className}` : styles.mark}\n      width={size}\n      height={size}\n      viewBox=\"0 0 40 40\"\n      role={decorative ? undefined : 'img'}\n      aria-hidden={decorative ? 'true' : undefined}\n      aria-labelledby={decorative ? undefined : titleId}\n    >\n      {!decorative && <title id={titleId}>{title}</title>}\n      {/* The tile. Fill set inline, next to the muted decision that chooses it;\n          the corner radius comes from the class (see ProductMark.module.css). */}\n      <rect\n        className={styles.ground}\n        width=\"40\"\n        height=\"40\"\n        style={{ fill: muted ? 'var(--color-neutral-300)' : 'var(--color-neutral-950)' }}\n      />\n      {glyph && (\n        <g\n          transform=\"translate(10 10) scale(0.5)\"\n          style={{ color: 'var(--color-primary-foreground)' }}\n        >\n          {glyph}\n        </g>\n      )}\n    </svg>\n  )\n}\n"],"names":["DEFAULT_SIZE","PRODUCT_SLUGS","GLYPHS","jsxs","Fragment","jsx","isProductSlug","slug","hasProductMark","ProductMark","size","muted","title","className","titleId","useId","decorative","glyph","styles"],"mappings":"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"}

package/dist/components/Sidebar/Sidebar.d.ts

@@ -1,7 +1,21 @@
 import { ReactNode } from 'react';
 export interface SidebarProps {
-    /** Names the sidebar landmark, so it stays distinct from other regions on the page. */
-    label: string;
+    /**
+     * Names the sidebar landmark, so it stays distinct from other regions on the
+     * page. It reaches `aria-label` on the `<aside>` and is **never rendered as
+     * text** -- a screen reader announces it and nobody else hears it.
+     *
+     * Spelled `landmarkLabel` rather than `label` on purpose (B33-1271). It used
+     * to be `label`, which is also what `NavSection` calls its prop -- and
+     * `NavSection`'s is the opposite thing, the visible uppercase header above the
+     * rows. `AppShell` passes both, a few lines apart, so one word named a string
+     * a person reads and a string only a screen reader hears in the same tree. A
+     * consumer who learned the convention from one component and applied it to the
+     * other shipped a visible string nobody could see, or a screen-reader-only
+     * string onto the screen. `label` stays with the visible meaning, which is the
+     * one a reader's intuition matches.
+     */
+    landmarkLabel: string;
     /** Sidebar-on-the-rail state. Narrows to the 56px rail; the pieces inside collapse themselves. */
     collapsed?: boolean;
     /**
@@ -16,4 +30,4 @@ export interface SidebarProps {
      */
     children: ReactNode;
 }
-export declare function Sidebar({ label, collapsed, children }: SidebarProps): import("react").JSX.Element;
+export declare function Sidebar({ landmarkLabel, collapsed, children }: SidebarProps): import("react").JSX.Element;

package/dist/components/Sidebar/Sidebar.js

@@ -1,14 +1,14 @@
-import { jsxs as i, jsx as t } from "react/jsx-runtime";
+import { jsxs as a, jsx as t } from "react/jsx-runtime";
 import "react";
 import { NavHeightBudgetWarning as o } from "./NavHeightBudgetWarning.js";
 import s from "./Sidebar.module.css.js";
-function p({ label: r, collapsed: a = !1, children: e }) {
-  return /* @__PURE__ */ i("aside", { className: s.sidebar, "aria-label": r, "data-collapsed": a ? "true" : void 0, children: [
+function f({ landmarkLabel: r, collapsed: e = !1, children: i }) {
+  return /* @__PURE__ */ a("aside", { className: s.sidebar, "aria-label": r, "data-collapsed": e ? "true" : void 0, children: [
     /* @__PURE__ */ t(o, { label: r }),
-    e
+    i
   ] });
 }
 export {
-  p as Sidebar
+  f as Sidebar
 };
 //# sourceMappingURL=Sidebar.js.map

package/dist/components/Sidebar/Sidebar.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.js","sources":["../../../src/components/Sidebar/Sidebar.tsx"],"sourcesContent":["import { type ReactNode } from 'react'\nimport { NavHeightBudgetWarning } from './NavHeightBudgetWarning'\nimport styles from './Sidebar.module.css'\n\nexport interface SidebarProps {\n  /** Names the sidebar landmark, so it stays distinct from other regions on the page. */\n  label: string\n  /** Sidebar-on-the-rail state. Narrows to the 56px rail; the pieces inside collapse themselves. */\n  collapsed?: boolean\n  /**\n   * What the sidebar holds -- wordmark, switcher, nav sections, wallet chip, footer. Passed in, never hardcoded.\n   *\n   * **Put the nav in a `<nav>` element that is a direct child of the sidebar.**\n   * That element is the sidebar's scroll region: a nav longer than the column\n   * scrolls inside itself, and everything above and below it -- the wordmark,\n   * the switcher, the wallet chip, the footer -- stays pinned. A nav nested\n   * inside another element does not get that, and says so in development. See\n   * ADR-0005.\n   */\n  children: ReactNode\n}\n\n// The sidebar frame: a 264px column with a hairline down its right edge,\n// collapsing to a 56px rail. It is only the container -- what stacks inside it\n// is data the consumer passes, so a product never hardcodes its own rows here.\n//\n// A Server Component: it holds no state, so a Next App Router consumer renders\n// the shell's static half without shipping it to the browser (B33-846). The one\n// piece that must run in the browser -- the development-mode nav-budget warning\n// -- is its own \"use client\" child, NavHeightBudgetWarning, which renders\n// nothing a consumer sees.\nexport function Sidebar({ label, collapsed = false, children }: SidebarProps) {\n  return (\n    <aside className={styles.sidebar} aria-label={label} data-collapsed={collapsed ? 'true' : undefined}>\n      <NavHeightBudgetWarning label={label} />\n      {children}\n    </aside>\n  )\n}\n"],"names":["Sidebar","label","collapsed","children","jsxs","styles","jsx","NavHeightBudgetWarning"],"mappings":";;;;AA+BO,SAASA,EAAQ,EAAE,OAAAC,GAAO,WAAAC,IAAY,IAAO,UAAAC,KAA0B;AAC5E,SACE,gBAAAC,EAAC,SAAA,EAAM,WAAWC,EAAO,SAAS,cAAYJ,GAAO,kBAAgBC,IAAY,SAAS,QACxF,UAAA;AAAA,IAAA,gBAAAI,EAACC,KAAuB,OAAAN,GAAc;AAAA,IACrCE;AAAA,EAAA,GACH;AAEJ;"}
+{"version":3,"file":"Sidebar.js","sources":["../../../src/components/Sidebar/Sidebar.tsx"],"sourcesContent":["import { type ReactNode } from 'react'\nimport { NavHeightBudgetWarning } from './NavHeightBudgetWarning'\nimport styles from './Sidebar.module.css'\n\nexport interface SidebarProps {\n  /**\n   * Names the sidebar landmark, so it stays distinct from other regions on the\n   * page. It reaches `aria-label` on the `<aside>` and is **never rendered as\n   * text** -- a screen reader announces it and nobody else hears it.\n   *\n   * Spelled `landmarkLabel` rather than `label` on purpose (B33-1271). It used\n   * to be `label`, which is also what `NavSection` calls its prop -- and\n   * `NavSection`'s is the opposite thing, the visible uppercase header above the\n   * rows. `AppShell` passes both, a few lines apart, so one word named a string\n   * a person reads and a string only a screen reader hears in the same tree. A\n   * consumer who learned the convention from one component and applied it to the\n   * other shipped a visible string nobody could see, or a screen-reader-only\n   * string onto the screen. `label` stays with the visible meaning, which is the\n   * one a reader's intuition matches.\n   */\n  landmarkLabel: string\n  /** Sidebar-on-the-rail state. Narrows to the 56px rail; the pieces inside collapse themselves. */\n  collapsed?: boolean\n  /**\n   * What the sidebar holds -- wordmark, switcher, nav sections, wallet chip, footer. Passed in, never hardcoded.\n   *\n   * **Put the nav in a `<nav>` element that is a direct child of the sidebar.**\n   * That element is the sidebar's scroll region: a nav longer than the column\n   * scrolls inside itself, and everything above and below it -- the wordmark,\n   * the switcher, the wallet chip, the footer -- stays pinned. A nav nested\n   * inside another element does not get that, and says so in development. See\n   * ADR-0005.\n   */\n  children: ReactNode\n}\n\n// The sidebar frame: a 264px column with a hairline down its right edge,\n// collapsing to a 56px rail. It is only the container -- what stacks inside it\n// is data the consumer passes, so a product never hardcodes its own rows here.\n//\n// A Server Component: it holds no state, so a Next App Router consumer renders\n// the shell's static half without shipping it to the browser (B33-846). The one\n// piece that must run in the browser -- the development-mode nav-budget warning\n// -- is its own \"use client\" child, NavHeightBudgetWarning, which renders\n// nothing a consumer sees.\nexport function Sidebar({ landmarkLabel, collapsed = false, children }: SidebarProps) {\n  return (\n    <aside className={styles.sidebar} aria-label={landmarkLabel} data-collapsed={collapsed ? 'true' : undefined}>\n      {/* The warning prints this to name *which* sidebar it is talking about, so\n          its prop is `label` in the developer-facing sense and stays that. */}\n      <NavHeightBudgetWarning label={landmarkLabel} />\n      {children}\n    </aside>\n  )\n}\n"],"names":["Sidebar","landmarkLabel","collapsed","children","jsxs","styles","jsx","NavHeightBudgetWarning"],"mappings":";;;;AA6CO,SAASA,EAAQ,EAAE,eAAAC,GAAe,WAAAC,IAAY,IAAO,UAAAC,KAA0B;AACpF,SACE,gBAAAC,EAAC,SAAA,EAAM,WAAWC,EAAO,SAAS,cAAYJ,GAAe,kBAAgBC,IAAY,SAAS,QAGhG,UAAA;AAAA,IAAA,gBAAAI,EAACC,GAAA,EAAuB,OAAON,EAAA,CAAe;AAAA,IAC7CE;AAAA,EAAA,GACH;AAEJ;"}

package/dist/components/WalletChip/WalletChip.d.ts

@@ -1,28 +1,36 @@
 import { WalletChipLabels } from './labels';
-export interface WalletChipProps {
-    /** Remaining granted tokens. Granted burns first and expires. */
-    granted: number;
-    /** Remaining purchased tokens. Purchased never expires. */
-    purchased: number;
-    /**
-     * The grant issued for this cycle. The denominator for "how much has burned",
-     * and so for the threshold; drawn as the bar's full width alongside purchased
-     * so the filled portion shortens as the month runs.
-     */
-    grantCycle: number;
-    /** When the current grant expires, preformatted for display, e.g. "30 Sep". */
-    grantExpires?: string;
-    /**
-     * The threshold state's runway line, preformatted, e.g. "About four days left
-     * at your current burn." Passed in rather than derived: the burn estimate is
-     * the product's to make, not the chip's -- the chip renders what it is given.
-     */
-    burnNote?: string;
-    /** The balance could not be confirmed. Renders as unknown, never as zero. */
-    unknown?: boolean;
+/**
+ * The props that say nothing about a balance, so both states take them
+ * identically: where the chip is drawn, what it is wired to, and the words and
+ * number formats it renders with.
+ */
+interface WalletChipChromeProps {
     /** The 56px rail. Abbreviates the balance and turns the split on its side. */
     collapsed?: boolean;
-    /** Top up. Wiring for the one button the sidebar is allowed to have. */
+    /**
+     * Top up. Wiring for the one button the sidebar is allowed to have.
+     *
+     * **It is also what makes that button exist.** Omit it and the chip draws no
+     * top-up affordance at all, in every state, and that is the fix B33-1270 made.
+     * The render used to be gated on `!unknown` alone, so a consumer that passed
+     * no handler got a visible control that did nothing and could not be removed
+     * -- `.topUp`'s class name is CSS-Modules-hashed, so there is no selector to
+     * reach it from outside the package.
+     *
+     * That was not hypothetical in either consumer. The Wallet passes no handler
+     * and ships the dead button today
+     * (`boostledger/src/app/(wallet)/WalletShell.tsx`), and Score wrote a whole
+     * client module to arm it across a Server Component boundary rather than live
+     * with it (`boostscore/components/app-shell/wallet-chip-top-up.tsx`, which
+     * says so at length).
+     *
+     * Nothing renders in the button's place. It carries no information of its own
+     * -- only its own affordance -- so a consumer with nowhere to send someone is
+     * better served by the chip without it than by a disabled one they did not
+     * ask for (ADR-0010, "Not entitled is not disabled", on why unavailable is not
+     * the same as disabled). B33-1047 is the other half: an `href` form of the
+     * same affordance, for a consumer that cannot pass a callback at all.
+     */
     onTopUp?: () => void;
     /**
      * The chip's user-facing strings. Every field has an English default, so a
@@ -30,10 +38,11 @@ export interface WalletChipProps {
      * French-default. The package takes no i18n dependency -- it renders what it
      * is given (B33-849).
      *
-     * Every field can be a plain string, so the whole object crosses the React
-     * Server Component boundary and a Next App Router page can build it. The four
-     * labels that carry a value mark its position with a `{placeholder}`; each
-     * also accepts a function, which only works from a Client Component (B33-880).
+     * Every field is a plain string, so the whole object crosses the React Server
+     * Component boundary and a Next App Router page can build it. The four labels
+     * that carry a value mark its position with a `%placeholder%` (B33-1277). None
+     * of them takes a function: that form only ever worked from a Client Component
+     * and nothing in the type said so (B33-880, B33-1278).
      */
     labels?: Partial<WalletChipLabels>;
     /**
@@ -57,4 +66,118 @@ export interface WalletChipProps {
      */
     locale?: string;
 }
-export declare function WalletChip({ granted, purchased, grantCycle, grantExpires, burnNote, unknown, collapsed, onTopUp, labels, locale }: WalletChipProps): import("react").JSX.Element;
+/**
+ * The chip with a balance the consumer stands behind. The two remaining figures
+ * are required, because this is the state that renders them.
+ */
+export interface WalletChipKnownProps extends WalletChipChromeProps {
+    /**
+     * Absent or `false`. The discriminant: it is what makes the figures below
+     * required here and forbidden in {@link WalletChipUnknownProps}.
+     */
+    unknown?: false;
+    /** Remaining granted tokens. Granted burns first and expires. */
+    granted: number;
+    /** Remaining purchased tokens. Purchased never expires. */
+    purchased: number;
+    /**
+     * What this cycle's grant started with, if the consumer knows. The bar's full
+     * width alongside purchased, so the part already burned draws as empty track
+     * and the filled portion shortens as the month runs.
+     *
+     * **Optional, and that is the fix B33-483 made.** It used to be required, and
+     * no consumer could satisfy it honestly: it is the Ledger's
+     * `grant_tokens_per_cycle`, and it cannot be reconstructed from a balance --
+     * `cycleUsedPct` counts purchased-bucket spend, is not `(cycle total -
+     * remaining)` once a credit, refund or void has touched the account, and is not
+     * bounded at 100. So the Wallet passed `grantCycle = granted`, which pins
+     * `burned` at 0 and held the threshold state unreachable in the reference
+     * implementation, and Score passed a local per-plan belief instead.
+     *
+     * Omitted, the bar measures against `granted + purchased` -- the balance
+     * itself. It then draws full and claims nothing about what burned, which is the
+     * honest rendering when nobody can say.
+     *
+     * It no longer decides the threshold on its own: {@link burnedFraction} does
+     * that, and this is only consulted when that is absent.
+     */
+    grantCycle?: number;
+    /**
+     * How much of the cycle's grant has burned, as a fraction -- `0.88` for 88%.
+     * Drives the threshold state, and is the figure the chip rounds into its pill.
+     *
+     * Passed in rather than derived, for exactly the reason {@link burnNote}
+     * already is: the burn is the product's measurement to make, not the chip's.
+     * The chip kept the arithmetic while taking the runway line as a prop, and fed
+     * it from a denominator no product could supply -- so the measurement was the
+     * chip's in name and nobody's in fact (B33-483).
+     *
+     * The *policy* stays here. `THRESHOLD_BURN` is 0.8 in this package, so four
+     * products trip at the same place and cannot drift to four different numbers.
+     * That is why this is a fraction and not a `threshold?: boolean`: a boolean
+     * would move the 80% decision into each consumer, and it would leave the pill
+     * with no figure to print.
+     *
+     * Supplied, it wins. Absent, the chip derives it from {@link grantCycle} as it
+     * always did; absent with no `grantCycle` either, nothing is claimed and the
+     * chip rests.
+     *
+     * It is not clamped. A consumer that passes a percentage where a fraction
+     * belongs renders a visibly absurd pill rather than a plausible "100%", and a
+     * wrong figure that looks wrong is the one that gets fixed.
+     */
+    burnedFraction?: number;
+    /** When the current grant expires, preformatted for display, e.g. "30 Sep". */
+    grantExpires?: string;
+    /**
+     * The threshold state's runway line, preformatted, e.g. "About four days left
+     * at your current burn." Passed in rather than derived: the burn estimate is
+     * the product's to make, not the chip's -- the chip renders what it is given.
+     */
+    burnNote?: string;
+}
+/**
+ * The chip whose balance could not be confirmed. It renders an em dash, no bar
+ * and no button, so **it takes no figures at all** -- each one below is
+ * `?: never`.
+ *
+ * That is deliberate and it is the second half of B33-483. The figures were
+ * required in every state, so both consumers manufactured zeroes to get past the
+ * type and then apologised for them in a comment -- "these zeroes are never
+ * rendered ... but they are not a balance and must not be read as one"
+ * (`boostscore/components/app-shell/wallet-chip.tsx`), and the same again in
+ * `wallet-slot.tsx` and `boostledger/src/app/(wallet)/layout.tsx`. A zero is a
+ * confident claim about someone's money. The type now refuses it rather than
+ * asking a comment to.
+ *
+ * `undefined` is still accepted, so a consumer that must build one props object
+ * can write `{ unknown: true, granted: undefined }` instead of branching.
+ */
+export interface WalletChipUnknownProps extends WalletChipChromeProps {
+    /** The balance could not be confirmed. Renders as unknown, never as zero. */
+    unknown: true;
+    granted?: never;
+    purchased?: never;
+    grantCycle?: never;
+    burnedFraction?: never;
+    /** Not rendered in this state: the footer only draws on a resting chip. */
+    grantExpires?: never;
+    /** Not rendered in this state: the runway line only draws past the threshold. */
+    burnNote?: never;
+}
+/**
+ * A discriminated union on `unknown`, and the discriminant has consequences for
+ * how a consumer *types* its own code, not only what it passes:
+ *
+ * - A helper that returns props for both states needs an explicit
+ *   `: WalletChipProps` return annotation. Without one, TypeScript widens the
+ *   `unknown: true` in an object literal to `boolean`, which matches neither
+ *   member, and the spread at the call site stops compiling.
+ * - `Omit<WalletChipProps, 'onTopUp'>` is not what it looks like. `Omit` over a
+ *   union flattens it into one object and loses the discrimination. Omit from
+ *   the members instead -- `Omit<WalletChipKnownProps, 'onTopUp'> |
+ *   Omit<WalletChipUnknownProps, 'onTopUp'>` -- which is why both are exported.
+ */
+export type WalletChipProps = WalletChipKnownProps | WalletChipUnknownProps;
+export declare function WalletChip({ granted, purchased, grantCycle, burnedFraction, grantExpires, burnNote, unknown, collapsed, onTopUp, labels, locale }: WalletChipProps): import("react").JSX.Element;
+export {};

package/dist/components/WalletChip/WalletChip.js

@@ -1,68 +1,71 @@
 "use client";
 import { jsxs as l, jsx as e } from "react/jsx-runtime";
 import a from "./WalletChip.module.css.js";
-import { thousandsFigure as U, formatTokens as o, DEFAULT_WALLET_LOCALE as B } from "./format.js";
-import { WalletMark as T, RetryMark as x } from "./icons.js";
-import { resolveWalletChipLabels as A } from "./labels.js";
-const R = 0.8;
-function L({ granted: r, purchased: t, cycleTotal: c, tone: m, label: h }) {
-  const i = (p) => `${p / c * 100}%`;
-  return /* @__PURE__ */ l("div", { className: a.bar, "data-tone": m, role: "img", "aria-label": h, children: [
-    /* @__PURE__ */ e("span", { className: a.segmentGranted, "data-testid": "segment-granted", style: { width: i(r) } }),
-    /* @__PURE__ */ e("span", { className: a.segmentPurchased, "data-testid": "segment-purchased", style: { width: i(t) } })
+import { thousandsFigure as A, formatTokens as m, DEFAULT_WALLET_LOCALE as M } from "./format.js";
+import { WalletMark as R, RetryMark as W } from "./icons.js";
+import { resolveWalletChipLabels as w } from "./labels.js";
+const y = 0.8, F = "var(--spacing-wallet-segment-min)";
+function g(s, r) {
+  const t = r > 0 ? s / r * 100 : 0;
+  return s <= 0 ? `${t}%` : `max(${t}%, ${F})`;
+}
+function B({ granted: s, purchased: r, cycleTotal: t, tone: h, label: o }) {
+  return /* @__PURE__ */ l("div", { className: a.bar, "data-tone": h, role: "img", "aria-label": o, children: [
+    /* @__PURE__ */ e("span", { className: a.segmentGranted, "data-testid": "segment-granted", style: { width: g(s, t) } }),
+    /* @__PURE__ */ e("span", { className: a.segmentPurchased, "data-testid": "segment-purchased", style: { width: g(r, t) } })
   ] });
 }
-function I({ granted: r, purchased: t, grantCycle: c, grantExpires: m, burnNote: h, unknown: i = !1, collapsed: p = !1, onTopUp: g, labels: y, locale: n = B }) {
-  const s = A(y), u = () => s.bar(o(r, n), o(t, n), o(r + t, n)), b = r + t, v = c + t, f = c > 0 ? (c - r) / c : 0, d = !i && f >= R;
-  if (p) {
-    const N = i ? void 0 : s.railFigure(U(b, n));
-    return /* @__PURE__ */ l("div", { className: a.rail, role: "group", "aria-label": N === void 0 ? s.railBalanceUnknown : s.railBalance(N), tabIndex: 0, children: [
-      /* @__PURE__ */ e(T, { className: a.railIcon }),
+function $({ granted: s = 0, purchased: r = 0, grantCycle: t, burnedFraction: h, grantExpires: o, burnNote: p, unknown: n = !1, collapsed: x = !1, onTopUp: u, labels: E, locale: d = M }) {
+  const i = w(E), b = () => i.bar(m(s, d), m(r, d), m(s + r, d)), v = s + r, f = (t ?? s) + r, U = t !== void 0 && t > 0 ? (t - s) / t : 0, L = h ?? U, c = !n && L >= y;
+  if (x) {
+    const N = n ? void 0 : i.railFigure(A(v, d));
+    return /* @__PURE__ */ l("div", { className: a.rail, role: "group", "aria-label": N === void 0 ? i.railBalanceUnknown : i.railBalance(N), tabIndex: 0, children: [
+      /* @__PURE__ */ e(R, { className: a.railIcon }),
       /* @__PURE__ */ e("span", { className: a.railFigure, children: N ?? "—" }),
-      i ? /* @__PURE__ */ e("span", { className: a.srOnly, children: s.railUnknown }) : /* @__PURE__ */ e(L, { granted: r, purchased: t, cycleTotal: v, tone: d ? "threshold" : "rest", label: u() })
+      n ? /* @__PURE__ */ e("span", { className: a.srOnly, children: i.railUnknown }) : /* @__PURE__ */ e(B, { granted: s, purchased: r, cycleTotal: f, tone: c ? "threshold" : "rest", label: b() })
     ] });
   }
-  return /* @__PURE__ */ l("div", { className: a.chip, role: "group", "aria-label": s.region, tabIndex: 0, "data-threshold": d ? "true" : void 0, "data-unknown": i ? "true" : void 0, children: [
+  return /* @__PURE__ */ l("div", { className: a.chip, role: "group", "aria-label": i.region, tabIndex: 0, "data-threshold": c ? "true" : void 0, "data-unknown": n ? "true" : void 0, children: [
     /* @__PURE__ */ l("div", { className: a.header, children: [
-      /* @__PURE__ */ e("span", { className: a.name, children: s.name }),
-      d && /* @__PURE__ */ l("span", { className: a.pill, children: [
-        Math.round(f * 100),
+      /* @__PURE__ */ e("span", { className: a.name, children: i.name }),
+      c && /* @__PURE__ */ l("span", { className: a.pill, children: [
+        Math.round(L * 100),
         "%"
       ] })
     ] }),
-    i ? /* @__PURE__ */ l("div", { className: a.figure, children: [
+    n ? /* @__PURE__ */ l("div", { className: a.figure, children: [
       /* @__PURE__ */ e("span", { className: a.amount, "aria-hidden": "true", children: "—" }),
-      /* @__PURE__ */ e(x, { className: a.retry }),
-      /* @__PURE__ */ e("span", { className: a.srOnly, children: s.balanceUnknown })
+      /* @__PURE__ */ e(W, { className: a.retry }),
+      /* @__PURE__ */ e("span", { className: a.srOnly, children: i.balanceUnknown })
     ] }) : /* @__PURE__ */ l("div", { className: a.figure, children: [
-      /* @__PURE__ */ e("span", { className: a.amount, children: o(b, n) }),
-      /* @__PURE__ */ e("span", { className: a.unit, children: s.unit })
+      /* @__PURE__ */ e("span", { className: a.amount, children: m(v, d) }),
+      /* @__PURE__ */ e("span", { className: a.unit, children: i.unit })
     ] }),
-    i ? /* @__PURE__ */ e("div", { className: a.bar, "data-tone": "unknown", "aria-hidden": "true" }) : /* @__PURE__ */ e(L, { granted: r, purchased: t, cycleTotal: v, tone: d ? "threshold" : "rest", label: u() }),
-    !i && !d && /* @__PURE__ */ l("div", { className: a.details, children: [
+    n ? /* @__PURE__ */ e("div", { className: a.bar, "data-tone": "unknown", "aria-hidden": "true" }) : /* @__PURE__ */ e(B, { granted: s, purchased: r, cycleTotal: f, tone: c ? "threshold" : "rest", label: b() }),
+    !n && !c && /* @__PURE__ */ l("div", { className: a.details, children: [
       /* @__PURE__ */ l("dl", { className: a.split, children: [
         /* @__PURE__ */ l("div", { className: a.splitRow, children: [
           /* @__PURE__ */ l("dt", { className: a.splitLabel, children: [
             /* @__PURE__ */ e("span", { className: a.dotGranted, "aria-hidden": "true" }),
-            s.granted
+            i.granted
           ] }),
-          /* @__PURE__ */ e("dd", { className: a.splitAmount, children: o(r, n) })
+          /* @__PURE__ */ e("dd", { className: a.splitAmount, children: m(s, d) })
         ] }),
         /* @__PURE__ */ l("div", { className: a.splitRow, children: [
           /* @__PURE__ */ l("dt", { className: a.splitLabel, children: [
             /* @__PURE__ */ e("span", { className: a.dotPurchased, "aria-hidden": "true" }),
-            s.purchased
+            i.purchased
           ] }),
-          /* @__PURE__ */ e("dd", { className: a.splitAmount, children: o(t, n) })
+          /* @__PURE__ */ e("dd", { className: a.splitAmount, children: m(r, d) })
         ] })
       ] }),
-      m && /* @__PURE__ */ e("p", { className: a.footer, children: s.grantExpiry(m) })
+      o && /* @__PURE__ */ e("p", { className: a.footer, children: i.grantExpiry(o) })
     ] }),
-    d && h && /* @__PURE__ */ e("p", { className: a.burnNote, children: h }),
-    !i && /* @__PURE__ */ e("button", { type: "button", className: a.topUp, "data-grown": d ? "true" : void 0, onClick: g, children: s.topUp })
+    c && p && /* @__PURE__ */ e("p", { className: a.burnNote, children: p }),
+    !n && u !== void 0 && /* @__PURE__ */ e("button", { type: "button", className: a.topUp, "data-grown": c ? "true" : void 0, onClick: u, children: i.topUp })
   ] });
 }
 export {
-  I as WalletChip
+  $ as WalletChip
 };
 //# sourceMappingURL=WalletChip.js.map