@naniteninja/trait-visual 1.0.3 → 1.0.4

package/lib/types/dust-field.types.d.ts

@@ -0,0 +1,61 @@
+import * as THREE from 'three';
+export type DustMode = 'disk' | 'sphere';
+export interface IDustPaletteStop {
+    /**
+     * Normalized radial position within the dust field (0 = core, 1 = outer edge).
+     */
+    at: number;
+    /**
+     * Color at this stop. Accepts any THREE color representation.
+     */
+    color: THREE.ColorRepresentation;
+    /**
+     * Optional intensity multiplier applied when lerping between stops.
+     * Defaults to 1.0.
+     */
+    intensity?: number;
+}
+export interface IDustPaletteOptions {
+    /**
+     * Ordered palette stops that describe the desired color ramp.
+     * Values outside [0, 1] will be clamped.
+     */
+    stops: IDustPaletteStop[];
+    /**
+     * Strength multiplier for hue bias modulation in the shader.
+     * Defaults to 0.65.
+     */
+    hueBiasScale?: number;
+    /**
+     * Minimum luminance floor to keep blacks saturated but not crushed.
+     * Defaults to 0.06.
+     */
+    backgroundLift?: number;
+    /**
+     * Maximum brightness applied to the core (radialT ~ 0).
+     * Defaults to 1.4.
+     */
+    coreIntensity?: number;
+}
+export interface IDustOptions {
+    innerRadius?: number;
+    outerRadius?: number;
+    thickness?: number;
+    countMidFar?: number;
+    countBokeh?: number;
+    minAngularVel?: number;
+    maxAngularVel?: number;
+    noiseStrength?: number;
+    colorInner?: THREE.ColorRepresentation;
+    colorMid?: THREE.ColorRepresentation;
+    colorOuter?: THREE.ColorRepresentation;
+    palette?: IDustPaletteOptions;
+    renderOrder?: number;
+}
+export type Cohort = 'disk' | 'diskBokeh' | 'halo' | 'haloBokeh';
+/** @deprecated Use IDustOptions */
+export type DustOptions = IDustOptions;
+/** @deprecated Use IDustPaletteOptions */
+export type DustPaletteOptions = IDustPaletteOptions;
+/** @deprecated Use IDustPaletteStop */
+export type DustPaletteStop = IDustPaletteStop;

package/lib/types/glow.types.d.ts

@@ -0,0 +1,18 @@
+import * as THREE from 'three';
+export type GlowUniforms = {
+    glowColor: {
+        value: THREE.Color;
+    };
+    opacity: {
+        value: number;
+    };
+    c?: {
+        value: number;
+    };
+    p?: {
+        value: number;
+    };
+    base?: {
+        value: number;
+    };
+};

package/lib/types/particle-field.types.d.ts

@@ -0,0 +1,53 @@
+import * as THREE from 'three';
+export interface IParticleFieldOptions {
+    coreRadius: number;
+    particleCount?: number;
+    palette?: 'supermassiveBlackhole' | 'blackhole';
+    distribution?: 'surface' | 'banded';
+    speedScale?: number;
+    particleSizeMax?: number;
+    particleSizeScale?: number;
+    surfaceRadiusMin?: number;
+    surfaceRadiusMax?: number;
+    rimMinShellFactor?: number;
+}
+export interface IFlowParticle {
+    type: 'topCurve' | 'bottomCurve' | 'orbit' | 'topCap' | 'bottomCap' | 'surface';
+    radius: number;
+    angle: number;
+    angularSpeed: number;
+    radialJitterAmp: number;
+    radialJitterFreq: number;
+    verticalOffset?: number;
+    size: number;
+    color: THREE.Color;
+    opacity: number;
+    lifetime: number;
+    age: number;
+    ellipse: number;
+    upBias: number;
+    depthBias: number;
+    wigglePhase: number;
+    wiggleFreqUp: number;
+    wiggleFreqDepth: number;
+    capRadBias?: number;
+    arcUpAmp: number;
+    arcDepthAmp: number;
+    arcRadAmp: number;
+    arcFreq: number;
+    angleWanderAmp: number;
+    angleWanderFreq: number;
+    angleWanderPhase: number;
+    tiltUF?: number;
+    phi?: number;
+    thetaMargin?: number;
+    frontCurveAngle?: number;
+    phiAmp?: number;
+    axis?: THREE.Vector3;
+    u?: THREE.Vector3;
+    v?: THREE.Vector3;
+    dirSign?: 1 | -1;
+    precessAxis?: THREE.Vector3;
+    precessSpeed?: number;
+    baseOmega?: number;
+}

package/lib/utils/debug-counters.d.ts

@@ -0,0 +1,6 @@
+export declare function getPhysicsCallsThisFrame(): number;
+export declare function setPhysicsCallsThisFrame(value: number): void;
+export declare function incrementPhysicsCalls(): number;
+export declare function getDebugFrameCount(): number;
+export declare function incrementDebugFrameCount(): number;
+export declare function resetPhysicsCalls(): void;

package/lib/utils/on-right-click.util.d.ts

@@ -0,0 +1,4 @@
+import * as THREE from 'three';
+import { Blackhole } from '../objects/Blackhole';
+import { ElementRef, Renderer2 } from '@angular/core';
+export declare function handleRightClick(event: MouseEvent, mouse: THREE.Vector2, camera: THREE.Camera, raycaster: THREE.Raycaster, cluster: THREE.Object3D, contextMenuRef: ElementRef, renderer2: Renderer2, setSelectedNode: (blackhole: Blackhole) => void, canvas?: HTMLCanvasElement | null, containerEl?: HTMLElement | null): void;

package/lib/utils/window.util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Safe access to window.location.search (e.g. for ?debug=1).
+ * Use instead of (window as any)?.location?.search to satisfy strict typing.
+ */
+export declare function getWindowLocationSearch(): string;
+/** True when URL has debug=1 (enables optional ingest logging). */
+export declare function isDebugIngestEnabled(): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naniteninja/trait-visual",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Angular library for visualizing trait-based relationships in 3D space using Three.js",
   "keywords": [
     "angular",

package/public-api.d.ts

@@ -0,0 +1,12 @@
+export * from './lib/trait-visual.component';
+export * from './lib/config-sidenav/config-sidenav.component';
+export * from './lib/app.types';
+export { Cluster } from './lib/objects/Cluster';
+export { Blackhole } from './lib/objects/Blackhole';
+export { StellarDustField } from './lib/services/stellar-dust-field';
+export type { DustMode } from './lib/services/stellar-dust-field';
+export { addNode, removeNode } from './lib/services/node-actions';
+export { BlackHoleParticleField } from './lib/services/black-hole-particle-field';
+export { handleRightClick } from './lib/utils/on-right-click.util';
+export { getWindowLocationSearch } from './lib/utils/window.util';
+export { dynamicCounts, updateCounts, attributeWeights, nodeData } from './lib/data/nodes.data';