@almadar/ui 5.103.0 → 5.104.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 (66) hide show
  1. package/dist/avl/index.cjs +15 -9
  2. package/dist/avl/index.css +3 -3
  3. package/dist/avl/index.js +15 -9
  4. package/dist/components/core/atoms/AtlasImage.d.ts +2 -2
  5. package/dist/components/core/atoms/FlipContainer.d.ts +1 -1
  6. package/dist/components/core/molecules/Card.d.ts +1 -1
  7. package/dist/components/core/molecules/Chart.d.ts +3 -3
  8. package/dist/components/core/molecules/DataGrid.d.ts +1 -1
  9. package/dist/components/core/molecules/DataList.d.ts +1 -1
  10. package/dist/components/core/molecules/DocPagination.d.ts +8 -1
  11. package/dist/components/core/molecules/DocSearch.d.ts +8 -1
  12. package/dist/components/core/molecules/FlipCard.d.ts +1 -1
  13. package/dist/components/core/molecules/LineChart.d.ts +3 -1
  14. package/dist/components/core/molecules/MapView.d.ts +18 -1
  15. package/dist/components/core/molecules/SortableList.d.ts +1 -1
  16. package/dist/components/core/molecules/TableView.d.ts +1 -1
  17. package/dist/components/core/organisms/DataTable.d.ts +7 -3
  18. package/dist/components/core/organisms/debug/RuntimeDebugger.d.ts +10 -1
  19. package/dist/components/core/organisms/debug/tabs/EntitiesTab.d.ts +2 -1
  20. package/dist/components/core/organisms/debug/tabs/EventDispatcherTab.d.ts +2 -1
  21. package/dist/components/core/organisms/debug/tabs/EventFlowTab.d.ts +6 -1
  22. package/dist/components/core/organisms/debug/tabs/GuardsPanel.d.ts +6 -1
  23. package/dist/components/core/organisms/debug/tabs/ServerBridgeTab.d.ts +12 -1
  24. package/dist/components/core/organisms/debug/tabs/TicksTab.d.ts +2 -1
  25. package/dist/components/core/organisms/debug/tabs/TraitsTab.d.ts +2 -1
  26. package/dist/components/core/organisms/debug/tabs/TransitionTimeline.d.ts +11 -1
  27. package/dist/components/core/organisms/debug/tabs/VerificationTab.d.ts +8 -1
  28. package/dist/components/game/2d/atoms/ActionButton.d.ts +2 -1
  29. package/dist/components/game/2d/atoms/ChoiceButton.d.ts +2 -1
  30. package/dist/components/game/2d/atoms/ComboCounter.d.ts +2 -1
  31. package/dist/components/game/2d/atoms/ControlButton.d.ts +2 -1
  32. package/dist/components/game/2d/atoms/DamageNumber.d.ts +2 -1
  33. package/dist/components/game/2d/atoms/DialogueBubble.d.ts +2 -1
  34. package/dist/components/game/2d/atoms/GameIcon.d.ts +2 -1
  35. package/dist/components/game/2d/atoms/HealthBar.d.ts +2 -1
  36. package/dist/components/game/2d/atoms/ItemSlot.d.ts +2 -1
  37. package/dist/components/game/2d/atoms/MiniMap.d.ts +2 -1
  38. package/dist/components/game/2d/atoms/ResourceCounter.d.ts +2 -1
  39. package/dist/components/game/2d/atoms/ScoreDisplay.d.ts +2 -1
  40. package/dist/components/game/2d/atoms/StatusEffect.d.ts +2 -1
  41. package/dist/components/game/2d/atoms/TimerDisplay.d.ts +2 -1
  42. package/dist/components/game/2d/atoms/TurnIndicator.d.ts +2 -1
  43. package/dist/components/game/2d/atoms/WaypointMarker.d.ts +2 -1
  44. package/dist/components/game/2d/molecules/Canvas2D.d.ts +5 -4
  45. package/dist/components/game/2d/molecules/GameHud.d.ts +2 -1
  46. package/dist/components/game/2d/molecules/GameMenu.d.ts +2 -1
  47. package/dist/components/game/2d/molecules/InventoryGrid.d.ts +2 -1
  48. package/dist/components/game/2d/molecules/ResourceBar.d.ts +2 -1
  49. package/dist/components/game/2d/molecules/StatBadge.d.ts +2 -1
  50. package/dist/components/game/shared/lib/editorUtils.d.ts +8 -8
  51. package/dist/components/index.cjs +11 -5
  52. package/dist/components/index.css +3 -3
  53. package/dist/components/index.js +11 -5
  54. package/dist/hooks/useGitHub.d.ts +7 -7
  55. package/dist/marketing/index.cjs +2 -2
  56. package/dist/marketing/index.js +2 -2
  57. package/dist/providers/EventBusProvider.d.ts +1 -1
  58. package/dist/providers/SelectionProvider.d.ts +1 -1
  59. package/dist/providers/ServerBridge.d.ts +1 -1
  60. package/dist/providers/index.cjs +11 -5
  61. package/dist/providers/index.css +3 -3
  62. package/dist/providers/index.js +11 -5
  63. package/dist/runtime/index.cjs +11 -5
  64. package/dist/runtime/index.css +3 -3
  65. package/dist/runtime/index.js +11 -5
  66. package/package.json +10 -15
@@ -630,7 +630,7 @@ var init_AvlFieldType = __esm({
630
630
  }
631
631
  });
632
632
 
633
- // node_modules/clsx/dist/clsx.mjs
633
+ // node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
634
634
  function r(e) {
635
635
  var t, f3, n = "";
636
636
  if ("string" == typeof e || "number" == typeof e) n += e;
@@ -645,11 +645,11 @@ function clsx() {
645
645
  return n;
646
646
  }
647
647
  var init_clsx = __esm({
648
- "node_modules/clsx/dist/clsx.mjs"() {
648
+ "node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs"() {
649
649
  }
650
650
  });
651
651
 
652
- // node_modules/tailwind-merge/dist/bundle-mjs.mjs
652
+ // node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
653
653
  function twJoin() {
654
654
  let index = 0;
655
655
  let argument;
@@ -693,7 +693,7 @@ function createTailwindMerge(createConfigFirst, ...createConfigRest) {
693
693
  }
694
694
  var CLASS_PART_SEPARATOR, createClassGroupUtils, getGroupRecursive, arbitraryPropertyRegex, getGroupIdForArbitraryProperty, createClassMap, processClassesRecursively, getPart, isThemeGetter, getPrefixedClassGroupEntries, createLruCache, IMPORTANT_MODIFIER, createParseClassName, sortModifiers, createConfigUtils, SPLIT_CLASSES_REGEX, mergeClassList, toValue, fromTheme, arbitraryValueRegex, fractionRegex, stringLengths, tshirtUnitRegex, lengthUnitRegex, colorFunctionRegex, shadowRegex, imageRegex, isLength, isArbitraryLength, isNumber, isArbitraryNumber, isInteger, isPercent, isArbitraryValue, isTshirtSize, sizeLabels, isArbitrarySize, isArbitraryPosition, imageLabels, isArbitraryImage, isArbitraryShadow, isAny, getIsArbitraryValue, isLengthOnly, isNever, isShadow, isImage, getDefaultConfig, twMerge;
695
695
  var init_bundle_mjs = __esm({
696
- "node_modules/tailwind-merge/dist/bundle-mjs.mjs"() {
696
+ "node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs"() {
697
697
  CLASS_PART_SEPARATOR = "-";
698
698
  createClassGroupUtils = (config) => {
699
699
  const classMap = createClassMap(config);
@@ -14003,6 +14003,9 @@ var init_useUnitSpriteAtlas = __esm({
14003
14003
  init_spriteAnimation();
14004
14004
  }
14005
14005
  });
14006
+ function normalizeBackdrop(bg) {
14007
+ return typeof bg === "string" ? { url: bg, role: "decoration", category: "background" } : bg;
14008
+ }
14006
14009
  function SideView({
14007
14010
  player,
14008
14011
  platforms,
@@ -14012,7 +14015,7 @@ function SideView({
14012
14015
  canvasHeight,
14013
14016
  follow,
14014
14017
  bgColor,
14015
- backgroundImage,
14018
+ backgroundImage: backgroundImageRaw,
14016
14019
  playerSprite,
14017
14020
  tileSprites,
14018
14021
  effects,
@@ -14020,6 +14023,7 @@ function SideView({
14020
14023
  keyUpMap,
14021
14024
  className
14022
14025
  }) {
14026
+ const backgroundImage = normalizeBackdrop(backgroundImageRaw);
14023
14027
  const canvasRef = React105.useRef(null);
14024
14028
  const eventBus = useEventBus();
14025
14029
  const keysRef = React105.useRef(/* @__PURE__ */ new Set());
@@ -14311,7 +14315,7 @@ function Canvas2D({
14311
14315
  effects: _effectsPropRaw = [],
14312
14316
  platforms,
14313
14317
  player,
14314
- backgroundImage,
14318
+ backgroundImage: backgroundImageRaw,
14315
14319
  // Interaction state
14316
14320
  selectedUnitId = null,
14317
14321
  validMoves = [],
@@ -14352,6 +14356,7 @@ function Canvas2D({
14352
14356
  // Remote asset loading
14353
14357
  assetManifest
14354
14358
  }) {
14359
+ const backgroundImage = normalizeBackdrop(backgroundImageRaw);
14355
14360
  const isSide = projection === "side";
14356
14361
  const isFree = projection === "free";
14357
14362
  const flatLike = projection === "hex" || projection === "flat" || isFree;
@@ -20335,9 +20340,9 @@ var init_BiologyCanvas = __esm({
20335
20340
  }
20336
20341
  });
20337
20342
 
20338
- // node_modules/katex/dist/katex.min.css
20343
+ // node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css
20339
20344
  var init_katex_min = __esm({
20340
- "node_modules/katex/dist/katex.min.css"() {
20345
+ "node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css"() {
20341
20346
  }
20342
20347
  });
20343
20348
  var Tabs;
@@ -32543,8 +32548,9 @@ var init_LineChart = __esm({
32543
32548
  const safeData = data ?? [];
32544
32549
  const sortedData = React105.useMemo(() => {
32545
32550
  if (safeData.length === 0) return [];
32551
+ if (!safeData.some((d) => d.date != null)) return [...safeData];
32546
32552
  return [...safeData].sort(
32547
- (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()
32553
+ (a, b) => new Date(a.date ?? 0).getTime() - new Date(b.date ?? 0).getTime()
32548
32554
  );
32549
32555
  }, [safeData]);
32550
32556
  const points = React105.useMemo(() => {
@@ -1,4 +1,4 @@
1
- /* node_modules/katex/dist/katex.min.css */
1
+ /* node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css */
2
2
  @font-face {
3
3
  font-display: block;
4
4
  font-family: KaTeX_AMS;
@@ -214,11 +214,11 @@
214
214
  border-color: currentColor;
215
215
  }
216
216
  .katex .katex-version:after {
217
- content: "0.16.45";
217
+ content: "0.16.47";
218
218
  }
219
219
  .katex .katex-mathml {
220
- clip: rect(1px, 1px, 1px, 1px);
221
220
  border: 0;
221
+ clip-path: inset(50%);
222
222
  height: 1px;
223
223
  overflow: hidden;
224
224
  padding: 0;
package/dist/avl/index.js CHANGED
@@ -584,7 +584,7 @@ var init_AvlFieldType = __esm({
584
584
  }
585
585
  });
586
586
 
587
- // node_modules/clsx/dist/clsx.mjs
587
+ // node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
588
588
  function r(e) {
589
589
  var t, f3, n = "";
590
590
  if ("string" == typeof e || "number" == typeof e) n += e;
@@ -599,11 +599,11 @@ function clsx() {
599
599
  return n;
600
600
  }
601
601
  var init_clsx = __esm({
602
- "node_modules/clsx/dist/clsx.mjs"() {
602
+ "node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs"() {
603
603
  }
604
604
  });
605
605
 
606
- // node_modules/tailwind-merge/dist/bundle-mjs.mjs
606
+ // node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
607
607
  function twJoin() {
608
608
  let index = 0;
609
609
  let argument;
@@ -647,7 +647,7 @@ function createTailwindMerge(createConfigFirst, ...createConfigRest) {
647
647
  }
648
648
  var CLASS_PART_SEPARATOR, createClassGroupUtils, getGroupRecursive, arbitraryPropertyRegex, getGroupIdForArbitraryProperty, createClassMap, processClassesRecursively, getPart, isThemeGetter, getPrefixedClassGroupEntries, createLruCache, IMPORTANT_MODIFIER, createParseClassName, sortModifiers, createConfigUtils, SPLIT_CLASSES_REGEX, mergeClassList, toValue, fromTheme, arbitraryValueRegex, fractionRegex, stringLengths, tshirtUnitRegex, lengthUnitRegex, colorFunctionRegex, shadowRegex, imageRegex, isLength, isArbitraryLength, isNumber, isArbitraryNumber, isInteger, isPercent, isArbitraryValue, isTshirtSize, sizeLabels, isArbitrarySize, isArbitraryPosition, imageLabels, isArbitraryImage, isArbitraryShadow, isAny, getIsArbitraryValue, isLengthOnly, isNever, isShadow, isImage, getDefaultConfig, twMerge;
649
649
  var init_bundle_mjs = __esm({
650
- "node_modules/tailwind-merge/dist/bundle-mjs.mjs"() {
650
+ "node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs"() {
651
651
  CLASS_PART_SEPARATOR = "-";
652
652
  createClassGroupUtils = (config) => {
653
653
  const classMap = createClassMap(config);
@@ -13957,6 +13957,9 @@ var init_useUnitSpriteAtlas = __esm({
13957
13957
  init_spriteAnimation();
13958
13958
  }
13959
13959
  });
13960
+ function normalizeBackdrop(bg) {
13961
+ return typeof bg === "string" ? { url: bg, role: "decoration", category: "background" } : bg;
13962
+ }
13960
13963
  function SideView({
13961
13964
  player,
13962
13965
  platforms,
@@ -13966,7 +13969,7 @@ function SideView({
13966
13969
  canvasHeight,
13967
13970
  follow,
13968
13971
  bgColor,
13969
- backgroundImage,
13972
+ backgroundImage: backgroundImageRaw,
13970
13973
  playerSprite,
13971
13974
  tileSprites,
13972
13975
  effects,
@@ -13974,6 +13977,7 @@ function SideView({
13974
13977
  keyUpMap,
13975
13978
  className
13976
13979
  }) {
13980
+ const backgroundImage = normalizeBackdrop(backgroundImageRaw);
13977
13981
  const canvasRef = useRef(null);
13978
13982
  const eventBus = useEventBus();
13979
13983
  const keysRef = useRef(/* @__PURE__ */ new Set());
@@ -14265,7 +14269,7 @@ function Canvas2D({
14265
14269
  effects: _effectsPropRaw = [],
14266
14270
  platforms,
14267
14271
  player,
14268
- backgroundImage,
14272
+ backgroundImage: backgroundImageRaw,
14269
14273
  // Interaction state
14270
14274
  selectedUnitId = null,
14271
14275
  validMoves = [],
@@ -14306,6 +14310,7 @@ function Canvas2D({
14306
14310
  // Remote asset loading
14307
14311
  assetManifest
14308
14312
  }) {
14313
+ const backgroundImage = normalizeBackdrop(backgroundImageRaw);
14309
14314
  const isSide = projection === "side";
14310
14315
  const isFree = projection === "free";
14311
14316
  const flatLike = projection === "hex" || projection === "flat" || isFree;
@@ -20289,9 +20294,9 @@ var init_BiologyCanvas = __esm({
20289
20294
  }
20290
20295
  });
20291
20296
 
20292
- // node_modules/katex/dist/katex.min.css
20297
+ // node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css
20293
20298
  var init_katex_min = __esm({
20294
- "node_modules/katex/dist/katex.min.css"() {
20299
+ "node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css"() {
20295
20300
  }
20296
20301
  });
20297
20302
  var Tabs;
@@ -32497,8 +32502,9 @@ var init_LineChart = __esm({
32497
32502
  const safeData = data ?? [];
32498
32503
  const sortedData = useMemo(() => {
32499
32504
  if (safeData.length === 0) return [];
32505
+ if (!safeData.some((d) => d.date != null)) return [...safeData];
32500
32506
  return [...safeData].sort(
32501
- (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()
32507
+ (a, b) => new Date(a.date ?? 0).getTime() - new Date(b.date ?? 0).getTime()
32502
32508
  );
32503
32509
  }, [safeData]);
32504
32510
  const points = useMemo(() => {
@@ -43,7 +43,7 @@ export interface AtlasPanelProps {
43
43
  * is cropped once to a dataURL; CSS border-image / background-repeat does the scaling. Falls back
44
44
  * to a plain container while the sheet/atlas load.
45
45
  */
46
- export declare function AtlasPanel({ asset, borderSlice, borderWidth, mode, className, style, children, 'aria-hidden': ariaHidden }: AtlasPanelProps): import("react/jsx-runtime").JSX.Element;
46
+ export declare function AtlasPanel({ asset, borderSlice, borderWidth, mode, className, style, children, 'aria-hidden': ariaHidden }: AtlasPanelProps): React.JSX.Element;
47
47
  export declare namespace AtlasPanel {
48
48
  var displayName: string;
49
49
  }
@@ -52,7 +52,7 @@ export declare namespace AtlasPanel {
52
52
  * sub-rect of the packed sheet into a canvas (never the whole sheet); otherwise it renders the
53
53
  * plain `<img>` path. `fill` + `fit` cover background/panel usage (GameShell, card frames).
54
54
  */
55
- export declare function AtlasImage({ asset, size, width, height, fill, fit, alt, className, style, 'aria-hidden': ariaHidden, }: AtlasImageProps): import("react/jsx-runtime").JSX.Element | null;
55
+ export declare function AtlasImage({ asset, size, width, height, fill, fit, alt, className, style, 'aria-hidden': ariaHidden, }: AtlasImageProps): React.JSX.Element | null;
56
56
  export declare namespace AtlasImage {
57
57
  var displayName: string;
58
58
  }
@@ -16,6 +16,6 @@ export interface FlipContainerProps {
16
16
  onClick?: () => void;
17
17
  }
18
18
  export declare const FlipContainer: {
19
- ({ flipped, className, children, onClick, }: FlipContainerProps): import("react/jsx-runtime").JSX.Element;
19
+ ({ flipped, className, children, onClick, }: FlipContainerProps): React.JSX.Element;
20
20
  displayName: string;
21
21
  };
@@ -51,7 +51,7 @@ export interface CardProps {
51
51
  /**
52
52
  * Card component for displaying content in a contained box
53
53
  */
54
- export declare function Card({ title, subtitle, image, actions, children, onClick, className, action, longPressEvent, longPressPayload, }: CardProps): import("react/jsx-runtime").JSX.Element;
54
+ export declare function Card({ title, subtitle, image, actions, children, onClick, className, action, longPressEvent, longPressPayload, }: CardProps): React.JSX.Element;
55
55
  export declare namespace Card {
56
56
  var displayName: string;
57
57
  }
@@ -35,7 +35,7 @@ export type ChartType = "bar" | "line" | "pie" | "area" | "donut" | "scatter" |
35
35
  */
36
36
  export type ChartLook = "bar-vertical" | "bar-horizontal" | "line" | "area" | "pie" | "donut" | "scatter" | "histogram";
37
37
  export type ChartStackMode = "none" | "stack" | "normalize";
38
- export interface ChartDataPoint {
38
+ export interface ChartSeriesPoint {
39
39
  label: string;
40
40
  value: number;
41
41
  color?: string;
@@ -49,7 +49,7 @@ export interface ChartScatterPoint {
49
49
  }
50
50
  export interface ChartSeries {
51
51
  name: string;
52
- data: readonly ChartDataPoint[];
52
+ data: readonly ChartSeriesPoint[];
53
53
  color?: string;
54
54
  dashed?: boolean;
55
55
  }
@@ -79,7 +79,7 @@ export interface ChartProps {
79
79
  /** Multi-series data */
80
80
  series?: readonly ChartSeries[];
81
81
  /** Simple single-series shorthand (bar/line/pie/area/donut/histogram) */
82
- data?: readonly ChartDataPoint[];
82
+ data?: readonly ChartSeriesPoint[];
83
83
  /** Raw {x,y} points for scatter */
84
84
  scatterData?: readonly ChartScatterPoint[];
85
85
  /** Chart height in px */
@@ -111,7 +111,7 @@ export interface DataGridProps extends DataDndProps {
111
111
  */
112
112
  look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
113
113
  }
114
- export declare function DataGrid({ entity, fields, columns, itemActions, 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, }: DataGridProps): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
114
+ export declare function DataGrid({ entity, fields, columns, itemActions, 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, }: DataGridProps): string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
115
115
  export declare namespace DataGrid {
116
116
  var displayName: string;
117
117
  }
@@ -123,7 +123,7 @@ export interface DataListProps extends DataDndProps {
123
123
  */
124
124
  look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
125
125
  }
126
- export declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
126
+ export declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
127
127
  export declare namespace DataList {
128
128
  var displayName: string;
129
129
  }
@@ -1,3 +1,10 @@
1
+ /**
2
+ * DocPagination Molecule
3
+ *
4
+ * Previous/Next navigation links for documentation pages.
5
+ * Composed from HStack, Box, VStack, Icon, and Typography atoms.
6
+ */
7
+ import React from 'react';
1
8
  export interface DocPaginationLink {
2
9
  label: string;
3
10
  href: string;
@@ -11,4 +18,4 @@ export interface DocPaginationProps {
11
18
  /** Additional class names */
12
19
  className?: string;
13
20
  }
14
- export declare function DocPagination({ prev, next, className }: DocPaginationProps): import("react/jsx-runtime").JSX.Element | null;
21
+ export declare function DocPagination({ prev, next, className }: DocPaginationProps): React.JSX.Element | null;
@@ -1,3 +1,10 @@
1
+ /**
2
+ * DocSearch — documentation search input with inline results dropdown (distinct from SearchInput).
3
+ * SearchInput emits bus events for entity-list filtering with debounce.
4
+ * DocSearch drives a callback-based result list with keyboard navigation and
5
+ * popover dropdown; designed for docs site navigation, not data-list filtering.
6
+ */
7
+ import React from 'react';
1
8
  export interface DocSearchResult {
2
9
  title: string;
3
10
  href: string;
@@ -12,4 +19,4 @@ export interface DocSearchProps {
12
19
  /** Additional class names */
13
20
  className?: string;
14
21
  }
15
- export declare function DocSearch({ placeholder, onSearch, className, }: DocSearchProps): import("react/jsx-runtime").JSX.Element;
22
+ export declare function DocSearch({ placeholder, onSearch, className, }: DocSearchProps): React.JSX.Element;
@@ -19,6 +19,6 @@ export interface FlipCardProps {
19
19
  height?: string;
20
20
  }
21
21
  export declare const FlipCard: {
22
- ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): import("react/jsx-runtime").JSX.Element;
22
+ ({ front, back, flipped, onFlip, className, height, }: FlipCardProps): React.JSX.Element;
23
23
  displayName: string;
24
24
  };
@@ -6,7 +6,9 @@
6
6
  */
7
7
  import React from 'react';
8
8
  export interface ChartDataPoint {
9
- date: string | Date;
9
+ /** Optional: chronological x-axis. Absent for a categorical line chart
10
+ * (label-as-x), which plots points in author order. */
11
+ date?: string | Date;
10
12
  value: number;
11
13
  label?: string;
12
14
  }
@@ -1,3 +1,20 @@
1
+ /**
2
+ * MapView Molecule Component
3
+ *
4
+ * Interactive map using react-leaflet with OpenStreetMap tiles.
5
+ * Supports both programmatic callbacks (onMapClick) and schema-driven
6
+ * event dispatch (mapClickEvent) via the event bus.
7
+ *
8
+ * Why this file looks weird: Leaflet's core/Util.js evaluates
9
+ * `window.requestAnimationFrame` at module load time, which crashes any
10
+ * SSR/SSG environment (Docusaurus, Next.js RSC, etc.) the moment a
11
+ * consumer statically imports something that transitively reaches MapView.
12
+ * To stay SSR-safe, the actual leaflet bindings are loaded lazily inside
13
+ * a `React.lazy(async () => …)` callback so the leaflet module is only
14
+ * evaluated when the component is rendered for the first time, which
15
+ * never happens on the server because Suspense shows the fallback there.
16
+ */
17
+ import React from 'react';
1
18
  import type { EventEmit } from '@almadar/core';
2
19
  export type MapMarkerData = {
3
20
  /** Unique marker identifier */
@@ -67,4 +84,4 @@ export interface MapViewProps {
67
84
  * lazy implementation finishes loading on the client) so SSR never reaches
68
85
  * the leaflet code.
69
86
  */
70
- export declare function MapView(props: MapViewProps): import("react/jsx-runtime").JSX.Element;
87
+ export declare function MapView(props: MapViewProps): React.JSX.Element;
@@ -14,6 +14,6 @@ export interface SortableListProps {
14
14
  dragHandlePosition?: 'left' | 'right';
15
15
  className?: string;
16
16
  }
17
- declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, }: SortableListProps): import("react/jsx-runtime").JSX.Element;
17
+ declare function SortableListInner({ items: initialItemsProp, renderItem, reorderEvent, reorderPayload, dragHandlePosition, className, }: SortableListProps): React.JSX.Element;
18
18
  export declare const SortableList: typeof SortableListInner;
19
19
  export {};
@@ -105,7 +105,7 @@ export interface TableViewProps extends DataDndProps {
105
105
  */
106
106
  look?: 'dense' | 'spacious' | 'striped' | 'borderless' | 'bordered';
107
107
  }
108
- export declare function TableView({ entity, columns, fields, itemActions, maxInlineActions, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, isLoading, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, }: TableViewProps): import("react/jsx-runtime").JSX.Element;
108
+ export declare function TableView({ entity, columns, fields, itemActions, maxInlineActions, selectable, selectEvent, selectedIds, sortEvent, sortColumn, sortDirection, className, emptyMessage, isLoading, error, groupBy, pageSize, children, renderItem: _schemaRenderItem, look, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, }: TableViewProps): React.JSX.Element;
109
109
  export declare namespace TableView {
110
110
  var displayName: string;
111
111
  }
@@ -5,8 +5,12 @@ import { DisplayStateProps } from "./types";
5
5
  import type { EntityRow, FieldValue } from "@almadar/core";
6
6
  export type EntityTableLook = "dense" | "spacious" | "striped" | "borderless" | "card-rows";
7
7
  export interface Column<T> {
8
- key: keyof T | string;
9
- header: string;
8
+ /** Column identity. Optional because `name` is an accepted alias; the
9
+ * compiler emits `{ name, label }` columns and `normalizeColumns` fills
10
+ * `key`/`header` from the aliases, so a column needs (`key` OR `name`) and
11
+ * (`header` OR `label`), not literally `key`+`header`. */
12
+ key?: keyof T | string;
13
+ header?: string;
10
14
  /** Alias for key (used by compiler-generated fields) */
11
15
  name?: string;
12
16
  /** Alias for header (used by compiler-generated fields) */
@@ -69,7 +73,7 @@ export interface DataTableProps<T extends EntityRow & {
69
73
  }
70
74
  export declare function DataTable<T extends EntityRow & {
71
75
  id: string | number;
72
- }>({ fields, columns, entity, itemActions, isLoading, error, emptyIcon, emptyTitle, emptyDescription, emptyAction, selectable, selectedIds, sortBy, sortDirection, searchable, searchValue, searchPlaceholder, page, pageSize, totalCount, rowActions: externalRowActions, bulkActions, headerActions, showTotal, className, look, }: DataTableProps<T>): import("react/jsx-runtime").JSX.Element;
76
+ }>({ fields, columns, entity, itemActions, isLoading, error, emptyIcon, emptyTitle, emptyDescription, emptyAction, selectable, selectedIds, sortBy, sortDirection, searchable, searchValue, searchPlaceholder, page, pageSize, totalCount, rowActions: externalRowActions, bulkActions, headerActions, showTotal, className, look, }: DataTableProps<T>): React.JSX.Element;
73
77
  export declare namespace DataTable {
74
78
  var displayName: string;
75
79
  }
@@ -1,3 +1,12 @@
1
+ /**
2
+ * RuntimeDebugger - Main debug panel for KFlow applications
3
+ *
4
+ * Press backtick (`) to toggle. Displays traits, ticks, entities, events,
5
+ * guards, verification checks, transition timeline, and server bridge health.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ import * as React from 'react';
1
10
  import type { OrbitalSchema } from '@almadar/core';
2
11
  import './RuntimeDebugger.css';
3
12
  export interface RuntimeDebuggerProps {
@@ -14,7 +23,7 @@ export interface RuntimeDebuggerProps {
14
23
  /** Raw schema for EventDispatcherTab payload extraction */
15
24
  schema?: OrbitalSchema;
16
25
  }
17
- export declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): import("react/jsx-runtime").JSX.Element | null;
26
+ export declare function RuntimeDebugger({ position, defaultCollapsed, className, mode, defaultTab, schema, }: RuntimeDebuggerProps): React.JSX.Element | null;
18
27
  export declare namespace RuntimeDebugger {
19
28
  var displayName: string;
20
29
  }
@@ -2,11 +2,12 @@
2
2
  * EntitiesTab - Displays entity snapshots
3
3
  * Uses existing component library atoms/molecules.
4
4
  */
5
+ import * as React from 'react';
5
6
  import type { EntitySnapshot } from '../../../../../lib/entityDebug';
6
7
  interface EntitiesTabProps {
7
8
  snapshot: EntitySnapshot | null;
8
9
  }
9
- export declare function EntitiesTab({ snapshot }: EntitiesTabProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare function EntitiesTab({ snapshot }: EntitiesTabProps): React.JSX.Element;
10
11
  export declare namespace EntitiesTab {
11
12
  var displayName: string;
12
13
  }
@@ -4,13 +4,14 @@
4
4
  * Shows available transitions per trait based on current state,
5
5
  * lets users click to fire events, and displays a compact transition log.
6
6
  */
7
+ import * as React from 'react';
7
8
  import type { OrbitalSchema } from '@almadar/core';
8
9
  import type { TraitDebugInfo } from '../../../../../lib/traitRegistry';
9
10
  interface EventDispatcherTabProps {
10
11
  traits: TraitDebugInfo[];
11
12
  schema?: OrbitalSchema;
12
13
  }
13
- export declare function EventDispatcherTab({ traits, schema }: EventDispatcherTabProps): import("react/jsx-runtime").JSX.Element;
14
+ export declare function EventDispatcherTab({ traits, schema }: EventDispatcherTabProps): React.JSX.Element;
14
15
  export declare namespace EventDispatcherTab {
15
16
  var displayName: string;
16
17
  }
@@ -1,8 +1,13 @@
1
+ /**
2
+ * EventFlowTab - Displays event flow and debug messages
3
+ * Uses existing component library atoms/molecules.
4
+ */
5
+ import * as React from 'react';
1
6
  import type { DebugEvent } from '../../../../../lib/debugRegistry';
2
7
  interface EventFlowTabProps {
3
8
  events: DebugEvent[];
4
9
  }
5
- export declare function EventFlowTab({ events }: EventFlowTabProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare function EventFlowTab({ events }: EventFlowTabProps): React.JSX.Element;
6
11
  export declare namespace EventFlowTab {
7
12
  var displayName: string;
8
13
  }
@@ -1,8 +1,13 @@
1
+ /**
2
+ * GuardsPanel - Displays guard evaluation history
3
+ * Uses existing component library atoms/molecules.
4
+ */
5
+ import * as React from 'react';
1
6
  import type { GuardEvaluation } from '../../../../../lib/guardRegistry';
2
7
  interface GuardsPanelProps {
3
8
  guards: GuardEvaluation[];
4
9
  }
5
- export declare function GuardsPanel({ guards }: GuardsPanelProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare function GuardsPanel({ guards }: GuardsPanelProps): React.JSX.Element;
6
11
  export declare namespace GuardsPanel {
7
12
  var displayName: string;
8
13
  }
@@ -1,8 +1,19 @@
1
+ /**
2
+ * ServerBridgeTab - Displays ServerBridge health and connectivity status
3
+ *
4
+ * Shows:
5
+ * - Connection status (connected/disconnected)
6
+ * - Events forwarded (client → server) count
7
+ * - Events received (server → client) count
8
+ * - Last error if any
9
+ * - Last heartbeat timestamp
10
+ */
11
+ import * as React from 'react';
1
12
  import type { BridgeHealth } from '../../../../../lib/verificationRegistry';
2
13
  interface ServerBridgeTabProps {
3
14
  bridge: BridgeHealth | null;
4
15
  }
5
- export declare function ServerBridgeTab({ bridge }: ServerBridgeTabProps): import("react/jsx-runtime").JSX.Element;
16
+ export declare function ServerBridgeTab({ bridge }: ServerBridgeTabProps): React.JSX.Element;
6
17
  export declare namespace ServerBridgeTab {
7
18
  var displayName: string;
8
19
  }
@@ -2,11 +2,12 @@
2
2
  * TicksTab - Displays tick execution timing and status
3
3
  * Uses existing component library atoms/molecules.
4
4
  */
5
+ import * as React from 'react';
5
6
  import type { TickExecution } from '../../../../../lib/tickRegistry';
6
7
  interface TicksTabProps {
7
8
  ticks: TickExecution[];
8
9
  }
9
- export declare function TicksTab({ ticks }: TicksTabProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare function TicksTab({ ticks }: TicksTabProps): React.JSX.Element;
10
11
  export declare namespace TicksTab {
11
12
  var displayName: string;
12
13
  }
@@ -2,11 +2,12 @@
2
2
  * TraitsTab - Displays active traits and their state machines
3
3
  * Uses existing component library atoms/molecules.
4
4
  */
5
+ import * as React from 'react';
5
6
  import type { TraitDebugInfo } from '../../../../../lib/traitRegistry';
6
7
  interface TraitsTabProps {
7
8
  traits: TraitDebugInfo[];
8
9
  }
9
- export declare function TraitsTab({ traits }: TraitsTabProps): import("react/jsx-runtime").JSX.Element;
10
+ export declare function TraitsTab({ traits }: TraitsTabProps): React.JSX.Element;
10
11
  export declare namespace TraitsTab {
11
12
  var displayName: string;
12
13
  }
@@ -1,8 +1,18 @@
1
+ /**
2
+ * TransitionTimeline - Visual timeline of state machine transitions
3
+ *
4
+ * Shows each transition with:
5
+ * - Trait name, from → to state, triggering event
6
+ * - Guard result (if any)
7
+ * - Effect execution results (green = executed, red = failed)
8
+ * - Timestamp
9
+ */
10
+ import * as React from 'react';
1
11
  import type { TransitionTrace } from '../../../../../lib/verificationRegistry';
2
12
  interface TransitionTimelineProps {
3
13
  transitions: TransitionTrace[];
4
14
  }
5
- export declare function TransitionTimeline({ transitions }: TransitionTimelineProps): import("react/jsx-runtime").JSX.Element;
15
+ export declare function TransitionTimeline({ transitions }: TransitionTimelineProps): React.JSX.Element;
6
16
  export declare namespace TransitionTimeline {
7
17
  var displayName: string;
8
18
  }
@@ -1,9 +1,16 @@
1
+ /**
2
+ * VerificationTab - Displays pass/fail verification checklist
3
+ *
4
+ * Shows all registered checks with their status, grouped by category.
5
+ * Green = pass, Red = fail, Yellow = warn, Gray = pending.
6
+ */
7
+ import * as React from 'react';
1
8
  import type { VerificationCheck, VerificationSummary } from '../../../../../lib/verificationRegistry';
2
9
  interface VerificationTabProps {
3
10
  checks: VerificationCheck[];
4
11
  summary: VerificationSummary;
5
12
  }
6
- export declare function VerificationTab({ checks, summary }: VerificationTabProps): import("react/jsx-runtime").JSX.Element;
13
+ export declare function VerificationTab({ checks, summary }: VerificationTabProps): React.JSX.Element;
7
14
  export declare namespace VerificationTab {
8
15
  var displayName: string;
9
16
  }
@@ -1,3 +1,4 @@
1
+ import * as React from 'react';
1
2
  import { type IconInput } from '../../../core/atoms/Icon';
2
3
  import type { Asset, EventKey } from '@almadar/core';
3
4
  export interface ActionButtonProps {
@@ -24,7 +25,7 @@ export interface ActionButtonProps {
24
25
  /** Additional CSS classes */
25
26
  className?: string;
26
27
  }
27
- export declare function ActionButton({ assetUrl, label, icon, cooldown, disabled, hotkey, size, variant, onClick, action, className, }: ActionButtonProps): import("react/jsx-runtime").JSX.Element;
28
+ export declare function ActionButton({ assetUrl, label, icon, cooldown, disabled, hotkey, size, variant, onClick, action, className, }: ActionButtonProps): React.JSX.Element;
28
29
  export declare namespace ActionButton {
29
30
  var displayName: string;
30
31
  }
@@ -1,3 +1,4 @@
1
+ import * as React from 'react';
1
2
  import { type IconInput } from '../../../core/atoms/Icon';
2
3
  import type { Asset, EventKey } from '@almadar/core';
3
4
  export interface ChoiceButtonProps {
@@ -22,7 +23,7 @@ export interface ChoiceButtonProps {
22
23
  /** Additional CSS classes */
23
24
  className?: string;
24
25
  }
25
- export declare function ChoiceButton({ text, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, }: ChoiceButtonProps): import("react/jsx-runtime").JSX.Element;
26
+ export declare function ChoiceButton({ text, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, }: ChoiceButtonProps): React.JSX.Element;
26
27
  export declare namespace ChoiceButton {
27
28
  var displayName: string;
28
29
  }