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

package/dist/resource/formats/fsd/64/readers/CjsFsd64SchemaFrontierGraphicIds.js

@@ -0,0 +1,94 @@
+import { CjsFsd64SchemaDecoder } from '../core/CjsFsd64SchemaDecoder.js';
+import { CjsFsd64SchemaReader } from '../core/CjsFsd64SchemaReader.js';
+
+/**
+ * Reads caller-supplied graphic identifier bytes **as EVE Frontier stores them**.
+ *
+ * The record is 168 bytes against Tranquility's 160, and every field this schema
+ * claims sits eight bytes later than its counterpart in
+ * `CjsFsd64SchemaGraphicIds`. The two are separate pinned layouts rather than
+ * versions of one, so a caller picks the one its target ships.
+ *
+ * The one structural difference is that **Frontier's record carries a presence
+ * word, at 164, and Tranquility's does not**. Where the EVE container leaves an
+ * absent string empty, this one also clears a bit, and each bit below was solved
+ * by requiring it to be set on exactly the records whose string is non-empty -
+ * an exact match on every one of the 3,267 records, not an implication.
+ *
+ * Derived against build 3512930, from `app:/bin64/graphicIDsLoader.pyd`'s field
+ * list, with the SOF names checked against what the target's own space object
+ * factory data names. Counts: `graphicFile` on 1,950 records, `iconFolder` 313,
+ * `sofFactionName` 1,775, `sofHullName` 1,157, `sofLayout` 1,270 and
+ * `sofRaceName` 1,916.
+ *
+ * The record carries further fields this schema does not claim - the colour
+ * vectors in the four-byte float slots from 104, and the animation and explosion
+ * identifiers. Two are measurable but unidentified: a data pointer at 24, whose
+ * 948 strings are SOF-shaped names that overlap `sofHullName`'s vocabulary, and
+ * pointers at 8 and 32 that are non-zero on every record. `sofMaterialSetID` is
+ * **not claimed**: the only candidate slot holds one non-zero value across the
+ * file and it is not a key in Frontier's two-record material set table, so
+ * nothing proves the offset.
+ */
+class CjsFsd64SchemaFrontierGraphicIds extends CjsFsd64SchemaReader {
+  static getFsdSchema = CjsFsd64SchemaReader.bindFsdSchema(CjsFsd64SchemaDecoder.defineSchema({
+    "schema": "carbonenginejs.fsdBinarySchema",
+    "name": "graphicIDs",
+    "schemaVersion": 1,
+    "path": "res:/staticdata/graphicids.fsdbinary",
+    "schemaID": "2bdea664c47b290277ceb9741651e981",
+    "container": {
+      "type": "MAP",
+      "recordSize": 168,
+      "key": {
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 0
+      },
+      "presence": {
+        "type": "UINT_32",
+        "offset": 164,
+        "allowedMask": 32767
+      },
+      "fields": [{
+        "name": "graphicFile",
+        "type": "STRING",
+        "offset": 48,
+        "presenceMask": 128
+      }, {
+        "name": "iconFolder",
+        "type": "STRING",
+        "offset": 56,
+        "presenceMask": 512
+      }, {
+        "name": "sofFactionName",
+        "type": "STRING",
+        "offset": 72,
+        "presenceMask": 1024
+      }, {
+        "name": "sofHullName",
+        "type": "STRING",
+        "offset": 80,
+        "presenceMask": 2048
+      }, {
+        "name": "sofLayout",
+        "type": "LIST",
+        "offset": 88,
+        "itemSize": 8,
+        "maximumCount": 256,
+        "presenceMask": 4096,
+        "item": {
+          "type": "STRING",
+          "offset": 0
+        }
+      }, {
+        "name": "sofRaceName",
+        "type": "STRING",
+        "offset": 96,
+        "presenceMask": 16384
+      }]
+    }
+  }));
+}
+
+export { CjsFsd64SchemaFrontierGraphicIds };
+//# sourceMappingURL=CjsFsd64SchemaFrontierGraphicIds.js.map

package/dist/resource/formats/fsd/64/readers/CjsFsd64SchemaFrontierGraphicIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsFsd64SchemaFrontierGraphicIds.js","sources":["../../../../../../../src/resource/formats/fsd/64/readers/CjsFsd64SchemaFrontierGraphicIds.js"],"sourcesContent":["import { CjsFsd64SchemaDecoder } from \"../core/CjsFsd64SchemaDecoder.js\";\nimport { CjsFsd64SchemaReader } from \"../core/CjsFsd64SchemaReader.js\";\n\n\n/**\n * Reads caller-supplied graphic identifier bytes **as EVE Frontier stores them**.\n *\n * The record is 168 bytes against Tranquility's 160, and every field this schema\n * claims sits eight bytes later than its counterpart in\n * `CjsFsd64SchemaGraphicIds`. The two are separate pinned layouts rather than\n * versions of one, so a caller picks the one its target ships.\n *\n * The one structural difference is that **Frontier's record carries a presence\n * word, at 164, and Tranquility's does not**. Where the EVE container leaves an\n * absent string empty, this one also clears a bit, and each bit below was solved\n * by requiring it to be set on exactly the records whose string is non-empty -\n * an exact match on every one of the 3,267 records, not an implication.\n *\n * Derived against build 3512930, from `app:/bin64/graphicIDsLoader.pyd`'s field\n * list, with the SOF names checked against what the target's own space object\n * factory data names. Counts: `graphicFile` on 1,950 records, `iconFolder` 313,\n * `sofFactionName` 1,775, `sofHullName` 1,157, `sofLayout` 1,270 and\n * `sofRaceName` 1,916.\n *\n * The record carries further fields this schema does not claim - the colour\n * vectors in the four-byte float slots from 104, and the animation and explosion\n * identifiers. Two are measurable but unidentified: a data pointer at 24, whose\n * 948 strings are SOF-shaped names that overlap `sofHullName`'s vocabulary, and\n * pointers at 8 and 32 that are non-zero on every record. `sofMaterialSetID` is\n * **not claimed**: the only candidate slot holds one non-zero value across the\n * file and it is not a key in Frontier's two-record material set table, so\n * nothing proves the offset.\n */\nexport class CjsFsd64SchemaFrontierGraphicIds extends CjsFsd64SchemaReader\n{\n    static getFsdSchema = CjsFsd64SchemaReader.bindFsdSchema(CjsFsd64SchemaDecoder.defineSchema({\n        \"schema\": \"carbonenginejs.fsdBinarySchema\",\n        \"name\": \"graphicIDs\",\n        \"schemaVersion\": 1,\n        \"path\": \"res:/staticdata/graphicids.fsdbinary\",\n        \"schemaID\": \"2bdea664c47b290277ceb9741651e981\",\n        \"container\": {\n            \"type\": \"MAP\",\n            \"recordSize\": 168,\n            \"key\": {\n                \"type\": \"UINT_32_IDENTIFIER\",\n                \"offset\": 0\n            },\n            \"presence\": {\n                \"type\": \"UINT_32\",\n                \"offset\": 164,\n                \"allowedMask\": 32767\n            },\n            \"fields\": [\n                {\n                    \"name\": \"graphicFile\",\n                    \"type\": \"STRING\",\n                    \"offset\": 48,\n                    \"presenceMask\": 128\n                },\n                {\n                    \"name\": \"iconFolder\",\n                    \"type\": \"STRING\",\n                    \"offset\": 56,\n                    \"presenceMask\": 512\n                },\n                {\n                    \"name\": \"sofFactionName\",\n                    \"type\": \"STRING\",\n                    \"offset\": 72,\n                    \"presenceMask\": 1024\n                },\n                {\n                    \"name\": \"sofHullName\",\n                    \"type\": \"STRING\",\n                    \"offset\": 80,\n                    \"presenceMask\": 2048\n                },\n                {\n                    \"name\": \"sofLayout\",\n                    \"type\": \"LIST\",\n                    \"offset\": 88,\n                    \"itemSize\": 8,\n                    \"maximumCount\": 256,\n                    \"presenceMask\": 4096,\n                    \"item\": {\n                        \"type\": \"STRING\",\n                        \"offset\": 0\n                    }\n                },\n                {\n                    \"name\": \"sofRaceName\",\n                    \"type\": \"STRING\",\n                    \"offset\": 96,\n                    \"presenceMask\": 16384\n                }\n            ]\n        }\n    }));\n\n}\n\nexport default new CjsFsd64SchemaFrontierGraphicIds();\n"],"names":["CjsFsd64SchemaFrontierGraphicIds","CjsFsd64SchemaReader","getFsdSchema","bindFsdSchema","CjsFsd64SchemaDecoder","defineSchema"],"mappings":";;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,gCAAgC,SAASC,oBAAoB,CAC1E;EACI,OAAOC,YAAY,GAAGD,oBAAoB,CAACE,aAAa,CAACC,qBAAqB,CAACC,YAAY,CAAC;AACxF,IAAA,QAAQ,EAAE,gCAAgC;AAC1C,IAAA,MAAM,EAAE,YAAY;AACpB,IAAA,eAAe,EAAE,CAAC;AAClB,IAAA,MAAM,EAAE,sCAAsC;AAC9C,IAAA,UAAU,EAAE,kCAAkC;AAC9C,IAAA,WAAW,EAAE;AACT,MAAA,MAAM,EAAE,KAAK;AACb,MAAA,YAAY,EAAE,GAAG;AACjB,MAAA,KAAK,EAAE;AACH,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE;OACb;AACD,MAAA,UAAU,EAAE;AACR,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,aAAa,EAAE;OAClB;AACD,MAAA,QAAQ,EAAE,CACN;AACI,QAAA,MAAM,EAAE,aAAa;AACrB,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,YAAY;AACpB,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,gBAAgB;AACxB,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,aAAa;AACrB,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,WAAW;AACnB,QAAA,MAAM,EAAE,MAAM;AACd,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,UAAU,EAAE,CAAC;AACb,QAAA,cAAc,EAAE,GAAG;AACnB,QAAA,cAAc,EAAE,IAAI;AACpB,QAAA,MAAM,EAAE;AACJ,UAAA,MAAM,EAAE,QAAQ;AAChB,UAAA,QAAQ,EAAE;AACd;AACJ,OAAC,EACD;AACI,QAAA,MAAM,EAAE,aAAa;AACrB,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;OACnB;AAET;AACJ,GAAC,CAAC,CAAC;AAEP;;;;"}

package/dist/resource/formats/fsd/64/readers/CjsFsd64SchemaFrontierTypes.js

@@ -0,0 +1,189 @@
+import { CjsFsd64SchemaDecoder } from '../core/CjsFsd64SchemaDecoder.js';
+import { CjsFsd64SchemaReader } from '../core/CjsFsd64SchemaReader.js';
+
+/**
+ * Reads caller-supplied `types.fsdbinary` bytes **as EVE Frontier stores them**.
+ *
+ * Frontier is a different game on the same engine, and its type record is a
+ * different layout: 136 bytes against Tranquility's 152, with a presence word at
+ * 132 rather than 148. It is not a version of the other schema, so it is not a
+ * variant of `CjsFsd64SchemaTypes` - the two are separate pinned layouts, and a
+ * caller picks the one its target ships.
+ *
+ * What the two records disagree about is the game, not the format. Frontier
+ * carries `tags` and drops `manufacturers`, `shipTreeGroupID`, `soundID` and the
+ * show-info quote pair; it also stores `typeID` a second time inside the record,
+ * where it equals the map key on all 32,627 records.
+ *
+ * **`name` and `description` are not in this file.** The record carries the
+ * localisation label identifiers, and the strings live in
+ * `res:/localizationfsd/localization_fsd_<language>.pickle` - which Frontier
+ * ships as pickle protocol 4, not protocol 0. The label field is declared here
+ * as `nameID`, matching the shape the official EVE export publishes and the
+ * spelling `CjsFsd64SchemaTypes` uses; Frontier's own loader calls it
+ * `typeNameID`.
+ *
+ * Derived against build 3512930, from `app:/bin64/typesLoader.pyd`'s field list
+ * and referential integrity against the containers each identifier points into.
+ * Every claim below is a measurement on all 32,627 records:
+ *
+ * - The stride is the only one in 128-152 that yields unique keys.
+ * - `groupID` resolves into `groups` on 32,623 of 32,623 non-zero records,
+ *   `graphicID` into `graphicids` on 12,636 of 12,636, `iconID` into `iconids`
+ *   on 9,984 of 9,984, `marketGroupID` into `marketgroups` on 9,693 of 9,693,
+ *   `metaGroupID` into `metagroups` on 4,149 of 4,149, and `descriptionID` and
+ *   `nameID` into the localisation table on 20,642 of 20,642 and 32,627 of
+ *   32,627.
+ * - `variationParentTypeID` and `wreckTypeID` resolve into this same file.
+ * - Each presence bit below is the smallest bit set on **every** record whose
+ *   field is non-zero. `iconID` (bit 5) is set on 9,998 records against 9,984
+ *   non-zero values and `metaLevel` (bit 10) on 1,941 against 1,110: those
+ *   fields are present holding zero, which is a real value, not an absence.
+ *
+ * `raceID` is a **bit mask here, not a single race**: its values are the powers
+ * of two the race table keys, plus the combinations 134 and 135. It is declared
+ * `UINT_32` for that reason, where `CjsFsd64SchemaTypes` declares an identifier.
+ *
+ * Two four-byte slots at 72 and 100 carry data this schema does not claim; one
+ * record sets each. Presence bits 6 (7,156 records) and 16 (912) are likewise
+ * informative and unassigned, which is where the loader's remaining fields -
+ * `platforms` among them - will be.
+ */
+class CjsFsd64SchemaFrontierTypes extends CjsFsd64SchemaReader {
+  static getFsdSchema = CjsFsd64SchemaReader.bindFsdSchema(CjsFsd64SchemaDecoder.defineSchema({
+    "schema": "carbonenginejs.fsdBinarySchema",
+    "name": "types",
+    "schemaVersion": 1,
+    "path": "res:/staticdata/types.fsdbinary",
+    "schemaID": "639467dd23791c31777b3f4ff31f6bad",
+    "container": {
+      "type": "MAP",
+      "recordSize": 136,
+      "key": {
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 0
+      },
+      "presence": {
+        "type": "UINT_32",
+        "offset": 132,
+        "allowedMask": 2097151
+      },
+      "fields": [{
+        "name": "basePrice",
+        "type": "FLOAT_64",
+        "offset": 8
+      }, {
+        "name": "capacity",
+        "type": "FLOAT_64",
+        "offset": 16
+      }, {
+        "name": "mass",
+        "type": "FLOAT_64",
+        "offset": 24
+      }, {
+        "name": "portionSize",
+        "type": "UINT_32",
+        "offset": 32
+      }, {
+        "name": "radius",
+        "type": "FLOAT_64",
+        "offset": 40
+      }, {
+        "name": "tags",
+        "type": "LIST",
+        "offset": 48,
+        "itemSize": 4,
+        "item": {
+          "type": "UINT_32_IDENTIFIER",
+          "offset": 0
+        }
+      }, {
+        "name": "volume",
+        "type": "FLOAT_64",
+        "offset": 56
+      }, {
+        "name": "descriptionID",
+        "type": "UINT_32",
+        "offset": 64,
+        "presenceMask": 4
+      }, {
+        "name": "factionID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 68,
+        "presenceMask": 8
+      }, {
+        "name": "graphicID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 76,
+        "presenceMask": 16
+      }, {
+        "name": "groupID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 80
+      }, {
+        "name": "iconID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 84,
+        "presenceMask": 32
+      }, {
+        "name": "marketGroupID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 88,
+        "presenceMask": 128
+      }, {
+        "name": "metaGroupID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 92,
+        "presenceMask": 512
+      }, {
+        "name": "metaLevel",
+        "type": "UINT_32",
+        "offset": 96,
+        "presenceMask": 1024
+      }, {
+        "name": "raceID",
+        "type": "UINT_32",
+        "offset": 104,
+        "presenceMask": 16384
+      }, {
+        "name": "techLevel",
+        "type": "UINT_32",
+        "offset": 108,
+        "presenceMask": 131072
+      }, {
+        "name": "typeID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 112
+      }, {
+        "name": "nameID",
+        "type": "UINT_32",
+        "sourceName": "typeNameID",
+        "renamed": true,
+        "offset": 116
+      }, {
+        "name": "variationParentTypeID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 120,
+        "presenceMask": 262144
+      }, {
+        "name": "wreckTypeID",
+        "type": "UINT_32_IDENTIFIER",
+        "offset": 124,
+        "presenceMask": 1048576
+      }, {
+        "name": "isDynamicType",
+        "type": "BOOLEAN",
+        "offset": 128,
+        "bit": 0
+      }, {
+        "name": "published",
+        "type": "BOOLEAN",
+        "offset": 129,
+        "bit": 0
+      }]
+    }
+  }));
+}
+
+export { CjsFsd64SchemaFrontierTypes };
+//# sourceMappingURL=CjsFsd64SchemaFrontierTypes.js.map

package/dist/resource/formats/fsd/64/readers/CjsFsd64SchemaFrontierTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsFsd64SchemaFrontierTypes.js","sources":["../../../../../../../src/resource/formats/fsd/64/readers/CjsFsd64SchemaFrontierTypes.js"],"sourcesContent":["import { CjsFsd64SchemaDecoder } from \"../core/CjsFsd64SchemaDecoder.js\";\nimport { CjsFsd64SchemaReader } from \"../core/CjsFsd64SchemaReader.js\";\n\n\n/**\n * Reads caller-supplied `types.fsdbinary` bytes **as EVE Frontier stores them**.\n *\n * Frontier is a different game on the same engine, and its type record is a\n * different layout: 136 bytes against Tranquility's 152, with a presence word at\n * 132 rather than 148. It is not a version of the other schema, so it is not a\n * variant of `CjsFsd64SchemaTypes` - the two are separate pinned layouts, and a\n * caller picks the one its target ships.\n *\n * What the two records disagree about is the game, not the format. Frontier\n * carries `tags` and drops `manufacturers`, `shipTreeGroupID`, `soundID` and the\n * show-info quote pair; it also stores `typeID` a second time inside the record,\n * where it equals the map key on all 32,627 records.\n *\n * **`name` and `description` are not in this file.** The record carries the\n * localisation label identifiers, and the strings live in\n * `res:/localizationfsd/localization_fsd_<language>.pickle` - which Frontier\n * ships as pickle protocol 4, not protocol 0. The label field is declared here\n * as `nameID`, matching the shape the official EVE export publishes and the\n * spelling `CjsFsd64SchemaTypes` uses; Frontier's own loader calls it\n * `typeNameID`.\n *\n * Derived against build 3512930, from `app:/bin64/typesLoader.pyd`'s field list\n * and referential integrity against the containers each identifier points into.\n * Every claim below is a measurement on all 32,627 records:\n *\n * - The stride is the only one in 128-152 that yields unique keys.\n * - `groupID` resolves into `groups` on 32,623 of 32,623 non-zero records,\n *   `graphicID` into `graphicids` on 12,636 of 12,636, `iconID` into `iconids`\n *   on 9,984 of 9,984, `marketGroupID` into `marketgroups` on 9,693 of 9,693,\n *   `metaGroupID` into `metagroups` on 4,149 of 4,149, and `descriptionID` and\n *   `nameID` into the localisation table on 20,642 of 20,642 and 32,627 of\n *   32,627.\n * - `variationParentTypeID` and `wreckTypeID` resolve into this same file.\n * - Each presence bit below is the smallest bit set on **every** record whose\n *   field is non-zero. `iconID` (bit 5) is set on 9,998 records against 9,984\n *   non-zero values and `metaLevel` (bit 10) on 1,941 against 1,110: those\n *   fields are present holding zero, which is a real value, not an absence.\n *\n * `raceID` is a **bit mask here, not a single race**: its values are the powers\n * of two the race table keys, plus the combinations 134 and 135. It is declared\n * `UINT_32` for that reason, where `CjsFsd64SchemaTypes` declares an identifier.\n *\n * Two four-byte slots at 72 and 100 carry data this schema does not claim; one\n * record sets each. Presence bits 6 (7,156 records) and 16 (912) are likewise\n * informative and unassigned, which is where the loader's remaining fields -\n * `platforms` among them - will be.\n */\nexport class CjsFsd64SchemaFrontierTypes extends CjsFsd64SchemaReader\n{\n    static getFsdSchema = CjsFsd64SchemaReader.bindFsdSchema(CjsFsd64SchemaDecoder.defineSchema({\n        \"schema\": \"carbonenginejs.fsdBinarySchema\",\n        \"name\": \"types\",\n        \"schemaVersion\": 1,\n        \"path\": \"res:/staticdata/types.fsdbinary\",\n        \"schemaID\": \"639467dd23791c31777b3f4ff31f6bad\",\n        \"container\": {\n            \"type\": \"MAP\",\n            \"recordSize\": 136,\n            \"key\": {\n                \"type\": \"UINT_32_IDENTIFIER\",\n                \"offset\": 0\n            },\n            \"presence\": {\n                \"type\": \"UINT_32\",\n                \"offset\": 132,\n                \"allowedMask\": 2097151\n            },\n            \"fields\": [\n                {\n                    \"name\": \"basePrice\",\n                    \"type\": \"FLOAT_64\",\n                    \"offset\": 8\n                },\n                {\n                    \"name\": \"capacity\",\n                    \"type\": \"FLOAT_64\",\n                    \"offset\": 16\n                },\n                {\n                    \"name\": \"mass\",\n                    \"type\": \"FLOAT_64\",\n                    \"offset\": 24\n                },\n                {\n                    \"name\": \"portionSize\",\n                    \"type\": \"UINT_32\",\n                    \"offset\": 32\n                },\n                {\n                    \"name\": \"radius\",\n                    \"type\": \"FLOAT_64\",\n                    \"offset\": 40\n                },\n                {\n                    \"name\": \"tags\",\n                    \"type\": \"LIST\",\n                    \"offset\": 48,\n                    \"itemSize\": 4,\n                    \"item\": {\n                        \"type\": \"UINT_32_IDENTIFIER\",\n                        \"offset\": 0\n                    }\n                },\n                {\n                    \"name\": \"volume\",\n                    \"type\": \"FLOAT_64\",\n                    \"offset\": 56\n                },\n                {\n                    \"name\": \"descriptionID\",\n                    \"type\": \"UINT_32\",\n                    \"offset\": 64,\n                    \"presenceMask\": 4\n                },\n                {\n                    \"name\": \"factionID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 68,\n                    \"presenceMask\": 8\n                },\n                {\n                    \"name\": \"graphicID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 76,\n                    \"presenceMask\": 16\n                },\n                {\n                    \"name\": \"groupID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 80\n                },\n                {\n                    \"name\": \"iconID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 84,\n                    \"presenceMask\": 32\n                },\n                {\n                    \"name\": \"marketGroupID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 88,\n                    \"presenceMask\": 128\n                },\n                {\n                    \"name\": \"metaGroupID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 92,\n                    \"presenceMask\": 512\n                },\n                {\n                    \"name\": \"metaLevel\",\n                    \"type\": \"UINT_32\",\n                    \"offset\": 96,\n                    \"presenceMask\": 1024\n                },\n                {\n                    \"name\": \"raceID\",\n                    \"type\": \"UINT_32\",\n                    \"offset\": 104,\n                    \"presenceMask\": 16384\n                },\n                {\n                    \"name\": \"techLevel\",\n                    \"type\": \"UINT_32\",\n                    \"offset\": 108,\n                    \"presenceMask\": 131072\n                },\n                {\n                    \"name\": \"typeID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 112\n                },\n                {\n                    \"name\": \"nameID\",\n                    \"type\": \"UINT_32\",\n                    \"sourceName\": \"typeNameID\",\n                    \"renamed\": true,\n                    \"offset\": 116\n                },\n                {\n                    \"name\": \"variationParentTypeID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 120,\n                    \"presenceMask\": 262144\n                },\n                {\n                    \"name\": \"wreckTypeID\",\n                    \"type\": \"UINT_32_IDENTIFIER\",\n                    \"offset\": 124,\n                    \"presenceMask\": 1048576\n                },\n                {\n                    \"name\": \"isDynamicType\",\n                    \"type\": \"BOOLEAN\",\n                    \"offset\": 128,\n                    \"bit\": 0\n                },\n                {\n                    \"name\": \"published\",\n                    \"type\": \"BOOLEAN\",\n                    \"offset\": 129,\n                    \"bit\": 0\n                }\n            ]\n        }\n    }));\n\n}\n\nexport default new CjsFsd64SchemaFrontierTypes();\n"],"names":["CjsFsd64SchemaFrontierTypes","CjsFsd64SchemaReader","getFsdSchema","bindFsdSchema","CjsFsd64SchemaDecoder","defineSchema"],"mappings":";;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,2BAA2B,SAASC,oBAAoB,CACrE;EACI,OAAOC,YAAY,GAAGD,oBAAoB,CAACE,aAAa,CAACC,qBAAqB,CAACC,YAAY,CAAC;AACxF,IAAA,QAAQ,EAAE,gCAAgC;AAC1C,IAAA,MAAM,EAAE,OAAO;AACf,IAAA,eAAe,EAAE,CAAC;AAClB,IAAA,MAAM,EAAE,iCAAiC;AACzC,IAAA,UAAU,EAAE,kCAAkC;AAC9C,IAAA,WAAW,EAAE;AACT,MAAA,MAAM,EAAE,KAAK;AACb,MAAA,YAAY,EAAE,GAAG;AACjB,MAAA,KAAK,EAAE;AACH,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE;OACb;AACD,MAAA,UAAU,EAAE;AACR,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,aAAa,EAAE;OAClB;AACD,MAAA,QAAQ,EAAE,CACN;AACI,QAAA,MAAM,EAAE,WAAW;AACnB,QAAA,MAAM,EAAE,UAAU;AAClB,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,UAAU;AAClB,QAAA,MAAM,EAAE,UAAU;AAClB,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,MAAM;AACd,QAAA,MAAM,EAAE,UAAU;AAClB,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,aAAa;AACrB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,MAAM,EAAE,UAAU;AAClB,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,MAAM;AACd,QAAA,MAAM,EAAE,MAAM;AACd,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,UAAU,EAAE,CAAC;AACb,QAAA,MAAM,EAAE;AACJ,UAAA,MAAM,EAAE,oBAAoB;AAC5B,UAAA,QAAQ,EAAE;AACd;AACJ,OAAC,EACD;AACI,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,MAAM,EAAE,UAAU;AAClB,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,eAAe;AACvB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,WAAW;AACnB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,WAAW;AACnB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,eAAe;AACvB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,aAAa;AACrB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,WAAW;AACnB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,EAAE;AACZ,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,WAAW;AACnB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,YAAY,EAAE,YAAY;AAC1B,QAAA,SAAS,EAAE,IAAI;AACf,QAAA,QAAQ,EAAE;AACd,OAAC,EACD;AACI,QAAA,MAAM,EAAE,uBAAuB;AAC/B,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,aAAa;AACrB,QAAA,MAAM,EAAE,oBAAoB;AAC5B,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,cAAc,EAAE;AACpB,OAAC,EACD;AACI,QAAA,MAAM,EAAE,eAAe;AACvB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,KAAK,EAAE;AACX,OAAC,EACD;AACI,QAAA,MAAM,EAAE,WAAW;AACnB,QAAA,MAAM,EAAE,SAAS;AACjB,QAAA,QAAQ,EAAE,GAAG;AACb,QAAA,KAAK,EAAE;OACV;AAET;AACJ,GAAC,CAAC,CAAC;AAEP;;;;"}

package/dist/resource/formats/fsd/64/readers/index.js

@@ -27,6 +27,8 @@ export { CjsFsd64SchemaDynamicItemAttributes } from './CjsFsd64SchemaDynamicItem
 export { CjsFsd64SchemaEpicArcs } from './CjsFsd64SchemaEpicArcs.js';
 export { CjsFsd64SchemaExpertSystems } from './CjsFsd64SchemaExpertSystems.js';
 export { CjsFsd64SchemaFactions } from './CjsFsd64SchemaFactions.js';
+export { CjsFsd64SchemaFrontierGraphicIds } from './CjsFsd64SchemaFrontierGraphicIds.js';
+export { CjsFsd64SchemaFrontierTypes } from './CjsFsd64SchemaFrontierTypes.js';
 export { CjsFsd64SchemaGraphicIds } from './CjsFsd64SchemaGraphicIds.js';
 export { CjsFsd64SchemaGraphicMaterialSets } from './CjsFsd64SchemaGraphicMaterialSets.js';
 export { CjsFsd64SchemaGroups } from './CjsFsd64SchemaGroups.js';

package/dist/resource/formats/fsd/64/readers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/resource/formats/hlsl/core/detailMapFamily.js

@@ -1,3 +1,5 @@
+import { TEXTURE_ARRAY_FAMILIES, recogniseTextureArrayFamily } from './textureArrayFamilies.js';
+
 /**
  * Recognises Carbon's Detail-map resource family from reflection alone.
  *
@@ -20,109 +22,33 @@
  * the WebGL2 sampler-unit limit of 16.
  */
 
-/** Resource names that make up the family, in layer order. */
-const DETAIL_PARAMETERS = Object.freeze(["Detail1Map", "Detail2Map", "Detail3Map"]);
 
-/** Carbon's resource type code for a 2D texture. */
-const CARBON_TEXTURE_2D = 2;
+/**
+ * The detail family's own row of the table.
+ *
+ * This module predates the table and is the documented entry point for the
+ * detail maps specifically - the contract, the WebGPU plan builder and the
+ * container's transform family all name it. It now delegates rather than
+ * carrying a second copy of the rules, because two implementations of
+ * "which registers take part" is exactly the drift the recogniser exists to
+ * prevent.
+ */
+const DETAIL_DEFINITION = TEXTURE_ARRAY_FAMILIES.find(definition => definition.family === "detail-map-array");
 
 /** The merged array's name, and the transform family it belongs to. */
-const DETAIL_MAP_ARRAY_NAME = "DetailArrayMap";
-const DETAIL_MAP_ARRAY_FAMILY = "detail-map-array";
+const DETAIL_MAP_ARRAY_NAME = DETAIL_DEFINITION.outputName;
+DETAIL_DEFINITION.family;
 
 /**
  * Recognises the detail-map family in one stage's reflected resources.
  *
- * Requires the maps to be contiguous from `Detail1Map` with no gap, in one
- * register space, at strictly ascending registers, and each an ordinary
- * single-element 2D texture declared linear. Anything else returns null: a
- * partial or unusual family is not merged, because guessing produces a shader
- * that links and samples the wrong thing.
- *
- * `isSRGB` must be present and false rather than merely not true. Carbon's
- * reader always sets it, so an absent flag means the caller is passing
- * something other than resource reflection, and the layers of one array texture
- * cannot disagree about whether sampling decodes sRGB.
- *
- * @param {Array<object>} resources Reflected resources, each carrying
- *   `registerIndex`, `name`, `type`, `isSRGB`, and optionally `registerSpace`
- *   and `arrayElements`. `parameter` is accepted in place of `name`.
+ * @param {Array<object>} resources Reflected resources.
  * @param {object} [options] Recognition options.
- * @param {number} [options.registerSpace] Default register space.
  * @returns {object|null} Frozen plan, or null when the family is absent or unusable.
  */
 function recogniseDetailMapFamily(resources, options = {}) {
-  const registerSpace = options.registerSpace ?? 0;
-  const byParameter = new Map();
-  for (const resource of resources ?? []) {
-    const value = resource?.toJSON?.() ?? resource;
-    const name = value?.name ?? value?.parameter;
-    if (typeof name !== "string" || !DETAIL_PARAMETERS.includes(name)) continue;
-
-    // A duplicate name means the reflection is not what this recogniser
-    // assumes, so it declines rather than picking one.
-    if (byParameter.has(name)) return null;
-    byParameter.set(name, {
-      registerIndex: value.registerIndex,
-      value
-    });
-  }
-  if (byParameter.size < 2) return null;
-
-  // Contiguous from Detail1Map: {1,2} and {1,2,3} merge, {1,3} does not.
-  const parameters = DETAIL_PARAMETERS.slice(0, byParameter.size);
-  if (parameters.some(parameter => !byParameter.has(parameter))) return null;
-  const layers = [];
-  for (const [layer, parameter] of parameters.entries()) {
-    const {
-      registerIndex,
-      value
-    } = byParameter.get(parameter);
-    if (!Number.isInteger(registerIndex) || registerIndex < 0 || value.type !== CARBON_TEXTURE_2D || (value.arrayElements ?? 1) !== 1 || value.isSRGB !== false) {
-      return null;
-    }
-    const space = value.registerSpace ?? registerSpace;
-
-    // One array texture occupies one binding, so the layers cannot come
-    // from different register spaces.
-    if (layer > 0 && space !== layers[layer - 1].registerSpace) return null;
-    if (layer > 0 && registerIndex <= layers[layer - 1].registerIndex) return null;
-    layers.push({
-      parameter,
-      layer,
-      registerIndex,
-      registerSpace: space
-    });
-  }
-  return {
-    family: DETAIL_MAP_ARRAY_FAMILY,
-    outputName: DETAIL_MAP_ARRAY_NAME,
-    registerSpace,
-    layerCount: layers.length,
-    layers: layers.map(entry => entry),
-    registers: layers.map(entry => entry.registerIndex)
-  };
-}
-
-/**
- * Builds the transform record the container's shared transform section stores.
- *
- * @param {object} plan Recognised family plan.
- * @param {string} layoutKey Enclosing pass key.
- * @returns {object} Transform record.
- */
-function detailMapTransformFor(plan, layoutKey) {
-  return {
-    id: `${layoutKey}:${DETAIL_MAP_ARRAY_FAMILY}:sampled-resource:${plan.registerSpace}:${plan.registers[0]}`,
-    family: DETAIL_MAP_ARRAY_FAMILY,
-    layoutKey,
-    inputs: plan.layers.map(entry => ({
-      registerSpace: entry.registerSpace,
-      registerIndex: entry.registerIndex,
-      parameter: entry.parameter
-    }))
-  };
+  return recogniseTextureArrayFamily(DETAIL_DEFINITION, resources, options);
 }
 
-export { DETAIL_MAP_ARRAY_FAMILY, DETAIL_MAP_ARRAY_NAME, detailMapTransformFor, recogniseDetailMapFamily };
+export { DETAIL_MAP_ARRAY_NAME, recogniseDetailMapFamily };
 //# sourceMappingURL=detailMapFamily.js.map

package/dist/resource/formats/hlsl/core/detailMapFamily.js.map

@@ -1 +1 @@
-{"version":3,"file":"detailMapFamily.js","sources":["../../../../../../src/resource/formats/hlsl/core/detailMapFamily.js"],"sourcesContent":["/**\n * Recognises Carbon's Detail-map resource family from reflection alone.\n *\n * Both backends merge `Detail1Map`/`Detail2Map`/`Detail3Map` into a single\n * array texture, and both need to agree exactly on *which* registers take part.\n * That decision is about the resources, not about the shading language, so it\n * lives here rather than twice in the two emitters.\n *\n * What this module does **not** do is prove the merge is safe. Recognising the\n * family is necessary but not sufficient: a backend must also confirm that every\n * use of those registers is a plain sample it can redirect at an array layer. A\n * detail map fetched by integer coordinate, or queried for its size, cannot be\n * merged, and only the code walking the shader can see that. So each backend\n * pairs this recogniser with its own use check and fails closed on anything it\n * does not understand.\n *\n * The WebGL 2 motivation is a hard limit rather than tidiness: the affected\n * shaders sit at exactly 16 textures against a 16-unit guarantee, so merging\n * three maps into one is what creates the headroom lighting needs. See\n * the WebGL2 sampler-unit limit of 16.\n */\n\n/** Resource names that make up the family, in layer order. */\nconst DETAIL_PARAMETERS = Object.freeze([ \"Detail1Map\", \"Detail2Map\", \"Detail3Map\" ]);\n\n/** Carbon's resource type code for a 2D texture. */\nconst CARBON_TEXTURE_2D = 2;\n\n/** The merged array's name, and the transform family it belongs to. */\nexport const DETAIL_MAP_ARRAY_NAME = \"DetailArrayMap\";\nexport const DETAIL_MAP_ARRAY_FAMILY = \"detail-map-array\";\n\n/**\n * Recognises the detail-map family in one stage's reflected resources.\n *\n * Requires the maps to be contiguous from `Detail1Map` with no gap, in one\n * register space, at strictly ascending registers, and each an ordinary\n * single-element 2D texture declared linear. Anything else returns null: a\n * partial or unusual family is not merged, because guessing produces a shader\n * that links and samples the wrong thing.\n *\n * `isSRGB` must be present and false rather than merely not true. Carbon's\n * reader always sets it, so an absent flag means the caller is passing\n * something other than resource reflection, and the layers of one array texture\n * cannot disagree about whether sampling decodes sRGB.\n *\n * @param {Array<object>} resources Reflected resources, each carrying\n *   `registerIndex`, `name`, `type`, `isSRGB`, and optionally `registerSpace`\n *   and `arrayElements`. `parameter` is accepted in place of `name`.\n * @param {object} [options] Recognition options.\n * @param {number} [options.registerSpace] Default register space.\n * @returns {object|null} Frozen plan, or null when the family is absent or unusable.\n */\nexport function recogniseDetailMapFamily(resources, options = {})\n{\n    const registerSpace = options.registerSpace ?? 0;\n    const byParameter = new Map();\n\n    for (const resource of resources ?? [])\n    {\n        const value = resource?.toJSON?.() ?? resource;\n        const name = value?.name ?? value?.parameter;\n        if (typeof name !== \"string\" || !DETAIL_PARAMETERS.includes(name)) continue;\n\n        // A duplicate name means the reflection is not what this recogniser\n        // assumes, so it declines rather than picking one.\n        if (byParameter.has(name)) return null;\n        byParameter.set(name, { registerIndex: value.registerIndex, value });\n    }\n\n    if (byParameter.size < 2) return null;\n\n    // Contiguous from Detail1Map: {1,2} and {1,2,3} merge, {1,3} does not.\n    const parameters = DETAIL_PARAMETERS.slice(0, byParameter.size);\n    if (parameters.some((parameter) => !byParameter.has(parameter))) return null;\n\n    const layers = [];\n    for (const [ layer, parameter ] of parameters.entries())\n    {\n        const { registerIndex, value } = byParameter.get(parameter);\n\n        if (!Number.isInteger(registerIndex) || registerIndex < 0\n            || value.type !== CARBON_TEXTURE_2D\n            || (value.arrayElements ?? 1) !== 1\n            || value.isSRGB !== false)\n        {\n            return null;\n        }\n\n        const space = value.registerSpace ?? registerSpace;\n\n        // One array texture occupies one binding, so the layers cannot come\n        // from different register spaces.\n        if (layer > 0 && space !== layers[layer - 1].registerSpace) return null;\n        if (layer > 0 && registerIndex <= layers[layer - 1].registerIndex) return null;\n\n        layers.push({ parameter, layer, registerIndex, registerSpace: space });\n    }\n\n    return {\n        family: DETAIL_MAP_ARRAY_FAMILY,\n        outputName: DETAIL_MAP_ARRAY_NAME,\n        registerSpace,\n        layerCount: layers.length,\n        layers: layers.map((entry) => entry),\n        registers: layers.map((entry) => entry.registerIndex)\n    };\n}\n\n/**\n * Builds the transform record the container's shared transform section stores.\n *\n * @param {object} plan Recognised family plan.\n * @param {string} layoutKey Enclosing pass key.\n * @returns {object} Transform record.\n */\nexport function detailMapTransformFor(plan, layoutKey)\n{\n    return {\n        id: `${layoutKey}:${DETAIL_MAP_ARRAY_FAMILY}:sampled-resource:${plan.registerSpace}:${plan.registers[0]}`,\n        family: DETAIL_MAP_ARRAY_FAMILY,\n        layoutKey,\n        inputs: plan.layers.map((entry) => ({\n            registerSpace: entry.registerSpace,\n            registerIndex: entry.registerIndex,\n            parameter: entry.parameter\n        }))\n    };\n}\n\nexport default recogniseDetailMapFamily;\n"],"names":["DETAIL_PARAMETERS","Object","freeze","CARBON_TEXTURE_2D","DETAIL_MAP_ARRAY_NAME","DETAIL_MAP_ARRAY_FAMILY","recogniseDetailMapFamily","resources","options","registerSpace","byParameter","Map","resource","value","toJSON","name","parameter","includes","has","set","registerIndex","size","parameters","slice","some","layers","layer","entries","get","Number","isInteger","type","arrayElements","isSRGB","space","push","family","outputName","layerCount","length","map","entry","registers","detailMapTransformFor","plan","layoutKey","id","inputs"],"mappings":"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"}
+{"version":3,"file":"detailMapFamily.js","sources":["../../../../../../src/resource/formats/hlsl/core/detailMapFamily.js"],"sourcesContent":["/**\n * Recognises Carbon's Detail-map resource family from reflection alone.\n *\n * Both backends merge `Detail1Map`/`Detail2Map`/`Detail3Map` into a single\n * array texture, and both need to agree exactly on *which* registers take part.\n * That decision is about the resources, not about the shading language, so it\n * lives here rather than twice in the two emitters.\n *\n * What this module does **not** do is prove the merge is safe. Recognising the\n * family is necessary but not sufficient: a backend must also confirm that every\n * use of those registers is a plain sample it can redirect at an array layer. A\n * detail map fetched by integer coordinate, or queried for its size, cannot be\n * merged, and only the code walking the shader can see that. So each backend\n * pairs this recogniser with its own use check and fails closed on anything it\n * does not understand.\n *\n * The WebGL 2 motivation is a hard limit rather than tidiness: the affected\n * shaders sit at exactly 16 textures against a 16-unit guarantee, so merging\n * three maps into one is what creates the headroom lighting needs. See\n * the WebGL2 sampler-unit limit of 16.\n */\n\nimport {\n    TEXTURE_ARRAY_FAMILIES,\n    recogniseTextureArrayFamily,\n    textureArrayTransformFor\n} from \"./textureArrayFamilies.js\";\n\n/**\n * The detail family's own row of the table.\n *\n * This module predates the table and is the documented entry point for the\n * detail maps specifically - the contract, the WebGPU plan builder and the\n * container's transform family all name it. It now delegates rather than\n * carrying a second copy of the rules, because two implementations of\n * \"which registers take part\" is exactly the drift the recogniser exists to\n * prevent.\n */\nconst DETAIL_DEFINITION = TEXTURE_ARRAY_FAMILIES\n    .find((definition) => definition.family === \"detail-map-array\");\n\n/** The merged array's name, and the transform family it belongs to. */\nexport const DETAIL_MAP_ARRAY_NAME = DETAIL_DEFINITION.outputName;\nexport const DETAIL_MAP_ARRAY_FAMILY = DETAIL_DEFINITION.family;\n\n/**\n * Recognises the detail-map family in one stage's reflected resources.\n *\n * @param {Array<object>} resources Reflected resources.\n * @param {object} [options] Recognition options.\n * @returns {object|null} Frozen plan, or null when the family is absent or unusable.\n */\nexport function recogniseDetailMapFamily(resources, options = {})\n{\n    return recogniseTextureArrayFamily(DETAIL_DEFINITION, resources, options);\n}\n\n/**\n * Builds the transform record the container's shared transform section stores.\n *\n * @param {object} plan Recognised family plan.\n * @param {string} layoutKey Enclosing pass key.\n * @returns {object} Transform record.\n */\nexport function detailMapTransformFor(plan, layoutKey)\n{\n    return textureArrayTransformFor(plan, layoutKey);\n}\n\nexport default recogniseDetailMapFamily;\n"],"names":["DETAIL_DEFINITION","TEXTURE_ARRAY_FAMILIES","find","definition","family","DETAIL_MAP_ARRAY_NAME","outputName","recogniseDetailMapFamily","resources","options","recogniseTextureArrayFamily"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,iBAAiB,GAAGC,sBAAsB,CAC3CC,IAAI,CAAEC,UAAU,IAAKA,UAAU,CAACC,MAAM,KAAK,kBAAkB,CAAC;;AAEnE;AACO,MAAMC,qBAAqB,GAAGL,iBAAiB,CAACM;AAChBN,iBAAiB,CAACI;;AAEzD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASG,wBAAwBA,CAACC,SAAS,EAAEC,OAAO,GAAG,EAAE,EAChE;AACI,EAAA,OAAOC,2BAA2B,CAACV,iBAAiB,EAAEQ,SAAS,EAAEC,OAAO,CAAC;AAC7E;;;;"}