@surdeddd/wmkit 0.3.0 → 0.4.0

package/README.md

@@ -15,16 +15,17 @@
 - 🪟 **Full window lifecycle** — open, close, focus, minimize, maximize, restore, drag, 8-direction resize
 - 🧠 **Headless core** — a serializable state machine plus a DOM controller; bring your own markup or use the glass theme
 - ⚛️ **Official adapters** — `@surdeddd/wmkit/react`, `/vue`, `/svelte`, `/solid`, `/angular`, all thin sugar over one core
-- ⊞ **Snap zones** — halves, quarters and drag-to-top maximize with a live preview
+- ⊞ **Snap zones** — halves, quarters, thirds and drag-to-top maximize with a live preview
 - 🧲 **Magnetism** — window edges align to neighbours and the viewport while dragging
 - ↩️ **Undo/redo** — every mutation is one step; a whole drag collapses into a single history entry
-- 🗂️ **Named layouts & arrange** — save/load desktop snapshots, `cascade`/`tile` in one call
-- ⌨️ **Accessible** — keyboard move/resize, F6 window cycling, focus-trapped modals, `aria-live` announcements
+- 🗂️ **Workspaces & layouts** — virtual desktops, saved snapshots, `cascade`/`tile` in one call
+- 🔒 **Aspect ratio lock** — pin a window to 16:9 or 4:3 and resize stays honest
+- ⌨️ **Accessible** — keyboard move/resize/snap, F6 window cycling, focus-trapped modals, `aria-live` announcements
 - ⚡ **Fast** — `transform`-only positioning, rAF-batched pointer input, structural sharing; 50 windows drag at 60fps
-- 💾 **Persistence** — one call to serialize the desktop, one call to restore it
+- 💾 **Persistence** — one call to serialize the desktop, one call to restore it, with versioned migrations
 - 🎨 **Three themes** — dark glass, light glass and Win98 retro, or bring your own CSS
 - 🖼️ **Popout** *(experimental)* — send a window into Document Picture-in-Picture
-- 📦 **Zero dependencies**, strict TypeScript, ESM + CJS, ~9.3 kB brotli core
+- 📦 **Zero dependencies**, strict TypeScript, ESM + CJS, ~10.7 kB brotli core
 
 ## Install
 
@@ -231,7 +232,7 @@ export class DesktopComponent implements AfterViewInit {
 
 ## Snap zones in action
 
-[![Snap zones — window tiled to the left half](https://raw.githubusercontent.com/Surdeddd/wmkit/main/.github/assets/snap.png)](https://surdeddd.github.io/wmkit/)
+[![Snap zones — three windows tiled into thirds](https://raw.githubusercontent.com/Surdeddd/wmkit/main/.github/assets/snap.png)](https://surdeddd.github.io/wmkit/)
 
 Throw a window against an edge or corner — a live preview shows the target zone, releasing tiles it. Halves, quarters, and drag-to-top maximize.
 
@@ -251,6 +252,7 @@ interface ManagerOptions {
   cascadeOrigin?: { x: number; y: number }
   idPrefix?: string
   historyLimit?: number         // undo/redo depth (default 50, 0 disables history)
+  workspace?: number            // initial virtual desktop (default 0)
 }
 ```
 
@@ -262,13 +264,16 @@ Manager methods:
 | `close(id)` / `closeAll()` | focus moves to the next eligible window |
 | `focus(id)` / `blur()` / `cycleFocus(dir?)` | focusing a minimized window restores it; modals block focus below them |
 | `minimize(id)` / `maximize(id)` / `restore(id)` / `toggleMaximize(id)` | restore returns to the pre-minimize stage, including maximized/snapped |
-| `snap(id, zone)` | `'left' \| 'right' \| 'top' \| 'bottom' \| 'top-left' \| …` |
-| `move(id, x, y)` / `moveBy(id, dx, dy)` / `resize(id, patch)` | resizing a snapped window unsnaps it |
+| `snap(id, zone)` | halves, quarters and thirds: `'left' \| 'right' \| 'top' \| 'bottom' \| 'top-left' \| … \| 'left-third' \| 'center-third' \| 'right-third'` |
+| `move(id, x, y)` / `moveBy(id, dx, dy)` / `resize(id, patch)` | resizing a snapped window unsnaps it; `aspectRatio` is preserved |
+| `center(id)` / `sendToBack(id)` | centre in the viewport, or drop to the bottom of the window's layer |
 | `restoreTo(id, bounds)` | used for drag-off-snap; stage → `normal` at explicit bounds |
-| `update(id, patch)` | title, layer, min/max size, per-window flags, `meta` |
-| `setViewport(size)` | re-derives maximized/snapped bounds, clamps the rest |
-| `serialize()` / `hydrate(data)` | JSON-safe snapshot of the whole desktop |
+| `update(id, patch)` | title, layer, min/max size, `aspectRatio`, per-window flags, `meta` |
+| `setViewport(size)` | re-derives maximized/snapped bounds, clamps the rest; never recorded in history |
+| `workspace()` / `setWorkspace(n)` / `moveToWorkspace(id, n)` | virtual desktops; focusing a window switches to its workspace |
+| `serialize()` / `hydrate(data)` | JSON-safe snapshot of the whole desktop, re-derived against the current viewport |
 | `undo()` / `redo()` / `canUndo()` / `canRedo()` / `clearHistory()` | every mutation is one step; a whole drag or resize collapses into a single entry |
+| `beginInteraction()` / `endInteraction()` / `abortInteraction()` | group a live gesture into one history entry, or drop it entirely on cancel |
 | `saveLayout(name)` / `loadLayout(name)` / `deleteLayout(name)` / `layoutNames()` | named desktop snapshots; `getLayout`/`setLayout` for external storage |
 | `arrange('cascade' \| 'tile')` | cascade staggers restored sizes, tile fills the viewport in a grid |
 | `minimizeAll()` / `restoreAll()` | bulk stage switches in one history step |
@@ -284,7 +289,7 @@ DOM controller: pointer drag with capture (touch/pen included), 8-direction resi
 ```ts
 interface DesktopOptions {
   snap?: boolean | { threshold?: number; cornerSize?: number; preview?: boolean; topEdge?: 'maximize' | 'top' | 'none' }
-  keyboard?: boolean | { moveStep?: number; cycle?: boolean }
+  keyboard?: boolean | { moveStep?: number; cycle?: boolean; snapShortcuts?: boolean; historyShortcuts?: boolean }
   announce?: boolean | Partial<AnnouncerMessages>   // localize screen-reader strings here
   autoViewport?: boolean                            // ResizeObserver → wm.setViewport (default true)
   magnetism?: boolean | { threshold?: number }      // edge-align to neighbours + viewport while dragging (default on, 8 px / 12 px coarse)
@@ -294,7 +299,7 @@ interface DesktopOptions {
 }
 ```
 
-Keyboard defaults: arrows move the focused window (16 px), `Alt` for 1 px steps, `Shift+arrows` resize, `F6` / `Shift+F6` cycle windows, `Escape` cancels an in-flight drag or resize.
+Keyboard defaults: arrows move the focused window (16 px), `Alt` for 1 px steps, `Shift+arrows` resize, `Ctrl/⌘+Alt+←/→` snap to a half, `Ctrl/⌘+Alt+↑/↓` maximize or minimize, `Ctrl/⌘+Z` / `Ctrl/⌘+Shift+Z` undo and redo, `F6` / `Shift+F6` cycle windows, `Escape` cancels an in-flight drag or resize (and drops it from the history).
 
 ### `persist(wm, options?)` — `@surdeddd/wmkit/persist`
 
@@ -307,6 +312,15 @@ store.clear()
 
 Storage defaults to `localStorage` (probed safely — SSR and private-mode friendly) and accepts any `getItem/setItem/removeItem` implementation.
 
+Payloads are wrapped in a `{ version, state }` envelope. Bump `version` when your window contract changes and pass `migrate` to upgrade older data — anything you cannot migrate is discarded instead of restored broken:
+
+```js
+persist(wm, {
+  version: 2,
+  migrate: (state, from) => (from === 1 ? upgrade(state) : null),
+})
+```
+
 ### `popout(wm, id, contentEl, options?)` — `@surdeddd/wmkit/popout` *(experimental)*
 
 Moves a window's content into a [Document Picture-in-Picture](https://developer.mozilla.org/docs/Web/API/Document_Picture-in-Picture_API) always-on-top OS window, keeping the same JS context and state. Feature-detect with `isPopoutSupported()`.
@@ -350,8 +364,8 @@ The core never touches `window`/`document` — create managers and even `hydrate
 
 ## Quality
 
-- 172 unit tests, **100%** line/branch/function/statement coverage on the core state machine and persistence
-- 178+ Playwright scenarios on Chromium, WebKit and mobile emulation: drag, 8-way resize, snap, magnetism, undo after drag, keyboard, touch, persistence across reloads, 50-window stress, modal traps, axe accessibility scans, visual regression screenshots
+- 216 unit tests, **100%** line/branch/function/statement coverage on the core state machine and persistence
+- 190+ Playwright scenarios on Chromium, WebKit and mobile emulation: drag, 8-way resize, snap, magnetism, workspaces, undo after drag, keyboard, touch, persistence across reloads, 50-window stress, modal traps, axe accessibility scans, visual regression screenshots
 - performance benchmarks run in CI on every push (`vitest bench`): 1 000 windows open in ~150 ms, a move among 50 windows costs ~1.2 µs, a full 100-step undo/redo sweep ~52 µs
 - `publint` + `@arethetypeswrong/cli` validate the published package, `size-limit` guards bundle budgets
 

package/README.ru.md

@@ -11,16 +11,17 @@
 - 🪟 **Полный жизненный цикл окна** — открытие, закрытие, фокус, сворачивание, разворачивание, восстановление, drag, ресайз в 8 направлениях
 - 🧠 **Headless-ядро** — сериализуемая стейт-машина плюс DOM-контроллер; своя разметка или готовая стеклянная тема
 - ⚛️ **Родные адаптеры** — `@surdeddd/wmkit/react`, `/vue`, `/svelte`, `/solid`, `/angular`, тонкий сахар над одним ядром
-- ⊞ **Snap-зоны** — половины, четверти и максимизация от верхнего края с живым превью
+- ⊞ **Snap-зоны** — половины, четверти, трети и максимизация от верхнего края с живым превью
 - 🧲 **Магнетизм** — края окна прилипают к соседям и вьюпорту при перетаскивании
 - ↩️ **Undo/redo** — каждая мутация = один шаг; целый drag схлопывается в одну запись истории
-- 🗂️ **Именованные layout'ы и arrange** — снапшоты рабочего стола, `cascade`/`tile` одним вызовом
-- ⌨️ **Доступность** — move/resize с клавиатуры, цикл окон по F6, focus-trap в модалках, `aria-live`-анонсы
+- 🗂️ **Рабочие столы и layout'ы** — виртуальные столы, снапшоты, `cascade`/`tile` одним вызовом
+- 🔒 **Фиксация пропорций** — окно с `aspectRatio` держит 16:9 или 4:3 при любом ресайзе
+- ⌨️ **Доступность** — move/resize/snap с клавиатуры, цикл окон по F6, focus-trap в модалках, `aria-live`-анонсы
 - ⚡ **Производительность** — позиционирование только через `transform`, rAF-батчинг ввода, structural sharing; 50 окон таскаются на 60fps
-- 💾 **Персист** — один вызов сериализует рабочий стол, один — восстанавливает
+- 💾 **Персист** — один вызов сериализует рабочий стол, один — восстанавливает, с версионированием и миграциями
 - 🎨 **Три темы** — тёмное стекло, светлое стекло и Win98-ретро, либо полностью свой CSS
 - 🖼️ **Popout** *(experimental)* — вынос окна в Document Picture-in-Picture
-- 📦 **Ноль зависимостей**, строгий TypeScript, ESM + CJS, ~9.3 kB brotli
+- 📦 **Ноль зависимостей**, строгий TypeScript, ESM + CJS, ~10.7 kB brotli
 
 ## Установка
 
@@ -93,11 +94,16 @@ wm.batch(() => { /* много операций — одно уведомлен
 wm.undo(); wm.redo()             // история изменений, drag = одна запись (historyLimit, default 50)
 wm.saveLayout('работа'); wm.loadLayout('работа')   // именованные снапшоты рабочего стола
 wm.arrange('tile')               // или 'cascade'; плюс minimizeAll() / restoreAll()
+
+wm.setWorkspace(1)               // виртуальные столы: окна других столов скрыты и не фокусируются
+wm.moveToWorkspace('docs', 1)    // focus('docs') сам переключит стол обратно
+wm.open({ id: 'video', aspectRatio: 16 / 9 })      // ресайз держит пропорцию
+wm.center('video'); wm.sendToBack('docs')
 ```
 
 Слои: `normal` < `floating` (always-on-top) < `modal`. Модалка блокирует фокус нижних окон (попытка — событие `modalblocked` и flash-анимация), Tab заперт внутри.
 
-Клавиатура по умолчанию: стрелки двигают сфокусированное окно (16 px), `Alt` — шаг 1 px, `Shift+стрелки` — ресайз, `F6`/`Shift+F6` — цикл по окнам, `Escape` отменяет активный drag/resize.
+Клавиатура по умолчанию: стрелки двигают сфокусированное окно (16 px), `Alt` — шаг 1 px, `Shift+стрелки` — ресайз, `Ctrl/⌘+Alt+←/→` — прилипание к половине, `Ctrl/⌘+Alt+↑/↓` — развернуть/свернуть, `Ctrl/⌘+Z` и `Ctrl/⌘+Shift+Z` — отмена и повтор, `F6`/`Shift+F6` — цикл по окнам, `Escape` отменяет активный drag/resize (и убирает его из истории).
 
 Магнетизм включён из коробки (порог 8 px, на тач-устройствах 12 px): `attachDesktop(wm, el, { magnetism: { threshold: 16 } })` или `magnetism: false`. Свой контекст-меню тайтлбара — через `onTitlebarContextMenu(win, event)` (правый клик и long-press на таче).
 
@@ -106,6 +112,11 @@ wm.arrange('tile')               // или 'cascade'; плюс minimizeAll() / r
 ```js
 import { persist } from '@surdeddd/wmkit/persist'
 persist(wm, { key: 'my-desktop' })  // авто-восстановление + debounce-сохранение
+
+persist(wm, {                       // версия контракта + миграция старых данных
+  version: 2,
+  migrate: (state, from) => (from === 1 ? upgrade(state) : null),
+})
 ```
 
 ### Popout (experimental)
@@ -129,8 +140,8 @@ if (isPopoutSupported()) await popout(wm, 'docs', contentElement)
 
 ## Качество
 
-- 172 юнит-теста, **100%** покрытие стейт-машины и persist по строкам/веткам/функциям
-- 178+ Playwright-сценариев на Chromium, WebKit и мобильной эмуляции: drag, ресайз во все стороны, снэп, магнетизм, undo после drag, клавиатура, touch, персист через перезагрузку, стресс на 50 окон, модальные ловушки, axe-аудиты доступности, визуальная регрессия по скриншотам
+- 216 юнит-тестов, **100%** покрытие стейт-машины и persist по строкам/веткам/функциям
+- 190+ Playwright-сценариев на Chromium, WebKit и мобильной эмуляции: drag, ресайз во все стороны, снэп, магнетизм, рабочие столы, undo после drag, клавиатура, touch, персист через перезагрузку, стресс на 50 окон, модальные ловушки, axe-аудиты доступности, визуальная регрессия по скриншотам
 - перф-бенчмарки в CI на каждый push (`vitest bench`): 1 000 окон открываются за ~150 мс, move среди 50 окон ~1.2 мкс, полный undo/redo-проход на 100 шагов ~52 мкс
 - `publint` + `@arethetypeswrong/cli` проверяют валидность пакета, `size-limit` следит за бюджетами
 

package/dist/angular.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkB35DANTX_cjs = require('./chunk-B35DANTX.cjs');
+var chunk3KZZOLHW_cjs = require('./chunk-3KZZOLHW.cjs');
 var core = require('@angular/core');
 
 function onDestroy(dispose) {
@@ -13,7 +13,7 @@ function onDestroy(dispose) {
   destroyRef?.onDestroy(dispose);
 }
 function useWindowManager(options) {
-  const wm = chunkB35DANTX_cjs.createWindowManager(options);
+  const wm = chunk3KZZOLHW_cjs.createWindowManager(options);
   onDestroy(() => wm.destroy());
   return wm;
 }
@@ -28,7 +28,8 @@ function useWmWindow(wm, id) {
   return core.computed(() => state().windows[id]);
 }
 function createDesktop(wm, options) {
-  const binder = chunkB35DANTX_cjs.createDesktopBinder(wm, options);
+  const binder = chunk3KZZOLHW_cjs.createDesktopBinder(wm, options);
+  onDestroy(() => binder.destroy());
   return {
     binder,
     desktop(element) {

package/dist/angular.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/adapters/angular.ts"],"names":["inject","DestroyRef","createWindowManager","signal","computed","createDesktopBinder"],"mappings":";;;;;AAMA,SAAS,UAAU,OAAA,EAA2B;AAC5C,EAAA,IAAI,UAAA,GAAgC,IAAA;AACpC,EAAA,IAAI;AACF,IAAA,UAAA,GAAaA,YAAOC,eAAU,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,UAAA,GAAa,IAAA;AAAA,EACf;AACA,EAAA,UAAA,EAAY,UAAU,OAAO,CAAA;AAC/B;AAEO,SAAS,iBAAiB,OAAA,EAAyC;AACxE,EAAA,MAAM,EAAA,GAAKC,sCAAoB,OAAO,CAAA;AACtC,EAAA,SAAA,CAAU,MAAM,EAAA,CAAG,OAAA,EAAS,CAAA;AAC5B,EAAA,OAAO,EAAA;AACT;AAEO,SAAS,WAAW,EAAA,EAAyC;AAClE,EAAA,MAAM,KAAA,GAAQC,WAAA,CAAO,EAAA,CAAG,QAAA,EAAU,CAAA;AAClC,EAAA,MAAM,IAAA,GAAO,GAAG,SAAA,CAAU,CAAC,SAAS,KAAA,CAAM,GAAA,CAAI,IAAI,CAAC,CAAA;AACnD,EAAA,SAAA,CAAU,IAAI,CAAA;AACd,EAAA,OAAO,MAAM,UAAA,EAAW;AAC1B;AAEO,SAAS,WAAA,CAAY,IAAmB,EAAA,EAA6C;AAC1F,EAAA,MAAM,KAAA,GAAQ,WAAW,EAAE,CAAA;AAC3B,EAAA,OAAOC,cAAS,MAAM,KAAA,EAAM,CAAE,OAAA,CAAQ,EAAE,CAAC,CAAA;AAC3C;AAQO,SAAS,aAAA,CAAc,IAAmB,OAAA,EAA0C;AACzF,EAAA,MAAM,MAAA,GAASC,qCAAA,CAAoB,EAAA,EAAI,OAAO,CAAA;AAC9C,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,QAAQ,OAAA,EAAS;AACf,MAAA,MAAM,MAAA,GAAS,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AACzC,MAAA,SAAA,CAAU,MAAM,CAAA;AAAA,IAClB,CAAA;AAAA,IACA,MAAA,CAAO,IAAI,aAAA,EAAe;AACxB,MAAA,OAAO,CAAC,OAAA,KAAY;AAClB,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,UAAA,CAAW,EAAA,EAAI,SAAS,aAAa,CAAA;AAC3D,QAAA,SAAA,CAAU,MAAM,CAAA;AAAA,MAClB,CAAA;AAAA,IACF;AAAA,GACF;AACF","file":"angular.cjs","sourcesContent":["import { computed, DestroyRef, inject, type Signal, signal } from '@angular/core'\nimport { createWindowManager } from '../core/manager'\nimport type { ManagerOptions, ManagerState, WindowManager, WindowState } from '../core/types'\nimport { createDesktopBinder, type DesktopBinder } from '../dom/binder'\nimport type { DesktopOptions, WindowAttachOptions } from '../dom/shared'\n\nfunction onDestroy(dispose: () => void): void {\n  let destroyRef: DestroyRef | null = null\n  try {\n    destroyRef = inject(DestroyRef)\n  } catch {\n    destroyRef = null\n  }\n  destroyRef?.onDestroy(dispose)\n}\n\nexport function useWindowManager(options?: ManagerOptions): WindowManager {\n  const wm = createWindowManager(options)\n  onDestroy(() => wm.destroy())\n  return wm\n}\n\nexport function useWmState(wm: WindowManager): Signal<ManagerState> {\n  const state = signal(wm.getState())\n  const stop = wm.subscribe((next) => state.set(next))\n  onDestroy(stop)\n  return state.asReadonly()\n}\n\nexport function useWmWindow(wm: WindowManager, id: string): Signal<WindowState | undefined> {\n  const state = useWmState(wm)\n  return computed(() => state().windows[id])\n}\n\nexport interface AngularDesktop {\n  binder: DesktopBinder\n  desktop(element: HTMLElement): void\n  window(id: string, options?: WindowAttachOptions): (element: HTMLElement) => void\n}\n\nexport function createDesktop(wm: WindowManager, options?: DesktopOptions): AngularDesktop {\n  const binder = createDesktopBinder(wm, options)\n  return {\n    binder,\n    desktop(element) {\n      const unbind = binder.bindDesktop(element)\n      onDestroy(unbind)\n    },\n    window(id, windowOptions) {\n      return (element) => {\n        const unbind = binder.bindWindow(id, element, windowOptions)\n        onDestroy(unbind)\n      }\n    },\n  }\n}\n"]}
+{"version":3,"sources":["../src/adapters/angular.ts"],"names":["inject","DestroyRef","createWindowManager","signal","computed","createDesktopBinder"],"mappings":";;;;;AAMA,SAAS,UAAU,OAAA,EAA2B;AAC5C,EAAA,IAAI,UAAA,GAAgC,IAAA;AACpC,EAAA,IAAI;AACF,IAAA,UAAA,GAAaA,YAAOC,eAAU,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,UAAA,GAAa,IAAA;AAAA,EACf;AACA,EAAA,UAAA,EAAY,UAAU,OAAO,CAAA;AAC/B;AAEO,SAAS,iBAAiB,OAAA,EAAyC;AACxE,EAAA,MAAM,EAAA,GAAKC,sCAAoB,OAAO,CAAA;AACtC,EAAA,SAAA,CAAU,MAAM,EAAA,CAAG,OAAA,EAAS,CAAA;AAC5B,EAAA,OAAO,EAAA;AACT;AAEO,SAAS,WAAW,EAAA,EAAyC;AAClE,EAAA,MAAM,KAAA,GAAQC,WAAA,CAAO,EAAA,CAAG,QAAA,EAAU,CAAA;AAClC,EAAA,MAAM,IAAA,GAAO,GAAG,SAAA,CAAU,CAAC,SAAS,KAAA,CAAM,GAAA,CAAI,IAAI,CAAC,CAAA;AACnD,EAAA,SAAA,CAAU,IAAI,CAAA;AACd,EAAA,OAAO,MAAM,UAAA,EAAW;AAC1B;AAEO,SAAS,WAAA,CAAY,IAAmB,EAAA,EAA6C;AAC1F,EAAA,MAAM,KAAA,GAAQ,WAAW,EAAE,CAAA;AAC3B,EAAA,OAAOC,cAAS,MAAM,KAAA,EAAM,CAAE,OAAA,CAAQ,EAAE,CAAC,CAAA;AAC3C;AAQO,SAAS,aAAA,CAAc,IAAmB,OAAA,EAA0C;AACzF,EAAA,MAAM,MAAA,GAASC,qCAAA,CAAoB,EAAA,EAAI,OAAO,CAAA;AAC9C,EAAA,SAAA,CAAU,MAAM,MAAA,CAAO,OAAA,EAAS,CAAA;AAChC,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,QAAQ,OAAA,EAAS;AACf,MAAA,MAAM,MAAA,GAAS,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AACzC,MAAA,SAAA,CAAU,MAAM,CAAA;AAAA,IAClB,CAAA;AAAA,IACA,MAAA,CAAO,IAAI,aAAA,EAAe;AACxB,MAAA,OAAO,CAAC,OAAA,KAAY;AAClB,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,UAAA,CAAW,EAAA,EAAI,SAAS,aAAa,CAAA;AAC3D,QAAA,SAAA,CAAU,MAAM,CAAA;AAAA,MAClB,CAAA;AAAA,IACF;AAAA,GACF;AACF","file":"angular.cjs","sourcesContent":["import { computed, DestroyRef, inject, type Signal, signal } from '@angular/core'\nimport { createWindowManager } from '../core/manager'\nimport type { ManagerOptions, ManagerState, WindowManager, WindowState } from '../core/types'\nimport { createDesktopBinder, type DesktopBinder } from '../dom/binder'\nimport type { DesktopOptions, WindowAttachOptions } from '../dom/shared'\n\nfunction onDestroy(dispose: () => void): void {\n  let destroyRef: DestroyRef | null = null\n  try {\n    destroyRef = inject(DestroyRef)\n  } catch {\n    destroyRef = null\n  }\n  destroyRef?.onDestroy(dispose)\n}\n\nexport function useWindowManager(options?: ManagerOptions): WindowManager {\n  const wm = createWindowManager(options)\n  onDestroy(() => wm.destroy())\n  return wm\n}\n\nexport function useWmState(wm: WindowManager): Signal<ManagerState> {\n  const state = signal(wm.getState())\n  const stop = wm.subscribe((next) => state.set(next))\n  onDestroy(stop)\n  return state.asReadonly()\n}\n\nexport function useWmWindow(wm: WindowManager, id: string): Signal<WindowState | undefined> {\n  const state = useWmState(wm)\n  return computed(() => state().windows[id])\n}\n\nexport interface AngularDesktop {\n  binder: DesktopBinder\n  desktop(element: HTMLElement): void\n  window(id: string, options?: WindowAttachOptions): (element: HTMLElement) => void\n}\n\nexport function createDesktop(wm: WindowManager, options?: DesktopOptions): AngularDesktop {\n  const binder = createDesktopBinder(wm, options)\n  onDestroy(() => binder.destroy())\n  return {\n    binder,\n    desktop(element) {\n      const unbind = binder.bindDesktop(element)\n      onDestroy(unbind)\n    },\n    window(id, windowOptions) {\n      return (element) => {\n        const unbind = binder.bindWindow(id, element, windowOptions)\n        onDestroy(unbind)\n      }\n    },\n  }\n}\n"]}

package/dist/angular.d.cts

@@ -1,6 +1,6 @@
 import { Signal } from '@angular/core';
-import { W as WindowManager, M as ManagerOptions, a as ManagerState, b as WindowState } from './types-DdCtDHgt.cjs';
-import { D as DesktopBinder, W as WindowAttachOptions, a as DesktopOptions } from './binder-Dq_AZRbo.cjs';
+import { W as WindowManager, M as ManagerOptions, a as ManagerState, b as WindowState } from './types-t6pyVYKN.cjs';
+import { D as DesktopBinder, W as WindowAttachOptions, a as DesktopOptions } from './binder-Dl07SXIM.cjs';
 
 declare function useWindowManager(options?: ManagerOptions): WindowManager;
 declare function useWmState(wm: WindowManager): Signal<ManagerState>;

package/dist/angular.d.ts

@@ -1,6 +1,6 @@
 import { Signal } from '@angular/core';
-import { W as WindowManager, M as ManagerOptions, a as ManagerState, b as WindowState } from './types-DdCtDHgt.js';
-import { D as DesktopBinder, W as WindowAttachOptions, a as DesktopOptions } from './binder-0Oku22Nc.js';
+import { W as WindowManager, M as ManagerOptions, a as ManagerState, b as WindowState } from './types-t6pyVYKN.js';
+import { D as DesktopBinder, W as WindowAttachOptions, a as DesktopOptions } from './binder-B2A2IZGh.js';
 
 declare function useWindowManager(options?: ManagerOptions): WindowManager;
 declare function useWmState(wm: WindowManager): Signal<ManagerState>;

package/dist/angular.js

@@ -1,4 +1,4 @@
-import { createWindowManager, createDesktopBinder } from './chunk-YCHJXSTC.js';
+import { createWindowManager, createDesktopBinder } from './chunk-FPZDAKNP.js';
 import { signal, computed, inject, DestroyRef } from '@angular/core';
 
 function onDestroy(dispose) {
@@ -27,6 +27,7 @@ function useWmWindow(wm, id) {
 }
 function createDesktop(wm, options) {
   const binder = createDesktopBinder(wm, options);
+  onDestroy(() => binder.destroy());
   return {
     binder,
     desktop(element) {

package/dist/angular.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/adapters/angular.ts"],"names":[],"mappings":";;;AAMA,SAAS,UAAU,OAAA,EAA2B;AAC5C,EAAA,IAAI,UAAA,GAAgC,IAAA;AACpC,EAAA,IAAI;AACF,IAAA,UAAA,GAAa,OAAO,UAAU,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,UAAA,GAAa,IAAA;AAAA,EACf;AACA,EAAA,UAAA,EAAY,UAAU,OAAO,CAAA;AAC/B;AAEO,SAAS,iBAAiB,OAAA,EAAyC;AACxE,EAAA,MAAM,EAAA,GAAK,oBAAoB,OAAO,CAAA;AACtC,EAAA,SAAA,CAAU,MAAM,EAAA,CAAG,OAAA,EAAS,CAAA;AAC5B,EAAA,OAAO,EAAA;AACT;AAEO,SAAS,WAAW,EAAA,EAAyC;AAClE,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,EAAA,CAAG,QAAA,EAAU,CAAA;AAClC,EAAA,MAAM,IAAA,GAAO,GAAG,SAAA,CAAU,CAAC,SAAS,KAAA,CAAM,GAAA,CAAI,IAAI,CAAC,CAAA;AACnD,EAAA,SAAA,CAAU,IAAI,CAAA;AACd,EAAA,OAAO,MAAM,UAAA,EAAW;AAC1B;AAEO,SAAS,WAAA,CAAY,IAAmB,EAAA,EAA6C;AAC1F,EAAA,MAAM,KAAA,GAAQ,WAAW,EAAE,CAAA;AAC3B,EAAA,OAAO,SAAS,MAAM,KAAA,EAAM,CAAE,OAAA,CAAQ,EAAE,CAAC,CAAA;AAC3C;AAQO,SAAS,aAAA,CAAc,IAAmB,OAAA,EAA0C;AACzF,EAAA,MAAM,MAAA,GAAS,mBAAA,CAAoB,EAAA,EAAI,OAAO,CAAA;AAC9C,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,QAAQ,OAAA,EAAS;AACf,MAAA,MAAM,MAAA,GAAS,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AACzC,MAAA,SAAA,CAAU,MAAM,CAAA;AAAA,IAClB,CAAA;AAAA,IACA,MAAA,CAAO,IAAI,aAAA,EAAe;AACxB,MAAA,OAAO,CAAC,OAAA,KAAY;AAClB,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,UAAA,CAAW,EAAA,EAAI,SAAS,aAAa,CAAA;AAC3D,QAAA,SAAA,CAAU,MAAM,CAAA;AAAA,MAClB,CAAA;AAAA,IACF;AAAA,GACF;AACF","file":"angular.js","sourcesContent":["import { computed, DestroyRef, inject, type Signal, signal } from '@angular/core'\nimport { createWindowManager } from '../core/manager'\nimport type { ManagerOptions, ManagerState, WindowManager, WindowState } from '../core/types'\nimport { createDesktopBinder, type DesktopBinder } from '../dom/binder'\nimport type { DesktopOptions, WindowAttachOptions } from '../dom/shared'\n\nfunction onDestroy(dispose: () => void): void {\n  let destroyRef: DestroyRef | null = null\n  try {\n    destroyRef = inject(DestroyRef)\n  } catch {\n    destroyRef = null\n  }\n  destroyRef?.onDestroy(dispose)\n}\n\nexport function useWindowManager(options?: ManagerOptions): WindowManager {\n  const wm = createWindowManager(options)\n  onDestroy(() => wm.destroy())\n  return wm\n}\n\nexport function useWmState(wm: WindowManager): Signal<ManagerState> {\n  const state = signal(wm.getState())\n  const stop = wm.subscribe((next) => state.set(next))\n  onDestroy(stop)\n  return state.asReadonly()\n}\n\nexport function useWmWindow(wm: WindowManager, id: string): Signal<WindowState | undefined> {\n  const state = useWmState(wm)\n  return computed(() => state().windows[id])\n}\n\nexport interface AngularDesktop {\n  binder: DesktopBinder\n  desktop(element: HTMLElement): void\n  window(id: string, options?: WindowAttachOptions): (element: HTMLElement) => void\n}\n\nexport function createDesktop(wm: WindowManager, options?: DesktopOptions): AngularDesktop {\n  const binder = createDesktopBinder(wm, options)\n  return {\n    binder,\n    desktop(element) {\n      const unbind = binder.bindDesktop(element)\n      onDestroy(unbind)\n    },\n    window(id, windowOptions) {\n      return (element) => {\n        const unbind = binder.bindWindow(id, element, windowOptions)\n        onDestroy(unbind)\n      }\n    },\n  }\n}\n"]}
+{"version":3,"sources":["../src/adapters/angular.ts"],"names":[],"mappings":";;;AAMA,SAAS,UAAU,OAAA,EAA2B;AAC5C,EAAA,IAAI,UAAA,GAAgC,IAAA;AACpC,EAAA,IAAI;AACF,IAAA,UAAA,GAAa,OAAO,UAAU,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,UAAA,GAAa,IAAA;AAAA,EACf;AACA,EAAA,UAAA,EAAY,UAAU,OAAO,CAAA;AAC/B;AAEO,SAAS,iBAAiB,OAAA,EAAyC;AACxE,EAAA,MAAM,EAAA,GAAK,oBAAoB,OAAO,CAAA;AACtC,EAAA,SAAA,CAAU,MAAM,EAAA,CAAG,OAAA,EAAS,CAAA;AAC5B,EAAA,OAAO,EAAA;AACT;AAEO,SAAS,WAAW,EAAA,EAAyC;AAClE,EAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,EAAA,CAAG,QAAA,EAAU,CAAA;AAClC,EAAA,MAAM,IAAA,GAAO,GAAG,SAAA,CAAU,CAAC,SAAS,KAAA,CAAM,GAAA,CAAI,IAAI,CAAC,CAAA;AACnD,EAAA,SAAA,CAAU,IAAI,CAAA;AACd,EAAA,OAAO,MAAM,UAAA,EAAW;AAC1B;AAEO,SAAS,WAAA,CAAY,IAAmB,EAAA,EAA6C;AAC1F,EAAA,MAAM,KAAA,GAAQ,WAAW,EAAE,CAAA;AAC3B,EAAA,OAAO,SAAS,MAAM,KAAA,EAAM,CAAE,OAAA,CAAQ,EAAE,CAAC,CAAA;AAC3C;AAQO,SAAS,aAAA,CAAc,IAAmB,OAAA,EAA0C;AACzF,EAAA,MAAM,MAAA,GAAS,mBAAA,CAAoB,EAAA,EAAI,OAAO,CAAA;AAC9C,EAAA,SAAA,CAAU,MAAM,MAAA,CAAO,OAAA,EAAS,CAAA;AAChC,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,QAAQ,OAAA,EAAS;AACf,MAAA,MAAM,MAAA,GAAS,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AACzC,MAAA,SAAA,CAAU,MAAM,CAAA;AAAA,IAClB,CAAA;AAAA,IACA,MAAA,CAAO,IAAI,aAAA,EAAe;AACxB,MAAA,OAAO,CAAC,OAAA,KAAY;AAClB,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,UAAA,CAAW,EAAA,EAAI,SAAS,aAAa,CAAA;AAC3D,QAAA,SAAA,CAAU,MAAM,CAAA;AAAA,MAClB,CAAA;AAAA,IACF;AAAA,GACF;AACF","file":"angular.js","sourcesContent":["import { computed, DestroyRef, inject, type Signal, signal } from '@angular/core'\nimport { createWindowManager } from '../core/manager'\nimport type { ManagerOptions, ManagerState, WindowManager, WindowState } from '../core/types'\nimport { createDesktopBinder, type DesktopBinder } from '../dom/binder'\nimport type { DesktopOptions, WindowAttachOptions } from '../dom/shared'\n\nfunction onDestroy(dispose: () => void): void {\n  let destroyRef: DestroyRef | null = null\n  try {\n    destroyRef = inject(DestroyRef)\n  } catch {\n    destroyRef = null\n  }\n  destroyRef?.onDestroy(dispose)\n}\n\nexport function useWindowManager(options?: ManagerOptions): WindowManager {\n  const wm = createWindowManager(options)\n  onDestroy(() => wm.destroy())\n  return wm\n}\n\nexport function useWmState(wm: WindowManager): Signal<ManagerState> {\n  const state = signal(wm.getState())\n  const stop = wm.subscribe((next) => state.set(next))\n  onDestroy(stop)\n  return state.asReadonly()\n}\n\nexport function useWmWindow(wm: WindowManager, id: string): Signal<WindowState | undefined> {\n  const state = useWmState(wm)\n  return computed(() => state().windows[id])\n}\n\nexport interface AngularDesktop {\n  binder: DesktopBinder\n  desktop(element: HTMLElement): void\n  window(id: string, options?: WindowAttachOptions): (element: HTMLElement) => void\n}\n\nexport function createDesktop(wm: WindowManager, options?: DesktopOptions): AngularDesktop {\n  const binder = createDesktopBinder(wm, options)\n  onDestroy(() => binder.destroy())\n  return {\n    binder,\n    desktop(element) {\n      const unbind = binder.bindDesktop(element)\n      onDestroy(unbind)\n    },\n    window(id, windowOptions) {\n      return (element) => {\n        const unbind = binder.bindWindow(id, element, windowOptions)\n        onDestroy(unbind)\n      }\n    },\n  }\n}\n"]}

package/dist/{binder-0Oku22Nc.d.ts → binder-B2A2IZGh.d.ts}

@@ -1,9 +1,10 @@
-import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-DdCtDHgt.js';
+import { f as Size, B as Bounds, g as SnapZone, W as WindowManager, b as WindowState } from './types-t6pyVYKN.js';
 
 declare function clamp(value: number, min: number, max: number): number;
 declare function clampSize(size: Size, min: Size, max: Size | null): Size;
 declare function clampToViewport(bounds: Bounds, viewport: Size, minVisible: number): Bounds;
 declare function boundsEqual(a: Bounds, b: Bounds): boolean;
+declare function applyAspect(size: Size, ratio: number, min: Size, max: Size | null, drive: 'width' | 'height'): Size;
 declare function zoneBounds(zone: SnapZone, viewport: Size): Bounds;
 interface SnapDetectOptions {
     threshold?: number;
@@ -26,6 +27,7 @@ interface AnnouncerMessages {
     maximized(title: string): string;
     snapped(title: string, zone: string): string;
     focused(title: string): string;
+    workspace(index: number): string;
 }
 declare const defaultMessages: AnnouncerMessages;
 interface Announcer {
@@ -42,6 +44,8 @@ interface DesktopSnapOptions extends SnapDetectOptions {
 interface DesktopKeyboardOptions {
     moveStep?: number;
     cycle?: boolean;
+    snapShortcuts?: boolean;
+    historyShortcuts?: boolean;
 }
 interface HitAreaOptions {
     edge?: number;
@@ -77,7 +81,8 @@ interface DesktopBinder {
     controller(): DesktopController | null;
     bindDesktop(element: HTMLElement): () => void;
     bindWindow(id: string, element: HTMLElement, options?: WindowAttachOptions): () => void;
+    destroy(): void;
 }
 declare function createDesktopBinder(wm: WindowManager, options?: DesktopOptions): DesktopBinder;
 
-export { type Announcer as A, type DesktopBinder as D, type HitAreaOptions as H, type MagnetResult as M, type SnapDetectOptions as S, type WindowAttachOptions as W, type DesktopOptions as a, type DesktopController as b, type AnnouncerMessages as c, type DesktopKeyboardOptions as d, type DesktopSnapOptions as e, type MagnetismOptions as f, boundsEqual as g, clamp as h, clampSize as i, clampToViewport as j, createAnnouncer as k, createDesktopBinder as l, defaultMessages as m, detectSnapZone as n, magnetize as o, zoneBounds as z };
+export { type Announcer as A, type DesktopBinder as D, type HitAreaOptions as H, type MagnetResult as M, type SnapDetectOptions as S, type WindowAttachOptions as W, type DesktopOptions as a, type DesktopController as b, type AnnouncerMessages as c, type DesktopKeyboardOptions as d, type DesktopSnapOptions as e, type MagnetismOptions as f, applyAspect as g, boundsEqual as h, clamp as i, clampSize as j, clampToViewport as k, createAnnouncer as l, createDesktopBinder as m, defaultMessages as n, detectSnapZone as o, magnetize as p, zoneBounds as z };

package/dist/{binder-Dq_AZRbo.d.cts → binder-Dl07SXIM.d.cts}

@@ -1,9 +1,10 @@
-import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-DdCtDHgt.cjs';
+import { f as Size, B as Bounds, g as SnapZone, W as WindowManager, b as WindowState } from './types-t6pyVYKN.cjs';
 
 declare function clamp(value: number, min: number, max: number): number;
 declare function clampSize(size: Size, min: Size, max: Size | null): Size;
 declare function clampToViewport(bounds: Bounds, viewport: Size, minVisible: number): Bounds;
 declare function boundsEqual(a: Bounds, b: Bounds): boolean;
+declare function applyAspect(size: Size, ratio: number, min: Size, max: Size | null, drive: 'width' | 'height'): Size;
 declare function zoneBounds(zone: SnapZone, viewport: Size): Bounds;
 interface SnapDetectOptions {
     threshold?: number;
@@ -26,6 +27,7 @@ interface AnnouncerMessages {
     maximized(title: string): string;
     snapped(title: string, zone: string): string;
     focused(title: string): string;
+    workspace(index: number): string;
 }
 declare const defaultMessages: AnnouncerMessages;
 interface Announcer {
@@ -42,6 +44,8 @@ interface DesktopSnapOptions extends SnapDetectOptions {
 interface DesktopKeyboardOptions {
     moveStep?: number;
     cycle?: boolean;
+    snapShortcuts?: boolean;
+    historyShortcuts?: boolean;
 }
 interface HitAreaOptions {
     edge?: number;
@@ -77,7 +81,8 @@ interface DesktopBinder {
     controller(): DesktopController | null;
     bindDesktop(element: HTMLElement): () => void;
     bindWindow(id: string, element: HTMLElement, options?: WindowAttachOptions): () => void;
+    destroy(): void;
 }
 declare function createDesktopBinder(wm: WindowManager, options?: DesktopOptions): DesktopBinder;
 
-export { type Announcer as A, type DesktopBinder as D, type HitAreaOptions as H, type MagnetResult as M, type SnapDetectOptions as S, type WindowAttachOptions as W, type DesktopOptions as a, type DesktopController as b, type AnnouncerMessages as c, type DesktopKeyboardOptions as d, type DesktopSnapOptions as e, type MagnetismOptions as f, boundsEqual as g, clamp as h, clampSize as i, clampToViewport as j, createAnnouncer as k, createDesktopBinder as l, defaultMessages as m, detectSnapZone as n, magnetize as o, zoneBounds as z };
+export { type Announcer as A, type DesktopBinder as D, type HitAreaOptions as H, type MagnetResult as M, type SnapDetectOptions as S, type WindowAttachOptions as W, type DesktopOptions as a, type DesktopController as b, type AnnouncerMessages as c, type DesktopKeyboardOptions as d, type DesktopSnapOptions as e, type MagnetismOptions as f, applyAspect as g, boundsEqual as h, clamp as i, clampSize as j, clampToViewport as k, createAnnouncer as l, createDesktopBinder as m, defaultMessages as n, detectSnapZone as o, magnetize as p, zoneBounds as z };