@boost33/ui 0.4.1 → 0.5.1

package/dist/components/WalletChip/WalletChip.module.css.js

@@ -1,56 +1,56 @@
-const t = "_chip_1th8y_37", _ = "_header_1th8y_74", n = "_name_1th8y_83", s = "_pill_1th8y_162", e = "_figure_1th8y_171", o = "_amount_1th8y_186", r = "_unit_1th8y_195", a = "_retry_1th8y_200", i = "_bar_1th8y_209", c = "_segmentGranted_1th8y_230", l = "_segmentPurchased_1th8y_231", h = "_details_1th8y_251", y = "_split_1th8y_260", d = "_splitRow_1th8y_267", p = "_splitLabel_1th8y_273", u = "_splitAmount_1th8y_281", m = "_dotGranted_1th8y_289", g = "_dotPurchased_1th8y_290", b = "_footer_1th8y_304", f = "_burnNote_1th8y_312", G = "_topUp_1th8y_87", P = "_rail_1th8y_378", w = "_railIcon_1th8y_392", A = "_railFigure_1th8y_398", F = "_srOnly_1th8y_411", I = {
+const t = "_chip_xxga2_37", _ = "_header_xxga2_74", a = "_name_xxga2_83", n = "_pill_xxga2_162", s = "_figure_xxga2_171", e = "_amount_xxga2_186", o = "_unit_xxga2_195", x = "_retry_xxga2_200", r = "_bar_xxga2_209", i = "_segmentGranted_xxga2_230", c = "_segmentPurchased_xxga2_231", l = "_details_xxga2_275", g = "_split_xxga2_284", d = "_splitRow_xxga2_291", p = "_splitLabel_xxga2_297", u = "_splitAmount_xxga2_305", m = "_dotGranted_xxga2_313", h = "_dotPurchased_xxga2_314", b = "_footer_xxga2_328", f = "_burnNote_xxga2_336", y = "_topUp_xxga2_87", G = "_rail_xxga2_402", P = "_railIcon_xxga2_416", w = "_railFigure_xxga2_422", A = "_srOnly_xxga2_435", F = {
   chip: t,
   header: _,
-  name: n,
-  pill: s,
-  figure: e,
-  amount: o,
-  unit: r,
-  retry: a,
-  bar: i,
-  segmentGranted: c,
-  segmentPurchased: l,
-  details: h,
-  split: y,
+  name: a,
+  pill: n,
+  figure: s,
+  amount: e,
+  unit: o,
+  retry: x,
+  bar: r,
+  segmentGranted: i,
+  segmentPurchased: c,
+  details: l,
+  split: g,
   splitRow: d,
   splitLabel: p,
   splitAmount: u,
   dotGranted: m,
-  dotPurchased: g,
+  dotPurchased: h,
   footer: b,
   burnNote: f,
-  topUp: G,
-  rail: P,
-  railIcon: w,
-  railFigure: A,
-  srOnly: F
+  topUp: y,
+  rail: G,
+  railIcon: P,
+  railFigure: w,
+  srOnly: A
 };
 export {
-  o as amount,
-  i as bar,
+  e as amount,
+  r as bar,
   f as burnNote,
   t as chip,
-  I as default,
-  h as details,
+  F as default,
+  l as details,
   m as dotGranted,
-  g as dotPurchased,
-  e as figure,
+  h as dotPurchased,
+  s as figure,
   b as footer,
   _ as header,
-  n as name,
-  s as pill,
-  P as rail,
-  A as railFigure,
-  w as railIcon,
-  a as retry,
-  c as segmentGranted,
-  l as segmentPurchased,
-  y as split,
+  a as name,
+  n as pill,
+  G as rail,
+  w as railFigure,
+  P as railIcon,
+  x as retry,
+  i as segmentGranted,
+  c as segmentPurchased,
+  g as split,
   u as splitAmount,
   p as splitLabel,
   d as splitRow,
-  F as srOnly,
-  G as topUp,
-  r as unit
+  A as srOnly,
+  y as topUp,
+  o as unit
 };
 //# sourceMappingURL=WalletChip.module.css.js.map

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

@@ -1,34 +1,48 @@
 /**
  * Every user-facing string the chip renders. Supplied whole -- the strings that
- * carry a value take a `{placeholder}` template (or a function) rather than
- * fragments, because word order is not a property of English and cannot be
- * reassembled on the consumer's side.
+ * carry a value take a `%placeholder%` template rather than fragments, because
+ * word order is not a property of English and cannot be reassembled on the
+ * consumer's side.
  *
- * `grantExpiry`, `railFigure`, `railBalance` and `bar` each accept two shapes.
+ * **Every field is a `string`.** `grantExpiry`, `railFigure`, `railBalance` and
+ * `bar` are templates: plain strings marking each value's position with a
+ * `%placeholder%` -- `'Granted expires %date% · burns first'`. So the whole
+ * `labels` object is data all the way down, it survives the React Server Component
+ * boundary, and a Next App Router page can build it. There is no function form:
+ * it only ever worked from a Client Component and nothing in the type said so
+ * (B33-1278). A sentence needing logic a template cannot express -- a plural rule,
+ * an `Intl.ListFormat` call -- is computed in the consumer's own catalogue, where
+ * ICU already lives, and passed here finished.
  *
- * A **template** is a plain string marking the value's position with a
- * `{placeholder}` -- `'Granted expires {date} · burns first'`. It is data all
- * the way down, so the whole `labels` object survives the React Server Component
- * boundary and a Next App Router page can pass it. **This is the recommended
- * form**, and the one the defaults use.
- *
- * A **function** of the same values still works unchanged. It is never
- * serializable, so it only reaches the chip from a Client Component, but it is
- * the escape hatch when the sentence needs logic a template cannot express --
- * ICU plurals, an `Intl.ListFormat` call.
- *
- * In a template, a `{name}` the label does not define is left exactly as written
- * -- a locale whose copy genuinely contains braces is not mangled, and a
+ * In a template, a `%name%` the label does not define is left exactly as written
+ * -- a locale whose copy genuinely pairs two percent signs is not mangled, and a
  * misspelled placeholder shows up in the rendering rather than silently
  * blanking. A placeholder a template omits is simply not rendered: a locale that
  * does not need a figure is allowed not to name it.
+ *
+ * **The delimiter is `%name%`, not `{name}`** (B33-1277). A brace is ICU
+ * MessageFormat argument syntax, so a consumer storing these templates in its own
+ * next-intl catalogue could not read them back through its own formatter. It can
+ * now. `src/fill-template.ts` carries the reasoning, including why `%{name}` and
+ * `{{name}}` would both have kept the collision. A `{braced}` name in a template
+ * is ordinary text here and is passed through untouched.
  */
 export interface WalletChipLabels {
     /** Accessible name for the expanded chip's status region. Default "Wallet balance". */
     region: string;
     /** The chip header. Default "Wallet". */
     name: string;
-    /** The unit rendered beside the figure. Default "tokens". */
+    /**
+     * The unit rendered beside the figure. Default "tokens".
+     *
+     * A single string, and so not count-dependent: a balance of one renders "1
+     * tokens" in English. That has been true since B33-849 and B33-1278 did not
+     * change it -- `unit` never had the function form, so dropping that form took
+     * nothing away here. It is also a state the chip is unlikely to reach: a
+     * one-token balance is an all-but-empty wallet. If a locale needs the unit to
+     * agree with the figure, the shape to add is a count-aware field, which is a
+     * decision and not a refactor; nothing in the package invents one meanwhile.
+     */
     unit: string;
     /** Screen-reader-only text in the figure when the balance is unknown. Default "Balance unknown". */
     balanceUnknown: string;
@@ -40,10 +54,9 @@ export interface WalletChipLabels {
      * The footer, around the preformatted expiry date. Supplied whole so the
      * consumer owns word order.
      *
-     * Placeholder: `{date}`. Default (en) `Granted expires {date} · burns first`.
-     * A function form `(date) => string` is also accepted.
+     * Placeholder: `%date%`. Default (en) `Granted expires %date% · burns first`.
      */
-    grantExpiry: string | ((date: string) => string);
+    grantExpiry: string;
     /** The top-up button. Default "Top up". */
     topUp: string;
     /**
@@ -51,8 +64,7 @@ export interface WalletChipLabels {
      * (e.g. "4.6"). Both the visible text in the 56px rail and the figure that
      * `railBalance` is given.
      *
-     * Placeholder: `{figure}`. Default (en) `{figure}k`. A function form
-     * `(figure) => string` is also accepted.
+     * Placeholder: `%figure%`. Default (en) `%figure%k`.
      *
      * The figure itself is formatted for `locale` -- "4.6" in `en-US`, "4,6" in
      * `fr-FR` -- but the mark after it is a word, and locales disagree about it:
@@ -61,14 +73,13 @@ export interface WalletChipLabels {
      * template rather than a bare suffix, because a locale is entitled to put the
      * mark somewhere other than the end (B33-876).
      */
-    railFigure: string | ((figure: string) => string);
+    railFigure: string;
     /**
      * The rail group's accessible name, around the abbreviated balance (e.g. "4.6k").
      *
-     * Placeholder: `{balance}`. Default (en) `Wallet balance {balance}`. A function
-     * form `(balance) => string` is also accepted.
+     * Placeholder: `%balance%`. Default (en) `Wallet balance %balance%`.
      */
-    railBalance: string | ((balance: string) => string);
+    railBalance: string;
     /** The rail group's accessible name when the balance is unknown. Default "Wallet balance unknown". */
     railBalanceUnknown: string;
     /** Screen-reader-only marker on the rail when the balance is unknown. Default "unknown". */
@@ -78,22 +89,25 @@ export interface WalletChipLabels {
      * whole rather than concatenated from fragments -- the shape that cannot be
      * translated at all otherwise.
      *
-     * Placeholders: `{granted}`, `{purchased}`, `{remaining}`. Default (en)
-     * `{granted} granted and {purchased} purchased of {remaining} remaining`. A
-     * function form `(granted, purchased, remaining) => string` is also accepted.
+     * Placeholders: `%granted%`, `%purchased%`, `%remaining%`. Default (en)
+     * `%granted% granted and %purchased% purchased of %remaining% remaining`.
      */
-    bar: string | ((granted: string, purchased: string, remaining: string) => string);
+    bar: string;
 }
 /**
  * The English defaults. A consumer that passes nothing renders exactly what the
  * chip rendered before this prop existed, so the wallet baselines do not move.
  *
- * **Every field is a string.** That is what makes `labels={defaultWalletChipLabels}`
- * and `labels={{ ...defaultWalletChipLabels, name: 'Portefeuille' }}` -- the
- * pattern the specimen shows and this package's own advice recommends -- legal
- * from a Server Component. The four value-carrying defaults are templates, and
- * the rendered output is character-for-character what the function defaults
- * produced (B33-880).
+ * **Every field is a string, and now by construction.** That is what makes
+ * `labels={defaultWalletChipLabels}` and
+ * `labels={{ ...defaultWalletChipLabels, name: 'Portefeuille' }}` -- the pattern
+ * the specimen shows and this package's own advice recommends -- legal from a
+ * Server Component (B33-880). It used to be a runtime fact pinned by a test,
+ * because `WalletChipLabels` admitted functions on four fields and `satisfies`
+ * could not tell the two apart (B33-1029). With the union gone the compiler
+ * carries it: a function here is a type error at the `satisfies`, and
+ * `tests/wallet-chip-labels.type-test.ts` asserts the all-strings shape of the
+ * interface itself so the guarantee cannot be lost by widening one field.
  *
  * Frozen because it is a public export reaching four products on a version bump.
  * `const` protects the binding, not the contents: without the freeze, a consumer
@@ -116,11 +130,15 @@ export declare const defaultWalletChipLabels: Readonly<{
     bar: string;
 }>;
 /**
- * The labels as the render consumes them: the four value-carrying fields
- * normalised to functions, whichever shape the consumer supplied. The component
- * calls `t.bar(…)` either way and never learns which form it was given, so the
- * union costs the render nothing -- and, in particular, the lazy call that keeps
- * a consumer's `bar` off the degraded unknown path (B33-875) still works.
+ * The labels as the render consumes them: the four templates presented as
+ * functions of their values, so the component writes `t.bar(…)` and never handles
+ * a template itself.
+ *
+ * This is internal -- it is not exported from `src/index.ts` -- and it stays a
+ * function shape now that `WalletChipLabels` holds only strings, for two reasons.
+ * The interpolation has to happen somewhere, and one site per label is the whole
+ * of it; and the call is where B33-875's laziness lives, so a label for an element
+ * that does not render is not interpolated at all.
  */
 export interface ResolvedWalletChipLabels extends Omit<WalletChipLabels, 'grantExpiry' | 'railFigure' | 'railBalance' | 'bar'> {
     grantExpiry: (date: string) => string;
@@ -130,14 +148,14 @@ export interface ResolvedWalletChipLabels extends Omit<WalletChipLabels, 'grantE
 }
 /**
  * Merge a consumer's partial `labels` onto the English defaults, treating an
- * explicitly-`undefined` field as unsupplied, and normalise the four
- * value-carrying fields to functions.
+ * explicitly-`undefined` field as unsupplied, and present the four templates as
+ * functions of their values.
  *
  * A next-intl `t('...')` returns `undefined` on a missed key, so
  * `{ name: undefined }` is what one missing translation out of thirteen looks like
  * at the call site -- it must fall back to English, not overwrite the default
- * with `undefined` and blank the header, unname the button, or crash on
- * `t.bar(...)` (B33-873). A plain object spread copies the `undefined` across; a
- * per-field skip does not.
+ * with `undefined` and blank the header, unname the button, or hand
+ * `fillTemplate` an `undefined` template (B33-873). A plain object spread copies
+ * the `undefined` across; a per-field skip does not.
  */
 export declare function resolveWalletChipLabels(labels?: Partial<WalletChipLabels>): ResolvedWalletChipLabels;

package/dist/components/WalletChip/labels.js

@@ -1,3 +1,4 @@
+import { fillTemplate as n } from "../../fill-template.js";
 const c = Object.freeze({
   region: "Wallet balance",
   name: "Wallet",
@@ -5,34 +6,28 @@ const c = Object.freeze({
   balanceUnknown: "Balance unknown",
   granted: "Granted",
   purchased: "Purchased",
-  grantExpiry: "Granted expires {date} · burns first",
+  grantExpiry: "Granted expires %date% · burns first",
   topUp: "Top up",
-  railFigure: "{figure}k",
-  railBalance: "Wallet balance {balance}",
+  railFigure: "%figure%k",
+  railBalance: "Wallet balance %balance%",
   railBalanceUnknown: "Wallet balance unknown",
   railUnknown: "unknown",
-  bar: "{granted} granted and {purchased} purchased of {remaining} remaining"
+  bar: "%granted% granted and %purchased% purchased of %remaining% remaining"
 });
-function r(t, e) {
-  return t.replace(
-    /\{(\w+)\}/g,
-    (n, a) => Object.hasOwn(e, a) ? e[a] ?? n : n
-  );
-}
-function o(t) {
-  const e = Object.fromEntries(
-    Object.entries(t ?? {}).filter(([, a]) => a !== void 0)
-  ), n = { ...c, ...e };
+function p(r) {
+  const l = Object.fromEntries(
+    Object.entries(r ?? {}).filter(([, e]) => e !== void 0)
+  ), a = { ...c, ...l };
   return {
-    ...n,
-    grantExpiry: (a) => typeof n.grantExpiry == "function" ? n.grantExpiry(a) : r(n.grantExpiry, { date: a }),
-    railFigure: (a) => typeof n.railFigure == "function" ? n.railFigure(a) : r(n.railFigure, { figure: a }),
-    railBalance: (a) => typeof n.railBalance == "function" ? n.railBalance(a) : r(n.railBalance, { balance: a }),
-    bar: (a, l, i) => typeof n.bar == "function" ? n.bar(a, l, i) : r(n.bar, { granted: a, purchased: l, remaining: i })
+    ...a,
+    grantExpiry: (e) => n(a.grantExpiry, { date: e }),
+    railFigure: (e) => n(a.railFigure, { figure: e }),
+    railBalance: (e) => n(a.railBalance, { balance: e }),
+    bar: (e, t, i) => n(a.bar, { granted: e, purchased: t, remaining: i })
   };
 }
 export {
   c as defaultWalletChipLabels,
-  o as resolveWalletChipLabels
+  p as resolveWalletChipLabels
 };
 //# sourceMappingURL=labels.js.map

package/dist/components/WalletChip/labels.js.map

@@ -1 +1 @@
-{"version":3,"file":"labels.js","sources":["../../../src/components/WalletChip/labels.ts"],"sourcesContent":["// The chip is the only component in the package that renders words. Every one\n// of them lives here as a prop with an English default, so a French-default\n// consumer (the first two are) can translate the chip without the package\n// taking an i18n dependency -- CLAUDE.md, \"a component here renders what it is\n// given\". This is the same argument grantExpires and burnNote already made,\n// applied to the strings that were still English literals in the render.\n//\n// Three of those strings carry a value, and word order is not a property of\n// English: \"Granted expires 30 Sep\" puts the date where English puts it, and a\n// translation cannot be reassembled from fragments on the consumer's side. The\n// shape that solves that and nothing else is a function -- and a function is\n// the one thing that cannot be a prop of a Client Component rendered from a\n// React Server Component. React's Flight serializer walks the whole prop graph\n// and throws on any function it finds, nested or not, in production as well as\n// in development:\n//\n//   Functions cannot be passed directly to Client Components unless you\n//   explicitly expose it by marking it with \"use server\".\n//\n// `AppShell.wallet` is a ReactNode slot, so it is the *consumer's page* that\n// constructs `<WalletChip …/>`, and a Server Component page is the default way\n// the shell is meant to be used. A labels object that cannot cross that\n// boundary is a labels object most consumers cannot pass (B33-880).\n//\n// So each of the three takes either shape. The string form spells the value's\n// position with a `{placeholder}`, which is data all the way down and crosses\n// the boundary intact; it is the form the defaults use and the form the\n// specimen and the CHANGELOG demonstrate. The function form still works\n// unchanged, for a Client Component consumer that wants a real function --\n// next-intl's ICU plurals, an Intl.ListFormat call -- and that is a consumer\n// already on the client, where functions are ordinary props.\n//\n// B33-876 added a fourth of the same kind, `railFigure`. The rail's balance is\n// a number the `locale` prop formats -- \"4.6\" or \"4,6\" -- followed by a mark\n// that is a word and not a number: English \"k\", German \"Tsd.\", and French with\n// a space in front of it that English does not have. Intl cannot supply it (its\n// own compact notation renders German four-digit balances unabbreviated, which\n// does not fit a 56px rail -- see format.ts), so it belongs here, in the same\n// template shape, for the same reason: the consumer owns where the mark goes.\n\n/**\n * Every user-facing string the chip renders. Supplied whole -- the strings that\n * carry a value take a `{placeholder}` template (or a function) rather than\n * fragments, because word order is not a property of English and cannot be\n * reassembled on the consumer's side.\n *\n * `grantExpiry`, `railFigure`, `railBalance` and `bar` each accept two shapes.\n *\n * A **template** is a plain string marking the value's position with a\n * `{placeholder}` -- `'Granted expires {date} · burns first'`. It is data all\n * the way down, so the whole `labels` object survives the React Server Component\n * boundary and a Next App Router page can pass it. **This is the recommended\n * form**, and the one the defaults use.\n *\n * A **function** of the same values still works unchanged. It is never\n * serializable, so it only reaches the chip from a Client Component, but it is\n * the escape hatch when the sentence needs logic a template cannot express --\n * ICU plurals, an `Intl.ListFormat` call.\n *\n * In a template, a `{name}` the label does not define is left exactly as written\n * -- a locale whose copy genuinely contains braces is not mangled, and a\n * misspelled placeholder shows up in the rendering rather than silently\n * blanking. A placeholder a template omits is simply not rendered: a locale that\n * does not need a figure is allowed not to name it.\n */\nexport interface WalletChipLabels {\n  /** Accessible name for the expanded chip's status region. Default \"Wallet balance\". */\n  region: string\n  /** The chip header. Default \"Wallet\". */\n  name: string\n  /** The unit rendered beside the figure. Default \"tokens\". */\n  unit: string\n  /** Screen-reader-only text in the figure when the balance is unknown. Default \"Balance unknown\". */\n  balanceUnknown: string\n  /** The granted side of the split -- granted burns first. Default \"Granted\". */\n  granted: string\n  /** The purchased side of the split -- purchased never expires. Default \"Purchased\". */\n  purchased: string\n  /**\n   * The footer, around the preformatted expiry date. Supplied whole so the\n   * consumer owns word order.\n   *\n   * Placeholder: `{date}`. Default (en) `Granted expires {date} · burns first`.\n   * A function form `(date) => string` is also accepted.\n   */\n  grantExpiry: string | ((date: string) => string)\n  /** The top-up button. Default \"Top up\". */\n  topUp: string\n  /**\n   * The rail's abbreviated balance, around the one-decimal-thousand figure\n   * (e.g. \"4.6\"). Both the visible text in the 56px rail and the figure that\n   * `railBalance` is given.\n   *\n   * Placeholder: `{figure}`. Default (en) `{figure}k`. A function form\n   * `(figure) => string` is also accepted.\n   *\n   * The figure itself is formatted for `locale` -- \"4.6\" in `en-US`, \"4,6\" in\n   * `fr-FR` -- but the mark after it is a word, and locales disagree about it:\n   * French writes \"4,6 k\" with a space, German abbreviates a thousand \"Tsd.\".\n   * So the mark is a label like every other word the chip renders, and a\n   * template rather than a bare suffix, because a locale is entitled to put the\n   * mark somewhere other than the end (B33-876).\n   */\n  railFigure: string | ((figure: string) => string)\n  /**\n   * The rail group's accessible name, around the abbreviated balance (e.g. \"4.6k\").\n   *\n   * Placeholder: `{balance}`. Default (en) `Wallet balance {balance}`. A function\n   * form `(balance) => string` is also accepted.\n   */\n  railBalance: string | ((balance: string) => string)\n  /** The rail group's accessible name when the balance is unknown. Default \"Wallet balance unknown\". */\n  railBalanceUnknown: string\n  /** Screen-reader-only marker on the rail when the balance is unknown. Default \"unknown\". */\n  railUnknown: string\n  /**\n   * The bar's accessible label, around the three preformatted figures. Assembled\n   * whole rather than concatenated from fragments -- the shape that cannot be\n   * translated at all otherwise.\n   *\n   * Placeholders: `{granted}`, `{purchased}`, `{remaining}`. Default (en)\n   * `{granted} granted and {purchased} purchased of {remaining} remaining`. A\n   * function form `(granted, purchased, remaining) => string` is also accepted.\n   */\n  bar: string | ((granted: string, purchased: string, remaining: string) => string)\n}\n\n/**\n * The English defaults. A consumer that passes nothing renders exactly what the\n * chip rendered before this prop existed, so the wallet baselines do not move.\n *\n * **Every field is a string.** That is what makes `labels={defaultWalletChipLabels}`\n * and `labels={{ ...defaultWalletChipLabels, name: 'Portefeuille' }}` -- the\n * pattern the specimen shows and this package's own advice recommends -- legal\n * from a Server Component. The four value-carrying defaults are templates, and\n * the rendered output is character-for-character what the function defaults\n * produced (B33-880).\n *\n * Frozen because it is a public export reaching four products on a version bump.\n * `const` protects the binding, not the contents: without the freeze, a consumer\n * aliasing it by reference -- `const mine = defaultWalletChipLabels; mine.name =\n * 'Portefeuille'` -- would silently rename every chip in the process (B33-877).\n */\nexport const defaultWalletChipLabels = Object.freeze({\n  region: 'Wallet balance',\n  name: 'Wallet',\n  unit: 'tokens',\n  balanceUnknown: 'Balance unknown',\n  granted: 'Granted',\n  purchased: 'Purchased',\n  grantExpiry: 'Granted expires {date} · burns first',\n  topUp: 'Top up',\n  railFigure: '{figure}k',\n  railBalance: 'Wallet balance {balance}',\n  railBalanceUnknown: 'Wallet balance unknown',\n  railUnknown: 'unknown',\n  bar: '{granted} granted and {purchased} purchased of {remaining} remaining',\n} satisfies WalletChipLabels)\n\n/**\n * The labels as the render consumes them: the four value-carrying fields\n * normalised to functions, whichever shape the consumer supplied. The component\n * calls `t.bar(…)` either way and never learns which form it was given, so the\n * union costs the render nothing -- and, in particular, the lazy call that keeps\n * a consumer's `bar` off the degraded unknown path (B33-875) still works.\n */\nexport interface ResolvedWalletChipLabels\n  extends Omit<WalletChipLabels, 'grantExpiry' | 'railFigure' | 'railBalance' | 'bar'> {\n  grantExpiry: (date: string) => string\n  railFigure: (figure: string) => string\n  railBalance: (balance: string) => string\n  bar: (granted: string, purchased: string, remaining: string) => string\n}\n\n/**\n * Fill a template's `{placeholder}`s from `values`.\n *\n * A name not in `values` is left verbatim, so misspelled or deliberate braces\n * survive to the rendering rather than disappearing. The replacement runs\n * through a callback, so a `$` in a formatted figure is a `$` and not a\n * `String.prototype.replace` substitution pattern.\n */\nfunction fillTemplate(template: string, values: Record<string, string>): string {\n  return template.replace(/\\{(\\w+)\\}/g, (whole, key: string) =>\n    Object.hasOwn(values, key) ? (values[key] ?? whole) : whole,\n  )\n}\n\n/**\n * Merge a consumer's partial `labels` onto the English defaults, treating an\n * explicitly-`undefined` field as unsupplied, and normalise the four\n * value-carrying fields to functions.\n *\n * A next-intl `t('...')` returns `undefined` on a missed key, so\n * `{ name: undefined }` is what one missing translation out of thirteen looks like\n * at the call site -- it must fall back to English, not overwrite the default\n * with `undefined` and blank the header, unname the button, or crash on\n * `t.bar(...)` (B33-873). A plain object spread copies the `undefined` across; a\n * per-field skip does not.\n */\nexport function resolveWalletChipLabels(labels?: Partial<WalletChipLabels>): ResolvedWalletChipLabels {\n  const supplied = Object.fromEntries(\n    Object.entries(labels ?? {}).filter(([, value]) => value !== undefined),\n  ) as Partial<WalletChipLabels>\n  const merged = { ...defaultWalletChipLabels, ...supplied }\n  return {\n    ...merged,\n    grantExpiry: (date) =>\n      typeof merged.grantExpiry === 'function'\n        ? merged.grantExpiry(date)\n        : fillTemplate(merged.grantExpiry, { date }),\n    railFigure: (figure) =>\n      typeof merged.railFigure === 'function'\n        ? merged.railFigure(figure)\n        : fillTemplate(merged.railFigure, { figure }),\n    railBalance: (balance) =>\n      typeof merged.railBalance === 'function'\n        ? merged.railBalance(balance)\n        : fillTemplate(merged.railBalance, { balance }),\n    bar: (granted, purchased, remaining) =>\n      typeof merged.bar === 'function'\n        ? merged.bar(granted, purchased, remaining)\n        : fillTemplate(merged.bar, { granted, purchased, remaining }),\n  }\n}\n"],"names":["defaultWalletChipLabels","fillTemplate","template","values","whole","key","resolveWalletChipLabels","labels","supplied","value","merged","date","figure","balance","granted","purchased","remaining"],"mappings":"AA+IO,MAAMA,IAA0B,OAAO,OAAO;AAAA,EACnD,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,WAAW;AAAA,EACX,aAAa;AAAA,EACb,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,KAAK;AACP,CAA4B;AAyB5B,SAASC,EAAaC,GAAkBC,GAAwC;AAC9E,SAAOD,EAAS;AAAA,IAAQ;AAAA,IAAc,CAACE,GAAOC,MAC5C,OAAO,OAAOF,GAAQE,CAAG,IAAKF,EAAOE,CAAG,KAAKD,IAASA;AAAA,EAAA;AAE1D;AAcO,SAASE,EAAwBC,GAA8D;AACpG,QAAMC,IAAW,OAAO;AAAA,IACtB,OAAO,QAAQD,KAAU,EAAE,EAAE,OAAO,CAAC,CAAA,EAAGE,CAAK,MAAMA,MAAU,MAAS;AAAA,EAAA,GAElEC,IAAS,EAAE,GAAGV,GAAyB,GAAGQ,EAAA;AAChD,SAAO;AAAA,IACL,GAAGE;AAAA,IACH,aAAa,CAACC,MACZ,OAAOD,EAAO,eAAgB,aAC1BA,EAAO,YAAYC,CAAI,IACvBV,EAAaS,EAAO,aAAa,EAAE,MAAAC,GAAM;AAAA,IAC/C,YAAY,CAACC,MACX,OAAOF,EAAO,cAAe,aACzBA,EAAO,WAAWE,CAAM,IACxBX,EAAaS,EAAO,YAAY,EAAE,QAAAE,GAAQ;AAAA,IAChD,aAAa,CAACC,MACZ,OAAOH,EAAO,eAAgB,aAC1BA,EAAO,YAAYG,CAAO,IAC1BZ,EAAaS,EAAO,aAAa,EAAE,SAAAG,GAAS;AAAA,IAClD,KAAK,CAACC,GAASC,GAAWC,MACxB,OAAON,EAAO,OAAQ,aAClBA,EAAO,IAAII,GAASC,GAAWC,CAAS,IACxCf,EAAaS,EAAO,KAAK,EAAE,SAAAI,GAAS,WAAAC,GAAW,WAAAC,EAAA,CAAW;AAAA,EAAA;AAEpE;"}
+{"version":3,"file":"labels.js","sources":["../../../src/components/WalletChip/labels.ts"],"sourcesContent":["// The chip is the only component in the package that renders words. Every one\n// of them lives here as a prop with an English default, so a French-default\n// consumer (the first two are) can translate the chip without the package\n// taking an i18n dependency -- CLAUDE.md, \"a component here renders what it is\n// given\". This is the same argument grantExpires and burnNote already made,\n// applied to the strings that were still English literals in the render.\n//\n// Three of those strings carry a value, and word order is not a property of\n// English: \"Granted expires 30 Sep\" puts the date where English puts it, and a\n// translation cannot be reassembled from fragments on the consumer's side. They\n// are supplied whole, as a template that spells the value's position with a\n// `%placeholder%`.\n//\n// ── Every field is a string, and that is the whole type (B33-1278) ───────────\n//\n// Each of those three was once `string | ((…) => string)`. The function half is\n// gone, and the reason is that it could not be used by the consumers this package\n// has. A function is the one thing that cannot be a prop of a Client Component\n// rendered from a React Server Component: React's Flight serializer walks the\n// whole prop graph and throws on any function it finds, nested or not, in\n// production as well as in development:\n//\n//   Functions cannot be passed directly to Client Components unless you\n//   explicitly expose it by marking it with \"use server\".\n//\n// `WalletChip` is a client module and `AppShell.wallet` is a ReactNode slot, so\n// it is the *consumer's page* that constructs `<WalletChip …/>` -- and under the\n// App Router that page is a Server Component by default, which is how both\n// consumers render it, because reading the balance is a server read. So the\n// function half was type-legal and fatal in production for the only way anyone\n// uses the component, and nothing in the type said so: `tsc` accepted it, the dev\n// server accepted it, and it threw at serialisation time (B33-880 for the first\n// half of this, B33-1278 for the rest). Score covered the hole from outside, with\n// a runtime `typeof raw === 'string'` guard and five tests walking the prop graph,\n// because -- in its own words -- neither `tsc` nor the dev server will.\n//\n// What the function form was *for* was logic a template cannot express: ICU\n// plurals, an `Intl.ListFormat` call. That capability is not lost, it moves to\n// where ICU already lives. A consumer selecting a plural form does the selection\n// in its own catalogue and passes this package the finished sentence, which is\n// what both consumers already do with next-intl. No default label in this package\n// is count-dependent, so no default needed it (see `unit` below).\n//\n// B33-876 added a fourth of the same kind, `railFigure`. The rail's balance is\n// a number the `locale` prop formats -- \"4.6\" or \"4,6\" -- followed by a mark\n// that is a word and not a number: English \"k\", German \"Tsd.\", and French with\n// a space in front of it that English does not have. Intl cannot supply it (its\n// own compact notation renders German four-digit balances unabbreviated, which\n// does not fit a 56px rail -- see format.ts), so it belongs here, in the same\n// template shape, for the same reason: the consumer owns where the mark goes.\n\nimport { fillTemplate } from '../../fill-template'\n\n/**\n * Every user-facing string the chip renders. Supplied whole -- the strings that\n * carry a value take a `%placeholder%` template rather than fragments, because\n * word order is not a property of English and cannot be reassembled on the\n * consumer's side.\n *\n * **Every field is a `string`.** `grantExpiry`, `railFigure`, `railBalance` and\n * `bar` are templates: plain strings marking each value's position with a\n * `%placeholder%` -- `'Granted expires %date% · burns first'`. So the whole\n * `labels` object is data all the way down, it survives the React Server Component\n * boundary, and a Next App Router page can build it. There is no function form:\n * it only ever worked from a Client Component and nothing in the type said so\n * (B33-1278). A sentence needing logic a template cannot express -- a plural rule,\n * an `Intl.ListFormat` call -- is computed in the consumer's own catalogue, where\n * ICU already lives, and passed here finished.\n *\n * In a template, a `%name%` the label does not define is left exactly as written\n * -- a locale whose copy genuinely pairs two percent signs is not mangled, and a\n * misspelled placeholder shows up in the rendering rather than silently\n * blanking. A placeholder a template omits is simply not rendered: a locale that\n * does not need a figure is allowed not to name it.\n *\n * **The delimiter is `%name%`, not `{name}`** (B33-1277). A brace is ICU\n * MessageFormat argument syntax, so a consumer storing these templates in its own\n * next-intl catalogue could not read them back through its own formatter. It can\n * now. `src/fill-template.ts` carries the reasoning, including why `%{name}` and\n * `{{name}}` would both have kept the collision. A `{braced}` name in a template\n * is ordinary text here and is passed through untouched.\n */\nexport interface WalletChipLabels {\n  /** Accessible name for the expanded chip's status region. Default \"Wallet balance\". */\n  region: string\n  /** The chip header. Default \"Wallet\". */\n  name: string\n  /**\n   * The unit rendered beside the figure. Default \"tokens\".\n   *\n   * A single string, and so not count-dependent: a balance of one renders \"1\n   * tokens\" in English. That has been true since B33-849 and B33-1278 did not\n   * change it -- `unit` never had the function form, so dropping that form took\n   * nothing away here. It is also a state the chip is unlikely to reach: a\n   * one-token balance is an all-but-empty wallet. If a locale needs the unit to\n   * agree with the figure, the shape to add is a count-aware field, which is a\n   * decision and not a refactor; nothing in the package invents one meanwhile.\n   */\n  unit: string\n  /** Screen-reader-only text in the figure when the balance is unknown. Default \"Balance unknown\". */\n  balanceUnknown: string\n  /** The granted side of the split -- granted burns first. Default \"Granted\". */\n  granted: string\n  /** The purchased side of the split -- purchased never expires. Default \"Purchased\". */\n  purchased: string\n  /**\n   * The footer, around the preformatted expiry date. Supplied whole so the\n   * consumer owns word order.\n   *\n   * Placeholder: `%date%`. Default (en) `Granted expires %date% · burns first`.\n   */\n  grantExpiry: string\n  /** The top-up button. Default \"Top up\". */\n  topUp: string\n  /**\n   * The rail's abbreviated balance, around the one-decimal-thousand figure\n   * (e.g. \"4.6\"). Both the visible text in the 56px rail and the figure that\n   * `railBalance` is given.\n   *\n   * Placeholder: `%figure%`. Default (en) `%figure%k`.\n   *\n   * The figure itself is formatted for `locale` -- \"4.6\" in `en-US`, \"4,6\" in\n   * `fr-FR` -- but the mark after it is a word, and locales disagree about it:\n   * French writes \"4,6 k\" with a space, German abbreviates a thousand \"Tsd.\".\n   * So the mark is a label like every other word the chip renders, and a\n   * template rather than a bare suffix, because a locale is entitled to put the\n   * mark somewhere other than the end (B33-876).\n   */\n  railFigure: string\n  /**\n   * The rail group's accessible name, around the abbreviated balance (e.g. \"4.6k\").\n   *\n   * Placeholder: `%balance%`. Default (en) `Wallet balance %balance%`.\n   */\n  railBalance: string\n  /** The rail group's accessible name when the balance is unknown. Default \"Wallet balance unknown\". */\n  railBalanceUnknown: string\n  /** Screen-reader-only marker on the rail when the balance is unknown. Default \"unknown\". */\n  railUnknown: string\n  /**\n   * The bar's accessible label, around the three preformatted figures. Assembled\n   * whole rather than concatenated from fragments -- the shape that cannot be\n   * translated at all otherwise.\n   *\n   * Placeholders: `%granted%`, `%purchased%`, `%remaining%`. Default (en)\n   * `%granted% granted and %purchased% purchased of %remaining% remaining`.\n   */\n  bar: string\n}\n\n/**\n * The English defaults. A consumer that passes nothing renders exactly what the\n * chip rendered before this prop existed, so the wallet baselines do not move.\n *\n * **Every field is a string, and now by construction.** That is what makes\n * `labels={defaultWalletChipLabels}` and\n * `labels={{ ...defaultWalletChipLabels, name: 'Portefeuille' }}` -- the pattern\n * the specimen shows and this package's own advice recommends -- legal from a\n * Server Component (B33-880). It used to be a runtime fact pinned by a test,\n * because `WalletChipLabels` admitted functions on four fields and `satisfies`\n * could not tell the two apart (B33-1029). With the union gone the compiler\n * carries it: a function here is a type error at the `satisfies`, and\n * `tests/wallet-chip-labels.type-test.ts` asserts the all-strings shape of the\n * interface itself so the guarantee cannot be lost by widening one field.\n *\n * Frozen because it is a public export reaching four products on a version bump.\n * `const` protects the binding, not the contents: without the freeze, a consumer\n * aliasing it by reference -- `const mine = defaultWalletChipLabels; mine.name =\n * 'Portefeuille'` -- would silently rename every chip in the process (B33-877).\n */\nexport const defaultWalletChipLabels = Object.freeze({\n  region: 'Wallet balance',\n  name: 'Wallet',\n  unit: 'tokens',\n  balanceUnknown: 'Balance unknown',\n  granted: 'Granted',\n  purchased: 'Purchased',\n  grantExpiry: 'Granted expires %date% · burns first',\n  topUp: 'Top up',\n  railFigure: '%figure%k',\n  railBalance: 'Wallet balance %balance%',\n  railBalanceUnknown: 'Wallet balance unknown',\n  railUnknown: 'unknown',\n  bar: '%granted% granted and %purchased% purchased of %remaining% remaining',\n} satisfies WalletChipLabels)\n\n/**\n * The labels as the render consumes them: the four templates presented as\n * functions of their values, so the component writes `t.bar(…)` and never handles\n * a template itself.\n *\n * This is internal -- it is not exported from `src/index.ts` -- and it stays a\n * function shape now that `WalletChipLabels` holds only strings, for two reasons.\n * The interpolation has to happen somewhere, and one site per label is the whole\n * of it; and the call is where B33-875's laziness lives, so a label for an element\n * that does not render is not interpolated at all.\n */\nexport interface ResolvedWalletChipLabels\n  extends Omit<WalletChipLabels, 'grantExpiry' | 'railFigure' | 'railBalance' | 'bar'> {\n  grantExpiry: (date: string) => string\n  railFigure: (figure: string) => string\n  railBalance: (balance: string) => string\n  bar: (granted: string, purchased: string, remaining: string) => string\n}\n\n/**\n * Merge a consumer's partial `labels` onto the English defaults, treating an\n * explicitly-`undefined` field as unsupplied, and present the four templates as\n * functions of their values.\n *\n * A next-intl `t('...')` returns `undefined` on a missed key, so\n * `{ name: undefined }` is what one missing translation out of thirteen looks like\n * at the call site -- it must fall back to English, not overwrite the default\n * with `undefined` and blank the header, unname the button, or hand\n * `fillTemplate` an `undefined` template (B33-873). A plain object spread copies\n * the `undefined` across; a per-field skip does not.\n */\nexport function resolveWalletChipLabels(labels?: Partial<WalletChipLabels>): ResolvedWalletChipLabels {\n  const supplied = Object.fromEntries(\n    Object.entries(labels ?? {}).filter(([, value]) => value !== undefined),\n  ) as Partial<WalletChipLabels>\n  const merged = { ...defaultWalletChipLabels, ...supplied }\n  return {\n    ...merged,\n    grantExpiry: (date) => fillTemplate(merged.grantExpiry, { date }),\n    railFigure: (figure) => fillTemplate(merged.railFigure, { figure }),\n    railBalance: (balance) => fillTemplate(merged.railBalance, { balance }),\n    bar: (granted, purchased, remaining) => fillTemplate(merged.bar, { granted, purchased, remaining }),\n  }\n}\n"],"names":["defaultWalletChipLabels","resolveWalletChipLabels","labels","supplied","value","merged","date","fillTemplate","figure","balance","granted","purchased","remaining"],"mappings":";AA0KO,MAAMA,IAA0B,OAAO,OAAO;AAAA,EACnD,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,WAAW;AAAA,EACX,aAAa;AAAA,EACb,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,KAAK;AACP,CAA4B;AAiCrB,SAASC,EAAwBC,GAA8D;AACpG,QAAMC,IAAW,OAAO;AAAA,IACtB,OAAO,QAAQD,KAAU,EAAE,EAAE,OAAO,CAAC,CAAA,EAAGE,CAAK,MAAMA,MAAU,MAAS;AAAA,EAAA,GAElEC,IAAS,EAAE,GAAGL,GAAyB,GAAGG,EAAA;AAChD,SAAO;AAAA,IACL,GAAGE;AAAA,IACH,aAAa,CAACC,MAASC,EAAaF,EAAO,aAAa,EAAE,MAAAC,GAAM;AAAA,IAChE,YAAY,CAACE,MAAWD,EAAaF,EAAO,YAAY,EAAE,QAAAG,GAAQ;AAAA,IAClE,aAAa,CAACC,MAAYF,EAAaF,EAAO,aAAa,EAAE,SAAAI,GAAS;AAAA,IACtE,KAAK,CAACC,GAASC,GAAWC,MAAcL,EAAaF,EAAO,KAAK,EAAE,SAAAK,GAAS,WAAAC,GAAW,WAAAC,EAAA,CAAW;AAAA,EAAA;AAEtG;"}

package/dist/fill-template.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fill a template's `%placeholder%`s from `values`.
+ *
+ * A name not in `values` is left verbatim, so a misspelling, a deliberate pair
+ * of percent signs, or a `{braced}` name meant for someone else's formatter all
+ * survive to the rendering rather than disappearing. The replacement runs
+ * through a callback, so a `$` in a formatted figure is a `$` and not a
+ * `String.prototype.replace` substitution pattern.
+ */
+export declare function fillTemplate(template: string, values: Record<string, string>): string;

package/dist/fill-template.js

@@ -0,0 +1,10 @@
+function c(r, t) {
+  return r.replace(
+    /%(\w+)%/g,
+    (e, n) => Object.hasOwn(t, n) ? t[n] ?? e : e
+  );
+}
+export {
+  c as fillTemplate
+};
+//# sourceMappingURL=fill-template.js.map

package/dist/fill-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill-template.js","sources":["../src/fill-template.ts"],"sourcesContent":["/*\n * The one `%placeholder%` filler, shared by every labels module.\n *\n * Flat at `src/` root beside `anchored-overlay.ts` and `nav-height-budget.ts`,\n * the precedent for logic shared across components, and absent from\n * `src/index.ts` -- consumers get components, not helpers.\n *\n * It lived privately inside `WalletChip/labels.ts` until B33-494 needed the same\n * shape for the NotificationCenter's `%source% · %time%` line. Copying it would\n * have been the third labels module re-deciding a contract two had already\n * settled, which is exactly what B33-1007 is open about: that ticket found\n * `AppSwitcher`'s labels diverging from `WalletChip`'s in three ways while its\n * own comment claimed parity, and `CLAUDE.md` names the outcome -- \"two\n * almost-identical components is the failure mode this whole repo exists to\n * end\". A second copy of this function would be a fourth dialect of the same\n * five lines, differing the day one of them is fixed.\n *\n * ── Why the delimiter is `%name%` and not `{name}` (B33-1277) ────────────────\n *\n * It was `{name}` until B33-1277, and `{\\w+}` is *exactly* ICU MessageFormat\n * argument syntax -- the syntax next-intl, FormatJS and every other ICU-backed\n * library in the Next.js ecosystem parses. So a consumer that stores these\n * default templates in the message catalogue it already has cannot read them\n * back through the function it already uses: ICU sees `{date}`, treats it as an\n * argument it was not given, and renders an error string where the sentence\n * should be. Score had to write a second accessor around its own formatter to\n * get the raw string out (`boostscore/components/app-shell/wallet-chip.tsx`) --\n * two accessors for one label bag, split on which fields happen to carry a\n * value, with the wrong choice showing formatter output in the sidebar.\n *\n * The fix is a delimiter holding no brace at all, which rules out both spellings\n * the ticket floated:\n *\n *   - `%{date}` still holds `{date}`. ICU does not read `%` as an escape, so it\n *     parses the argument and the failure is unchanged. The ticket's aside that\n *     \"ICU ignores it\" is the one claim in it that does not hold.\n *   - `{{date}}` is worse, as the ticket itself says: `{` is not a legal first\n *     character of an ICU argument name, so such a catalogue fails to parse at\n *     all rather than spoiling one sentence.\n *\n * `%name%` also clears every other formatter a Boost33 consumer might put copy\n * through, because all of them claim the double brace: i18next, Mustache and\n * Handlebars, and Vue's, Angular's and Svelte's template syntax. And it reads as\n * one unit in a translator's editor, being delimited at both ends -- gettext's\n * `%(name)s` leaves a bare `s` against the following word, and translators drop\n * it.\n *\n * No default in this package contains a `%`, so none of its own copy can be\n * mistaken for a placeholder; and an unknown name is left verbatim (below), so a\n * locale whose prose genuinely pairs two percent signs is not mangled, and\n * neither is an ICU `{argument}` a consumer means its own formatter to fill.\n */\n\n/**\n * Fill a template's `%placeholder%`s from `values`.\n *\n * A name not in `values` is left verbatim, so a misspelling, a deliberate pair\n * of percent signs, or a `{braced}` name meant for someone else's formatter all\n * survive to the rendering rather than disappearing. The replacement runs\n * through a callback, so a `$` in a formatted figure is a `$` and not a\n * `String.prototype.replace` substitution pattern.\n */\nexport function fillTemplate(template: string, values: Record<string, string>): string {\n  return template.replace(/%(\\w+)%/g, (whole, key: string) =>\n    Object.hasOwn(values, key) ? (values[key] ?? whole) : whole,\n  )\n}\n"],"names":["fillTemplate","template","values","whole","key"],"mappings":"AA8DO,SAASA,EAAaC,GAAkBC,GAAwC;AACrF,SAAOD,EAAS;AAAA,IAAQ;AAAA,IAAY,CAACE,GAAOC,MAC1C,OAAO,OAAOF,GAAQE,CAAG,IAAKF,EAAOE,CAAG,KAAKD,IAASA;AAAA,EAAA;AAE1D;"}

package/dist/index.d.ts

@@ -6,12 +6,12 @@ export { Wordmark } from './components/Wordmark/Wordmark';
 export type { WordmarkProps } from './components/Wordmark/Wordmark';
 export { Boost33Mark, BOOST33_MARK_MIN_LEGIBLE_PX } from './components/Boost33Mark/Boost33Mark';
 export type { Boost33MarkProps } from './components/Boost33Mark/Boost33Mark';
-export { ProductMark, PRODUCT_SLUGS } from './components/ProductMark/ProductMark';
-export type { ProductMarkProps, ProductSlug } from './components/ProductMark/ProductMark';
+export { ProductMark, hasProductMark } from './components/ProductMark/ProductMark';
+export type { ProductMarkProps } from './components/ProductMark/ProductMark';
 export { NavItem } from './components/NavItem/NavItem';
 export type { NavItemProps } from './components/NavItem/NavItem';
 export { WalletChip } from './components/WalletChip/WalletChip';
-export type { WalletChipProps } from './components/WalletChip/WalletChip';
+export type { WalletChipProps, WalletChipKnownProps, WalletChipUnknownProps } from './components/WalletChip/WalletChip';
 export { defaultWalletChipLabels } from './components/WalletChip/labels';
 export type { WalletChipLabels } from './components/WalletChip/labels';
 export { TopBar } from './components/TopBar/TopBar';
@@ -24,5 +24,11 @@ export { AppSwitcher } from './components/AppSwitcher/AppSwitcher';
 export type { AppSwitcherProps, AppSwitcherProduct, AppSwitcherHub, AppSwitcherAccount, } from './components/AppSwitcher/AppSwitcher';
 export { defaultAppSwitcherLabels } from './components/AppSwitcher/labels';
 export type { AppSwitcherLabels } from './components/AppSwitcher/labels';
-export { NAV_HEIGHT_BUDGET_PX, NAV_SECTION_HEADER_PX, NAV_ITEM_PX, NAV_SECTION_GAP_PX, NAV_FOCUS_GUTTER_PX, NAV_SHELL_FIXED_PX, NAV_SHELL_PACKAGE_FIXED_PX, NAV_SHELL_CONSUMER_SLOTS_PX, checkNavHeightBudget, measureNavHeight, navContentHeight, navBudgetForViewport, } from './nav-height-budget';
+export { DotMatrixLoader } from './components/DotMatrixLoader/DotMatrixLoader';
+export type { DotMatrixLoaderProps } from './components/DotMatrixLoader/DotMatrixLoader';
+export { LaunchLoader } from './components/LaunchLoader/LaunchLoader';
+export type { LaunchLoaderProps } from './components/LaunchLoader/LaunchLoader';
+export { launchBackdropCss } from './launch-gradient';
+export type { LaunchGradientStops } from './launch-gradient';
+export { checkNavHeightBudget, navContentHeight, navBudgetForViewport } from './nav-height-budget';
 export type { NavHeightBudget, NavRowCosts, NavSectionShape } from './nav-height-budget';

package/dist/index.js

@@ -1,45 +1,42 @@
 /* empty css           */
 import { Sidebar as t } from "./components/Sidebar/Sidebar.js";
-import { NavSection as p } from "./components/NavSection/NavSection.js";
-import { Wordmark as m } from "./components/Wordmark/Wordmark.js";
-import { BOOST33_MARK_MIN_LEGIBLE_PX as S, Boost33Mark as f } from "./components/Boost33Mark/Boost33Mark.js";
-import { PRODUCT_SLUGS as N, ProductMark as x } from "./components/ProductMark/ProductMark.js";
-import { NavItem as L } from "./components/NavItem/NavItem.js";
-import { WalletChip as T } from "./components/WalletChip/WalletChip.js";
-import { defaultWalletChipLabels as l } from "./components/WalletChip/labels.js";
-import { TopBar as h } from "./components/TopBar/TopBar.js";
-import { PageHeader as I } from "./components/PageHeader/PageHeader.js";
-import { AppShell as d } from "./components/AppShell/AppShell.js";
-import { AppSwitcher as B } from "./components/AppSwitcher/AppSwitcher.js";
-import { defaultAppSwitcherLabels as c } from "./components/AppSwitcher/labels.js";
-import { NAV_FOCUS_GUTTER_PX as u, NAV_HEIGHT_BUDGET_PX as v, NAV_ITEM_PX as M, NAV_SECTION_GAP_PX as U, NAV_SECTION_HEADER_PX as n, NAV_SHELL_CONSUMER_SLOTS_PX as D, NAV_SHELL_FIXED_PX as R, NAV_SHELL_PACKAGE_FIXED_PX as k, checkNavHeightBudget as s, measureNavHeight as F, navBudgetForViewport as b, navContentHeight as w } from "./nav-height-budget.js";
+import { NavSection as a } from "./components/NavSection/NavSection.js";
+import { Wordmark as f } from "./components/Wordmark/Wordmark.js";
+import { BOOST33_MARK_MIN_LEGIBLE_PX as d, Boost33Mark as h } from "./components/Boost33Mark/Boost33Mark.js";
+import { ProductMark as l, hasProductMark as c } from "./components/ProductMark/ProductMark.js";
+import { NavItem as n } from "./components/NavItem/NavItem.js";
+import { WalletChip as L } from "./components/WalletChip/WalletChip.js";
+import { defaultWalletChipLabels as s } from "./components/WalletChip/labels.js";
+import { TopBar as S } from "./components/TopBar/TopBar.js";
+import { PageHeader as v } from "./components/PageHeader/PageHeader.js";
+import { AppShell as C } from "./components/AppShell/AppShell.js";
+import { AppSwitcher as P } from "./components/AppSwitcher/AppSwitcher.js";
+import { defaultAppSwitcherLabels as b } from "./components/AppSwitcher/labels.js";
+import { DotMatrixLoader as H } from "./components/DotMatrixLoader/DotMatrixLoader.js";
+import { LaunchLoader as W } from "./components/LaunchLoader/LaunchLoader.js";
+import { launchBackdropCss as O } from "./launch-gradient.js";
+import { checkNavHeightBudget as D, navBudgetForViewport as F, navContentHeight as G } from "./nav-height-budget.js";
 export {
-  d as AppShell,
-  B as AppSwitcher,
-  S as BOOST33_MARK_MIN_LEGIBLE_PX,
-  f as Boost33Mark,
-  u as NAV_FOCUS_GUTTER_PX,
-  v as NAV_HEIGHT_BUDGET_PX,
-  M as NAV_ITEM_PX,
-  U as NAV_SECTION_GAP_PX,
-  n as NAV_SECTION_HEADER_PX,
-  D as NAV_SHELL_CONSUMER_SLOTS_PX,
-  R as NAV_SHELL_FIXED_PX,
-  k as NAV_SHELL_PACKAGE_FIXED_PX,
-  L as NavItem,
-  p as NavSection,
-  N as PRODUCT_SLUGS,
-  I as PageHeader,
-  x as ProductMark,
+  C as AppShell,
+  P as AppSwitcher,
+  d as BOOST33_MARK_MIN_LEGIBLE_PX,
+  h as Boost33Mark,
+  H as DotMatrixLoader,
+  W as LaunchLoader,
+  n as NavItem,
+  a as NavSection,
+  v as PageHeader,
+  l as ProductMark,
   t as Sidebar,
-  h as TopBar,
-  T as WalletChip,
-  m as Wordmark,
-  s as checkNavHeightBudget,
-  c as defaultAppSwitcherLabels,
-  l as defaultWalletChipLabels,
-  F as measureNavHeight,
-  b as navBudgetForViewport,
-  w as navContentHeight
+  S as TopBar,
+  L as WalletChip,
+  f as Wordmark,
+  D as checkNavHeightBudget,
+  b as defaultAppSwitcherLabels,
+  s as defaultWalletChipLabels,
+  c as hasProductMark,
+  O as launchBackdropCss,
+  F as navBudgetForViewport,
+  G as navContentHeight
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;"}

package/dist/launch-gradient.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @deprecated Ignored since 0.5.1 (B33-1401). The launch screen is the same
+ * Boost33 background for every product, built into `LaunchLoader`, so there are
+ * no per-product stops to pass. The type stays so a consumer on `^0.5.0` that
+ * still declares its colour map keeps compiling; drop the map and stop passing
+ * it.
+ */
+export type LaunchGradientStops = readonly [string, string, string, string];
+/**
+ * The launch screen's ground as a raw CSS string, for a consumer to inline in a
+ * `<style>` block with no stylesheet request.
+ *
+ * LaunchLoader paints its own background -- black, with one orange glow --
+ * from the package stylesheet, identically on both sides of a hub-to-product
+ * navigation. This paints the one thing that can show before that stylesheet
+ * and the markup arrive: the root in the same black, so the first frame is
+ * already the screen's ground rather than white.
+ *
+ * `stops` is ignored and kept only so the 0.5.0 call shape,
+ * `launchBackdropCss(stops)` or `launchBackdropCss(stops, selector)`, still
+ * compiles; `launchBackdropCss()` is the call to write now. `selector` defaults
+ * to `html`.
+ *
+ * The `(prefers-contrast)` branch paints the same black the default does. It is
+ * redundant today and kept on purpose: it is the branch the component honours
+ * too, and keeping the output's shape means the day the two paths differ again
+ * is a value change here, not a new rule a consumer has never inlined.
+ *
+ * The selector is the one thing still interpolated. It is the caller's own
+ * literal, never served data -- the stops were the value that would have come
+ * from a registry, and they are no longer written anywhere -- so it is not
+ * checked. Do not feed it from a request.
+ */
+export declare function launchBackdropCss(
+/** @deprecated Ignored since 0.5.1. Call `launchBackdropCss()`. */
+_stops?: LaunchGradientStops, selector?: string): string;

package/dist/launch-gradient.js

@@ -0,0 +1,8 @@
+const r = "var(--color-neutral-1000,black)";
+function n(c, o = "html") {
+  return `${o}{min-height:100%;background-color:${r}}@media (prefers-contrast){${o}{background-color:${r}}}`;
+}
+export {
+  n as launchBackdropCss
+};
+//# sourceMappingURL=launch-gradient.js.map

package/dist/launch-gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-gradient.js","sources":["../src/launch-gradient.ts"],"sourcesContent":["/*\n * LaunchLoader's backdrop CSS, as text (B33-1389, B33-1401). Beside the\n * components rather than inside one, the way nav-height-budget.ts is: it\n * renders nothing, and what it assembles is CSS a consumer inlines, not copy a\n * person reads -- so it sits outside the no-hardcoded-strings scan, which reads\n * src/components for rendered words.\n */\n\n/**\n * @deprecated Ignored since 0.5.1 (B33-1401). The launch screen is the same\n * Boost33 background for every product, built into `LaunchLoader`, so there are\n * no per-product stops to pass. The type stays so a consumer on `^0.5.0` that\n * still declares its colour map keeps compiling; drop the map and stop passing\n * it.\n */\nexport type LaunchGradientStops = readonly [string, string, string, string]\n\n/*\n * The ground every launch screen is painted on: --color-neutral-1000, the\n * charte's primary black, which tokens.css reserves for \"the logo and dark\n * ground\". Written as the token with a keyword fallback, because this string is\n * inlined in the first HTML chunk precisely so it paints before any stylesheet\n * arrives -- and before one arrives, the token does not exist. `black` is the\n * same value tokens.css declares for it (tests/launch-loader.test.tsx holds the\n * two together); a keyword rather than a hex because no hex lives in src/\n * outside the token sheets (tests/guards.test.ts).\n */\nconst LAUNCH_GROUND = 'var(--color-neutral-1000,black)'\n\n/**\n * The launch screen's ground as a raw CSS string, for a consumer to inline in a\n * `<style>` block with no stylesheet request.\n *\n * LaunchLoader paints its own background -- black, with one orange glow --\n * from the package stylesheet, identically on both sides of a hub-to-product\n * navigation. This paints the one thing that can show before that stylesheet\n * and the markup arrive: the root in the same black, so the first frame is\n * already the screen's ground rather than white.\n *\n * `stops` is ignored and kept only so the 0.5.0 call shape,\n * `launchBackdropCss(stops)` or `launchBackdropCss(stops, selector)`, still\n * compiles; `launchBackdropCss()` is the call to write now. `selector` defaults\n * to `html`.\n *\n * The `(prefers-contrast)` branch paints the same black the default does. It is\n * redundant today and kept on purpose: it is the branch the component honours\n * too, and keeping the output's shape means the day the two paths differ again\n * is a value change here, not a new rule a consumer has never inlined.\n *\n * The selector is the one thing still interpolated. It is the caller's own\n * literal, never served data -- the stops were the value that would have come\n * from a registry, and they are no longer written anywhere -- so it is not\n * checked. Do not feed it from a request.\n */\nexport function launchBackdropCss(\n  /** @deprecated Ignored since 0.5.1. Call `launchBackdropCss()`. */\n  _stops?: LaunchGradientStops,\n  selector = 'html',\n): string {\n  return (\n    `${selector}{min-height:100%;background-color:${LAUNCH_GROUND}}` +\n    `@media (prefers-contrast){${selector}{background-color:${LAUNCH_GROUND}}}`\n  )\n}\n"],"names":["LAUNCH_GROUND","launchBackdropCss","_stops","selector"],"mappings":"AA2BA,MAAMA,IAAgB;AA2Bf,SAASC,EAEdC,GACAC,IAAW,QACH;AACR,SACE,GAAGA,CAAQ,qCAAqCH,CAAa,8BAChCG,CAAQ,qBAAqBH,CAAa;AAE3E;"}