canvasengine 2.0.0-beta.34 → 2.0.0-beta.36

package/dist/directives/KeyboardControls.d.ts

@@ -1,5 +1,4 @@
-import { Directive } from '../engine/directive';
-import { Element } from '../engine/reactive';
+import { ControlsBase, ControlOptions, Controls, BoundKey } from './ControlsBase';
 
 export declare enum Input {
     Break = "break",
@@ -142,42 +141,49 @@ export declare enum Input {
     BackQuote = "`",
     Altgr = "altgr"
 }
-export interface ControlOptions {
-    repeat?: boolean;
-    bind: string | string[];
-    keyUp?: Function;
-    keyDown?: Function;
-    delay?: number | {
-        duration: number;
-        otherControls?: (string)[];
-    };
-}
-export interface Controls {
-    [controlName: string]: ControlOptions;
-}
-type BoundKey = {
-    actionName: string;
-    options: ControlOptions;
-    parameters?: any;
-};
-export declare class KeyboardControls extends Directive {
+export type { ControlOptions, Controls, BoundKey };
+/**
+ * Keyboard input controls implementation
+ *
+ * Handles keyboard input events and maps them to control actions.
+ * Supports composite directions (diagonal movement) and key repeat functionality.
+ *
+ * @example
+ * ```ts
+ * const keyboardControls = new KeyboardControls();
+ * keyboardControls.setInputs({
+ *   up: {
+ *     repeat: true,
+ *     bind: Input.Up,
+ *     keyDown() {
+ *       console.log('Up pressed');
+ *     }
+ *   }
+ * });
+ * keyboardControls.start();
+ * ```
+ */
+export declare class KeyboardControls extends ControlsBase {
     private keyState;
-    private boundKeys;
-    private stop;
     private lastKeyPressed;
-    private _controlsOptions;
-    private interval;
-    private serverFps;
     private directionState;
-    onInit(element: Element): void;
-    onMount(element: Element): void;
-    onUpdate(props: any): void;
-    onDestroy(): void;
-    /** @internal */
-    preStep(): void;
-    private applyInput;
-    private setupListeners;
-    private bindKey;
+    /**
+     * Setup keyboard event listeners
+     */
+    protected setupListeners(): void;
+    /**
+     * Cleanup keyboard event listeners
+     */
+    protected cleanup(): void;
+    /**
+     * Process keyboard inputs each step
+     */
+    protected preStep(): void;
+    /**
+     * Apply input for a keyboard key
+     * Overrides base implementation to handle key state and repeat logic
+     */
+    protected applyInput(keyName: string): void;
     private applyKeyDown;
     private applyKeyUp;
     private applyKeyPress;
@@ -185,346 +191,29 @@ export declare class KeyboardControls extends Directive {
     private updateDirectionState;
     private getDirection;
     /**
-     * From the name of the entry, we retrieve the control information
-     *
-     * ```ts
-     * import { Input, inject, KeyboardControls } from '@rpgjs/client'
-     *
-     * const controls = inject(KeyboardControls)
-     * controls.getControl(Input.Enter)
-
-     * if (control) {
-     *    console.log(control.actionName) // action
-     * }
-     * ```
-     * @title Get Control
-     * @method getControl(inputName)
-     * @param {string} inputName
-     * @returns { { actionName: string, options: any } | undefined }
-     * @memberof KeyboardControls
-     */
-    getControl(inputName: string): BoundKey | undefined;
-    /**
-     * Returns all controls
-     *
-     * @method getControls()
-     * @since 4.2.0
-     * @returns { { [key: string]: BoundKey } }
-     * @memberof KeyboardControls
-     */
-    getControls(): {
-        [key: string]: BoundKey;
-    };
-    /**
-     * Triggers an input according to the name of the control
+     * Apply a control action programmatically
+     * Triggers keyboard events to simulate key presses
      *
+     * @param controlName - Name of the control
+     * @param isDown - Whether the key is pressed (true) or released (false)
+     * @returns Promise that resolves when the action is complete
+     * @example
      * ```ts
-     * import { Control, inject, KeyboardControls } from '@rpgjs/client'
-     *
-     * const controls = inject(KeyboardControls)
-     * controls.applyControl(Control.Action)
-     * ```
-     *
-     * You can put a second parameter or indicate on whether the key is pressed or released
+     * // Press a key
+     * await keyboardControls.applyControl('action', true);
      *
-     * ```ts
-     * import { Control, inject, KeyboardControls } from '@rpgjs/client'
+     * // Release a key
+     * await keyboardControls.applyControl('action', false);
      *
-     * const controls = inject(KeyboardControls)
-     * controls.applyControl(Control.Up, true) // keydown
-     * controls.applyControl(Control.Up, false) // keyup
+     * // Press and release (default)
+     * await keyboardControls.applyControl('action');
      * ```
-     * @title Apply Control
-     * @method applyControl(controlName,isDown)
-     * @param {string} controlName
-     * @param {boolean} [isDown]
-     * @returns {Promise<void>}
-     * @memberof KeyboardControls
      */
     applyControl(controlName: string | number, isDown?: boolean | undefined): Promise<void>;
     /**
-     * Stop listening to the inputs. Pressing a key won't do anything
-     *
-     * @title Stop Inputs
-     * @method stopInputs()
-     * @returns {void}
-     * @memberof KeyboardControls
-     */
-    stopInputs(): void;
-    /**
-     * Listen to the inputs again
-     *
-     * @title Listen Inputs
-     * @method listenInputs()
-     * @returns {void}
-     * @memberof KeyboardControls
+     * Resume listening to inputs after stopInputs() was called
+     * Also resets keyboard state
      */
     listenInputs(): void;
-    /**
-     * Assign custom inputs to the scene
-     *
-     * The object is the following:
-     *
-     * * the key of the object is the name of the control. Either it is existing controls (Up, Dow, Left, Right, Action, Back) or customized controls
-     * * The value is an object representing control information:
-     *      * repeat {boolean} The key can be held down to repeat the action. (false by default)
-     *      * bind {string | string[]} To which key is linked the control
-     *      * method {Function} Function to be triggered. If you do not set this property, the name of the control is sent directly to the server.
-     *      * delay {object|number} (since v3.2.0) Indicates how long (in milliseconds) the player can press the key again to perform the action
-     *          * delay.duration
-     *          * delay.otherControls {string | string[]} Indicates the other controls that will also have the delay at the same time
-     *
-     * ```ts
-     * import { Control, Input, inject, KeyboardControls } from '@rpgjs/client'
-     *
-     * const controls = inject(KeyboardControls)
-     * controls.setInputs({
-            [Control.Up]: {
-                repeat: true,
-                bind: Input.Up
-            },
-            [Control.Down]: {
-                repeat: true,
-                bind: Input.Down
-            },
-            [Control.Right]: {
-                repeat: true,
-                bind: Input.Right
-            },
-            [Control.Left]: {
-                repeat: true,
-                bind: Input.Left
-            },
-            [Control.Action]: {
-                bind: [Input.Space, Input.Enter]
-            },
-            [Control.Back]: {
-                bind: Input.Escape
-            },
-
-            // The myscustom1 control is sent to the server when the A key is pressed.
-            mycustom1: {
-                bind: Input.A
-            },
-
-            // the myAction method is executed when the B key is pressed
-            mycustom2: {
-                bind: Input.B,
-                method({ actionName }) {
-                    console.log('cool', actionName)
-                }
-            },
-
-            // The player can redo the action after 400ms
-            mycustom3: {
-                bind: Input.C,
-                delay: 400 // ms
-            },
-
-            // The player can redo the action (mycustom4) and the directions after 400ms
-            mycustom4: {
-                bind: Input.C,
-                delay: {
-                    duration: 400,
-                    otherControls: [Control.Up, Control.Down, Control.Left, Control.Right]
-                }
-            }
-        })
-     *
-     * ```
-     * @enum {string} Control
-     *
-     * Control.Up | up
-     * Control.Down | down
-     * Control.Left | left
-     * Control.Right | right
-     * Control.Action | action
-     * Control.Back | back
-     *
-     * @enum {string} Mouse Event
-     *
-     * click | Click
-     * dblclick | Double Click
-     * mousedown | Mouse Down
-     * mouseup | Mouse Up
-     * mouseover | Mouse Over
-     * mousemove | Mouse Move
-     * mouseout | Mouse Out
-     * contextmenu | Context Menu
-     *
-     *
-     * @enum {string} Input
-     *
-     * break | Pause
-    * backspace | Backspace / Delete
-    * tab | Tab
-    * clear | Clear
-    * enter | Enter
-    * shift | Shift
-    * ctrl | Control
-    * alt | Alt
-    * pause/break | Pause / Break
-    * caps lock | Caps Lock
-    * escape | Escape
-    * conversion | Conversion
-    * non-conversion | Non-conversion
-    * space | Space
-    * page up | Page Up
-    * page down | Page Down
-    * end | End
-    * home | Home
-    * left | Left Arrow
-    * up | Up Arrow
-    * right | Right Arrow
-    * down | Down Arrow
-    * select | Select
-    * print | Print
-    * execute | Execute
-    * Print Screen | Print Screen
-    * insert | Insert
-    * delete | Delete
-    * n0 | 0
-    * n1 | 1
-    * n2 | 2
-    * n3 | 3
-    * n4 | 4
-    * n5 | 5
-    * n6 | 6
-    * n7 | 7
-    * n8 | 8
-    * n9 | 9
-    * : | Colon
-    * semicolon (firefox), equals | Semicolon (Firefox), Equals
-    * < | Less Than
-    * equals (firefox) | Equals (Firefox)
-    * ß | Eszett
-    * @ | At
-    * a | A
-    * b | B
-    * c | C
-    * d | D
-    * e | E
-    * f | F
-    * g | G
-    * h | H
-    * i | I
-    * j | J
-    * k | K
-    * l | L
-    * m | M
-    * n | N
-    * o | O
-    * p | P
-    * q | Q
-    * r | R
-    * s | S
-    * t | T
-    * u | U
-    * v | V
-    * w | W
-    * x | X
-    * y | Y
-    * z | Z
-    * Windows Key / Left ⌘ / Chromebook Search key | Windows Key / Left Command ⌘ / Chromebook Search Key
-    * right window key | Right Windows Key
-    * Windows Menu / Right ⌘ | Windows Menu / Right Command ⌘
-    * numpad 0 | Numpad 0
-    * numpad 1 | Numpad 1
-    * numpad 2 | Numpad 2
-    * numpad 3 | Numpad 3
-    * numpad 4 | Numpad 4
-    * numpad 5 | Numpad 5
-    * numpad 6 | Numpad 6
-    * numpad 7 | Numpad 7
-    * numpad 8 | Numpad 8
-    * numpad 9 | Numpad 9
-    * multiply | Multiply
-    * add | Add
-    * numpad period (firefox) | Numpad Period (Firefox)
-    * subtract | Subtract
-    * decimal point | Decimal Point
-    * divide | Divide
-    * f1 | F1
-    * f2 | F2
-    * f3 | F3
-    * f4 | F4
-    * f5 | F5
-    * f6 | F6
-    * f7 | F7
-    * f8 | F8
-    * f9 | F9
-    * f10 | F10
-    * f11 | F11
-    * f12 | F12
-    * f13 | F13
-    * f14 | F14
-    * f15 | F15
-    * f16 | F16
-    * f17 | F17
-    * f18 | F18
-    * f19 | F19
-    * f20 | F20
-    * f21 | F21
-    * f22 | F22
-    * f23 | F23
-    * f24 | F24
-    * num lock | Num Lock
-    * scroll lock | Scroll Lock
-    * ^ | Caret
-    * ! | Exclamation Point
-    * # | Hash
-    * $ | Dollar Sign
-    * ù | Grave Accent U
-    * page backward | Page Backward
-    * page forward | Page Forward
-    * closing paren (AZERTY) | Closing Parenthesis (AZERTY)
-    * * | Asterisk
-    * ~ + * key | Tilde + Asterisk Key
-    * minus (firefox), mute/unmute | Minus (Firefox), Mute/Unmute
-    * decrease volume level | Decrease Volume Level
-    * increase volume level | Increase Volume Level
-    * next | Next
-    * previous | Previous
-    * stop | Stop
-    * play/pause | Play/Pause
-    * e-mail | Email
-    * mute/unmute (firefox) | Mute/Unmute (Firefox)
-    * decrease volume level (firefox) | Decrease Volume Level (Firefox)
-    * increase volume level (firefox) | Increase Volume Level (Firefox)
-    * semi-colon / ñ | Semicolon / ñ
-    * equal sign | Equal Sign
-    * comma | Comma
-    * dash | Dash
-    * period | Period
-    * forward slash / ç | Forward Slash / ç
-    * grave accent / ñ / æ | Grave Accent / ñ / æ
-    * ?, / or ° | ?, / or °
-    * numpad period (chrome) | Numpad Period (Chrome)
-    * open bracket | Open Bracket
-    * back slash | Backslash
-    * close bracket / å | Close Bracket / å
-    * single quote / ø | Single Quote / ø
-    * \` | Backtick
-    * left or right ⌘ key (firefox) | Left or Right Command Key (Firefox)
-    * altgr | AltGr
-    * < /git > | < /git >
-    * GNOME Compose Key | GNOME Compose Key
-    * ç | ç
-    * XF86Forward | XF86Forward
-    * XF86Back | XF86Back
-    * alphanumeric | Alphanumeric
-    * hiragana/katakana | Hiragana/Katakana
-    * half-width/full-width | Half-Width/Full-Width
-    * kanji | Kanji
-    * toggle touchpad | Toggle Touchpad
-     *
-     * @title Set Inputs
-     * @method setInputs(inputs)
-     * @param {object} inputs
-     * @memberof KeyboardControls
-     */
-    setInputs(inputs: Controls): void;
-    get options(): Controls;
 }
-export {};
 //# sourceMappingURL=KeyboardControls.d.ts.map

package/dist/directives/KeyboardControls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyboardControls.d.ts","sourceRoot":"","sources":["../../src/directives/KeyboardControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,oBAAY,KAAK;IACb,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,KAAK,gBAAgB;IACrB,QAAQ,cAAc;IACtB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,aAAa,mBAAmB;IAChC,KAAK,UAAU;IACf,MAAM,YAAY;IAClB,QAAQ,cAAc;IACtB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,IAAI,IAAI;IACR,EAAE,IAAI;IACN,KAAK,IAAI;IACT,IAAI,IAAI;IACR,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,WAAW,iBAAiB;IAC5B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,IAAI,MAAM;IACV,GAAG,MAAM;IACT,GAAG,MAAM;IACT,KAAK,MAAM;IACX,IAAI,MAAM;IACV,IAAI,MAAM;IACV,GAAG,MAAM;IACT,KAAK,MAAM;IACX,MAAM,MAAM;IACZ,IAAI,MAAM;IACV,KAAK,MAAM;IACX,SAAS,gCAAgC;IACzC,QAAQ,MAAM;IACd,MAAM,qBAAqB;IAC3B,IAAI,WAAM;IACV,EAAE,MAAM;IACR,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,CAAC,MAAM;IACP,SAAS,sDAAiD;IAC1D,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,OAAO,aAAa;IACpB,QAAQ,aAAa;IACrB,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,YAAY,kBAAkB;IAC9B,MAAM,WAAW;IACjB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,OAAO,aAAa;IACpB,UAAU,gBAAgB;IAC1B,gBAAgB,MAAM;IACtB,eAAe,MAAM;IACrB,IAAI,MAAM;IACV,MAAM,MAAM;IACZ,OAAO,WAAM;IACb,YAAY,kBAAkB;IAC9B,WAAW,iBAAiB;IAC5B,IAAI,MAAM;IACV,cAAc,0BAA0B;IACxC,cAAc,0BAA0B;IACxC,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,SAAS,eAAe;IACxB,KAAK,WAAW;IAChB,SAAS,wBAAmB;IAC5B,SAAS,eAAe;IACxB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,WAAW,2BAAsB;IACjC,WAAW,mCAAyB;IACpC,WAAW,iBAAiB;IAC5B,SAAS,eAAe;IACxB,YAAY,2BAAsB;IAClC,WAAW,0BAAqB;IAChC,SAAS,MAAM;IACf,KAAK,UAAU;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;KAC9B,CAAC;CACL;AACD,MAAM,WAAW,QAAQ;IACrB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC;CACzC;AAmLD,KAAK,QAAQ,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAA;CAAE,CAAA;AAEjF,qBAAa,gBAAiB,SAAQ,SAAS;IAC3C,OAAO,CAAC,QAAQ,CAKV;IACN,OAAO,CAAC,SAAS,CAEX;IACN,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAK;IAErB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,cAAc,CAUpB;IAEF,MAAM,CAAC,OAAO,EAAE,OAAO;IAWvB,OAAO,CAAC,OAAO,EAAE,OAAO;IAExB,QAAQ,CAAC,KAAK,KAAA;IAId,SAAS;IAMT,gBAAgB;IAChB,OAAO;IAsBP,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,YAAY;IAepB;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAInD;;;;;;;OAOG;IACH,WAAW,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE;IAI1C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7F;;;;;;;OAOG;IACH,UAAU;IAIV;;;;;;;OAOG;IACH,YAAY;IAKZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsQG;IACH,SAAS,CAAC,MAAM,EAAE,QAAQ;IAkB1B,IAAI,OAAO,IAAI,QAAQ,CAEtB;CACJ"}
+{"version":3,"file":"KeyboardControls.d.ts","sourceRoot":"","sources":["../../src/directives/KeyboardControls.ts"],"names":[],"mappings":"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"}

package/dist/directives/Shake.d.ts

@@ -0,0 +1,98 @@
+import { Container } from 'pixi.js';
+import { Directive } from '../engine/directive';
+import { Element } from '../engine/reactive';
+import { Trigger } from '../engine/trigger';
+import { SignalOrPrimitive } from '../components/types';
+
+export type ShakeProps = {
+    /**
+     * Trigger that activates the shake animation
+     * When the trigger is activated, the shake animation will start
+     */
+    trigger?: Trigger<any>;
+    /**
+     * Intensity of the shake effect (in pixels)
+     * @default 10
+     */
+    intensity?: SignalOrPrimitive<number>;
+    /**
+     * Duration of the shake animation in milliseconds
+     * @default 500
+     */
+    duration?: SignalOrPrimitive<number>;
+    /**
+     * Number of shake oscillations during the animation
+     * Higher values create more rapid shaking
+     * @default 10
+     */
+    frequency?: SignalOrPrimitive<number>;
+    /**
+     * Direction of the shake: 'x', 'y', or 'both'
+     * @default 'both'
+     */
+    direction?: SignalOrPrimitive<'x' | 'y' | 'both'>;
+    /**
+     * Callback function called when shake starts
+     */
+    onStart?: () => void;
+    /**
+     * Callback function called when shake completes
+     */
+    onComplete?: () => void;
+};
+/**
+ * Shake directive that animates a display object's position when a trigger is activated.
+ * Creates a shake effect by rapidly oscillating the x and/or y position.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with trigger
+ * const shakeTrigger = trigger();
+ *
+ * onMount(element) {
+ *   // Element will shake when trigger is activated
+ *   element.props.shake = { trigger: shakeTrigger };
+ * }
+ *
+ * // Trigger the shake
+ * shakeTrigger.start();
+ * ```
+ */
+export declare class Shake extends Directive {
+    private elementRef;
+    private originalPosition;
+    private progressSignal;
+    private shakeSubscription;
+    private positionEffect;
+    private currentShakeConfig;
+    /**
+     * Initializes the shake directive
+     * @param element - The element to attach the shake effect to
+     */
+    onInit(element: Element<Container>): void;
+    /**
+     * Mounts the shake directive and sets up trigger listener
+     * @param element - The element being mounted
+     */
+    onMount(element: Element<Container>): void;
+    /**
+     * Gets the shake props with default values
+     * @returns ShakeProps with defaults applied
+     */
+    get shakeProps(): ShakeProps;
+    /**
+     * Performs the shake animation using animatedSignal
+     * @param data - Optional data passed from the trigger that can override default options
+     */
+    private performShake;
+    /**
+     * Updates the shake directive when props change
+     * @param props - Updated props
+     */
+    onUpdate(props: any): void;
+    /**
+     * Cleans up the shake directive
+     */
+    onDestroy(): void;
+}
+//# sourceMappingURL=Shake.d.ts.map

package/dist/directives/Shake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Shake.d.ts","sourceRoot":"","sources":["../../src/directives/Shake.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAS,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAiB,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAIxD,MAAM,MAAM,UAAU,GAAG;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC;IAClD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,KAAM,SAAQ,SAAS;IAChC,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,kBAAkB,CAKV;IAEhB;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;IAIlC;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;IAoBnC;;;OAGG;IACH,IAAI,UAAU,IAAI,UAAU,CAQ3B;IAED;;;OAGG;YACW,YAAY;IAuG1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG;IAUnB;;OAEG;IACH,SAAS;CA8BZ"}

package/dist/directives/index.d.ts

@@ -1,2 +1,12 @@
-
+export * from './ControlsBase';
+export * from './KeyboardControls';
+export * from './GamepadControls';
+export * from './Controls';
+export * from './Scheduler';
+export * from './ViewportFollow';
+export * from './Sound';
+export * from './Drag';
+export * from './Transition';
+export * from './Shake';
+export * from './Flash';
 //# sourceMappingURL=index.d.ts.map

package/dist/directives/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/directives/index.ts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAA;AAC3B,OAAO,aAAa,CAAA;AACpB,OAAO,kBAAkB,CAAA;AAEzB,OAAO,SAAS,CAAA;AAChB,OAAO,QAAQ,CAAA;AACf,OAAO,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/directives/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/dist/engine/trigger.d.ts

@@ -1,4 +1,4 @@
-interface Listen<T = any> {
+export interface Listen<T = any> {
     config: T | undefined;
     seed: {
         config: T | undefined;
@@ -6,7 +6,7 @@ interface Listen<T = any> {
         resolve: (value: any) => void;
     };
 }
-interface Trigger<T = any> {
+export interface Trigger<T = any> {
     start: () => Promise<void>;
     listen: () => Listen<T> | undefined;
 }
@@ -47,5 +47,4 @@ export declare function trigger<T = any>(globalConfig?: T): Trigger<T>;
  * ```
  */
 export declare function on(triggerSignal: any, callback: (config: any) => void | Promise<void>): void;
-export {};
 //# sourceMappingURL=trigger.d.ts.map

package/dist/engine/trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/engine/trigger.ts"],"names":[],"mappings":"AAEA,UAAU,MAAM,CAAC,CAAC,GAAG,GAAG;IACtB,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;KAC/B,CAAC;CACH;AAED,UAAU,OAAO,CAAC,CAAC,GAAG,GAAG;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAEvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA0B7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAarF"}
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../src/engine/trigger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,GAAG;IAC7B,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,IAAI,EAAE;QACJ,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;KAC/B,CAAC;CACH;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,GAAG;IAC9B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAEvD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA0B7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAarF"}

package/dist/engine/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/engine/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGzC;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE7C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAiBvD;AAyBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,KAAK,EAAE,GAAG,EACV,eAAe,UAAQ,GACxB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA0BrB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAY/D;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAEnC;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAErC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5D,IAAI,CAUN;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACX,MAAM,CAIR"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/engine/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGzC;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE7C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAiBvD;AAyBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,KAAK,EAAE,GAAG,EACV,eAAe,UAAQ,GACxB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA0BrB;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAY/D;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAEnC;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAErC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5D,IAAI,CAaN;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACX,MAAM,CAIR"}