@logixjs/core 0.0.1

package/dist/chunk-PYOE4VSI.js

@@ -0,0 +1,1924 @@
+import {
+  ReplayLog,
+  getAtPath,
+  parseListItemFieldPath,
+  setAtPathMutating,
+  toListItemValuePath
+} from "./chunk-BABLDP24.js";
+import {
+  Snapshot,
+  internal,
+  keyHash
+} from "./chunk-NZJKFF45.js";
+import {
+  forceSourceRefresh,
+  inSyncTransactionFiber
+} from "./chunk-ZFLHVFUC.js";
+import {
+  compareFieldPath,
+  getFieldPathId,
+  makeFieldPathIdRegistry,
+  normalizeFieldPath
+} from "./chunk-IHVBV5C2.js";
+import {
+  getBoundInternals
+} from "./chunk-3RMKLXHX.js";
+import {
+  ReplayModeConfigTag,
+  isDevEnv
+} from "./chunk-3QMIVH35.js";
+import {
+  record
+} from "./chunk-DMBALCE2.js";
+import {
+  fnv1a32,
+  stableStringify
+} from "./chunk-GMPEOUP2.js";
+import {
+  RunSessionTag,
+  make,
+  run
+} from "./chunk-OFADUJWJ.js";
+import {
+  EffectOpMiddlewareTag
+} from "./chunk-JWOYLO27.js";
+
+// src/internal/state-trait/build.ts
+import * as SchemaAST from "effect/SchemaAST";
+
+// src/internal/state-trait/meta.ts
+var uniqSortedStrings = (input) => {
+  const set = /* @__PURE__ */ new Set();
+  for (const item of input) {
+    const v = item.trim();
+    if (!v) continue;
+    set.add(v);
+  }
+  return Array.from(set).sort((a, b) => a.localeCompare(b));
+};
+var isPlainRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var sanitizeJsonValue = (input, depth) => {
+  if (input === null) return null;
+  if (typeof input === "string") return input;
+  if (typeof input === "boolean") return input;
+  if (typeof input === "number") {
+    return Number.isFinite(input) ? input : void 0;
+  }
+  if (depth >= 6) return void 0;
+  if (Array.isArray(input)) {
+    const out = [];
+    for (const item of input) {
+      const v = sanitizeJsonValue(item, depth + 1);
+      if (v !== void 0) out.push(v);
+    }
+    return out;
+  }
+  if (isPlainRecord(input)) {
+    const keys = Object.keys(input).sort();
+    const out = {};
+    for (const key of keys) {
+      const v = sanitizeJsonValue(input[key], depth + 1);
+      if (v !== void 0) out[key] = v;
+    }
+    return out;
+  }
+  return void 0;
+};
+var sanitize = (input) => {
+  if (input === null || input === void 0) return void 0;
+  if (typeof input !== "object" || Array.isArray(input)) return void 0;
+  const record2 = input;
+  const out = {};
+  const pickString = (key) => {
+    const value = record2[key];
+    if (typeof value !== "string") return;
+    const trimmed = value.trim();
+    if (!trimmed) return;
+    out[key] = trimmed;
+  };
+  pickString("label");
+  pickString("description");
+  pickString("group");
+  pickString("docsUrl");
+  pickString("cacheGroup");
+  const canonical = record2.canonical;
+  if (typeof canonical === "boolean") {
+    out.canonical = canonical;
+  }
+  const tagsRaw = record2.tags;
+  if (typeof tagsRaw === "string") {
+    const tags = uniqSortedStrings([tagsRaw]);
+    if (tags.length > 0) out.tags = tags;
+  } else if (Array.isArray(tagsRaw)) {
+    const tags = uniqSortedStrings(tagsRaw.filter((x) => typeof x === "string"));
+    if (tags.length > 0) out.tags = tags;
+  }
+  const annotations = {};
+  const annotationKeys = Object.keys(record2).filter((k) => k.startsWith("x-")).sort((a, b) => a.localeCompare(b));
+  for (const key of annotationKeys) {
+    const v = sanitizeJsonValue(record2[key], 0);
+    if (v !== void 0) annotations[key] = v;
+  }
+  const annotationsRaw = record2.annotations;
+  if (isPlainRecord(annotationsRaw)) {
+    const keys = Object.keys(annotationsRaw).filter((k) => k.startsWith("x-")).sort((a, b) => a.localeCompare(b));
+    for (const key of keys) {
+      const v = sanitizeJsonValue(annotationsRaw[key], 0);
+      if (v !== void 0) annotations[key] = v;
+    }
+  }
+  if (Object.keys(annotations).length > 0) out.annotations = annotations;
+  return Object.keys(out).length > 0 ? out : void 0;
+};
+var stableStringify2 = (meta) => {
+  const out = {};
+  const keys = Object.keys(meta).sort();
+  for (const k of keys) {
+    out[k] = meta[k];
+  }
+  return JSON.stringify(out);
+};
+var equals = (a, b) => {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return stableStringify2(a) === stableStringify2(b);
+};
+var mergeCanonical = (current, incoming) => {
+  const existing = current.meta;
+  if (!existing) {
+    return {
+      meta: incoming.meta,
+      origin: incoming.origin,
+      conflicts: current.conflicts
+    };
+  }
+  if (equals(existing, incoming.meta)) {
+    return current;
+  }
+  const conflicts = [...current.conflicts ?? []];
+  const push = (conflict) => {
+    const exists = conflicts.some((c) => c.origin === conflict.origin && equals(c.meta, conflict.meta));
+    if (!exists) conflicts.push(conflict);
+  };
+  const existingCanonical = existing.canonical === true;
+  const incomingCanonical = incoming.meta.canonical === true;
+  if (!existingCanonical && incomingCanonical) {
+    push({
+      origin: current.origin ?? "unknown",
+      meta: existing
+    });
+    return {
+      meta: incoming.meta,
+      origin: incoming.origin,
+      conflicts
+    };
+  }
+  push({
+    origin: incoming.origin,
+    meta: incoming.meta
+  });
+  return {
+    meta: existing,
+    origin: current.origin ?? incoming.origin,
+    conflicts
+  };
+};
+
+// src/internal/state-trait/model.ts
+var normalizeSpec = (spec) => {
+  const entries = [];
+  const isNode = (value) => typeof value === "object" && value !== null && value._tag === "StateTraitNode";
+  const isList = (value) => typeof value === "object" && value !== null && value._tag === "StateTraitList";
+  const joinPath = (prefix, suffix) => {
+    if (!prefix) return suffix;
+    if (!suffix) return prefix;
+    return `${prefix}.${suffix}`;
+  };
+  const prefixDeps = (deps, prefix) => {
+    if (!deps || deps.length === 0) return [];
+    return deps.map((d) => prefix ? joinPath(prefix, d) : d);
+  };
+  const normalizeEntry = (entry, fieldPath, depPrefix) => {
+    if (entry.kind === "computed") {
+      const meta = entry.meta;
+      const rawDeps = meta.deps;
+      const deps = rawDeps !== void 0 ? prefixDeps(rawDeps, depPrefix) : void 0;
+      return {
+        ...entry,
+        fieldPath,
+        meta: { ...meta, deps }
+      };
+    }
+    if (entry.kind === "source") {
+      const meta = entry.meta;
+      const rawDeps = meta.deps;
+      const deps = rawDeps !== void 0 ? prefixDeps(rawDeps, depPrefix) : void 0;
+      return {
+        ...entry,
+        fieldPath,
+        meta: { ...meta, deps, _fieldPath: fieldPath }
+      };
+    }
+    if (entry.kind === "link") {
+      const meta = entry.meta;
+      const from = prefixDeps([meta.from], depPrefix)[0] ?? meta.from;
+      return {
+        ...entry,
+        fieldPath,
+        meta: { ...meta, from }
+      };
+    }
+    return {
+      ...entry,
+      fieldPath
+    };
+  };
+  const expandNode = (scopeId, joinPrefix, node, options) => {
+    const addEntry = (relativeTarget, raw) => {
+      const rel = raw.fieldPath ?? relativeTarget;
+      const fieldPath = joinPrefix ? joinPath(joinPrefix, String(rel)) : String(rel);
+      entries.push(normalizeEntry(raw, fieldPath, joinPrefix));
+    };
+    const expandMaybeRecord = (value) => {
+      if (!value) return;
+      if (typeof value.kind === "string") {
+        addEntry("", value);
+        return;
+      }
+      const record2 = value;
+      for (const key in record2) {
+        if (!Object.prototype.hasOwnProperty.call(record2, key)) continue;
+        const entry = record2[key];
+        if (!entry) continue;
+        addEntry(key, entry);
+      }
+    };
+    expandMaybeRecord(node.computed);
+    expandMaybeRecord(node.source);
+    expandMaybeRecord(node.link);
+    if (node.check) {
+      const rules = {};
+      const checkDepsPrefix = options?.checkDepsPrefix ?? (joinPrefix.endsWith("[]") ? joinPrefix : "");
+      const prefixCheckDeps = (deps) => {
+        if (!deps || deps.length === 0) return [];
+        return deps.map((d) => d === "" ? scopeId : checkDepsPrefix ? joinPath(checkDepsPrefix, d) : d);
+      };
+      for (const name of Object.keys(node.check)) {
+        const rule = node.check[name];
+        if (typeof rule === "function") {
+          rules[name] = rule;
+          continue;
+        }
+        if (rule && typeof rule === "object") {
+          const meta = sanitize(rule.meta);
+          rules[name] = {
+            ...rule,
+            deps: prefixCheckDeps(rule.deps),
+            meta
+          };
+          continue;
+        }
+      }
+      entries.push({
+        fieldPath: scopeId,
+        kind: "check",
+        meta: {
+          rules,
+          writeback: { kind: "errors" }
+        }
+      });
+    }
+  };
+  for (const key in spec) {
+    if (!Object.prototype.hasOwnProperty.call(spec, key)) continue;
+    const raw = spec[key];
+    if (!raw) continue;
+    if (isList(raw)) {
+      const listPath = key;
+      if (raw.item) {
+        expandNode(`${listPath}[]`, `${listPath}[]`, raw.item);
+      }
+      if (raw.list) {
+        expandNode(listPath, listPath, raw.list, {
+          checkDepsPrefix: `${listPath}[]`
+        });
+      }
+      continue;
+    }
+    if (isNode(raw)) {
+      if (key === "$root") {
+        expandNode("$root", "", raw);
+      } else {
+        expandNode(key, key, raw);
+      }
+      continue;
+    }
+    const entry = raw;
+    const fieldPath = entry.fieldPath ?? key;
+    entries.push(normalizeEntry(entry, String(fieldPath), ""));
+  }
+  return entries;
+};
+var collectNodeMeta = (spec) => {
+  const out = /* @__PURE__ */ new Map();
+  const isNode = (value) => typeof value === "object" && value !== null && value._tag === "StateTraitNode";
+  const isList = (value) => typeof value === "object" && value !== null && value._tag === "StateTraitList";
+  const add = (scopeId, node) => {
+    const meta = sanitize(node.meta);
+    if (meta) out.set(scopeId, meta);
+  };
+  for (const key in spec) {
+    if (!Object.prototype.hasOwnProperty.call(spec, key)) continue;
+    const raw = spec[key];
+    if (!raw) continue;
+    if (isList(raw)) {
+      const listPath = key;
+      if (raw.item) add(`${listPath}[]`, raw.item);
+      if (raw.list) add(listPath, raw.list);
+      continue;
+    }
+    if (isNode(raw)) {
+      if (key === "$root") add("$root", raw);
+      else add(key, raw);
+      continue;
+    }
+  }
+  return out;
+};
+
+// src/internal/state-trait/build.ts
+var nowPerf = () => typeof globalThis.performance !== "undefined" && typeof globalThis.performance.now === "function" ? globalThis.performance.now() : Date.now();
+var getConvergeWriterDeps = (entry) => {
+  if (entry.kind === "computed") {
+    return entry.meta?.deps ?? [];
+  }
+  return [entry.meta.from];
+};
+var computeConvergeTopoOrder = (writers) => {
+  const writerByPath = /* @__PURE__ */ new Map();
+  for (const entry of writers) {
+    const existing = writerByPath.get(entry.fieldPath);
+    if (existing) {
+      return {
+        order: [],
+        configError: {
+          code: "MULTIPLE_WRITERS",
+          message: `[StateTrait.converge] Multiple writers for field "${entry.fieldPath}" (${existing.kind} + ${entry.kind}).`,
+          fields: [entry.fieldPath]
+        }
+      };
+    }
+    writerByPath.set(entry.fieldPath, entry);
+  }
+  const nodes = /* @__PURE__ */ new Set();
+  for (const entry of writers) {
+    nodes.add(entry.fieldPath);
+  }
+  const indegree = /* @__PURE__ */ new Map();
+  const forward = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    indegree.set(node, 0);
+    forward.set(node, []);
+  }
+  for (const entry of writers) {
+    const to = entry.fieldPath;
+    const deps = getConvergeWriterDeps(entry);
+    for (const dep of deps) {
+      if (!nodes.has(dep)) continue;
+      forward.get(dep).push(to);
+      indegree.set(to, (indegree.get(to) ?? 0) + 1);
+    }
+  }
+  const queue = [];
+  for (const [node, deg] of indegree.entries()) {
+    if (deg === 0) queue.push(node);
+  }
+  const order = [];
+  while (queue.length) {
+    const n = queue.shift();
+    order.push(n);
+    const outs = forward.get(n);
+    for (const to of outs) {
+      const next = (indegree.get(to) ?? 0) - 1;
+      indegree.set(to, next);
+      if (next === 0) queue.push(to);
+    }
+  }
+  if (order.length !== nodes.size) {
+    const remaining = Array.from(nodes).filter((n) => !order.includes(n));
+    return {
+      order: [],
+      configError: {
+        code: "CYCLE_DETECTED",
+        message: `[StateTrait.converge] Cycle detected in computed/link graph: ${remaining.join(", ")}`,
+        fields: remaining
+      }
+    };
+  }
+  return { order };
+};
+var collectSchemaFieldPaths = (schema) => {
+  const byKey = /* @__PURE__ */ new Map();
+  const add = (path) => {
+    const normalized = normalizeFieldPath(path);
+    if (!normalized) return;
+    byKey.set(JSON.stringify(normalized), normalized);
+  };
+  const visit = (ast, prefix, seen) => {
+    let current = ast;
+    while (true) {
+      if (SchemaAST.isSuspend(current)) {
+        if (seen.has(current)) return;
+        seen.add(current);
+        current = current.f();
+        continue;
+      }
+      if (SchemaAST.isRefinement(current)) {
+        current = current.from;
+        continue;
+      }
+      break;
+    }
+    if (SchemaAST.isTransformation(current)) {
+      visit(current.to, prefix, seen);
+      visit(current.from, prefix, seen);
+      return;
+    }
+    if (SchemaAST.isUnion(current)) {
+      for (const t of current.types) {
+        visit(t, prefix, seen);
+      }
+      return;
+    }
+    if (SchemaAST.isTupleType(current)) {
+      for (const e of current.elements) {
+        visit(e.type, prefix, seen);
+      }
+      for (const r of current.rest) {
+        visit(r.type, prefix, seen);
+      }
+      return;
+    }
+    if (SchemaAST.isTypeLiteral(current)) {
+      for (const ps of current.propertySignatures) {
+        const seg = String(ps.name);
+        if (!seg) continue;
+        const next = [...prefix, seg];
+        add(next);
+        visit(ps.type, next, seen);
+      }
+      return;
+    }
+  };
+  visit(schema.ast, [], /* @__PURE__ */ new Set());
+  return Array.from(byKey.values()).sort(compareFieldPath);
+};
+var buildConvergeIr = (stateSchema, entries) => {
+  const startedAt = nowPerf();
+  const generation = 0;
+  const writers = entries.filter((e) => e.kind === "computed" || e.kind === "link");
+  const writersKey = writers.map((entry) => `${entry.kind}:${entry.fieldPath}`).sort().join("|");
+  const depsKey = writers.map((entry) => {
+    const deps = getConvergeWriterDeps(entry).slice().sort().join(",");
+    const scheduling = entry.meta?.scheduling === "deferred" ? "d" : "i";
+    return `${entry.kind}:${entry.fieldPath}@${scheduling}=>${deps}`;
+  }).sort().join("|");
+  const writerByPath = /* @__PURE__ */ new Map();
+  for (const entry of writers) {
+    writerByPath.set(entry.fieldPath, entry);
+  }
+  const topo = writers.length > 0 ? computeConvergeTopoOrder(writers) : { order: [] };
+  const stepsById = topo.configError ? [] : topo.order.map((path) => writerByPath.get(path));
+  const fieldPathTable = /* @__PURE__ */ new Map();
+  const addPath = (path) => {
+    for (let i = 1; i <= path.length; i++) {
+      const prefix = path.slice(0, i);
+      const key = JSON.stringify(prefix);
+      if (!fieldPathTable.has(key)) fieldPathTable.set(key, prefix);
+    }
+  };
+  for (const schemaPath of collectSchemaFieldPaths(stateSchema)) {
+    addPath(schemaPath);
+  }
+  for (const entry of writers) {
+    const out = normalizeFieldPath(entry.fieldPath);
+    if (out) addPath(out);
+    for (const dep of getConvergeWriterDeps(entry)) {
+      const depPath = normalizeFieldPath(dep);
+      if (depPath) addPath(depPath);
+    }
+  }
+  const fieldPaths = Array.from(fieldPathTable.values()).sort(compareFieldPath);
+  const fieldPathIdRegistry = makeFieldPathIdRegistry(fieldPaths);
+  const fieldPathsKey = fnv1a32(stableStringify(fieldPaths));
+  const stepOutFieldPathIdByStepId = [];
+  const stepDepsFieldPathIdsByStepId = [];
+  const stepSchedulingByStepId = [];
+  for (const entry of stepsById) {
+    const out = normalizeFieldPath(entry.fieldPath);
+    const outId = out != null ? getFieldPathId(fieldPathIdRegistry, out) : void 0;
+    if (outId == null) {
+      throw new Error(`[StateTrait.build] Failed to map converge output fieldPath "${entry.fieldPath}" to FieldPathId.`);
+    }
+    const depIds = [];
+    for (const dep of getConvergeWriterDeps(entry)) {
+      const depPath = normalizeFieldPath(dep);
+      if (!depPath) continue;
+      const depId = getFieldPathId(fieldPathIdRegistry, depPath);
+      if (depId != null) depIds.push(depId);
+    }
+    stepOutFieldPathIdByStepId.push(outId);
+    stepDepsFieldPathIdsByStepId.push(depIds);
+    stepSchedulingByStepId.push(entry.meta?.scheduling === "deferred" ? "deferred" : "immediate");
+  }
+  const topoOrder = stepsById.map((_, i) => i);
+  const buildDurationMs = Math.max(0, nowPerf() - startedAt);
+  return {
+    generation,
+    writersKey,
+    depsKey,
+    fieldPathsKey,
+    fieldPaths,
+    fieldPathIdRegistry,
+    ...topo.configError ? { configError: topo.configError } : null,
+    stepsById,
+    stepOutFieldPathIdByStepId,
+    stepDepsFieldPathIdsByStepId,
+    stepSchedulingByStepId,
+    topoOrder,
+    buildDurationMs
+  };
+};
+var toFieldTrait = (entry) => {
+  const deps = [];
+  if (entry.kind === "computed") {
+    const meta = entry.meta;
+    const list = meta.deps;
+    if (list) deps.push(...list);
+  } else if (entry.kind === "source") {
+    const meta = entry.meta;
+    const list = meta.deps;
+    if (list) deps.push(...list);
+  } else if (entry.kind === "link") {
+    deps.push(entry.meta.from);
+  } else if (entry.kind === "check") {
+    const meta = entry.meta;
+    const rules = meta?.rules ?? {};
+    for (const name of Object.keys(rules)) {
+      const rule = rules[name];
+      if (rule && typeof rule === "object") {
+        const list = rule.deps;
+        if (list) deps.push(...list);
+      }
+    }
+  }
+  return {
+    fieldId: entry.fieldPath,
+    kind: entry.kind,
+    // Keep meta identical to Entry.meta at runtime so install can reuse it directly.
+    meta: entry.meta,
+    deps
+  };
+};
+var buildGraph = (entries, nodeMetaByFieldPath) => {
+  const fieldMap = /* @__PURE__ */ new Map();
+  const nodes = [];
+  const edges = [];
+  const resourcesById = /* @__PURE__ */ new Map();
+  const planSteps = [];
+  const ensureField = (fieldPath) => {
+    let field = fieldMap.get(fieldPath);
+    if (!field) {
+      field = {
+        id: fieldPath,
+        path: fieldPath,
+        traits: []
+      };
+      fieldMap.set(fieldPath, field);
+    }
+    return field;
+  };
+  for (const entry of entries) {
+    const fieldPath = entry.fieldPath;
+    const field = ensureField(fieldPath);
+    const trait = toFieldTrait(entry);
+    field.traits.push(trait);
+    if (entry.kind === "computed") {
+      const stepId = `computed:${fieldPath}`;
+      planSteps.push({
+        id: stepId,
+        kind: "computed-update",
+        targetFieldPath: fieldPath
+        // Note: the current version does not statically analyze computed dependencies; sourceFieldPaths remains empty.
+      });
+      const deps = entry.meta.deps;
+      if (deps) {
+        for (const dep of deps) {
+          ensureField(dep);
+          edges.push({
+            id: `computed:${dep}->${fieldPath}`,
+            from: dep,
+            to: fieldPath,
+            kind: "computed"
+          });
+        }
+      }
+    } else if (entry.kind === "link") {
+      const from = entry.meta.from;
+      ensureField(from);
+      const edgeId = `link:${from}->${fieldPath}`;
+      edges.push({
+        id: edgeId,
+        from,
+        to: fieldPath,
+        kind: "link"
+      });
+      planSteps.push({
+        id: `link:${fieldPath}`,
+        kind: "link-propagate",
+        targetFieldPath: fieldPath,
+        sourceFieldPaths: [from],
+        debugInfo: {
+          graphEdgeId: edgeId
+        }
+      });
+    } else if (entry.kind === "source") {
+      const resourceId = entry.meta.resource;
+      const resourceMeta = sanitize(entry.meta.meta);
+      const existing = resourcesById.get(resourceId);
+      if (existing) {
+        const ownerFields = [...existing.ownerFields, fieldPath];
+        let meta = existing.meta;
+        let metaOrigin = existing.metaOrigin;
+        let metaConflicts = existing.metaConflicts;
+        if (resourceMeta) {
+          const merged = mergeCanonical(
+            { meta, origin: metaOrigin, conflicts: metaConflicts },
+            { origin: fieldPath, meta: resourceMeta }
+          );
+          meta = merged.meta;
+          metaOrigin = merged.origin;
+          metaConflicts = merged.conflicts;
+        }
+        resourcesById.set(resourceId, {
+          ...existing,
+          ownerFields,
+          meta,
+          metaOrigin,
+          metaConflicts
+        });
+      } else {
+        resourcesById.set(resourceId, {
+          resourceId,
+          // Use a simple identifier string for now; may evolve into a structured form based on key rules.
+          keySelector: `StateTrait.source@${fieldPath}`,
+          ownerFields: [fieldPath],
+          meta: resourceMeta,
+          metaOrigin: resourceMeta ? fieldPath : void 0
+        });
+      }
+      planSteps.push({
+        id: `source:${fieldPath}`,
+        kind: "source-refresh",
+        targetFieldPath: fieldPath,
+        resourceId,
+        keySelectorId: `StateTrait.source@${fieldPath}`
+      });
+      const deps = entry.meta.deps;
+      if (deps) {
+        for (const dep of deps) {
+          ensureField(dep);
+          edges.push({
+            id: `source-dep:${dep}->${fieldPath}`,
+            from: dep,
+            to: fieldPath,
+            kind: "source-dep"
+          });
+        }
+      }
+    } else if (entry.kind === "check") {
+      planSteps.push({
+        id: `check:${fieldPath}`,
+        kind: "check-validate",
+        targetFieldPath: fieldPath
+      });
+      if (trait.deps.length > 0) {
+        for (const dep of trait.deps) {
+          ensureField(dep);
+          edges.push({
+            id: `check-dep:${dep}->${fieldPath}`,
+            from: dep,
+            to: fieldPath,
+            kind: "check-dep"
+          });
+        }
+      }
+    }
+  }
+  for (const field of fieldMap.values()) {
+    nodes.push({
+      id: field.id,
+      field,
+      traits: field.traits,
+      meta: nodeMetaByFieldPath.get(field.id)
+    });
+  }
+  const graph = {
+    _tag: "StateTraitGraph",
+    nodes,
+    edges,
+    resources: Array.from(resourcesById.values())
+  };
+  const plan = {
+    _tag: "StateTraitPlan",
+    steps: planSteps
+  };
+  return { graph, plan };
+};
+var assertNoLinkCycles = (edges) => {
+  const adjacency = /* @__PURE__ */ new Map();
+  for (const edge of edges) {
+    if (edge.kind !== "link") continue;
+    const list = adjacency.get(edge.from) ?? [];
+    list.push(edge.to);
+    adjacency.set(edge.from, list);
+  }
+  const visited = /* @__PURE__ */ new Set();
+  const stack = /* @__PURE__ */ new Set();
+  const dfs = (node) => {
+    if (stack.has(node)) {
+      throw new Error(
+        `[StateTrait.build] link cycle detected at field "${node}". Please check link traits for circular dependencies.`
+      );
+    }
+    if (visited.has(node)) return;
+    visited.add(node);
+    stack.add(node);
+    const nexts = adjacency.get(node);
+    if (nexts) {
+      for (const to of nexts) {
+        dfs(to);
+      }
+    }
+    stack.delete(node);
+  };
+  for (const node of adjacency.keys()) {
+    if (!visited.has(node)) {
+      dfs(node);
+    }
+  }
+};
+var collectSchemaPaths = (entries) => {
+  const byKey = /* @__PURE__ */ new Map();
+  const add = (ref) => {
+    if (!ref.path) return;
+    const k = `${ref.kind}|${ref.entryKind}|${ref.entryFieldPath}|${ref.ruleName ?? ""}|${ref.path}`;
+    byKey.set(k, ref);
+  };
+  const getCheckWritebackPath = (entry) => {
+    const wb = entry.meta?.writeback;
+    const p = wb && typeof wb === "object" ? wb.path : void 0;
+    const writebackPath = typeof p === "string" && p.startsWith("errors.") ? p : void 0;
+    if (writebackPath) return writebackPath;
+    const fieldPath = entry.fieldPath;
+    if (fieldPath.endsWith("[]")) {
+      return `errors.${fieldPath.slice(0, -2)}`;
+    }
+    return `errors.${fieldPath}`;
+  };
+  for (const entry of entries) {
+    add({
+      kind: "fieldPath",
+      entryKind: entry.kind,
+      entryFieldPath: entry.fieldPath,
+      path: entry.fieldPath
+    });
+    if (entry.kind === "computed" || entry.kind === "source") {
+      const deps = entry.meta?.deps ?? [];
+      for (const dep of deps) {
+        add({
+          kind: "dep",
+          entryKind: entry.kind,
+          entryFieldPath: entry.fieldPath,
+          path: dep
+        });
+      }
+    }
+    if (entry.kind === "link") {
+      add({
+        kind: "link_from",
+        entryKind: "link",
+        entryFieldPath: entry.fieldPath,
+        path: entry.meta.from
+      });
+    }
+    if (entry.kind === "check") {
+      add({
+        kind: "check_writeback",
+        entryKind: "check",
+        entryFieldPath: entry.fieldPath,
+        path: getCheckWritebackPath(entry)
+      });
+      const rules = entry.meta?.rules ?? {};
+      for (const name of Object.keys(rules)) {
+        const rule = rules[name];
+        if (!rule || typeof rule !== "object") continue;
+        const deps = rule.deps ?? [];
+        for (const dep of deps) {
+          add({
+            kind: "dep",
+            entryKind: "check",
+            entryFieldPath: entry.fieldPath,
+            ruleName: name,
+            path: dep
+          });
+        }
+      }
+    }
+  }
+  return Array.from(byKey.entries()).sort((a, b) => a[0].localeCompare(b[0])).map(([, v]) => v);
+};
+var build = (stateSchema, spec) => {
+  const entries = normalizeSpec(spec);
+  const nodeMetaByFieldPath = collectNodeMeta(spec);
+  for (const entry of entries) {
+    if (entry.kind === "computed") {
+      const deps = entry.meta.deps;
+      if (deps === void 0) {
+        throw new Error(
+          `[StateTrait.build] Missing explicit deps for computed "${entry.fieldPath}". Please use StateTrait.computed({ deps: [...], get: ... }).`
+        );
+      }
+    }
+    if (entry.kind === "source") {
+      const deps = entry.meta.deps;
+      if (deps === void 0) {
+        throw new Error(
+          `[StateTrait.build] Missing explicit deps for source "${entry.fieldPath}". Please provide meta.deps for StateTrait.source({ deps: [...], ... }).`
+        );
+      }
+    }
+    if (entry.kind === "check") {
+      const rules = entry.meta?.rules ?? {};
+      for (const name of Object.keys(rules)) {
+        const rule = rules[name];
+        if (typeof rule === "function" || !rule || typeof rule !== "object") {
+          throw new Error(
+            `[StateTrait.build] Missing explicit deps for check "${entry.fieldPath}" rule "${name}". Please use { deps: [...], validate: ... } form.`
+          );
+        }
+        if (rule.deps === void 0) {
+          throw new Error(
+            `[StateTrait.build] Missing explicit deps for check "${entry.fieldPath}" rule "${name}". Please provide deps: [...].`
+          );
+        }
+      }
+    }
+  }
+  const { graph, plan } = buildGraph(entries, nodeMetaByFieldPath);
+  assertNoLinkCycles(graph.edges);
+  return {
+    stateSchema,
+    spec,
+    entries,
+    graph,
+    plan,
+    convergeIr: buildConvergeIr(stateSchema, entries),
+    schemaPaths: collectSchemaPaths(entries)
+  };
+};
+
+// src/internal/state-trait/source.ts
+import { Effect, Fiber, FiberRef, Option } from "effect";
+import { create } from "mutative";
+
+// src/internal/state-trait/deps-trace.ts
+var isTraceableObject = (value) => {
+  if (!value || typeof value !== "object") return false;
+  if (Array.isArray(value)) return true;
+  if (value instanceof Date) return false;
+  if (value instanceof RegExp) return false;
+  if (value instanceof Error) return false;
+  if (value instanceof Map) return false;
+  if (value instanceof Set) return false;
+  if (value instanceof WeakMap) return false;
+  if (value instanceof WeakSet) return false;
+  return true;
+};
+var shouldIgnoreKey = (key) => key === "__proto__" || key === "prototype" || key === "constructor";
+var normalizeReads = (reads) => {
+  const all = Array.from(reads).filter((p) => typeof p === "string" && p.length > 0);
+  all.sort();
+  const isPrefix = (prefix, full) => full !== prefix && full.startsWith(prefix + ".");
+  const pruned = [];
+  for (const p of all) {
+    let hasMoreSpecific = false;
+    for (const other of all) {
+      if (isPrefix(p, other)) {
+        hasMoreSpecific = true;
+        break;
+      }
+    }
+    if (!hasMoreSpecific) {
+      pruned.push(p);
+    }
+  }
+  pruned.sort();
+  return pruned;
+};
+var covers = (declared, read) => declared === read || read.startsWith(declared + ".");
+var diffDeps = (declared, reads) => {
+  const declaredList = Array.from(new Set(declared)).filter((p) => typeof p === "string" && p.length > 0);
+  declaredList.sort();
+  const readList = Array.from(new Set(reads)).filter((p) => typeof p === "string" && p.length > 0);
+  readList.sort();
+  const missing = readList.filter((r) => declaredList.every((d) => !covers(d, r)));
+  const unused = declaredList.filter((d) => readList.every((r) => !covers(d, r)));
+  if (missing.length === 0 && unused.length === 0) return void 0;
+  return {
+    reads: readList,
+    declared: declaredList,
+    missing,
+    unused
+  };
+};
+var trace = (fn, state) => {
+  if (!isTraceableObject(state)) {
+    return { value: fn(state), reads: [] };
+  }
+  const reads = /* @__PURE__ */ new Set();
+  const proxyCache = /* @__PURE__ */ new WeakMap();
+  const proxyToTarget = /* @__PURE__ */ new WeakMap();
+  const wrap = (value2, path) => {
+    if (!isTraceableObject(value2)) return value2;
+    return getProxy(value2, path);
+  };
+  const unwrap = (value2) => {
+    if (value2 && (typeof value2 === "object" || typeof value2 === "function")) {
+      const target = proxyToTarget.get(value2);
+      if (target) return target;
+    }
+    return value2;
+  };
+  const getProxy = (target, basePath) => {
+    let byPath = proxyCache.get(target);
+    if (!byPath) {
+      byPath = /* @__PURE__ */ new Map();
+      proxyCache.set(target, byPath);
+    }
+    const cached = byPath.get(basePath);
+    if (cached) return cached;
+    const record2 = (path) => {
+      if (path) reads.add(path);
+    };
+    const proxy = new Proxy(target, {
+      get: (t, prop, receiver) => {
+        if (typeof prop === "symbol") {
+          return Reflect.get(t, prop, receiver);
+        }
+        const key = String(prop);
+        if (shouldIgnoreKey(key)) {
+          return Reflect.get(t, prop, receiver);
+        }
+        const nextPath = basePath ? `${basePath}.${key}` : key;
+        record2(nextPath);
+        const value2 = Reflect.get(t, prop, receiver);
+        return wrap(value2, nextPath);
+      },
+      has: (t, prop) => {
+        if (typeof prop === "symbol") return Reflect.has(t, prop);
+        const key = String(prop);
+        if (!shouldIgnoreKey(key)) {
+          const nextPath = basePath ? `${basePath}.${key}` : key;
+          record2(nextPath);
+        }
+        return Reflect.has(t, prop);
+      },
+      ownKeys: (t) => {
+        if (basePath) record2(basePath);
+        return Reflect.ownKeys(t);
+      },
+      getOwnPropertyDescriptor: (t, prop) => {
+        if (typeof prop === "symbol") {
+          return Reflect.getOwnPropertyDescriptor(t, prop);
+        }
+        const key = String(prop);
+        if (!shouldIgnoreKey(key)) {
+          const nextPath = basePath ? `${basePath}.${key}` : key;
+          record2(nextPath);
+        }
+        return Reflect.getOwnPropertyDescriptor(t, prop);
+      },
+      set: () => {
+        throw new Error(
+          "[deps-trace] Attempted to mutate state during deps tracing (state is readonly in dev-mode diagnostics)."
+        );
+      },
+      defineProperty: () => {
+        throw new Error(
+          "[deps-trace] Attempted to define property on state during deps tracing (state is readonly in dev-mode diagnostics)."
+        );
+      },
+      deleteProperty: () => {
+        throw new Error(
+          "[deps-trace] Attempted to delete property on state during deps tracing (state is readonly in dev-mode diagnostics)."
+        );
+      }
+    });
+    byPath.set(basePath, proxy);
+    proxyToTarget.set(proxy, target);
+    return proxy;
+  };
+  const root = getProxy(state, "");
+  const value = unwrap(fn(root));
+  return {
+    value,
+    reads: normalizeReads(reads)
+  };
+};
+
+// src/internal/state-trait/source.ts
+var onceInRunSession = (key) => Effect.serviceOption(RunSessionTag).pipe(
+  Effect.map((maybe) => Option.isSome(maybe) ? maybe.value.local.once(key) : true)
+);
+var formatList = (items, limit = 10) => {
+  if (items.length === 0) return "";
+  if (items.length <= limit) return items.join(", ");
+  return `${items.slice(0, limit).join(", ")}, \u2026(+${items.length - limit})`;
+};
+var emitDepsMismatch = (params) => Effect.gen(function* () {
+  const key = `${params.instanceId ?? "unknown"}::${params.kind}::${params.fieldPath}`;
+  const shouldEmit = yield* onceInRunSession(`deps_mismatch:${key}`);
+  if (!shouldEmit) return;
+  yield* record({
+    type: "diagnostic",
+    moduleId: params.moduleId,
+    instanceId: params.instanceId,
+    code: "state_trait::deps_mismatch",
+    severity: "warning",
+    message: `[deps] ${params.kind} "${params.fieldPath}" declared=[${formatList(params.diff.declared)}] reads=[${formatList(params.diff.reads)}] missing=[${formatList(params.diff.missing)}] unused=[${formatList(params.diff.unused)}]`,
+    hint: 'deps is the single source of truth for dependencies: incremental scheduling / reverse closures / performance optimizations rely on deps only. Keep deps consistent with actual reads; if you really depend on the whole object, declare a coarser-grained dep (e.g. "profile") to cover sub-field reads.',
+    kind: `deps_mismatch:${params.kind}`
+  });
+});
+var getMiddlewareStack = () => Effect.serviceOption(EffectOpMiddlewareTag).pipe(
+  Effect.map((maybe) => Option.isSome(maybe) ? maybe.value.stack : [])
+);
+var recordTraitPatch = (bound, path, reason, from, to, traitNodeId) => {
+  const normalized = normalizeFieldPath(path) ?? [];
+  try {
+    const internals = getBoundInternals(bound);
+    internals.txn.recordStatePatch(normalized, reason, from, to, traitNodeId);
+  } catch {
+  }
+};
+var recordReplayEvent = (bound, event) => {
+  try {
+    const internals = getBoundInternals(bound);
+    internals.txn.recordReplayEvent(event);
+  } catch {
+  }
+};
+var getBoundScope = (bound) => {
+  try {
+    const internals = getBoundInternals(bound);
+    return { moduleId: internals.moduleId, instanceId: internals.instanceId };
+  } catch {
+    return { moduleId: void 0, instanceId: void 0 };
+  }
+};
+var setSnapshotInTxn = (bound, fieldPath, next, reason, stepId, traitNodeId) => Effect.gen(function* () {
+  let wrote = false;
+  yield* bound.state.mutate((draft) => {
+    const prev = getAtPath(draft, fieldPath);
+    if (Object.is(prev, next)) return;
+    wrote = true;
+    setAtPathMutating(draft, fieldPath, next);
+    recordTraitPatch(bound, fieldPath, reason, prev, next, traitNodeId);
+  });
+  return wrote;
+});
+var writebackIfCurrentKeyHash = (bound, fieldPath, keyHash2, next, reason, stepId, traitNodeId, replayEvent) => Effect.gen(function* () {
+  let wrote = false;
+  yield* bound.state.mutate((draft) => {
+    const current = getAtPath(draft, fieldPath);
+    const currentKeyHash = current && typeof current === "object" ? current.keyHash : void 0;
+    if (currentKeyHash !== keyHash2) return;
+    const prev = current;
+    if (Object.is(prev, next)) return;
+    wrote = true;
+    setAtPathMutating(draft, fieldPath, next);
+    if (replayEvent) {
+      recordReplayEvent(bound, replayEvent);
+    }
+    recordTraitPatch(bound, fieldPath, reason, prev, next, traitNodeId);
+  });
+  return wrote;
+});
+var syncIdleInTransaction = (program, ctx) => Effect.sync(() => {
+  const draft = ctx.getDraft();
+  const updates = [];
+  for (const entry of program.entries) {
+    if (entry.kind !== "source") continue;
+    const fieldPath = entry.fieldPath;
+    const listItem = parseListItemFieldPath(fieldPath);
+    if (listItem) {
+      const listValue = getAtPath(draft, listItem.listPath);
+      const items = Array.isArray(listValue) ? listValue : [];
+      for (let index = 0; index < items.length; index++) {
+        const item = items[index];
+        let key2;
+        try {
+          key2 = entry.meta.key(item);
+        } catch {
+          continue;
+        }
+        if (key2 !== void 0) continue;
+        const concretePath = toListItemValuePath(listItem.listPath, index, listItem.itemPath);
+        const prev2 = getAtPath(draft, concretePath);
+        const prevStatus2 = prev2 && typeof prev2 === "object" ? prev2.status : void 0;
+        if (prevStatus2 === "idle") {
+          const data = prev2?.data;
+          const error = prev2?.error;
+          if (data === void 0 && error === void 0) {
+            continue;
+          }
+        }
+        updates.push({ fieldPath: concretePath, prev: prev2 });
+      }
+      continue;
+    }
+    let key;
+    try {
+      key = entry.meta.key(draft);
+    } catch {
+      continue;
+    }
+    if (key !== void 0) continue;
+    const prev = getAtPath(draft, fieldPath);
+    const prevStatus = prev && typeof prev === "object" ? prev.status : void 0;
+    if (prevStatus === "idle") {
+      const data = prev?.data;
+      const error = prev?.error;
+      if (data === void 0 && error === void 0) {
+        continue;
+      }
+    }
+    updates.push({ fieldPath, prev });
+  }
+  if (updates.length === 0) return;
+  const reason = "source-refresh";
+  const nextDraft = create(draft, (next) => {
+    for (const u of updates) {
+      setAtPathMutating(next, u.fieldPath, Snapshot.idle());
+    }
+  });
+  ctx.setDraft(nextDraft);
+  for (const u of updates) {
+    const normalized = normalizeFieldPath(u.fieldPath) ?? [];
+    ctx.recordPatch(normalized, reason, u.prev, Snapshot.idle(), `source:${u.fieldPath}:idle`);
+  }
+});
+var installSourceRefresh = (bound, step, entry) => {
+  if (!step.targetFieldPath) return Effect.void;
+  const fieldPath = step.targetFieldPath;
+  const resourceId = step.resourceId ?? entry.meta.resource;
+  const listItem = parseListItemFieldPath(fieldPath);
+  let internals;
+  try {
+    internals = getBoundInternals(bound);
+  } catch {
+    return Effect.void;
+  }
+  const register = internals.traits.registerSourceRefresh;
+  const recordSnapshot = (replayMode, replayLog, input) => {
+    if (!replayLog) return Effect.void;
+    if (replayMode !== "live") return Effect.void;
+    const event = input && typeof input === "object" && input._tag === "ResourceSnapshot" ? input : {
+      _tag: "ResourceSnapshot",
+      resourceId,
+      fieldPath: input.fieldPath,
+      keyHash: input.keyHash,
+      concurrency: input.concurrency,
+      phase: input.phase,
+      snapshot: input.snapshot,
+      timestamp: Date.now(),
+      moduleId: input.moduleId,
+      instanceId: input.instanceId
+    };
+    return replayLog.record(event);
+  };
+  if (listItem) {
+    const store = internals.traits.rowIdStore;
+    if (!store) {
+      return Effect.void;
+    }
+    const listPath = listItem.listPath;
+    const itemPath = listItem.itemPath;
+    if (!itemPath) {
+      return Effect.void;
+    }
+    const concurrency2 = entry.meta.concurrency;
+    const mode2 = concurrency2 ?? "switch";
+    const inFlight2 = /* @__PURE__ */ new Map();
+    const trailing2 = /* @__PURE__ */ new Map();
+    let gen2 = 0;
+    store.onRemoved(listPath, (rowId) => {
+      trailing2.delete(rowId);
+      inFlight2.delete(rowId);
+    });
+    const setSnapshotForRowInTxn = (rowId, next, reason, stepId) => Effect.gen(function* () {
+      let wrotePath;
+      yield* bound.state.mutate((draft) => {
+        const index = store.getIndex(listPath, rowId);
+        if (index === void 0) return;
+        const concretePath = toListItemValuePath(listPath, index, itemPath);
+        const prev = getAtPath(draft, concretePath);
+        if (Object.is(prev, next)) return;
+        wrotePath = concretePath;
+        setAtPathMutating(draft, concretePath, next);
+        recordTraitPatch(bound, concretePath, reason, prev, next, step.debugInfo?.graphNodeId);
+      });
+      return wrotePath;
+    });
+    const writebackIfCurrentKeyHashForRow = (rowId, keyHash2, next, reason, stepId, phase) => Effect.gen(function* () {
+      let wrotePath;
+      yield* bound.state.mutate((draft) => {
+        const index = store.getIndex(listPath, rowId);
+        if (index === void 0) return;
+        const concretePath = toListItemValuePath(listPath, index, itemPath);
+        const current = getAtPath(draft, concretePath);
+        const currentKeyHash = current && typeof current === "object" ? current.keyHash : void 0;
+        if (currentKeyHash !== keyHash2) return;
+        const prev = current;
+        if (Object.is(prev, next)) return;
+        wrotePath = concretePath;
+        setAtPathMutating(draft, concretePath, next);
+        if (phase) {
+          const { moduleId, instanceId } = getBoundScope(bound);
+          recordReplayEvent(bound, {
+            _tag: "ResourceSnapshot",
+            resourceId,
+            fieldPath: concretePath,
+            keyHash: keyHash2,
+            concurrency: mode2,
+            phase,
+            snapshot: next,
+            timestamp: Date.now(),
+            moduleId,
+            instanceId
+          });
+        }
+        recordTraitPatch(bound, concretePath, reason, prev, next, step.debugInfo?.graphNodeId);
+      });
+      return wrotePath;
+    });
+    const startFetch2 = (rowId, key, keyHash2, replayMode, replayLog) => Effect.gen(function* () {
+      const { moduleId, instanceId } = getBoundScope(bound);
+      const indexForLog = store.getIndex(listPath, rowId);
+      const logFieldPath = indexForLog === void 0 ? void 0 : toListItemValuePath(listPath, indexForLog, itemPath);
+      let loadingSnapshot = Snapshot.loading({ keyHash: keyHash2 });
+      if (replayMode === "replay" && replayLog && logFieldPath) {
+        const replayLoading = yield* replayLog.consumeNextResourceSnapshot({
+          resourceId,
+          fieldPath: logFieldPath,
+          keyHash: keyHash2,
+          phase: "loading"
+        });
+        if (replayLoading) {
+          loadingSnapshot = replayLoading.snapshot;
+        }
+      }
+      const wroteLoadingPath = yield* setSnapshotForRowInTxn(
+        rowId,
+        loadingSnapshot,
+        "source-refresh",
+        `source:${fieldPath}:${rowId}:loading`
+      );
+      if (wroteLoadingPath) {
+        const event = {
+          _tag: "ResourceSnapshot",
+          resourceId,
+          fieldPath: wroteLoadingPath,
+          keyHash: keyHash2,
+          concurrency: mode2,
+          phase: "loading",
+          snapshot: loadingSnapshot,
+          timestamp: Date.now(),
+          moduleId,
+          instanceId
+        };
+        recordReplayEvent(bound, event);
+        yield* recordSnapshot(replayMode, replayLog, event);
+      }
+      const io = Effect.gen(function* () {
+        if (replayMode === "replay" && replayLog) {
+          yield* Effect.yieldNow();
+          const consumePath = wroteLoadingPath ?? logFieldPath;
+          if (!consumePath) return yield* Effect.void;
+          const replayed = yield* replayLog.consumeNextResourceSnapshot({
+            resourceId,
+            fieldPath: consumePath,
+            keyHash: keyHash2
+          });
+          if (!replayed) return yield* Effect.void;
+          if (replayed.phase === "success") {
+            yield* writebackIfCurrentKeyHashForRow(
+              rowId,
+              keyHash2,
+              replayed.snapshot,
+              "source-refresh",
+              `source:${fieldPath}:${rowId}:success`,
+              "success"
+            );
+          } else if (replayed.phase === "error") {
+            yield* writebackIfCurrentKeyHashForRow(
+              rowId,
+              keyHash2,
+              replayed.snapshot,
+              "source-refresh",
+              `source:${fieldPath}:${rowId}:error`,
+              "error"
+            );
+          }
+          return yield* Effect.void;
+        }
+        const stack = yield* getMiddlewareStack();
+        const registryOpt = yield* Effect.serviceOption(internal.ResourceRegistryTag);
+        const registry = Option.isSome(registryOpt) ? registryOpt.value : void 0;
+        const spec = registry?.specs.get(resourceId);
+        if (!spec) {
+          return yield* Effect.void;
+        }
+        const loadEffect = spec.load(key);
+        const meta = {
+          moduleId,
+          instanceId,
+          fieldPath,
+          resourceId,
+          key,
+          keyHash: keyHash2,
+          rowId,
+          traitNodeId: step.debugInfo?.graphNodeId,
+          stepId: step.id
+        };
+        if (!(typeof meta.opSeq === "number" && Number.isFinite(meta.opSeq))) {
+          const sessionOpt = yield* Effect.serviceOption(RunSessionTag);
+          if (Option.isSome(sessionOpt)) {
+            const seqKey = instanceId ?? "global";
+            meta.opSeq = sessionOpt.value.local.nextSeq("opSeq", seqKey);
+          }
+        }
+        const op = make({
+          kind: "service",
+          name: resourceId,
+          effect: loadEffect,
+          meta
+        });
+        const exit = yield* Effect.exit(run(op, stack));
+        if (exit._tag === "Success") {
+          const successSnapshot = Snapshot.success({ keyHash: keyHash2, data: exit.value });
+          const wroteSuccessPath = yield* writebackIfCurrentKeyHashForRow(
+            rowId,
+            keyHash2,
+            successSnapshot,
+            "source-refresh",
+            `source:${fieldPath}:${rowId}:success`,
+            "success"
+          );
+          if (wroteSuccessPath) {
+            yield* recordSnapshot(replayMode, replayLog, {
+              _tag: "ResourceSnapshot",
+              resourceId,
+              fieldPath: wroteSuccessPath,
+              keyHash: keyHash2,
+              concurrency: mode2,
+              phase: "success",
+              snapshot: successSnapshot,
+              timestamp: Date.now(),
+              moduleId,
+              instanceId
+            });
+          }
+        } else {
+          const errorSnapshot = Snapshot.error({ keyHash: keyHash2, error: exit.cause });
+          const wroteErrorPath = yield* writebackIfCurrentKeyHashForRow(
+            rowId,
+            keyHash2,
+            errorSnapshot,
+            "source-refresh",
+            `source:${fieldPath}:${rowId}:error`,
+            "error"
+          );
+          if (wroteErrorPath) {
+            yield* recordSnapshot(replayMode, replayLog, {
+              _tag: "ResourceSnapshot",
+              resourceId,
+              fieldPath: wroteErrorPath,
+              keyHash: keyHash2,
+              concurrency: mode2,
+              phase: "error",
+              snapshot: errorSnapshot,
+              timestamp: Date.now(),
+              moduleId,
+              instanceId
+            });
+          }
+        }
+      }).pipe(Effect.catchAllCause(() => Effect.void));
+      const fiber = yield* Effect.forkScoped(Effect.locally(inSyncTransactionFiber, false)(io));
+      const myGen = gen2 += 1;
+      inFlight2.set(rowId, { gen: myGen, fiber, keyHash: keyHash2 });
+      yield* Effect.forkScoped(
+        Effect.locally(
+          inSyncTransactionFiber,
+          false
+        )(
+          Fiber.await(fiber).pipe(
+            Effect.zipRight(
+              Effect.sync(() => {
+                const current = inFlight2.get(rowId);
+                if (current && current.gen === myGen) {
+                  inFlight2.delete(rowId);
+                }
+              })
+            ),
+            Effect.zipRight(
+              mode2 === "exhaust-trailing" ? Effect.gen(function* () {
+                const next = trailing2.get(rowId);
+                trailing2.delete(rowId);
+                if (next) {
+                  yield* startFetch2(rowId, next.key, next.keyHash, replayMode, replayLog);
+                }
+              }) : Effect.void
+            ),
+            Effect.catchAllCause(() => Effect.void)
+          )
+        )
+      );
+    });
+    register(
+      fieldPath,
+      (state) => Effect.gen(function* () {
+        const { moduleId, instanceId } = getBoundScope(bound);
+        const replayModeOpt = yield* Effect.serviceOption(ReplayModeConfigTag);
+        const replayMode = Option.isSome(replayModeOpt) ? replayModeOpt.value.mode : "live";
+        const replayLogOpt = yield* Effect.serviceOption(ReplayLog);
+        const replayLog = Option.isSome(replayLogOpt) ? replayLogOpt.value : void 0;
+        const force = yield* FiberRef.get(forceSourceRefresh);
+        const listValue = getAtPath(state, listPath);
+        const items = Array.isArray(listValue) ? listValue : [];
+        const ids = store.ensureList(listPath, items);
+        const traceKey = `${instanceId ?? "unknown"}::source::${fieldPath}`;
+        if (isDevEnv() && (yield* onceInRunSession(`deps_trace_settled:${traceKey}`))) {
+          try {
+            const sample = items[0];
+            if (sample !== void 0) {
+              const traced = trace((s) => entry.meta.key(s), sample);
+              const prefixedReads = traced.reads.map((r) => r ? `${listPath}[].${r}` : `${listPath}[]`);
+              const diff = diffDeps(entry.meta.deps ?? [], prefixedReads);
+              if (diff) {
+                yield* emitDepsMismatch({
+                  moduleId,
+                  instanceId,
+                  kind: "source",
+                  fieldPath,
+                  diff
+                });
+              }
+            }
+          } catch {
+          }
+        }
+        for (let index = 0; index < items.length; index++) {
+          const rowId = ids[index];
+          if (!rowId) continue;
+          const concretePath = toListItemValuePath(listPath, index, itemPath);
+          const prevSnapshot = getAtPath(state, concretePath);
+          let key;
+          try {
+            key = entry.meta.key(items[index]);
+          } catch {
+            key = void 0;
+          }
+          const current = inFlight2.get(rowId);
+          if (key === void 0) {
+            trailing2.delete(rowId);
+            inFlight2.delete(rowId);
+            if (prevSnapshot && typeof prevSnapshot === "object" && prevSnapshot.status === "idle" && prevSnapshot.data === void 0 && prevSnapshot.error === void 0) {
+              continue;
+            }
+            const idleSnapshot = Snapshot.idle();
+            const wroteIdlePath = yield* setSnapshotForRowInTxn(
+              rowId,
+              idleSnapshot,
+              "source-refresh",
+              `source:${fieldPath}:${rowId}:idle`
+            );
+            if (wroteIdlePath) {
+              const event = {
+                _tag: "ResourceSnapshot",
+                resourceId,
+                fieldPath: wroteIdlePath,
+                keyHash: void 0,
+                concurrency: mode2,
+                phase: "idle",
+                snapshot: idleSnapshot,
+                timestamp: Date.now(),
+                moduleId,
+                instanceId
+              };
+              recordReplayEvent(bound, event);
+              yield* recordSnapshot(replayMode, replayLog, event);
+            }
+            continue;
+          }
+          const h = keyHash(key);
+          if (!force && current && current.keyHash === h) {
+            continue;
+          }
+          const prevKeyHash = prevSnapshot && typeof prevSnapshot === "object" ? prevSnapshot.keyHash : void 0;
+          if (!force && !current && prevKeyHash === h) {
+            continue;
+          }
+          if (mode2 === "exhaust-trailing" && current) {
+            trailing2.set(rowId, { key, keyHash: h });
+            const loadingSnapshot = Snapshot.loading({ keyHash: h });
+            const wroteLoadingPath = yield* setSnapshotForRowInTxn(
+              rowId,
+              loadingSnapshot,
+              "source-refresh",
+              `source:${fieldPath}:${rowId}:loading`
+            );
+            if (wroteLoadingPath) {
+              const event = {
+                _tag: "ResourceSnapshot",
+                resourceId,
+                fieldPath: wroteLoadingPath,
+                keyHash: h,
+                concurrency: mode2,
+                phase: "loading",
+                snapshot: loadingSnapshot,
+                timestamp: Date.now(),
+                moduleId,
+                instanceId
+              };
+              recordReplayEvent(bound, event);
+              yield* recordSnapshot(replayMode, replayLog, event);
+            }
+            continue;
+          }
+          if (mode2 === "switch" && current) {
+            trailing2.delete(rowId);
+            inFlight2.delete(rowId);
+          }
+          yield* startFetch2(rowId, key, h, replayMode, replayLog);
+        }
+      })
+    );
+    return Effect.void;
+  }
+  let inFlight;
+  let gen = 0;
+  let trailing;
+  const concurrency = entry.meta.concurrency;
+  const mode = concurrency ?? "switch";
+  const startFetch = (key, keyHash2, replayMode, replayLog) => Effect.gen(function* () {
+    const { moduleId, instanceId } = getBoundScope(bound);
+    let loadingSnapshot = Snapshot.loading({ keyHash: keyHash2 });
+    if (replayMode === "replay" && replayLog) {
+      const replayLoading = yield* replayLog.consumeNextResourceSnapshot({
+        resourceId,
+        fieldPath,
+        keyHash: keyHash2,
+        phase: "loading"
+      });
+      if (replayLoading) {
+        loadingSnapshot = replayLoading.snapshot;
+      }
+    }
+    const wroteLoading = yield* setSnapshotInTxn(
+      bound,
+      fieldPath,
+      loadingSnapshot,
+      "source-refresh",
+      `source:${fieldPath}:loading`,
+      step.debugInfo?.graphNodeId
+    );
+    if (wroteLoading) {
+      const event = {
+        _tag: "ResourceSnapshot",
+        resourceId,
+        fieldPath,
+        keyHash: keyHash2,
+        concurrency: mode,
+        phase: "loading",
+        snapshot: loadingSnapshot,
+        timestamp: Date.now(),
+        moduleId,
+        instanceId
+      };
+      recordReplayEvent(bound, event);
+      yield* recordSnapshot(replayMode, replayLog, event);
+    }
+    const io = Effect.gen(function* () {
+      if (replayMode === "replay" && replayLog) {
+        yield* Effect.yieldNow();
+        const replayed = yield* replayLog.consumeNextResourceSnapshot({
+          resourceId,
+          fieldPath,
+          keyHash: keyHash2
+        });
+        if (!replayed) return yield* Effect.void;
+        if (replayed.phase === "success") {
+          const event = {
+            _tag: "ResourceSnapshot",
+            resourceId,
+            fieldPath,
+            keyHash: keyHash2,
+            concurrency: mode,
+            phase: "success",
+            snapshot: replayed.snapshot,
+            timestamp: Date.now(),
+            moduleId,
+            instanceId
+          };
+          yield* writebackIfCurrentKeyHash(
+            bound,
+            fieldPath,
+            keyHash2,
+            replayed.snapshot,
+            "source-refresh",
+            `source:${fieldPath}:success`,
+            step.debugInfo?.graphNodeId,
+            event
+          );
+        } else if (replayed.phase === "error") {
+          const event = {
+            _tag: "ResourceSnapshot",
+            resourceId,
+            fieldPath,
+            keyHash: keyHash2,
+            concurrency: mode,
+            phase: "error",
+            snapshot: replayed.snapshot,
+            timestamp: Date.now(),
+            moduleId,
+            instanceId
+          };
+          yield* writebackIfCurrentKeyHash(
+            bound,
+            fieldPath,
+            keyHash2,
+            replayed.snapshot,
+            "source-refresh",
+            `source:${fieldPath}:error`,
+            step.debugInfo?.graphNodeId,
+            event
+          );
+        }
+        return yield* Effect.void;
+      }
+      const stack = yield* getMiddlewareStack();
+      const registryOpt = yield* Effect.serviceOption(internal.ResourceRegistryTag);
+      const registry = Option.isSome(registryOpt) ? registryOpt.value : void 0;
+      const spec = registry?.specs.get(resourceId);
+      if (!spec) {
+        return yield* Effect.void;
+      }
+      const loadEffect = spec.load(key);
+      const meta = {
+        moduleId,
+        instanceId,
+        fieldPath,
+        resourceId,
+        key,
+        keyHash: keyHash2,
+        traitNodeId: step.debugInfo?.graphNodeId,
+        stepId: step.id
+      };
+      if (!(typeof meta.opSeq === "number" && Number.isFinite(meta.opSeq))) {
+        const sessionOpt = yield* Effect.serviceOption(RunSessionTag);
+        if (Option.isSome(sessionOpt)) {
+          const seqKey = instanceId ?? "global";
+          meta.opSeq = sessionOpt.value.local.nextSeq("opSeq", seqKey);
+        }
+      }
+      const op = make({
+        kind: "trait-source",
+        name: resourceId,
+        effect: loadEffect,
+        meta
+      });
+      const exit = yield* Effect.exit(run(op, stack));
+      if (exit._tag === "Success") {
+        const successSnapshot = Snapshot.success({ keyHash: keyHash2, data: exit.value });
+        const event = {
+          _tag: "ResourceSnapshot",
+          resourceId,
+          fieldPath,
+          keyHash: keyHash2,
+          concurrency: mode,
+          phase: "success",
+          snapshot: successSnapshot,
+          timestamp: Date.now(),
+          moduleId,
+          instanceId
+        };
+        const wroteSuccess = yield* writebackIfCurrentKeyHash(
+          bound,
+          fieldPath,
+          keyHash2,
+          successSnapshot,
+          "source-refresh",
+          `source:${fieldPath}:success`,
+          step.debugInfo?.graphNodeId,
+          event
+        );
+        if (wroteSuccess) {
+          yield* recordSnapshot(replayMode, replayLog, event);
+        }
+      } else {
+        const errorSnapshot = Snapshot.error({ keyHash: keyHash2, error: exit.cause });
+        const event = {
+          _tag: "ResourceSnapshot",
+          resourceId,
+          fieldPath,
+          keyHash: keyHash2,
+          concurrency: mode,
+          phase: "error",
+          snapshot: errorSnapshot,
+          timestamp: Date.now(),
+          moduleId,
+          instanceId
+        };
+        const wroteError = yield* writebackIfCurrentKeyHash(
+          bound,
+          fieldPath,
+          keyHash2,
+          errorSnapshot,
+          "source-refresh",
+          `source:${fieldPath}:error`,
+          step.debugInfo?.graphNodeId,
+          event
+        );
+        if (wroteError) {
+          yield* recordSnapshot(replayMode, replayLog, event);
+        }
+      }
+    }).pipe(Effect.catchAllCause(() => Effect.void));
+    const fiber = yield* Effect.forkScoped(Effect.locally(inSyncTransactionFiber, false)(io));
+    const myGen = gen += 1;
+    inFlight = { gen: myGen, fiber, keyHash: keyHash2 };
+    yield* Effect.forkScoped(
+      Effect.locally(
+        inSyncTransactionFiber,
+        false
+      )(
+        Fiber.await(fiber).pipe(
+          Effect.zipRight(
+            Effect.sync(() => {
+              if (inFlight && inFlight.gen === myGen) {
+                inFlight = void 0;
+              }
+            })
+          ),
+          Effect.zipRight(
+            mode === "exhaust-trailing" ? Effect.gen(function* () {
+              const next = trailing;
+              trailing = void 0;
+              if (next) {
+                yield* startFetch(next.key, next.keyHash, replayMode, replayLog);
+              }
+            }) : Effect.void
+          ),
+          Effect.catchAllCause(() => Effect.void)
+        )
+      )
+    );
+  });
+  register(
+    fieldPath,
+    (state) => Effect.gen(function* () {
+      const { moduleId, instanceId } = getBoundScope(bound);
+      const replayModeOpt = yield* Effect.serviceOption(ReplayModeConfigTag);
+      const replayMode = Option.isSome(replayModeOpt) ? replayModeOpt.value.mode : "live";
+      const replayLogOpt = yield* Effect.serviceOption(ReplayLog);
+      const replayLog = Option.isSome(replayLogOpt) ? replayLogOpt.value : void 0;
+      const force = yield* FiberRef.get(forceSourceRefresh);
+      let key;
+      try {
+        key = entry.meta.key(state);
+      } catch {
+        key = void 0;
+      }
+      const traceKey = `${instanceId ?? "unknown"}::source::${fieldPath}`;
+      if (isDevEnv() && (yield* onceInRunSession(`deps_trace_settled:${traceKey}`))) {
+        try {
+          const traced = trace((s) => entry.meta.key(s), state);
+          const diff = diffDeps(entry.meta.deps ?? [], traced.reads);
+          if (diff) {
+            yield* emitDepsMismatch({
+              moduleId,
+              instanceId,
+              kind: "source",
+              fieldPath,
+              diff
+            });
+          }
+        } catch {
+        }
+      }
+      if (key === void 0) {
+        if (inFlight) {
+          yield* Fiber.interruptFork(inFlight.fiber);
+          inFlight = void 0;
+        }
+        trailing = void 0;
+        const idleSnapshot = Snapshot.idle();
+        const wroteIdle = yield* setSnapshotInTxn(
+          bound,
+          fieldPath,
+          idleSnapshot,
+          "source-refresh",
+          `source:${fieldPath}:idle`,
+          step.debugInfo?.graphNodeId
+        );
+        if (wroteIdle) {
+          const event = {
+            _tag: "ResourceSnapshot",
+            resourceId,
+            fieldPath,
+            keyHash: void 0,
+            concurrency: mode,
+            phase: "idle",
+            snapshot: idleSnapshot,
+            timestamp: Date.now(),
+            moduleId,
+            instanceId
+          };
+          recordReplayEvent(bound, event);
+          yield* recordSnapshot(replayMode, replayLog, event);
+        }
+        return;
+      }
+      const h = keyHash(key);
+      if (!force) {
+        if (inFlight && inFlight.keyHash === h) {
+          return;
+        }
+        const currentSnapshot = getAtPath(state, fieldPath);
+        const currentKeyHash = currentSnapshot && typeof currentSnapshot === "object" ? currentSnapshot.keyHash : void 0;
+        const currentStatus = currentSnapshot && typeof currentSnapshot === "object" ? currentSnapshot.status : void 0;
+        if (currentStatus && currentStatus !== "idle" && currentKeyHash === h) {
+          return;
+        }
+      }
+      if (mode === "exhaust-trailing" && inFlight) {
+        trailing = { key, keyHash: h };
+        const loadingSnapshot = Snapshot.loading({ keyHash: h });
+        const wroteLoading = yield* setSnapshotInTxn(
+          bound,
+          fieldPath,
+          loadingSnapshot,
+          "source-refresh",
+          `source:${fieldPath}:loading`,
+          step.debugInfo?.graphNodeId
+        );
+        if (wroteLoading) {
+          const event = {
+            _tag: "ResourceSnapshot",
+            resourceId,
+            fieldPath,
+            keyHash: h,
+            concurrency: mode,
+            phase: "loading",
+            snapshot: loadingSnapshot,
+            timestamp: Date.now(),
+            moduleId,
+            instanceId
+          };
+          recordReplayEvent(bound, event);
+          yield* recordSnapshot(replayMode, replayLog, event);
+        }
+        return;
+      }
+      if (mode === "switch" && inFlight) {
+        yield* Fiber.interruptFork(inFlight.fiber);
+        inFlight = void 0;
+        trailing = void 0;
+      }
+      yield* startFetch(key, h, replayMode, replayLog);
+    })
+  );
+  return Effect.void;
+};
+
+export {
+  diffDeps,
+  trace,
+  syncIdleInTransaction,
+  installSourceRefresh,
+  build
+};
+//# sourceMappingURL=chunk-PYOE4VSI.js.map