@kelnishi/satmouse-client 0.1.0

package/dist/utils/index.d.ts

@@ -0,0 +1,99 @@
+import { V as Vec3, S as SpatialData, e as TypedEmitter, B as ButtonEvent, a as ConnectionState, d as TransportProtocol, D as DeviceInfo, b as SatMouseConnection } from '../connection-CH2YsPn1.js';
+
+interface FlipConfig {
+    tx: boolean;
+    ty: boolean;
+    tz: boolean;
+    rx: boolean;
+    ry: boolean;
+    rz: boolean;
+}
+interface SensitivityConfig {
+    translation: number;
+    rotation: number;
+}
+/** Maps each input axis to an output axis. E.g., { tx: "tz", tz: "tx" } swaps X and Z translation. */
+type AxisMap = {
+    tx: keyof Vec3;
+    ty: keyof Vec3;
+    tz: keyof Vec3;
+    rx: keyof Vec3;
+    ry: keyof Vec3;
+    rz: keyof Vec3;
+};
+declare const DEFAULT_AXIS_MAP: AxisMap;
+declare function applyFlip(data: SpatialData, flip: FlipConfig): SpatialData;
+declare function applySensitivity(data: SpatialData, sens: SensitivityConfig): SpatialData;
+declare function applyDominant(data: SpatialData): SpatialData;
+declare function applyDeadZone(data: SpatialData, threshold: number): SpatialData;
+declare function applyAxisRemap(data: SpatialData, map: AxisMap): SpatialData;
+
+interface InputConfig {
+    sensitivity: SensitivityConfig;
+    flip: FlipConfig;
+    deadZone: number;
+    dominant: boolean;
+    axisRemap: AxisMap;
+    lockPosition: boolean;
+    lockRotation: boolean;
+}
+declare const DEFAULT_CONFIG: InputConfig;
+declare function mergeConfig(base: InputConfig, partial: Partial<InputConfig>): InputConfig;
+
+interface StorageAdapter {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+declare function saveSettings(config: InputConfig, storage?: StorageAdapter): void;
+declare function loadSettings(storage?: StorageAdapter): Partial<InputConfig> | null;
+
+interface InputManagerEvents {
+    /** Processed spatial data (after all transforms) */
+    spatialData: (data: SpatialData) => void;
+    /** Raw spatial data (before transforms) */
+    rawSpatialData: (data: SpatialData) => void;
+    /** Button event (pass-through from connection) */
+    buttonEvent: (data: ButtonEvent) => void;
+    /** Connection state changed */
+    stateChange: (state: ConnectionState, protocol: TransportProtocol) => void;
+    /** Device connected/disconnected */
+    deviceStatus: (event: "connected" | "disconnected", device: DeviceInfo) => void;
+    /** Configuration changed */
+    configChange: (config: InputConfig) => void;
+}
+/**
+ * Unified device service that wraps one or more SatMouseConnections
+ * and provides a single processed event stream.
+ *
+ * Applies a configurable transform pipeline to spatial data:
+ *   deadZone → dominant → flip → axisRemap → sensitivity → lock
+ *
+ * Persists settings to storage (localStorage by default).
+ */
+declare class InputManager extends TypedEmitter<InputManagerEvents> {
+    private connections;
+    private storage?;
+    private _config;
+    get config(): InputConfig;
+    constructor(config?: Partial<InputConfig>, storage?: StorageAdapter);
+    /** Add a connection to the managed set */
+    addConnection(connection: SatMouseConnection): void;
+    /** Remove a connection */
+    removeConnection(connection: SatMouseConnection): void;
+    /** Connect all managed connections */
+    connect(): Promise<void>;
+    /** Disconnect all managed connections */
+    disconnect(): void;
+    /** Fetch device info from all connections */
+    fetchDeviceInfo(): Promise<DeviceInfo[]>;
+    /** Update configuration. Persists by default. */
+    updateConfig(partial: Partial<InputConfig>, persist?: boolean): void;
+    /** Register a callback for processed spatial data. Returns unsubscribe function. */
+    onSpatialData(callback: (data: SpatialData) => void): () => void;
+    /** Register a callback for button events. Returns unsubscribe function. */
+    onButtonEvent(callback: (data: ButtonEvent) => void): () => void;
+    private wireConnection;
+    private processSpatialData;
+}
+
+export { type AxisMap, DEFAULT_AXIS_MAP, DEFAULT_CONFIG, type FlipConfig, type InputConfig, InputManager, type InputManagerEvents, type SensitivityConfig, type StorageAdapter, applyAxisRemap, applyDeadZone, applyDominant, applyFlip, applySensitivity, loadSettings, mergeConfig, saveSettings };

package/dist/utils/index.js

@@ -0,0 +1,219 @@
+import { TypedEmitter } from '../chunk-X6NIARXW.js';
+
+// src/utils/config.ts
+var DEFAULT_CONFIG = {
+  sensitivity: { translation: 1e-3, rotation: 1e-3 },
+  flip: { tx: false, ty: true, tz: true, rx: false, ry: true, rz: true },
+  deadZone: 0,
+  dominant: false,
+  axisRemap: { tx: "x", ty: "y", tz: "z", rx: "x", ry: "y", rz: "z" },
+  lockPosition: false,
+  lockRotation: false
+};
+function mergeConfig(base, partial) {
+  return {
+    ...base,
+    ...partial,
+    sensitivity: { ...base.sensitivity, ...partial.sensitivity },
+    flip: { ...base.flip, ...partial.flip },
+    axisRemap: { ...base.axisRemap, ...partial.axisRemap }
+  };
+}
+
+// src/utils/persistence.ts
+var STORAGE_KEY = "satmouse:settings";
+function getStorage(storage) {
+  if (storage) return storage;
+  try {
+    return globalThis.localStorage ?? null;
+  } catch {
+    return null;
+  }
+}
+function saveSettings(config, storage) {
+  const s = getStorage(storage);
+  if (!s) return;
+  s.setItem(STORAGE_KEY, JSON.stringify(config));
+}
+function loadSettings(storage) {
+  const s = getStorage(storage);
+  if (!s) return null;
+  const raw = s.getItem(STORAGE_KEY);
+  if (!raw) return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+// src/utils/transforms.ts
+var DEFAULT_AXIS_MAP = {
+  tx: "x",
+  ty: "y",
+  tz: "z",
+  rx: "x",
+  ry: "y",
+  rz: "z"
+};
+function applyFlip(data, flip) {
+  return {
+    ...data,
+    translation: {
+      x: flip.tx ? -data.translation.x : data.translation.x,
+      y: flip.ty ? -data.translation.y : data.translation.y,
+      z: flip.tz ? -data.translation.z : data.translation.z
+    },
+    rotation: {
+      x: flip.rx ? -data.rotation.x : data.rotation.x,
+      y: flip.ry ? -data.rotation.y : data.rotation.y,
+      z: flip.rz ? -data.rotation.z : data.rotation.z
+    }
+  };
+}
+function applySensitivity(data, sens) {
+  return {
+    ...data,
+    translation: {
+      x: data.translation.x * sens.translation,
+      y: data.translation.y * sens.translation,
+      z: data.translation.z * sens.translation
+    },
+    rotation: {
+      x: data.rotation.x * sens.rotation,
+      y: data.rotation.y * sens.rotation,
+      z: data.rotation.z * sens.rotation
+    }
+  };
+}
+function applyDominant(data) {
+  const axes = [
+    { group: "t", key: "x", v: Math.abs(data.translation.x) },
+    { group: "t", key: "y", v: Math.abs(data.translation.y) },
+    { group: "t", key: "z", v: Math.abs(data.translation.z) },
+    { group: "r", key: "x", v: Math.abs(data.rotation.x) },
+    { group: "r", key: "y", v: Math.abs(data.rotation.y) },
+    { group: "r", key: "z", v: Math.abs(data.rotation.z) }
+  ];
+  const max = axes.reduce((a, b) => b.v > a.v ? b : a);
+  const t = { x: 0, y: 0, z: 0 };
+  const r = { x: 0, y: 0, z: 0 };
+  if (max.group === "t") t[max.key] = data.translation[max.key];
+  else r[max.key] = data.rotation[max.key];
+  return { ...data, translation: t, rotation: r };
+}
+function applyDeadZone(data, threshold) {
+  const dz = (v) => Math.abs(v) < threshold ? 0 : v;
+  return {
+    ...data,
+    translation: { x: dz(data.translation.x), y: dz(data.translation.y), z: dz(data.translation.z) },
+    rotation: { x: dz(data.rotation.x), y: dz(data.rotation.y), z: dz(data.rotation.z) }
+  };
+}
+function applyAxisRemap(data, map) {
+  return {
+    ...data,
+    translation: {
+      x: 0,
+      y: 0,
+      z: 0,
+      [map.tx]: data.translation.x,
+      [map.ty]: data.translation.y,
+      [map.tz]: data.translation.z
+    },
+    rotation: {
+      x: 0,
+      y: 0,
+      z: 0,
+      [map.rx]: data.rotation.x,
+      [map.ry]: data.rotation.y,
+      [map.rz]: data.rotation.z
+    }
+  };
+}
+
+// src/utils/input-manager.ts
+var InputManager = class extends TypedEmitter {
+  connections = [];
+  storage;
+  _config;
+  get config() {
+    return this._config;
+  }
+  constructor(config, storage) {
+    super();
+    this.storage = storage;
+    const persisted = loadSettings(storage);
+    this._config = mergeConfig(DEFAULT_CONFIG, { ...config, ...persisted });
+  }
+  /** Add a connection to the managed set */
+  addConnection(connection) {
+    this.connections.push(connection);
+    this.wireConnection(connection);
+  }
+  /** Remove a connection */
+  removeConnection(connection) {
+    const idx = this.connections.indexOf(connection);
+    if (idx !== -1) this.connections.splice(idx, 1);
+    connection.removeAllListeners();
+  }
+  /** Connect all managed connections */
+  async connect() {
+    await Promise.all(this.connections.map((c) => c.connect()));
+  }
+  /** Disconnect all managed connections */
+  disconnect() {
+    for (const c of this.connections) c.disconnect();
+  }
+  /** Fetch device info from all connections */
+  async fetchDeviceInfo() {
+    const results = await Promise.all(this.connections.map((c) => c.fetchDeviceInfo()));
+    return results.flat();
+  }
+  /** Update configuration. Persists by default. */
+  updateConfig(partial, persist = true) {
+    this._config = mergeConfig(this._config, partial);
+    if (persist) saveSettings(this._config, this.storage);
+    this.emit("configChange", this._config);
+  }
+  /** Register a callback for processed spatial data. Returns unsubscribe function. */
+  onSpatialData(callback) {
+    this.on("spatialData", callback);
+    return () => this.off("spatialData", callback);
+  }
+  /** Register a callback for button events. Returns unsubscribe function. */
+  onButtonEvent(callback) {
+    this.on("buttonEvent", callback);
+    return () => this.off("buttonEvent", callback);
+  }
+  wireConnection(connection) {
+    connection.on("spatialData", (raw) => {
+      this.emit("rawSpatialData", raw);
+      const processed = this.processSpatialData(raw);
+      if (processed) this.emit("spatialData", processed);
+    });
+    connection.on("buttonEvent", (event) => this.emit("buttonEvent", event));
+    connection.on("stateChange", (state, proto) => this.emit("stateChange", state, proto));
+    connection.on("deviceStatus", (event, device) => this.emit("deviceStatus", event, device));
+  }
+  processSpatialData(raw) {
+    const cfg = this._config;
+    let data = raw;
+    if (cfg.deadZone > 0) data = applyDeadZone(data, cfg.deadZone);
+    if (cfg.dominant) data = applyDominant(data);
+    data = applyFlip(data, cfg.flip);
+    data = applyAxisRemap(data, cfg.axisRemap);
+    data = applySensitivity(data, cfg.sensitivity);
+    if (cfg.lockPosition) {
+      data = { ...data, translation: { x: 0, y: 0, z: 0 } };
+    }
+    if (cfg.lockRotation) {
+      data = { ...data, rotation: { x: 0, y: 0, z: 0 } };
+    }
+    return data;
+  }
+};
+
+export { DEFAULT_AXIS_MAP, DEFAULT_CONFIG, InputManager, applyAxisRemap, applyDeadZone, applyDominant, applyFlip, applySensitivity, loadSettings, mergeConfig, saveSettings };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/config.ts","../../src/utils/persistence.ts","../../src/utils/transforms.ts","../../src/utils/input-manager.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { FlipConfig, SensitivityConfig, AxisMap } from \"./transforms.js\";\n\nexport interface InputConfig {\n  sensitivity: SensitivityConfig;\n  flip: FlipConfig;\n  deadZone: number;\n  dominant: boolean;\n  axisRemap: AxisMap;\n  lockPosition: boolean;\n  lockRotation: boolean;\n}\n\nexport const DEFAULT_CONFIG: InputConfig = {\n  sensitivity: { translation: 0.001, rotation: 0.001 },\n  flip: { tx: false, ty: true, tz: true, rx: false, ry: true, rz: true },\n  deadZone: 0,\n  dominant: false,\n  axisRemap: { tx: \"x\", ty: \"y\", tz: \"z\", rx: \"x\", ry: \"y\", rz: \"z\" },\n  lockPosition: false,\n  lockRotation: false,\n};\n\nexport function mergeConfig(base: InputConfig, partial: Partial<InputConfig>): InputConfig {\n  return {\n    ...base,\n    ...partial,\n    sensitivity: { ...base.sensitivity, ...partial.sensitivity },\n    flip: { ...base.flip, ...partial.flip },\n    axisRemap: { ...base.axisRemap, ...partial.axisRemap },\n  };\n}\n","import type { InputConfig } from \"./config.js\";\n\nexport interface StorageAdapter {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n}\n\nconst STORAGE_KEY = \"satmouse:settings\";\n\nfunction getStorage(storage?: StorageAdapter): StorageAdapter | null {\n  if (storage) return storage;\n  try {\n    return globalThis.localStorage ?? null;\n  } catch {\n    return null;\n  }\n}\n\nexport function saveSettings(config: InputConfig, storage?: StorageAdapter): void {\n  const s = getStorage(storage);\n  if (!s) return;\n  s.setItem(STORAGE_KEY, JSON.stringify(config));\n}\n\nexport function loadSettings(storage?: StorageAdapter): Partial<InputConfig> | null {\n  const s = getStorage(storage);\n  if (!s) return null;\n  const raw = s.getItem(STORAGE_KEY);\n  if (!raw) return null;\n  try {\n    return JSON.parse(raw) as Partial<InputConfig>;\n  } catch {\n    return null;\n  }\n}\n","import type { SpatialData, Vec3 } from \"../core/types.js\";\n\nexport interface FlipConfig {\n  tx: boolean;\n  ty: boolean;\n  tz: boolean;\n  rx: boolean;\n  ry: boolean;\n  rz: boolean;\n}\n\nexport interface SensitivityConfig {\n  translation: number;\n  rotation: number;\n}\n\n/** Maps each input axis to an output axis. E.g., { tx: \"tz\", tz: \"tx\" } swaps X and Z translation. */\nexport type AxisMap = {\n  tx: keyof Vec3;\n  ty: keyof Vec3;\n  tz: keyof Vec3;\n  rx: keyof Vec3;\n  ry: keyof Vec3;\n  rz: keyof Vec3;\n};\n\nexport const DEFAULT_AXIS_MAP: AxisMap = {\n  tx: \"x\", ty: \"y\", tz: \"z\",\n  rx: \"x\", ry: \"y\", rz: \"z\",\n};\n\nexport function applyFlip(data: SpatialData, flip: FlipConfig): SpatialData {\n  return {\n    ...data,\n    translation: {\n      x: flip.tx ? -data.translation.x : data.translation.x,\n      y: flip.ty ? -data.translation.y : data.translation.y,\n      z: flip.tz ? -data.translation.z : data.translation.z,\n    },\n    rotation: {\n      x: flip.rx ? -data.rotation.x : data.rotation.x,\n      y: flip.ry ? -data.rotation.y : data.rotation.y,\n      z: flip.rz ? -data.rotation.z : data.rotation.z,\n    },\n  };\n}\n\nexport function applySensitivity(data: SpatialData, sens: SensitivityConfig): SpatialData {\n  return {\n    ...data,\n    translation: {\n      x: data.translation.x * sens.translation,\n      y: data.translation.y * sens.translation,\n      z: data.translation.z * sens.translation,\n    },\n    rotation: {\n      x: data.rotation.x * sens.rotation,\n      y: data.rotation.y * sens.rotation,\n      z: data.rotation.z * sens.rotation,\n    },\n  };\n}\n\nexport function applyDominant(data: SpatialData): SpatialData {\n  const axes = [\n    { group: \"t\" as const, key: \"x\" as const, v: Math.abs(data.translation.x) },\n    { group: \"t\" as const, key: \"y\" as const, v: Math.abs(data.translation.y) },\n    { group: \"t\" as const, key: \"z\" as const, v: Math.abs(data.translation.z) },\n    { group: \"r\" as const, key: \"x\" as const, v: Math.abs(data.rotation.x) },\n    { group: \"r\" as const, key: \"y\" as const, v: Math.abs(data.rotation.y) },\n    { group: \"r\" as const, key: \"z\" as const, v: Math.abs(data.rotation.z) },\n  ];\n  const max = axes.reduce((a, b) => (b.v > a.v ? b : a));\n\n  const t: Vec3 = { x: 0, y: 0, z: 0 };\n  const r: Vec3 = { x: 0, y: 0, z: 0 };\n\n  if (max.group === \"t\") t[max.key] = data.translation[max.key];\n  else r[max.key] = data.rotation[max.key];\n\n  return { ...data, translation: t, rotation: r };\n}\n\nexport function applyDeadZone(data: SpatialData, threshold: number): SpatialData {\n  const dz = (v: number) => (Math.abs(v) < threshold ? 0 : v);\n  return {\n    ...data,\n    translation: { x: dz(data.translation.x), y: dz(data.translation.y), z: dz(data.translation.z) },\n    rotation: { x: dz(data.rotation.x), y: dz(data.rotation.y), z: dz(data.rotation.z) },\n  };\n}\n\nexport function applyAxisRemap(data: SpatialData, map: AxisMap): SpatialData {\n  return {\n    ...data,\n    translation: {\n      x: 0, y: 0, z: 0,\n      [map.tx]: data.translation.x,\n      [map.ty]: data.translation.y,\n      [map.tz]: data.translation.z,\n    } as Vec3,\n    rotation: {\n      x: 0, y: 0, z: 0,\n      [map.rx]: data.rotation.x,\n      [map.ry]: data.rotation.y,\n      [map.rz]: data.rotation.z,\n    } as Vec3,\n  };\n}\n","import { TypedEmitter } from \"../core/emitter.js\";\nimport type { SatMouseConnection } from \"../core/connection.js\";\nimport type { SpatialData, ButtonEvent, DeviceInfo, ConnectionState, TransportProtocol } from \"../core/types.js\";\nimport type { InputConfig } from \"./config.js\";\nimport { DEFAULT_CONFIG, mergeConfig } from \"./config.js\";\nimport { loadSettings, saveSettings, type StorageAdapter } from \"./persistence.js\";\nimport {\n  applyFlip,\n  applySensitivity,\n  applyDominant,\n  applyDeadZone,\n  applyAxisRemap,\n} from \"./transforms.js\";\n\nexport interface InputManagerEvents {\n  /** Processed spatial data (after all transforms) */\n  spatialData: (data: SpatialData) => void;\n  /** Raw spatial data (before transforms) */\n  rawSpatialData: (data: SpatialData) => void;\n  /** Button event (pass-through from connection) */\n  buttonEvent: (data: ButtonEvent) => void;\n  /** Connection state changed */\n  stateChange: (state: ConnectionState, protocol: TransportProtocol) => void;\n  /** Device connected/disconnected */\n  deviceStatus: (event: \"connected\" | \"disconnected\", device: DeviceInfo) => void;\n  /** Configuration changed */\n  configChange: (config: InputConfig) => void;\n}\n\n/**\n * Unified device service that wraps one or more SatMouseConnections\n * and provides a single processed event stream.\n *\n * Applies a configurable transform pipeline to spatial data:\n *   deadZone → dominant → flip → axisRemap → sensitivity → lock\n *\n * Persists settings to storage (localStorage by default).\n */\nexport class InputManager extends TypedEmitter<InputManagerEvents> {\n  private connections: SatMouseConnection[] = [];\n  private storage?: StorageAdapter;\n\n  private _config: InputConfig;\n\n  get config(): InputConfig {\n    return this._config;\n  }\n\n  constructor(config?: Partial<InputConfig>, storage?: StorageAdapter) {\n    super();\n    this.storage = storage;\n    const persisted = loadSettings(storage);\n    this._config = mergeConfig(DEFAULT_CONFIG, { ...config, ...persisted });\n  }\n\n  /** Add a connection to the managed set */\n  addConnection(connection: SatMouseConnection): void {\n    this.connections.push(connection);\n    this.wireConnection(connection);\n  }\n\n  /** Remove a connection */\n  removeConnection(connection: SatMouseConnection): void {\n    const idx = this.connections.indexOf(connection);\n    if (idx !== -1) this.connections.splice(idx, 1);\n    connection.removeAllListeners();\n  }\n\n  /** Connect all managed connections */\n  async connect(): Promise<void> {\n    await Promise.all(this.connections.map((c) => c.connect()));\n  }\n\n  /** Disconnect all managed connections */\n  disconnect(): void {\n    for (const c of this.connections) c.disconnect();\n  }\n\n  /** Fetch device info from all connections */\n  async fetchDeviceInfo(): Promise<DeviceInfo[]> {\n    const results = await Promise.all(this.connections.map((c) => c.fetchDeviceInfo()));\n    return results.flat();\n  }\n\n  /** Update configuration. Persists by default. */\n  updateConfig(partial: Partial<InputConfig>, persist = true): void {\n    this._config = mergeConfig(this._config, partial);\n    if (persist) saveSettings(this._config, this.storage);\n    this.emit(\"configChange\", this._config);\n  }\n\n  /** Register a callback for processed spatial data. Returns unsubscribe function. */\n  onSpatialData(callback: (data: SpatialData) => void): () => void {\n    this.on(\"spatialData\", callback);\n    return () => this.off(\"spatialData\", callback);\n  }\n\n  /** Register a callback for button events. Returns unsubscribe function. */\n  onButtonEvent(callback: (data: ButtonEvent) => void): () => void {\n    this.on(\"buttonEvent\", callback);\n    return () => this.off(\"buttonEvent\", callback);\n  }\n\n  private wireConnection(connection: SatMouseConnection): void {\n    connection.on(\"spatialData\", (raw) => {\n      this.emit(\"rawSpatialData\", raw);\n      const processed = this.processSpatialData(raw);\n      if (processed) this.emit(\"spatialData\", processed);\n    });\n\n    connection.on(\"buttonEvent\", (event) => this.emit(\"buttonEvent\", event));\n    connection.on(\"stateChange\", (state, proto) => this.emit(\"stateChange\", state, proto));\n    connection.on(\"deviceStatus\", (event, device) => this.emit(\"deviceStatus\", event, device));\n  }\n\n  private processSpatialData(raw: SpatialData): SpatialData | null {\n    const cfg = this._config;\n    let data = raw;\n\n    // Transform pipeline\n    if (cfg.deadZone > 0) data = applyDeadZone(data, cfg.deadZone);\n    if (cfg.dominant) data = applyDominant(data);\n    data = applyFlip(data, cfg.flip);\n    data = applyAxisRemap(data, cfg.axisRemap);\n    data = applySensitivity(data, cfg.sensitivity);\n\n    // Lock axes\n    if (cfg.lockPosition) {\n      data = { ...data, translation: { x: 0, y: 0, z: 0 } };\n    }\n    if (cfg.lockRotation) {\n      data = { ...data, rotation: { x: 0, y: 0, z: 0 } };\n    }\n\n    return data;\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@kelnishi/satmouse-client",
+  "version": "0.1.0",
+  "description": "Client SDK for SatMouse 6DOF spatial input bridge",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.mjs",
+      "require": "./dist/core/index.cjs"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.mjs",
+      "require": "./dist/core/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.mjs",
+      "require": "./dist/utils/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.cjs"
+    },
+    "./react/styles.css": "./dist/styles.css"
+  },
+  "typesVersions": {
+    "*": {
+      "core": ["dist/core/index.d.ts"],
+      "utils": ["dist/utils/index.d.ts"],
+      "react": ["dist/react/index.d.ts"]
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kelnishi/SatMouse.git",
+    "directory": "packages/client"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}