@almadar/patterns 2.51.0 → 2.53.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/dist/component-mapping.json +1 -1
  2. package/dist/event-contracts.json +1 -1
  3. package/dist/index.d.ts +240 -0
  4. package/dist/index.js +187 -8
  5. package/dist/index.js.map +1 -1
  6. package/dist/patterns-registry.json +185 -6
  7. package/dist/registry.json +185 -6
  8. package/package.json +1 -1
package/dist/patterns-registry.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "1.0.0",
3
- "exportedAt": "2026-06-18T22:45:03.741Z",
3
+ "exportedAt": "2026-06-19T12:30:13.337Z",
4
4
  "patterns": {
5
5
  "entity-table": {
6
6
  "type": "entity-table",
@@ -39627,7 +39627,7 @@
39627
39627
  "object",
39628
39628
  "array"
39629
39629
  ],
39630
- "description": "Puzzle board-state entity (single row or array). The board reads `components` / `slots` arrays plus title/description/hint off the row.",
39630
+ "description": "Puzzle board-state entity (single row or array). The board reads `components` / `slots` arrays plus `attempts` / `result` off the row — the state machine is the single source of truth for placements.",
39631
39631
  "kind": "entity",
39632
39632
  "cardinality": "collection"
39633
39633
  },
@@ -39650,6 +39650,41 @@
39650
39650
  }
39651
39651
  ],
39652
39652
  "default": "PUZZLE_COMPLETE"
39653
+ },
39654
+ "placeEvent": {
39655
+ "types": [
39656
+ "string"
39657
+ ],
39658
+ "description": "Emits UI:{placeEvent} with { slotId, componentId } on component placement.",
39659
+ "kind": "event-ref",
39660
+ "emitPayloadSchema": [
39661
+ {
39662
+ "name": "slotId",
39663
+ "type": "string",
39664
+ "required": true
39665
+ },
39666
+ {
39667
+ "name": "componentId",
39668
+ "type": "string",
39669
+ "required": true
39670
+ }
39671
+ ]
39672
+ },
39673
+ "checkEvent": {
39674
+ "types": [
39675
+ "string"
39676
+ ],
39677
+ "description": "Emits UI:{checkEvent} with {} when the player checks the build.",
39678
+ "kind": "event-ref",
39679
+ "emitPayloadSchema": []
39680
+ },
39681
+ "playAgainEvent": {
39682
+ "types": [
39683
+ "string"
39684
+ ],
39685
+ "description": "Emits UI:{playAgainEvent} with {} on play again / reset.",
39686
+ "kind": "event-ref",
39687
+ "emitPayloadSchema": []
39653
39688
  }
39654
39689
  }
39655
39690
  },
@@ -39772,7 +39807,7 @@
39772
39807
  "object",
39773
39808
  "array"
39774
39809
  ],
39775
- "description": "Puzzle board-state entity (single row or array). The board reads `items` / `categories` arrays plus title/description/hint off the row.",
39810
+ "description": "Puzzle board-state entity (single row or array). The board reads `items` / `categories` arrays plus title/description/hint off the row. Items may carry `assignedCategory`; the row may carry `result` and `attempts` — all machine-owned.",
39776
39811
  "kind": "entity",
39777
39812
  "cardinality": "collection"
39778
39813
  },
@@ -39795,6 +39830,41 @@
39795
39830
  }
39796
39831
  ],
39797
39832
  "default": "PUZZLE_COMPLETE"
39833
+ },
39834
+ "assignEvent": {
39835
+ "types": [
39836
+ "string"
39837
+ ],
39838
+ "description": "Emits UI:{assignEvent} with { itemId, categoryId } when an item is sorted.",
39839
+ "kind": "event-ref",
39840
+ "emitPayloadSchema": [
39841
+ {
39842
+ "name": "itemId",
39843
+ "type": "string",
39844
+ "required": true
39845
+ },
39846
+ {
39847
+ "name": "categoryId",
39848
+ "type": "string",
39849
+ "required": true
39850
+ }
39851
+ ]
39852
+ },
39853
+ "checkEvent": {
39854
+ "types": [
39855
+ "string"
39856
+ ],
39857
+ "description": "Emits UI:{checkEvent} with {} when the player submits/checks.",
39858
+ "kind": "event-ref",
39859
+ "emitPayloadSchema": []
39860
+ },
39861
+ "playAgainEvent": {
39862
+ "types": [
39863
+ "string"
39864
+ ],
39865
+ "description": "Emits UI:{playAgainEvent} with {} on reset / play again.",
39866
+ "kind": "event-ref",
39867
+ "emitPayloadSchema": []
39798
39868
  }
39799
39869
  }
39800
39870
  },
@@ -39917,7 +39987,7 @@
39917
39987
  "object",
39918
39988
  "array"
39919
39989
  ],
39920
- "description": "Puzzle board-state entity (single row or array). The board reads `lines` array plus title/description/bugCount/hint off the row.",
39990
+ "description": "Puzzle board-state entity (single row or array). The board reads `lines` array (each with `isFlagged`), `result`, `attempts`, plus title/description/bugCount/hint off the row.",
39921
39991
  "kind": "entity",
39922
39992
  "cardinality": "collection"
39923
39993
  },
@@ -39940,6 +40010,36 @@
39940
40010
  }
39941
40011
  ],
39942
40012
  "default": "PUZZLE_COMPLETE"
40013
+ },
40014
+ "toggleFlagEvent": {
40015
+ "types": [
40016
+ "string"
40017
+ ],
40018
+ "description": "Emits UI:{toggleFlagEvent} with { lineId } when a line's bug-flag is toggled.",
40019
+ "kind": "event-ref",
40020
+ "emitPayloadSchema": [
40021
+ {
40022
+ "name": "lineId",
40023
+ "type": "string",
40024
+ "required": true
40025
+ }
40026
+ ]
40027
+ },
40028
+ "checkEvent": {
40029
+ "types": [
40030
+ "string"
40031
+ ],
40032
+ "description": "Emits UI:{checkEvent} with {} when the player checks/submits.",
40033
+ "kind": "event-ref",
40034
+ "emitPayloadSchema": []
40035
+ },
40036
+ "playAgainEvent": {
40037
+ "types": [
40038
+ "string"
40039
+ ],
40040
+ "description": "Emits UI:{playAgainEvent} with {} on play again / reset.",
40041
+ "kind": "event-ref",
40042
+ "emitPayloadSchema": []
39943
40043
  }
39944
40044
  }
39945
40045
  },
@@ -40521,7 +40621,7 @@
40521
40621
  "object",
40522
40622
  "array"
40523
40623
  ],
40524
- "description": "Puzzle board-state entity (single row or array). The board reads `actions` / `payoffMatrix` arrays plus title/description/rounds/hint off the row.",
40624
+ "description": "Puzzle board-state entity (single row or array). The board reads `score` / `round` / `result` / `targetScore` / `maxRounds` plus the `actions` / `payoffMatrix` arrays and title/description/hint off the row. Score accumulation + win/lose are owned by the gameplay machine.",
40525
40625
  "kind": "entity",
40526
40626
  "cardinality": "collection"
40527
40627
  },
@@ -40544,6 +40644,41 @@
40544
40644
  }
40545
40645
  ],
40546
40646
  "default": "PUZZLE_COMPLETE"
40647
+ },
40648
+ "playRoundEvent": {
40649
+ "types": [
40650
+ "string"
40651
+ ],
40652
+ "description": "Emits UI:{playRoundEvent} with the picked action + the UI-resolved payoff.",
40653
+ "kind": "event-ref",
40654
+ "emitPayloadSchema": [
40655
+ {
40656
+ "name": "playerAction",
40657
+ "type": "string",
40658
+ "required": true
40659
+ },
40660
+ {
40661
+ "name": "payoff",
40662
+ "type": "number",
40663
+ "required": true
40664
+ }
40665
+ ]
40666
+ },
40667
+ "finishEvent": {
40668
+ "types": [
40669
+ "string"
40670
+ ],
40671
+ "description": "Emits UI:{finishEvent} with {} when all rounds are spent.",
40672
+ "kind": "event-ref",
40673
+ "emitPayloadSchema": []
40674
+ },
40675
+ "playAgainEvent": {
40676
+ "types": [
40677
+ "string"
40678
+ ],
40679
+ "description": "Emits UI:{playAgainEvent} with {} on play again / reset.",
40680
+ "kind": "event-ref",
40681
+ "emitPayloadSchema": []
40547
40682
  }
40548
40683
  }
40549
40684
  },
@@ -41717,7 +41852,7 @@
41717
41852
  "object",
41718
41853
  "array"
41719
41854
  ],
41720
- "description": "Puzzle board-state entity (single row or array). The board reads the `parameters` array plus title/description/target/hint off the row.",
41855
+ "description": "Puzzle board-state entity (single row or array). The board reads the `parameters` slider descriptors plus the machine-owned `paramA`/`paramB`/ `output`/`target`/`tolerance`/`attempts`/`result` fields off the row.",
41721
41856
  "kind": "entity",
41722
41857
  "cardinality": "collection"
41723
41858
  },
@@ -41740,6 +41875,50 @@
41740
41875
  }
41741
41876
  ],
41742
41877
  "default": "PUZZLE_COMPLETE"
41878
+ },
41879
+ "setAEvent": {
41880
+ "types": [
41881
+ "string"
41882
+ ],
41883
+ "description": "Emits UI:{setAEvent} with { value } when parameter A's slider changes.",
41884
+ "kind": "event-ref",
41885
+ "emitPayloadSchema": [
41886
+ {
41887
+ "name": "value",
41888
+ "type": "number",
41889
+ "required": true
41890
+ }
41891
+ ]
41892
+ },
41893
+ "setBEvent": {
41894
+ "types": [
41895
+ "string"
41896
+ ],
41897
+ "description": "Emits UI:{setBEvent} with { value } when parameter B's slider changes.",
41898
+ "kind": "event-ref",
41899
+ "emitPayloadSchema": [
41900
+ {
41901
+ "name": "value",
41902
+ "type": "number",
41903
+ "required": true
41904
+ }
41905
+ ]
41906
+ },
41907
+ "checkEvent": {
41908
+ "types": [
41909
+ "string"
41910
+ ],
41911
+ "description": "Emits UI:{checkEvent} with {} on simulate / check.",
41912
+ "kind": "event-ref",
41913
+ "emitPayloadSchema": []
41914
+ },
41915
+ "playAgainEvent": {
41916
+ "types": [
41917
+ "string"
41918
+ ],
41919
+ "description": "Emits UI:{playAgainEvent} with {} on reset / play again.",
41920
+ "kind": "event-ref",
41921
+ "emitPayloadSchema": []
41743
41922
  }
41744
41923
  }
41745
41924
  },
package/dist/registry.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "1.0.0",
3
- "exportedAt": "2026-06-18T22:45:03.741Z",
3
+ "exportedAt": "2026-06-19T12:30:13.337Z",
4
4
  "patterns": {
5
5
  "entity-table": {
6
6
  "type": "entity-table",
@@ -39627,7 +39627,7 @@
39627
39627
  "object",
39628
39628
  "array"
39629
39629
  ],
39630
- "description": "Puzzle board-state entity (single row or array). The board reads `components` / `slots` arrays plus title/description/hint off the row.",
39630
+ "description": "Puzzle board-state entity (single row or array). The board reads `components` / `slots` arrays plus `attempts` / `result` off the row — the state machine is the single source of truth for placements.",
39631
39631
  "kind": "entity",
39632
39632
  "cardinality": "collection"
39633
39633
  },
@@ -39650,6 +39650,41 @@
39650
39650
  }
39651
39651
  ],
39652
39652
  "default": "PUZZLE_COMPLETE"
39653
+ },
39654
+ "placeEvent": {
39655
+ "types": [
39656
+ "string"
39657
+ ],
39658
+ "description": "Emits UI:{placeEvent} with { slotId, componentId } on component placement.",
39659
+ "kind": "event-ref",
39660
+ "emitPayloadSchema": [
39661
+ {
39662
+ "name": "slotId",
39663
+ "type": "string",
39664
+ "required": true
39665
+ },
39666
+ {
39667
+ "name": "componentId",
39668
+ "type": "string",
39669
+ "required": true
39670
+ }
39671
+ ]
39672
+ },
39673
+ "checkEvent": {
39674
+ "types": [
39675
+ "string"
39676
+ ],
39677
+ "description": "Emits UI:{checkEvent} with {} when the player checks the build.",
39678
+ "kind": "event-ref",
39679
+ "emitPayloadSchema": []
39680
+ },
39681
+ "playAgainEvent": {
39682
+ "types": [
39683
+ "string"
39684
+ ],
39685
+ "description": "Emits UI:{playAgainEvent} with {} on play again / reset.",
39686
+ "kind": "event-ref",
39687
+ "emitPayloadSchema": []
39653
39688
  }
39654
39689
  }
39655
39690
  },
@@ -39772,7 +39807,7 @@
39772
39807
  "object",
39773
39808
  "array"
39774
39809
  ],
39775
- "description": "Puzzle board-state entity (single row or array). The board reads `items` / `categories` arrays plus title/description/hint off the row.",
39810
+ "description": "Puzzle board-state entity (single row or array). The board reads `items` / `categories` arrays plus title/description/hint off the row. Items may carry `assignedCategory`; the row may carry `result` and `attempts` — all machine-owned.",
39776
39811
  "kind": "entity",
39777
39812
  "cardinality": "collection"
39778
39813
  },
@@ -39795,6 +39830,41 @@
39795
39830
  }
39796
39831
  ],
39797
39832
  "default": "PUZZLE_COMPLETE"
39833
+ },
39834
+ "assignEvent": {
39835
+ "types": [
39836
+ "string"
39837
+ ],
39838
+ "description": "Emits UI:{assignEvent} with { itemId, categoryId } when an item is sorted.",
39839
+ "kind": "event-ref",
39840
+ "emitPayloadSchema": [
39841
+ {
39842
+ "name": "itemId",
39843
+ "type": "string",
39844
+ "required": true
39845
+ },
39846
+ {
39847
+ "name": "categoryId",
39848
+ "type": "string",
39849
+ "required": true
39850
+ }
39851
+ ]
39852
+ },
39853
+ "checkEvent": {
39854
+ "types": [
39855
+ "string"
39856
+ ],
39857
+ "description": "Emits UI:{checkEvent} with {} when the player submits/checks.",
39858
+ "kind": "event-ref",
39859
+ "emitPayloadSchema": []
39860
+ },
39861
+ "playAgainEvent": {
39862
+ "types": [
39863
+ "string"
39864
+ ],
39865
+ "description": "Emits UI:{playAgainEvent} with {} on reset / play again.",
39866
+ "kind": "event-ref",
39867
+ "emitPayloadSchema": []
39798
39868
  }
39799
39869
  }
39800
39870
  },
@@ -39917,7 +39987,7 @@
39917
39987
  "object",
39918
39988
  "array"
39919
39989
  ],
39920
- "description": "Puzzle board-state entity (single row or array). The board reads `lines` array plus title/description/bugCount/hint off the row.",
39990
+ "description": "Puzzle board-state entity (single row or array). The board reads `lines` array (each with `isFlagged`), `result`, `attempts`, plus title/description/bugCount/hint off the row.",
39921
39991
  "kind": "entity",
39922
39992
  "cardinality": "collection"
39923
39993
  },
@@ -39940,6 +40010,36 @@
39940
40010
  }
39941
40011
  ],
39942
40012
  "default": "PUZZLE_COMPLETE"
40013
+ },
40014
+ "toggleFlagEvent": {
40015
+ "types": [
40016
+ "string"
40017
+ ],
40018
+ "description": "Emits UI:{toggleFlagEvent} with { lineId } when a line's bug-flag is toggled.",
40019
+ "kind": "event-ref",
40020
+ "emitPayloadSchema": [
40021
+ {
40022
+ "name": "lineId",
40023
+ "type": "string",
40024
+ "required": true
40025
+ }
40026
+ ]
40027
+ },
40028
+ "checkEvent": {
40029
+ "types": [
40030
+ "string"
40031
+ ],
40032
+ "description": "Emits UI:{checkEvent} with {} when the player checks/submits.",
40033
+ "kind": "event-ref",
40034
+ "emitPayloadSchema": []
40035
+ },
40036
+ "playAgainEvent": {
40037
+ "types": [
40038
+ "string"
40039
+ ],
40040
+ "description": "Emits UI:{playAgainEvent} with {} on play again / reset.",
40041
+ "kind": "event-ref",
40042
+ "emitPayloadSchema": []
39943
40043
  }
39944
40044
  }
39945
40045
  },
@@ -40521,7 +40621,7 @@
40521
40621
  "object",
40522
40622
  "array"
40523
40623
  ],
40524
- "description": "Puzzle board-state entity (single row or array). The board reads `actions` / `payoffMatrix` arrays plus title/description/rounds/hint off the row.",
40624
+ "description": "Puzzle board-state entity (single row or array). The board reads `score` / `round` / `result` / `targetScore` / `maxRounds` plus the `actions` / `payoffMatrix` arrays and title/description/hint off the row. Score accumulation + win/lose are owned by the gameplay machine.",
40525
40625
  "kind": "entity",
40526
40626
  "cardinality": "collection"
40527
40627
  },
@@ -40544,6 +40644,41 @@
40544
40644
  }
40545
40645
  ],
40546
40646
  "default": "PUZZLE_COMPLETE"
40647
+ },
40648
+ "playRoundEvent": {
40649
+ "types": [
40650
+ "string"
40651
+ ],
40652
+ "description": "Emits UI:{playRoundEvent} with the picked action + the UI-resolved payoff.",
40653
+ "kind": "event-ref",
40654
+ "emitPayloadSchema": [
40655
+ {
40656
+ "name": "playerAction",
40657
+ "type": "string",
40658
+ "required": true
40659
+ },
40660
+ {
40661
+ "name": "payoff",
40662
+ "type": "number",
40663
+ "required": true
40664
+ }
40665
+ ]
40666
+ },
40667
+ "finishEvent": {
40668
+ "types": [
40669
+ "string"
40670
+ ],
40671
+ "description": "Emits UI:{finishEvent} with {} when all rounds are spent.",
40672
+ "kind": "event-ref",
40673
+ "emitPayloadSchema": []
40674
+ },
40675
+ "playAgainEvent": {
40676
+ "types": [
40677
+ "string"
40678
+ ],
40679
+ "description": "Emits UI:{playAgainEvent} with {} on play again / reset.",
40680
+ "kind": "event-ref",
40681
+ "emitPayloadSchema": []
40547
40682
  }
40548
40683
  }
40549
40684
  },
@@ -41717,7 +41852,7 @@
41717
41852
  "object",
41718
41853
  "array"
41719
41854
  ],
41720
- "description": "Puzzle board-state entity (single row or array). The board reads the `parameters` array plus title/description/target/hint off the row.",
41855
+ "description": "Puzzle board-state entity (single row or array). The board reads the `parameters` slider descriptors plus the machine-owned `paramA`/`paramB`/ `output`/`target`/`tolerance`/`attempts`/`result` fields off the row.",
41721
41856
  "kind": "entity",
41722
41857
  "cardinality": "collection"
41723
41858
  },
@@ -41740,6 +41875,50 @@
41740
41875
  }
41741
41876
  ],
41742
41877
  "default": "PUZZLE_COMPLETE"
41878
+ },
41879
+ "setAEvent": {
41880
+ "types": [
41881
+ "string"
41882
+ ],
41883
+ "description": "Emits UI:{setAEvent} with { value } when parameter A's slider changes.",
41884
+ "kind": "event-ref",
41885
+ "emitPayloadSchema": [
41886
+ {
41887
+ "name": "value",
41888
+ "type": "number",
41889
+ "required": true
41890
+ }
41891
+ ]
41892
+ },
41893
+ "setBEvent": {
41894
+ "types": [
41895
+ "string"
41896
+ ],
41897
+ "description": "Emits UI:{setBEvent} with { value } when parameter B's slider changes.",
41898
+ "kind": "event-ref",
41899
+ "emitPayloadSchema": [
41900
+ {
41901
+ "name": "value",
41902
+ "type": "number",
41903
+ "required": true
41904
+ }
41905
+ ]
41906
+ },
41907
+ "checkEvent": {
41908
+ "types": [
41909
+ "string"
41910
+ ],
41911
+ "description": "Emits UI:{checkEvent} with {} on simulate / check.",
41912
+ "kind": "event-ref",
41913
+ "emitPayloadSchema": []
41914
+ },
41915
+ "playAgainEvent": {
41916
+ "types": [
41917
+ "string"
41918
+ ],
41919
+ "description": "Emits UI:{playAgainEvent} with {} on reset / play again.",
41920
+ "kind": "event-ref",
41921
+ "emitPayloadSchema": []
41743
41922
  }
41744
41923
  }
41745
41924
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@almadar/patterns",
3
- "version": "2.51.0",
3
+ "version": "2.53.0",
4
4
  "description": "Pattern registry and component mappings for Almadar",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",