@carbonenginejs/runtime-trinity 0.5.0 → 0.7.0

package/dist/renderJob/TriRenderJob.js

@@ -1,10 +1,15 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { io, type, carbon, impl, schema } from '@carbonenginejs/core-types/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, type, carbon, impl, schema } from '@carbonenginejs/runtime-utils/schema';
 import { Tr2RenderContext as _Tr2RenderContext } from '../trinityCore/Tr2RenderContext.js';
 import { TriRenderStep as _TriRenderStep } from './TriRenderStep.js';
 
 let _initProto, _initClass, _init_status, _init_extra_status, _init_stackGuard, _init_extra_stackGuard, _init_enabled, _init_extra_enabled, _init_name, _init_extra_name, _init_steps, _init_extra_steps;
+
+/**
+ * An ordered list of render steps plus the cursor and status that let the
+ * sequence pause mid-list and resume on a later frame.
+ */
 let _TriRenderJob;
 new class extends _identity {
   static [class TriRenderJob extends CjsModel {
@@ -23,6 +28,15 @@ new class extends _identity {
     name = (_init_extra_enabled(this), _init_name(this, ""));
     steps = (_init_extra_name(this), _init_steps(this, []));
     #currentStep = (_init_extra_steps(this), 0);
+
+    /**
+     * Carbon TriRenderJob::Run (cpp:18-125): runs the steps in order against a snapshot of the list, resuming at the persisted cursor when the previous run left the job RJ_IN_PROGRESS, and stopping at the first step that does not return RS_OK or that disables the job.
+     * Each step is bracketed by begin/end so the end hook runs even when execution throws. When stackGuard is set, the executor's render-target and depth-stencil depths are compared against the depths recorded on entry: shortfalls are reported as diagnostics and surplus pushes are popped back to the baseline.
+     * @param {number} realTime wall-clock time passed through to each step
+     * @param {number} simTime simulation time passed through to each step
+     * @param {object} [executor] performs the actual work described by the steps; defaults to the shared Tr2RenderContext. It may take over step dispatch by implementing BeginStep/ExecuteStep/EndStep.
+     * @returns {number} the resulting TriRenderJob.Status
+     */
     Run(realTime, simTime, executor = null) {
       if (!this.enabled) return _TriRenderJob.Status.RJ_DONE;
       const context = executor || _Tr2RenderContext.GetDefault();
@@ -105,6 +119,51 @@ new class extends _identity {
       }
       return this.status;
     }
+
+    /**
+     * Treats a step as enabled through its IsEnabled method, or when it has none,
+     * through an enabled field that is not false.
+     */
+
+    /**
+     * Gives the executor first refusal on step setup via BeginStep, and otherwise
+     * calls the step's own BeginExecute.
+     */
+
+    /**
+     * Gives the executor first refusal on step execution via ExecuteStep, and
+     * otherwise calls the step's own Execute; the returned step result decides
+     * whether the job continues.
+     */
+
+    /**
+     * Gives the executor first refusal on step teardown via EndStep, and otherwise
+     * calls the step's own EndExecute; the caller runs this even when execution
+     * threw.
+     */
+
+    /**
+     * Reads a stack depth off the executor, mapping a missing, negative or
+     * non-finite value to 0 so executors that do not track stacks never trip the
+     * guard.
+     */
+
+    /**
+     * Reports a stack-underflow diagnostic when the executor's render-target or
+     * depth-stencil depth has dropped below the depth recorded at job entry, the
+     * condition Carbon asserts on (TriRenderJob.cpp:63-64).
+     */
+
+    /**
+     * Pops the executor's stack back down to the depth recorded at job entry,
+     * mirroring Carbon's stack repair loop (TriRenderJob.cpp:85-92), and stops
+     * early if a pop fails to reduce the depth.
+     */
+
+    /**
+     * Forwards a typed diagnostic record to the executor when it exposes
+     * AddDiagnostic; Carbon asserts or logs at these same points.
+     */
   }];
   Status = Object.freeze({
     RJ_INIT: 0,

package/dist/renderJob/TriRenderJob.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriRenderJob.js","sources":["../../../src/renderJob/TriRenderJob.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderJob.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderJob.cpp\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/core-types/schema\";\nimport { Tr2RenderContext } from \"../trinityCore/Tr2RenderContext.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n@type.define({ className: \"TriRenderJob\", family: \"renderJob\" })\nexport class TriRenderJob extends CjsModel\n{\n  static Status = Object.freeze({\n    RJ_INIT: 0,\n    RJ_IN_PROGRESS: 1,\n    RJ_DONE: 2,\n    RJ_FAILED: 3\n  });\n\n  static RJ_INIT = 0;\n  static RJ_IN_PROGRESS = 1;\n  static RJ_DONE = 2;\n  static RJ_FAILED = 3;\n\n  static StepResult = TriRenderStep.Result;\n\n  @io.persist\n  @type.int32\n  @schema.enum(\"TriRenderJobStatus\")\n  status = TriRenderJob.Status.RJ_INIT;\n\n  @io.persist\n  @type.boolean\n  stackGuard = true;\n\n  @io.persist\n  @type.boolean\n  enabled = true;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.persist\n  @type.list(\"TriRenderStep\")\n  steps = [];\n\n  #currentStep = 0;\n\n  @carbon.method\n  @impl.adapted\n  Run(realTime, simTime, executor = null)\n  {\n    if (!this.enabled) return TriRenderJob.Status.RJ_DONE;\n\n    const context = executor || Tr2RenderContext.GetDefault();\n    const snapshot = this.steps.slice();\n    if (this.status !== TriRenderJob.Status.RJ_IN_PROGRESS || this.#currentStep >= snapshot.length)\n    {\n      this.#currentStep = 0;\n    }\n\n    const preRT = TriRenderJob.#stackSize(context, \"GetStackSizeRT\");\n    const preDS = TriRenderJob.#stackSize(context, \"GetStackSizeDS\");\n    let result = TriRenderJob.StepResult.RS_OK;\n    let runError = null;\n\n    try\n    {\n      while (this.#currentStep < snapshot.length)\n      {\n        const step = snapshot[this.#currentStep];\n        if (!step || !TriRenderJob.#isStepEnabled(step))\n        {\n          this.#currentStep++;\n          continue;\n        }\n\n        let began = false;\n        let stepError = null;\n        try\n        {\n          TriRenderJob.#beginStep(context, step, realTime, simTime, this);\n          began = true;\n          result = TriRenderJob.#executeStep(context, step, realTime, simTime, this);\n        }\n        catch (error)\n        {\n          stepError = error;\n        }\n        finally\n        {\n          if (began)\n          {\n            try\n            {\n              TriRenderJob.#endStep(context, step, realTime, simTime, this);\n            }\n            catch (error)\n            {\n              if (!stepError) stepError = error;\n              else TriRenderJob.#diagnose(context, \"step-cleanup-error\", { job: this, step, error });\n            }\n          }\n        }\n        if (stepError) throw stepError;\n\n        if (this.stackGuard)\n        {\n          TriRenderJob.#diagnoseUnderflow(context, preRT, preDS, this, step);\n        }\n        if (result !== TriRenderJob.StepResult.RS_OK || !this.enabled) break;\n        this.#currentStep++;\n      }\n    }\n    catch (error)\n    {\n      runError = error;\n      result = TriRenderJob.StepResult.RS_FAILED;\n    }\n    finally\n    {\n      if (this.stackGuard)\n      {\n        TriRenderJob.#diagnoseUnderflow(context, preRT, preDS, this, null);\n        TriRenderJob.#unwind(context, \"GetStackSizeRT\", \"PopRenderTarget\", preRT, this, \"render-target\");\n        TriRenderJob.#unwind(context, \"GetStackSizeDS\", \"PopDepthStencil\", preDS, this, \"depth-stencil\");\n      }\n    }\n\n    if (runError)\n    {\n      this.status = TriRenderJob.Status.RJ_FAILED;\n      throw runError;\n    }\n    if (!this.enabled) return TriRenderJob.Status.RJ_DONE;\n\n    switch (result)\n    {\n      case TriRenderJob.StepResult.RS_OK:\n      case TriRenderJob.StepResult.RS_TERMINATE:\n        this.status = TriRenderJob.Status.RJ_DONE;\n        break;\n      case TriRenderJob.StepResult.RS_FAILED:\n        this.status = TriRenderJob.Status.RJ_FAILED;\n        break;\n      case TriRenderJob.StepResult.RS_IN_PROGRESS:\n        this.status = TriRenderJob.Status.RJ_IN_PROGRESS;\n        break;\n      default:\n        this.status = TriRenderJob.Status.RJ_FAILED;\n        TriRenderJob.#diagnose(context, \"invalid-step-result\", { job: this, result });\n        break;\n    }\n    return this.status;\n  }\n\n  static #isStepEnabled(step)\n  {\n    return step.IsEnabled?.() ?? step.enabled !== false;\n  }\n\n  static #beginStep(executor, step, realTime, simTime, job)\n  {\n    if (executor?.BeginStep) return executor.BeginStep(step, realTime, simTime, job);\n    return step.BeginExecute?.(executor);\n  }\n\n  static #executeStep(executor, step, realTime, simTime, job)\n  {\n    if (executor?.ExecuteStep) return executor.ExecuteStep(step, realTime, simTime, job);\n    return step.Execute?.(realTime, simTime, executor);\n  }\n\n  static #endStep(executor, step, realTime, simTime, job)\n  {\n    if (executor?.EndStep) return executor.EndStep(step, realTime, simTime, job);\n    return step.EndExecute?.(executor);\n  }\n\n  static #stackSize(executor, method)\n  {\n    const value = executor?.[method]?.();\n    return Number.isFinite(value) && value >= 0 ? Math.trunc(value) : 0;\n  }\n\n  static #diagnoseUnderflow(executor, preRT, preDS, job, step)\n  {\n    const rt = TriRenderJob.#stackSize(executor, \"GetStackSizeRT\");\n    const ds = TriRenderJob.#stackSize(executor, \"GetStackSizeDS\");\n    if (rt < preRT) TriRenderJob.#diagnose(executor, \"stack-underflow\", { stack: \"render-target\", job, step, expected: preRT, actual: rt });\n    if (ds < preDS) TriRenderJob.#diagnose(executor, \"stack-underflow\", { stack: \"depth-stencil\", job, step, expected: preDS, actual: ds });\n  }\n\n  static #unwind(executor, sizeMethod, popMethod, baseline, job, stack)\n  {\n    let size = TriRenderJob.#stackSize(executor, sizeMethod);\n    if (size > baseline) TriRenderJob.#diagnose(executor, \"stack-repair\", { stack, job, expected: baseline, actual: size });\n    while (size > baseline)\n    {\n      if (!executor?.[popMethod]) break;\n      executor[popMethod]();\n      const next = TriRenderJob.#stackSize(executor, sizeMethod);\n      if (next >= size) break;\n      size = next;\n    }\n  }\n\n  static #diagnose(executor, type, detail)\n  {\n    executor?.AddDiagnostic?.({ type, ...detail });\n  }\n\n  static TriRenderJobStatus = TriRenderJob.Status;\n\n}\n"],"names":["_TriRenderJob","_identity","TriRenderJob","CjsModel","e","_init_status","_init_extra_status","_init_stackGuard","_init_extra_stackGuard","_init_enabled","_init_extra_enabled","_init_name","_init_extra_name","_init_steps","_init_extra_steps","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","schema","enum","boolean","string","list","carbon","method","impl","adapted","status","Status","RJ_INIT","stackGuard","enabled","name","steps","Run","realTime","simTime","executor","RJ_DONE","context","Tr2RenderContext","GetDefault","snapshot","slice","RJ_IN_PROGRESS","length","preRT","preDS","result","StepResult","RS_OK","runError","step","began","stepError","error","job","RS_FAILED","RJ_FAILED","RS_TERMINATE","RS_IN_PROGRESS","Object","freeze","TriRenderStep","Result","#isStepEnabled","IsEnabled","#beginStep","BeginStep","BeginExecute","#executeStep","ExecuteStep","Execute","#endStep","EndStep","EndExecute","#stackSize","value","Number","isFinite","Math","trunc","#diagnoseUnderflow","rt","ds","stack","expected","actual","#unwind","sizeMethod","popMethod","baseline","size","next","#diagnose","detail","AddDiagnostic","TriRenderJobStatus","constructor"],"mappings":"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"}
+{"version":3,"file":"TriRenderJob.js","sources":["../../../src/renderJob/TriRenderJob.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderJob.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderJob.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { Tr2RenderContext } from \"../trinityCore/Tr2RenderContext.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n/**\n * An ordered list of render steps plus the cursor and status that let the\n * sequence pause mid-list and resume on a later frame.\n */\n@type.define({ className: \"TriRenderJob\", family: \"renderJob\" })\nexport class TriRenderJob extends CjsModel\n{\n  static Status = Object.freeze({\n    RJ_INIT: 0,\n    RJ_IN_PROGRESS: 1,\n    RJ_DONE: 2,\n    RJ_FAILED: 3\n  });\n\n  static RJ_INIT = 0;\n  static RJ_IN_PROGRESS = 1;\n  static RJ_DONE = 2;\n  static RJ_FAILED = 3;\n\n  static StepResult = TriRenderStep.Result;\n\n  @io.persist\n  @type.int32\n  @schema.enum(\"TriRenderJobStatus\")\n  status = TriRenderJob.Status.RJ_INIT;\n\n  @io.persist\n  @type.boolean\n  stackGuard = true;\n\n  @io.persist\n  @type.boolean\n  enabled = true;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.persist\n  @type.list(\"TriRenderStep\")\n  steps = [];\n\n  #currentStep = 0;\n\n  /**\n   * Carbon TriRenderJob::Run (cpp:18-125): runs the steps in order against a snapshot of the list, resuming at the persisted cursor when the previous run left the job RJ_IN_PROGRESS, and stopping at the first step that does not return RS_OK or that disables the job.\n   * Each step is bracketed by begin/end so the end hook runs even when execution throws. When stackGuard is set, the executor's render-target and depth-stencil depths are compared against the depths recorded on entry: shortfalls are reported as diagnostics and surplus pushes are popped back to the baseline.\n   * @param {number} realTime wall-clock time passed through to each step\n   * @param {number} simTime simulation time passed through to each step\n   * @param {object} [executor] performs the actual work described by the steps; defaults to the shared Tr2RenderContext. It may take over step dispatch by implementing BeginStep/ExecuteStep/EndStep.\n   * @returns {number} the resulting TriRenderJob.Status\n   */\n  @carbon.method\n  @impl.adapted\n  Run(realTime, simTime, executor = null)\n  {\n    if (!this.enabled) return TriRenderJob.Status.RJ_DONE;\n\n    const context = executor || Tr2RenderContext.GetDefault();\n    const snapshot = this.steps.slice();\n    if (this.status !== TriRenderJob.Status.RJ_IN_PROGRESS || this.#currentStep >= snapshot.length)\n    {\n      this.#currentStep = 0;\n    }\n\n    const preRT = TriRenderJob.#stackSize(context, \"GetStackSizeRT\");\n    const preDS = TriRenderJob.#stackSize(context, \"GetStackSizeDS\");\n    let result = TriRenderJob.StepResult.RS_OK;\n    let runError = null;\n\n    try\n    {\n      while (this.#currentStep < snapshot.length)\n      {\n        const step = snapshot[this.#currentStep];\n        if (!step || !TriRenderJob.#isStepEnabled(step))\n        {\n          this.#currentStep++;\n          continue;\n        }\n\n        let began = false;\n        let stepError = null;\n        try\n        {\n          TriRenderJob.#beginStep(context, step, realTime, simTime, this);\n          began = true;\n          result = TriRenderJob.#executeStep(context, step, realTime, simTime, this);\n        }\n        catch (error)\n        {\n          stepError = error;\n        }\n        finally\n        {\n          if (began)\n          {\n            try\n            {\n              TriRenderJob.#endStep(context, step, realTime, simTime, this);\n            }\n            catch (error)\n            {\n              if (!stepError) stepError = error;\n              else TriRenderJob.#diagnose(context, \"step-cleanup-error\", { job: this, step, error });\n            }\n          }\n        }\n        if (stepError) throw stepError;\n\n        if (this.stackGuard)\n        {\n          TriRenderJob.#diagnoseUnderflow(context, preRT, preDS, this, step);\n        }\n        if (result !== TriRenderJob.StepResult.RS_OK || !this.enabled) break;\n        this.#currentStep++;\n      }\n    }\n    catch (error)\n    {\n      runError = error;\n      result = TriRenderJob.StepResult.RS_FAILED;\n    }\n    finally\n    {\n      if (this.stackGuard)\n      {\n        TriRenderJob.#diagnoseUnderflow(context, preRT, preDS, this, null);\n        TriRenderJob.#unwind(context, \"GetStackSizeRT\", \"PopRenderTarget\", preRT, this, \"render-target\");\n        TriRenderJob.#unwind(context, \"GetStackSizeDS\", \"PopDepthStencil\", preDS, this, \"depth-stencil\");\n      }\n    }\n\n    if (runError)\n    {\n      this.status = TriRenderJob.Status.RJ_FAILED;\n      throw runError;\n    }\n    if (!this.enabled) return TriRenderJob.Status.RJ_DONE;\n\n    switch (result)\n    {\n      case TriRenderJob.StepResult.RS_OK:\n      case TriRenderJob.StepResult.RS_TERMINATE:\n        this.status = TriRenderJob.Status.RJ_DONE;\n        break;\n      case TriRenderJob.StepResult.RS_FAILED:\n        this.status = TriRenderJob.Status.RJ_FAILED;\n        break;\n      case TriRenderJob.StepResult.RS_IN_PROGRESS:\n        this.status = TriRenderJob.Status.RJ_IN_PROGRESS;\n        break;\n      default:\n        this.status = TriRenderJob.Status.RJ_FAILED;\n        TriRenderJob.#diagnose(context, \"invalid-step-result\", { job: this, result });\n        break;\n    }\n    return this.status;\n  }\n\n  /**\n   * Treats a step as enabled through its IsEnabled method, or when it has none,\n   * through an enabled field that is not false.\n   */\n  static #isStepEnabled(step)\n  {\n    return step.IsEnabled?.() ?? step.enabled !== false;\n  }\n\n  /**\n   * Gives the executor first refusal on step setup via BeginStep, and otherwise\n   * calls the step's own BeginExecute.\n   */\n  static #beginStep(executor, step, realTime, simTime, job)\n  {\n    if (executor?.BeginStep) return executor.BeginStep(step, realTime, simTime, job);\n    return step.BeginExecute?.(executor);\n  }\n\n  /**\n   * Gives the executor first refusal on step execution via ExecuteStep, and\n   * otherwise calls the step's own Execute; the returned step result decides\n   * whether the job continues.\n   */\n  static #executeStep(executor, step, realTime, simTime, job)\n  {\n    if (executor?.ExecuteStep) return executor.ExecuteStep(step, realTime, simTime, job);\n    return step.Execute?.(realTime, simTime, executor);\n  }\n\n  /**\n   * Gives the executor first refusal on step teardown via EndStep, and otherwise\n   * calls the step's own EndExecute; the caller runs this even when execution\n   * threw.\n   */\n  static #endStep(executor, step, realTime, simTime, job)\n  {\n    if (executor?.EndStep) return executor.EndStep(step, realTime, simTime, job);\n    return step.EndExecute?.(executor);\n  }\n\n  /**\n   * Reads a stack depth off the executor, mapping a missing, negative or\n   * non-finite value to 0 so executors that do not track stacks never trip the\n   * guard.\n   */\n  static #stackSize(executor, method)\n  {\n    const value = executor?.[method]?.();\n    return Number.isFinite(value) && value >= 0 ? Math.trunc(value) : 0;\n  }\n\n  /**\n   * Reports a stack-underflow diagnostic when the executor's render-target or\n   * depth-stencil depth has dropped below the depth recorded at job entry, the\n   * condition Carbon asserts on (TriRenderJob.cpp:63-64).\n   */\n  static #diagnoseUnderflow(executor, preRT, preDS, job, step)\n  {\n    const rt = TriRenderJob.#stackSize(executor, \"GetStackSizeRT\");\n    const ds = TriRenderJob.#stackSize(executor, \"GetStackSizeDS\");\n    if (rt < preRT) TriRenderJob.#diagnose(executor, \"stack-underflow\", { stack: \"render-target\", job, step, expected: preRT, actual: rt });\n    if (ds < preDS) TriRenderJob.#diagnose(executor, \"stack-underflow\", { stack: \"depth-stencil\", job, step, expected: preDS, actual: ds });\n  }\n\n  /**\n   * Pops the executor's stack back down to the depth recorded at job entry,\n   * mirroring Carbon's stack repair loop (TriRenderJob.cpp:85-92), and stops\n   * early if a pop fails to reduce the depth.\n   */\n  static #unwind(executor, sizeMethod, popMethod, baseline, job, stack)\n  {\n    let size = TriRenderJob.#stackSize(executor, sizeMethod);\n    if (size > baseline) TriRenderJob.#diagnose(executor, \"stack-repair\", { stack, job, expected: baseline, actual: size });\n    while (size > baseline)\n    {\n      if (!executor?.[popMethod]) break;\n      executor[popMethod]();\n      const next = TriRenderJob.#stackSize(executor, sizeMethod);\n      if (next >= size) break;\n      size = next;\n    }\n  }\n\n  /**\n   * Forwards a typed diagnostic record to the executor when it exposes\n   * AddDiagnostic; Carbon asserts or logs at these same points.\n   */\n  static #diagnose(executor, type, detail)\n  {\n    executor?.AddDiagnostic?.({ type, ...detail });\n  }\n\n  static TriRenderJobStatus = TriRenderJob.Status;\n\n}\n"],"names":["_TriRenderJob","_identity","TriRenderJob","CjsModel","e","_init_status","_init_extra_status","_init_stackGuard","_init_extra_stackGuard","_init_enabled","_init_extra_enabled","_init_name","_init_extra_name","_init_steps","_init_extra_steps","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","schema","enum","boolean","string","list","carbon","method","impl","adapted","status","Status","RJ_INIT","stackGuard","enabled","name","steps","Run","realTime","simTime","executor","RJ_DONE","context","Tr2RenderContext","GetDefault","snapshot","slice","RJ_IN_PROGRESS","length","preRT","preDS","result","StepResult","RS_OK","runError","step","began","stepError","error","job","RS_FAILED","RJ_FAILED","RS_TERMINATE","RS_IN_PROGRESS","Object","freeze","TriRenderStep","Result","#isStepEnabled","IsEnabled","#beginStep","BeginStep","BeginExecute","#executeStep","ExecuteStep","Execute","#endStep","EndStep","EndExecute","#stackSize","value","Number","isFinite","Math","trunc","#diagnoseUnderflow","rt","ds","stack","expected","actual","#unwind","sizeMethod","popMethod","baseline","size","next","#diagnose","detail","AddDiagnostic","TriRenderJobStatus","constructor"],"mappings":"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"}

package/dist/renderJob/TriRenderStep.js

@@ -1,8 +1,13 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_enabled, _init_extra_enabled, _init_name, _init_extra_name;
+
+/**
+ * Base of every render-job step: an enable flag, a name, and the
+ * begin/execute/end contract the owning job drives.
+ */
 let _TriRenderStep;
 new class extends _identity {
   static [class TriRenderStep extends CjsModel {
@@ -21,10 +26,25 @@ new class extends _identity {
     }
     enabled = (_initProto(this), _init_enabled(this, true));
     name = (_init_extra_enabled(this), _init_name(this, ""));
+
+    /**
+     * Reports whether the owning job should run this step; disabled steps are
+     * skipped without advancing any state.
+     */
     IsEnabled() {
       return this.enabled;
     }
+
+    /**
+     * Hook the owning job calls before Execute; the base step does nothing, and
+     * subclasses use it to set up state that EndExecute tears down.
+     */
     BeginExecute() {}
+
+    /**
+     * Hook the owning job calls after Execute, including when Execute threw; the
+     * base step does nothing.
+     */
     EndExecute() {}
   }];
   Result = Object.freeze({

package/dist/renderJob/TriRenderStep.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriRenderStep.js","sources":["../../../src/renderJob/TriRenderStep.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderStep.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderStep.cpp\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\n\n\n@type.define({ className: \"TriRenderStep\", family: \"renderJob\" })\nexport class TriRenderStep extends CjsModel\n{\n  static Result = Object.freeze({\n    RS_OK: 0,\n    RS_FAILED: 1,\n    RS_IN_PROGRESS: 2,\n    RS_TERMINATE: 3\n  });\n\n  static RS_OK = 0;\n  static RS_FAILED = 1;\n  static RS_IN_PROGRESS = 2;\n  static RS_TERMINATE = 3;\n\n  @io.readwrite\n  @type.boolean\n  enabled = true;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @carbon.method\n  @impl.implemented\n  IsEnabled()\n  {\n    return this.enabled;\n  }\n\n  @carbon.method\n  @impl.adapted\n  BeginExecute()\n  {\n  }\n\n  @carbon.method\n  @impl.adapted\n  EndExecute()\n  {\n  }\n}\n"],"names":["_TriRenderStep","_identity","TriRenderStep","CjsModel","e","_init_enabled","_init_extra_enabled","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","boolean","persist","string","carbon","method","impl","implemented","adapted","constructor","args","enabled","name","IsEnabled","BeginExecute","EndExecute","Result","Object","freeze","RS_OK","RS_FAILED","RS_IN_PROGRESS","RS_TERMINATE"],"mappings":";;;;;AAG2E,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAG3E,MAAAC,aAAA,SACmCC,QAAQ,CAC3C;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAV,cAAA,EAAAW,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,QAAAA,SAAS,EAAE,eAAe;AAAEC,QAAAA,MAAM,EAAE;AAAY,OAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAe9DC,EAAE,EAAFA,EAAE,CAACC,SAAS,EACZL,IAAI,EAAJA,IAAI,CAACM,OAAO,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGZF,EAAE,EAAFA,EAAE,CAACG,OAAO,EACVP,IAAI,EAAJA,IAAI,CAACQ,MAAM,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAGXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAAA,CAMhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAKZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,kCApCoBvB,QAAQ,CAAA;AAAA;AAAAwB,IAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,MAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;MAAApB,gBAAA,CAAA,IAAA,CAAA;AAAA,IAAA;AAgBzCqB,IAAAA,OAAO,IAAApB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,IAAI,CAAA;AAIdyB,IAAAA,IAAI,IAAAxB,mBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;AAITwB,IAAAA,SAASA,GACT;MACE,OAAO,IAAI,CAACF,OAAO;AACrB,IAAA;IAIAG,YAAYA,GACZ,CACA;IAIAC,UAAUA,GACV,CACA;GACD;AAtCQC,EAAAA,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC5BC,IAAAA,KAAK,EAAE,CAAC;AACRC,IAAAA,SAAS,EAAE,CAAC;AACZC,IAAAA,cAAc,EAAE,CAAC;AACjBC,IAAAA,YAAY,EAAE;AAChB,GAAC,CAAC;AAEKH,EAAAA,KAAK,GAAG,CAAC;AACTC,EAAAA,SAAS,GAAG,CAAC;AACbC,EAAAA,cAAc,GAAG,CAAC;AAClBC,EAAAA,YAAY,GAAG,CAAC;EAACb,WAAAA,GAAA;IAAA,KAAA,CAAA3B,cAAA,GAAAW,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}
+{"version":3,"file":"TriRenderStep.js","sources":["../../../src/renderJob/TriRenderStep.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderStep.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriRenderStep.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * Base of every render-job step: an enable flag, a name, and the\n * begin/execute/end contract the owning job drives.\n */\n@type.define({ className: \"TriRenderStep\", family: \"renderJob\" })\nexport class TriRenderStep extends CjsModel\n{\n  static Result = Object.freeze({\n    RS_OK: 0,\n    RS_FAILED: 1,\n    RS_IN_PROGRESS: 2,\n    RS_TERMINATE: 3\n  });\n\n  static RS_OK = 0;\n  static RS_FAILED = 1;\n  static RS_IN_PROGRESS = 2;\n  static RS_TERMINATE = 3;\n\n  @io.readwrite\n  @type.boolean\n  enabled = true;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  /**\n   * Reports whether the owning job should run this step; disabled steps are\n   * skipped without advancing any state.\n   */\n  @carbon.method\n  @impl.implemented\n  IsEnabled()\n  {\n    return this.enabled;\n  }\n\n  /**\n   * Hook the owning job calls before Execute; the base step does nothing, and\n   * subclasses use it to set up state that EndExecute tears down.\n   */\n  @carbon.method\n  @impl.adapted\n  BeginExecute()\n  {\n  }\n\n  /**\n   * Hook the owning job calls after Execute, including when Execute threw; the\n   * base step does nothing.\n   */\n  @carbon.method\n  @impl.adapted\n  EndExecute()\n  {\n  }\n}\n"],"names":["_TriRenderStep","_identity","TriRenderStep","CjsModel","e","_init_enabled","_init_extra_enabled","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","boolean","persist","string","carbon","method","impl","implemented","adapted","constructor","args","enabled","name","IsEnabled","BeginExecute","EndExecute","Result","Object","freeze","RS_OK","RS_FAILED","RS_IN_PROGRESS","RS_TERMINATE"],"mappings":";;;;;;AAMA;AACA;AACA;AACA;AAHA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAIA,MAAAC,aAAA,SACmCC,QAAQ,CAC3C;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAV,cAAA,EAAAW,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,QAAAA,SAAS,EAAE,eAAe;AAAEC,QAAAA,MAAM,EAAE;AAAY,OAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAe9DC,EAAE,EAAFA,EAAE,CAACC,SAAS,EACZL,IAAI,EAAJA,IAAI,CAACM,OAAO,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGZF,EAAE,EAAFA,EAAE,CAACG,OAAO,EACVP,IAAI,EAAJA,IAAI,CAACQ,MAAM,CAAA,EAAA,EAAA,EAAA,MAAA,CAAA,EAAA,CAAA,CAOXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAAA,CAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CASZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,kCAhDoBvB,QAAQ,CAAA;AAAA;AAAAwB,IAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,MAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;MAAApB,gBAAA,CAAA,IAAA,CAAA;AAAA,IAAA;AAgBzCqB,IAAAA,OAAO,IAAApB,UAAA,CAAA,IAAA,CAAA,EAAAJ,aAAA,OAAG,IAAI,CAAA;AAIdyB,IAAAA,IAAI,IAAAxB,mBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,EAAE,CAAA;;AAET;AACF;AACA;AACA;AAGEwB,IAAAA,SAASA,GACT;MACE,OAAO,IAAI,CAACF,OAAO;AACrB,IAAA;;AAEA;AACF;AACA;AACA;IAGEG,YAAYA,GACZ,CACA;;AAEA;AACF;AACA;AACA;IAGEC,UAAUA,GACV,CACA;GACD;AAlDQC,EAAAA,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC5BC,IAAAA,KAAK,EAAE,CAAC;AACRC,IAAAA,SAAS,EAAE,CAAC;AACZC,IAAAA,cAAc,EAAE,CAAC;AACjBC,IAAAA,YAAY,EAAE;AAChB,GAAC,CAAC;AAEKH,EAAAA,KAAK,GAAG,CAAC;AACTC,EAAAA,SAAS,GAAG,CAAC;AACbC,EAAAA,cAAc,GAAG,CAAC;AAClBC,EAAAA,YAAY,GAAG,CAAC;EAACb,WAAAA,GAAA;IAAA,KAAA,CAAA3B,cAAA,GAAAW,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}

package/dist/renderJob/TriStepClear.js

@@ -1,10 +1,15 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { vec4 } from '@carbonenginejs/core-math/vec4';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { TriRenderJob as _TriRenderJob } from './TriRenderJob.js';
 import { TriRenderStep as _TriRenderStep } from './TriRenderStep.js';
 
 let _initProto, _initClass, _init_color, _init_extra_color, _init_depth, _init_extra_depth, _init_stencil, _init_extra_stencil, _init_isColorCleared, _init_extra_isColorCleared, _init_isDepthCleared, _init_extra_isDepthCleared, _init_isStencilCleared, _init_extra_isStencilCleared;
+
+/**
+ * Step that clears the bound colour, depth and stencil attachments, each
+ * independently enabled with its own clear value.
+ */
 let _TriStepClear;
 new class extends _identity {
   static [class TriStepClear extends _TriRenderStep {
@@ -27,6 +32,11 @@ new class extends _identity {
     isColorCleared = (_init_extra_stencil(this), _init_isColorCleared(this, true));
     isDepthCleared = (_init_extra_isColorCleared(this), _init_isDepthCleared(this, true));
     isStencilCleared = (_init_extra_isDepthCleared(this), _init_isStencilCleared(this, false));
+
+    /**
+     * Enables each clear channel according to whether its argument was supplied
+     * and non-null, so constructing with a colour alone clears colour only.
+     */
     __init__(color, depth, stencil) {
       this.isColorCleared = arguments.length >= 1 && color != null;
       this.isDepthCleared = arguments.length >= 2 && depth != null;
@@ -35,6 +45,12 @@ new class extends _identity {
       if (this.isDepthCleared) this.depth = Number(depth) || 0;
       if (this.isStencilCleared) this.stencil = Number(stencil) >>> 0;
     }
+
+    /**
+     * Hands the executor a clear description with the colour clamped to 0..1 and
+     * one enable flag per channel; which attachments those apply to is the
+     * executor's decision.
+     */
     Execute(_realTime, _simTime, executor) {
       executor?.Clear?.({
         color: Array.from(this.color, _TriStepClear.#clampColor),
@@ -46,6 +62,8 @@ new class extends _identity {
       });
       return _TriRenderJob.StepResult.RS_OK;
     }
+
+    /** Clamps one colour component into 0..1, mapping non-numeric values to 0. */
   }];
   #clampColor(value) {
     return Math.max(0, Math.min(1, Number(value) || 0));

package/dist/renderJob/TriStepClear.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriStepClear.js","sources":["../../../src/renderJob/TriStepClear.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepClear.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepClear.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepClear_Blue.cpp\nimport { vec4 } from \"@carbonenginejs/core-math/vec4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n@type.define({ className: \"TriStepClear\", family: \"renderJob\" })\nexport class TriStepClear extends TriRenderStep\n{\n  @io.persist\n  @type.color\n  color = vec4.fromValues(0, 0, 0, 1);\n\n  @io.persist\n  @type.float32\n  depth = 1;\n\n  @io.persist\n  @type.uint32\n  stencil = 0;\n\n  @io.persist\n  @type.boolean\n  isColorCleared = true;\n\n  @io.persist\n  @type.boolean\n  isDepthCleared = true;\n\n  @io.persist\n  @type.boolean\n  isStencilCleared = false;\n\n  @carbon.method\n  @impl.adapted\n  __init__(color, depth, stencil)\n  {\n    this.isColorCleared = arguments.length >= 1 && color != null;\n    this.isDepthCleared = arguments.length >= 2 && depth != null;\n    this.isStencilCleared = arguments.length >= 3 && stencil != null;\n    if (this.isColorCleared) vec4.copy(this.color, color);\n    if (this.isDepthCleared) this.depth = Number(depth) || 0;\n    if (this.isStencilCleared) this.stencil = Number(stencil) >>> 0;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    executor?.Clear?.({\n      color: Array.from(this.color, TriStepClear.#clampColor),\n      depth: this.depth,\n      stencil: this.stencil,\n      clearColor: this.isColorCleared,\n      clearDepth: this.isDepthCleared,\n      clearStencil: this.isStencilCleared\n    });\n    return TriRenderJob.StepResult.RS_OK;\n  }\n\n  static #clampColor(value)\n  {\n    return Math.max(0, Math.min(1, Number(value) || 0));\n  }\n}\n"],"names":["_TriStepClear","_identity","TriStepClear","TriRenderStep","e","_init_color","_init_extra_color","_init_depth","_init_extra_depth","_init_stencil","_init_extra_stencil","_init_isColorCleared","_init_extra_isColorCleared","_init_isDepthCleared","_init_extra_isDepthCleared","_init_isStencilCleared","_init_extra_isStencilCleared","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","color","float32","uint32","boolean","carbon","method","impl","adapted","implemented","constructor","args","vec4","fromValues","depth","stencil","isColorCleared","isDepthCleared","isStencilCleared","__init__","arguments","length","copy","Number","Execute","_realTime","_simTime","executor","Clear","Array","from","clearColor","clearDepth","clearStencil","TriRenderJob","StepResult","RS_OK","#clampColor","value","Math","max","min"],"mappings":"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"}
+{"version":3,"file":"TriStepClear.js","sources":["../../../src/renderJob/TriStepClear.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepClear.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepClear.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepClear_Blue.cpp\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n/**\n * Step that clears the bound colour, depth and stencil attachments, each\n * independently enabled with its own clear value.\n */\n@type.define({ className: \"TriStepClear\", family: \"renderJob\" })\nexport class TriStepClear extends TriRenderStep\n{\n  @io.persist\n  @type.color\n  color = vec4.fromValues(0, 0, 0, 1);\n\n  @io.persist\n  @type.float32\n  depth = 1;\n\n  @io.persist\n  @type.uint32\n  stencil = 0;\n\n  @io.persist\n  @type.boolean\n  isColorCleared = true;\n\n  @io.persist\n  @type.boolean\n  isDepthCleared = true;\n\n  @io.persist\n  @type.boolean\n  isStencilCleared = false;\n\n  /**\n   * Enables each clear channel according to whether its argument was supplied\n   * and non-null, so constructing with a colour alone clears colour only.\n   */\n  @carbon.method\n  @impl.adapted\n  __init__(color, depth, stencil)\n  {\n    this.isColorCleared = arguments.length >= 1 && color != null;\n    this.isDepthCleared = arguments.length >= 2 && depth != null;\n    this.isStencilCleared = arguments.length >= 3 && stencil != null;\n    if (this.isColorCleared) vec4.copy(this.color, color);\n    if (this.isDepthCleared) this.depth = Number(depth) || 0;\n    if (this.isStencilCleared) this.stencil = Number(stencil) >>> 0;\n  }\n\n  /**\n   * Hands the executor a clear description with the colour clamped to 0..1 and\n   * one enable flag per channel; which attachments those apply to is the\n   * executor's decision.\n   */\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    executor?.Clear?.({\n      color: Array.from(this.color, TriStepClear.#clampColor),\n      depth: this.depth,\n      stencil: this.stencil,\n      clearColor: this.isColorCleared,\n      clearDepth: this.isDepthCleared,\n      clearStencil: this.isStencilCleared\n    });\n    return TriRenderJob.StepResult.RS_OK;\n  }\n\n  /** Clamps one colour component into 0..1, mapping non-numeric values to 0. */\n  static #clampColor(value)\n  {\n    return Math.max(0, Math.min(1, Number(value) || 0));\n  }\n}\n"],"names":["_TriStepClear","_identity","TriStepClear","TriRenderStep","e","_init_color","_init_extra_color","_init_depth","_init_extra_depth","_init_stencil","_init_extra_stencil","_init_isColorCleared","_init_extra_isColorCleared","_init_isDepthCleared","_init_extra_isDepthCleared","_init_isStencilCleared","_init_extra_isStencilCleared","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","color","float32","uint32","boolean","carbon","method","impl","adapted","implemented","constructor","args","vec4","fromValues","depth","stencil","isColorCleared","isDepthCleared","isStencilCleared","__init__","arguments","length","copy","Number","Execute","_realTime","_simTime","executor","Clear","Array","from","clearColor","clearDepth","clearStencil","TriRenderJob","StepResult","RS_OK","#clampColor","value","Math","max","min"],"mappings":";;;;;;;;AASA;AACA;AACA;AACA;AAHA,IAAAA;AAAA,IAAA,cAAAC,SAAA,CAAA;AAAA,EAAA,QAIA,MAAAC,YAAA,SACkCC,cAAa,CAC/C;AAAA,IAAA;AAAA,MAAA,CAAA;QAAAC,CAAA,EAAA,CAAAC,WAAA,EAAAC,iBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,oBAAA,EAAAC,0BAAA,EAAAC,oBAAA,EAAAC,0BAAA,EAAAC,sBAAA,EAAAC,4BAAA,EAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAlB,aAAA,EAAAmB,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,QAAAA,SAAS,EAAE,cAAc;AAAEC,QAAAA,MAAM,EAAE;OAAa,CAAC,MAG7DC,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACM,KAAK,mBAGVF,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACO,OAAO,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAGZH,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACQ,MAAM,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAGXJ,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACS,OAAO,4BAGZL,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACS,OAAO,4BAGZL,EAAE,EAAFA,EAAE,CAACC,OAAO,EACVL,IAAI,EAAJA,IAAI,CAACS,OAAO,CAAA,EAAA,EAAA,EAAA,kBAAA,CAAA,EAAA,CAAA,CAOZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAgBZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAhDehC,cAAa,CAAA;AAAA;AAAAiC,IAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,MAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;MAAArB,4BAAA,CAAA,IAAA,CAAA;AAAA,IAAA;AAI7CW,IAAAA,KAAK,IAAAV,UAAA,CAAA,IAAA,CAAA,EAAAZ,WAAA,CAAA,IAAA,EAAGiC,IAAI,CAACC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAInCC,IAAAA,KAAK,IAAAlC,iBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,CAAC,CAAA;AAITkC,IAAAA,OAAO,IAAAjC,iBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAG,CAAC,CAAA;AAIXiC,IAAAA,cAAc,IAAAhC,mBAAA,CAAA,IAAA,CAAA,EAAAC,oBAAA,OAAG,IAAI,CAAA;AAIrBgC,IAAAA,cAAc,IAAA/B,0BAAA,CAAA,IAAA,CAAA,EAAAC,oBAAA,OAAG,IAAI,CAAA;AAIrB+B,IAAAA,gBAAgB,IAAA9B,0BAAA,CAAA,IAAA,CAAA,EAAAC,sBAAA,OAAG,KAAK,CAAA;;AAExB;AACF;AACA;AACA;AAGE8B,IAAAA,QAAQA,CAAClB,KAAK,EAAEa,KAAK,EAAEC,OAAO,EAC9B;MACE,IAAI,CAACC,cAAc,GAAGI,SAAS,CAACC,MAAM,IAAI,CAAC,IAAIpB,KAAK,IAAI,IAAI;MAC5D,IAAI,CAACgB,cAAc,GAAGG,SAAS,CAACC,MAAM,IAAI,CAAC,IAAIP,KAAK,IAAI,IAAI;MAC5D,IAAI,CAACI,gBAAgB,GAAGE,SAAS,CAACC,MAAM,IAAI,CAAC,IAAIN,OAAO,IAAI,IAAI;AAChE,MAAA,IAAI,IAAI,CAACC,cAAc,EAAEJ,IAAI,CAACU,IAAI,CAAC,IAAI,CAACrB,KAAK,EAAEA,KAAK,CAAC;AACrD,MAAA,IAAI,IAAI,CAACgB,cAAc,EAAE,IAAI,CAACH,KAAK,GAAGS,MAAM,CAACT,KAAK,CAAC,IAAI,CAAC;AACxD,MAAA,IAAI,IAAI,CAACI,gBAAgB,EAAE,IAAI,CAACH,OAAO,GAAGQ,MAAM,CAACR,OAAO,CAAC,KAAK,CAAC;AACjE,IAAA;;AAEA;AACF;AACA;AACA;AACA;AAGES,IAAAA,OAAOA,CAACC,SAAS,EAAEC,QAAQ,EAAEC,QAAQ,EACrC;MACEA,QAAQ,EAAEC,KAAK,GAAG;AAChB3B,QAAAA,KAAK,EAAE4B,KAAK,CAACC,IAAI,CAAC,IAAI,CAAC7B,KAAK,EAAEzB,aAAY,CAAC,WAAW,CAAC;QACvDsC,KAAK,EAAE,IAAI,CAACA,KAAK;QACjBC,OAAO,EAAE,IAAI,CAACA,OAAO;QACrBgB,UAAU,EAAE,IAAI,CAACf,cAAc;QAC/BgB,UAAU,EAAE,IAAI,CAACf,cAAc;QAC/BgB,YAAY,EAAE,IAAI,CAACf;AACrB,OAAC,CAAC;AACF,MAAA,OAAOgB,aAAY,CAACC,UAAU,CAACC,KAAK;AACtC,IAAA;;AAEA;GAKD;EAJQ,WAAWC,CAACC,KAAK,EACxB;AACE,IAAA,OAAOC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,GAAG,CAAC,CAAC,EAAElB,MAAM,CAACe,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,EAAA;EAAC5B,WAAAA,GAAA;IAAA,KAAA,CAAApC,aAAA,GAAAmB,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}

package/dist/renderJob/TriStepCopyRenderTarget.js

@@ -1,9 +1,14 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { io, carbon, impl, type, CjsSchema } from '@carbonenginejs/core-types/schema';
+import { io, carbon, impl, type, CjsSchema } from '@carbonenginejs/runtime-utils/schema';
 import { TriRenderJob as _TriRenderJob } from './TriRenderJob.js';
 import { TriRenderStep as _TriRenderStep } from './TriRenderStep.js';
 
 let _initProto, _initClass, _init_Destination, _init_extra_Destination, _init_destinationTexture, _init_extra_destinationTexture, _init_Source, _init_extra_Source, _init_sourceViewport, _init_extra_sourceViewport, _init_destinationViewport, _init_extra_destinationViewport;
+
+/**
+ * Step describing a copy out of one render target into another render target or
+ * into a texture resource, including the source and destination sub-rectangles.
+ */
 let _TriStepCopyRenderTar;
 new class extends _identity {
   static [class TriStepCopyRenderTarget extends _TriRenderStep {
@@ -25,18 +30,31 @@ new class extends _identity {
     Source = (_init_extra_destinationTexture(this), _init_Source(this, null));
     sourceViewport = (_init_extra_Source(this), _init_sourceViewport(this, null));
     destinationViewport = (_init_extra_sourceViewport(this), _init_destinationViewport(this, null));
+
+    /** Reads the destination render target under Carbon's lower-case accessor name. */
     get destination() {
       return this.Destination;
     }
+
+    /** Sets the destination render target, normalising a missing value to null. */
     set destination(value) {
       this.Destination = value ?? null;
     }
+
+    /** Reads the source render target under Carbon's lower-case accessor name. */
     get source() {
       return this.Source;
     }
+
+    /** Sets the source render target, normalising a missing value to null. */
     set source(value) {
       this.Source = value ?? null;
     }
+
+    /**
+     * Assigns the copy operands, routing a texture-resource destination to
+     * destinationTexture and anything else to the render-target destination.
+     */
     __init__(destination = null, source = null, destinationViewport = null, sourceViewport = null) {
       if (destination) {
         if (_TriStepCopyRenderTar.#isTextureResource(destination)) this.destinationTexture = destination;else this.Destination = destination;
@@ -45,12 +63,23 @@ new class extends _identity {
       this.destinationViewport = destinationViewport ?? null;
       this.sourceViewport = sourceViewport ?? null;
     }
+
+    /**
+     * Builds the copy intent and hands it to the executor's CopyRenderTarget;
+     * incomplete operands yield no intent and are a no-op that still reports
+     * RS_OK, while an explicit false from the executor is RS_FAILED.
+     */
     Execute(_realTime, _simTime, executor) {
       const intent = this.GetCopyIntent();
       if (!intent) return _TriRenderJob.StepResult.RS_OK;
       const copied = executor?.CopyRenderTarget?.(intent);
       return copied === false ? _TriRenderJob.StepResult.RS_FAILED : _TriRenderJob.StepResult.RS_OK;
     }
+
+    /**
+     * Carbon TriStepCopyRenderTarget::Execute (cpp:13-95): resolves the operands and viewports into a plain copy description the executor performs, with destinationType distinguishing the render-target path from the texture path.
+     * @returns {object|null} the copy intent, or null when the source or both destinations are missing
+     */
     GetCopyIntent() {
       if (!this.Source || !this.Destination && !this.destinationTexture) return null;
       const destX = Number(this.destinationViewport?.x) || 0;
@@ -69,6 +98,28 @@ new class extends _identity {
         sourceRect: this.sourceViewport ? _TriStepCopyRenderTar.#viewportRect(this.sourceViewport) : null
       };
     }
+
+    /**
+     * Builds the render-target-to-render-target rectangles: a source viewport with
+     * a non-positive extent cancels the copy, and a negative destination origin
+     * clamps to zero while trimming the same amount off the source rectangle
+     * (Carbon TriStepCopyRenderTarget.cpp:33-73).
+     */
+
+    /**
+     * Converts a viewport's x/y/width/height into a left/top/right/bottom
+     * rectangle, treating non-numeric fields as zero.
+     */
+
+    /**
+     * Reads a dimension off a render target through its Get<Name>() accessor or
+     * its lower-case property, yielding 0 when neither is present.
+     */
+
+    /**
+     * Identifies a destination as a texture resource by its registered class name,
+     * a name ending in TextureRes, or the presence of GetTexture.
+     */
   }];
   #renderTargetIntent(source, destination, sourceViewport, destX, destY) {
     let x = destX;

package/dist/renderJob/TriStepCopyRenderTarget.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriStepCopyRenderTarget.js","sources":["../../../src/renderJob/TriStepCopyRenderTarget.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepCopyRenderTarget.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepCopyRenderTarget.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepCopyRenderTarget_Blue.cpp\nimport { CjsSchema, carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n@type.define({ className: \"TriStepCopyRenderTarget\", family: \"renderJob\" })\nexport class TriStepCopyRenderTarget extends TriRenderStep\n{\n  @io.readwrite\n  @type.objectRef(\"Tr2RenderTarget\")\n  Destination = null;\n\n  @io.readwrite\n  @type.objectRef(\"TriTextureRes\")\n  destinationTexture = null;\n\n  @io.readwrite\n  @type.objectRef(\"Tr2RenderTarget\")\n  Source = null;\n\n  @io.readwrite\n  @type.objectRef(\"TriViewport\")\n  sourceViewport = null;\n\n  @io.readwrite\n  @type.objectRef(\"TriViewport\")\n  destinationViewport = null;\n\n  get destination()\n  {\n    return this.Destination;\n  }\n\n  set destination(value)\n  {\n    this.Destination = value ?? null;\n  }\n\n  get source()\n  {\n    return this.Source;\n  }\n\n  set source(value)\n  {\n    this.Source = value ?? null;\n  }\n\n  @carbon.method\n  @impl.adapted\n  __init__(destination = null, source = null, destinationViewport = null, sourceViewport = null)\n  {\n    if (destination)\n    {\n      if (TriStepCopyRenderTarget.#isTextureResource(destination)) this.destinationTexture = destination;\n      else this.Destination = destination;\n    }\n    this.Source = source ?? null;\n    this.destinationViewport = destinationViewport ?? null;\n    this.sourceViewport = sourceViewport ?? null;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    const intent = this.GetCopyIntent();\n    if (!intent) return TriRenderJob.StepResult.RS_OK;\n    const copied = executor?.CopyRenderTarget?.(intent);\n    return copied === false ? TriRenderJob.StepResult.RS_FAILED : TriRenderJob.StepResult.RS_OK;\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetCopyIntent()\n  {\n    if (!this.Source || (!this.Destination && !this.destinationTexture)) return null;\n    const destX = Number(this.destinationViewport?.x) || 0;\n    const destY = Number(this.destinationViewport?.y) || 0;\n    if (this.Destination)\n    {\n      return TriStepCopyRenderTarget.#renderTargetIntent(\n        this.Source,\n        this.Destination,\n        this.sourceViewport,\n        destX,\n        destY\n      );\n    }\n    return {\n      source: this.Source,\n      destination: this.destinationTexture,\n      destinationType: \"texture\",\n      destinationPoint: { x: destX, y: destY },\n      sourceRect: this.sourceViewport ? TriStepCopyRenderTarget.#viewportRect(this.sourceViewport) : null\n    };\n  }\n\n  static #renderTargetIntent(source, destination, sourceViewport, destX, destY)\n  {\n    let x = destX;\n    let y = destY;\n    let sourceRect;\n    if (sourceViewport)\n    {\n      if (Number(sourceViewport.width) <= 0 || Number(sourceViewport.height) <= 0) return null;\n      sourceRect = TriStepCopyRenderTarget.#viewportRect(sourceViewport);\n      if (x < 0)\n      {\n        sourceRect.right -= -x;\n        x = 0;\n      }\n      if (y < 0)\n      {\n        sourceRect.bottom -= -y;\n        y = 0;\n      }\n    }\n    else\n    {\n      sourceRect = {\n        left: 0,\n        top: 0,\n        right: TriStepCopyRenderTarget.#dimension(source, \"Width\", \"width\"),\n        bottom: TriStepCopyRenderTarget.#dimension(source, \"Height\", \"height\")\n      };\n      if (x < 0)\n      {\n        sourceRect.right += x;\n        x = 0;\n      }\n      if (y < 0)\n      {\n        sourceRect.bottom += y;\n        y = 0;\n      }\n    }\n    return {\n      source,\n      destination,\n      destinationType: \"renderTarget\",\n      sourceRect,\n      destinationRect: {\n        left: x,\n        top: y,\n        right: x + sourceRect.right - sourceRect.left,\n        bottom: y + sourceRect.bottom - sourceRect.top\n      }\n    };\n  }\n\n  static #viewportRect(viewport)\n  {\n    const left = Number(viewport.x) || 0;\n    const top = Number(viewport.y) || 0;\n    return {\n      left,\n      top,\n      right: left + (Number(viewport.width) || 0),\n      bottom: top + (Number(viewport.height) || 0)\n    };\n  }\n\n  static #dimension(value, method, property)\n  {\n    return Number(value?.[`Get${method}`]?.() ?? value?.[property]) || 0;\n  }\n\n  static #isTextureResource(value)\n  {\n    const name = CjsSchema.getClassName(value?.constructor) ?? value?._sourceClassName ?? \"\";\n    return name === \"TriTextureRes\" || /TextureRes$/.test(name) || typeof value?.GetTexture === \"function\";\n  }\n}\n"],"names":["_TriStepCopyRenderTar","_identity","TriStepCopyRenderTarget","TriRenderStep","e","_init_Destination","_init_extra_Destination","_init_destinationTexture","_init_extra_destinationTexture","_init_Source","_init_extra_Source","_init_sourceViewport","_init_extra_sourceViewport","_init_destinationViewport","_init_extra_destinationViewport","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","objectRef","carbon","method","impl","adapted","implemented","constructor","args","Destination","destinationTexture","Source","sourceViewport","destinationViewport","destination","value","source","__init__","Execute","_realTime","_simTime","executor","intent","GetCopyIntent","TriRenderJob","StepResult","RS_OK","copied","CopyRenderTarget","RS_FAILED","destX","Number","x","destY","y","destinationType","destinationPoint","sourceRect","#renderTargetIntent","width","height","right","bottom","left","top","destinationRect","#viewportRect","viewport","#dimension","property","#isTextureResource","name","CjsSchema","getClassName","_sourceClassName","test","GetTexture"],"mappings":"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"}
+{"version":3,"file":"TriStepCopyRenderTarget.js","sources":["../../../src/renderJob/TriStepCopyRenderTarget.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepCopyRenderTarget.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepCopyRenderTarget.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepCopyRenderTarget_Blue.cpp\nimport { CjsSchema, carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n/**\n * Step describing a copy out of one render target into another render target or\n * into a texture resource, including the source and destination sub-rectangles.\n */\n@type.define({ className: \"TriStepCopyRenderTarget\", family: \"renderJob\" })\nexport class TriStepCopyRenderTarget extends TriRenderStep\n{\n  @io.readwrite\n  @type.objectRef(\"Tr2RenderTarget\")\n  Destination = null;\n\n  @io.readwrite\n  @type.objectRef(\"TriTextureRes\")\n  destinationTexture = null;\n\n  @io.readwrite\n  @type.objectRef(\"Tr2RenderTarget\")\n  Source = null;\n\n  @io.readwrite\n  @type.objectRef(\"TriViewport\")\n  sourceViewport = null;\n\n  @io.readwrite\n  @type.objectRef(\"TriViewport\")\n  destinationViewport = null;\n\n  /** Reads the destination render target under Carbon's lower-case accessor name. */\n  get destination()\n  {\n    return this.Destination;\n  }\n\n  /** Sets the destination render target, normalising a missing value to null. */\n  set destination(value)\n  {\n    this.Destination = value ?? null;\n  }\n\n  /** Reads the source render target under Carbon's lower-case accessor name. */\n  get source()\n  {\n    return this.Source;\n  }\n\n  /** Sets the source render target, normalising a missing value to null. */\n  set source(value)\n  {\n    this.Source = value ?? null;\n  }\n\n  /**\n   * Assigns the copy operands, routing a texture-resource destination to\n   * destinationTexture and anything else to the render-target destination.\n   */\n  @carbon.method\n  @impl.adapted\n  __init__(destination = null, source = null, destinationViewport = null, sourceViewport = null)\n  {\n    if (destination)\n    {\n      if (TriStepCopyRenderTarget.#isTextureResource(destination)) this.destinationTexture = destination;\n      else this.Destination = destination;\n    }\n    this.Source = source ?? null;\n    this.destinationViewport = destinationViewport ?? null;\n    this.sourceViewport = sourceViewport ?? null;\n  }\n\n  /**\n   * Builds the copy intent and hands it to the executor's CopyRenderTarget;\n   * incomplete operands yield no intent and are a no-op that still reports\n   * RS_OK, while an explicit false from the executor is RS_FAILED.\n   */\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    const intent = this.GetCopyIntent();\n    if (!intent) return TriRenderJob.StepResult.RS_OK;\n    const copied = executor?.CopyRenderTarget?.(intent);\n    return copied === false ? TriRenderJob.StepResult.RS_FAILED : TriRenderJob.StepResult.RS_OK;\n  }\n\n  /**\n   * Carbon TriStepCopyRenderTarget::Execute (cpp:13-95): resolves the operands and viewports into a plain copy description the executor performs, with destinationType distinguishing the render-target path from the texture path.\n   * @returns {object|null} the copy intent, or null when the source or both destinations are missing\n   */\n  @carbon.method\n  @impl.adapted\n  GetCopyIntent()\n  {\n    if (!this.Source || (!this.Destination && !this.destinationTexture)) return null;\n    const destX = Number(this.destinationViewport?.x) || 0;\n    const destY = Number(this.destinationViewport?.y) || 0;\n    if (this.Destination)\n    {\n      return TriStepCopyRenderTarget.#renderTargetIntent(\n        this.Source,\n        this.Destination,\n        this.sourceViewport,\n        destX,\n        destY\n      );\n    }\n    return {\n      source: this.Source,\n      destination: this.destinationTexture,\n      destinationType: \"texture\",\n      destinationPoint: { x: destX, y: destY },\n      sourceRect: this.sourceViewport ? TriStepCopyRenderTarget.#viewportRect(this.sourceViewport) : null\n    };\n  }\n\n  /**\n   * Builds the render-target-to-render-target rectangles: a source viewport with\n   * a non-positive extent cancels the copy, and a negative destination origin\n   * clamps to zero while trimming the same amount off the source rectangle\n   * (Carbon TriStepCopyRenderTarget.cpp:33-73).\n   */\n  static #renderTargetIntent(source, destination, sourceViewport, destX, destY)\n  {\n    let x = destX;\n    let y = destY;\n    let sourceRect;\n    if (sourceViewport)\n    {\n      if (Number(sourceViewport.width) <= 0 || Number(sourceViewport.height) <= 0) return null;\n      sourceRect = TriStepCopyRenderTarget.#viewportRect(sourceViewport);\n      if (x < 0)\n      {\n        sourceRect.right -= -x;\n        x = 0;\n      }\n      if (y < 0)\n      {\n        sourceRect.bottom -= -y;\n        y = 0;\n      }\n    }\n    else\n    {\n      sourceRect = {\n        left: 0,\n        top: 0,\n        right: TriStepCopyRenderTarget.#dimension(source, \"Width\", \"width\"),\n        bottom: TriStepCopyRenderTarget.#dimension(source, \"Height\", \"height\")\n      };\n      if (x < 0)\n      {\n        sourceRect.right += x;\n        x = 0;\n      }\n      if (y < 0)\n      {\n        sourceRect.bottom += y;\n        y = 0;\n      }\n    }\n    return {\n      source,\n      destination,\n      destinationType: \"renderTarget\",\n      sourceRect,\n      destinationRect: {\n        left: x,\n        top: y,\n        right: x + sourceRect.right - sourceRect.left,\n        bottom: y + sourceRect.bottom - sourceRect.top\n      }\n    };\n  }\n\n  /**\n   * Converts a viewport's x/y/width/height into a left/top/right/bottom\n   * rectangle, treating non-numeric fields as zero.\n   */\n  static #viewportRect(viewport)\n  {\n    const left = Number(viewport.x) || 0;\n    const top = Number(viewport.y) || 0;\n    return {\n      left,\n      top,\n      right: left + (Number(viewport.width) || 0),\n      bottom: top + (Number(viewport.height) || 0)\n    };\n  }\n\n  /**\n   * Reads a dimension off a render target through its Get<Name>() accessor or\n   * its lower-case property, yielding 0 when neither is present.\n   */\n  static #dimension(value, method, property)\n  {\n    return Number(value?.[`Get${method}`]?.() ?? value?.[property]) || 0;\n  }\n\n  /**\n   * Identifies a destination as a texture resource by its registered class name,\n   * a name ending in TextureRes, or the presence of GetTexture.\n   */\n  static #isTextureResource(value)\n  {\n    const name = CjsSchema.getClassName(value?.constructor) ?? value?._sourceClassName ?? \"\";\n    return name === \"TriTextureRes\" || /TextureRes$/.test(name) || typeof value?.GetTexture === \"function\";\n  }\n}\n"],"names":["_TriStepCopyRenderTar","_identity","TriStepCopyRenderTarget","TriRenderStep","e","_init_Destination","_init_extra_Destination","_init_destinationTexture","_init_extra_destinationTexture","_init_Source","_init_extra_Source","_init_sourceViewport","_init_extra_sourceViewport","_init_destinationViewport","_init_extra_destinationViewport","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","objectRef","carbon","method","impl","adapted","implemented","constructor","args","Destination","destinationTexture","Source","sourceViewport","destinationViewport","destination","value","source","__init__","Execute","_realTime","_simTime","executor","intent","GetCopyIntent","TriRenderJob","StepResult","RS_OK","copied","CopyRenderTarget","RS_FAILED","destX","Number","x","destY","y","destinationType","destinationPoint","sourceRect","#renderTargetIntent","width","height","right","bottom","left","top","destinationRect","#viewportRect","viewport","#dimension","property","#isTextureResource","name","CjsSchema","getClassName","_sourceClassName","test","GetTexture"],"mappings":"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"}

package/dist/renderJob/TriStepEnableWireframeMode.js

@@ -1,9 +1,11 @@
 import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { TriRenderJob as _TriRenderJob } from './TriRenderJob.js';
 import { TriRenderStep as _TriRenderStep } from './TriRenderStep.js';
 
 let _initProto, _initClass, _init_enableWireframe, _init_extra_enableWireframe;
+
+/** Step that turns wireframe rasterization on or off for the steps that follow. */
 let _TriStepEnableWirefra;
 class TriStepEnableWireframeMode extends _TriRenderStep {
   static {
@@ -20,9 +22,16 @@ class TriStepEnableWireframeMode extends _TriRenderStep {
     _init_extra_enableWireframe(this);
   }
   enableWireframe = (_initProto(this), _init_enableWireframe(this, false));
+
+  /** Stores the wireframe flag, defaulting to off. */
   __init__(value = false) {
     this.enableWireframe = !!value;
   }
+
+  /**
+   * Forwards the flag to the executor; nothing restores the previous mode, so a
+   * matching step is needed to turn wireframe back off.
+   */
   Execute(_realTime, _simTime, executor) {
     executor?.SetWireframeRendering?.(this.enableWireframe);
     return _TriRenderJob.StepResult.RS_OK;

package/dist/renderJob/TriStepEnableWireframeMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriStepEnableWireframeMode.js","sources":["../../../src/renderJob/TriStepEnableWireframeMode.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepEnableWireframeMode.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n@type.define({ className: \"TriStepEnableWireframeMode\", family: \"renderJob\" })\nexport class TriStepEnableWireframeMode extends TriRenderStep\n{\n  @io.readwrite\n  @type.boolean\n  enableWireframe = false;\n\n  @carbon.method\n  @impl.adapted\n  __init__(value = false)\n  {\n    this.enableWireframe = !!value;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    executor?.SetWireframeRendering?.(this.enableWireframe);\n    return TriRenderJob.StepResult.RS_OK;\n  }\n}\n"],"names":["_TriStepEnableWirefra","TriStepEnableWireframeMode","TriRenderStep","e","_init_enableWireframe","_init_extra_enableWireframe","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","boolean","carbon","method","impl","adapted","implemented","constructor","args","enableWireframe","__init__","value","Execute","_realTime","_simTime","executor","SetWireframeRendering","TriRenderJob","StepResult","RS_OK"],"mappings":";;;;;;AAGmD,IAAAA;AAGnD,MAAAC,0BAAA,SACgDC,cAAa,CAC7D;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,qBAAA,EAAAC,2BAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,4BAA4B;AAAEC,MAAAA,MAAM,EAAE;AAAY,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAG3EC,EAAE,EAAFA,EAAE,CAACC,SAAS,EACZL,IAAI,EAAJA,IAAI,CAACM,OAAO,6BAGZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAMZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,+BAd6BnB,cAAa,CAAA;AAAA;AAAAoB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,2BAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI3DmB,EAAAA,eAAe,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAF,qBAAA,OAAG,KAAK,CAAA;AAIvBqB,EAAAA,QAAQA,CAACC,KAAK,GAAG,KAAK,EACtB;AACE,IAAA,IAAI,CAACF,eAAe,GAAG,CAAC,CAACE,KAAK;AAChC,EAAA;AAIAC,EAAAA,OAAOA,CAACC,SAAS,EAAEC,QAAQ,EAAEC,QAAQ,EACrC;AACEA,IAAAA,QAAQ,EAAEC,qBAAqB,GAAG,IAAI,CAACP,eAAe,CAAC;AACvD,IAAA,OAAOQ,aAAY,CAACC,UAAU,CAACC,KAAK;AACtC,EAAA;AAAC,EAAA;IAAA1B,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"TriStepEnableWireframeMode.js","sources":["../../../src/renderJob/TriStepEnableWireframeMode.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepEnableWireframeMode.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n/** Step that turns wireframe rasterization on or off for the steps that follow. */\n@type.define({ className: \"TriStepEnableWireframeMode\", family: \"renderJob\" })\nexport class TriStepEnableWireframeMode extends TriRenderStep\n{\n  @io.readwrite\n  @type.boolean\n  enableWireframe = false;\n\n  /** Stores the wireframe flag, defaulting to off. */\n  @carbon.method\n  @impl.adapted\n  __init__(value = false)\n  {\n    this.enableWireframe = !!value;\n  }\n\n  /**\n   * Forwards the flag to the executor; nothing restores the previous mode, so a\n   * matching step is needed to turn wireframe back off.\n   */\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    executor?.SetWireframeRendering?.(this.enableWireframe);\n    return TriRenderJob.StepResult.RS_OK;\n  }\n}\n"],"names":["_TriStepEnableWirefra","TriStepEnableWireframeMode","TriRenderStep","e","_init_enableWireframe","_init_extra_enableWireframe","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","boolean","carbon","method","impl","adapted","implemented","constructor","args","enableWireframe","__init__","value","Execute","_realTime","_simTime","executor","SetWireframeRendering","TriRenderJob","StepResult","RS_OK"],"mappings":";;;;;;;AAMA;AAAA,IAAAA;AACA,MAAAC,0BAAA,SACgDC,cAAa,CAC7D;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,qBAAA,EAAAC,2BAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,4BAA4B;AAAEC,MAAAA,MAAM,EAAE;AAAY,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAG3EC,EAAE,EAAFA,EAAE,CAACC,SAAS,EACZL,IAAI,EAAJA,IAAI,CAACM,OAAO,6BAIZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAUZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,+BAnB6BnB,cAAa,CAAA;AAAA;AAAAoB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,2BAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAI3DmB,EAAAA,eAAe,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAF,qBAAA,OAAG,KAAK,CAAA;;AAEvB;AAGAqB,EAAAA,QAAQA,CAACC,KAAK,GAAG,KAAK,EACtB;AACE,IAAA,IAAI,CAACF,eAAe,GAAG,CAAC,CAACE,KAAK;AAChC,EAAA;;AAEA;AACF;AACA;AACA;AAGEC,EAAAA,OAAOA,CAACC,SAAS,EAAEC,QAAQ,EAAEC,QAAQ,EACrC;AACEA,IAAAA,QAAQ,EAAEC,qBAAqB,GAAG,IAAI,CAACP,eAAe,CAAC;AACvD,IAAA,OAAOQ,aAAY,CAACC,UAAU,CAACC,KAAK;AACtC,EAAA;AAAC,EAAA;IAAA1B,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/renderJob/TriStepGenerateMipMaps.js

@@ -1,9 +1,11 @@
 import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { io, carbon, impl, type } from '@carbonenginejs/core-types/schema';
+import { io, carbon, impl, type } from '@carbonenginejs/runtime-utils/schema';
 import { TriRenderJob as _TriRenderJob } from './TriRenderJob.js';
 import { TriRenderStep as _TriRenderStep } from './TriRenderStep.js';
 
 let _initProto, _initClass, _init_renderTarget, _init_extra_renderTarget;
+
+/** Step that requests regeneration of a render target's mip chain. */
 let _TriStepGenerateMipMa;
 class TriStepGenerateMipMaps extends _TriRenderStep {
   static {
@@ -20,9 +22,16 @@ class TriStepGenerateMipMaps extends _TriRenderStep {
     _init_extra_renderTarget(this);
   }
   renderTarget = (_initProto(this), _init_renderTarget(this, null));
+
+  /** Stores the render target whose mip chain is regenerated. */
   __init__(renderTarget = null) {
     this.renderTarget = renderTarget ?? null;
   }
+
+  /**
+   * Asks the executor to regenerate the target's mip maps; with no target set
+   * the step is a no-op.
+   */
   Execute(_realTime, _simTime, executor) {
     if (this.renderTarget) executor?.GenerateMipMaps?.(this.renderTarget);
     return _TriRenderJob.StepResult.RS_OK;

package/dist/renderJob/TriStepGenerateMipMaps.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriStepGenerateMipMaps.js","sources":["../../../src/renderJob/TriStepGenerateMipMaps.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepGenerateMipMaps.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepGenerateMipMaps.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n@type.define({ className: \"TriStepGenerateMipMaps\", family: \"renderJob\" })\nexport class TriStepGenerateMipMaps extends TriRenderStep\n{\n  @io.persist\n  @type.objectRef(\"Tr2RenderTarget\")\n  renderTarget = null;\n\n  @carbon.method\n  @impl.adapted\n  __init__(renderTarget = null)\n  {\n    this.renderTarget = renderTarget ?? null;\n  }\n\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    if (this.renderTarget) executor?.GenerateMipMaps?.(this.renderTarget);\n    return TriRenderJob.StepResult.RS_OK;\n  }\n}\n"],"names":["_TriStepGenerateMipMa","TriStepGenerateMipMaps","TriRenderStep","e","_init_renderTarget","_init_extra_renderTarget","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","carbon","method","impl","adapted","implemented","constructor","args","renderTarget","__init__","Execute","_realTime","_simTime","executor","GenerateMipMaps","TriRenderJob","StepResult","RS_OK"],"mappings":";;;;;;AAImD,IAAAA;AAGnD,MAAAC,sBAAA,SAC4CC,cAAa,CACzD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,kBAAA,EAAAC,wBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,wBAAwB;AAAEC,MAAAA,MAAM,EAAE;AAAY,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGvEC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,iBAAiB,CAAC,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAGjCC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAMZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,+BAdyBnB,cAAa,CAAA;AAAA;AAAAoB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,wBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAIvDmB,EAAAA,YAAY,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAF,kBAAA,OAAG,IAAI,CAAA;AAInBqB,EAAAA,QAAQA,CAACD,YAAY,GAAG,IAAI,EAC5B;AACE,IAAA,IAAI,CAACA,YAAY,GAAGA,YAAY,IAAI,IAAI;AAC1C,EAAA;AAIAE,EAAAA,OAAOA,CAACC,SAAS,EAAEC,QAAQ,EAAEC,QAAQ,EACrC;IACE,IAAI,IAAI,CAACL,YAAY,EAAEK,QAAQ,EAAEC,eAAe,GAAG,IAAI,CAACN,YAAY,CAAC;AACrE,IAAA,OAAOO,aAAY,CAACC,UAAU,CAACC,KAAK;AACtC,EAAA;AAAC,EAAA;IAAAzB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"TriStepGenerateMipMaps.js","sources":["../../../src/renderJob/TriStepGenerateMipMaps.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepGenerateMipMaps.h\n// Source: E:\\carbonengine\\trinity\\trinity\\RenderJob\\TriStepGenerateMipMaps.cpp\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { TriRenderJob } from \"./TriRenderJob.js\";\nimport { TriRenderStep } from \"./TriRenderStep.js\";\n\n\n/** Step that requests regeneration of a render target's mip chain. */\n@type.define({ className: \"TriStepGenerateMipMaps\", family: \"renderJob\" })\nexport class TriStepGenerateMipMaps extends TriRenderStep\n{\n  @io.persist\n  @type.objectRef(\"Tr2RenderTarget\")\n  renderTarget = null;\n\n  /** Stores the render target whose mip chain is regenerated. */\n  @carbon.method\n  @impl.adapted\n  __init__(renderTarget = null)\n  {\n    this.renderTarget = renderTarget ?? null;\n  }\n\n  /**\n   * Asks the executor to regenerate the target's mip maps; with no target set\n   * the step is a no-op.\n   */\n  @carbon.method\n  @impl.implemented\n  Execute(_realTime, _simTime, executor)\n  {\n    if (this.renderTarget) executor?.GenerateMipMaps?.(this.renderTarget);\n    return TriRenderJob.StepResult.RS_OK;\n  }\n}\n"],"names":["_TriStepGenerateMipMa","TriStepGenerateMipMaps","TriRenderStep","e","_init_renderTarget","_init_extra_renderTarget","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","carbon","method","impl","adapted","implemented","constructor","args","renderTarget","__init__","Execute","_realTime","_simTime","executor","GenerateMipMaps","TriRenderJob","StepResult","RS_OK"],"mappings":";;;;;;;AAOA;AAAA,IAAAA;AACA,MAAAC,sBAAA,SAC4CC,cAAa,CACzD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,kBAAA,EAAAC,wBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAP,qBAAA,EAAAQ,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,wBAAwB;AAAEC,MAAAA,MAAM,EAAE;AAAY,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CAGvEC,EAAE,EAAFA,EAAE,CAACC,OAAO,EAAA,MAAA,EACVL,IAAI,CAACM,SAAS,CAAC,iBAAiB,CAAC,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAIjCC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAUZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,+BAnByBnB,cAAa,CAAA;AAAA;AAAAoB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAlB,wBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAIvDmB,EAAAA,YAAY,IAAAlB,UAAA,CAAA,IAAA,CAAA,EAAAF,kBAAA,OAAG,IAAI,CAAA;;AAEnB;AAGAqB,EAAAA,QAAQA,CAACD,YAAY,GAAG,IAAI,EAC5B;AACE,IAAA,IAAI,CAACA,YAAY,GAAGA,YAAY,IAAI,IAAI;AAC1C,EAAA;;AAEA;AACF;AACA;AACA;AAGEE,EAAAA,OAAOA,CAACC,SAAS,EAAEC,QAAQ,EAAEC,QAAQ,EACrC;IACE,IAAI,IAAI,CAACL,YAAY,EAAEK,QAAQ,EAAEC,eAAe,GAAG,IAAI,CAACN,YAAY,CAAC;AACrE,IAAA,OAAOO,aAAY,CAACC,UAAU,CAACC,KAAK;AACtC,EAAA;AAAC,EAAA;IAAAzB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/renderJob/TriStepPopDepthStencil.js

@@ -1,9 +1,11 @@
 import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { carbon, impl, type } from '@carbonenginejs/core-types/schema';
+import { carbon, impl, type } from '@carbonenginejs/runtime-utils/schema';
 import { TriRenderStep as _TriRenderStep } from './TriRenderStep.js';
 import { TriRenderJob as _TriRenderJob } from './TriRenderJob.js';
 
 let _initProto, _initClass;
+
+/** Step that pops the executor's depth-stencil stack, undoing an earlier push. */
 let _TriStepPopDepthStenc;
 class TriStepPopDepthStencil extends _TriRenderStep {
   static {
@@ -19,6 +21,10 @@ class TriStepPopDepthStencil extends _TriRenderStep {
     super(...args);
     _initProto(this);
   }
+  /**
+   * Pops the depth-stencil pushed earlier in the job; popping more than was
+   * pushed trips the job's stack guard.
+   */
   Execute(_realTime, _simTime, executor) {
     executor?.PopDepthStencil?.();
     return _TriRenderJob.StepResult.RS_OK;