@library/dom 0.0.6 → 0.0.8

package/.turbo/turbo-test.log

@@ -1,19 +1,46 @@
-
- RUN  v5.0.3 /Users/yeonjuan/Desktop/projects/library/packages/dom
-      Coverage enabled with v8
-
- ✓ src/uniqueSelectorOf.spec.ts (18 tests) 20ms
-
- Test Files  1 passed (1)
-      Tests  18 passed (18)
-   Start at  18:32:31
-   Duration  485ms (environment 84%, transform 5%, tests 5%, worker 5%, import 1%)
-
- % Coverage report from v8
--------------------|---------|----------|---------|---------|-------------------
-File               | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
--------------------|---------|----------|---------|---------|-------------------
-All files          |     100 |      100 |     100 |     100 |                   
- index.ts          |       0 |        0 |       0 |       0 |                   
- ...eSelectorOf.ts |     100 |      100 |     100 |     100 |                   
--------------------|---------|----------|---------|---------|-------------------
+[?25l
+ RUN  v5.0.3 /Users/yeonjuan/Desktop/projects/library/packages/dom
+      Coverage enabled with v8
+
+[?2026h
+ ❯ src/uniqueSelectorOf.spec.ts [queued]
+
+ Test Files 0 passed (1)
+      Tests 0 passed (0)
+   Start at 22:55:01
+   Duration 605ms
+[?2026l[?2026h ✓ src/uniqueSelectorOf.spec.ts (18 tests) 24ms
+   ✓ uniqueSelectorOf (18)
+     ✓ should return ID selector when element has an ID 4ms
+     ✓ should return unique class selector 5ms
+     ✓ should return combined class selector when single classes are not unique 1ms
+     ✓ should prefer single class over combined classes when unique 0ms
+     ✓ should return path with nth-of-type when classes are not unique 2ms
+     ✓ should return shortest unique path 1ms
+     ✓ should handle nested elements with same tag 1ms
+     ✓ should stop at parent with ID when needed 1ms
+     ✓ should return unique selector for deeply nested elements 1ms
+     ✓ should handle elements with multiple non-unique classes 1ms
+     ✓ should handle body element 0ms
+     ✓ should return unique selector even for complex DOM 1ms
+     ✓ should handle elements with empty class attribute 0ms
+     ✓ should verify returned selector actually queries the correct element 2ms
+     ✓ should return combined class selector when unique 1ms
+     ✓ should handle elements without parent 0ms
+     ✓ should handle case where path never becomes unique until root 1ms
+     ✓ should return null when unable to generate unique selector 0ms
+
+ Test Files  1 passed (1)
+      Tests  18 passed (18)
+   Start at  22:55:01
+   Duration  760ms (environment 87%, worker 4%, tests 4%, transform 4%, import 1%)
+
+[?2026l % Coverage report from v8
+---------------------|---------|----------|---------|---------|-------------------
+File                 | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
+---------------------|---------|----------|---------|---------|-------------------
+All files            |     100 |      100 |     100 |     100 |                   
+ index.ts            |       0 |        0 |       0 |       0 |                   
+ uniqueSelectorOf.ts |     100 |      100 |     100 |     100 |                   
+---------------------|---------|----------|---------|---------|-------------------
+[?2026h[?2026l[?25h

package/coverage/lcov-report/index.html

@@ -116,7 +116,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-10-04T09:32:32.477Z
+                at 2026-10-09T09:53:07.218Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/index.ts.html

@@ -73,7 +73,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-10-04T09:32:32.477Z
+                at 2026-10-09T09:53:07.218Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/uniqueSelectorOf.ts.html

@@ -228,13 +228,13 @@
  * @returns {string | null} - A unique query selector string that can be used with document.querySelector.
  * @example
  * ```
- * import { queryKeyOf } from "@library/dom";
+ * import { uniqueSelectorOf } from "@library/dom";
  *
  * const el = document.getElementById('myId');
- * queryKeyOf(el); // "#myId"
+ * uniqueSelectorOf(el); // "#myId"
  *
  * const el2 = document.querySelector('.unique-class');
- * queryKeyOf(el2); // ".unique-class"
+ * uniqueSelectorOf(el2); // ".unique-class"
  * ```
  */
 export function uniqueSelectorOf(element: HTMLElement): string | null {
@@ -307,7 +307,7 @@ export function uniqueSelectorOf(element: HTMLElement): string | null {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-10-04T09:32:32.477Z
+                at 2026-10-09T09:53:07.218Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/llms.txt

@@ -0,0 +1,45 @@
+<!-- Generated by `yarn docs`. Do not edit by hand. -->
+# @library/dom
+
+> A collection of DOM utilities for TypeScript.
+
+Install:
+
+```console
+npm install @library/dom
+```
+
+All exports are named ESM/CJS exports, importable as:
+
+```ts
+import { uniqueSelectorOf } from "@library/dom";
+```
+
+## API
+
+### uniqueSelectorOf
+
+Generate the shortest unique querySelector string that identifies the given element.
+Priority: id > unique class > path with nth-of-type
+
+```ts
+function uniqueSelectorOf(element: HTMLElement): string | null
+```
+
+Parameters:
+
+- `element`: The HTML element to generate a query selector for.
+
+Returns: A unique query selector string that can be used with document.querySelector.
+
+Example:
+
+```ts
+import { uniqueSelectorOf } from "@library/dom";
+
+const el = document.getElementById('myId');
+uniqueSelectorOf(el); // "#myId"
+
+const el2 = document.querySelector('.unique-class');
+uniqueSelectorOf(el2); // ".unique-class"
+```

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@library/dom",
-  "version": "0.0.6",
+  "version": "0.0.8",
+  "description": "A collection of DOM utilities for TypeScript.",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/cjs/index.d.cts",
@@ -17,6 +18,21 @@
       }
     }
   },
+  "keywords": [
+    "dom",
+    "html",
+    "typescript",
+    "utility"
+  ],
+  "homepage": "https://github.com/yeonjuan/library/tree/main/packages/dom#readme",
+  "bugs": {
+    "url": "https://github.com/yeonjuan/library/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yeonjuan/library.git",
+    "directory": "packages/dom"
+  },
   "license": "MIT",
   "scripts": {
     "build": "rimraf dist && tsup --tsconfig tsconfig.build.json",
@@ -25,5 +41,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "e1d0caf47e9ca8305ad84b2e2284c30fbe6b754d"
+  "gitHead": "fea3f714ec98af5ce58621c53734e44a62f881df"
 }

package/src/uniqueSelectorOf.ts

@@ -5,13 +5,13 @@
  * @returns {string | null} - A unique query selector string that can be used with document.querySelector.
  * @example
  * ```
- * import { queryKeyOf } from "@library/dom";
+ * import { uniqueSelectorOf } from "@library/dom";
  *
  * const el = document.getElementById('myId');
- * queryKeyOf(el); // "#myId"
+ * uniqueSelectorOf(el); // "#myId"
  *
  * const el2 = document.querySelector('.unique-class');
- * queryKeyOf(el2); // ".unique-class"
+ * uniqueSelectorOf(el2); // ".unique-class"
  * ```
  */
 export function uniqueSelectorOf(element: HTMLElement): string | null {