@carbonenginejs/runtime-resource 0.13.0 → 0.15.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.
- package/LICENSE +21 -21
- package/NOTICE +32 -32
- package/README.md +129 -129
- package/dist/CjsMotherLode.js +1271 -1271
- package/dist/CjsResMan.js +3858 -3858
- package/dist/CjsResManFetchProvider.js +94 -94
- package/dist/CjsResManWorkQueue.js +301 -301
- package/dist/_virtual/_rollupPluginBabelHelpers.js +150 -150
- package/dist/format/CjsBlueReader.js +358 -358
- package/dist/format/CjsByteReader.js +310 -310
- package/dist/format/CjsByteWriter.js +242 -242
- package/dist/format/CjsFormat.js +223 -223
- package/dist/format/CjsFormatError.js +41 -41
- package/dist/format/CjsReader.js +22 -22
- package/dist/format/CjsResourceProbe.js +279 -279
- package/dist/format/CjsStringTable.js +268 -268
- package/dist/format/carbonEffect/CjsCarbonEffectReader.js +265 -265
- package/dist/format/carbonEffect/CjsCarbonEffectWriter.js +373 -373
- package/dist/format/carbonEffect/buildCarbonEffectContainer.js +182 -182
- package/dist/format/carbonEffect/carbonEffectBackendBlock.js +321 -321
- package/dist/format/carbonEffect/carbonEffectRecords.js +1147 -1147
- package/dist/format/carbonEffect/carbonEffectResourceTransform.js +197 -197
- package/dist/format/compareUtf8.js +36 -36
- package/dist/format/effect/effectBodyInventory.js +146 -146
- package/dist/format/effect/effectPermutationGraph.js +257 -257
- package/dist/format/effect/sha256.js +114 -114
- package/dist/format/index.js +11 -11
- package/dist/format/payloadContract.js +193 -193
- package/dist/formats/black/CjsBlackFormat.js +310 -310
- package/dist/formats/black/core/CjsBlackBinaryReader.js +260 -260
- package/dist/formats/black/core/CjsBlackPropertyReaders.js +448 -448
- package/dist/formats/black/core/CjsBlackReader.js +764 -764
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js +540 -540
- package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -4
- package/dist/formats/black/core/blackConstants.js +7 -7
- package/dist/formats/black/core/blackDefinitions.js +10 -10
- package/dist/formats/black/core/blackEnums.js +6 -6
- package/dist/formats/black/core/blackSchema.js +3 -3
- package/dist/formats/black/core/blackVersion.js +22 -22
- package/dist/formats/black/core/helpers.js +199 -199
- package/dist/formats/black/core/schema.js +4 -4
- package/dist/formats/black/index.js +2 -2
- package/dist/formats/bnk/CjsBnkFormat.js +175 -175
- package/dist/formats/bnk/core/busNodes.js +252 -252
- package/dist/formats/bnk/core/effectNodes.js +147 -147
- package/dist/formats/bnk/core/eventAction.js +416 -416
- package/dist/formats/bnk/core/globalSettings.js +215 -215
- package/dist/formats/bnk/core/graph.js +137 -137
- package/dist/formats/bnk/core/helpers.js +512 -512
- package/dist/formats/bnk/core/musicNodes.js +540 -540
- package/dist/formats/bnk/core/nodeBase.js +553 -553
- package/dist/formats/bnk/core/sfxNodes.js +632 -632
- package/dist/formats/bnk/core/soundbanksInfo.js +209 -209
- package/dist/formats/bnk/index.js +2 -2
- package/dist/formats/cmf/CjsCmfFormat.js +497 -497
- package/dist/formats/cmf/core/binary.js +194 -194
- package/dist/formats/cmf/core/buffers.js +237 -237
- package/dist/formats/cmf/core/constants.js +47 -47
- package/dist/formats/cmf/core/gr2Anim.js +453 -453
- package/dist/formats/cmf/core/helpers.js +318 -318
- package/dist/formats/cmf/core/pack.js +276 -276
- package/dist/formats/cmf/core/schema.js +374 -374
- package/dist/formats/cmf/core/shared.js +277 -277
- package/dist/formats/cmf/core/writer.js +571 -571
- package/dist/formats/cmf/index.js +2 -2
- package/dist/formats/dds/CjsDdsFormat.js +200 -200
- package/dist/formats/dds/core/bc6h.js +298 -298
- package/dist/formats/dds/core/bc7.js +272 -272
- package/dist/formats/dds/core/helpers.js +901 -862
- package/dist/formats/dds/core/helpers.js.map +1 -1
- package/dist/formats/dds/index.js +2 -2
- package/dist/formats/dxbc/CjsDxbcFormat.js +187 -142
- package/dist/formats/dxbc/CjsDxbcFormat.js.map +1 -1
- package/dist/formats/dxbc/core/DxbcReader.js +266 -266
- package/dist/formats/dxbc/core/container.js +169 -169
- package/dist/formats/dxbc/core/decoder.js +789 -789
- package/dist/formats/dxbc/core/disassemble.js +240 -0
- package/dist/formats/dxbc/core/disassemble.js.map +1 -0
- package/dist/formats/dxbc/core/errors.js +19 -19
- package/dist/formats/dxbc/core/helpers.js +220 -220
- package/dist/formats/dxbc/core/opcodes.js +45 -45
- package/dist/formats/dxbc/core/program.js +91 -91
- package/dist/formats/dxbc/core/signature.js +172 -172
- package/dist/formats/dxbc/index.js +2 -2
- package/dist/formats/fbx/CjsFbxFormat.js +266 -266
- package/dist/formats/fbx/core/helpers.js +3932 -3932
- package/dist/formats/fbx/index.js +2 -2
- package/dist/formats/flac/CjsFlacFormat.js +142 -142
- package/dist/formats/flac/core/helpers.js +315 -315
- package/dist/formats/flac/index.js +2 -2
- package/dist/formats/gif/CjsGifFormat.js +141 -141
- package/dist/formats/gif/core/helpers.js +380 -380
- package/dist/formats/gif/index.js +2 -2
- package/dist/formats/gltf/CjsGltfFormat.js +252 -290
- package/dist/formats/gltf/CjsGltfFormat.js.map +1 -1
- package/dist/formats/gltf/core/helpers.js +287 -307
- package/dist/formats/gltf/core/helpers.js.map +1 -1
- package/dist/formats/gltf/core/json.js +79 -79
- package/dist/formats/gltf/core/parser.js +679 -679
- package/dist/formats/gltf/core/targets.js +173 -173
- package/dist/formats/gltf/index.js +2 -2
- package/dist/formats/gr2/CjsGr2Format.js +289 -289
- package/dist/formats/gr2/core/bitknit2.js +282 -282
- package/dist/formats/gr2/core/curves.js +1047 -1047
- package/dist/formats/gr2/core/gsf.js +72 -72
- package/dist/formats/gr2/core/helpers.js +352 -352
- package/dist/formats/gr2/core/json.js +622 -622
- package/dist/formats/gr2/core/oodle1.js +388 -388
- package/dist/formats/gr2/core/tangents.js +48 -48
- package/dist/formats/gr2/core/targets.js +361 -361
- package/dist/formats/gr2/index.js +2 -2
- package/dist/formats/hlsl/CjsHlslFormat.js +233 -254
- package/dist/formats/hlsl/CjsHlslFormat.js.map +1 -1
- package/dist/formats/hlsl/core/HlslBinaryUtils.js +15 -15
- package/dist/formats/hlsl/core/HlslEffectReadError.js +19 -19
- package/dist/formats/hlsl/core/HlslEffectStateManager.js +130 -130
- package/dist/formats/hlsl/core/HlslRenderStateSetup.js +37 -37
- package/dist/formats/hlsl/core/HlslResourceSetDescription.js +94 -94
- package/dist/formats/hlsl/core/HlslShaderBytecode.js +44 -44
- package/dist/formats/hlsl/core/analysis.js +51 -51
- package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js +850 -850
- package/dist/formats/hlsl/core/detailMapFamily.js +128 -128
- package/dist/formats/hlsl/core/helpers.js +270 -270
- package/dist/formats/hlsl/core/json.js +284 -284
- package/dist/formats/hlsl/core/localLightFamily.js +133 -133
- package/dist/formats/hlsl/core/metadata.js +327 -327
- package/dist/formats/hlsl/core/render-states.js +280 -280
- package/dist/formats/hlsl/core/tr2/HlslRenderContextEnum.js +43 -43
- package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js +320 -320
- package/dist/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js +33 -33
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js +423 -416
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js.map +1 -1
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectConstant.js +40 -40
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js +62 -62
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js +52 -52
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js +38 -38
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectResource.js +50 -50
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js +86 -86
- package/dist/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js +31 -31
- package/dist/formats/hlsl/core/tr2/shader/HlslPass.js +42 -42
- package/dist/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js +55 -55
- package/dist/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js +29 -29
- package/dist/formats/hlsl/core/tr2/shader/HlslShader.js +220 -220
- package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js +30 -30
- package/dist/formats/hlsl/index.js +3 -3
- package/dist/formats/index.js +33 -33
- package/dist/formats/jpeg/CjsJpegFormat.js +212 -212
- package/dist/formats/jpeg/core/helpers.js +402 -402
- package/dist/formats/jpeg/core/jpeg.js +480 -480
- package/dist/formats/jpeg/index.js +2 -2
- package/dist/formats/mp3/CjsMp3Format.js +197 -197
- package/dist/formats/mp3/core/helpers.js +375 -375
- package/dist/formats/mp3/index.js +2 -2
- package/dist/formats/mp4/CjsMp4Format.js +197 -197
- package/dist/formats/mp4/core/helpers.js +484 -484
- package/dist/formats/mp4/index.js +2 -2
- package/dist/formats/obj/CjsObjFormat.js +232 -253
- package/dist/formats/obj/CjsObjFormat.js.map +1 -1
- package/dist/formats/obj/core/helpers.js +553 -573
- package/dist/formats/obj/core/helpers.js.map +1 -1
- package/dist/formats/obj/core/json.js +64 -64
- package/dist/formats/obj/core/parser.js +321 -321
- package/dist/formats/obj/index.js +2 -2
- package/dist/formats/ogg/CjsOggFormat.js +143 -143
- package/dist/formats/ogg/core/helpers.js +410 -410
- package/dist/formats/ogg/core/imdct.js +178 -178
- package/dist/formats/ogg/core/vorbis.js +1017 -1017
- package/dist/formats/ogg/index.js +2 -2
- package/dist/formats/pickle/CjsPickleFormat.js +214 -214
- package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js +551 -551
- package/dist/formats/pickle/index.js +2 -2
- package/dist/formats/png/CjsPngFormat.js +201 -201
- package/dist/formats/png/core/helpers.js +635 -635
- package/dist/formats/png/index.js +2 -2
- package/dist/formats/red/CjsRedFormat.js +263 -263
- package/dist/formats/red/core/CjsRedReader.js +246 -246
- package/dist/formats/red/core/blackDefinitions.js +3 -3
- package/dist/formats/red/core/helpers.js +158 -158
- package/dist/formats/red/core/redGraph.js +71 -71
- package/dist/formats/red/core/schema.js +4 -4
- package/dist/formats/red/index.js +2 -2
- package/dist/formats/stl/CjsStlFormat.js +320 -365
- package/dist/formats/stl/CjsStlFormat.js.map +1 -1
- package/dist/formats/stl/core/helpers.js +241 -261
- package/dist/formats/stl/core/helpers.js.map +1 -1
- package/dist/formats/stl/core/json.js +51 -51
- package/dist/formats/stl/core/stl.js +642 -642
- package/dist/formats/stl/core/targets.js +173 -173
- package/dist/formats/stl/index.js +2 -2
- package/dist/formats/tga/CjsTgaFormat.js +197 -197
- package/dist/formats/tga/core/helpers.js +493 -493
- package/dist/formats/tga/index.js +2 -2
- package/dist/formats/wav/CjsWavFormat.js +198 -198
- package/dist/formats/wav/core/helpers.js +365 -365
- package/dist/formats/wav/index.js +2 -2
- package/dist/formats/webgl/CjsWebglFormat.js +199 -199
- package/dist/formats/webgl/core/buildGlslEffectContainer.js +70 -70
- package/dist/formats/webgl/core/effectPackage.js +900 -900
- package/dist/formats/webgl/core/errors.js +27 -27
- package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js +2820 -2820
- package/dist/formats/webgl/core/glsl/DxbcGlslHelpers.js +89 -89
- package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js +486 -486
- package/dist/formats/webgl/core/glsl/packedLightFixups.js +98 -98
- package/dist/formats/webgl/core/glslBackendBlock.js +552 -552
- package/dist/formats/webgl/core/glslBackendBodySet.js +243 -243
- package/dist/formats/webgl/core/glslEffectCompleteness.js +85 -85
- package/dist/formats/webgl/core/glslEffectCompleteness.js.map +1 -1
- package/dist/formats/webgl/core/helpers.js +167 -167
- package/dist/formats/webgl/core/inspectGlslEffectContainer.js +122 -122
- package/dist/formats/webgl/core/readGlslEffectContainer.js +202 -256
- package/dist/formats/webgl/core/readGlslEffectContainer.js.map +1 -1
- package/dist/formats/webgl/index.js +2 -2
- package/dist/formats/webgpu/CjsWebgpuFormat.js +357 -357
- package/dist/formats/webgpu/core/buildCarbonEffectContainer.js +89 -89
- package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js +354 -354
- package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js +355 -355
- package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js +90 -90
- package/dist/formats/webgpu/core/effectAnalysis.js +82 -82
- package/dist/formats/webgpu/core/effectBackendBodySet.js +306 -306
- package/dist/formats/webgpu/core/errors.js +20 -20
- package/dist/formats/webgpu/core/helpers.js +443 -443
- package/dist/formats/webgpu/core/ir/analyzeRegisterValues.js +212 -212
- package/dist/formats/webgpu/core/ir/buildControlFlow.js +220 -220
- package/dist/formats/webgpu/core/ir/indexableTemps.js +137 -137
- package/dist/formats/webgpu/core/ir/inferValueTypes.js +449 -449
- package/dist/formats/webgpu/core/ir/lowerDxbcToIr.js +494 -494
- package/dist/formats/webgpu/core/ir/resolveRegisterFlow.js +177 -177
- package/dist/formats/webgpu/core/ir/sourceLanes.js +61 -61
- package/dist/formats/webgpu/core/packageEffect.js +381 -381
- package/dist/formats/webgpu/core/packageEffectSelection.js +164 -164
- package/dist/formats/webgpu/core/packageMetadata.js +17 -17
- package/dist/formats/webgpu/core/schema.js +4 -4
- package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js +263 -263
- package/dist/formats/webgpu/core/wgsl/buildWgslBindingPlan.js +172 -172
- package/dist/formats/webgpu/core/wgsl/buildWgslSet.js +325 -325
- package/dist/formats/webgpu/core/wgsl/emitWgsl.js +356 -356
- package/dist/formats/webgpu/core/wgsl/hoistEscapingValues.js +77 -77
- package/dist/formats/webgpu/core/wgsl/lowerBindingLayout.js +451 -451
- package/dist/formats/webgpu/core/wgsl/lowerComputeProgram.js +735 -735
- package/dist/formats/webgpu/core/wgsl/lowerCreateHistogramsComputeProgram.js +457 -457
- package/dist/formats/webgpu/core/wgsl/lowerFragmentProgram.js +1572 -1572
- package/dist/formats/webgpu/core/wgsl/lowerMergeHistogramsComputeProgram.js +659 -659
- package/dist/formats/webgpu/core/wgsl/lowerParticleClearComputePrograms.js +734 -734
- package/dist/formats/webgpu/core/wgsl/lowerParticleEmitComputeProgram.js +583 -583
- package/dist/formats/webgpu/core/wgsl/lowerSkinVerticesComputeProgram.js +621 -621
- package/dist/formats/webgpu/core/wgsl/lowerSortComputeProgram.js +824 -824
- package/dist/formats/webgpu/core/wgsl/lowerSortInnerComputeProgram.js +697 -697
- package/dist/formats/webgpu/core/wgsl/lowerSortStepComputeProgram.js +559 -559
- package/dist/formats/webgpu/core/wgsl/lowerVertexProgram.js +1328 -1328
- package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js +110 -110
- package/dist/formats/webgpu/core/wgsl/precisionControls.js +55 -55
- package/dist/formats/webgpu/core/wgsl/selectionPlans.js +717 -717
- package/dist/formats/webgpu/core/wgsl/uniformity.js +78 -78
- package/dist/formats/webgpu/core/wgsl/validateExactComputeIr.js +196 -196
- package/dist/formats/webgpu/core/wgsl/validateHandleOperand.js +37 -37
- package/dist/formats/webgpu/index.js +2 -2
- package/dist/formats/webm/CjsWebmFormat.js +197 -197
- package/dist/formats/webm/core/helpers.js +572 -572
- package/dist/formats/webm/index.js +2 -2
- package/dist/formats/webp/CjsWebpFormat.js +140 -140
- package/dist/formats/webp/core/helpers.js +237 -237
- package/dist/formats/webp/index.js +2 -2
- package/dist/formats/wem/CjsWemFormat.js +250 -250
- package/dist/formats/wem/core/bitStream.js +261 -261
- package/dist/formats/wem/core/codebookLibrary.js +164 -164
- package/dist/formats/wem/core/helpers.js +437 -437
- package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
- package/dist/formats/wem/core/ptadpcm.js +77 -77
- package/dist/formats/wem/core/resolve.js +121 -121
- package/dist/formats/wem/core/wemToOgg.js +485 -485
- package/dist/formats/wem/index.js +2 -2
- package/dist/formats/yaml/CjsYamlFormat.js +134 -134
- package/dist/formats/yaml/core/CjsYamlReader.js +400 -400
- package/dist/formats/yaml/core/helpers.js +196 -196
- package/dist/formats/yaml/index.js +2 -2
- package/dist/index.js +64 -64
- package/dist/resource/CjsLoadingObject.js +19 -19
- package/dist/resource/CjsResource.js +801 -801
- package/dist/resource/ResourceHandlerMode.js +14 -14
- package/dist/resource/Tr2LightProfileRes.js +32 -32
- package/dist/resource/audio/AudioGeometryResData.js +47 -47
- package/dist/resource/audio/CjsAudioBufferRes.js +86 -86
- package/dist/resource/audio/CjsAudioRes.js +213 -213
- package/dist/resource/audio/index.js +4 -4
- package/dist/resource/geometry/MeshDecalData.js +37 -37
- package/dist/resource/geometry/MeshDecalLodData.js +34 -34
- package/dist/resource/geometry/TriGeometryRes.js +570 -467
- package/dist/resource/geometry/TriGeometryRes.js.map +1 -1
- package/dist/resource/geometry/TriGeometryResAreaData.js +59 -59
- package/dist/resource/geometry/TriGeometryResJointData.js +38 -38
- package/dist/resource/geometry/TriGeometryResLodData.js +88 -88
- package/dist/resource/geometry/TriGeometryResMeshData.js +63 -63
- package/dist/resource/geometry/TriGeometryResSkeletonData.js +34 -34
- package/dist/resource/geometry/TriJointBinding.js +38 -38
- package/dist/resource/geometry/TriMorphTargetGeometryConstants.js +46 -46
- package/dist/resource/geometry/TriRtGeometryConstants.js +88 -88
- package/dist/resource/geometry/granny/GStateBindingCallbackData.js +31 -31
- package/dist/resource/geometry/granny/Tr2GrannyIntersectionResult.js +60 -60
- package/dist/resource/geometry/granny/Tr2GrannyStateRes.js +36 -36
- package/dist/resource/geometry/granny/TriGrannyRes.js +35 -35
- package/dist/resource/geometry/granny/enums.js +10 -10
- package/dist/resource/geometry/granny/index.js +6 -6
- package/dist/resource/geometry/index.js +17 -17
- package/dist/resource/index.js +54 -54
- package/dist/resource/resourceBoundary.js +64 -64
- package/dist/resource/shader/Tr2EffectRes.js +336 -336
- package/dist/resource/shader/Tr2MaterialArea.js +31 -31
- package/dist/resource/shader/Tr2MaterialMesh.js +27 -27
- package/dist/resource/shader/Tr2MaterialRes.js +31 -31
- package/dist/resource/shader/Tr2Shader.js +283 -283
- package/dist/resource/shader/Tr2ShaderPermutation.js +43 -43
- package/dist/resource/shader/index.js +17 -17
- package/dist/resource/shader/reflection/Tr2EffectConstant.js +143 -143
- package/dist/resource/shader/reflection/Tr2EffectDefine.js +30 -30
- package/dist/resource/shader/reflection/Tr2EffectDescription.js +114 -114
- package/dist/resource/shader/reflection/Tr2EffectLibrary.js +168 -168
- package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js +125 -125
- package/dist/resource/shader/reflection/Tr2EffectResource.js +120 -120
- package/dist/resource/shader/reflection/Tr2EffectStageInput.js +372 -372
- package/dist/resource/shader/reflection/Tr2EffectTechnique.js +78 -78
- package/dist/resource/shader/reflection/Tr2Pass.js +168 -168
- package/dist/resource/shader/reflection/carbonRecordFields.js +159 -159
- package/dist/resource/shader/reflection/shaderStage.js +22 -22
- package/dist/resource/shader/sampler/Tr2SamplerSetup.js +135 -135
- package/dist/resource/texture/CjsTextureArrayRes.js +472 -472
- package/dist/resource/texture/CjsTextureArrayResParameterProxy.js +179 -179
- package/dist/resource/texture/Tr2ImageRes.js +120 -120
- package/dist/resource/texture/Tr2TextureLodManager.js +82 -82
- package/dist/resource/texture/Tr2TextureLodUpdateRequest.js +37 -37
- package/dist/resource/texture/Tr2TexturePackChannel.js +37 -37
- package/dist/resource/texture/Tr2TexturePipeline.js +54 -54
- package/dist/resource/texture/Tr2TexturePipelineParams.js +34 -34
- package/dist/resource/texture/Tr2TexturePipelineStepCompress.js +40 -40
- package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js +22 -22
- package/dist/resource/texture/Tr2TexturePipelineStepLimitSize.js +34 -34
- package/dist/resource/texture/Tr2TexturePipelineStepLoad.js +31 -31
- package/dist/resource/texture/Tr2TexturePipelineStepPack.js +43 -43
- package/dist/resource/texture/TriTextureRes.js +359 -359
- package/dist/resource/texture/index.js +15 -15
- package/dist/resource/texture/texturePipelineBehavior.js +308 -308
- package/dist/worker/CjsResManMainThreadLoader.js +89 -89
- package/dist/worker/CjsResManWorker.js +218 -218
- package/dist/worker/CjsResManWorkerLoader.js +437 -437
- package/dist/worker/protocol.js +12 -12
- package/docs/README.md +98 -98
- package/docs/architecture.md +118 -118
- package/docs/concepts/resource-lifecycle.md +226 -226
- package/docs/concepts/shader-resource-model.md +111 -111
- package/docs/concepts/writing-an-engine-adapter.md +115 -115
- package/docs/formats/README.md +138 -138
- package/docs/formats/carbon-effect-container.md +553 -553
- package/docs/formats/dxbc/README.md +68 -68
- package/docs/formats/dxbc/architecture.md +80 -80
- package/docs/formats/dxbc/reference/api.md +105 -77
- package/docs/formats/dxbc/reference/classes/README.md +9 -9
- package/docs/formats/dxbc/reference/decoded-output.md +122 -122
- package/docs/formats/gr2.md +160 -160
- package/docs/formats/hlsl/README.md +54 -54
- package/docs/formats/hlsl/architecture.md +66 -65
- package/docs/formats/hlsl/guides/hydrating-json-output.md +60 -60
- package/docs/formats/hlsl/guides/reading-effects.md +68 -64
- package/docs/formats/hlsl/reference/advanced-analysis.md +61 -61
- package/docs/formats/hlsl/reference/api.md +91 -92
- package/docs/formats/hlsl/reference/classes/README.md +11 -11
- package/docs/formats/hlsl/reference/json-graph.md +97 -97
- package/docs/formats/pickle.md +82 -82
- package/docs/formats/provenance.md +196 -196
- package/docs/formats/stl.md +37 -37
- package/docs/formats/webgl/README.md +115 -115
- package/docs/formats/webgl/architecture.md +69 -69
- package/docs/formats/webgl/carbon-constant-layouts.md +326 -326
- package/docs/formats/webgl/decl-io.md +1234 -1234
- package/docs/formats/webgl/memory-structured.md +890 -890
- package/docs/formats/webgl/reference/classes/README.md +9 -9
- package/docs/formats/webgl/texture-sample.md +964 -964
- package/docs/formats/webgpu/README.md +84 -84
- package/docs/formats/webgpu/architecture.md +95 -95
- package/docs/formats/webgpu/formats/carbon-webgpu.md +215 -215
- package/docs/formats/webgpu/guides/effect-packaging.md +189 -189
- package/docs/formats/webgpu/reference/api.md +196 -196
- package/docs/formats/webgpu/reference/classes/README.md +9 -9
- package/docs/formats/webgpu/reference/wgsl-compatibility.md +1546 -1546
- package/docs/formats/wwise.md +146 -146
- package/docs/reference/classes/README.md +35 -35
- package/docs/reference/classes/audio.md +30 -30
- package/docs/reference/classes/core.md +216 -216
- package/docs/reference/classes/dropped.md +46 -46
- package/docs/reference/classes/formats.md +944 -944
- package/docs/reference/classes/resources.md +456 -456
- package/docs/reference/classes/texture.md +26 -26
- package/docs/reference/events.md +117 -117
- package/docs/reference/motherlode-cache.md +275 -275
- package/docs/reference/queues.md +194 -194
- package/docs/reference/reload.md +107 -107
- package/docs/reference/texture-arrays.md +113 -113
- package/docs/reference/texture-pipeline.md +53 -53
- package/docs/reference/workers.md +142 -142
- package/docs/roadmap.md +150 -150
- package/format-notices/black/LICENSE +21 -21
- package/format-notices/black/NOTICE +47 -47
- package/format-notices/bnk/LICENSE +21 -21
- package/format-notices/bnk/NOTICE +21 -21
- package/format-notices/cmf/LICENSE +21 -21
- package/format-notices/cmf/NOTICE +36 -36
- package/format-notices/dds/LICENSE +21 -21
- package/format-notices/dds/NOTICE +14 -14
- package/format-notices/dxbc/LICENSE +21 -21
- package/format-notices/dxbc/NOTICE +20 -20
- package/format-notices/fbx/LICENSE +21 -21
- package/format-notices/fbx/NOTICE +14 -14
- package/format-notices/flac/LICENSE +21 -21
- package/format-notices/flac/NOTICE +14 -14
- package/format-notices/gif/LICENSE +21 -21
- package/format-notices/gif/NOTICE +14 -14
- package/format-notices/gltf/LICENSE +21 -21
- package/format-notices/gltf/NOTICE +27 -27
- package/format-notices/gr2/LICENSE +21 -21
- package/format-notices/gr2/NOTICE +60 -60
- package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -93
- package/format-notices/hlsl/LICENSE +21 -21
- package/format-notices/hlsl/NOTICE +25 -25
- package/format-notices/jpeg/LICENSE +21 -21
- package/format-notices/jpeg/NOTICE +14 -14
- package/format-notices/mp3/LICENSE +21 -21
- package/format-notices/mp3/NOTICE +14 -14
- package/format-notices/mp4/LICENSE +21 -21
- package/format-notices/mp4/NOTICE +14 -14
- package/format-notices/obj/LICENSE +21 -21
- package/format-notices/obj/NOTICE +26 -26
- package/format-notices/ogg/LICENSE +21 -21
- package/format-notices/ogg/NOTICE +28 -28
- package/format-notices/png/LICENSE +21 -21
- package/format-notices/png/NOTICE +14 -14
- package/format-notices/red/LICENSE +21 -21
- package/format-notices/red/NOTICE +31 -31
- package/format-notices/stl/LICENSE +21 -21
- package/format-notices/stl/NOTICE +21 -21
- package/format-notices/tga/LICENSE +21 -21
- package/format-notices/tga/NOTICE +14 -14
- package/format-notices/wav/LICENSE +21 -21
- package/format-notices/wav/NOTICE +14 -14
- package/format-notices/webgl/LICENSE +21 -21
- package/format-notices/webgl/NOTICE +35 -35
- package/format-notices/webgpu/LICENSE +21 -21
- package/format-notices/webgpu/NOTICE +31 -31
- package/format-notices/webm/LICENSE +21 -21
- package/format-notices/webm/NOTICE +14 -14
- package/format-notices/webp/LICENSE +21 -21
- package/format-notices/webp/NOTICE +14 -14
- package/format-notices/wem/LICENSE +57 -57
- package/format-notices/wem/NOTICE +33 -33
- package/format-notices/yaml/LICENSE +21 -21
- package/format-notices/yaml/NOTICE +44 -44
- package/package.json +63 -63
|
@@ -1,400 +1,400 @@
|
|
|
1
|
-
import { LineCounter, parseDocument, isMap, isSeq, isScalar, isAlias, visit } from 'yaml';
|
|
2
|
-
import { CjsReader } from '../../../format/CjsReader.js';
|
|
3
|
-
import { toYamlSourceText, 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
|
-
|
|
28
|
-
/**
|
|
29
|
-
* Construction-bound reader that parses one YAML source with the `yaml`
|
|
30
|
-
* library and produces the format's payload, raw, or document graphs while
|
|
31
|
-
* enforcing tag policy and alias limits.
|
|
32
|
-
*/
|
|
33
|
-
class CjsYamlReader extends CjsReader {
|
|
34
|
-
/**
|
|
35
|
-
* Creates a CjsYamlReader over caller-provided YAML bytes and reader
|
|
36
|
-
* options.
|
|
37
|
-
*/
|
|
38
|
-
constructor(input, options = {}) {
|
|
39
|
-
super(options);
|
|
40
|
-
const source = toYamlSourceText(input, "CjsYamlFormat");
|
|
41
|
-
this.source = source;
|
|
42
|
-
this.lineCounter = new LineCounter();
|
|
43
|
-
this.document = parseDocument(source, {
|
|
44
|
-
keepSourceTokens: true,
|
|
45
|
-
lineCounter: this.lineCounter,
|
|
46
|
-
prettyErrors: true,
|
|
47
|
-
strict: true,
|
|
48
|
-
uniqueKeys: this.options.uniqueKeys
|
|
49
|
-
});
|
|
50
|
-
this.inventory = this.BuildInventory();
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
/**
|
|
54
|
-
* Reads the primary public payload representation from the supplied input
|
|
55
|
-
* for the YAML document reader.
|
|
56
|
-
*/
|
|
57
|
-
Read() {
|
|
58
|
-
return this.ReadPayload();
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
/** Reads payload from the current YAML document reader. */
|
|
62
|
-
ReadPayload() {
|
|
63
|
-
return toJsonGraph(this.ReadRaw(), this.options);
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
/** Reads raw from the current YAML document reader. */
|
|
67
|
-
ReadRaw() {
|
|
68
|
-
this.AssertSyntax();
|
|
69
|
-
this.AssertAliasLimit();
|
|
70
|
-
return this.Convert(this.document.contents, new Map());
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
/** Reads document from the current YAML document reader. */
|
|
74
|
-
ReadDocument() {
|
|
75
|
-
let value = null;
|
|
76
|
-
const errors = this.inventory.errors.slice();
|
|
77
|
-
if (!errors.length) {
|
|
78
|
-
try {
|
|
79
|
-
this.AssertAliasLimit();
|
|
80
|
-
value = this.Convert(this.document.contents, new Map());
|
|
81
|
-
} catch (error) {
|
|
82
|
-
errors.push(this.DescribeError(error));
|
|
83
|
-
}
|
|
84
|
-
}
|
|
85
|
-
return {
|
|
86
|
-
format: {
|
|
87
|
-
id: "yaml"
|
|
88
|
-
},
|
|
89
|
-
source: {
|
|
90
|
-
name: this.options.sourceName,
|
|
91
|
-
length: this.source.length
|
|
92
|
-
},
|
|
93
|
-
root: {
|
|
94
|
-
kind: this.RootKind()
|
|
95
|
-
},
|
|
96
|
-
value,
|
|
97
|
-
tags: this.inventory.tags,
|
|
98
|
-
anchors: this.inventory.anchors,
|
|
99
|
-
aliases: this.inventory.aliases,
|
|
100
|
-
warnings: this.inventory.warnings,
|
|
101
|
-
errors
|
|
102
|
-
};
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
/**
|
|
106
|
-
* Returns structural metadata without materializing the decoded payload for
|
|
107
|
-
* the YAML document reader.
|
|
108
|
-
*/
|
|
109
|
-
Inspect() {
|
|
110
|
-
return {
|
|
111
|
-
format: {
|
|
112
|
-
id: "yaml"
|
|
113
|
-
},
|
|
114
|
-
source: {
|
|
115
|
-
name: this.options.sourceName,
|
|
116
|
-
length: this.source.length
|
|
117
|
-
},
|
|
118
|
-
root: {
|
|
119
|
-
kind: this.RootKind()
|
|
120
|
-
},
|
|
121
|
-
tags: this.inventory.tags,
|
|
122
|
-
anchors: this.inventory.anchors,
|
|
123
|
-
aliases: this.inventory.aliases,
|
|
124
|
-
warnings: this.inventory.warnings,
|
|
125
|
-
errors: this.inventory.errors
|
|
126
|
-
};
|
|
127
|
-
}
|
|
128
|
-
|
|
129
|
-
/**
|
|
130
|
-
* Classifies the root YAML node before conversion for the YAML document
|
|
131
|
-
* reader.
|
|
132
|
-
*/
|
|
133
|
-
RootKind() {
|
|
134
|
-
const node = this.document.contents;
|
|
135
|
-
if (node === null) return "null";
|
|
136
|
-
if (isMap(node)) return "mapping";
|
|
137
|
-
if (isSeq(node)) return "sequence";
|
|
138
|
-
if (isScalar(node)) return "scalar";
|
|
139
|
-
if (isAlias(node)) return "alias";
|
|
140
|
-
return "unknown";
|
|
141
|
-
}
|
|
142
|
-
|
|
143
|
-
/**
|
|
144
|
-
* Validates syntax against YAML document reader constraints and throws on
|
|
145
|
-
* failure.
|
|
146
|
-
*/
|
|
147
|
-
AssertSyntax() {
|
|
148
|
-
if (!this.document.errors.length) return;
|
|
149
|
-
const first = this.document.errors[0];
|
|
150
|
-
const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
|
|
151
|
-
throw new SyntaxError(`CjsYamlFormat${source}: ${displayMessage(first)}`);
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
/**
|
|
155
|
-
* Validates alias limit against YAML document reader constraints and throws
|
|
156
|
-
* on failure.
|
|
157
|
-
*/
|
|
158
|
-
AssertAliasLimit() {
|
|
159
|
-
if (this.inventory.aliases.length <= this.options.maxAliasCount) return;
|
|
160
|
-
const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
|
|
161
|
-
throw new RangeError(`CjsYamlFormat${source}: alias count ${this.inventory.aliases.length} exceeds maxAliasCount ${this.options.maxAliasCount}`);
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
/**
|
|
165
|
-
* Converts the current value into the normalized YAML document reader
|
|
166
|
-
* representation.
|
|
167
|
-
*/
|
|
168
|
-
Convert(node, memo) {
|
|
169
|
-
if (node === null || node === undefined) return null;
|
|
170
|
-
if (isAlias(node)) {
|
|
171
|
-
const source = node.resolve(this.document);
|
|
172
|
-
if (!source) throw this.NodeError(node, `unresolved alias "${node.source}"`);
|
|
173
|
-
return this.Convert(source, memo);
|
|
174
|
-
}
|
|
175
|
-
if (memo.has(node)) return memo.get(node);
|
|
176
|
-
const tag = this.CustomTag(node);
|
|
177
|
-
if (tag) {
|
|
178
|
-
this.AssertTagAllowed(tag, node);
|
|
179
|
-
const handler = this.FindTagHandler(tag);
|
|
180
|
-
if (handler) {
|
|
181
|
-
const value = this.ConvertBase(node, memo, true);
|
|
182
|
-
const handled = handler(value, this.TagContext(tag, node));
|
|
183
|
-
memo.set(node, handled);
|
|
184
|
-
return handled;
|
|
185
|
-
}
|
|
186
|
-
if (tag === PYTHON_TUPLE) {
|
|
187
|
-
if (!isSeq(node)) throw this.NodeError(node, `${tag} must decorate a sequence`);
|
|
188
|
-
return this.ConvertBase(node, memo, true);
|
|
189
|
-
}
|
|
190
|
-
if (tag === PYTHON_UNICODE) {
|
|
191
|
-
if (!isScalar(node) || typeof node.value !== "string") {
|
|
192
|
-
throw this.NodeError(node, `${tag} must decorate a string scalar`);
|
|
193
|
-
}
|
|
194
|
-
return node.value;
|
|
195
|
-
}
|
|
196
|
-
if (this.options.tagPolicy === TAG_REJECT) {
|
|
197
|
-
throw this.NodeError(node, `custom tag "${tag}" is rejected by tagPolicy`);
|
|
198
|
-
}
|
|
199
|
-
if (this.options.tagPolicy === TAG_HANDLE) {
|
|
200
|
-
throw this.NodeError(node, `custom tag "${tag}" has no explicit handler`);
|
|
201
|
-
}
|
|
202
|
-
if (this.options.tagPolicy === TAG_PRESERVE || tag === PYTHON_PROJECTED_DECAL || tag === PYTHON_PART_METADATA) {
|
|
203
|
-
const wrapper = {
|
|
204
|
-
[this.options.tagField]: tag
|
|
205
|
-
};
|
|
206
|
-
memo.set(node, wrapper);
|
|
207
|
-
wrapper[this.options.valueField] = this.ConvertBase(node, memo, false);
|
|
208
|
-
return wrapper;
|
|
209
|
-
}
|
|
210
|
-
}
|
|
211
|
-
return this.ConvertBase(node, memo, true);
|
|
212
|
-
}
|
|
213
|
-
|
|
214
|
-
/** Converts base into the normalized YAML document reader representation. */
|
|
215
|
-
ConvertBase(node, memo, memoize) {
|
|
216
|
-
if (isScalar(node)) return node.value;
|
|
217
|
-
if (isSeq(node)) {
|
|
218
|
-
const out = [];
|
|
219
|
-
if (memoize) memo.set(node, out);
|
|
220
|
-
for (const item of node.items) out.push(this.Convert(item, memo));
|
|
221
|
-
return out;
|
|
222
|
-
}
|
|
223
|
-
if (isMap(node)) {
|
|
224
|
-
const out = {};
|
|
225
|
-
if (memoize) memo.set(node, out);
|
|
226
|
-
for (const pair of node.items) {
|
|
227
|
-
const key = this.MapKey(pair.key);
|
|
228
|
-
if (this.options.uniqueKeys && Object.prototype.hasOwnProperty.call(out, key)) {
|
|
229
|
-
throw this.NodeError(pair.key, `duplicate mapping key "${key}"`);
|
|
230
|
-
}
|
|
231
|
-
// Defining the property prevents keys such as "__proto__" from
|
|
232
|
-
// mutating the result object's prototype.
|
|
233
|
-
defineMappingValue(out, key, this.Convert(pair.value, memo));
|
|
234
|
-
}
|
|
235
|
-
return out;
|
|
236
|
-
}
|
|
237
|
-
throw this.NodeError(node, "unsupported YAML node");
|
|
238
|
-
}
|
|
239
|
-
|
|
240
|
-
/**
|
|
241
|
-
* Converts a YAML mapping key into its JavaScript property representation
|
|
242
|
-
* for the YAML document reader.
|
|
243
|
-
*/
|
|
244
|
-
MapKey(node) {
|
|
245
|
-
if (!isScalar(node)) throw this.NodeError(node, "mapping keys must be scalar values");
|
|
246
|
-
return String(node.value);
|
|
247
|
-
}
|
|
248
|
-
|
|
249
|
-
/**
|
|
250
|
-
* Converts a YAML custom-tag node through its registered handler for the
|
|
251
|
-
* YAML document reader.
|
|
252
|
-
*/
|
|
253
|
-
CustomTag(node) {
|
|
254
|
-
const tag = canonicalTag(node.tag);
|
|
255
|
-
return tag && !STANDARD_TAGS.has(tag) ? tag : null;
|
|
256
|
-
}
|
|
257
|
-
|
|
258
|
-
/**
|
|
259
|
-
* Validates tag allowed against YAML document reader constraints and throws
|
|
260
|
-
* on failure.
|
|
261
|
-
*/
|
|
262
|
-
AssertTagAllowed(tag, node) {
|
|
263
|
-
if (!this.options.allowedTags) return;
|
|
264
|
-
const allowed = new Set(this.options.allowedTags.map(canonicalTag));
|
|
265
|
-
if (!allowed.has(tag)) throw this.NodeError(node, `custom tag "${tag}" is not in allowedTags`);
|
|
266
|
-
}
|
|
267
|
-
|
|
268
|
-
/** Finds tag handler in the current YAML document reader. */
|
|
269
|
-
FindTagHandler(tag) {
|
|
270
|
-
const handlers = this.options.tagHandlers;
|
|
271
|
-
const short = tag.startsWith(TAG_PREFIX) ? `!!${tag.slice(TAG_PREFIX.length)}` : tag;
|
|
272
|
-
if (handlers instanceof Map) return handlers.get(tag) || handlers.get(short) || null;
|
|
273
|
-
return handlers[tag] || handlers[short] || null;
|
|
274
|
-
}
|
|
275
|
-
|
|
276
|
-
/**
|
|
277
|
-
* Builds the context passed to a YAML custom-tag handler for the YAML
|
|
278
|
-
* document reader.
|
|
279
|
-
*/
|
|
280
|
-
TagContext(tag, node) {
|
|
281
|
-
return {
|
|
282
|
-
tag,
|
|
283
|
-
sourceName: this.options.sourceName,
|
|
284
|
-
location: this.TagLocation(node)
|
|
285
|
-
};
|
|
286
|
-
}
|
|
287
|
-
|
|
288
|
-
/**
|
|
289
|
-
* Creates a YAML conversion error annotated with node location for the YAML
|
|
290
|
-
* document reader.
|
|
291
|
-
*/
|
|
292
|
-
NodeError(node, message) {
|
|
293
|
-
const at = node && node.tag ? this.TagLocation(node) : this.Location(node);
|
|
294
|
-
const source = this.options.sourceName ? `${this.options.sourceName}:` : "";
|
|
295
|
-
const where = at ? `${source}${at.line}:${at.column}` : this.options.sourceName || "YAML input";
|
|
296
|
-
const error = new Error(`CjsYamlFormat ${where}: ${message}`);
|
|
297
|
-
error.code = "YAML_TAG_POLICY";
|
|
298
|
-
error.location = at;
|
|
299
|
-
return error;
|
|
300
|
-
}
|
|
301
|
-
|
|
302
|
-
/**
|
|
303
|
-
* Returns normalized source-location metadata for a YAML node for the YAML
|
|
304
|
-
* document reader.
|
|
305
|
-
*/
|
|
306
|
-
Location(node) {
|
|
307
|
-
if (!node || !Array.isArray(node.range)) return null;
|
|
308
|
-
const pos = this.lineCounter.linePos(node.range[0]);
|
|
309
|
-
return {
|
|
310
|
-
offset: node.range[0],
|
|
311
|
-
line: pos.line,
|
|
312
|
-
column: pos.col
|
|
313
|
-
};
|
|
314
|
-
}
|
|
315
|
-
|
|
316
|
-
/**
|
|
317
|
-
* Returns normalized source-location metadata for a YAML tag for the YAML
|
|
318
|
-
* document reader.
|
|
319
|
-
*/
|
|
320
|
-
TagLocation(node) {
|
|
321
|
-
const fallback = this.Location(node);
|
|
322
|
-
if (!fallback || !node.tag) return fallback;
|
|
323
|
-
const lineStart = this.source.lastIndexOf("\n", node.range[0] - 1) + 1;
|
|
324
|
-
const prefix = this.source.slice(lineStart, node.range[0]);
|
|
325
|
-
const tags = [...prefix.matchAll(/!<[^>]+>|!!?[^\s[\]{},]+/g)];
|
|
326
|
-
const match = tags[tags.length - 1];
|
|
327
|
-
if (!match) return fallback;
|
|
328
|
-
const offset = lineStart + match.index;
|
|
329
|
-
const pos = this.lineCounter.linePos(offset);
|
|
330
|
-
return {
|
|
331
|
-
offset,
|
|
332
|
-
line: pos.line,
|
|
333
|
-
column: pos.col
|
|
334
|
-
};
|
|
335
|
-
}
|
|
336
|
-
|
|
337
|
-
/**
|
|
338
|
-
* Builds a public description of error from the current YAML document
|
|
339
|
-
* reader.
|
|
340
|
-
*/
|
|
341
|
-
DescribeError(error) {
|
|
342
|
-
const linePos = error && error.linePos && error.linePos[0];
|
|
343
|
-
return {
|
|
344
|
-
code: error && error.code ? error.code : "YAML_ERROR",
|
|
345
|
-
message: displayMessage(error),
|
|
346
|
-
location: error && error.location ? error.location : linePos ? {
|
|
347
|
-
line: linePos.line,
|
|
348
|
-
column: linePos.col
|
|
349
|
-
} : null
|
|
350
|
-
};
|
|
351
|
-
}
|
|
352
|
-
|
|
353
|
-
/** Builds inventory for the current YAML document reader. */
|
|
354
|
-
BuildInventory() {
|
|
355
|
-
const tags = [];
|
|
356
|
-
const anchors = [];
|
|
357
|
-
const aliases = [];
|
|
358
|
-
visit(this.document, (_key, node) => {
|
|
359
|
-
if (!node || typeof node !== "object") return;
|
|
360
|
-
const tag = this.CustomTag(node);
|
|
361
|
-
const location = tag ? this.TagLocation(node) : this.Location(node);
|
|
362
|
-
if (tag) tags.push({
|
|
363
|
-
tag,
|
|
364
|
-
kind: this.NodeKind(node),
|
|
365
|
-
location
|
|
366
|
-
});
|
|
367
|
-
if (node.anchor) anchors.push({
|
|
368
|
-
name: node.anchor,
|
|
369
|
-
kind: this.NodeKind(node),
|
|
370
|
-
location
|
|
371
|
-
});
|
|
372
|
-
if (isAlias(node)) aliases.push({
|
|
373
|
-
name: node.source,
|
|
374
|
-
location
|
|
375
|
-
});
|
|
376
|
-
});
|
|
377
|
-
return {
|
|
378
|
-
tags,
|
|
379
|
-
anchors,
|
|
380
|
-
aliases,
|
|
381
|
-
warnings: this.document.warnings.map(error => this.DescribeError(error)),
|
|
382
|
-
errors: this.document.errors.map(error => this.DescribeError(error))
|
|
383
|
-
};
|
|
384
|
-
}
|
|
385
|
-
|
|
386
|
-
/**
|
|
387
|
-
* Returns the public kind label for a YAML node for the YAML document
|
|
388
|
-
* reader.
|
|
389
|
-
*/
|
|
390
|
-
NodeKind(node) {
|
|
391
|
-
if (isMap(node)) return "mapping";
|
|
392
|
-
if (isSeq(node)) return "sequence";
|
|
393
|
-
if (isScalar(node)) return "scalar";
|
|
394
|
-
if (isAlias(node)) return "alias";
|
|
395
|
-
return "unknown";
|
|
396
|
-
}
|
|
397
|
-
}
|
|
398
|
-
|
|
399
|
-
export { CjsYamlReader };
|
|
400
|
-
//# sourceMappingURL=CjsYamlReader.js.map
|
|
1
|
+
import { LineCounter, parseDocument, isMap, isSeq, isScalar, isAlias, visit } from 'yaml';
|
|
2
|
+
import { CjsReader } from '../../../format/CjsReader.js';
|
|
3
|
+
import { toYamlSourceText, 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
|
+
|
|
28
|
+
/**
|
|
29
|
+
* Construction-bound reader that parses one YAML source with the `yaml`
|
|
30
|
+
* library and produces the format's payload, raw, or document graphs while
|
|
31
|
+
* enforcing tag policy and alias limits.
|
|
32
|
+
*/
|
|
33
|
+
class CjsYamlReader extends CjsReader {
|
|
34
|
+
/**
|
|
35
|
+
* Creates a CjsYamlReader over caller-provided YAML bytes and reader
|
|
36
|
+
* options.
|
|
37
|
+
*/
|
|
38
|
+
constructor(input, options = {}) {
|
|
39
|
+
super(options);
|
|
40
|
+
const source = toYamlSourceText(input, "CjsYamlFormat");
|
|
41
|
+
this.source = source;
|
|
42
|
+
this.lineCounter = new LineCounter();
|
|
43
|
+
this.document = parseDocument(source, {
|
|
44
|
+
keepSourceTokens: true,
|
|
45
|
+
lineCounter: this.lineCounter,
|
|
46
|
+
prettyErrors: true,
|
|
47
|
+
strict: true,
|
|
48
|
+
uniqueKeys: this.options.uniqueKeys
|
|
49
|
+
});
|
|
50
|
+
this.inventory = this.BuildInventory();
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* Reads the primary public payload representation from the supplied input
|
|
55
|
+
* for the YAML document reader.
|
|
56
|
+
*/
|
|
57
|
+
Read() {
|
|
58
|
+
return this.ReadPayload();
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** Reads payload from the current YAML document reader. */
|
|
62
|
+
ReadPayload() {
|
|
63
|
+
return toJsonGraph(this.ReadRaw(), this.options);
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** Reads raw from the current YAML document reader. */
|
|
67
|
+
ReadRaw() {
|
|
68
|
+
this.AssertSyntax();
|
|
69
|
+
this.AssertAliasLimit();
|
|
70
|
+
return this.Convert(this.document.contents, new Map());
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/** Reads document from the current YAML document reader. */
|
|
74
|
+
ReadDocument() {
|
|
75
|
+
let value = null;
|
|
76
|
+
const errors = this.inventory.errors.slice();
|
|
77
|
+
if (!errors.length) {
|
|
78
|
+
try {
|
|
79
|
+
this.AssertAliasLimit();
|
|
80
|
+
value = this.Convert(this.document.contents, new Map());
|
|
81
|
+
} catch (error) {
|
|
82
|
+
errors.push(this.DescribeError(error));
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
return {
|
|
86
|
+
format: {
|
|
87
|
+
id: "yaml"
|
|
88
|
+
},
|
|
89
|
+
source: {
|
|
90
|
+
name: this.options.sourceName,
|
|
91
|
+
length: this.source.length
|
|
92
|
+
},
|
|
93
|
+
root: {
|
|
94
|
+
kind: this.RootKind()
|
|
95
|
+
},
|
|
96
|
+
value,
|
|
97
|
+
tags: this.inventory.tags,
|
|
98
|
+
anchors: this.inventory.anchors,
|
|
99
|
+
aliases: this.inventory.aliases,
|
|
100
|
+
warnings: this.inventory.warnings,
|
|
101
|
+
errors
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* Returns structural metadata without materializing the decoded payload for
|
|
107
|
+
* the YAML document reader.
|
|
108
|
+
*/
|
|
109
|
+
Inspect() {
|
|
110
|
+
return {
|
|
111
|
+
format: {
|
|
112
|
+
id: "yaml"
|
|
113
|
+
},
|
|
114
|
+
source: {
|
|
115
|
+
name: this.options.sourceName,
|
|
116
|
+
length: this.source.length
|
|
117
|
+
},
|
|
118
|
+
root: {
|
|
119
|
+
kind: this.RootKind()
|
|
120
|
+
},
|
|
121
|
+
tags: this.inventory.tags,
|
|
122
|
+
anchors: this.inventory.anchors,
|
|
123
|
+
aliases: this.inventory.aliases,
|
|
124
|
+
warnings: this.inventory.warnings,
|
|
125
|
+
errors: this.inventory.errors
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* Classifies the root YAML node before conversion for the YAML document
|
|
131
|
+
* reader.
|
|
132
|
+
*/
|
|
133
|
+
RootKind() {
|
|
134
|
+
const node = this.document.contents;
|
|
135
|
+
if (node === null) return "null";
|
|
136
|
+
if (isMap(node)) return "mapping";
|
|
137
|
+
if (isSeq(node)) return "sequence";
|
|
138
|
+
if (isScalar(node)) return "scalar";
|
|
139
|
+
if (isAlias(node)) return "alias";
|
|
140
|
+
return "unknown";
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Validates syntax against YAML document reader constraints and throws on
|
|
145
|
+
* failure.
|
|
146
|
+
*/
|
|
147
|
+
AssertSyntax() {
|
|
148
|
+
if (!this.document.errors.length) return;
|
|
149
|
+
const first = this.document.errors[0];
|
|
150
|
+
const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
|
|
151
|
+
throw new SyntaxError(`CjsYamlFormat${source}: ${displayMessage(first)}`);
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* Validates alias limit against YAML document reader constraints and throws
|
|
156
|
+
* on failure.
|
|
157
|
+
*/
|
|
158
|
+
AssertAliasLimit() {
|
|
159
|
+
if (this.inventory.aliases.length <= this.options.maxAliasCount) return;
|
|
160
|
+
const source = this.options.sourceName ? ` in ${this.options.sourceName}` : "";
|
|
161
|
+
throw new RangeError(`CjsYamlFormat${source}: alias count ${this.inventory.aliases.length} exceeds maxAliasCount ${this.options.maxAliasCount}`);
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/**
|
|
165
|
+
* Converts the current value into the normalized YAML document reader
|
|
166
|
+
* representation.
|
|
167
|
+
*/
|
|
168
|
+
Convert(node, memo) {
|
|
169
|
+
if (node === null || node === undefined) return null;
|
|
170
|
+
if (isAlias(node)) {
|
|
171
|
+
const source = node.resolve(this.document);
|
|
172
|
+
if (!source) throw this.NodeError(node, `unresolved alias "${node.source}"`);
|
|
173
|
+
return this.Convert(source, memo);
|
|
174
|
+
}
|
|
175
|
+
if (memo.has(node)) return memo.get(node);
|
|
176
|
+
const tag = this.CustomTag(node);
|
|
177
|
+
if (tag) {
|
|
178
|
+
this.AssertTagAllowed(tag, node);
|
|
179
|
+
const handler = this.FindTagHandler(tag);
|
|
180
|
+
if (handler) {
|
|
181
|
+
const value = this.ConvertBase(node, memo, true);
|
|
182
|
+
const handled = handler(value, this.TagContext(tag, node));
|
|
183
|
+
memo.set(node, handled);
|
|
184
|
+
return handled;
|
|
185
|
+
}
|
|
186
|
+
if (tag === PYTHON_TUPLE) {
|
|
187
|
+
if (!isSeq(node)) throw this.NodeError(node, `${tag} must decorate a sequence`);
|
|
188
|
+
return this.ConvertBase(node, memo, true);
|
|
189
|
+
}
|
|
190
|
+
if (tag === PYTHON_UNICODE) {
|
|
191
|
+
if (!isScalar(node) || typeof node.value !== "string") {
|
|
192
|
+
throw this.NodeError(node, `${tag} must decorate a string scalar`);
|
|
193
|
+
}
|
|
194
|
+
return node.value;
|
|
195
|
+
}
|
|
196
|
+
if (this.options.tagPolicy === TAG_REJECT) {
|
|
197
|
+
throw this.NodeError(node, `custom tag "${tag}" is rejected by tagPolicy`);
|
|
198
|
+
}
|
|
199
|
+
if (this.options.tagPolicy === TAG_HANDLE) {
|
|
200
|
+
throw this.NodeError(node, `custom tag "${tag}" has no explicit handler`);
|
|
201
|
+
}
|
|
202
|
+
if (this.options.tagPolicy === TAG_PRESERVE || tag === PYTHON_PROJECTED_DECAL || tag === PYTHON_PART_METADATA) {
|
|
203
|
+
const wrapper = {
|
|
204
|
+
[this.options.tagField]: tag
|
|
205
|
+
};
|
|
206
|
+
memo.set(node, wrapper);
|
|
207
|
+
wrapper[this.options.valueField] = this.ConvertBase(node, memo, false);
|
|
208
|
+
return wrapper;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
return this.ConvertBase(node, memo, true);
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/** Converts base into the normalized YAML document reader representation. */
|
|
215
|
+
ConvertBase(node, memo, memoize) {
|
|
216
|
+
if (isScalar(node)) return node.value;
|
|
217
|
+
if (isSeq(node)) {
|
|
218
|
+
const out = [];
|
|
219
|
+
if (memoize) memo.set(node, out);
|
|
220
|
+
for (const item of node.items) out.push(this.Convert(item, memo));
|
|
221
|
+
return out;
|
|
222
|
+
}
|
|
223
|
+
if (isMap(node)) {
|
|
224
|
+
const out = {};
|
|
225
|
+
if (memoize) memo.set(node, out);
|
|
226
|
+
for (const pair of node.items) {
|
|
227
|
+
const key = this.MapKey(pair.key);
|
|
228
|
+
if (this.options.uniqueKeys && Object.prototype.hasOwnProperty.call(out, key)) {
|
|
229
|
+
throw this.NodeError(pair.key, `duplicate mapping key "${key}"`);
|
|
230
|
+
}
|
|
231
|
+
// Defining the property prevents keys such as "__proto__" from
|
|
232
|
+
// mutating the result object's prototype.
|
|
233
|
+
defineMappingValue(out, key, this.Convert(pair.value, memo));
|
|
234
|
+
}
|
|
235
|
+
return out;
|
|
236
|
+
}
|
|
237
|
+
throw this.NodeError(node, "unsupported YAML node");
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
/**
|
|
241
|
+
* Converts a YAML mapping key into its JavaScript property representation
|
|
242
|
+
* for the YAML document reader.
|
|
243
|
+
*/
|
|
244
|
+
MapKey(node) {
|
|
245
|
+
if (!isScalar(node)) throw this.NodeError(node, "mapping keys must be scalar values");
|
|
246
|
+
return String(node.value);
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/**
|
|
250
|
+
* Converts a YAML custom-tag node through its registered handler for the
|
|
251
|
+
* YAML document reader.
|
|
252
|
+
*/
|
|
253
|
+
CustomTag(node) {
|
|
254
|
+
const tag = canonicalTag(node.tag);
|
|
255
|
+
return tag && !STANDARD_TAGS.has(tag) ? tag : null;
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/**
|
|
259
|
+
* Validates tag allowed against YAML document reader constraints and throws
|
|
260
|
+
* on failure.
|
|
261
|
+
*/
|
|
262
|
+
AssertTagAllowed(tag, node) {
|
|
263
|
+
if (!this.options.allowedTags) return;
|
|
264
|
+
const allowed = new Set(this.options.allowedTags.map(canonicalTag));
|
|
265
|
+
if (!allowed.has(tag)) throw this.NodeError(node, `custom tag "${tag}" is not in allowedTags`);
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
/** Finds tag handler in the current YAML document reader. */
|
|
269
|
+
FindTagHandler(tag) {
|
|
270
|
+
const handlers = this.options.tagHandlers;
|
|
271
|
+
const short = tag.startsWith(TAG_PREFIX) ? `!!${tag.slice(TAG_PREFIX.length)}` : tag;
|
|
272
|
+
if (handlers instanceof Map) return handlers.get(tag) || handlers.get(short) || null;
|
|
273
|
+
return handlers[tag] || handlers[short] || null;
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
/**
|
|
277
|
+
* Builds the context passed to a YAML custom-tag handler for the YAML
|
|
278
|
+
* document reader.
|
|
279
|
+
*/
|
|
280
|
+
TagContext(tag, node) {
|
|
281
|
+
return {
|
|
282
|
+
tag,
|
|
283
|
+
sourceName: this.options.sourceName,
|
|
284
|
+
location: this.TagLocation(node)
|
|
285
|
+
};
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* Creates a YAML conversion error annotated with node location for the YAML
|
|
290
|
+
* document reader.
|
|
291
|
+
*/
|
|
292
|
+
NodeError(node, message) {
|
|
293
|
+
const at = node && node.tag ? this.TagLocation(node) : this.Location(node);
|
|
294
|
+
const source = this.options.sourceName ? `${this.options.sourceName}:` : "";
|
|
295
|
+
const where = at ? `${source}${at.line}:${at.column}` : this.options.sourceName || "YAML input";
|
|
296
|
+
const error = new Error(`CjsYamlFormat ${where}: ${message}`);
|
|
297
|
+
error.code = "YAML_TAG_POLICY";
|
|
298
|
+
error.location = at;
|
|
299
|
+
return error;
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/**
|
|
303
|
+
* Returns normalized source-location metadata for a YAML node for the YAML
|
|
304
|
+
* document reader.
|
|
305
|
+
*/
|
|
306
|
+
Location(node) {
|
|
307
|
+
if (!node || !Array.isArray(node.range)) return null;
|
|
308
|
+
const pos = this.lineCounter.linePos(node.range[0]);
|
|
309
|
+
return {
|
|
310
|
+
offset: node.range[0],
|
|
311
|
+
line: pos.line,
|
|
312
|
+
column: pos.col
|
|
313
|
+
};
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
/**
|
|
317
|
+
* Returns normalized source-location metadata for a YAML tag for the YAML
|
|
318
|
+
* document reader.
|
|
319
|
+
*/
|
|
320
|
+
TagLocation(node) {
|
|
321
|
+
const fallback = this.Location(node);
|
|
322
|
+
if (!fallback || !node.tag) return fallback;
|
|
323
|
+
const lineStart = this.source.lastIndexOf("\n", node.range[0] - 1) + 1;
|
|
324
|
+
const prefix = this.source.slice(lineStart, node.range[0]);
|
|
325
|
+
const tags = [...prefix.matchAll(/!<[^>]+>|!!?[^\s[\]{},]+/g)];
|
|
326
|
+
const match = tags[tags.length - 1];
|
|
327
|
+
if (!match) return fallback;
|
|
328
|
+
const offset = lineStart + match.index;
|
|
329
|
+
const pos = this.lineCounter.linePos(offset);
|
|
330
|
+
return {
|
|
331
|
+
offset,
|
|
332
|
+
line: pos.line,
|
|
333
|
+
column: pos.col
|
|
334
|
+
};
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
/**
|
|
338
|
+
* Builds a public description of error from the current YAML document
|
|
339
|
+
* reader.
|
|
340
|
+
*/
|
|
341
|
+
DescribeError(error) {
|
|
342
|
+
const linePos = error && error.linePos && error.linePos[0];
|
|
343
|
+
return {
|
|
344
|
+
code: error && error.code ? error.code : "YAML_ERROR",
|
|
345
|
+
message: displayMessage(error),
|
|
346
|
+
location: error && error.location ? error.location : linePos ? {
|
|
347
|
+
line: linePos.line,
|
|
348
|
+
column: linePos.col
|
|
349
|
+
} : null
|
|
350
|
+
};
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
/** Builds inventory for the current YAML document reader. */
|
|
354
|
+
BuildInventory() {
|
|
355
|
+
const tags = [];
|
|
356
|
+
const anchors = [];
|
|
357
|
+
const aliases = [];
|
|
358
|
+
visit(this.document, (_key, node) => {
|
|
359
|
+
if (!node || typeof node !== "object") return;
|
|
360
|
+
const tag = this.CustomTag(node);
|
|
361
|
+
const location = tag ? this.TagLocation(node) : this.Location(node);
|
|
362
|
+
if (tag) tags.push({
|
|
363
|
+
tag,
|
|
364
|
+
kind: this.NodeKind(node),
|
|
365
|
+
location
|
|
366
|
+
});
|
|
367
|
+
if (node.anchor) anchors.push({
|
|
368
|
+
name: node.anchor,
|
|
369
|
+
kind: this.NodeKind(node),
|
|
370
|
+
location
|
|
371
|
+
});
|
|
372
|
+
if (isAlias(node)) aliases.push({
|
|
373
|
+
name: node.source,
|
|
374
|
+
location
|
|
375
|
+
});
|
|
376
|
+
});
|
|
377
|
+
return {
|
|
378
|
+
tags,
|
|
379
|
+
anchors,
|
|
380
|
+
aliases,
|
|
381
|
+
warnings: this.document.warnings.map(error => this.DescribeError(error)),
|
|
382
|
+
errors: this.document.errors.map(error => this.DescribeError(error))
|
|
383
|
+
};
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
/**
|
|
387
|
+
* Returns the public kind label for a YAML node for the YAML document
|
|
388
|
+
* reader.
|
|
389
|
+
*/
|
|
390
|
+
NodeKind(node) {
|
|
391
|
+
if (isMap(node)) return "mapping";
|
|
392
|
+
if (isSeq(node)) return "sequence";
|
|
393
|
+
if (isScalar(node)) return "scalar";
|
|
394
|
+
if (isAlias(node)) return "alias";
|
|
395
|
+
return "unknown";
|
|
396
|
+
}
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
export { CjsYamlReader };
|
|
400
|
+
//# sourceMappingURL=CjsYamlReader.js.map
|