tcdona_unilib 1.0.11 → 1.0.14

package/.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "singleQuote": true,
+  "tabWidth": 2,
+  "semi": false,
+  "arrowParens": "always"
+}

package/animejs.ts

@@ -1 +1,13 @@
-export { animate, createTimeline, createTimer, createScope, createSpring, createDraggable, stagger, eases, utils, svg, engine } from 'animejs';
+export {
+  animate,
+  createTimeline,
+  createTimer,
+  createScope,
+  createSpring,
+  createDraggable,
+  stagger,
+  eases,
+  utils,
+  svg,
+  engine,
+} from 'animejs'

package/ast-grep.ts

@@ -0,0 +1,42 @@
+// -----Type Only Export!-----//
+export type {
+  FileOption,
+  FindConfig,
+  NapiConfig,
+  DynamicLangRegistrations,
+  Edit,
+  Pos,
+  Range,
+  Rule,
+  Lang,
+  SgNode,
+} from '@ast-grep/napi'
+
+// -----Runtime Value Export!-----//
+// 导入所有需要的模块
+import {
+  findInFiles,
+  kind,
+  parse,
+  parseAsync,
+  parseFiles,
+  pattern,
+  registerDynamicLanguage,
+  Lang,
+  SgNode,
+  SgRoot,
+} from '@ast-grep/napi'
+
+// 导出为对象，避免命名冲突
+export const astgrep = {
+  findInFiles,
+  kind,
+  parse,
+  parseAsync,
+  parseFiles,
+  pattern,
+  registerDynamicLanguage,
+  Lang,
+  SgNode,
+  SgRoot,
+}

package/big.ts

@@ -1,2 +1,2 @@
-export { default as Big } from 'big.js';
-export type { Big as BigType, BigSource } from 'big.js';
+export { default as Big } from 'big.js'
+export type { Big as BigType, BigSource } from 'big.js'

package/clipboardy.ts

@@ -1 +1 @@
-export { default as clipboard } from 'clipboardy';
+export { default as clipboard } from 'clipboardy'

package/dayjs.ts

@@ -1,2 +1,2 @@
-export { default as dayjs } from 'dayjs';
-export type { Dayjs, ConfigType, OptionType } from 'dayjs';
+export { default as dayjs } from 'dayjs'
+export type { Dayjs, ConfigType, OptionType } from 'dayjs'

package/dotenvx.ts

@@ -1,4 +1,17 @@
-export { config, parse, set, get, ls, genexample } from "@dotenvx/dotenvx"
+// 导入所有需要的模块
+import { config, parse, set, get, ls, genexample } from '@dotenvx/dotenvx'
+
+// 导出为对象，避免命名冲突
+export const dotenvx = {
+  config,
+  parse,
+  set,
+  get,
+  ls,
+  genexample,
+}
+
+// 导出类型
 export type {
   DotenvConfigOptions,
   DotenvConfigOutput,
@@ -10,4 +23,4 @@ export type {
   SetOutput,
   GetOptions,
   GenExampleOutput,
-} from "@dotenvx/dotenvx"
+} from '@dotenvx/dotenvx'

package/eff/aff.ts

@@ -0,0 +1,161 @@
+import { Result } from 'neverthrow'
+import { err, ok, ResultAsync } from 'neverthrow'
+import {
+  Actrl,
+  ABORT_REASON,
+  shortId,
+  type AffFn,
+  type NonEmptyArray,
+  type ExtractOk,
+  type ExtractErr,
+} from './aff.util'
+
+export class Aff {
+  /**
+   * 创建子任务（继承父 signal，支持取消传播）
+   */
+  static make<T, E>(
+    actrlSpanId: string,
+    executor: AffFn<T, E>,
+    parentActrl: Actrl,
+  ): ResultAsync<T, E> {
+    const actrl = new Actrl(actrlSpanId)
+    const unlink = parentActrl.link(actrl)
+
+    const executorResult = executor(actrl)
+    // 统一处理 PromiseLike 和 ResultAsync，转换为 Promise<Result<T, E>>
+    // ResultAsync 实现了 PromiseLike，Promise.resolve 可以处理它
+    const promise: Promise<Result<T, E>> = Promise.resolve(
+      executorResult as PromiseLike<Result<T, E>>,
+    )
+      .catch((e) => err(e as E))
+      .then((result) => {
+        actrl.resultStatus = result.isOk() ? 'ok' : 'err'
+        unlink()
+        actrl.cancel(ABORT_REASON.COMPLETED)
+        return result
+      })
+
+    return new ResultAsync(promise)
+  }
+
+  /**
+   * 创建根级任务（无父 signal）
+   */
+  static root<T, E>(executor: AffFn<T, E>): ResultAsync<T, E> {
+    return Aff.make('root', executor, new Actrl('$', true))
+  }
+
+  static all<T extends NonEmptyArray<AffFn<unknown, unknown>>>(
+    executors: T,
+    parentActrl: Actrl,
+  ): ResultAsync<
+    { -readonly [P in keyof T]: ExtractOk<T[P]> },
+    ExtractErr<T[number]>
+  > {
+    const actrl = new Actrl('all#' + shortId())
+    const unlink = parentActrl.link(actrl)
+
+    // Result -> Promise 语义转换：err 变成 reject，这样 Promise.all 遇到 err 会立即返回
+    const toPromise = (ra: ResultAsync<unknown, unknown>) =>
+      ra.then((r) => (r.isOk() ? r.value : Promise.reject(r.error)))
+
+    const promise = Promise.all(
+      executors.map((fn, i) => toPromise(Aff.make(`all-${i}`, fn, actrl))),
+    )
+      .then((values) => {
+        unlink()
+        actrl.cancel(ABORT_REASON.COMPLETED)
+        return ok(values) as Result<
+          { -readonly [P in keyof T]: ExtractOk<T[P]> },
+          ExtractErr<T[number]>
+        >
+      })
+      .catch((e) => {
+        unlink()
+        actrl.cancel(ABORT_REASON.SETTLED)
+        return err(e) as Result<
+          { -readonly [P in keyof T]: ExtractOk<T[P]> },
+          ExtractErr<T[number]>
+        >
+      })
+
+    return new ResultAsync(promise)
+  }
+
+  static any<T extends NonEmptyArray<AffFn<unknown, unknown>>>(
+    executors: T,
+    parentActrl: Actrl,
+  ): ResultAsync<ExtractOk<T[number]>, ExtractErr<T[number]>[]> {
+    const actrl = new Actrl('any#' + shortId())
+    const unlink = parentActrl.link(actrl)
+
+    // Result -> Promise 语义转换
+    const toPromise = (ra: ResultAsync<unknown, unknown>) =>
+      ra.then((r) => (r.isOk() ? r.value : Promise.reject(r.error)))
+
+    const promise = Promise.any(
+      executors.map((fn, i) => toPromise(Aff.make(`any-${i}`, fn, actrl))),
+    )
+      .then((value) => {
+        unlink()
+        actrl.cancel(ABORT_REASON.SETTLED)
+        return ok(value) as Result<
+          ExtractOk<T[number]>,
+          ExtractErr<T[number]>[]
+        >
+      })
+      .catch((e: AggregateError) => {
+        unlink()
+        actrl.cancel(ABORT_REASON.COMPLETED)
+        return err(e.errors) as Result<
+          ExtractOk<T[number]>,
+          ExtractErr<T[number]>[]
+        >
+      })
+
+    return new ResultAsync(promise)
+  }
+
+  static race<T extends NonEmptyArray<AffFn<unknown, unknown>>>(
+    executors: T,
+    parentActrl: Actrl,
+  ): ResultAsync<ExtractOk<T[number]>, ExtractErr<T[number]>> {
+    const actrl = new Actrl('race#' + shortId())
+    const unlink = parentActrl.link(actrl)
+
+    const promise = Promise.race(
+      executors.map((fn, i) => Aff.make(`race-${i}`, fn, actrl)),
+    ).then((firstResult) => {
+      unlink()
+      actrl.cancel(ABORT_REASON.SETTLED)
+      return firstResult as Result<ExtractOk<T[number]>, ExtractErr<T[number]>>
+    })
+
+    return new ResultAsync(promise)
+  }
+
+  static allSettled<T extends NonEmptyArray<AffFn<unknown, unknown>>>(
+    executors: T,
+    parentActrl: Actrl,
+  ): ResultAsync<
+    { -readonly [P in keyof T]: Result<ExtractOk<T[P]>, ExtractErr<T[P]>> },
+    never
+  > {
+    const actrl = new Actrl('settled#' + shortId())
+    const unlink = parentActrl.link(actrl)
+
+    const promise = Promise.all(
+      executors.map((fn, i) => Aff.make(`allSettled-${i}`, fn, actrl)),
+    ).then((results) => {
+      unlink()
+      actrl.cancel(ABORT_REASON.COMPLETED)
+      return ok(results) as Result<
+        { -readonly [P in keyof T]: Result<ExtractOk<T[P]>, ExtractErr<T[P]>> },
+        never
+      >
+    })
+
+    return new ResultAsync(promise)
+  }
+}

package/eff/aff.util.ts

@@ -0,0 +1,218 @@
+import { Result } from 'neverthrow'
+import { err, ok, ResultAsync } from 'neverthrow'
+import { tcNanoid } from '../staticMeta/string.nanoid'
+
+export type ActrlSpan = {
+  id: string
+  parent: string
+  status: 'init'
+  startTime: number
+  duration: number
+}
+
+export class Actrl {
+  readonly ac: AbortController
+  public traceid: string = ''
+  public span: ActrlSpan = {
+    id: '',
+    parent: '',
+    status: 'init',
+    startTime: 0,
+    duration: 0,
+  }
+  private isRoot = false
+  public depth = 0 // 基于父子关系的真实深度
+  public resultStatus: 'ok' | 'err' | null = null // 任务返回状态
+  public logs: string[] = [] // 日志数组，用于收集日志信息
+  private rootLogs: string[] | null = null // 指向根 Actrl 的 logs，用于统一收集所有日志
+
+  constructor(spanid: string, isRoot = false) {
+    this.ac = new AbortController()
+    this.span.id = spanid
+    this.isRoot = isRoot
+    this.depth = isRoot ? 0 : 0
+    if (isRoot) {
+      this.rootLogs = this.logs // 根 Actrl 的 rootLogs 指向自己的 logs
+    }
+  }
+
+  get aborted() {
+    return this.ac.signal.aborted
+  }
+  get reason(): unknown {
+    return this.ac.signal.reason
+  }
+
+  cancel(reason?: unknown) {
+    this.ac.abort(reason)
+  }
+  link(childActrl: Actrl) {
+    // 让子 Actrl 共享根 Actrl 的 logs
+    childActrl.rootLogs = this.rootLogs || this.logs
+    // 获取目标日志数组（根 Actrl 的 logs）
+    const getTargetLogs = () => this.rootLogs || this.logs
+
+    if (this.isRoot) {
+      this.traceid = tcNanoid()
+      childActrl.traceid = this.traceid
+      childActrl.depth = 1
+
+      const indent = formatIndent(childActrl.depth)
+      const displayId = childActrl.span.id
+      getTargetLogs().push(formatLogStart(indent, displayId))
+
+      if (this.ac.signal.aborted) {
+        childActrl.cancel(this.ac.signal.reason)
+        getTargetLogs().push(
+          formatLogCancel(indent, childActrl.span.id, 'parent aborted'),
+        )
+        return noop
+      }
+      const handler = () => {
+        childActrl.cancel(this.ac.signal.reason)
+        // 记录取消日志（当父任务因为 SETTLED 被取消时）
+        if (this.ac.signal.reason === ABORT_REASON.SETTLED) {
+          getTargetLogs().push(formatLogCancel(indent, childActrl.span.id))
+        }
+      }
+      this.ac.signal.addEventListener('abort', handler, { once: true })
+      return () => {
+        // 判断是否被外部取消（reason 是 'settled' 表示被其他任务抢先完成）
+        const isCancelled =
+          childActrl.aborted && childActrl.reason === ABORT_REASON.SETTLED
+        let status = ''
+        if (isCancelled) {
+          status = ' [cancelled]'
+        } else if (childActrl.resultStatus) {
+          status = ' [' + childActrl.resultStatus + ']'
+        }
+        getTargetLogs().push(formatLogEnd(indent, childActrl.span.id, status))
+        this.ac.signal.removeEventListener('abort', handler)
+      }
+    }
+    childActrl.traceid = this.traceid
+    childActrl.span.parent = this.span.id
+    childActrl.depth = this.depth + 1
+
+    const indent = formatIndent(childActrl.depth)
+    const displayId = formatDisplayId(this.span.id, childActrl.span.id)
+    childActrl.span.id = displayId
+    getTargetLogs().push(formatLogStart(indent, displayId))
+
+    if (this.ac.signal.aborted) {
+      childActrl.cancel(this.ac.signal.reason)
+      getTargetLogs().push(
+        formatLogCancel(indent, childActrl.span.id, 'parent aborted'),
+      )
+      return noop
+    }
+    const handler = () => {
+      childActrl.cancel(this.ac.signal.reason)
+      // 记录取消日志（当父任务因为 SETTLED 被取消时）
+      if (this.ac.signal.reason === ABORT_REASON.SETTLED) {
+        getTargetLogs().push(formatLogCancel(indent, childActrl.span.id))
+      }
+    }
+    this.ac.signal.addEventListener('abort', handler, { once: true })
+    return () => {
+      // 判断是否被外部取消（reason 是 'settled' 表示被其他任务抢先完成）
+      const isCancelled =
+        childActrl.aborted && childActrl.reason === ABORT_REASON.SETTLED
+      let status = ''
+      if (isCancelled) {
+        status = ' [cancelled]'
+      } else if (childActrl.resultStatus) {
+        status = ' [' + childActrl.resultStatus + ']'
+      }
+      getTargetLogs().push(formatLogEnd(indent, childActrl.span.id, status))
+      this.ac.signal.removeEventListener('abort', handler)
+    }
+  }
+  on(
+    type: string,
+    listener: EventListenerOrEventListenerObject,
+    options?: boolean | AddEventListenerOptions,
+  ) {
+    this.ac.signal.addEventListener(type, listener, options)
+  }
+  off(
+    type: string,
+    listener: EventListenerOrEventListenerObject,
+    options?: boolean | EventListenerOptions,
+  ) {
+    this.ac.signal.removeEventListener(type, listener, options)
+  }
+}
+
+export type AffFn<T, E> = (
+  actrl: Actrl,
+) => PromiseLike<Result<T, E>> | ResultAsync<T, E>
+export type NonEmptyArray<T> = readonly [T, ...T[]]
+export type ExtractOk<T> = T extends AffFn<infer U, unknown> ? U : never
+export type ExtractErr<T> = T extends AffFn<unknown, infer E> ? E : never
+
+export const ABORT_REASON = { SETTLED: 'settled', COMPLETED: 'completed' } as const
+export const noop = () => {}
+
+// ============================================================
+// 日志格式化函数
+// ============================================================
+
+/**
+ * 生成缩进字符串
+ */
+export const formatIndent = (depth: number): string => {
+  return '  '.repeat(depth)
+}
+
+/**
+ * 格式化显示 ID（取父级最后一段 + 当前 id）
+ */
+export const formatDisplayId = (parentId: string, childId: string): string => {
+  const parentShort = parentId.split('/').pop() || parentId
+  return parentShort + '/' + childId
+}
+
+/**
+ * 格式化开始日志
+ */
+export const formatLogStart = (indent: string, id: string): string => {
+  return indent + '→ ' + id
+}
+
+/**
+ * 格式化结束日志
+ */
+export const formatLogEnd = (indent: string, id: string, status?: string): string => {
+  return indent + '← ' + id + (status || '')
+}
+
+/**
+ * 格式化取消日志
+ */
+export const formatLogCancel = (
+  indent: string,
+  id: string,
+  reason?: string,
+): string => {
+  if (reason === 'parent aborted') {
+    return indent + '✗ ' + id + ' [cancelled: parent aborted]'
+  }
+  return indent + '✗ ' + id + ' [cancelled]'
+}
+
+/**
+ * 打印日志
+ */
+export const printLogs = (logs: string[], title?: string): void => {
+  if (logs.length > 0) {
+    if (title) {
+      console.log(`=== ${title} ===`)
+    }
+    console.log(logs.join('\n'))
+  }
+}
+
+// 简短 id 生成器
+let _idCounter = 0
+export const shortId = () => (++_idCounter).toString(36)

package/eff/eff.delay.ts

@@ -0,0 +1,21 @@
+import { ok } from 'neverthrow'
+import { Eff } from './eff'
+
+/**
+ * 异步延迟函数：返回延迟是否完成（true）或被取消（false）
+ */
+export const delayEff = (time: number, parentSignal: AbortSignal) => {
+  return Eff.create<boolean, never>(({ signal }) => {
+    return new Promise((resolve) => {
+      const timer = setTimeout(() => resolve(ok(true)), time)
+      signal.addEventListener(
+        'abort',
+        () => {
+          clearTimeout(timer)
+          resolve(ok(false))
+        },
+        { once: true },
+      )
+    })
+  }, parentSignal)
+}