{feature} rename composed-css package

Author: bgotink

.eslintrc.yml

@@ -38,7 +38,6 @@ rules:
 overrides:
   - files:
       - packages/test/src/harness/**/browser.js
-      - packages/composed-css/src/**/*.js
     env:
       browser: true
   - files: ["**/*.ts"]

.prettierignore

@@ -1,5 +1,5 @@
 .yarn
 
 /packages/*/dist
-/packages/composed-css/*.js
-/packages/composed-css/*.cjs
+/packages/composed-dom/*.js
+/packages/composed-dom/*.cjs

.yarn/versions/0cf4f50d.yml

@@ -0,0 +1,5 @@
+releases:
+  composed-dom: major
+
+declined:
+  - "@ngx-playwright/test"

angular.json

@@ -10,7 +10,7 @@
 				"build": {
 					"builder": "@snuggery/snuggery:glob",
 					"options": {
-						"include": "@ngx-playwright/*"
+						"include": ["@ngx-playwright/*", "composed-dom"]
 					}
 				},
 				"deploy": {
@@ -99,8 +99,8 @@
 				}
 			}
 		},
-		"@ngx-playwright/composed-css": {
-			"root": "packages/composed-css",
+		"composed-dom": {
+			"root": "packages/composed-dom",
 			"architect": {
 				"build": {
 					"builder": "@snuggery/build-node:build",
@@ -120,7 +120,7 @@
 							}
 						],
 						"package": true,
-						"tsconfig": "packages/composed-css/tsconfig.lib.json"
+						"tsconfig": "packages/composed-dom/tsconfig.lib.json"
 					}
 				}
 			}

packages/composed-css/index.js

@@ -0,0 +1,2 @@
+/index.js           		linguist-generated
+/selector-engine.cjs		linguist-generated

packages/composed-dom/.gitattributes

@@ -1,4 +1,4 @@
-# `@ngx-playwright/composed-css`
+# `composed-dom`
 
 <!-- cspell:word shadowrootmode -->
 
@@ -86,6 +86,23 @@ import {selectors} from "@playwright/test";
 
 await selectors.register(
 	"css:composed",
-	import.meta.resolve("@ngx-playwright/composed-css/selector-engine"),
+	import.meta.resolve("composed-dom/selector-engine"),
 );
 ```
+
+## Usage in non-browser environments
+
+The `composed-dom` package only references one browser-specific global: the `document`.
+The `document` is only used if no `container` is passed as second parameter.
+This makes it possible to use this package in environments other than a browser tab, as long as you're able to provide a valid DOM Document or Element as `container` parameter.
+
+```js
+import {querySelector} from "composed-dom";
+import {JSDOM} from "jsdom";
+
+const dom = new JSDOM(/* ... */);
+
+// Pass in a container argument to make querySelector run in
+// this non-browser environment.
+const mainHeader = querySelector("h1", dom.window.document);
+```