@almadar/patterns 1.1.0 → 1.1.1

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.
package/dist/index.js CHANGED
@@ -1,7 +1,7 @@
1
1
  // src/patterns-registry.json
2
2
  var patterns_registry_default = {
3
3
  version: "1.0.0",
4
- exportedAt: "2026-02-10T15:35:56.769Z",
4
+ exportedAt: "2026-02-12T06:50:46.522Z",
5
5
  patterns: {
6
6
  "entity-table": {
7
7
  type: "entity-table",
@@ -1350,6 +1350,12 @@ var patterns_registry_default = {
1350
1350
  "string"
1351
1351
  ],
1352
1352
  description: "Additional CSS classes"
1353
+ },
1354
+ stepClickEvent: {
1355
+ types: [
1356
+ "string"
1357
+ ],
1358
+ description: "Declarative step click event \u2014 emits UI:{stepClickEvent} with { stepIndex }"
1353
1359
  }
1354
1360
  }
1355
1361
  },
@@ -1622,6 +1628,18 @@ var patterns_registry_default = {
1622
1628
  "string"
1623
1629
  ],
1624
1630
  description: "Additional CSS classes"
1631
+ },
1632
+ pageChangeEvent: {
1633
+ types: [
1634
+ "string"
1635
+ ],
1636
+ description: "Declarative page change event \u2014 emits UI:{pageChangeEvent} with { page }"
1637
+ },
1638
+ pageSizeChangeEvent: {
1639
+ types: [
1640
+ "string"
1641
+ ],
1642
+ description: "Declarative page size change event \u2014 emits UI:{pageSizeChangeEvent} with { pageSize }"
1625
1643
  }
1626
1644
  }
1627
1645
  },
@@ -1689,6 +1707,12 @@ var patterns_registry_default = {
1689
1707
  "string"
1690
1708
  ],
1691
1709
  description: "Variant for color styling"
1710
+ },
1711
+ actionEvent: {
1712
+ types: [
1713
+ "string"
1714
+ ],
1715
+ description: "Declarative action event \u2014 emits UI:{actionEvent} via eventBus when action button is clicked"
1692
1716
  }
1693
1717
  }
1694
1718
  },
@@ -1760,6 +1784,12 @@ var patterns_registry_default = {
1760
1784
  "string"
1761
1785
  ],
1762
1786
  description: "className prop"
1787
+ },
1788
+ retryEvent: {
1789
+ types: [
1790
+ "string"
1791
+ ],
1792
+ description: "Declarative retry event \u2014 emits UI:{retryEvent} via eventBus when retry button is clicked"
1763
1793
  }
1764
1794
  }
1765
1795
  },
@@ -1835,6 +1865,18 @@ var patterns_registry_default = {
1835
1865
  "string"
1836
1866
  ],
1837
1867
  description: "Additional CSS classes"
1868
+ },
1869
+ dismissEvent: {
1870
+ types: [
1871
+ "string"
1872
+ ],
1873
+ description: "Declarative dismiss event \u2014 emits UI:{dismissEvent} via eventBus when toast is dismissed"
1874
+ },
1875
+ actionEvent: {
1876
+ types: [
1877
+ "string"
1878
+ ],
1879
+ description: "Declarative action event \u2014 emits UI:{actionEvent} via eventBus when action button is clicked"
1838
1880
  }
1839
1881
  }
1840
1882
  },
@@ -2075,6 +2117,12 @@ var patterns_registry_default = {
2075
2117
  "string"
2076
2118
  ],
2077
2119
  description: "className prop"
2120
+ },
2121
+ closeEvent: {
2122
+ types: [
2123
+ "string"
2124
+ ],
2125
+ description: "Declarative close event \u2014 emits UI:{closeEvent} via eventBus when modal should close"
2078
2126
  }
2079
2127
  }
2080
2128
  },
@@ -2155,6 +2203,12 @@ var patterns_registry_default = {
2155
2203
  "string"
2156
2204
  ],
2157
2205
  description: "Additional class name"
2206
+ },
2207
+ closeEvent: {
2208
+ types: [
2209
+ "string"
2210
+ ],
2211
+ description: "Declarative close event \u2014 emits UI:{closeEvent} via eventBus when drawer should close"
2158
2212
  }
2159
2213
  }
2160
2214
  },
@@ -2427,6 +2481,24 @@ var patterns_registry_default = {
2427
2481
  "react.elementtype"
2428
2482
  ],
2429
2483
  description: "HTML element to render as"
2484
+ },
2485
+ action: {
2486
+ types: [
2487
+ "string"
2488
+ ],
2489
+ description: "Declarative event name \u2014 emits UI:{action} via eventBus on click"
2490
+ },
2491
+ actionPayload: {
2492
+ types: [
2493
+ "object"
2494
+ ],
2495
+ description: "Payload to include with the action event"
2496
+ },
2497
+ hoverEvent: {
2498
+ types: [
2499
+ "string"
2500
+ ],
2501
+ description: "Declarative hover event \u2014 emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave"
2430
2502
  }
2431
2503
  }
2432
2504
  },
@@ -2907,8 +2979,7 @@ var patterns_registry_default = {
2907
2979
  types: [
2908
2980
  "function"
2909
2981
  ],
2910
- description: "Called when a slot is selected",
2911
- required: true
2982
+ description: "Called when a slot is selected"
2912
2983
  },
2913
2984
  onUseItem: {
2914
2985
  types: [
@@ -2922,6 +2993,24 @@ var patterns_registry_default = {
2922
2993
  ],
2923
2994
  description: "Called when an item is dropped"
2924
2995
  },
2996
+ selectSlotEvent: {
2997
+ types: [
2998
+ "string"
2999
+ ],
3000
+ description: "Declarative event: emits UI:{selectSlotEvent} with { index } when a slot is selected"
3001
+ },
3002
+ useItemEvent: {
3003
+ types: [
3004
+ "string"
3005
+ ],
3006
+ description: "Declarative event: emits UI:{useItemEvent} with { item } when an item is used"
3007
+ },
3008
+ dropItemEvent: {
3009
+ types: [
3010
+ "string"
3011
+ ],
3012
+ description: "Declarative event: emits UI:{dropItemEvent} with { item } when an item is dropped"
3013
+ },
2925
3014
  showTooltips: {
2926
3015
  types: [
2927
3016
  "boolean"
@@ -2990,6 +3079,24 @@ var patterns_registry_default = {
2990
3079
  ],
2991
3080
  description: "Called when dialogue is advanced (no choices)"
2992
3081
  },
3082
+ completeEvent: {
3083
+ types: [
3084
+ "string"
3085
+ ],
3086
+ description: "Declarative event: emits UI:{completeEvent} when text animation completes"
3087
+ },
3088
+ choiceEvent: {
3089
+ types: [
3090
+ "string"
3091
+ ],
3092
+ description: "Declarative event: emits UI:{choiceEvent} with { choice } when a choice is selected"
3093
+ },
3094
+ advanceEvent: {
3095
+ types: [
3096
+ "string"
3097
+ ],
3098
+ description: "Declarative event: emits UI:{advanceEvent} when dialogue is advanced"
3099
+ },
2993
3100
  className: {
2994
3101
  types: [
2995
3102
  "string"
@@ -3081,6 +3188,24 @@ var patterns_registry_default = {
3081
3188
  "icon"
3082
3189
  ],
3083
3190
  description: "Right icon as Lucide icon component (convenience prop)"
3191
+ },
3192
+ action: {
3193
+ types: [
3194
+ "string"
3195
+ ],
3196
+ description: "Declarative event name \u2014 emits UI:{action} via eventBus on click"
3197
+ },
3198
+ actionPayload: {
3199
+ types: [
3200
+ "object"
3201
+ ],
3202
+ description: "Payload to include with the action event"
3203
+ },
3204
+ label: {
3205
+ types: [
3206
+ "string"
3207
+ ],
3208
+ description: "Button label text (alternative to children for schema-driven rendering)"
3084
3209
  }
3085
3210
  }
3086
3211
  },
@@ -3180,6 +3305,18 @@ var patterns_registry_default = {
3180
3305
  "function"
3181
3306
  ],
3182
3307
  description: "Click handler"
3308
+ },
3309
+ action: {
3310
+ types: [
3311
+ "string"
3312
+ ],
3313
+ description: "Declarative event name \u2014 emits UI:{action} via eventBus on click"
3314
+ },
3315
+ actionPayload: {
3316
+ types: [
3317
+ "object"
3318
+ ],
3319
+ description: "Payload to include with the action event"
3183
3320
  }
3184
3321
  }
3185
3322
  },
@@ -3296,6 +3433,12 @@ var patterns_registry_default = {
3296
3433
  "string"
3297
3434
  ],
3298
3435
  description: "Additional CSS classes"
3436
+ },
3437
+ action: {
3438
+ types: [
3439
+ "string"
3440
+ ],
3441
+ description: "Declarative event name \u2014 emits UI:{action} via eventBus on card click"
3299
3442
  }
3300
3443
  }
3301
3444
  },
@@ -3720,6 +3863,12 @@ var patterns_registry_default = {
3720
3863
  "string"
3721
3864
  ],
3722
3865
  description: "className prop"
3866
+ },
3867
+ dismissEvent: {
3868
+ types: [
3869
+ "string"
3870
+ ],
3871
+ description: "Declarative dismiss event \u2014 emits UI:{dismissEvent} via eventBus when alert is dismissed"
3723
3872
  }
3724
3873
  }
3725
3874
  },
@@ -3923,6 +4072,12 @@ var patterns_registry_default = {
3923
4072
  "string"
3924
4073
  ],
3925
4074
  description: "Additional CSS classes"
4075
+ },
4076
+ toggleEvent: {
4077
+ types: [
4078
+ "string"
4079
+ ],
4080
+ description: "Declarative toggle event \u2014 emits UI:{toggleEvent} with { itemId, isOpen }"
3926
4081
  }
3927
4082
  }
3928
4083
  },
@@ -4267,6 +4422,12 @@ var patterns_registry_default = {
4267
4422
  "boolean"
4268
4423
  ],
4269
4424
  description: "blur prop"
4425
+ },
4426
+ action: {
4427
+ types: [
4428
+ "string"
4429
+ ],
4430
+ description: "Declarative event name \u2014 emits UI:{action} via eventBus on click"
4270
4431
  }
4271
4432
  }
4272
4433
  },
@@ -4368,6 +4529,18 @@ var patterns_registry_default = {
4368
4529
  "number"
4369
4530
  ],
4370
4531
  description: "Tab index for focus management"
4532
+ },
4533
+ action: {
4534
+ types: [
4535
+ "string"
4536
+ ],
4537
+ description: "Declarative event name \u2014 emits UI:{action} via eventBus on click"
4538
+ },
4539
+ actionPayload: {
4540
+ types: [
4541
+ "object"
4542
+ ],
4543
+ description: "Payload to include with the action event"
4371
4544
  }
4372
4545
  }
4373
4546
  },
@@ -4382,6 +4555,13 @@ var patterns_registry_default = {
4382
4555
  ],
4383
4556
  typicalSize: "small",
4384
4557
  propsSchema: {
4558
+ highlightType: {
4559
+ types: [
4560
+ "highlighttype"
4561
+ ],
4562
+ description: "Type of highlight (determines color)",
4563
+ required: true
4564
+ },
4385
4565
  isActive: {
4386
4566
  types: [
4387
4567
  "boolean"
@@ -4425,12 +4605,17 @@ var patterns_registry_default = {
4425
4605
  description: "Highlighted text content",
4426
4606
  required: true
4427
4607
  },
4428
- highlightType: {
4608
+ action: {
4429
4609
  types: [
4430
- "highlighttype"
4610
+ "string"
4431
4611
  ],
4432
- description: "Type of highlight (determines color)",
4433
- required: true
4612
+ description: "Declarative event name \u2014 emits UI:{action} via eventBus on click"
4613
+ },
4614
+ hoverEvent: {
4615
+ types: [
4616
+ "string"
4617
+ ],
4618
+ description: "Declarative hover event \u2014 emits UI:{hoverEvent} with { hovered: true/false }"
4434
4619
  }
4435
4620
  }
4436
4621
  },
@@ -4613,6 +4798,18 @@ var patterns_registry_default = {
4613
4798
  ],
4614
4799
  description: "Called when button is released"
4615
4800
  },
4801
+ pressEvent: {
4802
+ types: [
4803
+ "string"
4804
+ ],
4805
+ description: "Declarative event name emitted on press via useEventBus"
4806
+ },
4807
+ releaseEvent: {
4808
+ types: [
4809
+ "string"
4810
+ ],
4811
+ description: "Declarative event name emitted on release via useEventBus"
4812
+ },
4616
4813
  pressed: {
4617
4814
  types: [
4618
4815
  "boolean"
@@ -4844,6 +5041,12 @@ var patterns_registry_default = {
4844
5041
  "function"
4845
5042
  ],
4846
5043
  description: "Optional onClick handler"
5044
+ },
5045
+ action: {
5046
+ types: [
5047
+ "string"
5048
+ ],
5049
+ description: "Declarative event name emitted on click via useEventBus"
4847
5050
  }
4848
5051
  }
4849
5052
  },
@@ -5364,6 +5567,12 @@ var patterns_registry_default = {
5364
5567
  "string"
5365
5568
  ],
5366
5569
  description: "Additional CSS classes"
5570
+ },
5571
+ closeEvent: {
5572
+ types: [
5573
+ "string"
5574
+ ],
5575
+ description: "Declarative close event \u2014 emits UI:{closeEvent} via eventBus when panel should close"
5367
5576
  }
5368
5577
  }
5369
5578
  },
@@ -5445,8 +5654,13 @@ var patterns_registry_default = {
5445
5654
  types: [
5446
5655
  "function"
5447
5656
  ],
5448
- description: "Called when a button is pressed/released",
5449
- required: true
5657
+ description: "Called when a button is pressed/released"
5658
+ },
5659
+ actionEvent: {
5660
+ types: [
5661
+ "string"
5662
+ ],
5663
+ description: "Declarative event name emitted on action via useEventBus"
5450
5664
  },
5451
5665
  layout: {
5452
5666
  types: [
@@ -5488,8 +5702,13 @@ var patterns_registry_default = {
5488
5702
  types: [
5489
5703
  "function"
5490
5704
  ],
5491
- description: "Called when a direction is pressed/released",
5492
- required: true
5705
+ description: "Called when a direction is pressed/released"
5706
+ },
5707
+ directionEvent: {
5708
+ types: [
5709
+ "string"
5710
+ ],
5711
+ description: "Declarative event name emitted on direction press/release via useEventBus"
5493
5712
  },
5494
5713
  size: {
5495
5714
  types: [
@@ -8323,6 +8542,12 @@ var patterns_registry_default = {
8323
8542
  ],
8324
8543
  description: "Callback when the effect animation completes"
8325
8544
  },
8545
+ completeEvent: {
8546
+ types: [
8547
+ "string"
8548
+ ],
8549
+ description: "Declarative event: emits UI:{completeEvent} when the effect animation completes"
8550
+ },
8326
8551
  className: {
8327
8552
  types: [
8328
8553
  "string"
@@ -8474,6 +8699,30 @@ var patterns_registry_default = {
8474
8699
  ],
8475
8700
  description: "Tile leave handler"
8476
8701
  },
8702
+ tileClickEvent: {
8703
+ types: [
8704
+ "string"
8705
+ ],
8706
+ description: "--- Declarative event props ---"
8707
+ },
8708
+ unitClickEvent: {
8709
+ types: [
8710
+ "string"
8711
+ ],
8712
+ description: "Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click"
8713
+ },
8714
+ tileHoverEvent: {
8715
+ types: [
8716
+ "string"
8717
+ ],
8718
+ description: "Declarative event: emits UI:{tileHoverEvent} with { x, y } on tile hover"
8719
+ },
8720
+ tileLeaveEvent: {
8721
+ types: [
8722
+ "string"
8723
+ ],
8724
+ description: "Declarative event: emits UI:{tileLeaveEvent} with {} on tile leave"
8725
+ },
8477
8726
  scale: {
8478
8727
  types: [
8479
8728
  "number"
@@ -9667,15 +9916,115 @@ var integrators_registry_default = {
9667
9916
  }
9668
9917
  }
9669
9918
  ]
9919
+ },
9920
+ github: {
9921
+ name: "github",
9922
+ description: "GitHub integration - Git operations and GitHub REST API",
9923
+ category: "devtools",
9924
+ actions: [
9925
+ {
9926
+ name: "cloneRepo",
9927
+ description: "Clone a repository",
9928
+ params: [
9929
+ { name: "repo", type: "string", required: true, description: "Repository URL or owner/repo" },
9930
+ { name: "branch", type: "string", required: false, description: "Branch to clone" }
9931
+ ],
9932
+ responseShape: { path: "string", branch: "string" }
9933
+ },
9934
+ {
9935
+ name: "createBranch",
9936
+ description: "Create a new branch",
9937
+ params: [
9938
+ { name: "repo", type: "string", required: true, description: "Local repo path" },
9939
+ { name: "branch", type: "string", required: true, description: "Branch name" }
9940
+ ],
9941
+ responseShape: { branch: "string" }
9942
+ },
9943
+ {
9944
+ name: "commit",
9945
+ description: "Commit changes",
9946
+ params: [
9947
+ { name: "repo", type: "string", required: true, description: "Local repo path" },
9948
+ { name: "message", type: "string", required: true, description: "Commit message" },
9949
+ { name: "files", type: "array", required: false, description: "Files to stage" }
9950
+ ],
9951
+ responseShape: { hash: "string", message: "string" }
9952
+ },
9953
+ {
9954
+ name: "push",
9955
+ description: "Push commits to remote",
9956
+ params: [
9957
+ { name: "repo", type: "string", required: true, description: "Local repo path" },
9958
+ { name: "branch", type: "string", required: false, description: "Branch to push" }
9959
+ ],
9960
+ responseShape: { success: "boolean" }
9961
+ },
9962
+ {
9963
+ name: "createPR",
9964
+ description: "Create a pull request",
9965
+ params: [
9966
+ { name: "title", type: "string", required: true, description: "PR title" },
9967
+ { name: "body", type: "string", required: false, description: "PR description" },
9968
+ { name: "head", type: "string", required: true, description: "Head branch" },
9969
+ { name: "base", type: "string", required: false, description: "Base branch (default: main)" }
9970
+ ],
9971
+ responseShape: { number: "number", url: "string" }
9972
+ },
9973
+ {
9974
+ name: "getPRComments",
9975
+ description: "Fetch pull request comments",
9976
+ params: [
9977
+ { name: "prNumber", type: "number", required: true, description: "PR number" }
9978
+ ],
9979
+ responseShape: { comments: "array" }
9980
+ },
9981
+ {
9982
+ name: "listIssues",
9983
+ description: "List issues with optional filters",
9984
+ params: [
9985
+ { name: "state", type: "string", required: false, description: "Issue state: open, closed, all" },
9986
+ { name: "labels", type: "string", required: false, description: "Comma-separated label names" }
9987
+ ],
9988
+ responseShape: { issues: "array" }
9989
+ },
9990
+ {
9991
+ name: "getIssue",
9992
+ description: "Get a single issue",
9993
+ params: [
9994
+ { name: "issueNumber", type: "number", required: true, description: "Issue number" }
9995
+ ],
9996
+ responseShape: { title: "string", body: "string", state: "string" }
9997
+ }
9998
+ ]
9999
+ },
10000
+ cli: {
10001
+ name: "cli",
10002
+ description: "Almadar CLI integration - schema validation and compilation",
10003
+ category: "devtools",
10004
+ actions: [
10005
+ {
10006
+ name: "validate",
10007
+ description: "Validate an orbital schema",
10008
+ params: [
10009
+ { name: "schema", type: "string", required: true, description: "Schema content to validate" }
10010
+ ],
10011
+ responseShape: {
10012
+ valid: "boolean",
10013
+ errors: "array",
10014
+ warnings: "array",
10015
+ summary: "string"
10016
+ }
10017
+ }
10018
+ ]
9670
10019
  }
9671
10020
  },
9672
- categories: ["media", "payment", "messaging", "ai"]
10021
+ categories: ["media", "payment", "messaging", "ai", "devtools"]
9673
10022
  };
9674
10023
 
9675
10024
  // src/component-mapping.json
9676
10025
  var component_mapping_default = {
9677
10026
  version: "1.0.0",
9678
- exportedAt: "2026-02-10T15:35:56.769Z",
10027
+ exportedAt: "2026-02-12T06:50:46.522Z",
9679
10028
  mappings: {
9680
10029
  "page-header": {
9681
10030
  component: "PageHeader",
@@ -10346,7 +10695,7 @@ var component_mapping_default = {
10346
10695
  // src/event-contracts.json
10347
10696
  var event_contracts_default = {
10348
10697
  version: "1.0.0",
10349
- exportedAt: "2026-02-10T15:35:56.769Z",
10698
+ exportedAt: "2026-02-12T06:50:46.522Z",
10350
10699
  contracts: {
10351
10700
  form: {
10352
10701
  emits: [