@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/utilities/Range.js

@@ -3,6 +3,12 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_isUniform, _init_extra_isUniform, _init_centerPoint, _init_extra_centerPoint, _init_minRangePoint, _init_extra_minRangePoint, _init_maxRangePoint, _init_extra_maxRangePoint;
+
+/**
+ * A center point with a lower and an upper range point, optionally kept
+ * symmetric about the center, and clamped for display against separate slider
+ * bounds.
+ */
 let _Range;
 class Range extends CjsModel {
   static {
@@ -59,6 +65,8 @@ class Range extends CjsModel {
     }
     this.#syncRangePoints();
   }
+
+  /** Returns the point both range points are measured from. */
   GetCenterPoint() {
     return this.centerPoint;
   }
@@ -67,21 +75,41 @@ class Range extends CjsModel {
   GetMinRangePoint() {
     return this.minRangePoint;
   }
+
+  /**
+   * Returns the upper range point after Carbon's clamp, which is a min against
+   * the slider maximum, not a max (Range.cpp:68-71).
+   */
   GetMaxRangePoint() {
     return this.maxRangePoint;
   }
+
+  /**
+   * Flips symmetric mode, and when turning it on collapses both sides to the
+   * smaller of the two distances from the center.
+   */
   ToggleIsUniform() {
     this.isUniform = !this.isUniform;
     if (this.isUniform) {
       this.FixUniformity();
     }
   }
+
+  /**
+   * Sets symmetric mode, fixing up the range points immediately when enabling
+   * it.
+   */
   SetIsUniform(value) {
     this.isUniform = value;
     if (this.isUniform) {
       this.FixUniformity();
     }
   }
+
+  /**
+   * Makes the range symmetric by adopting the smaller of the two distances from
+   * the center on both sides, so uniformity narrows rather than widens.
+   */
   FixUniformity() {
     const minRangeDelta = this.centerPoint - this.#minRange;
     const maxRangeDelta = this.#maxRange - this.centerPoint;
@@ -89,23 +117,48 @@ class Range extends CjsModel {
     this.SetMinRangePoint(this.centerPoint - newDelta);
     this.SetMaxRangePoint(this.centerPoint + newDelta);
   }
+
+  /**
+   * Reports whether the two range points are being kept symmetric about the
+   * center.
+   */
   GetIsUniform() {
     return this.isUniform;
   }
+
+  /**
+   * Sets the lower slider bound the exposed range points are clamped against,
+   * and re-clamps them.
+   */
   SetSliderMin(value) {
     this.#sliderRangeMin = value;
     this.#syncRangePoints();
   }
+
+  /**
+   * Sets the upper slider bound the exposed range points are clamped against,
+   * and re-clamps them.
+   */
   SetSliderMax(value) {
     this.#sliderRangeMax = value;
     this.#syncRangePoints();
   }
+
+  /** Returns the lower slider bound used when clamping the exposed range points. */
   GetSliderMin() {
     return this.#sliderRangeMin;
   }
+
+  /** Returns the upper slider bound used when clamping the exposed range points. */
   GetSliderMax() {
     return this.#sliderRangeMax;
   }
+
+  /**
+   * Recomputes the exposed minRangePoint and maxRangePoint from the internal
+   * range and the slider bounds; Carbon derives these on read (Range.cpp:63-71)
+   * and clamps both with min, which is reproduced here rather than corrected.
+   */
   #syncRangePoints() {
     this.minRangePoint = Math.min(this.#minRange, this.#sliderRangeMin);
     this.maxRangePoint = Math.min(this.#maxRange, this.#sliderRangeMax);

package/dist/utilities/Range.js.map

@@ -1 +1 @@
-{"version":3,"file":"Range.js","sources":["../../../src/utilities/Range.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Utilities\\Range.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Utilities\\Range.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\Utilities\\Range_Blue.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n@type.define({\n  className: \"Range\",\n  family: \"utilities\"\n})\nexport class Range extends CjsModel\n{\n  @type.boolean\n  isUniform = true;\n\n  @type.float32\n  centerPoint = 0;\n\n  @type.float32\n  minRangePoint = 0;\n\n  @type.float32\n  maxRangePoint = 0;\n\n  #minRange = 0;\n\n  #maxRange = 0;\n\n  #sliderRangeMin = 0;\n\n  #sliderRangeMax = 0;\n\n  /** Moves the range while preserving both distances from its center. */\n  @carbon.method\n  @impl.implemented\n  SetCenterPoint(value)\n  {\n    const delta = value - this.centerPoint;\n    this.centerPoint = value;\n    this.#minRange += delta;\n    this.#maxRange += delta;\n    this.#syncRangePoints();\n  }\n\n  /** Configures the symmetric range and its slider bounds. */\n  @carbon.method\n  @impl.implemented\n  Setup(rangeCenterPoint, rangeDeltaFromCenter, sliderMin, sliderMax)\n  {\n    this.centerPoint = rangeCenterPoint;\n    this.#minRange = this.centerPoint - rangeDeltaFromCenter;\n    this.#maxRange = this.centerPoint + rangeDeltaFromCenter;\n    this.#sliderRangeMin = sliderMin;\n    this.#sliderRangeMax = sliderMax;\n    this.#syncRangePoints();\n  }\n\n  /** Sets the lower range point and mirrors it when uniform. */\n  @carbon.method\n  @impl.implemented\n  SetMinRangePoint(value)\n  {\n    this.#minRange = Math.min(value, this.centerPoint);\n    if (this.isUniform)\n    {\n      this.#maxRange = this.centerPoint + (this.centerPoint - this.#minRange);\n    }\n    this.#syncRangePoints();\n  }\n\n  /** Sets the upper range point and mirrors it when uniform. */\n  @carbon.method\n  @impl.implemented\n  SetMaxRangePoint(value)\n  {\n    this.#maxRange = Math.max(value, this.centerPoint);\n    if (this.isUniform)\n    {\n      this.#minRange = this.centerPoint - (this.#maxRange - this.centerPoint);\n    }\n    this.#syncRangePoints();\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetCenterPoint()\n  {\n    return this.centerPoint;\n  }\n\n  /** Preserves Carbon's exact lower-bound comparison behavior. */\n  @carbon.method\n  @impl.implemented\n  GetMinRangePoint()\n  {\n    return this.minRangePoint;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetMaxRangePoint()\n  {\n    return this.maxRangePoint;\n  }\n\n  @carbon.method\n  @impl.implemented\n  ToggleIsUniform()\n  {\n    this.isUniform = !this.isUniform;\n    if (this.isUniform)\n    {\n      this.FixUniformity();\n    }\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetIsUniform(value)\n  {\n    this.isUniform = value;\n    if (this.isUniform)\n    {\n      this.FixUniformity();\n    }\n  }\n\n  FixUniformity()\n  {\n    const minRangeDelta = this.centerPoint - this.#minRange;\n    const maxRangeDelta = this.#maxRange - this.centerPoint;\n    const newDelta = Math.min(minRangeDelta, maxRangeDelta);\n    this.SetMinRangePoint(this.centerPoint - newDelta);\n    this.SetMaxRangePoint(this.centerPoint + newDelta);\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetIsUniform()\n  {\n    return this.isUniform;\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetSliderMin(value)\n  {\n    this.#sliderRangeMin = value;\n    this.#syncRangePoints();\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetSliderMax(value)\n  {\n    this.#sliderRangeMax = value;\n    this.#syncRangePoints();\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetSliderMin()\n  {\n    return this.#sliderRangeMin;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetSliderMax()\n  {\n    return this.#sliderRangeMax;\n  }\n\n  #syncRangePoints()\n  {\n    this.minRangePoint = Math.min(this.#minRange, this.#sliderRangeMin);\n    this.maxRangePoint = Math.min(this.#maxRange, this.#sliderRangeMax);\n  }\n}\n"],"names":["_Range","Range","CjsModel","e","_init_isUniform","_init_extra_isUniform","_init_centerPoint","_init_extra_centerPoint","_init_minRangePoint","_init_extra_minRangePoint","_init_maxRangePoint","_init_extra_maxRangePoint","_initProto","c","_initClass","_applyDecs","type","define","className","family","boolean","float32","carbon","method","impl","implemented","isUniform","centerPoint","minRangePoint","maxRangePoint","SetCenterPoint","value","delta","Setup","rangeCenterPoint","rangeDeltaFromCenter","sliderMin","sliderMax","SetMinRangePoint","Math","min","SetMaxRangePoint","max","GetCenterPoint","GetMinRangePoint","GetMaxRangePoint","ToggleIsUniform","FixUniformity","SetIsUniform","minRangeDelta","maxRangeDelta","newDelta","GetIsUniform","SetSliderMin","SetSliderMax","GetSliderMin","GetSliderMax","#syncRangePoints"],"mappings":"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"}
+{"version":3,"file":"Range.js","sources":["../../../src/utilities/Range.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Utilities\\Range.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Utilities\\Range.cpp\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Utilities\\Range_Blue.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\r\n\r\n\r\n/**\r\n * A center point with a lower and an upper range point, optionally kept\r\n * symmetric about the center, and clamped for display against separate slider\r\n * bounds.\r\n */\r\n@type.define({\r\n  className: \"Range\",\r\n  family: \"utilities\"\r\n})\r\nexport class Range extends CjsModel\r\n{\r\n  @type.boolean\r\n  isUniform = true;\r\n\r\n  @type.float32\r\n  centerPoint = 0;\r\n\r\n  @type.float32\r\n  minRangePoint = 0;\r\n\r\n  @type.float32\r\n  maxRangePoint = 0;\r\n\r\n  #minRange = 0;\r\n\r\n  #maxRange = 0;\r\n\r\n  #sliderRangeMin = 0;\r\n\r\n  #sliderRangeMax = 0;\r\n\r\n  /** Moves the range while preserving both distances from its center. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetCenterPoint(value)\r\n  {\r\n    const delta = value - this.centerPoint;\r\n    this.centerPoint = value;\r\n    this.#minRange += delta;\r\n    this.#maxRange += delta;\r\n    this.#syncRangePoints();\r\n  }\r\n\r\n  /** Configures the symmetric range and its slider bounds. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Setup(rangeCenterPoint, rangeDeltaFromCenter, sliderMin, sliderMax)\r\n  {\r\n    this.centerPoint = rangeCenterPoint;\r\n    this.#minRange = this.centerPoint - rangeDeltaFromCenter;\r\n    this.#maxRange = this.centerPoint + rangeDeltaFromCenter;\r\n    this.#sliderRangeMin = sliderMin;\r\n    this.#sliderRangeMax = sliderMax;\r\n    this.#syncRangePoints();\r\n  }\r\n\r\n  /** Sets the lower range point and mirrors it when uniform. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetMinRangePoint(value)\r\n  {\r\n    this.#minRange = Math.min(value, this.centerPoint);\r\n    if (this.isUniform)\r\n    {\r\n      this.#maxRange = this.centerPoint + (this.centerPoint - this.#minRange);\r\n    }\r\n    this.#syncRangePoints();\r\n  }\r\n\r\n  /** Sets the upper range point and mirrors it when uniform. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetMaxRangePoint(value)\r\n  {\r\n    this.#maxRange = Math.max(value, this.centerPoint);\r\n    if (this.isUniform)\r\n    {\r\n      this.#minRange = this.centerPoint - (this.#maxRange - this.centerPoint);\r\n    }\r\n    this.#syncRangePoints();\r\n  }\r\n\r\n  /** Returns the point both range points are measured from. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetCenterPoint()\r\n  {\r\n    return this.centerPoint;\r\n  }\r\n\r\n  /** Preserves Carbon's exact lower-bound comparison behavior. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetMinRangePoint()\r\n  {\r\n    return this.minRangePoint;\r\n  }\r\n\r\n  /**\r\n   * Returns the upper range point after Carbon's clamp, which is a min against\r\n   * the slider maximum, not a max (Range.cpp:68-71).\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetMaxRangePoint()\r\n  {\r\n    return this.maxRangePoint;\r\n  }\r\n\r\n  /**\r\n   * Flips symmetric mode, and when turning it on collapses both sides to the\r\n   * smaller of the two distances from the center.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ToggleIsUniform()\r\n  {\r\n    this.isUniform = !this.isUniform;\r\n    if (this.isUniform)\r\n    {\r\n      this.FixUniformity();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Sets symmetric mode, fixing up the range points immediately when enabling\r\n   * it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetIsUniform(value)\r\n  {\r\n    this.isUniform = value;\r\n    if (this.isUniform)\r\n    {\r\n      this.FixUniformity();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Makes the range symmetric by adopting the smaller of the two distances from\r\n   * the center on both sides, so uniformity narrows rather than widens.\r\n   */\r\n  FixUniformity()\r\n  {\r\n    const minRangeDelta = this.centerPoint - this.#minRange;\r\n    const maxRangeDelta = this.#maxRange - this.centerPoint;\r\n    const newDelta = Math.min(minRangeDelta, maxRangeDelta);\r\n    this.SetMinRangePoint(this.centerPoint - newDelta);\r\n    this.SetMaxRangePoint(this.centerPoint + newDelta);\r\n  }\r\n\r\n  /**\r\n   * Reports whether the two range points are being kept symmetric about the\r\n   * center.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetIsUniform()\r\n  {\r\n    return this.isUniform;\r\n  }\r\n\r\n  /**\r\n   * Sets the lower slider bound the exposed range points are clamped against,\r\n   * and re-clamps them.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetSliderMin(value)\r\n  {\r\n    this.#sliderRangeMin = value;\r\n    this.#syncRangePoints();\r\n  }\r\n\r\n  /**\r\n   * Sets the upper slider bound the exposed range points are clamped against,\r\n   * and re-clamps them.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetSliderMax(value)\r\n  {\r\n    this.#sliderRangeMax = value;\r\n    this.#syncRangePoints();\r\n  }\r\n\r\n  /** Returns the lower slider bound used when clamping the exposed range points. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetSliderMin()\r\n  {\r\n    return this.#sliderRangeMin;\r\n  }\r\n\r\n  /** Returns the upper slider bound used when clamping the exposed range points. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetSliderMax()\r\n  {\r\n    return this.#sliderRangeMax;\r\n  }\r\n\r\n  /**\r\n   * Recomputes the exposed minRangePoint and maxRangePoint from the internal\r\n   * range and the slider bounds; Carbon derives these on read (Range.cpp:63-71)\r\n   * and clamps both with min, which is reproduced here rather than corrected.\r\n   */\r\n  #syncRangePoints()\r\n  {\r\n    this.minRangePoint = Math.min(this.#minRange, this.#sliderRangeMin);\r\n    this.maxRangePoint = Math.min(this.#maxRange, this.#sliderRangeMax);\r\n  }\r\n}\r\n"],"names":["_Range","Range","CjsModel","e","_init_isUniform","_init_extra_isUniform","_init_centerPoint","_init_extra_centerPoint","_init_minRangePoint","_init_extra_minRangePoint","_init_maxRangePoint","_init_extra_maxRangePoint","_initProto","c","_initClass","_applyDecs","type","define","className","family","boolean","float32","carbon","method","impl","implemented","isUniform","centerPoint","minRangePoint","maxRangePoint","SetCenterPoint","value","delta","Setup","rangeCenterPoint","rangeDeltaFromCenter","sliderMin","sliderMax","SetMinRangePoint","Math","min","SetMaxRangePoint","max","GetCenterPoint","GetMinRangePoint","GetMaxRangePoint","ToggleIsUniform","FixUniformity","SetIsUniform","minRangeDelta","maxRangeDelta","newDelta","GetIsUniform","SetSliderMin","SetSliderMax","GetSliderMin","GetSliderMax","#syncRangePoints"],"mappings":";;;;;;AAOA;AACA;AACA;AACA;AACA;AAJA,IAAAA;AAKA,MAAAC,KAAA,SAI2BC,QAAQ,CACnC;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,eAAA,EAAAC,qBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,mBAAA,EAAAC,yBAAA,EAAAC,mBAAA,EAAAC,yBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAb,MAAA,EAAAc,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,OAAO;AAClBC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCH,IAAI,EAAJA,IAAI,CAACI,OAAO,uBAGZJ,IAAI,EAAJA,IAAI,CAACK,OAAO,yBAGZL,IAAI,EAAJA,IAAI,CAACK,OAAO,2BAGZL,IAAI,EAAJA,IAAI,CAACK,OAAO,2BAYZC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,4BAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAYhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,kBAAA,CAAA,EAAA,CAAA,CAYhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,kBAAA,CAAA,EAAA,CAAA,CAYhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,gBAAA,CAAA,EAAA,CAAA,CAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,8BAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,8BAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,6BAchBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,0BA2BhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAUhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAQhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,EAAA,CAAA,CAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,cAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EA5LQvB,QAAQ,CAAA;AAAA;AAGjCwB,EAAAA,SAAS,IAAAd,UAAA,CAAA,IAAA,CAAA,EAAAR,eAAA,OAAG,IAAI,CAAA;AAGhBuB,EAAAA,WAAW,IAAAtB,qBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAG,CAAC,CAAA;AAGfsB,EAAAA,aAAa,IAAArB,uBAAA,CAAA,IAAA,CAAA,EAAAC,mBAAA,OAAG,CAAC,CAAA;AAGjBqB,EAAAA,aAAa,IAAApB,yBAAA,CAAA,IAAA,CAAA,EAAAC,mBAAA,OAAG,CAAC,CAAA;AAEjB,EAAA,SAAS,IAAAC,yBAAA,CAAA,IAAA,CAAA,EAAG,CAAC;EAEb,SAAS,GAAG,CAAC;EAEb,eAAe,GAAG,CAAC;EAEnB,eAAe,GAAG,CAAC;;AAEnB;EAGAmB,cAAcA,CAACC,KAAK,EACpB;AACE,IAAA,MAAMC,KAAK,GAAGD,KAAK,GAAG,IAAI,CAACJ,WAAW;IACtC,IAAI,CAACA,WAAW,GAAGI,KAAK;AACxB,IAAA,IAAI,CAAC,SAAS,IAAIC,KAAK;AACvB,IAAA,IAAI,CAAC,SAAS,IAAIA,KAAK;AACvB,IAAA,IAAI,CAAC,gBAAgB,EAAE;AACzB,EAAA;;AAEA;EAGAC,KAAKA,CAACC,gBAAgB,EAAEC,oBAAoB,EAAEC,SAAS,EAAEC,SAAS,EAClE;IACE,IAAI,CAACV,WAAW,GAAGO,gBAAgB;IACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAACP,WAAW,GAAGQ,oBAAoB;IACxD,IAAI,CAAC,SAAS,GAAG,IAAI,CAACR,WAAW,GAAGQ,oBAAoB;AACxD,IAAA,IAAI,CAAC,eAAe,GAAGC,SAAS;AAChC,IAAA,IAAI,CAAC,eAAe,GAAGC,SAAS;AAChC,IAAA,IAAI,CAAC,gBAAgB,EAAE;AACzB,EAAA;;AAEA;EAGAC,gBAAgBA,CAACP,KAAK,EACtB;AACE,IAAA,IAAI,CAAC,SAAS,GAAGQ,IAAI,CAACC,GAAG,CAACT,KAAK,EAAE,IAAI,CAACJ,WAAW,CAAC;IAClD,IAAI,IAAI,CAACD,SAAS,EAClB;AACE,MAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAACC,WAAW,IAAI,IAAI,CAACA,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;AACzE,IAAA;AACA,IAAA,IAAI,CAAC,gBAAgB,EAAE;AACzB,EAAA;;AAEA;EAGAc,gBAAgBA,CAACV,KAAK,EACtB;AACE,IAAA,IAAI,CAAC,SAAS,GAAGQ,IAAI,CAACG,GAAG,CAACX,KAAK,EAAE,IAAI,CAACJ,WAAW,CAAC;IAClD,IAAI,IAAI,CAACD,SAAS,EAClB;AACE,MAAA,IAAI,CAAC,SAAS,GAAG,IAAI,CAACC,WAAW,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAACA,WAAW,CAAC;AACzE,IAAA;AACA,IAAA,IAAI,CAAC,gBAAgB,EAAE;AACzB,EAAA;;AAEA;AAGAgB,EAAAA,cAAcA,GACd;IACE,OAAO,IAAI,CAAChB,WAAW;AACzB,EAAA;;AAEA;AAGAiB,EAAAA,gBAAgBA,GAChB;IACE,OAAO,IAAI,CAAChB,aAAa;AAC3B,EAAA;;AAEA;AACF;AACA;AACA;AAGEiB,EAAAA,gBAAgBA,GAChB;IACE,OAAO,IAAI,CAAChB,aAAa;AAC3B,EAAA;;AAEA;AACF;AACA;AACA;AAGEiB,EAAAA,eAAeA,GACf;AACE,IAAA,IAAI,CAACpB,SAAS,GAAG,CAAC,IAAI,CAACA,SAAS;IAChC,IAAI,IAAI,CAACA,SAAS,EAClB;MACE,IAAI,CAACqB,aAAa,EAAE;AACtB,IAAA;AACF,EAAA;;AAEA;AACF;AACA;AACA;EAGEC,YAAYA,CAACjB,KAAK,EAClB;IACE,IAAI,CAACL,SAAS,GAAGK,KAAK;IACtB,IAAI,IAAI,CAACL,SAAS,EAClB;MACE,IAAI,CAACqB,aAAa,EAAE;AACtB,IAAA;AACF,EAAA;;AAEA;AACF;AACA;AACA;AACEA,EAAAA,aAAaA,GACb;IACE,MAAME,aAAa,GAAG,IAAI,CAACtB,WAAW,GAAG,IAAI,CAAC,SAAS;IACvD,MAAMuB,aAAa,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAACvB,WAAW;IACvD,MAAMwB,QAAQ,GAAGZ,IAAI,CAACC,GAAG,CAACS,aAAa,EAAEC,aAAa,CAAC;IACvD,IAAI,CAACZ,gBAAgB,CAAC,IAAI,CAACX,WAAW,GAAGwB,QAAQ,CAAC;IAClD,IAAI,CAACV,gBAAgB,CAAC,IAAI,CAACd,WAAW,GAAGwB,QAAQ,CAAC;AACpD,EAAA;;AAEA;AACF;AACA;AACA;AAGEC,EAAAA,YAAYA,GACZ;IACE,OAAO,IAAI,CAAC1B,SAAS;AACvB,EAAA;;AAEA;AACF;AACA;AACA;EAGE2B,YAAYA,CAACtB,KAAK,EAClB;AACE,IAAA,IAAI,CAAC,eAAe,GAAGA,KAAK;AAC5B,IAAA,IAAI,CAAC,gBAAgB,EAAE;AACzB,EAAA;;AAEA;AACF;AACA;AACA;EAGEuB,YAAYA,CAACvB,KAAK,EAClB;AACE,IAAA,IAAI,CAAC,eAAe,GAAGA,KAAK;AAC5B,IAAA,IAAI,CAAC,gBAAgB,EAAE;AACzB,EAAA;;AAEA;AAGAwB,EAAAA,YAAYA,GACZ;IACE,OAAO,IAAI,CAAC,eAAe;AAC7B,EAAA;;AAEA;AAGAC,EAAAA,YAAYA,GACZ;IACE,OAAO,IAAI,CAAC,eAAe;AAC7B,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACE,gBAAgBC,GAChB;AACE,IAAA,IAAI,CAAC7B,aAAa,GAAGW,IAAI,CAACC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC;AACnE,IAAA,IAAI,CAACX,aAAa,GAAGU,IAAI,CAACC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC;AACrE,EAAA;AAAC,EAAA;IAAA1B,UAAA,EAAA;AAAA;AACH;;;;"}

package/docs/README.md

@@ -0,0 +1,88 @@
+# Runtime Trinity documentation
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime-trinity`
+Audience: Runtime authors, engine authors, integrators, and maintainers
+Summary: Explains the GPU-free Trinity graph, its public entry points, and its ownership boundaries.
+
+## Purpose
+
+`@carbonenginejs/runtime-trinity` owns serializable Carbon Trinity and Eve
+object graphs together with portable CPU-side behavior. Applications can
+hydrate, inspect, update, and collect renderer-neutral work from those graphs
+without creating a canvas, graphics context, or GPU device.
+
+The source contains generated schema intake and maintained implementations.
+Classes leave `src/generated` before their first substantive manual source
+change and move into readable source-area directories. A promoted class may
+remain explicitly incomplete while its bounded portable behavior is reviewed.
+The parity audit can expose additional inherited or interface obligations
+after promotion; current exceptions remain explicit in the
+implementation-status reference.
+
+## Use this package when
+
+Use `@carbonenginejs/runtime-trinity` when code needs to:
+
+- hydrate or serialize Trinity and Eve graph objects;
+- update curves, controllers, cameras, scene objects, or effects on the CPU;
+- collect render batches and render-job intents for an engine to realize;
+- inspect schema-decorated fields and enum choices; or
+- build a headless tool that must not depend on WebGL or WebGPU.
+
+Use an engine package when code needs device creation, shader realization,
+resource uploads, draw submission, presentation, or device-loss recovery.
+
+## Where it fits
+
+```text
+@carbonenginejs/tools-core -- reviewed source --> @carbonenginejs/runtime-trinity
+@carbonenginejs/runtime-trinity -- depends on --> runtime-utils + runtime-resource
+
+@carbonenginejs/runtime-resource -- decoded values --> application composition
+@carbonenginejs/runtime-trinity -- graph and intents --> application composition
+application composition --> @carbonenginejs/engine-webgpu or host engine
+```
+
+`@carbonenginejs/runtime-utils` provides the shared model, schema, constants,
+and math foundation. `@carbonenginejs/tools-core` is a build-time producer of
+schema and generated-class input, not a runtime dependency.
+`@carbonenginejs/runtime-resource` owns decoded geometry and texture values,
+`Tr2EffectRes`, canonical `Tr2Shader`/reflection records, portable hydration,
+permutation selection, and shader caching. Trinity owns the mutable
+`Tr2Effect`/`Tr2Material` facade, parameters, authored options, sampler
+overrides, and graph behavior. Engine packages own live backend objects and
+realize the combined renderer-neutral graph.
+
+Character GState behavior belongs to `@carbonenginejs/runtime-character`.
+Applications or `@carbonenginejs/runtime-core` compose these domains.
+
+## Start here
+
+```js
+import { EveCamera } from "@carbonenginejs/runtime-trinity/eve";
+
+const camera = new EveCamera();
+camera.translationFromParent = 100;
+camera.Update(0, 16 / 9);
+
+const view = camera.GetViewMatrix();
+```
+
+Import a focused public subpath when the consumer only needs one source
+family. The root entry aggregates the complete public runtime.
+
+## Documentation map
+
+- [Architecture and ownership boundaries](architecture.md)
+- [Current API](reference/api.md)
+- [Main semantic extraction](reference/main-semantic-extraction.md)
+- [Eve runtime behavior](concepts/eve-runtime-behavior.md)
+- [Generated-class lifecycle](concepts/generated-class-lifecycle.md)
+- [Implementation status and audits](reference/implementation-status.md)
+- [Eve runtime classes](reference/classes/eve-runtime.md)
+- [Trinity core classes](reference/classes/trinity-core.md)
+
+A complete class-purpose catalog is planned after generated classes carry
+reviewed descriptor metadata and the shared documentation checker supports the
+package's deliberate dropped-class quarantine.

package/docs/architecture.md

@@ -0,0 +1,162 @@
+# Runtime Trinity architecture
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime-trinity`
+Audience: Runtime authors, engine authors, and maintainers
+Summary: Defines Trinity graph ownership and the boundary between portable state and backend realization.
+
+## Purpose
+
+`@carbonenginejs/runtime-trinity` preserves Carbon's serializable object graph and portable
+runtime behavior while keeping graphics-device work outside the package.
+Trinity classes can therefore be registered, hydrated, inspected, updated, and
+serialized in browsers, workers, Node.js tools, and test hosts.
+
+## Composition and data flow
+
+```text
+@carbonenginejs/tools-core -- reviewed source --> @carbonenginejs/runtime-trinity
+@carbonenginejs/runtime-trinity -- depends on --> runtime-utils + runtime-resource
+
+@carbonenginejs/runtime-resource -- decoded values --> application composition
+@carbonenginejs/runtime-trinity -- graph and intents --> application composition
+application composition --> host WebGL engine
+application composition --> @carbonenginejs/engine-webgpu
+```
+
+Runtime dependencies point from `@carbonenginejs/runtime-trinity` to
+`@carbonenginejs/runtime-utils` and `@carbonenginejs/runtime-resource`.
+Schema scanning and source emission flow from `@carbonenginejs/tools-core`
+during development, but generated source never imports that Node toolchain.
+
+## Owned responsibilities
+
+The current package owns:
+
+- Carbon-compatible class identity, schema fields, enums, and graph structure;
+- CPU-side curves, controllers, cameras, transforms, behaviors, and effects;
+- renderer-neutral render batches and ordered render-job intent;
+- per-object semantic values that can be established from graph state;
+- portable lifecycle, distribution, post-process graph, and scene behavior;
+- generated schema intake and the maintained implementations promoted from it.
+
+`TriDevice`, render contexts, targets, authored shader options, effect/material
+facades, parameters, buffers, and presentation records remain Trinity graph
+classes. Canonical `Tr2EffectRes`, `Tr2Shader`, and immutable reflection records
+are resource-owned. Serialized identity never makes either package the owner of
+live backend handles.
+
+## Ownership elsewhere
+
+- `@carbonenginejs/runtime-utils` owns shared models, schema decorators, math,
+  constants, and general runtime primitives.
+- `@carbonenginejs/runtime-resource` owns resource acquisition, decoding,
+  reusable CPU resource representations, compiled-effect selection/cache, and
+  the canonical device-free `Tr2Shader` reflection graph.
+- `@carbonenginejs/runtime-character` owns character GState behavior.
+- `@carbonenginejs/tools-core` owns source scanning, schema compilation, and
+  generated-class emission.
+- WebGL and WebGPU engines own devices, contexts, uploads, bindings, pipelines,
+  draw or dispatch encoding, presentation, synchronization, and loss recovery.
+- Applications or `@carbonenginejs/runtime-core` choose and compose engines and
+  domain runtimes.
+
+## Render-job contract
+
+`TriRenderJob` and `Tr2RenderJobs` preserve ordered step execution, resumable
+in-progress cursors, nested result mapping, recurring and chained scheduling,
+and deterministic target/depth stack cleanup.
+
+`Run(realTime, simTime, executor)` receives an injected executor. A WebGL
+executor may perform work immediately while a WebGPU executor may encode pass
+boundaries, but both preserve the observable step order and yield boundary.
+Nested jobs receive the same executor identity. `TriRenderJob` and
+`TriRenderStep` expose their status and result vocabularies as class statics.
+The default `Tr2RenderContext` is a GPU-free intent and diagnostic surface.
+
+## Render-batch contract
+
+`Tr2RenderBatch`, `TriRenderBatchAccumulator`, and `TriRenderBatchMap` collect,
+sort, group, and expose neutral CPU data. Geometry references, effect keys,
+per-object values, render modes, and draw arguments describe work; they are
+not live GPU resources.
+
+`CjsBatchManager` is the current GPU-free orchestrator. It registers producer
+types, invokes injected `Realize` and `Build` hooks, collects renderables,
+finalizes accumulators, and observes shared rebuild tokens. The backend
+realizers supplied through those hooks remain engine-owned.
+
+## Per-frame and per-object data
+
+Trinity can expose per-object values proven by graph state, including world
+transforms and maintained Eve per-object records. It does not invent missing
+renderer state.
+
+The active engine supplies complete per-frame values such as previous
+matrices, shadow state, resolution, jitter, presentation policy, and other
+backend-owned semantics before serialization or upload.
+
+### Constant-data ownership
+
+Trinity owns the constant-data layout outright: field names, element counts, an
+encoding kind per field, and the byte offsets. There is ONE layout and no
+per-engine packing, because these buffers are not backend-specific — every
+backend declares them as a flat array of `vec4`, and std140's stride for an
+array of `vec4` matches tight C++ packing. A struct the catalog does not cover
+fails at registration rather than at draw time. An engine that genuinely needs
+different memory transforms it downstream.
+
+`RawDataStore` leases payloads from a per-engine arena; `RawData` is the
+write-mostly view over one slice. Values are written through the encoding
+(matrices transposed, integers bit-cast), never read back, and the arena is
+rewound rather than freed per payload. Declared defaults are re-applied on
+lease; an unwritten field otherwise retains the previous tenant's bytes, which
+preserves the source engine's own contract that a fill writes every field it
+relies on.
+
+A renderable returns whichever shape its constant data actually has:
+
+- one payload, when a single buffer is bound;
+- a `{ vs, ps }` record, when the vertex and pixel stages take DIFFERENT
+  payloads and are therefore two separate buffers;
+- `null`, when the renderable cannot produce one — no geometry, or no
+  accumulator to lease from.
+
+The record itself belongs to one of Carbon's two tiers, chosen statically by
+class rather than by a runtime branch. A TRANSIENT record is leased from the
+frame arena and dies at reset. A PERSISTENT record is a member the owner keeps
+across frames, because it fills the record during update and reads it back
+afterwards; `EveSpaceObject2` is the reference case, and `Invalidate` marks it
+for re-upload once per frame.
+
+A struct declares the stages it binds to, so one payload bound to several
+stages stays one payload rather than being duplicated per stage. The batch
+pipeline threads whichever shape it receives without inspecting it.
+
+## Post-process graph
+
+`Tr2PostProcess2` and `Tr2PostProcessAttributes` own device-free activation,
+quality gates, lookup-table ordering, volume blending, and authored effect
+records. Engines independently realize temporary textures, exposure state,
+history, compute or fragment passes, readback, and loss recovery while
+preserving observable graph order.
+
+## Constraints
+
+- Package evaluation must not create a canvas, graphics context, audio
+  context, network request, or filesystem dependency.
+- Persisted schema fields must not hold live backend handles.
+- A generated class is generator-owned schema intake. It is promoted before
+  its first substantive manual source change, even when review leaves explicit
+  implementation gaps.
+- Backend-specific behavior must be injected through a narrow capability or
+  remain with the owning engine.
+
+## Related documentation
+
+- [Package documentation](README.md)
+- [Current API](reference/api.md)
+- [Main semantic extraction](reference/main-semantic-extraction.md)
+- [Eve runtime behavior](concepts/eve-runtime-behavior.md)
+- [Generated-class lifecycle](concepts/generated-class-lifecycle.md)
+- [Implementation status and audits](reference/implementation-status.md)

package/docs/concepts/eve-runtime-behavior.md

@@ -0,0 +1,86 @@
+# Eve runtime behavior
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime-trinity/eve`
+Audience: Runtime authors, engine authors, and integrators
+Summary: Describes maintained CPU behavior for Eve combat effects, morph state, and distributions.
+
+## Purpose
+
+The maintained Eve tree implements portable object-graph behavior without
+claiming renderer, resource-loader, or character-runtime ownership. These
+contracts let engines consume faithful CPU state through explicit seams.
+
+## Turrets and missiles
+
+`EveMobile` maps authored `locator_*` transforms and optional animated bone
+transforms into `EveTurretSet` instances. Turret sets own portable state
+changes, paired turret and damage-locator selection, looping-fire checks,
+tracking fades, muzzle transforms, target updates, firing effects, and
+controller forwarding.
+
+`EveSpaceObject2` supplies damage locators, miss positions, radius,
+impact-material data, and the shield-ellipsoid collision surface consumed by
+turrets and missiles.
+
+`EveTransform`, `EveMissile`, and `EveMissileWarhead` own CPU transforms,
+launch, eject, and tracking state, fixed-seed Perlin path offsets, target
+switching, impacts, explosion callbacks, particles, visibility, and dynamic
+MIRV bounds. Per-object records expose the world transform and missile size;
+an engine packs and uploads those logical values.
+
+`EveEffectRoot2` and `EveRootTransform` own detached effect placement,
+controller and curve propagation, targetable-sphere behavior, child update and
+renderable traversal, and authored effect level of detail.
+
+Native pose realization, geometry loading, quad submission, device buffers,
+and shader upload remain outside this package. A data-only generated child
+does not gain invented rendering behavior merely because a maintained root
+traverses it.
+
+## Animation and morph state
+
+Character GState ownership belongs to
+`@carbonenginejs/runtime-character`. `Tr2GStateAnimation` and
+`Tr2GStateParameter` are not Trinity exports.
+
+The generic `Tr2GrannyAnimation` graph remains in Trinity for non-character
+skinned geometry. Its updater samples legacy scalar vector tracks and modern
+morph channels, composes layers in native lexical order, exposes a detached
+morph snapshot, and applies `GrannyBoneOffset` corrections after animation
+sampling and before world-transform composition.
+
+`Tr2GrannyStateRes` remains owned by
+`@carbonenginejs/runtime-resource`.
+
+`Tr2Mesh` owns LOD-0 indexed morph-weight state, including manual weights and
+baked flags. `EveChildMesh` rebuilds its CPU morph records during asynchronous
+updates. Exact-name animation values override mesh weights; values below
+`0.001` remain inactive; active runtime and baked records are partitioned
+before an engine uploads or evaluates them.
+
+Trinity prepares morph records but does not perform GPU deformation or baking.
+
+## Distribution contract
+
+The Eve distribution family is browser-portable CPU behavior. Locator,
+parent-locator, and volume placement generators build the initial placement
+pool. Spawn and lifetime modifiers transform those records. Burst, interval,
+controller, sphere, plane, and snake spawners drive the shared
+`IEveDistributionRulesParent` contract.
+
+Carbon's mutable `uint32_t&` placement counter is represented by one explicit
+`{ value }` object.
+
+Sphere, ellipsoid, and box volumes expose point generation and change
+callbacks without creating renderer resources. Parent-locator generation uses
+`EveSpaceObject2.GetLocatorsForSet`; volume generation uses
+`IEveVolume.GeneratePointsInVolume`. These paths do not probe alternate method
+names or infer renderer capabilities.
+
+## Related documentation
+
+- [Architecture and ownership boundaries](../architecture.md)
+- [Current API](../reference/api.md)
+- [Main semantic extraction](../reference/main-semantic-extraction.md)
+- [Implementation status and audits](../reference/implementation-status.md)

package/docs/concepts/generated-class-lifecycle.md

@@ -0,0 +1,116 @@
+# Generated-class lifecycle
+
+Status: Evolving
+Scope: `@carbonenginejs/runtime-trinity` generated and maintained classes
+Audience: Runtime authors, schema-tool authors, and maintainers
+Summary: Defines how schema intake becomes reviewed runtime-trinity source.
+
+## Purpose
+
+Generated classes establish Carbon-compatible identity, inheritance, fields,
+decorators, and exposed method obligations. They are review input rather than
+the permanent home of manually maintained runtime behavior.
+
+The lifecycle keeps generated output reproducible while giving every manually
+edited class a stable, human-readable source tree.
+
+## Current lifecycle
+
+1. `@carbonenginejs/tools-core` scans Carbon declarations and compiles the
+   reviewed schema.
+2. The class emitter produces schema-shaped JavaScript in its tooling-owned
+   output corpus.
+3. Reviewed generated source is copied into `runtime-trinity/src/generated`;
+   the runtime does not depend on the tooling workspace.
+4. Runtime work verifies portable behavior against the public source,
+   interfaces, schema, and tests.
+5. Before the first substantive manual source change, the complete class moves
+   into the maintained source area that owns its responsibility.
+6. Manual implementation and review continue in that maintained home.
+   Unresolved obligations remain explicit with `@impl.notImplemented`.
+7. The maintained barrel exports the promoted class and the generated copy is
+   removed.
+8. Generation records that a hand-maintained source exists instead of
+   recreating a competing class.
+
+Inspection, tests outside the class, and unchanged emitter output do not
+trigger promotion. Manual behavior, source-corrected defaults or fields,
+inheritance changes, decorator corrections, runtime-specific dependencies,
+and class-owned enum work do.
+
+The parity audit remains active after promotion because later schema or
+interface-contract improvements can reveal additional obligations. A promoted
+class with a newly visible gap stays in its maintained home; the gap is made
+explicit and completed there instead of recreating a generated duplicate.
+
+Examples of maintained homes include:
+
+- `src/eve/camera` for camera state;
+- `src/eve/attachment/decal` for space-object decals;
+- `src/eve/child/behaviors/lifecycle` and `tunnels` for cohesive behaviors;
+- `src/eve/effect/multiEffect` for multi-effect graphs; and
+- `src/trinityCore/binding` for dynamic and value binding classes.
+
+## Enum ownership
+
+An enum associated with one Carbon class normally becomes a named frozen
+static on that canonical owner, for example `Owner.EnumType.MEMBER`. A
+serialized integer field uses `@schema.enum("EnumType")` so inspectors and
+user interfaces resolve the class static and discover its accepted
+vocabulary.
+
+Ownerless vocabulary used only inside this package remains beside its
+maintained family. Genuinely shared cross-package vocabulary belongs in
+`@carbonenginejs/runtime-utils`, which allows runtime and graphics packages to
+share the identity without importing one another. A standalone generated enum
+file alone is not evidence that the enum should move to runtime-utils.
+
+## Generated source
+
+Generated source may include explicit `@impl.notImplemented` methods. These
+markers preserve known obligations and allow the implementation-gap audit to
+report them. Generated code must not silently invent device, resource,
+filesystem, or native behavior.
+
+Generated output is deterministic and should not be hand-edited as a
+substitute for changing its owning schema or emitter. Runtime-specific
+implementations belong in the maintained tree before the manual edit is made.
+
+Generation runs into a tooling-owned scratch corpus or another staging
+directory. Reviewed output is then copied only into generator-owned paths.
+The class emitter refuses to overwrite a differing `--out` file unless
+`--force` is supplied; `--force` must not target runtime source.
+
+The generated provenance banner is not an ownership lock. Durable protection
+comes from maintained and dropped skip sets, staging-first generation,
+duplicate-class checks, and comparison of installed generated source with
+fresh output. Newly promoted files replace the generated banner with a
+hand-maintained provenance header and exact Carbon source paths.
+
+## Dropped quarantine
+
+`src/dropped` is separate from `src/generated`. It contains deliberately
+quarantined source with a file-specific disposition and is excluded from the
+normal implementation and parity ownership surface.
+
+A dropped class is not treated as an incomplete generated class and is not a
+supported public implementation. Its disposition records why this package
+owns the identity, why it is rejected as a runtime model, its replacement, and
+the condition for revival. Dropped files are not imported, exported,
+registered, or implemented in place.
+
+## Planned class descriptors
+
+The schema emitter is planned to carry a reviewed purpose, visibility, kind,
+source path, and public export for each generated class. That metadata will
+produce deterministic class-purpose catalogs without guessing responsibility
+from a class name.
+
+The catalog becomes part of the documentation validation gate after the
+shared checker can exclude the deliberate dropped quarantine.
+
+## Related documentation
+
+- [Architecture and ownership boundaries](../architecture.md)
+- [Current API](../reference/api.md)
+- [Implementation status and audits](../reference/implementation-status.md)