@holoscript/engine 6.0.3 → 6.0.4

package/dist/index-BJV21zuy.d.cts

@@ -0,0 +1,341 @@
+/**
+ * TerrainBrush — Sculpting brushes (raise/lower/smooth/flatten/paint)
+ *
+ * Applies heightmap modifications with configurable radius, strength,
+ * and falloff curves.
+ *
+ * @version 1.0.0
+ */
+type BrushMode = 'raise' | 'lower' | 'smooth' | 'flatten' | 'paint' | 'erode';
+type FalloffCurve = 'linear' | 'smooth' | 'sphere' | 'tip' | 'flat';
+interface BrushConfig {
+    mode: BrushMode;
+    radius: number;
+    strength: number;
+    falloff: FalloffCurve;
+    opacity: number;
+}
+interface TerrainCell {
+    height: number;
+    paintLayer: number;
+    locked: boolean;
+}
+declare class TerrainBrush {
+    private grid;
+    private strokes;
+    private undoStack;
+    private config;
+    private gridSize;
+    constructor(gridSize?: number, config?: Partial<BrushConfig>);
+    /**
+     * Apply brush at a position
+     */
+    apply(cx: number, cz: number, overrides?: Partial<BrushConfig>): number;
+    /**
+     * Paint a layer at a position
+     */
+    paint(cx: number, cz: number, layerIndex: number): number;
+    /**
+     * Undo last stroke
+     */
+    undo(): boolean;
+    /**
+     * Get height at a grid position
+     */
+    getHeight(x: number, z: number): number;
+    /**
+     * Get cell data
+     */
+    getCell(x: number, z: number): TerrainCell | undefined;
+    /**
+     * Lock/unlock cells
+     */
+    setLocked(x: number, z: number, locked: boolean): void;
+    /**
+     * Get current config
+     */
+    getConfig(): BrushConfig;
+    /**
+     * Set config
+     */
+    setConfig(cfg: Partial<BrushConfig>): void;
+    /**
+     * Get stroke count
+     */
+    getStrokeCount(): number;
+    /**
+     * Get grid size
+     */
+    getGridSize(): number;
+    /**
+     * Get undo count
+     */
+    getUndoCount(): number;
+    /**
+     * Get height range
+     */
+    getHeightRange(): {
+        min: number;
+        max: number;
+    };
+}
+
+/**
+ * TerrainLOD.ts
+ *
+ * Quadtree-based terrain LOD: distance-based chunking,
+ * seamless stitching, morph factors, and streaming.
+ *
+ * @module terrain
+ */
+interface TerrainChunk {
+    id: string;
+    level: number;
+    x: number;
+    z: number;
+    size: number;
+    resolution: number;
+    heightData: Float32Array;
+    morphFactor: number;
+    active: boolean;
+    children: string[];
+}
+interface TerrainLODConfig {
+    totalSize: number;
+    maxLOD: number;
+    baseResolution: number;
+    lodDistances: number[];
+    morphRange: number;
+}
+declare class TerrainLOD {
+    private config;
+    private chunks;
+    private activeChunks;
+    constructor(config?: Partial<TerrainLODConfig>);
+    generateQuadtree(heightSampler: (x: number, z: number) => number): void;
+    private subdivide;
+    selectLOD(cameraX: number, cameraZ: number): void;
+    getStitchEdges(chunkId: string): {
+        north: boolean;
+        south: boolean;
+        east: boolean;
+        west: boolean;
+    };
+    private overlapsX;
+    private overlapsZ;
+    getChunk(id: string): TerrainChunk | undefined;
+    getActiveChunks(): TerrainChunk[];
+    getActiveChunkCount(): number;
+    getTotalChunkCount(): number;
+    sampleHeight(x: number, z: number): number;
+}
+
+/**
+ * TerrainPaintLayer — Splat map layers for terrain texturing
+ *
+ * Manages per-vertex paint weights across multiple texture layers
+ * with blending, undo, and normalization.
+ *
+ * @version 1.0.0
+ */
+interface PaintLayer {
+    id: string;
+    name: string;
+    textureId: string;
+    tiling: number;
+    metallic: number;
+    roughness: number;
+}
+declare class TerrainPaintLayer {
+    private layers;
+    private splatMap;
+    private gridSize;
+    private undoStack;
+    constructor(gridSize?: number);
+    /**
+     * Add a texture layer
+     */
+    addLayer(layer: PaintLayer): number;
+    /**
+     * Remove a layer by index
+     */
+    removeLayer(index: number): boolean;
+    /**
+     * Paint a layer at a position with given weight
+     */
+    paintAt(x: number, z: number, layerIndex: number, weight: number, radius?: number): number;
+    /**
+     * Get weights at a position
+     */
+    getWeights(x: number, z: number): number[];
+    /**
+     * Get dominant layer at a position
+     */
+    getDominantLayer(x: number, z: number): number;
+    /**
+     * Undo last paint operation
+     */
+    undo(): boolean;
+    /**
+     * Normalize weights to sum to 1
+     */
+    private normalizeWeights;
+    /**
+     * Get layer definitions
+     */
+    getLayers(): PaintLayer[];
+    getLayerCount(): number;
+    getUndoCount(): number;
+}
+
+/**
+ * TerrainTexturing.ts
+ *
+ * Splatmap blending: multi-layer texturing, triplanar mapping,
+ * detail layers, and texture weights.
+ *
+ * @module terrain
+ */
+interface TerrainLayer {
+    id: string;
+    textureId: string;
+    normalMapId?: string;
+    tiling: {
+        x: number;
+        y: number;
+    };
+    metallic: number;
+    roughness: number;
+    heightBlend: boolean;
+}
+interface SplatmapData {
+    width: number;
+    height: number;
+    channels: Float32Array[];
+}
+interface TriplanarConfig {
+    sharpness: number;
+    tiling: number;
+    enabled: boolean;
+}
+declare class TerrainTexturing {
+    private layers;
+    private splatmap;
+    private triplanar;
+    private detailLayers;
+    addLayer(layer: TerrainLayer): void;
+    getLayer(index: number): TerrainLayer | undefined;
+    getLayerCount(): number;
+    removeLayer(id: string): void;
+    createSplatmap(width: number, height: number, channelCount?: number): SplatmapData;
+    paintSplatmap(channel: number, x: number, z: number, radius: number, strength: number, _heightMap?: Float32Array): void;
+    private normalizeSplatAt;
+    getSplatWeights(x: number, z: number): number[];
+    setTriplanar(config: Partial<TriplanarConfig>): void;
+    getTriplanar(): TriplanarConfig;
+    computeTriplanarWeights(normal: {
+        x: number;
+        y: number;
+        z: number;
+    }): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    addDetailLayer(layerIndex: number, distance: number, tiling: number): void;
+    getDetailLayers(): typeof this.detailLayers;
+}
+
+/**
+ * ErosionBrush — Interactive hydraulic/thermal erosion brushes
+ *
+ * Applies localized erosion simulation as a painting tool.
+ *
+ * @version 1.0.0
+ */
+type ErosionType = 'hydraulic' | 'thermal' | 'wind';
+interface ErosionConfig$1 {
+    type: ErosionType;
+    radius: number;
+    strength: number;
+    iterations: number;
+    sedimentCapacity: number;
+    thermalAngle: number;
+}
+interface ErosionResult$1 {
+    cellsAffected: number;
+    totalErosion: number;
+    totalDeposition: number;
+    iterations: number;
+}
+declare class ErosionBrush {
+    private heightmap;
+    private config;
+    private gridSize;
+    constructor(gridSize?: number, config?: Partial<ErosionConfig$1>);
+    /**
+     * Set heightmap data
+     */
+    setHeight(x: number, z: number, h: number): void;
+    getHeight(x: number, z: number): number;
+    /**
+     * Apply erosion at a center position
+     */
+    erode(cx: number, cz: number, overrides?: Partial<ErosionConfig$1>): ErosionResult$1;
+    private getNeighborHeights;
+    getConfig(): ErosionConfig$1;
+    setConfig(cfg: Partial<ErosionConfig$1>): void;
+    getGridSize(): number;
+}
+
+/**
+ * ErosionSim.ts
+ *
+ * Terrain erosion: hydraulic erosion (raindrop simulation),
+ * thermal erosion, sediment transport, and iteration control.
+ *
+ * @module terrain
+ */
+interface ErosionConfig {
+    iterations: number;
+    rainAmount: number;
+    solubility: number;
+    evaporationRate: number;
+    depositionRate: number;
+    gravity: number;
+    thermalAngle: number;
+    thermalRate: number;
+    seed: number;
+}
+interface ErosionResult {
+    totalEroded: number;
+    totalDeposited: number;
+    iterations: number;
+    maxDepthChange: number;
+}
+declare class ErosionSim {
+    private config;
+    constructor(config?: Partial<ErosionConfig>);
+    hydraulicErode(heightmap: Float32Array, width: number, height: number): ErosionResult;
+    thermalErode(heightmap: Float32Array, width: number, height: number, iterations?: number): ErosionResult;
+    setConfig(config: Partial<ErosionConfig>): void;
+    getConfig(): ErosionConfig;
+}
+
+type index_ErosionBrush = ErosionBrush;
+declare const index_ErosionBrush: typeof ErosionBrush;
+type index_ErosionSim = ErosionSim;
+declare const index_ErosionSim: typeof ErosionSim;
+type index_TerrainBrush = TerrainBrush;
+declare const index_TerrainBrush: typeof TerrainBrush;
+type index_TerrainLOD = TerrainLOD;
+declare const index_TerrainLOD: typeof TerrainLOD;
+type index_TerrainPaintLayer = TerrainPaintLayer;
+declare const index_TerrainPaintLayer: typeof TerrainPaintLayer;
+type index_TerrainTexturing = TerrainTexturing;
+declare const index_TerrainTexturing: typeof TerrainTexturing;
+declare namespace index {
+  export { index_ErosionBrush as ErosionBrush, index_ErosionSim as ErosionSim, index_TerrainBrush as TerrainBrush, index_TerrainLOD as TerrainLOD, index_TerrainPaintLayer as TerrainPaintLayer, index_TerrainTexturing as TerrainTexturing };
+}
+
+export { ErosionBrush as E, TerrainBrush as T, ErosionSim as a, TerrainLOD as b, TerrainPaintLayer as c, TerrainTexturing as d, index as i };

package/dist/index-BJV21zuy.d.ts

@@ -0,0 +1,341 @@
+/**
+ * TerrainBrush — Sculpting brushes (raise/lower/smooth/flatten/paint)
+ *
+ * Applies heightmap modifications with configurable radius, strength,
+ * and falloff curves.
+ *
+ * @version 1.0.0
+ */
+type BrushMode = 'raise' | 'lower' | 'smooth' | 'flatten' | 'paint' | 'erode';
+type FalloffCurve = 'linear' | 'smooth' | 'sphere' | 'tip' | 'flat';
+interface BrushConfig {
+    mode: BrushMode;
+    radius: number;
+    strength: number;
+    falloff: FalloffCurve;
+    opacity: number;
+}
+interface TerrainCell {
+    height: number;
+    paintLayer: number;
+    locked: boolean;
+}
+declare class TerrainBrush {
+    private grid;
+    private strokes;
+    private undoStack;
+    private config;
+    private gridSize;
+    constructor(gridSize?: number, config?: Partial<BrushConfig>);
+    /**
+     * Apply brush at a position
+     */
+    apply(cx: number, cz: number, overrides?: Partial<BrushConfig>): number;
+    /**
+     * Paint a layer at a position
+     */
+    paint(cx: number, cz: number, layerIndex: number): number;
+    /**
+     * Undo last stroke
+     */
+    undo(): boolean;
+    /**
+     * Get height at a grid position
+     */
+    getHeight(x: number, z: number): number;
+    /**
+     * Get cell data
+     */
+    getCell(x: number, z: number): TerrainCell | undefined;
+    /**
+     * Lock/unlock cells
+     */
+    setLocked(x: number, z: number, locked: boolean): void;
+    /**
+     * Get current config
+     */
+    getConfig(): BrushConfig;
+    /**
+     * Set config
+     */
+    setConfig(cfg: Partial<BrushConfig>): void;
+    /**
+     * Get stroke count
+     */
+    getStrokeCount(): number;
+    /**
+     * Get grid size
+     */
+    getGridSize(): number;
+    /**
+     * Get undo count
+     */
+    getUndoCount(): number;
+    /**
+     * Get height range
+     */
+    getHeightRange(): {
+        min: number;
+        max: number;
+    };
+}
+
+/**
+ * TerrainLOD.ts
+ *
+ * Quadtree-based terrain LOD: distance-based chunking,
+ * seamless stitching, morph factors, and streaming.
+ *
+ * @module terrain
+ */
+interface TerrainChunk {
+    id: string;
+    level: number;
+    x: number;
+    z: number;
+    size: number;
+    resolution: number;
+    heightData: Float32Array;
+    morphFactor: number;
+    active: boolean;
+    children: string[];
+}
+interface TerrainLODConfig {
+    totalSize: number;
+    maxLOD: number;
+    baseResolution: number;
+    lodDistances: number[];
+    morphRange: number;
+}
+declare class TerrainLOD {
+    private config;
+    private chunks;
+    private activeChunks;
+    constructor(config?: Partial<TerrainLODConfig>);
+    generateQuadtree(heightSampler: (x: number, z: number) => number): void;
+    private subdivide;
+    selectLOD(cameraX: number, cameraZ: number): void;
+    getStitchEdges(chunkId: string): {
+        north: boolean;
+        south: boolean;
+        east: boolean;
+        west: boolean;
+    };
+    private overlapsX;
+    private overlapsZ;
+    getChunk(id: string): TerrainChunk | undefined;
+    getActiveChunks(): TerrainChunk[];
+    getActiveChunkCount(): number;
+    getTotalChunkCount(): number;
+    sampleHeight(x: number, z: number): number;
+}
+
+/**
+ * TerrainPaintLayer — Splat map layers for terrain texturing
+ *
+ * Manages per-vertex paint weights across multiple texture layers
+ * with blending, undo, and normalization.
+ *
+ * @version 1.0.0
+ */
+interface PaintLayer {
+    id: string;
+    name: string;
+    textureId: string;
+    tiling: number;
+    metallic: number;
+    roughness: number;
+}
+declare class TerrainPaintLayer {
+    private layers;
+    private splatMap;
+    private gridSize;
+    private undoStack;
+    constructor(gridSize?: number);
+    /**
+     * Add a texture layer
+     */
+    addLayer(layer: PaintLayer): number;
+    /**
+     * Remove a layer by index
+     */
+    removeLayer(index: number): boolean;
+    /**
+     * Paint a layer at a position with given weight
+     */
+    paintAt(x: number, z: number, layerIndex: number, weight: number, radius?: number): number;
+    /**
+     * Get weights at a position
+     */
+    getWeights(x: number, z: number): number[];
+    /**
+     * Get dominant layer at a position
+     */
+    getDominantLayer(x: number, z: number): number;
+    /**
+     * Undo last paint operation
+     */
+    undo(): boolean;
+    /**
+     * Normalize weights to sum to 1
+     */
+    private normalizeWeights;
+    /**
+     * Get layer definitions
+     */
+    getLayers(): PaintLayer[];
+    getLayerCount(): number;
+    getUndoCount(): number;
+}
+
+/**
+ * TerrainTexturing.ts
+ *
+ * Splatmap blending: multi-layer texturing, triplanar mapping,
+ * detail layers, and texture weights.
+ *
+ * @module terrain
+ */
+interface TerrainLayer {
+    id: string;
+    textureId: string;
+    normalMapId?: string;
+    tiling: {
+        x: number;
+        y: number;
+    };
+    metallic: number;
+    roughness: number;
+    heightBlend: boolean;
+}
+interface SplatmapData {
+    width: number;
+    height: number;
+    channels: Float32Array[];
+}
+interface TriplanarConfig {
+    sharpness: number;
+    tiling: number;
+    enabled: boolean;
+}
+declare class TerrainTexturing {
+    private layers;
+    private splatmap;
+    private triplanar;
+    private detailLayers;
+    addLayer(layer: TerrainLayer): void;
+    getLayer(index: number): TerrainLayer | undefined;
+    getLayerCount(): number;
+    removeLayer(id: string): void;
+    createSplatmap(width: number, height: number, channelCount?: number): SplatmapData;
+    paintSplatmap(channel: number, x: number, z: number, radius: number, strength: number, _heightMap?: Float32Array): void;
+    private normalizeSplatAt;
+    getSplatWeights(x: number, z: number): number[];
+    setTriplanar(config: Partial<TriplanarConfig>): void;
+    getTriplanar(): TriplanarConfig;
+    computeTriplanarWeights(normal: {
+        x: number;
+        y: number;
+        z: number;
+    }): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    addDetailLayer(layerIndex: number, distance: number, tiling: number): void;
+    getDetailLayers(): typeof this.detailLayers;
+}
+
+/**
+ * ErosionBrush — Interactive hydraulic/thermal erosion brushes
+ *
+ * Applies localized erosion simulation as a painting tool.
+ *
+ * @version 1.0.0
+ */
+type ErosionType = 'hydraulic' | 'thermal' | 'wind';
+interface ErosionConfig$1 {
+    type: ErosionType;
+    radius: number;
+    strength: number;
+    iterations: number;
+    sedimentCapacity: number;
+    thermalAngle: number;
+}
+interface ErosionResult$1 {
+    cellsAffected: number;
+    totalErosion: number;
+    totalDeposition: number;
+    iterations: number;
+}
+declare class ErosionBrush {
+    private heightmap;
+    private config;
+    private gridSize;
+    constructor(gridSize?: number, config?: Partial<ErosionConfig$1>);
+    /**
+     * Set heightmap data
+     */
+    setHeight(x: number, z: number, h: number): void;
+    getHeight(x: number, z: number): number;
+    /**
+     * Apply erosion at a center position
+     */
+    erode(cx: number, cz: number, overrides?: Partial<ErosionConfig$1>): ErosionResult$1;
+    private getNeighborHeights;
+    getConfig(): ErosionConfig$1;
+    setConfig(cfg: Partial<ErosionConfig$1>): void;
+    getGridSize(): number;
+}
+
+/**
+ * ErosionSim.ts
+ *
+ * Terrain erosion: hydraulic erosion (raindrop simulation),
+ * thermal erosion, sediment transport, and iteration control.
+ *
+ * @module terrain
+ */
+interface ErosionConfig {
+    iterations: number;
+    rainAmount: number;
+    solubility: number;
+    evaporationRate: number;
+    depositionRate: number;
+    gravity: number;
+    thermalAngle: number;
+    thermalRate: number;
+    seed: number;
+}
+interface ErosionResult {
+    totalEroded: number;
+    totalDeposited: number;
+    iterations: number;
+    maxDepthChange: number;
+}
+declare class ErosionSim {
+    private config;
+    constructor(config?: Partial<ErosionConfig>);
+    hydraulicErode(heightmap: Float32Array, width: number, height: number): ErosionResult;
+    thermalErode(heightmap: Float32Array, width: number, height: number, iterations?: number): ErosionResult;
+    setConfig(config: Partial<ErosionConfig>): void;
+    getConfig(): ErosionConfig;
+}
+
+type index_ErosionBrush = ErosionBrush;
+declare const index_ErosionBrush: typeof ErosionBrush;
+type index_ErosionSim = ErosionSim;
+declare const index_ErosionSim: typeof ErosionSim;
+type index_TerrainBrush = TerrainBrush;
+declare const index_TerrainBrush: typeof TerrainBrush;
+type index_TerrainLOD = TerrainLOD;
+declare const index_TerrainLOD: typeof TerrainLOD;
+type index_TerrainPaintLayer = TerrainPaintLayer;
+declare const index_TerrainPaintLayer: typeof TerrainPaintLayer;
+type index_TerrainTexturing = TerrainTexturing;
+declare const index_TerrainTexturing: typeof TerrainTexturing;
+declare namespace index {
+  export { index_ErosionBrush as ErosionBrush, index_ErosionSim as ErosionSim, index_TerrainBrush as TerrainBrush, index_TerrainLOD as TerrainLOD, index_TerrainPaintLayer as TerrainPaintLayer, index_TerrainTexturing as TerrainTexturing };
+}
+
+export { ErosionBrush as E, TerrainBrush as T, ErosionSim as a, TerrainLOD as b, TerrainPaintLayer as c, TerrainTexturing as d, index as i };