@elytracms/studio 0.0.81 → 0.0.83

package/dist/lib/i18n/i18n.js

@@ -1,14 +1,32 @@
-import { useMemo } from 'react';
+import { useMemo, useSyncExternalStore } from 'react';
 import { resolveLabel } from '@elytracms/core/cms-core';
 import { resolveDeploymentI18n } from '@elytracms/studio/lib/workspace';
 import { EN_MESSAGES } from './messages.en.js';
 /**
- * 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.
+ * Studio-UI localization runtime (EC-241). Resolves the active UI locale, then
+ * translates message keys with an active-locale → English → visible-fallback chain.
+ *
+ * **Locale resolution is client-side** (EC-513, owner-ratified 2026-08-01: "the studio
+ * is primarily client-side and locales should be too"). Two mechanisms, in precedence
+ * order:
+ *
+ * 1. **`defineStudio({ i18n: { locale } })` — the supported way to fix the UI language.**
+ *    A pin is read from *config*, which is imported identically on server and client, so
+ *    SSR and the browser render the same locale with no header plumbing and no flash.
+ *    Both production consumers pin `de`.
+ * 2. **Browser detection** (`navigator.languages`) when nothing is pinned. It is
+ *    **deferred until after hydration** — see {@link subscribeToUiLocale}. The server
+ *    has no `navigator`, so it renders the default/pinned locale; the first client
+ *    render must produce byte-identical output or React discards the whole tree with a
+ *    hydration error (measured EC-513 under `de-DE`: the auth gate's "Checking session…").
+ *
+ * There is deliberately **no server-side resolver seam**. `setServerLanguagesResolver` +
+ * `parseAcceptLanguage` shipped exported and unit-tested from EC-241 but were never
+ * called by anything in production — not the demo, not the scaffold template, neither
+ * consumer — and EC-241 itself had already measured that TanStack Start's request-header
+ * helper is unreachable from a normal SSR route. EC-513 deleted both.
+ *
+ * No persisted locale selector in v1 (that rides EC-240's deferred account settings).
  */
 const BUILTIN_DEFAULT_LOCALE = 'en';
 /**
@@ -28,50 +46,95 @@ export function resolveActiveLocale(available, preferred, defaultLocale) {
     return defaultLocale;
 }
 let localeOverride = null;
-let serverLanguagesResolver = null;
+// --- post-hydration browser-locale detection (EC-513) ---
+let browserDetectionEnabled = false;
+const localeListeners = new Set();
 /**
- * Provide the request's preferred languages for **SSR** (EC-241). The server has no
- * `navigator`, so without this the server renders the default locale while the client
- * renders the browser locale — a hydration mismatch (server text ≠ client text). A
- * host (e.g. the TanStack Start root) sets a resolver that reads the request's
- * `Accept-Language` header. It is invoked per render, so when the host reads from
- * request-scoped storage (TanStack's AsyncLocalStorage) it stays concurrency-safe —
- * the engine keeps no request state. A no-op on the client, where `navigator` wins.
+ * Is `navigator` allowed to influence the resolved locale yet?
+ *
+ * In a **browser** it is not, until the first committed render of a locale consumer has
+ * run — the hydration render has to reproduce the server's markup exactly, and the
+ * server never sees `navigator`. Outside a browser (SSR, node tests) there is nothing
+ * to defer: `navigatorLanguages()` there is either genuinely absent (server → `[]`, the
+ * default locale, which is precisely what must be reproduced) or deliberately stubbed
+ * by a test.
  */
-export function setServerLanguagesResolver(fn) {
-    serverLanguagesResolver = fn;
+function browserDetectionReady() {
+    return browserDetectionEnabled || typeof window === 'undefined';
 }
 /**
- * Parse an HTTP `Accept-Language` header into an ordered list of language tags,
- * highest q-weight first: `de,en-US;q=0.7,en;q=0.3` → `['de', 'en-US', 'en']`. The
- * server equivalent of `navigator.languages`, so SSR resolves the same locale the
- * client will.
+ * Subscribe to the resolved UI locale, and — on the first subscription — switch browser
+ * detection on (EC-513).
+ *
+ * This is the whole post-hydration handover. `useSyncExternalStore` subscribes in a
+ * commit effect, i.e. **after** React has hydrated the server markup, so every render up
+ * to that point resolves the same default/pinned locale the server did. Flipping the flag
+ * changes the snapshot, React re-renders, and from then on `navigator.languages` decides.
+ *
+ * The flip is one-way and global rather than per-subscriber because the runtime is a
+ * per-boot singleton: 948 of the studio's ~956 localized render sites call the non-hook
+ * {@link translate} (measured 2026-08-01), so a per-hook flag would leave almost the whole
+ * chrome reading a locale nobody re-rendered for. The studio root subscribes once
+ * (`router/root.tsx`), which re-renders the tree exactly once when the handover happens.
+ *
+ * Exported (module-level only — deliberately not on the `lib/i18n` barrel) so the
+ * handover is testable without a React renderer, per the house test pattern.
  */
-export function parseAcceptLanguage(header) {
-    if (!header)
-        return [];
-    return header
-        .split(',')
-        .map((part) => {
-        const [tag, ...params] = part.trim().split(';');
-        const q = params.map((p) => p.trim()).find((p) => p.startsWith('q='));
-        const weight = q ? Number.parseFloat(q.slice(2)) : 1;
-        return { tag: (tag ?? '').trim(), weight: Number.isFinite(weight) ? weight : 1 };
-    })
-        .filter((entry) => entry.tag !== '' && entry.tag !== '*')
-        .sort((a, b) => b.weight - a.weight)
-        .map((entry) => entry.tag);
+export function subscribeToUiLocale(listener) {
+    localeListeners.add(listener);
+    if (!browserDetectionEnabled) {
+        browserDetectionEnabled = true;
+        for (const l of [...localeListeners])
+            l();
+    }
+    return () => {
+        localeListeners.delete(listener);
+    };
+}
+function uiLocaleSnapshot() {
+    return resolveStudioI18n().locale;
+}
+// --- post-hydration rendering gate (EC-523) ---
+const noopUnsubscribe = () => { };
+const subscribeNever = () => noopUnsubscribe;
+const hydratedSnapshot = () => true;
+const preHydrationSnapshot = () => false;
+/**
+ * Has React finished hydrating? `false` for every server render **and** for the
+ * hydration render itself; `true` from the first committed client render onwards.
+ *
+ * **Gate any localized text that can reach the prerendered shell on this** (EC-523).
+ * The studio builds as a static SPA, so `dist/client/_shell.html` is rendered at BUILD
+ * time: no request, no `Accept-Language`, no session. Every localized string baked into
+ * that file is therefore guaranteed wrong for some visitor — and that includes
+ * `aria-label` / `sr-only` text, because an accessible name is still a string and a
+ * screen-reader user cannot even notice it flip. The honest shape is to render no words
+ * at all until hydration, then announce in the visitor's real locale.
+ *
+ * Mechanism, and why it cannot itself cause a mismatch: `useSyncExternalStore` reads
+ * `getServerSnapshot` for the prerender *and* for the hydration render, so the two agree
+ * (a text mismatch makes React discard the whole tree — EC-513), then switches to
+ * `getSnapshot` in the commit that follows. The store never changes again, so `subscribe`
+ * is an inert module-level constant; a fresh closure per render would resubscribe on
+ * every render.
+ *
+ * Lives beside the EC-513 locale handover deliberately: both answer the same question —
+ * *is it safe to render locale-dependent output yet?* — and a contributor chasing "why is
+ * my string baked into the shell?" lands here.
+ */
+export function useHydrated() {
+    return useSyncExternalStore(subscribeNever, hydratedSnapshot, preHydrationSnapshot);
 }
 function navigatorLanguages() {
+    if (!browserDetectionReady())
+        return [];
     if (typeof navigator !== 'undefined') {
         if (navigator.languages && navigator.languages.length > 0)
             return [...navigator.languages];
         if (navigator.language)
             return [navigator.language];
     }
-    // SSR (no navigator): a host may resolve the request's Accept-Language.
-    const server = serverLanguagesResolver?.();
-    return server ? [...server] : [];
+    return [];
 }
 const warned = new Set();
 function warnOnce(message) {
@@ -185,12 +248,20 @@ export function localizedLabel(value, fallback = '') {
     return resolveLabel(value, locale, defaultLocale) ?? fallback;
 }
 // --- React hooks ---
-/** The active studio-UI locale (browser-resolved). */
+/**
+ * The active studio-UI locale — config-pinned, else browser-resolved.
+ *
+ * Subscribing (EC-513) is what makes the post-hydration handover visible: the hydration
+ * render gets the server's locale, and the component re-renders once when browser
+ * detection takes over. `router/root.tsx` calls this at the root so the whole chrome —
+ * including the ~948 non-hook {@link translate} sites — re-renders with it.
+ */
 export function useUiLocale() {
-    return resolveStudioI18n().locale;
+    return useSyncExternalStore(subscribeToUiLocale, uiLocaleSnapshot, uiLocaleSnapshot);
 }
 /** A `t(key, vars?)` translator bound to the active locale. */
 export function useT() {
+    useUiLocale(); // re-render this component when the locale handover happens (EC-513)
     return translate;
 }
 /**
@@ -199,7 +270,8 @@ export function useT() {
  * a locale resolved before the mount seeded the i18n config.
  */
 export function useLabel() {
-    const { locale, defaultLocale } = resolveStudioI18n();
+    const locale = useUiLocale(); // subscribes to the EC-513 post-hydration handover
+    const { defaultLocale } = resolveStudioI18n();
     return useMemo(() => (value, fallback) => resolveMsgLabel(value) ?? resolveLabel(value, locale, defaultLocale) ?? fallback ?? '', [locale, defaultLocale]);
 }
 /** Test seam: force the active locale. Never used by app code. */
@@ -207,9 +279,13 @@ export function setUiLocaleForTests(locale) {
     localeOverride = locale;
     warned.clear();
 }
-/** Test seam: reset i18n state (once-per-boot warnings + the SSR resolver). Never used by app code. */
+/**
+ * Test seam: reset i18n state — once-per-boot warnings + the EC-513 browser-detection
+ * handover flag and its subscribers. Never used by app code.
+ */
 export function resetStudioI18nForTests() {
     warned.clear();
-    serverLanguagesResolver = null;
+    browserDetectionEnabled = false;
+    localeListeners.clear();
 }
 //# sourceMappingURL=i18n.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/lib/i18n/i18n.ts"],"names":[],"mappings":"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","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\ntype LanguagesResolver = () => readonly string[] | null | undefined\nlet serverLanguagesResolver: LanguagesResolver | null = null\n\n/**\n * Provide the request's preferred languages for **SSR** (EC-241). The server has no\n * `navigator`, so without this the server renders the default locale while the client\n * renders the browser locale — a hydration mismatch (server text ≠ client text). A\n * host (e.g. the TanStack Start root) sets a resolver that reads the request's\n * `Accept-Language` header. It is invoked per render, so when the host reads from\n * request-scoped storage (TanStack's AsyncLocalStorage) it stays concurrency-safe —\n * the engine keeps no request state. A no-op on the client, where `navigator` wins.\n */\nexport function setServerLanguagesResolver(fn: LanguagesResolver | null): void {\n  serverLanguagesResolver = fn\n}\n\n/**\n * Parse an HTTP `Accept-Language` header into an ordered list of language tags,\n * highest q-weight first: `de,en-US;q=0.7,en;q=0.3` → `['de', 'en-US', 'en']`. The\n * server equivalent of `navigator.languages`, so SSR resolves the same locale the\n * client will.\n */\nexport function parseAcceptLanguage(header: string | null | undefined): string[] {\n  if (!header) return []\n  return header\n    .split(',')\n    .map((part) => {\n      const [tag, ...params] = part.trim().split(';')\n      const q = params.map((p) => p.trim()).find((p) => p.startsWith('q='))\n      const weight = q ? Number.parseFloat(q.slice(2)) : 1\n      return { tag: (tag ?? '').trim(), weight: Number.isFinite(weight) ? weight : 1 }\n    })\n    .filter((entry) => entry.tag !== '' && entry.tag !== '*')\n    .sort((a, b) => b.weight - a.weight)\n    .map((entry) => entry.tag)\n}\n\nfunction navigatorLanguages(): string[] {\n  if (typeof navigator !== 'undefined') {\n    if (navigator.languages && navigator.languages.length > 0) return [...navigator.languages]\n    if (navigator.language) return [navigator.language]\n  }\n  // SSR (no navigator): a host may resolve the request's Accept-Language.\n  const server = serverLanguagesResolver?.()\n  return server ? [...server] : []\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  // A config-pinned locale (EC-241) takes precedence over browser detection: it is read\n  // from config — identical on server and client — so SSR and hydration agree (no\n  // navigator-vs-server split). An unavailable pin is ignored with a visible signal\n  // (\"failures are first-class\"), and detection resumes.\n  let pinned: string | undefined\n  if (config.locale !== undefined) {\n    if (available.includes(config.locale)) pinned = config.locale\n    else\n      warnOnce(\n        `[i18n] pinned locale \"${config.locale}\" is not available (default \"${defaultLocale}\" + ${JSON.stringify(Object.keys(locales))}); using browser detection.`,\n      )\n  }\n  const locale =\n    localeOverride ?? pinned ?? 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 * A **catalog-backed** schema label (EC-241): a label whose text comes from the message\n * catalog by `key`, not a hard-coded string or a per-locale map. This is how the\n * engine's own built-in schemas (the redirects/users rails) localize — their default\n * labels resolve through the *same* consumer catalog as the rest of the chrome, so one\n * German catalog covers them with no per-rail override and no per-language data in\n * engine code. Consumers never author these (their labels are plain strings or\n * `{ en, de }` maps); it is an engine-internal seam.\n *\n * Encoded as a sentinel-prefixed string so it is a valid {@link LocalizedString} (no\n * change to the serializable schema type) and survives zod parse / object spread — it\n * is decoded only at the final render site by {@link resolveMsgLabel}. On the delivery\n * side (no catalog) `resolveLabel` returns it verbatim, which is harmless: the built-in\n * rails never render there.\n */\nconst MSG_LABEL_SENTINEL = '@@msg:'\nexport function msgLabel(key: string): LocalizedString {\n  return MSG_LABEL_SENTINEL + key\n}\n\n/**\n * Decode a {@link msgLabel} to its translated string for the active locale, or\n * `undefined` when the value is not a catalog-backed label (a plain string / locale\n * map / absent). Every studio label read site checks this first, then falls back to\n * {@link resolveLabel} for ordinary labels.\n */\nexport function resolveMsgLabel(value: unknown): string | undefined {\n  return typeof value === 'string' && value.startsWith(MSG_LABEL_SENTINEL)\n    ? translate(value.slice(MSG_LABEL_SENTINEL.length))\n    : undefined\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. A catalog-backed\n * {@link msgLabel} (the built-in rails) resolves through the message catalog.\n */\nexport function localizedLabel(value: LocalizedString | undefined, fallback = ''): string {\n  const fromCatalog = resolveMsgLabel(value)\n  if (fromCatalog !== undefined) return fromCatalog\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) =>\n      resolveMsgLabel(value) ?? 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 (once-per-boot warnings + the SSR resolver). Never used by app code. */\nexport function resetStudioI18nForTests(): void {\n  warned.clear()\n  serverLanguagesResolver = null\n}\n"]}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/lib/i18n/i18n.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo, useSyncExternalStore } 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, then\n * translates message keys with an active-locale → English → visible-fallback chain.\n *\n * **Locale resolution is client-side** (EC-513, owner-ratified 2026-08-01: \"the studio\n * is primarily client-side and locales should be too\"). Two mechanisms, in precedence\n * order:\n *\n * 1. **`defineStudio({ i18n: { locale } })` — the supported way to fix the UI language.**\n *    A pin is read from *config*, which is imported identically on server and client, so\n *    SSR and the browser render the same locale with no header plumbing and no flash.\n *    Both production consumers pin `de`.\n * 2. **Browser detection** (`navigator.languages`) when nothing is pinned. It is\n *    **deferred until after hydration** — see {@link subscribeToUiLocale}. The server\n *    has no `navigator`, so it renders the default/pinned locale; the first client\n *    render must produce byte-identical output or React discards the whole tree with a\n *    hydration error (measured EC-513 under `de-DE`: the auth gate's \"Checking session…\").\n *\n * There is deliberately **no server-side resolver seam**. `setServerLanguagesResolver` +\n * `parseAcceptLanguage` shipped exported and unit-tested from EC-241 but were never\n * called by anything in production — not the demo, not the scaffold template, neither\n * consumer — and EC-241 itself had already measured that TanStack Start's request-header\n * helper is unreachable from a normal SSR route. EC-513 deleted both.\n *\n * No persisted locale selector in v1 (that rides EC-240's deferred account settings).\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\n// --- post-hydration browser-locale detection (EC-513) ---\n\nlet browserDetectionEnabled = false\nconst localeListeners = new Set<() => void>()\n\n/**\n * Is `navigator` allowed to influence the resolved locale yet?\n *\n * In a **browser** it is not, until the first committed render of a locale consumer has\n * run — the hydration render has to reproduce the server's markup exactly, and the\n * server never sees `navigator`. Outside a browser (SSR, node tests) there is nothing\n * to defer: `navigatorLanguages()` there is either genuinely absent (server → `[]`, the\n * default locale, which is precisely what must be reproduced) or deliberately stubbed\n * by a test.\n */\nfunction browserDetectionReady(): boolean {\n  return browserDetectionEnabled || typeof window === 'undefined'\n}\n\n/**\n * Subscribe to the resolved UI locale, and — on the first subscription — switch browser\n * detection on (EC-513).\n *\n * This is the whole post-hydration handover. `useSyncExternalStore` subscribes in a\n * commit effect, i.e. **after** React has hydrated the server markup, so every render up\n * to that point resolves the same default/pinned locale the server did. Flipping the flag\n * changes the snapshot, React re-renders, and from then on `navigator.languages` decides.\n *\n * The flip is one-way and global rather than per-subscriber because the runtime is a\n * per-boot singleton: 948 of the studio's ~956 localized render sites call the non-hook\n * {@link translate} (measured 2026-08-01), so a per-hook flag would leave almost the whole\n * chrome reading a locale nobody re-rendered for. The studio root subscribes once\n * (`router/root.tsx`), which re-renders the tree exactly once when the handover happens.\n *\n * Exported (module-level only — deliberately not on the `lib/i18n` barrel) so the\n * handover is testable without a React renderer, per the house test pattern.\n */\nexport function subscribeToUiLocale(listener: () => void): () => void {\n  localeListeners.add(listener)\n  if (!browserDetectionEnabled) {\n    browserDetectionEnabled = true\n    for (const l of [...localeListeners]) l()\n  }\n  return () => {\n    localeListeners.delete(listener)\n  }\n}\n\nfunction uiLocaleSnapshot(): string {\n  return resolveStudioI18n().locale\n}\n\n// --- post-hydration rendering gate (EC-523) ---\n\nconst noopUnsubscribe = () => {}\nconst subscribeNever = () => noopUnsubscribe\nconst hydratedSnapshot = () => true\nconst preHydrationSnapshot = () => false\n\n/**\n * Has React finished hydrating? `false` for every server render **and** for the\n * hydration render itself; `true` from the first committed client render onwards.\n *\n * **Gate any localized text that can reach the prerendered shell on this** (EC-523).\n * The studio builds as a static SPA, so `dist/client/_shell.html` is rendered at BUILD\n * time: no request, no `Accept-Language`, no session. Every localized string baked into\n * that file is therefore guaranteed wrong for some visitor — and that includes\n * `aria-label` / `sr-only` text, because an accessible name is still a string and a\n * screen-reader user cannot even notice it flip. The honest shape is to render no words\n * at all until hydration, then announce in the visitor's real locale.\n *\n * Mechanism, and why it cannot itself cause a mismatch: `useSyncExternalStore` reads\n * `getServerSnapshot` for the prerender *and* for the hydration render, so the two agree\n * (a text mismatch makes React discard the whole tree — EC-513), then switches to\n * `getSnapshot` in the commit that follows. The store never changes again, so `subscribe`\n * is an inert module-level constant; a fresh closure per render would resubscribe on\n * every render.\n *\n * Lives beside the EC-513 locale handover deliberately: both answer the same question —\n * *is it safe to render locale-dependent output yet?* — and a contributor chasing \"why is\n * my string baked into the shell?\" lands here.\n */\nexport function useHydrated(): boolean {\n  return useSyncExternalStore(subscribeNever, hydratedSnapshot, preHydrationSnapshot)\n}\n\nfunction navigatorLanguages(): string[] {\n  if (!browserDetectionReady()) return []\n  if (typeof navigator !== 'undefined') {\n    if (navigator.languages && navigator.languages.length > 0) return [...navigator.languages]\n    if (navigator.language) return [navigator.language]\n  }\n  return []\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  // A config-pinned locale (EC-241) takes precedence over browser detection: it is read\n  // from config — identical on server and client — so SSR and hydration agree (no\n  // navigator-vs-server split). An unavailable pin is ignored with a visible signal\n  // (\"failures are first-class\"), and detection resumes.\n  let pinned: string | undefined\n  if (config.locale !== undefined) {\n    if (available.includes(config.locale)) pinned = config.locale\n    else\n      warnOnce(\n        `[i18n] pinned locale \"${config.locale}\" is not available (default \"${defaultLocale}\" + ${JSON.stringify(Object.keys(locales))}); using browser detection.`,\n      )\n  }\n  const locale =\n    localeOverride ?? pinned ?? 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 * A **catalog-backed** schema label (EC-241): a label whose text comes from the message\n * catalog by `key`, not a hard-coded string or a per-locale map. This is how the\n * engine's own built-in schemas (the redirects/users rails) localize — their default\n * labels resolve through the *same* consumer catalog as the rest of the chrome, so one\n * German catalog covers them with no per-rail override and no per-language data in\n * engine code. Consumers never author these (their labels are plain strings or\n * `{ en, de }` maps); it is an engine-internal seam.\n *\n * Encoded as a sentinel-prefixed string so it is a valid {@link LocalizedString} (no\n * change to the serializable schema type) and survives zod parse / object spread — it\n * is decoded only at the final render site by {@link resolveMsgLabel}. On the delivery\n * side (no catalog) `resolveLabel` returns it verbatim, which is harmless: the built-in\n * rails never render there.\n */\nconst MSG_LABEL_SENTINEL = '@@msg:'\nexport function msgLabel(key: string): LocalizedString {\n  return MSG_LABEL_SENTINEL + key\n}\n\n/**\n * Decode a {@link msgLabel} to its translated string for the active locale, or\n * `undefined` when the value is not a catalog-backed label (a plain string / locale\n * map / absent). Every studio label read site checks this first, then falls back to\n * {@link resolveLabel} for ordinary labels.\n */\nexport function resolveMsgLabel(value: unknown): string | undefined {\n  return typeof value === 'string' && value.startsWith(MSG_LABEL_SENTINEL)\n    ? translate(value.slice(MSG_LABEL_SENTINEL.length))\n    : undefined\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. A catalog-backed\n * {@link msgLabel} (the built-in rails) resolves through the message catalog.\n */\nexport function localizedLabel(value: LocalizedString | undefined, fallback = ''): string {\n  const fromCatalog = resolveMsgLabel(value)\n  if (fromCatalog !== undefined) return fromCatalog\n  const { locale, defaultLocale } = resolveStudioI18n()\n  return resolveLabel(value, locale, defaultLocale) ?? fallback\n}\n\n// --- React hooks ---\n\n/**\n * The active studio-UI locale — config-pinned, else browser-resolved.\n *\n * Subscribing (EC-513) is what makes the post-hydration handover visible: the hydration\n * render gets the server's locale, and the component re-renders once when browser\n * detection takes over. `router/root.tsx` calls this at the root so the whole chrome —\n * including the ~948 non-hook {@link translate} sites — re-renders with it.\n */\nexport function useUiLocale(): string {\n  return useSyncExternalStore(subscribeToUiLocale, uiLocaleSnapshot, uiLocaleSnapshot)\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  useUiLocale() // re-render this component when the locale handover happens (EC-513)\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 = useUiLocale() // subscribes to the EC-513 post-hydration handover\n  const { defaultLocale } = resolveStudioI18n()\n  return useMemo(\n    () => (value, fallback) =>\n      resolveMsgLabel(value) ?? 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/**\n * Test seam: reset i18n state — once-per-boot warnings + the EC-513 browser-detection\n * handover flag and its subscribers. Never used by app code.\n */\nexport function resetStudioI18nForTests(): void {\n  warned.clear()\n  browserDetectionEnabled = false\n  localeListeners.clear()\n}\n"]}

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

@@ -5,9 +5,16 @@
  *   from `@elytracms/studio/customization` so a consumer authors catalogs there.
  * - Studio components localize chrome via `translate`/`useT` and schema labels via
  *   `useLabel`.
+ * - **`defineStudio({ i18n: { locale } })` is the supported way to fix the UI language**
+ *   (EC-513); unpinned deployments follow the browser, resolved client-side after
+ *   hydration. There is no server-side resolver seam — `setServerLanguagesResolver` and
+ *   `parseAcceptLanguage` were deleted in EC-513, having never had a production caller.
+ * - **Anything that can render into the build-time SPA shell must gate its text on
+ *   `useHydrated`** (EC-523). The shell is prerendered with no request, so a localized
+ *   string baked into it — visible copy *or* an accessible name — is wrong for someone.
  */
 export type { SourceMessage, SourceCatalog, MessageCatalog, StudioI18nConfig } from './types.js';
 export { msg } from './types.js';
 export { EN_MESSAGES } from './messages.en.js';
 export type { MessageKey, TranslationCatalog } from './messages.en.js';
-export { resolveActiveLocale, resolveStudioI18n, translate, localizedLabel, msgLabel, resolveMsgLabel, useT, useUiLocale, useLabel, parseAcceptLanguage, setServerLanguagesResolver, setUiLocaleForTests, resetStudioI18nForTests, } from './i18n.js';
+export { resolveActiveLocale, resolveStudioI18n, translate, localizedLabel, msgLabel, resolveMsgLabel, useT, useUiLocale, useLabel, useHydrated, setUiLocaleForTests, resetStudioI18nForTests, } from './i18n.js';

package/dist/lib/i18n/index.js

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

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

@@ -1 +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;AAE3C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,QAAQ,EACR,eAAe,EACf,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,0BAA0B,EAC1B,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 type { MessageKey, TranslationCatalog } from './messages.en'\nexport {\n  resolveActiveLocale,\n  resolveStudioI18n,\n  translate,\n  localizedLabel,\n  msgLabel,\n  resolveMsgLabel,\n  useT,\n  useUiLocale,\n  useLabel,\n  parseAcceptLanguage,\n  setServerLanguagesResolver,\n  setUiLocaleForTests,\n  resetStudioI18nForTests,\n} from './i18n'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/i18n/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,QAAQ,EACR,eAAe,EACf,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,WAAW,EACX,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 * - **`defineStudio({ i18n: { locale } })` is the supported way to fix the UI language**\n *   (EC-513); unpinned deployments follow the browser, resolved client-side after\n *   hydration. There is no server-side resolver seam — `setServerLanguagesResolver` and\n *   `parseAcceptLanguage` were deleted in EC-513, having never had a production caller.\n * - **Anything that can render into the build-time SPA shell must gate its text on\n *   `useHydrated`** (EC-523). The shell is prerendered with no request, so a localized\n *   string baked into it — visible copy *or* an accessible name — is wrong for someone.\n */\nexport type { SourceMessage, SourceCatalog, MessageCatalog, StudioI18nConfig } from './types'\nexport { msg } from './types'\nexport { EN_MESSAGES } from './messages.en'\nexport type { MessageKey, TranslationCatalog } from './messages.en'\nexport {\n  resolveActiveLocale,\n  resolveStudioI18n,\n  translate,\n  localizedLabel,\n  msgLabel,\n  resolveMsgLabel,\n  useT,\n  useUiLocale,\n  useLabel,\n  useHydrated,\n  setUiLocaleForTests,\n  resetStudioI18nForTests,\n} from './i18n'\n"]}

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

@@ -217,6 +217,44 @@ export const deMessages = {
     // the session-expired predicate; re-auth happens in place, no navigation.
     'error.sessionExpiredTitle': 'Sie wurden abgemeldet',
     'error.sessionExpired': 'Sie wurden abgemeldet, daher werden Ihre letzten Änderungen nicht gespeichert. Melden Sie sich erneut an, um weiterzuarbeiten — Ihre ungespeicherten Änderungen bleiben genau hier erhalten.',
+    // EC-494 — Betriebs-Fehler, die die Operations-Grenze überqueren. Bezeichner
+    // (Operationsnamen, Entitätsarten, Dokumentschlüssel, Feldnamen) bleiben unübersetzt.
+    // EC-494 — die Titel der Fehler-Badges im Banner.
+    'operations.errorLabel.validation': 'Konnte nicht gespeichert werden',
+    'operations.errorLabel.not-found': 'Nicht gefunden',
+    'operations.errorLabel.conflict': 'Existiert bereits',
+    'operations.errorLabel.backend-unavailable': 'Verbindungsproblem',
+    'operations.errorLabel.unauthorized': 'Nicht erlaubt',
+    'operations.errorLabel.unknown': 'Etwas ist schiefgelaufen',
+    'operations.error.invalidInput': 'Die Eingabe für „{operation}“ ist ungültig.',
+    'operations.error.notFound': 'Kein {entity} für „{target}“ gefunden.',
+    'operations.error.conflict': '„{target}“ steht im Konflikt mit einem vorhandenen Datensatz.',
+    'operations.error.backendUnavailable': 'Das Persistenz-Backend ist nicht erreichbar.',
+    'operations.error.unauthorized': 'Die Operation „{operation}“ wurde vom Autorisierungs-Hook abgelehnt.',
+    'operations.error.unknown': 'Es ist ein unbekannter Fehler bei der Operation aufgetreten.',
+    'operations.error.documentSchemaViolation': 'Das Dokument „{collection}:{id}“ verletzt das Schema seiner Sammlung.',
+    'operations.error.strictReferencesBlockDelete': '„{target}“ kann nicht gelöscht werden: {count} Dokumente verweisen über strikte Beziehungsfelder darauf — {named}{more}. Entfernen Sie zuerst diese Verweise.',
+    'operations.error.strictReferencesBlockDeleteOne': '„{target}“ kann nicht gelöscht werden: {count} Dokument verweist über strikte Beziehungsfelder darauf — {named}. Entfernen Sie zuerst diese Verweise.',
+    'operations.error.strictReferencesBlockUnpublish': 'Die Veröffentlichung von „{target}“ kann nicht zurückgenommen werden: {count} Dokumente verweisen über strikte Beziehungsfelder darauf — {named}{more}. Entfernen Sie zuerst diese Verweise.',
+    'operations.error.strictReferencesBlockUnpublishOne': 'Die Veröffentlichung von „{target}“ kann nicht zurückgenommen werden: {count} Dokument verweist über strikte Beziehungsfelder darauf — {named}. Entfernen Sie zuerst diese Verweise.',
+    'operations.errorDetail.andMore': ' und {count} weitere',
+    // EC-494 — Fehler von Inhaltsabfragen (Filterleiste + Listing-Hinweis im Canvas).
+    // „filterable“, „asc“, „desc“, „in“, „empty“ sind Schlüsselwörter aus der Konfiguration
+    // und bleiben wörtlich stehen.
+    'content.queryError.nonFilterableField': 'Das Feld "{field}" in "{collection}" ist nicht als filterable deklariert.',
+    'content.queryError.unknownField': 'Das Feld "{field}" existiert in "{collection}" nicht.',
+    'content.queryError.unknownCollection': 'Die Sammlung "{collection}" ist nicht definiert.',
+    'content.queryError.filterShape': 'Der Filter für "{field}" muss ein Skalar oder ein Operator-Objekt sein.',
+    'content.queryError.filterNoOperators': 'Der Filter für "{field}" enthält keine Operatoren.',
+    'content.queryError.unknownOperator': 'Unbekannter Filteroperator "{operator}" auf "{field}" — das Vokabular ist genau {vocabulary}.',
+    'content.queryError.operatorInRequiresArray': 'Der Operator "in" auf "{field}" erwartet ein Array aus Skalaren.',
+    'content.queryError.operatorRequiresString': 'Der Operator "{operator}" auf "{field}" erwartet einen Zeichenkettenwert.',
+    'content.queryError.operatorEmptyRequiresBoolean': 'Der Operator "empty" auf "{field}" erwartet einen Wahrheitswert (true = ist leer).',
+    'content.queryError.operatorRequiresScalar': 'Der Operator "{operator}" auf "{field}" erwartet einen skalaren Wert.',
+    'content.queryError.sortNotFilterable': 'Das Sortierfeld "{field}" in "{collection}" ist nicht als filterable deklariert.',
+    'content.queryError.sortUnknownField': 'Das Sortierfeld "{field}" existiert in "{collection}" nicht.',
+    'content.queryError.sortDirection': 'Die Sortierrichtung muss "asc" oder "desc" sein.',
+    'content.queryError.limitPositiveInteger': 'Das Limit muss eine positive ganze Zahl sein.',
     // ─────────────────────────────────────────────────────────────────────────
     // CMS — collection list / view bar / filters / cells
     // ─────────────────────────────────────────────────────────────────────────
@@ -280,6 +318,9 @@ export const deMessages = {
     'cms.list.bulk.noSettableFields': 'Keine filterbaren Skalarfelder zum Setzen.',
     'cms.list.bulk.setField': 'Feld setzen',
     'cms.list.bulk.clearSelection': 'Auswahl aufheben',
+    // EC-494 — die beiden studio-seitigen Fehlergründe je Eintrag.
+    'cms.list.bulk.error.notInSession': 'Das Dokument ist nicht mehr in der Sitzung.',
+    'cms.list.bulk.error.notValidToPublish': 'Das Dokument ist nicht gültig zum Veröffentlichen.',
     'cms.list.bulk.set.set': 'Setze',
     'cms.list.bulk.set.to': 'auf',
     'cms.list.bulk.set.valueAria': 'Wert setzen',
@@ -303,6 +344,9 @@ export const deMessages = {
     'cms.filter.fieldAria': 'Filterfeld',
     'cms.filter.operatorAria': 'Filteroperator',
     'cms.filter.remove': 'Filter entfernen',
+    // EC-494 — die beiden studio-seitigen Klausel-Probleme.
+    'cms.filter.issue.stateOperator': 'Status-Filter unterstützen nur "eq" und "in".',
+    'cms.filter.issue.stateValue': 'Der Status muss "draft" oder "published" sein.',
     'cms.filter.valueAria': 'Filterwert',
     'cms.filter.valueListPlaceholder': 'Wert, Wert, …',
     'cms.filter.pickRelation': 'Auswählen…',
@@ -424,6 +468,7 @@ export const deMessages = {
     'cms.issue.reserved-field-name': 'Reservierter Feldname',
     'cms.issue.missing-required-field': 'Pflichtfeld fehlt',
     'cms.issue.invalid-field-value': 'Ungültiger Wert',
+    'cms.issue.invalid-field-value.warning': 'Wert prüfen',
     'cms.issue.unknown-relation-target': 'Fehlende Referenz',
     'cms.issue.unpublished-relation-target': 'Unveröffentlichte Referenz',
     'cms.issue.cardinality-violation': 'Falsche Anzahl von Werten',
@@ -441,6 +486,7 @@ export const deMessages = {
     'cms.issue.unknown-alias': 'Unbekannter Slot',
     'cms.issue.unfilled-slot': 'Leerer Slot',
     'cms.issue.custom-validation': 'Validierungsregel',
+    'cms.issue.unaddressable-url': 'Nicht erreichbare URL',
     'cms.issue.unknown-version': 'Unbekannte Version',
     // EC-443 — issue-card body templates (see messages.en.ts for the fallback contract).
     'cms.issueBody.missing-required-field': 'Das Pflichtfeld „{field}“ ist nicht ausgefüllt.',
@@ -507,6 +553,7 @@ export const deMessages = {
     'cms.issueMessage.duplicateSelectOption': 'Doppelte Auswahloption „{option}“ im Feld „{field}“.',
     'cms.issueMessage.duplicateObjectField': 'Doppeltes Feld „{field}“ im Objektfeld „{parent}“.',
     'cms.issueMessage.assetCollectionSingleton': 'Die Mediensammlung „{collection}“ kann kein Einzelstück sein.',
+    'cms.issueMessage.unknownPresentationBodyField': 'Die Sammlung „{collection}“ deklariert „{field}“ als Inhaltsfeld der Darstellung, definiert dieses Feld aber nicht.',
     'cms.issueMessage.duplicateCollectionField': 'Doppeltes Feld „{field}“ in der Sammlung „{collection}“.',
     'cms.issueMessage.duplicateCollectionId': 'Doppelte Sammlungs-id „{collection}“.',
     'cms.issueMessage.unknownLocale': 'Die Sprache „{locale}“ gehört nicht zum konfigurierten Sprachsatz.',
@@ -520,6 +567,7 @@ export const deMessages = {
     'cms.issueMessage.routeBoundDocumentNotFound': 'Das an die Route gebundene Dokument „{collection}:{id}“ wurde nicht gefunden.',
     'cms.issueMessage.routeParamNotCaptured': 'Die Route „{route}“ bindet ihr Dokument an den URL-Parameter „:{param}“, den das Muster „{pattern}“ nicht erfasst.',
     'cms.issueMessage.collectionNotDefined': 'Die Sammlung „{collection}“ ist nicht definiert.',
+    'cms.issueMessage.unaddressableLocaleCollision': 'Keine URL erreicht „{id}“ in der Sprache „{locale}“: die Adresse wäre „{url}“, aber das erste Segment „{segment}“ ist ein deklarierter Sprachcode — die Website liest diese URL daher als Sprache „{segment}“, Pfad „{readPath}“. Benennen Sie dieses Segment um — an diesem Dokument oder an der übergeordneten Seite, zu der es gehört — damit es nicht mit einem Sprachcode kollidiert.',
     'cms.issueDetail.expectsString': 'erwartet eine Zeichenkette',
     'cms.issueDetail.expectsRichText': 'erwartet Rich-Text-Inhalt (eine Zeichenkette oder einen Rich-Text-Wert)',
     'cms.issueDetail.expectsNumber': 'erwartet eine Zahl',
@@ -541,6 +589,8 @@ export const deMessages = {
     'cms.issueDetail.greaterThanMax': 'ist größer als das Maximum {max}',
     'cms.issueDetail.fewerThanMinItems': 'hat weniger als {min} Einträge',
     'cms.issueDetail.moreThanMaxItems': 'hat mehr als {max} Einträge',
+    'cms.issueDetail.duplicateValue': 'muss innerhalb der Sammlung eindeutig sein, aber das Dokument „{other}“ hat diesen Wert bereits',
+    'cms.issueDetail.duplicateValueForLocale': 'muss innerhalb der Sammlung eindeutig sein, aber das Dokument „{other}“ hat diesen Wert bereits für die Sprache „{locale}“',
     'cms.issueDetail.singleValuedManyTargets': 'ist einwertig, hat aber {count} Ziele',
     'cms.issueDetail.notADocumentReference': 'enthält einen Wert, der keine Dokumentreferenz ist',
     'cms.issueDetail.pointsAtOtherCollection': 'zeigt auf die Sammlung „{got}“, zielt aber auf „{target}“',
@@ -1020,6 +1070,23 @@ export const deMessages = {
     'builder.clipboard.pastedInto': '{summary} · in {destination}',
     'builder.clipboard.issueComponent': 'Komponente',
     'builder.clipboard.issueBinding': 'Bindung',
+    // EC-494 — Zwischenablage-Fehler aus der Engine plus der studio-seitige Einfüge-Diff.
+    'builder.clipboard.error.corruptJson': 'Der Inhalt der Zwischenablage ist kein gültiges JSON: {detail}',
+    'builder.clipboard.error.notEnvelope': 'Der Inhalt der Zwischenablage ist kein Elytra-Fragment-Umschlag.',
+    'builder.clipboard.error.foreignFormat': 'Der Inhalt der Zwischenablage ist kein Elytra-Fragment (erwartetes Format "{expected}").',
+    'builder.clipboard.error.versionNewer': 'Die Fragmentversion {version} ist neuer als von diesem Studio unterstützt (Version {supported}).',
+    'builder.clipboard.error.versionUnsupported': 'Die Fragmentversion {version} wird nicht unterstützt (dieses Studio liest Version {supported}).',
+    'builder.clipboard.error.invalidPayload': 'Das Fragment der Zwischenablage verletzt das Fragment-Schema.',
+    'builder.clipboard.error.nodeNotFound': 'In der Komposition existiert kein Knoten "{nodeId}".',
+    'builder.clipboard.error.fixtureNotFound': 'Die Komponente "{component}" deklariert kein Fixture namens "{fixture}".',
+    'builder.clipboard.issue.unresolvedBinding': 'Die Datenquelle "{sourceId}" ist in diesem Projekt nicht verfügbar.',
+    'builder.clipboard.issue.missingComponent': 'Die Komponente "{componentId}" ist in diesem Projekt nicht registriert.',
+    'builder.clipboard.summary.pasted': 'Eingefügt',
+    'builder.clipboard.summary.pastedWith': 'Eingefügt — {parts}',
+    'builder.clipboard.summary.bindingUnresolvedOne': '{count} Bindung nicht aufgelöst',
+    'builder.clipboard.summary.bindingsUnresolved': '{count} Bindungen nicht aufgelöst',
+    'builder.clipboard.summary.componentMissingOne': '{count} Komponente fehlt',
+    'builder.clipboard.summary.componentsMissing': '{count} Komponenten fehlen',
     'builder.reuse.makeReusable': 'Wiederverwendbar machen',
     'builder.reuse.detachToCopy': 'Als Kopie loslösen',
     'builder.reuse.defaultElementName': 'Wiederverwendbares Element',
@@ -1197,6 +1264,7 @@ export const deMessages = {
     'ai.error.route': 'Der Assistent ist derzeit nicht verfügbar. Bitte versuchen Sie es erneut.',
     'ai.error.generic': 'Etwas ist schiefgelaufen. Bitte versuchen Sie es erneut.',
     'ai.error.applyFailed': 'Der Entwurf konnte nicht übernommen werden.',
+    'ai.error.applyInvalid': 'Der Vorschlag passt nicht mehr zum aktuellen Dokument: {issues}',
     'ai.error.stepCap': 'Der Assistent hat nach {max} Werkzeugschritten angehalten. Senden Sie eine weitere Nachricht, um fortzufahren.',
     // EC-332 — full-document translation (header action + chat tool)
     'ai.translate.action': 'Dokument übersetzen',