@stroke-stabilizer/core 0.1.3

package/dist/filters/LinearPredictionFilter.d.ts

@@ -0,0 +1,54 @@
+import type { Filter } from '../types';
+export interface LinearPredictionFilterParams {
+    /**
+     * Number of points used for prediction
+     * More points = more stable but higher computation cost
+     * Recommended: 3-5
+     */
+    historySize: number;
+    /**
+     * Prediction strength (0-1)
+     * - 0: No prediction (returns current position as-is)
+     * - 1: Full prediction (maximally considers velocity/acceleration)
+     * Recommended: 0.3-0.7
+     */
+    predictionFactor: number;
+    /**
+     * Smoothing coefficient (0-1)
+     * EMA coefficient applied to prediction output
+     * Recommended: 0.5-0.8
+     */
+    smoothing?: number;
+}
+/**
+ * Create a linear prediction filter
+ *
+ * Compensates for filter-induced latency by estimating velocity and
+ * acceleration from past positions to predict the next position.
+ *
+ * @example
+ * ```ts
+ * // Standard settings
+ * const pointer = new StabilizedPointer()
+ *   .addFilter(linearPredictionFilter({
+ *     historySize: 4,
+ *     predictionFactor: 0.5
+ *   }))
+ *
+ * // Strong prediction (prioritize latency reduction)
+ * const responsive = linearPredictionFilter({
+ *   historySize: 3,
+ *   predictionFactor: 0.8,
+ *   smoothing: 0.7
+ * })
+ *
+ * // Stability focused
+ * const stable = linearPredictionFilter({
+ *   historySize: 5,
+ *   predictionFactor: 0.3,
+ *   smoothing: 0.5
+ * })
+ * ```
+ */
+export declare function linearPredictionFilter(params: LinearPredictionFilterParams): Filter;
+//# sourceMappingURL=LinearPredictionFilter.d.ts.map

package/dist/filters/LinearPredictionFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinearPredictionFilter.d.ts","sourceRoot":"","sources":["../../src/filters/LinearPredictionFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,UAAU,CAAA;AAErE,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA8OD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,4BAA4B,GACnC,MAAM,CAER"}

package/dist/filters/MovingAverageFilter.d.ts

@@ -0,0 +1,16 @@
+import type { Filter } from '../types';
+export interface MovingAverageFilterParams {
+    /** Number of points to average */
+    windowSize: number;
+}
+/**
+ * Create a moving average filter
+ *
+ * @example
+ * ```ts
+ * const pointer = new StabilizedPointer()
+ *   .addFilter(movingAverageFilter({ windowSize: 5 }))
+ * ```
+ */
+export declare function movingAverageFilter(params: MovingAverageFilterParams): Filter;
+//# sourceMappingURL=MovingAverageFilter.d.ts.map

package/dist/filters/MovingAverageFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MovingAverageFilter.d.ts","sourceRoot":"","sources":["../../src/filters/MovingAverageFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,UAAU,CAAA;AAErE,MAAM,WAAW,yBAAyB;IACxC,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAA;CACnB;AAoED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAE7E"}

package/dist/filters/NoiseFilter.d.ts

@@ -0,0 +1,16 @@
+import type { Filter } from '../types';
+export interface NoiseFilterParams {
+    /** Minimum movement distance (px). Movements smaller than this are rejected */
+    minDistance: number;
+}
+/**
+ * Create a noise filter
+ *
+ * @example
+ * ```ts
+ * const pointer = new StabilizedPointer()
+ *   .addFilter(noiseFilter({ minDistance: 2 }))
+ * ```
+ */
+export declare function noiseFilter(params: NoiseFilterParams): Filter;
+//# sourceMappingURL=NoiseFilter.d.ts.map

package/dist/filters/NoiseFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoiseFilter.d.ts","sourceRoot":"","sources":["../../src/filters/NoiseFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,UAAU,CAAA;AAErE,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAA;CACpB;AA8CD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAE7D"}

package/dist/filters/OneEuroFilter.d.ts

@@ -0,0 +1,45 @@
+import type { Filter } from '../types';
+export interface OneEuroFilterParams {
+    /**
+     * Minimum cutoff frequency (Hz)
+     * Smoothing strength at low speed. Lower = smoother.
+     * Recommended: 0.5 - 2.0
+     */
+    minCutoff: number;
+    /**
+     * Speed coefficient
+     * Rate of cutoff frequency increase based on speed.
+     * Higher = more responsive at high speed.
+     * Recommended: 0.001 - 0.01
+     */
+    beta: number;
+    /**
+     * Derivative cutoff frequency (Hz)
+     * Smoothing for velocity estimation. Usually fixed at 1.0.
+     */
+    dCutoff?: number;
+}
+/**
+ * Create a One Euro Filter
+ *
+ * Speed-adaptive low-pass filter.
+ * Strong smoothing at low speed, responsive at high speed.
+ *
+ * @example
+ * ```ts
+ * // Balanced settings
+ * const pointer = new StabilizedPointer()
+ *   .addFilter(oneEuroFilter({
+ *     minCutoff: 1.0,
+ *     beta: 0.007
+ *   }))
+ *
+ * // Smoother (higher latency)
+ * const smooth = oneEuroFilter({ minCutoff: 0.5, beta: 0.001 })
+ *
+ * // More responsive (may have jitter)
+ * const responsive = oneEuroFilter({ minCutoff: 2.0, beta: 0.01 })
+ * ```
+ */
+export declare function oneEuroFilter(params: OneEuroFilterParams): Filter;
+//# sourceMappingURL=OneEuroFilter.d.ts.map

package/dist/filters/OneEuroFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OneEuroFilter.d.ts","sourceRoot":"","sources":["../../src/filters/OneEuroFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,UAAU,CAAA;AAErE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAqKD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAEjE"}

package/dist/filters/StringFilter.d.ts

@@ -0,0 +1,16 @@
+import type { Filter } from '../types';
+export interface StringFilterParams {
+    /** String length (px): Dead zone radius */
+    stringLength: number;
+}
+/**
+ * Create a string stabilization filter
+ *
+ * @example
+ * ```ts
+ * const pointer = new StabilizedPointer()
+ *   .addFilter(stringFilter({ stringLength: 10 }))
+ * ```
+ */
+export declare function stringFilter(params: StringFilterParams): Filter;
+//# sourceMappingURL=StringFilter.d.ts.map

package/dist/filters/StringFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringFilter.d.ts","sourceRoot":"","sources":["../../src/filters/StringFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,UAAU,CAAA;AAErE,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAA;CACrB;AA8DD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAE/D"}

package/dist/filters/index.d.ts

@@ -0,0 +1,15 @@
+export { noiseFilter } from './NoiseFilter';
+export type { NoiseFilterParams } from './NoiseFilter';
+export { kalmanFilter } from './KalmanFilter';
+export type { KalmanFilterParams } from './KalmanFilter';
+export { movingAverageFilter } from './MovingAverageFilter';
+export type { MovingAverageFilterParams } from './MovingAverageFilter';
+export { stringFilter } from './StringFilter';
+export type { StringFilterParams } from './StringFilter';
+export { emaFilter } from './EmaFilter';
+export type { EmaFilterParams } from './EmaFilter';
+export { oneEuroFilter } from './OneEuroFilter';
+export type { OneEuroFilterParams } from './OneEuroFilter';
+export { linearPredictionFilter } from './LinearPredictionFilter';
+export type { LinearPredictionFilterParams } from './LinearPredictionFilter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/filters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAA"}