@carbonenginejs/runtime-resource 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/FORMAT-PROVENANCE.md +155 -144
  2. package/LICENSE +21 -21
  3. package/NOTICE +29 -29
  4. package/README.md +11 -0
  5. package/dist/CjsMotherLode.js +1271 -1271
  6. package/dist/CjsResMan.js +3005 -3005
  7. package/dist/CjsResManQueue.js +214 -214
  8. package/dist/CjsResource.js +566 -566
  9. package/dist/CjsResourceSource.js +59 -59
  10. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  11. package/dist/format/CjsBlueReader.js +269 -269
  12. package/dist/format/CjsFormat.js +192 -192
  13. package/dist/format/CjsReader.js +18 -18
  14. package/dist/format/CjsResourceProbe.js +277 -277
  15. package/dist/format/payloadContract.js +173 -173
  16. package/dist/formats/black/CjsBlackFormat.js +278 -278
  17. package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
  18. package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
  19. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  20. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
  21. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
  22. package/dist/formats/black/core/blackConstants.js +7 -7
  23. package/dist/formats/black/core/blackDefinitions.js +10 -10
  24. package/dist/formats/black/core/blackEnums.js +6 -6
  25. package/dist/formats/black/core/blackSchema.js +3 -3
  26. package/dist/formats/black/core/blackVersion.js +22 -22
  27. package/dist/formats/black/core/helpers.js +182 -182
  28. package/dist/formats/black/core/schema.js +4 -4
  29. package/dist/formats/black/index.js +2 -2
  30. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  31. package/dist/formats/bnk/core/graph.js +140 -140
  32. package/dist/formats/bnk/core/helpers.js +409 -409
  33. package/dist/formats/bnk/core/musicNodes.js +489 -489
  34. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  35. package/dist/formats/bnk/index.js +2 -2
  36. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  37. package/dist/formats/cmf/core/binary.js +118 -118
  38. package/dist/formats/cmf/core/buffers.js +233 -233
  39. package/dist/formats/cmf/core/constants.js +47 -47
  40. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  41. package/dist/formats/cmf/core/helpers.js +287 -287
  42. package/dist/formats/cmf/core/pack.js +276 -276
  43. package/dist/formats/cmf/core/schema.js +364 -364
  44. package/dist/formats/cmf/core/shared.js +268 -268
  45. package/dist/formats/cmf/core/writer.js +517 -517
  46. package/dist/formats/cmf/index.js +2 -2
  47. package/dist/formats/dds/CjsDdsFormat.js +193 -193
  48. package/dist/formats/dds/core/bc6h.js +288 -0
  49. package/dist/formats/dds/core/bc6h.js.map +1 -0
  50. package/dist/formats/dds/core/bc7.js +251 -0
  51. package/dist/formats/dds/core/bc7.js.map +1 -0
  52. package/dist/formats/dds/core/helpers.js +815 -812
  53. package/dist/formats/dds/core/helpers.js.map +1 -1
  54. package/dist/formats/dds/index.js +2 -2
  55. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  56. package/dist/formats/fbx/core/helpers.js +3901 -3901
  57. package/dist/formats/fbx/index.js +2 -2
  58. package/dist/formats/flac/CjsFlacFormat.js +87 -87
  59. package/dist/formats/flac/core/helpers.js +295 -295
  60. package/dist/formats/flac/index.js +2 -2
  61. package/dist/formats/gif/CjsGifFormat.js +87 -87
  62. package/dist/formats/gif/core/helpers.js +360 -360
  63. package/dist/formats/gif/index.js +2 -2
  64. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  65. package/dist/formats/gltf/core/helpers.js +292 -292
  66. package/dist/formats/gltf/core/json.js +79 -79
  67. package/dist/formats/gltf/core/parser.js +666 -666
  68. package/dist/formats/gltf/core/targets.js +163 -163
  69. package/dist/formats/gltf/index.js +2 -2
  70. package/dist/formats/index.js +23 -23
  71. package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
  72. package/dist/formats/jpeg/core/helpers.js +350 -350
  73. package/dist/formats/jpeg/core/jpeg.js +377 -377
  74. package/dist/formats/jpeg/index.js +2 -2
  75. package/dist/formats/mp3/CjsMp3Format.js +192 -192
  76. package/dist/formats/mp3/core/helpers.js +338 -338
  77. package/dist/formats/mp3/index.js +2 -2
  78. package/dist/formats/mp4/CjsMp4Format.js +191 -191
  79. package/dist/formats/mp4/core/helpers.js +449 -449
  80. package/dist/formats/mp4/index.js +2 -2
  81. package/dist/formats/obj/CjsObjFormat.js +253 -253
  82. package/dist/formats/obj/core/helpers.js +573 -573
  83. package/dist/formats/obj/core/json.js +64 -64
  84. package/dist/formats/obj/core/parser.js +321 -321
  85. package/dist/formats/obj/index.js +2 -2
  86. package/dist/formats/ogg/CjsOggFormat.js +88 -88
  87. package/dist/formats/ogg/core/helpers.js +387 -387
  88. package/dist/formats/ogg/core/imdct.js +178 -178
  89. package/dist/formats/ogg/core/vorbis.js +999 -999
  90. package/dist/formats/ogg/index.js +2 -2
  91. package/dist/formats/png/CjsPngFormat.js +195 -195
  92. package/dist/formats/png/core/helpers.js +583 -583
  93. package/dist/formats/png/index.js +2 -2
  94. package/dist/formats/red/CjsRedFormat.js +261 -261
  95. package/dist/formats/red/core/CjsRedReader.js +194 -194
  96. package/dist/formats/red/core/blackDefinitions.js +3 -3
  97. package/dist/formats/red/core/helpers.js +139 -139
  98. package/dist/formats/red/core/redGraph.js +68 -68
  99. package/dist/formats/red/core/schema.js +4 -4
  100. package/dist/formats/red/index.js +2 -2
  101. package/dist/formats/stl/CjsStlFormat.js +365 -365
  102. package/dist/formats/stl/core/helpers.js +261 -261
  103. package/dist/formats/stl/core/json.js +51 -51
  104. package/dist/formats/stl/core/stl.js +629 -629
  105. package/dist/formats/stl/core/targets.js +163 -163
  106. package/dist/formats/stl/index.js +2 -2
  107. package/dist/formats/tga/CjsTgaFormat.js +192 -192
  108. package/dist/formats/tga/core/helpers.js +446 -446
  109. package/dist/formats/tga/index.js +2 -2
  110. package/dist/formats/wav/CjsWavFormat.js +192 -192
  111. package/dist/formats/wav/core/helpers.js +328 -328
  112. package/dist/formats/wav/index.js +2 -2
  113. package/dist/formats/webm/CjsWebmFormat.js +191 -191
  114. package/dist/formats/webm/core/helpers.js +537 -537
  115. package/dist/formats/webm/index.js +2 -2
  116. package/dist/formats/webp/CjsWebpFormat.js +86 -86
  117. package/dist/formats/webp/core/helpers.js +214 -214
  118. package/dist/formats/webp/index.js +2 -2
  119. package/dist/formats/wem/CjsWemFormat.js +241 -241
  120. package/dist/formats/wem/core/bitStream.js +259 -259
  121. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  122. package/dist/formats/wem/core/helpers.js +417 -417
  123. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  124. package/dist/formats/wem/core/ptadpcm.js +77 -77
  125. package/dist/formats/wem/core/resolve.js +121 -121
  126. package/dist/formats/wem/core/wemToOgg.js +485 -485
  127. package/dist/formats/wem/index.js +2 -2
  128. package/dist/formats/yaml/CjsYamlFormat.js +83 -83
  129. package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
  130. package/dist/formats/yaml/core/helpers.js +160 -160
  131. package/dist/formats/yaml/index.js +2 -2
  132. package/dist/index.js +48 -48
  133. package/dist/resourcePath.js +18 -18
  134. package/dist/resourceStates.js +9 -9
  135. package/dist/resources/AudioGeometryResData.js +47 -47
  136. package/dist/resources/GStateBindingCallbackData.js +31 -31
  137. package/dist/resources/MeshDecalData.js +37 -37
  138. package/dist/resources/MeshDecalLodData.js +34 -34
  139. package/dist/resources/Tr2EffectRes.js +71 -71
  140. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  141. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  142. package/dist/resources/Tr2ImageRes.js +114 -114
  143. package/dist/resources/Tr2LightProfileRes.js +40 -40
  144. package/dist/resources/Tr2MaterialArea.js +34 -34
  145. package/dist/resources/Tr2MaterialMesh.js +31 -31
  146. package/dist/resources/Tr2MaterialRes.js +34 -34
  147. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  148. package/dist/resources/Tr2TextureLodManager.js +80 -80
  149. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  150. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  151. package/dist/resources/Tr2TexturePipeline.js +52 -52
  152. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  153. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  154. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  155. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  156. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  157. package/dist/resources/TriGeometryRes.js +239 -216
  158. package/dist/resources/TriGeometryRes.js.map +1 -1
  159. package/dist/resources/TriGeometryResAreaData.js +59 -59
  160. package/dist/resources/TriGeometryResJointData.js +38 -38
  161. package/dist/resources/TriGeometryResLodData.js +88 -88
  162. package/dist/resources/TriGeometryResMeshData.js +63 -63
  163. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  164. package/dist/resources/TriGrannyRes.js +43 -43
  165. package/dist/resources/TriJointBinding.js +38 -38
  166. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  167. package/dist/resources/TriRtGeometryConstants.js +88 -88
  168. package/dist/resources/TriTextureRes.js +304 -304
  169. package/dist/resources/enums.js +18 -18
  170. package/dist/resources/resourceBoundary.js +47 -47
  171. package/dist/resources/texturePipelineBehavior.js +308 -308
  172. package/dist/texture/CjsTextureArrayRes.js +406 -406
  173. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  174. package/format-notices/black/LICENSE +21 -21
  175. package/format-notices/black/NOTICE +47 -47
  176. package/format-notices/bnk/LICENSE +21 -21
  177. package/format-notices/bnk/NOTICE +20 -20
  178. package/format-notices/cmf/LICENSE +21 -21
  179. package/format-notices/cmf/NOTICE +36 -36
  180. package/format-notices/dds/LICENSE +21 -21
  181. package/format-notices/dds/NOTICE +14 -14
  182. package/format-notices/fbx/LICENSE +21 -21
  183. package/format-notices/fbx/NOTICE +14 -14
  184. package/format-notices/flac/LICENSE +21 -21
  185. package/format-notices/flac/NOTICE +14 -14
  186. package/format-notices/gif/LICENSE +21 -21
  187. package/format-notices/gif/NOTICE +14 -14
  188. package/format-notices/gltf/LICENSE +21 -21
  189. package/format-notices/gltf/NOTICE +27 -27
  190. package/format-notices/jpeg/LICENSE +21 -21
  191. package/format-notices/jpeg/NOTICE +14 -14
  192. package/format-notices/mp3/LICENSE +21 -21
  193. package/format-notices/mp3/NOTICE +14 -14
  194. package/format-notices/mp4/LICENSE +21 -21
  195. package/format-notices/mp4/NOTICE +14 -14
  196. package/format-notices/obj/LICENSE +21 -21
  197. package/format-notices/obj/NOTICE +26 -26
  198. package/format-notices/ogg/LICENSE +21 -21
  199. package/format-notices/ogg/NOTICE +28 -28
  200. package/format-notices/png/LICENSE +21 -21
  201. package/format-notices/png/NOTICE +14 -14
  202. package/format-notices/red/LICENSE +21 -21
  203. package/format-notices/red/NOTICE +31 -31
  204. package/format-notices/stl/LICENSE +21 -21
  205. package/format-notices/stl/NOTICE +21 -21
  206. package/format-notices/tga/LICENSE +21 -21
  207. package/format-notices/tga/NOTICE +14 -14
  208. package/format-notices/wav/LICENSE +21 -21
  209. package/format-notices/wav/NOTICE +14 -14
  210. package/format-notices/webm/LICENSE +21 -21
  211. package/format-notices/webm/NOTICE +14 -14
  212. package/format-notices/webp/LICENSE +21 -21
  213. package/format-notices/webp/NOTICE +14 -14
  214. package/format-notices/wem/LICENSE +57 -57
  215. package/format-notices/wem/NOTICE +33 -33
  216. package/format-notices/yaml/LICENSE +21 -21
  217. package/format-notices/yaml/NOTICE +44 -44
  218. package/package.json +2 -2
  219. package/resource-lifecycle.md +679 -679
@@ -1,305 +1,305 @@
1
- import { LineCounter, parseDocument, isMap, isSeq, isScalar, isAlias, visit } from 'yaml';
2
- import { CjsReader } from '../../../format/CjsReader.js';
3
- import { toJsonGraph, TAG_REJECT, TAG_HANDLE, TAG_PRESERVE } from './helpers.js';
4
-
5
- const TAG_PREFIX = "tag:yaml.org,2002:";
6
- const PYTHON_TUPLE = `${TAG_PREFIX}python/tuple`;
7
- const PYTHON_UNICODE = `${TAG_PREFIX}python/unicode`;
8
- const PYTHON_PROJECTED_DECAL = `${TAG_PREFIX}python/object:paperDoll.ProjectedDecal`;
9
- const PYTHON_PART_METADATA = `${TAG_PREFIX}python/object:paperDoll.AvatarPartMetaData`;
10
- const STANDARD_TAGS = new Set(["binary", "bool", "float", "int", "map", "merge", "null", "omap", "pairs", "seq", "set", "str", "timestamp"].map(name => `${TAG_PREFIX}${name}`));
11
- function canonicalTag(tag) {
12
- if (typeof tag !== "string") return tag;
13
- if (tag.startsWith("!!")) return `${TAG_PREFIX}${tag.slice(2)}`;
14
- return tag;
15
- }
16
- function displayMessage(error) {
17
- return String(error && error.message ? error.message : error).trim();
18
- }
19
- function defineMappingValue(target, key, value) {
20
- Object.defineProperty(target, key, {
21
- value,
22
- enumerable: true,
23
- configurable: true,
24
- writable: true
25
- });
26
- }
27
- class CjsYamlReader extends CjsReader {
28
- constructor(input, options = {}) {
29
- super(options);
30
- if (typeof input !== "string") {
31
- throw new TypeError("CjsYamlFormat input must be a YAML string");
32
- }
33
- this.source = input;
34
- this.lineCounter = new LineCounter();
35
- this.document = parseDocument(input, {
36
- keepSourceTokens: true,
37
- lineCounter: this.lineCounter,
38
- prettyErrors: true,
39
- strict: true,
40
- uniqueKeys: this.options.uniqueKeys
41
- });
42
- this.inventory = this.BuildInventory();
43
- }
44
- Read() {
45
- return this.ReadPayload();
46
- }
47
- ReadPayload() {
48
- return toJsonGraph(this.ReadRaw(), this.options);
49
- }
50
- ReadRaw() {
51
- this.AssertSyntax();
52
- this.AssertAliasLimit();
53
- return this.Convert(this.document.contents, new Map());
54
- }
55
- ReadDocument() {
56
- let value = null;
57
- const errors = this.inventory.errors.slice();
58
- if (!errors.length) {
59
- try {
60
- this.AssertAliasLimit();
61
- value = this.Convert(this.document.contents, new Map());
62
- } catch (error) {
63
- errors.push(this.DescribeError(error));
64
- }
65
- }
66
- return {
67
- format: {
68
- id: "yaml"
69
- },
70
- source: {
71
- name: this.options.sourceName,
72
- length: this.source.length
73
- },
74
- root: {
75
- kind: this.RootKind()
76
- },
77
- value,
78
- tags: this.inventory.tags,
79
- anchors: this.inventory.anchors,
80
- aliases: this.inventory.aliases,
81
- warnings: this.inventory.warnings,
82
- errors
83
- };
84
- }
85
- Inspect() {
86
- return {
87
- format: {
88
- id: "yaml"
89
- },
90
- source: {
91
- name: this.options.sourceName,
92
- length: this.source.length
93
- },
94
- root: {
95
- kind: this.RootKind()
96
- },
97
- tags: this.inventory.tags,
98
- anchors: this.inventory.anchors,
99
- aliases: this.inventory.aliases,
100
- warnings: this.inventory.warnings,
101
- errors: this.inventory.errors
102
- };
103
- }
104
- RootKind() {
105
- const node = this.document.contents;
106
- if (node === null) return "null";
107
- if (isMap(node)) return "mapping";
108
- if (isSeq(node)) return "sequence";
109
- if (isScalar(node)) return "scalar";
110
- if (isAlias(node)) return "alias";
111
- return "unknown";
112
- }
113
- AssertSyntax() {
114
- if (!this.document.errors.length) return;
115
- const first = this.document.errors[0];
116
- const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
117
- throw new SyntaxError(`CjsYamlFormat${source}: ${displayMessage(first)}`);
118
- }
119
- AssertAliasLimit() {
120
- if (this.inventory.aliases.length <= this.options.maxAliasCount) return;
121
- const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
122
- throw new RangeError(`CjsYamlFormat${source}: alias count ${this.inventory.aliases.length} exceeds maxAliasCount ${this.options.maxAliasCount}`);
123
- }
124
- Convert(node, memo) {
125
- if (node === null || node === undefined) return null;
126
- if (isAlias(node)) {
127
- const source = node.resolve(this.document);
128
- if (!source) throw this.NodeError(node, `unresolved alias "${node.source}"`);
129
- return this.Convert(source, memo);
130
- }
131
- if (memo.has(node)) return memo.get(node);
132
- const tag = this.CustomTag(node);
133
- if (tag) {
134
- this.AssertTagAllowed(tag, node);
135
- const handler = this.FindTagHandler(tag);
136
- if (handler) {
137
- const value = this.ConvertBase(node, memo, true);
138
- const handled = handler(value, this.TagContext(tag, node));
139
- memo.set(node, handled);
140
- return handled;
141
- }
142
- if (tag === PYTHON_TUPLE) {
143
- if (!isSeq(node)) throw this.NodeError(node, `${tag} must decorate a sequence`);
144
- return this.ConvertBase(node, memo, true);
145
- }
146
- if (tag === PYTHON_UNICODE) {
147
- if (!isScalar(node) || typeof node.value !== "string") {
148
- throw this.NodeError(node, `${tag} must decorate a string scalar`);
149
- }
150
- return node.value;
151
- }
152
- if (this.options.tagPolicy === TAG_REJECT) {
153
- throw this.NodeError(node, `custom tag "${tag}" is rejected by tagPolicy`);
154
- }
155
- if (this.options.tagPolicy === TAG_HANDLE) {
156
- throw this.NodeError(node, `custom tag "${tag}" has no explicit handler`);
157
- }
158
- if (this.options.tagPolicy === TAG_PRESERVE || tag === PYTHON_PROJECTED_DECAL || tag === PYTHON_PART_METADATA) {
159
- const wrapper = {
160
- [this.options.tagField]: tag
161
- };
162
- memo.set(node, wrapper);
163
- wrapper[this.options.valueField] = this.ConvertBase(node, memo, false);
164
- return wrapper;
165
- }
166
- }
167
- return this.ConvertBase(node, memo, true);
168
- }
169
- ConvertBase(node, memo, memoize) {
170
- if (isScalar(node)) return node.value;
171
- if (isSeq(node)) {
172
- const out = [];
173
- if (memoize) memo.set(node, out);
174
- for (const item of node.items) out.push(this.Convert(item, memo));
175
- return out;
176
- }
177
- if (isMap(node)) {
178
- const out = {};
179
- if (memoize) memo.set(node, out);
180
- for (const pair of node.items) {
181
- const key = this.MapKey(pair.key);
182
- if (this.options.uniqueKeys && Object.prototype.hasOwnProperty.call(out, key)) {
183
- throw this.NodeError(pair.key, `duplicate mapping key "${key}"`);
184
- }
185
- // Defining the property prevents keys such as "__proto__" from
186
- // mutating the result object's prototype.
187
- defineMappingValue(out, key, this.Convert(pair.value, memo));
188
- }
189
- return out;
190
- }
191
- throw this.NodeError(node, "unsupported YAML node");
192
- }
193
- MapKey(node) {
194
- if (!isScalar(node)) throw this.NodeError(node, "mapping keys must be scalar values");
195
- return String(node.value);
196
- }
197
- CustomTag(node) {
198
- const tag = canonicalTag(node.tag);
199
- return tag && !STANDARD_TAGS.has(tag) ? tag : null;
200
- }
201
- AssertTagAllowed(tag, node) {
202
- if (!this.options.allowedTags) return;
203
- const allowed = new Set(this.options.allowedTags.map(canonicalTag));
204
- if (!allowed.has(tag)) throw this.NodeError(node, `custom tag "${tag}" is not in allowedTags`);
205
- }
206
- FindTagHandler(tag) {
207
- const handlers = this.options.tagHandlers;
208
- const short = tag.startsWith(TAG_PREFIX) ? `!!${tag.slice(TAG_PREFIX.length)}` : tag;
209
- if (handlers instanceof Map) return handlers.get(tag) || handlers.get(short) || null;
210
- return handlers[tag] || handlers[short] || null;
211
- }
212
- TagContext(tag, node) {
213
- return {
214
- tag,
215
- sourceName: this.options.sourceName,
216
- location: this.TagLocation(node)
217
- };
218
- }
219
- NodeError(node, message) {
220
- const at = node && node.tag ? this.TagLocation(node) : this.Location(node);
221
- const source = this.options.sourceName ? `${this.options.sourceName}:` : "";
222
- const where = at ? `${source}${at.line}:${at.column}` : this.options.sourceName || "YAML input";
223
- const error = new Error(`CjsYamlFormat ${where}: ${message}`);
224
- error.code = "YAML_TAG_POLICY";
225
- error.location = at;
226
- return error;
227
- }
228
- Location(node) {
229
- if (!node || !Array.isArray(node.range)) return null;
230
- const pos = this.lineCounter.linePos(node.range[0]);
231
- return {
232
- offset: node.range[0],
233
- line: pos.line,
234
- column: pos.col
235
- };
236
- }
237
- TagLocation(node) {
238
- const fallback = this.Location(node);
239
- if (!fallback || !node.tag) return fallback;
240
- const lineStart = this.source.lastIndexOf("\n", node.range[0] - 1) + 1;
241
- const prefix = this.source.slice(lineStart, node.range[0]);
242
- const tags = [...prefix.matchAll(/!<[^>]+>|!!?[^\s[\]{},]+/g)];
243
- const match = tags[tags.length - 1];
244
- if (!match) return fallback;
245
- const offset = lineStart + match.index;
246
- const pos = this.lineCounter.linePos(offset);
247
- return {
248
- offset,
249
- line: pos.line,
250
- column: pos.col
251
- };
252
- }
253
- DescribeError(error) {
254
- const linePos = error && error.linePos && error.linePos[0];
255
- return {
256
- code: error && error.code ? error.code : "YAML_ERROR",
257
- message: displayMessage(error),
258
- location: error && error.location ? error.location : linePos ? {
259
- line: linePos.line,
260
- column: linePos.col
261
- } : null
262
- };
263
- }
264
- BuildInventory() {
265
- const tags = [];
266
- const anchors = [];
267
- const aliases = [];
268
- visit(this.document, (_key, node) => {
269
- if (!node || typeof node !== "object") return;
270
- const tag = this.CustomTag(node);
271
- const location = tag ? this.TagLocation(node) : this.Location(node);
272
- if (tag) tags.push({
273
- tag,
274
- kind: this.NodeKind(node),
275
- location
276
- });
277
- if (node.anchor) anchors.push({
278
- name: node.anchor,
279
- kind: this.NodeKind(node),
280
- location
281
- });
282
- if (isAlias(node)) aliases.push({
283
- name: node.source,
284
- location
285
- });
286
- });
287
- return {
288
- tags,
289
- anchors,
290
- aliases,
291
- warnings: this.document.warnings.map(error => this.DescribeError(error)),
292
- errors: this.document.errors.map(error => this.DescribeError(error))
293
- };
294
- }
295
- NodeKind(node) {
296
- if (isMap(node)) return "mapping";
297
- if (isSeq(node)) return "sequence";
298
- if (isScalar(node)) return "scalar";
299
- if (isAlias(node)) return "alias";
300
- return "unknown";
301
- }
302
- }
303
-
304
- export { CjsYamlReader };
305
- //# sourceMappingURL=CjsYamlReader.js.map
1
+ import { LineCounter, parseDocument, isMap, isSeq, isScalar, isAlias, visit } from 'yaml';
2
+ import { CjsReader } from '../../../format/CjsReader.js';
3
+ import { toJsonGraph, TAG_REJECT, TAG_HANDLE, TAG_PRESERVE } from './helpers.js';
4
+
5
+ const TAG_PREFIX = "tag:yaml.org,2002:";
6
+ const PYTHON_TUPLE = `${TAG_PREFIX}python/tuple`;
7
+ const PYTHON_UNICODE = `${TAG_PREFIX}python/unicode`;
8
+ const PYTHON_PROJECTED_DECAL = `${TAG_PREFIX}python/object:paperDoll.ProjectedDecal`;
9
+ const PYTHON_PART_METADATA = `${TAG_PREFIX}python/object:paperDoll.AvatarPartMetaData`;
10
+ const STANDARD_TAGS = new Set(["binary", "bool", "float", "int", "map", "merge", "null", "omap", "pairs", "seq", "set", "str", "timestamp"].map(name => `${TAG_PREFIX}${name}`));
11
+ function canonicalTag(tag) {
12
+ if (typeof tag !== "string") return tag;
13
+ if (tag.startsWith("!!")) return `${TAG_PREFIX}${tag.slice(2)}`;
14
+ return tag;
15
+ }
16
+ function displayMessage(error) {
17
+ return String(error && error.message ? error.message : error).trim();
18
+ }
19
+ function defineMappingValue(target, key, value) {
20
+ Object.defineProperty(target, key, {
21
+ value,
22
+ enumerable: true,
23
+ configurable: true,
24
+ writable: true
25
+ });
26
+ }
27
+ class CjsYamlReader extends CjsReader {
28
+ constructor(input, options = {}) {
29
+ super(options);
30
+ if (typeof input !== "string") {
31
+ throw new TypeError("CjsYamlFormat input must be a YAML string");
32
+ }
33
+ this.source = input;
34
+ this.lineCounter = new LineCounter();
35
+ this.document = parseDocument(input, {
36
+ keepSourceTokens: true,
37
+ lineCounter: this.lineCounter,
38
+ prettyErrors: true,
39
+ strict: true,
40
+ uniqueKeys: this.options.uniqueKeys
41
+ });
42
+ this.inventory = this.BuildInventory();
43
+ }
44
+ Read() {
45
+ return this.ReadPayload();
46
+ }
47
+ ReadPayload() {
48
+ return toJsonGraph(this.ReadRaw(), this.options);
49
+ }
50
+ ReadRaw() {
51
+ this.AssertSyntax();
52
+ this.AssertAliasLimit();
53
+ return this.Convert(this.document.contents, new Map());
54
+ }
55
+ ReadDocument() {
56
+ let value = null;
57
+ const errors = this.inventory.errors.slice();
58
+ if (!errors.length) {
59
+ try {
60
+ this.AssertAliasLimit();
61
+ value = this.Convert(this.document.contents, new Map());
62
+ } catch (error) {
63
+ errors.push(this.DescribeError(error));
64
+ }
65
+ }
66
+ return {
67
+ format: {
68
+ id: "yaml"
69
+ },
70
+ source: {
71
+ name: this.options.sourceName,
72
+ length: this.source.length
73
+ },
74
+ root: {
75
+ kind: this.RootKind()
76
+ },
77
+ value,
78
+ tags: this.inventory.tags,
79
+ anchors: this.inventory.anchors,
80
+ aliases: this.inventory.aliases,
81
+ warnings: this.inventory.warnings,
82
+ errors
83
+ };
84
+ }
85
+ Inspect() {
86
+ return {
87
+ format: {
88
+ id: "yaml"
89
+ },
90
+ source: {
91
+ name: this.options.sourceName,
92
+ length: this.source.length
93
+ },
94
+ root: {
95
+ kind: this.RootKind()
96
+ },
97
+ tags: this.inventory.tags,
98
+ anchors: this.inventory.anchors,
99
+ aliases: this.inventory.aliases,
100
+ warnings: this.inventory.warnings,
101
+ errors: this.inventory.errors
102
+ };
103
+ }
104
+ RootKind() {
105
+ const node = this.document.contents;
106
+ if (node === null) return "null";
107
+ if (isMap(node)) return "mapping";
108
+ if (isSeq(node)) return "sequence";
109
+ if (isScalar(node)) return "scalar";
110
+ if (isAlias(node)) return "alias";
111
+ return "unknown";
112
+ }
113
+ AssertSyntax() {
114
+ if (!this.document.errors.length) return;
115
+ const first = this.document.errors[0];
116
+ const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
117
+ throw new SyntaxError(`CjsYamlFormat${source}: ${displayMessage(first)}`);
118
+ }
119
+ AssertAliasLimit() {
120
+ if (this.inventory.aliases.length <= this.options.maxAliasCount) return;
121
+ const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
122
+ throw new RangeError(`CjsYamlFormat${source}: alias count ${this.inventory.aliases.length} exceeds maxAliasCount ${this.options.maxAliasCount}`);
123
+ }
124
+ Convert(node, memo) {
125
+ if (node === null || node === undefined) return null;
126
+ if (isAlias(node)) {
127
+ const source = node.resolve(this.document);
128
+ if (!source) throw this.NodeError(node, `unresolved alias "${node.source}"`);
129
+ return this.Convert(source, memo);
130
+ }
131
+ if (memo.has(node)) return memo.get(node);
132
+ const tag = this.CustomTag(node);
133
+ if (tag) {
134
+ this.AssertTagAllowed(tag, node);
135
+ const handler = this.FindTagHandler(tag);
136
+ if (handler) {
137
+ const value = this.ConvertBase(node, memo, true);
138
+ const handled = handler(value, this.TagContext(tag, node));
139
+ memo.set(node, handled);
140
+ return handled;
141
+ }
142
+ if (tag === PYTHON_TUPLE) {
143
+ if (!isSeq(node)) throw this.NodeError(node, `${tag} must decorate a sequence`);
144
+ return this.ConvertBase(node, memo, true);
145
+ }
146
+ if (tag === PYTHON_UNICODE) {
147
+ if (!isScalar(node) || typeof node.value !== "string") {
148
+ throw this.NodeError(node, `${tag} must decorate a string scalar`);
149
+ }
150
+ return node.value;
151
+ }
152
+ if (this.options.tagPolicy === TAG_REJECT) {
153
+ throw this.NodeError(node, `custom tag "${tag}" is rejected by tagPolicy`);
154
+ }
155
+ if (this.options.tagPolicy === TAG_HANDLE) {
156
+ throw this.NodeError(node, `custom tag "${tag}" has no explicit handler`);
157
+ }
158
+ if (this.options.tagPolicy === TAG_PRESERVE || tag === PYTHON_PROJECTED_DECAL || tag === PYTHON_PART_METADATA) {
159
+ const wrapper = {
160
+ [this.options.tagField]: tag
161
+ };
162
+ memo.set(node, wrapper);
163
+ wrapper[this.options.valueField] = this.ConvertBase(node, memo, false);
164
+ return wrapper;
165
+ }
166
+ }
167
+ return this.ConvertBase(node, memo, true);
168
+ }
169
+ ConvertBase(node, memo, memoize) {
170
+ if (isScalar(node)) return node.value;
171
+ if (isSeq(node)) {
172
+ const out = [];
173
+ if (memoize) memo.set(node, out);
174
+ for (const item of node.items) out.push(this.Convert(item, memo));
175
+ return out;
176
+ }
177
+ if (isMap(node)) {
178
+ const out = {};
179
+ if (memoize) memo.set(node, out);
180
+ for (const pair of node.items) {
181
+ const key = this.MapKey(pair.key);
182
+ if (this.options.uniqueKeys && Object.prototype.hasOwnProperty.call(out, key)) {
183
+ throw this.NodeError(pair.key, `duplicate mapping key "${key}"`);
184
+ }
185
+ // Defining the property prevents keys such as "__proto__" from
186
+ // mutating the result object's prototype.
187
+ defineMappingValue(out, key, this.Convert(pair.value, memo));
188
+ }
189
+ return out;
190
+ }
191
+ throw this.NodeError(node, "unsupported YAML node");
192
+ }
193
+ MapKey(node) {
194
+ if (!isScalar(node)) throw this.NodeError(node, "mapping keys must be scalar values");
195
+ return String(node.value);
196
+ }
197
+ CustomTag(node) {
198
+ const tag = canonicalTag(node.tag);
199
+ return tag && !STANDARD_TAGS.has(tag) ? tag : null;
200
+ }
201
+ AssertTagAllowed(tag, node) {
202
+ if (!this.options.allowedTags) return;
203
+ const allowed = new Set(this.options.allowedTags.map(canonicalTag));
204
+ if (!allowed.has(tag)) throw this.NodeError(node, `custom tag "${tag}" is not in allowedTags`);
205
+ }
206
+ FindTagHandler(tag) {
207
+ const handlers = this.options.tagHandlers;
208
+ const short = tag.startsWith(TAG_PREFIX) ? `!!${tag.slice(TAG_PREFIX.length)}` : tag;
209
+ if (handlers instanceof Map) return handlers.get(tag) || handlers.get(short) || null;
210
+ return handlers[tag] || handlers[short] || null;
211
+ }
212
+ TagContext(tag, node) {
213
+ return {
214
+ tag,
215
+ sourceName: this.options.sourceName,
216
+ location: this.TagLocation(node)
217
+ };
218
+ }
219
+ NodeError(node, message) {
220
+ const at = node && node.tag ? this.TagLocation(node) : this.Location(node);
221
+ const source = this.options.sourceName ? `${this.options.sourceName}:` : "";
222
+ const where = at ? `${source}${at.line}:${at.column}` : this.options.sourceName || "YAML input";
223
+ const error = new Error(`CjsYamlFormat ${where}: ${message}`);
224
+ error.code = "YAML_TAG_POLICY";
225
+ error.location = at;
226
+ return error;
227
+ }
228
+ Location(node) {
229
+ if (!node || !Array.isArray(node.range)) return null;
230
+ const pos = this.lineCounter.linePos(node.range[0]);
231
+ return {
232
+ offset: node.range[0],
233
+ line: pos.line,
234
+ column: pos.col
235
+ };
236
+ }
237
+ TagLocation(node) {
238
+ const fallback = this.Location(node);
239
+ if (!fallback || !node.tag) return fallback;
240
+ const lineStart = this.source.lastIndexOf("\n", node.range[0] - 1) + 1;
241
+ const prefix = this.source.slice(lineStart, node.range[0]);
242
+ const tags = [...prefix.matchAll(/!<[^>]+>|!!?[^\s[\]{},]+/g)];
243
+ const match = tags[tags.length - 1];
244
+ if (!match) return fallback;
245
+ const offset = lineStart + match.index;
246
+ const pos = this.lineCounter.linePos(offset);
247
+ return {
248
+ offset,
249
+ line: pos.line,
250
+ column: pos.col
251
+ };
252
+ }
253
+ DescribeError(error) {
254
+ const linePos = error && error.linePos && error.linePos[0];
255
+ return {
256
+ code: error && error.code ? error.code : "YAML_ERROR",
257
+ message: displayMessage(error),
258
+ location: error && error.location ? error.location : linePos ? {
259
+ line: linePos.line,
260
+ column: linePos.col
261
+ } : null
262
+ };
263
+ }
264
+ BuildInventory() {
265
+ const tags = [];
266
+ const anchors = [];
267
+ const aliases = [];
268
+ visit(this.document, (_key, node) => {
269
+ if (!node || typeof node !== "object") return;
270
+ const tag = this.CustomTag(node);
271
+ const location = tag ? this.TagLocation(node) : this.Location(node);
272
+ if (tag) tags.push({
273
+ tag,
274
+ kind: this.NodeKind(node),
275
+ location
276
+ });
277
+ if (node.anchor) anchors.push({
278
+ name: node.anchor,
279
+ kind: this.NodeKind(node),
280
+ location
281
+ });
282
+ if (isAlias(node)) aliases.push({
283
+ name: node.source,
284
+ location
285
+ });
286
+ });
287
+ return {
288
+ tags,
289
+ anchors,
290
+ aliases,
291
+ warnings: this.document.warnings.map(error => this.DescribeError(error)),
292
+ errors: this.document.errors.map(error => this.DescribeError(error))
293
+ };
294
+ }
295
+ NodeKind(node) {
296
+ if (isMap(node)) return "mapping";
297
+ if (isSeq(node)) return "sequence";
298
+ if (isScalar(node)) return "scalar";
299
+ if (isAlias(node)) return "alias";
300
+ return "unknown";
301
+ }
302
+ }
303
+
304
+ export { CjsYamlReader };
305
+ //# sourceMappingURL=CjsYamlReader.js.map