proscenium 0.19.0.beta6 → 0.19.0.beta7

data/lib/proscenium/ui/flash/node_modules/dom-mutations/readme.md

@@ -0,0 +1,125 @@
+# dom-mutations
+
+> Observe changes to the DOM using an async iterable — A nicer API for [MutationObserver](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver)
+
+This package only works in the browser.
+
+## Install
+
+```sh
+npm install dom-mutations
+```
+
+## Usage
+
+```js
+import domMutations from 'dom-mutations';
+
+const target = document.querySelector('#unicorn');
+
+for await (const mutation of domMutations(target, {childList: true})) {
+	console.log('Mutation:', mutation);
+}
+```
+
+## API
+
+### domMutations(target, options?) <sup>(default export)</sup>
+
+Accepts the same arguments as [`MutationObserver#observe()`](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver/observe#parameters) with an additional optional [`signal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/signal) option to abort the observation. If the signal is triggered, the async iterable throws an [abort error](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort).
+
+Returns an [`AsyncIterable`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_async_iterator_and_async_iterable_protocols) that yields [`MutationRecord`](https://developer.mozilla.org/en-US/docs/Web/API/MutationRecord) objects representing individual mutations.
+
+### batchedDomMutations(target, options?) <sup>(named export)</sup>
+
+Similar to `domMutations()`, but yields batches of [`MutationRecord`](https://developer.mozilla.org/en-US/docs/Web/API/MutationRecord) objects, each batch representing a group of mutations captured together. This method is less convenient, but can be useful in some cases when you need to handle mutations together as a group.
+
+```js
+import {batchedDomMutations} from 'dom-mutations';
+
+const target = document.querySelector('#unicorn');
+
+for await (const mutations of batchedDomMutations(target, {childList: true})) {
+	console.log('Batch of mutations:', mutations);
+}
+```
+
+## FAQ
+
+### How do I stop the iteration?
+
+Simply `return` or `break` in the loop body.
+
+### How do I stop the iteration from the outside?
+
+**Triggering the iterator to return**
+
+```js
+import domMutations from 'dom-mutations';
+
+const target = document.querySelector('#unicorn');
+
+const mutationIterator = domMutations(target, {childList: true})[Symbol.asyncIterator]();
+
+(async () => {
+	for await (const mutation of mutationIterator) {
+		console.log('Mutation:', mutation);
+	}
+})();
+
+setTimeout(() => {
+	mutationIterator.return();
+}, 10000);
+```
+
+**Using a variable**
+
+This has the downside of not ending the iteration until the next mutation.
+
+```js
+import domMutations from 'dom-mutations';
+
+const target = document.querySelector('#unicorn');
+
+let shouldStop = false;
+
+(async () => {
+	for await (const mutation of domMutations(target, {childList: true})) {
+		if (shouldStop) {
+			break;
+		}
+
+		console.log('Mutation:', mutation);
+	}
+})();
+
+setTimeout(() => {
+	shouldStop = true;
+}, 10000);
+```
+
+**Using [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController)**
+
+Unlike the above approaches, this will make the iterable throw an [abort error](https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort).
+
+```js
+import domMutations from 'dom-mutations';
+
+const target = document.querySelector('#unicorn');
+const controller = new AbortController();
+const {signal} = controller;
+
+(async () => {
+	for await (const mutation of domMutations(target, {childList: true, signal})) {
+		console.log('Mutation:', mutation);
+	}
+})();
+
+setTimeout(() => {
+	controller.abort();
+}, 10000);
+```
+
+## Related
+
+- [request-animation-frames](https://github.com/sindresorhus/request-animation-frames) - Use `requestAnimationFrame` as an async iterable, in any JavaScript environment

data/lib/proscenium/ui/flash/node_modules/sourdough-toast/LICENSE

@@ -0,0 +1,20 @@
+Copyright Mikkel Malmberg
+
+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.

data/lib/proscenium/ui/flash/node_modules/sourdough-toast/README.md

@@ -0,0 +1,11 @@
+<img src="example/toast.png" alt="Toast" width="120" />
+
+# sourdough-toast
+
+A plain JavaScript toast notification library inspired by [Sonner](https://sonner.emilkowal.ski).
+
+[Demo and usage](https://sourdough-toast.vercel.app/example)
+
+## License
+
+MIT

data/lib/proscenium/ui/flash/node_modules/sourdough-toast/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "sourdough-toast",
+  "version": "0.1.0",
+  "description": "Delicious Sourdough Toast",
+  "main": "src/sourdough-toast.js",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "npm run css",
+    "start": "serve",
+    "dev": "five-server --open=false & npm run css:watch",
+    "css": "tailwindcss -i example/example.css -o example/example.compiled.css",
+    "css:watch": "npm run css -- -w",
+    "test": "playwright test",
+    "test:serve": "serve -l 3030"
+  },
+  "keywords": [],
+  "author": "Mikkel Malmberg (@mikker)",
+  "license": "MIT",
+  "devDependencies": {
+    "@playwright/test": "^1.42.1",
+    "@tailwindcss/cli": "^4.0.0-alpha.9",
+    "five-server": "^0.3.2",
+    "prettier": "^3.2.5",
+    "prettier-plugin-tailwindcss": "^0.5.12",
+    "serve": "^14.2.1",
+    "tailwindcss": "^4.0.0-alpha.9"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikker/sourdough-toast.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mikker/sourdough-toast/issues"
+  },
+  "homepage": "https://github.com/mikker/sourdough-toast#readme",
+  "dependencies": {},
+  "prettier": {
+    "plugins": [
+      "prettier-plugin-tailwindcss"
+    ]
+  }
+}