@almadar/ui 6.51.2 → 6.52.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 (121) hide show
  1. package/dist/{Canvas3DHost-CLC_jXh_.d.ts → Canvas3DHost-CWO0tswb.d.ts} +1 -1
  2. package/dist/{FileTree-RKQqRhIM.d.ts → FileTree-DUi7e7Z8.d.ts} +5 -5
  3. package/dist/{GameAudioProvider-BgWLggIy.d.ts → GameAudioProvider-_hPzjqp-.d.ts} +1 -1
  4. package/dist/{NavStackContext-B-XLULCO.d.ts → NavStackContext-04NLdXsY.d.ts} +8 -0
  5. package/dist/Typography-7FRZOS2H.js +5 -0
  6. package/dist/{UISlotContext-DNM8iXna.d.ts → UISlotContext-CS487Uoc.d.ts} +1 -1
  7. package/dist/{UISlotRenderer-7UYHFW4S.js → UISlotRenderer-CR7SCAMR.js} +8 -8
  8. package/dist/avl/index.cjs +3401 -1590
  9. package/dist/avl/index.d.ts +4 -4
  10. package/dist/avl/index.js +26 -23
  11. package/dist/{chunk-6CFYRP4S.js → chunk-2QB2PXOO.js} +1 -3
  12. package/dist/{chunk-R4V7IZQP.js → chunk-5GCI6C7J.js} +2 -2
  13. package/dist/{chunk-BUEIZY54.js → chunk-BHZG4PDZ.js} +420 -422
  14. package/dist/{chunk-MWPX2O4M.js → chunk-CLSLVFSP.js} +3 -16
  15. package/dist/{chunk-GIPZSCND.js → chunk-EERAGPBW.js} +3078 -1832
  16. package/dist/{chunk-OLZ3EEML.js → chunk-G4GMXYMY.js} +109 -15
  17. package/dist/{chunk-HQDKHLFG.js → chunk-IN3BVW2Z.js} +15 -1
  18. package/dist/{chunk-FGHRVJCI.js → chunk-MSBMVG3B.js} +12 -2
  19. package/dist/{chunk-YKHNK5JH.js → chunk-NCNP2RKZ.js} +11 -4
  20. package/dist/{chunk-T7IH5ABO.js → chunk-QWDKMVLX.js} +69 -17
  21. package/dist/{chunk-NTO555KF.js → chunk-TWHYH25Q.js} +136 -15
  22. package/dist/{chunk-GHXWGQTX.js → chunk-V5AGW2JN.js} +1 -1
  23. package/dist/{chunk-L55SAFKL.js → chunk-WB2A6V3I.js} +31 -1
  24. package/dist/{chunk-JXUYEO7U.js → chunk-XUSSAWKL.js} +7 -1
  25. package/dist/{cn-CO-0rolG.d.ts → cn-ClXGlIOY.d.ts} +2 -2
  26. package/dist/components/index.cjs +4933 -3165
  27. package/dist/components/index.d.ts +499 -416
  28. package/dist/components/index.js +11 -11
  29. package/dist/context/index.cjs +12 -4
  30. package/dist/context/index.d.ts +3 -3
  31. package/dist/context/index.js +2 -2
  32. package/dist/hooks/index.cjs +73 -6
  33. package/dist/hooks/index.d.ts +32 -7
  34. package/dist/hooks/index.js +6 -6
  35. package/dist/lib/drawable/three/index.cjs +33 -2
  36. package/dist/lib/drawable/three/index.d.ts +5 -5
  37. package/dist/lib/drawable/three/index.js +7 -7
  38. package/dist/lib/index.cjs +69 -2
  39. package/dist/lib/index.d.ts +29 -6
  40. package/dist/lib/index.js +5 -5
  41. package/dist/locales/index.cjs +93 -3
  42. package/dist/locales/index.js +63 -3
  43. package/dist/{paintDispatch-CMgOyVjS.d.ts → paintDispatch-DHo3WhaU.d.ts} +4 -4
  44. package/dist/providers/index.cjs +3392 -1607
  45. package/dist/providers/index.d.ts +6 -6
  46. package/dist/providers/index.js +55 -16
  47. package/dist/runtime/index.cjs +3417 -1611
  48. package/dist/runtime/index.d.ts +2 -2
  49. package/dist/runtime/index.js +10 -10
  50. package/dist/ssr/index.cjs +306 -141
  51. package/dist/ssr/index.d.cts +32 -44
  52. package/dist/ssr/index.d.ts +32 -44
  53. package/dist/ssr/index.js +249 -84
  54. package/dist/{themeTokens-CN9WCXQc.d.ts → themeTokens-Ccu7EmGY.d.ts} +4 -2
  55. package/dist/{useUISlots-CwUWM1ra.d.ts → useUISlots-1dk2TR4j.d.ts} +1 -9
  56. package/dist/{verificationRegistry-DBHfOR9y.d.ts → verificationRegistry-BYD3cVhS.d.ts} +1 -1
  57. package/locales/ar.json +31 -1
  58. package/locales/en.json +31 -1
  59. package/locales/sl.json +31 -1
  60. package/package.json +12 -9
  61. package/tailwind-preset.cjs +24 -1
  62. package/themes/_base.css +86 -0
  63. package/themes/_contract.md +1 -0
  64. package/themes/almadar-website.css +2 -0
  65. package/themes/almadar.css +2 -0
  66. package/themes/aqua.css +5 -3
  67. package/themes/arabesque.css +9 -7
  68. package/themes/art-deco.css +5 -3
  69. package/themes/art-nouveau.css +4 -0
  70. package/themes/atelier.css +10 -8
  71. package/themes/bauhaus.css +2 -0
  72. package/themes/bloomberg-dense.css +13 -11
  73. package/themes/blueprint.css +2 -0
  74. package/themes/clay.css +2 -0
  75. package/themes/comic.css +12 -10
  76. package/themes/constructivist.css +2 -0
  77. package/themes/corporate.css +4 -2
  78. package/themes/cyberpunk.css +2 -0
  79. package/themes/frutiger-aero.css +2 -0
  80. package/themes/game-adventure.css +1 -0
  81. package/themes/game-rpg.css +1 -0
  82. package/themes/game-sci-fi.css +1 -0
  83. package/themes/game-ui-pack.css +1 -0
  84. package/themes/gazette.css +10 -8
  85. package/themes/glass.css +17 -15
  86. package/themes/gothic.css +2 -0
  87. package/themes/ink-wash.css +2 -0
  88. package/themes/kawaii.css +2 -0
  89. package/themes/kiosk.css +17 -15
  90. package/themes/linear-clean.css +12 -10
  91. package/themes/luxury.css +2 -0
  92. package/themes/mac-classic.css +2 -0
  93. package/themes/material.css +2 -0
  94. package/themes/memphis.css +2 -0
  95. package/themes/mid-century.css +2 -0
  96. package/themes/minimalist.css +2 -0
  97. package/themes/mudcloth.css +2 -0
  98. package/themes/neon.css +2 -0
  99. package/themes/neumorphic.css +2 -0
  100. package/themes/newsprint.css +2 -0
  101. package/themes/notion-editorial.css +12 -10
  102. package/themes/pixel.css +2 -0
  103. package/themes/prism.css +20 -18
  104. package/themes/retro.css +2 -0
  105. package/themes/risograph.css +2 -0
  106. package/themes/scandi.css +2 -0
  107. package/themes/sketch.css +2 -0
  108. package/themes/solarpunk.css +2 -0
  109. package/themes/steampunk.css +2 -0
  110. package/themes/swiss.css +2 -0
  111. package/themes/terminal.css +8 -6
  112. package/themes/trait-wars.css +2 -0
  113. package/themes/ukiyo-e.css +2 -0
  114. package/themes/vaporwave.css +2 -0
  115. package/themes/victorian.css +2 -0
  116. package/themes/wabi-sabi.css +2 -0
  117. package/themes/win95.css +2 -0
  118. package/themes/wireframe.css +2 -0
  119. package/themes/zine.css +2 -0
  120. package/dist/Typography-2Z3JKWHN.js +0 -5
  121. package/dist/{avl-3d-context-MAt_NuU9.d.ts → avl-3d-context-DLteNEwu.d.ts} +3 -3
@@ -1,26 +1,26 @@
1
+ import { A11yProps, 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, EnterAnimation, EditFocus, TraceSubagent, TraceActivity, TraceChatMessage } from '@almadar/core';
2
+ export { AnimationDef, AnimationName, AudioManifest, BusEvent, BusEventListener, BusEventSource, BusEventListener as EventListener, 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, g as DisplayFieldFormat } from '../paintDispatch-DHo3WhaU.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-DHo3WhaU.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-CWO0tswb.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-CWO0tswb.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-_hPzjqp-.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-BYD3cVhS.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
  */
@@ -878,7 +881,8 @@ declare const ProgressBar: React__default.FC<ProgressBarProps>;
878
881
  * A radio button component with label support and accessibility.
879
882
  */
880
883
 
881
- interface RadioProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
884
+ /** @accessibleName label */
885
+ interface RadioProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "size" | keyof A11yProps>, A11yProps {
882
886
  /** Additional CSS classes applied to the root element. */
883
887
  className?: string;
884
888
  /** Radio options (string array or SelectOption array) */
@@ -918,7 +922,7 @@ declare const Radio: React__default.ForwardRefExoticComponent<RadioProps & React
918
922
  */
919
923
 
920
924
  type SparklineColor = "auto" | "primary" | "success" | "warning" | "error" | "info" | "muted";
921
- interface SparklineProps {
925
+ interface SparklineProps extends A11yProps {
922
926
  /** Numeric series to plot. Length < 2 renders nothing. */
923
927
  data: readonly number[];
924
928
  /**
@@ -940,7 +944,8 @@ interface SparklineProps {
940
944
  }
941
945
  declare const Sparkline: React__default.FC<SparklineProps>;
942
946
 
943
- interface SwitchProps {
947
+ /** @accessibleName label */
948
+ interface SwitchProps extends A11yProps {
944
949
  checked?: boolean;
945
950
  defaultChecked?: boolean;
946
951
  onChange?: (checked: boolean) => void;
@@ -960,7 +965,7 @@ declare const Switch: React$1.ForwardRefExoticComponent<SwitchProps & React$1.Re
960
965
  */
961
966
 
962
967
  type SpacerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'auto';
963
- interface SpacerProps {
968
+ interface SpacerProps extends A11yProps {
964
969
  /** Fixed size (auto = flex grow) */
965
970
  size?: SpacerSize;
966
971
  /** Orientation (for fixed sizes) */
@@ -988,7 +993,7 @@ type StackDirection = "horizontal" | "vertical";
988
993
  type StackGap = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
989
994
  type StackAlign = "start" | "center" | "end" | "stretch" | "baseline";
990
995
  type StackJustify = "start" | "center" | "end" | "between" | "around" | "evenly";
991
- interface StackProps extends React__default.AriaAttributes {
996
+ interface StackProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
992
997
  /** Stack direction */
993
998
  direction?: StackDirection;
994
999
  /** Gap between children */
@@ -1015,12 +1020,8 @@ interface StackProps extends React__default.AriaAttributes {
1015
1020
  onClick?: (e: React__default.MouseEvent) => void;
1016
1021
  /** Keyboard handler */
1017
1022
  onKeyDown?: (e: React__default.KeyboardEvent) => void;
1018
- /** Role for accessibility */
1019
- role?: string;
1020
1023
  /** Element id */
1021
1024
  id?: string;
1022
- /** Tab index for focus management */
1023
- tabIndex?: number;
1024
1025
  /** Declarative event name — emits UI:{action} via eventBus on click */
1025
1026
  action?: EventKey;
1026
1027
  /** Payload to include with the action event
@@ -1057,7 +1058,7 @@ declare const HStack: React__default.FC<HStackProps>;
1057
1058
  */
1058
1059
 
1059
1060
  type HighlightType = "question" | "note";
1060
- interface TextHighlightProps {
1061
+ interface TextHighlightProps extends A11yProps {
1061
1062
  /**
1062
1063
  * Type of highlight (determines color)
1063
1064
  */
@@ -1115,7 +1116,7 @@ declare const TextHighlight: React__default.FC<TextHighlightProps>;
1115
1116
  type TypographyVariant = "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "heading" | "subheading" | "body1" | "body2" | "body" | "caption" | "overline" | "small" | "large" | "label";
1116
1117
  /** `none` = no size override — the variant's baked size applies. */
1117
1118
  type TypographySize = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
1118
- interface TypographyProps extends React__default.AriaAttributes {
1119
+ interface TypographyProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
1119
1120
  /** Typography variant */
1120
1121
  variant?: TypographyVariant;
1121
1122
  /** Heading level (1-6) - alternative to variant for headings */
@@ -1140,8 +1141,6 @@ interface TypographyProps extends React__default.AriaAttributes {
1140
1141
  className?: string;
1141
1142
  /** Inline style */
1142
1143
  style?: React__default.CSSProperties;
1143
- /** Accessibility role */
1144
- role?: string;
1145
1144
  /**
1146
1145
  * Value formatting applied to string/number/Date content — `none` (the
1147
1146
  * default) renders content as-is. Covers the raw-ISO-date class: a bound
@@ -1164,7 +1163,7 @@ declare const Typography: React__default.FC<TypographyProps>;
1164
1163
  * @packageDocumentation
1165
1164
  */
1166
1165
 
1167
- interface ThemeToggleProps {
1166
+ interface ThemeToggleProps extends A11yProps {
1168
1167
  /** Additional CSS classes */
1169
1168
  className?: string;
1170
1169
  /** Size variant */
@@ -1189,13 +1188,7 @@ interface ThemeToggleProps {
1189
1188
  */
1190
1189
  declare const ThemeToggle: React__default.FC<ThemeToggleProps>;
1191
1190
 
1192
- /**
1193
- * Overlay Atom Component
1194
- *
1195
- * A fixed backdrop for modals and drawers.
1196
- */
1197
-
1198
- interface OverlayProps {
1191
+ interface OverlayProps extends A11yProps {
1199
1192
  isVisible?: boolean;
1200
1193
  onClick?: (e: React__default.MouseEvent) => void;
1201
1194
  className?: string;
@@ -1248,7 +1241,7 @@ interface PresenceResult {
1248
1241
  * (via `cn`) and `onAnimationEnd` onto the element that carries the animation.
1249
1242
  */
1250
1243
  declare function usePresence(show: boolean, opts: UsePresenceOptions): PresenceResult;
1251
- interface PresenceProps extends UsePresenceOptions {
1244
+ interface PresenceProps extends UsePresenceOptions, A11yProps {
1252
1245
  /** When false, the exit animation runs, then children unmount. */
1253
1246
  show: boolean;
1254
1247
  className?: string;
@@ -1267,7 +1260,7 @@ declare const Presence: React__default.FC<PresenceProps>;
1267
1260
  * need the flip mechanic around custom face content.
1268
1261
  */
1269
1262
 
1270
- interface FlipContainerProps {
1263
+ interface FlipContainerProps extends A11yProps {
1271
1264
  /** Whether the container is flipped (rotateY 180deg) */
1272
1265
  flipped: boolean;
1273
1266
  /** Optional className for the outer wrapper */
@@ -1278,7 +1271,7 @@ interface FlipContainerProps {
1278
1271
  onClick?: () => void;
1279
1272
  }
1280
1273
  declare const FlipContainer: {
1281
- ({ flipped, className, children, onClick, }: FlipContainerProps): React__default.JSX.Element;
1274
+ ({ flipped, className, children, onClick, ...rest }: FlipContainerProps): React__default.JSX.Element;
1282
1275
  displayName: string;
1283
1276
  };
1284
1277
 
@@ -1293,7 +1286,7 @@ declare const FlipContainer: {
1293
1286
  * for non-modal use cases.
1294
1287
  */
1295
1288
 
1296
- interface DialogProps extends React__default.DialogHTMLAttributes<HTMLDialogElement> {
1289
+ interface DialogProps extends Omit<React__default.DialogHTMLAttributes<HTMLDialogElement>, keyof A11yProps>, A11yProps {
1297
1290
  /** Additional CSS classes */
1298
1291
  className?: string;
1299
1292
  /** Dialog contents */
@@ -1315,7 +1308,7 @@ declare const Dialog: React__default.ForwardRefExoticComponent<DialogProps & Rea
1315
1308
  *
1316
1309
  * @capabilities settings navigation sidebar, preferences menu panel, account settings nav, secondary panel, side navigation rail
1317
1310
  */
1318
- interface AsideProps extends React__default.HTMLAttributes<HTMLElement> {
1311
+ interface AsideProps extends Omit<React__default.HTMLAttributes<HTMLElement>, keyof A11yProps>, A11yProps {
1319
1312
  /** Additional CSS classes */
1320
1313
  className?: string;
1321
1314
  /** Aside contents */
@@ -1413,7 +1406,7 @@ type LawReference = {
1413
1406
  /** Optional link to full law text */
1414
1407
  link?: string;
1415
1408
  };
1416
- interface LawReferenceTooltipProps {
1409
+ interface LawReferenceTooltipProps extends A11yProps {
1417
1410
  /** The law reference to display */
1418
1411
  reference: LawReference;
1419
1412
  /** Children element that triggers the tooltip */
@@ -1440,14 +1433,7 @@ interface LawReferenceTooltipProps {
1440
1433
  */
1441
1434
  declare const LawReferenceTooltip: React__default.FC<LawReferenceTooltipProps>;
1442
1435
 
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 {
1436
+ interface DayCellProps extends A11yProps {
1451
1437
  /** The date this cell represents. Optional at the dynamic render edge: an
1452
1438
  * unbound `@config.date` arrives as `undefined`, so the cell falls back to today. */
1453
1439
  date?: Date;
@@ -1458,7 +1444,7 @@ interface DayCellProps {
1458
1444
  /** Additional CSS classes */
1459
1445
  className?: string;
1460
1446
  }
1461
- declare function DayCell({ date, isToday, onClick, className, }: DayCellProps): React__default.JSX.Element;
1447
+ declare function DayCell({ date, isToday, onClick, className, ...rest }: DayCellProps): React__default.JSX.Element;
1462
1448
  declare namespace DayCell {
1463
1449
  var displayName: string;
1464
1450
  }
@@ -1470,7 +1456,7 @@ declare namespace DayCell {
1470
1456
  * time slot that can hold event content via children.
1471
1457
  */
1472
1458
 
1473
- interface TimeSlotCellProps {
1459
+ interface TimeSlotCellProps extends A11yProps {
1474
1460
  /** Time label for this slot (e.g. "09:00") */
1475
1461
  time: string;
1476
1462
  /** Called when the slot is clicked */
@@ -1487,14 +1473,14 @@ interface TimeSlotCellProps {
1487
1473
  onPointerLeave?: React__default.PointerEventHandler<HTMLDivElement>;
1488
1474
  "data-testid"?: string;
1489
1475
  }
1490
- declare function TimeSlotCell({ time, onClick, className, children, isOccupied, onPointerDown, onPointerUp, onPointerCancel, onPointerLeave, "data-testid": testId, }: TimeSlotCellProps): React__default.JSX.Element;
1476
+ declare function TimeSlotCell({ time, onClick, className, children, isOccupied, onPointerDown, onPointerUp, onPointerCancel, onPointerLeave, "data-testid": testId, ...rest }: TimeSlotCellProps): React__default.JSX.Element;
1491
1477
  declare namespace TimeSlotCell {
1492
1478
  var displayName: string;
1493
1479
  }
1494
1480
 
1495
1481
  type StatusDotStatus = "online" | "offline" | "away" | "busy" | "warning" | "critical";
1496
1482
  type StatusDotSize = "sm" | "md" | "lg";
1497
- interface StatusDotProps extends React__default.HTMLAttributes<HTMLSpanElement> {
1483
+ interface StatusDotProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, keyof A11yProps>, A11yProps {
1498
1484
  /** Additional CSS classes applied to the root element. */
1499
1485
  className?: string;
1500
1486
  /** Status determines the dot color */
@@ -1510,7 +1496,7 @@ declare const StatusDot: React__default.ForwardRefExoticComponent<StatusDotProps
1510
1496
 
1511
1497
  type TrendDirection = "up" | "down" | "flat";
1512
1498
  type TrendIndicatorSize = "sm" | "md" | "lg";
1513
- interface TrendIndicatorProps extends React__default.HTMLAttributes<HTMLSpanElement> {
1499
+ interface TrendIndicatorProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, keyof A11yProps>, A11yProps {
1514
1500
  /** Additional CSS classes applied to the root element. */
1515
1501
  className?: string;
1516
1502
  /** Numeric value to display (e.g., 12.5 for +12.5%) */
@@ -1529,7 +1515,7 @@ interface TrendIndicatorProps extends React__default.HTMLAttributes<HTMLSpanElem
1529
1515
  declare const TrendIndicator: React__default.ForwardRefExoticComponent<TrendIndicatorProps & React__default.RefAttributes<HTMLSpanElement>>;
1530
1516
 
1531
1517
  type RangeSliderSize = "sm" | "md" | "lg";
1532
- interface RangeSliderProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange"> {
1518
+ interface RangeSliderProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange" | keyof A11yProps>, A11yProps {
1533
1519
  /** Additional CSS classes applied to the root element. */
1534
1520
  className?: string;
1535
1521
  /** Minimum value */
@@ -1565,15 +1551,7 @@ interface RangeSliderProps extends Omit<React__default.HTMLAttributes<HTMLDivEle
1565
1551
  }
1566
1552
  declare const RangeSlider: React__default.ForwardRefExoticComponent<RangeSliderProps & React__default.RefAttributes<HTMLDivElement>>;
1567
1553
 
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 {
1554
+ interface InfiniteScrollSentinelProps extends A11yProps {
1577
1555
  /** Event name to emit when load-more is triggered (emitted as UI:{loadMoreEvent}) */
1578
1556
  loadMoreEvent: EventKey;
1579
1557
  /** Optional payload to include with the load-more event
@@ -1591,15 +1569,7 @@ interface InfiniteScrollSentinelProps {
1591
1569
  }
1592
1570
  declare const InfiniteScrollSentinel: React__default.FC<InfiniteScrollSentinelProps>;
1593
1571
 
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 {
1572
+ interface ConfettiEffectProps extends A11yProps {
1603
1573
  /** When this changes from false to true, a burst of particles is spawned */
1604
1574
  trigger: boolean;
1605
1575
  /** How long the animation lasts in milliseconds */
@@ -1618,7 +1588,7 @@ declare const ConfettiEffect: React__default.FC<ConfettiEffectProps>;
1618
1588
  * that disappears after the full text has been typed out.
1619
1589
  */
1620
1590
 
1621
- interface TypewriterTextProps {
1591
+ interface TypewriterTextProps extends A11yProps {
1622
1592
  /** The full text to reveal */
1623
1593
  text: string;
1624
1594
  /** Milliseconds per character */
@@ -1632,7 +1602,7 @@ interface TypewriterTextProps {
1632
1602
  }
1633
1603
  declare const TypewriterText: React__default.FC<TypewriterTextProps>;
1634
1604
 
1635
- interface SectionHeaderProps {
1605
+ interface SectionHeaderProps extends A11yProps {
1636
1606
  /** Section title text */
1637
1607
  title: string;
1638
1608
  /** Optional subtitle text */
@@ -1670,7 +1640,7 @@ declare const SectionHeader: React__default.FC<SectionHeaderProps>;
1670
1640
  */
1671
1641
 
1672
1642
  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 {
1643
+ interface PatternTileProps extends A11yProps {
1674
1644
  /** Which geometric pattern to render */
1675
1645
  variant?: PatternVariant;
1676
1646
  /** Tile unit size in SVG units */
@@ -1690,7 +1660,7 @@ declare function getTileDimensions(variant: PatternVariant, size: number): {
1690
1660
 
1691
1661
  type RevealTrigger = 'scroll' | 'hover' | 'manual';
1692
1662
  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'> {
1663
+ interface AnimatedRevealProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children' | keyof A11yProps>, A11yProps {
1694
1664
  /** Additional CSS classes applied to the root element. */
1695
1665
  className?: string;
1696
1666
  /** What triggers the animation */
@@ -1715,7 +1685,8 @@ interface AnimatedRevealProps extends Omit<React__default.HTMLAttributes<HTMLDiv
1715
1685
  declare const AnimatedReveal: React__default.ForwardRefExoticComponent<AnimatedRevealProps & React__default.RefAttributes<HTMLDivElement>>;
1716
1686
 
1717
1687
  type GraphicAnimation = 'draw' | 'fill' | 'pulse' | 'morph';
1718
- interface AnimatedGraphicProps extends React__default.HTMLAttributes<HTMLDivElement> {
1688
+ /** @accessibleName alt */
1689
+ interface AnimatedGraphicProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
1719
1690
  /** Additional CSS classes applied to the root element. */
1720
1691
  className?: string;
1721
1692
  /** URL to an SVG file. Fetched and inlined to enable stroke/fill animations. */
@@ -2030,7 +2001,7 @@ declare const SHEET_COLUMNS = 8;
2030
2001
  */
2031
2002
  declare const SPRITE_SHEET_LAYOUT: Partial<Record<AnimationName, AnimationDef>>;
2032
2003
 
2033
- interface HealthBarProps {
2004
+ interface HealthBarProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2034
2005
  /** Current value */
2035
2006
  current: number;
2036
2007
  /** Maximum value */
@@ -2056,12 +2027,12 @@ interface HealthBarProps {
2056
2027
  /** Sprite image tiled across the filled portion of bar/progress formats. Falls back to CSS color gradient. */
2057
2028
  fillAsset?: Asset;
2058
2029
  }
2059
- declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, frameAsset, fillAsset, }: HealthBarProps): React$1.JSX.Element;
2030
+ declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, frameAsset, fillAsset, ...rest }: HealthBarProps): React$1.JSX.Element;
2060
2031
  declare namespace HealthBar {
2061
2032
  var displayName: string;
2062
2033
  }
2063
2034
 
2064
- interface ScoreDisplayProps {
2035
+ interface ScoreDisplayProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2065
2036
  /** Sprite asset — takes precedence over icon when provided */
2066
2037
  assetUrl?: Asset;
2067
2038
  /** Current score value */
@@ -2079,12 +2050,12 @@ interface ScoreDisplayProps {
2079
2050
  /** Number formatting locale */
2080
2051
  locale?: string;
2081
2052
  }
2082
- declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale: localeProp, }: ScoreDisplayProps): React$1.JSX.Element;
2053
+ declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale: localeProp, ...rest }: ScoreDisplayProps): React$1.JSX.Element;
2083
2054
  declare namespace ScoreDisplay {
2084
2055
  var displayName: string;
2085
2056
  }
2086
2057
 
2087
- interface ControlButtonProps {
2058
+ interface ControlButtonProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2088
2059
  /** Sprite asset — takes precedence over icon when provided */
2089
2060
  assetUrl?: Asset;
2090
2061
  /** Button label text */
@@ -2112,12 +2083,12 @@ interface ControlButtonProps {
2112
2083
  /** Additional CSS classes */
2113
2084
  className?: string;
2114
2085
  }
2115
- declare function ControlButton({ assetUrl, label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, }: ControlButtonProps): React$1.JSX.Element;
2086
+ declare function ControlButton({ assetUrl, label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, ...rest }: ControlButtonProps): React$1.JSX.Element;
2116
2087
  declare namespace ControlButton {
2117
2088
  var displayName: string;
2118
2089
  }
2119
2090
 
2120
- interface TimerDisplayProps {
2091
+ interface TimerDisplayProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2121
2092
  /** Time in seconds */
2122
2093
  seconds: number;
2123
2094
  /** Whether the timer is running */
@@ -2133,12 +2104,12 @@ interface TimerDisplayProps {
2133
2104
  /** Icon asset rendered to the left of the time value. Falls back to no icon. */
2134
2105
  iconAsset?: Asset;
2135
2106
  }
2136
- declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, }: TimerDisplayProps): React$1.JSX.Element;
2107
+ declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, ...rest }: TimerDisplayProps): React$1.JSX.Element;
2137
2108
  declare namespace TimerDisplay {
2138
2109
  var displayName: string;
2139
2110
  }
2140
2111
 
2141
- interface DialogueBubbleProps {
2112
+ interface DialogueBubbleProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2142
2113
  /** Speaker name displayed at the top */
2143
2114
  speaker?: string;
2144
2115
  /** Dialogue text content */
@@ -2158,12 +2129,12 @@ interface DialogueBubbleProps {
2158
2129
  /** Additional CSS classes */
2159
2130
  className?: string;
2160
2131
  }
2161
- declare function DialogueBubble({ speaker: speakerProp, text: textProp, portrait, position, mood, revealedChars, className, }: DialogueBubbleProps): React$1.JSX.Element;
2132
+ declare function DialogueBubble({ speaker: speakerProp, text: textProp, portrait, position, mood, revealedChars, className, ...rest }: DialogueBubbleProps): React$1.JSX.Element;
2162
2133
  declare namespace DialogueBubble {
2163
2134
  var displayName: string;
2164
2135
  }
2165
2136
 
2166
- interface ChoiceButtonProps {
2137
+ interface ChoiceButtonProps extends A11yProps {
2167
2138
  /** Choice text content */
2168
2139
  text: string;
2169
2140
  /** Choice index number (displayed as prefix) */
@@ -2185,7 +2156,7 @@ interface ChoiceButtonProps {
2185
2156
  /** Additional CSS classes */
2186
2157
  className?: string;
2187
2158
  }
2188
- declare function ChoiceButton({ text: textProp, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, }: ChoiceButtonProps): React$1.JSX.Element;
2159
+ declare function ChoiceButton({ text: textProp, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, ...rest }: ChoiceButtonProps): React$1.JSX.Element;
2189
2160
  declare namespace ChoiceButton {
2190
2161
  var displayName: string;
2191
2162
  }
@@ -2199,7 +2170,7 @@ interface ControlGridButton {
2199
2170
  variant?: 'primary' | 'secondary' | 'ghost' | string;
2200
2171
  }
2201
2172
  type DPadDirection = 'up' | 'down' | 'left' | 'right';
2202
- interface ControlGridProps {
2173
+ interface ControlGridProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2203
2174
  kind: ControlGridKind;
2204
2175
  /** action buttons (kind="actions") */
2205
2176
  buttons?: ControlGridButton[];
@@ -2234,7 +2205,7 @@ interface ControlGridProps {
2234
2205
  visibility?: 'auto' | 'always';
2235
2206
  className?: string;
2236
2207
  }
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;
2208
+ 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
2209
  declare namespace ControlGrid {
2239
2210
  var displayName: string;
2240
2211
  }
@@ -2245,7 +2216,7 @@ declare namespace ControlGrid {
2245
2216
  * with optional HealthBar (hearts/bar) or ScoreDisplay (animated number) and
2246
2217
  * a named label — purpose-built for HUD stat rows, not general status tags.
2247
2218
  */
2248
- interface StatBadgeProps {
2219
+ interface StatBadgeProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2249
2220
  /** Sprite asset — takes precedence over icon when provided */
2250
2221
  assetUrl?: Asset;
2251
2222
  /** Asset image (board ui/ PNG); takes precedence over the Lucide icon. */
@@ -2271,7 +2242,7 @@ interface StatBadgeProps {
2271
2242
  /** Additional CSS classes */
2272
2243
  className?: string;
2273
2244
  }
2274
- declare function StatBadge({ assetUrl, iconUrl, label, value, max, format, icon, size, variant, className, source: _source, field: _field, }: StatBadgeProps): React$1.JSX.Element;
2245
+ declare function StatBadge({ assetUrl, iconUrl, label, value, max, format, icon, size, variant, className, source: _source, field: _field, ...rest }: StatBadgeProps): React$1.JSX.Element;
2275
2246
  declare namespace StatBadge {
2276
2247
  var displayName: string;
2277
2248
  }
@@ -2301,7 +2272,7 @@ interface GameHudElement {
2301
2272
  /** Max value (for bars/hearts) */
2302
2273
  max?: number;
2303
2274
  }
2304
- interface GameHudProps {
2275
+ interface GameHudProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2305
2276
  /** Position of the HUD */
2306
2277
  position?: "top" | "bottom" | "corners" | string;
2307
2278
  /** Stats to display - accepts readonly for compatibility with generated const arrays */
@@ -2325,7 +2296,7 @@ interface GameHudProps {
2325
2296
  /** Whether to use a semi-transparent background */
2326
2297
  transparent?: boolean;
2327
2298
  }
2328
- declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, variant, className, transparent, }: GameHudProps): React$1.JSX.Element;
2299
+ declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, variant, className, transparent, ...rest }: GameHudProps): React$1.JSX.Element;
2329
2300
  declare namespace GameHud {
2330
2301
  var displayName: string;
2331
2302
  }
@@ -2346,7 +2317,7 @@ type MenuOption = EventPayload & {
2346
2317
  /** Sub-label or description */
2347
2318
  subLabel?: string;
2348
2319
  };
2349
- interface GameMenuProps {
2320
+ interface GameMenuProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2350
2321
  /** Menu title */
2351
2322
  title: string;
2352
2323
  /** Optional subtitle or version */
@@ -2364,7 +2335,7 @@ interface GameMenuProps {
2364
2335
  /** Additional CSS classes */
2365
2336
  className?: string;
2366
2337
  }
2367
- declare function GameMenu({ title: titleProp, subtitle, options, menuItems, onSelect, background, logo, className, }: GameMenuProps): React$1.JSX.Element;
2338
+ declare function GameMenu({ title: titleProp, subtitle, options, menuItems, onSelect, background, logo, className, ...rest }: GameMenuProps): React$1.JSX.Element;
2368
2339
  declare namespace GameMenu {
2369
2340
  var displayName: string;
2370
2341
  }
@@ -2387,7 +2358,7 @@ interface StateGraphTransition {
2387
2358
  event: string;
2388
2359
  guardHint?: string;
2389
2360
  }
2390
- interface StateGraphProps {
2361
+ interface StateGraphProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2391
2362
  /** All states in the machine (node labels). */
2392
2363
  states: string[];
2393
2364
  /** Player-built transitions rendered as arrows. */
@@ -2410,7 +2381,7 @@ interface StateGraphProps {
2410
2381
  }>;
2411
2382
  className?: string;
2412
2383
  }
2413
- declare function StateGraph({ states, transitions, currentState, selectedState, addingFrom, initialState, width, height, nodeClickEvent, className, }: StateGraphProps): React$1.JSX.Element;
2384
+ declare function StateGraph({ states, transitions, currentState, selectedState, addingFrom, initialState, width, height, nodeClickEvent, className, ...rest }: StateGraphProps): React$1.JSX.Element;
2414
2385
 
2415
2386
  /**
2416
2387
  * Canvas2D — the thin 2D draw-host (Drawable Canvas, P6 closing).
@@ -2473,7 +2444,9 @@ interface SidePlayer {
2473
2444
  animation?: string;
2474
2445
  frame?: number;
2475
2446
  }
2476
- interface Canvas2DProps {
2447
+ interface Canvas2DProps extends A11yProps {
2448
+ /** Text alternative for the scene, rendered as visually hidden text and linked by aria-describedby. */
2449
+ description?: string;
2477
2450
  /** Additional CSS classes */
2478
2451
  className?: string;
2479
2452
  /** Loading state indicator */
@@ -2565,7 +2538,7 @@ interface Canvas2DProps {
2565
2538
  * drawable registry context and the host paints them. */
2566
2539
  children?: React$1.ReactNode;
2567
2540
  }
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;
2541
+ 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
2542
  declare namespace Canvas2D {
2570
2543
  var displayName: string;
2571
2544
  }
@@ -2598,7 +2571,7 @@ declare namespace Canvas2D {
2598
2571
 
2599
2572
  /** Painter selection. Same `drawables` for both; differ only in projection + rasterizer. */
2600
2573
  type CanvasMode = '2d' | '3d';
2601
- interface CanvasProps {
2574
+ interface CanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
2602
2575
  /** Painter: 2D sprite/shape/text raster, or 3D mesh. Default '2d'. */
2603
2576
  mode?: CanvasMode;
2604
2577
  /** Neutral drawable descriptors — the `draw-*` children. Routed to the host's painter. */
@@ -2695,7 +2668,7 @@ interface CanvasProps {
2695
2668
  * Forwarded to the 2D host, which collects them via drawable registry context. */
2696
2669
  children?: React$1.ReactNode;
2697
2670
  }
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;
2671
+ 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
2672
  declare namespace Canvas {
2700
2673
  var displayName: string;
2701
2674
  }
@@ -2729,7 +2702,7 @@ declare function useUnitSpriteAtlas(units: IsometricUnit[]): UseUnitSpriteAtlasR
2729
2702
  * @packageDocumentation
2730
2703
  */
2731
2704
 
2732
- interface GameAudioToggleProps {
2705
+ interface GameAudioToggleProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
2733
2706
  /** Button size */
2734
2707
  size?: 'sm' | 'md' | 'lg';
2735
2708
  /** Additional CSS classes */
@@ -2747,7 +2720,7 @@ interface GameAudioToggleProps {
2747
2720
  muted: boolean;
2748
2721
  }>;
2749
2722
  }
2750
- declare function GameAudioToggle({ size, className, onAsset, offAsset, toggleEvent, }: GameAudioToggleProps): React__default.JSX.Element;
2723
+ declare function GameAudioToggle({ size, className, onAsset, offAsset, toggleEvent, ...rest }: GameAudioToggleProps): React__default.JSX.Element;
2751
2724
  declare namespace GameAudioToggle {
2752
2725
  var displayName: string;
2753
2726
  }
@@ -2859,7 +2832,7 @@ type TraitStateMachineDefinition = {
2859
2832
  transitions: TraitTransition[];
2860
2833
  description?: string;
2861
2834
  };
2862
- interface TraitStateViewerProps {
2835
+ interface TraitStateViewerProps extends A11yProps {
2863
2836
  /** The trait / state machine to visualize */
2864
2837
  trait: TraitStateMachineDefinition;
2865
2838
  /** Display variant */
@@ -2879,7 +2852,7 @@ interface TraitStateViewerProps {
2879
2852
  /** Error state */
2880
2853
  error?: UiError | null;
2881
2854
  }
2882
- declare function TraitStateViewer({ trait, variant, size, showTransitions, onStateClick, stateStyles, className, }: TraitStateViewerProps): React__default.JSX.Element;
2855
+ declare function TraitStateViewer({ trait, variant, size, showTransitions, onStateClick, stateStyles, className, ...rest }: TraitStateViewerProps): React__default.JSX.Element;
2883
2856
  declare namespace TraitStateViewer {
2884
2857
  var displayName: string;
2885
2858
  }
@@ -2921,7 +2894,7 @@ type SlotItemData = {
2921
2894
  * Emits: UI:CLICK
2922
2895
  * Emits: UI:REMOVE
2923
2896
  */
2924
- interface TraitSlotProps {
2897
+ interface TraitSlotProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
2925
2898
  /** Slot index (1-based) */
2926
2899
  slotNumber: number;
2927
2900
  /** Currently equipped item, if any */
@@ -2977,7 +2950,7 @@ interface TraitSlotProps {
2977
2950
  itemId: string;
2978
2951
  }>;
2979
2952
  }
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;
2953
+ 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
2954
  declare namespace TraitSlot {
2982
2955
  var displayName: string;
2983
2956
  }
@@ -3187,7 +3160,7 @@ interface DisplayStateProps {
3187
3160
  * @packageDocumentation
3188
3161
  */
3189
3162
 
3190
- interface ActionTileProps extends DisplayStateProps {
3163
+ interface ActionTileProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3191
3164
  /** The action data */
3192
3165
  action: SlotItemData;
3193
3166
  /** Size variant */
@@ -3200,7 +3173,7 @@ interface ActionTileProps extends DisplayStateProps {
3200
3173
  border: string;
3201
3174
  }>;
3202
3175
  }
3203
- declare function ActionTile({ action, size, disabled, categoryColors, className, }: ActionTileProps): React__default.JSX.Element;
3176
+ declare function ActionTile({ action, size, disabled, categoryColors, className, ...rest }: ActionTileProps): React__default.JSX.Element;
3204
3177
  declare namespace ActionTile {
3205
3178
  var displayName: string;
3206
3179
  }
@@ -3214,7 +3187,7 @@ declare namespace ActionTile {
3214
3187
  * @packageDocumentation
3215
3188
  */
3216
3189
 
3217
- interface ActionPaletteProps {
3190
+ interface ActionPaletteProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3218
3191
  /** Available actions */
3219
3192
  actions: SlotItemData[];
3220
3193
  /** IDs of actions that are already used (shown as disabled) */
@@ -3233,7 +3206,7 @@ interface ActionPaletteProps {
3233
3206
  /** Additional CSS classes */
3234
3207
  className?: string;
3235
3208
  }
3236
- declare function ActionPalette({ actions, usedActionIds, allowDuplicates, categoryColors, size, label, className, }: ActionPaletteProps): React__default.JSX.Element;
3209
+ declare function ActionPalette({ actions, usedActionIds, allowDuplicates, categoryColors, size, label, className, ...rest }: ActionPaletteProps): React__default.JSX.Element;
3237
3210
  declare namespace ActionPalette {
3238
3211
  var displayName: string;
3239
3212
  }
@@ -3248,7 +3221,7 @@ declare namespace ActionPalette {
3248
3221
  * @packageDocumentation
3249
3222
  */
3250
3223
 
3251
- interface SequenceBarProps {
3224
+ interface SequenceBarProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3252
3225
  /** The current sequence (sparse — undefined means empty slot) */
3253
3226
  slots: Array<SlotItemData | undefined>;
3254
3227
  /** Max number of slots */
@@ -3282,7 +3255,7 @@ interface SequenceBarProps {
3282
3255
  /** Additional CSS classes */
3283
3256
  className?: string;
3284
3257
  }
3285
- declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, slotDropEvent, slotRemoveEvent, playing, currentStep, categoryColors, slotFeedback, size, className, }: SequenceBarProps): React__default.JSX.Element;
3258
+ declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, slotDropEvent, slotRemoveEvent, playing, currentStep, categoryColors, slotFeedback, size, className, ...rest }: SequenceBarProps): React__default.JSX.Element;
3286
3259
  declare namespace SequenceBar {
3287
3260
  var displayName: string;
3288
3261
  }
@@ -3348,7 +3321,7 @@ interface StateJsonTransition {
3348
3321
  * invented vocabulary against the orbital's event set. */
3349
3322
  event: string;
3350
3323
  }
3351
- interface StateJsonViewProps {
3324
+ interface StateJsonViewProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3352
3325
  /** Machine name */
3353
3326
  name: string;
3354
3327
  /** Initial state */
@@ -3364,7 +3337,7 @@ interface StateJsonViewProps {
3364
3337
  /** Additional CSS classes */
3365
3338
  className?: string;
3366
3339
  }
3367
- declare function StateJsonView({ name, initialState, states, transitions, label, defaultExpanded, className, }: StateJsonViewProps): React__default.JSX.Element;
3340
+ declare function StateJsonView({ name, initialState, states, transitions, label, defaultExpanded, className, ...rest }: StateJsonViewProps): React__default.JSX.Element;
3368
3341
  declare namespace StateJsonView {
3369
3342
  var displayName: string;
3370
3343
  }
@@ -3430,7 +3403,7 @@ declare const ALL_PRESETS: PhysicsPreset[];
3430
3403
  * layout out — no descriptor resolution, no runtime logic.
3431
3404
  */
3432
3405
 
3433
- interface GameShellProps {
3406
+ interface GameShellProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
3434
3407
  /** Application / game title shown as a floating chip */
3435
3408
  appName?: string;
3436
3409
  /** Stat chips row — floats along the top edge. Legacy chrome surface: new behaviors emit HUD chrome via `render-ui "hud-top"` instead. */
@@ -3560,7 +3533,7 @@ interface LearningTracePanel {
3560
3533
  /** Panel fill opacity (default 0.85). */
3561
3534
  backgroundOpacity?: number;
3562
3535
  }
3563
- interface LearningCanvasProps {
3536
+ interface LearningCanvasProps extends A11yProps {
3564
3537
  /** Additional CSS classes. */
3565
3538
  className?: string;
3566
3539
  /** Canvas width in CSS pixels. */
@@ -3609,6 +3582,8 @@ interface LearningCanvasProps {
3609
3582
  type?: string;
3610
3583
  index: number;
3611
3584
  }) => void;
3585
+ /** Text alternative for the canvas, rendered as visually hidden text and linked by aria-describedby. */
3586
+ description?: string;
3612
3587
  /** Loading state. */
3613
3588
  isLoading?: boolean;
3614
3589
  /** Error state. */
@@ -3703,7 +3678,7 @@ declare const NodeSlotEditor: React__default.FC<NodeSlotEditorProps>;
3703
3678
  * **Atomic Design**: Composed using Label and Typography atoms.
3704
3679
  */
3705
3680
 
3706
- interface FormFieldProps {
3681
+ interface FormFieldProps extends A11yProps {
3707
3682
  label: string;
3708
3683
  required?: boolean;
3709
3684
  error?: string;
@@ -3731,7 +3706,7 @@ interface EmptyStateSlotProps {
3731
3706
  emptyAction?: EmptyStateAction;
3732
3707
  }
3733
3708
  type EmptyStateLook = "illustrated" | "icon-only" | "text-only" | "mascot";
3734
- interface EmptyStateProps {
3709
+ interface EmptyStateProps extends A11yProps {
3735
3710
  /**
3736
3711
  * Icon to display. Accepts either:
3737
3712
  * - A Lucide icon component (LucideIcon)
@@ -3757,7 +3732,7 @@ interface EmptyStateProps {
3757
3732
  }
3758
3733
  declare const EmptyState: React__default.FC<EmptyStateProps>;
3759
3734
 
3760
- interface LoadingStateProps {
3735
+ interface LoadingStateProps extends A11yProps {
3761
3736
  title?: string;
3762
3737
  message?: string;
3763
3738
  className?: string;
@@ -3766,7 +3741,7 @@ interface LoadingStateProps {
3766
3741
  }
3767
3742
  declare const LoadingState: React__default.FC<LoadingStateProps>;
3768
3743
 
3769
- interface ErrorStateProps {
3744
+ interface ErrorStateProps extends A11yProps {
3770
3745
  title?: string;
3771
3746
  /** Error message to display */
3772
3747
  message?: string;
@@ -3779,13 +3754,19 @@ interface ErrorStateProps {
3779
3754
  }
3780
3755
  declare const ErrorState: React__default.FC<ErrorStateProps>;
3781
3756
 
3782
- type SkeletonVariant = 'header' | 'table' | 'form' | 'card' | 'text';
3783
- interface SkeletonProps {
3757
+ /**
3758
+ * Each variant mirrors the geometry of the component that replaces it, so the
3759
+ * swap from placeholder to content does not move the layout: `table` → TableView,
3760
+ * `list` → DataList, `grid` → DataGrid cards, `detail` → DetailPanel, `stats` →
3761
+ * stat tiles, `form` → Form, `card` / `header` / `text` for the rest.
3762
+ */
3763
+ type SkeletonVariant = 'header' | 'table' | 'list' | 'grid' | 'detail' | 'stats' | 'form' | 'card' | 'text';
3764
+ interface SkeletonProps extends A11yProps {
3784
3765
  /** The skeleton variant to render */
3785
3766
  variant?: SkeletonVariant;
3786
- /** Number of rows for table/text variants */
3767
+ /** Rows for table/list/text, cards for grid, field pairs for detail */
3787
3768
  rows?: number;
3788
- /** Number of columns for table variant */
3769
+ /** Columns for table, tiles for stats */
3789
3770
  columns?: number;
3790
3771
  /** Number of fields for form variant */
3791
3772
  fields?: number;
@@ -3793,10 +3774,8 @@ interface SkeletonProps {
3793
3774
  className?: string;
3794
3775
  }
3795
3776
  /**
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.
3777
+ * Skeleton — the loading placeholder. A loading state renders the variant shaped
3778
+ * like the content it gives way to; announced as a busy status region.
3800
3779
  *
3801
3780
  * @example
3802
3781
  * ```tsx
@@ -3809,7 +3788,7 @@ interface SkeletonProps {
3809
3788
  * </Suspense>
3810
3789
  * ```
3811
3790
  */
3812
- declare function Skeleton({ variant, rows, columns, fields, className, }: SkeletonProps): React__default.ReactElement;
3791
+ declare function Skeleton({ variant, rows, columns, fields, className, ...rest }: SkeletonProps): React__default.ReactElement;
3813
3792
  declare namespace Skeleton {
3814
3793
  var displayName: string;
3815
3794
  }
@@ -3847,7 +3826,7 @@ interface AccordionItem {
3847
3826
  */
3848
3827
  defaultOpen?: boolean;
3849
3828
  }
3850
- interface AccordionProps {
3829
+ interface AccordionProps extends A11yProps {
3851
3830
  /**
3852
3831
  * Accordion items
3853
3832
  */
@@ -3893,7 +3872,7 @@ declare const Accordion: React__default.FC<AccordionProps>;
3893
3872
  */
3894
3873
 
3895
3874
  type AlertVariant = "info" | "success" | "warning" | "error";
3896
- interface AlertProps {
3875
+ interface AlertProps extends A11yProps {
3897
3876
  /** Alert content (children or message) */
3898
3877
  children?: React__default.ReactNode;
3899
3878
  /** Alert message (alias for children) */
@@ -3947,7 +3926,7 @@ interface BreadcrumbItem {
3947
3926
  /** Event name to emit when clicked (for trait state machine integration) */
3948
3927
  event?: EventKey;
3949
3928
  }
3950
- interface BreadcrumbProps {
3929
+ interface BreadcrumbProps extends A11yProps {
3951
3930
  /**
3952
3931
  * Breadcrumb items. Omit together with `fromNavStack` to render the
3953
3932
  * orbital-scoped navigation stack instead of an authored trail.
@@ -4028,7 +4007,7 @@ interface FilterDefinition {
4028
4007
  *
4029
4008
  * @capabilities search refinement panel, facet filters, admin list filters, records filter sidebar, filter chips panel
4030
4009
  */
4031
- interface FilterGroupProps {
4010
+ interface FilterGroupProps extends A11yProps {
4032
4011
  /** Entity name to filter */
4033
4012
  entity: string;
4034
4013
  /** Filter definitions from schema */
@@ -4092,7 +4071,7 @@ interface ActionButton {
4092
4071
  /** Button variant - matches Button component variants. Accepts string for schema compatibility. */
4093
4072
  variant?: string;
4094
4073
  }
4095
- interface ButtonGroupProps {
4074
+ interface ButtonGroupProps extends A11yProps {
4096
4075
  /**
4097
4076
  * Button group content (Button components) - use this OR primary/secondary
4098
4077
  */
@@ -4176,7 +4155,7 @@ interface CommandPaletteCommand {
4176
4155
  * @payloadFor action */
4177
4156
  actionPayload?: EventPayload;
4178
4157
  }
4179
- interface CommandPaletteProps {
4158
+ interface CommandPaletteProps extends A11yProps {
4180
4159
  /** Whether the palette overlay is open */
4181
4160
  open: boolean;
4182
4161
  /** Called to open/close the overlay (Escape, overlay click, or a selection) */
@@ -4269,7 +4248,7 @@ declare namespace Card {
4269
4248
 
4270
4249
  type ContainerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
4271
4250
  type ContainerPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
4272
- interface ContainerProps {
4251
+ interface ContainerProps extends A11yProps {
4273
4252
  /** Maximum width */
4274
4253
  size?: ContainerSize;
4275
4254
  /** Alias for size (pattern compatibility) */
@@ -4302,7 +4281,7 @@ type FlexWrap = 'nowrap' | 'wrap' | 'wrap-reverse';
4302
4281
  type FlexAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
4303
4282
  type FlexJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
4304
4283
  type FlexGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
4305
- interface FlexProps {
4284
+ interface FlexProps extends A11yProps {
4306
4285
  /** Flex direction */
4307
4286
  direction?: FlexDirection;
4308
4287
  /** Flex wrap */
@@ -4369,7 +4348,8 @@ interface FloatingAction {
4369
4348
  */
4370
4349
  variant?: "primary" | "secondary" | "success" | "danger" | "warning";
4371
4350
  }
4372
- interface FloatingActionButtonProps {
4351
+ /** @accessibleName label */
4352
+ interface FloatingActionButtonProps extends A11yProps {
4373
4353
  /**
4374
4354
  * Declarative event name. When set, clicking the FAB emits `UI:{action}`
4375
4355
  * via the event bus and (if also provided) calls `onClick`. Mirrors the
@@ -4439,7 +4419,7 @@ interface ResponsiveGridCols {
4439
4419
  /** Extra large screens (1280px+) */
4440
4420
  xl?: GridCols;
4441
4421
  }
4442
- interface GridProps {
4422
+ interface GridProps extends A11yProps {
4443
4423
  /** Number of columns (can be responsive object) */
4444
4424
  cols?: GridCols | ResponsiveGridCols;
4445
4425
  /** Number of rows */
@@ -4477,7 +4457,7 @@ declare const Grid: React__default.FC<GridProps>;
4477
4457
  * Uses Input, Button, Icon, and Typography atoms.
4478
4458
  */
4479
4459
 
4480
- interface InputGroupProps extends Omit<InputProps, "icon" | "iconRight"> {
4460
+ interface InputGroupProps extends Omit<InputProps, "icon" | "iconRight" | keyof A11yProps>, A11yProps {
4481
4461
  /**
4482
4462
  * Left addon (icon, button, or text)
4483
4463
  */
@@ -4529,7 +4509,7 @@ interface MenuItem {
4529
4509
  subMenu?: MenuItem[];
4530
4510
  }
4531
4511
  type MenuPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-start" | "top-end" | "bottom-start" | "bottom-end";
4532
- interface MenuProps {
4512
+ interface MenuProps extends A11yProps {
4533
4513
  /** Menu trigger element */
4534
4514
  trigger: React__default.ReactNode;
4535
4515
  /** Menu items */
@@ -4567,7 +4547,7 @@ interface TopNavItemData {
4567
4547
  /** Child items shown in a dropdown. */
4568
4548
  children?: TopNavItemData[];
4569
4549
  }
4570
- interface TopNavItemProps {
4550
+ interface TopNavItemProps extends A11yProps {
4571
4551
  item: TopNavItemData;
4572
4552
  /** The href of the active page, used to mark the item (or its parent) active. */
4573
4553
  activeHref?: string;
@@ -4575,7 +4555,7 @@ interface TopNavItemProps {
4575
4555
  tone?: 'solid' | 'soft';
4576
4556
  className?: string;
4577
4557
  }
4578
- declare function TopNavItem({ item, activeHref, tone, className }: TopNavItemProps): React__default.ReactElement;
4558
+ declare function TopNavItem({ item, activeHref, tone, className, ...rest }: TopNavItemProps): React__default.ReactElement;
4579
4559
  declare namespace TopNavItem {
4580
4560
  var displayName: string;
4581
4561
  }
@@ -4593,7 +4573,7 @@ type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
4593
4573
  * `size` (which conveys content scale).
4594
4574
  */
4595
4575
  type ModalLook = "centered-card" | "top-sheet" | "side-drawer" | "full-screen";
4596
- interface ModalProps {
4576
+ interface ModalProps extends A11yProps {
4597
4577
  /** Whether the modal is open (defaults to true when rendered by slot wrapper) */
4598
4578
  isOpen?: boolean;
4599
4579
  /** Callback when modal should close (injected by slot wrapper) */
@@ -4642,7 +4622,7 @@ declare const Modal: React__default.FC<ModalProps>;
4642
4622
  * @packageDocumentation
4643
4623
  */
4644
4624
 
4645
- interface PageTransitionProps {
4625
+ interface PageTransitionProps extends A11yProps {
4646
4626
  /** Value that changes on navigation (a page path). */
4647
4627
  locationKey: string;
4648
4628
  children: React__default.ReactNode;
@@ -4669,7 +4649,7 @@ declare const PageTransition: React__default.FC<PageTransitionProps>;
4669
4649
  * layer over the nearest positioned ancestor (and `shake` items are inert).
4670
4650
  */
4671
4651
 
4672
- interface FxOverlayProps {
4652
+ interface FxOverlayProps extends A11yProps {
4673
4653
  /** 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
4654
  items: FxOverlayItem[];
4675
4655
  /** The fx mechanic's decay tick period in ms; per-item animation duration = maxTtl × tickMs. Default 500. */
@@ -4688,7 +4668,7 @@ declare const FxOverlay: React__default.FC<FxOverlayProps>;
4688
4668
  * Uses Button, Icon, Typography, and Input atoms.
4689
4669
  */
4690
4670
 
4691
- interface PaginationProps {
4671
+ interface PaginationProps extends A11yProps {
4692
4672
  /**
4693
4673
  * Current page (1-indexed)
4694
4674
  */
@@ -4761,7 +4741,7 @@ declare const Pagination: React__default.FC<PaginationProps>;
4761
4741
 
4762
4742
  type PopoverPosition = "top" | "bottom" | "left" | "right";
4763
4743
  type PopoverTrigger = "click" | "hover";
4764
- interface PopoverProps {
4744
+ interface PopoverProps extends A11yProps {
4765
4745
  /**
4766
4746
  * Popover content
4767
4747
  */
@@ -4813,7 +4793,7 @@ declare const Popover: React__default.FC<PopoverProps>;
4813
4793
 
4814
4794
  type CoachmarkPlacement = "top" | "bottom" | "left" | "right";
4815
4795
  type CoachmarkAnchor = React__default.RefObject<HTMLElement | null> | string | DOMRect;
4816
- interface CoachmarkProps {
4796
+ interface CoachmarkProps extends A11yProps {
4817
4797
  /** Controlled visibility. */
4818
4798
  open: boolean;
4819
4799
  /** The element to point at: a ref, a CSS selector, or a DOMRect. */
@@ -4900,7 +4880,7 @@ interface RelationOption {
4900
4880
  /** Whether this option is disabled */
4901
4881
  disabled?: boolean;
4902
4882
  }
4903
- interface RelationSelectProps {
4883
+ interface RelationSelectProps extends A11yProps {
4904
4884
  /** Current value (ID) */
4905
4885
  value?: string;
4906
4886
  /** Callback when value changes */
@@ -4942,7 +4922,7 @@ declare const RelationSelect: React__default.FC<RelationSelectProps>;
4942
4922
  /**
4943
4923
  * @minWidth 160
4944
4924
  */
4945
- interface SearchInputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'type'> {
4925
+ interface SearchInputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'type' | keyof A11yProps>, A11yProps {
4946
4926
  /**
4947
4927
  * Search value (controlled mode)
4948
4928
  */
@@ -5001,7 +4981,7 @@ declare const SearchInput: React__default.FC<SearchInputProps>;
5001
4981
  * API, used where the panel is always present in the component tree.
5002
4982
  */
5003
4983
 
5004
- interface SidePanelProps {
4984
+ interface SidePanelProps extends A11yProps {
5005
4985
  /**
5006
4986
  * Panel title
5007
4987
  */
@@ -5055,7 +5035,7 @@ declare const SidePanel: React__default.FC<SidePanelProps>;
5055
5035
  */
5056
5036
 
5057
5037
  type SimpleGridGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
5058
- interface SimpleGridProps {
5038
+ interface SimpleGridProps extends A11yProps {
5059
5039
  /** Minimum width of each child (e.g., 200, "200px", "15rem") */
5060
5040
  minChildWidth?: number | string;
5061
5041
  /** Maximum number of columns */
@@ -5068,6 +5048,10 @@ interface SimpleGridProps {
5068
5048
  className?: string;
5069
5049
  /** Children elements */
5070
5050
  children: React__default.ReactNode;
5051
+ /** Element id forwarded to the grid element. */
5052
+ id?: string;
5053
+ /** DOM attributes forwarded to the grid element (aria-*, data-*, role, id). */
5054
+ [attr: `aria-${string}` | `data-${string}`]: string | number | boolean | undefined;
5071
5055
  }
5072
5056
  /**
5073
5057
  * SimpleGrid - Auto-responsive grid layout
@@ -5109,7 +5093,7 @@ interface TabItem {
5109
5093
  /** Whether this tab is currently active (for controlled tabs) */
5110
5094
  active?: boolean;
5111
5095
  }
5112
- interface TabsProps {
5096
+ interface TabsProps extends A11yProps {
5113
5097
  /** Tab items */
5114
5098
  items?: TabItem[];
5115
5099
  /** Tab items (alias for items - used by generated code) */
@@ -5141,14 +5125,18 @@ declare const Tabs: React__default.FC<TabsProps>;
5141
5125
  */
5142
5126
 
5143
5127
  type ToastVariant = "success" | "error" | "info" | "warning";
5144
- interface ToastProps {
5128
+ interface ToastProps extends A11yProps {
5145
5129
  /** Toast variant */
5146
5130
  variant?: ToastVariant;
5147
5131
  /** Toast message */
5148
5132
  message: string;
5149
5133
  /** Toast title (optional) */
5150
5134
  title?: string;
5151
- /** Auto-dismiss duration in milliseconds (0 = no auto-dismiss) */
5135
+ /**
5136
+ * Auto-dismiss duration in milliseconds (0 = no auto-dismiss). The timer
5137
+ * pauses while the toast is hovered or focused, and a toast carrying an
5138
+ * action (`actionLabel` with `onAction`/`actionEvent`) never auto-dismisses.
5139
+ */
5152
5140
  duration?: number;
5153
5141
  /** Show dismiss button */
5154
5142
  dismissible?: boolean;
@@ -5177,7 +5165,7 @@ declare const Toast: React__default.FC<ToastProps>;
5177
5165
  */
5178
5166
 
5179
5167
  type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
5180
- interface TooltipProps {
5168
+ interface TooltipProps extends A11yProps {
5181
5169
  /** Tooltip content */
5182
5170
  content: React__default.ReactNode;
5183
5171
  /** Tooltip trigger element (ReactElement or ReactNode that will be wrapped in span) */
@@ -5201,6 +5189,7 @@ declare const Tooltip: React__default.FC<TooltipProps>;
5201
5189
  * screens, where the tap is the action).
5202
5190
  */
5203
5191
 
5192
+ /** @accessibleName label */
5204
5193
  interface IconButtonProps extends Omit<ButtonProps, 'children' | 'label' | 'icon' | 'leftIcon' | 'rightIcon' | 'iconRight'> {
5205
5194
  icon: IconInput;
5206
5195
  /** What the button does — its accessible name and its tooltip. */
@@ -5229,7 +5218,7 @@ declare const IconButton: React__default.ForwardRefExoticComponent<IconButtonPro
5229
5218
 
5230
5219
  type DrawerPosition = "left" | "right";
5231
5220
  type DrawerSize = "sm" | "md" | "lg" | "xl" | "full";
5232
- interface DrawerProps {
5221
+ interface DrawerProps extends A11yProps {
5233
5222
  /** Whether the drawer is open (defaults to true when rendered by slot wrapper) */
5234
5223
  isOpen?: boolean;
5235
5224
  /** Fires after the exit animation completes (the drawer is about to unmount). */
@@ -5282,7 +5271,7 @@ interface WizardProgressStep {
5282
5271
  /** Step description (optional) */
5283
5272
  description?: string;
5284
5273
  }
5285
- interface WizardProgressProps {
5274
+ interface WizardProgressProps extends A11yProps {
5286
5275
  /** Step definitions (compatible with WizardContainer's WizardStep). A string is shorthand for `{ id: str, title: str }`. */
5287
5276
  steps?: (WizardProgressStep | string)[];
5288
5277
  /** Current step index (0-based) */
@@ -5320,7 +5309,7 @@ declare const WizardProgress: React__default.FC<WizardProgressProps>;
5320
5309
  * Uses wireframe theme styling (high contrast, sharp edges).
5321
5310
  */
5322
5311
 
5323
- interface WizardNavigationProps {
5312
+ interface WizardNavigationProps extends A11yProps {
5324
5313
  /** Current step index (0-based) */
5325
5314
  currentStep: number;
5326
5315
  /** Total number of steps */
@@ -5386,7 +5375,7 @@ declare const WizardNavigation: React__default.FC<WizardNavigationProps>;
5386
5375
  * DocumentViewer and `<svg>` in JazariStateMachine/StateMachineView.
5387
5376
  */
5388
5377
 
5389
- interface MarkdownContentProps {
5378
+ interface MarkdownContentProps extends A11yProps {
5390
5379
  /** The markdown content to render */
5391
5380
  content: string;
5392
5381
  /** Text direction (defaults to ltr; `ltr` is first so the generated config seeds it) */
@@ -5526,7 +5515,7 @@ interface CodeViewerFile {
5526
5515
  code: string;
5527
5516
  language?: CodeLanguage;
5528
5517
  }
5529
- interface CodeBlockProps {
5518
+ interface CodeBlockProps extends A11yProps {
5530
5519
  /** The code content to display */
5531
5520
  code?: string;
5532
5521
  /** Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered) */
@@ -5733,7 +5722,7 @@ declare const CodeBlock: React__default.NamedExoticComponent<CodeBlockProps>;
5733
5722
  *
5734
5723
  * @capabilities multiple-choice quiz, test question, exam item, assessment question, knowledge check, trivia question
5735
5724
  */
5736
- interface QuizBlockProps {
5725
+ interface QuizBlockProps extends A11yProps {
5737
5726
  /** The quiz question */
5738
5727
  question: string;
5739
5728
  /** The quiz answer (revealed on toggle) */
@@ -5758,7 +5747,7 @@ declare const QuizBlock: React__default.FC<QuizBlockProps>;
5758
5747
  * - entityAware: false
5759
5748
  */
5760
5749
 
5761
- interface ScaledDiagramProps {
5750
+ interface ScaledDiagramProps extends A11yProps {
5762
5751
  children: React__default.ReactNode;
5763
5752
  className?: string;
5764
5753
  }
@@ -5786,7 +5775,7 @@ interface CalendarEventRow {
5786
5775
  endTime?: string;
5787
5776
  color?: string;
5788
5777
  }
5789
- interface CalendarGridProps {
5778
+ interface CalendarGridProps extends A11yProps {
5790
5779
  /** Start of the week (defaults to current week's Monday) */
5791
5780
  weekStart?: Date;
5792
5781
  /** Time slot labels (defaults to 09:00-17:00) */
@@ -5854,7 +5843,7 @@ interface CalendarGridProps {
5854
5843
  */
5855
5844
  renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
5856
5845
  }
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;
5846
+ declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, endField, colorField, children, renderItem, ...rest }: CalendarGridProps): React__default.JSX.Element;
5858
5847
  declare namespace CalendarGrid {
5859
5848
  var displayName: string;
5860
5849
  }
@@ -5884,7 +5873,7 @@ interface GanttLink {
5884
5873
  * @capabilities gantt chart, project timeline, schedule view, task bars, dependency arrows, roadmap, milestone plan
5885
5874
  * @fieldsContract display
5886
5875
  */
5887
- interface GanttProps {
5876
+ interface GanttProps extends A11yProps {
5888
5877
  /**
5889
5878
  * Schema entity data — the task rows to place on the axis. pattern-sync tags
5890
5879
  * it `kind:"entity", cardinality:"collection"` so consumers bind the domain
@@ -5927,7 +5916,7 @@ interface GanttProps {
5927
5916
  /** Error state */
5928
5917
  error?: UiError | null;
5929
5918
  }
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;
5919
+ declare function Gantt({ tasks, links, titleField, startField, endField, durationField, statusField, statusColorMap, groupField, rangeStart, rangeEnd, showToday, dayWidth, barClickEvent, className, isLoading, error, ...rest }: GanttProps): React__default.JSX.Element;
5931
5920
  declare namespace Gantt {
5932
5921
  var displayName: string;
5933
5922
  }
@@ -5960,7 +5949,7 @@ type RepeatableItem = {
5960
5949
  *
5961
5950
  * @capabilities dynamic line items, repeatable field group, add/remove entry rows, multi-entry form block
5962
5951
  */
5963
- interface RepeatableFormSectionProps {
5952
+ interface RepeatableFormSectionProps extends A11yProps {
5964
5953
  /** Section type identifier */
5965
5954
  sectionType: string;
5966
5955
  /** Section title */
@@ -6025,7 +6014,7 @@ type ViolationRecord = {
6025
6014
  /** Tab/form where violation occurred */
6026
6015
  tabId?: string;
6027
6016
  };
6028
- interface ViolationAlertProps {
6017
+ interface ViolationAlertProps extends A11yProps {
6029
6018
  /** Violation data */
6030
6019
  violation: ViolationRecord;
6031
6020
  /** Visual severity (derived from actionType if not specified) */
@@ -6052,7 +6041,7 @@ declare const ViolationAlert: React__default.FC<ViolationAlertProps>;
6052
6041
  * Provides consistent styling and interaction for section headers.
6053
6042
  */
6054
6043
 
6055
- interface FormSectionHeaderProps {
6044
+ interface FormSectionHeaderProps extends A11yProps {
6056
6045
  /** Section title */
6057
6046
  title: string;
6058
6047
  /** Section subtitle */
@@ -6088,7 +6077,7 @@ declare const FormSectionHeader: React__default.FC<FormSectionHeaderProps>;
6088
6077
  *
6089
6078
  * @capabilities flashcard, study deck, spaced-repetition review card, memorization drill, quiz reveal card, question/answer card, before/after reveal, term-and-definition card
6090
6079
  */
6091
- interface FlipCardProps {
6080
+ interface FlipCardProps extends A11yProps {
6092
6081
  /** Content rendered on the front face */
6093
6082
  front: React__default.ReactNode;
6094
6083
  /** Content rendered on the back face */
@@ -6103,7 +6092,7 @@ interface FlipCardProps {
6103
6092
  height?: string;
6104
6093
  }
6105
6094
  declare const FlipCard: {
6106
- ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): React__default.JSX.Element;
6095
+ ({ front, back, flipped, onFlip, className, height, ...rest }: FlipCardProps): React__default.JSX.Element;
6107
6096
  displayName: string;
6108
6097
  };
6109
6098
 
@@ -6205,7 +6194,7 @@ declare const IconPicker: React__default.FC<IconPickerProps>;
6205
6194
  */
6206
6195
 
6207
6196
  type EmojiPickerPosition = 'top' | 'bottom';
6208
- interface EmojiPickerProps {
6197
+ interface EmojiPickerProps extends A11yProps {
6209
6198
  /**
6210
6199
  * Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus
6211
6200
  */
@@ -6262,7 +6251,7 @@ interface DateRangePickerPreset {
6262
6251
  */
6263
6252
  range?: (() => DateRange) | DateRange;
6264
6253
  }
6265
- interface DateRangePickerProps {
6254
+ interface DateRangePickerProps extends A11yProps {
6266
6255
  /** Controlled `from` (ISO date YYYY-MM-DD). */
6267
6256
  from?: string;
6268
6257
  /** Controlled `to` (ISO date YYYY-MM-DD). */
@@ -6305,7 +6294,7 @@ interface DateRangeSelectorOption {
6305
6294
  label: string;
6306
6295
  value: string;
6307
6296
  }
6308
- interface DateRangeSelectorProps {
6297
+ interface DateRangeSelectorProps extends A11yProps {
6309
6298
  /** Available range options */
6310
6299
  options?: DateRangeSelectorOption[];
6311
6300
  /** Currently selected value */
@@ -6328,7 +6317,7 @@ interface ChartLegendItem {
6328
6317
  label: string;
6329
6318
  color: string;
6330
6319
  }
6331
- interface ChartLegendProps {
6320
+ interface ChartLegendProps extends A11yProps {
6332
6321
  /** Legend items with label and color */
6333
6322
  items: ChartLegendItem[];
6334
6323
  /** Additional CSS classes */
@@ -6359,7 +6348,7 @@ interface ChartDataPoint {
6359
6348
  value: number;
6360
6349
  label?: string;
6361
6350
  }
6362
- interface LineChartProps {
6351
+ interface LineChartProps extends A11yProps {
6363
6352
  /** Data points to plot */
6364
6353
  data: ChartDataPoint[];
6365
6354
  /** SVG viewBox width */
@@ -6390,7 +6379,7 @@ declare const LineChart: React__default.FC<LineChartProps>;
6390
6379
 
6391
6380
  type DotState = 'active' | 'complete' | 'pending';
6392
6381
  type DotSize = 'sm' | 'md' | 'lg';
6393
- interface ProgressDotsProps {
6382
+ interface ProgressDotsProps extends A11yProps {
6394
6383
  /** Total number of dots */
6395
6384
  count: number;
6396
6385
  /** Current active index (0-based) */
@@ -6518,7 +6507,7 @@ interface MathHop {
6518
6507
  /** Hop label, centered above the arc. */
6519
6508
  label?: string;
6520
6509
  }
6521
- interface MathCanvasProps {
6510
+ interface MathCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
6522
6511
  className?: string;
6523
6512
  width?: number;
6524
6513
  height?: number;
@@ -6812,7 +6801,7 @@ interface PhysicsMeter {
6812
6801
  /** Bar + value color (default '#3b82f6'). */
6813
6802
  color?: string;
6814
6803
  }
6815
- interface PhysicsCanvasProps {
6804
+ interface PhysicsCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
6816
6805
  className?: string;
6817
6806
  width?: number;
6818
6807
  height?: number;
@@ -7021,7 +7010,7 @@ interface BiologyHelix3D {
7021
7010
  /** Spread multiplier for unwound rungs (default 1.8). */
7022
7011
  unwindSpread?: number;
7023
7012
  }
7024
- interface BiologyCanvasProps {
7013
+ interface BiologyCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7025
7014
  className?: string;
7026
7015
  width?: number;
7027
7016
  height?: number;
@@ -7214,7 +7203,7 @@ interface ChemistryLattice3D {
7214
7203
  /** Selected-site color (default '#f59e0b'). */
7215
7204
  selectedColor?: string;
7216
7205
  }
7217
- interface ChemistryCanvasProps {
7206
+ interface ChemistryCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7218
7207
  className?: string;
7219
7208
  width?: number;
7220
7209
  height?: number;
@@ -7362,7 +7351,7 @@ interface AlgorithmAxisLabel {
7362
7351
  text: string;
7363
7352
  color?: string;
7364
7353
  }
7365
- interface AlgorithmCanvasProps {
7354
+ interface AlgorithmCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7366
7355
  className?: string;
7367
7356
  width?: number;
7368
7357
  height?: number;
@@ -7450,7 +7439,7 @@ interface AlgoGraphEdge {
7450
7439
  state?: AlgoGraphEdgeState;
7451
7440
  color?: string;
7452
7441
  }
7453
- interface AlgoGraphCanvasProps {
7442
+ interface AlgoGraphCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
7454
7443
  className?: string;
7455
7444
  width?: number;
7456
7445
  height?: number;
@@ -7508,7 +7497,9 @@ declare const AlgoGraphCanvas: React$1.FC<AlgoGraphCanvasProps>;
7508
7497
 
7509
7498
  /** A point in scene space: `[x, y, z]` — x/y the ground plane, z the height (cells). */
7510
7499
  type Learning3DPoint = [number, number, number];
7511
- interface LearningScene3DProps {
7500
+ interface LearningScene3DProps extends A11yProps {
7501
+ /** Text alternative for the scene, rendered as visually hidden text and linked by aria-describedby. */
7502
+ description?: string;
7512
7503
  className?: string;
7513
7504
  width?: number;
7514
7505
  height?: number;
@@ -7533,7 +7524,7 @@ interface LearningScene3DProps {
7533
7524
  /** Fires with the `id` of a clicked descriptor (descriptors carry `id` via DrawableBase). */
7534
7525
  onItemClick?: (id: string) => void;
7535
7526
  }
7536
- declare function LearningScene3D({ className, width, height, title, backgroundColor, drawables, camera, lighting, post, showGrid, shadows, interactive, isLoading, error, onItemClick, }: LearningScene3DProps): React$1.JSX.Element;
7527
+ 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
7528
  declare namespace LearningScene3D {
7538
7529
  var displayName: string;
7539
7530
  }
@@ -7592,7 +7583,7 @@ interface GraphViewEdge {
7592
7583
  color?: string;
7593
7584
  label?: string;
7594
7585
  }
7595
- interface GraphViewProps {
7586
+ interface GraphViewProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
7596
7587
  /** Graph nodes */
7597
7588
  nodes: GraphViewNode[];
7598
7589
  /** Graph edges */
@@ -7672,7 +7663,7 @@ interface MapRouteData {
7672
7663
  /** Label shown in a popup at the midpoint */
7673
7664
  label?: string;
7674
7665
  }
7675
- interface MapViewProps {
7666
+ interface MapViewProps extends A11yProps {
7676
7667
  /** Array of markers to display */
7677
7668
  markers?: MapMarkerData[];
7678
7669
  /** Routes (polylines with optional popups) drawn over the tile layer */
@@ -7711,7 +7702,8 @@ interface MapViewProps {
7711
7702
  declare function MapView(props: MapViewProps): React__default.JSX.Element;
7712
7703
 
7713
7704
  type NumberStepperSize = "sm" | "md" | "lg";
7714
- interface NumberStepperProps {
7705
+ /** @accessibleName label */
7706
+ interface NumberStepperProps extends A11yProps {
7715
7707
  /** Current value */
7716
7708
  value?: number;
7717
7709
  /** Minimum value */
@@ -7743,7 +7735,8 @@ declare const NumberStepper: React__default.FC<NumberStepperProps>;
7743
7735
 
7744
7736
  type StarRatingSize = "sm" | "md" | "lg";
7745
7737
  type StarRatingPrecision = "full" | "half";
7746
- interface StarRatingProps {
7738
+ /** @accessibleName label */
7739
+ interface StarRatingProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
7747
7740
  /** Current rating value */
7748
7741
  value?: number;
7749
7742
  /** Maximum number of stars */
@@ -7771,7 +7764,7 @@ interface StarRatingProps {
7771
7764
  }
7772
7765
  declare const StarRating: React__default.FC<StarRatingProps>;
7773
7766
 
7774
- interface UploadDropZoneProps {
7767
+ interface UploadDropZoneProps extends A11yProps {
7775
7768
  /** Accepted MIME types (e.g., "image/*", "application/pdf") */
7776
7769
  accept?: string;
7777
7770
  /** Max file size in bytes */
@@ -7811,7 +7804,7 @@ interface LightboxImage {
7811
7804
  alt?: string;
7812
7805
  caption?: string;
7813
7806
  }
7814
- interface LightboxProps {
7807
+ interface LightboxProps extends A11yProps {
7815
7808
  /** Array of images to display */
7816
7809
  images: LightboxImage[];
7817
7810
  /** Current image index */
@@ -7858,6 +7851,11 @@ declare const Lightbox: React__default.FC<LightboxProps>;
7858
7851
  * evaluated by the one helper below.
7859
7852
  */
7860
7853
  type RowActionCondition = SExpr$1 | ((row: EntityRow) => boolean);
7854
+ /**
7855
+ * What an action item's `payload` holds: the authored `(fn row { key: <expr> })`
7856
+ * S-expression, or the compiled shell's `(row) => payload` closure.
7857
+ */
7858
+ type RowActionPayload = SExpr$1 | ((row: EntityRow) => EventPayload);
7861
7859
 
7862
7860
  /**
7863
7861
  * useDataDnd — shared drag-drop machinery for DataList + DataGrid.
@@ -7934,6 +7932,8 @@ interface DataGridItemAction {
7934
7932
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
7935
7933
  /** Per-row condition, authored as `(fn row <bool>)`: the row's button is drawn only when it returns true. Omit = always shown. */
7936
7934
  when?: RowActionCondition;
7935
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
7936
+ payload?: RowActionPayload;
7937
7937
  }
7938
7938
  /**
7939
7939
  * DataGrid — structured records grid rendering rows over configurable columns,
@@ -7943,7 +7943,7 @@ interface DataGridItemAction {
7943
7943
  * @fieldsContract display
7944
7944
  * @minWidth 200
7945
7945
  */
7946
- interface DataGridProps extends DataDndProps, EmptyStateSlotProps {
7946
+ interface DataGridProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
7947
7947
  /**
7948
7948
  * Schema entity data — the collection of rows to render. pattern-sync tags
7949
7949
  * it `kind:"entity", cardinality:"collection"` so consumers bind the domain
@@ -8015,7 +8015,7 @@ interface DataGridProps extends DataDndProps, EmptyStateSlotProps {
8015
8015
  * field whose type is relation. Same contract DetailPanel takes. */
8016
8016
  relationsData?: Record<string, readonly RelationOption[]>;
8017
8017
  }
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;
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, ...rest }: DataGridProps): string | number | bigint | boolean | React__default.JSX.Element | 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> | null | undefined;
8019
8019
  declare namespace DataGrid {
8020
8020
  var displayName: string;
8021
8021
  }
@@ -8048,6 +8048,8 @@ interface DataListItemAction {
8048
8048
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
8049
8049
  /** Per-row condition, authored as `(fn row <bool>)`: the row's button is drawn only when it returns true. Omit = always shown. */
8050
8050
  when?: RowActionCondition;
8051
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
8052
+ payload?: RowActionPayload;
8051
8053
  }
8052
8054
  interface DataListSwipeAction {
8053
8055
  /** Button label */
@@ -8061,7 +8063,7 @@ interface DataListSwipeAction {
8061
8063
  * @fieldsContract display
8062
8064
  * @minWidth 200
8063
8065
  */
8064
- interface DataListProps extends DataDndProps, EmptyStateSlotProps {
8066
+ interface DataListProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
8065
8067
  /**
8066
8068
  * Schema entity data — the collection of rows to render.
8067
8069
  */
@@ -8169,7 +8171,7 @@ interface DataListProps extends DataDndProps, EmptyStateSlotProps {
8169
8171
  * field whose type is relation. Same contract DetailPanel takes. */
8170
8172
  relationsData?: Record<string, readonly RelationOption[]>;
8171
8173
  }
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;
8174
+ 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, ...rest }: DataListProps): string | number | bigint | boolean | React__default.JSX.Element | 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> | null | undefined;
8173
8175
  declare namespace DataList {
8174
8176
  var displayName: string;
8175
8177
  }
@@ -8231,6 +8233,8 @@ interface TableViewItemAction {
8231
8233
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
8232
8234
  /** Per-row condition, authored as `(fn row <bool>)`: the row's menu item is drawn only when it returns true. Omit = always shown. */
8233
8235
  when?: RowActionCondition;
8236
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
8237
+ payload?: RowActionPayload;
8234
8238
  }
8235
8239
  /**
8236
8240
  * TableView — sortable, selectable data table rendering rows over configurable
@@ -8240,7 +8244,7 @@ interface TableViewItemAction {
8240
8244
  * @fieldsContract display
8241
8245
  * @minWidth 240
8242
8246
  */
8243
- interface TableViewProps extends DataDndProps, EmptyStateSlotProps {
8247
+ interface TableViewProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
8244
8248
  /** Schema entity data — the collection of rows to render. */
8245
8249
  entity: readonly EntityRow[];
8246
8250
  /** Column definitions. The compiler emits `columns`; `fields` is the alias. */
@@ -8307,7 +8311,7 @@ interface TableViewProps extends DataDndProps, EmptyStateSlotProps {
8307
8311
  * column whose field is relation-typed. Same contract DetailPanel takes. */
8308
8312
  relationsData?: Record<string, readonly RelationOption[]>;
8309
8313
  }
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;
8314
+ 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, ...rest }: TableViewProps): React__default.JSX.Element;
8311
8315
  declare namespace TableView {
8312
8316
  var displayName: string;
8313
8317
  }
@@ -8321,7 +8325,7 @@ declare namespace TableView {
8321
8325
  */
8322
8326
 
8323
8327
  type StatDisplayLook = 'elevated' | 'flat' | 'progress-backed' | 'gauge' | 'sparkline';
8324
- interface StatDisplayProps {
8328
+ interface StatDisplayProps extends A11yProps {
8325
8329
  /** Display label (e.g., "Total", "Remaining") */
8326
8330
  label: string;
8327
8331
  /** Primary value (number or formatted string) */
@@ -8389,7 +8393,7 @@ interface MeterAction {
8389
8393
  navigatesTo?: string;
8390
8394
  variant?: "primary" | "secondary" | "ghost";
8391
8395
  }
8392
- interface MeterProps {
8396
+ interface MeterProps extends A11yProps {
8393
8397
  /** Current value */
8394
8398
  value: number;
8395
8399
  /** Minimum value */
@@ -8440,7 +8444,7 @@ interface SwipeAction {
8440
8444
  /** Per-row condition, authored as `(fn row <bool>)`: the swipe action is revealed only when it returns true. Omit = always shown. */
8441
8445
  when?: RowActionCondition;
8442
8446
  }
8443
- interface SwipeableRowProps {
8447
+ interface SwipeableRowProps extends A11yProps {
8444
8448
  leftActions?: SwipeAction[];
8445
8449
  rightActions?: SwipeAction[];
8446
8450
  threshold?: number;
@@ -8462,7 +8466,7 @@ declare const SwipeableRow: React__default.FC<SwipeableRowProps>;
8462
8466
  *
8463
8467
  * @capabilities checklist, task list, to-do list, priority list, ranked list, drag-to-reorder queue
8464
8468
  */
8465
- interface SortableListProps {
8469
+ interface SortableListProps extends A11yProps {
8466
8470
  items: readonly EntityRow[];
8467
8471
  /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
8468
8472
  renderItem: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -8477,7 +8481,7 @@ interface SortableListProps {
8477
8481
  dragHandlePosition?: 'left' | 'right';
8478
8482
  className?: string;
8479
8483
  }
8480
- declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, }: SortableListProps): React__default.JSX.Element;
8484
+ declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, ...rest }: SortableListProps): React__default.JSX.Element;
8481
8485
  declare const SortableList: typeof SortableListInner;
8482
8486
 
8483
8487
  /**
@@ -8494,7 +8498,7 @@ interface CarouselItem {
8494
8498
  title?: string;
8495
8499
  image?: AssetUrl;
8496
8500
  }
8497
- interface CarouselProps<T = CarouselItem> {
8501
+ interface CarouselProps<T = CarouselItem> extends A11yProps {
8498
8502
  /** Array of items to display as slides */
8499
8503
  items: T[];
8500
8504
  /** Render function for each slide. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
@@ -8522,7 +8526,7 @@ interface CarouselProps<T = CarouselItem> {
8522
8526
  /** Additional CSS classes */
8523
8527
  className?: string;
8524
8528
  }
8525
- declare const Carousel: <T = CarouselItem>({ items, renderItem, children, autoPlay, autoPlayInterval, showDots, showArrows, loop, slideChangeEvent, slideChangePayload, className, }: CarouselProps<T>) => React__default.ReactElement | null;
8529
+ declare const Carousel: <T = CarouselItem>({ items, renderItem, children, autoPlay, autoPlayInterval, showDots, showArrows, loop, slideChangeEvent, slideChangePayload, className, ...rest }: CarouselProps<T>) => React__default.ReactElement | null;
8526
8530
 
8527
8531
  /**
8528
8532
  * PullToRefresh Molecule Component
@@ -8532,7 +8536,7 @@ declare const Carousel: <T = CarouselItem>({ items, renderItem, children, autoPl
8532
8536
  * a refresh event via the event bus when the threshold is met.
8533
8537
  */
8534
8538
 
8535
- interface PullToRefreshProps {
8539
+ interface PullToRefreshProps extends A11yProps {
8536
8540
  /** Event name to emit on refresh (emitted as UI:{refreshEvent}) */
8537
8541
  refreshEvent: EventKey;
8538
8542
  /** Payload to include with the refresh event
@@ -8561,7 +8565,7 @@ declare const PullToRefresh: React__default.FC<PullToRefreshProps>;
8561
8565
  *
8562
8566
  * @capabilities feature highlight, benefit callout, product capability card, feature-grid tile
8563
8567
  */
8564
- interface FeatureCardProps {
8568
+ interface FeatureCardProps extends A11yProps {
8565
8569
  icon?: IconInput;
8566
8570
  /** Feature title */
8567
8571
  title: string;
@@ -8587,7 +8591,7 @@ declare const FeatureCard: React__default.FC<FeatureCardProps>;
8587
8591
  * Composes SimpleGrid and FeatureCard molecules.
8588
8592
  */
8589
8593
 
8590
- interface FeatureGridProps {
8594
+ interface FeatureGridProps extends A11yProps {
8591
8595
  /** Array of feature card configurations */
8592
8596
  items: FeatureCardProps[];
8593
8597
  /** Number of grid columns */
@@ -8606,7 +8610,7 @@ declare const FeatureGrid: React__default.FC<FeatureGridProps>;
8606
8610
  * later value changes. Optional label below the number.
8607
8611
  */
8608
8612
 
8609
- interface AnimatedCounterProps {
8613
+ interface AnimatedCounterProps extends A11yProps {
8610
8614
  /** Target value. Strings may carry display affixes (e.g. "500+", "99.9%", "$1.2M"). */
8611
8615
  value: string | number;
8612
8616
  /** Label displayed below the number */
@@ -8640,7 +8644,7 @@ interface SocialProofItem {
8640
8644
  /** Optional quote or testimonial text */
8641
8645
  quote?: string;
8642
8646
  }
8643
- interface SocialProofProps {
8647
+ interface SocialProofProps extends A11yProps {
8644
8648
  /** List of social proof items */
8645
8649
  items: SocialProofItem[];
8646
8650
  /** Display variant */
@@ -8673,7 +8677,7 @@ declare const SocialProof: React__default.FC<SocialProofProps>;
8673
8677
  * (`[string]` config knobs without `enumValues`).
8674
8678
  */
8675
8679
 
8676
- interface TagInputProps {
8680
+ interface TagInputProps extends A11yProps {
8677
8681
  /** Current list of tags. */
8678
8682
  value: ReadonlyArray<string>;
8679
8683
  /** Direct callback emitted on every change. Stays as the
@@ -8787,7 +8791,7 @@ type VoteStackVariant = "vertical" | "horizontal";
8787
8791
  * std atoms to drop their string sentinel.
8788
8792
  */
8789
8793
  type VoteValue = "up" | "down" | "none" | null;
8790
- interface VoteStackProps {
8794
+ interface VoteStackProps extends A11yProps {
8791
8795
  /** Current tally */
8792
8796
  count: number;
8793
8797
  /** Current user's vote (null = no vote cast) */
@@ -8819,7 +8823,7 @@ interface LikertOption {
8819
8823
  /** Visible label below (radios) or inside (buttons) the control */
8820
8824
  label: string;
8821
8825
  }
8822
- interface LikertScaleProps {
8826
+ interface LikertScaleProps extends A11yProps {
8823
8827
  /** Optional row prompt above the scale */
8824
8828
  question?: string;
8825
8829
  /** Scale points (defaults to a translated 5-point agree/disagree set) */
@@ -8855,7 +8859,7 @@ interface MatrixColumn {
8855
8859
  value: number | string;
8856
8860
  label: string;
8857
8861
  }
8858
- interface MatrixQuestionProps {
8862
+ interface MatrixQuestionProps extends A11yProps {
8859
8863
  /** Optional title rendered above the matrix */
8860
8864
  title?: string;
8861
8865
  /** Question rows */
@@ -8894,7 +8898,7 @@ type QrScanResult = EventPayload & {
8894
8898
  format: string;
8895
8899
  timestamp: number;
8896
8900
  };
8897
- interface QrScannerProps {
8901
+ interface QrScannerProps extends A11yProps {
8898
8902
  onScan?: (result: QrScanResult) => void;
8899
8903
  scanEvent?: EventEmit<QrScanResult>;
8900
8904
  onError?: (error: Error) => void;
@@ -8933,7 +8937,7 @@ type OptionConstraint = {
8933
8937
  min?: number;
8934
8938
  max?: number;
8935
8939
  };
8936
- interface OptionConstraintGroupProps {
8940
+ interface OptionConstraintGroupProps extends A11yProps {
8937
8941
  groupId: string;
8938
8942
  title: string;
8939
8943
  description?: string;
@@ -8966,7 +8970,7 @@ interface CanvasItemRow {
8966
8970
  status?: CanvasItemStatus;
8967
8971
  shape?: CanvasItemShape;
8968
8972
  }
8969
- interface PositionedCanvasProps {
8973
+ interface PositionedCanvasProps extends A11yProps {
8970
8974
  /**
8971
8975
  * Items to render. The molecule narrows non-array values to `[]` and reads
8972
8976
  * each row's `id` / `x` / `y` / `label` fields at render time.
@@ -9009,7 +9013,7 @@ declare const PositionedCanvas: React__default.FC<PositionedCanvasProps>;
9009
9013
  * always sees the latest content.
9010
9014
  */
9011
9015
 
9012
- interface RichTextEditorProps {
9016
+ interface RichTextEditorProps extends A11yProps {
9013
9017
  /** The rich text content as HTML. Sanitized before rendering and on every change. */
9014
9018
  value?: string;
9015
9019
  onChange?: (value: string) => void;
@@ -9055,7 +9059,7 @@ interface DocumentPanelAction {
9055
9059
  *
9056
9060
  * @capabilities document page, note editor, wiki page, article editor, writing surface, rich text document, content editing canvas
9057
9061
  */
9058
- interface DocumentPanelProps {
9062
+ interface DocumentPanelProps extends A11yProps {
9059
9063
  /** The record's id — carried on every commit and action event. */
9060
9064
  id?: string;
9061
9065
  /** Document title (falls back to "Untitled" for a blank draft) */
@@ -9103,7 +9107,7 @@ interface DocumentPanelProps {
9103
9107
  placeholder?: string;
9104
9108
  className?: string;
9105
9109
  }
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;
9110
+ 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
9111
 
9108
9112
  /**
9109
9113
  * DocumentDetails Molecule
@@ -9153,7 +9157,7 @@ interface DocumentDetailsField {
9153
9157
  * @capabilities document settings, page details, post settings sidebar, metadata panel, document properties, publish settings
9154
9158
  * @fieldsContract display
9155
9159
  */
9156
- interface DocumentDetailsProps {
9160
+ interface DocumentDetailsProps extends A11yProps {
9157
9161
  /** The loaded record — supplies the id every commit carries and the
9158
9162
  * values the rows read. */
9159
9163
  entity?: EntityRow;
@@ -9177,7 +9181,7 @@ interface DocumentDetailsProps {
9177
9181
  title?: string;
9178
9182
  className?: string;
9179
9183
  }
9180
- declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, title, className, }: DocumentDetailsProps): React__default.ReactElement | null;
9184
+ declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, title, className, ...rest }: DocumentDetailsProps): React__default.ReactElement | null;
9181
9185
 
9182
9186
  /**
9183
9187
  * ReplyTree Organism Component
@@ -9198,7 +9202,7 @@ interface ReplyNodeRow {
9198
9202
  collapsed?: boolean;
9199
9203
  replies?: readonly EntityWith<ReplyNodeRow>[];
9200
9204
  }
9201
- interface ReplyTreeProps {
9205
+ interface ReplyTreeProps extends A11yProps {
9202
9206
  nodes: readonly EntityWith<ReplyNodeRow>[];
9203
9207
  maxDepth?: number;
9204
9208
  onVote?: (nodeId: string, vote: VoteValue) => void;
@@ -9238,7 +9242,7 @@ interface BranchingRule extends EventPayload {
9238
9242
  value: string | string[];
9239
9243
  targetQuestionId: string | typeof END_OF_SURVEY;
9240
9244
  }
9241
- interface BranchingLogicBuilderProps {
9245
+ interface BranchingLogicBuilderProps extends A11yProps {
9242
9246
  questions: readonly BranchingQuestion[] | EventPayloadValue;
9243
9247
  /**
9244
9248
  * Rules. Accepts either a typed array (direct consumers) or the runtime
@@ -9270,7 +9274,7 @@ type CommitKind = 'user' | 'agent' | 'restore' | 'undo' | 'redo' | 'snapshot' |
9270
9274
  *
9271
9275
  * @capabilities version history row, commit entry, revision list item, change log entry, restore point, undo history item
9272
9276
  */
9273
- interface CommitRowProps {
9277
+ interface CommitRowProps extends A11yProps {
9274
9278
  /** Commit id; the first 7 characters are shown, the whole id on hover. */
9275
9279
  sha: string;
9276
9280
  /** Commit message. */
@@ -9318,7 +9322,7 @@ interface ChangeListItem {
9318
9322
  *
9319
9323
  * @capabilities change summary, what changed, version changes, diff summary, release notes list, modification list
9320
9324
  */
9321
- interface ChangeListProps {
9325
+ interface ChangeListProps extends A11yProps {
9322
9326
  /** The changes. Accepts a typed list or a render-ui payload binding. */
9323
9327
  changes: readonly ChangeListItem[] | EventPayloadValue;
9324
9328
  /** Emitted by a change's Inspect button. Payload: { title, type }. */
@@ -9363,7 +9367,7 @@ interface DiffHunk {
9363
9367
  *
9364
9368
  * @capabilities version diff, compare revisions, what changed, before and after, code diff, commit diff, revision comparison
9365
9369
  */
9366
- interface VersionDiffProps {
9370
+ interface VersionDiffProps extends A11yProps {
9367
9371
  /**
9368
9372
  * All available revisions (at least 2). Accepts either a typed array (direct
9369
9373
  * consumers) or the runtime payload shape from a render-ui binding
@@ -9417,7 +9421,7 @@ interface DocBreadcrumbItem {
9417
9421
  /** Navigation href (omit for the current/last item) */
9418
9422
  href?: string;
9419
9423
  }
9420
- interface DocBreadcrumbProps {
9424
+ interface DocBreadcrumbProps extends A11yProps {
9421
9425
  /** Breadcrumb path items, last item is treated as current page */
9422
9426
  items: DocBreadcrumbItem[];
9423
9427
  /** Additional CSS classes */
@@ -9437,7 +9441,7 @@ interface DocPaginationLink {
9437
9441
  href: string;
9438
9442
  category?: string;
9439
9443
  }
9440
- interface DocPaginationProps {
9444
+ interface DocPaginationProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
9441
9445
  /** Previous page link */
9442
9446
  prev?: DocPaginationLink;
9443
9447
  /** Next page link */
@@ -9445,7 +9449,7 @@ interface DocPaginationProps {
9445
9449
  /** Additional class names */
9446
9450
  className?: string;
9447
9451
  }
9448
- declare function DocPagination({ prev, next, className }: DocPaginationProps): React__default.JSX.Element | null;
9452
+ declare function DocPagination({ prev, next, className, ...rest }: DocPaginationProps): React__default.JSX.Element | null;
9449
9453
 
9450
9454
  /**
9451
9455
  * DocSearch — documentation search input with inline results dropdown (distinct from SearchInput).
@@ -9460,7 +9464,7 @@ interface DocSearchResult {
9460
9464
  excerpt?: string;
9461
9465
  category?: string;
9462
9466
  }
9463
- interface DocSearchProps {
9467
+ interface DocSearchProps extends A11yProps {
9464
9468
  /** Placeholder text for the input */
9465
9469
  placeholder?: string;
9466
9470
  /** Callback invoked with the search query, returns results */
@@ -9468,7 +9472,7 @@ interface DocSearchProps {
9468
9472
  /** Additional class names */
9469
9473
  className?: string;
9470
9474
  }
9471
- declare function DocSearch({ placeholder, onSearch, className, }: DocSearchProps): React__default.JSX.Element;
9475
+ declare function DocSearch({ placeholder, onSearch, className, ...rest }: DocSearchProps): React__default.JSX.Element;
9472
9476
 
9473
9477
  /**
9474
9478
  * DocSidebar — collapsible documentation navigation sidebar.
@@ -9487,7 +9491,7 @@ interface DocSidebarItem {
9487
9491
  /** Whether this item is currently active */
9488
9492
  active?: boolean;
9489
9493
  }
9490
- interface DocSidebarProps {
9494
+ interface DocSidebarProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
9491
9495
  /** Sidebar navigation items */
9492
9496
  items: DocSidebarItem[];
9493
9497
  /** Additional CSS classes */
@@ -9510,7 +9514,7 @@ interface DocTOCItem {
9510
9514
  /** Heading level: 2 for h2, 3 for h3, etc. */
9511
9515
  level: number;
9512
9516
  }
9513
- interface DocTOCProps {
9517
+ interface DocTOCProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
9514
9518
  /** Table of contents items */
9515
9519
  items: DocTOCItem[];
9516
9520
  /** Currently active section id */
@@ -9527,7 +9531,7 @@ declare const DocTOC: React__default.FC<DocTOCProps>;
9527
9531
  * Used between major sections for visual separation without hard background-color breaks.
9528
9532
  */
9529
9533
 
9530
- interface GradientDividerProps {
9534
+ interface GradientDividerProps extends A11yProps {
9531
9535
  /** Semantic palette token or a raw CSS color value. Defaults to 'primary'. */
9532
9536
  color?: ColorToken | string;
9533
9537
  /** Additional class names */
@@ -9559,7 +9563,7 @@ interface PageHeaderStatus {
9559
9563
  label: string;
9560
9564
  variant?: "default" | "success" | "warning" | "danger" | "info";
9561
9565
  }
9562
- interface PageHeaderProps {
9566
+ interface PageHeaderProps extends A11yProps {
9563
9567
  /** Page title - accepts string or number from generated code accessing dynamic entity data */
9564
9568
  title?: string | number;
9565
9569
  /** Icon shown before the title. */
@@ -9595,7 +9599,7 @@ interface PageHeaderProps {
9595
9599
  }
9596
9600
  declare const PageHeader: React__default.FC<PageHeaderProps>;
9597
9601
 
9598
- interface FormSectionProps extends DisplayStateProps {
9602
+ interface FormSectionProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
9599
9603
  /** Section title */
9600
9604
  title?: string;
9601
9605
  /** Section description */
@@ -9615,7 +9619,7 @@ declare const FormSection$1: React__default.FC<FormSectionProps>;
9615
9619
  /**
9616
9620
  * Form layout with multiple sections
9617
9621
  */
9618
- interface FormLayoutProps extends DisplayStateProps {
9622
+ interface FormLayoutProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
9619
9623
  children: React__default.ReactNode;
9620
9624
  /** Show section dividers */
9621
9625
  dividers?: boolean;
@@ -9624,7 +9628,7 @@ declare const FormLayout: React__default.FC<FormLayoutProps>;
9624
9628
  /**
9625
9629
  * Form actions bar (submit/cancel buttons)
9626
9630
  */
9627
- interface FormActionsProps extends DisplayStateProps {
9631
+ interface FormActionsProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
9628
9632
  children: React__default.ReactNode;
9629
9633
  /** Sticky at bottom */
9630
9634
  sticky?: boolean;
@@ -9685,7 +9689,7 @@ interface HeaderUserAvatar {
9685
9689
  alt?: string;
9686
9690
  initials?: string;
9687
9691
  }
9688
- interface HeaderProps {
9692
+ interface HeaderProps extends A11yProps {
9689
9693
  /**
9690
9694
  * Logo/Brand content
9691
9695
  */
@@ -9820,7 +9824,7 @@ interface NavigationItem {
9820
9824
  */
9821
9825
  subMenu?: NavigationItem[];
9822
9826
  }
9823
- interface NavigationProps {
9827
+ interface NavigationProps extends A11yProps {
9824
9828
  /**
9825
9829
  * Navigation items
9826
9830
  */
@@ -9850,7 +9854,7 @@ declare const Navigation: React__default.FC<NavigationProps>;
9850
9854
 
9851
9855
  type SectionPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
9852
9856
  type SectionVariant = 'default' | 'card' | 'bordered' | 'filled';
9853
- interface SectionProps {
9857
+ interface SectionProps extends A11yProps {
9854
9858
  /** Section title */
9855
9859
  title?: string;
9856
9860
  /** Section subtitle/description */
@@ -9915,7 +9919,7 @@ interface SidebarItem {
9915
9919
  /** Sub-items (for nested navigation) */
9916
9920
  subItems?: SidebarItem[];
9917
9921
  }
9918
- interface SidebarProps {
9922
+ interface SidebarProps extends A11yProps {
9919
9923
  /** Additional CSS classes */
9920
9924
  className?: string;
9921
9925
  /** Loading state indicator */
@@ -9962,7 +9966,7 @@ declare const Sidebar: React__default.FC<SidebarProps>;
9962
9966
 
9963
9967
  type SplitRatio = '1:1' | '1:2' | '2:1' | '1:3' | '3:1' | '1:4' | '4:1' | '2:3' | '3:2';
9964
9968
  type SplitGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
9965
- interface SplitProps {
9969
+ interface SplitProps extends A11yProps {
9966
9970
  /** Size ratio between left and right panels */
9967
9971
  ratio?: SplitRatio;
9968
9972
  /** Gap between panels */
@@ -10003,7 +10007,7 @@ declare const Split: React__default.FC<SplitProps>;
10003
10007
  */
10004
10008
 
10005
10009
  type ConfirmDialogVariant = "danger" | "warning" | "info" | "default";
10006
- interface ConfirmDialogProps {
10010
+ interface ConfirmDialogProps extends A11yProps {
10007
10011
  /** Whether the dialog is open (defaults to true when rendered by slot wrapper) */
10008
10012
  isOpen?: boolean;
10009
10013
  /** Callback when dialog is closed (injected by slot wrapper) */
@@ -10173,7 +10177,7 @@ interface WizardStep {
10173
10177
  /** Allow additional properties from schema */
10174
10178
  [key: string]: JsonValue | React__default.ReactNode | WizardSection[] | WizardEntityMapping | WizardValidationRule[] | WizardLawReference[] | (() => boolean) | undefined;
10175
10179
  }
10176
- interface WizardContainerProps {
10180
+ interface WizardContainerProps extends A11yProps {
10177
10181
  /** Wizard steps */
10178
10182
  steps: WizardStep[];
10179
10183
  /** Current step index (controlled) - accepts number or string for generated code compatibility */
@@ -10246,7 +10250,7 @@ interface OrbitalVisualizationSchemaSummary {
10246
10250
  /** Trait count. */
10247
10251
  traits?: number;
10248
10252
  }
10249
- interface OrbitalVisualizationProps {
10253
+ interface OrbitalVisualizationProps extends A11yProps {
10250
10254
  /** Complexity-scoring summary of a KFlow schema (counts only — see
10251
10255
  * {@link OrbitalVisualizationSchemaSummary}). */
10252
10256
  schema?: OrbitalVisualizationSchemaSummary;
@@ -10274,7 +10278,7 @@ declare const OrbitalVisualization: React__default.FC<OrbitalVisualizationProps>
10274
10278
  * machine drawn with gear-shaped states, from an orbital schema or one trait.
10275
10279
  */
10276
10280
 
10277
- interface JazariStateMachineProps {
10281
+ interface JazariStateMachineProps extends A11yProps {
10278
10282
  /** Additional CSS classes */
10279
10283
  className?: string;
10280
10284
  /** Loading state indicator */
@@ -10306,7 +10310,7 @@ declare const JazariStateMachine: React__default.FC<JazariStateMachineProps>;
10306
10310
  * - entityAware: false
10307
10311
  */
10308
10312
 
10309
- interface ContentRendererProps extends DisplayStateProps {
10313
+ interface ContentRendererProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
10310
10314
  /** Raw content string — auto-parsed into segments */
10311
10315
  content?: string;
10312
10316
  /** Pre-parsed segments (overrides content) */
@@ -10376,7 +10380,7 @@ interface ChartAction {
10376
10380
  navigatesTo?: string;
10377
10381
  variant?: "primary" | "secondary" | "ghost";
10378
10382
  }
10379
- interface ChartProps {
10383
+ interface ChartProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
10380
10384
  /** Chart title */
10381
10385
  title?: string;
10382
10386
  /** Chart subtitle / description */
@@ -10445,7 +10449,7 @@ declare const Chart: React__default.FC<ChartProps>;
10445
10449
  *
10446
10450
  * @capabilities e-signature capture, sign-here field, consent signature, initial-here field, wet-signature substitute
10447
10451
  */
10448
- interface SignaturePadProps {
10452
+ interface SignaturePadProps extends A11yProps {
10449
10453
  /** Label above the pad */
10450
10454
  label?: string;
10451
10455
  /** Helper text */
@@ -10503,7 +10507,7 @@ interface DocumentItem {
10503
10507
  content?: string;
10504
10508
  documentType?: DocumentType;
10505
10509
  }
10506
- interface DocumentViewerProps {
10510
+ interface DocumentViewerProps extends A11yProps {
10507
10511
  /** Document title */
10508
10512
  title?: string;
10509
10513
  /** Document URL (for PDF/external documents) */
@@ -10598,7 +10602,9 @@ interface GraphAction {
10598
10602
  navigatesTo?: string;
10599
10603
  variant?: "primary" | "secondary" | "ghost";
10600
10604
  }
10601
- interface GraphCanvasProps {
10605
+ interface GraphCanvasProps extends A11yProps {
10606
+ /** Text alternative for the graph, rendered as visually hidden text and linked by aria-describedby. */
10607
+ description?: string;
10602
10608
  /** Graph title */
10603
10609
  title?: string;
10604
10610
  /** Graph nodes */
@@ -10683,7 +10689,7 @@ interface ImportSourceOption {
10683
10689
  /** Disable the option */
10684
10690
  disabled?: boolean;
10685
10691
  }
10686
- interface ImportSourcePickerProps {
10692
+ interface ImportSourcePickerProps extends A11yProps {
10687
10693
  /** Source options to render */
10688
10694
  sources: ImportSourceOption[];
10689
10695
  /** Called with the source id when an 'action' option is picked */
@@ -10728,7 +10734,7 @@ interface ImportEntityDisplay {
10728
10734
  singular: string;
10729
10735
  plural: string;
10730
10736
  }
10731
- interface ImportPreviewTreeProps {
10737
+ interface ImportPreviewTreeProps extends A11yProps {
10732
10738
  /** Staged units to preview */
10733
10739
  units: ImportPreviewUnit[];
10734
10740
  /** Elements skipped during extraction, with reasons */
@@ -10765,7 +10771,7 @@ interface ImportProgressCounts {
10765
10771
  committed?: number;
10766
10772
  failed?: number;
10767
10773
  }
10768
- interface ImportProgressProps {
10774
+ interface ImportProgressProps extends A11yProps {
10769
10775
  /** Current lifecycle step */
10770
10776
  step: ImportProgressStep;
10771
10777
  /** Unit counts */
@@ -10788,7 +10794,7 @@ declare const ImportProgress: React__default.FC<ImportProgressProps>;
10788
10794
  * - entityAware: false
10789
10795
  */
10790
10796
 
10791
- interface ActivationBlockProps {
10797
+ interface ActivationBlockProps extends A11yProps {
10792
10798
  /** The prior-knowledge question */
10793
10799
  question: string;
10794
10800
  /** Pre-filled response from saved state */
@@ -10810,7 +10816,7 @@ declare const ActivationBlock: React__default.FC<ActivationBlockProps>;
10810
10816
  * - entityAware: false
10811
10817
  */
10812
10818
 
10813
- interface ReflectionBlockProps {
10819
+ interface ReflectionBlockProps extends A11yProps {
10814
10820
  /** The reflection prompt */
10815
10821
  prompt: string;
10816
10822
  /** Zero-based index of this block (used in the emitted event payload) */
@@ -10835,7 +10841,7 @@ declare const ReflectionBlock: React__default.FC<ReflectionBlockProps>;
10835
10841
  * - entityAware: false
10836
10842
  */
10837
10843
 
10838
- interface ConnectionBlockProps {
10844
+ interface ConnectionBlockProps extends A11yProps {
10839
10845
  /** Markdown content summarising what the learner already knows */
10840
10846
  content: string;
10841
10847
  /** Additional CSS classes */
@@ -10866,7 +10872,7 @@ interface CodeSimulationOutput {
10866
10872
  passed: boolean;
10867
10873
  }>;
10868
10874
  }
10869
- interface CodeRunnerPanelProps {
10875
+ interface CodeRunnerPanelProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
10870
10876
  /** Initial code content */
10871
10877
  code: string;
10872
10878
  /** Programming language for syntax highlighting */
@@ -10910,7 +10916,7 @@ interface LessonUserProgress {
10910
10916
  reflectionNotes?: string[];
10911
10917
  bloomAnswered?: Record<number, boolean>;
10912
10918
  }
10913
- interface SegmentRendererProps {
10919
+ interface SegmentRendererProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
10914
10920
  /** Parsed lesson segments (see `parseLessonSegments`) */
10915
10921
  segments: LessonSegment[];
10916
10922
  /** Additional CSS classes for the root container */
@@ -10976,7 +10982,7 @@ interface FloatingToolbarItem {
10976
10982
  testId?: string;
10977
10983
  }
10978
10984
  type FloatingToolbarPosition = "bottom-center" | "bottom-left" | "bottom-right" | "top-center" | "top-left" | "top-right";
10979
- interface FloatingToolbarProps {
10985
+ interface FloatingToolbarProps extends A11yProps {
10980
10986
  /** Tool items rendered as icon buttons */
10981
10987
  items: FloatingToolbarItem[];
10982
10988
  /**
@@ -11021,6 +11027,8 @@ interface RowAction<T> {
11021
11027
  event?: EventKey;
11022
11028
  /** Per-row condition, authored as `(fn row <bool>)`; composes with `show`. Omit = always shown. */
11023
11029
  when?: RowActionCondition;
11030
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
11031
+ payload?: RowActionPayload;
11024
11032
  }
11025
11033
  type DataTableEmptyAction = EmptyStateAction;
11026
11034
  /**
@@ -11028,7 +11036,7 @@ type DataTableEmptyAction = EmptyStateAction;
11028
11036
  */
11029
11037
  interface DataTableProps<T extends EntityRow & {
11030
11038
  id: string | number;
11031
- }> extends DisplayStateProps {
11039
+ }> extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11032
11040
  /** Entity rows to display (collection cardinality). */
11033
11041
  entity?: readonly EntityRow[];
11034
11042
  /** Fields to display - accepts string[] or Column[] for unified interface. Alias for columns */
@@ -11049,6 +11057,8 @@ interface DataTableProps<T extends EntityRow & {
11049
11057
  onClick?: (row: T) => void;
11050
11058
  /** Per-row condition, authored as `(fn row <bool>)`: the row's action is drawn only when it returns true. Omit = always shown. */
11051
11059
  when?: RowActionCondition;
11060
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
11061
+ payload?: RowActionPayload;
11052
11062
  }[];
11053
11063
  emptyIcon?: IconInput;
11054
11064
  emptyTitle?: string;
@@ -11079,7 +11089,7 @@ interface DataTableProps<T extends EntityRow & {
11079
11089
  }
11080
11090
  declare function DataTable<T extends EntityRow & {
11081
11091
  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;
11092
+ }>({ 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, ...rest }: DataTableProps<T>): React__default.JSX.Element;
11083
11093
  declare namespace DataTable {
11084
11094
  var displayName: string;
11085
11095
  }
@@ -11107,7 +11117,7 @@ interface MetricDefinition {
11107
11117
  equals: string | number | boolean;
11108
11118
  };
11109
11119
  }
11110
- interface StatCardProps extends DisplayStateProps {
11120
+ interface StatCardProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11111
11121
  /** Entity data (single record or collection) used to compute metrics. */
11112
11122
  entity?: EntityRow | readonly EntityRow[];
11113
11123
  /** Main label */
@@ -11153,6 +11163,110 @@ interface StatCardProps extends DisplayStateProps {
11153
11163
  }
11154
11164
  declare const StatCard: React__default.FC<StatCardProps>;
11155
11165
 
11166
+ /**
11167
+ * Timeline Organism Component
11168
+ *
11169
+ * A vertical timeline component for displaying chronological events.
11170
+ * Composes atoms and molecules for layout, uses CSS variables for theming.
11171
+ *
11172
+ * Orbital Component Interface Compliance:
11173
+ * - Entity binding with auto-fetch when entity is a string
11174
+ * - Event emission via useEventBus (UI:* events)
11175
+ * - isLoading and error state props
11176
+ * - className for external styling
11177
+ */
11178
+
11179
+ type TimelineItemStatus = "complete" | "active" | "pending" | "error";
11180
+ /**
11181
+ * Layer 2 visual treatment for the timeline pattern — orthogonal to the
11182
+ * semantic status conveyed by per-item style.
11183
+ */
11184
+ type TimelineLook = "vertical-compact" | "vertical-spacious" | "horizontal" | "swimlane";
11185
+ interface TimelineItem {
11186
+ /** Unique identifier */
11187
+ id: string;
11188
+ /** Item title */
11189
+ title: string;
11190
+ /** Item description */
11191
+ description?: string;
11192
+ /** Timestamp string */
11193
+ date?: string;
11194
+ /** Status indicator */
11195
+ status?: TimelineItemStatus;
11196
+ /** Icon override */
11197
+ icon?: IconInput;
11198
+ /** Additional metadata tags */
11199
+ tags?: readonly string[];
11200
+ }
11201
+ interface TimelineAction {
11202
+ label: string;
11203
+ event?: EventKey;
11204
+ navigatesTo?: string;
11205
+ variant?: "primary" | "secondary" | "ghost";
11206
+ }
11207
+ interface TimelineProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11208
+ /** Additional CSS classes */
11209
+ className?: string;
11210
+ /** Loading state indicator */
11211
+ isLoading?: boolean;
11212
+ /** Error state */
11213
+ error?: UiError | null;
11214
+ /**
11215
+ * Schema entity data typed against @almadar/core's EntityRow. Items from
11216
+ * `entity` are normalised into `items` when `items` is omitted. UI-specific
11217
+ * TimelineItem fields (`icon`, callbacks) cannot round-trip through the
11218
+ * event bus, so decorative stories that need them pass `items` directly.
11219
+ */
11220
+ entity?: readonly EntityRow[];
11221
+ /** Timeline title */
11222
+ title?: string;
11223
+ /** Timeline items */
11224
+ items?: readonly TimelineItem[];
11225
+ /** Entity fields the timeline draws; each slot is named by its own `*Field` prop. */
11226
+ fields?: readonly string[];
11227
+ /** Entity field holding each item's title. */
11228
+ titleField?: string;
11229
+ /** Entity field holding each item's description. */
11230
+ descriptionField?: string;
11231
+ /** Entity field holding each item's date. */
11232
+ dateField?: string;
11233
+ /** Entity field holding each item's status (complete | active | pending | error). */
11234
+ statusField?: string;
11235
+ /** Actions per item */
11236
+ itemActions?: readonly TimelineAction[];
11237
+ /** Layer 2 visual treatment. */
11238
+ look?: TimelineLook;
11239
+ }
11240
+ declare const Timeline: React__default.FC<TimelineProps>;
11241
+
11242
+ /**
11243
+ * Page variants of a record detail. DetailPanel computes the pieces of a
11244
+ * record page (header, key figures, field sections, prose, footer) and the
11245
+ * declared region data; a look only ARRANGES them, composing the existing
11246
+ * core components — it never fetches and never infers a region from data.
11247
+ */
11248
+
11249
+ /**
11250
+ * panel = labelled-field record (default) · profile = person/member hero ·
11251
+ * showcase = image-first product/listing · workflow = lifecycle stepper +
11252
+ * activity (+ declared line items) · map = location hero · ledger = document with line items and
11253
+ * totals · conversation = thread beside the record facts · workspace = tabbed
11254
+ * record.
11255
+ */
11256
+ type DetailLook = 'panel' | 'profile' | 'showcase' | 'workflow' | 'map' | 'ledger' | 'conversation' | 'workspace';
11257
+ /** One stage of a declared lifecycle, in order. */
11258
+ interface DetailStage {
11259
+ value: string;
11260
+ label: string;
11261
+ }
11262
+ /** One workspace tab: the declared fields it shows, or content composed in (e.g. a related list's trait). */
11263
+ interface DetailTab {
11264
+ id: string;
11265
+ label: string;
11266
+ fields?: readonly string[];
11267
+ content?: React__default.ReactNode;
11268
+ }
11269
+
11156
11270
  /**
11157
11271
  * DetailPanel Organism Component
11158
11272
  *
@@ -11197,6 +11311,8 @@ interface DetailPanelAction {
11197
11311
  variant?: "primary" | "secondary" | "ghost" | "danger";
11198
11312
  /** Condition over the panel's record, authored as `(fn row <bool>)`: the button is drawn only when it returns true. Omit = always shown. */
11199
11313
  when?: RowActionCondition;
11314
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. Omit = `{ id, row }`. */
11315
+ payload?: RowActionPayload;
11200
11316
  }
11201
11317
  /** Schema metadata the runtime's detail enrichment (UISlotRenderer) or the
11202
11318
  * compiled path's codegen injects onto a field. */
@@ -11224,7 +11340,7 @@ interface DetailPanelStatus {
11224
11340
  *
11225
11341
  * @fieldsContract display
11226
11342
  */
11227
- interface DetailPanelProps extends DisplayStateProps {
11343
+ interface DetailPanelProps extends DisplayStateProps, A11yProps {
11228
11344
  /** RECORD-cardinality: renders ONE record (see body collapse below). */
11229
11345
  entity?: EntityRow;
11230
11346
  title?: string;
@@ -11281,6 +11397,39 @@ interface DetailPanelProps extends DisplayStateProps {
11281
11397
  * server-side by the runtime (relation-option injection) or bound by
11282
11398
  * compiled codegen; resolves stored foreign ids to display names. */
11283
11399
  relationsData?: Record<string, readonly RelationOption[]>;
11400
+ /** 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). */
11401
+ look?: DetailLook;
11402
+ /** Record field holding the avatar image. The profile look always shows an avatar, with the title's initials when this is unset or empty. */
11403
+ avatarField?: string;
11404
+ /** Record field holding the cover image (profile). */
11405
+ coverField?: string;
11406
+ /** Record field holding the image, or list of images, the showcase look leads with. */
11407
+ mediaField?: string;
11408
+ /** Record field holding the current lifecycle stage (workflow). */
11409
+ stageField?: string;
11410
+ /** The lifecycle in order, `{ value, label }` per stage (workflow). */
11411
+ stages?: readonly DetailStage[];
11412
+ /** Activity entries shown under the record (workflow). */
11413
+ activity?: readonly TimelineItem[];
11414
+ /** Activity composed in instead of `activity` — e.g. the record's own history trait (workflow). */
11415
+ activityContent?: React__default.ReactNode;
11416
+ /** Record fields holding the location (map). */
11417
+ latitudeField?: string;
11418
+ longitudeField?: string;
11419
+ /** Child rows shown as the document's line items (ledger). */
11420
+ lineItems?: readonly EntityRow[];
11421
+ /** Columns of the line-items table (ledger). */
11422
+ lineItemColumns?: readonly TableViewColumn[];
11423
+ /** Line items composed in instead of `lineItems` — e.g. the child rows' own trait (ledger). */
11424
+ lineItemsContent?: React__default.ReactNode;
11425
+ /** Record fields shown as the document's totals, in order (ledger). */
11426
+ totals?: readonly DisplayField[];
11427
+ /** The thread shown as the main surface (conversation). */
11428
+ thread?: readonly EntityWith<ReplyNodeRow>[];
11429
+ /** The thread composed in instead of `thread` — e.g. the replies' own trait with its composer (conversation). */
11430
+ threadContent?: React__default.ReactNode;
11431
+ /** Tabs after the overview tab, each listing declared field names (workspace). */
11432
+ tabs?: readonly DetailTab[];
11284
11433
  }
11285
11434
  declare const DetailPanel: React__default.FC<DetailPanelProps>;
11286
11435
 
@@ -11432,7 +11581,7 @@ interface SchemaFieldOverride {
11432
11581
  *
11433
11582
  * @fieldsContract form
11434
11583
  */
11435
- interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
11584
+ interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormElement>, "onSubmit" | keyof A11yProps>, A11yProps {
11436
11585
  /** Form fields (traditional React children) */
11437
11586
  children?: React__default.ReactNode;
11438
11587
  /** Submit event name for trait dispatch (emitted via eventBus as UI:{onSubmit}) */
@@ -11560,10 +11709,12 @@ interface SchemaItemAction {
11560
11709
  onClick?: (row: EntityRow) => void;
11561
11710
  /** Per-row condition, authored as `(fn row <bool>)`: the row's action is drawn only when it returns true. Omit = always shown. */
11562
11711
  when?: RowActionCondition;
11712
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
11713
+ payload?: RowActionPayload;
11563
11714
  }
11564
11715
  /** A field is a plain name or a declared {@link DisplayField}. */
11565
11716
  type FieldDef$1 = string | DisplayField;
11566
- interface ListProps extends DisplayStateProps {
11717
+ interface ListProps extends DisplayStateProps, A11yProps {
11567
11718
  /** Entity data (single record or collection). */
11568
11719
  entity?: EntityRow | readonly EntityRow[];
11569
11720
  /** Entity type name for display */
@@ -11621,10 +11772,12 @@ interface CardItemAction {
11621
11772
  variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | string;
11622
11773
  /** Per-row condition, authored as `(fn row <bool>)`: the card's button is drawn only when it returns true. Omit = always shown. */
11623
11774
  when?: RowActionCondition;
11775
+ /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
11776
+ payload?: RowActionPayload;
11624
11777
  }
11625
11778
  /** A field is a plain name or a declared {@link DisplayField}. */
11626
11779
  type FieldDef = string | DisplayField;
11627
- interface CardGridProps extends DisplayStateProps {
11780
+ interface CardGridProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11628
11781
  /** Entity data (single record or collection). */
11629
11782
  entity?: EntityRow | readonly EntityRow[];
11630
11783
  /** Minimum width of each card (default: 280px) */
@@ -11684,7 +11837,7 @@ interface MasterDetailProps<T extends EntityRow & {
11684
11837
  id: string | number;
11685
11838
  } = EntityRow & {
11686
11839
  id: string | number;
11687
- }> extends DisplayStateProps {
11840
+ }> extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11688
11841
  /** Entity rows to display in the master list (collection cardinality). */
11689
11842
  entity?: readonly EntityRow[];
11690
11843
  /** Fields to show in the master list (maps to DataTable columns) */
@@ -11725,7 +11878,7 @@ declare const StateMachineView: React__default.FC<StateMachineViewProps>;
11725
11878
  * Uses wireframe theme styling (high contrast, sharp edges).
11726
11879
  */
11727
11880
 
11728
- interface SplitPaneProps {
11881
+ interface SplitPaneProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11729
11882
  /** Direction of the split */
11730
11883
  direction?: "horizontal" | "vertical";
11731
11884
  /** Initial ratio (0-100, percentage of first pane) */
@@ -11764,7 +11917,7 @@ declare const SplitPane: React__default.FC<SplitPaneProps>;
11764
11917
  * Uses wireframe theme styling (high contrast, sharp edges).
11765
11918
  */
11766
11919
 
11767
- interface MasterDetailLayoutProps {
11920
+ interface MasterDetailLayoutProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11768
11921
  /** Master panel content (usually a list) */
11769
11922
  master: React__default.ReactNode;
11770
11923
  /** Detail panel content */
@@ -11806,7 +11959,7 @@ interface DashboardGridCell {
11806
11959
  /** Number of rows this cell spans (1-2) */
11807
11960
  rowSpan?: 1 | 2;
11808
11961
  }
11809
- interface DashboardGridProps extends DisplayStateProps {
11962
+ interface DashboardGridProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11810
11963
  /** Number of columns */
11811
11964
  columns?: 2 | 3 | 4;
11812
11965
  /** Gap between cells */
@@ -11842,7 +11995,7 @@ interface TabDefinition {
11842
11995
  /** Disable this tab */
11843
11996
  disabled?: boolean;
11844
11997
  }
11845
- interface TabbedContainerProps {
11998
+ interface TabbedContainerProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11846
11999
  /** Tab definitions */
11847
12000
  tabs: TabDefinition[];
11848
12001
  /** Default active tab ID */
@@ -11901,7 +12054,7 @@ declare function useDockLayout(): DockLayoutContextValue;
11901
12054
  declare const COMPACT_MEDIA_QUERY = "(max-width: 1023.98px)";
11902
12055
  /** Whether the viewport is in the compact (mobile) range — the one threshold every compact decision uses. */
11903
12056
  declare function useCompactLayout(): boolean;
11904
- interface DockLayoutProps {
12057
+ interface DockLayoutProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
11905
12058
  /** Fixed-width far-left vertical strip (e.g. an icon nav rail). */
11906
12059
  rail?: React__default.ReactNode;
11907
12060
  /** Collapsible, resizable left sidebar. */
@@ -12007,6 +12160,12 @@ interface UISlotComponentProps {
12007
12160
  pattern?: string;
12008
12161
  /** Source trait name for data-source-trait attribute (compiled mode) */
12009
12162
  sourceTrait?: string;
12163
+ /**
12164
+ * Compiled mode: the root node's declared `enter`. When set, the slot plays
12165
+ * no theme-default entry (the root element animates itself, or opts out
12166
+ * with `none`). Runtime mode reads it off the slot content.
12167
+ */
12168
+ enter?: EnterAnimation;
12010
12169
  /**
12011
12170
  * Host-supplied stock content for a slot-host region (Studio V4 §14 Part
12012
12171
  * I2). Ignored whenever `children` is passed — `children` (compiled mode)
@@ -12209,7 +12368,7 @@ declare const DrawerSlot: React__default.FC<DrawerSlotProps>;
12209
12368
  * - Fixed positioning in corner of screen
12210
12369
  */
12211
12370
 
12212
- interface ToastSlotProps {
12371
+ interface ToastSlotProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12213
12372
  /** Content to display in the toast (message or ReactNode) */
12214
12373
  children?: React__default.ReactNode;
12215
12374
  /** Toast variant */
@@ -12237,82 +12396,6 @@ interface ToastSlotProps {
12237
12396
  */
12238
12397
  declare const ToastSlot: React__default.FC<ToastSlotProps>;
12239
12398
 
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
12399
  /**
12317
12400
  * MediaGallery Organism Component
12318
12401
  *
@@ -12348,7 +12431,7 @@ interface MediaGalleryAction {
12348
12431
  navigatesTo?: string;
12349
12432
  variant?: "primary" | "secondary" | "ghost";
12350
12433
  }
12351
- interface MediaGalleryProps extends DisplayStateProps {
12434
+ interface MediaGalleryProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12352
12435
  /** Entity rows to display (collection cardinality). */
12353
12436
  entity?: readonly EntityRow[];
12354
12437
  /** Gallery title */
@@ -12387,7 +12470,7 @@ declare const MediaGallery: React__default.FC<MediaGalleryProps>;
12387
12470
  * @packageDocumentation
12388
12471
  */
12389
12472
 
12390
- interface RuntimeDebuggerProps {
12473
+ interface RuntimeDebuggerProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
12391
12474
  /** Initial position */
12392
12475
  position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
12393
12476
  /** Initial collapsed state */
@@ -12401,7 +12484,7 @@ interface RuntimeDebuggerProps {
12401
12484
  /** Raw schema for EventDispatcherTab payload extraction */
12402
12485
  schema?: OrbitalSchema;
12403
12486
  }
12404
- declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): React$1.JSX.Element | null;
12487
+ declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, ...rest }: RuntimeDebuggerProps): React$1.JSX.Element | null;
12405
12488
  declare namespace RuntimeDebugger {
12406
12489
  var displayName: string;
12407
12490
  }
@@ -12420,7 +12503,7 @@ declare namespace RuntimeDebugger {
12420
12503
  */
12421
12504
 
12422
12505
  type ChatBarStatus = 'idle' | 'running' | 'paused' | 'complete' | 'error';
12423
- interface ChatBarProps extends DisplayStateProps {
12506
+ interface ChatBarProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12424
12507
  /** Pipeline status */
12425
12508
  status?: ChatBarStatus;
12426
12509
  /** Currently active gate label, e.g. "Gate 2: State machines" */
@@ -12434,7 +12517,7 @@ interface ChatBarProps extends DisplayStateProps {
12434
12517
  /** Agent context description */
12435
12518
  context?: string;
12436
12519
  }
12437
- declare function ChatBar({ status, activeGate, jepaValidity, runningIndicator, placeholder, context, className, }: ChatBarProps): React__default.ReactElement;
12520
+ declare function ChatBar({ status, activeGate, jepaValidity, runningIndicator, placeholder, context, className, ...rest }: ChatBarProps): React__default.ReactElement;
12438
12521
  declare namespace ChatBar {
12439
12522
  var displayName: string;
12440
12523
  }
@@ -12469,7 +12552,7 @@ declare function parseEditFocus(value: EventPayloadValue | undefined): EditFocus
12469
12552
 
12470
12553
  /** Disclosure level driving panel density (builder=1 … architect=4). */
12471
12554
  type TraceDisclosureLevel = 1 | 2 | 3 | 4;
12472
- interface SubagentTracePanelProps extends DisplayStateProps {
12555
+ interface SubagentTracePanelProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12473
12556
  /** All known subagents from the runner. */
12474
12557
  subagents: TraceSubagent[];
12475
12558
  /** Current canvas focus orbital — only used by overlay mode. Tab mode ignores this. */
@@ -12665,7 +12748,7 @@ interface DashboardLayoutProps {
12665
12748
  }
12666
12749
  declare const DashboardLayout: React__default.FC<DashboardLayoutProps>;
12667
12750
 
12668
- interface AuthLayoutProps {
12751
+ interface AuthLayoutProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12669
12752
  /** App name */
12670
12753
  appName?: string;
12671
12754
  /** Logo component or URL */
@@ -12704,7 +12787,7 @@ interface CounterEntity {
12704
12787
  /** Formatted range text (e.g. "Range: 0 to 100") */
12705
12788
  rangeText?: string;
12706
12789
  }
12707
- interface CounterTemplateProps extends TemplateProps<CounterEntity> {
12790
+ interface CounterTemplateProps extends TemplateProps<CounterEntity>, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12708
12791
  /** Called when increment is clicked */
12709
12792
  onIncrement?: () => void;
12710
12793
  /** Called when decrement is clicked */
@@ -12736,7 +12819,7 @@ declare const CounterTemplate: React__default.FC<CounterTemplateProps>;
12736
12819
  * **Atomic Design**: Composed using Box, Typography, and Button atoms.
12737
12820
  */
12738
12821
 
12739
- interface GenericAppTemplateProps extends TemplateProps {
12822
+ interface GenericAppTemplateProps extends TemplateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
12740
12823
  /** Page title */
12741
12824
  title: string;
12742
12825
  /** Subtitle or description */