@kibee/renderer-three 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -3,6 +3,7 @@ import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
 
 type BeeVisualState = "idle" | "guiding" | "thinking" | "celebrating";
 type BeeAssetVariant = "hero" | "runtime";
+type BeeAvatarPreset = "bee" | "orb" | "ring";
 type BeeQualityTier = "auto" | "high" | "balanced" | "low";
 type BeeMotionMode = "auto" | "full" | "reduced";
 
@@ -35,6 +36,7 @@ interface DockMotionOptions {
 }
 interface ThreeBeeRendererOptions {
     assetUrl?: string;
+    avatarPreset?: BeeAvatarPreset;
     assetVariant?: BeeAssetVariant;
     qualityTier?: BeeQualityTier;
     enableShadows?: boolean;
@@ -190,6 +192,8 @@ declare class ThreeBeeRenderer implements BeeRenderer {
     private createRenderer;
     private createLights;
     private loadBeeModel;
+    private createPresetAvatar;
+    private clearVisualRig;
     private createFallbackBee;
     private initializeDockedHome;
     private startRenderLoop;
@@ -275,4 +279,4 @@ declare class ThreeBeeRenderer implements BeeRenderer {
 
 declare function applyLegacyBeeMaterialCompat(gltf: GLTF): Promise<void>;
 
-export { type BeeActionChoice, type BeeActionHandler, type BeeAssetVariant, type BeeDockClickBehavior, type BeeDockPosition, type BeeDockVariant, type BeeMotionMode, type BeeQualityTier, type BeeRenderer, type BeeVisualState, type DockMotionOptions, type MoveToOptions, type PromptOptions, type SetCustomDockPositionOptions, type SpeakOptions, ThreeBeeRenderer, type ThreeBeeRendererOptions, type TooltipArrowEdge, applyLegacyBeeMaterialCompat };
+export { type BeeActionChoice, type BeeActionHandler, type BeeAssetVariant, type BeeAvatarPreset, type BeeDockClickBehavior, type BeeDockPosition, type BeeDockVariant, type BeeMotionMode, type BeeQualityTier, type BeeRenderer, type BeeVisualState, type DockMotionOptions, type MoveToOptions, type PromptOptions, type SetCustomDockPositionOptions, type SpeakOptions, ThreeBeeRenderer, type ThreeBeeRendererOptions, type TooltipArrowEdge, applyLegacyBeeMaterialCompat };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
 
 type BeeVisualState = "idle" | "guiding" | "thinking" | "celebrating";
 type BeeAssetVariant = "hero" | "runtime";
+type BeeAvatarPreset = "bee" | "orb" | "ring";
 type BeeQualityTier = "auto" | "high" | "balanced" | "low";
 type BeeMotionMode = "auto" | "full" | "reduced";
 
@@ -35,6 +36,7 @@ interface DockMotionOptions {
 }
 interface ThreeBeeRendererOptions {
     assetUrl?: string;
+    avatarPreset?: BeeAvatarPreset;
     assetVariant?: BeeAssetVariant;
     qualityTier?: BeeQualityTier;
     enableShadows?: boolean;
@@ -190,6 +192,8 @@ declare class ThreeBeeRenderer implements BeeRenderer {
     private createRenderer;
     private createLights;
     private loadBeeModel;
+    private createPresetAvatar;
+    private clearVisualRig;
     private createFallbackBee;
     private initializeDockedHome;
     private startRenderLoop;
@@ -275,4 +279,4 @@ declare class ThreeBeeRenderer implements BeeRenderer {
 
 declare function applyLegacyBeeMaterialCompat(gltf: GLTF): Promise<void>;
 
-export { type BeeActionChoice, type BeeActionHandler, type BeeAssetVariant, type BeeDockClickBehavior, type BeeDockPosition, type BeeDockVariant, type BeeMotionMode, type BeeQualityTier, type BeeRenderer, type BeeVisualState, type DockMotionOptions, type MoveToOptions, type PromptOptions, type SetCustomDockPositionOptions, type SpeakOptions, ThreeBeeRenderer, type ThreeBeeRendererOptions, type TooltipArrowEdge, applyLegacyBeeMaterialCompat };
+export { type BeeActionChoice, type BeeActionHandler, type BeeAssetVariant, type BeeAvatarPreset, type BeeDockClickBehavior, type BeeDockPosition, type BeeDockVariant, type BeeMotionMode, type BeeQualityTier, type BeeRenderer, type BeeVisualState, type DockMotionOptions, type MoveToOptions, type PromptOptions, type SetCustomDockPositionOptions, type SpeakOptions, ThreeBeeRenderer, type ThreeBeeRendererOptions, type TooltipArrowEdge, applyLegacyBeeMaterialCompat };

package/dist/index.js

@@ -959,6 +959,11 @@ var ThreeBeeRenderer = class {
     this.scene.add(ambient, hemisphere, key, fill, rim);
   }
   async loadBeeModel() {
+    const preset = this.options.avatarPreset ?? "bee";
+    if (preset === "orb" || preset === "ring") {
+      this.createPresetAvatar(preset);
+      return true;
+    }
     try {
       const loader = new import_GLTFLoader.GLTFLoader();
       registerPbrSpecularGlossinessGLTFPlugin(loader);
@@ -1019,9 +1024,69 @@ var ThreeBeeRenderer = class {
       this.updateBeeScreenPosition();
       return true;
     } catch {
+      if (this.options.assetUrl) {
+        this.createPresetAvatar("orb");
+        return true;
+      }
       return false;
     }
   }
+  createPresetAvatar(preset) {
+    this.runtimeWings = null;
+    this.clearVisualRig();
+    if (preset === "orb") {
+      const orbMaterial = new THREE2.MeshPhysicalMaterial({
+        color: 13228274,
+        roughness: 0.28,
+        metalness: 0.04,
+        clearcoat: 0.45,
+        emissive: 9087192,
+        emissiveIntensity: 0.18
+      });
+      const orb = new THREE2.Mesh(new THREE2.SphereGeometry(14, 32, 32), orbMaterial);
+      this.visualRig.add(orb);
+    } else {
+      const ringMaterial = new THREE2.MeshPhysicalMaterial({
+        color: 13943976,
+        transparent: true,
+        opacity: 0.72,
+        roughness: 0.12,
+        metalness: 0.02,
+        side: THREE2.DoubleSide
+      });
+      const ring = new THREE2.Mesh(new THREE2.TorusGeometry(16, 2.4, 16, 64), ringMaterial);
+      ring.rotation.x = Math.PI / 2.3;
+      const core = new THREE2.Mesh(
+        new THREE2.SphereGeometry(6, 24, 24),
+        new THREE2.MeshPhysicalMaterial({
+          color: 15787730,
+          roughness: 0.34,
+          metalness: 0.05
+        })
+      );
+      this.visualRig.add(ring, core);
+    }
+    this.applyHomeFacing(true);
+    this.updateBeeScreenPosition();
+  }
+  clearVisualRig() {
+    while (this.visualRig.children.length > 0) {
+      const child = this.visualRig.children[0];
+      this.visualRig.remove(child);
+      child.traverse((node) => {
+        if (node instanceof THREE2.Mesh) {
+          node.geometry?.dispose();
+          const materials = Array.isArray(node.material) ? node.material : [node.material];
+          for (const material of materials) {
+            material.dispose();
+          }
+        }
+      });
+    }
+    this.mixer = null;
+    this.actions.clear();
+    this.activeActionName = null;
+  }
   createFallbackBee() {
     this.runtimeWings = null;
     const bodyMaterial = new THREE2.MeshStandardMaterial({ color: 13867825 });

package/dist/index.mjs

@@ -922,6 +922,11 @@ var ThreeBeeRenderer = class {
     this.scene.add(ambient, hemisphere, key, fill, rim);
   }
   async loadBeeModel() {
+    const preset = this.options.avatarPreset ?? "bee";
+    if (preset === "orb" || preset === "ring") {
+      this.createPresetAvatar(preset);
+      return true;
+    }
     try {
       const loader = new GLTFLoader();
       registerPbrSpecularGlossinessGLTFPlugin(loader);
@@ -982,9 +987,69 @@ var ThreeBeeRenderer = class {
       this.updateBeeScreenPosition();
       return true;
     } catch {
+      if (this.options.assetUrl) {
+        this.createPresetAvatar("orb");
+        return true;
+      }
       return false;
     }
   }
+  createPresetAvatar(preset) {
+    this.runtimeWings = null;
+    this.clearVisualRig();
+    if (preset === "orb") {
+      const orbMaterial = new THREE2.MeshPhysicalMaterial({
+        color: 13228274,
+        roughness: 0.28,
+        metalness: 0.04,
+        clearcoat: 0.45,
+        emissive: 9087192,
+        emissiveIntensity: 0.18
+      });
+      const orb = new THREE2.Mesh(new THREE2.SphereGeometry(14, 32, 32), orbMaterial);
+      this.visualRig.add(orb);
+    } else {
+      const ringMaterial = new THREE2.MeshPhysicalMaterial({
+        color: 13943976,
+        transparent: true,
+        opacity: 0.72,
+        roughness: 0.12,
+        metalness: 0.02,
+        side: THREE2.DoubleSide
+      });
+      const ring = new THREE2.Mesh(new THREE2.TorusGeometry(16, 2.4, 16, 64), ringMaterial);
+      ring.rotation.x = Math.PI / 2.3;
+      const core = new THREE2.Mesh(
+        new THREE2.SphereGeometry(6, 24, 24),
+        new THREE2.MeshPhysicalMaterial({
+          color: 15787730,
+          roughness: 0.34,
+          metalness: 0.05
+        })
+      );
+      this.visualRig.add(ring, core);
+    }
+    this.applyHomeFacing(true);
+    this.updateBeeScreenPosition();
+  }
+  clearVisualRig() {
+    while (this.visualRig.children.length > 0) {
+      const child = this.visualRig.children[0];
+      this.visualRig.remove(child);
+      child.traverse((node) => {
+        if (node instanceof THREE2.Mesh) {
+          node.geometry?.dispose();
+          const materials = Array.isArray(node.material) ? node.material : [node.material];
+          for (const material of materials) {
+            material.dispose();
+          }
+        }
+      });
+    }
+    this.mixer = null;
+    this.actions.clear();
+    this.activeActionName = null;
+  }
   createFallbackBee() {
     this.runtimeWings = null;
     const bodyMaterial = new THREE2.MeshStandardMaterial({ color: 13867825 });

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@kibee/renderer-three",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "sideEffects": ["*.css"],
+  "sideEffects": [
+    "*.css"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -13,7 +15,9 @@
     },
     "./styles.css": "./dist/styles.css"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean --tsconfig tsconfig.build.json && cp src/styles.css dist/styles.css",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
@@ -27,5 +31,8 @@
   },
   "devDependencies": {
     "tsup": "^8.5.1"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }