@holoscript/engine 6.0.3 → 6.0.4

package/dist/index-BysHjDSO.d.cts

@@ -0,0 +1,224 @@
+/**
+ * Keplerian Orbital Mechanics Calculator
+ *
+ * Calculates celestial body positions using classical Keplerian orbital elements.
+ * Based on the standard orbital mechanics equations used in astronomy.
+ */
+interface OrbitalElements {
+    /** Semi-major axis in AU (Astronomical Units) */
+    semiMajorAxis: number;
+    /** Orbital eccentricity (0 = circle, <1 = ellipse) */
+    eccentricity: number;
+    /** Inclination in degrees */
+    inclination: number;
+    /** Longitude of ascending node in degrees */
+    longitudeAscending: number;
+    /** Argument of periapsis in degrees */
+    argumentPeriapsis: number;
+    /** Mean anomaly at epoch (J2000) in degrees */
+    meanAnomalyEpoch: number;
+    /** Orbital period in days */
+    orbitalPeriod: number;
+    /** Parent body name for moons/satellites (optional) */
+    parent?: string;
+}
+interface Position3D {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Convert radians to degrees
+ */
+declare function toDegrees(radians: number): number;
+/**
+ * Calculate position in 3D space from orbital elements at a given time
+ *
+ * @param elements - Keplerian orbital elements
+ * @param julianDate - Julian date (days since J2000 epoch)
+ * @returns 3D position in AU (heliocentric or relative to parent)
+ */
+declare function calculatePosition(elements: OrbitalElements, julianDate: number): Position3D;
+/**
+ * Convert Date to Julian Date (days since J2000.0 epoch)
+ * J2000.0 = January 1, 2000, 12:00 TT (Terrestrial Time)
+ *
+ * @param date - JavaScript Date object
+ * @returns Julian date (days since J2000)
+ */
+declare function dateToJulian(date: Date): number;
+/**
+ * Convert Julian date to JavaScript Date
+ *
+ * @param julianDate - Days since J2000
+ * @returns JavaScript Date object
+ */
+declare function julianToDate(julianDate: number): Date;
+/**
+ * Generate orbital path points for visualization
+ *
+ * @param elements - Orbital elements
+ * @param numPoints - Number of points to generate (default: 100)
+ * @returns Array of 3D positions around the orbit
+ */
+declare function generateOrbitalPath(elements: OrbitalElements, numPoints?: number): Position3D[];
+
+/**
+ * Time Manager for Orbital Simulations
+ *
+ * Manages simulation time, time scaling, and animation loop for orbital mechanics.
+ */
+type TimeUpdateCallback = (julianDate: number, realDate: Date) => void;
+declare class TimeManager {
+    private julianDate;
+    private timeScale;
+    private isPaused;
+    private lastUpdateTime;
+    private callbacks;
+    private intervalId;
+    constructor(startDate?: Date);
+    /**
+     * Start the time simulation loop
+     */
+    start(): void;
+    /**
+     * Stop the time simulation loop
+     */
+    stop(): void;
+    /**
+     * Update tick
+     */
+    private update;
+    /**
+     * Advance simulation time
+     *
+     * @param deltaMs - Milliseconds elapsed in real time
+     */
+    advance(deltaMs: number): void;
+    /**
+     * Pause time progression
+     */
+    pause(): void;
+    /**
+     * Resume time progression
+     */
+    play(): void;
+    /**
+     * Toggle pause/play
+     */
+    togglePause(): void;
+    /**
+     * Set time scale (speed multiplier)
+     *
+     * @param scale - Time scale (1 = real-time, 10 = 10x speed, etc.)
+     */
+    setTimeScale(scale: number): void;
+    /**
+     * Get current time scale
+     */
+    getTimeScale(): number;
+    /**
+     * Set simulation date
+     *
+     * @param date - JavaScript Date object
+     */
+    setDate(date: Date): void;
+    /**
+     * Get current simulation date as Julian date
+     */
+    getJulianDate(): number;
+    /**
+     * Get current simulation date as JavaScript Date
+     */
+    getDate(): Date;
+    /**
+     * Check if time is paused
+     */
+    getIsPaused(): boolean;
+    /**
+     * Register a callback for time updates
+     *
+     * @param callback - Function to call when time updates
+     */
+    onUpdate(callback: TimeUpdateCallback): void;
+    /**
+     * Unregister a time update callback
+     *
+     * @param callback - Callback function to remove
+     */
+    offUpdate(callback: TimeUpdateCallback): void;
+    /**
+     * Notify all registered callbacks of time update
+     */
+    private notifyCallbacks;
+    /**
+     * Get time state for serialization
+     */
+    getState(): {
+        julianDate: number;
+        timeScale: number;
+        isPaused: boolean;
+        date: string;
+    };
+}
+
+/**
+ * AttentionEngine
+ *
+ * Implements a heuristic-driven spatial culling and attention
+ * scoring system to avoid O(N^2) perception processing.
+ */
+interface AttendedEntity {
+    id: string;
+    position: [number, number, number];
+    velocity?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    saliencyBase?: number;
+}
+interface AttentionScore {
+    entityId: string;
+    weight: number;
+}
+declare class AttentionEngine {
+    /**
+     * Calculates the attention weight of a target entity relative to an observer.
+     * Incorporates 4 factors: Proximity, Movement, Base Saliency, and Recency (mocked).
+     */
+    static calculateWeight(observerPos: {
+        x: number;
+        y: number;
+        z: number;
+    }, target: AttendedEntity): number;
+    /**
+     * Filters a massive array of entities down to strictly the top K most attended
+     * objects around the observer to save inference/rendering payload.
+     */
+    static getTopKEntities(observerPos: {
+        x: number;
+        y: number;
+        z: number;
+    }, entities: AttendedEntity[], k: number): string[];
+}
+
+type index_AttendedEntity = AttendedEntity;
+type index_AttentionEngine = AttentionEngine;
+declare const index_AttentionEngine: typeof AttentionEngine;
+type index_AttentionScore = AttentionScore;
+type index_OrbitalElements = OrbitalElements;
+type index_Position3D = Position3D;
+type index_TimeManager = TimeManager;
+declare const index_TimeManager: typeof TimeManager;
+type index_TimeUpdateCallback = TimeUpdateCallback;
+declare const index_calculatePosition: typeof calculatePosition;
+declare const index_dateToJulian: typeof dateToJulian;
+declare const index_generateOrbitalPath: typeof generateOrbitalPath;
+declare const index_julianToDate: typeof julianToDate;
+declare const index_toDegrees: typeof toDegrees;
+declare namespace index {
+  export { type index_AttendedEntity as AttendedEntity, index_AttentionEngine as AttentionEngine, type index_AttentionScore as AttentionScore, type index_OrbitalElements as OrbitalElements, type index_Position3D as Position3D, index_TimeManager as TimeManager, type index_TimeUpdateCallback as TimeUpdateCallback, index_calculatePosition as calculatePosition, index_dateToJulian as dateToJulian, index_generateOrbitalPath as generateOrbitalPath, index_julianToDate as julianToDate, index_toDegrees as toDegrees };
+}
+
+export { type AttendedEntity as A, type OrbitalElements as O, type Position3D as P, TimeManager as T, AttentionEngine as a, type AttentionScore as b, type TimeUpdateCallback as c, calculatePosition as d, dateToJulian as e, generateOrbitalPath as g, index as i, julianToDate as j, toDegrees as t };

package/dist/index-BysHjDSO.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Keplerian Orbital Mechanics Calculator
+ *
+ * Calculates celestial body positions using classical Keplerian orbital elements.
+ * Based on the standard orbital mechanics equations used in astronomy.
+ */
+interface OrbitalElements {
+    /** Semi-major axis in AU (Astronomical Units) */
+    semiMajorAxis: number;
+    /** Orbital eccentricity (0 = circle, <1 = ellipse) */
+    eccentricity: number;
+    /** Inclination in degrees */
+    inclination: number;
+    /** Longitude of ascending node in degrees */
+    longitudeAscending: number;
+    /** Argument of periapsis in degrees */
+    argumentPeriapsis: number;
+    /** Mean anomaly at epoch (J2000) in degrees */
+    meanAnomalyEpoch: number;
+    /** Orbital period in days */
+    orbitalPeriod: number;
+    /** Parent body name for moons/satellites (optional) */
+    parent?: string;
+}
+interface Position3D {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Convert radians to degrees
+ */
+declare function toDegrees(radians: number): number;
+/**
+ * Calculate position in 3D space from orbital elements at a given time
+ *
+ * @param elements - Keplerian orbital elements
+ * @param julianDate - Julian date (days since J2000 epoch)
+ * @returns 3D position in AU (heliocentric or relative to parent)
+ */
+declare function calculatePosition(elements: OrbitalElements, julianDate: number): Position3D;
+/**
+ * Convert Date to Julian Date (days since J2000.0 epoch)
+ * J2000.0 = January 1, 2000, 12:00 TT (Terrestrial Time)
+ *
+ * @param date - JavaScript Date object
+ * @returns Julian date (days since J2000)
+ */
+declare function dateToJulian(date: Date): number;
+/**
+ * Convert Julian date to JavaScript Date
+ *
+ * @param julianDate - Days since J2000
+ * @returns JavaScript Date object
+ */
+declare function julianToDate(julianDate: number): Date;
+/**
+ * Generate orbital path points for visualization
+ *
+ * @param elements - Orbital elements
+ * @param numPoints - Number of points to generate (default: 100)
+ * @returns Array of 3D positions around the orbit
+ */
+declare function generateOrbitalPath(elements: OrbitalElements, numPoints?: number): Position3D[];
+
+/**
+ * Time Manager for Orbital Simulations
+ *
+ * Manages simulation time, time scaling, and animation loop for orbital mechanics.
+ */
+type TimeUpdateCallback = (julianDate: number, realDate: Date) => void;
+declare class TimeManager {
+    private julianDate;
+    private timeScale;
+    private isPaused;
+    private lastUpdateTime;
+    private callbacks;
+    private intervalId;
+    constructor(startDate?: Date);
+    /**
+     * Start the time simulation loop
+     */
+    start(): void;
+    /**
+     * Stop the time simulation loop
+     */
+    stop(): void;
+    /**
+     * Update tick
+     */
+    private update;
+    /**
+     * Advance simulation time
+     *
+     * @param deltaMs - Milliseconds elapsed in real time
+     */
+    advance(deltaMs: number): void;
+    /**
+     * Pause time progression
+     */
+    pause(): void;
+    /**
+     * Resume time progression
+     */
+    play(): void;
+    /**
+     * Toggle pause/play
+     */
+    togglePause(): void;
+    /**
+     * Set time scale (speed multiplier)
+     *
+     * @param scale - Time scale (1 = real-time, 10 = 10x speed, etc.)
+     */
+    setTimeScale(scale: number): void;
+    /**
+     * Get current time scale
+     */
+    getTimeScale(): number;
+    /**
+     * Set simulation date
+     *
+     * @param date - JavaScript Date object
+     */
+    setDate(date: Date): void;
+    /**
+     * Get current simulation date as Julian date
+     */
+    getJulianDate(): number;
+    /**
+     * Get current simulation date as JavaScript Date
+     */
+    getDate(): Date;
+    /**
+     * Check if time is paused
+     */
+    getIsPaused(): boolean;
+    /**
+     * Register a callback for time updates
+     *
+     * @param callback - Function to call when time updates
+     */
+    onUpdate(callback: TimeUpdateCallback): void;
+    /**
+     * Unregister a time update callback
+     *
+     * @param callback - Callback function to remove
+     */
+    offUpdate(callback: TimeUpdateCallback): void;
+    /**
+     * Notify all registered callbacks of time update
+     */
+    private notifyCallbacks;
+    /**
+     * Get time state for serialization
+     */
+    getState(): {
+        julianDate: number;
+        timeScale: number;
+        isPaused: boolean;
+        date: string;
+    };
+}
+
+/**
+ * AttentionEngine
+ *
+ * Implements a heuristic-driven spatial culling and attention
+ * scoring system to avoid O(N^2) perception processing.
+ */
+interface AttendedEntity {
+    id: string;
+    position: [number, number, number];
+    velocity?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    saliencyBase?: number;
+}
+interface AttentionScore {
+    entityId: string;
+    weight: number;
+}
+declare class AttentionEngine {
+    /**
+     * Calculates the attention weight of a target entity relative to an observer.
+     * Incorporates 4 factors: Proximity, Movement, Base Saliency, and Recency (mocked).
+     */
+    static calculateWeight(observerPos: {
+        x: number;
+        y: number;
+        z: number;
+    }, target: AttendedEntity): number;
+    /**
+     * Filters a massive array of entities down to strictly the top K most attended
+     * objects around the observer to save inference/rendering payload.
+     */
+    static getTopKEntities(observerPos: {
+        x: number;
+        y: number;
+        z: number;
+    }, entities: AttendedEntity[], k: number): string[];
+}
+
+type index_AttendedEntity = AttendedEntity;
+type index_AttentionEngine = AttentionEngine;
+declare const index_AttentionEngine: typeof AttentionEngine;
+type index_AttentionScore = AttentionScore;
+type index_OrbitalElements = OrbitalElements;
+type index_Position3D = Position3D;
+type index_TimeManager = TimeManager;
+declare const index_TimeManager: typeof TimeManager;
+type index_TimeUpdateCallback = TimeUpdateCallback;
+declare const index_calculatePosition: typeof calculatePosition;
+declare const index_dateToJulian: typeof dateToJulian;
+declare const index_generateOrbitalPath: typeof generateOrbitalPath;
+declare const index_julianToDate: typeof julianToDate;
+declare const index_toDegrees: typeof toDegrees;
+declare namespace index {
+  export { type index_AttendedEntity as AttendedEntity, index_AttentionEngine as AttentionEngine, type index_AttentionScore as AttentionScore, type index_OrbitalElements as OrbitalElements, type index_Position3D as Position3D, index_TimeManager as TimeManager, type index_TimeUpdateCallback as TimeUpdateCallback, index_calculatePosition as calculatePosition, index_dateToJulian as dateToJulian, index_generateOrbitalPath as generateOrbitalPath, index_julianToDate as julianToDate, index_toDegrees as toDegrees };
+}
+
+export { type AttendedEntity as A, type OrbitalElements as O, type Position3D as P, TimeManager as T, AttentionEngine as a, type AttentionScore as b, type TimeUpdateCallback as c, calculatePosition as d, dateToJulian as e, generateOrbitalPath as g, index as i, julianToDate as j, toDegrees as t };