@liberation-data/desk 0.1.0

package/dist/react/MenuBar.js

@@ -0,0 +1,245 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useId, useMemo, useRef, useState } from 'react';
+import { canPerform, perform } from '../core/commands.js';
+import { focusedId } from '../core/desk.js';
+import { bindShortcuts, formatShortcut, isApplePlatform } from '../core/shortcuts.js';
+import { useDesk } from './context.js';
+export const menuCommand = (label, command, options = {}) => ({
+    type: 'command',
+    label,
+    command,
+    ...options,
+});
+export const menuAction = (label, onSelect, options = {}) => ({
+    type: 'action',
+    label,
+    onSelect,
+    ...options,
+});
+export const menuSeparator = () => ({ type: 'separator' });
+export const menuHeader = (label) => ({ type: 'header', label });
+/** One item per open window, the key window checked — what a Window menu lists at its foot. */
+export function windowMenuItems(state, focus, title) {
+    const key = focusedId(state);
+    return state.windows.map(w => menuAction(title(w.id), () => focus(w.id), { checked: w.id === key }));
+}
+const read = (flag) => (typeof flag === 'function' ? flag() : flag);
+const selectable = (r) => r.enabled && (r.item.type === 'command' || r.item.type === 'action');
+export function MenuBar({ menus, status = [], leading, trailing, label = 'Menu bar', shortcuts = true, className }) {
+    const desk = useDesk();
+    const all = useMemo(() => [...menus, ...status], [menus, status]);
+    const [open, setOpen] = useState(null);
+    const [roving, setRoving] = useState(0);
+    const bar = useRef(null);
+    const titles = useRef(new Map());
+    // Where focus was before the keyboard reached the menu bar, so a chosen command starts from there.
+    const returnTo = useRef(null);
+    const baseId = useId();
+    const apple = useMemo(isApplePlatform, []);
+    const resolve = (menu) => (typeof menu.items === 'function' ? menu.items() : menu.items).map(item => ({
+        item,
+        enabled: item.type === 'command' ? canPerform(desk, item.command)
+            : item.type === 'action' ? !read(item.disabled)
+                : false,
+        checked: item.type === 'command' || item.type === 'action' ? read(item.checked) : undefined,
+    }));
+    const step = (items, from, delta) => {
+        for (let i = 1; i <= items.length; i++) {
+            const index = (from + delta * i + items.length * 2) % items.length;
+            if (items[index] && selectable(items[index]))
+                return index;
+        }
+        return -1;
+    };
+    const openMenu = (index, via, active = 'first') => {
+        const menu = all[(index + all.length) % all.length];
+        if (!menu)
+            return;
+        const items = resolve(menu);
+        setRoving(all.indexOf(menu));
+        setOpen({
+            id: menu.id,
+            items,
+            via,
+            active: active === 'none' ? -1 : active === 'first' ? step(items, -1, 1) : step(items, items.length, -1),
+        });
+        if (via === 'keyboard')
+            titles.current.get(menu.id)?.focus();
+    };
+    const close = (returnFocus) => {
+        const was = open;
+        setOpen(null);
+        if (returnFocus && was)
+            titles.current.get(was.id)?.focus();
+    };
+    const activate = (resolved) => {
+        if (!resolved || !selectable(resolved))
+            return;
+        const wasKeyboard = open?.via === 'keyboard';
+        setOpen(null);
+        // Keyboard use put focus on the menu bar; send it back so the command starts where the person was working.
+        if (wasKeyboard && bar.current?.contains(document.activeElement)) {
+            if (returnTo.current?.isConnected)
+                returnTo.current.focus();
+            else
+                document.activeElement.blur();
+        }
+        const { item } = resolved;
+        if (item.type === 'command')
+            perform(desk, item.command, item.args);
+        else if (item.type === 'action')
+            item.onSelect();
+    };
+    // While a menu is open, the keyboard drives it without it ever holding focus.
+    useEffect(() => {
+        if (!open)
+            return;
+        const menuIndex = all.findIndex(m => m.id === open.id);
+        const onKey = (event) => {
+            const handled = (() => {
+                switch (event.key) {
+                    case 'ArrowDown':
+                        setOpen({ ...open, active: step(open.items, open.active, 1) });
+                        return true;
+                    case 'ArrowUp':
+                        setOpen({ ...open, active: step(open.items, open.active < 0 ? open.items.length : open.active, -1) });
+                        return true;
+                    case 'Home':
+                        setOpen({ ...open, active: step(open.items, -1, 1) });
+                        return true;
+                    case 'End':
+                        setOpen({ ...open, active: step(open.items, open.items.length, -1) });
+                        return true;
+                    case 'ArrowRight':
+                        openMenu(menuIndex + 1, open.via);
+                        return true;
+                    case 'ArrowLeft':
+                        openMenu(menuIndex - 1, open.via);
+                        return true;
+                    case 'Enter':
+                    case ' ':
+                        activate(open.items[open.active]);
+                        return true;
+                    case 'Escape':
+                        close(open.via === 'keyboard');
+                        return true;
+                    case 'Tab':
+                        close(false);
+                        return false;
+                    default: {
+                        if (event.key.length !== 1 || event.metaKey || event.ctrlKey || event.altKey)
+                            return false;
+                        const letter = event.key.toLowerCase();
+                        const start = open.active;
+                        for (let i = 1; i <= open.items.length; i++) {
+                            const index = (start + i) % open.items.length;
+                            const r = open.items[index];
+                            if (r && selectable(r) && 'label' in r.item && r.item.label.toLowerCase().startsWith(letter)) {
+                                setOpen({ ...open, active: index });
+                                return true;
+                            }
+                        }
+                        return false;
+                    }
+                }
+            })();
+            if (handled) {
+                event.preventDefault();
+                event.stopPropagation();
+            }
+        };
+        const onPointerDown = (event) => {
+            if (!bar.current?.contains(event.target))
+                setOpen(null);
+        };
+        document.addEventListener('keydown', onKey, true);
+        document.addEventListener('pointerdown', onPointerDown, true);
+        return () => {
+            document.removeEventListener('keydown', onKey, true);
+            document.removeEventListener('pointerdown', onPointerDown, true);
+        };
+    });
+    // Menus own their key equivalents, as in AppKit. Menus that build their items when opened are
+    // read when a key is pressed, so their shortcuts work before the menu has ever been opened.
+    const menusNow = useRef(all);
+    menusNow.current = all;
+    useEffect(() => shortcuts
+        ? bindShortcuts(desk, () => Object.fromEntries(menusNow.current
+            .flatMap(m => (typeof m.items === 'function' ? m.items() : m.items))
+            .flatMap(i => (i.type === 'command' && i.shortcut ? [[i.shortcut, i.command]] : []))), { apple })
+        : undefined, [desk, shortcuts, apple]);
+    const onBarKeyDown = (event) => {
+        if (open)
+            return;
+        const index = all.findIndex(m => titles.current.get(m.id) === document.activeElement);
+        if (index < 0)
+            return;
+        const move = (to) => {
+            const next = all[(to + all.length) % all.length];
+            if (next) {
+                setRoving(all.indexOf(next));
+                titles.current.get(next.id)?.focus();
+            }
+        };
+        switch (event.key) {
+            case 'ArrowRight':
+                move(index + 1);
+                break;
+            case 'ArrowLeft':
+                move(index - 1);
+                break;
+            case 'Home':
+                move(0);
+                break;
+            case 'End':
+                move(all.length - 1);
+                break;
+            case 'ArrowDown':
+            case 'Enter':
+            case ' ':
+                openMenu(index, 'keyboard', 'first');
+                break;
+            case 'ArrowUp':
+                openMenu(index, 'keyboard', 'last');
+                break;
+            default: return;
+        }
+        event.preventDefault();
+    };
+    const renderMenu = (menu, index) => {
+        const isOpen = open?.id === menu.id;
+        const titleId = `${baseId}-title-${menu.id}`;
+        const menuId = `${baseId}-menu-${menu.id}`;
+        return (_jsxs("div", { className: "desk-menubar-slot", "data-align": index >= menus.length ? 'end' : undefined, children: [_jsx("button", { ref: el => {
+                        if (el)
+                            titles.current.set(menu.id, el);
+                        else
+                            titles.current.delete(menu.id);
+                    }, id: titleId, type: "button", role: "menuitem", className: "desk-menubar-title", "aria-haspopup": "menu", "aria-expanded": isOpen, "aria-controls": isOpen ? menuId : undefined, "aria-label": menu.title ? menu.label : undefined, "data-emphasis": menu.emphasis || undefined, tabIndex: index === roving ? 0 : -1, 
+                    // Opening a menu with the pointer must not move focus out of the window being worked in.
+                    onMouseDown: event => event.preventDefault(), onClick: () => (isOpen ? close(false) : openMenu(index, 'pointer', 'none')), onPointerEnter: () => {
+                        if (open && !isOpen)
+                            openMenu(index, open.via, open.via === 'keyboard' ? 'first' : 'none');
+                    }, children: menu.title ?? menu.label }), isOpen && open && (_jsx("div", { id: menuId, role: "menu", "aria-labelledby": titleId, className: "desk-menu", "aria-activedescendant": open.active >= 0 ? `${menuId}-${open.active}` : undefined, children: open.items.map((resolved, i) => {
+                        const { item } = resolved;
+                        if (item.type === 'separator')
+                            return _jsx("div", { role: "separator", className: "desk-menu-separator" }, i);
+                        if (item.type === 'header')
+                            return _jsx("div", { role: "presentation", className: "desk-menu-header", children: item.label }, i);
+                        const checkable = resolved.checked !== undefined;
+                        return (_jsxs("div", { id: `${menuId}-${i}`, role: checkable ? 'menuitemcheckbox' : 'menuitem', "aria-checked": checkable ? resolved.checked : undefined, "aria-disabled": !resolved.enabled || undefined, className: "desk-menu-item", "data-active": i === open.active || undefined, onMouseDown: event => event.preventDefault(), onPointerMove: () => {
+                                if (open.active !== i && selectable(resolved))
+                                    setOpen({ ...open, active: i });
+                            }, onPointerLeave: () => {
+                                if (open.via === 'pointer' && open.active === i)
+                                    setOpen({ ...open, active: -1 });
+                            }, onClick: () => activate(resolved), children: [_jsx("span", { className: "desk-menu-check", "aria-hidden": "true", children: resolved.checked ? '✓' : '' }), _jsx("span", { className: "desk-menu-label", children: item.label }), item.detail && _jsx("span", { className: "desk-menu-detail", children: item.detail }), item.shortcut && _jsx("kbd", { className: "desk-menu-shortcut", children: formatShortcut(item.shortcut, apple) })] }, i));
+                    }) }))] }, menu.id));
+    };
+    return (_jsxs("div", { ref: bar, role: "menubar", "aria-label": label, className: ['desk-menubar', className].filter(Boolean).join(' '), onKeyDown: onBarKeyDown, onFocus: event => {
+            const from = event.relatedTarget;
+            if (from instanceof HTMLElement && !bar.current?.contains(from))
+                returnTo.current = from;
+        }, children: [leading && _jsx("div", { className: "desk-menubar-leading", children: leading }), menus.map((menu, i) => renderMenu(menu, i)), _jsx("span", { className: "desk-menubar-spacer" }), status.map((menu, i) => renderMenu(menu, menus.length + i)), trailing && _jsx("div", { className: "desk-menubar-trailing", children: trailing })] }));
+}
+//# sourceMappingURL=MenuBar.js.map

package/dist/react/MenuBar.js.map

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

package/dist/react/appFrame.d.ts

@@ -0,0 +1,37 @@
+import type { Accepts } from './dnd.js';
+export interface AppFrameProps {
+    /** The accessible name of the frame: what the app is. */
+    readonly title: string;
+    /** The app's page, as a URL or as the HTML itself. Give one. */
+    readonly src?: string;
+    readonly srcDoc?: string;
+    /** Topics the app may hear, e.g. `['ride.selected']` or `['ride.*']`. Default: none. */
+    readonly listens?: readonly string[];
+    /** Topics the app may say. Anything else it publishes is dropped. Default: none. */
+    readonly says?: readonly string[];
+    /** What may be dropped on it. Default: nothing. */
+    readonly accepts?: Accepts;
+    /** Windows the app may ask to open. Default: none. */
+    readonly opens?: readonly string[];
+    /**
+     * The frame's sandbox. The default lets the app run its own scripts and forms, and
+     * nothing more: no same-origin access, no top-level navigation, no pop-ups.
+     */
+    readonly sandbox?: string;
+    readonly className?: string;
+}
+export declare function AppFrame({ title, src, srcDoc, listens, says, accepts, opens, sandbox, className, }: AppFrameProps): import("react").JSX.Element;
+/**
+ * The app's half of the bridge, as a script to put in its page. It gives the page a
+ * small `desk` object:
+ *
+ *   desk.on('ride.selected', event => …)     hear a granted topic
+ *   desk.onDrop(drop => …)                   take what is dropped on the window
+ *   desk.publish('ride.selected', ride)      say something, if it was granted
+ *   desk.open('map')                         ask for a window, if it was granted
+ *   desk.window                              which window this is, once connected
+ */
+export declare const APP_BRIDGE_SCRIPT = "(() => {\n  const handlers = new Map();\n  const drops = [];\n  const send = message => parent.postMessage(Object.assign({ desk: 1 }, message), '*');\n  const desk = {\n    window: null,\n    listens: [],\n    says: [],\n    on(topic, handler) { (handlers.get(topic) || handlers.set(topic, []).get(topic)).push(handler); },\n    onDrop(handler) { drops.push(handler); },\n    publish(topic, payload) { send({ kind: 'publish', topic, payload }); },\n    open(window) { send({ kind: 'open', window }); },\n  };\n  const matches = (pattern, topic) =>\n    pattern === '*' || pattern === topic || (pattern.endsWith('.*') && (topic === pattern.slice(0, -2) || topic.startsWith(pattern.slice(0, -1))));\n  addEventListener('message', event => {\n    if (event.source !== parent || !event.data || event.data.desk !== 1) return;\n    const message = event.data;\n    if (message.kind === 'hello') { desk.window = message.window; desk.listens = message.listens; desk.says = message.says; }\n    if (message.kind === 'event') for (const [pattern, list] of handlers) if (matches(pattern, message.topic)) list.forEach(h => h(message));\n    if (message.kind === 'drop') drops.forEach(h => h(message));\n  });\n  window.desk = desk;\n  send({ kind: 'ready' });\n})();";
+/** Puts the bridge into a page of HTML, so a generated app needs nothing added by hand. */
+export declare function withAppBridge(html: string): string;
+//# sourceMappingURL=appFrame.d.ts.map

package/dist/react/appFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appFrame.d.ts","sourceRoot":"","sources":["../../src/react/appFrame.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AA8BvC,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,GAAG,EACH,MAAM,EACN,OAAY,EACZ,IAAS,EACT,OAAO,EACP,KAAU,EACV,OAAqC,EACrC,SAAS,GACV,EAAE,aAAa,+BAyEf;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,2uCAwBxB,CAAA;AAEN,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/react/appFrame.js

@@ -0,0 +1,119 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { topicMatches } from '../core/events.js';
+import { useDragging, useDropTarget } from './dnd.js';
+import { useDesk, useWindowId } from './context.js';
+import { useBus } from './events.js';
+/*
+ * A generated app — a self-contained page — running inside a window, and taking
+ * part in the desk as a native window does: hearing events, saying things, and
+ * taking what is dropped on it.
+ *
+ * It runs in a sandboxed frame with no access to the host's origin, and talks
+ * only through messages. The host decides, per app, which topics it may hear,
+ * which it may say, and what may be dropped on it. Nothing else crosses.
+ */
+/** The protocol version. Every message carries it, so a mismatch is ignored rather than misread. */
+const PROTOCOL = 1;
+const isAppMessage = (data) => typeof data === 'object' && data !== null && data.desk === PROTOCOL && typeof data.kind === 'string';
+export function AppFrame({ title, src, srcDoc, listens = [], says = [], accepts, opens = [], sandbox = 'allow-scripts allow-forms', className, }) {
+    const desk = useDesk();
+    const bus = useBus();
+    const windowId = useWindowId();
+    const frame = useRef(null);
+    const dragging = useDragging();
+    const post = (message) => {
+        // A sandboxed frame without same-origin has an opaque origin, so '*' is the only
+        // target that reaches it. It is safe here: the message goes to this frame's
+        // window and no other.
+        frame.current?.contentWindow?.postMessage(message, '*');
+    };
+    const latest = useRef({ listens, says, opens, windowId });
+    latest.current = { listens, says, opens, windowId };
+    // What the app says: only from this frame, only on topics it was granted.
+    useEffect(() => {
+        const onMessage = (event) => {
+            if (!frame.current || event.source !== frame.current.contentWindow || !isAppMessage(event.data))
+                return;
+            const message = event.data;
+            const granted = latest.current;
+            if (message.kind === 'ready') {
+                post({ desk: PROTOCOL, kind: 'hello', window: granted.windowId, listens: granted.listens, says: granted.says });
+            }
+            else if (message.kind === 'publish') {
+                if (typeof message.topic === 'string' && granted.says.some(pattern => topicMatches(pattern, message.topic))) {
+                    bus.publish(message.topic, message.payload, { from: granted.windowId });
+                }
+            }
+            else if (message.kind === 'open') {
+                if (typeof message.window === 'string' && granted.opens.includes(message.window))
+                    desk.open(message.window);
+            }
+        };
+        window.addEventListener('message', onMessage);
+        return () => window.removeEventListener('message', onMessage);
+    }, [bus, desk]);
+    // What the app hears: only the topics it was granted, and never its own words back.
+    const listenKey = listens.join('|');
+    useEffect(() => {
+        if (!listens.length)
+            return;
+        const stops = listens.map(pattern => bus.subscribe(pattern, (event) => {
+            if (event.from !== null && event.from === latest.current.windowId)
+                return;
+            post({ desk: PROTOCOL, kind: 'event', topic: event.topic, payload: event.payload, from: event.from });
+        }));
+        return () => stops.forEach(stop => stop());
+        // listenKey stands for the list's contents; the array itself changes identity every render.
+    }, [bus, listenKey]);
+    const { dropProps } = useDropTarget({
+        accepts: accepts ?? (() => false),
+        disabled: accepts === undefined,
+        onDrop: drag => post({ desk: PROTOCOL, kind: 'drop', type: drag.type, payload: drag.payload, from: drag.from }),
+    });
+    // While something is being carried, the frame must not swallow the pointer, or the
+    // desk can never see that it is over this app.
+    const frameStyle = { pointerEvents: dragging ? 'none' : 'auto' };
+    return (_jsx("div", { className: ['desk-app-frame', className].filter(Boolean).join(' '), ...dropProps, children: _jsx("iframe", { ref: frame, title: title, className: "desk-app-frame-page", sandbox: sandbox, ...(srcDoc !== undefined ? { srcDoc } : src !== undefined ? { src } : {}), style: frameStyle }) }));
+}
+/**
+ * The app's half of the bridge, as a script to put in its page. It gives the page a
+ * small `desk` object:
+ *
+ *   desk.on('ride.selected', event => …)     hear a granted topic
+ *   desk.onDrop(drop => …)                   take what is dropped on the window
+ *   desk.publish('ride.selected', ride)      say something, if it was granted
+ *   desk.open('map')                         ask for a window, if it was granted
+ *   desk.window                              which window this is, once connected
+ */
+export const APP_BRIDGE_SCRIPT = `(() => {
+  const handlers = new Map();
+  const drops = [];
+  const send = message => parent.postMessage(Object.assign({ desk: ${PROTOCOL} }, message), '*');
+  const desk = {
+    window: null,
+    listens: [],
+    says: [],
+    on(topic, handler) { (handlers.get(topic) || handlers.set(topic, []).get(topic)).push(handler); },
+    onDrop(handler) { drops.push(handler); },
+    publish(topic, payload) { send({ kind: 'publish', topic, payload }); },
+    open(window) { send({ kind: 'open', window }); },
+  };
+  const matches = (pattern, topic) =>
+    pattern === '*' || pattern === topic || (pattern.endsWith('.*') && (topic === pattern.slice(0, -2) || topic.startsWith(pattern.slice(0, -1))));
+  addEventListener('message', event => {
+    if (event.source !== parent || !event.data || event.data.desk !== ${PROTOCOL}) return;
+    const message = event.data;
+    if (message.kind === 'hello') { desk.window = message.window; desk.listens = message.listens; desk.says = message.says; }
+    if (message.kind === 'event') for (const [pattern, list] of handlers) if (matches(pattern, message.topic)) list.forEach(h => h(message));
+    if (message.kind === 'drop') drops.forEach(h => h(message));
+  });
+  window.desk = desk;
+  send({ kind: 'ready' });
+})();`;
+/** Puts the bridge into a page of HTML, so a generated app needs nothing added by hand. */
+export function withAppBridge(html) {
+    const script = `<script>${APP_BRIDGE_SCRIPT}</script>`;
+    return /<head[^>]*>/i.test(html) ? html.replace(/<head[^>]*>/i, match => `${match}${script}`) : `${script}${html}`;
+}
+//# sourceMappingURL=appFrame.js.map

package/dist/react/appFrame.js.map

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

package/dist/react/arrange.d.ts

@@ -0,0 +1,24 @@
+import type { Frame, WindowId } from '../core/types.js';
+/** The part of the stage windows are laid out in, and the gap between them. */
+export interface Area extends Frame {
+    readonly gap: number;
+}
+export interface ArrangeLimits {
+    readonly minWidth: number;
+    readonly minHeight: number;
+}
+/**
+ * Where Arrange puts each window. The same windows always land in the same places:
+ * the focused window takes the first and largest place, the rest follow in the order
+ * they were opened. Nothing here looks at where windows are now, so a small drag
+ * never swaps two windows the next time.
+ *
+ *   1 fills the area · 2 side by side · 3 one tall on the left, two stacked on the right
+ *   4 a 2 × 2 grid · more a grid, while every cell stays usable
+ *
+ * When a grid cell would be too small to use, the focused window and the one used
+ * before it share the area and the rest cascade over the second half, so the focused
+ * window, which stays in front, covers none of them.
+ */
+export declare function arrangement(ids: readonly WindowId[], focused: WindowId | null, previous: WindowId | null, area: Area, limits: ArrangeLimits): Record<WindowId, Frame>;
+//# sourceMappingURL=arrange.d.ts.map

package/dist/react/arrange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrange.d.ts","sourceRoot":"","sources":["../../src/react/arrange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEvD,+EAA+E;AAC/E,MAAM,WAAW,IAAK,SAAQ,KAAK;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,SAAS,QAAQ,EAAE,EACxB,OAAO,EAAE,QAAQ,GAAG,IAAI,EACxB,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAkDzB"}

package/dist/react/arrange.js

@@ -0,0 +1,61 @@
+/**
+ * Where Arrange puts each window. The same windows always land in the same places:
+ * the focused window takes the first and largest place, the rest follow in the order
+ * they were opened. Nothing here looks at where windows are now, so a small drag
+ * never swaps two windows the next time.
+ *
+ *   1 fills the area · 2 side by side · 3 one tall on the left, two stacked on the right
+ *   4 a 2 × 2 grid · more a grid, while every cell stays usable
+ *
+ * When a grid cell would be too small to use, the focused window and the one used
+ * before it share the area and the rest cascade over the second half, so the focused
+ * window, which stays in front, covers none of them.
+ */
+export function arrangement(ids, focused, previous, area, limits) {
+    const first = focused && ids.includes(focused) ? focused : ids[0];
+    if (first === undefined)
+        return {};
+    const order = [first, ...ids.filter(id => id !== first)];
+    const { x, y, width, height, gap } = area;
+    const half = (width - gap) / 2;
+    const place = (frames) => Object.fromEntries(order.map((id, i) => [id, frames[i]]));
+    if (order.length === 1)
+        return place([{ x, y, width, height }]);
+    if (order.length === 2)
+        return place([{ x, y, width: half, height }, { x: x + half + gap, y, width: half, height }]);
+    if (order.length === 3) {
+        const stacked = (height - gap) / 2;
+        return place([
+            { x, y, width: half, height },
+            { x: x + half + gap, y, width: half, height: stacked },
+            { x: x + half + gap, y: y + stacked + gap, width: half, height: stacked },
+        ]);
+    }
+    const columns = Math.ceil(Math.sqrt(order.length));
+    const rows = Math.ceil(order.length / columns);
+    const cellWidth = (width - gap * (columns - 1)) / columns;
+    const cellHeight = (height - gap * (rows - 1)) / rows;
+    if (cellWidth >= limits.minWidth && cellHeight >= limits.minHeight) {
+        return place(order.map((_, i) => ({
+            x: x + (i % columns) * (cellWidth + gap),
+            y: y + Math.floor(i / columns) * (cellHeight + gap),
+            width: cellWidth,
+            height: cellHeight,
+        })));
+    }
+    // Too many to grid: the two most recent share the area, the rest cascade over the second half.
+    const second = previous && previous !== first && ids.includes(previous) ? previous : order[1];
+    const rest = order.filter(id => id !== first && id !== second);
+    const step = 28;
+    const floatWidth = Math.max(limits.minWidth, Math.min(720, half - step * 2));
+    const floatHeight = Math.max(limits.minHeight, Math.min(520, height - step * 2));
+    return {
+        [first]: { x, y, width: half, height },
+        [second]: { x: x + half + gap, y, width: half, height },
+        ...Object.fromEntries(rest.map((id, i) => {
+            const n = i % 6;
+            return [id, { x: x + half + gap + step + n * 32, y: y + step + n * step, width: floatWidth, height: floatHeight }];
+        })),
+    };
+}
+//# sourceMappingURL=arrange.js.map

package/dist/react/arrange.js.map

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

package/dist/react/commands.d.ts

@@ -0,0 +1,23 @@
+import type { RefObject } from 'react';
+import type { CommandHandler, CommandId } from '../core/commands.js';
+import type { Keymap, ShortcutOptions } from '../core/shortcuts.js';
+export interface UseCommandOptions {
+    /** Whether the handler can act right now. Read when the command arrives and when a menu opens. */
+    readonly enabled?: boolean | (() => boolean);
+    /**
+     * Where in the chain this responder sits.
+     * - `'window'` (the default inside a window): the window this component is rendered in.
+     * - `'app'` (the default outside windows): the top of the chain.
+     * - a ref: that element, e.g. an editor that answers Copy only while it has focus.
+     */
+    readonly at?: 'window' | 'app' | RefObject<Element | null>;
+}
+/** Answers a command when it reaches this component's place in the responder chain. */
+export declare function useCommand<Args = unknown>(command: CommandId, handler: CommandHandler<Args>, options?: UseCommandOptions): void;
+/** Returns a function that sends a command along the chain, and reports whether anything handled it. */
+export declare function usePerform(): <Args = unknown>(command: CommandId, args?: Args) => boolean;
+/** Returns a function that asks whether a command would be handled right now — what a menu calls as it opens. */
+export declare function useCanPerform(): (command: CommandId) => boolean;
+/** Performs commands from keyboard shortcuts while mounted. Pass a stable keymap. */
+export declare function useShortcuts(keymap: Keymap, options?: ShortcutOptions): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/react/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/react/commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpE,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAGnE,MAAM,WAAW,iBAAiB;IAChC,kGAAkG;IAClG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;CAC3D;AAED,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI,CAmBnI;AAED,wGAAwG;AACxG,wBAAgB,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,CAGzF;AAED,iHAAiH;AACjH,wBAAgB,aAAa,IAAI,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAG/D;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAIhF"}

package/dist/react/commands.js

@@ -0,0 +1,41 @@
+import { useCallback, useContext, useEffect, useRef } from 'react';
+import { addCommandHandler, canPerform, perform } from '../core/commands.js';
+import { bindShortcuts } from '../core/shortcuts.js';
+import { useDesk, WindowContext } from './context.js';
+/** Answers a command when it reaches this component's place in the responder chain. */
+export function useCommand(command, handler, options = {}) {
+    const window = useContext(WindowContext);
+    // Latest handler and enablement without re-registering on every render.
+    const latest = useRef({ handler, enabled: options.enabled });
+    latest.current = { handler, enabled: options.enabled };
+    const at = options.at ?? (window ? 'window' : 'app');
+    const ref = typeof at === 'object' ? at : at === 'window' ? window?.element : null;
+    useEffect(() => {
+        const target = at === 'app' ? document : ref?.current;
+        if (!target)
+            return;
+        return addCommandHandler(target, command, args => latest.current.handler(args), {
+            enabled: () => {
+                const enabled = latest.current.enabled;
+                return typeof enabled === 'function' ? enabled() : (enabled ?? true);
+            },
+        });
+    }, [command, at, ref]);
+}
+/** Returns a function that sends a command along the chain, and reports whether anything handled it. */
+export function usePerform() {
+    const desk = useDesk();
+    return useCallback((command, args) => perform(desk, command, args), [desk]);
+}
+/** Returns a function that asks whether a command would be handled right now — what a menu calls as it opens. */
+export function useCanPerform() {
+    const desk = useDesk();
+    return useCallback(command => canPerform(desk, command), [desk]);
+}
+/** Performs commands from keyboard shortcuts while mounted. Pass a stable keymap. */
+export function useShortcuts(keymap, options = {}) {
+    const desk = useDesk();
+    const { target, apple } = options;
+    useEffect(() => bindShortcuts(desk, keymap, { ...(target ? { target } : {}), ...(apple === undefined ? {} : { apple }) }), [desk, keymap, target, apple]);
+}
+//# sourceMappingURL=commands.js.map

package/dist/react/commands.js.map

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