@3driseai/3drise-viewer 0.1.41 → 0.1.43

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

@@ -0,0 +1,53 @@
+import { type RefObject } from 'react';
+import * as THREE from 'three';
+import type { AnimationOptions, MouseMoveDomain } from '@3driseai/3drise-core';
+import { type LampTarget } from '../../hooks/useTimeLighting';
+import type { ObjectReadyProps } from '../../types/objectReady';
+export interface UrbanInstance {
+    object: THREE.Object3D;
+    /** The uniform sets that take the sun block (one per material family the variant owns). */
+    uniformSets: Array<Record<string, {
+        value: any;
+    }>>;
+    apply(cfg: Record<string, unknown>): void;
+    rebuild(cfg: Record<string, unknown>): void;
+    update(dt: number, camera: THREE.Camera): void;
+    /** Local-space bounds (the hook applies the object's world matrix). */
+    bounds(): THREE.Box3;
+    /** Lamp-gathering targets (local bounds): a uniform set to fill with the nearest lamps, or a baked
+     *  lamp field (createLampField) for a large merged surface. Defaults to every uniform set with
+     *  lamp uniforms at bounds(). */
+    lampTargets?(): LampTarget[];
+    dispose(): void;
+}
+/** One lamp-gathering target of an urban instance (bounds in the instance's local space). */
+export type { LampTarget };
+export interface UrbanVariantProps extends ObjectReadyProps {
+    config: {
+        type: string;
+    };
+    /** Scene object id: the live-edit handle is found by it. */
+    id?: string;
+    /** Keyframes on the config knobs (animations.urban.animations). */
+    keyframes?: AnimationOptions[];
+    /** Pointer bindings on the config knobs (mouseMove.urban). */
+    mouseMove?: MouseMoveDomain;
+}
+export interface UrbanCore {
+    DEFAULTS: Record<string, unknown>;
+    STRUCTURAL: readonly string[];
+    ANIMATABLE: ReadonlySet<string>;
+    createUniforms(): Record<string, {
+        value: any;
+    }>;
+    build(u: Record<string, {
+        value: any;
+    }>, cfg: Record<string, unknown>): UrbanInstance;
+}
+/** Texture refs ({ set, maps, tileSize }) with their maps filled in and on the CDN host — also refs one level down, in a map of them by key (a street grid's per-ground textures). */
+export declare function resolveUrbanTextures<T extends Record<string, unknown>>(cfg: T): T;
+export declare function useUrbanInstance(core: UrbanCore, props: UrbanVariantProps): {
+    rootRef: RefObject<THREE.Group | null>;
+    instance: UrbanInstance;
+};
+//# sourceMappingURL=useUrbanInstance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUrbanInstance.d.ts","sourceRoot":"","sources":["../../../src/components/urban/useUrbanInstance.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAsE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3G,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK/E,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;IACvB,2FAA2F;IAC3F,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC,CAAC;IACnD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/C,uEAAuE;IACvE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC;IACrB;;qCAEiC;IACjC,WAAW,CAAC,IAAI,UAAU,EAAE,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACnB;AAED,6FAA6F;AAC7F,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACvD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACtB,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;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC;CACzF;AAYD,sLAAsL;AACtL,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAUjF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,GAAG;IAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAmC/I"}

package/dist/components/urban/useUrbanInstance.js

@@ -0,0 +1,100 @@
+// =============================================================================
+// useUrbanInstance — the React side every urban component shares
+// =============================================================================
+//
+// A variant's core (urban/core/<key>.ts, emitted from the lab module) is plain three.js:
+// createUniforms(), build(u, cfg) -> { object, uniformSets, apply, rebuild, update, bounds,
+// lampTargets?, dispose }. This hook wires it into the config pattern and the family's
+// shared services, so a component is a dozen lines:
+//
+//   - base config over the type's defaults (withConfigDefaults); texture refs resolved to
+//     map URLs (stored maps, else the studio's library resolver) and routed to the CDN;
+//   - built once; a change of a STRUCTURAL knob calls instance.rebuild(cfg); 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):
+//     the scene sun on every uniform set with the object's `lighting` override (auto | day |
+//     night), and the lamp list: when a lamp registers, moves or changes, each surface
+//     re-gathers the lamps that reach its bounds (per chunk for long roads), in WORLD space like
+//     the shaders' vP; a target with a `field` (a street grid) re-bakes its lamp texture;
+//   - readiness (useObjectReady) and StrictMode-safe disposal (useCommittedInstance).
+//
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { toCdn } from '@3driseai/3drise-core';
+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';
+import { resolveTextureMaps, textureResolverVersion } from './textureSetResolver.js';
+const isTextureRef = (v) => !!v && typeof v === 'object' && !Array.isArray(v) && 'set' in v;
+/** One ref with its maps filled in and on the CDN host. */
+function resolveRef(ref) {
+    const maps = resolveTextureMaps(ref) ?? {};
+    const cdn = {};
+    for (const [m, url] of Object.entries(maps))
+        if (url)
+            cdn[m] = toCdn(url);
+    return { ...ref, maps: cdn };
+}
+/** Texture refs ({ set, maps, tileSize }) with their maps filled in and on the CDN host — also refs one level down, in a map of them by key (a street grid's per-ground textures). */
+export function resolveUrbanTextures(cfg) {
+    let out = null;
+    for (const [k, v] of Object.entries(cfg)) {
+        if (!v || typeof v !== 'object' || Array.isArray(v))
+            continue;
+        if (isTextureRef(v)) {
+            (out ??= { ...cfg })[k] = resolveRef(v);
+            continue;
+        }
+        const entries = Object.entries(v);
+        if (!entries.length || !entries.every(([, x]) => isTextureRef(x)))
+            continue;
+        (out ??= { ...cfg })[k] = Object.fromEntries(entries.map(([id, x]) => [id, resolveRef(x)]));
+    }
+    return (out ?? cfg);
+}
+export function useUrbanInstance(core, props) {
+    const { config, id, keyframes, mouseMove, onObjectReady, onObjectDispose } = props;
+    const rootRef = useRef(null);
+    useObjectReady(rootRef, config, onObjectReady, onObjectDispose);
+    const base = useMemo(() => withConfigDefaults(core.DEFAULTS, config), [config]); // eslint-disable-line react-hooks/exhaustive-deps
+    // The library resolver arrives after the files tree loads: re-resolve when it changes.
+    const resolverVersion = useResolverVersion();
+    const cfg = useMemo(() => resolveUrbanTextures(base), [base, resolverVersion]); // eslint-disable-line react-hooks/exhaustive-deps
+    const uniforms = useMemo(() => core.createUniforms(), []); // eslint-disable-line react-hooks/exhaustive-deps
+    // Built once (a structural change rebuilds in place); disposed on a real unmount only —
+    // StrictMode-safe (useCommittedInstance).
+    const instance = useCommittedInstance(() => core.build(uniforms, cfg), [uniforms]);
+    const push = useCallback((merged) => { instance.apply(merged); }, [instance]);
+    useConfigDriver({ rootRef, id, family: 'urban', base, structural: core.STRUCTURAL, allowed: core.ANIMATABLE, keyframes, mouseMove, push });
+    // The time of day (TimeControls) and the lamp list: the shared pattern (useTimeLighting),
+    // after the config driver's frame (as before: overrides land, then sun, update, lamps).
+    const { relight } = useTimeLighting({
+        rootRef, instance, lighting: cfg.lighting || 'auto',
+        update: (dt, state) => instance.update(dt, state.camera),
+    });
+    // Structural knobs rebuild; everything else applies.
+    const structuralKey = JSON.stringify(core.STRUCTURAL.map((k) => cfg[k]));
+    const builtWith = useRef(structuralKey);
+    useLayoutEffect(() => {
+        if (builtWith.current !== structuralKey) {
+            builtWith.current = structuralKey;
+            instance.rebuild(cfg);
+        }
+        else
+            instance.apply(cfg);
+        relight();
+    }, [instance, cfg, structuralKey, relight]);
+    return { rootRef, instance };
+}
+// A render-triggering view of the resolver version (polled once a second: the library loads once).
+function useResolverVersion() {
+    const [v, setV] = useState(textureResolverVersion());
+    useEffect(() => {
+        const t = setInterval(() => { const n = textureResolverVersion(); if (n !== v)
+            setV(n); }, 1000);
+        return () => clearInterval(t);
+    }, [v]);
+    return v;
+}

package/dist/components/vegetation/VegetationBush.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { BushVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationBushProps extends VegetationVariantProps {
+    config: BushVegetationConfig;
+}
+declare const VegetationBush: React.FC<VegetationBushProps>;
+export default VegetationBush;
+//# sourceMappingURL=VegetationBush.d.ts.map

package/dist/components/vegetation/VegetationBush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationBush.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationBush.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IAC/D,MAAM,EAAE,oBAAoB,CAAC;CAChC;AAED,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAOjD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/vegetation/VegetationBush.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/bush.js';
+// =============================================================================
+// VegetationBush — Bush (type 'vegetation', config.type 'bush')
+// =============================================================================
+// A shrub grown from basal stems arching from the ground: a species' habit (boxwood, wild shrub, lavender, hydrangea, fern, juniper), dense shaped leaves, flower heads and berries, seasonal colour and wind. Use for gardens, hedgerows, undergrowth and planters.
+// The construction lives in core/bush.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.bush,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.bush.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationBush = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationBush;

package/dist/components/vegetation/VegetationCrops.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { CropsVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationCropsProps extends VegetationVariantProps {
+    config: CropsVegetationConfig;
+}
+declare const VegetationCrops: React.FC<VegetationCropsProps>;
+export default VegetationCrops;
+//# sourceMappingURL=VegetationCrops.d.ts.map

package/dist/components/vegetation/VegetationCrops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationCrops.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationCrops.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAChE,MAAM,EAAE,qBAAqB,CAAC;CACjC;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAOnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/vegetation/VegetationCrops.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/crops.js';
+// =============================================================================
+// VegetationCrops — Crops (type 'vegetation', config.type 'crops')
+// =============================================================================
+// A planted bed: rows of one crop (tomato, pepper, corn, lettuce, cabbage, pumpkin, strawberry) on ridged soil, each plant a small branching model with its leaves and its produce, grown from seedlings with the growth knob and ripened with ripeness. Use for farms, gardens, greenhouses and food scenes.
+// The construction lives in core/crops.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.crops,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.crops.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationCrops = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationCrops;

package/dist/components/vegetation/VegetationFlowers.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { FlowersVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationFlowersProps extends VegetationVariantProps {
+    config: FlowersVegetationConfig;
+}
+declare const VegetationFlowers: React.FC<VegetationFlowersProps>;
+export default VegetationFlowers;
+//# sourceMappingURL=VegetationFlowers.d.ts.map

package/dist/components/vegetation/VegetationFlowers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationFlowers.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationFlowers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IAClE,MAAM,EAAE,uBAAuB,CAAC;CACnC;AAED,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAOvD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/components/vegetation/VegetationFlowers.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/flowers.js';
+// =============================================================================
+// VegetationFlowers — Flowers (type 'vegetation', config.type 'flowers')
+// =============================================================================
+// A bed or meadow of one flower species (daisy, tulip, poppy, sunflower, cosmos, lavender): stalks, petal heads that open from buds with the bloom knob, centres and leaves, nodding in the wind. Use for gardens, meadows, parks and planters.
+// The construction lives in core/flowers.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.flowers,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.flowers.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationFlowers = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationFlowers;

package/dist/components/vegetation/VegetationForest.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { ForestVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationForestProps extends VegetationVariantProps {
+    config: ForestVegetationConfig;
+}
+declare const VegetationForest: React.FC<VegetationForestProps>;
+export default VegetationForest;
+//# sourceMappingURL=VegetationForest.d.ts.map

package/dist/components/vegetation/VegetationForest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationForest.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationForest.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACjE,MAAM,EAAE,sBAAsB,CAAC;CAClC;AAED,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAOrD,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/components/vegetation/VegetationForest.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/forest.js';
+// =============================================================================
+// VegetationForest — Forest (type 'vegetation', config.type 'forest')
+// =============================================================================
+// A forest of hundreds to thousands of trees filling its box: a species mix (temperate, conifer, birch, mediterranean, tropical, savanna, blossom, winter) in groves and glades with undergrowth, every tree an instanced lit impostor and the nearest ones real trees. Use for woods, hillsides, landscapes and backdrops.
+// The construction lives in core/forest.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.forest,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.forest.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationForest = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationForest;

package/dist/components/vegetation/VegetationFruit.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { FruitVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationFruitProps extends VegetationVariantProps {
+    config: FruitVegetationConfig;
+}
+declare const VegetationFruit: React.FC<VegetationFruitProps>;
+export default VegetationFruit;
+//# sourceMappingURL=VegetationFruit.d.ts.map

package/dist/components/vegetation/VegetationFruit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationFruit.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationFruit.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAChE,MAAM,EAAE,qBAAqB,CAAC;CACjC;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAOnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/vegetation/VegetationFruit.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/fruit.js';
+// =============================================================================
+// VegetationFruit — Fruit (type 'vegetation', config.type 'fruit')
+// =============================================================================
+// One kind of fruit (apple, orange, lemon, pear, banana, cherry, strawberry, grapes, watermelon, pineapple) as a single piece or a pile on the ground: a procedural body with its stem and leaves, a skin that ripens between two colours with the kind's pattern and gloss. Use for kitchens, markets, still lifes and food scenes.
+// The construction lives in core/fruit.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.fruit,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.fruit.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationFruit = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationFruit;

package/dist/components/vegetation/VegetationGrass.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { GrassVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationGrassProps extends VegetationVariantProps {
+    config: GrassVegetationConfig;
+}
+declare const VegetationGrass: React.FC<VegetationGrassProps>;
+export default VegetationGrass;
+//# sourceMappingURL=VegetationGrass.d.ts.map

package/dist/components/vegetation/VegetationGrass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationGrass.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationGrass.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAChE,MAAM,EAAE,qBAAqB,CAAC;CACjC;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAOnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/vegetation/VegetationGrass.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/grass.js';
+// =============================================================================
+// VegetationGrass — Grass (type 'vegetation', config.type 'grass')
+// =============================================================================
+// A field of bent grass blades in tufts and patches, with waves running through it in the wind, drying from the tips with the season, and scattered meadow flowers. Use for lawns, meadows, verges and any ground that should not be bare.
+// The construction lives in core/grass.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.grass,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.grass.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationGrass = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationGrass;

package/dist/components/vegetation/VegetationHedge.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { HedgeVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationHedgeProps extends VegetationVariantProps {
+    config: HedgeVegetationConfig;
+}
+declare const VegetationHedge: React.FC<VegetationHedgeProps>;
+export default VegetationHedge;
+//# sourceMappingURL=VegetationHedge.d.ts.map

package/dist/components/vegetation/VegetationHedge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationHedge.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationHedge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAChE,MAAM,EAAE,qBAAqB,CAAC;CACjC;AAED,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAOnD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/components/vegetation/VegetationHedge.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/hedge.js';
+// =============================================================================
+// VegetationHedge — Hedge (type 'vegetation', config.type 'hedge')
+// =============================================================================
+// A clipped hedge or topiary (box, dome, ball, cylinder, cone, spiral) filled with foliage: a dense skin of small leaves on the clipped surface, a shaded fill inside and twigs beneath, from razor-trimmed to shaggy. Use for gardens, borders, mazes, formal grounds and topiary.
+// The construction lives in core/hedge.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.hedge,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.hedge.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationHedge = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationHedge;

package/dist/components/vegetation/VegetationIvy.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { IvyVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationIvyProps extends VegetationVariantProps {
+    config: IvyVegetationConfig;
+}
+declare const VegetationIvy: React.FC<VegetationIvyProps>;
+export default VegetationIvy;
+//# sourceMappingURL=VegetationIvy.d.ts.map

package/dist/components/vegetation/VegetationIvy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationIvy.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationIvy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAC9D,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/vegetation/VegetationIvy.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/ivy.js';
+// =============================================================================
+// VegetationIvy — Ivy (type 'vegetation', config.type 'ivy')
+// =============================================================================
+// Climbing ivy on the faces of its box: vines random-walked up a wall with branching and thinning, three-lobed leaves facing out, drawn from the ground with the growth knob so it can climb in animation. Use for walls, pillars, fences, ruins and facades.
+// The construction lives in core/ivy.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.ivy,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.ivy.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationIvy = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationIvy;

package/dist/components/vegetation/VegetationTree.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { TreeVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationTreeProps extends VegetationVariantProps {
+    config: TreeVegetationConfig;
+}
+declare const VegetationTree: React.FC<VegetationTreeProps>;
+export default VegetationTree;
+//# sourceMappingURL=VegetationTree.d.ts.map

package/dist/components/vegetation/VegetationTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationTree.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationTree.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IAC/D,MAAM,EAAE,oBAAoB,CAAC;CAChC;AAED,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAOjD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/vegetation/VegetationTree.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/tree.js';
+// =============================================================================
+// VegetationTree — Tree (type 'vegetation', config.type 'tree')
+// =============================================================================
+// A parametric tree: a species' branching skeleton (oak, pine, birch, willow, palm, maple, cypress) with ridged bark, shaped leaves that turn with the season and let go, hanging fruit that ripens, and hierarchical wind. Use for parks, forests, gardens and any outdoor scene.
+// The construction lives in core/tree.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.tree,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.tree.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationTree = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationTree;

package/dist/components/vegetation/VegetationVegetable.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { VegetableVegetationConfig } from '@3driseai/3drise-core';
+import type { VegetationVariantProps } from './useVegetationInstance';
+export interface VegetationVegetableProps extends VegetationVariantProps {
+    config: VegetableVegetationConfig;
+}
+declare const VegetationVegetable: React.FC<VegetationVegetableProps>;
+export default VegetationVegetable;
+//# sourceMappingURL=VegetationVegetable.d.ts.map

package/dist/components/vegetation/VegetationVegetable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VegetationVegetable.d.ts","sourceRoot":"","sources":["../../../src/components/vegetation/VegetationVegetable.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,KAAK,EAAkB,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAmBtF,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACpE,MAAM,EAAE,yBAAyB,CAAC;CACrC;AAED,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAO3D,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/components/vegetation/VegetationVegetable.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DEFAULT_VEGETATION_OBJECTS, VEGETATION_OBJECTS_ANIMATABLE } from '@3driseai/3drise-core';
+import { useVegetationInstance } from './useVegetationInstance.js';
+import { createUniforms, build, STRUCTURAL } from './core/vegetable.js';
+// =============================================================================
+// VegetationVegetable — Vegetable (type 'vegetation', config.type 'vegetable')
+// =============================================================================
+// One kind of vegetable (tomato, pepper, pumpkin, carrot, corn, cucumber, eggplant, broccoli, potato, onion) as a single piece or a pile on the ground: a procedural body with its stem, calyx, tops or husk, a skin that ripens between two colours with the kind's pattern and gloss. Use for kitchens, markets, farms and food scenes.
+// The construction lives in core/vegetable.ts (emitted from the lab); this component wires it into
+// the config pattern and the scene sun through useVegetationInstance.
+const CORE = {
+    DEFAULTS: DEFAULT_VEGETATION_OBJECTS.vegetable,
+    STRUCTURAL,
+    /** Knobs a keyframe or pointer binding may drive per frame — exactly what the push applies. */
+    ANIMATABLE: new Set(VEGETATION_OBJECTS_ANIMATABLE.vegetable.map((p) => p.value)),
+    createUniforms,
+    build,
+};
+const VegetationVegetable = (props) => {
+    const { rootRef, instance } = useVegetationInstance(CORE, props);
+    return (_jsx("group", { ref: rootRef, children: _jsx("primitive", { object: instance.object }) }));
+};
+export default VegetationVegetable;