@surdeddd/wmkit 0.2.0 → 0.3.0

package/README.md

@@ -14,13 +14,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`, `@surdeddd/wmkit/vue`, `@surdeddd/wmkit/svelte`, `@surdeddd/wmkit/solid`, all thin sugar over one core
+- ⚛️ **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
+- 🧲 **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
 - ⚡ **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
+- 🎨 **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, ~9.3 kB brotli core
 
 ## Install
 
@@ -190,6 +194,41 @@ 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/)
@@ -211,6 +250,7 @@ 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)
 }
 ```
 
@@ -228,6 +268,10 @@ Manager methods:
 | `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 |
+| `undo()` / `redo()` / `canUndo()` / `canRedo()` / `clearHistory()` | every mutation is one step; a whole drag or resize collapses into a single entry |
+| `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 |
 
@@ -243,7 +287,10 @@ interface DesktopOptions {
   keyboard?: boolean | { moveStep?: number; cycle?: 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
 }
 ```
 
@@ -277,6 +324,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 +338,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 +350,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
+- 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
+- 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,17 @@
 
 - 🪟 **Полный жизненный цикл окна** — открытие, закрытие, фокус, сворачивание, разворачивание, восстановление, drag, ресайз в 8 направлениях
 - 🧠 **Headless-ядро** — сериализуемая стейт-машина плюс DOM-контроллер; своя разметка или готовая стеклянная тема
-- ⚛️ **Родные адаптеры** — `@surdeddd/wmkit/react`, `@surdeddd/wmkit/vue`, `@surdeddd/wmkit/svelte`, `@surdeddd/wmkit/solid`, тонкий сахар над одним ядром
+- ⚛️ **Родные адаптеры** — `@surdeddd/wmkit/react`, `/vue`, `/svelte`, `/solid`, `/angular`, тонкий сахар над одним ядром
 - ⊞ **Snap-зоны** — половины, четверти и максимизация от верхнего края с живым превью
+- 🧲 **Магнетизм** — края окна прилипают к соседям и вьюпорту при перетаскивании
+- ↩️ **Undo/redo** — каждая мутация = один шаг; целый drag схлопывается в одну запись истории
+- 🗂️ **Именованные layout'ы и arrange** — снапшоты рабочего стола, `cascade`/`tile` одним вызовом
 - ⌨️ **Доступность** — move/resize с клавиатуры, цикл окон по 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, ~9.3 kB brotli
 
 ## Установка
 
@@ -68,7 +72,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,12 +89,18 @@ 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()
 ```
 
 Слои: `normal` < `floating` (always-on-top) < `modal`. Модалка блокирует фокус нижних окон (попытка — событие `modalblocked` и flash-анимация), Tab заперт внутри.
 
 Клавиатура по умолчанию: стрелки двигают сфокусированное окно (16 px), `Alt` — шаг 1 px, `Shift+стрелки` — ресайз, `F6`/`Shift+F6` — цикл по окнам, `Escape` отменяет активный drag/resize.
 
+Магнетизм включён из коробки (порог 8 px, на тач-устройствах 12 px): `attachDesktop(wm, el, { magnetism: { threshold: 16 } })` или `magnetism: false`. Свой контекст-меню тайтлбара — через `onTitlebarContextMenu(win, event)` (правый клик и long-press на таче).
+
 ### Персист
 
 ```js
@@ -111,14 +121,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-аудиты доступности
+- 172 юнит-теста, **100%** покрытие стейт-машины и persist по строкам/веткам/функциям
+- 178+ 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,52 @@
+'use strict';
+
+var chunkB35DANTX_cjs = require('./chunk-B35DANTX.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 = chunkB35DANTX_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 = chunkB35DANTX_cjs.createDesktopBinder(wm, options);
+  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,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"]}

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-DdCtDHgt.cjs';
+import { D as DesktopBinder, W as WindowAttachOptions, a as DesktopOptions } from './binder-Dq_AZRbo.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-DdCtDHgt.js';
+import { D as DesktopBinder, W as WindowAttachOptions, a as DesktopOptions } from './binder-0Oku22Nc.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,47 @@
+import { createWindowManager, createDesktopBinder } from './chunk-YCHJXSTC.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);
+  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,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"]}

package/dist/{binder-BY-saDUB.d.cts → binder-0Oku22Nc.d.ts}

@@ -1,4 +1,4 @@
-import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-Bkrq2djr.cjs';
+import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-DdCtDHgt.js';
 
 declare function clamp(value: number, min: number, max: number): number;
 declare function clampSize(size: Size, min: Size, max: Size | null): Size;
@@ -10,6 +10,13 @@ interface SnapDetectOptions {
     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;
@@ -40,13 +47,18 @@ 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;
@@ -68,4 +80,4 @@ interface DesktopBinder {
 }
 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, 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 };

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

@@ -1,4 +1,4 @@
-import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-Bkrq2djr.js';
+import { B as Bounds, f as Size, g as SnapZone, W as WindowManager, b as WindowState } from './types-DdCtDHgt.cjs';
 
 declare function clamp(value: number, min: number, max: number): number;
 declare function clampSize(size: Size, min: Size, max: Size | null): Size;
@@ -10,6 +10,13 @@ interface SnapDetectOptions {
     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;
@@ -40,13 +47,18 @@ 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;
@@ -68,4 +80,4 @@ interface DesktopBinder {
 }
 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, 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 };