@almadar/ui 2.1.10 → 2.2.0

package/dist/{chunk-JLEMVREZ.js → chunk-GOZKH7QW.js}

@@ -1,12 +1,15 @@
 import { useEventBus } from './chunk-YXZM3WCF.js';
+import { en_default } from './chunk-TSETXL2E.js';
 import React2, { createContext, useContext, useState, useMemo, useCallback, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
+var { $meta: _meta, ...coreMessages } = en_default;
+var coreLocale = coreMessages;
 var I18nContext = createContext({
   locale: "en",
   direction: "ltr",
-  t: (key) => key
-  // passthrough fallback
+  t: (key) => coreLocale[key] ?? key
+  // core locale fallback
 });
 I18nContext.displayName = "I18nContext";
 var I18nProvider = I18nContext.Provider;
@@ -15,7 +18,7 @@ function useTranslate() {
 }
 function createTranslate(messages) {
   return (key, params) => {
-    let msg = messages[key] ?? key;
+    let msg = messages[key] ?? coreLocale[key] ?? key;
     if (params) {
       for (const [k, v] of Object.entries(params)) {
         msg = msg.split(`{{${k}}}`).join(String(v));

package/dist/chunk-TSETXL2E.js

@@ -0,0 +1,103 @@
+// locales/en.json
+var en_default = {
+  $meta: { locale: "en", direction: "ltr" },
+  "common.save": "Save",
+  "common.cancel": "Cancel",
+  "common.delete": "Delete",
+  "common.close": "Close",
+  "common.confirm": "Are you sure?",
+  "common.create": "Create",
+  "common.edit": "Edit",
+  "common.view": "View",
+  "common.add": "Add",
+  "common.remove": "Remove",
+  "common.search": "Search...",
+  "common.filter": "Filter",
+  "common.actions": "Actions",
+  "common.yes": "Yes",
+  "common.no": "No",
+  "common.ok": "OK",
+  "common.done": "Done",
+  "common.apply": "Apply",
+  "common.reset": "Reset",
+  "common.refresh": "Refresh",
+  "common.export": "Export",
+  "common.import": "Import",
+  "common.copy": "Copy",
+  "common.settings": "Settings",
+  "nav.previous": "Previous",
+  "nav.next": "Next",
+  "nav.back": "Back",
+  "nav.home": "Home",
+  "form.submit": "Submit",
+  "form.saving": "Saving...",
+  "form.required": "This field is required",
+  "form.invalidEmail": "Enter a valid email address",
+  "form.selectPlaceholder": "Select {{label}}...",
+  "form.searchPlaceholder": "Search {{entity}}...",
+  "table.empty.title": "No items found",
+  "table.empty.description": "No items to display.",
+  "table.search.placeholder": "Search...",
+  "table.pagination.showing": "Showing {{start}} to {{end}} of {{total}} results",
+  "table.pagination.page": "Page {{page}} of {{totalPages}}",
+  "table.bulk.selected": "{{count}} selected",
+  "table.loading": "Loading...",
+  "status.loading": "Loading...",
+  "status.scheduled": "Scheduled",
+  "status.inProgress": "In Progress",
+  "status.completed": "Completed",
+  "status.cancelled": "Cancelled",
+  "status.pending": "Pending",
+  "status.active": "Active",
+  "status.inactive": "Inactive",
+  "status.draft": "Draft",
+  "status.archived": "Archived",
+  "error.generic": "Something went wrong",
+  "error.retry": "Try again",
+  "error.notFound": "Not found",
+  "error.loadFailed": "Failed to load: {{message}}",
+  "error.configMissing": "Configuration not found for: {{id}}",
+  "common.loading": "Loading...",
+  "common.saveChanges": "Save Changes",
+  "common.retry": "Retry",
+  "common.open": "Open",
+  "common.back": "Back",
+  "empty.noItems": "No items",
+  "empty.noData": "No data available",
+  "empty.noItemsYet": "No items yet",
+  "empty.noItemsAdded": "No items added yet",
+  "empty.noOptionsFound": "No options found",
+  "list.addItemPlaceholder": "Add new item...",
+  "error.occurred": "An error occurred",
+  "error.failedToLoad": "Failed to load data",
+  "wizard.back": "Back",
+  "wizard.next": "Next",
+  "wizard.complete": "Complete",
+  "wizard.stepOf": "Step {{current}} of {{total}}",
+  "pagination.previous": "Previous",
+  "pagination.next": "Next",
+  "pagination.total": "Total:",
+  "pagination.show": "Show:",
+  "pagination.goTo": "Go to:",
+  "pagination.go": "Go",
+  "auth.signIn": "Sign in",
+  "auth.signOut": "Sign out",
+  "dialog.confirm": "Confirm",
+  "dialog.cancel": "Cancel",
+  "dialog.loading": "Loading...",
+  "dialog.delete.title": "Delete {{item}}?",
+  "dialog.delete.message": "This action cannot be undone.",
+  "trait.availableActions": "Available Actions",
+  "trait.transitions": "Transitions",
+  "trait.availableNow": "Available now",
+  "book.startReading": "Start Reading",
+  "book.tableOfContents": "Table of Contents",
+  "book.partNumber": "Part {{number}}",
+  "book.print": "Print",
+  "book.previousPage": "Previous page",
+  "book.nextPage": "Next page",
+  "quiz.showAnswer": "Show answer",
+  "quiz.hideAnswer": "Hide answer"
+};
+
+export { en_default };

package/dist/components/index.d.ts

@@ -10,8 +10,8 @@ import { I as IsometricTile, a as IsometricUnit, b as IsometricFeature, C as Cam
 export { AuthContextValue, AuthUser, ChangeSummary, CompileResult, CompileStage, ENTITY_EVENTS, EntityDataAdapter, EntityDataProvider, EntityDataRecord, EntityMutationResult, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, HistoryTimelineItem, I18nContextValue, I18nProvider, OpenFile, OrbitalEventPayload, OrbitalEventResponse, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, ResolvedEntity, RevertResult, SelectedFile, TranslateFunction, UseCompileResult, UseEntityDetailResult, UseEntityListOptions, UseEntityListResult, UseEntityMutationsOptions, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseOrbitalHistoryOptions, UseOrbitalHistoryResult, createTranslate, entityDataKeys, parseQueryBinding, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEmitEvent, useEntities, useEntitiesByType, useEntity, 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 } from '../hooks/index.js';
 import { E as EventBusContextType } from '../event-bus-types-CjJduURa.js';
 export { a as EventListener, K as KFlowEvent, U as Unsubscribe } from '../event-bus-types-CjJduURa.js';
-import { S as SlotContent, a as UISlot } from '../useUISlots-D0mttBSP.js';
-export { D as DEFAULT_SLOTS, R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback, U as UISlotManager, u as useUISlotManager } from '../useUISlots-D0mttBSP.js';
+import { S as SlotContent, a as UISlot } from '../useUISlots-BBjNvQtb.js';
+export { D as DEFAULT_SLOTS, R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback, U as UISlotManager, u as useUISlotManager } from '../useUISlots-BBjNvQtb.js';
 export { Entity, clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../stores/index.js';
 import 'clsx';
 import '@tanstack/react-query';
@@ -114,6 +114,8 @@ type BadgeSize = "sm" | "md" | "lg";
 interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     variant?: BadgeVariant;
     size?: BadgeSize;
+    /** Numeric count or amount to display in badge */
+    amount?: number;
 }
 declare const Badge: React__default.ForwardRefExoticComponent<BadgeProps & React__default.RefAttributes<HTMLSpanElement>>;
 
@@ -1437,6 +1439,14 @@ interface CardProps {
     className?: string;
     /** Declarative event name — emits UI:{action} via eventBus on card click */
     action?: string;
+    /** Whether the card is selected (highlighted state) */
+    isSelected?: boolean;
+    /** Card name (alias for title) */
+    name?: string;
+    /** Level indicator */
+    level?: number;
+    /** Maximum level */
+    maxLevel?: number;
 }
 /**
  * Card component for displaying content in a contained box
@@ -2683,6 +2693,8 @@ interface StatCardProps extends EntityDisplayProps {
     };
     /** Metrics to display (schema format) - accepts readonly for compatibility with generated const arrays */
     metrics?: readonly MetricDefinition[];
+    /** Compact display mode */
+    compact?: boolean;
 }
 declare const StatCard: React__default.FC<StatCardProps>;
 
@@ -2990,7 +3002,7 @@ interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormEleme
     /** Additional CSS classes */
     className?: string;
     /** Entity type name or schema object. When OrbitalEntity, fields are auto-derived if not provided. */
-    entity?: string | OrbitalEntity;
+    entity?: string | OrbitalEntity | readonly Record<string, unknown>[];
     /** Form mode - 'create' for new records, 'edit' for updating existing */
     mode?: "create" | "edit";
     /** Fields definition (schema format) - accepts readonly for generated const arrays */
@@ -3587,6 +3599,10 @@ interface CardGridProps extends EntityDisplayProps {
     itemActions?: readonly CardItemAction[];
     /** Show total count in pagination */
     showTotal?: boolean;
+    /** Show avatar/image field on cards */
+    showAvatar?: boolean;
+    /** Visual variant for the card grid */
+    variant?: string;
 }
 /**
  * CardGrid - Responsive card collection layout
@@ -4387,15 +4403,13 @@ interface SpriteSheetUrls {
  * @packageDocumentation
  */
 
-interface IsometricCanvasProps {
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
+/** Event Contract:
+ *  Emits: UI:TILE_CLICK
+ *  Emits: UI:UNIT_CLICK
+ *  Emits: UI:TILE_HOVER
+ *  Emits: UI:TILE_LEAVE
+ */
+interface IsometricCanvasProps extends EntityDisplayProps {
     /** Array of tiles to render */
     tiles?: IsometricTile[];
     /** Array of units on the board */
@@ -4419,13 +4433,9 @@ interface IsometricCanvasProps {
         x: number;
         y: number;
     } | null;
-    /** Tile click handler */
     onTileClick?: (x: number, y: number) => void;
-    /** Unit click handler */
     onUnitClick?: (unitId: string) => void;
-    /** Tile hover handler */
     onTileHover?: (x: number, y: number) => void;
-    /** Tile leave handler */
     onTileLeave?: () => void;
     /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
     tileClickEvent?: string;
@@ -4447,6 +4457,10 @@ interface IsometricCanvasProps {
     enableCamera?: boolean;
     /** Extra scale multiplier for unit draw size. 1 = default. */
     unitScale?: number;
+    /** Board width in tiles (overrides tile-derived size) */
+    boardWidth?: number;
+    /** Board height in tiles (overrides tile-derived size) */
+    boardHeight?: number;
     /** Override for the diamond-top Y offset within the tile sprite (default: 374).
      *  This controls where the flat diamond face sits vertically inside the tile image. */
     diamondTopY?: number;
@@ -4460,7 +4474,7 @@ interface IsometricCanvasProps {
     resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
     /** Additional sprite URLs to preload (e.g., effect sprites) */
     effectSpriteUrls?: string[];
-    /** Callback to draw canvas effects after units */
+    /** Callback to draw canvas effects after units (canvas-specific: cannot be declarative) */
     onDrawEffects?: (ctx: CanvasRenderingContext2D, animTime: number, getImage: (url: string) => HTMLImageElement | undefined) => void;
     /** Whether there are active effects — keeps RAF loop alive */
     hasActiveEffects?: boolean;
@@ -5350,6 +5364,11 @@ interface DialogueNode {
     choices?: DialogueChoice[];
     autoAdvance?: number;
 }
+/** Event Contract:
+ *  Emits: UI:COMPLETE
+ *  Emits: UI:CHOICE
+ *  Emits: UI:ADVANCE
+ */
 interface DialogueBoxProps {
     /** Current dialogue node to display */
     dialogue: DialogueNode;
@@ -5706,9 +5725,14 @@ interface WorldMapEntity {
     };
     backgroundImage?: string;
 }
-interface WorldMapBoardProps extends Omit<EntityDisplayProps, 'entity'> {
-    /** World map entity data */
-    entity: WorldMapEntity;
+/** Event Contract:
+ *  Emits: UI:HERO_SELECT
+ *  Emits: UI:HERO_MOVE
+ *  Emits: UI:BATTLE_ENCOUNTER
+ *  Emits: UI:FEATURE_ENTER
+ *  Emits: UI:TILE_CLICK
+ */
+interface WorldMapBoardProps extends EntityDisplayProps<WorldMapEntity> {
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */
@@ -5755,7 +5779,7 @@ interface WorldMapBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
     className?: string;
 }
-declare function WorldMapBoard({ entity, scale, unitScale, allowMoveAllHeroes, isInRange, heroSelectEvent, heroMoveEvent, battleEncounterEvent, featureEnterEvent, tileClickEvent, header, sidePanel, overlay, footer, onHeroSelect, onHeroMove, onBattleEncounter, onFeatureEnter, diamondTopY, enableCamera, effectSpriteUrls, resolveUnitFrame, className, }: WorldMapBoardProps): React__default.JSX.Element;
+declare function WorldMapBoard({ entity, isLoading, scale, unitScale, allowMoveAllHeroes, isInRange, heroSelectEvent, heroMoveEvent, battleEncounterEvent, featureEnterEvent, tileClickEvent, header, sidePanel, overlay, footer, onHeroSelect, onHeroMove, onBattleEncounter, onFeatureEnter, diamondTopY, enableCamera, effectSpriteUrls, resolveUnitFrame, className, }: WorldMapBoardProps): React__default.JSX.Element;
 declare namespace WorldMapBoard {
     var displayName: string;
 }
@@ -5929,6 +5953,10 @@ interface SlotItemData {
     /** Optional state machine for tooltip display */
     stateMachine?: TraitStateMachineDefinition;
 }
+/** Event Contract:
+ *  Emits: UI:CLICK
+ *  Emits: UI:REMOVE
+ */
 interface TraitSlotProps {
     /** Slot index (1-based) */
     slotNumber: number;
@@ -7826,14 +7854,19 @@ declare const CodeViewer: React__default.FC<CodeViewerProps>;
  * All templates MUST extend `TemplateProps<E>` to enforce entity-only data flow
  * and JSON round-trip compatibility with the flattener pipeline.
  *
+ * The compiler passes `entity` as `E[]` (array from data store), so
+ * TemplateProps accepts the same union as EntityDisplayProps.
+ *
  * @see docs/Almadar_Templates.md
  */
 /** Base props for all templates — enforces entity-only data flow. */
 interface TemplateProps<E extends {
     id: string;
+} = {
+    id: string;
 }> {
-    /** Entity data — the sole source of runtime state */
-    entity: E;
+    /** Entity data — single object, array from compiler, or string entity name */
+    entity?: string | E | readonly E[];
     /** External styling override */
     className?: string;
 }
@@ -7841,7 +7874,7 @@ interface TemplateProps<E extends {
 interface NavItem {
     label: string;
     href: string;
-    icon: LucideIcon;
+    icon?: LucideIcon;
     badge?: string | number;
     children?: NavItem[];
 }
@@ -7866,6 +7899,8 @@ interface DashboardLayoutProps {
     sidebarFooter?: React__default.ReactNode;
     /** Callback when user clicks sign out (optional - uses auth context signOut if not provided) */
     onSignOut?: () => void;
+    /** Page content rendered inside the main area */
+    children?: React__default.ReactNode;
 }
 declare const DashboardLayout: React__default.FC<DashboardLayoutProps>;
 
@@ -7997,11 +8032,10 @@ declare const GenericAppTemplate: React__default.FC<GenericAppTemplateProps>;
  * Replaces DashboardLayout for game clients — no sidebar nav, just full-viewport
  * rendering with an optional HUD overlay bar.
  *
- * Used as a React Router layout route element:
- *   <Route element={<GameShell appName="TraitWars" />}>
- *     <Route index element={<WorldMapPage />} />
- *     ...
- *   </Route>
+ * Wrap game page content directly as children:
+ *   <GameShell appName="TraitWars">
+ *     <WorldMapPage />
+ *   </GameShell>
  *
  * @generated pattern — can be customised per-game via props
  */
@@ -8015,11 +8049,13 @@ interface GameShellProps {
     className?: string;
     /** Whether to show the minimal top bar (default: true) */
     showTopBar?: boolean;
+    /** Game content rendered inside the full-screen area */
+    children?: React__default.ReactNode;
 }
 /**
  * Full-viewport game shell layout.
  *
- * Renders child routes via `<Outlet />` inside a full-height flex container.
+ * Renders children inside a full-height flex container.
  * An optional top bar shows the game title and can host HUD widgets.
  */
 declare const GameShell: React__default.FC<GameShellProps>;
@@ -8041,7 +8077,7 @@ interface BattleTemplateProps extends TemplateProps<BattleEntity> {
     /** Unit draw-size multiplier */
     unitScale?: number;
 }
-declare function BattleTemplate({ entity, scale, unitScale, className, }: BattleTemplateProps): React__default.JSX.Element;
+declare function BattleTemplate({ entity, scale, unitScale, className, }: BattleTemplateProps): React__default.JSX.Element | null;
 declare namespace BattleTemplate {
     var displayName: string;
 }
@@ -8061,7 +8097,7 @@ interface CastleTemplateProps extends TemplateProps<CastleEntity> {
     /** Canvas render scale */
     scale?: number;
 }
-declare function CastleTemplate({ entity, scale, className, }: CastleTemplateProps): React__default.JSX.Element;
+declare function CastleTemplate({ entity, scale, className, }: CastleTemplateProps): React__default.JSX.Element | null;
 declare namespace CastleTemplate {
     var displayName: string;
 }