retiam 0.0.0-stage ā 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/cli.js +209 -0
- package/bin/export.js +323 -0
- package/bin/init.js +425 -0
- package/bin/lint.js +354 -0
- package/bin/render.js +600 -0
- package/bin/snapshot.js +231 -0
- package/dist/UTIF-pBEih-vH.js +2845 -0
- package/dist/assets/Excalifont-Regular.woff2 +0 -0
- package/dist/assets/FiraCode-Regular.ttf +0 -0
- package/dist/assets/FrederickatheGreat-Regular.ttf +0 -0
- package/dist/assets/Virgil.woff2 +0 -0
- package/dist/assets/roboto-msdf.json +3643 -0
- package/dist/assets/roboto-msdf.png +0 -0
- package/dist/assets/roboto-regular.ttf +0 -0
- package/dist/assets/rt_hdr_alb_nrm.tza +0 -0
- package/dist/assets/worker-DKrf-Y6u.js +1231 -0
- package/dist/decompress-D5RzmD-2.js +566 -0
- package/dist/index-CnM0BhUR.js +109423 -0
- package/dist/libs/charts/cartesian/AreaChart.d.ts +12 -0
- package/dist/libs/charts/cartesian/BarChart.d.ts +39 -0
- package/dist/libs/charts/cartesian/LineChart.d.ts +44 -0
- package/dist/libs/charts/components/Tooltip.d.ts +18 -0
- package/dist/libs/charts/core/Chart.d.ts +37 -0
- package/dist/libs/charts/core/Scale.d.ts +34 -0
- package/dist/libs/charts/core/Theme.d.ts +20 -0
- package/dist/libs/charts/index.d.ts +8 -0
- package/dist/libs/charts/index.js +639 -0
- package/dist/libs/charts/polar/PieChart.d.ts +38 -0
- package/dist/libs/graphs/automata/Automaton.d.ts +46 -0
- package/dist/libs/graphs/automata/AutomatonRunner.d.ts +22 -0
- package/dist/libs/graphs/automata/Tape.d.ts +45 -0
- package/dist/libs/graphs/core/GraphEdge.d.ts +44 -0
- package/dist/libs/graphs/core/GraphNode.d.ts +41 -0
- package/dist/libs/graphs/core/GraphTheme.d.ts +35 -0
- package/dist/libs/graphs/core/Layouts.d.ts +34 -0
- package/dist/libs/graphs/graph/Graph.d.ts +50 -0
- package/dist/libs/graphs/index.d.ts +8 -0
- package/dist/libs/graphs/index.js +802 -0
- package/dist/libs/highlights/backdrop/BackdropFade.d.ts +10 -0
- package/dist/libs/highlights/backdrop/MarkerSweep.d.ts +10 -0
- package/dist/libs/highlights/boundary/BoundaryRipple.d.ts +10 -0
- package/dist/libs/highlights/boundary/Circumscribe.d.ts +10 -0
- package/dist/libs/highlights/boundary/CornerBrackets.d.ts +10 -0
- package/dist/libs/highlights/boundary/Underline.d.ts +10 -0
- package/dist/libs/highlights/core/types.d.ts +141 -0
- package/dist/libs/highlights/core/utils.d.ts +15 -0
- package/dist/libs/highlights/finish/Flash.d.ts +21 -0
- package/dist/libs/highlights/finish/FlashFinish.d.ts +10 -0
- package/dist/libs/highlights/finish/ShimmerSweep.d.ts +9 -0
- package/dist/libs/highlights/finish/SparkleBurst.d.ts +10 -0
- package/dist/libs/highlights/index.d.ts +17 -0
- package/dist/libs/highlights/index.js +435 -0
- package/dist/libs/highlights/material/Blink.d.ts +15 -0
- package/dist/libs/highlights/material/ColorTint.d.ts +9 -0
- package/dist/libs/highlights/material/PulseGlow.d.ts +9 -0
- package/dist/libs/highlights/motion/PopHighlight.d.ts +9 -0
- package/dist/libs/highlights/motion/WiggleHighlight.d.ts +9 -0
- package/dist/libs/physics/2d/Joint2D.d.ts +37 -0
- package/dist/libs/physics/2d/Physics2D.d.ts +125 -0
- package/dist/libs/physics/2d/Physics2DTypes.d.ts +185 -0
- package/dist/libs/physics/2d/Physics2DUtils.d.ts +9 -0
- package/dist/libs/physics/2d/backends/IPhysics2DBackend.d.ts +46 -0
- package/dist/libs/physics/2d/backends/Planck2DBackend.d.ts +44 -0
- package/dist/libs/physics/2d/backends/Rapier2DBackend.d.ts +46 -0
- package/dist/libs/physics/2d/components/RigidBody2DComponent.d.ts +56 -0
- package/dist/libs/physics/2d/components/SoftBody2DComponent.d.ts +19 -0
- package/dist/libs/physics/3d/Physics3D.d.ts +66 -0
- package/dist/libs/physics/3d/Physics3DTypes.d.ts +100 -0
- package/dist/libs/physics/3d/PhysicsUtils.d.ts +9 -0
- package/dist/libs/physics/3d/backends/Box3DBackend.d.ts +66 -0
- package/dist/libs/physics/3d/backends/IPhysics3DBackend.d.ts +22 -0
- package/dist/libs/physics/3d/backends/Rapier3DBackend.d.ts +33 -0
- package/dist/libs/physics/3d/components/RigidBodyComponent.d.ts +100 -0
- package/dist/libs/physics/3d/components/SoftBodyComponent.d.ts +26 -0
- package/dist/libs/physics/index.d.ts +17 -0
- package/dist/libs/physics/index.js +18697 -0
- package/dist/libs/rough/RoughModifier.d.ts +72 -0
- package/dist/libs/rough/RoughShape.d.ts +175 -0
- package/dist/libs/rough/index.d.ts +5 -0
- package/dist/libs/rough/index.js +1488 -0
- package/dist/libs/shapes/2d/Annulus.d.ts +33 -0
- package/dist/libs/shapes/2d/ArchitecturalProfile.d.ts +42 -0
- package/dist/libs/shapes/2d/Capsule.d.ts +33 -0
- package/dist/libs/shapes/2d/Chevron.d.ts +37 -0
- package/dist/libs/shapes/2d/Crescent.d.ts +27 -0
- package/dist/libs/shapes/2d/Cross.d.ts +32 -0
- package/dist/libs/shapes/2d/CurvedArrow.d.ts +53 -0
- package/dist/libs/shapes/2d/Diamond.d.ts +32 -0
- package/dist/libs/shapes/2d/DoubleArrow.d.ts +28 -0
- package/dist/libs/shapes/2d/Gear2D.d.ts +42 -0
- package/dist/libs/shapes/2d/Heart.d.ts +28 -0
- package/dist/libs/shapes/2d/Parallelogram.d.ts +37 -0
- package/dist/libs/shapes/2d/RegularPolygon.d.ts +41 -0
- package/dist/libs/shapes/2d/Sector.d.ts +27 -0
- package/dist/libs/shapes/2d/Spiral2D.d.ts +42 -0
- package/dist/libs/shapes/2d/Squircle.d.ts +39 -0
- package/dist/libs/shapes/2d/Star.d.ts +47 -0
- package/dist/libs/shapes/2d/Teardrop.d.ts +27 -0
- package/dist/libs/shapes/2d/Trapezoid.d.ts +37 -0
- package/dist/libs/shapes/2d/Waveform2D.d.ts +47 -0
- package/dist/libs/shapes/2d/index.d.ts +20 -0
- package/dist/libs/shapes/3d/Bipyramid3D.d.ts +27 -0
- package/dist/libs/shapes/3d/Capsule3D.d.ts +33 -0
- package/dist/libs/shapes/3d/Diamond3D.d.ts +42 -0
- package/dist/libs/shapes/3d/Ellipsoid3D.d.ts +37 -0
- package/dist/libs/shapes/3d/Gear3D.d.ts +42 -0
- package/dist/libs/shapes/3d/Helix3D.d.ts +43 -0
- package/dist/libs/shapes/3d/PlatonicSolids.d.ts +42 -0
- package/dist/libs/shapes/3d/Prism3D.d.ts +32 -0
- package/dist/libs/shapes/3d/Pyramid3D.d.ts +32 -0
- package/dist/libs/shapes/3d/RoundedBox3D.d.ts +37 -0
- package/dist/libs/shapes/3d/Superellipsoid3D.d.ts +48 -0
- package/dist/libs/shapes/3d/TorusKnot3D.d.ts +42 -0
- package/dist/libs/shapes/3d/TruncatedCone3D.d.ts +37 -0
- package/dist/libs/shapes/3d/Tube3D.d.ts +39 -0
- package/dist/libs/shapes/3d/Wedge3D.d.ts +27 -0
- package/dist/libs/shapes/3d/index.d.ts +15 -0
- package/dist/libs/shapes/index.d.ts +8 -0
- package/dist/libs/shapes/index.js +3196 -0
- package/dist/libs/shapes/types.d.ts +32 -0
- package/dist/libs/shapes/utils/index.d.ts +2 -0
- package/dist/libs/shapes/utils/meshGenerators.d.ts +71 -0
- package/dist/libs/shapes/utils/pathCalculations.d.ts +81 -0
- package/dist/libs/tts/animations/Speak.d.ts +79 -0
- package/dist/libs/tts/components/Subtitles.d.ts +141 -0
- package/dist/libs/tts/components/TTSNarrationComponent.d.ts +57 -0
- package/dist/libs/tts/core/MsEdgeVoices.d.ts +29 -0
- package/dist/libs/tts/core/TTSAudio.d.ts +80 -0
- package/dist/libs/tts/core/TTSCache.d.ts +15 -0
- package/dist/libs/tts/core/TTSClient.d.ts +66 -0
- package/dist/libs/tts/core/mp3Utils.d.ts +19 -0
- package/dist/libs/tts/core/msEdgeV2.d.ts +4 -0
- package/dist/libs/tts/core/types.d.ts +84 -0
- package/dist/libs/tts/index.d.ts +16 -0
- package/dist/libs/tts/index.js +1611 -0
- package/dist/libs/tts/providers/ITTSProvider.d.ts +30 -0
- package/dist/libs/tts/providers/MsEdgeTTSProvider.d.ts +61 -0
- package/dist/main-Bw2LTrnR.js +22927 -0
- package/dist/opentype.module-D6jx0UDN.js +8689 -0
- package/dist/retiam.es.js +814 -0
- package/dist/src/engine/_core/Always.d.ts +181 -0
- package/dist/src/engine/_core/Component.d.ts +43 -0
- package/dist/src/engine/_core/Constants.d.ts +168 -0
- package/dist/src/engine/_core/Entity.d.ts +725 -0
- package/dist/src/engine/_core/Fill.d.ts +34 -0
- package/dist/src/engine/_core/Group.d.ts +88 -0
- package/dist/src/engine/_core/IPlugin.d.ts +44 -0
- package/dist/src/engine/_core/Interfaces.d.ts +50 -0
- package/dist/src/engine/_core/Material.d.ts +184 -0
- package/dist/src/engine/_core/OfflineRenderManager.d.ts +10 -0
- package/dist/src/engine/_core/Paint.d.ts +155 -0
- package/dist/src/engine/_core/Scene.d.ts +399 -0
- package/dist/src/engine/_core/SceneComposer.d.ts +269 -0
- package/dist/src/engine/_core/SceneInterface.d.ts +55 -0
- package/dist/src/engine/_core/SnapshotManager.d.ts +56 -0
- package/dist/src/engine/_core/State.d.ts +106 -0
- package/dist/src/engine/_core/StateDataManager.d.ts +61 -0
- package/dist/src/engine/_core/TextureManager.d.ts +20 -0
- package/dist/src/engine/_core/Transform.d.ts +344 -0
- package/dist/src/engine/_core/UIManager.d.ts +28 -0
- package/dist/src/engine/_core/VectorEntity.d.ts +151 -0
- package/dist/src/engine/_core/VideoData.d.ts +47 -0
- package/dist/src/engine/animation/AnimOptions.d.ts +93 -0
- package/dist/src/engine/animation/Animation.d.ts +134 -0
- package/dist/src/engine/animation/AnimationFrameScheduler.d.ts +26 -0
- package/dist/src/engine/animation/AnimationFunctions.d.ts +105 -0
- package/dist/src/engine/animation/Animator.d.ts +153 -0
- package/dist/src/engine/animation/BlurIn.d.ts +40 -0
- package/dist/src/engine/animation/BlurOut.d.ts +41 -0
- package/dist/src/engine/animation/BlurPulse.d.ts +33 -0
- package/dist/src/engine/animation/BlurTarget.d.ts +25 -0
- package/dist/src/engine/animation/BlurTo.d.ts +30 -0
- package/dist/src/engine/animation/Concurrent.d.ts +52 -0
- package/dist/src/engine/animation/CustomAnimation.d.ts +24 -0
- package/dist/src/engine/animation/Delay.d.ts +68 -0
- package/dist/src/engine/animation/FadeIn.d.ts +7 -0
- package/dist/src/engine/animation/FadeOut.d.ts +17 -0
- package/dist/src/engine/animation/GroupAnimator.d.ts +106 -0
- package/dist/src/engine/animation/Rate.d.ts +80 -0
- package/dist/src/engine/animation/Sequential.d.ts +29 -0
- package/dist/src/engine/animation/StateAnimation.d.ts +46 -0
- package/dist/src/engine/animation/TrackAnimation.d.ts +22 -0
- package/dist/src/engine/animation/TrackBuilder.d.ts +44 -0
- package/dist/src/engine/animation/Waiting.d.ts +32 -0
- package/dist/src/engine/animation/Write.d.ts +8 -0
- package/dist/src/engine/animation/camera/CameraDollyZoom.d.ts +18 -0
- package/dist/src/engine/animation/camera/CameraLookAt.d.ts +18 -0
- package/dist/src/engine/animation/camera/CameraMove.d.ts +24 -0
- package/dist/src/engine/animation/camera/CameraOrbit.d.ts +19 -0
- package/dist/src/engine/animation/creation/AppearInstant.d.ts +30 -0
- package/dist/src/engine/animation/creation/BatchIntroduce.d.ts +36 -0
- package/dist/src/engine/animation/creation/BloomIn.d.ts +46 -0
- package/dist/src/engine/animation/creation/BurstIn.d.ts +42 -0
- package/dist/src/engine/animation/creation/CascadeIn.d.ts +64 -0
- package/dist/src/engine/animation/creation/Create.d.ts +38 -0
- package/dist/src/engine/animation/creation/Create3D.d.ts +12 -0
- package/dist/src/engine/animation/creation/CrystallizeIn.d.ts +46 -0
- package/dist/src/engine/animation/creation/DrawBorderOnly.d.ts +27 -0
- package/dist/src/engine/animation/creation/DrawBorderThenFill.d.ts +24 -0
- package/dist/src/engine/animation/creation/DropIn.d.ts +29 -0
- package/dist/src/engine/animation/creation/EraseIn.d.ts +48 -0
- package/dist/src/engine/animation/creation/GlowIn.d.ts +56 -0
- package/dist/src/engine/animation/creation/GrowFromCenter.d.ts +27 -0
- package/dist/src/engine/animation/creation/GrowFromEdge.d.ts +33 -0
- package/dist/src/engine/animation/creation/IrisIn.d.ts +38 -0
- package/dist/src/engine/animation/creation/MaterializeFrom.d.ts +50 -0
- package/dist/src/engine/animation/creation/PopIn.d.ts +45 -0
- package/dist/src/engine/animation/creation/RevealFromClip.d.ts +36 -0
- package/dist/src/engine/animation/creation/ScatterAssemble.d.ts +51 -0
- package/dist/src/engine/animation/creation/ShimmerIn.d.ts +52 -0
- package/dist/src/engine/animation/creation/SlideIn.d.ts +33 -0
- package/dist/src/engine/animation/creation/SpinIn.d.ts +45 -0
- package/dist/src/engine/animation/creation/StaggerWrite.d.ts +31 -0
- package/dist/src/engine/animation/creation/TelegraphThenReveal.d.ts +56 -0
- package/dist/src/engine/animation/creation/TraceBack.d.ts +46 -0
- package/dist/src/engine/animation/creation/TransmitIn.d.ts +46 -0
- package/dist/src/engine/animation/creation/Typewriter.d.ts +149 -0
- package/dist/src/engine/animation/creation/TypewriterIn.d.ts +93 -0
- package/dist/src/engine/animation/creation/Uncreate.d.ts +34 -0
- package/dist/src/engine/animation/creation/UnfoldFromCenter.d.ts +40 -0
- package/dist/src/engine/animation/creation/Unwrite.d.ts +18 -0
- package/dist/src/engine/animation/creation/WaveIn.d.ts +46 -0
- package/dist/src/engine/animation/creation/WipeIn.d.ts +50 -0
- package/dist/src/engine/animation/layout/ArrangeReveal.d.ts +51 -0
- package/dist/src/engine/animation/layout/ArrangeRipple.d.ts +51 -0
- package/dist/src/engine/animation/layout/MorphArrange.d.ts +38 -0
- package/dist/src/engine/animation/motion/LissajousAnimation.d.ts +50 -0
- package/dist/src/engine/animation/motion/MotionPath.d.ts +73 -0
- package/dist/src/engine/animation/motion/OrbitAnimation.d.ts +41 -0
- package/dist/src/engine/animation/motion/ShakeAnimation.d.ts +37 -0
- package/dist/src/engine/animation/motion/SpiralAnimation.d.ts +49 -0
- package/dist/src/engine/animation/motion/SplineAnimation.d.ts +107 -0
- package/dist/src/engine/animation/motion/SpringAnimation.d.ts +50 -0
- package/dist/src/engine/animation/transform/HomotopyAnimation.d.ts +23 -0
- package/dist/src/engine/animation/transform/ModelTransform.d.ts +19 -0
- package/dist/src/engine/animation/transform/Morph.d.ts +18 -0
- package/dist/src/engine/animation/transform/SDF3DTransform.d.ts +12 -0
- package/dist/src/engine/animation/transform/SpaceTransform.d.ts +14 -0
- package/dist/src/engine/animation/transform/TransformMatch.d.ts +14 -0
- package/dist/src/engine/animation/transform/TransformMatchingShapes.d.ts +21 -0
- package/dist/src/engine/animation/transform/TransformMatchingTex.d.ts +17 -0
- package/dist/src/engine/animation/transform/TransformMatchingText.d.ts +19 -0
- package/dist/src/engine/animation/transform/VectorTransform.d.ts +22 -0
- package/dist/src/engine/audio/AudioAnalyzer.d.ts +80 -0
- package/dist/src/engine/audio/AudioLoader.d.ts +29 -0
- package/dist/src/engine/audio/AudioManager.d.ts +186 -0
- package/dist/src/engine/audio/AudioPlugin.d.ts +46 -0
- package/dist/src/engine/audio/AudioTimeline.d.ts +111 -0
- package/dist/src/engine/audio/audioUtils.d.ts +8 -0
- package/dist/src/engine/audio/components/AudioListenerComponent.d.ts +11 -0
- package/dist/src/engine/audio/components/SpatialAudioComponent.d.ts +48 -0
- package/dist/src/engine/audio/index.d.ts +8 -0
- package/dist/src/engine/camera/Camera.d.ts +293 -0
- package/dist/src/engine/camera/Camera2DController.d.ts +393 -0
- package/dist/src/engine/camera/CameraController.d.ts +78 -0
- package/dist/src/engine/camera/OrbitCameraController.d.ts +138 -0
- package/dist/src/engine/camera/RenderView.d.ts +73 -0
- package/dist/src/engine/components/FragmentComponent.d.ts +30 -0
- package/dist/src/engine/components/GeometryComponent.d.ts +52 -0
- package/dist/src/engine/components/InteractionComponent.d.ts +47 -0
- package/dist/src/engine/components/RendererComponent.d.ts +38 -0
- package/dist/src/engine/components/fragment/Fragment2D.d.ts +10 -0
- package/dist/src/engine/components/fragment/IndexFragment2D.d.ts +10 -0
- package/dist/src/engine/components/fragment/Line3DFragment.d.ts +16 -0
- package/dist/src/engine/components/fragment/LineFragment.d.ts +5 -0
- package/dist/src/engine/components/fragment/ManimSurfaceFragment.d.ts +13 -0
- package/dist/src/engine/components/fragment/MathSurfaceFragment.d.ts +6 -0
- package/dist/src/engine/components/fragment/ModelFragment.d.ts +20 -0
- package/dist/src/engine/components/fragment/ParametricSurfaceFragment.d.ts +24 -0
- package/dist/src/engine/components/fragment/PathFragment.d.ts +37 -0
- package/dist/src/engine/components/fragment/PolyFragment.d.ts +20 -0
- package/dist/src/engine/components/fragment/SDF2DFragment.d.ts +22 -0
- package/dist/src/engine/components/fragment/SDFFragment.d.ts +25 -0
- package/dist/src/engine/components/fragment/ShaderFragment.d.ts +12 -0
- package/dist/src/engine/components/fragment/SplatFragment.d.ts +14 -0
- package/dist/src/engine/components/fragment/SpriteFragment.d.ts +30 -0
- package/dist/src/engine/components/fragment/SurfaceFragment.d.ts +16 -0
- package/dist/src/engine/components/fragment/TextFragment.d.ts +15 -0
- package/dist/src/engine/components/fragment/TriangulatedPathFragment.d.ts +14 -0
- package/dist/src/engine/components/geometry/BezierGeometry.d.ts +27 -0
- package/dist/src/engine/components/geometry/DeformableMeshGeometry.d.ts +31 -0
- package/dist/src/engine/components/geometry/Geometry2D.d.ts +18 -0
- package/dist/src/engine/components/geometry/IndexGeometry2D.d.ts +26 -0
- package/dist/src/engine/components/geometry/Line3DGeometry.d.ts +27 -0
- package/dist/src/engine/components/geometry/LineGeometry.d.ts +15 -0
- package/dist/src/engine/components/geometry/ModelGeometry.d.ts +29 -0
- package/dist/src/engine/components/geometry/MorphGeometry.d.ts +44 -0
- package/dist/src/engine/components/geometry/PathGeometry.d.ts +73 -0
- package/dist/src/engine/components/geometry/PolyGeometry.d.ts +31 -0
- package/dist/src/engine/components/geometry/QuadGeometry.d.ts +26 -0
- package/dist/src/engine/components/geometry/TextGeometry.d.ts +23 -0
- package/dist/src/engine/components/geometry/TriangulatedPathGeometry.d.ts +116 -0
- package/dist/src/engine/components/geometry/morph/DualContouringProcessor.d.ts +11 -0
- package/dist/src/engine/components/geometry/morph/MorphProcessor.d.ts +12 -0
- package/dist/src/engine/components/geometry/morph/NaiveProcessor.d.ts +6 -0
- package/dist/src/engine/components/geometry/morph/SdfVolumetricProcessor.d.ts +12 -0
- package/dist/src/engine/components/geometry/morph/SwarmProcessor.d.ts +9 -0
- package/dist/src/engine/components/renderers/MeshRenderer.d.ts +8 -0
- package/dist/src/engine/components/renderers/ModelRenderer.d.ts +9 -0
- package/dist/src/engine/components/renderers/PathRenderer.d.ts +9 -0
- package/dist/src/engine/components/renderers/TriangulatedPathRenderer.d.ts +32 -0
- package/dist/src/engine/compute/Compute.d.ts +322 -0
- package/dist/src/engine/compute/ComputeKernel.d.ts +39 -0
- package/dist/src/engine/control/InputRecorder.d.ts +62 -0
- package/dist/src/engine/control/InteractionManager.d.ts +49 -0
- package/dist/src/engine/control/PlayerControls.d.ts +60 -0
- package/dist/src/engine/control/menu.d.ts +56 -0
- package/dist/src/engine/entities/Instanced.d.ts +114 -0
- package/dist/src/engine/entities/SubScene.d.ts +10 -0
- package/dist/src/engine/entities/composites/PlotPrimitiveFactory.d.ts +22 -0
- package/dist/src/engine/entities/composites/PlotPrimitiveType.d.ts +15 -0
- package/dist/src/engine/entities/composites/coordinates/Axes.d.ts +88 -0
- package/dist/src/engine/entities/composites/coordinates/ComplexPlane.d.ts +49 -0
- package/dist/src/engine/entities/composites/coordinates/CoordinateSystem.d.ts +130 -0
- package/dist/src/engine/entities/composites/coordinates/NumberPlane.d.ts +129 -0
- package/dist/src/engine/entities/composites/coordinates/PolarAxes.d.ts +84 -0
- package/dist/src/engine/entities/composites/coordinates/ThreeDAxes.d.ts +74 -0
- package/dist/src/engine/entities/composites/geometry/Arrow.d.ts +109 -0
- package/dist/src/engine/entities/composites/geometry/Arrow3D.d.ts +34 -0
- package/dist/src/engine/entities/composites/geometry/BooleanOps.d.ts +40 -0
- package/dist/src/engine/entities/composites/geometry/Brace.d.ts +31 -0
- package/dist/src/engine/entities/composites/geometry/MathShape3D.d.ts +36 -0
- package/dist/src/engine/entities/composites/geometry/MeshSprite.d.ts +66 -0
- package/dist/src/engine/entities/composites/geometry/PixelGrid.d.ts +51 -0
- package/dist/src/engine/entities/composites/plotting/Calculus.d.ts +64 -0
- package/dist/src/engine/entities/composites/plotting/FunctionGraph2D.d.ts +48 -0
- package/dist/src/engine/entities/composites/plotting/ImplicitCurve2D.d.ts +39 -0
- package/dist/src/engine/entities/composites/plotting/ImplicitCurve2DGPU.d.ts +20 -0
- package/dist/src/engine/entities/composites/plotting/ImplicitSurface3D.d.ts +32 -0
- package/dist/src/engine/entities/composites/plotting/ParametricCurve2D.d.ts +49 -0
- package/dist/src/engine/entities/composites/plotting/ParametricCurve3D.d.ts +40 -0
- package/dist/src/engine/entities/composites/plotting/ParametricSurface3D.d.ts +42 -0
- package/dist/src/engine/entities/composites/plotting/PolarCurve.d.ts +26 -0
- package/dist/src/engine/entities/composites/plotting/RaymarchPlot3D.d.ts +65 -0
- package/dist/src/engine/entities/composites/plotting/Streamlines2D.d.ts +29 -0
- package/dist/src/engine/entities/composites/plotting/SurfaceGraph3D.d.ts +29 -0
- package/dist/src/engine/entities/composites/plotting/VectorField2D.d.ts +23 -0
- package/dist/src/engine/entities/composites/plotting/VectorField3D.d.ts +20 -0
- package/dist/src/engine/entities/composites/svg/SVG.d.ts +32 -0
- package/dist/src/engine/entities/composites/svg/SVGPath.d.ts +12 -0
- package/dist/src/engine/entities/composites/text/Code.d.ts +197 -0
- package/dist/src/engine/entities/composites/text/MarkupText.d.ts +175 -0
- package/dist/src/engine/entities/composites/text/SDFText.d.ts +92 -0
- package/dist/src/engine/entities/composites/text/Tex.d.ts +80 -0
- package/dist/src/engine/entities/composites/text/TexFontPatcher.d.ts +15 -0
- package/dist/src/engine/entities/composites/text/Text.d.ts +91 -0
- package/dist/src/engine/entities/composites/text/TextSplitter.d.ts +44 -0
- package/dist/src/engine/entities/composites/text/excalifontMathJaxData.d.ts +8 -0
- package/dist/src/engine/entities/composites/text/virgilMathJaxData.d.ts +3 -0
- package/dist/src/engine/entities/composites/trackers/ValueTrackers.d.ts +14 -0
- package/dist/src/engine/entities/composites/trackers/alwaysRedraw.d.ts +8 -0
- package/dist/src/engine/entities/layout/Arrange.d.ts +359 -0
- package/dist/src/engine/entities/layout/FeedbackZoomView.d.ts +25 -0
- package/dist/src/engine/entities/layout/HBox.d.ts +80 -0
- package/dist/src/engine/entities/layout/Mask.d.ts +17 -0
- package/dist/src/engine/entities/layout/VBox.d.ts +80 -0
- package/dist/src/engine/entities/layout/VGroup.d.ts +17 -0
- package/dist/src/engine/entities/layout/ZoomView.d.ts +49 -0
- package/dist/src/engine/entities/primitives/2d/AnimatedSprite.d.ts +28 -0
- package/dist/src/engine/entities/primitives/2d/Arc.d.ts +51 -0
- package/dist/src/engine/entities/primitives/2d/Bezier.d.ts +102 -0
- package/dist/src/engine/entities/primitives/2d/Circle.d.ts +20 -0
- package/dist/src/engine/entities/primitives/2d/Dot.d.ts +274 -0
- package/dist/src/engine/entities/primitives/2d/Ellipse.d.ts +14 -0
- package/dist/src/engine/entities/primitives/2d/Line.d.ts +72 -0
- package/dist/src/engine/entities/primitives/2d/Mesh2D.d.ts +44 -0
- package/dist/src/engine/entities/primitives/2d/Path.d.ts +328 -0
- package/dist/src/engine/entities/primitives/2d/Poly.d.ts +73 -0
- package/dist/src/engine/entities/primitives/2d/Rect.d.ts +37 -0
- package/dist/src/engine/entities/primitives/2d/SDF2D.d.ts +125 -0
- package/dist/src/engine/entities/primitives/2d/Shader.d.ts +77 -0
- package/dist/src/engine/entities/primitives/2d/Spline.d.ts +122 -0
- package/dist/src/engine/entities/primitives/2d/Spring.d.ts +135 -0
- package/dist/src/engine/entities/primitives/2d/Sprite.d.ts +27 -0
- package/dist/src/engine/entities/primitives/2d/Triangle.d.ts +44 -0
- package/dist/src/engine/entities/primitives/2d/curves/BSplineEvaluator.d.ts +20 -0
- package/dist/src/engine/entities/primitives/2d/curves/BezierEvaluator.d.ts +21 -0
- package/dist/src/engine/entities/primitives/2d/curves/CatmullRomEvaluator.d.ts +20 -0
- package/dist/src/engine/entities/primitives/2d/curves/CurveEvaluator.d.ts +68 -0
- package/dist/src/engine/entities/primitives/2d/curves/HermiteEvaluator.d.ts +19 -0
- package/dist/src/engine/entities/primitives/2d/curves/NaturalSplineEvaluator.d.ts +31 -0
- package/dist/src/engine/entities/primitives/2d/sdf/SDFCircle.d.ts +53 -0
- package/dist/src/engine/entities/primitives/3d/Box.d.ts +9 -0
- package/dist/src/engine/entities/primitives/3d/Cone.d.ts +6 -0
- package/dist/src/engine/entities/primitives/3d/Cylinder.d.ts +13 -0
- package/dist/src/engine/entities/primitives/3d/Environment.d.ts +8 -0
- package/dist/src/engine/entities/primitives/3d/Light.d.ts +8 -0
- package/dist/src/engine/entities/primitives/3d/Line3D.d.ts +78 -0
- package/dist/src/engine/entities/primitives/3d/Model.d.ts +79 -0
- package/dist/src/engine/entities/primitives/3d/MorphModel.d.ts +13 -0
- package/dist/src/engine/entities/primitives/3d/MorphOptions.d.ts +132 -0
- package/dist/src/engine/entities/primitives/3d/ParametricModel.d.ts +36 -0
- package/dist/src/engine/entities/primitives/3d/Plane.d.ts +30 -0
- package/dist/src/engine/entities/primitives/3d/RTHTML.d.ts +47 -0
- package/dist/src/engine/entities/primitives/3d/RTImage.d.ts +7 -0
- package/dist/src/engine/entities/primitives/3d/RTVideo.d.ts +12 -0
- package/dist/src/engine/entities/primitives/3d/SDFVolume.d.ts +7 -0
- package/dist/src/engine/entities/primitives/3d/Sphere.d.ts +9 -0
- package/dist/src/engine/entities/primitives/3d/Terrain3D.d.ts +39 -0
- package/dist/src/engine/entities/primitives/3d/Torus.d.ts +8 -0
- package/dist/src/engine/entities/primitives/3d/TracePath.d.ts +38 -0
- package/dist/src/engine/entities/sdf/SDFEntity3D.d.ts +13 -0
- package/dist/src/engine/entities/sdf/SDFMorph3D.d.ts +12 -0
- package/dist/src/engine/entities/sdf/SDFNode.d.ts +148 -0
- package/dist/src/engine/font/Font.d.ts +39 -0
- package/dist/src/engine/font/FontCache.d.ts +31 -0
- package/dist/src/engine/font/FontLoader.d.ts +38 -0
- package/dist/src/engine/font/FontResolver.d.ts +27 -0
- package/dist/src/engine/font/MSDFGenerator.d.ts +28 -0
- package/dist/src/engine/font/types.d.ts +76 -0
- package/dist/src/engine/loader/SubTexture.d.ts +61 -0
- package/dist/src/engine/loader/TextureAtlas.d.ts +84 -0
- package/dist/src/engine/material/FillEffect.d.ts +108 -0
- package/dist/src/engine/material/FillEffectBase.d.ts +34 -0
- package/dist/src/engine/material/PathEffect.d.ts +254 -0
- package/dist/src/engine/material/PathEffectBase.d.ts +34 -0
- package/dist/src/engine/material/fill_effects/CheckerboardFillEffect.d.ts +8 -0
- package/dist/src/engine/material/fill_effects/CustomFillEffect.d.ts +11 -0
- package/dist/src/engine/material/fill_effects/DotsFillEffect.d.ts +8 -0
- package/dist/src/engine/material/fill_effects/GlowFillEffect.d.ts +22 -0
- package/dist/src/engine/material/fill_effects/LinearGradientFillEffect.d.ts +8 -0
- package/dist/src/engine/material/fill_effects/OpacityFillEffect.d.ts +7 -0
- package/dist/src/engine/material/fill_effects/RadialGradientFillEffect.d.ts +8 -0
- package/dist/src/engine/material/fill_effects/SolidFillEffect.d.ts +7 -0
- package/dist/src/engine/material/fill_effects/StripesFillEffect.d.ts +8 -0
- package/dist/src/engine/material/fill_effects/TintFillEffect.d.ts +8 -0
- package/dist/src/engine/material/fill_effects/VignetteFillEffect.d.ts +7 -0
- package/dist/src/engine/material/fill_effects/colorMixer.d.ts +5 -0
- package/dist/src/engine/material/fill_effects/glowShader.d.ts +31 -0
- package/dist/src/engine/material/fill_effects/index.d.ts +13 -0
- package/dist/src/engine/material/fills/GradientFill.d.ts +32 -0
- package/dist/src/engine/material/fills/SolidFill.d.ts +6 -0
- package/dist/src/engine/material/fills/TextureFill.d.ts +24 -0
- package/dist/src/engine/material/fills/VideoFill.d.ts +12 -0
- package/dist/src/engine/material/path_effects/BrushEffect.d.ts +24 -0
- package/dist/src/engine/material/path_effects/CalligraphicEffect.d.ts +23 -0
- package/dist/src/engine/material/path_effects/ChalkEffect.d.ts +58 -0
- package/dist/src/engine/material/path_effects/CustomPathEffect.d.ts +11 -0
- package/dist/src/engine/material/path_effects/DashEffect.d.ts +14 -0
- package/dist/src/engine/material/path_effects/DynamicStrokeEffect.d.ts +25 -0
- package/dist/src/engine/material/path_effects/FluidEffect.d.ts +21 -0
- package/dist/src/engine/material/path_effects/GlowPathEffect.d.ts +7 -0
- package/dist/src/engine/material/path_effects/GradientPathEffect.d.ts +8 -0
- package/dist/src/engine/material/path_effects/OpacityPathEffect.d.ts +7 -0
- package/dist/src/engine/material/path_effects/PencilEffect.d.ts +22 -0
- package/dist/src/engine/material/path_effects/SketchEffect.d.ts +31 -0
- package/dist/src/engine/material/path_effects/SolidPathEffect.d.ts +7 -0
- package/dist/src/engine/material/path_effects/SpontaneousEffect.d.ts +23 -0
- package/dist/src/engine/material/path_effects/TaperEffect.d.ts +19 -0
- package/dist/src/engine/material/path_effects/WaveEffect.d.ts +7 -0
- package/dist/src/engine/material/path_effects/chalkShader.d.ts +36 -0
- package/dist/src/engine/material/path_effects/dynamicStrokeShader.d.ts +165 -0
- package/dist/src/engine/material/path_effects/index.d.ts +18 -0
- package/dist/src/engine/material/path_effects/sketchShader.d.ts +41 -0
- package/dist/src/engine/math/AABB.d.ts +95 -0
- package/dist/src/engine/math/Color.d.ts +221 -0
- package/dist/src/engine/math/Complex.d.ts +51 -0
- package/dist/src/engine/math/FourierTransform.d.ts +120 -0
- package/dist/src/engine/math/Frustum.d.ts +30 -0
- package/dist/src/engine/math/Math3D.d.ts +121 -0
- package/dist/src/engine/math/fields/SpatialField.d.ts +37 -0
- package/dist/src/engine/math/fields/StandardFields.d.ts +146 -0
- package/dist/src/engine/math/noise/BaseNoise.d.ts +80 -0
- package/dist/src/engine/math/noise/Noise.d.ts +55 -0
- package/dist/src/engine/math/noise/NoiseParams.d.ts +42 -0
- package/dist/src/engine/math/noise/NoiseScaler.d.ts +48 -0
- package/dist/src/engine/math/noise/PerlinNoise.d.ts +17 -0
- package/dist/src/engine/math/noise/SimplexNoise.d.ts +12 -0
- package/dist/src/engine/math/noise/ValueNoise.d.ts +15 -0
- package/dist/src/engine/math/noise/WhiteNoise.d.ts +13 -0
- package/dist/src/engine/math/noise/WorleyNoise.d.ts +20 -0
- package/dist/src/engine/math/vector/GPUData.d.ts +5 -0
- package/dist/src/engine/math/vector/Mat3.d.ts +111 -0
- package/dist/src/engine/math/vector/Mat4.d.ts +209 -0
- package/dist/src/engine/math/vector/Point.d.ts +38 -0
- package/dist/src/engine/math/vector/Quaternion.d.ts +83 -0
- package/dist/src/engine/math/vector/Vec2.d.ts +118 -0
- package/dist/src/engine/math/vector/Vec3.d.ts +120 -0
- package/dist/src/engine/modifiers/IPathModifier.d.ts +41 -0
- package/dist/src/engine/modifiers/PathModifier.d.ts +113 -0
- package/dist/src/engine/modifiers/PathModifierBase.d.ts +41 -0
- package/dist/src/engine/modifiers/PathModifierPipeline.d.ts +52 -0
- package/dist/src/engine/modifiers/path/CustomModifier.d.ts +14 -0
- package/dist/src/engine/modifiers/path/DashModifier.d.ts +23 -0
- package/dist/src/engine/modifiers/path/ExcalidrawModifier.d.ts +29 -0
- package/dist/src/engine/modifiers/path/OffsetModifier.d.ts +42 -0
- package/dist/src/engine/modifiers/path/PathModifierUtils.d.ts +50 -0
- package/dist/src/engine/modifiers/path/PuckerBloatModifier.d.ts +22 -0
- package/dist/src/engine/modifiers/path/ResampleModifier.d.ts +23 -0
- package/dist/src/engine/modifiers/path/ReverseModifier.d.ts +10 -0
- package/dist/src/engine/modifiers/path/RoundCornersModifier.d.ts +22 -0
- package/dist/src/engine/modifiers/path/SmoothModifier.d.ts +25 -0
- package/dist/src/engine/modifiers/path/TrimModifier.d.ts +40 -0
- package/dist/src/engine/modifiers/path/TwistModifier.d.ts +28 -0
- package/dist/src/engine/modifiers/path/WiggleModifier.d.ts +52 -0
- package/dist/src/engine/modifiers/path/WobbleModifier.d.ts +132 -0
- package/dist/src/engine/modifiers/path/ZigZagModifier.d.ts +33 -0
- package/dist/src/engine/recorder/OfflineRecorder.d.ts +11 -0
- package/dist/src/engine/recorder/Recorder.d.ts +65 -0
- package/dist/src/engine/render/RenderConfig.d.ts +65 -0
- package/dist/src/engine/render/RenderStateCache.d.ts +39 -0
- package/dist/src/engine/render/RenderTarget.d.ts +141 -0
- package/dist/src/engine/render/Renderer.d.ts +67 -0
- package/dist/src/engine/render/allocator/DirtyBufferTracker.d.ts +70 -0
- package/dist/src/engine/render/allocator/GPUStrokePipeline.d.ts +67 -0
- package/dist/src/engine/render/allocator/GlobalAnalyticalAllocator.d.ts +78 -0
- package/dist/src/engine/render/allocator/GlobalAnalyticalPipeline.d.ts +43 -0
- package/dist/src/engine/render/allocator/GlobalGeometryAllocator.d.ts +140 -0
- package/dist/src/engine/render/allocator/GlobalStateAllocator.d.ts +70 -0
- package/dist/src/engine/render/allocator/MegaDrawBatchManager.d.ts +45 -0
- package/dist/src/engine/render/features/CoreFeatures.d.ts +28 -0
- package/dist/src/engine/render/frame_graph/FrameGraph.d.ts +30 -0
- package/dist/src/engine/render/frame_graph/GraphBuilder.d.ts +11 -0
- package/dist/src/engine/render/frame_graph/Pass.d.ts +27 -0
- package/dist/src/engine/render/frame_graph/RenderContext.d.ts +13 -0
- package/dist/src/engine/render/frame_graph/Resource.d.ts +70 -0
- package/dist/src/engine/render/frame_graph/ResourcePool.d.ts +14 -0
- package/dist/src/engine/render/passes/AntiAliasingPass.d.ts +25 -0
- package/dist/src/engine/render/passes/BlurPass.d.ts +49 -0
- package/dist/src/engine/render/passes/ComputeUpdate.d.ts +8 -0
- package/dist/src/engine/render/passes/CreateTexturePass.d.ts +14 -0
- package/dist/src/engine/render/passes/CustomComputePass.d.ts +14 -0
- package/dist/src/engine/render/passes/FeedbackPass.d.ts +39 -0
- package/dist/src/engine/render/passes/OffscreenRenderPass.d.ts +49 -0
- package/dist/src/engine/render/passes/PPLLCompositePass.d.ts +13 -0
- package/dist/src/engine/render/passes/PPLLPreparePass.d.ts +12 -0
- package/dist/src/engine/render/passes/PersistentRenderTexture.d.ts +53 -0
- package/dist/src/engine/render/passes/PostProcessPass.d.ts +17 -0
- package/dist/src/engine/render/passes/PresentPass.d.ts +12 -0
- package/dist/src/engine/render/passes/RaytracePasses.d.ts +42 -0
- package/dist/src/engine/render/passes/RenderPass.d.ts +33 -0
- package/dist/src/engine/render/passes/ShadowPass.d.ts +19 -0
- package/dist/src/engine/render/passes/denoisers/OIDNDenoisePass.d.ts +28 -0
- package/dist/src/engine/render/passes/denoisers/SpatialDenoisePass.d.ts +12 -0
- package/dist/src/engine/render/pipelines/PipeLineDescriptors.d.ts +56 -0
- package/dist/src/engine/render/pipelines/Pipeline.d.ts +27 -0
- package/dist/src/engine/render/pipelines/ResourceLayouts.d.ts +37 -0
- package/dist/src/engine/render/pipelines/WGSLReflector.d.ts +25 -0
- package/dist/src/engine/render/ppll_oit/PPLLManager.d.ts +25 -0
- package/dist/src/engine/render/ppll_oit/PPLLManagerGlobal.d.ts +17 -0
- package/dist/src/engine/render/ppll_oit/PPLLManagerLocal.d.ts +12 -0
- package/dist/src/engine/render/raytrace/BVHBuilder.d.ts +13 -0
- package/dist/src/engine/render/raytrace/GPUArena.d.ts +22 -0
- package/dist/src/engine/render/raytrace/RaytraceManager.d.ts +36 -0
- package/dist/src/engine/render/raytrace/RaytraceShaders.d.ts +5 -0
- package/dist/src/engine/render/shader_system/ChunkRegistry.d.ts +25 -0
- package/dist/src/engine/render/shader_system/Domains.d.ts +12 -0
- package/dist/src/engine/render/shader_system/PipelineCache.d.ts +20 -0
- package/dist/src/engine/render/shader_system/ShaderBuilder.d.ts +61 -0
- package/dist/src/engine/render/shader_system/schemas/Schemas.d.ts +2 -0
- package/dist/src/engine/render/shader_system/schemas/ShaderTypes.d.ts +54 -0
- package/dist/src/engine/render/shader_system/schemas/UniformSchema.d.ts +36 -0
- package/dist/src/engine/render/shader_system/schemas/VaryingSchema.d.ts +15 -0
- package/dist/src/engine/render/shader_system/schemas/VertexSchema.d.ts +9 -0
- package/dist/src/engine/render/targets/ComputeStorageTexture.d.ts +22 -0
- package/dist/src/engine/render/targets/GBufferRenderTarget.d.ts +33 -0
- package/dist/src/engine/render/targets/PingPongRenderTarget.d.ts +34 -0
- package/dist/src/engine/style/excalidraw/Excalidraw.d.ts +117 -0
- package/dist/src/engine/style/excalidraw/ExcalidrawAnimation.d.ts +27 -0
- package/dist/src/engine/style/excalidraw/ExcalidrawTypes.d.ts +102 -0
- package/dist/src/engine/style/excalidraw/HachureGenerator.d.ts +85 -0
- package/dist/src/engine/style/excalidraw/index.d.ts +4 -0
- package/dist/src/engine/utils/Builder.d.ts +74 -0
- package/dist/src/engine/utils/Builder3D.d.ts +50 -0
- package/dist/src/engine/utils/CurveSampleUtils.d.ts +61 -0
- package/dist/src/engine/utils/CurveUtil.d.ts +39 -0
- package/dist/src/engine/utils/GeometrySnapshot.d.ts +17 -0
- package/dist/src/engine/utils/MarchingSquares.d.ts +10 -0
- package/dist/src/engine/utils/OBJLoader.d.ts +15 -0
- package/dist/src/engine/utils/PathEqualizer.d.ts +37 -0
- package/dist/src/engine/utils/PathGeometryUtils.d.ts +61 -0
- package/dist/src/engine/utils/PathTriangulator.d.ts +128 -0
- package/dist/src/engine/utils/Raycaster.d.ts +48 -0
- package/dist/src/engine/utils/RealTime.d.ts +16 -0
- package/dist/src/engine/utils/ShapeMatcher.d.ts +21 -0
- package/dist/src/engine/utils/SubdivisionEngine.d.ts +63 -0
- package/dist/src/engine/utils/Utility.d.ts +51 -0
- package/dist/src/engine/utils/gpu_utils.d.ts +80 -0
- package/dist/src/index.d.ts +438 -0
- package/dist/src/main.d.ts +5 -0
- package/dist/src/plugins/OutlinePlugin.d.ts +36 -0
- package/package.json +117 -6
- package/readme.md +145 -0
- package/README.md +0 -3
package/bin/lint.js
ADDED
|
@@ -0,0 +1,354 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
// =========================================================================
|
|
4
|
+
// File: bin/lint.js - Retiam Agent-Native Scene Linter & Static Analyzer
|
|
5
|
+
// =========================================================================
|
|
6
|
+
|
|
7
|
+
import fs from 'fs';
|
|
8
|
+
import path from 'path';
|
|
9
|
+
import ts from 'typescript';
|
|
10
|
+
|
|
11
|
+
const args = process.argv.slice(2);
|
|
12
|
+
let targetFile = null;
|
|
13
|
+
let jsonOutput = false;
|
|
14
|
+
|
|
15
|
+
const isHelp = args.includes('--help') || args.includes('-h') || args.includes('help');
|
|
16
|
+
if (isHelp) {
|
|
17
|
+
console.log(`
|
|
18
|
+
š Retiam WebGPU Engine - Scene Linter & Static Analyzer
|
|
19
|
+
|
|
20
|
+
Usage:
|
|
21
|
+
npx retiam lint <path/to/Scene.ts> [options]
|
|
22
|
+
|
|
23
|
+
Arguments:
|
|
24
|
+
<file> Target scene file to statically analyze (e.g. src/scenes/AStarScene.ts)
|
|
25
|
+
|
|
26
|
+
Options:
|
|
27
|
+
--json Output structured machine-readable JSON for agents and CI
|
|
28
|
+
--help, -h Show this help message and exit
|
|
29
|
+
|
|
30
|
+
Checks:
|
|
31
|
+
- Validates Scene class structure and async run() contract
|
|
32
|
+
- Detects un-awaited this.play() or this.wait() timing races
|
|
33
|
+
- Warns about dangling entities not attached to scene graph
|
|
34
|
+
- Catches Three.js / Python Manim hallucinations
|
|
35
|
+
- Flags extreme world coordinates exceeding standard camera frustum
|
|
36
|
+
|
|
37
|
+
Examples:
|
|
38
|
+
npx retiam lint src/scenes/AStarScene.ts
|
|
39
|
+
npx retiam lint src/scenes/AStarScene.ts --json
|
|
40
|
+
`);
|
|
41
|
+
process.exit(0);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
for (let i = 0; i < args.length; i++) {
|
|
45
|
+
if (args[i] === '--json') {
|
|
46
|
+
jsonOutput = true;
|
|
47
|
+
} else if (!args[i].startsWith('-') && !targetFile) {
|
|
48
|
+
targetFile = args[i];
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
if (!targetFile) {
|
|
53
|
+
if (jsonOutput) {
|
|
54
|
+
console.log(JSON.stringify({ status: 'error', message: 'No target scene file specified.' }));
|
|
55
|
+
} else {
|
|
56
|
+
console.error('ā Error: No target scene file specified.');
|
|
57
|
+
console.log('Usage: npx retiam lint <path/to/Scene.ts> [--json]');
|
|
58
|
+
}
|
|
59
|
+
process.exit(1);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const resolvedPath = path.resolve(process.cwd(), targetFile);
|
|
63
|
+
if (!fs.existsSync(resolvedPath)) {
|
|
64
|
+
if (jsonOutput) {
|
|
65
|
+
console.log(JSON.stringify({ status: 'error', message: `File not found: ${targetFile}` }));
|
|
66
|
+
} else {
|
|
67
|
+
console.error(`ā Error: File not found: ${resolvedPath}`);
|
|
68
|
+
}
|
|
69
|
+
process.exit(1);
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const sourceCode = fs.readFileSync(resolvedPath, 'utf8');
|
|
73
|
+
const sourceFile = ts.createSourceFile(
|
|
74
|
+
resolvedPath,
|
|
75
|
+
sourceCode,
|
|
76
|
+
ts.ScriptTarget.Latest,
|
|
77
|
+
true
|
|
78
|
+
);
|
|
79
|
+
|
|
80
|
+
const diagnostics = [];
|
|
81
|
+
const lines = sourceCode.split('\n');
|
|
82
|
+
|
|
83
|
+
function addDiagnostic(type, rule, line, col, message, suggestion, codeSnippet) {
|
|
84
|
+
diagnostics.push({
|
|
85
|
+
type, // 'error' | 'warning'
|
|
86
|
+
rule,
|
|
87
|
+
line,
|
|
88
|
+
col,
|
|
89
|
+
message,
|
|
90
|
+
suggestion,
|
|
91
|
+
codeSnippet: codeSnippet || (lines[line - 1] ? lines[line - 1].trim() : '')
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
function getLineAndCol(node) {
|
|
96
|
+
const { line, character } = sourceFile.getLineAndCharacterOfPosition(node.getStart());
|
|
97
|
+
return { line: line + 1, col: character + 1 };
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
// Known Retiam Entity classes
|
|
101
|
+
const ENTITY_CLASSES = new Set([
|
|
102
|
+
'Circle', 'Rect', 'Line', 'Arrow', 'Polygon', 'RegularPolygon',
|
|
103
|
+
'Arc', 'Sector', 'Annulus', 'Dot', 'GlowDot', 'Path', 'SVGShape', 'SVG',
|
|
104
|
+
'SDFText', 'Tex', 'Code', 'Axes', 'NumberLine', 'Graph', 'BarChart',
|
|
105
|
+
'PieChart', 'Model', 'Sphere', 'Box3D', 'Cylinder', 'Cone', 'Plane',
|
|
106
|
+
'Mesh', 'MorphModel', 'TracePath', 'VBox', 'HBox', 'Group'
|
|
107
|
+
]);
|
|
108
|
+
|
|
109
|
+
// Track instantiated entities to check if they are added
|
|
110
|
+
const instantiatedEntities = new Map(); // name -> { line, col, className }
|
|
111
|
+
const referencedIdentifiers = new Set();
|
|
112
|
+
let hasSceneClass = false;
|
|
113
|
+
let hasRunMethod = false;
|
|
114
|
+
let hasCameraSetup = false;
|
|
115
|
+
|
|
116
|
+
function checkNode(node) {
|
|
117
|
+
// 1. Check for Scene Class & run() method
|
|
118
|
+
if (ts.isClassDeclaration(node)) {
|
|
119
|
+
if (node.heritageClauses) {
|
|
120
|
+
for (const clause of node.heritageClauses) {
|
|
121
|
+
if (clause.token === ts.SyntaxKind.ExtendsKeyword) {
|
|
122
|
+
for (const type of clause.types) {
|
|
123
|
+
if (type.expression.getText(sourceFile) === 'Scene') {
|
|
124
|
+
hasSceneClass = true;
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
// Check for run() method
|
|
132
|
+
for (const member of node.members) {
|
|
133
|
+
if (ts.isMethodDeclaration(member)) {
|
|
134
|
+
const name = member.name.getText(sourceFile);
|
|
135
|
+
if (name === 'run') {
|
|
136
|
+
hasRunMethod = true;
|
|
137
|
+
const isAsync = member.modifiers && member.modifiers.some(m => m.kind === ts.SyntaxKind.AsyncKeyword);
|
|
138
|
+
if (!isAsync) {
|
|
139
|
+
const { line, col } = getLineAndCol(member);
|
|
140
|
+
addDiagnostic('error', 'retiam/async-run-required', line, col,
|
|
141
|
+
'The run() method of a Scene must be async.',
|
|
142
|
+
'Change signature to: public async run(): Promise<void>'
|
|
143
|
+
);
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
// 2. Check for missing await on this.play() or this.wait()
|
|
151
|
+
if (ts.isCallExpression(node)) {
|
|
152
|
+
const exprText = node.expression.getText(sourceFile);
|
|
153
|
+
const isPlayCall = exprText === 'this.play' || exprText === 'scene.play' || exprText.endsWith('.play');
|
|
154
|
+
const isWaitCall = exprText === 'this.wait' || exprText === 'scene.wait' || exprText.endsWith('.wait');
|
|
155
|
+
|
|
156
|
+
if (isPlayCall || isWaitCall) {
|
|
157
|
+
// Check if parent is an AwaitExpression
|
|
158
|
+
let parent = node.parent;
|
|
159
|
+
// Handle parentheses or expressions
|
|
160
|
+
while (parent && ts.isParenthesizedExpression(parent)) {
|
|
161
|
+
parent = parent.parent;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
if (!parent || !ts.isAwaitExpression(parent)) {
|
|
165
|
+
// If it's part of a Promise.all or array, it might be fine, but standalone call without await causes sync race
|
|
166
|
+
const isInPromiseAll = parent && ts.isArrayLiteralExpression(parent) && parent.parent &&
|
|
167
|
+
ts.isCallExpression(parent.parent) && parent.parent.expression.getText(sourceFile).includes('Promise.all');
|
|
168
|
+
|
|
169
|
+
if (!isInPromiseAll) {
|
|
170
|
+
const { line, col } = getLineAndCol(node);
|
|
171
|
+
const callName = isPlayCall ? 'play()' : 'wait()';
|
|
172
|
+
addDiagnostic(
|
|
173
|
+
'error',
|
|
174
|
+
'retiam/missing-await',
|
|
175
|
+
line,
|
|
176
|
+
col,
|
|
177
|
+
`Calling ${callName} without 'await'. Animation steps will execute concurrently out of sequence.`,
|
|
178
|
+
`Add 'await' before ${node.getText(sourceFile)}`,
|
|
179
|
+
node.getText(sourceFile)
|
|
180
|
+
);
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
// Check camera setup
|
|
186
|
+
if (exprText.includes('camera.position') || exprText.includes('this.camera')) {
|
|
187
|
+
hasCameraSetup = true;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
// Track entities added to scene or containers
|
|
191
|
+
if (exprText === 'this.add' || exprText === 'scene.add' || exprText.endsWith('.add') || exprText.endsWith('.append')) {
|
|
192
|
+
for (const arg of node.arguments) {
|
|
193
|
+
referencedIdentifiers.add(arg.getText(sourceFile));
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
// 3. Track variable assignments with `new EntityClass(...)`
|
|
199
|
+
if (ts.isVariableDeclaration(node) && node.initializer && ts.isNewExpression(node.initializer)) {
|
|
200
|
+
const className = node.initializer.expression.getText(sourceFile);
|
|
201
|
+
if (ENTITY_CLASSES.has(className) && ts.isIdentifier(node.name)) {
|
|
202
|
+
const varName = node.name.text;
|
|
203
|
+
const { line, col } = getLineAndCol(node);
|
|
204
|
+
instantiatedEntities.set(varName, { line, col, className });
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
// 4. Check for Three.js or Python Manim hallucinations
|
|
209
|
+
if (ts.isIdentifier(node)) {
|
|
210
|
+
const text = node.text;
|
|
211
|
+
if (text === 'THREE') {
|
|
212
|
+
const { line, col } = getLineAndCol(node);
|
|
213
|
+
addDiagnostic(
|
|
214
|
+
'error',
|
|
215
|
+
'retiam/no-threejs',
|
|
216
|
+
line,
|
|
217
|
+
col,
|
|
218
|
+
'Detected Three.js reference. Retiam uses native WebGPU entities (e.g. Model, Sphere, Box3D).',
|
|
219
|
+
'Use Retiam 3D primitives: import { Model, Sphere, Box3D } from "retiam"'
|
|
220
|
+
);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
// 5. Check for extreme coordinates in Vector arrays: e.g. [150, 200, 0]
|
|
225
|
+
if (ts.isArrayLiteralExpression(node) && node.elements.length >= 2 && node.elements.length <= 4) {
|
|
226
|
+
const parentExpr = node.parent ? node.parent.getText(sourceFile) : '';
|
|
227
|
+
if (parentExpr.includes('position') || parentExpr.includes('shift') || parentExpr.includes('set')) {
|
|
228
|
+
for (const elem of node.elements) {
|
|
229
|
+
if (ts.isNumericLiteral(elem)) {
|
|
230
|
+
const val = parseFloat(elem.text);
|
|
231
|
+
if (Math.abs(val) > 40) {
|
|
232
|
+
const { line, col } = getLineAndCol(elem);
|
|
233
|
+
addDiagnostic(
|
|
234
|
+
'warning',
|
|
235
|
+
'retiam/extreme-coordinate',
|
|
236
|
+
line,
|
|
237
|
+
col,
|
|
238
|
+
`Coordinate value ${val} is very large. Standard Retiam camera view is typically between -10 and 10 world units.`,
|
|
239
|
+
'Verify camera distance or use auto-layout/nextTo for positioning.'
|
|
240
|
+
);
|
|
241
|
+
break;
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
// Continue recursive AST traversal
|
|
249
|
+
ts.forEachChild(node, checkNode);
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
// Traverse the AST
|
|
253
|
+
checkNode(sourceFile);
|
|
254
|
+
|
|
255
|
+
// Check if instantiated entities were ever added to the scene graph
|
|
256
|
+
for (const [varName, info] of instantiatedEntities.entries()) {
|
|
257
|
+
// If not referenced in an .add() call or as child
|
|
258
|
+
if (!referencedIdentifiers.has(varName)) {
|
|
259
|
+
// Also check if used in animations like `new Create(circle)`
|
|
260
|
+
const regex = new RegExp(`\\b${varName}\\b`, 'g');
|
|
261
|
+
const matches = (sourceCode.match(regex) || []).length;
|
|
262
|
+
// If it only appeared once (the declaration) or twice without being in this.add
|
|
263
|
+
if (matches <= 2) {
|
|
264
|
+
addDiagnostic(
|
|
265
|
+
'warning',
|
|
266
|
+
'retiam/dangling-entity',
|
|
267
|
+
info.line,
|
|
268
|
+
info.col,
|
|
269
|
+
`Entity '${varName}' (${info.className}) is created but might not be added to the scene.`,
|
|
270
|
+
`Ensure you call 'this.add(${varName})' or add it to a container (VBox/HBox).`
|
|
271
|
+
);
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
// Check Scene class presence
|
|
277
|
+
if (!hasSceneClass) {
|
|
278
|
+
addDiagnostic(
|
|
279
|
+
'error',
|
|
280
|
+
'retiam/missing-scene-class',
|
|
281
|
+
1,
|
|
282
|
+
1,
|
|
283
|
+
'No class extending "Scene" found in file.',
|
|
284
|
+
'Export a Scene class: export default class MyScene extends Scene { ... }'
|
|
285
|
+
);
|
|
286
|
+
} else if (!hasRunMethod) {
|
|
287
|
+
addDiagnostic(
|
|
288
|
+
'error',
|
|
289
|
+
'retiam/missing-run-method',
|
|
290
|
+
1,
|
|
291
|
+
1,
|
|
292
|
+
'The Scene class does not implement a run() method.',
|
|
293
|
+
'Implement: public async run(): Promise<void> { ... }'
|
|
294
|
+
);
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
if (!hasCameraSetup && hasSceneClass) {
|
|
298
|
+
addDiagnostic(
|
|
299
|
+
'warning',
|
|
300
|
+
'retiam/no-camera-setup',
|
|
301
|
+
1,
|
|
302
|
+
1,
|
|
303
|
+
'No camera position configuration detected in the scene.',
|
|
304
|
+
'Initialize camera: this.camera.position.set([0, 0, 14]);'
|
|
305
|
+
);
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
// Compute results
|
|
309
|
+
const errors = diagnostics.filter(d => d.type === 'error');
|
|
310
|
+
const warnings = diagnostics.filter(d => d.type === 'warning');
|
|
311
|
+
const isValid = errors.length === 0;
|
|
312
|
+
|
|
313
|
+
if (jsonOutput) {
|
|
314
|
+
const result = {
|
|
315
|
+
file: targetFile,
|
|
316
|
+
valid: isValid,
|
|
317
|
+
summary: {
|
|
318
|
+
errors: errors.length,
|
|
319
|
+
warnings: warnings.length,
|
|
320
|
+
total: diagnostics.length
|
|
321
|
+
},
|
|
322
|
+
diagnostics
|
|
323
|
+
};
|
|
324
|
+
console.log(JSON.stringify(result, null, 2));
|
|
325
|
+
} else {
|
|
326
|
+
console.log(`\nš Retiam Scene Linter: ${targetFile}`);
|
|
327
|
+
console.log('='.repeat(60));
|
|
328
|
+
|
|
329
|
+
if (diagnostics.length === 0) {
|
|
330
|
+
console.log('ā
All checks passed! Scene is syntactically and structurally sound.\n');
|
|
331
|
+
} else {
|
|
332
|
+
for (const diag of diagnostics) {
|
|
333
|
+
const icon = diag.type === 'error' ? 'ā [ERROR]' : 'ā ļø [WARN]';
|
|
334
|
+
console.log(`\n${icon} Line ${diag.line}:${diag.col} (${diag.rule})`);
|
|
335
|
+
console.log(` Message: ${diag.message}`);
|
|
336
|
+
if (diag.codeSnippet) {
|
|
337
|
+
console.log(` Snippet: ${diag.codeSnippet}`);
|
|
338
|
+
}
|
|
339
|
+
if (diag.suggestion) {
|
|
340
|
+
console.log(` š” Fix: ${diag.suggestion}`);
|
|
341
|
+
}
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
console.log('\n' + '-'.repeat(60));
|
|
345
|
+
console.log(`Found ${errors.length} error(s), ${warnings.length} warning(s).`);
|
|
346
|
+
if (!isValid) {
|
|
347
|
+
console.log('ā Scene has critical errors that may prevent proper animation playback.\n');
|
|
348
|
+
} else {
|
|
349
|
+
console.log('⨠No critical errors found. Please review the warnings above.\n');
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
process.exit(isValid ? 0 : 1);
|