@elytracms/studio 0.0.29 → 0.0.32

package/dist/lib/i18n/i18n.d.ts

@@ -0,0 +1,59 @@
+import type { LocalizedString } from '@elytracms/core/cms-core';
+import type { MessageCatalog, SourceCatalog } from './types';
+/**
+ * Pick the best available locale for the browser's ordered language preferences
+ * (EC-241): an exact tag match wins, else the base language (`de-DE` → `de`), else
+ * `defaultLocale`. Pure + deterministic — the browser list is the only input.
+ */
+export declare function resolveActiveLocale(available: readonly string[], preferred: readonly string[], defaultLocale: string): string;
+interface ResolvedI18n {
+    locale: string;
+    defaultLocale: string;
+    /** The active-locale catalog (empty when active === default → the English source is used). */
+    active: MessageCatalog;
+    source: SourceCatalog;
+}
+/**
+ * Resolve the studio i18n from the config holder + the browser locale (EC-241).
+ *
+ * NOT cached: the studio config holder (`createStudio`) is seeded at the mount, which
+ * runs AFTER the consumer's `studio.config` module built its sidebar — so an eager
+ * `translate` during that sidebar build (e.g. a built-in view label) sees an empty
+ * config. Caching the first result would poison every later render-time call with
+ * that empty-config English. Re-resolving each call is cheap (a few array ops) and
+ * always reflects the config once the mount has run. `translate`/`localizedLabel`
+ * are the hot callers; built-in view labels are lazy getters so they re-resolve too.
+ */
+export declare function resolveStudioI18n(): ResolvedI18n;
+/**
+ * Translate a message key for the active UI locale (EC-241): active-locale string
+ * ?? English source ?? **the key itself** (a visible fallback + a one-time console
+ * signal — "failures are first-class", never a silent blank). Non-hook — reads the
+ * per-boot singleton, so config-build and pure code can localize too; {@link useT}
+ * is the React-idiomatic wrapper.
+ */
+export declare function translate(key: string, vars?: Record<string, string | number>): string;
+/**
+ * Resolve a {@link LocalizedString} (field/collection/option label) against the
+ * active UI locale (EC-241) — **non-hook**, reading the per-boot singleton, so it is
+ * safe to call anywhere: a component body, a nested render helper, or config-build
+ * code. Returns `fallback` (default `''`) when the value is absent. Prefer this over
+ * `resolveLabel(x, useUiLocale())` at render sites — it localizes without a hook, so
+ * it can't trip the rules-of-hooks in a conditional/nested position.
+ */
+export declare function localizedLabel(value: LocalizedString | undefined, fallback?: string): string;
+/** The active studio-UI locale (browser-resolved). */
+export declare function useUiLocale(): string;
+/** A `t(key, vars?)` translator bound to the active locale. */
+export declare function useT(): (key: string, vars?: Record<string, string | number>) => string;
+/**
+ * Resolve a {@link LocalizedString} label (field/collection/option) for the active
+ * locale. Re-reads the locale each render (keyed into the memo) so it never captures
+ * a locale resolved before the mount seeded the i18n config.
+ */
+export declare function useLabel(): (value: LocalizedString | undefined, fallback?: string) => string;
+/** Test seam: force the active locale. Never used by app code. */
+export declare function setUiLocaleForTests(locale: string | null): void;
+/** Test seam: reset i18n state (the once-per-boot warnings). Never used by app code. */
+export declare function resetStudioI18nForTests(): void;
+export {};

package/dist/lib/i18n/i18n.js

@@ -0,0 +1,131 @@
+import { useMemo } from 'react';
+import { resolveLabel } from '@elytracms/core/cms-core';
+import { resolveDeploymentI18n } from '@elytracms/studio/lib/workspace';
+import { EN_MESSAGES } from './messages.en';
+/**
+ * Studio-UI localization runtime (EC-241). Resolves the active UI locale from the
+ * **browser's preferred locale** (no persisted selector in v1 — that rides EC-240's
+ * deferred account settings), then translates message keys with an
+ * active-locale → English → visible-fallback chain. The studio config is static per
+ * boot, so resolution is memoised once (like `getWorkspaceState`); a locale switch
+ * needs a reload, which is all v1 offers.
+ */
+const BUILTIN_DEFAULT_LOCALE = 'en';
+/**
+ * Pick the best available locale for the browser's ordered language preferences
+ * (EC-241): an exact tag match wins, else the base language (`de-DE` → `de`), else
+ * `defaultLocale`. Pure + deterministic — the browser list is the only input.
+ */
+export function resolveActiveLocale(available, preferred, defaultLocale) {
+    const lower = available.map((a) => a.toLowerCase());
+    for (const pref of preferred) {
+        const p = pref.toLowerCase();
+        const base = p.split('-')[0] ?? p;
+        const at = lower.findIndex((a) => a === p || a === base);
+        if (at >= 0)
+            return available[at];
+    }
+    return defaultLocale;
+}
+let localeOverride = null;
+function navigatorLanguages() {
+    if (typeof navigator === 'undefined')
+        return [];
+    if (navigator.languages && navigator.languages.length > 0)
+        return [...navigator.languages];
+    return navigator.language ? [navigator.language] : [];
+}
+const warned = new Set();
+function warnOnce(message) {
+    if (warned.has(message))
+        return;
+    warned.add(message);
+    if (typeof console !== 'undefined')
+        console.warn(message);
+}
+/**
+ * Resolve the studio i18n from the config holder + the browser locale (EC-241).
+ *
+ * NOT cached: the studio config holder (`createStudio`) is seeded at the mount, which
+ * runs AFTER the consumer's `studio.config` module built its sidebar — so an eager
+ * `translate` during that sidebar build (e.g. a built-in view label) sees an empty
+ * config. Caching the first result would poison every later render-time call with
+ * that empty-config English. Re-resolving each call is cheap (a few array ops) and
+ * always reflects the config once the mount has run. `translate`/`localizedLabel`
+ * are the hot callers; built-in view labels are lazy getters so they re-resolve too.
+ */
+export function resolveStudioI18n() {
+    const config = resolveDeploymentI18n() ?? {};
+    const defaultLocale = config.defaultLocale ?? BUILTIN_DEFAULT_LOCALE;
+    const locales = config.locales ?? {};
+    const available = [defaultLocale, ...Object.keys(locales).filter((l) => l !== defaultLocale)];
+    const locale = localeOverride ?? resolveActiveLocale(available, navigatorLanguages(), defaultLocale);
+    const active = locale === defaultLocale ? {} : (locales[locale] ?? {});
+    // Coverage lint: warn once when the active locale doesn't cover every English key.
+    if (locale !== defaultLocale && locales[locale]) {
+        const missing = Object.keys(EN_MESSAGES).filter((k) => !(k in active));
+        if (missing.length > 0) {
+            warnOnce(`[i18n] locale "${locale}" is missing ${missing.length} message(s); falling back to English for those.`);
+        }
+    }
+    return { locale, defaultLocale, active, source: EN_MESSAGES };
+}
+function interpolate(text, vars) {
+    return text.replace(/\{(\w+)\}/g, (whole, key) => (key in vars ? String(vars[key]) : whole));
+}
+/**
+ * Translate a message key for the active UI locale (EC-241): active-locale string
+ * ?? English source ?? **the key itself** (a visible fallback + a one-time console
+ * signal — "failures are first-class", never a silent blank). Non-hook — reads the
+ * per-boot singleton, so config-build and pure code can localize too; {@link useT}
+ * is the React-idiomatic wrapper.
+ */
+export function translate(key, vars) {
+    const i18n = resolveStudioI18n();
+    const hit = i18n.active[key] ?? i18n.source[key]?.message;
+    if (hit === undefined) {
+        warnOnce(`[i18n] missing message key: "${key}"`);
+        return key;
+    }
+    return vars ? interpolate(hit, vars) : hit;
+}
+/**
+ * Resolve a {@link LocalizedString} (field/collection/option label) against the
+ * active UI locale (EC-241) — **non-hook**, reading the per-boot singleton, so it is
+ * safe to call anywhere: a component body, a nested render helper, or config-build
+ * code. Returns `fallback` (default `''`) when the value is absent. Prefer this over
+ * `resolveLabel(x, useUiLocale())` at render sites — it localizes without a hook, so
+ * it can't trip the rules-of-hooks in a conditional/nested position.
+ */
+export function localizedLabel(value, fallback = '') {
+    const { locale, defaultLocale } = resolveStudioI18n();
+    return resolveLabel(value, locale, defaultLocale) ?? fallback;
+}
+// --- React hooks ---
+/** The active studio-UI locale (browser-resolved). */
+export function useUiLocale() {
+    return resolveStudioI18n().locale;
+}
+/** A `t(key, vars?)` translator bound to the active locale. */
+export function useT() {
+    return translate;
+}
+/**
+ * Resolve a {@link LocalizedString} label (field/collection/option) for the active
+ * locale. Re-reads the locale each render (keyed into the memo) so it never captures
+ * a locale resolved before the mount seeded the i18n config.
+ */
+export function useLabel() {
+    const { locale, defaultLocale } = resolveStudioI18n();
+    return useMemo(() => (value, fallback) => resolveLabel(value, locale, defaultLocale) ?? fallback ?? '', [locale, defaultLocale]);
+}
+/** Test seam: force the active locale. Never used by app code. */
+export function setUiLocaleForTests(locale) {
+    localeOverride = locale;
+    warned.clear();
+}
+/** Test seam: reset i18n state (the once-per-boot warnings). Never used by app code. */
+export function resetStudioI18nForTests() {
+    warned.clear();
+}
+//# sourceMappingURL=i18n.js.map

package/dist/lib/i18n/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/lib/i18n/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAG3C;;;;;;;GAOG;AAEH,MAAM,sBAAsB,GAAG,IAAI,CAAA;AAEnC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA4B,EAC5B,SAA4B,EAC5B,aAAqB;IAErB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;IACnD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACjC,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAA;QACxD,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC,EAAE,CAAE,CAAA;IACpC,CAAC;IACD,OAAO,aAAa,CAAA;AACtB,CAAC;AAUD,IAAI,cAAc,GAAkB,IAAI,CAAA;AAExC,SAAS,kBAAkB;IACzB,IAAI,OAAO,SAAS,KAAK,WAAW;QAAE,OAAO,EAAE,CAAA;IAC/C,IAAI,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;IAC1F,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACvD,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;AAChC,SAAS,QAAQ,CAAC,OAAe;IAC/B,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAM;IAC/B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACnB,IAAI,OAAO,OAAO,KAAK,WAAW;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,qBAAqB,EAAE,IAAI,EAAE,CAAA;IAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,sBAAsB,CAAA;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;IACpC,MAAM,SAAS,GAAG,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAA;IAC7F,MAAM,MAAM,GAAG,cAAc,IAAI,mBAAmB,CAAC,SAAS,EAAE,kBAAkB,EAAE,EAAE,aAAa,CAAC,CAAA;IACpG,MAAM,MAAM,GAAG,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IACtE,mFAAmF;IACnF,IAAI,MAAM,KAAK,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAA;QACtE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CACN,kBAAkB,MAAM,gBAAgB,OAAO,CAAC,MAAM,iDAAiD,CACxG,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAA;AAC/D,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,IAAqC;IACtE,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;AACtG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAsC;IAC3E,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAA;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACzD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,QAAQ,CAAC,gCAAgC,GAAG,GAAG,CAAC,CAAA;QAChD,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkC,EAAE,QAAQ,GAAG,EAAE;IAC9E,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,iBAAiB,EAAE,CAAA;IACrD,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,QAAQ,CAAA;AAC/D,CAAC;AAED,sBAAsB;AAEtB,sDAAsD;AACtD,MAAM,UAAU,WAAW;IACzB,OAAO,iBAAiB,EAAE,CAAC,MAAM,CAAA;AACnC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,IAAI;IAClB,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,iBAAiB,EAAE,CAAA;IACrD,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,QAAQ,IAAI,EAAE,EACvF,CAAC,MAAM,EAAE,aAAa,CAAC,CACxB,CAAA;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,cAAc,GAAG,MAAM,CAAA;IACvB,MAAM,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,uBAAuB;IACrC,MAAM,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC","sourcesContent":["import { useMemo } from 'react'\nimport { resolveLabel } from '@elytracms/core/cms-core'\nimport type { LocalizedString } from '@elytracms/core/cms-core'\nimport { resolveDeploymentI18n } from '@elytracms/studio/lib/workspace'\nimport { EN_MESSAGES } from './messages.en'\nimport type { MessageCatalog, SourceCatalog } from './types'\n\n/**\n * Studio-UI localization runtime (EC-241). Resolves the active UI locale from the\n * **browser's preferred locale** (no persisted selector in v1 — that rides EC-240's\n * deferred account settings), then translates message keys with an\n * active-locale → English → visible-fallback chain. The studio config is static per\n * boot, so resolution is memoised once (like `getWorkspaceState`); a locale switch\n * needs a reload, which is all v1 offers.\n */\n\nconst BUILTIN_DEFAULT_LOCALE = 'en'\n\n/**\n * Pick the best available locale for the browser's ordered language preferences\n * (EC-241): an exact tag match wins, else the base language (`de-DE` → `de`), else\n * `defaultLocale`. Pure + deterministic — the browser list is the only input.\n */\nexport function resolveActiveLocale(\n  available: readonly string[],\n  preferred: readonly string[],\n  defaultLocale: string,\n): string {\n  const lower = available.map((a) => a.toLowerCase())\n  for (const pref of preferred) {\n    const p = pref.toLowerCase()\n    const base = p.split('-')[0] ?? p\n    const at = lower.findIndex((a) => a === p || a === base)\n    if (at >= 0) return available[at]!\n  }\n  return defaultLocale\n}\n\ninterface ResolvedI18n {\n  locale: string\n  defaultLocale: string\n  /** The active-locale catalog (empty when active === default → the English source is used). */\n  active: MessageCatalog\n  source: SourceCatalog\n}\n\nlet localeOverride: string | null = null\n\nfunction navigatorLanguages(): string[] {\n  if (typeof navigator === 'undefined') return []\n  if (navigator.languages && navigator.languages.length > 0) return [...navigator.languages]\n  return navigator.language ? [navigator.language] : []\n}\n\nconst warned = new Set<string>()\nfunction warnOnce(message: string): void {\n  if (warned.has(message)) return\n  warned.add(message)\n  if (typeof console !== 'undefined') console.warn(message)\n}\n\n/**\n * Resolve the studio i18n from the config holder + the browser locale (EC-241).\n *\n * NOT cached: the studio config holder (`createStudio`) is seeded at the mount, which\n * runs AFTER the consumer's `studio.config` module built its sidebar — so an eager\n * `translate` during that sidebar build (e.g. a built-in view label) sees an empty\n * config. Caching the first result would poison every later render-time call with\n * that empty-config English. Re-resolving each call is cheap (a few array ops) and\n * always reflects the config once the mount has run. `translate`/`localizedLabel`\n * are the hot callers; built-in view labels are lazy getters so they re-resolve too.\n */\nexport function resolveStudioI18n(): ResolvedI18n {\n  const config = resolveDeploymentI18n() ?? {}\n  const defaultLocale = config.defaultLocale ?? BUILTIN_DEFAULT_LOCALE\n  const locales = config.locales ?? {}\n  const available = [defaultLocale, ...Object.keys(locales).filter((l) => l !== defaultLocale)]\n  const locale = localeOverride ?? resolveActiveLocale(available, navigatorLanguages(), defaultLocale)\n  const active = locale === defaultLocale ? {} : (locales[locale] ?? {})\n  // Coverage lint: warn once when the active locale doesn't cover every English key.\n  if (locale !== defaultLocale && locales[locale]) {\n    const missing = Object.keys(EN_MESSAGES).filter((k) => !(k in active))\n    if (missing.length > 0) {\n      warnOnce(\n        `[i18n] locale \"${locale}\" is missing ${missing.length} message(s); falling back to English for those.`,\n      )\n    }\n  }\n  return { locale, defaultLocale, active, source: EN_MESSAGES }\n}\n\nfunction interpolate(text: string, vars: Record<string, string | number>): string {\n  return text.replace(/\\{(\\w+)\\}/g, (whole, key: string) => (key in vars ? String(vars[key]) : whole))\n}\n\n/**\n * Translate a message key for the active UI locale (EC-241): active-locale string\n * ?? English source ?? **the key itself** (a visible fallback + a one-time console\n * signal — \"failures are first-class\", never a silent blank). Non-hook — reads the\n * per-boot singleton, so config-build and pure code can localize too; {@link useT}\n * is the React-idiomatic wrapper.\n */\nexport function translate(key: string, vars?: Record<string, string | number>): string {\n  const i18n = resolveStudioI18n()\n  const hit = i18n.active[key] ?? i18n.source[key]?.message\n  if (hit === undefined) {\n    warnOnce(`[i18n] missing message key: \"${key}\"`)\n    return key\n  }\n  return vars ? interpolate(hit, vars) : hit\n}\n\n/**\n * Resolve a {@link LocalizedString} (field/collection/option label) against the\n * active UI locale (EC-241) — **non-hook**, reading the per-boot singleton, so it is\n * safe to call anywhere: a component body, a nested render helper, or config-build\n * code. Returns `fallback` (default `''`) when the value is absent. Prefer this over\n * `resolveLabel(x, useUiLocale())` at render sites — it localizes without a hook, so\n * it can't trip the rules-of-hooks in a conditional/nested position.\n */\nexport function localizedLabel(value: LocalizedString | undefined, fallback = ''): string {\n  const { locale, defaultLocale } = resolveStudioI18n()\n  return resolveLabel(value, locale, defaultLocale) ?? fallback\n}\n\n// --- React hooks ---\n\n/** The active studio-UI locale (browser-resolved). */\nexport function useUiLocale(): string {\n  return resolveStudioI18n().locale\n}\n\n/** A `t(key, vars?)` translator bound to the active locale. */\nexport function useT(): (key: string, vars?: Record<string, string | number>) => string {\n  return translate\n}\n\n/**\n * Resolve a {@link LocalizedString} label (field/collection/option) for the active\n * locale. Re-reads the locale each render (keyed into the memo) so it never captures\n * a locale resolved before the mount seeded the i18n config.\n */\nexport function useLabel(): (value: LocalizedString | undefined, fallback?: string) => string {\n  const { locale, defaultLocale } = resolveStudioI18n()\n  return useMemo(\n    () => (value, fallback) => resolveLabel(value, locale, defaultLocale) ?? fallback ?? '',\n    [locale, defaultLocale],\n  )\n}\n\n/** Test seam: force the active locale. Never used by app code. */\nexport function setUiLocaleForTests(locale: string | null): void {\n  localeOverride = locale\n  warned.clear()\n}\n\n/** Test seam: reset i18n state (the once-per-boot warnings). Never used by app code. */\nexport function resetStudioI18nForTests(): void {\n  warned.clear()\n}\n"]}

package/dist/lib/i18n/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@elytracms/studio/lib/i18n` — studio-UI localization (EC-241).
+ *
+ * - Public config surface (`StudioI18nConfig`, `MessageCatalog`, `msg`) is re-exported
+ *   from `@elytracms/studio/customization` so a consumer authors catalogs there.
+ * - Studio components localize chrome via `translate`/`useT` and schema labels via
+ *   `useLabel`.
+ */
+export type { SourceMessage, SourceCatalog, MessageCatalog, StudioI18nConfig } from './types';
+export { msg } from './types';
+export { EN_MESSAGES } from './messages.en';
+export { resolveActiveLocale, resolveStudioI18n, translate, localizedLabel, useT, useUiLocale, useLabel, setUiLocaleForTests, resetStudioI18nForTests, } from './i18n';

package/dist/lib/i18n/index.js

@@ -0,0 +1,4 @@
+export { msg } from './types';
+export { EN_MESSAGES } from './messages.en';
+export { resolveActiveLocale, resolveStudioI18n, translate, localizedLabel, useT, useUiLocale, useLabel, setUiLocaleForTests, resetStudioI18nForTests, } from './i18n';
+//# sourceMappingURL=index.js.map

package/dist/lib/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/i18n/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,QAAQ,CAAA","sourcesContent":["/**\n * `@elytracms/studio/lib/i18n` — studio-UI localization (EC-241).\n *\n * - Public config surface (`StudioI18nConfig`, `MessageCatalog`, `msg`) is re-exported\n *   from `@elytracms/studio/customization` so a consumer authors catalogs there.\n * - Studio components localize chrome via `translate`/`useT` and schema labels via\n *   `useLabel`.\n */\nexport type { SourceMessage, SourceCatalog, MessageCatalog, StudioI18nConfig } from './types'\nexport { msg } from './types'\nexport { EN_MESSAGES } from './messages.en'\nexport {\n  resolveActiveLocale,\n  resolveStudioI18n,\n  translate,\n  localizedLabel,\n  useT,\n  useUiLocale,\n  useLabel,\n  setUiLocaleForTests,\n  resetStudioI18nForTests,\n} from './i18n'\n"]}

package/dist/lib/i18n/messages.en.d.ts

@@ -0,0 +1,15 @@
+import type { SourceCatalog } from './types';
+/**
+ * The engine's built-in **English source catalog** (EC-241) — the source of truth
+ * and the ultimate fallback for every studio-chrome string. A consumer adds a
+ * language via `defineStudio({ i18n: { locales: { de: deMessages } } })`; a key
+ * missing from the active locale falls back to the English `message` here, then to
+ * the key itself (a visible fallback + a one-time console signal), never a silent
+ * blank.
+ *
+ * v1 seeds a representative, high-traffic slice — the section rail + the shell user
+ * menu — to prove the pipeline end-to-end. Extracting every remaining studio string
+ * into keys is an ongoing mechanical sweep (see EC-241 "scope honesty"), not a
+ * silent omission.
+ */
+export declare const EN_MESSAGES: SourceCatalog;

package/dist/lib/i18n/messages.en.js

@@ -0,0 +1,39 @@
+import { msg } from './types';
+/**
+ * The engine's built-in **English source catalog** (EC-241) — the source of truth
+ * and the ultimate fallback for every studio-chrome string. A consumer adds a
+ * language via `defineStudio({ i18n: { locales: { de: deMessages } } })`; a key
+ * missing from the active locale falls back to the English `message` here, then to
+ * the key itself (a visible fallback + a one-time console signal), never a silent
+ * blank.
+ *
+ * v1 seeds a representative, high-traffic slice — the section rail + the shell user
+ * menu — to prove the pipeline end-to-end. Extracting every remaining studio string
+ * into keys is an ongoing mechanical sweep (see EC-241 "scope honesty"), not a
+ * silent omission.
+ */
+export const EN_MESSAGES = {
+    // --- Built-in navigation views (the section rail) ---
+    'nav.cms.label': msg('CMS'),
+    'nav.cms.description': msg('Model collections, fields, and documents.'),
+    'nav.components.label': msg('Components'),
+    'nav.components.description': msg('Browse the registry of primitives and project components.'),
+    'nav.redirects.label': msg('Redirects'),
+    'nav.redirects.description': msg('Create and manage URL redirects (301/302) for this site.'),
+    'nav.assets.label': msg('Assets'),
+    'nav.assets.description': msg('Manage uploaded media and metadata.'),
+    'nav.users.label': msg('Users'),
+    'nav.users.description': msg('Manage who has access to this deployment and their role.'),
+    'nav.extensions.label': msg('Extensions'),
+    'nav.extensions.description': msg('Install components, field types, adapters, and templates from the marketplace.'),
+    'nav.settings.label': msg('Settings'),
+    'nav.settings.description': msg('Configure project metadata and locales.'),
+    // --- Current-user menu (shell header) ---
+    'userMenu.accountMenu': msg('Account menu', 'aria-label on the avatar button that opens the user menu.'),
+    'userMenu.lightMode': msg('Light mode', 'Menu item: switch the studio to the light colour theme.'),
+    'userMenu.darkMode': msg('Dark mode', 'Menu item: switch the studio to the dark colour theme.'),
+    'userMenu.accountSettings': msg('Account settings'),
+    'userMenu.soon': msg('Soon', 'Badge on a feature that is not available yet.'),
+    'userMenu.signOut': msg('Sign out'),
+};
+//# sourceMappingURL=messages.en.js.map

package/dist/lib/i18n/messages.en.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.en.js","sourceRoot":"","sources":["../../../src/lib/i18n/messages.en.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAG7B;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,uDAAuD;IACvD,eAAe,EAAE,GAAG,CAAC,KAAK,CAAC;IAC3B,qBAAqB,EAAE,GAAG,CAAC,2CAA2C,CAAC;IACvE,sBAAsB,EAAE,GAAG,CAAC,YAAY,CAAC;IACzC,4BAA4B,EAAE,GAAG,CAAC,2DAA2D,CAAC;IAC9F,qBAAqB,EAAE,GAAG,CAAC,WAAW,CAAC;IACvC,2BAA2B,EAAE,GAAG,CAAC,0DAA0D,CAAC;IAC5F,kBAAkB,EAAE,GAAG,CAAC,QAAQ,CAAC;IACjC,wBAAwB,EAAE,GAAG,CAAC,qCAAqC,CAAC;IACpE,iBAAiB,EAAE,GAAG,CAAC,OAAO,CAAC;IAC/B,uBAAuB,EAAE,GAAG,CAAC,0DAA0D,CAAC;IACxF,sBAAsB,EAAE,GAAG,CAAC,YAAY,CAAC;IACzC,4BAA4B,EAAE,GAAG,CAC/B,gFAAgF,CACjF;IACD,oBAAoB,EAAE,GAAG,CAAC,UAAU,CAAC;IACrC,0BAA0B,EAAE,GAAG,CAAC,yCAAyC,CAAC;IAE1E,2CAA2C;IAC3C,sBAAsB,EAAE,GAAG,CAAC,cAAc,EAAE,2DAA2D,CAAC;IACxG,oBAAoB,EAAE,GAAG,CAAC,YAAY,EAAE,yDAAyD,CAAC;IAClG,mBAAmB,EAAE,GAAG,CAAC,WAAW,EAAE,wDAAwD,CAAC;IAC/F,0BAA0B,EAAE,GAAG,CAAC,kBAAkB,CAAC;IACnD,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,+CAA+C,CAAC;IAC7E,kBAAkB,EAAE,GAAG,CAAC,UAAU,CAAC;CACpC,CAAA","sourcesContent":["import { msg } from './types'\nimport type { SourceCatalog } from './types'\n\n/**\n * The engine's built-in **English source catalog** (EC-241) — the source of truth\n * and the ultimate fallback for every studio-chrome string. A consumer adds a\n * language via `defineStudio({ i18n: { locales: { de: deMessages } } })`; a key\n * missing from the active locale falls back to the English `message` here, then to\n * the key itself (a visible fallback + a one-time console signal), never a silent\n * blank.\n *\n * v1 seeds a representative, high-traffic slice — the section rail + the shell user\n * menu — to prove the pipeline end-to-end. Extracting every remaining studio string\n * into keys is an ongoing mechanical sweep (see EC-241 \"scope honesty\"), not a\n * silent omission.\n */\nexport const EN_MESSAGES: SourceCatalog = {\n  // --- Built-in navigation views (the section rail) ---\n  'nav.cms.label': msg('CMS'),\n  'nav.cms.description': msg('Model collections, fields, and documents.'),\n  'nav.components.label': msg('Components'),\n  'nav.components.description': msg('Browse the registry of primitives and project components.'),\n  'nav.redirects.label': msg('Redirects'),\n  'nav.redirects.description': msg('Create and manage URL redirects (301/302) for this site.'),\n  'nav.assets.label': msg('Assets'),\n  'nav.assets.description': msg('Manage uploaded media and metadata.'),\n  'nav.users.label': msg('Users'),\n  'nav.users.description': msg('Manage who has access to this deployment and their role.'),\n  'nav.extensions.label': msg('Extensions'),\n  'nav.extensions.description': msg(\n    'Install components, field types, adapters, and templates from the marketplace.',\n  ),\n  'nav.settings.label': msg('Settings'),\n  'nav.settings.description': msg('Configure project metadata and locales.'),\n\n  // --- Current-user menu (shell header) ---\n  'userMenu.accountMenu': msg('Account menu', 'aria-label on the avatar button that opens the user menu.'),\n  'userMenu.lightMode': msg('Light mode', 'Menu item: switch the studio to the light colour theme.'),\n  'userMenu.darkMode': msg('Dark mode', 'Menu item: switch the studio to the dark colour theme.'),\n  'userMenu.accountSettings': msg('Account settings'),\n  'userMenu.soon': msg('Soon', 'Badge on a feature that is not available yet.'),\n  'userMenu.signOut': msg('Sign out'),\n}\n"]}

package/dist/lib/i18n/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Studio-UI localization types (EC-241) — the leaf module both the message catalog
+ * and the resolver import, so nothing here may import studio runtime code (keeps the
+ * `defineStudio` config surface free of import cycles).
+ *
+ * This is the **studio-chrome** axis (engine-owned strings). Schema labels are a
+ * separate mechanism — a {@link import('@elytracms/core/cms-core').LocalizedString}
+ * on the field/collection def, resolved via `resolveLabel`. Content-*value*
+ * localization is a third, unrelated axis (`cms-core/localization.ts`).
+ */
+/** A source-catalog entry: the English string + an optional translator hint. */
+export interface SourceMessage {
+    /** The English (source-of-truth) string. */
+    message: string;
+    /**
+     * Translator hint/context — the same word can translate differently by context
+     * (the standard `msgctxt`/Lingui-comment idea). **Authoring/translation-time only:**
+     * it lives on the in-engine source catalog and is NOT shipped in the flat
+     * consumer-provided translation catalogs.
+     */
+    description?: string;
+}
+/** The in-engine English source catalog: message key → {@link SourceMessage}. */
+export type SourceCatalog = Record<string, SourceMessage>;
+/** A consumer-provided translation catalog: flat message key → localized string. */
+export type MessageCatalog = Record<string, string>;
+/** The studio-UI localization config passed to `defineStudio({ i18n })` (EC-241). */
+export interface StudioI18nConfig {
+    /**
+     * The locale used when the browser's preferred locale matches nothing available.
+     * Defaults to `'en'` (the in-engine source language).
+     */
+    defaultLocale?: string;
+    /**
+     * Imported translation catalogs keyed by locale code, e.g. `{ de: deMessages }`.
+     * English is always available as the built-in source, so it need not be listed.
+     */
+    locales?: Record<string, MessageCatalog>;
+}
+/**
+ * Author a source-catalog entry with an optional translator hint (EC-241). Kept in
+ * this leaf module so `messages.en.ts` can build the catalog without importing the
+ * resolver (which would import studio runtime code).
+ */
+export declare function msg(message: string, description?: string): SourceMessage;

package/dist/lib/i18n/types.js

@@ -0,0 +1,19 @@
+/**
+ * Studio-UI localization types (EC-241) — the leaf module both the message catalog
+ * and the resolver import, so nothing here may import studio runtime code (keeps the
+ * `defineStudio` config surface free of import cycles).
+ *
+ * This is the **studio-chrome** axis (engine-owned strings). Schema labels are a
+ * separate mechanism — a {@link import('@elytracms/core/cms-core').LocalizedString}
+ * on the field/collection def, resolved via `resolveLabel`. Content-*value*
+ * localization is a third, unrelated axis (`cms-core/localization.ts`).
+ */
+/**
+ * Author a source-catalog entry with an optional translator hint (EC-241). Kept in
+ * this leaf module so `messages.en.ts` can build the catalog without importing the
+ * resolver (which would import studio runtime code).
+ */
+export function msg(message, description) {
+    return description !== undefined ? { message, description } : { message };
+}
+//# sourceMappingURL=types.js.map

package/dist/lib/i18n/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/i18n/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmCH;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,WAAoB;IACvD,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAA;AAC3E,CAAC","sourcesContent":["/**\n * Studio-UI localization types (EC-241) — the leaf module both the message catalog\n * and the resolver import, so nothing here may import studio runtime code (keeps the\n * `defineStudio` config surface free of import cycles).\n *\n * This is the **studio-chrome** axis (engine-owned strings). Schema labels are a\n * separate mechanism — a {@link import('@elytracms/core/cms-core').LocalizedString}\n * on the field/collection def, resolved via `resolveLabel`. Content-*value*\n * localization is a third, unrelated axis (`cms-core/localization.ts`).\n */\n\n/** A source-catalog entry: the English string + an optional translator hint. */\nexport interface SourceMessage {\n  /** The English (source-of-truth) string. */\n  message: string\n  /**\n   * Translator hint/context — the same word can translate differently by context\n   * (the standard `msgctxt`/Lingui-comment idea). **Authoring/translation-time only:**\n   * it lives on the in-engine source catalog and is NOT shipped in the flat\n   * consumer-provided translation catalogs.\n   */\n  description?: string\n}\n\n/** The in-engine English source catalog: message key → {@link SourceMessage}. */\nexport type SourceCatalog = Record<string, SourceMessage>\n\n/** A consumer-provided translation catalog: flat message key → localized string. */\nexport type MessageCatalog = Record<string, string>\n\n/** The studio-UI localization config passed to `defineStudio({ i18n })` (EC-241). */\nexport interface StudioI18nConfig {\n  /**\n   * The locale used when the browser's preferred locale matches nothing available.\n   * Defaults to `'en'` (the in-engine source language).\n   */\n  defaultLocale?: string\n  /**\n   * Imported translation catalogs keyed by locale code, e.g. `{ de: deMessages }`.\n   * English is always available as the built-in source, so it need not be listed.\n   */\n  locales?: Record<string, MessageCatalog>\n}\n\n/**\n * Author a source-catalog entry with an optional translator hint (EC-241). Kept in\n * this leaf module so `messages.en.ts` can build the catalog without importing the\n * resolver (which would import studio runtime code).\n */\nexport function msg(message: string, description?: string): SourceMessage {\n  return description !== undefined ? { message, description } : { message }\n}\n"]}

package/dist/lib/persistence/convex-adapter.js

@@ -587,6 +587,7 @@ function redirectEntryFromDoc(doc, projectId) {
         to: doc.to,
         permanent: doc.permanent,
         enabled: doc.enabled,
+        ...(doc.meta !== undefined ? { meta: doc.meta } : {}),
         createdAt: doc.createdAt,
         updatedAt: doc.updatedAt,
     };
@@ -614,6 +615,7 @@ class ConvexRedirectRepository {
             to: input.to,
             permanent: input.permanent ?? true,
             enabled: input.enabled ?? true,
+            ...(input.meta !== undefined ? { meta: input.meta } : {}),
             createdAt: now,
             updatedAt: now,
         }));