@realnation/builder-shared-sdk 1.1.1 → 1.2.0

package/README.md

@@ -7,6 +7,7 @@
 - **HTTP客户端共享**: 提供统一的`axios`实例，自动处理鉴权Token，避免在每个Remote中重复配置。
 - **全局事件总线**: 一个简单的发布/订阅系统，用于在Host和Remotes之间或Remotes彼此之间进行解耦的通信。
 - **动态流程控制**: 一个极其灵活的事件驱动流程控制机制，允许Host动态注册回调，由任意Remote在特定时机触发。
+- **交互态 (Interaction State)**: Builder 里配的两态外观与四种触发方式的唯一实现，模块自渲染的元件调一下就和平台表现一致。见 [`src/interaction/README.md`](src/interaction/README.md)。
 
 ## 📦 安装
 

package/dist/interaction/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Interaction State — the two-appearance model shared by the platform editor,
+ * the runner and every module.
+ *
+ * An element configured in the Builder carries a normal appearance and a
+ * "selected" one. This module owns the single definition of what those
+ * properties mean and how they turn into CSS, so a module never has to
+ * reverse-engineer the runner to make its own elements behave the same way.
+ *
+ * Framework-free by construction: pure functions over the property bag. The
+ * Vue adapter (`@realnation/builder-shared-sdk/interaction/vue`) adds the
+ * trigger state machine on top and is the entry point most modules want.
+ */
+/** Property keys written by the Builder's Interaction State section. */
+export declare const INTERACTION_KEYS: {
+    readonly easing: "transition-easing";
+    readonly trigger: "transition-trigger";
+    readonly duration: "transition-duration";
+    readonly hold: "transition-hold";
+    readonly bgColor: "selected-bg-color";
+    readonly borderColor: "selected-border-color";
+    readonly rotation: "selected-rotation";
+    readonly scale: "selected-scale";
+    readonly opacity: "selected-opacity";
+};
+export type InteractionTrigger = 'hover' | 'click' | 'appear' | 'loop';
+export declare const INTERACTION_TRIGGERS: readonly InteractionTrigger[];
+/** Anything the Builder stores for one element. Values arrive untyped from the API. */
+export type InteractionProperty = Record<string, unknown>;
+/** The CSS properties this feature is allowed to touch, in camelCase for Vue's :style. */
+export interface InteractionStyle {
+    transition?: string;
+    transform?: string;
+    backgroundColor?: string;
+    borderColor?: string;
+    opacity?: string;
+}
+/**
+ * Whether the element has an interaction state at all.
+ *
+ * Easing is the section's master switch: `none` (the default) means the
+ * element behaves exactly as it did before this feature existed. Every entry
+ * point checks this first so unconfigured elements stay untouched.
+ */
+export declare function isInteractionEnabled(property: InteractionProperty | null | undefined): boolean;
+export declare function interactionTriggerOf(property: InteractionProperty | null | undefined): InteractionTrigger;
+export declare function interactionDurationOf(property: InteractionProperty | null | undefined): number;
+/**
+ * How long Loop rests in each state before easing into the other one.
+ *
+ * The floor exists because a 0/0 configuration would otherwise flip on every
+ * timer tick, which reads as a flicker rather than an animation.
+ */
+export declare function interactionPeriodOf(property: InteractionProperty | null | undefined): number;
+export interface InteractionStyleOptions {
+    /**
+     * Suppresses the transition for this call. On Appear needs one painted frame
+     * in the selected state with no transition, otherwise the element starts
+     * easing towards normal immediately and the starting point is never seen.
+     */
+    instant?: boolean;
+}
+/**
+ * The style to merge onto an element for a given state.
+ *
+ * Returns only the properties this feature owns, so callers can spread it over
+ * their own base style without losing layout or typography.
+ *
+ * Each selected-* value is applied only when it was actually configured —
+ * an unset colour must inherit the normal appearance rather than reset it.
+ */
+export declare function interactionStyle(property: InteractionProperty | null | undefined, active: boolean, options?: InteractionStyleOptions): InteractionStyle;
+//# sourceMappingURL=index.d.ts.map

package/dist/interaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wEAAwE;AACxE,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AACvE,eAAO,MAAM,oBAAoB,EAAE,SAAS,kBAAkB,EAAyC,CAAC;AAExG,uFAAuF;AACvF,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG9F;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,kBAAkB,CAGzG;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG5F;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAChD,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAgClB"}

package/dist/interaction/index.js

@@ -0,0 +1,103 @@
+/**
+ * Interaction State — the two-appearance model shared by the platform editor,
+ * the runner and every module.
+ *
+ * An element configured in the Builder carries a normal appearance and a
+ * "selected" one. This module owns the single definition of what those
+ * properties mean and how they turn into CSS, so a module never has to
+ * reverse-engineer the runner to make its own elements behave the same way.
+ *
+ * Framework-free by construction: pure functions over the property bag. The
+ * Vue adapter (`@realnation/builder-shared-sdk/interaction/vue`) adds the
+ * trigger state machine on top and is the entry point most modules want.
+ */
+/** Property keys written by the Builder's Interaction State section. */
+export const INTERACTION_KEYS = {
+    easing: 'transition-easing',
+    trigger: 'transition-trigger',
+    duration: 'transition-duration',
+    hold: 'transition-hold',
+    bgColor: 'selected-bg-color',
+    borderColor: 'selected-border-color',
+    rotation: 'selected-rotation',
+    scale: 'selected-scale',
+    opacity: 'selected-opacity',
+};
+export const INTERACTION_TRIGGERS = ['hover', 'click', 'appear', 'loop'];
+const num = (value, fallback) => {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : fallback;
+};
+/**
+ * Whether the element has an interaction state at all.
+ *
+ * Easing is the section's master switch: `none` (the default) means the
+ * element behaves exactly as it did before this feature existed. Every entry
+ * point checks this first so unconfigured elements stay untouched.
+ */
+export function isInteractionEnabled(property) {
+    if (!property)
+        return false;
+    return String(property[INTERACTION_KEYS.easing] ?? 'none') !== 'none';
+}
+export function interactionTriggerOf(property) {
+    const raw = String(property?.[INTERACTION_KEYS.trigger] ?? 'hover');
+    return INTERACTION_TRIGGERS.includes(raw) ? raw : 'hover';
+}
+export function interactionDurationOf(property) {
+    return num(property?.[INTERACTION_KEYS.duration], 400);
+}
+/**
+ * How long Loop rests in each state before easing into the other one.
+ *
+ * The floor exists because a 0/0 configuration would otherwise flip on every
+ * timer tick, which reads as a flicker rather than an animation.
+ */
+export function interactionPeriodOf(property) {
+    const hold = Math.max(0, num(property?.[INTERACTION_KEYS.hold], 600));
+    return Math.max(120, interactionDurationOf(property) + hold);
+}
+/**
+ * The style to merge onto an element for a given state.
+ *
+ * Returns only the properties this feature owns, so callers can spread it over
+ * their own base style without losing layout or typography.
+ *
+ * Each selected-* value is applied only when it was actually configured —
+ * an unset colour must inherit the normal appearance rather than reset it.
+ */
+export function interactionStyle(property, active, options = {}) {
+    if (!isInteractionEnabled(property))
+        return {};
+    const bag = property;
+    const easing = String(bag[INTERACTION_KEYS.easing]);
+    const duration = interactionDurationOf(bag);
+    const style = {};
+    if (options.instant) {
+        style.transition = 'none';
+    }
+    else if (duration > 0) {
+        style.transition = ['transform', 'background-color', 'border-color', 'opacity']
+            .map((prop) => `${prop} ${duration}ms ${easing}`)
+            .join(', ');
+    }
+    if (!active)
+        return style;
+    const bg = bag[INTERACTION_KEYS.bgColor];
+    if (bg && bg !== 'transparent')
+        style.backgroundColor = String(bg);
+    const border = bag[INTERACTION_KEYS.borderColor];
+    if (border)
+        style.borderColor = String(border);
+    // Rotation and scale share one CSS property, so either one being configured
+    // means both have to be written — the other falls back to its neutral value.
+    const rotation = bag[INTERACTION_KEYS.rotation];
+    const scale = bag[INTERACTION_KEYS.scale];
+    if (rotation != null || scale != null) {
+        style.transform = `rotate(${num(rotation, 0)}deg) scale(${num(scale, 100) / 100})`;
+    }
+    const opacity = bag[INTERACTION_KEYS.opacity];
+    if (opacity != null)
+        style.opacity = String(num(opacity, 100) / 100);
+    return style;
+}

package/dist/interaction/vue.d.ts

@@ -0,0 +1,38 @@
+import type { InteractionProperty, InteractionStyle } from './index.js';
+/** One element to drive: a stable key plus the properties the Builder stored for it. */
+export interface InteractionEntry {
+    key: string;
+    property: InteractionProperty | null | undefined;
+}
+export interface UseInteractionStateOptions {
+    /** Timer injection points, for tests and for hosts with their own scheduler. */
+    setTimer?: (fn: () => void, ms: number) => unknown;
+    clearTimer?: (handle: unknown) => void;
+    /** Schedules the frame after next. Defaults to double rAF, or a macrotask. */
+    nextFrame?: (fn: () => void) => void;
+}
+export interface InteractionStateApi {
+    /**
+     * The style to merge onto an element.
+     *
+     * `active` overrides the internal state — that is the hook for modules whose
+     * selection has its own meaning. Leave it out to follow the configured trigger.
+     */
+    style(property: InteractionProperty | null | undefined, key: string, active?: boolean): InteractionStyle;
+    /** Event handlers to v-bind. Empty unless the trigger is Hover / Press or Click. */
+    bind(property: InteractionProperty | null | undefined, key: string): Record<string, () => void>;
+    /**
+     * Restarts the timed triggers for exactly these elements.
+     *
+     * Call whenever the visible set changes — a new page, a new ratio. On Appear
+     * replays and Loop re-times, which is what "appears" means to a player who
+     * navigated back to a page they have already seen.
+     */
+    sync(entries: InteractionEntry[]): void;
+    /** Drops every timer and state. Called automatically on unmount. */
+    stop(): void;
+    isActive(key: string): boolean;
+    setActive(key: string, on: boolean): void;
+}
+export declare function useInteractionState(options?: UseInteractionStateOptions): InteractionStateApi;
+//# sourceMappingURL=vue.d.ts.map

package/dist/interaction/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/interaction/vue.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExE,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACzG,oFAAoF;IACpF,IAAI,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IAChG;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACxC,oEAAoE;IACpE,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3C;AAUD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,mBAAmB,CA8EjG"}

package/dist/interaction/vue.js

@@ -0,0 +1,107 @@
+/**
+ * Vue 3 adapter for Interaction State.
+ *
+ * Import from '@realnation/builder-shared-sdk/interaction/vue'. The core at
+ * '/interaction' is framework-free; the trigger state machine lives here
+ * because it needs reactivity to repaint when a timer flips a state.
+ *
+ * Two kinds of caller, one implementation:
+ *
+ *   • The runner and any module that lets the platform drive the state —
+ *     bind() wires the pointer events, sync() starts the timed triggers.
+ *
+ *   • A module whose "selected" means something of its own (which answer the
+ *     player picked, which card is face up) — pass that boolean to style() and
+ *     skip bind()/sync() entirely. The appearance still matches the platform.
+ *
+ * Returned by a factory rather than by a per-element composable: modules render
+ * their elements in a v-for, and a composable cannot be called from a loop.
+ */
+import { getCurrentInstance, onUnmounted, reactive } from 'vue';
+import { interactionPeriodOf, interactionStyle, interactionTriggerOf, isInteractionEnabled, } from './index.js';
+const defaultNextFrame = (fn) => {
+    if (typeof requestAnimationFrame === 'function') {
+        requestAnimationFrame(() => requestAnimationFrame(fn));
+        return;
+    }
+    setTimeout(fn, 0);
+};
+export function useInteractionState(options = {}) {
+    const setTimer = options.setTimer ?? ((fn, ms) => setInterval(fn, ms));
+    const clearTimer = options.clearTimer ?? ((handle) => clearInterval(handle));
+    const nextFrame = options.nextFrame ?? defaultNextFrame;
+    const active = reactive({});
+    // Separate from `active` because On Appear is active *without* a transition
+    // for its first frame; one boolean cannot say both things.
+    const instant = reactive({});
+    const timers = new Map();
+    // Guards the deferred On Appear callback: by the time the frame lands the
+    // player may already have navigated on, and the element is gone.
+    let generation = 0;
+    const stop = () => {
+        timers.forEach((handle) => clearTimer(handle));
+        timers.clear();
+        generation += 1;
+    };
+    const api = {
+        style(property, key, forced) {
+            const on = forced ?? active[key] ?? false;
+            return interactionStyle(property, on, { instant: instant[key] === true });
+        },
+        bind(property, key) {
+            if (!isInteractionEnabled(property))
+                return {};
+            const trigger = interactionTriggerOf(property);
+            if (trigger === 'click') {
+                // Deliberately not stopping propagation: the element may also carry a
+                // link or a node connection, and the visual state is only a layer on top.
+                return { onClick: () => { active[key] = !active[key]; } };
+            }
+            if (trigger !== 'hover')
+                return {};
+            const on = () => { active[key] = true; };
+            const off = () => { active[key] = false; };
+            return {
+                onPointerenter: on,
+                onPointerdown: on,
+                onPointerleave: off,
+                onPointerup: off,
+                onPointercancel: off,
+            };
+        },
+        sync(entries) {
+            stop();
+            const mine = generation;
+            for (const { key, property } of entries) {
+                if (!isInteractionEnabled(property))
+                    continue;
+                const trigger = interactionTriggerOf(property);
+                if (trigger === 'appear') {
+                    instant[key] = true;
+                    active[key] = true;
+                    nextFrame(() => {
+                        if (generation !== mine)
+                            return;
+                        instant[key] = false;
+                        active[key] = false;
+                    });
+                }
+                else if (trigger === 'loop') {
+                    active[key] = false;
+                    timers.set(key, setTimer(() => { active[key] = !active[key]; }, interactionPeriodOf(property)));
+                }
+                else {
+                    active[key] = false;
+                }
+            }
+        },
+        stop,
+        isActive: (key) => active[key] === true,
+        setActive: (key, on) => { active[key] = on; },
+    };
+    // Usable outside a component too (tests, a plain store); onUnmounted would
+    // only warn there. Those callers own the lifetime and call stop() themselves.
+    if (getCurrentInstance())
+        onUnmounted(stop);
+    return api;
+}

package/dist/runtime/facade.d.ts.map

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

package/dist/runtime/facade.js

@@ -291,10 +291,15 @@ export class RuntimeFacade {
      * callers get a MediaStream.
      */
     async openStream() {
+        // A Runtime session has one colour-stream receiver. Replacing an active
+        // receiver would silently freeze the first consumer, so callers must
+        // explicitly release it with camera.stopStream() before another component
+        // can acquire the stream.
+        if (this.pc)
+            throw new Error('camera stream is already in use');
         const RTC = globalThis.RTCPeerConnection;
         if (!RTC)
             throw new Error('WebRTC is not available in this environment');
-        this.closeStream(); // one receiver per Runtime session
         const pc = new RTC({ iceServers: [] }); // local-only: no STUN needed
         this.pc = pc;
         pc.addTransceiver('video', { direction: 'recvonly' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realnation/builder-shared-sdk",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "type": "module",
   "private": false,
   "exports": {
@@ -16,6 +16,14 @@
     "./runtime/vue": {
       "types": "./dist/runtime/vue/index.d.ts",
       "import": "./dist/runtime/vue/index.js"
+    },
+    "./interaction": {
+      "types": "./dist/interaction/index.d.ts",
+      "import": "./dist/interaction/index.js"
+    },
+    "./interaction/vue": {
+      "types": "./dist/interaction/vue.d.ts",
+      "import": "./dist/interaction/vue.js"
     }
   },
   "files": [