@netless/fastboard-core 0.2.12 → 0.3.0-canary.1

package/src/helpers/emitter.ts

@@ -1,21 +0,0 @@
-export type FastboardListener<T> = (event: T) => void;
-
-export class FastboardEmitter<T> {
-  listeners = new Set<FastboardListener<T>>();
-
-  get length(): number {
-    return this.listeners.size;
-  }
-
-  dispatch(message: T) {
-    this.listeners.forEach(callback => callback(message));
-  }
-
-  addListener(listener: FastboardListener<T>) {
-    this.listeners.add(listener);
-  }
-
-  removeListener(listener: FastboardListener<T>) {
-    this.listeners.delete(listener);
-  }
-}

package/src/helpers/utils.ts

@@ -1,78 +0,0 @@
-import type { ConvertedFile, JoinRoomParams, ReplayRoomParams, SceneDefinition, Size } from "white-web-sdk";
-import { WindowManager } from "@netless/window-manager";
-
-export function noop() {
-  /* noop */
-}
-
-export function safe_not_equal(a: unknown, b: unknown) {
-  return a != a ? b == b : a !== b || (a && typeof a === "object") || typeof a === "function";
-}
-
-export function getImageSize(url: string, fallback: Size) {
-  return new Promise<Size>(resolve => {
-    const img = new Image();
-    img.onload = () => resolve(img);
-    img.onerror = () => resolve(fallback);
-    img.src = url;
-  });
-}
-
-export function makeSlideParams(scenes: SceneDefinition[]) {
-  const emptyScenes: SceneDefinition[] = [];
-  let taskId = "";
-  let url = "";
-
-  // e.g. "ppt(x)://cdn/prefix/dynamicConvert/{taskId}/1.slide"
-  const pptSrcRE = /^pptx?(?<prefix>:\/\/\S+?dynamicConvert)\/(?<taskId>\w+)\//;
-
-  for (const { name, ppt } of scenes) {
-    // make sure scenesWithoutPPT.length === scenes.length
-    emptyScenes.push({ name });
-
-    if (!ppt || !ppt.src.startsWith("ppt")) {
-      continue;
-    }
-    const match = pptSrcRE.exec(ppt.src);
-    if (!match || !match.groups) {
-      continue;
-    }
-    taskId = match.groups.taskId;
-    url = "https" + match.groups.prefix;
-    break;
-  }
-
-  return { emptyScenes, taskId, url };
-}
-
-export function convertedFileToScene(f: ConvertedFile, i: number) {
-  return {
-    name: String(i + 1),
-    ppt: {
-      src: f.conversionFileUrl,
-      width: f.width,
-      height: f.height,
-      previewURL: f.preview,
-    },
-  };
-}
-
-export function ensureWindowManager<T extends JoinRoomParams | ReplayRoomParams>(joinRoom: T): T {
-  if (!joinRoom.invisiblePlugins || !joinRoom.invisiblePlugins.includes(WindowManager)) {
-    joinRoom.invisiblePlugins = [...(joinRoom.invisiblePlugins || []), WindowManager];
-  }
-  return joinRoom;
-}
-
-// Copy from https://github.com/crimx/side-effect-manager/blob/main/src/gen-uid.ts
-const SOUP = "!#%()*+,-./:;=?@[]^_`{|}~" + "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-const SOUP_LEN = SOUP.length;
-const ID_LEN = 20;
-const reusedIdCarrier = /* @__PURE__ */ Array(ID_LEN);
-
-export function genUID() {
-  for (let i = 0; i < ID_LEN; i++) {
-    reusedIdCarrier[i] = SOUP.charAt(Math.random() * SOUP_LEN);
-  }
-  return reusedIdCarrier.join("");
-}

package/src/helpers/value.ts

@@ -1,84 +0,0 @@
-import { FastboardEmitter } from "./emitter";
-import { noop, safe_not_equal } from "./utils";
-
-export type FastboardDisposer = () => void;
-
-export interface FastboardReadable<T> {
-  readonly value: T;
-  subscribe(callback: (value: T) => void): FastboardDisposer;
-  reaction(callback: (value: T) => void): FastboardDisposer;
-}
-
-export interface FastboardWritable<T, SetFn = (value: T) => void> extends FastboardReadable<T> {
-  setValue: SetFn;
-}
-
-export interface FastboardInternalValue<T> extends FastboardWritable<T> {
-  dispose: FastboardDisposer;
-}
-
-/**
- * Create a readonly, reactive value.
- * @example
- * createValue(manager.getMainViewSceneIndex(), (set) => {
- *   manager.emitter.on("mainViewSceneIndexChanged", set)
- *   return () => manager.emitter.off("mainViewSceneIndexChanged", set)
- * })
- */
-export function createValue<T>(
-  value: T,
-  effect: (set: (value: T) => void) => FastboardDisposer | void
-): FastboardReadable<T>;
-
-/**
- * Create a writable, reactive value.
- * @example
- * createValue(manager.getMainViewSceneIndex(), (set) => {
- *   manager.emitter.on("mainViewSceneIndexChanged", set)
- *   return () => manager.emitter.off("mainViewSceneIndexChanged", set)
- * }, (newValue) => {
- *   manager.setMainViewSceneIndex(newValue)
- * })
- */
-export function createValue<T, SetFn = (value: T) => void>(
-  value: T,
-  effect: (set: (value: T) => void) => FastboardDisposer | void,
-  set: (value: T) => void
-): FastboardWritable<T, SetFn>;
-
-export function createValue<T>(
-  value: T,
-  effect: (set: (value: T) => void) => FastboardDisposer | void,
-  setValue: (value: T) => void = noop
-): FastboardInternalValue<T> {
-  const emitter = new FastboardEmitter<T>();
-
-  function set(newValue: T) {
-    if (safe_not_equal(value, newValue)) {
-      emitter.dispatch((value = newValue));
-    }
-  }
-
-  const dispose = effect(set) || noop;
-
-  function subscribe(callback: (value: T) => void) {
-    emitter.addListener(callback);
-    callback(value);
-    return () => emitter.removeListener(callback);
-  }
-
-  function reaction(callback: (value: T) => void) {
-    emitter.addListener(callback);
-    return () => emitter.removeListener(callback);
-  }
-
-  return {
-    get value() {
-      return value;
-    },
-    subscribe,
-    reaction,
-    setValue,
-    dispose,
-  };
-}

package/src/impl/player.ts

@@ -1,122 +0,0 @@
-import type { Player, PlayerCallbacks, PlayerState, ViewCallbacks, WhiteWebSdk } from "white-web-sdk";
-import type { PublicEvent, WindowManager } from "@netless/window-manager";
-import type { FastboardDisposer, FastboardInternalValue } from "../helpers/value";
-
-import { createValue } from "../helpers/value";
-
-class FastboardPlayerBase {
-  public constructor(readonly sdk: WhiteWebSdk, readonly player: Player, readonly manager: WindowManager) {}
-
-  protected readonly _disposers: FastboardDisposer[] = [];
-  protected _destroyed = false;
-  protected _assertNotDestroyed() {
-    if (this._destroyed) {
-      throw new Error("[FastboardPlayer] Can not call any method on destroyed FastboardPlayer.");
-    }
-  }
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  protected createValue: typeof createValue = (...args: [any, any]): any => {
-    const value = createValue(...args);
-    this._disposers.push((value as FastboardInternalValue<unknown>).dispose);
-    return value;
-  };
-
-  protected _addPlayerListener<K extends keyof PlayerCallbacks, T = PlayerCallbacks[K]>(
-    name: K,
-    listener: T
-  ) {
-    this._assertNotDestroyed();
-    this.player.callbacks.on(name, listener);
-    return () => this.player.callbacks.off(name, listener);
-  }
-
-  protected _addManagerListener<K extends keyof PublicEvent>(name: K, set: (value: PublicEvent[K]) => void) {
-    this._assertNotDestroyed();
-    this.manager.emitter.on(name, set);
-    return () => this.manager.emitter.off(name, set);
-  }
-
-  protected _addMainViewListener<K extends keyof ViewCallbacks, T = ViewCallbacks[K]>(name: K, listener: T) {
-    this._assertNotDestroyed();
-    this.manager.mainView.callbacks.on(name, listener);
-    return () => this.manager.mainView.callbacks.off(name, listener);
-  }
-
-  public destroy() {
-    this._disposers.forEach(dispose => dispose());
-    this._disposers.length = 0;
-    this._destroyed = true;
-    this.manager.destroy();
-    this.player.callbacks.off();
-  }
-}
-
-export class FastboardPlayer extends FastboardPlayerBase {
-  /**
-   * Render this player to some DOM.
-   */
-  bindContainer(container: HTMLElement) {
-    this._assertNotDestroyed();
-    this.manager.bindContainer(container);
-  }
-
-  /**
-   * Move window-manager's collector to some place.
-   */
-  bindCollector(container: HTMLElement) {
-    this._assertNotDestroyed();
-    this.manager.bindCollectorContainer(container);
-  }
-
-  readonly currentTime = this.createValue(
-    this.player.progressTime,
-    set => this._addPlayerListener("onProgressTimeChanged", set),
-    this.player.seekToProgressTime.bind(this.player)
-  );
-
-  readonly phase = this.createValue(this.player.phase, set => this._addPlayerListener("onPhaseChanged", set));
-
-  readonly canplay = this.createValue(this.player.isPlayable, set =>
-    this._addPlayerListener("onIsPlayableChanged", set)
-  );
-
-  private _setSpeed!: (value: number) => void;
-  readonly speed = this.createValue(
-    this.player.playbackSpeed,
-    set => {
-      this._setSpeed = set;
-    },
-    value => {
-      this.player.playbackSpeed = value;
-      this._setSpeed(value);
-    }
-  );
-
-  readonly state = this.createValue<PlayerState | null>(null, set => {
-    const update = () => set(this.player.state);
-    const dispose1 = this._addPlayerListener("onLoadFirstFrame", update);
-    const dispose2 = this._addPlayerListener("onPlayerStateChanged", update);
-    return () => (dispose1(), dispose2());
-  });
-
-  seek(timestamp: number) {
-    this._assertNotDestroyed();
-    return this.player.seekToProgressTime(timestamp);
-  }
-
-  play() {
-    this._assertNotDestroyed();
-    this.player.play();
-  }
-
-  pause() {
-    this._assertNotDestroyed();
-    this.player.pause();
-  }
-
-  stop() {
-    this._assertNotDestroyed();
-    this.player.stop();
-  }
-}

package/src/minimal.ts

@@ -1,153 +0,0 @@
-import type {
-  Displayer,
-  HotKeys,
-  JoinRoomParams,
-  PlayerCallbacks,
-  ReplayRoomParams,
-  Room,
-  RoomCallbacks,
-  WhiteWebSdkConfiguration,
-} from "white-web-sdk";
-import type { MountParams } from "@netless/window-manager";
-
-import { contentModeScale, DefaultHotKeys, WhiteWebSdk } from "white-web-sdk";
-import { WindowManager } from "@netless/window-manager";
-
-import { ensureWindowManager } from "./helpers/utils";
-import { FastboardApp } from "./impl/app";
-import { FastboardPlayer } from "./impl/player";
-
-export type { FastboardReadable, FastboardWritable } from "./helpers/value";
-
-export type { AppsStatus, InsertDocsDynamic, InsertDocsParams, InsertDocsStatic } from "./impl/app";
-
-export type { FastboardApp, FastboardPlayer };
-
-export interface FastboardOptions {
-  sdkConfig: Omit<WhiteWebSdkConfiguration, "useMobXState"> & { region: string };
-  joinRoom: Omit<JoinRoomParams, "useMultiViews" | "disableNewPencil" | "disableMagixEventDispatchLimit"> & {
-    callbacks?: Partial<RoomCallbacks>;
-  };
-  managerConfig?: Omit<MountParams, "room">;
-}
-
-/**
- * Create a FastboardApp instance.
- * @example
- * let app = await createFastboard({
- *   sdkConfig: {
- *     appIdentifier: import.meta.env.VITE_APPID,
- *     region: "cn-hz",
- *   },
- *   joinRoom: {
- *     uid: unique_id,
- *     uuid: import.meta.env.VITE_ROOM_UUID,
- *     roomToken: import.meta.env.VITE_ROOM_TOKEN,
- *   },
- * })
- */
-export async function createFastboard({
-  sdkConfig,
-  joinRoom: { callbacks, ...joinRoomParams },
-  managerConfig,
-}: FastboardOptions) {
-  const sdk = new WhiteWebSdk({
-    ...sdkConfig,
-    useMobXState: true,
-  });
-
-  const hotKeys: Partial<HotKeys> = {
-    ...DefaultHotKeys,
-    changeToSelector: "s",
-    changeToLaserPointer: "z",
-    changeToPencil: "p",
-    changeToRectangle: "r",
-    changeToEllipse: "c",
-    changeToEraser: "e",
-    changeToText: "t",
-    changeToStraight: "l",
-    changeToArrow: "a",
-    changeToHand: "h",
-  };
-
-  const room = await sdk.joinRoom(
-    {
-      floatBar: true,
-      hotKeys,
-      ...ensureWindowManager(joinRoomParams),
-      useMultiViews: true,
-      disableNewPencil: false,
-      disableMagixEventDispatchLimit: true,
-    },
-    callbacks
-  );
-
-  const manager = await WindowManager.mount({
-    cursor: true,
-    ...managerConfig,
-    room,
-  });
-
-  manager.mainView.setCameraBound({
-    minContentMode: contentModeScale(0.3),
-    maxContentMode: contentModeScale(3),
-  });
-
-  return new FastboardApp(sdk, room, manager, hotKeys);
-}
-
-export interface FastboardReplayOptions {
-  sdkConfig: Omit<WhiteWebSdkConfiguration, "useMobXState"> & { region: string };
-  replayRoom: Omit<ReplayRoomParams, "useMultiViews"> & {
-    callbacks?: Partial<PlayerCallbacks>;
-  };
-  managerConfig?: Omit<MountParams, "room">;
-}
-
-/**
- * Create a FastboardPlayer instance.
- * @example
- * let app = await replayFastboard({
- *   sdkConfig: {
- *     appIdentifier: import.meta.env.VITE_APPID,
- *     region: "cn-hz",
- *   },
- *   replayRoom: {
- *     uid: unique_id,
- *     uuid: import.meta.env.VITE_ROOM_UUID,
- *     roomToken: import.meta.env.VITE_ROOM_TOKEN,
- *   },
- * })
- */
-export async function replayFastboard({
-  sdkConfig,
-  replayRoom: { callbacks, ...replayRoomParams },
-  managerConfig,
-}: FastboardReplayOptions) {
-  const sdk = new WhiteWebSdk({
-    ...sdkConfig,
-    useMobXState: true,
-  });
-
-  const player = await sdk.replayRoom(
-    {
-      ...ensureWindowManager(replayRoomParams),
-      useMultiViews: true,
-    },
-    callbacks
-  );
-
-  const managerPromise = WindowManager.mount({
-    cursor: true,
-    ...managerConfig,
-    room: player as Displayer as Room,
-  });
-
-  player.play();
-  const manager = await managerPromise;
-  player.pause();
-
-  return new FastboardPlayer(sdk, player, manager);
-}
-
-import "./behaviors/register-apps";