three-live 1.2.4 → 1.3.1

package/README.md

@@ -3,7 +3,7 @@
 Lightweight `<three-live>` web component for 3D, AR, and sandboxed procedural
 Three.js. Part of [Three-Live](https://github.com/google/three-live).
 
-> Developer Preview. APIs may change before a stable release.
+> Status: **Beta**. Minor API details may evolve before General Availability (GA).
 
 ## Install
 
@@ -46,7 +46,7 @@ display existing models only, use the viewer-only build:
 | :--- | :--- |
 | `dist/three-live-viewer.min.js` | Viewer only: `.glb` display, PBR, orbit controls, animation |
 | `dist/three-live.min.js` | Standard: viewer + sandboxed `<script type="text/three">` + AR handoff |
-| `dist/three-live-studio.min.js` | Add-on: PBR Next, HDRI/SH, `bloom`/`outline`, `KHR_materials_variants`, `EXT_meshopt_compression`, `KHR_interactivity` VM, hotspots |
+| `dist/three-live-studio.min.js` | Add-on: PBR Next, HDRI/SH, `bloom`/`outline`, `KHR_materials_variants`, `EXT_meshopt_compression`, `KHR_interactivity` VM, `lod` (`THREE.LOD` / `MSFT_lod`), hotspots |
 | `dist/three-live-cad.min.js` | Add-on: 2D `Path`/`Shape`, `ExtrudeGeometry`, 3D `CSG` Booleans, stroke-font `TextGeometry` |
 | `dist/three-live-animation.min.js` | Add-on: 64-joint skinning, morph targets, keyframe cross-fading, 2-bone/FABRIK `IKSolver` |
 | `dist/three-live-full.min.js` | Standard + all plugins (`studio`, `cad`, `animation`) |

package/dist/index.d.ts

@@ -87,6 +87,20 @@ export {
   type InteractivityValueSocket,
   type InteractivityVariableDef,
 } from './three-live/src/plugins/interactivity';
+export {
+  decimateGeometry,
+  getLodController,
+  installLodExtension,
+  LOD,
+  LodController,
+  lodPlugin,
+  materializeLodGeometry,
+  parseLod,
+  selectLodLevelIndex,
+  type LodGroupState,
+  type LodLevel,
+  type LodOptions,
+} from './three-live/src/plugins/lod';
 export {
   applyMeshoptFilter,
   decodeMeshoptBuffer,
@@ -130,6 +144,8 @@ export {
 } from './xr-live/src/xr-live-element';
 /** Optional spatial plugins (`xr-live/spatial`, `xr-live-spatial.min.js`). */
 export * from './xr-live/src/plugins/index';
+/** Optional simulation plugins (`xr-live/sim`, `xr-live-sim.min.js`). */
+export * from './xr-live/src/sim/index';
 
 /**
  * Declarative JSX / HTML attributes supported by the <three-live> custom element.
@@ -169,6 +185,18 @@ export interface ThreeLiveAttributes {
   'shadow-softness'?: number | string;
   /** Tone mapping mode ("neutral", "aces", "agx", "reinhard", "none"). */
   'tone-mapping'?: string;
+  /** Dual-Kawase bloom intensity (0.0 to 5.0). */
+  'bloom'?: number | string;
+  /** Luminance threshold for bloom extraction (default: 0.8). */
+  'bloom-threshold'?: number | string;
+  /** Blur radius multiplier for bloom passes (default: 0.5). */
+  'bloom-radius'?: number | string;
+  /** Declarative silhouette outline toggle or config. */
+  'outline'?: boolean | string;
+  /** Highlight the currently `selected-mesh` with a silhouette outline. */
+  'outline-selected'?: boolean | string;
+  /** Silhouette outline CSS hex color (default: "#38bdf8"). */
+  'outline-color'?: string;
   /** Enable or disable interactive camera orbit/pan/zoom controls (default: true). */
   'camera-controls'?: boolean | string;
   /** Automatically start keyframe animation playback. */
@@ -210,6 +238,16 @@ export interface ThreeLiveAttributes {
   // React 19 / JSX Event Listeners
   onload?: (e: CustomEvent<{model: GLBData}>) => void;
   onerror?: (e: CustomEvent<{error: any}>) => void;
+  'onthree-load'?: (
+    e: CustomEvent<{model: GLBData; source?: 'src' | 'model'}>,
+  ) => void;
+  'onthree-error'?: (
+    e: CustomEvent<{error: any; message: string; stage: string}>,
+  ) => void;
+  'onthree-context-lost'?: (e: CustomEvent<{originalEvent?: Event}>) => void;
+  'onthree-context-restored'?: (
+    e: CustomEvent<{originalEvent?: Event}>,
+  ) => void;
   onmeshclick?: (e: CustomEvent<HitDetail>) => void;
   'oncamera-change'?: (e: CustomEvent<CameraDetail>) => void;
   'onvariant-applied'?: (e: CustomEvent<{variantName: string | null}>) => void;
@@ -427,7 +465,27 @@ export interface XRLiveAttributes extends ThreeLiveAttributes {
       sdpMLineIndex: number | null;
     }>,
   ) => void;
+  onxraudioplay?: (
+    e: CustomEvent<{
+      node: string;
+      meshIndex: number;
+      preset: string | null;
+      src: string | null;
+      gain: number;
+      pan: number;
+      triggerCount: number;
+    }>,
+  ) => void;
   /** xr-live-sim events. */
+  onxrcollision?: (
+    e: CustomEvent<{
+      nodeId: string;
+      otherId: string;
+      normal: [number, number, number];
+      impactSpeed: number;
+    }>,
+  ) => void;
+  onxrsleep?: (e: CustomEvent<{nodeId: string}>) => void;
   oncharacterjump?: (
     e: CustomEvent<{nodeId: string; position: [number, number, number]}>,
   ) => void;