af-motion 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/CHANGELOG.md +33 -0
- package/LICENSE +201 -0
- package/README.md +203 -3
- package/RELEASE_NOTES.md +115 -0
- package/bin/af-motion.js +16 -0
- package/bin/mcp-server.js +21 -0
- package/dist/3d/adapter.d.ts +29 -0
- package/dist/3d/assets/cache.d.ts +71 -0
- package/dist/3d/assets/index.d.ts +10 -0
- package/dist/3d/assets/inspection.d.ts +19 -0
- package/dist/3d/assets/loaders.d.ts +30 -0
- package/dist/3d/assets/manager.d.ts +69 -0
- package/dist/3d/assets/scene-integration.d.ts +23 -0
- package/dist/3d/assets/types.d.ts +80 -0
- package/dist/3d/assets/validation.d.ts +12 -0
- package/dist/3d/camera/index.d.ts +7 -0
- package/dist/3d/camera/presets.d.ts +8 -0
- package/dist/3d/camera/transitions.d.ts +19 -0
- package/dist/3d/camera/types.d.ts +37 -0
- package/dist/3d/camera/validation.d.ts +9 -0
- package/dist/3d/capabilities.d.ts +11 -0
- package/dist/3d/composition/fallback.d.ts +20 -0
- package/dist/3d/composition/generation.d.ts +24 -0
- package/dist/3d/composition/index.d.ts +12 -0
- package/dist/3d/composition/quality.d.ts +35 -0
- package/dist/3d/composition/recipes.d.ts +34 -0
- package/dist/3d/composition/types.d.ts +88 -0
- package/dist/3d/composition/unified.d.ts +18 -0
- package/dist/3d/environment/index.d.ts +6 -0
- package/dist/3d/environment/presets.d.ts +8 -0
- package/dist/3d/environment/types.d.ts +36 -0
- package/dist/3d/environment/validation.d.ts +9 -0
- package/dist/3d/geometry/cache.d.ts +37 -0
- package/dist/3d/geometry/generators.d.ts +24 -0
- package/dist/3d/geometry/hash.d.ts +10 -0
- package/dist/3d/geometry/index.d.ts +9 -0
- package/dist/3d/geometry/three-adapter.d.ts +15 -0
- package/dist/3d/geometry/types.d.ts +120 -0
- package/dist/3d/geometry/validation.d.ts +6 -0
- package/dist/3d/index.d.ts +32 -0
- package/dist/3d/interaction/camera-controls.d.ts +58 -0
- package/dist/3d/interaction/index.d.ts +8 -0
- package/dist/3d/interaction/manager.d.ts +61 -0
- package/dist/3d/interaction/presets.d.ts +9 -0
- package/dist/3d/interaction/raycaster.d.ts +20 -0
- package/dist/3d/interaction/types.d.ts +78 -0
- package/dist/3d/lighting/index.d.ts +6 -0
- package/dist/3d/lighting/presets.d.ts +8 -0
- package/dist/3d/lighting/types.d.ts +31 -0
- package/dist/3d/lighting/validation.d.ts +17 -0
- package/dist/3d/materials/bridge.d.ts +11 -0
- package/dist/3d/materials/index.d.ts +7 -0
- package/dist/3d/materials/presets.d.ts +9 -0
- package/dist/3d/materials/types.d.ts +43 -0
- package/dist/3d/materials/validation.d.ts +9 -0
- package/dist/3d/morphing/animator.d.ts +19 -0
- package/dist/3d/morphing/correspondence.d.ts +32 -0
- package/dist/3d/morphing/geometry.d.ts +28 -0
- package/dist/3d/morphing/index.d.ts +16 -0
- package/dist/3d/morphing/interpolation.d.ts +45 -0
- package/dist/3d/morphing/morph.d.ts +18 -0
- package/dist/3d/morphing/presets.d.ts +31 -0
- package/dist/3d/morphing/react.d.ts +29 -0
- package/dist/3d/morphing/topology.d.ts +34 -0
- package/dist/3d/morphing/types.d.ts +138 -0
- package/dist/3d/morphing/validation.d.ts +19 -0
- package/dist/3d/optimization/analysis.d.ts +14 -0
- package/dist/3d/optimization/colliders.d.ts +16 -0
- package/dist/3d/optimization/geometry.d.ts +22 -0
- package/dist/3d/optimization/hierarchy.d.ts +14 -0
- package/dist/3d/optimization/index.d.ts +33 -0
- package/dist/3d/optimization/lod.d.ts +13 -0
- package/dist/3d/optimization/materials.d.ts +12 -0
- package/dist/3d/optimization/recommendations.d.ts +13 -0
- package/dist/3d/optimization/skeleton.d.ts +20 -0
- package/dist/3d/optimization/types.d.ts +252 -0
- package/dist/3d/physics/benchmark.d.ts +76 -0
- package/dist/3d/physics/body/inertia.d.ts +61 -0
- package/dist/3d/physics/collision/ccd.d.ts +26 -0
- package/dist/3d/physics/collision/narrowphase.d.ts +15 -0
- package/dist/3d/physics/collision/shapes.d.ts +45 -0
- package/dist/3d/physics/constraints/advanced.d.ts +40 -0
- package/dist/3d/physics/constraints/solver.d.ts +34 -0
- package/dist/3d/physics/constraints/types.d.ts +106 -0
- package/dist/3d/physics/events.d.ts +34 -0
- package/dist/3d/physics/index.d.ts +29 -0
- package/dist/3d/physics/material.d.ts +27 -0
- package/dist/3d/physics/math.d.ts +79 -0
- package/dist/3d/physics/soft/cloth.d.ts +12 -0
- package/dist/3d/physics/soft/collision.d.ts +12 -0
- package/dist/3d/physics/soft/gpu.d.ts +19 -0
- package/dist/3d/physics/soft/pbd.d.ts +20 -0
- package/dist/3d/physics/soft/rope.d.ts +16 -0
- package/dist/3d/physics/soft/soft-body.d.ts +12 -0
- package/dist/3d/physics/soft/types.d.ts +212 -0
- package/dist/3d/physics/solver/integrators.d.ts +25 -0
- package/dist/3d/physics/solver/types.d.ts +28 -0
- package/dist/3d/physics/spatial/spatial-hash.d.ts +51 -0
- package/dist/3d/physics/types.d.ts +579 -0
- package/dist/3d/physics/world.d.ts +106 -0
- package/dist/3d/r3f.d.ts +34 -0
- package/dist/3d/scene.d.ts +8 -0
- package/dist/3d/schema.d.ts +739 -0
- package/dist/3d/schemas/ai-integration.d.ts +201 -0
- package/dist/3d/schemas/correction.d.ts +11 -0
- package/dist/3d/schemas/index.d.ts +12 -0
- package/dist/3d/schemas/schemas.d.ts +361 -0
- package/dist/3d/schemas/serialization.d.ts +22 -0
- package/dist/3d/schemas/types.d.ts +199 -0
- package/dist/3d/schemas/validation.d.ts +33 -0
- package/dist/3d/scroll/controller.d.ts +32 -0
- package/dist/3d/scroll/index.d.ts +6 -0
- package/dist/3d/scroll/presets.d.ts +9 -0
- package/dist/3d/scroll/types.d.ts +53 -0
- package/dist/3d/terrain/biomes.d.ts +18 -0
- package/dist/3d/terrain/chunks.d.ts +20 -0
- package/dist/3d/terrain/erosion.d.ts +15 -0
- package/dist/3d/terrain/heightmap.d.ts +27 -0
- package/dist/3d/terrain/index.d.ts +18 -0
- package/dist/3d/terrain/materials.d.ts +20 -0
- package/dist/3d/terrain/noise.d.ts +25 -0
- package/dist/3d/terrain/physics.d.ts +34 -0
- package/dist/3d/terrain/terrain.d.ts +12 -0
- package/dist/3d/terrain/types.d.ts +235 -0
- package/dist/3d/terrain/vegetation.d.ts +14 -0
- package/dist/3d/types.d.ts +176 -0
- package/dist/3d/world/hydrology.d.ts +12 -0
- package/dist/3d/world/index.d.ts +15 -0
- package/dist/3d/world/lighting.d.ts +16 -0
- package/dist/3d/world/pipeline.d.ts +20 -0
- package/dist/3d/world/population.d.ts +12 -0
- package/dist/3d/world/presets.d.ts +11 -0
- package/dist/3d/world/streaming.d.ts +13 -0
- package/dist/3d/world/types.d.ts +272 -0
- package/dist/3d/world/world.d.ts +64 -0
- package/dist/backgrounds/advanced-gradient.d.ts +32 -0
- package/dist/backgrounds/atmospheric-backgrounds.d.ts +79 -0
- package/dist/backgrounds/aurora.d.ts +24 -0
- package/dist/backgrounds/cosmic-background.d.ts +31 -0
- package/dist/backgrounds/energy-effects.d.ts +78 -0
- package/dist/backgrounds/floating-orbs.d.ts +26 -0
- package/dist/backgrounds/fluid-backgrounds.d.ts +72 -0
- package/dist/backgrounds/geometric-backgrounds.d.ts +78 -0
- package/dist/backgrounds/gradient.d.ts +20 -0
- package/dist/backgrounds/grid.d.ts +22 -0
- package/dist/backgrounds/internal/canvas-lifecycle.d.ts +29 -0
- package/dist/backgrounds/noise.d.ts +20 -0
- package/dist/backgrounds/particle-background.d.ts +37 -0
- package/dist/backgrounds/particle-field.d.ts +22 -0
- package/dist/backgrounds/spotlight.d.ts +20 -0
- package/dist/backgrounds/wave.d.ts +22 -0
- package/dist/catalogue.d.ts +227 -0
- package/dist/catalogue.js +4 -0
- package/dist/chunks/catalogue-ZmbeEdRo.js +59850 -0
- package/dist/chunks/core-animation-CeiI_TEe.js +1394 -0
- package/dist/chunks/motion-choreography-DC6LWvDk.js +4089 -0
- package/dist/chunks/pointer-capture-lrnKAl2I.js +158 -0
- package/dist/chunks/safe-json-D5j34GEB.js +62 -0
- package/dist/chunks/scroll-velocity-BNUHaS0-.js +904 -0
- package/dist/cli/commands/doctor.d.ts +9 -0
- package/dist/cli/commands/example.d.ts +9 -0
- package/dist/cli/commands/info.d.ts +8 -0
- package/dist/cli/commands/init.d.ts +9 -0
- package/dist/cli/commands/presets.d.ts +10 -0
- package/dist/cli/commands/validate.d.ts +9 -0
- package/dist/cli/index.d.ts +22 -0
- package/dist/cli/types.d.ts +115 -0
- package/dist/cli/utils/safety.d.ts +11 -0
- package/dist/cli/utils/templates.d.ts +16 -0
- package/dist/cli/utils/terminal.d.ts +29 -0
- package/dist/cli.js +825 -0
- package/dist/core/adaptive-motion.d.ts +100 -0
- package/dist/core/adaptive-quality/controller.d.ts +61 -0
- package/dist/core/adaptive-quality/index.d.ts +13 -0
- package/dist/core/adaptive-quality/metrics.d.ts +33 -0
- package/dist/core/adaptive-quality/policies.d.ts +40 -0
- package/dist/core/adaptive-quality/profile.d.ts +58 -0
- package/dist/core/adaptive-quality/react.d.ts +57 -0
- package/dist/core/adaptive-quality/recommendation.d.ts +12 -0
- package/dist/core/adaptive-quality/resolution.d.ts +22 -0
- package/dist/core/adaptive-quality/types.d.ts +362 -0
- package/dist/core/advanced-motion/adapters.d.ts +20 -0
- package/dist/core/advanced-motion/controller.d.ts +52 -0
- package/dist/core/advanced-motion/index.d.ts +12 -0
- package/dist/core/advanced-motion/recipes.d.ts +16 -0
- package/dist/core/advanced-motion/timeline.d.ts +35 -0
- package/dist/core/advanced-motion/types.d.ts +174 -0
- package/dist/core/advanced-motion/validation.d.ts +11 -0
- package/dist/core/agent-workflows/agent-registry.d.ts +21 -0
- package/dist/core/agent-workflows/agents/accessibility-agent.d.ts +9 -0
- package/dist/core/agent-workflows/agents/composition-agent.d.ts +9 -0
- package/dist/core/agent-workflows/agents/design-to-motion-agent.d.ts +9 -0
- package/dist/core/agent-workflows/agents/index.d.ts +13 -0
- package/dist/core/agent-workflows/agents/motion-intelligence-agent.d.ts +9 -0
- package/dist/core/agent-workflows/agents/performance-agent.d.ts +9 -0
- package/dist/core/agent-workflows/agents/scene-generation-agent.d.ts +9 -0
- package/dist/core/agent-workflows/collaboration-planner.d.ts +38 -0
- package/dist/core/agent-workflows/collaboration-workflows.d.ts +83 -0
- package/dist/core/agent-workflows/communication.d.ts +29 -0
- package/dist/core/agent-workflows/conflict-resolver.d.ts +25 -0
- package/dist/core/agent-workflows/context.d.ts +36 -0
- package/dist/core/agent-workflows/execution-engine.d.ts +30 -0
- package/dist/core/agent-workflows/index.d.ts +20 -0
- package/dist/core/agent-workflows/orchestration-types.d.ts +144 -0
- package/dist/core/agent-workflows/orchestrator.d.ts +29 -0
- package/dist/core/agent-workflows/react.d.ts +71 -0
- package/dist/core/agent-workflows/shared-context.d.ts +36 -0
- package/dist/core/agent-workflows/task-planner.d.ts +42 -0
- package/dist/core/agent-workflows/templates.d.ts +14 -0
- package/dist/core/agent-workflows/tool-registry.d.ts +24 -0
- package/dist/core/agent-workflows/types.d.ts +167 -0
- package/dist/core/ai-ecosystem/capability-registry.d.ts +23 -0
- package/dist/core/ai-ecosystem/index.d.ts +13 -0
- package/dist/core/ai-ecosystem/pipeline.d.ts +19 -0
- package/dist/core/ai-ecosystem/provider.d.ts +19 -0
- package/dist/core/ai-ecosystem/types.d.ts +69 -0
- package/dist/core/ai-motion-intelligence/engine.d.ts +51 -0
- package/dist/core/ai-motion-intelligence/explanation-engine.d.ts +8 -0
- package/dist/core/ai-motion-intelligence/index.d.ts +15 -0
- package/dist/core/ai-motion-intelligence/intent-classifier.d.ts +14 -0
- package/dist/core/ai-motion-intelligence/knowledge-base.d.ts +12 -0
- package/dist/core/ai-motion-intelligence/provider.d.ts +31 -0
- package/dist/core/ai-motion-intelligence/quality-evaluator.d.ts +9 -0
- package/dist/core/ai-motion-intelligence/react.d.ts +14 -0
- package/dist/core/ai-motion-intelligence/recommendation-engine.d.ts +16 -0
- package/dist/core/ai-motion-intelligence/types.d.ts +134 -0
- package/dist/core/ai-motion-registry.d.ts +201 -0
- package/dist/core/animate.d.ts +57 -0
- package/dist/core/animation-intelligence/engine.d.ts +42 -0
- package/dist/core/animation-intelligence/index.d.ts +11 -0
- package/dist/core/animation-intelligence/intent.d.ts +15 -0
- package/dist/core/animation-intelligence/schema.d.ts +42 -0
- package/dist/core/animation-intelligence/scoring.d.ts +15 -0
- package/dist/core/animation-intelligence/types.d.ts +91 -0
- package/dist/core/animation-parallel.d.ts +37 -0
- package/dist/core/animation-presets.d.ts +56 -0
- package/dist/core/animation-sequence.d.ts +37 -0
- package/dist/core/animation-timeline.d.ts +46 -0
- package/dist/core/animation.d.ts +48 -0
- package/dist/core/built-in-palettes.d.ts +331 -0
- package/dist/core/choreography-intelligence/bridge.d.ts +43 -0
- package/dist/core/choreography-intelligence/generator.d.ts +11 -0
- package/dist/core/choreography-intelligence/index.d.ts +11 -0
- package/dist/core/choreography-intelligence/intent.d.ts +11 -0
- package/dist/core/choreography-intelligence/schema.d.ts +76 -0
- package/dist/core/choreography-intelligence/types.d.ts +87 -0
- package/dist/core/composition.d.ts +170 -0
- package/dist/core/configuration-corrector.d.ts +85 -0
- package/dist/core/design-intelligence.d.ts +199 -0
- package/dist/core/design-system.d.ts +206 -0
- package/dist/core/design-to-motion/design-analyzer.d.ts +13 -0
- package/dist/core/design-to-motion/engine.d.ts +34 -0
- package/dist/core/design-to-motion/generator.d.ts +16 -0
- package/dist/core/design-to-motion/index.d.ts +15 -0
- package/dist/core/design-to-motion/input-parser.d.ts +17 -0
- package/dist/core/design-to-motion/motion-planner.d.ts +11 -0
- package/dist/core/design-to-motion/presets.d.ts +11 -0
- package/dist/core/design-to-motion/react.d.ts +13 -0
- package/dist/core/design-to-motion/types.d.ts +221 -0
- package/dist/core/design-to-motion/validator.d.ts +13 -0
- package/dist/core/device-capabilities/classification.d.ts +25 -0
- package/dist/core/device-capabilities/detection.d.ts +27 -0
- package/dist/core/device-capabilities/graphics.d.ts +22 -0
- package/dist/core/device-capabilities/hardware.d.ts +27 -0
- package/dist/core/device-capabilities/index.d.ts +14 -0
- package/dist/core/device-capabilities/monitor.d.ts +19 -0
- package/dist/core/device-capabilities/react.d.ts +24 -0
- package/dist/core/device-capabilities/runtime.d.ts +11 -0
- package/dist/core/device-capabilities/scoring.d.ts +18 -0
- package/dist/core/device-capabilities/types.d.ts +171 -0
- package/dist/core/effect-composer.d.ts +41 -0
- package/dist/core/generation-pipeline.d.ts +135 -0
- package/dist/core/inertia.d.ts +30 -0
- package/dist/core/interactions/cursor-controller.d.ts +9 -0
- package/dist/core/interactions/custom-gestures.d.ts +28 -0
- package/dist/core/interactions/device-capabilities.d.ts +12 -0
- package/dist/core/interactions/drag-controller.d.ts +60 -0
- package/dist/core/interactions/errors.d.ts +13 -0
- package/dist/core/interactions/gesture-classifier.d.ts +43 -0
- package/dist/core/interactions/gesture-intelligence-controller.d.ts +9 -0
- package/dist/core/interactions/gesture-recognizers.d.ts +160 -0
- package/dist/core/interactions/gesture-sequence.d.ts +9 -0
- package/dist/core/interactions/index.d.ts +27 -0
- package/dist/core/interactions/input-normalizer.d.ts +8 -0
- package/dist/core/interactions/interaction-manager.d.ts +43 -0
- package/dist/core/interactions/keyboard-manager.d.ts +16 -0
- package/dist/core/interactions/magnetic-controller.d.ts +9 -0
- package/dist/core/interactions/magnetic-group.d.ts +11 -0
- package/dist/core/interactions/multitouch-controller.d.ts +62 -0
- package/dist/core/interactions/pointer-controller.d.ts +34 -0
- package/dist/core/interactions/pointer-tracker.d.ts +32 -0
- package/dist/core/interactions/prioritizer.d.ts +17 -0
- package/dist/core/interactions/touch-controller.d.ts +35 -0
- package/dist/core/interactions/types.d.ts +710 -0
- package/dist/core/layout/controller.d.ts +56 -0
- package/dist/core/layout/flip.d.ts +21 -0
- package/dist/core/layout/group.d.ts +46 -0
- package/dist/core/layout/index.d.ts +12 -0
- package/dist/core/layout/measure.d.ts +30 -0
- package/dist/core/layout/presets.d.ts +24 -0
- package/dist/core/layout/types.d.ts +189 -0
- package/dist/core/microinteractions/generator.d.ts +11 -0
- package/dist/core/microinteractions/index.d.ts +11 -0
- package/dist/core/microinteractions/intent.d.ts +11 -0
- package/dist/core/microinteractions/runtime.d.ts +25 -0
- package/dist/core/microinteractions/schema.d.ts +82 -0
- package/dist/core/microinteractions/types.d.ts +79 -0
- package/dist/core/motion-choreography.d.ts +163 -0
- package/dist/core/motion-dna.d.ts +129 -0
- package/dist/core/motion-path/animator.d.ts +13 -0
- package/dist/core/motion-path/engine.d.ts +27 -0
- package/dist/core/motion-path/follower.d.ts +8 -0
- package/dist/core/motion-path/index.d.ts +15 -0
- package/dist/core/motion-path/lut.d.ts +33 -0
- package/dist/core/motion-path/parser.d.ts +26 -0
- package/dist/core/motion-path/segments.d.ts +16 -0
- package/dist/core/motion-path/types.d.ts +178 -0
- package/dist/core/motion-path/vector3.d.ts +49 -0
- package/dist/core/motion-recipe.d.ts +171 -0
- package/dist/core/motion-states.d.ts +43 -0
- package/dist/core/motion-validation/consistency.d.ts +11 -0
- package/dist/core/motion-validation/index.d.ts +11 -0
- package/dist/core/motion-validation/optimizer.d.ts +11 -0
- package/dist/core/motion-validation/schema.d.ts +81 -0
- package/dist/core/motion-validation/types.d.ts +53 -0
- package/dist/core/motion-validation/validator.d.ts +11 -0
- package/dist/core/motion.d.ts +7 -0
- package/dist/core/natural-motion.d.ts +110 -0
- package/dist/core/palette-colors.d.ts +16 -0
- package/dist/core/palette-styles.d.ts +12 -0
- package/dist/core/palettes.d.ts +59 -0
- package/dist/core/performance-intelligence/conflicts.d.ts +21 -0
- package/dist/core/performance-intelligence/context.d.ts +48 -0
- package/dist/core/performance-intelligence/coordinator.d.ts +84 -0
- package/dist/core/performance-intelligence/decisions.d.ts +17 -0
- package/dist/core/performance-intelligence/history.d.ts +44 -0
- package/dist/core/performance-intelligence/index.d.ts +15 -0
- package/dist/core/performance-intelligence/policies.d.ts +59 -0
- package/dist/core/performance-intelligence/react.d.ts +78 -0
- package/dist/core/performance-intelligence/report.d.ts +16 -0
- package/dist/core/performance-intelligence/scoring.d.ts +16 -0
- package/dist/core/performance-intelligence/types.d.ts +203 -0
- package/dist/core/performance-optimizer/bottlenecks.d.ts +9 -0
- package/dist/core/performance-optimizer/index.d.ts +13 -0
- package/dist/core/performance-optimizer/optimizer.d.ts +43 -0
- package/dist/core/performance-optimizer/profiler.d.ts +38 -0
- package/dist/core/performance-optimizer/react.d.ts +55 -0
- package/dist/core/performance-optimizer/strategies.d.ts +22 -0
- package/dist/core/performance-optimizer/types.d.ts +227 -0
- package/dist/core/performance-optimizer/workers.d.ts +27 -0
- package/dist/core/physics/collision-constraints.d.ts +15 -0
- package/dist/core/physics/collision-detection.d.ts +93 -0
- package/dist/core/physics/collision-response.d.ts +24 -0
- package/dist/core/physics/collision-types.d.ts +381 -0
- package/dist/core/physics/collision-world.d.ts +11 -0
- package/dist/core/physics/composition-behaviors.d.ts +97 -0
- package/dist/core/physics/composition-choreography.d.ts +14 -0
- package/dist/core/physics/composition-engine.d.ts +25 -0
- package/dist/core/physics/composition-recipes.d.ts +46 -0
- package/dist/core/physics/composition-types.d.ts +265 -0
- package/dist/core/physics/composition-validation.d.ts +33 -0
- package/dist/core/physics/index.d.ts +37 -0
- package/dist/core/physics/inertia-animation.d.ts +11 -0
- package/dist/core/physics/inertia-math.d.ts +56 -0
- package/dist/core/physics/inertia-presets.d.ts +25 -0
- package/dist/core/physics/inertia-simulation.d.ts +11 -0
- package/dist/core/physics/inertia-types.d.ts +355 -0
- package/dist/core/physics/inertia-validation.d.ts +22 -0
- package/dist/core/physics/math.d.ts +99 -0
- package/dist/core/physics/presets.d.ts +28 -0
- package/dist/core/physics/simulation.d.ts +11 -0
- package/dist/core/physics/spring-animation.d.ts +11 -0
- package/dist/core/physics/spring-math.d.ts +47 -0
- package/dist/core/physics/spring-presets.d.ts +29 -0
- package/dist/core/physics/spring-simulation.d.ts +11 -0
- package/dist/core/physics/spring-types.d.ts +350 -0
- package/dist/core/physics/spring-validation.d.ts +22 -0
- package/dist/core/physics/stepper.d.ts +24 -0
- package/dist/core/physics/types.d.ts +280 -0
- package/dist/core/physics/validation.d.ts +62 -0
- package/dist/core/pointer-capture.d.ts +7 -0
- package/dist/core/reference-analysis/index.d.ts +10 -0
- package/dist/core/reference-analysis/interpreter.d.ts +12 -0
- package/dist/core/reference-analysis/planner.d.ts +15 -0
- package/dist/core/reference-analysis/specification.d.ts +14 -0
- package/dist/core/reference-analysis/types.d.ts +244 -0
- package/dist/core/resource-intelligence/cache.d.ts +43 -0
- package/dist/core/resource-intelligence/gpu.d.ts +19 -0
- package/dist/core/resource-intelligence/index.d.ts +16 -0
- package/dist/core/resource-intelligence/leaks.d.ts +13 -0
- package/dist/core/resource-intelligence/memory.d.ts +27 -0
- package/dist/core/resource-intelligence/pooling.d.ts +32 -0
- package/dist/core/resource-intelligence/pressure.d.ts +32 -0
- package/dist/core/resource-intelligence/react.d.ts +63 -0
- package/dist/core/resource-intelligence/registry.d.ts +33 -0
- package/dist/core/resource-intelligence/reports.d.ts +14 -0
- package/dist/core/resource-intelligence/types.d.ts +232 -0
- package/dist/core/scene-generation/engine.d.ts +31 -0
- package/dist/core/scene-generation/generator.d.ts +14 -0
- package/dist/core/scene-generation/index.d.ts +14 -0
- package/dist/core/scene-generation/input-parser.d.ts +24 -0
- package/dist/core/scene-generation/presets.d.ts +10 -0
- package/dist/core/scene-generation/react.d.ts +13 -0
- package/dist/core/scene-generation/scene-analyzer.d.ts +9 -0
- package/dist/core/scene-generation/scene-planner.d.ts +12 -0
- package/dist/core/scene-generation/types.d.ts +236 -0
- package/dist/core/scene-generation/validator.d.ts +18 -0
- package/dist/core/schema.d.ts +185 -0
- package/dist/core/scroll-intelligence/generator.d.ts +11 -0
- package/dist/core/scroll-intelligence/index.d.ts +11 -0
- package/dist/core/scroll-intelligence/intent.d.ts +11 -0
- package/dist/core/scroll-intelligence/runtime.d.ts +21 -0
- package/dist/core/scroll-intelligence/schema.d.ts +78 -0
- package/dist/core/scroll-intelligence/types.d.ts +85 -0
- package/dist/core/spring.d.ts +38 -0
- package/dist/core/svg-morph/animator.d.ts +10 -0
- package/dist/core/svg-morph/arc-to-cubic.d.ts +11 -0
- package/dist/core/svg-morph/index.d.ts +10 -0
- package/dist/core/svg-morph/interpolate.d.ts +23 -0
- package/dist/core/svg-morph/normalize.d.ts +34 -0
- package/dist/core/svg-morph/parser.d.ts +13 -0
- package/dist/core/svg-morph/shapes.d.ts +32 -0
- package/dist/core/svg-morph/types.d.ts +144 -0
- package/dist/core/transform.d.ts +27 -0
- package/dist/core/transitions/controller.d.ts +45 -0
- package/dist/core/transitions/engine.d.ts +26 -0
- package/dist/core/transitions/group-transition.d.ts +30 -0
- package/dist/core/transitions/index.d.ts +15 -0
- package/dist/core/transitions/presets.d.ts +16 -0
- package/dist/core/transitions/schema.d.ts +71 -0
- package/dist/core/transitions/shared-element-transition.d.ts +88 -0
- package/dist/core/transitions/shared-element.d.ts +84 -0
- package/dist/core/transitions/types.d.ts +185 -0
- package/dist/core/transitions/view-transition.d.ts +25 -0
- package/dist/core/typography/engine.d.ts +19 -0
- package/dist/core/typography/index.d.ts +15 -0
- package/dist/core/typography/path-motion.d.ts +24 -0
- package/dist/core/typography/presets.d.ts +14 -0
- package/dist/core/typography/properties.d.ts +19 -0
- package/dist/core/typography/segmenter.d.ts +32 -0
- package/dist/core/typography/stagger.d.ts +15 -0
- package/dist/core/typography/transitions.d.ts +11 -0
- package/dist/core/typography/types.d.ts +154 -0
- package/dist/core/utils/safe-json.d.ts +50 -0
- package/dist/core/visual-style-registry.d.ts +659 -0
- package/dist/easing/easings.d.ts +44 -0
- package/dist/effects/border-beam.d.ts +28 -0
- package/dist/effects/count-up.d.ts +30 -0
- package/dist/effects/cursor-trail.d.ts +23 -0
- package/dist/effects/drag.d.ts +41 -0
- package/dist/effects/draw-svg.d.ts +19 -0
- package/dist/effects/follow-pointer.d.ts +19 -0
- package/dist/effects/glow.d.ts +25 -0
- package/dist/effects/gradient-text.d.ts +22 -0
- package/dist/effects/hover-motion.d.ts +32 -0
- package/dist/effects/in-view.d.ts +14 -0
- package/dist/effects/magnetic.d.ts +40 -0
- package/dist/effects/morph-svg.d.ts +15 -0
- package/dist/effects/parallax.d.ts +42 -0
- package/dist/effects/pinch.d.ts +27 -0
- package/dist/effects/reveal.d.ts +33 -0
- package/dist/effects/ripple.d.ts +21 -0
- package/dist/effects/scroll-animate.d.ts +23 -0
- package/dist/effects/scroll-direction.d.ts +19 -0
- package/dist/effects/scroll-progress.d.ts +29 -0
- package/dist/effects/scroll-trigger.d.ts +22 -0
- package/dist/effects/scroll-velocity.d.ts +29 -0
- package/dist/effects/shine.d.ts +23 -0
- package/dist/effects/split-text.d.ts +17 -0
- package/dist/effects/spotlight.d.ts +24 -0
- package/dist/effects/stagger.d.ts +46 -0
- package/dist/effects/swipe.d.ts +27 -0
- package/dist/effects/text-highlight.d.ts +25 -0
- package/dist/effects/text-mask.d.ts +25 -0
- package/dist/effects/text-reveal.d.ts +28 -0
- package/dist/effects/text-scramble.d.ts +18 -0
- package/dist/effects/tilt.d.ts +42 -0
- package/dist/effects/typewriter.d.ts +26 -0
- package/dist/graphics/capabilities.d.ts +12 -0
- package/dist/graphics/composition/engine.d.ts +14 -0
- package/dist/graphics/composition/fallback.d.ts +13 -0
- package/dist/graphics/composition/index.d.ts +10 -0
- package/dist/graphics/composition/ordering.d.ts +29 -0
- package/dist/graphics/composition/quality.d.ts +24 -0
- package/dist/graphics/composition/schema.d.ts +156 -0
- package/dist/graphics/composition/types.d.ts +81 -0
- package/dist/graphics/composition/unified.d.ts +23 -0
- package/dist/graphics/effects/advanced/engine.d.ts +9 -0
- package/dist/graphics/effects/advanced/index.d.ts +1 -0
- package/dist/graphics/effects/composer.d.ts +9 -0
- package/dist/graphics/effects/distortion/engine.d.ts +9 -0
- package/dist/graphics/effects/distortion/index.d.ts +1 -0
- package/dist/graphics/effects/fluid/engine.d.ts +9 -0
- package/dist/graphics/effects/fluid/index.d.ts +1 -0
- package/dist/graphics/effects/index.d.ts +10 -0
- package/dist/graphics/effects/particles/engine.d.ts +9 -0
- package/dist/graphics/effects/particles/index.d.ts +2 -0
- package/dist/graphics/effects/particles/pool.d.ts +17 -0
- package/dist/graphics/effects/schema.d.ts +312 -0
- package/dist/graphics/effects/types.d.ts +85 -0
- package/dist/graphics/engine.d.ts +5 -0
- package/dist/graphics/environment/clouds.d.ts +28 -0
- package/dist/graphics/environment/environment.d.ts +50 -0
- package/dist/graphics/environment/fire-smoke.d.ts +32 -0
- package/dist/graphics/environment/fog.d.ts +28 -0
- package/dist/graphics/environment/index.d.ts +18 -0
- package/dist/graphics/environment/lightning.d.ts +33 -0
- package/dist/graphics/environment/rain.d.ts +33 -0
- package/dist/graphics/environment/snow.d.ts +30 -0
- package/dist/graphics/environment/types.d.ts +184 -0
- package/dist/graphics/environment/weather.d.ts +19 -0
- package/dist/graphics/environment/wind.d.ts +23 -0
- package/dist/graphics/fluid/flow-field.d.ts +74 -0
- package/dist/graphics/fluid/grid.d.ts +43 -0
- package/dist/graphics/fluid/index.d.ts +13 -0
- package/dist/graphics/fluid/interactions.d.ts +39 -0
- package/dist/graphics/fluid/rendering.d.ts +32 -0
- package/dist/graphics/fluid/simulation.d.ts +50 -0
- package/dist/graphics/fluid/solver.d.ts +19 -0
- package/dist/graphics/fluid/types.d.ts +186 -0
- package/dist/graphics/gpu-simulation/backends/backend.d.ts +24 -0
- package/dist/graphics/gpu-simulation/backends/cpu.d.ts +21 -0
- package/dist/graphics/gpu-simulation/backends/selection.d.ts +15 -0
- package/dist/graphics/gpu-simulation/backends/webgl2.d.ts +28 -0
- package/dist/graphics/gpu-simulation/backends/webgpu.d.ts +23 -0
- package/dist/graphics/gpu-simulation/capabilities.d.ts +14 -0
- package/dist/graphics/gpu-simulation/device.d.ts +17 -0
- package/dist/graphics/gpu-simulation/engine.d.ts +8 -0
- package/dist/graphics/gpu-simulation/index.d.ts +22 -0
- package/dist/graphics/gpu-simulation/ping-pong.d.ts +23 -0
- package/dist/graphics/gpu-simulation/pipeline.d.ts +18 -0
- package/dist/graphics/gpu-simulation/resource-manager.d.ts +8 -0
- package/dist/graphics/gpu-simulation/shaders.d.ts +50 -0
- package/dist/graphics/gpu-simulation/types.d.ts +288 -0
- package/dist/graphics/index.d.ts +23 -0
- package/dist/graphics/materials/glass.d.ts +22 -0
- package/dist/graphics/materials/index.d.ts +9 -0
- package/dist/graphics/materials/lighting.d.ts +22 -0
- package/dist/graphics/materials/presets.d.ts +28 -0
- package/dist/graphics/materials/schema.d.ts +574 -0
- package/dist/graphics/materials/surface.d.ts +13 -0
- package/dist/graphics/materials/types.d.ts +150 -0
- package/dist/graphics/particle-fields/composition.d.ts +32 -0
- package/dist/graphics/particle-fields/forces.d.ts +103 -0
- package/dist/graphics/particle-fields/index.d.ts +12 -0
- package/dist/graphics/particle-fields/interaction.d.ts +32 -0
- package/dist/graphics/particle-fields/spatial-index.d.ts +20 -0
- package/dist/graphics/particle-fields/system.d.ts +52 -0
- package/dist/graphics/particle-fields/types.d.ts +138 -0
- package/dist/graphics/particles/behaviors.d.ts +11 -0
- package/dist/graphics/particles/controller.d.ts +82 -0
- package/dist/graphics/particles/data-layout.d.ts +51 -0
- package/dist/graphics/particles/emitters.d.ts +24 -0
- package/dist/graphics/particles/index.d.ts +15 -0
- package/dist/graphics/particles/random.d.ts +25 -0
- package/dist/graphics/particles/rendering.d.ts +16 -0
- package/dist/graphics/particles/simulation.d.ts +23 -0
- package/dist/graphics/particles/types.d.ts +282 -0
- package/dist/graphics/renderer.d.ts +66 -0
- package/dist/graphics/resource-manager.d.ts +6 -0
- package/dist/graphics/schema.d.ts +177 -0
- package/dist/graphics/simulation/adapters.d.ts +36 -0
- package/dist/graphics/simulation/coordinator.d.ts +64 -0
- package/dist/graphics/simulation/index.d.ts +11 -0
- package/dist/graphics/simulation/optimizer.d.ts +101 -0
- package/dist/graphics/simulation/resource-manager.d.ts +40 -0
- package/dist/graphics/simulation/types.d.ts +126 -0
- package/dist/graphics/textures/cache.d.ts +29 -0
- package/dist/graphics/textures/canvas-utils.d.ts +31 -0
- package/dist/graphics/textures/engine.d.ts +34 -0
- package/dist/graphics/textures/generators.d.ts +29 -0
- package/dist/graphics/textures/index.d.ts +11 -0
- package/dist/graphics/textures/material-integration.d.ts +20 -0
- package/dist/graphics/textures/prng.d.ts +27 -0
- package/dist/graphics/textures/schema.d.ts +219 -0
- package/dist/graphics/textures/types.d.ts +80 -0
- package/dist/graphics/types.d.ts +152 -0
- package/dist/graphics/viewport.d.ts +32 -0
- package/dist/index.d.ts +132 -0
- package/dist/index.js +4921 -0
- package/dist/mcp/index.d.ts +12 -0
- package/dist/mcp/prompts.d.ts +9 -0
- package/dist/mcp/resources.d.ts +9 -0
- package/dist/mcp/server.d.ts +29 -0
- package/dist/mcp/tools.d.ts +9 -0
- package/dist/mcp/transport.d.ts +33 -0
- package/dist/mcp/types.d.ts +96 -0
- package/dist/presets.d.ts +176 -0
- package/dist/presets.js +3 -0
- package/dist/react.d.ts +5358 -0
- package/dist/react.js +7557 -0
- package/package.json +112 -6
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion 3D Scene Specification & Schema Types
|
|
3
|
+
*
|
|
4
|
+
* Machine-readable, typed contracts for complete 3D scenes, spatial transforms,
|
|
5
|
+
* object graphs, primitive geometries, model references, materials, and interactions.
|
|
6
|
+
*/
|
|
7
|
+
export type { Camera3DConfig, Environment3DConfig, Lighting3DConfig, Renderer3DConfig, } from "../types.js";
|
|
8
|
+
import type { Camera3DConfig, Environment3DConfig, Lighting3DConfig, Renderer3DConfig } from "../types.js";
|
|
9
|
+
export type Vector3 = readonly [x: number, y: number, z: number];
|
|
10
|
+
export type Quaternion = readonly [x: number, y: number, z: number, w: number];
|
|
11
|
+
export type EulerRotation = readonly [x: number, y: number, z: number];
|
|
12
|
+
export interface Transform3D {
|
|
13
|
+
readonly position?: Vector3;
|
|
14
|
+
readonly rotation?: EulerRotation;
|
|
15
|
+
readonly quaternion?: Quaternion;
|
|
16
|
+
readonly scale?: Vector3;
|
|
17
|
+
}
|
|
18
|
+
export interface BoundingBox3D {
|
|
19
|
+
readonly min: Vector3;
|
|
20
|
+
readonly max: Vector3;
|
|
21
|
+
readonly size?: Vector3;
|
|
22
|
+
readonly center?: Vector3;
|
|
23
|
+
}
|
|
24
|
+
export type CoordinateSystem = "right-handed-y-up" | "left-handed-y-up";
|
|
25
|
+
export type GeometryPrimitiveType = "box" | "sphere" | "cylinder" | "plane" | "torus" | "cone" | "capsule";
|
|
26
|
+
export interface PrimitiveGeometrySpec {
|
|
27
|
+
readonly type: "primitive";
|
|
28
|
+
readonly primitive: GeometryPrimitiveType;
|
|
29
|
+
readonly parameters?: Record<string, number>;
|
|
30
|
+
}
|
|
31
|
+
export interface ModelReferenceSpec {
|
|
32
|
+
readonly type: "model";
|
|
33
|
+
readonly format: "gltf" | "glb" | "obj" | "fbx";
|
|
34
|
+
readonly url: string;
|
|
35
|
+
readonly scale?: number;
|
|
36
|
+
readonly draco?: boolean;
|
|
37
|
+
}
|
|
38
|
+
export interface CustomGeometrySpec {
|
|
39
|
+
readonly type: "custom";
|
|
40
|
+
readonly id: string;
|
|
41
|
+
readonly parameters?: Record<string, unknown>;
|
|
42
|
+
}
|
|
43
|
+
export type GeometrySpec = PrimitiveGeometrySpec | ModelReferenceSpec | CustomGeometrySpec;
|
|
44
|
+
export type Material3DType = "basic" | "standard" | "physical" | "phong" | "toon" | "shadow" | "custom";
|
|
45
|
+
export type MaterialType3D = Material3DType;
|
|
46
|
+
export interface MaterialSpec {
|
|
47
|
+
readonly id?: string;
|
|
48
|
+
readonly type: Material3DType;
|
|
49
|
+
readonly color?: string;
|
|
50
|
+
readonly roughness?: number;
|
|
51
|
+
readonly metalness?: number;
|
|
52
|
+
readonly transmission?: number;
|
|
53
|
+
readonly ior?: number;
|
|
54
|
+
readonly opacity?: number;
|
|
55
|
+
readonly transparent?: boolean;
|
|
56
|
+
readonly wireframe?: boolean;
|
|
57
|
+
readonly mapUrl?: string;
|
|
58
|
+
readonly normalMapUrl?: string;
|
|
59
|
+
readonly roughnessMapUrl?: string;
|
|
60
|
+
}
|
|
61
|
+
export type InteractionTrigger = "click" | "hover" | "drag" | "pointer-move" | "key-press" | "scroll-into-view";
|
|
62
|
+
export type InteractionAction = "animate" | "emit-event" | "navigate" | "highlight" | "focus" | "custom";
|
|
63
|
+
export interface AccessibilitySpec {
|
|
64
|
+
readonly ariaLabel?: string;
|
|
65
|
+
readonly role?: string;
|
|
66
|
+
readonly focusable?: boolean;
|
|
67
|
+
readonly keyboardShortcut?: string;
|
|
68
|
+
}
|
|
69
|
+
export interface InputMappingSpec {
|
|
70
|
+
readonly pointer?: boolean;
|
|
71
|
+
readonly keyboard?: boolean;
|
|
72
|
+
readonly touch?: boolean;
|
|
73
|
+
readonly wheel?: boolean;
|
|
74
|
+
}
|
|
75
|
+
export interface CameraControlSpec {
|
|
76
|
+
readonly mode?: "orbit" | "pan" | "zoom" | "combined" | "none";
|
|
77
|
+
readonly enableOrbit?: boolean;
|
|
78
|
+
readonly enablePan?: boolean;
|
|
79
|
+
readonly enableZoom?: boolean;
|
|
80
|
+
readonly dampingFactor?: number;
|
|
81
|
+
readonly minDistance?: number;
|
|
82
|
+
readonly maxDistance?: number;
|
|
83
|
+
readonly minPolarAngle?: number;
|
|
84
|
+
readonly maxPolarAngle?: number;
|
|
85
|
+
}
|
|
86
|
+
export interface ScrollTimelineSpec {
|
|
87
|
+
readonly id: string;
|
|
88
|
+
readonly name?: string;
|
|
89
|
+
readonly keyframes: readonly any[];
|
|
90
|
+
readonly sections?: readonly any[];
|
|
91
|
+
}
|
|
92
|
+
export interface SceneInteractionSpec {
|
|
93
|
+
readonly controls?: CameraControlSpec;
|
|
94
|
+
readonly inputMapping?: InputMappingSpec;
|
|
95
|
+
readonly defaultHighlightColor?: string;
|
|
96
|
+
}
|
|
97
|
+
export interface InteractionSpec {
|
|
98
|
+
readonly trigger: InteractionTrigger;
|
|
99
|
+
readonly action: InteractionAction;
|
|
100
|
+
readonly targetId?: string;
|
|
101
|
+
readonly parameters?: Record<string, unknown>;
|
|
102
|
+
}
|
|
103
|
+
export interface AnimationKeyframeSpec {
|
|
104
|
+
readonly time: number;
|
|
105
|
+
readonly value: unknown;
|
|
106
|
+
readonly easing?: string;
|
|
107
|
+
}
|
|
108
|
+
export interface AnimationTrackSpec {
|
|
109
|
+
readonly property: "position" | "rotation" | "scale" | "opacity" | "color" | string;
|
|
110
|
+
readonly keyframes: readonly AnimationKeyframeSpec[];
|
|
111
|
+
readonly loop?: boolean;
|
|
112
|
+
readonly duration?: number;
|
|
113
|
+
}
|
|
114
|
+
export interface ObjectAnimationSpec {
|
|
115
|
+
readonly targetId: string;
|
|
116
|
+
readonly tracks: readonly AnimationTrackSpec[];
|
|
117
|
+
readonly autoPlay?: boolean;
|
|
118
|
+
}
|
|
119
|
+
export type SceneObjectType = "group" | "mesh" | "primitive" | "light" | "camera" | "environment" | "model" | "interactive" | "custom";
|
|
120
|
+
export interface BaseSceneObject {
|
|
121
|
+
readonly id: string;
|
|
122
|
+
readonly name?: string;
|
|
123
|
+
readonly type: SceneObjectType;
|
|
124
|
+
readonly transform?: Transform3D;
|
|
125
|
+
readonly visible?: boolean;
|
|
126
|
+
readonly castShadow?: boolean;
|
|
127
|
+
readonly receiveShadow?: boolean;
|
|
128
|
+
readonly parentId?: string;
|
|
129
|
+
readonly children?: readonly SceneObjectSpec[];
|
|
130
|
+
readonly accessibility?: AccessibilitySpec;
|
|
131
|
+
readonly interaction?: InteractionSpec;
|
|
132
|
+
readonly userData?: Record<string, unknown>;
|
|
133
|
+
}
|
|
134
|
+
export interface GroupObjectSpec extends BaseSceneObject {
|
|
135
|
+
readonly type: "group";
|
|
136
|
+
}
|
|
137
|
+
export interface MeshObjectSpec extends BaseSceneObject {
|
|
138
|
+
readonly type: "mesh";
|
|
139
|
+
readonly geometry?: GeometrySpec;
|
|
140
|
+
readonly material?: MaterialSpec;
|
|
141
|
+
}
|
|
142
|
+
export interface PrimitiveObjectSpec extends BaseSceneObject {
|
|
143
|
+
readonly type: "primitive";
|
|
144
|
+
readonly geometry: PrimitiveGeometrySpec;
|
|
145
|
+
readonly material?: MaterialSpec;
|
|
146
|
+
}
|
|
147
|
+
export interface LightObjectSpec extends BaseSceneObject {
|
|
148
|
+
readonly type: "light";
|
|
149
|
+
readonly lightType: "ambient" | "directional" | "point" | "spot";
|
|
150
|
+
readonly color?: string;
|
|
151
|
+
readonly intensity?: number;
|
|
152
|
+
readonly distance?: number;
|
|
153
|
+
readonly decay?: number;
|
|
154
|
+
readonly angle?: number;
|
|
155
|
+
readonly penumbra?: number;
|
|
156
|
+
readonly target?: Vector3;
|
|
157
|
+
}
|
|
158
|
+
export interface CameraObjectSpec extends BaseSceneObject {
|
|
159
|
+
readonly type: "camera";
|
|
160
|
+
readonly camera: Camera3DConfig;
|
|
161
|
+
}
|
|
162
|
+
export interface EnvironmentObjectSpec extends BaseSceneObject {
|
|
163
|
+
readonly type: "environment";
|
|
164
|
+
readonly environment: Environment3DConfig;
|
|
165
|
+
}
|
|
166
|
+
export interface ModelObjectSpec extends BaseSceneObject {
|
|
167
|
+
readonly type: "model";
|
|
168
|
+
readonly model: ModelReferenceSpec;
|
|
169
|
+
readonly material?: MaterialSpec;
|
|
170
|
+
}
|
|
171
|
+
export interface InteractiveObjectSpec extends BaseSceneObject {
|
|
172
|
+
readonly type: "interactive";
|
|
173
|
+
readonly interaction: InteractionSpec;
|
|
174
|
+
readonly geometry?: GeometrySpec;
|
|
175
|
+
readonly material?: MaterialSpec;
|
|
176
|
+
}
|
|
177
|
+
export interface CustomObjectSpec extends BaseSceneObject {
|
|
178
|
+
readonly type: "custom";
|
|
179
|
+
readonly customType: string;
|
|
180
|
+
readonly properties?: Record<string, unknown>;
|
|
181
|
+
}
|
|
182
|
+
export type SceneObjectSpec = GroupObjectSpec | MeshObjectSpec | PrimitiveObjectSpec | LightObjectSpec | CameraObjectSpec | EnvironmentObjectSpec | ModelObjectSpec | InteractiveObjectSpec | CustomObjectSpec;
|
|
183
|
+
export interface Scene3DSpecification {
|
|
184
|
+
readonly id: string;
|
|
185
|
+
readonly name?: string;
|
|
186
|
+
readonly version: string;
|
|
187
|
+
readonly metadata?: Record<string, unknown>;
|
|
188
|
+
readonly coordinateSystem?: CoordinateSystem;
|
|
189
|
+
readonly camera?: Camera3DConfig;
|
|
190
|
+
readonly lighting?: Lighting3DConfig;
|
|
191
|
+
readonly environment?: Environment3DConfig;
|
|
192
|
+
readonly renderer?: Renderer3DConfig;
|
|
193
|
+
readonly objects: readonly SceneObjectSpec[];
|
|
194
|
+
readonly animations?: readonly ObjectAnimationSpec[];
|
|
195
|
+
readonly interaction?: SceneInteractionSpec;
|
|
196
|
+
readonly scrollTimeline?: ScrollTimelineSpec;
|
|
197
|
+
readonly autoStart?: boolean;
|
|
198
|
+
readonly respectReducedMotion?: boolean;
|
|
199
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion 3D Scene Specification Validation
|
|
3
|
+
*
|
|
4
|
+
* Structured validation, spatial transform checks, hierarchy cycle detection,
|
|
5
|
+
* dangling reference detection, and interaction/timeline target verification.
|
|
6
|
+
*/
|
|
7
|
+
export interface ValidationError {
|
|
8
|
+
readonly path: string;
|
|
9
|
+
readonly message: string;
|
|
10
|
+
readonly code: string;
|
|
11
|
+
readonly severity: "error" | "warning";
|
|
12
|
+
}
|
|
13
|
+
export interface ValidationReport {
|
|
14
|
+
readonly valid: boolean;
|
|
15
|
+
readonly errors: readonly ValidationError[];
|
|
16
|
+
readonly warnings: readonly ValidationError[];
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Validate a Transform3D spatial configuration.
|
|
20
|
+
*/
|
|
21
|
+
export declare function validateTransform(transform: unknown, path?: string): ValidationError[];
|
|
22
|
+
/**
|
|
23
|
+
* Validate a single SceneObjectSpec node.
|
|
24
|
+
*/
|
|
25
|
+
export declare function validateSceneObject(obj: unknown, path?: string): ValidationError[];
|
|
26
|
+
/**
|
|
27
|
+
* Validate object hierarchy, circular relationships, and dangling parent references.
|
|
28
|
+
*/
|
|
29
|
+
export declare function validateSceneHierarchy(objects: readonly unknown[]): ValidationError[];
|
|
30
|
+
/**
|
|
31
|
+
* Validate an entire complete 3D scene specification.
|
|
32
|
+
*/
|
|
33
|
+
export declare function validateSceneSchema(scene: unknown): ValidationReport;
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion 3D Scroll-Driven Scene Controller
|
|
3
|
+
*
|
|
4
|
+
* Evaluates scroll progress across timelines, driving camera staging,
|
|
5
|
+
* object transforms, and section activations with bidirectional synchronization.
|
|
6
|
+
*/
|
|
7
|
+
import type { ScrollSceneOptions, ScrollSceneState } from "./types.js";
|
|
8
|
+
export declare class ScrollSceneController {
|
|
9
|
+
private readonly timeline;
|
|
10
|
+
private readonly sortedKeyframes;
|
|
11
|
+
private readonly options;
|
|
12
|
+
private currentProgress;
|
|
13
|
+
private activeSectionId?;
|
|
14
|
+
private containerElement;
|
|
15
|
+
private scrollListener;
|
|
16
|
+
constructor(options: ScrollSceneOptions);
|
|
17
|
+
/**
|
|
18
|
+
* Evaluates scene state at any arbitrary progress point in [0, 1].
|
|
19
|
+
*/
|
|
20
|
+
evaluate(progress: number): ScrollSceneState;
|
|
21
|
+
/**
|
|
22
|
+
* Binds scroll event listening to a scroll container or window.
|
|
23
|
+
*/
|
|
24
|
+
attachScroll(container: HTMLElement | Window): void;
|
|
25
|
+
/**
|
|
26
|
+
* Detaches scroll listener.
|
|
27
|
+
*/
|
|
28
|
+
detachScroll(): void;
|
|
29
|
+
getProgress(): number;
|
|
30
|
+
destroy(): void;
|
|
31
|
+
}
|
|
32
|
+
export declare function createScrollSceneController(options: ScrollSceneOptions): ScrollSceneController;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion 3D Scroll Timeline Presets
|
|
3
|
+
*
|
|
4
|
+
* Composable presets for exploded product views, camera flythroughs,
|
|
5
|
+
* and multi-chapter storytelling.
|
|
6
|
+
*/
|
|
7
|
+
import type { ScrollSceneTimeline } from "./types.js";
|
|
8
|
+
export declare const SCROLL_TIMELINE_PRESETS: Record<string, ScrollSceneTimeline>;
|
|
9
|
+
export declare function getScrollTimelinePreset(name: string): ScrollSceneTimeline;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion 3D Scroll-Driven Scene Types
|
|
3
|
+
*
|
|
4
|
+
* Framework-independent contracts for scroll-linked camera movement,
|
|
5
|
+
* object transformation tracks, timeline stages, and section activations.
|
|
6
|
+
*/
|
|
7
|
+
import type { Camera3DConfig, Vector3Tuple } from "../types.js";
|
|
8
|
+
export interface ObjectTransformState {
|
|
9
|
+
readonly position: Vector3Tuple;
|
|
10
|
+
readonly rotation: Vector3Tuple;
|
|
11
|
+
readonly scale: Vector3Tuple;
|
|
12
|
+
readonly opacity: number;
|
|
13
|
+
readonly visible: boolean;
|
|
14
|
+
}
|
|
15
|
+
export interface ScrollSceneKeyframe {
|
|
16
|
+
readonly progress: number;
|
|
17
|
+
readonly camera?: Partial<Camera3DConfig>;
|
|
18
|
+
readonly objects?: Record<string, {
|
|
19
|
+
readonly position?: Vector3Tuple;
|
|
20
|
+
readonly rotation?: Vector3Tuple;
|
|
21
|
+
readonly scale?: Vector3Tuple;
|
|
22
|
+
readonly opacity?: number;
|
|
23
|
+
readonly visible?: boolean;
|
|
24
|
+
}>;
|
|
25
|
+
readonly easing?: string;
|
|
26
|
+
}
|
|
27
|
+
export interface ScrollSceneSection {
|
|
28
|
+
readonly id: string;
|
|
29
|
+
readonly start: number;
|
|
30
|
+
readonly end: number;
|
|
31
|
+
readonly name?: string;
|
|
32
|
+
readonly cameraPreset?: string;
|
|
33
|
+
}
|
|
34
|
+
export interface ScrollSceneTimeline {
|
|
35
|
+
readonly id: string;
|
|
36
|
+
readonly name?: string;
|
|
37
|
+
readonly keyframes: readonly ScrollSceneKeyframe[];
|
|
38
|
+
readonly sections?: readonly ScrollSceneSection[];
|
|
39
|
+
}
|
|
40
|
+
export interface ScrollSceneState {
|
|
41
|
+
readonly progress: number;
|
|
42
|
+
readonly activeSectionId?: string;
|
|
43
|
+
readonly camera: Camera3DConfig;
|
|
44
|
+
readonly objects: Record<string, ObjectTransformState>;
|
|
45
|
+
}
|
|
46
|
+
export interface ScrollSceneOptions {
|
|
47
|
+
readonly timeline: ScrollSceneTimeline;
|
|
48
|
+
readonly initialCamera?: Camera3DConfig;
|
|
49
|
+
readonly container?: HTMLElement | Window | null;
|
|
50
|
+
readonly onProgress?: (progress: number, state: ScrollSceneState) => void;
|
|
51
|
+
readonly onSectionChange?: (sectionId: string) => void;
|
|
52
|
+
readonly respectReducedMotion?: boolean;
|
|
53
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Terrain Biome Classification
|
|
3
|
+
*
|
|
4
|
+
* Deterministic multi-factor biome classification system evaluating elevation,
|
|
5
|
+
* slope gradient, temperature, and moisture to synthesize realistic ecological zones.
|
|
6
|
+
*/
|
|
7
|
+
import type { HeightmapData, BiomeRule, BiomeWeightMap } from "./types.js";
|
|
8
|
+
export declare const DEFAULT_BIOME_RULES: BiomeRule[];
|
|
9
|
+
export interface BiomeClassificationOptions {
|
|
10
|
+
seed?: number | string;
|
|
11
|
+
moistureNoise?: (x: number, z: number) => number;
|
|
12
|
+
temperatureNoise?: (x: number, z: number) => number;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Classifies terrain biomes across the grid, synthesizing elevation, slope,
|
|
16
|
+
* temperature, and moisture into per-vertex blend weights and dominant biome labels.
|
|
17
|
+
*/
|
|
18
|
+
export declare function classifyTerrainBiomes(heightmap: HeightmapData, customRules?: BiomeRule[], options?: BiomeClassificationOptions): BiomeWeightMap;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Terrain Chunking & Level-of-Detail (LOD)
|
|
3
|
+
*
|
|
4
|
+
* Partitions vast heightmaps into localized spatial chunks with independent
|
|
5
|
+
* bounding boxes, multi-resolution LOD mesh generation, and distance-based LOD switching.
|
|
6
|
+
*/
|
|
7
|
+
import type { Vector3 } from "../physics/types.js";
|
|
8
|
+
import type { HeightmapData, TerrainChunk, TerrainMeshBuffers } from "./types.js";
|
|
9
|
+
/**
|
|
10
|
+
* Builds mesh buffers for a sub-region chunk of the heightmap at a specific LOD step.
|
|
11
|
+
*/
|
|
12
|
+
export declare function buildChunkMeshBuffers(heightmap: HeightmapData, startCol: number, endCol: number, startRow: number, endRow: number, lodStep?: number): TerrainMeshBuffers;
|
|
13
|
+
/**
|
|
14
|
+
* Creates spatial chunks dividing the terrain for localized frustum culling and LOD rendering.
|
|
15
|
+
*/
|
|
16
|
+
export declare function createTerrainChunks(heightmap: HeightmapData, chunkCount?: number): TerrainChunk[];
|
|
17
|
+
/**
|
|
18
|
+
* Updates a chunk's Level of Detail based on distance to the camera or viewer.
|
|
19
|
+
*/
|
|
20
|
+
export declare function updateChunkLOD(chunk: TerrainChunk, heightmap: HeightmapData, viewerPos: Vector3, lodDistances?: [number, number]): void;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Terrain Hydraulic & Thermal Erosion Engine
|
|
3
|
+
*
|
|
4
|
+
* Implements physical droplet hydraulic erosion (transport, erosion, deposition, evaporation)
|
|
5
|
+
* and talus-angle thermal scree slope stabilization with sediment conservation.
|
|
6
|
+
*/
|
|
7
|
+
import type { HeightmapData, HydraulicErosionConfig, ThermalErosionConfig } from "./types.js";
|
|
8
|
+
/**
|
|
9
|
+
* Applies physical particle-based hydraulic erosion to a heightmap in-place.
|
|
10
|
+
*/
|
|
11
|
+
export declare function applyHydraulicErosion(heightmap: HeightmapData, config?: HydraulicErosionConfig): HeightmapData;
|
|
12
|
+
/**
|
|
13
|
+
* Applies physical thermal erosion to stabilize scree and cliffs exceeding the talus angle.
|
|
14
|
+
*/
|
|
15
|
+
export declare function applyThermalErosion(heightmap: HeightmapData, config?: ThermalErosionConfig): HeightmapData;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { Vector3 } from "../physics/types.js";
|
|
2
|
+
/**
|
|
3
|
+
* AF Motion — 3D Terrain Heightmap & Geometry Generator
|
|
4
|
+
*
|
|
5
|
+
* Generates discrete 2D heightfield elevation grids, macro terrain presets,
|
|
6
|
+
* multi-layer noise blending, analytical surface normals, and indexed mesh buffers.
|
|
7
|
+
*/
|
|
8
|
+
import type { TerrainConfig, HeightmapData, TerrainMeshBuffers, TerrainPreset, NoiseLayerConfig } from "./types.js";
|
|
9
|
+
/**
|
|
10
|
+
* Returns default noise layers for a chosen terrain macro preset.
|
|
11
|
+
*/
|
|
12
|
+
export declare function getPresetNoiseLayers(preset: TerrainPreset, seed?: number | string): NoiseLayerConfig[];
|
|
13
|
+
/**
|
|
14
|
+
* Generates heightfield elevation grid data deterministically from configurations.
|
|
15
|
+
*/
|
|
16
|
+
export declare function generateTerrainHeightmap(config?: TerrainConfig): HeightmapData;
|
|
17
|
+
/**
|
|
18
|
+
* Builds standard 3D indexed vertex buffers (positions, normals, UVs, indices) from a heightmap.
|
|
19
|
+
*/
|
|
20
|
+
export declare function buildTerrainMeshBuffers(heightmap: HeightmapData): TerrainMeshBuffers;
|
|
21
|
+
/**
|
|
22
|
+
* Samples terrain elevation and normal at an arbitrary world position using bilinear interpolation.
|
|
23
|
+
*/
|
|
24
|
+
export declare function sampleTerrainHeightAndNormal(heightmap: HeightmapData, worldX: number, worldZ: number): {
|
|
25
|
+
height: number;
|
|
26
|
+
normal: Vector3;
|
|
27
|
+
};
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Procedural Terrain Subsystem
|
|
3
|
+
*
|
|
4
|
+
* Comprehensive framework-independent 3D procedural terrain engine featuring
|
|
5
|
+
* multi-algorithm deterministic noise, macro presets, hydraulic & thermal erosion,
|
|
6
|
+
* multi-factor ecological biomes, vertex color & splat materials, vegetation scattering,
|
|
7
|
+
* LOD chunks, and seamless physics heightfield integration.
|
|
8
|
+
*/
|
|
9
|
+
export * from "./types.js";
|
|
10
|
+
export * from "./noise.js";
|
|
11
|
+
export * from "./heightmap.js";
|
|
12
|
+
export * from "./erosion.js";
|
|
13
|
+
export * from "./biomes.js";
|
|
14
|
+
export * from "./materials.js";
|
|
15
|
+
export * from "./vegetation.js";
|
|
16
|
+
export * from "./physics.js";
|
|
17
|
+
export * from "./chunks.js";
|
|
18
|
+
export * from "./terrain.js";
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Terrain Material & Splat Generator
|
|
3
|
+
*
|
|
4
|
+
* Synthesizes multi-biome material blending, slope-aware rock cliffs,
|
|
5
|
+
* elevation-based snow/sand transitions, and RGBA vertex color buffers.
|
|
6
|
+
*/
|
|
7
|
+
import type { HeightmapData, BiomeWeightMap, BiomeRule } from "./types.js";
|
|
8
|
+
export interface TerrainMaterialBuffers {
|
|
9
|
+
/** RGBA vertex colors for multi-biome visual rendering [r0, g0, b0, a0, ...]. */
|
|
10
|
+
colors: Float32Array;
|
|
11
|
+
/** Primary 4-layer splat weights for shader texture blending [w0, w1, w2, w3, ...]. */
|
|
12
|
+
splatWeights: Float32Array;
|
|
13
|
+
/** Surface roughness array per vertex. */
|
|
14
|
+
roughness: Float32Array;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Generates vertex colors and material splat weights based on biome classification
|
|
18
|
+
* and slope blending.
|
|
19
|
+
*/
|
|
20
|
+
export declare function generateTerrainMaterials(heightmap: HeightmapData, biomes: BiomeWeightMap, customRules?: BiomeRule[]): TerrainMaterialBuffers;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Procedural Terrain Noise Engine
|
|
3
|
+
*
|
|
4
|
+
* Implements deterministic Perlin, Simplex, Fractal Brownian Motion (FBM),
|
|
5
|
+
* Ridged Multifractal, Domain Warping, and Cellular (Voronoi) noise algorithms.
|
|
6
|
+
*/
|
|
7
|
+
import type { NoiseLayerConfig } from "./types.js";
|
|
8
|
+
/**
|
|
9
|
+
* Creates a deterministic 512-entry permutation table from a given seed.
|
|
10
|
+
*/
|
|
11
|
+
export declare function createPermutationTable(seedInput?: number | string): Uint8Array;
|
|
12
|
+
export declare function perlin2D(x: number, y: number, perm: Uint8Array): number;
|
|
13
|
+
export declare function simplex2D(x: number, y: number, perm: Uint8Array): number;
|
|
14
|
+
export declare function cellular2D(x: number, y: number, seed: number, jitter?: number): number;
|
|
15
|
+
export declare function fbm2D(x: number, y: number, perm: Uint8Array, octaves?: number, lacunarity?: number, persistence?: number, useSimplex?: boolean): number;
|
|
16
|
+
export declare function ridgedMultifractal2D(x: number, y: number, perm: Uint8Array, octaves?: number, lacunarity?: number, persistence?: number): number;
|
|
17
|
+
export declare function domainWarp2D(x: number, y: number, perm: Uint8Array, strength?: number, octaves?: number): number;
|
|
18
|
+
export interface TerrainNoiseEvaluator {
|
|
19
|
+
sample(x: number, y: number): number;
|
|
20
|
+
sampleNormalized(x: number, y: number): number;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Creates an extensible, multi-octave deterministic procedural terrain noise evaluator.
|
|
24
|
+
*/
|
|
25
|
+
export declare function createTerrainNoise(config?: NoiseLayerConfig): TerrainNoiseEvaluator;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Terrain Physics Integration
|
|
3
|
+
*
|
|
4
|
+
* Heightfield collider generation, bilinear height & normal sampling,
|
|
5
|
+
* and swept raycasting for seamless interaction with RigidBody3D and SoftBody3D.
|
|
6
|
+
*/
|
|
7
|
+
import type { Vector3, Collider3D } from "../physics/types.js";
|
|
8
|
+
import type { HeightmapData } from "./types.js";
|
|
9
|
+
/**
|
|
10
|
+
* Creates a static heightfield collider compatible with AF Motion PhysicsWorld3D.
|
|
11
|
+
*/
|
|
12
|
+
export declare function createTerrainCollider(heightmap: HeightmapData, options?: {
|
|
13
|
+
id?: string;
|
|
14
|
+
friction?: number;
|
|
15
|
+
restitution?: number;
|
|
16
|
+
isTrigger?: boolean;
|
|
17
|
+
}): Collider3D;
|
|
18
|
+
/**
|
|
19
|
+
* Samples terrain elevation at an arbitrary world position using bilinear interpolation.
|
|
20
|
+
*/
|
|
21
|
+
export declare function sampleTerrainHeight(heightmap: HeightmapData, worldX: number, worldZ: number): number;
|
|
22
|
+
/**
|
|
23
|
+
* Samples terrain surface normal at an arbitrary world position.
|
|
24
|
+
*/
|
|
25
|
+
export declare function sampleTerrainNormal(heightmap: HeightmapData, worldX: number, worldZ: number): Vector3;
|
|
26
|
+
/**
|
|
27
|
+
* Fast swept raycaster against terrain heightfield with linear stepping and binary search refinement.
|
|
28
|
+
*/
|
|
29
|
+
export declare function raycastTerrain(heightmap: HeightmapData, rayOrigin: Vector3, rayDir: Vector3, maxDistance?: number): {
|
|
30
|
+
hit: boolean;
|
|
31
|
+
point: Vector3;
|
|
32
|
+
normal: Vector3;
|
|
33
|
+
distance: number;
|
|
34
|
+
} | null;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* AF Motion — 3D Procedural Terrain Engine
|
|
3
|
+
*
|
|
4
|
+
* Master Terrain3D orchestrator coordinating procedural heightmap generation,
|
|
5
|
+
* hydraulic/thermal erosion, biome classification, material splatting,
|
|
6
|
+
* vegetation scattering, chunking, and physics heightfield integration.
|
|
7
|
+
*/
|
|
8
|
+
import type { Terrain3D, TerrainConfig } from "./types.js";
|
|
9
|
+
/**
|
|
10
|
+
* Creates and initializes a complete 3D procedural terrain ecosystem.
|
|
11
|
+
*/
|
|
12
|
+
export declare function createTerrain3D(config?: TerrainConfig): Terrain3D;
|