tempest-react-sdk 0.78.0 → 0.79.0

package/dist/geo/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","names":[],"sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"mappings":"AA0EA,SAAgB,EAAgB,EAAwB,CACpD,OAAO,OAAO,SAAS,CAAK,GAAK,GAAS,KAAO,GAAS,EAC9D,CAGA,SAAgB,EAAiB,EAAwB,CACrD,OAAO,OAAO,SAAS,CAAK,GAAK,GAAS,MAAQ,GAAS,GAC/D,CAMA,SAAgB,EAAa,EAAqC,CAC9D,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GACxD,IAAM,EAAY,EAClB,OACI,OAAO,EAAU,UAAa,UAC9B,OAAO,EAAU,WAAc,UAC/B,EAAgB,EAAU,QAAQ,GAClC,EAAiB,EAAU,SAAS,CAE5C,CAGA,SAAgB,EAAc,EAA0B,CACpD,OAAO,KAAK,IAAI,GAAI,KAAK,IAAI,IAAK,CAAQ,CAAC,CAC/C,CAMA,SAAgB,EAAmB,EAA2B,CAE1D,QADoB,EAAY,KAAO,IAAO,KAAO,IAAO,GAEhE"}
+{"version":3,"file":"types.cjs","names":["isValidLatitude","value","isValidLongitude","isCoordinate","candidate","clampLatitude","latitude","normalizeLongitude","longitude"],"sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"mappings":"AA0EA,SAAgBA,EAAgB,EAAwB,CACpD,OAAO,OAAO,SAASC,CAAK,GAAKA,GAAS,KAAOA,GAAS,EAC9D,CAGA,SAAgBC,EAAiB,EAAwB,CACrD,OAAO,OAAO,SAASD,CAAK,GAAKA,GAAS,MAAQA,GAAS,GAC/D,CAMA,SAAgBE,EAAa,EAAqC,CAC9D,GAAI,OAAOF,GAAU,WAAYA,EAAgB,MAAO,GACxD,IAAMG,EAAYH,EAClB,OACI,OAAOG,EAAU,UAAa,UAC9B,OAAOA,EAAU,WAAc,UAC/BJ,EAAgBI,EAAU,QAAQ,GAClCF,EAAiBE,EAAU,SAAS,CAE5C,CAGA,SAAgBC,EAAc,EAA0B,CACpD,OAAO,KAAK,IAAI,GAAI,KAAK,IAAI,IAAKC,CAAQ,CAAC,CAC/C,CAMA,SAAgBC,EAAmB,EAA2B,CAE1D,QADoBC,EAAY,KAAO,IAAO,KAAO,IAAO,GAEhE,C"}

package/dist/geo/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"mappings":";AA0EA,SAAgB,EAAgB,GAAwB;CACpD,OAAO,OAAO,SAAS,CAAK,KAAK,KAAS,OAAO,KAAS;AAC9D;AAGA,SAAgB,EAAiB,GAAwB;CACrD,OAAO,OAAO,SAAS,CAAK,KAAK,KAAS,QAAQ,KAAS;AAC/D;AAMA,SAAgB,EAAa,GAAqC;CAC9D,IAAI,OAAO,KAAU,aAAY,GAAgB,OAAO;CACxD,IAAM,IAAY;CAClB,OACI,OAAO,EAAU,YAAa,YAC9B,OAAO,EAAU,aAAc,YAC/B,EAAgB,EAAU,QAAQ,KAClC,EAAiB,EAAU,SAAS;AAE5C;AAGA,SAAgB,EAAc,GAA0B;CACpD,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI,KAAK,CAAQ,CAAC;AAC/C;AAMA,SAAgB,EAAmB,GAA2B;CAE1D,SADoB,IAAY,OAAO,MAAO,OAAO,MAAO;AAEhE"}
+{"version":3,"file":"types.js","names":["isValidLatitude","value","isValidLongitude","isCoordinate","candidate","clampLatitude","latitude","normalizeLongitude","longitude"],"sources":["../../src/geo/types.ts"],"sourcesContent":["/**\n * WGS84 geographic coordinate. Mirrors the `Coordinate` schema from\n * `tempest-fastapi-sdk` (`geo/schemas.py`) — `latitude` in `[-90, 90]`,\n * `longitude` in `[-180, 180]`, serialized snake_case on the wire.\n */\nexport interface Coordinate {\n    /** WGS84 latitude in degrees, `[-90, 90]`. E.g. `-23.5505`. */\n    latitude: number;\n    /** WGS84 longitude in degrees, `[-180, 180]`. E.g. `-46.6333`. */\n    longitude: number;\n}\n\n/**\n * A pin plotted on a map: a {@link Coordinate} plus optional presentation and\n * an identity used for click callbacks. Shared by `TrajectoryMap` and the\n * Brazil maps' `markers` prop.\n */\nexport interface GeoMarker extends Coordinate {\n    /** Stable identity (returned by click handlers). Falls back to the index. */\n    id?: string;\n    /** Tooltip / accessible label for the pin. */\n    label?: string;\n    /** Fill color. Defaults to the primary token. */\n    color?: string;\n    /** Radius in pixels. Default: 6. */\n    radius?: number;\n}\n\n/**\n * A single sample in a recorded trajectory: a {@link Coordinate} stamped with\n * the epoch millisecond it was captured, plus the optional accuracy radius\n * reported by the Geolocation API.\n */\nexport interface TrackPoint extends Coordinate {\n    /** Capture time in epoch milliseconds (`GeolocationPosition.timestamp`). */\n    timestamp: number;\n    /** Horizontal accuracy radius in meters, if the device reported one. */\n    accuracy?: number;\n}\n\n/**\n * Travel mode. Mirrors the `TravelMode` string enum from `tempest-fastapi-sdk`\n * (`geo/enums.py`) — the on-the-wire value is the raw string.\n */\nexport type TravelMode = \"car\" | \"motorcycle\" | \"bus\";\n\n/**\n * Estimated travel between two coordinates. Mirrors the `TravelEstimate`\n * schema from `tempest-fastapi-sdk` (`geo/schemas.py`), snake_case preserved so\n * a response deserializes straight into this type.\n */\nexport interface TravelEstimate {\n    /** Travel mode the estimate was computed for. */\n    mode: TravelMode;\n    /** Great-circle distance scaled by circuity, in kilometers (`>= 0`). */\n    distance_km: number;\n    /** Estimated duration in minutes (`>= 0`). */\n    duration_minutes: number;\n    /** How the estimate was produced. `\"heuristic\"` (offline) or `\"osrm\"`. */\n    source: \"heuristic\" | \"osrm\";\n}\n\n/**\n * Axis-aligned geographic bounding box. `min`/`max` follow the same degree\n * ranges as {@link Coordinate}.\n */\nexport interface GeoBounds {\n    minLatitude: number;\n    maxLatitude: number;\n    minLongitude: number;\n    maxLongitude: number;\n}\n\n/** True when `value` is a finite latitude in `[-90, 90]`. */\nexport function isValidLatitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -90 && value <= 90;\n}\n\n/** True when `value` is a finite longitude in `[-180, 180]`. */\nexport function isValidLongitude(value: number): boolean {\n    return Number.isFinite(value) && value >= -180 && value <= 180;\n}\n\n/**\n * Type guard for {@link Coordinate}: an object with finite, in-range\n * `latitude` and `longitude`.\n */\nexport function isCoordinate(value: unknown): value is Coordinate {\n    if (typeof value !== \"object\" || value === null) return false;\n    const candidate = value as Record<string, unknown>;\n    return (\n        typeof candidate.latitude === \"number\" &&\n        typeof candidate.longitude === \"number\" &&\n        isValidLatitude(candidate.latitude) &&\n        isValidLongitude(candidate.longitude)\n    );\n}\n\n/** Clamp a latitude into the valid `[-90, 90]` range. */\nexport function clampLatitude(latitude: number): number {\n    return Math.min(90, Math.max(-90, latitude));\n}\n\n/**\n * Normalize a longitude into the `[-180, 180]` range, wrapping values that\n * cross the antimeridian (e.g. `190` → `-170`).\n */\nexport function normalizeLongitude(longitude: number): number {\n    const wrapped = ((((longitude + 180) % 360) + 360) % 360) - 180;\n    return wrapped;\n}\n"],"mappings":";AA0EA,SAAgBA,EAAgB,GAAwB;CACpD,OAAO,OAAO,SAASC,CAAK,KAAKA,KAAS,OAAOA,KAAS;AAC9D;AAGA,SAAgBC,EAAiB,GAAwB;CACrD,OAAO,OAAO,SAASD,CAAK,KAAKA,KAAS,QAAQA,KAAS;AAC/D;AAMA,SAAgBE,EAAa,GAAqC;CAC9D,IAAI,OAAOF,KAAU,aAAYA,GAAgB,OAAO;CACxD,IAAMG,IAAYH;CAClB,OACI,OAAOG,EAAU,YAAa,YAC9B,OAAOA,EAAU,aAAc,YAC/BJ,EAAgBI,EAAU,QAAQ,KAClCF,EAAiBE,EAAU,SAAS;AAE5C;AAGA,SAAgBC,EAAc,GAA0B;CACpD,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI,KAAKC,CAAQ,CAAC;AAC/C;AAMA,SAAgBC,EAAmB,GAA2B;CAE1D,SADoBC,IAAY,OAAO,MAAO,OAAO,MAAO;AAEhE"}

package/dist/geo/use-position-tracker.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-position-tracker.cjs","names":[],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useLatestRef(onError);\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":"iHAsDA,SAAgB,EACZ,EAAqC,CAAC,EACd,CACxB,GAAM,CAAE,YAAY,GAAO,UAAS,GAAG,GAAmB,EAEpD,CAAC,EAAQ,IAAA,EAAa,EAAA,SAAA,CAAgC,CAAC,CAAC,EACxD,CAAC,EAAY,IAAA,EAAiB,EAAA,SAAA,CAAiB,CAAC,EAChD,CAAC,EAAQ,IAAA,EAAa,EAAA,SAAA,CAAwB,MAAM,EAEpD,GAAA,EAAa,EAAA,OAAA,CAA+B,IAAI,EAChD,EAAa,EAAA,aAAa,CAAO,GAEvC,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAM,EAAU,EAAA,sBAAsB,CAClC,GAAG,EACH,SAAW,GAAS,CAChB,EAAU,CAAC,GAAG,CAAI,CAAC,EACnB,EAAc,EAAQ,UAAU,CACpC,EACA,eAAgB,EAChB,QAAU,GAAU,EAAW,UAAU,CAAK,CAClD,CAAC,EAID,MAHA,GAAW,QAAU,EACjB,GAAW,EAAQ,MAAM,MAEhB,CACT,EAAQ,KAAK,EACb,EAAW,QAAU,IACzB,CAIJ,EAAG,CAAC,CAAC,EAEL,IAAM,GAAA,EAAQ,EAAA,YAAA,KAAwB,EAAW,SAAS,MAAM,EAAG,CAAC,CAAC,EAC/D,GAAA,EAAO,EAAA,YAAA,KAAwB,EAAW,SAAS,KAAK,EAAG,CAAC,CAAC,EAC7D,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAClC,EAAW,SAAS,MAAM,EAC1B,EAAc,CAAC,CACnB,EAAG,CAAC,CAAC,EAEL,MAAO,CACH,SACA,UAAW,EAAO,OAAS,EAAI,EAAO,EAAO,OAAS,GAAK,KAC3D,aACA,SACA,WAAY,IAAW,WACvB,QACA,OACA,OACJ,CACJ"}
+{"version":3,"file":"use-position-tracker.cjs","names":["useState","useRef","useLatestRef","createPositionTracker","useCallback","require_use_latest_ref","require_create_position_tracker","react","usePositionTracker","trackerOptions","options","points","setPoints","distanceKm","setDistanceKm","status","setStatus","trackerRef","onErrorRef","onError","tracker","next","error","autoStart","start","stop","clear"],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useLatestRef(onError);\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":"A,iHAsDA,SAAgBQ,EACZ,EAAqC,CAAC,EACd,CACxB,GAAM,CAAE,YAAY,GAAO,UAAS,GAAGC,GAAmBC,EAEpD,CAACC,EAAQC,IAAA,EAAaZ,EAAAA,SAAAA,CAAgC,CAAC,CAAC,EACxD,CAACa,EAAYC,IAAA,EAAiBd,EAAAA,SAAAA,CAAiB,CAAC,EAChD,CAACe,EAAQC,IAAA,EAAahB,EAAAA,SAAAA,CAAwB,MAAM,EAEpDiB,GAAA,EAAahB,EAAAA,OAAAA,CAA+B,IAAI,EAChDiB,EAAahB,EAAAA,aAAaiB,CAAO,GAEvC,EAAAZ,EAAA,UAAA,KAAgB,CACZ,IAAMa,EAAUjB,EAAAA,sBAAsB,CAClC,GAAGM,EACH,SAAW,GAAS,CAChBG,EAAU,CAAC,GAAGS,CAAI,CAAC,EACnBP,EAAcM,EAAQ,UAAU,CACpC,EACA,eAAgBJ,EAChB,QAAU,GAAUE,EAAW,UAAUI,CAAK,CAClD,CAAC,EAID,MAHA,GAAW,QAAUF,EACjBG,GAAWH,EAAQ,MAAM,MAEhB,CACTA,EAAQ,KAAK,EACb,EAAW,QAAU,IACzB,CAIJ,EAAG,CAAC,CAAC,EAEL,IAAMI,GAAA,EAAQpB,EAAAA,YAAAA,KAAwBa,EAAW,SAAS,MAAM,EAAG,CAAC,CAAC,EAC/DQ,GAAA,EAAOrB,EAAAA,YAAAA,KAAwBa,EAAW,SAAS,KAAK,EAAG,CAAC,CAAC,EAC7DS,GAAA,EAAQtB,EAAAA,YAAAA,KAAwB,CAClCa,EAAW,SAAS,MAAM,EAC1BH,EAAc,CAAC,CACnB,EAAG,CAAC,CAAC,EAEL,MAAO,CACH,SACA,UAAWH,EAAO,OAAS,EAAIA,EAAOA,EAAO,OAAS,GAAK,KAC3D,aACA,SACA,WAAYI,IAAW,WACvB,QACA,OACA,OACJ,CACJ,C"}

package/dist/geo/use-position-tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-position-tracker.js","names":[],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useLatestRef(onError);\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":";;;;AAsDA,SAAgB,EACZ,IAAqC,CAAC,GACd;CACxB,IAAM,EAAE,eAAY,IAAO,YAAS,GAAG,MAAmB,GAEpD,CAAC,GAAQ,KAAa,EAAgC,CAAC,CAAC,GACxD,CAAC,GAAY,KAAiB,EAAiB,CAAC,GAChD,CAAC,GAAQ,KAAa,EAAwB,MAAM,GAEpD,IAAa,EAA+B,IAAI,GAChD,IAAa,EAAa,CAAO;CAEvC,QAAgB;EACZ,IAAM,IAAU,EAAsB;GAClC,GAAG;GACH,WAAW,MAAS;IAEhB,AADA,EAAU,CAAC,GAAG,CAAI,CAAC,GACnB,EAAc,EAAQ,UAAU;GACpC;GACA,gBAAgB;GAChB,UAAU,MAAU,EAAW,UAAU,CAAK;EAClD,CAAC;EAID,OAHA,EAAW,UAAU,GACjB,KAAW,EAAQ,MAAM,SAEhB;GAET,AADA,EAAQ,KAAK,GACb,EAAW,UAAU;EACzB;CAIJ,GAAG,CAAC,CAAC;CAEL,IAAM,IAAQ,QAAwB,EAAW,SAAS,MAAM,GAAG,CAAC,CAAC,GAC/D,IAAO,QAAwB,EAAW,SAAS,KAAK,GAAG,CAAC,CAAC,GAC7D,IAAQ,QAAwB;EAElC,AADA,EAAW,SAAS,MAAM,GAC1B,EAAc,CAAC;CACnB,GAAG,CAAC,CAAC;CAEL,OAAO;EACH;EACA,WAAW,EAAO,SAAS,IAAI,EAAO,EAAO,SAAS,KAAK;EAC3D;EACA;EACA,YAAY,MAAW;EACvB;EACA;EACA;CACJ;AACJ"}
+{"version":3,"file":"use-position-tracker.js","names":["usePositionTracker","trackerOptions","options","points","setPoints","useState","distanceKm","setDistanceKm","status","setStatus","trackerRef","useRef","onErrorRef","useLatestRef","onError","tracker","createPositionTracker","next","error","autoStart","start","useCallback","stop","clear"],"sources":["../../src/geo/use-position-tracker.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createPositionTracker,\n    type CreatePositionTrackerOptions,\n    type PositionTracker,\n    type TrackerStatus,\n} from \"./create-position-tracker\";\nimport type { TrackPoint } from \"./types\";\n\nexport interface UsePositionTrackerOptions extends Omit<\n    CreatePositionTrackerOptions,\n    \"onUpdate\" | \"onStatusChange\"\n> {\n    /** Start tracking automatically on mount. Default: `false`. */\n    autoStart?: boolean;\n}\n\nexport interface UsePositionTrackerResult {\n    /** Recorded trajectory (newest last). */\n    points: readonly TrackPoint[];\n    /** Most recent point, or `null` before the first fix. */\n    lastPoint: TrackPoint | null;\n    /** Total distance of the trajectory in kilometers. */\n    distanceKm: number;\n    /** Current tracker status. */\n    status: TrackerStatus;\n    /** True while `status === \"tracking\"`. */\n    isTracking: boolean;\n    /** Begin watching position. */\n    start: () => void;\n    /** Stop watching, keeping the trajectory. */\n    stop: () => void;\n    /** Stop and discard the trajectory. */\n    clear: () => void;\n}\n\n/**\n * React hook wrapping {@link createPositionTracker}. Records a live GPS\n * trajectory tied to the component lifecycle — the watch is torn down on\n * unmount. Fully browser-side; no external service.\n *\n * @example\n * const { points, distanceKm, isTracking, start, stop } = usePositionTracker({\n *   minDistanceKm: 0.01,\n * });\n * return (\n *   <>\n *     <button onClick={isTracking ? stop : start}>{isTracking ? \"Parar\" : \"Rastrear\"}</button>\n *     <TrajectoryMap points={points} />\n *     <span>{distanceKm.toFixed(2)} km</span>\n *   </>\n * );\n */\nexport function usePositionTracker(\n    options: UsePositionTrackerOptions = {},\n): UsePositionTrackerResult {\n    const { autoStart = false, onError, ...trackerOptions } = options;\n\n    const [points, setPoints] = useState<readonly TrackPoint[]>([]);\n    const [distanceKm, setDistanceKm] = useState<number>(0);\n    const [status, setStatus] = useState<TrackerStatus>(\"idle\");\n\n    const trackerRef = useRef<PositionTracker | null>(null);\n    const onErrorRef = useLatestRef(onError);\n\n    useEffect(() => {\n        const tracker = createPositionTracker({\n            ...trackerOptions,\n            onUpdate: (next) => {\n                setPoints([...next]);\n                setDistanceKm(tracker.distanceKm);\n            },\n            onStatusChange: setStatus,\n            onError: (error) => onErrorRef.current?.(error),\n        });\n        trackerRef.current = tracker;\n        if (autoStart) tracker.start();\n\n        return () => {\n            tracker.stop();\n            trackerRef.current = null;\n        };\n        // Tracker options are read once at creation; changing them mid-track\n        // would drop the recorded trajectory, so they are intentionally omitted.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, []);\n\n    const start = useCallback((): void => trackerRef.current?.start(), []);\n    const stop = useCallback((): void => trackerRef.current?.stop(), []);\n    const clear = useCallback((): void => {\n        trackerRef.current?.clear();\n        setDistanceKm(0);\n    }, []);\n\n    return {\n        points,\n        lastPoint: points.length > 0 ? points[points.length - 1] : null,\n        distanceKm,\n        status,\n        isTracking: status === \"tracking\",\n        start,\n        stop,\n        clear,\n    };\n}\n"],"mappings":";;;;AAsDA,SAAgBA,EACZ,IAAqC,CAAC,GACd;CACxB,IAAM,EAAE,eAAY,IAAO,YAAS,GAAGC,MAAmBC,GAEpD,CAACC,GAAQC,KAAaC,EAAgC,CAAC,CAAC,GACxD,CAACC,GAAYC,KAAiBF,EAAiB,CAAC,GAChD,CAACG,GAAQC,KAAaJ,EAAwB,MAAM,GAEpDK,IAAaC,EAA+B,IAAI,GAChDC,IAAaC,EAAaC,CAAO;CAEvC,QAAgB;EACZ,IAAMC,IAAUC,EAAsB;GAClC,GAAGf;GACH,WAAW,MAAS;IAEhB,AADAG,EAAU,CAAC,GAAGa,CAAI,CAAC,GACnBV,EAAcQ,EAAQ,UAAU;GACpC;GACA,gBAAgBN;GAChB,UAAU,MAAUG,EAAW,UAAUM,CAAK;EAClD,CAAC;EAID,OAHA,EAAW,UAAUH,GACjBI,KAAWJ,EAAQ,MAAM,SAEhB;GAET,AADAA,EAAQ,KAAK,GACb,EAAW,UAAU;EACzB;CAIJ,GAAG,CAAC,CAAC;CAEL,IAAMK,IAAQC,QAAwBX,EAAW,SAAS,MAAM,GAAG,CAAC,CAAC,GAC/DY,IAAOD,QAAwBX,EAAW,SAAS,KAAK,GAAG,CAAC,CAAC,GAC7Da,IAAQF,QAAwB;EAElC,AADAX,EAAW,SAAS,MAAM,GAC1BH,EAAc,CAAC;CACnB,GAAG,CAAC,CAAC;CAEL,OAAO;EACH;EACA,WAAWJ,EAAO,SAAS,IAAIA,EAAOA,EAAO,SAAS,KAAK;EAC3D;EACA;EACA,YAAYK,MAAW;EACvB;EACA;EACA;CACJ;AACJ"}

package/dist/hooks/pwa-env.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"pwa-env.cjs","names":[],"sources":["../../src/hooks/pwa-env.ts"],"sourcesContent":["/**\n * The Chromium-only `beforeinstallprompt` event. iOS Safari never fires it —\n * for those users the app falls back to manual \"Add to Home Screen\"\n * instructions. Ported into the SDK so consumers get the type without a global\n * augmentation.\n */\nexport interface BeforeInstallPromptEvent extends Event {\n    /** Platforms the prompt can target (e.g. `[\"web\", \"android\"]`). */\n    readonly platforms: readonly string[];\n    /** Resolves once the user accepts or dismisses the prompt. */\n    readonly userChoice: Promise<{\n        outcome: \"accepted\" | \"dismissed\";\n        platform: string;\n    }>;\n    /** Shows the native install prompt. */\n    prompt: () => Promise<void>;\n}\n\n/**\n * Detects iOS / iPadOS Safari, including modern iPads that report `MacIntel`\n * plus multi-touch instead of an `iPad` user agent.\n *\n * @returns `true` when running on iOS/iPadOS.\n */\nexport function isIOS(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (/iPad|iPhone|iPod/.test(ua)) return true;\n    return ua.includes(\"Mac\") && navigator.maxTouchPoints > 1;\n}\n\n/**\n * Detects Android browsers that ship a Chromium fork with the\n * `beforeinstallprompt` event stripped or unreliable. Those users must install\n * via the browser menu manually, identical to iOS Safari.\n *\n * @returns `true` when running on such an Android browser.\n */\nexport function isAndroidWithoutPromptApi(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (!/Android/i.test(ua)) return false;\n    return /MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(ua);\n}\n\n/**\n * Detects any Android browser.\n *\n * @returns `true` when the user agent reports Android.\n */\nexport function isAndroid(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    return /Android/i.test(navigator.userAgent);\n}\n\n/**\n * Builds an `intent://` URL that re-opens the current page inside Chrome on\n * Android. When Chrome is missing, the fallback URL points to the Play Store so\n * the user can still recover. Returns `null` outside Android.\n *\n * @returns The `intent://` URL, or `null` when not on Android or without a DOM.\n * @see https://developer.chrome.com/docs/multidevice/android/intents\n */\nexport function buildOpenInChromeIntent(): string | null {\n    if (typeof window === \"undefined\") return null;\n    if (!isAndroid()) return null;\n    const host = window.location.host;\n    const path = window.location.pathname + window.location.search;\n    const fallback = encodeURIComponent(\n        \"https://play.google.com/store/apps/details?id=com.android.chrome\",\n    );\n    return `intent://${host}${path}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${fallback};end`;\n}\n\n/**\n * Reports whether the app is running as an installed PWA (Android Chrome, iOS,\n * or desktop). Use it to suppress install CTAs once the user is already in the\n * standalone shell.\n *\n * @returns `true` when the display mode is standalone or iOS reports standalone.\n */\nexport function isStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    if (window.matchMedia?.(\"(display-mode: standalone)\")?.matches) return true;\n    return (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n}\n"],"mappings":"AAwBA,SAAgB,GAAiB,CAC7B,GAAI,OAAO,UAAc,IAAa,MAAO,GAC7C,IAAM,EAAK,UAAU,UAErB,MADI,mBAAmB,KAAK,CAAE,EAAU,GACjC,EAAG,SAAS,KAAK,GAAK,UAAU,eAAiB,CAC5D,CASA,SAAgB,GAAqC,CACjD,GAAI,OAAO,UAAc,IAAa,MAAO,GAC7C,IAAM,EAAK,UAAU,UAErB,MADK,WAAW,KAAK,CAAE,EAChB,+DAA+D,KAAK,CAAE,EAD5C,EAErC,CAOA,SAAgB,GAAqB,CAEjC,OADI,OAAO,UAAc,IAAoB,GACtC,WAAW,KAAK,UAAU,SAAS,CAC9C,CAUA,SAAgB,GAAyC,CAQrD,OAPI,OAAO,OAAW,KAClB,CAAC,EAAU,EAAU,KAMlB,YALM,OAAO,SAAS,OAChB,OAAO,SAAS,SAAW,OAAO,SAAS,OAIzB,4JACnC,CASA,SAAgB,GAAwB,CAGpC,OAFI,OAAO,OAAW,IAAoB,GACtC,OAAO,aAAa,4BAA4B,CAAC,EAAE,QAAgB,GAC/D,OAAO,UAAmD,aAAe,EACrF"}
+{"version":3,"file":"pwa-env.cjs","names":["isIOS","ua","isAndroidWithoutPromptApi","isAndroid","buildOpenInChromeIntent","isStandalone"],"sources":["../../src/hooks/pwa-env.ts"],"sourcesContent":["/**\n * The Chromium-only `beforeinstallprompt` event. iOS Safari never fires it —\n * for those users the app falls back to manual \"Add to Home Screen\"\n * instructions. Ported into the SDK so consumers get the type without a global\n * augmentation.\n */\nexport interface BeforeInstallPromptEvent extends Event {\n    /** Platforms the prompt can target (e.g. `[\"web\", \"android\"]`). */\n    readonly platforms: readonly string[];\n    /** Resolves once the user accepts or dismisses the prompt. */\n    readonly userChoice: Promise<{\n        outcome: \"accepted\" | \"dismissed\";\n        platform: string;\n    }>;\n    /** Shows the native install prompt. */\n    prompt: () => Promise<void>;\n}\n\n/**\n * Detects iOS / iPadOS Safari, including modern iPads that report `MacIntel`\n * plus multi-touch instead of an `iPad` user agent.\n *\n * @returns `true` when running on iOS/iPadOS.\n */\nexport function isIOS(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (/iPad|iPhone|iPod/.test(ua)) return true;\n    return ua.includes(\"Mac\") && navigator.maxTouchPoints > 1;\n}\n\n/**\n * Detects Android browsers that ship a Chromium fork with the\n * `beforeinstallprompt` event stripped or unreliable. Those users must install\n * via the browser menu manually, identical to iOS Safari.\n *\n * @returns `true` when running on such an Android browser.\n */\nexport function isAndroidWithoutPromptApi(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (!/Android/i.test(ua)) return false;\n    return /MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(ua);\n}\n\n/**\n * Detects any Android browser.\n *\n * @returns `true` when the user agent reports Android.\n */\nexport function isAndroid(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    return /Android/i.test(navigator.userAgent);\n}\n\n/**\n * Builds an `intent://` URL that re-opens the current page inside Chrome on\n * Android. When Chrome is missing, the fallback URL points to the Play Store so\n * the user can still recover. Returns `null` outside Android.\n *\n * @returns The `intent://` URL, or `null` when not on Android or without a DOM.\n * @see https://developer.chrome.com/docs/multidevice/android/intents\n */\nexport function buildOpenInChromeIntent(): string | null {\n    if (typeof window === \"undefined\") return null;\n    if (!isAndroid()) return null;\n    const host = window.location.host;\n    const path = window.location.pathname + window.location.search;\n    const fallback = encodeURIComponent(\n        \"https://play.google.com/store/apps/details?id=com.android.chrome\",\n    );\n    return `intent://${host}${path}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${fallback};end`;\n}\n\n/**\n * Reports whether the app is running as an installed PWA (Android Chrome, iOS,\n * or desktop). Use it to suppress install CTAs once the user is already in the\n * standalone shell.\n *\n * @returns `true` when the display mode is standalone or iOS reports standalone.\n */\nexport function isStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    if (window.matchMedia?.(\"(display-mode: standalone)\")?.matches) return true;\n    return (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n}\n"],"mappings":"AAwBA,SAAgBA,GAAiB,CAC7B,GAAI,OAAO,UAAc,IAAa,MAAO,GAC7C,IAAMC,EAAK,UAAU,UAErB,MADI,mBAAmB,KAAKA,CAAE,EAAU,GACjCA,EAAG,SAAS,KAAK,GAAK,UAAU,eAAiB,CAC5D,CASA,SAAgBC,GAAqC,CACjD,GAAI,OAAO,UAAc,IAAa,MAAO,GAC7C,IAAMD,EAAK,UAAU,UAErB,MADK,WAAW,KAAKA,CAAE,EAChB,+DAA+D,KAAKA,CAAE,EAD5C,EAErC,CAOA,SAAgBE,GAAqB,CAEjC,OADI,OAAO,UAAc,IAAoB,GACtC,WAAW,KAAK,UAAU,SAAS,CAC9C,CAUA,SAAgBC,GAAyC,CAQrD,OAPI,OAAO,OAAW,KAClB,CAACD,EAAU,EAAU,KAMlB,YALM,OAAO,SAAS,OAChB,OAAO,SAAS,SAAW,OAAO,SAAS,OAIzB,4JACnC,CASA,SAAgBE,GAAwB,CAGpC,OAFI,OAAO,OAAW,IAAoB,GACtC,OAAO,aAAa,4BAA4B,CAAC,EAAE,QAAgB,GAC/D,OAAO,UAAmD,aAAe,EACrF,C"}

package/dist/hooks/pwa-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"pwa-env.js","names":[],"sources":["../../src/hooks/pwa-env.ts"],"sourcesContent":["/**\n * The Chromium-only `beforeinstallprompt` event. iOS Safari never fires it —\n * for those users the app falls back to manual \"Add to Home Screen\"\n * instructions. Ported into the SDK so consumers get the type without a global\n * augmentation.\n */\nexport interface BeforeInstallPromptEvent extends Event {\n    /** Platforms the prompt can target (e.g. `[\"web\", \"android\"]`). */\n    readonly platforms: readonly string[];\n    /** Resolves once the user accepts or dismisses the prompt. */\n    readonly userChoice: Promise<{\n        outcome: \"accepted\" | \"dismissed\";\n        platform: string;\n    }>;\n    /** Shows the native install prompt. */\n    prompt: () => Promise<void>;\n}\n\n/**\n * Detects iOS / iPadOS Safari, including modern iPads that report `MacIntel`\n * plus multi-touch instead of an `iPad` user agent.\n *\n * @returns `true` when running on iOS/iPadOS.\n */\nexport function isIOS(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (/iPad|iPhone|iPod/.test(ua)) return true;\n    return ua.includes(\"Mac\") && navigator.maxTouchPoints > 1;\n}\n\n/**\n * Detects Android browsers that ship a Chromium fork with the\n * `beforeinstallprompt` event stripped or unreliable. Those users must install\n * via the browser menu manually, identical to iOS Safari.\n *\n * @returns `true` when running on such an Android browser.\n */\nexport function isAndroidWithoutPromptApi(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (!/Android/i.test(ua)) return false;\n    return /MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(ua);\n}\n\n/**\n * Detects any Android browser.\n *\n * @returns `true` when the user agent reports Android.\n */\nexport function isAndroid(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    return /Android/i.test(navigator.userAgent);\n}\n\n/**\n * Builds an `intent://` URL that re-opens the current page inside Chrome on\n * Android. When Chrome is missing, the fallback URL points to the Play Store so\n * the user can still recover. Returns `null` outside Android.\n *\n * @returns The `intent://` URL, or `null` when not on Android or without a DOM.\n * @see https://developer.chrome.com/docs/multidevice/android/intents\n */\nexport function buildOpenInChromeIntent(): string | null {\n    if (typeof window === \"undefined\") return null;\n    if (!isAndroid()) return null;\n    const host = window.location.host;\n    const path = window.location.pathname + window.location.search;\n    const fallback = encodeURIComponent(\n        \"https://play.google.com/store/apps/details?id=com.android.chrome\",\n    );\n    return `intent://${host}${path}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${fallback};end`;\n}\n\n/**\n * Reports whether the app is running as an installed PWA (Android Chrome, iOS,\n * or desktop). Use it to suppress install CTAs once the user is already in the\n * standalone shell.\n *\n * @returns `true` when the display mode is standalone or iOS reports standalone.\n */\nexport function isStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    if (window.matchMedia?.(\"(display-mode: standalone)\")?.matches) return true;\n    return (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n}\n"],"mappings":";AAwBA,SAAgB,IAAiB;CAC7B,IAAI,OAAO,YAAc,KAAa,OAAO;CAC7C,IAAM,IAAK,UAAU;CAErB,OADI,mBAAmB,KAAK,CAAE,IAAU,KACjC,EAAG,SAAS,KAAK,KAAK,UAAU,iBAAiB;AAC5D;AASA,SAAgB,IAAqC;CACjD,IAAI,OAAO,YAAc,KAAa,OAAO;CAC7C,IAAM,IAAK,UAAU;CAErB,OADK,WAAW,KAAK,CAAE,IAChB,+DAA+D,KAAK,CAAE,IAD5C;AAErC;AAOA,SAAgB,IAAqB;CAEjC,OADI,OAAO,YAAc,MAAoB,KACtC,WAAW,KAAK,UAAU,SAAS;AAC9C;AAUA,SAAgB,IAAyC;CAQrD,OAPI,OAAO,SAAW,OAClB,CAAC,EAAU,IAAU,OAMlB,YALM,OAAO,SAAS,OAChB,OAAO,SAAS,WAAW,OAAO,SAAS,OAIzB;AACnC;AASA,SAAgB,IAAwB;CAGpC,OAFI,OAAO,SAAW,MAAoB,KACtC,OAAO,aAAa,4BAA4B,CAAC,EAAE,UAAgB,KAC/D,OAAO,UAAmD,eAAe;AACrF"}
+{"version":3,"file":"pwa-env.js","names":["isIOS","ua","isAndroidWithoutPromptApi","isAndroid","buildOpenInChromeIntent","isStandalone"],"sources":["../../src/hooks/pwa-env.ts"],"sourcesContent":["/**\n * The Chromium-only `beforeinstallprompt` event. iOS Safari never fires it —\n * for those users the app falls back to manual \"Add to Home Screen\"\n * instructions. Ported into the SDK so consumers get the type without a global\n * augmentation.\n */\nexport interface BeforeInstallPromptEvent extends Event {\n    /** Platforms the prompt can target (e.g. `[\"web\", \"android\"]`). */\n    readonly platforms: readonly string[];\n    /** Resolves once the user accepts or dismisses the prompt. */\n    readonly userChoice: Promise<{\n        outcome: \"accepted\" | \"dismissed\";\n        platform: string;\n    }>;\n    /** Shows the native install prompt. */\n    prompt: () => Promise<void>;\n}\n\n/**\n * Detects iOS / iPadOS Safari, including modern iPads that report `MacIntel`\n * plus multi-touch instead of an `iPad` user agent.\n *\n * @returns `true` when running on iOS/iPadOS.\n */\nexport function isIOS(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (/iPad|iPhone|iPod/.test(ua)) return true;\n    return ua.includes(\"Mac\") && navigator.maxTouchPoints > 1;\n}\n\n/**\n * Detects Android browsers that ship a Chromium fork with the\n * `beforeinstallprompt` event stripped or unreliable. Those users must install\n * via the browser menu manually, identical to iOS Safari.\n *\n * @returns `true` when running on such an Android browser.\n */\nexport function isAndroidWithoutPromptApi(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    const ua = navigator.userAgent;\n    if (!/Android/i.test(ua)) return false;\n    return /MiuiBrowser|XiaoMi|UCBrowser|Opera Mini|KAIOS|HuaweiBrowser/i.test(ua);\n}\n\n/**\n * Detects any Android browser.\n *\n * @returns `true` when the user agent reports Android.\n */\nexport function isAndroid(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n    return /Android/i.test(navigator.userAgent);\n}\n\n/**\n * Builds an `intent://` URL that re-opens the current page inside Chrome on\n * Android. When Chrome is missing, the fallback URL points to the Play Store so\n * the user can still recover. Returns `null` outside Android.\n *\n * @returns The `intent://` URL, or `null` when not on Android or without a DOM.\n * @see https://developer.chrome.com/docs/multidevice/android/intents\n */\nexport function buildOpenInChromeIntent(): string | null {\n    if (typeof window === \"undefined\") return null;\n    if (!isAndroid()) return null;\n    const host = window.location.host;\n    const path = window.location.pathname + window.location.search;\n    const fallback = encodeURIComponent(\n        \"https://play.google.com/store/apps/details?id=com.android.chrome\",\n    );\n    return `intent://${host}${path}#Intent;scheme=https;package=com.android.chrome;S.browser_fallback_url=${fallback};end`;\n}\n\n/**\n * Reports whether the app is running as an installed PWA (Android Chrome, iOS,\n * or desktop). Use it to suppress install CTAs once the user is already in the\n * standalone shell.\n *\n * @returns `true` when the display mode is standalone or iOS reports standalone.\n */\nexport function isStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    if (window.matchMedia?.(\"(display-mode: standalone)\")?.matches) return true;\n    return (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n}\n"],"mappings":";AAwBA,SAAgBA,IAAiB;CAC7B,IAAI,OAAO,YAAc,KAAa,OAAO;CAC7C,IAAMC,IAAK,UAAU;CAErB,OADI,mBAAmB,KAAKA,CAAE,IAAU,KACjCA,EAAG,SAAS,KAAK,KAAK,UAAU,iBAAiB;AAC5D;AASA,SAAgBC,IAAqC;CACjD,IAAI,OAAO,YAAc,KAAa,OAAO;CAC7C,IAAMD,IAAK,UAAU;CAErB,OADK,WAAW,KAAKA,CAAE,IAChB,+DAA+D,KAAKA,CAAE,IAD5C;AAErC;AAOA,SAAgBE,IAAqB;CAEjC,OADI,OAAO,YAAc,MAAoB,KACtC,WAAW,KAAK,UAAU,SAAS;AAC9C;AAUA,SAAgBC,IAAyC;CAQrD,OAPI,OAAO,SAAW,OAClB,CAACD,EAAU,IAAU,OAMlB,YALM,OAAO,SAAS,OAChB,OAAO,SAAS,WAAW,OAAO,SAAS,OAIzB;AACnC;AASA,SAAgBE,IAAwB;CAGpC,OAFI,OAAO,SAAW,MAAoB,KACtC,OAAO,aAAa,4BAA4B,CAAC,EAAE,UAAgB,KAC/D,OAAO,UAAmD,eAAe;AACrF"}

package/dist/hooks/tab-sequence.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tab-sequence.cjs","names":[],"sources":["../../src/hooks/tab-sequence.ts"],"sourcesContent":["/** Elements that can take keyboard focus — shared by the focus trap and the portal tab order. */\nexport const FOCUSABLE_SELECTOR = [\n    \"a[href]\",\n    \"button:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/** A portalled panel and the element of the page it was opened from. */\nexport interface PortalLayer {\n    /** Wrapper of the trigger — the spot in the page the panel belongs to. */\n    anchor: HTMLElement;\n    /** The panel, mounted at the end of `body`. */\n    panel: HTMLElement;\n}\n\nconst layers = new Set<PortalLayer>();\n\n/**\n * Declare a portalled panel as belonging to the spot of its anchor.\n *\n * A portal takes the panel out of the subtree it was opened from, so a focus\n * trap around that subtree would see the panel as \"outside\" and pull focus away\n * from it. Registered layers are what {@link tabSequence} and\n * {@link tabRegion} splice back in.\n *\n * @param layer - The anchor and the panel.\n * @returns A function that removes the registration.\n */\nexport function registerPortalLayer(layer: PortalLayer): () => void {\n    layers.add(layer);\n    return () => {\n        layers.delete(layer);\n    };\n}\n\n/**\n * The elements `Tab` can stop on inside `root`, in document order.\n *\n * @param root - Where to look.\n * @returns The tabbable descendants that are not disabled, hidden or removed\n * from the tab order.\n */\nexport function tabbables(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter((el) => {\n        if (el.tabIndex < 0 || el.hasAttribute(\"aria-hidden\")) return false;\n        const style = window.getComputedStyle(el);\n        return style.display !== \"none\" && style.visibility !== \"hidden\";\n    });\n}\n\n/**\n * Split the layers into those opened from inside `root` and the rest.\n *\n * @param root - The subtree the layers are matched against.\n * @param pending - The layers not yet assigned to a subtree.\n * @returns The layers whose anchor lives in `root` (and whose panel does not),\n * and the remaining ones.\n */\nfunction ownedBy(\n    root: HTMLElement,\n    pending: PortalLayer[],\n): { owned: PortalLayer[]; rest: PortalLayer[] } {\n    const owned = pending.filter(\n        (layer) => root.contains(layer.anchor) && !root.contains(layer.panel),\n    );\n    return { owned, rest: pending.filter((layer) => !owned.includes(layer)) };\n}\n\n/**\n * Every subtree focus may sit in while `root` is trapped: `root` itself plus the\n * panels opened from it, transitively (a popover opened from a popover).\n *\n * @param root - The trapped container.\n * @returns `root` followed by the panels that belong to it.\n */\nexport function tabRegion(root: HTMLElement): HTMLElement[] {\n    const region: HTMLElement[] = [root];\n    let pending = [...layers];\n    for (let index = 0; index < region.length; index += 1) {\n        const { owned, rest } = ownedBy(region[index]!, pending);\n        region.push(...owned.map((layer) => layer.panel));\n        pending = rest;\n    }\n    return region;\n}\n\n/**\n * The order `Tab` walks inside `root`, with each owned portalled panel spliced\n * right after the last stop of its anchor — where it would sit had it rendered\n * in flow. That is the same order `usePortalTabOrder` restores between the\n * trigger and the panel, so the trap wraps at the same ends the user walks.\n *\n * @param root - The trapped container.\n * @param pending - Layers not yet placed; defaults to every registered one.\n * @returns The tab stops of `root` and of its panels, in walking order.\n */\nexport function tabSequence(\n    root: HTMLElement,\n    pending: PortalLayer[] = [...layers],\n): HTMLElement[] {\n    const native = tabbables(root);\n    const { owned, rest } = ownedBy(root, pending);\n    const inserted = new Map<number, HTMLElement[]>();\n    for (const layer of owned) {\n        let at = -1;\n        native.forEach((el, index) => {\n            const precedes =\n                (el.compareDocumentPosition(layer.anchor) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0;\n            if (precedes || layer.anchor.contains(el)) at = index;\n        });\n        inserted.set(at, [...(inserted.get(at) ?? []), ...tabSequence(layer.panel, rest)]);\n    }\n    const sequence: HTMLElement[] = [...(inserted.get(-1) ?? [])];\n    native.forEach((el, index) => {\n        sequence.push(el, ...(inserted.get(index) ?? []));\n    });\n    return sequence;\n}\n"],"mappings":"AACA,IAAa,EAAqB,CAC9B,UACA,yBACA,2BACA,wBACA,yBACA,iCACJ,CAAC,CAAC,KAAK,GAAG,EAUJ,EAAS,IAAI,IAanB,SAAgB,EAAoB,EAAgC,CAEhE,OADA,EAAO,IAAI,CAAK,MACH,CACT,EAAO,OAAO,CAAK,CACvB,CACJ,CASA,SAAgB,EAAU,EAAiC,CACvD,OAAO,MAAM,KAAK,EAAK,iBAA8B,CAAkB,CAAC,CAAC,CAAC,OAAQ,GAAO,CACrF,GAAI,EAAG,SAAW,GAAK,EAAG,aAAa,aAAa,EAAG,MAAO,GAC9D,IAAM,EAAQ,OAAO,iBAAiB,CAAE,EACxC,OAAO,EAAM,UAAY,QAAU,EAAM,aAAe,QAC5D,CAAC,CACL,CAUA,SAAS,EACL,EACA,EAC6C,CAC7C,IAAM,EAAQ,EAAQ,OACjB,GAAU,EAAK,SAAS,EAAM,MAAM,GAAK,CAAC,EAAK,SAAS,EAAM,KAAK,CACxE,EACA,MAAO,CAAE,QAAO,KAAM,EAAQ,OAAQ,GAAU,CAAC,EAAM,SAAS,CAAK,CAAC,CAAE,CAC5E,CASA,SAAgB,EAAU,EAAkC,CACxD,IAAM,EAAwB,CAAC,CAAI,EAC/B,EAAU,CAAC,GAAG,CAAM,EACxB,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAO,OAAQ,GAAS,EAAG,CACnD,GAAM,CAAE,QAAO,QAAS,EAAQ,EAAO,GAAS,CAAO,EACvD,EAAO,KAAK,GAAG,EAAM,IAAK,GAAU,EAAM,KAAK,CAAC,EAChD,EAAU,CACd,CACA,OAAO,CACX,CAYA,SAAgB,EACZ,EACA,EAAyB,CAAC,GAAG,CAAM,EACtB,CACb,IAAM,EAAS,EAAU,CAAI,EACvB,CAAE,QAAO,QAAS,EAAQ,EAAM,CAAO,EACvC,EAAW,IAAI,IACrB,IAAK,IAAM,KAAS,EAAO,CACvB,IAAI,EAAK,GACT,EAAO,SAAS,EAAI,IAAU,GAErB,EAAG,wBAAwB,EAAM,MAAM,EAAI,KAAK,+BAAiC,GACtE,EAAM,OAAO,SAAS,CAAE,KAAG,EAAK,EACpD,CAAC,EACD,EAAS,IAAI,EAAI,CAAC,GAAI,EAAS,IAAI,CAAE,GAAK,CAAC,EAAI,GAAG,EAAY,EAAM,MAAO,CAAI,CAAC,CAAC,CACrF,CACA,IAAM,EAA0B,CAAC,GAAI,EAAS,IAAI,EAAE,GAAK,CAAC,CAAE,EAI5D,OAHA,EAAO,SAAS,EAAI,IAAU,CAC1B,EAAS,KAAK,EAAI,GAAI,EAAS,IAAI,CAAK,GAAK,CAAC,CAAE,CACpD,CAAC,EACM,CACX"}
+{"version":3,"file":"tab-sequence.cjs","names":["FOCUSABLE_SELECTOR","layers","registerPortalLayer","layer","tabbables","root","el","style","ownedBy","owned","pending","tabRegion","region","index","rest","tabSequence","native","inserted","at","sequence"],"sources":["../../src/hooks/tab-sequence.ts"],"sourcesContent":["/** Elements that can take keyboard focus — shared by the focus trap and the portal tab order. */\nexport const FOCUSABLE_SELECTOR = [\n    \"a[href]\",\n    \"button:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/** A portalled panel and the element of the page it was opened from. */\nexport interface PortalLayer {\n    /** Wrapper of the trigger — the spot in the page the panel belongs to. */\n    anchor: HTMLElement;\n    /** The panel, mounted at the end of `body`. */\n    panel: HTMLElement;\n}\n\nconst layers = new Set<PortalLayer>();\n\n/**\n * Declare a portalled panel as belonging to the spot of its anchor.\n *\n * A portal takes the panel out of the subtree it was opened from, so a focus\n * trap around that subtree would see the panel as \"outside\" and pull focus away\n * from it. Registered layers are what {@link tabSequence} and\n * {@link tabRegion} splice back in.\n *\n * @param layer - The anchor and the panel.\n * @returns A function that removes the registration.\n */\nexport function registerPortalLayer(layer: PortalLayer): () => void {\n    layers.add(layer);\n    return () => {\n        layers.delete(layer);\n    };\n}\n\n/**\n * The elements `Tab` can stop on inside `root`, in document order.\n *\n * @param root - Where to look.\n * @returns The tabbable descendants that are not disabled, hidden or removed\n * from the tab order.\n */\nexport function tabbables(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter((el) => {\n        if (el.tabIndex < 0 || el.hasAttribute(\"aria-hidden\")) return false;\n        const style = window.getComputedStyle(el);\n        return style.display !== \"none\" && style.visibility !== \"hidden\";\n    });\n}\n\n/**\n * Split the layers into those opened from inside `root` and the rest.\n *\n * @param root - The subtree the layers are matched against.\n * @param pending - The layers not yet assigned to a subtree.\n * @returns The layers whose anchor lives in `root` (and whose panel does not),\n * and the remaining ones.\n */\nfunction ownedBy(\n    root: HTMLElement,\n    pending: PortalLayer[],\n): { owned: PortalLayer[]; rest: PortalLayer[] } {\n    const owned = pending.filter(\n        (layer) => root.contains(layer.anchor) && !root.contains(layer.panel),\n    );\n    return { owned, rest: pending.filter((layer) => !owned.includes(layer)) };\n}\n\n/**\n * Every subtree focus may sit in while `root` is trapped: `root` itself plus the\n * panels opened from it, transitively (a popover opened from a popover).\n *\n * @param root - The trapped container.\n * @returns `root` followed by the panels that belong to it.\n */\nexport function tabRegion(root: HTMLElement): HTMLElement[] {\n    const region: HTMLElement[] = [root];\n    let pending = [...layers];\n    for (let index = 0; index < region.length; index += 1) {\n        const { owned, rest } = ownedBy(region[index]!, pending);\n        region.push(...owned.map((layer) => layer.panel));\n        pending = rest;\n    }\n    return region;\n}\n\n/**\n * The order `Tab` walks inside `root`, with each owned portalled panel spliced\n * right after the last stop of its anchor — where it would sit had it rendered\n * in flow. That is the same order `usePortalTabOrder` restores between the\n * trigger and the panel, so the trap wraps at the same ends the user walks.\n *\n * @param root - The trapped container.\n * @param pending - Layers not yet placed; defaults to every registered one.\n * @returns The tab stops of `root` and of its panels, in walking order.\n */\nexport function tabSequence(\n    root: HTMLElement,\n    pending: PortalLayer[] = [...layers],\n): HTMLElement[] {\n    const native = tabbables(root);\n    const { owned, rest } = ownedBy(root, pending);\n    const inserted = new Map<number, HTMLElement[]>();\n    for (const layer of owned) {\n        let at = -1;\n        native.forEach((el, index) => {\n            const precedes =\n                (el.compareDocumentPosition(layer.anchor) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0;\n            if (precedes || layer.anchor.contains(el)) at = index;\n        });\n        inserted.set(at, [...(inserted.get(at) ?? []), ...tabSequence(layer.panel, rest)]);\n    }\n    const sequence: HTMLElement[] = [...(inserted.get(-1) ?? [])];\n    native.forEach((el, index) => {\n        sequence.push(el, ...(inserted.get(index) ?? []));\n    });\n    return sequence;\n}\n"],"mappings":"AACA,IAAaA,EAAqB,CAC9B,UACA,yBACA,2BACA,wBACA,yBACA,iCACJ,CAAC,CAAC,KAAK,GAAG,EAUJC,EAAS,IAAI,IAanB,SAAgBC,EAAoB,EAAgC,CAEhE,OADAD,EAAO,IAAIE,CAAK,MACH,CACTF,EAAO,OAAOE,CAAK,CACvB,CACJ,CASA,SAAgBC,EAAU,EAAiC,CACvD,OAAO,MAAM,KAAKC,EAAK,iBAA8BL,CAAkB,CAAC,CAAC,CAAC,OAAQ,GAAO,CACrF,GAAIM,EAAG,SAAW,GAAKA,EAAG,aAAa,aAAa,EAAG,MAAO,GAC9D,IAAMC,EAAQ,OAAO,iBAAiBD,CAAE,EACxC,OAAOC,EAAM,UAAY,QAAUA,EAAM,aAAe,QAC5D,CAAC,CACL,CAUA,SAASC,EACL,EACA,EAC6C,CAC7C,IAAMC,EAAQC,EAAQ,OACjB,GAAUL,EAAK,SAASF,EAAM,MAAM,GAAK,CAACE,EAAK,SAASF,EAAM,KAAK,CACxE,EACA,MAAO,CAAE,QAAO,KAAMO,EAAQ,OAAQ,GAAU,CAACD,EAAM,SAASN,CAAK,CAAC,CAAE,CAC5E,CASA,SAAgBQ,EAAU,EAAkC,CACxD,IAAMC,EAAwB,CAACP,CAAI,EAC/BK,EAAU,CAAC,GAAGT,CAAM,EACxB,IAAK,IAAIY,EAAQ,EAAGA,EAAQD,EAAO,OAAQ,GAAS,EAAG,CACnD,GAAM,CAAE,QAAO,QAASJ,EAAQI,EAAOC,GAASH,CAAO,EACvDE,EAAO,KAAK,GAAGH,EAAM,IAAK,GAAUN,EAAM,KAAK,CAAC,EAChD,EAAUW,CACd,CACA,OAAOF,CACX,CAYA,SAAgBG,EACZ,EACA,EAAyB,CAAC,GAAGd,CAAM,EACtB,CACb,IAAMe,EAASZ,EAAUC,CAAI,EACvB,CAAE,QAAO,QAASG,EAAQH,EAAMK,CAAO,EACvCO,EAAW,IAAI,IACrB,IAAK,IAAMd,KAASM,EAAO,CACvB,IAAIS,EAAK,GACTF,EAAO,SAAS,EAAI,IAAU,GAErBV,EAAG,wBAAwBH,EAAM,MAAM,EAAI,KAAK,+BAAiC,GACtEA,EAAM,OAAO,SAASG,CAAE,KAAG,EAAKO,EACpD,CAAC,EACDI,EAAS,IAAIC,EAAI,CAAC,GAAID,EAAS,IAAIC,CAAE,GAAK,CAAC,EAAI,GAAGH,EAAYZ,EAAM,MAAOW,CAAI,CAAC,CAAC,CACrF,CACA,IAAMK,EAA0B,CAAC,GAAIF,EAAS,IAAI,EAAE,GAAK,CAAC,CAAE,EAI5D,OAHAD,EAAO,SAAS,EAAI,IAAU,CAC1BG,EAAS,KAAKb,EAAI,GAAIW,EAAS,IAAIJ,CAAK,GAAK,CAAC,CAAE,CACpD,CAAC,EACMM,CACX,C"}

package/dist/hooks/tab-sequence.js.map

@@ -1 +1 @@
-{"version":3,"file":"tab-sequence.js","names":[],"sources":["../../src/hooks/tab-sequence.ts"],"sourcesContent":["/** Elements that can take keyboard focus — shared by the focus trap and the portal tab order. */\nexport const FOCUSABLE_SELECTOR = [\n    \"a[href]\",\n    \"button:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/** A portalled panel and the element of the page it was opened from. */\nexport interface PortalLayer {\n    /** Wrapper of the trigger — the spot in the page the panel belongs to. */\n    anchor: HTMLElement;\n    /** The panel, mounted at the end of `body`. */\n    panel: HTMLElement;\n}\n\nconst layers = new Set<PortalLayer>();\n\n/**\n * Declare a portalled panel as belonging to the spot of its anchor.\n *\n * A portal takes the panel out of the subtree it was opened from, so a focus\n * trap around that subtree would see the panel as \"outside\" and pull focus away\n * from it. Registered layers are what {@link tabSequence} and\n * {@link tabRegion} splice back in.\n *\n * @param layer - The anchor and the panel.\n * @returns A function that removes the registration.\n */\nexport function registerPortalLayer(layer: PortalLayer): () => void {\n    layers.add(layer);\n    return () => {\n        layers.delete(layer);\n    };\n}\n\n/**\n * The elements `Tab` can stop on inside `root`, in document order.\n *\n * @param root - Where to look.\n * @returns The tabbable descendants that are not disabled, hidden or removed\n * from the tab order.\n */\nexport function tabbables(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter((el) => {\n        if (el.tabIndex < 0 || el.hasAttribute(\"aria-hidden\")) return false;\n        const style = window.getComputedStyle(el);\n        return style.display !== \"none\" && style.visibility !== \"hidden\";\n    });\n}\n\n/**\n * Split the layers into those opened from inside `root` and the rest.\n *\n * @param root - The subtree the layers are matched against.\n * @param pending - The layers not yet assigned to a subtree.\n * @returns The layers whose anchor lives in `root` (and whose panel does not),\n * and the remaining ones.\n */\nfunction ownedBy(\n    root: HTMLElement,\n    pending: PortalLayer[],\n): { owned: PortalLayer[]; rest: PortalLayer[] } {\n    const owned = pending.filter(\n        (layer) => root.contains(layer.anchor) && !root.contains(layer.panel),\n    );\n    return { owned, rest: pending.filter((layer) => !owned.includes(layer)) };\n}\n\n/**\n * Every subtree focus may sit in while `root` is trapped: `root` itself plus the\n * panels opened from it, transitively (a popover opened from a popover).\n *\n * @param root - The trapped container.\n * @returns `root` followed by the panels that belong to it.\n */\nexport function tabRegion(root: HTMLElement): HTMLElement[] {\n    const region: HTMLElement[] = [root];\n    let pending = [...layers];\n    for (let index = 0; index < region.length; index += 1) {\n        const { owned, rest } = ownedBy(region[index]!, pending);\n        region.push(...owned.map((layer) => layer.panel));\n        pending = rest;\n    }\n    return region;\n}\n\n/**\n * The order `Tab` walks inside `root`, with each owned portalled panel spliced\n * right after the last stop of its anchor — where it would sit had it rendered\n * in flow. That is the same order `usePortalTabOrder` restores between the\n * trigger and the panel, so the trap wraps at the same ends the user walks.\n *\n * @param root - The trapped container.\n * @param pending - Layers not yet placed; defaults to every registered one.\n * @returns The tab stops of `root` and of its panels, in walking order.\n */\nexport function tabSequence(\n    root: HTMLElement,\n    pending: PortalLayer[] = [...layers],\n): HTMLElement[] {\n    const native = tabbables(root);\n    const { owned, rest } = ownedBy(root, pending);\n    const inserted = new Map<number, HTMLElement[]>();\n    for (const layer of owned) {\n        let at = -1;\n        native.forEach((el, index) => {\n            const precedes =\n                (el.compareDocumentPosition(layer.anchor) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0;\n            if (precedes || layer.anchor.contains(el)) at = index;\n        });\n        inserted.set(at, [...(inserted.get(at) ?? []), ...tabSequence(layer.panel, rest)]);\n    }\n    const sequence: HTMLElement[] = [...(inserted.get(-1) ?? [])];\n    native.forEach((el, index) => {\n        sequence.push(el, ...(inserted.get(index) ?? []));\n    });\n    return sequence;\n}\n"],"mappings":";AACA,IAAa,IAAqB;CAC9B;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC,CAAC,KAAK,GAAG,GAUJ,oBAAS,IAAI,IAAiB;AAapC,SAAgB,EAAoB,GAAgC;CAEhE,OADA,EAAO,IAAI,CAAK,SACH;EACT,EAAO,OAAO,CAAK;CACvB;AACJ;AASA,SAAgB,EAAU,GAAiC;CACvD,OAAO,MAAM,KAAK,EAAK,iBAA8B,CAAkB,CAAC,CAAC,CAAC,QAAQ,MAAO;EACrF,IAAI,EAAG,WAAW,KAAK,EAAG,aAAa,aAAa,GAAG,OAAO;EAC9D,IAAM,IAAQ,OAAO,iBAAiB,CAAE;EACxC,OAAO,EAAM,YAAY,UAAU,EAAM,eAAe;CAC5D,CAAC;AACL;AAUA,SAAS,EACL,GACA,GAC6C;CAC7C,IAAM,IAAQ,EAAQ,QACjB,MAAU,EAAK,SAAS,EAAM,MAAM,KAAK,CAAC,EAAK,SAAS,EAAM,KAAK,CACxE;CACA,OAAO;EAAE;EAAO,MAAM,EAAQ,QAAQ,MAAU,CAAC,EAAM,SAAS,CAAK,CAAC;CAAE;AAC5E;AASA,SAAgB,EAAU,GAAkC;CACxD,IAAM,IAAwB,CAAC,CAAI,GAC/B,IAAU,CAAC,GAAG,CAAM;CACxB,KAAK,IAAI,IAAQ,GAAG,IAAQ,EAAO,QAAQ,KAAS,GAAG;EACnD,IAAM,EAAE,UAAO,YAAS,EAAQ,EAAO,IAAS,CAAO;EAEvD,AADA,EAAO,KAAK,GAAG,EAAM,KAAK,MAAU,EAAM,KAAK,CAAC,GAChD,IAAU;CACd;CACA,OAAO;AACX;AAYA,SAAgB,EACZ,GACA,IAAyB,CAAC,GAAG,CAAM,GACtB;CACb,IAAM,IAAS,EAAU,CAAI,GACvB,EAAE,UAAO,YAAS,EAAQ,GAAM,CAAO,GACvC,oBAAW,IAAI,IAA2B;CAChD,KAAK,IAAM,KAAS,GAAO;EACvB,IAAI,IAAK;EAMT,AALA,EAAO,SAAS,GAAI,MAAU;GAG1B,EADK,EAAG,wBAAwB,EAAM,MAAM,IAAI,KAAK,iCAAiC,KACtE,EAAM,OAAO,SAAS,CAAE,OAAG,IAAK;EACpD,CAAC,GACD,EAAS,IAAI,GAAI,CAAC,GAAI,EAAS,IAAI,CAAE,KAAK,CAAC,GAAI,GAAG,EAAY,EAAM,OAAO,CAAI,CAAC,CAAC;CACrF;CACA,IAAM,IAA0B,CAAC,GAAI,EAAS,IAAI,EAAE,KAAK,CAAC,CAAE;CAI5D,OAHA,EAAO,SAAS,GAAI,MAAU;EAC1B,EAAS,KAAK,GAAI,GAAI,EAAS,IAAI,CAAK,KAAK,CAAC,CAAE;CACpD,CAAC,GACM;AACX"}
+{"version":3,"file":"tab-sequence.js","names":["FOCUSABLE_SELECTOR","layers","registerPortalLayer","layer","tabbables","root","el","style","ownedBy","owned","pending","tabRegion","region","index","rest","tabSequence","native","inserted","at","sequence"],"sources":["../../src/hooks/tab-sequence.ts"],"sourcesContent":["/** Elements that can take keyboard focus — shared by the focus trap and the portal tab order. */\nexport const FOCUSABLE_SELECTOR = [\n    \"a[href]\",\n    \"button:not([disabled])\",\n    \"textarea:not([disabled])\",\n    \"input:not([disabled])\",\n    \"select:not([disabled])\",\n    \"[tabindex]:not([tabindex='-1'])\",\n].join(\",\");\n\n/** A portalled panel and the element of the page it was opened from. */\nexport interface PortalLayer {\n    /** Wrapper of the trigger — the spot in the page the panel belongs to. */\n    anchor: HTMLElement;\n    /** The panel, mounted at the end of `body`. */\n    panel: HTMLElement;\n}\n\nconst layers = new Set<PortalLayer>();\n\n/**\n * Declare a portalled panel as belonging to the spot of its anchor.\n *\n * A portal takes the panel out of the subtree it was opened from, so a focus\n * trap around that subtree would see the panel as \"outside\" and pull focus away\n * from it. Registered layers are what {@link tabSequence} and\n * {@link tabRegion} splice back in.\n *\n * @param layer - The anchor and the panel.\n * @returns A function that removes the registration.\n */\nexport function registerPortalLayer(layer: PortalLayer): () => void {\n    layers.add(layer);\n    return () => {\n        layers.delete(layer);\n    };\n}\n\n/**\n * The elements `Tab` can stop on inside `root`, in document order.\n *\n * @param root - Where to look.\n * @returns The tabbable descendants that are not disabled, hidden or removed\n * from the tab order.\n */\nexport function tabbables(root: ParentNode): HTMLElement[] {\n    return Array.from(root.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR)).filter((el) => {\n        if (el.tabIndex < 0 || el.hasAttribute(\"aria-hidden\")) return false;\n        const style = window.getComputedStyle(el);\n        return style.display !== \"none\" && style.visibility !== \"hidden\";\n    });\n}\n\n/**\n * Split the layers into those opened from inside `root` and the rest.\n *\n * @param root - The subtree the layers are matched against.\n * @param pending - The layers not yet assigned to a subtree.\n * @returns The layers whose anchor lives in `root` (and whose panel does not),\n * and the remaining ones.\n */\nfunction ownedBy(\n    root: HTMLElement,\n    pending: PortalLayer[],\n): { owned: PortalLayer[]; rest: PortalLayer[] } {\n    const owned = pending.filter(\n        (layer) => root.contains(layer.anchor) && !root.contains(layer.panel),\n    );\n    return { owned, rest: pending.filter((layer) => !owned.includes(layer)) };\n}\n\n/**\n * Every subtree focus may sit in while `root` is trapped: `root` itself plus the\n * panels opened from it, transitively (a popover opened from a popover).\n *\n * @param root - The trapped container.\n * @returns `root` followed by the panels that belong to it.\n */\nexport function tabRegion(root: HTMLElement): HTMLElement[] {\n    const region: HTMLElement[] = [root];\n    let pending = [...layers];\n    for (let index = 0; index < region.length; index += 1) {\n        const { owned, rest } = ownedBy(region[index]!, pending);\n        region.push(...owned.map((layer) => layer.panel));\n        pending = rest;\n    }\n    return region;\n}\n\n/**\n * The order `Tab` walks inside `root`, with each owned portalled panel spliced\n * right after the last stop of its anchor — where it would sit had it rendered\n * in flow. That is the same order `usePortalTabOrder` restores between the\n * trigger and the panel, so the trap wraps at the same ends the user walks.\n *\n * @param root - The trapped container.\n * @param pending - Layers not yet placed; defaults to every registered one.\n * @returns The tab stops of `root` and of its panels, in walking order.\n */\nexport function tabSequence(\n    root: HTMLElement,\n    pending: PortalLayer[] = [...layers],\n): HTMLElement[] {\n    const native = tabbables(root);\n    const { owned, rest } = ownedBy(root, pending);\n    const inserted = new Map<number, HTMLElement[]>();\n    for (const layer of owned) {\n        let at = -1;\n        native.forEach((el, index) => {\n            const precedes =\n                (el.compareDocumentPosition(layer.anchor) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0;\n            if (precedes || layer.anchor.contains(el)) at = index;\n        });\n        inserted.set(at, [...(inserted.get(at) ?? []), ...tabSequence(layer.panel, rest)]);\n    }\n    const sequence: HTMLElement[] = [...(inserted.get(-1) ?? [])];\n    native.forEach((el, index) => {\n        sequence.push(el, ...(inserted.get(index) ?? []));\n    });\n    return sequence;\n}\n"],"mappings":";AACA,IAAaA,IAAqB;CAC9B;CACA;CACA;CACA;CACA;CACA;AACJ,CAAC,CAAC,KAAK,GAAG,GAUJC,oBAAS,IAAI,IAAiB;AAapC,SAAgBC,EAAoB,GAAgC;CAEhE,OADAD,EAAO,IAAIE,CAAK,SACH;EACT,EAAO,OAAOA,CAAK;CACvB;AACJ;AASA,SAAgBC,EAAU,GAAiC;CACvD,OAAO,MAAM,KAAKC,EAAK,iBAA8BL,CAAkB,CAAC,CAAC,CAAC,QAAQ,MAAO;EACrF,IAAIM,EAAG,WAAW,KAAKA,EAAG,aAAa,aAAa,GAAG,OAAO;EAC9D,IAAMC,IAAQ,OAAO,iBAAiBD,CAAE;EACxC,OAAOC,EAAM,YAAY,UAAUA,EAAM,eAAe;CAC5D,CAAC;AACL;AAUA,SAASC,EACL,GACA,GAC6C;CAC7C,IAAMC,IAAQC,EAAQ,QACjB,MAAUL,EAAK,SAASF,EAAM,MAAM,KAAK,CAACE,EAAK,SAASF,EAAM,KAAK,CACxE;CACA,OAAO;EAAE;EAAO,MAAMO,EAAQ,QAAQ,MAAU,CAACD,EAAM,SAASN,CAAK,CAAC;CAAE;AAC5E;AASA,SAAgBQ,EAAU,GAAkC;CACxD,IAAMC,IAAwB,CAACP,CAAI,GAC/BK,IAAU,CAAC,GAAGT,CAAM;CACxB,KAAK,IAAIY,IAAQ,GAAGA,IAAQD,EAAO,QAAQ,KAAS,GAAG;EACnD,IAAM,EAAE,UAAO,YAASJ,EAAQI,EAAOC,IAASH,CAAO;EAEvD,AADAE,EAAO,KAAK,GAAGH,EAAM,KAAK,MAAUN,EAAM,KAAK,CAAC,GAChD,IAAUW;CACd;CACA,OAAOF;AACX;AAYA,SAAgBG,EACZ,GACA,IAAyB,CAAC,GAAGd,CAAM,GACtB;CACb,IAAMe,IAASZ,EAAUC,CAAI,GACvB,EAAE,UAAO,YAASG,EAAQH,GAAMK,CAAO,GACvCO,oBAAW,IAAI,IAA2B;CAChD,KAAK,IAAMd,KAASM,GAAO;EACvB,IAAIS,IAAK;EAMT,AALAF,EAAO,SAAS,GAAI,MAAU;GAG1B,EADKV,EAAG,wBAAwBH,EAAM,MAAM,IAAI,KAAK,iCAAiC,KACtEA,EAAM,OAAO,SAASG,CAAE,OAAG,IAAKO;EACpD,CAAC,GACDI,EAAS,IAAIC,GAAI,CAAC,GAAID,EAAS,IAAIC,CAAE,KAAK,CAAC,GAAI,GAAGH,EAAYZ,EAAM,OAAOW,CAAI,CAAC,CAAC;CACrF;CACA,IAAMK,IAA0B,CAAC,GAAIF,EAAS,IAAI,EAAE,KAAK,CAAC,CAAE;CAI5D,OAHAD,EAAO,SAAS,GAAI,MAAU;EAC1B,EAAS,KAAKV,GAAI,GAAIW,EAAS,IAAIJ,CAAK,KAAK,CAAC,CAAE;CACpD,CAAC,GACMM;AACX"}

package/dist/hooks/use-announce.cjs

@@ -1,2 +1,2 @@
-let e=require("react");var t=7e3,n={position:`absolute`,width:`1px`,height:`1px`,margin:`-1px`,padding:`0`,border:`0`,overflow:`hidden`,clip:`rect(0 0 0 0)`,clipPath:`inset(50%)`,whiteSpace:`nowrap`},r=null,i=new Set;function a(e){let t=document.createElement(`div`);return e===`polite`&&t.setAttribute(`role`,`status`),t.setAttribute(`aria-live`,e),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(`data-tempest-announcer`,e),Object.assign(t.style,n),document.body.appendChild(t),t}function o(){return typeof document>`u`?null:r&&r.polite.isConnected&&r.assertive.isConnected?r:(r?.polite.remove(),r?.assertive.remove(),r={polite:a(`polite`),assertive:a(`assertive`)},r)}function s(e,n=`polite`){if(!e)return;let r=o();if(!r)return;let a=n===`assertive`?r.assertive:r.polite;a.replaceChildren();let s=document.createElement(`div`);s.textContent=e,a.appendChild(s);let c=setTimeout(()=>{i.delete(c),s.isConnected&&s.remove()},t);i.add(c)}function c(){for(let e of i)clearTimeout(e);i.clear(),r?.polite.remove(),r?.assertive.remove(),r=null}function l(){return(0,e.useEffect)(()=>{o()},[]),(0,e.useCallback)((e,t=`polite`)=>s(e,t),[])}exports.announce=s,exports.clearAnnouncer=c,exports.useAnnounce=l;
+let e=require("react");var t=7e3,n={position:`absolute`,width:`1px`,height:`1px`,margin:`-1px`,padding:`0`,border:`0`,overflow:`hidden`,clip:`rect(0 0 0 0)`,clipPath:`inset(50%)`,whiteSpace:`nowrap`},r=null,i=new Set;function a(e){let t=document.createElement(`div`);return e===`polite`&&t.setAttribute(`role`,`status`),t.setAttribute(`aria-live`,e),t.setAttribute(`aria-atomic`,`true`),t.setAttribute(`data-tempest-announcer`,e),Object.assign(t.style,n),document.body.appendChild(t),t}function o(){return typeof document>`u`?null:(r&&r.polite.isConnected&&r.assertive.isConnected||(r?.polite.remove(),r?.assertive.remove(),r={polite:a(`polite`),assertive:a(`assertive`)}),r)}function s(e,n=`polite`){if(!e)return;let r=o();if(!r)return;let a=n===`assertive`?r.assertive:r.polite;a.replaceChildren();let s=document.createElement(`div`);s.textContent=e,a.appendChild(s);let c=setTimeout(()=>{i.delete(c),s.isConnected&&s.remove()},t);i.add(c)}function c(){for(let e of i)clearTimeout(e);i.clear(),r?.polite.remove(),r?.assertive.remove(),r=null}function l(){return(0,e.useEffect)(()=>{o()},[]),(0,e.useCallback)((e,t=`polite`)=>s(e,t),[])}exports.announce=s,exports.clearAnnouncer=c,exports.useAnnounce=l;
 //# sourceMappingURL=use-announce.cjs.map

package/dist/hooks/use-announce.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-announce.cjs","names":[],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":"uBAaA,IAAM,EAAiB,IAUjB,EAA6C,CAC/C,SAAU,WACV,MAAO,MACP,OAAQ,MACR,OAAQ,OACR,QAAS,IACT,OAAQ,IACR,SAAU,SACV,KAAM,gBACN,SAAU,aACV,WAAY,QAChB,EAOI,EAA0B,KACxB,EAAS,IAAI,IAgBnB,SAAS,EAAa,EAA6C,CAC/D,IAAM,EAAO,SAAS,cAAc,KAAK,EAOzC,OANI,IAAe,UAAU,EAAK,aAAa,OAAQ,QAAQ,EAC/D,EAAK,aAAa,YAAa,CAAU,EACzC,EAAK,aAAa,cAAe,MAAM,EACvC,EAAK,aAAa,yBAA0B,CAAU,EACtD,OAAO,OAAO,EAAK,MAAO,CAAY,EACtC,SAAS,KAAK,YAAY,CAAI,EACvB,CACX,CAsBA,SAAS,GAAgC,CAMrC,OALI,OAAO,SAAa,IAAoB,KACxC,GAAW,EAAQ,OAAO,aAAe,EAAQ,UAAU,YAAoB,GACnF,GAAS,OAAO,OAAO,EACvB,GAAS,UAAU,OAAO,EAC1B,EAAU,CAAE,OAAQ,EAAa,QAAQ,EAAG,UAAW,EAAa,WAAW,CAAE,EAC1E,EACX,CAsBA,SAAgB,EAAS,EAAiB,EAAiC,SAAgB,CACvF,GAAI,CAAC,EAAS,OACd,IAAM,EAAO,EAAc,EAC3B,GAAI,CAAC,EAAM,OAEX,IAAM,EAAS,IAAe,YAAc,EAAK,UAAY,EAAK,OAClE,EAAO,gBAAgB,EACvB,IAAM,EAAO,SAAS,cAAc,KAAK,EACzC,EAAK,YAAc,EACnB,EAAO,YAAY,CAAI,EAEvB,IAAM,EAAQ,eAAiB,CAC3B,EAAO,OAAO,CAAK,EACf,EAAK,aAAa,EAAK,OAAO,CACtC,EAAG,CAAc,EACjB,EAAO,IAAI,CAAK,CACpB,CASA,SAAgB,GAAuB,CACnC,IAAK,IAAM,KAAS,EAAQ,aAAa,CAAK,EAC9C,EAAO,MAAM,EACb,GAAS,OAAO,OAAO,EACvB,GAAS,UAAU,OAAO,EAC1B,EAAU,IACd,CAgCA,SAAgB,GAA0E,CAKtF,OAJA,EAAA,EAAA,UAAA,KAAgB,CACZ,EAAc,CAClB,EAAG,CAAC,CAAC,GAEL,EAAO,EAAA,YAAA,EACF,EAAiB,EAAiC,WAC/C,EAAS,EAAS,CAAU,EAChC,CAAC,CACL,CACJ"}
+{"version":3,"file":"use-announce.cjs","names":["useCallback","react","CLEAR_AFTER_MS","HIDDEN_STYLE","regions","timers","createRegion","node","politeness","ensureRegions","announce","message","pair","region","item","timer","clearAnnouncer","useAnnounce"],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":"A,uBAaA,IAAME,EAAiB,IAUjBC,EAA6C,CAC/C,SAAU,WACV,MAAO,MACP,OAAQ,MACR,OAAQ,OACR,QAAS,IACT,OAAQ,IACR,SAAU,SACV,KAAM,gBACN,SAAU,aACV,WAAY,QAChB,EAOIC,EAA0B,KACxBC,EAAS,IAAI,IAgBnB,SAASC,EAAa,EAA6C,CAC/D,IAAMC,EAAO,SAAS,cAAc,KAAK,EAOzC,OANIC,IAAe,UAAUD,EAAK,aAAa,OAAQ,QAAQ,EAC/DA,EAAK,aAAa,YAAaC,CAAU,EACzCD,EAAK,aAAa,cAAe,MAAM,EACvCA,EAAK,aAAa,yBAA0BC,CAAU,EACtD,OAAO,OAAOD,EAAK,MAAOJ,CAAY,EACtC,SAAS,KAAK,YAAYI,CAAI,EACvBA,CACX,CAsBA,SAASE,GAAgC,CAMrC,OALI,OAAO,SAAa,IAAoB,MACxCL,GAAWA,EAAQ,OAAO,aAAeA,EAAQ,UAAU,cAC/DA,GAAS,OAAO,OAAO,EACvBA,GAAS,UAAU,OAAO,EAC1B,EAAU,CAAE,OAAQE,EAAa,QAAQ,EAAG,UAAWA,EAAa,WAAW,CAAE,GAC1EF,EACX,CAsBA,SAAgBM,EAAS,EAAiB,EAAiC,SAAgB,CACvF,GAAI,CAACC,EAAS,OACd,IAAMC,EAAOH,EAAc,EAC3B,GAAI,CAACG,EAAM,OAEX,IAAMC,EAASL,IAAe,YAAcI,EAAK,UAAYA,EAAK,OAClEC,EAAO,gBAAgB,EACvB,IAAMC,EAAO,SAAS,cAAc,KAAK,EACzC,EAAK,YAAcH,EACnBE,EAAO,YAAYC,CAAI,EAEvB,IAAMC,EAAQ,eAAiB,CAC3BV,EAAO,OAAOU,CAAK,EACfD,EAAK,aAAaA,EAAK,OAAO,CACtC,EAAGZ,CAAc,EACjBG,EAAO,IAAIU,CAAK,CACpB,CASA,SAAgBC,GAAuB,CACnC,IAAK,IAAMD,KAASV,EAAQ,aAAaU,CAAK,EAC9CV,EAAO,MAAM,EACbD,GAAS,OAAO,OAAO,EACvBA,GAAS,UAAU,OAAO,EAC1B,EAAU,IACd,CAgCA,SAAgBa,GAA0E,CAKtF,OAJA,EAAAhB,EAAA,UAAA,KAAgB,CACZQ,EAAc,CAClB,EAAG,CAAC,CAAC,GAEL,EAAOT,EAAAA,YAAAA,EACF,EAAiB,EAAiC,WAC/CU,EAASC,EAASH,CAAU,EAChC,CAAC,CACL,CACJ,C"}

package/dist/hooks/use-announce.js

@@ -17,10 +17,10 @@ function o(e) {
 	return e === "polite" && t.setAttribute("role", "status"), t.setAttribute("aria-live", e), t.setAttribute("aria-atomic", "true"), t.setAttribute("data-tempest-announcer", e), Object.assign(t.style, r), document.body.appendChild(t), t;
 }
 function s() {
-	return typeof document > "u" ? null : i && i.polite.isConnected && i.assertive.isConnected ? i : (i?.polite.remove(), i?.assertive.remove(), i = {
+	return typeof document > "u" ? null : (i && i.polite.isConnected && i.assertive.isConnected || (i?.polite.remove(), i?.assertive.remove(), i = {
 		polite: o("polite"),
 		assertive: o("assertive")
-	}, i);
+	}), i);
 }
 function c(e, t = "polite") {
 	if (!e) return;

package/dist/hooks/use-announce.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-announce.js","names":[],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":";;AAaA,IAAM,IAAiB,KAUjB,IAA6C;CAC/C,UAAU;CACV,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,UAAU;CACV,MAAM;CACN,UAAU;CACV,YAAY;AAChB,GAOI,IAA0B,MACxB,oBAAS,IAAI,IAAmC;AAgBtD,SAAS,EAAa,GAA6C;CAC/D,IAAM,IAAO,SAAS,cAAc,KAAK;CAOzC,OANI,MAAe,YAAU,EAAK,aAAa,QAAQ,QAAQ,GAC/D,EAAK,aAAa,aAAa,CAAU,GACzC,EAAK,aAAa,eAAe,MAAM,GACvC,EAAK,aAAa,0BAA0B,CAAU,GACtD,OAAO,OAAO,EAAK,OAAO,CAAY,GACtC,SAAS,KAAK,YAAY,CAAI,GACvB;AACX;AAsBA,SAAS,IAAgC;CAMrC,OALI,OAAO,WAAa,MAAoB,OACxC,KAAW,EAAQ,OAAO,eAAe,EAAQ,UAAU,cAAoB,KACnF,GAAS,OAAO,OAAO,GACvB,GAAS,UAAU,OAAO,GAC1B,IAAU;EAAE,QAAQ,EAAa,QAAQ;EAAG,WAAW,EAAa,WAAW;CAAE,GAC1E;AACX;AAsBA,SAAgB,EAAS,GAAiB,IAAiC,UAAgB;CACvF,IAAI,CAAC,GAAS;CACd,IAAM,IAAO,EAAc;CAC3B,IAAI,CAAC,GAAM;CAEX,IAAM,IAAS,MAAe,cAAc,EAAK,YAAY,EAAK;CAClE,EAAO,gBAAgB;CACvB,IAAM,IAAO,SAAS,cAAc,KAAK;CAEzC,AADA,EAAK,cAAc,GACnB,EAAO,YAAY,CAAI;CAEvB,IAAM,IAAQ,iBAAiB;EAE3B,AADA,EAAO,OAAO,CAAK,GACf,EAAK,eAAa,EAAK,OAAO;CACtC,GAAG,CAAc;CACjB,EAAO,IAAI,CAAK;AACpB;AASA,SAAgB,IAAuB;CACnC,KAAK,IAAM,KAAS,GAAQ,aAAa,CAAK;CAI9C,AAHA,EAAO,MAAM,GACb,GAAS,OAAO,OAAO,GACvB,GAAS,UAAU,OAAO,GAC1B,IAAU;AACd;AAgCA,SAAgB,IAA0E;CAKtF,OAJA,QAAgB;EACZ,EAAc;CAClB,GAAG,CAAC,CAAC,GAEE,GACF,GAAiB,IAAiC,aAC/C,EAAS,GAAS,CAAU,GAChC,CAAC,CACL;AACJ"}
+{"version":3,"file":"use-announce.js","names":["CLEAR_AFTER_MS","HIDDEN_STYLE","regions","timers","createRegion","node","politeness","ensureRegions","announce","message","pair","region","item","timer","clearAnnouncer","useAnnounce","useEffect","useCallback"],"sources":["../../src/hooks/use-announce.ts"],"sourcesContent":["import { useCallback, useEffect } from \"react\";\n\n/**\n * How urgently a screen reader should interrupt.\n *\n * `\"polite\"` waits for a pause in what is being read. `\"assertive\"` cuts in\n * immediately, which is right for an error the user must act on and wrong for\n * everything else — an assertive announcement can truncate the sentence the user\n * was in the middle of.\n */\nexport type AnnouncePoliteness = \"polite\" | \"assertive\";\n\n/** How long an announcement stays in the DOM before it is cleaned up. */\nconst CLEAR_AFTER_MS = 7_000;\n\n/**\n * Inline styles that hide an element visually while leaving it readable.\n *\n * Inline and not a CSS module on purpose: these nodes are created imperatively by\n * a hook, and a hook that only works when the app remembered to import\n * `tempest-react-sdk/styles.css` would drop two visible, unstyled paragraphs into\n * the page — a visual bug caused by an accessibility feature.\n */\nconst HIDDEN_STYLE: Partial<CSSStyleDeclaration> = {\n    position: \"absolute\",\n    width: \"1px\",\n    height: \"1px\",\n    margin: \"-1px\",\n    padding: \"0\",\n    border: \"0\",\n    overflow: \"hidden\",\n    clip: \"rect(0 0 0 0)\",\n    clipPath: \"inset(50%)\",\n    whiteSpace: \"nowrap\",\n};\n\ninterface Regions {\n    polite: HTMLElement;\n    assertive: HTMLElement;\n}\n\nlet regions: Regions | null = null;\nconst timers = new Set<ReturnType<typeof setTimeout>>();\n\n/**\n * Build one live region.\n *\n * The polite region carries `role=\"status\"`; the assertive one carries only\n * `aria-live=\"assertive\"`. `role=\"alert\"` is deliberately **not** used: these\n * regions live in the document for the page's whole life, and an empty element\n * claiming to be an alert is both a lie about its content and a trap for every\n * `getByRole(\"alert\")` in a consuming app's test suite, which would suddenly match\n * two nodes. A bare `aria-live` region is announced by every screen reader that\n * supports live regions at all.\n *\n * @param politeness - Which region to build.\n * @returns The region, already appended to `<body>`.\n */\nfunction createRegion(politeness: AnnouncePoliteness): HTMLElement {\n    const node = document.createElement(\"div\");\n    if (politeness === \"polite\") node.setAttribute(\"role\", \"status\");\n    node.setAttribute(\"aria-live\", politeness);\n    node.setAttribute(\"aria-atomic\", \"true\");\n    node.setAttribute(\"data-tempest-announcer\", politeness);\n    Object.assign(node.style, HIDDEN_STYLE);\n    document.body.appendChild(node);\n    return node;\n}\n\n/**\n * Get the two shared live regions, creating them on first use.\n *\n * **Two regions, not one with a switchable `aria-live`.** Politeness is a property\n * of the region, read when the assistive technology first registers it — flipping\n * the attribute later is honoured by some screen readers, ignored by others, and\n * in the worst case drops the announcement entirely. Two regions that never change\n * are the only version that behaves the same everywhere.\n *\n * **Shared, not one per component.** Every live region on the page is polled;\n * several of them mutating at once is how announcements get dropped or doubled.\n * One pair per document keeps the order deterministic.\n *\n * A pair is replaced as a **pair**, discarding the old one: if only one region was\n * torn out of the DOM (a router that replaced `<body>`, a micro-frontend unmount),\n * keeping its still-attached sibling would leave two regions of that politeness on\n * the page — the exact duplication the shared pair exists to prevent.\n *\n * @returns The polite and assertive regions, or `null` outside a document.\n */\nfunction ensureRegions(): Regions | null {\n    if (typeof document === \"undefined\") return null;\n    if (regions && regions.polite.isConnected && regions.assertive.isConnected) return regions;\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = { polite: createRegion(\"polite\"), assertive: createRegion(\"assertive\") };\n    return regions;\n}\n\n/**\n * Announce a message to screen readers, from anywhere — a hook, an event handler,\n * a plain function outside React.\n *\n * ## Why the same string announces twice\n *\n * Screen readers announce a live region when its **content changes**. Writing the\n * same text again is not a change, so \"Item removido\" twice in a row is read once —\n * the classic reason these announcers are quietly broken. Instead of mutating text,\n * every call replaces the region's child with a **new element**. The DOM mutation is\n * real even when the string is identical, so the second announcement happens, and\n * the reader hears the exact message with no padding characters bolted on.\n *\n * @param message - Text to read out. Empty strings are ignored.\n * @param politeness - `\"polite\"` (default) or `\"assertive\"`.\n *\n * @example\n * announce(`${count} pedidos encontrados`);\n * announce(\"Falha ao salvar\", \"assertive\");\n */\nexport function announce(message: string, politeness: AnnouncePoliteness = \"polite\"): void {\n    if (!message) return;\n    const pair = ensureRegions();\n    if (!pair) return;\n\n    const region = politeness === \"assertive\" ? pair.assertive : pair.polite;\n    region.replaceChildren();\n    const item = document.createElement(\"div\");\n    item.textContent = message;\n    region.appendChild(item);\n\n    const timer = setTimeout(() => {\n        timers.delete(timer);\n        if (item.isConnected) item.remove();\n    }, CLEAR_AFTER_MS);\n    timers.add(timer);\n}\n\n/**\n * Remove the shared regions and cancel pending cleanups.\n *\n * For test teardown and for a micro-frontend being unmounted from a page it does\n * not own. Regular apps never need it — two empty hidden `div`s cost nothing, and\n * tearing them down while another component still announces would lose messages.\n */\nexport function clearAnnouncer(): void {\n    for (const timer of timers) clearTimeout(timer);\n    timers.clear();\n    regions?.polite.remove();\n    regions?.assertive.remove();\n    regions = null;\n}\n\n/**\n * Announce transient messages to screen readers through one shared live region\n * pair.\n *\n * Reach for this when something happened that a sighted user can see and a screen\n * reader user cannot: a filter narrowed a list, a row saved, a copy succeeded, an\n * upload failed. It is **not** for content that is already on screen inside a\n * region with a role — a status pill, a toast that renders as `role=\"status\"`,\n * a form error tied to its input — announcing those again reads them twice.\n *\n * !!! warning \"Never wrap streaming text in a live region\"\n *     A live region over text that grows token by token makes the reader start the\n *     whole answer again on every token. Announce the **edges** instead — \"gerando\n *     resposta\" and \"resposta concluída\" — and leave the transcript in a plain\n *     `role=\"log\"` the user reads at their own pace. `AIChat` does exactly that.\n *\n * Mounting the hook creates the regions even before the first message. That is not\n * tidiness: a live region inserted into the DOM in the same frame as its first\n * content routinely loses that announcement, because the assistive technology has\n * to have registered the region before it can notice a change inside it.\n *\n * @returns A stable `announce(message, politeness?)` function.\n *\n * @example\n * const announce = useAnnounce();\n *\n * function onFilter(rows: Row[]) {\n *     announce(`${rows.length} resultados`);\n * }\n */\nexport function useAnnounce(): (message: string, politeness?: AnnouncePoliteness) => void {\n    useEffect(() => {\n        ensureRegions();\n    }, []);\n\n    return useCallback(\n        (message: string, politeness: AnnouncePoliteness = \"polite\") =>\n            announce(message, politeness),\n        [],\n    );\n}\n"],"mappings":";;AAaA,IAAMA,IAAiB,KAUjBC,IAA6C;CAC/C,UAAU;CACV,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,UAAU;CACV,MAAM;CACN,UAAU;CACV,YAAY;AAChB,GAOIC,IAA0B,MACxBC,oBAAS,IAAI,IAAmC;AAgBtD,SAASC,EAAa,GAA6C;CAC/D,IAAMC,IAAO,SAAS,cAAc,KAAK;CAOzC,OANIC,MAAe,YAAUD,EAAK,aAAa,QAAQ,QAAQ,GAC/DA,EAAK,aAAa,aAAaC,CAAU,GACzCD,EAAK,aAAa,eAAe,MAAM,GACvCA,EAAK,aAAa,0BAA0BC,CAAU,GACtD,OAAO,OAAOD,EAAK,OAAOJ,CAAY,GACtC,SAAS,KAAK,YAAYI,CAAI,GACvBA;AACX;AAsBA,SAASE,IAAgC;CAMrC,OALI,OAAO,WAAa,MAAoB,QACxCL,KAAWA,EAAQ,OAAO,eAAeA,EAAQ,UAAU,gBAC/DA,GAAS,OAAO,OAAO,GACvBA,GAAS,UAAU,OAAO,GAC1B,IAAU;EAAE,QAAQE,EAAa,QAAQ;EAAG,WAAWA,EAAa,WAAW;CAAE,IAC1EF;AACX;AAsBA,SAAgBM,EAAS,GAAiB,IAAiC,UAAgB;CACvF,IAAI,CAACC,GAAS;CACd,IAAMC,IAAOH,EAAc;CAC3B,IAAI,CAACG,GAAM;CAEX,IAAMC,IAASL,MAAe,cAAcI,EAAK,YAAYA,EAAK;CAClE,EAAO,gBAAgB;CACvB,IAAME,IAAO,SAAS,cAAc,KAAK;CAEzC,AADA,EAAK,cAAcH,GACnBE,EAAO,YAAYC,CAAI;CAEvB,IAAMC,IAAQ,iBAAiB;EAE3B,AADAV,EAAO,OAAOU,CAAK,GACfD,EAAK,eAAaA,EAAK,OAAO;CACtC,GAAGZ,CAAc;CACjB,EAAO,IAAIa,CAAK;AACpB;AASA,SAAgBC,IAAuB;CACnC,KAAK,IAAMD,KAASV,GAAQ,aAAaU,CAAK;CAI9C,AAHAV,EAAO,MAAM,GACbD,GAAS,OAAO,OAAO,GACvBA,GAAS,UAAU,OAAO,GAC1B,IAAU;AACd;AAgCA,SAAgBa,IAA0E;CAKtF,OAJAC,QAAgB;EACZ,EAAc;CAClB,GAAG,CAAC,CAAC,GAEEC,GACF,GAAiB,IAAiC,aAC/CT,EAASC,GAASH,CAAU,GAChC,CAAC,CACL;AACJ"}

package/dist/hooks/use-async.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-async.cjs","names":[],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":"+DA6BA,SAAgB,EACZ,EACA,EAA+B,CAAC,EAChC,EAAmC,CAAC,EACnB,CACjB,GAAM,CAAE,YAAY,IAAU,EACxB,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAIvB,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,EAElD,EAAQ,EAAA,aAAa,CAAO,EAC5B,GAAA,EAAY,EAAA,OAAA,CAAe,CAAC,EAC5B,GAAA,EAAa,EAAA,OAAA,CAAgB,EAAI,GAEvC,EAAA,EAAA,UAAA,MACI,EAAW,QAAU,OACR,CACT,EAAW,QAAU,EACzB,GACD,CAAC,CAAC,EAEL,IAAM,GAAA,EAAM,EAAA,YAAA,CAAY,SAAwB,CAC5C,IAAM,EAAS,EAAE,EAAU,QAC3B,EAAU,IAAa,CAAE,GAAG,EAAS,OAAQ,UAAW,MAAO,IAAA,EAAU,EAAE,EAC3E,GAAI,CACA,IAAM,EAAO,MAAM,EAAM,QAAQ,EAIjC,OAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,UAAW,OAAM,MAAO,IAAA,EAAU,CAAC,EAEnD,CACX,OAAS,EAAO,CAIZ,MAHI,EAAW,SAAW,EAAU,UAAY,GAC5C,EAAS,CAAE,OAAQ,QAAS,KAAM,IAAA,GAAW,OAAM,CAAC,EAElD,CACV,CACJ,EAAG,CAAC,CAAK,CAAC,EAEJ,GAAA,EAAQ,EAAA,YAAA,KAAwB,CAClC,EAAU,UACV,EAAS,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,CAClE,EAAG,CAAC,CAAC,EAUL,OARA,EAAA,EAAA,UAAA,KAAgB,CACP,GACL,EAAI,CAAC,CAAC,UAAY,CAElB,CAAC,CAEL,EAAG,CAAC,EAAW,GAAG,CAAI,CAAC,EAEhB,CACH,OAAQ,EAAM,OACd,KAAM,EAAM,KACZ,MAAO,EAAM,MACb,UAAW,EAAM,SAAW,UAC5B,UAAW,EAAM,SAAW,UAC5B,QAAS,EAAM,SAAW,QAC1B,MACA,OACJ,CACJ"}
+{"version":3,"file":"use-async.cjs","names":["useState","useLatestRef","useRef","useCallback","require_use_latest_ref","react","useAsync","options","state","setState","fnRef","asyncFn","callIdRef","mountedRef","run","callId","current","data","error","reset","immediate","deps"],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":"A,+DA6BA,SAAgBM,EACZ,EACA,EAA+B,CAAC,EAChC,EAAmC,CAAC,EACnB,CACjB,GAAM,CAAE,YAAY,IAAUC,EACxB,CAACC,EAAOC,IAAA,EAAYT,EAAAA,SAAAA,CAIvB,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,EAElDU,EAAQT,EAAAA,aAAaU,CAAO,EAC5BC,GAAA,EAAYV,EAAAA,OAAAA,CAAe,CAAC,EAC5BW,GAAA,EAAaX,EAAAA,OAAAA,CAAgB,EAAI,GAEvC,EAAAG,EAAA,UAAA,MACI,EAAW,QAAU,OACR,CACT,EAAW,QAAU,EACzB,GACD,CAAC,CAAC,EAEL,IAAMS,GAAA,EAAMX,EAAAA,YAAAA,CAAY,SAAwB,CAC5C,IAAMY,EAAS,EAAEH,EAAU,QAC3BH,EAAU,IAAa,CAAE,GAAGO,EAAS,OAAQ,UAAW,MAAO,IAAA,EAAU,EAAE,EAC3E,GAAI,CACA,IAAMC,EAAO,MAAMP,EAAM,QAAQ,EAIjC,OAHIG,EAAW,SAAWD,EAAU,UAAYG,GAC5CN,EAAS,CAAE,OAAQ,UAAW,OAAM,MAAO,IAAA,EAAU,CAAC,EAEnDQ,CACX,OAASC,EAAO,CAIZ,MAHIL,EAAW,SAAWD,EAAU,UAAYG,GAC5CN,EAAS,CAAE,OAAQ,QAAS,KAAM,IAAA,GAAW,OAAM,CAAC,EAElDS,CACV,CACJ,EAAG,CAACR,CAAK,CAAC,EAEJS,GAAA,EAAQhB,EAAAA,YAAAA,KAAwB,CAClC,EAAU,UACVM,EAAS,CAAE,OAAQ,OAAQ,KAAM,IAAA,GAAW,MAAO,IAAA,EAAU,CAAC,CAClE,EAAG,CAAC,CAAC,EAUL,OARA,EAAAJ,EAAA,UAAA,KAAgB,CACPe,GACLN,EAAI,CAAC,CAAC,UAAY,CAElB,CAAC,CAEL,EAAG,CAACM,EAAW,GAAGC,CAAI,CAAC,EAEhB,CACH,OAAQb,EAAM,OACd,KAAMA,EAAM,KACZ,MAAOA,EAAM,MACb,UAAWA,EAAM,SAAW,UAC5B,UAAWA,EAAM,SAAW,UAC5B,QAASA,EAAM,SAAW,QAC1B,MACA,OACJ,CACJ,C"}

package/dist/hooks/use-async.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-async.js","names":[],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":";;;AA6BA,SAAgB,EACZ,GACA,IAA+B,CAAC,GAChC,IAAmC,CAAC,GACnB;CACjB,IAAM,EAAE,eAAY,OAAU,GACxB,CAAC,GAAO,KAAY,EAIvB;EAAE,QAAQ;EAAQ,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU,CAAC,GAElD,IAAQ,EAAa,CAAO,GAC5B,IAAY,EAAe,CAAC,GAC5B,IAAa,EAAgB,EAAI;CAEvC,SACI,EAAW,UAAU,UACR;EACT,EAAW,UAAU;CACzB,IACD,CAAC,CAAC;CAEL,IAAM,IAAM,EAAY,YAAwB;EAC5C,IAAM,IAAS,EAAE,EAAU;EAC3B,GAAU,OAAa;GAAE,GAAG;GAAS,QAAQ;GAAW,OAAO,KAAA;EAAU,EAAE;EAC3E,IAAI;GACA,IAAM,IAAO,MAAM,EAAM,QAAQ;GAIjC,OAHI,EAAW,WAAW,EAAU,YAAY,KAC5C,EAAS;IAAE,QAAQ;IAAW;IAAM,OAAO,KAAA;GAAU,CAAC,GAEnD;EACX,SAAS,GAAO;GAIZ,MAHI,EAAW,WAAW,EAAU,YAAY,KAC5C,EAAS;IAAE,QAAQ;IAAS,MAAM,KAAA;IAAW;GAAM,CAAC,GAElD;EACV;CACJ,GAAG,CAAC,CAAK,CAAC,GAEJ,IAAQ,QAAwB;EAElC,AADA,EAAU,WACV,EAAS;GAAE,QAAQ;GAAQ,MAAM,KAAA;GAAW,OAAO,KAAA;EAAU,CAAC;CAClE,GAAG,CAAC,CAAC;CAUL,OARA,QAAgB;EACP,KACL,EAAI,CAAC,CAAC,YAAY,CAElB,CAAC;CAEL,GAAG,CAAC,GAAW,GAAG,CAAI,CAAC,GAEhB;EACH,QAAQ,EAAM;EACd,MAAM,EAAM;EACZ,OAAO,EAAM;EACb,WAAW,EAAM,WAAW;EAC5B,WAAW,EAAM,WAAW;EAC5B,SAAS,EAAM,WAAW;EAC1B;EACA;CACJ;AACJ"}
+{"version":3,"file":"use-async.js","names":["useAsync","options","state","setState","useState","fnRef","useLatestRef","asyncFn","callIdRef","useRef","mountedRef","run","useCallback","callId","current","data","error","reset","useEffect","immediate","deps"],"sources":["../../src/hooks/use-async.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\n\nexport type AsyncStatus = \"idle\" | \"pending\" | \"success\" | \"error\";\n\nexport interface UseAsyncResult<T> {\n    status: AsyncStatus;\n    data: T | undefined;\n    error: unknown;\n    isPending: boolean;\n    isSuccess: boolean;\n    isError: boolean;\n    /** Trigger the async function. Resolves with the new data or rejects. */\n    run: () => Promise<T>;\n    /** Reset state back to idle. */\n    reset: () => void;\n}\n\n/**\n * Run an async function and track its `idle/pending/success/error` state.\n *\n * - Discards results from stale runs (race-condition safe).\n * - `immediate` (default `false`) triggers the function on mount and when\n *   `deps` change. With `false`, call `run()` manually.\n * - Returns a stable object so callers can destructure or pass around safely.\n *\n * For server data with caching, prefer React Query — `useAsync` is the\n * minimal one-shot primitive without dependencies.\n */\nexport function useAsync<T>(\n    asyncFn: () => Promise<T>,\n    deps: ReadonlyArray<unknown> = [],\n    options: { immediate?: boolean } = {},\n): UseAsyncResult<T> {\n    const { immediate = false } = options;\n    const [state, setState] = useState<{\n        status: AsyncStatus;\n        data: T | undefined;\n        error: unknown;\n    }>({ status: \"idle\", data: undefined, error: undefined });\n\n    const fnRef = useLatestRef(asyncFn);\n    const callIdRef = useRef<number>(0);\n    const mountedRef = useRef<boolean>(true);\n\n    useEffect(() => {\n        mountedRef.current = true;\n        return () => {\n            mountedRef.current = false;\n        };\n    }, []);\n\n    const run = useCallback(async (): Promise<T> => {\n        const callId = ++callIdRef.current;\n        setState((current) => ({ ...current, status: \"pending\", error: undefined }));\n        try {\n            const data = await fnRef.current();\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"success\", data, error: undefined });\n            }\n            return data;\n        } catch (error) {\n            if (mountedRef.current && callIdRef.current === callId) {\n                setState({ status: \"error\", data: undefined, error });\n            }\n            throw error;\n        }\n    }, [fnRef]);\n\n    const reset = useCallback((): void => {\n        callIdRef.current++;\n        setState({ status: \"idle\", data: undefined, error: undefined });\n    }, []);\n\n    useEffect(() => {\n        if (!immediate) return;\n        run().catch(() => {\n            /* error already captured in state */\n        });\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [immediate, ...deps]);\n\n    return {\n        status: state.status,\n        data: state.data,\n        error: state.error,\n        isPending: state.status === \"pending\",\n        isSuccess: state.status === \"success\",\n        isError: state.status === \"error\",\n        run,\n        reset,\n    };\n}\n"],"mappings":";;;AA6BA,SAAgBA,EACZ,GACA,IAA+B,CAAC,GAChC,IAAmC,CAAC,GACnB;CACjB,IAAM,EAAE,eAAY,OAAUC,GACxB,CAACC,GAAOC,KAAYC,EAIvB;EAAE,QAAQ;EAAQ,MAAM,KAAA;EAAW,OAAO,KAAA;CAAU,CAAC,GAElDC,IAAQC,EAAaC,CAAO,GAC5BC,IAAYC,EAAe,CAAC,GAC5BC,IAAaD,EAAgB,EAAI;CAEvC,SACI,EAAW,UAAU,UACR;EACT,EAAW,UAAU;CACzB,IACD,CAAC,CAAC;CAEL,IAAME,IAAMC,EAAY,YAAwB;EAC5C,IAAMC,IAAS,EAAEL,EAAU;EAC3B,GAAU,OAAa;GAAE,GAAGM;GAAS,QAAQ;GAAW,OAAO,KAAA;EAAU,EAAE;EAC3E,IAAI;GACA,IAAMC,IAAO,MAAMV,EAAM,QAAQ;GAIjC,OAHIK,EAAW,WAAWF,EAAU,YAAYK,KAC5CV,EAAS;IAAE,QAAQ;IAAW;IAAM,OAAO,KAAA;GAAU,CAAC,GAEnDY;EACX,SAASC,GAAO;GAIZ,MAHIN,EAAW,WAAWF,EAAU,YAAYK,KAC5CV,EAAS;IAAE,QAAQ;IAAS,MAAM,KAAA;IAAW;GAAM,CAAC,GAElDa;EACV;CACJ,GAAG,CAACX,CAAK,CAAC,GAEJY,IAAQL,QAAwB;EAElC,AADA,EAAU,WACVT,EAAS;GAAE,QAAQ;GAAQ,MAAM,KAAA;GAAW,OAAO,KAAA;EAAU,CAAC;CAClE,GAAG,CAAC,CAAC;CAUL,OARAe,QAAgB;EACZ,AAAKC,KACLR,EAAI,CAAC,CAAC,YAAY,CAElB,CAAC;CAEL,GAAG,CAACQ,GAAW,GAAGC,CAAI,CAAC,GAEhB;EACH,QAAQlB,EAAM;EACd,MAAMA,EAAM;EACZ,OAAOA,EAAM;EACb,WAAWA,EAAM,WAAW;EAC5B,WAAWA,EAAM,WAAW;EAC5B,SAASA,EAAM,WAAW;EAC1B;EACA;CACJ;AACJ"}

package/dist/hooks/use-before-install-prompt.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-before-install-prompt.cjs","names":[],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":"uBAwBA,SAAS,GAA4B,CACjC,GAAI,OAAO,OAAW,IAAa,MAAO,GAE1C,IAAM,EAAqB,CADL,aAAc,aAAc,YACvB,CAAA,CAAa,KACnC,GAAS,OAAO,aAAa,kBAAkB,EAAK,EAAE,CAAC,EAAE,OAC9D,EAEM,EACD,OAAO,UAAmD,aAAe,GAC9E,OAAO,GAAsB,CACjC,CAMA,SAAgB,GAAuD,CACnE,GAAM,CAAC,EAAU,IAAA,EAAe,EAAA,SAAA,CAA0C,IAAI,EACxE,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAkB,EAAK,EACnD,CAAC,EAAc,IAAA,EAAmB,EAAA,SAAA,CAAkB,CAAgB,GAE1E,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,EAAW,GAAuB,CACpC,EAAM,eAAe,EACrB,EAAY,CAAiC,CACjD,EACM,MAA+B,CACjC,EAAY,IAAI,EAChB,EAAa,EAAI,EACjB,EAAgB,EAAI,CACxB,EACM,EAAmB,OAAO,aAAa,4BAA4B,EACnE,MAAiC,EAAgB,EAAiB,CAAC,EAIzE,OAHA,OAAO,iBAAiB,sBAAuB,CAAO,EACtD,OAAO,iBAAiB,eAAgB,CAAgB,EACxD,GAAkB,iBAAiB,SAAU,CAAkB,MAClD,CACT,OAAO,oBAAoB,sBAAuB,CAAO,EACzD,OAAO,oBAAoB,eAAgB,CAAgB,EAC3D,GAAkB,oBAAoB,SAAU,CAAkB,CACtE,CACJ,EAAG,CAAC,CAAC,EAEL,IAAM,GAAA,EAAS,EAAA,YAAA,CAAY,SAA+D,CACtF,GAAI,CAAC,EAAU,MAAO,cACtB,MAAM,EAAS,OAAO,EACtB,IAAM,EAAS,MAAM,EAAS,WAG9B,OAFA,EAAY,IAAI,EACZ,EAAO,UAAY,YAAY,EAAa,EAAI,EAC7C,EAAO,OAClB,EAAG,CAAC,CAAQ,CAAC,EAEb,MAAO,CACH,YAAa,CAAC,CAAC,EACf,YACA,eACA,QACJ,CACJ"}
+{"version":3,"file":"use-before-install-prompt.cjs","names":["useState","useCallback","react","detectStandalone","matchesDisplayMode","mode","iosStandalone","useBeforeInstallPrompt","deferred","setDeferred","installed","setInstalled","isStandalone","setIsStandalone","handler","event","installedHandler","displayModeQuery","displayModeHandler","prompt","result"],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":"A,uBAwBA,SAASG,GAA4B,CACjC,GAAI,OAAO,OAAW,IAAa,MAAO,GAE1C,IAAMC,EAAqB,CADL,aAAc,aAAc,YACvB,CAAA,CAAa,KACnC,GAAS,OAAO,aAAa,kBAAkBC,EAAK,EAAE,CAAC,EAAE,OAC9D,EAEMC,EACD,OAAO,UAAmD,aAAe,GAC9E,OAAOF,GAAsBE,CACjC,CAMA,SAAgBC,GAAuD,CACnE,GAAM,CAACC,EAAUC,IAAA,EAAeT,EAAAA,SAAAA,CAA0C,IAAI,EACxE,CAACU,EAAWC,IAAA,EAAgBX,EAAAA,SAAAA,CAAkB,EAAK,EACnD,CAACY,EAAcC,IAAA,EAAmBb,EAAAA,SAAAA,CAAkBG,CAAgB,GAE1E,EAAAD,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAMY,EAAW,GAAuB,CACpCC,EAAM,eAAe,EACrBN,EAAYM,CAAiC,CACjD,EACMC,MAA+B,CACjCP,EAAY,IAAI,EAChBE,EAAa,EAAI,EACjBE,EAAgB,EAAI,CACxB,EACMI,EAAmB,OAAO,aAAa,4BAA4B,EACnEC,MAAiCL,EAAgBV,EAAiB,CAAC,EAIzE,OAHA,OAAO,iBAAiB,sBAAuBW,CAAO,EACtD,OAAO,iBAAiB,eAAgBE,CAAgB,EACxDC,GAAkB,iBAAiB,SAAUC,CAAkB,MAClD,CACT,OAAO,oBAAoB,sBAAuBJ,CAAO,EACzD,OAAO,oBAAoB,eAAgBE,CAAgB,EAC3DC,GAAkB,oBAAoB,SAAUC,CAAkB,CACtE,CACJ,EAAG,CAAC,CAAC,EAEL,IAAMC,GAAA,EAASlB,EAAAA,YAAAA,CAAY,SAA+D,CACtF,GAAI,CAACO,EAAU,MAAO,cACtB,MAAMA,EAAS,OAAO,EACtB,IAAMY,EAAS,MAAMZ,EAAS,WAG9B,OAFAC,EAAY,IAAI,EACZW,EAAO,UAAY,YAAYT,EAAa,EAAI,EAC7CS,EAAO,OAClB,EAAG,CAACZ,CAAQ,CAAC,EAEb,MAAO,CACH,YAAa,CAAC,CAACA,EACf,YACA,eACA,QACJ,CACJ,C"}

package/dist/hooks/use-before-install-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-before-install-prompt.js","names":[],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":";;AAwBA,SAAS,IAA4B;CACjC,IAAI,OAAO,SAAW,KAAa,OAAO;CAE1C,IAAM,IAAqB;EADL;EAAc;EAAc;CACvB,CAAA,CAAa,MACnC,MAAS,OAAO,aAAa,kBAAkB,EAAK,EAAE,CAAC,EAAE,OAC9D,GAEM,IACD,OAAO,UAAmD,eAAe;CAC9E,OAAO,KAAsB;AACjC;AAMA,SAAgB,IAAuD;CACnE,IAAM,CAAC,GAAU,KAAe,EAA0C,IAAI,GACxE,CAAC,GAAW,KAAgB,EAAkB,EAAK,GACnD,CAAC,GAAc,KAAmB,EAAkB,CAAgB;CAE1E,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,KAAW,MAAuB;GAEpC,AADA,EAAM,eAAe,GACrB,EAAY,CAAiC;EACjD,GACM,UAA+B;GAGjC,AAFA,EAAY,IAAI,GAChB,EAAa,EAAI,GACjB,EAAgB,EAAI;EACxB,GACM,IAAmB,OAAO,aAAa,4BAA4B,GACnE,UAAiC,EAAgB,EAAiB,CAAC;EAIzE,OAHA,OAAO,iBAAiB,uBAAuB,CAAO,GACtD,OAAO,iBAAiB,gBAAgB,CAAgB,GACxD,GAAkB,iBAAiB,UAAU,CAAkB,SAClD;GAGT,AAFA,OAAO,oBAAoB,uBAAuB,CAAO,GACzD,OAAO,oBAAoB,gBAAgB,CAAgB,GAC3D,GAAkB,oBAAoB,UAAU,CAAkB;EACtE;CACJ,GAAG,CAAC,CAAC;CAEL,IAAM,IAAS,EAAY,YAA+D;EACtF,IAAI,CAAC,GAAU,OAAO;EACtB,MAAM,EAAS,OAAO;EACtB,IAAM,IAAS,MAAM,EAAS;EAG9B,OAFA,EAAY,IAAI,GACZ,EAAO,YAAY,cAAY,EAAa,EAAI,GAC7C,EAAO;CAClB,GAAG,CAAC,CAAQ,CAAC;CAEb,OAAO;EACH,aAAa,CAAC,CAAC;EACf;EACA;EACA;CACJ;AACJ"}
+{"version":3,"file":"use-before-install-prompt.js","names":["detectStandalone","matchesDisplayMode","mode","iosStandalone","useBeforeInstallPrompt","deferred","setDeferred","useState","installed","setInstalled","isStandalone","setIsStandalone","handler","event","installedHandler","displayModeQuery","displayModeHandler","prompt","useCallback","result"],"sources":["../../src/hooks/use-before-install-prompt.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from \"react\";\n\ninterface BeforeInstallPromptEvent extends Event {\n    readonly platforms: readonly string[];\n    readonly userChoice: Promise<{ outcome: \"accepted\" | \"dismissed\"; platform: string }>;\n    prompt(): Promise<void>;\n}\n\nexport interface UseBeforeInstallPromptResult {\n    /** True when the browser fired `beforeinstallprompt` and the user has not yet decided. */\n    installable: boolean;\n    /** True after the user accepts the install prompt. */\n    installed: boolean;\n    /**\n     * True when the app is already running as an installed PWA (display-mode\n     * `standalone`/`fullscreen`/`minimal-ui`, or iOS `navigator.standalone`).\n     * Use it to hide install affordances for users who already installed.\n     */\n    isStandalone: boolean;\n    /** Show the install prompt. Resolves with the user's choice. */\n    prompt: () => Promise<\"accepted\" | \"dismissed\" | \"unsupported\">;\n}\n\n/** Detect whether the document is running inside an installed PWA window. */\nfunction detectStandalone(): boolean {\n    if (typeof window === \"undefined\") return false;\n    const displayModes = [\"standalone\", \"fullscreen\", \"minimal-ui\"];\n    const matchesDisplayMode = displayModes.some(\n        (mode) => window.matchMedia?.(`(display-mode: ${mode})`)?.matches,\n    );\n    // iOS Safari exposes the legacy non-standard `navigator.standalone`.\n    const iosStandalone =\n        (window.navigator as Navigator & { standalone?: boolean }).standalone === true;\n    return matchesDisplayMode || iosStandalone;\n}\n\n/**\n * React hook for the PWA install prompt. Captures the `beforeinstallprompt`\n * event so you can defer the install UI to a moment that fits your UX.\n */\nexport function useBeforeInstallPrompt(): UseBeforeInstallPromptResult {\n    const [deferred, setDeferred] = useState<BeforeInstallPromptEvent | null>(null);\n    const [installed, setInstalled] = useState<boolean>(false);\n    const [isStandalone, setIsStandalone] = useState<boolean>(detectStandalone);\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const handler = (event: Event): void => {\n            event.preventDefault();\n            setDeferred(event as BeforeInstallPromptEvent);\n        };\n        const installedHandler = (): void => {\n            setDeferred(null);\n            setInstalled(true);\n            setIsStandalone(true);\n        };\n        const displayModeQuery = window.matchMedia?.(\"(display-mode: standalone)\");\n        const displayModeHandler = (): void => setIsStandalone(detectStandalone());\n        window.addEventListener(\"beforeinstallprompt\", handler);\n        window.addEventListener(\"appinstalled\", installedHandler);\n        displayModeQuery?.addEventListener(\"change\", displayModeHandler);\n        return () => {\n            window.removeEventListener(\"beforeinstallprompt\", handler);\n            window.removeEventListener(\"appinstalled\", installedHandler);\n            displayModeQuery?.removeEventListener(\"change\", displayModeHandler);\n        };\n    }, []);\n\n    const prompt = useCallback(async (): Promise<\"accepted\" | \"dismissed\" | \"unsupported\"> => {\n        if (!deferred) return \"unsupported\";\n        await deferred.prompt();\n        const result = await deferred.userChoice;\n        setDeferred(null);\n        if (result.outcome === \"accepted\") setInstalled(true);\n        return result.outcome;\n    }, [deferred]);\n\n    return {\n        installable: !!deferred,\n        installed,\n        isStandalone,\n        prompt,\n    };\n}\n"],"mappings":";;AAwBA,SAASA,IAA4B;CACjC,IAAI,OAAO,SAAW,KAAa,OAAO;CAE1C,IAAMC,IAAqB;EADL;EAAc;EAAc;CACvB,CAAA,CAAa,MACnC,MAAS,OAAO,aAAa,kBAAkBC,EAAK,EAAE,CAAC,EAAE,OAC9D,GAEMC,IACD,OAAO,UAAmD,eAAe;CAC9E,OAAOF,KAAsBE;AACjC;AAMA,SAAgBC,IAAuD;CACnE,IAAM,CAACC,GAAUC,KAAeC,EAA0C,IAAI,GACxE,CAACC,GAAWC,KAAgBF,EAAkB,EAAK,GACnD,CAACG,GAAcC,KAAmBJ,EAAkBP,CAAgB;CAE1E,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAMY,KAAW,MAAuB;GAEpC,AADAC,EAAM,eAAe,GACrBP,EAAYO,CAAiC;EACjD,GACMC,UAA+B;GAGjC,AAFAR,EAAY,IAAI,GAChBG,EAAa,EAAI,GACjBE,EAAgB,EAAI;EACxB,GACMI,IAAmB,OAAO,aAAa,4BAA4B,GACnEC,UAAiCL,EAAgBX,EAAiB,CAAC;EAIzE,OAHA,OAAO,iBAAiB,uBAAuBY,CAAO,GACtD,OAAO,iBAAiB,gBAAgBE,CAAgB,GACxDC,GAAkB,iBAAiB,UAAUC,CAAkB,SAClD;GAGT,AAFA,OAAO,oBAAoB,uBAAuBJ,CAAO,GACzD,OAAO,oBAAoB,gBAAgBE,CAAgB,GAC3DC,GAAkB,oBAAoB,UAAUC,CAAkB;EACtE;CACJ,GAAG,CAAC,CAAC;CAEL,IAAMC,IAASC,EAAY,YAA+D;EACtF,IAAI,CAACb,GAAU,OAAO;EACtB,MAAMA,EAAS,OAAO;EACtB,IAAMc,IAAS,MAAMd,EAAS;EAG9B,OAFAC,EAAY,IAAI,GACZa,EAAO,YAAY,cAAYV,EAAa,EAAI,GAC7CU,EAAO;CAClB,GAAG,CAACd,CAAQ,CAAC;CAEb,OAAO;EACH,aAAa,CAAC,CAACA;EACf;EACA;EACA;CACJ;AACJ"}

package/dist/hooks/use-breakpoint.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-breakpoint.cjs","names":[],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":"uBASA,IAAa,EAA0C,CACnD,GAAI,IACJ,GAAI,IACJ,GAAI,IACJ,GAAI,KACJ,GAAI,KACJ,MAAO,IACX,EAEM,EAA+B,CAAC,KAAM,KAAM,KAAM,KAAM,KAAM,KAAK,EAEzE,SAAS,EAAe,EAA2B,CAC/C,IAAI,EAAsB,KAC1B,IAAK,IAAM,KAAO,EACV,GAAS,EAAY,KACrB,EAAU,GAGlB,OAAO,CACX,CAwBA,SAAgB,GAAmC,CAC/C,GAAM,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,KACtB,OAAO,OAAW,IAAc,EAAI,OAAO,UAC/C,GAEA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAM,MAAuB,EAAS,OAAO,UAAU,EAGvD,OAFA,EAAS,EACT,OAAO,iBAAiB,SAAU,EAAU,CAAE,QAAS,EAAK,CAAC,MAChD,OAAO,oBAAoB,SAAU,CAAQ,CAC9D,EAAG,CAAC,CAAC,EAEL,IAAM,EAAU,EAAe,CAAK,EAC9B,EAAS,GAA4B,GAAS,EAAY,GAC1D,EAAS,GAA4B,EAAQ,EAAY,GAE/D,MAAO,CACH,UACA,QACA,QACA,QACA,SAAU,EAAM,IAAI,EACpB,SAAU,EAAM,IAAI,GAAK,EAAM,IAAI,EACnC,UAAW,EAAM,IAAI,CACzB,CACJ"}
+{"version":3,"file":"use-breakpoint.cjs","names":["useState","react","BREAKPOINTS","ORDER","resolveCurrent","current","key","width","useBreakpoint","setWidth","onResize","above","bp","below"],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":"A,uBASA,IAAaE,EAA0C,CACnD,GAAI,IACJ,GAAI,IACJ,GAAI,IACJ,GAAI,KACJ,GAAI,KACJ,MAAO,IACX,EAEMC,EAA+B,CAAC,KAAM,KAAM,KAAM,KAAM,KAAM,KAAK,EAEzE,SAASC,EAAe,EAA2B,CAC/C,IAAIC,EAAsB,KAC1B,IAAK,IAAMC,KAAOH,EACVI,GAASL,EAAYI,KACrB,EAAUA,GAGlB,OAAOD,CACX,CAwBA,SAAgBG,GAAmC,CAC/C,GAAM,CAACD,EAAOE,IAAA,EAAYT,EAAAA,SAAAA,KACtB,OAAO,OAAW,IAAc,EAAI,OAAO,UAC/C,GAEA,EAAAC,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,OAAW,IAAa,OACnC,IAAMS,MAAuBD,EAAS,OAAO,UAAU,EAGvD,OAFAC,EAAS,EACT,OAAO,iBAAiB,SAAUA,EAAU,CAAE,QAAS,EAAK,CAAC,MAChD,OAAO,oBAAoB,SAAUA,CAAQ,CAC9D,EAAG,CAAC,CAAC,EAEL,IAAML,EAAUD,EAAeG,CAAK,EAC9BI,EAAS,GAA4BJ,GAASL,EAAYU,GAC1DC,EAAS,GAA4BN,EAAQL,EAAYU,GAE/D,MAAO,CACH,UACA,QACA,QACA,QACA,SAAUC,EAAM,IAAI,EACpB,SAAUF,EAAM,IAAI,GAAKE,EAAM,IAAI,EACnC,UAAWF,EAAM,IAAI,CACzB,CACJ,C"}

package/dist/hooks/use-breakpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-breakpoint.js","names":[],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":";;AASA,IAAa,IAA0C;CACnD,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,OAAO;AACX,GAEM,IAA+B;CAAC;CAAM;CAAM;CAAM;CAAM;CAAM;AAAK;AAEzE,SAAS,EAAe,GAA2B;CAC/C,IAAI,IAAsB;CAC1B,KAAK,IAAM,KAAO,GACd,AAAI,KAAS,EAAY,OACrB,IAAU;CAGlB,OAAO;AACX;AAwBA,SAAgB,IAAmC;CAC/C,IAAM,CAAC,GAAO,KAAY,QACtB,OAAO,SAAW,MAAc,IAAI,OAAO,UAC/C;CAEA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAM,UAAuB,EAAS,OAAO,UAAU;EAGvD,OAFA,EAAS,GACT,OAAO,iBAAiB,UAAU,GAAU,EAAE,SAAS,GAAK,CAAC,SAChD,OAAO,oBAAoB,UAAU,CAAQ;CAC9D,GAAG,CAAC,CAAC;CAEL,IAAM,IAAU,EAAe,CAAK,GAC9B,KAAS,MAA4B,KAAS,EAAY,IAC1D,KAAS,MAA4B,IAAQ,EAAY;CAE/D,OAAO;EACH;EACA;EACA;EACA;EACA,UAAU,EAAM,IAAI;EACpB,UAAU,EAAM,IAAI,KAAK,EAAM,IAAI;EACnC,WAAW,EAAM,IAAI;CACzB;AACJ"}
+{"version":3,"file":"use-breakpoint.js","names":["BREAKPOINTS","ORDER","resolveCurrent","current","key","width","useBreakpoint","setWidth","useState","onResize","above","bp","below"],"sources":["../../src/hooks/use-breakpoint.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Breakpoint keys exposed by the SDK. Values mirror the CSS tokens\n * `--tempest-bp-xs|sm|md|lg|xl|2xl` defined in `styles/colors.css`.\n */\nexport type Breakpoint = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\";\n\n/** Pixel value paired with each breakpoint key. */\nexport const BREAKPOINTS: Record<Breakpoint, number> = {\n    xs: 480,\n    sm: 640,\n    md: 768,\n    lg: 1024,\n    xl: 1280,\n    \"2xl\": 1536,\n};\n\nconst ORDER: readonly Breakpoint[] = [\"xs\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n\nfunction resolveCurrent(width: number): Breakpoint {\n    let current: Breakpoint = \"xs\";\n    for (const key of ORDER) {\n        if (width >= BREAKPOINTS[key]) {\n            current = key;\n        }\n    }\n    return current;\n}\n\nexport interface BreakpointHelpers {\n    /** Current breakpoint key (the largest one whose min-width is matched). */\n    current: Breakpoint;\n    /** Window width in pixels at last update. `0` when SSR. */\n    width: number;\n    /** True when viewport width is `>=` the given breakpoint. */\n    above: (bp: Breakpoint) => boolean;\n    /** True when viewport width is `<` the given breakpoint. */\n    below: (bp: Breakpoint) => boolean;\n    /** Convenience flags mapping to typical device shapes. */\n    isMobile: boolean;\n    isTablet: boolean;\n    isDesktop: boolean;\n}\n\n/**\n * Reactive viewport-breakpoint hook.\n *\n * Returns the current breakpoint key plus `above` / `below` helpers and\n * `isMobile` / `isTablet` / `isDesktop` flags. SSR-safe — returns `xs` /\n * `width: 0` on the server, then updates after mount.\n */\nexport function useBreakpoint(): BreakpointHelpers {\n    const [width, setWidth] = useState<number>(() =>\n        typeof window === \"undefined\" ? 0 : window.innerWidth,\n    );\n\n    useEffect(() => {\n        if (typeof window === \"undefined\") return;\n        const onResize = (): void => setWidth(window.innerWidth);\n        onResize();\n        window.addEventListener(\"resize\", onResize, { passive: true });\n        return () => window.removeEventListener(\"resize\", onResize);\n    }, []);\n\n    const current = resolveCurrent(width);\n    const above = (bp: Breakpoint): boolean => width >= BREAKPOINTS[bp];\n    const below = (bp: Breakpoint): boolean => width < BREAKPOINTS[bp];\n\n    return {\n        current,\n        width,\n        above,\n        below,\n        isMobile: below(\"md\"),\n        isTablet: above(\"md\") && below(\"lg\"),\n        isDesktop: above(\"lg\"),\n    };\n}\n"],"mappings":";;AASA,IAAaA,IAA0C;CACnD,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,OAAO;AACX,GAEMC,IAA+B;CAAC;CAAM;CAAM;CAAM;CAAM;CAAM;AAAK;AAEzE,SAASC,EAAe,GAA2B;CAC/C,IAAIC,IAAsB;CAC1B,KAAK,IAAMC,KAAOH,GACd,AAAII,KAASL,EAAYI,OACrB,IAAUA;CAGlB,OAAOD;AACX;AAwBA,SAAgBG,IAAmC;CAC/C,IAAM,CAACD,GAAOE,KAAYC,QACtB,OAAO,SAAW,MAAc,IAAI,OAAO,UAC/C;CAEA,QAAgB;EACZ,IAAI,OAAO,SAAW,KAAa;EACnC,IAAMC,UAAuBF,EAAS,OAAO,UAAU;EAGvD,OAFAE,EAAS,GACT,OAAO,iBAAiB,UAAUA,GAAU,EAAE,SAAS,GAAK,CAAC,SAChD,OAAO,oBAAoB,UAAUA,CAAQ;CAC9D,GAAG,CAAC,CAAC;CAEL,IAAMN,IAAUD,EAAeG,CAAK,GAC9BK,KAAS,MAA4BL,KAASL,EAAYW,IAC1DC,KAAS,MAA4BP,IAAQL,EAAYW;CAE/D,OAAO;EACH;EACA;EACA;EACA;EACA,UAAUC,EAAM,IAAI;EACpB,UAAUF,EAAM,IAAI,KAAKE,EAAM,IAAI;EACnC,WAAWF,EAAM,IAAI;CACzB;AACJ"}

package/dist/hooks/use-click-outside.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-click-outside.cjs","names":[],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":"+DAYA,SAAgB,EACZ,EACmB,CACnB,IAAM,GAAA,EAAM,EAAA,OAAA,CAAU,IAAI,EACpB,EAAa,EAAA,aAAa,CAAO,EAmBvC,OAjBA,EAAA,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,SAAa,IAAa,OAErC,IAAM,EAAY,GAAyC,CACvD,IAAM,EAAS,EAAM,OACjB,CAAC,EAAI,SAAY,GAAU,EAAI,QAAQ,SAAS,CAAM,GAC1D,EAAW,QAAQ,CACvB,EAIA,OAFA,SAAS,iBAAiB,YAAa,CAAQ,EAC/C,SAAS,iBAAiB,aAAc,CAAQ,MACnC,CACT,SAAS,oBAAoB,YAAa,CAAQ,EAClD,SAAS,oBAAoB,aAAc,CAAQ,CACvD,CACJ,EAAG,CAAC,CAAU,CAAC,EAER,CACX"}
+{"version":3,"file":"use-click-outside.cjs","names":["useRef","useLatestRef","require_use_latest_ref","react","useClickOutside","ref","handlerRef","handler","listener","target","event"],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":"A,+DAYA,SAAgBI,EACZ,EACmB,CACnB,IAAMC,GAAA,EAAML,EAAAA,OAAAA,CAAU,IAAI,EACpBM,EAAaL,EAAAA,aAAaM,CAAO,EAmBvC,OAjBA,EAAAJ,EAAA,UAAA,KAAgB,CACZ,GAAI,OAAO,SAAa,IAAa,OAErC,IAAMK,EAAY,GAAyC,CACvD,IAAMC,EAASC,EAAM,OACjB,CAACL,EAAI,SAAYI,GAAUJ,EAAI,QAAQ,SAASI,CAAM,GAC1DH,EAAW,QAAQ,CACvB,EAIA,OAFA,SAAS,iBAAiB,YAAaE,CAAQ,EAC/C,SAAS,iBAAiB,aAAcA,CAAQ,MACnC,CACT,SAAS,oBAAoB,YAAaA,CAAQ,EAClD,SAAS,oBAAoB,aAAcA,CAAQ,CACvD,CACJ,EAAG,CAACF,CAAU,CAAC,EAERD,CACX,C"}

package/dist/hooks/use-click-outside.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-click-outside.js","names":[],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":";;;AAYA,SAAgB,EACZ,GACmB;CACnB,IAAM,IAAM,EAAU,IAAI,GACpB,IAAa,EAAa,CAAO;CAmBvC,OAjBA,QAAgB;EACZ,IAAI,OAAO,WAAa,KAAa;EAErC,IAAM,KAAY,MAAyC;GACvD,IAAM,IAAS,EAAM;GACjB,CAAC,EAAI,WAAY,KAAU,EAAI,QAAQ,SAAS,CAAM,KAC1D,EAAW,QAAQ;EACvB;EAIA,OAFA,SAAS,iBAAiB,aAAa,CAAQ,GAC/C,SAAS,iBAAiB,cAAc,CAAQ,SACnC;GAET,AADA,SAAS,oBAAoB,aAAa,CAAQ,GAClD,SAAS,oBAAoB,cAAc,CAAQ;EACvD;CACJ,GAAG,CAAC,CAAU,CAAC,GAER;AACX"}
+{"version":3,"file":"use-click-outside.js","names":["useClickOutside","ref","useRef","handlerRef","useLatestRef","handler","useEffect","listener","target","event"],"sources":["../../src/hooks/use-click-outside.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useLatestRef } from \"./use-latest-ref\";\nimport type { RefObject } from \"react\";\n\n/**\n * Call `handler` when a `mousedown` / `touchstart` occurs outside the returned\n * ref's element. SSR-safe — listeners are only attached in the browser.\n *\n * @typeParam T - element type to attach the ref to.\n * @param handler - invoked on an outside interaction.\n * @returns A ref to attach to the element treated as \"inside\".\n */\nexport function useClickOutside<T extends HTMLElement = HTMLElement>(\n    handler: () => void,\n): RefObject<T | null> {\n    const ref = useRef<T>(null);\n    const handlerRef = useLatestRef(handler);\n\n    useEffect(() => {\n        if (typeof document === \"undefined\") return;\n\n        const listener = (event: MouseEvent | TouchEvent): void => {\n            const target = event.target as Node | null;\n            if (!ref.current || (target && ref.current.contains(target))) return;\n            handlerRef.current();\n        };\n\n        document.addEventListener(\"mousedown\", listener);\n        document.addEventListener(\"touchstart\", listener);\n        return () => {\n            document.removeEventListener(\"mousedown\", listener);\n            document.removeEventListener(\"touchstart\", listener);\n        };\n    }, [handlerRef]);\n\n    return ref;\n}\n"],"mappings":";;;AAYA,SAAgBA,EACZ,GACmB;CACnB,IAAMC,IAAMC,EAAU,IAAI,GACpBC,IAAaC,EAAaC,CAAO;CAmBvC,OAjBAC,QAAgB;EACZ,IAAI,OAAO,WAAa,KAAa;EAErC,IAAMC,KAAY,MAAyC;GACvD,IAAMC,IAASC,EAAM;GACrB,AAAI,CAACR,EAAI,WAAYO,KAAUP,EAAI,QAAQ,SAASO,CAAM,KAC1DL,EAAW,QAAQ;EACvB;EAIA,OAFA,SAAS,iBAAiB,aAAaI,CAAQ,GAC/C,SAAS,iBAAiB,cAAcA,CAAQ,SACnC;GAET,AADA,SAAS,oBAAoB,aAAaA,CAAQ,GAClD,SAAS,oBAAoB,cAAcA,CAAQ;EACvD;CACJ,GAAG,CAACJ,CAAU,CAAC,GAERF;AACX"}