@almadar/ui 1.0.30 → 1.0.32

package/dist/context/index.d.ts

@@ -1,9 +1,9 @@
 import * as React from 'react';
 import React__default from 'react';
-import { U as UISlotManager, a as UISlot, S as SlotContent } from '../useUISlots-mnggE9X9.js';
-export { R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback } from '../useUISlots-mnggE9X9.js';
-import { T as ThemeProviderProps } from '../ThemeContext-lI5bo85E.js';
-export { B as BUILT_IN_THEMES, C as ColorMode, D as DesignTheme, R as ResolvedMode, a as ThemeContext, b as ThemeDefinition, c as ThemeProvider, u as useTheme } from '../ThemeContext-lI5bo85E.js';
+import { U as UISlotManager, a as UISlot, S as SlotContent } from '../useUISlots-D0mttBSP.js';
+export { R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback } from '../useUISlots-D0mttBSP.js';
+import { T as ThemeProviderProps } from '../ThemeContext-D9xUORq5.js';
+export { B as BUILT_IN_THEMES, C as ColorMode, D as DesignTheme, R as ResolvedMode, a as ThemeContext, b as ThemeDefinition, c as ThemeProvider, u as useTheme } from '../ThemeContext-D9xUORq5.js';
 
 /**
  * UISlotContext

package/dist/context/index.js

@@ -1,7 +1,6 @@
-export { UISlotContext, UISlotProvider, useSlotContent, useSlotHasContent, useUISlots } from '../chunk-W5YTXLXL.js';
+import { ThemeProvider, useTheme } from '../chunk-BTXQJGFB.js';
+export { BUILT_IN_THEMES, ThemeContext_default as ThemeContext, ThemeProvider, UISlotContext, UISlotProvider, useSlotContent, useSlotHasContent, useTheme, useUISlots } from '../chunk-BTXQJGFB.js';
 import '../chunk-7NEWMNNU.js';
-import { ThemeProvider, useTheme } from '../chunk-4UFNDD6B.js';
-export { BUILT_IN_THEMES, ThemeContext_default as ThemeContext, ThemeProvider, useTheme } from '../chunk-4UFNDD6B.js';
 import '../chunk-PKBMQBKP.js';
 import { createContext, useCallback, useMemo, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';

package/dist/{event-bus-types-8-cjyMxw.d.ts → event-bus-types-CjJduURa.d.ts}

@@ -60,6 +60,14 @@ interface EventBusContextType {
      * @returns True if there are listeners
      */
     hasListeners: (type: string) => boolean;
+    /**
+     * Subscribe to ALL events regardless of type.
+     * Useful for verification, debugging, and analytics.
+     *
+     * @param listener - Callback function invoked for every emitted event
+     * @returns Unsubscribe function
+     */
+    onAny?: (listener: EventListener) => Unsubscribe;
 }
 
 export type { EventBusContextType as E, KFlowEvent as K, Unsubscribe as U, EventListener as a };

package/dist/hooks/index.d.ts

@@ -1,21 +1,12 @@
 import { OrbitalSchema } from '@almadar/core';
-import { E as EventBusContextType, a as EventListener } from '../event-bus-types-8-cjyMxw.js';
-export { K as KFlowEvent, U as Unsubscribe } from '../event-bus-types-8-cjyMxw.js';
-export { D as DEFAULT_SLOTS, R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback, S as SlotContent, a as UISlot, U as UISlotManager, u as useUISlotManager } from '../useUISlots-mnggE9X9.js';
+import { E as EventBusContextType, a as EventListener } from '../event-bus-types-CjJduURa.js';
+export { K as KFlowEvent, U as Unsubscribe } from '../event-bus-types-CjJduURa.js';
+export { D as DEFAULT_SLOTS, R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback, S as SlotContent, a as UISlot, U as UISlotManager, u as useUISlotManager } from '../useUISlots-D0mttBSP.js';
+import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { Entity, getEntity, getByType, getAllEntities, getSingleton, spawnEntity, updateEntity, updateSingleton, removeEntity, clearEntities } from '../stores/index.js';
 
-/**
- * useEventBus Hook
- *
- * Provides event bus utilities for component communication.
- * This connects to the EventBusProvider for real applications
- * or provides a simple in-memory bus for design system / Storybook.
- *
- * @packageDocumentation
- */
-
 declare global {
     interface Window {
         __kflowEventBus?: EventBusContextType | null;
@@ -77,13 +68,6 @@ declare function useEventListener(event: string, handler: EventListener): void;
  */
 declare function useEmitEvent(): (type: string, payload?: Record<string, unknown>) => void;
 
-/**
- * useOrbitalHistory Hook
- *
- * Provides version control timeline for OrbitalSchema changes.
- * Tracks changesets and snapshots, supports reverting to previous versions.
- */
-
 interface ChangeSummary {
     added: number;
     modified: number;
@@ -123,12 +107,6 @@ interface UseOrbitalHistoryResult {
 }
 declare function useOrbitalHistory(options: UseOrbitalHistoryOptions): UseOrbitalHistoryResult;
 
-/**
- * useFileSystem Hook
- *
- * Provides file system operations for WebContainer-based file management.
- * Handles booting, mounting files, reading/writing, and tree operations.
- */
 interface FileNode {
     path: string;
     name: string;
@@ -170,11 +148,6 @@ interface UseFileSystemResult {
 }
 declare function useFileSystem(): UseFileSystemResult;
 
-/**
- * useExtensions Hook
- *
- * Manages loading and accessing language/editor extensions.
- */
 interface Extension {
     id: string;
     name: string;
@@ -208,12 +181,6 @@ interface UseExtensionsResult {
 }
 declare function useExtensions(options: UseExtensionsOptions): UseExtensionsResult;
 
-/**
- * useFileEditor Hook
- *
- * Manages file editing state and operations.
- */
-
 interface OpenFile {
     path: string;
     content: string;
@@ -244,11 +211,6 @@ interface UseFileEditorResult {
 }
 declare function useFileEditor(options: UseFileEditorOptions): UseFileEditorResult;
 
-/**
- * useCompile Hook
- *
- * Handles schema compilation to generate application files.
- */
 interface SchemaLike {
     name: string;
     version?: string;
@@ -272,13 +234,6 @@ interface UseCompileResult {
 }
 declare function useCompile(): UseCompileResult;
 
-/**
- * usePreview Hook
- *
- * Stub implementation for app preview state management.
- * Actual API calls should be implemented by the consuming client.
- */
-
 interface PreviewApp {
     id: string;
     name: string;
@@ -336,12 +291,6 @@ interface UsePreviewOptions {
 }
 declare function usePreview(options?: UsePreviewOptions): UsePreviewResult;
 
-/**
- * useDeepAgentGeneration Hook
- *
- * Stub implementation for deep agent generation functionality.
- */
-
 interface DeepAgentActionRequest {
     id: string;
     type: string;
@@ -388,12 +337,6 @@ interface UseDeepAgentGenerationResult {
 }
 declare function useDeepAgentGeneration(): UseDeepAgentGenerationResult;
 
-/**
- * useAgentChat Hook
- *
- * Stub implementation for agent chat functionality.
- */
-
 interface ChatMessage {
     id: string;
     role: 'user' | 'assistant' | 'system';
@@ -498,11 +441,6 @@ interface UseAgentChatResult {
 }
 declare function useAgentChat(options?: UseAgentChatOptions): UseAgentChatResult;
 
-/**
- * useValidation Hook
- *
- * Stub implementation for schema validation.
- */
 interface LLMErrorContext {
     rawValuePreview?: string;
     expectedType?: string;
@@ -550,16 +488,6 @@ interface UseValidationResult {
 }
 declare function useValidation(): UseValidationResult;
 
-/**
- * useUIEvents - UI Event to State Machine Bridge
- *
- * Listens for UI events from the event bus and dispatches
- * corresponding state machine events.
- *
- * Components emit events like `UI:VIEW`, `UI:SAVE`, `UI:CANCEL`
- * This hook translates them to state machine dispatch calls.
- */
-
 /**
  * Hook to bridge UI events to state machine dispatch
  *
@@ -595,17 +523,6 @@ declare function useUIEvents<E extends string>(dispatch: (event: E, payload?: un
  */
 declare function useSelectedEntity<T>(eventBusInstance?: ReturnType<typeof useEventBus>): [T | null, (entity: T | null) => void];
 
-/**
- * useEntityData Hook
- *
- * Provides data fetching utilities for entity lists and details.
- * Uses a pluggable EntityDataContext when available (e.g., builder runtime
- * bridges FetchedDataContext). Falls back to stubs when no provider is
- * present (Storybook, standalone design system).
- *
- * @packageDocumentation
- */
-
 interface EntityDataAdapter {
     /** Get all records for an entity */
     getData: (entity: string) => Record<string, unknown>[];
@@ -685,16 +602,57 @@ declare function useEntity$1<T = Record<string, unknown>>(entity: string | undef
  * Uses EntityDataContext if available, otherwise falls back to stub.
  */
 declare function useEntityDetail<T = Record<string, unknown>>(entity: string | undefined, id: string | undefined): UseEntityDetailResult<T>;
-
 /**
- * useQuerySingleton Hook
+ * Suspense-compatible hook for fetching entity list data.
  *
- * Provides query state management for search/filter components.
- * This is a stub implementation for the design system.
- * In a real application, this would connect to the orbital query singleton.
+ * Instead of returning `isLoading`/`error`, this hook **suspends** (throws a Promise)
+ * when data is not ready. Use inside a `<Suspense>` boundary.
  *
- * @packageDocumentation
+ * Falls back to the adapter when available; otherwise suspends briefly for stub data.
+ *
+ * @example
+ * ```tsx
+ * <Suspense fallback={<Skeleton variant="table" />}>
+ *   <ErrorBoundary>
+ *     <TaskList entity="Task" />
+ *   </ErrorBoundary>
+ * </Suspense>
+ *
+ * function TaskList({ entity }: { entity: string }) {
+ *   const { data } = useEntityListSuspense<Task>(entity);
+ *   // No loading check needed — Suspense handles it
+ *   return <DataTable data={data} ... />;
+ * }
+ * ```
  */
+declare function useEntityListSuspense<T = Record<string, unknown>>(entity: string): {
+    data: T[];
+    refetch: () => void;
+};
+/**
+ * Suspense-compatible hook for fetching a single entity by ID.
+ *
+ * Suspends when data is not ready. Use inside a `<Suspense>` boundary.
+ *
+ * @example
+ * ```tsx
+ * <Suspense fallback={<Skeleton variant="form" />}>
+ *   <ErrorBoundary>
+ *     <TaskDetail entity="Task" id={taskId} />
+ *   </ErrorBoundary>
+ * </Suspense>
+ *
+ * function TaskDetail({ entity, id }: { entity: string; id: string }) {
+ *   const { data } = useEntitySuspense<Task>(entity, id);
+ *   return <DetailPanel data={data} ... />;
+ * }
+ * ```
+ */
+declare function useEntitySuspense<T = Record<string, unknown>>(entity: string, id: string): {
+    data: T | null;
+    refetch: () => void;
+};
+
 /**
  * Query state for filters and search
  */
@@ -928,13 +886,6 @@ declare function useEntityMutations(entityName: string, options?: UseEntityMutat
     deleteError: Error | null;
 };
 
-/**
- * useEntities Hook
- *
- * React hook to access the entity store.
- * Uses useSyncExternalStore for efficient updates.
- */
-
 /**
  * Hook to access all entities
  */
@@ -984,6 +935,74 @@ declare function useInput(): {
     updateInput: (updates: Partial<Entity>) => void;
 };
 
+type TranslateFunction = (key: string, params?: Record<string, string | number>) => string;
+interface I18nContextValue {
+    /** Current locale code (e.g. 'en', 'ar', 'sl') */
+    locale: string;
+    /** Text direction for the current locale */
+    direction: 'ltr' | 'rtl';
+    /** Translate a key, with optional interpolation params */
+    t: TranslateFunction;
+}
+/**
+ * Provider component — wrap your app or Storybook decorator with this.
+ *
+ * ```tsx
+ * <I18nProvider value={{ locale: 'ar', direction: 'rtl', t: createTranslate(arMessages) }}>
+ *   <App />
+ * </I18nProvider>
+ * ```
+ */
+declare const I18nProvider: React.Provider<I18nContextValue>;
+/**
+ * Hook to access the current locale and translate function.
+ * Safe to call without a provider — returns passthrough t().
+ */
+declare function useTranslate(): I18nContextValue;
+/**
+ * Create a translate function from a flat messages object.
+ *
+ * ```ts
+ * const t = createTranslate({ 'common.save': 'Save', 'table.showing': 'Showing {{count}} of {{total}}' });
+ * t('common.save') // → 'Save'
+ * t('table.showing', { count: 5, total: 20 }) // → 'Showing 5 of 20'
+ * t('missing.key') // → 'missing.key' (fallback)
+ * ```
+ */
+declare function createTranslate(messages: Record<string, string>): TranslateFunction;
+
+interface ResolvedEntity<T> {
+    /** Resolved data array */
+    data: T[];
+    /** True when data was provided directly via props (not fetched) */
+    isLocal: boolean;
+    /** Loading state — always false for local data */
+    isLoading: boolean;
+    /** Error state — always null for local data */
+    error: Error | null;
+}
+/**
+ * Resolves entity data from either a direct `data` prop or an `entity` string.
+ *
+ * When `data` is provided, it is used directly (isLocal: true).
+ * When only `entity` (string) is provided, data is fetched via useEntityList.
+ * Direct `data` always takes precedence over auto-fetch.
+ *
+ * @param entity - Entity name string for auto-fetch, or undefined
+ * @param data - Direct data array from trait render-ui, or undefined
+ * @returns Normalized { data, isLocal, isLoading, error }
+ *
+ * @example
+ * ```tsx
+ * function MyOrganism({ entity, data, isLoading, error }: MyProps) {
+ *   const resolved = useResolvedEntity<Item>(entity, data);
+ *   // resolved.data is always T[] regardless of source
+ *   // resolved.isLocal tells you if data came from props
+ * }
+ * ```
+ */
+declare function useResolvedEntity<T = Record<string, unknown>>(entity: string | undefined, data: readonly T[] | T[] | undefined): ResolvedEntity<T>;
+
 /**
  * Auth Context Hook Stub
  *
@@ -1010,11 +1029,6 @@ interface AuthContextValue {
  */
 declare function useAuthContext(): AuthContextValue;
 
-/**
- * GitHub Integration Hooks
- *
- * React hooks for GitHub OAuth and repository management.
- */
 /**
  * GitHub connection status
  */
@@ -1074,4 +1088,4 @@ declare function useGitHubBranches(owner: string, repo: string, enabled?: boolea
     branches: string[];
 }, Error>;
 
-export { type AuthContextValue, type AuthUser, type ChangeSummary, type CompileResult, type CompileStage, ENTITY_EVENTS, Entity, type EntityDataAdapter, EntityDataProvider, type EntityDataRecord, type EntityMutationResult, EventBusContextType, EventListener, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryTimelineItem, type OpenFile, type OrbitalEventPayload, type OrbitalEventResponse, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type RevertResult, type SelectedFile, type UseCompileResult, type UseEntityDetailResult, type UseEntityListOptions, type UseEntityListResult, type UseEntityMutationsOptions, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, clearEntities, entityDataKeys, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEmitEvent, useEntities, useEntitiesByType, useEntity$1 as useEntity, useEntity as useEntityById, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityMutations, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useQuerySingleton, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation };
+export { type AuthContextValue, type AuthUser, type ChangeSummary, type CompileResult, type CompileStage, ENTITY_EVENTS, Entity, type EntityDataAdapter, EntityDataProvider, type EntityDataRecord, type EntityMutationResult, EventBusContextType, EventListener, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryTimelineItem, type I18nContextValue, I18nProvider, type OpenFile, type OrbitalEventPayload, type OrbitalEventResponse, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type ResolvedEntity, type RevertResult, type SelectedFile, type TranslateFunction, type UseCompileResult, type UseEntityDetailResult, type UseEntityListOptions, type UseEntityListResult, type UseEntityMutationsOptions, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, clearEntities, createTranslate, entityDataKeys, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEmitEvent, useEntities, useEntitiesByType, useEntity$1 as useEntity, useEntity as useEntityById, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntityMutations, useEntitySuspense, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useQuerySingleton, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useTranslate, useUIEvents, useUpdateEntity, useValidation };

package/dist/hooks/index.js

@@ -1,6 +1,7 @@
-export { ENTITY_EVENTS, parseQueryBinding, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEntities, useEntitiesByType, useEntity as useEntityById, useEntityMutations, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useQuerySingleton, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation } from '../chunk-7IYF4RUG.js';
-export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-7NEWMNNU.js';
+export { ENTITY_EVENTS, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEntities, useEntitiesByType, useEntity as useEntityById, useEntityMutations, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useResolvedEntity, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation } from '../chunk-RFD6G3ZR.js';
 import '../chunk-XSEDIUM6.js';
-export { EntityDataProvider, entityDataKeys, useEmitEvent, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, useEventBus, useEventListener } from '../chunk-HY5EFCOK.js';
+export { EntityDataProvider, I18nProvider, createTranslate, entityDataKeys, parseQueryBinding, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, useEntityListSuspense, useEntitySuspense, useQuerySingleton, useTranslate } from '../chunk-PE2H3NAW.js';
+export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-7NEWMNNU.js';
 export { clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../chunk-N7MVUW4R.js';
+export { useEmitEvent, useEventBus, useEventListener } from '../chunk-YXZM3WCF.js';
 import '../chunk-PKBMQBKP.js';

package/dist/isometric-ynNHVPZx.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Isometric Game Types
+ *
+ * Type definitions for isometric grid rendering: tiles, units, features.
+ * Used by IsometricCanvas and game hooks.
+ *
+ * @packageDocumentation
+ */
+/** A single isometric tile on the grid */
+interface IsometricTile {
+    /** Optional unique identifier (required for 3D rendering) */
+    id?: string;
+    /** Grid x coordinate */
+    x: number;
+    /** Grid y coordinate (2D) */
+    y: number;
+    /** Grid z coordinate (3D alternative to y) */
+    z?: number;
+    /** Terrain type key (e.g., 'grass', 'stone', 'water') - 2D */
+    terrain?: string;
+    /** Tile type for visual rendering (3D) */
+    type?: string;
+    /** Direct sprite URL override (bypasses getTerrainSprite resolver) */
+    terrainSprite?: string;
+    /** Whether units can traverse this tile (default true) */
+    passable?: boolean;
+    /** Movement cost for pathfinding (default 1) */
+    movementCost?: number;
+    /** Optional tile type for visual variants */
+    tileType?: string;
+    /** Elevation offset for 3D rendering */
+    elevation?: number;
+}
+/** A unit positioned on the isometric grid */
+interface IsometricUnit {
+    /** Unique unit identifier */
+    id: string;
+    /** Current grid position (2D format) */
+    position?: {
+        x: number;
+        y: number;
+    };
+    /** Grid x coordinate (3D format) */
+    x?: number;
+    /** Grid y coordinate (3D format) */
+    y?: number;
+    /** Grid z coordinate (3D format) */
+    z?: number;
+    /** Static sprite URL (used when no sprite sheet animation) */
+    sprite?: string;
+    /** Unit archetype key for sprite resolution */
+    unitType?: string;
+    /** Hero identifier for sprite sheet lookup */
+    heroId?: string;
+    /** Display name rendered below the unit */
+    name?: string;
+    /** Team affiliation for coloring */
+    team?: 'player' | 'enemy' | 'neutral';
+    /** Faction for 3D rendering (player/enemy/neutral) */
+    faction?: 'player' | 'enemy' | 'neutral';
+    /** Current health */
+    health?: number;
+    /** Maximum health */
+    maxHealth?: number;
+    /** Trait attachments for state display */
+    traits?: {
+        name: string;
+        currentState: string;
+        states: string[];
+        cooldown: number;
+    }[];
+    /** Previous position for movement trail ghost */
+    previousPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Elevation offset for 3D rendering */
+    elevation?: number;
+}
+/** A map feature (resource, building, portal, etc.) */
+interface IsometricFeature {
+    /** Optional unique identifier (required for 3D rendering) */
+    id?: string;
+    /** Grid x coordinate */
+    x: number;
+    /** Grid y coordinate (2D) */
+    y: number;
+    /** Grid z coordinate (3D alternative to y) */
+    z?: number;
+    /** Feature type key (e.g., 'goldMine', 'castle', 'portal') */
+    type: string;
+    /** Direct sprite URL override (bypasses getFeatureSprite resolver) */
+    sprite?: string;
+    /** 3D model URL (GLB format) for GameCanvas3D */
+    assetUrl?: string;
+    /** Color override for 3D rendering */
+    color?: string;
+    /** Elevation offset for 3D rendering */
+    elevation?: number;
+}
+/** Camera state for pan/zoom */
+interface CameraState {
+    /** Camera X offset in pixels */
+    x: number;
+    /** Camera Y offset in pixels */
+    y: number;
+    /** Zoom level (1.0 = 100%) */
+    zoom: number;
+}
+
+export type { CameraState as C, IsometricTile as I, IsometricUnit as a, IsometricFeature as b };