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

package/dist/global/compose/interface.js

@@ -12,7 +12,7 @@
 // A class takes its PRIMARY Carbon base with ordinary `extends`, and declares
 // each ADDITIONAL base with this decorator:
 //
-//   @compose.interface(Tr2RenderContextAL)
+//   @carbon.inherit(Tr2RenderContextAL)
 //   class Tr2RenderContext extends Tr2RenderContextBase { }
 //
 // which reads as Carbon's own base list. Measured 2026-09-07: of 75 tower
@@ -43,10 +43,24 @@ const OBJECT_MEMBERS = new Set(Object.getOwnPropertyNames(Object.prototype));
  * subclass that IS decorated copies the inherited set before adding to it, so
  * declaring a contract on a subclass never reaches back into its parent.
  */
-const COMPOSED = Symbol.for("carbonenginejs.compose.contracts");
+const COMPOSED = Symbol.for("carbonenginejs.compose.interfaces");
 
 /**
- * Records a contract against a class, copying an inherited record first.
+ * Records a contract and ITS OWN BASES against a class, copying an inherited
+ * record first.
+ *
+ * THE WHOLE CHAIN, NOT THE NAMED BASE ALONE, because `cast` ports
+ * `dynamic_cast` and C++ walks the base chain: something deriving from
+ * `ITriEffectTextureParameter` casts to `ITriEffectResourceParameter` and to
+ * `ITriEffectParameter` too, and Carbon does exactly that at different sites
+ * (`Tr2Effect.cpp:914-925`, `:1930`). `CollectMembers` already walks the chain
+ * for members, so recording only the leaf made a class that HAD every
+ * inherited member answer null when asked about any of them but the last -
+ * silently, which is the failure mode that matters.
+ *
+ * Declaring each level at the call site would also work and is rejected: the
+ * donor names one base and means the chain, so a base list that had to spell
+ * out its own ancestors would stop matching the header it is transcribed from.
  *
  * @param {Function} Constructor
  * @param {Function} Contract
@@ -58,7 +72,9 @@ function RecordContract(Constructor, Contract) {
       configurable: true
     });
   }
-  Constructor[COMPOSED].add(Contract);
+  for (let base = Contract; typeof base === "function" && base.prototype && base !== Object; base = Object.getPrototypeOf(base)) {
+    Constructor[COMPOSED].add(base);
+  }
 }
 
 /**
@@ -92,24 +108,28 @@ function CollectMembers(Contract) {
  * decorator can be applied to a class that already satisfies part of its
  * contract.
  *
- * Members arriving from the contract are reported to `onInstalled`, which the
- * schema uses to decorate them `impl.abstract` - matching what the mixin
- * towers decorated them with, so an unimplemented contract member throws where
- * it is called rather than returning undefined.
+ * Members arriving from the contract are reported to `onInstalled` ALONG WITH
+ * THE CONTRACT THEY CAME FROM, so the schema can carry across what the
+ * interface already declared about each one. That matters because Carbon's
+ * interfaces are not uniform: some methods are pure virtual and some have an
+ * empty body, and marking the second kind `impl.abstract` on every consumer
+ * would write "Carbon leaves this unimplemented" onto methods Carbon in fact
+ * implements - a false entry in the divergence ledger, which is the one thing
+ * `@impl` exists to keep honest.
  *
  * @param {Function} Constructor The class receiving the contract.
  * @param {Function} Contract The additional base.
- * @param {Function} [onInstalled] Called as `(Constructor, methodName)` for
- *   each method actually installed. Injected rather than imported; see the
- *   note at the top of this file.
+ * @param {Function} [onInstalled] Called as
+ *   `(Constructor, methodName, Contract)` for each method actually installed.
+ *   Injected rather than imported; see the note at the top of this file.
  * @returns {Function} The same constructor.
  */
 function installInterface(Constructor, Contract, onInstalled = null) {
   if (typeof Constructor !== "function") {
-    throw new TypeError("compose.interface requires a class constructor.");
+    throw new TypeError("carbon.inherit requires a class constructor.");
   }
   if (typeof Contract !== "function" || !Contract.prototype) {
-    throw new TypeError("compose.interface requires a contract class.");
+    throw new TypeError("carbon.inherit requires a base class.");
   }
   const installed = [];
   for (const [name, descriptor] of CollectMembers(Contract)) {
@@ -122,7 +142,7 @@ function installInterface(Constructor, Contract, onInstalled = null) {
   }
   RecordContract(Constructor, Contract);
   if (typeof onInstalled === "function") {
-    for (const name of installed) onInstalled(Constructor, name);
+    for (const name of installed) onInstalled(Constructor, name, Contract);
   }
   return Constructor;
 }
@@ -174,27 +194,112 @@ function cast(value, Contract) {
 }
 
 /**
- * The `@compose.interface(X)` class decorator.
+ * The `@carbon.inherit(X, Y, ...)` class decorator.
+ *
+ * Takes the additional bases and returns the decorator, so the declaration
+ * reads as Carbon's base list rather than as a wrapper call. Several at once
+ * because Carbon declares several at once - `TriDevice` has three
+ * (`TriDevice.h:33-36`) - and one decorator per base would read as three
+ * unrelated facts rather than one base list.
  *
- * Takes the additional base and returns the decorator, so the declaration
- * reads as Carbon's base list rather than as a wrapper call.
+ * ORDER IS CARBON'S BASE ORDER AND IT MATTERS. Installation is if-absent, so
+ * the first base declaring a member is the one that supplies it, exactly as
+ * C++ resolves an unqualified name against the base list left to right.
  *
- * @param {Function} Contract The additional base to declare.
- * @param {Function} [onInstalled] Schema decoration hook, injected by the
- *   caller that owns the namespace.
+ * INHERITING IS NOT MAPPING, and `@carbon.mapInterface` below is the other
+ * half. This one is Carbon's base list: it decides which members a class has
+ * and what `dynamic_cast` accepts. Mapping is the separate `_Blue.cpp`
+ * exposure that `BlueCastPtr` reads, and it decides real behaviour - see that
+ * decorator for the case that proves the two cannot be collapsed.
+ *
+ * @param {...Function} Contracts The additional bases, in Carbon's order. The
+ *   schema injects its decoration hook as the last argument.
  * @returns {Function} A stage-3 class decorator.
  */
-function composeInterfaceDecorator(Contract, onInstalled = null) {
-  if (typeof Contract !== "function" || !Contract.prototype) {
-    throw new TypeError("compose.interface requires a contract class.");
+function carbonInheritDecorator(Contracts, onInstalled = null) {
+  const bases = Array.isArray(Contracts) ? Contracts : [Contracts];
+  if (!bases.length) {
+    throw new TypeError("carbon.inherit requires at least one base class.");
+  }
+  for (const Contract of bases) {
+    if (typeof Contract !== "function" || !Contract.prototype) {
+      throw new TypeError("carbon.inherit requires a base class.");
+    }
+  }
+  return function (value, context) {
+    if (context && typeof context === "object" && context.kind !== "class") {
+      throw new TypeError("carbon.inherit only supports classes.");
+    }
+    for (const Contract of bases) installInterface(value, Contract, onInstalled);
+  };
+}
+
+/**
+ * The classes `_Blue.cpp` maps for a given class, held on the CONSTRUCTOR.
+ *
+ * Separate from the composed-base record above because the two answer
+ * different questions - see `carbonMapInterfaceDecorator`.
+ */
+const MAPPED = Symbol.for("carbonenginejs.carbon.mappedInterfaces");
+
+/**
+ * The `@carbon.mapInterface(X, Y, ...)` class decorator: Carbon's
+ * `MAP_INTERFACE` entries, from the class's `EXPOSURE_BEGIN` block.
+ *
+ * WHY THIS IS NOT THE SAME FACT AS THE BASE LIST, with the case that settles
+ * it. `MAP_INTERFACE` pushes an `InterfaceEntry` of IID and offset onto
+ * `s_interfaces` (`BlueExposureMacros.h:171-175`) - a QueryInterface table -
+ * and `BlueCastPtr` reads that table. It is NOT script-only; `blue/src` uses
+ * it throughout. The black-file reader branches on it:
+ *
+ *     IInitializePtr init( BlueCastPtr( instance ) );
+ *     if( !init ) { notify = BlueCastPtr( instance ); }
+ *                                       // BlackReader.cpp:410-421
+ *
+ * A class that MAPS `IInitialize` is hydrated by reading every member and
+ * then calling `Initialize()` once, with NO per-property notification. One
+ * that does not map it gets `OnModified` per property instead. Inheriting
+ * `IInitialize` does not put it in that table, so a class can implement
+ * `Initialize` and still take the notify branch - which is why method
+ * presence is the wrong test and this record is the right one.
+ *
+ * IT DESCRIBES AND DOES NOT INSTALL. Nothing is added to the prototype, and
+ * `cast` deliberately does not read it: `cast` ports `dynamic_cast`, which
+ * answers to the base list. A consumer wanting Carbon's exposure semantics
+ * asks `mappedInterfaces` explicitly, so the two casts can never be confused
+ * for one another.
+ *
+ * @param {...Function} Interfaces The mapped interfaces, as `_Blue.cpp` lists
+ *   them.
+ * @returns {Function} A stage-3 class decorator.
+ */
+function carbonMapInterfaceDecorator(Interfaces) {
+  const mapped = Array.isArray(Interfaces) ? Interfaces : [Interfaces];
+  if (!mapped.length) {
+    throw new TypeError("carbon.mapInterface requires at least one interface class.");
+  }
+  for (const Interface of mapped) {
+    if (typeof Interface !== "function" || !Interface.prototype) {
+      throw new TypeError("carbon.mapInterface requires an interface class.");
+    }
   }
   return function (value, context) {
     if (context && typeof context === "object" && context.kind !== "class") {
-      throw new TypeError("compose.interface only supports classes.");
+      throw new TypeError("carbon.mapInterface only supports classes.");
     }
-    installInterface(value, Contract, onInstalled);
+
+    // Copied before adding, for the reason the composed record is: a
+    // subclass declaring its own mapping must never reach back into its
+    // parent's.
+    const inherited = value[MAPPED];
+    const own = new Set(inherited ?? []);
+    for (const Interface of mapped) own.add(Interface);
+    Object.defineProperty(value, MAPPED, {
+      value: own,
+      configurable: true
+    });
   };
 }
 
-export { cast, composeInterfaceDecorator, installInterface };
+export { carbonInheritDecorator, carbonMapInterfaceDecorator, cast, installInterface };
 //# sourceMappingURL=interface.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"interface.js","sources":["../../../../src/global/compose/interface.js"],"sourcesContent":["// Source: trinity MAP_INTERFACE - Carbon's multiple-inheritance declaration,\n// e.g. `BLUE_CLASS( Tr2RenderContext ) : public Tr2RenderContextBase,\n// public Tr2RenderContextAL` (Tr2RenderContext.h:85-87).\n//\n// C++ spends multiple inheritance freely; JavaScript has ONE `extends` slot.\n// The shape this replaces is the mixin tower - `withIEveTransform(\n// withIEveSpaceObject2(withITr2BoundingBox(Tr2Transform)))` - where every\n// wrapper mints a distinct anonymous intermediate class. Those anonymous\n// classes are the only reason the Symbol-brand `hasInstance` machinery exists,\n// because two towers over the same base produce two unrelated constructors.\n//\n// A class takes its PRIMARY Carbon base with ordinary `extends`, and declares\n// each ADDITIONAL base with this decorator:\n//\n//   @compose.interface(Tr2RenderContextAL)\n//   class Tr2RenderContext extends Tr2RenderContextBase { }\n//\n// which reads as Carbon's own base list. Measured 2026-09-07: of 75 tower\n// sites, 42 are a single mixin over CjsModel and need no decorator at all once\n// CjsModel stops occupying the slot - the contract simply becomes the base.\n// 24 carry one real Carbon base plus one contract, and 9 are deeper.\n//\n// NO BRAND IS INSTALLED HERE, deliberately. Brands exist only where Carbon\n// itself casts (the BlueCastPtr ports); capability discovery and test lineage\n// checks are never a reason, and neither are typeof probes. A contract that\n// genuinely needs a cast declares its own `Symbol.hasInstance`, as the\n// dependency-free contracts under `global/contracts` already do.\n\n// This module imports NOTHING, for the reason `compose/notify.js` imports\n// nothing: `CjsSchema` installs these decorators onto its own namespace, so a\n// schema import here is a cycle through `schema/index.js` and fails at load\n// with \"Cannot access 'CjsSchema' before initialization\". Schema decoration of\n// installed members is therefore INJECTED by the caller - see `onInstalled`.\n\n/** Members every class already answers, which a contract must never overwrite. */\nconst OBJECT_MEMBERS = new Set(Object.getOwnPropertyNames(Object.prototype));\n\n\n/**\n * The composed-contract record, held on the CONSTRUCTOR.\n *\n * Class statics inherit, so a subclass that is never itself decorated still\n * finds its parent's record in one lookup - no constructor-chain walk. A\n * subclass that IS decorated copies the inherited set before adding to it, so\n * declaring a contract on a subclass never reaches back into its parent.\n */\nconst COMPOSED = Symbol.for(\"carbonenginejs.compose.contracts\");\n\n\n/**\n * Every contract composed onto a class, including those it inherits.\n *\n * @param {Function} Constructor\n * @returns {Set<Function>} Empty when nothing was composed. Do not mutate.\n */\nexport function composedContracts(Constructor)\n{\n    return (typeof Constructor === \"function\" && Constructor[COMPOSED]) || new Set();\n}\n\n\n/**\n * Records a contract against a class, copying an inherited record first.\n *\n * @param {Function} Constructor\n * @param {Function} Contract\n */\nfunction RecordContract(Constructor, Contract)\n{\n    if (!Object.hasOwn(Constructor, COMPOSED))\n    {\n        Object.defineProperty(Constructor, COMPOSED, {\n            value: new Set(Constructor[COMPOSED] ?? []),\n            configurable: true\n        });\n    }\n\n    Constructor[COMPOSED].add(Contract);\n}\n\n\n/**\n * Collects a contract's instance members, nearest declaration winning.\n *\n * Walks the prototype chain so a contract that itself extends another contract\n * contributes both, which is what a C++ base list does.\n *\n * @param {Function} Contract\n * @returns {Map<String, PropertyDescriptor>}\n */\nfunction CollectMembers(Contract)\n{\n    const members = new Map();\n\n    for (let proto = Contract.prototype; proto && proto !== Object.prototype;\n        proto = Object.getPrototypeOf(proto))\n    {\n        for (const name of Object.getOwnPropertyNames(proto))\n        {\n            if (name === \"constructor\" || OBJECT_MEMBERS.has(name)) continue;\n            if (members.has(name)) continue;\n\n            const descriptor = Object.getOwnPropertyDescriptor(proto, name);\n            if (descriptor) members.set(name, descriptor);\n        }\n    }\n\n    return members;\n}\n\n\n/**\n * Installs a contract's members onto a class's prototype, install-if-absent.\n *\n * Install-if-absent is the same rule `installNotify` follows: a member the\n * class or its `extends` chain already answers keeps its own, so declaring a\n * contract never silently replaces a real implementation. That is also why the\n * decorator can be applied to a class that already satisfies part of its\n * contract.\n *\n * Members arriving from the contract are reported to `onInstalled`, which the\n * schema uses to decorate them `impl.abstract` - matching what the mixin\n * towers decorated them with, so an unimplemented contract member throws where\n * it is called rather than returning undefined.\n *\n * @param {Function} Constructor The class receiving the contract.\n * @param {Function} Contract The additional base.\n * @param {Function} [onInstalled] Called as `(Constructor, methodName)` for\n *   each method actually installed. Injected rather than imported; see the\n *   note at the top of this file.\n * @returns {Function} The same constructor.\n */\nexport function installInterface(Constructor, Contract, onInstalled = null)\n{\n    if (typeof Constructor !== \"function\")\n    {\n        throw new TypeError(\"compose.interface requires a class constructor.\");\n    }\n    if (typeof Contract !== \"function\" || !Contract.prototype)\n    {\n        throw new TypeError(\"compose.interface requires a contract class.\");\n    }\n\n    const installed = [];\n\n    for (const [ name, descriptor ] of CollectMembers(Contract))\n    {\n        if (name in Constructor.prototype) continue;\n\n        Object.defineProperty(Constructor.prototype, name, {\n            ...descriptor,\n            configurable: true\n        });\n\n        if (typeof descriptor.value === \"function\") installed.push(name);\n    }\n\n    RecordContract(Constructor, Contract);\n\n    if (typeof onInstalled === \"function\")\n    {\n        for (const name of installed) onInstalled(Constructor, name);\n    }\n\n    return Constructor;\n}\n\n\n/**\n * Carbon's `dynamic_cast` / `BlueCastPtr`, as far as JavaScript can carry it.\n *\n * Carbon branches on runtime type constantly - 143 `dynamic_cast` sites in\n * trinity, of which ~116 target an INTERFACE and ask \"does this object\n * implement this optional contract?\". That is contract semantics, and it is\n * the one legitimate reason to test an object's type. This is that operation:\n *\n *     const owner = cast( child, IEveInheritPropertiesOwner );\n *     if( owner ) owner.SetInheritProperties( colorSet );\n *\n * against Carbon's\n *\n *     if( auto tmp = dynamic_cast<ITr2DebugRenderable*>( m_sourceEmitter.p ) )\n *\n * C++ gets a retyped pointer the compiler then enforces; JavaScript has no\n * type to change, so this does the checking half only and returns the same\n * object. The value is that HOW the question is answered lives in one place:\n * today a composed record with an `instanceof` fallback for contracts still\n * carrying a hand-written brand, tomorrow whatever replaces both, with no\n * call site touched.\n *\n * This is an INVENTION - Carbon needs no predicate because the cast doubles as\n * one. Registered in `docs/architecture/non-carbon-extensions.md`.\n *\n * @param {*} value The object to test.\n * @param {Function} Contract The contract to test against.\n * @returns {*} `value` when it implements the contract, otherwise `null`.\n */\nexport function cast(value, Contract)\n{\n    if (value === null || value === undefined) return null;\n\n    if (typeof Contract !== \"function\" || !Contract.prototype)\n    {\n        throw new TypeError(\"CjsSchema.cast requires a contract class.\");\n    }\n\n    const Constructor = value.constructor;\n\n    if (typeof Constructor === \"function\" && Constructor[COMPOSED]?.has(Contract))\n    {\n        return value;\n    }\n\n    // Contracts still carrying a hand-written `Symbol.hasInstance` brand, and\n    // ordinary `extends` lineage, both answer here. Removing a brand therefore\n    // never changes an answer, which is what makes the 16 of them migratable\n    // one at a time.\n    return value instanceof Contract ? value : null;\n}\n\n\n/**\n * The `@compose.interface(X)` class decorator.\n *\n * Takes the additional base and returns the decorator, so the declaration\n * reads as Carbon's base list rather than as a wrapper call.\n *\n * @param {Function} Contract The additional base to declare.\n * @param {Function} [onInstalled] Schema decoration hook, injected by the\n *   caller that owns the namespace.\n * @returns {Function} A stage-3 class decorator.\n */\nexport function composeInterfaceDecorator(Contract, onInstalled = null)\n{\n    if (typeof Contract !== \"function\" || !Contract.prototype)\n    {\n        throw new TypeError(\"compose.interface requires a contract class.\");\n    }\n\n    return function (value, context)\n    {\n        if (context && typeof context === \"object\" && context.kind !== \"class\")\n        {\n            throw new TypeError(\"compose.interface only supports classes.\");\n        }\n\n        installInterface(value, Contract, onInstalled);\n    };\n}\n"],"names":["OBJECT_MEMBERS","Set","Object","getOwnPropertyNames","prototype","COMPOSED","Symbol","for","RecordContract","Constructor","Contract","hasOwn","defineProperty","value","configurable","add","CollectMembers","members","Map","proto","getPrototypeOf","name","has","descriptor","getOwnPropertyDescriptor","set","installInterface","onInstalled","TypeError","installed","push","cast","undefined","constructor","composeInterfaceDecorator","context","kind"],"mappings":"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"}
+{"version":3,"file":"interface.js","sources":["../../../../src/global/compose/interface.js"],"sourcesContent":["// Source: trinity MAP_INTERFACE - Carbon's multiple-inheritance declaration,\n// e.g. `BLUE_CLASS( Tr2RenderContext ) : public Tr2RenderContextBase,\n// public Tr2RenderContextAL` (Tr2RenderContext.h:85-87).\n//\n// C++ spends multiple inheritance freely; JavaScript has ONE `extends` slot.\n// The shape this replaces is the mixin tower - `withIEveTransform(\n// withIEveSpaceObject2(withITr2BoundingBox(Tr2Transform)))` - where every\n// wrapper mints a distinct anonymous intermediate class. Those anonymous\n// classes are the only reason the Symbol-brand `hasInstance` machinery exists,\n// because two towers over the same base produce two unrelated constructors.\n//\n// A class takes its PRIMARY Carbon base with ordinary `extends`, and declares\n// each ADDITIONAL base with this decorator:\n//\n//   @carbon.inherit(Tr2RenderContextAL)\n//   class Tr2RenderContext extends Tr2RenderContextBase { }\n//\n// which reads as Carbon's own base list. Measured 2026-09-07: of 75 tower\n// sites, 42 are a single mixin over CjsModel and need no decorator at all once\n// CjsModel stops occupying the slot - the contract simply becomes the base.\n// 24 carry one real Carbon base plus one contract, and 9 are deeper.\n//\n// NO BRAND IS INSTALLED HERE, deliberately. Brands exist only where Carbon\n// itself casts (the BlueCastPtr ports); capability discovery and test lineage\n// checks are never a reason, and neither are typeof probes. A contract that\n// genuinely needs a cast declares its own `Symbol.hasInstance`, as the\n// dependency-free contracts under `global/contracts` already do.\n\n// This module imports NOTHING, for the reason `compose/notify.js` imports\n// nothing: `CjsSchema` installs these decorators onto its own namespace, so a\n// schema import here is a cycle through `schema/index.js` and fails at load\n// with \"Cannot access 'CjsSchema' before initialization\". Schema decoration of\n// installed members is therefore INJECTED by the caller - see `onInstalled`.\n\n/** Members every class already answers, which a contract must never overwrite. */\nconst OBJECT_MEMBERS = new Set(Object.getOwnPropertyNames(Object.prototype));\n\n\n/**\n * The composed-contract record, held on the CONSTRUCTOR.\n *\n * Class statics inherit, so a subclass that is never itself decorated still\n * finds its parent's record in one lookup - no constructor-chain walk. A\n * subclass that IS decorated copies the inherited set before adding to it, so\n * declaring a contract on a subclass never reaches back into its parent.\n */\nconst COMPOSED = Symbol.for(\"carbonenginejs.compose.interfaces\");\n\n\n/**\n * Every contract composed onto a class, including those it inherits.\n *\n * @param {Function} Constructor\n * @returns {Set<Function>} Empty when nothing was composed. Do not mutate.\n */\nexport function composedContracts(Constructor)\n{\n    return (typeof Constructor === \"function\" && Constructor[COMPOSED]) || new Set();\n}\n\n\n/**\n * Records a contract and ITS OWN BASES against a class, copying an inherited\n * record first.\n *\n * THE WHOLE CHAIN, NOT THE NAMED BASE ALONE, because `cast` ports\n * `dynamic_cast` and C++ walks the base chain: something deriving from\n * `ITriEffectTextureParameter` casts to `ITriEffectResourceParameter` and to\n * `ITriEffectParameter` too, and Carbon does exactly that at different sites\n * (`Tr2Effect.cpp:914-925`, `:1930`). `CollectMembers` already walks the chain\n * for members, so recording only the leaf made a class that HAD every\n * inherited member answer null when asked about any of them but the last -\n * silently, which is the failure mode that matters.\n *\n * Declaring each level at the call site would also work and is rejected: the\n * donor names one base and means the chain, so a base list that had to spell\n * out its own ancestors would stop matching the header it is transcribed from.\n *\n * @param {Function} Constructor\n * @param {Function} Contract\n */\nfunction RecordContract(Constructor, Contract)\n{\n    if (!Object.hasOwn(Constructor, COMPOSED))\n    {\n        Object.defineProperty(Constructor, COMPOSED, {\n            value: new Set(Constructor[COMPOSED] ?? []),\n            configurable: true\n        });\n    }\n\n    for (\n        let base = Contract;\n        typeof base === \"function\" && base.prototype && base !== Object;\n        base = Object.getPrototypeOf(base)\n    )\n    {\n        Constructor[COMPOSED].add(base);\n    }\n}\n\n\n/**\n * Collects a contract's instance members, nearest declaration winning.\n *\n * Walks the prototype chain so a contract that itself extends another contract\n * contributes both, which is what a C++ base list does.\n *\n * @param {Function} Contract\n * @returns {Map<String, PropertyDescriptor>}\n */\nfunction CollectMembers(Contract)\n{\n    const members = new Map();\n\n    for (let proto = Contract.prototype; proto && proto !== Object.prototype;\n        proto = Object.getPrototypeOf(proto))\n    {\n        for (const name of Object.getOwnPropertyNames(proto))\n        {\n            if (name === \"constructor\" || OBJECT_MEMBERS.has(name)) continue;\n            if (members.has(name)) continue;\n\n            const descriptor = Object.getOwnPropertyDescriptor(proto, name);\n            if (descriptor) members.set(name, descriptor);\n        }\n    }\n\n    return members;\n}\n\n\n/**\n * Installs a contract's members onto a class's prototype, install-if-absent.\n *\n * Install-if-absent is the same rule `installNotify` follows: a member the\n * class or its `extends` chain already answers keeps its own, so declaring a\n * contract never silently replaces a real implementation. That is also why the\n * decorator can be applied to a class that already satisfies part of its\n * contract.\n *\n * Members arriving from the contract are reported to `onInstalled` ALONG WITH\n * THE CONTRACT THEY CAME FROM, so the schema can carry across what the\n * interface already declared about each one. That matters because Carbon's\n * interfaces are not uniform: some methods are pure virtual and some have an\n * empty body, and marking the second kind `impl.abstract` on every consumer\n * would write \"Carbon leaves this unimplemented\" onto methods Carbon in fact\n * implements - a false entry in the divergence ledger, which is the one thing\n * `@impl` exists to keep honest.\n *\n * @param {Function} Constructor The class receiving the contract.\n * @param {Function} Contract The additional base.\n * @param {Function} [onInstalled] Called as\n *   `(Constructor, methodName, Contract)` for each method actually installed.\n *   Injected rather than imported; see the note at the top of this file.\n * @returns {Function} The same constructor.\n */\nexport function installInterface(Constructor, Contract, onInstalled = null)\n{\n    if (typeof Constructor !== \"function\")\n    {\n        throw new TypeError(\"carbon.inherit requires a class constructor.\");\n    }\n    if (typeof Contract !== \"function\" || !Contract.prototype)\n    {\n        throw new TypeError(\"carbon.inherit requires a base class.\");\n    }\n\n    const installed = [];\n\n    for (const [ name, descriptor ] of CollectMembers(Contract))\n    {\n        if (name in Constructor.prototype) continue;\n\n        Object.defineProperty(Constructor.prototype, name, {\n            ...descriptor,\n            configurable: true\n        });\n\n        if (typeof descriptor.value === \"function\") installed.push(name);\n    }\n\n    RecordContract(Constructor, Contract);\n\n    if (typeof onInstalled === \"function\")\n    {\n        for (const name of installed) onInstalled(Constructor, name, Contract);\n    }\n\n    return Constructor;\n}\n\n\n/**\n * Carbon's `dynamic_cast` / `BlueCastPtr`, as far as JavaScript can carry it.\n *\n * Carbon branches on runtime type constantly - 143 `dynamic_cast` sites in\n * trinity, of which ~116 target an INTERFACE and ask \"does this object\n * implement this optional contract?\". That is contract semantics, and it is\n * the one legitimate reason to test an object's type. This is that operation:\n *\n *     const owner = cast( child, IEveInheritPropertiesOwner );\n *     if( owner ) owner.SetInheritProperties( colorSet );\n *\n * against Carbon's\n *\n *     if( auto tmp = dynamic_cast<ITr2DebugRenderable*>( m_sourceEmitter.p ) )\n *\n * C++ gets a retyped pointer the compiler then enforces; JavaScript has no\n * type to change, so this does the checking half only and returns the same\n * object. The value is that HOW the question is answered lives in one place:\n * today a composed record with an `instanceof` fallback for contracts still\n * carrying a hand-written brand, tomorrow whatever replaces both, with no\n * call site touched.\n *\n * This is an INVENTION - Carbon needs no predicate because the cast doubles as\n * one. Registered in `docs/architecture/non-carbon-extensions.md`.\n *\n * @param {*} value The object to test.\n * @param {Function} Contract The contract to test against.\n * @returns {*} `value` when it implements the contract, otherwise `null`.\n */\nexport function cast(value, Contract)\n{\n    if (value === null || value === undefined) return null;\n\n    if (typeof Contract !== \"function\" || !Contract.prototype)\n    {\n        throw new TypeError(\"CjsSchema.cast requires a contract class.\");\n    }\n\n    const Constructor = value.constructor;\n\n    if (typeof Constructor === \"function\" && Constructor[COMPOSED]?.has(Contract))\n    {\n        return value;\n    }\n\n    // Contracts still carrying a hand-written `Symbol.hasInstance` brand, and\n    // ordinary `extends` lineage, both answer here. Removing a brand therefore\n    // never changes an answer, which is what makes the 16 of them migratable\n    // one at a time.\n    return value instanceof Contract ? value : null;\n}\n\n\n/**\n * The `@carbon.inherit(X, Y, ...)` class decorator.\n *\n * Takes the additional bases and returns the decorator, so the declaration\n * reads as Carbon's base list rather than as a wrapper call. Several at once\n * because Carbon declares several at once - `TriDevice` has three\n * (`TriDevice.h:33-36`) - and one decorator per base would read as three\n * unrelated facts rather than one base list.\n *\n * ORDER IS CARBON'S BASE ORDER AND IT MATTERS. Installation is if-absent, so\n * the first base declaring a member is the one that supplies it, exactly as\n * C++ resolves an unqualified name against the base list left to right.\n *\n * INHERITING IS NOT MAPPING, and `@carbon.mapInterface` below is the other\n * half. This one is Carbon's base list: it decides which members a class has\n * and what `dynamic_cast` accepts. Mapping is the separate `_Blue.cpp`\n * exposure that `BlueCastPtr` reads, and it decides real behaviour - see that\n * decorator for the case that proves the two cannot be collapsed.\n *\n * @param {...Function} Contracts The additional bases, in Carbon's order. The\n *   schema injects its decoration hook as the last argument.\n * @returns {Function} A stage-3 class decorator.\n */\nexport function carbonInheritDecorator(Contracts, onInstalled = null)\n{\n    const bases = Array.isArray(Contracts) ? Contracts : [ Contracts ];\n\n    if (!bases.length)\n    {\n        throw new TypeError(\"carbon.inherit requires at least one base class.\");\n    }\n\n    for (const Contract of bases)\n    {\n        if (typeof Contract !== \"function\" || !Contract.prototype)\n        {\n            throw new TypeError(\"carbon.inherit requires a base class.\");\n        }\n    }\n\n    return function (value, context)\n    {\n        if (context && typeof context === \"object\" && context.kind !== \"class\")\n        {\n            throw new TypeError(\"carbon.inherit only supports classes.\");\n        }\n\n        for (const Contract of bases) installInterface(value, Contract, onInstalled);\n    };\n}\n\n\n/**\n * The classes `_Blue.cpp` maps for a given class, held on the CONSTRUCTOR.\n *\n * Separate from the composed-base record above because the two answer\n * different questions - see `carbonMapInterfaceDecorator`.\n */\nconst MAPPED = Symbol.for(\"carbonenginejs.carbon.mappedInterfaces\");\n\n\n/**\n * Every interface Carbon's exposure layer maps onto a class, inherited ones\n * included.\n *\n * @param {Function} Constructor The class to ask about.\n * @returns {Set<Function>} Empty when nothing is mapped. Do not mutate.\n */\nexport function mappedInterfaces(Constructor)\n{\n    return (typeof Constructor === \"function\" && Constructor[MAPPED]) || new Set();\n}\n\n\n/**\n * The `@carbon.mapInterface(X, Y, ...)` class decorator: Carbon's\n * `MAP_INTERFACE` entries, from the class's `EXPOSURE_BEGIN` block.\n *\n * WHY THIS IS NOT THE SAME FACT AS THE BASE LIST, with the case that settles\n * it. `MAP_INTERFACE` pushes an `InterfaceEntry` of IID and offset onto\n * `s_interfaces` (`BlueExposureMacros.h:171-175`) - a QueryInterface table -\n * and `BlueCastPtr` reads that table. It is NOT script-only; `blue/src` uses\n * it throughout. The black-file reader branches on it:\n *\n *     IInitializePtr init( BlueCastPtr( instance ) );\n *     if( !init ) { notify = BlueCastPtr( instance ); }\n *                                       // BlackReader.cpp:410-421\n *\n * A class that MAPS `IInitialize` is hydrated by reading every member and\n * then calling `Initialize()` once, with NO per-property notification. One\n * that does not map it gets `OnModified` per property instead. Inheriting\n * `IInitialize` does not put it in that table, so a class can implement\n * `Initialize` and still take the notify branch - which is why method\n * presence is the wrong test and this record is the right one.\n *\n * IT DESCRIBES AND DOES NOT INSTALL. Nothing is added to the prototype, and\n * `cast` deliberately does not read it: `cast` ports `dynamic_cast`, which\n * answers to the base list. A consumer wanting Carbon's exposure semantics\n * asks `mappedInterfaces` explicitly, so the two casts can never be confused\n * for one another.\n *\n * @param {...Function} Interfaces The mapped interfaces, as `_Blue.cpp` lists\n *   them.\n * @returns {Function} A stage-3 class decorator.\n */\nexport function carbonMapInterfaceDecorator(Interfaces)\n{\n    const mapped = Array.isArray(Interfaces) ? Interfaces : [ Interfaces ];\n\n    if (!mapped.length)\n    {\n        throw new TypeError(\"carbon.mapInterface requires at least one interface class.\");\n    }\n\n    for (const Interface of mapped)\n    {\n        if (typeof Interface !== \"function\" || !Interface.prototype)\n        {\n            throw new TypeError(\"carbon.mapInterface requires an interface class.\");\n        }\n    }\n\n    return function (value, context)\n    {\n        if (context && typeof context === \"object\" && context.kind !== \"class\")\n        {\n            throw new TypeError(\"carbon.mapInterface only supports classes.\");\n        }\n\n        // Copied before adding, for the reason the composed record is: a\n        // subclass declaring its own mapping must never reach back into its\n        // parent's.\n        const inherited = value[MAPPED];\n        const own = new Set(inherited ?? []);\n        for (const Interface of mapped) own.add(Interface);\n\n        Object.defineProperty(value, MAPPED, { value: own, configurable: true });\n    };\n}\n"],"names":["OBJECT_MEMBERS","Set","Object","getOwnPropertyNames","prototype","COMPOSED","Symbol","for","RecordContract","Constructor","Contract","hasOwn","defineProperty","value","configurable","base","getPrototypeOf","add","CollectMembers","members","Map","proto","name","has","descriptor","getOwnPropertyDescriptor","set","installInterface","onInstalled","TypeError","installed","push","cast","undefined","constructor","carbonInheritDecorator","Contracts","bases","Array","isArray","length","context","kind","MAPPED","carbonMapInterfaceDecorator","Interfaces","mapped","Interface","inherited","own"],"mappings":"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"}

package/dist/global/compose/notify.js

@@ -84,6 +84,15 @@ function OffEvent(eventName = "*", listener = null, source = ANY_SOURCE) {
 /**
  * Emits a lowercased exact event name to all currently registered records.
  *
+ * THE LISTENER RECEIVES THE EVENT NAME AS ITS FIRST ARGUMENT, before the
+ * emitted arguments. Carbon does the same in both notify hooks - INotify
+ * OnModified is handed the member that changed, and IListNotify
+ * OnListModified takes the BLUELISTEVENT code as argument one - so the
+ * observer is always told WHAT happened and decides for itself. Without it a
+ * listener registered for two events cannot tell them apart, and ccpwgl keeps
+ * a closure per event name for exactly that reason; the missing name is a bug
+ * in the emitter this one descends from (operator, 2026-09-17).
+ *
  * @param {string} eventName
  * @param {...*} args
  * @returns {object} This emitter.
@@ -100,7 +109,7 @@ function EmitEvent(eventName, ...args) {
     for (const record of [...records]) {
       if (!records.has(record)) continue;
       if (record.once) RemoveEventRecord(record);
-      record.listener.call(record.source, ...args);
+      record.listener.call(record.source, name, ...args);
     }
   } catch (err) {
     error = err;

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

@@ -1 +1 @@
-{"version":3,"file":"notify.js","sources":["../../../../src/global/compose/notify.js"],"sourcesContent":["// The notify surface as COMPOSITION - the @compose.notify decorator and the\r\n// method map behind it (design record: docs/research/\r\n// cjsmodel-value-audit-2026-09-05.md, direction items 9 and 11).\r\n//\r\n// Carbon's word for the concept is notify (INotify / Be::NOTIFY /\r\n// IListNotify); this surface deliberately widens Carbon's single slot to a\r\n// subscriber list, which is a registered non-Carbon extension (origin:\r\n// ccpwgl Tw2EventEmitter). NO BRAND AND NO hasInstance, ruled: \"we control\r\n// the contract - if an OnEvent method didn't exist, it would throw\", and\r\n// discrimination exists only where Carbon itself casts.\r\n//\r\n// State is lazy on first listener and DELETED when the last listener leaves\r\n// (the emitter costs nothing while unobserved - the operator's GC concern is\r\n// the design constraint here). The state slot is the shared __state expando\r\n// (./runtimeState.js) - both live in global/compose, the home of what\r\n// @compose.* installs and the state those installations share.\r\n//\r\n// CjsEventEmitter remains as the inheritance packaging over this same map -\r\n// one implementation, two deliveries.\r\n\r\nimport { ensureRuntimeState, getRuntimeState } from \"./runtimeState.js\";\r\n\r\nconst ANY_SOURCE = Symbol(\"CjsNotify.AnySource\");\r\n\r\n/**\r\n * Adds event listeners from a plain object. A key ending in \".once\"\r\n * registers a once-only listener; values may be a function or\r\n * [function, source].\r\n *\r\n * @param {object|null} events\r\n * @returns {object} This emitter.\r\n */\r\nfunction AddEvents(events = null)\r\n{\r\n    if (!events || typeof events !== \"object\") return this;\r\n\r\n    for (const key of Object.keys(events))\r\n    {\r\n        const entry = NormalizeEventEntry(key, events[key]);\r\n        this.OnEvent(entry.eventName, entry.listener, entry.source, entry.once);\r\n    }\r\n\r\n    return this;\r\n}\r\n\r\n/**\r\n * Adds a listener for a lowercased exact event name.\r\n *\r\n * @param {string} eventName\r\n * @param {Function} listener\r\n * @param {*} source Optional callback source and `this` value.\r\n * @param {boolean} once\r\n * @returns {object} This emitter.\r\n */\r\nfunction OnEvent(eventName, listener, source = null, once = false)\r\n{\r\n    CreateEventRecord(this, eventName, listener, source, once);\r\n    return this;\r\n}\r\n\r\n/**\r\n * Adds a listener that is removed before its first callback is invoked.\r\n *\r\n * @param {string} eventName\r\n * @param {Function} listener\r\n * @param {*} source Optional callback source and `this` value.\r\n * @returns {object} This emitter.\r\n */\r\nfunction OnceEvent(eventName, listener, source = null)\r\n{\r\n    return this.OnEvent(eventName, listener, source, true);\r\n}\r\n\r\n/**\r\n * Removes matching listeners from this emitter. `eventName=\"*\"` means all\r\n * event buckets - cleanup matching only, not wildcard dispatch.\r\n *\r\n * @param {string} eventName\r\n * @param {?Function} listener\r\n * @param {*} source Optional callback source to match.\r\n * @returns {object} This emitter.\r\n */\r\nfunction OffEvent(eventName = \"*\", listener = null, source = ANY_SOURCE)\r\n{\r\n    for (const record of FindEventRecords(this, eventName, listener, source))\r\n    {\r\n        RemoveEventRecord(record);\r\n    }\r\n\r\n    return this;\r\n}\r\n\r\n/**\r\n * Emits a lowercased exact event name to all currently registered records.\r\n *\r\n * @param {string} eventName\r\n * @param {...*} args\r\n * @returns {object} This emitter.\r\n */\r\nfunction EmitEvent(eventName, ...args)\r\n{\r\n    if ((getRuntimeState(this)?.suppressEvents ?? 0) > 0) return this;\r\n    const events = GetEventMap(this);\r\n    if (!events) return this;\r\n\r\n    const name = NormalizeEventName(eventName);\r\n    const records = events.get(name);\r\n    if (!records) return this;\r\n\r\n    let error = null;\r\n\r\n    try\r\n    {\r\n        for (const record of [ ...records ])\r\n        {\r\n            if (!records.has(record)) continue;\r\n            if (record.once) RemoveEventRecord(record);\r\n            record.listener.call(record.source, ...args);\r\n        }\r\n    }\r\n    catch (err)\r\n    {\r\n        error = err;\r\n    }\r\n\r\n    if (error) throw error;\r\n    return this;\r\n}\r\n\r\n/**\r\n * Checks whether this emitter has a matching listener record.\r\n *\r\n * @param {string} eventName\r\n * @param {?Function} listener\r\n * @param {*} source Optional callback source to match.\r\n * @returns {boolean}\r\n */\r\nfunction HasListener(eventName = \"*\", listener = null, source = ANY_SOURCE)\r\n{\r\n    // The state answers the cheap question - is ANYTHING listening - before a\r\n    // record search runs. \"HasEvent\" was the old name and claimed more than is\r\n    // knowable: any caller may emit any name at any time, so what can be known\r\n    // is whether something is LISTENING to one.\r\n    if (!getRuntimeState(this)?.HasListener(eventName)) return false;\r\n    return FindEventRecords(this, eventName, listener, source).length > 0;\r\n}\r\n\r\n/**\r\n * Clears an event bucket or all event buckets from this emitter.\r\n *\r\n * @param {string} eventName\r\n * @returns {object} This emitter.\r\n */\r\nfunction ClearEvent(eventName = \"*\")\r\n{\r\n    return this.OffEvent(eventName);\r\n}\r\n\r\n/**\r\n * Gets the lowercased exact event names with active listener buckets.\r\n *\r\n * @returns {Array<string>}\r\n */\r\nfunction GetEventNames()\r\n{\r\n    const events = GetEventMap(this);\r\n    return events ? [ ...events.keys() ] : [];\r\n}\r\n\r\n/**\r\n * Gets the number of active listener records for an event or all events.\r\n *\r\n * @param {string} eventName\r\n * @returns {number}\r\n */\r\nfunction GetEventListenerCount(eventName = \"*\")\r\n{\r\n    return FindEventRecords(this, eventName).length;\r\n}\r\n\r\n/** The notify surface, one implementation for both deliveries. */\r\nexport const NOTIFY_METHODS = Object.freeze({\r\n    AddEvents,\r\n    OnEvent,\r\n    OnceEvent,\r\n    OffEvent,\r\n    EmitEvent,\r\n    HasListener,\r\n    ClearEvent,\r\n    GetEventNames,\r\n    GetEventListenerCount\r\n});\r\n\r\n/**\r\n * Installs the notify surface onto a class's prototype, install-if-absent:\r\n * a method the class (or its chain) already answers keeps its own.\r\n *\r\n * @param {Function} Constructor\r\n * @returns {Function} The same constructor.\r\n */\r\nexport function installNotify(Constructor)\r\n{\r\n    for (const [ name, method ] of Object.entries(NOTIFY_METHODS))\r\n    {\r\n        if (name in Constructor.prototype) continue;\r\n\r\n        Object.defineProperty(Constructor.prototype, name, {\r\n            value: method,\r\n            writable: true,\r\n            configurable: true\r\n        });\r\n    }\r\n    return Constructor;\r\n}\r\n\r\n/**\r\n * The @compose.notify class decorator.\r\n *\r\n * @param {Function} value The decorated class.\r\n * @param {object} [context] Stage-3 decorator context.\r\n * @returns {void}\r\n */\r\nexport function composeNotifyDecorator(value, context)\r\n{\r\n    if (context && typeof context === \"object\" && context.kind !== \"class\")\r\n    {\r\n        throw new TypeError(\"compose.notify only supports classes.\");\r\n    }\r\n    if (typeof value !== \"function\")\r\n    {\r\n        throw new TypeError(\"compose.notify requires a class constructor.\");\r\n    }\r\n    installNotify(value);\r\n}\r\n\r\nfunction CreateEventRecord(emitter, eventName, listener, source, once)\r\n{\r\n    const name = NormalizeEventName(eventName);\r\n    if (typeof listener !== \"function\")\r\n    {\r\n        throw new TypeError(\"CjsEventEmitter.OnEvent requires a listener function.\");\r\n    }\r\n\r\n    const record = {\r\n        emitter,\r\n        eventName: name,\r\n        listener,\r\n        source,\r\n        once: !!once\r\n    };\r\n\r\n    const events = GetEventMap(emitter, true);\r\n\r\n    let records = events.get(name);\r\n    if (!records)\r\n    {\r\n        records = new Set();\r\n        events.set(name, records);\r\n    }\r\n\r\n    records.add(record);\r\n\r\n    return record;\r\n}\r\n\r\nfunction RemoveEventRecord(record)\r\n{\r\n    const events = GetEventMap(record.emitter);\r\n    const records = events?.get(record.eventName);\r\n\r\n    if (records)\r\n    {\r\n        records.delete(record);\r\n        if (!records.size) events.delete(record.eventName);\r\n        if (!events.size)\r\n        {\r\n            const state = getRuntimeState(record.emitter);\r\n            delete state.events;\r\n            // The override goes with the map, so the stub answers false again.\r\n            delete state.HasListener;\r\n        }\r\n    }\r\n}\r\n\r\nfunction NormalizeEventName(eventName)\r\n{\r\n    const name = String(eventName || \"\").trim().toLowerCase();\r\n    if (!name) throw new TypeError(\"CjsEventEmitter requires an event name.\");\r\n    return name;\r\n}\r\n\r\nfunction FindEventRecords(emitter, eventName = \"*\", listener = null, source = ANY_SOURCE)\r\n{\r\n    const events = GetEventMap(emitter);\r\n    if (!events) return [];\r\n\r\n    const names = eventName === \"*\" ? [ ...events.keys() ] : [ NormalizeEventName(eventName) ];\r\n    const result = [];\r\n\r\n    for (const name of names)\r\n    {\r\n        const records = events.get(name);\r\n        if (!records) continue;\r\n\r\n        for (const record of records)\r\n        {\r\n            if (listener && record.listener !== listener) continue;\r\n            if (source !== ANY_SOURCE && record.source !== source) continue;\r\n            result.push(record);\r\n        }\r\n    }\r\n\r\n    return result;\r\n}\r\n\r\nfunction NormalizeEventEntry(key, value)\r\n{\r\n    let eventName = String(key);\r\n    let once = false;\r\n    let listener = value;\r\n    let source = null;\r\n\r\n    if (eventName.endsWith(\".once\"))\r\n    {\r\n        eventName = eventName.slice(0, -5);\r\n        once = true;\r\n    }\r\n\r\n    if (Array.isArray(value))\r\n    {\r\n        [ listener, source = null ] = value;\r\n    }\r\n\r\n    if (typeof listener !== \"function\")\r\n    {\r\n        throw new TypeError(\"CjsEventEmitter.AddEvents requires listener functions.\");\r\n    }\r\n\r\n    return { eventName, listener, source, once };\r\n}\r\n\r\n/**\r\n * The HasListener an object carries WHILE it has listeners, hijacking the\r\n * runtime-state prototype's always-false stub.\r\n *\r\n * @param {string} [eventName]\r\n * @returns {Boolean}\r\n */\r\nfunction HasListenerWithEvents(eventName = \"*\")\r\n{\r\n    if (eventName === \"*\") return true;\r\n\r\n    const records = this.events?.get(NormalizeEventName(eventName));\r\n    return records ? records.size > 0 : false;\r\n}\r\n\r\nfunction GetEventMap(emitter, create = false)\r\n{\r\n    const state = create ? ensureRuntimeState(emitter) : getRuntimeState(emitter);\r\n    if (!state) return null;\r\n\r\n    if (state.events === undefined)\r\n    {\r\n        if (!create) return null;\r\n        state.events = new Map();\r\n        // Installed the way the decorators install anything - defineProperty,\r\n        // non-enumerable, configurable so it can be removed again. A shared\r\n        // function reference: one property slot, no closure.\r\n        Object.defineProperty(state, \"HasListener\", {\r\n            value: HasListenerWithEvents,\r\n            writable: true,\r\n            configurable: true\r\n        });\r\n    }\r\n    else if (!(state.events instanceof Map))\r\n    {\r\n        throw new TypeError(\"CjsEventEmitter requires __state.events to be a Map.\");\r\n    }\r\n\r\n    return state.events;\r\n}\r\n"],"names":["ANY_SOURCE","Symbol","AddEvents","events","key","Object","keys","entry","NormalizeEventEntry","OnEvent","eventName","listener","source","once","CreateEventRecord","OnceEvent","OffEvent","record","FindEventRecords","RemoveEventRecord","EmitEvent","args","getRuntimeState","suppressEvents","GetEventMap","name","NormalizeEventName","records","get","error","has","call","err","HasListener","length","ClearEvent","GetEventNames","GetEventListenerCount","NOTIFY_METHODS","freeze","installNotify","Constructor","method","entries","prototype","defineProperty","value","writable","configurable","composeNotifyDecorator","context","kind","TypeError","emitter","Set","set","add","delete","size","state","String","trim","toLowerCase","names","result","push","endsWith","slice","Array","isArray","HasListenerWithEvents","create","ensureRuntimeState","undefined","Map"],"mappings":"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"}
+{"version":3,"file":"notify.js","sources":["../../../../src/global/compose/notify.js"],"sourcesContent":["// The notify surface as COMPOSITION - the @compose.notify decorator and the\r\n// method map behind it (design record: docs/research/\r\n// cjsmodel-value-audit-2026-09-05.md, direction items 9 and 11).\r\n//\r\n// Carbon's word for the concept is notify (INotify / Be::NOTIFY /\r\n// IListNotify); this surface deliberately widens Carbon's single slot to a\r\n// subscriber list, which is a registered non-Carbon extension (origin:\r\n// ccpwgl Tw2EventEmitter). NO BRAND AND NO hasInstance, ruled: \"we control\r\n// the contract - if an OnEvent method didn't exist, it would throw\", and\r\n// discrimination exists only where Carbon itself casts.\r\n//\r\n// State is lazy on first listener and DELETED when the last listener leaves\r\n// (the emitter costs nothing while unobserved - the operator's GC concern is\r\n// the design constraint here). The state slot is the shared __state expando\r\n// (./runtimeState.js) - both live in global/compose, the home of what\r\n// @compose.* installs and the state those installations share.\r\n//\r\n// CjsEventEmitter remains as the inheritance packaging over this same map -\r\n// one implementation, two deliveries.\r\n\r\nimport { ensureRuntimeState, getRuntimeState } from \"./runtimeState.js\";\r\n\r\nconst ANY_SOURCE = Symbol(\"CjsNotify.AnySource\");\r\n\r\n/**\r\n * Adds event listeners from a plain object. A key ending in \".once\"\r\n * registers a once-only listener; values may be a function or\r\n * [function, source].\r\n *\r\n * @param {object|null} events\r\n * @returns {object} This emitter.\r\n */\r\nfunction AddEvents(events = null)\r\n{\r\n    if (!events || typeof events !== \"object\") return this;\r\n\r\n    for (const key of Object.keys(events))\r\n    {\r\n        const entry = NormalizeEventEntry(key, events[key]);\r\n        this.OnEvent(entry.eventName, entry.listener, entry.source, entry.once);\r\n    }\r\n\r\n    return this;\r\n}\r\n\r\n/**\r\n * Adds a listener for a lowercased exact event name.\r\n *\r\n * @param {string} eventName\r\n * @param {Function} listener\r\n * @param {*} source Optional callback source and `this` value.\r\n * @param {boolean} once\r\n * @returns {object} This emitter.\r\n */\r\nfunction OnEvent(eventName, listener, source = null, once = false)\r\n{\r\n    CreateEventRecord(this, eventName, listener, source, once);\r\n    return this;\r\n}\r\n\r\n/**\r\n * Adds a listener that is removed before its first callback is invoked.\r\n *\r\n * @param {string} eventName\r\n * @param {Function} listener\r\n * @param {*} source Optional callback source and `this` value.\r\n * @returns {object} This emitter.\r\n */\r\nfunction OnceEvent(eventName, listener, source = null)\r\n{\r\n    return this.OnEvent(eventName, listener, source, true);\r\n}\r\n\r\n/**\r\n * Removes matching listeners from this emitter. `eventName=\"*\"` means all\r\n * event buckets - cleanup matching only, not wildcard dispatch.\r\n *\r\n * @param {string} eventName\r\n * @param {?Function} listener\r\n * @param {*} source Optional callback source to match.\r\n * @returns {object} This emitter.\r\n */\r\nfunction OffEvent(eventName = \"*\", listener = null, source = ANY_SOURCE)\r\n{\r\n    for (const record of FindEventRecords(this, eventName, listener, source))\r\n    {\r\n        RemoveEventRecord(record);\r\n    }\r\n\r\n    return this;\r\n}\r\n\r\n/**\r\n * Emits a lowercased exact event name to all currently registered records.\r\n *\r\n * THE LISTENER RECEIVES THE EVENT NAME AS ITS FIRST ARGUMENT, before the\r\n * emitted arguments. Carbon does the same in both notify hooks - INotify\r\n * OnModified is handed the member that changed, and IListNotify\r\n * OnListModified takes the BLUELISTEVENT code as argument one - so the\r\n * observer is always told WHAT happened and decides for itself. Without it a\r\n * listener registered for two events cannot tell them apart, and ccpwgl keeps\r\n * a closure per event name for exactly that reason; the missing name is a bug\r\n * in the emitter this one descends from (operator, 2026-09-17).\r\n *\r\n * @param {string} eventName\r\n * @param {...*} args\r\n * @returns {object} This emitter.\r\n */\r\nfunction EmitEvent(eventName, ...args)\r\n{\r\n    if ((getRuntimeState(this)?.suppressEvents ?? 0) > 0) return this;\r\n    const events = GetEventMap(this);\r\n    if (!events) return this;\r\n\r\n    const name = NormalizeEventName(eventName);\r\n    const records = events.get(name);\r\n    if (!records) return this;\r\n\r\n    let error = null;\r\n\r\n    try\r\n    {\r\n        for (const record of [ ...records ])\r\n        {\r\n            if (!records.has(record)) continue;\r\n            if (record.once) RemoveEventRecord(record);\r\n            record.listener.call(record.source, name, ...args);\r\n        }\r\n    }\r\n    catch (err)\r\n    {\r\n        error = err;\r\n    }\r\n\r\n    if (error) throw error;\r\n    return this;\r\n}\r\n\r\n/**\r\n * Checks whether this emitter has a matching listener record.\r\n *\r\n * @param {string} eventName\r\n * @param {?Function} listener\r\n * @param {*} source Optional callback source to match.\r\n * @returns {boolean}\r\n */\r\nfunction HasListener(eventName = \"*\", listener = null, source = ANY_SOURCE)\r\n{\r\n    // The state answers the cheap question - is ANYTHING listening - before a\r\n    // record search runs. \"HasEvent\" was the old name and claimed more than is\r\n    // knowable: any caller may emit any name at any time, so what can be known\r\n    // is whether something is LISTENING to one.\r\n    if (!getRuntimeState(this)?.HasListener(eventName)) return false;\r\n    return FindEventRecords(this, eventName, listener, source).length > 0;\r\n}\r\n\r\n/**\r\n * Clears an event bucket or all event buckets from this emitter.\r\n *\r\n * @param {string} eventName\r\n * @returns {object} This emitter.\r\n */\r\nfunction ClearEvent(eventName = \"*\")\r\n{\r\n    return this.OffEvent(eventName);\r\n}\r\n\r\n/**\r\n * Gets the lowercased exact event names with active listener buckets.\r\n *\r\n * @returns {Array<string>}\r\n */\r\nfunction GetEventNames()\r\n{\r\n    const events = GetEventMap(this);\r\n    return events ? [ ...events.keys() ] : [];\r\n}\r\n\r\n/**\r\n * Gets the number of active listener records for an event or all events.\r\n *\r\n * @param {string} eventName\r\n * @returns {number}\r\n */\r\nfunction GetEventListenerCount(eventName = \"*\")\r\n{\r\n    return FindEventRecords(this, eventName).length;\r\n}\r\n\r\n/** The notify surface, one implementation for both deliveries. */\r\nexport const NOTIFY_METHODS = Object.freeze({\r\n    AddEvents,\r\n    OnEvent,\r\n    OnceEvent,\r\n    OffEvent,\r\n    EmitEvent,\r\n    HasListener,\r\n    ClearEvent,\r\n    GetEventNames,\r\n    GetEventListenerCount\r\n});\r\n\r\n/**\r\n * Installs the notify surface onto a class's prototype, install-if-absent:\r\n * a method the class (or its chain) already answers keeps its own.\r\n *\r\n * @param {Function} Constructor\r\n * @returns {Function} The same constructor.\r\n */\r\nexport function installNotify(Constructor)\r\n{\r\n    for (const [ name, method ] of Object.entries(NOTIFY_METHODS))\r\n    {\r\n        if (name in Constructor.prototype) continue;\r\n\r\n        Object.defineProperty(Constructor.prototype, name, {\r\n            value: method,\r\n            writable: true,\r\n            configurable: true\r\n        });\r\n    }\r\n    return Constructor;\r\n}\r\n\r\n/**\r\n * The @compose.notify class decorator.\r\n *\r\n * @param {Function} value The decorated class.\r\n * @param {object} [context] Stage-3 decorator context.\r\n * @returns {void}\r\n */\r\nexport function composeNotifyDecorator(value, context)\r\n{\r\n    if (context && typeof context === \"object\" && context.kind !== \"class\")\r\n    {\r\n        throw new TypeError(\"compose.notify only supports classes.\");\r\n    }\r\n    if (typeof value !== \"function\")\r\n    {\r\n        throw new TypeError(\"compose.notify requires a class constructor.\");\r\n    }\r\n    installNotify(value);\r\n}\r\n\r\nfunction CreateEventRecord(emitter, eventName, listener, source, once)\r\n{\r\n    const name = NormalizeEventName(eventName);\r\n    if (typeof listener !== \"function\")\r\n    {\r\n        throw new TypeError(\"CjsEventEmitter.OnEvent requires a listener function.\");\r\n    }\r\n\r\n    const record = {\r\n        emitter,\r\n        eventName: name,\r\n        listener,\r\n        source,\r\n        once: !!once\r\n    };\r\n\r\n    const events = GetEventMap(emitter, true);\r\n\r\n    let records = events.get(name);\r\n    if (!records)\r\n    {\r\n        records = new Set();\r\n        events.set(name, records);\r\n    }\r\n\r\n    records.add(record);\r\n\r\n    return record;\r\n}\r\n\r\nfunction RemoveEventRecord(record)\r\n{\r\n    const events = GetEventMap(record.emitter);\r\n    const records = events?.get(record.eventName);\r\n\r\n    if (records)\r\n    {\r\n        records.delete(record);\r\n        if (!records.size) events.delete(record.eventName);\r\n        if (!events.size)\r\n        {\r\n            const state = getRuntimeState(record.emitter);\r\n            delete state.events;\r\n            // The override goes with the map, so the stub answers false again.\r\n            delete state.HasListener;\r\n        }\r\n    }\r\n}\r\n\r\nfunction NormalizeEventName(eventName)\r\n{\r\n    const name = String(eventName || \"\").trim().toLowerCase();\r\n    if (!name) throw new TypeError(\"CjsEventEmitter requires an event name.\");\r\n    return name;\r\n}\r\n\r\nfunction FindEventRecords(emitter, eventName = \"*\", listener = null, source = ANY_SOURCE)\r\n{\r\n    const events = GetEventMap(emitter);\r\n    if (!events) return [];\r\n\r\n    const names = eventName === \"*\" ? [ ...events.keys() ] : [ NormalizeEventName(eventName) ];\r\n    const result = [];\r\n\r\n    for (const name of names)\r\n    {\r\n        const records = events.get(name);\r\n        if (!records) continue;\r\n\r\n        for (const record of records)\r\n        {\r\n            if (listener && record.listener !== listener) continue;\r\n            if (source !== ANY_SOURCE && record.source !== source) continue;\r\n            result.push(record);\r\n        }\r\n    }\r\n\r\n    return result;\r\n}\r\n\r\nfunction NormalizeEventEntry(key, value)\r\n{\r\n    let eventName = String(key);\r\n    let once = false;\r\n    let listener = value;\r\n    let source = null;\r\n\r\n    if (eventName.endsWith(\".once\"))\r\n    {\r\n        eventName = eventName.slice(0, -5);\r\n        once = true;\r\n    }\r\n\r\n    if (Array.isArray(value))\r\n    {\r\n        [ listener, source = null ] = value;\r\n    }\r\n\r\n    if (typeof listener !== \"function\")\r\n    {\r\n        throw new TypeError(\"CjsEventEmitter.AddEvents requires listener functions.\");\r\n    }\r\n\r\n    return { eventName, listener, source, once };\r\n}\r\n\r\n/**\r\n * The HasListener an object carries WHILE it has listeners, hijacking the\r\n * runtime-state prototype's always-false stub.\r\n *\r\n * @param {string} [eventName]\r\n * @returns {Boolean}\r\n */\r\nfunction HasListenerWithEvents(eventName = \"*\")\r\n{\r\n    if (eventName === \"*\") return true;\r\n\r\n    const records = this.events?.get(NormalizeEventName(eventName));\r\n    return records ? records.size > 0 : false;\r\n}\r\n\r\nfunction GetEventMap(emitter, create = false)\r\n{\r\n    const state = create ? ensureRuntimeState(emitter) : getRuntimeState(emitter);\r\n    if (!state) return null;\r\n\r\n    if (state.events === undefined)\r\n    {\r\n        if (!create) return null;\r\n        state.events = new Map();\r\n        // Installed the way the decorators install anything - defineProperty,\r\n        // non-enumerable, configurable so it can be removed again. A shared\r\n        // function reference: one property slot, no closure.\r\n        Object.defineProperty(state, \"HasListener\", {\r\n            value: HasListenerWithEvents,\r\n            writable: true,\r\n            configurable: true\r\n        });\r\n    }\r\n    else if (!(state.events instanceof Map))\r\n    {\r\n        throw new TypeError(\"CjsEventEmitter requires __state.events to be a Map.\");\r\n    }\r\n\r\n    return state.events;\r\n}\r\n"],"names":["ANY_SOURCE","Symbol","AddEvents","events","key","Object","keys","entry","NormalizeEventEntry","OnEvent","eventName","listener","source","once","CreateEventRecord","OnceEvent","OffEvent","record","FindEventRecords","RemoveEventRecord","EmitEvent","args","getRuntimeState","suppressEvents","GetEventMap","name","NormalizeEventName","records","get","error","has","call","err","HasListener","length","ClearEvent","GetEventNames","GetEventListenerCount","NOTIFY_METHODS","freeze","installNotify","Constructor","method","entries","prototype","defineProperty","value","writable","configurable","composeNotifyDecorator","context","kind","TypeError","emitter","Set","set","add","delete","size","state","String","trim","toLowerCase","names","result","push","endsWith","slice","Array","isArray","HasListenerWithEvents","create","ensureRuntimeState","undefined","Map"],"mappings":"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"}