@surdeddd/wmkit 0.2.0 → 0.4.0

package/README.md

@@ -14,13 +14,18 @@
 
 - 🪟 **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`, `@surdeddd/wmkit/vue`, `@surdeddd/wmkit/svelte`, `@surdeddd/wmkit/solid`, all thin sugar over one core
-- ⊞ **Snap zones** — halves, quarters and drag-to-top maximize with a live preview
-- ⌨️ **Accessible** — keyboard move/resize, F6 window cycling, focus-trapped modals, `aria-live` announcements
+- ⚛️ **Official adapters** — `@surdeddd/wmkit/react`, `/vue`, `/svelte`, `/solid`, `/angular`, all thin sugar over one core
+- ⊞ **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
+- 🗂️ **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 kB gzip core
+- 📦 **Zero dependencies**, strict TypeScript, ESM + CJS, ~10.7 kB brotli core
 
 ## Install
 
@@ -190,9 +195,44 @@ function Desktop() {
 }
 ```
 
+## Angular
+
+```ts
+import { AfterViewInit, Component, ElementRef, ViewChild } from '@angular/core'
+import { useWindowManager, createDesktop, useWmState } from '@surdeddd/wmkit/angular'
+
+@Component({
+  selector: 'app-desktop',
+  standalone: true,
+  template: `
+    <div #desktop style="position: relative; height: 100vh">
+      <section #hello>
+        <header data-wm-drag><span data-wm-title>Hello</span></header>
+        <div data-wm-content>signals inside</div>
+      </section>
+    </div>
+  `,
+})
+export class DesktopComponent implements AfterViewInit {
+  wm = useWindowManager()
+  dk = createDesktop(this.wm)
+  state = useWmState(this.wm)
+  @ViewChild('desktop') desktopRef!: ElementRef<HTMLElement>
+  @ViewChild('hello') helloRef!: ElementRef<HTMLElement>
+
+  ngAfterViewInit(): void {
+    this.wm.open({ id: 'hello', title: 'Hello' })
+    this.dk.desktop(this.desktopRef.nativeElement)
+    this.dk.window('hello')(this.helloRef.nativeElement)
+  }
+}
+```
+
+`useWmState` returns a read-only `Signal<ManagerState>` and `useWmWindow(wm, id)` a computed per-window signal, so templates track updates fine-grained. Hooks called in an injection context clean up through `DestroyRef` automatically; outside one they simply skip auto-cleanup.
+
 ## 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.
 
@@ -211,6 +251,8 @@ interface ManagerOptions {
   cascadeOffset?: number        // auto-position step for new windows (default 32)
   cascadeOrigin?: { x: number; y: number }
   idPrefix?: string
+  historyLimit?: number         // undo/redo depth (default 50, 0 disables history)
+  workspace?: number            // initial virtual desktop (default 0)
 }
 ```
 
@@ -222,12 +264,19 @@ 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 |
 | `subscribe(fn)` / `on(event, fn)` | granular events: `open, close, focus, move, resize, stage, update, order, modalblocked` |
 | `batch(fn)` | coalesce many operations into one `change` notification |
 
@@ -240,14 +289,17 @@ 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)
+  hitAreas?: { edge?: number; corner?: number }     // resize handle thickness (auto-doubles on touch)
   minimizeTarget?: (win: WindowState) => Element | null  // FLIP ghost target on minimize
+  onTitlebarContextMenu?: (win: WindowState, event: MouseEvent) => void  // right-click / long-press hook for your own menu
 }
 ```
 
-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`
 
@@ -260,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()`.
@@ -277,6 +338,8 @@ Moves a window's content into a [Document Picture-in-Picture](https://developer.
 }
 ```
 
+Two more ready-made themes ship alongside: `themes/light.css` (light glass) and `themes/retro.css` (pixel-perfect Win98 nostalgia). All three style the same `data-wm-*` attributes, so switching is a one-line import swap.
+
 Skip the import entirely and the library stays headless: state attributes (`data-wm-stage`, `data-wm-focused`, `data-wm-dragging`, `data-wm-flash`, `[hidden]`) are yours to style.
 
 ## SSR
@@ -289,7 +352,7 @@ The core never touches `window`/`document` — create managers and even `hydrate
 | --- | --- | --- | --- | --- | --- |
 | Maintained | ✓ 2026 | ✗ since 2023 | ✗ since 2022 | ✓ | ✓ |
 | Headless core | ✓ | ✗ | ✗ | ~ own UI | ✓ |
-| Official adapters | React·Vue·Svelte·Solid | community | ✗ | React·Vue·Angular | via Ark UI |
+| Official adapters | React·Vue·Svelte·Solid·Angular | community | ✗ | React·Vue·Angular | via Ark UI |
 | Multi-window (z-order, taskbar, modals) | ✓ | partial | partial | dock groups | ✗ single panel |
 | Snap zones + preview | ✓ | ✗ | ✗ | — | ✗ |
 | Keyboard + screen reader | ✓ | ✗ | ✗ | partial | partial |
@@ -301,8 +364,9 @@ The core never touches `window`/`document` — create managers and even `hydrate
 
 ## Quality
 
-- 121 unit tests, **100%** line/branch/function/statement coverage on the core state machine and persistence
-- 160+ Playwright scenarios on Chromium, WebKit and mobile emulation: drag, 8-way resize, snap, keyboard, touch, persistence across reloads, 50-window stress, modal traps, axe accessibility scans
+- 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
 
 ## Development

package/README.ru.md

@@ -10,13 +10,18 @@
 
 - 🪟 **Полный жизненный цикл окна** — открытие, закрытие, фокус, сворачивание, разворачивание, восстановление, drag, ресайз в 8 направлениях
 - 🧠 **Headless-ядро** — сериализуемая стейт-машина плюс DOM-контроллер; своя разметка или готовая стеклянная тема
-- ⚛️ **Родные адаптеры** — `@surdeddd/wmkit/react`, `@surdeddd/wmkit/vue`, `@surdeddd/wmkit/svelte`, `@surdeddd/wmkit/solid`, тонкий сахар над одним ядром
-- ⊞ **Snap-зоны** — половины, четверти и максимизация от верхнего края с живым превью
-- ⌨️ **Доступность** — move/resize с клавиатуры, цикл окон по F6, focus-trap в модалках, `aria-live`-анонсы
+- ⚛️ **Родные адаптеры** — `@surdeddd/wmkit/react`, `/vue`, `/svelte`, `/solid`, `/angular`, тонкий сахар над одним ядром
+- ⊞ **Snap-зоны** — половины, четверти, трети и максимизация от верхнего края с живым превью
+- 🧲 **Магнетизм** — края окна прилипают к соседям и вьюпорту при перетаскивании
+- ↩️ **Undo/redo** — каждая мутация = один шаг; целый drag схлопывается в одну запись истории
+- 🗂️ **Рабочие столы и 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 kB gzip
+- 📦 **Ноль зависимостей**, строгий TypeScript, ESM + CJS, ~10.7 kB brotli
 
 ## Установка
 
@@ -68,7 +73,7 @@ desktop.attachWindow(win.id, el, { removeOnClose: true })
 
 ## Адаптеры
 
-Примеры для React, Vue, Svelte и Solid — в [английском README](./README.md#react) и на [лендинге](https://surdeddd.github.io/wmkit/) (табы «Фреймворки»). Принцип один: контент окна живёт в дереве вашего фреймворка, никакого innerHTML.
+Примеры для React, Vue, Svelte, Solid и Angular — в [английском README](./README.md#react) и на [лендинге](https://surdeddd.github.io/wmkit/) (табы «Фреймворки»). Принцип один: контент окна живёт в дереве вашего фреймворка, никакого innerHTML.
 
 ## API ядра — кратко
 
@@ -85,17 +90,33 @@ wm.hydrate(json)
 
 wm.on('stage', ({ window, previous }) => console.log(previous, '→', window.stage))
 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 на таче).
 
 ### Персист
 
 ```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)
@@ -111,14 +132,17 @@ if (isPopoutSupported()) await popout(wm, 'docs', contentElement)
 
 Подключите `@surdeddd/wmkit/themes/glass.css` и переопределяйте CSS-переменные (`--wm-radius`, `--wm-bg`, `--wm-accent`, …) — или не подключайте ничего и стилизуйте `data-wm-stage`, `data-wm-focused`, `data-wm-dragging`, `[hidden]` сами.
 
+Ещё две готовые темы: `themes/light.css` (светлое стекло) и `themes/retro.css` (Win98-ностальгия). Все три стилизуют одни и те же `data-wm-*` атрибуты — переключение = замена одного импорта.
+
 ## SSR
 
 Ядро не трогает `window`/`document`: менеджер можно создавать и гидрейтить на сервере, `attachDesktop` вызывается после маунта. `persist` тихо выключается без доступного storage.
 
 ## Качество
 
-- 121 юнит-тест, **100%** покрытие стейт-машины и persist по строкам/веткам/функциям
-- 160+ Playwright-сценариев на Chromium, WebKit и мобильной эмуляции: 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

@@ -0,0 +1,53 @@
+'use strict';
+
+var chunk3KZZOLHW_cjs = require('./chunk-3KZZOLHW.cjs');
+var core = require('@angular/core');
+
+function onDestroy(dispose) {
+  let destroyRef = null;
+  try {
+    destroyRef = core.inject(core.DestroyRef);
+  } catch {
+    destroyRef = null;
+  }
+  destroyRef?.onDestroy(dispose);
+}
+function useWindowManager(options) {
+  const wm = chunk3KZZOLHW_cjs.createWindowManager(options);
+  onDestroy(() => wm.destroy());
+  return wm;
+}
+function useWmState(wm) {
+  const state = core.signal(wm.getState());
+  const stop = wm.subscribe((next) => state.set(next));
+  onDestroy(stop);
+  return state.asReadonly();
+}
+function useWmWindow(wm, id) {
+  const state = useWmState(wm);
+  return core.computed(() => state().windows[id]);
+}
+function createDesktop(wm, options) {
+  const binder = chunk3KZZOLHW_cjs.createDesktopBinder(wm, options);
+  onDestroy(() => binder.destroy());
+  return {
+    binder,
+    desktop(element) {
+      const unbind = binder.bindDesktop(element);
+      onDestroy(unbind);
+    },
+    window(id, windowOptions) {
+      return (element) => {
+        const unbind = binder.bindWindow(id, element, windowOptions);
+        onDestroy(unbind);
+      };
+    }
+  };
+}
+
+exports.createDesktop = createDesktop;
+exports.useWindowManager = useWindowManager;
+exports.useWmState = useWmState;
+exports.useWmWindow = useWmWindow;
+//# sourceMappingURL=angular.cjs.map
+//# sourceMappingURL=angular.cjs.map

package/dist/angular.cjs.map

@@ -0,0 +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,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

@@ -0,0 +1,15 @@
+import { Signal } from '@angular/core';
+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>;
+declare function useWmWindow(wm: WindowManager, id: string): Signal<WindowState | undefined>;
+interface AngularDesktop {
+    binder: DesktopBinder;
+    desktop(element: HTMLElement): void;
+    window(id: string, options?: WindowAttachOptions): (element: HTMLElement) => void;
+}
+declare function createDesktop(wm: WindowManager, options?: DesktopOptions): AngularDesktop;
+
+export { type AngularDesktop, createDesktop, useWindowManager, useWmState, useWmWindow };

package/dist/angular.d.ts

@@ -0,0 +1,15 @@
+import { Signal } from '@angular/core';
+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>;
+declare function useWmWindow(wm: WindowManager, id: string): Signal<WindowState | undefined>;
+interface AngularDesktop {
+    binder: DesktopBinder;
+    desktop(element: HTMLElement): void;
+    window(id: string, options?: WindowAttachOptions): (element: HTMLElement) => void;
+}
+declare function createDesktop(wm: WindowManager, options?: DesktopOptions): AngularDesktop;
+
+export { type AngularDesktop, createDesktop, useWindowManager, useWmState, useWmWindow };

package/dist/angular.js

@@ -0,0 +1,48 @@
+import { createWindowManager, createDesktopBinder } from './chunk-FPZDAKNP.js';
+import { signal, computed, inject, DestroyRef } from '@angular/core';
+
+function onDestroy(dispose) {
+  let destroyRef = null;
+  try {
+    destroyRef = inject(DestroyRef);
+  } catch {
+    destroyRef = null;
+  }
+  destroyRef?.onDestroy(dispose);
+}
+function useWindowManager(options) {
+  const wm = createWindowManager(options);
+  onDestroy(() => wm.destroy());
+  return wm;
+}
+function useWmState(wm) {
+  const state = signal(wm.getState());
+  const stop = wm.subscribe((next) => state.set(next));
+  onDestroy(stop);
+  return state.asReadonly();
+}
+function useWmWindow(wm, id) {
+  const state = useWmState(wm);
+  return computed(() => state().windows[id]);
+}
+function createDesktop(wm, options) {
+  const binder = createDesktopBinder(wm, options);
+  onDestroy(() => binder.destroy());
+  return {
+    binder,
+    desktop(element) {
+      const unbind = binder.bindDesktop(element);
+      onDestroy(unbind);
+    },
+    window(id, windowOptions) {
+      return (element) => {
+        const unbind = binder.bindWindow(id, element, windowOptions);
+        onDestroy(unbind);
+      };
+    }
+  };
+}
+
+export { createDesktop, useWindowManager, useWmState, useWmWindow };
+//# sourceMappingURL=angular.js.map
+//# sourceMappingURL=angular.js.map

package/dist/angular.js.map

@@ -0,0 +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,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-BY-saDUB.d.cts → binder-B2A2IZGh.d.ts}

@@ -1,15 +1,23 @@
-import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-Bkrq2djr.cjs';
+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;
     cornerSize?: number;
 }
 declare function detectSnapZone(x: number, y: number, viewport: Size, options?: SnapDetectOptions): SnapZone | null;
+interface MagnetResult {
+    x: number;
+    y: number;
+    snappedX: boolean;
+    snappedY: boolean;
+}
+declare function magnetize(bounds: Bounds, targets: readonly Bounds[], threshold: number): MagnetResult;
 
 interface AnnouncerMessages {
     opened(title: string): string;
@@ -19,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 {
@@ -35,18 +44,25 @@ interface DesktopSnapOptions extends SnapDetectOptions {
 interface DesktopKeyboardOptions {
     moveStep?: number;
     cycle?: boolean;
+    snapShortcuts?: boolean;
+    historyShortcuts?: boolean;
 }
 interface HitAreaOptions {
     edge?: number;
     corner?: number;
 }
+interface MagnetismOptions {
+    threshold?: number;
+}
 interface DesktopOptions {
     snap?: boolean | DesktopSnapOptions;
     keyboard?: boolean | DesktopKeyboardOptions;
     announce?: boolean | Partial<AnnouncerMessages>;
     autoViewport?: boolean;
     hitAreas?: HitAreaOptions;
+    magnetism?: boolean | MagnetismOptions;
     minimizeTarget?: (window: WindowState) => Element | null;
+    onTitlebarContextMenu?: (window: WindowState, event: MouseEvent) => void;
 }
 interface WindowAttachOptions {
     handle?: HTMLElement | string;
@@ -65,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 SnapDetectOptions as S, type WindowAttachOptions as W, type DesktopController as a, type DesktopOptions as b, type AnnouncerMessages as c, type DesktopKeyboardOptions as d, type DesktopSnapOptions as e, boundsEqual as f, clamp as g, clampSize as h, clampToViewport as i, createAnnouncer as j, createDesktopBinder as k, defaultMessages as l, detectSnapZone as m, 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-D9UEE1SM.d.ts → binder-Dl07SXIM.d.cts}

@@ -1,15 +1,23 @@
-import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-Bkrq2djr.js';
+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;
     cornerSize?: number;
 }
 declare function detectSnapZone(x: number, y: number, viewport: Size, options?: SnapDetectOptions): SnapZone | null;
+interface MagnetResult {
+    x: number;
+    y: number;
+    snappedX: boolean;
+    snappedY: boolean;
+}
+declare function magnetize(bounds: Bounds, targets: readonly Bounds[], threshold: number): MagnetResult;
 
 interface AnnouncerMessages {
     opened(title: string): string;
@@ -19,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 {
@@ -35,18 +44,25 @@ interface DesktopSnapOptions extends SnapDetectOptions {
 interface DesktopKeyboardOptions {
     moveStep?: number;
     cycle?: boolean;
+    snapShortcuts?: boolean;
+    historyShortcuts?: boolean;
 }
 interface HitAreaOptions {
     edge?: number;
     corner?: number;
 }
+interface MagnetismOptions {
+    threshold?: number;
+}
 interface DesktopOptions {
     snap?: boolean | DesktopSnapOptions;
     keyboard?: boolean | DesktopKeyboardOptions;
     announce?: boolean | Partial<AnnouncerMessages>;
     autoViewport?: boolean;
     hitAreas?: HitAreaOptions;
+    magnetism?: boolean | MagnetismOptions;
     minimizeTarget?: (window: WindowState) => Element | null;
+    onTitlebarContextMenu?: (window: WindowState, event: MouseEvent) => void;
 }
 interface WindowAttachOptions {
     handle?: HTMLElement | string;
@@ -65,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 SnapDetectOptions as S, type WindowAttachOptions as W, type DesktopController as a, type DesktopOptions as b, type AnnouncerMessages as c, type DesktopKeyboardOptions as d, type DesktopSnapOptions as e, boundsEqual as f, clamp as g, clampSize as h, clampToViewport as i, createAnnouncer as j, createDesktopBinder as k, defaultMessages as l, detectSnapZone as m, 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 };