@shoplix-ai/block-kit 3.0.0 → 3.1.0

package/README.md

@@ -52,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/index.d.ts

@@ -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,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,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;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,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 = "3.0.0";
+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 = '3.0.0';
+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": "3.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": {