joist-core 2.3.0 → 2.4.0

package/build/logging/FactoryLogger.d.cts

@@ -0,0 +1,27 @@
+import { EntityMetadata } from "../EntityMetadata.cjs";
+import { UseMapSource } from "../newTestInstance.cjs";
+import { Entity } from "../Entity.cjs";
+//#region src/logging/FactoryLogger.d.ts
+type WriteFn = (line: string) => void;
+declare class FactoryLogger {
+  private level;
+  private writeFn;
+  private skipNextLogCreating;
+  constructor();
+  logCreating(cstr: any): void;
+  logAddToUseMap(e: Entity, source: UseMapSource): void;
+  logCreated(e: Entity): void;
+  logFoundExisting(e: Entity): void;
+  logFoundOpt(fieldName: string, e: Entity): void;
+  logNotFoundAndCreating(fieldName: string, meta: EntityMetadata): void;
+  logFoundInUseMap(fieldName: string, e: Entity): void;
+  logFoundSingleEntity(fieldName: string, e: Entity): void;
+  indent(): void;
+  dedent(): void;
+  private write;
+  private prefix;
+}
+declare function setFactoryWriter(write: WriteFn | undefined): void;
+//#endregion
+export { FactoryLogger, WriteFn, setFactoryWriter };
+//# sourceMappingURL=FactoryLogger.d.cts.map

package/build/logging/FactoryLogger.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryLogger.d.cts","names":[],"sources":["../../src/logging/FactoryLogger.ts"],"mappings":";;;;KAOY,WAAW;cAIV;UACH;UACA;UACA;EAIR;EAIA,YAAY;EASZ,eAAe,GAAG,QAAQ,QAAQ;EAQlC,WAAW,GAAG;EAKd,iBAAiB,GAAG;EAKpB,YAAY,mBAAmB,GAAG;EAIlC,uBAAuB,mBAAmB,MAAM;EAKhD,iBAAiB,mBAAmB,GAAG;EAIvC,qBAAqB,mBAAmB,GAAG;EAI3C;EAIA;UAIQ;UAIA;;iBAMM,iBAAiB,OAAO"}

package/build/logging/FactoryLogger.d.mts

@@ -0,0 +1,27 @@
+import { EntityMetadata } from "../EntityMetadata.mjs";
+import { UseMapSource } from "../newTestInstance.mjs";
+import { Entity } from "../Entity.mjs";
+//#region src/logging/FactoryLogger.d.ts
+type WriteFn = (line: string) => void;
+declare class FactoryLogger {
+  private level;
+  private writeFn;
+  private skipNextLogCreating;
+  constructor();
+  logCreating(cstr: any): void;
+  logAddToUseMap(e: Entity, source: UseMapSource): void;
+  logCreated(e: Entity): void;
+  logFoundExisting(e: Entity): void;
+  logFoundOpt(fieldName: string, e: Entity): void;
+  logNotFoundAndCreating(fieldName: string, meta: EntityMetadata): void;
+  logFoundInUseMap(fieldName: string, e: Entity): void;
+  logFoundSingleEntity(fieldName: string, e: Entity): void;
+  indent(): void;
+  dedent(): void;
+  private write;
+  private prefix;
+}
+declare function setFactoryWriter(write: WriteFn | undefined): void;
+//#endregion
+export { FactoryLogger, WriteFn, setFactoryWriter };
+//# sourceMappingURL=FactoryLogger.d.mts.map

package/build/logging/FactoryLogger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FactoryLogger.d.mts","names":[],"sources":["../../src/logging/FactoryLogger.ts"],"mappings":";;;;KAOY,WAAW;cAIV;UACH;UACA;UACA;EAIR;EAIA,YAAY;EASZ,eAAe,GAAG,QAAQ,QAAQ;EAQlC,WAAW,GAAG;EAKd,iBAAiB,GAAG;EAKpB,YAAY,mBAAmB,GAAG;EAIlC,uBAAuB,mBAAmB,MAAM;EAKhD,iBAAiB,mBAAmB,GAAG;EAIvC,qBAAqB,mBAAmB,GAAG;EAI3C;EAIA;UAIQ;UAIA;;iBAMM,iBAAiB,OAAO"}

package/build/logging/FactoryLogger.js

@@ -1,77 +1,62 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+import { getCallerName } from "../config.js";
+import "../EntityMetadata.js";
+import "../newTestInstance.js";
+import "../Entity.js";
+import ansis from "ansis";
+//#region src/logging/FactoryLogger.ts
+let writer = void 0;
+const { gray, green, yellow } = ansis;
+var FactoryLogger = class {
+	level = 0;
+	writeFn;
+	skipNextLogCreating = false;
+	constructor() {
+		this.writeFn = writer ?? process.stdout.write.bind(process.stdout);
+	}
+	logCreating(cstr) {
+		if (this.skipNextLogCreating) this.skipNextLogCreating = false;
+		else this.write("Creating", green.bold(`new ${cstr.name}`), gray(`at ${getCallerName(2)}`));
+	}
+	logAddToUseMap(e, source) {
+		if (source === "sameBranch" || source === "diffBranch") this.write(`${gray(`created`)} ${e.toString()} ${gray("added to scope")}`);
+		else this.write(`${gray(`...adding`)} ${e.toString()} ${gray("opt to scope")}`);
+	}
+	logCreated(e) {
+		this.write(`${gray(`created`)} ${e.toString()}`);
+	}
+	logFoundExisting(e) {
+		this.write(`${yellow(`using existing`)} ${e.toString()}`);
+	}
+	logFoundOpt(fieldName, e) {
+		this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from opt")}`);
+	}
+	logNotFoundAndCreating(fieldName, meta) {
+		this.write(`${gray(`${fieldName} =`)} creating ${green.bold(`new ${meta.type}`)}`);
+		this.skipNextLogCreating = true;
+	}
+	logFoundInUseMap(fieldName, e) {
+		this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from scope")}`);
+	}
+	logFoundSingleEntity(fieldName, e) {
+		this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from em")}`);
+	}
+	indent() {
+		this.level++;
+	}
+	dedent() {
+		this.level--;
+	}
+	write(...line) {
+		this.writeFn(this.prefix() + line.join(" ") + "\n");
+	}
+	prefix() {
+		return "  ".repeat(this.level);
+	}
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FactoryLogger = void 0;
-exports.setFactoryWriter = setFactoryWriter;
-const ansis_1 = __importDefault(require("ansis"));
-const config_1 = require("../config");
-let writer = undefined;
-const { gray, green, yellow } = ansis_1.default;
-class FactoryLogger {
-    level = 0;
-    writeFn;
-    skipNextLogCreating = false;
-    // We default to process.stdout.write to side-step around Jest's console.log instrumentation
-    // adding "...at..." stack traces to our output.
-    constructor() {
-        this.writeFn = writer ?? process.stdout.write.bind(process.stdout);
-    }
-    logCreating(cstr) {
-        // This was already logged by the parent `field = creating new`
-        if (this.skipNextLogCreating) {
-            this.skipNextLogCreating = false;
-        }
-        else {
-            this.write("Creating", green.bold(`new ${cstr.name}`), gray(`at ${(0, config_1.getCallerName)(2)}`));
-        }
-    }
-    logAddToUseMap(e, source) {
-        if (source === "sameBranch" || source === "diffBranch") {
-            this.write(`${gray(`created`)} ${e.toString()} ${gray("added to scope")}`);
-        }
-        else {
-            this.write(`${gray(`...adding`)} ${e.toString()} ${gray("opt to scope")}`);
-        }
-    }
-    logCreated(e) {
-        // This matches the `logAddToUseMap` but for entities not going into scope
-        this.write(`${gray(`created`)} ${e.toString()}`);
-    }
-    logFoundExisting(e) {
-        // Make this yellow because it reverses the "new Entity" we thought we were going to do
-        this.write(`${yellow(`using existing`)} ${e.toString()}`);
-    }
-    logFoundOpt(fieldName, e) {
-        this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from opt")}`);
-    }
-    logNotFoundAndCreating(fieldName, meta) {
-        this.write(`${gray(`${fieldName} =`)} creating ${green.bold(`new ${meta.type}`)}`);
-        this.skipNextLogCreating = true;
-    }
-    logFoundInUseMap(fieldName, e) {
-        this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from scope")}`);
-    }
-    logFoundSingleEntity(fieldName, e) {
-        this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray("from em")}`);
-    }
-    indent() {
-        this.level++;
-    }
-    dedent() {
-        this.level--;
-    }
-    write(...line) {
-        this.writeFn(this.prefix() + line.join(" ") + "\n");
-    }
-    prefix() {
-        return "  ".repeat(this.level);
-    }
-}
-exports.FactoryLogger = FactoryLogger;
-// Allow our test suite observe the logger behavior
 function setFactoryWriter(write) {
-    writer = write;
+	writer = write;
 }
+//#endregion
+export { FactoryLogger, setFactoryWriter };
+
 //# sourceMappingURL=FactoryLogger.js.map

package/build/logging/FactoryLogger.js.map

@@ -1 +1 @@
-{"version":3,"file":"FactoryLogger.js","sourceRoot":"","sources":["../../src/logging/FactoryLogger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FactoryLogger.js","names":[],"sources":["../../src/logging/FactoryLogger.ts"],"sourcesContent":["import ansis from \"ansis\";\nimport { getCallerName } from \"src/config.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { type EntityMetadata } from \"src/EntityMetadata.ts\";\nimport { type UseMapSource } from \"src/newTestInstance.ts\";\n\nlet writer: WriteFn | undefined = undefined;\nexport type WriteFn = (line: string) => void;\n\nconst { gray, green, yellow } = ansis;\n\nexport class FactoryLogger {\n  private level = 0;\n  private writeFn: WriteFn;\n  private skipNextLogCreating = false;\n\n  // We default to process.stdout.write to side-step around Jest's console.log instrumentation\n  // adding \"...at...\" stack traces to our output.\n  constructor() {\n    this.writeFn = writer ?? process.stdout.write.bind(process.stdout);\n  }\n\n  logCreating(cstr: any): void {\n    // This was already logged by the parent `field = creating new`\n    if (this.skipNextLogCreating) {\n      this.skipNextLogCreating = false;\n    } else {\n      this.write(\"Creating\", green.bold(`new ${cstr.name}`), gray(`at ${getCallerName(2)}`));\n    }\n  }\n\n  logAddToUseMap(e: Entity, source: UseMapSource): void {\n    if (source === \"sameBranch\" || source === \"diffBranch\") {\n      this.write(`${gray(`created`)} ${e.toString()} ${gray(\"added to scope\")}`);\n    } else {\n      this.write(`${gray(`...adding`)} ${e.toString()} ${gray(\"opt to scope\")}`);\n    }\n  }\n\n  logCreated(e: Entity): void {\n    // This matches the `logAddToUseMap` but for entities not going into scope\n    this.write(`${gray(`created`)} ${e.toString()}`);\n  }\n\n  logFoundExisting(e: Entity): void {\n    // Make this yellow because it reverses the \"new Entity\" we thought we were going to do\n    this.write(`${yellow(`using existing`)} ${e.toString()}`);\n  }\n\n  logFoundOpt(fieldName: string, e: Entity): void {\n    this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray(\"from opt\")}`);\n  }\n\n  logNotFoundAndCreating(fieldName: string, meta: EntityMetadata): void {\n    this.write(`${gray(`${fieldName} =`)} creating ${green.bold(`new ${meta.type}`)}`);\n    this.skipNextLogCreating = true;\n  }\n\n  logFoundInUseMap(fieldName: string, e: Entity): void {\n    this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray(\"from scope\")}`);\n  }\n\n  logFoundSingleEntity(fieldName: string, e: Entity): void {\n    this.write(`${gray(`${fieldName} =`)} ${e.toString()} ${gray(\"from em\")}`);\n  }\n\n  indent() {\n    this.level++;\n  }\n\n  dedent() {\n    this.level--;\n  }\n\n  private write(...line: string[]): void {\n    this.writeFn(this.prefix() + line.join(\" \") + \"\\n\");\n  }\n\n  private prefix() {\n    return \"  \".repeat(this.level);\n  }\n}\n\n// Allow our test suite observe the logger behavior\nexport function setFactoryWriter(write: WriteFn | undefined): void {\n  writer = write;\n}\n"],"mappings":";;;;;;AAMA,IAAI,SAA8B,KAAA;AAGlC,MAAM,EAAE,MAAM,OAAO,WAAW;AAEhC,IAAa,gBAAb,MAA2B;CACzB,QAAgB;CAChB;CACA,sBAA8B;CAI9B,cAAc;EACZ,KAAK,UAAU,UAAU,QAAQ,OAAO,MAAM,KAAK,QAAQ,MAAM;CACnE;CAEA,YAAY,MAAiB;EAE3B,IAAI,KAAK,qBACP,KAAK,sBAAsB;OAE3B,KAAK,MAAM,YAAY,MAAM,KAAK,OAAO,KAAK,MAAM,GAAG,KAAK,MAAM,cAAc,CAAC,GAAG,CAAC;CAEzF;CAEA,eAAe,GAAW,QAA4B;EACpD,IAAI,WAAW,gBAAgB,WAAW,cACxC,KAAK,MAAM,GAAG,KAAK,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,gBAAgB,GAAG;OAEzE,KAAK,MAAM,GAAG,KAAK,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,cAAc,GAAG;CAE7E;CAEA,WAAW,GAAiB;EAE1B,KAAK,MAAM,GAAG,KAAK,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG;CACjD;CAEA,iBAAiB,GAAiB;EAEhC,KAAK,MAAM,GAAG,OAAO,gBAAgB,EAAE,GAAG,EAAE,SAAS,GAAG;CAC1D;CAEA,YAAY,WAAmB,GAAiB;EAC9C,KAAK,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,UAAU,GAAG;CAC5E;CAEA,uBAAuB,WAAmB,MAA4B;EACpE,KAAK,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,EAAE,YAAY,MAAM,KAAK,OAAO,KAAK,MAAM,GAAG;EACjF,KAAK,sBAAsB;CAC7B;CAEA,iBAAiB,WAAmB,GAAiB;EACnD,KAAK,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,YAAY,GAAG;CAC9E;CAEA,qBAAqB,WAAmB,GAAiB;EACvD,KAAK,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,KAAK,SAAS,GAAG;CAC3E;CAEA,SAAS;EACP,KAAK;CACP;CAEA,SAAS;EACP,KAAK;CACP;CAEA,MAAc,GAAG,MAAsB;EACrC,KAAK,QAAQ,KAAK,OAAO,IAAI,KAAK,KAAK,GAAG,IAAI,IAAI;CACpD;CAEA,SAAiB;EACf,OAAO,KAAK,OAAO,KAAK,KAAK;CAC/B;AACF;AAGA,SAAgB,iBAAiB,OAAkC;CACjE,SAAS;AACX"}

package/build/logging/FieldLogger.cjs

@@ -0,0 +1,57 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_config = require("../config.cjs");
+const require_Entity = require("../Entity.cjs");
+let ansis = require("ansis");
+ansis = require_runtime.__toESM(ansis, 1);
+//#region src/logging/FieldLogger.ts
+const { gray, green, yellow, blue, red } = ansis.default;
+/**
+* Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.
+*/
+var FieldLogger = class {
+	#writeFn;
+	#watching = [];
+	constructor(watching, writeFn) {
+		this.#writeFn = writeFn ?? ((line) => process.stdout.write(`${line}\n`));
+		this.#watching = watching ?? [];
+	}
+	logCreate(entity) {
+		const log = this.shouldLog(entity, "constructor");
+		if (!log) return;
+		this.log(green.bold(`${entity.toTaggedString()}`) + " " + yellow(`created`), gray(`at ${require_config.getFuzzyCallerName()}`));
+		if (log === "breakpoint") debugger;
+	}
+	logSet(entity, fieldName, value) {
+		const log = this.shouldLog(entity, fieldName);
+		if (!log) return;
+		const color = this.getColor(value);
+		this.log(green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`), gray(`=`), color(`${value}`), gray(`at ${require_config.getFuzzyCallerName()}`));
+		if (log === "breakpoint") debugger;
+	}
+	log(...line) {
+		this.#writeFn(`${line.join(" ")}`);
+	}
+	shouldLog(entity, fieldName) {
+		if (this.#watching.length === 0) return true;
+		for (const { entity: entityName, fieldNames, breakpoint } of this.#watching) if (entity.constructor.name === entityName && (fieldNames === void 0 || fieldNames.includes(fieldName))) return breakpoint ? "breakpoint" : true;
+		return false;
+	}
+	getColor(value) {
+		return typeof value === "boolean" ? red : require_Entity.isEntity(value) ? green : blue;
+	}
+};
+var NoopFieldLogger = class extends FieldLogger {
+	constructor() {
+		super([]);
+	}
+	logCreate(entity) {}
+	logSet(entity, fieldName, value) {}
+};
+/** A shared no-op logger that avoids optional chaining in hot field access paths. */
+const noopFieldLogger = new NoopFieldLogger();
+//#endregion
+exports.FieldLogger = FieldLogger;
+exports.noopFieldLogger = noopFieldLogger;
+
+//# sourceMappingURL=FieldLogger.cjs.map

package/build/logging/FieldLogger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldLogger.cjs","names":["#writeFn","#watching","getFuzzyCallerName","isEntity"],"sources":["../../src/logging/FieldLogger.ts"],"sourcesContent":["import ansis from \"ansis\";\nimport { getFuzzyCallerName } from \"src/config.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\n\nconst { gray, green, yellow, blue, red } = ansis;\nexport type WriteFn = (line: string) => void;\n\nexport type FieldLoggerWatch = {\n  /** The entity name, i.e. `Author` */\n  entity: string;\n  /** The fields, i.e. `[\"firstName\", \"lastName\"]`. */\n  fieldNames?: string[];\n  /** Whether to stop a debugger when the field is set. */\n  breakpoint?: boolean;\n};\n\n/**\n * Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.\n */\nexport class FieldLogger {\n  readonly #writeFn: WriteFn;\n  readonly #watching: FieldLoggerWatch[] = [];\n\n  constructor(\n    /** The fields to watch, defaults to all fields. */\n    watching: FieldLoggerWatch[],\n    /** An optional/semi-internal write function, mostly for testing. */\n    writeFn?: WriteFn,\n  ) {\n    // We default to process.stdout.write to side-step around Jest's console.log instrumentation\n    this.#writeFn = writeFn ?? ((line) => process.stdout.write(`${line}\\n`));\n    this.#watching = watching ?? [];\n  }\n\n  logCreate(entity: Entity): void {\n    const log = this.shouldLog(entity, \"constructor\");\n    if (!log) return;\n    this.log(green.bold(`${entity.toTaggedString()}`) + \" \" + yellow(`created`), gray(`at ${getFuzzyCallerName()}`));\n    if (log === \"breakpoint\") debugger;\n  }\n\n  logSet(entity: Entity, fieldName: string, value: unknown): void {\n    const log = this.shouldLog(entity, fieldName);\n    if (!log) return;\n    const color = this.getColor(value);\n    this.log(\n      green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`),\n      gray(`=`),\n      color(`${value}`),\n      // We don't know if we'll be called from getField or M2O.set+getField, i.e. how many stack frames to skip\n      // to really get \"the caller's location\", so use `getFuzzyCallerName` instead of `getCallerName`.\n      gray(`at ${getFuzzyCallerName()}`),\n    );\n    if (log === \"breakpoint\") debugger;\n  }\n\n  private log(...line: string[]): void {\n    this.#writeFn(`${line.join(\" \")}`);\n  }\n\n  private shouldLog(entity: Entity, fieldName: string): boolean | \"breakpoint\" {\n    if (this.#watching.length === 0) return true;\n    for (const { entity: entityName, fieldNames, breakpoint } of this.#watching) {\n      if (entity.constructor.name === entityName && (fieldNames === undefined || fieldNames.includes(fieldName))) {\n        return breakpoint ? \"breakpoint\" : true;\n      }\n    }\n    return false;\n  }\n\n  // Do some `typeof` -> color\n  private getColor(value: unknown): typeof red {\n    return typeof value === \"boolean\"\n      ? red // boolean => red\n      : isEntity(value)\n        ? green // entity => green (matches other logging)\n        : blue; // otherwise strings/dates/numbers are blue;\n  }\n}\n\nclass NoopFieldLogger extends FieldLogger {\n  constructor() {\n    super([]);\n  }\n\n  logCreate(entity: Entity): void {}\n\n  logSet(entity: Entity, fieldName: string, value: unknown): void {}\n}\n\n/** A shared no-op logger that avoids optional chaining in hot field access paths. */\nexport const noopFieldLogger: FieldLogger = new NoopFieldLogger();\n"],"mappings":";;;;;;;AAIA,MAAM,EAAE,MAAM,OAAO,QAAQ,MAAM,QAAQ,MAAA;;;;AAe3C,IAAa,cAAb,MAAyB;CACvB;CACA,YAAyC,CAAC;CAE1C,YAEE,UAEA,SACA;EAEA,KAAKA,WAAW,aAAa,SAAS,QAAQ,OAAO,MAAM,GAAG,KAAK,GAAG;EACtE,KAAKC,YAAY,YAAY,CAAC;CAChC;CAEA,UAAU,QAAsB;EAC9B,MAAM,MAAM,KAAK,UAAU,QAAQ,aAAa;EAChD,IAAI,CAAC,KAAK;EACV,KAAK,IAAI,MAAM,KAAK,GAAG,OAAO,eAAe,GAAG,IAAI,MAAM,OAAO,SAAS,GAAG,KAAK,MAAMC,eAAAA,mBAAmB,GAAG,CAAC;EAC/G,IAAI,QAAQ,cAAc;CAC5B;CAEA,OAAO,QAAgB,WAAmB,OAAsB;EAC9D,MAAM,MAAM,KAAK,UAAU,QAAQ,SAAS;EAC5C,IAAI,CAAC,KAAK;EACV,MAAM,QAAQ,KAAK,SAAS,KAAK;EACjC,KAAK,IACH,MAAM,KAAK,GAAG,OAAO,eAAe,GAAG,IAAI,OAAO,IAAI,WAAW,GACjE,KAAK,GAAG,GACR,MAAM,GAAG,OAAO,GAGhB,KAAK,MAAMA,eAAAA,mBAAmB,GAAG,CACnC;EACA,IAAI,QAAQ,cAAc;CAC5B;CAEA,IAAY,GAAG,MAAsB;EACnC,KAAKF,SAAS,GAAG,KAAK,KAAK,GAAG,GAAG;CACnC;CAEA,UAAkB,QAAgB,WAA2C;EAC3E,IAAI,KAAKC,UAAU,WAAW,GAAG,OAAO;EACxC,KAAK,MAAM,EAAE,QAAQ,YAAY,YAAY,gBAAgB,KAAKA,WAChE,IAAI,OAAO,YAAY,SAAS,eAAe,eAAe,KAAA,KAAa,WAAW,SAAS,SAAS,IACtG,OAAO,aAAa,eAAe;EAGvC,OAAO;CACT;CAGA,SAAiB,OAA4B;EAC3C,OAAO,OAAO,UAAU,YACpB,MACAE,eAAAA,SAAS,KAAK,IACZ,QACA;CACR;AACF;AAEA,IAAM,kBAAN,cAA8B,YAAY;CACxC,cAAc;EACZ,MAAM,CAAC,CAAC;CACV;CAEA,UAAU,QAAsB,CAAC;CAEjC,OAAO,QAAgB,WAAmB,OAAsB,CAAC;AACnE;;AAGA,MAAa,kBAA+B,IAAI,gBAAgB"}

package/build/logging/FieldLogger.d.cts

@@ -0,0 +1,32 @@
+import { Entity } from "../Entity.cjs";
+//#region src/logging/FieldLogger.d.ts
+type WriteFn = (line: string) => void;
+type FieldLoggerWatch = {
+  /** The entity name, i.e. `Author` */
+  entity: string;
+  /** The fields, i.e. `["firstName", "lastName"]`. */
+  fieldNames?: string[];
+  /** Whether to stop a debugger when the field is set. */
+  breakpoint?: boolean;
+};
+/**
+ * Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.
+ */
+declare class FieldLogger {
+  #private;
+  constructor(
+  /** The fields to watch, defaults to all fields. */
+  watching: FieldLoggerWatch[],
+  /** An optional/semi-internal write function, mostly for testing. */
+  writeFn?: WriteFn);
+  logCreate(entity: Entity): void;
+  logSet(entity: Entity, fieldName: string, value: unknown): void;
+  private log;
+  private shouldLog;
+  private getColor;
+}
+/** A shared no-op logger that avoids optional chaining in hot field access paths. */
+declare const noopFieldLogger: FieldLogger;
+//#endregion
+export { FieldLogger, FieldLoggerWatch, WriteFn, noopFieldLogger };
+//# sourceMappingURL=FieldLogger.d.cts.map

package/build/logging/FieldLogger.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldLogger.d.cts","names":[],"sources":["../../src/logging/FieldLogger.ts"],"mappings":";;KAKY,WAAW;KAEX;;EAEV;;EAEA;;EAEA;;;;;cAMW;;EAIX,YAEE;;EAAA,UAAU,oBAEV;;EAAA,UAAU;EAOZ,UAAU,QAAQ;EAOlB,OAAO,QAAQ,QAAQ,mBAAmB;UAelC;UAIA;UAWA;;;cAoBG,iBAAiB"}

package/build/logging/FieldLogger.d.mts

@@ -0,0 +1,32 @@
+import { Entity } from "../Entity.mjs";
+//#region src/logging/FieldLogger.d.ts
+type WriteFn = (line: string) => void;
+type FieldLoggerWatch = {
+  /** The entity name, i.e. `Author` */
+  entity: string;
+  /** The fields, i.e. `["firstName", "lastName"]`. */
+  fieldNames?: string[];
+  /** Whether to stop a debugger when the field is set. */
+  breakpoint?: boolean;
+};
+/**
+ * Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.
+ */
+declare class FieldLogger {
+  #private;
+  constructor(
+  /** The fields to watch, defaults to all fields. */
+  watching: FieldLoggerWatch[],
+  /** An optional/semi-internal write function, mostly for testing. */
+  writeFn?: WriteFn);
+  logCreate(entity: Entity): void;
+  logSet(entity: Entity, fieldName: string, value: unknown): void;
+  private log;
+  private shouldLog;
+  private getColor;
+}
+/** A shared no-op logger that avoids optional chaining in hot field access paths. */
+declare const noopFieldLogger: FieldLogger;
+//#endregion
+export { FieldLogger, FieldLoggerWatch, WriteFn, noopFieldLogger };
+//# sourceMappingURL=FieldLogger.d.mts.map

package/build/logging/FieldLogger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldLogger.d.mts","names":[],"sources":["../../src/logging/FieldLogger.ts"],"mappings":";;KAKY,WAAW;KAEX;;EAEV;;EAEA;;EAEA;;;;;cAMW;;EAIX,YAEE;;EAAA,UAAU,oBAEV;;EAAA,UAAU;EAOZ,UAAU,QAAQ;EAOlB,OAAO,QAAQ,QAAQ,mBAAmB;UAelC;UAIA;UAWA;;;cAoBG,iBAAiB"}

package/build/logging/FieldLogger.js

@@ -1,69 +1,53 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FieldLogger = void 0;
-const ansis_1 = __importDefault(require("ansis"));
-const Entity_1 = require("../Entity");
-const config_1 = require("../config");
-const { gray, green, yellow, blue, red } = ansis_1.default;
+import { getFuzzyCallerName } from "../config.js";
+import { isEntity } from "../Entity.js";
+import ansis from "ansis";
+//#region src/logging/FieldLogger.ts
+const { gray, green, yellow, blue, red } = ansis;
 /**
- * Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.
- */
-class FieldLogger {
-    #writeFn;
-    #watching = [];
-    constructor(
-    /** The fields to watch, defaults to all fields. */
-    watching, 
-    /** An optional/semi-internal write function, mostly for testing. */
-    writeFn) {
-        // We default to process.stdout.write to side-step around Jest's console.log instrumentation
-        this.#writeFn = writeFn ?? ((line) => process.stdout.write(`${line}\n`));
-        this.#watching = watching ?? [];
-    }
-    logCreate(entity) {
-        const log = this.shouldLog(entity, "constructor");
-        if (!log)
-            return;
-        this.log(green.bold(`${entity.toTaggedString()}`) + " " + yellow(`created`), gray(`at ${(0, config_1.getFuzzyCallerName)()}`));
-        if (log === "breakpoint")
-            debugger;
-    }
-    logSet(entity, fieldName, value) {
-        const log = this.shouldLog(entity, fieldName);
-        if (!log)
-            return;
-        const color = this.getColor(value);
-        this.log(green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`), gray(`=`), color(`${value}`), 
-        // We don't know if we'll be called from getField or M2O.set+getField, i.e. how many stack frames to skip
-        // to really get "the caller's location", so use `getFuzzyCallerName` instead of `getCallerName`.
-        gray(`at ${(0, config_1.getFuzzyCallerName)()}`));
-        if (log === "breakpoint")
-            debugger;
-    }
-    log(...line) {
-        this.#writeFn(`${line.join(" ")}`);
-    }
-    shouldLog(entity, fieldName) {
-        if (this.#watching.length === 0)
-            return true;
-        for (const { entity: entityName, fieldNames, breakpoint } of this.#watching) {
-            if (entity.constructor.name === entityName && (fieldNames === undefined || fieldNames.includes(fieldName))) {
-                return breakpoint ? "breakpoint" : true;
-            }
-        }
-        return false;
-    }
-    // Do some `typeof` -> color
-    getColor(value) {
-        return typeof value === "boolean"
-            ? red // boolean => red
-            : (0, Entity_1.isEntity)(value)
-                ? green // entity => green (matches other logging)
-                : blue; // otherwise strings/dates/numbers are blue;
-    }
-}
-exports.FieldLogger = FieldLogger;
+* Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.
+*/
+var FieldLogger = class {
+	#writeFn;
+	#watching = [];
+	constructor(watching, writeFn) {
+		this.#writeFn = writeFn ?? ((line) => process.stdout.write(`${line}\n`));
+		this.#watching = watching ?? [];
+	}
+	logCreate(entity) {
+		const log = this.shouldLog(entity, "constructor");
+		if (!log) return;
+		this.log(green.bold(`${entity.toTaggedString()}`) + " " + yellow(`created`), gray(`at ${getFuzzyCallerName()}`));
+		if (log === "breakpoint") debugger;
+	}
+	logSet(entity, fieldName, value) {
+		const log = this.shouldLog(entity, fieldName);
+		if (!log) return;
+		const color = this.getColor(value);
+		this.log(green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`), gray(`=`), color(`${value}`), gray(`at ${getFuzzyCallerName()}`));
+		if (log === "breakpoint") debugger;
+	}
+	log(...line) {
+		this.#writeFn(`${line.join(" ")}`);
+	}
+	shouldLog(entity, fieldName) {
+		if (this.#watching.length === 0) return true;
+		for (const { entity: entityName, fieldNames, breakpoint } of this.#watching) if (entity.constructor.name === entityName && (fieldNames === void 0 || fieldNames.includes(fieldName))) return breakpoint ? "breakpoint" : true;
+		return false;
+	}
+	getColor(value) {
+		return typeof value === "boolean" ? red : isEntity(value) ? green : blue;
+	}
+};
+var NoopFieldLogger = class extends FieldLogger {
+	constructor() {
+		super([]);
+	}
+	logCreate(entity) {}
+	logSet(entity, fieldName, value) {}
+};
+/** A shared no-op logger that avoids optional chaining in hot field access paths. */
+const noopFieldLogger = new NoopFieldLogger();
+//#endregion
+export { FieldLogger, noopFieldLogger };
+
 //# sourceMappingURL=FieldLogger.js.map

package/build/logging/FieldLogger.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldLogger.js","sourceRoot":"","sources":["../../src/logging/FieldLogger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FieldLogger.js","names":["#writeFn","#watching"],"sources":["../../src/logging/FieldLogger.ts"],"sourcesContent":["import ansis from \"ansis\";\nimport { getFuzzyCallerName } from \"src/config.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\n\nconst { gray, green, yellow, blue, red } = ansis;\nexport type WriteFn = (line: string) => void;\n\nexport type FieldLoggerWatch = {\n  /** The entity name, i.e. `Author` */\n  entity: string;\n  /** The fields, i.e. `[\"firstName\", \"lastName\"]`. */\n  fieldNames?: string[];\n  /** Whether to stop a debugger when the field is set. */\n  breakpoint?: boolean;\n};\n\n/**\n * Logs the setting of fields on entities to a `writeFn`, which defaults to `process.stdout`.\n */\nexport class FieldLogger {\n  readonly #writeFn: WriteFn;\n  readonly #watching: FieldLoggerWatch[] = [];\n\n  constructor(\n    /** The fields to watch, defaults to all fields. */\n    watching: FieldLoggerWatch[],\n    /** An optional/semi-internal write function, mostly for testing. */\n    writeFn?: WriteFn,\n  ) {\n    // We default to process.stdout.write to side-step around Jest's console.log instrumentation\n    this.#writeFn = writeFn ?? ((line) => process.stdout.write(`${line}\\n`));\n    this.#watching = watching ?? [];\n  }\n\n  logCreate(entity: Entity): void {\n    const log = this.shouldLog(entity, \"constructor\");\n    if (!log) return;\n    this.log(green.bold(`${entity.toTaggedString()}`) + \" \" + yellow(`created`), gray(`at ${getFuzzyCallerName()}`));\n    if (log === \"breakpoint\") debugger;\n  }\n\n  logSet(entity: Entity, fieldName: string, value: unknown): void {\n    const log = this.shouldLog(entity, fieldName);\n    if (!log) return;\n    const color = this.getColor(value);\n    this.log(\n      green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`),\n      gray(`=`),\n      color(`${value}`),\n      // We don't know if we'll be called from getField or M2O.set+getField, i.e. how many stack frames to skip\n      // to really get \"the caller's location\", so use `getFuzzyCallerName` instead of `getCallerName`.\n      gray(`at ${getFuzzyCallerName()}`),\n    );\n    if (log === \"breakpoint\") debugger;\n  }\n\n  private log(...line: string[]): void {\n    this.#writeFn(`${line.join(\" \")}`);\n  }\n\n  private shouldLog(entity: Entity, fieldName: string): boolean | \"breakpoint\" {\n    if (this.#watching.length === 0) return true;\n    for (const { entity: entityName, fieldNames, breakpoint } of this.#watching) {\n      if (entity.constructor.name === entityName && (fieldNames === undefined || fieldNames.includes(fieldName))) {\n        return breakpoint ? \"breakpoint\" : true;\n      }\n    }\n    return false;\n  }\n\n  // Do some `typeof` -> color\n  private getColor(value: unknown): typeof red {\n    return typeof value === \"boolean\"\n      ? red // boolean => red\n      : isEntity(value)\n        ? green // entity => green (matches other logging)\n        : blue; // otherwise strings/dates/numbers are blue;\n  }\n}\n\nclass NoopFieldLogger extends FieldLogger {\n  constructor() {\n    super([]);\n  }\n\n  logCreate(entity: Entity): void {}\n\n  logSet(entity: Entity, fieldName: string, value: unknown): void {}\n}\n\n/** A shared no-op logger that avoids optional chaining in hot field access paths. */\nexport const noopFieldLogger: FieldLogger = new NoopFieldLogger();\n"],"mappings":";;;;AAIA,MAAM,EAAE,MAAM,OAAO,QAAQ,MAAM,QAAQ;;;;AAe3C,IAAa,cAAb,MAAyB;CACvB;CACA,YAAyC,CAAC;CAE1C,YAEE,UAEA,SACA;EAEA,KAAKA,WAAW,aAAa,SAAS,QAAQ,OAAO,MAAM,GAAG,KAAK,GAAG;EACtE,KAAKC,YAAY,YAAY,CAAC;CAChC;CAEA,UAAU,QAAsB;EAC9B,MAAM,MAAM,KAAK,UAAU,QAAQ,aAAa;EAChD,IAAI,CAAC,KAAK;EACV,KAAK,IAAI,MAAM,KAAK,GAAG,OAAO,eAAe,GAAG,IAAI,MAAM,OAAO,SAAS,GAAG,KAAK,MAAM,mBAAmB,GAAG,CAAC;EAC/G,IAAI,QAAQ,cAAc;CAC5B;CAEA,OAAO,QAAgB,WAAmB,OAAsB;EAC9D,MAAM,MAAM,KAAK,UAAU,QAAQ,SAAS;EAC5C,IAAI,CAAC,KAAK;EACV,MAAM,QAAQ,KAAK,SAAS,KAAK;EACjC,KAAK,IACH,MAAM,KAAK,GAAG,OAAO,eAAe,GAAG,IAAI,OAAO,IAAI,WAAW,GACjE,KAAK,GAAG,GACR,MAAM,GAAG,OAAO,GAGhB,KAAK,MAAM,mBAAmB,GAAG,CACnC;EACA,IAAI,QAAQ,cAAc;CAC5B;CAEA,IAAY,GAAG,MAAsB;EACnC,KAAKD,SAAS,GAAG,KAAK,KAAK,GAAG,GAAG;CACnC;CAEA,UAAkB,QAAgB,WAA2C;EAC3E,IAAI,KAAKC,UAAU,WAAW,GAAG,OAAO;EACxC,KAAK,MAAM,EAAE,QAAQ,YAAY,YAAY,gBAAgB,KAAKA,WAChE,IAAI,OAAO,YAAY,SAAS,eAAe,eAAe,KAAA,KAAa,WAAW,SAAS,SAAS,IACtG,OAAO,aAAa,eAAe;EAGvC,OAAO;CACT;CAGA,SAAiB,OAA4B;EAC3C,OAAO,OAAO,UAAU,YACpB,MACA,SAAS,KAAK,IACZ,QACA;CACR;AACF;AAEA,IAAM,kBAAN,cAA8B,YAAY;CACxC,cAAc;EACZ,MAAM,CAAC,CAAC;CACV;CAEA,UAAU,QAAsB,CAAC;CAEjC,OAAO,QAAgB,WAAmB,OAAsB,CAAC;AACnE;;AAGA,MAAa,kBAA+B,IAAI,gBAAgB"}

package/build/logging/ReactionLogger.cjs

@@ -0,0 +1,93 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_utils = require("../utils.cjs");
+require("../config.cjs");
+require("../EntityManager.cjs");
+require("../Entity.cjs");
+let ansis = require("ansis");
+ansis = require_runtime.__toESM(ansis, 1);
+//#region src/logging/ReactionLogger.ts
+const { gray, green, yellow, white } = ansis.default;
+let globalLogger = void 0;
+var ReactionLogger = class {
+	writeFn;
+	constructor(writeFn = process.stdout.write.bind(process.stdout)) {
+		this.writeFn = writeFn;
+	}
+	now() {
+		return performance.now();
+	}
+	logQueued(entity, fieldName, r) {
+		this.log(green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`), gray(`changed, queuing`), green.bold(`${entity.toTaggedString()}`) + yellow(maybeDotPath(r)) + yellow(r.name));
+	}
+	logQueuedAll(entity, reason, r) {
+		this.log(green.bold(`${entity.toTaggedString()}`), gray(`${reason}, queuing`), green.bold(`${entity.toTaggedString()}`) + green(maybeDotPath(r)) + yellow(r.name));
+	}
+	logStartingRecalc(em, kind) {
+		this.log(white.bold(`Recalculating reactive ${kind === "reactiveQueries" ? "queries" : "fields"} values...`), this.entityCount(em));
+	}
+	logStartingValidate(em, todos) {
+		const count = Object.values(todos).reduce((sum, t) => sum + t.inserts.length + t.updates.length + t.deletes.length, 0);
+		this.log(white.bold(`Validating from ${count} changed entities...`), this.entityCount(em));
+	}
+	/** Logs completed walks in deterministic shortest-path order. */
+	logWalks(walks, action) {
+		const ordered = walks.filter((walk) => walk !== void 0).sort((a, b) => a.r.path.length - b.r.path.length);
+		for (const { todo, r, entities } of ordered) {
+			const from = todo[0].constructor.name;
+			this.log(" ", gray(`Walked`), white(`${todo.length}`), green.bold(`${from}`) + green(`.${r.path.length === 0 ? "(self)" : r.path.join(".")}`), gray("paths, found"), white(`${entities.length}`), green.bold(`${r.cstr.name}`) + green(".") + yellow(r.name), gray(`to ${action}`));
+			if (entities.length > 0) this.log("   ", gray("["), todo.map((e) => e.toTaggedString()).join(" "), gray("] -> ["), [...new Set(entities)].map((e) => e.toTaggedString()).join(" "), gray("]"));
+		}
+	}
+	/** After finding the RFs/RQFs/Reactions to recalc, we call their `.load` promise to update. */
+	logLoadingStart(em, actions) {
+		this.log(" ", gray("Loading"), String(actions.length), gray("actions..."), this.entityCount(em));
+		const ordered = [...actions].sort((a, b) => a.r.path.length - b.r.path.length);
+		[...require_utils.groupBy(ordered, (a) => `${a.entity.constructor.name},${a.r.name}`).values()].forEach((actions) => {
+			const { r, entity } = actions[0];
+			this.log("   ", green.bold(entity.constructor.name) + green(".") + yellow(r.name), gray("-> ["), String(actions.map((a) => a.entity.toTaggedString()).join(" ")), gray("]"));
+		});
+	}
+	/** We've completed loading/evaling the reactions. */
+	logLoadingEnd(em, millis) {
+		this.log("   ", gray("took"), String(Math.floor(millis)), gray("millis"), this.entityCount(em));
+	}
+	entityCount(em) {
+		return gray("(em.entities=") + em.entities.length + gray(")");
+	}
+	log(...line) {
+		this.writeFn(`${line.join(" ")}\n`);
+	}
+};
+function setReactionLogging(arg) {
+	globalLogger = typeof arg === "boolean" ? arg ? new ReactionLogger() : void 0 : arg;
+}
+function maybeDotPath(r) {
+	return r.path.length > 0 ? `.${r.path.join(".")}.` : ".";
+}
+var NoopReactionLogger = class extends ReactionLogger {
+	now() {
+		return 0;
+	}
+	logQueued(entity, fieldName, r) {}
+	logQueuedAll(entity, reason, r) {}
+	logStartingRecalc(em, kind) {}
+	logStartingValidate(em, todos) {}
+	logWalks(walks, action) {}
+	logLoadingStart(em, actions) {}
+	logLoadingEnd(em, millis) {}
+};
+/** A shared no-op logger that avoids optional chaining in hot reaction paths. */
+const noopReactionLogger = new NoopReactionLogger();
+//#endregion
+exports.ReactionLogger = ReactionLogger;
+Object.defineProperty(exports, "globalLogger", {
+	enumerable: true,
+	get: function() {
+		return globalLogger;
+	}
+});
+exports.noopReactionLogger = noopReactionLogger;
+exports.setReactionLogging = setReactionLogging;
+
+//# sourceMappingURL=ReactionLogger.cjs.map

package/build/logging/ReactionLogger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactionLogger.cjs","names":["groupBy"],"sources":["../../src/logging/ReactionLogger.ts"],"sourcesContent":["import ansis from \"ansis\";\nimport { type Reactable, type ReactiveRule } from \"src/config.ts\";\nimport { type Entity } from \"src/Entity.ts\";\nimport { type EntityManager } from \"src/EntityManager.ts\";\nimport type { Todo } from \"src/flush/Todo.ts\";\nimport type { ReactiveAction } from \"src/reactivity/ReactionsManager.ts\";\nimport { groupBy } from \"src/utils.ts\";\n\nconst { gray, green, yellow, white } = ansis;\n\nexport let globalLogger: ReactionLogger | undefined = undefined;\ntype WriteFn = (line: string) => void;\nexport type ReactionWalk = {\n  todo: Entity[];\n  r: Reactable | ReactiveRule;\n  entities: Entity[];\n};\n\nexport class ReactionLogger {\n  private writeFn: WriteFn;\n\n  // We default to process.stdout.write to side-step around Jest's console.log instrumentation\n  constructor(writeFn: WriteFn = process.stdout.write.bind(process.stdout)) {\n    this.writeFn = writeFn;\n  }\n\n  now(): number {\n    return performance.now();\n  }\n\n  logQueued(entity: Entity, fieldName: string, r: Reactable): void {\n    this.log(\n      green.bold(`${entity.toTaggedString()}`) + yellow(`.${fieldName}`),\n      gray(`changed, queuing`),\n      green.bold(`${entity.toTaggedString()}`) + yellow(maybeDotPath(r)) + yellow(r.name),\n    );\n  }\n\n  logQueuedAll(entity: Entity, reason: string, r: Reactable): void {\n    this.log(\n      green.bold(`${entity.toTaggedString()}`),\n      gray(`${reason}, queuing`),\n      green.bold(`${entity.toTaggedString()}`) + green(maybeDotPath(r)) + yellow(r.name),\n    );\n  }\n\n  logStartingRecalc(em: EntityManager, kind: \"reactables\" | \"reactiveQueries\"): void {\n    this.log(\n      white.bold(`Recalculating reactive ${kind === \"reactiveQueries\" ? \"queries\" : \"fields\"} values...`),\n      this.entityCount(em),\n    );\n  }\n\n  logStartingValidate(em: EntityManager, todos: Record<string, Todo>): void {\n    const count = Object.values(todos).reduce(\n      (sum, t) => sum + t.inserts.length + t.updates.length + t.deletes.length,\n      0,\n    );\n    this.log(white.bold(`Validating from ${count} changed entities...`), this.entityCount(em));\n  }\n\n  /** Logs completed walks in deterministic shortest-path order. */\n  logWalks(walks: readonly (ReactionWalk | undefined)[], action: \"recalc\" | \"validate\"): void {\n    const ordered = walks.filter((walk) => walk !== undefined).sort((a, b) => a.r.path.length - b.r.path.length);\n    for (const { todo, r, entities } of ordered) {\n      const from = todo[0].constructor.name;\n      this.log(\n        \" \", // indent\n        gray(`Walked`),\n        white(`${todo.length}`),\n        green.bold(`${from}`) + green(`.${r.path.length === 0 ? \"(self)\" : r.path.join(\".\")}`),\n        gray(\"paths, found\"),\n        white(`${entities.length}`),\n        green.bold(`${r.cstr.name}`) + green(\".\") + yellow(r.name),\n        gray(`to ${action}`),\n      );\n      if (entities.length > 0) {\n        this.log(\n          \"   \", // indent\n          gray(\"[\"),\n          todo.map((e) => e.toTaggedString()).join(\" \"),\n          gray(\"] -> [\"),\n          [...new Set(entities)].map((e) => e.toTaggedString()).join(\" \"),\n          gray(\"]\"),\n        );\n      }\n    }\n  }\n\n  /** After finding the RFs/RQFs/Reactions to recalc, we call their `.load` promise to update. */\n  logLoadingStart(em: EntityManager, actions: ReactiveAction[]): void {\n    this.log(\" \", gray(\"Loading\"), String(actions.length), gray(\"actions...\"), this.entityCount(em));\n    const ordered = [...actions].sort((a, b) => a.r.path.length - b.r.path.length);\n    [...groupBy(ordered, (a) => `${a.entity.constructor.name},${a.r.name}`).values()].forEach((actions) => {\n      const { r, entity } = actions[0];\n      this.log(\n        \"   \",\n        green.bold(entity.constructor.name) + green(\".\") + yellow(r.name),\n        gray(\"-> [\"),\n        String(actions.map((a) => a.entity.toTaggedString()).join(\" \")),\n        gray(\"]\"),\n      );\n    });\n  }\n\n  /** We've completed loading/evaling the reactions. */\n  logLoadingEnd(em: EntityManager, millis: number): void {\n    this.log(\"   \", gray(\"took\"), String(Math.floor(millis)), gray(\"millis\"), this.entityCount(em));\n  }\n\n  private entityCount(em: EntityManager): string {\n    return gray(\"(em.entities=\") + em.entities.length + gray(\")\");\n  }\n\n  private log(...line: string[]): void {\n    this.writeFn(`${line.join(\" \")}\\n`);\n  }\n}\n\nexport function setReactionLogging(enabled: boolean): void;\nexport function setReactionLogging(logger: ReactionLogger): void;\nexport function setReactionLogging(arg: boolean | ReactionLogger): void {\n  globalLogger = typeof arg === \"boolean\" ? (arg ? new ReactionLogger() : undefined) : arg;\n}\n\nfunction maybeDotPath(r: Reactable): string {\n  return r.path.length > 0 ? `.${r.path.join(\".\")}.` : \".\";\n}\n\nclass NoopReactionLogger extends ReactionLogger {\n  now(): number {\n    return 0;\n  }\n\n  logQueued(entity: Entity, fieldName: string, r: Reactable): void {}\n\n  logQueuedAll(entity: Entity, reason: string, r: Reactable): void {}\n\n  logStartingRecalc(em: EntityManager, kind: \"reactables\" | \"reactiveQueries\"): void {}\n\n  logStartingValidate(em: EntityManager, todos: Record<string, Todo>): void {}\n\n  logWalks(walks: readonly (ReactionWalk | undefined)[], action: \"recalc\" | \"validate\"): void {}\n\n  logLoadingStart(em: EntityManager, actions: ReactiveAction[]): void {}\n\n  logLoadingEnd(em: EntityManager, millis: number): void {}\n}\n\n/** A shared no-op logger that avoids optional chaining in hot reaction paths. */\nexport const noopReactionLogger: ReactionLogger = new NoopReactionLogger();\n"],"mappings":"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"}