@bquery/bquery 1.5.0 → 1.7.0

package/dist/media-Di2Ta22s.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-Di2Ta22s.js","names":[],"sources":["../src/media/media-query.ts","../src/media/breakpoints.ts","../src/media/viewport.ts","../src/media/network.ts","../src/media/battery.ts","../src/media/geolocation.ts","../src/media/device-sensors.ts","../src/media/clipboard.ts"],"sourcesContent":["/**\r\n * Reactive media query matching.\r\n *\r\n * Returns a reactive boolean signal that tracks whether a CSS media query matches.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport { readonly, signal } from '../reactive/index';\r\nimport type { MediaSignalHandle } from './types';\r\n\r\n/**\r\n * Creates a reactive signal that tracks whether a CSS media query matches.\r\n *\r\n * Uses `window.matchMedia()` under the hood and automatically updates\r\n * when the match state changes (e.g., on window resize, device orientation change).\r\n *\r\n * @param query - A valid CSS media query string (e.g., `'(min-width: 768px)'`)\r\n * @returns A readonly reactive signal that is `true` when the query matches,\r\n * plus a `destroy()` method to remove the media query listener\r\n *\r\n * @example\r\n * ```ts\r\n * import { mediaQuery } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * const isDark = mediaQuery('(prefers-color-scheme: dark)');\r\n * effect(() => {\r\n *   document.body.classList.toggle('dark', isDark.value);\r\n * });\r\n *\r\n * const isWide = mediaQuery('(min-width: 1024px)');\r\n * effect(() => {\r\n *   console.log('Wide screen:', isWide.value);\r\n * });\r\n * ```\r\n */\r\nexport const mediaQuery = (query: string): MediaSignalHandle<boolean> => {\r\n  const s = signal(false);\r\n  let cleanup: (() => void) | undefined;\r\n\r\n  if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {\r\n    try {\r\n      const mql = window.matchMedia(query);\r\n      s.value = mql.matches;\r\n\r\n      const handler = (e: MediaQueryListEvent): void => {\r\n        s.value = e.matches;\r\n      };\r\n\r\n      if (typeof mql.addEventListener === 'function') {\r\n        mql.addEventListener('change', handler);\r\n        cleanup = () => {\r\n          mql.removeEventListener('change', handler);\r\n        };\r\n      } else if (\r\n        typeof (\r\n          mql as MediaQueryList & {\r\n            addListener?: (listener: (event: MediaQueryListEvent) => void) => void;\r\n            removeListener?: (listener: (event: MediaQueryListEvent) => void) => void;\r\n          }\r\n        ).addListener === 'function'\r\n      ) {\r\n        const legacyMql = mql as MediaQueryList & {\r\n          addListener: (listener: (event: MediaQueryListEvent) => void) => void;\r\n          removeListener: (listener: (event: MediaQueryListEvent) => void) => void;\r\n        };\r\n        legacyMql.addListener(handler);\r\n        cleanup = () => {\r\n          legacyMql.removeListener(handler);\r\n        };\r\n      }\r\n    } catch {\r\n      // matchMedia may throw in non-browser environments\r\n    }\r\n  }\r\n\r\n  const ro = readonly(s) as MediaSignalHandle<boolean>;\r\n  let destroyed = false;\r\n  Object.defineProperty(ro, 'destroy', {\r\n    enumerable: false,\r\n    configurable: true,\r\n    value(): void {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      cleanup?.();\r\n      s.dispose();\r\n    },\r\n  });\r\n\r\n  return ro;\r\n};\r\n","/**\r\n * Named breakpoint signals.\r\n *\r\n * Defines named breakpoints that return reactive boolean signals,\r\n * making it easy to respond to viewport size changes.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport { readonly, signal } from '../reactive/index';\r\nimport type { BreakpointMap, MediaSignalHandle } from './types';\r\n\r\ntype BreakpointSignals<T extends BreakpointMap> = { [K in keyof T]: MediaSignalHandle<boolean> } & {\r\n  destroyAll(): void;\r\n} & ('destroy' extends keyof T ? Record<never, never> : { destroy(): void });\r\n\r\n/**\r\n * Defines named breakpoints and returns reactive boolean signals for each.\r\n *\r\n * Each breakpoint is a minimum-width media query. The returned object maps\r\n * each breakpoint name to a `ReadonlySignal<boolean>` that is `true` when\r\n * the viewport width is at or above the breakpoint value.\r\n *\r\n * @param bp - An object mapping breakpoint names to minimum widths in pixels\r\n * @returns An object with the same keys, each a reactive boolean signal with\r\n * `destroy()`, plus a top-level `destroyAll()` method to clean up all listeners.\r\n * When no breakpoint is named `destroy`, a `destroy()` alias is also provided.\r\n *\r\n * @example\r\n * ```ts\r\n * import { breakpoints } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * const bp = breakpoints({ sm: 640, md: 768, lg: 1024, xl: 1280 });\r\n *\r\n * effect(() => {\r\n *   if (bp.xl.value) {\r\n *     console.log('Extra large viewport');\r\n *   } else if (bp.lg.value) {\r\n *     console.log('Large viewport');\r\n *   } else if (bp.md.value) {\r\n *     console.log('Medium viewport');\r\n *   } else {\r\n *     console.log('Small viewport');\r\n *   }\r\n * });\r\n * ```\r\n */\r\nexport const breakpoints = <T extends BreakpointMap>(\r\n  bp: T\r\n): BreakpointSignals<T> => {\r\n  const signals = {} as { [K in keyof T]: MediaSignalHandle<boolean> };\r\n  const destroyers: Array<() => void> = [];\r\n\r\n  type LegacyMediaQueryList = MediaQueryList & {\r\n    addListener?: (listener: (event: MediaQueryListEvent | MediaQueryList) => void) => void;\r\n    removeListener?: (listener: (event: MediaQueryListEvent | MediaQueryList) => void) => void;\r\n  };\r\n\r\n  for (const key of Object.keys(bp) as Array<keyof T>) {\r\n    const width = bp[key];\r\n    const s = signal(false);\r\n    let cleanup: (() => void) | undefined;\r\n\r\n    if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {\r\n      try {\r\n        const mql = window.matchMedia(`(min-width: ${width}px)`);\r\n        s.value = mql.matches;\r\n\r\n        const handler = (e: MediaQueryListEvent | MediaQueryList): void => {\r\n          s.value = e.matches;\r\n        };\r\n\r\n        if (typeof mql.addEventListener === 'function') {\r\n          mql.addEventListener('change', handler);\r\n          cleanup = () => {\r\n            mql.removeEventListener('change', handler);\r\n          };\r\n        } else {\r\n          const legacyMql = mql as LegacyMediaQueryList;\r\n          if (typeof legacyMql.addListener === 'function') {\r\n            legacyMql.addListener(handler);\r\n            cleanup = () => {\r\n              legacyMql.removeListener?.(handler);\r\n            };\r\n          }\r\n        }\r\n      } catch {\r\n        // matchMedia may throw in non-browser environments\r\n      }\r\n    }\r\n\r\n    const ro = readonly(s) as MediaSignalHandle<boolean>;\r\n    let destroyed = false;\r\n    Object.defineProperty(ro, 'destroy', {\r\n      enumerable: false,\r\n      configurable: true,\r\n      value(): void {\r\n        if (destroyed) return;\r\n        destroyed = true;\r\n        cleanup?.();\r\n        s.dispose();\r\n      },\r\n    });\r\n    destroyers.push(ro.destroy);\r\n    signals[key] = ro;\r\n  }\r\n\r\n  let destroyed = false;\r\n  const result = Object.defineProperty(signals, 'destroyAll', {\r\n    enumerable: false,\r\n    configurable: true,\r\n    value(): void {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      destroyers.forEach((destroy) => {\r\n        destroy();\r\n      });\r\n    },\r\n  }) as BreakpointSignals<T>;\r\n\r\n  if (!Object.prototype.hasOwnProperty.call(signals, 'destroy')) {\r\n    Object.defineProperty(result, 'destroy', {\r\n      enumerable: false,\r\n      configurable: true,\r\n      value: result.destroyAll,\r\n    });\r\n  }\r\n\r\n  return result;\r\n};\r\n","/**\r\n * Reactive viewport dimensions.\r\n *\r\n * Provides a reactive signal tracking the browser viewport's\r\n * width, height, and orientation.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport { readonly, signal } from '../reactive/index';\r\nimport type { ViewportSignal, ViewportState } from './types';\r\n\r\n/**\r\n * Computes orientation from width and height.\r\n * @internal\r\n */\r\nconst getOrientation = (w: number, h: number): 'portrait' | 'landscape' =>\r\n  h >= w ? 'portrait' : 'landscape';\r\n\r\n/**\r\n * Returns a reactive signal tracking the current viewport dimensions and orientation.\r\n *\r\n * Updates automatically when the window is resized. Uses `window.innerWidth`\r\n * and `window.innerHeight` under the hood.\r\n *\r\n * @returns A readonly reactive signal with `{ width, height, orientation }`\r\n * and a `destroy()` method to remove the resize listener\r\n *\r\n * @example\r\n * ```ts\r\n * import { useViewport } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * const viewport = useViewport();\r\n * effect(() => {\r\n *   console.log(`Viewport: ${viewport.value.width}x${viewport.value.height}`);\r\n *   console.log(`Orientation: ${viewport.value.orientation}`);\r\n * });\r\n * ```\r\n */\r\nexport const useViewport = (): ViewportSignal => {\r\n  const initial: ViewportState = {\r\n    width: typeof window !== 'undefined' ? window.innerWidth : 0,\r\n    height: typeof window !== 'undefined' ? window.innerHeight : 0,\r\n    orientation:\r\n      typeof window !== 'undefined'\r\n        ? getOrientation(window.innerWidth, window.innerHeight)\r\n        : 'portrait',\r\n  };\r\n\r\n  const s = signal<ViewportState>(initial);\r\n\r\n  let cleanup: (() => void) | undefined;\r\n\r\n  if (typeof window !== 'undefined') {\r\n    const handler = (): void => {\r\n      s.value = {\r\n        width: window.innerWidth,\r\n        height: window.innerHeight,\r\n        orientation: getOrientation(window.innerWidth, window.innerHeight),\r\n      };\r\n    };\r\n\r\n    window.addEventListener('resize', handler);\r\n    cleanup = () => {\r\n      window.removeEventListener('resize', handler);\r\n    };\r\n  }\r\n\r\n  const ro = readonly(s) as ViewportSignal;\r\n  let destroyed = false;\r\n  Object.defineProperty(ro, 'destroy', {\r\n    enumerable: false,\r\n    configurable: true,\r\n    value: (): void => {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      cleanup?.();\r\n      s.dispose();\r\n    },\r\n  });\r\n\r\n  return ro;\r\n};\r\n","/**\r\n * Reactive network status.\r\n *\r\n * Provides a reactive signal tracking the browser's network connectivity\r\n * and connection quality via the Network Information API.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport { readonly, signal } from '../reactive/index';\r\nimport type { NetworkSignal, NetworkState } from './types';\r\n\r\n/**\r\n * Navigator connection interface for the Network Information API.\r\n * @internal\r\n */\r\ninterface NavigatorConnection extends EventTarget {\r\n  effectiveType?: string;\r\n  downlink?: number;\r\n  rtt?: number;\r\n}\r\n\r\n/**\r\n * Extended Navigator with connection property.\r\n * @internal\r\n */\r\ninterface NavigatorWithConnection extends Navigator {\r\n  connection?: NavigatorConnection;\r\n}\r\n\r\n/**\r\n * Reads current network state from browser APIs.\r\n * @internal\r\n */\r\nconst getNetworkState = (): NetworkState => {\r\n  const online =\r\n    typeof navigator !== 'undefined' && navigator.onLine !== undefined ? navigator.onLine : true;\r\n\r\n  const nav = typeof navigator !== 'undefined' ? (navigator as NavigatorWithConnection) : undefined;\r\n  const conn = nav?.connection;\r\n\r\n  return {\r\n    online,\r\n    effectiveType: conn?.effectiveType ?? 'unknown',\r\n    downlink: conn?.downlink ?? 0,\r\n    rtt: conn?.rtt ?? 0,\r\n  };\r\n};\r\n\r\n/**\r\n * Returns a reactive signal tracking network connectivity and quality.\r\n *\r\n * Tracks whether the browser is online/offline and, where supported,\r\n * the effective connection type, downlink speed, and round-trip time\r\n * via the Network Information API.\r\n *\r\n * @returns A readonly reactive signal with `{ online, effectiveType, downlink, rtt }`\r\n * and a `destroy()` method to remove attached listeners\r\n *\r\n * @example\r\n * ```ts\r\n * import { useNetworkStatus } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * const net = useNetworkStatus();\r\n * effect(() => {\r\n *   if (!net.value.online) {\r\n *     console.warn('You are offline!');\r\n *   }\r\n *   console.log(`Connection: ${net.value.effectiveType}, RTT: ${net.value.rtt}ms`);\r\n * });\r\n * ```\r\n */\r\nexport const useNetworkStatus = (): NetworkSignal => {\r\n  const s = signal<NetworkState>(getNetworkState());\r\n  let cleanup: (() => void) | undefined;\r\n\r\n  if (typeof window !== 'undefined') {\r\n    const update = (): void => {\r\n      s.value = getNetworkState();\r\n    };\r\n\r\n    window.addEventListener('online', update);\r\n    window.addEventListener('offline', update);\r\n\r\n    const nav =\r\n      typeof navigator !== 'undefined' ? (navigator as NavigatorWithConnection) : undefined;\r\n    if (nav?.connection && typeof nav.connection.addEventListener === 'function') {\r\n      nav.connection.addEventListener('change', update);\r\n    }\r\n\r\n    cleanup = () => {\r\n      window.removeEventListener('online', update);\r\n      window.removeEventListener('offline', update);\r\n      if (nav?.connection && typeof nav.connection.removeEventListener === 'function') {\r\n        nav.connection.removeEventListener('change', update);\r\n      }\r\n    };\r\n  }\r\n\r\n  const ro = readonly(s) as NetworkSignal;\r\n  let destroyed = false;\r\n  Object.defineProperty(ro, 'destroy', {\r\n    value(): void {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      cleanup?.();\r\n      s.dispose();\r\n    },\r\n    enumerable: false,\r\n    configurable: true,\r\n  });\r\n\r\n  return ro;\r\n};\r\n","/**\r\n * Reactive battery status.\r\n *\r\n * Provides a reactive signal tracking the device's battery status\r\n * via the Battery Status API.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport { signal, readonly } from '../reactive/index';\r\nimport type { BatterySignal, BatteryState } from './types';\r\n\r\n/**\r\n * BatteryManager interface for the Battery Status API.\r\n * @internal\r\n */\r\ninterface BatteryManager extends EventTarget {\r\n  charging: boolean;\r\n  chargingTime: number;\r\n  dischargingTime: number;\r\n  level: number;\r\n}\r\n\r\n/** Default battery state when API is unavailable. */\r\nconst DEFAULT_BATTERY_STATE: BatteryState = {\r\n  supported: false,\r\n  charging: false,\r\n  chargingTime: 0,\r\n  dischargingTime: 0,\r\n  level: 1,\r\n};\r\n\r\n/**\r\n * Returns a reactive signal tracking the device's battery status.\r\n *\r\n * Uses the Battery Status API (`navigator.getBattery()`) where available.\r\n * Falls back gracefully to a default state with `supported: false` when\r\n * the API is not available.\r\n *\r\n * @returns A readonly reactive signal with battery state and a `destroy()` method\r\n * to remove Battery Status API listeners\r\n *\r\n * @example\r\n * ```ts\r\n * import { useBattery } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * const battery = useBattery();\r\n * effect(() => {\r\n *   if (battery.value.supported) {\r\n *     console.log(`Battery: ${(battery.value.level * 100).toFixed(0)}%`);\r\n *     console.log(`Charging: ${battery.value.charging}`);\r\n *   }\r\n * });\r\n * ```\r\n */\r\nexport const useBattery = (): BatterySignal => {\r\n  const s = signal<BatteryState>({ ...DEFAULT_BATTERY_STATE });\r\n  let cleanup: (() => void) | undefined;\r\n  let destroyed = false;\r\n\r\n  if (\r\n    typeof navigator !== 'undefined' &&\r\n    'getBattery' in navigator &&\r\n    typeof (navigator as Navigator & { getBattery: () => Promise<BatteryManager> }).getBattery ===\r\n      'function'\r\n  ) {\r\n    const nav = navigator as Navigator & { getBattery: () => Promise<BatteryManager> };\r\n\r\n    nav\r\n      .getBattery()\r\n      .then((battery) => {\r\n        if (destroyed) return;\r\n\r\n        const update = (): void => {\r\n          s.value = {\r\n            supported: true,\r\n            charging: battery.charging,\r\n            chargingTime: battery.chargingTime,\r\n            dischargingTime: battery.dischargingTime,\r\n            level: battery.level,\r\n          };\r\n        };\r\n\r\n        update();\r\n\r\n        battery.addEventListener('chargingchange', update);\r\n        battery.addEventListener('chargingtimechange', update);\r\n        battery.addEventListener('dischargingtimechange', update);\r\n        battery.addEventListener('levelchange', update);\r\n        cleanup = () => {\r\n          battery.removeEventListener('chargingchange', update);\r\n          battery.removeEventListener('chargingtimechange', update);\r\n          battery.removeEventListener('dischargingtimechange', update);\r\n          battery.removeEventListener('levelchange', update);\r\n        };\r\n      })\r\n      .catch(() => {\r\n        // Battery API rejected — keep default state\r\n      });\r\n  }\r\n\r\n  const ro = readonly(s) as BatterySignal;\r\n  Object.defineProperty(ro, 'destroy', {\r\n    enumerable: false,\r\n    configurable: true,\r\n    value(): void {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      cleanup?.();\r\n      s.dispose();\r\n    },\r\n  });\r\n\r\n  return ro;\r\n};\r\n","/**\r\n * Reactive geolocation.\r\n *\r\n * Provides a reactive signal tracking the device's geographic position\r\n * via the Geolocation API.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport { signal, readonly } from '../reactive/index';\r\nimport type { GeolocationOptions, GeolocationSignal, GeolocationState } from './types';\r\n\r\n/** Default geolocation state. */\r\nconst DEFAULT_GEO_STATE: GeolocationState = {\r\n  supported: false,\r\n  loading: false,\r\n  latitude: null,\r\n  longitude: null,\r\n  accuracy: null,\r\n  altitude: null,\r\n  altitudeAccuracy: null,\r\n  heading: null,\r\n  speed: null,\r\n  timestamp: null,\r\n  error: null,\r\n};\r\n\r\n/**\r\n * Returns a reactive signal tracking the device's geographic position.\r\n *\r\n * Uses the Geolocation API (`navigator.geolocation`) where available.\r\n * Can operate in one-shot mode (default) or continuous watch mode.\r\n *\r\n * @param options - Configuration for the geolocation request\r\n * @returns A readonly reactive signal with position data and loading/error state,\r\n * plus a `destroy()` method to stop an active watcher\r\n *\r\n * @example\r\n * ```ts\r\n * import { useGeolocation } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * // One-shot position\r\n * const geo = useGeolocation();\r\n * effect(() => {\r\n *   if (geo.value.loading) return console.log('Getting position...');\r\n *   if (geo.value.error) return console.error(geo.value.error);\r\n *   console.log(`Lat: ${geo.value.latitude}, Lng: ${geo.value.longitude}`);\r\n * });\r\n *\r\n * // Continuous watch with high accuracy\r\n * const geoWatch = useGeolocation({ watch: true, enableHighAccuracy: true });\r\n * ```\r\n */\r\nexport const useGeolocation = (options: GeolocationOptions = {}): GeolocationSignal => {\r\n  const { enableHighAccuracy = false, maximumAge = 0, timeout = Infinity, watch = false } = options;\r\n\r\n  const s = signal<GeolocationState>({ ...DEFAULT_GEO_STATE });\r\n\r\n  let destroyWatcher: (() => void) | undefined;\r\n\r\n  if (typeof navigator !== 'undefined' && 'geolocation' in navigator) {\r\n    s.value = { ...DEFAULT_GEO_STATE, supported: true, loading: true };\r\n\r\n    const posOptions: PositionOptions = {\r\n      enableHighAccuracy,\r\n      maximumAge,\r\n      timeout: timeout === Infinity ? undefined : timeout,\r\n    };\r\n\r\n    const onSuccess = (pos: GeolocationPosition): void => {\r\n      s.value = {\r\n        supported: true,\r\n        loading: false,\r\n        latitude: pos.coords.latitude,\r\n        longitude: pos.coords.longitude,\r\n        accuracy: pos.coords.accuracy,\r\n        altitude: pos.coords.altitude,\r\n        altitudeAccuracy: pos.coords.altitudeAccuracy,\r\n        heading: pos.coords.heading,\r\n        speed: pos.coords.speed,\r\n        timestamp: pos.timestamp,\r\n        error: null,\r\n      };\r\n    };\r\n\r\n    const onError = (err: GeolocationPositionError): void => {\r\n      s.value = {\r\n        ...s.value,\r\n        loading: false,\r\n        error: err.message,\r\n      };\r\n    };\r\n\r\n    if (watch) {\r\n      const watchId = navigator.geolocation.watchPosition(onSuccess, onError, posOptions);\r\n      destroyWatcher = () => {\r\n        navigator.geolocation.clearWatch(watchId);\r\n      };\r\n    } else {\r\n      navigator.geolocation.getCurrentPosition(onSuccess, onError, posOptions);\r\n    }\r\n  }\r\n\r\n  const ro = readonly(s) as GeolocationSignal;\r\n  let destroyed = false;\r\n  Object.defineProperty(ro, 'destroy', {\r\n    enumerable: false,\r\n    configurable: true,\r\n    value(): void {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      destroyWatcher?.();\r\n      s.dispose();\r\n    },\r\n  });\r\n\r\n  return ro;\r\n};\r\n","/**\r\n * Reactive device motion and orientation sensors.\r\n *\r\n * Provides reactive signals for accelerometer, gyroscope, and\r\n * compass data via the DeviceMotion and DeviceOrientation APIs.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport { signal, readonly } from '../reactive/index';\r\nimport type {\r\n  DeviceMotionSignal,\r\n  DeviceMotionState,\r\n  DeviceOrientationSignal,\r\n  DeviceOrientationState,\r\n} from './types';\r\n\r\n/** Default device motion state. */\r\nconst DEFAULT_MOTION_STATE: DeviceMotionState = {\r\n  acceleration: { x: null, y: null, z: null },\r\n  accelerationIncludingGravity: { x: null, y: null, z: null },\r\n  rotationRate: { alpha: null, beta: null, gamma: null },\r\n  interval: 0,\r\n};\r\n\r\n/** Default device orientation state. */\r\nconst DEFAULT_ORIENTATION_STATE: DeviceOrientationState = {\r\n  alpha: null,\r\n  beta: null,\r\n  gamma: null,\r\n  absolute: false,\r\n};\r\n\r\n/**\r\n * Returns a reactive signal tracking device motion (accelerometer + gyroscope).\r\n *\r\n * Uses the `devicemotion` event to provide acceleration, acceleration\r\n * including gravity, and rotation rate data.\r\n *\r\n * @returns A readonly reactive signal with motion sensor data and a `destroy()`\r\n * method to remove the underlying event listener\r\n *\r\n * @example\r\n * ```ts\r\n * import { useDeviceMotion } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * const motion = useDeviceMotion();\r\n * effect(() => {\r\n *   const { acceleration } = motion.value;\r\n *   console.log(`Acceleration: x=${acceleration.x}, y=${acceleration.y}, z=${acceleration.z}`);\r\n * });\r\n * ```\r\n */\r\nexport const useDeviceMotion = (): DeviceMotionSignal => {\r\n  const s = signal<DeviceMotionState>({ ...DEFAULT_MOTION_STATE });\r\n  let cleanup: (() => void) | undefined;\r\n\r\n  if (typeof window !== 'undefined') {\r\n    const handler = (e: DeviceMotionEvent): void => {\r\n      s.value = {\r\n        acceleration: {\r\n          x: e.acceleration?.x ?? null,\r\n          y: e.acceleration?.y ?? null,\r\n          z: e.acceleration?.z ?? null,\r\n        },\r\n        accelerationIncludingGravity: {\r\n          x: e.accelerationIncludingGravity?.x ?? null,\r\n          y: e.accelerationIncludingGravity?.y ?? null,\r\n          z: e.accelerationIncludingGravity?.z ?? null,\r\n        },\r\n        rotationRate: {\r\n          alpha: e.rotationRate?.alpha ?? null,\r\n          beta: e.rotationRate?.beta ?? null,\r\n          gamma: e.rotationRate?.gamma ?? null,\r\n        },\r\n        interval: e.interval ?? 0,\r\n      };\r\n    };\r\n\r\n    window.addEventListener('devicemotion', handler);\r\n    cleanup = () => {\r\n      window.removeEventListener('devicemotion', handler);\r\n    };\r\n  }\r\n\r\n  const ro = readonly(s) as DeviceMotionSignal;\r\n  let destroyed = false;\r\n  Object.defineProperty(ro, 'destroy', {\r\n    enumerable: false,\r\n    configurable: true,\r\n    value(): void {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      cleanup?.();\r\n      s.dispose();\r\n    },\r\n  });\r\n\r\n  return ro;\r\n};\r\n\r\n/**\r\n * Returns a reactive signal tracking device orientation (compass/gyroscope).\r\n *\r\n * Uses the `deviceorientation` event to provide alpha (compass heading),\r\n * beta (front-to-back tilt), and gamma (left-to-right tilt) data.\r\n *\r\n * @returns A readonly reactive signal with orientation data and a `destroy()`\r\n * method to remove the underlying event listener\r\n *\r\n * @example\r\n * ```ts\r\n * import { useDeviceOrientation } from '@bquery/bquery/media';\r\n * import { effect } from '@bquery/bquery/reactive';\r\n *\r\n * const orientation = useDeviceOrientation();\r\n * effect(() => {\r\n *   console.log(`Compass heading: ${orientation.value.alpha}°`);\r\n *   console.log(`Tilt: ${orientation.value.beta}° / ${orientation.value.gamma}°`);\r\n * });\r\n * ```\r\n */\r\nexport const useDeviceOrientation = (): DeviceOrientationSignal => {\r\n  const s = signal<DeviceOrientationState>({ ...DEFAULT_ORIENTATION_STATE });\r\n  let cleanup: (() => void) | undefined;\r\n\r\n  if (typeof window !== 'undefined') {\r\n    const handler = (e: DeviceOrientationEvent): void => {\r\n      s.value = {\r\n        alpha: e.alpha ?? null,\r\n        beta: e.beta ?? null,\r\n        gamma: e.gamma ?? null,\r\n        absolute: e.absolute ?? false,\r\n      };\r\n    };\r\n\r\n    window.addEventListener('deviceorientation', handler);\r\n    cleanup = () => {\r\n      window.removeEventListener('deviceorientation', handler);\r\n    };\r\n  }\r\n\r\n  const ro = readonly(s) as DeviceOrientationSignal;\r\n  let destroyed = false;\r\n  Object.defineProperty(ro, 'destroy', {\r\n    enumerable: false,\r\n    configurable: true,\r\n    value(): void {\r\n      if (destroyed) return;\r\n      destroyed = true;\r\n      cleanup?.();\r\n      s.dispose();\r\n    },\r\n  });\r\n\r\n  return ro;\r\n};\r\n","/**\r\n * Async clipboard API wrappers.\r\n *\r\n * Provides simple read/write access to the system clipboard\r\n * via the Async Clipboard API.\r\n *\r\n * @module bquery/media\r\n */\r\n\r\nimport type { ClipboardAPI } from './types';\r\n\r\nconst CLIPBOARD_UNAVAILABLE_ERROR =\r\n  'bQuery media: Clipboard API is unavailable. Use a secure context (HTTPS or localhost) and ensure clipboard permissions or user-activation requirements are met.';\r\n\r\n/**\r\n * Clipboard API wrapper providing simple async read/write access.\r\n *\r\n * Uses the modern Async Clipboard API (`navigator.clipboard`) under the hood.\r\n * Both methods are `Promise`-based and will reject if the API is unavailable\r\n * or permission is denied.\r\n *\r\n * @example\r\n * ```ts\r\n * import { clipboard } from '@bquery/bquery/media';\r\n *\r\n * // Write text to clipboard\r\n * await clipboard.write('Hello, world!');\r\n *\r\n * // Read text from clipboard\r\n * const text = await clipboard.read();\r\n * console.log(text); // \"Hello, world!\"\r\n * ```\r\n */\r\nexport const clipboard: ClipboardAPI = {\r\n  /**\r\n   * Reads text from the system clipboard.\r\n   *\r\n   * @returns A promise that resolves with the clipboard text content\r\n   * @throws Error if the Clipboard API is not available or permission is denied\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * const text = await clipboard.read();\r\n   * console.log('Clipboard contains:', text);\r\n   * ```\r\n   */\r\n  read: async (): Promise<string> => {\r\n    if (\r\n      typeof navigator === 'undefined' ||\r\n      !navigator.clipboard ||\r\n      typeof navigator.clipboard.readText !== 'function'\r\n    ) {\r\n      throw new Error(CLIPBOARD_UNAVAILABLE_ERROR);\r\n    }\r\n    return navigator.clipboard.readText();\r\n  },\r\n\r\n  /**\r\n   * Writes text to the system clipboard.\r\n   *\r\n   * @param text - The text to write to the clipboard\r\n   * @returns A promise that resolves when the text has been written\r\n   * @throws Error if the Clipboard API is not available or permission is denied\r\n   *\r\n   * @example\r\n   * ```ts\r\n   * await clipboard.write('Copied!');\r\n   * ```\r\n   */\r\n  write: async (text: string): Promise<void> => {\r\n    if (\r\n      typeof navigator === 'undefined' ||\r\n      !navigator.clipboard ||\r\n      typeof navigator.clipboard.writeText !== 'function'\r\n    ) {\r\n      throw new Error(CLIPBOARD_UNAVAILABLE_ERROR);\r\n    }\r\n    return navigator.clipboard.writeText(text);\r\n  },\r\n};\r\n"],"mappings":"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"}

package/dist/media.es.mjs

@@ -0,0 +1,12 @@
+import { a as s, c as a, i as o, l as t, n as i, o as r, r as u, s as n, t as c } from "./media-Di2Ta22s.js";
+export {
+  a as breakpoints,
+  c as clipboard,
+  t as mediaQuery,
+  s as useBattery,
+  i as useDeviceMotion,
+  u as useDeviceOrientation,
+  o as useGeolocation,
+  r as useNetworkStatus,
+  n as useViewport
+};

package/dist/motion/index.d.ts

@@ -1,18 +1,22 @@
 /**
- * Motion module providing view transitions, FLIP animations, and spring physics.
+ * Motion module providing view transitions, FLIP animations, spring physics,
+ * parallax, typewriter effects, and more.
  * Designed to work with modern browser APIs while providing smooth fallbacks.
  *
  * @module bquery/motion
  */
-export type { AnimateOptions, EasingFunction, ElementBounds, FlipGroupOptions, FlipOptions, ScrollAnimateCleanup, ScrollAnimateOptions, SequenceOptions, SequenceStep, Spring, SpringConfig, StaggerFunction, StaggerOptions, TimelineConfig, TimelineControls, TimelineStep, TransitionOptions, } from './types';
+export type { AnimateOptions, EasingFunction, ElementBounds, FlipGroupOptions, FlipOptions, MorphOptions, ParallaxCleanup, ParallaxOptions, ScrollAnimateCleanup, ScrollAnimateOptions, SequenceOptions, SequenceStep, Spring, SpringConfig, StaggerFunction, StaggerOptions, TimelineConfig, TimelineControls, TimelineStep, TransitionOptions, TypewriterControls, TypewriterOptions, } from './types';
 export { animate } from './animate';
 export { easeInCubic, easeInOutCubic, easeInOutQuad, easeInQuad, easeOutBack, easeOutCubic, easeOutExpo, easeOutQuad, easingPresets, linear, } from './easing';
 export { capturePosition, flip, flipElements, flipList } from './flip';
 export { keyframePresets } from './keyframes';
-export { prefersReducedMotion } from './reduced-motion';
+export { morphElement } from './morph';
+export { parallax } from './parallax';
+export { prefersReducedMotion, setReducedMotion } from './reduced-motion';
 export { scrollAnimate } from './scroll';
 export { spring, springPresets } from './spring';
 export { stagger } from './stagger';
 export { sequence, timeline } from './timeline';
 export { transition } from './transition';
+export { typewriter } from './typewriter';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/motion/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/motion/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,MAAM,EACN,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/motion/morph.d.ts

@@ -0,0 +1,27 @@
+/**
+ * FLIP-based morph animation between two element states.
+ *
+ * @module bquery/motion
+ */
+import type { MorphOptions } from './types';
+/**
+ * Perform a FLIP-based morph animation between two elements.
+ *
+ * Captures the bounding rect of the `from` element, hides it, shows the
+ * `to` element, then animates the `to` element from the `from` position
+ * using CSS transforms and opacity.
+ *
+ * @param from - The source element (will be hidden at the end)
+ * @param to - The destination element (will be shown and animated into place)
+ * @param options - Morph animation options
+ * @returns Promise that resolves when the morph completes
+ *
+ * @example
+ * ```ts
+ * const card = document.querySelector('.card');
+ * const detail = document.querySelector('.detail');
+ * await morphElement(card, detail, { duration: 400, easing: 'ease-out' });
+ * ```
+ */
+export declare const morphElement: (from: Element, to: Element, options?: MorphOptions) => Promise<void>;
+//# sourceMappingURL=morph.d.ts.map

package/dist/motion/morph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morph.d.ts","sourceRoot":"","sources":["../../src/motion/morph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,OAAO,EACb,IAAI,OAAO,EACX,UAAS,YAAiB,KACzB,OAAO,CAAC,IAAI,CAsHd,CAAC"}

package/dist/motion/parallax.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Scroll-linked parallax effect.
+ *
+ * @module bquery/motion
+ */
+import type { ParallaxCleanup, ParallaxOptions } from './types';
+/**
+ * Apply a scroll-linked parallax effect to an element.
+ *
+ * The element's position is translated based on the scroll position
+ * multiplied by the speed factor. A speed of `0.5` means the element
+ * moves at half the scroll speed (classic background parallax).
+ *
+ * @param element - The element to apply the parallax effect to
+ * @param options - Parallax configuration
+ * @returns A cleanup function that removes the scroll listener
+ *
+ * @example
+ * ```ts
+ * const cleanup = parallax(document.querySelector('.hero-bg')!, {
+ *   speed: 0.3,
+ *   direction: 'vertical',
+ * });
+ *
+ * // Later, remove the effect:
+ * cleanup();
+ * ```
+ */
+export declare const parallax: (element: Element, options?: ParallaxOptions) => ParallaxCleanup;
+//# sourceMappingURL=parallax.d.ts.map

package/dist/motion/parallax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallax.d.ts","sourceRoot":"","sources":["../../src/motion/parallax.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,OAAO,EAAE,UAAS,eAAoB,KAAG,eAwF1E,CAAC"}

package/dist/motion/reduced-motion.d.ts

@@ -1,12 +1,45 @@
 /**
- * Reduced motion detection helpers.
+ * Reduced motion detection and global toggle helpers.
  *
  * @module bquery/motion
  */
 /**
- * Check whether the user prefers reduced motion.
+ * Check whether reduced motion should be applied.
  *
- * @returns true if the user prefers reduced motion, otherwise false
+ * Returns the global override if set via {@link setReducedMotion},
+ * otherwise checks the user's system preference.
+ *
+ * @returns `true` if reduced motion should be applied
+ *
+ * @example
+ * ```ts
+ * if (prefersReducedMotion()) {
+ *   // skip animation
+ * }
+ * ```
  */
 export declare const prefersReducedMotion: () => boolean;
+/**
+ * Programmatically override the reduced motion preference globally.
+ *
+ * When set to `true`, all motion functions that respect reduced motion
+ * will skip animations. When set to `false`, animations run regardless
+ * of system settings. Pass `null` to restore system-preference detection.
+ *
+ * @param override - `true` to force reduced motion, `false` to force
+ *   full motion, or `null` to use system preference
+ *
+ * @example
+ * ```ts
+ * // Force all animations to be instant
+ * setReducedMotion(true);
+ *
+ * // Re-enable animations regardless of system
+ * setReducedMotion(false);
+ *
+ * // Restore system preference
+ * setReducedMotion(null);
+ * ```
+ */
+export declare const setReducedMotion: (override: boolean | null) => void;
 //# sourceMappingURL=reduced-motion.d.ts.map

package/dist/motion/reduced-motion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reduced-motion.d.ts","sourceRoot":"","sources":["../../src/motion/reduced-motion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,OAKvC,CAAC"}
+{"version":3,"file":"reduced-motion.d.ts","sourceRoot":"","sources":["../../src/motion/reduced-motion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,QAAO,OAQvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,OAAO,GAAG,IAAI,KAAG,IAE3D,CAAC"}

package/dist/motion/types.d.ts

@@ -189,4 +189,62 @@ export interface ScrollAnimateOptions extends AnimateOptions {
  * Cleanup function for scroll animations.
  */
 export type ScrollAnimateCleanup = () => void;
+/**
+ * Options for the `morphElement` FLIP-based morph animation.
+ */
+export interface MorphOptions {
+    /** Animation duration in milliseconds (default: 300) */
+    duration?: number;
+    /** CSS easing function (default: 'ease') */
+    easing?: string;
+    /** Whether to respect prefers-reduced-motion (default: true) */
+    respectReducedMotion?: boolean;
+    /** Callback when morph completes */
+    onComplete?: () => void;
+}
+/**
+ * Options for the `parallax` scroll-linked effect.
+ */
+export interface ParallaxOptions {
+    /** Parallax speed multiplier (default: 0.5). Values < 1 are slower, > 1 are faster. */
+    speed?: number;
+    /** Direction of the parallax effect (default: 'vertical') */
+    direction?: 'vertical' | 'horizontal' | 'both';
+    /** Whether to respect prefers-reduced-motion (default: true) */
+    respectReducedMotion?: boolean;
+}
+/**
+ * Cleanup function for the parallax effect.
+ */
+export type ParallaxCleanup = () => void;
+/**
+ * Options for the `typewriter` text animation.
+ */
+export interface TypewriterOptions {
+    /** Time in milliseconds between each character (default: 50) */
+    speed?: number;
+    /** Initial delay before starting, in milliseconds (default: 0) */
+    delay?: number;
+    /** Whether to show a blinking cursor (default: false) */
+    cursor?: boolean;
+    /** Cursor character (default: '|') */
+    cursorChar?: string;
+    /** Whether to loop the animation (default: false) */
+    loop?: boolean;
+    /** Pause duration at end before looping, in ms (default: 1000) */
+    loopDelay?: number;
+    /** Whether to respect prefers-reduced-motion (default: true) */
+    respectReducedMotion?: boolean;
+    /** Callback when typing completes (per-loop) */
+    onComplete?: () => void;
+}
+/**
+ * Controls for an active typewriter animation.
+ */
+export interface TypewriterControls {
+    /** Stop the animation and clean up */
+    stop(): void;
+    /** Promise that resolves when the animation finishes, or when a looping animation is stopped */
+    done: Promise<void>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/motion/types.d.ts.map

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

package/dist/motion/typewriter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Character-by-character typewriter text animation.
+ *
+ * @module bquery/motion
+ */
+import type { TypewriterControls, TypewriterOptions } from './types';
+/**
+ * Animate text appearing character by character in an element.
+ *
+ * @param element - The element to type text into
+ * @param text - The text to display
+ * @param options - Typewriter configuration
+ * @returns Controls with `.stop()` to cancel and `.done` promise
+ *
+ * @example
+ * ```ts
+ * const tw = typewriter(
+ *   document.querySelector('#output')!,
+ *   'Hello, world!',
+ *   { speed: 80, cursor: true },
+ * );
+ *
+ * // Wait for it to finish:
+ * await tw.done;
+ *
+ * // Or cancel early:
+ * tw.stop();
+ * ```
+ */
+export declare const typewriter: (element: HTMLElement, text: string, options?: TypewriterOptions) => TypewriterControls;
+//# sourceMappingURL=typewriter.d.ts.map

package/dist/motion/typewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typewriter.d.ts","sourceRoot":"","sources":["../../src/motion/typewriter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,GACrB,SAAS,WAAW,EACpB,MAAM,MAAM,EACZ,UAAS,iBAAsB,KAC9B,kBA+HF,CAAC"}