@carbonenginejs/runtime 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/global/blue/ISimTimeRebaseNotify.js

@@ -0,0 +1,28 @@
+import { CjsSchema, compose, impl } from '#schema';
+
+// Source: blue/include/IBlueOS.h:267-270
+//
+//     struct ISimTimeRebaseNotify
+//     {
+//         virtual void OnSimClockRebase( Be::Time oldTime, Be::Time newTime ) = 0;
+//     };
+//
+// Simulation time can be moved, not just slowed: a server sync can shift it.
+// Anything holding a simulation timestamp has to be told, or it is holding a
+// value from a clock that no longer exists. Registered through
+// `RegisterForSimTimeRebase`, which has seven call sites in Carbon.
+
+/** `ISimTimeRebaseNotify` - told when the simulation clock is moved, per blue/include/IBlueOS.h:267. */
+class ISimTimeRebaseNotify {
+  /**
+   * `OnSimClockRebase` - the simulation clock moved from one value to another.
+   *
+   * @param {number} _oldTime The simulation time before the move, in 100ns ticks.
+   * @param {number} _newTime The simulation time after it.
+   */
+  OnSimClockRebase(_oldTime, _newTime) {}
+}
+CjsSchema.decorateMethod(ISimTimeRebaseNotify, "OnSimClockRebase", compose.abstract, impl.abstract);
+
+export { ISimTimeRebaseNotify };
+//# sourceMappingURL=ISimTimeRebaseNotify.js.map

package/dist/global/blue/ISimTimeRebaseNotify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISimTimeRebaseNotify.js","sources":["../../../../src/global/blue/ISimTimeRebaseNotify.js"],"sourcesContent":["// Source: blue/include/IBlueOS.h:267-270\n//\n//     struct ISimTimeRebaseNotify\n//     {\n//         virtual void OnSimClockRebase( Be::Time oldTime, Be::Time newTime ) = 0;\n//     };\n//\n// Simulation time can be moved, not just slowed: a server sync can shift it.\n// Anything holding a simulation timestamp has to be told, or it is holding a\n// value from a clock that no longer exists. Registered through\n// `RegisterForSimTimeRebase`, which has seven call sites in Carbon.\nimport { CjsSchema, compose, impl } from \"#schema\";\n\n/** `ISimTimeRebaseNotify` - told when the simulation clock is moved, per blue/include/IBlueOS.h:267. */\nexport class ISimTimeRebaseNotify\n{\n  /**\n   * `OnSimClockRebase` - the simulation clock moved from one value to another.\n   *\n   * @param {number} _oldTime The simulation time before the move, in 100ns ticks.\n   * @param {number} _newTime The simulation time after it.\n   */\n  OnSimClockRebase(_oldTime, _newTime) {}\n}\n\nCjsSchema.decorateMethod(ISimTimeRebaseNotify, \"OnSimClockRebase\", compose.abstract, impl.abstract);\n"],"names":["ISimTimeRebaseNotify","OnSimClockRebase","_oldTime","_newTime","CjsSchema","decorateMethod","compose","abstract","impl"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,oBAAoB,CACjC;AACE;AACF;AACA;AACA;AACA;AACA;AACEC,EAAAA,gBAAgBA,CAACC,QAAQ,EAAEC,QAAQ,EAAE,CAAC;AACxC;AAEAC,SAAS,CAACC,cAAc,CAACL,oBAAoB,EAAE,kBAAkB,EAAEM,OAAO,CAACC,QAAQ,EAAEC,IAAI,CAACD,QAAQ,CAAC;;;;"}

package/dist/global/blue/IVariableTicker.js

@@ -0,0 +1,24 @@
+import { CjsSchema, compose, impl } from '#schema';
+
+// Source: blue/include/IBlueOS.h:246-253
+//
+// The variable-rate tick callback, beside the fixed-rate `IBlueEvents`. It
+// takes an elapsed SECONDS delta rather than a second absolute time, which is
+// the whole difference: a variable-rate ticker is told how much time passed,
+// a fixed-rate one is told what time it is.
+
+/** `IVariableTicker` - the variable-rate tick callback, per blue/include/IBlueOS.h:246. */
+class IVariableTicker {
+  /**
+   * `OnTick` - one pump cycle, with the elapsed time given.
+   *
+   * @param {number} _timestamp Time since the client started, in 100ns ticks.
+   * @param {number} _deltaTSec Seconds elapsed since the previous pump cycle.
+   * @param {*} _cookie Whatever the registrant passed when it registered.
+   */
+  OnTick(_timestamp, _deltaTSec, _cookie) {}
+}
+CjsSchema.decorateMethod(IVariableTicker, "OnTick", compose.abstract, impl.abstract);
+
+export { IVariableTicker };
+//# sourceMappingURL=IVariableTicker.js.map

package/dist/global/blue/IVariableTicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IVariableTicker.js","sources":["../../../../src/global/blue/IVariableTicker.js"],"sourcesContent":["// Source: blue/include/IBlueOS.h:246-253\n//\n// The variable-rate tick callback, beside the fixed-rate `IBlueEvents`. It\n// takes an elapsed SECONDS delta rather than a second absolute time, which is\n// the whole difference: a variable-rate ticker is told how much time passed,\n// a fixed-rate one is told what time it is.\nimport { CjsSchema, compose, impl } from \"#schema\";\n\n/** `IVariableTicker` - the variable-rate tick callback, per blue/include/IBlueOS.h:246. */\nexport class IVariableTicker\n{\n  /**\n   * `OnTick` - one pump cycle, with the elapsed time given.\n   *\n   * @param {number} _timestamp Time since the client started, in 100ns ticks.\n   * @param {number} _deltaTSec Seconds elapsed since the previous pump cycle.\n   * @param {*} _cookie Whatever the registrant passed when it registered.\n   */\n  OnTick(_timestamp, _deltaTSec, _cookie) {}\n}\n\nCjsSchema.decorateMethod(IVariableTicker, \"OnTick\", compose.abstract, impl.abstract);\n"],"names":["IVariableTicker","OnTick","_timestamp","_deltaTSec","_cookie","CjsSchema","decorateMethod","compose","abstract","impl"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,eAAe,CAC5B;AACE;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,MAAMA,CAACC,UAAU,EAAEC,UAAU,EAAEC,OAAO,EAAE,CAAC;AAC3C;AAEAC,SAAS,CAACC,cAAc,CAACN,eAAe,EAAE,QAAQ,EAAEO,OAAO,CAACC,QAAQ,EAAEC,IAAI,CAACD,QAAQ,CAAC;;;;"}

package/dist/global/blue/blue.js

@@ -0,0 +1,61 @@
+import { IBlueResMan } from './IBlueResMan.js';
+import { CjsBluePaths } from './CjsBluePaths.js';
+import { CjsBlueOS } from './CjsBlueOS.js';
+import { blueEnums } from './enums/CjsBlueEnumRegistry.js';
+
+// Source: blue/include/IBlueResMan.h:135, blue/include/IBluePaths.h:49,
+//   blue/include/IBlueOS.h:226
+//
+// Carbon's process-wide Blue facilities, which it declares as externs beside
+// the interfaces they point at:
+//
+//     extern BLUEIMPORT IBlueResMan* BeResMan;
+//     extern BLUEIMPORT IBluePaths*  BePaths;
+//     extern BLUEIMPORT IBlueOS*     BeOS;
+//
+// `Be` is Blue, so `BeResMan` is `blue.resMan` with the prefix spelled out.
+//
+// WHY A HOLDER RATHER THAN EXPORTED SERVICES. Reach a service THROUGH `blue`
+// and never capture it: `blue.resMan.GetResource(...)`, not
+// `const resMan = blue.resMan` at module scope. The holder owns the reference,
+// so whatever sits behind it can be replaced at any time - a stub, a recording
+// manager, one with a different cache - without anyone's cooperation. ccpwgl
+// had this right on `tw2` and lost it by re-exporting `resMan` and `device` as
+// module bindings, after which 120 files held the implementation directly:
+// that one shortcut fixed the instance count at one AND gave away the
+// swappability the arrangement existed to provide.
+//
+// WHY IT IMPORTS NOTHING BUT ITS OWN INTERFACES. A holder that constructs
+// nothing has no dependency on what it holds, so every layer may read it
+// without the import cycle ccpwgl pays for (`global` imports the root, the
+// root constructs the services, the services import `global`). Composition
+// fills the slots from above.
+//
+// The slots are never empty. Each starts as its interface, whose methods
+// throw, so a call before composition says so at the call site instead of
+// failing later on a null. One CarbonEngineJS per page; see
+// /docs/internal/decisions/composition-root-is-the-wrapper.md.
+
+/** Carbon's process-wide Blue facilities: `blue.resMan`, `blue.paths` and `blue.os`. */
+const blue = {
+  /** EnumRegistration and BlueEnum responsibilities combined for JavaScript. */
+  enums: blueEnums,
+  /** `BeResMan` (IBlueResMan.h:135) - the resource manager every consumer asks. */
+  resMan: new IBlueResMan(),
+  // Paths differs from the manager: an uncomposed one can still answer its
+  // main question truthfully - no, that file is not here - which is what
+  // Carbon returns for a file absent from the local machine, and what every
+  // caller is already written for. The verbs it cannot answer without a real
+  // file system stay refused. See CjsBluePaths.
+  /** `BePaths` (IBluePaths.h:49) - search paths, resolution, existence and streams. */
+  paths: new CjsBluePaths(),
+  // The OS is the ROOT CLOCK, and the reason this slot matters beyond time:
+  // its pump is what calls TriDevice.OnTick, which advances the animation
+  // clock the whole render path reads. Composed like the others, and answering
+  // truthfully before anything composes it - see CjsBlueOS.
+  /** `BeOS` (IBlueOS.h:226) - the clock, the pump, and the tick registry. */
+  os: new CjsBlueOS()
+};
+
+export { blue };
+//# sourceMappingURL=blue.js.map

package/dist/global/blue/blue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blue.js","sources":["../../../../src/global/blue/blue.js"],"sourcesContent":["// Source: blue/include/IBlueResMan.h:135, blue/include/IBluePaths.h:49,\n//   blue/include/IBlueOS.h:226\n//\n// Carbon's process-wide Blue facilities, which it declares as externs beside\n// the interfaces they point at:\n//\n//     extern BLUEIMPORT IBlueResMan* BeResMan;\n//     extern BLUEIMPORT IBluePaths*  BePaths;\n//     extern BLUEIMPORT IBlueOS*     BeOS;\n//\n// `Be` is Blue, so `BeResMan` is `blue.resMan` with the prefix spelled out.\n//\n// WHY A HOLDER RATHER THAN EXPORTED SERVICES. Reach a service THROUGH `blue`\n// and never capture it: `blue.resMan.GetResource(...)`, not\n// `const resMan = blue.resMan` at module scope. The holder owns the reference,\n// so whatever sits behind it can be replaced at any time - a stub, a recording\n// manager, one with a different cache - without anyone's cooperation. ccpwgl\n// had this right on `tw2` and lost it by re-exporting `resMan` and `device` as\n// module bindings, after which 120 files held the implementation directly:\n// that one shortcut fixed the instance count at one AND gave away the\n// swappability the arrangement existed to provide.\n//\n// WHY IT IMPORTS NOTHING BUT ITS OWN INTERFACES. A holder that constructs\n// nothing has no dependency on what it holds, so every layer may read it\n// without the import cycle ccpwgl pays for (`global` imports the root, the\n// root constructs the services, the services import `global`). Composition\n// fills the slots from above.\n//\n// The slots are never empty. Each starts as its interface, whose methods\n// throw, so a call before composition says so at the call site instead of\n// failing later on a null. One CarbonEngineJS per page; see\n// /docs/internal/decisions/composition-root-is-the-wrapper.md.\nimport { IBlueResMan } from \"./IBlueResMan.js\";\nimport { CjsBluePaths } from \"./CjsBluePaths.js\";\nimport { CjsBlueOS } from \"./CjsBlueOS.js\";\nimport { blueEnums } from \"./enums/CjsBlueEnumRegistry.js\";\n\n/** Carbon's process-wide Blue facilities: `blue.resMan`, `blue.paths` and `blue.os`. */\nexport const blue = {\n  /** EnumRegistration and BlueEnum responsibilities combined for JavaScript. */\n  enums: blueEnums,\n  /** `BeResMan` (IBlueResMan.h:135) - the resource manager every consumer asks. */\n  resMan: new IBlueResMan(),\n\n  // Paths differs from the manager: an uncomposed one can still answer its\n  // main question truthfully - no, that file is not here - which is what\n  // Carbon returns for a file absent from the local machine, and what every\n  // caller is already written for. The verbs it cannot answer without a real\n  // file system stay refused. See CjsBluePaths.\n  /** `BePaths` (IBluePaths.h:49) - search paths, resolution, existence and streams. */\n  paths: new CjsBluePaths(),\n\n  // The OS is the ROOT CLOCK, and the reason this slot matters beyond time:\n  // its pump is what calls TriDevice.OnTick, which advances the animation\n  // clock the whole render path reads. Composed like the others, and answering\n  // truthfully before anything composes it - see CjsBlueOS.\n  /** `BeOS` (IBlueOS.h:226) - the clock, the pump, and the tick registry. */\n  os: new CjsBlueOS()\n};\n"],"names":["blue","enums","blueEnums","resMan","IBlueResMan","paths","CjsBluePaths","os","CjsBlueOS"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACO,MAAMA,IAAI,GAAG;AAClB;AACAC,EAAAA,KAAK,EAAEC,SAAS;AAChB;AACAC,EAAAA,MAAM,EAAE,IAAIC,WAAW,EAAE;AAEzB;AACA;AACA;AACA;AACA;AACA;AACAC,EAAAA,KAAK,EAAE,IAAIC,YAAY,EAAE;AAEzB;AACA;AACA;AACA;AACA;EACAC,EAAE,EAAE,IAAIC,SAAS;AACnB;;;;"}

package/dist/global/blue/enums/CjsBlueEnumRegistry.js

@@ -0,0 +1,173 @@
+// Source: blueexposure/include/BlueRegistration.h (enum registration only)
+// Source: blueexposure/BlueRegistration.cpp:10-91 (ordered name lookup)
+// Source: blueexposure/BlueRegistrationPython.cpp (PyBlueEnumObject / blue.BlueEnum)
+// Absorbed: EnumRegistration<T> -> ordered member records; EnumTypeRegistration
+// -> RegisterEnum; PyBlueEnumObject -> read-only values and registry lookups.
+// BlueRegistration's non-enum facilities and other VarChooser uses survive.
+// JS adaptation: qualified names share one table instead of per-module tables;
+// module bodies replace static constructors; no Python extension object exists.
+// Schema attribution is installed by CjsSchema after its own initialization.
+
+/** Native enum exposure flags, retained as metadata without Python module mutation. */
+const EnumRegistrationType = Object.freeze({
+  ENUM_REG_VALUES_ON_MODULE: 1,
+  ENUM_REG_ENUM_OBJECT_ON_MODULE: 2
+});
+
+/** Combines Carbon enum registration and BlueEnum lookup in a dependency-free registry. */
+class CjsBlueEnumRegistry {
+  #byName = new Map();
+  #byObject = new WeakMap();
+
+  /** Registers a read-only named-value object and its ordered chooser metadata. */
+  RegisterEnum(name, values, definition = {}) {
+    if (typeof name !== "string" || !name || name.trim() !== name) {
+      throw new TypeError("Enum name must be a non-empty, unpadded string.");
+    }
+    if (!values || Object.getPrototypeOf(values) !== Object.prototype && Object.getPrototypeOf(values) !== null || Array.isArray(values)) {
+      throw new TypeError("Enum values must be a plain name-to-integer object.");
+    }
+    const records = new Map();
+    for (const key of Object.keys(values)) {
+      const property = Object.getOwnPropertyDescriptor(values, key);
+      if (!key || Number.isFinite(Number(key)) || !Object.hasOwn(property, "value")) {
+        throw new TypeError("Enum members must have nonnumeric names and data values.");
+      }
+      uint32(property.value);
+      records.set(key, {
+        name: key,
+        value: property.value
+      });
+    }
+    const ordered = [];
+    if (definition.members !== undefined && !Array.isArray(definition.members)) {
+      throw new TypeError("Enum members metadata must be an array.");
+    }
+    for (const member of definition.members || []) {
+      const record = records.get(member.name);
+      if (!record || record.value !== member.value) {
+        throw new TypeError("Enum member metadata must agree with the named-value object.");
+      }
+      if (member.description !== undefined) {
+        if (typeof member.description !== "string") throw new TypeError("Enum descriptions must be strings.");
+        record.description = member.description;
+      }
+      ordered.push(Object.freeze(record));
+      records.delete(member.name);
+    }
+    for (const record of records.values()) ordered.push(Object.freeze(record));
+    const info = {
+      name,
+      type: values,
+      members: Object.freeze(ordered)
+    };
+    // Native VarChooser names are exposed labels, not necessarily C++ enum
+    // identifiers. Its ordered selection may omit sentinels and aliases.
+    if (definition.chooser !== undefined) {
+      if (!Array.isArray(definition.chooser)) throw new TypeError("Enum chooser must be an array.");
+      const allowed = new Set(ordered.map(member => uint32(member.value)));
+      info.chooser = Object.freeze(definition.chooser.map(member => {
+        if (typeof member.name !== "string" || !member.name || !allowed.has(uint32(member.value))) {
+          throw new TypeError("Enum chooser entries must name declared enum values.");
+        }
+        const entry = {
+          name: member.name,
+          value: member.value
+        };
+        if (member.description !== undefined) {
+          if (typeof member.description !== "string") throw new TypeError("Enum descriptions must be strings.");
+          entry.description = member.description;
+        }
+        return Object.freeze(entry);
+      }));
+    }
+    for (const key of ["source", "family", "line", "exposure", "exposedName", "chooserSource"]) {
+      if (definition[key] === undefined) continue;
+      if (key === "line" || key === "exposure") {
+        if (!Number.isInteger(definition[key]) || definition[key] < 0) {
+          throw new TypeError(`Enum ${key} must be a nonnegative integer.`);
+        }
+      } else if (typeof definition[key] !== "string") throw new TypeError(`Enum ${key} must be a string.`);
+      info[key] = definition[key];
+    }
+    const existing = this.#byName.get(name);
+    if (existing) {
+      if (existing.type !== values || JSON.stringify({
+        ...existing,
+        type: null
+      }) !== JSON.stringify({
+        ...info,
+        type: null
+      })) {
+        throw new TypeError(`Enum registration conflicts with ${name}.`);
+      }
+      return values;
+    }
+    if (this.#byObject.has(values)) throw new TypeError("Enum object already has a canonical name.");
+    Object.freeze(values);
+    this.#byName.set(name, Object.freeze(info));
+    this.#byObject.set(values, name);
+    return values;
+  }
+
+  /** Reports whether an enum name is registered without resolving a domain. */
+  HasEnum(name) {
+    return this.#byName.has(name);
+  }
+
+  /** Returns the registered read-only named-value object. */
+  GetEnum(name) {
+    return this.GetEnumInfo(name).type;
+  }
+
+  /** Returns ordered chooser metadata, descriptions and donor provenance. */
+  GetEnumInfo(name) {
+    const info = this.#byName.get(name);
+    if (!info) throw new ReferenceError(`Enum is not registered: ${name}`);
+    return info;
+  }
+
+  /** Returns an object's canonical registration name, or null. */
+  GetEnumName(values) {
+    return this.#byObject.get(values) || null;
+  }
+
+  /** Joins every exact alias in chooser order, matching GetEnumValueName_Impl. */
+  GetNameFromValue(name, value) {
+    const info = this.GetEnumInfo(name);
+    const members = info.chooser ?? info.members;
+    const bits = uint32(value);
+    const matches = members.filter(member => uint32(member.value) === bits);
+    if (!matches.length) throw new RangeError(`Enum value not found in ${name}: ${value}`);
+    return matches.map(member => member.name).join(" | ");
+  }
+
+  /** Returns the first exact mask name, or every contained nonzero chooser entry. */
+  GetNameFromBitmask(name, mask) {
+    const info = this.GetEnumInfo(name);
+    const members = info.chooser ?? info.members;
+    const bits = uint32(mask);
+    const exact = members.find(member => uint32(member.value) === bits);
+    if (exact) return exact.name;
+    // Carbon permits unknown remaining bits and includes contained composites.
+    const matches = members.filter(member => {
+      const value = uint32(member.value);
+      return value !== 0 && (value & bits) >>> 0 === value;
+    });
+    if (!matches.length) throw new RangeError(`Enum value not found in ${name}: ${mask}`);
+    return matches.map(member => member.name).join(" | ");
+  }
+}
+function uint32(value) {
+  // Python accepts signed int; JS additionally accepts its unsigned spelling.
+  if (!Number.isInteger(value) || value < -2147483648 || value > 4294967295) {
+    throw new TypeError("Enum values must be signed or unsigned 32-bit integers.");
+  }
+  return value >>> 0;
+}
+
+/** Shared enum storage used by Blue and schema without importing either facade. */
+const blueEnums = new CjsBlueEnumRegistry();
+
+export { CjsBlueEnumRegistry, EnumRegistrationType, blueEnums };
+//# sourceMappingURL=CjsBlueEnumRegistry.js.map

package/dist/global/blue/enums/CjsBlueEnumRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsBlueEnumRegistry.js","sources":["../../../../../src/global/blue/enums/CjsBlueEnumRegistry.js"],"sourcesContent":["// Source: blueexposure/include/BlueRegistration.h (enum registration only)\n// Source: blueexposure/BlueRegistration.cpp:10-91 (ordered name lookup)\n// Source: blueexposure/BlueRegistrationPython.cpp (PyBlueEnumObject / blue.BlueEnum)\n// Absorbed: EnumRegistration<T> -> ordered member records; EnumTypeRegistration\n// -> RegisterEnum; PyBlueEnumObject -> read-only values and registry lookups.\n// BlueRegistration's non-enum facilities and other VarChooser uses survive.\n// JS adaptation: qualified names share one table instead of per-module tables;\n// module bodies replace static constructors; no Python extension object exists.\n// Schema attribution is installed by CjsSchema after its own initialization.\n\n/** Native enum exposure flags, retained as metadata without Python module mutation. */\nexport const EnumRegistrationType = Object.freeze({\n    ENUM_REG_VALUES_ON_MODULE: 1,\n    ENUM_REG_ENUM_OBJECT_ON_MODULE: 2\n});\n\n/** Combines Carbon enum registration and BlueEnum lookup in a dependency-free registry. */\nexport class CjsBlueEnumRegistry\n{\n    #byName = new Map();\n    #byObject = new WeakMap();\n\n    /** Registers a read-only named-value object and its ordered chooser metadata. */\n    RegisterEnum(name, values, definition = {})\n    {\n        if (typeof name !== \"string\" || !name || name.trim() !== name)\n        {\n            throw new TypeError(\"Enum name must be a non-empty, unpadded string.\");\n        }\n        if (!values || (Object.getPrototypeOf(values) !== Object.prototype\n            && Object.getPrototypeOf(values) !== null) || Array.isArray(values))\n        {\n            throw new TypeError(\"Enum values must be a plain name-to-integer object.\");\n        }\n        const records = new Map();\n        for (const key of Object.keys(values))\n        {\n            const property = Object.getOwnPropertyDescriptor(values, key);\n            if (!key || Number.isFinite(Number(key)) || !Object.hasOwn(property, \"value\"))\n            {\n                throw new TypeError(\"Enum members must have nonnumeric names and data values.\");\n            }\n            uint32(property.value);\n            records.set(key, { name: key, value: property.value });\n        }\n        const ordered = [];\n        if (definition.members !== undefined && !Array.isArray(definition.members))\n        {\n            throw new TypeError(\"Enum members metadata must be an array.\");\n        }\n        for (const member of definition.members || [])\n        {\n            const record = records.get(member.name);\n            if (!record || record.value !== member.value)\n            {\n                throw new TypeError(\"Enum member metadata must agree with the named-value object.\");\n            }\n            if (member.description !== undefined)\n            {\n                if (typeof member.description !== \"string\") throw new TypeError(\"Enum descriptions must be strings.\");\n                record.description = member.description;\n            }\n            ordered.push(Object.freeze(record));\n            records.delete(member.name);\n        }\n        for (const record of records.values()) ordered.push(Object.freeze(record));\n        const info = { name, type: values, members: Object.freeze(ordered) };\n        // Native VarChooser names are exposed labels, not necessarily C++ enum\n        // identifiers. Its ordered selection may omit sentinels and aliases.\n        if (definition.chooser !== undefined)\n        {\n            if (!Array.isArray(definition.chooser)) throw new TypeError(\"Enum chooser must be an array.\");\n            const allowed = new Set(ordered.map(member => uint32(member.value)));\n            info.chooser = Object.freeze(definition.chooser.map(member => {\n                if (typeof member.name !== \"string\" || !member.name || !allowed.has(uint32(member.value)))\n                {\n                    throw new TypeError(\"Enum chooser entries must name declared enum values.\");\n                }\n                const entry = { name: member.name, value: member.value };\n                if (member.description !== undefined)\n                {\n                    if (typeof member.description !== \"string\") throw new TypeError(\"Enum descriptions must be strings.\");\n                    entry.description = member.description;\n                }\n                return Object.freeze(entry);\n            }));\n        }\n        for (const key of [\"source\", \"family\", \"line\", \"exposure\", \"exposedName\", \"chooserSource\"])\n        {\n            if (definition[key] === undefined) continue;\n            if (key === \"line\" || key === \"exposure\")\n            {\n                if (!Number.isInteger(definition[key]) || definition[key] < 0)\n                {\n                    throw new TypeError(`Enum ${key} must be a nonnegative integer.`);\n                }\n            }\n            else if (typeof definition[key] !== \"string\") throw new TypeError(`Enum ${key} must be a string.`);\n            info[key] = definition[key];\n        }\n        const existing = this.#byName.get(name);\n        if (existing)\n        {\n            if (existing.type !== values || JSON.stringify({ ...existing, type: null }) !== JSON.stringify({ ...info, type: null }))\n            {\n                throw new TypeError(`Enum registration conflicts with ${name}.`);\n            }\n            return values;\n        }\n        if (this.#byObject.has(values)) throw new TypeError(\"Enum object already has a canonical name.\");\n        Object.freeze(values);\n        this.#byName.set(name, Object.freeze(info));\n        this.#byObject.set(values, name);\n        return values;\n    }\n\n    /** Reports whether an enum name is registered without resolving a domain. */\n    HasEnum(name)\n    {\n        return this.#byName.has(name);\n    }\n\n    /** Returns the registered read-only named-value object. */\n    GetEnum(name)\n    {\n        return this.GetEnumInfo(name).type;\n    }\n\n    /** Returns ordered chooser metadata, descriptions and donor provenance. */\n    GetEnumInfo(name)\n    {\n        const info = this.#byName.get(name);\n        if (!info) throw new ReferenceError(`Enum is not registered: ${name}`);\n        return info;\n    }\n\n    /** Returns an object's canonical registration name, or null. */\n    GetEnumName(values)\n    {\n        return this.#byObject.get(values) || null;\n    }\n\n    /** Joins every exact alias in chooser order, matching GetEnumValueName_Impl. */\n    GetNameFromValue(name, value)\n    {\n        const info = this.GetEnumInfo(name);\n        const members = info.chooser ?? info.members;\n        const bits = uint32(value);\n        const matches = members.filter(member => uint32(member.value) === bits);\n        if (!matches.length) throw new RangeError(`Enum value not found in ${name}: ${value}`);\n        return matches.map(member => member.name).join(\" | \");\n    }\n\n    /** Returns the first exact mask name, or every contained nonzero chooser entry. */\n    GetNameFromBitmask(name, mask)\n    {\n        const info = this.GetEnumInfo(name);\n        const members = info.chooser ?? info.members;\n        const bits = uint32(mask);\n        const exact = members.find(member => uint32(member.value) === bits);\n        if (exact) return exact.name;\n        // Carbon permits unknown remaining bits and includes contained composites.\n        const matches = members.filter(member => {\n            const value = uint32(member.value);\n            return value !== 0 && ((value & bits) >>> 0) === value;\n        });\n        if (!matches.length) throw new RangeError(`Enum value not found in ${name}: ${mask}`);\n        return matches.map(member => member.name).join(\" | \");\n    }\n}\n\nfunction uint32(value)\n{\n    // Python accepts signed int; JS additionally accepts its unsigned spelling.\n    if (!Number.isInteger(value) || value < -2147483648 || value > 4294967295)\n    {\n        throw new TypeError(\"Enum values must be signed or unsigned 32-bit integers.\");\n    }\n    return value >>> 0;\n}\n\n/** Shared enum storage used by Blue and schema without importing either facade. */\nexport const blueEnums = new CjsBlueEnumRegistry();\n"],"names":["EnumRegistrationType","Object","freeze","ENUM_REG_VALUES_ON_MODULE","ENUM_REG_ENUM_OBJECT_ON_MODULE","CjsBlueEnumRegistry","Map","WeakMap","RegisterEnum","name","values","definition","trim","TypeError","getPrototypeOf","prototype","Array","isArray","records","key","keys","property","getOwnPropertyDescriptor","Number","isFinite","hasOwn","uint32","value","set","ordered","members","undefined","member","record","get","description","push","delete","info","type","chooser","allowed","Set","map","has","entry","isInteger","existing","JSON","stringify","HasEnum","GetEnum","GetEnumInfo","ReferenceError","GetEnumName","GetNameFromValue","bits","matches","filter","length","RangeError","join","GetNameFromBitmask","mask","exact","find","blueEnums"],"mappings":"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"}

package/dist/global/blue/index.js

@@ -1,2 +1,21 @@
 export { CjsScriptCallback } from './CjsScriptCallback.js';
+export { IBlueDynamicResourceConstructor } from './IBlueDynamicResourceConstructor.js';
+export { BeInfo } from './BeInfo.js';
+export { IBlueEvents } from './IBlueEvents.js';
+export { IVariableTicker } from './IVariableTicker.js';
+export { ICatchupTicks } from './ICatchupTicks.js';
+export { ISimTimeRebaseNotify } from './ISimTimeRebaseNotify.js';
+export { IBlueOS } from './IBlueOS.js';
+export { CjsBlueOS } from './CjsBlueOS.js';
+export { CcpDateTime } from './CcpDateTime.js';
+export { TimeAsDateTime, TimeAsDouble, TimeFromDateTime, TimeIsUTC } from './CcpTime.js';
+export { BlueResManQueue, IBlueResMan } from './IBlueResMan.js';
+export { IBlueResManNotifications } from './IBlueResManNotifications.js';
+export { IInitialize } from './IInitialize.js';
+export { IListNotify } from './IListNotify.js';
+export { INotify, IsMatch } from './INotify.js';
+export { CjsBluePaths } from './CjsBluePaths.js';
+export { IBluePaths } from './IBluePaths.js';
+export { blue } from './blue.js';
+export { CjsBlueEnumRegistry, EnumRegistrationType } from './enums/CjsBlueEnumRegistry.js';
 //# sourceMappingURL=index.js.map

package/dist/global/blue/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;"}

package/dist/global/blue/registerTrinityEnums.js

@@ -0,0 +1,43 @@
+import { blue } from './blue.js';
+import { EnumRegistrationType } from './enums/CjsBlueEnumRegistry.js';
+import { ReflectionMode } from '../consts/graphics/trinityEnums.js';
+import { Tr2Lod } from '../consts/trinity.js';
+
+// Source: trinity/trinity/Eve/EveEntity.h:9, trinity/trinity/Eve/EveEntity_Blue.cpp:10,
+//   trinity/trinity/Resources/Tr2LodResource.h:7
+// Shared constants stay dependency-free. Consumers import this registration
+// module explicitly; importing Blue alone does not load Trinity registrations.
+blue.enums.RegisterEnum("trinity.EntityComponents.ReflectionMode", ReflectionMode, {
+  source: "trinity/trinity/Eve/EveEntity.h",
+  family: "trinity",
+  line: 9,
+  exposedName: "ReflectionModeType",
+  exposure: EnumRegistrationType.ENUM_REG_ENUM_OBJECT_ON_MODULE,
+  chooserSource: "trinity/trinity/Eve/EveEntity_Blue.cpp:10",
+  chooser: [{
+    name: "Never",
+    value: ReflectionMode.REFLECT_NEVER,
+    description: "Never render into the reflection map"
+  }, {
+    name: "LowMediumAndHigh",
+    value: ReflectionMode.REFLECT_LOW_MEDIUM_HIGH,
+    description: "Render into the reflection map when reflection settings is set to low, medium or high"
+  }, {
+    name: "MediumAndHigh",
+    value: ReflectionMode.REFLECT_MEDIUM_AND_HIGH,
+    description: "Render into the reflection map when reflection settings is set to medium or high"
+  }, {
+    name: "High",
+    value: ReflectionMode.REFLECT_HIGH,
+    description: "Only render into the reflection map when reflection settings is set to high"
+  }]
+});
+
+// No native chooser or BLUE_REGISTER_ENUM was found for Tr2Lod in Trinity.
+// Register its declared identifiers without inventing Python exposure metadata.
+blue.enums.RegisterEnum("trinity.Tr2Lod", Tr2Lod, {
+  source: "trinity/trinity/Resources/Tr2LodResource.h",
+  family: "trinity",
+  line: 7
+});
+//# sourceMappingURL=registerTrinityEnums.js.map

package/dist/global/blue/registerTrinityEnums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTrinityEnums.js","sources":["../../../../src/global/blue/registerTrinityEnums.js"],"sourcesContent":["// Source: trinity/trinity/Eve/EveEntity.h:9, trinity/trinity/Eve/EveEntity_Blue.cpp:10,\r\n//   trinity/trinity/Resources/Tr2LodResource.h:7\r\n// Shared constants stay dependency-free. Consumers import this registration\r\n// module explicitly; importing Blue alone does not load Trinity registrations.\r\nimport { blue } from \"./blue.js\";\r\nimport { EnumRegistrationType } from \"./enums/CjsBlueEnumRegistry.js\";\r\nimport { ReflectionMode } from \"../consts/graphics/trinityEnums.js\";\r\nimport { Tr2Lod } from \"../consts/trinity.js\";\r\n\r\nblue.enums.RegisterEnum(\"trinity.EntityComponents.ReflectionMode\", ReflectionMode, {\r\n  source: \"trinity/trinity/Eve/EveEntity.h\", family: \"trinity\", line: 9,\r\n  exposedName: \"ReflectionModeType\", exposure: EnumRegistrationType.ENUM_REG_ENUM_OBJECT_ON_MODULE,\r\n  chooserSource: \"trinity/trinity/Eve/EveEntity_Blue.cpp:10\",\r\n  chooser: [\r\n    { name: \"Never\", value: ReflectionMode.REFLECT_NEVER, description: \"Never render into the reflection map\" },\r\n    { name: \"LowMediumAndHigh\", value: ReflectionMode.REFLECT_LOW_MEDIUM_HIGH, description: \"Render into the reflection map when reflection settings is set to low, medium or high\" },\r\n    { name: \"MediumAndHigh\", value: ReflectionMode.REFLECT_MEDIUM_AND_HIGH, description: \"Render into the reflection map when reflection settings is set to medium or high\" },\r\n    { name: \"High\", value: ReflectionMode.REFLECT_HIGH, description: \"Only render into the reflection map when reflection settings is set to high\" }\r\n  ]\r\n});\r\n\r\n// No native chooser or BLUE_REGISTER_ENUM was found for Tr2Lod in Trinity.\r\n// Register its declared identifiers without inventing Python exposure metadata.\r\nblue.enums.RegisterEnum(\"trinity.Tr2Lod\", Tr2Lod, {\r\n  source: \"trinity/trinity/Resources/Tr2LodResource.h\", family: \"trinity\", line: 7\r\n});\r\n"],"names":["blue","enums","RegisterEnum","ReflectionMode","source","family","line","exposedName","exposure","EnumRegistrationType","ENUM_REG_ENUM_OBJECT_ON_MODULE","chooserSource","chooser","name","value","REFLECT_NEVER","description","REFLECT_LOW_MEDIUM_HIGH","REFLECT_MEDIUM_AND_HIGH","REFLECT_HIGH","Tr2Lod"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AAMAA,IAAI,CAACC,KAAK,CAACC,YAAY,CAAC,yCAAyC,EAAEC,cAAc,EAAE;AACjFC,EAAAA,MAAM,EAAE,iCAAiC;AAAEC,EAAAA,MAAM,EAAE,SAAS;AAAEC,EAAAA,IAAI,EAAE,CAAC;AACrEC,EAAAA,WAAW,EAAE,oBAAoB;EAAEC,QAAQ,EAAEC,oBAAoB,CAACC,8BAA8B;AAChGC,EAAAA,aAAa,EAAE,2CAA2C;AAC1DC,EAAAA,OAAO,EAAE,CACP;AAAEC,IAAAA,IAAI,EAAE,OAAO;IAAEC,KAAK,EAAEX,cAAc,CAACY,aAAa;AAAEC,IAAAA,WAAW,EAAE;AAAuC,GAAC,EAC3G;AAAEH,IAAAA,IAAI,EAAE,kBAAkB;IAAEC,KAAK,EAAEX,cAAc,CAACc,uBAAuB;AAAED,IAAAA,WAAW,EAAE;AAAwF,GAAC,EACjL;AAAEH,IAAAA,IAAI,EAAE,eAAe;IAAEC,KAAK,EAAEX,cAAc,CAACe,uBAAuB;AAAEF,IAAAA,WAAW,EAAE;AAAmF,GAAC,EACzK;AAAEH,IAAAA,IAAI,EAAE,MAAM;IAAEC,KAAK,EAAEX,cAAc,CAACgB,YAAY;AAAEH,IAAAA,WAAW,EAAE;GAA+E;AAEpJ,CAAC,CAAC;;AAEF;AACA;AACAhB,IAAI,CAACC,KAAK,CAACC,YAAY,CAAC,gBAAgB,EAAEkB,MAAM,EAAE;AAChDhB,EAAAA,MAAM,EAAE,4CAA4C;AAAEC,EAAAA,MAAM,EAAE,SAAS;AAAEC,EAAAA,IAAI,EAAE;AACjF,CAAC,CAAC"}

package/dist/global/compose/abstract.js

@@ -0,0 +1,81 @@
+// Installs the body of a method that an implementer must supply.
+//
+// The throwing body was previously written by hand at every site - four video
+// decoder interfaces and the interface roots in `global/contracts` carry twenty
+// or so identical `throw new Error("X.Y must be implemented.")` lines, each one
+// repeating a class name that a rename would silently desynchronise, and each
+// one paired with an `@impl.abstract` marker that has to agree with it.
+//
+// `@impl.abstract` still DESCRIBES the method; this INSTALLS it. Both are
+// applied, which is the split `CjsSchema.compose` exists to keep.
+
+/**
+ * Builds the message for a method that was reached without an implementation.
+ *
+ * Two names, because they answer different questions: the declaring class says
+ * what the interface is, and the runtime class says who failed to honour it.
+ * When they match, nothing real is installed behind the interface at all, and
+ * saying so once is clearer than saying it twice.
+ *
+ * Names come from the registered class name rather than `constructor.name`,
+ * which a minifying bundler rewrites - a shipped consumer would otherwise read
+ * `e.GetResource must be implemented`.
+ */
+function AbstractMessage(getClassName, instance, declaringName, methodName) {
+  const runtimeName = instance?.constructor ? getClassName(instance.constructor) || instance.constructor.name || null : null;
+  const declaring = declaringName || runtimeName || "<unregistered>";
+  if (!runtimeName || runtimeName === declaring) {
+    return `${declaring}.${methodName} must be implemented.`;
+  }
+  return `${runtimeName} does not implement ${declaring}.${methodName}.`;
+}
+
+/**
+ * Creates the `@compose.abstract` method decorator.
+ *
+ * @param {(Constructor: Function) => string|null} getClassName Registered-name resolver.
+ * @returns {Function} The decorator.
+ */
+function composeAbstractDecorator(getClassName) {
+  return function (value, context) {
+    // The 2022 decorator form: a method decorator receives the function and
+    // a context carrying its name and kind.
+    if (context && typeof context === "object" && "kind" in context) {
+      if (context.kind !== "method") {
+        throw new TypeError("compose.abstract only supports methods.");
+      }
+      const methodName = String(context.name);
+      let declaringName = null;
+      context.addInitializer?.(function () {
+        // Runs with `this` as the instance (or the class, for a static),
+        // which is the first moment the declaring class is knowable.
+        const Constructor = typeof this === "function" ? this : this?.constructor;
+        declaringName = declaringName || (Constructor ? getClassName(Constructor) || Constructor.name : null);
+      });
+      return function (...args) {
+        throw new Error(AbstractMessage(getClassName, this, declaringName, methodName));
+      };
+    }
+
+    // The legacy form used by `CjsSchema.decorateMethod`, which hands over a
+    // prototype and a name rather than a function and a context.
+    const prototype = value;
+    const methodName = String(context);
+    if (!prototype || typeof prototype !== "object") {
+      throw new TypeError("compose.abstract only supports methods.");
+    }
+    const declaringName = prototype.constructor ? getClassName(prototype.constructor) || prototype.constructor.name : null;
+    Object.defineProperty(prototype, methodName, {
+      configurable: true,
+      writable: true,
+      enumerable: false,
+      value: function (...args) {
+        throw new Error(AbstractMessage(getClassName, this, declaringName, methodName));
+      }
+    });
+    return undefined;
+  };
+}
+
+export { composeAbstractDecorator };
+//# sourceMappingURL=abstract.js.map

package/dist/global/compose/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sources":["../../../../src/global/compose/abstract.js"],"sourcesContent":["// Installs the body of a method that an implementer must supply.\n//\n// The throwing body was previously written by hand at every site - four video\n// decoder interfaces and the interface roots in `global/contracts` carry twenty\n// or so identical `throw new Error(\"X.Y must be implemented.\")` lines, each one\n// repeating a class name that a rename would silently desynchronise, and each\n// one paired with an `@impl.abstract` marker that has to agree with it.\n//\n// `@impl.abstract` still DESCRIBES the method; this INSTALLS it. Both are\n// applied, which is the split `CjsSchema.compose` exists to keep.\n\n/**\n * Builds the message for a method that was reached without an implementation.\n *\n * Two names, because they answer different questions: the declaring class says\n * what the interface is, and the runtime class says who failed to honour it.\n * When they match, nothing real is installed behind the interface at all, and\n * saying so once is clearer than saying it twice.\n *\n * Names come from the registered class name rather than `constructor.name`,\n * which a minifying bundler rewrites - a shipped consumer would otherwise read\n * `e.GetResource must be implemented`.\n */\nfunction AbstractMessage(getClassName, instance, declaringName, methodName)\n{\n    const runtimeName = instance?.constructor\n        ? (getClassName(instance.constructor) || instance.constructor.name || null)\n        : null;\n    const declaring = declaringName || runtimeName || \"<unregistered>\";\n\n    if (!runtimeName || runtimeName === declaring)\n    {\n        return `${declaring}.${methodName} must be implemented.`;\n    }\n    return `${runtimeName} does not implement ${declaring}.${methodName}.`;\n}\n\n/**\n * Creates the `@compose.abstract` method decorator.\n *\n * @param {(Constructor: Function) => string|null} getClassName Registered-name resolver.\n * @returns {Function} The decorator.\n */\nexport function composeAbstractDecorator(getClassName)\n{\n    return function (value, context)\n    {\n        // The 2022 decorator form: a method decorator receives the function and\n        // a context carrying its name and kind.\n        if (context && typeof context === \"object\" && \"kind\" in context)\n        {\n            if (context.kind !== \"method\")\n            {\n                throw new TypeError(\"compose.abstract only supports methods.\");\n            }\n            const methodName = String(context.name);\n            let declaringName = null;\n            context.addInitializer?.(function ()\n            {\n                // Runs with `this` as the instance (or the class, for a static),\n                // which is the first moment the declaring class is knowable.\n                const Constructor = typeof this === \"function\" ? this : this?.constructor;\n                declaringName = declaringName\n                    || (Constructor ? getClassName(Constructor) || Constructor.name : null);\n            });\n            return function (...args)\n            {\n                throw new Error(AbstractMessage(getClassName, this, declaringName, methodName));\n            };\n        }\n\n        // The legacy form used by `CjsSchema.decorateMethod`, which hands over a\n        // prototype and a name rather than a function and a context.\n        const prototype = value;\n        const methodName = String(context);\n        if (!prototype || typeof prototype !== \"object\")\n        {\n            throw new TypeError(\"compose.abstract only supports methods.\");\n        }\n        const declaringName = prototype.constructor\n            ? getClassName(prototype.constructor) || prototype.constructor.name\n            : null;\n        Object.defineProperty(prototype, methodName, {\n            configurable: true,\n            writable: true,\n            enumerable: false,\n            value: function (...args)\n            {\n                throw new Error(AbstractMessage(getClassName, this, declaringName, methodName));\n            }\n        });\n        return undefined;\n    };\n}\n"],"names":["AbstractMessage","getClassName","instance","declaringName","methodName","runtimeName","constructor","name","declaring","composeAbstractDecorator","value","context","kind","TypeError","String","addInitializer","Constructor","args","Error","prototype","Object","defineProperty","configurable","writable","enumerable","undefined"],"mappings":"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"}