@almadar/ui 5.107.0 → 5.109.0

package/dist/components/game/three/lib/game3dAssetManifest.d.ts

@@ -1,48 +0,0 @@
-/**
- * game3dAssetManifest — shared, asset-URL-free helpers for the 3D game-canvas
- * templates (battle / castle / world-map).
- *
- * Every GLB model URL lives in the lolo `assetManifest` config and arrives via
- * props; these helpers resolve a tile's / feature's `modelUrl` from that manifest
- * by terrain/feature key. NO asset URLs are declared here — the templates and this
- * module stay pure, exactly like the `GameCanvas3D` molecule.
- *
- * @packageDocumentation
- */
-import type { Asset, EntityRow } from '@almadar/core';
-import type { IsometricTile, IsometricFeature } from '../../lib/isometricTypes';
-/** GLB model assets for a 3D board, keyed by terrain "kind" and (optionally) feature type. */
-export interface Game3DAssetManifest {
-    /** Floor model assets by terrain kind ('wall' | 'dirt' | 'open'). */
-    models?: Record<string, Asset>;
-    /** Feature/structure model assets by feature type ('gold_mine', 'portal', …). */
-    features?: Record<string, Asset>;
-}
-/** Layout-only tile (no model URL): position + terrain kind. */
-export interface Tile3DLayout {
-    id?: string;
-    x: number;
-    y: number;
-    z?: number;
-    type: string;
-    passable?: boolean;
-    /** Terrain kind that maps into `assetManifest.models` (wall | dirt | open). */
-    kind: string;
-}
-/**
- * Resolve a layout tile array into render-ready `IsometricTile[]`, attaching each
- * tile's `modelUrl` from `assetManifest.models` by terrain kind. Pure: URLs come
- * only from the manifest.
- */
-export declare function resolveTilesWithModels(layout: readonly Tile3DLayout[], manifest: Game3DAssetManifest | undefined): IsometricTile[];
-/**
- * Map prop `IsometricTile[]` (which already carry `type`/`passable` but no model)
- * into render-ready tiles with manifest-resolved model URLs.
- */
-export declare function resolvePropTiles(tiles: readonly IsometricTile[], manifest: Game3DAssetManifest | undefined): IsometricTile[];
-/** Read entity-carried tile rows into render-ready `IsometricTile[]` with manifest-resolved models. */
-export declare function resolveEntityTiles(entity: EntityRow | readonly EntityRow[] | undefined, manifest: Game3DAssetManifest | undefined): IsometricTile[];
-/** Resolve feature model URLs from `assetManifest.features` by feature type. */
-export declare function resolveFeaturesWithModels(features: readonly IsometricFeature[], manifest: Game3DAssetManifest | undefined): IsometricFeature[];
-/** Read entity-carried feature rows into render-ready `IsometricFeature[]` with manifest models. */
-export declare function resolveEntityFeatures(entity: EntityRow | readonly EntityRow[] | undefined, manifest: Game3DAssetManifest | undefined): IsometricFeature[];

package/dist/components/game/three/molecules/GameCamera3D.d.ts

@@ -1,35 +0,0 @@
-/**
- * GameCamera3D
- *
- * Camera-tracking helpers extracted from GameCanvas3D: an imperative-handle
- * position reporter, a smooth-follow camera for `follow`/`chase` modes, and a
- * lerped group wrapper for interpolated positions between LOLO tick snapshots.
- *
- * @packageDocumentation
- */
-import React from 'react';
-/** Reports the live camera position on every change (imperative handle integration). */
-export declare function CameraController3D({ onCameraChange, }: {
-    onCameraChange?: (pos: {
-        x: number;
-        y: number;
-        z: number;
-    }) => void;
-}): null;
-/**
- * Camera that smooth-tracks a world-space target (side-view player or selected unit).
- * OrbitControls is disabled while following — the camera is authoritative.
- */
-export declare function FollowCamera3D({ target, offset, }: {
-    target: [number, number, number];
-    offset: [number, number, number];
-}): null;
-/**
- * Group that smooth-lerps toward its target position between LOLO tick snapshots
- * (the 3D analogue of Canvas2D's `interpolateUnits`). Disabled → snaps.
- */
-export declare function LerpedGroup3D({ target, enabled, children, }: {
-    target: [number, number, number];
-    enabled: boolean;
-    children: React.ReactNode;
-}): React.JSX.Element;

package/dist/components/game/three/molecules/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * Game 3D (three.js)
- *
- * Three.js components, hooks, loaders, renderers, and the GameCanvas3D family.
- * Code-split behind the `@almadar/ui/components/molecules/game/three` subpath.
- *
- * @packageDocumentation
- */
-export { Scene3D, type Scene3DProps } from './Scene3D';
-export { Camera3D, type Camera3DProps, type Camera3DHandle, type CameraMode } from './Camera3D';
-export { Lighting3D, type Lighting3DProps } from './Lighting3D';
-export { Canvas3DLoadingState, type Canvas3DLoadingStateProps, } from './Canvas3DLoadingState';
-export { Canvas3DErrorBoundary, type Canvas3DErrorBoundaryProps, type Canvas3DErrorBoundaryState, } from './Canvas3DErrorBoundary';
-export { ModelLoader, type ModelLoaderProps, } from './ModelLoader';
-export { useThree, type UseThreeOptions, type UseThreeReturn, } from '../hooks/useThree';
-export { useAssetLoader, type UseAssetLoaderOptions, type UseAssetLoaderReturn, type AssetLoadingState, } from '../hooks/useAssetLoader';
-export { useSceneGraph, type UseSceneGraphReturn, type SceneGraphNode, type NodeType, } from '../hooks/useSceneGraph';
-export { useRaycaster, type UseRaycasterOptions, type UseRaycasterReturn, type RaycastHit, type GridHit, } from '../hooks/useRaycaster';
-export { useGameCanvas3DEvents, type UseGameCanvas3DEventsOptions, type UseGameCanvas3DEventsReturn, type GameCanvas3DEventConfig, } from '../hooks/useGameCanvas3DEvents';
-export { AssetLoader, assetLoader, type LoadedModel, } from '../lib/AssetLoader';
-export type { UnitAnimationState } from '../../lib/spriteAnimationTypes';
-export { GameCanvas3D, type GameCanvas3DProps } from './GameCanvas3D';
-export { gridToWorld, worldToGrid, raycastToPlane, raycastToObjects, gridDistance, gridManhattanDistance, getNeighbors, isInBounds, getCellsInRadius, createGridHighlight, normalizeMouseCoordinates, type Grid3DConfig, type GridCoordinate, } from '../lib/grid3D';
-export { Avl3DViewer, type Avl3DViewerProps } from '../../../avl/organisms/Avl3DViewer';
-export { Avl3DApplicationScene, type Avl3DApplicationSceneProps } from '../../../avl/organisms/Avl3DApplicationScene';
-export { Avl3DOrbitalScene, type Avl3DOrbitalSceneProps } from '../../../avl/organisms/Avl3DOrbitalScene';
-export { Avl3DTraitScene, type Avl3DTraitSceneProps } from '../../../avl/organisms/Avl3DTraitScene';
-export { Avl3DTransitionScene, type Avl3DTransitionSceneProps } from '../../../avl/organisms/Avl3DTransitionScene';
-export { Avl3DEffects, type Avl3DEffectsProps } from '../../../avl/organisms/Avl3DEffects';
-export { Avl3DContext, useAvl3DConfig, type Avl3DModelOverrides, type Avl3DConfig } from '../../../avl/providers/avl-3d-context';
-export { AVL_3D_COLORS, CAMERA_POSITIONS, goldenSpiralPositions, fibonacciSpherePositions, orbitRingPositions, arcCurve3D, selfLoopCurve3D, treeLayout3D, type Position3D, } from '../../../avl/lib/avl-3d-layout';
-export { isInFrustum, filterByFrustum, getVisibleIndices, calculateLODLevel, updateInstanceLOD, cullInstancedMesh, SpatialHashGrid, type CullingOptions, type LODLevel, type LODConfig, } from '../lib/culling';

package/dist/components/game/three/patterns.d.ts

@@ -1,16 +0,0 @@
-/**
- * Curated list of the PUBLIC 3D (Three.js) render-ui pattern components.
- *
- * The 3D family is a code-split optional surface (published via the
- * `@almadar/ui/components/{organisms,molecules}/game/three` subpath, never in
- * the main barrel — that would pull @react-three/fiber into every app). This
- * file is the source of truth for WHICH 3D components are render-ui patterns:
- * `pattern-sync` discovers `patterns.ts` files by walking the tree and admits
- * exactly the names listed here, so the 3D scene internals re-exported alongside
- * them (Scene3D, Camera3D, Lighting3D, ModelLoader, Canvas3D, …) do NOT leak in
- * as factory patterns. Move this file anywhere under `components/` and the
- * scanner still finds it.
- *
- * @packageDocumentation
- */
-export { GameCanvas3D } from './molecules/GameCanvas3D';