@dxyl/utils 1.3.4 → 1.3.6

package/types/state/StateMachine.d.ts

@@ -0,0 +1,149 @@
+export interface StateMachineConfig<S extends string, E extends string, C> {
+    initial: S;
+    states: {
+        [K in S]: {
+            on?: {
+                [K in E]?: {
+                    target: S;
+                    action?: (context: C, event: {
+                        type: E;
+                        prevState: S;
+                        payload?: any;
+                    }, instance: StateMachine<S, E, C>) => C;
+                };
+            };
+            onEnter?: (context: C, instance: StateMachine<S, E, C>) => void;
+            onExit?: (context: C, instance: StateMachine<S, E, C>) => void;
+        };
+    };
+    context: C;
+}
+export declare class StateMachine<S extends string, E extends string, C> {
+    private currentState;
+    private context;
+    private config;
+    private listeners;
+    constructor(config: StateMachineConfig<S, E, C>);
+    getState(): S;
+    getContext(): C;
+    send(eventType: E, payload?: any): boolean;
+    subscribe(listener: (state: S, context: C) => void): () => void;
+    reset(): void;
+}
+/***
+ * // 定义状态
+type LightState = 'off' | 'low' | 'medium' | 'high';
+
+// 定义事件
+type LightEvent = 'TURN_ON' | 'TURN_OFF' | 'INCREASE' | 'DECREASE';
+
+// 定义上下文（附加数据）
+interface LightContext {
+  brightness: number;
+  powerUsage: number;
+}
+
+// 创建配置
+const lightConfig: StateMachineConfig<LightState, LightEvent, LightContext> = {
+  initial: 'off',
+  context: {
+    brightness: 0,
+    powerUsage: 0
+  },
+  states: {
+    off: {
+      on: {
+        TURN_ON: {
+          target: 'low',
+          action: (ctx) => ({
+            ...ctx,
+            brightness: 10,
+            powerUsage: ctx.powerUsage + 5
+          })
+        }
+      },
+      onEnter: (ctx) => {
+        console.log('💡 灯已关闭，当前功耗:', ctx.powerUsage);
+      }
+    },
+    low: {
+      on: {
+        TURN_OFF: {
+          target: 'off',
+          action: (ctx) => ({
+            ...ctx,
+            brightness: 0,
+            powerUsage: ctx.powerUsage - 5
+          })
+        },
+        INCREASE: {
+          target: 'medium',
+          action: (ctx) => ({
+            ...ctx,
+            brightness: 50,
+            powerUsage: ctx.powerUsage + 10
+          })
+        }
+      },
+      onEnter: (ctx) => {
+        console.log('💡 低亮度模式，亮度:', ctx.brightness);
+      }
+    },
+    medium: {
+      on: {
+        DECREASE: {
+          target: 'low',
+          action: (ctx) => ({
+            ...ctx,
+            brightness: 10,
+            powerUsage: ctx.powerUsage - 10
+          })
+        },
+        INCREASE: {
+          target: 'high',
+          action: (ctx) => ({
+            ...ctx,
+            brightness: 100,
+            powerUsage: ctx.powerUsage + 15
+          })
+        }
+      },
+      onEnter: (ctx) => {
+        console.log('💡 中等亮度模式，亮度:', ctx.brightness);
+      }
+    },
+    high: {
+      on: {
+        DECREASE: {
+          target: 'medium',
+          action: (ctx) => ({
+            ...ctx,
+            brightness: 50,
+            powerUsage: ctx.powerUsage - 15
+          })
+        }
+      },
+      onEnter: (ctx) => {
+        console.log('💡 高亮度模式，亮度:', ctx.brightness);
+      }
+    }
+  }
+};
+
+// 使用状态机
+const lightMachine = new StateMachine(lightConfig);
+
+// 监听状态变化
+const unsubscribe = lightMachine.subscribe((state, context) => {
+  console.log(`状态变更为: ${state}, 亮度: ${context.brightness}`);
+});
+
+// 发送事件
+lightMachine.send('TURN_ON');   // off -> low
+lightMachine.send('INCREASE');  // low -> medium
+lightMachine.send('INCREASE');  // medium -> high
+lightMachine.send('DECREASE');  // high -> medium
+lightMachine.send('TURN_OFF');  // medium -> off
+
+unsubscribe();
+ */ 

package/types/state/StateMachinePlus.d.ts

@@ -0,0 +1,40 @@
+export interface State {
+    name?: string;
+    transitions: string[];
+    onEnter?: (context: {
+        from: string;
+        eventData?: any;
+        data: any;
+    }) => boolean | void;
+    onState?: () => any;
+    onExit?: (context: {
+        to: string;
+        data: any;
+    }) => boolean | void;
+    onUpdate?: (data: any, elapsedMs: number) => any;
+}
+export interface StateMachineDescription {
+    start: string;
+    states: {
+        [name: string]: State;
+    };
+}
+export type PossibleStates<TMachine> = TMachine extends StateMachineDescription ? Extract<keyof TMachine['states'], string> : never;
+export interface StateMachineState {
+    data: any;
+    currentState: string;
+}
+export declare class StateMachine<TPossibleStates extends string, TData> {
+    startState: State;
+    private _currentState;
+    get currentState(): State;
+    set currentState(state: State);
+    states: Map<string, State>;
+    data?: TData;
+    static create<TMachine extends StateMachineDescription, TData>(machineDescription: TMachine, data?: TData): StateMachine<PossibleStates<TMachine>, TData>;
+    in(state: TPossibleStates): boolean;
+    go(stateName: TPossibleStates, eventData?: any): boolean;
+    update(elapsedMs: number): void;
+    save(saveKey: string): void;
+    restore(saveKey: string): void;
+}

package/types/stats.module.d.ts

@@ -1,3 +1,3 @@
-import Stats = require("stats.js");
-
-export default Stats;
+import Stats = require("stats.js");
+
+export default Stats;

package/types/utils/token.d.ts

@@ -0,0 +1 @@
+export {};