@planet-matrix/mobius-model 0.1.4 → 0.4.0

package/dist/signal/signal-core/reactive-system.d.ts

@@ -1,161 +0,0 @@
-import type { Flags } from './flags.ts';
-export interface Node {
-    /**
-     * 当前节点的上游连接链中的第一个连接。
-     */
-    headDepLink?: Link | undefined;
-    /**
-     * 当前节点的上游连接链中的最后一个连接。
-     */
-    tailDepLink?: Link | undefined;
-    /**
-     * 当前节点的下游连接链中的第一个连接。
-     */
-    headSubLink?: Link | undefined;
-    /**
-     * 当前节点的下游连接链中的最后一个连接。
-     */
-    tailSubLink?: Link | undefined;
-    /**
-     * 当前节点的标记。
-     */
-    flags: Flags;
-}
-/**
- * 连接用于表示某个节点（下游节点）依赖了某个节点（上游节点）。
- *
- * 多个连接连在一起形成连接链，连接链只有两种情况：
- *
- * 1. 下游连接链：链中所有连接的上游节点相同，通过该链可以找到该上游节点的所有下游节点。
- * 2. 上游连接链：链中所有连接的下游节点相同，通过该链可以找到该下游节点的所有上游节点。
- */
-export interface Link {
-    /**
-     * 连接中的上游节点。
-     */
-    dep: Node;
-    /**
-     * 连接中的上游节点的下游连接链中的上一个连接。（下一个下游连接）
-     */
-    prevSubLink?: Link | undefined;
-    /**
-     * 连接中的上游节点的下游连接链中的下一个连接。（上一个下游连接）
-     */
-    nextSubLink?: Link | undefined;
-    /**
-     * 连接中的下游节点。
-     */
-    sub: Node;
-    /**
-     * 连接中的下游节点的上游连接链中的上一个连接。（上一个上游连接）
-     */
-    prevDepLink?: Link | undefined;
-    /**
-     * 连接中的下游节点的上游连接链中的下一个连接。（下一个上游连接）
-     */
-    nextDepLink?: Link | undefined;
-}
-export interface CreateReactiveSystemOptions {
-    /**
-     * 当节点的值需要更新时此回调会执行，返回值表示更新前后值是否变化。
-     */
-    update(sub: Node): boolean;
-    /**
-     * 当节点的上游节点的值发生变化后此回调会执行。
-     *
-     * 注意：只有包含 Watching 标记的节点会触发此方法。
-     */
-    notify(node: Node): void;
-    /**
-     * 当节点不再拥有任何下游节点时此回调会执行。
-     */
-    unwatched(node: Node): void;
-}
-export interface ReactiveSystem {
-    /**
-     * 判断连接是否是节点的上游连接。
-     */
-    isDepLinkOfNode(link: Link, node: Node): boolean;
-    /**
-     * 判断连接是否是节点的下游连接。
-     */
-    isSubLinkOfNode(link: Link, node: Node): boolean;
-    /**
-     * 获取两个节点之间的连接。
-     */
-    getLinkOfNodes(dep: Node, sub: Node): Link | undefined;
-    /**
-     * 判断两个节点之间是否存在连接。
-     */
-    isLinked(nodeA: Node, nodeB: Node): boolean;
-    /**
-     * 为两个节点建立连接。
-     */
-    linkNode(dep: Node, sub: Node): void;
-    /**
-     * 为两个节点解除连接。
-     */
-    unlinkNode(nodeA: Node, nodeB: Node): void;
-    /**
-     * 解除连接。
-     */
-    unlink(link: Link): void;
-    /**
-     * 为节点解除所有上游连接。
-     */
-    unlinkAllDepLinksOfNode(node: Node): void;
-    /**
-     * 为节点解除所有下游连接。
-     */
-    unlinkAllSubLinksOfNode(node: Node): void;
-    /**
-     * 获取当前正在进行依赖收集的节点。
-     */
-    getActiveNodeAsSub(): Node | undefined;
-    /**
-     * 设置当前正在进行依赖收集的节点。
-     */
-    setActiveNodeAsSub(nodeAsSub: Node): void;
-    /**
-     * 重置当前正在进行依赖收集的节点。
-     */
-    resetActiveNodeAsSub(): void;
-    /**
-     * 将指定节点作为当前正在进行依赖收集的节点执行指定函数。
-     */
-    withActiveNodeAsSub<T>(nodeAsSub: Node, fn: () => T): T;
-    /**
-     * 开始对节点（作为下游节点）进行依赖收集。
-     */
-    startTracking(node: Node): void;
-    /**
-     * 结束对节点（作为下游节点）进行依赖收集。
-     */
-    endTracking(node: Node): void;
-    /**
-     * 对节点（作为下游节点）进行依赖收集。
-     */
-    withTracking<T>(node: Node, fn: () => T): T;
-    /**
-     * 为两个节点建立连接（依赖收集优化版）。
-     */
-    linkNodeOptimizedForTracking(dep: Node, sub: Node): void;
-    /**
-     * 将节点作为当前正在进行依赖收集的节点的上游节点。
-     */
-    track(node: Node): void;
-    /**
-     * 当节点的值发生变化后，调用此方法更新直接下游节点的标记。
-     */
-    shallowPropagate(node: Node): void;
-    /**
-     * 当节点的值发生变化后，调用此方法更新所有下游节点的标记。
-     */
-    deeeeepPropagate(node: Node): void;
-    /**
-     * 解决节点的 Pending 标记。
-     */
-    resolvePending(node: Node): void;
-}
-export declare const createReactiveSystem: (options: CreateReactiveSystemOptions) => ReactiveSystem;
-//# sourceMappingURL=reactive-system.d.ts.map

package/dist/signal/signal-core/reactive-system.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reactive-system.d.ts","sourceRoot":"","sources":["../../../src/signal/signal-core/reactive-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAE/B;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AACD;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,GAAG,EAAE,IAAI,CAAC;IACV;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAE/B;;OAEG;IACH,GAAG,EAAE,IAAI,CAAC;IACV;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC7B;AACD,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IACjD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IACjD;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACrC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1C;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAG1C;;OAEG;IACH,kBAAkB,IAAI,IAAI,GAAG,SAAS,CAAC;IACvC;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1C;;OAEG;IACH,oBAAoB,IAAI,IAAI,CAAC;IAC7B;;OAEG;IACH,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACxD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C;;OAEG;IACH,4BAA4B,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACzD;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IACnC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAClC;AACD,eAAO,MAAM,oBAAoB,0DA0ehC,CAAA"}

package/dist/signal/signal-operators/index.d.ts

@@ -1,4 +0,0 @@
-import type { Signal } from "#Source/index.ts";
-export declare const withHistory: <T>(orginal: Signal<T>) => Signal<T[]>;
-export declare const zip: <T, U>(signal1: Signal<T>, signal2: Signal<U>) => Signal<[T, U]>;
-//# sourceMappingURL=index.d.ts.map

package/dist/signal/signal-operators/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/signal/signal-operators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C,eAAO,MAAM,WAAW,GAAI,CAAC,oCAO5B,CAAA;AAED,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,2DAMvB,CAAA"}

package/src/signal/index.ts

@@ -1,2 +0,0 @@
-export * from "./signal-core/index.ts"
-export * from "./signal-operators/index.ts"

package/src/signal/signal-core/README.md

@@ -1,4 +0,0 @@
-# Signals
-
-- https://github.com/stackblitz/alien-signals
-- https://github.com/johnsoncodehk/alien-signals-starter

package/src/signal/signal-core/primitive.ts

@@ -1,275 +0,0 @@
-import type { Flags } from "./flags.ts"
-import { createReactiveSystem } from "./reactive-system.ts"
-import { flags } from "./flags.ts"
-import type { Link, Node } from "./reactive-system.ts"
-
-const VOID = Symbol("void") as unknown;
-
-const queue: Effect[] = [];
-const flush = (): void => {
-  while (queue.length !== 0) {
-    queue.shift()!.run();
-  }
-}
-
-let batchDepth = 0;
-export const startBatch = (): void => {
-  batchDepth = batchDepth + 1;
-}
-export const endBatch = (): void => {
-  batchDepth = batchDepth - 1;
-  if (batchDepth === 0) {
-    flush();
-  }
-}
-
-const reactiveSystem = createReactiveSystem({
-  update(node: Signal | Computed) {
-    return node.update();
-  },
-  notify(node: Effect) {
-    const nodes = []
-    let currentNode: Effect | undefined = node
-    while (currentNode !== undefined) {
-      if (currentNode.flags.hasWatching() === false) {
-        break
-      }
-      node.notify();
-      nodes.push(currentNode);
-      const nextNode: Node | undefined = currentNode?.headSubLink?.sub
-      currentNode = nextNode instanceof Effect ? nextNode : undefined
-    }
-    queue.push(...nodes.toReversed());
-  },
-  unwatched(node: Signal | Computed | Effect) {
-    return node.stop();
-  }
-});
-const {
-  unlinkAllDepLinksOfNode,
-
-  withTracking,
-  track,
-
-  shallowPropagate,
-  deeeeepPropagate,
-  resolvePending,
-} = reactiveSystem
-
-/**
- * Signal 的值只有在被获取的时候才会更新。
- */
-export class Signal<T = unknown> implements Node {
-  headSubLink: Link | undefined;
-  tailSubLink: Link | undefined;
-  flags: Flags;
-
-  value: T;
-  pendingValue: T;
-
-  constructor(value: T) {
-    this.headSubLink = undefined;
-    this.tailSubLink = undefined;
-    this.flags = flags().setMutable();
-
-    this.pendingValue = value;
-    this.value = value;
-  }
-
-  get(): T {
-    let valueChanged = false
-
-    // 如果包含 Dirty 标记，则进行更新
-    const shouldUpdate = this.flags.hasDirty();
-    if (shouldUpdate === true) {
-      valueChanged = this.update()
-    }
-
-    // 如果值发生变化，则更新直接下游节点的标记
-    if (valueChanged === true) {
-      shallowPropagate(this);
-    }
-
-    // 自动进行依赖收集
-    track(this);
-
-    return this.value;
-  }
-
-  set(value: T): void {
-    // 将新值暂存起来，等用到的时候再执行更新
-    this.pendingValue = value;
-    // 为当前节点添加 Dirty 标记
-    this.flags.setDirty();
-
-    // 更新所有下游节点的标记
-    deeeeepPropagate(this);
-
-    // 执行更新队列
-    if (batchDepth === 0) {
-      flush();
-    }
-  }
-
-  /**
-   * 返回值表示更新前后值是否变化。
-   */
-  update(): boolean {
-    this.flags.unsetDirty();
-
-    const oldValue = this.value;
-    const newValue = this.pendingValue;
-    this.value = newValue;
-
-    return oldValue !== newValue;
-  }
-
-  stop(): void {
-    // do nothing
-  }
-}
-
-/**
- * Computed 的值只有在被获取的时候才会更新。
- * Computed 的值只有在上游节点的值发生变化时才会更新。
- * Computed 的下游节点全部解除连接时会自动与所有上游节点解除连接，并回到初始状态。
- */
-export class Computed<T = unknown> implements Node {
-  headDepLink: Link | undefined;
-  tailDepLink: Link | undefined;
-  headSubLink: Link | undefined;
-  tailSubLink: Link | undefined;
-  flags: Flags;
-
-  value: T;
-  getValue: () => T;
-
-  constructor(getValue: () => T) {
-    this.headDepLink = undefined;
-    this.tailDepLink = undefined;
-    this.headSubLink = undefined;
-    this.tailSubLink = undefined;
-    // 值在创建时尚未计算，因此初始时添加 Dirty 标记
-    this.flags = flags().setMutable().setDirty();
-
-    // undefined 可能是使用者期待的合法值，因此这里使用 VOID 占位
-    // oxlint-disable-next-line no-unsafe-type-assertion
-    this.value = VOID as T;
-    this.getValue = getValue;
-  }
-
-  get(): T {
-    let valueChanged = false;
-
-    // 如果包含 Pending 标记，则进行解决
-    const shouldResolve = this.flags.hasPending();
-    if (shouldResolve === true) {
-      resolvePending(this);
-    }
-
-    // 如果包含 Dirty 标记，则进行更新
-    const shouldUpdate = this.flags.hasDirty();
-    if (shouldUpdate === true) {
-      valueChanged = this.update()
-    }
-
-    // 如果值变化，则通知下游（仅通知直接下游）
-    if (valueChanged === true) {
-      shallowPropagate(this);
-    }
-
-    // 自动进行依赖收集
-    track(this);
-
-    return this.value;
-  }
-
-  /**
-   * 返回值表示更新前后值是否变化。
-   */
-  update(): boolean {
-    const result = withTracking(this, () => {
-      const oldValue = this.value;
-      const newValue = this.getValue();
-      this.value = newValue;
-      return oldValue !== newValue;
-    })
-    return result;
-  }
-
-  stop(): void {
-    unlinkAllDepLinksOfNode(this);
-    this.flags = flags().setMutable().setDirty();
-  }
-}
-
-/**
- * Effect 会在创建时立即执行一次传入的函数。
- * Effect 会在每次上游节点的值发生变化时重新执行传入的函数。
- * Effect 在任意时刻最多只能一个待运行。
- * Effect 可以与 Effect 建立连接。
- * 作为上游节点的 Effect 在没有下游节点时会自动与所有上游节点解除连接，并将标记清空。
- */
-export class Effect implements Node {
-  headDepLink: Link | undefined;
-  tailDepLink: Link | undefined;
-  headSubLink: Link | undefined;
-  tailSubLink: Link | undefined;
-  flags: Flags;
-
-  fn: () => void;
-
-  constructor(fn: () => void) {
-    this.headDepLink = undefined;
-    this.tailDepLink = undefined;
-    this.headSubLink = undefined;
-    this.tailSubLink = undefined;
-    // 在创建完成后即进入观察状态，因此初始时添加 Watching 标记
-    this.flags = flags().setWatching();
-
-    this.fn = fn;
-    this.internalRun();
-  }
-
-  notify(): void {
-    this.flags.unsetWatching();
-  }
-
-  run(): void {
-    this.flags.setWatching();
-
-    // 如果包含 Pending 标记，则进行解决
-    const shouldResolve = this.flags.hasPending();
-    if (shouldResolve === true) {
-      resolvePending(this);
-    }
-
-    // 如果包含 Dirty 标记，则进行更新
-    const shouldRun = this.flags.hasDirty();
-    if (shouldRun === true) {
-      this.internalRun();
-    }
-  }
-
-  private internalRun(): void {
-    track(this);
-    withTracking(this, () => {
-      return this.fn();
-    })
-  }
-
-  stop(): void {
-    unlinkAllDepLinksOfNode(this);
-    this.flags.clear();
-  }
-}
-
-export const signal = <T>(initialValue: T): Signal<T> => {
-  return new Signal(initialValue);
-}
-export const computed = <T>(getter: () => T): Computed<T> => {
-  return new Computed<T>(getter);
-}
-export const effect = (fn: () => void): Effect => {
-  return new Effect(fn);
-}

package/src/signal/signal-operators/index.ts

@@ -1,19 +0,0 @@
-import type { Signal } from "#Source/index.ts"
-import { effect, signal } from "#Source/index.ts"
-
-export const withHistory = <T>(orginal: Signal<T>): Signal<T[]> => {
-  const history: T[] = []
-  effect(() => {
-    history.push(orginal.get())
-  })
-  const result = signal<T[]>(history)
-  return result
-}
-
-export const zip = <T, U>(signal1: Signal<T>, signal2: Signal<U>): Signal<[T, U]> => {
-  const result = signal<[T, U]>([signal1.get(), signal2.get()])
-  effect(() => {
-    result.set([signal1.get(), signal2.get()])
-  })
-  return result
-}

package/tests/unit/signal/effect.spec.ts

@@ -1,108 +0,0 @@
-import { expect, test } from 'vitest';
-import { computed, effect, endBatch, signal, startBatch } from '#Source/index.ts';
-
-test('should clear subscriptions when untracked by all subscribers', () => {
-  /**
-   *   a
-   *   |
-   *   b
-   *   |
-   *   e
-   */
-  let bRunTimes = 0;
-  const a = signal(1);
-  const b = computed(() => {
-    bRunTimes = bRunTimes + 1;
-    return a.get() * 2;
-  });
-  const e = effect(() => {
-    b.get();
-  });
-
-  expect(bRunTimes).toBe(1);
-  a.set(2);
-  expect(bRunTimes).toBe(2);
-  e.stop();
-  a.set(3);
-  expect(bRunTimes).toBe(2);
-});
-
-test('should not run untracked inner effect', () => {
-  /**
-   *     a
-   *    / \
-   *   b  e2(inner)
-   *    \ /
-   *     e1(outer)
-   */
-  let countOfInnerEffect = 0;
-  const a = signal(3);
-  const b = computed(() => a.get() > 0);
-  effect(() => {
-    if (b.get() === true) {
-      countOfInnerEffect = countOfInnerEffect + 1;
-      effect(() => {
-        if (a.get() === 0) {
-          throw new Error("bad");
-        }
-      });
-    }
-  });
-
-  a.set(2);
-  a.set(1);
-  a.set(0);
-});
-
-test('should run outer effect first', () => {
-  /**
-   *   a       b
-   *   | \     /
-   *   |   \  /
-   *   |  e2(inner)
-   *   \ /
-   *    e1(outer)
-   */
-  const a = signal(1);
-  const b = signal(1);
-  effect(() => {
-    if (a.get() !== 0) {
-      effect(() => {
-        b.get();
-        if (a.get() === 0) {
-          throw new Error("bad");
-        }
-      });
-    }
-  });
-
-  startBatch();
-  b.set(0);
-  a.set(0);
-  endBatch();
-});
-
-test('should not trigger inner effect when resolve maybe dirty', () => {
-  /**
-   *    a
-   *    |
-   *    b
-   *   e2(inner)
-   *    |
-   *   e1(outer)
-   */
-  const a = signal(0);
-  const b = computed(() => a.get() % 2);
-  let innerTriggerTimes = 0;
-  effect(() => {
-    effect(() => {
-      b.get();
-      innerTriggerTimes = innerTriggerTimes + 1;
-      if (innerTriggerTimes >= 2) {
-        throw new Error("bad");
-      }
-    });
-  });
-
-  a.set(2);
-});