@lightningtv/solid 3.0.0-2 → 3.0.0-20

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

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

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

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

@@ -1,4 +1,4 @@
-import { type IRendererTexture } from '@lightningtv/core';
+import { type TextureMap } from '@lightningtv/core';
 export interface SpriteDef {
     name: string | number;
     x: number;
@@ -6,4 +6,4 @@ export interface SpriteDef {
     width: number;
     height: number;
 }
-export declare function createSpriteMap(src: string, subTextures: SpriteDef[]): Record<string, IRendererTexture>;
+export declare function createSpriteMap(src: string, subTextures: SpriteDef[]): Record<string, InstanceType<TextureMap['SubTexture']>>;

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

@@ -1 +1 @@
-{"version":3,"file":"createSpriteMap.js","sourceRoot":"","sources":["../../../../src/primitives/utils/createSpriteMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAUpE,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,WAAwB;IAExB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE;QAC9D,GAAG;KACJ,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC,MAAM,CAAmC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACrE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAClC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,YAAY,EAAE;YACjD,OAAO,EAAE,gBAAgB;YACzB,CAAC;YACD,CAAC;YACD,KAAK;YACL,MAAM;SACP,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}
+{"version":3,"file":"createSpriteMap.js","sourceRoot":"","sources":["../../../../src/primitives/utils/createSpriteMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAU9D,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,WAAwB;IAExB,MAAM,gBAAgB,GAAG,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE;QAC9D,GAAG;KACJ,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC,MAAM,CAEvB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACX,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAClC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,YAAY,EAAE;YACjD,OAAO,EAAE,gBAAgB;YACzB,CAAC;YACD,CAAC;YACD,KAAK;YACL,MAAM;SACP,CAA2C,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

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

@@ -1,5 +1,85 @@
-import { ElementNode } from '@lightningtv/core';
-import { type KeyHandler } from '@lightningtv/core/focusManager';
-import type { OnSelectedChanged } from '../types.js';
-export declare function onGridFocus(onSelectedChanged: OnSelectedChanged | undefined): (this: ElementNode) => boolean;
-export declare function handleNavigation(direction: 'up' | 'right' | 'down' | 'left'): KeyHandler;
+import * as lng from '@lightningtv/solid';
+import * as lngp from '@lightningtv/solid/primitives';
+declare module '@lightningtv/core' {
+    interface ElementNode {
+        /** For children of {@link lngp.NavigableElement}, set to `true` to prevent being selected */
+        skipFocus?: boolean;
+    }
+}
+/** @deprecated Use {@link navigableForwardFocus} instead */
+export declare function onGridFocus(_?: lngp.OnSelectedChanged): lng.ForwardFocusHandler;
+/**
+ * Forwards focus to the first focusable child of a {@link lngp.NavigableElement} and
+ * selects it.
+ *
+ * @example
+ * ```tsx
+ * <view
+ *   selected={0}
+ *   forwardFocus={navigableForwardFocus}
+ *   onSelectedChanged={(idx, el, child, lastIdx) => {...}}
+ * >
+ * ```
+ */
+export declare const navigableForwardFocus: lng.ForwardFocusHandler;
+export declare function handleNavigation(direction: 'up' | 'right' | 'down' | 'left'): lng.KeyHandler;
+/**
+ * Handles navigation key events for navigable elements, \
+ * such as {@link lngp.Row} and {@link lngp.Column}.
+ *
+ * Uses {@link moveSelection} to select the next or previous child based on the key pressed.
+ *
+ * @example
+ * ```tsx
+ * <view
+ *   selected={0}
+ *   onUp={navigableHandleNavigation}
+ *   onDown={navigableHandleNavigation}
+ *   onSelectedChanged={(idx, el, child, lastIdx) => {...}}
+ * >
+ * ```
+ */
+export declare const navigableHandleNavigation: lng.KeyHandler;
+/**
+ * Moves the selection within a {@link lngp.NavigableElement}.
+ */
+export declare function moveSelection(el: lngp.NavigableElement, delta: number): boolean;
+/**
+ * Forwards focus to the closest or first focusable child of a {@link lngp.NavigableElement} and
+ * selects it.
+ *
+ * To determine the closest child, it uses the distance between the center of the previous focused element
+ * and the center of each child element.
+ *
+ * @example
+ * ```tsx
+ * <view
+ *   selected={0}
+ *   forwardFocus={spatialForwardFocus}
+ *   onSelectedChanged={(idx, el, child, lastIdx) => {...}}
+ * >
+ * ```
+ */
+export declare const spatialForwardFocus: lng.ForwardFocusHandler;
+/**
+ * Handles spatial navigation within a {@link lngp.NavigableElement} by moving focus
+ * based on the arrow keys pressed.
+ *
+ * This function allows for navigation in a grid-like manner for flex-wrap containers, \
+ * where pressing the arrow keys will either:
+ * - move focus to the next/prev child in the same row/column
+ * - or find the closest child in the next/prev row/column.
+ *
+ * @example
+ * ```tsx
+ * <view
+ *   selected={0}
+ *   display="flex"
+ *   flexWrap="wrap"
+ *   onUp={spatialHandleNavigation}
+ *   onDown={spatialHandleNavigation}
+ *   onSelectedChanged={(idx, el, child, lastIdx) => {...}}
+ * >
+ * ```
+ */
+export declare const spatialHandleNavigation: lng.KeyHandler;