@at-flux/dom 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Taylor Siviter
+
+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,15 @@
+# @at-flux/dom
+
+Type-safe DOM helpers for Astro / browser code. **Separate** from `@at-flux/astroflare` — add it as its own dependency and import from `@at-flux/dom`.
+
+## Install
+
+```bash
+pnpm add @at-flux/dom
+```
+
+## Usage
+
+```ts
+import { getElementById, getElementByQueryOrThrow } from '@at-flux/dom';
+```

package/dist/index.cjs

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+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 = {};
+__export(index_exports, {
+  getElementById: () => getElementById,
+  getElementByIdOrThrow: () => getElementByIdOrThrow,
+  getElementByQuery: () => getElementByQuery,
+  getElementByQueryOrThrow: () => getElementByQueryOrThrow
+});
+module.exports = __toCommonJS(index_exports);
+var getElementById = (id, ctor) => {
+  const element = document.getElementById(id);
+  return element instanceof ctor ? element : null;
+};
+var getElementByIdOrThrow = (id, ctor) => {
+  const element = getElementById(id, ctor);
+  if (!element) {
+    throw new Error(`Element with id "${id}" not found or not the expected type`);
+  }
+  return element;
+};
+var getElementByQuery = (selector, root = document) => {
+  return root.querySelector(selector);
+};
+var getElementByQueryOrThrow = (selector, root = document) => {
+  const element = getElementByQuery(selector, root);
+  if (!element) {
+    throw new Error(`Element not found with selector "${selector}"`);
+  }
+  return element;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getElementById,
+  getElementByIdOrThrow,
+  getElementByQuery,
+  getElementByQueryOrThrow
+});

package/dist/index.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Type-safe DOM helpers shared across Astroflare projects.
+ */
+declare const getElementById: <T extends HTMLElement>(id: string, ctor: {
+    new (...args: unknown[]): T;
+} | (Function & {
+    prototype: T;
+})) => T | null;
+declare const getElementByIdOrThrow: <T extends HTMLElement>(id: string, ctor: {
+    new (...args: unknown[]): T;
+} | (Function & {
+    prototype: T;
+})) => T;
+declare const getElementByQuery: <T extends Element>(selector: string, root?: Document | Element) => T | null;
+declare const getElementByQueryOrThrow: <T extends Element>(selector: string, root?: Document | Element) => T;
+
+export { getElementById, getElementByIdOrThrow, getElementByQuery, getElementByQueryOrThrow };

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Type-safe DOM helpers shared across Astroflare projects.
+ */
+declare const getElementById: <T extends HTMLElement>(id: string, ctor: {
+    new (...args: unknown[]): T;
+} | (Function & {
+    prototype: T;
+})) => T | null;
+declare const getElementByIdOrThrow: <T extends HTMLElement>(id: string, ctor: {
+    new (...args: unknown[]): T;
+} | (Function & {
+    prototype: T;
+})) => T;
+declare const getElementByQuery: <T extends Element>(selector: string, root?: Document | Element) => T | null;
+declare const getElementByQueryOrThrow: <T extends Element>(selector: string, root?: Document | Element) => T;
+
+export { getElementById, getElementByIdOrThrow, getElementByQuery, getElementByQueryOrThrow };

package/dist/index.js

@@ -0,0 +1,28 @@
+// src/index.ts
+var getElementById = (id, ctor) => {
+  const element = document.getElementById(id);
+  return element instanceof ctor ? element : null;
+};
+var getElementByIdOrThrow = (id, ctor) => {
+  const element = getElementById(id, ctor);
+  if (!element) {
+    throw new Error(`Element with id "${id}" not found or not the expected type`);
+  }
+  return element;
+};
+var getElementByQuery = (selector, root = document) => {
+  return root.querySelector(selector);
+};
+var getElementByQueryOrThrow = (selector, root = document) => {
+  const element = getElementByQuery(selector, root);
+  if (!element) {
+    throw new Error(`Element not found with selector "${selector}"`);
+  }
+  return element;
+};
+export {
+  getElementById,
+  getElementByIdOrThrow,
+  getElementByQuery,
+  getElementByQueryOrThrow
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@at-flux/dom",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "Type-safe DOM helpers for Astroflare projects",
+  "author": "Taylor Siviter <taylor@siviter.xyz>",
+  "license": "MIT",
+  "keywords": [
+    "astro",
+    "dom",
+    "utilities",
+    "typescript"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "jsdom": "^25.0.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/at-flux/astroflare.git"
+  },
+  "bugs": {
+    "url": "https://github.com/at-flux/astroflare/issues"
+  },
+  "homepage": "https://github.com/at-flux/astroflare#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}