@holoscript/engine 6.0.3 → 6.0.4

package/dist/index-DfNLiAka.d.cts

@@ -0,0 +1,192 @@
+/**
+ * LODManager.ts
+ *
+ * Level-of-detail management: distance-based LOD selection,
+ * transition blending, hysteresis, and per-object bias config.
+ *
+ * @module world
+ */
+interface LODLevel {
+    level: number;
+    maxDistance: number;
+    meshDetail: number;
+}
+interface LODObject {
+    id: string;
+    position: [number, number, number];
+    currentLevel: number;
+    levels: LODLevel[];
+    bias: number;
+    visible: boolean;
+    transitionAlpha: number;
+}
+interface LODConfig {
+    defaultLevels: LODLevel[];
+    hysteresis: number;
+    transitionSpeed: number;
+    maxObjects: number;
+}
+declare class LODManager {
+    private config;
+    private objects;
+    private viewerPosition;
+    constructor(config?: Partial<LODConfig>);
+    register(id: string, position: [number, number, number], levels?: LODLevel[], bias?: number): LODObject;
+    unregister(id: string): boolean;
+    setViewerPosition(x: number, y: number, z: number): void;
+    update(dt: number): void;
+    getObject(id: string): LODObject | undefined;
+    getObjectCount(): number;
+    getLevelDistribution(): Map<number, number>;
+    getObjectsAtLevel(level: number): LODObject[];
+    getAverageLOD(): number;
+}
+
+/**
+ * OcclusionCulling.ts
+ *
+ * Visibility determination: frustum culling, AABB tests,
+ * portal-based occlusion, and query batching.
+ *
+ * @module world
+ */
+interface AABB {
+    min: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    max: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+interface FrustumPlane {
+    normal: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    distance: number;
+}
+interface CullableObject {
+    id: string;
+    bounds: AABB;
+    visible: boolean;
+    lastTestFrame: number;
+    layer: number;
+}
+interface OcclusionPortal {
+    id: string;
+    bounds: AABB;
+    connectedZones: [string, string];
+    open: boolean;
+}
+interface OcclusionZone {
+    id: string;
+    bounds: AABB;
+    objects: string[];
+}
+declare class OcclusionCulling {
+    private objects;
+    private zones;
+    private portals;
+    private frustumPlanes;
+    private currentFrame;
+    private visibleCount;
+    private culledCount;
+    private layerMask;
+    register(id: string, bounds: AABB, layer?: number): CullableObject;
+    unregister(id: string): boolean;
+    updateBounds(id: string, bounds: AABB): void;
+    addZone(id: string, bounds: AABB, objectIds?: string[]): void;
+    addPortal(id: string, bounds: AABB, zone1: string, zone2: string): void;
+    setPortalOpen(id: string, open: boolean): void;
+    setFrustum(planes: FrustumPlane[]): void;
+    setLayerMask(mask: number): void;
+    performCulling(): void;
+    private isInFrustum;
+    testAABBOverlap(a: AABB, b: AABB): boolean;
+    queryRegion(region: AABB): CullableObject[];
+    getVisibleZones(startZone: string): string[];
+    getVisibleObjects(): CullableObject[];
+    getVisibleCount(): number;
+    getCulledCount(): number;
+    getTotalCount(): number;
+    getCullRatio(): number;
+    getCurrentFrame(): number;
+}
+
+/**
+ * WorldStreamer.ts
+ *
+ * Chunk-based world streaming: loading/unloading by distance,
+ * async chunk generation, seamless transitions, and memory budgets.
+ *
+ * @module world
+ */
+type ChunkState = 'unloaded' | 'loading' | 'loaded' | 'unloading';
+interface WorldChunk {
+    id: string;
+    x: number;
+    z: number;
+    state: ChunkState;
+    data: Record<string, unknown> | null;
+    priority: number;
+    lastAccessTime: number;
+    size: number;
+}
+interface StreamingConfig {
+    chunkSize: number;
+    loadRadius: number;
+    unloadRadius: number;
+    maxConcurrentLoads: number;
+    memoryBudget: number;
+}
+declare class WorldStreamer {
+    private config;
+    private chunks;
+    private viewerPosition;
+    private totalMemory;
+    private loadQueue;
+    private activeLoads;
+    private chunkGenerator;
+    constructor(config?: Partial<StreamingConfig>);
+    setChunkGenerator(gen: (x: number, z: number) => Record<string, unknown>): void;
+    setViewerPosition(x: number, z: number): void;
+    update(): void;
+    private requestLoad;
+    private processLoadQueue;
+    private unloadChunk;
+    loadChunk(x: number, z: number): WorldChunk;
+    getChunk(x: number, z: number): WorldChunk | undefined;
+    getLoadedChunks(): WorldChunk[];
+    getLoadedCount(): number;
+    getTotalMemory(): number;
+    isOverBudget(): boolean;
+    getChunkSize(): number;
+}
+
+type index_AABB = AABB;
+type index_ChunkState = ChunkState;
+type index_CullableObject = CullableObject;
+type index_FrustumPlane = FrustumPlane;
+type index_LODConfig = LODConfig;
+type index_LODLevel = LODLevel;
+type index_LODManager = LODManager;
+declare const index_LODManager: typeof LODManager;
+type index_LODObject = LODObject;
+type index_OcclusionCulling = OcclusionCulling;
+declare const index_OcclusionCulling: typeof OcclusionCulling;
+type index_OcclusionPortal = OcclusionPortal;
+type index_OcclusionZone = OcclusionZone;
+type index_StreamingConfig = StreamingConfig;
+type index_WorldChunk = WorldChunk;
+type index_WorldStreamer = WorldStreamer;
+declare const index_WorldStreamer: typeof WorldStreamer;
+declare namespace index {
+  export { type index_AABB as AABB, type index_ChunkState as ChunkState, type index_CullableObject as CullableObject, type index_FrustumPlane as FrustumPlane, type index_LODConfig as LODConfig, type index_LODLevel as LODLevel, index_LODManager as LODManager, type index_LODObject as LODObject, index_OcclusionCulling as OcclusionCulling, type index_OcclusionPortal as OcclusionPortal, type index_OcclusionZone as OcclusionZone, type index_StreamingConfig as StreamingConfig, type index_WorldChunk as WorldChunk, index_WorldStreamer as WorldStreamer };
+}
+
+export { type AABB as A, type ChunkState as C, type FrustumPlane as F, type LODConfig as L, OcclusionCulling as O, type StreamingConfig as S, type WorldChunk as W, type CullableObject as a, type LODLevel as b, LODManager as c, type LODObject as d, type OcclusionPortal as e, type OcclusionZone as f, WorldStreamer as g, index as i };

package/dist/index-DfNLiAka.d.ts

@@ -0,0 +1,192 @@
+/**
+ * LODManager.ts
+ *
+ * Level-of-detail management: distance-based LOD selection,
+ * transition blending, hysteresis, and per-object bias config.
+ *
+ * @module world
+ */
+interface LODLevel {
+    level: number;
+    maxDistance: number;
+    meshDetail: number;
+}
+interface LODObject {
+    id: string;
+    position: [number, number, number];
+    currentLevel: number;
+    levels: LODLevel[];
+    bias: number;
+    visible: boolean;
+    transitionAlpha: number;
+}
+interface LODConfig {
+    defaultLevels: LODLevel[];
+    hysteresis: number;
+    transitionSpeed: number;
+    maxObjects: number;
+}
+declare class LODManager {
+    private config;
+    private objects;
+    private viewerPosition;
+    constructor(config?: Partial<LODConfig>);
+    register(id: string, position: [number, number, number], levels?: LODLevel[], bias?: number): LODObject;
+    unregister(id: string): boolean;
+    setViewerPosition(x: number, y: number, z: number): void;
+    update(dt: number): void;
+    getObject(id: string): LODObject | undefined;
+    getObjectCount(): number;
+    getLevelDistribution(): Map<number, number>;
+    getObjectsAtLevel(level: number): LODObject[];
+    getAverageLOD(): number;
+}
+
+/**
+ * OcclusionCulling.ts
+ *
+ * Visibility determination: frustum culling, AABB tests,
+ * portal-based occlusion, and query batching.
+ *
+ * @module world
+ */
+interface AABB {
+    min: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    max: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+interface FrustumPlane {
+    normal: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    distance: number;
+}
+interface CullableObject {
+    id: string;
+    bounds: AABB;
+    visible: boolean;
+    lastTestFrame: number;
+    layer: number;
+}
+interface OcclusionPortal {
+    id: string;
+    bounds: AABB;
+    connectedZones: [string, string];
+    open: boolean;
+}
+interface OcclusionZone {
+    id: string;
+    bounds: AABB;
+    objects: string[];
+}
+declare class OcclusionCulling {
+    private objects;
+    private zones;
+    private portals;
+    private frustumPlanes;
+    private currentFrame;
+    private visibleCount;
+    private culledCount;
+    private layerMask;
+    register(id: string, bounds: AABB, layer?: number): CullableObject;
+    unregister(id: string): boolean;
+    updateBounds(id: string, bounds: AABB): void;
+    addZone(id: string, bounds: AABB, objectIds?: string[]): void;
+    addPortal(id: string, bounds: AABB, zone1: string, zone2: string): void;
+    setPortalOpen(id: string, open: boolean): void;
+    setFrustum(planes: FrustumPlane[]): void;
+    setLayerMask(mask: number): void;
+    performCulling(): void;
+    private isInFrustum;
+    testAABBOverlap(a: AABB, b: AABB): boolean;
+    queryRegion(region: AABB): CullableObject[];
+    getVisibleZones(startZone: string): string[];
+    getVisibleObjects(): CullableObject[];
+    getVisibleCount(): number;
+    getCulledCount(): number;
+    getTotalCount(): number;
+    getCullRatio(): number;
+    getCurrentFrame(): number;
+}
+
+/**
+ * WorldStreamer.ts
+ *
+ * Chunk-based world streaming: loading/unloading by distance,
+ * async chunk generation, seamless transitions, and memory budgets.
+ *
+ * @module world
+ */
+type ChunkState = 'unloaded' | 'loading' | 'loaded' | 'unloading';
+interface WorldChunk {
+    id: string;
+    x: number;
+    z: number;
+    state: ChunkState;
+    data: Record<string, unknown> | null;
+    priority: number;
+    lastAccessTime: number;
+    size: number;
+}
+interface StreamingConfig {
+    chunkSize: number;
+    loadRadius: number;
+    unloadRadius: number;
+    maxConcurrentLoads: number;
+    memoryBudget: number;
+}
+declare class WorldStreamer {
+    private config;
+    private chunks;
+    private viewerPosition;
+    private totalMemory;
+    private loadQueue;
+    private activeLoads;
+    private chunkGenerator;
+    constructor(config?: Partial<StreamingConfig>);
+    setChunkGenerator(gen: (x: number, z: number) => Record<string, unknown>): void;
+    setViewerPosition(x: number, z: number): void;
+    update(): void;
+    private requestLoad;
+    private processLoadQueue;
+    private unloadChunk;
+    loadChunk(x: number, z: number): WorldChunk;
+    getChunk(x: number, z: number): WorldChunk | undefined;
+    getLoadedChunks(): WorldChunk[];
+    getLoadedCount(): number;
+    getTotalMemory(): number;
+    isOverBudget(): boolean;
+    getChunkSize(): number;
+}
+
+type index_AABB = AABB;
+type index_ChunkState = ChunkState;
+type index_CullableObject = CullableObject;
+type index_FrustumPlane = FrustumPlane;
+type index_LODConfig = LODConfig;
+type index_LODLevel = LODLevel;
+type index_LODManager = LODManager;
+declare const index_LODManager: typeof LODManager;
+type index_LODObject = LODObject;
+type index_OcclusionCulling = OcclusionCulling;
+declare const index_OcclusionCulling: typeof OcclusionCulling;
+type index_OcclusionPortal = OcclusionPortal;
+type index_OcclusionZone = OcclusionZone;
+type index_StreamingConfig = StreamingConfig;
+type index_WorldChunk = WorldChunk;
+type index_WorldStreamer = WorldStreamer;
+declare const index_WorldStreamer: typeof WorldStreamer;
+declare namespace index {
+  export { type index_AABB as AABB, type index_ChunkState as ChunkState, type index_CullableObject as CullableObject, type index_FrustumPlane as FrustumPlane, type index_LODConfig as LODConfig, type index_LODLevel as LODLevel, index_LODManager as LODManager, type index_LODObject as LODObject, index_OcclusionCulling as OcclusionCulling, type index_OcclusionPortal as OcclusionPortal, type index_OcclusionZone as OcclusionZone, type index_StreamingConfig as StreamingConfig, type index_WorldChunk as WorldChunk, index_WorldStreamer as WorldStreamer };
+}
+
+export { type AABB as A, type ChunkState as C, type FrustumPlane as F, type LODConfig as L, OcclusionCulling as O, type StreamingConfig as S, type WorldChunk as W, type CullableObject as a, type LODLevel as b, LODManager as c, type LODObject as d, type OcclusionPortal as e, type OcclusionZone as f, WorldStreamer as g, index as i };