@divinci-ai/robot-avatar 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Divinci AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @divinci-ai/robot-avatar
+
+The Divinci robot mascot — the procedural, rigged react-three-fiber avatar
+shared by every surface that shows him:
+
+| Surface | Wrapper |
+|---|---|
+| SDK docs hero (sdk.divinci.ai) | `workspace/sdk/docs/src/components/RobotHero/RobotHero.tsx` |
+| Web app + Divinci Agent panel | `workspace/clients/web/src/components/RobotAvatar/RobotAvatar.tsx` |
+| Chrome extension (iframe) | via the web app / a dedicated robot page (planned) |
+
+## Entry points
+
+- **`@divinci-ai/robot-avatar`** (light, no three.js): `AvatarState`,
+  `RobotAvatarColors`, `blendHex`, `useRenderGate`. Safe for main bundles.
+- **`@divinci-ai/robot-avatar/scene`** (heavy): `RobotScene`, `LogoRobot`,
+  `AnimatedHeart`, `useRobotSignals`, `useGroupMotion`. **Always lazy-import**
+  so three.js stays in its own chunk:
+
+```tsx
+import { lazy } from "react";
+const RobotScene = lazy(() =>
+  import("@divinci-ai/robot-avatar/scene").then((m) => ({ default: m.RobotScene }))
+);
+```
+
+## Built-in hardening (every consumer gets these)
+
+- `powerPreference: "low-power"` — never spins up the discrete GPU.
+- `failIfMajorPerformanceCaveat: true` — refuses software WebGL (SwiftShader)
+  instead of burning CPU; your error boundary shows the static fallback.
+- `paused` prop → R3F `frameloop: "never"`. Pair with `useRenderGate` (pauses
+  when scrolled off-screen, tab hidden, or user idle).
+- `onContextLost` callback — `webglcontextlost` does not throw through React;
+  listen here and swap to your static fallback.
+- `prefers-reduced-motion` honored live: autonomous animation freezes to a
+  rest pose; only the gentle cursor-driven gaze lean remains.
+- `dpr` capped at `[1, 1.5]` by default (the mascot renders small).
+
+## Consumer responsibilities
+
+Each wrapper owns: color resolution (theme vars vs brand constants), the
+static fallback image (Suspense placeholder + WebGL-failure fallback +
+context-loss swap), and any surface-specific gaze target (`speakerTarget`).
+
+## Version skew
+
+Compiled against the lowest consumer versions (react 18 / three 0.169 /
+r3f 8 / drei 9); peer ranges span through the docs site's react 19 / three
+0.185 / r3f 9 / drei 10. Only skew-stable APIs are used (`Canvas`, `useFrame`,
+`Environment`, `Lightformer`, core three geometry/materials) — check both
+consumers when touching imports.

package/dist/blend.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tiny hex-color blend used by consumers to derive the robot's palette from a
+ * theme (web client) or brand constants (docs hero). Lives in the light entry
+ * so wrappers can compute colors without touching three.js.
+ */
+/** Blend two hex colors; t=0 → a, t=1 → b. */
+export declare function blendHex(a: string, b: string, t: number): string;
+//# sourceMappingURL=blend.d.ts.map

package/dist/blend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blend.d.ts","sourceRoot":"","sources":["../src/blend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQhE"}

package/dist/blend.js

@@ -0,0 +1,17 @@
+/**
+ * Tiny hex-color blend used by consumers to derive the robot's palette from a
+ * theme (web client) or brand constants (docs hero). Lives in the light entry
+ * so wrappers can compute colors without touching three.js.
+ */
+/** Blend two hex colors; t=0 → a, t=1 → b. */
+export function blendHex(a, b, t) {
+    const m = a.replace("#", "").trim();
+    const n = b.replace("#", "").trim();
+    if (m.length < 6 || n.length < 6)
+        return a;
+    const ra = [parseInt(m.slice(0, 2), 16), parseInt(m.slice(2, 4), 16), parseInt(m.slice(4, 6), 16)];
+    const rb = [parseInt(n.slice(0, 2), 16), parseInt(n.slice(2, 4), 16), parseInt(n.slice(4, 6), 16)];
+    const mix = ra.map((v, i) => Math.round(v + (rb[i] - v) * t));
+    return "#" + mix.map((v) => Math.max(0, Math.min(255, v)).toString(16).padStart(2, "0")).join("");
+}
+//# sourceMappingURL=blend.js.map

package/dist/blend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blend.js","sourceRoot":"","sources":["../src/blend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACtD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnG,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnG,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @divinci-ai/robot-avatar — light entry (NO three.js).
+ *
+ * Import this from main bundles; lazy-import "@divinci-ai/robot-avatar/scene"
+ * for the WebGL chunk:
+ *
+ *   const RobotScene = lazy(() =>
+ *     import("@divinci-ai/robot-avatar/scene").then((m) => ({ default: m.RobotScene }))
+ *   );
+ */
+export type { AvatarState, RobotAvatarColors } from "./types.js";
+export { blendHex } from "./blend.js";
+export { useRenderGate, type RenderGate, type RenderGateOptions } from "./render-gate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @divinci-ai/robot-avatar — light entry (NO three.js).
+ *
+ * Import this from main bundles; lazy-import "@divinci-ai/robot-avatar/scene"
+ * for the WebGL chunk:
+ *
+ *   const RobotScene = lazy(() =>
+ *     import("@divinci-ai/robot-avatar/scene").then((m) => ({ default: m.RobotScene }))
+ *   );
+ */
+export { blendHex } from "./blend.js";
+export { useRenderGate } from "./render-gate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAA2C,MAAM,kBAAkB,CAAC"}

package/dist/render-gate.d.ts

@@ -0,0 +1,32 @@
+/**
+ * useRenderGate — shared "should the robot render right now?" gate.
+ *
+ * Returns `active: false` when any of these hold:
+ *  - the container is scrolled out of the viewport (IntersectionObserver)
+ *  - the tab is hidden (visibilitychange)
+ *  - the user has been idle for `idleMs` (optional; pass 0/undefined to skip)
+ *
+ * Consumers feed `active` into RobotScene's `paused` prop, which sets the R3F
+ * frameloop to "never" — the WebGL context stays alive but stops burning
+ * GPU/battery. This generalizes the SDK docs hero's gate controller so the web
+ * app / agent panel / extension iframe get the same behavior for free.
+ *
+ * Lives in the light entry: React-only, no three.js.
+ */
+export interface RenderGateOptions {
+    /** Pause after this many ms without pointer/key/scroll activity. 0 = never. */
+    idleMs?: number;
+    /** IntersectionObserver threshold for "visible" (default 0.05). */
+    threshold?: number;
+}
+export interface RenderGate<T extends HTMLElement> {
+    /**
+     * Attach to the element wrapping the canvas. A callback ref (not a ref
+     * object) so the type is identical under react 18 and 19 typings.
+     */
+    ref: (node: T | null) => void;
+    /** True when the robot should animate. */
+    active: boolean;
+}
+export declare function useRenderGate<T extends HTMLElement = HTMLDivElement>(options?: RenderGateOptions): RenderGate<T>;
+//# sourceMappingURL=render-gate.d.ts.map

package/dist/render-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-gate.d.ts","sourceRoot":"","sources":["../src/render-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,WAAW;IAC/C;;;OAGG;IACH,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9B,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,cAAc,EAClE,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CAAC,CAAC,CAAC,CAgEf"}

package/dist/render-gate.js

@@ -0,0 +1,72 @@
+/**
+ * useRenderGate — shared "should the robot render right now?" gate.
+ *
+ * Returns `active: false` when any of these hold:
+ *  - the container is scrolled out of the viewport (IntersectionObserver)
+ *  - the tab is hidden (visibilitychange)
+ *  - the user has been idle for `idleMs` (optional; pass 0/undefined to skip)
+ *
+ * Consumers feed `active` into RobotScene's `paused` prop, which sets the R3F
+ * frameloop to "never" — the WebGL context stays alive but stops burning
+ * GPU/battery. This generalizes the SDK docs hero's gate controller so the web
+ * app / agent panel / extension iframe get the same behavior for free.
+ *
+ * Lives in the light entry: React-only, no three.js.
+ */
+import { useEffect, useState } from "react";
+export function useRenderGate(options = {}) {
+    const { idleMs = 0, threshold = 0.05 } = options;
+    const [node, setNode] = useState(null);
+    const [active, setActive] = useState(true);
+    useEffect(() => {
+        let visible = true;
+        let shown = !document.hidden;
+        let idle = false;
+        let idleTimer;
+        const recompute = () => {
+            setActive(visible && shown && !idle);
+        };
+        const bumpIdle = () => {
+            if (!idleMs)
+                return;
+            if (idle) {
+                idle = false;
+                recompute();
+            }
+            window.clearTimeout(idleTimer);
+            idleTimer = window.setTimeout(() => {
+                idle = true;
+                recompute();
+            }, idleMs);
+        };
+        let io;
+        if (node && typeof IntersectionObserver !== "undefined") {
+            io = new IntersectionObserver((entries) => {
+                visible = entries.some((e) => e.isIntersecting);
+                recompute();
+            }, { threshold });
+            io.observe(node);
+        }
+        const onVisibility = () => {
+            shown = !document.hidden;
+            recompute();
+        };
+        document.addEventListener("visibilitychange", onVisibility);
+        const activityEvents = ["pointermove", "pointerdown", "keydown", "wheel", "touchstart", "scroll"];
+        if (idleMs) {
+            activityEvents.forEach((ev) => window.addEventListener(ev, bumpIdle, { passive: true }));
+            bumpIdle();
+        }
+        recompute();
+        return () => {
+            io?.disconnect();
+            document.removeEventListener("visibilitychange", onVisibility);
+            if (idleMs) {
+                activityEvents.forEach((ev) => window.removeEventListener(ev, bumpIdle));
+                window.clearTimeout(idleTimer);
+            }
+        };
+    }, [node, idleMs, threshold]);
+    return { ref: setNode, active };
+}
+//# sourceMappingURL=render-gate.js.map

package/dist/render-gate.js.map

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

package/dist/scene/AnimatedHeart.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AnimatedHeart — the Divinci heart rendered in code (not baked into the GLB)
+ * so it can be alive: it slowly phases through brand colors, is slightly
+ * transparent, and gently pulses.
+ */
+import React from "react";
+import type { MutableRefObject } from "react";
+import type { RobotSignals } from "./useRobotSignals.js";
+export interface AnimatedHeartProps {
+    position?: [number, number, number];
+    scale?: number;
+    cycleSeconds?: number;
+    opacity?: number;
+    stretchY?: number;
+    sig?: MutableRefObject<RobotSignals>;
+}
+export declare function AnimatedHeart({ position, scale, cycleSeconds, opacity, stretchY, sig, }: AnimatedHeartProps): React.ReactElement;
+//# sourceMappingURL=AnimatedHeart.d.ts.map

package/dist/scene/AnimatedHeart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedHeart.d.ts","sourceRoot":"","sources":["../../src/scene/AnimatedHeart.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAA0B,MAAM,OAAO,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;CACtC;AAwBD,wBAAgB,aAAa,CAAC,EAC5B,QAAyB,EACzB,KAAW,EACX,YAAgB,EAChB,OAAa,EACb,QAAY,EACZ,GAAG,GACJ,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA4CzC"}

package/dist/scene/AnimatedHeart.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * AnimatedHeart — the Divinci heart rendered in code (not baked into the GLB)
+ * so it can be alive: it slowly phases through brand colors, is slightly
+ * transparent, and gently pulses.
+ */
+import { useMemo, useRef } from "react";
+import { useFrame } from "@react-three/fiber";
+import * as THREE from "three";
+function makeHeartGeometry() {
+    const s = new THREE.Shape();
+    s.moveTo(0, 0.3);
+    s.bezierCurveTo(0, 0.3, -0.2, 0, -0.5, 0);
+    s.bezierCurveTo(-0.95, 0, -0.95, 0.5, -0.95, 0.5);
+    s.bezierCurveTo(-0.95, 0.78, -0.6, 1.05, 0, 1.35);
+    s.bezierCurveTo(0.6, 1.05, 0.95, 0.78, 0.95, 0.5);
+    s.bezierCurveTo(0.95, 0.5, 0.95, 0, 0.5, 0);
+    s.bezierCurveTo(0.2, 0, 0, 0.3, 0, 0.3);
+    const geo = new THREE.ExtrudeGeometry(s, {
+        depth: 0.55,
+        bevelEnabled: true,
+        bevelThickness: 0.14,
+        bevelSize: 0.14,
+        bevelSegments: 5,
+        curveSegments: 28,
+    });
+    geo.center();
+    geo.rotateZ(Math.PI);
+    return geo;
+}
+export function AnimatedHeart({ position = [0, 0.2, 0.45], scale = 0.5, cycleSeconds = 6, opacity = 0.8, stretchY = 1, sig, }) {
+    const geometry = useMemo(makeHeartGeometry, []);
+    const mesh = useRef(null);
+    const material = useRef(null);
+    const color = useMemo(() => new THREE.Color(), []);
+    useFrame(() => {
+        const t = performance.now() / 1000;
+        const s = sig?.current;
+        const reduced = s?.reduced ?? false;
+        // Reduced motion: hold a static mid-cycle color, no hue drift / pulse / bob.
+        const phase = reduced ? 0 : Math.sin((t * 2 * Math.PI) / cycleSeconds);
+        const hue = (0.89 + 0.11 * phase) % 1;
+        color.setHSL(hue, 0.7, 0.56);
+        if (material.current) {
+            material.current.color.copy(color);
+            material.current.emissive.copy(color);
+        }
+        if (mesh.current) {
+            if (reduced) {
+                mesh.current.scale.set(scale, scale * stretchY, scale);
+                mesh.current.position.y = position[1];
+            }
+            else {
+                const reacting = s ? t < s.reactUntil : false;
+                const pulse = 1 + (reacting ? 0.2 : 0.05) * Math.sin(t * (reacting ? 9 : 2.4));
+                mesh.current.scale.set(scale * pulse, scale * stretchY * pulse, scale * pulse);
+                mesh.current.position.y = position[1] + (reacting ? Math.abs(Math.sin(t * 9)) * 0.06 : 0);
+            }
+        }
+    });
+    return (_jsx("mesh", { ref: mesh, geometry: geometry, position: position, scale: scale, children: _jsx("meshStandardMaterial", { ref: material, transparent: true, opacity: opacity, roughness: 0.2, metalness: 0.0, emissiveIntensity: 0.35, depthWrite: false }) }));
+}
+//# sourceMappingURL=AnimatedHeart.js.map

package/dist/scene/AnimatedHeart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedHeart.js","sourceRoot":"","sources":["../../src/scene/AnimatedHeart.tsx"],"names":[],"mappings":"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"}

package/dist/scene/LogoRobot.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LogoRobot — the Divinci mascot, hand-built in code and fully rigged.
+ *
+ * Structure mirrors the flat logo (open frame, NO torso):
+ *  - rounded-corner head with two dark eyes + two ball-tipped antennae
+ *  - two "4"-shaped arm/leg forms (mirrored): diagonal + crossbar + vertical
+ *    stem, one sphere hand; a foot floats below each
+ *  - the AnimatedHeart floating in the chest center
+ *
+ * Every part is rigged and animates independently off shared interaction
+ * signals (page-wide gaze, keystroke reactions, idle fidgets).
+ */
+import React from "react";
+import { type SpeakerTarget } from "./useRobotSignals.js";
+import type { AvatarState, RobotAvatarColors } from "../types.js";
+export interface LogoRobotProps {
+    state: AvatarState;
+    colors: RobotAvatarColors;
+    autoRotate?: boolean;
+    /** Optional extra gaze target (see useRobotSignals). */
+    speakerTarget?: SpeakerTarget;
+}
+export declare function LogoRobot({ state, colors, autoRotate, speakerTarget }: LogoRobotProps): React.ReactElement;
+//# sourceMappingURL=LogoRobot.d.ts.map

package/dist/scene/LogoRobot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogoRobot.d.ts","sourceRoot":"","sources":["../../src/scene/LogoRobot.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAA0B,MAAM,OAAO,CAAC;AAI/C,OAAO,EAAqD,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE7G,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6PlE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wDAAwD;IACxD,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAkB,EAAE,aAAa,EAAE,EAAE,cAAc,GAAG,KAAK,CAAC,YAAY,CAgFlH"}