sequence-controller 1.0.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 egorkk1211@gmail.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+# SequenceController
+
+Small engine for handling **step combinations and sequences**.
+
+Supports:
+
+- step combos (`A + B`)
+- combo sequences (`A+B → C`)
+- scoped actions (same combos in different contexts)
+- sequence timeouts
+
+---
+
+## Install
+
+```bash
+npm install sequence-controller
+```
+
+---
+
+## Basic usage
+
+```ts
+const controller = new SequenceController<string>();
+
+controller.register(["Ctrl", "S"], {
+  handler: () => console.log("Save"),
+});
+
+controller.emitStep("Ctrl");
+controller.emitStep("S");
+```
+
+---
+
+## Keyboard example
+
+```ts
+const controller = new SequenceController<string>();
+controller.register(["Ctrl", "S"], {
+  handler: () => console.log("Save"),
+});
+
+window.addEventListener("keydown", (e) => {
+  const fired = controller.emitStep(e.key);
+
+  for (const [event, handler] of fired) {
+    handler(event);
+  }
+});
+
+window.addEventListener("keyup", (e) => {
+  controller.removeStep(e.key);
+});
+```
+
+---
+
+## Combos
+
+```ts
+controller.register(["Ctrl", "S"], {
+  handler: () => console.log("Save"),
+});
+```
+
+---
+
+## Sequences
+
+```ts
+controller.register(
+  [
+    ["Ctrl", "K"],
+    ["Ctrl", "C"],
+  ],
+  {
+    handler: () => console.log("Comment"),
+  },
+);
+```
+
+Execution order:
+
+    Ctrl+K → Ctrl+C
+
+---
+
+## Scope
+
+Scopes isolate actions so the same combos can exist in different
+contexts.
+
+```ts
+controller.register(["Enter"], { handler: submitForm }, "modal");
+
+controller.emitStep("Enter", "modal");
+```
+
+Default scope:
+
+    $global
+
+---
+
+## Sequence timeout
+
+Default: **3 seconds**
+
+```ts
+controller.register([["A"], ["B"]], {
+  clearDuration: 5,
+  handler: () => console.log("Triggered"),
+});
+```
+
+---
+
+## API
+
+### register(sequence, setup, scope?)
+
+Registers an action.
+
+```ts
+register(
+  Combo | Sequence,
+  {
+    handler: (event) => void
+    clearDuration?: number
+  },
+  scope?: string
+): ActionId
+```
+
+---
+
+### emitStep(step, scope?)
+
+Processes a step.
+
+Returns actions to execute.
+
+```ts
+const fired = controller.emitStep(step);
+
+for (const [event, handler] of fired) {
+  handler(event);
+}
+```
+
+---
+
+### removeStep(step)
+
+Removes step from active steps.
+
+Used for events like `keyup`.
+
+---
+
+### unregister(id)
+
+Removes registered action.
+
+---
+
+## Event
+
+Handler receives:
+
+```ts
+{
+  sequence: Sequence;
+  activeSteps: Set;
+  timestamp: number;
+}
+```
+
+---
+
+## License
+
+MIT

package/dist/SequenceController.d.ts

@@ -0,0 +1,95 @@
+import type { ActionId, Combo, Fired, Scope, SequenceAction, Step, ToString } from "./types";
+/**
+ * SequenceController manages step combinations and sequences.
+ *
+ * It allows registering actions that should fire when specific
+ * combinations or ordered sequences of combinations occur.
+ *
+ * Steps represent currently active inputs (e.g. pressed keys).
+ * Actions are grouped by scopes so the same combinations can
+ * be reused in different contexts (e.g. editor, modal, global).
+ */
+export declare class SequenceController<T extends ToString> {
+    /** Currently active steps (global state). */
+    private activeSteps;
+    /**
+     * Index of actions grouped by scope.
+     *
+     * Structure:
+     * scope -> comboKey -> ComboIndexEntry[]
+     */
+    private scopedIndexes;
+    /**
+     * Current candidates for sequence progression.
+     *
+     * Stores partial progress of sequences that already matched
+     * one or more combos but haven't finished yet.
+     *
+     * Structure:
+     * scope -> actionId -> candidateState
+     */
+    private scopedCandidates;
+    /**
+     * Registers a new sequence action.
+     *
+     * @param sequence A single combo or an ordered sequence of combos.
+     * @param setup Action configuration (handler, clearDuration, etc.).
+     * @param scope Logical context where this action is active.
+     *
+     * @returns ActionId that can be used later to unregister the action.
+     */
+    register(sequence: Combo<T> | Combo<T>[], setup: Omit<SequenceAction<T>, "id" | "sequence">, scope?: Scope): ActionId;
+    /**
+     * Removes previously registered action.
+     *
+     * Also clears any pending sequence candidates associated
+     * with the removed action.
+     * @param id ID of the action to be deleted
+     */
+    unregister(id: ActionId): void;
+    /**
+     * Emits a new step.
+     *
+     * This method should be called whenever an input step occurs
+     * (e.g. keydown event).
+     *
+     * It checks whether the current active steps match any
+     * registered combos or progress any sequence.
+     *
+     * @param step Current step
+     * @param scope Current execution context
+     *
+     * @returns Array of [event, handler] tuples to be executed.
+     */
+    emitStep(step: Step<T>, scope?: Scope): Fired<T>;
+    /**
+     * Removes step from active steps set.
+     *
+     * Should be called when input step ends
+     * (e.g. keyup event).
+     * @param step Step to be deleted
+     */
+    removeStep(step: Step<T>): void;
+    /**
+     * Creates event object passed to action handlers.
+     */
+    private buildEvent;
+    /**
+     * Generates a unique key for a combo.
+     *
+     * Steps are sorted so combo order doesn't matter.
+     */
+    private comboKey;
+    /**
+     * Generates key representing currently active steps.
+     */
+    private activeKey;
+    /**
+     * Removes expired sequence candidates.
+     *
+     * Candidates expire if they are not continued within
+     * `clearDuration` seconds.
+     */
+    private cleanupCandidates;
+}
+//# sourceMappingURL=SequenceController.d.ts.map

package/dist/SequenceController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceController.d.ts","sourceRoot":"","sources":["../src/SequenceController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAGR,KAAK,EACL,KAAK,EACL,KAAK,EAEL,cAAc,EAEd,IAAI,EACJ,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;GASG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,QAAQ;IAChD,6CAA6C;IAC7C,OAAO,CAAC,WAAW,CAAgB;IACnC;;;;;OAKG;IACH,OAAO,CAAC,aAAa,CAAoC;IACzD;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB,CAAuC;IAE/D;;;;;;;;OAQG;IACH,QAAQ,CACN,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,EAC/B,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,UAAU,CAAC,EACjD,KAAK,GAAE,KAAiB,GACvB,QAAQ;IAiCX;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,QAAQ;IAYvB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,KAAiB,GAAG,KAAK,CAAC,CAAC,CAAC;IAiD3D;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAIxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAKhB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/SequenceController.js

@@ -0,0 +1,188 @@
+/**
+ * SequenceController manages step combinations and sequences.
+ *
+ * It allows registering actions that should fire when specific
+ * combinations or ordered sequences of combinations occur.
+ *
+ * Steps represent currently active inputs (e.g. pressed keys).
+ * Actions are grouped by scopes so the same combinations can
+ * be reused in different contexts (e.g. editor, modal, global).
+ */
+export class SequenceController {
+    /** Currently active steps (global state). */
+    activeSteps = new Set();
+    /**
+     * Index of actions grouped by scope.
+     *
+     * Structure:
+     * scope -> comboKey -> ComboIndexEntry[]
+     */
+    scopedIndexes = new Map();
+    /**
+     * Current candidates for sequence progression.
+     *
+     * Stores partial progress of sequences that already matched
+     * one or more combos but haven't finished yet.
+     *
+     * Structure:
+     * scope -> actionId -> candidateState
+     */
+    scopedCandidates = new Map();
+    /**
+     * Registers a new sequence action.
+     *
+     * @param sequence A single combo or an ordered sequence of combos.
+     * @param setup Action configuration (handler, clearDuration, etc.).
+     * @param scope Logical context where this action is active.
+     *
+     * @returns ActionId that can be used later to unregister the action.
+     */
+    register(sequence, setup, scope = "$global") {
+        const id = crypto.randomUUID();
+        const normalized = Array.isArray(sequence[0])
+            ? sequence
+            : [sequence];
+        if (!normalized[0] || normalized[0].length === 0)
+            throw Error("Empty sequence.");
+        const action = {
+            id,
+            sequence: normalized,
+            ...setup,
+        };
+        const actionIndex = this.scopedIndexes.get(scope) ?? new Map();
+        normalized.forEach((combo, index) => {
+            const key = this.comboKey(combo);
+            const list = actionIndex.get(key) ?? [];
+            list.push({
+                action,
+                index,
+            });
+            actionIndex.set(key, list);
+        });
+        this.scopedIndexes.set(scope, actionIndex);
+        return id;
+    }
+    /**
+     * Removes previously registered action.
+     *
+     * Also clears any pending sequence candidates associated
+     * with the removed action.
+     * @param id ID of the action to be deleted
+     */
+    unregister(id) {
+        for (const [scope, actionIndex] of this.scopedIndexes.entries()) {
+            actionIndex.delete(id);
+            this.scopedIndexes.set(scope, actionIndex);
+        }
+        for (const [scope, actionsCandidates] of this.scopedCandidates.entries()) {
+            actionsCandidates.delete(id);
+            this.scopedCandidates.set(scope, actionsCandidates);
+        }
+    }
+    /**
+     * Emits a new step.
+     *
+     * This method should be called whenever an input step occurs
+     * (e.g. keydown event).
+     *
+     * It checks whether the current active steps match any
+     * registered combos or progress any sequence.
+     *
+     * @param step Current step
+     * @param scope Current execution context
+     *
+     * @returns Array of [event, handler] tuples to be executed.
+     */
+    emitStep(step, scope = "$global") {
+        this.cleanupCandidates(scope);
+        const firedToNextStep = new Set();
+        const actionIndex = this.scopedIndexes.get(scope);
+        if (!actionIndex)
+            return [];
+        this.activeSteps.add(step);
+        const key = this.activeKey();
+        const actions = actionIndex.get(key);
+        if (!actions)
+            return [];
+        const actionsCandidates = this.scopedCandidates.get(scope) ?? new Map();
+        const emitActions = actions.filter(({ action, index }) => {
+            const comboIndex = actionsCandidates.get(action.id)?.index ?? 0;
+            const combo = action.sequence[comboIndex];
+            if (!combo || index !== comboIndex || firedToNextStep.has(action.id))
+                return false;
+            firedToNextStep.add(action.id);
+            if (comboIndex === action.sequence.length - 1) {
+                actionsCandidates.delete(action.id);
+                this.scopedCandidates.set(scope, actionsCandidates);
+                return true;
+            }
+            actionsCandidates.set(action.id, {
+                index: comboIndex + 1,
+                timestamp: Date.now(),
+                clearDuration: action.clearDuration,
+            });
+            this.scopedCandidates.set(scope, actionsCandidates);
+            return false;
+        });
+        const fired = [];
+        for (const { action } of emitActions) {
+            fired.push([this.buildEvent(action), action.handler]);
+        }
+        return fired;
+    }
+    /**
+     * Removes step from active steps set.
+     *
+     * Should be called when input step ends
+     * (e.g. keyup event).
+     * @param step Step to be deleted
+     */
+    removeStep(step) {
+        this.activeSteps.delete(step);
+    }
+    /**
+     * Creates event object passed to action handlers.
+     */
+    buildEvent(action) {
+        return {
+            sequence: action.sequence,
+            activeSteps: new Set(this.activeSteps),
+            timestamp: Date.now(),
+        };
+    }
+    /**
+     * Generates a unique key for a combo.
+     *
+     * Steps are sorted so combo order doesn't matter.
+     */
+    comboKey(combo) {
+        const strings = combo.map((step) => step.toString()).sort();
+        return JSON.stringify(strings);
+    }
+    /**
+     * Generates key representing currently active steps.
+     */
+    activeKey() {
+        const strings = [...this.activeSteps].map((step) => step.toString()).sort();
+        return JSON.stringify(strings);
+    }
+    /**
+     * Removes expired sequence candidates.
+     *
+     * Candidates expire if they are not continued within
+     * `clearDuration` seconds.
+     */
+    cleanupCandidates(scope) {
+        const now = Date.now();
+        const actionsCandidates = this.scopedCandidates.get(scope);
+        if (!actionsCandidates)
+            return;
+        for (const [id, { timestamp, clearDuration }] of actionsCandidates) {
+            const clearMs = (clearDuration ?? 3) * 1000;
+            if (now - timestamp > clearMs) {
+                actionsCandidates.delete(id);
+            }
+        }
+    }
+}
+//# sourceMappingURL=SequenceController.js.map

package/dist/SequenceController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SequenceController.js","sourceRoot":"","sources":["../src/SequenceController.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./SequenceController";
+export type { Step, Combo, Sequence, ToString, ActionId, SequenceEvent, Fired, SequenceActionHandler, SequenceAction, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,YAAY,EACV,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,KAAK,EACL,qBAAqB,EACrB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./SequenceController";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+export type ToString = {
+    toString: () => string;
+};
+export type ActionId = string;
+export type Scope = string;
+export type Step<T extends ToString> = T;
+export type Combo<T extends ToString> = Step<T>[];
+export type Sequence<T extends ToString> = Combo<T>[];
+export type SequenceEvent<T extends ToString> = {
+    sequence: Sequence<T>;
+    activeSteps: Set<T>;
+    timestamp: number;
+};
+export type Fired<T extends ToString> = [
+    SequenceEvent<T>,
+    SequenceActionHandler<T>
+][];
+export type SequenceActionHandler<T extends ToString, K extends SequenceEvent<T> = SequenceEvent<T>> = (e: K) => void;
+export type SequenceAction<T extends ToString> = {
+    id: ActionId;
+    sequence: Sequence<T>;
+    handler: SequenceActionHandler<T>;
+    clearDuration?: number;
+};
+export type ComboIndexEntry<T extends ToString> = {
+    action: SequenceAction<T>;
+    index: number;
+};
+export type ActionIndex<T extends ToString> = Map<ActionId, ComboIndexEntry<T>[]>;
+export type ActionCandidate = {
+    index: number;
+    timestamp: number;
+    clearDuration: number | undefined;
+};
+export type ActionsCandidates = Map<ActionId, ActionCandidate>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,CAAC;AAEzC,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAElD,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAEtD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,QAAQ,IAAI;IAC9C,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,QAAQ,IAAI;IACtC,aAAa,CAAC,CAAC,CAAC;IAChB,qBAAqB,CAAC,CAAC,CAAC;CACzB,EAAE,CAAC;AAEJ,MAAM,MAAM,qBAAqB,CAC/B,CAAC,SAAS,QAAQ,EAClB,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,IAC3C,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;AAEnB,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,QAAQ,IAAI;IAC/C,EAAE,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,QAAQ,IAAI;IAChD,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,QAAQ,IAAI,GAAG,CAC/C,QAAQ,EACR,eAAe,CAAC,CAAC,CAAC,EAAE,CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "sequence-controller",
+  "version": "1.0.0",
+  "description": "A small engine for handling step combos and sequences with scoped actions.",
+  "author": "egorkk1211@gmail.com",
+  "license": "MIT",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "keywords": [
+    "sequence",
+    "combo",
+    "hotkeys",
+    "typescript"
+  ],
+  "homepage": "https://github.com/Egor-source/sequence_builder/tree/main/packages/sequenceController",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/egorkrotov/sequence_builder.git",
+    "directory": "packages/sequenceController"
+  },
+  "bugs": {
+    "url": "https://github.com/Egor-source/sequence_builder/issues"
+  },
+  "devDependencies": {
+    "typescript": "^5.1.6"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}