@samline/drawer 2.0.0

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Samuel Olvera (Samline)
+Copyright (c) 2023 Emil Kowalski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# Drawer
+
+A universal drawer package with one shared interaction runtime across React, Vue, Svelte, vanilla JS, and browser/CDN usage.
+
+Drawer is inspired by [Vaul](https://github.com/emilkowalski/vaul). The package keeps the original drawer interaction model while making the same user-facing behavior available through different integration styles.
+
+## Installation
+
+```bash
+npm install @samline/drawer
+```
+
+```bash
+bun add @samline/drawer
+```
+
+## Quick Start
+
+```ts
+import { createDrawer } from '@samline/drawer'
+
+const drawer = createDrawer({
+  direction: 'bottom',
+  dismissible: true,
+  triggerText: 'Open drawer',
+  showHandle: true,
+  title: 'Drawer title',
+  description: 'Drawer description',
+  content: 'Drawer content'
+})
+
+drawer.setOpen(true)
+```
+
+## Entrypoints
+
+- `@samline/drawer`: vanilla API and shared runtime helpers
+- `@samline/drawer/react`: React component API
+- `@samline/drawer/browser`: browser global for CDN or plain HTML
+- `@samline/drawer/vue`: Vue wrapper over the shared runtime
+- `@samline/drawer/svelte`: Svelte action and helpers
+- `@samline/drawer/core`: controller and snapshot contracts only
+- `@samline/drawer/styles.css`: shared styles
+
+## Full Docs
+
+Use docs/ when you want the full API surface, lifecycle notes, runtime attributes, and framework-specific guidance.
+
+- [docs/README.md](docs/README.md)
+- [docs/api.md](docs/api.md)
+- [docs/vanilla.md](docs/vanilla.md)
+- [docs/browser.md](docs/browser.md)
+- [docs/react.md](docs/react.md)
+- [docs/vue.md](docs/vue.md)
+- [docs/svelte.md](docs/svelte.md)
+
+## Notes
+
+- All entrypoints target the same user-facing drawer behavior for shared options.
+- When `shouldScaleBackground` is enabled, add `data-drawer-wrapper` to the app shell element that should scale.
+- When a child control should not start dragging, add `data-drawer-no-drag` to that element.
+- The public DOM contract uses `data-drawer-*` attributes.
+
+## License
+
+MIT