@lemoncat7/dsh-theme-xiaohei 0.3.0-alpha.22 → 0.3.1

package/lib/scene/character-idle.d.ts

@@ -0,0 +1,17 @@
+export type CharacterIdlePose = 'seated' | 'chin' | 'doze';
+export declare const CHARACTER_CHIN_DELAY = 30000;
+export declare const CHARACTER_DOZE_DELAY = 180000;
+interface IdleClock {
+    now(): number;
+    setTimeout(callback: () => void, delay: number): number;
+    clearTimeout(handle: number): void;
+}
+/** One pending deadline, no polling, no model/session state or persisted user data. */
+export declare function createCharacterIdleController(clock: IdleClock, changed: (pose: CharacterIdlePose) => void): {
+    readonly pose: CharacterIdlePose;
+    activity(): void;
+    setPaused(value: boolean): void;
+    dispose(): void;
+};
+export {};
+//# sourceMappingURL=character-idle.d.ts.map

package/lib/scene/character-idle.js

@@ -0,0 +1,65 @@
+export const CHARACTER_CHIN_DELAY = 30_000;
+export const CHARACTER_DOZE_DELAY = 180_000;
+/** One pending deadline, no polling, no model/session state or persisted user data. */
+export function createCharacterIdleController(clock, changed) {
+    let pose = 'seated';
+    let lastActivity = clock.now();
+    let timer;
+    let paused = true;
+    let disposed = false;
+    const clear = () => {
+        if (timer !== undefined)
+            clock.clearTimeout(timer);
+        timer = undefined;
+    };
+    const update = (next) => {
+        if (next !== pose) {
+            pose = next;
+            changed(next);
+        }
+    };
+    const schedule = () => {
+        clear();
+        if (paused || disposed || pose === 'doze')
+            return;
+        const deadline = pose === 'seated' ? CHARACTER_CHIN_DELAY : CHARACTER_DOZE_DELAY;
+        timer = clock.setTimeout(tick, Math.max(1, lastActivity + deadline - clock.now()));
+    };
+    function tick() {
+        timer = undefined;
+        if (paused || disposed)
+            return;
+        const elapsed = clock.now() - lastActivity;
+        update(elapsed >= CHARACTER_DOZE_DELAY ? 'doze' : elapsed >= CHARACTER_CHIN_DELAY ? 'chin' : 'seated');
+        schedule();
+    }
+    return {
+        get pose() { return pose; },
+        activity() {
+            if (paused || disposed)
+                return;
+            const now = clock.now();
+            // Pointer events can fire at 120 Hz. Update a timestamp at most once per
+            // second; never reset a timeout on each pointer movement or keystroke.
+            if (pose === 'seated' && now - lastActivity < 1000)
+                return;
+            lastActivity = now;
+            if (pose !== 'seated') {
+                update('seated');
+                schedule();
+            }
+        },
+        setPaused(value) {
+            if (disposed || value === paused)
+                return;
+            paused = value;
+            clear();
+            lastActivity = clock.now();
+            update('seated');
+            if (!paused)
+                schedule();
+        },
+        dispose() { disposed = true; clear(); },
+    };
+}
+//# sourceMappingURL=character-idle.js.map

package/lib/scene/character-layout.d.ts

@@ -0,0 +1,24 @@
+/** Pure placement policy: decoration may only occupy space outside message bounds. */
+export interface CharacterRect {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export interface CharacterLayoutInput {
+    sidebar: CharacterRect;
+    scroll: CharacterRect;
+    flow: CharacterRect;
+    viewportWidth: number;
+    viewportHeight: number;
+    controls: CharacterRect[];
+}
+export interface CharacterPlacement {
+    pose: 'seated' | 'peek' | 'halfpeek' | 'hidden';
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export declare function resolveCharacterPlacement(input: CharacterLayoutInput): CharacterPlacement;
+//# sourceMappingURL=character-layout.d.ts.map

package/lib/scene/character-layout.js

@@ -0,0 +1,51 @@
+const hidden = { pose: 'hidden', left: 0, top: 0, width: 0, height: 0 };
+const SEATED_RATIO = 0.71;
+const PEEK_RATIO = 0.63;
+const HALF_PEEK_RATIO = 0.44;
+export function resolveCharacterPlacement(input) {
+    const { sidebar, scroll, flow, viewportWidth, viewportHeight, controls } = input;
+    // Wallpaper belongs to the viewport, not the welcome/composer dock. Reserve
+    // the same top/bottom chrome space before and after the first message.
+    const bottom = Math.min(sidebar.bottom, viewportHeight) - 148;
+    const top = Math.max(sidebar.top + 24, 96);
+    if (bottom - top < 130 || sidebar.right > flow.left)
+        return hidden;
+    const rightStart = flow.right + 56;
+    const seatedWidth = Math.min(250, scroll.right - rightStart - 20, (bottom - top) * SEATED_RATIO, 340 * SEATED_RATIO);
+    if (seatedWidth >= 190) {
+        const height = seatedWidth / SEATED_RATIO;
+        return { pose: 'seated', left: scroll.right - seatedWidth - 16,
+            top: top + (bottom - top - height) * 0.6, width: seatedWidth, height };
+    }
+    const avatarInset = viewportWidth > 760 ? 52 : 0;
+    const freeGap = flow.left - avatarInset - sidebar.right;
+    if (freeGap >= 66) {
+        const width = Math.min(104, freeGap - 12, (bottom - top) * PEEK_RATIO);
+        const height = width / PEEK_RATIO;
+        return { pose: 'peek', left: sidebar.right - 6,
+            top: top + Math.min(160, (bottom - top - height) * 0.5), width, height };
+    }
+    // A collapsed rail has a large blank region between navigation and Settings.
+    // Use that region only after excluding every real interactive control.
+    if (sidebar.right - sidebar.left > 100)
+        return hidden;
+    const left = sidebar.left + 7;
+    const width = Math.min(60, flow.left - avatarInset - left - 10);
+    if (width < 40)
+        return hidden;
+    const height = width / HALF_PEEK_RATIO;
+    const blocked = controls.filter(r => r.right > left && r.left < left + width)
+        .map(r => ({ start: Math.max(top, r.top - 12), end: Math.min(bottom, r.bottom + 12) }))
+        .filter(r => r.end > r.start).sort((a, b) => a.start - b.start);
+    let cursor = top;
+    let best = { start: top, end: top };
+    for (const block of [...blocked, { start: bottom, end: bottom }]) {
+        if (block.start - cursor > best.end - best.start)
+            best = { start: cursor, end: block.start };
+        cursor = Math.max(cursor, block.end);
+    }
+    if (best.end - best.start < height + 12)
+        return hidden;
+    return { pose: 'halfpeek', left, top: best.start + (best.end - best.start - height) * 0.45, width, height };
+}
+//# sourceMappingURL=character-layout.js.map

package/lib/scene/character-poses.d.ts

@@ -0,0 +1,26 @@
+/** Shared catalog: runtime preloading and CSS must always use the same assets. */
+export declare const CHARACTER_POSES: {
+    readonly seated: {
+        readonly light: string;
+        readonly dark: string;
+    };
+    readonly chin: {
+        readonly light: string;
+        readonly dark: string;
+    };
+    readonly doze: {
+        readonly light: string;
+        readonly dark: string;
+    };
+    readonly peek: {
+        readonly light: string;
+        readonly dark: string;
+    };
+    readonly halfpeek: {
+        readonly light: string;
+        readonly dark: string;
+    };
+};
+export type CharacterPose = keyof typeof CHARACTER_POSES;
+export declare const CHARACTER_POSE_NAMES: CharacterPose[];
+//# sourceMappingURL=character-poses.d.ts.map

package/lib/scene/character-poses.js

@@ -0,0 +1,11 @@
+import { XIAOHEI_SEATED_LIGHT, XIAOHEI_SEATED_DARK, XIAOHEI_PEEK_LIGHT, XIAOHEI_PEEK_DARK, XIAOHEI_CHIN_LIGHT, XIAOHEI_CHIN_DARK, XIAOHEI_DOZE_LIGHT, XIAOHEI_DOZE_DARK, XIAOHEI_HALFPEEK_LIGHT, XIAOHEI_HALFPEEK_DARK, } from '../generated-backgrounds.js';
+/** Shared catalog: runtime preloading and CSS must always use the same assets. */
+export const CHARACTER_POSES = {
+    seated: { light: XIAOHEI_SEATED_LIGHT, dark: XIAOHEI_SEATED_DARK },
+    chin: { light: XIAOHEI_CHIN_LIGHT, dark: XIAOHEI_CHIN_DARK },
+    doze: { light: XIAOHEI_DOZE_LIGHT, dark: XIAOHEI_DOZE_DARK },
+    peek: { light: XIAOHEI_PEEK_LIGHT, dark: XIAOHEI_PEEK_DARK },
+    halfpeek: { light: XIAOHEI_HALFPEEK_LIGHT, dark: XIAOHEI_HALFPEEK_DARK },
+};
+export const CHARACTER_POSE_NAMES = Object.keys(CHARACTER_POSES);
+//# sourceMappingURL=character-poses.js.map

package/lib/scene/heixiu-feedback.d.ts

@@ -1,3 +1,3 @@
 /** Session feedback runs on an inner plane so ambient drifting stays untouched. */
-export declare const XIAOHEI_HEIXIU_FEEDBACK_CSS = "\n.xiaohei-scene__heixiu-body {\n  position: absolute;\n  inset: 0;\n  display: block;\n  transform: translate3d(0, 0, 0);\n  opacity: 1;\n}\n\nhtml[data-xiaohei-state='thinking'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-body {\n  animation: xiaohei-heixiu-feedback-send 620ms cubic-bezier(0.22, 0.72, 0.24, 1) both;\n}\n\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--mascot .xiaohei-scene__heixiu-body,\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-body,\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--sidebar .xiaohei-scene__heixiu-body {\n  animation: xiaohei-heixiu-feedback-complete 760ms cubic-bezier(0.16, 1, 0.3, 1) both;\n}\n\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-body {\n  animation-delay: 70ms;\n}\n\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--sidebar .xiaohei-scene__heixiu-body {\n  animation-delay: 140ms;\n}\n\nhtml[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-body {\n  animation: xiaohei-heixiu-feedback-error 880ms cubic-bezier(0.22, 0.72, 0.24, 1) both;\n}\n\nhtml[data-xiaohei-state='thinking'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-open,\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open,\nhtml[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open {\n  animation: xiaohei-heixiu-feedback-eyes-open 620ms step-end both;\n}\n\nhtml[data-xiaohei-state='thinking'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-blink,\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink,\nhtml[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink {\n  animation: xiaohei-heixiu-feedback-eyes-blink 620ms step-end both;\n}\n\n@keyframes xiaohei-heixiu-feedback-send {\n  0%, 100% { transform: translate3d(0, 0, 0); opacity: 1; }\n  34% { transform: translate3d(0, -0.28rem, 0); opacity: 1; }\n  68% { transform: translate3d(0, 0.08rem, 0); opacity: 0.94; }\n}\n\n@keyframes xiaohei-heixiu-feedback-complete {\n  0%, 100% { transform: translate3d(0, 0, 0); opacity: 1; }\n  38% { transform: translate3d(0, -0.42rem, 0); opacity: 1; }\n  68% { transform: translate3d(0, -0.12rem, 0); opacity: 0.96; }\n}\n\n@keyframes xiaohei-heixiu-feedback-error {\n  0%, 100% { transform: translate3d(0, 0, 0); opacity: 1; }\n  30% { transform: translate3d(0, 0.2rem, 0); opacity: 0.52; }\n  62% { transform: translate3d(0, 0.08rem, 0); opacity: 0.72; }\n}\n\n@keyframes xiaohei-heixiu-feedback-eyes-open {\n  0%, 24%, 48%, 100% { opacity: 1; }\n  25%, 47% { opacity: 0; }\n}\n\n@keyframes xiaohei-heixiu-feedback-eyes-blink {\n  0%, 24%, 48%, 100% { opacity: 0; }\n  25%, 47% { opacity: 1; }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  html[data-xiaohei-state] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-body,\n  html[data-xiaohei-state] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open,\n  html[data-xiaohei-state] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink {\n    animation: none;\n  }\n}\n";
+export declare const XIAOHEI_HEIXIU_FEEDBACK_CSS = "\n.xiaohei-scene__heixiu-body {\n  position: absolute;\n  inset: 0;\n  display: block;\n  transform: translate3d(0, 0, 0);\n  opacity: 1;\n}\n\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--mascot .xiaohei-scene__heixiu-body,\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--sidebar .xiaohei-scene__heixiu-body {\n  animation: xiaohei-heixiu-feedback-complete 760ms cubic-bezier(0.16, 1, 0.3, 1) both;\n}\n\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--sidebar .xiaohei-scene__heixiu-body {\n  animation-delay: 140ms;\n}\n\nhtml[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-body {\n  animation: xiaohei-heixiu-feedback-error 880ms cubic-bezier(0.22, 0.72, 0.24, 1) both;\n}\n\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open,\nhtml[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open {\n  animation: xiaohei-heixiu-feedback-eyes-open 620ms step-end both;\n}\n\nhtml[data-xiaohei-state='complete'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink,\nhtml[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink {\n  animation: xiaohei-heixiu-feedback-eyes-blink 620ms step-end both;\n}\n\n@keyframes xiaohei-heixiu-feedback-complete {\n  0%, 100% { transform: translate3d(0, 0, 0); opacity: 1; }\n  38% { transform: translate3d(0, -0.42rem, 0); opacity: 1; }\n  68% { transform: translate3d(0, -0.12rem, 0); opacity: 0.96; }\n}\n\n@keyframes xiaohei-heixiu-feedback-error {\n  0%, 100% { transform: translate3d(0, 0, 0); opacity: 1; }\n  30% { transform: translate3d(0, 0.2rem, 0); opacity: 0.52; }\n  62% { transform: translate3d(0, 0.08rem, 0); opacity: 0.72; }\n}\n\n@keyframes xiaohei-heixiu-feedback-eyes-open {\n  0%, 24%, 48%, 100% { opacity: 1; }\n  25%, 47% { opacity: 0; }\n}\n\n@keyframes xiaohei-heixiu-feedback-eyes-blink {\n  0%, 24%, 48%, 100% { opacity: 0; }\n  25%, 47% { opacity: 1; }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  html[data-xiaohei-state] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-body,\n  html[data-xiaohei-state] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open,\n  html[data-xiaohei-state] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink {\n    animation: none;\n  }\n}\n";
 //# sourceMappingURL=heixiu-feedback.d.ts.map

package/lib/scene/heixiu-feedback.js

@@ -8,20 +8,11 @@ export const XIAOHEI_HEIXIU_FEEDBACK_CSS = `
   opacity: 1;
 }
 
-html[data-xiaohei-state='thinking'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-body {
-  animation: xiaohei-heixiu-feedback-send 620ms cubic-bezier(0.22, 0.72, 0.24, 1) both;
-}
-
 html[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--mascot .xiaohei-scene__heixiu-body,
-html[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-body,
 html[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--sidebar .xiaohei-scene__heixiu-body {
   animation: xiaohei-heixiu-feedback-complete 760ms cubic-bezier(0.16, 1, 0.3, 1) both;
 }
 
-html[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-body {
-  animation-delay: 70ms;
-}
-
 html[data-xiaohei-state='complete'] .xiaohei-scene__heixiu--sidebar .xiaohei-scene__heixiu-body {
   animation-delay: 140ms;
 }
@@ -30,24 +21,16 @@ html[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-b
   animation: xiaohei-heixiu-feedback-error 880ms cubic-bezier(0.22, 0.72, 0.24, 1) both;
 }
 
-html[data-xiaohei-state='thinking'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-open,
 html[data-xiaohei-state='complete'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open,
 html[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-open {
   animation: xiaohei-heixiu-feedback-eyes-open 620ms step-end both;
 }
 
-html[data-xiaohei-state='thinking'] .xiaohei-scene__heixiu--composer .xiaohei-scene__heixiu-blink,
 html[data-xiaohei-state='complete'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink,
 html[data-xiaohei-state='error'] .xiaohei-scene__heixiu .xiaohei-scene__heixiu-blink {
   animation: xiaohei-heixiu-feedback-eyes-blink 620ms step-end both;
 }
 
-@keyframes xiaohei-heixiu-feedback-send {
-  0%, 100% { transform: translate3d(0, 0, 0); opacity: 1; }
-  34% { transform: translate3d(0, -0.28rem, 0); opacity: 1; }
-  68% { transform: translate3d(0, 0.08rem, 0); opacity: 0.94; }
-}
-
 @keyframes xiaohei-heixiu-feedback-complete {
   0%, 100% { transform: translate3d(0, 0, 0); opacity: 1; }
   38% { transform: translate3d(0, -0.42rem, 0); opacity: 1; }

package/lib/scene/pointer-bridge.d.ts

@@ -0,0 +1,21 @@
+export declare const XIAOHEI_SYLVA_POINTER_CHANNEL = "dsh-theme-xiaohei/sylva-pointer-v1";
+export declare const XIAOHEI_SYLVA_POINTER_ACK_CHANNEL = "dsh-theme-xiaohei/sylva-pointer-ack-v1";
+export declare const XIAOHEI_SYLVA_POINTER_MARKER = "data-xiaohei-pointer-bridge";
+export type XiaoheiSylvaPointerMessage = {
+    channel: typeof XIAOHEI_SYLVA_POINTER_CHANNEL;
+    event: 'move' | 'leave';
+    x?: number;
+    y?: number;
+    pointerType?: string;
+};
+type FrameBounds = Pick<DOMRectReadOnly, 'left' | 'top' | 'width' | 'height'>;
+/** Translate a host-page pointer into the isolated scene viewport. */
+export declare function resolveXiaoheiSylvaPointer(clientX: number, clientY: number, bounds: FrameBounds): Pick<XiaoheiSylvaPointerMessage, 'event' | 'x' | 'y'>;
+/** Add the receiver to a derived srcDoc without changing the registered ThreeUI source. */
+export declare function injectXiaoheiSylvaPointerBridge(source: string): string;
+/** Prepare a frame before it is connected, so WebGL boots exactly once. */
+export declare function prepareXiaoheiSylvaPointerFrame(frame: HTMLIFrameElement): boolean;
+/** Install a movement-only bridge. It never forwards clicks or presses. */
+export declare function installXiaoheiSylvaPointerBridge(host: HTMLElement, prepareSceneFrame?: (frame: HTMLIFrameElement) => void): () => void;
+export {};
+//# sourceMappingURL=pointer-bridge.d.ts.map

package/lib/scene/pointer-bridge.js

@@ -0,0 +1,155 @@
+export const XIAOHEI_SYLVA_POINTER_CHANNEL = 'dsh-theme-xiaohei/sylva-pointer-v1';
+export const XIAOHEI_SYLVA_POINTER_ACK_CHANNEL = 'dsh-theme-xiaohei/sylva-pointer-ack-v1';
+export const XIAOHEI_SYLVA_POINTER_MARKER = 'data-xiaohei-pointer-bridge';
+/** Translate a host-page pointer into the isolated scene viewport. */
+export function resolveXiaoheiSylvaPointer(clientX, clientY, bounds) {
+    const x = clientX - bounds.left;
+    const y = clientY - bounds.top;
+    if (bounds.width <= 0 || bounds.height <= 0 || x < 0 || y < 0 || x > bounds.width || y > bounds.height) {
+        return { event: 'leave' };
+    }
+    return { event: 'move', x, y };
+}
+const RECEIVER = `
+  /* ${XIAOHEI_SYLVA_POINTER_MARKER}="true" — host pointer coordinates enter
+     the authored scene here, while actions remain owned by DSH. */
+  var XIAOHEI_POINTER_CHANNEL = ${JSON.stringify(XIAOHEI_SYLVA_POINTER_CHANNEL)};
+  var XIAOHEI_POINTER_ACK_CHANNEL = ${JSON.stringify(XIAOHEI_SYLVA_POINTER_ACK_CHANNEL)};
+  function xiaoheiAcknowledgePointer(eventName) {
+    parent.postMessage({
+      channel: XIAOHEI_POINTER_ACK_CHANNEL,
+      event: eventName,
+      pointerX: pointer.x,
+      pointerY: pointer.y,
+      ndcX: ndc.x,
+      ndcY: ndc.y,
+      reducedMotion: REDUCED
+    }, '*');
+  }
+  window.addEventListener('message', function (message) {
+    if (message.source !== parent) return;
+    var data = message.data;
+    if (!data || data.channel !== XIAOHEI_POINTER_CHANNEL) return;
+    if (data.event === 'leave') {
+      pointer.x = pointer.y = 0;
+      ndc.x = 10;
+      xiaoheiAcknowledgePointer('leave');
+      return;
+    }
+    if (data.event !== 'move' || !Number.isFinite(data.x) || !Number.isFinite(data.y)) return;
+    pointer.x = (data.x / window.innerWidth) * 2 - 1;
+    pointer.y = (data.y / window.innerHeight) * 2 - 1;
+    var xiaoheiHeroRect = hero.getBoundingClientRect();
+    ndc.x = ((data.x - xiaoheiHeroRect.left) / xiaoheiHeroRect.width) * 2 - 1;
+    ndc.y = -((data.y - xiaoheiHeroRect.top) / xiaoheiHeroRect.height) * 2 + 1;
+    /* Reduced motion keeps ambient animation still, but direct manipulation
+       must remain responsive. Render only the pointer-driven moss response. */
+    if (REDUCED && renderer && camera && typeof updateMouse === 'function') {
+      var xiaoheiReduced = REDUCED;
+      REDUCED = false;
+      updateMouse(0.016);
+      renderer.render(scene, camera);
+      REDUCED = xiaoheiReduced;
+    }
+    xiaoheiAcknowledgePointer('move');
+  });
+`;
+/** Add the receiver to a derived srcDoc without changing the registered ThreeUI source. */
+export function injectXiaoheiSylvaPointerBridge(source) {
+    if (source.includes(`${XIAOHEI_SYLVA_POINTER_MARKER}="true"`))
+        return source;
+    const runtimeEnd = source.lastIndexOf('\n})();\n</script>');
+    if (runtimeEnd < 0)
+        return source;
+    return `${source.slice(0, runtimeEnd)}${RECEIVER}${source.slice(runtimeEnd)}`;
+}
+/** Prepare a frame before it is connected, so WebGL boots exactly once. */
+export function prepareXiaoheiSylvaPointerFrame(frame) {
+    const source = frame.getAttribute('srcdoc');
+    if (source === null)
+        return false;
+    const bridgedSource = injectXiaoheiSylvaPointerBridge(source);
+    if (bridgedSource === source && !source.includes(`${XIAOHEI_SYLVA_POINTER_MARKER}="true"`))
+        return false;
+    frame.dataset.xiaoheiPointerBridge = 'true';
+    if (bridgedSource !== source)
+        frame.setAttribute('srcdoc', bridgedSource);
+    return true;
+}
+/** Install a movement-only bridge. It never forwards clicks or presses. */
+export function installXiaoheiSylvaPointerBridge(host, prepareSceneFrame = () => { }) {
+    const win = host.ownerDocument.defaultView;
+    if (win === null)
+        return () => { };
+    let frame = null;
+    let lastFrameWindow = null;
+    const prepareFrame = () => {
+        const nextFrame = host.querySelector('iframe');
+        if (!(nextFrame instanceof win.HTMLIFrameElement))
+            return;
+        frame = nextFrame;
+        lastFrameWindow = nextFrame.contentWindow;
+        prepareSceneFrame(frame);
+        prepareXiaoheiSylvaPointerFrame(frame);
+    };
+    const post = (message) => {
+        frame?.contentWindow?.postMessage({ channel: XIAOHEI_SYLVA_POINTER_CHANNEL, ...message }, '*');
+    };
+    const onPointerMove = (event) => {
+        if (event.pointerType === 'touch' || frame === null)
+            return;
+        const point = resolveXiaoheiSylvaPointer(event.clientX, event.clientY, frame.getBoundingClientRect());
+        post({ ...point, pointerType: event.pointerType || 'mouse' });
+    };
+    const onPointerDown = (event) => {
+        if (event.pointerType !== 'touch' || frame === null)
+            return;
+        const point = resolveXiaoheiSylvaPointer(event.clientX, event.clientY, frame.getBoundingClientRect());
+        post({ ...point, pointerType: 'touch' });
+    };
+    const onPointerEnd = (event) => {
+        if (event.pointerType === 'touch')
+            post({ event: 'leave', pointerType: 'touch' });
+    };
+    const onPointerLeave = (event) => {
+        post({ event: 'leave', pointerType: event.pointerType || 'mouse' });
+    };
+    const onBlur = () => post({ event: 'leave', pointerType: 'mouse' });
+    const onMessage = (event) => {
+        if (event.source !== lastFrameWindow)
+            return;
+        const data = event.data;
+        if (data === null || data.channel !== XIAOHEI_SYLVA_POINTER_ACK_CHANNEL || frame === null)
+            return;
+        frame.dataset.xiaoheiPointerState = data.event === 'move' ? 'active' : 'idle';
+        frame.dataset.xiaoheiPointerX = String(data.pointerX ?? '');
+        frame.dataset.xiaoheiPointerY = String(data.pointerY ?? '');
+        frame.dataset.xiaoheiPointerReducedMotion = String(data.reducedMotion === true);
+    };
+    const observer = new win.MutationObserver(prepareFrame);
+    observer.observe(host, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ['srcdoc'],
+    });
+    prepareFrame();
+    win.addEventListener('pointermove', onPointerMove, { passive: true, capture: true });
+    win.addEventListener('pointerdown', onPointerDown, { passive: true, capture: true });
+    win.addEventListener('pointerup', onPointerEnd, { passive: true, capture: true });
+    win.addEventListener('pointercancel', onPointerEnd, { passive: true, capture: true });
+    win.addEventListener('pointerleave', onPointerLeave, { capture: true });
+    win.addEventListener('blur', onBlur);
+    win.addEventListener('message', onMessage);
+    return () => {
+        observer.disconnect();
+        win.removeEventListener('pointermove', onPointerMove, { capture: true });
+        win.removeEventListener('pointerdown', onPointerDown, { capture: true });
+        win.removeEventListener('pointerup', onPointerEnd, { capture: true });
+        win.removeEventListener('pointercancel', onPointerEnd, { capture: true });
+        win.removeEventListener('pointerleave', onPointerLeave, { capture: true });
+        win.removeEventListener('blur', onBlur);
+        win.removeEventListener('message', onMessage);
+    };
+}
+//# sourceMappingURL=pointer-bridge.js.map

package/lib/scene/runtime.d.ts

@@ -0,0 +1,12 @@
+type XiaoheiWorldRenderer = (host: HTMLElement) => () => void;
+/** Register the browser-only world renderer without coupling shared scene code to raw assets. */
+export declare function configureXiaoheiWorldRenderer(renderer: XiaoheiWorldRenderer): () => void;
+/** Number of top-level decorative parts installed into the ambient layer. */
+export declare const XIAOHEI_SCENE_PART_COUNT: 1;
+/**
+ * Install the static wallpaper after plugin boot becomes idle. Appearance is
+ * CSS-driven; no image load handlers or per-frame character animation.
+ */
+export declare function installXiaoheiScene(doc?: Document | undefined): () => void;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/lib/scene/runtime.js

@@ -0,0 +1,87 @@
+import { XIAOHEI_SCENE_CSS, XIAOHEI_SCENE_LAYER_ID, XIAOHEI_SCENE_STYLE_ID, XIAOHEI_SCENE_WORLD_CLASS, } from './styles.js';
+let worldRenderer;
+/** Register the browser-only world renderer without coupling shared scene code to raw assets. */
+export function configureXiaoheiWorldRenderer(renderer) {
+    worldRenderer = renderer;
+    return () => {
+        if (worldRenderer === renderer)
+            worldRenderer = undefined;
+    };
+}
+const PARTS = [
+    XIAOHEI_SCENE_WORLD_CLASS,
+];
+/** Number of top-level decorative parts installed into the ambient layer. */
+export const XIAOHEI_SCENE_PART_COUNT = PARTS.length;
+/**
+ * Install the static wallpaper after plugin boot becomes idle. Appearance is
+ * CSS-driven; no image load handlers or per-frame character animation.
+ */
+export function installXiaoheiScene(doc = typeof document === 'undefined' ? undefined : document) {
+    if (doc === undefined)
+        return () => { };
+    let disposed = false;
+    let removeMountedScene = () => { };
+    let removeWorld = () => { };
+    const mount = () => {
+        if (disposed)
+            return;
+        removeWorld();
+        removeWorld = () => { };
+        doc.getElementById(XIAOHEI_SCENE_STYLE_ID)?.remove();
+        doc.getElementById(XIAOHEI_SCENE_LAYER_ID)?.remove();
+        const style = doc.createElement('style');
+        style.id = XIAOHEI_SCENE_STYLE_ID;
+        style.textContent = XIAOHEI_SCENE_CSS;
+        doc.head.append(style);
+        const layer = doc.createElement('div');
+        layer.id = XIAOHEI_SCENE_LAYER_ID;
+        layer.setAttribute('aria-hidden', 'true');
+        layer.setAttribute('data-xiaohei-scene', '');
+        let worldHost;
+        for (const className of PARTS) {
+            if (className === XIAOHEI_SCENE_WORLD_CLASS) {
+                worldHost = createWorldBackground(doc);
+                layer.append(worldHost);
+                continue;
+            }
+            const part = doc.createElement('span');
+            part.className = className;
+            layer.append(part);
+        }
+        doc.body.prepend(layer);
+        if (worldHost !== undefined && worldRenderer !== undefined) {
+            removeWorld = worldRenderer(worldHost);
+        }
+        removeMountedScene = () => {
+            removeWorld();
+            removeWorld = () => { };
+            layer.remove();
+            style.remove();
+        };
+    };
+    const win = doc.defaultView;
+    let cancelSchedule = () => { };
+    if (win !== null && typeof win.requestIdleCallback === 'function') {
+        const idleId = win.requestIdleCallback(mount, { timeout: 800 });
+        cancelSchedule = () => win.cancelIdleCallback(idleId);
+    }
+    else if (win !== null) {
+        const timeoutId = win.setTimeout(mount, 0);
+        cancelSchedule = () => win.clearTimeout(timeoutId);
+    }
+    else {
+        mount();
+    }
+    return () => {
+        disposed = true;
+        cancelSchedule();
+        removeMountedScene();
+    };
+}
+function createWorldBackground(doc) {
+    const world = doc.createElement('div');
+    world.className = XIAOHEI_SCENE_WORLD_CLASS;
+    return world;
+}
+//# sourceMappingURL=runtime.js.map

package/lib/scene/styles.d.ts

@@ -0,0 +1,7 @@
+/** Stable scene and material ids, shared with lifecycle and browser checks. */
+export declare const XIAOHEI_SCENE_STYLE_ID = "dsh-theme-xiaohei/scene-style";
+export declare const XIAOHEI_SCENE_LAYER_ID = "dsh-theme-xiaohei/scene-layer";
+export declare const XIAOHEI_SCENE_WORLD_CLASS = "xiaohei-scene__world";
+/** Static paired wallpapers; no per-frame effects or session-state dependency. */
+export declare const XIAOHEI_SCENE_CSS: string;
+//# sourceMappingURL=styles.d.ts.map

package/lib/scene/styles.js

@@ -0,0 +1,75 @@
+import { XIAOHEI_WALLPAPER_LIGHT, XIAOHEI_WALLPAPER_DARK, } from '../generated-backgrounds.js';
+import { XIAOHEI_WALLPAPER_CHARACTER_CSS } from './wallpaper-character-styles.js';
+/** Stable scene and material ids, shared with lifecycle and browser checks. */
+export const XIAOHEI_SCENE_STYLE_ID = 'dsh-theme-xiaohei/scene-style';
+export const XIAOHEI_SCENE_LAYER_ID = 'dsh-theme-xiaohei/scene-layer';
+export const XIAOHEI_SCENE_WORLD_CLASS = 'xiaohei-scene__world';
+/** Static paired wallpapers; no per-frame effects or session-state dependency. */
+export const XIAOHEI_SCENE_CSS = `
+body {
+  background: #151C26;
+}
+
+html[data-xiaohei-appearance='light'] body {
+  background: #D4D5D5;
+}
+
+#root {
+  position: relative;
+  z-index: 1;
+}
+
+[id='${XIAOHEI_SCENE_LAYER_ID}'] {
+  position: fixed;
+  inset: 0;
+  /* The decorative canvas uses the large viewport, not the keyboard-reduced
+   * visual viewport. The host UI is still free to resize above it. */
+  height: 100vh;
+  height: 100lvh;
+  container: xiaohei-wallpaper / size;
+  z-index: 0;
+  overflow: hidden;
+  contain: strict;
+  isolation: isolate;
+  pointer-events: none;
+  user-select: none;
+  background: #151C26;
+}
+
+html[data-xiaohei-appearance='light'] [id='${XIAOHEI_SCENE_LAYER_ID}'] {
+  background: #D4D5D5;
+}
+
+.${XIAOHEI_SCENE_WORLD_CLASS} {
+  --xiaohei-wallpaper-wide: url("${XIAOHEI_WALLPAPER_DARK}");
+  position: absolute;
+  inset: 0;
+  display: block;
+  overflow: hidden;
+  pointer-events: none;
+  background-image: var(--xiaohei-wallpaper-wide);
+  background-size: cover;
+  background-position: right center;
+  background-repeat: no-repeat;
+}
+
+html[data-xiaohei-appearance='light'] .${XIAOHEI_SCENE_WORLD_CLASS} {
+  --xiaohei-wallpaper-wide: url("${XIAOHEI_WALLPAPER_LIGHT}");
+}
+
+/* The atmosphere contains no character; responsive poses are placed separately
+ * against measured free space, never by cropping a portrait into messages. */
+${XIAOHEI_WALLPAPER_CHARACTER_CSS}
+
+.${XIAOHEI_SCENE_WORLD_CLASS} > * {
+  width: 100%;
+  height: 100%;
+}
+
+@media (forced-colors: active), print {
+  [id='${XIAOHEI_SCENE_LAYER_ID}'] {
+    display: none;
+  }
+}
+`;
+//# sourceMappingURL=styles.js.map

package/lib/scene/sylva-performance.d.ts

@@ -0,0 +1,11 @@
+export declare const XIAOHEI_SYLVA_PERFORMANCE_MARKER = "data-xiaohei-performance-profile";
+/**
+ * Apply a conservative runtime profile to the registered ThreeUI source.
+ *
+ * The registered source remains byte-for-byte untouched on disk. The profile
+ * only changes the iframe source snapshot before its first navigation, keeping
+ * upstream source verification useful while avoiding the scene's most costly
+ * defaults on long-running DSH sessions.
+ */
+export declare function injectXiaoheiSylvaPerformanceProfile(source: string): string;
+//# sourceMappingURL=sylva-performance.d.ts.map