@jgengine/core 0.10.0 → 0.11.0

package/dist/world/volumetricClouds.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Volumetric cloud layer config for `sky()` — a raymarched cloud slab mounted from the environment
+ * `sky` seam. Pure config + defaulting here; the raymarch shader lives in the `shell` renderer
+ * (`environment/VolumetricClouds.tsx`), mounted alongside `SkyDome` whenever a sky descriptor carries
+ * this field. Off by default — omit `volumetricClouds` on `sky({...})` and no layer mounts.
+ *
+ * @capability volumetric-clouds raymarched cloud layer sky option
+ */
+/** Volumetric cloud layer params, as authored on `sky({ volumetricClouds })`. All fields optional. */
+export interface VolumetricCloudsConfig {
+    /** Fraction of the sky covered by cloud mass, 0..1. Higher = more overcast. Default 0.42. */
+    coverage?: number;
+    /** Raymarch density multiplier — thicker, more opaque cloud bodies at higher values. Default 1.5. */
+    density?: number;
+    /** Cloud layer base altitude in world units. Default 90. */
+    height?: number;
+    /** Cloud layer vertical thickness in world units. Default 55. */
+    thickness?: number;
+    /** Horizontal drift speed, world units/second. Default 1.1. */
+    speed?: number;
+    /** Noise feature scale — world units per cloud puff; larger = bigger, fewer puffs. Default 140. */
+    scale?: number;
+    /** Cloud body base color (shadowed side). Default "#c9d3de". */
+    color?: string;
+    /** Sun-facing lit edge color (silver-lining / forward scatter). Default "#fff6e0". */
+    sunColor?: string;
+    /** Forward sun-scatter strength, 0..1 — brighter, more luminous edges toward the sun. Default 0.9. */
+    sunScatter?: number;
+    /** Seed string; same seed reproduces the same cloud layout. */
+    seed?: string;
+}
+/** Fully-defaulted volumetric cloud params, resolved from a `VolumetricCloudsConfig`. */
+export interface VolumetricCloudsRules {
+    coverage: number;
+    density: number;
+    height: number;
+    thickness: number;
+    speed: number;
+    scale: number;
+    color: string;
+    sunColor: string;
+    sunScatter: number;
+    seed: string;
+}
+/** Volumetric cloud defaults: a moderate, drifting cumulus layer. */
+export declare const VOLUMETRIC_CLOUDS_DEFAULTS: VolumetricCloudsRules;
+/**
+ * Resolve a `VolumetricCloudsConfig` into fully-defaulted, clamped rules — pure, no shader/DOM
+ * involved, so the defaulting logic is unit-testable without a renderer.
+ * @internal
+ */
+export declare function resolveVolumetricClouds(config?: VolumetricCloudsConfig): VolumetricCloudsRules;

package/dist/world/volumetricClouds.js

@@ -0,0 +1,43 @@
+/**
+ * Volumetric cloud layer config for `sky()` — a raymarched cloud slab mounted from the environment
+ * `sky` seam. Pure config + defaulting here; the raymarch shader lives in the `shell` renderer
+ * (`environment/VolumetricClouds.tsx`), mounted alongside `SkyDome` whenever a sky descriptor carries
+ * this field. Off by default — omit `volumetricClouds` on `sky({...})` and no layer mounts.
+ *
+ * @capability volumetric-clouds raymarched cloud layer sky option
+ */
+/** Volumetric cloud defaults: a moderate, drifting cumulus layer. */
+export const VOLUMETRIC_CLOUDS_DEFAULTS = {
+    coverage: 0.42,
+    density: 1.5,
+    height: 90,
+    thickness: 55,
+    speed: 1.1,
+    scale: 140,
+    color: "#c9d3de",
+    sunColor: "#fff6e0",
+    sunScatter: 0.9,
+    seed: "",
+};
+/**
+ * Resolve a `VolumetricCloudsConfig` into fully-defaulted, clamped rules — pure, no shader/DOM
+ * involved, so the defaulting logic is unit-testable without a renderer.
+ * @internal
+ */
+export function resolveVolumetricClouds(config = {}) {
+    return {
+        coverage: clamp01(config.coverage ?? VOLUMETRIC_CLOUDS_DEFAULTS.coverage),
+        density: Math.max(0, config.density ?? VOLUMETRIC_CLOUDS_DEFAULTS.density),
+        height: config.height ?? VOLUMETRIC_CLOUDS_DEFAULTS.height,
+        thickness: Math.max(1, config.thickness ?? VOLUMETRIC_CLOUDS_DEFAULTS.thickness),
+        speed: config.speed ?? VOLUMETRIC_CLOUDS_DEFAULTS.speed,
+        scale: Math.max(1, config.scale ?? VOLUMETRIC_CLOUDS_DEFAULTS.scale),
+        color: config.color ?? VOLUMETRIC_CLOUDS_DEFAULTS.color,
+        sunColor: config.sunColor ?? VOLUMETRIC_CLOUDS_DEFAULTS.sunColor,
+        sunScatter: clamp01(config.sunScatter ?? VOLUMETRIC_CLOUDS_DEFAULTS.sunScatter),
+        seed: config.seed ?? VOLUMETRIC_CLOUDS_DEFAULTS.seed,
+    };
+}
+function clamp01(value) {
+    return Math.min(1, Math.max(0, value));
+}

package/dist/world/walls.d.ts

@@ -27,11 +27,17 @@ export interface RoofConfig {
     pitch?: number;
     overhang?: number;
 }
+/** @internal */
 export declare function wallSegments(points: readonly Vec2[], closed: boolean): WallSegment[];
+/** @internal */
 export declare function isEnclosed(points: readonly Vec2[], tolerance?: number): boolean;
+/** @internal */
 export declare function enclosePath(points: readonly Vec2[], tolerance?: number): readonly Vec2[];
+/** @internal */
 export declare function polygonArea(polygon: readonly Vec2[]): number;
+/** @internal */
 export declare function footprintFromWalls(points: readonly Vec2[], tolerance?: number): EnclosedFootprint | null;
+/** @internal */
 export declare function autoRoof(footprint: EnclosedFootprint, config?: RoofConfig): RoofPlan;
 export type PaintTarget = "floor" | "wall";
 export interface SurfacePaintStore {
@@ -42,6 +48,7 @@ export interface SurfacePaintStore {
     snapshot(): Record<PaintTarget, Record<string, string>>;
     restore(snapshot: Record<PaintTarget, Record<string, string>>): void;
 }
+/** @internal */
 export declare function createSurfacePaint(): SurfacePaintStore;
 export interface WallDrawTool {
     addPoint(point: Vec2, snap?: number): Vec2;
@@ -54,8 +61,10 @@ export interface WallDrawTool {
     footprint(): EnclosedFootprint | null;
     roof(config?: RoofConfig): RoofPlan | null;
 }
+/** @internal */
 export declare function createWallDrawTool(config?: {
     snap?: number;
     closeTolerance?: number;
 }): WallDrawTool;
+/** @internal */
 export declare function wallSegmentBounds(segment: WallSegment, thickness: number): Aabb;

package/dist/world/walls.js

@@ -1,4 +1,5 @@
 import { footprintAabb } from "./geometry.js";
+/** @internal */
 export function wallSegments(points, closed) {
     const segments = [];
     const count = closed ? points.length : points.length - 1;
@@ -11,6 +12,7 @@ export function wallSegments(points, closed) {
     }
     return segments;
 }
+/** @internal */
 export function isEnclosed(points, tolerance = 0.5) {
     if (points.length < 3)
         return false;
@@ -18,6 +20,7 @@ export function isEnclosed(points, tolerance = 0.5) {
     const last = points[points.length - 1];
     return Math.hypot(first[0] - last[0], first[1] - last[1]) <= tolerance;
 }
+/** @internal */
 export function enclosePath(points, tolerance = 0.5) {
     if (points.length < 3)
         return points;
@@ -25,6 +28,7 @@ export function enclosePath(points, tolerance = 0.5) {
         return points;
     return points.slice(0, points.length - 1);
 }
+/** @internal */
 export function polygonArea(polygon) {
     let sum = 0;
     for (let index = 0; index < polygon.length; index += 1) {
@@ -34,6 +38,7 @@ export function polygonArea(polygon) {
     }
     return Math.abs(sum) / 2;
 }
+/** @internal */
 export function footprintFromWalls(points, tolerance = 0.5) {
     const closed = isEnclosed(points, tolerance);
     const polygon = enclosePath(points, tolerance);
@@ -65,6 +70,7 @@ export function footprintFromWalls(points, tolerance = 0.5) {
         closed,
     };
 }
+/** @internal */
 export function autoRoof(footprint, config = {}) {
     const style = config.style ?? "hip";
     const eaveHeight = config.eaveHeight ?? 3;
@@ -131,6 +137,7 @@ export function autoRoof(footprint, config = {}) {
     }
     return { style, ridge, apexHeight, eaveHeight, faces };
 }
+/** @internal */
 export function createSurfacePaint() {
     const maps = {
         floor: new Map(),
@@ -166,6 +173,7 @@ function snapPoint(point, grid) {
         return point;
     return [Math.round(point[0] / grid) * grid, Math.round(point[1] / grid) * grid];
 }
+/** @internal */
 export function createWallDrawTool(config = {}) {
     const defaultSnap = config.snap ?? 0;
     const closeTolerance = config.closeTolerance ?? 0.5;
@@ -214,6 +222,7 @@ export function createWallDrawTool(config = {}) {
         },
     };
 }
+/** @internal */
 export function wallSegmentBounds(segment, thickness) {
     const center = [(segment.from[0] + segment.to[0]) / 2, (segment.from[1] + segment.to[1]) / 2];
     const quarterTurns = Math.abs(Math.round(segment.angle / (Math.PI / 2))) % 2;

package/dist/world/waterKind.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `water` studio: a parametric water surface authored as a box volume — its XZ footprint becomes the
+ * water plane, its top face the water height. Pure config here (color/wave/foam/opacity params + a
+ * footprint resolver); the animated shader plane lives in the `shell` renderer, which maps these
+ * params onto the existing Ocean material. A scene kind so a pond or moat is dragged in the editor and
+ * tuned with sliders, persisted in `editor.scene.json`. Distinct from the infinite `waterSurface`
+ * ocean primitive (`./water`) — this is a bounded, editor-authored patch.
+ *
+ * @capability water parametric water surface volume
+ */
+import { type ParamSchema, type SceneKindObject } from "../scene/sceneKinds.js";
+/** The editor volume kind marking a box as a water surface. */
+export declare const WATER_VOLUME_KIND = "water";
+/** Fully-defaulted water surface params parsed from a volume's `meta`. */
+export interface WaterRules {
+    /** Deep-water base color (hex). */
+    color: string;
+    /** Shallow/edge tint blended toward the shore (hex). */
+    shallowColor: string;
+    /** Wave amplitude in meters. */
+    waveHeight: number;
+    /** Wave scroll speed multiplier. */
+    waveSpeed: number;
+    /** Spatial wave frequency (waves per meter). */
+    waveScale: number;
+    /** Foam band width at the shoreline, meters. */
+    foam: number;
+    /** Surface opacity, 0..1. */
+    opacity: number;
+    /** Reflection/metalness strength, 0..1. */
+    reflectivity: number;
+}
+/** Water defaults: a calm blue-green pond with a soft foam edge. */
+export declare const WATER_DEFAULTS: WaterRules;
+/** The water parameter schema — drives the inspector and `meta` parse via the studio seam. */
+export declare const WATER_SCHEMA: ParamSchema;
+/** Parse a volume's `meta` into fully-defaulted water rules. @internal */
+export declare function readWaterRules(meta: Record<string, unknown> | undefined): WaterRules;
+/** A resolved water surface: world-space plane center/size (XZ) at surface height `y`, plus its params. */
+export interface ResolvedWater {
+    center: readonly [number, number, number];
+    /** Full width (X) and depth (Z) of the water plane in meters. */
+    size: readonly [number, number];
+    rules: WaterRules;
+}
+/**
+ * Resolve a water volume into a flat surface: the box footprint (`halfExtents`, else `radius`) becomes
+ * the plane size, the box top (`center.y + halfExtents.y`) the water height. Returns null for a
+ * degenerate footprint. Reads footprint from the object's `halfExtents`/`radius` meta mirror written
+ * by the volume, falling back to a 20 m square.
+ * @internal
+ */
+export declare function resolveWaterObject(object: SceneKindObject): ResolvedWater | null;
+/** Registers the `water` scene kind (schema + resolver). Called by {@link registerBuiltinSceneKinds}. @internal */
+export declare function registerWaterKind(): void;

package/dist/world/waterKind.js

@@ -0,0 +1,99 @@
+/**
+ * `water` studio: a parametric water surface authored as a box volume — its XZ footprint becomes the
+ * water plane, its top face the water height. Pure config here (color/wave/foam/opacity params + a
+ * footprint resolver); the animated shader plane lives in the `shell` renderer, which maps these
+ * params onto the existing Ocean material. A scene kind so a pond or moat is dragged in the editor and
+ * tuned with sliders, persisted in `editor.scene.json`. Distinct from the infinite `waterSurface`
+ * ocean primitive (`./water`) — this is a bounded, editor-authored patch.
+ *
+ * @capability water parametric water surface volume
+ */
+import { registerSceneKind } from "../scene/sceneKinds.js";
+/** The editor volume kind marking a box as a water surface. */
+export const WATER_VOLUME_KIND = "water";
+/** Water defaults: a calm blue-green pond with a soft foam edge. */
+export const WATER_DEFAULTS = {
+    color: "#1c6c86",
+    shallowColor: "#4bb6bf",
+    waveHeight: 0.12,
+    waveSpeed: 0.6,
+    waveScale: 0.35,
+    foam: 1.2,
+    opacity: 0.86,
+    reflectivity: 0.4,
+};
+/** The water parameter schema — drives the inspector and `meta` parse via the studio seam. */
+export const WATER_SCHEMA = {
+    fields: [
+        { type: "color", key: "color", label: "deep color", default: WATER_DEFAULTS.color },
+        { type: "color", key: "shallowColor", label: "shallow color", default: WATER_DEFAULTS.shallowColor },
+        { type: "range", key: "waveHeight", label: "wave height", min: 0, max: 1, step: 0.01, default: WATER_DEFAULTS.waveHeight, unit: "m" },
+        { type: "range", key: "waveSpeed", label: "wave speed", min: 0, max: 3, step: 0.05, default: WATER_DEFAULTS.waveSpeed },
+        { type: "range", key: "waveScale", label: "wave scale", min: 0.02, max: 2, step: 0.02, default: WATER_DEFAULTS.waveScale },
+        { type: "range", key: "foam", label: "foam edge", min: 0, max: 6, step: 0.1, default: WATER_DEFAULTS.foam, unit: "m" },
+        { type: "range", key: "opacity", label: "opacity", min: 0.1, max: 1, step: 0.01, default: WATER_DEFAULTS.opacity },
+        { type: "range", key: "reflectivity", label: "reflectivity", min: 0, max: 1, step: 0.01, default: WATER_DEFAULTS.reflectivity },
+    ],
+};
+function metaNumber(meta, key, fallback) {
+    const value = meta?.[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function metaString(meta, key, fallback) {
+    const value = meta?.[key];
+    return typeof value === "string" ? value : fallback;
+}
+/** Parse a volume's `meta` into fully-defaulted water rules. @internal */
+export function readWaterRules(meta) {
+    return {
+        color: metaString(meta, "color", WATER_DEFAULTS.color),
+        shallowColor: metaString(meta, "shallowColor", WATER_DEFAULTS.shallowColor),
+        waveHeight: Math.max(0, metaNumber(meta, "waveHeight", WATER_DEFAULTS.waveHeight)),
+        waveSpeed: Math.max(0, metaNumber(meta, "waveSpeed", WATER_DEFAULTS.waveSpeed)),
+        waveScale: Math.max(0.01, metaNumber(meta, "waveScale", WATER_DEFAULTS.waveScale)),
+        foam: Math.max(0, metaNumber(meta, "foam", WATER_DEFAULTS.foam)),
+        opacity: Math.min(1, Math.max(0, metaNumber(meta, "opacity", WATER_DEFAULTS.opacity))),
+        reflectivity: Math.min(1, Math.max(0, metaNumber(meta, "reflectivity", WATER_DEFAULTS.reflectivity))),
+    };
+}
+/** Reads a numeric field off a possibly-untyped `{x,y,z}`-ish object. */
+function axis(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+/**
+ * Resolve a water volume into a flat surface: the box footprint (`halfExtents`, else `radius`) becomes
+ * the plane size, the box top (`center.y + halfExtents.y`) the water height. Returns null for a
+ * degenerate footprint. Reads footprint from the object's `halfExtents`/`radius` meta mirror written
+ * by the volume, falling back to a 20 m square.
+ * @internal
+ */
+export function resolveWaterObject(object) {
+    const center = object.center ?? object.position;
+    if (center === undefined)
+        return null;
+    const meta = object.meta;
+    const he = object.halfExtents;
+    const radius = object.radius ?? axis(meta?.["radius"]);
+    const halfX = axis(he?.x) ?? radius ?? 10;
+    const halfZ = axis(he?.z) ?? radius ?? 10;
+    const halfY = axis(he?.y) ?? 0;
+    const width = Math.max(0.1, halfX * 2);
+    const depth = Math.max(0.1, halfZ * 2);
+    return { center: [center.x, center.y + halfY, center.z], size: [width, depth], rules: readWaterRules(meta) };
+}
+/** Registers the `water` scene kind (schema + resolver). Called by {@link registerBuiltinSceneKinds}. @internal */
+export function registerWaterKind() {
+    registerSceneKind({
+        kind: WATER_VOLUME_KIND,
+        target: "volume",
+        label: "Water surface",
+        addCategory: "Studios",
+        accent: "#38bdf8",
+        schema: WATER_SCHEMA,
+        resolve: (object) => resolveWaterObject(object),
+        note: (object) => {
+            const resolved = resolveWaterObject(object);
+            return resolved === null ? "Give the volume a box footprint." : `${Math.round(resolved.size[0])}×${Math.round(resolved.size[1])} m surface`;
+        },
+    });
+}

package/dist/world.d.ts

@@ -0,0 +1,132 @@
+export { type HeatConfig, type HeatGain, type HeatLevelDef, type HeatState } from "./ai/heatSystem.js";
+export { advanceInterestGate, createInterestCensus, createInterestGateState, interestPhase, type InterestCensus, type InterestCensusAccumulator, type InterestGateInput, type InterestGateState, type InterestGateStep, type InterestSchedulerConfig, type InterestState, type InterestTier, } from "./ai/interestScheduler.js";
+export { type Job, type JobDef, type JobReport } from "./ai/jobBoard.js";
+export { advanceSpawnDirector, advanceWave, createSpawnDirectorState, pickSpawnPoint, raiseAlert, type SpawnDirectorConfig, type SpawnDirectorState, type SpawnEntry, type SpawnRequest, type WaveManifest, } from "./ai/spawnDirector.js";
+export { acquireTarget, createTargetAcquirer, type AcquisitionEnvelope, type AcquisitionPolicy, type AcquisitionResult, type AcquisitionRetention, type TargetAcquirer, } from "./ai/targetAcquisition.js";
+export { createThreatTable, type ThreatTable } from "./ai/threat.js";
+export { createAreaEffectField, type AreaEffectEvent, type AreaEffectField, type AreaEventKind, type AreaFieldState, type AreaLeaveReason, type AreaMembership, type AreaShape, type AreaSourceSpec, type AreaStepInput, } from "./area/areaEffectField.js";
+export { cappedStacks, extremumStack, independentStacks, sumMagnitude, uniqueByStackKey, type AreaStackPolicy, type MagnitudeOf, } from "./area/stackPolicy.js";
+export { computeFalloffGain, distance3, resolveEmitterGain, type AudioBusDef, type AudioFalloffConfig, type SoundDef, } from "./audio/audioFalloff.js";
+export { mtof, notesInWindow, themeLoopSeconds, type MusicInstrument, type MusicTheme, type NoteEvent, } from "./audio/music.js";
+export { type NoiseVoice, type SynthPatch, type ToneVoice } from "./audio/synth.js";
+export { createFactionGraph, createFactionRoster, type FactionDef } from "./faction/factions.js";
+export { DEFAULT_REPUTATION_TIERS, createReputationLedger, effectiveRelation, tierForStanding, } from "./faction/reputation.js";
+export { controlGroupKey, resolveControlGroupIntent, type ControlGroupInput, type ControlGroupIntent, type ControlGroupOptions, } from "./input/controlGroups.js";
+export { buildContextMenu, contextVerb, contextVerbInput, type ContextMenu, type ContextVerb, } from "./interaction/contextMenu.js";
+export { LOCK_ACTIONS, generateLock, solveLock, solveLockPath, stepLock, visibleCells, type LockAction, type LockCell, type LockSpec, type LockStepResult, type LockTierSpec, } from "./interaction/lockpick.js";
+export { command, gauge, keybind, label, proximityPrompt, resolveActivePrompt, type PositionedPrompt, type ProximityPrompt, } from "./interaction/proximityPrompt.js";
+export { evaluateQteSequence, pendingQteStep, type QteStep } from "./interaction/qte.js";
+export { evaluateSkillCheck, skillCheckZoneAt, type SkillCheckConfig, type SkillCheckResult, } from "./interaction/skillCheck.js";
+export { resolveLocalAvoidance, type AvoidanceAgent, type LocalAvoidanceOptions } from "./movement/avoidance.js";
+export { assignFormationSlots, boxFormation, circleFormation, facingYaw, lineFormation, placeFormation, wedgeFormation, type BoxFormationOptions, type CircleFormationOptions, type FormationSlotGenerator, type LineFormationOptions, type SlotAssignmentOptions, type WedgeFormationOptions, } from "./movement/formation.js";
+export { createGlideModel } from "./movement/glideModel.js";
+export { createGrappleSwing } from "./movement/grappleSwing.js";
+export { createLeaderTrail } from "./movement/leaderTrail.js";
+export { MOVEMENT_TUNING } from "./movement/movementModel.js";
+export { resolvePlayerMovementTuning, stepPlayerMovement } from "./movement/playerMovement.js";
+export { POSE_HITBOX, createPoseState, type MovementPose } from "./movement/poseState.js";
+export { steerYaw } from "./movement/steering.js";
+export { constrainToNavGrid } from "./nav/navConstrain.js";
+export { populateNavGridFromEnvironment } from "./nav/navFromEnvironment.js";
+export { createNavGrid, findPath, slopeStepCost, type NavGrid, type NavPoint } from "./nav/navGrid.js";
+export { advancePathFollow, createPathFollow, pathFollowProgress, pathFollowSeek, pathFromNav, pathLength, type PathFollowConfig, type PathFollowProgress, type PathFollowState, type PathProgress, type Waypoint, } from "./nav/pathFollow.js";
+export { defineAttackMoveOrder, defineHoldOrder, defineMoveOrder, definePatrolOrder, defineStopOrder, defineTargetedOrder, type AttackMoveOrderPayload, type EmptyOrderPayload, type EngagementKindConfig, type EngagementOrderState, type MoveOrderPayload, type OrderKindConfig, type OrderMoveResult, type OrderMover, type OrderTargeting, type PatrolOrderPayload, type PatrolOrderState, type TargetedOrderPayload, } from "./orders/orderKinds.js";
+export { createOrderQueue, createOrderRegistry, type Order, type OrderCancelReason, type OrderEvent, type OrderIssueResult, type OrderKind, type OrderOutcome, type OrderPhase, type OrderProgress, type OrderQueue, type OrderQueueOptions, type OrderQueuePolicy, type OrderQueueState, type OrderRegistry, type OrderRejection, type OrderRequest, type OrderStartResult, type OrderTickReport, type OrderVec3, } from "./orders/orderQueue.js";
+export { createBallisticSweep, type BallisticSweep, type BallisticSweepHit } from "./physics/ballisticSweep.js";
+export { createBuoyantBody } from "./physics/buoyancy.js";
+export { Carryable, carrySpeedMultiplier } from "./physics/carryable.js";
+export { createDamageModel } from "./physics/damageZones.js";
+export { tickDrivableVehicle } from "./physics/drivableVehicle.js";
+export { ForceVolume, PlatformCarry } from "./physics/forceVolume.js";
+export { createKinematicVehicle, type KinematicVehicle, type KinematicVehicleStep, type KinematicVehicleTuning, } from "./physics/kinematicVehicle.js";
+export { PhysicsWorld, SHAPE_BOX, SHAPE_SPHERE, type AddBodyOptions, type CollisionEvent, type PhysicsStats, } from "./physics/physicsWorld.js";
+export { createRagdoll } from "./physics/ragdoll.js";
+export { SpatialGrid } from "./physics/spatialGrid.js";
+export { StructureGraph, type CollapseEvent, type StructureMaterial } from "./physics/structure.js";
+export { Glide, Grapple } from "./physics/traversal.js";
+export { DEFAULT_GRIP_CURVE, createVehicleBody, sampleGripCurve, type GripCurve } from "./physics/vehicleBody.js";
+export { createAssetCatalog, type AssetCatalog, type ModelAssetRef, type ModelDims } from "./scene/assetCatalog.js";
+export { partsBounds, registerAssetGenerator, type GeneratedAsset, type GeneratedPart } from "./scene/assetGenerator.js";
+export { applyRotationPolicy, headingToRotationY, normalizeDegrees, parseAssetSpace, parseRotationPolicy, resolveAnchorOffset, resolveFacingRotationY, rotatedFootprint, rotationYToHeading, snapHeading, toEngineUnits, validateAssetSpace, type AssetAnchor, type AssetSpace, type AssetSpaceIssue, type PlacementRotationPolicy, } from "./scene/assetSpace.js";
+export { collectAuthoredTriggers, createAuthoredTriggerRuntime, getTriggerAction, listTriggerActions, pointInVolume, registerTriggerAction, type AuthoredTrigger, type AuthoredTriggerRuntime, type TriggerActionDefinition, type TriggerDispatchEvent, type TriggerEvent, type TriggerHandlers, type TriggerSourceKind, } from "./scene/authoredTriggers.js";
+export { selectAutoTarget, type AutoTargetPolicy } from "./scene/autoTarget.js";
+export { advanceBehaviors, behaviorControl, type BehaviorControl, type BehaviorInspection, type BehaviorResumePolicy, type BehaviorSnapshot, type BehaviorStatus, } from "./scene/behaviorRuntime.js";
+export { patrol, player, talkable, wander, type BehaviorDescriptor } from "./scene/behaviors.js";
+export { createBodyBind } from "./scene/bodyBind.js";
+export { type ColliderPurpose, type EntityColliderSet, type ResolvedCollider } from "./scene/colliders.js";
+export { type StatCatalog, type StatValue } from "./scene/entityStats.js";
+export { entityMetaOf, groundSpeed, type EntityPosition, type SceneEntity } from "./scene/entityStore.js";
+export { DEFAULT_FORWARD } from "./scene/facing.js";
+export { readNamedSockets, type ModelNode } from "./scene/modelSockets.js";
+export { MountController, createMountController } from "./scene/mount.js";
+export { objectVisualScale, type ObjectVisual, type SceneObject } from "./scene/objectStore.js";
+export { type PaintStroke } from "./scene/paintLayer.js";
+export { type RosterEntry } from "./scene/roster.js";
+export { parseParams, registerSceneKind, type ParamField, type ParamSchema, type ParsedParams, type SceneKindObject, type SceneKindResolveContext, type WeightedParamEntry, } from "./scene/sceneKinds.js";
+export { firstImpact, hitsUntilBlocked, type SceneRaycastApi, type SceneRaycastHit } from "./scene/sceneRaycast.js";
+export { createSelectionSet, isMarquee, screenRect, selectWithinRect, type ScreenRect, type SelectionSet, } from "./scene/selection.js";
+export { createSelectionBookmarks, recallSelectionBookmark, type BookmarkRecallMode, type RecallBookmarkOptions, type SelectionBookmarkSnapshot, type SelectionBookmarks, type SelectionPruneResult, } from "./scene/selectionBookmarks.js";
+export { type Aim } from "./scene/spatial.js";
+export { createStationClaim, type Station } from "./scene/stationClaim.js";
+export { VehicleSeats, createVehicleSeats } from "./scene/vehicleSeat.js";
+export { type ConcealmentSensor } from "./sensor/concealment.js";
+export { type FreezeMonitor, type FreezeViolation } from "./sensor/freezeMonitor.js";
+export { type FramingConfig, type FrustumProjection, type FrustumSample, type FrustumSensor, type FrustumTarget, } from "./sensor/frustumSensor.js";
+export { type HiddenStateSource, type SensorProbeOptions, type SensorReading } from "./sensor/hiddenStateProbe.js";
+export { type RecordingBuffer, type RecordingBufferOptions } from "./sensor/recordingBuffer.js";
+export { type RevealHit, type RevealQuery } from "./sensor/revealQuery.js";
+export { getCurrentGameTimestamp, sanitizeGameTimeScale } from "./time/gameClock.js";
+export { type ClockSnapshot, type SimClock } from "./time/simClock.js";
+export { type BoundsSpec, type Vec3 } from "./visibility/bounds.js";
+export { type CameraVisibilityContext } from "./visibility/camera.js";
+export { type VisibilityConfig } from "./visibility/config.js";
+export { distance } from "./visibility/distance.js";
+export { type CameraView, type Frustum } from "./visibility/frustum.js";
+export { createVisibilitySystem, type Renderable, type VisibilitySystem } from "./visibility/visibilitySystem.js";
+export { markerCatalogId, placeAuthoredObjects, placeAuthoredObjectsFromDocument, resolveAuthoredObjects, } from "./world/authoredObjects.js";
+export { createContributionPool, createPlotPermissions, type BuildRole } from "./world/buildPermissions.js";
+export { buildingIndex, type BuildingIndex } from "./world/buildingIndex.js";
+export { type BuildingPaletteOverrides, type BuildingStyle } from "./world/buildings.js";
+export { CarvableField, VoxelVolume, carvableTerrain, type VoxelMaterial } from "./world/carve.js";
+export { catenaryCurve, sagCurve } from "./world/catenary.js";
+export { snapToNearest, socketWorldPosition, socketsCompatible, worldSockets } from "./world/connectors.js";
+export { createEnvironmentField, type EnvironmentField, type HeatSource } from "./world/envField.js";
+export { resolveStructureBuildings, summarizeEnvironment } from "./world/environmentSummary.js";
+export { biomes, building, environment, flat, grass, ocean, pad, plots, rain, road, sky, snow, terrain, tilemap, voxel, type BiomeBand, type BuildingEnvironmentDescriptor, type EnvironmentWorldFeature, type GrassEnvironmentDescriptor, type OceanEnvironmentDescriptor, type PadEnvironmentDescriptor, type PadSize, type RainEnvironmentDescriptor, type RoadEnvironmentDescriptor, type SkyEnvironmentDescriptor, type SnowEnvironmentDescriptor, type TerrainCircleRegion, type TerrainDetailConfig, type TerrainDetailMaterialConfig, type TerrainEnvironmentDescriptor, type TerrainFlattenMask, type TerrainMaterialRegion, type TerrainPolylineRegion, type TerrainRectRegion, type TerrainRegionStyle, type WeatherEnvironmentDescriptor, type WorldFeature, type WorldGridCell, type WorldGridConfig, } from "./world/features.js";
+export { createFogField, type FogCells, type FogField } from "./world/fog.js";
+export { boundaryNeighbors, createFootprintGrid, footprintObstacles, hasValidAdjacency } from "./world/footprintGrid.js";
+export { type Aabb, type AvoidZone } from "./world/geometry.js";
+export { GRASS_SCHEMA } from "./world/grassKind.js";
+export { resolveGridInstances } from "./world/gridInstances.js";
+export { createLodScheduler } from "./world/lod.js";
+export { mapLayerColor, type MapCellStates, type MapRoute, type MapZone } from "./world/mapLayers.js";
+export { DEFAULT_MARKER_KINDS, createMarkerSet, markerKindStyle, type MapMarker, type MarkerKindStyle, type MarkerSet, } from "./world/markers.js";
+export { bearingToCardinal, clampToMinimapEdge, compassBearing, headingToBearing, projectToMinimap, relativeBearing, unprojectFromMinimap, type Cardinal, type MinimapView, type WorldXZ, } from "./world/minimap.js";
+export { placeAlongPath } from "./world/pathInstances.js";
+export { withPathProfiles, type PathHeightPolicy, type PathRetaining, type TerrainPathProfile, } from "./world/pathTerrain.js";
+export { placeAssetFromCommit, resolvePlaceAsset, toEditorMarker, toStructureInput, type PlaceAssetResult, } from "./world/placeAsset.js";
+export { createPlacedStructureStore, type PlacedStructure } from "./world/placedStructureStore.js";
+export { validatePlacement, type PlacementRules } from "./world/placement.js";
+export { createPlacementController, quarterTurnsToRotationY, type PlacementCommit, type PlacementController, type PlacementPreview, type SnapMode, } from "./world/placementController.js";
+export { composeRealm } from "./world/realm.js";
+export { createRegionField, isRegionField, type RegionField } from "./world/regions.js";
+export { buildRoadRibbon, dashSegments } from "./world/roads.js";
+export { scatter, type ScatterPoint } from "./world/scatter.js";
+export { pickWeighted, scatterItems, type ScatterInstance } from "./world/scatterItems.js";
+export { SCATTER_PATH_KIND, clearanceZonesFrom, distanceToPolygonEdge, isScatterPath, pointInPolygon, polygonArea, polygonBounds, readScatterPalette, readScatterRules, resolveScatter, resolveScatterRegion, scatterRegionEstimate, scatterRegionFromPath, type ScatterTerrain, } from "./world/scatterRegion.js";
+export { SOIL_KIND, SOIL_SCHEMA, type SoilRules } from "./world/soilKind.js";
+export { annulusRegion, boxRegion, customRegion, discRegion, pointSetRegion, polygonRegion, rectRegion, sampleBatch, samplePoint, sampleStratified, shellRegion, sphereRegion, weightedRegion, type AreaDistribution, type FallbackPolicy, type Point3, type RadialDistribution, type SampleBatchOptions, type SampleBatchResult, type SampleConstraints, type SamplePoint, type SamplePointOptions, type SampleReason, type SampleRegion, type SampleResult, type StratifiedOptions, type VolumeDistribution, type WeightedRegionEntry, } from "./world/spatialSample.js";
+export { furnitureSpots, laneCenters, offsetPath, parkingSpots, sidewalkPoint, sidewalkWidthOf, } from "./world/streets.js";
+export { solveSupport, toDebrisBodies, type SupportResult } from "./world/support.js";
+export { applyDeltaToSnapshot, applySurfaceDeltaToSnapshot, beginSurfaceStroke, beginTerraformStroke, createEditableTerrain, createTerraformBrush, createTerrainSnapshot, editableTerrainFromSnapshot, migrateTerrainSnapshot, revertDeltaFromSnapshot, revertSurfaceDeltaFromSnapshot, type EditableTerrain, type SurfaceDelta, type SurfaceStroke, type TerraformDelta, type TerraformEdit, type TerraformFalloff, type TerraformMode, type TerraformShape, type TerraformSnapshot, type TerraformStroke, type TerrainMaterialLayer, type TerrainSurfaceRule, } from "./world/terraform.js";
+export { TERRAIN_MATERIAL_PALETTES, applyPathProfiles, type NoiseFieldConfig, type ResolvedTerrainDetail, type TerrainField, type TerrainPalette, } from "./world/terrain.js";
+export { chooseContourInterval, drapePolyline, extractContours, sampleElevation, summarizeElevation, surfaceGridLines, surfaceRing, terrainContourGuides, type ContourLine, type ContourOptions, type DrapeOptions, type ElevationReadout, type ElevationSummary, type GroundPoint, type GuideRegion, type HeightSampler, type SurfaceGridLine, type SurfaceGridOptions, } from "./world/terrainGuides.js";
+export { VEGETATION_VOLUME_KIND } from "./world/vegetation.js";
+export { VISIBILITY_HIDDEN, VISIBILITY_OBSERVED, VISIBILITY_REMEMBERED, createVisibilityField, type VisibilityCells, type VisibilityDelta, type VisibilityField, type VisibilityFieldConfig, type VisibilityFieldState, type VisibilityGroupState, type VisibilityMemory, type VisibilityState, } from "./world/visibilityField.js";
+export { type VolumetricCloudsConfig, type VolumetricCloudsRules } from "./world/volumetricClouds.js";
+export { createVoxelField, type VoxelFace } from "./world/voxelField.js";
+export { type EnclosedFootprint, type RoofPlan } from "./world/walls.js";
+export { waterSurface, waterSurfaceFromDescriptor, type WaterSurface } from "./world/water.js";
+export { WATER_SCHEMA, type WaterRules } from "./world/waterKind.js";
+export { createFireGrid, resolveWeather, type FireGrid, type ResolvedWeather, type WeatherModifierTable, type WeatherState, } from "./world/weather.js";
+export { windField, type WindField } from "./world/wind.js";

package/dist/world.js

@@ -0,0 +1,132 @@
+export {} from "./ai/heatSystem.js";
+export { advanceInterestGate, createInterestCensus, createInterestGateState, interestPhase, } from "./ai/interestScheduler.js";
+export {} from "./ai/jobBoard.js";
+export { advanceSpawnDirector, advanceWave, createSpawnDirectorState, pickSpawnPoint, raiseAlert, } from "./ai/spawnDirector.js";
+export { acquireTarget, createTargetAcquirer, } from "./ai/targetAcquisition.js";
+export { createThreatTable } from "./ai/threat.js";
+export { createAreaEffectField, } from "./area/areaEffectField.js";
+export { cappedStacks, extremumStack, independentStacks, sumMagnitude, uniqueByStackKey, } from "./area/stackPolicy.js";
+export { computeFalloffGain, distance3, resolveEmitterGain, } from "./audio/audioFalloff.js";
+export { mtof, notesInWindow, themeLoopSeconds, } from "./audio/music.js";
+export {} from "./audio/synth.js";
+export { createFactionGraph, createFactionRoster } from "./faction/factions.js";
+export { DEFAULT_REPUTATION_TIERS, createReputationLedger, effectiveRelation, tierForStanding, } from "./faction/reputation.js";
+export { controlGroupKey, resolveControlGroupIntent, } from "./input/controlGroups.js";
+export { buildContextMenu, contextVerb, contextVerbInput, } from "./interaction/contextMenu.js";
+export { LOCK_ACTIONS, generateLock, solveLock, solveLockPath, stepLock, visibleCells, } from "./interaction/lockpick.js";
+export { command, gauge, keybind, label, proximityPrompt, resolveActivePrompt, } from "./interaction/proximityPrompt.js";
+export { evaluateQteSequence, pendingQteStep } from "./interaction/qte.js";
+export { evaluateSkillCheck, skillCheckZoneAt, } from "./interaction/skillCheck.js";
+export { resolveLocalAvoidance } from "./movement/avoidance.js";
+export { assignFormationSlots, boxFormation, circleFormation, facingYaw, lineFormation, placeFormation, wedgeFormation, } from "./movement/formation.js";
+export { createGlideModel } from "./movement/glideModel.js";
+export { createGrappleSwing } from "./movement/grappleSwing.js";
+export { createLeaderTrail } from "./movement/leaderTrail.js";
+export { MOVEMENT_TUNING } from "./movement/movementModel.js";
+export { resolvePlayerMovementTuning, stepPlayerMovement } from "./movement/playerMovement.js";
+export { POSE_HITBOX, createPoseState } from "./movement/poseState.js";
+export { steerYaw } from "./movement/steering.js";
+export { constrainToNavGrid } from "./nav/navConstrain.js";
+export { populateNavGridFromEnvironment } from "./nav/navFromEnvironment.js";
+export { createNavGrid, findPath, slopeStepCost } from "./nav/navGrid.js";
+export { advancePathFollow, createPathFollow, pathFollowProgress, pathFollowSeek, pathFromNav, pathLength, } from "./nav/pathFollow.js";
+export { defineAttackMoveOrder, defineHoldOrder, defineMoveOrder, definePatrolOrder, defineStopOrder, defineTargetedOrder, } from "./orders/orderKinds.js";
+export { createOrderQueue, createOrderRegistry, } from "./orders/orderQueue.js";
+export { createBallisticSweep } from "./physics/ballisticSweep.js";
+export { createBuoyantBody } from "./physics/buoyancy.js";
+export { Carryable, carrySpeedMultiplier } from "./physics/carryable.js";
+export { createDamageModel } from "./physics/damageZones.js";
+export { tickDrivableVehicle } from "./physics/drivableVehicle.js";
+export { ForceVolume, PlatformCarry } from "./physics/forceVolume.js";
+export { createKinematicVehicle, } from "./physics/kinematicVehicle.js";
+export { PhysicsWorld, SHAPE_BOX, SHAPE_SPHERE, } from "./physics/physicsWorld.js";
+export { createRagdoll } from "./physics/ragdoll.js";
+export { SpatialGrid } from "./physics/spatialGrid.js";
+export { StructureGraph } from "./physics/structure.js";
+export { Glide, Grapple } from "./physics/traversal.js";
+export { DEFAULT_GRIP_CURVE, createVehicleBody, sampleGripCurve } from "./physics/vehicleBody.js";
+export { createAssetCatalog } from "./scene/assetCatalog.js";
+export { partsBounds, registerAssetGenerator } from "./scene/assetGenerator.js";
+export { applyRotationPolicy, headingToRotationY, normalizeDegrees, parseAssetSpace, parseRotationPolicy, resolveAnchorOffset, resolveFacingRotationY, rotatedFootprint, rotationYToHeading, snapHeading, toEngineUnits, validateAssetSpace, } from "./scene/assetSpace.js";
+export { collectAuthoredTriggers, createAuthoredTriggerRuntime, getTriggerAction, listTriggerActions, pointInVolume, registerTriggerAction, } from "./scene/authoredTriggers.js";
+export { selectAutoTarget } from "./scene/autoTarget.js";
+export { advanceBehaviors, behaviorControl, } from "./scene/behaviorRuntime.js";
+export { patrol, player, talkable, wander } from "./scene/behaviors.js";
+export { createBodyBind } from "./scene/bodyBind.js";
+export {} from "./scene/colliders.js";
+export {} from "./scene/entityStats.js";
+export { entityMetaOf, groundSpeed } from "./scene/entityStore.js";
+export { DEFAULT_FORWARD } from "./scene/facing.js";
+export { readNamedSockets } from "./scene/modelSockets.js";
+export { MountController, createMountController } from "./scene/mount.js";
+export { objectVisualScale } from "./scene/objectStore.js";
+export {} from "./scene/paintLayer.js";
+export {} from "./scene/roster.js";
+export { parseParams, registerSceneKind, } from "./scene/sceneKinds.js";
+export { firstImpact, hitsUntilBlocked } from "./scene/sceneRaycast.js";
+export { createSelectionSet, isMarquee, screenRect, selectWithinRect, } from "./scene/selection.js";
+export { createSelectionBookmarks, recallSelectionBookmark, } from "./scene/selectionBookmarks.js";
+export {} from "./scene/spatial.js";
+export { createStationClaim } from "./scene/stationClaim.js";
+export { VehicleSeats, createVehicleSeats } from "./scene/vehicleSeat.js";
+export {} from "./sensor/concealment.js";
+export {} from "./sensor/freezeMonitor.js";
+export {} from "./sensor/frustumSensor.js";
+export {} from "./sensor/hiddenStateProbe.js";
+export {} from "./sensor/recordingBuffer.js";
+export {} from "./sensor/revealQuery.js";
+export { getCurrentGameTimestamp, sanitizeGameTimeScale } from "./time/gameClock.js";
+export {} from "./time/simClock.js";
+export {} from "./visibility/bounds.js";
+export {} from "./visibility/camera.js";
+export {} from "./visibility/config.js";
+export { distance } from "./visibility/distance.js";
+export {} from "./visibility/frustum.js";
+export { createVisibilitySystem } from "./visibility/visibilitySystem.js";
+export { markerCatalogId, placeAuthoredObjects, placeAuthoredObjectsFromDocument, resolveAuthoredObjects, } from "./world/authoredObjects.js";
+export { createContributionPool, createPlotPermissions } from "./world/buildPermissions.js";
+export { buildingIndex } from "./world/buildingIndex.js";
+export {} from "./world/buildings.js";
+export { CarvableField, VoxelVolume, carvableTerrain } from "./world/carve.js";
+export { catenaryCurve, sagCurve } from "./world/catenary.js";
+export { snapToNearest, socketWorldPosition, socketsCompatible, worldSockets } from "./world/connectors.js";
+export { createEnvironmentField } from "./world/envField.js";
+export { resolveStructureBuildings, summarizeEnvironment } from "./world/environmentSummary.js";
+export { biomes, building, environment, flat, grass, ocean, pad, plots, rain, road, sky, snow, terrain, tilemap, voxel, } from "./world/features.js";
+export { createFogField } from "./world/fog.js";
+export { boundaryNeighbors, createFootprintGrid, footprintObstacles, hasValidAdjacency } from "./world/footprintGrid.js";
+export {} from "./world/geometry.js";
+export { GRASS_SCHEMA } from "./world/grassKind.js";
+export { resolveGridInstances } from "./world/gridInstances.js";
+export { createLodScheduler } from "./world/lod.js";
+export { mapLayerColor } from "./world/mapLayers.js";
+export { DEFAULT_MARKER_KINDS, createMarkerSet, markerKindStyle, } from "./world/markers.js";
+export { bearingToCardinal, clampToMinimapEdge, compassBearing, headingToBearing, projectToMinimap, relativeBearing, unprojectFromMinimap, } from "./world/minimap.js";
+export { placeAlongPath } from "./world/pathInstances.js";
+export { withPathProfiles, } from "./world/pathTerrain.js";
+export { placeAssetFromCommit, resolvePlaceAsset, toEditorMarker, toStructureInput, } from "./world/placeAsset.js";
+export { createPlacedStructureStore } from "./world/placedStructureStore.js";
+export { validatePlacement } from "./world/placement.js";
+export { createPlacementController, quarterTurnsToRotationY, } from "./world/placementController.js";
+export { composeRealm } from "./world/realm.js";
+export { createRegionField, isRegionField } from "./world/regions.js";
+export { buildRoadRibbon, dashSegments } from "./world/roads.js";
+export { scatter } from "./world/scatter.js";
+export { pickWeighted, scatterItems } from "./world/scatterItems.js";
+export { SCATTER_PATH_KIND, clearanceZonesFrom, distanceToPolygonEdge, isScatterPath, pointInPolygon, polygonArea, polygonBounds, readScatterPalette, readScatterRules, resolveScatter, resolveScatterRegion, scatterRegionEstimate, scatterRegionFromPath, } from "./world/scatterRegion.js";
+export { SOIL_KIND, SOIL_SCHEMA } from "./world/soilKind.js";
+export { annulusRegion, boxRegion, customRegion, discRegion, pointSetRegion, polygonRegion, rectRegion, sampleBatch, samplePoint, sampleStratified, shellRegion, sphereRegion, weightedRegion, } from "./world/spatialSample.js";
+export { furnitureSpots, laneCenters, offsetPath, parkingSpots, sidewalkPoint, sidewalkWidthOf, } from "./world/streets.js";
+export { solveSupport, toDebrisBodies } from "./world/support.js";
+export { applyDeltaToSnapshot, applySurfaceDeltaToSnapshot, beginSurfaceStroke, beginTerraformStroke, createEditableTerrain, createTerraformBrush, createTerrainSnapshot, editableTerrainFromSnapshot, migrateTerrainSnapshot, revertDeltaFromSnapshot, revertSurfaceDeltaFromSnapshot, } from "./world/terraform.js";
+export { TERRAIN_MATERIAL_PALETTES, applyPathProfiles, } from "./world/terrain.js";
+export { chooseContourInterval, drapePolyline, extractContours, sampleElevation, summarizeElevation, surfaceGridLines, surfaceRing, terrainContourGuides, } from "./world/terrainGuides.js";
+export { VEGETATION_VOLUME_KIND } from "./world/vegetation.js";
+export { VISIBILITY_HIDDEN, VISIBILITY_OBSERVED, VISIBILITY_REMEMBERED, createVisibilityField, } from "./world/visibilityField.js";
+export {} from "./world/volumetricClouds.js";
+export { createVoxelField } from "./world/voxelField.js";
+export {} from "./world/walls.js";
+export { waterSurface, waterSurfaceFromDescriptor } from "./world/water.js";
+export { WATER_SCHEMA } from "./world/waterKind.js";
+export { createFireGrid, resolveWeather, } from "./world/weather.js";
+export { windField } from "./world/wind.js";