@liberation-data/desk 0.1.0

package/dist/core/location.js

@@ -0,0 +1,99 @@
+import { cascadeFrame, focusedId, normalise } from './desk.js';
+/*
+ * The URL carries which windows are open, which are free, and which has focus —
+ * never frames. A shared link should open the same things, not reproduce
+ * someone else's window positions on a different screen.
+ *
+ *   #w=notes,clock~,inspector&f=clock
+ *
+ * `~` marks a free window; the others fill the desk. `f` names the focused window.
+ */
+const FLOAT = '~';
+const warned = new Set();
+/** Said once per message: a warning on every parse would be noise, not help. */
+const warnOnce = (message) => {
+    if (warned.has(message))
+        return;
+    warned.add(message);
+    console.warn(message);
+};
+export function serialize(state, options = {}) {
+    const params = new URLSearchParams();
+    if (!state.windows.length)
+        return params;
+    params.set(options.key ?? 'w', state.windows.map(w => `${encodeURIComponent(w.id)}${w.mode === 'floating' ? FLOAT : ''}`).join(','));
+    const focused = focusedId(state);
+    if (focused)
+        params.set(options.focusKey ?? 'f', focused);
+    return params;
+}
+export function parse(params, stage, options = {}) {
+    const known = options.isKnown ??
+        (id => {
+            // Without `isKnown` a stale or hand-edited link opens ids the app cannot render.
+            warnOnce(`desk: no isKnown given, so "${id}" from a URL is taken on trust. Pass isKnown to drop unknown windows.`);
+            return true;
+        });
+    const raw = params.get(options.key ?? 'w');
+    if (!raw)
+        return { windows: [], stack: [] };
+    const entries = raw
+        .split(',')
+        .filter(Boolean)
+        .map(token => {
+        const floating = token.endsWith(FLOAT);
+        return { id: decodeURIComponent(floating ? token.slice(0, -1) : token), floating };
+    })
+        .filter(e => e.id && known(e.id));
+    const windows = entries.map((e, i) => e.floating
+        ? { id: e.id, mode: 'floating', frame: cascadeFrame(entries.slice(0, i).filter(x => x.floating).length, stage) }
+        : { id: e.id, mode: 'filled' });
+    const focus = params.get(options.focusKey ?? 'f');
+    const ids = windows.map(w => w.id);
+    const stack = focus && ids.includes(focus) ? [...ids.filter(id => id !== focus), focus] : ids;
+    return normalise({ windows, stack });
+}
+const openSet = (state) => state.windows.map(w => w.id).join('|');
+/**
+ * Keeps the desk and the URL hash in step. Opening or closing a window pushes a
+ * history entry, so Back closes it; focus and mode changes replace the entry.
+ * Other hash parameters are left alone, so the app can keep using the hash too.
+ */
+export function syncWithLocation(desk, stage, options = {}, env) {
+    const target = env ?? globalThis;
+    const keys = [options.key ?? 'w', options.focusKey ?? 'f'];
+    const read = () => new URLSearchParams(target.location.hash.replace(/^#/, ''));
+    const fromUrl = () => desk.restore(parse(read(), stage(), options));
+    const toUrl = (state, previous) => {
+        const params = read();
+        keys.forEach(k => params.delete(k));
+        serialize(state, options).forEach((value, key) => params.set(key, value));
+        const url = `#${params.toString().replace(/%2C/g, ',').replace(/%7E/g, FLOAT)}`;
+        if (url === target.location.hash || (url === '#' && !target.location.hash))
+            return;
+        if (openSet(state) !== openSet(previous))
+            target.history.pushState(null, '', url);
+        else
+            target.history.replaceState(null, '', url);
+    };
+    // A URL that names windows wins. One that names none adopts whatever the app opened.
+    if (read().has(keys[0]))
+        fromUrl();
+    else if (desk.getState().windows.length)
+        toUrl(desk.getState(), desk.getState());
+    let previous = desk.getState();
+    const unsubscribe = desk.subscribe(state => {
+        toUrl(state, previous);
+        previous = state;
+    });
+    const onPop = () => {
+        fromUrl();
+        previous = desk.getState();
+    };
+    target.addEventListener('popstate', onPop);
+    return () => {
+        unsubscribe();
+        target.removeEventListener('popstate', onPop);
+    };
+}
+//# sourceMappingURL=location.js.map

package/dist/core/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../src/core/location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAI9D;;;;;;;;GAQG;AAEH,MAAM,KAAK,GAAG,GAAG,CAAA;AAEjB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;AAChC,gFAAgF;AAChF,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,EAAE;IACnC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAM;IAC/B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACnB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACvB,CAAC,CAAA;AAWD,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,OAAO,GAAoB,EAAE;IACvE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,MAAM,CAAA;IACxC,MAAM,CAAC,GAAG,CACR,OAAO,CAAC,GAAG,IAAI,GAAG,EAClB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACrG,CAAA;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,OAAO;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,EAAE,OAAO,CAAC,CAAA;IACzD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAuB,EAAE,KAAW,EAAE,OAAO,GAAoB,EAAE;IACvF,MAAM,KAAK,GACT,OAAO,CAAC,OAAO;QACf,CAAC,EAAE,CAAC,EAAE;YACJ,iFAAiF;YACjF,QAAQ,CAAC,+BAA+B,EAAE,uEAAuE,CAAC,CAAA;YAClH,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAE3C,MAAM,OAAO,GAAG,GAAG;SAChB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,KAAK,CAAC,EAAE;QACX,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACtC,OAAO,EAAE,EAAE,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IACpF,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAEnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CACzB,CAAC,CAAC,EAAE,CAAC,EAAc,EAAE,CACnB,CAAC,CAAC,QAAQ;QACR,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;QAChH,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CACnC,CAAA;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAA;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAClC,MAAM,KAAK,GAAG,KAAK,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAC7F,OAAO,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;AACtC,CAAC;AASD,MAAM,OAAO,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE5E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAU,EAAE,KAAiB,EAAE,OAAO,GAAoB,EAAE,EAAE,GAAiB;IAC9G,MAAM,MAAM,GAAG,GAAG,IAAK,UAAqC,CAAA;IAC5D,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAA;IAC1D,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAA;IAE9E,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAA;IAEnE,MAAM,KAAK,GAAG,CAAC,KAAgB,EAAE,QAAmB,EAAE,EAAE;QACtD,MAAM,MAAM,GAAG,IAAI,EAAE,CAAA;QACrB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QACnC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;QACzE,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAA;QAC/E,IAAI,GAAG,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAM;QAClF,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC;YAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;;YAC5E,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;IACjD,CAAC,CAAA;IAED,qFAAqF;IACrF,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAW,CAAC;QAAE,OAAO,EAAE,CAAA;SACvC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;IAChF,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;QACzC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACtB,QAAQ,GAAG,KAAK,CAAA;IAClB,CAAC,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,OAAO,EAAE,CAAA;QACT,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;IAC5B,CAAC,CAAA;IACD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAE1C,OAAO,GAAG,EAAE;QACV,WAAW,EAAE,CAAA;QACb,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC/C,CAAC,CAAA;AACH,CAAC"}

package/dist/core/shortcuts.d.ts

@@ -0,0 +1,36 @@
+import type { CommandId } from './commands.js';
+import type { Desk } from './desk.js';
+export type Keymap = Readonly<Record<string, CommandId>>;
+export interface Shortcut {
+    readonly key: string;
+    readonly mod: boolean;
+    readonly shift: boolean;
+    readonly alt: boolean;
+    readonly ctrl: boolean;
+}
+export declare function parseShortcut(text: string): Shortcut;
+/**
+ * Whether the app is running installed, rather than in a browser tab. Only then
+ * may it take shortcuts the browser normally owns, such as ⌘W (HIG.md §5).
+ */
+export declare const isInstalledApp: () => boolean;
+export declare const isApplePlatform: () => boolean;
+interface KeyLike {
+    readonly key: string;
+    readonly code?: string;
+    readonly metaKey: boolean;
+    readonly ctrlKey: boolean;
+    readonly shiftKey: boolean;
+    readonly altKey: boolean;
+}
+export declare function matchesShortcut(event: KeyLike, shortcut: Shortcut, apple?: boolean): boolean;
+/** How a menu shows a shortcut: `⇧⌘Z` on Apple devices, `Ctrl+Shift+Z` elsewhere. */
+export declare function formatShortcut(text: string, apple?: boolean): string;
+export interface ShortcutOptions {
+    readonly target?: EventTarget;
+    readonly apple?: boolean;
+}
+/** Performs commands from keyboard shortcuts. Returns a function that stops listening. */
+export declare function bindShortcuts(desk: Desk | null, keymap: Keymap | (() => Keymap), options?: ShortcutOptions): () => void;
+export {};
+//# sourceMappingURL=shortcuts.d.ts.map

package/dist/core/shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.d.ts","sourceRoot":"","sources":["../../src/core/shortcuts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AASrC,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;AAExD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAUpD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,OACuH,CAAA;AAEzJ,eAAO,MAAM,eAAe,QAAO,OAC0E,CAAA;AAE7G,UAAU,OAAO;IACf,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAaD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,UAAoB,GAAG,OAAO,CAUtG;AAMD,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAoB,GAAG,MAAM,CAK9E;AAKD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,IAAI,CAoB3H"}

package/dist/core/shortcuts.js

@@ -0,0 +1,73 @@
+import { perform } from './commands.js';
+const NAMES = { esc: 'escape', return: 'enter', comma: ',', space: ' ', backquote: '`' };
+export function parseShortcut(text) {
+    const parts = text.toLowerCase().split('+');
+    const key = parts.pop() ?? '';
+    return {
+        key: NAMES[key] ?? key,
+        mod: parts.includes('mod'),
+        shift: parts.includes('shift'),
+        alt: parts.includes('alt') || parts.includes('option'),
+        ctrl: parts.includes('ctrl'),
+    };
+}
+/**
+ * Whether the app is running installed, rather than in a browser tab. Only then
+ * may it take shortcuts the browser normally owns, such as ⌘W (HIG.md §5).
+ */
+export const isInstalledApp = () => typeof matchMedia === 'function' && (matchMedia('(display-mode: standalone)').matches || matchMedia('(display-mode: window-controls-overlay)').matches);
+export const isApplePlatform = () => typeof navigator !== 'undefined' && /mac|iphone|ipad|ipod/i.test(navigator.platform || navigator.userAgent);
+const CODES = {
+    BracketLeft: '[', BracketRight: ']', Backquote: '`', Comma: ',', Period: '.', Slash: '/', Semicolon: ';', Quote: "'", Minus: '-', Equal: '=', Backslash: '\\', Space: ' ',
+};
+/** The unmodified key a physical key stands for: ⌥ on a Mac turns `]` into `‘`, but the code is still BracketRight. */
+const keyFromCode = (code) => !code ? undefined
+    : code.startsWith('Key') ? code.slice(3).toLowerCase()
+        : code.startsWith('Digit') ? code.slice(5)
+            : CODES[code];
+export function matchesShortcut(event, shortcut, apple = isApplePlatform()) {
+    const wantMeta = apple && shortcut.mod;
+    const wantCtrl = shortcut.ctrl || (!apple && shortcut.mod);
+    return ((event.key.toLowerCase() === shortcut.key || keyFromCode(event.code) === shortcut.key) &&
+        event.metaKey === wantMeta &&
+        event.ctrlKey === wantCtrl &&
+        event.shiftKey === shortcut.shift &&
+        event.altKey === shortcut.alt);
+}
+const GLYPHS = {
+    escape: 'Esc', enter: '↩', ',': ',', ' ': 'Space', arrowup: '↑', arrowdown: '↓', arrowleft: '←', arrowright: '→', backspace: '⌫', '`': '`',
+};
+/** How a menu shows a shortcut: `⇧⌘Z` on Apple devices, `Ctrl+Shift+Z` elsewhere. */
+export function formatShortcut(text, apple = isApplePlatform()) {
+    const s = parseShortcut(text);
+    const key = GLYPHS[s.key] ?? s.key.toUpperCase();
+    if (apple)
+        return `${s.ctrl ? '⌃' : ''}${s.alt ? '⌥' : ''}${s.shift ? '⇧' : ''}${s.mod ? '⌘' : ''}${key}`;
+    return [s.ctrl || s.mod ? 'Ctrl' : '', s.alt ? 'Alt' : '', s.shift ? 'Shift' : '', key].filter(Boolean).join('+');
+}
+const isEditable = (target) => target instanceof Element && (target.closest('input, textarea, select, [contenteditable=""], [contenteditable="true"]') !== null);
+/** Performs commands from keyboard shortcuts. Returns a function that stops listening. */
+export function bindShortcuts(desk, keymap, options = {}) {
+    const target = options.target ?? globalThis;
+    const bind = (map) => Object.entries(map).map(([text, command]) => ({ shortcut: parseShortcut(text), command }));
+    // A keymap given as a function is read at each key press, for menus whose items change.
+    const fixed = typeof keymap === 'function' ? null : bind(keymap);
+    const onKeyDown = (event) => {
+        const key = event;
+        if (key.defaultPrevented || key.isComposing)
+            return;
+        const bindings = fixed ?? bind(keymap());
+        const binding = bindings.find(b => matchesShortcut(key, b.shortcut, options.apple));
+        if (!binding)
+            return;
+        // A bare key belongs to whatever is being typed into; a modified one can still be a command.
+        const plain = !binding.shortcut.mod && !binding.shortcut.ctrl && !binding.shortcut.alt;
+        if (plain && isEditable(key.target))
+            return;
+        if (perform(desk, binding.command))
+            key.preventDefault();
+    };
+    target.addEventListener('keydown', onKeyDown);
+    return () => target.removeEventListener('keydown', onKeyDown);
+}
+//# sourceMappingURL=shortcuts.js.map

package/dist/core/shortcuts.js.map

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

package/dist/core/titles.d.ts

@@ -0,0 +1,3 @@
+export declare function titleCase(text: string): string;
+export declare const isTitleCase: (text: string) => boolean;
+//# sourceMappingURL=titles.d.ts.map

package/dist/core/titles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"titles.d.ts","sourceRoot":"","sources":["../../src/core/titles.ts"],"names":[],"mappings":"AAeA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU9C;AAED,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,OAA0C,CAAA"}

package/dist/core/titles.js

@@ -0,0 +1,26 @@
+/*
+ * App and window names are names, so they are written in title case: Ride Card,
+ * Parts & Wear, Service History. It is not applied for you, because a window showing one
+ * document takes that document's own name, as written. Use `titleCase` where a name
+ * is defined, and `isTitleCase` in a test over the names an app defines.
+ */
+/** Short words that stay lower case inside a title: articles, conjunctions, short prepositions. */
+const MINOR = new Set(['a', 'an', 'and', 'as', 'at', 'but', 'by', 'for', 'in', 'nor', 'of', 'on', 'or', 'per', 'so', 'the', 'to', 'up', 'via', 'vs', 'yet']);
+// A word someone has already cased on purpose — iPhone, API, macOS — is left alone.
+const deliberate = (word) => /[A-Z]/.test(word.slice(1));
+const capital = (word) => word.charAt(0).toUpperCase() + word.slice(1);
+export function titleCase(text) {
+    const words = text.trim().split(/\s+/);
+    return words
+        .map((word, i) => {
+        if (deliberate(word))
+            return word;
+        const edge = i === 0 || i === words.length - 1;
+        if (!edge && MINOR.has(word.toLowerCase()))
+            return word.toLowerCase();
+        return word.split('-').map(capital).join('-');
+    })
+        .join(' ');
+}
+export const isTitleCase = (text) => titleCase(text) === text.trim();
+//# sourceMappingURL=titles.js.map

package/dist/core/titles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"titles.js","sourceRoot":"","sources":["../../src/core/titles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mGAAmG;AACnG,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;AAE5J,oFAAoF;AACpF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAEhE,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAE9E,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACtC,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACf,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QACjC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;QAC9C,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;QACrE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/C,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAA"}

package/dist/core/types.d.ts

@@ -0,0 +1,51 @@
+export type WindowId = string;
+export interface Frame {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface Size {
+    readonly width: number;
+    readonly height: number;
+}
+export type DeskWindow = 
+/** Fills the desk, at whatever size the desk is. */
+{
+    readonly id: WindowId;
+    readonly mode: 'filled';
+} | {
+    readonly id: WindowId;
+    readonly mode: 'floating';
+    readonly frame: Frame;
+};
+export type WindowMode = DeskWindow['mode'];
+export interface DeskState {
+    /** Open windows in the order they were opened. Arrange lays them out in this order, so focusing never reshuffles them. */
+    readonly windows: readonly DeskWindow[];
+    /** Window ids back to front. The last one has focus. */
+    readonly stack: readonly WindowId[];
+}
+export interface CascadeOptions {
+    readonly maxWidth: number;
+    readonly maxHeight: number;
+    readonly margin: number;
+    readonly step: {
+        readonly x: number;
+        readonly y: number;
+    };
+    /** After this many floating windows the cascade wraps back to the top-left. */
+    readonly wrap: number;
+}
+export interface DeskOptions {
+    readonly cascade?: Partial<CascadeOptions>;
+    /** Reports the stage's size, so floating windows open inside it. */
+    readonly stage?: () => Size;
+    readonly initial?: DeskState;
+}
+export interface OpenOptions {
+    /** Open as a free window rather than filling the desk. Given a frame, it floats there. */
+    readonly mode?: WindowMode;
+    readonly frame?: Frame;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAA;AAE7B,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,UAAU;AACpB,oDAAoD;AAClD;IAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAE/E,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;AAE3C,MAAM,WAAW,SAAS;IACxB,0HAA0H;IAC1H,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IACvC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CACvB"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}