@data-slot/dialog 0.1.0

package/README.md

@@ -0,0 +1,176 @@
+# @data-slot/dialog
+
+Headless modal dialog component for vanilla JavaScript. Accessible, unstyled, tiny.
+
+## Installation
+
+```bash
+npm install @data-slot/dialog
+```
+
+## Quick Start
+
+```html
+<div data-slot="dialog">
+  <button data-slot="dialog-trigger">Open Dialog</button>
+  <div data-slot="dialog-content" hidden>
+    <h2 data-slot="dialog-title">Dialog Title</h2>
+    <p data-slot="dialog-description">Dialog description text.</p>
+    <button data-slot="dialog-close">Close</button>
+  </div>
+</div>
+
+<script type="module">
+  import { create } from "@data-slot/dialog";
+  
+  const controllers = create();
+</script>
+```
+
+## API
+
+### `create(scope?)`
+
+Auto-discover and bind all dialog instances in a scope (defaults to `document`).
+
+```typescript
+import { create } from "@data-slot/dialog";
+
+const controllers = create(); // Returns DialogController[]
+```
+
+### `createDialog(root, options?)`
+
+Create a controller for a specific element.
+
+```typescript
+import { createDialog } from "@data-slot/dialog";
+
+const dialog = createDialog(element, {
+  defaultOpen: false,
+  closeOnClickOutside: true,
+  closeOnEscape: true,
+  lockScroll: true,
+  onOpenChange: (open) => console.log(open),
+});
+```
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `defaultOpen` | `boolean` | `false` | Initial open state |
+| `closeOnClickOutside` | `boolean` | `true` | Close when clicking outside content |
+| `closeOnEscape` | `boolean` | `true` | Close when pressing Escape |
+| `lockScroll` | `boolean` | `true` | Lock body scroll when open |
+| `onOpenChange` | `(open: boolean) => void` | `undefined` | Callback when open state changes |
+
+### Controller
+
+| Method/Property | Description |
+|-----------------|-------------|
+| `open()` | Open the dialog |
+| `close()` | Close the dialog |
+| `toggle()` | Toggle the dialog |
+| `isOpen` | Current open state (readonly `boolean`) |
+| `destroy()` | Cleanup all event listeners |
+
+## Markup Structure
+
+```html
+<div data-slot="dialog">
+  <button data-slot="dialog-trigger">Open</button>
+  <div data-slot="dialog-content" role="dialog">
+    <h2 data-slot="dialog-title">Title</h2>
+    <p data-slot="dialog-description">Description</p>
+    <button data-slot="dialog-close">Close</button>
+  </div>
+</div>
+```
+
+### Required Slots
+
+- `dialog-content` - The dialog panel (required)
+
+### Optional Slots
+
+- `dialog-trigger` - Button to open the dialog
+- `dialog-title` - Title for `aria-labelledby`
+- `dialog-description` - Description for `aria-describedby`
+- `dialog-close` - Button to close the dialog
+
+## Styling
+
+Use `data-state` attributes for CSS styling:
+
+```css
+/* Backdrop/overlay */
+[data-slot="dialog-content"] {
+  position: fixed;
+  inset: 0;
+  display: grid;
+  place-items: center;
+  background: rgba(0, 0, 0, 0.5);
+}
+
+/* Closed state */
+[data-slot="dialog"][data-state="closed"] [data-slot="dialog-content"] {
+  display: none;
+}
+
+/* Animation */
+[data-slot="dialog-content"] {
+  opacity: 0;
+  transition: opacity 0.2s;
+}
+
+[data-slot="dialog"][data-state="open"] [data-slot="dialog-content"] {
+  opacity: 1;
+}
+```
+
+With Tailwind:
+
+```html
+<div data-slot="dialog-content" class="fixed inset-0 grid place-items-center bg-black/50 data-[state=closed]:hidden">
+  <div class="bg-white rounded-lg p-6 max-w-md">
+    <!-- Dialog content -->
+  </div>
+</div>
+```
+
+## Accessibility
+
+The component automatically handles:
+
+- `role="dialog"` on content
+- `aria-modal="true"` on content
+- `aria-labelledby` linked to title
+- `aria-describedby` linked to description
+- `aria-haspopup="dialog"` on trigger
+- `aria-expanded` state on trigger
+- Focus trap within dialog
+- Focus restoration on close
+
+## Keyboard Navigation
+
+| Key | Action |
+|-----|--------|
+| `Escape` | Close dialog |
+| `Tab` | Cycle focus within dialog |
+| `Shift+Tab` | Cycle focus backwards |
+
+## Events
+
+Listen for changes via custom events:
+
+```javascript
+element.addEventListener("dialog:change", (e) => {
+  console.log("Dialog open:", e.detail.open);
+});
+```
+
+## License
+
+MIT
+

package/dist/index.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));const c=s(require(`@data-slot/core`)),l=`a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])`,u=[];let d=0,f=``,p=``;function m(e,t={}){let{defaultOpen:n=!1,onOpenChange:r,closeOnClickOutside:i=!0,closeOnEscape:a=!0,lockScroll:o=!0,alertDialog:s=!1}=t,m=(0,c.getPart)(e,`dialog-trigger`),h=(0,c.getPart)(e,`dialog-overlay`),g=(0,c.getPart)(e,`dialog-content`),_=(0,c.getPart)(e,`dialog-close`),v=(0,c.getPart)(e,`dialog-title`),y=(0,c.getPart)(e,`dialog-description`);if(!g)throw Error(`Dialog requires dialog-content slot`);if(!h)throw Error(`Dialog requires dialog-overlay slot`);let b=!1,x=null,S=[];(0,c.ensureId)(g,`dialog-content`),g.setAttribute(`role`,s?`alertdialog`:`dialog`),(0,c.setAria)(g,`modal`,!0),(0,c.linkLabelledBy)(g,v,y),h.setAttribute(`role`,`presentation`),h.setAttribute(`aria-hidden`,`true`),h.tabIndex=-1,m&&(m.setAttribute(`aria-haspopup`,`dialog`),m.setAttribute(`aria-controls`,g.id),(0,c.setAria)(m,`expanded`,!1));let C=!1,w=()=>{g.hasAttribute(`tabindex`)||(g.tabIndex=-1,C=!0)},T=()=>{C&&(g.removeAttribute(`tabindex`),C=!1)},E=()=>{let e=g.querySelector(`[autofocus]`);if(e)return e.focus();let t=g.querySelector(l);if(t)return t.focus();w(),g.focus()},D=(t,n=!1)=>{if(!(b===t&&!n)){if(t){if(x=document.activeElement,u.push(O),o){if(d===0){let e=window.innerWidth-document.documentElement.clientWidth;f=document.body.style.overflow,p=document.body.style.paddingRight,document.body.style.paddingRight=`${e}px`,document.body.style.overflow=`hidden`}d++}}else{let e=u.indexOf(O);e!==-1&&u.splice(e,1),o&&(d--,d===0&&(document.body.style.overflow=f,document.body.style.paddingRight=p)),T();let t=x;x=null,requestAnimationFrame(()=>{t&&document.contains(t)&&typeof t.focus==`function`&&t.focus()})}b=t,g.hidden=!b,h.hidden=!b,m&&(0,c.setAria)(m,`expanded`,b),e.setAttribute(`data-state`,b?`open`:`closed`),(0,c.emit)(e,`dialog:change`,{open:b}),r?.(b),t&&requestAnimationFrame(E)}};n?(g.hidden=!1,h.hidden=!1,e.setAttribute(`data-state`,`open`),D(!0,!0)):(g.hidden=!0,h.hidden=!0,e.setAttribute(`data-state`,`closed`)),m&&S.push((0,c.on)(m,`click`,()=>D(!b))),_&&S.push((0,c.on)(_,`click`,()=>D(!1))),i&&S.push((0,c.on)(h,`pointerdown`,e=>{e.target===h&&b&&D(!1)})),S.push((0,c.on)(document,`keydown`,e=>{if(b){if(e.key===`Escape`&&a){let t=u[u.length-1];t===O&&(e.preventDefault(),D(!1));return}if(e.key===`Tab`){let t=g.querySelectorAll(l);if(t.length===0){e.preventDefault(),w(),g.focus();return}let n=t[0],r=t[t.length-1],i=document.activeElement;if(!g.contains(i)){e.preventDefault(),n.focus();return}if(n===r){e.preventDefault();return}e.shiftKey?i===n&&(e.preventDefault(),r.focus()):i===r&&(e.preventDefault(),n.focus())}}}));let O={open:()=>D(!0),close:()=>D(!1),toggle:()=>D(!b),get isOpen(){return b},destroy:()=>{b&&D(!1,!0),T(),S.forEach(e=>e()),S.length=0}};return O}const h=new WeakSet;function g(e=document){let t=[];for(let n of(0,c.getRoots)(e,`dialog`)){if(h.has(n))continue;h.add(n),t.push(m(n))}return t}exports.create=g,exports.createDialog=m;

package/dist/index.d.cts

@@ -0,0 +1,54 @@
+//#region src/index.d.ts
+interface DialogOptions {
+  /** Initial open state */
+  defaultOpen?: boolean;
+  /** Callback when open state changes */
+  onOpenChange?: (open: boolean) => void;
+  /** Close when clicking overlay */
+  closeOnClickOutside?: boolean;
+  /** Close when pressing Escape */
+  closeOnEscape?: boolean;
+  /** Lock body scroll when open */
+  lockScroll?: boolean;
+  /** Use alertdialog role for blocking confirmations */
+  alertDialog?: boolean;
+}
+interface DialogController {
+  /** Open the dialog */
+  open(): void;
+  /** Close the dialog */
+  close(): void;
+  /** Toggle the dialog */
+  toggle(): void;
+  /** Current open state */
+  readonly isOpen: boolean;
+  /** Cleanup all event listeners */
+  destroy(): void;
+}
+/**
+ * Create a dialog controller for a root element
+ *
+ * Expected markup:
+ * ```html
+ * <div data-slot="dialog">
+ *   <button data-slot="dialog-trigger">Open</button>
+ *   <div data-slot="dialog-overlay"></div>
+ *   <div data-slot="dialog-content">
+ *     <h2 data-slot="dialog-title">Title</h2>
+ *     <p data-slot="dialog-description">Description</p>
+ *     <button data-slot="dialog-close">Close</button>
+ *   </div>
+ * </div>
+ * ```
+ *
+ * Note: Overlay is required. For modal behavior with inert backgrounds,
+ * mount dialogs as direct children of document.body (portal pattern).
+ */
+declare function createDialog(root: Element, options?: DialogOptions): DialogController;
+/**
+ * Find and bind all dialog components in a scope
+ * Returns array of controllers for programmatic access
+ */
+declare function create(scope?: ParentNode): DialogController[];
+//#endregion
+export { DialogController, DialogOptions, create, createDialog };

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+//#region src/index.d.ts
+interface DialogOptions {
+  /** Initial open state */
+  defaultOpen?: boolean;
+  /** Callback when open state changes */
+  onOpenChange?: (open: boolean) => void;
+  /** Close when clicking overlay */
+  closeOnClickOutside?: boolean;
+  /** Close when pressing Escape */
+  closeOnEscape?: boolean;
+  /** Lock body scroll when open */
+  lockScroll?: boolean;
+  /** Use alertdialog role for blocking confirmations */
+  alertDialog?: boolean;
+}
+interface DialogController {
+  /** Open the dialog */
+  open(): void;
+  /** Close the dialog */
+  close(): void;
+  /** Toggle the dialog */
+  toggle(): void;
+  /** Current open state */
+  readonly isOpen: boolean;
+  /** Cleanup all event listeners */
+  destroy(): void;
+}
+/**
+ * Create a dialog controller for a root element
+ *
+ * Expected markup:
+ * ```html
+ * <div data-slot="dialog">
+ *   <button data-slot="dialog-trigger">Open</button>
+ *   <div data-slot="dialog-overlay"></div>
+ *   <div data-slot="dialog-content">
+ *     <h2 data-slot="dialog-title">Title</h2>
+ *     <p data-slot="dialog-description">Description</p>
+ *     <button data-slot="dialog-close">Close</button>
+ *   </div>
+ * </div>
+ * ```
+ *
+ * Note: Overlay is required. For modal behavior with inert backgrounds,
+ * mount dialogs as direct children of document.body (portal pattern).
+ */
+declare function createDialog(root: Element, options?: DialogOptions): DialogController;
+/**
+ * Find and bind all dialog components in a scope
+ * Returns array of controllers for programmatic access
+ */
+declare function create(scope?: ParentNode): DialogController[];
+//#endregion
+export { DialogController, DialogOptions, create, createDialog };

package/dist/index.js

@@ -0,0 +1 @@
+import{emit as e,ensureId as t,getPart as n,getRoots as r,linkLabelledBy as i,on as a,setAria as o}from"@data-slot/core";const s=`a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])`,c=[];let l=0,u=``,d=``;function f(r,f={}){let{defaultOpen:p=!1,onOpenChange:m,closeOnClickOutside:h=!0,closeOnEscape:g=!0,lockScroll:_=!0,alertDialog:v=!1}=f,y=n(r,`dialog-trigger`),b=n(r,`dialog-overlay`),x=n(r,`dialog-content`),S=n(r,`dialog-close`),C=n(r,`dialog-title`),w=n(r,`dialog-description`);if(!x)throw Error(`Dialog requires dialog-content slot`);if(!b)throw Error(`Dialog requires dialog-overlay slot`);let T=!1,E=null,D=[];t(x,`dialog-content`),x.setAttribute(`role`,v?`alertdialog`:`dialog`),o(x,`modal`,!0),i(x,C,w),b.setAttribute(`role`,`presentation`),b.setAttribute(`aria-hidden`,`true`),b.tabIndex=-1,y&&(y.setAttribute(`aria-haspopup`,`dialog`),y.setAttribute(`aria-controls`,x.id),o(y,`expanded`,!1));let O=!1,k=()=>{x.hasAttribute(`tabindex`)||(x.tabIndex=-1,O=!0)},A=()=>{O&&(x.removeAttribute(`tabindex`),O=!1)},j=()=>{let e=x.querySelector(`[autofocus]`);if(e)return e.focus();let t=x.querySelector(s);if(t)return t.focus();k(),x.focus()},M=(t,n=!1)=>{if(!(T===t&&!n)){if(t){if(E=document.activeElement,c.push(N),_){if(l===0){let e=window.innerWidth-document.documentElement.clientWidth;u=document.body.style.overflow,d=document.body.style.paddingRight,document.body.style.paddingRight=`${e}px`,document.body.style.overflow=`hidden`}l++}}else{let e=c.indexOf(N);e!==-1&&c.splice(e,1),_&&(l--,l===0&&(document.body.style.overflow=u,document.body.style.paddingRight=d)),A();let t=E;E=null,requestAnimationFrame(()=>{t&&document.contains(t)&&typeof t.focus==`function`&&t.focus()})}T=t,x.hidden=!T,b.hidden=!T,y&&o(y,`expanded`,T),r.setAttribute(`data-state`,T?`open`:`closed`),e(r,`dialog:change`,{open:T}),m?.(T),t&&requestAnimationFrame(j)}};p?(x.hidden=!1,b.hidden=!1,r.setAttribute(`data-state`,`open`),M(!0,!0)):(x.hidden=!0,b.hidden=!0,r.setAttribute(`data-state`,`closed`)),y&&D.push(a(y,`click`,()=>M(!T))),S&&D.push(a(S,`click`,()=>M(!1))),h&&D.push(a(b,`pointerdown`,e=>{e.target===b&&T&&M(!1)})),D.push(a(document,`keydown`,e=>{if(T){if(e.key===`Escape`&&g){let t=c[c.length-1];t===N&&(e.preventDefault(),M(!1));return}if(e.key===`Tab`){let t=x.querySelectorAll(s);if(t.length===0){e.preventDefault(),k(),x.focus();return}let n=t[0],r=t[t.length-1],i=document.activeElement;if(!x.contains(i)){e.preventDefault(),n.focus();return}if(n===r){e.preventDefault();return}e.shiftKey?i===n&&(e.preventDefault(),r.focus()):i===r&&(e.preventDefault(),n.focus())}}}));let N={open:()=>M(!0),close:()=>M(!1),toggle:()=>M(!T),get isOpen(){return T},destroy:()=>{T&&M(!1,!0),A(),D.forEach(e=>e()),D.length=0}};return N}const p=new WeakSet;function m(e=document){let t=[];for(let n of r(e,`dialog`)){if(p.has(n))continue;p.add(n),t.push(f(n))}return t}export{m as create,f as createDialog};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@data-slot/dialog",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown"
+  },
+  "dependencies": {
+    "@data-slot/core": "workspace:*"
+  },
+  "keywords": [
+    "headless",
+    "ui",
+    "dialog",
+    "modal",
+    "vanilla",
+    "data-slot"
+  ],
+  "license": "MIT"
+}