@almadar/ui 5.18.1 → 5.20.0

package/dist/components/{organisms/game → game/organisms}/three/index.css

@@ -1,4 +1,4 @@
-/* components/organisms/game/three/components/Canvas3DLoadingState.css */
+/* components/game/organisms/three/components/Canvas3DLoadingState.css */
 .canvas-3d-loading {
   position: absolute;
   inset: 0;
@@ -151,7 +151,7 @@
   }
 }
 
-/* components/organisms/game/three/components/Canvas3DErrorBoundary.css */
+/* components/game/organisms/three/components/Canvas3DErrorBoundary.css */
 .canvas-3d-error {
   position: absolute;
   inset: 0;
@@ -209,7 +209,7 @@
 }
 .canvas-3d-error__details {
   margin: 24px 0;
-  text-align: left;
+  text-align: start;
   background: rgba(0, 0, 0, 0.3);
   border-radius: 8px;
   overflow: hidden;
@@ -314,7 +314,7 @@
   }
 }
 
-/* components/organisms/game/GameCanvas3D.css */
+/* components/game/organisms/GameCanvas3D.css */
 .game-canvas-3d {
   position: relative;
   width: 100%;

package/dist/components/{organisms/game → game/organisms}/three/index.d.ts

@@ -20,16 +20,16 @@ export { useGameCanvas3DEvents, type UseGameCanvas3DEventsOptions, type UseGameC
 export { AssetLoader, assetLoader, type LoadedModel, } from './loaders/AssetLoader';
 export { TileRenderer, UnitRenderer, FeatureRenderer, FeatureRenderer3D, preloadFeatures, type TileRendererProps, type UnitRendererProps, type FeatureRendererProps, type FeatureRenderer3DProps, type UnitAnimationState, } from './renderers';
 export { GameCanvas3D, type GameCanvas3DProps } from '../GameCanvas3D';
-export { GameCanvas3DBattleTemplate, type GameCanvas3DBattleTemplateProps } from '../../../templates/GameCanvas3DBattleTemplate';
-export { GameCanvas3DCastleTemplate, type GameCanvas3DCastleTemplateProps } from '../../../templates/GameCanvas3DCastleTemplate';
-export { GameCanvas3DWorldMapTemplate, type GameCanvas3DWorldMapTemplateProps } from '../../../templates/GameCanvas3DWorldMapTemplate';
+export { GameCanvas3DBattleTemplate, type GameCanvas3DBattleTemplateProps } from '../../templates/GameCanvas3DBattleTemplate';
+export { GameCanvas3DCastleTemplate, type GameCanvas3DCastleTemplateProps } from '../../templates/GameCanvas3DCastleTemplate';
+export { GameCanvas3DWorldMapTemplate, type GameCanvas3DWorldMapTemplateProps } from '../../templates/GameCanvas3DWorldMapTemplate';
 export { gridToWorld, worldToGrid, raycastToPlane, raycastToObjects, gridDistance, gridManhattanDistance, getNeighbors, isInBounds, getCellsInRadius, createGridHighlight, normalizeMouseCoordinates, type Grid3DConfig, type GridCoordinate, } from './utils/grid3D';
-export { Avl3DViewer, type Avl3DViewerProps } from '../../avl/Avl3DViewer';
-export { Avl3DApplicationScene, type Avl3DApplicationSceneProps } from '../../avl/Avl3DApplicationScene';
-export { Avl3DOrbitalScene, type Avl3DOrbitalSceneProps } from '../../avl/Avl3DOrbitalScene';
-export { Avl3DTraitScene, type Avl3DTraitSceneProps } from '../../avl/Avl3DTraitScene';
-export { Avl3DTransitionScene, type Avl3DTransitionSceneProps } from '../../avl/Avl3DTransitionScene';
-export { Avl3DEffects, type Avl3DEffectsProps } from '../../avl/Avl3DEffects';
-export { Avl3DContext, useAvl3DConfig, type Avl3DModelOverrides, type Avl3DConfig } from '../../avl/avl-3d-context';
-export { AVL_3D_COLORS, CAMERA_POSITIONS, goldenSpiralPositions, fibonacciSpherePositions, orbitRingPositions, arcCurve3D, selfLoopCurve3D, treeLayout3D, type Position3D, } from '../../avl/avl-3d-layout';
+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/organisms/avl-3d-context';
+export { AVL_3D_COLORS, CAMERA_POSITIONS, goldenSpiralPositions, fibonacciSpherePositions, orbitRingPositions, arcCurve3D, selfLoopCurve3D, treeLayout3D, type Position3D, } from '../../../avl/organisms/avl-3d-layout';
 export { isInFrustum, filterByFrustum, getVisibleIndices, calculateLODLevel, updateInstanceLOD, cullInstancedMesh, SpatialHashGrid, type CullingOptions, type LODLevel, type LODConfig, } from './utils/culling';

package/dist/components/{organisms/game → game/organisms}/three/index.js

@@ -1,5 +1,5 @@
-import React10, { forwardRef, useRef, useEffect, useImperativeHandle, useState, useMemo, useCallback, createContext, Component, useContext, useReducer } from 'react';
-import { useThree, useFrame, Canvas } from '@react-three/fiber';
+import React11, { forwardRef, useRef, useEffect, useImperativeHandle, useState, useMemo, useCallback, createContext, Component, useContext, useReducer } from 'react';
+import { useThree, useFrame, Canvas, context } from '@react-three/fiber';
 import * as THREE6 from 'three';
 import { Vector3, QuadraticBezierCurve3, MathUtils, Quaternion } from 'three';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -755,7 +755,7 @@ var AssetLoader = class {
 };
 var assetLoader = new AssetLoader();
 
-// components/organisms/game/three/hooks/useThree.ts
+// components/game/organisms/three/hooks/useThree.ts
 var DEFAULT_OPTIONS = {
   cameraMode: "isometric",
   cameraPosition: [10, 10, 10],
@@ -1475,7 +1475,7 @@ function useEmitEvent() {
   );
 }
 
-// components/organisms/game/three/hooks/useGameCanvas3DEvents.ts
+// components/game/organisms/three/hooks/useGameCanvas3DEvents.ts
 function useGameCanvas3DEvents(options) {
   const {
     tileClickEvent,
@@ -1862,7 +1862,7 @@ function UnitRenderer({
   onAnimationStateChange,
   animationSpeed = 1
 }) {
-  const handleUnitClick = React10.useCallback(
+  const handleUnitClick = React11.useCallback(
     (unit) => {
       onUnitClick?.(unit);
     },
@@ -2039,15 +2039,14 @@ function FeatureVisual({
     }
   );
 }
-function FeatureRenderer({
+function FeatureGroup({
   features,
   cellSize = 1,
   offsetX = 0,
   offsetZ = 0,
   onFeatureClick,
   onFeatureHover,
-  selectedFeatureIds = [],
-  featureColors
+  selectedFeatureIds = []
 }) {
   return /* @__PURE__ */ jsx("group", { children: features.map((feature) => {
     const x = (feature.x - offsetX) * cellSize;
@@ -2067,6 +2066,15 @@ function FeatureRenderer({
     );
   }) });
 }
+function FeatureRenderer(props) {
+  const insideCanvas = useContext(context) != null;
+  if (insideCanvas) return /* @__PURE__ */ jsx(FeatureGroup, { ...props });
+  return /* @__PURE__ */ jsxs(Canvas, { camera: { position: [4, 4, 6], fov: 50 }, style: { width: "100%", height: 360 }, children: [
+    /* @__PURE__ */ jsx("ambientLight", { intensity: 0.6 }),
+    /* @__PURE__ */ jsx("directionalLight", { position: [5, 8, 5], intensity: 0.8 }),
+    /* @__PURE__ */ jsx(FeatureGroup, { ...props })
+  ] });
+}
 var log5 = createLogger("almadar:ui:game:feature-renderer");
 function detectAssetRoot3(modelUrl) {
   const idx = modelUrl.indexOf("/3d/");
@@ -2741,7 +2749,7 @@ function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
 
-// components/atoms/Box.tsx
+// components/core/atoms/Box.tsx
 var paddingStyles = {
   none: "p-0",
   xs: "p-1",
@@ -2844,7 +2852,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React10.forwardRef(
+var Box = React11.forwardRef(
   ({
     padding,
     paddingX,
@@ -2894,7 +2902,7 @@ var Box = React10.forwardRef(
       onMouseLeave?.(e);
     }, [hoverEvent, eventBus, onMouseLeave]);
     const isClickable = action || onClick;
-    return React10.createElement(
+    return React11.createElement(
       Component2,
       {
         ref,
@@ -3379,7 +3387,7 @@ function normalizeMouseCoordinates(clientX, clientY, element) {
   };
 }
 
-// components/organisms/avl/avl-schema-parser.ts
+// components/avl/organisms/avl-schema-parser.ts
 function getEntity(orbital) {
   const entity = orbital.entity;
   if (typeof entity === "string") {
@@ -3641,7 +3649,7 @@ function parseTransitionLevel(schema, orbitalName, traitName, transitionIndex) {
   };
 }
 
-// components/organisms/avl/avl-zoom-state.ts
+// components/avl/organisms/avl-zoom-state.ts
 var initialZoomState = {
   level: "application",
   selectedOrbital: null,
@@ -5131,7 +5139,7 @@ var Avl3DTraitScene = ({
 };
 Avl3DTraitScene.displayName = "Avl3DTraitScene";
 
-// components/atoms/avl/types.ts
+// components/avl/atoms/types.ts
 var AVL_OPERATOR_COLORS = {
   arithmetic: "#4A90D9",
   comparison: "#E8913A",
@@ -5637,7 +5645,7 @@ var Avl3DViewer = ({
   const handleTraitClick = useCallback((name) => {
     dispatch({ type: "ZOOM_INTO_TRAIT", trait: name, targetPosition: { x: 0, y: 0 } });
   }, []);
-  const [highlightedTrait, setHighlightedTrait] = React10.useState(null);
+  const [highlightedTrait, setHighlightedTrait] = React11.useState(null);
   const handleTransitionClick = useCallback((index) => {
     dispatch({ type: "ZOOM_INTO_TRANSITION", transitionIndex: index, targetPosition: { x: 0, y: 0 } });
   }, []);
@@ -5724,7 +5732,7 @@ var Avl3DViewer = ({
             gap: "xs",
             align: "center",
             className: "absolute top-2 left-2 z-10 bg-surface/80 backdrop-blur rounded-md px-3 py-1.5",
-            children: breadcrumbs.map((crumb, i) => /* @__PURE__ */ jsxs(React10.Fragment, { children: [
+            children: breadcrumbs.map((crumb, i) => /* @__PURE__ */ jsxs(React11.Fragment, { children: [
               i > 0 && /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", className: "mx-1", children: "/" }),
               i < breadcrumbs.length - 1 ? /* @__PURE__ */ jsx(
                 Box,

package/dist/components/{organisms/game → game/organisms}/three/renderers/FeatureRenderer.d.ts

@@ -27,18 +27,12 @@ export interface FeatureRendererProps {
     featureColors?: Record<string, string>;
 }
 /**
- * FeatureRenderer Component
- *
- * Renders all features in the scene.
- *
- * @example
- * ```tsx
- * <FeatureRenderer
- *     features={features}
- *     cellSize={1}
- *     onFeatureClick={handleFeatureClick}
- * />
- * ```
+ * Self-contained FeatureRenderer. three.js geometry only renders inside an
+ * `@react-three/fiber` `<Canvas>`. When already inside one (the fiber context is
+ * set) it renders the raw group; standalone it bundles a default `<Canvas>`
+ * (camera + lighting) so it shows on its own. The Canvas is an implementation
+ * detail, and the conditional check keeps it composable inside a larger scene
+ * (no nested Canvas).
  */
-export declare function FeatureRenderer({ features, cellSize, offsetX, offsetZ, onFeatureClick, onFeatureHover, selectedFeatureIds, featureColors, }: FeatureRendererProps): React.JSX.Element;
+export declare function FeatureRenderer(props: FeatureRendererProps): React.JSX.Element;
 export default FeatureRenderer;

package/dist/components/{templates → game/templates}/BattleTemplate.d.ts

@@ -9,9 +9,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { TemplateProps } from './types';
-import type { BattleEntity } from '../organisms/game/BattleBoard';
-export type { BattleEntity, BattlePhase, BattleUnit, BattleTile, BattleSlotContext, } from '../organisms/game/BattleBoard';
+import type { TemplateProps } from '../../core/templates/types';
+import type { BattleEntity } from '../organisms/BattleBoard';
+export type { BattleEntity, BattlePhase, BattleUnit, BattleTile, BattleSlotContext, } from '../organisms/BattleBoard';
 export interface BattleTemplateProps extends TemplateProps<BattleEntity> {
     /** Canvas render scale */
     scale?: number;

package/dist/components/{templates → game/templates}/CastleTemplate.d.ts

@@ -9,9 +9,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { TemplateProps } from './types';
-import type { CastleEntity } from '../organisms/game/CastleBoard';
-export type { CastleEntity, CastleSlotContext, } from '../organisms/game/CastleBoard';
+import type { TemplateProps } from '../../core/templates/types';
+import type { CastleEntity } from '../organisms/CastleBoard';
+export type { CastleEntity, CastleSlotContext, } from '../organisms/CastleBoard';
 export interface CastleTemplateProps extends TemplateProps<CastleEntity> {
     /** Canvas render scale */
     scale?: number;

package/dist/components/{templates → game/templates}/GameCanvas3DBattleTemplate.d.ts

@@ -19,8 +19,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/game/types/isometric';
-import type { TemplateProps } from './types';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import type { TemplateProps } from '../../core/templates/types';
 export interface Battle3DEntity {
     /** Battlefield tiles */
     tiles: IsometricTile[];

package/dist/components/{templates → game/templates}/GameCanvas3DCastleTemplate.d.ts

@@ -18,8 +18,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/game/types/isometric';
-import type { TemplateProps } from './types';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import type { TemplateProps } from '../../core/templates/types';
 export interface Castle3DEntity {
     /** Castle grounds tiles */
     tiles: IsometricTile[];

package/dist/components/{templates → game/templates}/GameCanvas3DWorldMapTemplate.d.ts

@@ -19,8 +19,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/game/types/isometric';
-import type { TemplateProps } from './types';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import type { TemplateProps } from '../../core/templates/types';
 export interface WorldMap3DEntity {
     /** Map tiles */
     tiles: IsometricTile[];

package/dist/components/{templates → game/templates}/GameTemplate.d.ts

@@ -6,7 +6,7 @@
  * **Atomic Design**: Composed using Box, Typography, and Layout molecules/atoms.
  */
 import React from "react";
-import type { TemplateProps } from "./types";
+import type { TemplateProps } from "../../core/templates/types";
 interface GameEntity {
     id: string;
     title?: string;

package/dist/components/{templates → game/templates}/WorldMapTemplate.d.ts

@@ -9,9 +9,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { TemplateProps } from './types';
-import type { WorldMapEntity } from '../organisms/game/WorldMapBoard';
-export type { WorldMapEntity, MapHero, MapHex, WorldMapSlotContext, } from '../organisms/game/WorldMapBoard';
+import type { TemplateProps } from '../../core/templates/types';
+import type { WorldMapEntity } from '../organisms/WorldMapBoard';
+export type { WorldMapEntity, MapHero, MapHex, WorldMapSlotContext, } from '../organisms/WorldMapBoard';
 export interface WorldMapTemplateProps extends TemplateProps<WorldMapEntity> {
     /** Canvas render scale */
     scale?: number;