@vgai/engine 0.2.0 → 0.3.0

package/dist/scene/schema/environment.js

@@ -0,0 +1,357 @@
+import { z } from 'zod';
+import { buildRenderingZod } from '../../render/render-features';
+export const SceneNavigationSchema = z
+    .object({
+    cellSize: z
+        .number()
+        .optional()
+        .describe('Navmesh voxel cell size (smaller = more detail, slower bake)'),
+    cellHeight: z.number().optional().describe('Navmesh voxel cell height'),
+    walkableSlopeAngle: z
+        .number()
+        .optional()
+        .describe('Maximum slope angle (degrees) agents can walk on'),
+    walkableHeight: z
+        .number()
+        .optional()
+        .describe('Minimum ceiling height for walkable areas (in voxels)'),
+    walkableClimb: z
+        .number()
+        .optional()
+        .describe('Maximum step height agents can climb (in voxels)'),
+    walkableRadius: z.number().optional().describe('Agent radius for navmesh erosion (in voxels)'),
+    maxEdgeLen: z.number().optional().describe('Maximum contour edge length in the navmesh'),
+    maxSimplificationError: z
+        .number()
+        .optional()
+        .describe('Maximum deviation for navmesh edge simplification'),
+    minRegionArea: z
+        .number()
+        .optional()
+        .describe('Minimum region area — smaller regions are removed'),
+    mergeRegionArea: z
+        .number()
+        .optional()
+        .describe('Regions smaller than this are merged with neighbors'),
+})
+    .describe('Recast navigation mesh bake parameters');
+export const SceneToneMappingSchema = z
+    .object({
+    mode: z
+        .enum(['none', 'linear', 'reinhard', 'cineon', 'aces', 'agx'])
+        .optional()
+        .describe('Tone mapping operator'),
+    exposure: z.number().optional().describe('Exposure level'),
+})
+    .describe('Tone mapping configuration');
+export const ScenePostProcessingSchema = z
+    .object({
+    // ── Bloom & Vignette ──────────────────────────────────────────────────
+    bloom: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable bloom effect'),
+        intensity: z.number().optional().describe('Bloom intensity multiplier'),
+        luminanceThreshold: z.number().optional().describe('Minimum luminance to trigger bloom'),
+        luminanceSmoothing: z
+            .number()
+            .optional()
+            .describe('Smoothing applied to luminance threshold'),
+    })
+        .optional()
+        .describe('Bloom glow effect'),
+    vignette: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable vignette effect'),
+        darkness: z.number().optional().describe('Vignette darkness intensity'),
+        offset: z.number().optional().describe('Vignette offset from center'),
+    })
+        .optional()
+        .describe('Screen-edge darkening effect'),
+    // ── Color adjustments ─────────────────────────────────────────────────
+    brightnessContrast: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable brightness/contrast adjustment'),
+        brightness: z.number().optional().describe('Brightness adjustment (-1 to 1)'),
+        contrast: z.number().optional().describe('Contrast adjustment (-1 to 1)'),
+    })
+        .optional()
+        .describe('Brightness and contrast color adjustment'),
+    hueSaturation: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable hue/saturation adjustment'),
+        hue: z.number().optional().describe('Hue rotation in radians'),
+        saturation: z.number().optional().describe('Saturation adjustment (-1 to 1)'),
+    })
+        .optional()
+        .describe('Hue rotation and saturation color adjustment'),
+    sepia: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable sepia tone'),
+        intensity: z.number().optional().describe('Sepia effect intensity (0 to 1)'),
+    })
+        .optional()
+        .describe('Warm sepia tone for vintage photograph look'),
+    colorDepth: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable color depth reduction'),
+        bits: z.number().optional().describe('Number of color bits per channel (1–16)'),
+    })
+        .optional()
+        .describe('Reduce color bit depth for posterized/banded look'),
+    // ── Lens effects ──────────────────────────────────────────────────────
+    chromaticAberration: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable chromatic aberration'),
+        offsetX: z.number().optional().describe('Horizontal color fringe offset'),
+        offsetY: z.number().optional().describe('Vertical color fringe offset'),
+        radialModulation: z.boolean().optional().describe('Increase effect toward screen edges'),
+        modulationOffset: z.number().optional().describe('Radial modulation offset from center'),
+    })
+        .optional()
+        .describe('Lens chromatic aberration (color fringing at screen edges)'),
+    lensDistortion: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable lens distortion'),
+        distortionX: z.number().optional().describe('Horizontal barrel/pincushion distortion'),
+        distortionY: z.number().optional().describe('Vertical barrel/pincushion distortion'),
+        focalLengthX: z.number().optional().describe('Horizontal focal length'),
+        focalLengthY: z.number().optional().describe('Vertical focal length'),
+        skew: z.number().optional().describe('Lens skew angle'),
+    })
+        .optional()
+        .describe('Barrel/pincushion lens distortion'),
+    depthOfField: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable depth of field'),
+        worldFocusDistance: z.number().optional().describe('Focus distance in world units'),
+        worldFocusRange: z.number().optional().describe('Focus range in world units'),
+        bokehScale: z.number().optional().describe('Bokeh blur scale'),
+        focalLength: z.number().optional().describe('Camera focal length in mm'),
+    })
+        .optional()
+        .describe('Physically-based depth of field with bokeh blur'),
+    tiltShift: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable tilt-shift effect'),
+        offset: z.number().optional().describe('Focus band offset from center'),
+        rotation: z.number().optional().describe('Focus band rotation in radians'),
+        focusArea: z.number().optional().describe('Focus band width (0–1)'),
+        feather: z.number().optional().describe('Blur falloff smoothness'),
+    })
+        .optional()
+        .describe('Tilt-shift miniature-world blur effect'),
+    // ── Film / retro ──────────────────────────────────────────────────────
+    noise: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable film grain noise'),
+        premultiply: z
+            .boolean()
+            .optional()
+            .describe('Multiply noise with input color instead of adding'),
+    })
+        .optional()
+        .describe('Random per-pixel noise overlay (film grain)'),
+    scanline: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable scanline overlay'),
+        density: z.number().optional().describe('Number of scanlines across screen height'),
+    })
+        .optional()
+        .describe('Horizontal scanline overlay (CRT monitor look)'),
+    dotScreen: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable dot screen halftone'),
+        angle: z.number().optional().describe('Pattern angle in radians'),
+        scale: z.number().optional().describe('Pattern dot scale'),
+    })
+        .optional()
+        .describe('Halftone dot pattern (newspaper/comic look)'),
+    grid: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable grid overlay'),
+        scale: z.number().optional().describe('Grid cell scale'),
+        lineWidth: z.number().optional().describe('Grid line width'),
+    })
+        .optional()
+        .describe('Visible grid pattern overlay'),
+    pixelation: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable pixelation'),
+        granularity: z.number().optional().describe('Pixel size (higher = more pixelated)'),
+    })
+        .optional()
+        .describe('Reduce resolution for pixel-art / mosaic effect'),
+    glitch: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable digital glitch effect'),
+        delayX: z.number().optional().describe('Minimum delay between glitches (seconds)'),
+        delayY: z.number().optional().describe('Maximum delay between glitches (seconds)'),
+        durationX: z.number().optional().describe('Minimum glitch duration (seconds)'),
+        durationY: z.number().optional().describe('Maximum glitch duration (seconds)'),
+        strengthX: z.number().optional().describe('Minimum glitch strength'),
+        strengthY: z.number().optional().describe('Maximum glitch strength'),
+        columns: z.number().optional().describe('Number of glitch columns'),
+        ratio: z.number().optional().describe('Glitch ratio (0–1)'),
+    })
+        .optional()
+        .describe('Random digital glitch artifacts (block displacement, color shifting)'),
+    // ── Distortion ────────────────────────────────────────────────────────
+    shockWave: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable shock wave distortion'),
+        speed: z.number().optional().describe('Wave propagation speed'),
+        maxRadius: z.number().optional().describe('Maximum wave radius'),
+        waveSize: z.number().optional().describe('Width of the distortion wave'),
+        amplitude: z.number().optional().describe('Distortion strength'),
+        positionX: z.number().optional().describe('Wave origin X in world space'),
+        positionY: z.number().optional().describe('Wave origin Y in world space'),
+        positionZ: z.number().optional().describe('Wave origin Z in world space'),
+    })
+        .optional()
+        .describe('Expanding spherical distortion wave from a point'),
+    // ── Anti-aliasing ─────────────────────────────────────────────────────
+    smaa: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable SMAA anti-aliasing'),
+        preset: z
+            .enum(['low', 'medium', 'high', 'ultra'])
+            .optional()
+            .describe('Quality preset (higher = better quality, more cost)'),
+    })
+        .optional()
+        .describe('Subpixel Morphological Anti-Aliasing'),
+    // ── Ambient occlusion ─────────────────────────────────────────────────
+    ssao: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable screen-space ambient occlusion'),
+        radius: z.number().optional().describe('Occlusion sampling radius'),
+        intensity: z.number().optional().describe('Occlusion intensity multiplier'),
+        bias: z.number().optional().describe('Depth bias to reduce self-occlusion artifacts'),
+        samples: z.number().optional().describe('Number of occlusion samples per pixel'),
+        rings: z.number().optional().describe('Number of spiral sample rings'),
+        fade: z.number().optional().describe('Distance at which occlusion fades out'),
+        color: z.string().optional().describe('Occlusion tint color as CSS hex'),
+    })
+        .optional()
+        .describe('Screen-space ambient occlusion (darken creases and crevices)'),
+    n8ao: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable N8AO ambient occlusion'),
+        aoSamples: z.number().optional().describe('Number of AO samples (default 16)'),
+        aoRadius: z.number().optional().describe('AO sampling radius in world units'),
+        intensity: z.number().optional().describe('AO intensity multiplier'),
+        denoiseSamples: z.number().optional().describe('Number of denoise samples'),
+        denoiseRadius: z.number().optional().describe('Denoise blur radius'),
+        distanceFalloff: z.number().optional().describe('AO distance falloff'),
+        screenSpaceRadius: z
+            .boolean()
+            .optional()
+            .describe('Use screen-space radius instead of world-space'),
+        color: z.string().optional().describe('AO tint color as CSS hex'),
+        halfRes: z.boolean().optional().describe('Render AO at half resolution for performance'),
+    })
+        .optional()
+        .describe('High-quality ambient occlusion (N8AO — alternative to SSAO)'),
+    // ── Entity-referencing effects ────────────────────────────────────────
+    godRays: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable god rays'),
+        sourceEntity: z.string().optional().describe('Entity ID of the light source mesh'),
+        density: z.number().optional().describe('Ray density'),
+        decay: z.number().optional().describe('Ray intensity decay along distance'),
+        weight: z.number().optional().describe('Ray weight / brightness'),
+        exposure: z.number().optional().describe('Overall god ray exposure'),
+        samples: z.number().optional().describe('Number of ray-march samples'),
+    })
+        .optional()
+        .describe('Volumetric light shafts from a light source entity'),
+    outline: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable outline effect'),
+        tags: z.array(z.string()).optional().describe('Entity tags to outline'),
+        edgeStrength: z.number().optional().describe('Outline edge thickness / strength'),
+        pulseSpeed: z.number().optional().describe('Outline pulse animation speed (0 = no pulse)'),
+        visibleEdgeColor: z.string().optional().describe('Color of visible edges as CSS hex'),
+        hiddenEdgeColor: z
+            .string()
+            .optional()
+            .describe('Color of hidden/occluded edges as CSS hex'),
+        xRay: z.boolean().optional().describe('Show outline through occluding objects'),
+    })
+        .optional()
+        .describe('Highlight entities matching tags with colored outlines'),
+    // ── Screen-space reflections & GI (realism-effects) ───────────────────
+    ssr: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable screen-space reflections'),
+        intensity: z.number().optional().describe('Reflection intensity'),
+        exponent: z.number().optional().describe('Reflection falloff exponent'),
+        distance: z.number().optional().describe('Maximum reflection ray distance'),
+        thickness: z.number().optional().describe('Depth thickness for hit testing'),
+        maxRoughness: z.number().optional().describe('Maximum roughness for reflections (0–1)'),
+    })
+        .optional()
+        .describe('Screen-space reflections for reflective/glossy surfaces'),
+    ssgi: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable screen-space global illumination'),
+        intensity: z.number().optional().describe('Indirect light intensity'),
+        distance: z.number().optional().describe('Maximum GI ray distance'),
+        thickness: z.number().optional().describe('Depth thickness for hit testing'),
+        maxRoughness: z.number().optional().describe('Maximum roughness for GI (0–1)'),
+    })
+        .optional()
+        .describe('Screen-space global illumination (indirect lighting bounce)'),
+    motionBlur: z
+        .object({
+        enabled: z.boolean().optional().describe('Enable motion blur'),
+        intensity: z.number().optional().describe('Motion blur intensity'),
+        jitter: z.number().optional().describe('Sample jitter amount'),
+        samples: z.number().optional().describe('Number of blur samples'),
+    })
+        .optional()
+        .describe('Per-object motion blur from camera and object movement'),
+})
+    .describe('Post-processing effects');
+export const ScenePhysicsSettingsSchema = z
+    .object({
+    collisionLayers: z
+        .array(z.string())
+        .optional()
+        .describe('Named collision layers (up to 16). Index = bit position in collision bitmasks'),
+})
+    .describe('Physics world settings');
+export const SceneEnvironmentSchema = z
+    .object({
+    background: z.string().optional().describe('Background color as CSS hex string'),
+    ambient: z
+        .object({
+        color: z.string().describe('Ambient light color'),
+        intensity: z.number().describe('Ambient light intensity'),
+    })
+        .optional()
+        .describe('Global ambient light'),
+    fog: z
+        .object({
+        type: z.enum(['linear', 'exponential']).describe('Fog falloff type'),
+        color: z.string().describe('Fog color'),
+        near: z.number().optional().describe('Fog start distance (linear only)'),
+        far: z.number().optional().describe('Fog end distance (linear only)'),
+        density: z.number().optional().describe('Fog density (exponential only)'),
+    })
+        .optional()
+        .describe('Distance fog settings'),
+    skybox: z.string().optional().describe('Path to HDR/EXR skybox environment map'),
+    envMapIntensity: z
+        .number()
+        .optional()
+        .describe('Environment map reflection intensity multiplier'),
+    toneMapping: SceneToneMappingSchema.optional().describe('Tone mapping configuration'),
+    postProcessing: ScenePostProcessingSchema.optional().describe('Post-processing effects (bloom, vignette)'),
+    navigation: SceneNavigationSchema.optional().describe('Navigation mesh bake settings'),
+    physics: ScenePhysicsSettingsSchema.optional().describe('Physics world settings'),
+    rendering: buildRenderingZod()
+        .optional()
+        .describe('Scene-level render feature toggles (auto-batching, culling, LOD, shadows, etc.). Omit a field to inherit the engine default. Derived from the render-feature registry.'),
+})
+    .describe('Scene-level environment and rendering settings');

package/dist/scene/schema/index.d.ts

@@ -0,0 +1,39 @@
+export type { SceneAnimation } from './animation';
+export { SceneAnimationSchema } from './animation';
+export type { SceneAudio } from './audio';
+export { SceneAudioSchema } from './audio';
+export type { SceneCamera } from './camera';
+export { SceneCameraSchema } from './camera';
+export type { SceneCollider } from './collider';
+export { SceneColliderSchema } from './collider';
+export type { SceneEntity } from './entity';
+export { SceneEntitySchema } from './entity';
+export type { EntityRef } from './entity-ref';
+export { EntityRefSchema, isEntityRefSchema } from './entity-ref';
+export type { SceneEnvironment, SceneNavigation, ScenePhysicsSettings, ScenePostProcessing, SceneToneMapping, } from './environment';
+export { SceneEnvironmentSchema, SceneNavigationSchema, ScenePhysicsSettingsSchema, ScenePostProcessingSchema, SceneToneMappingSchema, } from './environment';
+export type { InstancesFile } from './instances';
+export { InstancesFileSchema } from './instances';
+export type { SceneJoint } from './joint';
+export { SceneJointSchema } from './joint';
+export type { SceneLight } from './light';
+export { SceneLightSchema } from './light';
+export type { MaterialFile, SceneMaterial } from './material';
+export { MaterialFileSchema, SceneMaterialSchema } from './material';
+export type { SceneMesh } from './mesh';
+export { SceneMeshSchema } from './mesh';
+export type { SceneParticles } from './particles';
+export { SceneParticlesOverrideSchema, SceneParticlesSchema } from './particles';
+export type { ScenePhysics } from './physics';
+export { ScenePhysicsSchema } from './physics';
+export type { PrefabFile, SceneFile } from './scene-file';
+export { mergePrefabInstance, PrefabFileSchema, SceneFileSchema } from './scene-file';
+export type { SceneShadow } from './shadow';
+export { SceneShadowSchema } from './shadow';
+export type { SceneSpline } from './spline';
+export { SceneSplineOverrideSchema, SceneSplineSchema } from './spline';
+export type { Quat, SceneTransform, Vec3 } from './tuples';
+export { QuatSchema, TransformSchema, Vec3Schema } from './tuples';
+export type { UIAnimatableProperty, UIAnimation, UIBinding, UIEasing, UIKeyframe, UILayout, UINode, UINodeKind, UIPrefabFile, UIRoot, UIStyle, UITheme, UIThemeFile, UITrack, } from './ui';
+export { UIAnimatablePropertySchema, UIAnimationSchema, UIBindingSchema, UIEasingSchema, UIKeyframeSchema, UILayoutSchema, UINodeKindSchema, UINodeSchema, UIPrefabFileSchema, UIRootSchema, UIStateStylesSchema, UIStyleSchema, UIThemeFileSchema, UIThemeSchema, UITrackSchema, } from './ui';
+//# sourceMappingURL=index.d.ts.map

package/dist/scene/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scene/schema/index.ts"],"names":[],"mappings":"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"}

package/dist/scene/schema/index.js

@@ -0,0 +1,20 @@
+// Zod schemas
+export { SceneAnimationSchema } from './animation';
+export { SceneAudioSchema } from './audio';
+export { SceneCameraSchema } from './camera';
+export { SceneColliderSchema } from './collider';
+export { SceneEntitySchema } from './entity';
+export { EntityRefSchema, isEntityRefSchema } from './entity-ref';
+export { SceneEnvironmentSchema, SceneNavigationSchema, ScenePhysicsSettingsSchema, ScenePostProcessingSchema, SceneToneMappingSchema, } from './environment';
+export { InstancesFileSchema } from './instances';
+export { SceneJointSchema } from './joint';
+export { SceneLightSchema } from './light';
+export { MaterialFileSchema, SceneMaterialSchema } from './material';
+export { SceneMeshSchema } from './mesh';
+export { SceneParticlesOverrideSchema, SceneParticlesSchema } from './particles';
+export { ScenePhysicsSchema } from './physics';
+export { mergePrefabInstance, PrefabFileSchema, SceneFileSchema } from './scene-file';
+export { SceneShadowSchema } from './shadow';
+export { SceneSplineOverrideSchema, SceneSplineSchema } from './spline';
+export { QuatSchema, TransformSchema, Vec3Schema } from './tuples';
+export { UIAnimatablePropertySchema, UIAnimationSchema, UIBindingSchema, UIEasingSchema, UIKeyframeSchema, UILayoutSchema, UINodeKindSchema, UINodeSchema, UIPrefabFileSchema, UIRootSchema, UIStateStylesSchema, UIStyleSchema, UIThemeFileSchema, UIThemeSchema, UITrackSchema, } from './ui';

package/dist/scene/schema/instances.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+/**
+ * `.instances.json` — a declarative, authored-data instance-transform asset
+ * (F3, docs/VSCN-STRUCTURAL-GAPS-DESIGN.md). Referenced by `mesh.instances`
+ * as the data counterpart to `mesh.instancer` (a code-registered generator):
+ * a bare array of 10-number tuples, one per instance, each
+ * `[posX,posY,posZ, quatX,quatY,quatZ,quatW, scaleX,scaleY,scaleZ]`. The
+ * scene loader fetches+parses this file and renders it as one
+ * `THREE.InstancedMesh` (one draw call) — bulk transform data is referenced
+ * as an asset, never inlined into the vscn (keeps vscn thin — gate G4).
+ */
+export declare const InstancesFileSchema: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+export type InstancesFile = z.infer<typeof InstancesFileSchema>;
+//# sourceMappingURL=instances.d.ts.map

package/dist/scene/schema/instances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/scene/schema/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,kKAoB7B,CAAC;AAEJ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/scene/schema/instances.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+/**
+ * `.instances.json` — a declarative, authored-data instance-transform asset
+ * (F3, docs/VSCN-STRUCTURAL-GAPS-DESIGN.md). Referenced by `mesh.instances`
+ * as the data counterpart to `mesh.instancer` (a code-registered generator):
+ * a bare array of 10-number tuples, one per instance, each
+ * `[posX,posY,posZ, quatX,quatY,quatZ,quatW, scaleX,scaleY,scaleZ]`. The
+ * scene loader fetches+parses this file and renders it as one
+ * `THREE.InstancedMesh` (one draw call) — bulk transform data is referenced
+ * as an asset, never inlined into the vscn (keeps vscn thin — gate G4).
+ */
+export const InstancesFileSchema = z
+    .array(z.tuple([
+    z.number().describe('posX'),
+    z.number().describe('posY'),
+    z.number().describe('posZ'),
+    z.number().describe('quatX'),
+    z.number().describe('quatY'),
+    z.number().describe('quatZ'),
+    z.number().describe('quatW'),
+    z.number().describe('scaleX'),
+    z.number().describe('scaleY'),
+    z.number().describe('scaleZ'),
+]))
+    .describe('Instance-transform asset (.instances.json): an array of 10-number tuples ' +
+    '[posX,posY,posZ, quatX,quatY,quatZ,quatW, scaleX,scaleY,scaleZ], one per instance. ' +
+    'Referenced by a mesh via `mesh.instances` and rendered as a single THREE.InstancedMesh ' +
+    '(one draw call).');

package/dist/scene/schema/joint.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export declare const SceneJointSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        fixed: "fixed";
+        revolute: "revolute";
+        prismatic: "prismatic";
+        spherical: "spherical";
+        spring: "spring";
+    }>;
+    target: z.ZodString;
+    anchor: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    targetAnchor: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    axis: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    limits: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+    }, z.core.$strip>>;
+    stiffness: z.ZodOptional<z.ZodNumber>;
+    damping: z.ZodOptional<z.ZodNumber>;
+    restLength: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SceneJoint = z.infer<typeof SceneJointSchema>;
+//# sourceMappingURL=joint.d.ts.map

package/dist/scene/schema/joint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joint.d.ts","sourceRoot":"","sources":["../../../src/scene/schema/joint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;iBAoB6B,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/scene/schema/joint.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { Vec3Schema } from './tuples';
+export const SceneJointSchema = z
+    .object({
+    type: z
+        .enum(['fixed', 'revolute', 'prismatic', 'spherical', 'spring'])
+        .describe('Joint constraint type'),
+    target: z.string().describe('Entity ID of the body this joint connects to'),
+    anchor: Vec3Schema.optional().describe('Local anchor point on this body'),
+    targetAnchor: Vec3Schema.optional().describe('Local anchor point on the target body'),
+    axis: Vec3Schema.optional().describe('Rotation/slide axis for revolute and prismatic joints'),
+    limits: z
+        .object({
+        min: z.number().describe('Minimum angle (degrees) or distance'),
+        max: z.number().describe('Maximum angle (degrees) or distance'),
+    })
+        .optional()
+        .describe('Angle or distance limits for revolute/prismatic joints'),
+    stiffness: z.number().optional().describe('Spring stiffness coefficient'),
+    damping: z.number().optional().describe('Spring damping coefficient'),
+    restLength: z.number().optional().describe('Spring rest length'),
+})
+    .describe('Physics joint constraint between two bodies');

package/dist/scene/schema/light.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const SceneLightSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        directional: "directional";
+        point: "point";
+        spot: "spot";
+        hemisphere: "hemisphere";
+        area: "area";
+    }>;
+    color: z.ZodOptional<z.ZodString>;
+    intensity: z.ZodOptional<z.ZodNumber>;
+    groundColor: z.ZodOptional<z.ZodString>;
+    distance: z.ZodOptional<z.ZodNumber>;
+    angle: z.ZodOptional<z.ZodNumber>;
+    penumbra: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Partial schema for prefab instance overrides (type not required). */
+export declare const SceneLightOverrideSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        directional: "directional";
+        point: "point";
+        spot: "spot";
+        hemisphere: "hemisphere";
+        area: "area";
+    }>>;
+    color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    intensity: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    groundColor: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    distance: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    angle: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    penumbra: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    width: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+    height: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type SceneLight = z.infer<typeof SceneLightSchema>;
+//# sourceMappingURL=light.d.ts.map

package/dist/scene/schema/light.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light.d.ts","sourceRoot":"","sources":["../../../src/scene/schema/light.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAGW,CAAC;AAEzC,wEAAwE;AACxE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;iBAA2B,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/scene/schema/light.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+const SceneLightBase = z.object({
+    type: z.enum(['directional', 'point', 'spot', 'hemisphere', 'area']).describe('Light type'),
+    color: z.string().optional().describe('Light color as CSS hex string'),
+    intensity: z.number().optional().describe('Light intensity multiplier'),
+    groundColor: z.string().optional().describe('Ground color for hemisphere lights'),
+    distance: z
+        .number()
+        .optional()
+        .describe('Maximum range of the light. 0 = infinite (point/spot only)'),
+    angle: z.number().optional().describe('Spotlight cone angle in radians (spot only)'),
+    penumbra: z.number().optional().describe('Spotlight penumbra softness 0–1 (spot only)'),
+    width: z
+        .number()
+        .optional()
+        .describe('Area light width (area only). RectAreaLight has NO shadow support and only affects ' +
+        'Standard/Physical materials — degrades loudly, not silently.'),
+    height: z
+        .number()
+        .optional()
+        .describe('Area light height (area only). RectAreaLight has NO shadow support and only affects ' +
+        'Standard/Physical materials — degrades loudly, not silently.'),
+});
+export const SceneLightSchema = SceneLightBase.refine((l) => l.type !== 'spot' || l.angle === undefined || l.angle > 0, { message: 'Spot light angle must be positive' }).describe('Light source configuration');
+/** Partial schema for prefab instance overrides (type not required). */
+export const SceneLightOverrideSchema = SceneLightBase.partial();