@needle-tools/engine 4.11.2 → 4.11.3-next.2e95398

package/lib/engine-components/splines/SplineWalker.d.ts

@@ -6,6 +6,9 @@ import { SplineContainer } from "./Spline.js";
  * Use this with a SplineContainer component.
  *
  * - Example http://samples.needle.tools/splines
+ *
+ * @category Splines
+ * @group Components
  */
 export declare class SplineWalker extends Behaviour {
     /**

package/lib/engine-components/splines/SplineWalker.js

@@ -14,6 +14,9 @@ import { SplineContainer } from "./Spline.js";
  * Use this with a SplineContainer component.
  *
  * - Example http://samples.needle.tools/splines
+ *
+ * @category Splines
+ * @group Components
  */
 export class SplineWalker extends Behaviour {
     /**

package/lib/engine-components/splines/SplineWalker.js.map

@@ -1 +1 @@
-{"version":3,"file":"SplineWalker.js","sourceRoot":"","sources":["../../../src/engine-components/splines/SplineWalker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SplineWalker.js","sourceRoot":"","sources":["../../../src/engine-components/splines/SplineWalker.ts"],"names":[],"mappings":"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"}

package/lib/engine-components/timeline/SignalAsset.d.ts

@@ -1,14 +1,24 @@
 import { Behaviour } from "../Component.js";
 import { EventList } from "../EventList.js";
+/**
+ * Used to reference a signal asset in a SignalReceiver. This is internally used by the {@link SignalReceiverEvent}.
+ */
 export declare class SignalAsset {
     guid: string;
 }
+/**
+ * An event that links a signal to a reaction.
+ * Used internally by {@link SignalReceiver}.
+ */
 export declare class SignalReceiverEvent {
     signal: SignalAsset;
     reaction: EventList<void>;
 }
 /** SignalReceiver is a component that listens for signals and invokes a reaction when a signal is received.
- * Signals can be added to a signal track on a timeline
+ * Signals can be added to a signal track on a {@link PlayableDirector}
+ *
+ * @category Sequencing and Timelines
+ * @group Components
  */
 export declare class SignalReceiver extends Behaviour {
     private static receivers;

package/lib/engine-components/timeline/SignalAsset.js

@@ -9,12 +9,19 @@ import { getParam } from "../../engine/engine_utils.js";
 import { Behaviour } from "../Component.js";
 import { EventList } from "../EventList.js";
 const debug = getParam("debugsignals");
+/**
+ * Used to reference a signal asset in a SignalReceiver. This is internally used by the {@link SignalReceiverEvent}.
+ */
 export class SignalAsset {
     guid;
 }
 __decorate([
     serializable()
 ], SignalAsset.prototype, "guid", void 0);
+/**
+ * An event that links a signal to a reaction.
+ * Used internally by {@link SignalReceiver}.
+ */
 export class SignalReceiverEvent {
     signal;
     reaction;
@@ -26,7 +33,10 @@ __decorate([
     serializable(EventList)
 ], SignalReceiverEvent.prototype, "reaction", void 0);
 /** SignalReceiver is a component that listens for signals and invokes a reaction when a signal is received.
- * Signals can be added to a signal track on a timeline
+ * Signals can be added to a signal track on a {@link PlayableDirector}
+ *
+ * @category Sequencing and Timelines
+ * @group Components
  */
 export class SignalReceiver extends Behaviour {
     static receivers = {};

package/lib/engine-components/timeline/SignalAsset.js.map

@@ -1 +1 @@
-{"version":3,"file":"SignalAsset.js","sourceRoot":"","sources":["../../../src/engine-components/timeline/SignalAsset.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SignalAsset.js","sourceRoot":"","sources":["../../../src/engine-components/timeline/SignalAsset.ts"],"names":[],"mappings":"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"}

package/lib/engine-components/ui/Raycaster.d.ts

@@ -11,6 +11,12 @@ export declare abstract class Raycaster extends Behaviour {
     onDisable(): void;
     abstract performRaycast(_opts?: IRaycastOptions | RaycastOptions | null): Intersection[] | null;
 }
+/**
+ * A Raycaster that performs raycasting against its own GameObject.
+ *
+ * @category Interaction
+ * @group Components
+ */
 export declare class ObjectRaycaster extends Raycaster {
     private targets;
     private raycastHits;
@@ -18,9 +24,21 @@ export declare class ObjectRaycaster extends Raycaster {
     start(): void;
     performRaycast(opts?: IRaycastOptions | RaycastOptions | null): Intersection[] | null;
 }
+/**
+ * A Raycaster that performs raycasting against UI elements (objects with a CanvasRenderer component).
+ *
+ * @category UI
+ * @group Components
+ */
 export declare class GraphicRaycaster extends ObjectRaycaster {
     constructor();
 }
+/**
+ * A Raycaster that performs sphere overlap raycasting for spatial grab interactions in XR.
+ *
+ * @category XR
+ * @group Components
+ */
 export declare class SpatialGrabRaycaster extends Raycaster {
     /**
      * Use to disable SpatialGrabRaycaster globally

package/lib/engine-components/ui/Raycaster.js

@@ -25,6 +25,12 @@ export class Raycaster extends Behaviour {
         EventSystem.get(this.context)?.unregister(this);
     }
 }
+/**
+ * A Raycaster that performs raycasting against its own GameObject.
+ *
+ * @category Interaction
+ * @group Components
+ */
 export class ObjectRaycaster extends Raycaster {
     targets = null;
     raycastHits = [];
@@ -61,6 +67,12 @@ export class ObjectRaycaster extends Raycaster {
 __decorate([
     serializable()
 ], ObjectRaycaster.prototype, "ignoreSkinnedMeshes", void 0);
+/**
+ * A Raycaster that performs raycasting against UI elements (objects with a CanvasRenderer component).
+ *
+ * @category UI
+ * @group Components
+ */
 export class GraphicRaycaster extends ObjectRaycaster {
     // eventCamera: Camera | null = null;
     // ignoreReversedGraphics: boolean = false;
@@ -70,6 +82,12 @@ export class GraphicRaycaster extends ObjectRaycaster {
         this.ignoreSkinnedMeshes = true;
     }
 }
+/**
+ * A Raycaster that performs sphere overlap raycasting for spatial grab interactions in XR.
+ *
+ * @category XR
+ * @group Components
+ */
 export class SpatialGrabRaycaster extends Raycaster {
     /**
      * Use to disable SpatialGrabRaycaster globally

package/lib/engine-components/ui/Raycaster.js.map

@@ -1 +1 @@
-{"version":3,"file":"Raycaster.js","sourceRoot":"","sources":["../../../src/engine-components/ui/Raycaster.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Raycaster.js","sourceRoot":"","sources":["../../../src/engine-components/ui/Raycaster.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAA0B,WAAW,EAAE,MAAM,OAAO,CAAC;AAE5D,OAAO,EAAwB,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;;GAGG;AACH,MAAM,OAAgB,SAAU,SAAQ,SAAS;IAC7C,KAAK;QACD,WAAW,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,QAAQ;QACJ,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,SAAS;QACL,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;CAGJ;AAGD;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAClC,OAAO,GAAsB,IAAI,CAAC;IAClC,WAAW,GAAmB,EAAE,CAAC;IAGzC,mBAAmB,GAAG,KAAK,CAAC;IAE5B,KAAK;QACD,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,cAAc,CAAC,OAAgD,IAAI;QAC/D,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,IAAI,KAAK,IAAI,cAAc,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;QAChC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAElC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;QAC7B,IAAI,IAAI,CAAC,mBAAmB,EAAE;YAC1B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,EAAE;gBACpB,mEAAmE;gBACnE,IAAI,GAAG,YAAY,WAAW,EAAE;oBAC5B,OAAO,sBAAsB,CAAC;iBACjC;gBACD,wCAAwC;gBACxC,IAAI,IAAI;oBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC3B,6BAA6B;gBAC7B,OAAO,IAAI,CAAC;YAChB,CAAC,CAAC;SACL;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AA9BG;IADC,YAAY,EAAE;4DACa;AAiChC;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACjD,qCAAqC;IACrC,2CAA2C;IAC3C,iDAAiD;IAEjD;QACI,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;IACpC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAE/C;;OAEG;IACH,MAAM,CAAC,KAAK,GAAY,IAAI,CAAC;IAE7B,cAAc,CAAC,KAA+C;QAC1D,uCAAuC;QACvC,IAAI,CAAC,eAAe,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzC,IAAI,CAAC,oBAAoB,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7C,IAAI,CAAC,KAAK,EAAE,GAAG;YAAE,OAAO,IAAI,CAAC;QAE7B,0FAA0F;QAC1F,6FAA6F;QAC7F,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC;QAErB,uEAAuE;QACvE,+BAA+B;QAC/B,oDAAoD;QAEpD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/engine",
-  "version": "4.11.2",
+  "version": "4.11.3-next.2e95398",
   "description": "Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development with great integrations into editors like Unity or Blender - and can be deployed onto any device! It is flexible, extensible and networking and XR are built-in.",
   "main": "dist/needle-engine.min.js",
   "exports": {
@@ -169,4 +169,4 @@
   "module": "lib/needle-engine.js",
   "typings": "lib/needle-engine.d.ts",
   "types": "lib/needle-engine.d.ts"
-}
+}

package/src/engine/api.ts

@@ -76,6 +76,7 @@ export { prefix, validate } from "./engine_util_decorator.js";
 export * from "./engine_utils.js";
 export * from "./engine_utils_format.js";
 export * from "./engine_utils_screenshot.js";
+export { generateQRCode } from "./engine_utils_qrcode.js";
 export * from "./export/index.js";
 export * from "./extensions/index.js";
 export * from "./js-extensions/index.js";

package/src/engine/engine_utils.ts

@@ -3,11 +3,9 @@ import { Quaternion, Vector2, Vector3, Vector4 } from "three";
 
 declare type Vector = Vector2 | Vector3 | Vector4 | Quaternion;
 
-import { needleLogoOnlySVG } from "./assets/index.js";
 import type { Context } from "./engine_context.js";
 import { ContextRegistry } from "./engine_context_registry.js";
 import { type SourceIdentifier } from "./engine_types.js";
-import type { NeedleEngineWebComponent } from "./webcomponents/needle-engine.js";
 
 // https://schneidenbach.gitbooks.io/typescript-cookbook/content/nameof-operator.html
 /** @internal */
@@ -899,230 +897,3 @@ export async function PromiseAllWithErrors<T>(promise: Promise<T>[]): Promise<{
 
 
 
-
-
-/** Generates a QR code HTML image using https://github.com/davidshimjs/qrcodejs
- * @param args.text The text to encode
- * @param args.width The width of the QR code
- * @param args.height The height of the QR code
- * @param args.colorDark The color of the dark squares
- * @param args.colorLight The color of the light squares
- * @param args.correctLevel The error correction level to use
- * @param args.showLogo If true, the same logo as for the Needle loading screen will be drawn in the center of the QR code
- * @param args.showUrl If true, the URL will be shown below the QR code
- * @param args.domElement The dom element to append the QR code to. If not provided a new div will be created and returned
- * @returns The dom element containing the QR code
- */
-export async function generateQRCode(args: { domElement?: HTMLElement, text: string, width?: number, height?: number, colorDark?: string, colorLight?: string, correctLevel?: any, showLogo?: boolean, showUrl?: boolean }): Promise<HTMLElement> {
-
-    // Ensure that the QRCode library is loaded
-    if (!globalThis["QRCode"]) {
-        const url = "https://cdn.jsdelivr.net/gh/davidshimjs/qrcodejs@gh-pages/qrcode.min.js";
-        let script = document.head.querySelector(`script[src="${url}"]`) as HTMLScriptElement;
-        if (!script) {
-            script = document.createElement("script");
-            script.src = url;
-            document.head.appendChild(script);
-        }
-
-        await new Promise((resolve, _reject) => {
-            script.addEventListener("load", () => {
-                resolve(true);
-            });
-        });
-    }
-
-    const QRCODE = globalThis["QRCode"];
-    const target = args.domElement ?? document.createElement("div");
-    const qrCode = new QRCODE(target, {
-        width: args.width ?? 256,
-        height: args.height ?? 256,
-        colorDark: "#000000",
-        colorLight: "#ffffff",
-        correctLevel: args.showLogo ? QRCODE.CorrectionLevel.H : QRCODE.CorrectLevel.M,
-        ...args,
-    });
-
-    // Number of rows/columns of the generated QR code
-    const moduleCount = qrCode?._oQRCode.moduleCount || 0;
-    const canvas = qrCode?._oDrawing?._elCanvas as HTMLCanvasElement;
-    
-    let sizePercentage = 0.25;
-    if (moduleCount < 40)
-        sizePercentage = Math.floor(moduleCount / 4) / moduleCount;
-    else
-        sizePercentage = Math.floor(moduleCount / 6) / moduleCount;
-    
-    const paddingPercentage = Math.floor(moduleCount / 20) / moduleCount;
-    try {
-        const img = await addOverlays(canvas, { showLogo: args.showLogo, logoSize: sizePercentage, logoPadding: paddingPercentage }).catch(_e => { /** ignore */ });
-        if (img) {
-            target.innerHTML = "";
-            target.append(img);
-        }
-    }
-    catch { } // Ignore
-
-    if (args.showUrl !== false && args.text) {
-        // Add link label below the QR code
-        // Clean up the text. If it's a URL: remove the protocol, www. part, trailing slashes or trailing question marks
-        const existingLabel = target.querySelector(".qr-code-link-label");
-        let displayText = args.text.replace(/^(https?:\/\/)?(www\.)?/, "").replace(/\/+$/, "").replace(/\?+$/, "");
-        displayText = "Scan to visit " + displayText;
-        if (existingLabel) {
-            existingLabel.textContent = displayText;
-        } else {
-            // Create a new label
-            const linkLabel = document.createElement("div");
-            linkLabel.classList.add("qr-code-link-label");
-            args.text = displayText;
-            linkLabel.textContent = args.text;
-            linkLabel.addEventListener("click", (ev) => {
-                // Prevent the QR panel from closing
-                ev.stopImmediatePropagation();
-            });
-
-            linkLabel.style.textAlign = "center";
-            linkLabel.style.fontSize = "0.8em";
-            linkLabel.style.marginTop = "0.1em";
-            linkLabel.style.color = "#000000";
-            linkLabel.style.fontFamily = "'Roboto Flex', sans-serif";
-            linkLabel.style.opacity = "0.5";
-            linkLabel.style.wordBreak = "break-all";
-            linkLabel.style.wordWrap = "break-word";
-            linkLabel.style.marginBottom = "0.3em";
-
-            // Ensure max. width
-            target.style.width = "calc(210px + 20px)";
-
-            target.appendChild(linkLabel);
-        }
-    }
-
-    return target;
-}
-
-async function addOverlays(canvas: HTMLCanvasElement, args: { showLogo?: boolean, logoSize?: number, logoPadding?: number }): Promise<HTMLImageElement | void> {
-    if (!canvas) return;
-
-    // Internal settings
-    const canvasPadding = 8;
-    const shadowBlur = 20;
-    const rectanglePadding = args.logoPadding || 1. / 32;
-    // With dropshadow under the logo
-    /*
-    const shadowColor = "#00000099";
-    const rectangleRadius = 0.4 * 16;
-    */
-    // Without dropshadow under the logo
-    const shadowColor = "transparent";
-    const rectangleRadius = 0;
-
-    // Draw the website's icon in the center of the QR code
-    const faviconImage = new Image();
-    const element = document.querySelector("needle-engine") as NeedleEngineWebComponent;
-    const logoSrc = element?.getAttribute("loading-logo-src") || needleLogoOnlySVG;
-    if (!logoSrc) return;
-
-    let haveLogo = false;
-    if (args.showLogo !== false) {
-        faviconImage.src = logoSrc;
-        haveLogo = await new Promise((resolve, _reject) => {
-            faviconImage.onload = () => resolve(true);
-            faviconImage.onerror = (err) => {
-                console.error("Error loading favicon image for QR code", err);
-                resolve(false);
-            };
-        });
-    }
-
-    // Add some padding around the canvas – we need to copy the QR code image to a larger canvas
-    const paddedCanvas = document.createElement("canvas");
-    paddedCanvas.width = canvas.width + canvasPadding;
-    paddedCanvas.height = canvas.height + canvasPadding;
-    const paddedContext = paddedCanvas.getContext("2d");
-    if (!paddedContext) {
-        return;
-    }
-
-    // Clear with white
-    paddedContext.fillStyle = "#ffffff";
-    paddedContext.fillRect(0, 0, paddedCanvas.width, paddedCanvas.height);
-    paddedContext.drawImage(canvas, canvasPadding / 2, canvasPadding / 2);
-
-    // Enable anti-aliasing
-    paddedContext.imageSmoothingEnabled = true;
-    paddedContext.imageSmoothingQuality = "high";
-    // @ts-ignore
-    paddedContext.mozImageSmoothingEnabled = true;
-    // @ts-ignore
-    paddedContext.webkitImageSmoothingEnabled = true;
-
-    // Draw a slight gradient background with 10% opacity and "lighten" composite operation
-    paddedContext.globalCompositeOperation = "lighten";
-    const gradient = paddedContext.createLinearGradient(0, 0, 0, paddedCanvas.height);
-    gradient.addColorStop(0, "rgb(45, 45, 45)");
-    gradient.addColorStop(1, "rgb(45, 45, 45)");
-    paddedContext.fillStyle = gradient;
-    paddedContext.fillRect(0, 0, paddedCanvas.width, paddedCanvas.height);
-    paddedContext.globalCompositeOperation = "source-over";
-
-
-    let sizeX = Math.min(canvas.width, canvas.height) * (args.logoSize || 0.25);
-    let sizeY = sizeX;
-
-    if (haveLogo) {
-        // Get aspect of image
-        const aspect = faviconImage.width / faviconImage.height;
-        if (aspect > 1) sizeY = sizeX / aspect;
-        else sizeX = sizeY * aspect;
-
-        const rectanglePaddingPx = rectanglePadding * canvas.width;
-
-        // Apply padding
-        const sizeForBackground = Math.max(sizeX, sizeY);
-        const sizeXPadded = Math.round(sizeForBackground + rectanglePaddingPx);
-        const sizeYPadded = Math.round(sizeForBackground + rectanglePaddingPx);
-        const x = (paddedCanvas.width - sizeForBackground) / 2;
-        const y = (paddedCanvas.height - sizeForBackground) / 2;
-
-        // Draw shape with blurred shadow
-        paddedContext.shadowColor = shadowColor;
-        paddedContext.shadowBlur = shadowBlur;
-
-        // Draw rounded rectangle with radius
-        // Convert 0.4rem to pixels, taking DPI into account
-        const radius = rectangleRadius;
-        const xPadded = Math.round(x - rectanglePaddingPx / 2);
-        const yPadded = Math.round(y - rectanglePaddingPx / 2);
-        paddedContext.beginPath();
-        paddedContext.moveTo(xPadded + radius, yPadded);
-        paddedContext.lineTo(xPadded + sizeXPadded - radius, yPadded);
-        paddedContext.quadraticCurveTo(xPadded + sizeXPadded, yPadded, xPadded + sizeXPadded, yPadded + radius);
-        paddedContext.lineTo(xPadded + sizeXPadded, yPadded + sizeYPadded - radius);
-        paddedContext.quadraticCurveTo(xPadded + sizeXPadded, yPadded + sizeYPadded, xPadded + sizeXPadded - radius, yPadded + sizeYPadded);
-        paddedContext.lineTo(xPadded + radius, yPadded + sizeYPadded);
-        paddedContext.quadraticCurveTo(xPadded, yPadded + sizeYPadded, xPadded, yPadded + sizeYPadded - radius);
-        paddedContext.lineTo(xPadded, yPadded + radius);
-        paddedContext.quadraticCurveTo(xPadded, yPadded, xPadded + radius, yPadded);
-        paddedContext.fillStyle = "#ffffff";
-        paddedContext.closePath();
-        paddedContext.fill();
-        paddedContext.clip();
-
-        // Reset shadow and draw favicon
-        paddedContext.shadowColor = "transparent";
-        const logoX = (paddedCanvas.width - sizeX) / 2;
-        const logoY = (paddedCanvas.height - sizeY) / 2;
-        paddedContext.drawImage(faviconImage, logoX, logoY, sizeX, sizeY);
-    }
-
-    // Replace the canvas with the padded one
-    const paddedImage = paddedCanvas.toDataURL("image/png");
-    const img = document.createElement("img");
-    img.src = paddedImage;
-    img.style.width = "100%";
-    img.style.height = "auto";
-
-    return img;
-}

package/src/engine/engine_utils_attributes.ts

@@ -0,0 +1,72 @@
+
+
+/**
+ * @internal
+ */
+export namespace InternalAttributeUtils {
+
+    /**
+     * Checks if the given value is considered "falsey" in the context of HTML attributes.
+     * A value is considered falsey if it is "0" or "false" (case-insensitive).
+     *
+     * @param value - The attribute value to check.
+     * @returns True if the value is falsey, otherwise false.
+     */
+    export function isFalsey(value: string | null): boolean {
+        return value === "0" || value?.toLowerCase() === "false";
+    }
+
+    /**
+     * Retrieves the value of the specified attribute from the given element.
+     * If the attribute value is considered falsey, it returns null.
+     * @returns The attribute value or null if falsey.
+     */
+    export function getAttributeValueIfNotFalsey(element: Element, attributeName: string, opts?: { onAttribute: (value: string) => void }): string | null {
+        const attrValue = element.getAttribute(attributeName);
+        if (isFalsey(attrValue)) {
+            return null;
+        }
+        opts?.onAttribute?.call(null, attrValue!);
+        return attrValue;
+    }
+
+    /**
+     * Retrieves the value of the specified attribute from the given element.
+     * If the attribute value is considered falsey, it returns false.
+     * If the attribute is not set at all, it returns null.
+     * @returns The attribute value, false if falsey, or null if not set.
+     * 
+     * @example
+     * ```typescript
+     * const result = HTMLAttributeUtils.getAttributeAndCheckFalsey(element, 'data-example', {
+     *     onAttribute: (value, falsey) => {
+     *         console.log(`Attribute value: ${value}
+     * , Is falsey: ${falsey}`);
+     *     }
+     * });
+     * 
+     * if (result === false) {
+     *     console.log('The attribute is set to a falsey value.');
+     * } else if (result === null) {
+     *     console.log('The attribute is not set.');
+     * } else {
+     *     console.log(`The attribute value is: ${result}`);
+     * }
+     * ```
+     */
+    export function getAttributeAndCheckFalsey(element: Element, attributeName: string, opts?: { onAttribute: (value: string, falsey:boolean) => void }): false | string | null {
+        const attrValue = element.getAttribute(attributeName);
+        // If the attribute is not set at all we just return
+        if(attrValue === null) {
+            return null;
+        }
+        if (isFalsey(attrValue)) {
+            opts?.onAttribute?.call(null, attrValue!, true);
+            return false;
+        }
+        opts?.onAttribute?.call(null, attrValue!, false);
+        return attrValue;
+    }
+
+}
+