@shoplix-ai/block-kit 3.0.0 → 3.2.0

package/README.md

@@ -52,7 +52,94 @@ 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),
+  `platformWords`, the word catalog below, and `moneyParts`, `moneyText`,
+  `moneyAmount` and `discountPercent`, the money presentation 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.
+
+## How a price is written
+
+Display money carries the string the Provider formatted in the buyer's language
+and the decimal amount it was formatted from. **Every figure a block computes
+comes from the amount**: reading a number back out of the formatted string
+assumes the full stop is the decimal mark, which is wrong across most of Europe
+and puts a confident nonsense percentage on a badge.
+
+```ts
+const percent = discountPercent(product.price, product.compareAtPrice);
+const { digits, label } = moneyParts(product.price, language, theme.money);
+const line = moneyText(product.price, language, theme.money);
+```
+
+`theme.money` is the digit style the design chose, and there are two.
+`locale`, the default, draws the string the Provider wrote and no label beside
+it. `latin` writes the digits from the amount in Latin numerals, grouped in
+threes at the currency's own number of decimal places, with the currency's
+short label beside them: how the Gulf commerce apps write a price in an Arabic
+app. Money that carries no amount is drawn as the Provider wrote it, whatever
+the style, so a block never loses a price it cannot restyle.
+
+The short label comes from a maintained table of the currencies the platform
+writes its own way, the Gulf currencies in Arabic among them. A currency the
+table does not name takes the symbol the buyer's own language writes for it,
+and the three letter code where the language writes none.
 
 ## Rows: what the host lays out
 

package/dist/index.d.ts

@@ -11,9 +11,12 @@ export { defineCodeBlock, shopBlocks } from './code-block.js';
 export type { CodeBlock, CodeBlockModule } from './code-block.js';
 export { CONTRACT_MAJOR, CONTRACT_VERSION } from './version.js';
 export { resolveToken } from './tokens.js';
-export { formatMoney } from './money.js';
+export { discountPercent, formatMoney, moneyAmount, moneyParts, moneyText } from './money.js';
+export type { MoneyParts } from './money.js';
 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,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"}
+{"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,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9F,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,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

@@ -5,7 +5,8 @@ export { defineBinding, defineSettings } from './authoring.js';
 export { defineCodeBlock, shopBlocks } from './code-block.js';
 export { CONTRACT_MAJOR, CONTRACT_VERSION } from './version.js';
 export { resolveToken } from './tokens.js';
-export { formatMoney } from './money.js';
+export { discountPercent, formatMoney, moneyAmount, moneyParts, moneyText } 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;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"}
+{"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,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9F,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/money.d.ts

@@ -1,6 +1,35 @@
+import { type DisplayMoney, type MoneyStyle } from '@shoplix-ai/sdui-schema';
 /**
  * Display-only money, formatted on the device in the buyer's language. The
  * charged price always comes from Shopify checkout, never from this string.
  */
 export declare function formatMoney(amount: string | number, currencyCode: string, language: string): string | null;
+/** The digits of a price and the short label of its currency, drawn side by side. */
+export interface MoneyParts {
+    readonly digits: string;
+    readonly label: string;
+}
+/** The number behind display money; null where the Provider recorded none. */
+export declare function moneyAmount(money: DisplayMoney | undefined): number | null;
+/**
+ * A price in the two pieces a card lays out itself. Under the latin style the
+ * digits are written from the decimal amount and the label is the currency's
+ * short one; under every other style, and for money carrying no amount this
+ * can be written from, the price stays the one string the Provider wrote and
+ * there is no label beside it.
+ *
+ * The latin style groups in threes with a period decimal whatever grouping the
+ * buyer's own language writes, so an Indian English buyer reads 1,234,567.89
+ * rather than 12,34,567.89. A merchant wanting the buyer's own grouping takes
+ * the locale style.
+ */
+export declare function moneyParts(money: DisplayMoney, language: string, style?: MoneyStyle): MoneyParts;
+/** One price on one line, in the style the theme chose. */
+export declare function moneyText(money: DisplayMoney, language: string, style?: MoneyStyle): string;
+/**
+ * The percent off for a badge, from the two decimal amounts of one currency.
+ * Null where either side carries no amount, where the currencies differ, or
+ * where the saving does not round to a percent worth drawing.
+ */
+export declare function discountPercent(price: DisplayMoney, compareAt: DisplayMoney | undefined): number | null;
 //# sourceMappingURL=money.d.ts.map

package/dist/money.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAUf"}
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAajC;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAYf;AAoDD,qFAAqF;AACrF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAI1E;AAyCD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,UAAgC,GACtC,UAAU,CAQZ;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CACvB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,UAAgC,GACtC,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,YAAY,GAAG,SAAS,GAClC,MAAM,GAAG,IAAI,CAOf"}

package/dist/money.js

@@ -1,12 +1,21 @@
+import { DEFAULT_MONEY_STYLE, } from '@shoplix-ai/sdui-schema';
+import { readable } from './locale.js';
 const CURRENCY_CODE = /^[A-Z]{3}$/;
+/** The decimal shape the display contract records an amount in. */
+const DECIMAL = /^\d+(\.\d+)?$/;
+/** A float that can no longer hold the amount's whole part exactly. */
+function representable(value) {
+    return Number.isSafeInteger(Math.trunc(value));
+}
 /**
  * Display-only money, formatted on the device in the buyer's language. The
  * charged price always comes from Shopify checkout, never from this string.
  */
 export function formatMoney(amount, currencyCode, language) {
     const value = typeof amount === 'number' ? amount : Number(amount);
-    if (!Number.isFinite(value) || !CURRENCY_CODE.test(currencyCode))
+    if (!Number.isFinite(value) || !representable(value) || !CURRENCY_CODE.test(currencyCode)) {
         return null;
+    }
     try {
         return new Intl.NumberFormat(language, { style: 'currency', currency: currencyCode }).format(value);
     }
@@ -14,4 +23,135 @@ export function formatMoney(amount, currencyCode, language) {
         return `${amount} ${currencyCode}`;
     }
 }
+/**
+ * The short label the platform draws beside a price where it wants one of its
+ * own: the Gulf currencies in Arabic, whose ICU symbol carries a trailing full
+ * stop and direction marks a card does not draw. A currency this table does
+ * not name takes the symbol the buyer's own language writes for it, and the
+ * three letter code where the language writes none.
+ */
+const CURRENCY_LABELS = {
+    AED: { ar: 'د.إ' },
+    BHD: { ar: 'د.ب' },
+    EGP: { ar: 'ج.م' },
+    JOD: { ar: 'د.أ' },
+    KWD: { ar: 'د.ك' },
+    OMR: { ar: 'ر.ع' },
+    QAR: { ar: 'ر.ق' },
+    SAR: { ar: 'ر.س' },
+    USD: { ar: '$' },
+};
+/** The currencies written with other than two decimal places, by ISO 4217. */
+const CURRENCY_PLACES = {
+    BHD: 3,
+    CLF: 4,
+    CLP: 0,
+    DJF: 0,
+    GNF: 0,
+    IQD: 3,
+    ISK: 0,
+    JOD: 3,
+    JPY: 0,
+    KMF: 0,
+    KRW: 0,
+    KWD: 3,
+    LYD: 3,
+    OMR: 3,
+    PYG: 0,
+    RWF: 0,
+    TND: 3,
+    UGX: 0,
+    UYI: 0,
+    UYW: 4,
+    VND: 0,
+    VUV: 0,
+    XAF: 0,
+    XOF: 0,
+    XPF: 0,
+};
+const DEFAULT_PLACES = 2;
+/** The number behind display money; null where the Provider recorded none. */
+export function moneyAmount(money) {
+    if (money?.amount === undefined)
+        return null;
+    const value = Number(money.amount);
+    return Number.isFinite(value) && representable(value) ? value : null;
+}
+function symbolOf(currencyCode, language) {
+    try {
+        const parts = new Intl.NumberFormat(language, {
+            style: 'currency',
+            currency: currencyCode,
+            currencyDisplay: 'narrowSymbol',
+        }).formatToParts(0);
+        return parts.find((part) => part.type === 'currency')?.value;
+    }
+    catch {
+        return undefined;
+    }
+}
+function currencyLabel(currencyCode, language) {
+    const named = CURRENCY_LABELS[currencyCode];
+    const own = named === undefined ? undefined : readable(named, language, language);
+    return own ?? symbolOf(currencyCode, language) ?? currencyCode;
+}
+/** A decimal amount at a currency's own number of places, rounded half up, never through a float. */
+function atPlaces(amount, places) {
+    const [whole = '0', fraction = ''] = amount.split('.');
+    if (fraction.length <= places) {
+        return places === 0 ? whole : `${whole}.${fraction.padEnd(places, '0')}`;
+    }
+    const carry = Number(fraction[places]) >= 5 ? 1n : 0n;
+    const units = (BigInt(`${whole}${fraction.slice(0, places)}`) + carry)
+        .toString()
+        .padStart(places + 1, '0');
+    return places === 0 ? units : `${units.slice(0, -places)}.${units.slice(-places)}`;
+}
+function latinDigits(amount, currencyCode) {
+    const written = atPlaces(amount, CURRENCY_PLACES[currencyCode] ?? DEFAULT_PLACES);
+    const [whole = '0', fraction] = written.split('.');
+    const grouped = whole.replace(/\B(?=(\d{3})+$)/g, ',');
+    return fraction === undefined ? grouped : `${grouped}.${fraction}`;
+}
+/**
+ * A price in the two pieces a card lays out itself. Under the latin style the
+ * digits are written from the decimal amount and the label is the currency's
+ * short one; under every other style, and for money carrying no amount this
+ * can be written from, the price stays the one string the Provider wrote and
+ * there is no label beside it.
+ *
+ * The latin style groups in threes with a period decimal whatever grouping the
+ * buyer's own language writes, so an Indian English buyer reads 1,234,567.89
+ * rather than 12,34,567.89. A merchant wanting the buyer's own grouping takes
+ * the locale style.
+ */
+export function moneyParts(money, language, style = DEFAULT_MONEY_STYLE) {
+    if (style.digits !== 'latin' || money.amount === undefined || !DECIMAL.test(money.amount)) {
+        return { digits: money.formatted, label: '' };
+    }
+    return {
+        digits: latinDigits(money.amount, money.currencyCode),
+        label: currencyLabel(money.currencyCode, language),
+    };
+}
+/** One price on one line, in the style the theme chose. */
+export function moneyText(money, language, style = DEFAULT_MONEY_STYLE) {
+    const { digits, label } = moneyParts(money, language, style);
+    return label === '' ? digits : `${digits} ${label}`;
+}
+/**
+ * The percent off for a badge, from the two decimal amounts of one currency.
+ * Null where either side carries no amount, where the currencies differ, or
+ * where the saving does not round to a percent worth drawing.
+ */
+export function discountPercent(price, compareAt) {
+    if (compareAt === undefined || compareAt.currencyCode !== price.currencyCode)
+        return null;
+    const now = moneyAmount(price);
+    const was = moneyAmount(compareAt);
+    if (now === null || was === null || was <= now)
+        return null;
+    const percent = Math.round((1 - now / was) * 100);
+    return percent === 0 ? null : percent;
+}
 //# sourceMappingURL=money.js.map

package/dist/money.js.map

@@ -1 +1 @@
-{"version":3,"file":"money.js","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,YAAY,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAuB,EACvB,YAAoB,EACpB,QAAgB;IAEhB,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAC1F,KAAK,CACN,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"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"}

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 = "3.0.0";
+export declare const CONTRACT_VERSION = "3.2.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 = '3.0.0';
+export const CONTRACT_VERSION = '3.2.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": "3.0.0",
+  "version": "3.2.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.9.0"
+    "@shoplix-ai/sdui-schema": "1.10.0"
   },
   "peerDependencies": {
     "react": ">=19.0.0"