@noy-db/hub 0.3.0-pre.7 → 0.3.0-pre.9

package/dist/forget/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SubjectDeclaration, F as ForgetStrategy } from '../subject-index-O75wKshW.js';
-export { a as ForgetResult, N as NO_FORGET, b as SUBJECT_INDEX_COLLECTION, c as SubjectRef } from '../subject-index-O75wKshW.js';
+import { S as SubjectDeclaration, F as ForgetStrategy } from '../subject-index-CyOgGMJL.js';
+export { a as ForgetResult, N as NO_FORGET, b as SUBJECT_INDEX_COLLECTION, c as SubjectRef } from '../subject-index-CyOgGMJL.js';
 
 /**
  * `withForgetCascade` — the active factory for GDPR right-to-erasure via

package/dist/forget/index.js

@@ -1,16 +1,16 @@
 import {
   NO_FORGET,
   SUBJECT_INDEX_COLLECTION
-} from "../chunk-VMRXI3IF.js";
-import "../chunk-JIW3Q5JN.js";
-import "../chunk-HGQ6UNHE.js";
-import "../chunk-5UOPIPZC.js";
-import "../chunk-UWZ7O4NR.js";
-import "../chunk-HCK2DFEK.js";
-import "../chunk-VFQOE76I.js";
+} from "../chunk-A2APWS32.js";
+import "../chunk-XHD3L3JO.js";
+import "../chunk-Z5YFRMG5.js";
+import "../chunk-XQ7UYPVN.js";
+import "../chunk-6MWUANRF.js";
+import "../chunk-2KOSJTMU.js";
 import "../chunk-LP7BEXCT.js";
-import "../chunk-5HZULLHE.js";
-import "../chunk-OJ64XMPJ.js";
+import "../chunk-AUR7MRHA.js";
+import "../chunk-UNJU345Q.js";
+import "../chunk-CU62BBRB.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/with-audit/forget/active.ts

package/dist/guards/index.d.ts

@@ -1,8 +1,7 @@
-export { I as ImmutableGuardConfig, T as TransitionGuardConfig, i as immutableGuard, t as transitionGuard, w as withGuard } from '../transition-guard-BzsAQEd-.js';
-import { bJ as GuardStrategy, bK as GuardChange, bL as GuardContext } from '../index-BJ3L-XcV.js';
-export { bM as AmendmentForbiddenError, bN as FieldFrozenError, bO as GuardRegistry, bP as GuardStrategyHandle, bQ as IllegalTransitionError, bR as InvariantError, bS as ReadOnlyVaultFacade, bT as RecordLockedError } from '../index-BJ3L-XcV.js';
-import '../subject-index-O75wKshW.js';
-import '../describe-C6iHNlqJ.js';
+export { I as ImmutableGuardConfig, T as TransitionGuardConfig, i as immutableGuard, t as transitionGuard, w as withGuard } from '../transition-guard-BOUkzQU4.js';
+import { bc as GuardStrategy, bd as GuardChange, be as GuardContext } from '../index-DzhNI2vE.js';
+export { bf as AmendmentForbiddenError, bg as FieldFrozenError, bh as GuardRegistry, bi as GuardStrategyHandle, bj as IllegalTransitionError, bk as InvariantError, bl as ReadOnlyVaultFacade, bm as RecordLockedError } from '../index-DzhNI2vE.js';
+import '../subject-index-CyOgGMJL.js';
 import '../index-B9QdHytu.js';
 import '@noy-db/attestation';
 

package/dist/guards/index.js

@@ -2,23 +2,23 @@ import {
   immutableGuard,
   transitionGuard,
   withGuard
-} from "../chunk-PAJCRV7O.js";
+} from "../chunk-KYC4LIEU.js";
 import {
   ReadOnlyVaultFacade
-} from "../chunk-RUIMKQTA.js";
+} from "../chunk-QJR3W3MF.js";
 import {
   GuardRegistry
 } from "../chunk-YMUGBZN2.js";
 import {
   GuardExecutor
-} from "../chunk-HU55NPHZ.js";
+} from "../chunk-Y2OCKFZ3.js";
 import {
   AmendmentForbiddenError,
   FieldFrozenError,
   IllegalTransitionError,
   InvariantError,
   RecordLockedError
-} from "../chunk-OJ64XMPJ.js";
+} from "../chunk-CU62BBRB.js";
 import "../chunk-PZ5AY32C.js";
 export {
   AmendmentForbiddenError,

package/dist/{hash-BPzm02Za.d.ts → hash-DBkZfIBW.d.ts}

@@ -1,4 +1,4 @@
-import { cV as EncryptedEnvelope } from './index-BJ3L-XcV.js';
+import { d0 as EncryptedEnvelope } from './index-DzhNI2vE.js';
 
 /**
  * Ledger storage constants — pinned in their own leaf module so

package/dist/history/index.d.ts

@@ -1,8 +1,7 @@
-import { cS as HistoryStrategy, cT as NoydbStore, cU as HistoryOptions, cV as EncryptedEnvelope, cW as PruneOptions } from '../index-BJ3L-XcV.js';
-export { cX as AppendInput, cY as ChangeType, cZ as CollectionInstant, cE as DiffEntry, c_ as JsonPatch, c$ as JsonPatchOp, d0 as LedgerStore, d1 as VaultEngine, d2 as VaultInstant, d3 as VerifyResult, d4 as applyPatch, d5 as computePatch, d6 as diff, d7 as formatDiff } from '../index-BJ3L-XcV.js';
-export { L as LedgerEntry, d as canonicalJson, h as hashEntry, p as paddedIndex, e as parseIndex, s as sha256Hex } from '../subject-index-O75wKshW.js';
-export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-BPzm02Za.js';
-import '../describe-C6iHNlqJ.js';
+import { cZ as HistoryStrategy, c_ as NoydbStore, c$ as HistoryOptions, d0 as EncryptedEnvelope, d1 as PruneOptions } from '../index-DzhNI2vE.js';
+export { d2 as AppendInput, d3 as ChangeType, d4 as CollectionInstant, c7 as DiffEntry, d5 as JsonPatch, d6 as JsonPatchOp, d7 as LedgerStore, d8 as VaultEngine, d9 as VaultInstant, da as VerifyResult, db as applyPatch, dc as computePatch, dd as diff, de as formatDiff } from '../index-DzhNI2vE.js';
+export { L as LedgerEntry, d as canonicalJson, h as hashEntry, p as paddedIndex, e as parseIndex, s as sha256Hex } from '../subject-index-CyOgGMJL.js';
+export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-DBkZfIBW.js';
 import '../index-B9QdHytu.js';
 import '@noy-db/attestation';
 

package/dist/history/index.js

@@ -7,7 +7,7 @@ import {
   pruneHistory,
   saveHistory,
   tombstoneHistory
-} from "../chunk-J54DC5IC.js";
+} from "../chunk-4G3IT7J7.js";
 import {
   diff,
   formatDiff
@@ -16,7 +16,7 @@ import {
   LedgerStore,
   applyPatch,
   computePatch
-} from "../chunk-62TTFKU4.js";
+} from "../chunk-WNA6T3MA.js";
 import {
   LEDGER_COLLECTION,
   LEDGER_DELTAS_COLLECTION
@@ -28,16 +28,16 @@ import {
   paddedIndex,
   parseIndex,
   sha256Hex
-} from "../chunk-G5CFMITA.js";
-import "../chunk-JIW3Q5JN.js";
-import "../chunk-HGQ6UNHE.js";
-import "../chunk-5UOPIPZC.js";
-import "../chunk-UWZ7O4NR.js";
-import "../chunk-HCK2DFEK.js";
-import "../chunk-VFQOE76I.js";
+} from "../chunk-MSVY7ULZ.js";
+import "../chunk-XHD3L3JO.js";
+import "../chunk-Z5YFRMG5.js";
+import "../chunk-XQ7UYPVN.js";
+import "../chunk-6MWUANRF.js";
+import "../chunk-2KOSJTMU.js";
 import "../chunk-LP7BEXCT.js";
-import "../chunk-5HZULLHE.js";
-import "../chunk-OJ64XMPJ.js";
+import "../chunk-AUR7MRHA.js";
+import "../chunk-UNJU345Q.js";
+import "../chunk-CU62BBRB.js";
 import "../chunk-PZ5AY32C.js";
 
 // src/with-commit/history/active.ts

package/dist/i18n/index.d.ts

@@ -1,10 +1,29 @@
-import { I as I18nStrategy } from '../index-BJ3L-XcV.js';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictKeyInUseError, d as DictKeyMissingError, e as DictionaryHandle, f as DictionaryOptions, g as I18nMap, h as I18nTextDescriptor, i as I18nTextOptions, L as Layer, j as LocaleNotSpecifiedError, M as MissingTranslationError, O as OnMissing, k as OnMissingPolicy, R as ReservedCollectionNameError, l as ResolveI18nOptions, S as ScriptViolationError, m as ScriptWarning, n as StaticDictDescriptor, o as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError, p as applyI18nLocale, q as dictCollectionName, r as dictKey, s as enforceScript, t as getAtPath, u as i18nText, v as inferScripts, w as isDictCollectionName, x as isDictKeyDescriptor, y as isI18nTextDescriptor, z as isStaticDictDescriptor, A as resolveI18nText, B as resolvePolicy, C as setAtPathInPlace, E as staticDict, F as stripI18nFilled, G as validateI18nTextValue } from '../index-BJ3L-XcV.js';
-import '../subject-index-O75wKshW.js';
-import '../describe-C6iHNlqJ.js';
+import { ck as I18nStrategy } from '../index-DzhNI2vE.js';
+export { cl as DICT_COLLECTION_PREFIX, cm as DictEntry, cn as DictKeyDescriptor, co as DictKeyInUseError, cp as DictKeyMissingError, cq as DictionaryHandle, cr as DictionaryOptions, cs as I18nMap, ct as I18nTextDescriptor, cu as I18nTextOptions, cv as Layer, cw as LocaleNotSpecifiedError, cx as MissingTranslationError, cy as OnMissing, cz as OnMissingPolicy, cA as ReservedCollectionNameError, cB as ResolveI18nOptions, cC as ScriptViolationError, cD as ScriptWarning, cE as StaticDictDescriptor, cF as StaticDictReadonlyError, cG as TranslatorNotConfiguredError, cH as UnknownDictCodeError, cI as applyI18nLocale, cJ as dictCollectionName, cK as dictKey, cL as enforceScript, cM as i18nText, cN as inferScripts, cO as isDictCollectionName, cP as isDictKeyDescriptor, cQ as isI18nTextDescriptor, cR as isStaticDictDescriptor, cS as presentI18nForJoin, cT as resolveI18nText, cU as resolvePolicy, cV as staticDict, cW as stripI18nFilled, cX as validateI18nTextValue } from '../index-DzhNI2vE.js';
+import '../subject-index-CyOgGMJL.js';
 import '../index-B9QdHytu.js';
 import '@noy-db/attestation';
 
+/**
+ * Generic dotted-path / `[]`-wildcard record helpers. Kernel-owned:
+ * these carry zero i18n logic — they were extracted out of
+ * `shape/via-i18n/core.ts` (Task 7, #623) so kernel call-sites (put-time
+ * validation, densify) can import them without a spine→service edge.
+ *
+ * @internal
+ */
+/**
+ * Return all leaf values at `path`, expanding `[].` array wildcards.
+ *
+ * - `'name'`              → `[obj.name]`
+ * - `'address.lineOne'`   → `[obj.address.lineOne]`
+ * - `'contacts[].title'`  → `[obj.contacts[0].title, obj.contacts[1].title, …]`
+ *
+ * Returns an empty array when the path does not resolve (missing key,
+ * wrong type, etc.). Used by `enforceI18nOnPut` to validate nested fields.
+ */
+declare function getAtPath(obj: Record<string, unknown>, path: string): unknown[];
+
 /**
  * Active i18n strategy — `withI18n()` returns the real implementation
  * that wires multi-locale resolution, i18nText validation, and the
@@ -34,4 +53,4 @@ import '@noy-db/attestation';
 
 declare function withI18n(): I18nStrategy;
 
-export { I18nStrategy, withI18n };
+export { I18nStrategy, getAtPath, withI18n };

package/dist/i18n/index.js

@@ -1,37 +1,39 @@
+import {
+  withLookup
+} from "../chunk-ANDBBA2P.js";
 import {
   DICT_COLLECTION_PREFIX,
-  DictionaryHandle,
+  LookupHandle,
   dictCollectionName,
   dictKey,
-  isDictCollectionName,
-  isDictKeyDescriptor,
-  isStaticDictDescriptor,
   staticDict
-} from "../chunk-WFBZRXS5.js";
-import "../chunk-GMZFHDSG.js";
-import "../chunk-3CHNKEFI.js";
-import "../chunk-G5CFMITA.js";
-import "../chunk-JIW3Q5JN.js";
-import "../chunk-HGQ6UNHE.js";
-import "../chunk-5UOPIPZC.js";
-import "../chunk-UWZ7O4NR.js";
-import "../chunk-HCK2DFEK.js";
-import "../chunk-VFQOE76I.js";
+} from "../chunk-IIP5WFVT.js";
+import "../chunk-MSVY7ULZ.js";
+import "../chunk-XHD3L3JO.js";
+import "../chunk-Z5YFRMG5.js";
+import "../chunk-XQ7UYPVN.js";
+import "../chunk-6MWUANRF.js";
+import "../chunk-2KOSJTMU.js";
 import "../chunk-LP7BEXCT.js";
-import "../chunk-5HZULLHE.js";
+import "../chunk-AUR7MRHA.js";
+import "../chunk-UNJU345Q.js";
 import {
   applyI18nLocale,
   enforceScript,
   getAtPath,
   i18nText,
   inferScripts,
+  isDictCollectionName,
+  isDictKeyDescriptor,
   isI18nTextDescriptor,
+  isStaticDictDescriptor,
+  presentI18nForJoin,
   resolveI18nText,
   resolvePolicy,
-  setAtPathInPlace,
   stripI18nFilled,
   validateI18nTextValue
-} from "../chunk-BASCPHNM.js";
+} from "../chunk-3C5CKXFI.js";
+import "../chunk-6G2SCQYS.js";
 import {
   DictKeyInUseError,
   DictKeyMissingError,
@@ -42,10 +44,10 @@ import {
   StaticDictReadonlyError,
   TranslatorNotConfiguredError,
   UnknownDictCodeError
-} from "../chunk-OJ64XMPJ.js";
+} from "../chunk-CU62BBRB.js";
 import "../chunk-PZ5AY32C.js";
 
-// src/with-shape/i18n/densify.ts
+// src/shape/via-i18n/densify.ts
 var MARKER = "_i18nFilled";
 function priorFilled(prior, field) {
   if (!prior) return /* @__PURE__ */ new Set();
@@ -120,8 +122,9 @@ function densify(record, prior, fields) {
   }
 }
 
-// src/with-shape/i18n/active.ts
+// src/shape/via-i18n/active.ts
 function withI18n() {
+  const lookup = withLookup();
   return {
     applyI18nLocale,
     validateI18nTextValue,
@@ -129,18 +132,26 @@ function withI18n() {
     computeExemptFills,
     densify,
     buildDictionaryHandle(opts) {
-      return new DictionaryHandle(
-        opts.adapter,
-        opts.compartmentName,
-        opts.dictionaryName,
-        opts.keyring,
-        opts.getDEK,
-        opts.encrypted,
-        opts.ledger,
-        opts.options,
-        opts.findAndUpdateReferences,
-        opts.emitter
-      );
+      return lookup.buildLookupHandle({
+        adapter: opts.adapter,
+        compartmentName: opts.compartmentName,
+        dimensionName: opts.dictionaryName,
+        keyring: opts.keyring,
+        reservedEnvelopes: opts.reservedEnvelopes,
+        encrypted: opts.encrypted,
+        ledger: opts.ledger,
+        options: opts.options,
+        findAndUpdateReferences: opts.findAndUpdateReferences,
+        emitter: opts.emitter,
+        buildDeleteMarker: opts.buildDeleteMarker,
+        // #647 fix wave 1
+        onDirty: opts.onDirty,
+        // #650 Task 4
+        onRecordMutated: opts.onRecordMutated,
+        // #650 Task 4
+        checkReferencesOnDelete: opts.checkReferencesOnDelete
+        // #650 Task 5
+      });
     }
   };
 }
@@ -148,7 +159,7 @@ export {
   DICT_COLLECTION_PREFIX,
   DictKeyInUseError,
   DictKeyMissingError,
-  DictionaryHandle,
+  LookupHandle as DictionaryHandle,
   LocaleNotSpecifiedError,
   MissingTranslationError,
   ReservedCollectionNameError,
@@ -167,9 +178,9 @@ export {
   isDictKeyDescriptor,
   isI18nTextDescriptor,
   isStaticDictDescriptor,
+  presentI18nForJoin,
   resolveI18nText,
   resolvePolicy,
-  setAtPathInPlace,
   staticDict,
   stripI18nFilled,
   validateI18nTextValue,

package/dist/i18n/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/with-shape/i18n/densify.ts","../../src/with-shape/i18n/active.ts"],"sourcesContent":["/**\n * `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":[]}
+{"version":3,"sources":["../../src/shape/via-i18n/densify.ts","../../src/shape/via-i18n/active.ts"],"sourcesContent":["/**\n * `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 type { DictionaryHandle } from './dictionary.js'\nimport { withLookup } from '../via-lookup/active.js'\n\nexport function withI18n(): I18nStrategy {\n  // #650 Task 1: the handle-construction logic moved to\n  // shape/via-lookup/active.ts (LookupHandle, renamed from\n  // DictionaryHandle, new home). buildDictionaryHandle below is now a\n  // thin field-name translator over buildLookupHandle — same handle.\n  const lookup = withLookup()\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 lookup.buildLookupHandle<Keys>({\n        adapter: opts.adapter,\n        compartmentName: opts.compartmentName,\n        dimensionName: opts.dictionaryName,\n        keyring: opts.keyring,\n        reservedEnvelopes: opts.reservedEnvelopes,\n        encrypted: opts.encrypted,\n        ledger: opts.ledger,\n        options: opts.options,\n        findAndUpdateReferences: opts.findAndUpdateReferences,\n        emitter: opts.emitter,\n        buildDeleteMarker: opts.buildDeleteMarker, // #647 fix wave 1\n        onDirty: opts.onDirty, // #650 Task 4\n        onRecordMutated: opts.onRecordMutated, // #650 Task 4\n        checkReferencesOnDelete: opts.checkReferencesOnDelete, // #650 Task 5\n      })\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/in/index.d.ts

@@ -1,5 +1,4 @@
-export { eQ as ChangeEvent, ci as Collection, gA as LiveQuery, ha as Noydb, e7 as Query, V as Vault } from '../index-BJ3L-XcV.js';
-import '../subject-index-O75wKshW.js';
-import '../describe-C6iHNlqJ.js';
+export { e_ as ChangeEvent, bN as Collection, gR as LiveQuery, hs as Noydb, ef as Query, V as Vault } from '../index-DzhNI2vE.js';
+import '../subject-index-CyOgGMJL.js';
 import '../index-B9QdHytu.js';
 import '@noy-db/attestation';

package/dist/{index-CLucFLeN.d.ts → index-CyclmyDr.d.ts}

@@ -1,9 +1,8 @@
-import { cT as NoydbStore, dg as SealingKeyProvider, cF as UnlockedKeyring, eP as CargoStrategy } from './index-BJ3L-XcV.js';
+import { c_ as NoydbStore, dn as SealingKeyProvider, c8 as UnlockedKeyring, eZ as CargoStrategy } from './index-DzhNI2vE.js';
 import './ulid-DRH25k3y.js';
 import './index-B9QdHytu.js';
 import './kernel/index.js';
-import './describe-C6iHNlqJ.js';
-import './vault-diff-DmBBatkx.js';
+import './vault-diff-Dt9NkLzw.js';
 
 /**
  * Hub-core constants that must be referenceable without pulling any