layerpro 3.3.0 → 3.4.0

package/README.md

@@ -18,7 +18,7 @@
 ![OXlint](https://img.shields.io/badge/Oxlint-gray?logo=oxc)
 ![Playwright](https://img.shields.io/badge/Playwright-gray?logo=playwright)
 
-LayerPro replaces the browser's native `alert()`, `confirm()`, and `prompt()` with beautiful, fully customizable modals that work everywhere — no more blocking the main thread, no more default browser styling.
+LayerPro replaces the browser's native `alert()`, `confirm()`, and `prompt()` with beautiful, fully customizable modals that work everywhere - no more blocking the main thread, no more default browser styling.
 
 ## Table of Contents
 
@@ -43,12 +43,12 @@ LayerPro replaces the browser's native `alert()`, `confirm()`, and `prompt()` wi
 
 ## Features
 
-- **Zero runtime dependencies** — no jQuery, pure vanilla DOM helpers; `react`/`react-dom` are peer dependencies, only loaded when React bodies are used, powered by [`reattach`](https://npmjs.com/package/reattach)
-- **Multiple modal types** — alert, confirm, prompt, message
-- **Fully customizable** — appearance, behavior, and content
-- **Dockable windows** (taskbar-style) — click a dock icon to restore, focus, or minimize, just like an OS taskbar
-- **Draggable & resizable** — instant, with no transition lag while resizing
-- **CSS-only maximize** — uses `position: fixed` + insets, so it follows the viewport with no JS resize listeners
+- **Zero runtime dependencies** - no jQuery, pure vanilla DOM helpers; `react`/`react-dom` are peer dependencies, only loaded when React bodies are used, powered by [`reattach`](https://npmjs.com/package/reattach)
+- **Multiple modal types** - alert, confirm, prompt, message
+- **Fully customizable** - appearance, behavior, and content
+- **Dockable windows** (taskbar-style) - click a dock icon to restore, focus, or minimize, just like an OS taskbar
+- **Draggable & resizable** - instant, with no transition lag while resizing
+- **CSS-only maximize** - uses `position: fixed` + insets, so it follows the viewport with no JS resize listeners
 - **Fade in/out transitions** for open/close
 - **Full TypeScript support**
 
@@ -72,7 +72,7 @@ Import LayerPro once, in your app's entry point:
 import "layerpro";
 ```
 
-That's it — `alert()`, `confirm()`, `prompt()`, `message()`, and `popup()` are now available globally.
+That's it - `alert()`, `confirm()`, `prompt()`, `message()`, and `popup()` are now available globally.
 
 The `popup` alias is a shorthand for `layerpro.popup`:
 
@@ -120,7 +120,7 @@ popup.open({
 
 ### React Components
 
-LayerPro's React adapter is powered by [`reattach`](https://npmjs.com/package/reattach), a zero-dependency library for mounting React components anywhere in the DOM. It handles root creation, automatic root reuse on duplicate-id reopen, **Context Bridging** across detached roots, and **auto-healing DOM** recovery — all without extra setup.
+LayerPro's React adapter is powered by [`reattach`](https://npmjs.com/package/reattach), a zero-dependency library for mounting React components anywhere in the DOM. It handles root creation, automatic root reuse on duplicate-id reopen, **Context Bridging** across detached roots, and **auto-healing DOM** recovery - all without extra setup.
 
 ```jsx
 popup.open({
@@ -174,7 +174,7 @@ popup.open({
   id: string,             // Unique ID (auto-generated as popup_1, popup_2, ... if omitted)
   body: any,              // Content (text, HTML, or React)
   name: string,           // Modal title
-  icon: string,           // Icon glyph — HTML entity (e.g. "⚠") or HTML string
+  icon: string,           // Icon glyph - HTML entity (e.g. "⚠") or HTML string
 
   // Dimensions (defaults: width 340, height 220; minWidth 340, minHeight 220)
   width: number,
@@ -210,7 +210,7 @@ popup.open({
   iconize: boolean,       // allow minimize to dock
   dockable: boolean,      // show an icon in the dock bar
   close: boolean,         // show the close button
-  raised: boolean,        // alias: modal — full-screen overlay that blocks pointer events beneath
+  raised: boolean,        // alias: modal - full-screen overlay that blocks pointer events beneath
   modal: boolean,         // alias of raised
 
   // Buttons
@@ -221,9 +221,9 @@ popup.open({
 }
 ```
 
-> **`raised` / `modal`** injects a full-viewport overlay (`popup_raised_<id>`) that intercepts every pointer event — the page underneath becomes unclickable until the popup closes. Both names are accepted.
+> **`raised` / `modal`** injects a full-viewport overlay (`popup_raised_<id>`) that intercepts every pointer event - the page underneath becomes unclickable until the popup closes. Both names are accepted.
 
-> **Duplicate id** — opening a popup whose `id` already exists brings that window to the front and refreshes its `body`/`buttons` instead of doing nothing.
+> **Duplicate id** - opening a popup whose `id` already exists brings that window to the front and refreshes its `body`/`buttons` instead of doing nothing.
 
 ## Global Overrides
 
@@ -238,7 +238,7 @@ prompt("Name?", name => {...});     // LayerPro prompt (callback, not a string r
 message("Done!");                   // LayerPro message
 ```
 
-> **⚠️ Important:** the overridden `confirm()` no longer returns a `boolean`, and `prompt()` no longer returns a `string` — they are callback-based and return `undefined`. Any third-party code that does `if (confirm("..."))` will silently fall into the falsy branch. If your codebase depends on native synchronous return values, call **`layerpro.noGlobals()`** right after importing LayerPro to restore the originals:
+> **⚠️ Important:** the overridden `confirm()` no longer returns a `boolean`, and `prompt()` no longer returns a `string` - they are callback-based and return `undefined`. Any third-party code that does `if (confirm("..."))` will silently fall into the falsy branch. If your codebase depends on native synchronous return values, call **`layerpro.noGlobals()`** right after importing LayerPro to restore the originals:
 >
 > ```javascript
 > import "layerpro";
@@ -285,10 +285,10 @@ The title bar, window surface, internal area, and body all read from CSS custom
 
 ## Security
 
-- **Same-origin fetch guard** — the `source` prop only accepts same-origin URLs; cross-origin requests are rejected before any network call is made, preventing SSRF and data exfiltration.
-- **HTML escaping** — all user-provided text content (button labels, body content, titles) is automatically escaped via `escapeHtml()` to prevent XSS.
-- **CSP-friendly** — no inline scripts or `eval()` are used. React components are rendered via `reattach.mount()` (backed by `createRoot()`).
-- **Opt-out of global overrides** — call `layerpro.noGlobals()` after import to restore native `alert`, `confirm`, `prompt`, and remove the `message` global if your codebase depends on synchronous return values.
+- **Same-origin fetch guard** - the `source` prop only accepts same-origin URLs; cross-origin requests are rejected before any network call is made, preventing SSRF and data exfiltration.
+- **HTML escaping** - all user-provided text content (button labels, body content, titles) is automatically escaped via `escapeHtml()` to prevent XSS.
+- **CSP-friendly** - no inline scripts or `eval()` are used. React components are rendered via `reattach.mount()` (backed by `createRoot()`).
+- **Opt-out of global overrides** - call `layerpro.noGlobals()` after import to restore native `alert`, `confirm`, `prompt`, and remove the `message` global if your codebase depends on synchronous return values.
 
 ## Browser Support
 
@@ -298,7 +298,7 @@ Chrome 80+ • Firefox 75+ • Safari 13+ • Edge 80+
 
 LayerPro's source is currently private, but contributions and discussion are welcome. Get in touch:
 
-- **Dario Passariello** — https://dario.passariello.ca/ — dariopassariello@gmail.com
+- **Dario Passariello** - https://dario.passariello.ca/ - dariopassariello@gmail.com
 
 ## License