@almadar/ui 2.13.3 → 2.15.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 (420) hide show
  1. package/dist/{chunk-UNDQO6DL.js → chunk-4KP6IZEQ.js} +3 -3
  2. package/dist/chunk-4N3BAPDB.js +1667 -0
  3. package/dist/{chunk-PERGHHON.js → chunk-IRIGCHP4.js} +2 -12
  4. package/dist/{chunk-Y7IHEYYE.js → chunk-QU2X55WH.js} +11 -1
  5. package/dist/{chunk-4ZBSL37D.js → chunk-XL7WB2O5.js} +415 -58
  6. package/dist/{chunk-MSLMORZK.js → chunk-YPY74G7F.js} +13434 -2264
  7. package/dist/components/atoms/AnimatedCounter.d.ts +20 -0
  8. package/dist/components/atoms/Avatar.d.ts +58 -0
  9. package/dist/components/atoms/Badge.d.ts +14 -0
  10. package/dist/components/atoms/Box.d.ts +57 -0
  11. package/dist/components/atoms/Button.d.ts +24 -0
  12. package/dist/components/atoms/Card.d.ts +18 -0
  13. package/dist/components/atoms/Center.d.ts +33 -0
  14. package/dist/components/atoms/Checkbox.d.ts +9 -0
  15. package/dist/components/atoms/ConditionalWrapper.d.ts +68 -0
  16. package/dist/components/atoms/ConfettiEffect.d.ts +19 -0
  17. package/dist/components/atoms/DayCell.d.ts +21 -0
  18. package/dist/components/atoms/Divider.d.ts +29 -0
  19. package/dist/components/atoms/FlipContainer.d.ts +21 -0
  20. package/dist/components/atoms/Icon.d.ts +39 -0
  21. package/dist/components/atoms/InfiniteScrollSentinel.d.ts +23 -0
  22. package/dist/components/atoms/Input.d.ts +26 -0
  23. package/dist/components/atoms/Label.d.ts +5 -0
  24. package/dist/components/atoms/LawReferenceTooltip.d.ts +48 -0
  25. package/dist/components/atoms/Overlay.d.ts +16 -0
  26. package/dist/components/atoms/ProgressBar.d.ts +63 -0
  27. package/dist/components/atoms/Radio.d.ts +26 -0
  28. package/dist/components/atoms/RangeSlider.d.ts +31 -0
  29. package/dist/components/atoms/Select.d.ts +12 -0
  30. package/dist/components/atoms/Spacer.d.ts +25 -0
  31. package/dist/components/atoms/Spinner.d.ts +6 -0
  32. package/dist/components/atoms/Stack.d.ts +66 -0
  33. package/dist/components/atoms/StatusDot.d.ts +14 -0
  34. package/dist/components/atoms/Switch.d.ts +12 -0
  35. package/dist/components/atoms/TextHighlight.d.ts +53 -0
  36. package/dist/components/atoms/Textarea.d.ts +5 -0
  37. package/dist/components/atoms/ThemeSelector.d.ts +21 -0
  38. package/dist/components/atoms/ThemeToggle.d.ts +33 -0
  39. package/dist/components/atoms/TimeSlotCell.d.ts +23 -0
  40. package/dist/components/atoms/TrendIndicator.d.ts +18 -0
  41. package/dist/components/atoms/TypewriterText.d.ts +20 -0
  42. package/dist/components/atoms/Typography.d.ts +57 -0
  43. package/dist/components/atoms/game/ActionButton.d.ts +25 -0
  44. package/dist/components/atoms/game/ChoiceButton.d.ts +18 -0
  45. package/dist/components/atoms/game/ComboCounter.d.ts +16 -0
  46. package/dist/components/atoms/game/ControlButton.d.ts +31 -0
  47. package/dist/components/atoms/game/DamageNumber.d.ts +14 -0
  48. package/dist/components/atoms/game/DialogueBubble.d.ts +16 -0
  49. package/dist/components/atoms/game/HealthBar.d.ts +18 -0
  50. package/dist/components/atoms/game/ItemSlot.d.ts +25 -0
  51. package/dist/components/atoms/game/MiniMap.d.ts +36 -0
  52. package/dist/components/atoms/game/ResourceCounter.d.ts +21 -0
  53. package/dist/components/atoms/game/ScoreDisplay.d.ts +21 -0
  54. package/dist/components/atoms/game/Sprite.d.ts +63 -0
  55. package/dist/components/atoms/game/StateIndicator.d.ts +31 -0
  56. package/dist/components/atoms/game/StatusEffect.d.ts +21 -0
  57. package/dist/components/atoms/game/TimerDisplay.d.ts +18 -0
  58. package/dist/components/atoms/game/TurnIndicator.d.ts +18 -0
  59. package/dist/components/atoms/game/WaypointMarker.d.ts +19 -0
  60. package/dist/components/atoms/game/XPBar.d.ts +20 -0
  61. package/dist/components/atoms/game/index.d.ts +25 -0
  62. package/dist/components/atoms/index.d.ts +37 -0
  63. package/dist/components/index.css +508 -0
  64. package/dist/components/index.d.ts +6 -9788
  65. package/dist/components/index.js +769 -11187
  66. package/dist/components/molecules/Accordion.d.ts +67 -0
  67. package/dist/components/molecules/Alert.d.ts +24 -0
  68. package/dist/components/molecules/Breadcrumb.d.ts +55 -0
  69. package/dist/components/molecules/ButtonGroup.d.ts +67 -0
  70. package/dist/components/molecules/CalendarGrid.d.ts +43 -0
  71. package/dist/components/molecules/Card.d.ts +56 -0
  72. package/dist/components/molecules/Carousel.d.ts +31 -0
  73. package/dist/components/molecules/ChartLegend.d.ts +20 -0
  74. package/dist/components/molecules/Container.d.ts +30 -0
  75. package/dist/components/molecules/DataGrid.d.ts +75 -0
  76. package/dist/components/molecules/DataList.d.ts +95 -0
  77. package/dist/components/molecules/DateRangeSelector.d.ts +22 -0
  78. package/dist/components/molecules/Drawer.d.ts +46 -0
  79. package/dist/components/molecules/EmptyState.d.ts +25 -0
  80. package/dist/components/molecules/ErrorBoundary.d.ts +55 -0
  81. package/dist/components/molecules/ErrorState.d.ts +13 -0
  82. package/dist/components/molecules/FilterGroup.d.ts +54 -0
  83. package/dist/components/molecules/Flex.d.ts +43 -0
  84. package/dist/components/molecules/FlipCard.d.ts +25 -0
  85. package/dist/components/molecules/FloatingActionButton.d.ts +69 -0
  86. package/dist/components/molecules/FormField.d.ts +16 -0
  87. package/dist/components/molecules/FormSectionHeader.d.ts +30 -0
  88. package/dist/components/molecules/GraphView.d.ts +45 -0
  89. package/dist/components/molecules/Grid.d.ts +54 -0
  90. package/dist/components/molecules/InputGroup.d.ts +24 -0
  91. package/dist/components/molecules/Lightbox.d.ts +25 -0
  92. package/dist/components/molecules/LineChart.d.ts +33 -0
  93. package/dist/components/molecules/LoadingState.d.ts +7 -0
  94. package/dist/components/molecules/MapView.d.ts +40 -0
  95. package/dist/components/molecules/Menu.d.ts +40 -0
  96. package/dist/components/molecules/Meter.d.ts +51 -0
  97. package/dist/components/molecules/Modal.d.ts +28 -0
  98. package/dist/components/molecules/NumberStepper.d.ts +27 -0
  99. package/dist/components/molecules/Pagination.d.ts +66 -0
  100. package/dist/components/molecules/Popover.d.ts +39 -0
  101. package/dist/components/molecules/ProgressDots.d.ts +24 -0
  102. package/dist/components/molecules/PullToRefresh.d.ts +21 -0
  103. package/dist/components/molecules/QuizBlock.d.ts +20 -0
  104. package/dist/components/molecules/RelationSelect.d.ts +48 -0
  105. package/dist/components/molecules/RepeatableFormSection.d.ts +58 -0
  106. package/dist/components/molecules/ScaledDiagram.d.ts +20 -0
  107. package/dist/components/molecules/SearchInput.d.ts +60 -0
  108. package/dist/components/molecules/SidePanel.d.ts +47 -0
  109. package/dist/components/molecules/SimpleGrid.d.ts +27 -0
  110. package/dist/components/molecules/Skeleton.d.ts +35 -0
  111. package/dist/components/molecules/SortableList.d.ts +17 -0
  112. package/dist/components/molecules/StarRating.d.ts +26 -0
  113. package/dist/components/molecules/StatDisplay.d.ts +37 -0
  114. package/dist/components/molecules/SwipeableRow.d.ts +24 -0
  115. package/dist/components/molecules/Tabs.d.ts +45 -0
  116. package/dist/components/molecules/Toast.d.ts +35 -0
  117. package/dist/components/molecules/Tooltip.d.ts +25 -0
  118. package/dist/components/molecules/UploadDropZone.d.ts +26 -0
  119. package/dist/components/molecules/ViolationAlert.d.ts +49 -0
  120. package/dist/components/molecules/WizardNavigation.d.ts +51 -0
  121. package/dist/components/molecules/WizardProgress.d.ts +42 -0
  122. package/dist/components/molecules/game/ActionButtons.d.ts +34 -0
  123. package/dist/components/molecules/game/CombatLog.d.ts +30 -0
  124. package/dist/components/molecules/game/CraftingRecipe.d.ts +33 -0
  125. package/dist/components/molecules/game/DPad.d.ts +22 -0
  126. package/dist/components/molecules/game/DialogueBox.d.ts +78 -0
  127. package/dist/components/molecules/game/EnemyPlate.d.ts +27 -0
  128. package/dist/components/molecules/game/GameCanvas2D.d.ts +18 -0
  129. package/dist/components/molecules/game/GameHud.d.ts +49 -0
  130. package/dist/components/molecules/game/GameMenu.d.ts +43 -0
  131. package/dist/components/molecules/game/GameOverScreen.d.ts +56 -0
  132. package/dist/components/molecules/game/HealthPanel.d.ts +27 -0
  133. package/dist/components/molecules/game/InventoryGrid.d.ts +30 -0
  134. package/dist/components/molecules/game/InventoryPanel.d.ts +67 -0
  135. package/dist/components/molecules/game/IsometricCanvas.d.ts +127 -0
  136. package/dist/components/molecules/game/PlatformerCanvas.d.ts +52 -0
  137. package/dist/components/molecules/game/PowerupSlots.d.ts +23 -0
  138. package/dist/components/molecules/game/QuestTracker.d.ts +20 -0
  139. package/dist/components/molecules/game/ResourceBar.d.ts +23 -0
  140. package/dist/components/molecules/game/ScoreBoard.d.ts +18 -0
  141. package/dist/components/molecules/game/StatBadge.d.ts +27 -0
  142. package/dist/components/molecules/game/TurnPanel.d.ts +29 -0
  143. package/dist/components/molecules/game/UnitCommandBar.d.ts +25 -0
  144. package/dist/components/molecules/game/index.d.ts +30 -0
  145. package/dist/components/molecules/index.d.ts +59 -0
  146. package/dist/components/molecules/markdown/CodeBlock.d.ts +25 -0
  147. package/dist/components/molecules/markdown/MarkdownContent.d.ts +26 -0
  148. package/dist/components/molecules/markdown/index.d.ts +2 -0
  149. package/dist/components/organisms/CardGrid.d.ts +80 -0
  150. package/dist/components/organisms/Chart.d.ts +59 -0
  151. package/dist/components/organisms/CodeViewer.d.ts +67 -0
  152. package/dist/components/organisms/ComponentPatterns.d.ts +453 -0
  153. package/dist/components/organisms/ConfirmDialog.d.ts +50 -0
  154. package/dist/components/organisms/ContentRenderer.d.ts +23 -0
  155. package/dist/components/organisms/CustomPattern.d.ts +104 -0
  156. package/dist/components/organisms/DataTable.d.ts +67 -0
  157. package/dist/components/organisms/DetailPanel.d.ts +78 -0
  158. package/dist/components/organisms/DocumentViewer.d.ts +60 -0
  159. package/dist/components/organisms/DrawerSlot.d.ts +39 -0
  160. package/dist/components/organisms/Form.d.ts +206 -0
  161. package/dist/components/organisms/FormSection.d.ts +41 -0
  162. package/dist/components/organisms/GraphCanvas.d.ts +69 -0
  163. package/dist/components/organisms/Header.d.ts +110 -0
  164. package/dist/components/organisms/JazariStateMachine.d.ts +60 -0
  165. package/dist/components/organisms/LayoutPatterns.d.ts +181 -0
  166. package/dist/components/organisms/List.d.ts +78 -0
  167. package/dist/components/organisms/MasterDetail.d.ts +32 -0
  168. package/dist/components/organisms/MediaGallery.d.ts +57 -0
  169. package/dist/components/organisms/Meter.d.ts +58 -0
  170. package/dist/components/organisms/ModalSlot.d.ts +35 -0
  171. package/dist/components/organisms/Navigation.d.ts +68 -0
  172. package/dist/components/organisms/NotifyListener.d.ts +15 -0
  173. package/dist/components/organisms/OrbitalVisualization.d.ts +48 -0
  174. package/dist/components/organisms/PageHeader.d.ts +59 -0
  175. package/dist/components/organisms/Section.d.ts +44 -0
  176. package/dist/components/organisms/Sidebar.d.ts +63 -0
  177. package/dist/components/organisms/SignaturePad.d.ts +44 -0
  178. package/dist/components/organisms/Split.d.ts +42 -0
  179. package/dist/components/organisms/StatCard.d.ts +62 -0
  180. package/dist/components/organisms/StateMachineView.d.ts +36 -0
  181. package/dist/components/organisms/Table.d.ts +99 -0
  182. package/dist/components/organisms/Timeline.d.ts +49 -0
  183. package/dist/components/organisms/ToastSlot.d.ts +38 -0
  184. package/dist/components/organisms/UISlotRenderer.d.ts +112 -0
  185. package/dist/components/organisms/WizardContainer.d.ts +160 -0
  186. package/dist/components/organisms/book/BookChapterView.d.ts +17 -0
  187. package/dist/components/organisms/book/BookCoverPage.d.ts +20 -0
  188. package/dist/components/organisms/book/BookNavBar.d.ts +19 -0
  189. package/dist/components/organisms/book/BookTableOfContents.d.ts +18 -0
  190. package/dist/components/organisms/book/BookViewer.d.ts +28 -0
  191. package/dist/components/organisms/book/index.d.ts +7 -0
  192. package/dist/components/organisms/book/types.d.ts +77 -0
  193. package/dist/components/organisms/component-registry.generated.d.ts +9 -0
  194. package/dist/components/organisms/debug/RuntimeDebugger.d.ts +19 -0
  195. package/dist/components/organisms/debug/hooks/useDebugData.d.ts +25 -0
  196. package/dist/components/organisms/debug/index.d.ts +13 -0
  197. package/dist/components/organisms/debug/tabs/EntitiesTab.d.ts +13 -0
  198. package/dist/components/organisms/debug/tabs/EventDispatcherTab.d.ts +16 -0
  199. package/dist/components/organisms/debug/tabs/EventFlowTab.d.ts +9 -0
  200. package/dist/components/organisms/debug/tabs/GuardsPanel.d.ts +9 -0
  201. package/dist/components/organisms/debug/tabs/ServerBridgeTab.d.ts +9 -0
  202. package/dist/components/organisms/debug/tabs/TicksTab.d.ts +13 -0
  203. package/dist/components/organisms/debug/tabs/TraitsTab.d.ts +13 -0
  204. package/dist/components/organisms/debug/tabs/TransitionTimeline.d.ts +9 -0
  205. package/dist/components/organisms/debug/tabs/VerificationTab.d.ts +10 -0
  206. package/dist/components/organisms/game/BattleBoard.d.ts +175 -0
  207. package/dist/components/organisms/game/CanvasEffect.d.ts +68 -0
  208. package/dist/components/organisms/game/CastleBoard.d.ts +85 -0
  209. package/dist/components/organisms/game/CombatLog.d.ts +2 -0
  210. package/dist/components/organisms/game/DialogueBox.d.ts +2 -0
  211. package/dist/components/organisms/game/GameAudioProvider.d.ts +47 -0
  212. package/dist/components/organisms/game/GameAudioToggle.d.ts +28 -0
  213. package/dist/components/organisms/game/GameCanvas3D.d.ts +181 -0
  214. package/dist/components/organisms/game/GameHud.d.ts +2 -0
  215. package/dist/components/organisms/game/GameMenu.d.ts +2 -0
  216. package/dist/components/organisms/game/GameOverScreen.d.ts +2 -0
  217. package/dist/components/organisms/game/InventoryPanel.d.ts +2 -0
  218. package/dist/components/organisms/game/IsometricCanvas.d.ts +3 -0
  219. package/dist/components/organisms/game/PlatformerCanvas.d.ts +2 -0
  220. package/dist/components/organisms/game/TraitSlot.d.ts +90 -0
  221. package/dist/components/organisms/game/TraitStateViewer.d.ts +53 -0
  222. package/dist/components/organisms/game/UncontrolledBattleBoard.d.ts +26 -0
  223. package/dist/components/organisms/game/WorldMapBoard.d.ts +156 -0
  224. package/dist/components/organisms/game/editor/editorUtils.d.ts +109 -0
  225. package/dist/components/organisms/game/editor/index.d.ts +9 -0
  226. package/dist/components/organisms/game/hooks/useBattleState.d.ts +35 -0
  227. package/dist/components/organisms/game/hooks/useCamera.d.ts +41 -0
  228. package/dist/components/organisms/game/hooks/useGameAudio.d.ts +47 -0
  229. package/dist/components/organisms/game/hooks/useImageCache.d.ts +16 -0
  230. package/dist/components/organisms/game/hooks/usePhysics2D.d.ts +45 -0
  231. package/dist/components/organisms/game/hooks/useSpriteAnimations.d.ts +43 -0
  232. package/dist/components/organisms/game/index.d.ts +52 -0
  233. package/dist/components/organisms/game/managers/PhysicsManager.d.ts +103 -0
  234. package/dist/components/organisms/game/physics-sim/SimulationCanvas.d.ts +20 -0
  235. package/dist/components/organisms/game/physics-sim/SimulationControls.d.ts +28 -0
  236. package/dist/components/organisms/game/physics-sim/SimulationGraph.d.ts +25 -0
  237. package/dist/components/organisms/game/physics-sim/index.d.ts +7 -0
  238. package/dist/components/organisms/game/physics-sim/presets/index.d.ts +4 -0
  239. package/dist/components/organisms/game/physics-sim/presets/mechanics.d.ts +4 -0
  240. package/dist/components/organisms/game/physics-sim/presets/types.d.ts +43 -0
  241. package/dist/components/organisms/game/puzzles/builder/BuilderBoard.d.ts +52 -0
  242. package/dist/components/organisms/game/puzzles/builder/index.d.ts +2 -0
  243. package/dist/components/organisms/game/puzzles/classifier/ClassifierBoard.d.ts +53 -0
  244. package/dist/components/organisms/game/puzzles/classifier/index.d.ts +2 -0
  245. package/dist/components/organisms/game/puzzles/debugger/DebuggerBoard.d.ts +45 -0
  246. package/dist/components/organisms/game/puzzles/debugger/index.d.ts +2 -0
  247. package/dist/components/organisms/game/puzzles/event-handler/EventHandlerBoard.d.ts +55 -0
  248. package/dist/components/organisms/game/puzzles/event-handler/EventLog.d.ts +31 -0
  249. package/dist/components/organisms/game/puzzles/event-handler/ObjectRulePanel.d.ts +45 -0
  250. package/dist/components/organisms/game/puzzles/event-handler/RuleEditor.d.ts +41 -0
  251. package/dist/components/organisms/game/puzzles/event-handler/index.d.ts +8 -0
  252. package/dist/components/organisms/game/puzzles/negotiator/NegotiatorBoard.d.ts +54 -0
  253. package/dist/components/organisms/game/puzzles/negotiator/index.d.ts +2 -0
  254. package/dist/components/organisms/game/puzzles/sequencer/ActionPalette.d.ts +34 -0
  255. package/dist/components/organisms/game/puzzles/sequencer/ActionTile.d.ts +30 -0
  256. package/dist/components/organisms/game/puzzles/sequencer/SequenceBar.d.ts +41 -0
  257. package/dist/components/organisms/game/puzzles/sequencer/SequencerBoard.d.ts +72 -0
  258. package/dist/components/organisms/game/puzzles/sequencer/index.d.ts +8 -0
  259. package/dist/components/organisms/game/puzzles/simulator/SimulatorBoard.d.ts +54 -0
  260. package/dist/components/organisms/game/puzzles/simulator/index.d.ts +2 -0
  261. package/dist/components/organisms/game/puzzles/state-architect/CodeView.d.ts +24 -0
  262. package/dist/components/organisms/game/puzzles/state-architect/StateArchitectBoard.d.ts +76 -0
  263. package/dist/components/organisms/game/puzzles/state-architect/StateNode.d.ts +33 -0
  264. package/dist/components/organisms/game/puzzles/state-architect/TransitionArrow.d.ts +36 -0
  265. package/dist/components/organisms/game/puzzles/state-architect/VariablePanel.d.ts +28 -0
  266. package/dist/components/organisms/game/puzzles/state-architect/index.d.ts +10 -0
  267. package/dist/components/organisms/game/three/Camera3D.d.ts +60 -0
  268. package/dist/components/organisms/game/three/Lighting3D.d.ts +47 -0
  269. package/dist/components/organisms/game/three/Scene3D.d.ts +37 -0
  270. package/dist/components/organisms/game/three/components/Canvas3DErrorBoundary.d.ts +51 -0
  271. package/dist/components/organisms/game/three/components/Canvas3DLoadingState.d.ts +44 -0
  272. package/dist/components/organisms/game/three/components/ModelLoader.d.ts +44 -0
  273. package/dist/components/organisms/game/three/components/PhysicsObject3D.d.ts +74 -0
  274. package/dist/components/organisms/game/three/components/index.d.ts +10 -0
  275. package/dist/components/organisms/game/three/hooks/useAssetLoader.d.ts +58 -0
  276. package/dist/components/organisms/game/three/hooks/useGameCanvas3DEvents.d.ts +79 -0
  277. package/dist/components/organisms/game/three/hooks/useRaycaster.d.ts +86 -0
  278. package/dist/components/organisms/game/three/hooks/useSceneGraph.d.ts +66 -0
  279. package/dist/components/organisms/game/three/hooks/useThree.d.ts +58 -0
  280. package/dist/components/organisms/game/three/index.d.ts +18 -1228
  281. package/dist/components/organisms/game/three/index.js +49 -1709
  282. package/dist/components/organisms/game/three/loaders/AssetLoader.d.ts +80 -0
  283. package/dist/components/organisms/game/three/renderers/FeatureRenderer.d.ts +44 -0
  284. package/dist/components/organisms/game/three/renderers/FeatureRenderer3D.d.ts +44 -0
  285. package/dist/components/organisms/game/three/renderers/TileRenderer.d.ts +57 -0
  286. package/dist/components/organisms/game/three/renderers/UnitRenderer.d.ts +46 -0
  287. package/dist/components/organisms/game/three/renderers/index.d.ts +11 -0
  288. package/dist/components/organisms/game/three/utils/culling.d.ts +134 -0
  289. package/dist/components/organisms/game/three/utils/grid3D.d.ts +154 -0
  290. package/dist/components/organisms/game/types/effects.d.ts +253 -0
  291. package/dist/components/organisms/game/types/game.d.ts +92 -0
  292. package/dist/{isometric-ynNHVPZx.d.ts → components/organisms/game/types/isometric.d.ts} +4 -6
  293. package/dist/components/organisms/game/types/spriteAnimation.d.ts +73 -0
  294. package/dist/components/organisms/game/useCanvasEffects.d.ts +26 -0
  295. package/dist/components/organisms/game/utils/canvasEffects.d.ts +50 -0
  296. package/dist/components/organisms/game/utils/combatEffects.d.ts +64 -0
  297. package/dist/components/organisms/game/utils/combatPresets.d.ts +15 -0
  298. package/dist/components/organisms/game/utils/isometric.d.ts +61 -0
  299. package/dist/components/organisms/game/utils/spriteAnimation.d.ts +57 -0
  300. package/dist/components/organisms/game/utils/spriteSheetConstants.d.ts +16 -0
  301. package/dist/components/organisms/index.d.ts +38 -0
  302. package/dist/components/organisms/layout/DashboardGrid.d.ts +35 -0
  303. package/dist/components/organisms/layout/MasterDetail.d.ts +32 -0
  304. package/dist/components/organisms/layout/SplitPane.d.ts +34 -0
  305. package/dist/components/organisms/layout/TabbedContainer.d.ts +42 -0
  306. package/dist/components/organisms/layout/index.d.ts +9 -0
  307. package/dist/components/organisms/types.d.ts +63 -0
  308. package/dist/components/templates/AuthLayout.d.ts +14 -0
  309. package/dist/components/templates/BattleTemplate.d.ts +25 -0
  310. package/dist/components/templates/CastleTemplate.d.ts +23 -0
  311. package/dist/components/templates/CounterTemplate.d.ts +44 -0
  312. package/dist/components/templates/DashboardLayout.d.ts +34 -0
  313. package/dist/components/templates/GameCanvas3DBattleTemplate.d.ts +96 -0
  314. package/dist/components/templates/GameCanvas3DCastleTemplate.d.ts +90 -0
  315. package/dist/components/templates/GameCanvas3DWorldMapTemplate.d.ts +96 -0
  316. package/dist/components/templates/GameShell.d.ts +34 -0
  317. package/dist/components/templates/GameTemplate.d.ts +36 -0
  318. package/dist/components/templates/GenericAppTemplate.d.ts +30 -0
  319. package/dist/components/templates/WorldMapTemplate.d.ts +29 -0
  320. package/dist/components/templates/index.d.ts +10 -0
  321. package/dist/components/templates/types.d.ts +22 -0
  322. package/dist/context/DesignThemeContext.d.ts +21 -0
  323. package/dist/{ThemeContext-D9xUORq5.d.ts → context/ThemeContext.d.ts} +15 -16
  324. package/dist/context/UISlotContext.d.ts +75 -0
  325. package/dist/context/UserContext.d.ts +111 -0
  326. package/dist/context/index.d.ts +6 -206
  327. package/dist/{event-bus-types-CjJduURa.d.ts → hooks/event-bus-types.d.ts} +4 -6
  328. package/dist/hooks/index.d.ts +30 -1220
  329. package/dist/hooks/index.js +2 -2
  330. package/dist/hooks/useAgentChat.d.ts +104 -0
  331. package/dist/hooks/useAuthContext.d.ts +25 -0
  332. package/dist/hooks/useCompile.d.ts +22 -0
  333. package/dist/hooks/useDeepAgentGeneration.d.ts +46 -0
  334. package/dist/hooks/useDragReorder.d.ts +26 -0
  335. package/dist/hooks/useEntities.d.ts +52 -0
  336. package/dist/hooks/useEntityData.d.ts +155 -0
  337. package/dist/hooks/useEntityMutations.d.ts +80 -0
  338. package/dist/hooks/useEventBus.d.ts +96 -0
  339. package/dist/hooks/useExtensions.d.ts +32 -0
  340. package/dist/hooks/useFileEditor.d.ts +32 -0
  341. package/dist/hooks/useFileSystem.d.ts +40 -0
  342. package/dist/hooks/useGitHub.d.ts +58 -0
  343. package/dist/hooks/useInfiniteScroll.d.ts +13 -0
  344. package/dist/hooks/useLongPress.d.ts +16 -0
  345. package/dist/hooks/useOrbitalHistory.d.ts +39 -0
  346. package/dist/hooks/useOrbitalMutations.d.ts +95 -0
  347. package/dist/hooks/usePinchZoom.d.ts +22 -0
  348. package/dist/hooks/usePreview.d.ts +57 -0
  349. package/dist/hooks/usePullToRefresh.d.ts +25 -0
  350. package/dist/hooks/useQuerySingleton.d.ts +78 -0
  351. package/dist/hooks/useResolvedEntity.d.ts +32 -0
  352. package/dist/hooks/useSwipeGesture.d.ts +26 -0
  353. package/dist/hooks/useTranslate.d.ts +35 -0
  354. package/dist/hooks/useUIEvents.d.ts +35 -0
  355. package/dist/{useUISlots-BBjNvQtb.d.ts → hooks/useUISlots.d.ts} +8 -9
  356. package/dist/hooks/useValidation.d.ts +46 -0
  357. package/dist/lib/api-client.d.ts +42 -0
  358. package/dist/lib/cn.d.ts +6 -0
  359. package/dist/lib/debug.d.ts +43 -0
  360. package/dist/lib/debugRegistry.d.ts +29 -0
  361. package/dist/lib/debugUtils.d.ts +27 -0
  362. package/dist/lib/entityDebug.d.ts +38 -0
  363. package/dist/lib/getNestedValue.d.ts +33 -0
  364. package/dist/lib/guardRegistry.d.ts +32 -0
  365. package/dist/lib/index.d.ts +17 -319
  366. package/dist/lib/index.js +1 -3
  367. package/dist/lib/jazari/index.d.ts +5 -0
  368. package/dist/lib/jazari/layout.d.ts +30 -0
  369. package/dist/lib/jazari/svg-paths.d.ts +61 -0
  370. package/dist/lib/jazari/types.d.ts +91 -0
  371. package/dist/lib/parseContentSegments.d.ts +41 -0
  372. package/dist/lib/tickRegistry.d.ts +40 -0
  373. package/dist/lib/traitRegistry.d.ts +34 -0
  374. package/dist/lib/verificationRegistry.d.ts +138 -0
  375. package/dist/lib/visualizer/browser.d.ts +47 -0
  376. package/dist/lib/visualizer/index.d.ts +143 -0
  377. package/dist/locales/index.d.ts +5 -7
  378. package/dist/providers/EventBusProvider.d.ts +60 -0
  379. package/dist/providers/FetchedDataProvider.d.ts +105 -0
  380. package/dist/providers/OfflineModeProvider.d.ts +79 -0
  381. package/dist/providers/OrbitalProvider.d.ts +101 -0
  382. package/dist/providers/SelectionProvider.d.ts +81 -0
  383. package/dist/providers/VerificationProvider.d.ts +63 -0
  384. package/dist/providers/index.css +599 -0
  385. package/dist/providers/index.d.ts +16 -464
  386. package/dist/providers/index.js +5 -4
  387. package/dist/renderer/client-effect-executor.d.ts +68 -0
  388. package/dist/renderer/data-resolver.d.ts +68 -0
  389. package/dist/renderer/index.d.ts +22 -519
  390. package/dist/renderer/init.d.ts +14 -0
  391. package/dist/renderer/navigation.d.ts +142 -0
  392. package/dist/{offline-executor-CHr4uAhf.d.ts → renderer/offline-executor.d.ts} +9 -172
  393. package/dist/renderer/pattern-resolver.d.ts +91 -0
  394. package/dist/renderer/slot-definitions.d.ts +45 -0
  395. package/dist/renderer/types.d.ts +160 -0
  396. package/dist/renderer/useClientEffects.d.ts +88 -0
  397. package/dist/runtime/EntitySchemaContext.d.ts +40 -0
  398. package/dist/runtime/TraitProvider.d.ts +52 -0
  399. package/dist/runtime/createClientEffectHandlers.d.ts +23 -0
  400. package/dist/runtime/index.css +599 -0
  401. package/dist/runtime/index.d.ts +10 -275
  402. package/dist/runtime/index.js +6 -6
  403. package/dist/runtime/types.d.ts +10 -0
  404. package/dist/runtime/ui/SlotsContext.d.ts +71 -0
  405. package/dist/runtime/useResolvedSchema.d.ts +45 -0
  406. package/dist/runtime/useTraitStateMachine.d.ts +48 -0
  407. package/dist/scripts/generate-design-system.d.ts +29 -0
  408. package/dist/scripts/generate-theme-from-schema.d.ts +10 -0
  409. package/dist/scripts/generate.d.ts +12 -0
  410. package/dist/scripts/suggest-components.d.ts +31 -0
  411. package/dist/scripts/types.d.ts +129 -0
  412. package/dist/stores/entityStore.d.ts +99 -0
  413. package/dist/stores/filtering.d.ts +51 -0
  414. package/dist/stores/index.d.ts +4 -148
  415. package/dist/tsup.config.d.ts +2 -0
  416. package/dist/vitest.config.d.ts +2 -0
  417. package/package.json +5 -4
  418. package/dist/chunk-42YQ6JVR.js +0 -48
  419. package/dist/chunk-WCTZ7WZX.js +0 -311
  420. package/dist/cn-C_ATNPvi.d.ts +0 -332
@@ -0,0 +1,112 @@
1
+ /**
2
+ * UISlotRenderer Component
3
+ *
4
+ * Renders all UI slots. This is the central component that displays
5
+ * content rendered by traits via render_ui effects.
6
+ *
7
+ * Slots are rendered as:
8
+ * - Layout slots: Inline in the page flow (main, sidebar)
9
+ * - Portal slots: Rendered via portals (modal, drawer, toast, etc.)
10
+ * - HUD slots: Fixed position overlays (hud-top, hud-bottom)
11
+ *
12
+ * @packageDocumentation
13
+ */
14
+ import React from "react";
15
+ import { type UISlot, type SlotContent } from "../../context/UISlotContext";
16
+ export interface SuspenseConfig {
17
+ /** Enable Suspense boundaries around slot content */
18
+ enabled: boolean;
19
+ /** Custom fallback per slot, overrides default Skeleton variant */
20
+ slotFallbacks?: Partial<Record<UISlot, React.ReactNode>>;
21
+ }
22
+ /**
23
+ * Provider for Suspense configuration.
24
+ * When enabled, each UI slot is wrapped in `<ErrorBoundary><Suspense>`.
25
+ */
26
+ export declare function SuspenseConfigProvider({ config, children, }: {
27
+ config: SuspenseConfig;
28
+ children: React.ReactNode;
29
+ }): React.FunctionComponentElement<React.ProviderProps<SuspenseConfig>>;
30
+ export declare namespace SuspenseConfigProvider {
31
+ var displayName: string;
32
+ }
33
+ interface UISlotComponentProps {
34
+ slot: UISlot;
35
+ portal?: boolean;
36
+ position?: "left" | "right" | "top-right" | "top-left" | "bottom-right" | "bottom-left";
37
+ className?: string;
38
+ draggable?: boolean;
39
+ isLoading?: boolean;
40
+ error?: Error | null;
41
+ entity?: string;
42
+ /** Compiled mode: render children directly instead of resolving from context */
43
+ children?: React.ReactNode;
44
+ /** Pattern type for data-pattern attribute (compiled mode) */
45
+ pattern?: string;
46
+ /** Source trait name for data-source-trait attribute (compiled mode) */
47
+ sourceTrait?: string;
48
+ }
49
+ /**
50
+ * Individual slot renderer.
51
+ *
52
+ * Handles different slot types with appropriate wrappers.
53
+ */
54
+ declare function UISlotComponent({ slot, portal, position, className, children, pattern, sourceTrait, }: UISlotComponentProps): React.ReactElement | null;
55
+ interface SlotContentRendererProps {
56
+ content: SlotContent;
57
+ onDismiss: () => void;
58
+ className?: string;
59
+ isLoading?: boolean;
60
+ error?: Error | null;
61
+ entity?: string;
62
+ }
63
+ /**
64
+ * Renders the actual content of a slot.
65
+ *
66
+ * Dynamically renders pattern components from the registry.
67
+ * For layout patterns with `hasChildren`, recursively renders nested patterns.
68
+ */
69
+ declare function SlotContentRenderer({ content, onDismiss, }: SlotContentRendererProps): React.ReactElement;
70
+ export interface UISlotRendererProps {
71
+ /** Include HUD slots */
72
+ includeHud?: boolean;
73
+ /** HUD positioning mode: 'fixed' (default, viewport-relative) or 'inline' (container-relative, uses sticky) */
74
+ hudMode?: 'fixed' | 'inline';
75
+ /** Include floating slot */
76
+ includeFloating?: boolean;
77
+ /** Additional class name for the container */
78
+ className?: string;
79
+ /** Loading state indicator */
80
+ isLoading?: boolean;
81
+ /** Error state */
82
+ error?: Error | null;
83
+ /** Entity name for schema-driven auto-fetch */
84
+ entity?: string;
85
+ /**
86
+ * Enable Suspense boundaries around each slot.
87
+ * When true, each inline slot is wrapped in `<ErrorBoundary><Suspense>` with
88
+ * Skeleton fallbacks. Opt-in — existing isLoading prop pattern still works.
89
+ */
90
+ suspense?: boolean | SuspenseConfig;
91
+ }
92
+ /**
93
+ * Main UI Slot Renderer component.
94
+ *
95
+ * Renders all slot containers. Place this in your page/layout component.
96
+ *
97
+ * @example
98
+ * ```tsx
99
+ * function PageLayout() {
100
+ * return (
101
+ * <div className="page-layout">
102
+ * <UISlotRenderer />
103
+ * </div>
104
+ * );
105
+ * }
106
+ * ```
107
+ */
108
+ export declare function UISlotRenderer({ includeHud, hudMode, includeFloating, className, suspense, }: UISlotRendererProps): React.ReactElement;
109
+ export declare namespace UISlotRenderer {
110
+ var displayName: string;
111
+ }
112
+ export { UISlotComponent, SlotContentRenderer };
@@ -0,0 +1,160 @@
1
+ /**
2
+ * WizardContainer Component
3
+ *
4
+ * Multi-step wizard pattern with progress indicator.
5
+ * Composes Box, Typography, and Button atoms.
6
+ *
7
+ * Uses wireframe theme styling (high contrast, sharp edges).
8
+ */
9
+ import React from "react";
10
+ /** Form field definition for wizard sections */
11
+ export interface WizardField {
12
+ id: string;
13
+ type: string;
14
+ label?: string;
15
+ required?: boolean;
16
+ repeatable?: boolean;
17
+ options?: Array<{
18
+ value: string;
19
+ label: string;
20
+ isDefault?: boolean;
21
+ }>;
22
+ defaultValue?: unknown;
23
+ condition?: unknown[];
24
+ placeholder?: string;
25
+ entityField?: string;
26
+ minLength?: number;
27
+ maxLength?: number;
28
+ dataSource?: Record<string, unknown>;
29
+ displayFields?: string[];
30
+ searchConfig?: Record<string, unknown>;
31
+ hiddenCalculations?: Array<{
32
+ variable: string;
33
+ expression: unknown;
34
+ scope?: string;
35
+ }>;
36
+ signatureConfig?: Record<string, unknown>;
37
+ displayTemplate?: Record<string, unknown>;
38
+ lawReference?: Record<string, unknown>;
39
+ contextMenu?: string[];
40
+ calculated?: Record<string, unknown>;
41
+ readOnly?: boolean;
42
+ minDate?: unknown;
43
+ stats?: Array<{
44
+ label: string;
45
+ value: unknown;
46
+ icon?: string;
47
+ }>;
48
+ items?: Array<{
49
+ id: string;
50
+ label: string;
51
+ autoCheck?: unknown;
52
+ }>;
53
+ [key: string]: unknown;
54
+ }
55
+ /** Section within a wizard step */
56
+ export interface WizardSection {
57
+ id: string;
58
+ title?: string;
59
+ description?: string;
60
+ fields?: WizardField[];
61
+ subsections?: WizardSection[];
62
+ condition?: unknown[];
63
+ repeatable?: boolean;
64
+ minItems?: number;
65
+ addButtonLabel?: string;
66
+ hiddenCalculations?: Array<{
67
+ variable: string;
68
+ expression: unknown;
69
+ scope?: string;
70
+ }>;
71
+ dataSource?: Record<string, unknown>;
72
+ readOnly?: boolean;
73
+ [key: string]: unknown;
74
+ }
75
+ /** Entity mapping configuration */
76
+ export interface WizardEntityMapping {
77
+ entity: string;
78
+ mode: "search_or_create" | "create_multiple" | "select_one" | "update" | string;
79
+ parentField?: string;
80
+ idField?: string;
81
+ [key: string]: unknown;
82
+ }
83
+ /** Validation rule for wizard steps */
84
+ export interface WizardValidationRule {
85
+ condition: unknown[];
86
+ message: string;
87
+ }
88
+ /** Law reference for compliance */
89
+ export interface WizardLawReference {
90
+ law: string;
91
+ article: string;
92
+ description?: string;
93
+ }
94
+ export interface WizardStep {
95
+ /** Step identifier */
96
+ id?: string;
97
+ /** Tab identifier (schema-driven) */
98
+ tabId?: string;
99
+ /** Step title */
100
+ title?: string;
101
+ /** Step name (schema-driven, used as title if title not provided) */
102
+ name?: string;
103
+ /** Step description (optional) */
104
+ description?: string;
105
+ /** Step content (React component mode) */
106
+ content?: React.ReactNode;
107
+ /** Whether this step can be skipped */
108
+ optional?: boolean;
109
+ /** Custom validation for this step */
110
+ isValid?: () => boolean;
111
+ /** Form sections within this step */
112
+ sections?: WizardSection[];
113
+ /** Global variables required before entering this step */
114
+ globalVariablesRequired?: string[];
115
+ /** Global variables set by this step */
116
+ globalVariablesSet?: string[];
117
+ /** Local variables scoped to this step */
118
+ localVariables?: string[];
119
+ /** Entity mapping configuration */
120
+ entityMapping?: WizardEntityMapping;
121
+ /** Validation rules for this step */
122
+ validationRules?: WizardValidationRule[];
123
+ /** Law references for compliance */
124
+ lawReferences?: WizardLawReference[];
125
+ /** Phase of the inspection process */
126
+ phase?: string;
127
+ /** Context menu actions */
128
+ contextMenu?: string[];
129
+ /** Allow additional properties from schema */
130
+ [key: string]: unknown;
131
+ }
132
+ export interface WizardContainerProps {
133
+ /** Wizard steps */
134
+ steps: WizardStep[];
135
+ /** Current step index (controlled) - accepts unknown for generated code compatibility */
136
+ currentStep?: number | string | unknown;
137
+ /** Callback when step changes */
138
+ onStepChange?: (stepIndex: number) => void;
139
+ /** Callback when wizard is completed */
140
+ onComplete?: () => void;
141
+ /** Show progress indicator */
142
+ showProgress?: boolean;
143
+ /** Allow navigation to previous steps */
144
+ allowBack?: boolean;
145
+ /** Modal mode (compact header, no padding) */
146
+ compact?: boolean;
147
+ /** Additional CSS classes */
148
+ className?: string;
149
+ /** Loading state indicator */
150
+ isLoading?: boolean;
151
+ /** Error state */
152
+ error?: Error | null;
153
+ /** Entity type name (schema-driven) */
154
+ entity?: string;
155
+ }
156
+ /**
157
+ * WizardContainer - Multi-step wizard
158
+ */
159
+ export declare const WizardContainer: React.FC<WizardContainerProps>;
160
+ export default WizardContainer;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * BookChapterView Organism
3
+ *
4
+ * Renders a single chapter: title + optional orbital diagram +
5
+ * rich content via ContentRenderer.
6
+ *
7
+ * Event Contract:
8
+ * - Delegates to ContentRenderer children
9
+ */
10
+ import React from 'react';
11
+ import type { EntityDisplayProps } from '../types';
12
+ import type { BookChapter } from './types';
13
+ export interface BookChapterViewProps extends EntityDisplayProps<BookChapter> {
14
+ chapter: BookChapter;
15
+ direction?: 'rtl' | 'ltr';
16
+ }
17
+ export declare const BookChapterView: React.FC<BookChapterViewProps>;
@@ -0,0 +1,20 @@
1
+ /**
2
+ * BookCoverPage Molecule
3
+ *
4
+ * Renders a book cover with title, subtitle, author, and optional image.
5
+ * Centered layout suitable for the first "page" of a BookViewer.
6
+ *
7
+ * Event Contract:
8
+ * - Emits: UI:BOOK_START
9
+ */
10
+ import React from 'react';
11
+ import type { EntityDisplayProps } from '../types';
12
+ import type { BookData } from './types';
13
+ export interface BookCoverPageProps extends EntityDisplayProps<BookData> {
14
+ title: string;
15
+ subtitle?: string;
16
+ author?: string;
17
+ coverImageUrl?: string;
18
+ direction?: 'rtl' | 'ltr';
19
+ }
20
+ export declare const BookCoverPage: React.FC<BookCoverPageProps>;
@@ -0,0 +1,19 @@
1
+ /**
2
+ * BookNavBar Molecule
3
+ *
4
+ * Navigation bar for the BookViewer with prev/next, page indicator,
5
+ * print button, and TOC toggle.
6
+ *
7
+ * Event Contract:
8
+ * - Emits: UI:BOOK_PAGE_PREV, UI:BOOK_PAGE_NEXT, UI:BOOK_PRINT, UI:BOOK_SHOW_TOC
9
+ */
10
+ import React from 'react';
11
+ import type { EntityDisplayProps } from '../types';
12
+ import type { BookData } from './types';
13
+ export interface BookNavBarProps extends EntityDisplayProps<BookData> {
14
+ currentPage: number;
15
+ totalPages: number;
16
+ chapterTitle?: string;
17
+ direction?: 'rtl' | 'ltr';
18
+ }
19
+ export declare const BookNavBar: React.FC<BookNavBarProps>;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * BookTableOfContents Molecule
3
+ *
4
+ * Renders a clickable table of contents grouped by parts.
5
+ * Highlights the current chapter.
6
+ *
7
+ * Event Contract:
8
+ * - Emits: UI:BOOK_NAVIGATE { chapterId }
9
+ */
10
+ import React from 'react';
11
+ import type { EntityDisplayProps } from '../types';
12
+ import type { BookPart } from './types';
13
+ export interface BookTableOfContentsProps extends EntityDisplayProps<BookPart> {
14
+ parts: BookPart[];
15
+ currentChapterId?: string;
16
+ direction?: 'rtl' | 'ltr';
17
+ }
18
+ export declare const BookTableOfContents: React.FC<BookTableOfContentsProps>;
@@ -0,0 +1,28 @@
1
+ /**
2
+ * BookViewer Organism
3
+ *
4
+ * Flippable book reader with cover, TOC, chapter views, and navigation.
5
+ * Supports RTL layout (Arabic), CSS slide transitions, and print mode.
6
+ *
7
+ * Page model:
8
+ * 0 = cover, 1 = TOC, 2+ = chapters (flattened from parts)
9
+ *
10
+ * Field mapping:
11
+ * Entity data may use non-English field names (e.g. Arabic .orb schemas).
12
+ * Pass a `fieldMap` prop to translate entity fields to canonical BookData.
13
+ * Default: IDENTITY_BOOK_FIELDS (English field names, no translation).
14
+ *
15
+ * Event Contract:
16
+ * - Emits: UI:BOOK_PAGE_CHANGE { pageIndex, chapterId? }
17
+ * - Listens: UI:BOOK_START, UI:BOOK_NAVIGATE, UI:BOOK_PAGE_PREV/NEXT, UI:BOOK_PRINT, UI:BOOK_SHOW_TOC
18
+ */
19
+ import React from 'react';
20
+ import type { EntityDisplayProps } from '../types';
21
+ import type { BookData, BookFieldMap } from './types';
22
+ export interface BookViewerProps extends EntityDisplayProps<BookData | Record<string, unknown>> {
23
+ /** Initial page index (default: 0 = cover) */
24
+ initialPage?: number;
25
+ /** Field name translation map — a BookFieldMap object or locale key ("ar") */
26
+ fieldMap?: BookFieldMap | string;
27
+ }
28
+ export declare const BookViewer: React.FC<BookViewerProps>;
@@ -0,0 +1,7 @@
1
+ export { BookViewer, type BookViewerProps } from './BookViewer';
2
+ export { BookChapterView, type BookChapterViewProps } from './BookChapterView';
3
+ export { BookCoverPage, type BookCoverPageProps } from './BookCoverPage';
4
+ export { BookTableOfContents, type BookTableOfContentsProps } from './BookTableOfContents';
5
+ export { BookNavBar, type BookNavBarProps } from './BookNavBar';
6
+ export type { BookData, BookPart, BookChapter, BookFieldMap } from './types';
7
+ export { mapBookData, resolveFieldMap, IDENTITY_BOOK_FIELDS, AR_BOOK_FIELDS } from './types';
@@ -0,0 +1,77 @@
1
+ /**
2
+ * BookViewer shared types
3
+ *
4
+ * Field names are canonical English. When entity data arrives from a
5
+ * schema with non-English field names (e.g. Arabic .orb), a field map
6
+ * translates them before passing to BookViewer. See `mapBookData()`.
7
+ */
8
+ export interface BookData {
9
+ title: string;
10
+ subtitle?: string;
11
+ author?: string;
12
+ coverImageUrl?: string;
13
+ direction?: 'rtl' | 'ltr';
14
+ parts: BookPart[];
15
+ }
16
+ export interface BookPart {
17
+ title: string;
18
+ chapters: BookChapter[];
19
+ }
20
+ export interface BookChapter {
21
+ id: string;
22
+ title: string;
23
+ content: string;
24
+ orbitalSchema?: unknown;
25
+ }
26
+ /**
27
+ * Maps raw entity field names to canonical BookData field names.
28
+ * Each key is a canonical field, each value is the entity field name.
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * // Arabic schema
33
+ * const AR_BOOK_FIELDS: BookFieldMap = {
34
+ * title: 'العنوان',
35
+ * subtitle: 'العنوان_الفرعي',
36
+ * author: 'المؤلف',
37
+ * coverImageUrl: 'صورة_الغلاف',
38
+ * direction: 'الاتجاه',
39
+ * parts: 'الأجزاء',
40
+ * partTitle: 'العنوان',
41
+ * chapters: 'الفصول',
42
+ * chapterId: 'المعرف',
43
+ * chapterTitle: 'العنوان',
44
+ * chapterContent: 'المحتوى',
45
+ * chapterOrbitalSchema: 'المخطط_المداري',
46
+ * };
47
+ * ```
48
+ */
49
+ export interface BookFieldMap {
50
+ title: string;
51
+ subtitle: string;
52
+ author: string;
53
+ coverImageUrl: string;
54
+ direction: string;
55
+ parts: string;
56
+ partTitle: string;
57
+ chapters: string;
58
+ chapterId: string;
59
+ chapterTitle: string;
60
+ chapterContent: string;
61
+ chapterOrbitalSchema: string;
62
+ }
63
+ /** Identity map — entity already uses canonical English field names */
64
+ export declare const IDENTITY_BOOK_FIELDS: BookFieldMap;
65
+ /** Arabic field map for الأمة_الرقمية schema */
66
+ export declare const AR_BOOK_FIELDS: BookFieldMap;
67
+ /**
68
+ * Resolves a fieldMap prop to a BookFieldMap object.
69
+ * Accepts a BookFieldMap object directly, a locale string key ("ar"),
70
+ * or undefined (defaults to identity/English).
71
+ */
72
+ export declare function resolveFieldMap(fieldMap: BookFieldMap | string | undefined): BookFieldMap;
73
+ /**
74
+ * Maps a raw entity record to a typed BookData using a field map.
75
+ * Pass `IDENTITY_BOOK_FIELDS` for English schemas, `AR_BOOK_FIELDS` for Arabic, etc.
76
+ */
77
+ export declare function mapBookData(raw: Record<string, unknown>, fields?: BookFieldMap): BookData;
@@ -0,0 +1,9 @@
1
+ import type React from 'react';
2
+ /**
3
+ * Maps component names to actual React components.
4
+ * Generated from @almadar/patterns component-mapping.json.
5
+ *
6
+ * Pattern wrappers (ButtonPattern, VStackPattern, etc.) adapt the raw component
7
+ * API to the render-ui config format. Direct components are used when no wrapper exists.
8
+ */
9
+ export declare const COMPONENT_REGISTRY: Record<string, React.ComponentType<any>>;
@@ -0,0 +1,19 @@
1
+ import './RuntimeDebugger.css';
2
+ export interface RuntimeDebuggerProps {
3
+ /** Initial position */
4
+ position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
5
+ /** Initial collapsed state */
6
+ defaultCollapsed?: boolean;
7
+ /** Additional CSS classes */
8
+ className?: string;
9
+ /** Display mode: floating (fixed overlay) or inline (block element) */
10
+ mode?: 'floating' | 'inline';
11
+ /** Default active tab id */
12
+ defaultTab?: string;
13
+ /** Raw schema for EventDispatcherTab payload extraction */
14
+ schema?: Record<string, unknown>;
15
+ }
16
+ export declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): import("react/jsx-runtime").JSX.Element | null;
17
+ export declare namespace RuntimeDebugger {
18
+ var displayName: string;
19
+ }
@@ -0,0 +1,25 @@
1
+ import { type TraitDebugInfo } from '../../../../lib/traitRegistry';
2
+ import { type TickExecution } from '../../../../lib/tickRegistry';
3
+ import { type GuardEvaluation } from '../../../../lib/guardRegistry';
4
+ import { type EntitySnapshot } from '../../../../lib/entityDebug';
5
+ import { type DebugEvent } from '../../../../lib/debugRegistry';
6
+ import { type VerificationCheck, type TransitionTrace, type BridgeHealth, type VerificationSummary } from '../../../../lib/verificationRegistry';
7
+ export interface DebugData {
8
+ traits: TraitDebugInfo[];
9
+ ticks: TickExecution[];
10
+ guards: GuardEvaluation[];
11
+ events: DebugEvent[];
12
+ entitySnapshot: EntitySnapshot | null;
13
+ verification: {
14
+ checks: VerificationCheck[];
15
+ transitions: TransitionTrace[];
16
+ bridge: BridgeHealth | null;
17
+ summary: VerificationSummary;
18
+ };
19
+ lastUpdate: number;
20
+ }
21
+ /**
22
+ * Hook that aggregates data from all debug registries.
23
+ * Subscribes to changes and polls entity snapshots.
24
+ */
25
+ export declare function useDebugData(): DebugData;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Debug Organism Components
3
+ *
4
+ * Runtime debugging and verification tools for KFlow applications.
5
+ *
6
+ * @packageDocumentation
7
+ */
8
+ export { RuntimeDebugger, type RuntimeDebuggerProps } from './RuntimeDebugger';
9
+ export { useDebugData, type DebugData } from './hooks/useDebugData';
10
+ export { VerificationTab } from './tabs/VerificationTab';
11
+ export { TransitionTimeline } from './tabs/TransitionTimeline';
12
+ export { ServerBridgeTab } from './tabs/ServerBridgeTab';
13
+ export { EventDispatcherTab } from './tabs/EventDispatcherTab';
@@ -0,0 +1,13 @@
1
+ /**
2
+ * EntitiesTab - Displays entity snapshots
3
+ * Uses existing component library atoms/molecules.
4
+ */
5
+ import type { EntitySnapshot } from '../../../../lib/entityDebug';
6
+ interface EntitiesTabProps {
7
+ snapshot: EntitySnapshot | null;
8
+ }
9
+ export declare function EntitiesTab({ snapshot }: EntitiesTabProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare namespace EntitiesTab {
11
+ var displayName: string;
12
+ }
13
+ export {};
@@ -0,0 +1,16 @@
1
+ /**
2
+ * EventDispatcherTab - Fire events into the state machine from the debug panel
3
+ *
4
+ * Shows available transitions per trait based on current state,
5
+ * lets users click to fire events, and displays a compact transition log.
6
+ */
7
+ import type { TraitDebugInfo } from '../../../../lib/traitRegistry';
8
+ interface EventDispatcherTabProps {
9
+ traits: TraitDebugInfo[];
10
+ schema?: Record<string, unknown>;
11
+ }
12
+ export declare function EventDispatcherTab({ traits, schema }: EventDispatcherTabProps): import("react/jsx-runtime").JSX.Element;
13
+ export declare namespace EventDispatcherTab {
14
+ var displayName: string;
15
+ }
16
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { DebugEvent } from '../../../../lib/debugRegistry';
2
+ interface EventFlowTabProps {
3
+ events: DebugEvent[];
4
+ }
5
+ export declare function EventFlowTab({ events }: EventFlowTabProps): import("react/jsx-runtime").JSX.Element;
6
+ export declare namespace EventFlowTab {
7
+ var displayName: string;
8
+ }
9
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { GuardEvaluation } from '../../../../lib/guardRegistry';
2
+ interface GuardsPanelProps {
3
+ guards: GuardEvaluation[];
4
+ }
5
+ export declare function GuardsPanel({ guards }: GuardsPanelProps): import("react/jsx-runtime").JSX.Element;
6
+ export declare namespace GuardsPanel {
7
+ var displayName: string;
8
+ }
9
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { BridgeHealth } from '../../../../lib/verificationRegistry';
2
+ interface ServerBridgeTabProps {
3
+ bridge: BridgeHealth | null;
4
+ }
5
+ export declare function ServerBridgeTab({ bridge }: ServerBridgeTabProps): import("react/jsx-runtime").JSX.Element;
6
+ export declare namespace ServerBridgeTab {
7
+ var displayName: string;
8
+ }
9
+ export {};
@@ -0,0 +1,13 @@
1
+ /**
2
+ * TicksTab - Displays tick execution timing and status
3
+ * Uses existing component library atoms/molecules.
4
+ */
5
+ import type { TickExecution } from '../../../../lib/tickRegistry';
6
+ interface TicksTabProps {
7
+ ticks: TickExecution[];
8
+ }
9
+ export declare function TicksTab({ ticks }: TicksTabProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare namespace TicksTab {
11
+ var displayName: string;
12
+ }
13
+ export {};
@@ -0,0 +1,13 @@
1
+ /**
2
+ * TraitsTab - Displays active traits and their state machines
3
+ * Uses existing component library atoms/molecules.
4
+ */
5
+ import type { TraitDebugInfo } from '../../../../lib/traitRegistry';
6
+ interface TraitsTabProps {
7
+ traits: TraitDebugInfo[];
8
+ }
9
+ export declare function TraitsTab({ traits }: TraitsTabProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare namespace TraitsTab {
11
+ var displayName: string;
12
+ }
13
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { TransitionTrace } from '../../../../lib/verificationRegistry';
2
+ interface TransitionTimelineProps {
3
+ transitions: TransitionTrace[];
4
+ }
5
+ export declare function TransitionTimeline({ transitions }: TransitionTimelineProps): import("react/jsx-runtime").JSX.Element;
6
+ export declare namespace TransitionTimeline {
7
+ var displayName: string;
8
+ }
9
+ export {};
@@ -0,0 +1,10 @@
1
+ import type { VerificationCheck, VerificationSummary } from '../../../../lib/verificationRegistry';
2
+ interface VerificationTabProps {
3
+ checks: VerificationCheck[];
4
+ summary: VerificationSummary;
5
+ }
6
+ export declare function VerificationTab({ checks, summary }: VerificationTabProps): import("react/jsx-runtime").JSX.Element;
7
+ export declare namespace VerificationTab {
8
+ var displayName: string;
9
+ }
10
+ export {};