@shoplix-ai/block-kit 2.0.0 → 3.1.0

package/README.md

@@ -22,12 +22,18 @@ written against this package and nothing else from the runtime. It holds:
 - **The capability set.** `addToCart` (with optional line attributes),
   `openCart`, `beginCheckout`, `setLineQuantity`, `removeLines` (one or many
   line ids), `applyDiscountCode`, `removeDiscountCode`, `setCartNote`,
-  `setLineAttributes`. Closed, and the same list the schema package lets a
-  Block Definition declare. A cart capability resolves once Shopify accepted
-  and rejects with a `CapabilityRefusal`: the outcome (`refused`, `not_found`,
-  `failed`) and Shopify's messages; `isCapabilityRefusal` tells it apart from
-  any other rejection. Nothing repaints before Shopify's answer, and the block
-  decides how to show a refusal.
+  `setLineAttributes`, and `notificationInvitation`, the shopper's own
+  notification decision as one host state: whether the invitation is still
+  offered, the tap that opens the phone's prompt and the tap that hides it
+  until the next completed checkout. Closed, and the same list the schema
+  package lets a Block Definition declare. A cart capability resolves once Shopify accepted
+  the change it asked for and rejects with a `CapabilityRefusal`: the outcome
+  (`refused`, `not_found`, `failed`) and the messages that came with it,
+  Shopify's own or the host's where Shopify sent none — a quantity over the
+  stock is clamped by Shopify and not refused, and the host names what is left;
+  `isCapabilityRefusal` tells it apart from any other rejection. Nothing
+  repaints before Shopify's answer, and the block decides how to show a
+  refusal.
 - **The authoring shape of a Code Block.** `defineSettings()` and
   `defineBinding()` type a block's settings and binding files; `SettingsValues`
   derives the renderer's settings type from the settings file;
@@ -46,7 +52,66 @@ written against this package and nothing else from the runtime. It holds:
   currency, for display only: the total a buyer sees is always Shopify's),
   `pickLocale` (the buyer's language from the Shop's languages with default
   fallback), `localize` (one string out of a locale object), `textDirection`,
-  `imageSourceFor` (the rendition to paint at a given display width).
+  `imageSourceFor` (the rendition to paint at a given display width), and
+  `platformWords`, the word catalog below.
+
+## The theme a renderer receives
+
+`props.theme` is the Shop's tokens resolved once, by the schema package, for
+every renderer alike: the phone's, the dashboard canvas twin and the CLI's dev
+page. It carries thirteen colour roles, two type families, a corner radius and
+a spacing rhythm, and never a leaf to follow.
+
+The colour roles are `brand`, `accent`, `action`, `surface`, `elevated`,
+`text`, `muted`, `border`, `sunken`, `subtle`, `overlay`, `success` and
+`warning`. The last six answer on every theme, whether the merchant named them
+or not: a theme that names none derives them from the palette it does carry, so
+`border` is a hairline that shows on the merchant's own background, `sunken` a
+well under it, `subtle` a dimmer ink than `muted`, `overlay` a scrim in their
+own surface, and the two status colours step toward the merchant's text until
+they are legible on the merchant's surface. A theme that names one wins over
+the derivation. Draw a role rather than a hex: a merchant with a dark theme
+gets an unreadable block otherwise.
+
+A design decision too particular for a role goes in the per component tier,
+which is free form and needs no contract change. Read one through
+`componentTokenValue`, by its dotted path under that tier, with a theme role
+behind it:
+
+```ts
+const line = componentTokenValue(theme, 'divider.line', theme.colors.border);
+```
+
+Two rules hold the convention together. The path names the Block Type first
+and the part it draws second, so one Block Type's tokens sit in one group. The
+fallback is always a theme role, never a literal: a merchant who names nothing
+still gets their own palette, and the token is the escape hatch over it. A
+token of another type is not drawn, the fallback is.
+
+## The words a renderer owns
+
+A renderer never carries its own literal. Every functional word the platform
+puts on screen lives in one catalog, and a renderer reads it through
+`platformWords(language, defaultLanguage)`:
+
+```ts
+const words = platformWords(language, defaultLanguage);
+words.own('cart.checkout');
+words.merchantOr(settings.label, 'cart.subtotal');
+```
+
+A functional word is one the platform owns and the merchant never types:
+Checkout, Sold out, Subtotal, Added, Could not add. Marketing copy, a trust
+strip's promise or a promo card's headline, is merchant set localized text and
+stays out of the catalog, because no catalog can guess it. Where a Block Type
+lets the merchant overwrite a functional word, `merchantOr` takes their text
+when they wrote a language the buyer reads and the catalog's word otherwise.
+
+The catalog answers in English, Arabic and Turkish. A language it does not
+carry falls back to English, written down here rather than left to whichever
+string sits first in an object. Every language answers every key of
+`WORD_KEYS`, which the type system and a test both hold; a word added in
+English and nowhere else does not compile.
 
 ## Rows: what the host lays out
 

package/dist/capabilities.d.ts

@@ -1,12 +1,13 @@
 import { type BlockCapabilityName, type CartAttribute } from '@shoplix-ai/sdui-schema';
 /**
  * The closed capability set. A renderer reaches commerce only through these
- * nine; the Storefront token, the cart id and navigation never cross the
- * contract. The set is code, never document content, and it does not grow
- * without a new contract major. The schema package names the same list, so a
- * Block Definition can declare only what a renderer can be handed.
+ * nine, and the shopper's notification decision only through the tenth; the
+ * Storefront token, the cart id and navigation never cross the contract. The
+ * set is code, never document content, and it does not grow without a new
+ * contract major. The schema package names the same list, so a Block
+ * Definition can declare only what a renderer can be handed.
  */
-export declare const CAPABILITY_NAMES: readonly ["addToCart", "openCart", "beginCheckout", "setLineQuantity", "removeLines", "applyDiscountCode", "removeDiscountCode", "setCartNote", "setLineAttributes"];
+export declare const CAPABILITY_NAMES: readonly ["addToCart", "openCart", "beginCheckout", "setLineQuantity", "removeLines", "applyDiscountCode", "removeDiscountCode", "setCartNote", "setLineAttributes", "notificationInvitation"];
 export type CapabilityName = BlockCapabilityName;
 export interface CartLineInput {
     readonly variantId: string;
@@ -21,10 +22,22 @@ export interface CartLineAttributesInput {
     readonly lineId: string;
     readonly attributes: readonly CartAttribute[];
 }
+/**
+ * The Notification Invitation as a renderer sees it: whether there is still
+ * anything to ask, the tap that opens the phone's own prompt, and the tap
+ * that hides the invitation until the shopper's next completed checkout. One
+ * host state, so two blocks on one device never disagree.
+ */
+export interface NotificationInvitation {
+    readonly offered: boolean;
+    readonly turnOn: () => void;
+    readonly dismiss: () => void;
+}
 /**
  * Every cart capability answers through the host's one serialized queue and
- * resolves once Shopify accepted; it rejects with a CapabilityRefusal, and
- * the held cart repaints only on Shopify's answer, never before.
+ * resolves once Shopify accepted the change it was asked for; it rejects with
+ * a CapabilityRefusal, and the held cart repaints only on Shopify's answer,
+ * never before.
  */
 export interface Capabilities {
     readonly addToCart: (line: CartLineInput) => Promise<void>;
@@ -36,19 +49,22 @@ export interface Capabilities {
     readonly removeDiscountCode: (code: string) => Promise<void>;
     readonly setCartNote: (note: string) => Promise<void>;
     readonly setLineAttributes: (input: CartLineAttributesInput) => Promise<void>;
+    readonly notificationInvitation: NotificationInvitation;
 }
 /** What a renderer sees: exactly the capabilities its Block Type declared. */
 export type CapabilityObject<K extends CapabilityName = never> = Pick<Capabilities, K>;
 /**
- * Why a capability's promise rejected: Shopify refused the change (a quantity
- * it will not sell, a code it does not honour), the cart is gone, or the call
- * never got an answer.
+ * Why a capability's promise rejected: the change did not land (a quantity the
+ * shop will not sell, a code it does not honour), the cart is gone, or the
+ * call never got an answer.
  */
 export type CapabilityOutcome = 'refused' | 'not_found' | 'failed';
 /**
- * The typed refusal a cart capability rejects with: the outcome, and what
- * Shopify said, in the buyer's language where Shopify gave it. A block
- * decides how to show it; the host never shows it for the block.
+ * The typed refusal a cart capability rejects with: the outcome, and the words
+ * that came with it in the buyer's language — Shopify's own, or the host's
+ * where Shopify sent none, as it does for a quantity it silently clamps to the
+ * stock left. A block decides how to show it; the host never shows it for the
+ * block.
  */
 export declare class CapabilityRefusal extends Error {
     readonly outcome: CapabilityOutcome;

package/dist/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,sKAAyB,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/E;AAED,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAQnE;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE;IAJtC,SAAkB,IAAI,uBAAuB;gBAGlC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE;CAIvC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAU9E"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,gMAAyB,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;CACzD;AAED,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAQnE;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE;IAJtC,SAAkB,IAAI,uBAAuB;gBAGlC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE;CAIvC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAU9E"}

package/dist/capabilities.js

@@ -1,10 +1,11 @@
 import { BLOCK_CAPABILITY_NAMES, } from '@shoplix-ai/sdui-schema';
 /**
  * The closed capability set. A renderer reaches commerce only through these
- * nine; the Storefront token, the cart id and navigation never cross the
- * contract. The set is code, never document content, and it does not grow
- * without a new contract major. The schema package names the same list, so a
- * Block Definition can declare only what a renderer can be handed.
+ * nine, and the shopper's notification decision only through the tenth; the
+ * Storefront token, the cart id and navigation never cross the contract. The
+ * set is code, never document content, and it does not grow without a new
+ * contract major. The schema package names the same list, so a Block
+ * Definition can declare only what a renderer can be handed.
  */
 export const CAPABILITY_NAMES = BLOCK_CAPABILITY_NAMES;
 const OUTCOMES = new Set([
@@ -13,9 +14,11 @@ const OUTCOMES = new Set([
     'failed',
 ]);
 /**
- * The typed refusal a cart capability rejects with: the outcome, and what
- * Shopify said, in the buyer's language where Shopify gave it. A block
- * decides how to show it; the host never shows it for the block.
+ * The typed refusal a cart capability rejects with: the outcome, and the words
+ * that came with it in the buyer's language — Shopify's own, or the host's
+ * where Shopify sent none, as it does for a quantity it silently clamps to the
+ * stock left. A block decides how to show it; the host never shows it for the
+ * block.
  */
 export class CapabilityRefusal extends Error {
     outcome;

package/dist/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AA+CvD,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAoB;IAC/D,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAI/B;IACA;IAJO,IAAI,GAAG,mBAAmB,CAAC;IAE7C,YACW,OAA0B,EAC1B,QAA2B;QAEpC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAHjD,YAAO,GAAP,OAAO,CAAmB;QAC1B,aAAQ,GAAR,QAAQ,CAAmB;IAGtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAkE,CAAC;IAC/E,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,mBAAmB;QAChC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAC7D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAGvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AA6DvD,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAoB;IAC/D,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAI/B;IACA;IAJO,IAAI,GAAG,mBAAmB,CAAC;IAE7C,YACW,OAA0B,EAC1B,QAA2B;QAEpC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAHjD,YAAO,GAAP,OAAO,CAAmB;QAC1B,aAAQ,GAAR,QAAQ,CAAmB;IAGtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAkE,CAAC;IAC/E,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,mBAAmB;QAChC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAC7D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { CAPABILITY_NAMES, CapabilityRefusal, isCapabilityRefusal } from './capabilities.js';
-export type { Capabilities, CapabilityName, CapabilityObject, CapabilityOutcome, CartLineAttributesInput, CartLineInput, CartLineQuantityInput, } from './capabilities.js';
+export type { Capabilities, CapabilityName, CapabilityObject, CapabilityOutcome, CartLineAttributesInput, CartLineInput, CartLineQuantityInput, NotificationInvitation, } from './capabilities.js';
 export { defineBlock } from './contract.js';
 export type { BlockDefinition, BlockItemRenderProps, BlockOwner, BlockRegistration, BlockRenderProps, BlockRenderer, BlockRows, BlockSettings, CartSummary, TextDirection, } from './contract.js';
 export type { BlockNavigation } from './navigation.js';
@@ -16,4 +16,6 @@ export { imageSourceFor } from './renditions.js';
 export type { ImageSource } from './renditions.js';
 export { localize, pickLocale, textDirection } from './locale.js';
 export type { ShopLanguages } from './locale.js';
+export { CATALOG_LANGUAGES, WORD_KEYS, platformWords } from './words.js';
+export type { PlatformWords, WordKey } from './words.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -8,4 +8,5 @@ export { resolveToken } from './tokens.js';
 export { formatMoney } from './money.js';
 export { imageSourceFor } from './renditions.js';
 export { localize, pickLocale, textDirection } from './locale.js';
+export { CATALOG_LANGUAGES, WORD_KEYS, platformWords } from './words.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAW7F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgB5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAY7F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgB5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAElE,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/locale.d.ts

@@ -4,6 +4,8 @@ export interface ShopLanguages {
     readonly default: LocaleCode;
     readonly supported: readonly LocaleCode[];
 }
+export declare const ENGLISH: LocaleCode;
+export declare function baseOf(locale: string): string;
 /**
  * The buyer's language: the first preferred locale the Shop supports, by
  * exact code, then by base language either way round; the Shop's default
@@ -11,8 +13,17 @@ export interface ShopLanguages {
  */
 export declare function pickLocale(languages: ShopLanguages, preferred: readonly string[]): LocaleCode;
 /**
- * One string out of a full locale object: the buyer's language, its base
- * language, the default language, then whatever the text carries first.
+ * The one string of a locale object the buyer can actually read: their own
+ * language, its base language, the Shop's default language, its base.
+ * Undefined when the text carries none of them, which is a caller's decision
+ * to make rather than a string to guess at.
+ */
+export declare function readable(text: LocalizedText, language: LocaleCode, fallback: LocaleCode): string | undefined;
+/**
+ * One string out of a full locale object: the language the buyer reads, then
+ * English, then whatever the text carries. The last step is for merchant
+ * written text only, where one language the merchant typed beats nothing at
+ * all; a word the platform owns comes from the catalog instead.
  */
 export declare function localize(text: LocalizedText, language: LocaleCode, fallback: LocaleCode): string;
 export declare function textDirection(language: LocaleCode): TextDirection;

package/dist/locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;CAC3C;AAQD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAQ7F;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAShG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAEjE"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;CAC3C;AAID,eAAO,MAAM,OAAO,EAAE,UAAiB,CAAC;AAExC,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAQ7F;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,UAAU,GACnB,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAEhG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAEjE"}

package/dist/locale.js

@@ -1,5 +1,6 @@
 const RTL_LANGUAGES = new Set(['ar', 'he', 'fa', 'ur']);
-function baseOf(locale) {
+export const ENGLISH = 'en';
+export function baseOf(locale) {
     return locale.split('-')[0].toLowerCase();
 }
 /**
@@ -19,16 +20,28 @@ export function pickLocale(languages, preferred) {
     return languages.default;
 }
 /**
- * One string out of a full locale object: the buyer's language, its base
- * language, the default language, then whatever the text carries first.
+ * The one string of a locale object the buyer can actually read: their own
+ * language, its base language, the Shop's default language, its base.
+ * Undefined when the text carries none of them, which is a caller's decision
+ * to make rather than a string to guess at.
+ */
+export function readable(text, language, fallback) {
+    const candidates = [
+        text[language],
+        text[baseOf(language)],
+        text[fallback],
+        text[baseOf(fallback)],
+    ];
+    return candidates.find((candidate) => candidate !== undefined && candidate.length > 0);
+}
+/**
+ * One string out of a full locale object: the language the buyer reads, then
+ * English, then whatever the text carries. The last step is for merchant
+ * written text only, where one language the merchant typed beats nothing at
+ * all; a word the platform owns comes from the catalog instead.
  */
 export function localize(text, language, fallback) {
-    return (text[language] ??
-        text[baseOf(language)] ??
-        text[fallback] ??
-        text[baseOf(fallback)] ??
-        Object.values(text)[0] ??
-        '');
+    return readable(text, language, fallback) ?? text[ENGLISH] ?? Object.values(text)[0] ?? '';
 }
 export function textDirection(language) {
     return RTL_LANGUAGES.has(baseOf(language)) ? 'rtl' : 'ltr';

package/dist/locale.js.map

@@ -1 +1 @@
-{"version":3,"file":"locale.js","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAQA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAExD,SAAS,MAAM,CAAC,MAAc;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,SAAwB,EAAE,SAA4B;IAC/E,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAmB,EAAE,QAAoB,EAAE,QAAoB;IACtF,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,EAAE,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAoB;IAChD,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAQA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,OAAO,GAAe,IAAI,CAAC;AAExC,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,SAAwB,EAAE,SAA4B;IAC/E,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAmB,EACnB,QAAoB,EACpB,QAAoB;IAEpB,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,QAAQ,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;KACvB,CAAC;IACF,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAmB,EAAE,QAAoB,EAAE,QAAoB;IACtF,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAoB;IAChD,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC"}

package/dist/version.d.ts

@@ -4,6 +4,6 @@
  * The major is the compatibility line: a Shop package built against another
  * major never meets this runtime, and a major bump is an announced event.
  */
-export declare const CONTRACT_VERSION = "2.0.0";
-export declare const CONTRACT_MAJOR = 2;
+export declare const CONTRACT_VERSION = "3.1.0";
+export declare const CONTRACT_MAJOR = 3;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -4,6 +4,6 @@
  * The major is the compatibility line: a Shop package built against another
  * major never meets this runtime, and a major bump is an announced event.
  */
-export const CONTRACT_VERSION = '2.0.0';
-export const CONTRACT_MAJOR = 2;
+export const CONTRACT_VERSION = '3.1.0';
+export const CONTRACT_MAJOR = 3;
 //# sourceMappingURL=version.js.map

package/dist/words.d.ts

@@ -0,0 +1,97 @@
+import type { LocaleCode, LocalizedText } from '@shoplix-ai/sdui-schema';
+/**
+ * Every functional word a platform renderer owns, in English. A functional
+ * word is one the platform puts on screen and the merchant never types:
+ * Checkout, Sold out, Subtotal, Added, Could not add. Marketing copy, a trust
+ * strip's promise or a promo card's headline, is merchant set localized text
+ * and has no place here, because no catalog can guess it.
+ *
+ * The key list is this table. A language that answers fewer keys does not
+ * compile, and a language the catalog does not carry falls back to English
+ * here, deliberately, rather than to whichever string happens to sit first in
+ * an object.
+ */
+declare const ENGLISH_WORDS: {
+    readonly 'cart.title': "Cart";
+    readonly 'cart.close': "Close";
+    readonly 'cart.empty': "Your cart is empty";
+    readonly 'cart.continue_shopping': "Continue shopping";
+    readonly 'cart.items_in_cart': "items in the cart";
+    readonly 'cart.subtotal': "Subtotal";
+    readonly 'cart.discount': "Discount";
+    readonly 'cart.line_discount': "Discount";
+    readonly 'cart.total': "Total";
+    readonly 'cart.estimated': "estimated";
+    readonly 'cart.checkout': "Checkout";
+    readonly 'cart.checkout_unavailable': "Checkout is unavailable right now. Please try again.";
+    readonly 'cart.remove': "Remove";
+    readonly 'cart.decrease': "Decrease quantity";
+    readonly 'cart.increase': "Increase quantity";
+    readonly 'cart.discount_code': "Discount code";
+    readonly 'cart.code_placeholder': "Enter a code";
+    readonly 'cart.apply': "Apply";
+    readonly 'cart.code_not_applicable': "This code is not valid for this cart";
+    readonly 'cart.note_label': "Order note";
+    readonly 'cart.note_placeholder': "Anything we should know?";
+    readonly 'cart.update_failed': "Could not update the cart";
+    readonly 'product.add_to_cart': "Add to cart";
+    readonly 'product.added': "Added to cart";
+    readonly 'product.add_failed': "Could not add";
+    readonly 'product.sold_out': "Sold out";
+    readonly 'product.in_stock': "In stock";
+    readonly 'product.out_of_stock': "Out of stock";
+    readonly 'product.only_left': "Only {count} left";
+    readonly 'product.brand': "Brand";
+    readonly 'product.type': "Type";
+    readonly 'search.title': "Search";
+    readonly 'search.placeholder': "Search";
+    readonly 'search.prompt': "Search the shop for a product";
+    readonly 'search.no_results': "Nothing matched your search";
+    readonly 'countdown.days': "Days";
+    readonly 'countdown.hours': "Hours";
+    readonly 'countdown.minutes': "Minutes";
+    readonly 'countdown.seconds': "Seconds";
+    readonly 'notifications.ask': "Want to know when your order ships?";
+    readonly 'notifications.turn_on': "Turn on";
+    readonly 'notifications.hide': "Hide this";
+    readonly 'notifications.order_updates': "Order updates";
+    readonly 'notifications.on': "On";
+    readonly 'notifications.off': "Off";
+    readonly 'screen.back': "Back";
+    readonly 'screen.unavailable': "Not available";
+    readonly 'screen.unavailable_body': "This page is not part of the shop any more.";
+    readonly 'screen.unreachable': "The shop could not be reached.";
+    readonly 'screen.retry': "Try again";
+    readonly 'account.title': "Account";
+    readonly 'account.language': "Language";
+    readonly 'account.country': "Country";
+    readonly 'account.about': "About";
+    readonly 'account.version': "Version";
+    readonly 'account.shop': "Shop";
+    readonly 'account.loading': "Loading the shop settings";
+    readonly 'account.no_markets': "No markets to choose from";
+    readonly 'account.notifications': "Notifications";
+    readonly 'account.privacy': "Privacy";
+    readonly 'account.share_diagnostics': "Share app diagnostics";
+};
+export type WordKey = keyof typeof ENGLISH_WORDS;
+/** Every functional word key, for a caller that walks the catalog. */
+export declare const WORD_KEYS: readonly WordKey[];
+/** The languages the catalog answers in its own right. */
+export declare const CATALOG_LANGUAGES: readonly LocaleCode[];
+export interface PlatformWords {
+    /** The platform's own word for this key, in the buyer's language. */
+    own(key: WordKey): string;
+    /**
+     * The merchant's own text where they set one in a language the buyer reads,
+     * the platform's own word otherwise.
+     */
+    merchantOr(text: LocalizedText | undefined, key: WordKey): string;
+}
+/**
+ * The catalog bound to one buyer: their language for the platform's own words,
+ * their language and the Shop's default for a merchant's override of one.
+ */
+export declare function platformWords(language: LocaleCode, defaultLanguage: LocaleCode): PlatformWords;
+export {};
+//# sourceMappingURL=words.d.ts.map

package/dist/words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../src/words.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGzE;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8DT,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,aAAa,CAAC;AA0IjD,sEAAsE;AACtE,eAAO,MAAM,SAAS,EAAE,SAAS,OAAO,EAA4C,CAAC;AAErF,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAE,SAAS,UAAU,EAAyB,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;CACnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,GAAG,aAAa,CAO9F"}

package/dist/words.js

@@ -0,0 +1,223 @@
+import { ENGLISH, baseOf, readable } from './locale.js';
+/**
+ * Every functional word a platform renderer owns, in English. A functional
+ * word is one the platform puts on screen and the merchant never types:
+ * Checkout, Sold out, Subtotal, Added, Could not add. Marketing copy, a trust
+ * strip's promise or a promo card's headline, is merchant set localized text
+ * and has no place here, because no catalog can guess it.
+ *
+ * The key list is this table. A language that answers fewer keys does not
+ * compile, and a language the catalog does not carry falls back to English
+ * here, deliberately, rather than to whichever string happens to sit first in
+ * an object.
+ */
+const ENGLISH_WORDS = {
+    'cart.title': 'Cart',
+    'cart.close': 'Close',
+    'cart.empty': 'Your cart is empty',
+    'cart.continue_shopping': 'Continue shopping',
+    'cart.items_in_cart': 'items in the cart',
+    'cart.subtotal': 'Subtotal',
+    'cart.discount': 'Discount',
+    'cart.line_discount': 'Discount',
+    'cart.total': 'Total',
+    'cart.estimated': 'estimated',
+    'cart.checkout': 'Checkout',
+    'cart.checkout_unavailable': 'Checkout is unavailable right now. Please try again.',
+    'cart.remove': 'Remove',
+    'cart.decrease': 'Decrease quantity',
+    'cart.increase': 'Increase quantity',
+    'cart.discount_code': 'Discount code',
+    'cart.code_placeholder': 'Enter a code',
+    'cart.apply': 'Apply',
+    'cart.code_not_applicable': 'This code is not valid for this cart',
+    'cart.note_label': 'Order note',
+    'cart.note_placeholder': 'Anything we should know?',
+    'cart.update_failed': 'Could not update the cart',
+    'product.add_to_cart': 'Add to cart',
+    'product.added': 'Added to cart',
+    'product.add_failed': 'Could not add',
+    'product.sold_out': 'Sold out',
+    'product.in_stock': 'In stock',
+    'product.out_of_stock': 'Out of stock',
+    'product.only_left': 'Only {count} left',
+    'product.brand': 'Brand',
+    'product.type': 'Type',
+    'search.title': 'Search',
+    'search.placeholder': 'Search',
+    'search.prompt': 'Search the shop for a product',
+    'search.no_results': 'Nothing matched your search',
+    'countdown.days': 'Days',
+    'countdown.hours': 'Hours',
+    'countdown.minutes': 'Minutes',
+    'countdown.seconds': 'Seconds',
+    'notifications.ask': 'Want to know when your order ships?',
+    'notifications.turn_on': 'Turn on',
+    'notifications.hide': 'Hide this',
+    'notifications.order_updates': 'Order updates',
+    'notifications.on': 'On',
+    'notifications.off': 'Off',
+    'screen.back': 'Back',
+    'screen.unavailable': 'Not available',
+    'screen.unavailable_body': 'This page is not part of the shop any more.',
+    'screen.unreachable': 'The shop could not be reached.',
+    'screen.retry': 'Try again',
+    'account.title': 'Account',
+    'account.language': 'Language',
+    'account.country': 'Country',
+    'account.about': 'About',
+    'account.version': 'Version',
+    'account.shop': 'Shop',
+    'account.loading': 'Loading the shop settings',
+    'account.no_markets': 'No markets to choose from',
+    'account.notifications': 'Notifications',
+    'account.privacy': 'Privacy',
+    'account.share_diagnostics': 'Share app diagnostics',
+};
+const ARABIC_WORDS = {
+    'cart.title': 'السلة',
+    'cart.close': 'إغلاق',
+    'cart.empty': 'سلتك فارغة',
+    'cart.continue_shopping': 'تابع التسوق',
+    'cart.items_in_cart': 'عناصر في السلة',
+    'cart.subtotal': 'المجموع الفرعي',
+    'cart.discount': 'الخصم',
+    'cart.line_discount': 'خصم',
+    'cart.total': 'الإجمالي',
+    'cart.estimated': 'تقديري',
+    'cart.checkout': 'الدفع',
+    'cart.checkout_unavailable': 'الدفع غير متاح حاليًا. حاول مرة أخرى.',
+    'cart.remove': 'إزالة',
+    'cart.decrease': 'تقليل الكمية',
+    'cart.increase': 'زيادة الكمية',
+    'cart.discount_code': 'رمز الخصم',
+    'cart.code_placeholder': 'أدخل الرمز',
+    'cart.apply': 'تطبيق',
+    'cart.code_not_applicable': 'هذا الرمز غير صالح لهذه السلة',
+    'cart.note_label': 'ملاحظة الطلب',
+    'cart.note_placeholder': 'هل من شيء يجب أن نعرفه؟',
+    'cart.update_failed': 'تعذّر تحديث السلة',
+    'product.add_to_cart': 'أضف إلى السلة',
+    'product.added': 'أُضيف إلى السلة',
+    'product.add_failed': 'تعذّرت الإضافة',
+    'product.sold_out': 'نفذت الكمية',
+    'product.in_stock': 'متوفر',
+    'product.out_of_stock': 'نفدت الكمية',
+    'product.only_left': 'المتبقي {count} فقط',
+    'product.brand': 'العلامة',
+    'product.type': 'النوع',
+    'search.title': 'بحث',
+    'search.placeholder': 'بحث',
+    'search.prompt': 'ابحث عن منتج في المتجر',
+    'search.no_results': 'لا نتائج لبحثك',
+    'countdown.days': 'أيام',
+    'countdown.hours': 'ساعات',
+    'countdown.minutes': 'دقائق',
+    'countdown.seconds': 'ثوان',
+    'notifications.ask': 'هل تريد معرفة موعد شحن طلبك؟',
+    'notifications.turn_on': 'تفعيل',
+    'notifications.hide': 'إخفاء',
+    'notifications.order_updates': 'تحديثات الطلب',
+    'notifications.on': 'مفعّلة',
+    'notifications.off': 'متوقفة',
+    'screen.back': 'رجوع',
+    'screen.unavailable': 'غير متاح',
+    'screen.unavailable_body': 'هذه الصفحة لم تعد جزءًا من المتجر.',
+    'screen.unreachable': 'تعذر الوصول إلى المتجر.',
+    'screen.retry': 'حاول مرة أخرى',
+    'account.title': 'الحساب',
+    'account.language': 'اللغة',
+    'account.country': 'الدولة',
+    'account.about': 'عن التطبيق',
+    'account.version': 'الإصدار',
+    'account.shop': 'المتجر',
+    'account.loading': 'جارٍ تحميل إعدادات المتجر',
+    'account.no_markets': 'لا أسواق للاختيار منها',
+    'account.notifications': 'الإشعارات',
+    'account.privacy': 'الخصوصية',
+    'account.share_diagnostics': 'مشاركة بيانات تشخيص التطبيق',
+};
+const TURKISH_WORDS = {
+    'cart.title': 'Sepet',
+    'cart.close': 'Kapat',
+    'cart.empty': 'Sepetiniz boş',
+    'cart.continue_shopping': 'Alışverişe devam et',
+    'cart.items_in_cart': 'sepetteki ürün',
+    'cart.subtotal': 'Ara toplam',
+    'cart.discount': 'İndirim',
+    'cart.line_discount': 'İndirim',
+    'cart.total': 'Toplam',
+    'cart.estimated': 'tahmini',
+    'cart.checkout': 'Ödeme',
+    'cart.checkout_unavailable': 'Ödeme şu anda kullanılamıyor. Lütfen tekrar deneyin.',
+    'cart.remove': 'Kaldır',
+    'cart.decrease': 'Adedi azalt',
+    'cart.increase': 'Adedi artır',
+    'cart.discount_code': 'İndirim kodu',
+    'cart.code_placeholder': 'Bir kod girin',
+    'cart.apply': 'Uygula',
+    'cart.code_not_applicable': 'Bu kod bu sepet için geçerli değil',
+    'cart.note_label': 'Sipariş notu',
+    'cart.note_placeholder': 'Bilmemiz gereken bir şey var mı?',
+    'cart.update_failed': 'Sepet güncellenemedi',
+    'product.add_to_cart': 'Sepete ekle',
+    'product.added': 'Sepete eklendi',
+    'product.add_failed': 'Eklenemedi',
+    'product.sold_out': 'Tükendi',
+    'product.in_stock': 'Stokta var',
+    'product.out_of_stock': 'Stokta yok',
+    'product.only_left': 'Yalnızca {count} adet kaldı',
+    'product.brand': 'Marka',
+    'product.type': 'Tür',
+    'search.title': 'Ara',
+    'search.placeholder': 'Ara',
+    'search.prompt': 'Mağazada bir ürün arayın',
+    'search.no_results': 'Aramanızla eşleşen bir sonuç yok',
+    'countdown.days': 'Gün',
+    'countdown.hours': 'Saat',
+    'countdown.minutes': 'Dakika',
+    'countdown.seconds': 'Saniye',
+    'notifications.ask': 'Siparişinizin ne zaman kargolandığını öğrenmek ister misiniz?',
+    'notifications.turn_on': 'Aç',
+    'notifications.hide': 'Bunu gizle',
+    'notifications.order_updates': 'Sipariş bildirimleri',
+    'notifications.on': 'Açık',
+    'notifications.off': 'Kapalı',
+    'screen.back': 'Geri',
+    'screen.unavailable': 'Kullanılamıyor',
+    'screen.unavailable_body': 'Bu sayfa artık mağazanın bir parçası değil.',
+    'screen.unreachable': 'Mağazaya ulaşılamadı.',
+    'screen.retry': 'Tekrar dene',
+    'account.title': 'Hesap',
+    'account.language': 'Dil',
+    'account.country': 'Ülke',
+    'account.about': 'Hakkında',
+    'account.version': 'Sürüm',
+    'account.shop': 'Mağaza',
+    'account.loading': 'Mağaza ayarları yükleniyor',
+    'account.no_markets': 'Seçilecek pazar yok',
+    'account.notifications': 'Bildirimler',
+    'account.privacy': 'Gizlilik',
+    'account.share_diagnostics': 'Uygulama tanılama verilerini paylaş',
+};
+const CATALOG = {
+    en: ENGLISH_WORDS,
+    ar: ARABIC_WORDS,
+    tr: TURKISH_WORDS,
+};
+/** Every functional word key, for a caller that walks the catalog. */
+export const WORD_KEYS = Object.keys(ENGLISH_WORDS);
+/** The languages the catalog answers in its own right. */
+export const CATALOG_LANGUAGES = Object.keys(CATALOG);
+/**
+ * The catalog bound to one buyer: their language for the platform's own words,
+ * their language and the Shop's default for a merchant's override of one.
+ */
+export function platformWords(language, defaultLanguage) {
+    const table = CATALOG[language] ?? CATALOG[baseOf(language)] ?? CATALOG[ENGLISH];
+    return {
+        own: (key) => table[key],
+        merchantOr: (text, key) => (text === undefined ? undefined : readable(text, language, defaultLanguage)) ?? table[key],
+    };
+}
+//# sourceMappingURL=words.js.map

package/dist/words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.js","sourceRoot":"","sources":["../src/words.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shoplix-ai/block-kit",
-  "version": "2.0.0",
+  "version": "3.1.0",
   "description": "The renderer contract every Block Type renderer is written against: what a renderer receives, how a Block Type is registered with its owner, the closed capability set, and the small helpers renderers share. Contract only, no renderers.",
   "license": "MIT",
   "repository": {
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@shoplix-ai/sdui-schema": "1.5.0"
+    "@shoplix-ai/sdui-schema": "1.9.0"
   },
   "peerDependencies": {
     "react": ">=19.0.0"