@almadar/ui 6.51.2 → 6.53.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.
Files changed (127) hide show
  1. package/dist/{EntityBindingContext-BbxrwSb9.d.ts → AwaitingSkeletonContext-Bh399p1x.d.ts} +17 -2
  2. package/dist/{Canvas3DHost-CLC_jXh_.d.ts → Canvas3DHost-B-y2TNij.d.ts} +1 -1
  3. package/dist/{FileTree-RKQqRhIM.d.ts → FileTree-DUi7e7Z8.d.ts} +5 -5
  4. package/dist/{GameAudioProvider-BgWLggIy.d.ts → GameAudioProvider-DyBvYP2c.d.ts} +1 -1
  5. package/dist/{NavStackContext-B-XLULCO.d.ts → NavStackContext-04NLdXsY.d.ts} +8 -0
  6. package/dist/Typography-JGSDH4JP.js +5 -0
  7. package/dist/{UISlotContext-DNM8iXna.d.ts → UISlotContext-CS487Uoc.d.ts} +1 -1
  8. package/dist/{UISlotRenderer-7UYHFW4S.js → UISlotRenderer-JT34I3O7.js} +9 -9
  9. package/dist/avl/index.cjs +39958 -38525
  10. package/dist/avl/index.d.ts +8 -5
  11. package/dist/avl/index.js +37 -26
  12. package/dist/{chunk-JXUYEO7U.js → chunk-2LFBQ4IS.js} +7 -1
  13. package/dist/{chunk-GIPZSCND.js → chunk-3EF5SDIJ.js} +31157 -31206
  14. package/dist/{chunk-GHXWGQTX.js → chunk-4OZDHCZV.js} +1 -1
  15. package/dist/{chunk-HQDKHLFG.js → chunk-64WACXM7.js} +15 -1
  16. package/dist/{chunk-FGHRVJCI.js → chunk-6O37FCX4.js} +13 -2
  17. package/dist/{chunk-BUEIZY54.js → chunk-7LM6I3NA.js} +8 -7
  18. package/dist/chunk-CBIJP5PL.js +284 -0
  19. package/dist/{chunk-MWPX2O4M.js → chunk-GMDMOYXD.js} +3 -16
  20. package/dist/{chunk-YKHNK5JH.js → chunk-GODZKHAL.js} +11 -4
  21. package/dist/{chunk-T7IH5ABO.js → chunk-IKULQIDX.js} +199 -88
  22. package/dist/{chunk-NTO555KF.js → chunk-JRW33U35.js} +183 -62
  23. package/dist/{chunk-OLZ3EEML.js → chunk-KQXXO42S.js} +106 -90
  24. package/dist/chunk-OKWD7LPO.js +80 -0
  25. package/dist/{chunk-YHY5K2Y7.js → chunk-PEST66PN.js} +6 -0
  26. package/dist/{chunk-L55SAFKL.js → chunk-UGHAADU5.js} +77 -1
  27. package/dist/{chunk-6CFYRP4S.js → chunk-VHTJRS2N.js} +4 -8
  28. package/dist/{chunk-R4V7IZQP.js → chunk-WPNM2KC6.js} +2 -2
  29. package/dist/{cn-CO-0rolG.d.ts → cn-ClXGlIOY.d.ts} +2 -2
  30. package/dist/components/index.cjs +46084 -44766
  31. package/dist/components/index.d.ts +645 -699
  32. package/dist/components/index.js +621 -13
  33. package/dist/context/index.cjs +20 -7
  34. package/dist/context/index.d.ts +3 -3
  35. package/dist/context/index.js +3 -3
  36. package/dist/hooks/index.cjs +126 -9
  37. package/dist/hooks/index.d.ts +32 -7
  38. package/dist/hooks/index.js +7 -7
  39. package/dist/lib/drawable/three/index.cjs +79 -2
  40. package/dist/lib/drawable/three/index.d.ts +3 -3
  41. package/dist/lib/drawable/three/index.js +7 -7
  42. package/dist/lib/index.cjs +116 -2
  43. package/dist/lib/index.d.ts +29 -6
  44. package/dist/lib/index.js +6 -5
  45. package/dist/locales/index.cjs +231 -3
  46. package/dist/locales/index.js +155 -3
  47. package/dist/{paintDispatch-CMgOyVjS.d.ts → paintDispatch-_6EhJCiL.d.ts} +6 -6
  48. package/dist/providers/index.cjs +36404 -35028
  49. package/dist/providers/index.d.ts +34 -9
  50. package/dist/providers/index.js +82 -19
  51. package/dist/renderer/index.cjs +6 -0
  52. package/dist/renderer/index.d.ts +1 -1
  53. package/dist/renderer/index.js +1 -1
  54. package/dist/runtime/index.cjs +37861 -36437
  55. package/dist/runtime/index.d.ts +6 -4
  56. package/dist/runtime/index.js +11 -11
  57. package/dist/ssr/index.cjs +584 -181
  58. package/dist/ssr/index.d.cts +36 -44
  59. package/dist/ssr/index.d.ts +36 -44
  60. package/dist/ssr/index.js +527 -124
  61. package/dist/{themeTokens-CN9WCXQc.d.ts → themeTokens-Ccu7EmGY.d.ts} +4 -2
  62. package/dist/{useUISlots-CwUWM1ra.d.ts → useUISlots-1dk2TR4j.d.ts} +1 -9
  63. package/dist/{verificationRegistry-DBHfOR9y.d.ts → verificationRegistry-CD7Xb40L.d.ts} +1 -1
  64. package/locales/ar.json +77 -1
  65. package/locales/en.json +77 -1
  66. package/locales/sl.json +77 -1
  67. package/package.json +13 -10
  68. package/tailwind-preset.cjs +37 -1
  69. package/themes/_base.css +114 -8
  70. package/themes/_contract.md +6 -0
  71. package/themes/almadar-website.css +2 -0
  72. package/themes/almadar.css +2 -0
  73. package/themes/aqua.css +5 -3
  74. package/themes/arabesque.css +9 -7
  75. package/themes/art-deco.css +5 -3
  76. package/themes/art-nouveau.css +4 -0
  77. package/themes/atelier.css +10 -8
  78. package/themes/bauhaus.css +2 -0
  79. package/themes/bloomberg-dense.css +13 -11
  80. package/themes/blueprint.css +2 -0
  81. package/themes/clay.css +2 -0
  82. package/themes/comic.css +12 -10
  83. package/themes/constructivist.css +2 -0
  84. package/themes/corporate.css +4 -2
  85. package/themes/cyberpunk.css +2 -0
  86. package/themes/frutiger-aero.css +2 -0
  87. package/themes/game-adventure.css +1 -0
  88. package/themes/game-rpg.css +1 -0
  89. package/themes/game-sci-fi.css +1 -0
  90. package/themes/game-ui-pack.css +1 -0
  91. package/themes/gazette.css +10 -8
  92. package/themes/glass.css +17 -15
  93. package/themes/gothic.css +2 -0
  94. package/themes/ink-wash.css +2 -0
  95. package/themes/kawaii.css +2 -0
  96. package/themes/kiosk.css +17 -15
  97. package/themes/linear-clean.css +12 -10
  98. package/themes/luxury.css +2 -0
  99. package/themes/mac-classic.css +2 -0
  100. package/themes/material.css +2 -0
  101. package/themes/memphis.css +2 -0
  102. package/themes/mid-century.css +2 -0
  103. package/themes/minimalist.css +2 -0
  104. package/themes/mudcloth.css +2 -0
  105. package/themes/neon.css +2 -0
  106. package/themes/neumorphic.css +2 -0
  107. package/themes/newsprint.css +2 -0
  108. package/themes/notion-editorial.css +12 -10
  109. package/themes/pixel.css +2 -0
  110. package/themes/prism.css +20 -18
  111. package/themes/retro.css +2 -0
  112. package/themes/risograph.css +2 -0
  113. package/themes/scandi.css +2 -0
  114. package/themes/sketch.css +2 -0
  115. package/themes/solarpunk.css +2 -0
  116. package/themes/steampunk.css +2 -0
  117. package/themes/swiss.css +2 -0
  118. package/themes/terminal.css +8 -6
  119. package/themes/trait-wars.css +2 -0
  120. package/themes/ukiyo-e.css +2 -0
  121. package/themes/vaporwave.css +2 -0
  122. package/themes/victorian.css +2 -0
  123. package/themes/wabi-sabi.css +2 -0
  124. package/themes/win95.css +2 -0
  125. package/themes/wireframe.css +2 -0
  126. package/themes/zine.css +2 -0
  127. package/dist/Typography-2Z3JKWHN.js +0 -5
@@ -1,26 +1,26 @@
1
+ import { A11yProps, Asset, EventKey, EventPayload, EventEmit, AssetUrl, FieldValue, EntityRow, EntityRole, AnimationName, SpriteDirection, AnimationDef, ScenePos, Camera, SoundEntry, EntityWith, TraitConfigValue, SkeletonVariant, SkeletonSpec, SkeletonNode, SurfaceMode, EventListen, JsonValue, AssetCatalog, SExpr as SExpr$1, JsonObject, EventPayloadValue, DeclaredTraitConfig, TraitConfig, ControlValue, OrbitalSchema, Trait, TraceActivity, OrbitalEntity, FormSubmitPayload, UISlot, EnterAnimation, EditFocus, TraceSubagent, TraceChatMessage } from '@almadar/core';
2
+ export { AnimationDef, AnimationName, AudioManifest, BusEvent, BusEventListener, BusEventSource, BusEventListener as EventListener, SkeletonVariant, SoundEntry, SpriteDirection, UISlot, Unsubscribe } from '@almadar/core';
1
3
  import * as React$1 from 'react';
2
4
  import React__default, { ReactNode, ErrorInfo } from 'react';
3
- import { Asset, EventKey, EventPayload, EventEmit, AssetUrl, FieldValue, EntityRow, EntityRole, AnimationName, SpriteDirection, AnimationDef, ScenePos, Camera, SoundEntry, EntityWith, TraitConfigValue, EventListen, JsonValue, AssetCatalog, SExpr as SExpr$1, JsonObject, EventPayloadValue, DeclaredTraitConfig, TraitConfig, ControlValue, OrbitalSchema, Trait, OrbitalEntity, FormSubmitPayload, UISlot, EditFocus, TraceSubagent, TraceActivity, TraceChatMessage } from '@almadar/core';
4
- export { AnimationDef, AnimationName, AudioManifest, BusEvent, BusEventListener, BusEventSource, BusEventListener as EventListener, SoundEntry, SpriteDirection, UISlot, Unsubscribe } from '@almadar/core';
5
- import { I as IconInput, U as UiError, D as DrawableNode, P as Projector, F as FxOverlayItem, B as BadgeColor, M as MeshShapeKind, a as MeshMaterial, b as DrawGroupProps, c as DrawTextProps, d as DrawMeshProps, e as DisplayField, f as BadgeVariant, C as ColorToken, g as DisplayFieldFormat } from '../paintDispatch-CMgOyVjS.js';
6
- export { h as Badge, i as BadgeProps, j as FxOverlayKind, k as Icon, l as IconAnimation, m as IconProps, n as IconSize, o as ImageSource, L as LinkAction, p as Point, R as Rect } from '../paintDispatch-CMgOyVjS.js';
5
+ import { I as IconInput, U as UiError, D as DrawableNode, P as Projector, F as FxOverlayItem, B as BadgeColor, M as MeshShapeKind, a as MeshMaterial, b as DrawGroupProps, c as DrawTextProps, d as DrawMeshProps, e as DisplayField, f as BadgeVariant, C as ColorToken } from '../paintDispatch-_6EhJCiL.js';
6
+ export { g as Badge, h as BadgeProps, i as FxOverlayKind, j as Icon, k as IconAnimation, l as IconProps, m as IconSize, n as ImageSource, L as LinkAction, o as Point, R as Rect } from '../paintDispatch-_6EhJCiL.js';
7
7
  import { SExpr } from '@almadar/evaluator';
8
- import { U as UnitAnimationState, F as FacingDirection, S as SpriteSheetUrls, f as SpriteFrameDims, R as ResolvedFrame, g as CanvasLighting, h as CanvasPost, a as IsometricUnit, i as CameraState } from '../Canvas3DHost-CLC_jXh_.js';
9
- export { B as BoardTile, G as GameAction, j as GamePhase, k as GameState, l as GameUnit, b as IsometricFeature, I as IsometricTile, P as Position, m as UnitTrait, n as calculateAttackTargets, o as calculateValidMoves, p as createInitialGameState } from '../Canvas3DHost-CLC_jXh_.js';
10
- export { G as GameAudioContext, a as GameAudioContextValue, e as GameAudioControls, b as GameAudioProvider, c as GameAudioProviderProps, U as UseGameAudioOptions, f as useGameAudio, u as useGameAudioContext } from '../GameAudioProvider-BgWLggIy.js';
11
- import { c as AvlStateMachineProps } from '../FileTree-RKQqRhIM.js';
12
- export { B as BehaviorView, d as BehaviorViewProps, e as FileTree, F as FileTreeItem, f as FileTreeNode, g as FileTreeProps, M as ModuleCard, h as ModuleCardProps } from '../FileTree-RKQqRhIM.js';
8
+ import { U as UnitAnimationState, F as FacingDirection, S as SpriteSheetUrls, f as SpriteFrameDims, R as ResolvedFrame, g as CanvasLighting, h as CanvasPost, a as IsometricUnit, i as CameraState } from '../Canvas3DHost-B-y2TNij.js';
9
+ export { B as BoardTile, G as GameAction, j as GamePhase, k as GameState, l as GameUnit, b as IsometricFeature, I as IsometricTile, P as Position, m as UnitTrait, n as calculateAttackTargets, o as calculateValidMoves, p as createInitialGameState } from '../Canvas3DHost-B-y2TNij.js';
10
+ export { G as GameAudioContext, a as GameAudioContextValue, e as GameAudioControls, b as GameAudioProvider, c as GameAudioProviderProps, U as UseGameAudioOptions, f as useGameAudio, u as useGameAudioContext } from '../GameAudioProvider-DyBvYP2c.js';
11
+ import { c as AvlStateMachineProps } from '../FileTree-DUi7e7Z8.js';
12
+ export { B as BehaviorView, d as BehaviorViewProps, e as FileTree, F as FileTreeItem, f as FileTreeNode, g as FileTreeProps, M as ModuleCard, h as ModuleCardProps } from '../FileTree-DUi7e7Z8.js';
13
13
  import { LucideIcon } from 'lucide-react';
14
- import { c as EditorMotion, d as EditorOperator, C as ContentSegment, L as LessonSegment, l as InteractiveOrbitalType } from '../cn-CO-0rolG.js';
15
- export { B as BloomLevel, n as BloomQuizBlock, o as BloomQuizBlockProps, M as MixedSegment, g as cn, j as parseLessonSegments, q as parseMarkdownWithCodeBlocks } from '../cn-CO-0rolG.js';
14
+ import { c as EditorMotion, d as EditorOperator, C as ContentSegment, L as LessonSegment, l as InteractiveOrbitalType } from '../cn-ClXGlIOY.js';
15
+ export { B as BloomLevel, n as BloomQuizBlock, o as BloomQuizBlockProps, M as MixedSegment, g as cn, j as parseLessonSegments, q as parseMarkdownWithCodeBlocks } from '../cn-ClXGlIOY.js';
16
16
  import { LanguageCode } from '@almadar/core/i18n';
17
17
  import { EmojiPickPayload, ItemActionPayload, SelectionChangePayload } from '@almadar/core/patterns';
18
18
  import { T as TraitLevelData } from '../avl-schema-parser-C0wnAp5x.js';
19
- import { b as SlotContent, d as SlotPropValue } from '../useUISlots-CwUWM1ra.js';
20
- export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, c as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-CwUWM1ra.js';
21
- import '../verificationRegistry-DBHfOR9y.js';
22
- export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useFormatContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.js';
23
- export { E as EventBusContextType, a as NavStackApi, u as useNavStack } from '../NavStackContext-B-XLULCO.js';
19
+ import { a as SlotContent, c as SlotPropValue } from '../useUISlots-1dk2TR4j.js';
20
+ export { D as DEFAULT_SLOTS, S as SlotChangeCallback, b as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-1dk2TR4j.js';
21
+ import '../verificationRegistry-CD7Xb40L.js';
22
+ export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useFormatContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, usePrefersReducedMotion, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.js';
23
+ export { E as EventBusContextType, a as NavStackApi, u as useNavStack } from '../NavStackContext-04NLdXsY.js';
24
24
  export { E as EditorKeyEvent, a as KeyCaptureEntry, K as KeyCaptureTable, U as UseKeyboardRouterOptions, k as keyChord, m as mergeCaptureTables, u as useKeyboardRouter } from '../useKeyboardRouter-BW3rThep.js';
25
25
  export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-Czc2JAxo.js';
26
26
  import 'three';
@@ -30,7 +30,7 @@ import '@almadar/runtime';
30
30
  import '../format-Czimj421.js';
31
31
  import '@tanstack/react-query';
32
32
 
33
- interface SvgBranchProps {
33
+ interface SvgBranchProps extends A11yProps {
34
34
  x?: number;
35
35
  y?: number;
36
36
  variant?: 'fork' | 'merge' | 'diamond';
@@ -46,7 +46,7 @@ interface SvgBranchProps {
46
46
  }
47
47
  declare const SvgBranch: React__default.FC<SvgBranchProps>;
48
48
 
49
- interface SvgConnectionProps {
49
+ interface SvgConnectionProps extends A11yProps {
50
50
  x1?: number;
51
51
  y1?: number;
52
52
  x2?: number;
@@ -63,7 +63,7 @@ interface SvgConnectionProps {
63
63
  }
64
64
  declare const SvgConnection: React__default.FC<SvgConnectionProps>;
65
65
 
66
- interface SvgFlowProps {
66
+ interface SvgFlowProps extends A11yProps {
67
67
  points?: Array<[number, number]>;
68
68
  color?: string;
69
69
  strokeWidth?: number;
@@ -77,7 +77,7 @@ interface SvgFlowProps {
77
77
  }
78
78
  declare const SvgFlow: React__default.FC<SvgFlowProps>;
79
79
 
80
- interface SvgGridProps {
80
+ interface SvgGridProps extends A11yProps {
81
81
  x?: number;
82
82
  y?: number;
83
83
  cols?: number;
@@ -95,7 +95,7 @@ interface SvgGridProps {
95
95
  }
96
96
  declare const SvgGrid: React__default.FC<SvgGridProps>;
97
97
 
98
- interface SvgLobeProps {
98
+ interface SvgLobeProps extends A11yProps {
99
99
  cx?: number;
100
100
  cy?: number;
101
101
  rx?: number;
@@ -112,7 +112,7 @@ interface SvgLobeProps {
112
112
  }
113
113
  declare const SvgLobe: React__default.FC<SvgLobeProps>;
114
114
 
115
- interface SvgMeshProps {
115
+ interface SvgMeshProps extends A11yProps {
116
116
  cx?: number;
117
117
  cy?: number;
118
118
  nodes?: number;
@@ -128,7 +128,7 @@ interface SvgMeshProps {
128
128
  }
129
129
  declare const SvgMesh: React__default.FC<SvgMeshProps>;
130
130
 
131
- interface SvgMorphProps {
131
+ interface SvgMorphProps extends A11yProps {
132
132
  x?: number;
133
133
  y?: number;
134
134
  size?: number;
@@ -143,7 +143,7 @@ interface SvgMorphProps {
143
143
  }
144
144
  declare const SvgMorph: React__default.FC<SvgMorphProps>;
145
145
 
146
- interface SvgNodeProps {
146
+ interface SvgNodeProps extends A11yProps {
147
147
  x?: number;
148
148
  y?: number;
149
149
  r?: number;
@@ -159,7 +159,7 @@ interface SvgNodeProps {
159
159
  }
160
160
  declare const SvgNode: React__default.FC<SvgNodeProps>;
161
161
 
162
- interface SvgPulseProps {
162
+ interface SvgPulseProps extends A11yProps {
163
163
  cx?: number;
164
164
  cy?: number;
165
165
  rings?: number;
@@ -175,7 +175,7 @@ interface SvgPulseProps {
175
175
  }
176
176
  declare const SvgPulse: React__default.FC<SvgPulseProps>;
177
177
 
178
- interface SvgRingProps {
178
+ interface SvgRingProps extends A11yProps {
179
179
  cx?: number;
180
180
  cy?: number;
181
181
  r?: number;
@@ -192,7 +192,7 @@ interface SvgRingProps {
192
192
  }
193
193
  declare const SvgRing: React__default.FC<SvgRingProps>;
194
194
 
195
- interface SvgShieldProps {
195
+ interface SvgShieldProps extends A11yProps {
196
196
  x?: number;
197
197
  y?: number;
198
198
  size?: number;
@@ -207,7 +207,7 @@ interface SvgShieldProps {
207
207
  }
208
208
  declare const SvgShield: React__default.FC<SvgShieldProps>;
209
209
 
210
- interface SvgStackProps {
210
+ interface SvgStackProps extends A11yProps {
211
211
  x?: number;
212
212
  y?: number;
213
213
  layers?: number;
@@ -226,7 +226,8 @@ declare const SvgStack: React__default.FC<SvgStackProps>;
226
226
 
227
227
  type ButtonVariant = "primary" | "secondary" | "ghost" | "danger" | "success" | "warning" | "default" | "link";
228
228
  type ButtonSize = "sm" | "md" | "lg";
229
- interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
229
+ /** @accessibleName label */
230
+ interface ButtonProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, keyof A11yProps>, A11yProps {
230
231
  /** Additional CSS classes applied to the root element. */
231
232
  className?: string;
232
233
  variant?: ButtonVariant;
@@ -266,7 +267,8 @@ interface SelectOption$1 {
266
267
  value: string;
267
268
  label: string;
268
269
  }
269
- interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "onChange"> {
270
+ /** @accessibleName label */
271
+ interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "onChange" | Exclude<keyof A11yProps, "role" | "dir">>, Omit<A11yProps, "role" | "dir"> {
270
272
  /** Additional CSS classes applied to the root element. */
271
273
  className?: string;
272
274
  /** Placeholder text */
@@ -313,21 +315,24 @@ interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputEl
313
315
  }
314
316
  declare const Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>>;
315
317
 
316
- interface LabelProps extends React__default.LabelHTMLAttributes<HTMLLabelElement> {
318
+ interface LabelProps extends Omit<React__default.LabelHTMLAttributes<HTMLLabelElement>, keyof A11yProps>, A11yProps {
317
319
  /** Additional CSS classes applied to the root element. */
318
320
  className?: string;
319
321
  /** Label text content */
320
322
  text?: string;
321
323
  /** Associated input element ID */
322
324
  htmlFor?: string;
323
- /** Show required indicator */
325
+ /** Show required indicator (decorative; the field itself carries aria-required) */
324
326
  required?: boolean;
325
327
  }
326
328
  declare const Label: React__default.ForwardRefExoticComponent<LabelProps & React__default.RefAttributes<HTMLLabelElement>>;
327
329
 
328
- interface TextareaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange'> {
330
+ /** @accessibleName label */
331
+ interface TextareaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | keyof A11yProps>, A11yProps {
329
332
  /** Additional CSS classes applied to the root element. */
330
333
  className?: string;
334
+ /** Visible label naming the field. */
335
+ label?: string;
331
336
  /** Placeholder text */
332
337
  placeholder?: string;
333
338
  /** Number of visible rows */
@@ -336,6 +341,8 @@ interface TextareaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
336
341
  action?: EventEmit<{
337
342
  value: string;
338
343
  }>;
344
+ /** Helper text describing the field. */
345
+ helperText?: string;
339
346
  /** Error message */
340
347
  error?: string;
341
348
  /** onChange handler or declarative event key for trait dispatch */
@@ -360,9 +367,12 @@ interface SelectOptionGroup {
360
367
  label: string;
361
368
  options: SelectOption[];
362
369
  }
363
- interface SelectProps extends Omit<React__default.SelectHTMLAttributes<HTMLSelectElement>, "children" | "onChange" | "multiple"> {
370
+ /** @accessibleName label */
371
+ interface SelectProps extends Omit<React__default.SelectHTMLAttributes<HTMLSelectElement>, "children" | "onChange" | "multiple" | keyof A11yProps>, A11yProps {
364
372
  /** Additional CSS classes applied to the root element. */
365
373
  className?: string;
374
+ /** Visible label naming the control. */
375
+ label?: string;
366
376
  /** Select options (flat list) */
367
377
  options?: SelectOption[];
368
378
  /** Grouped options — rendered as <optgroup> in native mode, sections in rich mode. */
@@ -397,7 +407,8 @@ interface SelectProps extends Omit<React__default.SelectHTMLAttributes<HTMLSelec
397
407
  }
398
408
  declare const Select: React__default.ForwardRefExoticComponent<SelectProps & React__default.RefAttributes<HTMLSelectElement>>;
399
409
 
400
- interface CheckboxProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange"> {
410
+ /** @accessibleName label */
411
+ interface CheckboxProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange" | keyof A11yProps>, A11yProps {
401
412
  /** Additional CSS classes applied to the root element. */
402
413
  className?: string;
403
414
  /** Whether the checkbox is checked */
@@ -405,6 +416,8 @@ interface CheckboxProps extends Omit<React__default.InputHTMLAttributes<HTMLInpu
405
416
  /** Default checked state (uncontrolled) */
406
417
  defaultChecked?: boolean;
407
418
  label?: string;
419
+ /** Error message */
420
+ error?: string;
408
421
  /** onChange handler or declarative event key for trait dispatch */
409
422
  onChange?: React__default.ChangeEventHandler<HTMLInputElement> | EventEmit<{
410
423
  checked: boolean;
@@ -418,7 +431,7 @@ type CardShadow = "none" | "sm" | "md" | "lg";
418
431
  * `variant` (which conveys role / state).
419
432
  */
420
433
  type CardLook = "elevated" | "flat-bordered" | "borderless-divider" | "ticket" | "invoice" | "chip" | "tile-image-first";
421
- interface CardProps$1 extends React__default.HTMLAttributes<HTMLDivElement> {
434
+ interface CardProps$1 extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
422
435
  /** Additional CSS classes applied to the root element. */
423
436
  className?: string;
424
437
  variant?: "default" | "bordered" | "elevated" | "interactive";
@@ -472,7 +485,8 @@ interface AtlasImageAsset extends SpriteRef {
472
485
  name?: string;
473
486
  category?: string;
474
487
  }
475
- interface AtlasImageProps {
488
+ /** @accessibleName alt */
489
+ interface AtlasImageProps extends Omit<A11yProps, 'aria-hidden'> {
476
490
  asset?: AtlasImageAsset;
477
491
  /** Square pixel size (icon usage). Ignored when `fill`. */
478
492
  size?: number;
@@ -492,7 +506,7 @@ interface AtlasImageProps {
492
506
  * the sheet + atlas are loaded; `onReady` re-fires the caller when they land.
493
507
  */
494
508
  declare function useAtlasSliceDataUrl(asset: AtlasImageAsset | undefined): string | undefined;
495
- interface AtlasPanelProps {
509
+ interface AtlasPanelProps extends Omit<A11yProps, 'aria-hidden'> {
496
510
  asset?: AtlasImageAsset;
497
511
  /** Border thickness (source pixels) for the 9-slice cut. */
498
512
  borderSlice?: number;
@@ -510,7 +524,7 @@ interface AtlasPanelProps {
510
524
  * is cropped once to a dataURL; CSS border-image / background-repeat does the scaling. Falls back
511
525
  * to a plain container while the sheet/atlas load.
512
526
  */
513
- declare function AtlasPanel({ asset, borderSlice, borderWidth, mode, className, style, children, 'aria-hidden': ariaHidden }: AtlasPanelProps): React$1.JSX.Element;
527
+ declare function AtlasPanel({ asset, borderSlice, borderWidth, mode, className, style, children, 'aria-hidden': ariaHidden, ...rest }: AtlasPanelProps): React$1.JSX.Element;
514
528
  declare namespace AtlasPanel {
515
529
  var displayName: string;
516
530
  }
@@ -519,7 +533,7 @@ declare namespace AtlasPanel {
519
533
  * sub-rect of the packed sheet into a canvas (never the whole sheet); otherwise it renders the
520
534
  * plain `<img>` path. `fill` + `fit` cover background/panel usage (GameShell, card frames).
521
535
  */
522
- declare function AtlasImage({ asset, size, width, height, fill, fit, alt, className, style, 'aria-hidden': ariaHidden, }: AtlasImageProps): React$1.JSX.Element | null;
536
+ declare function AtlasImage({ asset, size, width, height, fill, fit, alt, className, style, 'aria-hidden': ariaHidden, ...rest }: AtlasImageProps): React$1.JSX.Element | null;
523
537
  declare namespace AtlasImage {
524
538
  var displayName: string;
525
539
  }
@@ -527,7 +541,8 @@ declare namespace AtlasImage {
527
541
  type ImageFit = 'cover' | 'contain' | 'fill' | 'none';
528
542
  type ImageAspect = 'auto' | '1/1' | '4/3' | '3/2' | '16/9' | '21/9';
529
543
  type ImageRounded = 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
530
- interface ImageProps {
544
+ /** @accessibleName alt */
545
+ interface ImageProps extends A11yProps {
531
546
  /** Image source URL */
532
547
  src: AssetUrl;
533
548
  /** Alternative text; empty string marks the image decorative */
@@ -547,7 +562,8 @@ interface ImageProps {
547
562
  }
548
563
  declare const Image: React__default.FC<ImageProps>;
549
564
 
550
- interface GameIconProps {
565
+ /** @accessibleName alt */
566
+ interface GameIconProps extends A11yProps {
551
567
  /** Asset — when url is present, renders an img (Asset-primary). */
552
568
  assetUrl?: Asset;
553
569
  /** Lucide component or kebab-case icon name (fallback when no assetUrl). */
@@ -559,14 +575,14 @@ interface GameIconProps {
559
575
  /** Additional CSS classes. */
560
576
  className?: string;
561
577
  }
562
- declare function GameIcon({ assetUrl, icon, size, alt, className }: GameIconProps): React$1.JSX.Element;
578
+ declare function GameIcon({ assetUrl, icon, size, alt, className, ...rest }: GameIconProps): React$1.JSX.Element;
563
579
  declare namespace GameIcon {
564
580
  var displayName: string;
565
581
  }
566
582
 
567
583
  type FilterPillVariant = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "info" | "neutral";
568
584
  type FilterPillSize = "sm" | "md" | "lg";
569
- interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, "onClick"> {
585
+ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, "onClick" | keyof A11yProps>, A11yProps {
570
586
  /** Additional CSS classes applied to the root element. */
571
587
  className?: string;
572
588
  variant?: FilterPillVariant;
@@ -595,7 +611,7 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
595
611
  declare const FilterPill: React__default.ForwardRefExoticComponent<FilterPillProps & React__default.RefAttributes<HTMLSpanElement>>;
596
612
 
597
613
  type SpinnerSize = "xs" | "sm" | "md" | "lg";
598
- interface SpinnerProps extends React__default.HTMLAttributes<HTMLDivElement> {
614
+ interface SpinnerProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
599
615
  /** Additional CSS classes applied to the root element. */
600
616
  className?: string;
601
617
  size?: SpinnerSize;
@@ -604,15 +620,10 @@ interface SpinnerProps extends React__default.HTMLAttributes<HTMLDivElement> {
604
620
  }
605
621
  declare const Spinner: React__default.ForwardRefExoticComponent<SpinnerProps & React__default.RefAttributes<HTMLDivElement>>;
606
622
 
607
- /**
608
- * Avatar Atom Component
609
- *
610
- * A versatile avatar component supporting images, initials, icons, and status indicators.
611
- */
612
-
613
623
  type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
614
624
  type AvatarStatus = "online" | "offline" | "away" | "busy";
615
- interface AvatarProps {
625
+ /** @accessibleName alt name */
626
+ interface AvatarProps extends A11yProps {
616
627
  /**
617
628
  * Image source URL
618
629
  */
@@ -678,13 +689,11 @@ type BoxMargin = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "auto";
678
689
  type BoxBg = "transparent" | "primary" | "secondary" | "muted" | "accent" | "surface" | "overlay";
679
690
  type BoxRounded = "none" | "sm" | "md" | "lg" | "xl" | "2xl" | "full";
680
691
  type BoxShadow = "none" | "sm" | "md" | "lg" | "xl";
681
- interface BoxProps extends React__default.HTMLAttributes<HTMLDivElement> {
692
+ interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
682
693
  /** Additional CSS classes applied to the root element. */
683
694
  className?: string;
684
695
  /** Data-theme attribute applied to the root element for CSS theme scoping (e.g. almadar-website-dark). */
685
696
  'data-theme'?: string;
686
- /** Text direction for this subtree: "ltr", "rtl" (Arabic/Hebrew content) or "auto" */
687
- dir?: string;
688
697
  /**
689
698
  * Padding on all sides
690
699
  * @example md
@@ -745,13 +754,7 @@ interface BoxProps extends React__default.HTMLAttributes<HTMLDivElement> {
745
754
  */
746
755
  declare const Box: React__default.ForwardRefExoticComponent<BoxProps & React__default.RefAttributes<HTMLDivElement>>;
747
756
 
748
- /**
749
- * Center Component
750
- *
751
- * A layout utility that centers its children horizontally and/or vertically.
752
- */
753
-
754
- interface CenterProps {
757
+ interface CenterProps extends A11yProps {
755
758
  /** Center inline (width fits content) vs block (full width) */
756
759
  inline?: boolean;
757
760
  /** Center only horizontally */
@@ -786,7 +789,7 @@ declare const Center: React__default.FC<CenterProps>;
786
789
 
787
790
  type DividerOrientation = "horizontal" | "vertical";
788
791
  type DividerVariant = "solid" | "dashed" | "dotted";
789
- interface DividerProps {
792
+ interface DividerProps extends A11yProps {
790
793
  /**
791
794
  * Orientation of the divider
792
795
  * @default 'horizontal'
@@ -817,7 +820,7 @@ declare const Divider: React__default.FC<DividerProps>;
817
820
  type ProgressBarType = "linear" | "circular" | "stepped";
818
821
  type ProgressBarVariant = "default" | "primary" | "success" | "warning" | "error" | "danger";
819
822
  type ProgressBarColor = ProgressBarVariant;
820
- interface ProgressBarProps {
823
+ interface ProgressBarProps extends A11yProps {
821
824
  /**
822
825
  * Progress value (0-100)
823
826
  */
@@ -838,8 +841,7 @@ interface ProgressBarProps {
838
841
  */
839
842
  variant?: ProgressBarVariant;
840
843
  /**
841
- * Color variant (alias for variant)
842
- * @default 'primary'
844
+ * Color variant (alias for variant; `variant` applies when omitted)
843
845
  */
844
846
  color?: ProgressBarColor;
845
847
  /**
@@ -878,7 +880,8 @@ declare const ProgressBar: React__default.FC<ProgressBarProps>;
878
880
  * A radio button component with label support and accessibility.
879
881
  */
880
882
 
881
- interface RadioProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
883
+ /** @accessibleName label */
884
+ interface RadioProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "size" | keyof A11yProps>, A11yProps {
882
885
  /** Additional CSS classes applied to the root element. */
883
886
  className?: string;
884
887
  /** Radio options (string array or SelectOption array) */
@@ -918,7 +921,7 @@ declare const Radio: React__default.ForwardRefExoticComponent<RadioProps & React
918
921
  */
919
922
 
920
923
  type SparklineColor = "auto" | "primary" | "success" | "warning" | "error" | "info" | "muted";
921
- interface SparklineProps {
924
+ interface SparklineProps extends A11yProps {
922
925
  /** Numeric series to plot. Length < 2 renders nothing. */
923
926
  data: readonly number[];
924
927
  /**
@@ -940,7 +943,8 @@ interface SparklineProps {
940
943
  }
941
944
  declare const Sparkline: React__default.FC<SparklineProps>;
942
945
 
943
- interface SwitchProps {
946
+ /** @accessibleName label */
947
+ interface SwitchProps extends A11yProps {
944
948
  checked?: boolean;
945
949
  defaultChecked?: boolean;
946
950
  onChange?: (checked: boolean) => void;
@@ -960,7 +964,7 @@ declare const Switch: React$1.ForwardRefExoticComponent<SwitchProps & React$1.Re
960
964
  */
961
965
 
962
966
  type SpacerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'auto';
963
- interface SpacerProps {
967
+ interface SpacerProps extends A11yProps {
964
968
  /** Fixed size (auto = flex grow) */
965
969
  size?: SpacerSize;
966
970
  /** Orientation (for fixed sizes) */
@@ -988,7 +992,7 @@ type StackDirection = "horizontal" | "vertical";
988
992
  type StackGap = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
989
993
  type StackAlign = "start" | "center" | "end" | "stretch" | "baseline";
990
994
  type StackJustify = "start" | "center" | "end" | "between" | "around" | "evenly";
991
- interface StackProps extends React__default.AriaAttributes {
995
+ interface StackProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
992
996
  /** Stack direction */
993
997
  direction?: StackDirection;
994
998
  /** Gap between children */
@@ -1015,12 +1019,8 @@ interface StackProps extends React__default.AriaAttributes {
1015
1019
  onClick?: (e: React__default.MouseEvent) => void;
1016
1020
  /** Keyboard handler */
1017
1021
  onKeyDown?: (e: React__default.KeyboardEvent) => void;
1018
- /** Role for accessibility */
1019
- role?: string;
1020
1022
  /** Element id */
1021
1023
  id?: string;
1022
- /** Tab index for focus management */
1023
- tabIndex?: number;
1024
1024
  /** Declarative event name — emits UI:{action} via eventBus on click */
1025
1025
  action?: EventKey;
1026
1026
  /** Payload to include with the action event
@@ -1057,7 +1057,7 @@ declare const HStack: React__default.FC<HStackProps>;
1057
1057
  */
1058
1058
 
1059
1059
  type HighlightType = "question" | "note";
1060
- interface TextHighlightProps {
1060
+ interface TextHighlightProps extends A11yProps {
1061
1061
  /**
1062
1062
  * Type of highlight (determines color)
1063
1063
  */
@@ -1115,7 +1115,7 @@ declare const TextHighlight: React__default.FC<TextHighlightProps>;
1115
1115
  type TypographyVariant = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "heading" | "subheading" | "body1" | "body2" | "body" | "caption" | "overline" | "small" | "large" | "label";
1116
1116
  /** `none` = no size override — the variant's baked size applies. */
1117
1117
  type TypographySize = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
1118
- interface TypographyProps extends React__default.AriaAttributes {
1118
+ interface TypographyProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
1119
1119
  /** Typography variant */
1120
1120
  variant?: TypographyVariant;
1121
1121
  /** Heading level (1-6) - alternative to variant for headings */
@@ -1140,8 +1140,6 @@ interface TypographyProps extends React__default.AriaAttributes {
1140
1140
  className?: string;
1141
1141
  /** Inline style */
1142
1142
  style?: React__default.CSSProperties;
1143
- /** Accessibility role */
1144
- role?: string;
1145
1143
  /**
1146
1144
  * Value formatting applied to string/number/Date content — `none` (the
1147
1145
  * default) renders content as-is. Covers the raw-ISO-date class: a bound
@@ -1164,7 +1162,7 @@ declare const Typography: React__default.FC<TypographyProps>;
1164
1162
  * @packageDocumentation
1165
1163
  */
1166
1164
 
1167
- interface ThemeToggleProps {
1165
+ interface ThemeToggleProps extends A11yProps {
1168
1166
  /** Additional CSS classes */
1169
1167
  className?: string;
1170
1168
  /** Size variant */
@@ -1189,13 +1187,7 @@ interface ThemeToggleProps {
1189
1187
  */
1190
1188
  declare const ThemeToggle: React__default.FC<ThemeToggleProps>;
1191
1189
 
1192
- /**
1193
- * Overlay Atom Component
1194
- *
1195
- * A fixed backdrop for modals and drawers.
1196
- */
1197
-
1198
- interface OverlayProps {
1190
+ interface OverlayProps extends A11yProps {
1199
1191
  isVisible?: boolean;
1200
1192
  onClick?: (e: React__default.MouseEvent) => void;
1201
1193
  className?: string;
@@ -1248,7 +1240,7 @@ interface PresenceResult {
1248
1240
  * (via `cn`) and `onAnimationEnd` onto the element that carries the animation.
1249
1241
  */
1250
1242
  declare function usePresence(show: boolean, opts: UsePresenceOptions): PresenceResult;
1251
- interface PresenceProps extends UsePresenceOptions {
1243
+ interface PresenceProps extends UsePresenceOptions, A11yProps {
1252
1244
  /** When false, the exit animation runs, then children unmount. */
1253
1245
  show: boolean;
1254
1246
  className?: string;
@@ -1267,7 +1259,7 @@ declare const Presence: React__default.FC<PresenceProps>;
1267
1259
  * need the flip mechanic around custom face content.
1268
1260
  */
1269
1261
 
1270
- interface FlipContainerProps {
1262
+ interface FlipContainerProps extends A11yProps {
1271
1263
  /** Whether the container is flipped (rotateY 180deg) */
1272
1264
  flipped: boolean;
1273
1265
  /** Optional className for the outer wrapper */
@@ -1278,7 +1270,7 @@ interface FlipContainerProps {
1278
1270
  onClick?: () => void;
1279
1271
  }
1280
1272
  declare const FlipContainer: {
1281
- ({ flipped, className, children, onClick, }: FlipContainerProps): React__default.JSX.Element;
1273
+ ({ flipped, className, children, onClick, ...rest }: FlipContainerProps): React__default.JSX.Element;
1282
1274
  displayName: string;
1283
1275
  };
1284
1276
 
@@ -1293,7 +1285,7 @@ declare const FlipContainer: {
1293
1285
  * for non-modal use cases.
1294
1286
  */
1295
1287
 
1296
- interface DialogProps extends React__default.DialogHTMLAttributes<HTMLDialogElement> {
1288
+ interface DialogProps extends Omit<React__default.DialogHTMLAttributes<HTMLDialogElement>, keyof A11yProps>, A11yProps {
1297
1289
  /** Additional CSS classes */
1298
1290
  className?: string;
1299
1291
  /** Dialog contents */
@@ -1315,7 +1307,7 @@ declare const Dialog: React__default.ForwardRefExoticComponent<DialogProps & Rea
1315
1307
  *
1316
1308
  * @capabilities settings navigation sidebar, preferences menu panel, account settings nav, secondary panel, side navigation rail
1317
1309
  */
1318
- interface AsideProps extends React__default.HTMLAttributes<HTMLElement> {
1310
+ interface AsideProps extends Omit<React__default.HTMLAttributes<HTMLElement>, keyof A11yProps>, A11yProps {
1319
1311
  /** Additional CSS classes */
1320
1312
  className?: string;
1321
1313
  /** Aside contents */
@@ -1413,7 +1405,7 @@ type LawReference = {
1413
1405
  /** Optional link to full law text */
1414
1406
  link?: string;
1415
1407
  };
1416
- interface LawReferenceTooltipProps {
1408
+ interface LawReferenceTooltipProps extends A11yProps {
1417
1409
  /** The law reference to display */
1418
1410
  reference: LawReference;
1419
1411
  /** Children element that triggers the tooltip */
@@ -1440,14 +1432,7 @@ interface LawReferenceTooltipProps {
1440
1432
  */
1441
1433
  declare const LawReferenceTooltip: React__default.FC<LawReferenceTooltipProps>;
1442
1434
 
1443
- /**
1444
- * DayCell
1445
- *
1446
- * Calendar day header atom. Renders day abbreviation and date number
1447
- * with optional today highlight.
1448
- */
1449
-
1450
- interface DayCellProps {
1435
+ interface DayCellProps extends A11yProps {
1451
1436
  /** The date this cell represents. Optional at the dynamic render edge: an
1452
1437
  * unbound `@config.date` arrives as `undefined`, so the cell falls back to today. */
1453
1438
  date?: Date;
@@ -1458,7 +1443,7 @@ interface DayCellProps {
1458
1443
  /** Additional CSS classes */
1459
1444
  className?: string;
1460
1445
  }
1461
- declare function DayCell({ date, isToday, onClick, className, }: DayCellProps): React__default.JSX.Element;
1446
+ declare function DayCell({ date, isToday, onClick, className, ...rest }: DayCellProps): React__default.JSX.Element;
1462
1447
  declare namespace DayCell {
1463
1448
  var displayName: string;
1464
1449
  }
@@ -1470,7 +1455,7 @@ declare namespace DayCell {
1470
1455
  * time slot that can hold event content via children.
1471
1456
  */
1472
1457
 
1473
- interface TimeSlotCellProps {
1458
+ interface TimeSlotCellProps extends A11yProps {
1474
1459
  /** Time label for this slot (e.g. "09:00") */
1475
1460
  time: string;
1476
1461
  /** Called when the slot is clicked */
@@ -1487,14 +1472,14 @@ interface TimeSlotCellProps {
1487
1472
  onPointerLeave?: React__default.PointerEventHandler<HTMLDivElement>;
1488
1473
  "data-testid"?: string;
1489
1474
  }
1490
- declare function TimeSlotCell({ time, onClick, className, children, isOccupied, onPointerDown, onPointerUp, onPointerCancel, onPointerLeave, "data-testid": testId, }: TimeSlotCellProps): React__default.JSX.Element;
1475
+ declare function TimeSlotCell({ time, onClick, className, children, isOccupied, onPointerDown, onPointerUp, onPointerCancel, onPointerLeave, "data-testid": testId, ...rest }: TimeSlotCellProps): React__default.JSX.Element;
1491
1476
  declare namespace TimeSlotCell {
1492
1477
  var displayName: string;
1493
1478
  }
1494
1479
 
1495
1480
  type StatusDotStatus = "online" | "offline" | "away" | "busy" | "warning" | "critical";
1496
1481
  type StatusDotSize = "sm" | "md" | "lg";
1497
- interface StatusDotProps extends React__default.HTMLAttributes<HTMLSpanElement> {
1482
+ interface StatusDotProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, keyof A11yProps>, A11yProps {
1498
1483
  /** Additional CSS classes applied to the root element. */
1499
1484
  className?: string;
1500
1485
  /** Status determines the dot color */
@@ -1510,7 +1495,7 @@ declare const StatusDot: React__default.ForwardRefExoticComponent<StatusDotProps
1510
1495
 
1511
1496
  type TrendDirection = "up" | "down" | "flat";
1512
1497
  type TrendIndicatorSize = "sm" | "md" | "lg";
1513
- interface TrendIndicatorProps extends React__default.HTMLAttributes<HTMLSpanElement> {
1498
+ interface TrendIndicatorProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, keyof A11yProps>, A11yProps {
1514
1499
  /** Additional CSS classes applied to the root element. */
1515
1500
  className?: string;
1516
1501
  /** Numeric value to display (e.g., 12.5 for +12.5%) */
@@ -1529,7 +1514,7 @@ interface TrendIndicatorProps extends React__default.HTMLAttributes<HTMLSpanElem
1529
1514
  declare const TrendIndicator: React__default.ForwardRefExoticComponent<TrendIndicatorProps & React__default.RefAttributes<HTMLSpanElement>>;
1530
1515
 
1531
1516
  type RangeSliderSize = "sm" | "md" | "lg";
1532
- interface RangeSliderProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange"> {
1517
+ interface RangeSliderProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange" | keyof A11yProps>, A11yProps {
1533
1518
  /** Additional CSS classes applied to the root element. */
1534
1519
  className?: string;
1535
1520
  /** Minimum value */
@@ -1565,15 +1550,7 @@ interface RangeSliderProps extends Omit<React__default.HTMLAttributes<HTMLDivEle
1565
1550
  }
1566
1551
  declare const RangeSlider: React__default.ForwardRefExoticComponent<RangeSliderProps & React__default.RefAttributes<HTMLDivElement>>;
1567
1552
 
1568
- /**
1569
- * InfiniteScrollSentinel Atom Component
1570
- *
1571
- * Invisible element placed at the end of a list. Uses IntersectionObserver
1572
- * via useInfiniteScroll to detect when the user scrolls near the bottom,
1573
- * then fires a load-more event through the event bus.
1574
- */
1575
-
1576
- interface InfiniteScrollSentinelProps {
1553
+ interface InfiniteScrollSentinelProps extends A11yProps {
1577
1554
  /** Event name to emit when load-more is triggered (emitted as UI:{loadMoreEvent}) */
1578
1555
  loadMoreEvent: EventKey;
1579
1556
  /** Optional payload to include with the load-more event
@@ -1591,15 +1568,7 @@ interface InfiniteScrollSentinelProps {
1591
1568
  }
1592
1569
  declare const InfiniteScrollSentinel: React__default.FC<InfiniteScrollSentinelProps>;
1593
1570
 
1594
- /**
1595
- * ConfettiEffect Atom Component
1596
- *
1597
- * Renders a brief particle burst animation when triggered.
1598
- * Uses CSS keyframe animations for each particle with random
1599
- * position, rotation, and velocity.
1600
- */
1601
-
1602
- interface ConfettiEffectProps {
1571
+ interface ConfettiEffectProps extends A11yProps {
1603
1572
  /** When this changes from false to true, a burst of particles is spawned */
1604
1573
  trigger: boolean;
1605
1574
  /** How long the animation lasts in milliseconds */
@@ -1618,7 +1587,7 @@ declare const ConfettiEffect: React__default.FC<ConfettiEffectProps>;
1618
1587
  * that disappears after the full text has been typed out.
1619
1588
  */
1620
1589
 
1621
- interface TypewriterTextProps {
1590
+ interface TypewriterTextProps extends A11yProps {
1622
1591
  /** The full text to reveal */
1623
1592
  text: string;
1624
1593
  /** Milliseconds per character */
@@ -1632,7 +1601,7 @@ interface TypewriterTextProps {
1632
1601
  }
1633
1602
  declare const TypewriterText: React__default.FC<TypewriterTextProps>;
1634
1603
 
1635
- interface SectionHeaderProps {
1604
+ interface SectionHeaderProps extends A11yProps {
1636
1605
  /** Section title text */
1637
1606
  title: string;
1638
1607
  /** Optional subtitle text */
@@ -1670,7 +1639,7 @@ declare const SectionHeader: React__default.FC<SectionHeaderProps>;
1670
1639
  */
1671
1640
 
1672
1641
  type PatternVariant = 'star8' | 'star6' | 'khatam' | 'star10' | 'star12' | 'rosette-double' | 'rosette-filled' | 'seigaiha' | 'greek-key' | 'celtic-knot' | 'kolam' | 'arch' | 'arabesque-vine' | 'arabesque-net';
1673
- interface PatternTileProps {
1642
+ interface PatternTileProps extends A11yProps {
1674
1643
  /** Which geometric pattern to render */
1675
1644
  variant?: PatternVariant;
1676
1645
  /** Tile unit size in SVG units */
@@ -1690,7 +1659,7 @@ declare function getTileDimensions(variant: PatternVariant, size: number): {
1690
1659
 
1691
1660
  type RevealTrigger = 'scroll' | 'hover' | 'manual';
1692
1661
  type RevealAnimation = 'fade-up' | 'fade-down' | 'fade-in' | 'fade-left' | 'fade-right' | 'scale' | 'scale-up' | 'none';
1693
- interface AnimatedRevealProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children'> {
1662
+ interface AnimatedRevealProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children' | keyof A11yProps>, A11yProps {
1694
1663
  /** Additional CSS classes applied to the root element. */
1695
1664
  className?: string;
1696
1665
  /** What triggers the animation */
@@ -1715,7 +1684,8 @@ interface AnimatedRevealProps extends Omit<React__default.HTMLAttributes<HTMLDiv
1715
1684
  declare const AnimatedReveal: React__default.ForwardRefExoticComponent<AnimatedRevealProps & React__default.RefAttributes<HTMLDivElement>>;
1716
1685
 
1717
1686
  type GraphicAnimation = 'draw' | 'fill' | 'pulse' | 'morph';
1718
- interface AnimatedGraphicProps extends React__default.HTMLAttributes<HTMLDivElement> {
1687
+ /** @accessibleName alt */
1688
+ interface AnimatedGraphicProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
1719
1689
  /** Additional CSS classes applied to the root element. */
1720
1690
  className?: string;
1721
1691
  /** URL to an SVG file. Fetched and inlined to enable stroke/fill animations. */
@@ -2030,7 +2000,7 @@ declare const SHEET_COLUMNS = 8;
2030
2000
  */
2031
2001
  declare const SPRITE_SHEET_LAYOUT: Partial<Record<AnimationName, AnimationDef>>;
2032
2002
 
2033
- interface HealthBarProps {
2003
+ interface HealthBarProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2034
2004
  /** Current value */
2035
2005
  current: number;
2036
2006
  /** Maximum value */
@@ -2056,12 +2026,12 @@ interface HealthBarProps {
2056
2026
  /** Sprite image tiled across the filled portion of bar/progress formats. Falls back to CSS color gradient. */
2057
2027
  fillAsset?: Asset;
2058
2028
  }
2059
- declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, frameAsset, fillAsset, }: HealthBarProps): React$1.JSX.Element;
2029
+ declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, frameAsset, fillAsset, ...rest }: HealthBarProps): React$1.JSX.Element;
2060
2030
  declare namespace HealthBar {
2061
2031
  var displayName: string;
2062
2032
  }
2063
2033
 
2064
- interface ScoreDisplayProps {
2034
+ interface ScoreDisplayProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2065
2035
  /** Sprite asset — takes precedence over icon when provided */
2066
2036
  assetUrl?: Asset;
2067
2037
  /** Current score value */
@@ -2079,12 +2049,12 @@ interface ScoreDisplayProps {
2079
2049
  /** Number formatting locale */
2080
2050
  locale?: string;
2081
2051
  }
2082
- declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale: localeProp, }: ScoreDisplayProps): React$1.JSX.Element;
2052
+ declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale: localeProp, ...rest }: ScoreDisplayProps): React$1.JSX.Element;
2083
2053
  declare namespace ScoreDisplay {
2084
2054
  var displayName: string;
2085
2055
  }
2086
2056
 
2087
- interface ControlButtonProps {
2057
+ interface ControlButtonProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2088
2058
  /** Sprite asset — takes precedence over icon when provided */
2089
2059
  assetUrl?: Asset;
2090
2060
  /** Button label text */
@@ -2112,12 +2082,12 @@ interface ControlButtonProps {
2112
2082
  /** Additional CSS classes */
2113
2083
  className?: string;
2114
2084
  }
2115
- declare function ControlButton({ assetUrl, label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, }: ControlButtonProps): React$1.JSX.Element;
2085
+ declare function ControlButton({ assetUrl, label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, ...rest }: ControlButtonProps): React$1.JSX.Element;
2116
2086
  declare namespace ControlButton {
2117
2087
  var displayName: string;
2118
2088
  }
2119
2089
 
2120
- interface TimerDisplayProps {
2090
+ interface TimerDisplayProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2121
2091
  /** Time in seconds */
2122
2092
  seconds: number;
2123
2093
  /** Whether the timer is running */
@@ -2133,12 +2103,12 @@ interface TimerDisplayProps {
2133
2103
  /** Icon asset rendered to the left of the time value. Falls back to no icon. */
2134
2104
  iconAsset?: Asset;
2135
2105
  }
2136
- declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, }: TimerDisplayProps): React$1.JSX.Element;
2106
+ declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, ...rest }: TimerDisplayProps): React$1.JSX.Element;
2137
2107
  declare namespace TimerDisplay {
2138
2108
  var displayName: string;
2139
2109
  }
2140
2110
 
2141
- interface DialogueBubbleProps {
2111
+ interface DialogueBubbleProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2142
2112
  /** Speaker name displayed at the top */
2143
2113
  speaker?: string;
2144
2114
  /** Dialogue text content */
@@ -2158,12 +2128,12 @@ interface DialogueBubbleProps {
2158
2128
  /** Additional CSS classes */
2159
2129
  className?: string;
2160
2130
  }
2161
- declare function DialogueBubble({ speaker: speakerProp, text: textProp, portrait, position, mood, revealedChars, className, }: DialogueBubbleProps): React$1.JSX.Element;
2131
+ declare function DialogueBubble({ speaker: speakerProp, text: textProp, portrait, position, mood, revealedChars, className, ...rest }: DialogueBubbleProps): React$1.JSX.Element;
2162
2132
  declare namespace DialogueBubble {
2163
2133
  var displayName: string;
2164
2134
  }
2165
2135
 
2166
- interface ChoiceButtonProps {
2136
+ interface ChoiceButtonProps extends A11yProps {
2167
2137
  /** Choice text content */
2168
2138
  text: string;
2169
2139
  /** Choice index number (displayed as prefix) */
@@ -2185,7 +2155,7 @@ interface ChoiceButtonProps {
2185
2155
  /** Additional CSS classes */
2186
2156
  className?: string;
2187
2157
  }
2188
- declare function ChoiceButton({ text: textProp, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, }: ChoiceButtonProps): React$1.JSX.Element;
2158
+ declare function ChoiceButton({ text: textProp, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, ...rest }: ChoiceButtonProps): React$1.JSX.Element;
2189
2159
  declare namespace ChoiceButton {
2190
2160
  var displayName: string;
2191
2161
  }
@@ -2199,7 +2169,7 @@ interface ControlGridButton {
2199
2169
  variant?: 'primary' | 'secondary' | 'ghost' | string;
2200
2170
  }
2201
2171
  type DPadDirection = 'up' | 'down' | 'left' | 'right';
2202
- interface ControlGridProps {
2172
+ interface ControlGridProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2203
2173
  kind: ControlGridKind;
2204
2174
  /** action buttons (kind="actions") */
2205
2175
  buttons?: ControlGridButton[];
@@ -2234,7 +2204,7 @@ interface ControlGridProps {
2234
2204
  visibility?: 'auto' | 'always';
2235
2205
  className?: string;
2236
2206
  }
2237
- declare function ControlGrid({ kind, buttons: buttonsProp, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionEvents, directionReleaseEvents, directionAssets, size, disabled, visibility, className, }: ControlGridProps): React$1.JSX.Element | null;
2207
+ declare function ControlGrid({ kind, buttons: buttonsProp, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionEvents, directionReleaseEvents, directionAssets, size, disabled, visibility, className, ...rest }: ControlGridProps): React$1.JSX.Element | null;
2238
2208
  declare namespace ControlGrid {
2239
2209
  var displayName: string;
2240
2210
  }
@@ -2245,7 +2215,7 @@ declare namespace ControlGrid {
2245
2215
  * with optional HealthBar (hearts/bar) or ScoreDisplay (animated number) and
2246
2216
  * a named label — purpose-built for HUD stat rows, not general status tags.
2247
2217
  */
2248
- interface StatBadgeProps {
2218
+ interface StatBadgeProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2249
2219
  /** Sprite asset — takes precedence over icon when provided */
2250
2220
  assetUrl?: Asset;
2251
2221
  /** Asset image (board ui/ PNG); takes precedence over the Lucide icon. */
@@ -2271,7 +2241,7 @@ interface StatBadgeProps {
2271
2241
  /** Additional CSS classes */
2272
2242
  className?: string;
2273
2243
  }
2274
- declare function StatBadge({ assetUrl, iconUrl, label, value, max, format, icon, size, variant, className, source: _source, field: _field, }: StatBadgeProps): React$1.JSX.Element;
2244
+ declare function StatBadge({ assetUrl, iconUrl, label, value, max, format, icon, size, variant, className, source: _source, field: _field, ...rest }: StatBadgeProps): React$1.JSX.Element;
2275
2245
  declare namespace StatBadge {
2276
2246
  var displayName: string;
2277
2247
  }
@@ -2301,7 +2271,7 @@ interface GameHudElement {
2301
2271
  /** Max value (for bars/hearts) */
2302
2272
  max?: number;
2303
2273
  }
2304
- interface GameHudProps {
2274
+ interface GameHudProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2305
2275
  /** Position of the HUD */
2306
2276
  position?: "top" | "bottom" | "corners" | string;
2307
2277
  /** Stats to display - accepts readonly for compatibility with generated const arrays */
@@ -2325,7 +2295,7 @@ interface GameHudProps {
2325
2295
  /** Whether to use a semi-transparent background */
2326
2296
  transparent?: boolean;
2327
2297
  }
2328
- declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, variant, className, transparent, }: GameHudProps): React$1.JSX.Element;
2298
+ declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, variant, className, transparent, ...rest }: GameHudProps): React$1.JSX.Element;
2329
2299
  declare namespace GameHud {
2330
2300
  var displayName: string;
2331
2301
  }
@@ -2346,7 +2316,7 @@ type MenuOption = EventPayload & {
2346
2316
  /** Sub-label or description */
2347
2317
  subLabel?: string;
2348
2318
  };
2349
- interface GameMenuProps {
2319
+ interface GameMenuProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2350
2320
  /** Menu title */
2351
2321
  title: string;
2352
2322
  /** Optional subtitle or version */
@@ -2364,7 +2334,7 @@ interface GameMenuProps {
2364
2334
  /** Additional CSS classes */
2365
2335
  className?: string;
2366
2336
  }
2367
- declare function GameMenu({ title: titleProp, subtitle, options, menuItems, onSelect, background, logo, className, }: GameMenuProps): React$1.JSX.Element;
2337
+ declare function GameMenu({ title: titleProp, subtitle, options, menuItems, onSelect, background, logo, className, ...rest }: GameMenuProps): React$1.JSX.Element;
2368
2338
  declare namespace GameMenu {
2369
2339
  var displayName: string;
2370
2340
  }
@@ -2387,7 +2357,7 @@ interface StateGraphTransition {
2387
2357
  event: string;
2388
2358
  guardHint?: string;
2389
2359
  }
2390
- interface StateGraphProps {
2360
+ interface StateGraphProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2391
2361
  /** All states in the machine (node labels). */
2392
2362
  states: string[];
2393
2363
  /** Player-built transitions rendered as arrows. */
@@ -2410,7 +2380,7 @@ interface StateGraphProps {
2410
2380
  }>;
2411
2381
  className?: string;
2412
2382
  }
2413
- declare function StateGraph({ states, transitions, currentState, selectedState, addingFrom, initialState, width, height, nodeClickEvent, className, }: StateGraphProps): React$1.JSX.Element;
2383
+ declare function StateGraph({ states, transitions, currentState, selectedState, addingFrom, initialState, width, height, nodeClickEvent, className, ...rest }: StateGraphProps): React$1.JSX.Element;
2414
2384
 
2415
2385
  /**
2416
2386
  * Canvas2D — the thin 2D draw-host (Drawable Canvas, P6 closing).
@@ -2473,7 +2443,9 @@ interface SidePlayer {
2473
2443
  animation?: string;
2474
2444
  frame?: number;
2475
2445
  }
2476
- interface Canvas2DProps {
2446
+ interface Canvas2DProps extends A11yProps {
2447
+ /** Text alternative for the scene, rendered as visually hidden text and linked by aria-describedby. */
2448
+ description?: string;
2477
2449
  /** Additional CSS classes */
2478
2450
  className?: string;
2479
2451
  /** Loading state indicator */
@@ -2565,7 +2537,7 @@ interface Canvas2DProps {
2565
2537
  * drawable registry context and the host paints them. */
2566
2538
  children?: React$1.ReactNode;
2567
2539
  }
2568
- declare function Canvas2D({ className, isLoading, error, projection, drawables, backgroundImage: backgroundImageRaw, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyMap, keyUpMap, editable, selectedId, onSelect, onMove, selectEvent, moveEvent, camera, scale, tileWidth, fit, showMinimap, followTarget, cameraPos, bgColor, children, }: Canvas2DProps): React$1.JSX.Element;
2540
+ declare function Canvas2D({ className, isLoading, error, projection, drawables, backgroundImage: backgroundImageRaw, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyMap, keyUpMap, editable, selectedId, onSelect, onMove, selectEvent, moveEvent, camera, scale, tileWidth, fit, showMinimap, followTarget, cameraPos, bgColor, children, description, ...rest }: Canvas2DProps): React$1.JSX.Element;
2569
2541
  declare namespace Canvas2D {
2570
2542
  var displayName: string;
2571
2543
  }
@@ -2598,7 +2570,7 @@ declare namespace Canvas2D {
2598
2570
 
2599
2571
  /** Painter selection. Same `drawables` for both; differ only in projection + rasterizer. */
2600
2572
  type CanvasMode = '2d' | '3d';
2601
- interface CanvasProps {
2573
+ interface CanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2602
2574
  /** Painter: 2D sprite/shape/text raster, or 3D mesh. Default '2d'. */
2603
2575
  mode?: CanvasMode;
2604
2576
  /** Neutral drawable descriptors — the `draw-*` children. Routed to the host's painter. */
@@ -2695,7 +2667,7 @@ interface CanvasProps {
2695
2667
  * Forwarded to the 2D host, which collects them via drawable registry context. */
2696
2668
  children?: React$1.ReactNode;
2697
2669
  }
2698
- declare function Canvas({ mode, drawables, camera, projection, className, isLoading, unitScale, showMinimap, fit, tileWidth, backgroundImage, backgroundColor, worldWidth, worldHeight, pixelsPerUnit, showGrid, shadows, showCoordinates, showTileInfo, fogOfWar, lighting, post, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, featureClickEvent, keyMap, keyUpMap, editable, selectedId, onSelect, onMove, selectEvent, moveEvent, children, }: CanvasProps): React$1.JSX.Element;
2670
+ declare function Canvas({ mode, drawables, camera, projection, className, isLoading, unitScale, showMinimap, fit, tileWidth, backgroundImage, backgroundColor, worldWidth, worldHeight, pixelsPerUnit, showGrid, shadows, showCoordinates, showTileInfo, fogOfWar, lighting, post, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, featureClickEvent, keyMap, keyUpMap, editable, selectedId, onSelect, onMove, selectEvent, moveEvent, children, ...rest }: CanvasProps): React$1.JSX.Element;
2699
2671
  declare namespace Canvas {
2700
2672
  var displayName: string;
2701
2673
  }
@@ -2729,7 +2701,7 @@ declare function useUnitSpriteAtlas(units: IsometricUnit[]): UseUnitSpriteAtlasR
2729
2701
  * @packageDocumentation
2730
2702
  */
2731
2703
 
2732
- interface GameAudioToggleProps {
2704
+ interface GameAudioToggleProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
2733
2705
  /** Button size */
2734
2706
  size?: 'sm' | 'md' | 'lg';
2735
2707
  /** Additional CSS classes */
@@ -2747,7 +2719,7 @@ interface GameAudioToggleProps {
2747
2719
  muted: boolean;
2748
2720
  }>;
2749
2721
  }
2750
- declare function GameAudioToggle({ size, className, onAsset, offAsset, toggleEvent, }: GameAudioToggleProps): React__default.JSX.Element;
2722
+ declare function GameAudioToggle({ size, className, onAsset, offAsset, toggleEvent, ...rest }: GameAudioToggleProps): React__default.JSX.Element;
2751
2723
  declare namespace GameAudioToggle {
2752
2724
  var displayName: string;
2753
2725
  }
@@ -2859,7 +2831,7 @@ type TraitStateMachineDefinition = {
2859
2831
  transitions: TraitTransition[];
2860
2832
  description?: string;
2861
2833
  };
2862
- interface TraitStateViewerProps {
2834
+ interface TraitStateViewerProps extends A11yProps {
2863
2835
  /** The trait / state machine to visualize */
2864
2836
  trait: TraitStateMachineDefinition;
2865
2837
  /** Display variant */
@@ -2879,7 +2851,7 @@ interface TraitStateViewerProps {
2879
2851
  /** Error state */
2880
2852
  error?: UiError | null;
2881
2853
  }
2882
- declare function TraitStateViewer({ trait, variant, size, showTransitions, onStateClick, stateStyles, className, }: TraitStateViewerProps): React__default.JSX.Element;
2854
+ declare function TraitStateViewer({ trait, variant, size, showTransitions, onStateClick, stateStyles, className, ...rest }: TraitStateViewerProps): React__default.JSX.Element;
2883
2855
  declare namespace TraitStateViewer {
2884
2856
  var displayName: string;
2885
2857
  }
@@ -2921,7 +2893,7 @@ type SlotItemData = {
2921
2893
  * Emits: UI:CLICK
2922
2894
  * Emits: UI:REMOVE
2923
2895
  */
2924
- interface TraitSlotProps {
2896
+ interface TraitSlotProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
2925
2897
  /** Slot index (1-based) */
2926
2898
  slotNumber: number;
2927
2899
  /** Currently equipped item, if any */
@@ -2977,7 +2949,7 @@ interface TraitSlotProps {
2977
2949
  itemId: string;
2978
2950
  }>;
2979
2951
  }
2980
- declare function TraitSlot({ slotNumber, equippedItem, locked, lockLabel, selected, size, showTooltip, categoryColors, tooltipFrameUrl, className, feedback, onItemDrop, draggable, onDragStart, onClick, onRemove, clickEvent, removeEvent, dropEvent, }: TraitSlotProps): React__default.JSX.Element;
2952
+ declare function TraitSlot({ slotNumber, equippedItem, locked, lockLabel, selected, size, showTooltip, categoryColors, tooltipFrameUrl, className, feedback, onItemDrop, draggable, onDragStart, onClick, onRemove, clickEvent, removeEvent, dropEvent, ...rest }: TraitSlotProps): React__default.JSX.Element;
2981
2953
  declare namespace TraitSlot {
2982
2954
  var displayName: string;
2983
2955
  }
@@ -3187,7 +3159,7 @@ interface DisplayStateProps {
3187
3159
  * @packageDocumentation
3188
3160
  */
3189
3161
 
3190
- interface ActionTileProps extends DisplayStateProps {
3162
+ interface ActionTileProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3191
3163
  /** The action data */
3192
3164
  action: SlotItemData;
3193
3165
  /** Size variant */
@@ -3200,7 +3172,7 @@ interface ActionTileProps extends DisplayStateProps {
3200
3172
  border: string;
3201
3173
  }>;
3202
3174
  }
3203
- declare function ActionTile({ action, size, disabled, categoryColors, className, }: ActionTileProps): React__default.JSX.Element;
3175
+ declare function ActionTile({ action, size, disabled, categoryColors, className, ...rest }: ActionTileProps): React__default.JSX.Element;
3204
3176
  declare namespace ActionTile {
3205
3177
  var displayName: string;
3206
3178
  }
@@ -3214,7 +3186,7 @@ declare namespace ActionTile {
3214
3186
  * @packageDocumentation
3215
3187
  */
3216
3188
 
3217
- interface ActionPaletteProps {
3189
+ interface ActionPaletteProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3218
3190
  /** Available actions */
3219
3191
  actions: SlotItemData[];
3220
3192
  /** IDs of actions that are already used (shown as disabled) */
@@ -3233,7 +3205,7 @@ interface ActionPaletteProps {
3233
3205
  /** Additional CSS classes */
3234
3206
  className?: string;
3235
3207
  }
3236
- declare function ActionPalette({ actions, usedActionIds, allowDuplicates, categoryColors, size, label, className, }: ActionPaletteProps): React__default.JSX.Element;
3208
+ declare function ActionPalette({ actions, usedActionIds, allowDuplicates, categoryColors, size, label, className, ...rest }: ActionPaletteProps): React__default.JSX.Element;
3237
3209
  declare namespace ActionPalette {
3238
3210
  var displayName: string;
3239
3211
  }
@@ -3248,7 +3220,7 @@ declare namespace ActionPalette {
3248
3220
  * @packageDocumentation
3249
3221
  */
3250
3222
 
3251
- interface SequenceBarProps {
3223
+ interface SequenceBarProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3252
3224
  /** The current sequence (sparse — undefined means empty slot) */
3253
3225
  slots: Array<SlotItemData | undefined>;
3254
3226
  /** Max number of slots */
@@ -3282,7 +3254,7 @@ interface SequenceBarProps {
3282
3254
  /** Additional CSS classes */
3283
3255
  className?: string;
3284
3256
  }
3285
- declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, slotDropEvent, slotRemoveEvent, playing, currentStep, categoryColors, slotFeedback, size, className, }: SequenceBarProps): React__default.JSX.Element;
3257
+ declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, slotDropEvent, slotRemoveEvent, playing, currentStep, categoryColors, slotFeedback, size, className, ...rest }: SequenceBarProps): React__default.JSX.Element;
3286
3258
  declare namespace SequenceBar {
3287
3259
  var displayName: string;
3288
3260
  }
@@ -3348,7 +3320,7 @@ interface StateJsonTransition {
3348
3320
  * invented vocabulary against the orbital's event set. */
3349
3321
  event: string;
3350
3322
  }
3351
- interface StateJsonViewProps {
3323
+ interface StateJsonViewProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3352
3324
  /** Machine name */
3353
3325
  name: string;
3354
3326
  /** Initial state */
@@ -3364,7 +3336,7 @@ interface StateJsonViewProps {
3364
3336
  /** Additional CSS classes */
3365
3337
  className?: string;
3366
3338
  }
3367
- declare function StateJsonView({ name, initialState, states, transitions, label, defaultExpanded, className, }: StateJsonViewProps): React__default.JSX.Element;
3339
+ declare function StateJsonView({ name, initialState, states, transitions, label, defaultExpanded, className, ...rest }: StateJsonViewProps): React__default.JSX.Element;
3368
3340
  declare namespace StateJsonView {
3369
3341
  var displayName: string;
3370
3342
  }
@@ -3430,7 +3402,7 @@ declare const ALL_PRESETS: PhysicsPreset[];
3430
3402
  * layout out — no descriptor resolution, no runtime logic.
3431
3403
  */
3432
3404
 
3433
- interface GameShellProps {
3405
+ interface GameShellProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3434
3406
  /** Application / game title shown as a floating chip */
3435
3407
  appName?: string;
3436
3408
  /** Stat chips row — floats along the top edge. Legacy chrome surface: new behaviors emit HUD chrome via `render-ui "hud-top"` instead. */
@@ -3560,7 +3532,7 @@ interface LearningTracePanel {
3560
3532
  /** Panel fill opacity (default 0.85). */
3561
3533
  backgroundOpacity?: number;
3562
3534
  }
3563
- interface LearningCanvasProps {
3535
+ interface LearningCanvasProps extends A11yProps {
3564
3536
  /** Additional CSS classes. */
3565
3537
  className?: string;
3566
3538
  /** Canvas width in CSS pixels. */
@@ -3609,6 +3581,8 @@ interface LearningCanvasProps {
3609
3581
  type?: string;
3610
3582
  index: number;
3611
3583
  }) => void;
3584
+ /** Text alternative for the canvas, rendered as visually hidden text and linked by aria-describedby. */
3585
+ description?: string;
3612
3586
  /** Loading state. */
3613
3587
  isLoading?: boolean;
3614
3588
  /** Error state. */
@@ -3703,7 +3677,7 @@ declare const NodeSlotEditor: React__default.FC<NodeSlotEditorProps>;
3703
3677
  * **Atomic Design**: Composed using Label and Typography atoms.
3704
3678
  */
3705
3679
 
3706
- interface FormFieldProps {
3680
+ interface FormFieldProps extends A11yProps {
3707
3681
  label: string;
3708
3682
  required?: boolean;
3709
3683
  error?: string;
@@ -3731,7 +3705,7 @@ interface EmptyStateSlotProps {
3731
3705
  emptyAction?: EmptyStateAction;
3732
3706
  }
3733
3707
  type EmptyStateLook = "illustrated" | "icon-only" | "text-only" | "mascot";
3734
- interface EmptyStateProps {
3708
+ interface EmptyStateProps extends A11yProps {
3735
3709
  /**
3736
3710
  * Icon to display. Accepts either:
3737
3711
  * - A Lucide icon component (LucideIcon)
@@ -3757,7 +3731,7 @@ interface EmptyStateProps {
3757
3731
  }
3758
3732
  declare const EmptyState: React__default.FC<EmptyStateProps>;
3759
3733
 
3760
- interface LoadingStateProps {
3734
+ interface LoadingStateProps extends A11yProps {
3761
3735
  title?: string;
3762
3736
  message?: string;
3763
3737
  className?: string;
@@ -3766,7 +3740,7 @@ interface LoadingStateProps {
3766
3740
  }
3767
3741
  declare const LoadingState: React__default.FC<LoadingStateProps>;
3768
3742
 
3769
- interface ErrorStateProps {
3743
+ interface ErrorStateProps extends A11yProps {
3770
3744
  title?: string;
3771
3745
  /** Error message to display */
3772
3746
  message?: string;
@@ -3779,13 +3753,14 @@ interface ErrorStateProps {
3779
3753
  }
3780
3754
  declare const ErrorState: React__default.FC<ErrorStateProps>;
3781
3755
 
3782
- type SkeletonVariant = 'header' | 'table' | 'form' | 'card' | 'text';
3783
- interface SkeletonProps {
3756
+ interface SkeletonProps extends A11yProps {
3784
3757
  /** The skeleton variant to render */
3785
3758
  variant?: SkeletonVariant;
3786
- /** Number of rows for table/text variants */
3759
+ /** A declared `skeleton` prop value (shape name, sized shape or `none`); overrides variant/rows/columns/fields */
3760
+ spec?: SkeletonSpec;
3761
+ /** Rows for table/list/text, cards for grid, field pairs for detail */
3787
3762
  rows?: number;
3788
- /** Number of columns for table variant */
3763
+ /** Columns for table, tiles for stats */
3789
3764
  columns?: number;
3790
3765
  /** Number of fields for form variant */
3791
3766
  fields?: number;
@@ -3793,10 +3768,8 @@ interface SkeletonProps {
3793
3768
  className?: string;
3794
3769
  }
3795
3770
  /**
3796
- * Skeleton — loading placeholder with 5 variants for Suspense fallbacks.
3797
- *
3798
- * Variants: `header`, `table`, `form`, `card`, `text`.
3799
- * Used as fallback content inside `<Suspense>` boundaries.
3771
+ * Skeleton — the loading placeholder. A loading state renders the variant shaped
3772
+ * like the content it gives way to; announced as a busy status region.
3800
3773
  *
3801
3774
  * @example
3802
3775
  * ```tsx
@@ -3809,10 +3782,18 @@ interface SkeletonProps {
3809
3782
  * </Suspense>
3810
3783
  * ```
3811
3784
  */
3812
- declare function Skeleton({ variant, rows, columns, fields, className, }: SkeletonProps): React__default.ReactElement;
3785
+ declare function Skeleton({ variant, spec, rows, columns, fields, className, ...rest }: SkeletonProps): React__default.ReactElement | null;
3813
3786
  declare namespace Skeleton {
3814
3787
  var displayName: string;
3815
3788
  }
3789
+ /**
3790
+ * A predicted skeleton (what a server-backed trait will render while it awaits
3791
+ * its round trip), drawn as one busy status region.
3792
+ */
3793
+ declare function SkeletonTree({ node, className }: {
3794
+ node: SkeletonNode;
3795
+ className?: string;
3796
+ }): React__default.ReactElement;
3816
3797
 
3817
3798
  /**
3818
3799
  * Accordion Molecule Component
@@ -3847,7 +3828,7 @@ interface AccordionItem {
3847
3828
  */
3848
3829
  defaultOpen?: boolean;
3849
3830
  }
3850
- interface AccordionProps {
3831
+ interface AccordionProps extends A11yProps {
3851
3832
  /**
3852
3833
  * Accordion items
3853
3834
  */
@@ -3873,6 +3854,8 @@ interface AccordionProps {
3873
3854
  * Callback when item opens/closes
3874
3855
  */
3875
3856
  onItemToggle?: (itemId: string, isOpen: boolean) => void;
3857
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
3858
+ surface?: SurfaceMode;
3876
3859
  /**
3877
3860
  * Additional CSS classes
3878
3861
  */
@@ -3893,7 +3876,7 @@ declare const Accordion: React__default.FC<AccordionProps>;
3893
3876
  */
3894
3877
 
3895
3878
  type AlertVariant = "info" | "success" | "warning" | "error";
3896
- interface AlertProps {
3879
+ interface AlertProps extends A11yProps {
3897
3880
  /** Alert content (children or message) */
3898
3881
  children?: React__default.ReactNode;
3899
3882
  /** Alert message (alias for children) */
@@ -3947,7 +3930,7 @@ interface BreadcrumbItem {
3947
3930
  /** Event name to emit when clicked (for trait state machine integration) */
3948
3931
  event?: EventKey;
3949
3932
  }
3950
- interface BreadcrumbProps {
3933
+ interface BreadcrumbProps extends A11yProps {
3951
3934
  /**
3952
3935
  * Breadcrumb items. Omit together with `fromNavStack` to render the
3953
3936
  * orbital-scoped navigation stack instead of an authored trail.
@@ -4028,7 +4011,7 @@ interface FilterDefinition {
4028
4011
  *
4029
4012
  * @capabilities search refinement panel, facet filters, admin list filters, records filter sidebar, filter chips panel
4030
4013
  */
4031
- interface FilterGroupProps {
4014
+ interface FilterGroupProps extends A11yProps {
4032
4015
  /** Entity name to filter */
4033
4016
  entity: string;
4034
4017
  /** Filter definitions from schema */
@@ -4092,7 +4075,7 @@ interface ActionButton {
4092
4075
  /** Button variant - matches Button component variants. Accepts string for schema compatibility. */
4093
4076
  variant?: string;
4094
4077
  }
4095
- interface ButtonGroupProps {
4078
+ interface ButtonGroupProps extends A11yProps {
4096
4079
  /**
4097
4080
  * Button group content (Button components) - use this OR primary/secondary
4098
4081
  */
@@ -4176,7 +4159,7 @@ interface CommandPaletteCommand {
4176
4159
  * @payloadFor action */
4177
4160
  actionPayload?: EventPayload;
4178
4161
  }
4179
- interface CommandPaletteProps {
4162
+ interface CommandPaletteProps extends A11yProps {
4180
4163
  /** Whether the palette overlay is open */
4181
4164
  open: boolean;
4182
4165
  /** Called to open/close the overlay (Escape, overlay click, or a selection) */
@@ -4269,7 +4252,7 @@ declare namespace Card {
4269
4252
 
4270
4253
  type ContainerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
4271
4254
  type ContainerPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
4272
- interface ContainerProps {
4255
+ interface ContainerProps extends A11yProps {
4273
4256
  /** Maximum width */
4274
4257
  size?: ContainerSize;
4275
4258
  /** Alias for size (pattern compatibility) */
@@ -4302,7 +4285,7 @@ type FlexWrap = 'nowrap' | 'wrap' | 'wrap-reverse';
4302
4285
  type FlexAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
4303
4286
  type FlexJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
4304
4287
  type FlexGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
4305
- interface FlexProps {
4288
+ interface FlexProps extends A11yProps {
4306
4289
  /** Flex direction */
4307
4290
  direction?: FlexDirection;
4308
4291
  /** Flex wrap */
@@ -4369,7 +4352,8 @@ interface FloatingAction {
4369
4352
  */
4370
4353
  variant?: "primary" | "secondary" | "success" | "danger" | "warning";
4371
4354
  }
4372
- interface FloatingActionButtonProps {
4355
+ /** @accessibleName label */
4356
+ interface FloatingActionButtonProps extends A11yProps {
4373
4357
  /**
4374
4358
  * Declarative event name. When set, clicking the FAB emits `UI:{action}`
4375
4359
  * via the event bus and (if also provided) calls `onClick`. Mirrors the
@@ -4439,7 +4423,7 @@ interface ResponsiveGridCols {
4439
4423
  /** Extra large screens (1280px+) */
4440
4424
  xl?: GridCols;
4441
4425
  }
4442
- interface GridProps {
4426
+ interface GridProps extends A11yProps {
4443
4427
  /** Number of columns (can be responsive object) */
4444
4428
  cols?: GridCols | ResponsiveGridCols;
4445
4429
  /** Number of rows */
@@ -4477,7 +4461,7 @@ declare const Grid: React__default.FC<GridProps>;
4477
4461
  * Uses Input, Button, Icon, and Typography atoms.
4478
4462
  */
4479
4463
 
4480
- interface InputGroupProps extends Omit<InputProps, "icon" | "iconRight"> {
4464
+ interface InputGroupProps extends Omit<InputProps, "icon" | "iconRight" | keyof A11yProps>, A11yProps {
4481
4465
  /**
4482
4466
  * Left addon (icon, button, or text)
4483
4467
  */
@@ -4517,7 +4501,7 @@ interface MenuItem {
4517
4501
  title?: string;
4518
4502
  /** Item click handler */
4519
4503
  onClick?: () => void;
4520
- /** Event name for pattern compatibility */
4504
+ /** Bus event this item fires on pick — unless `onClick` is set, which then owns firing (`event` then only names the item, e.g. its `action-<EVENT>` test id). */
4521
4505
  event?: EventKey;
4522
4506
  /** Link this item follows on pick: an in-app path (nav stack), `#anchor` or absolute URL. */
4523
4507
  href?: string;
@@ -4529,7 +4513,7 @@ interface MenuItem {
4529
4513
  subMenu?: MenuItem[];
4530
4514
  }
4531
4515
  type MenuPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-start" | "top-end" | "bottom-start" | "bottom-end";
4532
- interface MenuProps {
4516
+ interface MenuProps extends A11yProps {
4533
4517
  /** Menu trigger element */
4534
4518
  trigger: React__default.ReactNode;
4535
4519
  /** Menu items */
@@ -4567,7 +4551,7 @@ interface TopNavItemData {
4567
4551
  /** Child items shown in a dropdown. */
4568
4552
  children?: TopNavItemData[];
4569
4553
  }
4570
- interface TopNavItemProps {
4554
+ interface TopNavItemProps extends A11yProps {
4571
4555
  item: TopNavItemData;
4572
4556
  /** The href of the active page, used to mark the item (or its parent) active. */
4573
4557
  activeHref?: string;
@@ -4575,7 +4559,7 @@ interface TopNavItemProps {
4575
4559
  tone?: 'solid' | 'soft';
4576
4560
  className?: string;
4577
4561
  }
4578
- declare function TopNavItem({ item, activeHref, tone, className }: TopNavItemProps): React__default.ReactElement;
4562
+ declare function TopNavItem({ item, activeHref, tone, className, ...rest }: TopNavItemProps): React__default.ReactElement;
4579
4563
  declare namespace TopNavItem {
4580
4564
  var displayName: string;
4581
4565
  }
@@ -4593,7 +4577,7 @@ type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
4593
4577
  * `size` (which conveys content scale).
4594
4578
  */
4595
4579
  type ModalLook = "centered-card" | "top-sheet" | "side-drawer" | "full-screen";
4596
- interface ModalProps {
4580
+ interface ModalProps extends A11yProps {
4597
4581
  /** Whether the modal is open (defaults to true when rendered by slot wrapper) */
4598
4582
  isOpen?: boolean;
4599
4583
  /** Callback when modal should close (injected by slot wrapper) */
@@ -4642,7 +4626,7 @@ declare const Modal: React__default.FC<ModalProps>;
4642
4626
  * @packageDocumentation
4643
4627
  */
4644
4628
 
4645
- interface PageTransitionProps {
4629
+ interface PageTransitionProps extends A11yProps {
4646
4630
  /** Value that changes on navigation (a page path). */
4647
4631
  locationKey: string;
4648
4632
  children: React__default.ReactNode;
@@ -4669,7 +4653,7 @@ declare const PageTransition: React__default.FC<PageTransitionProps>;
4669
4653
  * layer over the nearest positioned ancestor (and `shake` items are inert).
4670
4654
  */
4671
4655
 
4672
- interface FxOverlayProps {
4656
+ interface FxOverlayProps extends A11yProps {
4673
4657
  /** Live screen-space fx entries (the mechanic's fx list filtered to `space == "screen"`); mount starts each item's animation, ttl decay unmounts it. */
4674
4658
  items: FxOverlayItem[];
4675
4659
  /** The fx mechanic's decay tick period in ms; per-item animation duration = maxTtl × tickMs. Default 500. */
@@ -4688,7 +4672,7 @@ declare const FxOverlay: React__default.FC<FxOverlayProps>;
4688
4672
  * Uses Button, Icon, Typography, and Input atoms.
4689
4673
  */
4690
4674
 
4691
- interface PaginationProps {
4675
+ interface PaginationProps extends A11yProps {
4692
4676
  /**
4693
4677
  * Current page (1-indexed)
4694
4678
  */
@@ -4761,7 +4745,7 @@ declare const Pagination: React__default.FC<PaginationProps>;
4761
4745
 
4762
4746
  type PopoverPosition = "top" | "bottom" | "left" | "right";
4763
4747
  type PopoverTrigger = "click" | "hover";
4764
- interface PopoverProps {
4748
+ interface PopoverProps extends A11yProps {
4765
4749
  /**
4766
4750
  * Popover content
4767
4751
  */
@@ -4813,7 +4797,7 @@ declare const Popover: React__default.FC<PopoverProps>;
4813
4797
 
4814
4798
  type CoachmarkPlacement = "top" | "bottom" | "left" | "right";
4815
4799
  type CoachmarkAnchor = React__default.RefObject<HTMLElement | null> | string | DOMRect;
4816
- interface CoachmarkProps {
4800
+ interface CoachmarkProps extends A11yProps {
4817
4801
  /** Controlled visibility. */
4818
4802
  open: boolean;
4819
4803
  /** The element to point at: a ref, a CSS selector, or a DOMRect. */
@@ -4900,7 +4884,7 @@ interface RelationOption {
4900
4884
  /** Whether this option is disabled */
4901
4885
  disabled?: boolean;
4902
4886
  }
4903
- interface RelationSelectProps {
4887
+ interface RelationSelectProps extends A11yProps {
4904
4888
  /** Current value (ID) */
4905
4889
  value?: string;
4906
4890
  /** Callback when value changes */
@@ -4942,7 +4926,7 @@ declare const RelationSelect: React__default.FC<RelationSelectProps>;
4942
4926
  /**
4943
4927
  * @minWidth 160
4944
4928
  */
4945
- interface SearchInputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'type'> {
4929
+ interface SearchInputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'type' | keyof A11yProps>, A11yProps {
4946
4930
  /**
4947
4931
  * Search value (controlled mode)
4948
4932
  */
@@ -4962,8 +4946,7 @@ interface SearchInputProps extends Omit<React__default.InputHTMLAttributes<HTMLI
4962
4946
  */
4963
4947
  isLoading?: boolean;
4964
4948
  /**
4965
- * Placeholder text
4966
- * @default 'Search...'
4949
+ * Placeholder text (the translated "Search" when omitted)
4967
4950
  */
4968
4951
  placeholder?: string;
4969
4952
  /**
@@ -5001,7 +4984,7 @@ declare const SearchInput: React__default.FC<SearchInputProps>;
5001
4984
  * API, used where the panel is always present in the component tree.
5002
4985
  */
5003
4986
 
5004
- interface SidePanelProps {
4987
+ interface SidePanelProps extends A11yProps {
5005
4988
  /**
5006
4989
  * Panel title
5007
4990
  */
@@ -5055,7 +5038,7 @@ declare const SidePanel: React__default.FC<SidePanelProps>;
5055
5038
  */
5056
5039
 
5057
5040
  type SimpleGridGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
5058
- interface SimpleGridProps {
5041
+ interface SimpleGridProps extends A11yProps {
5059
5042
  /** Minimum width of each child (e.g., 200, "200px", "15rem") */
5060
5043
  minChildWidth?: number | string;
5061
5044
  /** Maximum number of columns */
@@ -5068,6 +5051,10 @@ interface SimpleGridProps {
5068
5051
  className?: string;
5069
5052
  /** Children elements */
5070
5053
  children: React__default.ReactNode;
5054
+ /** Element id forwarded to the grid element. */
5055
+ id?: string;
5056
+ /** DOM attributes forwarded to the grid element (aria-*, data-*, role, id). */
5057
+ [attr: `aria-${string}` | `data-${string}`]: string | number | boolean | undefined;
5071
5058
  }
5072
5059
  /**
5073
5060
  * SimpleGrid - Auto-responsive grid layout
@@ -5109,7 +5096,7 @@ interface TabItem {
5109
5096
  /** Whether this tab is currently active (for controlled tabs) */
5110
5097
  active?: boolean;
5111
5098
  }
5112
- interface TabsProps {
5099
+ interface TabsProps extends A11yProps {
5113
5100
  /** Tab items */
5114
5101
  items?: TabItem[];
5115
5102
  /** Tab items (alias for items - used by generated code) */
@@ -5141,14 +5128,18 @@ declare const Tabs: React__default.FC<TabsProps>;
5141
5128
  */
5142
5129
 
5143
5130
  type ToastVariant = "success" | "error" | "info" | "warning";
5144
- interface ToastProps {
5131
+ interface ToastProps extends A11yProps {
5145
5132
  /** Toast variant */
5146
5133
  variant?: ToastVariant;
5147
5134
  /** Toast message */
5148
5135
  message: string;
5149
5136
  /** Toast title (optional) */
5150
5137
  title?: string;
5151
- /** Auto-dismiss duration in milliseconds (0 = no auto-dismiss) */
5138
+ /**
5139
+ * Auto-dismiss duration in milliseconds (0 = no auto-dismiss). The timer
5140
+ * pauses while the toast is hovered or focused, and a toast carrying an
5141
+ * action (`actionLabel` with `onAction`/`actionEvent`) never auto-dismisses.
5142
+ */
5152
5143
  duration?: number;
5153
5144
  /** Show dismiss button */
5154
5145
  dismissible?: boolean;
@@ -5177,7 +5168,7 @@ declare const Toast: React__default.FC<ToastProps>;
5177
5168
  */
5178
5169
 
5179
5170
  type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
5180
- interface TooltipProps {
5171
+ interface TooltipProps extends A11yProps {
5181
5172
  /** Tooltip content */
5182
5173
  content: React__default.ReactNode;
5183
5174
  /** Tooltip trigger element (ReactElement or ReactNode that will be wrapped in span) */
@@ -5201,6 +5192,7 @@ declare const Tooltip: React__default.FC<TooltipProps>;
5201
5192
  * screens, where the tap is the action).
5202
5193
  */
5203
5194
 
5195
+ /** @accessibleName label */
5204
5196
  interface IconButtonProps extends Omit<ButtonProps, 'children' | 'label' | 'icon' | 'leftIcon' | 'rightIcon' | 'iconRight'> {
5205
5197
  icon: IconInput;
5206
5198
  /** What the button does — its accessible name and its tooltip. */
@@ -5229,7 +5221,7 @@ declare const IconButton: React__default.ForwardRefExoticComponent<IconButtonPro
5229
5221
 
5230
5222
  type DrawerPosition = "left" | "right";
5231
5223
  type DrawerSize = "sm" | "md" | "lg" | "xl" | "full";
5232
- interface DrawerProps {
5224
+ interface DrawerProps extends A11yProps {
5233
5225
  /** Whether the drawer is open (defaults to true when rendered by slot wrapper) */
5234
5226
  isOpen?: boolean;
5235
5227
  /** Fires after the exit animation completes (the drawer is about to unmount). */
@@ -5282,7 +5274,7 @@ interface WizardProgressStep {
5282
5274
  /** Step description (optional) */
5283
5275
  description?: string;
5284
5276
  }
5285
- interface WizardProgressProps {
5277
+ interface WizardProgressProps extends A11yProps {
5286
5278
  /** Step definitions (compatible with WizardContainer's WizardStep). A string is shorthand for `{ id: str, title: str }`. */
5287
5279
  steps?: (WizardProgressStep | string)[];
5288
5280
  /** Current step index (0-based) */
@@ -5320,7 +5312,7 @@ declare const WizardProgress: React__default.FC<WizardProgressProps>;
5320
5312
  * Uses wireframe theme styling (high contrast, sharp edges).
5321
5313
  */
5322
5314
 
5323
- interface WizardNavigationProps {
5315
+ interface WizardNavigationProps extends A11yProps {
5324
5316
  /** Current step index (0-based) */
5325
5317
  currentStep: number;
5326
5318
  /** Total number of steps */
@@ -5386,7 +5378,7 @@ declare const WizardNavigation: React__default.FC<WizardNavigationProps>;
5386
5378
  * DocumentViewer and `<svg>` in JazariStateMachine/StateMachineView.
5387
5379
  */
5388
5380
 
5389
- interface MarkdownContentProps {
5381
+ interface MarkdownContentProps extends A11yProps {
5390
5382
  /** The markdown content to render */
5391
5383
  content: string;
5392
5384
  /** Text direction (defaults to ltr; `ltr` is first so the generated config seeds it) */
@@ -5526,7 +5518,7 @@ interface CodeViewerFile {
5526
5518
  code: string;
5527
5519
  language?: CodeLanguage;
5528
5520
  }
5529
- interface CodeBlockProps {
5521
+ interface CodeBlockProps extends A11yProps {
5530
5522
  /** The code content to display */
5531
5523
  code?: string;
5532
5524
  /** Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered) */
@@ -5733,7 +5725,7 @@ declare const CodeBlock: React__default.NamedExoticComponent<CodeBlockProps>;
5733
5725
  *
5734
5726
  * @capabilities multiple-choice quiz, test question, exam item, assessment question, knowledge check, trivia question
5735
5727
  */
5736
- interface QuizBlockProps {
5728
+ interface QuizBlockProps extends A11yProps {
5737
5729
  /** The quiz question */
5738
5730
  question: string;
5739
5731
  /** The quiz answer (revealed on toggle) */
@@ -5758,7 +5750,7 @@ declare const QuizBlock: React__default.FC<QuizBlockProps>;
5758
5750
  * - entityAware: false
5759
5751
  */
5760
5752
 
5761
- interface ScaledDiagramProps {
5753
+ interface ScaledDiagramProps extends A11yProps {
5762
5754
  children: React__default.ReactNode;
5763
5755
  className?: string;
5764
5756
  }
@@ -5786,7 +5778,7 @@ interface CalendarEventRow {
5786
5778
  endTime?: string;
5787
5779
  color?: string;
5788
5780
  }
5789
- interface CalendarGridProps {
5781
+ interface CalendarGridProps extends A11yProps {
5790
5782
  /** Start of the week (defaults to current week's Monday) */
5791
5783
  weekStart?: Date;
5792
5784
  /** Time slot labels (defaults to 09:00-17:00) */
@@ -5802,6 +5794,8 @@ interface CalendarGridProps {
5802
5794
  onEventClick?: (event: EntityRow) => void;
5803
5795
  /** Additional CSS classes */
5804
5796
  className?: string;
5797
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
5798
+ surface?: SurfaceMode;
5805
5799
  /** Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload } */
5806
5800
  longPressEvent?: EventEmit<{
5807
5801
  date: string;
@@ -5854,7 +5848,7 @@ interface CalendarGridProps {
5854
5848
  */
5855
5849
  renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
5856
5850
  }
5857
- declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, endField, colorField, children, renderItem, }: CalendarGridProps): React__default.JSX.Element;
5851
+ declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, surface, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, endField, colorField, children, renderItem, ...rest }: CalendarGridProps): React__default.JSX.Element;
5858
5852
  declare namespace CalendarGrid {
5859
5853
  var displayName: string;
5860
5854
  }
@@ -5884,7 +5878,7 @@ interface GanttLink {
5884
5878
  * @capabilities gantt chart, project timeline, schedule view, task bars, dependency arrows, roadmap, milestone plan
5885
5879
  * @fieldsContract display
5886
5880
  */
5887
- interface GanttProps {
5881
+ interface GanttProps extends A11yProps {
5888
5882
  /**
5889
5883
  * Schema entity data — the task rows to place on the axis. pattern-sync tags
5890
5884
  * it `kind:"entity", cardinality:"collection"` so consumers bind the domain
@@ -5920,6 +5914,8 @@ interface GanttProps {
5920
5914
  barClickEvent?: EventEmit<{
5921
5915
  id: string;
5922
5916
  }>;
5917
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
5918
+ surface?: SurfaceMode;
5923
5919
  /** Additional CSS classes */
5924
5920
  className?: string;
5925
5921
  /** Loading state */
@@ -5927,7 +5923,7 @@ interface GanttProps {
5927
5923
  /** Error state */
5928
5924
  error?: UiError | null;
5929
5925
  }
5930
- declare function Gantt({ tasks, links, titleField, startField, endField, durationField, statusField, statusColorMap, groupField, rangeStart, rangeEnd, showToday, dayWidth, barClickEvent, className, isLoading, error, }: GanttProps): React__default.JSX.Element;
5926
+ declare function Gantt({ tasks, links, titleField, startField, endField, durationField, statusField, statusColorMap, groupField, rangeStart, rangeEnd, showToday, dayWidth, barClickEvent, className, isLoading, error, surface, ...rest }: GanttProps): React__default.JSX.Element;
5931
5927
  declare namespace Gantt {
5932
5928
  var displayName: string;
5933
5929
  }
@@ -5960,7 +5956,7 @@ type RepeatableItem = {
5960
5956
  *
5961
5957
  * @capabilities dynamic line items, repeatable field group, add/remove entry rows, multi-entry form block
5962
5958
  */
5963
- interface RepeatableFormSectionProps {
5959
+ interface RepeatableFormSectionProps extends A11yProps {
5964
5960
  /** Section type identifier */
5965
5961
  sectionType: string;
5966
5962
  /** Section title */
@@ -6025,7 +6021,7 @@ type ViolationRecord = {
6025
6021
  /** Tab/form where violation occurred */
6026
6022
  tabId?: string;
6027
6023
  };
6028
- interface ViolationAlertProps {
6024
+ interface ViolationAlertProps extends A11yProps {
6029
6025
  /** Violation data */
6030
6026
  violation: ViolationRecord;
6031
6027
  /** Visual severity (derived from actionType if not specified) */
@@ -6052,7 +6048,7 @@ declare const ViolationAlert: React__default.FC<ViolationAlertProps>;
6052
6048
  * Provides consistent styling and interaction for section headers.
6053
6049
  */
6054
6050
 
6055
- interface FormSectionHeaderProps {
6051
+ interface FormSectionHeaderProps extends A11yProps {
6056
6052
  /** Section title */
6057
6053
  title: string;
6058
6054
  /** Section subtitle */
@@ -6088,7 +6084,7 @@ declare const FormSectionHeader: React__default.FC<FormSectionHeaderProps>;
6088
6084
  *
6089
6085
  * @capabilities flashcard, study deck, spaced-repetition review card, memorization drill, quiz reveal card, question/answer card, before/after reveal, term-and-definition card
6090
6086
  */
6091
- interface FlipCardProps {
6087
+ interface FlipCardProps extends A11yProps {
6092
6088
  /** Content rendered on the front face */
6093
6089
  front: React__default.ReactNode;
6094
6090
  /** Content rendered on the back face */
@@ -6103,7 +6099,7 @@ interface FlipCardProps {
6103
6099
  height?: string;
6104
6100
  }
6105
6101
  declare const FlipCard: {
6106
- ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): React__default.JSX.Element;
6102
+ ({ front, back, flipped, onFlip, className, height, ...rest }: FlipCardProps): React__default.JSX.Element;
6107
6103
  displayName: string;
6108
6104
  };
6109
6105
 
@@ -6205,7 +6201,7 @@ declare const IconPicker: React__default.FC<IconPickerProps>;
6205
6201
  */
6206
6202
 
6207
6203
  type EmojiPickerPosition = 'top' | 'bottom';
6208
- interface EmojiPickerProps {
6204
+ interface EmojiPickerProps extends A11yProps {
6209
6205
  /**
6210
6206
  * Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus
6211
6207
  */
@@ -6221,8 +6217,7 @@ interface EmojiPickerProps {
6221
6217
  */
6222
6218
  triggerIcon?: IconInput;
6223
6219
  /**
6224
- * Accessible label for the trigger button
6225
- * @default translated "Add emoji"
6220
+ * Accessible label for the trigger button (the translated "Add emoji" when omitted)
6226
6221
  */
6227
6222
  triggerLabel?: string;
6228
6223
  /**
@@ -6262,7 +6257,7 @@ interface DateRangePickerPreset {
6262
6257
  */
6263
6258
  range?: (() => DateRange) | DateRange;
6264
6259
  }
6265
- interface DateRangePickerProps {
6260
+ interface DateRangePickerProps extends A11yProps {
6266
6261
  /** Controlled `from` (ISO date YYYY-MM-DD). */
6267
6262
  from?: string;
6268
6263
  /** Controlled `to` (ISO date YYYY-MM-DD). */
@@ -6305,7 +6300,7 @@ interface DateRangeSelectorOption {
6305
6300
  label: string;
6306
6301
  value: string;
6307
6302
  }
6308
- interface DateRangeSelectorProps {
6303
+ interface DateRangeSelectorProps extends A11yProps {
6309
6304
  /** Available range options */
6310
6305
  options?: DateRangeSelectorOption[];
6311
6306
  /** Currently selected value */
@@ -6328,7 +6323,7 @@ interface ChartLegendItem {
6328
6323
  label: string;
6329
6324
  color: string;
6330
6325
  }
6331
- interface ChartLegendProps {
6326
+ interface ChartLegendProps extends A11yProps {
6332
6327
  /** Legend items with label and color */
6333
6328
  items: ChartLegendItem[];
6334
6329
  /** Additional CSS classes */
@@ -6359,7 +6354,7 @@ interface ChartDataPoint {
6359
6354
  value: number;
6360
6355
  label?: string;
6361
6356
  }
6362
- interface LineChartProps {
6357
+ interface LineChartProps extends A11yProps {
6363
6358
  /** Data points to plot */
6364
6359
  data: ChartDataPoint[];
6365
6360
  /** SVG viewBox width */
@@ -6390,7 +6385,7 @@ declare const LineChart: React__default.FC<LineChartProps>;
6390
6385
 
6391
6386
  type DotState = 'active' | 'complete' | 'pending';
6392
6387
  type DotSize = 'sm' | 'md' | 'lg';
6393
- interface ProgressDotsProps {
6388
+ interface ProgressDotsProps extends A11yProps {
6394
6389
  /** Total number of dots */
6395
6390
  count: number;
6396
6391
  /** Current active index (0-based) */
@@ -6518,7 +6513,7 @@ interface MathHop {
6518
6513
  /** Hop label, centered above the arc. */
6519
6514
  label?: string;
6520
6515
  }
6521
- interface MathCanvasProps {
6516
+ interface MathCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
6522
6517
  className?: string;
6523
6518
  width?: number;
6524
6519
  height?: number;
@@ -6812,7 +6807,7 @@ interface PhysicsMeter {
6812
6807
  /** Bar + value color (default '#3b82f6'). */
6813
6808
  color?: string;
6814
6809
  }
6815
- interface PhysicsCanvasProps {
6810
+ interface PhysicsCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
6816
6811
  className?: string;
6817
6812
  width?: number;
6818
6813
  height?: number;
@@ -7021,7 +7016,7 @@ interface BiologyHelix3D {
7021
7016
  /** Spread multiplier for unwound rungs (default 1.8). */
7022
7017
  unwindSpread?: number;
7023
7018
  }
7024
- interface BiologyCanvasProps {
7019
+ interface BiologyCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7025
7020
  className?: string;
7026
7021
  width?: number;
7027
7022
  height?: number;
@@ -7214,7 +7209,7 @@ interface ChemistryLattice3D {
7214
7209
  /** Selected-site color (default '#f59e0b'). */
7215
7210
  selectedColor?: string;
7216
7211
  }
7217
- interface ChemistryCanvasProps {
7212
+ interface ChemistryCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7218
7213
  className?: string;
7219
7214
  width?: number;
7220
7215
  height?: number;
@@ -7362,7 +7357,7 @@ interface AlgorithmAxisLabel {
7362
7357
  text: string;
7363
7358
  color?: string;
7364
7359
  }
7365
- interface AlgorithmCanvasProps {
7360
+ interface AlgorithmCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7366
7361
  className?: string;
7367
7362
  width?: number;
7368
7363
  height?: number;
@@ -7450,7 +7445,7 @@ interface AlgoGraphEdge {
7450
7445
  state?: AlgoGraphEdgeState;
7451
7446
  color?: string;
7452
7447
  }
7453
- interface AlgoGraphCanvasProps {
7448
+ interface AlgoGraphCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7454
7449
  className?: string;
7455
7450
  width?: number;
7456
7451
  height?: number;
@@ -7508,7 +7503,9 @@ declare const AlgoGraphCanvas: React$1.FC<AlgoGraphCanvasProps>;
7508
7503
 
7509
7504
  /** A point in scene space: `[x, y, z]` — x/y the ground plane, z the height (cells). */
7510
7505
  type Learning3DPoint = [number, number, number];
7511
- interface LearningScene3DProps {
7506
+ interface LearningScene3DProps extends A11yProps {
7507
+ /** Text alternative for the scene, rendered as visually hidden text and linked by aria-describedby. */
7508
+ description?: string;
7512
7509
  className?: string;
7513
7510
  width?: number;
7514
7511
  height?: number;
@@ -7533,7 +7530,7 @@ interface LearningScene3DProps {
7533
7530
  /** Fires with the `id` of a clicked descriptor (descriptors carry `id` via DrawableBase). */
7534
7531
  onItemClick?: (id: string) => void;
7535
7532
  }
7536
- declare function LearningScene3D({ className, width, height, title, backgroundColor, drawables, camera, lighting, post, showGrid, shadows, interactive, isLoading, error, onItemClick, }: LearningScene3DProps): React$1.JSX.Element;
7533
+ declare function LearningScene3D({ className, width, height, title, backgroundColor, drawables, camera, lighting, post, showGrid, shadows, interactive, isLoading, error, onItemClick, description, ...rest }: LearningScene3DProps): React$1.JSX.Element;
7537
7534
  declare namespace LearningScene3D {
7538
7535
  var displayName: string;
7539
7536
  }
@@ -7592,7 +7589,7 @@ interface GraphViewEdge {
7592
7589
  color?: string;
7593
7590
  label?: string;
7594
7591
  }
7595
- interface GraphViewProps {
7592
+ interface GraphViewProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
7596
7593
  /** Graph nodes */
7597
7594
  nodes: GraphViewNode[];
7598
7595
  /** Graph edges */
@@ -7605,6 +7602,8 @@ interface GraphViewProps {
7605
7602
  width?: number;
7606
7603
  /** Height in pixels */
7607
7604
  height?: number;
7605
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
7606
+ surface?: SurfaceMode;
7608
7607
  /** Additional CSS classes */
7609
7608
  className?: string;
7610
7609
  /** Show node labels (default true) */
@@ -7672,7 +7671,9 @@ interface MapRouteData {
7672
7671
  /** Label shown in a popup at the midpoint */
7673
7672
  label?: string;
7674
7673
  }
7675
- interface MapViewProps {
7674
+ interface MapViewProps extends A11yProps {
7675
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
7676
+ surface?: SurfaceMode;
7676
7677
  /** Array of markers to display */
7677
7678
  markers?: MapMarkerData[];
7678
7679
  /** Routes (polylines with optional popups) drawn over the tile layer */
@@ -7711,7 +7712,8 @@ interface MapViewProps {
7711
7712
  declare function MapView(props: MapViewProps): React__default.JSX.Element;
7712
7713
 
7713
7714
  type NumberStepperSize = "sm" | "md" | "lg";
7714
- interface NumberStepperProps {
7715
+ /** @accessibleName label */
7716
+ interface NumberStepperProps extends A11yProps {
7715
7717
  /** Current value */
7716
7718
  value?: number;
7717
7719
  /** Minimum value */
@@ -7743,7 +7745,8 @@ declare const NumberStepper: React__default.FC<NumberStepperProps>;
7743
7745
 
7744
7746
  type StarRatingSize = "sm" | "md" | "lg";
7745
7747
  type StarRatingPrecision = "full" | "half";
7746
- interface StarRatingProps {
7748
+ /** @accessibleName label */
7749
+ interface StarRatingProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
7747
7750
  /** Current rating value */
7748
7751
  value?: number;
7749
7752
  /** Maximum number of stars */
@@ -7771,7 +7774,7 @@ interface StarRatingProps {
7771
7774
  }
7772
7775
  declare const StarRating: React__default.FC<StarRatingProps>;
7773
7776
 
7774
- interface UploadDropZoneProps {
7777
+ interface UploadDropZoneProps extends A11yProps {
7775
7778
  /** Accepted MIME types (e.g., "image/*", "application/pdf") */
7776
7779
  accept?: string;
7777
7780
  /** Max file size in bytes */
@@ -7811,7 +7814,7 @@ interface LightboxImage {
7811
7814
  alt?: string;
7812
7815
  caption?: string;
7813
7816
  }
7814
- interface LightboxProps {
7817
+ interface LightboxProps extends A11yProps {
7815
7818
  /** Array of images to display */
7816
7819
  images: LightboxImage[];
7817
7820
  /** Current image index */
@@ -7858,6 +7861,11 @@ declare const Lightbox: React__default.FC<LightboxProps>;
7858
7861
  * evaluated by the one helper below.
7859
7862
  */
7860
7863
  type RowActionCondition = SExpr$1 | ((row: EntityRow) => boolean);
7864
+ /**
7865
+ * What an action item's `payload` holds: the authored `(fn row { key: <expr> })`
7866
+ * S-expression, or the compiled shell's `(row) => payload` closure.
7867
+ */
7868
+ type RowActionPayload = SExpr$1 | ((row: EntityRow) => EventPayload);
7861
7869
 
7862
7870
  /**
7863
7871
  * useDataDnd — shared drag-drop machinery for DataList + DataGrid.
@@ -7934,6 +7942,8 @@ interface DataGridItemAction {
7934
7942
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
7935
7943
  /** Per-row condition, authored as `(fn row <bool>)`: the row's button is drawn only when it returns true. Omit = always shown. */
7936
7944
  when?: RowActionCondition;
7945
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
7946
+ payload?: RowActionPayload;
7937
7947
  }
7938
7948
  /**
7939
7949
  * DataGrid — structured records grid rendering rows over configurable columns,
@@ -7943,7 +7953,7 @@ interface DataGridItemAction {
7943
7953
  * @fieldsContract display
7944
7954
  * @minWidth 200
7945
7955
  */
7946
- interface DataGridProps extends DataDndProps, EmptyStateSlotProps {
7956
+ interface DataGridProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
7947
7957
  /**
7948
7958
  * Schema entity data — the collection of rows to render. pattern-sync tags
7949
7959
  * it `kind:"entity", cardinality:"collection"` so consumers bind the domain
@@ -7977,6 +7987,8 @@ interface DataGridProps extends DataDndProps, EmptyStateSlotProps {
7977
7987
  className?: string;
7978
7988
  /** Loading state */
7979
7989
  isLoading?: boolean;
7990
+ /** Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out). */
7991
+ skeleton?: SkeletonSpec;
7980
7992
  /** Error state */
7981
7993
  error?: UiError | null;
7982
7994
  /** Entity field name containing an image URL for card thumbnails */
@@ -8009,13 +8021,15 @@ interface DataGridProps extends DataDndProps, EmptyStateSlotProps {
8009
8021
  * data-grid / data-list / entity-table share one knob name from authors.
8010
8022
  */
8011
8023
  look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
8024
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
8025
+ surface?: SurfaceMode;
8012
8026
  /** Relation display data: { fieldName: [{value, label}] } — injected
8013
8027
  * server-side by the runtime (relation-option injection) or bound by
8014
8028
  * compiled codegen; resolves stored foreign ids to display names for a
8015
8029
  * field whose type is relation. Same contract DetailPanel takes. */
8016
8030
  relationsData?: Record<string, readonly RelationOption[]>;
8017
8031
  }
8018
- declare function DataGrid({ entity, emptyIcon, emptyTitle, emptyDescription, emptyAction, fields, columns, itemActions, itemClickEvent, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, relationsData, }: DataGridProps): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | React__default.JSX.Element | null | undefined;
8032
+ declare function DataGrid({ entity, emptyIcon, emptyTitle, emptyDescription, emptyAction, fields, columns, itemActions, itemClickEvent, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, skeleton, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, surface, relationsData, ...rest }: DataGridProps): React__default.JSX.Element;
8019
8033
  declare namespace DataGrid {
8020
8034
  var displayName: string;
8021
8035
  }
@@ -8048,6 +8062,8 @@ interface DataListItemAction {
8048
8062
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
8049
8063
  /** Per-row condition, authored as `(fn row <bool>)`: the row's button is drawn only when it returns true. Omit = always shown. */
8050
8064
  when?: RowActionCondition;
8065
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
8066
+ payload?: RowActionPayload;
8051
8067
  }
8052
8068
  interface DataListSwipeAction {
8053
8069
  /** Button label */
@@ -8061,7 +8077,7 @@ interface DataListSwipeAction {
8061
8077
  * @fieldsContract display
8062
8078
  * @minWidth 200
8063
8079
  */
8064
- interface DataListProps extends DataDndProps, EmptyStateSlotProps {
8080
+ interface DataListProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
8065
8081
  /**
8066
8082
  * Schema entity data — the collection of rows to render.
8067
8083
  */
@@ -8108,6 +8124,8 @@ interface DataListProps extends DataDndProps, EmptyStateSlotProps {
8108
8124
  className?: string;
8109
8125
  /** Loading state */
8110
8126
  isLoading?: boolean;
8127
+ /** Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out). */
8128
+ skeleton?: SkeletonSpec;
8111
8129
  /** Error state */
8112
8130
  error?: UiError | null;
8113
8131
  /** Enable drag-to-reorder with grip handles */
@@ -8163,13 +8181,15 @@ interface DataListProps extends DataDndProps, EmptyStateSlotProps {
8163
8181
  * data-grid / data-list / entity-table share one knob name from authors.
8164
8182
  */
8165
8183
  look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
8184
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
8185
+ surface?: SurfaceMode;
8166
8186
  /** Relation display data: { fieldName: [{value, label}] } — injected
8167
8187
  * server-side by the runtime (relation-option injection) or bound by
8168
8188
  * compiled codegen; resolves stored foreign ids to display names for a
8169
8189
  * field whose type is relation. Same contract DetailPanel takes. */
8170
8190
  relationsData?: Record<string, readonly RelationOption[]>;
8171
8191
  }
8172
- declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, senderLabelField, currentUser, emptyMessage, emptyIcon, emptyTitle, emptyDescription, emptyAction, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, sortBy, sortDirection, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, relationsData, }: DataListProps): string | number | bigint | boolean | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | React__default.JSX.Element | null | undefined;
8192
+ declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, senderLabelField, currentUser, emptyMessage, emptyIcon, emptyTitle, emptyDescription, emptyAction, className, isLoading, skeleton, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, sortBy, sortDirection, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, surface, relationsData, ...rest }: DataListProps): React__default.JSX.Element;
8173
8193
  declare namespace DataList {
8174
8194
  var displayName: string;
8175
8195
  }
@@ -8231,6 +8251,8 @@ interface TableViewItemAction {
8231
8251
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
8232
8252
  /** Per-row condition, authored as `(fn row <bool>)`: the row's menu item is drawn only when it returns true. Omit = always shown. */
8233
8253
  when?: RowActionCondition;
8254
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
8255
+ payload?: RowActionPayload;
8234
8256
  }
8235
8257
  /**
8236
8258
  * TableView — sortable, selectable data table rendering rows over configurable
@@ -8240,13 +8262,15 @@ interface TableViewItemAction {
8240
8262
  * @fieldsContract display
8241
8263
  * @minWidth 240
8242
8264
  */
8243
- interface TableViewProps extends DataDndProps, EmptyStateSlotProps {
8265
+ interface TableViewProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
8244
8266
  /** Schema entity data — the collection of rows to render. */
8245
8267
  entity: readonly EntityRow[];
8246
8268
  /** Column definitions. The compiler emits `columns`; `fields` is the alias. */
8247
8269
  columns?: readonly TableViewColumn[];
8248
8270
  /** Alias for `columns`. */
8249
8271
  fields?: readonly TableViewColumn[];
8272
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
8273
+ surface?: SurfaceMode;
8250
8274
  /** Per-row actions, collected under a trailing kebab overflow menu. */
8251
8275
  itemActions?: readonly TableViewItemAction[];
8252
8276
  /** @deprecated Row actions always render as a kebab menu now (UX doctrine: row actions behind an overflow menu; a pinned inline button strip paints over cells during horizontal scroll). Accepted and ignored. */
@@ -8277,6 +8301,8 @@ interface TableViewProps extends DataDndProps, EmptyStateSlotProps {
8277
8301
  emptyMessage?: string;
8278
8302
  /** Loading state. */
8279
8303
  isLoading?: boolean;
8304
+ /** Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out). */
8305
+ skeleton?: SkeletonSpec;
8280
8306
  /** Error state. */
8281
8307
  error?: UiError | null;
8282
8308
  /** Group rows under section headers by a field value. */
@@ -8307,7 +8333,7 @@ interface TableViewProps extends DataDndProps, EmptyStateSlotProps {
8307
8333
  * column whose field is relation-typed. Same contract DetailPanel takes. */
8308
8334
  relationsData?: Record<string, readonly RelationOption[]>;
8309
8335
  }
8310
- declare function TableView({ entity, columns, fields, itemActions, itemClickEvent, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, emptyIcon, emptyTitle, emptyDescription, emptyAction, isLoading, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, relationsData, }: TableViewProps): React__default.JSX.Element;
8336
+ declare function TableView({ entity, columns, fields, itemActions, itemClickEvent, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, emptyIcon, emptyTitle, emptyDescription, emptyAction, isLoading, skeleton, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, surface, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, relationsData, ...rest }: TableViewProps): React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>>;
8311
8337
  declare namespace TableView {
8312
8338
  var displayName: string;
8313
8339
  }
@@ -8321,7 +8347,7 @@ declare namespace TableView {
8321
8347
  */
8322
8348
 
8323
8349
  type StatDisplayLook = 'elevated' | 'flat' | 'progress-backed' | 'gauge' | 'sparkline';
8324
- interface StatDisplayProps {
8350
+ interface StatDisplayProps extends A11yProps {
8325
8351
  /** Display label (e.g., "Total", "Remaining") */
8326
8352
  label: string;
8327
8353
  /** Primary value (number or formatted string) */
@@ -8360,10 +8386,14 @@ interface StatDisplayProps {
8360
8386
  compact?: boolean;
8361
8387
  /** Layer 2 visual treatment. */
8362
8388
  look?: StatDisplayLook;
8389
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
8390
+ surface?: SurfaceMode;
8363
8391
  /** Additional CSS classes */
8364
8392
  className?: string;
8365
8393
  /** Loading state */
8366
8394
  isLoading?: boolean;
8395
+ /** Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out). */
8396
+ skeleton?: SkeletonSpec;
8367
8397
  /** Error state */
8368
8398
  error?: UiError | null;
8369
8399
  }
@@ -8389,7 +8419,7 @@ interface MeterAction {
8389
8419
  navigatesTo?: string;
8390
8420
  variant?: "primary" | "secondary" | "ghost";
8391
8421
  }
8392
- interface MeterProps {
8422
+ interface MeterProps extends A11yProps {
8393
8423
  /** Current value */
8394
8424
  value: number;
8395
8425
  /** Minimum value */
@@ -8440,7 +8470,7 @@ interface SwipeAction {
8440
8470
  /** Per-row condition, authored as `(fn row <bool>)`: the swipe action is revealed only when it returns true. Omit = always shown. */
8441
8471
  when?: RowActionCondition;
8442
8472
  }
8443
- interface SwipeableRowProps {
8473
+ interface SwipeableRowProps extends A11yProps {
8444
8474
  leftActions?: SwipeAction[];
8445
8475
  rightActions?: SwipeAction[];
8446
8476
  threshold?: number;
@@ -8462,7 +8492,7 @@ declare const SwipeableRow: React__default.FC<SwipeableRowProps>;
8462
8492
  *
8463
8493
  * @capabilities checklist, task list, to-do list, priority list, ranked list, drag-to-reorder queue
8464
8494
  */
8465
- interface SortableListProps {
8495
+ interface SortableListProps extends A11yProps {
8466
8496
  items: readonly EntityRow[];
8467
8497
  /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
8468
8498
  renderItem: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -8477,7 +8507,7 @@ interface SortableListProps {
8477
8507
  dragHandlePosition?: 'left' | 'right';
8478
8508
  className?: string;
8479
8509
  }
8480
- declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, }: SortableListProps): React__default.JSX.Element;
8510
+ declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, ...rest }: SortableListProps): React__default.JSX.Element;
8481
8511
  declare const SortableList: typeof SortableListInner;
8482
8512
 
8483
8513
  /**
@@ -8494,7 +8524,7 @@ interface CarouselItem {
8494
8524
  title?: string;
8495
8525
  image?: AssetUrl;
8496
8526
  }
8497
- interface CarouselProps<T = CarouselItem> {
8527
+ interface CarouselProps<T = CarouselItem> extends A11yProps {
8498
8528
  /** Array of items to display as slides */
8499
8529
  items: T[];
8500
8530
  /** Render function for each slide. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
@@ -8522,7 +8552,7 @@ interface CarouselProps<T = CarouselItem> {
8522
8552
  /** Additional CSS classes */
8523
8553
  className?: string;
8524
8554
  }
8525
- declare const Carousel: <T = CarouselItem>({ items, renderItem, children, autoPlay, autoPlayInterval, showDots, showArrows, loop, slideChangeEvent, slideChangePayload, className, }: CarouselProps<T>) => React__default.ReactElement | null;
8555
+ declare const Carousel: <T = CarouselItem>({ items, renderItem, children, autoPlay, autoPlayInterval, showDots, showArrows, loop, slideChangeEvent, slideChangePayload, className, ...rest }: CarouselProps<T>) => React__default.ReactElement | null;
8526
8556
 
8527
8557
  /**
8528
8558
  * PullToRefresh Molecule Component
@@ -8532,7 +8562,7 @@ declare const Carousel: <T = CarouselItem>({ items, renderItem, children, autoPl
8532
8562
  * a refresh event via the event bus when the threshold is met.
8533
8563
  */
8534
8564
 
8535
- interface PullToRefreshProps {
8565
+ interface PullToRefreshProps extends A11yProps {
8536
8566
  /** Event name to emit on refresh (emitted as UI:{refreshEvent}) */
8537
8567
  refreshEvent: EventKey;
8538
8568
  /** Payload to include with the refresh event
@@ -8561,7 +8591,7 @@ declare const PullToRefresh: React__default.FC<PullToRefreshProps>;
8561
8591
  *
8562
8592
  * @capabilities feature highlight, benefit callout, product capability card, feature-grid tile
8563
8593
  */
8564
- interface FeatureCardProps {
8594
+ interface FeatureCardProps extends A11yProps {
8565
8595
  icon?: IconInput;
8566
8596
  /** Feature title */
8567
8597
  title: string;
@@ -8587,7 +8617,7 @@ declare const FeatureCard: React__default.FC<FeatureCardProps>;
8587
8617
  * Composes SimpleGrid and FeatureCard molecules.
8588
8618
  */
8589
8619
 
8590
- interface FeatureGridProps {
8620
+ interface FeatureGridProps extends A11yProps {
8591
8621
  /** Array of feature card configurations */
8592
8622
  items: FeatureCardProps[];
8593
8623
  /** Number of grid columns */
@@ -8606,7 +8636,7 @@ declare const FeatureGrid: React__default.FC<FeatureGridProps>;
8606
8636
  * later value changes. Optional label below the number.
8607
8637
  */
8608
8638
 
8609
- interface AnimatedCounterProps {
8639
+ interface AnimatedCounterProps extends A11yProps {
8610
8640
  /** Target value. Strings may carry display affixes (e.g. "500+", "99.9%", "$1.2M"). */
8611
8641
  value: string | number;
8612
8642
  /** Label displayed below the number */
@@ -8640,7 +8670,7 @@ interface SocialProofItem {
8640
8670
  /** Optional quote or testimonial text */
8641
8671
  quote?: string;
8642
8672
  }
8643
- interface SocialProofProps {
8673
+ interface SocialProofProps extends A11yProps {
8644
8674
  /** List of social proof items */
8645
8675
  items: SocialProofItem[];
8646
8676
  /** Display variant */
@@ -8673,7 +8703,7 @@ declare const SocialProof: React__default.FC<SocialProofProps>;
8673
8703
  * (`[string]` config knobs without `enumValues`).
8674
8704
  */
8675
8705
 
8676
- interface TagInputProps {
8706
+ interface TagInputProps extends A11yProps {
8677
8707
  /** Current list of tags. */
8678
8708
  value: ReadonlyArray<string>;
8679
8709
  /** Direct callback emitted on every change. Stays as the
@@ -8787,7 +8817,7 @@ type VoteStackVariant = "vertical" | "horizontal";
8787
8817
  * std atoms to drop their string sentinel.
8788
8818
  */
8789
8819
  type VoteValue = "up" | "down" | "none" | null;
8790
- interface VoteStackProps {
8820
+ interface VoteStackProps extends A11yProps {
8791
8821
  /** Current tally */
8792
8822
  count: number;
8793
8823
  /** Current user's vote (null = no vote cast) */
@@ -8819,7 +8849,7 @@ interface LikertOption {
8819
8849
  /** Visible label below (radios) or inside (buttons) the control */
8820
8850
  label: string;
8821
8851
  }
8822
- interface LikertScaleProps {
8852
+ interface LikertScaleProps extends A11yProps {
8823
8853
  /** Optional row prompt above the scale */
8824
8854
  question?: string;
8825
8855
  /** Scale points (defaults to a translated 5-point agree/disagree set) */
@@ -8855,7 +8885,7 @@ interface MatrixColumn {
8855
8885
  value: number | string;
8856
8886
  label: string;
8857
8887
  }
8858
- interface MatrixQuestionProps {
8888
+ interface MatrixQuestionProps extends A11yProps {
8859
8889
  /** Optional title rendered above the matrix */
8860
8890
  title?: string;
8861
8891
  /** Question rows */
@@ -8894,7 +8924,7 @@ type QrScanResult = EventPayload & {
8894
8924
  format: string;
8895
8925
  timestamp: number;
8896
8926
  };
8897
- interface QrScannerProps {
8927
+ interface QrScannerProps extends A11yProps {
8898
8928
  onScan?: (result: QrScanResult) => void;
8899
8929
  scanEvent?: EventEmit<QrScanResult>;
8900
8930
  onError?: (error: Error) => void;
@@ -8933,7 +8963,7 @@ type OptionConstraint = {
8933
8963
  min?: number;
8934
8964
  max?: number;
8935
8965
  };
8936
- interface OptionConstraintGroupProps {
8966
+ interface OptionConstraintGroupProps extends A11yProps {
8937
8967
  groupId: string;
8938
8968
  title: string;
8939
8969
  description?: string;
@@ -8966,7 +8996,7 @@ interface CanvasItemRow {
8966
8996
  status?: CanvasItemStatus;
8967
8997
  shape?: CanvasItemShape;
8968
8998
  }
8969
- interface PositionedCanvasProps {
8999
+ interface PositionedCanvasProps extends A11yProps {
8970
9000
  /**
8971
9001
  * Items to render. The molecule narrows non-array values to `[]` and reads
8972
9002
  * each row's `id` / `x` / `y` / `label` fields at render time.
@@ -9009,7 +9039,7 @@ declare const PositionedCanvas: React__default.FC<PositionedCanvasProps>;
9009
9039
  * always sees the latest content.
9010
9040
  */
9011
9041
 
9012
- interface RichTextEditorProps {
9042
+ interface RichTextEditorProps extends A11yProps {
9013
9043
  /** The rich text content as HTML. Sanitized before rendering and on every change. */
9014
9044
  value?: string;
9015
9045
  onChange?: (value: string) => void;
@@ -9055,7 +9085,7 @@ interface DocumentPanelAction {
9055
9085
  *
9056
9086
  * @capabilities document page, note editor, wiki page, article editor, writing surface, rich text document, content editing canvas
9057
9087
  */
9058
- interface DocumentPanelProps {
9088
+ interface DocumentPanelProps extends A11yProps {
9059
9089
  /** The record's id — carried on every commit and action event. */
9060
9090
  id?: string;
9061
9091
  /** Document title (falls back to "Untitled" for a blank draft) */
@@ -9103,7 +9133,7 @@ interface DocumentPanelProps {
9103
9133
  placeholder?: string;
9104
9134
  className?: string;
9105
9135
  }
9106
- declare function DocumentPanel({ id, title, subtitle, coverImage, icon, value, actions, maxInlineActions, editing, titleCommitEvent, contentChangeEvent, editEvent, doneEvent, editLabel, doneLabel, autosaveHint, placeholder, className, }: DocumentPanelProps): React__default.ReactElement;
9136
+ declare function DocumentPanel({ id, title, subtitle, coverImage, icon, value, actions, maxInlineActions, editing, titleCommitEvent, contentChangeEvent, editEvent, doneEvent, editLabel, doneLabel, autosaveHint, placeholder, className, ...rest }: DocumentPanelProps): React__default.ReactElement;
9107
9137
 
9108
9138
  /**
9109
9139
  * DocumentDetails Molecule
@@ -9153,7 +9183,7 @@ interface DocumentDetailsField {
9153
9183
  * @capabilities document settings, page details, post settings sidebar, metadata panel, document properties, publish settings
9154
9184
  * @fieldsContract display
9155
9185
  */
9156
- interface DocumentDetailsProps {
9186
+ interface DocumentDetailsProps extends A11yProps {
9157
9187
  /** The loaded record — supplies the id every commit carries and the
9158
9188
  * values the rows read. */
9159
9189
  entity?: EntityRow;
@@ -9177,7 +9207,7 @@ interface DocumentDetailsProps {
9177
9207
  title?: string;
9178
9208
  className?: string;
9179
9209
  }
9180
- declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, title, className, }: DocumentDetailsProps): React__default.ReactElement | null;
9210
+ declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, title, className, ...rest }: DocumentDetailsProps): React__default.ReactElement | null;
9181
9211
 
9182
9212
  /**
9183
9213
  * ReplyTree Organism Component
@@ -9198,7 +9228,7 @@ interface ReplyNodeRow {
9198
9228
  collapsed?: boolean;
9199
9229
  replies?: readonly EntityWith<ReplyNodeRow>[];
9200
9230
  }
9201
- interface ReplyTreeProps {
9231
+ interface ReplyTreeProps extends A11yProps {
9202
9232
  nodes: readonly EntityWith<ReplyNodeRow>[];
9203
9233
  maxDepth?: number;
9204
9234
  onVote?: (nodeId: string, vote: VoteValue) => void;
@@ -9238,7 +9268,7 @@ interface BranchingRule extends EventPayload {
9238
9268
  value: string | string[];
9239
9269
  targetQuestionId: string | typeof END_OF_SURVEY;
9240
9270
  }
9241
- interface BranchingLogicBuilderProps {
9271
+ interface BranchingLogicBuilderProps extends A11yProps {
9242
9272
  questions: readonly BranchingQuestion[] | EventPayloadValue;
9243
9273
  /**
9244
9274
  * Rules. Accepts either a typed array (direct consumers) or the runtime
@@ -9246,6 +9276,8 @@ interface BranchingLogicBuilderProps {
9246
9276
  * `[]` internally when the value isn't an array.
9247
9277
  */
9248
9278
  rules: readonly BranchingRule[] | EventPayloadValue;
9279
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
9280
+ surface?: SurfaceMode;
9249
9281
  onRulesChange?: (rules: BranchingRule[]) => void;
9250
9282
  /** Event name dispatched via event bus when rules change. Payload: `{ rules }`. */
9251
9283
  rulesChangeEvent?: EventEmit<{
@@ -9270,7 +9302,7 @@ type CommitKind = 'user' | 'agent' | 'restore' | 'undo' | 'redo' | 'snapshot' |
9270
9302
  *
9271
9303
  * @capabilities version history row, commit entry, revision list item, change log entry, restore point, undo history item
9272
9304
  */
9273
- interface CommitRowProps {
9305
+ interface CommitRowProps extends A11yProps {
9274
9306
  /** Commit id; the first 7 characters are shown, the whole id on hover. */
9275
9307
  sha: string;
9276
9308
  /** Commit message. */
@@ -9318,7 +9350,7 @@ interface ChangeListItem {
9318
9350
  *
9319
9351
  * @capabilities change summary, what changed, version changes, diff summary, release notes list, modification list
9320
9352
  */
9321
- interface ChangeListProps {
9353
+ interface ChangeListProps extends A11yProps {
9322
9354
  /** The changes. Accepts a typed list or a render-ui payload binding. */
9323
9355
  changes: readonly ChangeListItem[] | EventPayloadValue;
9324
9356
  /** Emitted by a change's Inspect button. Payload: { title, type }. */
@@ -9363,7 +9395,7 @@ interface DiffHunk {
9363
9395
  *
9364
9396
  * @capabilities version diff, compare revisions, what changed, before and after, code diff, commit diff, revision comparison
9365
9397
  */
9366
- interface VersionDiffProps {
9398
+ interface VersionDiffProps extends A11yProps {
9367
9399
  /**
9368
9400
  * All available revisions (at least 2). Accepts either a typed array (direct
9369
9401
  * consumers) or the runtime payload shape from a render-ui binding
@@ -9417,7 +9449,7 @@ interface DocBreadcrumbItem {
9417
9449
  /** Navigation href (omit for the current/last item) */
9418
9450
  href?: string;
9419
9451
  }
9420
- interface DocBreadcrumbProps {
9452
+ interface DocBreadcrumbProps extends A11yProps {
9421
9453
  /** Breadcrumb path items, last item is treated as current page */
9422
9454
  items: DocBreadcrumbItem[];
9423
9455
  /** Additional CSS classes */
@@ -9437,7 +9469,7 @@ interface DocPaginationLink {
9437
9469
  href: string;
9438
9470
  category?: string;
9439
9471
  }
9440
- interface DocPaginationProps {
9472
+ interface DocPaginationProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
9441
9473
  /** Previous page link */
9442
9474
  prev?: DocPaginationLink;
9443
9475
  /** Next page link */
@@ -9445,7 +9477,7 @@ interface DocPaginationProps {
9445
9477
  /** Additional class names */
9446
9478
  className?: string;
9447
9479
  }
9448
- declare function DocPagination({ prev, next, className }: DocPaginationProps): React__default.JSX.Element | null;
9480
+ declare function DocPagination({ prev, next, className, ...rest }: DocPaginationProps): React__default.JSX.Element | null;
9449
9481
 
9450
9482
  /**
9451
9483
  * DocSearch — documentation search input with inline results dropdown (distinct from SearchInput).
@@ -9460,7 +9492,7 @@ interface DocSearchResult {
9460
9492
  excerpt?: string;
9461
9493
  category?: string;
9462
9494
  }
9463
- interface DocSearchProps {
9495
+ interface DocSearchProps extends A11yProps {
9464
9496
  /** Placeholder text for the input */
9465
9497
  placeholder?: string;
9466
9498
  /** Callback invoked with the search query, returns results */
@@ -9468,7 +9500,7 @@ interface DocSearchProps {
9468
9500
  /** Additional class names */
9469
9501
  className?: string;
9470
9502
  }
9471
- declare function DocSearch({ placeholder, onSearch, className, }: DocSearchProps): React__default.JSX.Element;
9503
+ declare function DocSearch({ placeholder, onSearch, className, ...rest }: DocSearchProps): React__default.JSX.Element;
9472
9504
 
9473
9505
  /**
9474
9506
  * DocSidebar — collapsible documentation navigation sidebar.
@@ -9487,7 +9519,7 @@ interface DocSidebarItem {
9487
9519
  /** Whether this item is currently active */
9488
9520
  active?: boolean;
9489
9521
  }
9490
- interface DocSidebarProps {
9522
+ interface DocSidebarProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
9491
9523
  /** Sidebar navigation items */
9492
9524
  items: DocSidebarItem[];
9493
9525
  /** Additional CSS classes */
@@ -9510,7 +9542,7 @@ interface DocTOCItem {
9510
9542
  /** Heading level: 2 for h2, 3 for h3, etc. */
9511
9543
  level: number;
9512
9544
  }
9513
- interface DocTOCProps {
9545
+ interface DocTOCProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
9514
9546
  /** Table of contents items */
9515
9547
  items: DocTOCItem[];
9516
9548
  /** Currently active section id */
@@ -9527,7 +9559,7 @@ declare const DocTOC: React__default.FC<DocTOCProps>;
9527
9559
  * Used between major sections for visual separation without hard background-color breaks.
9528
9560
  */
9529
9561
 
9530
- interface GradientDividerProps {
9562
+ interface GradientDividerProps extends A11yProps {
9531
9563
  /** Semantic palette token or a raw CSS color value. Defaults to 'primary'. */
9532
9564
  color?: ColorToken | string;
9533
9565
  /** Additional class names */
@@ -9559,7 +9591,9 @@ interface PageHeaderStatus {
9559
9591
  label: string;
9560
9592
  variant?: "default" | "success" | "warning" | "danger" | "info";
9561
9593
  }
9562
- interface PageHeaderProps {
9594
+ interface PageHeaderProps extends A11yProps {
9595
+ /** The shape an empty slot shows while this header's server render is in flight (`none` opts out). @default 'header' */
9596
+ skeleton?: SkeletonSpec;
9563
9597
  /** Page title - accepts string or number from generated code accessing dynamic entity data */
9564
9598
  title?: string | number;
9565
9599
  /** Icon shown before the title. */
@@ -9595,7 +9629,7 @@ interface PageHeaderProps {
9595
9629
  }
9596
9630
  declare const PageHeader: React__default.FC<PageHeaderProps>;
9597
9631
 
9598
- interface FormSectionProps extends DisplayStateProps {
9632
+ interface FormSectionProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
9599
9633
  /** Section title */
9600
9634
  title?: string;
9601
9635
  /** Section description */
@@ -9615,7 +9649,7 @@ declare const FormSection$1: React__default.FC<FormSectionProps>;
9615
9649
  /**
9616
9650
  * Form layout with multiple sections
9617
9651
  */
9618
- interface FormLayoutProps extends DisplayStateProps {
9652
+ interface FormLayoutProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
9619
9653
  children: React__default.ReactNode;
9620
9654
  /** Show section dividers */
9621
9655
  dividers?: boolean;
@@ -9624,7 +9658,7 @@ declare const FormLayout: React__default.FC<FormLayoutProps>;
9624
9658
  /**
9625
9659
  * Form actions bar (submit/cancel buttons)
9626
9660
  */
9627
- interface FormActionsProps extends DisplayStateProps {
9661
+ interface FormActionsProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
9628
9662
  children: React__default.ReactNode;
9629
9663
  /** Sticky at bottom */
9630
9664
  sticky?: boolean;
@@ -9685,7 +9719,7 @@ interface HeaderUserAvatar {
9685
9719
  alt?: string;
9686
9720
  initials?: string;
9687
9721
  }
9688
- interface HeaderProps {
9722
+ interface HeaderProps extends A11yProps {
9689
9723
  /**
9690
9724
  * Logo/Brand content
9691
9725
  */
@@ -9820,7 +9854,7 @@ interface NavigationItem {
9820
9854
  */
9821
9855
  subMenu?: NavigationItem[];
9822
9856
  }
9823
- interface NavigationProps {
9857
+ interface NavigationProps extends A11yProps {
9824
9858
  /**
9825
9859
  * Navigation items
9826
9860
  */
@@ -9850,7 +9884,7 @@ declare const Navigation: React__default.FC<NavigationProps>;
9850
9884
 
9851
9885
  type SectionPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
9852
9886
  type SectionVariant = 'default' | 'card' | 'bordered' | 'filled';
9853
- interface SectionProps {
9887
+ interface SectionProps extends A11yProps {
9854
9888
  /** Section title */
9855
9889
  title?: string;
9856
9890
  /** Section subtitle/description */
@@ -9915,7 +9949,7 @@ interface SidebarItem {
9915
9949
  /** Sub-items (for nested navigation) */
9916
9950
  subItems?: SidebarItem[];
9917
9951
  }
9918
- interface SidebarProps {
9952
+ interface SidebarProps extends A11yProps {
9919
9953
  /** Additional CSS classes */
9920
9954
  className?: string;
9921
9955
  /** Loading state indicator */
@@ -9962,7 +9996,7 @@ declare const Sidebar: React__default.FC<SidebarProps>;
9962
9996
 
9963
9997
  type SplitRatio = '1:1' | '1:2' | '2:1' | '1:3' | '3:1' | '1:4' | '4:1' | '2:3' | '3:2';
9964
9998
  type SplitGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
9965
- interface SplitProps {
9999
+ interface SplitProps extends A11yProps {
9966
10000
  /** Size ratio between left and right panels */
9967
10001
  ratio?: SplitRatio;
9968
10002
  /** Gap between panels */
@@ -10003,7 +10037,7 @@ declare const Split: React__default.FC<SplitProps>;
10003
10037
  */
10004
10038
 
10005
10039
  type ConfirmDialogVariant = "danger" | "warning" | "info" | "default";
10006
- interface ConfirmDialogProps {
10040
+ interface ConfirmDialogProps extends A11yProps {
10007
10041
  /** Whether the dialog is open (defaults to true when rendered by slot wrapper) */
10008
10042
  isOpen?: boolean;
10009
10043
  /** Callback when dialog is closed (injected by slot wrapper) */
@@ -10173,7 +10207,7 @@ interface WizardStep {
10173
10207
  /** Allow additional properties from schema */
10174
10208
  [key: string]: JsonValue | React__default.ReactNode | WizardSection[] | WizardEntityMapping | WizardValidationRule[] | WizardLawReference[] | (() => boolean) | undefined;
10175
10209
  }
10176
- interface WizardContainerProps {
10210
+ interface WizardContainerProps extends A11yProps {
10177
10211
  /** Wizard steps */
10178
10212
  steps: WizardStep[];
10179
10213
  /** Current step index (controlled) - accepts number or string for generated code compatibility */
@@ -10246,7 +10280,7 @@ interface OrbitalVisualizationSchemaSummary {
10246
10280
  /** Trait count. */
10247
10281
  traits?: number;
10248
10282
  }
10249
- interface OrbitalVisualizationProps {
10283
+ interface OrbitalVisualizationProps extends A11yProps {
10250
10284
  /** Complexity-scoring summary of a KFlow schema (counts only — see
10251
10285
  * {@link OrbitalVisualizationSchemaSummary}). */
10252
10286
  schema?: OrbitalVisualizationSchemaSummary;
@@ -10274,7 +10308,7 @@ declare const OrbitalVisualization: React__default.FC<OrbitalVisualizationProps>
10274
10308
  * machine drawn with gear-shaped states, from an orbital schema or one trait.
10275
10309
  */
10276
10310
 
10277
- interface JazariStateMachineProps {
10311
+ interface JazariStateMachineProps extends A11yProps {
10278
10312
  /** Additional CSS classes */
10279
10313
  className?: string;
10280
10314
  /** Loading state indicator */
@@ -10306,7 +10340,7 @@ declare const JazariStateMachine: React__default.FC<JazariStateMachineProps>;
10306
10340
  * - entityAware: false
10307
10341
  */
10308
10342
 
10309
- interface ContentRendererProps extends DisplayStateProps {
10343
+ interface ContentRendererProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
10310
10344
  /** Raw content string — auto-parsed into segments */
10311
10345
  content?: string;
10312
10346
  /** Pre-parsed segments (overrides content) */
@@ -10376,7 +10410,9 @@ interface ChartAction {
10376
10410
  navigatesTo?: string;
10377
10411
  variant?: "primary" | "secondary" | "ghost";
10378
10412
  }
10379
- interface ChartProps {
10413
+ interface ChartProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
10414
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
10415
+ surface?: SurfaceMode;
10380
10416
  /** Chart title */
10381
10417
  title?: string;
10382
10418
  /** Chart subtitle / description */
@@ -10417,6 +10453,8 @@ interface ChartProps {
10417
10453
  actions?: readonly ChartAction[];
10418
10454
  /** Loading state */
10419
10455
  isLoading?: boolean;
10456
+ /** Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out). */
10457
+ skeleton?: SkeletonSpec;
10420
10458
  /** Error state */
10421
10459
  error?: UiError | null;
10422
10460
  /** Additional CSS classes */
@@ -10445,7 +10483,7 @@ declare const Chart: React__default.FC<ChartProps>;
10445
10483
  *
10446
10484
  * @capabilities e-signature capture, sign-here field, consent signature, initial-here field, wet-signature substitute
10447
10485
  */
10448
- interface SignaturePadProps {
10486
+ interface SignaturePadProps extends A11yProps {
10449
10487
  /** Label above the pad */
10450
10488
  label?: string;
10451
10489
  /** Helper text */
@@ -10503,7 +10541,9 @@ interface DocumentItem {
10503
10541
  content?: string;
10504
10542
  documentType?: DocumentType;
10505
10543
  }
10506
- interface DocumentViewerProps {
10544
+ interface DocumentViewerProps extends A11yProps {
10545
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
10546
+ surface?: SurfaceMode;
10507
10547
  /** Document title */
10508
10548
  title?: string;
10509
10549
  /** Document URL (for PDF/external documents) */
@@ -10598,7 +10638,9 @@ interface GraphAction {
10598
10638
  navigatesTo?: string;
10599
10639
  variant?: "primary" | "secondary" | "ghost";
10600
10640
  }
10601
- interface GraphCanvasProps {
10641
+ interface GraphCanvasProps extends A11yProps {
10642
+ /** Text alternative for the graph, rendered as visually hidden text and linked by aria-describedby. */
10643
+ description?: string;
10602
10644
  /** Graph title */
10603
10645
  title?: string;
10604
10646
  /** Graph nodes */
@@ -10683,7 +10725,7 @@ interface ImportSourceOption {
10683
10725
  /** Disable the option */
10684
10726
  disabled?: boolean;
10685
10727
  }
10686
- interface ImportSourcePickerProps {
10728
+ interface ImportSourcePickerProps extends A11yProps {
10687
10729
  /** Source options to render */
10688
10730
  sources: ImportSourceOption[];
10689
10731
  /** Called with the source id when an 'action' option is picked */
@@ -10728,7 +10770,9 @@ interface ImportEntityDisplay {
10728
10770
  singular: string;
10729
10771
  plural: string;
10730
10772
  }
10731
- interface ImportPreviewTreeProps {
10773
+ interface ImportPreviewTreeProps extends A11yProps {
10774
+ /** Content surface: `auto` paints the theme's surface behind each group tile unless it already sits on one (a card, dialog or another block); `none` opts out. */
10775
+ surface?: SurfaceMode;
10732
10776
  /** Staged units to preview */
10733
10777
  units: ImportPreviewUnit[];
10734
10778
  /** Elements skipped during extraction, with reasons */
@@ -10765,7 +10809,7 @@ interface ImportProgressCounts {
10765
10809
  committed?: number;
10766
10810
  failed?: number;
10767
10811
  }
10768
- interface ImportProgressProps {
10812
+ interface ImportProgressProps extends A11yProps {
10769
10813
  /** Current lifecycle step */
10770
10814
  step: ImportProgressStep;
10771
10815
  /** Unit counts */
@@ -10788,7 +10832,7 @@ declare const ImportProgress: React__default.FC<ImportProgressProps>;
10788
10832
  * - entityAware: false
10789
10833
  */
10790
10834
 
10791
- interface ActivationBlockProps {
10835
+ interface ActivationBlockProps extends A11yProps {
10792
10836
  /** The prior-knowledge question */
10793
10837
  question: string;
10794
10838
  /** Pre-filled response from saved state */
@@ -10810,7 +10854,7 @@ declare const ActivationBlock: React__default.FC<ActivationBlockProps>;
10810
10854
  * - entityAware: false
10811
10855
  */
10812
10856
 
10813
- interface ReflectionBlockProps {
10857
+ interface ReflectionBlockProps extends A11yProps {
10814
10858
  /** The reflection prompt */
10815
10859
  prompt: string;
10816
10860
  /** Zero-based index of this block (used in the emitted event payload) */
@@ -10835,7 +10879,7 @@ declare const ReflectionBlock: React__default.FC<ReflectionBlockProps>;
10835
10879
  * - entityAware: false
10836
10880
  */
10837
10881
 
10838
- interface ConnectionBlockProps {
10882
+ interface ConnectionBlockProps extends A11yProps {
10839
10883
  /** Markdown content summarising what the learner already knows */
10840
10884
  content: string;
10841
10885
  /** Additional CSS classes */
@@ -10866,7 +10910,7 @@ interface CodeSimulationOutput {
10866
10910
  passed: boolean;
10867
10911
  }>;
10868
10912
  }
10869
- interface CodeRunnerPanelProps {
10913
+ interface CodeRunnerPanelProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
10870
10914
  /** Initial code content */
10871
10915
  code: string;
10872
10916
  /** Programming language for syntax highlighting */
@@ -10910,7 +10954,7 @@ interface LessonUserProgress {
10910
10954
  reflectionNotes?: string[];
10911
10955
  bloomAnswered?: Record<number, boolean>;
10912
10956
  }
10913
- interface SegmentRendererProps {
10957
+ interface SegmentRendererProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
10914
10958
  /** Parsed lesson segments (see `parseLessonSegments`) */
10915
10959
  segments: LessonSegment[];
10916
10960
  /** Additional CSS classes for the root container */
@@ -10976,7 +11020,7 @@ interface FloatingToolbarItem {
10976
11020
  testId?: string;
10977
11021
  }
10978
11022
  type FloatingToolbarPosition = "bottom-center" | "bottom-left" | "bottom-right" | "top-center" | "top-left" | "top-right";
10979
- interface FloatingToolbarProps {
11023
+ interface FloatingToolbarProps extends A11yProps {
10980
11024
  /** Tool items rendered as icon buttons */
10981
11025
  items: FloatingToolbarItem[];
10982
11026
  /**
@@ -10991,96 +11035,94 @@ interface FloatingToolbarProps {
10991
11035
  }
10992
11036
  declare const FloatingToolbar: React__default.FC<FloatingToolbarProps>;
10993
11037
 
10994
- type EntityTableLook = "dense" | "spacious" | "striped" | "borderless" | "card-rows";
10995
- interface Column<T> {
10996
- /** Column identity. Optional because `name` is an accepted alias; the
10997
- * compiler emits `{ name, label }` columns and `normalizeColumns` fills
10998
- * `key`/`header` from the aliases, so a column needs (`key` OR `name`) and
10999
- * (`header` OR `label`), not literally `key`+`header`. */
11000
- key?: keyof T | string;
11001
- header?: string;
11002
- /** Alias for key (used by compiler-generated fields) */
11003
- name?: string;
11004
- /** Alias for header (used by compiler-generated fields) */
11005
- label?: string;
11006
- width?: string;
11007
- sortable?: boolean;
11008
- /** Horizontal alignment of the column's header and cells */
11009
- align?: "left" | "center" | "right";
11010
- /** Value format (locale-aware) */
11011
- format?: DisplayFieldFormat;
11012
- render?: (value: FieldValue | undefined, row: T, index: number) => React__default.ReactNode;
11038
+ /**
11039
+ * AgentActivityFeed Molecule
11040
+ *
11041
+ * The one row renderer for the agent's activities (`@almadar/core`
11042
+ * `TraceActivity`, mapped by rabit's `mapSSEToTraceActivities`). Every
11043
+ * persona's chat surface mounts it with the activities its manifest's
11044
+ * `activity` audience selects.
11045
+ */
11046
+
11047
+ /** Where an activity's "jump to" affordance should take a canvas. */
11048
+ interface AgentActivityJumpTarget {
11049
+ orbital: string;
11050
+ trait?: string;
11051
+ transition?: string;
11013
11052
  }
11014
- interface RowAction<T> {
11015
- label: string;
11016
- icon?: IconInput;
11017
- /** Optional when `event` is set — a bus-emitting onClick is synthesized. */
11018
- onClick?: (row: T) => void;
11019
- variant?: "default" | "danger";
11020
- show?: (row: T) => boolean;
11021
- event?: EventKey;
11022
- /** Per-row condition, authored as `(fn row <bool>)`; composes with `show`. Omit = always shown. */
11023
- when?: RowActionCondition;
11053
+ /** What a row can only know from the list it sits in. */
11054
+ interface RowFacts {
11055
+ /** An `orbital_started` whose run has finished (an `orbital_done` for it follows). */
11056
+ settled: boolean;
11057
+ /** At a `done` row: how many orbitals this run finished (its own "ready" rows). */
11058
+ readyCount: number;
11024
11059
  }
11025
- type DataTableEmptyAction = EmptyStateAction;
11026
11060
  /**
11027
- * @fieldsContract display
11061
+ * Per-item facts for a feed. Each `orbital_done` settles the latest still-open
11062
+ * start of its orbital (an orbital can be built more than once); each `done`
11063
+ * counts the distinct orbitals that finished since the previous `done`.
11064
+ * Non-activity items (`activityOf` → null) get neutral facts.
11028
11065
  */
11029
- interface DataTableProps<T extends EntityRow & {
11030
- id: string | number;
11031
- }> extends DisplayStateProps {
11032
- /** Entity rows to display (collection cardinality). */
11033
- entity?: readonly EntityRow[];
11034
- /** Fields to display - accepts string[] or Column[] for unified interface. Alias for columns */
11035
- fields: readonly Column<T>[] | readonly string[];
11036
- /** Columns can be Column objects or simple string field names */
11037
- columns?: readonly Column<T>[] | readonly string[];
11038
- /** When set, rows are activatable and emit UI:{itemClickEvent} with { id, row } */
11039
- /** @entityRow row */
11040
- itemClickEvent?: EventEmit<ItemActionPayload>;
11041
- /** Item actions from generated code - maps to rowActions */
11042
- itemActions?: readonly {
11043
- label: string;
11044
- event?: EventKey;
11045
- navigatesTo?: string;
11046
- placement?: "row" | "bulk" | string;
11047
- icon?: IconInput;
11048
- variant?: "default" | "primary" | "secondary" | "ghost" | "danger" | string;
11049
- onClick?: (row: T) => void;
11050
- /** Per-row condition, authored as `(fn row <bool>)`: the row's action is drawn only when it returns true. Omit = always shown. */
11051
- when?: RowActionCondition;
11052
- }[];
11053
- emptyIcon?: IconInput;
11066
+ declare function activityRowFacts<T>(items: readonly T[], activityOf: (item: T) => TraceActivity | null): RowFacts[];
11067
+ interface AgentActivityRowProps {
11068
+ activity: TraceActivity;
11069
+ /** "Jump to" affordance — rendered only when supplied and the activity names an orbital. */
11070
+ onJump?: (target: AgentActivityJumpTarget) => void;
11071
+ /** What the row knows from its list (`activityRowFacts`). */
11072
+ facts: RowFacts;
11073
+ }
11074
+ declare function AgentActivityRow({ activity, onJump, facts }: AgentActivityRowProps): React__default.ReactElement;
11075
+ declare namespace AgentActivityRow {
11076
+ var displayName: string;
11077
+ }
11078
+ /** Shown at the end of a feed while the agent works, so a long LLM call never looks idle. */
11079
+ declare function AgentThinkingRow(): React__default.ReactElement;
11080
+ /** One conversation: the user's prompt and everything the agent did for it. */
11081
+ interface AgentConversation {
11082
+ /** The prompt that started it; undefined for activity recorded before any prompt. */
11083
+ prompt?: string;
11084
+ startedAt: number;
11085
+ activities: TraceActivity[];
11086
+ }
11087
+ /** Split a feed into conversations, each starting at a user prompt. */
11088
+ declare function groupIntoConversations(activities: readonly TraceActivity[]): AgentConversation[];
11089
+ interface AgentActivityFeedProps {
11090
+ activities: readonly TraceActivity[];
11091
+ /** The agent is running: show the thinking row after the last activity. */
11092
+ working?: boolean;
11093
+ onJump?: (target: AgentActivityJumpTarget) => void;
11054
11094
  emptyTitle?: string;
11055
11095
  emptyDescription?: string;
11056
- emptyAction?: DataTableEmptyAction;
11057
- selectable?: boolean;
11058
- searchable?: boolean;
11059
- searchPlaceholder?: string;
11060
- rowActions?: readonly RowAction<T>[];
11061
- bulkActions?: ReadonlyArray<{
11062
- label: string;
11063
- icon?: IconInput;
11064
- /** Optional when `event` is set — a bus-emitting onClick is synthesized. */
11065
- onClick?: (selectedRows: T[]) => void;
11066
- variant?: "default" | "danger";
11067
- event?: EventKey;
11068
- }>;
11069
- headerActions?: React__default.ReactNode;
11070
- /** Show total count in pagination */
11071
- showTotal?: boolean;
11072
- /** Layer 2 visual treatment — orthogonal to the semantic variant. */
11073
- look?: EntityTableLook;
11074
- /** Relation display data: { fieldName: [{value, label}] } — injected
11075
- * server-side by the runtime (relation-option injection) or bound by
11076
- * compiled codegen; resolves stored foreign ids to display names for a
11077
- * column whose field is relation-typed. Same contract DetailPanel takes. */
11078
- relationsData?: Record<string, readonly RelationOption[]>;
11096
+ /** Scroll the latest row into view as rows arrive. Off for a list of feeds (a run history). @default true */
11097
+ followLatest?: boolean;
11098
+ className?: string;
11079
11099
  }
11080
- declare function DataTable<T extends EntityRow & {
11081
- id: string | number;
11082
- }>({ fields, columns, entity, itemActions, itemClickEvent, isLoading, error, emptyIcon, emptyTitle, emptyDescription, emptyAction, selectable, selectedIds, sortBy, sortDirection, searchable, searchValue, searchPlaceholder, page, pageSize, totalCount, rowActions: externalRowActions, bulkActions, headerActions, showTotal, className, look, relationsData, }: DataTableProps<T>): React__default.JSX.Element;
11083
- declare namespace DataTable {
11100
+ declare function AgentActivityFeed({ activities, working, onJump, emptyTitle, emptyDescription, followLatest, className }: AgentActivityFeedProps): React__default.ReactElement;
11101
+ declare namespace AgentActivityFeed {
11102
+ var displayName: string;
11103
+ }
11104
+
11105
+ /**
11106
+ * AgentChatFeed — a chat region's view of an agent turn: the activities the
11107
+ * host's audience selected, rendered by `AgentActivityFeed`, with raw LLM
11108
+ * responses behind a "Raw LLM" switch (off by default, so the conversation
11109
+ * stays readable until they're wanted). The switch is remembered per host.
11110
+ */
11111
+
11112
+ interface AgentChatFeedProps {
11113
+ /** Activities already selected by the host's manifest audience. */
11114
+ activities: readonly TraceActivity[];
11115
+ emptyTitle: string;
11116
+ /** localStorage key remembering the Raw LLM switch for this host. */
11117
+ rawLlmPreferenceKey: string;
11118
+ /** Prefix for the toolbar test id and the switch's element id. */
11119
+ idPrefix: string;
11120
+ /** The agent is running — the feed shows it is thinking. */
11121
+ working?: boolean;
11122
+ className?: string;
11123
+ }
11124
+ declare function AgentChatFeed({ activities, emptyTitle, rawLlmPreferenceKey, idPrefix, working, className }: AgentChatFeedProps): React__default.ReactElement;
11125
+ declare namespace AgentChatFeed {
11084
11126
  var displayName: string;
11085
11127
  }
11086
11128
 
@@ -11107,7 +11149,7 @@ interface MetricDefinition {
11107
11149
  equals: string | number | boolean;
11108
11150
  };
11109
11151
  }
11110
- interface StatCardProps extends DisplayStateProps {
11152
+ interface StatCardProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11111
11153
  /** Entity data (single record or collection) used to compute metrics. */
11112
11154
  entity?: EntityRow | readonly EntityRow[];
11113
11155
  /** Main label */
@@ -11150,9 +11192,119 @@ interface StatCardProps extends DisplayStateProps {
11150
11192
  compact?: boolean;
11151
11193
  /** Sparkline data points for an inline trend chart */
11152
11194
  sparklineData?: readonly number[];
11195
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
11196
+ surface?: SurfaceMode;
11153
11197
  }
11154
11198
  declare const StatCard: React__default.FC<StatCardProps>;
11155
11199
 
11200
+ /**
11201
+ * Timeline Organism Component
11202
+ *
11203
+ * A vertical timeline component for displaying chronological events.
11204
+ * Composes atoms and molecules for layout, uses CSS variables for theming.
11205
+ *
11206
+ * Orbital Component Interface Compliance:
11207
+ * - Entity binding with auto-fetch when entity is a string
11208
+ * - Event emission via useEventBus (UI:* events)
11209
+ * - isLoading and error state props
11210
+ * - className for external styling
11211
+ */
11212
+
11213
+ type TimelineItemStatus = "complete" | "active" | "pending" | "error";
11214
+ /**
11215
+ * Layer 2 visual treatment for the timeline pattern — orthogonal to the
11216
+ * semantic status conveyed by per-item style.
11217
+ */
11218
+ type TimelineLook = "vertical-compact" | "vertical-spacious" | "horizontal" | "swimlane";
11219
+ interface TimelineItem {
11220
+ /** Unique identifier */
11221
+ id: string;
11222
+ /** Item title */
11223
+ title: string;
11224
+ /** Item description */
11225
+ description?: string;
11226
+ /** Timestamp string */
11227
+ date?: string;
11228
+ /** Status indicator */
11229
+ status?: TimelineItemStatus;
11230
+ /** Icon override */
11231
+ icon?: IconInput;
11232
+ /** Additional metadata tags */
11233
+ tags?: readonly string[];
11234
+ }
11235
+ interface TimelineAction {
11236
+ label: string;
11237
+ event?: EventKey;
11238
+ navigatesTo?: string;
11239
+ variant?: "primary" | "secondary" | "ghost";
11240
+ }
11241
+ interface TimelineProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11242
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
11243
+ surface?: SurfaceMode;
11244
+ /** Additional CSS classes */
11245
+ className?: string;
11246
+ /** Loading state indicator */
11247
+ isLoading?: boolean;
11248
+ /** Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out). */
11249
+ skeleton?: SkeletonSpec;
11250
+ /** Error state */
11251
+ error?: UiError | null;
11252
+ /**
11253
+ * Schema entity data typed against @almadar/core's EntityRow. Items from
11254
+ * `entity` are normalised into `items` when `items` is omitted. UI-specific
11255
+ * TimelineItem fields (`icon`, callbacks) cannot round-trip through the
11256
+ * event bus, so decorative stories that need them pass `items` directly.
11257
+ */
11258
+ entity?: EntityRow | readonly EntityRow[];
11259
+ /** Timeline title */
11260
+ title?: string;
11261
+ /** Timeline items */
11262
+ items?: readonly TimelineItem[];
11263
+ /** Entity fields the timeline draws; each slot is named by its own `*Field` prop. */
11264
+ fields?: readonly string[];
11265
+ /** Entity field holding each item's title. */
11266
+ titleField?: string;
11267
+ /** Entity field holding each item's description. */
11268
+ descriptionField?: string;
11269
+ /** Entity field holding each item's date. */
11270
+ dateField?: string;
11271
+ /** Entity field holding each item's status (complete | active | pending | error). */
11272
+ statusField?: string;
11273
+ /** Actions per item */
11274
+ itemActions?: readonly TimelineAction[];
11275
+ /** Layer 2 visual treatment. */
11276
+ look?: TimelineLook;
11277
+ }
11278
+ declare const Timeline: React__default.FC<TimelineProps>;
11279
+
11280
+ /**
11281
+ * Page variants of a record detail. DetailPanel computes the pieces of a
11282
+ * record page (header, key figures, field sections, prose, footer) and the
11283
+ * declared region data; a look only ARRANGES them, composing the existing
11284
+ * core components — it never fetches and never infers a region from data.
11285
+ */
11286
+
11287
+ /**
11288
+ * panel = labelled-field record (default) · profile = person/member hero ·
11289
+ * showcase = image-first product/listing · workflow = lifecycle stepper +
11290
+ * activity (+ declared line items) · map = location hero · ledger = document with line items and
11291
+ * totals · conversation = thread beside the record facts · workspace = tabbed
11292
+ * record.
11293
+ */
11294
+ type DetailLook = 'panel' | 'profile' | 'showcase' | 'workflow' | 'map' | 'ledger' | 'conversation' | 'workspace';
11295
+ /** One stage of a declared lifecycle, in order. */
11296
+ interface DetailStage {
11297
+ value: string;
11298
+ label: string;
11299
+ }
11300
+ /** One workspace tab: the declared fields it shows, or content composed in (e.g. a related list's trait). */
11301
+ interface DetailTab {
11302
+ id: string;
11303
+ label: string;
11304
+ fields?: readonly string[];
11305
+ content?: React__default.ReactNode;
11306
+ }
11307
+
11156
11308
  /**
11157
11309
  * DetailPanel Organism Component
11158
11310
  *
@@ -11197,6 +11349,8 @@ interface DetailPanelAction {
11197
11349
  variant?: "primary" | "secondary" | "ghost" | "danger";
11198
11350
  /** Condition over the panel's record, authored as `(fn row <bool>)`: the button is drawn only when it returns true. Omit = always shown. */
11199
11351
  when?: RowActionCondition;
11352
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. Omit = `{ id, row }`. */
11353
+ payload?: RowActionPayload;
11200
11354
  }
11201
11355
  /** Schema metadata the runtime's detail enrichment (UISlotRenderer) or the
11202
11356
  * compiled path's codegen injects onto a field. */
@@ -11211,7 +11365,7 @@ interface DetailFieldSchema {
11211
11365
  * field fills — title (`h3`/`h4`), header badge (`badge`), progress bar
11212
11366
  * (`progress`), prose block (`body`), date, metric — is declared here.
11213
11367
  */
11214
- type FieldDef$2 = string | (DisplayField & DetailFieldSchema) | (Pick<DisplayField, "variant" | "format" | "colorMap"> & DetailFieldSchema & {
11368
+ type FieldDef = string | (DisplayField & DetailFieldSchema) | (Pick<DisplayField, "variant" | "format" | "colorMap"> & DetailFieldSchema & {
11215
11369
  key: string;
11216
11370
  header?: string;
11217
11371
  });
@@ -11224,7 +11378,9 @@ interface DetailPanelStatus {
11224
11378
  *
11225
11379
  * @fieldsContract display
11226
11380
  */
11227
- interface DetailPanelProps extends DisplayStateProps {
11381
+ interface DetailPanelProps extends DisplayStateProps, A11yProps {
11382
+ /** Skeleton drawn while loading, and the shape an empty slot shows while this element's server render is in flight (`none` opts out). */
11383
+ skeleton?: SkeletonSpec;
11228
11384
  /** RECORD-cardinality: renders ONE record (see body collapse below). */
11229
11385
  entity?: EntityRow;
11230
11386
  title?: string;
@@ -11260,8 +11416,10 @@ interface DetailPanelProps extends DisplayStateProps {
11260
11416
  closeEvent?: EventKey;
11261
11417
  footer?: React__default.ReactNode;
11262
11418
  slideOver?: boolean;
11419
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. Inline mode only; the slide-over is itself a surface. */
11420
+ surface?: SurfaceMode;
11263
11421
  /** Fields to display: field names, or declared fields ({ name, label, variant, format, colorMap, labels }) */
11264
- fields: readonly (FieldDef$2 | DetailField)[];
11422
+ fields: readonly (FieldDef | DetailField)[];
11265
11423
  /** Alias for fields - backwards compatibility */
11266
11424
  fieldNames?: readonly string[];
11267
11425
  /** Initial data for edit mode (passed by compiler) */
@@ -11281,6 +11439,39 @@ interface DetailPanelProps extends DisplayStateProps {
11281
11439
  * server-side by the runtime (relation-option injection) or bound by
11282
11440
  * compiled codegen; resolves stored foreign ids to display names. */
11283
11441
  relationsData?: Record<string, readonly RelationOption[]>;
11442
+ /** Page variant: panel (labelled fields, default), profile (person/member hero), showcase (image-first product/listing), workflow (lifecycle stepper + activity), map (location hero), ledger (document with line items + totals), conversation (thread beside the record), workspace (tabbed record). */
11443
+ look?: DetailLook;
11444
+ /** Record field holding the avatar image. The profile look always shows an avatar, with the title's initials when this is unset or empty. */
11445
+ avatarField?: string;
11446
+ /** Record field holding the cover image (profile). */
11447
+ coverField?: string;
11448
+ /** Record field holding the image, or list of images, the showcase look leads with. */
11449
+ mediaField?: string;
11450
+ /** Record field holding the current lifecycle stage (workflow). */
11451
+ stageField?: string;
11452
+ /** The lifecycle in order, `{ value, label }` per stage (workflow). */
11453
+ stages?: readonly DetailStage[];
11454
+ /** Activity entries shown under the record (workflow). */
11455
+ activity?: readonly TimelineItem[];
11456
+ /** Activity composed in instead of `activity` — e.g. the record's own history trait (workflow). */
11457
+ activityContent?: React__default.ReactNode;
11458
+ /** Record fields holding the location (map). */
11459
+ latitudeField?: string;
11460
+ longitudeField?: string;
11461
+ /** Child rows shown as the document's line items (ledger). */
11462
+ lineItems?: readonly EntityRow[];
11463
+ /** Columns of the line-items table (ledger). */
11464
+ lineItemColumns?: readonly TableViewColumn[];
11465
+ /** Line items composed in instead of `lineItems` — e.g. the child rows' own trait (ledger). */
11466
+ lineItemsContent?: React__default.ReactNode;
11467
+ /** Record fields shown as the document's totals, in order (ledger). */
11468
+ totals?: readonly DisplayField[];
11469
+ /** The thread shown as the main surface (conversation). */
11470
+ thread?: readonly EntityWith<ReplyNodeRow>[];
11471
+ /** The thread composed in instead of `thread` — e.g. the replies' own trait with its composer (conversation). */
11472
+ threadContent?: React__default.ReactNode;
11473
+ /** Tabs after the overview tab, each listing declared field names (workspace). */
11474
+ tabs?: readonly DetailTab[];
11284
11475
  }
11285
11476
  declare const DetailPanel: React__default.FC<DetailPanelProps>;
11286
11477
 
@@ -11432,7 +11623,11 @@ interface SchemaFieldOverride {
11432
11623
  *
11433
11624
  * @fieldsContract form
11434
11625
  */
11435
- interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
11626
+ interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormElement>, "onSubmit" | keyof A11yProps>, A11yProps {
11627
+ /** Content surface: `auto` paints the theme's surface (with card padding) behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
11628
+ surface?: SurfaceMode;
11629
+ /** The shape an empty slot shows while this form's server render is in flight (`none` opts out). @default 'form' */
11630
+ skeleton?: SkeletonSpec;
11436
11631
  /** Form fields (traditional React children) */
11437
11632
  children?: React__default.ReactNode;
11438
11633
  /** Submit event name for trait dispatch (emitted via eventBus as UI:{onSubmit}) */
@@ -11510,198 +11705,6 @@ interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormEleme
11510
11705
  }
11511
11706
  declare const Form: React__default.FC<FormProps>;
11512
11707
 
11513
- /**
11514
- * List Organism Component
11515
- *
11516
- * A beautifully designed, scannable list view.
11517
- *
11518
- * Design inspiration: Linear, Notion, Apple Reminders
11519
- * - Soft, harmonious color palette
11520
- * - Refined typography with proper hierarchy
11521
- * - Subtle shadows and depth
11522
- * - Delightful hover micro-interactions
11523
- * - Elegant status indicators
11524
- *
11525
- * Closed Circuit Compliance (Dumb Organism):
11526
- * - Receives ALL data via props (no internal fetch)
11527
- * - Emits events via useEventBus (UI:SELECT, UI:DESELECT, UI:VIEW)
11528
- * - Never listens to events — only emits
11529
- * - No internal search/filter state — trait provides filtered data
11530
- */
11531
-
11532
- type ListItem = {
11533
- id: string;
11534
- title?: string;
11535
- description?: string;
11536
- icon?: IconInput;
11537
- avatar?: {
11538
- src?: AssetUrl;
11539
- alt?: string;
11540
- initials?: string;
11541
- };
11542
- badge?: string | number;
11543
- metadata?: React__default.ReactNode;
11544
- onClick?: () => void;
11545
- disabled?: boolean;
11546
- completed?: boolean;
11547
- _fields?: Record<string, FieldValue | undefined>;
11548
- };
11549
- interface SchemaItemAction {
11550
- label: string;
11551
- /** Event to dispatch on click */
11552
- event?: EventKey;
11553
- navigatesTo?: string;
11554
- /** Action placement - accepts all common placement values */
11555
- placement?: "row" | "bulk" | "card" | "footer" | string;
11556
- variant?: "primary" | "secondary" | "ghost" | "danger" | "default";
11557
- /** Declaring an icon draws the action as an inline icon button; actions without one go in the overflow menu. */
11558
- icon?: IconInput;
11559
- /** Click handler from generated code */
11560
- onClick?: (row: EntityRow) => void;
11561
- /** Per-row condition, authored as `(fn row <bool>)`: the row's action is drawn only when it returns true. Omit = always shown. */
11562
- when?: RowActionCondition;
11563
- }
11564
- /** A field is a plain name or a declared {@link DisplayField}. */
11565
- type FieldDef$1 = string | DisplayField;
11566
- interface ListProps extends DisplayStateProps {
11567
- /** Entity data (single record or collection). */
11568
- entity?: EntityRow | readonly EntityRow[];
11569
- /** Entity type name for display */
11570
- entityType?: string;
11571
- selectable?: boolean;
11572
- /** Item actions - schema-driven or function-based */
11573
- itemActions?: ((item: ListItem) => MenuItem[]) | readonly SchemaItemAction[];
11574
- showDividers?: boolean;
11575
- variant?: "default" | "card";
11576
- emptyMessage?: string;
11577
- /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
11578
- renderItem?: (item: ListItem, index: number) => React__default.ReactNode;
11579
- children?: React__default.ReactNode;
11580
- /** Fields to display: field names, or declared fields ({ name, label, variant, format, colorMap, labels }) */
11581
- fields: readonly FieldDef$1[];
11582
- /** Alias for fields - backwards compatibility */
11583
- fieldNames?: readonly string[];
11584
- /** When set, clicking a row emits UI:{itemClickEvent} with { id, row }. Omit = rows are not clickable. */
11585
- /** @entityRow row */
11586
- itemClickEvent?: EventEmit<ItemActionPayload>;
11587
- /** Row field that marks an item completed (`true` strikes its title through) */
11588
- completedField?: string;
11589
- /** Row field that marks an item disabled (`true` dims the row and disables its click) */
11590
- disabledField?: string;
11591
- }
11592
- declare const List: React__default.FC<ListProps>;
11593
-
11594
- /**
11595
- * CardGrid Component
11596
- *
11597
- * A dumb, responsive grid specifically designed for card layouts.
11598
- * Uses CSS Grid auto-fit for automatic responsive columns.
11599
- *
11600
- * Data comes exclusively from the `entity` prop (injected by the runtime).
11601
- * All user interactions emit events via useEventBus. Never manages internal state
11602
- * for pagination, filtering, or search. All state is owned by the trait state machine.
11603
- */
11604
-
11605
- type CardGridGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
11606
- /**
11607
- * Action configuration for card items (schema-driven)
11608
- */
11609
- interface CardItemAction {
11610
- /** Action button label */
11611
- label: string;
11612
- /** Event to dispatch on click (schema metadata) */
11613
- event?: EventKey;
11614
- /** Navigation URL - supports template interpolation like "/products/{{row.id}}" */
11615
- navigatesTo?: string;
11616
- /** Callback on click */
11617
- onClick?: (item: EventPayload) => void;
11618
- /** Action placement - accepts string for compatibility with generated code */
11619
- placement?: 'card' | 'footer' | 'row' | string;
11620
- /** Button variant - accepts string for compatibility with generated code */
11621
- variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | string;
11622
- /** Per-row condition, authored as `(fn row <bool>)`: the card's button is drawn only when it returns true. Omit = always shown. */
11623
- when?: RowActionCondition;
11624
- }
11625
- /** A field is a plain name or a declared {@link DisplayField}. */
11626
- type FieldDef = string | DisplayField;
11627
- interface CardGridProps extends DisplayStateProps {
11628
- /** Entity data (single record or collection). */
11629
- entity?: EntityRow | readonly EntityRow[];
11630
- /** Minimum width of each card (default: 280px) */
11631
- minCardWidth?: number;
11632
- /** Maximum number of columns */
11633
- maxCols?: 1 | 2 | 3 | 4 | 5 | 6;
11634
- /** Gap between cards */
11635
- gap?: CardGridGap;
11636
- /** Align cards vertically in their cells */
11637
- alignItems?: 'start' | 'center' | 'end' | 'stretch';
11638
- /** Children elements (cards) - optional when using entity prop */
11639
- children?: React__default.ReactNode;
11640
- /** Fields to display - required for schema-driven rendering */
11641
- fields: readonly FieldDef[];
11642
- /** Alias for fields - backwards compatibility */
11643
- fieldNames?: readonly string[];
11644
- /** Alias for fields - backwards compatibility */
11645
- columns?: readonly FieldDef[];
11646
- /** When set, clicking a card emits UI:{itemClickEvent} with { id, row }. Omit = cards are not clickable. */
11647
- /** @entityRow row */
11648
- itemClickEvent?: EventEmit<ItemActionPayload>;
11649
- /** Actions for each card item (schema-driven) */
11650
- itemActions?: readonly CardItemAction[];
11651
- /** Show total count in pagination */
11652
- showTotal?: boolean;
11653
- /** Show avatar/image field on cards */
11654
- showAvatar?: boolean;
11655
- /** Visual variant for the card grid */
11656
- variant?: string;
11657
- /** Entity field name containing an image URL to display as card thumbnail */
11658
- imageField?: string;
11659
- }
11660
- /**
11661
- * CardGrid - Responsive card collection layout
11662
- *
11663
- * Can be used in two ways:
11664
- * 1. With children: <CardGrid><Card>...</Card></CardGrid>
11665
- * 2. With entity data: <CardGrid entity={tasks} fields={['title', 'status']} />
11666
- *
11667
- * All data comes from the `entity` prop. Pagination display hints come from
11668
- * `page`, `pageSize`, and `totalCount` props (set by the trait via render-ui).
11669
- */
11670
- declare const CardGrid: React__default.FC<CardGridProps>;
11671
-
11672
- /**
11673
- * MasterDetail Component
11674
- *
11675
- * A layout pattern that shows a list/table of entities.
11676
- * This is a thin wrapper around DataTable that accepts master-detail specific props.
11677
- *
11678
- * The `entity` prop carries the data array (injected by the runtime).
11679
- * The "detail" part is typically rendered separately via another render_ui effect
11680
- * to a sidebar or detail panel when an item is selected.
11681
- */
11682
-
11683
- interface MasterDetailProps<T extends EntityRow & {
11684
- id: string | number;
11685
- } = EntityRow & {
11686
- id: string | number;
11687
- }> extends DisplayStateProps {
11688
- /** Entity rows to display in the master list (collection cardinality). */
11689
- entity?: readonly EntityRow[];
11690
- /** Fields to show in the master list (maps to DataTable columns) */
11691
- masterFields: readonly string[];
11692
- /** Fields for detail view (passed through but typically handled by separate render_ui) */
11693
- detailFields?: readonly string[];
11694
- /** Loading state (alias for isLoading) */
11695
- loading?: boolean;
11696
- }
11697
- declare function MasterDetail<T extends EntityRow & {
11698
- id: string | number;
11699
- }>({ entity, masterFields, detailFields: _detailFields, // Captured but not used here - detail handled separately
11700
- loading: externalLoading, isLoading: externalIsLoading, error: externalError, className, ...rest }: MasterDetailProps<T>): React__default.ReactElement;
11701
- declare namespace MasterDetail {
11702
- var displayName: string;
11703
- }
11704
-
11705
11708
  /**
11706
11709
  * StateMachineView — the AVL state machine with loading / error / empty states.
11707
11710
  */
@@ -11725,7 +11728,7 @@ declare const StateMachineView: React__default.FC<StateMachineViewProps>;
11725
11728
  * Uses wireframe theme styling (high contrast, sharp edges).
11726
11729
  */
11727
11730
 
11728
- interface SplitPaneProps {
11731
+ interface SplitPaneProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11729
11732
  /** Direction of the split */
11730
11733
  direction?: "horizontal" | "vertical";
11731
11734
  /** Initial ratio (0-100, percentage of first pane) */
@@ -11764,7 +11767,7 @@ declare const SplitPane: React__default.FC<SplitPaneProps>;
11764
11767
  * Uses wireframe theme styling (high contrast, sharp edges).
11765
11768
  */
11766
11769
 
11767
- interface MasterDetailLayoutProps {
11770
+ interface MasterDetailLayoutProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11768
11771
  /** Master panel content (usually a list) */
11769
11772
  master: React__default.ReactNode;
11770
11773
  /** Detail panel content */
@@ -11806,7 +11809,9 @@ interface DashboardGridCell {
11806
11809
  /** Number of rows this cell spans (1-2) */
11807
11810
  rowSpan?: 1 | 2;
11808
11811
  }
11809
- interface DashboardGridProps extends DisplayStateProps {
11812
+ interface DashboardGridProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11813
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. Each cell is a tile. */
11814
+ surface?: SurfaceMode;
11810
11815
  /** Number of columns */
11811
11816
  columns?: 2 | 3 | 4;
11812
11817
  /** Gap between cells */
@@ -11842,7 +11847,7 @@ interface TabDefinition {
11842
11847
  /** Disable this tab */
11843
11848
  disabled?: boolean;
11844
11849
  }
11845
- interface TabbedContainerProps {
11850
+ interface TabbedContainerProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11846
11851
  /** Tab definitions */
11847
11852
  tabs: TabDefinition[];
11848
11853
  /** Default active tab ID */
@@ -11901,7 +11906,7 @@ declare function useDockLayout(): DockLayoutContextValue;
11901
11906
  declare const COMPACT_MEDIA_QUERY = "(max-width: 1023.98px)";
11902
11907
  /** Whether the viewport is in the compact (mobile) range — the one threshold every compact decision uses. */
11903
11908
  declare function useCompactLayout(): boolean;
11904
- interface DockLayoutProps {
11909
+ interface DockLayoutProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11905
11910
  /** Fixed-width far-left vertical strip (e.g. an icon nav rail). */
11906
11911
  rail?: React__default.ReactNode;
11907
11912
  /** Collapsible, resizable left sidebar. */
@@ -11918,7 +11923,7 @@ interface DockLayoutProps {
11918
11923
  railWidth?: number;
11919
11924
  /** Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280 */
11920
11925
  secondarySidebarWidth?: number;
11921
- /** Whether `sidebar` is collapsed. @default false */
11926
+ /** Whether `sidebar` is collapsed (controlled; the layout keeps its own state when omitted). */
11922
11927
  sidebarCollapsed?: boolean;
11923
11928
  onSidebarCollapsedChange?: (collapsed: boolean) => void;
11924
11929
  /** Sidebar size as a SplitPane ratio (0-100, percentage of the sidebar/main split). @default 20 */
@@ -11926,7 +11931,7 @@ interface DockLayoutProps {
11926
11931
  onSidebarWidthChange?: (width: number) => void;
11927
11932
  /** Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160 */
11928
11933
  sidebarMinSize?: number;
11929
- /** Whether `bottomPanel` is collapsed. @default false */
11934
+ /** Whether `bottomPanel` is collapsed (controlled; the layout keeps its own state when omitted). */
11930
11935
  bottomPanelCollapsed?: boolean;
11931
11936
  onBottomPanelCollapsedChange?: (collapsed: boolean) => void;
11932
11937
  /** Bottom panel size as a SplitPane ratio (0-100, percentage given to the panel). @default 30 */
@@ -11934,7 +11939,7 @@ interface DockLayoutProps {
11934
11939
  onBottomPanelHeightChange?: (height: number) => void;
11935
11940
  /** Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120 */
11936
11941
  bottomPanelMinSize?: number;
11937
- /** Whether `secondarySidebar` is collapsed. @default false */
11942
+ /** Whether `secondarySidebar` is collapsed (controlled; the layout keeps its own state when omitted). */
11938
11943
  secondarySidebarCollapsed?: boolean;
11939
11944
  onSecondarySidebarCollapsedChange?: (collapsed: boolean) => void;
11940
11945
  /** The mobile variant; decided by the viewport (narrower than 1024px) when omitted. */
@@ -12007,6 +12012,19 @@ interface UISlotComponentProps {
12007
12012
  pattern?: string;
12008
12013
  /** Source trait name for data-source-trait attribute (compiled mode) */
12009
12014
  sourceTrait?: string;
12015
+ /**
12016
+ * Compiled mode: the root node's declared `enter`. When set, the slot plays
12017
+ * no theme-default entry (the root element animates itself, or opts out
12018
+ * with `none`). Runtime mode reads it off the slot content.
12019
+ */
12020
+ enter?: EnterAnimation;
12021
+ /**
12022
+ * Compiled mode: the predicted skeleton while this trait's server round
12023
+ * trip is in flight (the View selects it by the pending transition). Shown
12024
+ * only while the slot is empty. Runtime mode reads it from
12025
+ * `AwaitingSkeletonContext`.
12026
+ */
12027
+ awaitingSkeleton?: SkeletonNode;
12010
12028
  /**
12011
12029
  * Host-supplied stock content for a slot-host region (Studio V4 §14 Part
12012
12030
  * I2). Ignored whenever `children` is passed — `children` (compiled mode)
@@ -12209,7 +12227,7 @@ declare const DrawerSlot: React__default.FC<DrawerSlotProps>;
12209
12227
  * - Fixed positioning in corner of screen
12210
12228
  */
12211
12229
 
12212
- interface ToastSlotProps {
12230
+ interface ToastSlotProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12213
12231
  /** Content to display in the toast (message or ReactNode) */
12214
12232
  children?: React__default.ReactNode;
12215
12233
  /** Toast variant */
@@ -12237,82 +12255,6 @@ interface ToastSlotProps {
12237
12255
  */
12238
12256
  declare const ToastSlot: React__default.FC<ToastSlotProps>;
12239
12257
 
12240
- /**
12241
- * Timeline Organism Component
12242
- *
12243
- * A vertical timeline component for displaying chronological events.
12244
- * Composes atoms and molecules for layout, uses CSS variables for theming.
12245
- *
12246
- * Orbital Component Interface Compliance:
12247
- * - Entity binding with auto-fetch when entity is a string
12248
- * - Event emission via useEventBus (UI:* events)
12249
- * - isLoading and error state props
12250
- * - className for external styling
12251
- */
12252
-
12253
- type TimelineItemStatus = "complete" | "active" | "pending" | "error";
12254
- /**
12255
- * Layer 2 visual treatment for the timeline pattern — orthogonal to the
12256
- * semantic status conveyed by per-item style.
12257
- */
12258
- type TimelineLook = "vertical-compact" | "vertical-spacious" | "horizontal" | "swimlane";
12259
- interface TimelineItem {
12260
- /** Unique identifier */
12261
- id: string;
12262
- /** Item title */
12263
- title: string;
12264
- /** Item description */
12265
- description?: string;
12266
- /** Timestamp string */
12267
- date?: string;
12268
- /** Status indicator */
12269
- status?: TimelineItemStatus;
12270
- /** Icon override */
12271
- icon?: IconInput;
12272
- /** Additional metadata tags */
12273
- tags?: readonly string[];
12274
- }
12275
- interface TimelineAction {
12276
- label: string;
12277
- event?: EventKey;
12278
- navigatesTo?: string;
12279
- variant?: "primary" | "secondary" | "ghost";
12280
- }
12281
- interface TimelineProps {
12282
- /** Additional CSS classes */
12283
- className?: string;
12284
- /** Loading state indicator */
12285
- isLoading?: boolean;
12286
- /** Error state */
12287
- error?: UiError | null;
12288
- /**
12289
- * Schema entity data typed against @almadar/core's EntityRow. Items from
12290
- * `entity` are normalised into `items` when `items` is omitted. UI-specific
12291
- * TimelineItem fields (`icon`, callbacks) cannot round-trip through the
12292
- * event bus, so decorative stories that need them pass `items` directly.
12293
- */
12294
- entity?: readonly EntityRow[];
12295
- /** Timeline title */
12296
- title?: string;
12297
- /** Timeline items */
12298
- items?: readonly TimelineItem[];
12299
- /** Entity fields the timeline draws; each slot is named by its own `*Field` prop. */
12300
- fields?: readonly string[];
12301
- /** Entity field holding each item's title. */
12302
- titleField?: string;
12303
- /** Entity field holding each item's description. */
12304
- descriptionField?: string;
12305
- /** Entity field holding each item's date. */
12306
- dateField?: string;
12307
- /** Entity field holding each item's status (complete | active | pending | error). */
12308
- statusField?: string;
12309
- /** Actions per item */
12310
- itemActions?: readonly TimelineAction[];
12311
- /** Layer 2 visual treatment. */
12312
- look?: TimelineLook;
12313
- }
12314
- declare const Timeline: React__default.FC<TimelineProps>;
12315
-
12316
12258
  /**
12317
12259
  * MediaGallery Organism Component
12318
12260
  *
@@ -12348,7 +12290,9 @@ interface MediaGalleryAction {
12348
12290
  navigatesTo?: string;
12349
12291
  variant?: "primary" | "secondary" | "ghost";
12350
12292
  }
12351
- interface MediaGalleryProps extends DisplayStateProps {
12293
+ interface MediaGalleryProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12294
+ /** Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out. */
12295
+ surface?: SurfaceMode;
12352
12296
  /** Entity rows to display (collection cardinality). */
12353
12297
  entity?: readonly EntityRow[];
12354
12298
  /** Gallery title */
@@ -12387,7 +12331,7 @@ declare const MediaGallery: React__default.FC<MediaGalleryProps>;
12387
12331
  * @packageDocumentation
12388
12332
  */
12389
12333
 
12390
- interface RuntimeDebuggerProps {
12334
+ interface RuntimeDebuggerProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
12391
12335
  /** Initial position */
12392
12336
  position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
12393
12337
  /** Initial collapsed state */
@@ -12401,7 +12345,7 @@ interface RuntimeDebuggerProps {
12401
12345
  /** Raw schema for EventDispatcherTab payload extraction */
12402
12346
  schema?: OrbitalSchema;
12403
12347
  }
12404
- declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): React$1.JSX.Element | null;
12348
+ declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, ...rest }: RuntimeDebuggerProps): React$1.JSX.Element | null;
12405
12349
  declare namespace RuntimeDebugger {
12406
12350
  var displayName: string;
12407
12351
  }
@@ -12420,7 +12364,7 @@ declare namespace RuntimeDebugger {
12420
12364
  */
12421
12365
 
12422
12366
  type ChatBarStatus = 'idle' | 'running' | 'paused' | 'complete' | 'error';
12423
- interface ChatBarProps extends DisplayStateProps {
12367
+ interface ChatBarProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12424
12368
  /** Pipeline status */
12425
12369
  status?: ChatBarStatus;
12426
12370
  /** Currently active gate label, e.g. "Gate 2: State machines" */
@@ -12433,8 +12377,10 @@ interface ChatBarProps extends DisplayStateProps {
12433
12377
  placeholder?: string;
12434
12378
  /** Agent context description */
12435
12379
  context?: string;
12380
+ /** The event a message is sent as — `UI:{sendEvent}` with `{ message }`, from Enter or the send button. @default "CHAT_SEND" */
12381
+ sendEvent?: EventKey;
12436
12382
  }
12437
- declare function ChatBar({ status, activeGate, jepaValidity, runningIndicator, placeholder, context, className, }: ChatBarProps): React__default.ReactElement;
12383
+ declare function ChatBar({ status, activeGate, jepaValidity, runningIndicator, placeholder, context, sendEvent, className, ...rest }: ChatBarProps): React__default.ReactElement;
12438
12384
  declare namespace ChatBar {
12439
12385
  var displayName: string;
12440
12386
  }
@@ -12469,7 +12415,7 @@ declare function parseEditFocus(value: EventPayloadValue | undefined): EditFocus
12469
12415
 
12470
12416
  /** Disclosure level driving panel density (builder=1 … architect=4). */
12471
12417
  type TraceDisclosureLevel = 1 | 2 | 3 | 4;
12472
- interface SubagentTracePanelProps extends DisplayStateProps {
12418
+ interface SubagentTracePanelProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12473
12419
  /** All known subagents from the runner. */
12474
12420
  subagents: TraceSubagent[];
12475
12421
  /** Current canvas focus orbital — only used by overlay mode. Tab mode ignores this. */
@@ -12665,7 +12611,7 @@ interface DashboardLayoutProps {
12665
12611
  }
12666
12612
  declare const DashboardLayout: React__default.FC<DashboardLayoutProps>;
12667
12613
 
12668
- interface AuthLayoutProps {
12614
+ interface AuthLayoutProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12669
12615
  /** App name */
12670
12616
  appName?: string;
12671
12617
  /** Logo component or URL */
@@ -12704,7 +12650,7 @@ interface CounterEntity {
12704
12650
  /** Formatted range text (e.g. "Range: 0 to 100") */
12705
12651
  rangeText?: string;
12706
12652
  }
12707
- interface CounterTemplateProps extends TemplateProps<CounterEntity> {
12653
+ interface CounterTemplateProps extends TemplateProps<CounterEntity>, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12708
12654
  /** Called when increment is clicked */
12709
12655
  onIncrement?: () => void;
12710
12656
  /** Called when decrement is clicked */
@@ -12736,7 +12682,7 @@ declare const CounterTemplate: React__default.FC<CounterTemplateProps>;
12736
12682
  * **Atomic Design**: Composed using Box, Typography, and Button atoms.
12737
12683
  */
12738
12684
 
12739
- interface GenericAppTemplateProps extends TemplateProps {
12685
+ interface GenericAppTemplateProps extends TemplateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12740
12686
  /** Page title */
12741
12687
  title: string;
12742
12688
  /** Subtitle or description */
@@ -12752,4 +12698,4 @@ interface GenericAppTemplateProps extends TemplateProps {
12752
12698
  }
12753
12699
  declare const GenericAppTemplate: React__default.FC<GenericAppTemplateProps>;
12754
12700
 
12755
- export { ALL_PRESETS, Accordion, type AccordionItem, type AccordionProps, Card as ActionCard, type CardProps as ActionCardProps, ActionPalette, type ActionPaletteProps, ActionTile, type ActionTileProps, ActivationBlock, type ActivationBlockProps, Alert, type AlertProps, type AlertVariant, AlgoGraphCanvas, type AlgoGraphCanvasProps, type AlgoGraphEdge, type AlgoGraphEdgeState, type AlgoGraphLayout, type AlgoGraphNode, type AlgoGraphNodeBadge, type AlgoGraphNodeState, type AlgorithmBar, AlgorithmCanvas, type AlgorithmCanvasProps, type AlgorithmCell, type AlgorithmPointer, AnimatedCounter, type AnimatedCounterProps, AnimatedGraphic, type AnimatedGraphicProps, AnimatedReveal, type AnimatedRevealProps, Aside, type AsideProps, AssetPicker, type AssetPickerProps, AtlasImage, type AtlasImageAsset, type AtlasImageProps, AtlasPanel, type AtlasPanelProps, AuthLayout, type AuthLayoutProps, Avatar, type AvatarProps, type AvatarSize, type AvatarStatus, BadgeVariant, BiologyCanvas, type BiologyCanvasProps, type BiologyEdge, type BiologyNode, Box, type BoxBg, type BoxMargin, type BoxPadding, type BoxProps, type BoxRounded, type BoxShadow, BranchingLogicBuilder, type BranchingLogicBuilderProps, type BranchingQuestion, type BranchingRule, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, COMPACT_MEDIA_QUERY, CalendarGrid, type CalendarGridProps, type CameraMode, CameraState, Canvas, Canvas2D, type Canvas2DProps, type CanvasItemShape, type CanvasItemStatus, type CanvasMode, type CanvasProps, Card$1 as Card, type CardAction, CardBody, CardContent, CardFooter, CardGrid, type CardGridGap, type CardGridProps, CardHeader, type CardProps$1 as CardProps, CardTitle, Carousel, type CarouselProps, Center, type CenterProps, ChangeList, type ChangeListItem, type ChangeListProps, type ChangeType, Chart, type ChartDataPoint, ChartLegend, type ChartLegendItem, type ChartLegendProps, type ChartProps, type ChartSeries, type ChartType, ChatBar, type ChatBarProps, type ChatBarStatus, Checkbox, type CheckboxProps, type ChemistryArrow, type ChemistryAtom, type ChemistryBond, ChemistryCanvas, type ChemistryCanvasProps, ChoiceButton, type ChoiceButtonProps, Coachmark, type CoachmarkAnchor, type CoachmarkPlacement, type CoachmarkProps, type CodeAssistProvider, type CodeAssistRequest, type CodeAssistResult, CodeBlock, type CodeBlockProps, type CodeCompletion, type CodeCompletionProvider, type CodeCompletionResult, type CodeDiagnostic, type CodeLanguage, type CodeLanguageLoader, CodeRunnerPanel, type CodeRunnerPanelProps, type CodeSimulationOutput, type CodeSuggestion, type CodeViewerAction, type CodeViewerFile, type CodeViewerMode, CollapsibleSection, type CollapsibleSectionProps, type Column, CommandPalette, type CommandPaletteCommand, type CommandPaletteProps, type CommitKind, CommitRow, type CommitRowProps, type ConditionalContext, ConditionalWrapper, type ConditionalWrapperProps, ConfettiEffect, type ConfettiEffectProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogVariant, ConnectionBlock, type ConnectionBlockProps, Container, type ContainerProps, ContentRenderer, type ContentRendererProps, ControlButton, type ControlButtonProps, ControlGrid, type ControlGridButton, type ControlGridKind, type ControlGridProps, type CounterSize, CounterTemplate, type CounterTemplateProps, type CounterVariant, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, type DPadDirection, 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, DateRangePicker, type DateRangePickerPreset, type DateRangePickerProps, DateRangeSelector, type DateRangeSelectorOption, type DateRangeSelectorProps, DayCell, type DayCellProps, type DetailField, DetailPanel, type DetailPanelProps, type DetailSection, Dialog, type DialogProps, DialogueBubble, type DialogueBubbleProps, type DiffHunk, type DiffLine$1 as DiffLine, type DiffLineType, type DiffRevision, type DispatchCommandPaletteCommandDeps, type DisplayStateProps, Divider, type DividerOrientation, type DividerProps, DocBreadcrumb, type DocBreadcrumbItem, type DocBreadcrumbProps, DocPagination, type DocPaginationLink, type DocPaginationProps, DocSearch, type DocSearchProps, type DocSearchResult, DocSidebar, type DocSidebarItem, type DocSidebarProps, DocTOC, type DocTOCItem, type DocTOCProps, DockLayout, type DockLayoutContextValue, type DockLayoutProps, DocumentDetails, type DocumentDetailsField, type DocumentDetailsProps, DocumentPanel, type DocumentPanelAction, type DocumentPanelProps, type DocumentType, DocumentViewer, type DocumentViewerProps, StateMachineView as DomStateMachineVisualizer, type DotSize, type DotState, Drawer, type DrawerPosition, type DrawerProps, type DrawerSize, DrawerSlot, type DrawerSlotProps, ELEMENT_SELECTED_EVENT, EdgeDecoration, type EdgeDecorationProps, type EdgeSide, type EdgeVariant, EditorCheckbox, type EditorCheckboxProps, type EditorMode, EditorSelect, type EditorSelectProps, EditorSlider, type EditorSliderProps, EditorTextInput, type EditorTextInputProps, EditorToolbar, type EditorToolbarProps, EmojiPicker, type EmojiPickerPosition, type EmojiPickerProps, EmptyState, type EmptyStateProps, EntityDisplayEvents, ErrorBoundary, type ErrorBoundaryProps, ErrorState, type ErrorStateProps, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FacingDirection, FeatureCard, type FeatureCardProps, FeatureGrid, type FeatureGridProps, type FilterDefinition, FilterGroup, type FilterGroupProps, type FilterPayload, FilterPill, type FilterPillProps, type FilterPillSize, type FilterPillVariant, Flex, type FlexProps, FlipCard, type FlipCardProps, FlipContainer, type FlipContainerProps, type FloatingAction, FloatingActionButton, type FloatingActionButtonProps, FloatingToolbar, type FloatingToolbarItem, type FloatingToolbarPosition, type FloatingToolbarProps, Form, FormActions, type FormActionsProps, FormField, type FormFieldProps, FormLayout, type FormLayoutProps, type FormProps, FormSection$1 as FormSection, FormSectionHeader, type FormSectionHeaderProps, type FormSectionProps, FxOverlay, FxOverlayItem, type FxOverlayProps, GameAudioCue, type GameAudioCueProps, GameAudioToggle, type GameAudioToggleProps, GameHud, type GameHudElement, type GameHudProps, type GameHudStat, GameIcon, type GameIconProps, GameMenu, type GameMenuProps, GameShell, type GameShellProps, Gantt, type GanttLink, type GanttProps, GenericAppTemplate, type GenericAppTemplateProps, GeometricPattern, type GeometricPatternProps, GradientDivider, type GradientDividerProps, GraphCanvas, type GraphCanvasProps, type GraphEdge, type GraphNode, type GraphSimilarity, GraphView, type GraphViewEdge, type GraphViewNode, type GraphViewProps, type GraphicAnimation, Grid, GridPicker, type GridPickerCellSize, type GridPickerProps, type GridProps, HStack, type HStackProps, Header, type HeaderProps, HealthBar, type HealthBarProps, type HighlightType, IconButton, type IconButtonProps, IconInput, IconPicker, type IconPickerProps, Image, type ImageAspect, type ImageFit, type ImageProps, type ImageRounded, type ImportEntityDisplay, ImportPreviewTree, type ImportPreviewTreeProps, type ImportPreviewUnit, ImportProgress, type ImportProgressCounts, type ImportProgressProps, type ImportProgressStep, type ImportSkippedElement, type ImportSourceOption, ImportSourcePicker, type ImportSourcePickerProps, InfiniteScrollSentinel, type InfiniteScrollSentinelProps, Input, InputGroup, type InputGroupProps, type InputProps, IsometricUnit, JazariStateMachine, type JazariStateMachineProps, JsonTreeEditor, type JsonTreeEditorProps, Label, type LabelProps, type LawReference, LawReferenceTooltip, type LawReferenceTooltipProps, type Learning3DPoint, LearningCanvas, type LearningCanvasProps, type LearningPhysicsBody, type LearningPhysicsConstraint, type LearningPoint, LearningScene3D, type LearningScene3DProps, type LearningShape, type LearningShapeType, LessonSegment, type LessonUserProgress, Lightbox, type LightboxImage, type LightboxProps, type LikertOption, LikertScale, type LikertScaleProps, LineChart, type LineChartProps, List, type ListItem, type ListProps, LoadingState, type LoadingStateProps, type MapMarkerData, type MapRouteData, type MapRouteWaypoint, MapView, type MapViewProps, MarkdownContent, type MarkdownContentProps, MasterDetail, MasterDetailLayout, type MasterDetailLayoutProps, type MasterDetailProps, MathCanvas, type MathCanvasProps, type MathCurve, type MathPoint, type MathVector, type MatrixColumn, MatrixQuestion, type MatrixQuestionProps, type MatrixRow, MediaGallery, type MediaGalleryProps, type MediaItem, Menu, type MenuItem, type MenuOption, type MenuProps, type MeshSphereOpts, Meter, type MeterAction, type MeterProps, type MeterThreshold, type MeterVariant, Modal, type ModalProps, type ModalSize, ModalSlot, type ModalSlotProps, type NavItem, Navigation, type NavigationItem, type NavigationProps, NodeSlotEditor, type NodeSlotEditorProps, NumberStepper, type NumberStepperProps, type NumberStepperSize, OnboardingSpotlight, type OnboardingSpotlightProps, type OptionConstraint, OptionConstraintGroup, type OptionConstraintGroupProps, type OptionConstraintOption, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, type OrbitalVisualizationProps, Overlay, type OverlayProps, type PageBreadcrumb, PageHeader, type PageHeaderProps, PageTransition, type PageTransitionProps, type PaginatePayload, Pagination, type PaginationProps, PatternTile, type PatternTileProps, type PatternVariant, PhysicsCanvas, type PhysicsCanvasProps, type PickerItem, type Platform, Popover, type PopoverProps, PositionedCanvas, type PositionedCanvasProps, Presence, type PresenceAnimation, type PresenceProps, type PresenceResult, type PrismLanguageGrammar, ProgressBar, type ProgressBarColor, type ProgressBarProps, type ProgressBarVariant, ProgressDots, type ProgressDotsProps, type Projection, PropertyInspector, type PropertyInspectorProps, PullToRefresh, type PullToRefreshProps, type QrScanResult, QrScanner, type QrScannerProps, QuizBlock, type QuizBlockProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, type RangeSliderSize, ReflectionBlock, type ReflectionBlockProps, type RelationOption, RelationSelect, type RelationSelectProps, RepeatableFormSection, type RepeatableFormSectionProps, type RepeatableItem, ReplyTree, type ReplyTreeProps, ResolvedFrame, type RevealAnimation, type RevealTrigger, RichTextEditor, type RichTextEditorProps, type RowAction, type RuleDefinition, type RuleOption, RuntimeDebugger, type RuntimeDebuggerProps, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, type ScaledDiagramProps, ScoreDisplay, type ScoreDisplayProps, SearchInput, type SearchInputProps, type SearchPayload, Section, SectionHeader, type SectionHeaderProps, type SectionProps, SegmentRenderer, type SegmentRendererProps, Select, type SelectOption, type SelectOptionGroup, type SelectPayload, type SelectProps, SequenceBar, type SequenceBarProps, SidePanel, type SidePanelProps, type SidePlayer, Sidebar, type SidebarItem, type SidebarProps, SignaturePad, type SignaturePadProps, SimpleGrid, type SimpleGridProps, Skeleton, type SkeletonProps, type SkeletonVariant, SlotContent, SlotContentRenderer, type SlotItemData, SocialProof, type SocialProofItem, type SocialProofProps, type SortPayload, SortableList, type SortableListProps, Spacer, type SpacerProps, type SpacerSize, Sparkline, type SparklineColor, type SparklineProps, Spinner, type SpinnerProps, Split, SplitPane, type SplitPaneProps, type SplitProps, type SpotlightStep, SpriteFrameDims, SpriteSheetUrls, Stack, type StackAlign, type StackDirection, type StackGap, type StackJustify, type StackProps, StarRating, type StarRatingPrecision, type StarRatingProps, type StarRatingSize, StatBadge, type StatBadgeProps, StatCard, type StatCardProps, StatDisplay, type StatDisplayProps, StateGraph, type StateGraphProps, type StateGraphTransition, StateJsonView, type StateJsonViewProps, StateMachineView, type StateMachineViewProps, StatusBar, type StatusBarProps, StatusDot, type StatusDotProps, type StatusDotSize, type StatusDotStatus, SubagentTracePanel, type SubagentTracePanelProps, SvgBranch, type SvgBranchProps, SvgConnection, type SvgConnectionProps, SvgFlow, type SvgFlowProps, SvgGrid, type SvgGridProps, SvgLobe, type SvgLobeProps, SvgMesh, type SvgMeshProps, SvgMorph, type SvgMorphProps, SvgNode, type SvgNodeProps, SvgPulse, type SvgPulseProps, SvgRing, type SvgRingProps, SvgShield, type SvgShieldProps, SvgStack, type SvgStackProps, type SwipeAction, SwipeableRow, type SwipeableRowProps, Switch, type SwitchProps, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, type TabDefinition, type TabItem, TabbedContainer, type TabbedContainerProps, TableView, type TableViewColumn, type TableViewProps, Tabs, type TabsProps, TagInput, type TagInputProps, type TeamUnitTraits, type TemplateProps, TerrainPalette, type TerrainPaletteProps, TextHighlight, type TextHighlightProps, Textarea, type TextareaProps, ThemeToggle, type ThemeToggleProps, type TileCoord, type TileLayout, TimeSlotCell, type TimeSlotCellProps, Timeline, type TimelineItem, type TimelineItemStatus, type TimelineProps, TimerDisplay, type TimerDisplayProps, Toast, type ToastProps, ToastSlot, type ToastSlotProps, type ToastVariant, Tooltip, type TooltipProps, TopNavItem, type TopNavItemData, type TopNavItemProps, type TraceDisclosureLevel, TraitFrame, type TraitFrameProps, TraitSlot, type TraitSlotProps, type TraitStateMachineDefinition, TraitStateViewer, type TraitStateViewerProps, type TraitTransition, type TrendDirection, TrendIndicator, type TrendIndicatorProps, type TrendIndicatorSize, TypewriterText, type TypewriterTextProps, Typography, type TypographyProps, type TypographyVariant, UISlotComponent, type UISlotComponentProps, UISlotRenderer, type UISlotRendererProps, UiError, UnitAnimationState, UploadDropZone, type UploadDropZoneProps, type UsePresenceOptions, VStack, type VStackProps, type Vec2, VersionDiff, type DiffLine as VersionDiffLine, type VersionDiffProps, ViolationAlert, type ViolationAlertProps, type ViolationRecord, VoteStack, type VoteStackProps, WizardContainer, type WizardContainerProps, WizardNavigation, type WizardNavigationProps, WizardProgress, type WizardProgressProps, type WizardProgressStep, type WizardStep, applyCompletion, applySuggestions, arrowBetween, billboardLabel, boardEntity, bool, createUnitAnimationState, cylinderBetween, dispatchCommandPaletteCommand, get3DClickPayload, getCurrentFrame, getTileDimensions, inferDirection, isoToScreen, makeAsset, makeAssetMap, meshSphere, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, pendulum, projectileMotion, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, rows, sanitizeRichHtml, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAnchorRect, useAtlasSliceDataUrl, useCamera, useCompactLayout, useDockLayout, useImageCache, usePresence, useUnitSpriteAtlas, vec2 };
12701
+ export { ALL_PRESETS, Accordion, type AccordionItem, type AccordionProps, Card as ActionCard, type CardProps as ActionCardProps, ActionPalette, type ActionPaletteProps, ActionTile, type ActionTileProps, ActivationBlock, type ActivationBlockProps, AgentActivityFeed, type AgentActivityFeedProps, type AgentActivityJumpTarget, AgentActivityRow, type AgentActivityRowProps, AgentChatFeed, type AgentChatFeedProps, type AgentConversation, AgentThinkingRow, Alert, type AlertProps, type AlertVariant, AlgoGraphCanvas, type AlgoGraphCanvasProps, type AlgoGraphEdge, type AlgoGraphEdgeState, type AlgoGraphLayout, type AlgoGraphNode, type AlgoGraphNodeBadge, type AlgoGraphNodeState, type AlgorithmBar, AlgorithmCanvas, type AlgorithmCanvasProps, type AlgorithmCell, type AlgorithmPointer, AnimatedCounter, type AnimatedCounterProps, AnimatedGraphic, type AnimatedGraphicProps, AnimatedReveal, type AnimatedRevealProps, Aside, type AsideProps, AssetPicker, type AssetPickerProps, AtlasImage, type AtlasImageAsset, type AtlasImageProps, AtlasPanel, type AtlasPanelProps, AuthLayout, type AuthLayoutProps, Avatar, type AvatarProps, type AvatarSize, type AvatarStatus, BadgeVariant, BiologyCanvas, type BiologyCanvasProps, type BiologyEdge, type BiologyNode, Box, type BoxBg, type BoxMargin, type BoxPadding, type BoxProps, type BoxRounded, type BoxShadow, BranchingLogicBuilder, type BranchingLogicBuilderProps, type BranchingQuestion, type BranchingRule, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, COMPACT_MEDIA_QUERY, CalendarGrid, type CalendarGridProps, type CameraMode, CameraState, Canvas, Canvas2D, type Canvas2DProps, type CanvasItemShape, type CanvasItemStatus, type CanvasMode, type CanvasProps, Card$1 as Card, type CardAction, CardBody, CardContent, CardFooter, CardHeader, type CardProps$1 as CardProps, CardTitle, Carousel, type CarouselProps, Center, type CenterProps, ChangeList, type ChangeListItem, type ChangeListProps, type ChangeType, Chart, type ChartDataPoint, ChartLegend, type ChartLegendItem, type ChartLegendProps, type ChartProps, type ChartSeries, type ChartType, ChatBar, type ChatBarProps, type ChatBarStatus, Checkbox, type CheckboxProps, type ChemistryArrow, type ChemistryAtom, type ChemistryBond, ChemistryCanvas, type ChemistryCanvasProps, ChoiceButton, type ChoiceButtonProps, Coachmark, type CoachmarkAnchor, type CoachmarkPlacement, type CoachmarkProps, type CodeAssistProvider, type CodeAssistRequest, type CodeAssistResult, CodeBlock, type CodeBlockProps, type CodeCompletion, type CodeCompletionProvider, type CodeCompletionResult, type CodeDiagnostic, type CodeLanguage, type CodeLanguageLoader, CodeRunnerPanel, type CodeRunnerPanelProps, type CodeSimulationOutput, type CodeSuggestion, type CodeViewerAction, type CodeViewerFile, type CodeViewerMode, CollapsibleSection, type CollapsibleSectionProps, CommandPalette, type CommandPaletteCommand, type CommandPaletteProps, type CommitKind, CommitRow, type CommitRowProps, type ConditionalContext, ConditionalWrapper, type ConditionalWrapperProps, ConfettiEffect, type ConfettiEffectProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogVariant, ConnectionBlock, type ConnectionBlockProps, Container, type ContainerProps, ContentRenderer, type ContentRendererProps, ControlButton, type ControlButtonProps, ControlGrid, type ControlGridButton, type ControlGridKind, type ControlGridProps, type CounterSize, CounterTemplate, type CounterTemplateProps, type CounterVariant, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, type DPadDirection, DashboardGrid, type DashboardGridCell, type DashboardGridProps, DashboardLayout, type DashboardLayoutProps, DataGrid, type DataGridField, type DataGridItemAction, type DataGridProps, DataList, type DataListField, type DataListItemAction, type DataListProps, DateRangePicker, type DateRangePickerPreset, type DateRangePickerProps, DateRangeSelector, type DateRangeSelectorOption, type DateRangeSelectorProps, DayCell, type DayCellProps, type DetailField, DetailPanel, type DetailPanelProps, type DetailSection, Dialog, type DialogProps, DialogueBubble, type DialogueBubbleProps, type DiffHunk, type DiffLine$1 as DiffLine, type DiffLineType, type DiffRevision, type DispatchCommandPaletteCommandDeps, type DisplayStateProps, Divider, type DividerOrientation, type DividerProps, DocBreadcrumb, type DocBreadcrumbItem, type DocBreadcrumbProps, DocPagination, type DocPaginationLink, type DocPaginationProps, DocSearch, type DocSearchProps, type DocSearchResult, DocSidebar, type DocSidebarItem, type DocSidebarProps, DocTOC, type DocTOCItem, type DocTOCProps, DockLayout, type DockLayoutContextValue, type DockLayoutProps, DocumentDetails, type DocumentDetailsField, type DocumentDetailsProps, DocumentPanel, type DocumentPanelAction, type DocumentPanelProps, type DocumentType, DocumentViewer, type DocumentViewerProps, StateMachineView as DomStateMachineVisualizer, type DotSize, type DotState, Drawer, type DrawerPosition, type DrawerProps, type DrawerSize, DrawerSlot, type DrawerSlotProps, ELEMENT_SELECTED_EVENT, EdgeDecoration, type EdgeDecorationProps, type EdgeSide, type EdgeVariant, EditorCheckbox, type EditorCheckboxProps, type EditorMode, EditorSelect, type EditorSelectProps, EditorSlider, type EditorSliderProps, EditorTextInput, type EditorTextInputProps, EditorToolbar, type EditorToolbarProps, EmojiPicker, type EmojiPickerPosition, type EmojiPickerProps, EmptyState, type EmptyStateProps, EntityDisplayEvents, ErrorBoundary, type ErrorBoundaryProps, ErrorState, type ErrorStateProps, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FacingDirection, FeatureCard, type FeatureCardProps, FeatureGrid, type FeatureGridProps, type FilterDefinition, FilterGroup, type FilterGroupProps, type FilterPayload, FilterPill, type FilterPillProps, type FilterPillSize, type FilterPillVariant, Flex, type FlexProps, FlipCard, type FlipCardProps, FlipContainer, type FlipContainerProps, type FloatingAction, FloatingActionButton, type FloatingActionButtonProps, FloatingToolbar, type FloatingToolbarItem, type FloatingToolbarPosition, type FloatingToolbarProps, Form, FormActions, type FormActionsProps, FormField, type FormFieldProps, FormLayout, type FormLayoutProps, type FormProps, FormSection$1 as FormSection, FormSectionHeader, type FormSectionHeaderProps, type FormSectionProps, FxOverlay, FxOverlayItem, type FxOverlayProps, GameAudioCue, type GameAudioCueProps, GameAudioToggle, type GameAudioToggleProps, GameHud, type GameHudElement, type GameHudProps, type GameHudStat, GameIcon, type GameIconProps, GameMenu, type GameMenuProps, GameShell, type GameShellProps, Gantt, type GanttLink, type GanttProps, GenericAppTemplate, type GenericAppTemplateProps, GeometricPattern, type GeometricPatternProps, GradientDivider, type GradientDividerProps, GraphCanvas, type GraphCanvasProps, type GraphEdge, type GraphNode, type GraphSimilarity, GraphView, type GraphViewEdge, type GraphViewNode, type GraphViewProps, type GraphicAnimation, Grid, GridPicker, type GridPickerCellSize, type GridPickerProps, type GridProps, HStack, type HStackProps, Header, type HeaderProps, HealthBar, type HealthBarProps, type HighlightType, IconButton, type IconButtonProps, IconInput, IconPicker, type IconPickerProps, Image, type ImageAspect, type ImageFit, type ImageProps, type ImageRounded, type ImportEntityDisplay, ImportPreviewTree, type ImportPreviewTreeProps, type ImportPreviewUnit, ImportProgress, type ImportProgressCounts, type ImportProgressProps, type ImportProgressStep, type ImportSkippedElement, type ImportSourceOption, ImportSourcePicker, type ImportSourcePickerProps, InfiniteScrollSentinel, type InfiniteScrollSentinelProps, Input, InputGroup, type InputGroupProps, type InputProps, IsometricUnit, JazariStateMachine, type JazariStateMachineProps, JsonTreeEditor, type JsonTreeEditorProps, Label, type LabelProps, type LawReference, LawReferenceTooltip, type LawReferenceTooltipProps, type Learning3DPoint, LearningCanvas, type LearningCanvasProps, type LearningPhysicsBody, type LearningPhysicsConstraint, type LearningPoint, LearningScene3D, type LearningScene3DProps, type LearningShape, type LearningShapeType, LessonSegment, type LessonUserProgress, Lightbox, type LightboxImage, type LightboxProps, type LikertOption, LikertScale, type LikertScaleProps, LineChart, type LineChartProps, LoadingState, type LoadingStateProps, type MapMarkerData, type MapRouteData, type MapRouteWaypoint, MapView, type MapViewProps, MarkdownContent, type MarkdownContentProps, MasterDetailLayout, type MasterDetailLayoutProps, MathCanvas, type MathCanvasProps, type MathCurve, type MathPoint, type MathVector, type MatrixColumn, MatrixQuestion, type MatrixQuestionProps, type MatrixRow, MediaGallery, type MediaGalleryProps, type MediaItem, Menu, type MenuItem, type MenuOption, type MenuProps, type MeshSphereOpts, Meter, type MeterAction, type MeterProps, type MeterThreshold, type MeterVariant, Modal, type ModalProps, type ModalSize, ModalSlot, type ModalSlotProps, type NavItem, Navigation, type NavigationItem, type NavigationProps, NodeSlotEditor, type NodeSlotEditorProps, NumberStepper, type NumberStepperProps, type NumberStepperSize, OnboardingSpotlight, type OnboardingSpotlightProps, type OptionConstraint, OptionConstraintGroup, type OptionConstraintGroupProps, type OptionConstraintOption, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, type OrbitalVisualizationProps, Overlay, type OverlayProps, type PageBreadcrumb, PageHeader, type PageHeaderProps, PageTransition, type PageTransitionProps, type PaginatePayload, Pagination, type PaginationProps, PatternTile, type PatternTileProps, type PatternVariant, PhysicsCanvas, type PhysicsCanvasProps, type PickerItem, type Platform, Popover, type PopoverProps, PositionedCanvas, type PositionedCanvasProps, Presence, type PresenceAnimation, type PresenceProps, type PresenceResult, type PrismLanguageGrammar, ProgressBar, type ProgressBarColor, type ProgressBarProps, type ProgressBarVariant, ProgressDots, type ProgressDotsProps, type Projection, PropertyInspector, type PropertyInspectorProps, PullToRefresh, type PullToRefreshProps, type QrScanResult, QrScanner, type QrScannerProps, QuizBlock, type QuizBlockProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, type RangeSliderSize, ReflectionBlock, type ReflectionBlockProps, type RelationOption, RelationSelect, type RelationSelectProps, RepeatableFormSection, type RepeatableFormSectionProps, type RepeatableItem, ReplyTree, type ReplyTreeProps, ResolvedFrame, type RevealAnimation, type RevealTrigger, RichTextEditor, type RichTextEditorProps, type RowFacts, type RuleDefinition, type RuleOption, RuntimeDebugger, type RuntimeDebuggerProps, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, type ScaledDiagramProps, ScoreDisplay, type ScoreDisplayProps, SearchInput, type SearchInputProps, type SearchPayload, Section, SectionHeader, type SectionHeaderProps, type SectionProps, SegmentRenderer, type SegmentRendererProps, Select, type SelectOption, type SelectOptionGroup, type SelectPayload, type SelectProps, SequenceBar, type SequenceBarProps, SidePanel, type SidePanelProps, type SidePlayer, Sidebar, type SidebarItem, type SidebarProps, SignaturePad, type SignaturePadProps, SimpleGrid, type SimpleGridProps, Skeleton, type SkeletonProps, SkeletonTree, SlotContent, SlotContentRenderer, type SlotItemData, SocialProof, type SocialProofItem, type SocialProofProps, type SortPayload, SortableList, type SortableListProps, Spacer, type SpacerProps, type SpacerSize, Sparkline, type SparklineColor, type SparklineProps, Spinner, type SpinnerProps, Split, SplitPane, type SplitPaneProps, type SplitProps, type SpotlightStep, SpriteFrameDims, SpriteSheetUrls, Stack, type StackAlign, type StackDirection, type StackGap, type StackJustify, type StackProps, StarRating, type StarRatingPrecision, type StarRatingProps, type StarRatingSize, StatBadge, type StatBadgeProps, StatCard, type StatCardProps, StatDisplay, type StatDisplayProps, StateGraph, type StateGraphProps, type StateGraphTransition, StateJsonView, type StateJsonViewProps, StateMachineView, type StateMachineViewProps, StatusBar, type StatusBarProps, StatusDot, type StatusDotProps, type StatusDotSize, type StatusDotStatus, SubagentTracePanel, type SubagentTracePanelProps, SvgBranch, type SvgBranchProps, SvgConnection, type SvgConnectionProps, SvgFlow, type SvgFlowProps, SvgGrid, type SvgGridProps, SvgLobe, type SvgLobeProps, SvgMesh, type SvgMeshProps, SvgMorph, type SvgMorphProps, SvgNode, type SvgNodeProps, SvgPulse, type SvgPulseProps, SvgRing, type SvgRingProps, SvgShield, type SvgShieldProps, SvgStack, type SvgStackProps, type SwipeAction, SwipeableRow, type SwipeableRowProps, Switch, type SwitchProps, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, type TabDefinition, type TabItem, TabbedContainer, type TabbedContainerProps, TableView, type TableViewColumn, type TableViewProps, Tabs, type TabsProps, TagInput, type TagInputProps, type TeamUnitTraits, type TemplateProps, TerrainPalette, type TerrainPaletteProps, TextHighlight, type TextHighlightProps, Textarea, type TextareaProps, ThemeToggle, type ThemeToggleProps, type TileCoord, type TileLayout, TimeSlotCell, type TimeSlotCellProps, Timeline, type TimelineItem, type TimelineItemStatus, type TimelineProps, TimerDisplay, type TimerDisplayProps, Toast, type ToastProps, ToastSlot, type ToastSlotProps, type ToastVariant, Tooltip, type TooltipProps, TopNavItem, type TopNavItemData, type TopNavItemProps, type TraceDisclosureLevel, TraitFrame, type TraitFrameProps, TraitSlot, type TraitSlotProps, type TraitStateMachineDefinition, TraitStateViewer, type TraitStateViewerProps, type TraitTransition, type TrendDirection, TrendIndicator, type TrendIndicatorProps, type TrendIndicatorSize, TypewriterText, type TypewriterTextProps, Typography, type TypographyProps, type TypographyVariant, UISlotComponent, type UISlotComponentProps, UISlotRenderer, type UISlotRendererProps, UiError, UnitAnimationState, UploadDropZone, type UploadDropZoneProps, type UsePresenceOptions, VStack, type VStackProps, type Vec2, VersionDiff, type DiffLine as VersionDiffLine, type VersionDiffProps, ViolationAlert, type ViolationAlertProps, type ViolationRecord, VoteStack, type VoteStackProps, WizardContainer, type WizardContainerProps, WizardNavigation, type WizardNavigationProps, WizardProgress, type WizardProgressProps, type WizardProgressStep, type WizardStep, activityRowFacts, applyCompletion, applySuggestions, arrowBetween, billboardLabel, boardEntity, bool, createUnitAnimationState, cylinderBetween, dispatchCommandPaletteCommand, get3DClickPayload, getCurrentFrame, getTileDimensions, groupIntoConversations, inferDirection, isoToScreen, makeAsset, makeAssetMap, meshSphere, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, pendulum, projectileMotion, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, rows, sanitizeRichHtml, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAnchorRect, useAtlasSliceDataUrl, useCamera, useCompactLayout, useDockLayout, useImageCache, usePresence, useUnitSpriteAtlas, vec2 };