dom-top-layer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mark McCann
+
+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,42 @@
+# dom-top-layer
+
+`dom-top-layer` is a framework-agnostic TypeScript library for tracking which elements are currently active in the browser's top layer and for reacting to changes over time.
+
+The package is being set up to support two core goals:
+
+- inspect the current top-layer stack and its order
+- subscribe to top-layer changes without binding the API to a specific framework
+
+## Status
+
+This repository currently contains the package infrastructure and a minimal public entrypoint so the project can be built, tested, and published while the runtime API is designed.
+
+## Why This Package?
+
+Modern browsers expose several features that participate in the top layer, such as dialogs, popovers, and fullscreen elements. What browsers do not currently provide is a first-class, framework-agnostic way to inspect the active top-layer stack or subscribe to changes in that stack.
+
+`dom-top-layer` is intended to fill that gap with a small, focused browser utility that can later power framework adapters, hooks, or application-specific integrations without making those choices part of the core package.
+
+## Installation
+
+```bash
+npm install dom-top-layer
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Planned Direction
+
+- framework-agnostic top-layer inspection primitives
+- subscription APIs for top-layer changes
+- browser-focused behavior with TypeScript-first ergonomics
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {};\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/llms.txt

@@ -0,0 +1,17 @@
+Project: dom-top-layer
+
+Summary:
+- Framework-agnostic TypeScript library for tracking browser top-layer state.
+- Intended to expose top-layer inspection and subscription primitives.
+- Current repository state focuses on package infrastructure, build tooling, and test scaffolding.
+
+Guidance:
+- Prefer `README.md` for package-level positioning and setup commands.
+- Treat `src/index.ts` as the source of truth for the public export surface.
+- Keep the core package framework-agnostic and browser-focused.
+- Avoid introducing framework-specific hooks or adapters into the root package unless explicitly requested.
+
+Key Docs:
+- README: `README.md`
+- Public exports: `src/index.ts`
+- Project guidance: `AGENTS.md`

package/package.json

@@ -0,0 +1,125 @@
+{
+    "name": "dom-top-layer",
+    "version": "0.1.0",
+    "description": "A framework-agnostic TypeScript library for tracking browser top-layer state and subscribing to top-layer changes.",
+    "keywords": [
+        "top-layer",
+        "browser",
+        "dom",
+        "dialog",
+        "popover",
+        "fullscreen",
+        "typescript"
+    ],
+    "homepage": "https://github.com/marksmccann/dom-top-layer#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/marksmccann/dom-top-layer.git"
+    },
+    "bugs": {
+        "url": "https://github.com/marksmccann/dom-top-layer/issues"
+    },
+    "license": "MIT",
+    "author": "Mark McCann",
+    "type": "module",
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.cjs"
+        },
+        "./*": null
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE",
+        "llms.txt"
+    ],
+    "sideEffects": false,
+    "engines": {
+        "node": ">=18"
+    },
+    "scripts": {
+        "build": "tsup",
+        "commit": "cz",
+        "dev": "tsup --watch",
+        "format": "prettier --write .",
+        "lint": "eslint .",
+        "prepublishOnly": "npm run build",
+        "release": "release-it",
+        "typecheck": "tsc --project tsconfig.json --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "prepare": "node ./scripts/prepare.mjs"
+    },
+    "config": {
+        "commitizen": {
+            "path": "cz-conventional-changelog"
+        }
+    },
+    "release-it": {
+        "git": {
+            "commitMessage": "chore(release): v${version}",
+            "tagName": "v${version}",
+            "requireCleanWorkingDir": true,
+            "requireUpstream": true,
+            "requireBranch": "main"
+        },
+        "npm": {
+            "publish": true
+        },
+        "github": {
+            "release": false
+        },
+        "plugins": {
+            "@release-it/conventional-changelog": {
+                "infile": "CHANGELOG.md",
+                "header": "# Changelog",
+                "preset": {
+                    "name": "conventionalcommits"
+                }
+            }
+        },
+        "hooks": {
+            "before:init": [
+                "npm run lint",
+                "npm run typecheck",
+                "npm test"
+            ]
+        }
+    },
+    "lint-staged": {
+        "*.{ts,js,cjs,mjs,md}": [
+            "prettier --write"
+        ],
+        "*.{ts,js}": [
+            "eslint --fix"
+        ]
+    },
+    "devDependencies": {
+        "@commitlint/cli": "^20.4.2",
+        "@commitlint/config-conventional": "^20.4.2",
+        "@eslint/js": "^10.0.1",
+        "@release-it/conventional-changelog": "^10.0.5",
+        "@types/node": "^24.10.1",
+        "@vitest/coverage-v8": "^4.0.18",
+        "commitizen": "^4.3.1",
+        "cz-conventional-changelog": "^3.3.0",
+        "eslint": "^10.0.1",
+        "eslint-config-prettier": "^10.1.8",
+        "globals": "^16.5.0",
+        "husky": "^9.1.7",
+        "jsdom": "^27.2.0",
+        "lint-staged": "^16.2.7",
+        "prettier": "^3.8.1",
+        "release-it": "^19.2.4",
+        "tsup": "^8.5.1",
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.46.3",
+        "vitest": "^4.0.18"
+    }
+}