@lightningtv/solid 3.0.0-2 → 3.0.0-21

package/dist/src/primitives/useMouse.js

@@ -1,8 +1,17 @@
-import { ElementNode, activeElement, isElementNode, isTextNode, rootNode, Config, } from '@lightningtv/solid';
+import { Config, ElementNode, activeElement, isElementNode, isFunc, isTextNode, rootNode, } from '../index.js';
 import { makeEventListener } from '@solid-primitives/event-listener';
 import { useMousePosition } from '@solid-primitives/mouse';
 import { createScheduled, throttle } from '@solid-primitives/scheduled';
-import { createEffect } from 'solid-js';
+import { createEffect, getOwner, runWithOwner } from 'solid-js';
+export function addCustomStateToElement(element, state) {
+    element.states?.add(state);
+}
+export function removeCustomStateFromElement(element, state) {
+    element?.states?.remove(state);
+}
+export function hasCustomState(element, state) {
+    return element.states?.has(state);
+}
 function createKeyboardEvent(key, keyCode, eventName = 'keydown') {
     return new KeyboardEvent(eventName, {
         key,
@@ -15,6 +24,7 @@ function createKeyboardEvent(key, keyCode, eventName = 'keydown') {
         bubbles: true,
     });
 }
+let scrollTimeout;
 const handleScroll = throttle((e) => {
     const deltaY = e.deltaY;
     if (deltaY < 0) {
@@ -23,19 +33,126 @@ const handleScroll = throttle((e) => {
     else if (deltaY > 0) {
         document.body.dispatchEvent(createKeyboardEvent('ArrowDown', 40));
     }
+    // clear the last timeout if the user is still scrolling
+    clearTimeout(scrollTimeout);
+    // after 250ms of no scroll events, we send a keyup event to stop the scrolling
+    scrollTimeout = setTimeout(() => {
+        document.body.dispatchEvent(createKeyboardEvent('ArrowUp', 38, 'keyup'));
+        document.body.dispatchEvent(createKeyboardEvent('ArrowDown', 40, 'keyup'));
+    }, 250);
 }, 250);
-const handleClick = (e) => {
+function findElementWithCustomState(myApp, x, y, customState) {
+    const result = getChildrenByPosition(myApp, x, y).filter((el) => hasCustomState(el, customState));
+    if (result.length === 0) {
+        return undefined;
+    }
+    let element = result[result.length - 1];
+    while (element) {
+        const elmParent = element.parent;
+        if (elmParent?.forwardStates && hasCustomState(elmParent, customState)) {
+            element = elmParent;
+        }
+        else {
+            break;
+        }
+    }
+    return element;
+}
+function findElementByActiveElement(e) {
     const active = activeElement();
     const precision = Config.rendererOptions?.deviceLogicalPixelRatio || 1;
     if (active instanceof ElementNode &&
-        testCollision(e.clientX, e.clientY, active.lng.absX || 0 * precision, active.lng.absY || 0 * precision, active.width || 0 * precision, active.height || 0 * precision)) {
+        testCollision(e.clientX, e.clientY, (active.lng.absX || 0) * precision, (active.lng.absY || 0) * precision, (active.width || 0) * precision, (active.height || 0) * precision)) {
+        return active;
+    }
+    let parent = active?.parent;
+    while (parent) {
+        if (isFunc(parent.onMouseClick) &&
+            active &&
+            testCollision(e.clientX, e.clientY, (parent.lng.absX || 0) * precision, (parent.lng.absY || 0) * precision, (parent.width || 0) * precision, (parent.height || 0) * precision)) {
+            return parent;
+        }
+        parent = parent.parent;
+    }
+    return null;
+}
+function applyPressedState(element, pressedState) {
+    addCustomStateToElement(element, pressedState);
+}
+function handleElementClick(clickedElement, e, customStates, pressedElementRef) {
+    if (customStates?.pressedState && pressedElementRef?.current) {
+        removeCustomStateFromElement(pressedElementRef.current, customStates.pressedState);
+        pressedElementRef.current = null;
+    }
+    if (isFunc(clickedElement.onMouseClick)) {
+        clickedElement.onMouseClick(e, clickedElement);
+        return;
+    }
+    else if (isFunc(clickedElement.onEnter)) {
+        clickedElement.onEnter();
+        return;
+    }
+    clickedElement.setFocus();
+    setTimeout(() => {
         document.dispatchEvent(createKeyboardEvent('Enter', 13));
         setTimeout(() => document.body.dispatchEvent(createKeyboardEvent('Enter', 13, 'keyup')), 1);
-    }
-};
+    }, 1);
+}
+function createHandleClick(myApp, customStates, pressedElementRef) {
+    return (e) => {
+        const clickedElement = customStates
+            ? findElementWithCustomState(myApp, e.clientX, e.clientY, customStates.hoverState)
+            : findElementByActiveElement(e);
+        if (!clickedElement) {
+            return;
+        }
+        handleElementClick(clickedElement, e, customStates, pressedElementRef);
+    };
+}
+function createHandleMouseDown(myApp, customStates, pressedElementRef) {
+    return (e) => {
+        if (!customStates) {
+            return;
+        }
+        const pressedElement = findElementWithCustomState(myApp, e.clientX, e.clientY, customStates.hoverState);
+        if (!pressedElement) {
+            return;
+        }
+        applyPressedState(pressedElement, customStates.pressedState);
+        if (pressedElementRef) {
+            pressedElementRef.current = pressedElement;
+        }
+    };
+}
 function testCollision(px, py, cx, cy, cw = 0, ch = 0) {
     return px >= cx && px <= cx + cw && py >= cy && py <= cy + ch;
 }
+function isNodeAtPosition(node, x, y, precision) {
+    if (!isElementNode(node)) {
+        return false;
+    }
+    return (node.alpha !== 0 &&
+        !node.skipFocus &&
+        testCollision(x, y, (node.lng.absX || 0) * precision, (node.lng.absY || 0) * precision, (node.width || 0) * precision, (node.height || 0) * precision));
+}
+function findHighestZIndexNode(nodes) {
+    if (nodes.length === 0) {
+        return undefined;
+    }
+    if (nodes.length === 1) {
+        return nodes[0];
+    }
+    let maxZIndex = -1;
+    let highestNode = undefined;
+    for (const node of nodes) {
+        const zIndex = node.zIndex ?? -1;
+        if (zIndex >= maxZIndex) {
+            maxZIndex = zIndex;
+            highestNode = node;
+        }
+    }
+    return highestNode;
+}
 function getChildrenByPosition(node, x, y) {
     const result = [];
     const precision = Config.rendererOptions?.deviceLogicalPixelRatio || 1;
@@ -43,72 +160,79 @@ function getChildrenByPosition(node, x, y) {
     let queue = [node];
     while (queue.length > 0) {
         // Process nodes at the current level
-        const currentLevelNodes = [];
-        for (const currentNode of queue) {
-            if (isElementNode(currentNode) &&
-                currentNode.alpha !== 0 &&
-                !currentNode.skipFocus &&
-                testCollision(x, y, currentNode.lng.absX || 0 * precision, currentNode.lng.absY || 0 * precision, (currentNode.width || 0) * precision, (currentNode.height || 0) * precision)) {
-                currentLevelNodes.push(currentNode);
-            }
-        }
-        const size = currentLevelNodes.length;
-        if (size === 0) {
+        const currentLevelNodes = queue.filter((currentNode) => isNodeAtPosition(currentNode, x, y, precision));
+        if (currentLevelNodes.length === 0) {
             break;
         }
-        let highestZIndexNode = null;
-        if (size === 1) {
-            highestZIndexNode = currentLevelNodes[0];
-        }
-        else {
-            let maxZIndex = -1;
-            for (const node of currentLevelNodes) {
-                const zIndex = node.zIndex ?? -1;
-                if (zIndex > maxZIndex) {
-                    maxZIndex = zIndex;
-                    highestZIndexNode = node;
-                }
-                else if (zIndex === maxZIndex) {
-                    highestZIndexNode = node;
-                }
-            }
-        }
-        if (highestZIndexNode && !isTextNode(highestZIndexNode)) {
-            result.push(highestZIndexNode);
-            queue = highestZIndexNode.children;
-        }
-        else {
-            queue = [];
+        const highestZIndexNode = findHighestZIndexNode(currentLevelNodes);
+        if (!highestZIndexNode || isTextNode(highestZIndexNode)) {
+            break;
         }
+        result.push(highestZIndexNode);
+        queue = highestZIndexNode.children;
     }
     return result;
 }
-export function useMouse(myApp = rootNode, throttleBy = 100) {
+export function useMouse(myApp = rootNode, throttleBy = 100, options) {
     const pos = useMousePosition();
     const scheduled = createScheduled((fn) => throttle(fn, throttleBy));
+    let previousElement = null;
+    const pressedElementRef = { current: null };
+    const customStates = options?.customStates;
+    const hoverState = customStates?.hoverState;
+    const handleClick = createHandleClick(myApp, customStates, pressedElementRef);
+    const handleMouseDown = createHandleMouseDown(myApp, customStates, pressedElementRef);
+    const owner = getOwner();
+    const handleClickContext = (e) => {
+        runWithOwner(owner, () => handleClick(e));
+    };
+    const handleMouseDownContext = (e) => {
+        runWithOwner(owner, () => handleMouseDown(e));
+    };
     makeEventListener(window, 'wheel', handleScroll);
-    makeEventListener(window, 'click', handleClick);
+    makeEventListener(window, 'click', handleClickContext);
+    makeEventListener(window, 'mousedown', handleMouseDownContext);
     createEffect(() => {
         if (scheduled()) {
-            const result = getChildrenByPosition(myApp, pos.x, pos.y).filter((el) => el.focus || el.onFocus || el.onEnter);
+            const result = getChildrenByPosition(myApp, pos.x, pos.y).filter((el) => !!(el.onEnter ||
+                el.onMouseClick ||
+                el.onFocus ||
+                el[Config.focusStateKey] ||
+                (hoverState ? el[hoverState] : false)));
             if (result.length) {
                 let activeElm = result[result.length - 1];
                 while (activeElm) {
                     const elmParent = activeElm.parent;
                     if (elmParent?.forwardStates) {
-                        activeElm = activeElm.parent;
+                        activeElm = elmParent;
                     }
                     else {
                         break;
                     }
                 }
+                if (!activeElm) {
+                    return;
+                }
                 // Update Row & Column Selected property
-                const activeElmParent = activeElm?.parent;
-                if (activeElm && activeElmParent?.selected !== undefined) {
+                const activeElmParent = activeElm.parent;
+                if (activeElmParent?.selected !== undefined) {
                     activeElmParent.selected =
                         activeElmParent.children.indexOf(activeElm);
                 }
-                activeElm?.setFocus();
+                if (previousElement && previousElement !== activeElm && hoverState) {
+                    removeCustomStateFromElement(previousElement, hoverState);
+                }
+                if (hoverState) {
+                    addCustomStateToElement(activeElm, hoverState);
+                }
+                else {
+                    activeElm.setFocus();
+                }
+                previousElement = activeElm;
+            }
+            else if (previousElement && hoverState) {
+                removeCustomStateFromElement(previousElement, hoverState);
+                previousElement = null;
             }
         }
     });

package/dist/src/primitives/useMouse.js.map

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

package/dist/src/primitives/utils/chainFunctions.d.ts

@@ -1,4 +1,30 @@
-type ChainableFunction = (...args: unknown[]) => unknown;
-export declare function chainFunctions(...args: ChainableFunction[]): ChainableFunction;
-export declare function chainFunctions<T>(...args: (ChainableFunction | T)[]): T;
-export {};
+import * as s from 'solid-js';
+export type AnyFunction = (this: any, ...args: any[]) => any;
+/**
+ * take an array of functions and if you return `true` from a function, it will stop the chain
+ * @param fns list of functions to chain together, can be `undefined`, `null`, or `false` to skip them
+ * @returns a function that will call each function in the list until one returns `true` or all functions are called.
+ * If no functions are provided, it will return `undefined`.
+ *
+ * @example
+ * ```tsx
+ * function Button (props: NodeProps) {
+ *   function onEnter (el: ElementNode) {...}
+ *   return <view onEnter={chainFunctions(props.onEnter, onEnter)} />
+ * }
+ * ```
+ */
+export declare function chainFunctions<T extends AnyFunction>(...fns: T[]): T;
+export declare function chainFunctions<T extends AnyFunction>(...fns: (T | undefined | null | false)[]): T | undefined;
+/**
+ * Utility for chaining multiple `ref` assignments with `props.ref` forwarding.
+ * @param refs list of ref setters. Can be a `props.ref` prop for ref forwarding or a setter to a local variable (`el => ref = el`).
+ * @example
+ * ```tsx
+ * function Button (props: NodeProps) {
+ *    let localRef: ElementNode | undefined
+ *    return <view ref={chainRefs(props.ref, el => localRef = el)} />
+ * }
+ * ```
+ */
+export declare const chainRefs: <T>(...refs: (s.Ref<T> | undefined)[]) => (el: T) => void;

package/dist/src/primitives/utils/chainFunctions.js

@@ -1,6 +1,5 @@
-// take an array of functions and if you return true from a function, it will stop the chain
-export function chainFunctions(...args) {
-    const onlyFunctions = args.filter((func) => typeof func === 'function');
+export function chainFunctions(...fns) {
+    const onlyFunctions = fns.filter((func) => typeof func === 'function');
     if (onlyFunctions.length === 0) {
         return undefined;
     }
@@ -18,4 +17,16 @@ export function chainFunctions(...args) {
         return result;
     };
 }
+/**
+ * Utility for chaining multiple `ref` assignments with `props.ref` forwarding.
+ * @param refs list of ref setters. Can be a `props.ref` prop for ref forwarding or a setter to a local variable (`el => ref = el`).
+ * @example
+ * ```tsx
+ * function Button (props: NodeProps) {
+ *    let localRef: ElementNode | undefined
+ *    return <view ref={chainRefs(props.ref, el => localRef = el)} />
+ * }
+ * ```
+ */
+export const chainRefs = chainFunctions;
 //# sourceMappingURL=chainFunctions.js.map

package/dist/src/primitives/utils/chainFunctions.js.map

@@ -1 +1 @@
-{"version":3,"file":"chainFunctions.js","sourceRoot":"","sources":["../../../../src/primitives/utils/chainFunctions.ts"],"names":[],"mappings":"AAKA,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAC5B,GAAG,IAA+B;IAElC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC;IACxE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,UAA6B,GAAG,SAAoB;QACzD,IAAI,MAAM,CAAC;QACX,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"chainFunctions.js","sourceRoot":"","sources":["../../../../src/primitives/utils/chainFunctions.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,cAAc,CAC5B,GAAG,GAA+C;IAElD,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC;IACvE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,UAAU,GAAG,SAAS;QAC3B,IAAI,MAAM,CAAC;QACX,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,cAEL,CAAC"}

package/dist/src/primitives/utils/createBlurredImage.d.ts

@@ -0,0 +1,56 @@
+import { type Accessor, type Resource } from 'solid-js';
+/**
+ * Represents a valid image source that can be used for blurring
+ */
+type ImageSource = string | URL;
+/**
+ * Represents a valid image source or null/undefined
+ */
+type NullableImageSource = ImageSource | null | undefined;
+/**
+ * Configuration options for Gaussian blur operation
+ */
+interface BlurOptions {
+    /**
+     * The blur radius in pixels
+     * @default 10
+     */
+    readonly radius?: number;
+    /**
+     * CORS setting for image loading
+     * @default 'anonymous'
+     */
+    readonly crossOrigin?: 'anonymous' | 'use-credentials' | '';
+    /**
+     * The resolution of the output image in pixels
+     * @default 1
+     */
+    readonly resolution?: number;
+}
+/**
+ * Type for the resource return value from createBlurredImage
+ */
+type BlurredImageResource<T extends NullableImageSource> = Resource<T extends null | undefined ? null : string>;
+/**
+ * Applies Gaussian blur to an image URL
+ * @param imageUrl - Image source (string or URL)
+ * @param options - Blur configuration options
+ * @returns Promise resolving to data URL of blurred image
+ * @throws {Error} If image fails to load or blur operation fails
+ */
+export declare function applyGaussianBlur<TSource extends ImageSource>(imageUrl: TSource, options?: Readonly<BlurOptions>): Promise<string>;
+/**
+ * Hook to create a blurred image resource
+ * @param imageUrl - Accessor function returning image source or null/undefined
+ * @param options - Blur configuration options
+ * @returns Resource containing blurred image data URL or null
+ * @template TSource - Type of image source (string, URL, or null/undefined)
+ *
+ * @example
+ * ```ts
+ * const imageUrl = () => 'https://example.com/image.jpg';
+ * const blurred = createBlurredImage(imageUrl, { radius: 15 });
+ * ```
+ */
+export declare function createBlurredImage<TSource extends NullableImageSource>(imageUrl: Accessor<TSource>, options?: Readonly<BlurOptions>): BlurredImageResource<TSource>;
+export {};

package/dist/src/primitives/utils/createBlurredImage.js

@@ -0,0 +1,223 @@
+import { createResource } from 'solid-js';
+/**
+ * Default blur options
+ */
+const DEFAULT_BLUR_OPTIONS = {
+    radius: 10,
+    crossOrigin: 'anonymous',
+    resolution: 1,
+};
+/**
+ * Validates that radius is a positive number
+ */
+function isValidRadius(radius) {
+    return radius > 0 && Number.isFinite(radius);
+}
+/**
+ * Ensures a resolution is a positive number
+ */
+function isValidResolution(resolution) {
+    return resolution > 0 && resolution <= 1 && Number.isFinite(resolution);
+}
+/**
+ * Applies vertical Gaussian blur to image data
+ * @param input - Input pixel data
+ * @param output - Output pixel data buffer
+ * @param width - Image width
+ * @param height - Image height
+ * @param kernel - Gaussian kernel weights
+ * @param half - Half of kernel size
+ */
+function applyVerticalBlur(input, output, width, height, kernel, half) {
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            let r = 0, g = 0, b = 0, a = 0;
+            let weightSum = 0;
+            for (let ky = -half; ky <= half; ky++) {
+                const py = y + ky;
+                if (py >= 0 && py < height) {
+                    const pixelIndex = (py * width + x) * 4;
+                    const weight = kernel[ky + half];
+                    r += input[pixelIndex] * weight;
+                    g += input[pixelIndex + 1] * weight;
+                    b += input[pixelIndex + 2] * weight;
+                    a += input[pixelIndex + 3] * weight;
+                    weightSum += weight;
+                }
+            }
+            const outputIndex = (y * width + x) * 4;
+            output[outputIndex] = r / weightSum;
+            output[outputIndex + 1] = g / weightSum;
+            output[outputIndex + 2] = b / weightSum;
+            output[outputIndex + 3] = a / weightSum;
+        }
+    }
+}
+/**
+ * Applies horizontal Gaussian blur to image data
+ * @param input - Input pixel data
+ * @param output - Output pixel data buffer
+ * @param width - Image width
+ * @param height - Image height
+ * @param kernel - Gaussian kernel weights
+ * @param half - Half of kernel size
+ */
+function applyHorizontalBlur(input, output, width, height, kernel, half) {
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            let r = 0, g = 0, b = 0, a = 0;
+            let weightSum = 0;
+            for (let kx = -half; kx <= half; kx++) {
+                const px = x + kx;
+                if (px >= 0 && px < width) {
+                    const pixelIndex = (y * width + px) * 4;
+                    const weight = kernel[kx + half];
+                    r += input[pixelIndex] * weight;
+                    g += input[pixelIndex + 1] * weight;
+                    b += input[pixelIndex + 2] * weight;
+                    a += input[pixelIndex + 3] * weight;
+                    weightSum += weight;
+                }
+            }
+            const outputIndex = (y * width + x) * 4;
+            output[outputIndex] = r / weightSum;
+            output[outputIndex + 1] = g / weightSum;
+            output[outputIndex + 2] = b / weightSum;
+            output[outputIndex + 3] = a / weightSum;
+        }
+    }
+}
+/**
+ * Generates a normalized Gaussian kernel
+ * @param size - Kernel size (must be odd)
+ * @param sigma - Standard deviation
+ * @returns Normalized Gaussian kernel
+ */
+function generateGaussianKernel(size, sigma) {
+    const kernel = [];
+    const half = Math.floor(size / 2);
+    let sum = 0;
+    for (let i = -half; i <= half; i++) {
+        const value = Math.exp(-(i * i) / (2 * sigma * sigma));
+        kernel.push(value);
+        sum += value;
+    }
+    return Object.freeze(kernel.map((value) => value / sum));
+}
+/**
+ * Applies Gaussian blur convolution to image data
+ * @param imageData - Source image data
+ * @param dimensions - Image dimensions
+ * @param radius - Blur radius
+ * @returns Blurred image data
+ */
+function gaussianBlurConvolution(imageData, dimensions, radius) {
+    const { data } = imageData;
+    const { width, height } = dimensions;
+    const output = new Uint8ClampedArray(data.length);
+    const kernelSize = Math.ceil(radius * 2) * 2 + 1;
+    const kernel = generateGaussianKernel(kernelSize, radius);
+    const half = Math.floor(kernelSize / 2);
+    applyHorizontalBlur(data, output, width, height, kernel, half);
+    const tempData = new Uint8ClampedArray(output);
+    applyVerticalBlur(tempData, output, width, height, kernel, half);
+    return new ImageData(output, width, height);
+}
+/**
+ * Applies Gaussian blur to an image URL
+ * @param imageUrl - Image source (string or URL)
+ * @param options - Blur configuration options
+ * @returns Promise resolving to data URL of blurred image
+ * @throws {Error} If image fails to load or blur operation fails
+ */
+export async function applyGaussianBlur(imageUrl, options) {
+    const opts = { ...DEFAULT_BLUR_OPTIONS, ...options };
+    const radius = opts.radius;
+    const resolution = opts.resolution;
+    if (!isValidRadius(radius)) {
+        throw new Error(`Invalid blur radius: ${radius}. Must be a positive number.`);
+    }
+    if (!isValidResolution(resolution)) {
+        throw new Error(`Invalid resolution: ${resolution}. Must be a number between 0 and 1.`);
+    }
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        img.crossOrigin = opts.crossOrigin;
+        img.onload = () => {
+            try {
+                const canvas = document.createElement('canvas');
+                const ctx = canvas.getContext('2d', {
+                    willReadFrequently: true,
+                });
+                if (ctx === null) {
+                    reject(new Error('Failed to get canvas context'));
+                    return;
+                }
+                const scaledWidth = Math.max(1, Math.round(img.width * resolution));
+                const scaledHeight = Math.max(1, Math.round(img.height * resolution));
+                const dimensions = {
+                    width: scaledWidth,
+                    height: scaledHeight,
+                };
+                canvas.width = dimensions.width;
+                canvas.height = dimensions.height;
+                const hasFilterSupport = ctx.filter !== undefined;
+                if (hasFilterSupport) {
+                    ctx.filter = `blur(${radius}px)`;
+                    ctx.drawImage(img, 0, 0, scaledWidth, scaledHeight);
+                    ctx.filter = 'none';
+                }
+                else {
+                    ctx.drawImage(img, 0, 0, scaledWidth, scaledHeight);
+                    const imageData = ctx.getImageData(0, 0, dimensions.width, dimensions.height);
+                    const blurredData = gaussianBlurConvolution(imageData, dimensions, radius);
+                    ctx.putImageData(blurredData, 0, 0);
+                }
+                const dataUrl = canvas.toDataURL();
+                if (dataUrl) {
+                    resolve(dataUrl);
+                }
+                else {
+                    reject(new Error('Failed to create image data URL'));
+                }
+            }
+            catch (error) {
+                reject(error instanceof Error
+                    ? error
+                    : new Error('Unknown error during blur operation'));
+            }
+        };
+        img.onerror = () => {
+            reject(new Error('Failed to load image'));
+        };
+        const srcString = typeof imageUrl === 'string' ? imageUrl : imageUrl.toString();
+        img.src = srcString;
+    });
+}
+/**
+ * Hook to create a blurred image resource
+ * @param imageUrl - Accessor function returning image source or null/undefined
+ * @param options - Blur configuration options
+ * @returns Resource containing blurred image data URL or null
+ * @template TSource - Type of image source (string, URL, or null/undefined)
+ *
+ * @example
+ * ```ts
+ * const imageUrl = () => 'https://example.com/image.jpg';
+ * const blurred = createBlurredImage(imageUrl, { radius: 15 });
+ * ```
+ */
+export function createBlurredImage(imageUrl, options) {
+    const imageUrlString = () => {
+        const url = imageUrl();
+        if (url === null || url === undefined) {
+            return url;
+        }
+        return typeof url === 'string' ? url : url.toString();
+    };
+    const [blurredImage] = createResource(imageUrlString, async (url) => {
+        return await applyGaussianBlur(url, options);
+    });
+    return blurredImage;
+}
+//# sourceMappingURL=createBlurredImage.js.map