ts-spatial-navigation 1.0.0-beta.1

package/dist/constants.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Constants for Spatial Navigation
+ * Replaces magic numbers with named constants
+ */
+/**
+ * Keyboard key codes for navigation
+ */
+export declare const KeyCode: {
+    readonly ENTER: 13;
+    readonly LEFT: 37;
+    readonly UP: 38;
+    readonly RIGHT: 39;
+    readonly DOWN: 40;
+};
+export type KeyCodeValue = (typeof KeyCode)[keyof typeof KeyCode];
+/**
+ * Key code to direction mapping
+ */
+export declare const KEY_TO_DIRECTION: {
+    readonly 37: "left";
+    readonly 38: "up";
+    readonly 39: "right";
+    readonly 40: "down";
+};
+/**
+ * Reverse direction mapping
+ */
+export declare const REVERSE_DIRECTION: {
+    readonly left: "right";
+    readonly up: "down";
+    readonly right: "left";
+    readonly down: "up";
+};
+/**
+ * Grid configuration for spatial partitioning
+ * The navigation algorithm divides space into a 3x3 grid
+ *
+ *   0 | 1 | 2
+ *   ---------
+ *   3 | 4 | 5
+ *   ---------
+ *   6 | 7 | 8
+ */
+export declare const Grid: {
+    readonly SIZE: 3;
+    readonly TOTAL_CELLS: 9;
+    readonly TOP_LEFT: 0;
+    readonly TOP_CENTER: 1;
+    readonly TOP_RIGHT: 2;
+    readonly MIDDLE_LEFT: 3;
+    readonly MIDDLE_CENTER: 4;
+    readonly MIDDLE_RIGHT: 5;
+    readonly BOTTOM_LEFT: 6;
+    readonly BOTTOM_CENTER: 7;
+    readonly BOTTOM_RIGHT: 8;
+    readonly CORNERS: readonly [0, 2, 6, 8];
+};
+export type GridPosition = (typeof Grid)['TOP_LEFT' | 'TOP_CENTER' | 'TOP_RIGHT' | 'MIDDLE_LEFT' | 'MIDDLE_CENTER' | 'MIDDLE_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_CENTER' | 'BOTTOM_RIGHT'];
+/**
+ * Default configuration values
+ */
+export declare const Defaults: {
+    readonly SECTION_PREFIX: "section-";
+    readonly EVENT_PREFIX: "sn:";
+    readonly STRAIGHT_OVERLAP_THRESHOLD: 0.5;
+    readonly RESTRICT_MODE: "self-first";
+    readonly TAB_INDEX_IGNORE_LIST: "a, input, select, textarea, button, iframe, [contentEditable=true]";
+};
+/**
+ * Event names (without prefix)
+ */
+export declare const EventName: {
+    readonly WILL_MOVE: "willmove";
+    readonly WILL_FOCUS: "willfocus";
+    readonly WILL_UNFOCUS: "willunfocus";
+    readonly FOCUSED: "focused";
+    readonly UNFOCUSED: "unfocused";
+    readonly ENTER_DOWN: "enter-down";
+    readonly ENTER_UP: "enter-up";
+    readonly NAVIGATE_FAILED: "navigatefailed";
+};
+export type EventNameValue = (typeof EventName)[keyof typeof EventName];
+/**
+ * Restriction modes for section navigation
+ */
+export declare const RestrictMode: {
+    readonly SELF_FIRST: "self-first";
+    readonly SELF_ONLY: "self-only";
+    readonly NONE: "none";
+};
+export type RestrictModeValue = (typeof RestrictMode)[keyof typeof RestrictMode];
+/**
+ * Enter behavior options
+ */
+export declare const EnterTo: {
+    readonly LAST_FOCUSED: "last-focused";
+    readonly DEFAULT_ELEMENT: "default-element";
+    readonly NONE: "";
+};
+export type EnterToValue = (typeof EnterTo)[keyof typeof EnterTo];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;CAMV,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;CAiBP,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,IAAI,CAAC,CACpC,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,GACd,aAAa,GACb,eAAe,GACf,cAAc,CAAC,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;CASZ,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,98 @@
+/**
+ * Constants for Spatial Navigation
+ * Replaces magic numbers with named constants
+ */
+/**
+ * Keyboard key codes for navigation
+ */
+export const KeyCode = {
+    ENTER: 13,
+    LEFT: 37,
+    UP: 38,
+    RIGHT: 39,
+    DOWN: 40,
+};
+/**
+ * Key code to direction mapping
+ */
+export const KEY_TO_DIRECTION = {
+    [KeyCode.LEFT]: 'left',
+    [KeyCode.UP]: 'up',
+    [KeyCode.RIGHT]: 'right',
+    [KeyCode.DOWN]: 'down',
+};
+/**
+ * Reverse direction mapping
+ */
+export const REVERSE_DIRECTION = {
+    left: 'right',
+    up: 'down',
+    right: 'left',
+    down: 'up',
+};
+/**
+ * Grid configuration for spatial partitioning
+ * The navigation algorithm divides space into a 3x3 grid
+ *
+ *   0 | 1 | 2
+ *   ---------
+ *   3 | 4 | 5
+ *   ---------
+ *   6 | 7 | 8
+ */
+export const Grid = {
+    SIZE: 3,
+    TOTAL_CELLS: 9,
+    // Named positions
+    TOP_LEFT: 0,
+    TOP_CENTER: 1,
+    TOP_RIGHT: 2,
+    MIDDLE_LEFT: 3,
+    MIDDLE_CENTER: 4,
+    MIDDLE_RIGHT: 5,
+    BOTTOM_LEFT: 6,
+    BOTTOM_CENTER: 7,
+    BOTTOM_RIGHT: 8,
+    // Corner positions (used for overlap calculations)
+    CORNERS: [0, 2, 6, 8],
+};
+/**
+ * Default configuration values
+ */
+export const Defaults = {
+    SECTION_PREFIX: 'section-',
+    EVENT_PREFIX: 'sn:',
+    STRAIGHT_OVERLAP_THRESHOLD: 0.5,
+    RESTRICT_MODE: 'self-first',
+    TAB_INDEX_IGNORE_LIST: 'a, input, select, textarea, button, iframe, [contentEditable=true]',
+};
+/**
+ * Event names (without prefix)
+ */
+export const EventName = {
+    WILL_MOVE: 'willmove',
+    WILL_FOCUS: 'willfocus',
+    WILL_UNFOCUS: 'willunfocus',
+    FOCUSED: 'focused',
+    UNFOCUSED: 'unfocused',
+    ENTER_DOWN: 'enter-down',
+    ENTER_UP: 'enter-up',
+    NAVIGATE_FAILED: 'navigatefailed',
+};
+/**
+ * Restriction modes for section navigation
+ */
+export const RestrictMode = {
+    SELF_FIRST: 'self-first',
+    SELF_ONLY: 'self-only',
+    NONE: 'none',
+};
+/**
+ * Enter behavior options
+ */
+export const EnterTo = {
+    LAST_FOCUSED: 'last-focused',
+    DEFAULT_ELEMENT: 'default-element',
+    NONE: '',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,EAAE,EAAE,EAAE;IACN,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;CACA,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM;IACtB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI;IAClB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO;IACxB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM;CACd,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,OAAO;IACb,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,IAAI;CACF,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;IAEd,kBAAkB;IAClB,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IAEf,mDAAmD;IACnD,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU;CACtB,CAAC;AAaX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc,EAAE,UAAU;IAC1B,YAAY,EAAE,KAAK;IACnB,0BAA0B,EAAE,GAAG;IAC/B,aAAa,EAAE,YAAqB;IACpC,qBAAqB,EAAE,oEAAoE;CACnF,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,UAAU;IACrB,UAAU,EAAE,WAAW;IACvB,YAAY,EAAE,aAAa;IAC3B,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,eAAe,EAAE,gBAAgB;CACzB,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;CACJ,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAClC,IAAI,EAAE,EAAE;CACA,CAAC"}

package/dist/core.d.ts

@@ -0,0 +1,40 @@
+import type { Config, Direction, Priorities, Rect, SpatialEventDetail } from './types';
+export { getRect, partition, distanceBuilder } from './geometry';
+/**
+ * Sets the event prefix for custom events dispatched by the library.
+ * @param prefix The new prefix to use (e.g., 'spatial:')
+ */
+export declare const setEventPrefix: (prefix: string) => void;
+/**
+ * Gets the current event prefix.
+ * @returns The current event prefix
+ */
+export declare const getEventPrefix: () => string;
+export declare const prioritize: (priorities: Priorities) => Rect[] | null;
+export declare const navigate: (target: HTMLElement, direction: Direction, candidates: HTMLElement[], config: Config) => HTMLElement;
+export declare const parseSelector: (selector: string | NodeList | HTMLElement) => HTMLElement[];
+export declare const matchSelector: (elem: HTMLElement | null | undefined, selector: string | HTMLElement[] | HTMLElement) => boolean;
+export declare const getCurrentFocusedElement: () => HTMLElement | null;
+/**
+ * Merges multiple source objects into a new object.
+ * Properties from later sources override earlier ones.
+ * Undefined values are ignored.
+ *
+ * @param out - Base object to extend
+ * @param sources - Source objects to merge from
+ * @returns New merged object (does not mutate inputs)
+ */
+export declare function extend<T extends object>(out: object, source: T): T;
+export declare function extend<T extends object, U extends object>(out: object, source1: T, source2: U): T & U;
+export declare function extend<T extends object>(out: T, ...sources: object[]): T;
+/**
+ * Returns a new array with excluded elements removed.
+ * Does not mutate the original array.
+ *
+ * @param elemList - Array of elements to filter
+ * @param excludedElem - Element(s) to exclude
+ * @returns New filtered array
+ */
+export declare const exclude: <T>(elemList: T[], excludedElem: T | T[]) => T[];
+export declare const dispatch: (elem: HTMLElement, type: string, details?: SpatialEventDetail, cancelable?: boolean) => boolean;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EACT,UAAU,EAEV,IAAI,EACJ,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQjE;;;GAGG;AACH,eAAO,MAAM,cAAc,WAAY,MAAM,KAAG,IAE/C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,MAEjC,CAAC;AAEF,eAAO,MAAM,UAAU,8BAA6B,IAAI,EAAE,GAAG,IA8B5D,CAAC;AAEF,eAAO,MAAM,QAAQ,WACX,WAAW,aACR,SAAS,cACR,WAAW,EAAE,UACjB,MAAM,gBAoIf,CAAC;AAEF,eAAO,MAAM,aAAa,aAAc,MAAM,GAAG,QAAQ,GAAG,WAAW,KAAG,WAAW,EAgBpF,CAAC;AAEF,eAAO,MAAM,aAAa,SAClB,WAAW,GAAG,IAAI,GAAG,SAAS,YAC1B,MAAM,GAAG,WAAW,EAAE,GAAG,WAAW,KAC7C,OAUF,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAO,WAAW,GAAG,IAOzD,CAAC;AAEF;;;;;;;;GAQG;AAEH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;AAEpE,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvG,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;AAiB1E;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,kDAQnB,CAAC;AAEF,eAAO,MAAM,QAAQ,SACb,WAAW,QACX,MAAM,YACF,kBAAkB,2BAE3B,OAGF,CAAC"}

package/dist/core.js

@@ -0,0 +1,245 @@
+// Re-export geometry functions for backwards compatibility
+export { getRect, partition, distanceBuilder } from './geometry';
+import { getRect, partition, distanceBuilder } from './geometry';
+/*****************/
+/* Core Function */
+/*****************/
+let EVENT_PREFIX = 'sn:';
+/**
+ * Sets the event prefix for custom events dispatched by the library.
+ * @param prefix The new prefix to use (e.g., 'spatial:')
+ */
+export const setEventPrefix = (prefix) => {
+    EVENT_PREFIX = prefix;
+};
+/**
+ * Gets the current event prefix.
+ * @returns The current event prefix
+ */
+export const getEventPrefix = () => {
+    return EVENT_PREFIX;
+};
+export const prioritize = (priorities) => {
+    let destPriority = null;
+    for (let i = 0; i < priorities.length; i++) {
+        if (priorities[i].group.length) {
+            destPriority = priorities[i];
+            break;
+        }
+    }
+    if (!destPriority) {
+        return null;
+    }
+    const destDistance = destPriority.distance;
+    destPriority.group.sort((a, b) => {
+        for (let i = 0; i < destDistance.length; i++) {
+            const distance = destDistance[i];
+            const delta = distance(a) - distance(b);
+            if (delta) {
+                return delta;
+            }
+        }
+        return 0;
+    });
+    return destPriority.group;
+};
+export const navigate = (target, direction, candidates, config) => {
+    if (!target || !direction || !candidates || !candidates.length) {
+        return null;
+    }
+    const rects = [];
+    const targetRect = getRect(target);
+    if (!targetRect)
+        return null;
+    for (var i = 0; i < candidates.length; i++) {
+        var rect = getRect(candidates[i]);
+        if (rect)
+            rects.push(rect);
+    }
+    if (!rects.length)
+        return null;
+    const distanceFunction = distanceBuilder(targetRect);
+    const groups = partition(rects, targetRect, config.straightOverlapThreshold || 0.5);
+    const internalGroups = partition(groups[4], targetRect, config.straightOverlapThreshold || 0.5);
+    let priorities;
+    switch (direction) {
+        case 'left':
+            priorities = [
+                {
+                    group: internalGroups[0].concat(internalGroups[3]).concat(internalGroups[6]),
+                    distance: [distanceFunction.nearPlumbLineIsBetter, distanceFunction.topIsBetter]
+                },
+                {
+                    group: groups[3],
+                    distance: [distanceFunction.nearPlumbLineIsBetter, distanceFunction.topIsBetter]
+                },
+                {
+                    group: groups[0].concat(groups[6]),
+                    distance: [
+                        distanceFunction.nearHorizonIsBetter,
+                        distanceFunction.rightIsBetter,
+                        distanceFunction.nearTargetTopIsBetter
+                    ]
+                }
+            ];
+            break;
+        case 'right':
+            priorities = [
+                {
+                    group: internalGroups[2].concat(internalGroups[5]).concat(internalGroups[8]),
+                    distance: [distanceFunction.nearPlumbLineIsBetter, distanceFunction.topIsBetter]
+                },
+                {
+                    group: groups[5],
+                    distance: [distanceFunction.nearPlumbLineIsBetter, distanceFunction.topIsBetter]
+                },
+                {
+                    group: groups[2].concat(groups[8]),
+                    distance: [
+                        distanceFunction.nearHorizonIsBetter,
+                        distanceFunction.leftIsBetter,
+                        distanceFunction.nearTargetTopIsBetter
+                    ]
+                }
+            ];
+            break;
+        case 'up':
+            priorities = [
+                {
+                    group: internalGroups[0].concat(internalGroups[1]).concat(internalGroups[2]),
+                    distance: [distanceFunction.nearHorizonIsBetter, distanceFunction.leftIsBetter]
+                },
+                {
+                    group: groups[1],
+                    distance: [distanceFunction.nearHorizonIsBetter, distanceFunction.leftIsBetter]
+                },
+                {
+                    group: groups[0].concat(groups[2]),
+                    distance: [
+                        distanceFunction.nearPlumbLineIsBetter,
+                        distanceFunction.bottomIsBetter,
+                        distanceFunction.nearTargetLeftIsBetter
+                    ]
+                }
+            ];
+            break;
+        case 'down':
+            priorities = [
+                {
+                    group: internalGroups[6].concat(internalGroups[7]).concat(internalGroups[8]),
+                    distance: [distanceFunction.nearHorizonIsBetter, distanceFunction.leftIsBetter]
+                },
+                {
+                    group: groups[7],
+                    distance: [distanceFunction.nearHorizonIsBetter, distanceFunction.leftIsBetter]
+                },
+                {
+                    group: groups[6].concat(groups[8]),
+                    distance: [
+                        distanceFunction.nearPlumbLineIsBetter,
+                        distanceFunction.topIsBetter,
+                        distanceFunction.nearTargetLeftIsBetter
+                    ]
+                }
+            ];
+            break;
+        default:
+            return null;
+    }
+    if (config.straightOnly)
+        priorities.pop();
+    const destGroup = prioritize(priorities);
+    if (!destGroup)
+        return null;
+    let dest = null;
+    if (config.rememberSource &&
+        config.previous &&
+        config.previous.destination === target &&
+        config.previous.reverse === direction) {
+        for (let j = 0; j < destGroup.length; j++) {
+            if (destGroup[j].element === config.previous.target) {
+                dest = destGroup[j].element;
+                break;
+            }
+        }
+    }
+    if (!dest) {
+        dest = destGroup[0].element;
+    }
+    return dest;
+};
+export const parseSelector = (selector) => {
+    let result = [];
+    try {
+        if (selector) {
+            if (typeof selector === 'string') {
+                result = [].slice.call(document.querySelectorAll(selector));
+            }
+            else if (selector instanceof NodeList) {
+                result = [].slice.call(selector);
+            }
+            else if (selector instanceof HTMLElement) {
+                result = [selector];
+            }
+        }
+    }
+    catch (err) {
+        console.error(err);
+    }
+    return result;
+};
+export const matchSelector = (elem, selector) => {
+    if (!elem)
+        return false;
+    if (typeof selector === 'string') {
+        return elem.matches(selector);
+    }
+    else if (Array.isArray(selector)) {
+        return selector.includes(elem);
+    }
+    else if (selector instanceof HTMLElement) {
+        return elem === selector;
+    }
+    return false;
+};
+export const getCurrentFocusedElement = () => {
+    const activeElement = document.activeElement;
+    if (activeElement && activeElement !== document.body) {
+        return activeElement;
+    }
+    else {
+        return null;
+    }
+};
+// Implementation
+export function extend(out, ...sources) {
+    const result = { ...out };
+    for (const source of sources) {
+        if (source) {
+            for (const key of Object.keys(source)) {
+                const value = source[key];
+                if (value !== undefined) {
+                    result[key] = value;
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Returns a new array with excluded elements removed.
+ * Does not mutate the original array.
+ *
+ * @param elemList - Array of elements to filter
+ * @param excludedElem - Element(s) to exclude
+ * @returns New filtered array
+ */
+export const exclude = (elemList, excludedElem) => {
+    const excludedSet = new Set(Array.isArray(excludedElem) ? excludedElem : [excludedElem]);
+    return elemList.filter((elem) => !excludedSet.has(elem));
+};
+export const dispatch = (elem, type, details, cancelable = true) => {
+    const evt = new CustomEvent(EVENT_PREFIX + type, { bubbles: true, cancelable, detail: details });
+    return elem.dispatchEvent(evt);
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/factory.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Factory Module
+ * Creates isolated instances of spatial navigation.
+ * Enables multiple independent navigation contexts.
+ */
+import type { Direction, GlobalConfig, SectionConfig, AddSectionConfig } from './types';
+/**
+ * Options for creating a spatial navigation instance.
+ */
+export interface CreateSpatialNavigationOptions {
+    /**
+     * Initial global configuration.
+     */
+    config?: Partial<GlobalConfig>;
+    /**
+     * Whether to auto-initialize on creation.
+     * @default false
+     */
+    autoInit?: boolean;
+}
+/**
+ * Public API interface for spatial navigation.
+ * This interface documents all public methods available on the navigation instance.
+ */
+export interface SpatialNavigationAPI {
+    init(): void;
+    uninit(): void;
+    clear(): void;
+    setConfig(config: Partial<GlobalConfig>): void;
+    getConfig(): GlobalConfig;
+    add(config: AddSectionConfig): string;
+    add(id: string, config?: Partial<SectionConfig>): string;
+    remove(id: string): boolean;
+    disable(id: string): boolean;
+    enable(id: string): boolean;
+    set(id: string, config: Partial<SectionConfig>): boolean;
+    get(id: string): SectionConfig | undefined;
+    focus(target?: string | HTMLElement, silent?: boolean): boolean;
+    move(direction: Direction, selector?: string): boolean;
+    pause(): void;
+    resume(): void;
+    isPaused(): boolean;
+    makeFocusable(sectionId?: string): void;
+    setDefaultSection(id: string): void;
+}
+/**
+ * Creates a new spatial navigation instance.
+ *
+ * This factory function allows creating isolated navigation contexts,
+ * useful for:
+ * - Multiple independent navigation areas
+ * - Testing with isolated state
+ * - Micro-frontends or iframe scenarios
+ *
+ * @example
+ * ```typescript
+ * // Create an instance with custom config
+ * const nav = createSpatialNavigation({
+ *   config: {
+ *     straightOnly: true,
+ *     eventPrefix: 'custom:'
+ *   },
+ *   autoInit: true
+ * });
+ *
+ * // Add sections
+ * nav.add({ selector: '.nav-item' });
+ *
+ * // Navigate
+ * nav.move('right');
+ * ```
+ *
+ * @param options - Configuration options for the instance
+ * @returns A spatial navigation instance with the full API
+ */
+export declare function createSpatialNavigation(_options?: CreateSpatialNavigationOptions): SpatialNavigationAPI;
+/**
+ * Type for the default singleton instance.
+ * Includes all public API methods plus legacy compatibility.
+ */
+export type SpatialNavigationInstance = SpatialNavigationAPI & {
+    /**
+     * @deprecated Use getConfig() instead
+     */
+    globalConfig: GlobalConfig;
+};
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IAEnC,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;IAGd,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC/C,SAAS,IAAI,YAAY,CAAC;IAG1B,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC;IACzD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAG3C,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAChE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAGvD,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,IAAI,OAAO,CAAC;IAGpB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,8BAA8B,GACxC,oBAAoB,CAStB;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG;IAC7D;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC"}

package/dist/factory.js

@@ -0,0 +1,44 @@
+/**
+ * Factory Module
+ * Creates isolated instances of spatial navigation.
+ * Enables multiple independent navigation contexts.
+ */
+/**
+ * Creates a new spatial navigation instance.
+ *
+ * This factory function allows creating isolated navigation contexts,
+ * useful for:
+ * - Multiple independent navigation areas
+ * - Testing with isolated state
+ * - Micro-frontends or iframe scenarios
+ *
+ * @example
+ * ```typescript
+ * // Create an instance with custom config
+ * const nav = createSpatialNavigation({
+ *   config: {
+ *     straightOnly: true,
+ *     eventPrefix: 'custom:'
+ *   },
+ *   autoInit: true
+ * });
+ *
+ * // Add sections
+ * nav.add({ selector: '.nav-item' });
+ *
+ * // Navigate
+ * nav.move('right');
+ * ```
+ *
+ * @param options - Configuration options for the instance
+ * @returns A spatial navigation instance with the full API
+ */
+export function createSpatialNavigation(_options) {
+    // TODO: Implement full isolated instance
+    // For now, this is a placeholder that documents the intended API.
+    // Full implementation requires refactoring spatial-navigation.ts
+    // to support dependency injection of state.
+    throw new Error('createSpatialNavigation() is not yet fully implemented. ' +
+        'Use the default export from spatial-navigation.ts for now.');
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyDH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAyC;IAEzC,yCAAyC;IACzC,kEAAkE;IAClE,iEAAiE;IACjE,4CAA4C;IAC5C,MAAM,IAAI,KAAK,CACb,0DAA0D;QAC1D,4DAA4D,CAC7D,CAAC;AACJ,CAAC"}