jssm 5.162.0 → 5.162.2

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.
@@ -1144,15 +1144,15 @@ type JssmEventFilterMap<mDT> = {
1144
1144
  /**
1145
1145
  * Per-event filter object (as passed to {@link Machine.on}). Use
1146
1146
  * `JssmEventDetailMap<mDT>[Ev]` to find the matching detail type.
1147
- * @typeparam mDT The type of the machine data member.
1148
- * @typeparam Ev The event name.
1147
+ * @typeParam mDT The type of the machine data member.
1148
+ * @typeParam Ev The event name.
1149
1149
  */
1150
1150
  type JssmEventFilter<mDT, Ev extends JssmEventName> = JssmEventFilterMap<mDT>[Ev];
1151
1151
  /**
1152
1152
  * Per-event handler signature. Receives a detail object typed by event
1153
1153
  * name, so `e.action` (etc.) only exist where they're meaningful.
1154
- * @typeparam mDT The type of the machine data member.
1155
- * @typeparam Ev The event name.
1154
+ * @typeParam mDT The type of the machine data member.
1155
+ * @typeParam Ev The event name.
1156
1156
  */
1157
1157
  type JssmEventHandler<mDT, Ev extends JssmEventName> = (detail: JssmEventDetailMap<mDT>[Ev]) => void;
1158
1158
  /**
@@ -1406,7 +1406,7 @@ declare class Machine<mDT> {
1406
1406
  * console.log( lswitch.state() ); // 'off'
1407
1407
  * ```
1408
1408
  *
1409
- * @typeparam mDT The type of the machine data member; usually omitted
1409
+ * @typeParam mDT The type of the machine data member; usually omitted
1410
1410
  *
1411
1411
  * @returns The current state name.
1412
1412
  *
@@ -1426,7 +1426,7 @@ declare class Machine<mDT> {
1426
1426
  *
1427
1427
  * See also {@link display_text}.
1428
1428
  *
1429
- * @typeparam mDT The type of the machine data member; usually omitted
1429
+ * @typeParam mDT The type of the machine data member; usually omitted
1430
1430
  *
1431
1431
  * @param state The state to get the label for.
1432
1432
  *
@@ -1453,7 +1453,7 @@ declare class Machine<mDT> {
1453
1453
  * console.log( lswitch.display_text('b') ); // 'b'
1454
1454
  * ```
1455
1455
  *
1456
- * @typeparam mDT The type of the machine data member; usually omitted
1456
+ * @typeParam mDT The type of the machine data member; usually omitted
1457
1457
  *
1458
1458
  * @param state The state to get display text for.
1459
1459
  *
@@ -1472,7 +1472,7 @@ declare class Machine<mDT> {
1472
1472
  * console.log( lswitch.data() ); // 1
1473
1473
  * ```
1474
1474
  *
1475
- * @typeparam mDT The type of the machine data member; usually omitted
1475
+ * @typeParam mDT The type of the machine data member; usually omitted
1476
1476
  *
1477
1477
  * @returns A deep clone of the machine's current data value.
1478
1478
  *
@@ -1636,7 +1636,7 @@ declare class Machine<mDT> {
1636
1636
  * console.log( final_test.is_start_state('b') ); // true
1637
1637
  * ```
1638
1638
  *
1639
- * @typeparam mDT The type of the machine data member; usually omitted
1639
+ * @typeParam mDT The type of the machine data member; usually omitted
1640
1640
  *
1641
1641
  * @param whichState The name of the state to check
1642
1642
  *
@@ -1661,7 +1661,7 @@ declare class Machine<mDT> {
1661
1661
  * console.log( final_test.is_start_state('b') ); // true
1662
1662
  * ```
1663
1663
  *
1664
- * @typeparam mDT The type of the machine data member; usually omitted
1664
+ * @typeParam mDT The type of the machine data member; usually omitted
1665
1665
  *
1666
1666
  * @param whichState The name of the state to check
1667
1667
  *
@@ -1714,7 +1714,7 @@ declare class Machine<mDT> {
1714
1714
  * console.log( final_test.state_is_final('second') ); // true
1715
1715
  * ```
1716
1716
  *
1717
- * @typeparam mDT The type of the machine data member; usually omitted
1717
+ * @typeParam mDT The type of the machine data member; usually omitted
1718
1718
  *
1719
1719
  * @param whichState The name of the state to check for finality
1720
1720
  *
@@ -1744,7 +1744,7 @@ declare class Machine<mDT> {
1744
1744
  * string to recreate (to not waste repeated space;) if you want the machine
1745
1745
  * string embedded, call {@link serialize_with_string} instead.
1746
1746
  *
1747
- * @typeparam mDT The type of the machine data member; usually omitted
1747
+ * @typeParam mDT The type of the machine data member; usually omitted
1748
1748
  *
1749
1749
  * @param comment An optional comment string to embed in the serialized
1750
1750
  * output for identification or debugging.
@@ -1904,7 +1904,7 @@ declare class Machine<mDT> {
1904
1904
  * console.log( lswitch.states() ); // ['on', 'off']
1905
1905
  * ```
1906
1906
  *
1907
- * @typeparam mDT The type of the machine data member; usually omitted
1907
+ * @typeParam mDT The type of the machine data member; usually omitted
1908
1908
  *
1909
1909
  * @returns An array of all state names in the machine.
1910
1910
  *
@@ -1929,7 +1929,7 @@ declare class Machine<mDT> {
1929
1929
  * console.log( lswitch.has_state('dance') ); // false
1930
1930
  * ```
1931
1931
  *
1932
- * @typeparam mDT The type of the machine data member; usually omitted
1932
+ * @typeParam mDT The type of the machine data member; usually omitted
1933
1933
  *
1934
1934
  * @param whichState The state to be checked for existence.
1935
1935
  *
@@ -1967,7 +1967,7 @@ declare class Machine<mDT> {
1967
1967
  * ]
1968
1968
  * ```
1969
1969
  *
1970
- * @typeparam mDT The type of the machine data member; usually omitted
1970
+ * @typeParam mDT The type of the machine data member; usually omitted
1971
1971
  *
1972
1972
  * @returns An array of all {@link JssmTransition} edge objects.
1973
1973
  *
@@ -2118,7 +2118,7 @@ declare class Machine<mDT> {
2118
2118
  * light.list_transitions(); // { entrances: [ 'yellow', 'off' ], exits: [ 'green', 'off' ] }
2119
2119
  * ```
2120
2120
  *
2121
- * @typeparam mDT The type of the machine data member; usually omitted
2121
+ * @typeParam mDT The type of the machine data member; usually omitted
2122
2122
  *
2123
2123
  * @param whichState The state whose transitions to have listed
2124
2124
  *
@@ -2141,7 +2141,7 @@ declare class Machine<mDT> {
2141
2141
  * light.list_entrances(); // [ 'yellow', 'off' ]
2142
2142
  * ```
2143
2143
  *
2144
- * @typeparam mDT The type of the machine data member; usually omitted
2144
+ * @typeParam mDT The type of the machine data member; usually omitted
2145
2145
  *
2146
2146
  * @param whichState The state whose entrances to have listed
2147
2147
  *
@@ -2163,7 +2163,7 @@ declare class Machine<mDT> {
2163
2163
  * light.list_exits(); // [ 'green', 'off' ]
2164
2164
  * ```
2165
2165
  *
2166
- * @typeparam mDT The type of the machine data member; usually omitted
2166
+ * @typeParam mDT The type of the machine data member; usually omitted
2167
2167
  *
2168
2168
  * @param whichState The state whose exits to have listed
2169
2169
  *
@@ -2301,7 +2301,7 @@ declare class Machine<mDT> {
2301
2301
  * console.log( machine.actions() ); // logs ['next', 'shutdown']
2302
2302
  * ```
2303
2303
  *
2304
- * @typeparam mDT The type of the machine data member; usually omitted
2304
+ * @typeParam mDT The type of the machine data member; usually omitted
2305
2305
  *
2306
2306
  * @param whichState The state whose actions to list. Defaults to the
2307
2307
  * current state.
@@ -2327,7 +2327,7 @@ declare class Machine<mDT> {
2327
2327
  * console.log( machine.list_states_having_action('start') ); // ['off']
2328
2328
  * ```
2329
2329
  *
2330
- * @typeparam mDT The type of the machine data member; usually omitted
2330
+ * @typeParam mDT The type of the machine data member; usually omitted
2331
2331
  *
2332
2332
  * @param whichState The action to be checked for associated states
2333
2333
  *
@@ -2400,7 +2400,7 @@ declare class Machine<mDT> {
2400
2400
  * m.isIn('nonesuch'); // false — undeclared group has no members
2401
2401
  * ```
2402
2402
  *
2403
- * @typeparam mDT The type of the machine data member; usually omitted
2403
+ * @typeParam mDT The type of the machine data member; usually omitted
2404
2404
  *
2405
2405
  * @param groupName The group to test the current state against.
2406
2406
  *
@@ -2428,7 +2428,7 @@ declare class Machine<mDT> {
2428
2428
  * m.groupsOf('z'); // Set {} — not in any group
2429
2429
  * ```
2430
2430
  *
2431
- * @typeparam mDT The type of the machine data member; usually omitted
2431
+ * @typeParam mDT The type of the machine data member; usually omitted
2432
2432
  *
2433
2433
  * @param state The state whose containing groups are wanted.
2434
2434
  *
@@ -2454,7 +2454,7 @@ declare class Machine<mDT> {
2454
2454
  * m.groups(); // [ 'first', 'second' ]
2455
2455
  * ```
2456
2456
  *
2457
- * @typeparam mDT The type of the machine data member; usually omitted
2457
+ * @typeParam mDT The type of the machine data member; usually omitted
2458
2458
  *
2459
2459
  * @returns The declared group names, in declaration order.
2460
2460
  *
@@ -2477,7 +2477,7 @@ declare class Machine<mDT> {
2477
2477
  * m.statesIn('inner'); // [ 'a', 'b' ]
2478
2478
  * ```
2479
2479
  *
2480
- * @typeparam mDT The type of the machine data member; usually omitted
2480
+ * @typeParam mDT The type of the machine data member; usually omitted
2481
2481
  *
2482
2482
  * @param groupName The group whose transitive member states are wanted.
2483
2483
  *
@@ -2525,7 +2525,7 @@ declare class Machine<mDT> {
2525
2525
  * off(); // unsubscribe
2526
2526
  * ```
2527
2527
  *
2528
- * @typeparam Ev The event name (drives the detail type).
2528
+ * @typeParam Ev The event name (drives the detail type).
2529
2529
  * @param name The event name to subscribe to.
2530
2530
  * @param filterOrFn Either a filter object or, when calling the no-filter
2531
2531
  * form, the handler itself.
@@ -2546,7 +2546,7 @@ declare class Machine<mDT> {
2546
2546
  * m.once('terminal', e => console.log(`done at ${e.state}`));
2547
2547
  * ```
2548
2548
  *
2549
- * @typeparam Ev The event name.
2549
+ * @typeParam Ev The event name.
2550
2550
  * @param name The event name.
2551
2551
  * @param filterOrFn A filter object or the handler (no-filter form).
2552
2552
  * @param maybeFn The handler, when a filter was supplied.
@@ -3050,7 +3050,7 @@ declare class Machine<mDT> {
3050
3050
  * - When multiple edges exist between two states with different `kind`
3051
3051
  * values, only the first edge's kind is used to pick the edge-type hook.
3052
3052
  *
3053
- * @typeparam mDT The type of the machine data member; usually omitted.
3053
+ * @typeParam mDT The type of the machine data member; usually omitted.
3054
3054
  *
3055
3055
  * @param newStateOrAction The target state name (for a plain or forced
3056
3056
  * transition) or the action name (when `wasAction` is true).
@@ -3102,7 +3102,7 @@ declare class Machine<mDT> {
3102
3102
  *
3103
3103
  * Notice that the machine's current state, `e`, is not in the returned list.
3104
3104
  *
3105
- * @typeparam mDT The type of the machine data member; usually omitted
3105
+ * @typeParam mDT The type of the machine data member; usually omitted
3106
3106
  *
3107
3107
  */
3108
3108
  get history(): [string, mDT][];
@@ -3135,7 +3135,7 @@ declare class Machine<mDT> {
3135
3135
  *
3136
3136
  * Notice that the machine's current state, `e`, is in the returned list.
3137
3137
  *
3138
- * @typeparam mDT The type of the machine data member; usually omitted
3138
+ * @typeParam mDT The type of the machine data member; usually omitted
3139
3139
  *
3140
3140
  */
3141
3141
  get history_inclusive(): [string, mDT][];
@@ -3154,7 +3154,7 @@ declare class Machine<mDT> {
3154
3154
  * foo.history_length; // 5
3155
3155
  * ```
3156
3156
  *
3157
- * @typeparam mDT The type of the machine data member; usually omitted
3157
+ * @typeParam mDT The type of the machine data member; usually omitted
3158
3158
  *
3159
3159
  */
3160
3160
  get history_length(): number;
@@ -3171,7 +3171,7 @@ declare class Machine<mDT> {
3171
3171
  * light.state(); // 'green'
3172
3172
  * ```
3173
3173
  *
3174
- * @typeparam mDT The type of the machine data member; usually omitted
3174
+ * @typeParam mDT The type of the machine data member; usually omitted
3175
3175
  *
3176
3176
  * @param actionName The action to engage
3177
3177
  *
@@ -3198,7 +3198,7 @@ declare class Machine<mDT> {
3198
3198
  * // { shape: 'circle' }
3199
3199
  * ```
3200
3200
  *
3201
- * @typeparam mDT The type of the machine data member; usually omitted
3201
+ * @typeParam mDT The type of the machine data member; usually omitted
3202
3202
  *
3203
3203
  * @returns The {@link JssmStateConfig} for standard states.
3204
3204
  *
@@ -3224,7 +3224,7 @@ declare class Machine<mDT> {
3224
3224
  * // { shape: 'circle' }
3225
3225
  * ```
3226
3226
  *
3227
- * @typeparam mDT The type of the machine data member; usually omitted
3227
+ * @typeParam mDT The type of the machine data member; usually omitted
3228
3228
  *
3229
3229
  * @returns The {@link JssmStateConfig} for hooked states.
3230
3230
  *
@@ -3249,7 +3249,7 @@ declare class Machine<mDT> {
3249
3249
  * // { shape: 'circle' }
3250
3250
  * ```
3251
3251
  *
3252
- * @typeparam mDT The type of the machine data member; usually omitted
3252
+ * @typeParam mDT The type of the machine data member; usually omitted
3253
3253
  *
3254
3254
  * @returns The {@link JssmStateConfig} for start states.
3255
3255
  *
@@ -3279,7 +3279,7 @@ declare class Machine<mDT> {
3279
3279
  * // { shape: 'circle' }
3280
3280
  * ```
3281
3281
  *
3282
- * @typeparam mDT The type of the machine data member; usually omitted
3282
+ * @typeParam mDT The type of the machine data member; usually omitted
3283
3283
  *
3284
3284
  * @returns The {@link JssmStateConfig} for end states.
3285
3285
  *
@@ -3304,7 +3304,7 @@ declare class Machine<mDT> {
3304
3304
  * // { shape: 'circle' }
3305
3305
  * ```
3306
3306
  *
3307
- * @typeparam mDT The type of the machine data member; usually omitted
3307
+ * @typeParam mDT The type of the machine data member; usually omitted
3308
3308
  *
3309
3309
  * @returns The {@link JssmStateConfig} for terminal states.
3310
3310
  *
@@ -3326,7 +3326,7 @@ declare class Machine<mDT> {
3326
3326
  * // { shape: 'circle' }
3327
3327
  * ```
3328
3328
  *
3329
- * @typeparam mDT The type of the machine data member; usually omitted
3329
+ * @typeParam mDT The type of the machine data member; usually omitted
3330
3330
  *
3331
3331
  * @returns The {@link JssmStateConfig} for the active state.
3332
3332
  *
@@ -3598,7 +3598,7 @@ declare class Machine<mDT> {
3598
3598
  * m.resolve_state_config('working').color; // '#ffa500ff' — from group &busy
3599
3599
  * ```
3600
3600
  *
3601
- * @typeparam mDT The type of the machine data member; usually omitted
3601
+ * @typeParam mDT The type of the machine data member; usually omitted
3602
3602
  *
3603
3603
  * @param state The state to compute the composite config for.
3604
3604
  *
@@ -3621,7 +3621,7 @@ declare class Machine<mDT> {
3621
3621
  * winning over outer), then the per-state config, and finally — for the
3622
3622
  * current state only — the active overlay. Last wins at every tier.
3623
3623
  *
3624
- * @typeparam mDT The type of the machine data member; usually omitted
3624
+ * @typeParam mDT The type of the machine data member; usually omitted
3625
3625
  *
3626
3626
  * @param state The state to compute the composite style for.
3627
3627
  *
@@ -3655,7 +3655,7 @@ declare class Machine<mDT> {
3655
3655
  * light.state(); // 'yellow'
3656
3656
  * ```
3657
3657
  *
3658
- * @typeparam mDT The type of the machine data member; usually omitted
3658
+ * @typeParam mDT The type of the machine data member; usually omitted
3659
3659
  *
3660
3660
  * @param actionName The action to engage
3661
3661
  *
@@ -3688,7 +3688,7 @@ declare class Machine<mDT> {
3688
3688
  * light.state(); // 'green'
3689
3689
  * ```
3690
3690
  *
3691
- * @typeparam mDT The type of the machine data member; usually omitted
3691
+ * @typeParam mDT The type of the machine data member; usually omitted
3692
3692
  *
3693
3693
  * @param newState The state to switch to
3694
3694
  *
@@ -3710,7 +3710,7 @@ declare class Machine<mDT> {
3710
3710
  * light.state(); // 'green'
3711
3711
  * ```
3712
3712
  *
3713
- * @typeparam mDT The type of the machine data member; usually omitted
3713
+ * @typeParam mDT The type of the machine data member; usually omitted
3714
3714
  *
3715
3715
  * @param newState The state to switch to
3716
3716
  *
@@ -3735,7 +3735,7 @@ declare class Machine<mDT> {
3735
3735
  * light.state(); // 'off'
3736
3736
  * ```
3737
3737
  *
3738
- * @typeparam mDT The type of the machine data member; usually omitted
3738
+ * @typeParam mDT The type of the machine data member; usually omitted
3739
3739
  *
3740
3740
  * @param newState The state to switch to
3741
3741
  *