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

package/dist/global/schema/hydration.js

@@ -1,3 +1,5 @@
+import { CjsSchema } from './CjsSchema.js';
+
 /**
  * Hydration adapter seam - the population contract for readers that build
  * runtime objects incrementally (black/red). The ordering guarantee:
@@ -24,8 +26,16 @@
  * SetValues is called directly rather than through CjsSchema.setValues so a
  * reader works with only the schema layer loaded; the two are the same path
  * for every class that has the method.
+ *
+ * A REGISTERED class without SetValues - one that no longer extends CjsModel -
+ * is still a resolved class, so it populates through CjsSchema.setValues, which
+ * answers without the model layer. Only an unregistered carrier (the reader's
+ * `{ _sourceClassName }` fallback) takes raw assignment. Without this middle
+ * arm, taking a class off the base would silently drop it to Object.assign:
+ * no coercion, no writability gate, no settle.
  */
 
+
 /**
  * Resolves a normalized adapter from hydration options. The returned object
  * always exposes construct/applyValues/finalize with the documented defaults.
@@ -47,6 +57,10 @@ function resolveHydrationAdapter(options = {}) {
         instance.SetValues(values, ctx?.options);
         return instance;
       }
+      if (instance && CjsSchema.getClassName(instance.constructor)) {
+        CjsSchema.setValues(instance, values, ctx?.options);
+        return instance;
+      }
       return Object.assign(instance, values);
     },
     finalize(instance, ctx) {

package/dist/global/schema/hydration.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydration.js","sources":["../../../../src/global/schema/hydration.js"],"sourcesContent":["/**\n * Hydration adapter seam - the population contract for readers that build\n * runtime objects incrementally (black/red). The ordering guarantee:\n *\n *   1. construct   - build every instance (register refs before values, so\n *                    cycles/back-references resolve)\n *   2. applyValues - apply each node's field values\n *   3. finalize    - run once per instance AFTER the whole graph is built,\n *                    so references are already resolved\n *\n * DEFAULTS (operator ruling, 2026-09-05; resource-population.md owns the\n * decision): a resolved class is populated through its own validated setter -\n * \"if someone is using Object.assign, they probably should be using\n * SetValues\" - and a class-owned Initialize runs once post-graph, which is\n * the incremental-reader counterpart of the reader+IInitialize handshake\n * Blue performs and CjsModel.from performs for whole-bag JSON. Plain\n * fallback carriers (unresolved kinds) keep raw assignment: that IS their\n * contract, not a bypass.\n *\n * The single escape hatch is `options.adapter`, per-hook optional. The\n * per-kind adapters map and the hydrationAdapter alias are gone - they had\n * zero consumers. Callers wanting raw assignment pass their own adapter.\n *\n * SetValues is called directly rather than through CjsSchema.setValues so a\n * reader works with only the schema layer loaded; the two are the same path\n * for every class that has the method.\n */\n\n/**\n * Resolves a normalized adapter from hydration options. The returned object\n * always exposes construct/applyValues/finalize with the documented defaults.\n *\n * @param {Object} [options]\n * @param {Object} [options.adapter] Per-hook overrides: construct/applyValues/finalize.\n * @returns {{ construct: Function, applyValues: Function, finalize: Function }}\n */\nexport function resolveHydrationAdapter(options = {})\n{\n    const custom = options.adapter || null;\n\n    return {\n        construct(kind, ctx)\n        {\n            if (custom && typeof custom.construct === \"function\") return custom.construct(kind, ctx);\n            return undefined;\n        },\n        applyValues(instance, values, ctx)\n        {\n            if (custom && typeof custom.applyValues === \"function\") return custom.applyValues(instance, values, ctx);\n            if (instance && typeof instance.SetValues === \"function\")\n            {\n                instance.SetValues(values, ctx?.options);\n                return instance;\n            }\n            return Object.assign(instance, values);\n        },\n        finalize(instance, ctx)\n        {\n            if (custom && typeof custom.finalize === \"function\")\n            {\n                custom.finalize(instance, ctx);\n                return;\n            }\n            if (instance && typeof instance.Initialize === \"function\") instance.Initialize();\n        }\n    };\n}\n"],"names":["resolveHydrationAdapter","options","custom","adapter","construct","kind","ctx","undefined","applyValues","instance","values","SetValues","Object","assign","finalize","Initialize"],"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;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,uBAAuBA,CAACC,OAAO,GAAG,EAAE,EACpD;AACI,EAAA,MAAMC,MAAM,GAAGD,OAAO,CAACE,OAAO,IAAI,IAAI;EAEtC,OAAO;AACHC,IAAAA,SAASA,CAACC,IAAI,EAAEC,GAAG,EACnB;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACE,SAAS,KAAK,UAAU,EAAE,OAAOF,MAAM,CAACE,SAAS,CAACC,IAAI,EAAEC,GAAG,CAAC;AACxF,MAAA,OAAOC,SAAS;IACpB,CAAC;AACDC,IAAAA,WAAWA,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,EACjC;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACM,WAAW,KAAK,UAAU,EAAE,OAAON,MAAM,CAACM,WAAW,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,CAAC;MACxG,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACE,SAAS,KAAK,UAAU,EACxD;QACIF,QAAQ,CAACE,SAAS,CAACD,MAAM,EAAEJ,GAAG,EAAEL,OAAO,CAAC;AACxC,QAAA,OAAOQ,QAAQ;AACnB,MAAA;AACA,MAAA,OAAOG,MAAM,CAACC,MAAM,CAACJ,QAAQ,EAAEC,MAAM,CAAC;IAC1C,CAAC;AACDI,IAAAA,QAAQA,CAACL,QAAQ,EAAEH,GAAG,EACtB;MACI,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACY,QAAQ,KAAK,UAAU,EACnD;AACIZ,QAAAA,MAAM,CAACY,QAAQ,CAACL,QAAQ,EAAEH,GAAG,CAAC;AAC9B,QAAA;AACJ,MAAA;AACA,MAAA,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACM,UAAU,KAAK,UAAU,EAAEN,QAAQ,CAACM,UAAU,EAAE;AACpF,IAAA;GACH;AACL;;;;"}
+{"version":3,"file":"hydration.js","sources":["../../../../src/global/schema/hydration.js"],"sourcesContent":["/**\n * Hydration adapter seam - the population contract for readers that build\n * runtime objects incrementally (black/red). The ordering guarantee:\n *\n *   1. construct   - build every instance (register refs before values, so\n *                    cycles/back-references resolve)\n *   2. applyValues - apply each node's field values\n *   3. finalize    - run once per instance AFTER the whole graph is built,\n *                    so references are already resolved\n *\n * DEFAULTS (operator ruling, 2026-09-05; resource-population.md owns the\n * decision): a resolved class is populated through its own validated setter -\n * \"if someone is using Object.assign, they probably should be using\n * SetValues\" - and a class-owned Initialize runs once post-graph, which is\n * the incremental-reader counterpart of the reader+IInitialize handshake\n * Blue performs and CjsModel.from performs for whole-bag JSON. Plain\n * fallback carriers (unresolved kinds) keep raw assignment: that IS their\n * contract, not a bypass.\n *\n * The single escape hatch is `options.adapter`, per-hook optional. The\n * per-kind adapters map and the hydrationAdapter alias are gone - they had\n * zero consumers. Callers wanting raw assignment pass their own adapter.\n *\n * SetValues is called directly rather than through CjsSchema.setValues so a\n * reader works with only the schema layer loaded; the two are the same path\n * for every class that has the method.\n *\n * A REGISTERED class without SetValues - one that no longer extends CjsModel -\n * is still a resolved class, so it populates through CjsSchema.setValues, which\n * answers without the model layer. Only an unregistered carrier (the reader's\n * `{ _sourceClassName }` fallback) takes raw assignment. Without this middle\n * arm, taking a class off the base would silently drop it to Object.assign:\n * no coercion, no writability gate, no settle.\n */\n\nimport { CjsSchema } from \"./CjsSchema.js\";\n\n/**\n * Resolves a normalized adapter from hydration options. The returned object\n * always exposes construct/applyValues/finalize with the documented defaults.\n *\n * @param {Object} [options]\n * @param {Object} [options.adapter] Per-hook overrides: construct/applyValues/finalize.\n * @returns {{ construct: Function, applyValues: Function, finalize: Function }}\n */\nexport function resolveHydrationAdapter(options = {})\n{\n    const custom = options.adapter || null;\n\n    return {\n        construct(kind, ctx)\n        {\n            if (custom && typeof custom.construct === \"function\") return custom.construct(kind, ctx);\n            return undefined;\n        },\n        applyValues(instance, values, ctx)\n        {\n            if (custom && typeof custom.applyValues === \"function\") return custom.applyValues(instance, values, ctx);\n            if (instance && typeof instance.SetValues === \"function\")\n            {\n                instance.SetValues(values, ctx?.options);\n                return instance;\n            }\n            if (instance && CjsSchema.getClassName(instance.constructor))\n            {\n                CjsSchema.setValues(instance, values, ctx?.options);\n                return instance;\n            }\n            return Object.assign(instance, values);\n        },\n        finalize(instance, ctx)\n        {\n            if (custom && typeof custom.finalize === \"function\")\n            {\n                custom.finalize(instance, ctx);\n                return;\n            }\n            if (instance && typeof instance.Initialize === \"function\") instance.Initialize();\n        }\n    };\n}\n"],"names":["resolveHydrationAdapter","options","custom","adapter","construct","kind","ctx","undefined","applyValues","instance","values","SetValues","CjsSchema","getClassName","constructor","setValues","Object","assign","finalize","Initialize"],"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;AACA;AACA;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,uBAAuBA,CAACC,OAAO,GAAG,EAAE,EACpD;AACI,EAAA,MAAMC,MAAM,GAAGD,OAAO,CAACE,OAAO,IAAI,IAAI;EAEtC,OAAO;AACHC,IAAAA,SAASA,CAACC,IAAI,EAAEC,GAAG,EACnB;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACE,SAAS,KAAK,UAAU,EAAE,OAAOF,MAAM,CAACE,SAAS,CAACC,IAAI,EAAEC,GAAG,CAAC;AACxF,MAAA,OAAOC,SAAS;IACpB,CAAC;AACDC,IAAAA,WAAWA,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,EACjC;AACI,MAAA,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACM,WAAW,KAAK,UAAU,EAAE,OAAON,MAAM,CAACM,WAAW,CAACC,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,CAAC;MACxG,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACE,SAAS,KAAK,UAAU,EACxD;QACIF,QAAQ,CAACE,SAAS,CAACD,MAAM,EAAEJ,GAAG,EAAEL,OAAO,CAAC;AACxC,QAAA,OAAOQ,QAAQ;AACnB,MAAA;MACA,IAAIA,QAAQ,IAAIG,SAAS,CAACC,YAAY,CAACJ,QAAQ,CAACK,WAAW,CAAC,EAC5D;QACIF,SAAS,CAACG,SAAS,CAACN,QAAQ,EAAEC,MAAM,EAAEJ,GAAG,EAAEL,OAAO,CAAC;AACnD,QAAA,OAAOQ,QAAQ;AACnB,MAAA;AACA,MAAA,OAAOO,MAAM,CAACC,MAAM,CAACR,QAAQ,EAAEC,MAAM,CAAC;IAC1C,CAAC;AACDQ,IAAAA,QAAQA,CAACT,QAAQ,EAAEH,GAAG,EACtB;MACI,IAAIJ,MAAM,IAAI,OAAOA,MAAM,CAACgB,QAAQ,KAAK,UAAU,EACnD;AACIhB,QAAAA,MAAM,CAACgB,QAAQ,CAACT,QAAQ,EAAEH,GAAG,CAAC;AAC9B,QAAA;AACJ,MAAA;AACA,MAAA,IAAIG,QAAQ,IAAI,OAAOA,QAAQ,CAACU,UAAU,KAAK,UAAU,EAAEV,QAAQ,CAACU,UAAU,EAAE;AACpF,IAAA;GACH;AACL;;;;"}

package/dist/resource/formats/webgl/core/glsl/DxbcGlslEmitter.js

@@ -395,13 +395,23 @@ class DxbcGlslEmitter {
       this._analyzeUavStores(state);
     }
     state.integerVertexInputs = new Map();
+    // Register -> GLSL integer built-in (`gl_VertexID`/`gl_InstanceID`) for
+    // system-value inputs; filled by _declareSystemInput.
+    state.systemIntegerInputs = new Map();
+    // Integer companions for temporaries. Small integers held as float bit
+    // patterns are denormals, and ANGLE/D3D11 hardware does not preserve
+    // them in float storage: a vertex-id corner index `r0.x = uintBitsToFloat(id & 3u)`
+    // reads back 0 for ids 1..3, collapsing every quad (plane sets, the sprite
+    // pool). Packed-light shaders need the same companions for their words.
+    state.integerTemps = !!state.lightPackedTexture || state.decoder.instructions.some(instruction => (instruction.opcodeName === "dcl_input_sgv" || instruction.opcodeName === "dcl_input_ps_sgv") && (instruction.declaration?.systemValueName === "vertex_id" || instruction.declaration?.systemValueName === "instance_id"));
     state.formatter = new DxbcGlslOperandFormatter({
       // Populated during vertex-input declaration (the declaration loop
       // runs before any body emission, so the map is complete before the
       // first operand is formatted). Integer reads of these registers
       // value-convert instead of bitcast - see _declareVertexInput.
       integerInputs: state.integerVertexInputs,
-      integerTemps: !!state.lightPackedTexture,
+      integerTemps: state.integerTemps,
+      systemIntegerInputs: state.systemIntegerInputs,
       componentMap: operand => {
         if (operand.type === 1) return state.inputMasks.get(operand.registerIndex) || null;
         if (operand.type === 2) return state.outputMasks.get(operand.registerIndex) || null;
@@ -1109,7 +1119,7 @@ class DxbcGlslEmitter {
       case "dcl_temps":
         for (let index = 0; index < declaration.tempCount; index += 1) {
           state.declarationLines.push(`vec4 r${index};`);
-          if (state.lightPackedTexture) state.declarationLines.push(`uvec4 cjsBitsR${index};`);
+          if (state.integerTemps) state.declarationLines.push(`uvec4 cjsBitsR${index};`);
         }
         break;
       case "dcl_indexable_temp":
@@ -1515,9 +1525,11 @@ class DxbcGlslEmitter {
         break;
       case "vertex_id":
         state.inputNames.set(register, "vec4(intBitsToFloat(gl_VertexID))");
+        state.systemIntegerInputs.set(register, "gl_VertexID");
         break;
       case "instance_id":
         state.inputNames.set(register, "vec4(intBitsToFloat(gl_InstanceID))");
+        state.systemIntegerInputs.set(register, "gl_InstanceID");
         break;
       default:
         throw new WebglReadError("System-generated input is not supported by the WebGL2 emitter", {
@@ -1759,7 +1771,7 @@ class DxbcGlslEmitter {
     // Centralize writes here because several lowerings emit lane writes
     // directly rather than going through _assign. This is per assignment,
     // not a shader/register-number pattern or a control-flow dataflow guess.
-    const assignment = state.lightPackedTexture && /^(r(\d+)(?:\.[xyzw]+)?) = ([\s\S]+);$/.exec(text);
+    const assignment = state.integerTemps && /^(r(\d+)(?:\.[xyzw]+)?) = ([\s\S]+);$/.exec(text);
     if (assignment) {
       const [, target, index, value] = assignment;
       const suffix = target.slice(`r${index}`.length);
@@ -2128,7 +2140,7 @@ class DxbcGlslEmitter {
     } = this._destMask(state, instruction);
     if (!target) return;
     const aliases = instruction.operands.slice(1).some(operand => operand.type === destOperand.type && operand.registerIndex === destOperand.registerIndex);
-    const rawMove = !!state.lightPackedTexture && destOperand.type === 0;
+    const rawMove = state.integerTemps && destOperand.type === 0;
     if (aliases) {
       this._line(state, "{");
       state.indent += 1;
@@ -2503,7 +2515,7 @@ DxbcGlslEmitter.LOWERINGS = {
     const {
       mask
     } = this._destMask(state, instruction);
-    if (state.lightPackedTexture && instruction.operands[0].type === 0 && !instruction.saturate && !["neg", "abs", "absneg"].includes(instruction.operands[1].modifierName)) {
+    if (state.integerTemps && instruction.operands[0].type === 0 && !instruction.saturate && !["neg", "abs", "absneg"].includes(instruction.operands[1].modifierName)) {
       const raw = this._vecArg(state, instruction.operands[1], mask, "uint");
       this._assign(state, instruction, `uintBitsToFloat(${raw})`);
       return;