@motionscript/core 0.1.0-alpha.3 → 0.1.0-alpha.5
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 +220 -0
- package/LICENSE +201 -201
- package/NOTICE +48 -0
- package/README.md +93 -72
- package/dist/assets/asset-index.js.map +1 -1
- package/dist/assets/catalog.d.ts +9 -0
- package/dist/assets/catalog.d.ts.map +1 -1
- package/dist/assets/catalog.js +11 -0
- package/dist/assets/catalog.js.map +1 -1
- package/dist/assets/errors.d.ts.map +1 -1
- package/dist/assets/errors.js +8 -3
- package/dist/assets/errors.js.map +1 -1
- package/dist/assets/index.js.map +1 -1
- package/dist/assets/manager.d.ts +26 -1
- package/dist/assets/manager.d.ts.map +1 -1
- package/dist/assets/manager.js +79 -4
- 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.d.ts +3 -3
- package/dist/assets/scope.d.ts.map +1 -1
- package/dist/assets/scope.js.map +1 -1
- package/dist/attributes/audio/filters/chain.d.ts +1 -1
- package/dist/attributes/audio/filters/chain.js.map +1 -1
- package/dist/attributes/audio/filters/curve.d.ts +8 -8
- package/dist/attributes/audio/filters/curve.d.ts.map +1 -1
- package/dist/attributes/audio/filters/curve.js +20 -19
- package/dist/attributes/audio/filters/curve.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/echo.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/gain.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/highpass.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/lowpass.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/speed.d.ts +2 -2
- package/dist/attributes/audio/filters/implementations/speed.js.map +1 -1
- package/dist/attributes/audio/filters/implementations/tremolo.js.map +1 -1
- package/dist/attributes/audio/filters/index.d.ts +1 -1
- package/dist/attributes/audio/filters/index.d.ts.map +1 -1
- package/dist/attributes/audio/filters/index.js +1 -1
- package/dist/attributes/audio/filters/index.js.map +1 -1
- package/dist/attributes/audio/filters/registry.js.map +1 -1
- package/dist/attributes/audio/filters/union.js.map +1 -1
- package/dist/attributes/audio/request.d.ts +17 -2
- package/dist/attributes/audio/request.d.ts.map +1 -1
- package/dist/attributes/audio/request.js.map +1 -1
- package/dist/attributes/audio/schedule.d.ts +4 -2
- package/dist/attributes/audio/schedule.d.ts.map +1 -1
- package/dist/attributes/audio/schedule.js +15 -8
- package/dist/attributes/audio/schedule.js.map +1 -1
- package/dist/attributes/audio/sound.d.ts +4 -2
- package/dist/attributes/audio/sound.d.ts.map +1 -1
- package/dist/attributes/audio/sound.js +8 -4
- package/dist/attributes/audio/sound.js.map +1 -1
- package/dist/attributes/index.js.map +1 -1
- package/dist/attributes/layout/alignment.js +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.js.map +1 -1
- package/dist/attributes/layout/size.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.d.ts +3 -1
- package/dist/attributes/properties/decorator.d.ts.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 +9 -2
- package/dist/attributes/properties/typed.d.ts.map +1 -1
- package/dist/attributes/properties/typed.js +15 -1
- package/dist/attributes/properties/typed.js.map +1 -1
- package/dist/attributes/render3d/orbit.d.ts +8 -8
- package/dist/attributes/render3d/orbit.js +7 -7
- package/dist/attributes/render3d/orbit.js.map +1 -1
- 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.d.ts +4 -4
- package/dist/attributes/shape/effects/backdrop.d.ts.map +1 -1
- package/dist/attributes/shape/effects/backdrop.js.map +1 -1
- package/dist/attributes/shape/effects/chain.d.ts +28 -120
- package/dist/attributes/shape/effects/chain.d.ts.map +1 -1
- package/dist/attributes/shape/effects/chain.js +16 -88
- package/dist/attributes/shape/effects/chain.js.map +1 -1
- package/dist/attributes/shape/effects/effect-data.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/ascii.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bit-crush.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/block-displace.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bloom.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/bulge.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/chromatic-aberration.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/color-adjustment.d.ts +2 -2
- package/dist/attributes/shape/effects/implementations/color-adjustment.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/curves.d.ts +1 -1
- package/dist/attributes/shape/effects/implementations/curves.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/directional-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/dither.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/drop-shadow.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/duotone.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/edges.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/glass.d.ts +15 -24
- package/dist/attributes/shape/effects/implementations/glass.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/glass.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/glow.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/grain.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/grayscale.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/halftone.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/invert.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/kaleidoscope.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/lut.d.ts +1 -1
- package/dist/attributes/shape/effects/implementations/lut.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/magnify.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/motion-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/oil-paint.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/outline.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/pixelate.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/posterize.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/progressive-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/radial-blur.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/rgb-shift.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/scanlines.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/scatter.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/shader.d.ts.map +1 -1
- package/dist/attributes/shape/effects/implementations/shader.js +15 -8
- package/dist/attributes/shape/effects/implementations/shader.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/sharpen.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/streak.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/threshold.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/twirl.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/vignette.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/vintage.js.map +1 -1
- package/dist/attributes/shape/effects/implementations/wave.js.map +1 -1
- package/dist/attributes/shape/effects/index.d.ts +2 -6
- package/dist/attributes/shape/effects/index.d.ts.map +1 -1
- package/dist/attributes/shape/effects/index.js.map +1 -1
- package/dist/attributes/shape/effects/registry.d.ts +23 -6
- package/dist/attributes/shape/effects/registry.d.ts.map +1 -1
- package/dist/attributes/shape/effects/registry.js +44 -10
- package/dist/attributes/shape/effects/registry.js.map +1 -1
- package/dist/attributes/shape/effects/union.d.ts +2 -6
- package/dist/attributes/shape/effects/union.d.ts.map +1 -1
- 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.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.d.ts.map +1 -1
- package/dist/attributes/shape/fill/color/parser.js +81 -44
- package/dist/attributes/shape/fill/color/parser.js.map +1 -1
- package/dist/attributes/shape/fill/gradient-stops.d.ts +16 -0
- package/dist/attributes/shape/fill/gradient-stops.d.ts.map +1 -0
- package/dist/attributes/shape/fill/gradient-stops.js +65 -0
- package/dist/attributes/shape/fill/gradient-stops.js.map +1 -0
- 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.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/conic-gradient.js +2 -5
- 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.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/fractal-noise.js +2 -10
- 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.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/image.js +5 -4
- package/dist/attributes/shape/fill/implementations/image.js.map +1 -1
- package/dist/attributes/shape/fill/implementations/linear-gradient.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/linear-gradient.js +2 -6
- 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.d.ts.map +1 -1
- package/dist/attributes/shape/fill/implementations/radial-gradient.js +2 -5
- package/dist/attributes/shape/fill/implementations/radial-gradient.js.map +1 -1
- 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 +1 -1
- package/dist/attributes/shape/fill/implementations/video.js.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.js.map +1 -1
- package/dist/attributes/shape/fill/union.js.map +1 -1
- package/dist/attributes/shape/filters/chain.d.ts +4 -10
- package/dist/attributes/shape/filters/chain.d.ts.map +1 -1
- package/dist/attributes/shape/filters/chain.js +1 -13
- 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.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.d.ts +1 -1
- package/dist/attributes/shape/filters/index.js.map +1 -1
- package/dist/attributes/shape/filters/registry.d.ts +2 -2
- 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 +6 -7
- 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.d.ts.map +1 -1
- package/dist/attributes/shape/path/anchors.js +12 -5
- 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.d.ts.map +1 -1
- package/dist/attributes/shape/path/morph.js +16 -4
- 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.js.map +1 -1
- package/dist/attributes/shape/shaders/pack.js.map +1 -1
- package/dist/attributes/shape/shaders/resolve.js.map +1 -1
- 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.d.ts +2 -2
- package/dist/attributes/shape/stroke/index.d.ts.map +1 -1
- package/dist/attributes/shape/stroke/index.js +1 -1
- package/dist/attributes/shape/stroke/index.js.map +1 -1
- package/dist/attributes/shape/stroke/stroke.d.ts +27 -6
- package/dist/attributes/shape/stroke/stroke.d.ts.map +1 -1
- package/dist/attributes/shape/stroke/stroke.js +22 -2
- 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.d.ts +6 -0
- package/dist/attributes/text/ops.d.ts.map +1 -1
- package/dist/attributes/text/ops.js +1 -0
- package/dist/attributes/text/ops.js.map +1 -1
- package/dist/attributes/text/types.js.map +1 -1
- package/dist/browser/chunks/chunk-FUZVFT3W.js +18 -0
- package/dist/browser/chunks/chunk-FUZVFT3W.js.map +7 -0
- package/dist/browser/chunks/chunk-QG6C23IJ.js +3 -0
- package/dist/browser/chunks/chunk-QG6C23IJ.js.map +7 -0
- package/dist/browser/chunks/chunk-SFNJRPBV.js +2 -0
- package/dist/browser/chunks/chunk-SFNJRPBV.js.map +7 -0
- package/dist/browser/component.js +1 -1
- package/dist/browser/component.js.map +1 -1
- package/dist/browser/index.js +1 -1
- package/dist/browser/index.js.map +4 -4
- package/dist/browser/jsx-jsx-dev-runtime.js +1 -1
- package/dist/browser/jsx-jsx-runtime.js +1 -1
- package/dist/browser/manifest.json +3 -2
- package/dist/browser/sdk.js +1 -1
- package/dist/component.js.map +1 -1
- package/dist/document/audio.d.ts +1 -1
- package/dist/document/audio.js +4 -4
- package/dist/document/audio.js.map +1 -1
- package/dist/document/builtins.d.ts.map +1 -1
- package/dist/document/builtins.js +8 -14
- package/dist/document/builtins.js.map +1 -1
- package/dist/document/command-traits.d.ts +1 -1
- package/dist/document/command-traits.js +13 -1
- 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.d.ts +2 -2
- package/dist/document/doc-index.d.ts.map +1 -1
- package/dist/document/doc-index.js.map +1 -1
- package/dist/document/expression/compile.d.ts.map +1 -1
- package/dist/document/expression/compile.js +8 -5
- package/dist/document/expression/compile.js.map +1 -1
- package/dist/document/expression/index.js.map +1 -1
- package/dist/document/expression/ops.js +1 -1
- package/dist/document/expression/ops.js.map +1 -1
- package/dist/document/expression/parse.d.ts.map +1 -1
- package/dist/document/expression/parse.js +15 -6
- package/dist/document/expression/parse.js.map +1 -1
- package/dist/document/expression/refs.d.ts +1 -1
- package/dist/document/expression/refs.js +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.d.ts.map +1 -1
- package/dist/document/expression/walk.js +2 -1
- package/dist/document/expression/walk.js.map +1 -1
- package/dist/document/index.d.ts +2 -0
- package/dist/document/index.d.ts.map +1 -1
- package/dist/document/index.js +2 -0
- package/dist/document/index.js.map +1 -1
- package/dist/document/node-decorator.js.map +1 -1
- package/dist/document/node-descriptor.d.ts +19 -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 +70 -0
- package/dist/document/placement.d.ts.map +1 -0
- package/dist/document/placement.js +83 -0
- package/dist/document/placement.js.map +1 -0
- package/dist/document/project.d.ts +2 -2
- package/dist/document/project.d.ts.map +1 -1
- package/dist/document/project.js.map +1 -1
- package/dist/document/registry.d.ts +17 -0
- package/dist/document/registry.d.ts.map +1 -1
- package/dist/document/registry.js +29 -2
- package/dist/document/registry.js.map +1 -1
- package/dist/document/timeline-patch.js.map +1 -1
- package/dist/document/timeline.d.ts +73 -18
- package/dist/document/timeline.d.ts.map +1 -1
- package/dist/document/timeline.js +192 -40
- package/dist/document/timeline.js.map +1 -1
- package/dist/document/types.d.ts +12 -12
- package/dist/document/types.d.ts.map +1 -1
- package/dist/document/types.js +2 -2
- package/dist/document/types.js.map +1 -1
- package/dist/document/validate.d.ts +2 -2
- package/dist/document/validate.d.ts.map +1 -1
- package/dist/document/validate.js +37 -31
- package/dist/document/validate.js.map +1 -1
- package/dist/document/withdraw.d.ts +28 -0
- package/dist/document/withdraw.d.ts.map +1 -0
- package/dist/document/withdraw.js +61 -0
- package/dist/document/withdraw.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/jsx/jsx-dev-runtime.js.map +1 -1
- package/dist/jsx/jsx-runtime.d.ts +9 -1
- package/dist/jsx/jsx-runtime.d.ts.map +1 -1
- package/dist/jsx/jsx-runtime.js +13 -3
- package/dist/jsx/jsx-runtime.js.map +1 -1
- package/dist/layout/bounds.d.ts +0 -1
- package/dist/layout/bounds.d.ts.map +1 -1
- package/dist/layout/bounds.js.map +1 -1
- package/dist/layout/constraints.js.map +1 -1
- package/dist/layout/flex.d.ts +4 -2
- package/dist/layout/flex.d.ts.map +1 -1
- package/dist/layout/flex.js +27 -11
- 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.d.ts +6 -0
- package/dist/layout/ops.d.ts.map +1 -1
- package/dist/layout/ops.js +6 -0
- package/dist/layout/ops.js.map +1 -1
- package/dist/layout/types.js.map +1 -1
- package/dist/nodes/2d/node-lifecycle.js.map +1 -1
- package/dist/nodes/2d/node-motion.js.map +1 -1
- package/dist/nodes/2d/node-render.d.ts +3 -3
- package/dist/nodes/2d/node-render.d.ts.map +1 -1
- package/dist/nodes/2d/node-render.js.map +1 -1
- package/dist/nodes/2d/node-transform.js.map +1 -1
- package/dist/nodes/2d/node2d.d.ts +115 -3
- package/dist/nodes/2d/node2d.d.ts.map +1 -1
- package/dist/nodes/2d/node2d.js +180 -28
- package/dist/nodes/2d/node2d.js.map +1 -1
- package/dist/nodes/2d/paint-node.d.ts +27 -0
- package/dist/nodes/2d/paint-node.d.ts.map +1 -1
- package/dist/nodes/2d/paint-node.js +42 -0
- package/dist/nodes/2d/paint-node.js.map +1 -1
- package/dist/nodes/audio/audio-bus.js.map +1 -1
- package/dist/nodes/audio/index.js.map +1 -1
- package/dist/nodes/audio/node-audio.js.map +1 -1
- package/dist/nodes/audio/sound-node.d.ts +2 -2
- package/dist/nodes/audio/sound-node.d.ts.map +1 -1
- package/dist/nodes/audio/sound-node.js +1 -1
- package/dist/nodes/audio/sound-node.js.map +1 -1
- package/dist/nodes/geometry/bounds-shape-node.d.ts +4 -4
- package/dist/nodes/geometry/bounds-shape-node.js +2 -2
- package/dist/nodes/geometry/bounds-shape-node.js.map +1 -1
- package/dist/nodes/geometry/box-path-node.d.ts +3 -3
- package/dist/nodes/geometry/box-path-node.js +2 -2
- package/dist/nodes/geometry/box-path-node.js.map +1 -1
- package/dist/nodes/geometry/ellipse-node.js.map +1 -1
- package/dist/nodes/geometry/group-bounds.d.ts +2 -2
- package/dist/nodes/geometry/group-bounds.d.ts.map +1 -1
- package/dist/nodes/geometry/group-bounds.js +1 -2
- package/dist/nodes/geometry/group-bounds.js.map +1 -1
- package/dist/nodes/geometry/path-node.d.ts.map +1 -1
- package/dist/nodes/geometry/path-node.js +6 -0
- package/dist/nodes/geometry/path-node.js.map +1 -1
- package/dist/nodes/geometry/polygon-node.js.map +1 -1
- package/dist/nodes/geometry/polygram-node.js.map +1 -1
- package/dist/nodes/geometry/rect-node.js.map +1 -1
- package/dist/nodes/geometry/shape-node.js.map +1 -1
- package/dist/nodes/geometry/shape-outline.d.ts +2 -2
- package/dist/nodes/geometry/shape-outline.d.ts.map +1 -1
- package/dist/nodes/geometry/shape-outline.js +2 -13
- package/dist/nodes/geometry/shape-outline.js.map +1 -1
- package/dist/nodes/index.d.ts +3 -8
- package/dist/nodes/index.d.ts.map +1 -1
- package/dist/nodes/index.js +3 -8
- package/dist/nodes/index.js.map +1 -1
- package/dist/nodes/layout/camera-node.d.ts +9 -0
- package/dist/nodes/layout/camera-node.d.ts.map +1 -1
- package/dist/nodes/layout/camera-node.js +38 -3
- package/dist/nodes/layout/camera-node.js.map +1 -1
- package/dist/nodes/layout/orbit-camera-node.d.ts +1 -1
- package/dist/nodes/layout/orbit-camera-node.js +1 -1
- package/dist/nodes/layout/orbit-camera-node.js.map +1 -1
- package/dist/nodes/layout/rotated-box.js.map +1 -1
- package/dist/nodes/media/video-node.d.ts.map +1 -1
- package/dist/nodes/media/video-node.js +2 -0
- package/dist/nodes/media/video-node.js.map +1 -1
- package/dist/nodes/node/declare-paints.js.map +1 -1
- package/dist/nodes/node/node-editor-state.js.map +1 -1
- package/dist/nodes/node/node-reactive.js.map +1 -1
- package/dist/nodes/node/node-time.d.ts +3 -3
- package/dist/nodes/node/node-time.d.ts.map +1 -1
- package/dist/nodes/node/node-time.js +1 -1
- package/dist/nodes/node/node-time.js.map +1 -1
- package/dist/nodes/node/node-walk.js.map +1 -1
- package/dist/nodes/node/node.d.ts +5 -3
- package/dist/nodes/node/node.d.ts.map +1 -1
- package/dist/nodes/node/node.js +44 -19
- package/dist/nodes/node/node.js.map +1 -1
- package/dist/nodes/node/text-defaults.d.ts +10 -12
- package/dist/nodes/node/text-defaults.d.ts.map +1 -1
- package/dist/nodes/node/text-defaults.js +10 -12
- package/dist/nodes/node/text-defaults.js.map +1 -1
- package/dist/nodes/{scene → root}/canvas2d-node.d.ts +2 -2
- package/dist/nodes/root/canvas2d-node.d.ts.map +1 -0
- package/dist/nodes/{scene → root}/canvas2d-node.js +2 -2
- package/dist/nodes/root/canvas2d-node.js.map +1 -0
- package/dist/nodes/root/provider-node.d.ts.map +1 -0
- package/dist/nodes/root/provider-node.js.map +1 -0
- package/dist/nodes/root/theme-provider-node.d.ts.map +1 -0
- package/dist/nodes/root/theme-provider-node.js.map +1 -0
- package/dist/nodes/text/default-text-style-node.d.ts +5 -2
- package/dist/nodes/text/default-text-style-node.d.ts.map +1 -1
- package/dist/nodes/text/default-text-style-node.js +10 -4
- package/dist/nodes/text/default-text-style-node.js.map +1 -1
- package/dist/nodes/text/number-format.d.ts +1 -1
- package/dist/nodes/text/number-format.js +1 -1
- package/dist/nodes/text/number-format.js.map +1 -1
- package/dist/nodes/text/number-node.js.map +1 -1
- package/dist/nodes/text/number-pattern.js.map +1 -1
- package/dist/nodes/text/richtext-node.js +1 -1
- package/dist/nodes/text/richtext-node.js.map +1 -1
- package/dist/nodes/text/text-base.d.ts.map +1 -1
- package/dist/nodes/text/text-base.js +1 -1
- package/dist/nodes/text/text-base.js.map +1 -1
- package/dist/nodes/text/text-node.js.map +1 -1
- package/dist/nodes/text/text-selection.js.map +1 -1
- package/dist/nodes/three/camera-nodes.d.ts +21 -3
- package/dist/nodes/three/camera-nodes.d.ts.map +1 -1
- package/dist/nodes/three/camera-nodes.js +42 -1
- package/dist/nodes/three/camera-nodes.js.map +1 -1
- package/dist/nodes/three/canvas3d-node.d.ts +29 -6
- package/dist/nodes/three/canvas3d-node.d.ts.map +1 -1
- package/dist/nodes/three/canvas3d-node.js +44 -2
- package/dist/nodes/three/canvas3d-node.js.map +1 -1
- package/dist/nodes/three/drawable-nodes.d.ts +25 -11
- package/dist/nodes/three/drawable-nodes.d.ts.map +1 -1
- package/dist/nodes/three/drawable-nodes.js +43 -13
- package/dist/nodes/three/drawable-nodes.js.map +1 -1
- package/dist/nodes/three/environment-nodes.d.ts +9 -3
- package/dist/nodes/three/environment-nodes.d.ts.map +1 -1
- package/dist/nodes/three/environment-nodes.js.map +1 -1
- package/dist/nodes/three/geometry-nodes.d.ts +2 -2
- package/dist/nodes/three/geometry-nodes.js +2 -2
- package/dist/nodes/three/geometry-nodes.js.map +1 -1
- package/dist/nodes/three/grid-geometry3d.js.map +1 -1
- package/dist/nodes/three/group3d.js.map +1 -1
- package/dist/nodes/three/light-nodes.d.ts.map +1 -1
- package/dist/nodes/three/light-nodes.js +3 -3
- package/dist/nodes/three/light-nodes.js.map +1 -1
- package/dist/nodes/three/mesh3d.js.map +1 -1
- package/dist/nodes/three/node3d.d.ts +48 -0
- package/dist/nodes/three/node3d.d.ts.map +1 -1
- package/dist/nodes/three/node3d.js +53 -3
- package/dist/nodes/three/node3d.js.map +1 -1
- package/dist/platform/audio-sink.d.ts +2 -2
- package/dist/platform/audio-sink.d.ts.map +1 -1
- package/dist/platform/audio-sink.js.map +1 -1
- package/dist/platform/exporter.d.ts +13 -8
- package/dist/platform/exporter.d.ts.map +1 -1
- package/dist/platform/exporter.js.map +1 -1
- package/dist/platform/index.d.ts +1 -1
- package/dist/platform/index.d.ts.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.d.ts +12 -6
- package/dist/platform/storage-adapter.d.ts.map +1 -1
- package/dist/platform/storage-adapter.js +4 -0
- package/dist/platform/storage-adapter.js.map +1 -1
- package/dist/platform/ticker.d.ts +6 -0
- package/dist/platform/ticker.d.ts.map +1 -1
- package/dist/platform/ticker.js +6 -0
- 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.d.ts +3 -3
- package/dist/project/tree.d.ts.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 +17 -0
- package/dist/renamed-scene-names.d.ts.map +1 -0
- package/dist/renamed-scene-names.js +9 -0
- package/dist/renamed-scene-names.js.map +1 -0
- package/dist/render/canvas-render-context2d.d.ts +2 -2
- package/dist/render/canvas-render-context2d.d.ts.map +1 -1
- package/dist/render/canvas-render-context2d.js.map +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/latex.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.d.ts +12 -0
- package/dist/render/descriptors/shape.d.ts.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.d.ts +2 -2
- package/dist/render/descriptors/transform.d.ts.map +1 -1
- package/dist/render/descriptors/transform.js.map +1 -1
- package/dist/render/graphics2d.d.ts +3 -3
- package/dist/render/graphics2d.d.ts.map +1 -1
- package/dist/render/graphics2d.js +1 -1
- package/dist/render/graphics2d.js.map +1 -1
- 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 +2 -2
- package/dist/render/render-context2d.d.ts.map +1 -1
- package/dist/render/render-context2d.js.map +1 -1
- 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.d.ts.map +1 -1
- package/dist/render3d/bounds3d.js +4 -2
- package/dist/render3d/bounds3d.js.map +1 -1
- package/dist/render3d/builders.js.map +1 -1
- package/dist/render3d/camera.d.ts +6 -0
- package/dist/render3d/camera.d.ts.map +1 -1
- package/dist/render3d/camera.js +5 -3
- package/dist/render3d/camera.js.map +1 -1
- package/dist/render3d/fill3d.d.ts +2 -9
- package/dist/render3d/fill3d.d.ts.map +1 -1
- package/dist/render3d/fill3d.js +2 -13
- package/dist/render3d/fill3d.js.map +1 -1
- package/dist/render3d/geometry.d.ts +8 -1
- package/dist/render3d/geometry.d.ts.map +1 -1
- package/dist/render3d/geometry.js.map +1 -1
- package/dist/render3d/graphics3d.d.ts +8 -4
- package/dist/render3d/graphics3d.d.ts.map +1 -1
- package/dist/render3d/graphics3d.js +18 -10
- package/dist/render3d/graphics3d.js.map +1 -1
- package/dist/render3d/index.d.ts +1 -1
- package/dist/render3d/index.js +1 -1
- package/dist/render3d/index.js.map +1 -1
- package/dist/render3d/inert.d.ts +14 -0
- package/dist/render3d/inert.d.ts.map +1 -0
- package/dist/render3d/inert.js +62 -0
- package/dist/render3d/inert.js.map +1 -0
- package/dist/render3d/light.js.map +1 -1
- package/dist/render3d/material.d.ts +10 -5
- package/dist/render3d/material.d.ts.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.d.ts +23 -4
- package/dist/render3d/scene-settings.d.ts.map +1 -1
- package/dist/render3d/scene-settings.js.map +1 -1
- package/dist/render3d/scene3d.d.ts +11 -0
- package/dist/render3d/scene3d.d.ts.map +1 -1
- package/dist/render3d/scene3d.js +39 -6
- package/dist/render3d/scene3d.js.map +1 -1
- package/dist/render3d/segments.js.map +1 -1
- package/dist/render3d/texture.d.ts +9 -0
- package/dist/render3d/texture.d.ts.map +1 -1
- package/dist/render3d/texture.js +13 -0
- package/dist/render3d/texture.js.map +1 -1
- package/dist/render3d/tracking.js.map +1 -1
- package/dist/render3d/transform.d.ts +1 -1
- package/dist/render3d/transform.js.map +1 -1
- package/dist/render3d/vector3.d.ts +18 -1
- package/dist/render3d/vector3.d.ts.map +1 -1
- package/dist/render3d/vector3.js +27 -0
- package/dist/render3d/vector3.js.map +1 -1
- package/dist/render3d/walk.d.ts +1 -1
- package/dist/render3d/walk.d.ts.map +1 -1
- package/dist/render3d/walk.js +5 -1
- package/dist/render3d/walk.js.map +1 -1
- package/dist/runtime/asset-refine.js.map +1 -1
- package/dist/runtime/asset-timeline.js.map +1 -1
- 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 +5 -3
- package/dist/runtime/clip-instance.d.ts.map +1 -1
- package/dist/runtime/clip-instance.js +10 -6
- package/dist/runtime/clip-instance.js.map +1 -1
- package/dist/runtime/clip-store.d.ts +9 -0
- package/dist/runtime/clip-store.d.ts.map +1 -1
- package/dist/runtime/clip-store.js +19 -0
- package/dist/runtime/clip-store.js.map +1 -1
- package/dist/runtime/engine.d.ts +5 -0
- package/dist/runtime/engine.d.ts.map +1 -1
- package/dist/runtime/engine.js +2 -0
- package/dist/runtime/engine.js.map +1 -1
- package/dist/runtime/frame-time.d.ts +31 -0
- package/dist/runtime/frame-time.d.ts.map +1 -0
- package/dist/runtime/frame-time.js +29 -0
- package/dist/runtime/frame-time.js.map +1 -0
- package/dist/runtime/index.d.ts +1 -0
- package/dist/runtime/index.d.ts.map +1 -1
- package/dist/runtime/index.js +1 -0
- package/dist/runtime/index.js.map +1 -1
- package/dist/runtime/node-picking.d.ts +44 -3
- package/dist/runtime/node-picking.d.ts.map +1 -1
- package/dist/runtime/node-picking.js +118 -3
- package/dist/runtime/node-picking.js.map +1 -1
- package/dist/runtime/node-picking3d.d.ts +2 -1
- package/dist/runtime/node-picking3d.d.ts.map +1 -1
- package/dist/runtime/node-picking3d.js +5 -2
- package/dist/runtime/node-picking3d.js.map +1 -1
- package/dist/runtime/placement.d.ts.map +1 -1
- package/dist/runtime/placement.js +4 -5
- package/dist/runtime/placement.js.map +1 -1
- package/dist/runtime/playback-controller.d.ts +31 -2
- package/dist/runtime/playback-controller.d.ts.map +1 -1
- package/dist/runtime/playback-controller.js +63 -6
- 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 +9 -7
- package/dist/runtime/session.d.ts.map +1 -1
- package/dist/runtime/session.js +12 -4
- package/dist/runtime/session.js.map +1 -1
- package/dist/runtime/settle.js.map +1 -1
- package/dist/runtime/state-evaluator.d.ts +1 -1
- package/dist/runtime/state-evaluator.d.ts.map +1 -1
- package/dist/runtime/state-evaluator.js +4 -3
- package/dist/runtime/state-evaluator.js.map +1 -1
- package/dist/runtime/text-geometry.js.map +1 -1
- package/dist/sdk/index.d.ts +19 -15
- package/dist/sdk/index.d.ts.map +1 -1
- package/dist/sdk/index.js +11 -6
- package/dist/sdk/index.js.map +1 -1
- package/dist/tween/command-decorator.d.ts +2 -0
- package/dist/tween/command-decorator.d.ts.map +1 -1
- package/dist/tween/command-decorator.js.map +1 -1
- package/dist/tween/command.js.map +1 -1
- package/dist/tween/ease/constants.d.ts.map +1 -1
- package/dist/tween/ease/constants.js +8 -5
- package/dist/tween/ease/constants.js.map +1 -1
- package/dist/tween/ease/curve.d.ts.map +1 -1
- package/dist/tween/ease/curve.js +4 -3
- package/dist/tween/ease/curve.js.map +1 -1
- package/dist/tween/ease/describe.d.ts +15 -0
- package/dist/tween/ease/describe.d.ts.map +1 -0
- package/dist/tween/ease/describe.js +37 -0
- package/dist/tween/ease/describe.js.map +1 -0
- package/dist/tween/ease/type.js.map +1 -1
- 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.d.ts +3 -3
- package/dist/tween/prepare.js +3 -3
- package/dist/tween/prepare.js.map +1 -1
- package/dist/tween/seekable.d.ts +1 -1
- package/dist/tween/seekable.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.d.ts +1 -1
- package/dist/util/metrics.js +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 -1
- package/dist/attributes/shape/effects/implementations/displace.d.ts +0 -48
- package/dist/attributes/shape/effects/implementations/displace.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/displace.js +0 -30
- package/dist/attributes/shape/effects/implementations/displace.js.map +0 -1
- package/dist/attributes/shape/effects/implementations/god-rays.d.ts +0 -28
- package/dist/attributes/shape/effects/implementations/god-rays.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/god-rays.js +0 -26
- package/dist/attributes/shape/effects/implementations/god-rays.js.map +0 -1
- package/dist/attributes/shape/effects/implementations/texture.d.ts +0 -28
- package/dist/attributes/shape/effects/implementations/texture.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/texture.js +0 -25
- package/dist/attributes/shape/effects/implementations/texture.js.map +0 -1
- package/dist/attributes/shape/effects/implementations/trails.d.ts +0 -41
- package/dist/attributes/shape/effects/implementations/trails.d.ts.map +0 -1
- package/dist/attributes/shape/effects/implementations/trails.js +0 -22
- package/dist/attributes/shape/effects/implementations/trails.js.map +0 -1
- package/dist/browser/chunks/chunk-2T3HXSC2.js +0 -2
- package/dist/browser/chunks/chunk-2T3HXSC2.js.map +0 -7
- package/dist/browser/chunks/chunk-KJXGRHOL.js +0 -3
- package/dist/browser/chunks/chunk-KJXGRHOL.js.map +0 -7
- package/dist/browser/chunks/chunk-TGDX2SS2.js +0 -18
- package/dist/browser/chunks/chunk-TGDX2SS2.js.map +0 -7
- package/dist/nodes/geometry/dot-grid-node.d.ts +0 -105
- package/dist/nodes/geometry/dot-grid-node.d.ts.map +0 -1
- package/dist/nodes/geometry/dot-grid-node.js +0 -142
- package/dist/nodes/geometry/dot-grid-node.js.map +0 -1
- package/dist/nodes/geometry/grid-lines.d.ts +0 -101
- package/dist/nodes/geometry/grid-lines.d.ts.map +0 -1
- package/dist/nodes/geometry/grid-lines.js +0 -128
- package/dist/nodes/geometry/grid-lines.js.map +0 -1
- package/dist/nodes/geometry/grid-pattern-node.d.ts +0 -58
- package/dist/nodes/geometry/grid-pattern-node.d.ts.map +0 -1
- package/dist/nodes/geometry/grid-pattern-node.js +0 -172
- package/dist/nodes/geometry/grid-pattern-node.js.map +0 -1
- package/dist/nodes/geometry/line-grid-node.d.ts +0 -62
- package/dist/nodes/geometry/line-grid-node.d.ts.map +0 -1
- package/dist/nodes/geometry/line-grid-node.js +0 -127
- package/dist/nodes/geometry/line-grid-node.js.map +0 -1
- package/dist/nodes/geometry/line-node.d.ts +0 -58
- package/dist/nodes/geometry/line-node.d.ts.map +0 -1
- package/dist/nodes/geometry/line-node.js +0 -123
- package/dist/nodes/geometry/line-node.js.map +0 -1
- package/dist/nodes/geometry/viewport-pattern-node.d.ts +0 -39
- package/dist/nodes/geometry/viewport-pattern-node.d.ts.map +0 -1
- package/dist/nodes/geometry/viewport-pattern-node.js +0 -79
- package/dist/nodes/geometry/viewport-pattern-node.js.map +0 -1
- package/dist/nodes/scene/canvas2d-node.d.ts.map +0 -1
- package/dist/nodes/scene/canvas2d-node.js.map +0 -1
- package/dist/nodes/scene/provider-node.d.ts.map +0 -1
- package/dist/nodes/scene/provider-node.js.map +0 -1
- package/dist/nodes/scene/theme-provider-node.d.ts.map +0 -1
- package/dist/nodes/scene/theme-provider-node.js.map +0 -1
- /package/dist/nodes/{scene → root}/provider-node.d.ts +0 -0
- /package/dist/nodes/{scene → root}/provider-node.js +0 -0
- /package/dist/nodes/{scene → root}/theme-provider-node.d.ts +0 -0
- /package/dist/nodes/{scene → root}/theme-provider-node.js +0 -0
package/dist/render3d/fill3d.js
CHANGED
|
@@ -5,6 +5,8 @@ import { lerpColor } from "../attributes/shape/fill/lerp.js";
|
|
|
5
5
|
// `render/graphics2d` reaches only the *effects* chain at runtime, never back
|
|
6
6
|
// into `render3d` — see the note on `SurfaceSource3D`.
|
|
7
7
|
import { Graphics2D } from "../render/graphics2d.js";
|
|
8
|
+
import { looksLikeAssetPath } from "./texture.js";
|
|
9
|
+
export { looksLikeAssetPath };
|
|
8
10
|
const DEFAULT_SIZE = 512;
|
|
9
11
|
/**
|
|
10
12
|
* Resolve a {@link Fill3D} into the material fields it describes.
|
|
@@ -93,19 +95,6 @@ function rasterized(fill, options) {
|
|
|
93
95
|
identity: `fill:${fillIdentity(fill)}:${width}x${height}`,
|
|
94
96
|
};
|
|
95
97
|
}
|
|
96
|
-
/**
|
|
97
|
-
* True for a string that names an asset rather than a colour.
|
|
98
|
-
*
|
|
99
|
-
* Leading `/` or `.` is a path by construction; otherwise the extension decides.
|
|
100
|
-
* A colour never matches either, and a bare name like `"wood"` is a colour —
|
|
101
|
-
* which is right, since an asset reference without a path or extension is not
|
|
102
|
-
* something the manifest could resolve either.
|
|
103
|
-
*/
|
|
104
|
-
export function looksLikeAssetPath(value) {
|
|
105
|
-
return value.startsWith("/")
|
|
106
|
-
|| value.startsWith(".")
|
|
107
|
-
|| /\.(png|jpe?g|webp|avif|svg|ktx2?|hdr|exr|mp4|webm|mov)$/i.test(value);
|
|
108
|
-
}
|
|
109
98
|
/** True for a `Texture3D` descriptor object (not a source value). */
|
|
110
99
|
function isTextureDescriptor(value) {
|
|
111
100
|
return "src" in value || "data" in value || ("source" in value && "width" in value);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fill3d.js","sourceRoot":"","sources":["../../src/render3d/fill3d.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Color, type NormalizedColor, parseColor } from \"@/attributes/shape/fill/color/parser\";\nimport { lerpColor } from \"@/attributes/shape/fill/lerp\";\nimport type { Fill } from \"@/attributes/shape/fill/chain\";\n// A value import, unlike the type-only ones in `texture.ts`: building the rect a\n// fill chain is painted into needs the recorder itself. Safe because\n// `render/graphics2d` reaches only the *effects* chain at runtime, never back\n// into `render3d` — see the note on `SurfaceSource3D`.\nimport { Graphics2D } from \"@/render/graphics2d\";\nimport type { SurfaceSource3D, Texture3D } from \"./texture\";\n\n/**\n * What a surface is made of.\n *\n * The same value a 2D `fill` takes, so a mesh and a rect are described with one\n * vocabulary: a colour, a gradient, an image, a video, a noise field, a whole\n * stack of blended layers — and, because a `Node2D` subtree and a built\n * `Graphics2D` are fills too, any 2D content at all.\n *\n * This is the 3D counterpart of Spline's material *stack*, built on the fill\n * chain that already exists rather than on a second set of layer types. What it\n * replaces is a flat `color` plus five separate texture slots (`map`,\n * `emissiveMap`, `alphaMap`, `envMap`, `lightMap`), each of which was a fill\n * wearing a different name.\n */\nexport type Fill3D = Color | Fill | Texture3D | SurfaceSource3D;\n\n/** What a {@link Fill3D} contributes to a material descriptor. */\nexport interface ResolvedFill3D {\n color?: Color;\n map?: Texture3D;\n}\n\n/** Sizing for the buffer a rich fill is rasterized into. */\nexport interface Fill3DOptions {\n /** Default 512. */\n width?: number;\n /** Default 512. */\n height?: number;\n}\n\nconst DEFAULT_SIZE = 512;\n\n/**\n * Resolve a {@link Fill3D} into the material fields it describes.\n *\n * Three outcomes, and which one applies is decided by what the fill *is* rather\n * than by an author picking a slot:\n *\n * - **A colour** stays a colour. `fill=\"tomato\"` writes `material.color`, costs\n * nothing, and is by far the common case — so it must not be the one that\n * allocates a texture.\n * - **A texture** (an asset path, or any `Texture3D` descriptor) becomes `map`.\n * - **Anything richer** — a gradient, a layer stack, a `Node2D` subtree, a built\n * `Graphics2D`, a nested `Scene3D` — is painted into an offscreen buffer and\n * bound as `map`, through exactly the `Tex.surface` machinery that already\n * existed for putting 2D content on geometry.\n *\n * That last arm is what makes the 2D and 3D fill vocabularies genuinely one\n * thing: `Fills.canvas3D(scene)` inside a chain renders 3D into a layer of a\n * material on a mesh, with no new code path, because the 2D fill renderer was\n * already able to do it.\n */\nexport function resolveFill3D(\n fill: Fill3D | undefined,\n options: Fill3DOptions = {},\n): ResolvedFill3D {\n if (fill === undefined || fill === null) return {};\n\n if (typeof fill === \"string\") {\n // A bare string is ambiguous between a colour and an asset path, and both\n // are things authors write. Resolved the way the material handler already\n // resolved a `color` that looked like a file — so this is the existing\n // rule moved somewhere it can be stated once.\n return looksLikeAssetPath(fill) ? { map: fill } : { color: fill };\n }\n\n if (Array.isArray(fill)) {\n // A `Color` is also an array — of numbers. A fill chain is an array of\n // layers, which are strings or objects.\n if (fill.every((entry) => typeof entry === \"number\")) {\n return { color: fill as unknown as Color };\n }\n return { map: rasterized(fill as Fill, options) };\n }\n\n if (typeof fill === \"object\") {\n if (isSurfaceSourceValue(fill)) return { map: surfaceFor(fill as SurfaceSource3D, options) };\n if (isTextureDescriptor(fill)) return { map: fill as Texture3D };\n if (isSolidLayer(fill)) return { color: (fill as { color: Color }).color };\n }\n\n return { map: rasterized(fill as Fill, options) };\n}\n\n/**\n * A surface texture painting `source` directly.\n *\n * Identity comes from the source object, which the `Tex.surface` contract already\n * requires to be hoisted — so nothing has to be written by hand and a source that\n * goes out of scope stops being cached.\n */\nfunction surfaceFor(source: SurfaceSource3D, options: Fill3DOptions): Texture3D {\n return {\n source,\n width: options.width ?? DEFAULT_SIZE,\n height: options.height ?? DEFAULT_SIZE,\n };\n}\n\n/**\n * A surface texture painting a fill chain into a rect that fills the buffer.\n *\n * Marked `static` and given a derived identity, because a fill chain describes\n * the *same* pixels every frame unless one of its own values moved. Without both\n * of those a gradient on a cube would re-rasterize a 512² offscreen buffer and\n * re-upload it sixty times a second to produce an identical image — which is\n * exactly the trap that makes \"just render it to a texture\" a bad idea in\n * general, and is worth the small amount of bookkeeping to avoid.\n *\n * A chain holding something genuinely live (a video layer, a `Fills.canvas3D`) is\n * still re-rasterized: those carry object identity, which `fillIdentity` folds in\n * and which changes when the content does.\n */\nfunction rasterized(fill: Fill, options: Fill3DOptions): Texture3D {\n const width = options.width ?? DEFAULT_SIZE;\n const height = options.height ?? DEFAULT_SIZE;\n return {\n source: new Graphics2D().rect({ width, height }).fill(fill),\n width,\n height,\n static: true,\n identity: `fill:${fillIdentity(fill)}:${width}x${height}`,\n };\n}\n\n/**\n * True for a string that names an asset rather than a colour.\n *\n * Leading `/` or `.` is a path by construction; otherwise the extension decides.\n * A colour never matches either, and a bare name like `\"wood\"` is a colour —\n * which is right, since an asset reference without a path or extension is not\n * something the manifest could resolve either.\n */\nexport function looksLikeAssetPath(value: string): boolean {\n return value.startsWith(\"/\")\n || value.startsWith(\".\")\n || /\\.(png|jpe?g|webp|avif|svg|ktx2?|hdr|exr|mp4|webm|mov)$/i.test(value);\n}\n\n/** True for a `Texture3D` descriptor object (not a source value). */\nfunction isTextureDescriptor(value: object): boolean {\n return \"src\" in value || \"data\" in value || (\"source\" in value && \"width\" in value);\n}\n\n/**\n * True for a value that is 2D content to be painted, rather than a descriptor.\n *\n * Structural, like `resolveSurfaceSource`, and for the same reason: an\n * `instanceof` here would need value imports of `Node2D` and close a real module\n * cycle. A `Scene3D` also exposes `ops()`, so it is excluded explicitly — it is a\n * fill *layer* (`Fills.canvas3D`) rather than a 2D source, and routing it through\n * the chain arm is what gets it composited with the rest of the stack.\n */\nfunction isSurfaceSourceValue(value: object): boolean {\n const bag = value as Record<string, unknown>;\n if (typeof bag.cameraDescriptor === \"function\") return false;\n if (typeof bag.ops === \"function\") return true;\n return typeof bag.id === \"string\" && typeof bag.attach === \"function\";\n}\n\n/** True for a single solid-colour fill layer, which needs no texture. */\nfunction isSolidLayer(value: object): boolean {\n const bag = value as Record<string, unknown>;\n if (bag.type !== \"solid\" || bag.color === undefined) return false;\n // Anything beyond the colour — a per-layer opacity, a blend mode, a\n // reference space — is a composite the colour slot cannot express.\n return bag.opacity === undefined && bag.blend === undefined && bag.space === undefined;\n}\n\n/**\n * Interpolate two fills.\n *\n * Colours interpolate — that is the overwhelmingly common tween and it must not\n * snap. Anything else holds the start value and swaps at the end, because there\n * is no meaningful halfway between a gradient and a photograph; cross-fading two\n * surfaces is a *stack* (`fill={[a, b]}` with the second layer's opacity tweened),\n * which is how it is expressed in 2D too.\n *\n * The colour test is deliberately cheap and allocation-free: resolving a rich\n * fill builds a `Graphics2D` and a texture descriptor, and doing that twice per\n * frame for a tween that is going to snap anyway would be pure waste.\n */\nexport function lerpFill3D(from: Fill3D, to: Fill3D, t: number): Fill3D {\n const start = asPlainColor(from);\n const end = asPlainColor(to);\n if (start !== null && end !== null) {\n return lerpColor(normalize(start), normalize(end), t) as unknown as Fill3D;\n }\n return t < 1 ? from : to;\n}\n\n/** The colour a fill *is*, or `null` when it is anything richer. No allocation. */\nfunction asPlainColor(fill: Fill3D | undefined): Color | null {\n if (fill === undefined || fill === null) return null;\n if (typeof fill === \"string\") return looksLikeAssetPath(fill) ? null : fill;\n if (Array.isArray(fill)) {\n return fill.every((entry) => typeof entry === \"number\") ? (fill as unknown as Color) : null;\n }\n if (typeof fill === \"object\" && isSolidLayer(fill)) return (fill as { color: Color }).color;\n return null;\n}\n\nfunction normalize(color: Color): NormalizedColor {\n return Array.isArray(color) ? (color as NormalizedColor) : parseColor(color);\n}\n\nconst objectIds = new WeakMap<object, string>();\nlet objectCounter = 0;\n\n/**\n * A stable key for a fill value.\n *\n * Plain data is walked and sorted; anything with a prototype of its own — a\n * `Scene3D`, a `Graphics2D`, a video source — is keyed by object identity, which\n * is both cheaper than serialising it and the honest answer, since two different\n * instances describe two different things whatever their fields say. A\n * `FillChain` is unwrapped to its list first, so building one inline still\n * produces the same key for the same layers.\n */\nfunction fillIdentity(value: unknown): string {\n if (value === null || typeof value !== \"object\") return String(value);\n if (Array.isArray(value)) return `[${value.map(fillIdentity).join(\",\")}]`;\n\n const list = (value as { list?: unknown }).list;\n if (Array.isArray(list)) return fillIdentity(list);\n\n const prototype = Object.getPrototypeOf(value);\n if (prototype !== Object.prototype && prototype !== null) {\n let id = objectIds.get(value);\n if (id === undefined) {\n id = `@${objectCounter++}`;\n objectIds.set(value, id);\n }\n return id;\n }\n\n const bag = value as Record<string, unknown>;\n return `{${Object.keys(bag).sort().map((key) => `${key}:${fillIdentity(bag[key])}`).join(\",\")}}`;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"fill3d.js","sourceRoot":"","sources":["../../src/render3d/fill3d.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Color, type NormalizedColor, parseColor } from \"@/attributes/shape/fill/color/parser\";\r\nimport { lerpColor } from \"@/attributes/shape/fill/lerp\";\r\nimport type { Fill } from \"@/attributes/shape/fill/chain\";\r\n// A value import, unlike the type-only ones in `texture.ts`: building the rect a\r\n// fill chain is painted into needs the recorder itself. Safe because\r\n// `render/graphics2d` reaches only the *effects* chain at runtime, never back\r\n// into `render3d` — see the note on `SurfaceSource3D`.\r\nimport { Graphics2D } from \"@/render/graphics2d\";\r\nimport { looksLikeAssetPath } from \"./texture\";\r\nimport type { SurfaceSource3D, Texture3D } from \"./texture\";\r\n\r\nexport { looksLikeAssetPath };\r\n\r\n/**\r\n * What a surface is made of.\r\n *\r\n * The same value a 2D `fill` takes, so a mesh and a rect are described with one\r\n * vocabulary: a colour, a gradient, an image, a video, a noise field, a whole\r\n * stack of blended layers — and, because a `Node2D` subtree and a built\r\n * `Graphics2D` are fills too, any 2D content at all.\r\n *\r\n * This is the 3D counterpart of Spline's material *stack*, built on the fill\r\n * chain that already exists rather than on a second set of layer types. What it\r\n * replaces is a flat `color` plus five separate texture slots (`map`,\r\n * `emissiveMap`, `alphaMap`, `envMap`, `lightMap`), each of which was a fill\r\n * wearing a different name.\r\n */\r\nexport type Fill3D = Color | Fill | Texture3D | SurfaceSource3D;\r\n\r\n/** What a {@link Fill3D} contributes to a material descriptor. */\r\nexport interface ResolvedFill3D {\r\n color?: Color;\r\n map?: Texture3D;\r\n}\r\n\r\n/** Sizing for the buffer a rich fill is rasterized into. */\r\nexport interface Fill3DOptions {\r\n /** Default 512. */\r\n width?: number;\r\n /** Default 512. */\r\n height?: number;\r\n}\r\n\r\nconst DEFAULT_SIZE = 512;\r\n\r\n/**\r\n * Resolve a {@link Fill3D} into the material fields it describes.\r\n *\r\n * Three outcomes, and which one applies is decided by what the fill *is* rather\r\n * than by an author picking a slot:\r\n *\r\n * - **A colour** stays a colour. `fill=\"tomato\"` writes `material.color`, costs\r\n * nothing, and is by far the common case — so it must not be the one that\r\n * allocates a texture.\r\n * - **A texture** (an asset path, or any `Texture3D` descriptor) becomes `map`.\r\n * - **Anything richer** — a gradient, a layer stack, a `Node2D` subtree, a built\r\n * `Graphics2D`, a nested `Scene3D` — is painted into an offscreen buffer and\r\n * bound as `map`, through exactly the `Tex.surface` machinery that already\r\n * existed for putting 2D content on geometry.\r\n *\r\n * That last arm is what makes the 2D and 3D fill vocabularies genuinely one\r\n * thing: `Fills.canvas3D(scene)` inside a chain renders 3D into a layer of a\r\n * material on a mesh, with no new code path, because the 2D fill renderer was\r\n * already able to do it.\r\n */\r\nexport function resolveFill3D(\r\n fill: Fill3D | undefined,\r\n options: Fill3DOptions = {},\r\n): ResolvedFill3D {\r\n if (fill === undefined || fill === null) return {};\r\n\r\n if (typeof fill === \"string\") {\r\n // A bare string is ambiguous between a colour and an asset path, and both\r\n // are things authors write. Resolved the way the material handler already\r\n // resolved a `color` that looked like a file — so this is the existing\r\n // rule moved somewhere it can be stated once.\r\n return looksLikeAssetPath(fill) ? { map: fill } : { color: fill };\r\n }\r\n\r\n if (Array.isArray(fill)) {\r\n // A `Color` is also an array — of numbers. A fill chain is an array of\r\n // layers, which are strings or objects.\r\n if (fill.every((entry) => typeof entry === \"number\")) {\r\n return { color: fill as unknown as Color };\r\n }\r\n return { map: rasterized(fill as Fill, options) };\r\n }\r\n\r\n if (typeof fill === \"object\") {\r\n if (isSurfaceSourceValue(fill)) return { map: surfaceFor(fill as SurfaceSource3D, options) };\r\n if (isTextureDescriptor(fill)) return { map: fill as Texture3D };\r\n if (isSolidLayer(fill)) return { color: (fill as { color: Color }).color };\r\n }\r\n\r\n return { map: rasterized(fill as Fill, options) };\r\n}\r\n\r\n/**\r\n * A surface texture painting `source` directly.\r\n *\r\n * Identity comes from the source object, which the `Tex.surface` contract already\r\n * requires to be hoisted — so nothing has to be written by hand and a source that\r\n * goes out of scope stops being cached.\r\n */\r\nfunction surfaceFor(source: SurfaceSource3D, options: Fill3DOptions): Texture3D {\r\n return {\r\n source,\r\n width: options.width ?? DEFAULT_SIZE,\r\n height: options.height ?? DEFAULT_SIZE,\r\n };\r\n}\r\n\r\n/**\r\n * A surface texture painting a fill chain into a rect that fills the buffer.\r\n *\r\n * Marked `static` and given a derived identity, because a fill chain describes\r\n * the *same* pixels every frame unless one of its own values moved. Without both\r\n * of those a gradient on a cube would re-rasterize a 512² offscreen buffer and\r\n * re-upload it sixty times a second to produce an identical image — which is\r\n * exactly the trap that makes \"just render it to a texture\" a bad idea in\r\n * general, and is worth the small amount of bookkeeping to avoid.\r\n *\r\n * A chain holding something genuinely live (a video layer, a `Fills.canvas3D`) is\r\n * still re-rasterized: those carry object identity, which `fillIdentity` folds in\r\n * and which changes when the content does.\r\n */\r\nfunction rasterized(fill: Fill, options: Fill3DOptions): Texture3D {\r\n const width = options.width ?? DEFAULT_SIZE;\r\n const height = options.height ?? DEFAULT_SIZE;\r\n return {\r\n source: new Graphics2D().rect({ width, height }).fill(fill),\r\n width,\r\n height,\r\n static: true,\r\n identity: `fill:${fillIdentity(fill)}:${width}x${height}`,\r\n };\r\n}\r\n\r\n/** True for a `Texture3D` descriptor object (not a source value). */\r\nfunction isTextureDescriptor(value: object): boolean {\r\n return \"src\" in value || \"data\" in value || (\"source\" in value && \"width\" in value);\r\n}\r\n\r\n/**\r\n * True for a value that is 2D content to be painted, rather than a descriptor.\r\n *\r\n * Structural, like `resolveSurfaceSource`, and for the same reason: an\r\n * `instanceof` here would need value imports of `Node2D` and close a real module\r\n * cycle. A `Scene3D` also exposes `ops()`, so it is excluded explicitly — it is a\r\n * fill *layer* (`Fills.canvas3D`) rather than a 2D source, and routing it through\r\n * the chain arm is what gets it composited with the rest of the stack.\r\n */\r\nfunction isSurfaceSourceValue(value: object): boolean {\r\n const bag = value as Record<string, unknown>;\r\n if (typeof bag.cameraDescriptor === \"function\") return false;\r\n if (typeof bag.ops === \"function\") return true;\r\n return typeof bag.id === \"string\" && typeof bag.attach === \"function\";\r\n}\r\n\r\n/** True for a single solid-colour fill layer, which needs no texture. */\r\nfunction isSolidLayer(value: object): boolean {\r\n const bag = value as Record<string, unknown>;\r\n if (bag.type !== \"solid\" || bag.color === undefined) return false;\r\n // Anything beyond the colour — a per-layer opacity, a blend mode, a\r\n // reference space — is a composite the colour slot cannot express.\r\n return bag.opacity === undefined && bag.blend === undefined && bag.space === undefined;\r\n}\r\n\r\n/**\r\n * Interpolate two fills.\r\n *\r\n * Colours interpolate — that is the overwhelmingly common tween and it must not\r\n * snap. Anything else holds the start value and swaps at the end, because there\r\n * is no meaningful halfway between a gradient and a photograph; cross-fading two\r\n * surfaces is a *stack* (`fill={[a, b]}` with the second layer's opacity tweened),\r\n * which is how it is expressed in 2D too.\r\n *\r\n * The colour test is deliberately cheap and allocation-free: resolving a rich\r\n * fill builds a `Graphics2D` and a texture descriptor, and doing that twice per\r\n * frame for a tween that is going to snap anyway would be pure waste.\r\n */\r\nexport function lerpFill3D(from: Fill3D, to: Fill3D, t: number): Fill3D {\r\n const start = asPlainColor(from);\r\n const end = asPlainColor(to);\r\n if (start !== null && end !== null) {\r\n return lerpColor(normalize(start), normalize(end), t) as unknown as Fill3D;\r\n }\r\n return t < 1 ? from : to;\r\n}\r\n\r\n/** The colour a fill *is*, or `null` when it is anything richer. No allocation. */\r\nfunction asPlainColor(fill: Fill3D | undefined): Color | null {\r\n if (fill === undefined || fill === null) return null;\r\n if (typeof fill === \"string\") return looksLikeAssetPath(fill) ? null : fill;\r\n if (Array.isArray(fill)) {\r\n return fill.every((entry) => typeof entry === \"number\") ? (fill as unknown as Color) : null;\r\n }\r\n if (typeof fill === \"object\" && isSolidLayer(fill)) return (fill as { color: Color }).color;\r\n return null;\r\n}\r\n\r\nfunction normalize(color: Color): NormalizedColor {\r\n return Array.isArray(color) ? (color as NormalizedColor) : parseColor(color);\r\n}\r\n\r\nconst objectIds = new WeakMap<object, string>();\r\nlet objectCounter = 0;\r\n\r\n/**\r\n * A stable key for a fill value.\r\n *\r\n * Plain data is walked and sorted; anything with a prototype of its own — a\r\n * `Scene3D`, a `Graphics2D`, a video source — is keyed by object identity, which\r\n * is both cheaper than serialising it and the honest answer, since two different\r\n * instances describe two different things whatever their fields say. A\r\n * `FillChain` is unwrapped to its list first, so building one inline still\r\n * produces the same key for the same layers.\r\n */\r\nfunction fillIdentity(value: unknown): string {\r\n if (value === null || typeof value !== \"object\") return String(value);\r\n if (Array.isArray(value)) return `[${value.map(fillIdentity).join(\",\")}]`;\r\n\r\n const list = (value as { list?: unknown }).list;\r\n if (Array.isArray(list)) return fillIdentity(list);\r\n\r\n const prototype = Object.getPrototypeOf(value);\r\n if (prototype !== Object.prototype && prototype !== null) {\r\n let id = objectIds.get(value);\r\n if (id === undefined) {\r\n id = `@${objectCounter++}`;\r\n objectIds.set(value, id);\r\n }\r\n return id;\r\n }\r\n\r\n const bag = value as Record<string, unknown>;\r\n return `{${Object.keys(bag).sort().map((key) => `${key}:${fillIdentity(bag[key])}`).join(\",\")}}`;\r\n}\r\n"]}
|
|
@@ -9,6 +9,12 @@ import type { Segments3D } from "./segments.js";
|
|
|
9
9
|
* type system, and the renderer treats any change to it as a full rebuild since
|
|
10
10
|
* it cannot know what a given key affects), but it means no author is ever
|
|
11
11
|
* blocked waiting for a field to be modelled here.
|
|
12
|
+
*
|
|
13
|
+
* **Where it is applied**: materials, lights (and a light's `shadow`) and
|
|
14
|
+
* cameras. **Where it is not**: geometries, the environment and post effects. A
|
|
15
|
+
* `params` there is recorded and nothing reads it (probe: `box({ params: { name:
|
|
16
|
+
* "x" } })` leaves the built geometry's `name` empty), and in development the
|
|
17
|
+
* first one warns. Set a geometry's own fields instead.
|
|
12
18
|
*/
|
|
13
19
|
export interface Passthrough3D {
|
|
14
20
|
params?: Record<string, unknown>;
|
|
@@ -126,8 +132,9 @@ export interface RingGeometry3D extends Passthrough3D, Sweep3D {
|
|
|
126
132
|
}
|
|
127
133
|
export interface CapsuleGeometry3D extends Passthrough3D {
|
|
128
134
|
type: "capsule";
|
|
135
|
+
/** Default 0.5. */
|
|
129
136
|
radius?: number;
|
|
130
|
-
/** Length of the straight mid-section, excluding the caps. */
|
|
137
|
+
/** Length of the straight mid-section, excluding the caps. Default 1. */
|
|
131
138
|
height?: number;
|
|
132
139
|
/** `[radial, cap]`. Default `[16, 8]`. */
|
|
133
140
|
segments?: Segments3D;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/render3d/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,KAAK,KAAK,EAAc,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C
|
|
1
|
+
{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/render3d/geometry.ts"],"names":[],"mappings":"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"}
|
|
@@ -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\";\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 */\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 radius?: number;\n /** Length of the straight mid-section, excluding the caps. */\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
|
+
{"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"]}
|
|
@@ -165,7 +165,7 @@ type ParamsOf<G> = Omit<G, "type">;
|
|
|
165
165
|
*
|
|
166
166
|
* ── Angles are DEGREES ────────────────────────────────────────────────────────
|
|
167
167
|
* Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,
|
|
168
|
-
* matching
|
|
168
|
+
* matching the engine's 2D `rotation`. The renderer converts.
|
|
169
169
|
*
|
|
170
170
|
* ── Animation ─────────────────────────────────────────────────────────────────
|
|
171
171
|
* A `Graphics3D` is rebuilt from scratch every frame, so animation is just
|
|
@@ -204,6 +204,8 @@ type ParamsOf<G> = Omit<G, "type">;
|
|
|
204
204
|
*/
|
|
205
205
|
export declare class Graphics3D {
|
|
206
206
|
private _ops;
|
|
207
|
+
/** Append one op, flagging (in development) inputs no renderer acts on. */
|
|
208
|
+
private record;
|
|
207
209
|
/**
|
|
208
210
|
* Record a mesh from an explicit geometry and material. The geometry sugar
|
|
209
211
|
* methods below all funnel here.
|
|
@@ -242,8 +244,8 @@ export declare class Graphics3D {
|
|
|
242
244
|
* Record a line. Give it either explicit `points` or a `geometry` (typically
|
|
243
245
|
* `Geo.edges(...)` for a wireframe outline).
|
|
244
246
|
*
|
|
245
|
-
* `closed` joins the last point back to the first,
|
|
246
|
-
*
|
|
247
|
+
* `closed` joins the last point back to the first, as the 2D `line` op's
|
|
248
|
+
* own field does. `segments` treats the points as disjoint start/end pairs
|
|
247
249
|
* instead — the form `Geo.edges(...)` produces. (There is no subdivision to
|
|
248
250
|
* confuse it with: a line is drawn from the points it is given.)
|
|
249
251
|
*/
|
|
@@ -267,7 +269,9 @@ export declare class Graphics3D {
|
|
|
267
269
|
opacity?: number;
|
|
268
270
|
} & Transform3D): this;
|
|
269
271
|
/**
|
|
270
|
-
* Record a loaded model
|
|
272
|
+
* Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)
|
|
273
|
+
* resolves to an empty slot and draws nothing, and in development the first
|
|
274
|
+
* one recorded warns.
|
|
271
275
|
*
|
|
272
276
|
* Baked animation is sampled by explicit `time`, never advanced by a delta, so
|
|
273
277
|
* a model stays frame-identical under scrubbing.
|
|
@@ -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,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAClE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,eAAe,EAClE,eAAe,EAAE,oBAAoB,EAAE,cAAc,EAAE,gBAAgB,EACvE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EACvD,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"graphics3d.d.ts","sourceRoot":"","sources":["../../src/render3d/graphics3d.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { resolveFill3D } from "./fill3d.js";
|
|
2
|
+
import { inspectDrawable3D } from "./inert.js";
|
|
2
3
|
/**
|
|
3
4
|
* Op kinds that put something in the scene (as opposed to shaping the tree).
|
|
4
5
|
*
|
|
@@ -111,7 +112,7 @@ function pickGeometry(source, type) {
|
|
|
111
112
|
*
|
|
112
113
|
* ── Angles are DEGREES ────────────────────────────────────────────────────────
|
|
113
114
|
* Every angle here — Euler rotations, sweep arcs, UV rotation — is in degrees,
|
|
114
|
-
* matching
|
|
115
|
+
* matching the engine's 2D `rotation`. The renderer converts.
|
|
115
116
|
*
|
|
116
117
|
* ── Animation ─────────────────────────────────────────────────────────────────
|
|
117
118
|
* A `Graphics3D` is rebuilt from scratch every frame, so animation is just
|
|
@@ -150,13 +151,18 @@ function pickGeometry(source, type) {
|
|
|
150
151
|
*/
|
|
151
152
|
export class Graphics3D {
|
|
152
153
|
_ops = [];
|
|
154
|
+
/** Append one op, flagging (in development) inputs no renderer acts on. */
|
|
155
|
+
record(op) {
|
|
156
|
+
inspectDrawable3D(op);
|
|
157
|
+
this._ops.push(op);
|
|
158
|
+
}
|
|
153
159
|
// ─── Meshes ──────────────────────────────────────────────────────────────
|
|
154
160
|
/**
|
|
155
161
|
* Record a mesh from an explicit geometry and material. The geometry sugar
|
|
156
162
|
* methods below all funnel here.
|
|
157
163
|
*/
|
|
158
164
|
mesh(geometry, material, transform) {
|
|
159
|
-
this.
|
|
165
|
+
this.record({
|
|
160
166
|
kind: "mesh",
|
|
161
167
|
geometry,
|
|
162
168
|
material: material ?? { type: "standard" },
|
|
@@ -220,7 +226,7 @@ export class Graphics3D {
|
|
|
220
226
|
* positions.map(p => ({ position: p })))
|
|
221
227
|
*/
|
|
222
228
|
instances(geometry, material, instances, options) {
|
|
223
|
-
this.
|
|
229
|
+
this.record({
|
|
224
230
|
kind: "instances",
|
|
225
231
|
geometry,
|
|
226
232
|
material,
|
|
@@ -232,7 +238,7 @@ export class Graphics3D {
|
|
|
232
238
|
}
|
|
233
239
|
/** Record a point cloud — one sprite-like dot per vertex of `geometry`. */
|
|
234
240
|
points(geometry, material, transform) {
|
|
235
|
-
this.
|
|
241
|
+
this.record({
|
|
236
242
|
kind: "points",
|
|
237
243
|
geometry,
|
|
238
244
|
material: material ?? { type: "points" },
|
|
@@ -244,8 +250,8 @@ export class Graphics3D {
|
|
|
244
250
|
* Record a line. Give it either explicit `points` or a `geometry` (typically
|
|
245
251
|
* `Geo.edges(...)` for a wireframe outline).
|
|
246
252
|
*
|
|
247
|
-
* `closed` joins the last point back to the first,
|
|
248
|
-
*
|
|
253
|
+
* `closed` joins the last point back to the first, as the 2D `line` op's
|
|
254
|
+
* own field does. `segments` treats the points as disjoint start/end pairs
|
|
249
255
|
* instead — the form `Geo.edges(...)` produces. (There is no subdivision to
|
|
250
256
|
* confuse it with: a line is drawn from the points it is given.)
|
|
251
257
|
*/
|
|
@@ -263,7 +269,7 @@ export class Graphics3D {
|
|
|
263
269
|
: {}),
|
|
264
270
|
...(opacity !== undefined ? { opacity } : {}),
|
|
265
271
|
};
|
|
266
|
-
this.
|
|
272
|
+
this.record({
|
|
267
273
|
kind: "line",
|
|
268
274
|
geometry: geometry ?? { type: "buffer", position: flattenPoints(points) },
|
|
269
275
|
material: resolved,
|
|
@@ -282,7 +288,7 @@ export class Graphics3D {
|
|
|
282
288
|
...(paint.color !== undefined ? { color: paint.color } : {}),
|
|
283
289
|
...(opacity !== undefined ? { opacity } : {}),
|
|
284
290
|
};
|
|
285
|
-
this.
|
|
291
|
+
this.record({
|
|
286
292
|
kind: "sprite",
|
|
287
293
|
material: resolved,
|
|
288
294
|
transform: pickTransform(options),
|
|
@@ -290,14 +296,16 @@ export class Graphics3D {
|
|
|
290
296
|
return this;
|
|
291
297
|
}
|
|
292
298
|
/**
|
|
293
|
-
* Record a loaded model
|
|
299
|
+
* Record a loaded model. **glTF/GLB only**: any other format (an `.obj`, say)
|
|
300
|
+
* resolves to an empty slot and draws nothing, and in development the first
|
|
301
|
+
* one recorded warns.
|
|
294
302
|
*
|
|
295
303
|
* Baked animation is sampled by explicit `time`, never advanced by a delta, so
|
|
296
304
|
* a model stays frame-identical under scrubbing.
|
|
297
305
|
*/
|
|
298
306
|
model(options) {
|
|
299
307
|
const { src, animation, override } = options;
|
|
300
|
-
this.
|
|
308
|
+
this.record({
|
|
301
309
|
kind: "model",
|
|
302
310
|
src,
|
|
303
311
|
animation: animation === undefined
|
|
@@ -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\";\nimport type {\n BoxGeometry3D, 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 { 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 * protected renderSelf(ctx: RenderContext3D): void {\n * ctx.draw(new Graphics3D()\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 }));\n * }\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 motion-script'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 props while building:\n *\n * class Rig extends Canvas3D {\n * @property({ default: 0 }) declare spin: number;\n * @vector3Property() declare lift: Vector3;\n *\n * protected buildScene3D(scene: Scene3D): void {\n * scene.draw(new Graphics3D()\n * .box({ rotation: [0, this.spin, 0], position: this.lift }));\n * }\n * }\n * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })\n *\n * Note `@vector3Property` rather than a bare `@property`. A prop holding a\n * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,\n * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it\n * alone; the attribute-typed decorators carry the right one already.\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 // ─── 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._ops.push({\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._ops.push({\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._ops.push({\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, matching the 2D `Line`\n * node's own prop. `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._ops.push({\n kind: \"line\",\n geometry: geometry ?? { type: \"buffer\", position: flattenPoints(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._ops.push({\n kind: \"sprite\",\n material: resolved,\n transform: pickTransform(options),\n });\n return this;\n }\n\n /**\n * Record a loaded model (glTF/GLB, OBJ).\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._ops.push({\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/** Flatten `Vector3Input`s into the packed `[x, y, z, …]` a buffer wants. */\nfunction flattenPoints(points: readonly Vector3Input[]): number[] {\n const out: number[] = [];\n for (const point of points) {\n if (typeof point === \"number\") {\n out.push(point, point, point);\n } else if (Array.isArray(point)) {\n out.push(point[0] ?? 0, point[1] ?? 0, point[2] ?? 0);\n } else {\n const v = point as { x: number; y: number; z: number };\n out.push(v.x ?? 0, v.y ?? 0, v.z ?? 0);\n }\n }\n return out;\n}\n"]}
|
|
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 * protected renderSelf(ctx: RenderContext3D): void {\r\n * ctx.draw(new Graphics3D()\r\n * .box({ width: 2, cornerRadius: 0.15, fill: \"#e0533d\", roughness: 0.3 }));\r\n * }\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 props while building:\r\n *\r\n * class Rig extends Canvas3D {\r\n * @property({ default: 0 }) declare spin: number;\r\n * @vector3Property() declare lift: Vector3;\r\n *\r\n * protected buildScene3D(scene: Scene3D): void {\r\n * scene.draw(new Graphics3D()\r\n * .box({ rotation: [0, this.spin, 0], position: this.lift }));\r\n * }\r\n * }\r\n * // rig().to({ data: { spin: 360 }, duration: 2, easing: easeInOut() })\r\n *\r\n * Note `@vector3Property` rather than a bare `@property`. A prop holding a\r\n * non-number needs an explicit tween (`lerpVector3`, `lerpEuler3`,\r\n * `slerpQuaternion`) or `to()` has nothing to interpolate it with and leaves it\r\n * alone; the attribute-typed decorators carry the right one already.\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"]}
|