@cosmos.gl/graph 2.6.3 → 2.6.4

package/dist/src/helper.d.ts

@@ -1,61 +0,0 @@
-import { Device, Framebuffer } from '@luma.gl/core';
-import { default as DOMPurify } from 'dompurify';
-export declare const isFunction: <T>(a: T) => boolean;
-export declare const isArray: <T>(a: unknown | T[]) => a is T[];
-export declare const isObject: <T>(a: T) => boolean;
-export declare const isAClassInstance: <T>(a: T) => boolean;
-export declare const isPlainObject: <T>(a: T) => boolean;
-export declare function getRgbaColor(value: string | [number, number, number, number]): [number, number, number, number];
-export declare function rgbToBrightness(r: number, g: number, b: number): number;
-/**
- * TODO: Migrate from deprecated `readPixelsToArrayWebGL` to CommandEncoder API
- *
- * `readPixelsToArrayWebGL` is deprecated in luma.gl v9. The recommended modern approach is:
- *
- * 1. Create a buffer to hold the pixel data:
- *    const buffer = device.createBuffer({
- *      byteLength: width * height * 4 * 4, // RGBA, 4 bytes per float
- *      usage: Buffer.COPY_DST | Buffer.MAP_READ
- *    });
- *
- * 2. Copy texture/framebuffer to buffer using command encoder:
- *    const commandEncoder = device.createCommandEncoder();
- *    commandEncoder.copyTextureToBuffer({
- *      sourceTexture: fbo, // Can be Texture or Framebuffer
- *      width: sourceWidth ?? fbo.width,
- *      height: sourceHeight ?? fbo.height,
- *      origin: [sourceX, sourceY],
- *      destinationBuffer: buffer
- *    });
- *    const commandBuffer = commandEncoder.finish();
- *    device.submit(commandBuffer);
- *
- * 3. Read the data from the buffer (async):
- *    const pixelData = await buffer.readAsync(); // Returns ArrayBuffer
- *    return new Float32Array(pixelData);
- *
- * Note: The modern approach is asynchronous, so this function signature would need to change
- * to return Promise<Float32Array> or we'd need to handle async at all call sites (18 locations).
- *
- * Migration impact:
- * - This function is used in 18 places across the codebase
- * - All call sites would need to be updated to handle async
- * - Consider batching the migration to avoid inconsistencies
- *
- * Current status: Deprecated but still functional. Keeping for now until full migration can be planned.
- */
-export declare function readPixels(device: Device, fbo: Framebuffer, sourceX?: number, sourceY?: number, sourceWidth?: number, sourceHeight?: number): Float32Array;
-export declare function clamp(num: number, min: number, max: number): number;
-export declare function isNumber(value: number | undefined | null | typeof NaN): boolean;
-/**
- * Sanitizes HTML content to prevent XSS attacks using DOMPurify
- *
- * This function is used internally to sanitize HTML content before setting innerHTML,
- * such as in attribution text. It uses a safe default configuration that allows
- * only common safe HTML elements and attributes.
- *
- * @param html The HTML string to sanitize
- * @param options Optional DOMPurify configuration options to override defaults
- * @returns Sanitized HTML string safe for innerHTML usage
- */
-export declare function sanitizeHtml(html: string, options?: DOMPurify.Config): string;

package/dist/src/modules/ForceGravity/index.d.ts

@@ -1,13 +0,0 @@
-import { CoreModule } from '../core-module';
-export declare class ForceGravity extends CoreModule {
-    private runCommand;
-    private vertexCoordBuffer;
-    private uniformStore;
-    initPrograms(): void;
-    run(): void;
-    /**
-     * Destruction order matters
-     * Models -> Framebuffers -> Textures -> UniformStores -> Buffers
-     */
-    destroy(): void;
-}

package/dist/src/modules/ForceManyBody/index.d.ts

@@ -1,26 +0,0 @@
-import { CoreModule } from '../core-module';
-export declare class ForceManyBody extends CoreModule {
-    private randomValuesTexture;
-    private pointIndices;
-    private levels;
-    private levelTargets;
-    private calculateLevelsCommand;
-    private forceCommand;
-    private forceFromItsOwnCentermassCommand;
-    private forceVertexCoordBuffer;
-    private calculateLevelsUniformStore;
-    private forceUniformStore;
-    private forceCenterUniformStore;
-    private previousPointsTextureSize;
-    private previousSpaceSize;
-    create(): void;
-    initPrograms(): void;
-    run(): void;
-    /**
-     * Destruction order matters
-     * Models -> Framebuffers -> Textures -> UniformStores -> Buffers
-     */
-    destroy(): void;
-    private drawLevels;
-    private drawForces;
-}

package/dist/src/modules/ForceMouse/index.d.ts

@@ -1,13 +0,0 @@
-import { CoreModule } from '../core-module';
-export declare class ForceMouse extends CoreModule {
-    private runCommand;
-    private vertexCoordBuffer;
-    private uniformStore;
-    initPrograms(): void;
-    run(): void;
-    /**
-     * Destruction order matters
-     * Models -> Framebuffers -> Textures -> UniformStores -> Buffers
-     */
-    destroy(): void;
-}

package/dist/src/modules/Shared/buffer.d.ts

@@ -1 +0,0 @@
-export declare function createIndexesForBuffer(textureSize: number): Float32Array;

package/dist/src/modules/Shared/texture-utils.d.ts

@@ -1,8 +0,0 @@
-import { TextureFormat } from '@luma.gl/core';
-/**
- * Calculates bytesPerRow for texture uploads.
- * @param format - Texture format
- * @param width - Texture width in pixels
- * @returns bytesPerRow in bytes
- */
-export declare function getBytesPerRow(format: TextureFormat, width: number): number;

package/dist/src/modules/Shared/uniform-utils.d.ts

@@ -1,11 +0,0 @@
-/**
- * Validates and normalizes array values to fixed-size tuples for shader uniforms.
- */
-/**
- * Ensures a value is a vec2 tuple [number, number].
- */
-export declare function ensureVec2(arr: number[] | undefined, fallback: [number, number]): [number, number];
-/**
- * Ensures a value is a vec4 tuple [number, number, number, number].
- */
-export declare function ensureVec4(arr: number[] | undefined, fallback: [number, number, number, number]): [number, number, number, number];

package/dist/src/modules/Store/index.d.ts

@@ -1,169 +0,0 @@
-import { mat3 } from 'gl-matrix';
-import { GraphConfigInterface } from '../../config';
-export declare const ALPHA_MIN = 0.001;
-export declare const MAX_POINT_SIZE = 64;
-/**
- * Maximum number of executions to delay before performing hover detection.
- * This threshold prevents excessive hover detection calls for performance optimization.
- * The `findHoveredItem` method will skip actual detection until this count is reached.
- */
-export declare const MAX_HOVER_DETECTION_DELAY = 4;
-export type Hovered = {
-    index: number;
-    position: [number, number];
-};
-type Focused = {
-    index: number;
-};
-/**
- * Type alias for a 4x4 matrix stored as a 16-element array in column-major order.
- * Used for std140 uniform buffer layout compatibility.
- */
-type Mat4Array = [number, number, number, number, number, number, number, number, number, number, number, number, number, number, number, number];
-export declare class Store {
-    pointsTextureSize: number;
-    linksTextureSize: number;
-    alpha: number;
-    transform: mat3;
-    screenSize: [number, number];
-    mousePosition: number[];
-    screenMousePosition: number[];
-    selectedArea: number[][];
-    isSimulationRunning: boolean;
-    simulationProgress: number;
-    selectedIndices: Float32Array | null;
-    maxPointSize: number;
-    hoveredPoint: Hovered | undefined;
-    focusedPoint: Focused | undefined;
-    draggingPointIndex: number | undefined;
-    hoveredLinkIndex: number | undefined;
-    adjustedSpaceSize: number;
-    isSpaceKeyPressed: boolean;
-    div: HTMLDivElement | undefined;
-    webglMaxTextureSize: number;
-    hoveredPointRingColor: number[];
-    focusedPointRingColor: number[];
-    hoveredLinkColor: number[];
-    greyoutPointColor: number[];
-    isDarkenGreyout: boolean;
-    isLinkHoveringEnabled: boolean;
-    private alphaTarget;
-    private scalePointX;
-    private scalePointY;
-    private random;
-    private _backgroundColor;
-    get backgroundColor(): [number, number, number, number];
-    /**
-     * Gets the transformation matrix as a 4x4 matrix for std140 uniform buffer layout.
-     *
-     * This method converts the internal 3x3 transformation matrix (mat3) to a 4x4 matrix format
-     * required by WebGPU uniform buffers using the std140 layout standard.
-     *
-     * ## Matrix Storage Format
-     *
-     * Matrices are stored in **column-major order** (GLSL convention). The internal `transform`
-     * array is a 9-element array representing a 3x3 matrix:
-     *
-     * ```
-     * [m00, m10, m20, m01, m11, m21, m02, m12, m22]
-     * ```
-     *
-     * Which represents the matrix:
-     * ```
-     * [m00 m01 m02]
-     * [m10 m11 m12]
-     * [m20 m21 m22]
-     * ```
-     *
-     * ## Why This Conversion Is Needed
-     *
-     * The internal `transform` property stores a 3x3 matrix (9 elements) which is sufficient for
-     * 2D transformations (translation, rotation, scaling in x/y plane). However, when passing
-     * transformation matrices to GPU shaders via uniform buffers, we must comply with the std140
-     * layout standard.
-     *
-     * ### std140 Layout Requirements
-     *
-     * The std140 layout standard (used in both OpenGL and WebGPU) defines strict alignment rules:
-     *
-     * 1. **Matrix Alignment**: In std140, matrices are stored as arrays of column vectors
-     *    - `mat3` requires each column to be aligned to 16 bytes (vec4 alignment)
-     *    - This means `mat3` occupies 3 columns × 16 bytes = 48 bytes total
-     *    - `mat4` occupies 4 columns × 16 bytes = 64 bytes total
-     *
-     * 2. **Alignment Issues with mat3**:
-     *    - The 48-byte size of `mat3` creates awkward alignment and padding requirements
-     *    - Different GPU drivers may handle `mat3` padding inconsistently
-     *    - This can lead to data misalignment and incorrect transformations
-     *
-     * 3. **Why mat4 is Preferred**:
-     *    - `mat4` has clean 64-byte alignment (power of 2)
-     *    - Consistent behavior across all GPU drivers and platforms
-     *    - The shader can easily extract the 3x3 portion: `mat3 transformMat3 = mat3(transformationMatrix)`
-     *    - The 4th column is set to `[0, 0, 0, 1]` (homogeneous coordinate) which doesn't affect 2D transforms
-     *
-     * ### Conversion Process
-     *
-     * The 3x3 matrix is converted to 4x4 by:
-     * - Placing the 3x3 values in the top-left corner (preserving column-major order)
-     * - Setting the 4th column to `[0, 0, 0, 1]` (homogeneous coordinate)
-     * - The 4th row is implicitly `[0, 0, 0, 1]` due to column-major storage
-     *
-     * This creates a valid 4x4 transformation matrix that:
-     * - Maintains the same 2D transformation behavior
-     * - Satisfies std140 alignment requirements
-     * - Works consistently across all GPU platforms
-     *
-     * ### Usage in Shaders
-     *
-     * Shaders using uniform buffers receive this as `mat4` and extract the 3x3 portion:
-     * ```glsl
-     * layout(std140) uniform uniforms {
-     *   mat4 transformationMatrix;
-     * } uniforms;
-     *
-     * mat3 transformMat3 = mat3(uniforms.transformationMatrix);
-     * vec3 final = transformMat3 * vec3(position, 1);
-     * ```
-     *
-     * @returns A 16-element array representing a 4x4 matrix in column-major order,
-     *          suitable for std140 uniform buffer layout. The matrix preserves the
-     *          2D transformation from the original 3x3 matrix.
-     *
-     * @example
-     * ```typescript
-     * const matrix = store.transformationMatrix4x4;
-     * uniformStore.setUniforms({
-     *   uniforms: {
-     *     transformationMatrix: matrix  // Expects mat4x4<f32> in shader
-     *   }
-     * });
-     * ```
-     */
-    get transformationMatrix4x4(): Mat4Array;
-    set backgroundColor(color: [number, number, number, number]);
-    addRandomSeed(seed: number | string): void;
-    getRandomFloat(min: number, max: number): number;
-    /**
-     * If the config parameter `spaceSize` exceeds the limits of WebGL,
-     * it reduces the space size without changing the config parameter.
-     * Ensures `spaceSize` is always a positive number >= 2 (required for Math.log2).
-     */
-    adjustSpaceSize(configSpaceSize: number, webglMaxTextureSize: number): void;
-    /**
-     * Sets the WebGL texture size limit for use in atlas creation and other texture operations.
-     */
-    setWebGLMaxTextureSize(webglMaxTextureSize: number): void;
-    updateScreenSize(width: number, height: number): void;
-    scaleX(x: number): number;
-    scaleY(y: number): number;
-    setHoveredPointRingColor(color: string | [number, number, number, number]): void;
-    setFocusedPointRingColor(color: string | [number, number, number, number]): void;
-    setGreyoutPointColor(color: string | [number, number, number, number] | undefined): void;
-    updateLinkHoveringEnabled(config: Pick<GraphConfigInterface, 'onLinkClick' | 'onLinkMouseOver' | 'onLinkMouseOut'>): void;
-    setHoveredLinkColor(color?: string | [number, number, number, number]): void;
-    setFocusedPoint(index?: number): void;
-    addAlpha(decay: number): number;
-    private alphaDecay;
-}
-export {};

package/dist/vite.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import('vite').UserConfigFnObject;
-export default _default;