@rb-games/core 0.1.0

package/dist/state-machine/guards.d.ts

@@ -0,0 +1,151 @@
+import type { TransitionGuard } from './types';
+/**
+ * Built-in guard functions for common transition validation scenarios
+ *
+ * Guards control whether state transitions are allowed.
+ * Return true to allow transition, false to block it.
+ *
+ * @example
+ * ```typescript
+ * import { guards } from '@rb-games/core/state-machine';
+ *
+ * .guard('canEnter', guards.and(
+ *   guards.hasData('balance'),
+ *   guards.dataGreaterThan('balance', 0)
+ * ))
+ * ```
+ */
+export declare const guards: {
+    /**
+     * Always allow transition
+     *
+     * @returns Guard that always returns true
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.always())
+     * ```
+     */
+    always: () => TransitionGuard;
+    /**
+     * Never allow transition
+     *
+     * @returns Guard that always returns false
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.never())
+     * ```
+     */
+    never: () => TransitionGuard;
+    /**
+     * Check if data key exists and is not null/undefined
+     *
+     * @template TData - Type of state data
+     * @param key - Data key to check
+     * @returns Guard that checks if key exists
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.hasData('balance'))
+     * ```
+     */
+    hasData: <TData = any>(key: keyof TData) => TransitionGuard<TData>;
+    /**
+     * Check if data key equals a specific value
+     *
+     * @template TData - Type of state data
+     * @param key - Data key to check
+     * @param value - Value to compare against
+     * @returns Guard that checks equality
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.dataEquals('gameMode', 'normal'))
+     * ```
+     */
+    dataEquals: <TData = any>(key: keyof TData, value: any) => TransitionGuard<TData>;
+    /**
+     * Check if data key is greater than a value
+     *
+     * @template TData - Type of state data
+     * @param key - Data key to check (must be number)
+     * @param value - Value to compare against
+     * @returns Guard that checks if key > value
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.dataGreaterThan('balance', 0))
+     * ```
+     */
+    dataGreaterThan: <TData = any>(key: keyof TData, value: number) => TransitionGuard<TData>;
+    /**
+     * Check if data key is less than a value
+     *
+     * @template TData - Type of state data
+     * @param key - Data key to check (must be number)
+     * @param value - Value to compare against
+     * @returns Guard that checks if key < value
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.dataLessThan('lives', 3))
+     * ```
+     */
+    dataLessThan: <TData = any>(key: keyof TData, value: number) => TransitionGuard<TData>;
+    /**
+     * Combine multiple guards with AND logic
+     *
+     * All guards must return true for transition to be allowed.
+     *
+     * @template TData - Type of state data
+     * @param guards - Guards to combine
+     * @returns Guard that checks all guards
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.and(
+     *   guards.hasData('balance'),
+     *   guards.dataGreaterThan('balance', 10),
+     *   (ctx) => ctx.data.isActive
+     * ))
+     * ```
+     */
+    and: <TData = any>(...guards: TransitionGuard<TData>[]) => TransitionGuard<TData>;
+    /**
+     * Combine multiple guards with OR logic
+     *
+     * At least one guard must return true for transition to be allowed.
+     *
+     * @template TData - Type of state data
+     * @param guards - Guards to combine
+     * @returns Guard that checks any guard
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.or(
+     *   guards.dataEquals('mode', 'demo'),
+     *   guards.dataGreaterThan('balance', 0)
+     * ))
+     * ```
+     */
+    or: <TData = any>(...guards: TransitionGuard<TData>[]) => TransitionGuard<TData>;
+    /**
+     * Negate a guard (NOT logic)
+     *
+     * Returns opposite of the guard's result.
+     *
+     * @template TData - Type of state data
+     * @param guard - Guard to negate
+     * @returns Guard that returns opposite result
+     *
+     * @example
+     * ```typescript
+     * .guard('canEnter', guards.not(
+     *   guards.dataEquals('isLocked', true)
+     * ))
+     * ```
+     */
+    not: <TData = any>(guard: TransitionGuard<TData>) => TransitionGuard<TData>;
+};
+//# sourceMappingURL=guards.d.ts.map

package/dist/state-machine/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../state-machine/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM;IACjB;;;;;;;;;OASG;kBACS,eAAe;IAE3B;;;;;;;;;OASG;iBACQ,eAAe;IAE1B;;;;;;;;;;;OAWG;cACO,KAAK,aAAa,MAAM,KAAK,KAAG,eAAe,CAAC,KAAK,CAAC;IAIhE;;;;;;;;;;;;OAYG;iBACU,KAAK,aAAa,MAAM,KAAK,SAAS,GAAG,KAAG,eAAe,CAAC,KAAK,CAAC;IAI/E;;;;;;;;;;;;OAYG;sBACe,KAAK,aAAa,MAAM,KAAK,SAAS,MAAM,KAAG,eAAe,CAAC,KAAK,CAAC;IAIvF;;;;;;;;;;;;OAYG;mBACY,KAAK,aAAa,MAAM,KAAK,SAAS,MAAM,KAAG,eAAe,CAAC,KAAK,CAAC;IAIpF;;;;;;;;;;;;;;;;;OAiBG;UACG,KAAK,mBAAmB,eAAe,CAAC,KAAK,CAAC,EAAE,KAAG,eAAe,CAAC,KAAK,CAAC;IAU/E;;;;;;;;;;;;;;;;OAgBG;SACE,KAAK,mBAAmB,eAAe,CAAC,KAAK,CAAC,EAAE,KAAG,eAAe,CAAC,KAAK,CAAC;IAU9E;;;;;;;;;;;;;;;OAeG;UACG,KAAK,eAAe,eAAe,CAAC,KAAK,CAAC,KAAG,eAAe,CAAC,KAAK,CAAC;CAG1E,CAAC"}

package/dist/state-machine/index.d.ts

@@ -0,0 +1,5 @@
+export { StateMachine } from './StateMachine';
+export { ConfigBuilder, createConfig } from './ConfigBuilder';
+export { guards } from './guards';
+export type { StateKey, ModeKey, ScopeKey, StateContext, StateDefinition, ModeDefinition, StateMachineConfig, TransitionOptions, TransitionGuard, StateHook, ResolverFunction, ConfigValue, ScopeConfig, StateMachineEvents, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/state-machine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../state-machine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,YAAY,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,SAAS,CAAC"}