@cats-inc/cats-platform 0.1.0

package/build/server/app/renderer/entities-shell/entitiesExitMemory.js

@@ -0,0 +1,28 @@
+import { isPlatformEntityPath } from '../../../shared/platformRoutePaths.js';
+import { createSurfaceExitMemory } from '../surfaceExitMemory.js';
+// Cats Directory's exit-memory tracker. Built on the shared
+// `createSurfaceExitMemory` factory so the back button in
+// `EntitiesAppShellSidebar` can compute the same kind of history
+// delta the Settings × button uses — clicking it lands on whatever
+// non-Entities surface the user came from (chat, work, code, lobby),
+// skipping any in-Entities navigations along the way.
+//
+// Lifecycle mirrors Settings: every non-Entities path visit clears
+// the snapshot and marks "we've seen a home surface"; the next entry
+// from a non-Entities path snapshots `idx - 1` as the return target;
+// in-Entities navigations keep that snapshot stable. Cold mount on a
+// deep `/entities/...` URL (bookmark, tray, hard reload) leaves the
+// snapshot null, and the back button falls back to `/lobby` with
+// replace.
+const memory = createSurfaceExitMemory({ isInside: isPlatformEntityPath });
+export function recordEntitiesRouteTransition(pathname, idx) {
+    memory.record(pathname, idx);
+}
+export function getEntitiesExitDelta(currentIdx) {
+    return memory.getExitDelta(currentIdx);
+}
+// Test-only: reset module state for isolation between test cases.
+export function __resetEntitiesExitMemoryForTests() {
+    memory.__resetForTests();
+}
+//# sourceMappingURL=entitiesExitMemory.js.map

package/build/server/app/renderer/entities-shell/entitiesExitMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitiesExitMemory.js","sourceRoot":"","sources":["../../../../../src/app/renderer/entities-shell/entitiesExitMemory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,4DAA4D;AAC5D,0DAA0D;AAC1D,iEAAiE;AACjE,mEAAmE;AACnE,qEAAqE;AACrE,sDAAsD;AACtD,EAAE;AACF,mEAAmE;AACnE,qEAAqE;AACrE,qEAAqE;AACrE,qEAAqE;AACrE,oEAAoE;AACpE,iEAAiE;AACjE,WAAW;AAEX,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;AAE3E,MAAM,UAAU,6BAA6B,CAC3C,QAAgB,EAChB,GAAuB;IAEvB,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAA8B;IAE9B,OAAO,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iCAAiC;IAC/C,MAAM,CAAC,eAAe,EAAE,CAAC;AAC3B,CAAC"}

package/build/server/app/renderer/guideCatPlacement.d.ts

@@ -0,0 +1,92 @@
+import type { GuideCatFloatingAnchor, GuideCatPlacement } from '../../shared/platform-contract.js';
+export type GuideCatSurfaceClass = 'lobby' | 'workspace' | 'hidden';
+export type GuideCatDockSlotKind = 'lobby' | 'workspace';
+export type GuideCatPlacementOverrideReason = 'narrow_layout' | 'collision_reflow' | null;
+export interface GuideCatViewportRect {
+    width: number;
+    height: number;
+}
+export interface GuideCatSafeArea {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export interface GuideCatSlotRect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export declare function resolveGuideCatSurfaceClass(pathname: string, placement?: GuideCatPlacement): GuideCatSurfaceClass;
+export declare const FLOATING_PILL_RADIUS_PX: number;
+export declare const GUIDE_CAT_UNDOCK_ESCAPE_THRESHOLD_PX = 24;
+export declare const GUIDE_CAT_DRAG_MOVEMENT_THRESHOLD_PX = 4;
+export declare function hasDragMovement(input: {
+    startX: number;
+    startY: number;
+    currentX: number;
+    currentY: number;
+}): boolean;
+export declare function resolveGuideCatSafeArea(input: {
+    surface: GuideCatSurfaceClass;
+    viewport: GuideCatViewportRect;
+    topChromeBottom: number | null;
+    sidebarRight: number | null;
+    rightBlockedLeft?: number | null;
+}): GuideCatSafeArea;
+export declare function clampFloatingAnchorToSafeArea(input: {
+    anchor: GuideCatFloatingAnchor;
+    viewport: GuideCatViewportRect;
+    safeArea: GuideCatSafeArea;
+}): {
+    x: number;
+    y: number;
+};
+export declare function projectFloatingAnchorToNormalized(input: {
+    pointerX: number;
+    pointerY: number;
+    viewport: GuideCatViewportRect;
+}): GuideCatFloatingAnchor;
+export declare function resolveEffectiveFloatingAnchor(anchor: GuideCatFloatingAnchor | null): GuideCatFloatingAnchor;
+export type GuideCatFloatingReleaseCommit = {
+    floatingAnchor: GuideCatFloatingAnchor;
+} | {
+    placement: 'floating';
+    floatingAnchor: GuideCatFloatingAnchor;
+};
+export declare function resolveGuideCatFloatingReleaseCommit(input: {
+    pointerX: number;
+    pointerY: number;
+    viewport: GuideCatViewportRect;
+    safeArea: GuideCatSafeArea;
+    undock?: boolean;
+}): GuideCatFloatingReleaseCommit;
+export declare function isPointerOverSlotCorridor(input: {
+    pointerX: number;
+    pointerY: number;
+    slotRect: GuideCatSlotRect | null;
+}): boolean;
+export declare function resolveActiveDockSlot(surface: GuideCatSurfaceClass): GuideCatDockSlotKind | null;
+export interface GuideCatFloatingProjection {
+    kind: 'floating';
+    x: number;
+    y: number;
+    overrideReason: GuideCatPlacementOverrideReason;
+}
+export interface GuideCatDockedProjection {
+    kind: 'docked';
+    slot: GuideCatDockSlotKind;
+}
+export interface GuideCatHiddenProjection {
+    kind: 'hidden';
+}
+export type GuideCatProjection = GuideCatHiddenProjection | GuideCatFloatingProjection | GuideCatDockedProjection;
+export declare function resolveGuideCatProjection(input: {
+    placement: GuideCatPlacement;
+    anchor: GuideCatFloatingAnchor | null;
+    surface: GuideCatSurfaceClass;
+    viewport: GuideCatViewportRect;
+    safeArea: GuideCatSafeArea;
+}): GuideCatProjection;
+//# sourceMappingURL=guideCatPlacement.d.ts.map

package/build/server/app/renderer/guideCatPlacement.d.ts.map

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

package/build/server/app/renderer/guideCatPlacement.js

@@ -0,0 +1,154 @@
+import { GUIDE_CAT_FLOATING_ANCHOR_DEFAULT } from '../../shared/platform-contract.js';
+import { isLobbyPath, isSetupPath } from '../../shared/platformRoutePaths.js';
+import { isSettingsPath } from '../../shared/settingsRoute.js';
+export function resolveGuideCatSurfaceClass(pathname, placement = 'floating') {
+    if (isSetupPath(pathname)) {
+        return 'hidden';
+    }
+    const isSettingsRoute = isSettingsPath(pathname);
+    if (isSettingsRoute) {
+        // When the pill is docked, the sidebar still renders in settings mode
+        // and the user can reasonably click the docked pill to open a peek.
+        // Only the floating placement needs settings to hide the pill (there is
+        // no floating surface to anchor against inside the settings layout).
+        return placement === 'docked' ? 'workspace' : 'hidden';
+    }
+    if (isLobbyPath(pathname)) {
+        return 'lobby';
+    }
+    return 'workspace';
+}
+const SAFE_AREA_MARGIN = 16;
+const FLOATING_PILL_DIAMETER = 28;
+export const FLOATING_PILL_RADIUS_PX = FLOATING_PILL_DIAMETER / 2;
+/* Padding around the dock slot rect that counts as "close enough to commit a
+   dock on release". Keep this tight — the slot itself is only ~32-44px, so a
+   larger padding would make the preview trigger from uncomfortably far away. */
+const DOCK_CORRIDOR_PADDING = 24;
+export const GUIDE_CAT_UNDOCK_ESCAPE_THRESHOLD_PX = 24;
+export const GUIDE_CAT_DRAG_MOVEMENT_THRESHOLD_PX = 4;
+export function hasDragMovement(input) {
+    const dx = input.currentX - input.startX;
+    const dy = input.currentY - input.startY;
+    return Math.hypot(dx, dy) >= GUIDE_CAT_DRAG_MOVEMENT_THRESHOLD_PX;
+}
+export function resolveGuideCatSafeArea(input) {
+    const { surface, viewport, topChromeBottom, sidebarRight, rightBlockedLeft = null, } = input;
+    // The safe area describes valid positions for the pill centre, so the pill
+    // radius is added on every edge to keep the visible pill a full
+    // SAFE_AREA_MARGIN away from chrome rather than half-overlapping it.
+    const leftChrome = surface === 'workspace' && sidebarRight != null
+        ? Math.max(SAFE_AREA_MARGIN, sidebarRight + SAFE_AREA_MARGIN)
+        : SAFE_AREA_MARGIN;
+    const topChrome = surface === 'lobby' && topChromeBottom != null
+        ? Math.max(SAFE_AREA_MARGIN, topChromeBottom + SAFE_AREA_MARGIN)
+        : SAFE_AREA_MARGIN;
+    const rightChrome = surface === 'workspace' && rightBlockedLeft != null
+        ? Math.min(viewport.width - SAFE_AREA_MARGIN, rightBlockedLeft - SAFE_AREA_MARGIN)
+        : viewport.width - SAFE_AREA_MARGIN;
+    const left = leftChrome + FLOATING_PILL_RADIUS_PX;
+    const top = topChrome + FLOATING_PILL_RADIUS_PX;
+    const right = Math.max(left + 1, rightChrome - FLOATING_PILL_RADIUS_PX);
+    const bottom = Math.max(top + 1, viewport.height - SAFE_AREA_MARGIN - FLOATING_PILL_RADIUS_PX);
+    return { left, top, right, bottom };
+}
+export function clampFloatingAnchorToSafeArea(input) {
+    const { anchor, viewport, safeArea } = input;
+    const rawX = anchor.x * viewport.width;
+    const rawY = anchor.y * viewport.height;
+    return {
+        x: Math.min(safeArea.right, Math.max(safeArea.left, rawX)),
+        y: Math.min(safeArea.bottom, Math.max(safeArea.top, rawY)),
+    };
+}
+export function projectFloatingAnchorToNormalized(input) {
+    const { pointerX, pointerY, viewport } = input;
+    if (viewport.width <= 0 || viewport.height <= 0) {
+        return { ...GUIDE_CAT_FLOATING_ANCHOR_DEFAULT };
+    }
+    return {
+        x: Math.min(1, Math.max(0, pointerX / viewport.width)),
+        y: Math.min(1, Math.max(0, pointerY / viewport.height)),
+    };
+}
+export function resolveEffectiveFloatingAnchor(anchor) {
+    return anchor ?? { ...GUIDE_CAT_FLOATING_ANCHOR_DEFAULT };
+}
+export function resolveGuideCatFloatingReleaseCommit(input) {
+    const anchor = projectFloatingAnchorToNormalized({
+        pointerX: input.pointerX,
+        pointerY: input.pointerY,
+        viewport: input.viewport,
+    });
+    const effective = resolveEffectiveFloatingAnchor(anchor);
+    const clamped = clampFloatingAnchorToSafeArea({
+        anchor: effective,
+        viewport: input.viewport,
+        safeArea: input.safeArea,
+    });
+    const floatingAnchor = projectFloatingAnchorToNormalized({
+        pointerX: clamped.x,
+        pointerY: clamped.y,
+        viewport: input.viewport,
+    });
+    return input.undock
+        ? {
+            placement: 'floating',
+            floatingAnchor,
+        }
+        : { floatingAnchor };
+}
+export function isPointerOverSlotCorridor(input) {
+    const { pointerX, pointerY, slotRect } = input;
+    if (!slotRect) {
+        return false;
+    }
+    return (pointerX >= slotRect.left - DOCK_CORRIDOR_PADDING
+        && pointerX <= slotRect.right + DOCK_CORRIDOR_PADDING
+        && pointerY >= slotRect.top - DOCK_CORRIDOR_PADDING
+        && pointerY <= slotRect.bottom + DOCK_CORRIDOR_PADDING);
+}
+export function resolveActiveDockSlot(surface) {
+    if (surface === 'lobby') {
+        return 'lobby';
+    }
+    if (surface === 'workspace') {
+        return 'workspace';
+    }
+    return null;
+}
+export function resolveGuideCatProjection(input) {
+    const { placement, anchor, surface, viewport, safeArea } = input;
+    if (surface === 'hidden') {
+        return { kind: 'hidden' };
+    }
+    if (placement === 'docked') {
+        const slot = resolveActiveDockSlot(surface);
+        if (slot) {
+            return { kind: 'docked', slot };
+        }
+        return { kind: 'hidden' };
+    }
+    const effective = resolveEffectiveFloatingAnchor(anchor);
+    const { x, y } = clampFloatingAnchorToSafeArea({
+        anchor: effective,
+        viewport,
+        safeArea,
+    });
+    const clampedAnchor = projectFloatingAnchorToNormalized({
+        pointerX: x,
+        pointerY: y,
+        viewport,
+    });
+    const overrideReason = Math.abs(clampedAnchor.x - effective.x) > 0.001
+        || Math.abs(clampedAnchor.y - effective.y) > 0.001
+        ? 'collision_reflow'
+        : null;
+    return {
+        kind: 'floating',
+        x,
+        y,
+        overrideReason,
+    };
+}
+//# sourceMappingURL=guideCatPlacement.js.map

package/build/server/app/renderer/guideCatPlacement.js.map

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

package/build/server/app/renderer/guideCatUiPrefsStore.d.ts

@@ -0,0 +1,66 @@
+import type { GuideCatFloatingAnchor, GuideCatPlacement, GuideCatSidecarMode } from '../../shared/platform-contract.js';
+export declare const GUIDE_CAT_UI_PREFS_STORAGE_KEY = "cats.guide-cat-ui-prefs";
+export declare const GUIDE_CAT_UI_PREFS_SCHEMA_VERSION = 1;
+export interface GuideCatUiPrefs {
+    sidecarSeen: boolean;
+    sidecarMode: GuideCatSidecarMode;
+    placement: GuideCatPlacement;
+    floatingAnchor: GuideCatFloatingAnchor | null;
+}
+export interface GuideCatUiPrefsPatch {
+    sidecarSeen?: boolean;
+    sidecarMode?: GuideCatSidecarMode;
+    placement?: GuideCatPlacement;
+    floatingAnchor?: GuideCatFloatingAnchor | null;
+}
+interface GuideCatUiPrefsStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+type GuideCatUiPrefsListener = () => void;
+export interface GuideCatUiPrefsHydrationResult {
+    prefs: GuideCatUiPrefs;
+    source: 'local' | 'defaults';
+    persisted: boolean;
+}
+export declare const GUIDE_CAT_UI_PREFS_DEFAULTS: GuideCatUiPrefs;
+export interface UseGuideCatUiPrefsOptions {
+    hydrate?: boolean;
+}
+export interface UseGuideCatUiPrefsResult {
+    prefs: GuideCatUiPrefs;
+    hydrated: boolean;
+    update: (patch: GuideCatUiPrefsPatch) => void;
+}
+export declare function mergeGuideCatUiPrefs(current: GuideCatUiPrefs, patch: GuideCatUiPrefsPatch): GuideCatUiPrefs;
+export declare function parseStoredGuideCatUiPrefs(raw: string | null | undefined): GuideCatUiPrefs | null;
+export declare function serializeGuideCatUiPrefs(prefs: GuideCatUiPrefs): string;
+export declare function readStoredGuideCatUiPrefs(storage: GuideCatUiPrefsStorage | null | undefined): GuideCatUiPrefs | null;
+export declare function writeStoredGuideCatUiPrefs(storage: GuideCatUiPrefsStorage | null | undefined, prefs: GuideCatUiPrefs): {
+    persisted: boolean;
+    prefs: GuideCatUiPrefs;
+};
+export declare function hydrateGuideCatUiPrefs(options: {
+    storage: GuideCatUiPrefsStorage | null | undefined;
+}): GuideCatUiPrefsHydrationResult;
+export declare class GuideCatUiPrefsStore {
+    private readonly storage;
+    private prefs;
+    private hydrated;
+    private listeners;
+    private storageListening;
+    constructor(storage: GuideCatUiPrefsStorage | null | undefined);
+    getSnapshot: () => GuideCatUiPrefs;
+    isHydrated(): boolean;
+    subscribe: (listener: GuideCatUiPrefsListener) => (() => void);
+    ensureHydrated(): void;
+    update(patch: GuideCatUiPrefsPatch): void;
+    private emit;
+    private ensureStorageListener;
+    private teardownStorageListener;
+    private readonly handleStorageEvent;
+}
+export declare function createGuideCatUiPrefsStore(storage: GuideCatUiPrefsStorage | null | undefined): GuideCatUiPrefsStore;
+export declare function useGuideCatUiPrefs(options?: UseGuideCatUiPrefsOptions): UseGuideCatUiPrefsResult;
+export {};
+//# sourceMappingURL=guideCatUiPrefsStore.d.ts.map

package/build/server/app/renderer/guideCatUiPrefsStore.d.ts.map

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

package/build/server/app/renderer/guideCatUiPrefsStore.js

@@ -0,0 +1,291 @@
+import { useCallback, useEffect, useLayoutEffect, useMemo, useState, useSyncExternalStore, } from 'react';
+export const GUIDE_CAT_UI_PREFS_STORAGE_KEY = 'cats.guide-cat-ui-prefs';
+export const GUIDE_CAT_UI_PREFS_SCHEMA_VERSION = 1;
+export const GUIDE_CAT_UI_PREFS_DEFAULTS = {
+    sidecarSeen: false,
+    sidecarMode: 'auto',
+    placement: 'floating',
+    floatingAnchor: null,
+};
+const warnedInvalidGuideCatUiPrefsContexts = new Set();
+function readBrowserGlobal() {
+    const candidate = globalThis;
+    if (typeof candidate.addEventListener !== 'function'
+        || typeof candidate.removeEventListener !== 'function') {
+        return null;
+    }
+    return candidate;
+}
+function useIsoLayoutEffect(effect, deps) {
+    const hook = readBrowserGlobal() === null ? useEffect : useLayoutEffect;
+    hook(effect, deps);
+}
+function normalizeFloatingAnchor(value) {
+    if (typeof value !== 'object' || value === null) {
+        return null;
+    }
+    const record = value;
+    const x = record.x;
+    const y = record.y;
+    if (typeof x !== 'number' || typeof y !== 'number') {
+        return null;
+    }
+    if (!Number.isFinite(x) || !Number.isFinite(y)) {
+        return null;
+    }
+    return {
+        x: Math.min(1, Math.max(0, x)),
+        y: Math.min(1, Math.max(0, y)),
+    };
+}
+function normalizeSidecarMode(value) {
+    return value === 'auto' || value === 'drawer' || value === 'bubble'
+        ? value
+        : GUIDE_CAT_UI_PREFS_DEFAULTS.sidecarMode;
+}
+function normalizePlacement(value) {
+    return value === 'floating' || value === 'docked'
+        ? value
+        : GUIDE_CAT_UI_PREFS_DEFAULTS.placement;
+}
+export function mergeGuideCatUiPrefs(current, patch) {
+    return {
+        sidecarSeen: patch.sidecarSeen ?? current.sidecarSeen,
+        sidecarMode: patch.sidecarMode ?? current.sidecarMode,
+        placement: patch.placement ?? current.placement,
+        floatingAnchor: patch.floatingAnchor !== undefined ? patch.floatingAnchor : current.floatingAnchor,
+    };
+}
+export function parseStoredGuideCatUiPrefs(raw) {
+    if (!raw) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null) {
+            return null;
+        }
+        const record = parsed;
+        // Future: when bumping the schema version, add a case that parses older
+        // records and migrates them in memory before returning the current shape.
+        switch (record.version) {
+            case GUIDE_CAT_UI_PREFS_SCHEMA_VERSION:
+                return {
+                    sidecarSeen: record.sidecarSeen === true,
+                    sidecarMode: normalizeSidecarMode(record.sidecarMode),
+                    placement: normalizePlacement(record.placement),
+                    floatingAnchor: normalizeFloatingAnchor(record.floatingAnchor),
+                };
+            default:
+                return null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+function warnInvalidGuideCatUiPrefsRecord(context) {
+    if (warnedInvalidGuideCatUiPrefsContexts.has(context)) {
+        return;
+    }
+    warnedInvalidGuideCatUiPrefsContexts.add(context);
+    globalThis.console?.warn?.(`[guide-cat-ui-prefs] Ignoring unsupported or malformed stored prefs during ${context}.`);
+}
+export function serializeGuideCatUiPrefs(prefs) {
+    const record = {
+        version: GUIDE_CAT_UI_PREFS_SCHEMA_VERSION,
+        sidecarSeen: prefs.sidecarSeen,
+        sidecarMode: prefs.sidecarMode,
+        placement: prefs.placement,
+        floatingAnchor: prefs.floatingAnchor ? { ...prefs.floatingAnchor } : null,
+    };
+    return JSON.stringify(record);
+}
+export function readStoredGuideCatUiPrefs(storage) {
+    if (!storage) {
+        return null;
+    }
+    try {
+        return parseStoredGuideCatUiPrefs(storage.getItem(GUIDE_CAT_UI_PREFS_STORAGE_KEY));
+    }
+    catch {
+        return null;
+    }
+}
+function readStoredGuideCatUiPrefsRaw(storage) {
+    if (!storage) {
+        return null;
+    }
+    try {
+        return storage.getItem(GUIDE_CAT_UI_PREFS_STORAGE_KEY);
+    }
+    catch {
+        return null;
+    }
+}
+export function writeStoredGuideCatUiPrefs(storage, prefs) {
+    if (!storage) {
+        return { persisted: false, prefs };
+    }
+    try {
+        storage.setItem(GUIDE_CAT_UI_PREFS_STORAGE_KEY, serializeGuideCatUiPrefs(prefs));
+        const readBack = readStoredGuideCatUiPrefs(storage);
+        if (readBack) {
+            return { persisted: true, prefs: readBack };
+        }
+    }
+    catch {
+        // Ignore storage failures and keep the in-memory value alive.
+    }
+    return { persisted: false, prefs };
+}
+export function hydrateGuideCatUiPrefs(options) {
+    const { storage } = options;
+    const storedRaw = readStoredGuideCatUiPrefsRaw(storage);
+    const stored = parseStoredGuideCatUiPrefs(storedRaw);
+    if (stored) {
+        return { prefs: stored, source: 'local', persisted: true };
+    }
+    if (storedRaw !== null) {
+        warnInvalidGuideCatUiPrefsRecord('bootstrap');
+        return {
+            prefs: { ...GUIDE_CAT_UI_PREFS_DEFAULTS },
+            source: 'defaults',
+            persisted: false,
+        };
+    }
+    const prefs = { ...GUIDE_CAT_UI_PREFS_DEFAULTS };
+    const persisted = writeStoredGuideCatUiPrefs(storage, prefs).persisted;
+    return { prefs, source: 'defaults', persisted };
+}
+function areGuideCatUiPrefsEqual(a, b) {
+    return (a.sidecarSeen === b.sidecarSeen
+        && a.sidecarMode === b.sidecarMode
+        && a.placement === b.placement
+        && a.floatingAnchor?.x === b.floatingAnchor?.x
+        && a.floatingAnchor?.y === b.floatingAnchor?.y);
+}
+export class GuideCatUiPrefsStore {
+    storage;
+    prefs = { ...GUIDE_CAT_UI_PREFS_DEFAULTS };
+    hydrated = false;
+    listeners = new Set();
+    storageListening = false;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    getSnapshot = () => this.prefs;
+    isHydrated() {
+        return this.hydrated;
+    }
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        this.ensureStorageListener();
+        return () => {
+            this.listeners.delete(listener);
+            if (this.listeners.size === 0) {
+                this.teardownStorageListener();
+            }
+        };
+    };
+    ensureHydrated() {
+        if (this.hydrated) {
+            return;
+        }
+        const result = hydrateGuideCatUiPrefs({ storage: this.storage });
+        this.prefs = result.prefs;
+        this.hydrated = true;
+    }
+    update(patch) {
+        if (!this.hydrated) {
+            this.ensureHydrated();
+        }
+        const next = mergeGuideCatUiPrefs(this.prefs, patch);
+        if (areGuideCatUiPrefsEqual(this.prefs, next)) {
+            return;
+        }
+        const nextSnapshot = writeStoredGuideCatUiPrefs(this.storage, next).prefs;
+        this.prefs = nextSnapshot;
+        this.hydrated = true;
+        this.emit();
+    }
+    emit() {
+        this.listeners.forEach((listener) => listener());
+    }
+    ensureStorageListener() {
+        const browser = readBrowserGlobal();
+        if (!browser || this.storageListening) {
+            return;
+        }
+        browser.addEventListener?.('storage', this.handleStorageEvent);
+        this.storageListening = true;
+    }
+    teardownStorageListener() {
+        const browser = readBrowserGlobal();
+        if (!browser || !this.storageListening) {
+            return;
+        }
+        browser.removeEventListener?.('storage', this.handleStorageEvent);
+        this.storageListening = false;
+    }
+    handleStorageEvent = (event) => {
+        if (event.key !== GUIDE_CAT_UI_PREFS_STORAGE_KEY) {
+            return;
+        }
+        if (event.newValue === null) {
+            const next = { ...GUIDE_CAT_UI_PREFS_DEFAULTS };
+            if (areGuideCatUiPrefsEqual(this.prefs, next)) {
+                return;
+            }
+            this.prefs = next;
+            this.hydrated = true;
+            this.emit();
+            return;
+        }
+        const next = parseStoredGuideCatUiPrefs(event.newValue);
+        if (!next) {
+            warnInvalidGuideCatUiPrefsRecord('storage-event');
+            return;
+        }
+        if (areGuideCatUiPrefsEqual(this.prefs, next)) {
+            return;
+        }
+        this.prefs = next;
+        this.hydrated = true;
+        this.emit();
+    };
+}
+export function createGuideCatUiPrefsStore(storage) {
+    return new GuideCatUiPrefsStore(storage);
+}
+let guideCatUiPrefsStore = null;
+function getBrowserGuideCatUiPrefsStore() {
+    if (!guideCatUiPrefsStore) {
+        guideCatUiPrefsStore = createGuideCatUiPrefsStore(readBrowserGlobal()?.localStorage ?? null);
+    }
+    return guideCatUiPrefsStore;
+}
+export function useGuideCatUiPrefs(options = {}) {
+    const { hydrate = true, } = options;
+    const store = useMemo(() => readBrowserGlobal() === null
+        ? createGuideCatUiPrefsStore(null)
+        : getBrowserGuideCatUiPrefsStore(), []);
+    const [, setHydrationTick] = useState(0);
+    useIsoLayoutEffect(() => {
+        if (!hydrate || store.isHydrated()) {
+            return;
+        }
+        store.ensureHydrated();
+        setHydrationTick((current) => current + 1);
+    }, [hydrate, store]);
+    const prefs = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+    const update = useCallback((patch) => {
+        store.update(patch);
+    }, [store]);
+    return {
+        prefs,
+        hydrated: hydrate && store.isHydrated(),
+        update,
+    };
+}
+//# sourceMappingURL=guideCatUiPrefsStore.js.map