footprintjs 9.48.2 → 10.0.0

package/dist/types/lib/memory/index.d.ts

@@ -1,26 +1,11 @@
-/**
- * memory/ — Foundation library (zero external deps)
- *
- * Transactional state management with namespace isolation,
- * atomic commits, and event-sourced time-travel.
- */
+/** Engine frame, diagnostics, run policy and redaction. Record primitives belong to foottrace. */
+export type { RetentionPolicy } from '../capture/policies.js';
+export type { ReadSummaryMarker, WriteSummaryMarker } from '../capture/summarize.js';
 export { DiagnosticCollector } from './DiagnosticCollector.js';
-export { EventLog } from './EventLog.js';
-export { SharedMemory } from './SharedMemory.js';
-export { StageContext } from './StageContext.js';
-export { TransactionBuffer } from './TransactionBuffer.js';
+export type { FlowControlType, FlowMessage, ReadTrackingMode, StageSnapshot, WriteTrackingMode } from './frameTypes.js';
 export type { RedactionVerdict } from './redaction.js';
 export { RedactionRule } from './redaction.js';
-export { redactPatch } from './scrub.js';
+export { SCOPE_PLACEHOLDER } from './redaction.js';
 export type { RunDials, RunPolicy } from './runPolicy.js';
 export { DEFAULT_RUN_POLICY, runPolicy } from './runPolicy.js';
-export type { HonestyCode } from './honesty.js';
-export { HONESTY_CODES } from './honesty.js';
-export { LOG_PLACEHOLDER } from './placeholders.js';
-export { SCOPE_PLACEHOLDER } from './redaction.js';
-export type { RetentionPolicy } from '../capture/policies.js';
-export type { ReadSummaryMarker, WriteSummaryMarker } from '../capture/summarize.js';
-export type { FlowControlType, FlowMessage, ReadTrackingMode, StageSnapshot, WriteTrackingMode } from './frameTypes.js';
-export type { CommitBundle, CommitValuesMode, MemoryPatch, TraceEntry, UntrackedSource } from './types.js';
-export { UnknownVerbError } from './verbs.js';
-export { applySmartMerge, deepSmartMerge, DELIM, getNestedValue, getRunAndGlobalPaths, normalisePath, pathSegments, setNestedValue, updateNestedValue, updateValue, } from './utils.js';
+export { StageContext } from './StageContext.js';

package/dist/types/lib/memory/redaction.d.ts

@@ -57,9 +57,9 @@
  * `'[REDACTED]'` ({@link SCOPE_PLACEHOLDER}, below — the verdict's own).
  * Neither string changed in 9.19.0 or since; each is spelled once in `src/`.
  */
+import type { WriteScrub, WriteVerb } from 'foottrace/write';
 import type { StructuredErrorInfo } from '../errors/errorInfo.js';
 import type { RedactionMarks } from '../pause/types.js';
-import type { WriteScrub, WriteVerb } from './RecordFrame.js';
 /**
  * What the SCOPE CHANNEL carries where a value was scrubbed: a scope recorder's read, write and
  * commit events, the `stageReads` / `stageWrites` retention, the narrative, a decision's evidence, an

package/dist/types/lib/memory/runPolicy.d.ts

@@ -29,9 +29,10 @@
  * rule's marks. The mirror STORE is not policy — each runtime (a subflow has its own) keeps
  * its own store when `mirror` is set.
  */
+import type { CommitValuesMode } from 'foottrace';
+import type { WriteProvenanceMode } from 'foottrace/write';
 import type { ReadTrackingMode, WriteTrackingMode } from './frameTypes.js';
 import type { RedactionRule } from './redaction.js';
-import type { CommitValuesMode, WriteProvenanceMode } from './types.js';
 /**
  * The four observability dials as an executor takes them — every field optional, an absent
  * one is its default. `FlowChartExecutorOptions` extends this interface.
@@ -102,7 +103,7 @@ export interface RunDials {
      *
      * Consumers that read `bundle.overwrite[key]` as "the full value written"
      * must switch to `commitValueAt(commitLog, idx, key)` from
-     * `footprintjs/trace` — under `'delta'` that value is verb-qualified (an
+     * `foottrace` — under `'delta'` that value is verb-qualified (an
      * `append` bundle holds only the tail). Path-tier consumers
      * (`findLastWriter`, `causalChain`, narrative, lens highlights) are
      * unaffected. The active mode is surfaced as

package/dist/types/lib/recorder/ControlDepRecorder.d.ts

@@ -40,7 +40,8 @@
  *
  * @example
  * ```typescript
- * import { controlDepRecorder, causalChain } from 'footprintjs/trace';
+ * import { controlDepRecorder } from 'footprintjs/trace';
+import { causalChain } from 'foottrace';
  *
  * const ctrl = controlDepRecorder();
  * executor.attachCombinedRecorder(ctrl); // auto-routes to FlowRecorder channel
@@ -52,9 +53,9 @@
  * });
  * ```
  */
+import type { ControlDependency, ControlDepLookup } from 'foottrace';
 import type { DecisionEvidence, SelectionEvidence } from '../decide/types.js';
 import type { FlowDecisionEvent, FlowErrorEvent, FlowRecorder, FlowSelectedEvent, FlowStageEvent } from '../engine/narrative/types.js';
-import type { ControlDependency, ControlDepLookup } from '../memory/backtrack.js';
 /** One recorded decision/selection event (RFC-003 D5). */
 export interface ControlDecisionRecord {
     /** runtimeStageId of the decider/selector execution step. */

package/dist/types/lib/recorder/EmitRecorder.d.ts

@@ -58,7 +58,7 @@
  * executor.attachEmitRecorder(tokenMeter);
  * ```
  */
-import type { EmitSourcePosition } from '../memory/eventPosition.js';
+import type { EmitSourcePosition } from 'foottrace';
 import type { RecorderBundle } from './snapshot.js';
 /**
  * Event delivered to `EmitRecorder.onEmit`.

package/dist/types/lib/recorder/qualityTrace.d.ts

@@ -13,7 +13,7 @@
  * Root cause: quality dropped at call-llm#5 (0.8 → 0.3, Δ0.5)
  * ```
  */
-import type { CommitBundle } from '../memory/types.js';
+import type { CommitBundle } from 'foottrace';
 import type { QualityEntry } from './QualityRecorder.js';
 /** Minimal per-step quality lookup — satisfied by `QualityRecorder` (structural, decoupled). */
 export interface QualityLookup {

package/dist/types/lib/runner/ExecutionRuntime.d.ts

@@ -9,13 +9,12 @@
  * The engine (FlowchartTraverser) receives this as its runtime parameter.
  * After execution, consumers query it for the full execution state.
  */
-import { EventLog } from '../memory/EventLog.js';
-import type { LogAddress } from '../memory/eventPosition.js';
+import type { CommitBundle, CommitValuesMode, LogAddress } from 'foottrace';
+import type { WriteProvenanceMode } from 'foottrace/write';
+import { EventLog, SharedMemory } from 'foottrace/write';
 import type { StageSnapshot } from '../memory/frameTypes.js';
 import type { RunPolicy } from '../memory/runPolicy.js';
-import { SharedMemory } from '../memory/SharedMemory.js';
 import { StageContext } from '../memory/StageContext.js';
-import type { CommitBundle, CommitValuesMode, WriteProvenanceMode } from '../memory/types.js';
 import type { ObserverStats } from './DeferredObserverTier.js';
 /** Snapshot of a single recorder's collected data. */
 export interface RecorderSnapshot {
@@ -67,7 +66,7 @@ export type RuntimeSnapshot = {
      * Commit bundles are DIFFS, so the log alone cannot rebuild a value that
      * was seeded before the run and only ever merged afterwards. Shipping the
      * base WITH the log is what makes an offline fold — `stateAt(snapshot, i)`
-     * from `footprintjs/trace` — reproduce the state a stage actually saw.
+     * from `foottrace` — reproduce the state a stage actually saw.
      *
      * OPTIONAL BY TYPE, and absent in exactly two cases. A plain `getSnapshot()`
      * always carries it, so a live fold reports `basis: 'initial+log'`. Under

package/dist/types/lib/runner/FlowChartExecutor.d.ts

@@ -21,6 +21,7 @@
  * stays here is the per-run state and the run lifecycle that threads it.
  *   const result = await executor.run({ input: data, env: { traceId: 'req-123' } });
  */
+import type { CommitValuesMode } from 'foottrace';
 import type { FlowChart } from '../builder/types.js';
 import type { CombinedNarrativeRecorderOptions } from '../engine/narrative/CombinedNarrativeRecorder.js';
 import type { CombinedNarrativeEntry } from '../engine/narrative/narrativeTypes.js';
@@ -28,7 +29,6 @@ import type { ManifestEntry } from '../engine/narrative/recorders/ManifestFlowRe
 import type { FlowRecorder } from '../engine/narrative/types.js';
 import { type ExecutorResult, type RunOptions, type ScopeFactory, type SerializedPipelineStructure, type StageNode, type SubflowResult } from '../engine/types.js';
 import type { ReadTrackingMode, WriteTrackingMode } from '../memory/frameTypes.js';
-import type { CommitValuesMode } from '../memory/types.js';
 import type { FlowchartCheckpoint } from '../pause/types.js';
 import type { CombinedRecorder } from '../recorder/CombinedRecorder.js';
 import type { EmitRecorder } from '../recorder/EmitRecorder.js';

package/dist/types/lib/runner/getSubtreeSnapshot.d.ts

@@ -45,7 +45,7 @@ export interface SubtreeSnapshot {
      * The subflow's OWN fold base — the state its isolated runtime started from,
      * before its first commit (`treeContext.initialState`). Pair it with
      * `history` to fold the subflow's state at any of its commits:
-     * `stateAt(subtree, i)` from `footprintjs/trace` reads exactly these two
+     * `stateAt(subtree, i)` from `foottrace` reads exactly these two
      * fields. Normally `{}` — a subflow's `inputMapper` seed is its first
      * COMMIT, not a pre-run base.
      */

package/dist/types/recorders.d.ts

@@ -25,7 +25,7 @@
  */
 import type { CombinedNarrativeRecorderOptions } from './lib/engine/narrative/CombinedNarrativeRecorder.js';
 import { CombinedNarrativeRecorder } from './lib/engine/narrative/CombinedNarrativeRecorder.js';
-import type { BreakRenderContext, DecisionRenderContext, EmitRenderContext, ErrorRenderContext, ForkRenderContext, LoopRenderContext, NarrativeFormatter, NarrativeRenderer, OpRenderContext, SelectedRenderContext, StageRenderContext, SubflowRenderContext } from './lib/engine/narrative/narrativeTypes.js';
+import type { BreakRenderContext, DecisionRenderContext, EmitRenderContext, ErrorRenderContext, ForkRenderContext, LoopRenderContext, NarrativeFormatter, OpRenderContext, SelectedRenderContext, StageRenderContext, SubflowRenderContext } from './lib/engine/narrative/narrativeTypes.js';
 import { AdaptiveNarrativeFlowRecorder } from './lib/engine/narrative/recorders/AdaptiveNarrativeFlowRecorder.js';
 import type { ManifestEntry } from './lib/engine/narrative/recorders/ManifestFlowRecorder.js';
 import { ManifestFlowRecorder } from './lib/engine/narrative/recorders/ManifestFlowRecorder.js';
@@ -36,7 +36,6 @@ import type { DebugEntry, DebugRecorderOptions } from './lib/scope/recorders/Deb
 import { DebugRecorder } from './lib/scope/recorders/DebugRecorder.js';
 import type { AggregatedMetrics, MetricRecorderOptions, StageMetrics } from './lib/scope/recorders/MetricRecorder.js';
 import { MetricRecorder } from './lib/scope/recorders/MetricRecorder.js';
-export type { EmitSourcePosition, LogAddress } from './lib/memory/eventPosition.js';
 /**
  * ScopeRecorder factory for combined flow+data narrative.
  *
@@ -67,7 +66,7 @@ export declare function manifest(): ManifestInstance;
 export declare function adaptive(): AdaptiveNarrativeFlowRecorder;
 export declare function milestone(): MilestoneNarrativeFlowRecorder;
 export declare function windowed(maxEntries?: number): WindowedNarrativeFlowRecorder;
-export type { BreakRenderContext, CombinedNarrativeRecorderOptions, DecisionRenderContext, EmitEvent, EmitRecorder, EmitRenderContext, ErrorRenderContext, ForkRenderContext, LoopRenderContext, NarrativeFormatter, NarrativeRenderer, OpRenderContext, SelectedRenderContext, StageRenderContext, SubflowRenderContext, };
+export type { BreakRenderContext, CombinedNarrativeRecorderOptions, DecisionRenderContext, EmitEvent, EmitRecorder, EmitRenderContext, ErrorRenderContext, ForkRenderContext, LoopRenderContext, NarrativeFormatter, OpRenderContext, SelectedRenderContext, StageRenderContext, SubflowRenderContext, };
 export type { AggregatedMetrics, MetricRecorderOptions, StageMetrics };
 export type { CompositeSnapshot } from './lib/recorder/index.js';
 export { CompositeRecorder } from './lib/recorder/index.js';

package/dist/types/trace.d.ts

@@ -1,69 +1,23 @@
 /**
- * footprintjs/trace — Execution tracing, debugging, and backtracking utilities.
+ * footprintjs/trace — recorder stores, topology, chart boundaries and control dependencies.
  *
- * Runtime stage IDs, commit log queries, and recorder base classes.
- *
- * @example
- * ```typescript
- * import { parseRuntimeStageId, findLastWriter, KeyedStore, SequenceStore } from 'footprintjs/trace';
- *
- * // Parse a runtimeStageId
- * const { stageId, executionIndex } = parseRuntimeStageId('call-llm#5');
- *
- * // Backtrack: who wrote 'systemPrompt' before commit at idx 8?
- * const writer = findLastWriter(commitLog, 'systemPrompt', 8);
- *
- * // v5 primary API: compose a Store as a field (one purpose per recorder).
- * // KeyedStore<T> — 1:1 (one entry per step)
- * class MyRecorder {
- *   readonly id = 'my-recorder';
- *   private store = new KeyedStore<MyEntry>();
- *   onWrite(e) { this.store.set(e.runtimeStageId, { ... }); }
- * }
- *
- * // SequenceStore<T> — 1:N (multiple entries per step, ordering matters)
- * class AuditRecorder {
- *   readonly id = 'audit';
- *   private store = new SequenceStore<AuditEntry>();
- *   onRead(e) { this.store.push({ runtimeStageId: e.runtimeStageId, ... }); }
- * }
- * ```
+ * Record readers, types and runtime-ID grammar belong to `foottrace`; record path helpers belong
+ * to `foottrace/paths`, and record writers to `foottrace/write`. This door exports only engine-owned
+ * observer tools. Record symbols are never re-exported across the package boundary.
  */
-export type { CommitIdx, ExecutionCounter, ExecutionIndex, RuntimeStageId } from './lib/ids/runtimeStageId.js';
-export { buildRuntimeStageId, createExecutionCounter, parseRuntimeStageId, splitStageId, } from './lib/ids/runtimeStageId.js';
-export { BRANCH_SEGMENT_MARKER, buildBranchSegment, hasBranchSegmentMarker, isBranchSegment, parseBranchSegment, } from './lib/ids/branchSegment.js';
 export type { WalkerItem, WalkerOptions } from './lib/engine/walkSubflowSpec.js';
 export { walkSubflowSpec } from './lib/engine/walkSubflowSpec.js';
-export { pathSegments } from './lib/memory/paths.js';
-export { UnknownVerbError } from './lib/memory/verbs.js';
-export type { CommitBundle, MemoryPatch, TraceEntry } from './lib/memory/types.js';
-export type { ExecutionTree } from './lib/memory/types.js';
-export { applySmartMerge } from './lib/memory/verbs.js';
-export type { ValueBasis, ValueBasisOptions, ValueWithBasis, WriterBasis, WriterWithBasis, } from './lib/memory/commitLogUtils.js';
-export { buildCommitIndex, commitIndexOf, commitValueAt, commitValueAtWithBasis, findCommit, findCommits, findLastWriter, findLastWriterWithBasis, inferLegacyPhases, recordsPhases, } from './lib/memory/commitLogUtils.js';
-export type { CommitPhase } from './lib/memory/types.js';
-export type { AxisRefusal, AxisSplit, BookendedAxis, FoldBasis, FoldedState, FoldSource, LogGap, Mark, Move, MoveRefusal, Stop, StopFilter, StopKind, TimeTravel, TimeTravelOptions, TimeTravelSource, TimeTravelStrategy, } from './lib/time-travel/index.js';
-export { commitStops, commitStopsStrategy, filterStops, isCommitBundle, splitAxis, stateAt, tagStops, timeTravel, } from './lib/time-travel/index.js';
-export type { CausalChainOptions, CausalEdge, CausalNode, ControlDependency, ControlDepLookup, EdgeWeigher, KeysReadLookup, } from './lib/memory/backtrack.js';
-export { causalChain, flattenCausalDAG, formatCausalChain } from './lib/memory/backtrack.js';
-export type { UntrackedSource } from './lib/memory/types.js';
-export type { ArrayProvenance, AttributionBasis, ElementBirth, FedBasis, ForwardEdge, ForwardNode, ForwardRead, ForwardSlice, ForwardSliceJSON, HonestyNote, HonestyNoteCode, KeyMoment, KeysReadSource, KeyTimeline, MissingProvenanceReason, MissingSliceReason, ReadsCoverage, SliceJSON, StateKey, VariableSlice, } from './lib/slice/index.js';
-export type { ForwardSliceForKeyOptions, KeyTimelineOptions, SliceForKeyOptions } from './lib/slice/index.js';
-export { arrayProvenance, elementProvenance, formatForwardSlice, formatSlice, formatTimeline, forwardSliceForKey, forwardSliceToJSON, keysReadFromExecutionTree, keysReadFromMap, keyTimeline, normaliseStateKey, resolveKeysReadSource, sliceForKey, sliceToJSON, } from './lib/slice/index.js';
-export type { HonestyCode } from './lib/memory/honesty.js';
-export { HONESTY_CODES } from './lib/memory/honesty.js';
+export { BRANCH_SEGMENT_MARKER, buildBranchSegment, hasBranchSegmentMarker, isBranchSegment, parseBranchSegment, } from './lib/ids/branchSegment.js';
 export { BoundaryStateStore } from './lib/recorder/BoundaryStateStore.js';
-export { KeyedStore } from './lib/recorder/KeyedStore.js';
-export { SequenceStore } from './lib/recorder/SequenceStore.js';
-export type { RangeEntry, RangeToken } from './lib/recorder/CommitRangeIndex.js';
-export { CommitRangeIndex } from './lib/recorder/CommitRangeIndex.js';
-export type { Topology, TopologyEdge, TopologyIncomingKind, TopologyNode, TopologyRecorderOptions, } from './lib/recorder/TopologyRecorder.js';
-export { TopologyRecorder, topologyRecorder } from './lib/recorder/TopologyRecorder.js';
-export type { InOutEntry, InOutPhase, InOutRecorderOptions } from './lib/recorder/InOutRecorder.js';
-export { InOutRecorder, inOutRecorder, ROOT_RUNTIME_STAGE_ID, ROOT_SUBFLOW_ID } from './lib/recorder/InOutRecorder.js';
 export type { ControlDecisionRecord, ControlDepRecorderOptions } from './lib/recorder/ControlDepRecorder.js';
 export { ControlDepRecorder, controlDepRecorder } from './lib/recorder/ControlDepRecorder.js';
+export type { InOutEntry, InOutPhase, InOutRecorderOptions } from './lib/recorder/InOutRecorder.js';
+export { InOutRecorder, inOutRecorder, ROOT_RUNTIME_STAGE_ID, ROOT_SUBFLOW_ID } from './lib/recorder/InOutRecorder.js';
+export { KeyedStore } from './lib/recorder/KeyedStore.js';
 export type { QualityEntry, QualityRecorderOptions, QualityScoringFn } from './lib/recorder/QualityRecorder.js';
 export { QualityRecorder } from './lib/recorder/QualityRecorder.js';
 export type { QualityFrame, QualityStackTrace } from './lib/recorder/qualityTrace.js';
 export { formatQualityTrace, qualityTrace } from './lib/recorder/qualityTrace.js';
+export { SequenceStore } from './lib/recorder/SequenceStore.js';
+export type { Topology, TopologyEdge, TopologyIncomingKind, TopologyNode, TopologyRecorderOptions, } from './lib/recorder/TopologyRecorder.js';
+export { TopologyRecorder, topologyRecorder } from './lib/recorder/TopologyRecorder.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "footprintjs",
-  "version": "9.48.2",
+  "version": "10.0.0",
   "description": "Explainable backend flows — automatic causal traces, decision evidence, and MCP tool generation for AI agents",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",
@@ -52,7 +52,7 @@
     "check:dup-types": "node scripts/check-dup-types.mjs",
     "check:layering": "node scripts/check-layering.mjs",
     "check:record-tests": "node scripts/record-tests.mjs --check",
-    "check:trace-ready": "node scripts/trace-ready.mjs --check-e1",
+    "check:trace-ready": "node scripts/trace-ready.mjs --check-extracted",
     "trace:ready": "node scripts/trace-ready.mjs",
     "check:doc-snippets": "node scripts/check-doc-snippets.mjs",
     "audit:family": "node scripts/audit-family-versions.mjs",
@@ -127,16 +127,6 @@
         "default": "./dist/trace.js"
       }
     },
-    "./write": {
-      "import": {
-        "types": "./dist/esm/write.d.ts",
-        "default": "./dist/esm/write.js"
-      },
-      "require": {
-        "types": "./dist/types/write.d.ts",
-        "default": "./dist/write.js"
-      }
-    },
     "./detach": {
       "import": {
         "types": "./dist/esm/detach.d.ts",
@@ -170,9 +160,6 @@
       "trace": [
         "./dist/types/trace.d.ts"
       ],
-      "write": [
-        "./dist/types/write.d.ts"
-      ],
       "detach": [
         "./dist/types/detach.d.ts"
       ],
@@ -188,6 +175,9 @@
     ]
   },
   "sideEffects": false,
+  "dependencies": {
+    "foottrace": "^1.0.0"
+  },
   "peerDependencies": {
     "zod": "^3.0.0 || ^4.0.0"
   },
@@ -219,6 +209,7 @@
     "markdown-it": "^14.3.1",
     "prettier": "^2.8.1",
     "publint": "^0.3.0",
+    "semver": "^7.8.5",
     "typedoc": "^0.28.17",
     "typescript": "~5.4.5",
     "vitest": "^4.0.18",

package/dist/esm/lib/capture/freeze.d.ts

@@ -1,91 +0,0 @@
-/**
- * freeze.ts — the ONE deep-freeze walk (moved here from `scope/protection/readonlyInput.ts` in F3),
- * and the serve-time law for the commit log (9.44.2).
- *
- * WHY HERE. Saved trees freeze through this walk: the fold base served as
- * `initialState` (`ExecutionRuntime · getFoldBase`), the
- * dev-mode snapshot (`runner/snapshot.ts · servedSnapshot`), every state `stateAt` hands out
- * (`time-travel/stateAt.ts`) and, since F3, every commit bundle (`EventLog · record`). `memory/` must
- * not import `scope/` (that edge closed the memory ⇄ scope ⇄ recorder module cycle F0 removed), so the
- * walk lives in this leaf folder, which imports nothing outside itself. Args use an ownership snapshot
- * instead (`scope/protection/readonlyInput.ts · createFrozenArgs`): never freeze borrowed caller values.
- *
- * FREEZE WHAT CAN BE FROZEN, COPY WHAT CAN'T (9.44.2). `Object.freeze` cannot seal a Date's time, a
- * Map's or Set's entries, a buffer's bytes, a RegExp (`compile()` rewrites a frozen one) or an Error
- * (V8's own `stack` accessor writes through a frozen one). A fresh tree handed to one caller (a `stateAt`
- * state, the dev-mode snapshot) is that caller's own, so freezing it is a guard and nothing more. The
- * COMMIT LOG — each bundle, and the fold base — is served to every reader, so {@link freezeRecord}
- * remembers that a record holds such a value, its first serve maps the containers on the way to each
- * one (its open PATHS), and {@link serveRecord} hands a reader a copy of those paths only: a fresh copy
- * of each such value, fresh frozen containers on the way to it, and every other part shared, frozen, as
- * it is. Until 9.44.2 `snapshot.commitLog[i].overwrite.when.setTime(0)` rewrote every later snapshot,
- * `stateAt`, `commitValueAt`, slice and cursor answer.
- *
- * Every walk here is ITERATIVE (an explicit stack): a record's depth is not bounded by the call stack.
- *
- * @example
- * ```typescript
- * import { deepFreeze, freezeRecord, serveRecord } from './freeze.js';
- *
- * const args = deepFreeze({ order: { lines: [{ sku: 'A' }] }, bytes: new Uint8Array([1]) });
- * Object.isFrozen(args.order.lines[0]); // true
- * Object.isFrozen(args.bytes); // false — a typed array cannot be frozen; it is skipped
- *
- * const record = freezeRecord({ when: new Date(0), tags: ['a'] });
- * const served = serveRecord(record);
- * served.when.setTime(5); // changes the reader's copy
- * serveRecord(record).when.getTime(); // 0 — every serve is the record as recorded
- * served.tags === record.tags; // true — the sealed part is shared, not copied
- * serveRecord(freezeRecord({ n: 1 })); // a record freezing sealed whole: served as itself
- * ```
- */
-/**
- * How {@link deepFreeze} walks an ARRAY.
- *
- * - `'every-key'` (the default) — every own property, as for any other object: the index elements
- *   AND any expando (`arr.note = { … }`). The dev-mode snapshot relies on this contract.
- * - `'indices'` — the index elements only, so no key string is allocated per element; this is what
- *   keeps freezing a 10,000-element commit inside its budget (`bench/element-writes.ts`). An object
- *   hung on an array EXPANDO is then left unfrozen, and unseen by {@link serveRecord} — the commit
- *   log's named hole (`EventLog · record`; an array expando is out of contract for state).
- */
-export type ArrayWalk = 'every-key' | 'indices';
-/**
- * Freezes `obj` and every object reachable through its own properties, and returns `obj`.
- *
- * - An object that is ALREADY frozen is left as it is, and not descended — 9.32.0's contract, kept:
- *   args may hold a caller's frozen object with live parts inside (a class instance a stage calls),
- *   and freezing past it would break them. It is also what ends a cycle. The commit log never meets
- *   one: its payloads are fresh `structuredClone`s.
- * - ArrayBuffer views (typed arrays, `DataView`) are skipped: `Object.freeze` throws on a non-empty
- *   typed array, so a `Uint8Array` in state, args or the fold base used to fail the run or the
- *   snapshot here.
- * - What `Object.freeze` cannot reach stays mutable — Map and Set contents, a Date's time, the
- *   bytes behind a buffer. A frozen RegExp's `lastIndex` is read-only, so a `/g` or `/y` regex
- *   taken from a frozen tree throws when `exec` or `replace` advance it. The commit log goes through
- *   {@link freezeRecord} and {@link serveRecord} instead.
- * - Functions are not descended (they are not values the engine stores).
- */
-export declare function deepFreeze<T>(obj: T, arrays?: ArrayWalk): T;
-/**
- * {@link deepFreeze} for a record many readers are SERVED (a commit bundle, the fold base), and two more
- * things on the same walk:
- *
- *   - it remembers THAT the record holds a value freezing cannot seal — one flag; the record's first
- *     serve maps WHERE (the containers on the way to each such value, its open paths), so the run pays
- *     nothing more and {@link serveRecord} copies those paths and nothing else;
- *   - a typed array or `DataView` that views a SLICE of a bigger buffer (a Node `Buffer` views its
- *     shared pool) is replaced, in the record, by a copy of the bytes it views — the record keeps the
- *     view's bytes, never the rest of the buffer (a resizable or shared buffer is kept as it is).
- *
- * A part frozen before is not frozen past (deepFreeze's contract) but is looked through, so a value
- * freezing cannot seal inside it still opens the record. Returns `record`.
- */
-export declare function freezeRecord<T extends object>(record: T, arrays?: ArrayWalk): T;
-/**
- * The record as a reader may hold it — THE serve-time law: a record freezing sealed whole is served as
- * itself (shared, no cost); any other as a copy of its open paths ({@link freezeRecord}): fresh frozen
- * containers down to each value freezing cannot seal, a fresh copy of that value, and every other part
- * shared, frozen, as it is. A copy is served the same way again.
- */
-export declare function serveRecord<T>(record: T): T;