@almadar/ui 2.1.11 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,8 @@
1
1
  import * as React$1 from 'react';
2
2
  import React__default, { ReactNode, ErrorInfo } from 'react';
3
3
  import { LucideIcon } from 'lucide-react';
4
- import { SExpr } from '@almadar/evaluator';
5
4
  import * as react_jsx_runtime from 'react/jsx-runtime';
5
+ import { SExpr } from '@almadar/evaluator';
6
6
  import { OrbitalEntity } from '@almadar/core';
7
7
  import { b as DomLayoutData, d as DomStateNode, V as VisualizerConfig, e as DomTransitionLabel, C as ContentSegment } from '../cn-BoBXsxuX.js';
8
8
  export { h as cn } from '../cn-BoBXsxuX.js';
@@ -10,8 +10,8 @@ import { I as IsometricTile, a as IsometricUnit, b as IsometricFeature, C as Cam
10
10
  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';
11
11
  import { E as EventBusContextType } from '../event-bus-types-CjJduURa.js';
12
12
  export { a as EventListener, K as KFlowEvent, U as Unsubscribe } from '../event-bus-types-CjJduURa.js';
13
- import { S as SlotContent, a as UISlot } from '../useUISlots-D0mttBSP.js';
14
- export { D as DEFAULT_SLOTS, R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback, U as UISlotManager, u as useUISlotManager } from '../useUISlots-D0mttBSP.js';
13
+ import { S as SlotContent, a as UISlot } from '../useUISlots-BBjNvQtb.js';
14
+ export { D as DEFAULT_SLOTS, R as RenderUIConfig, b as SlotAnimation, c as SlotChangeCallback, U as UISlotManager, u as useUISlotManager } from '../useUISlots-BBjNvQtb.js';
15
15
  export { Entity, clearEntities, getAllEntities, getByType, getEntity, getSingleton, removeEntity, spawnEntity, updateEntity, updateSingleton } from '../stores/index.js';
16
16
  import 'clsx';
17
17
  import '@tanstack/react-query';
@@ -26,10 +26,10 @@ interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElem
26
26
  leftIcon?: React__default.ReactNode;
27
27
  /** Right icon as ReactNode (preferred) */
28
28
  rightIcon?: React__default.ReactNode;
29
- /** Left icon as Lucide icon component (convenience prop, renders with default size) */
30
- icon?: LucideIcon;
31
- /** Right icon as Lucide icon component (convenience prop) */
32
- iconRight?: LucideIcon;
29
+ /** Left icon as Lucide icon component or string name (e.g. "plus", "trash") */
30
+ icon?: LucideIcon | string;
31
+ /** Right icon as Lucide icon component or string name */
32
+ iconRight?: LucideIcon | string;
33
33
  /** Declarative event name — emits UI:{action} via eventBus on click */
34
34
  action?: string;
35
35
  /** Payload to include with the action event */
@@ -116,6 +116,8 @@ interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
116
116
  size?: BadgeSize;
117
117
  /** Numeric count or amount to display in badge */
118
118
  amount?: number;
119
+ /** Badge label text (alternative to children for schema-driven rendering) */
120
+ label?: string;
119
121
  }
120
122
  declare const Badge: React__default.ForwardRefExoticComponent<BadgeProps & React__default.RefAttributes<HTMLSpanElement>>;
121
123
 
@@ -588,7 +590,7 @@ declare const TextHighlight: React__default.FC<TextHighlightProps>;
588
590
  * Text elements following the KFlow design system with theme-aware styling.
589
591
  */
590
592
 
591
- type TypographyVariant = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "body1" | "body2" | "body" | "caption" | "overline" | "small" | "large" | "label";
593
+ type TypographyVariant = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "heading" | "subheading" | "body1" | "body2" | "body" | "caption" | "overline" | "small" | "large" | "label";
592
594
  type TypographySize = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
593
595
  interface TypographyProps {
594
596
  /** Typography variant */
@@ -711,6 +713,21 @@ interface OverlayProps {
711
713
  }
712
714
  declare const Overlay: React__default.FC<OverlayProps>;
713
715
 
716
+ interface FlipContainerProps {
717
+ /** Whether the container is flipped (rotateY 180deg) */
718
+ flipped: boolean;
719
+ /** Optional className for the outer wrapper */
720
+ className?: string;
721
+ /** The two face elements (front and back) */
722
+ children: React__default.ReactNode;
723
+ /** Click handler on the outer wrapper */
724
+ onClick?: () => void;
725
+ }
726
+ declare const FlipContainer: {
727
+ ({ flipped, className, children, onClick, }: FlipContainerProps): react_jsx_runtime.JSX.Element;
728
+ displayName: string;
729
+ };
730
+
714
731
  /**
715
732
  * ConditionalWrapper Atom Component
716
733
  *
@@ -828,6 +845,52 @@ interface LawReferenceTooltipProps {
828
845
  */
829
846
  declare const LawReferenceTooltip: React__default.FC<LawReferenceTooltipProps>;
830
847
 
848
+ /**
849
+ * DayCell
850
+ *
851
+ * Calendar day header atom. Renders day abbreviation and date number
852
+ * with optional today highlight.
853
+ */
854
+
855
+ interface DayCellProps {
856
+ /** The date this cell represents */
857
+ date: Date;
858
+ /** Whether this date is today */
859
+ isToday?: boolean;
860
+ /** Called when the day is clicked */
861
+ onClick?: (date: Date) => void;
862
+ /** Additional CSS classes */
863
+ className?: string;
864
+ }
865
+ declare function DayCell({ date, isToday, onClick, className, }: DayCellProps): React__default.JSX.Element;
866
+ declare namespace DayCell {
867
+ var displayName: string;
868
+ }
869
+
870
+ /**
871
+ * TimeSlotCell
872
+ *
873
+ * Calendar time slot atom. Renders a clickable container for a single
874
+ * time slot that can hold event content via children.
875
+ */
876
+
877
+ interface TimeSlotCellProps {
878
+ /** Time label for this slot (e.g. "09:00") */
879
+ time: string;
880
+ /** Called when the slot is clicked */
881
+ onClick?: (time: string) => void;
882
+ /** Additional CSS classes */
883
+ className?: string;
884
+ /** Event content placed inside the slot */
885
+ children?: React__default.ReactNode;
886
+ /** Whether this slot contains an event */
887
+ isOccupied?: boolean;
888
+ }
889
+ declare function TimeSlotCell({ time, onClick, className, children, isOccupied, }: TimeSlotCellProps): React__default.JSX.Element;
890
+ declare namespace TimeSlotCell {
891
+ var displayName: string;
892
+ }
893
+
831
894
  interface HealthBarProps {
832
895
  /** Current health value */
833
896
  current: number;
@@ -2375,6 +2438,42 @@ interface ScaledDiagramProps {
2375
2438
  }
2376
2439
  declare const ScaledDiagram: React__default.FC<ScaledDiagramProps>;
2377
2440
 
2441
+ /**
2442
+ * CalendarGrid
2443
+ *
2444
+ * Pure presentational weekly calendar grid molecule.
2445
+ * No entity binding, no event bus, no translations.
2446
+ * Composes DayCell and TimeSlotCell atoms into a 7-day grid.
2447
+ */
2448
+
2449
+ interface CalendarEvent {
2450
+ id: string;
2451
+ title: string;
2452
+ startTime: string | Date;
2453
+ endTime?: string | Date;
2454
+ color?: string;
2455
+ }
2456
+ interface CalendarGridProps {
2457
+ /** Start of the week (defaults to current week's Monday) */
2458
+ weekStart?: Date;
2459
+ /** Time slot labels (defaults to 09:00-17:00) */
2460
+ timeSlots?: string[];
2461
+ /** Events to display on the grid */
2462
+ events?: CalendarEvent[];
2463
+ /** Called when a time slot is clicked */
2464
+ onSlotClick?: (day: Date, time: string) => void;
2465
+ /** Called when a day header is clicked */
2466
+ onDayClick?: (day: Date) => void;
2467
+ /** Called when an event is clicked */
2468
+ onEventClick?: (event: CalendarEvent) => void;
2469
+ /** Additional CSS classes */
2470
+ className?: string;
2471
+ }
2472
+ declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, }: CalendarGridProps): React__default.JSX.Element;
2473
+ declare namespace CalendarGrid {
2474
+ var displayName: string;
2475
+ }
2476
+
2378
2477
  /**
2379
2478
  * RepeatableFormSection
2380
2479
  *
@@ -2515,6 +2614,293 @@ interface FormSectionHeaderProps {
2515
2614
  }
2516
2615
  declare const FormSectionHeader: React__default.FC<FormSectionHeaderProps>;
2517
2616
 
2617
+ interface FlipCardProps {
2618
+ /** Content rendered on the front face */
2619
+ front: React__default.ReactNode;
2620
+ /** Content rendered on the back face */
2621
+ back: React__default.ReactNode;
2622
+ /** Controlled flip state */
2623
+ flipped?: boolean;
2624
+ /** Callback when the card is clicked to flip */
2625
+ onFlip?: () => void;
2626
+ /** Optional className for the outer container */
2627
+ className?: string;
2628
+ /** Card height as a Tailwind class (default: 'h-64') */
2629
+ height?: string;
2630
+ }
2631
+ declare const FlipCard: {
2632
+ ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): react_jsx_runtime.JSX.Element;
2633
+ displayName: string;
2634
+ };
2635
+
2636
+ /**
2637
+ * DateRangeSelector Molecule Component
2638
+ *
2639
+ * Button group for selecting time range periods.
2640
+ * Pure UI molecule with no entity binding.
2641
+ */
2642
+
2643
+ interface DateRangeSelectorOption {
2644
+ label: string;
2645
+ value: string;
2646
+ }
2647
+ interface DateRangeSelectorProps {
2648
+ /** Available range options */
2649
+ options?: DateRangeSelectorOption[];
2650
+ /** Currently selected value */
2651
+ selected?: string;
2652
+ /** Callback when a range is selected */
2653
+ onSelect?: (value: string) => void;
2654
+ /** Additional CSS classes */
2655
+ className?: string;
2656
+ }
2657
+ declare const DateRangeSelector: React__default.FC<DateRangeSelectorProps>;
2658
+
2659
+ /**
2660
+ * ChartLegend Molecule Component
2661
+ *
2662
+ * Color-coded legend for chart data series.
2663
+ * Pure UI molecule with no entity binding.
2664
+ */
2665
+
2666
+ interface ChartLegendItem {
2667
+ label: string;
2668
+ color: string;
2669
+ }
2670
+ interface ChartLegendProps {
2671
+ /** Legend items with label and color */
2672
+ items: ChartLegendItem[];
2673
+ /** Additional CSS classes */
2674
+ className?: string;
2675
+ /** Layout direction */
2676
+ direction?: 'horizontal' | 'vertical';
2677
+ }
2678
+ declare const ChartLegend: React__default.FC<ChartLegendProps>;
2679
+
2680
+ /**
2681
+ * LineChart Molecule Component
2682
+ *
2683
+ * SVG-based line/area chart for time-series data.
2684
+ * Pure UI molecule with no entity binding.
2685
+ */
2686
+
2687
+ interface ChartDataPoint$1 {
2688
+ date: string | Date;
2689
+ value: number;
2690
+ label?: string;
2691
+ }
2692
+ interface LineChartProps {
2693
+ /** Data points to plot */
2694
+ data: ChartDataPoint$1[];
2695
+ /** SVG viewBox width */
2696
+ width?: number;
2697
+ /** SVG viewBox height */
2698
+ height?: number;
2699
+ /** Show horizontal grid lines at 25/50/75% */
2700
+ showGrid?: boolean;
2701
+ /** Show value labels near data points */
2702
+ showValues?: boolean;
2703
+ /** Fill area under line with gradient */
2704
+ showArea?: boolean;
2705
+ /** Line stroke color */
2706
+ lineColor?: string;
2707
+ /** Area fill color (used for gradient) */
2708
+ areaColor?: string;
2709
+ /** Additional CSS classes */
2710
+ className?: string;
2711
+ }
2712
+ declare const LineChart: React__default.FC<LineChartProps>;
2713
+
2714
+ /**
2715
+ * ProgressDots Molecule Component
2716
+ *
2717
+ * Step indicator dots for multi-step flows.
2718
+ * Pure UI molecule with no entity binding.
2719
+ */
2720
+
2721
+ type DotState = 'active' | 'complete' | 'pending';
2722
+ type DotSize = 'sm' | 'md' | 'lg';
2723
+ interface ProgressDotsProps {
2724
+ /** Total number of dots */
2725
+ count: number;
2726
+ /** Current active index (0-based) */
2727
+ currentIndex: number;
2728
+ /** Custom state resolver per dot index */
2729
+ getState?: (index: number) => DotState;
2730
+ /** Callback when a dot is clicked */
2731
+ onDotClick?: (index: number) => void;
2732
+ /** Additional CSS classes */
2733
+ className?: string;
2734
+ /** Dot size */
2735
+ size?: DotSize;
2736
+ }
2737
+ declare const ProgressDots: React__default.FC<ProgressDotsProps>;
2738
+
2739
+ /**
2740
+ * GraphView Molecule Component
2741
+ *
2742
+ * Pure presentational force-directed graph visualization using SVG.
2743
+ * Entity-less, no event bus, no translations. Accepts raw nodes and edges.
2744
+ *
2745
+ * Uses a simple force simulation (repulsion + attraction + centering)
2746
+ * to lay out nodes, then renders via SVG circles and lines.
2747
+ */
2748
+
2749
+ interface GraphViewNode {
2750
+ id: string;
2751
+ label?: string;
2752
+ color?: string;
2753
+ size?: number;
2754
+ group?: string;
2755
+ }
2756
+ interface GraphViewEdge {
2757
+ source: string;
2758
+ target: string;
2759
+ color?: string;
2760
+ label?: string;
2761
+ }
2762
+ interface GraphViewProps {
2763
+ /** Graph nodes */
2764
+ nodes: GraphViewNode[];
2765
+ /** Graph edges */
2766
+ edges: GraphViewEdge[];
2767
+ /** Callback when a node is clicked */
2768
+ onNodeClick?: (node: GraphViewNode) => void;
2769
+ /** Callback when a node is hovered (null on leave) */
2770
+ onNodeHover?: (node: GraphViewNode | null) => void;
2771
+ /** Width in pixels */
2772
+ width?: number;
2773
+ /** Height in pixels */
2774
+ height?: number;
2775
+ /** Additional CSS classes */
2776
+ className?: string;
2777
+ /** Show node labels (default true) */
2778
+ showLabels?: boolean;
2779
+ /** Auto zoom-to-fit after layout settles (default true) */
2780
+ zoomToFit?: boolean;
2781
+ }
2782
+ declare const GraphView: React__default.FC<GraphViewProps>;
2783
+
2784
+ /**
2785
+ * DataGrid Molecule
2786
+ *
2787
+ * A simplified, schema-driven card grid for iterating over entity data.
2788
+ * Extracted from the CardGrid organism with all complexity removed:
2789
+ * no built-in search, sort, filter, pagination, selection, or bulk actions.
2790
+ *
2791
+ * Accepts `fields` config for per-field rendering control (icon, variant, format)
2792
+ * and `itemActions` for per-item event bus wiring.
2793
+ *
2794
+ * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
2795
+ */
2796
+
2797
+ interface DataGridField {
2798
+ /** Entity field name (dot-notation supported) */
2799
+ name: string;
2800
+ /** Display label (auto-generated from name if omitted) */
2801
+ label?: string;
2802
+ /** Lucide icon name to show beside the field */
2803
+ icon?: string;
2804
+ /** Rendering variant: 'h3' for title, 'body' for text, 'caption' for small,
2805
+ * 'badge' for status badge, 'progress' for progress display */
2806
+ variant?: 'h3' | 'h4' | 'body' | 'caption' | 'badge' | 'small' | 'progress';
2807
+ /** Optional format function name: 'date', 'currency', 'number', 'boolean' */
2808
+ format?: 'date' | 'currency' | 'number' | 'boolean' | 'percent';
2809
+ }
2810
+ interface DataGridItemAction {
2811
+ /** Button label */
2812
+ label: string;
2813
+ /** Event name to emit (dispatched as UI:{event} with { row: itemData }) */
2814
+ event: string;
2815
+ /** Lucide icon name */
2816
+ icon?: string;
2817
+ /** Button variant */
2818
+ variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
2819
+ }
2820
+ interface DataGridProps {
2821
+ /** Entity data array */
2822
+ entity?: unknown | readonly unknown[];
2823
+ /** Field definitions for rendering each card */
2824
+ fields?: readonly DataGridField[];
2825
+ /** Alias for fields (compiler generates `columns` for field definitions) */
2826
+ columns?: readonly DataGridField[];
2827
+ /** Per-item action buttons */
2828
+ itemActions?: readonly DataGridItemAction[];
2829
+ /** Number of columns (uses auto-fit if omitted) */
2830
+ cols?: 1 | 2 | 3 | 4 | 5 | 6;
2831
+ /** Gap between cards */
2832
+ gap?: 'none' | 'sm' | 'md' | 'lg' | 'xl';
2833
+ /** Minimum card width in pixels (used when cols is not set, default 280) */
2834
+ minCardWidth?: number;
2835
+ /** Additional CSS classes */
2836
+ className?: string;
2837
+ /** Loading state */
2838
+ isLoading?: boolean;
2839
+ /** Error state */
2840
+ error?: Error | null;
2841
+ /** Entity field name containing an image URL for card thumbnails */
2842
+ imageField?: string;
2843
+ }
2844
+ declare const DataGrid: React__default.FC<DataGridProps>;
2845
+
2846
+ /**
2847
+ * DataList Molecule
2848
+ *
2849
+ * A simplified, schema-driven list for iterating over entity data.
2850
+ * Extracted from the List organism with all complexity removed:
2851
+ * no built-in search, sort, filter, selection, bulk actions, or custom renderers.
2852
+ *
2853
+ * Accepts `fields` config for per-field rendering control (icon, variant, format)
2854
+ * and `itemActions` for per-item event bus wiring.
2855
+ *
2856
+ * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
2857
+ */
2858
+
2859
+ interface DataListField {
2860
+ /** Entity field name (dot-notation supported) */
2861
+ name: string;
2862
+ /** Display label (auto-generated from name if omitted) */
2863
+ label?: string;
2864
+ /** Lucide icon name to show beside the field */
2865
+ icon?: string;
2866
+ /** Rendering variant: 'h3'/'h4' for title, 'body' for text, 'caption' for small,
2867
+ * 'badge' for status badge, 'progress' for progress bar */
2868
+ variant?: 'h3' | 'h4' | 'body' | 'caption' | 'badge' | 'small' | 'progress';
2869
+ /** Optional format: 'date', 'currency', 'number', 'boolean', 'percent' */
2870
+ format?: 'date' | 'currency' | 'number' | 'boolean' | 'percent';
2871
+ }
2872
+ interface DataListItemAction {
2873
+ /** Button label */
2874
+ label: string;
2875
+ /** Event name to emit (dispatched as UI:{event} with { row: itemData }) */
2876
+ event: string;
2877
+ /** Lucide icon name */
2878
+ icon?: string;
2879
+ /** Button variant */
2880
+ variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
2881
+ }
2882
+ interface DataListProps {
2883
+ /** Entity data array */
2884
+ entity?: unknown | readonly unknown[];
2885
+ /** Field definitions for rendering each row */
2886
+ fields?: readonly DataListField[];
2887
+ /** Alias for fields (compiler may generate `columns` for field definitions) */
2888
+ columns?: readonly DataListField[];
2889
+ /** Per-item action buttons */
2890
+ itemActions?: readonly DataListItemAction[];
2891
+ /** Gap between rows */
2892
+ gap?: 'none' | 'sm' | 'md' | 'lg';
2893
+ /** Visual variant */
2894
+ variant?: 'default' | 'card' | 'compact';
2895
+ /** Additional CSS classes */
2896
+ className?: string;
2897
+ /** Loading state */
2898
+ isLoading?: boolean;
2899
+ /** Error state */
2900
+ error?: Error | null;
2901
+ }
2902
+ declare const DataList: React__default.FC<DataListProps>;
2903
+
2518
2904
  /**
2519
2905
  * Shared types for entity-display organisms.
2520
2906
  *
@@ -2582,6 +2968,10 @@ interface EntityDisplayProps<T = unknown> {
2582
2968
  interface Column<T> {
2583
2969
  key: keyof T | string;
2584
2970
  header: string;
2971
+ /** Alias for key (used by compiler-generated fields) */
2972
+ name?: string;
2973
+ /** Alias for header (used by compiler-generated fields) */
2974
+ label?: string;
2585
2975
  width?: string;
2586
2976
  sortable?: boolean;
2587
2977
  render?: (value: unknown, row: T, index: number) => React__default.ReactNode;
@@ -2598,7 +2988,7 @@ interface DataTableProps<T extends {
2598
2988
  id: string | number;
2599
2989
  }> extends EntityDisplayProps<T> {
2600
2990
  /** Fields to display - accepts string[] or Column[] for unified interface. Alias for columns */
2601
- fields?: readonly Column<T>[] | readonly string[];
2991
+ fields: readonly Column<T>[] | readonly string[];
2602
2992
  /** Columns can be Column objects or simple string field names */
2603
2993
  columns?: readonly Column<T>[] | readonly string[];
2604
2994
  /** Item actions from generated code - maps to rowActions */
@@ -2790,11 +3180,14 @@ interface DetailPanelAction {
2790
3180
  variant?: "primary" | "secondary" | "ghost" | "danger";
2791
3181
  }
2792
3182
  /**
2793
- * Field definition for unified interface - can be a simple string or object
3183
+ * Field definition for unified interface - can be a simple string, key/header object, or typed object
2794
3184
  */
2795
3185
  type FieldDef$2 = string | {
2796
3186
  key: string;
2797
3187
  header?: string;
3188
+ } | {
3189
+ name: string;
3190
+ type: string;
2798
3191
  };
2799
3192
  interface DetailPanelProps extends EntityDisplayProps {
2800
3193
  title?: string;
@@ -2810,7 +3203,7 @@ interface DetailPanelProps extends EntityDisplayProps {
2810
3203
  footer?: React__default.ReactNode;
2811
3204
  slideOver?: boolean;
2812
3205
  /** Fields to display - accepts string[], {key, header}[], or DetailField[] */
2813
- fields?: readonly (FieldDef$2 | DetailField)[];
3206
+ fields: readonly (FieldDef$2 | DetailField)[];
2814
3207
  /** Alias for fields - backwards compatibility */
2815
3208
  fieldNames?: readonly string[];
2816
3209
  /** Initial data for edit mode (passed by compiler) */
@@ -3002,11 +3395,11 @@ interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormEleme
3002
3395
  /** Additional CSS classes */
3003
3396
  className?: string;
3004
3397
  /** Entity type name or schema object. When OrbitalEntity, fields are auto-derived if not provided. */
3005
- entity?: string | OrbitalEntity;
3398
+ entity?: string | OrbitalEntity | readonly Record<string, unknown>[];
3006
3399
  /** Form mode - 'create' for new records, 'edit' for updating existing */
3007
3400
  mode?: "create" | "edit";
3008
3401
  /** Fields definition (schema format) - accepts readonly for generated const arrays */
3009
- fields?: readonly Readonly<SchemaField>[];
3402
+ fields: readonly Readonly<SchemaField>[];
3010
3403
  /** Initial form data */
3011
3404
  initialData?: Record<string, unknown> | unknown;
3012
3405
  /** Loading state */
@@ -3025,6 +3418,8 @@ interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormEleme
3025
3418
  submitEvent?: string;
3026
3419
  /** Event to dispatch on cancel (defaults to 'CANCEL') */
3027
3420
  cancelEvent?: string;
3421
+ /** Entity ID binding for edit mode (triggers initialData from selectedEntity in compiled code) */
3422
+ entityId?: string;
3028
3423
  /** Data for relation fields: { fieldName: RelationOption[] } */
3029
3424
  relationsData?: Record<string, readonly RelationOption[]>;
3030
3425
  /** Loading state for relation data: { fieldName: boolean } */
@@ -3516,11 +3911,13 @@ interface SchemaItemAction {
3516
3911
  onClick?: (row: unknown) => void;
3517
3912
  }
3518
3913
  /**
3519
- * Field definition - can be a simple string or object with key/header
3914
+ * Field definition - can be a simple string or object with key/header or name/label
3520
3915
  */
3521
3916
  type FieldDef$1 = string | {
3522
- key: string;
3917
+ key?: string;
3523
3918
  header?: string;
3919
+ name?: string;
3920
+ label?: string;
3524
3921
  };
3525
3922
  interface ListProps extends EntityDisplayProps {
3526
3923
  /** Entity type name for display */
@@ -3534,7 +3931,7 @@ interface ListProps extends EntityDisplayProps {
3534
3931
  renderItem?: (item: ListItem, index: number) => React__default.ReactNode;
3535
3932
  children?: React__default.ReactNode;
3536
3933
  /** Fields to display - accepts string[] or {key, header}[] for unified interface */
3537
- fields?: readonly FieldDef$1[];
3934
+ fields: readonly FieldDef$1[];
3538
3935
  /** Alias for fields - backwards compatibility */
3539
3936
  fieldNames?: readonly string[];
3540
3937
  }
@@ -3547,7 +3944,7 @@ declare const List: React__default.FC<ListProps>;
3547
3944
  * Uses CSS Grid auto-fit for automatic responsive columns.
3548
3945
  *
3549
3946
  * Data comes exclusively from the `entity` prop (injected by the runtime).
3550
- * All user interactions emit events via useEventBus never manages internal state
3947
+ * All user interactions emit events via useEventBus. Never manages internal state
3551
3948
  * for pagination, filtering, or search. All state is owned by the trait state machine.
3552
3949
  */
3553
3950
 
@@ -3572,11 +3969,13 @@ interface CardItemAction {
3572
3969
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | string;
3573
3970
  }
3574
3971
  /**
3575
- * Field definition - can be a simple string or object with key/header
3972
+ * Field definition - can be a simple string or object with key/header or name/label
3576
3973
  */
3577
3974
  type FieldDef = string | {
3578
- key: string;
3975
+ key?: string;
3579
3976
  header?: string;
3977
+ name?: string;
3978
+ label?: string;
3580
3979
  };
3581
3980
  interface CardGridProps extends EntityDisplayProps {
3582
3981
  /** Minimum width of each card (default: 280px) */
@@ -3589,8 +3988,8 @@ interface CardGridProps extends EntityDisplayProps {
3589
3988
  alignItems?: 'start' | 'center' | 'end' | 'stretch';
3590
3989
  /** Children elements (cards) - optional when using entity prop */
3591
3990
  children?: React__default.ReactNode;
3592
- /** Fields to display - accepts string[] or {key, header}[] for unified interface */
3593
- fields?: readonly FieldDef[];
3991
+ /** Fields to display - required for schema-driven rendering */
3992
+ fields: readonly FieldDef[];
3594
3993
  /** Alias for fields - backwards compatibility */
3595
3994
  fieldNames?: readonly string[];
3596
3995
  /** Alias for fields - backwards compatibility */
@@ -3603,13 +4002,15 @@ interface CardGridProps extends EntityDisplayProps {
3603
4002
  showAvatar?: boolean;
3604
4003
  /** Visual variant for the card grid */
3605
4004
  variant?: string;
4005
+ /** Entity field name containing an image URL to display as card thumbnail */
4006
+ imageField?: string;
3606
4007
  }
3607
4008
  /**
3608
4009
  * CardGrid - Responsive card collection layout
3609
4010
  *
3610
4011
  * Can be used in two ways:
3611
4012
  * 1. With children: <CardGrid><Card>...</Card></CardGrid>
3612
- * 2. With entity data: <CardGrid entity={tasks} fieldNames={['title']} />
4013
+ * 2. With entity data: <CardGrid entity={tasks} fields={['title', 'status']} />
3613
4014
  *
3614
4015
  * All data comes from the `entity` prop. Pagination display hints come from
3615
4016
  * `page`, `pageSize`, and `totalCount` props (set by the trait via render-ui).
@@ -3633,7 +4034,7 @@ interface MasterDetailProps<T extends {
3633
4034
  id: string | number;
3634
4035
  }> extends EntityDisplayProps<T> {
3635
4036
  /** Fields to show in the master list (maps to DataTable columns) */
3636
- masterFields?: readonly string[];
4037
+ masterFields: readonly string[];
3637
4038
  /** Fields for detail view (passed through but typically handled by separate render_ui) */
3638
4039
  detailFields?: readonly string[];
3639
4040
  /** Loading state (alias for isLoading) */
@@ -5732,9 +6133,7 @@ interface WorldMapEntity {
5732
6133
  * Emits: UI:FEATURE_ENTER
5733
6134
  * Emits: UI:TILE_CLICK
5734
6135
  */
5735
- interface WorldMapBoardProps extends Omit<EntityDisplayProps, 'entity'> {
5736
- /** World map entity data */
5737
- entity: WorldMapEntity;
6136
+ interface WorldMapBoardProps extends EntityDisplayProps<WorldMapEntity> {
5738
6137
  /** Canvas render scale */
5739
6138
  scale?: number;
5740
6139
  /** Unit draw-size multiplier */
@@ -5781,7 +6180,7 @@ interface WorldMapBoardProps extends Omit<EntityDisplayProps, 'entity'> {
5781
6180
  resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
5782
6181
  className?: string;
5783
6182
  }
5784
- 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;
6183
+ 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;
5785
6184
  declare namespace WorldMapBoard {
5786
6185
  var displayName: string;
5787
6186
  }
@@ -7382,6 +7781,22 @@ interface ToastSlotProps {
7382
7781
  */
7383
7782
  declare const ToastSlot: React__default.FC<ToastSlotProps>;
7384
7783
 
7784
+ /**
7785
+ * NotifyListener Component
7786
+ *
7787
+ * Listens for UI:NOTIFY events on the event bus and renders toast notifications.
7788
+ * Mount once at the app root level (inside EventBusProvider).
7789
+ *
7790
+ * The compiler transpiles `notify("message", severity)` effects into
7791
+ * `eventBus.emit('UI:NOTIFY', { message, severity })` calls.
7792
+ * This component picks those up and renders them as Toast overlays.
7793
+ */
7794
+
7795
+ declare function NotifyListener(): React__default.ReactElement | null;
7796
+ declare namespace NotifyListener {
7797
+ var displayName: string;
7798
+ }
7799
+
7385
7800
  /**
7386
7801
  * Chart Organism Component
7387
7802
  *
@@ -7543,7 +7958,7 @@ interface TimelineProps extends EntityDisplayProps<TimelineItem> {
7543
7958
  /** Timeline items */
7544
7959
  items?: readonly TimelineItem[];
7545
7960
  /** Fields to display */
7546
- fields?: readonly string[];
7961
+ fields: readonly string[];
7547
7962
  /** Actions per item */
7548
7963
  itemActions?: readonly TimelineAction[];
7549
7964
  }
@@ -7856,14 +8271,19 @@ declare const CodeViewer: React__default.FC<CodeViewerProps>;
7856
8271
  * All templates MUST extend `TemplateProps<E>` to enforce entity-only data flow
7857
8272
  * and JSON round-trip compatibility with the flattener pipeline.
7858
8273
  *
8274
+ * The compiler passes `entity` as `E[]` (array from data store), so
8275
+ * TemplateProps accepts the same union as EntityDisplayProps.
8276
+ *
7859
8277
  * @see docs/Almadar_Templates.md
7860
8278
  */
7861
8279
  /** Base props for all templates — enforces entity-only data flow. */
7862
8280
  interface TemplateProps<E extends {
7863
8281
  id: string;
8282
+ } = {
8283
+ id: string;
7864
8284
  }> {
7865
- /** Entity data — the sole source of runtime state */
7866
- entity: E;
8285
+ /** Entity data — single object, array from compiler, or string entity name */
8286
+ entity?: string | E | readonly E[];
7867
8287
  /** External styling override */
7868
8288
  className?: string;
7869
8289
  }
@@ -7871,7 +8291,7 @@ interface TemplateProps<E extends {
7871
8291
  interface NavItem {
7872
8292
  label: string;
7873
8293
  href: string;
7874
- icon: LucideIcon;
8294
+ icon?: LucideIcon;
7875
8295
  badge?: string | number;
7876
8296
  children?: NavItem[];
7877
8297
  }
@@ -8074,7 +8494,7 @@ interface BattleTemplateProps extends TemplateProps<BattleEntity> {
8074
8494
  /** Unit draw-size multiplier */
8075
8495
  unitScale?: number;
8076
8496
  }
8077
- declare function BattleTemplate({ entity, scale, unitScale, className, }: BattleTemplateProps): React__default.JSX.Element;
8497
+ declare function BattleTemplate({ entity, scale, unitScale, className, }: BattleTemplateProps): React__default.JSX.Element | null;
8078
8498
  declare namespace BattleTemplate {
8079
8499
  var displayName: string;
8080
8500
  }
@@ -8094,7 +8514,7 @@ interface CastleTemplateProps extends TemplateProps<CastleEntity> {
8094
8514
  /** Canvas render scale */
8095
8515
  scale?: number;
8096
8516
  }
8097
- declare function CastleTemplate({ entity, scale, className, }: CastleTemplateProps): React__default.JSX.Element;
8517
+ declare function CastleTemplate({ entity, scale, className, }: CastleTemplateProps): React__default.JSX.Element | null;
8098
8518
  declare namespace CastleTemplate {
8099
8519
  var displayName: string;
8100
8520
  }
@@ -8125,4 +8545,4 @@ declare namespace WorldMapTemplate {
8125
8545
  var displayName: string;
8126
8546
  }
8127
8547
 
8128
- export { ALL_PRESETS, AR_BOOK_FIELDS, Accordion, type AccordionItem, type AccordionProps, Card as ActionCard, type CardProps as ActionCardProps, ActionPalette, type ActionPaletteProps, ActionTile, type ActionTileProps, Alert, type AlertProps, type AlertVariant, type AnimationDef, type AnimationName, type AudioManifest, AuthLayout, type AuthLayoutProps, Avatar, type AvatarProps, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeVariant, BattleBoard, type BattleBoardProps, type BattleEntity, type BattlePhase, type BattleSlotContext, type BattleStateCallbacks, type BattleStateEventConfig, type BattleStateResult, BattleTemplate, type BattleTemplateProps, type BattleTile, type BattleUnit, type BoardTile, type BookChapter, BookChapterView, type BookChapterViewProps, BookCoverPage, type BookCoverPageProps, type BookData, type BookFieldMap, BookNavBar, type BookNavBarProps, type BookPart, BookTableOfContents, type BookTableOfContentsProps, BookViewer, type BookViewerProps, Box, type BoxBg, type BoxMargin, type BoxPadding, type BoxProps, type BoxRounded, type BoxShadow, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, BuilderBoard, type BuilderBoardProps, type BuilderComponent, type BuilderPuzzleEntity, type BuilderSlot, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, CameraState, CanvasEffect, type CanvasEffectProps, Card$1 as Card, type CardAction, CardBody, CardContent, CardFooter, CardGrid, type CardGridGap, type CardGridProps, CardHeader, type CardProps$1 as CardProps, CardTitle, CastleBoard, type CastleBoardProps, type CastleEntity, type CastleSlotContext, CastleTemplate, type CastleTemplateProps, Center, type CenterProps, Chart, type ChartDataPoint, type ChartProps, type ChartSeries, type ChartType, Checkbox, type CheckboxProps, ClassifierBoard, type ClassifierBoardProps, type ClassifierCategory, type ClassifierItem, type ClassifierPuzzleEntity, CodeBlock, type CodeBlockProps, CodeView, type CodeViewProps, CodeViewer, type CodeViewerMode, type CodeViewerProps, CollapsibleSection, type CollapsibleSectionProps, type Column, type CombatActionType, type CombatEffect, type CombatEvent, type CombatEventData, type CombatEventType, CombatLog, type CombatLogEventType, type CombatLogProps, type ConditionalContext, ConditionalWrapper, type ConditionalWrapperProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogVariant, Container, type ContainerProps, ContentRenderer, type ContentRendererProps, ControlButton, type ControlButtonProps, type CounterSize, CounterTemplate, type CounterTemplateProps, type CounterVariant, DIAMOND_TOP_Y, type DamageResult, DashboardGrid, type DashboardGridCell, type DashboardGridProps, DashboardLayout, type DashboardLayoutProps, DataTable, type DataTableProps, DebuggerBoard, type DebuggerBoardProps, type DebuggerLine, type DebuggerPuzzleEntity, type DetailField, DetailPanel, type DetailPanelProps, type DetailSection, DialogueBox, type DialogueBoxProps, type DialogueChoice, type DialogueNode, type DiffLine, Divider, type DividerOrientation, type DividerProps, type DocumentType, DocumentViewer, type DocumentViewerProps, StateMachineView as DomStateMachineVisualizer, Drawer, type DrawerPosition, type DrawerProps, type DrawerSize, DrawerSlot, type DrawerSlotProps, EditorCheckbox, type EditorCheckboxProps, type EditorMode, EditorSelect, type EditorSelectProps, EditorSlider, type EditorSliderProps, EditorTextInput, type EditorTextInputProps, EditorToolbar, type EditorToolbarProps, EmptyState, type EmptyStateProps, EntityDisplayEvents, type EntityDisplayProps, ErrorBoundary, type ErrorBoundaryProps, ErrorState, type ErrorStateProps, EventBusContextType, EventHandlerBoard, type EventHandlerBoardProps, type EventHandlerPuzzleEntity, EventLog, type EventLogEntry, type EventLogProps, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, type FacingDirection, type FilterDefinition, FilterGroup, type FilterGroupProps, type FilterPayload, Flex, type FlexProps, FloatingActionButton, type FloatingActionButtonProps, Form, FormActions, type FormActionsProps, FormField, type FormFieldProps, FormLayout, type FormLayoutProps, type FormProps, FormSection$1 as FormSection, FormSectionHeader, type FormSectionHeaderProps, type FormSectionProps, type FrameDimsResolver, type GameAction, GameAudioContext, type GameAudioContextValue, type GameAudioControls, GameAudioProvider, type GameAudioProviderProps, GameAudioToggle, type GameAudioToggleProps, GameHud, type GameHudElement, type GameHudProps, type GameHudStat, GameMenu, type GameMenuProps, type GameOverAction, GameOverScreen, type GameOverScreenProps, type GameOverStat, type GamePhase, GameShell, type GameShellProps, type GameState, GameTemplate, type GameTemplateProps, type GameUnit, GenericAppTemplate, type GenericAppTemplateProps, GraphCanvas, type GraphCanvasProps, type GraphEdge, type GraphNode, Grid, type GridProps, HStack, type HStackProps, Header, type HeaderProps, Heading, type HeadingProps, HealthBar, type HealthBarProps, type HighlightType, IDENTITY_BOOK_FIELDS, Icon, type IconAnimation, type IconProps, type IconSize, Input, InputGroup, type InputGroupProps, type InputProps, type InventoryItem, InventoryPanel, type InventoryPanelProps, IsometricCanvas, type IsometricCanvasProps, IsometricFeature, IsometricTile, IsometricUnit, JazariStateMachine, type JazariStateMachineProps, Label, type LabelProps, type LawReference, LawReferenceTooltip, type LawReferenceTooltipProps, List, type ListItem, type ListProps, LoadingState, type LoadingStateProps, type MapHero, type MapHex, MarkdownContent, type MarkdownContentProps, MasterDetail, type MasterDetailProps, type MeasurementPoint, MediaGallery, type MediaGalleryProps, type MediaItem, Menu, type MenuItem, type MenuOption, type MenuProps, Meter, type MeterProps, type MeterThreshold, type MeterVariant, Modal, type ModalProps, type ModalSize, ModalSlot, type ModalSlotProps, type NavItem, Navigation, type NavigationItem, type NavigationProps, type NegotiatorAction, NegotiatorBoard, type NegotiatorBoardProps, type NegotiatorPuzzleEntity, ObjectRulePanel, type ObjectRulePanelProps, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, type OrbitalVisualizationProps, Overlay, type OverlayProps, type PageBreadcrumb, PageHeader, type PageHeaderProps, type PaginatePayload, Pagination, type PaginationProps, type PayoffEntry, type Physics2DState, type PhysicsBody, type PhysicsBounds, type PhysicsConfig, type PhysicsConstraint, PhysicsManager, type PhysicsPreset, Popover, type PopoverProps, type Position, ProgressBar, type ProgressBarColor, type ProgressBarProps, type ProgressBarVariant, type PuzzleObjectDef, QuizBlock, type QuizBlockProps, Radio, type RadioProps, type RelationOption, RelationSelect, type RelationSelectProps, RepeatableFormSection, type RepeatableFormSectionProps, type RepeatableItem, type ResolvedFrame, type RowAction, type RuleDefinition, RuleEditor, type RuleEditorProps, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, type ScaledDiagramProps, ScoreDisplay, type ScoreDisplayProps, SearchInput, type SearchInputProps, type SearchPayload, Section, type SectionProps, Select, type SelectOption, type SelectPayload, type SelectProps, SequenceBar, type SequenceBarProps, SequencerBoard, type SequencerBoardProps, type SequencerPuzzleEntity, type SheetUrlResolver, SidePanel, type SidePanelProps, Sidebar, type SidebarItem, type SidebarProps, SignaturePad, type SignaturePadProps, SimpleGrid, type SimpleGridProps, SimulationCanvas, type SimulationCanvasProps, SimulationControls, type SimulationControlsProps, SimulationGraph, type SimulationGraphProps, SimulatorBoard, type SimulatorBoardProps, type SimulatorParameter, type SimulatorPuzzleEntity, Skeleton, type SkeletonProps, type SkeletonVariant, SlotContent, SlotContentRenderer, type SlotItemData, type SortDirection, type SortPayload, type SoundEntry, Spacer, type SpacerProps, type SpacerSize, Spinner, type SpinnerProps, Split, SplitPane, type SplitPaneProps, type SplitProps, Sprite, type SpriteDirection, type SpriteFrameDims, type SpriteProps, type SpriteSheetUrls, Stack, type StackAlign, type StackDirection, type StackGap, type StackJustify, type StackProps, StatCard, type StatCardProps, StateArchitectBoard, type StateArchitectBoardProps, type StateArchitectPuzzleEntity, type StateArchitectTransition, StateIndicator, type StateIndicatorProps, StateMachineView, type StateMachineViewProps, StateNode, type StateNodeProps, type StateStyle, StatusBar, type StatusBarProps, Switch, type SwitchProps, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, type TabDefinition, type TabItem, TabbedContainer, type TabbedContainerProps, Table, type TableColumn, type TableProps, Tabs, type TabsProps, type TemplateProps, TerrainPalette, type TerrainPaletteProps, type TestCase, Text, TextHighlight, type TextHighlightProps, type TextProps, Textarea, type TextareaProps, ThemeSelector, ThemeToggle, type ThemeToggleProps, Timeline, type TimelineItem, type TimelineItemStatus, type TimelineProps, Toast, type ToastProps, ToastSlot, type ToastSlotProps, type ToastVariant, Tooltip, type TooltipProps, TraitSlot, type TraitSlotProps, type TraitStateMachineDefinition, TraitStateViewer, type TraitStateViewerProps, type TraitTransition, TransitionArrow, type TransitionArrowProps, type TransitionBundle, Typography, type TypographyProps, type TypographyVariant, UISlot, UISlotComponent, UISlotRenderer, type UISlotRendererProps, UncontrolledBattleBoard, type UncontrolledBattleBoardProps, type UnitAnimationState, type UnitTrait, type UseGameAudioOptions, type UsePhysics2DOptions, type UsePhysics2DReturn, type UseSpriteAnimationsOptions, type UseSpriteAnimationsResult, VStack, type VStackProps, type VariableDef, VariablePanel, type VariablePanelProps, ViolationAlert, type ViolationAlertProps, type ViolationRecord, WizardContainer, type WizardContainerProps, WizardNavigation, type WizardNavigationProps, WizardProgress, type WizardProgressProps, type WizardProgressStep, type WizardStep, WorldMapBoard, type WorldMapBoardProps, type WorldMapEntity, type WorldMapSlotContext, WorldMapTemplate, type WorldMapTemplateProps, applyTemporaryEffect, calculateAttackTargets, calculateDamage, calculateValidMoves, combatAnimations, combatClasses, combatEffects, createInitialGameState, createUnitAnimationState, drawSprite, generateCombatMessage, getCurrentFrame, inferDirection, isoToScreen, mapBookData, pendulum, projectileMotion, resolveFieldMap, resolveFrame, resolveSheetDirection, screenToIso, springOscillator, tickAnimationState, transitionAnimation, useBattleState, useCamera, useGameAudio, useGameAudioContext, useImageCache, usePhysics2D, useSpriteAnimations };
8548
+ export { ALL_PRESETS, AR_BOOK_FIELDS, Accordion, type AccordionItem, type AccordionProps, Card as ActionCard, type CardProps as ActionCardProps, ActionPalette, type ActionPaletteProps, ActionTile, type ActionTileProps, Alert, type AlertProps, type AlertVariant, type AnimationDef, type AnimationName, type AudioManifest, AuthLayout, type AuthLayoutProps, Avatar, type AvatarProps, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeVariant, BattleBoard, type BattleBoardProps, type BattleEntity, type BattlePhase, type BattleSlotContext, type BattleStateCallbacks, type BattleStateEventConfig, type BattleStateResult, BattleTemplate, type BattleTemplateProps, type BattleTile, type BattleUnit, type BoardTile, type BookChapter, BookChapterView, type BookChapterViewProps, BookCoverPage, type BookCoverPageProps, type BookData, type BookFieldMap, BookNavBar, type BookNavBarProps, type BookPart, BookTableOfContents, type BookTableOfContentsProps, BookViewer, type BookViewerProps, Box, type BoxBg, type BoxMargin, type BoxPadding, type BoxProps, type BoxRounded, type BoxShadow, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, BuilderBoard, type BuilderBoardProps, type BuilderComponent, type BuilderPuzzleEntity, type BuilderSlot, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type CalendarEvent, CalendarGrid, type CalendarGridProps, CameraState, CanvasEffect, type CanvasEffectProps, Card$1 as Card, type CardAction, CardBody, CardContent, CardFooter, CardGrid, type CardGridGap, type CardGridProps, CardHeader, type CardProps$1 as CardProps, CardTitle, CastleBoard, type CastleBoardProps, type CastleEntity, type CastleSlotContext, CastleTemplate, type CastleTemplateProps, Center, type CenterProps, Chart, type ChartDataPoint$1 as ChartDataPoint, ChartLegend, type ChartLegendItem, type ChartLegendProps, type ChartProps, type ChartSeries, type ChartType, Checkbox, type CheckboxProps, ClassifierBoard, type ClassifierBoardProps, type ClassifierCategory, type ClassifierItem, type ClassifierPuzzleEntity, CodeBlock, type CodeBlockProps, CodeView, type CodeViewProps, CodeViewer, type CodeViewerMode, type CodeViewerProps, CollapsibleSection, type CollapsibleSectionProps, type Column, type CombatActionType, type CombatEffect, type CombatEvent, type CombatEventData, type CombatEventType, CombatLog, type CombatLogEventType, type CombatLogProps, type ConditionalContext, ConditionalWrapper, type ConditionalWrapperProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogVariant, Container, type ContainerProps, ContentRenderer, type ContentRendererProps, ControlButton, type ControlButtonProps, type CounterSize, CounterTemplate, type CounterTemplateProps, type CounterVariant, DIAMOND_TOP_Y, type DamageResult, DashboardGrid, type DashboardGridCell, type DashboardGridProps, DashboardLayout, type DashboardLayoutProps, DataGrid, type DataGridField, type DataGridItemAction, type DataGridProps, DataList, type DataListField, type DataListItemAction, type DataListProps, DataTable, type DataTableProps, DateRangeSelector, type DateRangeSelectorOption, type DateRangeSelectorProps, DayCell, type DayCellProps, DebuggerBoard, type DebuggerBoardProps, type DebuggerLine, type DebuggerPuzzleEntity, type DetailField, DetailPanel, type DetailPanelProps, type DetailSection, DialogueBox, type DialogueBoxProps, type DialogueChoice, type DialogueNode, type DiffLine, Divider, type DividerOrientation, type DividerProps, type DocumentType, DocumentViewer, type DocumentViewerProps, StateMachineView as DomStateMachineVisualizer, type DotSize, type DotState, Drawer, type DrawerPosition, type DrawerProps, type DrawerSize, DrawerSlot, type DrawerSlotProps, EditorCheckbox, type EditorCheckboxProps, type EditorMode, EditorSelect, type EditorSelectProps, EditorSlider, type EditorSliderProps, EditorTextInput, type EditorTextInputProps, EditorToolbar, type EditorToolbarProps, EmptyState, type EmptyStateProps, EntityDisplayEvents, type EntityDisplayProps, ErrorBoundary, type ErrorBoundaryProps, ErrorState, type ErrorStateProps, EventBusContextType, EventHandlerBoard, type EventHandlerBoardProps, type EventHandlerPuzzleEntity, EventLog, type EventLogEntry, type EventLogProps, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, type FacingDirection, type FilterDefinition, FilterGroup, type FilterGroupProps, type FilterPayload, Flex, type FlexProps, FlipCard, type FlipCardProps, FlipContainer, type FlipContainerProps, FloatingActionButton, type FloatingActionButtonProps, Form, FormActions, type FormActionsProps, FormField, type FormFieldProps, FormLayout, type FormLayoutProps, type FormProps, FormSection$1 as FormSection, FormSectionHeader, type FormSectionHeaderProps, type FormSectionProps, type FrameDimsResolver, type GameAction, GameAudioContext, type GameAudioContextValue, type GameAudioControls, GameAudioProvider, type GameAudioProviderProps, GameAudioToggle, type GameAudioToggleProps, GameHud, type GameHudElement, type GameHudProps, type GameHudStat, GameMenu, type GameMenuProps, type GameOverAction, GameOverScreen, type GameOverScreenProps, type GameOverStat, type GamePhase, GameShell, type GameShellProps, type GameState, GameTemplate, type GameTemplateProps, type GameUnit, GenericAppTemplate, type GenericAppTemplateProps, GraphCanvas, type GraphCanvasProps, type GraphEdge, type GraphNode, GraphView, type GraphViewEdge, type GraphViewNode, type GraphViewProps, Grid, type GridProps, HStack, type HStackProps, Header, type HeaderProps, Heading, type HeadingProps, HealthBar, type HealthBarProps, type HighlightType, IDENTITY_BOOK_FIELDS, Icon, type IconAnimation, type IconProps, type IconSize, Input, InputGroup, type InputGroupProps, type InputProps, type InventoryItem, InventoryPanel, type InventoryPanelProps, IsometricCanvas, type IsometricCanvasProps, IsometricFeature, IsometricTile, IsometricUnit, JazariStateMachine, type JazariStateMachineProps, Label, type LabelProps, type LawReference, LawReferenceTooltip, type LawReferenceTooltipProps, LineChart, type LineChartProps, List, type ListItem, type ListProps, LoadingState, type LoadingStateProps, type MapHero, type MapHex, MarkdownContent, type MarkdownContentProps, MasterDetail, type MasterDetailProps, type MeasurementPoint, MediaGallery, type MediaGalleryProps, type MediaItem, Menu, type MenuItem, type MenuOption, type MenuProps, Meter, type MeterProps, type MeterThreshold, type MeterVariant, Modal, type ModalProps, type ModalSize, ModalSlot, type ModalSlotProps, type NavItem, Navigation, type NavigationItem, type NavigationProps, type NegotiatorAction, NegotiatorBoard, type NegotiatorBoardProps, type NegotiatorPuzzleEntity, NotifyListener, ObjectRulePanel, type ObjectRulePanelProps, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, type OrbitalVisualizationProps, Overlay, type OverlayProps, type PageBreadcrumb, PageHeader, type PageHeaderProps, type PaginatePayload, Pagination, type PaginationProps, type PayoffEntry, type Physics2DState, type PhysicsBody, type PhysicsBounds, type PhysicsConfig, type PhysicsConstraint, PhysicsManager, type PhysicsPreset, Popover, type PopoverProps, type Position, ProgressBar, type ProgressBarColor, type ProgressBarProps, type ProgressBarVariant, ProgressDots, type ProgressDotsProps, type PuzzleObjectDef, QuizBlock, type QuizBlockProps, Radio, type RadioProps, type RelationOption, RelationSelect, type RelationSelectProps, RepeatableFormSection, type RepeatableFormSectionProps, type RepeatableItem, type ResolvedFrame, type RowAction, type RuleDefinition, RuleEditor, type RuleEditorProps, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, type ScaledDiagramProps, ScoreDisplay, type ScoreDisplayProps, SearchInput, type SearchInputProps, type SearchPayload, Section, type SectionProps, Select, type SelectOption, type SelectPayload, type SelectProps, SequenceBar, type SequenceBarProps, SequencerBoard, type SequencerBoardProps, type SequencerPuzzleEntity, type SheetUrlResolver, SidePanel, type SidePanelProps, Sidebar, type SidebarItem, type SidebarProps, SignaturePad, type SignaturePadProps, SimpleGrid, type SimpleGridProps, SimulationCanvas, type SimulationCanvasProps, SimulationControls, type SimulationControlsProps, SimulationGraph, type SimulationGraphProps, SimulatorBoard, type SimulatorBoardProps, type SimulatorParameter, type SimulatorPuzzleEntity, Skeleton, type SkeletonProps, type SkeletonVariant, SlotContent, SlotContentRenderer, type SlotItemData, type SortDirection, type SortPayload, type SoundEntry, Spacer, type SpacerProps, type SpacerSize, Spinner, type SpinnerProps, Split, SplitPane, type SplitPaneProps, type SplitProps, Sprite, type SpriteDirection, type SpriteFrameDims, type SpriteProps, type SpriteSheetUrls, Stack, type StackAlign, type StackDirection, type StackGap, type StackJustify, type StackProps, StatCard, type StatCardProps, StateArchitectBoard, type StateArchitectBoardProps, type StateArchitectPuzzleEntity, type StateArchitectTransition, StateIndicator, type StateIndicatorProps, StateMachineView, type StateMachineViewProps, StateNode, type StateNodeProps, type StateStyle, StatusBar, type StatusBarProps, Switch, type SwitchProps, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, type TabDefinition, type TabItem, TabbedContainer, type TabbedContainerProps, Table, type TableColumn, type TableProps, Tabs, type TabsProps, type TemplateProps, TerrainPalette, type TerrainPaletteProps, type TestCase, Text, TextHighlight, type TextHighlightProps, type TextProps, Textarea, type TextareaProps, ThemeSelector, ThemeToggle, type ThemeToggleProps, TimeSlotCell, type TimeSlotCellProps, Timeline, type TimelineItem, type TimelineItemStatus, type TimelineProps, Toast, type ToastProps, ToastSlot, type ToastSlotProps, type ToastVariant, Tooltip, type TooltipProps, TraitSlot, type TraitSlotProps, type TraitStateMachineDefinition, TraitStateViewer, type TraitStateViewerProps, type TraitTransition, TransitionArrow, type TransitionArrowProps, type TransitionBundle, Typography, type TypographyProps, type TypographyVariant, UISlot, UISlotComponent, UISlotRenderer, type UISlotRendererProps, UncontrolledBattleBoard, type UncontrolledBattleBoardProps, type UnitAnimationState, type UnitTrait, type UseGameAudioOptions, type UsePhysics2DOptions, type UsePhysics2DReturn, type UseSpriteAnimationsOptions, type UseSpriteAnimationsResult, VStack, type VStackProps, type VariableDef, VariablePanel, type VariablePanelProps, ViolationAlert, type ViolationAlertProps, type ViolationRecord, WizardContainer, type WizardContainerProps, WizardNavigation, type WizardNavigationProps, WizardProgress, type WizardProgressProps, type WizardProgressStep, type WizardStep, WorldMapBoard, type WorldMapBoardProps, type WorldMapEntity, type WorldMapSlotContext, WorldMapTemplate, type WorldMapTemplateProps, applyTemporaryEffect, calculateAttackTargets, calculateDamage, calculateValidMoves, combatAnimations, combatClasses, combatEffects, createInitialGameState, createUnitAnimationState, drawSprite, generateCombatMessage, getCurrentFrame, inferDirection, isoToScreen, mapBookData, pendulum, projectileMotion, resolveFieldMap, resolveFrame, resolveSheetDirection, screenToIso, springOscillator, tickAnimationState, transitionAnimation, useBattleState, useCamera, useGameAudio, useGameAudioContext, useImageCache, usePhysics2D, useSpriteAnimations };