@noy-db/hub 0.2.0-pre.27 → 0.2.0-pre.28

package/dist/i18n/index.d.cts

@@ -1,12 +1,12 @@
-export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, v as validateI18nTextValue } from '../strategy-D1zjEV3n.cjs';
-import { I as I18nStrategy } from '../types-CwrTuYFI.cjs';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-CwrTuYFI.cjs';
+export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, h as stripI18nFilled, v as validateI18nTextValue } from '../strategy-DDNvt_UD.cjs';
+import { I as I18nStrategy } from '../types-B_eCkuEI.cjs';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-B_eCkuEI.cjs';
 export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-Dwk2k1xY.cjs';
 import '../lazy-builder-eYZzLEL1.cjs';
 import '../predicate-BmhBSPCH.cjs';
 import '../strategy-BSxFXGzb.cjs';
 import '../index-BMmajblo.cjs';
-import '../index-DoxKSsMj.cjs';
+import '../index-CVnt2Qmq.cjs';
 import '@noy-db/attestation';
 
 /**

package/dist/i18n/index.d.ts

@@ -1,12 +1,12 @@
-export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, v as validateI18nTextValue } from '../strategy-YQ1qJWyq.js';
-import { I as I18nStrategy } from '../types-CkSWJt0H.js';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-CkSWJt0H.js';
+export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, h as stripI18nFilled, v as validateI18nTextValue } from '../strategy-BoITAb2H.js';
+import { I as I18nStrategy } from '../types-84nsWSDF.js';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-84nsWSDF.js';
 export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-Dwk2k1xY.js';
 import '../lazy-builder-ChSqcF5t.js';
 import '../predicate-BmhBSPCH.js';
 import '../strategy-BSxFXGzb.js';
 import '../index-BMmajblo.js';
-import '../index-LaexBi3v.js';
+import '../index-DxBNV54L.js';
 import '@noy-db/attestation';
 
 /**

package/dist/i18n/index.js

@@ -7,7 +7,7 @@ import {
   isDictKeyDescriptor,
   isStaticDictDescriptor,
   staticDict
-} from "../chunk-PFKAT4NT.js";
+} from "../chunk-HQ242WNG.js";
 import {
   applyI18nLocale,
   enforceScript,
@@ -18,11 +18,12 @@ import {
   resolveI18nText,
   resolvePolicy,
   setAtPathInPlace,
+  stripI18nFilled,
   validateI18nTextValue
-} from "../chunk-KD253AI5.js";
-import "../chunk-LXA2E3VI.js";
+} from "../chunk-6LD37AMK.js";
+import "../chunk-VSL3W2MO.js";
 import "../chunk-PDVP3C2I.js";
-import "../chunk-AD6RNBAW.js";
+import "../chunk-QSLIT4JZ.js";
 import "../chunk-7JSP3E67.js";
 import {
   DictKeyInUseError,
@@ -36,12 +37,89 @@ import {
   UnknownDictCodeError
 } from "../chunk-DDOYOMAD.js";
 
+// src/i18n/densify.ts
+var MARKER = "_i18nFilled";
+function priorFilled(prior, field) {
+  if (!prior) return /* @__PURE__ */ new Set();
+  const marker = prior[MARKER];
+  return new Set(marker?.[field] ?? []);
+}
+function singleLeaf(record, field) {
+  const leaves = getAtPath(record, field);
+  if (leaves.length !== 1) return void 0;
+  const leaf = leaves[0];
+  if (!leaf || typeof leaf !== "object" || Array.isArray(leaf)) return void 0;
+  return leaf;
+}
+function computeExemptFills(prior, incoming, fields) {
+  const out = /* @__PURE__ */ new Map();
+  if (!prior) return out;
+  for (const field of Object.keys(fields)) {
+    const filled = priorFilled(prior, field);
+    if (filled.size === 0) continue;
+    const priorLeaf = singleLeaf(prior, field);
+    const incLeaf = singleLeaf(incoming, field);
+    if (!priorLeaf || !incLeaf) continue;
+    const exempt = /* @__PURE__ */ new Set();
+    for (const loc of filled) {
+      if (incLeaf[loc] !== void 0 && incLeaf[loc] !== "" && incLeaf[loc] === priorLeaf[loc]) {
+        exempt.add(loc);
+      }
+    }
+    if (exempt.size > 0) out.set(field, exempt);
+  }
+  return out;
+}
+function densify(record, prior, fields) {
+  let marker = record[MARKER];
+  for (const [field, descriptor] of Object.entries(fields)) {
+    const leaf = singleLeaf(record, field);
+    if (!leaf) continue;
+    const { languages, substitute, smartSubstitute } = descriptor.options;
+    const filledSet = priorFilled(prior, field);
+    const priorLeaf = singleLeaf(prior ?? {}, field);
+    const isUnchangedFill = (loc) => filledSet.has(loc) && priorLeaf?.[loc] !== void 0 && leaf[loc] === priorLeaf[loc];
+    const authored = {};
+    for (const [loc, val] of Object.entries(leaf)) {
+      if (typeof val === "string" && val !== "" && !isUnchangedFill(loc)) authored[loc] = val;
+    }
+    const filled = [];
+    for (const loc of languages) {
+      if (authored[loc] !== void 0) continue;
+      const sub = resolveI18nText(authored, loc, void 0, field, {
+        policy: "substitute",
+        substitute: substitute ?? ["any"],
+        ...smartSubstitute ? { smartSubstitute } : {}
+      });
+      if (typeof sub === "string" && sub !== "") {
+        leaf[loc] = sub;
+        filled.push(loc);
+      } else if (isUnchangedFill(loc)) {
+        delete leaf[loc];
+      }
+    }
+    if (filled.length > 0) {
+      marker ??= {};
+      marker[field] = filled;
+    } else if (marker) {
+      delete marker[field];
+    }
+  }
+  if (marker && Object.keys(marker).length > 0) {
+    record[MARKER] = marker;
+  } else {
+    delete record[MARKER];
+  }
+}
+
 // src/i18n/active.ts
 function withI18n() {
   return {
     applyI18nLocale,
     validateI18nTextValue,
     enforceScript,
+    computeExemptFills,
+    densify,
     buildDictionaryHandle(opts) {
       return new DictionaryHandle(
         opts.adapter,
@@ -85,6 +163,7 @@ export {
   resolvePolicy,
   setAtPathInPlace,
   staticDict,
+  stripI18nFilled,
   validateI18nTextValue,
   withI18n
 };

package/dist/i18n/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/i18n/active.ts"],"sourcesContent":["/**\n * Active i18n strategy — `withI18n()` returns the real implementation\n * that wires multi-locale resolution, i18nText validation, and the\n * `DictionaryHandle` for `dictKey` fields into the core read/write\n * paths.\n *\n * Consumers opt in by:\n *\n * ```ts\n * import { createNoydb } from '@noy-db/hub'\n * import { withI18n } from '@noy-db/hub/i18n'\n *\n * const db = await createNoydb({\n *   store: ...,\n *   user: ...,\n *   i18nStrategy: withI18n(),\n * })\n * ```\n *\n * The factory delegates to the existing `core.ts` and `dictionary.ts`\n * modules. Splitting the import chain through this file is what lets\n * tsup tree-shake the `~854 LOC` of dictionary + locale resolution\n * out of the default bundle when no `withI18n()` import is present.\n *\n * @public\n */\n\nimport type { I18nStrategy, BuildDictionaryHandleOptions } from './strategy.js'\nimport { applyI18nLocale, validateI18nTextValue } from './core.js'\nimport { enforceScript } from './script.js'\nimport { DictionaryHandle } from './dictionary.js'\n\nexport function withI18n(): I18nStrategy {\n  return {\n    applyI18nLocale,\n    validateI18nTextValue,\n    enforceScript,\n    buildDictionaryHandle<Keys extends string = string>(\n      opts: BuildDictionaryHandleOptions<Keys>,\n    ): DictionaryHandle<Keys> {\n      return new DictionaryHandle<Keys>(\n        opts.adapter,\n        opts.compartmentName,\n        opts.dictionaryName,\n        opts.keyring,\n        opts.getDEK,\n        opts.encrypted,\n        opts.ledger,\n        opts.options,\n        opts.findAndUpdateReferences,\n        opts.emitter,\n      )\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCO,SAAS,WAAyB;AACvC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,sBACE,MACwB;AACxB,aAAO,IAAI;AAAA,QACT,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/i18n/densify.ts","../../src/i18n/active.ts"],"sourcesContent":["/**\n * #435 v1.x densifyOnWrite — eager-fill empty i18n slots from each field's\n * substitute chain at write time, recording provenance in the internal\n * `_i18nFilled` marker (decision A: dense map + prior-read).\n *\n * Pure functions over plain records; all DB wiring lives in collection.ts.\n * Only single-leaf i18n fields are supported (array-wildcard paths are\n * skipped, mirroring auto-translate).\n */\nimport { getAtPath, resolveI18nText } from './core.js'\nimport type { I18nTextDescriptor } from './core.js'\n\nconst MARKER = '_i18nFilled'\n\ntype Leaf = Record<string, string>\n\n/** Locales recorded as densify-filled on the prior record for `field`. */\nfunction priorFilled(prior: Record<string, unknown> | undefined, field: string): Set<string> {\n  if (!prior) return new Set()\n  const marker = prior[MARKER] as Record<string, string[]> | undefined\n  return new Set(marker?.[field] ?? [])\n}\n\n/** The single leaf map for `field`, or undefined for absent / array-wildcard / non-object. */\nfunction singleLeaf(record: Record<string, unknown>, field: string): Leaf | undefined {\n  const leaves = getAtPath(record, field)\n  if (leaves.length !== 1) return undefined\n  const leaf = leaves[0]\n  if (!leaf || typeof leaf !== 'object' || Array.isArray(leaf)) return undefined\n  return leaf as Leaf\n}\n\n/**\n * Per field, the locales that are UNCHANGED round-tripped densify fills — i.e.\n * marked filled on the prior record AND identical in the incoming record.\n * These are exempt from write-time script enforcement (they are derived copies,\n * not authored text). Slots the user changed are NOT exempt (validated as authored).\n */\nexport function computeExemptFills(\n  prior: Record<string, unknown> | undefined,\n  incoming: Record<string, unknown>,\n  fields: Record<string, I18nTextDescriptor>,\n): Map<string, Set<string>> {\n  const out = new Map<string, Set<string>>()\n  if (!prior) return out\n  for (const field of Object.keys(fields)) {\n    const filled = priorFilled(prior, field)\n    if (filled.size === 0) continue\n    const priorLeaf = singleLeaf(prior, field)\n    const incLeaf = singleLeaf(incoming, field)\n    if (!priorLeaf || !incLeaf) continue\n    const exempt = new Set<string>()\n    for (const loc of filled) {\n      if (incLeaf[loc] !== undefined && incLeaf[loc] !== '' && incLeaf[loc] === priorLeaf[loc]) {\n        exempt.add(loc)\n      }\n    }\n    if (exempt.size > 0) out.set(field, exempt)\n  }\n  return out\n}\n\n/**\n * Mutate `record` in place: fill empty declared-language slots for each\n * densify-enabled field from the field's substitute chain, recompute unchanged\n * prior fills, clear marks for slots that became authored, and write the\n * resulting `_i18nFilled` marker (removed when empty).\n *\n * `prior` is read-only — it is never mutated.\n *\n * Provenance uses value-equality (decision A): a slot counts as an unchanged\n * fill when it was prior-marked AND its value still equals the prior value. A\n * consequence is that re-authoring a value byte-identical to the existing fill\n * keeps it classified as a fill (the visible value is unchanged either way; the\n * slot stays script-exempt and will auto-refresh if its source later changes).\n * This is inherent to value-equality provenance, not a bug.\n */\nexport function densify(\n  record: Record<string, unknown>,\n  prior: Record<string, unknown> | undefined,\n  fields: Record<string, I18nTextDescriptor>,\n): void {\n  let marker = record[MARKER] as Record<string, string[]> | undefined\n\n  for (const [field, descriptor] of Object.entries(fields)) {\n    const leaf = singleLeaf(record, field)\n    if (!leaf) continue\n    const { languages, substitute, smartSubstitute } = descriptor.options\n    const filledSet = priorFilled(prior, field)\n    const priorLeaf = singleLeaf(prior ?? {}, field)\n    const isUnchangedFill = (loc: string): boolean =>\n      filledSet.has(loc) && priorLeaf?.[loc] !== undefined && leaf[loc] === priorLeaf[loc]\n\n    // Authored source = present, non-empty, NOT an unchanged prior fill.\n    const authored: Leaf = {}\n    for (const [loc, val] of Object.entries(leaf)) {\n      if (typeof val === 'string' && val !== '' && !isUnchangedFill(loc)) authored[loc] = val\n    }\n\n    const filled: string[] = []\n    for (const loc of languages) {\n      if (authored[loc] !== undefined) continue // real value present → not a fill\n      const sub = resolveI18nText(authored, loc, undefined, field, {\n        policy: 'substitute',\n        substitute: substitute ?? ['any'],\n        ...(smartSubstitute ? { smartSubstitute } : {}),\n      })\n      if (typeof sub === 'string' && sub !== '') {\n        leaf[loc] = sub\n        filled.push(loc)\n      } else if (isUnchangedFill(loc)) {\n        delete leaf[loc] // stale fill with no source left → drop it\n      }\n    }\n\n    if (filled.length > 0) {\n      marker ??= {}\n      marker[field] = filled\n    } else if (marker) {\n      delete marker[field]\n    }\n  }\n\n  if (marker && Object.keys(marker).length > 0) {\n    record[MARKER] = marker\n  } else {\n    delete record[MARKER]\n  }\n}\n","/**\n * Active i18n strategy — `withI18n()` returns the real implementation\n * that wires multi-locale resolution, i18nText validation, and the\n * `DictionaryHandle` for `dictKey` fields into the core read/write\n * paths.\n *\n * Consumers opt in by:\n *\n * ```ts\n * import { createNoydb } from '@noy-db/hub'\n * import { withI18n } from '@noy-db/hub/i18n'\n *\n * const db = await createNoydb({\n *   store: ...,\n *   user: ...,\n *   i18nStrategy: withI18n(),\n * })\n * ```\n *\n * The factory delegates to the existing `core.ts` and `dictionary.ts`\n * modules. Splitting the import chain through this file is what lets\n * tsup tree-shake the `~854 LOC` of dictionary + locale resolution\n * out of the default bundle when no `withI18n()` import is present.\n *\n * @public\n */\n\nimport type { I18nStrategy, BuildDictionaryHandleOptions } from './strategy.js'\nimport { applyI18nLocale, validateI18nTextValue } from './core.js'\nimport { enforceScript } from './script.js'\nimport { computeExemptFills, densify } from './densify.js'\nimport { DictionaryHandle } from './dictionary.js'\n\nexport function withI18n(): I18nStrategy {\n  return {\n    applyI18nLocale,\n    validateI18nTextValue,\n    enforceScript,\n    computeExemptFills,\n    densify,\n    buildDictionaryHandle<Keys extends string = string>(\n      opts: BuildDictionaryHandleOptions<Keys>,\n    ): DictionaryHandle<Keys> {\n      return new DictionaryHandle<Keys>(\n        opts.adapter,\n        opts.compartmentName,\n        opts.dictionaryName,\n        opts.keyring,\n        opts.getDEK,\n        opts.encrypted,\n        opts.ledger,\n        opts.options,\n        opts.findAndUpdateReferences,\n        opts.emitter,\n      )\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{index-wRwJVVJQ.d.ts → index-BidHvmWf.d.ts}

@@ -1,9 +1,9 @@
 import './predicate-BmhBSPCH.js';
-import './strategy-YQ1qJWyq.js';
+import './strategy-BoITAb2H.js';
 import './ulid-DRH25k3y.js';
-import './types-CkSWJt0H.js';
+import './types-84nsWSDF.js';
 import './errors-Dwk2k1xY.js';
-import './index-LaexBi3v.js';
+import './index-DxBNV54L.js';
 
 interface EncryptResult {
     iv: string;

package/dist/{index-CqzZml-D.d.cts → index-CP24aYCp.d.cts}

@@ -1,9 +1,9 @@
 import './predicate-BmhBSPCH.cjs';
-import './strategy-D1zjEV3n.cjs';
+import './strategy-DDNvt_UD.cjs';
 import './ulid-DRH25k3y.cjs';
-import './types-CwrTuYFI.cjs';
+import './types-B_eCkuEI.cjs';
 import './errors-Dwk2k1xY.cjs';
-import './index-DoxKSsMj.cjs';
+import './index-CVnt2Qmq.cjs';
 
 interface EncryptResult {
     iv: string;

package/dist/{index-DoxKSsMj.d.cts → index-CVnt2Qmq.d.cts}

@@ -1,6 +1,6 @@
 import { C as CollectionIndexes, a as Clause, O as Operator } from './predicate-BmhBSPCH.cjs';
 import { N as NoydbError } from './errors-Dwk2k1xY.cjs';
-import { a as I18nTextDescriptor, N as MoneyDescriptor, A as AggregateStrategy, j as AggregateSpec, k as Aggregation, h as AggregateResult, o as GroupedQuery, p as GroupedQueryN } from './strategy-D1zjEV3n.cjs';
+import { a as I18nTextDescriptor, P as MoneyDescriptor, A as AggregateStrategy, k as AggregateSpec, l as Aggregation, j as AggregateResult, p as GroupedQuery, q as GroupedQueryN } from './strategy-DDNvt_UD.cjs';
 
 /**
  * Foreign-key references — the soft-FK mechanism.

package/dist/{index-LaexBi3v.d.ts → index-DxBNV54L.d.ts}

@@ -1,6 +1,6 @@
 import { C as CollectionIndexes, a as Clause, O as Operator } from './predicate-BmhBSPCH.js';
 import { N as NoydbError } from './errors-Dwk2k1xY.js';
-import { a as I18nTextDescriptor, N as MoneyDescriptor, A as AggregateStrategy, j as AggregateSpec, k as Aggregation, h as AggregateResult, o as GroupedQuery, p as GroupedQueryN } from './strategy-YQ1qJWyq.js';
+import { a as I18nTextDescriptor, P as MoneyDescriptor, A as AggregateStrategy, k as AggregateSpec, l as Aggregation, j as AggregateResult, p as GroupedQuery, q as GroupedQueryN } from './strategy-BoITAb2H.js';
 
 /**
  * Foreign-key references — the soft-FK mechanism.

package/dist/index.cjs

@@ -7578,13 +7578,14 @@ function stripDisallowed(str, scripts) {
   for (const ch of str) if (ok.test(ch)) out += ch;
   return out;
 }
-function enforceScript(value, field, descriptor) {
+function enforceScript(value, field, descriptor, exempt) {
   const opt = descriptor.options;
   if (!opt.script) return { value, warnings: [] };
   const mode = opt.onScriptViolation ?? "reject";
   const warnings = [];
   let out = value;
   for (const [locale, raw] of Object.entries(value)) {
+    if (exempt?.has(locale)) continue;
     if (typeof raw !== "string") continue;
     const allowed = allowedFor(descriptor, locale);
     if (fullMatcher(allowed).test(raw)) continue;
@@ -7675,8 +7676,18 @@ var init_script = __esm({
 
 // src/i18n/core.ts
 function i18nText(options) {
+  if (options.densifyOnWrite === true && hasThrowPolicy(options.onMissing)) {
+    throw new Error(
+      `i18nText: densifyOnWrite cannot be combined with an explicit onMissing 'throw' policy \u2014 densify fills every empty slot, so a 'throw' would be unreachable. Remove the 'throw' policy or disable densifyOnWrite.`
+    );
+  }
   return { _noydbI18nText: true, options };
 }
+function hasThrowPolicy(onMissing) {
+  if (onMissing === void 0) return false;
+  if (typeof onMissing === "string") return onMissing === "throw";
+  return Object.values(onMissing).includes("throw");
+}
 function isI18nTextDescriptor(x) {
   return typeof x === "object" && x !== null && x._noydbI18nText === true;
 }
@@ -7874,8 +7885,15 @@ function applyI18nLocale(record, i18nFields, locale, fallback, layer = "read") {
     };
     result = applyAtPath(result, field, locale, fallback, opts);
   }
+  result = stripI18nFilled(result);
   return result;
 }
+function stripI18nFilled(record) {
+  if (!Object.prototype.hasOwnProperty.call(record, "_i18nFilled")) return record;
+  const rest = { ...record };
+  delete rest._i18nFilled;
+  return rest;
+}
 var init_core = __esm({
   "src/i18n/core.ts"() {
     "use strict";
@@ -8905,6 +8923,11 @@ var init_strategy2 = __esm({
       enforceScript(value) {
         return { value, warnings: [] };
       },
+      computeExemptFills() {
+        return /* @__PURE__ */ new Map();
+      },
+      densify() {
+      },
       buildDictionaryHandle() {
         throw notEnabled("vault.dictionary()");
       }
@@ -13868,6 +13891,12 @@ var init_collection = __esm({
        * Declared via the `i18nFields` collection option.
        */
       i18nFields;
+      /**
+       * #435 — the densify-enabled subset of {@link i18nFields} (fields whose
+       * descriptor opts in via `densifyOnWrite: true`). `undefined` when none opt
+       * in, so the write path skips all densify work for ordinary collections.
+       */
+      i18nDensifyFields;
       /**
        * Map of field name → `DictKeyDescriptor` for fields declared with
        * `dictKey()`. Used by `get()`/`list()` to add `<field>Label` virtual
@@ -14054,6 +14083,10 @@ var init_collection = __esm({
         this.refEnforcer = opts.refEnforcer;
         this.joinResolver = opts.joinResolver;
         this.i18nFields = opts.i18nFields;
+        const densifyFields = opts.i18nFields ? Object.fromEntries(
+          Object.entries(opts.i18nFields).filter(([, d]) => d.options.densifyOnWrite === true)
+        ) : {};
+        this.i18nDensifyFields = Object.keys(densifyFields).length > 0 ? densifyFields : void 0;
         this.dictKeyFields = opts.dictKeyFields;
         if (opts.moneyFields) validateMoneyFieldPaths(opts.moneyFields);
         this.moneyFields = opts.moneyFields;
@@ -14373,6 +14406,32 @@ var init_collection = __esm({
           if (busAfterPut) await this.subsystemBus.dispatch("afterPut", event);
         }
       }
+      /**
+       * #435 — resolve the prior stored record (with its `_i18nFilled` marker) for
+       * densify. Eager: in-memory cache; lazy: LRU then adapter. undefined if absent.
+       */
+      async resolveDensifyPrior(id) {
+        if (this.lazy && this.lru) {
+          const cached = this.lru.get(id);
+          if (cached) return cached.record;
+          const env = await this.adapter.get(this.vault, this.name, id);
+          if (!env) return void 0;
+          const rec = await this.decryptRecord(env);
+          return rec === null ? void 0 : rec;
+        }
+        await this.ensureHydrated();
+        return this.cache.get(id)?.record;
+      }
+      /**
+       * #435 — densify provenance for a record: which i18n slots were auto-filled,
+       * e.g. `{ name: ['en'] }`. undefined when nothing was filled. The marker is
+       * stripped from ordinary reads; this is the sanctioned audit accessor.
+       */
+      async i18nProvenance(id) {
+        const prior = await this.resolveDensifyPrior(id);
+        const marker = prior?.["_i18nFilled"];
+        return marker && Object.keys(marker).length > 0 ? marker : void 0;
+      }
       /**
        * Validate a record against this collection's schema WITHOUT writing it.
        * Returns the (possibly coerced) record on success; throws
@@ -14487,6 +14546,16 @@ var init_collection = __esm({
             setAtPathInPlace(obj, field, translated);
           }
         }
+        let densifyPrior;
+        let exemptFills;
+        if (this.i18nDensifyFields) {
+          densifyPrior = await this.resolveDensifyPrior(id);
+          exemptFills = this.i18nStrategy.computeExemptFills(
+            densifyPrior,
+            record,
+            this.i18nDensifyFields
+          );
+        }
         if (this.i18nFields) {
           const obj = record;
           for (const [field, descriptor] of Object.entries(this.i18nFields)) {
@@ -14494,18 +14563,38 @@ var init_collection = __esm({
             for (const leaf of getAtPath(obj, field)) {
               if (!leaf || typeof leaf !== "object" || Array.isArray(leaf)) continue;
               const leafMap = leaf;
-              const { value: cleaned } = this.i18nStrategy.enforceScript(
+              const { value: cleaned, warnings } = this.i18nStrategy.enforceScript(
                 leafMap,
                 field,
-                descriptor
+                descriptor,
+                exemptFills?.get(field)
               );
               if (cleaned !== leafMap) Object.assign(leafMap, cleaned);
+              const mode = descriptor.options.onScriptViolation;
+              if (mode === "warn" || mode === "filter") {
+                for (const w of warnings) {
+                  this.emitter.emit("i18n:script-violation", {
+                    vault: this.vault,
+                    collection: this.name,
+                    id,
+                    mode,
+                    warning: w
+                  });
+                }
+              }
             }
           }
         }
         if (this.i18nPutValidator !== void 0) {
           this.i18nPutValidator(record);
         }
+        if (this.i18nDensifyFields) {
+          this.i18nStrategy.densify(
+            record,
+            densifyPrior,
+            this.i18nDensifyFields
+          );
+        }
         if (this.refEnforcer !== void 0) {
           await this.refEnforcer.enforceRefsOnPut(this.name, record);
         }
@@ -15359,7 +15448,7 @@ var init_collection = __esm({
         }
         await this.ensureHydrated();
         const entries = [];
-        for (const [id, e] of this.cache) entries.push({ id, record: e.record });
+        for (const [id, e] of this.cache) entries.push({ id, record: stripI18nFilled(e.record) });
         return searchScan(entries, field, query, opts);
       }
       // ─── Bulk operations ─────────────────────────────────────
@@ -16273,7 +16362,7 @@ var init_collection = __esm({
         const hasStaticDisplay = hasDict && this.dictKeyFields !== void 0 && Object.values(this.dictKeyFields).some(
           (d) => isStaticDictDescriptor(d) && d.displayLocale !== void 0
         );
-        if (!locale && !hasStaticDisplay) return result;
+        if (!locale && !hasStaticDisplay) return stripI18nFilled(result);
         const layer = localeOpts?._layer ?? "read";
         if (locale && hasI18n && this.i18nFields) {
           result = this.i18nStrategy.applyI18nLocale(result, this.i18nFields, locale, localeOpts?.fallback, layer);
@@ -16340,7 +16429,7 @@ var init_collection = __esm({
           }
           result = withLabels;
         }
-        return result;
+        return stripI18nFilled(result);
       }
       /**
        * Low-level: encrypt a pre-serialised JSON string into an EncryptedEnvelope.