@mcp-b/wc-support 0.2.0

package/dist/utilities/drag.js

@@ -0,0 +1,106 @@
+const supportsTouch = typeof window !== "undefined" && "ontouchstart" in window;
+/**
+ * Attaches the necessary events to make an element draggable.
+ *
+ * This by itself will not make the element draggable, but it provides the events and callbacks necessary to facilitate
+ * dragging. Use the `clientX` and `clientY` arguments of each callback to update the UI as desired when dragging.
+ *
+ * Drag functionality will be enabled as soon as the constructor is called. A `start()` and `stop()` method can be used
+ * to start and stop it, if needed.
+ *
+ * Note: to prevent undesired scrolling while dragging on touch devices, use `touch-action: none` in the component's
+ * styles instead of preventing the `pointerdown` event.
+ *
+ * @usage
+ *
+ * const draggable = new DraggableElement(element, {
+ *   start: (clientX, clientY) => { ... },
+ *   move: (clientX, clientY) => { ... },
+ *   stop: (clientX, clientY) => { ... }
+ * });
+ */
+export class DraggableElement {
+    constructor(el, options) {
+        this.isActive = false;
+        this.isDragging = false;
+        this.handleDragStart = (event) => {
+            const clientX = "touches" in event ? event.touches[0].clientX : event.clientX;
+            const clientY = "touches" in event ? event.touches[0].clientY : event.clientY;
+            if (this.isDragging ||
+                // Prevent right-clicks from triggering drags
+                (!supportsTouch && event.buttons > 1)) {
+                return;
+            }
+            this.isDragging = true;
+            // Capture pointer to prevent iframes from stealing events during drag
+            if ("pointerId" in event) {
+                event.target.setPointerCapture(event.pointerId);
+            }
+            document.addEventListener("pointerup", this.handleDragStop);
+            document.addEventListener("pointermove", this.handleDragMove);
+            document.addEventListener("touchend", this.handleDragStop);
+            document.addEventListener("touchmove", this.handleDragMove);
+            this.options.start(clientX, clientY);
+        };
+        this.handleDragStop = (event) => {
+            // touchend has an empty `touches` list — use changedTouches instead
+            const clientX = "changedTouches" in event ? event.changedTouches[0].clientX : event.clientX;
+            const clientY = "changedTouches" in event ? event.changedTouches[0].clientY : event.clientY;
+            this.isDragging = false;
+            document.removeEventListener("pointerup", this.handleDragStop);
+            document.removeEventListener("pointermove", this.handleDragMove);
+            document.removeEventListener("touchend", this.handleDragStop);
+            document.removeEventListener("touchmove", this.handleDragMove);
+            this.options.stop(clientX, clientY);
+        };
+        this.handleDragMove = (event) => {
+            const clientX = "touches" in event ? event.touches[0].clientX : event.clientX;
+            const clientY = "touches" in event ? event.touches[0].clientY : event.clientY;
+            // Prevent text selection while dragging
+            window.getSelection()?.removeAllRanges();
+            this.options.move(clientX, clientY);
+        };
+        this.element = el;
+        this.options = {
+            start: () => undefined,
+            stop: () => undefined,
+            move: () => undefined,
+            ...options,
+        };
+        this.start();
+    }
+    /** Start listening to drags. */
+    start() {
+        if (!this.isActive) {
+            this.element.addEventListener("pointerdown", this.handleDragStart);
+            if (supportsTouch) {
+                this.element.addEventListener("touchstart", this.handleDragStart);
+            }
+            this.isActive = true;
+        }
+    }
+    /** Stop listening to drags. */
+    stop() {
+        document.removeEventListener("pointerup", this.handleDragStop);
+        document.removeEventListener("pointermove", this.handleDragMove);
+        document.removeEventListener("touchend", this.handleDragStop);
+        document.removeEventListener("touchmove", this.handleDragMove);
+        this.element.removeEventListener("pointerdown", this.handleDragStart);
+        if (supportsTouch) {
+            this.element.removeEventListener("touchstart", this.handleDragStart);
+        }
+        this.isActive = false;
+        this.isDragging = false;
+    }
+    /** Starts or stops the drag listeners. */
+    toggle(isActive) {
+        const isGoingToBeActive = isActive !== undefined ? isActive : !this.isActive;
+        if (isGoingToBeActive) {
+            this.start();
+        }
+        else {
+            this.stop();
+        }
+    }
+}
+//# sourceMappingURL=drag.js.map

package/dist/utilities/drag.js.map

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

package/dist/utilities/html.d.ts

@@ -0,0 +1,5 @@
+/** Returns the "inner HTML" of a slot element. */
+export declare function getSlotHtml(slot: HTMLSlotElement): string;
+/** Returns the "text content" of a slot element. */
+export declare function getSlotText(slot: HTMLSlotElement | undefined | null): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/utilities/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/utilities/html.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAezD;AAoBD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAO5E"}

package/dist/utilities/html.js

@@ -0,0 +1,41 @@
+/** Returns the "inner HTML" of a slot element. */
+export function getSlotHtml(slot) {
+    const nodes = slot.assignedNodes({ flatten: true });
+    let innerHtml = "";
+    [...nodes].forEach((node) => {
+        if (node.nodeType === Node.ELEMENT_NODE) {
+            innerHtml += node.outerHTML;
+        }
+        if (node.nodeType === Node.TEXT_NODE) {
+            innerHtml += node.textContent;
+        }
+    });
+    return innerHtml;
+}
+function extractText(nodesArray) {
+    let text = "";
+    nodesArray.forEach((node) => {
+        if (node.nodeType === Node.TEXT_NODE) {
+            // If it's a text node, add its content
+            text += node.textContent || "";
+        }
+        else if (node.nodeType === Node.ELEMENT_NODE && node.hasChildNodes()) {
+            // If it's an element node, check for child text nodes
+            text += extractText(Array.from(node.childNodes));
+        }
+        else if (node.nodeType === Node.ELEMENT_NODE) {
+            // For elements without children, get their textContent
+            text += node.textContent || "";
+        }
+    });
+    return text;
+}
+/** Returns the "text content" of a slot element. */
+export function getSlotText(slot) {
+    if (!slot) {
+        return "";
+    }
+    const nodes = slot.assignedNodes({ flatten: true });
+    return extractText(nodes).trim();
+}
+//# sourceMappingURL=html.js.map

package/dist/utilities/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/utilities/html.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,IAAqB;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,SAAS,IAAK,IAAoB,CAAC,SAAS,CAAC;QAC/C,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB;IACrC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,uCAAuC;YACvC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QACjC,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY,IAAK,IAAoB,CAAC,aAAa,EAAE,EAAE,CAAC;YACxF,sDAAsD;YACtD,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,uDAAuD;YACvD,IAAI,IAAK,IAAoB,CAAC,WAAW,IAAI,EAAE,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,IAAwC;IAClE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/utilities/icon-library.d.ts

@@ -0,0 +1,28 @@
+export type ResolveFunction = (name: string, family: string) => string;
+export type MutateFunction = (svg: SVGElement) => void;
+export interface Library {
+    resolve: ResolveFunction;
+    mutate?: MutateFunction;
+}
+/** Any element that can be tracked by the icon library system. */
+export interface IconElement extends HTMLElement {
+    load(): Promise<void>;
+}
+/** Registers a new icon library. */
+export declare function registerIconLibrary(name: string, library: Library): void;
+/** Removes a previously registered icon library. */
+export declare function unregisterIconLibrary(name: string): void;
+/** Gets a registered icon library. */
+export declare function getLibrary(name: string): Library | undefined;
+/** Call this when an icon is connected to make it reactive to changes to icon libraries. */
+export declare function connectIcon(el: IconElement): void;
+/** Call this when an icon is disconnected and no longer needs to be reactive. */
+export declare function disconnectIcon(el: IconElement): void;
+/** Gets an array of all icons that are currently connected. */
+export declare function getObservedIcons(): IconElement[];
+/**
+ * Updates all connected icons from the specified library. Call this after registering, unregistering, or making changes
+ * to an icon library to make sure icons refresh.
+ */
+export declare function updateConnectedIcons(): Promise<void[]>;
+//# sourceMappingURL=icon-library.d.ts.map

package/dist/utilities/icon-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-library.d.ts","sourceRoot":"","sources":["../../src/utilities/icon-library.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;AAEvD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAKD,oCAAoC;AACpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,QAGjE;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,QAGjD;AAED,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,uBAEtC;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,QAE1C;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,QAE7C;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,kBAE/B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,oBAEzC"}

package/dist/utilities/icon-library.js

@@ -0,0 +1,36 @@
+const libraries = new Map();
+const connectedIcons = new Set();
+/** Registers a new icon library. */
+export function registerIconLibrary(name, library) {
+    libraries.set(name, library);
+    updateConnectedIcons();
+}
+/** Removes a previously registered icon library. */
+export function unregisterIconLibrary(name) {
+    libraries.delete(name);
+    updateConnectedIcons();
+}
+/** Gets a registered icon library. */
+export function getLibrary(name) {
+    return libraries.get(name);
+}
+/** Call this when an icon is connected to make it reactive to changes to icon libraries. */
+export function connectIcon(el) {
+    connectedIcons.add(el);
+}
+/** Call this when an icon is disconnected and no longer needs to be reactive. */
+export function disconnectIcon(el) {
+    connectedIcons.delete(el);
+}
+/** Gets an array of all icons that are currently connected. */
+export function getObservedIcons() {
+    return [...connectedIcons];
+}
+/**
+ * Updates all connected icons from the specified library. Call this after registering, unregistering, or making changes
+ * to an icon library to make sure icons refresh.
+ */
+export async function updateConnectedIcons() {
+    return Promise.all([...connectedIcons].map((icon) => icon.load()));
+}
+//# sourceMappingURL=icon-library.js.map

package/dist/utilities/icon-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-library.js","sourceRoot":"","sources":["../../src/utilities/icon-library.ts"],"names":[],"mappings":"AAaA,MAAM,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;AAC7C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAe,CAAC;AAE9C,oCAAoC;AACpC,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAgB;IAChE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,oBAAoB,EAAE,CAAC;AACzB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,oBAAoB,EAAE,CAAC;AACzB,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,EAAe;IACzC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,EAAe;IAC5C,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/utilities/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./active-element.js";
+export * from "./localize.js";
+export * from "./animate.js";
+export * from "./defined.js";
+export * from "./drag.js";
+export * from "./html.js";
+export * from "./icon-library.js";
+export * from "./library.js";
+export * from "./loader.js";
+export * from "./long-press.js";
+export * from "./math.js";
+export * from "./parse.js";
+export * from "./platform.js";
+export * from "./scroll.js";
+export * from "./search.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/utilities/index.js

@@ -0,0 +1,16 @@
+export * from "./active-element.js";
+export * from "./localize.js";
+export * from "./animate.js";
+export * from "./defined.js";
+export * from "./drag.js";
+export * from "./html.js";
+export * from "./icon-library.js";
+export * from "./library.js";
+export * from "./loader.js";
+export * from "./long-press.js";
+export * from "./math.js";
+export * from "./parse.js";
+export * from "./platform.js";
+export * from "./scroll.js";
+export * from "./search.js";
+//# sourceMappingURL=index.js.map

package/dist/utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/utilities/library.d.ts

@@ -0,0 +1,19 @@
+/** Sets the library's asset path to the specified directory or URL. */
+export declare function setLibraryPath(path: string): void;
+/**
+ * Gets the library's assets path.
+ *
+ * The asset path is used to load assets such as icons and images. By default, Sigvelo will look for a script ending in
+ * "sigvelo.js" and guess the asset path relative to the script's location. This "just works" for most users but, if
+ * you're bundling the library, you'll need to copy the `assets` folder into your app and point this to that location.
+ *
+ * The easiest way is to provide a `data-sigvelo` attribute on any element in the DOM.
+ *
+ * @example
+ *
+ *  <html data-sigvelo="/path/to/assets">
+ *
+ * @param subpath - An optional path to append to the base path.
+ */
+export declare function getLibraryPath(subpath?: string): string;
+//# sourceMappingURL=library.d.ts.map

package/dist/utilities/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/utilities/library.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,QAE1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,SAAK,UA4B1C"}

package/dist/utilities/library.js

@@ -0,0 +1,45 @@
+let libraryPath = "";
+/** Sets the library's asset path to the specified directory or URL. */
+export function setLibraryPath(path) {
+    libraryPath = path;
+}
+/**
+ * Gets the library's assets path.
+ *
+ * The asset path is used to load assets such as icons and images. By default, Sigvelo will look for a script ending in
+ * "sigvelo.js" and guess the asset path relative to the script's location. This "just works" for most users but, if
+ * you're bundling the library, you'll need to copy the `assets` folder into your app and point this to that location.
+ *
+ * The easiest way is to provide a `data-sigvelo` attribute on any element in the DOM.
+ *
+ * @example
+ *
+ *  <html data-sigvelo="/path/to/assets">
+ *
+ * @param subpath - An optional path to append to the base path.
+ */
+export function getLibraryPath(subpath = "") {
+    if (!libraryPath) {
+        const sigveloEl = document.querySelector("[data-sigvelo]");
+        if (sigveloEl?.hasAttribute("data-sigvelo")) {
+            // Use data-sigvelo to get the root-relative URL
+            const rootRelativeUrl = new URL(sigveloEl.getAttribute("data-sigvelo") ?? "", window.location.href).pathname;
+            setLibraryPath(rootRelativeUrl);
+        }
+        else {
+            // Use the path to sigvelo.js or sigvelo.loader.js
+            const scripts = [...document.getElementsByTagName("script")];
+            const sigveloScript = scripts.find((script) => {
+                const src = script.src.split("?")[0];
+                return src.endsWith("sigvelo.js") || src.endsWith("sigvelo.loader.js");
+            });
+            if (sigveloScript) {
+                const path = String(sigveloScript.getAttribute("src"));
+                setLibraryPath(path.split("/").slice(0, -1).join("/"));
+            }
+        }
+    }
+    // Return the asset path without a trailing slash and append the subpath
+    return libraryPath.replace(/\/$/, "") + (subpath ? `/${subpath.replace(/^\//, "")}` : ``);
+}
+//# sourceMappingURL=library.js.map

package/dist/utilities/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../src/utilities/library.ts"],"names":[],"mappings":"AAAA,IAAI,WAAW,GAAG,EAAE,CAAC;AAErB,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO,GAAG,EAAE;IACzC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAE3D,IAAI,SAAS,EAAE,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5C,gDAAgD;YAChD,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,SAAS,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,EAAE,EAC5C,MAAM,CAAC,QAAQ,CAAC,IAAI,CACrB,CAAC,QAAQ,CAAC;YACX,cAAc,CAAC,eAAe,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,kDAAkD;YAClD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAwB,CAAC;YACpF,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;YAEH,IAAI,aAAa,EAAE,CAAC;gBAClB,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;gBACvD,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/utilities/loader.d.ts

@@ -0,0 +1,36 @@
+export type ComponentModuleMap = Record<string, () => Promise<unknown>>;
+export interface LoaderOptions {
+    /** A map of component names (without prefix) to lazy import functions. */
+    modules?: ComponentModuleMap;
+}
+/**
+ * Starts the autoloader and registers new Sigvelo elements as they appear in the DOM.
+ *
+ * When `modules` is provided, the loader uses it to resolve components (Vite-friendly).
+ * Otherwise, it falls back to constructing file paths via `getLibraryPath`.
+ */
+export declare function startLoader(options?: LoaderOptions): void;
+/**
+ * Stops the autoloader. Elements that have already been loaded will remain loaded.
+ */
+export declare function stopLoader(): void;
+/**
+ * Checks a node for undefined elements and attempts to register them.
+ */
+export declare function discoverElements(root: Element | ShadowRoot): Promise<void>;
+/**
+ * Many multi-page applications (MPAs) use Hotwire: Turbo to provide a SPA-like experience for users. When visiting
+ * links, Turbo intercepts the click, fetches the new page, and updates metadata and content without redirecting,
+ * resulting in a buttery smooth transition when going from one page to another.
+ *
+ * However, when you use Turbo with Sigvelo's autoloader, you may see FOUCE when visiting new pages for the first time.
+ * This is because Turbo renders the new page and _then_ the autoloader fetches unregistered components.
+ *
+ * To solve that, this function adds a listener that hooks into Turbo's `turbo:before-render` event and registers all
+ * components before the new page is rendered, effectively eliminating FOUCE for page-to-page navigation.
+ *
+ * The function comes with a configurable timeout to prevent issues with errors or slow networks. For most use cases,
+ * the default value of 2000ms is optimal.
+ */
+export declare function preventTurboFouce(timeout?: number): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/utilities/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/utilities/loader.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AA6CxE,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,QAUlD;AAED;;GAEG;AACH,wBAAgB,UAAU,SAEzB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,iBAsDhE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,SAAO,QAgB/C"}

package/dist/utilities/loader.js

@@ -0,0 +1,139 @@
+import { isDesignSystemTag, stripElementPrefix } from "../prefix.js";
+import { getLibraryPath } from "./library.js";
+let moduleMap;
+const observer = new MutationObserver((mutations) => {
+    for (const { addedNodes } of mutations) {
+        for (const node of addedNodes) {
+            if (node.nodeType === Node.ELEMENT_NODE) {
+                discoverElements(node);
+            }
+        }
+    }
+});
+/**
+ * Registers an element by tag name.
+ */
+function register(tagName) {
+    // If the element is already defined, there's nothing more to do
+    if (customElements.get(tagName)) {
+        return Promise.resolve();
+    }
+    const tagWithoutPrefix = stripElementPrefix(tagName);
+    // Use the module map if provided, otherwise fall back to path-based dynamic import
+    if (moduleMap) {
+        const loader = moduleMap[tagWithoutPrefix];
+        if (loader) {
+            return loader().then(() => { });
+        }
+        return Promise.reject(new Error(`Unknown component <${tagName}>`));
+    }
+    const path = getLibraryPath(`components/${tagWithoutPrefix}/${tagWithoutPrefix}.js`);
+    return new Promise((resolve, reject) => {
+        import(/* @vite-ignore */ path)
+            .then(() => resolve())
+            .catch(() => {
+            reject(new Error(`Failed to load <${tagName}> from "${path}"`));
+        });
+    });
+}
+/**
+ * Starts the autoloader and registers new Sigvelo elements as they appear in the DOM.
+ *
+ * When `modules` is provided, the loader uses it to resolve components (Vite-friendly).
+ * Otherwise, it falls back to constructing file paths via `getLibraryPath`.
+ */
+export function startLoader(options) {
+    if (options?.modules) {
+        moduleMap = options.modules;
+    }
+    // Initial discovery
+    discoverElements(document.body);
+    // Listen for new undefined elements
+    observer.observe(document.documentElement, { subtree: true, childList: true });
+}
+/**
+ * Stops the autoloader. Elements that have already been loaded will remain loaded.
+ */
+export function stopLoader() {
+    observer.disconnect();
+}
+/**
+ * Checks a node for undefined elements and attempts to register them.
+ */
+export async function discoverElements(root) {
+    const rootTagName = root instanceof Element ? root.tagName.toLowerCase() : "";
+    const rootIsSigveloElement = isDesignSystemTag(rootTagName);
+    // Get a list of elements to preload from all `data-sigvelo-preload` attributes on the page
+    const tagsToPreload = [...document.querySelectorAll("[data-sigvelo-preload]")]
+        .map((el) => el.getAttribute("data-sigvelo-preload") || "")
+        .flatMap((attr) => attr.split(" "))
+        .filter((tag) => tag.length > 0);
+    const tagsOnPage = [...root.querySelectorAll(":not(:defined)")]
+        .map((el) => el.tagName.toLowerCase())
+        .filter((tag) => isDesignSystemTag(tag));
+    // If the root element is an undefined Sigvelo element, add it to the list
+    if (rootIsSigveloElement && !customElements.get(rootTagName)) {
+        tagsOnPage.push(rootTagName);
+    }
+    // Get a unique list of all tags to register
+    const tagsToRegister = [...new Set(tagsOnPage.concat(tagsToPreload))];
+    const registered = [];
+    const unknown = [];
+    if (tagsToRegister.length === 0) {
+        return;
+    }
+    // Registration is sequential on purpose; the inner await is what orders it,
+    // so a plain for-of is correct here (the array is not async iterable).
+    for (const tagName of tagsToRegister) {
+        try {
+            await register(tagName);
+            registered.push(tagName);
+        }
+        catch {
+            unknown.push(tagName);
+        }
+    }
+    // Wait a cycle for initial component updates to complete
+    await new Promise(requestAnimationFrame);
+    //
+    // Emit the 'sigvelo-discovery-complete' event for this batch of elements. The detail payload will include an object
+    // with an array of elements that were registered and an array of unknown elements (i.e. not found).
+    //
+    root.dispatchEvent(new CustomEvent("sigvelo-discovery-complete", {
+        bubbles: false,
+        cancelable: false,
+        composed: true,
+        detail: { registered, unknown },
+    }));
+}
+/**
+ * Many multi-page applications (MPAs) use Hotwire: Turbo to provide a SPA-like experience for users. When visiting
+ * links, Turbo intercepts the click, fetches the new page, and updates metadata and content without redirecting,
+ * resulting in a buttery smooth transition when going from one page to another.
+ *
+ * However, when you use Turbo with Sigvelo's autoloader, you may see FOUCE when visiting new pages for the first time.
+ * This is because Turbo renders the new page and _then_ the autoloader fetches unregistered components.
+ *
+ * To solve that, this function adds a listener that hooks into Turbo's `turbo:before-render` event and registers all
+ * components before the new page is rendered, effectively eliminating FOUCE for page-to-page navigation.
+ *
+ * The function comes with a configurable timeout to prevent issues with errors or slow networks. For most use cases,
+ * the default value of 2000ms is optimal.
+ */
+export function preventTurboFouce(timeout = 2000) {
+    document.addEventListener("turbo:before-render", async (event) => {
+        const newBody = event.detail.newBody;
+        event.preventDefault();
+        try {
+            // Wait until all elements are registered or two seconds, whichever comes first
+            await Promise.race([
+                discoverElements(newBody),
+                new Promise((resolve) => setTimeout(resolve, timeout)),
+            ]);
+        }
+        finally {
+            event.detail.resume();
+        }
+    });
+}
+//# sourceMappingURL=loader.js.map

package/dist/utilities/loader.js.map

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

package/dist/utilities/localize.d.ts

@@ -0,0 +1,62 @@
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+/** Extracts parameter types from a translation value that is a function. */
+type FunctionParams<T> = T extends (...args: infer P) => string ? P : [];
+/** Minimum shape every translation must satisfy. */
+export interface BaseTranslation {
+    /** BCP 47 language code, e.g. `en`, `en-GB`. */
+    $code: string;
+    /** Human-readable language name, e.g. `English`, `Espanol`. */
+    $name: string;
+    /** Text directionality. */
+    $dir: "ltr" | "rtl";
+}
+/** Registers the fallback translation used when no better match is found. */
+export declare function registerDefaultTranslation(translation: BaseTranslation): void;
+/**
+ * Registers one or more translations. If a translation with the same language
+ * code already exists, the new keys are merged into it.
+ */
+export declare function registerTranslation(...items: BaseTranslation[]): void;
+/** Re-reads `<html>` attributes and requests an update on every connected element. */
+export declare function update(): void;
+/**
+ * Reactive Controller that localizes terms, dates, numbers, and currency for
+ * Lit-based custom elements.
+ *
+ * Instantiate in a component constructor:
+ * ```ts
+ * private localize = new LocalizeController(this)
+ * ```
+ *
+ * The controller automatically re-renders its host when `<html dir>` or
+ * `<html lang>` change. To also react to per-element overrides, declare
+ * `dir` / `lang` as reactive properties on the host.
+ */
+export declare class LocalizeController<T extends BaseTranslation = BaseTranslation> implements ReactiveController {
+    private host;
+    constructor(host: ReactiveControllerHost & HTMLElement);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /** Returns the host's resolved text direction (`ltr` or `rtl`). */
+    dir(): string;
+    /** Returns the host's resolved BCP 47 language tag. */
+    lang(): string;
+    /** Checks whether a translation key exists for the given (or current) language. */
+    exists<K extends keyof T>(key: K, options?: {
+        lang?: string;
+        includeDefault?: boolean;
+    }): boolean;
+    /**
+     * Returns a translated string for the given key. If the value is a function,
+     * it is called with the supplied arguments.
+     */
+    term<K extends keyof T>(key: K, ...args: FunctionParams<T[K]>): string;
+    /** Formats a date using `Intl.DateTimeFormat` in the host's locale. */
+    date(value: Date | string, options?: Intl.DateTimeFormatOptions): string;
+    /** Formats a number using `Intl.NumberFormat` in the host's locale. */
+    number(value: number | string, options?: Intl.NumberFormatOptions): string;
+    /** Formats a relative time value (e.g. "3 days ago") in the host's locale. */
+    relativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;
+}
+export {};
+//# sourceMappingURL=localize.d.ts.map

package/dist/utilities/localize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize.d.ts","sourceRoot":"","sources":["../../src/utilities/localize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AAGtE,4EAA4E;AAC5E,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;AAEzE,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB;AAoBD,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,eAAe,QAGtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,KAAK,EAAE,eAAe,EAAE,QAM9D;AAED,sFAAsF;AACtF,wBAAgB,MAAM,SASrB;AAiBD;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAkB,CAC7B,CAAC,SAAS,eAAe,GAAG,eAAe,CAC3C,YAAW,kBAAkB;IAC7B,OAAO,CAAC,IAAI,CAAuC;gBAEvC,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAKtD,aAAa;IAGb,gBAAgB;IAIhB,mEAAmE;IACnE,GAAG;IAIH,uDAAuD;IACvD,IAAI;IAIJ,mFAAmF;IACnF,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,EACtB,GAAG,EAAE,CAAC,EACN,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO,GACxD,OAAO;IAOV;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM;IAatE,uEAAuE;IACvE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM;IAIxE,uEAAuE;IACvE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM;IAK1E,8EAA8E;IAC9E,YAAY,CACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,sBAAsB,EACjC,OAAO,CAAC,EAAE,IAAI,CAAC,yBAAyB,GACvC,MAAM;CAGV"}