@tearleads/windowing 0.1.1

package/window/WindowMenuContext.d.ts

@@ -0,0 +1,46 @@
+import { type PropsWithChildren } from "react";
+import { type WindowBackAction, type WindowBackActionInput, type WindowTitleBarActionInput } from "./WindowChromeActions.js";
+import type { WindowMenuItem } from "./WindowMenuBar.js";
+import type { WindowTitleBarAction } from "./WindowTitleBar.js";
+interface WindowRefreshMenuItemInput {
+    disabled?: boolean;
+    label?: string;
+    onRefresh: () => unknown;
+    priority?: number;
+    refreshing?: boolean;
+}
+interface WindowFileMenuItemInput {
+    disabled?: boolean;
+    id: string;
+    label: string;
+    onClick: () => unknown;
+    priority?: number;
+}
+export declare function WindowMenuProvider({ children }: PropsWithChildren): import("react").JSX.Element;
+export declare function useWindowFileMenuItems(): WindowMenuItem[];
+export declare function useWindowViewMenuItems(): WindowMenuItem[];
+export declare function useWindowRefreshMenuItemValue(): WindowMenuItem | null;
+export declare function useWindowTitleBarActions(): WindowTitleBarAction[];
+export declare function useWindowBackActionValue(): WindowBackAction | null;
+export declare function useWindowToolbarReserved(): boolean;
+export declare function useWindowToolbarReservationReleased(): boolean;
+export declare function useWindowFileMenuItem(item: WindowFileMenuItemInput | null): void;
+export declare function useWindowViewMenuItem(item: WindowFileMenuItemInput | null): void;
+/**
+ * Registers an action in the current window's title bar.
+ *
+ * Keep `item` and its `icon` reference-stable, such as by memoizing them with
+ * `useMemo`, so the window does not re-register the action on every render.
+ */
+export declare function useWindowTitleBarAction(item: WindowTitleBarActionInput | null): void;
+export declare function useWindowBackAction(item: WindowBackActionInput | null): void;
+/**
+ * Keeps this window's toolbar row reserved (rendered) while the caller is
+ * mounted, even when it registers no title-bar or back actions. A mini-app that
+ * wants explorer-style chrome on every route — a blank bar on the routes that
+ * have no actions rather than a collapsing/reappearing row — calls this once.
+ * Pass `reserve = false` to release the reservation without unmounting.
+ */
+export declare function useWindowToolbarReservation(reserve?: boolean): void;
+export declare function useWindowRefreshMenuItem(item: WindowRefreshMenuItemInput | null): void;
+export {};

package/window/WindowMenuContext.js

@@ -0,0 +1,208 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef, } from "react";
+import { useWindowItemRegistration } from "./useWindowItemRegistration.js";
+import { sameWindowItem, selectHighestPriorityItem, useWindowItemRegistry, } from "./useWindowItemRegistry.js";
+import { useWindowToolbarReservationRegistry } from "./useWindowToolbarReservationRegistry.js";
+import { createBackAction, createRegisteredBackAction, createRegisteredTitleBarAction, createTitleBarActions, } from "./WindowChromeActions.js";
+import { createMenuItems, createRefreshMenuItem, REFRESH_LABEL, } from "./windowMenuRegistrations.js";
+function createRegisteredMenuItem(item, onClick) {
+    return {
+        disabled: item.disabled ?? false,
+        id: item.id,
+        label: item.label,
+        onClick,
+        priority: item.priority ?? 0,
+    };
+}
+function createRegisteredRefreshMenuItem(item, onRefresh) {
+    return {
+        disabled: item.disabled ?? false,
+        label: item.label ?? REFRESH_LABEL,
+        onRefresh,
+        priority: item.priority ?? 0,
+        refreshing: item.refreshing ?? false,
+    };
+}
+const WindowMenuContext = createContext({
+    fileMenuItems: [],
+    viewMenuItems: [],
+    refreshMenuItem: null,
+    titleBarActions: [],
+    backAction: null,
+    toolbarReserved: false,
+    toolbarReservationReleased: false,
+    registerFileMenuItem: () => { },
+    unregisterFileMenuItem: () => { },
+    registerViewMenuItem: () => { },
+    unregisterViewMenuItem: () => { },
+    registerTitleBarAction: () => { },
+    unregisterTitleBarAction: () => { },
+    registerBackAction: () => { },
+    unregisterBackAction: () => { },
+    registerRefreshMenuItem: () => { },
+    unregisterRefreshMenuItem: () => { },
+    registerToolbarReservation: () => { },
+    unregisterToolbarReservation: () => { },
+});
+function useWindowMenuContextValue() {
+    const fileMenu = useWindowItemRegistry(sameWindowItem);
+    const viewMenu = useWindowItemRegistry(sameWindowItem);
+    const titleBar = useWindowItemRegistry(sameWindowItem);
+    const back = useWindowItemRegistry(sameWindowItem);
+    const refresh = useWindowItemRegistry(sameWindowItem);
+    const toolbarReservation = useWindowToolbarReservationRegistry();
+    const fileMenuItemList = useMemo(() => createMenuItems(fileMenu.items), [fileMenu.items]);
+    const refreshMenuItem = useMemo(() => createRefreshMenuItem(selectHighestPriorityItem(refresh.items)), [refresh.items]);
+    const viewMenuItemList = useMemo(() => [
+        ...createMenuItems(viewMenu.items),
+        ...(refreshMenuItem ? [refreshMenuItem] : []),
+    ], [refreshMenuItem, viewMenu.items]);
+    const titleBarActionList = useMemo(() => createTitleBarActions(titleBar.items), [titleBar.items]);
+    const backAction = useMemo(() => createBackAction(selectHighestPriorityItem(back.items)), [back.items]);
+    const value = useMemo(() => ({
+        fileMenuItems: fileMenuItemList,
+        viewMenuItems: viewMenuItemList,
+        refreshMenuItem,
+        titleBarActions: titleBarActionList,
+        backAction,
+        toolbarReserved: toolbarReservation.reserved,
+        toolbarReservationReleased: toolbarReservation.released,
+        registerFileMenuItem: fileMenu.registerItem,
+        unregisterFileMenuItem: fileMenu.unregisterItem,
+        registerViewMenuItem: viewMenu.registerItem,
+        unregisterViewMenuItem: viewMenu.unregisterItem,
+        registerTitleBarAction: titleBar.registerItem,
+        unregisterTitleBarAction: titleBar.unregisterItem,
+        registerBackAction: back.registerItem,
+        unregisterBackAction: back.unregisterItem,
+        registerRefreshMenuItem: refresh.registerItem,
+        unregisterRefreshMenuItem: refresh.unregisterItem,
+        registerToolbarReservation: toolbarReservation.register,
+        unregisterToolbarReservation: toolbarReservation.unregister,
+    }), [
+        fileMenuItemList,
+        viewMenuItemList,
+        refreshMenuItem,
+        titleBarActionList,
+        backAction,
+        toolbarReservation,
+        fileMenu.registerItem,
+        fileMenu.unregisterItem,
+        viewMenu.registerItem,
+        viewMenu.unregisterItem,
+        titleBar.registerItem,
+        titleBar.unregisterItem,
+        back.registerItem,
+        back.unregisterItem,
+        refresh.registerItem,
+        refresh.unregisterItem,
+    ]);
+    return value;
+}
+export function WindowMenuProvider({ children }) {
+    const value = useWindowMenuContextValue();
+    return (_jsx(WindowMenuContext.Provider, { value: value, children: children }));
+}
+export function useWindowFileMenuItems() {
+    return useContext(WindowMenuContext).fileMenuItems;
+}
+export function useWindowViewMenuItems() {
+    return useContext(WindowMenuContext).viewMenuItems;
+}
+export function useWindowRefreshMenuItemValue() {
+    return useContext(WindowMenuContext).refreshMenuItem;
+}
+export function useWindowTitleBarActions() {
+    return useContext(WindowMenuContext).titleBarActions;
+}
+export function useWindowBackActionValue() {
+    return useContext(WindowMenuContext).backAction;
+}
+export function useWindowToolbarReserved() {
+    return useContext(WindowMenuContext).toolbarReserved;
+}
+export function useWindowToolbarReservationReleased() {
+    return useContext(WindowMenuContext).toolbarReservationReleased;
+}
+function useRegisteredWindowMenuItem(item, registerMenuItem, unregisterMenuItem) {
+    useWindowItemRegistration({
+        action: item?.onClick ?? null,
+        createRegisteredItem: createRegisteredMenuItem,
+        input: item,
+        registerItem: registerMenuItem,
+        unregisterItem: unregisterMenuItem,
+    });
+}
+export function useWindowFileMenuItem(item) {
+    const { registerFileMenuItem, unregisterFileMenuItem } = useContext(WindowMenuContext);
+    useRegisteredWindowMenuItem(item, registerFileMenuItem, unregisterFileMenuItem);
+}
+export function useWindowViewMenuItem(item) {
+    const { registerViewMenuItem, unregisterViewMenuItem } = useContext(WindowMenuContext);
+    useRegisteredWindowMenuItem(item, registerViewMenuItem, unregisterViewMenuItem);
+}
+/**
+ * Registers an action in the current window's title bar.
+ *
+ * Keep `item` and its `icon` reference-stable, such as by memoizing them with
+ * `useMemo`, so the window does not re-register the action on every render.
+ */
+export function useWindowTitleBarAction(item) {
+    const { registerTitleBarAction, unregisterTitleBarAction } = useContext(WindowMenuContext);
+    useWindowItemRegistration({
+        action: item?.onClick ?? null,
+        createRegisteredItem: createRegisteredTitleBarAction,
+        input: item,
+        registerItem: registerTitleBarAction,
+        unregisterItem: unregisterTitleBarAction,
+    });
+}
+export function useWindowBackAction(item) {
+    const { registerBackAction, unregisterBackAction } = useContext(WindowMenuContext);
+    useWindowItemRegistration({
+        action: item?.onClick ?? null,
+        createRegisteredItem: createRegisteredBackAction,
+        input: item,
+        registerItem: registerBackAction,
+        unregisterItem: unregisterBackAction,
+    });
+}
+/**
+ * Keeps this window's toolbar row reserved (rendered) while the caller is
+ * mounted, even when it registers no title-bar or back actions. A mini-app that
+ * wants explorer-style chrome on every route — a blank bar on the routes that
+ * have no actions rather than a collapsing/reappearing row — calls this once.
+ * Pass `reserve = false` to release the reservation without unmounting.
+ */
+export function useWindowToolbarReservation(reserve = true) {
+    const { registerToolbarReservation, unregisterToolbarReservation } = useContext(WindowMenuContext);
+    const idRef = useRef({});
+    const hasEverReservedRef = useRef(false);
+    useEffect(() => {
+        const id = idRef.current;
+        if (reserve) {
+            hasEverReservedRef.current = true;
+            registerToolbarReservation(id, true);
+            return () => unregisterToolbarReservation(id);
+        }
+        if (!hasEverReservedRef.current) {
+            return;
+        }
+        // A caller that previously reserved the row is now explicitly releasing it.
+        // This lets WindowToolBar clear its latched blank row while callers that
+        // never opted into reservations keep the older latch-once behavior.
+        registerToolbarReservation(id, false);
+        return () => unregisterToolbarReservation(id);
+    }, [reserve, registerToolbarReservation, unregisterToolbarReservation]);
+}
+export function useWindowRefreshMenuItem(item) {
+    const { registerRefreshMenuItem, unregisterRefreshMenuItem } = useContext(WindowMenuContext);
+    useWindowItemRegistration({
+        action: item?.onRefresh ?? null,
+        createRegisteredItem: createRegisteredRefreshMenuItem,
+        input: item,
+        registerItem: registerRefreshMenuItem,
+        unregisterItem: unregisterRefreshMenuItem,
+    });
+}
+//# sourceMappingURL=WindowMenuContext.js.map

package/window/WindowMenuContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowMenuContext.js","sourceRoot":"","sources":["../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowMenuContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EAEb,UAAU,EACV,SAAS,EACT,OAAO,EACP,MAAM,GACP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAC5F,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,GAMtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,aAAa,GAGd,MAAM,2BAA2B,CAAC;AAkBnC,SAAS,wBAAwB,CAC/B,IAA6B,EAC7B,OAAsB;IAEtB,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;QAChC,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,IAAgC,EAChC,SAAwB;IAExB,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;QAChC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,aAAa;QAClC,SAAS;QACT,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;QAC5B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;KACrC,CAAC;AACJ,CAAC;AAmCD,MAAM,iBAAiB,GAAG,aAAa,CAAyB;IAC9D,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,EAAE;IACnB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,KAAK;IACtB,0BAA0B,EAAE,KAAK;IACjC,oBAAoB,EAAE,GAAG,EAAE,GAAE,CAAC;IAC9B,sBAAsB,EAAE,GAAG,EAAE,GAAE,CAAC;IAChC,oBAAoB,EAAE,GAAG,EAAE,GAAE,CAAC;IAC9B,sBAAsB,EAAE,GAAG,EAAE,GAAE,CAAC;IAChC,sBAAsB,EAAE,GAAG,EAAE,GAAE,CAAC;IAChC,wBAAwB,EAAE,GAAG,EAAE,GAAE,CAAC;IAClC,kBAAkB,EAAE,GAAG,EAAE,GAAE,CAAC;IAC5B,oBAAoB,EAAE,GAAG,EAAE,GAAE,CAAC;IAC9B,uBAAuB,EAAE,GAAG,EAAE,GAAE,CAAC;IACjC,yBAAyB,EAAE,GAAG,EAAE,GAAE,CAAC;IACnC,0BAA0B,EAAE,GAAG,EAAE,GAAE,CAAC;IACpC,4BAA4B,EAAE,GAAG,EAAE,GAAE,CAAC;CACvC,CAAC,CAAC;AAEH,SAAS,yBAAyB;IAChC,MAAM,QAAQ,GACZ,qBAAqB,CAA2B,cAAc,CAAC,CAAC;IAClE,MAAM,QAAQ,GACZ,qBAAqB,CAA2B,cAAc,CAAC,CAAC;IAClE,MAAM,QAAQ,GACZ,qBAAqB,CAAiC,cAAc,CAAC,CAAC;IACxE,MAAM,IAAI,GACR,qBAAqB,CAA6B,cAAc,CAAC,CAAC;IACpE,MAAM,OAAO,GACX,qBAAqB,CAAkC,cAAc,CAAC,CAAC;IACzE,MAAM,kBAAkB,GAAG,mCAAmC,EAAE,CAAC;IAEjE,MAAM,gBAAgB,GAAG,OAAO,CAC9B,GAAG,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EACrC,CAAC,QAAQ,CAAC,KAAK,CAAC,CACjB,CAAC;IACF,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EACrE,CAAC,OAAO,CAAC,KAAK,CAAC,CAChB,CAAC;IACF,MAAM,gBAAgB,GAAG,OAAO,CAC9B,GAAG,EAAE,CAAC;QACJ,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC;QAClC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,EACD,CAAC,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,CAClC,CAAC;IACF,MAAM,kBAAkB,GAAG,OAAO,CAChC,GAAG,EAAE,CAAC,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC3C,CAAC,QAAQ,CAAC,KAAK,CAAC,CACjB,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CACxB,GAAG,EAAE,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAC7D,CAAC,IAAI,CAAC,KAAK,CAAC,CACb,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,aAAa,EAAE,gBAAgB;QAC/B,aAAa,EAAE,gBAAgB;QAC/B,eAAe;QACf,eAAe,EAAE,kBAAkB;QACnC,UAAU;QACV,eAAe,EAAE,kBAAkB,CAAC,QAAQ;QAC5C,0BAA0B,EAAE,kBAAkB,CAAC,QAAQ;QACvD,oBAAoB,EAAE,QAAQ,CAAC,YAAY;QAC3C,sBAAsB,EAAE,QAAQ,CAAC,cAAc;QAC/C,oBAAoB,EAAE,QAAQ,CAAC,YAAY;QAC3C,sBAAsB,EAAE,QAAQ,CAAC,cAAc;QAC/C,sBAAsB,EAAE,QAAQ,CAAC,YAAY;QAC7C,wBAAwB,EAAE,QAAQ,CAAC,cAAc;QACjD,kBAAkB,EAAE,IAAI,CAAC,YAAY;QACrC,oBAAoB,EAAE,IAAI,CAAC,cAAc;QACzC,uBAAuB,EAAE,OAAO,CAAC,YAAY;QAC7C,yBAAyB,EAAE,OAAO,CAAC,cAAc;QACjD,0BAA0B,EAAE,kBAAkB,CAAC,QAAQ;QACvD,4BAA4B,EAAE,kBAAkB,CAAC,UAAU;KAC5D,CAAC,EACF;QACE,gBAAgB;QAChB,gBAAgB;QAChB,eAAe;QACf,kBAAkB;QAClB,UAAU;QACV,kBAAkB;QAClB,QAAQ,CAAC,YAAY;QACrB,QAAQ,CAAC,cAAc;QACvB,QAAQ,CAAC,YAAY;QACrB,QAAQ,CAAC,cAAc;QACvB,QAAQ,CAAC,YAAY;QACrB,QAAQ,CAAC,cAAc;QACvB,IAAI,CAAC,YAAY;QACjB,IAAI,CAAC,cAAc;QACnB,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,cAAc;KACvB,CACF,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAE,QAAQ,EAAqB;IAChE,MAAM,KAAK,GAAG,yBAAyB,EAAE,CAAC;IAE1C,OAAO,CACL,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACrC,QAAQ,GACkB,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC,aAAa,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC,aAAa,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC,eAAe,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC,eAAe,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC,UAAU,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC,eAAe,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC,0BAA0B,CAAC;AAClE,CAAC;AAED,SAAS,2BAA2B,CAClC,IAAoC,EACpC,gBAAsE,EACtE,kBAAwC;IAExC,yBAAyB,CAAC;QACxB,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC7B,oBAAoB,EAAE,wBAAwB;QAC9C,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,gBAAgB;QAC9B,cAAc,EAAE,kBAAkB;KACnC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAoC;IAEpC,MAAM,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,GACpD,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,2BAA2B,CACzB,IAAI,EACJ,oBAAoB,EACpB,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAoC;IAEpC,MAAM,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,GACpD,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,2BAA2B,CACzB,IAAI,EACJ,oBAAoB,EACpB,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAsC;IAEtC,MAAM,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,GACxD,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,yBAAyB,CAAC;QACxB,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC7B,oBAAoB,EAAE,8BAA8B;QACpD,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,sBAAsB;QACpC,cAAc,EAAE,wBAAwB;KACzC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAkC;IACpE,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,GAChD,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,yBAAyB,CAAC;QACxB,MAAM,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QAC7B,oBAAoB,EAAE,0BAA0B;QAChD,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,kBAAkB;QAChC,cAAc,EAAE,oBAAoB;KACrC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAO,GAAG,IAAI;IACxD,MAAM,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,GAChE,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IACjC,MAAM,kBAAkB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;QAEzB,IAAI,OAAO,EAAE,CAAC;YACZ,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAAC;YAClC,0BAA0B,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACrC,OAAO,GAAG,EAAE,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,4EAA4E;QAC5E,yEAAyE;QACzE,oEAAoE;QACpE,0BAA0B,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACtC,OAAO,GAAG,EAAE,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAuC;IAEvC,MAAM,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,GAC1D,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAChC,yBAAyB,CAAC;QACxB,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI;QAC/B,oBAAoB,EAAE,+BAA+B;QACrD,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,uBAAuB;QACrC,cAAc,EAAE,yBAAyB;KAC1C,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n} from \"react\";\nimport { useWindowItemRegistration } from \"./useWindowItemRegistration\";\nimport {\n  sameWindowItem,\n  selectHighestPriorityItem,\n  useWindowItemRegistry,\n} from \"./useWindowItemRegistry\";\nimport { useWindowToolbarReservationRegistry } from \"./useWindowToolbarReservationRegistry\";\nimport {\n  createBackAction,\n  createRegisteredBackAction,\n  createRegisteredTitleBarAction,\n  createTitleBarActions,\n  type RegisteredWindowBackAction,\n  type RegisteredWindowTitleBarAction,\n  type WindowBackAction,\n  type WindowBackActionInput,\n  type WindowTitleBarActionInput,\n} from \"./WindowChromeActions\";\nimport type { WindowMenuItem } from \"./WindowMenuBar\";\nimport type { WindowTitleBarAction } from \"./WindowTitleBar\";\nimport {\n  createMenuItems,\n  createRefreshMenuItem,\n  REFRESH_LABEL,\n  type RegisteredWindowMenuItem,\n  type RegisteredWindowRefreshMenuItem,\n} from \"./windowMenuRegistrations\";\n\ninterface WindowRefreshMenuItemInput {\n  disabled?: boolean;\n  label?: string;\n  onRefresh: () => unknown;\n  priority?: number;\n  refreshing?: boolean;\n}\n\ninterface WindowFileMenuItemInput {\n  disabled?: boolean;\n  id: string;\n  label: string;\n  onClick: () => unknown;\n  priority?: number;\n}\n\nfunction createRegisteredMenuItem(\n  item: WindowFileMenuItemInput,\n  onClick: () => unknown,\n): RegisteredWindowMenuItem {\n  return {\n    disabled: item.disabled ?? false,\n    id: item.id,\n    label: item.label,\n    onClick,\n    priority: item.priority ?? 0,\n  };\n}\n\nfunction createRegisteredRefreshMenuItem(\n  item: WindowRefreshMenuItemInput,\n  onRefresh: () => unknown,\n): RegisteredWindowRefreshMenuItem {\n  return {\n    disabled: item.disabled ?? false,\n    label: item.label ?? REFRESH_LABEL,\n    onRefresh,\n    priority: item.priority ?? 0,\n    refreshing: item.refreshing ?? false,\n  };\n}\n\ninterface WindowMenuContextValue {\n  fileMenuItems: WindowMenuItem[];\n  viewMenuItems: WindowMenuItem[];\n  /**\n   * The winning refresh registration, also folded into `viewMenuItems` for the\n   * windowed menu bar. Exposed on its own because the routed shell has no menu\n   * bar and renders it as an app bar toolbar button instead.\n   */\n  refreshMenuItem: WindowMenuItem | null;\n  titleBarActions: WindowTitleBarAction[];\n  backAction: WindowBackAction | null;\n  toolbarReserved: boolean;\n  toolbarReservationReleased: boolean;\n  registerFileMenuItem: (id: object, item: RegisteredWindowMenuItem) => void;\n  unregisterFileMenuItem: (id: object) => void;\n  registerViewMenuItem: (id: object, item: RegisteredWindowMenuItem) => void;\n  unregisterViewMenuItem: (id: object) => void;\n  registerTitleBarAction: (\n    id: object,\n    item: RegisteredWindowTitleBarAction,\n  ) => void;\n  unregisterTitleBarAction: (id: object) => void;\n  registerBackAction: (id: object, item: RegisteredWindowBackAction) => void;\n  unregisterBackAction: (id: object) => void;\n  registerRefreshMenuItem: (\n    id: object,\n    item: RegisteredWindowRefreshMenuItem,\n  ) => void;\n  unregisterRefreshMenuItem: (id: object) => void;\n  registerToolbarReservation: (id: object, reserved: boolean) => void;\n  unregisterToolbarReservation: (id: object) => void;\n}\n\nconst WindowMenuContext = createContext<WindowMenuContextValue>({\n  fileMenuItems: [],\n  viewMenuItems: [],\n  refreshMenuItem: null,\n  titleBarActions: [],\n  backAction: null,\n  toolbarReserved: false,\n  toolbarReservationReleased: false,\n  registerFileMenuItem: () => {},\n  unregisterFileMenuItem: () => {},\n  registerViewMenuItem: () => {},\n  unregisterViewMenuItem: () => {},\n  registerTitleBarAction: () => {},\n  unregisterTitleBarAction: () => {},\n  registerBackAction: () => {},\n  unregisterBackAction: () => {},\n  registerRefreshMenuItem: () => {},\n  unregisterRefreshMenuItem: () => {},\n  registerToolbarReservation: () => {},\n  unregisterToolbarReservation: () => {},\n});\n\nfunction useWindowMenuContextValue(): WindowMenuContextValue {\n  const fileMenu =\n    useWindowItemRegistry<RegisteredWindowMenuItem>(sameWindowItem);\n  const viewMenu =\n    useWindowItemRegistry<RegisteredWindowMenuItem>(sameWindowItem);\n  const titleBar =\n    useWindowItemRegistry<RegisteredWindowTitleBarAction>(sameWindowItem);\n  const back =\n    useWindowItemRegistry<RegisteredWindowBackAction>(sameWindowItem);\n  const refresh =\n    useWindowItemRegistry<RegisteredWindowRefreshMenuItem>(sameWindowItem);\n  const toolbarReservation = useWindowToolbarReservationRegistry();\n\n  const fileMenuItemList = useMemo(\n    () => createMenuItems(fileMenu.items),\n    [fileMenu.items],\n  );\n  const refreshMenuItem = useMemo(\n    () => createRefreshMenuItem(selectHighestPriorityItem(refresh.items)),\n    [refresh.items],\n  );\n  const viewMenuItemList = useMemo(\n    () => [\n      ...createMenuItems(viewMenu.items),\n      ...(refreshMenuItem ? [refreshMenuItem] : []),\n    ],\n    [refreshMenuItem, viewMenu.items],\n  );\n  const titleBarActionList = useMemo(\n    () => createTitleBarActions(titleBar.items),\n    [titleBar.items],\n  );\n  const backAction = useMemo(\n    () => createBackAction(selectHighestPriorityItem(back.items)),\n    [back.items],\n  );\n\n  const value = useMemo(\n    () => ({\n      fileMenuItems: fileMenuItemList,\n      viewMenuItems: viewMenuItemList,\n      refreshMenuItem,\n      titleBarActions: titleBarActionList,\n      backAction,\n      toolbarReserved: toolbarReservation.reserved,\n      toolbarReservationReleased: toolbarReservation.released,\n      registerFileMenuItem: fileMenu.registerItem,\n      unregisterFileMenuItem: fileMenu.unregisterItem,\n      registerViewMenuItem: viewMenu.registerItem,\n      unregisterViewMenuItem: viewMenu.unregisterItem,\n      registerTitleBarAction: titleBar.registerItem,\n      unregisterTitleBarAction: titleBar.unregisterItem,\n      registerBackAction: back.registerItem,\n      unregisterBackAction: back.unregisterItem,\n      registerRefreshMenuItem: refresh.registerItem,\n      unregisterRefreshMenuItem: refresh.unregisterItem,\n      registerToolbarReservation: toolbarReservation.register,\n      unregisterToolbarReservation: toolbarReservation.unregister,\n    }),\n    [\n      fileMenuItemList,\n      viewMenuItemList,\n      refreshMenuItem,\n      titleBarActionList,\n      backAction,\n      toolbarReservation,\n      fileMenu.registerItem,\n      fileMenu.unregisterItem,\n      viewMenu.registerItem,\n      viewMenu.unregisterItem,\n      titleBar.registerItem,\n      titleBar.unregisterItem,\n      back.registerItem,\n      back.unregisterItem,\n      refresh.registerItem,\n      refresh.unregisterItem,\n    ],\n  );\n\n  return value;\n}\n\nexport function WindowMenuProvider({ children }: PropsWithChildren) {\n  const value = useWindowMenuContextValue();\n\n  return (\n    <WindowMenuContext.Provider value={value}>\n      {children}\n    </WindowMenuContext.Provider>\n  );\n}\n\nexport function useWindowFileMenuItems(): WindowMenuItem[] {\n  return useContext(WindowMenuContext).fileMenuItems;\n}\n\nexport function useWindowViewMenuItems(): WindowMenuItem[] {\n  return useContext(WindowMenuContext).viewMenuItems;\n}\n\nexport function useWindowRefreshMenuItemValue(): WindowMenuItem | null {\n  return useContext(WindowMenuContext).refreshMenuItem;\n}\n\nexport function useWindowTitleBarActions(): WindowTitleBarAction[] {\n  return useContext(WindowMenuContext).titleBarActions;\n}\n\nexport function useWindowBackActionValue(): WindowBackAction | null {\n  return useContext(WindowMenuContext).backAction;\n}\n\nexport function useWindowToolbarReserved(): boolean {\n  return useContext(WindowMenuContext).toolbarReserved;\n}\n\nexport function useWindowToolbarReservationReleased(): boolean {\n  return useContext(WindowMenuContext).toolbarReservationReleased;\n}\n\nfunction useRegisteredWindowMenuItem(\n  item: WindowFileMenuItemInput | null,\n  registerMenuItem: (id: object, item: RegisteredWindowMenuItem) => void,\n  unregisterMenuItem: (id: object) => void,\n): void {\n  useWindowItemRegistration({\n    action: item?.onClick ?? null,\n    createRegisteredItem: createRegisteredMenuItem,\n    input: item,\n    registerItem: registerMenuItem,\n    unregisterItem: unregisterMenuItem,\n  });\n}\n\nexport function useWindowFileMenuItem(\n  item: WindowFileMenuItemInput | null,\n): void {\n  const { registerFileMenuItem, unregisterFileMenuItem } =\n    useContext(WindowMenuContext);\n  useRegisteredWindowMenuItem(\n    item,\n    registerFileMenuItem,\n    unregisterFileMenuItem,\n  );\n}\n\nexport function useWindowViewMenuItem(\n  item: WindowFileMenuItemInput | null,\n): void {\n  const { registerViewMenuItem, unregisterViewMenuItem } =\n    useContext(WindowMenuContext);\n  useRegisteredWindowMenuItem(\n    item,\n    registerViewMenuItem,\n    unregisterViewMenuItem,\n  );\n}\n\n/**\n * Registers an action in the current window's title bar.\n *\n * Keep `item` and its `icon` reference-stable, such as by memoizing them with\n * `useMemo`, so the window does not re-register the action on every render.\n */\nexport function useWindowTitleBarAction(\n  item: WindowTitleBarActionInput | null,\n): void {\n  const { registerTitleBarAction, unregisterTitleBarAction } =\n    useContext(WindowMenuContext);\n  useWindowItemRegistration({\n    action: item?.onClick ?? null,\n    createRegisteredItem: createRegisteredTitleBarAction,\n    input: item,\n    registerItem: registerTitleBarAction,\n    unregisterItem: unregisterTitleBarAction,\n  });\n}\n\nexport function useWindowBackAction(item: WindowBackActionInput | null): void {\n  const { registerBackAction, unregisterBackAction } =\n    useContext(WindowMenuContext);\n  useWindowItemRegistration({\n    action: item?.onClick ?? null,\n    createRegisteredItem: createRegisteredBackAction,\n    input: item,\n    registerItem: registerBackAction,\n    unregisterItem: unregisterBackAction,\n  });\n}\n\n/**\n * Keeps this window's toolbar row reserved (rendered) while the caller is\n * mounted, even when it registers no title-bar or back actions. A mini-app that\n * wants explorer-style chrome on every route — a blank bar on the routes that\n * have no actions rather than a collapsing/reappearing row — calls this once.\n * Pass `reserve = false` to release the reservation without unmounting.\n */\nexport function useWindowToolbarReservation(reserve = true): void {\n  const { registerToolbarReservation, unregisterToolbarReservation } =\n    useContext(WindowMenuContext);\n  const idRef = useRef<object>({});\n  const hasEverReservedRef = useRef(false);\n\n  useEffect(() => {\n    const id = idRef.current;\n\n    if (reserve) {\n      hasEverReservedRef.current = true;\n      registerToolbarReservation(id, true);\n      return () => unregisterToolbarReservation(id);\n    }\n\n    if (!hasEverReservedRef.current) {\n      return;\n    }\n\n    // A caller that previously reserved the row is now explicitly releasing it.\n    // This lets WindowToolBar clear its latched blank row while callers that\n    // never opted into reservations keep the older latch-once behavior.\n    registerToolbarReservation(id, false);\n    return () => unregisterToolbarReservation(id);\n  }, [reserve, registerToolbarReservation, unregisterToolbarReservation]);\n}\n\nexport function useWindowRefreshMenuItem(\n  item: WindowRefreshMenuItemInput | null,\n): void {\n  const { registerRefreshMenuItem, unregisterRefreshMenuItem } =\n    useContext(WindowMenuContext);\n  useWindowItemRegistration({\n    action: item?.onRefresh ?? null,\n    createRegisteredItem: createRegisteredRefreshMenuItem,\n    input: item,\n    registerItem: registerRefreshMenuItem,\n    unregisterItem: unregisterRefreshMenuItem,\n  });\n}\n"]}

package/window/WindowMinimizeButton.d.ts

@@ -0,0 +1,3 @@
+export declare function WindowMinimizeButton({ onClick }: {
+    onClick: () => void;
+}): import("react").JSX.Element;

package/window/WindowMinimizeButton.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+export function WindowMinimizeButton({ onClick }) {
+    return (_jsx("button", { type: "button", className: "window-minimize", "aria-label": "Minimize window", title: "Minimize window", onClick: onClick, children: "\u2013" }));
+}
+//# sourceMappingURL=WindowMinimizeButton.js.map

package/window/WindowMinimizeButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowMinimizeButton.js","sourceRoot":"","sources":["../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowMinimizeButton.tsx"],"names":[],"mappings":";AAAA,MAAM,UAAU,oBAAoB,CAAC,EAAE,OAAO,EAA2B;IACvE,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,iBAAiB,gBAChB,iBAAiB,EAC5B,KAAK,EAAC,iBAAiB,EACvB,OAAO,EAAE,OAAO,uBAGT,CACV,CAAC;AACJ,CAAC","sourcesContent":["export function WindowMinimizeButton({ onClick }: { onClick: () => void }) {\n  return (\n    <button\n      type=\"button\"\n      className=\"window-minimize\"\n      aria-label=\"Minimize window\"\n      title=\"Minimize window\"\n      onClick={onClick}\n    >\n      &#8211;\n    </button>\n  );\n}\n"]}

package/window/WindowResizeHandle.css

@@ -0,0 +1,65 @@
+/*
+ * Corner resize affordance. Each handle is an invisible hit target pinned to a
+ * window corner; on hover it paints an L-shaped bracket that hugs that corner —
+ * only the two outward-facing edges — so the corner itself lights up (not just
+ * the cursor), signalling it can be dragged.
+ * The bracket is drawn in --color-dark, the theme's foreground primitive, so it
+ * reads as the window's own edge lit up and stays crisp in both themes (a
+ * charcoal bracket on the light surface, a near-white one on the dark surface).
+ * Each bracket follows the rounded window corner while its hit target stays
+ * square, keeping the outermost corner easy to grab.
+ */
+.window-resize {
+  position: absolute;
+  width: 14px;
+  height: 14px;
+  touch-action: none;
+  border: 0 solid transparent;
+  transition: border-color var(--transition);
+}
+
+/* Gate the highlight behind a true-hover pointer. On coarse (touch) pointers a
+   tap triggers :hover and it stays stuck until the next tap elsewhere; scoping
+   the rule to fine pointers means it simply never applies there. Corner-drag
+   resize is a pointer affordance anyway, so touch loses nothing. */
+@media (hover: hover) {
+  .window-resize:hover {
+    border-color: var(--color-dark);
+  }
+}
+
+.window-resize--se {
+  border-bottom-right-radius: var(--app-radius-surface);
+  right: 0;
+  bottom: 0;
+  cursor: se-resize;
+  border-right-width: 2px;
+  border-bottom-width: 2px;
+}
+
+.window-resize--sw {
+  border-bottom-left-radius: var(--app-radius-surface);
+  bottom: 0;
+  left: 0;
+  cursor: sw-resize;
+  border-bottom-width: 2px;
+  border-left-width: 2px;
+}
+
+.window-resize--ne {
+  border-top-right-radius: var(--app-radius-surface);
+  top: 0;
+  right: 0;
+  cursor: ne-resize;
+  border-top-width: 2px;
+  border-right-width: 2px;
+}
+
+.window-resize--nw {
+  border-top-left-radius: var(--app-radius-surface);
+  top: 0;
+  left: 0;
+  cursor: nw-resize;
+  border-top-width: 2px;
+  border-left-width: 2px;
+}

package/window/WindowResizeHandle.d.ts

@@ -0,0 +1,5 @@
+export type ResizeCorner = "se" | "sw" | "ne" | "nw";
+export declare function WindowResizeHandle({ corner, onPointerDown, }: {
+    corner: ResizeCorner;
+    onPointerDown: (e: React.PointerEvent, corner: ResizeCorner) => void;
+}): import("react").JSX.Element;

package/window/WindowResizeHandle.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import "./WindowResizeHandle.css";
+export function WindowResizeHandle({ corner, onPointerDown, }) {
+    return (_jsx("div", { role: "none", className: `window-resize window-resize--${corner}`, onPointerDown: (e) => onPointerDown(e, corner) }));
+}
+//# sourceMappingURL=WindowResizeHandle.js.map

package/window/WindowResizeHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowResizeHandle.js","sourceRoot":"","sources":["../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowResizeHandle.tsx"],"names":[],"mappings":";AAAA,OAAO,0BAA0B,CAAC;AAIlC,MAAM,UAAU,kBAAkB,CAAC,EACjC,MAAM,EACN,aAAa,GAId;IACC,OAAO,CACL,cACE,IAAI,EAAC,MAAM,EACX,SAAS,EAAE,gCAAgC,MAAM,EAAE,EACnD,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,GAC9C,CACH,CAAC;AACJ,CAAC","sourcesContent":["import \"./WindowResizeHandle.css\";\n\nexport type ResizeCorner = \"se\" | \"sw\" | \"ne\" | \"nw\";\n\nexport function WindowResizeHandle({\n  corner,\n  onPointerDown,\n}: {\n  corner: ResizeCorner;\n  onPointerDown: (e: React.PointerEvent, corner: ResizeCorner) => void;\n}) {\n  return (\n    <div\n      role=\"none\"\n      className={`window-resize window-resize--${corner}`}\n      onPointerDown={(e) => onPointerDown(e, corner)}\n    />\n  );\n}\n"]}

package/window/WindowSidebar.css

@@ -0,0 +1,37 @@
+.window-sidebar-layout {
+  display: flex;
+  flex: 1;
+  min-height: 0;
+  height: 100%;
+  overflow: hidden;
+}
+
+.window-sidebar {
+  overflow: auto;
+  scrollbar-gutter: var(--scrollbar-gutter);
+  flex-shrink: 0;
+  min-width: 5rem;
+}
+
+.window-sidebar-handle {
+  width: 6px;
+  margin: 0 -2px;
+}
+
+.window-sidebar-handle::before {
+  left: 2px;
+}
+
+.window-sidebar-content {
+  position: relative;
+  flex: 1;
+  min-width: 0;
+  min-height: 0;
+  overflow: hidden;
+}
+
+.window-sidebar-content-scroll {
+  height: 100%;
+  overflow: auto;
+  scrollbar-gutter: var(--scrollbar-gutter);
+}

package/window/WindowSidebar.d.ts

@@ -0,0 +1,6 @@
+import type { PropsWithChildren, Ref } from "react";
+export declare function WindowSidebar({ contentRef, defaultWidth, sidebar, children, }: PropsWithChildren<{
+    contentRef?: Ref<HTMLDivElement> | undefined;
+    defaultWidth?: number;
+    sidebar?: React.ReactNode;
+}>): import("react").JSX.Element;

package/window/WindowSidebar.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SidebarResizeHandle, useSidebarResize, } from "../sidebar/SidebarResize.js";
+import "./WindowSidebar.css";
+const DEFAULT_WIDTH = 160;
+export function WindowSidebar({ contentRef, defaultWidth = DEFAULT_WIDTH, sidebar, children, }) {
+    const resize = useSidebarResize({ defaultWidth });
+    return (_jsxs("div", { className: "window-sidebar-layout", children: [_jsx("div", { className: "window-sidebar", ref: resize.sidebarRef, style: { width: resize.width ?? defaultWidth }, children: sidebar }), _jsx(SidebarResizeHandle, { className: "window-sidebar-handle", currentWidth: resize.resolvedWidth, onKeyDown: resize.handleKeyDown, onPointerDown: resize.handlePointerDown }), _jsx("div", { className: "window-sidebar-content", ref: contentRef, tabIndex: -1, children: _jsx("div", { className: "window-sidebar-content-scroll", children: children }) })] }));
+}
+//# sourceMappingURL=WindowSidebar.js.map

package/window/WindowSidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowSidebar.js","sourceRoot":"","sources":["../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowSidebar.tsx"],"names":[],"mappings":";AACA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,qBAAqB,CAAC;AAE7B,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,MAAM,UAAU,aAAa,CAAC,EAC5B,UAAU,EACV,YAAY,GAAG,aAAa,EAC5B,OAAO,EACP,QAAQ,GAKR;IACA,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAElD,OAAO,CACL,eAAK,SAAS,EAAC,uBAAuB,aACpC,cACE,SAAS,EAAC,gBAAgB,EAC1B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,YAAY,EAAE,YAE7C,OAAO,GACJ,EACN,KAAC,mBAAmB,IAClB,SAAS,EAAC,uBAAuB,EACjC,YAAY,EAAE,MAAM,CAAC,aAAa,EAClC,SAAS,EAAE,MAAM,CAAC,aAAa,EAC/B,aAAa,EAAE,MAAM,CAAC,iBAAiB,GACvC,EAGF,cAAK,SAAS,EAAC,wBAAwB,EAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,YACnE,cAAK,SAAS,EAAC,+BAA+B,YAAE,QAAQ,GAAO,GAC3D,IACF,CACP,CAAC;AACJ,CAAC","sourcesContent":["import type { PropsWithChildren, Ref } from \"react\";\nimport {\n  SidebarResizeHandle,\n  useSidebarResize,\n} from \"../sidebar/SidebarResize\";\nimport \"./WindowSidebar.css\";\n\nconst DEFAULT_WIDTH = 160;\n\nexport function WindowSidebar({\n  contentRef,\n  defaultWidth = DEFAULT_WIDTH,\n  sidebar,\n  children,\n}: PropsWithChildren<{\n  contentRef?: Ref<HTMLDivElement> | undefined;\n  defaultWidth?: number;\n  sidebar?: React.ReactNode;\n}>) {\n  const resize = useSidebarResize({ defaultWidth });\n\n  return (\n    <div className=\"window-sidebar-layout\">\n      <div\n        className=\"window-sidebar\"\n        ref={resize.sidebarRef}\n        style={{ width: resize.width ?? defaultWidth }}\n      >\n        {sidebar}\n      </div>\n      <SidebarResizeHandle\n        className=\"window-sidebar-handle\"\n        currentWidth={resize.resolvedWidth}\n        onKeyDown={resize.handleKeyDown}\n        onPointerDown={resize.handlePointerDown}\n      />\n      {/* Focusable only to script, like `.window-body-content`: the overlay host\n          is where focus lands when an overlay outlives the control that opened it. */}\n      <div className=\"window-sidebar-content\" ref={contentRef} tabIndex={-1}>\n        <div className=\"window-sidebar-content-scroll\">{children}</div>\n      </div>\n    </div>\n  );\n}\n"]}

package/window/WindowSidebarContext.d.ts

@@ -0,0 +1,14 @@
+import { type PropsWithChildren, type ReactNode } from "react";
+interface WindowSidebarContextValue {
+    sidebar: ReactNode;
+    setSidebar: (node: ReactNode) => void;
+}
+export declare function WindowSidebarProvider({ children }: PropsWithChildren): import("react").JSX.Element;
+export declare function hasWindowSidebar(sidebar: ReactNode): boolean;
+export declare function useWindowSidebar(): WindowSidebarContextValue;
+export declare function useRegisteredWindowSidebar({ enabled, setSidebar, sidebar, }: {
+    enabled?: boolean;
+    setSidebar: (node: ReactNode) => void;
+    sidebar: ReactNode;
+}): void;
+export {};

package/window/WindowSidebarContext.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef, useState, } from "react";
+const WindowSidebarContext = createContext({
+    sidebar: null,
+    setSidebar: () => { },
+});
+export function WindowSidebarProvider({ children }) {
+    const [sidebar, setSidebar] = useState(null);
+    const value = useMemo(() => ({ sidebar, setSidebar }), [sidebar]);
+    return (_jsx(WindowSidebarContext.Provider, { value: value, children: children }));
+}
+// `sidebar` is a ReactNode, so `false`/`null`/`undefined` all mean "no
+// sidebar" while renderable falsy values like `0` or `""` do not.
+export function hasWindowSidebar(sidebar) {
+    return sidebar !== null && sidebar !== undefined && sidebar !== false;
+}
+export function useWindowSidebar() {
+    return useContext(WindowSidebarContext);
+}
+export function useRegisteredWindowSidebar({ enabled = true, setSidebar, sidebar, }) {
+    // The ref keeps the clearing cleanup pinned to [enabled] even when a caller
+    // passes a setter that is not referentially stable: with setSidebar in the
+    // cleanup's deps, every such render would clear-then-reregister the sidebar
+    // and re-render the window shell in a loop.
+    const setSidebarRef = useRef(setSidebar);
+    setSidebarRef.current = setSidebar;
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        setSidebar(sidebar);
+    }, [enabled, setSidebar, sidebar]);
+    // Clearing stays in its own effect so a sidebar-node change swaps the node
+    // without a transient null; the cleanup runs only on unmount or when
+    // `enabled` flips off.
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        return () => setSidebarRef.current(null);
+    }, [enabled]);
+}
+//# sourceMappingURL=WindowSidebarContext.js.map

package/window/WindowSidebarContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowSidebarContext.js","sourceRoot":"","sources":["../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowSidebarContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,aAAa,EAGb,UAAU,EACV,SAAS,EACT,OAAO,EACP,MAAM,EACN,QAAQ,GACT,MAAM,OAAO,CAAC;AAOf,MAAM,oBAAoB,GAAG,aAAa,CAA4B;IACpE,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,EAAE,QAAQ,EAAqB;IACnE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAY,IAAI,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,OAAO,CACL,KAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACxC,QAAQ,GACqB,CACjC,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,OAAkB;IACjD,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,EACzC,OAAO,GAAG,IAAI,EACd,UAAU,EACV,OAAO,GAKR;IACC,4EAA4E;IAC5E,2EAA2E;IAC3E,4EAA4E;IAC5E,4CAA4C;IAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;IAEnC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,UAAU,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnC,2EAA2E;IAC3E,qEAAqE;IACrE,uBAAuB;IACvB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AAChB,CAAC","sourcesContent":["import {\n  createContext,\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\n\ninterface WindowSidebarContextValue {\n  sidebar: ReactNode;\n  setSidebar: (node: ReactNode) => void;\n}\n\nconst WindowSidebarContext = createContext<WindowSidebarContextValue>({\n  sidebar: null,\n  setSidebar: () => {},\n});\n\nexport function WindowSidebarProvider({ children }: PropsWithChildren) {\n  const [sidebar, setSidebar] = useState<ReactNode>(null);\n  const value = useMemo(() => ({ sidebar, setSidebar }), [sidebar]);\n  return (\n    <WindowSidebarContext.Provider value={value}>\n      {children}\n    </WindowSidebarContext.Provider>\n  );\n}\n\n// `sidebar` is a ReactNode, so `false`/`null`/`undefined` all mean \"no\n// sidebar\" while renderable falsy values like `0` or `\"\"` do not.\nexport function hasWindowSidebar(sidebar: ReactNode): boolean {\n  return sidebar !== null && sidebar !== undefined && sidebar !== false;\n}\n\nexport function useWindowSidebar() {\n  return useContext(WindowSidebarContext);\n}\n\nexport function useRegisteredWindowSidebar({\n  enabled = true,\n  setSidebar,\n  sidebar,\n}: {\n  enabled?: boolean;\n  setSidebar: (node: ReactNode) => void;\n  sidebar: ReactNode;\n}) {\n  // The ref keeps the clearing cleanup pinned to [enabled] even when a caller\n  // passes a setter that is not referentially stable: with setSidebar in the\n  // cleanup's deps, every such render would clear-then-reregister the sidebar\n  // and re-render the window shell in a loop.\n  const setSidebarRef = useRef(setSidebar);\n  setSidebarRef.current = setSidebar;\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n\n    setSidebar(sidebar);\n  }, [enabled, setSidebar, sidebar]);\n\n  // Clearing stays in its own effect so a sidebar-node change swaps the node\n  // without a transient null; the cleanup runs only on unmount or when\n  // `enabled` flips off.\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n\n    return () => setSidebarRef.current(null);\n  }, [enabled]);\n}\n"]}

package/window/WindowStateProvider/WindowStateProvider.d.ts

@@ -0,0 +1,2 @@
+import { type PropsWithChildren } from "react";
+export declare function WindowStateProvider({ children }: PropsWithChildren): import("react").JSX.Element;

package/window/WindowStateProvider/WindowStateProvider.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo, useRef, useState } from "react";
+import { windowActionsContext, windowStateContext } from "./context.js";
+import { useWindowStateActions } from "./useWindowStateActions.js";
+export function WindowStateProvider({ children }) {
+    const [windows, setWindows] = useState([]);
+    const counter = useRef(0);
+    const actions = useWindowStateActions({ counter, setWindows });
+    const windowMap = useMemo(() => new Map(windows.map((windowEntry) => [windowEntry.id, windowEntry])), [windows]);
+    const state = useMemo(() => ({
+        windows,
+        windowMap,
+    }), [windows, windowMap]);
+    return (_jsx(windowActionsContext.context.Provider, { value: actions, children: _jsx(windowStateContext.context.Provider, { value: state, children: children }) }));
+}
+//# sourceMappingURL=WindowStateProvider.js.map

package/window/WindowStateProvider/WindowStateProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WindowStateProvider.js","sourceRoot":"","sources":["../../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowStateProvider/WindowStateProvider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAA0B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,UAAU,mBAAmB,CAAC,EAAE,QAAQ,EAAqB;IACjE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,OAAO,CACvB,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,EAC1E,CAAC,OAAO,CAAC,CACV,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,OAAO;QACP,SAAS;KACV,CAAC,EACF,CAAC,OAAO,EAAE,SAAS,CAAC,CACrB,CAAC;IACF,OAAO,CACL,KAAC,oBAAoB,CAAC,OAAO,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YACnD,KAAC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC9C,QAAQ,GAC2B,GACA,CACzC,CAAC;AACJ,CAAC","sourcesContent":["import { type PropsWithChildren, useMemo, useRef, useState } from \"react\";\nimport { windowActionsContext, windowStateContext } from \"./context\";\nimport type { WindowEntry, WindowStateData } from \"./types\";\nimport { useWindowStateActions } from \"./useWindowStateActions\";\n\nexport function WindowStateProvider({ children }: PropsWithChildren) {\n  const [windows, setWindows] = useState<WindowEntry[]>([]);\n  const counter = useRef(0);\n  const actions = useWindowStateActions({ counter, setWindows });\n  const windowMap = useMemo(\n    () => new Map(windows.map((windowEntry) => [windowEntry.id, windowEntry])),\n    [windows],\n  );\n  const state = useMemo<WindowStateData>(\n    () => ({\n      windows,\n      windowMap,\n    }),\n    [windows, windowMap],\n  );\n  return (\n    <windowActionsContext.context.Provider value={actions}>\n      <windowStateContext.context.Provider value={state}>\n        {children}\n      </windowStateContext.context.Provider>\n    </windowActionsContext.context.Provider>\n  );\n}\n"]}

package/window/WindowStateProvider/context.d.ts

@@ -0,0 +1,4 @@
+import { type RequiredContext } from "../../createRequiredContext.js";
+import type { WindowStateActions, WindowStateData } from "./types.js";
+export declare const windowStateContext: RequiredContext<WindowStateData>;
+export declare const windowActionsContext: RequiredContext<WindowStateActions>;

package/window/WindowStateProvider/context.js

@@ -0,0 +1,7 @@
+import { createRequiredContext, } from "../../createRequiredContext.js";
+// Keep state and actions in separate contexts so consumers that only need
+// stable actions like create/restore do not re-render on every window-state
+// change.
+export const windowStateContext = createRequiredContext("useWindowStateData requires WindowStateProvider");
+export const windowActionsContext = createRequiredContext("useWindowActions requires WindowStateProvider");
+//# sourceMappingURL=context.js.map

package/window/WindowStateProvider/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowStateProvider/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AAGrC,0EAA0E;AAC1E,4EAA4E;AAC5E,UAAU;AACV,MAAM,CAAC,MAAM,kBAAkB,GAC7B,qBAAqB,CAAC,iDAAiD,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,oBAAoB,GAC/B,qBAAqB,CAAC,+CAA+C,CAAC,CAAC","sourcesContent":["import {\n  createRequiredContext,\n  type RequiredContext,\n} from \"../../createRequiredContext\";\nimport type { WindowStateActions, WindowStateData } from \"./types\";\n\n// Keep state and actions in separate contexts so consumers that only need\n// stable actions like create/restore do not re-render on every window-state\n// change.\nexport const windowStateContext: RequiredContext<WindowStateData> =\n  createRequiredContext(\"useWindowStateData requires WindowStateProvider\");\n\nexport const windowActionsContext: RequiredContext<WindowStateActions> =\n  createRequiredContext(\"useWindowActions requires WindowStateProvider\");\n"]}

package/window/WindowStateProvider/index.d.ts

@@ -0,0 +1,5 @@
+export type { WindowCreateOptions, WindowEntry, WindowGeometry, WindowPosition, WindowSize, WindowStateActions, WindowStateData, } from "./types.js";
+export { useWindowActions } from "./useWindowActions.js";
+export { useWindowStateData } from "./useWindowStateData.js";
+export { findTopWindow } from "./util/index.js";
+export { WindowStateProvider } from "./WindowStateProvider.js";

package/window/WindowStateProvider/index.js

@@ -0,0 +1,5 @@
+export { useWindowActions } from "./useWindowActions.js";
+export { useWindowStateData } from "./useWindowStateData.js";
+export { findTopWindow } from "./util/index.js";
+export { WindowStateProvider } from "./WindowStateProvider.js";
+//# sourceMappingURL=index.js.map

package/window/WindowStateProvider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../Users/a2f0/github/tearleads5/packages/windowing/src/window/WindowStateProvider/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export type {\n  WindowCreateOptions,\n  WindowEntry,\n  WindowGeometry,\n  WindowPosition,\n  WindowSize,\n  WindowStateActions,\n  WindowStateData,\n} from \"./types\";\nexport { useWindowActions } from \"./useWindowActions\";\nexport { useWindowStateData } from \"./useWindowStateData\";\nexport { findTopWindow } from \"./util\";\nexport { WindowStateProvider } from \"./WindowStateProvider\";\n"]}