@ifc-lite/renderer 1.6.1 → 1.8.0

package/README.md

@@ -0,0 +1,40 @@
+# @ifc-lite/renderer
+
+WebGPU-based 3D rendering engine for IFClite. Provides GPU-accelerated rendering with depth testing, frustum culling, and zero-copy WASM-to-GPU data transfer.
+
+## Installation
+
+```bash
+npm install @ifc-lite/renderer
+```
+
+## Quick Start
+
+```typescript
+import { Renderer } from '@ifc-lite/renderer';
+
+const renderer = new Renderer(canvas);
+await renderer.init();
+
+renderer.loadGeometry(geometryData);
+renderer.fitToView();
+renderer.render();
+```
+
+## Features
+
+- WebGPU rendering with depth testing and frustum culling
+- Zero-copy transfer from WASM linear memory to GPU buffers
+- Section planes for cross-section views
+- 3D measurements with snap-to-edge
+- Entity picking via GPU ray casting
+- Multi-model federation support (FederationRegistry)
+- Per-entity visibility and color override
+
+## API
+
+See the [Rendering Guide](../../docs/guide/rendering.md) and [API Reference](../../docs/api/typescript.md#ifc-literenderer).
+
+## License
+
+[MPL-2.0](../../LICENSE)

package/dist/camera-animation.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Camera animation system handling tweened transitions, inertia/momentum,
+ * preset views, and first-person mode.
+ * Extracted from Camera class using composition pattern.
+ */
+import type { Vec3 } from './types.js';
+import type { CameraInternalState } from './camera-controls.js';
+import type { CameraControls } from './camera-controls.js';
+import type { CameraProjection } from './camera-projection.js';
+/**
+ * Manages camera animations: tweened transitions between positions,
+ * inertia/momentum after user interaction, preset view switching
+ * with rotation cycling, and first-person movement.
+ */
+export declare class CameraAnimator {
+    private readonly state;
+    private readonly updateMatrices;
+    private readonly controls;
+    private readonly projection;
+    private velocity;
+    private damping;
+    private minVelocity;
+    private animationStartTime;
+    private animationDuration;
+    private animationStartPos;
+    private animationStartTarget;
+    private animationEndPos;
+    private animationEndTarget;
+    private animationStartUp;
+    private animationEndUp;
+    private animationEasing;
+    private isFirstPersonMode;
+    private firstPersonSpeed;
+    private lastPresetView;
+    private presetViewRotation;
+    constructor(state: CameraInternalState, updateMatrices: () => void, controls: CameraControls, projection: CameraProjection);
+    addOrbitVelocity(deltaX: number, deltaY: number): void;
+    addPanVelocity(deltaX: number, deltaY: number, panSpeed: number): void;
+    addZoomVelocity(normalizedDelta: number): void;
+    /**
+     * Reset preset view tracking (called when user orbits)
+     */
+    resetPresetTracking(): void;
+    /**
+     * Update camera animation and inertia
+     * Returns true if camera is still animating
+     */
+    update(_deltaTime: number): boolean;
+    /**
+     * Animate camera to fit bounds (southeast isometric view)
+     * Y-up coordinate system
+     */
+    zoomToFit(min: Vec3, max: Vec3, duration?: number): Promise<void>;
+    /**
+     * Frame/center view on a point (keeps current distance and direction)
+     * Standard CAD "Frame Selection" behavior
+     */
+    framePoint(point: Vec3, duration?: number): Promise<void>;
+    /**
+     * Frame selection - zoom to fit bounds while keeping current view direction
+     * This is what "Frame Selection" should do - zoom to fill screen
+     */
+    frameBounds(min: Vec3, max: Vec3, duration?: number): Promise<void>;
+    zoomExtent(min: Vec3, max: Vec3, duration?: number): Promise<void>;
+    /**
+     * Animate camera to position and target
+     */
+    animateTo(endPos: Vec3, endTarget: Vec3, duration?: number): Promise<void>;
+    /**
+     * Animate camera to position, target, and up vector (for orthogonal preset views)
+     */
+    animateToWithUp(endPos: Vec3, endTarget: Vec3, endUp: Vec3, duration?: number): Promise<void>;
+    /**
+     * Easing function: easeOutCubic
+     */
+    private easeOutCubic;
+    /**
+     * Set first-person mode
+     */
+    enableFirstPersonMode(enabled: boolean): void;
+    /**
+     * Move in first-person mode (Y-up coordinate system)
+     */
+    moveFirstPerson(forward: number, right: number, up: number): void;
+    /**
+     * Set preset view with explicit bounds (Y-up coordinate system)
+     * Clicking the same view again rotates 90 degrees around the view axis
+     * @param buildingRotation Optional building rotation in radians (from IfcSite placement)
+     */
+    setPresetView(view: 'top' | 'bottom' | 'front' | 'back' | 'left' | 'right', bounds?: {
+        min: Vec3;
+        max: Vec3;
+    }, buildingRotation?: number): void;
+    /**
+     * Get current bounds estimate (simplified - in production would use scene bounds)
+     */
+    private getCurrentBounds;
+    /**
+     * Reset velocity (stop inertia)
+     */
+    stopInertia(): void;
+    /**
+     * Reset camera animation state (clear inertia, cancel animations, reset preset tracking)
+     * Called when loading a new model to ensure clean state
+     */
+    reset(): void;
+}
+//# sourceMappingURL=camera-animation.d.ts.map

package/dist/camera-animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-animation.d.ts","sourceRoot":"","sources":["../src/camera-animation.ts"],"names":[],"mappings":"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"}