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

package/dist/global/blue/BlueClasses.js

@@ -0,0 +1,200 @@
+import { impl, CjsSchema, carbon } from '#schema';
+import { IBlueClasses } from './IBlueClasses.js';
+
+// Source: blueexposure/BlueClasses.h
+// Source: blueexposure/BlueClasses.cpp
+// Source: blueexposure/include/BlueTypes.h:409-419 (Be::ClassRegistration)
+//
+// The registry behind `blue.classes` (`BeClasses`).
+//
+// ONE TABLE, NOT TWO. `CjsSchema` already keeps the by-name constructor table
+// (`SetConstructor`/`GetConstructor`) and fills it for every class it defines;
+// it currently does four or five Carbon jobs at once (ClassInfo, BeClasses,
+// RTTI, the copier, the exposure macros), and its class registry is
+// BeClasses' job (operator, 2026-09-22; /docs/architecture/blue-service-ownership.md).
+// Until that splits out, this class is the Carbon-named face over the same table, so a
+// class registered either way is found either way. A class with no schema
+// (HostBitmap, for one) registers here.
+//
+// It answers truthfully
+// before anything is composed - an empty registry finds nothing, which is what
+// Carbon returns for a class nobody registered - so the slot holds this class
+// directly rather than a throwing interface.
+//
+// A REGISTRATION IS { name, type, createFn, flags }. `type`, `createFn` and
+// `flags` are Carbon's `mType`, `mCreateFn` and `mFlags`. In JavaScript a
+// class is its own type information, so `type` is the constructor itself:
+// `GetClassRegistration("X").type` is how a caller reaches a class's statics
+// or subclasses it without importing it. `name` is the class name Carbon's
+// `ClassInfo` carries; it is given explicitly and never read from
+// `type.name`, because a minifier renames classes and the lookup would
+// then silently miss in production.
+//
+// A CLASS ID IS THE CLASS NAME. Carbon's `Be::Clsid` is a GUID paired with a
+// module and name, and `FindClsid` already ignores the module ("we don't allow
+// name clashes between modules", BlueClasses.cpp:340-343). With no GUIDs to
+// carry, the name is the only identity there is.
+
+/** `BlueClasses` - the class registry `blue.classes` holds, per blueexposure/BlueClasses.cpp. */
+class BlueClasses extends IBlueClasses {
+  /** Carbon's `Be::ClassRegistration::Flags` (BlueTypes.h:415-418). */
+  static Flags = {
+    DISABLE_PYTHON_CONSTRUCTION: 1
+  };
+
+  /** Carbon's per-registration createFn and flags, where they differ from `new type()` and 0. */
+  _extras = new Map();
+
+  /**
+   * Register every entry of a table (BlueClasses.cpp:296-302).
+   *
+   * @param {Array<{name: string, type: Function, createFn?: Function, flags?: number}>} table Registrations.
+   */
+  RegisterClasses(table) {
+    for (const registration of table) {
+      this._RegisterSingleClass(registration);
+    }
+  }
+
+  /**
+   * Remove every entry of a table (BlueClasses.cpp:304-310, 282-294).
+   *
+   * @param {Array<{name: string}>} table Registrations to remove.
+   */
+  UnregisterClasses(table) {
+    for (const registration of table) {
+      this._extras.delete(registration.name);
+      CjsSchema.DeleteConstructor(registration.name);
+    }
+  }
+
+  /**
+   * The registration for a class id, or null (BlueClasses.cpp:331-336).
+   *
+   * @param {string} clsid Class id, which is the class name.
+   * @returns {{name: string, type: Function, createFn: Function, flags: number}|null} Registration.
+   */
+  GetClassRegistration(clsid) {
+    const type = CjsSchema.GetConstructor(clsid);
+    if (!type) return null;
+    const extras = this._extras.get(clsid);
+    return {
+      name: clsid,
+      type,
+      createFn: extras?.createFn ?? (() => new type()),
+      flags: extras?.flags ?? 0
+    };
+  }
+
+  /**
+   * The class id registered under a name, or null (BlueClasses.cpp:355-364).
+   *
+   * @param {string} name Class name.
+   * @returns {string|null} Class id.
+   */
+  FindClsid(name) {
+    return CjsSchema.GetConstructor(name) ? name : null;
+  }
+
+  /**
+   * A new instance of the class with this id, or null (BlueClasses.cpp:429-445).
+   *
+   * @param {string} clsid Class id, which is the class name.
+   * @returns {object|null} New instance.
+   */
+  CreateInstance(clsid) {
+    const registration = this.GetClassRegistration(clsid);
+    return registration ? registration.createFn() : null;
+  }
+
+  /**
+   * A new instance of the class registered under a name, or null (BlueClasses.cpp:448-464).
+   *
+   * @param {string} className Class name.
+   * @returns {object|null} New instance.
+   */
+  CreateInstanceFromName(className) {
+    return this.CreateInstance(className);
+  }
+
+  /** Register one entry, refusing a name already taken (BlueClasses.cpp:266-280). */
+  _RegisterSingleClass(registration) {
+    const {
+      name,
+      type
+    } = registration;
+    if (CjsSchema.GetConstructor(name)) {
+      // Carbon: CCP_LOGERR("Class %s.%s is already registered!") and keeps the
+      // first registration (BlueClasses.cpp:272-276).
+      return;
+    }
+    CjsSchema.SetConstructor(name, type);
+    if (registration.createFn || registration.flags) {
+      this._extras.set(name, {
+        createFn: registration.createFn,
+        flags: registration.flags ?? 0
+      });
+    }
+  }
+  QueryThisInterface() {
+    throw new Error("BlueClasses.QueryThisInterface is not implemented");
+  }
+  FindVariable() {
+    throw new Error("BlueClasses.FindVariable is not implemented");
+  }
+  UpdateObjectCount() {
+    throw new Error("BlueClasses.UpdateObjectCount is not implemented");
+  }
+  CopyTo() {
+    throw new Error("BlueClasses.CopyTo is not implemented");
+  }
+  CloneTo() {
+    throw new Error("BlueClasses.CloneTo is not implemented");
+  }
+  ProcessPendingDeletes() {
+    throw new Error("BlueClasses.ProcessPendingDeletes is not implemented");
+  }
+  ProcessAllPendingDeletes() {
+    throw new Error("BlueClasses.ProcessAllPendingDeletes is not implemented");
+  }
+  SetPendingDeletesEnabled() {
+    throw new Error("BlueClasses.SetPendingDeletesEnabled is not implemented");
+  }
+  IsPendingDeletesEnabled() {
+    throw new Error("BlueClasses.IsPendingDeletesEnabled is not implemented");
+  }
+  RegisterThunker() {
+    throw new Error("BlueClasses.RegisterThunker is not implemented");
+  }
+  GetRtti() {
+    throw new Error("BlueClasses.GetRtti is not implemented");
+  }
+}
+const NOT_YET = impl.reason("No consumer yet; ported when one needs it.");
+CjsSchema.define(BlueClasses, {
+  className: "BlueClasses",
+  family: "blue",
+  fields: {},
+  methods: {
+    RegisterClasses: [carbon.method, impl.adapted, impl.reason("Carbon walks a null-terminated array; JavaScript takes any iterable of registrations.")],
+    UnregisterClasses: [carbon.method, impl.implemented],
+    GetClassRegistration: [carbon.method, impl.adapted, impl.reason("A class id is the class name: there are no GUIDs to carry, and Carbon already forbids name clashes between modules.")],
+    FindClsid: [carbon.method, impl.adapted, impl.reason("Carbon's out-parameter overload and its module argument collapse: the id is the name, and Carbon ignores the module.")],
+    CreateInstance: [carbon.method, impl.adapted, impl.reason("Carbon returns bool and writes the instance through ppv after a QueryInterface for riid; JavaScript returns the instance or null, with no interface id to query.")],
+    CreateInstanceFromName: [carbon.method, impl.adapted, impl.reason("Carbon returns bool and writes the instance through ppv after a QueryInterface for riid; JavaScript returns the instance or null, with no interface id to query.")],
+    QueryThisInterface: [carbon.method, impl.notImplemented, NOT_YET],
+    FindVariable: [carbon.method, impl.notImplemented, NOT_YET],
+    UpdateObjectCount: [carbon.method, impl.notImplemented, NOT_YET],
+    CopyTo: [carbon.method, impl.notImplemented, NOT_YET],
+    CloneTo: [carbon.method, impl.notImplemented, NOT_YET],
+    ProcessPendingDeletes: [carbon.method, impl.notImplemented, NOT_YET],
+    ProcessAllPendingDeletes: [carbon.method, impl.notImplemented, NOT_YET],
+    SetPendingDeletesEnabled: [carbon.method, impl.notImplemented, NOT_YET],
+    IsPendingDeletesEnabled: [carbon.method, impl.notImplemented, NOT_YET],
+    RegisterThunker: [carbon.method, impl.notImplemented, NOT_YET],
+    GetRtti: [carbon.method, impl.notImplemented, NOT_YET]
+  }
+});
+
+export { BlueClasses };
+//# sourceMappingURL=BlueClasses.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlueClasses.js","sources":["../../../../src/global/blue/BlueClasses.js"],"sourcesContent":["// Source: blueexposure/BlueClasses.h\n// Source: blueexposure/BlueClasses.cpp\n// Source: blueexposure/include/BlueTypes.h:409-419 (Be::ClassRegistration)\n//\n// The registry behind `blue.classes` (`BeClasses`).\n//\n// ONE TABLE, NOT TWO. `CjsSchema` already keeps the by-name constructor table\n// (`SetConstructor`/`GetConstructor`) and fills it for every class it defines;\n// it currently does four or five Carbon jobs at once (ClassInfo, BeClasses,\n// RTTI, the copier, the exposure macros), and its class registry is\n// BeClasses' job (operator, 2026-09-22; /docs/architecture/blue-service-ownership.md).\n// Until that splits out, this class is the Carbon-named face over the same table, so a\n// class registered either way is found either way. A class with no schema\n// (HostBitmap, for one) registers here.\n//\n// It answers truthfully\n// before anything is composed - an empty registry finds nothing, which is what\n// Carbon returns for a class nobody registered - so the slot holds this class\n// directly rather than a throwing interface.\n//\n// A REGISTRATION IS { name, type, createFn, flags }. `type`, `createFn` and\n// `flags` are Carbon's `mType`, `mCreateFn` and `mFlags`. In JavaScript a\n// class is its own type information, so `type` is the constructor itself:\n// `GetClassRegistration(\"X\").type` is how a caller reaches a class's statics\n// or subclasses it without importing it. `name` is the class name Carbon's\n// `ClassInfo` carries; it is given explicitly and never read from\n// `type.name`, because a minifier renames classes and the lookup would\n// then silently miss in production.\n//\n// A CLASS ID IS THE CLASS NAME. Carbon's `Be::Clsid` is a GUID paired with a\n// module and name, and `FindClsid` already ignores the module (\"we don't allow\n// name clashes between modules\", BlueClasses.cpp:340-343). With no GUIDs to\n// carry, the name is the only identity there is.\nimport { CjsSchema, carbon, impl } from \"#schema\";\nimport { IBlueClasses } from \"./IBlueClasses.js\";\n\n\n/** `BlueClasses` - the class registry `blue.classes` holds, per blueexposure/BlueClasses.cpp. */\nexport class BlueClasses extends IBlueClasses\n{\n\n  /** Carbon's `Be::ClassRegistration::Flags` (BlueTypes.h:415-418). */\n  static Flags = {\n    DISABLE_PYTHON_CONSTRUCTION: 1\n  };\n\n  /** Carbon's per-registration createFn and flags, where they differ from `new type()` and 0. */\n  _extras = new Map();\n\n  /**\n   * Register every entry of a table (BlueClasses.cpp:296-302).\n   *\n   * @param {Array<{name: string, type: Function, createFn?: Function, flags?: number}>} table Registrations.\n   */\n  RegisterClasses(table)\n  {\n    for (const registration of table)\n    {\n      this._RegisterSingleClass(registration);\n    }\n  }\n\n  /**\n   * Remove every entry of a table (BlueClasses.cpp:304-310, 282-294).\n   *\n   * @param {Array<{name: string}>} table Registrations to remove.\n   */\n  UnregisterClasses(table)\n  {\n    for (const registration of table)\n    {\n      this._extras.delete(registration.name);\n      CjsSchema.DeleteConstructor(registration.name);\n    }\n  }\n\n  /**\n   * The registration for a class id, or null (BlueClasses.cpp:331-336).\n   *\n   * @param {string} clsid Class id, which is the class name.\n   * @returns {{name: string, type: Function, createFn: Function, flags: number}|null} Registration.\n   */\n  GetClassRegistration(clsid)\n  {\n    const type = CjsSchema.GetConstructor(clsid);\n\n    if (!type) return null;\n\n    const extras = this._extras.get(clsid);\n\n    return {\n      name: clsid,\n      type,\n      createFn: extras?.createFn ?? (() => new type()),\n      flags: extras?.flags ?? 0\n    };\n  }\n\n  /**\n   * The class id registered under a name, or null (BlueClasses.cpp:355-364).\n   *\n   * @param {string} name Class name.\n   * @returns {string|null} Class id.\n   */\n  FindClsid(name)\n  {\n    return CjsSchema.GetConstructor(name) ? name : null;\n  }\n\n  /**\n   * A new instance of the class with this id, or null (BlueClasses.cpp:429-445).\n   *\n   * @param {string} clsid Class id, which is the class name.\n   * @returns {object|null} New instance.\n   */\n  CreateInstance(clsid)\n  {\n    const registration = this.GetClassRegistration(clsid);\n\n    return registration ? registration.createFn() : null;\n  }\n\n  /**\n   * A new instance of the class registered under a name, or null (BlueClasses.cpp:448-464).\n   *\n   * @param {string} className Class name.\n   * @returns {object|null} New instance.\n   */\n  CreateInstanceFromName(className)\n  {\n    return this.CreateInstance(className);\n  }\n\n  /** Register one entry, refusing a name already taken (BlueClasses.cpp:266-280). */\n  _RegisterSingleClass(registration)\n  {\n    const { name, type } = registration;\n\n    if (CjsSchema.GetConstructor(name))\n    {\n      // Carbon: CCP_LOGERR(\"Class %s.%s is already registered!\") and keeps the\n      // first registration (BlueClasses.cpp:272-276).\n      return;\n    }\n\n    CjsSchema.SetConstructor(name, type);\n\n    if (registration.createFn || registration.flags)\n    {\n      this._extras.set(name, { createFn: registration.createFn, flags: registration.flags ?? 0 });\n    }\n  }\n\n  QueryThisInterface() { throw new Error(\"BlueClasses.QueryThisInterface is not implemented\"); }\n\n  FindVariable() { throw new Error(\"BlueClasses.FindVariable is not implemented\"); }\n\n  UpdateObjectCount() { throw new Error(\"BlueClasses.UpdateObjectCount is not implemented\"); }\n\n  CopyTo() { throw new Error(\"BlueClasses.CopyTo is not implemented\"); }\n\n  CloneTo() { throw new Error(\"BlueClasses.CloneTo is not implemented\"); }\n\n  ProcessPendingDeletes() { throw new Error(\"BlueClasses.ProcessPendingDeletes is not implemented\"); }\n\n  ProcessAllPendingDeletes() { throw new Error(\"BlueClasses.ProcessAllPendingDeletes is not implemented\"); }\n\n  SetPendingDeletesEnabled() { throw new Error(\"BlueClasses.SetPendingDeletesEnabled is not implemented\"); }\n\n  IsPendingDeletesEnabled() { throw new Error(\"BlueClasses.IsPendingDeletesEnabled is not implemented\"); }\n\n  RegisterThunker() { throw new Error(\"BlueClasses.RegisterThunker is not implemented\"); }\n\n  GetRtti() { throw new Error(\"BlueClasses.GetRtti is not implemented\"); }\n\n}\n\nconst NOT_YET = impl.reason(\"No consumer yet; ported when one needs it.\");\n\nCjsSchema.define(BlueClasses, {\n  className: \"BlueClasses\",\n  family: \"blue\",\n  fields: {},\n  methods: {\n    RegisterClasses: [ carbon.method, impl.adapted, impl.reason(\"Carbon walks a null-terminated array; JavaScript takes any iterable of registrations.\") ],\n    UnregisterClasses: [ carbon.method, impl.implemented ],\n    GetClassRegistration: [ carbon.method, impl.adapted, impl.reason(\"A class id is the class name: there are no GUIDs to carry, and Carbon already forbids name clashes between modules.\") ],\n    FindClsid: [ carbon.method, impl.adapted, impl.reason(\"Carbon's out-parameter overload and its module argument collapse: the id is the name, and Carbon ignores the module.\") ],\n    CreateInstance: [ carbon.method, impl.adapted, impl.reason(\"Carbon returns bool and writes the instance through ppv after a QueryInterface for riid; JavaScript returns the instance or null, with no interface id to query.\") ],\n    CreateInstanceFromName: [ carbon.method, impl.adapted, impl.reason(\"Carbon returns bool and writes the instance through ppv after a QueryInterface for riid; JavaScript returns the instance or null, with no interface id to query.\") ],\n    QueryThisInterface: [ carbon.method, impl.notImplemented, NOT_YET ],\n    FindVariable: [ carbon.method, impl.notImplemented, NOT_YET ],\n    UpdateObjectCount: [ carbon.method, impl.notImplemented, NOT_YET ],\n    CopyTo: [ carbon.method, impl.notImplemented, NOT_YET ],\n    CloneTo: [ carbon.method, impl.notImplemented, NOT_YET ],\n    ProcessPendingDeletes: [ carbon.method, impl.notImplemented, NOT_YET ],\n    ProcessAllPendingDeletes: [ carbon.method, impl.notImplemented, NOT_YET ],\n    SetPendingDeletesEnabled: [ carbon.method, impl.notImplemented, NOT_YET ],\n    IsPendingDeletesEnabled: [ carbon.method, impl.notImplemented, NOT_YET ],\n    RegisterThunker: [ carbon.method, impl.notImplemented, NOT_YET ],\n    GetRtti: [ carbon.method, impl.notImplemented, NOT_YET ]\n  }\n});\n"],"names":["BlueClasses","IBlueClasses","Flags","DISABLE_PYTHON_CONSTRUCTION","_extras","Map","RegisterClasses","table","registration","_RegisterSingleClass","UnregisterClasses","delete","name","CjsSchema","DeleteConstructor","GetClassRegistration","clsid","type","GetConstructor","extras","get","createFn","flags","FindClsid","CreateInstance","CreateInstanceFromName","className","SetConstructor","set","QueryThisInterface","Error","FindVariable","UpdateObjectCount","CopyTo","CloneTo","ProcessPendingDeletes","ProcessAllPendingDeletes","SetPendingDeletesEnabled","IsPendingDeletesEnabled","RegisterThunker","GetRtti","NOT_YET","impl","reason","define","family","fields","methods","carbon","method","adapted","implemented","notImplemented"],"mappings":"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"}

package/dist/global/blue/IBlueClasses.js

@@ -0,0 +1,79 @@
+import { CjsSchema, compose, impl } from '#schema';
+
+// Source: blueexposure/include/IBlueClasses.h
+//
+// The class registry as its CONSUMERS see it. Carbon reaches it through its
+// own extern, `BeClasses` (`blueexposure/BlueClasses.cpp:28`), which is how a
+// subsystem builds an object it does not import: `BlackReader.cpp:347` creates
+// every loaded object through `BeClasses->CreateInstanceFromName`.
+//
+// That is also why it matters here. `resource` and `trinityal` are sibling
+// layers that may not import each other; both may import `blue`, so a class
+// one of them owns is reached by the other through this registry. A class
+// nobody registered is simply not found, and the caller fails at the call.
+
+/** `IBlueClasses` - class registration and creation by name, per blueexposure/include/IBlueClasses.h. */
+class IBlueClasses {
+  /** `RegisterClasses` - register every entry of a class-registration table. */
+  RegisterClasses(_table) {}
+
+  /** `UnregisterClasses` - remove every entry of a class-registration table. */
+  UnregisterClasses(_table) {}
+
+  /** `GetClassRegistration` - the registration for a class id, or null. */
+  GetClassRegistration(_clsid) {}
+
+  /** `FindClsid` - the class id registered under a name, or null. */
+  FindClsid(_name) {}
+
+  /** `CreateInstance` - a new instance of the class with this id, or null. */
+  CreateInstance(_clsid) {}
+
+  /** `CreateInstanceFromName` - a new instance of the class registered under this name, or null. */
+  CreateInstanceFromName(_className) {}
+
+  /** `QueryThisInterface` - cast an object to an interface it implements. */
+  QueryThisInterface(_self, _riid) {}
+
+  /** `FindVariable` - the exposed member entry for a name on a class type. */
+  FindVariable(_name, _type) {}
+
+  /** `UpdateObjectCount` - adjust the live and lock counts of an object's class. */
+  UpdateObjectCount(_obj, _inst, _lock) {}
+
+  /** `CopyTo` - deep-copy an object through its exposed members. */
+  CopyTo(_source) {}
+
+  /** `CloneTo` - clone an object through its exposed members. */
+  CloneTo(_source) {}
+
+  /** `ProcessPendingDeletes` - release objects whose deletion was deferred. */
+  ProcessPendingDeletes() {}
+
+  /** `ProcessAllPendingDeletes` - release every deferred deletion. */
+  ProcessAllPendingDeletes() {}
+
+  /** `SetPendingDeletesEnabled` - turn deferred deletion on or off. */
+  SetPendingDeletesEnabled(_enabled) {}
+
+  /** `IsPendingDeletesEnabled` - whether deletion is deferred. */
+  IsPendingDeletesEnabled() {}
+
+  /** `RegisterThunker` - register a script method-thunk table for an interface. */
+  RegisterThunker(_defs, _riid) {}
+
+  /** `GetRtti` - the runtime type information for a class type. */
+  GetRtti(_type) {}
+}
+for (const method of ["RegisterClasses", "UnregisterClasses", "GetClassRegistration", "FindClsid", "CreateInstance", "CreateInstanceFromName", "QueryThisInterface", "FindVariable", "UpdateObjectCount", "CopyTo", "CloneTo", "ProcessPendingDeletes", "ProcessAllPendingDeletes", "SetPendingDeletesEnabled", "IsPendingDeletesEnabled", "RegisterThunker", "GetRtti"]) {
+  CjsSchema.decorateMethod(IBlueClasses, method, compose.abstract, impl.abstract);
+}
+CjsSchema.define(IBlueClasses, {
+  className: "IBlueClasses",
+  carbon: "IBlueClasses",
+  family: "blue",
+  fields: {}
+});
+
+export { IBlueClasses };
+//# sourceMappingURL=IBlueClasses.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IBlueClasses.js","sources":["../../../../src/global/blue/IBlueClasses.js"],"sourcesContent":["// Source: blueexposure/include/IBlueClasses.h\n//\n// The class registry as its CONSUMERS see it. Carbon reaches it through its\n// own extern, `BeClasses` (`blueexposure/BlueClasses.cpp:28`), which is how a\n// subsystem builds an object it does not import: `BlackReader.cpp:347` creates\n// every loaded object through `BeClasses->CreateInstanceFromName`.\n//\n// That is also why it matters here. `resource` and `trinityal` are sibling\n// layers that may not import each other; both may import `blue`, so a class\n// one of them owns is reached by the other through this registry. A class\n// nobody registered is simply not found, and the caller fails at the call.\nimport { CjsSchema, compose, impl } from \"#schema\";\n\n/** `IBlueClasses` - class registration and creation by name, per blueexposure/include/IBlueClasses.h. */\nexport class IBlueClasses\n{\n  /** `RegisterClasses` - register every entry of a class-registration table. */\n  RegisterClasses(_table) {}\n\n  /** `UnregisterClasses` - remove every entry of a class-registration table. */\n  UnregisterClasses(_table) {}\n\n  /** `GetClassRegistration` - the registration for a class id, or null. */\n  GetClassRegistration(_clsid) {}\n\n  /** `FindClsid` - the class id registered under a name, or null. */\n  FindClsid(_name) {}\n\n  /** `CreateInstance` - a new instance of the class with this id, or null. */\n  CreateInstance(_clsid) {}\n\n  /** `CreateInstanceFromName` - a new instance of the class registered under this name, or null. */\n  CreateInstanceFromName(_className) {}\n\n  /** `QueryThisInterface` - cast an object to an interface it implements. */\n  QueryThisInterface(_self, _riid) {}\n\n  /** `FindVariable` - the exposed member entry for a name on a class type. */\n  FindVariable(_name, _type) {}\n\n  /** `UpdateObjectCount` - adjust the live and lock counts of an object's class. */\n  UpdateObjectCount(_obj, _inst, _lock) {}\n\n  /** `CopyTo` - deep-copy an object through its exposed members. */\n  CopyTo(_source) {}\n\n  /** `CloneTo` - clone an object through its exposed members. */\n  CloneTo(_source) {}\n\n  /** `ProcessPendingDeletes` - release objects whose deletion was deferred. */\n  ProcessPendingDeletes() {}\n\n  /** `ProcessAllPendingDeletes` - release every deferred deletion. */\n  ProcessAllPendingDeletes() {}\n\n  /** `SetPendingDeletesEnabled` - turn deferred deletion on or off. */\n  SetPendingDeletesEnabled(_enabled) {}\n\n  /** `IsPendingDeletesEnabled` - whether deletion is deferred. */\n  IsPendingDeletesEnabled() {}\n\n  /** `RegisterThunker` - register a script method-thunk table for an interface. */\n  RegisterThunker(_defs, _riid) {}\n\n  /** `GetRtti` - the runtime type information for a class type. */\n  GetRtti(_type) {}\n}\n\nfor (const method of [\n  \"RegisterClasses\", \"UnregisterClasses\", \"GetClassRegistration\", \"FindClsid\", \"CreateInstance\",\n  \"CreateInstanceFromName\", \"QueryThisInterface\", \"FindVariable\", \"UpdateObjectCount\", \"CopyTo\",\n  \"CloneTo\", \"ProcessPendingDeletes\", \"ProcessAllPendingDeletes\", \"SetPendingDeletesEnabled\",\n  \"IsPendingDeletesEnabled\", \"RegisterThunker\", \"GetRtti\"\n])\n{\n  CjsSchema.decorateMethod(IBlueClasses, method, compose.abstract, impl.abstract);\n}\n\nCjsSchema.define(IBlueClasses, { className: \"IBlueClasses\", carbon: \"IBlueClasses\", family: \"blue\", fields: {} });\n"],"names":["IBlueClasses","RegisterClasses","_table","UnregisterClasses","GetClassRegistration","_clsid","FindClsid","_name","CreateInstance","CreateInstanceFromName","_className","QueryThisInterface","_self","_riid","FindVariable","_type","UpdateObjectCount","_obj","_inst","_lock","CopyTo","_source","CloneTo","ProcessPendingDeletes","ProcessAllPendingDeletes","SetPendingDeletesEnabled","_enabled","IsPendingDeletesEnabled","RegisterThunker","_defs","GetRtti","method","CjsSchema","decorateMethod","compose","abstract","impl","define","className","carbon","family","fields"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,YAAY,CACzB;AACE;EACAC,eAAeA,CAACC,MAAM,EAAE,CAAC;;AAEzB;EACAC,iBAAiBA,CAACD,MAAM,EAAE,CAAC;;AAE3B;EACAE,oBAAoBA,CAACC,MAAM,EAAE,CAAC;;AAE9B;EACAC,SAASA,CAACC,KAAK,EAAE,CAAC;;AAElB;EACAC,cAAcA,CAACH,MAAM,EAAE,CAAC;;AAExB;EACAI,sBAAsBA,CAACC,UAAU,EAAE,CAAC;;AAEpC;AACAC,EAAAA,kBAAkBA,CAACC,KAAK,EAAEC,KAAK,EAAE,CAAC;;AAElC;AACAC,EAAAA,YAAYA,CAACP,KAAK,EAAEQ,KAAK,EAAE,CAAC;;AAE5B;AACAC,EAAAA,iBAAiBA,CAACC,IAAI,EAAEC,KAAK,EAAEC,KAAK,EAAE,CAAC;;AAEvC;EACAC,MAAMA,CAACC,OAAO,EAAE,CAAC;;AAEjB;EACAC,OAAOA,CAACD,OAAO,EAAE,CAAC;;AAElB;EACAE,qBAAqBA,GAAG,CAAC;;AAEzB;EACAC,wBAAwBA,GAAG,CAAC;;AAE5B;EACAC,wBAAwBA,CAACC,QAAQ,EAAE,CAAC;;AAEpC;EACAC,uBAAuBA,GAAG,CAAC;;AAE3B;AACAC,EAAAA,eAAeA,CAACC,KAAK,EAAEhB,KAAK,EAAE,CAAC;;AAE/B;EACAiB,OAAOA,CAACf,KAAK,EAAE,CAAC;AAClB;AAEA,KAAK,MAAMgB,MAAM,IAAI,CACnB,iBAAiB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,WAAW,EAAE,gBAAgB,EAC7F,wBAAwB,EAAE,oBAAoB,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAC7F,SAAS,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,0BAA0B,EAC1F,yBAAyB,EAAE,iBAAiB,EAAE,SAAS,CACxD,EACD;AACEC,EAAAA,SAAS,CAACC,cAAc,CAACjC,YAAY,EAAE+B,MAAM,EAAEG,OAAO,CAACC,QAAQ,EAAEC,IAAI,CAACD,QAAQ,CAAC;AACjF;AAEAH,SAAS,CAACK,MAAM,CAACrC,YAAY,EAAE;AAAEsC,EAAAA,SAAS,EAAE,cAAc;AAAEC,EAAAA,MAAM,EAAE,cAAc;AAAEC,EAAAA,MAAM,EAAE,MAAM;AAAEC,EAAAA,MAAM,EAAE;AAAG,CAAC,CAAC;;;;"}

package/dist/global/blue/IBlueDynamicResourceConstructor.js

@@ -16,8 +16,24 @@ import { CjsSchema, compose, impl } from '#schema';
 class IBlueDynamicResourceConstructor {
   /** `GetResource` - construct the resource this query describes. */
   GetResource(_query) {}
+
+  /**
+   * Whether the resource this constructor builds may stay in the cache once
+   * nothing holds it.
+   *
+   * Not Carbon: Carbon inserts every dynamic resource with
+   * `CACHING_NOT_ALLOWED` (`BlueResMan.cpp:233`) because it rebuilds from local
+   * disk. We pay a network fetch and a decode, so each constructor says what its
+   * resource costs to rebuild. The default is Carbon's.
+   *
+   * @returns {boolean} True to keep the resource cached after release.
+   */
+  IsCacheable() {
+    return false;
+  }
 }
 CjsSchema.decorateMethod(IBlueDynamicResourceConstructor, "GetResource", compose.abstract, impl.abstract);
+CjsSchema.decorateMethod(IBlueDynamicResourceConstructor, "IsCacheable", impl.custom);
 CjsSchema.define(IBlueDynamicResourceConstructor, {
   className: "IBlueDynamicResourceConstructor",
   carbon: "IBlueDynamicResourceConstructor",

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

@@ -1 +1 @@
-{"version":3,"file":"IBlueDynamicResourceConstructor.js","sources":["../../../../src/global/blue/IBlueDynamicResourceConstructor.js"],"sourcesContent":["// Source: blue/include/IBlueResMan.h:39-44\n//\n// The factory behind a `dynamic:/<name>/<query>` path. The manager knows\n// nothing about what it builds: the thing that knows registers itself, as\n// Carbon's procedural textures do from their own files -\n// `BeResMan->RegisterResourceConstructor( L\"gradient_1d\", this )`\n// (`Resources/Procedural/GradientTexture.cpp:35`) and `L\"color\"`\n// (`SolidColorTexture.cpp:21`).\n//\n// Declared beside IBlueResMan in Carbon's one header; here it takes its own\n// file, because a class is found by its own name.\nimport { CjsSchema, compose, impl } from \"#schema\";\n\n/** `IBlueDynamicResourceConstructor` - builds a resource for a `dynamic:/<name>` path. */\nexport class IBlueDynamicResourceConstructor\n{\n  /** `GetResource` - construct the resource this query describes. */\n  GetResource(_query) {}\n}\n\nCjsSchema.decorateMethod(IBlueDynamicResourceConstructor, \"GetResource\", compose.abstract, impl.abstract);\nCjsSchema.define(IBlueDynamicResourceConstructor, {\n  className: \"IBlueDynamicResourceConstructor\", carbon: \"IBlueDynamicResourceConstructor\", family: \"blue\", fields: {}\n});\n"],"names":["IBlueDynamicResourceConstructor","GetResource","_query","CjsSchema","decorateMethod","compose","abstract","impl","define","className","carbon","family","fields"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,+BAA+B,CAC5C;AACE;EACAC,WAAWA,CAACC,MAAM,EAAE,CAAC;AACvB;AAEAC,SAAS,CAACC,cAAc,CAACJ,+BAA+B,EAAE,aAAa,EAAEK,OAAO,CAACC,QAAQ,EAAEC,IAAI,CAACD,QAAQ,CAAC;AACzGH,SAAS,CAACK,MAAM,CAACR,+BAA+B,EAAE;AAChDS,EAAAA,SAAS,EAAE,iCAAiC;AAAEC,EAAAA,MAAM,EAAE,iCAAiC;AAAEC,EAAAA,MAAM,EAAE,MAAM;AAAEC,EAAAA,MAAM,EAAE;AACnH,CAAC,CAAC;;;;"}
+{"version":3,"file":"IBlueDynamicResourceConstructor.js","sources":["../../../../src/global/blue/IBlueDynamicResourceConstructor.js"],"sourcesContent":["// Source: blue/include/IBlueResMan.h:39-44\n//\n// The factory behind a `dynamic:/<name>/<query>` path. The manager knows\n// nothing about what it builds: the thing that knows registers itself, as\n// Carbon's procedural textures do from their own files -\n// `BeResMan->RegisterResourceConstructor( L\"gradient_1d\", this )`\n// (`Resources/Procedural/GradientTexture.cpp:35`) and `L\"color\"`\n// (`SolidColorTexture.cpp:21`).\n//\n// Declared beside IBlueResMan in Carbon's one header; here it takes its own\n// file, because a class is found by its own name.\nimport { CjsSchema, compose, impl } from \"#schema\";\n\n/** `IBlueDynamicResourceConstructor` - builds a resource for a `dynamic:/<name>` path. */\nexport class IBlueDynamicResourceConstructor\n{\n  /** `GetResource` - construct the resource this query describes. */\n  GetResource(_query) {}\n\n  /**\n   * Whether the resource this constructor builds may stay in the cache once\n   * nothing holds it.\n   *\n   * Not Carbon: Carbon inserts every dynamic resource with\n   * `CACHING_NOT_ALLOWED` (`BlueResMan.cpp:233`) because it rebuilds from local\n   * disk. We pay a network fetch and a decode, so each constructor says what its\n   * resource costs to rebuild. The default is Carbon's.\n   *\n   * @returns {boolean} True to keep the resource cached after release.\n   */\n  IsCacheable() {\n    return false;\n  }\n}\n\nCjsSchema.decorateMethod(IBlueDynamicResourceConstructor, \"GetResource\", compose.abstract, impl.abstract);\nCjsSchema.decorateMethod(IBlueDynamicResourceConstructor, \"IsCacheable\", impl.custom);\nCjsSchema.define(IBlueDynamicResourceConstructor, {\n  className: \"IBlueDynamicResourceConstructor\", carbon: \"IBlueDynamicResourceConstructor\", family: \"blue\", fields: {}\n});\n"],"names":["IBlueDynamicResourceConstructor","GetResource","_query","IsCacheable","CjsSchema","decorateMethod","compose","abstract","impl","custom","define","className","carbon","family","fields"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,+BAA+B,CAC5C;AACE;EACAC,WAAWA,CAACC,MAAM,EAAE,CAAC;;AAErB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,GAAG;AACZ,IAAA,OAAO,KAAK;AACd,EAAA;AACF;AAEAC,SAAS,CAACC,cAAc,CAACL,+BAA+B,EAAE,aAAa,EAAEM,OAAO,CAACC,QAAQ,EAAEC,IAAI,CAACD,QAAQ,CAAC;AACzGH,SAAS,CAACC,cAAc,CAACL,+BAA+B,EAAE,aAAa,EAAEQ,IAAI,CAACC,MAAM,CAAC;AACrFL,SAAS,CAACM,MAAM,CAACV,+BAA+B,EAAE;AAChDW,EAAAA,SAAS,EAAE,iCAAiC;AAAEC,EAAAA,MAAM,EAAE,iCAAiC;AAAEC,EAAAA,MAAM,EAAE,MAAM;AAAEC,EAAAA,MAAM,EAAE;AACnH,CAAC,CAAC;;;;"}

package/dist/global/blue/blue.js

@@ -1,6 +1,7 @@
 import { IBlueResMan } from './IBlueResMan.js';
 import { CjsBluePaths } from './CjsBluePaths.js';
 import { CjsBlueOS } from './CjsBlueOS.js';
+import { BlueClasses } from './BlueClasses.js';
 import { blueEnums } from './enums/CjsBlueEnumRegistry.js';
 
 // Source: blue/include/IBlueResMan.h:135, blue/include/IBluePaths.h:49,
@@ -36,7 +37,7 @@ import { blueEnums } from './enums/CjsBlueEnumRegistry.js';
 // 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`. */
+/** Carbon's process-wide Blue facilities: `blue.resMan`, `blue.paths`, `blue.os` and `blue.classes`. */
 const blue = {
   /** EnumRegistration and BlueEnum responsibilities combined for JavaScript. */
   enums: blueEnums,
@@ -54,7 +55,12 @@ const blue = {
   // 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()
+  os: new CjsBlueOS(),
+  // The class registry. Like paths it answers truthfully uncomposed: nothing
+  // registered means nothing found, which is Carbon's answer too. It is how a
+  // layer builds a class another layer owns without importing it.
+  /** `BeClasses` (blueexposure/BlueClasses.cpp:28) - class registration and creation by name. */
+  classes: new BlueClasses()
 };
 
 export { blue };

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

@@ -1 +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;;;;"}
+{"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 { BlueClasses } from \"./BlueClasses.js\";\nimport { blueEnums } from \"./enums/CjsBlueEnumRegistry.js\";\n\n/** Carbon's process-wide Blue facilities: `blue.resMan`, `blue.paths`, `blue.os` and `blue.classes`. */\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  // The class registry. Like paths it answers truthfully uncomposed: nothing\n  // registered means nothing found, which is Carbon's answer too. It is how a\n  // layer builds a class another layer owns without importing it.\n  /** `BeClasses` (blueexposure/BlueClasses.cpp:28) - class registration and creation by name. */\n  classes: new BlueClasses()\n};\n"],"names":["blue","enums","blueEnums","resMan","IBlueResMan","paths","CjsBluePaths","os","CjsBlueOS","classes","BlueClasses"],"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;;AAOA;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;AACAC,EAAAA,EAAE,EAAE,IAAIC,SAAS,EAAE;AAEnB;AACA;AACA;AACA;EACAC,OAAO,EAAE,IAAIC,WAAW;AAC1B;;;;"}

package/dist/global/blue/index.js

@@ -16,6 +16,8 @@ export { IListNotify } from './IListNotify.js';
 export { INotify, IsMatch } from './INotify.js';
 export { CjsBluePaths } from './CjsBluePaths.js';
 export { IBluePaths } from './IBluePaths.js';
+export { IBlueClasses } from './IBlueClasses.js';
+export { BlueClasses } from './BlueClasses.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/consts/index.js

@@ -7,7 +7,6 @@ export { AudioChannelLayout, AudioSampleFormat, normalizeAudioSampleFormat } fro
 export { ShaderModel, ShaderStage, normalizeShaderStage } from './shader/shaderStages.js';
 export { DxgiFormat, normalizeDxgiFormat } from './d3d/dxgiFormats.js';
 export { D3dPrimitiveTopology } from './d3d/primitiveTopology.js';
-export { CarbonPixelFormatToWebGpu, DxgiFormatToPixelFormat, GpuTextureFormat, PixelFormatToWebGpu, SrgbSiblingOf, dxgiToPixelFormat, toWebGpuTextureFormat } from './webgpu/textureFormats.js';
 export { BLUEERROR, BLUELISTEVENT } from './blue.js';
 export { Tr2Lod } from './trinity.js';
 //# sourceMappingURL=index.js.map

package/dist/global/consts/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/consts/renderContext/formats.js

@@ -153,53 +153,54 @@ const COMPRESSED_FORMATS = new Set([PixelFormat.PIXEL_FORMAT_BC1_TYPELESS, Pixel
 /** Eight-byte block formats; every other compressed format is sixteen. */
 const EIGHT_BYTE_BLOCK_FORMATS = new Set([PixelFormat.PIXEL_FORMAT_BC1_TYPELESS, PixelFormat.PIXEL_FORMAT_BC1_UNORM, PixelFormat.PIXEL_FORMAT_BC1_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_BC4_TYPELESS, PixelFormat.PIXEL_FORMAT_BC4_UNORM, PixelFormat.PIXEL_FORMAT_BC4_SNORM]);
 
-/**
- * Whether a format stores blocks rather than pixels.
- *
- * @param {number} format A `PixelFormat` value.
- * @returns {boolean} True for the BC family.
+/**
+ * Whether a format stores blocks rather than pixels.
+ *
+ * @param {number} format A `PixelFormat` value.
+ * @returns {boolean} True for the BC family.
  */
 function IsCompressedFormat(format) {
   return COMPRESSED_FORMATS.has(format);
 }
 
-/**
- * Bytes in one compressed block, or 0 when the format is not a block image.
- *
- * @param {number} format A `PixelFormat` value.
- * @returns {number} Block size in bytes.
+/**
+ * Bytes in one compressed block, or 0 when the format is not a block image.
+ *
+ * @param {number} format A `PixelFormat` value.
+ * @returns {number} Block size in bytes.
  */
 function GetBlockByteSize(format) {
   if (!COMPRESSED_FORMATS.has(format)) return 0;
   return EIGHT_BYTE_BLOCK_FORMATS.has(format) ? 8 : 16;
 }
 
-// CARBON'S TABLE, INCLUDING THE THREE-CHANNEL ENTRY. The R32G32B32 formats are
-// listed with the four-channel ones and so report 16 bytes rather than 12
-// (`PixelFormat.h:203-215`). That is deliberate transcription, not an oversight:
-// changing it here would make our mip pitch disagree with the engine we mirror.
-const BYTES_PER_PIXEL = new Map([[16, [PixelFormat.PIXEL_FORMAT_R32G32B32A32_TYPELESS, PixelFormat.PIXEL_FORMAT_R32G32B32A32_FLOAT, PixelFormat.PIXEL_FORMAT_R32G32B32A32_UINT, PixelFormat.PIXEL_FORMAT_R32G32B32A32_SINT, PixelFormat.PIXEL_FORMAT_R32G32B32_TYPELESS, PixelFormat.PIXEL_FORMAT_R32G32B32_FLOAT, PixelFormat.PIXEL_FORMAT_R32G32B32_UINT, PixelFormat.PIXEL_FORMAT_R32G32B32_SINT]], [8, [PixelFormat.PIXEL_FORMAT_R16G16B16A16_TYPELESS, PixelFormat.PIXEL_FORMAT_R16G16B16A16_FLOAT, PixelFormat.PIXEL_FORMAT_R16G16B16A16_UNORM, PixelFormat.PIXEL_FORMAT_R16G16B16A16_UINT, PixelFormat.PIXEL_FORMAT_R16G16B16A16_SNORM, PixelFormat.PIXEL_FORMAT_R16G16B16A16_SINT, PixelFormat.PIXEL_FORMAT_R32G32_TYPELESS, PixelFormat.PIXEL_FORMAT_R32G32_FLOAT, PixelFormat.PIXEL_FORMAT_R32G32_UINT, PixelFormat.PIXEL_FORMAT_R32G32_SINT, PixelFormat.PIXEL_FORMAT_R32G8X24_TYPELESS, PixelFormat.PIXEL_FORMAT_D32_FLOAT_S8X24_UINT, PixelFormat.PIXEL_FORMAT_R32_FLOAT_X8X24_TYPELESS, PixelFormat.PIXEL_FORMAT_X32_TYPELESS_G8X24_UINT]], [4, [PixelFormat.PIXEL_FORMAT_R10G10B10A2_TYPELESS, PixelFormat.PIXEL_FORMAT_R10G10B10A2_UNORM, PixelFormat.PIXEL_FORMAT_R10G10B10A2_UINT, PixelFormat.PIXEL_FORMAT_R11G11B10_FLOAT, PixelFormat.PIXEL_FORMAT_R8G8B8A8_TYPELESS, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UINT, PixelFormat.PIXEL_FORMAT_R8G8B8A8_SNORM, PixelFormat.PIXEL_FORMAT_R8G8B8A8_SINT, PixelFormat.PIXEL_FORMAT_R16G16_TYPELESS, PixelFormat.PIXEL_FORMAT_R16G16_FLOAT, PixelFormat.PIXEL_FORMAT_R16G16_UNORM, PixelFormat.PIXEL_FORMAT_R16G16_UINT, PixelFormat.PIXEL_FORMAT_R16G16_SNORM, PixelFormat.PIXEL_FORMAT_R16G16_SINT, PixelFormat.PIXEL_FORMAT_R32_TYPELESS, PixelFormat.PIXEL_FORMAT_D32_FLOAT, PixelFormat.PIXEL_FORMAT_R32_FLOAT, PixelFormat.PIXEL_FORMAT_R32_UINT, PixelFormat.PIXEL_FORMAT_R32_SINT, PixelFormat.PIXEL_FORMAT_R24G8_TYPELESS, PixelFormat.PIXEL_FORMAT_D24_UNORM_S8_UINT, PixelFormat.PIXEL_FORMAT_R24_UNORM_X8_TYPELESS, PixelFormat.PIXEL_FORMAT_X24_TYPELESS_G8_UINT, PixelFormat.PIXEL_FORMAT_R9G9B9E5_SHAREDEXP, PixelFormat.PIXEL_FORMAT_R8G8_B8G8_UNORM, PixelFormat.PIXEL_FORMAT_G8R8_G8B8_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM, PixelFormat.PIXEL_FORMAT_R10G10B10_XR_BIAS_A2_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8A8_TYPELESS, PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_B8G8R8X8_TYPELESS, PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM_SRGB]], [2, [PixelFormat.PIXEL_FORMAT_R8G8_TYPELESS, PixelFormat.PIXEL_FORMAT_R8G8_UNORM, PixelFormat.PIXEL_FORMAT_R8G8_UINT, PixelFormat.PIXEL_FORMAT_R8G8_SNORM, PixelFormat.PIXEL_FORMAT_R8G8_SINT, PixelFormat.PIXEL_FORMAT_R16_TYPELESS, PixelFormat.PIXEL_FORMAT_R16_FLOAT, PixelFormat.PIXEL_FORMAT_D16_UNORM, PixelFormat.PIXEL_FORMAT_R16_UNORM, PixelFormat.PIXEL_FORMAT_R16_UINT, PixelFormat.PIXEL_FORMAT_R16_SNORM, PixelFormat.PIXEL_FORMAT_R16_SINT, PixelFormat.PIXEL_FORMAT_B5G6R5_UNORM, PixelFormat.PIXEL_FORMAT_B5G5R5A1_UNORM]], [1, [PixelFormat.PIXEL_FORMAT_R8_TYPELESS, PixelFormat.PIXEL_FORMAT_R8_UNORM, PixelFormat.PIXEL_FORMAT_R8_UINT, PixelFormat.PIXEL_FORMAT_R8_SNORM, PixelFormat.PIXEL_FORMAT_R8_SINT, PixelFormat.PIXEL_FORMAT_A8_UNORM]]]);
+// CARBON'S TABLE, WITH ONE FIX. diverged: Carbon lists the R32G32B32 formats
+// with the four-channel ones, so they report 16 bytes rather than 12
+// (`PixelFormat.h:211-215`), and every size, pitch and offset for them is wrong.
+// Fixed here (operator, 2026-09-22); reported upstream as issue 5 in
+// /docs/research/carbon-imageio-issue.md.
+const BYTES_PER_PIXEL = new Map([[16, [PixelFormat.PIXEL_FORMAT_R32G32B32A32_TYPELESS, PixelFormat.PIXEL_FORMAT_R32G32B32A32_FLOAT, PixelFormat.PIXEL_FORMAT_R32G32B32A32_UINT, PixelFormat.PIXEL_FORMAT_R32G32B32A32_SINT]], [12, [PixelFormat.PIXEL_FORMAT_R32G32B32_TYPELESS, PixelFormat.PIXEL_FORMAT_R32G32B32_FLOAT, PixelFormat.PIXEL_FORMAT_R32G32B32_UINT, PixelFormat.PIXEL_FORMAT_R32G32B32_SINT]], [8, [PixelFormat.PIXEL_FORMAT_R16G16B16A16_TYPELESS, PixelFormat.PIXEL_FORMAT_R16G16B16A16_FLOAT, PixelFormat.PIXEL_FORMAT_R16G16B16A16_UNORM, PixelFormat.PIXEL_FORMAT_R16G16B16A16_UINT, PixelFormat.PIXEL_FORMAT_R16G16B16A16_SNORM, PixelFormat.PIXEL_FORMAT_R16G16B16A16_SINT, PixelFormat.PIXEL_FORMAT_R32G32_TYPELESS, PixelFormat.PIXEL_FORMAT_R32G32_FLOAT, PixelFormat.PIXEL_FORMAT_R32G32_UINT, PixelFormat.PIXEL_FORMAT_R32G32_SINT, PixelFormat.PIXEL_FORMAT_R32G8X24_TYPELESS, PixelFormat.PIXEL_FORMAT_D32_FLOAT_S8X24_UINT, PixelFormat.PIXEL_FORMAT_R32_FLOAT_X8X24_TYPELESS, PixelFormat.PIXEL_FORMAT_X32_TYPELESS_G8X24_UINT]], [4, [PixelFormat.PIXEL_FORMAT_R10G10B10A2_TYPELESS, PixelFormat.PIXEL_FORMAT_R10G10B10A2_UNORM, PixelFormat.PIXEL_FORMAT_R10G10B10A2_UINT, PixelFormat.PIXEL_FORMAT_R11G11B10_FLOAT, PixelFormat.PIXEL_FORMAT_R8G8B8A8_TYPELESS, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_R8G8B8A8_UINT, PixelFormat.PIXEL_FORMAT_R8G8B8A8_SNORM, PixelFormat.PIXEL_FORMAT_R8G8B8A8_SINT, PixelFormat.PIXEL_FORMAT_R16G16_TYPELESS, PixelFormat.PIXEL_FORMAT_R16G16_FLOAT, PixelFormat.PIXEL_FORMAT_R16G16_UNORM, PixelFormat.PIXEL_FORMAT_R16G16_UINT, PixelFormat.PIXEL_FORMAT_R16G16_SNORM, PixelFormat.PIXEL_FORMAT_R16G16_SINT, PixelFormat.PIXEL_FORMAT_R32_TYPELESS, PixelFormat.PIXEL_FORMAT_D32_FLOAT, PixelFormat.PIXEL_FORMAT_R32_FLOAT, PixelFormat.PIXEL_FORMAT_R32_UINT, PixelFormat.PIXEL_FORMAT_R32_SINT, PixelFormat.PIXEL_FORMAT_R24G8_TYPELESS, PixelFormat.PIXEL_FORMAT_D24_UNORM_S8_UINT, PixelFormat.PIXEL_FORMAT_R24_UNORM_X8_TYPELESS, PixelFormat.PIXEL_FORMAT_X24_TYPELESS_G8_UINT, PixelFormat.PIXEL_FORMAT_R9G9B9E5_SHAREDEXP, PixelFormat.PIXEL_FORMAT_R8G8_B8G8_UNORM, PixelFormat.PIXEL_FORMAT_G8R8_G8B8_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM, PixelFormat.PIXEL_FORMAT_R10G10B10_XR_BIAS_A2_UNORM, PixelFormat.PIXEL_FORMAT_B8G8R8A8_TYPELESS, PixelFormat.PIXEL_FORMAT_B8G8R8A8_UNORM_SRGB, PixelFormat.PIXEL_FORMAT_B8G8R8X8_TYPELESS, PixelFormat.PIXEL_FORMAT_B8G8R8X8_UNORM_SRGB]], [2, [PixelFormat.PIXEL_FORMAT_R8G8_TYPELESS, PixelFormat.PIXEL_FORMAT_R8G8_UNORM, PixelFormat.PIXEL_FORMAT_R8G8_UINT, PixelFormat.PIXEL_FORMAT_R8G8_SNORM, PixelFormat.PIXEL_FORMAT_R8G8_SINT, PixelFormat.PIXEL_FORMAT_R16_TYPELESS, PixelFormat.PIXEL_FORMAT_R16_FLOAT, PixelFormat.PIXEL_FORMAT_D16_UNORM, PixelFormat.PIXEL_FORMAT_R16_UNORM, PixelFormat.PIXEL_FORMAT_R16_UINT, PixelFormat.PIXEL_FORMAT_R16_SNORM, PixelFormat.PIXEL_FORMAT_R16_SINT, PixelFormat.PIXEL_FORMAT_B5G6R5_UNORM, PixelFormat.PIXEL_FORMAT_B5G5R5A1_UNORM]], [1, [PixelFormat.PIXEL_FORMAT_R8_TYPELESS, PixelFormat.PIXEL_FORMAT_R8_UNORM, PixelFormat.PIXEL_FORMAT_R8_UINT, PixelFormat.PIXEL_FORMAT_R8_SNORM, PixelFormat.PIXEL_FORMAT_R8_SINT, PixelFormat.PIXEL_FORMAT_A8_UNORM]]]);
 const BYTES_BY_FORMAT = new Map();
 for (const [bytes, formats] of BYTES_PER_PIXEL) {
   for (const format of formats) BYTES_BY_FORMAT.set(format, bytes);
 }
 
-/**
- * Bytes in one pixel, or 0 for a compressed or unknown format.
- *
- * @param {number} format A `PixelFormat` value.
- * @returns {number} Size in bytes.
+/**
+ * Bytes in one pixel, or 0 for a compressed or unknown format.
+ *
+ * @param {number} format A `PixelFormat` value.
+ * @returns {number} Size in bytes.
  */
 function GetBytesPerPixel(format) {
   const bytes = BYTES_BY_FORMAT.get(format);
   return bytes === undefined ? 0 : bytes;
 }
 
-/**
- * The canonical pixel-format STRING a texture payload carries
- * (`graphics/pixelFormats.js`, what the DDS and image readers emit) to Carbon's
- * numeric enum, which `Tr2BitmapDimensions` and every `Tr2TextureAL` speak.
- * Typeless, depth and packed formats have no string and are absent.
+/**
+ * The canonical pixel-format STRING a texture payload carries
+ * (`graphics/pixelFormats.js`, what the DDS and image readers emit) to Carbon's
+ * numeric enum, which `Tr2BitmapDimensions` and every `Tr2TextureAL` speak.
+ * Typeless, depth and packed formats have no string and are absent.
  */
 const PixelFormatFromCanonical = Object.freeze({
   "r8unorm": PixelFormat.PIXEL_FORMAT_R8_UNORM,