@wix/web5-core 1.63.38 → 1.63.40

package/dist/cjs/errors/errorTemplates.js

@@ -6,79 +6,103 @@ exports.resolveErrorTemplate = exports.DEFAULT_ERROR_TEMPLATES = void 0;
 
 /** Icon identifiers for error templates — resolved to SVG components by the rendering component */
 
-const retryAndContactButtons = [{
-  text: 'Try Again',
+/**
+ * The eleven error types collapse into five states a shopper can act on
+ * (B2B-4615). Each state has one job, so each has one line and at most one
+ * action:
+ *
+ *   A · No answer   — llm-error-text, llm-empty-response
+ *   B · Interrupted  — 500, generic-network-error, timeout, streaming-error,
+ *                       history-load-error
+ *   C · Fresh start  — 403, 404
+ *   D · Partial      — partial-load
+ *   E · Quota        — 429
+ *
+ * `iconType` stays on every template that had one: the new design drops icons,
+ * but w5-client-circana and w5-client-feature-com still read the field and
+ * must keep the look they have.
+ */
+
+const retryButton = [{
+  text: 'Try again',
   action: 'retry',
   variant: 'cta'
-}, {
-  text: 'Contact Us',
-  variant: 'link'
 }];
+
+/** A · No answer — nothing to retry, so it offers somewhere else to go. */
+const noAnswerTemplate = {
+  title: "I can't help with that one \u2014 but I can help with these.",
+  showChips: true
+};
+
+/** B · Interrupted — the message is still there to send again. */
+const interruptedTitle = "That didn't come through. Let's try again.";
+
+/** C · Fresh start — the thread is gone; hand the conversation back. */
+const freshStartTemplate = {
+  title: "We're starting fresh \u2014 earlier messages aren't saved.",
+  showChips: true,
+  chipsLabel: 'Ask anything to pick up again'
+};
 const DEFAULT_ERROR_TEMPLATES = exports.DEFAULT_ERROR_TEMPLATES = {
-  'conversation-llm-error-text': {
-    title: "I couldn't find information about what you asked.\nTry asking about a different topic.",
-    showChips: true
-  },
-  'conversation-llm-empty-response': {
-    title: "I couldn't find information about what you asked.\nTry asking about a different topic.",
-    showChips: true
-  },
+  'conversation-llm-error-text': noAnswerTemplate,
+  'conversation-llm-empty-response': noAnswerTemplate,
   'conversation-500': {
     iconType: 'error-500',
-    title: "This page isn't available right now.",
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
   'conversation-generic-network-error': {
     iconType: 'timeout',
-    title: 'Something went wrong on our side.\nPlease try again in a moment.',
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
   'conversation-timeout': {
     iconType: 'timeout',
-    title: 'Something went wrong on our side.\nPlease try again in a moment.',
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
   'conversation-streaming-error': {
     iconType: 'streaming-error',
-    title: 'The connection dropped. Please try again.',
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
-  'conversation-404': {
-    iconType: 'not-found',
-    title: 'Page not found.\nIt happens! Let\u2019s get you back on track',
-    showChips: true,
-    chipsLabel: 'Some ideas to get you started:'
+  // Same state as the four above, deliberately not the same action: a history
+  // load fails before there is a last message, so `retry` has nothing to
+  // re-send and would sit there doing nothing.
+  'history-load-error': {
+    iconType: 'streaming-error',
+    title: interruptedTitle,
+    buttons: [{
+      text: 'Try again',
+      action: 'reload',
+      variant: 'cta'
+    }]
   },
   'conversation-403': {
     iconType: 'forbidden',
-    title: 'Welcome back.\nFor privacy, we couldn\u2019t restore previous content. Ask anything to continue.',
-    showChips: true,
-    chipsLabel: 'Some ideas to get you started:'
+    ...freshStartTemplate
   },
-  'conversation-429': {
-    iconType: 'quota-exceeded',
-    title: 'This service is currently out of quota.\nPlease try again later.',
-    buttons: [{
-      text: 'Contact Us',
-      variant: 'link'
-    }]
+  'conversation-404': {
+    iconType: 'not-found',
+    ...freshStartTemplate
   },
+  // D · Partial — an answer DID render; some of it is missing. This one is
+  // appended to the answer rather than replacing it.
   'conversation-partial-load': {
     iconType: 'partial-load',
-    title: 'Some content didn\u2019t load',
-    buttons: retryAndContactButtons
-  },
-  'history-load-error': {
-    iconType: 'streaming-error',
-    title: 'We couldn\u2019t load this conversation.',
+    title: "Some of this didn't load.",
     buttons: [{
-      text: 'New Conversation',
-      action: 'newConversation',
+      text: 'Reload',
+      action: 'reload',
       variant: 'cta'
-    }, {
-      text: 'Contact Us',
-      variant: 'link'
     }]
+  },
+  // E · Quota — waiting is the only fix, so the copy asks for time.
+  'conversation-429': {
+    iconType: 'quota-exceeded',
+    title: 'I need a minute to catch up. Try again shortly.',
+    buttons: retryButton
   }
 };
 

package/dist/cjs/errors/errorTemplates.js.map

@@ -1 +1 @@
-{"version":3,"names":["retryAndContactButtons","text","action","variant","DEFAULT_ERROR_TEMPLATES","exports","title","showChips","iconType","buttons","chipsLabel","resolveErrorTemplate","type","overrides","templates"],"sources":["../../../src/errors/errorTemplates.ts"],"sourcesContent":["import type { ConversationErrorType } from './conversationErrorTypes';\n\n/** Action identifiers for error template buttons — resolved to callbacks by the rendering component */\nexport type ErrorActionType = 'retry' | 'newConversation' | 'reload';\n\n/** Icon identifiers for error templates — resolved to SVG components by the rendering component */\nexport type ErrorIconType =\n  | 'error-500'\n  | 'timeout'\n  | 'streaming-error'\n  | 'not-found'\n  | 'forbidden'\n  | 'partial-load'\n  | 'quota-exceeded';\n\nexport interface ErrorTemplateButton {\n  text: string;\n  /** URL for navigation (renders as a link) */\n  href?: string;\n  /** Action identifier — component resolves to a callback */\n  action?: ErrorActionType;\n  variant: 'cta' | 'link';\n}\n\nexport interface ErrorTemplate {\n  title: string;\n  subtitle?: string;\n  /** Icon identifier — component resolves to an SVG */\n  iconType?: ErrorIconType;\n  buttons?: ErrorTemplateButton[];\n  showChips?: boolean;\n  chipsLabel?: string;\n}\n\nexport type ErrorTemplateOverrides = Partial<\n  Record<ConversationErrorType, ErrorTemplate>\n>;\n\nconst retryAndContactButtons: ErrorTemplateButton[] = [\n  { text: 'Try Again', action: 'retry', variant: 'cta' },\n  { text: 'Contact Us', variant: 'link' },\n];\n\nexport const DEFAULT_ERROR_TEMPLATES: Record<\n  ConversationErrorType,\n  ErrorTemplate\n> = {\n  'conversation-llm-error-text': {\n    title:\n      \"I couldn't find information about what you asked.\\nTry asking about a different topic.\",\n    showChips: true,\n  },\n  'conversation-llm-empty-response': {\n    title:\n      \"I couldn't find information about what you asked.\\nTry asking about a different topic.\",\n    showChips: true,\n  },\n  'conversation-500': {\n    iconType: 'error-500',\n    title: \"This page isn't available right now.\",\n    buttons: retryAndContactButtons,\n  },\n  'conversation-generic-network-error': {\n    iconType: 'timeout',\n    title: 'Something went wrong on our side.\\nPlease try again in a moment.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-timeout': {\n    iconType: 'timeout',\n    title: 'Something went wrong on our side.\\nPlease try again in a moment.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-streaming-error': {\n    iconType: 'streaming-error',\n    title: 'The connection dropped. Please try again.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-404': {\n    iconType: 'not-found',\n    title: 'Page not found.\\nIt happens! Let\\u2019s get you back on track',\n    showChips: true,\n    chipsLabel: 'Some ideas to get you started:',\n  },\n  'conversation-403': {\n    iconType: 'forbidden',\n    title:\n      'Welcome back.\\nFor privacy, we couldn\\u2019t restore previous content. Ask anything to continue.',\n    showChips: true,\n    chipsLabel: 'Some ideas to get you started:',\n  },\n  'conversation-429': {\n    iconType: 'quota-exceeded',\n    title: 'This service is currently out of quota.\\nPlease try again later.',\n    buttons: [{ text: 'Contact Us', variant: 'link' }],\n  },\n  'conversation-partial-load': {\n    iconType: 'partial-load',\n    title: 'Some content didn\\u2019t load',\n    buttons: retryAndContactButtons,\n  },\n  'history-load-error': {\n    iconType: 'streaming-error',\n    title: 'We couldn\\u2019t load this conversation.',\n    buttons: [\n      { text: 'New Conversation', action: 'newConversation', variant: 'cta' },\n      { text: 'Contact Us', variant: 'link' },\n    ],\n  },\n};\n\n/** Resolves the error template for a given type, merging client overrides on top of defaults */\nexport const resolveErrorTemplate = (\n  type: string,\n  overrides?: ErrorTemplateOverrides,\n): ErrorTemplate => {\n  const templates = overrides\n    ? { ...DEFAULT_ERROR_TEMPLATES, ...overrides }\n    : DEFAULT_ERROR_TEMPLATES;\n  return (\n    templates[type as ConversationErrorType] ??\n    templates['conversation-llm-error-text']\n  );\n};\n"],"mappings":";;;;AAEA;;AAGA;;AAiCA,MAAMA,sBAA6C,GAAG,CACpD;EAAEC,IAAI,EAAE,WAAW;EAAEC,MAAM,EAAE,OAAO;EAAEC,OAAO,EAAE;AAAM,CAAC,EACtD;EAAEF,IAAI,EAAE,YAAY;EAAEE,OAAO,EAAE;AAAO,CAAC,CACxC;AAEM,MAAMC,uBAGZ,GAAAC,OAAA,CAAAD,uBAAA,GAAG;EACF,6BAA6B,EAAE;IAC7BE,KAAK,EACH,wFAAwF;IAC1FC,SAAS,EAAE;EACb,CAAC;EACD,iCAAiC,EAAE;IACjCD,KAAK,EACH,wFAAwF;IAC1FC,SAAS,EAAE;EACb,CAAC;EACD,kBAAkB,EAAE;IAClBC,QAAQ,EAAE,WAAW;IACrBF,KAAK,EAAE,sCAAsC;IAC7CG,OAAO,EAAET;EACX,CAAC;EACD,oCAAoC,EAAE;IACpCQ,QAAQ,EAAE,SAAS;IACnBF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAET;EACX,CAAC;EACD,sBAAsB,EAAE;IACtBQ,QAAQ,EAAE,SAAS;IACnBF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAET;EACX,CAAC;EACD,8BAA8B,EAAE;IAC9BQ,QAAQ,EAAE,iBAAiB;IAC3BF,KAAK,EAAE,2CAA2C;IAClDG,OAAO,EAAET;EACX,CAAC;EACD,kBAAkB,EAAE;IAClBQ,QAAQ,EAAE,WAAW;IACrBF,KAAK,EAAE,+DAA+D;IACtEC,SAAS,EAAE,IAAI;IACfG,UAAU,EAAE;EACd,CAAC;EACD,kBAAkB,EAAE;IAClBF,QAAQ,EAAE,WAAW;IACrBF,KAAK,EACH,kGAAkG;IACpGC,SAAS,EAAE,IAAI;IACfG,UAAU,EAAE;EACd,CAAC;EACD,kBAAkB,EAAE;IAClBF,QAAQ,EAAE,gBAAgB;IAC1BF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAE,CAAC;MAAER,IAAI,EAAE,YAAY;MAAEE,OAAO,EAAE;IAAO,CAAC;EACnD,CAAC;EACD,2BAA2B,EAAE;IAC3BK,QAAQ,EAAE,cAAc;IACxBF,KAAK,EAAE,+BAA+B;IACtCG,OAAO,EAAET;EACX,CAAC;EACD,oBAAoB,EAAE;IACpBQ,QAAQ,EAAE,iBAAiB;IAC3BF,KAAK,EAAE,0CAA0C;IACjDG,OAAO,EAAE,CACP;MAAER,IAAI,EAAE,kBAAkB;MAAEC,MAAM,EAAE,iBAAiB;MAAEC,OAAO,EAAE;IAAM,CAAC,EACvE;MAAEF,IAAI,EAAE,YAAY;MAAEE,OAAO,EAAE;IAAO,CAAC;EAE3C;AACF,CAAC;;AAED;AACO,MAAMQ,oBAAoB,GAAGA,CAClCC,IAAY,EACZC,SAAkC,KAChB;EAClB,MAAMC,SAAS,GAAGD,SAAS,GACvB;IAAE,GAAGT,uBAAuB;IAAE,GAAGS;EAAU,CAAC,GAC5CT,uBAAuB;EAC3B,OACEU,SAAS,CAACF,IAAI,CAA0B,IACxCE,SAAS,CAAC,6BAA6B,CAAC;AAE5C,CAAC;AAACT,OAAA,CAAAM,oBAAA,GAAAA,oBAAA","ignoreList":[]}
+{"version":3,"names":["retryButton","text","action","variant","noAnswerTemplate","title","showChips","interruptedTitle","freshStartTemplate","chipsLabel","DEFAULT_ERROR_TEMPLATES","exports","iconType","buttons","resolveErrorTemplate","type","overrides","templates"],"sources":["../../../src/errors/errorTemplates.ts"],"sourcesContent":["import type { ConversationErrorType } from './conversationErrorTypes';\n\n/** Action identifiers for error template buttons — resolved to callbacks by the rendering component */\nexport type ErrorActionType = 'retry' | 'newConversation' | 'reload';\n\n/** Icon identifiers for error templates — resolved to SVG components by the rendering component */\nexport type ErrorIconType =\n  | 'error-500'\n  | 'timeout'\n  | 'streaming-error'\n  | 'not-found'\n  | 'forbidden'\n  | 'partial-load'\n  | 'quota-exceeded';\n\nexport interface ErrorTemplateButton {\n  text: string;\n  /** URL for navigation (renders as a link) */\n  href?: string;\n  /** Action identifier — component resolves to a callback */\n  action?: ErrorActionType;\n  variant: 'cta' | 'link';\n}\n\nexport interface ErrorTemplate {\n  title: string;\n  subtitle?: string;\n  /** Icon identifier — component resolves to an SVG */\n  iconType?: ErrorIconType;\n  buttons?: ErrorTemplateButton[];\n  showChips?: boolean;\n  chipsLabel?: string;\n}\n\nexport type ErrorTemplateOverrides = Partial<\n  Record<ConversationErrorType, ErrorTemplate>\n>;\n\n/**\n * The eleven error types collapse into five states a shopper can act on\n * (B2B-4615). Each state has one job, so each has one line and at most one\n * action:\n *\n *   A · No answer   — llm-error-text, llm-empty-response\n *   B · Interrupted  — 500, generic-network-error, timeout, streaming-error,\n *                       history-load-error\n *   C · Fresh start  — 403, 404\n *   D · Partial      — partial-load\n *   E · Quota        — 429\n *\n * `iconType` stays on every template that had one: the new design drops icons,\n * but w5-client-circana and w5-client-feature-com still read the field and\n * must keep the look they have.\n */\n\nconst retryButton: ErrorTemplateButton[] = [\n  { text: 'Try again', action: 'retry', variant: 'cta' },\n];\n\n/** A · No answer — nothing to retry, so it offers somewhere else to go. */\nconst noAnswerTemplate: ErrorTemplate = {\n  title: \"I can't help with that one \\u2014 but I can help with these.\",\n  showChips: true,\n};\n\n/** B · Interrupted — the message is still there to send again. */\nconst interruptedTitle = \"That didn't come through. Let's try again.\";\n\n/** C · Fresh start — the thread is gone; hand the conversation back. */\nconst freshStartTemplate: ErrorTemplate = {\n  title: \"We're starting fresh \\u2014 earlier messages aren't saved.\",\n  showChips: true,\n  chipsLabel: 'Ask anything to pick up again',\n};\n\nexport const DEFAULT_ERROR_TEMPLATES: Record<\n  ConversationErrorType,\n  ErrorTemplate\n> = {\n  'conversation-llm-error-text': noAnswerTemplate,\n  'conversation-llm-empty-response': noAnswerTemplate,\n  'conversation-500': {\n    iconType: 'error-500',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  'conversation-generic-network-error': {\n    iconType: 'timeout',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  'conversation-timeout': {\n    iconType: 'timeout',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  'conversation-streaming-error': {\n    iconType: 'streaming-error',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  // Same state as the four above, deliberately not the same action: a history\n  // load fails before there is a last message, so `retry` has nothing to\n  // re-send and would sit there doing nothing.\n  'history-load-error': {\n    iconType: 'streaming-error',\n    title: interruptedTitle,\n    buttons: [{ text: 'Try again', action: 'reload', variant: 'cta' }],\n  },\n  'conversation-403': { iconType: 'forbidden', ...freshStartTemplate },\n  'conversation-404': { iconType: 'not-found', ...freshStartTemplate },\n  // D · Partial — an answer DID render; some of it is missing. This one is\n  // appended to the answer rather than replacing it.\n  'conversation-partial-load': {\n    iconType: 'partial-load',\n    title: \"Some of this didn't load.\",\n    buttons: [{ text: 'Reload', action: 'reload', variant: 'cta' }],\n  },\n  // E · Quota — waiting is the only fix, so the copy asks for time.\n  'conversation-429': {\n    iconType: 'quota-exceeded',\n    title: 'I need a minute to catch up. Try again shortly.',\n    buttons: retryButton,\n  },\n};\n\n/** Resolves the error template for a given type, merging client overrides on top of defaults */\nexport const resolveErrorTemplate = (\n  type: string,\n  overrides?: ErrorTemplateOverrides,\n): ErrorTemplate => {\n  const templates = overrides\n    ? { ...DEFAULT_ERROR_TEMPLATES, ...overrides }\n    : DEFAULT_ERROR_TEMPLATES;\n  return (\n    templates[type as ConversationErrorType] ??\n    templates['conversation-llm-error-text']\n  );\n};\n"],"mappings":";;;;AAEA;;AAGA;;AAiCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,WAAkC,GAAG,CACzC;EAAEC,IAAI,EAAE,WAAW;EAAEC,MAAM,EAAE,OAAO;EAAEC,OAAO,EAAE;AAAM,CAAC,CACvD;;AAED;AACA,MAAMC,gBAA+B,GAAG;EACtCC,KAAK,EAAE,8DAA8D;EACrEC,SAAS,EAAE;AACb,CAAC;;AAED;AACA,MAAMC,gBAAgB,GAAG,4CAA4C;;AAErE;AACA,MAAMC,kBAAiC,GAAG;EACxCH,KAAK,EAAE,4DAA4D;EACnEC,SAAS,EAAE,IAAI;EACfG,UAAU,EAAE;AACd,CAAC;AAEM,MAAMC,uBAGZ,GAAAC,OAAA,CAAAD,uBAAA,GAAG;EACF,6BAA6B,EAAEN,gBAAgB;EAC/C,iCAAiC,EAAEA,gBAAgB;EACnD,kBAAkB,EAAE;IAClBQ,QAAQ,EAAE,WAAW;IACrBP,KAAK,EAAEE,gBAAgB;IACvBM,OAAO,EAAEb;EACX,CAAC;EACD,oCAAoC,EAAE;IACpCY,QAAQ,EAAE,SAAS;IACnBP,KAAK,EAAEE,gBAAgB;IACvBM,OAAO,EAAEb;EACX,CAAC;EACD,sBAAsB,EAAE;IACtBY,QAAQ,EAAE,SAAS;IACnBP,KAAK,EAAEE,gBAAgB;IACvBM,OAAO,EAAEb;EACX,CAAC;EACD,8BAA8B,EAAE;IAC9BY,QAAQ,EAAE,iBAAiB;IAC3BP,KAAK,EAAEE,gBAAgB;IACvBM,OAAO,EAAEb;EACX,CAAC;EACD;EACA;EACA;EACA,oBAAoB,EAAE;IACpBY,QAAQ,EAAE,iBAAiB;IAC3BP,KAAK,EAAEE,gBAAgB;IACvBM,OAAO,EAAE,CAAC;MAAEZ,IAAI,EAAE,WAAW;MAAEC,MAAM,EAAE,QAAQ;MAAEC,OAAO,EAAE;IAAM,CAAC;EACnE,CAAC;EACD,kBAAkB,EAAE;IAAES,QAAQ,EAAE,WAAW;IAAE,GAAGJ;EAAmB,CAAC;EACpE,kBAAkB,EAAE;IAAEI,QAAQ,EAAE,WAAW;IAAE,GAAGJ;EAAmB,CAAC;EACpE;EACA;EACA,2BAA2B,EAAE;IAC3BI,QAAQ,EAAE,cAAc;IACxBP,KAAK,EAAE,2BAA2B;IAClCQ,OAAO,EAAE,CAAC;MAAEZ,IAAI,EAAE,QAAQ;MAAEC,MAAM,EAAE,QAAQ;MAAEC,OAAO,EAAE;IAAM,CAAC;EAChE,CAAC;EACD;EACA,kBAAkB,EAAE;IAClBS,QAAQ,EAAE,gBAAgB;IAC1BP,KAAK,EAAE,iDAAiD;IACxDQ,OAAO,EAAEb;EACX;AACF,CAAC;;AAED;AACO,MAAMc,oBAAoB,GAAGA,CAClCC,IAAY,EACZC,SAAkC,KAChB;EAClB,MAAMC,SAAS,GAAGD,SAAS,GACvB;IAAE,GAAGN,uBAAuB;IAAE,GAAGM;EAAU,CAAC,GAC5CN,uBAAuB;EAC3B,OACEO,SAAS,CAACF,IAAI,CAA0B,IACxCE,SAAS,CAAC,6BAA6B,CAAC;AAE5C,CAAC;AAACN,OAAA,CAAAG,oBAAA,GAAAA,oBAAA","ignoreList":[]}

package/dist/cjs/styles/base-tokens.css

@@ -8,7 +8,12 @@
   /* Color tokens — HSL triplets */
   --background: 0 0% 100%;
   --foreground: 0 0% 3.9%;
-  --card: 0 0% 100%;
+  /* A card must not dissolve into the page it sits on. Until the seed's
+   * migration to `bg-card` this separation was drawn the other way round —
+   * section bands were `bg-muted` and cards were the pure `--background` — so
+   * the tint moves onto the card and `--background` goes back to meaning what
+   * it says: the page. Same two greys, opposite surfaces. */
+  --card: 0 0% 96.1%;
   --card-foreground: 0 0% 3.9%;
   --popover: 0 0% 100%;
   --popover-foreground: 0 0% 3.9%;
@@ -113,7 +118,7 @@
 .dark {
   --background: 0 0% 3.9%;
   --foreground: 0 0% 98%;
-  --card: 0 0% 3.9%;
+  --card: 0 0% 14.9%;
   --card-foreground: 0 0% 98%;
   --popover: 0 0% 3.9%;
   --popover-foreground: 0 0% 98%;

package/dist/cjs/theme/tokenContract.js

@@ -71,11 +71,19 @@ exports.hostAliasFor = hostAliasFor;
  * with no name, and a label on a token nobody may set is a promise the panel
  * cannot keep. One argument, one decision.
  *
- * Labels are the merchant's words rather than the token's — "Buttons & links",
- * not "primary". Someone choosing their shop's colours is not reading a design
+ * Labels are the merchant's words rather than the token's — "Card background",
+ * not "card". Someone choosing their shop's colours is not reading a design
  * system, and `--primary-foreground` is not a colour anyone picks: it is
  * whatever stays legible ON primary, which the theme derives. Exposing the
  * derived half is how a panel produces white text on a white button.
+ *
+ * Only FOUR carry a label (product request, 2026-09-09): the page's surface and
+ * text, and a card's. They are the four a shop owner can point at on the page
+ * and name without being taught the vocabulary, and — unlike `--secondary`,
+ * `--accent` or `--muted`, which the importer MIXES from the anchors — they are
+ * independent of each other, so setting one cannot contradict the arithmetic
+ * that produced another. Everything else stays import-only: the store still
+ * fills it, the panel just does not offer it.
  */
 const brandColor = label => ({
   bucket: 'brand',
@@ -97,21 +105,21 @@ const brandColor = label => ({
  */
 const THEME_TOKEN_CONTRACT = exports.THEME_TOKEN_CONTRACT = Object.freeze({
   // ── brand · colour roles (18) ────────────────────────────────────────────
-  '--background': brandColor('Page background'),
-  '--foreground': brandColor('Text'),
-  '--card': brandColor(),
-  '--card-foreground': brandColor(),
+  '--background': brandColor('Background color'),
+  '--foreground': brandColor('Text color'),
+  '--card': brandColor('Card background'),
+  '--card-foreground': brandColor('Card text'),
   '--popover': brandColor(),
   '--popover-foreground': brandColor(),
-  '--primary': brandColor('Buttons & links'),
+  '--primary': brandColor(),
   '--primary-foreground': brandColor(),
   '--secondary': brandColor(),
   '--secondary-foreground': brandColor(),
   '--muted': brandColor(),
   '--muted-foreground': brandColor(),
-  '--accent': brandColor('Highlights'),
+  '--accent': brandColor(),
   '--accent-foreground': brandColor(),
-  '--border': brandColor('Lines & borders'),
+  '--border': brandColor(),
   '--input': brandColor(),
   '--ring': brandColor(),
   /**
@@ -121,7 +129,7 @@ const THEME_TOKEN_CONTRACT = exports.THEME_TOKEN_CONTRACT = Object.freeze({
    * emits the other twenty. A store that states a distinct heading colour has
    * somewhere for it to go the moment an adapter learns to read one.
    */
-  '--heading': brandColor('Headings'),
+  '--heading': brandColor(),
   // ── brand · type (2) ─────────────────────────────────────────────────────
   '--font-sans': {
     bucket: 'brand',
@@ -136,14 +144,15 @@ const THEME_TOKEN_CONTRACT = exports.THEME_TOKEN_CONTRACT = Object.freeze({
   // ── host · shape (1) ─────────────────────────────────────────────────────
   /**
    * The one token whose bucket changed, and the reason this contract exists.
-   * Editable because it is the one value a store and a template are known to
-   * disagree about in a way a merchant can see and wants to settle.
+   * A store's imported radius still reaches the page as `--web5-host-radius`
+   * and a template still beats it; what changed is that the OWNER no longer
+   * gets a control for it — the panel is four colours now, and shape is not
+   * one of them.
    */
   '--radius': {
     bucket: 'host',
     type: 'length',
-    editable: true,
-    label: 'Corner rounding'
+    editable: false
   }
 });
 
@@ -169,8 +178,9 @@ const TOKEN_NAME_PATTERN = exports.TOKEN_NAME_PATTERN = /^--[a-z0-9-]+$/;
  * Derived from the contract rather than listed again beside it, so a token
  * cannot be editable in one place and absent from the other. The order is the
  * declaration order above, which reads outside-in — the page, then its text,
- * then the things drawn on it — and is a better first impression than
- * alphabetical or than the order the tokens happen to be defined for CSS.
+ * then the card drawn on it, then the card's text — and is a better first
+ * impression than alphabetical or than the order the tokens happen to be
+ * defined for CSS.
  */
 const EDITABLE_TOKENS = exports.EDITABLE_TOKENS = Object.freeze(Object.entries(THEME_TOKEN_CONTRACT).filter(([, entry]) => entry.editable));
 

package/dist/cjs/theme/tokenContract.js.map

@@ -1 +1 @@
-{"version":3,"names":["brandColor","label","bucket","type","editable","undefined","THEME_TOKEN_CONTRACT","exports","Object","freeze","BRAND_TOKENS","Set","entries","filter","entry","map","token","TOKEN_NAME_PATTERN","EDITABLE_TOKENS","hostAliasFor","slice","bucketOf","_THEME_TOKEN_CONTRACT"],"sources":["../../../src/theme/tokenContract.ts"],"sourcesContent":["/**\n * The theme-token contract (DL #193).\n *\n * One home for the answer to \"who is allowed to set this token, and who wins\n * when more than one of them does\". Three things need that answer and must not\n * each keep their own copy:\n *\n *   - **`applyThemeOverrides`** decides, per key, whether to write the real\n *     token or its `--web5-host-*` alias.\n *   - **the seed's `validate-templates`** fails a template that sets a brand\n *     token.\n *   - **the shop owner's panel** renders a control per `editable` entry.\n *\n * A leaf module beside `hostScope.ts`, and for the same reason: both are data\n * that several packages must agree on, and both have to be readable from plain\n * Node tooling. Requiring this package's ENTRY from Node fails — the CSS import\n * in it is a syntax error to the CJS loader, which is what `scope-css.ts`\n * documents — but a deep import of a leaf like this one works, so the seed's\n * validator can read it without loading a component library.\n *\n * It was briefly its own package. That was justified by `embed-loader` needing\n * the list without taking core's eleven dependencies — and the loader turned\n * out not to need it at all, because `applyThemeOverrides` has owned runtime\n * token injection here since DL #131.\n *\n * ## The two buckets\n *\n * The split is about who WINS, not about what may be imported. A platform\n * adapter is free to read anything the store states; the bucket decides what\n * happens when a template has an opinion about the same token.\n *\n * - `brand` — the store's identity: colour roles and font families. The\n *   imported value is written as the real token, last, so it wins\n *   unconditionally. A template is not permitted to set these.\n * - `host`  — the store's shape: corner radius today. The imported value is\n *   written as `--web5-host-<name>` and consumed by core as a `var()`\n *   fallback, so a template stating the real token beats it and a template\n *   that stays silent inherits the store's.\n *\n * A token absent from this map is treated as `host`. That is deliberate and\n * safe: an alias nothing consumes renders nothing, so an adapter that learns\n * to read a token core has never heard of cannot override a template by\n * accident. The wiring line in core is the real gate for a host token, not the\n * entry here.\n *\n * ## Why all but one are brand\n *\n * This is not a new taxonomy. Twenty of these are the set\n * `web50-shopify-adapter` already emits, with a bucket attached; the\n * twenty-first, `--heading`, has been in core's catalogue since DL #131 and is\n * consumed by the seed, but no adapter fills it yet. Exactly one token changes\n * hands relative to the behaviour before DL #193 — `--radius`, which used to\n * win against the template that had chosen a different one. That single\n * misfiling is the whole of the bug this contract exists to fix.\n */\n\n/** How a value is spelled, which is what makes validation possible. */\nexport type TokenType =\n  /** An HSL triplet with no `hsl()` wrapper — `0 0% 9%`. The core bridge wraps it. */\n  | 'color-hsl'\n  /** A CSS font stack — `'Poppins', ui-sans-serif, sans-serif`. */\n  | 'font-stack'\n  /** A CSS length. MUST carry a unit: a bare `0` turns `calc(var(--radius) - 4px)`\n   *  into a type error and takes the derived radius scale out entirely. */\n  | 'length';\n\n/** Which layer wins when both a store and a template state this token. */\nexport type TokenBucket = 'brand' | 'host';\n\nexport interface TokenContractEntry {\n  bucket: TokenBucket;\n  type: TokenType;\n  /** May the shop owner set this from the panel? */\n  editable: boolean;\n  /** Shown in the owner's panel. Absent for entries that are not editable. */\n  label?: string;\n}\n\n/**\n * A colour role. Giving one a label is what puts it in the owner's panel.\n *\n * The two travel together on purpose: `editable` without a label is a control\n * with no name, and a label on a token nobody may set is a promise the panel\n * cannot keep. One argument, one decision.\n *\n * Labels are the merchant's words rather than the token's — \"Buttons & links\",\n * not \"primary\". Someone choosing their shop's colours is not reading a design\n * system, and `--primary-foreground` is not a colour anyone picks: it is\n * whatever stays legible ON primary, which the theme derives. Exposing the\n * derived half is how a panel produces white text on a white button.\n */\nconst brandColor = (label?: string): TokenContractEntry => ({\n  bucket: 'brand',\n  type: 'color-hsl',\n  editable: label !== undefined,\n  ...(label === undefined ? {} : { label }),\n});\n\n/**\n * Every token a platform adapter may meaningfully emit today.\n *\n * Growth is adapter-driven on purpose: a token joins when an adapter can\n * actually read it, not on spec. `theme_overrides` is capped at 32 entries by\n * its proto, so there are twelve slots left and no reason to spend them on\n * speculation. `--spacing` is the tempting next one and should be resisted —\n * it scales every `p-*`, `m-*` and `gap-*` in the bundle from one number.\n */\nexport const THEME_TOKEN_CONTRACT: Readonly<Record<string, TokenContractEntry>> =\n  Object.freeze({\n    // ── brand · colour roles (18) ────────────────────────────────────────────\n    '--background': brandColor('Page background'),\n    '--foreground': brandColor('Text'),\n    '--card': brandColor(),\n    '--card-foreground': brandColor(),\n    '--popover': brandColor(),\n    '--popover-foreground': brandColor(),\n    '--primary': brandColor('Buttons & links'),\n    '--primary-foreground': brandColor(),\n    '--secondary': brandColor(),\n    '--secondary-foreground': brandColor(),\n    '--muted': brandColor(),\n    '--muted-foreground': brandColor(),\n    '--accent': brandColor('Highlights'),\n    '--accent-foreground': brandColor(),\n    '--border': brandColor('Lines & borders'),\n    '--input': brandColor(),\n    '--ring': brandColor(),\n\n    /**\n     * Brand-shaped and supported end to end, but no adapter fills it yet: the\n     * seed consumes it (`--color-heading-fg: hsl(var(--heading, var(--foreground)))`)\n     * and core has catalogued it since DL #131, while `web50-shopify-adapter`\n     * emits the other twenty. A store that states a distinct heading colour has\n     * somewhere for it to go the moment an adapter learns to read one.\n     */\n    '--heading': brandColor('Headings'),\n\n    // ── brand · type (2) ─────────────────────────────────────────────────────\n    '--font-sans': { bucket: 'brand', type: 'font-stack', editable: false },\n    '--font-display': { bucket: 'brand', type: 'font-stack', editable: false },\n\n    // ── host · shape (1) ─────────────────────────────────────────────────────\n    /**\n     * The one token whose bucket changed, and the reason this contract exists.\n     * Editable because it is the one value a store and a template are known to\n     * disagree about in a way a merchant can see and wants to settle.\n     */\n    '--radius': {\n      bucket: 'host',\n      type: 'length',\n      editable: true,\n      label: 'Corner rounding',\n    },\n  });\n\n/**\n * The tokens written directly, which is the only question the loader has to\n * answer per key — everything else takes the alias path.\n */\nexport const BRAND_TOKENS: ReadonlySet<string> = Object.freeze(\n  new Set(\n    Object.entries(THEME_TOKEN_CONTRACT)\n      .filter(([, entry]) => entry.bucket === 'brand')\n      .map(([token]) => token),\n  ),\n) as ReadonlySet<string>;\n\n/**\n * A token name we are willing to compose into a CSS declaration.\n *\n * The keys reaching the loader came out of a backend map, which came out of an\n * adapter reading a merchant's theme file. A key carrying `:` or `;` would\n * write arbitrary declarations onto the mount, so the shape is checked where\n * the declaration is built rather than trusted from the source.\n */\nexport const TOKEN_NAME_PATTERN = /^--[a-z0-9-]+$/;\n\n/**\n * What the owner's panel offers, in the order it offers it.\n *\n * Derived from the contract rather than listed again beside it, so a token\n * cannot be editable in one place and absent from the other. The order is the\n * declaration order above, which reads outside-in — the page, then its text,\n * then the things drawn on it — and is a better first impression than\n * alphabetical or than the order the tokens happen to be defined for CSS.\n */\nexport const EDITABLE_TOKENS: readonly (readonly [\n  token: string,\n  entry: TokenContractEntry,\n])[] = Object.freeze(\n  Object.entries(THEME_TOKEN_CONTRACT).filter(([, entry]) => entry.editable),\n) as readonly (readonly [string, TokenContractEntry])[];\n\n/** `--radius` → `--web5-host-radius`. Derived, never stored: one fewer thing to get wrong. */\nexport function hostAliasFor(token: string): string {\n  return `--web5-host-${token.slice(2)}`;\n}\n\n/** Whether this token is written directly (brand) or as an alias (host, and anything unknown). */\nexport function bucketOf(token: string): TokenBucket {\n  return THEME_TOKEN_CONTRACT[token]?.bucket ?? 'host';\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAUA;;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,UAAU,GAAIC,KAAc,KAA0B;EAC1DC,MAAM,EAAE,OAAO;EACfC,IAAI,EAAE,WAAW;EACjBC,QAAQ,EAAEH,KAAK,KAAKI,SAAS;EAC7B,IAAIJ,KAAK,KAAKI,SAAS,GAAG,CAAC,CAAC,GAAG;IAAEJ;EAAM,CAAC;AAC1C,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMK,oBAAkE,GAAAC,OAAA,CAAAD,oBAAA,GAC7EE,MAAM,CAACC,MAAM,CAAC;EACZ;EACA,cAAc,EAAET,UAAU,CAAC,iBAAiB,CAAC;EAC7C,cAAc,EAAEA,UAAU,CAAC,MAAM,CAAC;EAClC,QAAQ,EAAEA,UAAU,CAAC,CAAC;EACtB,mBAAmB,EAAEA,UAAU,CAAC,CAAC;EACjC,WAAW,EAAEA,UAAU,CAAC,CAAC;EACzB,sBAAsB,EAAEA,UAAU,CAAC,CAAC;EACpC,WAAW,EAAEA,UAAU,CAAC,iBAAiB,CAAC;EAC1C,sBAAsB,EAAEA,UAAU,CAAC,CAAC;EACpC,aAAa,EAAEA,UAAU,CAAC,CAAC;EAC3B,wBAAwB,EAAEA,UAAU,CAAC,CAAC;EACtC,SAAS,EAAEA,UAAU,CAAC,CAAC;EACvB,oBAAoB,EAAEA,UAAU,CAAC,CAAC;EAClC,UAAU,EAAEA,UAAU,CAAC,YAAY,CAAC;EACpC,qBAAqB,EAAEA,UAAU,CAAC,CAAC;EACnC,UAAU,EAAEA,UAAU,CAAC,iBAAiB,CAAC;EACzC,SAAS,EAAEA,UAAU,CAAC,CAAC;EACvB,QAAQ,EAAEA,UAAU,CAAC,CAAC;EAEtB;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,WAAW,EAAEA,UAAU,CAAC,UAAU,CAAC;EAEnC;EACA,aAAa,EAAE;IAAEE,MAAM,EAAE,OAAO;IAAEC,IAAI,EAAE,YAAY;IAAEC,QAAQ,EAAE;EAAM,CAAC;EACvE,gBAAgB,EAAE;IAAEF,MAAM,EAAE,OAAO;IAAEC,IAAI,EAAE,YAAY;IAAEC,QAAQ,EAAE;EAAM,CAAC;EAE1E;EACA;AACJ;AACA;AACA;AACA;EACI,UAAU,EAAE;IACVF,MAAM,EAAE,MAAM;IACdC,IAAI,EAAE,QAAQ;IACdC,QAAQ,EAAE,IAAI;IACdH,KAAK,EAAE;EACT;AACF,CAAC,CAAC;;AAEJ;AACA;AACA;AACA;AACO,MAAMS,YAAiC,GAAAH,OAAA,CAAAG,YAAA,GAAGF,MAAM,CAACC,MAAM,CAC5D,IAAIE,GAAG,CACLH,MAAM,CAACI,OAAO,CAACN,oBAAoB,CAAC,CACjCO,MAAM,CAAC,CAAC,GAAGC,KAAK,CAAC,KAAKA,KAAK,CAACZ,MAAM,KAAK,OAAO,CAAC,CAC/Ca,GAAG,CAAC,CAAC,CAACC,KAAK,CAAC,KAAKA,KAAK,CAC3B,CACF,CAAwB;;AAExB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,kBAAkB,GAAAV,OAAA,CAAAU,kBAAA,GAAG,gBAAgB;;AAElD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,eAGT,GAAAX,OAAA,CAAAW,eAAA,GAAGV,MAAM,CAACC,MAAM,CAClBD,MAAM,CAACI,OAAO,CAACN,oBAAoB,CAAC,CAACO,MAAM,CAAC,CAAC,GAAGC,KAAK,CAAC,KAAKA,KAAK,CAACV,QAAQ,CAC3E,CAAuD;;AAEvD;AACO,SAASe,YAAYA,CAACH,KAAa,EAAU;EAClD,OAAO,eAAeA,KAAK,CAACI,KAAK,CAAC,CAAC,CAAC,EAAE;AACxC;;AAEA;AACO,SAASC,QAAQA,CAACL,KAAa,EAAe;EAAA,IAAAM,qBAAA;EACnD,OAAO,EAAAA,qBAAA,GAAAhB,oBAAoB,CAACU,KAAK,CAAC,qBAA3BM,qBAAA,CAA6BpB,MAAM,KAAI,MAAM;AACtD","ignoreList":[]}
+{"version":3,"names":["brandColor","label","bucket","type","editable","undefined","THEME_TOKEN_CONTRACT","exports","Object","freeze","BRAND_TOKENS","Set","entries","filter","entry","map","token","TOKEN_NAME_PATTERN","EDITABLE_TOKENS","hostAliasFor","slice","bucketOf","_THEME_TOKEN_CONTRACT"],"sources":["../../../src/theme/tokenContract.ts"],"sourcesContent":["/**\n * The theme-token contract (DL #193).\n *\n * One home for the answer to \"who is allowed to set this token, and who wins\n * when more than one of them does\". Three things need that answer and must not\n * each keep their own copy:\n *\n *   - **`applyThemeOverrides`** decides, per key, whether to write the real\n *     token or its `--web5-host-*` alias.\n *   - **the seed's `validate-templates`** fails a template that sets a brand\n *     token.\n *   - **the shop owner's panel** renders a control per `editable` entry.\n *\n * A leaf module beside `hostScope.ts`, and for the same reason: both are data\n * that several packages must agree on, and both have to be readable from plain\n * Node tooling. Requiring this package's ENTRY from Node fails — the CSS import\n * in it is a syntax error to the CJS loader, which is what `scope-css.ts`\n * documents — but a deep import of a leaf like this one works, so the seed's\n * validator can read it without loading a component library.\n *\n * It was briefly its own package. That was justified by `embed-loader` needing\n * the list without taking core's eleven dependencies — and the loader turned\n * out not to need it at all, because `applyThemeOverrides` has owned runtime\n * token injection here since DL #131.\n *\n * ## The two buckets\n *\n * The split is about who WINS, not about what may be imported. A platform\n * adapter is free to read anything the store states; the bucket decides what\n * happens when a template has an opinion about the same token.\n *\n * - `brand` — the store's identity: colour roles and font families. The\n *   imported value is written as the real token, last, so it wins\n *   unconditionally. A template is not permitted to set these.\n * - `host`  — the store's shape: corner radius today. The imported value is\n *   written as `--web5-host-<name>` and consumed by core as a `var()`\n *   fallback, so a template stating the real token beats it and a template\n *   that stays silent inherits the store's.\n *\n * A token absent from this map is treated as `host`. That is deliberate and\n * safe: an alias nothing consumes renders nothing, so an adapter that learns\n * to read a token core has never heard of cannot override a template by\n * accident. The wiring line in core is the real gate for a host token, not the\n * entry here.\n *\n * ## Why all but one are brand\n *\n * This is not a new taxonomy. Twenty of these are the set\n * `web50-shopify-adapter` already emits, with a bucket attached; the\n * twenty-first, `--heading`, has been in core's catalogue since DL #131 and is\n * consumed by the seed, but no adapter fills it yet. Exactly one token changes\n * hands relative to the behaviour before DL #193 — `--radius`, which used to\n * win against the template that had chosen a different one. That single\n * misfiling is the whole of the bug this contract exists to fix.\n */\n\n/** How a value is spelled, which is what makes validation possible. */\nexport type TokenType =\n  /** An HSL triplet with no `hsl()` wrapper — `0 0% 9%`. The core bridge wraps it. */\n  | 'color-hsl'\n  /** A CSS font stack — `'Poppins', ui-sans-serif, sans-serif`. */\n  | 'font-stack'\n  /** A CSS length. MUST carry a unit: a bare `0` turns `calc(var(--radius) - 4px)`\n   *  into a type error and takes the derived radius scale out entirely. */\n  | 'length';\n\n/** Which layer wins when both a store and a template state this token. */\nexport type TokenBucket = 'brand' | 'host';\n\nexport interface TokenContractEntry {\n  bucket: TokenBucket;\n  type: TokenType;\n  /** May the shop owner set this from the panel? */\n  editable: boolean;\n  /** Shown in the owner's panel. Absent for entries that are not editable. */\n  label?: string;\n}\n\n/**\n * A colour role. Giving one a label is what puts it in the owner's panel.\n *\n * The two travel together on purpose: `editable` without a label is a control\n * with no name, and a label on a token nobody may set is a promise the panel\n * cannot keep. One argument, one decision.\n *\n * Labels are the merchant's words rather than the token's — \"Card background\",\n * not \"card\". Someone choosing their shop's colours is not reading a design\n * system, and `--primary-foreground` is not a colour anyone picks: it is\n * whatever stays legible ON primary, which the theme derives. Exposing the\n * derived half is how a panel produces white text on a white button.\n *\n * Only FOUR carry a label (product request, 2026-09-09): the page's surface and\n * text, and a card's. They are the four a shop owner can point at on the page\n * and name without being taught the vocabulary, and — unlike `--secondary`,\n * `--accent` or `--muted`, which the importer MIXES from the anchors — they are\n * independent of each other, so setting one cannot contradict the arithmetic\n * that produced another. Everything else stays import-only: the store still\n * fills it, the panel just does not offer it.\n */\nconst brandColor = (label?: string): TokenContractEntry => ({\n  bucket: 'brand',\n  type: 'color-hsl',\n  editable: label !== undefined,\n  ...(label === undefined ? {} : { label }),\n});\n\n/**\n * Every token a platform adapter may meaningfully emit today.\n *\n * Growth is adapter-driven on purpose: a token joins when an adapter can\n * actually read it, not on spec. `theme_overrides` is capped at 32 entries by\n * its proto, so there are twelve slots left and no reason to spend them on\n * speculation. `--spacing` is the tempting next one and should be resisted —\n * it scales every `p-*`, `m-*` and `gap-*` in the bundle from one number.\n */\nexport const THEME_TOKEN_CONTRACT: Readonly<Record<string, TokenContractEntry>> =\n  Object.freeze({\n    // ── brand · colour roles (18) ────────────────────────────────────────────\n    '--background': brandColor('Background color'),\n    '--foreground': brandColor('Text color'),\n    '--card': brandColor('Card background'),\n    '--card-foreground': brandColor('Card text'),\n    '--popover': brandColor(),\n    '--popover-foreground': brandColor(),\n    '--primary': brandColor(),\n    '--primary-foreground': brandColor(),\n    '--secondary': brandColor(),\n    '--secondary-foreground': brandColor(),\n    '--muted': brandColor(),\n    '--muted-foreground': brandColor(),\n    '--accent': brandColor(),\n    '--accent-foreground': brandColor(),\n    '--border': brandColor(),\n    '--input': brandColor(),\n    '--ring': brandColor(),\n\n    /**\n     * Brand-shaped and supported end to end, but no adapter fills it yet: the\n     * seed consumes it (`--color-heading-fg: hsl(var(--heading, var(--foreground)))`)\n     * and core has catalogued it since DL #131, while `web50-shopify-adapter`\n     * emits the other twenty. A store that states a distinct heading colour has\n     * somewhere for it to go the moment an adapter learns to read one.\n     */\n    '--heading': brandColor(),\n\n    // ── brand · type (2) ─────────────────────────────────────────────────────\n    '--font-sans': { bucket: 'brand', type: 'font-stack', editable: false },\n    '--font-display': { bucket: 'brand', type: 'font-stack', editable: false },\n\n    // ── host · shape (1) ─────────────────────────────────────────────────────\n    /**\n     * The one token whose bucket changed, and the reason this contract exists.\n     * A store's imported radius still reaches the page as `--web5-host-radius`\n     * and a template still beats it; what changed is that the OWNER no longer\n     * gets a control for it — the panel is four colours now, and shape is not\n     * one of them.\n     */\n    '--radius': {\n      bucket: 'host',\n      type: 'length',\n      editable: false,\n    },\n  });\n\n/**\n * The tokens written directly, which is the only question the loader has to\n * answer per key — everything else takes the alias path.\n */\nexport const BRAND_TOKENS: ReadonlySet<string> = Object.freeze(\n  new Set(\n    Object.entries(THEME_TOKEN_CONTRACT)\n      .filter(([, entry]) => entry.bucket === 'brand')\n      .map(([token]) => token),\n  ),\n) as ReadonlySet<string>;\n\n/**\n * A token name we are willing to compose into a CSS declaration.\n *\n * The keys reaching the loader came out of a backend map, which came out of an\n * adapter reading a merchant's theme file. A key carrying `:` or `;` would\n * write arbitrary declarations onto the mount, so the shape is checked where\n * the declaration is built rather than trusted from the source.\n */\nexport const TOKEN_NAME_PATTERN = /^--[a-z0-9-]+$/;\n\n/**\n * What the owner's panel offers, in the order it offers it.\n *\n * Derived from the contract rather than listed again beside it, so a token\n * cannot be editable in one place and absent from the other. The order is the\n * declaration order above, which reads outside-in — the page, then its text,\n * then the card drawn on it, then the card's text — and is a better first\n * impression than alphabetical or than the order the tokens happen to be\n * defined for CSS.\n */\nexport const EDITABLE_TOKENS: readonly (readonly [\n  token: string,\n  entry: TokenContractEntry,\n])[] = Object.freeze(\n  Object.entries(THEME_TOKEN_CONTRACT).filter(([, entry]) => entry.editable),\n) as readonly (readonly [string, TokenContractEntry])[];\n\n/** `--radius` → `--web5-host-radius`. Derived, never stored: one fewer thing to get wrong. */\nexport function hostAliasFor(token: string): string {\n  return `--web5-host-${token.slice(2)}`;\n}\n\n/** Whether this token is written directly (brand) or as an alias (host, and anything unknown). */\nexport function bucketOf(token: string): TokenBucket {\n  return THEME_TOKEN_CONTRACT[token]?.bucket ?? 'host';\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/errors/errorTemplates.js

@@ -2,79 +2,103 @@
 
 /** Icon identifiers for error templates — resolved to SVG components by the rendering component */
 
-const retryAndContactButtons = [{
-  text: 'Try Again',
+/**
+ * The eleven error types collapse into five states a shopper can act on
+ * (B2B-4615). Each state has one job, so each has one line and at most one
+ * action:
+ *
+ *   A · No answer   — llm-error-text, llm-empty-response
+ *   B · Interrupted  — 500, generic-network-error, timeout, streaming-error,
+ *                       history-load-error
+ *   C · Fresh start  — 403, 404
+ *   D · Partial      — partial-load
+ *   E · Quota        — 429
+ *
+ * `iconType` stays on every template that had one: the new design drops icons,
+ * but w5-client-circana and w5-client-feature-com still read the field and
+ * must keep the look they have.
+ */
+
+const retryButton = [{
+  text: 'Try again',
   action: 'retry',
   variant: 'cta'
-}, {
-  text: 'Contact Us',
-  variant: 'link'
 }];
+
+/** A · No answer — nothing to retry, so it offers somewhere else to go. */
+const noAnswerTemplate = {
+  title: "I can't help with that one \u2014 but I can help with these.",
+  showChips: true
+};
+
+/** B · Interrupted — the message is still there to send again. */
+const interruptedTitle = "That didn't come through. Let's try again.";
+
+/** C · Fresh start — the thread is gone; hand the conversation back. */
+const freshStartTemplate = {
+  title: "We're starting fresh \u2014 earlier messages aren't saved.",
+  showChips: true,
+  chipsLabel: 'Ask anything to pick up again'
+};
 export const DEFAULT_ERROR_TEMPLATES = {
-  'conversation-llm-error-text': {
-    title: "I couldn't find information about what you asked.\nTry asking about a different topic.",
-    showChips: true
-  },
-  'conversation-llm-empty-response': {
-    title: "I couldn't find information about what you asked.\nTry asking about a different topic.",
-    showChips: true
-  },
+  'conversation-llm-error-text': noAnswerTemplate,
+  'conversation-llm-empty-response': noAnswerTemplate,
   'conversation-500': {
     iconType: 'error-500',
-    title: "This page isn't available right now.",
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
   'conversation-generic-network-error': {
     iconType: 'timeout',
-    title: 'Something went wrong on our side.\nPlease try again in a moment.',
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
   'conversation-timeout': {
     iconType: 'timeout',
-    title: 'Something went wrong on our side.\nPlease try again in a moment.',
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
   'conversation-streaming-error': {
     iconType: 'streaming-error',
-    title: 'The connection dropped. Please try again.',
-    buttons: retryAndContactButtons
+    title: interruptedTitle,
+    buttons: retryButton
   },
-  'conversation-404': {
-    iconType: 'not-found',
-    title: 'Page not found.\nIt happens! Let\u2019s get you back on track',
-    showChips: true,
-    chipsLabel: 'Some ideas to get you started:'
+  // Same state as the four above, deliberately not the same action: a history
+  // load fails before there is a last message, so `retry` has nothing to
+  // re-send and would sit there doing nothing.
+  'history-load-error': {
+    iconType: 'streaming-error',
+    title: interruptedTitle,
+    buttons: [{
+      text: 'Try again',
+      action: 'reload',
+      variant: 'cta'
+    }]
   },
   'conversation-403': {
     iconType: 'forbidden',
-    title: 'Welcome back.\nFor privacy, we couldn\u2019t restore previous content. Ask anything to continue.',
-    showChips: true,
-    chipsLabel: 'Some ideas to get you started:'
+    ...freshStartTemplate
   },
-  'conversation-429': {
-    iconType: 'quota-exceeded',
-    title: 'This service is currently out of quota.\nPlease try again later.',
-    buttons: [{
-      text: 'Contact Us',
-      variant: 'link'
-    }]
+  'conversation-404': {
+    iconType: 'not-found',
+    ...freshStartTemplate
   },
+  // D · Partial — an answer DID render; some of it is missing. This one is
+  // appended to the answer rather than replacing it.
   'conversation-partial-load': {
     iconType: 'partial-load',
-    title: 'Some content didn\u2019t load',
-    buttons: retryAndContactButtons
-  },
-  'history-load-error': {
-    iconType: 'streaming-error',
-    title: 'We couldn\u2019t load this conversation.',
+    title: "Some of this didn't load.",
     buttons: [{
-      text: 'New Conversation',
-      action: 'newConversation',
+      text: 'Reload',
+      action: 'reload',
       variant: 'cta'
-    }, {
-      text: 'Contact Us',
-      variant: 'link'
     }]
+  },
+  // E · Quota — waiting is the only fix, so the copy asks for time.
+  'conversation-429': {
+    iconType: 'quota-exceeded',
+    title: 'I need a minute to catch up. Try again shortly.',
+    buttons: retryButton
   }
 };
 

package/dist/esm/errors/errorTemplates.js.map

@@ -1 +1 @@
-{"version":3,"names":["retryAndContactButtons","text","action","variant","DEFAULT_ERROR_TEMPLATES","title","showChips","iconType","buttons","chipsLabel","resolveErrorTemplate","type","overrides","templates"],"sources":["../../../src/errors/errorTemplates.ts"],"sourcesContent":["import type { ConversationErrorType } from './conversationErrorTypes';\n\n/** Action identifiers for error template buttons — resolved to callbacks by the rendering component */\nexport type ErrorActionType = 'retry' | 'newConversation' | 'reload';\n\n/** Icon identifiers for error templates — resolved to SVG components by the rendering component */\nexport type ErrorIconType =\n  | 'error-500'\n  | 'timeout'\n  | 'streaming-error'\n  | 'not-found'\n  | 'forbidden'\n  | 'partial-load'\n  | 'quota-exceeded';\n\nexport interface ErrorTemplateButton {\n  text: string;\n  /** URL for navigation (renders as a link) */\n  href?: string;\n  /** Action identifier — component resolves to a callback */\n  action?: ErrorActionType;\n  variant: 'cta' | 'link';\n}\n\nexport interface ErrorTemplate {\n  title: string;\n  subtitle?: string;\n  /** Icon identifier — component resolves to an SVG */\n  iconType?: ErrorIconType;\n  buttons?: ErrorTemplateButton[];\n  showChips?: boolean;\n  chipsLabel?: string;\n}\n\nexport type ErrorTemplateOverrides = Partial<\n  Record<ConversationErrorType, ErrorTemplate>\n>;\n\nconst retryAndContactButtons: ErrorTemplateButton[] = [\n  { text: 'Try Again', action: 'retry', variant: 'cta' },\n  { text: 'Contact Us', variant: 'link' },\n];\n\nexport const DEFAULT_ERROR_TEMPLATES: Record<\n  ConversationErrorType,\n  ErrorTemplate\n> = {\n  'conversation-llm-error-text': {\n    title:\n      \"I couldn't find information about what you asked.\\nTry asking about a different topic.\",\n    showChips: true,\n  },\n  'conversation-llm-empty-response': {\n    title:\n      \"I couldn't find information about what you asked.\\nTry asking about a different topic.\",\n    showChips: true,\n  },\n  'conversation-500': {\n    iconType: 'error-500',\n    title: \"This page isn't available right now.\",\n    buttons: retryAndContactButtons,\n  },\n  'conversation-generic-network-error': {\n    iconType: 'timeout',\n    title: 'Something went wrong on our side.\\nPlease try again in a moment.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-timeout': {\n    iconType: 'timeout',\n    title: 'Something went wrong on our side.\\nPlease try again in a moment.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-streaming-error': {\n    iconType: 'streaming-error',\n    title: 'The connection dropped. Please try again.',\n    buttons: retryAndContactButtons,\n  },\n  'conversation-404': {\n    iconType: 'not-found',\n    title: 'Page not found.\\nIt happens! Let\\u2019s get you back on track',\n    showChips: true,\n    chipsLabel: 'Some ideas to get you started:',\n  },\n  'conversation-403': {\n    iconType: 'forbidden',\n    title:\n      'Welcome back.\\nFor privacy, we couldn\\u2019t restore previous content. Ask anything to continue.',\n    showChips: true,\n    chipsLabel: 'Some ideas to get you started:',\n  },\n  'conversation-429': {\n    iconType: 'quota-exceeded',\n    title: 'This service is currently out of quota.\\nPlease try again later.',\n    buttons: [{ text: 'Contact Us', variant: 'link' }],\n  },\n  'conversation-partial-load': {\n    iconType: 'partial-load',\n    title: 'Some content didn\\u2019t load',\n    buttons: retryAndContactButtons,\n  },\n  'history-load-error': {\n    iconType: 'streaming-error',\n    title: 'We couldn\\u2019t load this conversation.',\n    buttons: [\n      { text: 'New Conversation', action: 'newConversation', variant: 'cta' },\n      { text: 'Contact Us', variant: 'link' },\n    ],\n  },\n};\n\n/** Resolves the error template for a given type, merging client overrides on top of defaults */\nexport const resolveErrorTemplate = (\n  type: string,\n  overrides?: ErrorTemplateOverrides,\n): ErrorTemplate => {\n  const templates = overrides\n    ? { ...DEFAULT_ERROR_TEMPLATES, ...overrides }\n    : DEFAULT_ERROR_TEMPLATES;\n  return (\n    templates[type as ConversationErrorType] ??\n    templates['conversation-llm-error-text']\n  );\n};\n"],"mappings":"AAEA;;AAGA;;AAiCA,MAAMA,sBAA6C,GAAG,CACpD;EAAEC,IAAI,EAAE,WAAW;EAAEC,MAAM,EAAE,OAAO;EAAEC,OAAO,EAAE;AAAM,CAAC,EACtD;EAAEF,IAAI,EAAE,YAAY;EAAEE,OAAO,EAAE;AAAO,CAAC,CACxC;AAED,OAAO,MAAMC,uBAGZ,GAAG;EACF,6BAA6B,EAAE;IAC7BC,KAAK,EACH,wFAAwF;IAC1FC,SAAS,EAAE;EACb,CAAC;EACD,iCAAiC,EAAE;IACjCD,KAAK,EACH,wFAAwF;IAC1FC,SAAS,EAAE;EACb,CAAC;EACD,kBAAkB,EAAE;IAClBC,QAAQ,EAAE,WAAW;IACrBF,KAAK,EAAE,sCAAsC;IAC7CG,OAAO,EAAER;EACX,CAAC;EACD,oCAAoC,EAAE;IACpCO,QAAQ,EAAE,SAAS;IACnBF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAER;EACX,CAAC;EACD,sBAAsB,EAAE;IACtBO,QAAQ,EAAE,SAAS;IACnBF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAER;EACX,CAAC;EACD,8BAA8B,EAAE;IAC9BO,QAAQ,EAAE,iBAAiB;IAC3BF,KAAK,EAAE,2CAA2C;IAClDG,OAAO,EAAER;EACX,CAAC;EACD,kBAAkB,EAAE;IAClBO,QAAQ,EAAE,WAAW;IACrBF,KAAK,EAAE,+DAA+D;IACtEC,SAAS,EAAE,IAAI;IACfG,UAAU,EAAE;EACd,CAAC;EACD,kBAAkB,EAAE;IAClBF,QAAQ,EAAE,WAAW;IACrBF,KAAK,EACH,kGAAkG;IACpGC,SAAS,EAAE,IAAI;IACfG,UAAU,EAAE;EACd,CAAC;EACD,kBAAkB,EAAE;IAClBF,QAAQ,EAAE,gBAAgB;IAC1BF,KAAK,EAAE,kEAAkE;IACzEG,OAAO,EAAE,CAAC;MAAEP,IAAI,EAAE,YAAY;MAAEE,OAAO,EAAE;IAAO,CAAC;EACnD,CAAC;EACD,2BAA2B,EAAE;IAC3BI,QAAQ,EAAE,cAAc;IACxBF,KAAK,EAAE,+BAA+B;IACtCG,OAAO,EAAER;EACX,CAAC;EACD,oBAAoB,EAAE;IACpBO,QAAQ,EAAE,iBAAiB;IAC3BF,KAAK,EAAE,0CAA0C;IACjDG,OAAO,EAAE,CACP;MAAEP,IAAI,EAAE,kBAAkB;MAAEC,MAAM,EAAE,iBAAiB;MAAEC,OAAO,EAAE;IAAM,CAAC,EACvE;MAAEF,IAAI,EAAE,YAAY;MAAEE,OAAO,EAAE;IAAO,CAAC;EAE3C;AACF,CAAC;;AAED;AACA,OAAO,MAAMO,oBAAoB,GAAGA,CAClCC,IAAY,EACZC,SAAkC,KAChB;EAClB,MAAMC,SAAS,GAAGD,SAAS,GACvB;IAAE,GAAGR,uBAAuB;IAAE,GAAGQ;EAAU,CAAC,GAC5CR,uBAAuB;EAC3B,OACES,SAAS,CAACF,IAAI,CAA0B,IACxCE,SAAS,CAAC,6BAA6B,CAAC;AAE5C,CAAC","ignoreList":[]}
+{"version":3,"names":["retryButton","text","action","variant","noAnswerTemplate","title","showChips","interruptedTitle","freshStartTemplate","chipsLabel","DEFAULT_ERROR_TEMPLATES","iconType","buttons","resolveErrorTemplate","type","overrides","templates"],"sources":["../../../src/errors/errorTemplates.ts"],"sourcesContent":["import type { ConversationErrorType } from './conversationErrorTypes';\n\n/** Action identifiers for error template buttons — resolved to callbacks by the rendering component */\nexport type ErrorActionType = 'retry' | 'newConversation' | 'reload';\n\n/** Icon identifiers for error templates — resolved to SVG components by the rendering component */\nexport type ErrorIconType =\n  | 'error-500'\n  | 'timeout'\n  | 'streaming-error'\n  | 'not-found'\n  | 'forbidden'\n  | 'partial-load'\n  | 'quota-exceeded';\n\nexport interface ErrorTemplateButton {\n  text: string;\n  /** URL for navigation (renders as a link) */\n  href?: string;\n  /** Action identifier — component resolves to a callback */\n  action?: ErrorActionType;\n  variant: 'cta' | 'link';\n}\n\nexport interface ErrorTemplate {\n  title: string;\n  subtitle?: string;\n  /** Icon identifier — component resolves to an SVG */\n  iconType?: ErrorIconType;\n  buttons?: ErrorTemplateButton[];\n  showChips?: boolean;\n  chipsLabel?: string;\n}\n\nexport type ErrorTemplateOverrides = Partial<\n  Record<ConversationErrorType, ErrorTemplate>\n>;\n\n/**\n * The eleven error types collapse into five states a shopper can act on\n * (B2B-4615). Each state has one job, so each has one line and at most one\n * action:\n *\n *   A · No answer   — llm-error-text, llm-empty-response\n *   B · Interrupted  — 500, generic-network-error, timeout, streaming-error,\n *                       history-load-error\n *   C · Fresh start  — 403, 404\n *   D · Partial      — partial-load\n *   E · Quota        — 429\n *\n * `iconType` stays on every template that had one: the new design drops icons,\n * but w5-client-circana and w5-client-feature-com still read the field and\n * must keep the look they have.\n */\n\nconst retryButton: ErrorTemplateButton[] = [\n  { text: 'Try again', action: 'retry', variant: 'cta' },\n];\n\n/** A · No answer — nothing to retry, so it offers somewhere else to go. */\nconst noAnswerTemplate: ErrorTemplate = {\n  title: \"I can't help with that one \\u2014 but I can help with these.\",\n  showChips: true,\n};\n\n/** B · Interrupted — the message is still there to send again. */\nconst interruptedTitle = \"That didn't come through. Let's try again.\";\n\n/** C · Fresh start — the thread is gone; hand the conversation back. */\nconst freshStartTemplate: ErrorTemplate = {\n  title: \"We're starting fresh \\u2014 earlier messages aren't saved.\",\n  showChips: true,\n  chipsLabel: 'Ask anything to pick up again',\n};\n\nexport const DEFAULT_ERROR_TEMPLATES: Record<\n  ConversationErrorType,\n  ErrorTemplate\n> = {\n  'conversation-llm-error-text': noAnswerTemplate,\n  'conversation-llm-empty-response': noAnswerTemplate,\n  'conversation-500': {\n    iconType: 'error-500',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  'conversation-generic-network-error': {\n    iconType: 'timeout',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  'conversation-timeout': {\n    iconType: 'timeout',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  'conversation-streaming-error': {\n    iconType: 'streaming-error',\n    title: interruptedTitle,\n    buttons: retryButton,\n  },\n  // Same state as the four above, deliberately not the same action: a history\n  // load fails before there is a last message, so `retry` has nothing to\n  // re-send and would sit there doing nothing.\n  'history-load-error': {\n    iconType: 'streaming-error',\n    title: interruptedTitle,\n    buttons: [{ text: 'Try again', action: 'reload', variant: 'cta' }],\n  },\n  'conversation-403': { iconType: 'forbidden', ...freshStartTemplate },\n  'conversation-404': { iconType: 'not-found', ...freshStartTemplate },\n  // D · Partial — an answer DID render; some of it is missing. This one is\n  // appended to the answer rather than replacing it.\n  'conversation-partial-load': {\n    iconType: 'partial-load',\n    title: \"Some of this didn't load.\",\n    buttons: [{ text: 'Reload', action: 'reload', variant: 'cta' }],\n  },\n  // E · Quota — waiting is the only fix, so the copy asks for time.\n  'conversation-429': {\n    iconType: 'quota-exceeded',\n    title: 'I need a minute to catch up. Try again shortly.',\n    buttons: retryButton,\n  },\n};\n\n/** Resolves the error template for a given type, merging client overrides on top of defaults */\nexport const resolveErrorTemplate = (\n  type: string,\n  overrides?: ErrorTemplateOverrides,\n): ErrorTemplate => {\n  const templates = overrides\n    ? { ...DEFAULT_ERROR_TEMPLATES, ...overrides }\n    : DEFAULT_ERROR_TEMPLATES;\n  return (\n    templates[type as ConversationErrorType] ??\n    templates['conversation-llm-error-text']\n  );\n};\n"],"mappings":"AAEA;;AAGA;;AAiCA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,MAAMA,WAAkC,GAAG,CACzC;EAAEC,IAAI,EAAE,WAAW;EAAEC,MAAM,EAAE,OAAO;EAAEC,OAAO,EAAE;AAAM,CAAC,CACvD;;AAED;AACA,MAAMC,gBAA+B,GAAG;EACtCC,KAAK,EAAE,8DAA8D;EACrEC,SAAS,EAAE;AACb,CAAC;;AAED;AACA,MAAMC,gBAAgB,GAAG,4CAA4C;;AAErE;AACA,MAAMC,kBAAiC,GAAG;EACxCH,KAAK,EAAE,4DAA4D;EACnEC,SAAS,EAAE,IAAI;EACfG,UAAU,EAAE;AACd,CAAC;AAED,OAAO,MAAMC,uBAGZ,GAAG;EACF,6BAA6B,EAAEN,gBAAgB;EAC/C,iCAAiC,EAAEA,gBAAgB;EACnD,kBAAkB,EAAE;IAClBO,QAAQ,EAAE,WAAW;IACrBN,KAAK,EAAEE,gBAAgB;IACvBK,OAAO,EAAEZ;EACX,CAAC;EACD,oCAAoC,EAAE;IACpCW,QAAQ,EAAE,SAAS;IACnBN,KAAK,EAAEE,gBAAgB;IACvBK,OAAO,EAAEZ;EACX,CAAC;EACD,sBAAsB,EAAE;IACtBW,QAAQ,EAAE,SAAS;IACnBN,KAAK,EAAEE,gBAAgB;IACvBK,OAAO,EAAEZ;EACX,CAAC;EACD,8BAA8B,EAAE;IAC9BW,QAAQ,EAAE,iBAAiB;IAC3BN,KAAK,EAAEE,gBAAgB;IACvBK,OAAO,EAAEZ;EACX,CAAC;EACD;EACA;EACA;EACA,oBAAoB,EAAE;IACpBW,QAAQ,EAAE,iBAAiB;IAC3BN,KAAK,EAAEE,gBAAgB;IACvBK,OAAO,EAAE,CAAC;MAAEX,IAAI,EAAE,WAAW;MAAEC,MAAM,EAAE,QAAQ;MAAEC,OAAO,EAAE;IAAM,CAAC;EACnE,CAAC;EACD,kBAAkB,EAAE;IAAEQ,QAAQ,EAAE,WAAW;IAAE,GAAGH;EAAmB,CAAC;EACpE,kBAAkB,EAAE;IAAEG,QAAQ,EAAE,WAAW;IAAE,GAAGH;EAAmB,CAAC;EACpE;EACA;EACA,2BAA2B,EAAE;IAC3BG,QAAQ,EAAE,cAAc;IACxBN,KAAK,EAAE,2BAA2B;IAClCO,OAAO,EAAE,CAAC;MAAEX,IAAI,EAAE,QAAQ;MAAEC,MAAM,EAAE,QAAQ;MAAEC,OAAO,EAAE;IAAM,CAAC;EAChE,CAAC;EACD;EACA,kBAAkB,EAAE;IAClBQ,QAAQ,EAAE,gBAAgB;IAC1BN,KAAK,EAAE,iDAAiD;IACxDO,OAAO,EAAEZ;EACX;AACF,CAAC;;AAED;AACA,OAAO,MAAMa,oBAAoB,GAAGA,CAClCC,IAAY,EACZC,SAAkC,KAChB;EAClB,MAAMC,SAAS,GAAGD,SAAS,GACvB;IAAE,GAAGL,uBAAuB;IAAE,GAAGK;EAAU,CAAC,GAC5CL,uBAAuB;EAC3B,OACEM,SAAS,CAACF,IAAI,CAA0B,IACxCE,SAAS,CAAC,6BAA6B,CAAC;AAE5C,CAAC","ignoreList":[]}

package/dist/esm/styles/base-tokens.css

@@ -8,7 +8,12 @@
   /* Color tokens — HSL triplets */
   --background: 0 0% 100%;
   --foreground: 0 0% 3.9%;
-  --card: 0 0% 100%;
+  /* A card must not dissolve into the page it sits on. Until the seed's
+   * migration to `bg-card` this separation was drawn the other way round —
+   * section bands were `bg-muted` and cards were the pure `--background` — so
+   * the tint moves onto the card and `--background` goes back to meaning what
+   * it says: the page. Same two greys, opposite surfaces. */
+  --card: 0 0% 96.1%;
   --card-foreground: 0 0% 3.9%;
   --popover: 0 0% 100%;
   --popover-foreground: 0 0% 3.9%;
@@ -113,7 +118,7 @@
 .dark {
   --background: 0 0% 3.9%;
   --foreground: 0 0% 98%;
-  --card: 0 0% 3.9%;
+  --card: 0 0% 14.9%;
   --card-foreground: 0 0% 98%;
   --popover: 0 0% 3.9%;
   --popover-foreground: 0 0% 98%;

package/dist/esm/theme/tokenContract.js

@@ -65,11 +65,19 @@
  * with no name, and a label on a token nobody may set is a promise the panel
  * cannot keep. One argument, one decision.
  *
- * Labels are the merchant's words rather than the token's — "Buttons & links",
- * not "primary". Someone choosing their shop's colours is not reading a design
+ * Labels are the merchant's words rather than the token's — "Card background",
+ * not "card". Someone choosing their shop's colours is not reading a design
  * system, and `--primary-foreground` is not a colour anyone picks: it is
  * whatever stays legible ON primary, which the theme derives. Exposing the
  * derived half is how a panel produces white text on a white button.
+ *
+ * Only FOUR carry a label (product request, 2026-09-09): the page's surface and
+ * text, and a card's. They are the four a shop owner can point at on the page
+ * and name without being taught the vocabulary, and — unlike `--secondary`,
+ * `--accent` or `--muted`, which the importer MIXES from the anchors — they are
+ * independent of each other, so setting one cannot contradict the arithmetic
+ * that produced another. Everything else stays import-only: the store still
+ * fills it, the panel just does not offer it.
  */
 const brandColor = label => ({
   bucket: 'brand',
@@ -91,21 +99,21 @@ const brandColor = label => ({
  */
 export const THEME_TOKEN_CONTRACT = Object.freeze({
   // ── brand · colour roles (18) ────────────────────────────────────────────
-  '--background': brandColor('Page background'),
-  '--foreground': brandColor('Text'),
-  '--card': brandColor(),
-  '--card-foreground': brandColor(),
+  '--background': brandColor('Background color'),
+  '--foreground': brandColor('Text color'),
+  '--card': brandColor('Card background'),
+  '--card-foreground': brandColor('Card text'),
   '--popover': brandColor(),
   '--popover-foreground': brandColor(),
-  '--primary': brandColor('Buttons & links'),
+  '--primary': brandColor(),
   '--primary-foreground': brandColor(),
   '--secondary': brandColor(),
   '--secondary-foreground': brandColor(),
   '--muted': brandColor(),
   '--muted-foreground': brandColor(),
-  '--accent': brandColor('Highlights'),
+  '--accent': brandColor(),
   '--accent-foreground': brandColor(),
-  '--border': brandColor('Lines & borders'),
+  '--border': brandColor(),
   '--input': brandColor(),
   '--ring': brandColor(),
   /**
@@ -115,7 +123,7 @@ export const THEME_TOKEN_CONTRACT = Object.freeze({
    * emits the other twenty. A store that states a distinct heading colour has
    * somewhere for it to go the moment an adapter learns to read one.
    */
-  '--heading': brandColor('Headings'),
+  '--heading': brandColor(),
   // ── brand · type (2) ─────────────────────────────────────────────────────
   '--font-sans': {
     bucket: 'brand',
@@ -130,14 +138,15 @@ export const THEME_TOKEN_CONTRACT = Object.freeze({
   // ── host · shape (1) ─────────────────────────────────────────────────────
   /**
    * The one token whose bucket changed, and the reason this contract exists.
-   * Editable because it is the one value a store and a template are known to
-   * disagree about in a way a merchant can see and wants to settle.
+   * A store's imported radius still reaches the page as `--web5-host-radius`
+   * and a template still beats it; what changed is that the OWNER no longer
+   * gets a control for it — the panel is four colours now, and shape is not
+   * one of them.
    */
   '--radius': {
     bucket: 'host',
     type: 'length',
-    editable: true,
-    label: 'Corner rounding'
+    editable: false
   }
 });
 
@@ -169,8 +178,9 @@ export const TOKEN_NAME_PATTERN = /^--[a-z0-9-]+$/;
  * Derived from the contract rather than listed again beside it, so a token
  * cannot be editable in one place and absent from the other. The order is the
  * declaration order above, which reads outside-in — the page, then its text,
- * then the things drawn on it — and is a better first impression than
- * alphabetical or than the order the tokens happen to be defined for CSS.
+ * then the card drawn on it, then the card's text — and is a better first
+ * impression than alphabetical or than the order the tokens happen to be
+ * defined for CSS.
  */
 export const EDITABLE_TOKENS = Object.freeze(Object.entries(THEME_TOKEN_CONTRACT).filter(_ref3 => {
   let [, entry] = _ref3;

package/dist/esm/theme/tokenContract.js.map

@@ -1 +1 @@
-{"version":3,"names":["brandColor","label","bucket","type","editable","undefined","THEME_TOKEN_CONTRACT","Object","freeze","BRAND_TOKENS","Set","entries","filter","_ref","entry","map","_ref2","token","TOKEN_NAME_PATTERN","EDITABLE_TOKENS","_ref3","hostAliasFor","slice","bucketOf","_THEME_TOKEN_CONTRACT"],"sources":["../../../src/theme/tokenContract.ts"],"sourcesContent":["/**\n * The theme-token contract (DL #193).\n *\n * One home for the answer to \"who is allowed to set this token, and who wins\n * when more than one of them does\". Three things need that answer and must not\n * each keep their own copy:\n *\n *   - **`applyThemeOverrides`** decides, per key, whether to write the real\n *     token or its `--web5-host-*` alias.\n *   - **the seed's `validate-templates`** fails a template that sets a brand\n *     token.\n *   - **the shop owner's panel** renders a control per `editable` entry.\n *\n * A leaf module beside `hostScope.ts`, and for the same reason: both are data\n * that several packages must agree on, and both have to be readable from plain\n * Node tooling. Requiring this package's ENTRY from Node fails — the CSS import\n * in it is a syntax error to the CJS loader, which is what `scope-css.ts`\n * documents — but a deep import of a leaf like this one works, so the seed's\n * validator can read it without loading a component library.\n *\n * It was briefly its own package. That was justified by `embed-loader` needing\n * the list without taking core's eleven dependencies — and the loader turned\n * out not to need it at all, because `applyThemeOverrides` has owned runtime\n * token injection here since DL #131.\n *\n * ## The two buckets\n *\n * The split is about who WINS, not about what may be imported. A platform\n * adapter is free to read anything the store states; the bucket decides what\n * happens when a template has an opinion about the same token.\n *\n * - `brand` — the store's identity: colour roles and font families. The\n *   imported value is written as the real token, last, so it wins\n *   unconditionally. A template is not permitted to set these.\n * - `host`  — the store's shape: corner radius today. The imported value is\n *   written as `--web5-host-<name>` and consumed by core as a `var()`\n *   fallback, so a template stating the real token beats it and a template\n *   that stays silent inherits the store's.\n *\n * A token absent from this map is treated as `host`. That is deliberate and\n * safe: an alias nothing consumes renders nothing, so an adapter that learns\n * to read a token core has never heard of cannot override a template by\n * accident. The wiring line in core is the real gate for a host token, not the\n * entry here.\n *\n * ## Why all but one are brand\n *\n * This is not a new taxonomy. Twenty of these are the set\n * `web50-shopify-adapter` already emits, with a bucket attached; the\n * twenty-first, `--heading`, has been in core's catalogue since DL #131 and is\n * consumed by the seed, but no adapter fills it yet. Exactly one token changes\n * hands relative to the behaviour before DL #193 — `--radius`, which used to\n * win against the template that had chosen a different one. That single\n * misfiling is the whole of the bug this contract exists to fix.\n */\n\n/** How a value is spelled, which is what makes validation possible. */\nexport type TokenType =\n  /** An HSL triplet with no `hsl()` wrapper — `0 0% 9%`. The core bridge wraps it. */\n  | 'color-hsl'\n  /** A CSS font stack — `'Poppins', ui-sans-serif, sans-serif`. */\n  | 'font-stack'\n  /** A CSS length. MUST carry a unit: a bare `0` turns `calc(var(--radius) - 4px)`\n   *  into a type error and takes the derived radius scale out entirely. */\n  | 'length';\n\n/** Which layer wins when both a store and a template state this token. */\nexport type TokenBucket = 'brand' | 'host';\n\nexport interface TokenContractEntry {\n  bucket: TokenBucket;\n  type: TokenType;\n  /** May the shop owner set this from the panel? */\n  editable: boolean;\n  /** Shown in the owner's panel. Absent for entries that are not editable. */\n  label?: string;\n}\n\n/**\n * A colour role. Giving one a label is what puts it in the owner's panel.\n *\n * The two travel together on purpose: `editable` without a label is a control\n * with no name, and a label on a token nobody may set is a promise the panel\n * cannot keep. One argument, one decision.\n *\n * Labels are the merchant's words rather than the token's — \"Buttons & links\",\n * not \"primary\". Someone choosing their shop's colours is not reading a design\n * system, and `--primary-foreground` is not a colour anyone picks: it is\n * whatever stays legible ON primary, which the theme derives. Exposing the\n * derived half is how a panel produces white text on a white button.\n */\nconst brandColor = (label?: string): TokenContractEntry => ({\n  bucket: 'brand',\n  type: 'color-hsl',\n  editable: label !== undefined,\n  ...(label === undefined ? {} : { label }),\n});\n\n/**\n * Every token a platform adapter may meaningfully emit today.\n *\n * Growth is adapter-driven on purpose: a token joins when an adapter can\n * actually read it, not on spec. `theme_overrides` is capped at 32 entries by\n * its proto, so there are twelve slots left and no reason to spend them on\n * speculation. `--spacing` is the tempting next one and should be resisted —\n * it scales every `p-*`, `m-*` and `gap-*` in the bundle from one number.\n */\nexport const THEME_TOKEN_CONTRACT: Readonly<Record<string, TokenContractEntry>> =\n  Object.freeze({\n    // ── brand · colour roles (18) ────────────────────────────────────────────\n    '--background': brandColor('Page background'),\n    '--foreground': brandColor('Text'),\n    '--card': brandColor(),\n    '--card-foreground': brandColor(),\n    '--popover': brandColor(),\n    '--popover-foreground': brandColor(),\n    '--primary': brandColor('Buttons & links'),\n    '--primary-foreground': brandColor(),\n    '--secondary': brandColor(),\n    '--secondary-foreground': brandColor(),\n    '--muted': brandColor(),\n    '--muted-foreground': brandColor(),\n    '--accent': brandColor('Highlights'),\n    '--accent-foreground': brandColor(),\n    '--border': brandColor('Lines & borders'),\n    '--input': brandColor(),\n    '--ring': brandColor(),\n\n    /**\n     * Brand-shaped and supported end to end, but no adapter fills it yet: the\n     * seed consumes it (`--color-heading-fg: hsl(var(--heading, var(--foreground)))`)\n     * and core has catalogued it since DL #131, while `web50-shopify-adapter`\n     * emits the other twenty. A store that states a distinct heading colour has\n     * somewhere for it to go the moment an adapter learns to read one.\n     */\n    '--heading': brandColor('Headings'),\n\n    // ── brand · type (2) ─────────────────────────────────────────────────────\n    '--font-sans': { bucket: 'brand', type: 'font-stack', editable: false },\n    '--font-display': { bucket: 'brand', type: 'font-stack', editable: false },\n\n    // ── host · shape (1) ─────────────────────────────────────────────────────\n    /**\n     * The one token whose bucket changed, and the reason this contract exists.\n     * Editable because it is the one value a store and a template are known to\n     * disagree about in a way a merchant can see and wants to settle.\n     */\n    '--radius': {\n      bucket: 'host',\n      type: 'length',\n      editable: true,\n      label: 'Corner rounding',\n    },\n  });\n\n/**\n * The tokens written directly, which is the only question the loader has to\n * answer per key — everything else takes the alias path.\n */\nexport const BRAND_TOKENS: ReadonlySet<string> = Object.freeze(\n  new Set(\n    Object.entries(THEME_TOKEN_CONTRACT)\n      .filter(([, entry]) => entry.bucket === 'brand')\n      .map(([token]) => token),\n  ),\n) as ReadonlySet<string>;\n\n/**\n * A token name we are willing to compose into a CSS declaration.\n *\n * The keys reaching the loader came out of a backend map, which came out of an\n * adapter reading a merchant's theme file. A key carrying `:` or `;` would\n * write arbitrary declarations onto the mount, so the shape is checked where\n * the declaration is built rather than trusted from the source.\n */\nexport const TOKEN_NAME_PATTERN = /^--[a-z0-9-]+$/;\n\n/**\n * What the owner's panel offers, in the order it offers it.\n *\n * Derived from the contract rather than listed again beside it, so a token\n * cannot be editable in one place and absent from the other. The order is the\n * declaration order above, which reads outside-in — the page, then its text,\n * then the things drawn on it — and is a better first impression than\n * alphabetical or than the order the tokens happen to be defined for CSS.\n */\nexport const EDITABLE_TOKENS: readonly (readonly [\n  token: string,\n  entry: TokenContractEntry,\n])[] = Object.freeze(\n  Object.entries(THEME_TOKEN_CONTRACT).filter(([, entry]) => entry.editable),\n) as readonly (readonly [string, TokenContractEntry])[];\n\n/** `--radius` → `--web5-host-radius`. Derived, never stored: one fewer thing to get wrong. */\nexport function hostAliasFor(token: string): string {\n  return `--web5-host-${token.slice(2)}`;\n}\n\n/** Whether this token is written directly (brand) or as an alias (host, and anything unknown). */\nexport function bucketOf(token: string): TokenBucket {\n  return THEME_TOKEN_CONTRACT[token]?.bucket ?? 'host';\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["brandColor","label","bucket","type","editable","undefined","THEME_TOKEN_CONTRACT","Object","freeze","BRAND_TOKENS","Set","entries","filter","_ref","entry","map","_ref2","token","TOKEN_NAME_PATTERN","EDITABLE_TOKENS","_ref3","hostAliasFor","slice","bucketOf","_THEME_TOKEN_CONTRACT"],"sources":["../../../src/theme/tokenContract.ts"],"sourcesContent":["/**\n * The theme-token contract (DL #193).\n *\n * One home for the answer to \"who is allowed to set this token, and who wins\n * when more than one of them does\". Three things need that answer and must not\n * each keep their own copy:\n *\n *   - **`applyThemeOverrides`** decides, per key, whether to write the real\n *     token or its `--web5-host-*` alias.\n *   - **the seed's `validate-templates`** fails a template that sets a brand\n *     token.\n *   - **the shop owner's panel** renders a control per `editable` entry.\n *\n * A leaf module beside `hostScope.ts`, and for the same reason: both are data\n * that several packages must agree on, and both have to be readable from plain\n * Node tooling. Requiring this package's ENTRY from Node fails — the CSS import\n * in it is a syntax error to the CJS loader, which is what `scope-css.ts`\n * documents — but a deep import of a leaf like this one works, so the seed's\n * validator can read it without loading a component library.\n *\n * It was briefly its own package. That was justified by `embed-loader` needing\n * the list without taking core's eleven dependencies — and the loader turned\n * out not to need it at all, because `applyThemeOverrides` has owned runtime\n * token injection here since DL #131.\n *\n * ## The two buckets\n *\n * The split is about who WINS, not about what may be imported. A platform\n * adapter is free to read anything the store states; the bucket decides what\n * happens when a template has an opinion about the same token.\n *\n * - `brand` — the store's identity: colour roles and font families. The\n *   imported value is written as the real token, last, so it wins\n *   unconditionally. A template is not permitted to set these.\n * - `host`  — the store's shape: corner radius today. The imported value is\n *   written as `--web5-host-<name>` and consumed by core as a `var()`\n *   fallback, so a template stating the real token beats it and a template\n *   that stays silent inherits the store's.\n *\n * A token absent from this map is treated as `host`. That is deliberate and\n * safe: an alias nothing consumes renders nothing, so an adapter that learns\n * to read a token core has never heard of cannot override a template by\n * accident. The wiring line in core is the real gate for a host token, not the\n * entry here.\n *\n * ## Why all but one are brand\n *\n * This is not a new taxonomy. Twenty of these are the set\n * `web50-shopify-adapter` already emits, with a bucket attached; the\n * twenty-first, `--heading`, has been in core's catalogue since DL #131 and is\n * consumed by the seed, but no adapter fills it yet. Exactly one token changes\n * hands relative to the behaviour before DL #193 — `--radius`, which used to\n * win against the template that had chosen a different one. That single\n * misfiling is the whole of the bug this contract exists to fix.\n */\n\n/** How a value is spelled, which is what makes validation possible. */\nexport type TokenType =\n  /** An HSL triplet with no `hsl()` wrapper — `0 0% 9%`. The core bridge wraps it. */\n  | 'color-hsl'\n  /** A CSS font stack — `'Poppins', ui-sans-serif, sans-serif`. */\n  | 'font-stack'\n  /** A CSS length. MUST carry a unit: a bare `0` turns `calc(var(--radius) - 4px)`\n   *  into a type error and takes the derived radius scale out entirely. */\n  | 'length';\n\n/** Which layer wins when both a store and a template state this token. */\nexport type TokenBucket = 'brand' | 'host';\n\nexport interface TokenContractEntry {\n  bucket: TokenBucket;\n  type: TokenType;\n  /** May the shop owner set this from the panel? */\n  editable: boolean;\n  /** Shown in the owner's panel. Absent for entries that are not editable. */\n  label?: string;\n}\n\n/**\n * A colour role. Giving one a label is what puts it in the owner's panel.\n *\n * The two travel together on purpose: `editable` without a label is a control\n * with no name, and a label on a token nobody may set is a promise the panel\n * cannot keep. One argument, one decision.\n *\n * Labels are the merchant's words rather than the token's — \"Card background\",\n * not \"card\". Someone choosing their shop's colours is not reading a design\n * system, and `--primary-foreground` is not a colour anyone picks: it is\n * whatever stays legible ON primary, which the theme derives. Exposing the\n * derived half is how a panel produces white text on a white button.\n *\n * Only FOUR carry a label (product request, 2026-09-09): the page's surface and\n * text, and a card's. They are the four a shop owner can point at on the page\n * and name without being taught the vocabulary, and — unlike `--secondary`,\n * `--accent` or `--muted`, which the importer MIXES from the anchors — they are\n * independent of each other, so setting one cannot contradict the arithmetic\n * that produced another. Everything else stays import-only: the store still\n * fills it, the panel just does not offer it.\n */\nconst brandColor = (label?: string): TokenContractEntry => ({\n  bucket: 'brand',\n  type: 'color-hsl',\n  editable: label !== undefined,\n  ...(label === undefined ? {} : { label }),\n});\n\n/**\n * Every token a platform adapter may meaningfully emit today.\n *\n * Growth is adapter-driven on purpose: a token joins when an adapter can\n * actually read it, not on spec. `theme_overrides` is capped at 32 entries by\n * its proto, so there are twelve slots left and no reason to spend them on\n * speculation. `--spacing` is the tempting next one and should be resisted —\n * it scales every `p-*`, `m-*` and `gap-*` in the bundle from one number.\n */\nexport const THEME_TOKEN_CONTRACT: Readonly<Record<string, TokenContractEntry>> =\n  Object.freeze({\n    // ── brand · colour roles (18) ────────────────────────────────────────────\n    '--background': brandColor('Background color'),\n    '--foreground': brandColor('Text color'),\n    '--card': brandColor('Card background'),\n    '--card-foreground': brandColor('Card text'),\n    '--popover': brandColor(),\n    '--popover-foreground': brandColor(),\n    '--primary': brandColor(),\n    '--primary-foreground': brandColor(),\n    '--secondary': brandColor(),\n    '--secondary-foreground': brandColor(),\n    '--muted': brandColor(),\n    '--muted-foreground': brandColor(),\n    '--accent': brandColor(),\n    '--accent-foreground': brandColor(),\n    '--border': brandColor(),\n    '--input': brandColor(),\n    '--ring': brandColor(),\n\n    /**\n     * Brand-shaped and supported end to end, but no adapter fills it yet: the\n     * seed consumes it (`--color-heading-fg: hsl(var(--heading, var(--foreground)))`)\n     * and core has catalogued it since DL #131, while `web50-shopify-adapter`\n     * emits the other twenty. A store that states a distinct heading colour has\n     * somewhere for it to go the moment an adapter learns to read one.\n     */\n    '--heading': brandColor(),\n\n    // ── brand · type (2) ─────────────────────────────────────────────────────\n    '--font-sans': { bucket: 'brand', type: 'font-stack', editable: false },\n    '--font-display': { bucket: 'brand', type: 'font-stack', editable: false },\n\n    // ── host · shape (1) ─────────────────────────────────────────────────────\n    /**\n     * The one token whose bucket changed, and the reason this contract exists.\n     * A store's imported radius still reaches the page as `--web5-host-radius`\n     * and a template still beats it; what changed is that the OWNER no longer\n     * gets a control for it — the panel is four colours now, and shape is not\n     * one of them.\n     */\n    '--radius': {\n      bucket: 'host',\n      type: 'length',\n      editable: false,\n    },\n  });\n\n/**\n * The tokens written directly, which is the only question the loader has to\n * answer per key — everything else takes the alias path.\n */\nexport const BRAND_TOKENS: ReadonlySet<string> = Object.freeze(\n  new Set(\n    Object.entries(THEME_TOKEN_CONTRACT)\n      .filter(([, entry]) => entry.bucket === 'brand')\n      .map(([token]) => token),\n  ),\n) as ReadonlySet<string>;\n\n/**\n * A token name we are willing to compose into a CSS declaration.\n *\n * The keys reaching the loader came out of a backend map, which came out of an\n * adapter reading a merchant's theme file. A key carrying `:` or `;` would\n * write arbitrary declarations onto the mount, so the shape is checked where\n * the declaration is built rather than trusted from the source.\n */\nexport const TOKEN_NAME_PATTERN = /^--[a-z0-9-]+$/;\n\n/**\n * What the owner's panel offers, in the order it offers it.\n *\n * Derived from the contract rather than listed again beside it, so a token\n * cannot be editable in one place and absent from the other. The order is the\n * declaration order above, which reads outside-in — the page, then its text,\n * then the card drawn on it, then the card's text — and is a better first\n * impression than alphabetical or than the order the tokens happen to be\n * defined for CSS.\n */\nexport const EDITABLE_TOKENS: readonly (readonly [\n  token: string,\n  entry: TokenContractEntry,\n])[] = Object.freeze(\n  Object.entries(THEME_TOKEN_CONTRACT).filter(([, entry]) => entry.editable),\n) as readonly (readonly [string, TokenContractEntry])[];\n\n/** `--radius` → `--web5-host-radius`. Derived, never stored: one fewer thing to get wrong. */\nexport function hostAliasFor(token: string): string {\n  return `--web5-host-${token.slice(2)}`;\n}\n\n/** Whether this token is written directly (brand) or as an alias (host, and anything unknown). */\nexport function bucketOf(token: string): TokenBucket {\n  return THEME_TOKEN_CONTRACT[token]?.bucket ?? 'host';\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/types/errors/errorTemplates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorTemplates.d.ts","sourceRoot":"","sources":["../../../src/errors/errorTemplates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,uGAAuG;AACvG,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAErE,mGAAmG;AACnG,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC,CAC7C,CAAC;AAOF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,qBAAqB,EACrB,aAAa,CA+Dd,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,SACzB,MAAM,cACA,sBAAsB,KACjC,aAQF,CAAC"}
+{"version":3,"file":"errorTemplates.d.ts","sourceRoot":"","sources":["../../../src/errors/errorTemplates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,uGAAuG;AACvG,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,iBAAiB,GAAG,QAAQ,CAAC;AAErE,mGAAmG;AACnG,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,MAAM,CAAC,qBAAqB,EAAE,aAAa,CAAC,CAC7C,CAAC;AAuCF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAC1C,qBAAqB,EACrB,aAAa,CA+Cd,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,SACzB,MAAM,cACA,sBAAsB,KACjC,aAQF,CAAC"}

package/dist/types/theme/tokenContract.d.ts

@@ -102,8 +102,9 @@ export declare const TOKEN_NAME_PATTERN: RegExp;
  * Derived from the contract rather than listed again beside it, so a token
  * cannot be editable in one place and absent from the other. The order is the
  * declaration order above, which reads outside-in — the page, then its text,
- * then the things drawn on it — and is a better first impression than
- * alphabetical or than the order the tokens happen to be defined for CSS.
+ * then the card drawn on it, then the card's text — and is a better first
+ * impression than alphabetical or than the order the tokens happen to be
+ * defined for CSS.
  */
 export declare const EDITABLE_TOKENS: readonly (readonly [
     token: string,

package/dist/types/theme/tokenContract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenContract.d.ts","sourceRoot":"","sources":["../../../src/theme/tokenContract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,uEAAuE;AACvE,MAAM,MAAM,SAAS;AACnB,oFAAoF;AAClF,WAAW;AACb,iEAAiE;GAC/D,YAAY;AACd;yEACyE;GACvE,QAAQ,CAAC;AAEb,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CA8C1E,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAMrB,CAAC;AAEzB;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,SAAS;IAC/C,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,kBAAkB;CAC1B,CAAC,EAEqD,CAAC;AAExD,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAEnD"}
+{"version":3,"file":"tokenContract.d.ts","sourceRoot":"","sources":["../../../src/theme/tokenContract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,uEAAuE;AACvE,MAAM,MAAM,SAAS;AACnB,oFAAoF;AAClF,WAAW;AACb,iEAAiE;GAC/D,YAAY;AACd;yEACyE;GACvE,QAAQ,CAAC;AAEb,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8BD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CA+C1E,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAMrB,CAAC;AAEzB;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAEnD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,SAAS;IAC/C,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,kBAAkB;CAC1B,CAAC,EAEqD,CAAC;AAExD,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kGAAkG;AAClG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAEnD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wix/web5-core",
   "license": "MIT",
-  "version": "1.63.38",
+  "version": "1.63.40",
   "author": {
     "name": "tsachis",
     "email": "tsachis@wix.com"
@@ -100,5 +100,5 @@
   "wallaby": {
     "autoDetect": true
   },
-  "falconPackageHash": "527f52ff447d5d61666f8af72e2f79ab513eea188fe4f1a640a38cb2"
+  "falconPackageHash": "822781481f70a468191111623bc8e82e6c573c2980eddd65f4ec07c4"
 }

package/src/styles/base-tokens.css

@@ -8,7 +8,12 @@
   /* Color tokens — HSL triplets */
   --background: 0 0% 100%;
   --foreground: 0 0% 3.9%;
-  --card: 0 0% 100%;
+  /* A card must not dissolve into the page it sits on. Until the seed's
+   * migration to `bg-card` this separation was drawn the other way round —
+   * section bands were `bg-muted` and cards were the pure `--background` — so
+   * the tint moves onto the card and `--background` goes back to meaning what
+   * it says: the page. Same two greys, opposite surfaces. */
+  --card: 0 0% 96.1%;
   --card-foreground: 0 0% 3.9%;
   --popover: 0 0% 100%;
   --popover-foreground: 0 0% 3.9%;
@@ -113,7 +118,7 @@
 .dark {
   --background: 0 0% 3.9%;
   --foreground: 0 0% 98%;
-  --card: 0 0% 3.9%;
+  --card: 0 0% 14.9%;
   --card-foreground: 0 0% 98%;
   --popover: 0 0% 3.9%;
   --popover-foreground: 0 0% 98%;