@3driseai/3drise-viewer 0.1.42 → 0.1.44

package/dist/components/sports/useSportsInstance.d.ts

@@ -0,0 +1,35 @@
+import { type RefObject } from 'react';
+import * as THREE from 'three';
+import type { AnimationOptions, MouseMoveDomain } from '@3driseai/3drise-core';
+import { type TimeLit } from '../../hooks/useTimeLighting';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface SportsInstance extends TimeLit {
+    object: THREE.Object3D;
+    materials: THREE.Material[];
+    apply(cfg: Record<string, unknown>): void;
+    update(dt: number): void;
+    dispose(): void;
+}
+export interface SportsVariantProps extends ObjectReadyProps {
+    config: {
+        type: string;
+    };
+    /** Scene object id: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on the config knobs (animations.sports.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on the config knobs (mouseMove.sports). */
+    mouseMove?: MouseMoveDomain;
+}
+export interface SportsCore {
+    DEFAULTS: Record<string, unknown>;
+    STRUCTURAL: readonly string[];
+    ANIMATABLE: ReadonlySet<string>;
+    createUniforms(): Record<string, any>;
+    build(u: Record<string, any>, cfg: Record<string, unknown>): SportsInstance;
+}
+export declare function useSportsInstance(core: SportsCore, props: SportsVariantProps): {
+    rootRef: RefObject<THREE.Group | null>;
+    instance: SportsInstance;
+};
+//# sourceMappingURL=useSportsInstance.d.ts.map

package/dist/components/sports/useSportsInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSportsInstance.d.ts","sourceRoot":"","sources":["../../../src/components/sports/useSportsInstance.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACtF,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK/E,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,cAAe,SAAQ,OAAO;IAC3C,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IACxD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC;CAC/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,GAAG;IAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAuBnJ"}

package/dist/components/sports/useSportsInstance.js

@@ -0,0 +1,47 @@
+// =============================================================================
+// useSportsInstance — the React side every sports component shares
+// =============================================================================
+//
+// A variant's core (sports/core/<key>.ts, emitted from the lab module) is plain three.js:
+// createUniforms(), build(u, cfg) -> { object, materials, apply, update, dispose, and for the
+// time-lit variants uniformSets + bounds }. This hook wires it into the config pattern and the
+// app's shared services, the same ones the urban family uses:
+//
+//   - base config over the type's defaults (withConfigDefaults);
+//   - built once; a change of a STRUCTURAL knob builds a new instance (the uniforms outlive
+//     it); every other committed change and every per-frame override goes through
+//     instance.apply (the one door: live drag, keyframes, pointer bindings, timeline clips —
+//     useConfigDriver);
+//   - the time of day (useTimeLighting — the app's one pattern for TimeControls-lit objects,
+//     shared with urban roads and buildings): the scene sun on the instance's uniform sets with
+//     the object's `lighting` override (auto | day | night), and the lamp list — a court's
+//     surface gathers the lamps that reach it (its own floodlights, its neighbours', street
+//     lamps) whenever the list changes or the court moves;
+//   - readiness (useObjectReady) and StrictMode-safe disposal (useCommittedInstance: a dev
+//     double mount must not unregister the floodlights of the court on screen).
+//
+import { useCallback, useLayoutEffect, useMemo, useRef } from 'react';
+import { withConfigDefaults } from '../../utils/configAnimations.js';
+import { useObjectReady } from '../../hooks/useObjectReady.js';
+import { useConfigDriver } from '../../hooks/useConfigDriver.js';
+import { useCommittedInstance } from '../../hooks/useCommittedInstance.js';
+import { useTimeLighting } from '../../hooks/useTimeLighting.js';
+export function useSportsInstance(core, props) {
+    const { config, id, keyframes, mouseMove, onObjectReady, onObjectDispose } = props;
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    const cfg = useMemo(() => withConfigDefaults(core.DEFAULTS, config), [config]); // eslint-disable-line react-hooks/exhaustive-deps
+    // uniforms outlive rebuilds
+    const uniforms = useMemo(() => core.createUniforms(), []); // eslint-disable-line react-hooks/exhaustive-deps
+    const structuralKey = JSON.stringify(core.STRUCTURAL.map((k) => cfg[k]));
+    const instance = useCommittedInstance(() => core.build(uniforms, cfg), [uniforms, structuralKey]);
+    const push = useCallback((merged) => { instance.apply(merged); }, [instance]);
+    useConfigDriver({ rootRef, id, family: 'sports', base: cfg, structural: core.STRUCTURAL, allowed: core.ANIMATABLE, keyframes, mouseMove, push });
+    // The time of day (TimeControls) and the lamp list: the shared pattern, as urban.
+    const { relight } = useTimeLighting({
+        rootRef, instance, lighting: cfg.lighting || 'auto',
+        update: (dt) => instance.update(dt),
+    });
+    useLayoutEffect(() => { instance.apply(cfg); relight(); }, [instance, cfg, relight]);
+    return { rootRef, instance };
+}

package/dist/components/terrain/TerrainSurface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TerrainSurface.d.ts","sourceRoot":"","sources":["../../../src/components/terrain/TerrainSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAkB1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAkBjD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA6I/C,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"TerrainSurface.d.ts","sourceRoot":"","sources":["../../../src/components/terrain/TerrainSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAkB1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAoBjD;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CA0J/C,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/terrain/TerrainSurface.js

@@ -13,6 +13,8 @@ import { getAnimatableProperties } from '@3driseai/3drise-core';
 import { applyConfigKeyframeAnimations, applyConfigMouseMove, } from '../../utils/configAnimations.js';
 import { TERRAIN_DRAW_ORDER, ringDrawOrder } from '../../utils/environmentDrawOrder.js';
 import { isMobileDevice } from '../../utils/deviceTier.js';
+import { registerGround, bumpGround, heightSignature } from '../../utils/groundRegistry.js';
+import { terrainHeightAt } from '../../utils/terrainHeight.js';
 /**
  * Phone / tablet tier, applied at render time only — the saved scene keeps its
  * numbers, so the same project is full quality on a desktop. Measured on the
@@ -92,6 +94,13 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
         return () => { delete root.userData[TERRAIN_LIVE_KEY]; };
     }, [id, liveHandle]);
     useObjectReady(rootRef, { id, type: 'terrain', config, quality }, onObjectReady, onObjectDispose);
+    // The ground for layouts with onGround (groundRegistry): the config this frame draws,
+    // so a keyframed or dragged shape knob moves the copies with it.
+    const groundCfg = useRef(null);
+    useEffect(() => registerGround(id, (x, z) => {
+        const g = groundCfg.current;
+        return g ? terrainHeightAt(g.cfg, x, z, g.cell) : null;
+    }), [id]);
     useFrame((state) => {
         const camera = state.camera;
         updateSun();
@@ -112,6 +121,11 @@ const TerrainSurface = ({ id = '3drise-terrain', config, quality, skySettings, t
             cfg.textureDistance = Math.min(cfg.textureDistance ?? 4000, MOBILE.maxTextureDistance);
         }
         const qual = { ...quality, ...liveQuality.current };
+        const sig = heightSignature(cfg, String(qual.cellSize));
+        if (groundCfg.current?.sig !== sig) {
+            groundCfg.current = { cfg, cell: qual.cellSize ?? 2, sig };
+            bumpGround();
+        }
         applyTerrainUniforms(material, cfg, qual);
         applyTerrainTextures(material, cfg, textures);
         // ONE origin for the whole pyramid, snapped to twice the finest cell.

package/dist/components/urban/UrbanBlock.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { BlockUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanBlockProps extends UrbanVariantProps {
+    config: BlockUrbanConfig;
+}
+declare const UrbanBlock: React.FC<UrbanBlockProps>;
+export default UrbanBlock;
+//# sourceMappingURL=UrbanBlock.d.ts.map

package/dist/components/urban/UrbanBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanBlock.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanBlock.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACtD,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAOzC,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/components/urban/UrbanBlock.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/block.js';
+// =============================================================================
+// UrbanBlock — City Block (type 'urban', config.type 'block')
+// =============================================================================
+// A grid of parametric buildings on a paved or lawn plot, with its own small lit streets through the middle (a cross or one way), drawn from a city mix (downtown, residential, old town, industrial, suburb) or the block's own knobs with jittered footprints, heights, facades and tints, as one instanced mesh with emissive windows at night. Use for filling a city around a hero model in a few clicks.
+// The construction lives in core/block.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.block,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.block.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanBlock = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanBlock;

package/dist/components/urban/UrbanBuilding.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { BuildingUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanBuildingProps extends UrbanVariantProps {
+    config: BuildingUrbanConfig;
+}
+declare const UrbanBuilding: React.FC<UrbanBuildingProps>;
+export default UrbanBuilding;
+//# sourceMappingURL=UrbanBuilding.d.ts.map

package/dist/components/urban/UrbanBuilding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanBuilding.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanBuilding.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IACzD,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AAED,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAO/C,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/components/urban/UrbanBuilding.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/building.js';
+// =============================================================================
+// UrbanBuilding — Building (type 'urban', config.type 'building')
+// =============================================================================
+// A parametric building: nine footprints (box, L, U, courtyard, stepped, slab, podium tower, twin towers, cylinder), eight shader facades (curtain wall, punched, ribbon, brick, balconies, concrete panel, glass fins, industrial) and nine roofs (flat to pitched, hip, mansard, helipad, crown, green), with emissive rooms at night. Use for city context around a hero model.
+// The construction lives in core/building.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.building,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.building.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanBuilding = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanBuilding;

package/dist/components/urban/UrbanJunction.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { JunctionUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanJunctionProps extends UrbanVariantProps {
+    config: JunctionUrbanConfig;
+}
+declare const UrbanJunction: React.FC<UrbanJunctionProps>;
+export default UrbanJunction;
+//# sourceMappingURL=UrbanJunction.d.ts.map

package/dist/components/urban/UrbanJunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanJunction.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanJunction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IACzD,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AAED,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAO/C,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/components/urban/UrbanJunction.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/junction.js';
+// =============================================================================
+// UrbanJunction — Junction (type 'urban', config.type 'junction')
+// =============================================================================
+// A road intersection, cross, T or roundabout, with rounded kerb corners, lane markings, stop lines and zebra crossings on each arm, cycling traffic signals and a street lamp on each corner that lights the crossing at night; roads of the same width end at its arms. Use for where the streets of a city block meet.
+// The construction lives in core/junction.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.junction,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.junction.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanJunction = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanJunction;

package/dist/components/urban/UrbanPark.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ParkUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanParkProps extends UrbanVariantProps {
+    config: ParkUrbanConfig;
+}
+declare const UrbanPark: React.FC<UrbanParkProps>;
+export default UrbanPark;
+//# sourceMappingURL=UrbanPark.d.ts.map

package/dist/components/urban/UrbanPark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanPark.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanPark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACrD,MAAM,EAAE,eAAe,CAAC;CAC3B;AAED,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAOvC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/components/urban/UrbanPark.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/park.js';
+// =============================================================================
+// UrbanPark — Park (type 'urban', config.type 'park')
+// =============================================================================
+// A lawn inside a polygon with a looping paved path, an optional cross path, a kerb and short park lamps that light it at night; add trees and benches with the vegetation and street furniture objects. Use for the green between city blocks or a square in front of a hero building.
+// The construction lives in core/park.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.park,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.park.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanPark = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanPark;

package/dist/components/urban/UrbanParkingLot.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ParkingLotUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanParkingLotProps extends UrbanVariantProps {
+    config: ParkingLotUrbanConfig;
+}
+declare const UrbanParkingLot: React.FC<UrbanParkingLotProps>;
+export default UrbanParkingLot;
+//# sourceMappingURL=UrbanParkingLot.d.ts.map

package/dist/components/urban/UrbanParkingLot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanParkingLot.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanParkingLot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC3D,MAAM,EAAE,qBAAqB,CAAC;CACjC;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAOnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/urban/UrbanParkingLot.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/parkingLot.js';
+// =============================================================================
+// UrbanParkingLot — Parking Lot (type 'urban', config.type 'parkingLot')
+// =============================================================================
+// A surface car park: marked bays around aisles on asphalt from the texture library, a kerb, tall lamps that light it at night and a crowd of low-poly parked cars at a set occupancy, all instanced. Use for the ground around offices, malls and stations in a city scene.
+// The construction lives in core/parkingLot.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.parkingLot,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.parkingLot.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanParkingLot = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanParkingLot;

package/dist/components/urban/UrbanPlaza.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { PlazaUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanPlazaProps extends UrbanVariantProps {
+    config: PlazaUrbanConfig;
+}
+declare const UrbanPlaza: React.FC<UrbanPlazaProps>;
+export default UrbanPlaza;
+//# sourceMappingURL=UrbanPlaza.d.ts.map

package/dist/components/urban/UrbanPlaza.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanPlaza.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanPlaza.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACtD,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAOzC,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/components/urban/UrbanPlaza.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/plaza.js';
+// =============================================================================
+// UrbanPlaza — Plaza (type 'urban', config.type 'plaza')
+// =============================================================================
+// A paved area inside a polygon: a library paving set with a second set laid in a grid, stripe, ring or checker pattern in metres, a kerb around the edge, lit by the street lamps at night. Use for a hero building's forecourt, a square or a courtyard.
+// The construction lives in core/plaza.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.plaza,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.plaza.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanPlaza = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanPlaza;

package/dist/components/urban/UrbanRoad.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { RoadUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanRoadProps extends UrbanVariantProps {
+    config: RoadUrbanConfig;
+}
+declare const UrbanRoad: React.FC<UrbanRoadProps>;
+export default UrbanRoad;
+//# sourceMappingURL=UrbanRoad.d.ts.map

package/dist/components/urban/UrbanRoad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanRoad.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanRoad.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACrD,MAAM,EAAE,eAAe,CAAC;CAC3B;AAED,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAOvC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/components/urban/UrbanRoad.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/road.js';
+// =============================================================================
+// UrbanRoad — Road (type 'urban', config.type 'road')
+// =============================================================================
+// A street along a polyline: lanes with dashed or solid markings, zebra crossings, kerbed sidewalks and street lamps at a spacing, all from the texture library; lamps light the asphalt at night. Use for the streets of a city block.
+// The construction lives in core/road.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.road,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.road.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanRoad = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanRoad;

package/dist/components/urban/UrbanSignage.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { SignageUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanSignageProps extends UrbanVariantProps {
+    config: SignageUrbanConfig;
+}
+declare const UrbanSignage: React.FC<UrbanSignageProps>;
+export default UrbanSignage;
+//# sourceMappingURL=UrbanSignage.d.ts.map

package/dist/components/urban/UrbanSignage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanSignage.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanSignage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;CAC9B;AAED,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAO7C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/urban/UrbanSignage.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/signage.js';
+// =============================================================================
+// UrbanSignage — Signage (type 'urban', config.type 'signage')
+// =============================================================================
+// A billboard on posts, a street totem or a rooftop sign carrying a picture of your choice, lit as a print by day and backlit at night, spilling a little light on the ground. Use for branding a development, a sales office or a shop in a city scene.
+// The construction lives in core/signage.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.signage,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.signage.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanSignage = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanSignage;

package/dist/components/urban/UrbanSkyline.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { SkylineUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanSkylineProps extends UrbanVariantProps {
+    config: SkylineUrbanConfig;
+}
+declare const UrbanSkyline: React.FC<UrbanSkylineProps>;
+export default UrbanSkyline;
+//# sourceMappingURL=UrbanSkyline.d.ts.map

package/dist/components/urban/UrbanSkyline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanSkyline.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanSkyline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;CAC9B;AAED,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAO7C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/urban/UrbanSkyline.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/skyline.js';
+// =============================================================================
+// UrbanSkyline — Skyline (type 'urban', config.type 'skyline')
+// =============================================================================
+// A far belt of hundreds of parametric buildings on a ring around the scene, varied in footprint, height, facade and tint, drawn as one instanced mesh with lit windows at night. Use for the city horizon behind a hero building or block.
+// The construction lives in core/skyline.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.skyline,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.skyline.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanSkyline = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanSkyline;

package/dist/components/urban/UrbanStreetFurniture.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { StreetFurnitureUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanStreetFurnitureProps extends UrbanVariantProps {
+    config: StreetFurnitureUrbanConfig;
+}
+declare const UrbanStreetFurniture: React.FC<UrbanStreetFurnitureProps>;
+export default UrbanStreetFurniture;
+//# sourceMappingURL=UrbanStreetFurniture.d.ts.map

package/dist/components/urban/UrbanStreetFurniture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanStreetFurniture.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanStreetFurniture.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAChE,MAAM,EAAE,0BAA0B,CAAC;CACtC;AAED,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAO7D,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/components/urban/UrbanStreetFurniture.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/streetFurniture.js';
+// =============================================================================
+// UrbanStreetFurniture — Street Furniture (type 'urban', config.type 'streetFurniture')
+// =============================================================================
+// One piece of street furniture by kind: a street lamp with an emissive head that lights nearby roads and facades at night, a slatted bench, a bollard or a bus shelter with a lit panel. Use for the pavements and plazas of a city scene.
+// The construction lives in core/streetFurniture.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.streetFurniture,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.streetFurniture.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanStreetFurniture = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanStreetFurniture;

package/dist/components/urban/UrbanStreetGrid.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { StreetGridUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanStreetGridProps extends UrbanVariantProps {
+    config: StreetGridUrbanConfig;
+}
+declare const UrbanStreetGrid: React.FC<UrbanStreetGridProps>;
+export default UrbanStreetGrid;
+//# sourceMappingURL=UrbanStreetGrid.d.ts.map

package/dist/components/urban/UrbanStreetGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanStreetGrid.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanStreetGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAuBvE,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC3D,MAAM,EAAE,qBAAqB,CAAC;CACjC;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAanD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/urban/UrbanStreetGrid.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/streetGrid.js';
+import { useGridLayout } from '../../hooks/useGridLayout.js';
+// =============================================================================
+// UrbanStreetGrid — Street Grid (type 'urban', config.type 'streetGrid')
+// =============================================================================
+// A whole street grid as one object, drawn from the grid its `layoutId` names (a built-in grid,
+// 'preset:<id>', or a saved grid — a `layout` asset): junctions, roads between them ending at the
+// junction arms, tees and rounded corners on the edge (or open stubs), signals, lamps and traffic on
+// every street, and a ground under the grid's grounds (a texture each, or a lawn).
+// The construction lives in core/streetGrid.ts (emitted from the lab); this component resolves the
+// grid and wires the rest into the config pattern, the scene sun and the lamp list (useUrbanInstance).
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.streetGrid,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.streetGrid.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanStreetGrid = (props) => {
+    const ref = props.config.layoutId ?? DEFAULT_URBAN_OBJECTS.streetGrid.layoutId;
+    // The grid it names: a preset at once; a saved grid once the project has registered it (load
+    // order is not guaranteed — until then nothing is built), and its new version after an edit.
+    const layout = useGridLayout(ref);
+    // handed to the core as `layout` (a structural key: a new grid rebuilds, the same one doesn't)
+    const config = useMemo(() => ({ ...props.config, layout }), [props.config, layout]);
+    const { rootRef, instance } = useUrbanInstance(CORE, { ...props, config });
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanStreetGrid;

package/dist/components/urban/UrbanTraffic.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { TrafficUrbanConfig } from '@3driseai/3drise-core';
+import type { UrbanVariantProps } from './useUrbanInstance';
+export interface UrbanTrafficProps extends UrbanVariantProps {
+    config: TrafficUrbanConfig;
+}
+declare const UrbanTraffic: React.FC<UrbanTrafficProps>;
+export default UrbanTraffic;
+//# sourceMappingURL=UrbanTraffic.d.ts.map

package/dist/components/urban/UrbanTraffic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrbanTraffic.d.ts","sourceRoot":"","sources":["../../../src/components/urban/UrbanTraffic.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAa,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAmBvE,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IACxD,MAAM,EAAE,kBAAkB,CAAC;CAC9B;AAED,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAO7C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/urban/UrbanTraffic.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_URBAN_OBJECTS, URBAN_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useUrbanInstance } from './useUrbanInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/traffic.js';
+// =============================================================================
+// UrbanTraffic — Traffic (type 'urban', config.type 'traffic')
+// =============================================================================
+// Streams of head and tail lights moving along a road path at night, lanes running both ways, as instanced glowing sprites with no car geometry. Use for living streets in night shots of a city scene.
+// The construction lives in core/traffic.ts (emitted from the lab); this component wires it
+// into the config pattern, the scene sun and the lamp list through useUrbanInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_URBAN_OBJECTS.traffic,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(URBAN_OBJECTS_ANIMATABLE.traffic.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const UrbanTraffic = (props) => {
+    const { rootRef, instance } = useUrbanInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default UrbanTraffic;