@motionscript/core 0.1.0-alpha.7 → 0.1.0-alpha.9
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/CHANGELOG.md +12 -0
- package/LICENSE +201 -201
- package/NOTICE +49 -48
- package/README.md +91 -91
- package/dist/assets/asset-index.js.map +1 -1
- package/dist/assets/catalog.js.map +1 -1
- package/dist/assets/errors.js.map +1 -1
- package/dist/assets/index.js.map +1 -1
- package/dist/assets/manager.d.ts.map +1 -1
- package/dist/assets/manager.js +7 -5
- package/dist/assets/manager.js.map +1 -1
- package/dist/assets/manifest.js.map +1 -1
- package/dist/assets/record.js.map +1 -1
- package/dist/assets/scope.js.map +1 -1
- package/dist/attributes/audio/effects/chain.d.ts +73 -0
- package/dist/attributes/audio/effects/chain.d.ts.map +1 -0
- package/dist/attributes/audio/effects/chain.js +67 -0
- package/dist/attributes/audio/effects/chain.js.map +1 -0
- package/dist/attributes/audio/effects/implementations/echo.d.ts +14 -0
- package/dist/attributes/audio/effects/implementations/echo.d.ts.map +1 -0
- package/dist/attributes/audio/{filters → effects}/implementations/echo.js +2 -2
- package/dist/attributes/audio/effects/implementations/echo.js.map +1 -0
- package/dist/attributes/audio/effects/implementations/gain.d.ts +10 -0
- package/dist/attributes/audio/effects/implementations/gain.d.ts.map +1 -0
- package/dist/attributes/audio/{filters → effects}/implementations/gain.js +2 -2
- package/dist/attributes/audio/effects/implementations/gain.js.map +1 -0
- package/dist/attributes/audio/effects/implementations/highpass.d.ts +12 -0
- package/dist/attributes/audio/effects/implementations/highpass.d.ts.map +1 -0
- package/dist/attributes/audio/{filters → effects}/implementations/highpass.js +2 -2
- package/dist/attributes/audio/effects/implementations/highpass.js.map +1 -0
- package/dist/attributes/audio/effects/implementations/lowpass.d.ts +12 -0
- package/dist/attributes/audio/effects/implementations/lowpass.d.ts.map +1 -0
- package/dist/attributes/audio/{filters → effects}/implementations/lowpass.js +2 -2
- package/dist/attributes/audio/effects/implementations/lowpass.js.map +1 -0
- package/dist/attributes/audio/effects/implementations/tremolo.d.ts +12 -0
- package/dist/attributes/audio/effects/implementations/tremolo.d.ts.map +1 -0
- package/dist/attributes/audio/{filters → effects}/implementations/tremolo.js +2 -2
- package/dist/attributes/audio/effects/implementations/tremolo.js.map +1 -0
- package/dist/attributes/audio/effects/index.d.ts +12 -0
- package/dist/attributes/audio/effects/index.d.ts.map +1 -0
- package/dist/attributes/audio/effects/index.js +4 -0
- package/dist/attributes/audio/effects/index.js.map +1 -0
- package/dist/attributes/audio/effects/registry.d.ts +36 -0
- package/dist/attributes/audio/effects/registry.d.ts.map +1 -0
- package/dist/attributes/audio/effects/registry.js +80 -0
- package/dist/attributes/audio/effects/registry.js.map +1 -0
- package/dist/attributes/audio/effects/union.d.ts +14 -0
- package/dist/attributes/audio/effects/union.d.ts.map +1 -0
- package/dist/attributes/audio/effects/union.js +24 -0
- package/dist/attributes/audio/effects/union.js.map +1 -0
- package/dist/attributes/audio/ramp.d.ts +103 -0
- package/dist/attributes/audio/ramp.d.ts.map +1 -0
- package/dist/attributes/audio/ramp.js +246 -0
- package/dist/attributes/audio/ramp.js.map +1 -0
- package/dist/attributes/audio/request.d.ts +24 -13
- package/dist/attributes/audio/request.d.ts.map +1 -1
- package/dist/attributes/audio/request.js +4 -3
- package/dist/attributes/audio/request.js.map +1 -1
- package/dist/attributes/audio/schedule.d.ts +21 -13
- package/dist/attributes/audio/schedule.d.ts.map +1 -1
- package/dist/attributes/audio/schedule.js +42 -28
- package/dist/attributes/audio/schedule.js.map +1 -1
- package/dist/attributes/audio/sound.d.ts +15 -12
- package/dist/attributes/audio/sound.d.ts.map +1 -1
- package/dist/attributes/audio/sound.js +8 -10
- package/dist/attributes/audio/sound.js.map +1 -1
- package/dist/attributes/audio/transition.d.ts +33 -0
- package/dist/attributes/audio/transition.d.ts.map +1 -0
- package/dist/attributes/audio/transition.js +48 -0
- package/dist/attributes/audio/transition.js.map +1 -0
- package/dist/attributes/index.d.ts +4 -3
- package/dist/attributes/index.d.ts.map +1 -1
- package/dist/attributes/index.js +4 -7
- package/dist/attributes/index.js.map +1 -1
- package/dist/attributes/layout/alignment.js.map +1 -1
- package/dist/attributes/layout/index.js.map +1 -1
- package/dist/attributes/layout/insets.js.map +1 -1
- package/dist/attributes/layout/matrix2d.d.ts +2 -2
- package/dist/attributes/layout/matrix2d.js.map +1 -1
- package/dist/attributes/layout/size.js.map +1 -1
- package/dist/attributes/layout/space3d.js +1 -1
- package/dist/attributes/layout/space3d.js.map +1 -1
- package/dist/attributes/layout/transform3d.js.map +1 -1
- package/dist/attributes/layout/vector2.js.map +1 -1
- package/dist/attributes/layout/world-transform.js.map +1 -1
- package/dist/attributes/mask/boolean.js.map +1 -1
- package/dist/attributes/mask/mask.js.map +1 -1
- package/dist/attributes/properties/decorator.js.map +1 -1
- package/dist/attributes/properties/inputs.js.map +1 -1
- package/dist/attributes/properties/typed.d.ts +7 -7
- package/dist/attributes/properties/typed.d.ts.map +1 -1
- package/dist/attributes/properties/typed.js +6 -6
- package/dist/attributes/properties/typed.js.map +1 -1
- package/dist/attributes/render3d/orbit.js.map +1 -1
- package/dist/attributes/shape/corners/corner-radius.d.ts +1 -2
- package/dist/attributes/shape/corners/corner-radius.d.ts.map +1 -1
- package/dist/attributes/shape/corners/corner-radius.js +1 -2
- package/dist/attributes/shape/corners/corner-radius.js.map +1 -1
- package/dist/attributes/shape/corners/corner-style.js.map +1 -1
- package/dist/attributes/shape/corners/corners.js.map +1 -1
- package/dist/attributes/shape/corners/index.js.map +1 -1
- package/dist/attributes/shape/effects/backdrop.js.map +1 -1
- package/dist/attributes/shape/effects/chain.d.ts +96 -409
- package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
- package/dist/attributes/shape/effects/chain.js +93 -283
- package/dist/attributes/shape/effects/chain.js.map +1 -1
- package/dist/attributes/shape/effects/effect-data.d.ts +1 -1
- package/dist/attributes/shape/effects/effect-data.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/ascii.d.ts +45 -13
- package/dist/attributes/shape/effects/implementations/ascii.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/ascii.js +29 -23
- package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bit-crush.d.ts +32 -7
- package/dist/attributes/shape/effects/implementations/bit-crush.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/bit-crush.js +17 -15
- package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/block-displace.d.ts +46 -10
- package/dist/attributes/shape/effects/implementations/block-displace.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/block-displace.js +21 -19
- package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bloom.d.ts +32 -7
- package/dist/attributes/shape/effects/implementations/bloom.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/bloom.js +17 -11
- package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/blur.d.ts +16 -3
- package/dist/attributes/shape/effects/implementations/blur.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/blur.js +13 -5
- package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bulge.d.ts +28 -9
- package/dist/attributes/shape/effects/implementations/bulge.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/bulge.js +15 -14
- package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts +21 -5
- package/dist/attributes/shape/effects/implementations/chromatic-aberration.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/chromatic-aberration.js +15 -10
- package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +96 -26
- package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/color-adjustment.js +29 -26
- package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/curves.d.ts +20 -6
- package/dist/attributes/shape/effects/implementations/curves.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/curves.js +26 -23
- package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/directional-blur.d.ts +26 -5
- package/dist/attributes/shape/effects/implementations/directional-blur.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/directional-blur.js +15 -10
- package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/dither.d.ts +58 -11
- package/dist/attributes/shape/effects/implementations/dither.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/dither.js +26 -20
- package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts +46 -14
- package/dist/attributes/shape/effects/implementations/drop-shadow.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/drop-shadow.js +24 -29
- package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/duotone.d.ts +26 -7
- package/dist/attributes/shape/effects/implementations/duotone.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/duotone.js +17 -16
- package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/edges.d.ts +29 -7
- package/dist/attributes/shape/effects/implementations/edges.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/edges.js +17 -14
- package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/glass.d.ts +76 -19
- package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/glass.js +28 -22
- package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/glow.d.ts +149 -42
- package/dist/attributes/shape/effects/implementations/glow.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/glow.js +74 -72
- package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/grain.d.ts +43 -11
- package/dist/attributes/shape/effects/implementations/grain.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/grain.js +21 -18
- package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/grayscale.d.ts +17 -3
- package/dist/attributes/shape/effects/implementations/grayscale.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/grayscale.js +13 -5
- package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/halftone.d.ts +40 -9
- package/dist/attributes/shape/effects/implementations/halftone.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/halftone.js +20 -16
- package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/invert.d.ts +23 -5
- package/dist/attributes/shape/effects/implementations/invert.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/invert.js +15 -10
- package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts +57 -18
- package/dist/attributes/shape/effects/implementations/kaleidoscope.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/kaleidoscope.js +25 -22
- package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/lut.d.ts +34 -7
- package/dist/attributes/shape/effects/implementations/lut.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/lut.js +20 -16
- package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/magnify.d.ts +27 -9
- package/dist/attributes/shape/effects/implementations/magnify.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/magnify.js +17 -14
- package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/motion-blur.d.ts +54 -19
- package/dist/attributes/shape/effects/implementations/motion-blur.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/motion-blur.js +42 -20
- package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/oil-paint.d.ts +17 -3
- package/dist/attributes/shape/effects/implementations/oil-paint.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/oil-paint.js +13 -9
- package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/outline.d.ts +28 -8
- package/dist/attributes/shape/effects/implementations/outline.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/outline.js +18 -17
- package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/pixelate.d.ts +25 -6
- package/dist/attributes/shape/effects/implementations/pixelate.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/pixelate.js +16 -14
- package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/posterize.d.ts +14 -3
- package/dist/attributes/shape/effects/implementations/posterize.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/posterize.js +13 -9
- package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts +91 -26
- package/dist/attributes/shape/effects/implementations/progressive-blur.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/progressive-blur.js +27 -28
- package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/radial-blur.d.ts +49 -10
- package/dist/attributes/shape/effects/implementations/radial-blur.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/radial-blur.js +19 -20
- package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts +36 -6
- package/dist/attributes/shape/effects/implementations/rgb-shift.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/rgb-shift.js +16 -15
- package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/scanlines.d.ts +52 -11
- package/dist/attributes/shape/effects/implementations/scanlines.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/scanlines.js +21 -18
- package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/scatter.d.ts +23 -9
- package/dist/attributes/shape/effects/implementations/scatter.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/scatter.js +15 -12
- package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/shader.d.ts +90 -34
- package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/shader.js +42 -26
- package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/sharpen.d.ts +23 -5
- package/dist/attributes/shape/effects/implementations/sharpen.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/sharpen.js +16 -11
- package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/streak.d.ts +40 -9
- package/dist/attributes/shape/effects/implementations/streak.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/streak.js +19 -16
- package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/threshold.d.ts +24 -5
- package/dist/attributes/shape/effects/implementations/threshold.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/threshold.js +17 -11
- package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/twirl.d.ts +35 -8
- package/dist/attributes/shape/effects/implementations/twirl.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/twirl.js +17 -16
- package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/vignette.d.ts +37 -7
- package/dist/attributes/shape/effects/implementations/vignette.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/vignette.js +19 -18
- package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/vintage.d.ts +24 -5
- package/dist/attributes/shape/effects/implementations/vintage.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/vintage.js +15 -10
- package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/wave.d.ts +61 -14
- package/dist/attributes/shape/effects/implementations/wave.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/wave.js +26 -23
- package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
- package/dist/attributes/shape/effects/index.d.ts +4 -2
- package/dist/attributes/shape/effects/index.d.ts.map +1 -1
- package/dist/attributes/shape/effects/index.js +1 -1
- package/dist/attributes/shape/effects/index.js.map +1 -1
- package/dist/attributes/shape/effects/registry.d.ts +11 -0
- package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
- package/dist/attributes/shape/effects/registry.js +113 -102
- package/dist/attributes/shape/effects/registry.js.map +1 -1
- package/dist/attributes/shape/effects/spec.d.ts +229 -0
- package/dist/attributes/shape/effects/spec.d.ts.map +1 -0
- package/dist/attributes/shape/effects/spec.js +178 -0
- package/dist/attributes/shape/effects/spec.js.map +1 -0
- package/dist/attributes/shape/effects/union.js.map +1 -1
- package/dist/attributes/shape/fill/blend.js.map +1 -1
- package/dist/attributes/shape/fill/chain.d.ts +7 -9
- package/dist/attributes/shape/fill/chain.d.ts.map +1 -1
- package/dist/attributes/shape/fill/chain.js +9 -11
- package/dist/attributes/shape/fill/chain.js.map +1 -1
- package/dist/attributes/shape/fill/coerce.js.map +1 -1
- package/dist/attributes/shape/fill/color/constants.js.map +1 -1
- package/dist/attributes/shape/fill/color/parser.js.map +1 -1
- package/dist/attributes/shape/fill/gradient-stops.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/canvas3d.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/color.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/conic-gradient.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/dot-grid.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/fractal-noise.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/grid.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/image.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/linear-gradient.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/noise.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/radial-gradient.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/shader.d.ts +27 -26
- package/dist/attributes/shape/fill/implementations/shader.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/shader.js +20 -14
- package/dist/attributes/shape/fill/implementations/shader.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/stripe.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/video.js.map +1 -1
- package/dist/attributes/shape/fill/index.d.ts +1 -1
- package/dist/attributes/shape/fill/index.d.ts.map +1 -1
- package/dist/attributes/shape/fill/index.js.map +1 -1
- package/dist/attributes/shape/fill/lerp.js.map +1 -1
- package/dist/attributes/shape/fill/media-preset.js.map +1 -1
- package/dist/attributes/shape/fill/registry.d.ts +1 -2
- package/dist/attributes/shape/fill/registry.d.ts.map +1 -1
- package/dist/attributes/shape/fill/registry.js +1 -2
- package/dist/attributes/shape/fill/registry.js.map +1 -1
- package/dist/attributes/shape/fill/union.js.map +1 -1
- package/dist/attributes/shape/filters/chain.d.ts +2 -6
- package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
- package/dist/attributes/shape/filters/chain.js +1 -5
- package/dist/attributes/shape/filters/chain.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/alpha.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/blur.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/color-adjustment.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/color-matrix.d.ts +2 -2
- package/dist/attributes/shape/filters/implementations/color-matrix.d.ts.map +1 -1
- package/dist/attributes/shape/filters/implementations/color-matrix.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/curves.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/echo.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/exposure.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/grayscale.js.map +1 -1
- package/dist/attributes/shape/filters/implementations/posterize-time.js.map +1 -1
- package/dist/attributes/shape/filters/index.js.map +1 -1
- package/dist/attributes/shape/filters/registry.d.ts +1 -1
- package/dist/attributes/shape/filters/registry.d.ts.map +1 -1
- package/dist/attributes/shape/filters/registry.js +3 -3
- package/dist/attributes/shape/filters/registry.js.map +1 -1
- package/dist/attributes/shape/filters/union.d.ts +2 -3
- package/dist/attributes/shape/filters/union.d.ts.map +1 -1
- package/dist/attributes/shape/filters/union.js.map +1 -1
- package/dist/attributes/shape/path/anchors.js.map +1 -1
- package/dist/attributes/shape/path/bezier.js.map +1 -1
- package/dist/attributes/shape/path/index.js.map +1 -1
- package/dist/attributes/shape/path/measure.js.map +1 -1
- package/dist/attributes/shape/path/morph.js.map +1 -1
- package/dist/attributes/shape/path/ops.js.map +1 -1
- package/dist/attributes/shape/path/types.js.map +1 -1
- package/dist/attributes/shape/path/walk.js.map +1 -1
- package/dist/attributes/shape/shaders/index.d.ts +2 -0
- package/dist/attributes/shape/shaders/index.d.ts.map +1 -1
- package/dist/attributes/shape/shaders/index.js +2 -0
- package/dist/attributes/shape/shaders/index.js.map +1 -1
- package/dist/attributes/shape/shaders/language.d.ts +26 -0
- package/dist/attributes/shape/shaders/language.d.ts.map +1 -0
- package/dist/attributes/shape/shaders/language.js +20 -0
- package/dist/attributes/shape/shaders/language.js.map +1 -0
- package/dist/attributes/shape/shaders/pack.d.ts +25 -11
- package/dist/attributes/shape/shaders/pack.d.ts.map +1 -1
- package/dist/attributes/shape/shaders/pack.js +9 -4
- package/dist/attributes/shape/shaders/pack.js.map +1 -1
- package/dist/attributes/shape/shaders/resolve.d.ts +4 -5
- package/dist/attributes/shape/shaders/resolve.d.ts.map +1 -1
- package/dist/attributes/shape/shaders/resolve.js +3 -6
- package/dist/attributes/shape/shaders/resolve.js.map +1 -1
- package/dist/attributes/shape/shaders/uniforms.d.ts +41 -0
- package/dist/attributes/shape/shaders/uniforms.d.ts.map +1 -0
- package/dist/attributes/shape/shaders/uniforms.js +0 -0
- package/dist/attributes/shape/shaders/uniforms.js.map +1 -0
- package/dist/attributes/shape/shadow/index.js.map +1 -1
- package/dist/attributes/shape/shadow/shadow.js.map +1 -1
- package/dist/attributes/shape/stroke/index.js.map +1 -1
- package/dist/attributes/shape/stroke/stroke.js.map +1 -1
- package/dist/attributes/shared/operators.js.map +1 -1
- package/dist/attributes/text/index.js.map +1 -1
- package/dist/attributes/text/ops.js.map +1 -1
- package/dist/attributes/text/types.js.map +1 -1
- package/dist/browser/chunks/{chunk-LKUYVFU3.js → chunk-4BDLFEOC.js} +1 -1
- package/dist/browser/chunks/chunk-4BDLFEOC.js.map +7 -0
- package/dist/browser/chunks/chunk-7DB6BI27.js +6 -0
- package/dist/browser/chunks/chunk-7DB6BI27.js.map +7 -0
- package/dist/browser/chunks/chunk-IX53IFBD.js +13 -0
- package/dist/browser/chunks/chunk-IX53IFBD.js.map +7 -0
- package/dist/browser/chunks/{chunk-ZRPZPWZU.js → chunk-Q55UPA3E.js} +1 -1
- package/dist/browser/chunks/chunk-Q55UPA3E.js.map +7 -0
- package/dist/browser/component.js +1 -1
- package/dist/browser/experimental.js +1 -1
- package/dist/browser/experimental.js.map +4 -4
- package/dist/browser/index.js +1 -1
- package/dist/browser/index.js.map +2 -2
- package/dist/browser/manifest.json +1 -1
- package/dist/browser/sdk.js +1 -1
- package/dist/component.js.map +1 -1
- package/dist/components/builtins/audio/audio.d.ts +14 -5
- package/dist/components/builtins/audio/audio.d.ts.map +1 -1
- package/dist/components/builtins/audio/audio.js +10 -13
- package/dist/components/builtins/audio/audio.js.map +1 -1
- package/dist/components/builtins/geometry/composite.d.ts +3 -3
- package/dist/components/builtins/geometry/composite.js.map +1 -1
- package/dist/components/builtins/geometry/geometry.js.map +1 -1
- package/dist/components/builtins/geometry/shape-outline.js.map +1 -1
- package/dist/components/builtins/layout/layout.js.map +1 -1
- package/dist/components/builtins/media/media.d.ts +7 -7
- package/dist/components/builtins/media/media.d.ts.map +1 -1
- package/dist/components/builtins/media/media.js +4 -10
- package/dist/components/builtins/media/media.js.map +1 -1
- package/dist/components/builtins/providers/providers.js.map +1 -1
- package/dist/components/builtins/text/number-format.js.map +1 -1
- package/dist/components/builtins/text/number-pattern.js.map +1 -1
- package/dist/components/builtins/text/text-defaults.js.map +1 -1
- package/dist/components/builtins/text/text-layout.js.map +1 -1
- package/dist/components/builtins/text/text.d.ts +9 -9
- package/dist/components/builtins/text/text.d.ts.map +1 -1
- package/dist/components/builtins/text/text.js +3 -0
- package/dist/components/builtins/text/text.js.map +1 -1
- package/dist/components/builtins/three/canvas3d.js.map +1 -1
- package/dist/components/builtins/three/grid-geometry3d.js.map +1 -1
- package/dist/components/builtins/three/three.js.map +1 -1
- package/dist/components/factory/api.d.ts +38 -11
- package/dist/components/factory/api.d.ts.map +1 -1
- package/dist/components/factory/api.js.map +1 -1
- package/dist/components/factory/clip-of.js.map +1 -1
- package/dist/components/factory/commands-for.js.map +1 -1
- package/dist/components/factory/component-audio.js.map +1 -1
- package/dist/components/factory/component2d.js.map +1 -1
- package/dist/components/factory/component3d.d.ts.map +1 -1
- package/dist/components/factory/component3d.js +11 -3
- package/dist/components/factory/component3d.js.map +1 -1
- package/dist/components/factory/factory.d.ts +3 -0
- package/dist/components/factory/factory.d.ts.map +1 -1
- package/dist/components/factory/factory.js +39 -5
- package/dist/components/factory/factory.js.map +1 -1
- package/dist/components/factory/timeline.js.map +1 -1
- package/dist/components/factory/type-def.js.map +1 -1
- package/dist/components/factory/types.js.map +1 -1
- package/dist/components/factory/views.js.map +1 -1
- package/dist/components/modules/aim.js.map +1 -1
- package/dist/components/modules/corners.js.map +1 -1
- package/dist/components/modules/flow.js.map +1 -1
- package/dist/components/modules/material.js.map +1 -1
- package/dist/components/modules/paint.js.map +1 -1
- package/dist/components/modules/shapes.js.map +1 -1
- package/dist/components/modules/text-layout.js.map +1 -1
- package/dist/components/modules/text-style.js.map +1 -1
- package/dist/components/modules/three-entries.js.map +1 -1
- package/dist/components/modules/view3d.js.map +1 -1
- package/dist/components/trees/2d/group-bounds.js.map +1 -1
- package/dist/components/trees/2d/node-lifecycle.js.map +1 -1
- package/dist/components/trees/2d/node-motion.js.map +1 -1
- package/dist/components/trees/2d/node-render.d.ts +1 -1
- package/dist/components/trees/2d/node-render.js +1 -1
- package/dist/components/trees/2d/node-render.js.map +1 -1
- package/dist/components/trees/2d/node-space.js.map +1 -1
- package/dist/components/trees/2d/node-transform.js.map +1 -1
- package/dist/components/trees/2d/node2d.d.ts +1 -1
- package/dist/components/trees/2d/node2d.js +1 -1
- package/dist/components/trees/2d/node2d.js.map +1 -1
- package/dist/components/trees/audio/index.js.map +1 -1
- package/dist/components/trees/audio/node-audio.d.ts +16 -9
- package/dist/components/trees/audio/node-audio.d.ts.map +1 -1
- package/dist/components/trees/audio/node-audio.js +15 -11
- package/dist/components/trees/audio/node-audio.js.map +1 -1
- package/dist/components/trees/index.js.map +1 -1
- package/dist/components/trees/node/node-editor-state.js.map +1 -1
- package/dist/components/trees/node/node-reactive.js.map +1 -1
- package/dist/components/trees/node/node-time.js.map +1 -1
- package/dist/components/trees/node/node-walk.js.map +1 -1
- package/dist/components/trees/node/node.js.map +1 -1
- package/dist/components/trees/root/canvas2d-node.js.map +1 -1
- package/dist/components/trees/three/node3d.js.map +1 -1
- package/dist/document/audio.js.map +1 -1
- package/dist/document/builtins.js.map +1 -1
- package/dist/document/command-traits.d.ts +12 -2
- package/dist/document/command-traits.d.ts.map +1 -1
- package/dist/document/command-traits.js +34 -6
- package/dist/document/command-traits.js.map +1 -1
- package/dist/document/deny-globals.js.map +1 -1
- package/dist/document/diff.js.map +1 -1
- package/dist/document/doc-index.js.map +1 -1
- package/dist/document/expression/compile.js.map +1 -1
- package/dist/document/expression/index.js.map +1 -1
- package/dist/document/expression/ops.js.map +1 -1
- package/dist/document/expression/parse.js.map +1 -1
- package/dist/document/expression/refs.js.map +1 -1
- package/dist/document/expression/types.js.map +1 -1
- package/dist/document/expression/walk.js.map +1 -1
- package/dist/document/index.d.ts +8 -0
- package/dist/document/index.d.ts.map +1 -1
- package/dist/document/index.js +4 -0
- package/dist/document/index.js.map +1 -1
- package/dist/document/migrate.d.ts +70 -0
- package/dist/document/migrate.d.ts.map +1 -0
- package/dist/document/migrate.js +202 -0
- package/dist/document/migrate.js.map +1 -0
- package/dist/document/missing-node.d.ts +27 -0
- package/dist/document/missing-node.d.ts.map +1 -0
- package/dist/document/missing-node.js +48 -0
- package/dist/document/missing-node.js.map +1 -0
- package/dist/document/node-decorator.js.map +1 -1
- package/dist/document/node-descriptor.d.ts +4 -0
- package/dist/document/node-descriptor.d.ts.map +1 -1
- package/dist/document/node-descriptor.js.map +1 -1
- package/dist/document/placement.d.ts +2 -1
- package/dist/document/placement.d.ts.map +1 -1
- package/dist/document/placement.js.map +1 -1
- package/dist/document/project.d.ts +2 -0
- package/dist/document/project.d.ts.map +1 -1
- package/dist/document/project.js +1 -0
- package/dist/document/project.js.map +1 -1
- package/dist/document/prop-evolution.d.ts +51 -0
- package/dist/document/prop-evolution.d.ts.map +1 -0
- package/dist/document/prop-evolution.js +83 -0
- package/dist/document/prop-evolution.js.map +1 -0
- package/dist/document/registry.d.ts +16 -0
- package/dist/document/registry.d.ts.map +1 -1
- package/dist/document/registry.js +30 -4
- package/dist/document/registry.js.map +1 -1
- package/dist/document/settled-index.d.ts +2 -0
- package/dist/document/settled-index.d.ts.map +1 -1
- package/dist/document/settled-index.js +5 -5
- package/dist/document/settled-index.js.map +1 -1
- package/dist/document/timeline-patch.d.ts +4 -0
- package/dist/document/timeline-patch.d.ts.map +1 -1
- package/dist/document/timeline-patch.js +28 -3
- package/dist/document/timeline-patch.js.map +1 -1
- package/dist/document/timeline.d.ts +45 -1
- package/dist/document/timeline.d.ts.map +1 -1
- package/dist/document/timeline.js +172 -42
- package/dist/document/timeline.js.map +1 -1
- package/dist/document/types.d.ts +14 -28
- package/dist/document/types.d.ts.map +1 -1
- package/dist/document/types.js.map +1 -1
- package/dist/document/validate.d.ts +17 -5
- package/dist/document/validate.d.ts.map +1 -1
- package/dist/document/validate.js +158 -21
- package/dist/document/validate.js.map +1 -1
- package/dist/document/vocabulary.d.ts +28 -0
- package/dist/document/vocabulary.d.ts.map +1 -0
- package/dist/document/vocabulary.js +42 -0
- package/dist/document/vocabulary.js.map +1 -0
- package/dist/experimental.d.ts +68 -8
- package/dist/experimental.d.ts.map +1 -1
- package/dist/experimental.js +22 -8
- package/dist/experimental.js.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/layout/bounds.js.map +1 -1
- package/dist/layout/constraints.js.map +1 -1
- package/dist/layout/flex.js.map +1 -1
- package/dist/layout/freeform.js.map +1 -1
- package/dist/layout/grid.js.map +1 -1
- package/dist/layout/index.js.map +1 -1
- package/dist/layout/item.js.map +1 -1
- package/dist/layout/ops.js.map +1 -1
- package/dist/layout/types.js.map +1 -1
- package/dist/platform/audio-sink.js.map +1 -1
- package/dist/platform/exporter.d.ts +13 -0
- package/dist/platform/exporter.d.ts.map +1 -1
- package/dist/platform/exporter.js.map +1 -1
- package/dist/platform/index.js.map +1 -1
- package/dist/platform/stepped-clock.js.map +1 -1
- package/dist/platform/storage-adapter.js.map +1 -1
- package/dist/platform/ticker.js.map +1 -1
- package/dist/project/config.js.map +1 -1
- package/dist/project/index.js.map +1 -1
- package/dist/project/tree.js.map +1 -1
- package/dist/props/host.js.map +1 -1
- package/dist/props/index.js.map +1 -1
- package/dist/props/observer.js.map +1 -1
- package/dist/props/slot.js.map +1 -1
- package/dist/renamed-scene-names.d.ts +1 -1
- package/dist/renamed-scene-names.d.ts.map +1 -1
- package/dist/renamed-scene-names.js +1 -1
- package/dist/renamed-scene-names.js.map +1 -1
- package/dist/render/canvas-render-context2d.d.ts +9 -0
- package/dist/render/canvas-render-context2d.d.ts.map +1 -1
- package/dist/render/canvas-render-context2d.js +10 -0
- package/dist/render/canvas-render-context2d.js.map +1 -1
- package/dist/render/clip-contains.js +1 -1
- package/dist/render/clip-contains.js.map +1 -1
- package/dist/render/clip.js.map +1 -1
- package/dist/render/descriptors/ellipse.js.map +1 -1
- package/dist/render/descriptors/line.js.map +1 -1
- package/dist/render/descriptors/path-builder.js.map +1 -1
- package/dist/render/descriptors/path.js.map +1 -1
- package/dist/render/descriptors/polygon.js.map +1 -1
- package/dist/render/descriptors/polygram.js.map +1 -1
- package/dist/render/descriptors/rect.js.map +1 -1
- package/dist/render/descriptors/richtext.js.map +1 -1
- package/dist/render/descriptors/shape.js.map +1 -1
- package/dist/render/descriptors/text.d.ts +2 -2
- package/dist/render/descriptors/text.js +2 -2
- package/dist/render/descriptors/text.js.map +1 -1
- package/dist/render/descriptors/transform.js.map +1 -1
- package/dist/render/graphics2d.js.map +1 -1
- package/dist/render/index.d.ts +2 -0
- package/dist/render/index.d.ts.map +1 -1
- package/dist/render/index.js +1 -0
- package/dist/render/index.js.map +1 -1
- package/dist/render/measure-context.js.map +1 -1
- package/dist/render/null-render-context.js.map +1 -1
- package/dist/render/render-context2d.d.ts +1 -1
- package/dist/render/render-context2d.js.map +1 -1
- package/dist/render/render-issue.d.ts +39 -0
- package/dist/render/render-issue.d.ts.map +1 -0
- package/dist/render/render-issue.js +29 -0
- package/dist/render/render-issue.js.map +1 -0
- package/dist/render/surface.d.ts +2 -2
- package/dist/render/surface.js.map +1 -1
- package/dist/render/text-defaults.js.map +1 -1
- package/dist/render/text-layout.js.map +1 -1
- package/dist/render3d/bounds3d.js.map +1 -1
- package/dist/render3d/builders.js.map +1 -1
- package/dist/render3d/camera.js.map +1 -1
- package/dist/render3d/fill3d.js.map +1 -1
- package/dist/render3d/geometry.js.map +1 -1
- package/dist/render3d/graphics3d.d.ts.map +1 -1
- package/dist/render3d/graphics3d.js +54 -5
- package/dist/render3d/graphics3d.js.map +1 -1
- package/dist/render3d/index.js.map +1 -1
- package/dist/render3d/inert.js.map +1 -1
- package/dist/render3d/light.js.map +1 -1
- package/dist/render3d/material.js.map +1 -1
- package/dist/render3d/matrix4.js.map +1 -1
- package/dist/render3d/render-context3d.js.map +1 -1
- package/dist/render3d/resources.js.map +1 -1
- package/dist/render3d/rounded-box.js.map +1 -1
- package/dist/render3d/scene-settings.js.map +1 -1
- package/dist/render3d/scene3d.js.map +1 -1
- package/dist/render3d/segments.js.map +1 -1
- package/dist/render3d/texture.js.map +1 -1
- package/dist/render3d/tracking.js.map +1 -1
- package/dist/render3d/transform.js.map +1 -1
- package/dist/render3d/vector3.js.map +1 -1
- package/dist/render3d/walk.js.map +1 -1
- package/dist/runtime/asset-refine.js +2 -1
- package/dist/runtime/asset-refine.js.map +1 -1
- package/dist/runtime/asset-timeline.d.ts +10 -0
- package/dist/runtime/asset-timeline.d.ts.map +1 -1
- package/dist/runtime/asset-timeline.js.map +1 -1
- package/dist/runtime/asset-update.d.ts.map +1 -1
- package/dist/runtime/asset-update.js +7 -0
- package/dist/runtime/asset-update.js.map +1 -1
- package/dist/runtime/audio-index.js.map +1 -1
- package/dist/runtime/builtin-context.js.map +1 -1
- package/dist/runtime/clip-instance.d.ts +3 -1
- package/dist/runtime/clip-instance.d.ts.map +1 -1
- package/dist/runtime/clip-instance.js +4 -0
- package/dist/runtime/clip-instance.js.map +1 -1
- package/dist/runtime/clip-store.d.ts.map +1 -1
- package/dist/runtime/clip-store.js +17 -2
- package/dist/runtime/clip-store.js.map +1 -1
- package/dist/runtime/engine.d.ts +5 -3
- package/dist/runtime/engine.d.ts.map +1 -1
- package/dist/runtime/engine.js +2 -1
- package/dist/runtime/engine.js.map +1 -1
- package/dist/runtime/frame-time.js.map +1 -1
- package/dist/runtime/index.js.map +1 -1
- package/dist/runtime/node-picking.js.map +1 -1
- package/dist/runtime/node-picking3d.js.map +1 -1
- package/dist/runtime/placement.js.map +1 -1
- package/dist/runtime/playback-controller.d.ts.map +1 -1
- package/dist/runtime/playback-controller.js +14 -4
- package/dist/runtime/playback-controller.js.map +1 -1
- package/dist/runtime/playback.js.map +1 -1
- package/dist/runtime/precompisition.js.map +1 -1
- package/dist/runtime/project-assets.js.map +1 -1
- package/dist/runtime/session.d.ts +7 -3
- package/dist/runtime/session.d.ts.map +1 -1
- package/dist/runtime/session.js +11 -4
- package/dist/runtime/session.js.map +1 -1
- package/dist/runtime/settle.js.map +1 -1
- package/dist/runtime/state-evaluator.js.map +1 -1
- package/dist/runtime/text-geometry.d.ts +1 -1
- package/dist/runtime/text-geometry.js.map +1 -1
- package/dist/sdk/index.d.ts +8 -6
- package/dist/sdk/index.d.ts.map +1 -1
- package/dist/sdk/index.js +10 -3
- package/dist/sdk/index.js.map +1 -1
- package/dist/tween/command-decorator.d.ts +7 -0
- package/dist/tween/command-decorator.d.ts.map +1 -1
- package/dist/tween/command-decorator.js +1 -0
- package/dist/tween/command-decorator.js.map +1 -1
- package/dist/tween/command.js.map +1 -1
- package/dist/tween/ease/constants.js.map +1 -1
- package/dist/tween/ease/curve.js.map +1 -1
- package/dist/tween/ease/describe.d.ts +2 -0
- package/dist/tween/ease/describe.d.ts.map +1 -1
- package/dist/tween/ease/describe.js +4 -0
- package/dist/tween/ease/describe.js.map +1 -1
- package/dist/tween/ease/spec.d.ts +31 -0
- package/dist/tween/ease/spec.d.ts.map +1 -0
- package/dist/tween/ease/spec.js +51 -0
- package/dist/tween/ease/spec.js.map +1 -0
- package/dist/tween/ease/type.js.map +1 -1
- package/dist/tween/index.d.ts +1 -0
- package/dist/tween/index.d.ts.map +1 -1
- package/dist/tween/index.js +1 -0
- package/dist/tween/index.js.map +1 -1
- package/dist/tween/inert.js.map +1 -1
- package/dist/tween/lerp.js.map +1 -1
- package/dist/tween/loop.js.map +1 -1
- package/dist/tween/prepare.js.map +1 -1
- package/dist/tween/stepper.js.map +1 -1
- package/dist/tween/to-command.js.map +1 -1
- package/dist/util/clamp.js.map +1 -1
- package/dist/util/context.js.map +1 -1
- package/dist/util/csv.js.map +1 -1
- package/dist/util/generateList.js.map +1 -1
- package/dist/util/index.js.map +1 -1
- package/dist/util/metrics.js.map +1 -1
- package/dist/util/random.js.map +1 -1
- package/dist/util/reference.js.map +1 -1
- package/dist/util/scheduler.js.map +1 -1
- package/package.json +2 -2
- package/dist/attributes/audio/filters/chain.d.ts +0 -113
- package/dist/attributes/audio/filters/chain.d.ts.map +0 -1
- package/dist/attributes/audio/filters/chain.js +0 -104
- package/dist/attributes/audio/filters/chain.js.map +0 -1
- package/dist/attributes/audio/filters/curve.d.ts +0 -152
- package/dist/attributes/audio/filters/curve.d.ts.map +0 -1
- package/dist/attributes/audio/filters/curve.js +0 -250
- package/dist/attributes/audio/filters/curve.js.map +0 -1
- package/dist/attributes/audio/filters/implementations/echo.d.ts +0 -14
- package/dist/attributes/audio/filters/implementations/echo.d.ts.map +0 -1
- package/dist/attributes/audio/filters/implementations/echo.js.map +0 -1
- package/dist/attributes/audio/filters/implementations/gain.d.ts +0 -10
- package/dist/attributes/audio/filters/implementations/gain.d.ts.map +0 -1
- package/dist/attributes/audio/filters/implementations/gain.js.map +0 -1
- package/dist/attributes/audio/filters/implementations/highpass.d.ts +0 -12
- package/dist/attributes/audio/filters/implementations/highpass.d.ts.map +0 -1
- package/dist/attributes/audio/filters/implementations/highpass.js.map +0 -1
- package/dist/attributes/audio/filters/implementations/lowpass.d.ts +0 -12
- package/dist/attributes/audio/filters/implementations/lowpass.d.ts.map +0 -1
- package/dist/attributes/audio/filters/implementations/lowpass.js.map +0 -1
- package/dist/attributes/audio/filters/implementations/speed.d.ts +0 -18
- package/dist/attributes/audio/filters/implementations/speed.d.ts.map +0 -1
- package/dist/attributes/audio/filters/implementations/speed.js +0 -6
- package/dist/attributes/audio/filters/implementations/speed.js.map +0 -1
- package/dist/attributes/audio/filters/implementations/tremolo.d.ts +0 -12
- package/dist/attributes/audio/filters/implementations/tremolo.d.ts.map +0 -1
- package/dist/attributes/audio/filters/implementations/tremolo.js.map +0 -1
- package/dist/attributes/audio/filters/index.d.ts +0 -22
- package/dist/attributes/audio/filters/index.d.ts.map +0 -1
- package/dist/attributes/audio/filters/index.js +0 -8
- package/dist/attributes/audio/filters/index.js.map +0 -1
- package/dist/attributes/audio/filters/registry.d.ts +0 -36
- package/dist/attributes/audio/filters/registry.d.ts.map +0 -1
- package/dist/attributes/audio/filters/registry.js +0 -82
- package/dist/attributes/audio/filters/registry.js.map +0 -1
- package/dist/attributes/audio/filters/union.d.ts +0 -18
- package/dist/attributes/audio/filters/union.d.ts.map +0 -1
- package/dist/attributes/audio/filters/union.js +0 -28
- package/dist/attributes/audio/filters/union.js.map +0 -1
- package/dist/attributes/shape/sksl-uniforms.d.ts +0 -146
- package/dist/attributes/shape/sksl-uniforms.d.ts.map +0 -1
- package/dist/attributes/shape/sksl-uniforms.js +0 -0
- package/dist/attributes/shape/sksl-uniforms.js.map +0 -1
- package/dist/browser/chunks/chunk-D4FSTPML.js +0 -14
- package/dist/browser/chunks/chunk-D4FSTPML.js.map +0 -7
- package/dist/browser/chunks/chunk-LKUYVFU3.js.map +0 -7
- package/dist/browser/chunks/chunk-RTNATFWX.js +0 -5
- package/dist/browser/chunks/chunk-RTNATFWX.js.map +0 -7
- package/dist/browser/chunks/chunk-ZRPZPWZU.js.map +0 -7
- package/dist/component/api.d.ts +0 -508
- package/dist/component/api.d.ts.map +0 -1
- package/dist/component/api.js +0 -4
- package/dist/component/api.js.map +0 -1
- package/dist/component/builtins/audio.d.ts +0 -26
- package/dist/component/builtins/audio.d.ts.map +0 -1
- package/dist/component/builtins/audio.js +0 -41
- package/dist/component/builtins/audio.js.map +0 -1
- package/dist/component/builtins/canvas3d.d.ts +0 -98
- package/dist/component/builtins/canvas3d.d.ts.map +0 -1
- package/dist/component/builtins/canvas3d.js +0 -21
- package/dist/component/builtins/canvas3d.js.map +0 -1
- package/dist/component/builtins/composite.d.ts +0 -56
- package/dist/component/builtins/composite.d.ts.map +0 -1
- package/dist/component/builtins/composite.js +0 -25
- package/dist/component/builtins/composite.js.map +0 -1
- package/dist/component/builtins/geometry.d.ts +0 -505
- package/dist/component/builtins/geometry.d.ts.map +0 -1
- package/dist/component/builtins/geometry.js +0 -107
- package/dist/component/builtins/geometry.js.map +0 -1
- package/dist/component/builtins/layout.d.ts +0 -88
- package/dist/component/builtins/layout.d.ts.map +0 -1
- package/dist/component/builtins/layout.js +0 -84
- package/dist/component/builtins/layout.js.map +0 -1
- package/dist/component/builtins/media.d.ts +0 -95
- package/dist/component/builtins/media.d.ts.map +0 -1
- package/dist/component/builtins/media.js +0 -149
- package/dist/component/builtins/media.js.map +0 -1
- package/dist/component/builtins/providers.d.ts +0 -23
- package/dist/component/builtins/providers.d.ts.map +0 -1
- package/dist/component/builtins/providers.js +0 -30
- package/dist/component/builtins/providers.js.map +0 -1
- package/dist/component/builtins/text.d.ts +0 -193
- package/dist/component/builtins/text.d.ts.map +0 -1
- package/dist/component/builtins/text.js +0 -113
- package/dist/component/builtins/text.js.map +0 -1
- package/dist/component/builtins/three.d.ts +0 -1085
- package/dist/component/builtins/three.d.ts.map +0 -1
- package/dist/component/builtins/three.js +0 -265
- package/dist/component/builtins/three.js.map +0 -1
- package/dist/component/clip-of.d.ts +0 -5
- package/dist/component/clip-of.d.ts.map +0 -1
- package/dist/component/clip-of.js +0 -33
- package/dist/component/clip-of.js.map +0 -1
- package/dist/component/commands-for.d.ts +0 -19
- package/dist/component/commands-for.d.ts.map +0 -1
- package/dist/component/commands-for.js +0 -5
- package/dist/component/commands-for.js.map +0 -1
- package/dist/component/component-audio.d.ts +0 -9
- package/dist/component/component-audio.d.ts.map +0 -1
- package/dist/component/component-audio.js +0 -18
- package/dist/component/component-audio.js.map +0 -1
- package/dist/component/component2d.d.ts +0 -9
- package/dist/component/component2d.d.ts.map +0 -1
- package/dist/component/component2d.js +0 -239
- package/dist/component/component2d.js.map +0 -1
- package/dist/component/component3d.d.ts +0 -9
- package/dist/component/component3d.d.ts.map +0 -1
- package/dist/component/component3d.js +0 -99
- package/dist/component/component3d.js.map +0 -1
- package/dist/component/factory.d.ts +0 -63
- package/dist/component/factory.d.ts.map +0 -1
- package/dist/component/factory.js +0 -313
- package/dist/component/factory.js.map +0 -1
- package/dist/component/modules/aim.d.ts +0 -30
- package/dist/component/modules/aim.d.ts.map +0 -1
- package/dist/component/modules/aim.js +0 -39
- package/dist/component/modules/aim.js.map +0 -1
- package/dist/component/modules/corners.d.ts +0 -13
- package/dist/component/modules/corners.d.ts.map +0 -1
- package/dist/component/modules/corners.js +0 -12
- package/dist/component/modules/corners.js.map +0 -1
- package/dist/component/modules/flow.d.ts +0 -26
- package/dist/component/modules/flow.d.ts.map +0 -1
- package/dist/component/modules/flow.js +0 -55
- package/dist/component/modules/flow.js.map +0 -1
- package/dist/component/modules/material.d.ts +0 -40
- package/dist/component/modules/material.d.ts.map +0 -1
- package/dist/component/modules/material.js +0 -75
- package/dist/component/modules/material.js.map +0 -1
- package/dist/component/modules/paint.d.ts +0 -71
- package/dist/component/modules/paint.d.ts.map +0 -1
- package/dist/component/modules/paint.js +0 -106
- package/dist/component/modules/paint.js.map +0 -1
- package/dist/component/modules/shapes.d.ts +0 -31
- package/dist/component/modules/shapes.d.ts.map +0 -1
- package/dist/component/modules/shapes.js +0 -43
- package/dist/component/modules/shapes.js.map +0 -1
- package/dist/component/modules/text-layout.d.ts +0 -26
- package/dist/component/modules/text-layout.d.ts.map +0 -1
- package/dist/component/modules/text-layout.js +0 -57
- package/dist/component/modules/text-layout.js.map +0 -1
- package/dist/component/modules/text-style.d.ts +0 -48
- package/dist/component/modules/text-style.d.ts.map +0 -1
- package/dist/component/modules/text-style.js +0 -63
- package/dist/component/modules/text-style.js.map +0 -1
- package/dist/component/modules/three-entries.d.ts +0 -23
- package/dist/component/modules/three-entries.d.ts.map +0 -1
- package/dist/component/modules/three-entries.js +0 -41
- package/dist/component/modules/three-entries.js.map +0 -1
- package/dist/component/modules/view3d.d.ts +0 -55
- package/dist/component/modules/view3d.d.ts.map +0 -1
- package/dist/component/modules/view3d.js +0 -160
- package/dist/component/modules/view3d.js.map +0 -1
- package/dist/component/timeline.d.ts +0 -22
- package/dist/component/timeline.d.ts.map +0 -1
- package/dist/component/timeline.js +0 -128
- package/dist/component/timeline.js.map +0 -1
- package/dist/component/type-def.d.ts +0 -26
- package/dist/component/type-def.d.ts.map +0 -1
- package/dist/component/type-def.js +0 -16
- package/dist/component/type-def.js.map +0 -1
- package/dist/component/types.d.ts +0 -91
- package/dist/component/types.d.ts.map +0 -1
- package/dist/component/types.js +0 -88
- package/dist/component/types.js.map +0 -1
- package/dist/component/views.d.ts +0 -121
- package/dist/component/views.d.ts.map +0 -1
- package/dist/component/views.js +0 -413
- package/dist/component/views.js.map +0 -1
- package/dist/document/withdraw.d.ts +0 -28
- package/dist/document/withdraw.d.ts.map +0 -1
- package/dist/document/withdraw.js +0 -61
- package/dist/document/withdraw.js.map +0 -1
- package/dist/jsx/jsx-dev-runtime.d.ts +0 -3
- package/dist/jsx/jsx-dev-runtime.d.ts.map +0 -1
- package/dist/jsx/jsx-dev-runtime.js +0 -3
- package/dist/jsx/jsx-dev-runtime.js.map +0 -1
- package/dist/jsx/jsx-runtime.d.ts +0 -27
- package/dist/jsx/jsx-runtime.d.ts.map +0 -1
- package/dist/jsx/jsx-runtime.js +0 -26
- package/dist/jsx/jsx-runtime.js.map +0 -1
- package/dist/nodes/2d/node-lifecycle.d.ts +0 -46
- package/dist/nodes/2d/node-lifecycle.d.ts.map +0 -1
- package/dist/nodes/2d/node-lifecycle.js +0 -264
- package/dist/nodes/2d/node-lifecycle.js.map +0 -1
- package/dist/nodes/2d/node-motion.d.ts +0 -56
- package/dist/nodes/2d/node-motion.d.ts.map +0 -1
- package/dist/nodes/2d/node-motion.js +0 -86
- package/dist/nodes/2d/node-motion.js.map +0 -1
- package/dist/nodes/2d/node-render.d.ts +0 -44
- package/dist/nodes/2d/node-render.d.ts.map +0 -1
- package/dist/nodes/2d/node-render.js +0 -80
- package/dist/nodes/2d/node-render.js.map +0 -1
- package/dist/nodes/2d/node-space.d.ts +0 -63
- package/dist/nodes/2d/node-space.d.ts.map +0 -1
- package/dist/nodes/2d/node-space.js +0 -131
- package/dist/nodes/2d/node-space.js.map +0 -1
- package/dist/nodes/2d/node-transform.d.ts +0 -55
- package/dist/nodes/2d/node-transform.d.ts.map +0 -1
- package/dist/nodes/2d/node-transform.js +0 -73
- package/dist/nodes/2d/node-transform.js.map +0 -1
- package/dist/nodes/2d/node2d.d.ts +0 -1111
- package/dist/nodes/2d/node2d.d.ts.map +0 -1
- package/dist/nodes/2d/node2d.js +0 -1665
- package/dist/nodes/2d/node2d.js.map +0 -1
- package/dist/nodes/2d/paint-node.d.ts +0 -142
- package/dist/nodes/2d/paint-node.d.ts.map +0 -1
- package/dist/nodes/2d/paint-node.js +0 -232
- package/dist/nodes/2d/paint-node.js.map +0 -1
- package/dist/nodes/audio/audio-bus.d.ts +0 -28
- package/dist/nodes/audio/audio-bus.d.ts.map +0 -1
- package/dist/nodes/audio/audio-bus.js +0 -33
- package/dist/nodes/audio/audio-bus.js.map +0 -1
- package/dist/nodes/audio/index.d.ts +0 -4
- package/dist/nodes/audio/index.d.ts.map +0 -1
- package/dist/nodes/audio/index.js +0 -2
- package/dist/nodes/audio/index.js.map +0 -1
- package/dist/nodes/audio/node-audio.d.ts +0 -107
- package/dist/nodes/audio/node-audio.d.ts.map +0 -1
- package/dist/nodes/audio/node-audio.js +0 -179
- package/dist/nodes/audio/node-audio.js.map +0 -1
- package/dist/nodes/audio/sound-node.d.ts +0 -41
- package/dist/nodes/audio/sound-node.d.ts.map +0 -1
- package/dist/nodes/audio/sound-node.js +0 -71
- package/dist/nodes/audio/sound-node.js.map +0 -1
- package/dist/nodes/geometry/boolean-node.d.ts +0 -28
- package/dist/nodes/geometry/boolean-node.d.ts.map +0 -1
- package/dist/nodes/geometry/boolean-node.js +0 -81
- package/dist/nodes/geometry/boolean-node.js.map +0 -1
- package/dist/nodes/geometry/bounds-shape-node.d.ts +0 -149
- package/dist/nodes/geometry/bounds-shape-node.d.ts.map +0 -1
- package/dist/nodes/geometry/bounds-shape-node.js +0 -181
- package/dist/nodes/geometry/bounds-shape-node.js.map +0 -1
- package/dist/nodes/geometry/box-path-node.d.ts +0 -89
- package/dist/nodes/geometry/box-path-node.d.ts.map +0 -1
- package/dist/nodes/geometry/box-path-node.js +0 -116
- package/dist/nodes/geometry/box-path-node.js.map +0 -1
- package/dist/nodes/geometry/ellipse-node.d.ts +0 -18
- package/dist/nodes/geometry/ellipse-node.d.ts.map +0 -1
- package/dist/nodes/geometry/ellipse-node.js +0 -45
- package/dist/nodes/geometry/ellipse-node.js.map +0 -1
- package/dist/nodes/geometry/group-bounds.d.ts +0 -56
- package/dist/nodes/geometry/group-bounds.d.ts.map +0 -1
- package/dist/nodes/geometry/group-bounds.js +0 -87
- package/dist/nodes/geometry/group-bounds.js.map +0 -1
- package/dist/nodes/geometry/mask-node.d.ts +0 -33
- package/dist/nodes/geometry/mask-node.d.ts.map +0 -1
- package/dist/nodes/geometry/mask-node.js +0 -66
- package/dist/nodes/geometry/mask-node.js.map +0 -1
- package/dist/nodes/geometry/path-node.d.ts +0 -26
- package/dist/nodes/geometry/path-node.d.ts.map +0 -1
- package/dist/nodes/geometry/path-node.js +0 -58
- package/dist/nodes/geometry/path-node.js.map +0 -1
- package/dist/nodes/geometry/polygon-node.d.ts +0 -26
- package/dist/nodes/geometry/polygon-node.d.ts.map +0 -1
- package/dist/nodes/geometry/polygon-node.js +0 -47
- package/dist/nodes/geometry/polygon-node.js.map +0 -1
- package/dist/nodes/geometry/polygram-node.d.ts +0 -33
- package/dist/nodes/geometry/polygram-node.d.ts.map +0 -1
- package/dist/nodes/geometry/polygram-node.js +0 -52
- package/dist/nodes/geometry/polygram-node.js.map +0 -1
- package/dist/nodes/geometry/rect-node.d.ts +0 -38
- package/dist/nodes/geometry/rect-node.d.ts.map +0 -1
- package/dist/nodes/geometry/rect-node.js +0 -56
- package/dist/nodes/geometry/rect-node.js.map +0 -1
- package/dist/nodes/geometry/shape-node.d.ts +0 -71
- package/dist/nodes/geometry/shape-node.d.ts.map +0 -1
- package/dist/nodes/geometry/shape-node.js +0 -140
- package/dist/nodes/geometry/shape-node.js.map +0 -1
- package/dist/nodes/geometry/shape-outline.d.ts +0 -93
- package/dist/nodes/geometry/shape-outline.d.ts.map +0 -1
- package/dist/nodes/geometry/shape-outline.js +0 -470
- package/dist/nodes/geometry/shape-outline.js.map +0 -1
- package/dist/nodes/index.d.ts +0 -53
- package/dist/nodes/index.d.ts.map +0 -1
- package/dist/nodes/index.js +0 -35
- package/dist/nodes/index.js.map +0 -1
- package/dist/nodes/layout/camera-node.d.ts +0 -80
- package/dist/nodes/layout/camera-node.d.ts.map +0 -1
- package/dist/nodes/layout/camera-node.js +0 -153
- package/dist/nodes/layout/camera-node.js.map +0 -1
- package/dist/nodes/layout/orbit-camera-node.d.ts +0 -80
- package/dist/nodes/layout/orbit-camera-node.d.ts.map +0 -1
- package/dist/nodes/layout/orbit-camera-node.js +0 -118
- package/dist/nodes/layout/orbit-camera-node.js.map +0 -1
- package/dist/nodes/layout/rotated-box.d.ts +0 -20
- package/dist/nodes/layout/rotated-box.d.ts.map +0 -1
- package/dist/nodes/layout/rotated-box.js +0 -76
- package/dist/nodes/layout/rotated-box.js.map +0 -1
- package/dist/nodes/media/video-node.d.ts +0 -229
- package/dist/nodes/media/video-node.d.ts.map +0 -1
- package/dist/nodes/media/video-node.js +0 -350
- package/dist/nodes/media/video-node.js.map +0 -1
- package/dist/nodes/node/declare-paints.d.ts +0 -19
- package/dist/nodes/node/declare-paints.d.ts.map +0 -1
- package/dist/nodes/node/declare-paints.js +0 -27
- package/dist/nodes/node/declare-paints.js.map +0 -1
- package/dist/nodes/node/node-editor-state.d.ts +0 -53
- package/dist/nodes/node/node-editor-state.d.ts.map +0 -1
- package/dist/nodes/node/node-editor-state.js +0 -23
- package/dist/nodes/node/node-editor-state.js.map +0 -1
- package/dist/nodes/node/node-reactive.d.ts +0 -89
- package/dist/nodes/node/node-reactive.d.ts.map +0 -1
- package/dist/nodes/node/node-reactive.js +0 -135
- package/dist/nodes/node/node-reactive.js.map +0 -1
- package/dist/nodes/node/node-time.d.ts +0 -39
- package/dist/nodes/node/node-time.d.ts.map +0 -1
- package/dist/nodes/node/node-time.js +0 -14
- package/dist/nodes/node/node-time.js.map +0 -1
- package/dist/nodes/node/node-walk.d.ts +0 -46
- package/dist/nodes/node/node-walk.d.ts.map +0 -1
- package/dist/nodes/node/node-walk.js +0 -74
- package/dist/nodes/node/node-walk.js.map +0 -1
- package/dist/nodes/node/node.d.ts +0 -445
- package/dist/nodes/node/node.d.ts.map +0 -1
- package/dist/nodes/node/node.js +0 -745
- package/dist/nodes/node/node.js.map +0 -1
- package/dist/nodes/node/text-defaults.d.ts +0 -32
- package/dist/nodes/node/text-defaults.d.ts.map +0 -1
- package/dist/nodes/node/text-defaults.js +0 -37
- package/dist/nodes/node/text-defaults.js.map +0 -1
- package/dist/nodes/root/canvas2d-node.d.ts +0 -163
- package/dist/nodes/root/canvas2d-node.d.ts.map +0 -1
- package/dist/nodes/root/canvas2d-node.js +0 -264
- package/dist/nodes/root/canvas2d-node.js.map +0 -1
- package/dist/nodes/root/provider-node.d.ts +0 -47
- package/dist/nodes/root/provider-node.d.ts.map +0 -1
- package/dist/nodes/root/provider-node.js +0 -63
- package/dist/nodes/root/provider-node.js.map +0 -1
- package/dist/nodes/root/theme-provider-node.d.ts +0 -29
- package/dist/nodes/root/theme-provider-node.d.ts.map +0 -1
- package/dist/nodes/root/theme-provider-node.js +0 -43
- package/dist/nodes/root/theme-provider-node.js.map +0 -1
- package/dist/nodes/text/default-text-style-node.d.ts +0 -103
- package/dist/nodes/text/default-text-style-node.d.ts.map +0 -1
- package/dist/nodes/text/default-text-style-node.js +0 -146
- package/dist/nodes/text/default-text-style-node.js.map +0 -1
- package/dist/nodes/text/number-format.d.ts +0 -66
- package/dist/nodes/text/number-format.d.ts.map +0 -1
- package/dist/nodes/text/number-format.js +0 -227
- package/dist/nodes/text/number-format.js.map +0 -1
- package/dist/nodes/text/number-node.d.ts +0 -94
- package/dist/nodes/text/number-node.d.ts.map +0 -1
- package/dist/nodes/text/number-node.js +0 -86
- package/dist/nodes/text/number-node.js.map +0 -1
- package/dist/nodes/text/number-pattern.d.ts +0 -51
- package/dist/nodes/text/number-pattern.d.ts.map +0 -1
- package/dist/nodes/text/number-pattern.js +0 -77
- package/dist/nodes/text/number-pattern.js.map +0 -1
- package/dist/nodes/text/richtext-node.d.ts +0 -68
- package/dist/nodes/text/richtext-node.d.ts.map +0 -1
- package/dist/nodes/text/richtext-node.js +0 -78
- package/dist/nodes/text/richtext-node.js.map +0 -1
- package/dist/nodes/text/text-base.d.ts +0 -118
- package/dist/nodes/text/text-base.d.ts.map +0 -1
- package/dist/nodes/text/text-base.js +0 -153
- package/dist/nodes/text/text-base.js.map +0 -1
- package/dist/nodes/text/text-layout.d.ts +0 -87
- package/dist/nodes/text/text-layout.d.ts.map +0 -1
- package/dist/nodes/text/text-layout.js +0 -368
- package/dist/nodes/text/text-layout.js.map +0 -1
- package/dist/nodes/text/text-node.d.ts +0 -84
- package/dist/nodes/text/text-node.d.ts.map +0 -1
- package/dist/nodes/text/text-node.js +0 -188
- package/dist/nodes/text/text-node.js.map +0 -1
- package/dist/nodes/text/text-selection.d.ts +0 -125
- package/dist/nodes/text/text-selection.d.ts.map +0 -1
- package/dist/nodes/text/text-selection.js +0 -209
- package/dist/nodes/text/text-selection.js.map +0 -1
- package/dist/nodes/three/camera-nodes.d.ts +0 -109
- package/dist/nodes/three/camera-nodes.d.ts.map +0 -1
- package/dist/nodes/three/camera-nodes.js +0 -112
- package/dist/nodes/three/camera-nodes.js.map +0 -1
- package/dist/nodes/three/canvas3d-node.d.ts +0 -295
- package/dist/nodes/three/canvas3d-node.d.ts.map +0 -1
- package/dist/nodes/three/canvas3d-node.js +0 -486
- package/dist/nodes/three/canvas3d-node.js.map +0 -1
- package/dist/nodes/three/drawable-nodes.d.ts +0 -173
- package/dist/nodes/three/drawable-nodes.d.ts.map +0 -1
- package/dist/nodes/three/drawable-nodes.js +0 -284
- package/dist/nodes/three/drawable-nodes.js.map +0 -1
- package/dist/nodes/three/environment-nodes.d.ts +0 -106
- package/dist/nodes/three/environment-nodes.d.ts.map +0 -1
- package/dist/nodes/three/environment-nodes.js +0 -134
- package/dist/nodes/three/environment-nodes.js.map +0 -1
- package/dist/nodes/three/geometry-nodes.d.ts +0 -197
- package/dist/nodes/three/geometry-nodes.d.ts.map +0 -1
- package/dist/nodes/three/geometry-nodes.js +0 -322
- package/dist/nodes/three/geometry-nodes.js.map +0 -1
- package/dist/nodes/three/grid-geometry3d.d.ts +0 -62
- package/dist/nodes/three/grid-geometry3d.d.ts.map +0 -1
- package/dist/nodes/three/grid-geometry3d.js +0 -114
- package/dist/nodes/three/grid-geometry3d.js.map +0 -1
- package/dist/nodes/three/group3d.d.ts +0 -23
- package/dist/nodes/three/group3d.d.ts.map +0 -1
- package/dist/nodes/three/group3d.js +0 -21
- package/dist/nodes/three/group3d.js.map +0 -1
- package/dist/nodes/three/light-nodes.d.ts +0 -120
- package/dist/nodes/three/light-nodes.d.ts.map +0 -1
- package/dist/nodes/three/light-nodes.js +0 -173
- package/dist/nodes/three/light-nodes.js.map +0 -1
- package/dist/nodes/three/mesh3d.d.ts +0 -117
- package/dist/nodes/three/mesh3d.d.ts.map +0 -1
- package/dist/nodes/three/mesh3d.js +0 -147
- package/dist/nodes/three/mesh3d.js.map +0 -1
- package/dist/nodes/three/node3d.d.ts +0 -230
- package/dist/nodes/three/node3d.d.ts.map +0 -1
- package/dist/nodes/three/node3d.js +0 -337
- package/dist/nodes/three/node3d.js.map +0 -1
- package/dist/render/descriptors/latex.d.ts +0 -6
- package/dist/render/descriptors/latex.d.ts.map +0 -1
- package/dist/render/descriptors/latex.js +0 -2
- package/dist/render/descriptors/latex.js.map +0 -1
- package/dist/tween/seekable.d.ts +0 -81
- package/dist/tween/seekable.d.ts.map +0 -1
- package/dist/tween/seekable.js +0 -137
- package/dist/tween/seekable.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/render3d/geometry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PathData } from \"@/render/descriptors/path\";\r\nimport type { PathBuilder } from \"@/render/descriptors/path-builder\";\r\nimport { type Color, parseColor } from \"@/attributes/shape/fill/color/parser\";\r\nimport type { Vector3, Vector3Input } from \"./vector3\";\r\nimport type { Segments3D } from \"./segments\";\r\n\r\n/**\r\n * Anything not modelled by a named field, assigned straight onto the constructed\r\n * object. The documented last resort — unsafe by construction (it bypasses the\r\n * type system, and the renderer treats any change to it as a full rebuild since\r\n * it cannot know what a given key affects), but it means no author is ever\r\n * blocked waiting for a field to be modelled here.\r\n *\r\n * **Where it is applied**: materials, lights (and a light's `shadow`) and\r\n * cameras. **Where it is not**: geometries, the environment and post effects. A\r\n * `params` there is recorded and nothing reads it (probe: `box({ params: { name:\r\n * \"x\" } })` leaves the built geometry's `name` empty), and in development the\r\n * first one warns. Set a geometry's own fields instead.\r\n */\r\nexport interface Passthrough3D {\r\n params?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * A partial revolution, shared by every shape that has one.\r\n *\r\n * `Ellipse` has said `startAngle` / `sweep` in degrees since the beginning, so 3D\r\n * says it too. It replaces three's five spellings of the same idea —\r\n * `thetaStart`, `thetaLength`, `phiStart`, `phiLength` and `arc` — which differ\r\n * per shape for reasons that are about three's own history rather than about\r\n * anything an author is trying to draw.\r\n */\r\nexport interface Sweep3D {\r\n /** Where the revolution begins, in **degrees**. Default 0. */\r\n startAngle?: number;\r\n /** How far it runs, in **degrees**. Default 360 (or 180 for a half sweep). */\r\n sweep?: number;\r\n}\r\n\r\n// ─── Primitives ──────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * A box.\r\n *\r\n * `cornerRadius` is the same control `Rect` carries in 2D and rounds all twelve\r\n * edges; it is most of the difference between a scene that reads as designed and\r\n * one that reads as a renderer test. See `evaluateRoundedBox` for how the\r\n * surface is built.\r\n */\r\nexport interface BoxGeometry3D extends Passthrough3D {\r\n type: \"box\";\r\n width?: number;\r\n height?: number;\r\n depth?: number;\r\n /** Rounds every edge and corner. Clamped to the smallest half-extent. */\r\n cornerRadius?: number;\r\n /** Face subdivision, as `[x, y, z]`. Default 1. */\r\n segments?: Segments3D;\r\n}\r\n\r\n/** A sphere, or a wedge/band of one via {@link Sweep3D} and the latitude pair. */\r\nexport interface SphereGeometry3D extends Passthrough3D, Sweep3D {\r\n type: \"sphere\";\r\n radius?: number;\r\n /** `[longitude, latitude]`. Default `[32, 16]`. */\r\n segments?: Segments3D;\r\n /** Vertical band start, in **degrees** from the north pole. Default 0. */\r\n startLatitude?: number;\r\n /** Vertical band extent, in **degrees**. Default 180 (pole to pole). */\r\n latitudeSweep?: number;\r\n}\r\n\r\nexport interface PlaneGeometry3D extends Passthrough3D {\r\n type: \"plane\";\r\n width?: number;\r\n height?: number;\r\n /** `[width, height]`. Raise to subdivide for per-vertex displacement. */\r\n segments?: Segments3D;\r\n}\r\n\r\n/**\r\n * A cylinder, or any tapered tube.\r\n *\r\n * `radius` takes `[top, bottom]` for a taper, which is what `radiusTop` and\r\n * `radiusBottom` were — one field, and the pair reads as the thing it describes.\r\n */\r\nexport interface CylinderGeometry3D extends Passthrough3D, Sweep3D {\r\n type: \"cylinder\";\r\n /** A scalar, or `[top, bottom]` to taper. Default 1. */\r\n radius?: number | readonly [number, number];\r\n height?: number;\r\n /** `[radial, height]`. Default `[32, 1]`. */\r\n segments?: Segments3D;\r\n /** Draw the end caps. Default true. */\r\n capped?: boolean;\r\n}\r\n\r\nexport interface ConeGeometry3D extends Passthrough3D, Sweep3D {\r\n type: \"cone\";\r\n radius?: number;\r\n height?: number;\r\n /** `[radial, height]`. Default `[32, 1]`. */\r\n segments?: Segments3D;\r\n /** Draw the base cap. Default true. */\r\n capped?: boolean;\r\n}\r\n\r\nexport interface TorusGeometry3D extends Passthrough3D, Sweep3D {\r\n type: \"torus\";\r\n /** Distance from the centre to the middle of the ring. */\r\n radius?: number;\r\n /** Thickness of the ring itself. Default 0.4. */\r\n thickness?: number;\r\n /** `[radial, tubular]`. Default `[16, 48]`. */\r\n segments?: Segments3D;\r\n}\r\n\r\nexport interface TorusKnotGeometry3D extends Passthrough3D {\r\n type: \"torusKnot\";\r\n radius?: number;\r\n /** Thickness of the strand. Default 0.4. */\r\n thickness?: number;\r\n /** `[tubular, radial]`. Default `[64, 8]`. */\r\n segments?: Segments3D;\r\n /** Winding counts as `[around the axis, around the torus]`. Default `[2, 3]`. */\r\n windings?: readonly [number, number];\r\n}\r\n\r\nexport interface CircleGeometry3D extends Passthrough3D, Sweep3D {\r\n type: \"circle\";\r\n radius?: number;\r\n /** Default 32. */\r\n segments?: Segments3D;\r\n}\r\n\r\n/** A flat annulus — a disc with a hole. */\r\nexport interface RingGeometry3D extends Passthrough3D, Sweep3D {\r\n type: \"ring\";\r\n /** Outer radius. Default 1. */\r\n radius?: number;\r\n /** Inner radius — the size of the hole. Default 0.5. */\r\n innerRadius?: number;\r\n /** `[around, radial]`. Default `[32, 1]`. */\r\n segments?: Segments3D;\r\n}\r\n\r\nexport interface CapsuleGeometry3D extends Passthrough3D {\r\n type: \"capsule\";\r\n /** Default 0.5. */\r\n radius?: number;\r\n /** Length of the straight mid-section, excluding the caps. Default 1. */\r\n height?: number;\r\n /** `[radial, cap]`. Default `[16, 8]`. */\r\n segments?: Segments3D;\r\n}\r\n\r\nexport interface PolyhedronGeometry3D extends Passthrough3D {\r\n type: \"polyhedron\";\r\n shape: \"tetrahedron\" | \"octahedron\" | \"icosahedron\" | \"dodecahedron\";\r\n radius?: number;\r\n /** Subdivision. Raising this on an icosahedron approximates a sphere. */\r\n segments?: Segments3D;\r\n}\r\n\r\n// ─── Path-derived (reuses core's own 2D path vocabulary) ─────────────────────\r\n\r\n/** How an extrusion's edge is chamfered. A bare number is the bevel's size. */\r\nexport interface Bevel3D {\r\n size?: number;\r\n thickness?: number;\r\n offset?: number;\r\n segments?: number;\r\n}\r\n\r\n/**\r\n * A 2D outline swept into a solid. `path` accepts the same `PathData` (SVG\r\n * string or command list) or {@link PathBuilder} the 2D `Path` node takes — same\r\n * name, same value — so an existing 2D outline becomes an extruded solid with no\r\n * new vocabulary.\r\n */\r\nexport interface ExtrudeGeometry3D extends Passthrough3D {\r\n type: \"extrude\";\r\n path: PathData | PathBuilder;\r\n depth?: number;\r\n /** Curve flattening resolution. Default 12. */\r\n segments?: Segments3D;\r\n /** A number is the bevel size; an object tunes the rest. Omit for no bevel. */\r\n bevel?: number | Bevel3D;\r\n}\r\n\r\n/** A profile revolved about the Y axis — vases, bowls, turned shapes. */\r\nexport interface LatheGeometry3D extends Passthrough3D, Sweep3D {\r\n type: \"lathe\";\r\n /** Profile points in the XY plane; `x` is the radius, `y` the height. */\r\n points: readonly Vector3Input[];\r\n /** Default 12. */\r\n segments?: Segments3D;\r\n}\r\n\r\n/** A circular cross-section swept along a 3D curve. */\r\nexport interface TubeGeometry3D extends Passthrough3D {\r\n type: \"tube\";\r\n points: readonly Vector3Input[];\r\n radius?: number;\r\n /** `[along the curve, around it]`. Default `[64, 8]`. */\r\n segments?: Segments3D;\r\n closed?: boolean;\r\n}\r\n\r\n// ─── Arbitrary vertex data ───────────────────────────────────────────────────\r\n\r\n/**\r\n * Raw vertex buffers — the general escape hatch that makes *any* computable mesh\r\n * expressible without leaving pure data.\r\n *\r\n * `position` is required and holds `[x, y, z, x, y, z, …]`. `index` lets vertices\r\n * be shared between faces. Omit `normal` and set {@link computeNormals} to have\r\n * them derived.\r\n */\r\nexport interface BufferGeometry3D extends Passthrough3D {\r\n type: \"buffer\";\r\n /** Flat `xyz` triples. */\r\n position: ArrayLike<number>;\r\n /** Flat `xyz` triples. Omit and set {@link computeNormals} to derive them. */\r\n normal?: ArrayLike<number>;\r\n /** Flat `uv` pairs. */\r\n uv?: ArrayLike<number>;\r\n /** Flat linear `rgb` triples. Needs `vertexColors: true` on the material. */\r\n color?: ArrayLike<number>;\r\n /** Triangle indices into the arrays above. */\r\n index?: ArrayLike<number>;\r\n /** Derive vertex normals after upload — needed for correct lighting. */\r\n computeNormals?: boolean;\r\n /**\r\n * Bump after mutating an array **in place** to force a re-upload.\r\n *\r\n * Reusing one `Float32Array` across frames and writing into it is the fast\r\n * way to animate a mesh, but it defeats identity comparison — the renderer\r\n * sees the same array object and cannot tell the contents changed. Bumping\r\n * `revision` tells it explicitly.\r\n *\r\n * With `revision` omitted the renderer re-uploads every frame, which is\r\n * correct-by-default for a buffer you built deliberately. Set\r\n * {@link staticData} once the data stops changing.\r\n */\r\n revision?: number;\r\n /**\r\n * Declare the arrays immutable, so the renderer compares by identity alone\r\n * and skips the per-frame re-upload. Only safe when you never mutate in place.\r\n */\r\n staticData?: boolean;\r\n}\r\n\r\n/** One evaluated vertex of a {@link ParametricGeometry3D} surface. */\r\nexport type ParametricVertex3D = Vector3 | readonly [number, number, number];\r\n\r\n/**\r\n * A surface sampled over a `[0,1] × [0,1]` grid — the ergonomic form of\r\n * {@link BufferGeometry3D} for procedural meshes (waves, terrain, ribbons).\r\n *\r\n * Core evaluates the callbacks into vertex buffers at record time, so the\r\n * descriptor handed to the renderer is still plain data. Re-evaluated every\r\n * frame, so read the node's props and the frame time inside `vertex`.\r\n *\r\n * Geo.parametric({\r\n * segments: [70, 70],\r\n * vertex: (u, v) => ({ x: (u - 0.5) * 20, y: wave(u, v, t), z: (v - 0.5) * 20 }),\r\n * computeNormals: true,\r\n * })\r\n */\r\nexport interface ParametricGeometry3D extends Passthrough3D {\r\n type: \"parametric\";\r\n /** Grid resolution as `[u, v]`, or one number for both. */\r\n segments: Segments3D;\r\n /** Position for grid coordinate `(u, v)`, both in `[0, 1]`. */\r\n vertex: (u: number, v: number) => ParametricVertex3D;\r\n /** Optional per-vertex colour. Needs `vertexColors: true` on the material. */\r\n color?: (u: number, v: number, position: Vector3) => Color;\r\n /** Derive vertex normals. Almost always wanted for a lit surface. */\r\n computeNormals?: boolean;\r\n /**\r\n * A value that changes exactly when {@link vertex} would return something\r\n * different — supply it and the surface is re-evaluated only when it moves.\r\n *\r\n * Omitted (the default) the surface is re-evaluated **every frame**, which is\r\n * what makes the `read the node's props and the frame time inside vertex` contract\r\n * above work without any bookkeeping. It is also expensive: `segments: 80` is\r\n * ~6.6k calls to `vertex`, plus normals and a full buffer re-upload, and a\r\n * frame draws for any reason at all — an unrelated node being dragged, the\r\n * camera orbiting, a tween elsewhere in the scene. A surface whose shape did\r\n * not change pays all of that for an identical result.\r\n *\r\n * `vertex` is a closure, so the renderer cannot inspect what it captured;\r\n * only the author knows. Derive this from exactly those captures — the\r\n * domain, the amplitude, the identity of the function being plotted — and\r\n * leave it out for a surface that genuinely varies with time.\r\n *\r\n * Same name and same role as {@link BufferGeometry3D.revision}: the explicit\r\n * \"this is what changed\" marker. `segments` needs no help here, being plain\r\n * data the renderer already compares.\r\n */\r\n revision?: number;\r\n}\r\n\r\n// ─── Derived ─────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * The hard edges of another geometry, as line segments — a clean wireframe\r\n * outline without the diagonals of a triangulated one. Draw it with\r\n * `Graphics3D.line({ segments: true })`.\r\n */\r\nexport interface EdgesGeometry3D extends Passthrough3D {\r\n type: \"edges\";\r\n source: Geometry3D;\r\n /** Minimum dihedral angle in **degrees** for an edge to count. Default 1. */\r\n thresholdAngle?: number;\r\n}\r\n\r\n/** Every triangle edge of another geometry, as line segments. */\r\nexport interface WireframeGeometry3D extends Passthrough3D {\r\n type: \"wireframe\";\r\n source: Geometry3D;\r\n}\r\n\r\n/** Geometry taken from a loaded model file, by node name. */\r\nexport interface ModelGeometry3D extends Passthrough3D {\r\n type: \"modelGeometry\";\r\n src: string;\r\n /** Which node of the model to take. Defaults to the first mesh found. */\r\n node?: string;\r\n}\r\n\r\n/** Normalize {@link CylinderGeometry3D.radius} to its `[top, bottom]` pair. */\r\nexport function cylinderRadii(\r\n radius: number | readonly [number, number] | undefined,\r\n): [number, number] {\r\n if (radius === undefined) return [1, 1];\r\n if (typeof radius === \"number\") return [radius, radius];\r\n return [radius[0] ?? 1, radius[1] ?? radius[0] ?? 1];\r\n}\r\n\r\n/** Normalize {@link ExtrudeGeometry3D.bevel} to its full option set, or `null`. */\r\nexport function resolveBevel3D(bevel: number | Bevel3D | undefined): Required<Bevel3D> | null {\r\n if (bevel === undefined) return null;\r\n const options = typeof bevel === \"number\" ? { size: bevel } : bevel;\r\n const size = options.size ?? 0.1;\r\n return {\r\n size,\r\n // Scaled off `size` rather than defaulted independently, so the one-number\r\n // form produces a bevel with sane proportions instead of a sliver.\r\n thickness: options.thickness ?? size * 2,\r\n offset: options.offset ?? 0,\r\n segments: options.segments ?? 3,\r\n };\r\n}\r\n\r\n/**\r\n * Evaluate a {@link ParametricGeometry3D} into concrete vertex buffers.\r\n *\r\n * Lives in core rather than the renderer so the grid/winding maths is\r\n * backend-agnostic and unit-testable without a GPU. Called by the renderer at\r\n * draw time (not at record time) so the cost is only paid when the frame is\r\n * actually rasterized, and never during the asset-tracking replay.\r\n *\r\n * The grid is `(segments + 1)²` vertices wound counter-clockwise, so front faces\r\n * point along +Y for a surface authored in the XZ plane.\r\n */\r\nexport function evaluateParametric(geometry: ParametricGeometry3D): BufferGeometry3D {\r\n const resolved = geometry.segments;\r\n const [uSegments, vSegments] = typeof resolved === \"number\"\r\n ? [resolved, resolved]\r\n : [resolved[0] ?? 1, resolved[1] ?? resolved[0] ?? 1];\r\n\r\n const uCount = Math.max(1, Math.floor(uSegments)) + 1;\r\n const vCount = Math.max(1, Math.floor(vSegments)) + 1;\r\n\r\n const position = new Float32Array(uCount * vCount * 3);\r\n const uv = new Float32Array(uCount * vCount * 2);\r\n const color = geometry.color ? new Float32Array(uCount * vCount * 3) : undefined;\r\n\r\n const scratch: Vector3 = { x: 0, y: 0, z: 0 };\r\n\r\n for (let vi = 0; vi < vCount; vi++) {\r\n const v = vi / (vCount - 1);\r\n for (let ui = 0; ui < uCount; ui++) {\r\n const u = ui / (uCount - 1);\r\n const index = vi * uCount + ui;\r\n\r\n const vertex = geometry.vertex(u, v);\r\n if (Array.isArray(vertex)) {\r\n scratch.x = vertex[0]; scratch.y = vertex[1]; scratch.z = vertex[2];\r\n } else {\r\n const p = vertex as Vector3;\r\n scratch.x = p.x; scratch.y = p.y; scratch.z = p.z;\r\n }\r\n\r\n position[index * 3] = scratch.x;\r\n position[index * 3 + 1] = scratch.y;\r\n position[index * 3 + 2] = scratch.z;\r\n\r\n uv[index * 2] = u;\r\n uv[index * 2 + 1] = v;\r\n\r\n if (color && geometry.color) {\r\n const rgba = resolveLinearRgb(geometry.color(u, v, scratch));\r\n color[index * 3] = rgba[0];\r\n color[index * 3 + 1] = rgba[1];\r\n color[index * 3 + 2] = rgba[2];\r\n }\r\n }\r\n }\r\n\r\n // Two triangles per cell. Uint32 because a 256² grid already exceeds Uint16.\r\n const index = new Uint32Array((uCount - 1) * (vCount - 1) * 6);\r\n let cursor = 0;\r\n for (let vi = 0; vi < vCount - 1; vi++) {\r\n for (let ui = 0; ui < uCount - 1; ui++) {\r\n const a = vi * uCount + ui;\r\n const b = a + 1;\r\n const c = a + uCount;\r\n const d = c + 1;\r\n index[cursor++] = a; index[cursor++] = c; index[cursor++] = b;\r\n index[cursor++] = b; index[cursor++] = c; index[cursor++] = d;\r\n }\r\n }\r\n\r\n return {\r\n type: \"buffer\",\r\n position,\r\n uv,\r\n color,\r\n index,\r\n computeNormals: geometry.computeNormals,\r\n params: geometry.params,\r\n };\r\n}\r\n\r\n/**\r\n * A {@link Color} as **linear-light** RGB, which is what a vertex-colour buffer\r\n * must hold: a renderer samples that attribute directly into its linear working\r\n * space, with no decode step of its own.\r\n *\r\n * `parseColor` returns gamma-encoded sRGB (hex is `byte / 255`), so the sRGB\r\n * transfer function has to be inverted here. Skipping this renders vertex-coloured\r\n * surfaces visibly washed out.\r\n */\r\nfunction resolveLinearRgb(color: Color): readonly [number, number, number] {\r\n const [r, g, b] = typeof color === \"string\" ? parseColor(color) : color;\r\n return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)];\r\n}\r\n\r\n/** Inverse sRGB transfer function (IEC 61966-2-1), per channel. */\r\nfunction srgbToLinear(channel: number): number {\r\n return channel <= 0.04045\r\n ? channel / 12.92\r\n : Math.pow((channel + 0.055) / 1.055, 2.4);\r\n}\r\n\r\n/**\r\n * Every geometry a mesh can be built from. Discriminated on `type`, so new\r\n * shapes are additive.\r\n */\r\nexport type Geometry3D =\r\n | BoxGeometry3D\r\n | SphereGeometry3D\r\n | PlaneGeometry3D\r\n | CylinderGeometry3D\r\n | ConeGeometry3D\r\n | TorusGeometry3D\r\n | TorusKnotGeometry3D\r\n | CircleGeometry3D\r\n | RingGeometry3D\r\n | CapsuleGeometry3D\r\n | PolyhedronGeometry3D\r\n | ExtrudeGeometry3D\r\n | LatheGeometry3D\r\n | TubeGeometry3D\r\n | BufferGeometry3D\r\n | ParametricGeometry3D\r\n | EdgesGeometry3D\r\n | WireframeGeometry3D\r\n | ModelGeometry3D;\r\n"]}
|
|
1
|
+
{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/render3d/geometry.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PathData } from \"@/render/descriptors/path\";\nimport type { PathBuilder } from \"@/render/descriptors/path-builder\";\nimport { type Color, parseColor } from \"@/attributes/shape/fill/color/parser\";\nimport type { Vector3, Vector3Input } from \"./vector3\";\nimport type { Segments3D } from \"./segments\";\n\n/**\n * Anything not modelled by a named field, assigned straight onto the constructed\n * object. The documented last resort — unsafe by construction (it bypasses the\n * type system, and the renderer treats any change to it as a full rebuild since\n * it cannot know what a given key affects), but it means no author is ever\n * blocked waiting for a field to be modelled here.\n *\n * **Where it is applied**: materials, lights (and a light's `shadow`) and\n * cameras. **Where it is not**: geometries, the environment and post effects. A\n * `params` there is recorded and nothing reads it (probe: `box({ params: { name:\n * \"x\" } })` leaves the built geometry's `name` empty), and in development the\n * first one warns. Set a geometry's own fields instead.\n */\nexport interface Passthrough3D {\n params?: Record<string, unknown>;\n}\n\n/**\n * A partial revolution, shared by every shape that has one.\n *\n * `Ellipse` has said `startAngle` / `sweep` in degrees since the beginning, so 3D\n * says it too. It replaces three's five spellings of the same idea —\n * `thetaStart`, `thetaLength`, `phiStart`, `phiLength` and `arc` — which differ\n * per shape for reasons that are about three's own history rather than about\n * anything an author is trying to draw.\n */\nexport interface Sweep3D {\n /** Where the revolution begins, in **degrees**. Default 0. */\n startAngle?: number;\n /** How far it runs, in **degrees**. Default 360 (or 180 for a half sweep). */\n sweep?: number;\n}\n\n// ─── Primitives ──────────────────────────────────────────────────────────────\n\n/**\n * A box.\n *\n * `cornerRadius` is the same control `Rect` carries in 2D and rounds all twelve\n * edges; it is most of the difference between a scene that reads as designed and\n * one that reads as a renderer test. See `evaluateRoundedBox` for how the\n * surface is built.\n */\nexport interface BoxGeometry3D extends Passthrough3D {\n type: \"box\";\n width?: number;\n height?: number;\n depth?: number;\n /** Rounds every edge and corner. Clamped to the smallest half-extent. */\n cornerRadius?: number;\n /** Face subdivision, as `[x, y, z]`. Default 1. */\n segments?: Segments3D;\n}\n\n/** A sphere, or a wedge/band of one via {@link Sweep3D} and the latitude pair. */\nexport interface SphereGeometry3D extends Passthrough3D, Sweep3D {\n type: \"sphere\";\n radius?: number;\n /** `[longitude, latitude]`. Default `[32, 16]`. */\n segments?: Segments3D;\n /** Vertical band start, in **degrees** from the north pole. Default 0. */\n startLatitude?: number;\n /** Vertical band extent, in **degrees**. Default 180 (pole to pole). */\n latitudeSweep?: number;\n}\n\nexport interface PlaneGeometry3D extends Passthrough3D {\n type: \"plane\";\n width?: number;\n height?: number;\n /** `[width, height]`. Raise to subdivide for per-vertex displacement. */\n segments?: Segments3D;\n}\n\n/**\n * A cylinder, or any tapered tube.\n *\n * `radius` takes `[top, bottom]` for a taper, which is what `radiusTop` and\n * `radiusBottom` were — one field, and the pair reads as the thing it describes.\n */\nexport interface CylinderGeometry3D extends Passthrough3D, Sweep3D {\n type: \"cylinder\";\n /** A scalar, or `[top, bottom]` to taper. Default 1. */\n radius?: number | readonly [number, number];\n height?: number;\n /** `[radial, height]`. Default `[32, 1]`. */\n segments?: Segments3D;\n /** Draw the end caps. Default true. */\n capped?: boolean;\n}\n\nexport interface ConeGeometry3D extends Passthrough3D, Sweep3D {\n type: \"cone\";\n radius?: number;\n height?: number;\n /** `[radial, height]`. Default `[32, 1]`. */\n segments?: Segments3D;\n /** Draw the base cap. Default true. */\n capped?: boolean;\n}\n\nexport interface TorusGeometry3D extends Passthrough3D, Sweep3D {\n type: \"torus\";\n /** Distance from the centre to the middle of the ring. */\n radius?: number;\n /** Thickness of the ring itself. Default 0.4. */\n thickness?: number;\n /** `[radial, tubular]`. Default `[16, 48]`. */\n segments?: Segments3D;\n}\n\nexport interface TorusKnotGeometry3D extends Passthrough3D {\n type: \"torusKnot\";\n radius?: number;\n /** Thickness of the strand. Default 0.4. */\n thickness?: number;\n /** `[tubular, radial]`. Default `[64, 8]`. */\n segments?: Segments3D;\n /** Winding counts as `[around the axis, around the torus]`. Default `[2, 3]`. */\n windings?: readonly [number, number];\n}\n\nexport interface CircleGeometry3D extends Passthrough3D, Sweep3D {\n type: \"circle\";\n radius?: number;\n /** Default 32. */\n segments?: Segments3D;\n}\n\n/** A flat annulus — a disc with a hole. */\nexport interface RingGeometry3D extends Passthrough3D, Sweep3D {\n type: \"ring\";\n /** Outer radius. Default 1. */\n radius?: number;\n /** Inner radius — the size of the hole. Default 0.5. */\n innerRadius?: number;\n /** `[around, radial]`. Default `[32, 1]`. */\n segments?: Segments3D;\n}\n\nexport interface CapsuleGeometry3D extends Passthrough3D {\n type: \"capsule\";\n /** Default 0.5. */\n radius?: number;\n /** Length of the straight mid-section, excluding the caps. Default 1. */\n height?: number;\n /** `[radial, cap]`. Default `[16, 8]`. */\n segments?: Segments3D;\n}\n\nexport interface PolyhedronGeometry3D extends Passthrough3D {\n type: \"polyhedron\";\n shape: \"tetrahedron\" | \"octahedron\" | \"icosahedron\" | \"dodecahedron\";\n radius?: number;\n /** Subdivision. Raising this on an icosahedron approximates a sphere. */\n segments?: Segments3D;\n}\n\n// ─── Path-derived (reuses core's own 2D path vocabulary) ─────────────────────\n\n/** How an extrusion's edge is chamfered. A bare number is the bevel's size. */\nexport interface Bevel3D {\n size?: number;\n thickness?: number;\n offset?: number;\n segments?: number;\n}\n\n/**\n * A 2D outline swept into a solid. `path` accepts the same `PathData` (SVG\n * string or command list) or {@link PathBuilder} the 2D `Path` node takes — same\n * name, same value — so an existing 2D outline becomes an extruded solid with no\n * new vocabulary.\n */\nexport interface ExtrudeGeometry3D extends Passthrough3D {\n type: \"extrude\";\n path: PathData | PathBuilder;\n depth?: number;\n /** Curve flattening resolution. Default 12. */\n segments?: Segments3D;\n /** A number is the bevel size; an object tunes the rest. Omit for no bevel. */\n bevel?: number | Bevel3D;\n}\n\n/** A profile revolved about the Y axis — vases, bowls, turned shapes. */\nexport interface LatheGeometry3D extends Passthrough3D, Sweep3D {\n type: \"lathe\";\n /** Profile points in the XY plane; `x` is the radius, `y` the height. */\n points: readonly Vector3Input[];\n /** Default 12. */\n segments?: Segments3D;\n}\n\n/** A circular cross-section swept along a 3D curve. */\nexport interface TubeGeometry3D extends Passthrough3D {\n type: \"tube\";\n points: readonly Vector3Input[];\n radius?: number;\n /** `[along the curve, around it]`. Default `[64, 8]`. */\n segments?: Segments3D;\n closed?: boolean;\n}\n\n// ─── Arbitrary vertex data ───────────────────────────────────────────────────\n\n/**\n * Raw vertex buffers — the general escape hatch that makes *any* computable mesh\n * expressible without leaving pure data.\n *\n * `position` is required and holds `[x, y, z, x, y, z, …]`. `index` lets vertices\n * be shared between faces. Omit `normal` and set {@link computeNormals} to have\n * them derived.\n */\nexport interface BufferGeometry3D extends Passthrough3D {\n type: \"buffer\";\n /** Flat `xyz` triples. */\n position: ArrayLike<number>;\n /** Flat `xyz` triples. Omit and set {@link computeNormals} to derive them. */\n normal?: ArrayLike<number>;\n /** Flat `uv` pairs. */\n uv?: ArrayLike<number>;\n /** Flat linear `rgb` triples. Needs `vertexColors: true` on the material. */\n color?: ArrayLike<number>;\n /** Triangle indices into the arrays above. */\n index?: ArrayLike<number>;\n /** Derive vertex normals after upload — needed for correct lighting. */\n computeNormals?: boolean;\n /**\n * Bump after mutating an array **in place** to force a re-upload.\n *\n * Reusing one `Float32Array` across frames and writing into it is the fast\n * way to animate a mesh, but it defeats identity comparison — the renderer\n * sees the same array object and cannot tell the contents changed. Bumping\n * `revision` tells it explicitly.\n *\n * With `revision` omitted the renderer re-uploads every frame, which is\n * correct-by-default for a buffer you built deliberately. Set\n * {@link staticData} once the data stops changing.\n */\n revision?: number;\n /**\n * Declare the arrays immutable, so the renderer compares by identity alone\n * and skips the per-frame re-upload. Only safe when you never mutate in place.\n */\n staticData?: boolean;\n}\n\n/** One evaluated vertex of a {@link ParametricGeometry3D} surface. */\nexport type ParametricVertex3D = Vector3 | readonly [number, number, number];\n\n/**\n * A surface sampled over a `[0,1] × [0,1]` grid — the ergonomic form of\n * {@link BufferGeometry3D} for procedural meshes (waves, terrain, ribbons).\n *\n * Core evaluates the callbacks into vertex buffers at record time, so the\n * descriptor handed to the renderer is still plain data. Re-evaluated every\n * frame, so read the node's props and the frame time inside `vertex`.\n *\n * Geo.parametric({\n * segments: [70, 70],\n * vertex: (u, v) => ({ x: (u - 0.5) * 20, y: wave(u, v, t), z: (v - 0.5) * 20 }),\n * computeNormals: true,\n * })\n */\nexport interface ParametricGeometry3D extends Passthrough3D {\n type: \"parametric\";\n /** Grid resolution as `[u, v]`, or one number for both. */\n segments: Segments3D;\n /** Position for grid coordinate `(u, v)`, both in `[0, 1]`. */\n vertex: (u: number, v: number) => ParametricVertex3D;\n /** Optional per-vertex colour. Needs `vertexColors: true` on the material. */\n color?: (u: number, v: number, position: Vector3) => Color;\n /** Derive vertex normals. Almost always wanted for a lit surface. */\n computeNormals?: boolean;\n /**\n * A value that changes exactly when {@link vertex} would return something\n * different — supply it and the surface is re-evaluated only when it moves.\n *\n * Omitted (the default) the surface is re-evaluated **every frame**, which is\n * what makes the `read the node's props and the frame time inside vertex` contract\n * above work without any bookkeeping. It is also expensive: `segments: 80` is\n * ~6.6k calls to `vertex`, plus normals and a full buffer re-upload, and a\n * frame draws for any reason at all — an unrelated node being dragged, the\n * camera orbiting, a tween elsewhere in the scene. A surface whose shape did\n * not change pays all of that for an identical result.\n *\n * `vertex` is a closure, so the renderer cannot inspect what it captured;\n * only the author knows. Derive this from exactly those captures — the\n * domain, the amplitude, the identity of the function being plotted — and\n * leave it out for a surface that genuinely varies with time.\n *\n * Same name and same role as {@link BufferGeometry3D.revision}: the explicit\n * \"this is what changed\" marker. `segments` needs no help here, being plain\n * data the renderer already compares.\n */\n revision?: number;\n}\n\n// ─── Derived ─────────────────────────────────────────────────────────────────\n\n/**\n * The hard edges of another geometry, as line segments — a clean wireframe\n * outline without the diagonals of a triangulated one. Draw it with\n * `Graphics3D.line({ segments: true })`.\n */\nexport interface EdgesGeometry3D extends Passthrough3D {\n type: \"edges\";\n source: Geometry3D;\n /** Minimum dihedral angle in **degrees** for an edge to count. Default 1. */\n thresholdAngle?: number;\n}\n\n/** Every triangle edge of another geometry, as line segments. */\nexport interface WireframeGeometry3D extends Passthrough3D {\n type: \"wireframe\";\n source: Geometry3D;\n}\n\n/** Geometry taken from a loaded model file, by node name. */\nexport interface ModelGeometry3D extends Passthrough3D {\n type: \"modelGeometry\";\n src: string;\n /** Which node of the model to take. Defaults to the first mesh found. */\n node?: string;\n}\n\n/** Normalize {@link CylinderGeometry3D.radius} to its `[top, bottom]` pair. */\nexport function cylinderRadii(\n radius: number | readonly [number, number] | undefined,\n): [number, number] {\n if (radius === undefined) return [1, 1];\n if (typeof radius === \"number\") return [radius, radius];\n return [radius[0] ?? 1, radius[1] ?? radius[0] ?? 1];\n}\n\n/** Normalize {@link ExtrudeGeometry3D.bevel} to its full option set, or `null`. */\nexport function resolveBevel3D(bevel: number | Bevel3D | undefined): Required<Bevel3D> | null {\n if (bevel === undefined) return null;\n const options = typeof bevel === \"number\" ? { size: bevel } : bevel;\n const size = options.size ?? 0.1;\n return {\n size,\n // Scaled off `size` rather than defaulted independently, so the one-number\n // form produces a bevel with sane proportions instead of a sliver.\n thickness: options.thickness ?? size * 2,\n offset: options.offset ?? 0,\n segments: options.segments ?? 3,\n };\n}\n\n/**\n * Evaluate a {@link ParametricGeometry3D} into concrete vertex buffers.\n *\n * Lives in core rather than the renderer so the grid/winding maths is\n * backend-agnostic and unit-testable without a GPU. Called by the renderer at\n * draw time (not at record time) so the cost is only paid when the frame is\n * actually rasterized, and never during the asset-tracking replay.\n *\n * The grid is `(segments + 1)²` vertices wound counter-clockwise, so front faces\n * point along +Y for a surface authored in the XZ plane.\n */\nexport function evaluateParametric(geometry: ParametricGeometry3D): BufferGeometry3D {\n const resolved = geometry.segments;\n const [uSegments, vSegments] = typeof resolved === \"number\"\n ? [resolved, resolved]\n : [resolved[0] ?? 1, resolved[1] ?? resolved[0] ?? 1];\n\n const uCount = Math.max(1, Math.floor(uSegments)) + 1;\n const vCount = Math.max(1, Math.floor(vSegments)) + 1;\n\n const position = new Float32Array(uCount * vCount * 3);\n const uv = new Float32Array(uCount * vCount * 2);\n const color = geometry.color ? new Float32Array(uCount * vCount * 3) : undefined;\n\n const scratch: Vector3 = { x: 0, y: 0, z: 0 };\n\n for (let vi = 0; vi < vCount; vi++) {\n const v = vi / (vCount - 1);\n for (let ui = 0; ui < uCount; ui++) {\n const u = ui / (uCount - 1);\n const index = vi * uCount + ui;\n\n const vertex = geometry.vertex(u, v);\n if (Array.isArray(vertex)) {\n scratch.x = vertex[0]; scratch.y = vertex[1]; scratch.z = vertex[2];\n } else {\n const p = vertex as Vector3;\n scratch.x = p.x; scratch.y = p.y; scratch.z = p.z;\n }\n\n position[index * 3] = scratch.x;\n position[index * 3 + 1] = scratch.y;\n position[index * 3 + 2] = scratch.z;\n\n uv[index * 2] = u;\n uv[index * 2 + 1] = v;\n\n if (color && geometry.color) {\n const rgba = resolveLinearRgb(geometry.color(u, v, scratch));\n color[index * 3] = rgba[0];\n color[index * 3 + 1] = rgba[1];\n color[index * 3 + 2] = rgba[2];\n }\n }\n }\n\n // Two triangles per cell. Uint32 because a 256² grid already exceeds Uint16.\n const index = new Uint32Array((uCount - 1) * (vCount - 1) * 6);\n let cursor = 0;\n for (let vi = 0; vi < vCount - 1; vi++) {\n for (let ui = 0; ui < uCount - 1; ui++) {\n const a = vi * uCount + ui;\n const b = a + 1;\n const c = a + uCount;\n const d = c + 1;\n index[cursor++] = a; index[cursor++] = c; index[cursor++] = b;\n index[cursor++] = b; index[cursor++] = c; index[cursor++] = d;\n }\n }\n\n return {\n type: \"buffer\",\n position,\n uv,\n color,\n index,\n computeNormals: geometry.computeNormals,\n params: geometry.params,\n };\n}\n\n/**\n * A {@link Color} as **linear-light** RGB, which is what a vertex-colour buffer\n * must hold: a renderer samples that attribute directly into its linear working\n * space, with no decode step of its own.\n *\n * `parseColor` returns gamma-encoded sRGB (hex is `byte / 255`), so the sRGB\n * transfer function has to be inverted here. Skipping this renders vertex-coloured\n * surfaces visibly washed out.\n */\nfunction resolveLinearRgb(color: Color): readonly [number, number, number] {\n const [r, g, b] = typeof color === \"string\" ? parseColor(color) : color;\n return [srgbToLinear(r), srgbToLinear(g), srgbToLinear(b)];\n}\n\n/** Inverse sRGB transfer function (IEC 61966-2-1), per channel. */\nfunction srgbToLinear(channel: number): number {\n return channel <= 0.04045\n ? channel / 12.92\n : Math.pow((channel + 0.055) / 1.055, 2.4);\n}\n\n/**\n * Every geometry a mesh can be built from. Discriminated on `type`, so new\n * shapes are additive.\n */\nexport type Geometry3D =\n | BoxGeometry3D\n | SphereGeometry3D\n | PlaneGeometry3D\n | CylinderGeometry3D\n | ConeGeometry3D\n | TorusGeometry3D\n | TorusKnotGeometry3D\n | CircleGeometry3D\n | RingGeometry3D\n | CapsuleGeometry3D\n | PolyhedronGeometry3D\n | ExtrudeGeometry3D\n | LatheGeometry3D\n | TubeGeometry3D\n | BufferGeometry3D\n | ParametricGeometry3D\n | EdgesGeometry3D\n | WireframeGeometry3D\n | ModelGeometry3D;\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graphics3d.d.ts","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sCAAsC,CAAC;AAClE,OAAO,KAAK,EACR,aAAa,
|
|
1
|
+
{"version":3,"file":"graphics3d.d.ts","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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"}
|
|
@@ -265,7 +265,7 @@ export class Graphics3D {
|
|
|
265
265
|
};
|
|
266
266
|
this.record({
|
|
267
267
|
kind: "line",
|
|
268
|
-
geometry: geometry ??
|
|
268
|
+
geometry: geometry ?? lineBuffer(points),
|
|
269
269
|
material: resolved,
|
|
270
270
|
mode: segments ? "segments" : closed ? "loop" : "strip",
|
|
271
271
|
transform: pickTransform(options),
|
|
@@ -320,21 +320,70 @@ export class Graphics3D {
|
|
|
320
320
|
return this._ops.length === 0;
|
|
321
321
|
}
|
|
322
322
|
}
|
|
323
|
+
/** The buffer each points array was last flattened into, and the revision it was uploaded under. */
|
|
324
|
+
const lineBuffers = new WeakMap();
|
|
325
|
+
let lineRevision = 0;
|
|
326
|
+
/**
|
|
327
|
+
* `points` as a line's buffer. The same array holding the same values gets the
|
|
328
|
+
* same buffer and revision back, so a renderer uploads an unchanged line once,
|
|
329
|
+
* not every frame; the values are checked, so one changed in place still lands.
|
|
330
|
+
*/
|
|
331
|
+
function lineBuffer(points) {
|
|
332
|
+
let kept = lineBuffers.get(points);
|
|
333
|
+
if (!kept || !holds(kept.position, points)) {
|
|
334
|
+
kept = { position: flattenPoints(points), revision: ++lineRevision };
|
|
335
|
+
lineBuffers.set(points, kept);
|
|
336
|
+
}
|
|
337
|
+
return { type: "buffer", position: kept.position, revision: kept.revision };
|
|
338
|
+
}
|
|
323
339
|
/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */
|
|
324
340
|
function flattenPoints(points) {
|
|
325
|
-
const out =
|
|
341
|
+
const out = new Float32Array(points.length * 3);
|
|
342
|
+
let i = 0;
|
|
326
343
|
for (const point of points) {
|
|
327
344
|
if (typeof point === "number") {
|
|
328
|
-
out
|
|
345
|
+
out[i] = out[i + 1] = out[i + 2] = point;
|
|
329
346
|
}
|
|
330
347
|
else if (Array.isArray(point)) {
|
|
331
|
-
out
|
|
348
|
+
out[i] = point[0] ?? 0;
|
|
349
|
+
out[i + 1] = point[1] ?? 0;
|
|
350
|
+
out[i + 2] = point[2] ?? 0;
|
|
332
351
|
}
|
|
333
352
|
else {
|
|
334
353
|
const v = point;
|
|
335
|
-
out
|
|
354
|
+
out[i] = v.x ?? 0;
|
|
355
|
+
out[i + 1] = v.y ?? 0;
|
|
356
|
+
out[i + 2] = v.z ?? 0;
|
|
336
357
|
}
|
|
358
|
+
i += 3;
|
|
337
359
|
}
|
|
338
360
|
return out;
|
|
339
361
|
}
|
|
362
|
+
/** Whether `buffer` is what flattening `points` would give. */
|
|
363
|
+
function holds(buffer, points) {
|
|
364
|
+
if (buffer.length !== points.length * 3)
|
|
365
|
+
return false;
|
|
366
|
+
let i = 0;
|
|
367
|
+
for (const point of points) {
|
|
368
|
+
let x, y, z;
|
|
369
|
+
if (typeof point === "number") {
|
|
370
|
+
x = y = z = point;
|
|
371
|
+
}
|
|
372
|
+
else if (Array.isArray(point)) {
|
|
373
|
+
x = point[0] ?? 0;
|
|
374
|
+
y = point[1] ?? 0;
|
|
375
|
+
z = point[2] ?? 0;
|
|
376
|
+
}
|
|
377
|
+
else {
|
|
378
|
+
const v = point;
|
|
379
|
+
x = v.x ?? 0;
|
|
380
|
+
y = v.y ?? 0;
|
|
381
|
+
z = v.z ?? 0;
|
|
382
|
+
}
|
|
383
|
+
if (buffer[i] !== Math.fround(x) || buffer[i + 1] !== Math.fround(y) || buffer[i + 2] !== Math.fround(z))
|
|
384
|
+
return false;
|
|
385
|
+
i += 3;
|
|
386
|
+
}
|
|
387
|
+
return true;
|
|
388
|
+
}
|
|
340
389
|
//# sourceMappingURL=graphics3d.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graphics3d.js","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type {\r\n BoxGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\r\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\r\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\r\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\r\n} from \"./geometry\";\r\nimport type { Material3D, Shading3D } from \"./material\";\r\nimport type { Texture3D } from \"./texture\";\r\nimport { resolveFill3D, type Fill3D } from \"./fill3d\";\r\nimport { inspectDrawable3D } from \"./inert\";\r\nimport { type Transform3D, type Blend3D, type Faces3D } from \"./transform\";\r\nimport type { Vector3Input } from \"./vector3\";\r\n\r\n// ─── Ops ─────────────────────────────────────────────────────────────────────\r\n\r\n/** One clip of a model's baked animation, sampled at an explicit time. */\r\nexport interface ModelAnimation3D {\r\n /** Clip name, or its index in the file. Defaults to the first clip. */\r\n clip?: string | number;\r\n /**\r\n * Seconds into the clip. **Explicit by design** — the renderer seeks to this\r\n * time rather than advancing by a delta, which is what keeps a model's\r\n * animation identical whether the frame was reached by playing forward or by\r\n * scrubbing backwards.\r\n */\r\n time: number;\r\n /** Blend weight, for cross-fading clips. Default 1. */\r\n weight?: number;\r\n}\r\n\r\n/**\r\n * How a `line` op connects its points: in order, or as disjoint start/end pairs,\r\n * or in order and closed back to the start.\r\n */\r\nexport type LineMode3D = \"strip\" | \"segments\" | \"loop\";\r\n\r\n/**\r\n * One recorded operation in a {@link Graphics3D} command list.\r\n *\r\n * Every op draws something. Hierarchy, lights and the camera are *scene*\r\n * concerns, recorded by the `Node3D` tree into a `Scene3D` — this is only ever\r\n * \"what one node paints\", which is exactly what a `Graphics2D` is in 2D.\r\n *\r\n * A drawable's geometry and material are *inline sub-descriptors*, not ops,\r\n * because in a 3D scene graph they are properties of an object rather than\r\n * children of it.\r\n */\r\nexport type Graphics3DOp =\r\n | { kind: \"mesh\"; geometry: Geometry3D; material: Material3D | readonly Material3D[]; transform?: Transform3D }\r\n | {\r\n kind: \"instances\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n /** Per-instance placement. Length drives the instance count. */\r\n instances: readonly Transform3D[];\r\n /** Per-instance tint. Needs a material that reads instance colour. */\r\n colors?: readonly Color[];\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"points\"; geometry: Geometry3D; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"line\";\r\n geometry: Geometry3D;\r\n material: Material3D;\r\n mode: LineMode3D;\r\n transform?: Transform3D;\r\n }\r\n | { kind: \"sprite\"; material: Material3D; transform?: Transform3D }\r\n | {\r\n kind: \"model\";\r\n src: string;\r\n animation?: readonly ModelAnimation3D[];\r\n /** Replace materials on the loaded graph, keyed by mesh or material name. */\r\n override?: Readonly<Record<string, Material3D>>;\r\n transform?: Transform3D;\r\n };\r\n\r\n/**\r\n * Op kinds that put something in the scene (as opposed to shaping the tree).\r\n *\r\n * Shared with `Scene3D`, whose op list is this one plus `push`/`pop`/`light`/\r\n * `camera` — so \"is anything actually drawn here\" has a single definition.\r\n */\r\n/** @internal */\r\nexport const DRAWABLE_KINDS: ReadonlySet<string> = new Set([\r\n \"mesh\", \"light\", \"instances\", \"points\", \"line\", \"sprite\", \"model\",\r\n]);\r\n\r\n// ─── Shorthand ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Material fields promoted onto the geometry sugar methods, so the common case is\r\n * one flat call: `.box({ width: 2, fill: \"red\", roughness: 0.3 })`.\r\n *\r\n * `fill` is the whole 2D fill vocabulary — see {@link Fill3D} — and is what a\r\n * flat `color` plus a `map` slot used to be. The rest is surface *response*\r\n * (how light behaves on it) rather than colour, which is the line Spline's\r\n * material panel draws too and the reason those stay separate fields.\r\n *\r\n * These desugar at record time into a full {@link Material3D} — `standard` by\r\n * default, `basic` when {@link unlit} is set — so the recorded op list stays\r\n * canonical. Pass {@link material} to bypass the shorthand entirely; every\r\n * renderer-level knob that is not a design decision (`depthWrite`, `alphaTest`,\r\n * `toneMapped`, `polygonOffset`, …) lives there and only there.\r\n */\r\nexport interface MaterialShorthand3D {\r\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\r\n material?: Material3D | readonly Material3D[];\r\n /** What the surface is made of: a colour, a texture, a gradient, 2D content. */\r\n fill?: Fill3D;\r\n opacity?: number;\r\n roughness?: number;\r\n metalness?: number;\r\n /** Self-illumination. Bloom in the post chain is what makes it glow. */\r\n emission?: Color;\r\n emissionStrength?: number;\r\n normalMap?: Texture3D;\r\n roughnessMap?: Texture3D;\r\n metalnessMap?: Texture3D;\r\n aoMap?: Texture3D;\r\n alphaMap?: Texture3D;\r\n envMapIntensity?: number;\r\n wireframe?: boolean;\r\n /** Facet or smooth shading. Default `\"smooth\"`. */\r\n shading?: Shading3D;\r\n /** Which faces to rasterize. Default `\"front\"`. */\r\n faces?: Faces3D;\r\n vertexColors?: boolean;\r\n blend?: Blend3D;\r\n /** Shade with an unlit `basic` material instead of `standard`. */\r\n unlit?: boolean;\r\n}\r\n\r\n/** Transform + material shorthand, accepted by every geometry sugar method. */\r\nexport type MeshShorthand3D = Transform3D & MaterialShorthand3D;\r\n\r\nconst TRANSFORM_KEYS = [\r\n \"position\", \"rotation\", \"quaternion\", \"scale\", \"lookAt\",\r\n \"visible\", \"shadow\", \"renderOrder\",\r\n] as const;\r\n\r\n/**\r\n * Shorthand keys copied straight onto the built descriptor.\r\n *\r\n * `fill` is deliberately absent: it resolves into `color` *and* `map` rather than\r\n * being one field, so it is handled on its own in {@link resolveMaterialShorthand3D}.\r\n */\r\nconst MATERIAL_SHORTHAND_KEYS = [\r\n \"opacity\", \"roughness\", \"metalness\",\r\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\r\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\r\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\r\n] as const;\r\n\r\n/** Every key the shorthand owns, for stripping a geometry bag. */\r\nconst SHORTHAND_KEYS: readonly string[] = [...MATERIAL_SHORTHAND_KEYS, \"fill\", \"material\", \"unlit\"];\r\n\r\n/**\r\n * Pull the {@link Transform3D} fields out of a shorthand bag. Takes `object` so\r\n * the concrete option types at each call site pass without a cast, and returns\r\n * `undefined` rather than `{}` when there is nothing to apply — an absent\r\n * transform lets the renderer skip the matrix write entirely.\r\n */\r\nfunction pickTransform(source: object): Transform3D | undefined {\r\n const bag = source as Record<string, unknown>;\r\n let out: Record<string, unknown> | undefined;\r\n for (const key of TRANSFORM_KEYS) {\r\n if (bag[key] !== undefined) (out ??= {})[key] = bag[key];\r\n }\r\n return out as Transform3D | undefined;\r\n}\r\n\r\n/**\r\n * Build the material a shorthand bag describes. Always returns one, so a recorded\r\n * drawable op never has to be interpreted with \"…or the default\" in mind.\r\n *\r\n * Exported because `Mesh3D` desugars the identical bag from its own props: this\r\n * is where `fill` becomes `color`-or-`map`, and two copies of that decision is\r\n * two chances for a node and a builder call to paint differently.\r\n *\r\n * @internal\r\n */\r\nexport function resolveMaterialShorthand3D(source: MaterialShorthand3D): Material3D | readonly Material3D[] {\r\n if (source.material !== undefined) return source.material;\r\n\r\n const material: Record<string, unknown> = { type: source.unlit ? \"basic\" : \"standard\" };\r\n\r\n const fill = resolveFill3D(source.fill);\r\n if (fill.color !== undefined) material.color = fill.color;\r\n if (fill.map !== undefined) material.map = fill.map;\r\n\r\n for (const key of MATERIAL_SHORTHAND_KEYS) {\r\n const value = (source as Record<string, unknown>)[key];\r\n if (value !== undefined) material[key] = value;\r\n }\r\n return material as unknown as Material3D;\r\n}\r\n\r\n/** Drop the shorthand/transform keys, leaving only a geometry's own params. */\r\nfunction pickGeometry<T>(source: object, type: string): T {\r\n const bag = source as Record<string, unknown>;\r\n const out: Record<string, unknown> = { type };\r\n for (const key in bag) {\r\n if (SHORTHAND_KEYS.includes(key)) continue;\r\n if ((TRANSFORM_KEYS as readonly string[]).includes(key)) continue;\r\n if (bag[key] !== undefined) out[key] = bag[key];\r\n }\r\n return out as T;\r\n}\r\n\r\n/** Geometry params only, with `type` and the inherited passthrough removed. */\r\ntype ParamsOf<G> = Omit<G, \"type\">;\r\n\r\n// ─── Recorder ────────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * What one 3D node draws — the `Graphics2D` of 3D.\r\n *\r\n * Records an ordered list of drawables (meshes, instanced meshes, points, lines,\r\n * sprites, models), each with its own geometry, material and local transform.\r\n * That is the whole surface: it holds no camera, no lights and no hierarchy,\r\n * because those are properties of a *scene* rather than of a thing in one, and\r\n * the `Node3D` tree owns them. The exact division `Graphics2D` and\r\n * `RenderContext2D` already make in 2D.\r\n *\r\n * render: (ctx) => ctx.draw(new Graphics3D()\r\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 })),\r\n *\r\n * Nothing here touches a renderer: a built `Graphics3D` is handed to a\r\n * {@link RenderContext3D}, which splices its ops into the scene being recorded.\r\n *\r\n * ── One flat bag, deliberately ────────────────────────────────────────────────\r\n * `Graphics2D` paints with a *chained* `.rect(…).fill(…)`, and this does not,\r\n * which is the one place the two recorders diverge on purpose. In 2D a `fill` is\r\n * a **group-scoped op** covering the shapes recorded before it; in 3D a material\r\n * belongs to exactly one object, because a mesh *is* geometry plus material.\r\n * A chained `.box().fill()` would imply a group material that has nothing to\r\n * scope over, so the shape and what it is made of are stated together instead.\r\n *\r\n * ── Angles are DEGREES ────────────────────────────────────────────────────────\r\n * Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,\r\n * matching the engine's 2D `rotation`. The renderer converts.\r\n *\r\n * ── Animation ─────────────────────────────────────────────────────────────────\r\n * A `Graphics3D` is rebuilt from scratch every frame, so animation is just\r\n * reading the node's own state while building:\r\n *\r\n * const Rig = component3d({\r\n * key: \"rig\",\r\n * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },\r\n * render: (ctx, s) => ctx.draw(new Graphics3D()\r\n * .box({ rotation: [0, s.spin, 0], position: s.lift })),\r\n * });\r\n * // a `to` of { spin: 360 } over two seconds turns it\r\n *\r\n * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit\r\n * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing\r\n * to interpolate it with and leaves it alone.\r\n *\r\n * ── Reconciliation identity ───────────────────────────────────────────────────\r\n * The renderer caches one live 3D object per op and mutates it between frames\r\n * rather than rebuilding. Identity is **derived**: it comes from the owning\r\n * `Node3D` plus a signature of what the op actually draws, so a builder that\r\n * emits ops conditionally reuses the right cache entry with nothing written by\r\n * hand. There is no `key` to set.\r\n *\r\n * ── What is cheap to animate ──────────────────────────────────────────────────\r\n * Transforms and most material values are in-place writes, so they cost nothing\r\n * per frame. **Geometry parameters are not** — three geometries are immutable, so\r\n * tweening `.box({ width: this.size })` reallocates the mesh every frame. Scale\r\n * the object instead: `.box({ width: 1, scale: [this.size, 1, 1] })`. The fields marked\r\n * \"structural\" on `MaterialCommon3D` recompile the shader program and should be\r\n * set once, not tweened.\r\n */\r\nexport class Graphics3D {\r\n private _ops: Graphics3DOp[] = [];\r\n\r\n /** Append one op, flagging (in development) inputs no renderer acts on. */\r\n private record(op: Graphics3DOp): void {\r\n inspectDrawable3D(op);\r\n this._ops.push(op);\r\n }\r\n\r\n // ─── Meshes ──────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record a mesh from an explicit geometry and material. The geometry sugar\r\n * methods below all funnel here.\r\n */\r\n mesh(\r\n geometry: Geometry3D,\r\n material?: Material3D | readonly Material3D[],\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"mesh\",\r\n geometry,\r\n material: material ?? { type: \"standard\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a mesh from a geometry `type` plus a flat shorthand bag. */\r\n private sugar(type: Geometry3D[\"type\"], options?: MeshShorthand3D): this {\r\n const source: MeshShorthand3D = options ?? {};\r\n return this.mesh(\r\n pickGeometry<Geometry3D>(source, type),\r\n resolveMaterialShorthand3D(source),\r\n pickTransform(source),\r\n );\r\n }\r\n\r\n box(options?: ParamsOf<BoxGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"box\", options);\r\n }\r\n sphere(options?: ParamsOf<SphereGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"sphere\", options);\r\n }\r\n plane(options?: ParamsOf<PlaneGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"plane\", options);\r\n }\r\n cylinder(options?: ParamsOf<CylinderGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cylinder\", options);\r\n }\r\n cone(options?: ParamsOf<ConeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"cone\", options);\r\n }\r\n torus(options?: ParamsOf<TorusGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torus\", options);\r\n }\r\n torusKnot(options?: ParamsOf<TorusKnotGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"torusKnot\", options);\r\n }\r\n circle(options?: ParamsOf<CircleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"circle\", options);\r\n }\r\n ring(options?: ParamsOf<RingGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"ring\", options);\r\n }\r\n capsule(options?: ParamsOf<CapsuleGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"capsule\", options);\r\n }\r\n polyhedron(options: ParamsOf<PolyhedronGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"polyhedron\", options);\r\n }\r\n extrude(options: ParamsOf<ExtrudeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"extrude\", options);\r\n }\r\n lathe(options: ParamsOf<LatheGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"lathe\", options);\r\n }\r\n tube(options: ParamsOf<TubeGeometry3D> & MeshShorthand3D): this {\r\n return this.sugar(\"tube\", options);\r\n }\r\n\r\n // ─── Other drawables ─────────────────────────────────────────────────────\r\n\r\n /**\r\n * Record many copies of one geometry in a single draw call. The way to put\r\n * thousands of objects on screen — a plain `mesh` per copy would not keep up.\r\n *\r\n * g3.instances(Geo.box({ width: 0.2 }), Mat.standard({ color: \"cyan\" }),\r\n * positions.map(p => ({ position: p })))\r\n */\r\n instances(\r\n geometry: Geometry3D,\r\n material: Material3D,\r\n instances: readonly Transform3D[],\r\n options?: { colors?: readonly Color[]; transform?: Transform3D },\r\n ): this {\r\n this.record({\r\n kind: \"instances\",\r\n geometry,\r\n material,\r\n instances,\r\n colors: options?.colors,\r\n transform: options?.transform,\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a point cloud — one sprite-like dot per vertex of `geometry`. */\r\n points(\r\n geometry: Geometry3D,\r\n material?: Material3D,\r\n transform?: Transform3D,\r\n ): this {\r\n this.record({\r\n kind: \"points\",\r\n geometry,\r\n material: material ?? { type: \"points\" },\r\n transform,\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a line. Give it either explicit `points` or a `geometry` (typically\r\n * `Geo.edges(...)` for a wireframe outline).\r\n *\r\n * `closed` joins the last point back to the first, as the 2D `line` op's\r\n * own field does. `segments` treats the points as disjoint start/end pairs\r\n * instead — the form `Geo.edges(...)` produces. (There is no subdivision to\r\n * confuse it with: a line is drawn from the points it is given.)\r\n */\r\n line(options: {\r\n points?: readonly Vector3Input[];\r\n geometry?: Geometry3D;\r\n material?: Material3D;\r\n /** Join the last point back to the first. */\r\n closed?: boolean;\r\n /** Treat the points as disjoint start/end pairs. */\r\n segments?: boolean;\r\n /** The line's paint. Cap and join have no meaning on a GL line. */\r\n stroke?: LineStroke3D;\r\n opacity?: number;\r\n transform?: Transform3D;\r\n } & Transform3D): this {\r\n const { points, geometry, material, closed, segments, stroke, opacity } = options;\r\n\r\n if (!points && !geometry) {\r\n throw new Error(\"Graphics3D.line() needs either `points` or `geometry`.\");\r\n }\r\n\r\n const resolved: Material3D = material ?? {\r\n type: stroke?.dash !== undefined ? \"lineDashed\" : \"lineBasic\",\r\n ...(stroke?.fill !== undefined ? { color: stroke.fill } : {}),\r\n ...(stroke?.weight !== undefined ? { width: stroke.weight } : {}),\r\n ...(stroke?.dash !== undefined\r\n ? { dashSize: stroke.dash[0], gapSize: stroke.dash[1] ?? stroke.dash[0] }\r\n : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n\r\n this.record({\r\n kind: \"line\",\r\n geometry: geometry ?? { type: \"buffer\", position: flattenPoints(points!) },\r\n material: resolved,\r\n mode: segments ? \"segments\" : closed ? \"loop\" : \"strip\",\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /** Record a camera-facing textured quad. */\r\n sprite(options: { fill?: Fill3D; material?: Material3D; opacity?: number } & Transform3D): this {\r\n const { fill, material, opacity } = options;\r\n const paint = resolveFill3D(fill);\r\n const resolved: Material3D = material ?? {\r\n type: \"sprite\",\r\n ...(paint.map !== undefined ? { map: paint.map } : {}),\r\n ...(paint.color !== undefined ? { color: paint.color } : {}),\r\n ...(opacity !== undefined ? { opacity } : {}),\r\n } as Material3D;\r\n this.record({\r\n kind: \"sprite\",\r\n material: resolved,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n /**\r\n * Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)\r\n * resolves to an empty slot and draws nothing, and in development the first\r\n * one recorded warns.\r\n *\r\n * Baked animation is sampled by explicit `time`, never advanced by a delta, so\r\n * a model stays frame-identical under scrubbing.\r\n */\r\n model(options: {\r\n src: string;\r\n animation?: ModelAnimation3D | readonly ModelAnimation3D[];\r\n override?: Readonly<Record<string, Material3D>>;\r\n } & Transform3D): this {\r\n const { src, animation, override } = options;\r\n this.record({\r\n kind: \"model\",\r\n src,\r\n animation: animation === undefined\r\n ? undefined\r\n : Array.isArray(animation) ? animation : [animation as ModelAnimation3D],\r\n override,\r\n transform: pickTransform(options),\r\n });\r\n return this;\r\n }\r\n\r\n // ─── Consumption ─────────────────────────────────────────────────────────\r\n\r\n /** The recorded ops, in order. Replayed by the renderer. */\r\n ops(): readonly Graphics3DOp[] {\r\n return this._ops;\r\n }\r\n\r\n /** True when this node draws nothing. */\r\n isEmpty(): boolean {\r\n return this._ops.length === 0;\r\n }\r\n}\r\n\r\n/**\r\n * A 3D line's paint, named after the 2D `Stroke` it mirrors.\r\n *\r\n * `cap`, `join` and the rest of the 2D stroke vocabulary are deliberately absent:\r\n * they describe a stroked *path*, and a GL line has no outline to cap. Note that\r\n * `weight` above 1 is ignored by most WebGL implementations — for a genuinely\r\n * thick line, draw a `tube`.\r\n */\r\nexport interface LineStroke3D {\r\n /** The line's colour. Named `fill` to match the 2D `Stroke`. */\r\n fill?: Color;\r\n weight?: number;\r\n /** Dash and gap lengths, in world units. */\r\n dash?: readonly [number, number?];\r\n}\r\n\r\n/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */\r\nfunction flattenPoints(points: readonly Vector3Input[]): number[] {\r\n const out: number[] = [];\r\n for (const point of points) {\r\n if (typeof point === \"number\") {\r\n out.push(point, point, point);\r\n } else if (Array.isArray(point)) {\r\n out.push(point[0] ?? 0, point[1] ?? 0, point[2] ?? 0);\r\n } else {\r\n const v = point as { x: number; y: number; z: number };\r\n out.push(v.x ?? 0, v.y ?? 0, v.z ?? 0);\r\n }\r\n }\r\n return out;\r\n}\r\n"]}
|
|
1
|
+
{"version":3,"file":"graphics3d.js","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAe,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAoE5C;;;;;GAKG;AACH,gBAAgB;AAChB,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACvD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;CACpE,CAAC,CAAC;AAkDH,MAAM,cAAc,GAAG;IACnB,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ;IACvD,SAAS,EAAE,QAAQ,EAAE,aAAa;CAC5B,CAAC;AAEX;;;;;GAKG;AACH,MAAM,uBAAuB,GAAG;IAC5B,SAAS,EAAE,WAAW,EAAE,WAAW;IACnC,UAAU,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc;IAC3D,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW;IACnE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO;CACrC,CAAC;AAEX,kEAAkE;AAClE,MAAM,cAAc,GAAsB,CAAC,GAAG,uBAAuB,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAEpG;;;;;GAKG;AACH,SAAS,aAAa,CAAC,MAAc;IACjC,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,IAAI,GAAwC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAA8B,CAAC;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAA2B;IAClE,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IAE1D,MAAM,QAAQ,GAA4B,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAExF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAEpD,KAAK,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAI,MAAkC,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;IACD,OAAO,QAAiC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,SAAS,YAAY,CAAI,MAAc,EAAE,IAAY;IACjD,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3C,IAAK,cAAoC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAClE,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAQ,CAAC;AACpB,CAAC;AAKD,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,OAAO,UAAU;IACX,IAAI,GAAmB,EAAE,CAAC;IAElC,2EAA2E;IACnE,MAAM,CAAC,EAAgB;QAC3B,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED,4EAA4E;IAE5E;;;OAGG;IACH,IAAI,CACA,QAAoB,EACpB,QAA6C,EAC7C,SAAuB;QAEvB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,MAAM;YACZ,QAAQ;YACR,QAAQ,EAAE,QAAQ,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;YAC1C,SAAS;SACZ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,sEAAsE;IAC9D,KAAK,CAAC,IAAwB,EAAE,OAAyB;QAC7D,MAAM,MAAM,GAAoB,OAAO,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CACZ,YAAY,CAAa,MAAM,EAAE,IAAI,CAAC,EACtC,0BAA0B,CAAC,MAAM,CAAC,EAClC,aAAa,CAAC,MAAM,CAAC,CACxB,CAAC;IACN,CAAC;IAED,GAAG,CAAC,OAAmD;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,CAAC,OAAsD;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,OAAqD;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,QAAQ,CAAC,OAAwD;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,OAAoD;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,OAAqD;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,SAAS,CAAC,OAAyD;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,CAAC,OAAsD;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,OAAoD;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,OAAuD;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,UAAU,CAAC,OAAyD;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,OAAsD;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,OAAoD;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,OAAmD;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,4EAA4E;IAE5E;;;;;;OAMG;IACH,SAAS,CACL,QAAoB,EACpB,QAAoB,EACpB,SAAiC,EACjC,OAAgE;QAEhE,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,WAAW;YACjB,QAAQ;YACR,QAAQ;YACR,SAAS;YACT,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,SAAS,EAAE,OAAO,EAAE,SAAS;SAChC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,2EAA2E;IAC3E,MAAM,CACF,QAAoB,EACpB,QAAqB,EACrB,SAAuB;QAEvB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ;YACR,QAAQ,EAAE,QAAQ,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxC,SAAS;SACZ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,OAYU;QACX,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAElF,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,QAAQ,GAAe,QAAQ,IAAI;YACrC,IAAI,EAAE,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW;YAC7D,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS;gBAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBACzE,CAAC,CAAC,EAAE,CAAC;YACT,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClC,CAAC;QAEhB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,QAAQ,IAAI,UAAU,CAAC,MAAO,CAAC;YACzC,QAAQ,EAAE,QAAQ;YAClB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;YACvD,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,OAAiF;QACpF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAe,QAAQ,IAAI;YACrC,IAAI,EAAE,QAAQ;YACd,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClC,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,QAAQ;YAClB,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAIS;QACX,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC;YACR,IAAI,EAAE,OAAO;YACb,GAAG;YACH,SAAS,EAAE,SAAS,KAAK,SAAS;gBAC9B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAA6B,CAAC;YAC5E,QAAQ;YACR,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,4EAA4E;IAE5E,4DAA4D;IAC5D,GAAG;QACC,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,yCAAyC;IACzC,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IAClC,CAAC;CACJ;AAkBD,oGAAoG;AACpG,MAAM,WAAW,GAAG,IAAI,OAAO,EAA2F,CAAC;AAC3H,IAAI,YAAY,GAAG,CAAC,CAAC;AAErB;;;;GAIG;AACH,SAAS,UAAU,CAAC,MAA+B;IAC/C,IAAI,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACzC,IAAI,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC;QACrE,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAChF,CAAC;AAED,6EAA6E;AAC7E,SAAS,aAAa,CAAC,MAA+B;IAClD,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QAC7C,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3B,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,KAA4C,CAAC;YACvD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,CAAC,IAAI,CAAC,CAAC;IACX,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED,+DAA+D;AAC/D,SAAS,KAAK,CAAC,MAAoB,EAAE,MAA+B;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAS,EAAE,CAAS,EAAE,CAAS,CAAC;QACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,KAA4C,CAAC;YACvD,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACb,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACb,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QACD,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACvH,CAAC,IAAI,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport type {\n BoxGeometry3D, BufferGeometry3D, CapsuleGeometry3D, CircleGeometry3D, ConeGeometry3D,\n CylinderGeometry3D, ExtrudeGeometry3D, Geometry3D, LatheGeometry3D,\n PlaneGeometry3D, PolyhedronGeometry3D, RingGeometry3D, SphereGeometry3D,\n TorusGeometry3D, TorusKnotGeometry3D, TubeGeometry3D,\n} from \"./geometry\";\nimport type { Material3D, Shading3D } from \"./material\";\nimport type { Texture3D } from \"./texture\";\nimport { resolveFill3D, type Fill3D } from \"./fill3d\";\nimport { inspectDrawable3D } from \"./inert\";\nimport { type Transform3D, type Blend3D, type Faces3D } from \"./transform\";\nimport type { Vector3Input } from \"./vector3\";\n\n// ─── Ops ─────────────────────────────────────────────────────────────────────\n\n/** One clip of a model's baked animation, sampled at an explicit time. */\nexport interface ModelAnimation3D {\n /** Clip name, or its index in the file. Defaults to the first clip. */\n clip?: string | number;\n /**\n * Seconds into the clip. **Explicit by design** — the renderer seeks to this\n * time rather than advancing by a delta, which is what keeps a model's\n * animation identical whether the frame was reached by playing forward or by\n * scrubbing backwards.\n */\n time: number;\n /** Blend weight, for cross-fading clips. Default 1. */\n weight?: number;\n}\n\n/**\n * How a `line` op connects its points: in order, or as disjoint start/end pairs,\n * or in order and closed back to the start.\n */\nexport type LineMode3D = \"strip\" | \"segments\" | \"loop\";\n\n/**\n * One recorded operation in a {@link Graphics3D} command list.\n *\n * Every op draws something. Hierarchy, lights and the camera are *scene*\n * concerns, recorded by the `Node3D` tree into a `Scene3D` — this is only ever\n * \"what one node paints\", which is exactly what a `Graphics2D` is in 2D.\n *\n * A drawable's geometry and material are *inline sub-descriptors*, not ops,\n * because in a 3D scene graph they are properties of an object rather than\n * children of it.\n */\nexport type Graphics3DOp =\n | { kind: \"mesh\"; geometry: Geometry3D; material: Material3D | readonly Material3D[]; transform?: Transform3D }\n | {\n kind: \"instances\";\n geometry: Geometry3D;\n material: Material3D;\n /** Per-instance placement. Length drives the instance count. */\n instances: readonly Transform3D[];\n /** Per-instance tint. Needs a material that reads instance colour. */\n colors?: readonly Color[];\n transform?: Transform3D;\n }\n | { kind: \"points\"; geometry: Geometry3D; material: Material3D; transform?: Transform3D }\n | {\n kind: \"line\";\n geometry: Geometry3D;\n material: Material3D;\n mode: LineMode3D;\n transform?: Transform3D;\n }\n | { kind: \"sprite\"; material: Material3D; transform?: Transform3D }\n | {\n kind: \"model\";\n src: string;\n animation?: readonly ModelAnimation3D[];\n /** Replace materials on the loaded graph, keyed by mesh or material name. */\n override?: Readonly<Record<string, Material3D>>;\n transform?: Transform3D;\n };\n\n/**\n * Op kinds that put something in the scene (as opposed to shaping the tree).\n *\n * Shared with `Scene3D`, whose op list is this one plus `push`/`pop`/`light`/\n * `camera` — so \"is anything actually drawn here\" has a single definition.\n */\n/** @internal */\nexport const DRAWABLE_KINDS: ReadonlySet<string> = new Set([\n \"mesh\", \"light\", \"instances\", \"points\", \"line\", \"sprite\", \"model\",\n]);\n\n// ─── Shorthand ───────────────────────────────────────────────────────────────\n\n/**\n * Material fields promoted onto the geometry sugar methods, so the common case is\n * one flat call: `.box({ width: 2, fill: \"red\", roughness: 0.3 })`.\n *\n * `fill` is the whole 2D fill vocabulary — see {@link Fill3D} — and is what a\n * flat `color` plus a `map` slot used to be. The rest is surface *response*\n * (how light behaves on it) rather than colour, which is the line Spline's\n * material panel draws too and the reason those stay separate fields.\n *\n * These desugar at record time into a full {@link Material3D} — `standard` by\n * default, `basic` when {@link unlit} is set — so the recorded op list stays\n * canonical. Pass {@link material} to bypass the shorthand entirely; every\n * renderer-level knob that is not a design decision (`depthWrite`, `alphaTest`,\n * `toneMapped`, `polygonOffset`, …) lives there and only there.\n */\nexport interface MaterialShorthand3D {\n /** A full descriptor (or an array, for multi-material). Wins over the rest. */\n material?: Material3D | readonly Material3D[];\n /** What the surface is made of: a colour, a texture, a gradient, 2D content. */\n fill?: Fill3D;\n opacity?: number;\n roughness?: number;\n metalness?: number;\n /** Self-illumination. Bloom in the post chain is what makes it glow. */\n emission?: Color;\n emissionStrength?: number;\n normalMap?: Texture3D;\n roughnessMap?: Texture3D;\n metalnessMap?: Texture3D;\n aoMap?: Texture3D;\n alphaMap?: Texture3D;\n envMapIntensity?: number;\n wireframe?: boolean;\n /** Facet or smooth shading. Default `\"smooth\"`. */\n shading?: Shading3D;\n /** Which faces to rasterize. Default `\"front\"`. */\n faces?: Faces3D;\n vertexColors?: boolean;\n blend?: Blend3D;\n /** Shade with an unlit `basic` material instead of `standard`. */\n unlit?: boolean;\n}\n\n/** Transform + material shorthand, accepted by every geometry sugar method. */\nexport type MeshShorthand3D = Transform3D & MaterialShorthand3D;\n\nconst TRANSFORM_KEYS = [\n \"position\", \"rotation\", \"quaternion\", \"scale\", \"lookAt\",\n \"visible\", \"shadow\", \"renderOrder\",\n] as const;\n\n/**\n * Shorthand keys copied straight onto the built descriptor.\n *\n * `fill` is deliberately absent: it resolves into `color` *and* `map` rather than\n * being one field, so it is handled on its own in {@link resolveMaterialShorthand3D}.\n */\nconst MATERIAL_SHORTHAND_KEYS = [\n \"opacity\", \"roughness\", \"metalness\",\n \"emission\", \"emissionStrength\", \"normalMap\", \"roughnessMap\",\n \"metalnessMap\", \"aoMap\", \"alphaMap\", \"envMapIntensity\", \"wireframe\",\n \"shading\", \"faces\", \"vertexColors\", \"blend\",\n] as const;\n\n/** Every key the shorthand owns, for stripping a geometry bag. */\nconst SHORTHAND_KEYS: readonly string[] = [...MATERIAL_SHORTHAND_KEYS, \"fill\", \"material\", \"unlit\"];\n\n/**\n * Pull the {@link Transform3D} fields out of a shorthand bag. Takes `object` so\n * the concrete option types at each call site pass without a cast, and returns\n * `undefined` rather than `{}` when there is nothing to apply — an absent\n * transform lets the renderer skip the matrix write entirely.\n */\nfunction pickTransform(source: object): Transform3D | undefined {\n const bag = source as Record<string, unknown>;\n let out: Record<string, unknown> | undefined;\n for (const key of TRANSFORM_KEYS) {\n if (bag[key] !== undefined) (out ??= {})[key] = bag[key];\n }\n return out as Transform3D | undefined;\n}\n\n/**\n * Build the material a shorthand bag describes. Always returns one, so a recorded\n * drawable op never has to be interpreted with \"…or the default\" in mind.\n *\n * Exported because `Mesh3D` desugars the identical bag from its own props: this\n * is where `fill` becomes `color`-or-`map`, and two copies of that decision is\n * two chances for a node and a builder call to paint differently.\n *\n * @internal\n */\nexport function resolveMaterialShorthand3D(source: MaterialShorthand3D): Material3D | readonly Material3D[] {\n if (source.material !== undefined) return source.material;\n\n const material: Record<string, unknown> = { type: source.unlit ? \"basic\" : \"standard\" };\n\n const fill = resolveFill3D(source.fill);\n if (fill.color !== undefined) material.color = fill.color;\n if (fill.map !== undefined) material.map = fill.map;\n\n for (const key of MATERIAL_SHORTHAND_KEYS) {\n const value = (source as Record<string, unknown>)[key];\n if (value !== undefined) material[key] = value;\n }\n return material as unknown as Material3D;\n}\n\n/** Drop the shorthand/transform keys, leaving only a geometry's own params. */\nfunction pickGeometry<T>(source: object, type: string): T {\n const bag = source as Record<string, unknown>;\n const out: Record<string, unknown> = { type };\n for (const key in bag) {\n if (SHORTHAND_KEYS.includes(key)) continue;\n if ((TRANSFORM_KEYS as readonly string[]).includes(key)) continue;\n if (bag[key] !== undefined) out[key] = bag[key];\n }\n return out as T;\n}\n\n/** Geometry params only, with `type` and the inherited passthrough removed. */\ntype ParamsOf<G> = Omit<G, \"type\">;\n\n// ─── Recorder ────────────────────────────────────────────────────────────────\n\n/**\n * What one 3D node draws — the `Graphics2D` of 3D.\n *\n * Records an ordered list of drawables (meshes, instanced meshes, points, lines,\n * sprites, models), each with its own geometry, material and local transform.\n * That is the whole surface: it holds no camera, no lights and no hierarchy,\n * because those are properties of a *scene* rather than of a thing in one, and\n * the `Node3D` tree owns them. The exact division `Graphics2D` and\n * `RenderContext2D` already make in 2D.\n *\n * render: (ctx) => ctx.draw(new Graphics3D()\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 })),\n *\n * Nothing here touches a renderer: a built `Graphics3D` is handed to a\n * {@link RenderContext3D}, which splices its ops into the scene being recorded.\n *\n * ── One flat bag, deliberately ────────────────────────────────────────────────\n * `Graphics2D` paints with a *chained* `.rect(…).fill(…)`, and this does not,\n * which is the one place the two recorders diverge on purpose. In 2D a `fill` is\n * a **group-scoped op** covering the shapes recorded before it; in 3D a material\n * belongs to exactly one object, because a mesh *is* geometry plus material.\n * A chained `.box().fill()` would imply a group material that has nothing to\n * scope over, so the shape and what it is made of are stated together instead.\n *\n * ── Angles are DEGREES ────────────────────────────────────────────────────────\n * Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,\n * matching the engine's 2D `rotation`. The renderer converts.\n *\n * ── Animation ─────────────────────────────────────────────────────────────────\n * A `Graphics3D` is rebuilt from scratch every frame, so animation is just\n * reading the node's own state while building:\n *\n * const Rig = component3d({\n * key: \"rig\",\n * state: { spin: 0, lift: Types.custom<Vector3>([0, 0, 0], { lerp: lerpVector3 }) },\n * render: (ctx, s) => ctx.draw(new Graphics3D()\n * .box({ rotation: [0, s.spin, 0], position: s.lift })),\n * });\n * // a `to` of { spin: 360 } over two seconds turns it\n *\n * Note the `lerp` on `lift`. An entry holding a non-number needs an explicit\n * tween (`lerpVector3`, `lerpEuler3`, `slerpQuaternion`) or `to()` has nothing\n * to interpolate it with and leaves it alone.\n *\n * ── Reconciliation identity ───────────────────────────────────────────────────\n * The renderer caches one live 3D object per op and mutates it between frames\n * rather than rebuilding. Identity is **derived**: it comes from the owning\n * `Node3D` plus a signature of what the op actually draws, so a builder that\n * emits ops conditionally reuses the right cache entry with nothing written by\n * hand. There is no `key` to set.\n *\n * ── What is cheap to animate ──────────────────────────────────────────────────\n * Transforms and most material values are in-place writes, so they cost nothing\n * per frame. **Geometry parameters are not** — three geometries are immutable, so\n * tweening `.box({ width: this.size })` reallocates the mesh every frame. Scale\n * the object instead: `.box({ width: 1, scale: [this.size, 1, 1] })`. The fields marked\n * \"structural\" on `MaterialCommon3D` recompile the shader program and should be\n * set once, not tweened.\n */\nexport class Graphics3D {\n private _ops: Graphics3DOp[] = [];\n\n /** Append one op, flagging (in development) inputs no renderer acts on. */\n private record(op: Graphics3DOp): void {\n inspectDrawable3D(op);\n this._ops.push(op);\n }\n\n // ─── Meshes ──────────────────────────────────────────────────────────────\n\n /**\n * Record a mesh from an explicit geometry and material. The geometry sugar\n * methods below all funnel here.\n */\n mesh(\n geometry: Geometry3D,\n material?: Material3D | readonly Material3D[],\n transform?: Transform3D,\n ): this {\n this.record({\n kind: \"mesh\",\n geometry,\n material: material ?? { type: \"standard\" },\n transform,\n });\n return this;\n }\n\n /** Record a mesh from a geometry `type` plus a flat shorthand bag. */\n private sugar(type: Geometry3D[\"type\"], options?: MeshShorthand3D): this {\n const source: MeshShorthand3D = options ?? {};\n return this.mesh(\n pickGeometry<Geometry3D>(source, type),\n resolveMaterialShorthand3D(source),\n pickTransform(source),\n );\n }\n\n box(options?: ParamsOf<BoxGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"box\", options);\n }\n sphere(options?: ParamsOf<SphereGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"sphere\", options);\n }\n plane(options?: ParamsOf<PlaneGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"plane\", options);\n }\n cylinder(options?: ParamsOf<CylinderGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"cylinder\", options);\n }\n cone(options?: ParamsOf<ConeGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"cone\", options);\n }\n torus(options?: ParamsOf<TorusGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"torus\", options);\n }\n torusKnot(options?: ParamsOf<TorusKnotGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"torusKnot\", options);\n }\n circle(options?: ParamsOf<CircleGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"circle\", options);\n }\n ring(options?: ParamsOf<RingGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"ring\", options);\n }\n capsule(options?: ParamsOf<CapsuleGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"capsule\", options);\n }\n polyhedron(options: ParamsOf<PolyhedronGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"polyhedron\", options);\n }\n extrude(options: ParamsOf<ExtrudeGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"extrude\", options);\n }\n lathe(options: ParamsOf<LatheGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"lathe\", options);\n }\n tube(options: ParamsOf<TubeGeometry3D> & MeshShorthand3D): this {\n return this.sugar(\"tube\", options);\n }\n\n // ─── Other drawables ─────────────────────────────────────────────────────\n\n /**\n * Record many copies of one geometry in a single draw call. The way to put\n * thousands of objects on screen — a plain `mesh` per copy would not keep up.\n *\n * g3.instances(Geo.box({ width: 0.2 }), Mat.standard({ color: \"cyan\" }),\n * positions.map(p => ({ position: p })))\n */\n instances(\n geometry: Geometry3D,\n material: Material3D,\n instances: readonly Transform3D[],\n options?: { colors?: readonly Color[]; transform?: Transform3D },\n ): this {\n this.record({\n kind: \"instances\",\n geometry,\n material,\n instances,\n colors: options?.colors,\n transform: options?.transform,\n });\n return this;\n }\n\n /** Record a point cloud — one sprite-like dot per vertex of `geometry`. */\n points(\n geometry: Geometry3D,\n material?: Material3D,\n transform?: Transform3D,\n ): this {\n this.record({\n kind: \"points\",\n geometry,\n material: material ?? { type: \"points\" },\n transform,\n });\n return this;\n }\n\n /**\n * Record a line. Give it either explicit `points` or a `geometry` (typically\n * `Geo.edges(...)` for a wireframe outline).\n *\n * `closed` joins the last point back to the first, as the 2D `line` op's\n * own field does. `segments` treats the points as disjoint start/end pairs\n * instead — the form `Geo.edges(...)` produces. (There is no subdivision to\n * confuse it with: a line is drawn from the points it is given.)\n */\n line(options: {\n points?: readonly Vector3Input[];\n geometry?: Geometry3D;\n material?: Material3D;\n /** Join the last point back to the first. */\n closed?: boolean;\n /** Treat the points as disjoint start/end pairs. */\n segments?: boolean;\n /** The line's paint. Cap and join have no meaning on a GL line. */\n stroke?: LineStroke3D;\n opacity?: number;\n transform?: Transform3D;\n } & Transform3D): this {\n const { points, geometry, material, closed, segments, stroke, opacity } = options;\n\n if (!points && !geometry) {\n throw new Error(\"Graphics3D.line() needs either `points` or `geometry`.\");\n }\n\n const resolved: Material3D = material ?? {\n type: stroke?.dash !== undefined ? \"lineDashed\" : \"lineBasic\",\n ...(stroke?.fill !== undefined ? { color: stroke.fill } : {}),\n ...(stroke?.weight !== undefined ? { width: stroke.weight } : {}),\n ...(stroke?.dash !== undefined\n ? { dashSize: stroke.dash[0], gapSize: stroke.dash[1] ?? stroke.dash[0] }\n : {}),\n ...(opacity !== undefined ? { opacity } : {}),\n } as Material3D;\n\n this.record({\n kind: \"line\",\n geometry: geometry ?? lineBuffer(points!),\n material: resolved,\n mode: segments ? \"segments\" : closed ? \"loop\" : \"strip\",\n transform: pickTransform(options),\n });\n return this;\n }\n\n /** Record a camera-facing textured quad. */\n sprite(options: { fill?: Fill3D; material?: Material3D; opacity?: number } & Transform3D): this {\n const { fill, material, opacity } = options;\n const paint = resolveFill3D(fill);\n const resolved: Material3D = material ?? {\n type: \"sprite\",\n ...(paint.map !== undefined ? { map: paint.map } : {}),\n ...(paint.color !== undefined ? { color: paint.color } : {}),\n ...(opacity !== undefined ? { opacity } : {}),\n } as Material3D;\n this.record({\n kind: \"sprite\",\n material: resolved,\n transform: pickTransform(options),\n });\n return this;\n }\n\n /**\n * Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)\n * resolves to an empty slot and draws nothing, and in development the first\n * one recorded warns.\n *\n * Baked animation is sampled by explicit `time`, never advanced by a delta, so\n * a model stays frame-identical under scrubbing.\n */\n model(options: {\n src: string;\n animation?: ModelAnimation3D | readonly ModelAnimation3D[];\n override?: Readonly<Record<string, Material3D>>;\n } & Transform3D): this {\n const { src, animation, override } = options;\n this.record({\n kind: \"model\",\n src,\n animation: animation === undefined\n ? undefined\n : Array.isArray(animation) ? animation : [animation as ModelAnimation3D],\n override,\n transform: pickTransform(options),\n });\n return this;\n }\n\n // ─── Consumption ─────────────────────────────────────────────────────────\n\n /** The recorded ops, in order. Replayed by the renderer. */\n ops(): readonly Graphics3DOp[] {\n return this._ops;\n }\n\n /** True when this node draws nothing. */\n isEmpty(): boolean {\n return this._ops.length === 0;\n }\n}\n\n/**\n * A 3D line's paint, named after the 2D `Stroke` it mirrors.\n *\n * `cap`, `join` and the rest of the 2D stroke vocabulary are deliberately absent:\n * they describe a stroked *path*, and a GL line has no outline to cap. Note that\n * `weight` above 1 is ignored by most WebGL implementations — for a genuinely\n * thick line, draw a `tube`.\n */\nexport interface LineStroke3D {\n /** The line's colour. Named `fill` to match the 2D `Stroke`. */\n fill?: Color;\n weight?: number;\n /** Dash and gap lengths, in world units. */\n dash?: readonly [number, number?];\n}\n\n/** The buffer each points array was last flattened into, and the revision it was uploaded under. */\nconst lineBuffers = new WeakMap<readonly Vector3Input[], { readonly position: Float32Array; readonly revision: number }>();\nlet lineRevision = 0;\n\n/**\n * `points` as a line's buffer. The same array holding the same values gets the\n * same buffer and revision back, so a renderer uploads an unchanged line once,\n * not every frame; the values are checked, so one changed in place still lands.\n */\nfunction lineBuffer(points: readonly Vector3Input[]): BufferGeometry3D {\n let kept = lineBuffers.get(points);\n if (!kept || !holds(kept.position, points)) {\n kept = { position: flattenPoints(points), revision: ++lineRevision };\n lineBuffers.set(points, kept);\n }\n return { type: \"buffer\", position: kept.position, revision: kept.revision };\n}\n\n/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */\nfunction flattenPoints(points: readonly Vector3Input[]): Float32Array {\n const out = new Float32Array(points.length * 3);\n let i = 0;\n for (const point of points) {\n if (typeof point === \"number\") {\n out[i] = out[i + 1] = out[i + 2] = point;\n } else if (Array.isArray(point)) {\n out[i] = point[0] ?? 0;\n out[i + 1] = point[1] ?? 0;\n out[i + 2] = point[2] ?? 0;\n } else {\n const v = point as { x: number; y: number; z: number };\n out[i] = v.x ?? 0;\n out[i + 1] = v.y ?? 0;\n out[i + 2] = v.z ?? 0;\n }\n i += 3;\n }\n return out;\n}\n\n/** Whether `buffer` is what flattening `points` would give. */\nfunction holds(buffer: Float32Array, points: readonly Vector3Input[]): boolean {\n if (buffer.length !== points.length * 3) return false;\n let i = 0;\n for (const point of points) {\n let x: number, y: number, z: number;\n if (typeof point === \"number\") {\n x = y = z = point;\n } else if (Array.isArray(point)) {\n x = point[0] ?? 0;\n y = point[1] ?? 0;\n z = point[2] ?? 0;\n } else {\n const v = point as { x: number; y: number; z: number };\n x = v.x ?? 0;\n y = v.y ?? 0;\n z = v.z ?? 0;\n }\n if (buffer[i] !== Math.fround(x) || buffer[i + 1] !== Math.fround(y) || buffer[i + 2] !== Math.fround(z)) return false;\n i += 3;\n }\n return true;\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render3d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE3F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EACH,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAC7D,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EACxD,UAAU,EAAE,SAAS,EAAE,aAAa,GACvC,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/F,gBAAgB,CAAC,OAAO,EACpB,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EACtE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,GAC3E,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAU/E,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAS7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAazH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAKnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMpD,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAExF,OAAO,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5E,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["/**\
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render3d/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE3F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EACH,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,mBAAmB,EAC7D,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EACxD,UAAU,EAAE,SAAS,EAAE,aAAa,GACvC,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/F,gBAAgB,CAAC,OAAO,EACpB,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EACtE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,GAC3E,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAU/E,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAS7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAazH,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAKnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMpD,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAExF,OAAO,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5E,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC","sourcesContent":["/**\n * 3D scene description.\n *\n * The same split as 2D, one dimension over: a {@link Graphics3D} is what a single\n * node draws (the `Graphics2D` of 3D), a {@link RenderContext3D} is what it draws\n * *into*, and a {@link Scene3D} is the recorded result — camera, lights, fog and\n * every drawable — that a backend replays.\n *\n * Unlike `@/render` (whose descriptors are `@internal`, since nodes build them on\n * the author's behalf), the vocabulary here is **public**: a `Node3D` takes these\n * descriptors as props, and a hand-built `Scene3D` is the escape hatch for\n * painting 3D through an arbitrary 2D path.\n *\n * Nothing in this directory imports a renderer, and no field holds a DOM handle —\n * so `three` never enters core.\n */\n\nexport { Graphics3D } from \"./graphics3d\";\nexport type {\n Graphics3DOp, LineMode3D, LineStroke3D, ModelAnimation3D,\n MaterialShorthand3D, MeshShorthand3D,\n} from \"./graphics3d\";\n/** @internal */ export { DRAWABLE_KINDS, resolveMaterialShorthand3D } from \"./graphics3d\";\n\nexport { Scene3D } from \"./scene3d\";\nexport type { Scene3DOp } from \"./scene3d\";\n\nexport { RenderContext3D } from \"./render-context3d\";\nexport type { Node3DRenderState } from \"./render-context3d\";\n\nexport { Geo, Mat, Tex } from \"./builders\";\n\nexport { resolveFill3D, looksLikeAssetPath } from \"./fill3d\";\nexport type { Fill3D, Fill3DOptions, ResolvedFill3D } from \"./fill3d\";\n\nexport { segmentsOf } from \"./segments\";\nexport type { Segments3D } from \"./segments\";\n\nexport { evaluateRoundedBox } from \"./rounded-box\";\nexport type { RoundedBoxOptions } from \"./rounded-box\";\n\nexport {\n lerpVector3, lerpEuler3, slerpQuaternion, normalizeQuaternion,\n quaternionFromEuler, resolveVector3, IDENTITY_QUATERNION,\n vector3Ops, euler3Ops, quaternionOps,\n} from \"./vector3\";\nexport type { Vector3, Vector3Input, Euler3, EulerOrder, Quaternion } from \"./vector3\";\n\nexport { shadowCasts, shadowReceives, resolveShadowOptions3D } from \"./transform\";\nexport type { Transform3D, Shadow3D, ShadowOptions3D, Faces3D, Blend3D } from \"./transform\";\n\nexport { geometryBounds3D } from \"./bounds3d\";\nexport type { Box3 } from \"./bounds3d\";\n/** @internal */ export { centeredBox3, corners3, transformBox3, unionBox3 } from \"./bounds3d\";\n\n/** @internal */ export {\n applyMatrix4, compose4, identity4, invert4, lookAtRotation4, multiply4,\n orthographic4, perspective4, rotationOf4, transformMatrix4, translation4,\n} from \"./matrix4\";\n/** @internal */ export type { Matrix4, Vector4 } from \"./matrix4\";\n\nexport { evaluateParametric, cylinderRadii, resolveBevel3D } from \"./geometry\";\nexport type {\n Geometry3D, Passthrough3D, Sweep3D, Bevel3D,\n BoxGeometry3D, SphereGeometry3D, PlaneGeometry3D, CylinderGeometry3D,\n ConeGeometry3D, TorusGeometry3D, TorusKnotGeometry3D, CircleGeometry3D,\n RingGeometry3D, CapsuleGeometry3D, PolyhedronGeometry3D, ExtrudeGeometry3D,\n LatheGeometry3D, TubeGeometry3D, BufferGeometry3D, ParametricGeometry3D,\n ParametricVertex3D, EdgesGeometry3D, WireframeGeometry3D, ModelGeometry3D,\n} from \"./geometry\";\n\nexport { MUTABLE_MATERIAL_KEYS, STRUCTURAL_MATERIAL_KEYS } from \"./material\";\nexport type {\n Material3D, MaterialCommon3D, Uniform3D, Shading3D,\n BasicMaterial3D, StandardMaterial3D, PhysicalMaterial3D, PhongMaterial3D,\n LambertMaterial3D, ToonMaterial3D, NormalMaterial3D, DepthMaterial3D,\n MatcapMaterial3D, PointsMaterial3D, LineBasicMaterial3D, LineDashedMaterial3D,\n SpriteMaterial3D, ShadowMaterial3D, ShaderMaterial3D,\n} from \"./material\";\n\nexport { isDataTexture3D, isSurfaceTexture3D, resolveTexture3D, resolveSurfaceSource, texture3DSource } from \"./texture\";\nexport type {\n Texture3D, ImageTexture3D, DataTexture3D, SurfaceTexture3D, TextureOptions3D,\n SurfaceSource3D, ResolvedSurfaceSource,\n TextureWrap3D, TextureFilter3D, TextureColorSpace3D,\n} from \"./texture\";\n\nexport type {\n LightData3D,\n AmbientLightData3D, HemisphereLightData3D, DirectionalLightData3D,\n PointLightData3D, SpotLightData3D, AreaLightData3D,\n} from \"./light\";\n\nexport { isOrbitCamera3D, resolveCameraPlacement } from \"./camera\";\nexport type {\n CameraData3D, CameraCommon3D, PerspectiveCameraData3D, OrthographicCameraData3D,\n} from \"./camera\";\n\nexport { resolveShadows3D } from \"./scene-settings\";\nexport type {\n FogData3D, EnvironmentData3D, ShadowSettings3D, Shadows3D,\n ToneSettings3D, ToneMapping3D, PostEffect3D,\n} from \"./scene-settings\";\n\n/** @internal */ export { forEachTexture3D, isTextureLike, TEXTURE_KEYS } from \"./walk\";\n\nexport { registerCanvas3DWarmup, registerCanvas3DResourceLoader } from \"./resources\";\nexport { canvas3DResourceKey, parseCanvas3DResourceKey } from \"./resources\";\nexport type { Canvas3DWarmup, Canvas3DResourceLoader, Canvas3DResourceKind } from \"./resources\";\n/** @internal */ export { warmCanvas3D, canvas3DResourceLoader, hasCanvas3DBackend } from \"./resources\";\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"inert.js","sourceRoot":"","sources":["../../src/render3d/inert.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AACjC,IAAI,WAAgC,CAAC;AAErC,gEAAgE;AAChE,SAAS,aAAa;IAClB,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAAe;IACpD,IAAI,CAAC,aAAa,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAChD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,oBAAoB;IAChC,MAAM,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAgB;IAC9C,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IAE7B,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,WAAW,CACP,mBAAmB,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,CAAC,IAAI,mHAAmH;kBACrJ,gGAAgG,CACrG,CAAC;QACN,CAAC;IACL,CAAC;IAED,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC3E,KAAK,MAAM,QAAQ,IAAI,SAAkC,EAAE,CAAC;YACxD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;gBACzD,WAAW,CACP,gBAAgB,EAChB,eAAe,QAAQ,CAAC,OAAO,uIAAuI;sBACpK,4CAA4C,CACjD,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,WAAW,CACP,WAAW,EACX,cAAc,EAAE,CAAC,GAAG,4FAA4F,CACnH,CAAC;IACN,CAAC;AACL,CAAC","sourcesContent":["import type { Graphics3DOp } from \"./graphics3d\";\
|
|
1
|
+
{"version":3,"file":"inert.js","sourceRoot":"","sources":["../../src/render3d/inert.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AACjC,IAAI,WAAgC,CAAC;AAErC,gEAAgE;AAChE,SAAS,aAAa;IAClB,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAAe;IACpD,IAAI,CAAC,aAAa,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAChD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,oBAAoB;IAChC,MAAM,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAgB;IAC9C,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO;IAE7B,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3C,WAAW,CACP,mBAAmB,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EACrC,oBAAoB,EAAE,CAAC,QAAQ,CAAC,IAAI,mHAAmH;kBACrJ,gGAAgG,CACrG,CAAC;QACN,CAAC;IACL,CAAC;IAED,IAAI,UAAU,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC3E,KAAK,MAAM,QAAQ,IAAI,SAAkC,EAAE,CAAC;YACxD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;gBACzD,WAAW,CACP,gBAAgB,EAChB,eAAe,QAAQ,CAAC,OAAO,uIAAuI;sBACpK,4CAA4C,CACjD,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,WAAW,CACP,WAAW,EACX,cAAc,EAAE,CAAC,GAAG,4FAA4F,CACnH,CAAC;IACN,CAAC;AACL,CAAC","sourcesContent":["import type { Graphics3DOp } from \"./graphics3d\";\nimport type { Material3D } from \"./material\";\n\n/**\n * Development warnings for 3D inputs that are accepted, typed and recorded, and\n * that no renderer acts on.\n *\n * A few corners of the 3D vocabulary are declared ahead of the backend: the post\n * chain, HDR/EXR/cubemap environments, `params` on a geometry or an environment,\n * `extends` on a shader material and OBJ models. Each is stored faithfully and\n * read by nothing, so a scene that uses one renders exactly like a scene without\n * it — and with no error, which is the part that costs an afternoon. These say so\n * once, in development, naming the input and what to do instead.\n *\n * Each message is printed once per session. Nothing here changes what is\n * recorded, so none of it can move a frame.\n */\n\nconst warned = new Set<string>();\nlet development: boolean | undefined;\n\n/** Read once: in Node, `process.env` is a lookup per access. */\nfunction isDevelopment(): boolean {\n return (development ??= process.env.NODE_ENV !== \"production\");\n}\n\n/**\n * Print `message` once per `key`, in development only.\n * @internal\n */\nexport function warnInert3D(key: string, message: string): void {\n if (!isDevelopment() || warned.has(key)) return;\n warned.add(key);\n console.warn(`[motionscript] ${message}`);\n}\n\n/** Forget what has been warned, so a test can see the same warning again. @internal */\nexport function resetInertWarnings3D(): void {\n warned.clear();\n}\n\n/**\n * Check one recorded drawable for inputs the renderer ignores.\n * @internal\n */\nexport function inspectDrawable3D(op: Graphics3DOp): void {\n if (!isDevelopment()) return;\n\n if (\"geometry\" in op) {\n const params = op.geometry.params;\n if (params && Object.keys(params).length > 0) {\n warnInert3D(\n `geometry-params:${op.geometry.type}`,\n `\\`params\\` on a \"${op.geometry.type}\" geometry is not applied: three builds a geometry from its named fields and nothing assigns \\`params\\` onto it. `\n + \"Set the geometry's own fields instead. (`params` is applied on materials, lights and cameras.)\",\n );\n }\n }\n\n if (\"material\" in op) {\n const materials = Array.isArray(op.material) ? op.material : [op.material];\n for (const material of materials as readonly Material3D[]) {\n if (material.type === \"shader\" && material.extends != null) {\n warnInert3D(\n \"shader-extends\",\n `\\`extends: \"${material.extends}\"\\` on a shader material is not applied: the shader replaces the built-in model, so scene lighting, shadows and fog do not reach it. `\n + \"Write the lighting you need in the shader.\",\n );\n }\n }\n }\n\n if (op.kind === \"model\" && /\\.obj(?:$|[?#])/i.test(op.src)) {\n warnInert3D(\n \"model-obj\",\n `The model \"${op.src}\" is an OBJ file, and only glTF/GLB models load: it will draw nothing. Convert it to .glb.`,\n );\n }\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"light.js","sourceRoot":"","sources":["../../src/render3d/light.ts"],"names":[],"mappings":"","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\
|
|
1
|
+
{"version":3,"file":"light.js","sourceRoot":"","sources":["../../src/render3d/light.ts"],"names":[],"mappings":"","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport type { Passthrough3D } from \"./geometry\";\nimport type { Shadow3D } from \"./transform\";\nimport type { Vector3Input } from \"./vector3\";\n\n/**\n * Every light shares its colour, its strength, and what it does about shadows.\n *\n * `shadow` is the same {@link Shadow3D} an object carries — see that type for why\n * one name covers both, and for the two knobs its object form exposes in place of\n * three's seven.\n */\ninterface LightCommon3D extends Passthrough3D {\n color?: Color;\n intensity?: number;\n}\n\n/** Uniform light from every direction. Cheap fill; casts no shadows. */\nexport interface AmbientLightData3D extends LightCommon3D {\n type: \"ambient\";\n}\n\n/**\n * Two-tone ambient — one colour from above, another from below. A cheap and\n * surprisingly effective stand-in for a sky/ground environment.\n */\nexport interface HemisphereLightData3D extends Passthrough3D {\n type: \"hemisphere\";\n /** Colour from above. */\n sky?: Color;\n /** Colour from below. */\n ground?: Color;\n intensity?: number;\n}\n\n/**\n * Parallel rays from an infinitely distant source — sunlight. Only the light's\n * *direction* matters, which is the vector from its `position` to {@link target}.\n */\nexport interface DirectionalLightData3D extends LightCommon3D {\n type: \"directional\";\n /** World-space point the light aims at. Default origin. */\n target?: Vector3Input;\n shadow?: Shadow3D;\n}\n\n/**\n * Light radiating from a point in every direction — a bare bulb.\n *\n * `intensity` is on the same scale as a directional light's: 1 is a normal light,\n * not one candela. three measures point and spot lights in candela and\n * directional lights in lux, which is physically correct and means the same\n * number produces wildly different results on the two — a scene ends up written\n * with `intensity={2.4}` on one light beside `intensity={40}` on another. The\n * renderer applies the steradian conversion so the numbers are comparable.\n */\nexport interface PointLightData3D extends LightCommon3D {\n type: \"point\";\n /** Cutoff range. 0 (default) means no cutoff. */\n distance?: number;\n /** Falloff exponent. 2 is physically correct. */\n decay?: number;\n shadow?: Shadow3D;\n}\n\n/** A cone of light — a lamp, a torch, a stage spot. */\nexport interface SpotLightData3D extends LightCommon3D {\n type: \"spot\";\n target?: Vector3Input;\n /** Cone half-angle in **degrees**. */\n angle?: number;\n /** 0 hard edge → 1 fully feathered. */\n penumbra?: number;\n distance?: number;\n decay?: number;\n shadow?: Shadow3D;\n}\n\n/**\n * A glowing rectangle — softboxes, strip lights, windows. Physically the nicest\n * soft light, but it only works with `standard`/`physical` materials and casts no\n * shadows.\n *\n * Named for what it is rather than for the three class behind it: \"rectArea\" put\n * a renderer's internal name in the authoring surface, and `Rect` already means\n * something else here.\n */\nexport interface AreaLightData3D extends LightCommon3D {\n type: \"area\";\n width?: number;\n height?: number;\n}\n\n/** Every light a scene can contain. Discriminated on `type`. */\nexport type LightData3D =\n | AmbientLightData3D\n | HemisphereLightData3D\n | DirectionalLightData3D\n | PointLightData3D\n | SpotLightData3D\n | AreaLightData3D;\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"material.js","sourceRoot":"","sources":["../../src/render3d/material.ts"],"names":[],"mappings":"AAiVA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB;IAC7D,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc;IACjE,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK;IACrE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB;IACxE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB;IACxE,kBAAkB,EAAE,qBAAqB;IACzC,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB;IACxD,aAAa,EAAE,mBAAmB,EAAE,kBAAkB;IACtD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU;IAC3D,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,oBAAoB;CACzE,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACvD,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO;IACzD,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW;IACpD,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS;CAC/C,CAAC","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\r\nimport type { Vector2 } from \"@/attributes/layout/vector2\";\r\nimport type { Vector3 } from \"./vector3\";\r\nimport type { Passthrough3D } from \"./geometry\";\r\nimport type { Blend3D, Faces3D } from \"./transform\";\r\nimport type { Texture3D } from \"./texture\";\r\n\r\n/** Facet or smooth shading. `\"flat\"` gives one normal per triangle. */\r\nexport type Shading3D = \"smooth\" | \"flat\";\r\n\r\n/**\r\n * State every material shares, regardless of shading model.\r\n *\r\n * A note on cost, because it is not obvious: the fields in the first block are\r\n * plain uniform writes the renderer can mutate in place every frame, so they are\r\n * free to animate. The fields marked **structural** change the compiled shader\r\n * program, so changing one mid-timeline forces a recompile — set them once and\r\n * leave them alone rather than tweening them.\r\n */\r\nexport interface MaterialCommon3D extends Passthrough3D {\r\n /** 0–1. Free to animate; blending is turned on for you below 1. */\r\n opacity?: number;\r\n /** Hide without removing. Free to animate. */\r\n visible?: boolean;\r\n\r\n /**\r\n * **Structural, and normally derived rather than written.**\r\n *\r\n * The renderer turns alpha blending on whenever anything about the material\r\n * actually needs it — `opacity` below 1, a colour carrying alpha, an\r\n * `alphaMap`, or transmission — so an author never has to pair a fade with a\r\n * second flag, and `opacity: 0.5` can no longer silently do nothing (which is\r\n * exactly what it did when this defaulted to `false`).\r\n *\r\n * Set it explicitly only to *force* blending on a fully opaque material, which\r\n * is occasionally wanted for draw-order reasons. Setting it `false` does not\r\n * turn off blending a lower alpha requires; there is no useful meaning for\r\n * that, and it only ever expressed a bug.\r\n */\r\n transparent?: boolean;\r\n /** **Structural.** Discard fragments below this alpha. Cheap cutout transparency. */\r\n alphaTest?: number;\r\n /** **Structural.** Which faces to rasterize. Default `\"front\"`. */\r\n faces?: Faces3D;\r\n /** **Structural.** Draw edges only. */\r\n wireframe?: boolean;\r\n /** **Structural.** How the colour combines with the framebuffer. */\r\n blend?: Blend3D;\r\n /** **Structural.** Read per-vertex colours from the geometry's `color` buffer. */\r\n vertexColors?: boolean;\r\n /** **Structural.** Apply the scene's tone mapping. Default true. */\r\n toneMapped?: boolean;\r\n\r\n /**\r\n * Write to the depth buffer.\r\n *\r\n * **Derived unless stated**: a blended surface stops writing depth, and an\r\n * opaque one writes it. three defaults this to `true` for everything, so a\r\n * translucent mesh occluded whatever was drawn after it — a surface at 5%\r\n * opacity rendering as a near-invisible cut-out through the things behind\r\n * it. Set it explicitly for a translucent surface that genuinely should\r\n * occlude.\r\n */\r\n depthWrite?: boolean;\r\n /** Test against the depth buffer. Turn off to force draw-on-top. */\r\n depthTest?: boolean;\r\n /** Nudge depth to break z-fighting between coplanar surfaces. */\r\n polygonOffset?: boolean;\r\n polygonOffsetFactor?: number;\r\n polygonOffsetUnits?: number;\r\n /** Smooth gradient banding. */\r\n dithering?: boolean;\r\n}\r\n\r\n/** Maps shared by the lit shading models. */\r\ninterface CommonMaps3D {\r\n /** Base colour (albedo). Sampled as sRGB. */\r\n map?: Texture3D;\r\n /** Per-pixel opacity, read from the red channel. */\r\n alphaMap?: Texture3D;\r\n /** Ambient occlusion, read from the red channel. Needs a second UV set. */\r\n aoMap?: Texture3D;\r\n aoMapIntensity?: number;\r\n /** Tangent-space normals. Sampled as linear data, not colour. */\r\n normalMap?: Texture3D;\r\n /** Normal strength, per axis. A number applies to both. */\r\n normalScale?: number | Vector2;\r\n /** Displaces vertices along their normals. Needs a subdivided geometry. */\r\n displacementMap?: Texture3D;\r\n displacementScale?: number;\r\n displacementBias?: number;\r\n /** Reflected environment. Usually inherited from the scene's environment. */\r\n envMap?: Texture3D;\r\n /** Multiplies light received from the environment. */\r\n envMapIntensity?: number;\r\n /** Baked light added on top, unaffected by scene lights. */\r\n lightMap?: Texture3D;\r\n lightMapIntensity?: number;\r\n}\r\n\r\n/** Emission shared by the lit shading models. */\r\ninterface Emissive3D {\r\n /** Self-illumination colour. Does not light other objects (see `post` bloom). */\r\n emission?: Color;\r\n emissionStrength?: number;\r\n emissionMap?: Texture3D;\r\n}\r\n\r\n/** Unlit — a flat colour, ignoring every light. The cheapest material. */\r\nexport interface BasicMaterial3D extends MaterialCommon3D, CommonMaps3D {\r\n type: \"basic\";\r\n color?: Color;\r\n}\r\n\r\n/**\r\n * Physically based metal/rough shading. The sensible default for most surfaces:\r\n * `roughness` and `metalness` cover the majority of real materials, and both are\r\n * free to animate.\r\n */\r\nexport interface StandardMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\r\n type: \"standard\";\r\n color?: Color;\r\n /** 0 mirror-smooth → 1 fully diffuse. */\r\n roughness?: number;\r\n /** 0 dielectric → 1 metal. Metals tint their reflections by `color`. */\r\n metalness?: number;\r\n roughnessMap?: Texture3D;\r\n metalnessMap?: Texture3D;\r\n /** **Structural.** Facet or smooth shading. Default `\"smooth\"`. */\r\n shading?: Shading3D;\r\n}\r\n\r\n/**\r\n * Everything {@link StandardMaterial3D} has plus the expensive extras: clearcoat,\r\n * transmission (real refraction), sheen and iridescence. Costs more per pixel, so\r\n * reach for `standard` unless a surface needs these.\r\n */\r\nexport interface PhysicalMaterial3D extends Omit<StandardMaterial3D, \"type\"> {\r\n type: \"physical\";\r\n /** A second specular lobe over the base — car paint, lacquer, varnish. */\r\n clearcoat?: number;\r\n clearcoatRoughness?: number;\r\n clearcoatMap?: Texture3D;\r\n clearcoatNormalMap?: Texture3D;\r\n clearcoatRoughnessMap?: Texture3D;\r\n /** Light transmitted *through* the surface — glass, water. Blends for you. */\r\n transmission?: number;\r\n transmissionMap?: Texture3D;\r\n /** Wall thickness for transmission tinting. */\r\n thickness?: number;\r\n thicknessMap?: Texture3D;\r\n /** Volumetric absorption colour at {@link attenuationDistance}. */\r\n attenuationColor?: Color;\r\n attenuationDistance?: number;\r\n /** Index of refraction. 1.5 glass, 1.33 water, 2.42 diamond. */\r\n ior?: number;\r\n /** Retroreflective sheen — cloth, velvet, dust. */\r\n sheen?: number;\r\n sheenColor?: Color;\r\n sheenRoughness?: number;\r\n /** Thin-film interference — soap bubbles, oil slicks, beetle shells. */\r\n iridescence?: number;\r\n iridescenceIOR?: number;\r\n iridescenceThicknessRange?: readonly [number, number];\r\n /** Strength/tint of the dielectric specular highlight. */\r\n specularIntensity?: number;\r\n specularColor?: Color;\r\n /** Anisotropic (brushed-metal) highlight stretching. */\r\n anisotropy?: number;\r\n /** Degrees. */\r\n anisotropyRotation?: number;\r\n}\r\n\r\n/** Classic Blinn-Phong: a diffuse term plus a tight specular highlight. */\r\nexport interface PhongMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\r\n type: \"phong\";\r\n color?: Color;\r\n specular?: Color;\r\n /** Highlight tightness. Higher is smaller and sharper. */\r\n shininess?: number;\r\n specularMap?: Texture3D;\r\n /** **Structural.** */\r\n shading?: Shading3D;\r\n}\r\n\r\n/** Diffuse-only Lambertian shading. Cheap; good for matte and unlit-ish looks. */\r\nexport interface LambertMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\r\n type: \"lambert\";\r\n color?: Color;\r\n /** **Structural.** */\r\n shading?: Shading3D;\r\n}\r\n\r\n/** Banded cel shading. `gradientMap` controls the steps. */\r\nexport interface ToonMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\r\n type: \"toon\";\r\n color?: Color;\r\n gradientMap?: Texture3D;\r\n}\r\n\r\n/** Surface normals as RGB. A debugging workhorse. */\r\nexport interface NormalMaterial3D extends MaterialCommon3D {\r\n type: \"normal\";\r\n /** **Structural.** */\r\n shading?: Shading3D;\r\n}\r\n\r\n/** Depth as greyscale. For debugging and custom depth passes. */\r\nexport interface DepthMaterial3D extends MaterialCommon3D {\r\n type: \"depth\";\r\n}\r\n\r\n/** Lit by a pre-baked sphere image. Very cheap, very stylizable. */\r\nexport interface MatcapMaterial3D extends MaterialCommon3D {\r\n type: \"matcap\";\r\n color?: Color;\r\n matcap?: Texture3D;\r\n map?: Texture3D;\r\n normalMap?: Texture3D;\r\n normalScale?: number | Vector2;\r\n}\r\n\r\n/** Shading for a `points` cloud. */\r\nexport interface PointsMaterial3D extends MaterialCommon3D {\r\n type: \"points\";\r\n color?: Color;\r\n size?: number;\r\n /** Shrink distant points with perspective. Default true. */\r\n sizeAttenuation?: boolean;\r\n map?: Texture3D;\r\n alphaMap?: Texture3D;\r\n}\r\n\r\n/**\r\n * Shading for a `line`. Note `width` is capped at 1px by most WebGL\r\n * implementations regardless of what you set, and **nothing substitutes a\r\n * mesh-backed line** for a larger one: it is written to `linewidth` and that is\r\n * all. For a genuinely thick line draw a `tube`.\r\n */\r\nexport interface LineBasicMaterial3D extends MaterialCommon3D {\r\n type: \"lineBasic\";\r\n color?: Color;\r\n width?: number;\r\n}\r\n\r\n/** A dashed line. Requires computed line distances, which the renderer handles. */\r\nexport interface LineDashedMaterial3D extends MaterialCommon3D {\r\n type: \"lineDashed\";\r\n color?: Color;\r\n width?: number;\r\n dashSize?: number;\r\n gapSize?: number;\r\n /** Offset along the line — animate for a marching-ants effect. */\r\n scale?: number;\r\n}\r\n\r\n/** Shading for a camera-facing `sprite`. */\r\nexport interface SpriteMaterial3D extends MaterialCommon3D {\r\n type: \"sprite\";\r\n color?: Color;\r\n map?: Texture3D;\r\n /** Degrees. */\r\n rotation?: number;\r\n}\r\n\r\n/** Receives shadows onto an otherwise invisible surface. For AR-style grounding. */\r\nexport interface ShadowMaterial3D extends MaterialCommon3D {\r\n type: \"shadow\";\r\n color?: Color;\r\n}\r\n\r\n/**\r\n * A shader uniform value. Deliberately narrow: everything here is plain,\r\n * inspectable data that can be interpolated, which is what keeps a shader-driven\r\n * scene seekable.\r\n */\r\nexport type Uniform3D =\r\n | number\r\n | boolean\r\n | Color\r\n | Vector2\r\n | Vector3\r\n | { x: number; y: number; z: number; w: number }\r\n | readonly number[]\r\n | Texture3D;\r\n\r\n/**\r\n * Raw GLSL — total control over both stages.\r\n *\r\n * Uniform **values** are cheap: the renderer writes them in place each frame, so\r\n * driving them from tweened props costs nothing. Uniform *names* and the shader\r\n * **source** are structural — changing either recompiles the program.\r\n *\r\n * {@link extends} is declared to patch three's built-in lit shader instead of\r\n * replacing it, but **it is not read yet**: a shader always replaces the model, so\r\n * scene lighting, shadows and fog do not reach it. The first material that sets\r\n * it warns in development. Write the lighting you need in the shader.\r\n */\r\nexport interface ShaderMaterial3D extends MaterialCommon3D {\r\n type: \"shader\";\r\n /** Vertex stage source. */\r\n vertex: string;\r\n /** Fragment stage source. */\r\n fragment: string;\r\n uniforms?: Readonly<Record<string, Uniform3D>>;\r\n /** `#define`s injected ahead of both stages. **Structural.** */\r\n defines?: Readonly<Record<string, string | number | boolean>>;\r\n /**\r\n * Wrap a built-in shading model rather than replacing it, so scene lighting,\r\n * shadows and fog still apply. Null (the default) is a raw shader.\r\n *\r\n * **Not implemented**: no backend reads it, so every shader is a plain\r\n * replacement whatever this says.\r\n */\r\n extends?: \"standard\" | \"basic\" | \"phong\" | null;\r\n /** Skip three's automatic attribute/uniform prelude (a raw shader). */\r\n raw?: boolean;\r\n}\r\n\r\n/** Every material a drawable can be shaded with. Discriminated on `type`. */\r\nexport type Material3D =\r\n | BasicMaterial3D\r\n | StandardMaterial3D\r\n | PhysicalMaterial3D\r\n | PhongMaterial3D\r\n | LambertMaterial3D\r\n | ToonMaterial3D\r\n | NormalMaterial3D\r\n | DepthMaterial3D\r\n | MatcapMaterial3D\r\n | PointsMaterial3D\r\n | LineBasicMaterial3D\r\n | LineDashedMaterial3D\r\n | SpriteMaterial3D\r\n | ShadowMaterial3D\r\n | ShaderMaterial3D;\r\n\r\n/**\r\n * Material fields whose value the renderer can write in place, without\r\n * recompiling. Everything *not* listed here is structural: changing it rebuilds\r\n * the material. Shared by the reconciler and the `MeshShorthand` desugarer so the\r\n * two can't disagree about what is cheap.\r\n */\r\nexport const MUTABLE_MATERIAL_KEYS: readonly string[] = [\r\n \"color\", \"opacity\", \"visible\", \"emission\", \"emissionStrength\",\r\n \"roughness\", \"metalness\", \"shininess\", \"specular\", \"reflectivity\",\r\n \"clearcoat\", \"clearcoatRoughness\", \"transmission\", \"thickness\", \"ior\",\r\n \"sheen\", \"sheenColor\", \"sheenRoughness\", \"iridescence\", \"iridescenceIOR\",\r\n \"specularIntensity\", \"specularColor\", \"anisotropy\", \"anisotropyRotation\",\r\n \"attenuationColor\", \"attenuationDistance\",\r\n \"aoMapIntensity\", \"lightMapIntensity\", \"envMapIntensity\",\r\n \"normalScale\", \"displacementScale\", \"displacementBias\",\r\n \"size\", \"width\", \"dashSize\", \"gapSize\", \"scale\", \"rotation\",\r\n \"depthWrite\", \"depthTest\", \"polygonOffsetFactor\", \"polygonOffsetUnits\",\r\n];\r\n\r\n/**\r\n * Material fields that change the compiled shader program. Changing one forces a\r\n * rebuild, so they must never be tweened — the renderer warns when it sees one\r\n * change repeatedly.\r\n *\r\n * `transparent` is here and is also *derived*, which is only a contradiction\r\n * until you look at when it moves: it flips at most once per material, on the\r\n * first frame a fade leaves full opacity, and the renderer latches it there. See\r\n * `needsBlending` in the material handler.\r\n */\r\nexport const STRUCTURAL_MATERIAL_KEYS: readonly string[] = [\r\n \"transparent\", \"alphaTest\", \"faces\", \"wireframe\", \"blend\",\r\n \"vertexColors\", \"toneMapped\", \"shading\", \"dithering\",\r\n \"polygonOffset\", \"raw\", \"extends\", \"defines\",\r\n];\r\n"]}
|
|
1
|
+
{"version":3,"file":"material.js","sourceRoot":"","sources":["../../src/render3d/material.ts"],"names":[],"mappings":"AAiVA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB;IAC7D,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc;IACjE,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK;IACrE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB;IACxE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB;IACxE,kBAAkB,EAAE,qBAAqB;IACzC,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB;IACxD,aAAa,EAAE,mBAAmB,EAAE,kBAAkB;IACtD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU;IAC3D,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,oBAAoB;CACzE,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACvD,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO;IACzD,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW;IACpD,eAAe,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS;CAC/C,CAAC","sourcesContent":["import type { Color } from \"@/attributes/shape/fill/color/parser\";\nimport type { Vector2 } from \"@/attributes/layout/vector2\";\nimport type { Vector3 } from \"./vector3\";\nimport type { Passthrough3D } from \"./geometry\";\nimport type { Blend3D, Faces3D } from \"./transform\";\nimport type { Texture3D } from \"./texture\";\n\n/** Facet or smooth shading. `\"flat\"` gives one normal per triangle. */\nexport type Shading3D = \"smooth\" | \"flat\";\n\n/**\n * State every material shares, regardless of shading model.\n *\n * A note on cost, because it is not obvious: the fields in the first block are\n * plain uniform writes the renderer can mutate in place every frame, so they are\n * free to animate. The fields marked **structural** change the compiled shader\n * program, so changing one mid-timeline forces a recompile — set them once and\n * leave them alone rather than tweening them.\n */\nexport interface MaterialCommon3D extends Passthrough3D {\n /** 0–1. Free to animate; blending is turned on for you below 1. */\n opacity?: number;\n /** Hide without removing. Free to animate. */\n visible?: boolean;\n\n /**\n * **Structural, and normally derived rather than written.**\n *\n * The renderer turns alpha blending on whenever anything about the material\n * actually needs it — `opacity` below 1, a colour carrying alpha, an\n * `alphaMap`, or transmission — so an author never has to pair a fade with a\n * second flag, and `opacity: 0.5` can no longer silently do nothing (which is\n * exactly what it did when this defaulted to `false`).\n *\n * Set it explicitly only to *force* blending on a fully opaque material, which\n * is occasionally wanted for draw-order reasons. Setting it `false` does not\n * turn off blending a lower alpha requires; there is no useful meaning for\n * that, and it only ever expressed a bug.\n */\n transparent?: boolean;\n /** **Structural.** Discard fragments below this alpha. Cheap cutout transparency. */\n alphaTest?: number;\n /** **Structural.** Which faces to rasterize. Default `\"front\"`. */\n faces?: Faces3D;\n /** **Structural.** Draw edges only. */\n wireframe?: boolean;\n /** **Structural.** How the colour combines with the framebuffer. */\n blend?: Blend3D;\n /** **Structural.** Read per-vertex colours from the geometry's `color` buffer. */\n vertexColors?: boolean;\n /** **Structural.** Apply the scene's tone mapping. Default true. */\n toneMapped?: boolean;\n\n /**\n * Write to the depth buffer.\n *\n * **Derived unless stated**: a blended surface stops writing depth, and an\n * opaque one writes it. three defaults this to `true` for everything, so a\n * translucent mesh occluded whatever was drawn after it — a surface at 5%\n * opacity rendering as a near-invisible cut-out through the things behind\n * it. Set it explicitly for a translucent surface that genuinely should\n * occlude.\n */\n depthWrite?: boolean;\n /** Test against the depth buffer. Turn off to force draw-on-top. */\n depthTest?: boolean;\n /** Nudge depth to break z-fighting between coplanar surfaces. */\n polygonOffset?: boolean;\n polygonOffsetFactor?: number;\n polygonOffsetUnits?: number;\n /** Smooth gradient banding. */\n dithering?: boolean;\n}\n\n/** Maps shared by the lit shading models. */\ninterface CommonMaps3D {\n /** Base colour (albedo). Sampled as sRGB. */\n map?: Texture3D;\n /** Per-pixel opacity, read from the red channel. */\n alphaMap?: Texture3D;\n /** Ambient occlusion, read from the red channel. Needs a second UV set. */\n aoMap?: Texture3D;\n aoMapIntensity?: number;\n /** Tangent-space normals. Sampled as linear data, not colour. */\n normalMap?: Texture3D;\n /** Normal strength, per axis. A number applies to both. */\n normalScale?: number | Vector2;\n /** Displaces vertices along their normals. Needs a subdivided geometry. */\n displacementMap?: Texture3D;\n displacementScale?: number;\n displacementBias?: number;\n /** Reflected environment. Usually inherited from the scene's environment. */\n envMap?: Texture3D;\n /** Multiplies light received from the environment. */\n envMapIntensity?: number;\n /** Baked light added on top, unaffected by scene lights. */\n lightMap?: Texture3D;\n lightMapIntensity?: number;\n}\n\n/** Emission shared by the lit shading models. */\ninterface Emissive3D {\n /** Self-illumination colour. Does not light other objects (see `post` bloom). */\n emission?: Color;\n emissionStrength?: number;\n emissionMap?: Texture3D;\n}\n\n/** Unlit — a flat colour, ignoring every light. The cheapest material. */\nexport interface BasicMaterial3D extends MaterialCommon3D, CommonMaps3D {\n type: \"basic\";\n color?: Color;\n}\n\n/**\n * Physically based metal/rough shading. The sensible default for most surfaces:\n * `roughness` and `metalness` cover the majority of real materials, and both are\n * free to animate.\n */\nexport interface StandardMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\n type: \"standard\";\n color?: Color;\n /** 0 mirror-smooth → 1 fully diffuse. */\n roughness?: number;\n /** 0 dielectric → 1 metal. Metals tint their reflections by `color`. */\n metalness?: number;\n roughnessMap?: Texture3D;\n metalnessMap?: Texture3D;\n /** **Structural.** Facet or smooth shading. Default `\"smooth\"`. */\n shading?: Shading3D;\n}\n\n/**\n * Everything {@link StandardMaterial3D} has plus the expensive extras: clearcoat,\n * transmission (real refraction), sheen and iridescence. Costs more per pixel, so\n * reach for `standard` unless a surface needs these.\n */\nexport interface PhysicalMaterial3D extends Omit<StandardMaterial3D, \"type\"> {\n type: \"physical\";\n /** A second specular lobe over the base — car paint, lacquer, varnish. */\n clearcoat?: number;\n clearcoatRoughness?: number;\n clearcoatMap?: Texture3D;\n clearcoatNormalMap?: Texture3D;\n clearcoatRoughnessMap?: Texture3D;\n /** Light transmitted *through* the surface — glass, water. Blends for you. */\n transmission?: number;\n transmissionMap?: Texture3D;\n /** Wall thickness for transmission tinting. */\n thickness?: number;\n thicknessMap?: Texture3D;\n /** Volumetric absorption colour at {@link attenuationDistance}. */\n attenuationColor?: Color;\n attenuationDistance?: number;\n /** Index of refraction. 1.5 glass, 1.33 water, 2.42 diamond. */\n ior?: number;\n /** Retroreflective sheen — cloth, velvet, dust. */\n sheen?: number;\n sheenColor?: Color;\n sheenRoughness?: number;\n /** Thin-film interference — soap bubbles, oil slicks, beetle shells. */\n iridescence?: number;\n iridescenceIOR?: number;\n iridescenceThicknessRange?: readonly [number, number];\n /** Strength/tint of the dielectric specular highlight. */\n specularIntensity?: number;\n specularColor?: Color;\n /** Anisotropic (brushed-metal) highlight stretching. */\n anisotropy?: number;\n /** Degrees. */\n anisotropyRotation?: number;\n}\n\n/** Classic Blinn-Phong: a diffuse term plus a tight specular highlight. */\nexport interface PhongMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\n type: \"phong\";\n color?: Color;\n specular?: Color;\n /** Highlight tightness. Higher is smaller and sharper. */\n shininess?: number;\n specularMap?: Texture3D;\n /** **Structural.** */\n shading?: Shading3D;\n}\n\n/** Diffuse-only Lambertian shading. Cheap; good for matte and unlit-ish looks. */\nexport interface LambertMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\n type: \"lambert\";\n color?: Color;\n /** **Structural.** */\n shading?: Shading3D;\n}\n\n/** Banded cel shading. `gradientMap` controls the steps. */\nexport interface ToonMaterial3D extends MaterialCommon3D, CommonMaps3D, Emissive3D {\n type: \"toon\";\n color?: Color;\n gradientMap?: Texture3D;\n}\n\n/** Surface normals as RGB. A debugging workhorse. */\nexport interface NormalMaterial3D extends MaterialCommon3D {\n type: \"normal\";\n /** **Structural.** */\n shading?: Shading3D;\n}\n\n/** Depth as greyscale. For debugging and custom depth passes. */\nexport interface DepthMaterial3D extends MaterialCommon3D {\n type: \"depth\";\n}\n\n/** Lit by a pre-baked sphere image. Very cheap, very stylizable. */\nexport interface MatcapMaterial3D extends MaterialCommon3D {\n type: \"matcap\";\n color?: Color;\n matcap?: Texture3D;\n map?: Texture3D;\n normalMap?: Texture3D;\n normalScale?: number | Vector2;\n}\n\n/** Shading for a `points` cloud. */\nexport interface PointsMaterial3D extends MaterialCommon3D {\n type: \"points\";\n color?: Color;\n size?: number;\n /** Shrink distant points with perspective. Default true. */\n sizeAttenuation?: boolean;\n map?: Texture3D;\n alphaMap?: Texture3D;\n}\n\n/**\n * Shading for a `line`. Note `width` is capped at 1px by most WebGL\n * implementations regardless of what you set, and **nothing substitutes a\n * mesh-backed line** for a larger one: it is written to `linewidth` and that is\n * all. For a genuinely thick line draw a `tube`.\n */\nexport interface LineBasicMaterial3D extends MaterialCommon3D {\n type: \"lineBasic\";\n color?: Color;\n width?: number;\n}\n\n/** A dashed line. Requires computed line distances, which the renderer handles. */\nexport interface LineDashedMaterial3D extends MaterialCommon3D {\n type: \"lineDashed\";\n color?: Color;\n width?: number;\n dashSize?: number;\n gapSize?: number;\n /** Offset along the line — animate for a marching-ants effect. */\n scale?: number;\n}\n\n/** Shading for a camera-facing `sprite`. */\nexport interface SpriteMaterial3D extends MaterialCommon3D {\n type: \"sprite\";\n color?: Color;\n map?: Texture3D;\n /** Degrees. */\n rotation?: number;\n}\n\n/** Receives shadows onto an otherwise invisible surface. For AR-style grounding. */\nexport interface ShadowMaterial3D extends MaterialCommon3D {\n type: \"shadow\";\n color?: Color;\n}\n\n/**\n * A shader uniform value. Deliberately narrow: everything here is plain,\n * inspectable data that can be interpolated, which is what keeps a shader-driven\n * scene seekable.\n */\nexport type Uniform3D =\n | number\n | boolean\n | Color\n | Vector2\n | Vector3\n | { x: number; y: number; z: number; w: number }\n | readonly number[]\n | Texture3D;\n\n/**\n * Raw GLSL — total control over both stages.\n *\n * Uniform **values** are cheap: the renderer writes them in place each frame, so\n * driving them from tweened props costs nothing. Uniform *names* and the shader\n * **source** are structural — changing either recompiles the program.\n *\n * {@link extends} is declared to patch three's built-in lit shader instead of\n * replacing it, but **it is not read yet**: a shader always replaces the model, so\n * scene lighting, shadows and fog do not reach it. The first material that sets\n * it warns in development. Write the lighting you need in the shader.\n */\nexport interface ShaderMaterial3D extends MaterialCommon3D {\n type: \"shader\";\n /** Vertex stage source. */\n vertex: string;\n /** Fragment stage source. */\n fragment: string;\n uniforms?: Readonly<Record<string, Uniform3D>>;\n /** `#define`s injected ahead of both stages. **Structural.** */\n defines?: Readonly<Record<string, string | number | boolean>>;\n /**\n * Wrap a built-in shading model rather than replacing it, so scene lighting,\n * shadows and fog still apply. Null (the default) is a raw shader.\n *\n * **Not implemented**: no backend reads it, so every shader is a plain\n * replacement whatever this says.\n */\n extends?: \"standard\" | \"basic\" | \"phong\" | null;\n /** Skip three's automatic attribute/uniform prelude (a raw shader). */\n raw?: boolean;\n}\n\n/** Every material a drawable can be shaded with. Discriminated on `type`. */\nexport type Material3D =\n | BasicMaterial3D\n | StandardMaterial3D\n | PhysicalMaterial3D\n | PhongMaterial3D\n | LambertMaterial3D\n | ToonMaterial3D\n | NormalMaterial3D\n | DepthMaterial3D\n | MatcapMaterial3D\n | PointsMaterial3D\n | LineBasicMaterial3D\n | LineDashedMaterial3D\n | SpriteMaterial3D\n | ShadowMaterial3D\n | ShaderMaterial3D;\n\n/**\n * Material fields whose value the renderer can write in place, without\n * recompiling. Everything *not* listed here is structural: changing it rebuilds\n * the material. Shared by the reconciler and the `MeshShorthand` desugarer so the\n * two can't disagree about what is cheap.\n */\nexport const MUTABLE_MATERIAL_KEYS: readonly string[] = [\n \"color\", \"opacity\", \"visible\", \"emission\", \"emissionStrength\",\n \"roughness\", \"metalness\", \"shininess\", \"specular\", \"reflectivity\",\n \"clearcoat\", \"clearcoatRoughness\", \"transmission\", \"thickness\", \"ior\",\n \"sheen\", \"sheenColor\", \"sheenRoughness\", \"iridescence\", \"iridescenceIOR\",\n \"specularIntensity\", \"specularColor\", \"anisotropy\", \"anisotropyRotation\",\n \"attenuationColor\", \"attenuationDistance\",\n \"aoMapIntensity\", \"lightMapIntensity\", \"envMapIntensity\",\n \"normalScale\", \"displacementScale\", \"displacementBias\",\n \"size\", \"width\", \"dashSize\", \"gapSize\", \"scale\", \"rotation\",\n \"depthWrite\", \"depthTest\", \"polygonOffsetFactor\", \"polygonOffsetUnits\",\n];\n\n/**\n * Material fields that change the compiled shader program. Changing one forces a\n * rebuild, so they must never be tweened — the renderer warns when it sees one\n * change repeatedly.\n *\n * `transparent` is here and is also *derived*, which is only a contradiction\n * until you look at when it moves: it flips at most once per material, on the\n * first frame a fade leaves full opacity, and the renderer latches it there. See\n * `needsBlending` in the material handler.\n */\nexport const STRUCTURAL_MATERIAL_KEYS: readonly string[] = [\n \"transparent\", \"alphaTest\", \"faces\", \"wireframe\", \"blend\",\n \"vertexColors\", \"toneMapped\", \"shading\", \"dithering\",\n \"polygonOffset\", \"raw\", \"extends\", \"defines\",\n];\n"]}
|