vim-web 0.5.0-dev.5 → 0.5.0-dev.7

package/dist/types/core-viewers/ultra/colorManager.d.ts

@@ -1,6 +1,6 @@
 import { RpcSafeClient } from './rpcSafeClient';
 import { RemoteColor } from './remoteColor';
-import { RGBA32 } from './rpcTypes';
+import * as THREE from 'three';
 /**
  * Manages the creation, caching, and deletion of color instances.
  * Handles batched deletion of colors to optimize RPC calls.
@@ -21,14 +21,14 @@ export declare class ColorManager {
      * @param hex - The RGBA32 color value
      * @returns Promise resolving to a ColorHandle, or undefined if creation fails
      */
-    getColor(hex: RGBA32): Promise<RemoteColor | undefined>;
+    getColor(color: THREE.Color): Promise<RemoteColor | undefined>;
     /**
      * Creates or retrieves cached color instances for multiple hex values.
-     * @param c - Array of RGBA32 color values
+     * @param colors - Array of RGBA32 color values
      * @returns Promise resolving to an array of ColorHandles in the same order as input, or undefined if creation fails
      * @remarks Duplicate hex values will be mapped to the same color instance for efficiency
      */
-    getColors(c: RGBA32[]): Promise<RemoteColor[]>;
+    getColors(colors: THREE.Color[]): Promise<RemoteColor[]>;
     /**
      * Retrieves a color instance by its unique identifier.
      * @param id - The unique identifier of the color

package/dist/types/core-viewers/ultra/element3d.d.ts

@@ -1,7 +1,7 @@
 import { IVimElement } from "../shared/vim";
 import { VisibilityState } from "./visibility";
-import { Box3, RGBA32 } from "./rpcTypes";
 import { Vim } from "./vim";
+import * as THREE from "three";
 /**
  * Represents a single 3D element within a `Vim` model.
  * Provides access to per-instance state, color, and bounding box.
@@ -33,12 +33,12 @@ export declare class Element3D implements IVimElement {
     /**
      * Gets or sets the color override of the element.
      */
-    get color(): RGBA32 | undefined;
-    set color(color: RGBA32 | undefined);
+    get color(): THREE.Color | undefined;
+    set color(color: THREE.Color | undefined);
     /**
      * Computes and returns the bounding box of the element.
      * Returns undefined if the element is abstract.
      * @returns A promise resolving to the element's bounding box.
      */
-    getBoundingBox(): Promise<Box3 | undefined>;
+    getBoundingBox(): Promise<THREE.Box3 | undefined>;
 }

package/dist/types/core-viewers/ultra/index.d.ts

@@ -1,6 +1,6 @@
 import "./style.css";
 export * from './viewer';
-export { RGB, RGBA, RGBA32, Segment, type SectionBoxState, type HitCheckResult, type VimStatus } from './rpcTypes';
+export { Segment, type SectionBoxState, type HitCheckResult, type VimStatus } from './rpcTypes';
 export { materialHandles, MaterialHandles, type MaterialHandle, } from './rpcClient';
 export { InputMode, VimLoadingStatus } from './rpcSafeClient';
 export { VisibilityState } from './visibility';

package/dist/types/core-viewers/ultra/remoteColor.d.ts

@@ -1,5 +1,5 @@
-import { RGBA32 } from './rpcTypes';
 import { ColorManager } from './colorManager';
+import * as THREE from 'three';
 /**
  * Represents a handle to a color in the color management system.
  * This class provides access to color components and manages the lifecycle of color instances.
@@ -9,7 +9,7 @@ export declare class RemoteColor {
     /** Unique identifier for the color instance */
     readonly id: number;
     /** The RGBA color value */
-    readonly color: RGBA32;
+    readonly color: THREE.Color;
     private _disposed;
     /**
      * Indicates whether the color handle has been disposed.
@@ -21,33 +21,13 @@ export declare class RemoteColor {
      * @returns {number} The color value as a hexadecimal number.
      */
     get hex(): number;
-    /**
-     * Gets the red component of the color.
-     * @returns {number} The red component value in the range [0-255].
-     */
-    get r(): number;
-    /**
-     * Gets the green component of the color.
-     * @returns {number} The green component value in the range [0-255].
-     */
-    get g(): number;
-    /**
-     * Gets the blue component of the color.
-     * @returns {number} The blue component value in the range [0-255].
-     */
-    get b(): number;
-    /**
-     * Gets the alpha (opacity) component of the color.
-     * @returns {number} The alpha component value in the range [0-255].
-     */
-    get a(): number;
     /**
      * Creates a new ColorHandle instance.
      * @param {RGBA32} color - The RGBA color value.
      * @param {number} serverId - The unique identifier assigned by the server.
      * @param {ColorManager} manager - The color manager instance that manages this color handle.
      */
-    constructor(color: RGBA32, serverId: number, manager: ColorManager);
+    constructor(color: THREE.Color, serverId: number, manager: ColorManager);
     /**
      * Disposes of the color handle and releases associated resources.
      * Once disposed, the color handle cannot be used anymore.

package/dist/types/core-viewers/ultra/renderer.d.ts

@@ -2,14 +2,14 @@ import { ISignal } from "ste-signals";
 import * as THREE from "three";
 import { ILogger } from "./logger";
 import { RpcSafeClient, SceneSettings } from "./rpcSafeClient";
-import { RGBA } from "./rpcTypes";
 import { ClientStreamError } from "./socketClient";
 /**
  * Render settings that extend SceneSettings with additional rendering-specific properties
  */
 export type RenderSettings = SceneSettings & {
     /** Color used for ghost/transparent rendering */
-    ghostColor: RGBA;
+    ghostColor: THREE.Color;
+    ghostOpacity: number;
 };
 /**
  * Default rendering settings
@@ -20,13 +20,14 @@ export declare const defaultRenderSettings: RenderSettings;
  */
 export interface IRenderer {
     onSceneUpdated: ISignal;
-    ghostColor: RGBA;
+    ghostColor: THREE.Color;
+    ghostOpacity: number;
     hdrScale: number;
     toneMappingWhitePoint: number;
     hdrBackgroundScale: number;
     hdrBackgroundSaturation: number;
     backgroundBlur: number;
-    backgroundColor: RGBA;
+    backgroundColor: THREE.Color;
     getBoundingBox(): Promise<THREE.Box3 | undefined>;
 }
 /**
@@ -60,9 +61,10 @@ export declare class Renderer implements IRenderer {
     notifySceneUpdated(): void;
     /**
      * Gets the ghost color used for transparent rendering
-     * @returns Current ghost color as RGBA
+     * @returns Current ghost color as a THREE.Color
      */
-    get ghostColor(): RGBA;
+    get ghostColor(): THREE.Color;
+    get ghostOpacity(): number;
     /**
      * Gets the tone mapping white point value
      * @returns Current tone mapping white point
@@ -92,12 +94,13 @@ export declare class Renderer implements IRenderer {
      * Gets the background color
      * @returns Current background color as RGBA
      */
-    get backgroundColor(): RGBA;
+    get backgroundColor(): THREE.Color;
     /**
      * Updates the ghost color used for transparent rendering
-     * @param value - New ghost color as RGBA
+     * @param value - New ghost color as THREE.Color
      */
-    set ghostColor(value: RGBA);
+    set ghostColor(value: THREE.Color);
+    set ghostOpacity(value: number);
     /**
      * Sets the tone mapping white point value
      * @param value - New tone mapping white point value
@@ -125,9 +128,9 @@ export declare class Renderer implements IRenderer {
     set backgroundBlur(value: number);
     /**
      * Sets the background color
-     * @param value - New background color as RGBA
+     * @param value - New background color as THREE.Color
      */
-    set backgroundColor(value: RGBA);
+    set backgroundColor(value: THREE.Color);
     getBoundingBox(): Promise<THREE.Box3 | undefined>;
     /**
      * Requests an update to be performed on the next animation frame.

package/dist/types/core-viewers/ultra/rpcTypes.d.ts

@@ -15,6 +15,8 @@ export declare class RGBA {
     b: number;
     a: number;
     constructor(r: number, g: number, b: number, a?: number);
+    static fromThree(color: THREE.Color, opacity?: number): RGBA;
+    toThree(): THREE.Color;
     clone(): RGBA;
     isValid(): boolean;
     equals(color: RGBA): boolean;
@@ -29,6 +31,7 @@ export declare class RGB {
 export declare class RGBA32 {
     readonly hex: number;
     constructor(hex: number);
+    static fromThree(color: THREE.Color, opacity?: number): RGBA32;
     static fromInts(r: number, g: number, b: number, a?: number): RGBA32;
     static fromFloats(r: number, g: number, b: number, a?: number): RGBA32;
     static fromString(str: string): RGBA32;

package/dist/types/core-viewers/ultra/rpcUtils.d.ts

@@ -0,0 +1,8 @@
+import * as rpcTypes from "./rpcTypes";
+import * as THREE from "three";
+export declare function RGBToThree(color: rpcTypes.RGB): THREE.Color;
+export declare function RGBAToThree(color: rpcTypes.RGBA): THREE.Color;
+export declare function RGBA32ToThree(color: rpcTypes.RGBA32): THREE.Color;
+export declare function RGBfromThree(color: THREE.Color): rpcTypes.RGB;
+export declare function RGBAfromThree(color: THREE.Color, opacity?: number): rpcTypes.RGBA;
+export declare function RGBA32fromThree(color: THREE.Color, opacity?: number): rpcTypes.RGBA32;

package/dist/types/core-viewers/ultra/vim.d.ts

@@ -7,7 +7,6 @@ import { VisibilitySynchronizer } from './visibility';
 import { Renderer } from './renderer';
 import { RpcSafeClient, VimSource } from './rpcSafeClient';
 import * as THREE from 'three';
-import { RGBA32 } from './rpcTypes';
 export declare class Vim implements IVim<Element3D> {
     readonly source: VimSource;
     private _handle;
@@ -17,7 +16,7 @@ export declare class Vim implements IVim<Element3D> {
     private _renderer;
     private _logger;
     readonly visibility: VisibilitySynchronizer;
-    private _nodeColors;
+    private _elementColors;
     private _updatedColors;
     private _updateScheduled;
     private _elementCount;
@@ -37,9 +36,9 @@ export declare class Vim implements IVim<Element3D> {
     private _getHandle;
     getBoundingBoxNodes(nodes: number[] | 'all'): Promise<THREE.Box3 | undefined>;
     getBoundingBox(): Promise<THREE.Box3 | undefined>;
-    getColor(node: number): RGBA32 | undefined;
-    setColor(nodes: number[], color: RGBA32 | undefined): Promise<void>;
-    setColors(nodes: number[], color: (RGBA32 | undefined)[]): Promise<void>;
+    getColor(elementIndex: number): THREE.Color | undefined;
+    setColor(elementIndex: number[], color: THREE.Color | undefined): Promise<void>;
+    setColors(nodes: number[], color: (THREE.Color | undefined)[]): Promise<void>;
     private applyColor;
     clearColor(elements: number[] | 'all'): void;
     reapplyColors(): void;

package/dist/types/utils/validation.d.ts

@@ -1,5 +1,6 @@
 import * as THREE from 'three';
 import * as Core from '../core-viewers';
+import { RGBA } from '../core-viewers/ultra/rpcTypes';
 export declare class Validation {
     static isNumber(value: number): boolean;
     static isPositiveNumber(value: number): boolean;
@@ -15,8 +16,6 @@ export declare class Validation {
     static isValidVector3(value: THREE.Vector3): boolean;
     static isValidBox(box: THREE.Box3): boolean;
     static isValidSegment(segment: Core.Ultra.Segment): boolean;
-    static isRelativeRGBA(color: Core.Ultra.RGBA): boolean;
-    static isRelativeRGB(color: Core.Ultra.RGB): boolean;
     static isNonEmptyString(value: string): boolean;
     static isURL(value: string): boolean;
     static areSameLength<T1, T2>(array: T1[], array2: T2[]): boolean;
@@ -24,6 +23,7 @@ export declare class Validation {
     static clamp(min: number, max: number, value: number): number;
     static clamp01(value: number): number;
     static min0(value: number): number;
-    static clampRGBA01(value: Core.Ultra.RGBA): Core.Ultra.RGBA;
-    static clampRGB01(value: Core.Ultra.RGBA): Core.Ultra.RGBA;
+    static clampColor01(value: THREE.Color): THREE.Color;
+    static clampRGBA01(value: RGBA): RGBA;
+    static clampRGB01(value: RGBA): RGBA;
 }