@almadar/patterns 2.19.2 → 2.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "1.0.0",
3
- "exportedAt": "2026-05-03T17:38:21.517Z",
3
+ "exportedAt": "2026-05-04T04:46:21.886Z",
4
4
  "patterns": {
5
5
  "entity-table": {
6
6
  "type": "entity-table",
@@ -312,7 +312,18 @@
312
312
  "types": [
313
313
  "function"
314
314
  ],
315
- "description": "renderItem prop"
315
+ "description": "renderItem prop",
316
+ "kind": "callback",
317
+ "callbackArgs": [
318
+ {
319
+ "name": "item",
320
+ "type": "object"
321
+ },
322
+ {
323
+ "name": "index",
324
+ "type": "number"
325
+ }
326
+ ]
316
327
  },
317
328
  "children": {
318
329
  "types": [
@@ -750,7 +761,9 @@
750
761
  "types": [
751
762
  "string"
752
763
  ],
753
- "description": "Event to emit when back is clicked (default: BACK)"
764
+ "description": "Event to emit when back is clicked (default: BACK)",
765
+ "kind": "event-ref",
766
+ "emitPayloadSchema": []
754
767
  },
755
768
  "breadcrumbs": {
756
769
  "types": [
@@ -804,7 +817,14 @@
804
817
  "types": [
805
818
  "function"
806
819
  ],
807
- "description": "onTabChange prop"
820
+ "description": "onTabChange prop",
821
+ "kind": "callback",
822
+ "callbackArgs": [
823
+ {
824
+ "name": "value",
825
+ "type": "string"
826
+ }
827
+ ]
808
828
  },
809
829
  "children": {
810
830
  "types": [
@@ -1004,7 +1024,14 @@
1004
1024
  "types": [
1005
1025
  "function"
1006
1026
  ],
1007
- "description": "Callback when any field value changes"
1027
+ "description": "Callback when any field value changes",
1028
+ "kind": "callback",
1029
+ "callbackArgs": [
1030
+ {
1031
+ "name": "change",
1032
+ "type": "object"
1033
+ }
1034
+ ]
1008
1035
  },
1009
1036
  "configPath": {
1010
1037
  "types": [
@@ -1204,7 +1231,14 @@
1204
1231
  "types": [
1205
1232
  "function"
1206
1233
  ],
1207
- "description": "Callback when any field value changes"
1234
+ "description": "Callback when any field value changes",
1235
+ "kind": "callback",
1236
+ "callbackArgs": [
1237
+ {
1238
+ "name": "change",
1239
+ "type": "object"
1240
+ }
1241
+ ]
1208
1242
  },
1209
1243
  "configPath": {
1210
1244
  "types": [
@@ -1240,7 +1274,14 @@
1240
1274
  "types": [
1241
1275
  "function"
1242
1276
  ],
1243
- "description": "Callback when search value changes"
1277
+ "description": "Callback when search value changes",
1278
+ "kind": "callback",
1279
+ "callbackArgs": [
1280
+ {
1281
+ "name": "value",
1282
+ "type": "string"
1283
+ }
1284
+ ]
1244
1285
  },
1245
1286
  "debounceMs": {
1246
1287
  "types": [
@@ -1319,13 +1360,26 @@
1319
1360
  "types": [
1320
1361
  "function"
1321
1362
  ],
1322
- "description": "Callback when a filter changes - for EntityStore integration"
1363
+ "description": "Callback when a filter changes - for EntityStore integration",
1364
+ "kind": "callback",
1365
+ "callbackArgs": [
1366
+ {
1367
+ "name": "field",
1368
+ "type": "string"
1369
+ },
1370
+ {
1371
+ "name": "value",
1372
+ "type": "string"
1373
+ }
1374
+ ]
1323
1375
  },
1324
1376
  "onClearAll": {
1325
1377
  "types": [
1326
1378
  "function"
1327
1379
  ],
1328
- "description": "Callback to clear all filters"
1380
+ "description": "Callback to clear all filters",
1381
+ "kind": "callback",
1382
+ "callbackArgs": []
1329
1383
  },
1330
1384
  "className": {
1331
1385
  "types": [
@@ -1403,7 +1457,28 @@
1403
1457
  "types": [
1404
1458
  "function"
1405
1459
  ],
1406
- "description": "Callback when tab changes"
1460
+ "description": "Callback when tab changes",
1461
+ "kind": "callback",
1462
+ "callbackArgs": [
1463
+ {
1464
+ "name": "tabId",
1465
+ "type": "string"
1466
+ }
1467
+ ]
1468
+ },
1469
+ "tabChangeEvent": {
1470
+ "types": [
1471
+ "string"
1472
+ ],
1473
+ "description": "Declarative tab change event — emits UI:{tabChangeEvent} with { tabId }",
1474
+ "kind": "event-ref",
1475
+ "emitPayloadSchema": [
1476
+ {
1477
+ "name": "tabId",
1478
+ "type": "string",
1479
+ "required": true
1480
+ }
1481
+ ]
1407
1482
  },
1408
1483
  "variant": {
1409
1484
  "types": [
@@ -1485,7 +1560,7 @@
1485
1560
  "types": [
1486
1561
  "array"
1487
1562
  ],
1488
- "description": "Step definitions (compatible with WizardContainer's WizardStep)",
1563
+ "description": "Step definitions (compatible with WizardContainer's WizardStep). A string is shorthand for `{ id: str, title: str }`.",
1489
1564
  "required": true
1490
1565
  },
1491
1566
  "currentStep": {
@@ -1499,7 +1574,14 @@
1499
1574
  "types": [
1500
1575
  "function"
1501
1576
  ],
1502
- "description": "Callback when a completed step is clicked"
1577
+ "description": "Callback when a completed step is clicked",
1578
+ "kind": "callback",
1579
+ "callbackArgs": [
1580
+ {
1581
+ "name": "stepIndex",
1582
+ "type": "number"
1583
+ }
1584
+ ]
1503
1585
  },
1504
1586
  "allowNavigation": {
1505
1587
  "types": [
@@ -1523,7 +1605,15 @@
1523
1605
  "types": [
1524
1606
  "string"
1525
1607
  ],
1526
- "description": "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }"
1608
+ "description": "Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }",
1609
+ "kind": "event-ref",
1610
+ "emitPayloadSchema": [
1611
+ {
1612
+ "name": "stepIndex",
1613
+ "type": "number",
1614
+ "required": true
1615
+ }
1616
+ ]
1527
1617
  }
1528
1618
  }
1529
1619
  },
@@ -1615,19 +1705,25 @@
1615
1705
  "types": [
1616
1706
  "function"
1617
1707
  ],
1618
- "description": "Direct callback for Back (alternative to event)"
1708
+ "description": "Direct callback for Back (alternative to event)",
1709
+ "kind": "callback",
1710
+ "callbackArgs": []
1619
1711
  },
1620
1712
  "onNextClick": {
1621
1713
  "types": [
1622
1714
  "function"
1623
1715
  ],
1624
- "description": "Direct callback for Next (alternative to event)"
1716
+ "description": "Direct callback for Next (alternative to event)",
1717
+ "kind": "callback",
1718
+ "callbackArgs": []
1625
1719
  },
1626
1720
  "onCompleteClick": {
1627
1721
  "types": [
1628
1722
  "function"
1629
1723
  ],
1630
- "description": "Direct callback for Complete (alternative to event)"
1724
+ "description": "Direct callback for Complete (alternative to event)",
1725
+ "kind": "callback",
1726
+ "callbackArgs": []
1631
1727
  },
1632
1728
  "compact": {
1633
1729
  "types": [
@@ -1673,13 +1769,22 @@
1673
1769
  "types": [
1674
1770
  "function"
1675
1771
  ],
1676
- "description": "Callback when step changes"
1772
+ "description": "Callback when step changes",
1773
+ "kind": "callback",
1774
+ "callbackArgs": [
1775
+ {
1776
+ "name": "stepIndex",
1777
+ "type": "number"
1778
+ }
1779
+ ]
1677
1780
  },
1678
1781
  "onComplete": {
1679
1782
  "types": [
1680
1783
  "function"
1681
1784
  ],
1682
- "description": "Callback when wizard is completed"
1785
+ "description": "Callback when wizard is completed",
1786
+ "kind": "callback",
1787
+ "callbackArgs": []
1683
1788
  },
1684
1789
  "showProgress": {
1685
1790
  "types": [
@@ -1753,7 +1858,14 @@
1753
1858
  "types": [
1754
1859
  "function"
1755
1860
  ],
1756
- "description": "Callback when page changes (optional - can be a no-op if not interactive)"
1861
+ "description": "Callback when page changes (optional - can be a no-op if not interactive)",
1862
+ "kind": "callback",
1863
+ "callbackArgs": [
1864
+ {
1865
+ "name": "page",
1866
+ "type": "number"
1867
+ }
1868
+ ]
1757
1869
  },
1758
1870
  "showPageSize": {
1759
1871
  "types": [
@@ -1777,7 +1889,14 @@
1777
1889
  "types": [
1778
1890
  "function"
1779
1891
  ],
1780
- "description": "Callback when page size changes"
1892
+ "description": "Callback when page size changes",
1893
+ "kind": "callback",
1894
+ "callbackArgs": [
1895
+ {
1896
+ "name": "size",
1897
+ "type": "number"
1898
+ }
1899
+ ]
1781
1900
  },
1782
1901
  "showJumpToPage": {
1783
1902
  "types": [
@@ -1813,13 +1932,29 @@
1813
1932
  "types": [
1814
1933
  "string"
1815
1934
  ],
1816
- "description": "Declarative page change event — emits UI:{pageChangeEvent} with { page }"
1935
+ "description": "Declarative page change event — emits UI:{pageChangeEvent} with { page }",
1936
+ "kind": "event-ref",
1937
+ "emitPayloadSchema": [
1938
+ {
1939
+ "name": "page",
1940
+ "type": "number",
1941
+ "required": true
1942
+ }
1943
+ ]
1817
1944
  },
1818
1945
  "pageSizeChangeEvent": {
1819
1946
  "types": [
1820
1947
  "string"
1821
1948
  ],
1822
- "description": "Declarative page size change event — emits UI:{pageSizeChangeEvent} with { pageSize }"
1949
+ "description": "Declarative page size change event — emits UI:{pageSizeChangeEvent} with { pageSize }",
1950
+ "kind": "event-ref",
1951
+ "emitPayloadSchema": [
1952
+ {
1953
+ "name": "pageSize",
1954
+ "type": "number",
1955
+ "required": true
1956
+ }
1957
+ ]
1823
1958
  }
1824
1959
  }
1825
1960
  },
@@ -1868,7 +2003,9 @@
1868
2003
  "types": [
1869
2004
  "function"
1870
2005
  ],
1871
- "description": "onAction prop"
2006
+ "description": "onAction prop",
2007
+ "kind": "callback",
2008
+ "callbackArgs": []
1872
2009
  },
1873
2010
  "className": {
1874
2011
  "types": [
@@ -1899,7 +2036,9 @@
1899
2036
  "types": [
1900
2037
  "string"
1901
2038
  ],
1902
- "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked"
2039
+ "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked",
2040
+ "kind": "event-ref",
2041
+ "emitPayloadSchema": []
1903
2042
  }
1904
2043
  }
1905
2044
  },
@@ -1964,7 +2103,9 @@
1964
2103
  "types": [
1965
2104
  "function"
1966
2105
  ],
1967
- "description": "onRetry prop"
2106
+ "description": "onRetry prop",
2107
+ "kind": "callback",
2108
+ "callbackArgs": []
1968
2109
  },
1969
2110
  "className": {
1970
2111
  "types": [
@@ -1976,7 +2117,9 @@
1976
2117
  "types": [
1977
2118
  "string"
1978
2119
  ],
1979
- "description": "Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked"
2120
+ "description": "Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked",
2121
+ "kind": "event-ref",
2122
+ "emitPayloadSchema": []
1980
2123
  }
1981
2124
  }
1982
2125
  },
@@ -2032,7 +2175,9 @@
2032
2175
  "types": [
2033
2176
  "function"
2034
2177
  ],
2035
- "description": "Callback when toast is dismissed"
2178
+ "description": "Callback when toast is dismissed",
2179
+ "kind": "callback",
2180
+ "callbackArgs": []
2036
2181
  },
2037
2182
  "actionLabel": {
2038
2183
  "types": [
@@ -2044,7 +2189,9 @@
2044
2189
  "types": [
2045
2190
  "function"
2046
2191
  ],
2047
- "description": "Action button click handler"
2192
+ "description": "Action button click handler",
2193
+ "kind": "callback",
2194
+ "callbackArgs": []
2048
2195
  },
2049
2196
  "badge": {
2050
2197
  "types": [
@@ -2063,13 +2210,17 @@
2063
2210
  "types": [
2064
2211
  "string"
2065
2212
  ],
2066
- "description": "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when toast is dismissed"
2213
+ "description": "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when toast is dismissed",
2214
+ "kind": "event-ref",
2215
+ "emitPayloadSchema": []
2067
2216
  },
2068
2217
  "actionEvent": {
2069
2218
  "types": [
2070
2219
  "string"
2071
2220
  ],
2072
- "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked"
2221
+ "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked",
2222
+ "kind": "event-ref",
2223
+ "emitPayloadSchema": []
2073
2224
  }
2074
2225
  }
2075
2226
  },
@@ -2252,7 +2403,9 @@
2252
2403
  "types": [
2253
2404
  "function"
2254
2405
  ],
2255
- "description": "Callback when modal should close (injected by slot wrapper)"
2406
+ "description": "Callback when modal should close (injected by slot wrapper)",
2407
+ "kind": "callback",
2408
+ "callbackArgs": []
2256
2409
  },
2257
2410
  "title": {
2258
2411
  "types": [
@@ -2313,7 +2466,9 @@
2313
2466
  "types": [
2314
2467
  "string"
2315
2468
  ],
2316
- "description": "Declarative close event — emits UI:{closeEvent} via eventBus when modal should close"
2469
+ "description": "Declarative close event — emits UI:{closeEvent} via eventBus when modal should close",
2470
+ "kind": "event-ref",
2471
+ "emitPayloadSchema": []
2317
2472
  },
2318
2473
  "swipeDownToClose": {
2319
2474
  "types": [
@@ -2344,7 +2499,9 @@
2344
2499
  "types": [
2345
2500
  "function"
2346
2501
  ],
2347
- "description": "Callback when drawer should close (injected by slot wrapper)"
2502
+ "description": "Callback when drawer should close (injected by slot wrapper)",
2503
+ "kind": "callback",
2504
+ "callbackArgs": []
2348
2505
  },
2349
2506
  "title": {
2350
2507
  "types": [
@@ -2433,13 +2590,17 @@
2433
2590
  "types": [
2434
2591
  "function"
2435
2592
  ],
2436
- "description": "Callback when dialog is closed (injected by slot wrapper)"
2593
+ "description": "Callback when dialog is closed (injected by slot wrapper)",
2594
+ "kind": "callback",
2595
+ "callbackArgs": []
2437
2596
  },
2438
2597
  "onConfirm": {
2439
2598
  "types": [
2440
2599
  "function"
2441
2600
  ],
2442
- "description": "Callback when action is confirmed (injected by slot wrapper)"
2601
+ "description": "Callback when action is confirmed (injected by slot wrapper)",
2602
+ "kind": "callback",
2603
+ "callbackArgs": []
2443
2604
  },
2444
2605
  "title": {
2445
2606
  "types": [
@@ -3243,7 +3404,14 @@
3243
3404
  "types": [
3244
3405
  "function"
3245
3406
  ],
3246
- "description": "Called when an option is selected (legacy callback, prefer event bus)"
3407
+ "description": "Called when an option is selected (legacy callback, prefer event bus)",
3408
+ "kind": "callback",
3409
+ "callbackArgs": [
3410
+ {
3411
+ "name": "option",
3412
+ "type": "object"
3413
+ }
3414
+ ]
3247
3415
  },
3248
3416
  "eventBus": {
3249
3417
  "types": [
@@ -3317,7 +3485,14 @@
3317
3485
  "types": [
3318
3486
  "function"
3319
3487
  ],
3320
- "description": "Called when an action is selected (legacy callback, prefer event bus)"
3488
+ "description": "Called when an action is selected (legacy callback, prefer event bus)",
3489
+ "kind": "callback",
3490
+ "callbackArgs": [
3491
+ {
3492
+ "name": "action",
3493
+ "type": "object"
3494
+ }
3495
+ ]
3321
3496
  },
3322
3497
  "eventBus": {
3323
3498
  "types": [
@@ -3400,37 +3575,82 @@
3400
3575
  "types": [
3401
3576
  "function"
3402
3577
  ],
3403
- "description": "Called when a slot is selected"
3578
+ "description": "Called when a slot is selected",
3579
+ "kind": "callback",
3580
+ "callbackArgs": [
3581
+ {
3582
+ "name": "index",
3583
+ "type": "number"
3584
+ }
3585
+ ]
3404
3586
  },
3405
3587
  "onUseItem": {
3406
3588
  "types": [
3407
3589
  "function"
3408
3590
  ],
3409
- "description": "Called when an item is used (double-click or Enter)"
3591
+ "description": "Called when an item is used (double-click or Enter)",
3592
+ "kind": "callback",
3593
+ "callbackArgs": [
3594
+ {
3595
+ "name": "item",
3596
+ "type": "object"
3597
+ }
3598
+ ]
3410
3599
  },
3411
3600
  "onDropItem": {
3412
3601
  "types": [
3413
3602
  "function"
3414
3603
  ],
3415
- "description": "Called when an item is dropped"
3604
+ "description": "Called when an item is dropped",
3605
+ "kind": "callback",
3606
+ "callbackArgs": [
3607
+ {
3608
+ "name": "item",
3609
+ "type": "object"
3610
+ }
3611
+ ]
3416
3612
  },
3417
3613
  "selectSlotEvent": {
3418
3614
  "types": [
3419
3615
  "string"
3420
3616
  ],
3421
- "description": "Declarative event: emits UI:{selectSlotEvent} with { index } when a slot is selected"
3617
+ "description": "Declarative event: emits UI:{selectSlotEvent} with { index } when a slot is selected",
3618
+ "kind": "event-ref",
3619
+ "emitPayloadSchema": [
3620
+ {
3621
+ "name": "index",
3622
+ "type": "number",
3623
+ "required": true
3624
+ }
3625
+ ]
3422
3626
  },
3423
3627
  "useItemEvent": {
3424
3628
  "types": [
3425
3629
  "string"
3426
3630
  ],
3427
- "description": "Declarative event: emits UI:{useItemEvent} with { item } when an item is used"
3631
+ "description": "Declarative event: emits UI:{useItemEvent} with { item: InventoryItem } when an item is used",
3632
+ "kind": "event-ref",
3633
+ "emitPayloadSchema": [
3634
+ {
3635
+ "name": "item",
3636
+ "type": "object",
3637
+ "required": true
3638
+ }
3639
+ ]
3428
3640
  },
3429
3641
  "dropItemEvent": {
3430
3642
  "types": [
3431
3643
  "string"
3432
3644
  ],
3433
- "description": "Declarative event: emits UI:{dropItemEvent} with { item } when an item is dropped"
3645
+ "description": "Declarative event: emits UI:{dropItemEvent} with { item: InventoryItem } when an item is dropped",
3646
+ "kind": "event-ref",
3647
+ "emitPayloadSchema": [
3648
+ {
3649
+ "name": "item",
3650
+ "type": "object",
3651
+ "required": true
3652
+ }
3653
+ ]
3434
3654
  },
3435
3655
  "showTooltips": {
3436
3656
  "types": [
@@ -3490,37 +3710,60 @@
3490
3710
  "types": [
3491
3711
  "function"
3492
3712
  ],
3493
- "description": "Called when text animation completes"
3713
+ "description": "Called when text animation completes",
3714
+ "kind": "callback",
3715
+ "callbackArgs": []
3494
3716
  },
3495
3717
  "onChoice": {
3496
3718
  "types": [
3497
3719
  "function"
3498
3720
  ],
3499
- "description": "Called when a choice is selected"
3721
+ "description": "Called when a choice is selected",
3722
+ "kind": "callback",
3723
+ "callbackArgs": [
3724
+ {
3725
+ "name": "choice",
3726
+ "type": "object"
3727
+ }
3728
+ ]
3500
3729
  },
3501
3730
  "onAdvance": {
3502
3731
  "types": [
3503
3732
  "function"
3504
3733
  ],
3505
- "description": "Called when dialogue is advanced (no choices)"
3734
+ "description": "Called when dialogue is advanced (no choices)",
3735
+ "kind": "callback",
3736
+ "callbackArgs": []
3506
3737
  },
3507
3738
  "completeEvent": {
3508
3739
  "types": [
3509
3740
  "string"
3510
3741
  ],
3511
- "description": "Declarative event: emits UI:{completeEvent} when text animation completes"
3742
+ "description": "Declarative event: emits UI:{completeEvent} when text animation completes",
3743
+ "kind": "event-ref",
3744
+ "emitPayloadSchema": []
3512
3745
  },
3513
3746
  "choiceEvent": {
3514
3747
  "types": [
3515
3748
  "string"
3516
3749
  ],
3517
- "description": "Declarative event: emits UI:{choiceEvent} with { choice } when a choice is selected"
3750
+ "description": "Declarative event: emits UI:{choiceEvent} with { choice: DialogueChoice } when a choice is selected",
3751
+ "kind": "event-ref",
3752
+ "emitPayloadSchema": [
3753
+ {
3754
+ "name": "choice",
3755
+ "type": "object",
3756
+ "required": true
3757
+ }
3758
+ ]
3518
3759
  },
3519
3760
  "advanceEvent": {
3520
3761
  "types": [
3521
3762
  "string"
3522
3763
  ],
3523
- "description": "Declarative event: emits UI:{advanceEvent} when dialogue is advanced"
3764
+ "description": "Declarative event: emits UI:{advanceEvent} when dialogue is advanced",
3765
+ "kind": "event-ref",
3766
+ "emitPayloadSchema": []
3524
3767
  },
3525
3768
  "className": {
3526
3769
  "types": [
@@ -3828,7 +4071,9 @@
3828
4071
  "types": [
3829
4072
  "function"
3830
4073
  ],
3831
- "description": "Click handler"
4074
+ "description": "Click handler",
4075
+ "kind": "callback",
4076
+ "callbackArgs": []
3832
4077
  },
3833
4078
  "action": {
3834
4079
  "types": [
@@ -4205,7 +4450,9 @@
4205
4450
  "types": [
4206
4451
  "function"
4207
4452
  ],
4208
- "description": "Callback when clear button is clicked"
4453
+ "description": "Callback when clear button is clicked",
4454
+ "kind": "callback",
4455
+ "callbackArgs": []
4209
4456
  },
4210
4457
  "options": {
4211
4458
  "types": [
@@ -4428,7 +4675,14 @@
4428
4675
  "types": [
4429
4676
  "function"
4430
4677
  ],
4431
- "description": "onChange prop"
4678
+ "description": "onChange prop",
4679
+ "kind": "callback",
4680
+ "callbackArgs": [
4681
+ {
4682
+ "name": "checked",
4683
+ "type": "boolean"
4684
+ }
4685
+ ]
4432
4686
  },
4433
4687
  "disabled": {
4434
4688
  "types": [
@@ -4544,13 +4798,17 @@
4544
4798
  "types": [
4545
4799
  "function"
4546
4800
  ],
4547
- "description": "onDismiss prop"
4801
+ "description": "onDismiss prop",
4802
+ "kind": "callback",
4803
+ "callbackArgs": []
4548
4804
  },
4549
4805
  "onClose": {
4550
4806
  "types": [
4551
4807
  "function"
4552
4808
  ],
4553
- "description": "onClose prop"
4809
+ "description": "onClose prop",
4810
+ "kind": "callback",
4811
+ "callbackArgs": []
4554
4812
  },
4555
4813
  "actions": {
4556
4814
  "types": [
@@ -4792,7 +5050,18 @@
4792
5050
  "types": [
4793
5051
  "function"
4794
5052
  ],
4795
- "description": "Callback when item opens/closes"
5053
+ "description": "Callback when item opens/closes",
5054
+ "kind": "callback",
5055
+ "callbackArgs": [
5056
+ {
5057
+ "name": "itemId",
5058
+ "type": "string"
5059
+ },
5060
+ {
5061
+ "name": "isOpen",
5062
+ "type": "boolean"
5063
+ }
5064
+ ]
4796
5065
  },
4797
5066
  "className": {
4798
5067
  "types": [
@@ -4804,7 +5073,20 @@
4804
5073
  "types": [
4805
5074
  "string"
4806
5075
  ],
4807
- "description": "Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen }"
5076
+ "description": "Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen }",
5077
+ "kind": "event-ref",
5078
+ "emitPayloadSchema": [
5079
+ {
5080
+ "name": "itemId",
5081
+ "type": "string",
5082
+ "required": true
5083
+ },
5084
+ {
5085
+ "name": "isOpen",
5086
+ "type": "boolean",
5087
+ "required": true
5088
+ }
5089
+ ]
4808
5090
  }
4809
5091
  }
4810
5092
  },
@@ -4983,7 +5265,18 @@
4983
5265
  "function"
4984
5266
  ],
4985
5267
  "description": "Render function for each item",
4986
- "required": true
5268
+ "required": true,
5269
+ "kind": "callback",
5270
+ "callbackArgs": [
5271
+ {
5272
+ "name": "item",
5273
+ "type": "object"
5274
+ },
5275
+ {
5276
+ "name": "index",
5277
+ "type": "number"
5278
+ }
5279
+ ]
4987
5280
  },
4988
5281
  "minItems": {
4989
5282
  "types": [
@@ -5031,19 +5324,43 @@
5031
5324
  "types": [
5032
5325
  "function"
5033
5326
  ],
5034
- "description": "Add handler"
5327
+ "description": "Add handler",
5328
+ "kind": "callback",
5329
+ "callbackArgs": []
5035
5330
  },
5036
5331
  "onRemove": {
5037
5332
  "types": [
5038
5333
  "function"
5039
5334
  ],
5040
- "description": "Remove handler"
5335
+ "description": "Remove handler",
5336
+ "kind": "callback",
5337
+ "callbackArgs": [
5338
+ {
5339
+ "name": "itemId",
5340
+ "type": "string"
5341
+ },
5342
+ {
5343
+ "name": "index",
5344
+ "type": "number"
5345
+ }
5346
+ ]
5041
5347
  },
5042
5348
  "onReorder": {
5043
5349
  "types": [
5044
5350
  "function"
5045
5351
  ],
5046
- "description": "Reorder handler"
5352
+ "description": "Reorder handler",
5353
+ "kind": "callback",
5354
+ "callbackArgs": [
5355
+ {
5356
+ "name": "fromIndex",
5357
+ "type": "number"
5358
+ },
5359
+ {
5360
+ "name": "toIndex",
5361
+ "type": "number"
5362
+ }
5363
+ ]
5047
5364
  },
5048
5365
  "trackAddedInState": {
5049
5366
  "types": [
@@ -5175,7 +5492,14 @@
5175
5492
  "types": [
5176
5493
  "function"
5177
5494
  ],
5178
- "description": "onClick prop"
5495
+ "description": "onClick prop",
5496
+ "kind": "callback",
5497
+ "callbackArgs": [
5498
+ {
5499
+ "name": "e",
5500
+ "type": "object"
5501
+ }
5502
+ ]
5179
5503
  },
5180
5504
  "className": {
5181
5505
  "types": [
@@ -5305,13 +5629,27 @@
5305
5629
  "types": [
5306
5630
  "function"
5307
5631
  ],
5308
- "description": "Click handler"
5632
+ "description": "Click handler",
5633
+ "kind": "callback",
5634
+ "callbackArgs": [
5635
+ {
5636
+ "name": "e",
5637
+ "type": "object"
5638
+ }
5639
+ ]
5309
5640
  },
5310
5641
  "onKeyDown": {
5311
5642
  "types": [
5312
5643
  "function"
5313
5644
  ],
5314
- "description": "Keyboard handler"
5645
+ "description": "Keyboard handler",
5646
+ "kind": "callback",
5647
+ "callbackArgs": [
5648
+ {
5649
+ "name": "e",
5650
+ "type": "object"
5651
+ }
5652
+ ]
5315
5653
  },
5316
5654
  "role": {
5317
5655
  "types": [
@@ -5378,19 +5716,25 @@
5378
5716
  "types": [
5379
5717
  "function"
5380
5718
  ],
5381
- "description": "Callback when highlight is clicked"
5719
+ "description": "Callback when highlight is clicked",
5720
+ "kind": "callback",
5721
+ "callbackArgs": []
5382
5722
  },
5383
5723
  "onMouseEnter": {
5384
5724
  "types": [
5385
5725
  "function"
5386
5726
  ],
5387
- "description": "Callback when highlight is hovered"
5727
+ "description": "Callback when highlight is hovered",
5728
+ "kind": "callback",
5729
+ "callbackArgs": []
5388
5730
  },
5389
5731
  "onMouseLeave": {
5390
5732
  "types": [
5391
5733
  "function"
5392
5734
  ],
5393
- "description": "Callback when hover ends"
5735
+ "description": "Callback when hover ends",
5736
+ "kind": "callback",
5737
+ "callbackArgs": []
5394
5738
  },
5395
5739
  "annotationId": {
5396
5740
  "types": [
@@ -5658,13 +6002,17 @@
5658
6002
  "types": [
5659
6003
  "function"
5660
6004
  ],
5661
- "description": "Called when button is pressed"
6005
+ "description": "Called when button is pressed",
6006
+ "kind": "callback",
6007
+ "callbackArgs": []
5662
6008
  },
5663
6009
  "onRelease": {
5664
6010
  "types": [
5665
6011
  "function"
5666
6012
  ],
5667
- "description": "Called when button is released"
6013
+ "description": "Called when button is released",
6014
+ "kind": "callback",
6015
+ "callbackArgs": []
5668
6016
  },
5669
6017
  "pressEvent": {
5670
6018
  "types": [
@@ -5926,7 +6274,9 @@
5926
6274
  "types": [
5927
6275
  "function"
5928
6276
  ],
5929
- "description": "Optional onClick handler"
6277
+ "description": "Optional onClick handler",
6278
+ "kind": "callback",
6279
+ "callbackArgs": []
5930
6280
  },
5931
6281
  "action": {
5932
6282
  "types": [
@@ -6170,7 +6520,9 @@
6170
6520
  "types": [
6171
6521
  "function"
6172
6522
  ],
6173
- "description": "Optional direct click handler. Runs after the action emit when both are present."
6523
+ "description": "Optional direct click handler. Runs after the action emit when both are present.",
6524
+ "kind": "callback",
6525
+ "callbackArgs": []
6174
6526
  },
6175
6527
  "variant": {
6176
6528
  "types": [
@@ -6291,7 +6643,9 @@
6291
6643
  "types": [
6292
6644
  "function"
6293
6645
  ],
6294
- "description": "Toggle collapse handler (makes header clickable)"
6646
+ "description": "Toggle collapse handler (makes header clickable)",
6647
+ "kind": "callback",
6648
+ "callbackArgs": []
6295
6649
  },
6296
6650
  "badge": {
6297
6651
  "types": [
@@ -6392,7 +6746,14 @@
6392
6746
  "types": [
6393
6747
  "function"
6394
6748
  ],
6395
- "description": "Callback when value changes"
6749
+ "description": "Callback when value changes",
6750
+ "kind": "callback",
6751
+ "callbackArgs": [
6752
+ {
6753
+ "name": "value",
6754
+ "type": "string"
6755
+ }
6756
+ ]
6396
6757
  },
6397
6758
  "options": {
6398
6759
  "types": [
@@ -6500,7 +6861,9 @@
6500
6861
  "function"
6501
6862
  ],
6502
6863
  "description": "On close handler",
6503
- "required": true
6864
+ "required": true,
6865
+ "kind": "callback",
6866
+ "callbackArgs": []
6504
6867
  },
6505
6868
  "width": {
6506
6869
  "types": [
@@ -6534,7 +6897,9 @@
6534
6897
  "types": [
6535
6898
  "string"
6536
6899
  ],
6537
- "description": "Declarative close event — emits UI:{closeEvent} via eventBus when panel should close"
6900
+ "description": "Declarative close event — emits UI:{closeEvent} via eventBus when panel should close",
6901
+ "kind": "event-ref",
6902
+ "emitPayloadSchema": []
6538
6903
  }
6539
6904
  }
6540
6905
  },
@@ -6576,13 +6941,22 @@
6576
6941
  "types": [
6577
6942
  "function"
6578
6943
  ],
6579
- "description": "Dismiss handler"
6944
+ "description": "Dismiss handler",
6945
+ "kind": "callback",
6946
+ "callbackArgs": []
6580
6947
  },
6581
6948
  "onNavigateToField": {
6582
6949
  "types": [
6583
6950
  "function"
6584
6951
  ],
6585
- "description": "Navigate to the field that caused violation"
6952
+ "description": "Navigate to the field that caused violation",
6953
+ "kind": "callback",
6954
+ "callbackArgs": [
6955
+ {
6956
+ "name": "fieldId",
6957
+ "type": "string"
6958
+ }
6959
+ ]
6586
6960
  },
6587
6961
  "compact": {
6588
6962
  "types": [
@@ -6620,13 +6994,37 @@
6620
6994
  "types": [
6621
6995
  "function"
6622
6996
  ],
6623
- "description": "Called when a button is pressed/released"
6997
+ "description": "Called when a button is pressed/released",
6998
+ "kind": "callback",
6999
+ "callbackArgs": [
7000
+ {
7001
+ "name": "id",
7002
+ "type": "string"
7003
+ },
7004
+ {
7005
+ "name": "pressed",
7006
+ "type": "boolean"
7007
+ }
7008
+ ]
6624
7009
  },
6625
7010
  "actionEvent": {
6626
7011
  "types": [
6627
7012
  "string"
6628
7013
  ],
6629
- "description": "Declarative event name emitted on action via useEventBus"
7014
+ "description": "Declarative event name emitted on action via useEventBus",
7015
+ "kind": "event-ref",
7016
+ "emitPayloadSchema": [
7017
+ {
7018
+ "name": "id",
7019
+ "type": "string",
7020
+ "required": true
7021
+ },
7022
+ {
7023
+ "name": "pressed",
7024
+ "type": "boolean",
7025
+ "required": true
7026
+ }
7027
+ ]
6630
7028
  },
6631
7029
  "layout": {
6632
7030
  "types": [
@@ -6678,13 +7076,37 @@
6678
7076
  "types": [
6679
7077
  "function"
6680
7078
  ],
6681
- "description": "Called when a direction is pressed/released"
7079
+ "description": "Called when a direction is pressed/released",
7080
+ "kind": "callback",
7081
+ "callbackArgs": [
7082
+ {
7083
+ "name": "direction",
7084
+ "type": "string"
7085
+ },
7086
+ {
7087
+ "name": "pressed",
7088
+ "type": "boolean"
7089
+ }
7090
+ ]
6682
7091
  },
6683
7092
  "directionEvent": {
6684
7093
  "types": [
6685
7094
  "string"
6686
7095
  ],
6687
- "description": "Declarative event name emitted on direction press/release via useEventBus"
7096
+ "description": "Declarative event name emitted on direction press/release via useEventBus",
7097
+ "kind": "event-ref",
7098
+ "emitPayloadSchema": [
7099
+ {
7100
+ "name": "direction",
7101
+ "type": "string",
7102
+ "required": true
7103
+ },
7104
+ {
7105
+ "name": "pressed",
7106
+ "type": "boolean",
7107
+ "required": true
7108
+ }
7109
+ ]
6688
7110
  },
6689
7111
  "size": {
6690
7112
  "types": [
@@ -7062,7 +7484,9 @@
7062
7484
  "types": [
7063
7485
  "function"
7064
7486
  ],
7065
- "description": "Menu toggle callback"
7487
+ "description": "Menu toggle callback",
7488
+ "kind": "callback",
7489
+ "callbackArgs": []
7066
7490
  },
7067
7491
  "showSearch": {
7068
7492
  "types": [
@@ -7080,7 +7504,14 @@
7080
7504
  "types": [
7081
7505
  "function"
7082
7506
  ],
7083
- "description": "Search callback"
7507
+ "description": "Search callback",
7508
+ "kind": "callback",
7509
+ "callbackArgs": [
7510
+ {
7511
+ "name": "value",
7512
+ "type": "string"
7513
+ }
7514
+ ]
7084
7515
  },
7085
7516
  "userAvatar": {
7086
7517
  "types": [
@@ -7098,7 +7529,9 @@
7098
7529
  "types": [
7099
7530
  "function"
7100
7531
  ],
7101
- "description": "Callback when user avatar is clicked"
7532
+ "description": "Callback when user avatar is clicked",
7533
+ "kind": "callback",
7534
+ "callbackArgs": []
7102
7535
  },
7103
7536
  "actions": {
7104
7537
  "types": [
@@ -7126,7 +7559,9 @@
7126
7559
  "types": [
7127
7560
  "function"
7128
7561
  ],
7129
- "description": "Callback when logo/brand is clicked"
7562
+ "description": "Callback when logo/brand is clicked",
7563
+ "kind": "callback",
7564
+ "callbackArgs": []
7130
7565
  },
7131
7566
  "className": {
7132
7567
  "types": [
@@ -7368,7 +7803,9 @@
7368
7803
  "types": [
7369
7804
  "function"
7370
7805
  ],
7371
- "description": "Click handler"
7806
+ "description": "Click handler",
7807
+ "kind": "callback",
7808
+ "callbackArgs": []
7372
7809
  },
7373
7810
  "className": {
7374
7811
  "types": [
@@ -7585,7 +8022,15 @@
7585
8022
  "types": [
7586
8023
  "string"
7587
8024
  ],
7588
- "description": "Event emitted when collapse state changes, payload: { collapsed: boolean }"
8025
+ "description": "Event emitted when collapse state changes, payload: { collapsed: boolean }",
8026
+ "kind": "event-ref",
8027
+ "emitPayloadSchema": [
8028
+ {
8029
+ "name": "collapsed",
8030
+ "type": "boolean",
8031
+ "required": true
8032
+ }
8033
+ ]
7589
8034
  },
7590
8035
  "hideCollapseButton": {
7591
8036
  "types": [
@@ -7603,13 +8048,17 @@
7603
8048
  "types": [
7604
8049
  "string"
7605
8050
  ],
7606
- "description": "Event emitted when close button is clicked"
8051
+ "description": "Event emitted when close button is clicked",
8052
+ "kind": "event-ref",
8053
+ "emitPayloadSchema": []
7607
8054
  },
7608
8055
  "logoClickEvent": {
7609
8056
  "types": [
7610
8057
  "string"
7611
8058
  ],
7612
- "description": "Event emitted when logo/brand is clicked"
8059
+ "description": "Event emitted when logo/brand is clicked",
8060
+ "kind": "event-ref",
8061
+ "emitPayloadSchema": []
7613
8062
  }
7614
8063
  }
7615
8064
  },
@@ -7883,7 +8332,14 @@
7883
8332
  "types": [
7884
8333
  "function"
7885
8334
  ],
7886
- "description": "Row actions menu items"
8335
+ "description": "Row actions menu items",
8336
+ "kind": "callback",
8337
+ "callbackArgs": [
8338
+ {
8339
+ "name": "row",
8340
+ "type": "object"
8341
+ }
8342
+ ]
7887
8343
  },
7888
8344
  "emptyMessage": {
7889
8345
  "types": [
@@ -8073,7 +8529,14 @@
8073
8529
  "types": [
8074
8530
  "function"
8075
8531
  ],
8076
- "description": "Callback when tab changes"
8532
+ "description": "Callback when tab changes",
8533
+ "kind": "callback",
8534
+ "callbackArgs": [
8535
+ {
8536
+ "name": "tabId",
8537
+ "type": "string"
8538
+ }
8539
+ ]
8077
8540
  },
8078
8541
  "position": {
8079
8542
  "types": [
@@ -8164,19 +8627,25 @@
8164
8627
  "types": [
8165
8628
  "function"
8166
8629
  ],
8167
- "description": "Called when increment is clicked"
8630
+ "description": "Called when increment is clicked",
8631
+ "kind": "callback",
8632
+ "callbackArgs": []
8168
8633
  },
8169
8634
  "onDecrement": {
8170
8635
  "types": [
8171
8636
  "function"
8172
8637
  ],
8173
- "description": "Called when decrement is clicked"
8638
+ "description": "Called when decrement is clicked",
8639
+ "kind": "callback",
8640
+ "callbackArgs": []
8174
8641
  },
8175
8642
  "onReset": {
8176
8643
  "types": [
8177
8644
  "function"
8178
8645
  ],
8179
- "description": "Called when reset is clicked"
8646
+ "description": "Called when reset is clicked",
8647
+ "kind": "callback",
8648
+ "callbackArgs": []
8180
8649
  },
8181
8650
  "title": {
8182
8651
  "types": [
@@ -8271,7 +8740,9 @@
8271
8740
  "types": [
8272
8741
  "function"
8273
8742
  ],
8274
- "description": "Callback when user clicks sign out (optional - uses auth context signOut if not provided)"
8743
+ "description": "Callback when user clicks sign out (optional - uses auth context signOut if not provided)",
8744
+ "kind": "callback",
8745
+ "callbackArgs": []
8275
8746
  },
8276
8747
  "children": {
8277
8748
  "types": [
@@ -8844,7 +9315,15 @@
8844
9315
  "types": [
8845
9316
  "string"
8846
9317
  ],
8847
- "description": "Event name emitted when selection changes (emitted as UI:{selectionEvent})"
9318
+ "description": "Event name emitted when selection changes (emitted as UI:{selectionEvent})",
9319
+ "kind": "event-ref",
9320
+ "emitPayloadSchema": [
9321
+ {
9322
+ "name": "selection",
9323
+ "type": "array",
9324
+ "required": true
9325
+ }
9326
+ ]
8848
9327
  },
8849
9328
  "showUpload": {
8850
9329
  "types": [
@@ -8929,19 +9408,36 @@
8929
9408
  "types": [
8930
9409
  "function"
8931
9410
  ],
8932
- "description": "Callback when signature changes"
9411
+ "description": "Callback when signature changes",
9412
+ "kind": "callback",
9413
+ "callbackArgs": [
9414
+ {
9415
+ "name": "dataUrl",
9416
+ "type": "string"
9417
+ }
9418
+ ]
8933
9419
  },
8934
9420
  "signEvent": {
8935
9421
  "types": [
8936
9422
  "string"
8937
9423
  ],
8938
- "description": "Event to emit on sign"
9424
+ "description": "Event to emit on sign",
9425
+ "kind": "event-ref",
9426
+ "emitPayloadSchema": [
9427
+ {
9428
+ "name": "signature",
9429
+ "type": "string",
9430
+ "required": true
9431
+ }
9432
+ ]
8939
9433
  },
8940
9434
  "clearEvent": {
8941
9435
  "types": [
8942
9436
  "string"
8943
9437
  ],
8944
- "description": "Event to emit on clear"
9438
+ "description": "Event to emit on clear",
9439
+ "kind": "event-ref",
9440
+ "emitPayloadSchema": []
8945
9441
  },
8946
9442
  "entity": {
8947
9443
  "types": [
@@ -9150,13 +9646,28 @@
9150
9646
  "types": [
9151
9647
  "function"
9152
9648
  ],
9153
- "description": "On node click"
9649
+ "description": "On node click",
9650
+ "kind": "callback",
9651
+ "callbackArgs": [
9652
+ {
9653
+ "name": "node",
9654
+ "type": "object"
9655
+ }
9656
+ ]
9154
9657
  },
9155
9658
  "nodeClickEvent": {
9156
9659
  "types": [
9157
9660
  "string"
9158
9661
  ],
9159
- "description": "Node click event"
9662
+ "description": "Node click event",
9663
+ "kind": "event-ref",
9664
+ "emitPayloadSchema": [
9665
+ {
9666
+ "name": "id",
9667
+ "type": "string",
9668
+ "required": true
9669
+ }
9670
+ ]
9160
9671
  },
9161
9672
  "layout": {
9162
9673
  "types": [
@@ -9364,13 +9875,17 @@
9364
9875
  "types": [
9365
9876
  "function"
9366
9877
  ],
9367
- "description": "Callback when the effect animation completes"
9878
+ "description": "Callback when the effect animation completes",
9879
+ "kind": "callback",
9880
+ "callbackArgs": []
9368
9881
  },
9369
9882
  "completeEvent": {
9370
9883
  "types": [
9371
9884
  "string"
9372
9885
  ],
9373
- "description": "Declarative event: emits UI:{completeEvent} when the effect animation completes"
9886
+ "description": "Declarative event: emits UI:{completeEvent} when the effect animation completes",
9887
+ "kind": "event-ref",
9888
+ "emitPayloadSchema": []
9374
9889
  },
9375
9890
  "className": {
9376
9891
  "types": [
@@ -9497,49 +10012,116 @@
9497
10012
  "types": [
9498
10013
  "function"
9499
10014
  ],
9500
- "description": "--- Event handlers (legacy callbacks — prefer declarative event string props below) ---"
10015
+ "description": "--- Event handlers (legacy callbacks — prefer declarative event string props below) ---",
10016
+ "kind": "callback",
10017
+ "callbackArgs": [
10018
+ {
10019
+ "name": "x",
10020
+ "type": "number"
10021
+ },
10022
+ {
10023
+ "name": "y",
10024
+ "type": "number"
10025
+ }
10026
+ ]
9501
10027
  },
9502
10028
  "onUnitClick": {
9503
10029
  "types": [
9504
10030
  "function"
9505
10031
  ],
9506
- "description": "onUnitClick prop"
10032
+ "description": "onUnitClick prop",
10033
+ "kind": "callback",
10034
+ "callbackArgs": [
10035
+ {
10036
+ "name": "unitId",
10037
+ "type": "string"
10038
+ }
10039
+ ]
9507
10040
  },
9508
10041
  "onTileHover": {
9509
10042
  "types": [
9510
10043
  "function"
9511
10044
  ],
9512
- "description": "onTileHover prop"
10045
+ "description": "onTileHover prop",
10046
+ "kind": "callback",
10047
+ "callbackArgs": [
10048
+ {
10049
+ "name": "x",
10050
+ "type": "number"
10051
+ },
10052
+ {
10053
+ "name": "y",
10054
+ "type": "number"
10055
+ }
10056
+ ]
9513
10057
  },
9514
10058
  "onTileLeave": {
9515
10059
  "types": [
9516
10060
  "function"
9517
10061
  ],
9518
- "description": "onTileLeave prop"
10062
+ "description": "onTileLeave prop",
10063
+ "kind": "callback",
10064
+ "callbackArgs": []
9519
10065
  },
9520
10066
  "tileClickEvent": {
9521
10067
  "types": [
9522
10068
  "string"
9523
10069
  ],
9524
- "description": "--- Declarative event props ---"
10070
+ "description": "--- Declarative event props ---",
10071
+ "kind": "event-ref",
10072
+ "emitPayloadSchema": [
10073
+ {
10074
+ "name": "x",
10075
+ "type": "number",
10076
+ "required": true
10077
+ },
10078
+ {
10079
+ "name": "y",
10080
+ "type": "number",
10081
+ "required": true
10082
+ }
10083
+ ]
9525
10084
  },
9526
10085
  "unitClickEvent": {
9527
10086
  "types": [
9528
10087
  "string"
9529
10088
  ],
9530
- "description": "Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click"
10089
+ "description": "Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click",
10090
+ "kind": "event-ref",
10091
+ "emitPayloadSchema": [
10092
+ {
10093
+ "name": "unitId",
10094
+ "type": "string",
10095
+ "required": true
10096
+ }
10097
+ ]
9531
10098
  },
9532
10099
  "tileHoverEvent": {
9533
10100
  "types": [
9534
10101
  "string"
9535
10102
  ],
9536
- "description": "Declarative event: emits UI:{tileHoverEvent} with { x, y } on tile hover"
10103
+ "description": "Declarative event: emits UI:{tileHoverEvent} with { x, y } on tile hover",
10104
+ "kind": "event-ref",
10105
+ "emitPayloadSchema": [
10106
+ {
10107
+ "name": "x",
10108
+ "type": "number",
10109
+ "required": true
10110
+ },
10111
+ {
10112
+ "name": "y",
10113
+ "type": "number",
10114
+ "required": true
10115
+ }
10116
+ ]
9537
10117
  },
9538
10118
  "tileLeaveEvent": {
9539
10119
  "types": [
9540
10120
  "string"
9541
10121
  ],
9542
- "description": "Declarative event: emits UI:{tileLeaveEvent} with {} on tile leave"
10122
+ "description": "Declarative event: emits UI:{tileLeaveEvent} with {} on tile leave",
10123
+ "kind": "event-ref",
10124
+ "emitPayloadSchema": []
9543
10125
  },
9544
10126
  "scale": {
9545
10127
  "types": [
@@ -9599,25 +10181,53 @@
9599
10181
  "types": [
9600
10182
  "function"
9601
10183
  ],
9602
- "description": "--- Asset resolution (project-agnostic) ---"
10184
+ "description": "--- Asset resolution (project-agnostic) ---",
10185
+ "kind": "callback",
10186
+ "callbackArgs": [
10187
+ {
10188
+ "name": "terrain",
10189
+ "type": "string"
10190
+ }
10191
+ ]
9603
10192
  },
9604
10193
  "getFeatureSprite": {
9605
10194
  "types": [
9606
10195
  "function"
9607
10196
  ],
9608
- "description": "Resolve feature sprite URL from feature type key"
10197
+ "description": "Resolve feature sprite URL from feature type key",
10198
+ "kind": "callback",
10199
+ "callbackArgs": [
10200
+ {
10201
+ "name": "featureType",
10202
+ "type": "string"
10203
+ }
10204
+ ]
9609
10205
  },
9610
10206
  "getUnitSprite": {
9611
10207
  "types": [
9612
10208
  "function"
9613
10209
  ],
9614
- "description": "Resolve unit static sprite URL"
10210
+ "description": "Resolve unit static sprite URL",
10211
+ "kind": "callback",
10212
+ "callbackArgs": [
10213
+ {
10214
+ "name": "unit",
10215
+ "type": "object"
10216
+ }
10217
+ ]
9615
10218
  },
9616
10219
  "resolveUnitFrame": {
9617
10220
  "types": [
9618
10221
  "function"
9619
10222
  ],
9620
- "description": "Resolve animated sprite sheet frame for a unit"
10223
+ "description": "Resolve animated sprite sheet frame for a unit",
10224
+ "kind": "callback",
10225
+ "callbackArgs": [
10226
+ {
10227
+ "name": "unitId",
10228
+ "type": "string"
10229
+ }
10230
+ ]
9621
10231
  },
9622
10232
  "effectSpriteUrls": {
9623
10233
  "types": [
@@ -9629,7 +10239,22 @@
9629
10239
  "types": [
9630
10240
  "function"
9631
10241
  ],
9632
- "description": "Callback to draw canvas effects after units (canvas-specific: cannot be declarative)"
10242
+ "description": "Callback to draw canvas effects after units (canvas-specific: cannot be declarative)",
10243
+ "kind": "callback",
10244
+ "callbackArgs": [
10245
+ {
10246
+ "name": "ctx",
10247
+ "type": "object"
10248
+ },
10249
+ {
10250
+ "name": "animTime",
10251
+ "type": "number"
10252
+ },
10253
+ {
10254
+ "name": "getImage",
10255
+ "type": "function"
10256
+ }
10257
+ ]
9633
10258
  },
9634
10259
  "hasActiveEffects": {
9635
10260
  "types": [
@@ -9806,61 +10431,151 @@
9806
10431
  "types": [
9807
10432
  "function"
9808
10433
  ],
9809
- "description": "-- Slots --"
10434
+ "description": "-- Slots --",
10435
+ "kind": "callback",
10436
+ "callbackArgs": [
10437
+ {
10438
+ "name": "ctx",
10439
+ "type": "object"
10440
+ }
10441
+ ]
9810
10442
  },
9811
10443
  "sidebar": {
9812
10444
  "types": [
9813
10445
  "function"
9814
10446
  ],
9815
- "description": "Sidebar content (combat log, unit roster, etc.)"
10447
+ "description": "Sidebar content (combat log, unit roster, etc.)",
10448
+ "kind": "callback",
10449
+ "callbackArgs": [
10450
+ {
10451
+ "name": "ctx",
10452
+ "type": "object"
10453
+ }
10454
+ ]
9816
10455
  },
9817
10456
  "actions": {
9818
10457
  "types": [
9819
10458
  "function"
9820
10459
  ],
9821
- "description": "Floating action buttons"
10460
+ "description": "Floating action buttons",
10461
+ "kind": "callback",
10462
+ "callbackArgs": [
10463
+ {
10464
+ "name": "ctx",
10465
+ "type": "object"
10466
+ }
10467
+ ]
9822
10468
  },
9823
10469
  "overlay": {
9824
10470
  "types": [
9825
10471
  "function"
9826
10472
  ],
9827
- "description": "Floating overlays above the canvas (damage popups, tooltips)"
10473
+ "description": "Floating overlays above the canvas (damage popups, tooltips)",
10474
+ "kind": "callback",
10475
+ "callbackArgs": [
10476
+ {
10477
+ "name": "ctx",
10478
+ "type": "object"
10479
+ }
10480
+ ]
9828
10481
  },
9829
10482
  "gameOverOverlay": {
9830
10483
  "types": [
9831
10484
  "function"
9832
10485
  ],
9833
- "description": "Game-over screen overlay"
10486
+ "description": "Game-over screen overlay",
10487
+ "kind": "callback",
10488
+ "callbackArgs": [
10489
+ {
10490
+ "name": "ctx",
10491
+ "type": "object"
10492
+ }
10493
+ ]
9834
10494
  },
9835
10495
  "onAttack": {
9836
10496
  "types": [
9837
10497
  "function"
9838
10498
  ],
9839
- "description": "-- Callbacks --"
10499
+ "description": "-- Callbacks --",
10500
+ "kind": "callback",
10501
+ "callbackArgs": [
10502
+ {
10503
+ "name": "attacker",
10504
+ "type": "object"
10505
+ },
10506
+ {
10507
+ "name": "target",
10508
+ "type": "object"
10509
+ },
10510
+ {
10511
+ "name": "damage",
10512
+ "type": "number"
10513
+ }
10514
+ ]
9840
10515
  },
9841
10516
  "onGameEnd": {
9842
10517
  "types": [
9843
10518
  "function"
9844
10519
  ],
9845
- "description": "Called when battle ends"
10520
+ "description": "Called when battle ends",
10521
+ "kind": "callback",
10522
+ "callbackArgs": [
10523
+ {
10524
+ "name": "result",
10525
+ "type": "string"
10526
+ }
10527
+ ]
9846
10528
  },
9847
10529
  "onUnitMove": {
9848
10530
  "types": [
9849
10531
  "function"
9850
10532
  ],
9851
- "description": "Called after a unit moves"
10533
+ "description": "Called after a unit moves",
10534
+ "kind": "callback",
10535
+ "callbackArgs": [
10536
+ {
10537
+ "name": "unit",
10538
+ "type": "object"
10539
+ },
10540
+ {
10541
+ "name": "to",
10542
+ "type": "object"
10543
+ }
10544
+ ]
9852
10545
  },
9853
10546
  "calculateDamage": {
9854
10547
  "types": [
9855
10548
  "function"
9856
10549
  ],
9857
- "description": "Custom combat damage calculator"
10550
+ "description": "Custom combat damage calculator",
10551
+ "kind": "callback",
10552
+ "callbackArgs": [
10553
+ {
10554
+ "name": "attacker",
10555
+ "type": "object"
10556
+ },
10557
+ {
10558
+ "name": "target",
10559
+ "type": "object"
10560
+ }
10561
+ ]
9858
10562
  },
9859
10563
  "onDrawEffects": {
9860
10564
  "types": [
9861
10565
  "function"
9862
10566
  ],
9863
- "description": "-- Canvas pass-through --"
10567
+ "description": "-- Canvas pass-through --",
10568
+ "kind": "callback",
10569
+ "callbackArgs": [
10570
+ {
10571
+ "name": "ctx",
10572
+ "type": "object"
10573
+ },
10574
+ {
10575
+ "name": "timestamp",
10576
+ "type": "number"
10577
+ }
10578
+ ]
9864
10579
  },
9865
10580
  "hasActiveEffects": {
9866
10581
  "types": [
@@ -9878,49 +10593,109 @@
9878
10593
  "types": [
9879
10594
  "function"
9880
10595
  ],
9881
- "description": "resolveUnitFrame prop"
10596
+ "description": "resolveUnitFrame prop",
10597
+ "kind": "callback",
10598
+ "callbackArgs": [
10599
+ {
10600
+ "name": "unitId",
10601
+ "type": "string"
10602
+ }
10603
+ ]
9882
10604
  },
9883
10605
  "tileClickEvent": {
9884
10606
  "types": [
9885
10607
  "string"
9886
10608
  ],
9887
- "description": "-- Declarative event props --"
10609
+ "description": "-- Declarative event props --",
10610
+ "kind": "event-ref",
10611
+ "emitPayloadSchema": [
10612
+ {
10613
+ "name": "x",
10614
+ "type": "number",
10615
+ "required": true
10616
+ },
10617
+ {
10618
+ "name": "y",
10619
+ "type": "number",
10620
+ "required": true
10621
+ }
10622
+ ]
9888
10623
  },
9889
10624
  "unitClickEvent": {
9890
10625
  "types": [
9891
10626
  "string"
9892
10627
  ],
9893
- "description": "Emits UI:{unitClickEvent} with { unitId } on unit click"
10628
+ "description": "Emits UI:{unitClickEvent} with { unitId } on unit click",
10629
+ "kind": "event-ref",
10630
+ "emitPayloadSchema": [
10631
+ {
10632
+ "name": "unitId",
10633
+ "type": "string",
10634
+ "required": true
10635
+ }
10636
+ ]
9894
10637
  },
9895
10638
  "endTurnEvent": {
9896
10639
  "types": [
9897
10640
  "string"
9898
10641
  ],
9899
- "description": "Emits UI:{endTurnEvent} with {} on end turn"
10642
+ "description": "Emits UI:{endTurnEvent} with {} on end turn",
10643
+ "kind": "event-ref",
10644
+ "emitPayloadSchema": []
9900
10645
  },
9901
10646
  "cancelEvent": {
9902
10647
  "types": [
9903
10648
  "string"
9904
10649
  ],
9905
- "description": "Emits UI:{cancelEvent} with {} on cancel"
10650
+ "description": "Emits UI:{cancelEvent} with {} on cancel",
10651
+ "kind": "event-ref",
10652
+ "emitPayloadSchema": []
9906
10653
  },
9907
10654
  "gameEndEvent": {
9908
10655
  "types": [
9909
10656
  "string"
9910
10657
  ],
9911
- "description": "Emits UI:{gameEndEvent} with { result } on game end"
10658
+ "description": "Emits UI:{gameEndEvent} with { result: 'victory' | 'defeat' } on game end",
10659
+ "kind": "event-ref",
10660
+ "emitPayloadSchema": [
10661
+ {
10662
+ "name": "result",
10663
+ "type": "string",
10664
+ "required": true
10665
+ }
10666
+ ]
9912
10667
  },
9913
10668
  "playAgainEvent": {
9914
10669
  "types": [
9915
10670
  "string"
9916
10671
  ],
9917
- "description": "Emits UI:{playAgainEvent} with {} on play again / reset"
10672
+ "description": "Emits UI:{playAgainEvent} with {} on play again / reset",
10673
+ "kind": "event-ref",
10674
+ "emitPayloadSchema": []
9918
10675
  },
9919
10676
  "attackEvent": {
9920
10677
  "types": [
9921
10678
  "string"
9922
10679
  ],
9923
- "description": "Emits UI:{attackEvent} with { attackerId, targetId, damage } on attack"
10680
+ "description": "Emits UI:{attackEvent} with { attackerId, targetId, damage } on attack",
10681
+ "kind": "event-ref",
10682
+ "emitPayloadSchema": [
10683
+ {
10684
+ "name": "attackerId",
10685
+ "type": "string",
10686
+ "required": true
10687
+ },
10688
+ {
10689
+ "name": "targetId",
10690
+ "type": "string",
10691
+ "required": true
10692
+ },
10693
+ {
10694
+ "name": "damage",
10695
+ "type": "number",
10696
+ "required": true
10697
+ }
10698
+ ]
9924
10699
  },
9925
10700
  "className": {
9926
10701
  "types": [
@@ -9958,61 +10733,158 @@
9958
10733
  "types": [
9959
10734
  "function"
9960
10735
  ],
9961
- "description": "-- Render-prop slots --"
10736
+ "description": "-- Render-prop slots --",
10737
+ "kind": "callback",
10738
+ "callbackArgs": [
10739
+ {
10740
+ "name": "ctx",
10741
+ "type": "object"
10742
+ }
10743
+ ]
9962
10744
  },
9963
10745
  "sidePanel": {
9964
10746
  "types": [
9965
10747
  "function"
9966
10748
  ],
9967
- "description": "Side panel content (buildings list, recruit tab, garrison tab)"
10749
+ "description": "Side panel content (buildings list, recruit tab, garrison tab)",
10750
+ "kind": "callback",
10751
+ "callbackArgs": [
10752
+ {
10753
+ "name": "ctx",
10754
+ "type": "object"
10755
+ }
10756
+ ]
9968
10757
  },
9969
10758
  "overlay": {
9970
10759
  "types": [
9971
10760
  "function"
9972
10761
  ],
9973
- "description": "Canvas overlay (hover tooltips, etc.)"
10762
+ "description": "Canvas overlay (hover tooltips, etc.)",
10763
+ "kind": "callback",
10764
+ "callbackArgs": [
10765
+ {
10766
+ "name": "ctx",
10767
+ "type": "object"
10768
+ }
10769
+ ]
9974
10770
  },
9975
10771
  "footer": {
9976
10772
  "types": [
9977
10773
  "function"
9978
10774
  ],
9979
- "description": "Bottom bar (income summary, etc.)"
10775
+ "description": "Bottom bar (income summary, etc.)",
10776
+ "kind": "callback",
10777
+ "callbackArgs": [
10778
+ {
10779
+ "name": "ctx",
10780
+ "type": "object"
10781
+ }
10782
+ ]
9980
10783
  },
9981
10784
  "onFeatureClick": {
9982
10785
  "types": [
9983
10786
  "function"
9984
10787
  ],
9985
- "description": "-- Callback overrides --"
10788
+ "description": "-- Callback overrides --",
10789
+ "kind": "callback",
10790
+ "callbackArgs": [
10791
+ {
10792
+ "name": "feature",
10793
+ "type": "object"
10794
+ }
10795
+ ]
9986
10796
  },
9987
10797
  "onUnitClick": {
9988
10798
  "types": [
9989
10799
  "function"
9990
10800
  ],
9991
- "description": "Called when a unit is clicked"
10801
+ "description": "Called when a unit is clicked",
10802
+ "kind": "callback",
10803
+ "callbackArgs": [
10804
+ {
10805
+ "name": "unit",
10806
+ "type": "object"
10807
+ }
10808
+ ]
9992
10809
  },
9993
10810
  "onTileClick": {
9994
10811
  "types": [
9995
10812
  "function"
9996
10813
  ],
9997
- "description": "Called when any tile is clicked"
10814
+ "description": "Called when any tile is clicked",
10815
+ "kind": "callback",
10816
+ "callbackArgs": [
10817
+ {
10818
+ "name": "x",
10819
+ "type": "number"
10820
+ },
10821
+ {
10822
+ "name": "y",
10823
+ "type": "number"
10824
+ }
10825
+ ]
9998
10826
  },
9999
10827
  "featureClickEvent": {
10000
10828
  "types": [
10001
10829
  "string"
10002
10830
  ],
10003
- "description": "-- Declarative event props --"
10831
+ "description": "-- Declarative event props --",
10832
+ "kind": "event-ref",
10833
+ "emitPayloadSchema": [
10834
+ {
10835
+ "name": "featureId",
10836
+ "type": "string",
10837
+ "required": true
10838
+ },
10839
+ {
10840
+ "name": "featureType",
10841
+ "type": "string",
10842
+ "required": true
10843
+ },
10844
+ {
10845
+ "name": "x",
10846
+ "type": "number",
10847
+ "required": true
10848
+ },
10849
+ {
10850
+ "name": "y",
10851
+ "type": "number",
10852
+ "required": true
10853
+ }
10854
+ ]
10004
10855
  },
10005
10856
  "unitClickEvent": {
10006
10857
  "types": [
10007
10858
  "string"
10008
10859
  ],
10009
- "description": "Event name to emit via event bus when a unit is clicked (emits UI:{unitClickEvent})"
10860
+ "description": "Event name to emit via event bus when a unit is clicked (emits UI:{unitClickEvent})",
10861
+ "kind": "event-ref",
10862
+ "emitPayloadSchema": [
10863
+ {
10864
+ "name": "unitId",
10865
+ "type": "string",
10866
+ "required": true
10867
+ }
10868
+ ]
10010
10869
  },
10011
10870
  "tileClickEvent": {
10012
10871
  "types": [
10013
10872
  "string"
10014
10873
  ],
10015
- "description": "Event name to emit via event bus when a tile is clicked (emits UI:{tileClickEvent})"
10874
+ "description": "Event name to emit via event bus when a tile is clicked (emits UI:{tileClickEvent})",
10875
+ "kind": "event-ref",
10876
+ "emitPayloadSchema": [
10877
+ {
10878
+ "name": "x",
10879
+ "type": "number",
10880
+ "required": true
10881
+ },
10882
+ {
10883
+ "name": "y",
10884
+ "type": "number",
10885
+ "required": true
10886
+ }
10887
+ ]
10016
10888
  },
10017
10889
  "className": {
10018
10890
  "types": [
@@ -10081,85 +10953,242 @@
10081
10953
  "types": [
10082
10954
  "function"
10083
10955
  ],
10084
- "description": "Custom movement range validator"
10956
+ "description": "Custom movement range validator",
10957
+ "kind": "callback",
10958
+ "callbackArgs": [
10959
+ {
10960
+ "name": "from",
10961
+ "type": "object"
10962
+ },
10963
+ {
10964
+ "name": "to",
10965
+ "type": "object"
10966
+ },
10967
+ {
10968
+ "name": "range",
10969
+ "type": "number"
10970
+ }
10971
+ ]
10085
10972
  },
10086
10973
  "heroSelectEvent": {
10087
10974
  "types": [
10088
10975
  "string"
10089
10976
  ],
10090
- "description": "-- Declarative event props --"
10977
+ "description": "-- Declarative event props --",
10978
+ "kind": "event-ref",
10979
+ "emitPayloadSchema": [
10980
+ {
10981
+ "name": "heroId",
10982
+ "type": "string",
10983
+ "required": true
10984
+ }
10985
+ ]
10091
10986
  },
10092
10987
  "heroMoveEvent": {
10093
10988
  "types": [
10094
10989
  "string"
10095
10990
  ],
10096
- "description": "Emits UI:{heroMoveEvent} with { heroId, toX, toY }"
10991
+ "description": "Emits UI:{heroMoveEvent} with { heroId, toX, toY }",
10992
+ "kind": "event-ref",
10993
+ "emitPayloadSchema": [
10994
+ {
10995
+ "name": "heroId",
10996
+ "type": "string",
10997
+ "required": true
10998
+ },
10999
+ {
11000
+ "name": "toX",
11001
+ "type": "number",
11002
+ "required": true
11003
+ },
11004
+ {
11005
+ "name": "toY",
11006
+ "type": "number",
11007
+ "required": true
11008
+ }
11009
+ ]
10097
11010
  },
10098
11011
  "battleEncounterEvent": {
10099
11012
  "types": [
10100
11013
  "string"
10101
11014
  ],
10102
- "description": "Emits UI:{battleEncounterEvent} with { attackerId, defenderId }"
11015
+ "description": "Emits UI:{battleEncounterEvent} with { attackerId, defenderId }",
11016
+ "kind": "event-ref",
11017
+ "emitPayloadSchema": [
11018
+ {
11019
+ "name": "attackerId",
11020
+ "type": "string",
11021
+ "required": true
11022
+ },
11023
+ {
11024
+ "name": "defenderId",
11025
+ "type": "string",
11026
+ "required": true
11027
+ }
11028
+ ]
10103
11029
  },
10104
11030
  "featureEnterEvent": {
10105
11031
  "types": [
10106
11032
  "string"
10107
11033
  ],
10108
- "description": "Emits UI:{featureEnterEvent} with { heroId, feature, hex }"
11034
+ "description": "Emits UI:{featureEnterEvent} with { heroId, feature, hex }",
11035
+ "kind": "event-ref",
11036
+ "emitPayloadSchema": [
11037
+ {
11038
+ "name": "heroId",
11039
+ "type": "string",
11040
+ "required": true
11041
+ },
11042
+ {
11043
+ "name": "feature",
11044
+ "type": "string",
11045
+ "required": true
11046
+ },
11047
+ {
11048
+ "name": "hex",
11049
+ "type": "object",
11050
+ "required": true
11051
+ }
11052
+ ]
10109
11053
  },
10110
11054
  "tileClickEvent": {
10111
11055
  "types": [
10112
11056
  "string"
10113
11057
  ],
10114
- "description": "Emits UI:{tileClickEvent} with { x, y }"
11058
+ "description": "Emits UI:{tileClickEvent} with { x, y }",
11059
+ "kind": "event-ref",
11060
+ "emitPayloadSchema": [
11061
+ {
11062
+ "name": "x",
11063
+ "type": "number",
11064
+ "required": true
11065
+ },
11066
+ {
11067
+ "name": "y",
11068
+ "type": "number",
11069
+ "required": true
11070
+ }
11071
+ ]
10115
11072
  },
10116
11073
  "header": {
10117
11074
  "types": [
10118
11075
  "function"
10119
11076
  ],
10120
- "description": "-- Slots --"
11077
+ "description": "-- Slots --",
11078
+ "kind": "callback",
11079
+ "callbackArgs": [
11080
+ {
11081
+ "name": "ctx",
11082
+ "type": "object"
11083
+ }
11084
+ ]
10121
11085
  },
10122
11086
  "sidePanel": {
10123
11087
  "types": [
10124
11088
  "function"
10125
11089
  ],
10126
- "description": "Side panel (hero detail, hero lists, etc.)"
11090
+ "description": "Side panel (hero detail, hero lists, etc.)",
11091
+ "kind": "callback",
11092
+ "callbackArgs": [
11093
+ {
11094
+ "name": "ctx",
11095
+ "type": "object"
11096
+ }
11097
+ ]
10127
11098
  },
10128
11099
  "overlay": {
10129
11100
  "types": [
10130
11101
  "function"
10131
11102
  ],
10132
- "description": "Canvas overlay (tooltips, popups)"
11103
+ "description": "Canvas overlay (tooltips, popups)",
11104
+ "kind": "callback",
11105
+ "callbackArgs": [
11106
+ {
11107
+ "name": "ctx",
11108
+ "type": "object"
11109
+ }
11110
+ ]
10133
11111
  },
10134
11112
  "footer": {
10135
11113
  "types": [
10136
11114
  "function"
10137
11115
  ],
10138
- "description": "Footer"
11116
+ "description": "Footer",
11117
+ "kind": "callback",
11118
+ "callbackArgs": [
11119
+ {
11120
+ "name": "ctx",
11121
+ "type": "object"
11122
+ }
11123
+ ]
10139
11124
  },
10140
11125
  "onHeroSelect": {
10141
11126
  "types": [
10142
11127
  "function"
10143
11128
  ],
10144
- "description": "-- Callbacks --"
11129
+ "description": "-- Callbacks --",
11130
+ "kind": "callback",
11131
+ "callbackArgs": [
11132
+ {
11133
+ "name": "heroId",
11134
+ "type": "string"
11135
+ }
11136
+ ]
10145
11137
  },
10146
11138
  "onHeroMove": {
10147
11139
  "types": [
10148
11140
  "function"
10149
11141
  ],
10150
- "description": "onHeroMove prop"
11142
+ "description": "onHeroMove prop",
11143
+ "kind": "callback",
11144
+ "callbackArgs": [
11145
+ {
11146
+ "name": "heroId",
11147
+ "type": "string"
11148
+ },
11149
+ {
11150
+ "name": "toX",
11151
+ "type": "number"
11152
+ },
11153
+ {
11154
+ "name": "toY",
11155
+ "type": "number"
11156
+ }
11157
+ ]
10151
11158
  },
10152
11159
  "onBattleEncounter": {
10153
11160
  "types": [
10154
11161
  "function"
10155
11162
  ],
10156
- "description": "Called when hero clicks an enemy hero tile"
11163
+ "description": "Called when hero clicks an enemy hero tile",
11164
+ "kind": "callback",
11165
+ "callbackArgs": [
11166
+ {
11167
+ "name": "attackerId",
11168
+ "type": "string"
11169
+ },
11170
+ {
11171
+ "name": "defenderId",
11172
+ "type": "string"
11173
+ }
11174
+ ]
10157
11175
  },
10158
11176
  "onFeatureEnter": {
10159
11177
  "types": [
10160
11178
  "function"
10161
11179
  ],
10162
- "description": "Called when hero enters a feature hex (castle, resource, etc.)"
11180
+ "description": "Called when hero enters a feature hex (castle, resource, etc.)",
11181
+ "kind": "callback",
11182
+ "callbackArgs": [
11183
+ {
11184
+ "name": "heroId",
11185
+ "type": "string"
11186
+ },
11187
+ {
11188
+ "name": "hex",
11189
+ "type": "object"
11190
+ }
11191
+ ]
10163
11192
  },
10164
11193
  "diamondTopY": {
10165
11194
  "types": [
@@ -10183,7 +11212,14 @@
10183
11212
  "types": [
10184
11213
  "function"
10185
11214
  ],
10186
- "description": "resolveUnitFrame prop"
11215
+ "description": "resolveUnitFrame prop",
11216
+ "kind": "callback",
11217
+ "callbackArgs": [
11218
+ {
11219
+ "name": "unitId",
11220
+ "type": "string"
11221
+ }
11222
+ ]
10187
11223
  }
10188
11224
  }
10189
11225
  },
@@ -10217,7 +11253,9 @@
10217
11253
  "function"
10218
11254
  ],
10219
11255
  "description": "onToggle prop",
10220
- "required": true
11256
+ "required": true,
11257
+ "kind": "callback",
11258
+ "callbackArgs": []
10221
11259
  },
10222
11260
  "children": {
10223
11261
  "types": [
@@ -10287,13 +11325,22 @@
10287
11325
  "types": [
10288
11326
  "function"
10289
11327
  ],
10290
- "description": "Click handler"
11328
+ "description": "Click handler",
11329
+ "kind": "callback",
11330
+ "callbackArgs": []
10291
11331
  },
10292
11332
  "onHover": {
10293
11333
  "types": [
10294
11334
  "function"
10295
11335
  ],
10296
- "description": "Hover handler"
11336
+ "description": "Hover handler",
11337
+ "kind": "callback",
11338
+ "callbackArgs": [
11339
+ {
11340
+ "name": "hovered",
11341
+ "type": "boolean"
11342
+ }
11343
+ ]
10297
11344
  },
10298
11345
  "fallbackGeometry": {
10299
11346
  "types": [
@@ -10367,13 +11414,27 @@
10367
11414
  "types": [
10368
11415
  "function"
10369
11416
  ],
10370
- "description": "Called when feature is clicked"
11417
+ "description": "Called when feature is clicked",
11418
+ "kind": "callback",
11419
+ "callbackArgs": [
11420
+ {
11421
+ "name": "feature",
11422
+ "type": "object"
11423
+ }
11424
+ ]
10371
11425
  },
10372
11426
  "onFeatureHover": {
10373
11427
  "types": [
10374
11428
  "function"
10375
11429
  ],
10376
- "description": "Called when feature is hovered"
11430
+ "description": "Called when feature is hovered",
11431
+ "kind": "callback",
11432
+ "callbackArgs": [
11433
+ {
11434
+ "name": "feature",
11435
+ "type": "object"
11436
+ }
11437
+ ]
10377
11438
  },
10378
11439
  "selectedFeatureIds": {
10379
11440
  "types": [
@@ -10441,13 +11502,27 @@
10441
11502
  "types": [
10442
11503
  "function"
10443
11504
  ],
10444
- "description": "Called when tile is clicked"
11505
+ "description": "Called when tile is clicked",
11506
+ "kind": "callback",
11507
+ "callbackArgs": [
11508
+ {
11509
+ "name": "tile",
11510
+ "type": "object"
11511
+ }
11512
+ ]
10445
11513
  },
10446
11514
  "onTileHover": {
10447
11515
  "types": [
10448
11516
  "function"
10449
11517
  ],
10450
- "description": "Called when tile is hovered"
11518
+ "description": "Called when tile is hovered",
11519
+ "kind": "callback",
11520
+ "callbackArgs": [
11521
+ {
11522
+ "name": "tile",
11523
+ "type": "object"
11524
+ }
11525
+ ]
10451
11526
  },
10452
11527
  "selectedTileIds": {
10453
11528
  "types": [
@@ -10515,13 +11590,31 @@
10515
11590
  "types": [
10516
11591
  "function"
10517
11592
  ],
10518
- "description": "Called when unit is clicked"
11593
+ "description": "Called when unit is clicked",
11594
+ "kind": "callback",
11595
+ "callbackArgs": [
11596
+ {
11597
+ "name": "unit",
11598
+ "type": "object"
11599
+ }
11600
+ ]
10519
11601
  },
10520
11602
  "onAnimationStateChange": {
10521
11603
  "types": [
10522
11604
  "function"
10523
11605
  ],
10524
- "description": "Called when unit animation state changes"
11606
+ "description": "Called when unit animation state changes",
11607
+ "kind": "callback",
11608
+ "callbackArgs": [
11609
+ {
11610
+ "name": "unitId",
11611
+ "type": "string"
11612
+ },
11613
+ {
11614
+ "name": "state",
11615
+ "type": "string"
11616
+ }
11617
+ ]
10525
11618
  },
10526
11619
  "animationSpeed": {
10527
11620
  "types": [
@@ -10621,7 +11714,18 @@
10621
11714
  "types": [
10622
11715
  "function"
10623
11716
  ],
10624
- "description": "Called when an error is caught (for logging/telemetry)"
11717
+ "description": "Called when an error is caught (for logging/telemetry)",
11718
+ "kind": "callback",
11719
+ "callbackArgs": [
11720
+ {
11721
+ "name": "error",
11722
+ "type": "object"
11723
+ },
11724
+ {
11725
+ "name": "errorInfo",
11726
+ "type": "object"
11727
+ }
11728
+ ]
10625
11729
  }
10626
11730
  }
10627
11731
  },
@@ -10885,7 +11989,14 @@
10885
11989
  "types": [
10886
11990
  "function"
10887
11991
  ],
10888
- "description": "-- Drag and drop --"
11992
+ "description": "-- Drag and drop --",
11993
+ "kind": "callback",
11994
+ "callbackArgs": [
11995
+ {
11996
+ "name": "item",
11997
+ "type": "object"
11998
+ }
11999
+ ]
10889
12000
  },
10890
12001
  "draggable": {
10891
12002
  "types": [
@@ -10897,7 +12008,14 @@
10897
12008
  "types": [
10898
12009
  "function"
10899
12010
  ],
10900
- "description": "Called when drag starts from this slot"
12011
+ "description": "Called when drag starts from this slot",
12012
+ "kind": "callback",
12013
+ "callbackArgs": [
12014
+ {
12015
+ "name": "item",
12016
+ "type": "object"
12017
+ }
12018
+ ]
10901
12019
  },
10902
12020
  "feedback": {
10903
12021
  "types": [
@@ -10913,25 +12031,45 @@
10913
12031
  "types": [
10914
12032
  "function"
10915
12033
  ],
10916
- "description": "-- Callbacks --"
12034
+ "description": "-- Callbacks --",
12035
+ "kind": "callback",
12036
+ "callbackArgs": []
10917
12037
  },
10918
12038
  "onRemove": {
10919
12039
  "types": [
10920
12040
  "function"
10921
12041
  ],
10922
- "description": "Remove handler"
12042
+ "description": "Remove handler",
12043
+ "kind": "callback",
12044
+ "callbackArgs": []
10923
12045
  },
10924
12046
  "clickEvent": {
10925
12047
  "types": [
10926
12048
  "string"
10927
12049
  ],
10928
- "description": "-- Declarative events --"
12050
+ "description": "-- Declarative events --",
12051
+ "kind": "event-ref",
12052
+ "emitPayloadSchema": [
12053
+ {
12054
+ "name": "slotNumber",
12055
+ "type": "number",
12056
+ "required": true
12057
+ }
12058
+ ]
10929
12059
  },
10930
12060
  "removeEvent": {
10931
12061
  "types": [
10932
12062
  "string"
10933
12063
  ],
10934
- "description": "Emits UI:{removeEvent} with { slotNumber }"
12064
+ "description": "Emits UI:{removeEvent} with { slotNumber }",
12065
+ "kind": "event-ref",
12066
+ "emitPayloadSchema": [
12067
+ {
12068
+ "name": "slotNumber",
12069
+ "type": "number",
12070
+ "required": true
12071
+ }
12072
+ ]
10935
12073
  }
10936
12074
  }
10937
12075
  },
@@ -10986,7 +12124,14 @@
10986
12124
  "types": [
10987
12125
  "function"
10988
12126
  ],
10989
- "description": "Click handler for states"
12127
+ "description": "Click handler for states",
12128
+ "kind": "callback",
12129
+ "callbackArgs": [
12130
+ {
12131
+ "name": "state",
12132
+ "type": "string"
12133
+ }
12134
+ ]
10990
12135
  },
10991
12136
  "stateStyles": {
10992
12137
  "types": [
@@ -11138,7 +12283,14 @@
11138
12283
  "types": [
11139
12284
  "function"
11140
12285
  ],
11141
- "description": "GAP-51: called with the new code on every keystroke when `editable === true`. Consumers should debounce + parse downstream — `CodeBlock` does not."
12286
+ "description": "GAP-51: called with the new code on every keystroke when `editable === true`. Consumers should debounce + parse downstream — `CodeBlock` does not.",
12287
+ "kind": "callback",
12288
+ "callbackArgs": [
12289
+ {
12290
+ "name": "code",
12291
+ "type": "string"
12292
+ }
12293
+ ]
11142
12294
  },
11143
12295
  "errorLines": {
11144
12296
  "types": [
@@ -11404,7 +12556,18 @@
11404
12556
  "types": [
11405
12557
  "function"
11406
12558
  ],
11407
- "description": "Custom state node renderer — when provided, replaces the default circle nodes"
12559
+ "description": "Custom state node renderer — when provided, replaces the default circle nodes",
12560
+ "kind": "callback",
12561
+ "callbackArgs": [
12562
+ {
12563
+ "name": "state",
12564
+ "type": "object"
12565
+ },
12566
+ {
12567
+ "name": "config",
12568
+ "type": "object"
12569
+ }
12570
+ ]
11408
12571
  }
11409
12572
  }
11410
12573
  },
@@ -11862,42 +13025,68 @@
11862
13025
  "function"
11863
13026
  ],
11864
13027
  "description": "onPlay prop",
11865
- "required": true
13028
+ "required": true,
13029
+ "kind": "callback",
13030
+ "callbackArgs": []
11866
13031
  },
11867
13032
  "onPause": {
11868
13033
  "types": [
11869
13034
  "function"
11870
13035
  ],
11871
13036
  "description": "onPause prop",
11872
- "required": true
13037
+ "required": true,
13038
+ "kind": "callback",
13039
+ "callbackArgs": []
11873
13040
  },
11874
13041
  "onStep": {
11875
13042
  "types": [
11876
13043
  "function"
11877
13044
  ],
11878
13045
  "description": "onStep prop",
11879
- "required": true
13046
+ "required": true,
13047
+ "kind": "callback",
13048
+ "callbackArgs": []
11880
13049
  },
11881
13050
  "onReset": {
11882
13051
  "types": [
11883
13052
  "function"
11884
13053
  ],
11885
13054
  "description": "onReset prop",
11886
- "required": true
13055
+ "required": true,
13056
+ "kind": "callback",
13057
+ "callbackArgs": []
11887
13058
  },
11888
13059
  "onSpeedChange": {
11889
13060
  "types": [
11890
13061
  "function"
11891
13062
  ],
11892
13063
  "description": "onSpeedChange prop",
11893
- "required": true
13064
+ "required": true,
13065
+ "kind": "callback",
13066
+ "callbackArgs": [
13067
+ {
13068
+ "name": "speed",
13069
+ "type": "number"
13070
+ }
13071
+ ]
11894
13072
  },
11895
13073
  "onParameterChange": {
11896
13074
  "types": [
11897
13075
  "function"
11898
13076
  ],
11899
13077
  "description": "onParameterChange prop",
11900
- "required": true
13078
+ "required": true,
13079
+ "kind": "callback",
13080
+ "callbackArgs": [
13081
+ {
13082
+ "name": "name",
13083
+ "type": "string"
13084
+ },
13085
+ {
13086
+ "name": "value",
13087
+ "type": "number"
13088
+ }
13089
+ ]
11901
13090
  },
11902
13091
  "className": {
11903
13092
  "types": [
@@ -11993,7 +13182,20 @@
11993
13182
  "types": [
11994
13183
  "string"
11995
13184
  ],
11996
- "description": "completeEvent prop"
13185
+ "description": "completeEvent prop",
13186
+ "kind": "event-ref",
13187
+ "emitPayloadSchema": [
13188
+ {
13189
+ "name": "success",
13190
+ "type": "boolean",
13191
+ "required": true
13192
+ },
13193
+ {
13194
+ "name": "attempts",
13195
+ "type": "number",
13196
+ "required": true
13197
+ }
13198
+ ]
11997
13199
  }
11998
13200
  }
11999
13201
  },
@@ -12019,7 +13221,20 @@
12019
13221
  "types": [
12020
13222
  "string"
12021
13223
  ],
12022
- "description": "completeEvent prop"
13224
+ "description": "completeEvent prop",
13225
+ "kind": "event-ref",
13226
+ "emitPayloadSchema": [
13227
+ {
13228
+ "name": "success",
13229
+ "type": "boolean",
13230
+ "required": true
13231
+ },
13232
+ {
13233
+ "name": "attempts",
13234
+ "type": "number",
13235
+ "required": true
13236
+ }
13237
+ ]
12023
13238
  }
12024
13239
  }
12025
13240
  },
@@ -12045,7 +13260,20 @@
12045
13260
  "types": [
12046
13261
  "string"
12047
13262
  ],
12048
- "description": "completeEvent prop"
13263
+ "description": "completeEvent prop",
13264
+ "kind": "event-ref",
13265
+ "emitPayloadSchema": [
13266
+ {
13267
+ "name": "success",
13268
+ "type": "boolean",
13269
+ "required": true
13270
+ },
13271
+ {
13272
+ "name": "attempts",
13273
+ "type": "number",
13274
+ "required": true
13275
+ }
13276
+ ]
12049
13277
  }
12050
13278
  }
12051
13279
  },
@@ -12078,13 +13306,23 @@
12078
13306
  "types": [
12079
13307
  "string"
12080
13308
  ],
12081
- "description": "Emits UI:{playEvent}"
13309
+ "description": "Emits UI:{playEvent}",
13310
+ "kind": "event-ref",
13311
+ "emitPayloadSchema": []
12082
13312
  },
12083
13313
  "completeEvent": {
12084
13314
  "types": [
12085
13315
  "string"
12086
13316
  ],
12087
- "description": "Emits UI:{completeEvent} with { success }"
13317
+ "description": "Emits UI:{completeEvent} with { success }",
13318
+ "kind": "event-ref",
13319
+ "emitPayloadSchema": [
13320
+ {
13321
+ "name": "success",
13322
+ "type": "boolean",
13323
+ "required": true
13324
+ }
13325
+ ]
12088
13326
  }
12089
13327
  }
12090
13328
  },
@@ -12150,7 +13388,18 @@
12150
13388
  "function"
12151
13389
  ],
12152
13390
  "description": "Called when rules change",
12153
- "required": true
13391
+ "required": true,
13392
+ "kind": "callback",
13393
+ "callbackArgs": [
13394
+ {
13395
+ "name": "objectId",
13396
+ "type": "string"
13397
+ },
13398
+ {
13399
+ "name": "rules",
13400
+ "type": "array"
13401
+ }
13402
+ ]
12154
13403
  },
12155
13404
  "disabled": {
12156
13405
  "types": [
@@ -12203,13 +13452,22 @@
12203
13452
  "function"
12204
13453
  ],
12205
13454
  "description": "Called when rule changes",
12206
- "required": true
13455
+ "required": true,
13456
+ "kind": "callback",
13457
+ "callbackArgs": [
13458
+ {
13459
+ "name": "rule",
13460
+ "type": "object"
13461
+ }
13462
+ ]
12207
13463
  },
12208
13464
  "onRemove": {
12209
13465
  "types": [
12210
13466
  "function"
12211
13467
  ],
12212
- "description": "Called when rule is removed"
13468
+ "description": "Called when rule is removed",
13469
+ "kind": "callback",
13470
+ "callbackArgs": []
12213
13471
  },
12214
13472
  "disabled": {
12215
13473
  "types": [
@@ -12247,7 +13505,20 @@
12247
13505
  "types": [
12248
13506
  "string"
12249
13507
  ],
12250
- "description": "completeEvent prop"
13508
+ "description": "completeEvent prop",
13509
+ "kind": "event-ref",
13510
+ "emitPayloadSchema": [
13511
+ {
13512
+ "name": "success",
13513
+ "type": "boolean",
13514
+ "required": true
13515
+ },
13516
+ {
13517
+ "name": "score",
13518
+ "type": "number",
13519
+ "required": true
13520
+ }
13521
+ ]
12251
13522
  }
12252
13523
  }
12253
13524
  },
@@ -12385,14 +13656,32 @@
12385
13656
  "function"
12386
13657
  ],
12387
13658
  "description": "Called when an item is dropped into slot at index",
12388
- "required": true
13659
+ "required": true,
13660
+ "kind": "callback",
13661
+ "callbackArgs": [
13662
+ {
13663
+ "name": "index",
13664
+ "type": "number"
13665
+ },
13666
+ {
13667
+ "name": "item",
13668
+ "type": "object"
13669
+ }
13670
+ ]
12389
13671
  },
12390
13672
  "onSlotRemove": {
12391
13673
  "types": [
12392
13674
  "function"
12393
13675
  ],
12394
13676
  "description": "Called when a slot is cleared",
12395
- "required": true
13677
+ "required": true,
13678
+ "kind": "callback",
13679
+ "callbackArgs": [
13680
+ {
13681
+ "name": "index",
13682
+ "type": "number"
13683
+ }
13684
+ ]
12396
13685
  },
12397
13686
  "playing": {
12398
13687
  "types": [
@@ -12471,13 +13760,34 @@
12471
13760
  "types": [
12472
13761
  "string"
12473
13762
  ],
12474
- "description": "Emits UI:{playEvent} with { sequence: string[] }"
13763
+ "description": "Emits UI:{playEvent} with { sequence: string[] }",
13764
+ "kind": "event-ref",
13765
+ "emitPayloadSchema": [
13766
+ {
13767
+ "name": "sequence",
13768
+ "type": "array",
13769
+ "required": true
13770
+ }
13771
+ ]
12475
13772
  },
12476
13773
  "completeEvent": {
12477
13774
  "types": [
12478
13775
  "string"
12479
13776
  ],
12480
- "description": "Emits UI:{completeEvent} with { success: boolean }"
13777
+ "description": "Emits UI:{completeEvent} with { success: boolean }",
13778
+ "kind": "event-ref",
13779
+ "emitPayloadSchema": [
13780
+ {
13781
+ "name": "success",
13782
+ "type": "boolean",
13783
+ "required": true
13784
+ },
13785
+ {
13786
+ "name": "sequence",
13787
+ "type": "array",
13788
+ "required": true
13789
+ }
13790
+ ]
12481
13791
  }
12482
13792
  }
12483
13793
  },
@@ -12503,7 +13813,20 @@
12503
13813
  "types": [
12504
13814
  "string"
12505
13815
  ],
12506
- "description": "completeEvent prop"
13816
+ "description": "completeEvent prop",
13817
+ "kind": "event-ref",
13818
+ "emitPayloadSchema": [
13819
+ {
13820
+ "name": "success",
13821
+ "type": "boolean",
13822
+ "required": true
13823
+ },
13824
+ {
13825
+ "name": "attempts",
13826
+ "type": "number",
13827
+ "required": true
13828
+ }
13829
+ ]
12507
13830
  }
12508
13831
  }
12509
13832
  },
@@ -12574,13 +13897,28 @@
12574
13897
  "types": [
12575
13898
  "string"
12576
13899
  ],
12577
- "description": "Emits UI:{testEvent}"
13900
+ "description": "Emits UI:{testEvent}",
13901
+ "kind": "event-ref",
13902
+ "emitPayloadSchema": []
12578
13903
  },
12579
13904
  "completeEvent": {
12580
13905
  "types": [
12581
13906
  "string"
12582
13907
  ],
12583
- "description": "Emits UI:{completeEvent} with { success, passedTests }"
13908
+ "description": "Emits UI:{completeEvent} with { success, passedTests }",
13909
+ "kind": "event-ref",
13910
+ "emitPayloadSchema": [
13911
+ {
13912
+ "name": "success",
13913
+ "type": "boolean",
13914
+ "required": true
13915
+ },
13916
+ {
13917
+ "name": "passedTests",
13918
+ "type": "number",
13919
+ "required": true
13920
+ }
13921
+ ]
12584
13922
  }
12585
13923
  }
12586
13924
  },
@@ -12631,7 +13969,9 @@
12631
13969
  "types": [
12632
13970
  "function"
12633
13971
  ],
12634
- "description": "Click handler"
13972
+ "description": "Click handler",
13973
+ "kind": "callback",
13974
+ "callbackArgs": []
12635
13975
  },
12636
13976
  "className": {
12637
13977
  "types": [
@@ -12689,7 +14029,9 @@
12689
14029
  "types": [
12690
14030
  "function"
12691
14031
  ],
12692
- "description": "Click handler"
14032
+ "description": "Click handler",
14033
+ "kind": "callback",
14034
+ "callbackArgs": []
12693
14035
  },
12694
14036
  "className": {
12695
14037
  "types": [
@@ -12760,7 +14102,14 @@
12760
14102
  "types": [
12761
14103
  "function"
12762
14104
  ],
12763
- "description": "Called when the day is clicked"
14105
+ "description": "Called when the day is clicked",
14106
+ "kind": "callback",
14107
+ "callbackArgs": [
14108
+ {
14109
+ "name": "date",
14110
+ "type": "object"
14111
+ }
14112
+ ]
12764
14113
  },
12765
14114
  "className": {
12766
14115
  "types": [
@@ -12805,7 +14154,9 @@
12805
14154
  "types": [
12806
14155
  "function"
12807
14156
  ],
12808
- "description": "Click handler on the outer wrapper"
14157
+ "description": "Click handler on the outer wrapper",
14158
+ "kind": "callback",
14159
+ "callbackArgs": []
12809
14160
  }
12810
14161
  }
12811
14162
  },
@@ -12832,7 +14183,14 @@
12832
14183
  "types": [
12833
14184
  "function"
12834
14185
  ],
12835
- "description": "Called when the slot is clicked"
14186
+ "description": "Called when the slot is clicked",
14187
+ "kind": "callback",
14188
+ "callbackArgs": [
14189
+ {
14190
+ "name": "time",
14191
+ "type": "string"
14192
+ }
14193
+ ]
12836
14194
  },
12837
14195
  "className": {
12838
14196
  "types": [
@@ -12887,19 +14245,44 @@
12887
14245
  "types": [
12888
14246
  "function"
12889
14247
  ],
12890
- "description": "Called when a time slot is clicked"
14248
+ "description": "Called when a time slot is clicked",
14249
+ "kind": "callback",
14250
+ "callbackArgs": [
14251
+ {
14252
+ "name": "day",
14253
+ "type": "object"
14254
+ },
14255
+ {
14256
+ "name": "time",
14257
+ "type": "string"
14258
+ }
14259
+ ]
12891
14260
  },
12892
14261
  "onDayClick": {
12893
14262
  "types": [
12894
14263
  "function"
12895
14264
  ],
12896
- "description": "Called when a day header is clicked"
14265
+ "description": "Called when a day header is clicked",
14266
+ "kind": "callback",
14267
+ "callbackArgs": [
14268
+ {
14269
+ "name": "day",
14270
+ "type": "object"
14271
+ }
14272
+ ]
12897
14273
  },
12898
14274
  "onEventClick": {
12899
14275
  "types": [
12900
14276
  "function"
12901
14277
  ],
12902
- "description": "Called when an event is clicked"
14278
+ "description": "Called when an event is clicked",
14279
+ "kind": "callback",
14280
+ "callbackArgs": [
14281
+ {
14282
+ "name": "event",
14283
+ "type": "object"
14284
+ }
14285
+ ]
12903
14286
  },
12904
14287
  "className": {
12905
14288
  "types": [
@@ -12911,7 +14294,20 @@
12911
14294
  "types": [
12912
14295
  "string"
12913
14296
  ],
12914
- "description": "Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time }"
14297
+ "description": "Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload }",
14298
+ "kind": "event-ref",
14299
+ "emitPayloadSchema": [
14300
+ {
14301
+ "name": "date",
14302
+ "type": "string",
14303
+ "required": true
14304
+ },
14305
+ {
14306
+ "name": "time",
14307
+ "type": "string",
14308
+ "required": false
14309
+ }
14310
+ ]
12915
14311
  },
12916
14312
  "longPressPayload": {
12917
14313
  "types": [
@@ -12923,13 +14319,17 @@
12923
14319
  "types": [
12924
14320
  "string"
12925
14321
  ],
12926
- "description": "Event emitted on swipe left (next week): UI:{swipeLeftEvent}"
14322
+ "description": "Event emitted on swipe left (next week): UI:{swipeLeftEvent}",
14323
+ "kind": "event-ref",
14324
+ "emitPayloadSchema": []
12927
14325
  },
12928
14326
  "swipeRightEvent": {
12929
14327
  "types": [
12930
14328
  "string"
12931
14329
  ],
12932
- "description": "Event emitted on swipe right (prev week): UI:{swipeRightEvent}"
14330
+ "description": "Event emitted on swipe right (prev week): UI:{swipeRightEvent}",
14331
+ "kind": "event-ref",
14332
+ "emitPayloadSchema": []
12933
14333
  }
12934
14334
  }
12935
14335
  },
@@ -12997,7 +14397,14 @@
12997
14397
  "types": [
12998
14398
  "function"
12999
14399
  ],
13000
- "description": "Callback when a range is selected"
14400
+ "description": "Callback when a range is selected",
14401
+ "kind": "callback",
14402
+ "callbackArgs": [
14403
+ {
14404
+ "name": "value",
14405
+ "type": "string"
14406
+ }
14407
+ ]
13001
14408
  },
13002
14409
  "className": {
13003
14410
  "types": [
@@ -13042,7 +14449,9 @@
13042
14449
  "types": [
13043
14450
  "function"
13044
14451
  ],
13045
- "description": "Callback when the card is clicked to flip"
14452
+ "description": "Callback when the card is clicked to flip",
14453
+ "kind": "callback",
14454
+ "callbackArgs": []
13046
14455
  },
13047
14456
  "className": {
13048
14457
  "types": [
@@ -13087,13 +14496,27 @@
13087
14496
  "types": [
13088
14497
  "function"
13089
14498
  ],
13090
- "description": "Callback when a node is clicked"
14499
+ "description": "Callback when a node is clicked",
14500
+ "kind": "callback",
14501
+ "callbackArgs": [
14502
+ {
14503
+ "name": "node",
14504
+ "type": "object"
14505
+ }
14506
+ ]
13091
14507
  },
13092
14508
  "onNodeHover": {
13093
14509
  "types": [
13094
14510
  "function"
13095
14511
  ],
13096
- "description": "Callback when a node is hovered (null on leave)"
14512
+ "description": "Callback when a node is hovered (null on leave)",
14513
+ "kind": "callback",
14514
+ "callbackArgs": [
14515
+ {
14516
+ "name": "node",
14517
+ "type": "object"
14518
+ }
14519
+ ]
13097
14520
  },
13098
14521
  "width": {
13099
14522
  "types": [
@@ -13224,13 +14647,27 @@
13224
14647
  "types": [
13225
14648
  "function"
13226
14649
  ],
13227
- "description": "Custom state resolver per dot index"
14650
+ "description": "Custom state resolver per dot index",
14651
+ "kind": "callback",
14652
+ "callbackArgs": [
14653
+ {
14654
+ "name": "index",
14655
+ "type": "number"
14656
+ }
14657
+ ]
13228
14658
  },
13229
14659
  "onDotClick": {
13230
14660
  "types": [
13231
14661
  "function"
13232
14662
  ],
13233
- "description": "Callback when a dot is clicked"
14663
+ "description": "Callback when a dot is clicked",
14664
+ "kind": "callback",
14665
+ "callbackArgs": [
14666
+ {
14667
+ "name": "index",
14668
+ "type": "number"
14669
+ }
14670
+ ]
13234
14671
  },
13235
14672
  "className": {
13236
14673
  "types": [
@@ -13370,13 +14807,35 @@
13370
14807
  "types": [
13371
14808
  "function"
13372
14809
  ],
13373
- "description": "Render prop for custom per-card content, typed to the grid's entity shape `T`. When provided, `fields` and `itemActions` are ignored."
14810
+ "description": "Render prop for custom per-card content, typed to the grid's entity shape `T`. When provided, `fields` and `itemActions` are ignored.",
14811
+ "kind": "callback",
14812
+ "callbackArgs": [
14813
+ {
14814
+ "name": "item",
14815
+ "type": "object"
14816
+ },
14817
+ {
14818
+ "name": "index",
14819
+ "type": "number"
14820
+ }
14821
+ ]
13374
14822
  },
13375
14823
  "renderItem": {
13376
14824
  "types": [
13377
14825
  "function"
13378
14826
  ],
13379
- "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync."
14827
+ "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync.",
14828
+ "kind": "callback",
14829
+ "callbackArgs": [
14830
+ {
14831
+ "name": "item",
14832
+ "type": "object"
14833
+ },
14834
+ {
14835
+ "name": "index",
14836
+ "type": "number"
14837
+ }
14838
+ ]
13380
14839
  },
13381
14840
  "pageSize": {
13382
14841
  "types": [
@@ -13549,13 +15008,35 @@
13549
15008
  "types": [
13550
15009
  "function"
13551
15010
  ],
13552
- "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored."
15011
+ "description": "Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored.",
15012
+ "kind": "callback",
15013
+ "callbackArgs": [
15014
+ {
15015
+ "name": "item",
15016
+ "type": "object"
15017
+ },
15018
+ {
15019
+ "name": "index",
15020
+ "type": "number"
15021
+ }
15022
+ ]
13553
15023
  },
13554
15024
  "renderItem": {
13555
15025
  "types": [
13556
15026
  "function"
13557
15027
  ],
13558
- "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync."
15028
+ "description": "Per-item render function (schema-level alias for children render prop). In .orb schemas: [\"fn\", \"item\", { pattern tree with @item.field bindings }] The compiler converts this to the children render prop. @deprecated Use children render prop in React code. This prop exists for pattern registry sync.",
15029
+ "kind": "callback",
15030
+ "callbackArgs": [
15031
+ {
15032
+ "name": "item",
15033
+ "type": "object"
15034
+ },
15035
+ {
15036
+ "name": "index",
15037
+ "type": "number"
15038
+ }
15039
+ ]
13559
15040
  },
13560
15041
  "pageSize": {
13561
15042
  "types": [
@@ -13652,25 +15133,45 @@
13652
15133
  "types": [
13653
15134
  "string"
13654
15135
  ],
13655
- "description": "Event names for keyboard controls"
15136
+ "description": "Event names for keyboard controls",
15137
+ "kind": "event-ref",
15138
+ "emitPayloadSchema": [
15139
+ {
15140
+ "name": "direction",
15141
+ "type": "number",
15142
+ "required": true
15143
+ }
15144
+ ]
13656
15145
  },
13657
15146
  "rightEvent": {
13658
15147
  "types": [
13659
15148
  "string"
13660
15149
  ],
13661
- "description": "rightEvent prop"
15150
+ "description": "rightEvent prop",
15151
+ "kind": "event-ref",
15152
+ "emitPayloadSchema": [
15153
+ {
15154
+ "name": "direction",
15155
+ "type": "number",
15156
+ "required": true
15157
+ }
15158
+ ]
13662
15159
  },
13663
15160
  "jumpEvent": {
13664
15161
  "types": [
13665
15162
  "string"
13666
15163
  ],
13667
- "description": "jumpEvent prop"
15164
+ "description": "jumpEvent prop",
15165
+ "kind": "event-ref",
15166
+ "emitPayloadSchema": []
13668
15167
  },
13669
15168
  "stopEvent": {
13670
15169
  "types": [
13671
15170
  "string"
13672
15171
  ],
13673
- "description": "stopEvent prop"
15172
+ "description": "stopEvent prop",
15173
+ "kind": "event-ref",
15174
+ "emitPayloadSchema": []
13674
15175
  },
13675
15176
  "className": {
13676
15177
  "types": [
@@ -13725,25 +15226,84 @@
13725
15226
  "types": [
13726
15227
  "function"
13727
15228
  ],
13728
- "description": "Callback when a marker is clicked (programmatic use)"
15229
+ "description": "Callback when a marker is clicked (programmatic use)",
15230
+ "kind": "callback",
15231
+ "callbackArgs": [
15232
+ {
15233
+ "name": "marker",
15234
+ "type": "object"
15235
+ }
15236
+ ]
13729
15237
  },
13730
15238
  "onMapClick": {
13731
15239
  "types": [
13732
15240
  "function"
13733
15241
  ],
13734
- "description": "Callback when the map is clicked (programmatic use)"
15242
+ "description": "Callback when the map is clicked (programmatic use)",
15243
+ "kind": "callback",
15244
+ "callbackArgs": [
15245
+ {
15246
+ "name": "lat",
15247
+ "type": "number"
15248
+ },
15249
+ {
15250
+ "name": "lng",
15251
+ "type": "number"
15252
+ }
15253
+ ]
13735
15254
  },
13736
15255
  "mapClickEvent": {
13737
15256
  "types": [
13738
15257
  "string"
13739
15258
  ],
13740
- "description": "Event name dispatched via event bus when the map is clicked. Payload: { latitude, longitude }"
15259
+ "description": "Event name dispatched via event bus when the map is clicked. Payload: { latitude, longitude }",
15260
+ "kind": "event-ref",
15261
+ "emitPayloadSchema": [
15262
+ {
15263
+ "name": "latitude",
15264
+ "type": "number",
15265
+ "required": true
15266
+ },
15267
+ {
15268
+ "name": "longitude",
15269
+ "type": "number",
15270
+ "required": true
15271
+ }
15272
+ ]
13741
15273
  },
13742
15274
  "markerClickEvent": {
13743
15275
  "types": [
13744
15276
  "string"
13745
15277
  ],
13746
- "description": "Event name dispatched via event bus when a marker is clicked. Payload: marker data"
15278
+ "description": "Event name dispatched via event bus when a marker is clicked. Payload: full MapMarkerData spread.",
15279
+ "kind": "event-ref",
15280
+ "emitPayloadSchema": [
15281
+ {
15282
+ "name": "id",
15283
+ "type": "string",
15284
+ "required": true
15285
+ },
15286
+ {
15287
+ "name": "lat",
15288
+ "type": "number",
15289
+ "required": true
15290
+ },
15291
+ {
15292
+ "name": "lng",
15293
+ "type": "number",
15294
+ "required": true
15295
+ },
15296
+ {
15297
+ "name": "label",
15298
+ "type": "string",
15299
+ "required": false
15300
+ },
15301
+ {
15302
+ "name": "category",
15303
+ "type": "string",
15304
+ "required": false
15305
+ }
15306
+ ]
13747
15307
  },
13748
15308
  "showClickedPin": {
13749
15309
  "types": [
@@ -13852,13 +15412,27 @@
13852
15412
  "types": [
13853
15413
  "function"
13854
15414
  ],
13855
- "description": "Direct onChange callback"
15415
+ "description": "Direct onChange callback",
15416
+ "kind": "callback",
15417
+ "callbackArgs": [
15418
+ {
15419
+ "name": "value",
15420
+ "type": "number"
15421
+ }
15422
+ ]
13856
15423
  },
13857
15424
  "formatValue": {
13858
15425
  "types": [
13859
15426
  "function"
13860
15427
  ],
13861
- "description": "Format function for tooltip display"
15428
+ "description": "Format function for tooltip display",
15429
+ "kind": "callback",
15430
+ "callbackArgs": [
15431
+ {
15432
+ "name": "value",
15433
+ "type": "number"
15434
+ }
15435
+ ]
13862
15436
  }
13863
15437
  }
13864
15438
  },
@@ -14015,13 +15589,22 @@
14015
15589
  "types": [
14016
15590
  "function"
14017
15591
  ],
14018
- "description": "Direct onClose callback"
15592
+ "description": "Direct onClose callback",
15593
+ "kind": "callback",
15594
+ "callbackArgs": []
14019
15595
  },
14020
15596
  "onIndexChange": {
14021
15597
  "types": [
14022
15598
  "function"
14023
15599
  ],
14024
- "description": "Direct onIndexChange callback"
15600
+ "description": "Direct onIndexChange callback",
15601
+ "kind": "callback",
15602
+ "callbackArgs": [
15603
+ {
15604
+ "name": "index",
15605
+ "type": "number"
15606
+ }
15607
+ ]
14025
15608
  },
14026
15609
  "className": {
14027
15610
  "types": [
@@ -14087,7 +15670,14 @@
14087
15670
  "types": [
14088
15671
  "function"
14089
15672
  ],
14090
- "description": "Direct onChange callback"
15673
+ "description": "Direct onChange callback",
15674
+ "kind": "callback",
15675
+ "callbackArgs": [
15676
+ {
15677
+ "name": "value",
15678
+ "type": "number"
15679
+ }
15680
+ ]
14091
15681
  },
14092
15682
  "action": {
14093
15683
  "types": [
@@ -14183,7 +15773,14 @@
14183
15773
  "types": [
14184
15774
  "function"
14185
15775
  ],
14186
- "description": "Direct onChange callback"
15776
+ "description": "Direct onChange callback",
15777
+ "kind": "callback",
15778
+ "callbackArgs": [
15779
+ {
15780
+ "name": "value",
15781
+ "type": "number"
15782
+ }
15783
+ ]
14187
15784
  },
14188
15785
  "className": {
14189
15786
  "types": [
@@ -14270,7 +15867,14 @@
14270
15867
  "types": [
14271
15868
  "function"
14272
15869
  ],
14273
- "description": "Direct onFiles callback"
15870
+ "description": "Direct onFiles callback",
15871
+ "kind": "callback",
15872
+ "callbackArgs": [
15873
+ {
15874
+ "name": "files",
15875
+ "type": "array"
15876
+ }
15877
+ ]
14274
15878
  },
14275
15879
  "className": {
14276
15880
  "types": [
@@ -14455,7 +16059,9 @@
14455
16059
  "types": [
14456
16060
  "function"
14457
16061
  ],
14458
- "description": "Called when the entire text has been revealed"
16062
+ "description": "Called when the entire text has been revealed",
16063
+ "kind": "callback",
16064
+ "callbackArgs": []
14459
16065
  }
14460
16066
  }
14461
16067
  },
@@ -14479,13 +16085,35 @@
14479
16085
  "types": [
14480
16086
  "function"
14481
16087
  ],
14482
- "description": "Render function for each slide"
16088
+ "description": "Render function for each slide",
16089
+ "kind": "callback",
16090
+ "callbackArgs": [
16091
+ {
16092
+ "name": "item",
16093
+ "type": "object"
16094
+ },
16095
+ {
16096
+ "name": "index",
16097
+ "type": "number"
16098
+ }
16099
+ ]
14483
16100
  },
14484
16101
  "children": {
14485
16102
  "types": [
14486
16103
  "function"
14487
16104
  ],
14488
- "description": "Children-as-function fallback for renderItem (compiler compatibility)"
16105
+ "description": "Children-as-function fallback for renderItem (compiler compatibility)",
16106
+ "kind": "callback",
16107
+ "callbackArgs": [
16108
+ {
16109
+ "name": "item",
16110
+ "type": "object"
16111
+ },
16112
+ {
16113
+ "name": "index",
16114
+ "type": "number"
16115
+ }
16116
+ ]
14489
16117
  },
14490
16118
  "autoPlay": {
14491
16119
  "types": [
@@ -14521,7 +16149,15 @@
14521
16149
  "types": [
14522
16150
  "string"
14523
16151
  ],
14524
- "description": "Declarative event name for slide change"
16152
+ "description": "Declarative event name for slide change",
16153
+ "kind": "event-ref",
16154
+ "emitPayloadSchema": [
16155
+ {
16156
+ "name": "index",
16157
+ "type": "number",
16158
+ "required": true
16159
+ }
16160
+ ]
14525
16161
  },
14526
16162
  "slideChangePayload": {
14527
16163
  "types": [
@@ -14606,7 +16242,18 @@
14606
16242
  "function"
14607
16243
  ],
14608
16244
  "description": "renderItem prop",
14609
- "required": true
16245
+ "required": true,
16246
+ "kind": "callback",
16247
+ "callbackArgs": [
16248
+ {
16249
+ "name": "item",
16250
+ "type": "object"
16251
+ },
16252
+ {
16253
+ "name": "index",
16254
+ "type": "number"
16255
+ }
16256
+ ]
14610
16257
  },
14611
16258
  "reorderEvent": {
14612
16259
  "types": [
@@ -14893,7 +16540,9 @@
14893
16540
  "types": [
14894
16541
  "function"
14895
16542
  ],
14896
- "description": "Click handler"
16543
+ "description": "Click handler",
16544
+ "kind": "callback",
16545
+ "callbackArgs": []
14897
16546
  },
14898
16547
  "className": {
14899
16548
  "types": [
@@ -14943,7 +16592,9 @@
14943
16592
  "types": [
14944
16593
  "function"
14945
16594
  ],
14946
- "description": "Click handler"
16595
+ "description": "Click handler",
16596
+ "kind": "callback",
16597
+ "callbackArgs": []
14947
16598
  },
14948
16599
  "className": {
14949
16600
  "types": [
@@ -15168,7 +16819,9 @@
15168
16819
  "types": [
15169
16820
  "function"
15170
16821
  ],
15171
- "description": "Click handler"
16822
+ "description": "Click handler",
16823
+ "kind": "callback",
16824
+ "callbackArgs": []
15172
16825
  },
15173
16826
  "className": {
15174
16827
  "types": [
@@ -15571,13 +17224,23 @@
15571
17224
  "types": [
15572
17225
  "function"
15573
17226
  ],
15574
- "description": "Callback when the craft button is clicked"
17227
+ "description": "Callback when the craft button is clicked",
17228
+ "kind": "callback",
17229
+ "callbackArgs": []
15575
17230
  },
15576
17231
  "craftEvent": {
15577
17232
  "types": [
15578
17233
  "string"
15579
17234
  ],
15580
- "description": "Event bus event name for crafting"
17235
+ "description": "Event bus event name for crafting",
17236
+ "kind": "event-ref",
17237
+ "emitPayloadSchema": [
17238
+ {
17239
+ "name": "output",
17240
+ "type": "string",
17241
+ "required": true
17242
+ }
17243
+ ]
15581
17244
  },
15582
17245
  "className": {
15583
17246
  "types": [
@@ -15747,13 +17410,28 @@
15747
17410
  "types": [
15748
17411
  "function"
15749
17412
  ],
15750
- "description": "Callback when an item is selected"
17413
+ "description": "Callback when an item is selected",
17414
+ "kind": "callback",
17415
+ "callbackArgs": [
17416
+ {
17417
+ "name": "id",
17418
+ "type": "string"
17419
+ }
17420
+ ]
15751
17421
  },
15752
17422
  "selectEvent": {
15753
17423
  "types": [
15754
17424
  "string"
15755
17425
  ],
15756
- "description": "Event bus event name for selection"
17426
+ "description": "Event bus event name for selection",
17427
+ "kind": "event-ref",
17428
+ "emitPayloadSchema": [
17429
+ {
17430
+ "name": "id",
17431
+ "type": "string",
17432
+ "required": true
17433
+ }
17434
+ ]
15757
17435
  },
15758
17436
  "size": {
15759
17437
  "types": [
@@ -17956,7 +19634,14 @@
17956
19634
  "types": [
17957
19635
  "function"
17958
19636
  ],
17959
- "description": "Callback invoked with the search query, returns results"
19637
+ "description": "Callback invoked with the search query, returns results",
19638
+ "kind": "callback",
19639
+ "callbackArgs": [
19640
+ {
19641
+ "name": "query",
19642
+ "type": "string"
19643
+ }
19644
+ ]
17960
19645
  },
17961
19646
  "className": {
17962
19647
  "types": [
@@ -19986,13 +21671,22 @@
19986
21671
  "function"
19987
21672
  ],
19988
21673
  "description": "Click handler",
19989
- "required": true
21674
+ "required": true,
21675
+ "kind": "callback",
21676
+ "callbackArgs": []
19990
21677
  },
19991
21678
  "onHover": {
19992
21679
  "types": [
19993
21680
  "function"
19994
21681
  ],
19995
- "description": "Hover callback"
21682
+ "description": "Hover callback",
21683
+ "kind": "callback",
21684
+ "callbackArgs": [
21685
+ {
21686
+ "name": "hovering",
21687
+ "type": "boolean"
21688
+ }
21689
+ ]
19996
21690
  },
19997
21691
  "cursor": {
19998
21692
  "types": [
@@ -20075,7 +21769,18 @@
20075
21769
  "types": [
20076
21770
  "function"
20077
21771
  ],
20078
- "description": "Callback when zoom level changes"
21772
+ "description": "Callback when zoom level changes",
21773
+ "kind": "callback",
21774
+ "callbackArgs": [
21775
+ {
21776
+ "name": "level",
21777
+ "type": "object"
21778
+ },
21779
+ {
21780
+ "name": "context",
21781
+ "type": "object"
21782
+ }
21783
+ ]
20079
21784
  },
20080
21785
  "width": {
20081
21786
  "types": [
@@ -20172,7 +21877,18 @@
20172
21877
  "types": [
20173
21878
  "function"
20174
21879
  ],
20175
- "description": "onTransitionClick prop"
21880
+ "description": "onTransitionClick prop",
21881
+ "kind": "callback",
21882
+ "callbackArgs": [
21883
+ {
21884
+ "name": "transitionIndex",
21885
+ "type": "number"
21886
+ },
21887
+ {
21888
+ "name": "position",
21889
+ "type": "object"
21890
+ }
21891
+ ]
20176
21892
  }
20177
21893
  }
20178
21894
  },
@@ -20828,7 +22544,9 @@
20828
22544
  "types": [
20829
22545
  "function"
20830
22546
  ],
20831
- "description": "Click handler"
22547
+ "description": "Click handler",
22548
+ "kind": "callback",
22549
+ "callbackArgs": []
20832
22550
  }
20833
22551
  }
20834
22552
  },
@@ -20960,7 +22678,9 @@
20960
22678
  "types": [
20961
22679
  "function"
20962
22680
  ],
20963
- "description": "onTransitionClick prop"
22681
+ "description": "onTransitionClick prop",
22682
+ "kind": "callback",
22683
+ "callbackArgs": []
20964
22684
  }
20965
22685
  }
20966
22686
  },
@@ -21120,19 +22840,44 @@
21120
22840
  "types": [
21121
22841
  "function"
21122
22842
  ],
21123
- "description": "onNodeClick prop"
22843
+ "description": "onNodeClick prop",
22844
+ "kind": "callback",
22845
+ "callbackArgs": [
22846
+ {
22847
+ "name": "context",
22848
+ "type": "object"
22849
+ }
22850
+ ]
21124
22851
  },
21125
22852
  "onLevelChange": {
21126
22853
  "types": [
21127
22854
  "function"
21128
22855
  ],
21129
- "description": "onLevelChange prop"
22856
+ "description": "onLevelChange prop",
22857
+ "kind": "callback",
22858
+ "callbackArgs": [
22859
+ {
22860
+ "name": "level",
22861
+ "type": "object"
22862
+ },
22863
+ {
22864
+ "name": "orbital",
22865
+ "type": "string"
22866
+ }
22867
+ ]
21130
22868
  },
21131
22869
  "onOrbitalDoubleClick": {
21132
22870
  "types": [
21133
22871
  "function"
21134
22872
  ],
21135
- "description": "GAP-52: fired when the user double-clicks an orbital. Consumers (e.g. the builder workspace) use this as the trigger to enter cosmic mode (`AvlOrbitalsCosmicZoom`) for the focused orbital. The level at which this fires is controlled by `cosmicEntryLevel` (default `'expanded'`). At `'expanded'` the existing overview→expanded drill is preserved — the callback fires only on the second double-click. At `'overview'` the callback fires on the FIRST double-click and the existing drill is suppressed for that interaction. `'both'` fires at either level. The callback runs unconditionally — persona / permission gating is the consumer's responsibility."
22873
+ "description": "GAP-52: fired when the user double-clicks an orbital. Consumers (e.g. the builder workspace) use this as the trigger to enter cosmic mode (`AvlOrbitalsCosmicZoom`) for the focused orbital. The level at which this fires is controlled by `cosmicEntryLevel` (default `'expanded'`). At `'expanded'` the existing overview→expanded drill is preserved — the callback fires only on the second double-click. At `'overview'` the callback fires on the FIRST double-click and the existing drill is suppressed for that interaction. `'both'` fires at either level. The callback runs unconditionally — persona / permission gating is the consumer's responsibility.",
22874
+ "kind": "callback",
22875
+ "callbackArgs": [
22876
+ {
22877
+ "name": "orbital",
22878
+ "type": "string"
22879
+ }
22880
+ ]
21136
22881
  },
21137
22882
  "cosmicEntryLevel": {
21138
22883
  "types": [
@@ -21173,19 +22918,40 @@
21173
22918
  "types": [
21174
22919
  "function"
21175
22920
  ],
21176
- "description": "Called when the user edits the schema via the inspector."
22921
+ "description": "Called when the user edits the schema via the inspector.",
22922
+ "kind": "callback",
22923
+ "callbackArgs": [
22924
+ {
22925
+ "name": "schema",
22926
+ "type": "object"
22927
+ }
22928
+ ]
21177
22929
  },
21178
22930
  "onPatternDelete": {
21179
22931
  "types": [
21180
22932
  "function"
21181
22933
  ],
21182
- "description": "Called when the user presses Delete/Backspace with a pattern selected."
22934
+ "description": "Called when the user presses Delete/Backspace with a pattern selected.",
22935
+ "kind": "callback",
22936
+ "callbackArgs": [
22937
+ {
22938
+ "name": "context",
22939
+ "type": "object"
22940
+ }
22941
+ ]
21183
22942
  },
21184
22943
  "onEventWire": {
21185
22944
  "types": [
21186
22945
  "function"
21187
22946
  ],
21188
- "description": "Called when the user drags from a source handle to a target handle (event wiring)."
22947
+ "description": "Called when the user drags from a source handle to a target handle (event wiring).",
22948
+ "kind": "callback",
22949
+ "callbackArgs": [
22950
+ {
22951
+ "name": "wire",
22952
+ "type": "object"
22953
+ }
22954
+ ]
21189
22955
  },
21190
22956
  "behaviorMeta": {
21191
22957
  "types": [
@@ -21207,7 +22973,14 @@
21207
22973
  "types": [
21208
22974
  "function"
21209
22975
  ],
21210
- "description": "Called when the user clicks a node in overview level (for composition hints)."
22976
+ "description": "Called when the user clicks a node in overview level (for composition hints).",
22977
+ "kind": "callback",
22978
+ "callbackArgs": [
22979
+ {
22980
+ "name": "orbitalName",
22981
+ "type": "string"
22982
+ }
22983
+ ]
21211
22984
  },
21212
22985
  "composeLevel": {
21213
22986
  "types": [
@@ -21231,7 +23004,18 @@
21231
23004
  "types": [
21232
23005
  "function"
21233
23006
  ],
21234
- "description": "@deprecated Use onNodeClick instead. Kept for AvlCosmicZoom compat."
23007
+ "description": "@deprecated Use onNodeClick instead. Kept for AvlCosmicZoom compat.",
23008
+ "kind": "callback",
23009
+ "callbackArgs": [
23010
+ {
23011
+ "name": "level",
23012
+ "type": "string"
23013
+ },
23014
+ {
23015
+ "name": "context",
23016
+ "type": "object"
23017
+ }
23018
+ ]
21235
23019
  },
21236
23020
  "focusTarget": {
21237
23021
  "types": [
@@ -21787,7 +23571,9 @@
21787
23571
  "types": [
21788
23572
  "function"
21789
23573
  ],
21790
- "description": "Click handler"
23574
+ "description": "Click handler",
23575
+ "kind": "callback",
23576
+ "callbackArgs": []
21791
23577
  },
21792
23578
  "className": {
21793
23579
  "types": [
@@ -21845,7 +23631,9 @@
21845
23631
  "types": [
21846
23632
  "function"
21847
23633
  ],
21848
- "description": "Click handler"
23634
+ "description": "Click handler",
23635
+ "kind": "callback",
23636
+ "callbackArgs": []
21849
23637
  },
21850
23638
  "incomingCount": {
21851
23639
  "types": [
@@ -21954,7 +23742,9 @@
21954
23742
  "types": [
21955
23743
  "function"
21956
23744
  ],
21957
- "description": "Click handler"
23745
+ "description": "Click handler",
23746
+ "kind": "callback",
23747
+ "callbackArgs": []
21958
23748
  },
21959
23749
  "color": {
21960
23750
  "types": [
@@ -21997,13 +23787,31 @@
21997
23787
  "types": [
21998
23788
  "function"
21999
23789
  ],
22000
- "description": "Called each frame with the 2D context and current frame count"
23790
+ "description": "Called each frame with the 2D context and current frame count",
23791
+ "kind": "callback",
23792
+ "callbackArgs": [
23793
+ {
23794
+ "name": "ctx",
23795
+ "type": "object"
23796
+ },
23797
+ {
23798
+ "name": "frame",
23799
+ "type": "number"
23800
+ }
23801
+ ]
22001
23802
  },
22002
23803
  "onTick": {
22003
23804
  "types": [
22004
23805
  "function"
22005
23806
  ],
22006
- "description": "Called each tick with delta time in seconds"
23807
+ "description": "Called each tick with delta time in seconds",
23808
+ "kind": "callback",
23809
+ "callbackArgs": [
23810
+ {
23811
+ "name": "dt",
23812
+ "type": "number"
23813
+ }
23814
+ ]
22007
23815
  },
22008
23816
  "fps": {
22009
23817
  "types": [
@@ -22108,7 +23916,14 @@
22108
23916
  "types": [
22109
23917
  "function"
22110
23918
  ],
22111
- "description": "Click handler for an orbital"
23919
+ "description": "Click handler for an orbital",
23920
+ "kind": "callback",
23921
+ "callbackArgs": [
23922
+ {
23923
+ "name": "orbitalName",
23924
+ "type": "string"
23925
+ }
23926
+ ]
22112
23927
  },
22113
23928
  "color": {
22114
23929
  "types": [
@@ -22167,7 +23982,14 @@
22167
23982
  "types": [
22168
23983
  "function"
22169
23984
  ],
22170
- "description": "Click handler for a trait"
23985
+ "description": "Click handler for a trait",
23986
+ "kind": "callback",
23987
+ "callbackArgs": [
23988
+ {
23989
+ "name": "traitName",
23990
+ "type": "string"
23991
+ }
23992
+ ]
22171
23993
  },
22172
23994
  "highlightedTrait": {
22173
23995
  "types": [
@@ -22179,7 +24001,14 @@
22179
24001
  "types": [
22180
24002
  "function"
22181
24003
  ],
22182
- "description": "Highlight change handler"
24004
+ "description": "Highlight change handler",
24005
+ "kind": "callback",
24006
+ "callbackArgs": [
24007
+ {
24008
+ "name": "traitName",
24009
+ "type": "string"
24010
+ }
24011
+ ]
22183
24012
  },
22184
24013
  "color": {
22185
24014
  "types": [
@@ -22212,7 +24041,14 @@
22212
24041
  "types": [
22213
24042
  "function"
22214
24043
  ],
22215
- "description": "Click handler for a transition"
24044
+ "description": "Click handler for a transition",
24045
+ "kind": "callback",
24046
+ "callbackArgs": [
24047
+ {
24048
+ "name": "transitionIndex",
24049
+ "type": "number"
24050
+ }
24051
+ ]
22216
24052
  },
22217
24053
  "color": {
22218
24054
  "types": [
@@ -22296,7 +24132,18 @@
22296
24132
  "types": [
22297
24133
  "function"
22298
24134
  ],
22299
- "description": "Callback when zoom level changes"
24135
+ "description": "Callback when zoom level changes",
24136
+ "kind": "callback",
24137
+ "callbackArgs": [
24138
+ {
24139
+ "name": "level",
24140
+ "type": "object"
24141
+ },
24142
+ {
24143
+ "name": "context",
24144
+ "type": "object"
24145
+ }
24146
+ ]
22300
24147
  },
22301
24148
  "width": {
22302
24149
  "types": [
@@ -22463,37 +24310,99 @@
22463
24310
  "types": [
22464
24311
  "function"
22465
24312
  ],
22466
- "description": "Callback when a tile is clicked"
24313
+ "description": "Callback when a tile is clicked",
24314
+ "kind": "callback",
24315
+ "callbackArgs": [
24316
+ {
24317
+ "name": "tile",
24318
+ "type": "object"
24319
+ },
24320
+ {
24321
+ "name": "event",
24322
+ "type": "object"
24323
+ }
24324
+ ]
22467
24325
  },
22468
24326
  "onUnitClick": {
22469
24327
  "types": [
22470
24328
  "function"
22471
24329
  ],
22472
- "description": "Callback when a unit is clicked"
24330
+ "description": "Callback when a unit is clicked",
24331
+ "kind": "callback",
24332
+ "callbackArgs": [
24333
+ {
24334
+ "name": "unit",
24335
+ "type": "object"
24336
+ },
24337
+ {
24338
+ "name": "event",
24339
+ "type": "object"
24340
+ }
24341
+ ]
22473
24342
  },
22474
24343
  "onFeatureClick": {
22475
24344
  "types": [
22476
24345
  "function"
22477
24346
  ],
22478
- "description": "Callback when a feature is clicked"
24347
+ "description": "Callback when a feature is clicked",
24348
+ "kind": "callback",
24349
+ "callbackArgs": [
24350
+ {
24351
+ "name": "feature",
24352
+ "type": "object"
24353
+ },
24354
+ {
24355
+ "name": "event",
24356
+ "type": "object"
24357
+ }
24358
+ ]
22479
24359
  },
22480
24360
  "onCanvasClick": {
22481
24361
  "types": [
22482
24362
  "function"
22483
24363
  ],
22484
- "description": "Callback when canvas is clicked (background)"
24364
+ "description": "Callback when canvas is clicked (background)",
24365
+ "kind": "callback",
24366
+ "callbackArgs": [
24367
+ {
24368
+ "name": "event",
24369
+ "type": "object"
24370
+ }
24371
+ ]
22485
24372
  },
22486
24373
  "onTileHover": {
22487
24374
  "types": [
22488
24375
  "function"
22489
24376
  ],
22490
- "description": "Callback when mouse moves over a tile"
24377
+ "description": "Callback when mouse moves over a tile",
24378
+ "kind": "callback",
24379
+ "callbackArgs": [
24380
+ {
24381
+ "name": "tile",
24382
+ "type": "object"
24383
+ },
24384
+ {
24385
+ "name": "event",
24386
+ "type": "object"
24387
+ }
24388
+ ]
22491
24389
  },
22492
24390
  "onUnitAnimation": {
22493
24391
  "types": [
22494
24392
  "function"
22495
24393
  ],
22496
- "description": "Callback for unit animation state change"
24394
+ "description": "Callback for unit animation state change",
24395
+ "kind": "callback",
24396
+ "callbackArgs": [
24397
+ {
24398
+ "name": "unitId",
24399
+ "type": "string"
24400
+ },
24401
+ {
24402
+ "name": "state",
24403
+ "type": "string"
24404
+ }
24405
+ ]
22497
24406
  },
22498
24407
  "assetLoader": {
22499
24408
  "types": [
@@ -22529,49 +24438,232 @@
22529
24438
  "types": [
22530
24439
  "string"
22531
24440
  ],
22532
- "description": "Declarative event: tile click"
24441
+ "description": "Declarative event: tile click",
24442
+ "kind": "event-ref",
24443
+ "emitPayloadSchema": [
24444
+ {
24445
+ "name": "tileId",
24446
+ "type": "string",
24447
+ "required": true
24448
+ },
24449
+ {
24450
+ "name": "x",
24451
+ "type": "number",
24452
+ "required": true
24453
+ },
24454
+ {
24455
+ "name": "z",
24456
+ "type": "number",
24457
+ "required": true
24458
+ },
24459
+ {
24460
+ "name": "type",
24461
+ "type": "string",
24462
+ "required": false
24463
+ },
24464
+ {
24465
+ "name": "terrain",
24466
+ "type": "string",
24467
+ "required": false
24468
+ },
24469
+ {
24470
+ "name": "elevation",
24471
+ "type": "number",
24472
+ "required": false
24473
+ }
24474
+ ]
22533
24475
  },
22534
24476
  "unitClickEvent": {
22535
24477
  "types": [
22536
24478
  "string"
22537
24479
  ],
22538
- "description": "Declarative event: unit click"
24480
+ "description": "Declarative event: unit click",
24481
+ "kind": "event-ref",
24482
+ "emitPayloadSchema": [
24483
+ {
24484
+ "name": "unitId",
24485
+ "type": "string",
24486
+ "required": true
24487
+ },
24488
+ {
24489
+ "name": "x",
24490
+ "type": "number",
24491
+ "required": true
24492
+ },
24493
+ {
24494
+ "name": "z",
24495
+ "type": "number",
24496
+ "required": true
24497
+ },
24498
+ {
24499
+ "name": "unitType",
24500
+ "type": "string",
24501
+ "required": false
24502
+ },
24503
+ {
24504
+ "name": "name",
24505
+ "type": "string",
24506
+ "required": false
24507
+ },
24508
+ {
24509
+ "name": "team",
24510
+ "type": "string",
24511
+ "required": false
24512
+ },
24513
+ {
24514
+ "name": "faction",
24515
+ "type": "string",
24516
+ "required": false
24517
+ },
24518
+ {
24519
+ "name": "health",
24520
+ "type": "number",
24521
+ "required": false
24522
+ },
24523
+ {
24524
+ "name": "maxHealth",
24525
+ "type": "number",
24526
+ "required": false
24527
+ }
24528
+ ]
22539
24529
  },
22540
24530
  "featureClickEvent": {
22541
24531
  "types": [
22542
24532
  "string"
22543
24533
  ],
22544
- "description": "Declarative event: feature click"
24534
+ "description": "Declarative event: feature click",
24535
+ "kind": "event-ref",
24536
+ "emitPayloadSchema": [
24537
+ {
24538
+ "name": "featureId",
24539
+ "type": "string",
24540
+ "required": true
24541
+ },
24542
+ {
24543
+ "name": "x",
24544
+ "type": "number",
24545
+ "required": true
24546
+ },
24547
+ {
24548
+ "name": "z",
24549
+ "type": "number",
24550
+ "required": true
24551
+ },
24552
+ {
24553
+ "name": "type",
24554
+ "type": "string",
24555
+ "required": false
24556
+ },
24557
+ {
24558
+ "name": "elevation",
24559
+ "type": "number",
24560
+ "required": false
24561
+ }
24562
+ ]
22545
24563
  },
22546
24564
  "canvasClickEvent": {
22547
24565
  "types": [
22548
24566
  "string"
22549
24567
  ],
22550
- "description": "Declarative event: canvas click"
24568
+ "description": "Declarative event: canvas click",
24569
+ "kind": "event-ref",
24570
+ "emitPayloadSchema": [
24571
+ {
24572
+ "name": "clientX",
24573
+ "type": "number",
24574
+ "required": true
24575
+ },
24576
+ {
24577
+ "name": "clientY",
24578
+ "type": "number",
24579
+ "required": true
24580
+ },
24581
+ {
24582
+ "name": "button",
24583
+ "type": "number",
24584
+ "required": true
24585
+ }
24586
+ ]
22551
24587
  },
22552
24588
  "tileHoverEvent": {
22553
24589
  "types": [
22554
24590
  "string"
22555
24591
  ],
22556
- "description": "Declarative event: tile hover"
24592
+ "description": "Declarative event: tile hover",
24593
+ "kind": "event-ref",
24594
+ "emitPayloadSchema": [
24595
+ {
24596
+ "name": "tileId",
24597
+ "type": "string",
24598
+ "required": true
24599
+ },
24600
+ {
24601
+ "name": "x",
24602
+ "type": "number",
24603
+ "required": true
24604
+ },
24605
+ {
24606
+ "name": "z",
24607
+ "type": "number",
24608
+ "required": true
24609
+ },
24610
+ {
24611
+ "name": "type",
24612
+ "type": "string",
24613
+ "required": false
24614
+ }
24615
+ ]
22557
24616
  },
22558
24617
  "tileLeaveEvent": {
22559
24618
  "types": [
22560
24619
  "string"
22561
24620
  ],
22562
- "description": "Declarative event: tile leave"
24621
+ "description": "Declarative event: tile leave",
24622
+ "kind": "event-ref",
24623
+ "emitPayloadSchema": []
22563
24624
  },
22564
24625
  "unitAnimationEvent": {
22565
24626
  "types": [
22566
24627
  "string"
22567
24628
  ],
22568
- "description": "Declarative event: unit animation"
24629
+ "description": "Declarative event: unit animation",
24630
+ "kind": "event-ref",
24631
+ "emitPayloadSchema": [
24632
+ {
24633
+ "name": "unitId",
24634
+ "type": "string",
24635
+ "required": true
24636
+ },
24637
+ {
24638
+ "name": "state",
24639
+ "type": "string",
24640
+ "required": true
24641
+ },
24642
+ {
24643
+ "name": "timestamp",
24644
+ "type": "number",
24645
+ "required": true
24646
+ }
24647
+ ]
22569
24648
  },
22570
24649
  "cameraChangeEvent": {
22571
24650
  "types": [
22572
24651
  "string"
22573
24652
  ],
22574
- "description": "Declarative event: camera change"
24653
+ "description": "Declarative event: camera change",
24654
+ "kind": "event-ref",
24655
+ "emitPayloadSchema": [
24656
+ {
24657
+ "name": "position",
24658
+ "type": "object",
24659
+ "required": true
24660
+ },
24661
+ {
24662
+ "name": "timestamp",
24663
+ "type": "number",
24664
+ "required": true
24665
+ }
24666
+ ]
22575
24667
  },
22576
24668
  "loadingMessage": {
22577
24669
  "types": [
@@ -22678,7 +24770,14 @@
22678
24770
  "types": [
22679
24771
  "function"
22680
24772
  ],
22681
- "description": "Called when camera changes"
24773
+ "description": "Called when camera changes",
24774
+ "kind": "callback",
24775
+ "callbackArgs": [
24776
+ {
24777
+ "name": "camera",
24778
+ "type": "object"
24779
+ }
24780
+ ]
22682
24781
  }
22683
24782
  }
22684
24783
  },
@@ -22807,13 +24906,26 @@
22807
24906
  "types": [
22808
24907
  "function"
22809
24908
  ],
22810
- "description": "Error callback"
24909
+ "description": "Error callback",
24910
+ "kind": "callback",
24911
+ "callbackArgs": [
24912
+ {
24913
+ "name": "error",
24914
+ "type": "object"
24915
+ },
24916
+ {
24917
+ "name": "errorInfo",
24918
+ "type": "object"
24919
+ }
24920
+ ]
22811
24921
  },
22812
24922
  "onReset": {
22813
24923
  "types": [
22814
24924
  "function"
22815
24925
  ],
22816
- "description": "Reset callback"
24926
+ "description": "Reset callback",
24927
+ "kind": "callback",
24928
+ "callbackArgs": []
22817
24929
  }
22818
24930
  }
22819
24931
  },
@@ -22939,19 +25051,35 @@
22939
25051
  "types": [
22940
25052
  "function"
22941
25053
  ],
22942
- "description": "Called when physics state updates"
25054
+ "description": "Called when physics state updates",
25055
+ "kind": "callback",
25056
+ "callbackArgs": [
25057
+ {
25058
+ "name": "state",
25059
+ "type": "object"
25060
+ }
25061
+ ]
22943
25062
  },
22944
25063
  "onGroundHit": {
22945
25064
  "types": [
22946
25065
  "function"
22947
25066
  ],
22948
- "description": "Called when object hits ground"
25067
+ "description": "Called when object hits ground",
25068
+ "kind": "callback",
25069
+ "callbackArgs": []
22949
25070
  },
22950
25071
  "onCollision": {
22951
25072
  "types": [
22952
25073
  "function"
22953
25074
  ],
22954
- "description": "Called when collision occurs"
25075
+ "description": "Called when collision occurs",
25076
+ "kind": "callback",
25077
+ "callbackArgs": [
25078
+ {
25079
+ "name": "otherEntityId",
25080
+ "type": "string"
25081
+ }
25082
+ ]
22955
25083
  }
22956
25084
  }
22957
25085
  },
@@ -22995,13 +25123,27 @@
22995
25123
  "types": [
22996
25124
  "function"
22997
25125
  ],
22998
- "description": "Called when feature is clicked"
25126
+ "description": "Called when feature is clicked",
25127
+ "kind": "callback",
25128
+ "callbackArgs": [
25129
+ {
25130
+ "name": "feature",
25131
+ "type": "object"
25132
+ }
25133
+ ]
22999
25134
  },
23000
25135
  "onFeatureHover": {
23001
25136
  "types": [
23002
25137
  "function"
23003
25138
  ],
23004
- "description": "Called when feature is hovered"
25139
+ "description": "Called when feature is hovered",
25140
+ "kind": "callback",
25141
+ "callbackArgs": [
25142
+ {
25143
+ "name": "feature",
25144
+ "type": "object"
25145
+ }
25146
+ ]
23005
25147
  },
23006
25148
  "selectedFeatureIds": {
23007
25149
  "types": [
@@ -23404,14 +25546,23 @@
23404
25546
  "types": [
23405
25547
  "function"
23406
25548
  ],
23407
- "description": "onSchemaChange prop"
25549
+ "description": "onSchemaChange prop",
25550
+ "kind": "callback",
25551
+ "callbackArgs": [
25552
+ {
25553
+ "name": "schema",
25554
+ "type": "object"
25555
+ }
25556
+ ]
23408
25557
  },
23409
25558
  "onClose": {
23410
25559
  "types": [
23411
25560
  "function"
23412
25561
  ],
23413
25562
  "description": "onClose prop",
23414
- "required": true
25563
+ "required": true,
25564
+ "kind": "callback",
25565
+ "callbackArgs": []
23415
25566
  }
23416
25567
  }
23417
25568
  },
@@ -23469,7 +25620,14 @@
23469
25620
  "types": [
23470
25621
  "function"
23471
25622
  ],
23472
- "description": "Called when a file is clicked"
25623
+ "description": "Called when a file is clicked",
25624
+ "kind": "callback",
25625
+ "callbackArgs": [
25626
+ {
25627
+ "name": "path",
25628
+ "type": "string"
25629
+ }
25630
+ ]
23473
25631
  },
23474
25632
  "className": {
23475
25633
  "types": [
@@ -23548,7 +25706,14 @@
23548
25706
  "types": [
23549
25707
  "function"
23550
25708
  ],
23551
- "description": "GAP-55: fired when the user clicks an orbital tile. Consumers (e.g. the builder workspace) use this as the trigger to drill INTO the clicked orbital — typically by switching back to the canvas tab and opening the clicked orbital at L2 expanded. Local `selected` toggle (visual highlight + info panel) still fires regardless of whether the callback is provided."
25709
+ "description": "GAP-55: fired when the user clicks an orbital tile. Consumers (e.g. the builder workspace) use this as the trigger to drill INTO the clicked orbital — typically by switching back to the canvas tab and opening the clicked orbital at L2 expanded. Local `selected` toggle (visual highlight + info panel) still fires regardless of whether the callback is provided.",
25710
+ "kind": "callback",
25711
+ "callbackArgs": [
25712
+ {
25713
+ "name": "orbital",
25714
+ "type": "string"
25715
+ }
25716
+ ]
23552
25717
  },
23553
25718
  "minZoom": {
23554
25719
  "types": [