@pithos/core 2.0.0

package/dist/arkhe/test/globals.js

@@ -0,0 +1,241 @@
+// INTENTIONAL: Encapsulating globalThis access to avoid repeating type casts
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const _globalThis = globalThis;
+/**
+ * Returns typed reference to globalThis for test environments.
+ *
+ * @returns The global object with any typing.
+ * @since 2.0.0
+ */
+export const getGlobalThis = () => _globalThis;
+/**
+ * Global registry to track mock restores for automatic cleanup.
+ * @internal
+ */
+const activeRestores = new Set();
+/** @internal */
+const registerRestore = (restore) => {
+    activeRestores.add(restore);
+};
+/** @internal */
+// Stryker disable next-line BlockStatement: equivalent mutant - double restore has same observable result but causes memory leak
+const unregisterRestore = (restore) => {
+    activeRestores.delete(restore);
+};
+/**
+ * Wraps a restore function for automatic tracking.
+ * @internal
+ * @since 2.0.0
+ */
+export const trackRestore = (restore) => {
+    registerRestore(restore);
+    return () => {
+        unregisterRestore(restore);
+        restore();
+    };
+};
+/**
+ * Restores all tracked mocks (LIFO order). Called automatically after each test.
+ * @internal
+ * @performance Uses Set for O(1) add/delete. Restores in reverse order (LIFO) via Array.from and reverse iteration.
+ */
+const autoRestoreAll = () => {
+    const restores = Array.from(activeRestores);
+    activeRestores.clear();
+    for (let i = restores.length - 1; i >= 0; i--) {
+        restores[i]();
+    }
+};
+/**
+ * @internal
+ * @since 2.0.0
+ */
+export const __autoRestoreAll = autoRestoreAll;
+/**
+ * Creates a mock window object on globalThis for Node.js tests.
+ *
+ * @param overrides - Properties to set on the mock window.
+ * @returns Object containing the mock window and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { window, restore } = mockWindow({ innerWidth: 1024 });
+ * expect(window.innerWidth).toBe(1024);
+ * restore();
+ * ```
+ */
+export const mockWindow = (overrides = {}) => {
+    const originalWindow = _globalThis.window;
+    const hasOriginalWindow = "window" in _globalThis;
+    const mockWin = { ...overrides };
+    _globalThis.window = mockWin;
+    const restore = () => {
+        if (hasOriginalWindow) {
+            _globalThis.window = originalWindow;
+        }
+        else {
+            delete _globalThis.window;
+        }
+    };
+    return { window: mockWin, restore: trackRestore(restore) };
+};
+/**
+ * Creates a mock document object on globalThis for Node.js tests.
+ *
+ * @param overrides - Properties to set on the mock document.
+ * @returns Object containing the mock document and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { document, restore } = mockDocument({
+ *   querySelector: vi.fn(() => null),
+ * });
+ * restore();
+ * ```
+ */
+export const mockDocument = (overrides = {}) => {
+    const originalDocument = _globalThis.document;
+    const hasOriginalDocument = "document" in _globalThis;
+    const mockDoc = { ...overrides };
+    _globalThis.document = mockDoc;
+    const restore = () => {
+        if (hasOriginalDocument) {
+            _globalThis.document = originalDocument;
+        }
+        else {
+            delete _globalThis.document;
+        }
+    };
+    return { document: mockDoc, restore: trackRestore(restore) };
+};
+/**
+ * Creates a mock DOMRect constructor on globalThis for Node.js tests.
+ *
+ * @param implementation - Optional custom DOMRect implementation.
+ * @returns Object containing the mock DOMRect and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { DOMRect, restore } = mockDOMRect();
+ * const rect = new DOMRect(0, 0, 100, 100);
+ * expect(rect.width).toBe(100);
+ * restore();
+ * ```
+ */
+export const mockDOMRect = (implementation) => {
+    const originalDOMRect = _globalThis.DOMRect;
+    const hasOriginalDOMRect = "DOMRect" in _globalThis;
+    const mockDOMRectClass = implementation ??
+        class DOMRect {
+            constructor(x = 0, y = 0, width = 0, height = 0) {
+                this.x = x;
+                this.y = y;
+                this.width = width;
+                this.height = height;
+                this.top = y;
+                this.left = x;
+                this.right = x + width;
+                this.bottom = y + height;
+            }
+            toJSON() {
+                return JSON.stringify({
+                    x: this.x,
+                    y: this.y,
+                    width: this.width,
+                    height: this.height,
+                    top: this.top,
+                    right: this.right,
+                    bottom: this.bottom,
+                    left: this.left,
+                });
+            }
+        };
+    _globalThis.DOMRect = mockDOMRectClass;
+    const restore = () => {
+        if (hasOriginalDOMRect) {
+            _globalThis.DOMRect = originalDOMRect;
+        }
+        else {
+            delete _globalThis.DOMRect;
+        }
+    };
+    return { DOMRect: mockDOMRectClass, restore: trackRestore(restore) };
+};
+/**
+ * Creates a mock performance object on globalThis for Node.js tests.
+ *
+ * @param overrides - Properties to override on the mock performance.
+ * @returns Object containing the mock performance and restore function.
+ * @since 2.0.0
+ *
+ * @note Always call `restore()` for cleanup. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const { performance, restore } = mockPerformance({
+ *   now: vi.fn(() => 12345),
+ * });
+ * expect(performance.now()).toBe(12345);
+ * restore();
+ * ```
+ */
+export const mockPerformance = (overrides = {}) => {
+    const originalPerformance = _globalThis
+        .performance;
+    const hasOriginalPerformance = "performance" in _globalThis;
+    const mockPerf = { now: () => Date.now(), ...overrides };
+    _globalThis.performance = mockPerf;
+    const restore = () => {
+        if (hasOriginalPerformance) {
+            _globalThis.performance =
+                originalPerformance;
+        }
+        else {
+            delete _globalThis.performance;
+        }
+    };
+    return { performance: mockPerf, restore: trackRestore(restore) };
+};
+/**
+ * Sets a value on globalThis and returns a restore function.
+ *
+ * @template T - The value type.
+ * @param key - The key to set on globalThis.
+ * @param value - The value to set.
+ * @returns A restore function.
+ * @since 2.0.0
+ *
+ * @note Always call the returned restore function. Auto-restored after each test if forgotten.
+ *
+ * @example
+ * ```typescript
+ * const restore = setGlobal('fetch', vi.fn());
+ * // ... tests ...
+ * restore();
+ * ```
+ */
+export const setGlobal = (key, value) => {
+    const globals = _globalThis;
+    const originalValue = globals[key];
+    const hasOriginal = key in _globalThis;
+    globals[key] = value;
+    const restore = () => {
+        if (hasOriginal) {
+            globals[key] = originalValue;
+        }
+        else {
+            delete globals[key];
+        }
+    };
+    return trackRestore(restore);
+};
+//# sourceMappingURL=globals.js.map

package/dist/arkhe/test/globals.js.map

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

package/dist/arkhe/test/private-access.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @since 2.0.0
+ */
+export type testAny = any;
+/**
+ * Casts a value to a target type for test access to private members.
+ *
+ * @template T - The target type to cast to.
+ * @param obj - The value to cast.
+ * @returns The value cast to the target type.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * class MyClass {
+ *   private secret = 42;
+ * }
+ *
+ * const instance = new MyClass();
+ * const exposed = cast<{ secret: number }>(instance);
+ * expect(exposed.secret).toBe(42);
+ * ```
+ */
+export declare const cast: <T = testAny>(obj: unknown) => T;
+/**
+ * Casts a value to an array type for tests.
+ *
+ * @template T - The array element type.
+ * @param obj - The value to cast.
+ * @returns The value cast to `T[]`.
+ * @since 2.0.0
+ */
+export declare const castArray: <T = testAny>(obj: unknown) => T[];
+/**
+ * Casts a value to a Map type for tests.
+ *
+ * @template K - The key type.
+ * @template V - The value type.
+ * @param obj - The value to cast.
+ * @returns The value cast to `Map<K, V>`.
+ * @since 2.0.0
+ */
+export declare const castMap: <K = string, V = testAny>(obj: unknown) => Map<K, V>;
+/**
+ * Pre-cast null for test assertions.
+ * @since 2.0.0
+ */
+export declare const testNull: any;
+/**
+ * Pre-cast undefined for test assertions.
+ * @since 2.0.0
+ */
+export declare const testUndefined: any;
+//# sourceMappingURL=private-access.d.ts.map

package/dist/arkhe/test/private-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-access.d.ts","sourceRoot":"","sources":["../../../src/arkhe/test/private-access.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAE1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,OAAO,KAAG,CAAa,CAAC;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,OAAO,KAAG,CAAC,EAAgB,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,KAAK,OAAO,KAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CACtD,CAAC;AAEnB;;;GAGG;AACH,eAAO,MAAM,QAAQ,KAAa,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,aAAa,KAAkB,CAAC"}

package/dist/arkhe/test/private-access.js

@@ -0,0 +1,50 @@
+/**
+ * Casts a value to a target type for test access to private members.
+ *
+ * @template T - The target type to cast to.
+ * @param obj - The value to cast.
+ * @returns The value cast to the target type.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * class MyClass {
+ *   private secret = 42;
+ * }
+ *
+ * const instance = new MyClass();
+ * const exposed = cast<{ secret: number }>(instance);
+ * expect(exposed.secret).toBe(42);
+ * ```
+ */
+export const cast = (obj) => obj;
+/**
+ * Casts a value to an array type for tests.
+ *
+ * @template T - The array element type.
+ * @param obj - The value to cast.
+ * @returns The value cast to `T[]`.
+ * @since 2.0.0
+ */
+export const castArray = (obj) => obj;
+/**
+ * Casts a value to a Map type for tests.
+ *
+ * @template K - The key type.
+ * @template V - The value type.
+ * @param obj - The value to cast.
+ * @returns The value cast to `Map<K, V>`.
+ * @since 2.0.0
+ */
+export const castMap = (obj) => obj;
+/**
+ * Pre-cast null for test assertions.
+ * @since 2.0.0
+ */
+export const testNull = cast(null);
+/**
+ * Pre-cast undefined for test assertions.
+ * @since 2.0.0
+ */
+export const testUndefined = cast(undefined);
+//# sourceMappingURL=private-access.js.map

package/dist/arkhe/test/private-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-access.js","sourceRoot":"","sources":["../../../src/arkhe/test/private-access.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAc,GAAY,EAAK,EAAE,CAAC,GAAQ,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAc,GAAY,EAAO,EAAE,CAAC,GAAU,CAAC;AAExE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAA0B,GAAY,EAAa,EAAE,CAC1E,GAAgB,CAAC;AAEnB;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC"}

package/dist/arkhe/types/animations/easing.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Represents an easing function that takes a progress value and returns a transformed value.
+ * @param t - Progress value between 0 and 1.
+ * @returns Transformed progress value.
+ * @since 1.0.0
+ */
+export type EasingFunction = (t: number) => number;
+//# sourceMappingURL=easing.d.ts.map

package/dist/arkhe/types/animations/easing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/animations/easing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC"}

package/dist/arkhe/types/animations/easing.js

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

package/dist/arkhe/types/animations/easing.js.map

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

package/dist/arkhe/types/common/arrayable.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Represents a value that can be either a single item or an array of items.
+ * @template T - The base type.
+ * @since 2.0.0
+ * @example
+ * ```typescript
+ * function processItems(items: Arrayable<string>): string[] {
+ *   return Array.isArray(items) ? items : [items];
+ * }
+ *
+ * processItems("single"); // Returns ["single"]
+ * processItems(["a", "b"]); // Returns ["a", "b"]
+ * ```
+ */
+export type Arrayable<T> = T | T[];
+//# sourceMappingURL=arrayable.d.ts.map

package/dist/arkhe/types/common/arrayable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayable.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/common/arrayable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC"}

package/dist/arkhe/types/common/arrayable.js

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

package/dist/arkhe/types/common/arrayable.js.map

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

package/dist/arkhe/types/common/awaitable.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Represents a value that can be awaited (either the value itself or a Promise-like).
+ * @template T - The base type.
+ * @since 2.0.0
+ * @example
+ * ```typescript
+ * async function processData(data: Awaitable<string>): Promise<string> {
+ *   const result = await data; // Works with both string and Promise<string>
+ *   return result.toUpperCase();
+ * }
+ *
+ * processData("hello"); // Valid
+ * processData(Promise.resolve("world")); // Valid
+ * ```
+ */
+export type Awaitable<T> = T | PromiseLike<T>;
+//# sourceMappingURL=awaitable.d.ts.map

package/dist/arkhe/types/common/awaitable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awaitable.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/common/awaitable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC"}

package/dist/arkhe/types/common/awaitable.js

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

package/dist/arkhe/types/common/awaitable.js.map

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

package/dist/arkhe/types/common/nullish.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Represents a value that can be null or undefined.
+ * @template T - The base type.
+ * @since 1.0.0
+ * @example
+ * ```typescript
+ * type Settings = {
+ *   theme: string;
+ *   language: Nullish<string>; // string | null | undefined
+ * };
+ *
+ * const settings: Settings = {
+ *   theme: "dark",
+ *   language: null // Valid
+ * };
+ * ```
+ */
+export type Nullish<T> = T | null | undefined;
+//# sourceMappingURL=nullish.d.ts.map

package/dist/arkhe/types/common/nullish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullish.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/common/nullish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC"}

package/dist/arkhe/types/common/nullish.js

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

package/dist/arkhe/types/common/nullish.js.map

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

package/dist/arkhe/types/dom/attachable.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Interface for objects that can be attached to and detached from DOM elements.
+ * @since 2.0.0
+ */
+export interface Attachable {
+    /** Whether the object is currently attached to an element. */
+    readonly isAttached: boolean;
+    /** Attaches the object to the specified element. */
+    attachTo(element: EventTarget): void;
+    /** Detaches the object from its current element. */
+    detach(): void;
+    /** Destroys the object and releases all resources. */
+    destroy(): void;
+}
+//# sourceMappingURL=attachable.d.ts.map

package/dist/arkhe/types/dom/attachable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachable.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/dom/attachable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,oDAAoD;IACpD,MAAM,IAAI,IAAI,CAAC;IACf,sDAAsD;IACtD,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/arkhe/types/dom/attachable.js

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

package/dist/arkhe/types/dom/attachable.js.map

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

package/dist/arkhe/types/dom/viewport.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Represents viewport meta tag values for mobile web applications.
+ * @since 1.0.0
+ */
+export interface ViewportValues {
+    /** Initial zoom scale. */
+    initialScale: number | null;
+    /** Minimum allowed zoom scale. */
+    minimumScale: number | null;
+    /** Maximum allowed zoom scale. */
+    maximumScale: number | null;
+    /** Whether user can zoom the page. */
+    userScalable: boolean | null;
+}
+//# sourceMappingURL=viewport.d.ts.map

package/dist/arkhe/types/dom/viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/dom/viewport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kCAAkC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kCAAkC;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sCAAsC;IACtC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B"}

package/dist/arkhe/types/dom/viewport.js

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

package/dist/arkhe/types/dom/viewport.js.map

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

package/dist/arkhe/types/gestures/axis.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Represents the axis or axes for gesture detection.
+ * @since 1.0.0
+ */
+export type Axis = "x" | "y" | "both";
+//# sourceMappingURL=axis.d.ts.map

package/dist/arkhe/types/gestures/axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/gestures/axis.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC"}

package/dist/arkhe/types/gestures/axis.js

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

package/dist/arkhe/types/gestures/axis.js.map

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

package/dist/arkhe/types/gestures/drag.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Represents the type of gesture input device.
+ * @since 1.0.0
+ */
+export type GestureType = "pointer" | "mouse" | "touch";
+/**
+ * Union type for all drag-related events.
+ * @since 1.0.0
+ */
+export type DragEvent = PointerEvent | MouseEvent | TouchEvent;
+//# sourceMappingURL=drag.d.ts.map

package/dist/arkhe/types/gestures/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/gestures/drag.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC"}

package/dist/arkhe/types/gestures/drag.js

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

package/dist/arkhe/types/gestures/drag.js.map

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

package/dist/arkhe/types/math/arithmetic.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Arithmetic and mathematical types for common use cases
+ *
+ * @since 2.0.0
+ */
+/**
+ * Represents a min/max value pair - simple and extensible
+ *
+ * @example
+ * ```typescript
+ * const ageRange: MinMax = { min: 18, max: 65 };
+ * const priceRange: MinMax = { min: 0, max: 1000 };
+ * const scoreConstraints: MinMax = { min: 0, max: 100 };
+ * ```
+ */
+export interface MinMax {
+    /** Minimum value */
+    min: number;
+    /** Maximum value */
+    max: number;
+}
+/**
+ * Extends MinMax with inclusivity control for both bounds.
+ * @since 2.0.0
+ * @example
+ * ```typescript
+ * const range1: InclusiveMinMax = { min: 0, max: 10 }; // [0, 10) - default
+ * const range2: InclusiveMinMax = { min: 0, max: 10, minInclusive: false }; // (0, 10)
+ * const range3: InclusiveMinMax = { min: 0, max: 10, maxInclusive: true }; // [0, 10]
+ * const range4: InclusiveMinMax = { min: 0, max: 10, minInclusive: false, maxInclusive: true }; // (0, 10]
+ * ```
+ */
+export interface InclusiveMinMax extends MinMax {
+    /** Whether the minimum value is inclusive (default: true) */
+    minInclusive?: boolean;
+    /** Whether the maximum value is inclusive (default: false) */
+    maxInclusive?: boolean;
+}
+/**
+ * Represents a percentage calculation.
+ * @since 2.0.0
+ * @example
+ * ```typescript
+ * const progress: Percentage = {
+ *   value: 75,
+ *   total: 100,
+ *   percentage: 75
+ * };
+ * ```
+ */
+export interface Percentage {
+    /** The current value */
+    value: number;
+    /** The total value */
+    total: number;
+    /** The calculated percentage */
+    percentage: number;
+}
+/**
+ * Represents a mathematical interval with start, end, and optional step.
+ * @since 2.0.0
+ * @example
+ * ```typescript
+ * const timeInterval: Interval = {
+ *   start: 0,
+ *   end: 10,
+ *   step: 1
+ * };
+ * ```
+ */
+export interface Interval {
+    /** Start value of the interval */
+    start: number;
+    /** End value of the interval */
+    end: number;
+    /** Step size for progression (default: 1) */
+    step?: number;
+}
+//# sourceMappingURL=arithmetic.d.ts.map

package/dist/arkhe/types/math/arithmetic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arithmetic.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/types/math/arithmetic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,MAAM;IACrB,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAgB,SAAQ,MAAM;IAC7C,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}