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

package/docs/trinity/reference/implementation-status.md

@@ -1,33 +1,33 @@
-# Runtime Trinity implementation status
-
-Status: Evolving
-Scope: `@carbonenginejs/runtime/trinity`
-Audience: Runtime authors, engine authors, and maintainers
-Summary: Defines the implementation audits and records current user-visible graph limitations.
-
-## Purpose
-
+# Runtime Trinity implementation status
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime/trinity`
+Audience: Runtime authors, engine authors, and maintainers
+Summary: Defines the implementation audits and records current user-visible graph limitations.
+
+## Purpose
+
 Three complementary audits keep incomplete behavior explicit. Their command
-output is authoritative for the checked source state; this page explains how
-to interpret that output and records the current package-level limitation.
-
-## Explicit implementation gaps
-
-Run:
-
-```sh
+output is authoritative for the checked source state; this page explains how
+to interpret that output and records the current package-level limitation.
+
+## Explicit implementation gaps
+
+Run:
+
+```sh
 npm run audit:trinity:gaps
-```
-
-The gap audit inventories `@impl.notImplemented` methods and `@type.unknown`
-properties in generated and maintained source. It excludes the deliberate
-`src/trinity/dropped` quarantine by default.
-
+```
+
+The gap audit inventories `@impl.notImplemented` methods and `@type.unknown`
+properties in generated and maintained source. It excludes the deliberate
+`src/trinity/dropped` quarantine by default.
+
 The recorded gap-audit snapshot contains (not a fresh current-source count):
 
 - 142 explicit methods across 44 classes; and
 - zero unknown properties.
-
+
 In that snapshot, the remaining methods were concentrated in native, GPU,
 font, bitmap/atlas, particle, scene-picking, smart-light, and related
 backend-facing families.
@@ -52,25 +52,25 @@ now call both emitters and systems directly.
 `ITr2InstanceData` likewise separates the provider contract from its returned
 instance-data packet. `Tr2RuntimeInstanceData` and `Tr2ParticleSystem` now
 publish their ready CPU buffers, normalized layouts, counts, and bounds through
-that contract; `Tr2DirectInstanceData` deliberately inherits the throwing
-buffer/readiness methods until an engine supplies its physical realization.
-
+that contract; `Tr2DirectInstanceData` inherits the throwing buffer/readiness
+methods, and the buffer work behind them is not ported yet.
+
 Required interface operations are not counted as implementation gaps. Their
 canonical root carries `@impl.abstract` and throws; a subclass that does not
 override the operation therefore inherits the failure.
-
-## Promoted-class parity
-
-Run the parity audit against a compiled Carbon schema supplied by the caller:
-
-```sh
+
+## Promoted-class parity
+
+Run the parity audit against a compiled Carbon schema supplied by the caller:
+
+```sh
 npm run audit:trinity:parity -- --schema-root path/to/schema-build
-```
-
-The `CARBON_SCHEMA_ROOT` environment variable may provide the same location.
-The audit resolves JavaScript inheritance, checks `@carbon.method` exposure,
-and excludes deliberately quarantined classes.
-
+```
+
+The `CARBON_SCHEMA_ROOT` environment variable may provide the same location.
+The audit resolves JavaScript inheritance, checks `@carbon.method` exposure,
+and excludes deliberately quarantined classes.
+
 Against the isolated 2026-08-22 Carbon schema refresh, the recorded audit checked
 344 promoted classes and excluded 32 quarantined classes. It reported no
 omitted or present-but-unexposed Carbon methods, missing JavaScript classes,
@@ -108,11 +108,11 @@ implemented in maintained source:
   edit-session state is private rather than schema data.
 - `EveChildCloud` now inherits the maintained `EveSpaceObjectChild` contract
   and owns its CPU SRT composition, world bounds, visibility gate, and exposed
-  transform/sphere queries; its GPU cloud realization remains engine-owned.
+  transform/sphere queries; its GPU cloud work is not ported yet.
 - `CjsInstancedMeshManager` is the dependency-free CPU registration contract.
   Trinity calls it directly, registers terminal `RawData`, and retains the
-  issuing manager separately from opaque handles; production engine
-  realization remains open in the supporting engines.
+  issuing manager separately from opaque handles; the manager behind those
+  handles is not ported.
 - `ITr2BoundingBox` is a dependency-free global contract. Effect roots,
   transforms, planets, root transforms, and space objects inherit its abstract
   methods through dependency-safe contract mixins and override the Carbon
@@ -161,36 +161,36 @@ implementations extend it, and call required methods directly. Consumers do
 not preflight methods on organization-owned values. Opaque `@type.rawStruct`
 identities remain informational because they describe native layouts rather
 than runtime classes.
-
+
 ## Controller compatibility proof
-
-Controller and binding implementations are present and covered by JavaScript
-tests, but exact Carbon output and ordering parity is not yet proven. Passing
-the package suite establishes internal consistency, not equivalence to Carbon.
-Before accepting behavioral cleanup, compare Carbon and JavaScript traces for:
-
-1. initialization and linking order;
-2. repeated equal and unequal writes;
-3. scalar, boolean, array-fill, and swizzled binding destinations;
-4. destination-buffer writes and dirty-mask accumulation;
-5. same-frame multiple writes and frame-boundary mask consumption;
-6. state-machine transition evaluation and variable masks;
-7. source propagation and external events, confirming events do not affect
-   controller correctness; and
-8. output values and timing across representative update sequences.
-
-Generic binding destinations suppress equal-value writes unless the field is
-marked `@io.always`. Controller float variables deliberately carry that marker
-so equal writes still reach their destination and dirty mask. Initialization
-is silent, and the masks remain frame-consumed; those semantics are part of the
-parity gate rather than incidental test behavior.
+
+Controller and binding implementations are present and covered by JavaScript
+tests, but exact Carbon output and ordering parity is not yet proven. Passing
+the package suite establishes internal consistency, not equivalence to Carbon.
+Before accepting behavioral cleanup, compare Carbon and JavaScript traces for:
+
+1. initialization and linking order;
+2. repeated equal and unequal writes;
+3. scalar, boolean, array-fill, and swizzled binding destinations;
+4. destination-buffer writes and dirty-mask accumulation;
+5. same-frame multiple writes and frame-boundary mask consumption;
+6. state-machine transition evaluation and variable masks;
+7. source propagation and external events, confirming events do not affect
+   controller correctness; and
+8. output values and timing across representative update sequences.
+
+Generic binding destinations suppress equal-value writes unless the field is
+marked `@edit.always`. Controller float variables deliberately carry that marker
+so equal writes still reach their destination and dirty mask. Initialization
+is silent, and the masks remain frame-consumed; those semantics are part of the
+parity gate rather than incidental test behavior.
 
 ## Current runtime limits
 
 The architecture owns [mesh draw arguments](../architecture.md#render-batch-contract),
 [frame/tick ordering](../architecture.md#frame-contract), and
 [vertex-declaration matching](../architecture.md#vertex-declaration-matching).
-`CjsFrameDriver` requires exact lifecycle, render-context, and render-job identities.
+Carbon's frame body is unported; see trinity architecture, *Frame contract*.
 Catalog completeness and promotion gates are below.
 
 - Device creation, GPU resources, draw submission, presentation, and
@@ -205,14 +205,14 @@ Catalog completeness and promotion gates are below.
   documentation. `npm run catalog:trinity` reports no missing catalog entry.
   Promotion review must continue to install a descriptor before a new
   maintained class is considered complete.
-- `EveSpaceScene` owns persistent per-frame record storage and fills scene,
-  lighting, fog, shadow-quality, and volumetric values. Its fill methods
-  consume stored history and jitter fields, but JavaScript does not yet
-  advance them; the host must provision them or they retain identity/zero
-  defaults. The driver supplies current render-context/device values, frame
-  counters, dimensions, gamma/mip/upscaling settings, atlas settings, and an
-  optional shadow map. Pixel fill precedes vertex fill because it resets the
-  upscaling amount read by the vertex record.
+- `EveSpaceScene` owns persistent per-frame record storage and fills scene,
+  lighting, fog, shadow-quality, and volumetric values. Its fill methods
+  consume stored history and jitter fields, but JavaScript does not yet
+  advance them; the host must provision them or they retain identity/zero
+  defaults. The driver supplies current render-context/device values, frame
+  counters, dimensions, gamma/mip/upscaling settings, atlas settings, and an
+  optional shadow map. Pixel fill precedes vertex fill because it resets the
+  upscaling amount read by the vertex record.
 - Per-object layouts and restored data classes do not prove producer
   completeness. `EveLineSet` and `EveCurveLineSet` now allocate
   `Tr2PerObjectDataStandard`, but `EveEllipseSet.GetPerObjectData` still reaches
@@ -252,33 +252,33 @@ Catalog completeness and promotion gates are below.
 - The child reference and socket resource seam is synchronous and injected.
 - Socket parameter auto-creation currently covers the emitted string
   parameter type; additional types require corresponding schema emission.
-- Portable pick-batch and identity behavior is implemented for
-  `EveSpaceObject2`, `EveTransform`, and the inherited transform family.
-  GPU-readback scene picking remains explicit, as do decal pick-batch and
-  sphere-pin pick surfaces.
-- The cross-package bone-curve seam is incomplete. `Tr2BoneMatrixCurve`
+- Portable pick-batch and identity behavior is implemented for
+  `EveSpaceObject2`, `EveTransform`, and the inherited transform family.
+  GPU-readback scene picking remains explicit, as do decal pick-batch and
+  sphere-pin pick surfaces.
+- The cross-package bone-curve seam is incomplete. `Tr2BoneMatrixCurve`
   currently supplies a bone name where the `src/character` skinned-object
-  surface accepts a numeric index, and it does not re-resolve that index when
-  the skeleton tag changes.
-- Calculated whole-object bounds remain planned as a separate lazy cache and
-  are not inferred through generic graph traversal.
+  surface accepts a numeric index, and it does not re-resolve that index when
+  the skeleton tag changes.
+- Calculated whole-object bounds remain planned as a separate lazy cache and
+  are not inferred through generic graph traversal.
 - The maintained `EveSpaceSceneRenderDriver` implements a partial frame spine:
   scene update, lighting/fog updates, visibility/gather, batch submission and
   per-frame fills. It does not yet implement the complete rendering sequence.
-
-## Planned completion gates
-
+
+## Planned completion gates
+
 See [Generated-class lifecycle](../concepts/generated-class-lifecycle.md) for
 promotion and maintained-home review. Later schema/interface obligations remain
 explicit parity-audit gaps without undoing promotion. Backend-only methods remain
 explicit until an owning engine exposes a proven capability.
-
+
 The public class-purpose catalog is current for documented classes. Promotion
 still requires reviewed descriptor metadata, catalog regeneration, and
 documentation validation; dropped quarantine classes remain excluded.
-
-## Related documentation
-
-- [Architecture and ownership boundaries](../architecture.md)
-- [Generated-class lifecycle](../concepts/generated-class-lifecycle.md)
-- [Current API](api.md)
+
+## Related documentation
+
+- [Architecture and ownership boundaries](../architecture.md)
+- [Generated-class lifecycle](../concepts/generated-class-lifecycle.md)
+- [Current API](api.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carbonenginejs/runtime",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "private": false,
   "description": "Browser-safe CarbonEngineJS runtime: resource and format readers, the Trinity/EVE object graph, SOF, audio, character, and the WebGPU renderer.",
   "type": "module",
@@ -184,6 +184,7 @@
     "#utils/resfile": "./dist/global/utils/resFile.js",
     "#utils/*": "./dist/global/utils/*.js",
     "#consts": "./dist/global/consts/index.js",
+    "#consts/blue": "./dist/global/consts/blue.js",
     "#consts/media": "./dist/global/consts/media/index.js",
     "#consts/graphics": "./dist/global/consts/graphics/index.js",
     "#consts/render-context": "./dist/global/consts/renderContext/index.js",

package/dist/core/CjsFrameDriver.js

@@ -1,109 +0,0 @@
-// Source: trinity/trinity/TriDevice.cpp:1151-1187
-// Source: trinity/trinity/TriDevice.cpp:805-843
-// Source: trinity/trinity/Tr2Renderer.cpp:1040-1081
-//
-// Carbon places this neutral frame body on each backend TriDevice. The combined
-// runtime keeps its ordering in core composition while the concrete engine
-// supplies the nominal device-facing lifecycle. Presentation is deliberately
-// absent: Carbon presents the previous frame at the top of the next engine tick
-// to overlap CPU and GPU work.
-/** Runs Carbon's backend-neutral frame body against exact runtime identities. */
-class CjsFrameDriver {
-  #renderContext;
-  #renderJobs;
-  #frameLifecycle;
-
-  /**
-   * Creates a driver from the context, jobs, and engine lifecycle required by
-   * every frame.
-   */
-  constructor({
-    renderContext,
-    renderJobs,
-    frameLifecycle
-  } = {}) {
-    this.#renderContext = renderContext;
-    this.SetRenderJobs(renderJobs);
-    this.SetFrameLifecycle(frameLifecycle);
-  }
-
-  /** Returns the exact render context this driver brackets. */
-  GetRenderContext() {
-    return this.#renderContext;
-  }
-
-  /** Binds the exact render-job scheduler run each frame. */
-  SetRenderJobs(renderJobs) {
-    this.#renderJobs = renderJobs;
-    return this;
-  }
-
-  /** Binds the exact engine lifecycle used for device-facing frame work. */
-  SetFrameLifecycle(frameLifecycle) {
-    this.#frameLifecycle = frameLifecycle;
-    return this;
-  }
-
-  /**
-   * Advances the frame counter and animation time, applying Carbon's hourly
-   * rebase, and returns the new animation time.
-   */
-  Tick(elapsed = 0, animationTimeScale = 1) {
-    const context = this.#renderContext;
-    let animationTime = context.GetAnimationTime() + (Number(elapsed) || 0) * animationTimeScale;
-    if (animationTime > CjsFrameDriver.ANIMATION_TIME_MAX) {
-      animationTime -= CjsFrameDriver.ANIMATION_TIME_MAX;
-    }
-    context.AdvanceFrame(animationTime);
-    return animationTime;
-  }
-
-  /**
-   * Executes one requested frame in Carbon order and closes every opened
-   * bracket even when rendering or an earlier closer fails.
-   */
-  Render(realTime = 0, simTime = 0) {
-    const context = this.#renderContext;
-    const lifecycle = this.#frameLifecycle;
-    const errors = [];
-    let profileOpen = false;
-    let frameOpen = false;
-    let renderContextOpen = false;
-    try {
-      lifecycle.Throttle();
-      lifecycle.SyncToGpu();
-      context.SetViewport(lifecycle.GetViewport());
-      lifecycle.BeginProfileFrame(context.GetCurrentFrameCounter());
-      profileOpen = true;
-      context.BeginFrame();
-      frameOpen = true;
-      context.BeginRenderContext();
-      renderContextOpen = true;
-      lifecycle.ReserveQuadListIndexBuffer(0);
-      this.#renderJobs.Run(realTime, simTime, context);
-    } catch (error) {
-      errors.push(error);
-    }
-    if (profileOpen) CloseRequired(errors, () => lifecycle.EndProfileFrame());
-    if (renderContextOpen) CloseRequired(errors, () => context.EndRenderContext());
-    if (frameOpen) CloseRequired(errors, () => context.EndFrame());
-    if (errors.length === 1) throw errors[0];
-    if (errors.length > 1) {
-      throw new AggregateError(errors, "CjsFrameDriver frame execution and cleanup failed.");
-    }
-    return true;
-  }
-
-  /** Carbon's hourly animation-clock rebase point, in seconds. */
-  static ANIMATION_TIME_MAX = 3600;
-}
-function CloseRequired(errors, close) {
-  try {
-    close();
-  } catch (error) {
-    errors.push(error);
-  }
-}
-
-export { CjsFrameDriver };
-//# sourceMappingURL=CjsFrameDriver.js.map

package/dist/core/CjsFrameDriver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CjsFrameDriver.js","sources":["../../../src/core/CjsFrameDriver.js"],"sourcesContent":["// Source: trinity/trinity/TriDevice.cpp:1151-1187\n// Source: trinity/trinity/TriDevice.cpp:805-843\n// Source: trinity/trinity/Tr2Renderer.cpp:1040-1081\n//\n// Carbon places this neutral frame body on each backend TriDevice. The combined\n// runtime keeps its ordering in core composition while the concrete engine\n// supplies the nominal device-facing lifecycle. Presentation is deliberately\n// absent: Carbon presents the previous frame at the top of the next engine tick\n// to overlap CPU and GPU work.\n/** Runs Carbon's backend-neutral frame body against exact runtime identities. */\nexport class CjsFrameDriver\n{\n    #renderContext;\n\n    #renderJobs;\n\n    #frameLifecycle;\n\n    /**\n     * Creates a driver from the context, jobs, and engine lifecycle required by\n     * every frame.\n     */\n    constructor({ renderContext, renderJobs, frameLifecycle } = {})\n    {\n        this.#renderContext = renderContext;\n        this.SetRenderJobs(renderJobs);\n        this.SetFrameLifecycle(frameLifecycle);\n    }\n\n    /** Returns the exact render context this driver brackets. */\n    GetRenderContext()\n    {\n        return this.#renderContext;\n    }\n\n    /** Binds the exact render-job scheduler run each frame. */\n    SetRenderJobs(renderJobs)\n    {\n        this.#renderJobs = renderJobs;\n        return this;\n    }\n\n    /** Binds the exact engine lifecycle used for device-facing frame work. */\n    SetFrameLifecycle(frameLifecycle)\n    {\n        this.#frameLifecycle = frameLifecycle;\n        return this;\n    }\n\n    /**\n     * Advances the frame counter and animation time, applying Carbon's hourly\n     * rebase, and returns the new animation time.\n     */\n    Tick(elapsed = 0, animationTimeScale = 1)\n    {\n        const context = this.#renderContext;\n        let animationTime = context.GetAnimationTime() + (Number(elapsed) || 0) * animationTimeScale;\n        if (animationTime > CjsFrameDriver.ANIMATION_TIME_MAX)\n        {\n            animationTime -= CjsFrameDriver.ANIMATION_TIME_MAX;\n        }\n        context.AdvanceFrame(animationTime);\n        return animationTime;\n    }\n\n    /**\n     * Executes one requested frame in Carbon order and closes every opened\n     * bracket even when rendering or an earlier closer fails.\n     */\n    Render(realTime = 0, simTime = 0)\n    {\n        const context = this.#renderContext;\n        const lifecycle = this.#frameLifecycle;\n        const errors = [];\n        let profileOpen = false;\n        let frameOpen = false;\n        let renderContextOpen = false;\n\n        try\n        {\n            lifecycle.Throttle();\n            lifecycle.SyncToGpu();\n            context.SetViewport(lifecycle.GetViewport());\n\n            lifecycle.BeginProfileFrame(context.GetCurrentFrameCounter());\n            profileOpen = true;\n\n            context.BeginFrame();\n            frameOpen = true;\n            context.BeginRenderContext();\n            renderContextOpen = true;\n\n            lifecycle.ReserveQuadListIndexBuffer(0);\n            this.#renderJobs.Run(realTime, simTime, context);\n        }\n        catch (error)\n        {\n            errors.push(error);\n        }\n\n        if (profileOpen) CloseRequired(errors, () => lifecycle.EndProfileFrame());\n        if (renderContextOpen) CloseRequired(errors, () => context.EndRenderContext());\n        if (frameOpen) CloseRequired(errors, () => context.EndFrame());\n\n        if (errors.length === 1) throw errors[0];\n        if (errors.length > 1)\n        {\n            throw new AggregateError(errors, \"CjsFrameDriver frame execution and cleanup failed.\");\n        }\n        return true;\n    }\n\n    /** Carbon's hourly animation-clock rebase point, in seconds. */\n    static ANIMATION_TIME_MAX = 3600;\n}\n\nfunction CloseRequired(errors, close)\n{\n    try\n    {\n        close();\n    }\n    catch (error)\n    {\n        errors.push(error);\n    }\n}\n"],"names":["CjsFrameDriver","constructor","renderContext","renderJobs","frameLifecycle","SetRenderJobs","SetFrameLifecycle","GetRenderContext","Tick","elapsed","animationTimeScale","context","animationTime","GetAnimationTime","Number","ANIMATION_TIME_MAX","AdvanceFrame","Render","realTime","simTime","lifecycle","errors","profileOpen","frameOpen","renderContextOpen","Throttle","SyncToGpu","SetViewport","GetViewport","BeginProfileFrame","GetCurrentFrameCounter","BeginFrame","BeginRenderContext","ReserveQuadListIndexBuffer","Run","error","push","CloseRequired","EndProfileFrame","EndRenderContext","EndFrame","length","AggregateError","close"],"mappings":"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"}

package/dist/global/contracts/CjsFrameLifecycle.js

@@ -1,49 +0,0 @@
-import { impl } from '../schema/index.js';
-import { CjsSchema } from '../schema/CjsSchema.js';
-
-/**
- * Dependency-free engine lifecycle required to execute one runtime frame.
- *
- * Presentation and the outer tick remain engine-owned. Every required method
- * throws until a concrete engine lifecycle overrides it.
- */
-class CjsFrameLifecycle {
-  /** Applies engine-owned frame pacing before GPU synchronization. */
-  Throttle() {
-    throw new Error("CjsFrameLifecycle.Throttle must be overridden by a concrete engine lifecycle.");
-  }
-
-  /** Synchronizes queued CPU work to the engine before frame recording. */
-  SyncToGpu() {
-    throw new Error("CjsFrameLifecycle.SyncToGpu must be overridden by a concrete engine lifecycle.");
-  }
-
-  /** Returns the viewport the render context must publish for this frame. */
-  GetViewport() {
-    throw new Error("CjsFrameLifecycle.GetViewport must be overridden by a concrete engine lifecycle.");
-  }
-
-  /** Opens engine profiling for the supplied runtime frame counter. */
-  BeginProfileFrame(_frameCounter) {
-    throw new Error("CjsFrameLifecycle.BeginProfileFrame must be overridden by a concrete engine lifecycle.");
-  }
-
-  /** Closes engine profiling for the current runtime frame. */
-  EndProfileFrame() {
-    throw new Error("CjsFrameLifecycle.EndProfileFrame must be overridden by a concrete engine lifecycle.");
-  }
-
-  /** Reserves the shared quad-list index capacity requested for this frame. */
-  ReserveQuadListIndexBuffer(_count) {
-    throw new Error("CjsFrameLifecycle.ReserveQuadListIndexBuffer must be overridden by a concrete engine lifecycle.");
-  }
-}
-CjsSchema.decorateMethod(CjsFrameLifecycle, "Throttle", impl.abstract);
-CjsSchema.decorateMethod(CjsFrameLifecycle, "SyncToGpu", impl.abstract);
-CjsSchema.decorateMethod(CjsFrameLifecycle, "GetViewport", impl.abstract);
-CjsSchema.decorateMethod(CjsFrameLifecycle, "BeginProfileFrame", impl.abstract);
-CjsSchema.decorateMethod(CjsFrameLifecycle, "EndProfileFrame", impl.abstract);
-CjsSchema.decorateMethod(CjsFrameLifecycle, "ReserveQuadListIndexBuffer", impl.abstract);
-
-export { CjsFrameLifecycle };
-//# sourceMappingURL=CjsFrameLifecycle.js.map

package/dist/global/contracts/CjsFrameLifecycle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CjsFrameLifecycle.js","sources":["../../../../src/global/contracts/CjsFrameLifecycle.js"],"sourcesContent":["import { CjsSchema, impl } from \"../schema/index.js\";\n\n/**\n * Dependency-free engine lifecycle required to execute one runtime frame.\n *\n * Presentation and the outer tick remain engine-owned. Every required method\n * throws until a concrete engine lifecycle overrides it.\n */\nexport class CjsFrameLifecycle\n{\n    /** Applies engine-owned frame pacing before GPU synchronization. */\n    Throttle()\n    {\n        throw new Error(\"CjsFrameLifecycle.Throttle must be overridden by a concrete engine lifecycle.\");\n    }\n\n    /** Synchronizes queued CPU work to the engine before frame recording. */\n    SyncToGpu()\n    {\n        throw new Error(\"CjsFrameLifecycle.SyncToGpu must be overridden by a concrete engine lifecycle.\");\n    }\n\n    /** Returns the viewport the render context must publish for this frame. */\n    GetViewport()\n    {\n        throw new Error(\"CjsFrameLifecycle.GetViewport must be overridden by a concrete engine lifecycle.\");\n    }\n\n    /** Opens engine profiling for the supplied runtime frame counter. */\n    BeginProfileFrame(_frameCounter)\n    {\n        throw new Error(\"CjsFrameLifecycle.BeginProfileFrame must be overridden by a concrete engine lifecycle.\");\n    }\n\n    /** Closes engine profiling for the current runtime frame. */\n    EndProfileFrame()\n    {\n        throw new Error(\"CjsFrameLifecycle.EndProfileFrame must be overridden by a concrete engine lifecycle.\");\n    }\n\n    /** Reserves the shared quad-list index capacity requested for this frame. */\n    ReserveQuadListIndexBuffer(_count)\n    {\n        throw new Error(\"CjsFrameLifecycle.ReserveQuadListIndexBuffer must be overridden by a concrete engine lifecycle.\");\n    }\n}\n\nCjsSchema.decorateMethod(CjsFrameLifecycle, \"Throttle\", impl.abstract);\nCjsSchema.decorateMethod(CjsFrameLifecycle, \"SyncToGpu\", impl.abstract);\nCjsSchema.decorateMethod(CjsFrameLifecycle, \"GetViewport\", impl.abstract);\nCjsSchema.decorateMethod(CjsFrameLifecycle, \"BeginProfileFrame\", impl.abstract);\nCjsSchema.decorateMethod(CjsFrameLifecycle, \"EndProfileFrame\", impl.abstract);\nCjsSchema.decorateMethod(CjsFrameLifecycle, \"ReserveQuadListIndexBuffer\", impl.abstract);\n"],"names":["CjsFrameLifecycle","Throttle","Error","SyncToGpu","GetViewport","BeginProfileFrame","_frameCounter","EndProfileFrame","ReserveQuadListIndexBuffer","_count","CjsSchema","decorateMethod","impl","abstract"],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,iBAAiB,CAC9B;AACI;AACAC,EAAAA,QAAQA,GACR;AACI,IAAA,MAAM,IAAIC,KAAK,CAAC,+EAA+E,CAAC;AACpG,EAAA;;AAEA;AACAC,EAAAA,SAASA,GACT;AACI,IAAA,MAAM,IAAID,KAAK,CAAC,gFAAgF,CAAC;AACrG,EAAA;;AAEA;AACAE,EAAAA,WAAWA,GACX;AACI,IAAA,MAAM,IAAIF,KAAK,CAAC,kFAAkF,CAAC;AACvG,EAAA;;AAEA;EACAG,iBAAiBA,CAACC,aAAa,EAC/B;AACI,IAAA,MAAM,IAAIJ,KAAK,CAAC,wFAAwF,CAAC;AAC7G,EAAA;;AAEA;AACAK,EAAAA,eAAeA,GACf;AACI,IAAA,MAAM,IAAIL,KAAK,CAAC,sFAAsF,CAAC;AAC3G,EAAA;;AAEA;EACAM,0BAA0BA,CAACC,MAAM,EACjC;AACI,IAAA,MAAM,IAAIP,KAAK,CAAC,iGAAiG,CAAC;AACtH,EAAA;AACJ;AAEAQ,SAAS,CAACC,cAAc,CAACX,iBAAiB,EAAE,UAAU,EAAEY,IAAI,CAACC,QAAQ,CAAC;AACtEH,SAAS,CAACC,cAAc,CAACX,iBAAiB,EAAE,WAAW,EAAEY,IAAI,CAACC,QAAQ,CAAC;AACvEH,SAAS,CAACC,cAAc,CAACX,iBAAiB,EAAE,aAAa,EAAEY,IAAI,CAACC,QAAQ,CAAC;AACzEH,SAAS,CAACC,cAAc,CAACX,iBAAiB,EAAE,mBAAmB,EAAEY,IAAI,CAACC,QAAQ,CAAC;AAC/EH,SAAS,CAACC,cAAc,CAACX,iBAAiB,EAAE,iBAAiB,EAAEY,IAAI,CAACC,QAAQ,CAAC;AAC7EH,SAAS,CAACC,cAAc,CAACX,iBAAiB,EAAE,4BAA4B,EAAEY,IAAI,CAACC,QAAQ,CAAC;;;;"}

package/dist/global/contracts/CjsInstancedMeshManager.js

@@ -1,58 +0,0 @@
-import { impl } from '../schema/index.js';
-import { CjsSchema } from '../schema/CjsSchema.js';
-
-/**
- * Dependency-free contract implemented by an engine's instanced-mesh
- * realization. Trinity owns the registration data; the engine owns its GPU
- * buffers, culling allocations and draw submission.
- */
-class CjsInstancedMeshManager {
-  /** Registers one terminal per-object RawData record and returns an opaque handle. */
-  AddPerObjectData(_data) {
-    throw new Error("CjsInstancedMeshManager.AddPerObjectData must be implemented by an engine.");
-  }
-
-  /** Registers one set of instance culling spheres and returns an opaque handle. */
-  AddBoundingSphereGroup(_bounds, _flags, _spheres, _count) {
-    throw new Error("CjsInstancedMeshManager.AddBoundingSphereGroup must be implemented by an engine.");
-  }
-
-  /**
-   * Registers one instanced geometry area and returns an opaque handle.
-   * The arguments are the geometry, vertex declaration, batch type, mesh
-   * index, area index/count, effect/hash, per-object handle, sphere handle,
-   * instance records/count, picking owner and picking-owner index.
-   */
-  AddMeshGroup(_geometry, _vertexDeclaration, _batchType, _meshIndex, _areaIndex, _areaCount, _effect, _effectHash, _perObjectDataHandle, _sphereHandle, _instances, _instanceCount, _pickingOwner, _pickingOwnerIndex) {
-    throw new Error("CjsInstancedMeshManager.AddMeshGroup must be implemented by an engine.");
-  }
-
-  /** Updates the world bounds and flags of a registered sphere group. */
-  SetSphereGroupBounds(_handle, _bounds, _flags) {
-    throw new Error("CjsInstancedMeshManager.SetSphereGroupBounds must be implemented by an engine.");
-  }
-
-  /** Removes one registered instanced geometry area. */
-  RemoveMeshGroup(_handle) {
-    throw new Error("CjsInstancedMeshManager.RemoveMeshGroup must be implemented by an engine.");
-  }
-
-  /** Removes one registered instance culling-sphere group. */
-  RemoveBoundingSphereGroup(_handle) {
-    throw new Error("CjsInstancedMeshManager.RemoveBoundingSphereGroup must be implemented by an engine.");
-  }
-
-  /** Removes one registered per-object data provider. */
-  RemovePerObjectData(_handle) {
-    throw new Error("CjsInstancedMeshManager.RemovePerObjectData must be implemented by an engine.");
-  }
-}
-for (const method of ["AddPerObjectData", "AddBoundingSphereGroup", "AddMeshGroup", "SetSphereGroupBounds", "RemoveMeshGroup", "RemoveBoundingSphereGroup", "RemovePerObjectData"]) {
-  CjsSchema.decorateMethod(CjsInstancedMeshManager, method, impl.abstract);
-}
-CjsSchema.define(CjsInstancedMeshManager, {
-  className: "CjsInstancedMeshManager"
-});
-
-export { CjsInstancedMeshManager };
-//# sourceMappingURL=CjsInstancedMeshManager.js.map

package/dist/global/contracts/CjsInstancedMeshManager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CjsInstancedMeshManager.js","sources":["../../../../src/global/contracts/CjsInstancedMeshManager.js"],"sourcesContent":["import { CjsSchema, impl } from \"../schema/index.js\";\n\n\n/**\n * Dependency-free contract implemented by an engine's instanced-mesh\n * realization. Trinity owns the registration data; the engine owns its GPU\n * buffers, culling allocations and draw submission.\n */\nexport class CjsInstancedMeshManager\n{\n  /** Registers one terminal per-object RawData record and returns an opaque handle. */\n  AddPerObjectData(_data)\n  {\n    throw new Error(\"CjsInstancedMeshManager.AddPerObjectData must be implemented by an engine.\");\n  }\n\n  /** Registers one set of instance culling spheres and returns an opaque handle. */\n  AddBoundingSphereGroup(_bounds, _flags, _spheres, _count)\n  {\n    throw new Error(\"CjsInstancedMeshManager.AddBoundingSphereGroup must be implemented by an engine.\");\n  }\n\n  /**\n   * Registers one instanced geometry area and returns an opaque handle.\n   * The arguments are the geometry, vertex declaration, batch type, mesh\n   * index, area index/count, effect/hash, per-object handle, sphere handle,\n   * instance records/count, picking owner and picking-owner index.\n   */\n  AddMeshGroup(\n    _geometry,\n    _vertexDeclaration,\n    _batchType,\n    _meshIndex,\n    _areaIndex,\n    _areaCount,\n    _effect,\n    _effectHash,\n    _perObjectDataHandle,\n    _sphereHandle,\n    _instances,\n    _instanceCount,\n    _pickingOwner,\n    _pickingOwnerIndex)\n  {\n    throw new Error(\"CjsInstancedMeshManager.AddMeshGroup must be implemented by an engine.\");\n  }\n\n  /** Updates the world bounds and flags of a registered sphere group. */\n  SetSphereGroupBounds(_handle, _bounds, _flags)\n  {\n    throw new Error(\"CjsInstancedMeshManager.SetSphereGroupBounds must be implemented by an engine.\");\n  }\n\n  /** Removes one registered instanced geometry area. */\n  RemoveMeshGroup(_handle)\n  {\n    throw new Error(\"CjsInstancedMeshManager.RemoveMeshGroup must be implemented by an engine.\");\n  }\n\n  /** Removes one registered instance culling-sphere group. */\n  RemoveBoundingSphereGroup(_handle)\n  {\n    throw new Error(\"CjsInstancedMeshManager.RemoveBoundingSphereGroup must be implemented by an engine.\");\n  }\n\n  /** Removes one registered per-object data provider. */\n  RemovePerObjectData(_handle)\n  {\n    throw new Error(\"CjsInstancedMeshManager.RemovePerObjectData must be implemented by an engine.\");\n  }\n}\n\nfor (const method of [\n  \"AddPerObjectData\",\n  \"AddBoundingSphereGroup\",\n  \"AddMeshGroup\",\n  \"SetSphereGroupBounds\",\n  \"RemoveMeshGroup\",\n  \"RemoveBoundingSphereGroup\",\n  \"RemovePerObjectData\"\n])\n{\n  CjsSchema.decorateMethod(CjsInstancedMeshManager, method, impl.abstract);\n}\nCjsSchema.define(CjsInstancedMeshManager, { className: \"CjsInstancedMeshManager\" });\n"],"names":["CjsInstancedMeshManager","AddPerObjectData","_data","Error","AddBoundingSphereGroup","_bounds","_flags","_spheres","_count","AddMeshGroup","_geometry","_vertexDeclaration","_batchType","_meshIndex","_areaIndex","_areaCount","_effect","_effectHash","_perObjectDataHandle","_sphereHandle","_instances","_instanceCount","_pickingOwner","_pickingOwnerIndex","SetSphereGroupBounds","_handle","RemoveMeshGroup","RemoveBoundingSphereGroup","RemovePerObjectData","method","CjsSchema","decorateMethod","impl","abstract","define","className"],"mappings":";;;AAGA;AACA;AACA;AACA;AACA;AACO,MAAMA,uBAAuB,CACpC;AACE;EACAC,gBAAgBA,CAACC,KAAK,EACtB;AACE,IAAA,MAAM,IAAIC,KAAK,CAAC,4EAA4E,CAAC;AAC/F,EAAA;;AAEA;EACAC,sBAAsBA,CAACC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,MAAM,EACxD;AACE,IAAA,MAAM,IAAIL,KAAK,CAAC,kFAAkF,CAAC;AACrG,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACEM,EAAAA,YAAYA,CACVC,SAAS,EACTC,kBAAkB,EAClBC,UAAU,EACVC,UAAU,EACVC,UAAU,EACVC,UAAU,EACVC,OAAO,EACPC,WAAW,EACXC,oBAAoB,EACpBC,aAAa,EACbC,UAAU,EACVC,cAAc,EACdC,aAAa,EACbC,kBAAkB,EACpB;AACE,IAAA,MAAM,IAAIpB,KAAK,CAAC,wEAAwE,CAAC;AAC3F,EAAA;;AAEA;AACAqB,EAAAA,oBAAoBA,CAACC,OAAO,EAAEpB,OAAO,EAAEC,MAAM,EAC7C;AACE,IAAA,MAAM,IAAIH,KAAK,CAAC,gFAAgF,CAAC;AACnG,EAAA;;AAEA;EACAuB,eAAeA,CAACD,OAAO,EACvB;AACE,IAAA,MAAM,IAAItB,KAAK,CAAC,2EAA2E,CAAC;AAC9F,EAAA;;AAEA;EACAwB,yBAAyBA,CAACF,OAAO,EACjC;AACE,IAAA,MAAM,IAAItB,KAAK,CAAC,qFAAqF,CAAC;AACxG,EAAA;;AAEA;EACAyB,mBAAmBA,CAACH,OAAO,EAC3B;AACE,IAAA,MAAM,IAAItB,KAAK,CAAC,+EAA+E,CAAC;AAClG,EAAA;AACF;AAEA,KAAK,MAAM0B,MAAM,IAAI,CACnB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,qBAAqB,CACtB,EACD;EACEC,SAAS,CAACC,cAAc,CAAC/B,uBAAuB,EAAE6B,MAAM,EAAEG,IAAI,CAACC,QAAQ,CAAC;AAC1E;AACAH,SAAS,CAACI,MAAM,CAAClC,uBAAuB,EAAE;AAAEmC,EAAAA,SAAS,EAAE;AAA0B,CAAC,CAAC;;;;"}