@zk-tech/bedrock 0.0.1 → 0.1.0

package/src/undo-redo-stack/state-stack.ts

@@ -1,133 +0,0 @@
-import type { Event } from '../event';
-import { Emitter } from '../event';
-
-export class StateUndoRedoStack<T> {
-  // 当undo结束后触发
-  public onDidUndo: Event<[T]>;
-  // 当redo结束后触发
-  public onDidRedo: Event<[T]>;
-  // 当栈发生变化时触发
-  public onStackChange: Event<[]>;
-
-  protected readonly _past: T[] = [];
-  protected readonly _future: T[] = [];
-
-  protected _onDidUndo = new Emitter<[T]>();
-  protected _onDidRedo = new Emitter<[T]>();
-  protected _onStackChange = new Emitter<[]>();
-
-  constructor(
-    protected _currentState: T,
-    protected readonly _limitSize = Infinity,
-  ) {
-    this.onDidUndo = this._onDidUndo.event;
-    this.onDidRedo = this._onDidRedo.event;
-    this.onStackChange = this._onStackChange.event;
-  }
-
-  get currentState() {
-    return this._currentState;
-  }
-
-  /**
-   * 进行撤销
-   */
-  public undo() {
-    if (!this.canUndo()) {
-      return;
-    }
-    this._future.push(this._currentState);
-    this._currentState = this._past.pop()!;
-    this._onDidUndo.fire(this._currentState);
-    this._onStackChange.fire();
-  }
-
-  /**
-   * 进行重做
-   *
-   * 注意：该方法不允许被子类重写
-   */
-  public redo() {
-    if (!this.canRedo()) {
-      return;
-    }
-    this._past.push(this._currentState);
-    this._currentState = this._future.pop()!;
-    this._onDidRedo.fire(this._currentState);
-    this._onStackChange.fire();
-  }
-
-  /**
-   * 追加操作进入栈中
-   *
-   * 注意：该方法不允许被子类重写
-   */
-  public pushElement(element: T) {
-    this._future.length = 0;
-    if (this._isOverflow(element)) {
-      this._past.shift();
-    }
-    if (this._currentState) {
-      this._past.push(this._currentState);
-    }
-    this._currentState = element;
-    this._onStackChange.fire();
-  }
-
-  /**
-   * 是否可以撤销
-   */
-  public canUndo(): boolean {
-    return this._past.length > 0;
-  }
-
-  /**
-   * 是否可以重做
-   */
-  public canRedo(): boolean {
-    return this._future.length > 0;
-  }
-
-  /**
-   * 清除undo
-   */
-  public clearUndo(): void {
-    if (this._past.length === 0) {
-      return;
-    }
-    this._past.length = 0;
-    this._onStackChange.fire();
-  }
-
-  /**
-   * 清除redo
-   */
-  public clearRedo(): void {
-    if (this._future.length === 0) {
-      return;
-    }
-    this._future.length = 0;
-    this._onStackChange.fire();
-  }
-
-  /**
-   * 重置栈
-   * 清空undo和redo
-   */
-  public reset(state: T): void {
-    if (this._past.length === 0 && this._future.length === 0 && this._currentState === state) {
-      return;
-    }
-    this._past.length = 0;
-    this._future.length = 0;
-    this._currentState = state;
-    this._onStackChange.fire();
-  }
-
-  /**
-   * 判断新添加元素，是否会超出栈的大小
-   */
-  protected _isOverflow(_elem: T) {
-    return this._past.length >= this._limitSize;
-  }
-}

package/src/uuid/index.ts

@@ -1,7 +0,0 @@
-export { uuid } from './uuid';
-export { upperCaseUuid } from './uuid';
-
-export { generateUuid } from './uuid';
-export { generateUpperCaseUuid } from './uuid';
-
-export { isUuid } from './uuid';

package/src/uuid/uuid.ts

@@ -1,86 +0,0 @@
-declare const crypto:
-  | undefined
-  | {
-      // https://developer.mozilla.org/en-US/docs/Web/API/Crypto/getRandomValues#browser_compatibility
-      getRandomValues?: (data: Uint8Array) => Uint8Array;
-      // https://developer.mozilla.org/en-US/docs/Web/API/Crypto/randomUUID#browser_compatibility
-      randomUUID?: () => UuidString;
-    };
-
-const pattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-
-type UuidString = `${string}-${string}-${string}-${string}-${string}`;
-
-/**
- * 判断一个字符串，是否是标准的UUID
- */
-export function isUuid(value: string): boolean {
-  return pattern.test(value);
-}
-
-/**
- * 生成一个标准的UUID
- */
-export const generateUuid = ((): (() => UuidString) => {
-  // 优先使用 randomUUID
-  if (typeof crypto === 'object' && typeof crypto.randomUUID === 'function') {
-    return crypto.randomUUID.bind(crypto);
-  }
-
-  // 其次尝试使用 randomValues
-  let getRandomValues: (bucket: Uint8Array) => Uint8Array;
-  if (typeof crypto === 'object' && typeof crypto.getRandomValues === 'function') {
-    getRandomValues = crypto.getRandomValues.bind(crypto);
-  } else {
-    getRandomValues = function (bucket: Uint8Array): Uint8Array {
-      for (let i = 0; i < bucket.length; i++) {
-        bucket[i] = Math.floor(Math.random() * 256);
-      }
-      return bucket;
-    };
-  }
-
-  const data = new Uint8Array(16);
-  const hex: string[] = [];
-  for (let i = 0; i < 256; i++) {
-    hex.push(i.toString(16).padStart(2, '0'));
-  }
-
-  return (): UuidString => {
-    getRandomValues(data);
-
-    data[6] = (data[6] & 0x0f) | 0x40;
-    data[8] = (data[8] & 0x3f) | 0x80;
-
-    let i = 0;
-    let result = '';
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += '-';
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += '-';
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += '-';
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += '-';
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    result += hex[data[i++]];
-    return result as UuidString;
-  };
-})();
-
-/**
- * 生成一个标准且字母大写的UUID
- */
-export const generateUpperCaseUuid = () => generateUuid().toUpperCase();
-export const uuid = generateUuid;
-export const upperCaseUuid = generateUpperCaseUuid;

package/src/worker/cors-worker.ts

@@ -1,38 +0,0 @@
-/**
- * 将 worker 转 inline worker 的帮助函数，为了性能考虑，SCM 会在构建线上项目时将资源依赖都打包上传到 cdn 处。
- * 包括 worker.js，但是这种策略违反同源加载策略。所以为了应对这种问题，我们需要将 worker 进行强制内联处理.
- *
- * 由于 webpack AST 的约束限制.必须严格使用以下语法申明 worker：
- * new Worker(new URL('xxx.js', import.meta.url)
- * 字符上必须严格匹配。所以导入使用 CorsWorker 时，需要将其强行 alias
- * import { CorsWorker as Worker } from '@byted-image/lv-bedrock/worker';
- * )
- */
-import type { IDisposable } from '@/dispose';
-
-export class CorsWorker implements IDisposable {
-  private readonly _worker: Worker;
-
-  constructor(url: string | URL) {
-    const absoluteUrl = new URL(url, window.location.href).toString();
-    const workerSource = `\
-	const urlString = ${JSON.stringify(absoluteUrl)}
-	const originURL = new URL(urlString)
-	const originalImportScripts = self.importScripts
-	self.importScripts = (url) => originalImportScripts.call(self, new URL(url, originURL).toString())
-	importScripts(urlString);
-	`;
-    const blob = new Blob([workerSource], { type: 'application/javascript' });
-    const objectURL = URL.createObjectURL(blob);
-    this._worker = new Worker(objectURL);
-    URL.revokeObjectURL(objectURL);
-  }
-
-  getWorker() {
-    return this._worker;
-  }
-
-  dispose(): void {
-    this._worker.terminate();
-  }
-}

package/src/worker/index.ts

@@ -1,4 +0,0 @@
-export { CorsWorker } from './cors-worker';
-export { PromiseWorkerWorkerThread } from './promise-worker-worker-thread';
-export { PromiseWorkerMainThread } from './promise-worker-main-thread';
-export type { PromiseWorkerRequest, PromiseWorkerResponse } from './promise-worker.interface';

package/src/worker/node_modules/.vitest/results.json

@@ -1 +0,0 @@
-{"version":"1.0.1","results":[[":promise-worker-main-thread.test.ts",{"duration":3,"failed":false}]]}

package/src/worker/promise-worker-main-thread.test.ts

@@ -1,91 +0,0 @@
-import { lvAssert } from '@/assert';
-import { PromiseWorkerMainThread } from './promise-worker-main-thread';
-
-class MockWebWorker {
-  public onmessage: ((e: MessageEvent) => void) | null = null;
-  public postMessage!: (message: any) => void;
-
-  constructor(postMessage: any) {
-    this.postMessage = postMessage;
-  }
-
-  triggerMessage(e: MessageEvent) {
-    this.onmessage!(e);
-  }
-
-  terminate() {
-    // ...
-  }
-}
-
-describe('promise-worker-main-thread', () => {
-  // 普通open
-  test('base1', async () => {
-    const fn1 = vi.fn();
-    const postMessageFn = vi.fn();
-
-    const worker = new MockWebWorker(postMessageFn);
-    worker.onmessage = fn1;
-    const mainThread = new PromiseWorkerMainThread(worker as any as Worker);
-
-    const task = {};
-    const defer = mainThread.sendTaskToWorker(task);
-    expect(postMessageFn).toBeCalledWith(expect.objectContaining(task));
-
-    const [firstArg] = postMessageFn.mock.calls[0];
-
-    const resp = {
-      pid: firstArg.pid,
-      code: 0,
-      data: 1,
-    };
-    const resp1 = {
-      pid: `${firstArg.pid}1111`,
-      code: 0,
-      data: 1,
-    };
-    // @ts-expect-error type error 不去模拟完整的 MessageEvent 对象了。就将就一个用到的数据结构算了
-    expect(() => worker.onmessage({ data: resp1 })).toThrowError();
-    expect(fn1).toBeCalledWith({ data: resp1 }); // 外面的监听正常触发
-
-    await new Promise(process.nextTick);
-
-    // @ts-expect-error type error
-    worker.onmessage({ data: resp });
-    expect(fn1).toBeCalledWith({ data: resp }); // 外面的监听正常触发
-    await new Promise(process.nextTick);
-
-    const res = await defer;
-    expect(res.ok).toBe(true);
-    lvAssert(res.ok)
-    expect(res.code).toBe(0);
-    expect(res.value).toBe(resp.data);
-  });
-
-  test('reject', async () => {
-    const fn1 = vi.fn();
-    const postMessageFn = vi.fn();
-
-    const worker = new MockWebWorker(postMessageFn);
-    worker.onmessage = fn1;
-    const mainThread = new PromiseWorkerMainThread(worker as any as Worker);
-
-    const task = {};
-    const defer = mainThread.sendTaskToWorker(task);
-    expect(postMessageFn).toBeCalledWith(expect.objectContaining(task));
-
-    const [firstArg] = postMessageFn.mock.calls[0];
-    const resp = {
-      pid: firstArg.pid,
-      code: -1,
-      msg: 'error',
-    };
-    // @ts-expect-error type error 不去模拟完整的 MessageEvent 对象了。就将就一个用到的数据结构算了
-    worker.onmessage({ data: resp });
-
-    const res = await defer;
-    expect(res.ok).toBe(false);
-    expect(res.code).toBe(-1);
-    expect(res.msg).toBe('error');
-  });
-});

package/src/worker/promise-worker-main-thread.ts

@@ -1,76 +0,0 @@
-/**
- * worker 包装函数，允许将事件处理成 promise 形式.
- */
-import { uuid } from '@/uuid';
-import type { Deferred } from '@/promise';
-import { defer } from '@/promise';
-import { lvAssert } from '@/assert';
-import { makeError, makeOk, makeOkWith, type ILvErrorOr } from '@/error';
-import type { PromiseWorkerRawRequest, PromiseWorkerRequest, PromiseWorkerResponse } from './promise-worker.interface';
-
-export class PromiseWorkerMainThread {
-  private readonly _deferMap: Map<string, Deferred<any>> = new Map();
-
-  constructor(private readonly _worker: Worker) {
-    const preMessageHandler = _worker.onmessage?.bind(_worker);
-    this._worker.onmessage = (event) => {
-      // 如果 worker 在传递进来之前已经绑定过 onmessage.
-      // 那么做一层代理确保原本的监听函数不会失效丢失
-      preMessageHandler?.(event);
-
-      this._receiveWorkerMsgHandler(event?.data);
-    };
-  }
-
-  /**
-   * 将任务下派给 worker 并等待其返回
-   * - 由于 worker 本身运行在独立线程中，所以没必要专门为其设计任务执行队列.
-   * */
-  public sendTaskToWorker<ReqT, ResT>(req: Omit<PromiseWorkerRequest<ReqT> | PromiseWorkerRawRequest, 'pid'> = {}): Promise<ILvErrorOr<ResT>> {
-    const taskDefer = defer<ILvErrorOr<ResT>>();
-    const worker = this._worker;
-    const id = uuid();
-
-    this._deferMap.set(id, taskDefer);
-    worker.postMessage({
-      pid: id,
-      ...req,
-    } as PromiseWorkerRequest<ReqT>);
-    return taskDefer.promise;
-  }
-
-  private _receiveWorkerMsgHandler<ResT>(res?: PromiseWorkerResponse<ResT>) {
-    if (!res) {
-      return;
-    }
-    if (!this._check(res)) {
-      return;
-    }
-
-    const { pid, code, msg, data } = res;
-    const task = this._deferMap.get(pid) as Deferred<ILvErrorOr<ResT>>;
-    lvAssert(task, `task-${pid} is not defined`);
-
-    if (code === 0) {
-      if (!data) {
-        task.resolve(makeOk());
-      } else {
-        task.resolve(makeOkWith<ResT>(data));
-      }
-    } else {
-      task.resolve(makeError(code, msg ?? 'no message error.'));
-    }
-    this._deferMap.delete(pid);
-  }
-
-  private _check<ResT>(res?: PromiseWorkerResponse<ResT>): res is PromiseWorkerResponse<ResT> {
-    if (!res) {
-      return false;
-    }
-    const keyMap = ['pid'];
-    if (keyMap.map((key) => key in res).includes(false)) {
-      return false;
-    }
-    return true;
-  }
-}

package/src/worker/promise-worker-worker-thread.ts

@@ -1,64 +0,0 @@
-/**
- * worker 包装函数，允许将事件处理成 promise 形式.
- */
-import type { PromiseWorkerRawRequest, PromiseWorkerRequest, PromiseWorkerResponse } from './promise-worker.interface';
-
-export abstract class PromiseWorkerWorkerThread {
-  constructor() {
-    self.onmessage = (event) => {
-      this._receiveMainThreadMsgHandler(event?.data);
-    };
-  }
-
-  /**
-   * 将任务下派给 worker 并等待其返回
-   * - 由于 worker 本身运行在独立线程中，所以没必要专门为其设计任务执行队列.
-   * */
-  protected _sendSuccessToMainThread<ReqT, ResT>(
-    req: PromiseWorkerRequest<ReqT> | PromiseWorkerRawRequest,
-    result?: ResT,
-  ): void {
-    self.postMessage({
-      pid: req.pid,
-      code: 0,
-      data: result,
-    } as PromiseWorkerResponse<ResT>);
-  }
-
-  protected _sendFailToMainThread<ReqT>(
-    req: PromiseWorkerRequest<ReqT> | PromiseWorkerRawRequest,
-    errCode: number,
-    message?: string,
-  ): void {
-    self.postMessage({
-      pid: req.pid,
-      code: errCode,
-      msg: message,
-    } as PromiseWorkerResponse<any>);
-  }
-
-  protected abstract _messageHandler(req: PromiseWorkerRequest<any> | PromiseWorkerRawRequest): void;
-
-  private _receiveMainThreadMsgHandler<ReqT>(req?: PromiseWorkerRequest<ReqT>) {
-    if (!req) {
-      return;
-    }
-    if (!this._check(req)) {
-      return;
-    }
-
-    try {
-      this._messageHandler(req);
-    } catch (err) {
-      this._sendFailToMainThread(req, -1, (err as Error).message ?? 'unknown error.');
-    }
-  }
-
-  private _check<ReqT>(req: PromiseWorkerRequest<ReqT>): req is PromiseWorkerRequest<ReqT> {
-    const keyMap = ['pid'];
-    if (keyMap.map((key) => key in req).includes(false)) {
-      return false;
-    }
-    return true;
-  }
-}

package/src/worker/promise-worker.interface.ts

@@ -1,15 +0,0 @@
-export interface PromiseWorkerRequest<Req> {
-  pid: string;
-  data: Req;
-}
-
-export interface PromiseWorkerRawRequest {
-  pid: string;
-}
-
-export interface PromiseWorkerResponse<Res> {
-  pid: string;
-  code: number;
-  msg?: string;
-  data?: Res;
-}