@almadar/ui 5.29.0 → 5.30.0

package/dist/components/core/molecules/DocumentViewer.d.ts

@@ -51,8 +51,6 @@ export interface DocumentViewerProps {
     actions?: readonly DocumentAction[];
     /** Multiple documents (tabbed view) */
     documents?: readonly DocumentItem[];
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
     /** Loading state */
     isLoading?: boolean;
     /** Error state */

package/dist/components/core/molecules/Header.d.ts

@@ -109,9 +109,5 @@ export interface HeaderProps {
      * Error state (closed circuit)
      */
     error?: UiError | null;
-    /**
-     * Entity name for schema-driven auto-fetch (closed circuit)
-     */
-    entity?: string;
 }
 export declare const Header: React.FC<HeaderProps>;

package/dist/components/core/molecules/Navigation.d.ts

@@ -63,7 +63,5 @@ export interface NavigationProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
 }
 export declare const Navigation: React.FC<NavigationProps>;

package/dist/components/core/molecules/PageHeader.d.ts

@@ -45,8 +45,6 @@ export interface PageHeaderProps {
     isLoading?: boolean;
     /** Error state */
     error?: UiError | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
     /** Tabs for sub-navigation */
     tabs?: ReadonlyArray<{
         label: string;

package/dist/components/core/molecules/PropertyInspector.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { DeclaredTraitConfig, TraitConfig, TraitConfigValue, AssetCatalog } from '@almadar/core';
+import type { DeclaredTraitConfig, ConfigFieldDeclaration, TraitConfig, TraitConfigValue, AssetCatalog } from '@almadar/core';
 import type { DisplayStateProps } from '../organisms/types';
 /**
  * PropertyInspector — Storybook-style controls panel for a trait's `config`.
@@ -26,4 +26,11 @@ export interface PropertyInspectorProps extends DisplayStateProps {
     /** Browsable asset catalog supplied to `asset`-typed fields' AssetPicker. */
     assets?: AssetCatalog;
 }
+export declare function FieldControl({ name, decl, value, onChange, assets, }: {
+    name: string;
+    decl: ConfigFieldDeclaration;
+    value: TraitConfigValue | undefined;
+    onChange: (field: string, value: TraitConfigValue) => void;
+    assets?: AssetCatalog;
+}): React.ReactElement;
 export declare const PropertyInspector: React.FC<PropertyInspectorProps>;

package/dist/components/game/molecules/three/index.cjs

@@ -1756,6 +1756,30 @@ function TileRenderer({
       const x = (tile.x - offsetX) * cellSize;
       const z = ((tile.z ?? tile.y ?? 0) - offsetZ) * cellSize;
       const y = (tile.elevation ?? 0) * 0.1;
+      const position = [x, y, z];
+      if (tile.modelUrl) {
+        return /* @__PURE__ */ jsxRuntime.jsx(
+          "group",
+          {
+            userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
+            onClick: () => onTileClick?.(tile),
+            onPointerEnter: () => onTileHover?.(tile),
+            onPointerLeave: () => onTileHover?.(null),
+            children: /* @__PURE__ */ jsxRuntime.jsx(
+              ModelLoader,
+              {
+                url: tile.modelUrl,
+                position,
+                scale: cellSize * 0.9,
+                fallbackGeometry: "box",
+                castShadow: true,
+                receiveShadow: true
+              }
+            )
+          },
+          tile.id ?? `tile-${tile.x}-${tile.y}`
+        );
+      }
       const colorHex = terrainColors[tile.type || ""] || terrainColors[tile.terrain || ""] || "#808080";
       const isSelected = tile.id ? selectedTileIds.includes(tile.id) : false;
       const isValidMove = validMoves.some(
@@ -1771,7 +1795,7 @@ function TileRenderer({
       return /* @__PURE__ */ jsxRuntime.jsxs(
         "mesh",
         {
-          position: [x, y, z],
+          position,
           userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
           onClick: () => onTileClick?.(tile),
           onPointerEnter: () => onTileHover?.(tile),
@@ -1793,7 +1817,8 @@ function TileRenderer({
       );
     });
   };
-  if (useInstancing && tiles.length > 0) {
+  const hasModelTiles = tiles.some((t) => t.modelUrl);
+  if (useInstancing && tiles.length > 0 && !hasModelTiles) {
     return /* @__PURE__ */ jsxRuntime.jsx(
       "instancedMesh",
       {

package/dist/components/game/molecules/three/index.js

@@ -1732,6 +1732,30 @@ function TileRenderer({
       const x = (tile.x - offsetX) * cellSize;
       const z = ((tile.z ?? tile.y ?? 0) - offsetZ) * cellSize;
       const y = (tile.elevation ?? 0) * 0.1;
+      const position = [x, y, z];
+      if (tile.modelUrl) {
+        return /* @__PURE__ */ jsx(
+          "group",
+          {
+            userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
+            onClick: () => onTileClick?.(tile),
+            onPointerEnter: () => onTileHover?.(tile),
+            onPointerLeave: () => onTileHover?.(null),
+            children: /* @__PURE__ */ jsx(
+              ModelLoader,
+              {
+                url: tile.modelUrl,
+                position,
+                scale: cellSize * 0.9,
+                fallbackGeometry: "box",
+                castShadow: true,
+                receiveShadow: true
+              }
+            )
+          },
+          tile.id ?? `tile-${tile.x}-${tile.y}`
+        );
+      }
       const colorHex = terrainColors[tile.type || ""] || terrainColors[tile.terrain || ""] || "#808080";
       const isSelected = tile.id ? selectedTileIds.includes(tile.id) : false;
       const isValidMove = validMoves.some(
@@ -1747,7 +1771,7 @@ function TileRenderer({
       return /* @__PURE__ */ jsxs(
         "mesh",
         {
-          position: [x, y, z],
+          position,
           userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
           onClick: () => onTileClick?.(tile),
           onPointerEnter: () => onTileHover?.(tile),
@@ -1769,7 +1793,8 @@ function TileRenderer({
       );
     });
   };
-  if (useInstancing && tiles.length > 0) {
+  const hasModelTiles = tiles.some((t) => t.modelUrl);
+  if (useInstancing && tiles.length > 0 && !hasModelTiles) {
     return /* @__PURE__ */ jsx(
       "instancedMesh",
       {

package/dist/components/game/organisms/TraitSlot.d.ts

@@ -29,7 +29,9 @@ export type SlotItemData = {
     description?: string;
     /** Emoji or text icon */
     iconEmoji?: string;
-    /** Image URL icon (takes precedence over iconEmoji) */
+    /** Image URL icon (takes precedence over iconEmoji)
+     * @default https://almadar-kflow-assets.web.app/shared/platformer/items/platformPack_item001.png
+     */
     iconUrl?: AssetUrl;
     /** Optional state machine for tooltip display */
     stateMachine?: TraitStateMachineDefinition;

package/dist/components/game/organisms/types/isometric.d.ts

@@ -31,6 +31,8 @@ export interface IsometricTile {
     tileType?: string;
     /** Elevation offset for 3D rendering */
     elevation?: number;
+    /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
+    modelUrl?: AssetUrl;
 }
 /** A unit positioned on the isometric grid */
 export type IsometricUnit = {