@colixsystems/widget-sdk 0.288.0 → 0.289.0

package/README.md

@@ -90,7 +90,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.288.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+`v0.289.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+
+### What's new in 0.289.0 (contract 1.237.0)
+
+**`manifest.translations` may declare up to 500 keys (was 200).** A widget with many screens, or one that ships every label of a large form, no longer runs out of keys. Widening: every manifest that validated before still does.
 
 ### What's new in 0.288.0 (contract 1.236.0)
 

package/dist/contract.cjs

@@ -4176,7 +4176,7 @@ const MANIFEST_SCHEMA = {
     type: "object",
     required: false,
     description:
-      "Optional (REQ-L10N-WIDGET). Translation strings the widget ships. Shape { <key>: { en: string, <locale>?: string, ... } } — `en` is REQUIRED per key. At install the host merges these into the tenant's localization dictionary under a per-widget namespace (`widget.<manifest.id>.<key>`); `useI18n().t(\"<key>\")` resolves the namespaced key automatically, so authors never type the prefix. Non-destructive: an existing admin-edited value is never overwritten, and a language the tenant has not added is never created (values for absent locales are dropped; the widget's `en` seeds the tenant's base language so every key renders). Keys persist across uninstalls; admins prune them from the Translations admin (bulk delete by `widget.<id>.` prefix). Limits: ≤200 keys; each key matches /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/; each value ≤1 KB; the namespaced key must fit the dictionary key cap (128 chars).",
+      "Optional (REQ-L10N-WIDGET). Translation strings the widget ships. Shape { <key>: { en: string, <locale>?: string, ... } } — `en` is REQUIRED per key. At install the host merges these into the tenant's localization dictionary under a per-widget namespace (`widget.<manifest.id>.<key>`); `useI18n().t(\"<key>\")` resolves the namespaced key automatically, so authors never type the prefix. Non-destructive: an existing admin-edited value is never overwritten, and a language the tenant has not added is never created (values for absent locales are dropped; the widget's `en` seeds the tenant's base language so every key renders). Keys persist across uninstalls; admins prune them from the Translations admin (bulk delete by `widget.<id>.` prefix). Limits: ≤500 keys; each key matches /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/; each value ≤1 KB; the namespaced key must fit the dictionary key cap (128 chars).",
     default: {},
   },
 };
@@ -6749,7 +6749,9 @@ const CONTRACT = deepFreeze({
   //    `order: { table_id, record_id }` the server marks paid on settlement,
   //    a template column may declare `paymentStatus: true`, and four new
   //    PaymentError codes.
-  version: "1.236.0",
+  // 1.237.0: widening — `manifest.translations` may declare up to 500 keys
+  //    (was 200).
+  version: "1.237.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/contract.js

@@ -4172,7 +4172,7 @@ const MANIFEST_SCHEMA = {
     type: "object",
     required: false,
     description:
-      "Optional (REQ-L10N-WIDGET). Translation strings the widget ships. Shape { <key>: { en: string, <locale>?: string, ... } } — `en` is REQUIRED per key. At install the host merges these into the tenant's localization dictionary under a per-widget namespace (`widget.<manifest.id>.<key>`); `useI18n().t(\"<key>\")` resolves the namespaced key automatically, so authors never type the prefix. Non-destructive: an existing admin-edited value is never overwritten, and a language the tenant has not added is never created (values for absent locales are dropped; the widget's `en` seeds the tenant's base language so every key renders). Keys persist across uninstalls; admins prune them from the Translations admin (bulk delete by `widget.<id>.` prefix). Limits: ≤200 keys; each key matches /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/; each value ≤1 KB; the namespaced key must fit the dictionary key cap (128 chars).",
+      "Optional (REQ-L10N-WIDGET). Translation strings the widget ships. Shape { <key>: { en: string, <locale>?: string, ... } } — `en` is REQUIRED per key. At install the host merges these into the tenant's localization dictionary under a per-widget namespace (`widget.<manifest.id>.<key>`); `useI18n().t(\"<key>\")` resolves the namespaced key automatically, so authors never type the prefix. Non-destructive: an existing admin-edited value is never overwritten, and a language the tenant has not added is never created (values for absent locales are dropped; the widget's `en` seeds the tenant's base language so every key renders). Keys persist across uninstalls; admins prune them from the Translations admin (bulk delete by `widget.<id>.` prefix). Limits: ≤500 keys; each key matches /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/; each value ≤1 KB; the namespaced key must fit the dictionary key cap (128 chars).",
     default: {},
   },
 };
@@ -6745,7 +6745,9 @@ const CONTRACT = deepFreeze({
   //    `order: { table_id, record_id }` the server marks paid on settlement,
   //    a template column may declare `paymentStatus: true`, and four new
   //    PaymentError codes.
-  version: "1.236.0",
+  // 1.237.0: widening — `manifest.translations` may declare up to 500 keys
+  //    (was 200).
+  version: "1.237.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/index.d.ts

@@ -474,7 +474,7 @@ export interface WidgetManifest {
    * under a per-widget namespace (`widget.<id>.<key>`), so `useI18n().t(key)`
    * resolves the namespaced key automatically — the author never types the
    * prefix. Non-destructive (admin edits win; absent languages are not
-   * created) and persists across uninstalls. Caps: ≤200 keys, key matches
+   * created) and persists across uninstalls. Caps: ≤500 keys, key matches
    * /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/, value ≤1 KB.
    */
   translations?: Record<string, { en: string } & Record<string, string>>;

package/dist/manifest.cjs

@@ -47,8 +47,8 @@ const VALID_PLATFORMS = new Set(["web", "native"]);
 // backend/src/core/services/l10n.service.js). The locale pattern mirrors that
 // service's LANG_CODE_RE so a manifest can't declare a locale the dictionary
 // would reject.
-// One page of the dictionary's widget namespace (l10n MAX_KEYS_PER_PAGE).
-const TRANSLATIONS_MAX_KEYS = 200;
+// Bounds one package's rows in a workspace's translation dictionary.
+const TRANSLATIONS_MAX_KEYS = 500;
 const TRANSLATION_VALUE_MAX_BYTES = 1024;
 const TRANSLATION_KEY_RE = /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/;
 const TRANSLATION_LOCALE_RE = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8})?$/;

package/dist/manifest.js

@@ -42,8 +42,8 @@ const VALID_PLATFORMS = new Set(["web", "native"]);
 // backend/src/core/services/l10n.service.js). The locale pattern mirrors that
 // service's LANG_CODE_RE so a manifest can't declare a locale the dictionary
 // would reject.
-// One page of the dictionary's widget namespace (l10n MAX_KEYS_PER_PAGE).
-const TRANSLATIONS_MAX_KEYS = 200;
+// Bounds one package's rows in a workspace's translation dictionary.
+const TRANSLATIONS_MAX_KEYS = 500;
 const TRANSLATION_VALUE_MAX_BYTES = 1024;
 const TRANSLATION_KEY_RE = /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/;
 const TRANSLATION_LOCALE_RE = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8})?$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.288.0",
+  "version": "0.289.0",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "homepage": "https://github.com/Colix-AB/AppStudio",
   "type": "module",

package/src/contract.js

@@ -4172,7 +4172,7 @@ const MANIFEST_SCHEMA = {
     type: "object",
     required: false,
     description:
-      "Optional (REQ-L10N-WIDGET). Translation strings the widget ships. Shape { <key>: { en: string, <locale>?: string, ... } } — `en` is REQUIRED per key. At install the host merges these into the tenant's localization dictionary under a per-widget namespace (`widget.<manifest.id>.<key>`); `useI18n().t(\"<key>\")` resolves the namespaced key automatically, so authors never type the prefix. Non-destructive: an existing admin-edited value is never overwritten, and a language the tenant has not added is never created (values for absent locales are dropped; the widget's `en` seeds the tenant's base language so every key renders). Keys persist across uninstalls; admins prune them from the Translations admin (bulk delete by `widget.<id>.` prefix). Limits: ≤200 keys; each key matches /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/; each value ≤1 KB; the namespaced key must fit the dictionary key cap (128 chars).",
+      "Optional (REQ-L10N-WIDGET). Translation strings the widget ships. Shape { <key>: { en: string, <locale>?: string, ... } } — `en` is REQUIRED per key. At install the host merges these into the tenant's localization dictionary under a per-widget namespace (`widget.<manifest.id>.<key>`); `useI18n().t(\"<key>\")` resolves the namespaced key automatically, so authors never type the prefix. Non-destructive: an existing admin-edited value is never overwritten, and a language the tenant has not added is never created (values for absent locales are dropped; the widget's `en` seeds the tenant's base language so every key renders). Keys persist across uninstalls; admins prune them from the Translations admin (bulk delete by `widget.<id>.` prefix). Limits: ≤500 keys; each key matches /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/; each value ≤1 KB; the namespaced key must fit the dictionary key cap (128 chars).",
     default: {},
   },
 };
@@ -6745,7 +6745,9 @@ const CONTRACT = deepFreeze({
   //    `order: { table_id, record_id }` the server marks paid on settlement,
   //    a template column may declare `paymentStatus: true`, and four new
   //    PaymentError codes.
-  version: "1.236.0",
+  // 1.237.0: widening — `manifest.translations` may declare up to 500 keys
+  //    (was 200).
+  version: "1.237.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,