tcdona_unilib 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# tclib - 统一依赖聚合层
+
+一个统一的依赖管理库，支持通过子路径导入，保持 tree-shaking 能力。
+
+## 特性
+
+- ✅ ESM 模块（`type: module`）
+- ✅ 子路径导入支持（如 `import from 'tclib/zod'`）
+- ✅ Tree-shaking 优化
+- ✅ 完整的类型支持
+- ✅ 统一的版本管理
+
+## 安装
+
+```bash
+npm install tclib
+# or
+yarn add tclib
+# or
+pnpm add tclib
+```
+
+## 使用
+
+### 子路径导入
+
+```typescript
+// 导入单个库
+import { z } from "tclib/zod"
+import { nanoid } from "tclib/nanoid"
+import dayjs from "tclib/dayjs"
+import { defineConfig } from "tclib/vite"
+
+// 导入所有库
+import * as tclib from "tclib"
+```
+
+## 支持的库
+
+| 库名         | 导入方式           | 用途             |
+| ------------ | ------------------ | ---------------- |
+| neverthrow   | `tclib/neverthrow` | 错误处理         |
+| zod          | `tclib/zod`        | 数据验证         |
+| zx           | `tclib/zx`         | Shell 脚本       |
+| dayjs        | `tclib/dayjs`      | 日期时间         |
+| big.js       | `tclib/big.js`     | 精确算术         |
+| nanoid       | `tclib/nanoid`     | ID 生成          |
+| nanostores   | `tclib/nanostores` | 状态管理         |
+| effort       | `tclib/effort`     | 效率工具         |
+| animejs      | `tclib/animejs`    | 动画库           |
+| clipboardy   | `tclib/clipboardy` | 剪贴板           |
+| marked       | `tclib/marked`     | Markdown 解析    |
+| pathe        | `tclib/pathe`      | 路径处理         |
+| prettier     | `tclib/prettier`   | 代码格式化       |
+| turndown     | `tclib/turndown`   | HTML 转 Markdown |
+| effector     | `tclib/effector`   | 事件管理         |
+| comctx       | `tclib/comctx`     | 上下文管理       |
+| es-toolkit   | `tclib/estk`       | ES 工具集        |
+| magic-regexp | `tclib/magicreg`   | 正则表达式       |
+| exome        | `tclib/exome`      | 状态管理         |
+| vue          | `tclib/vue`        | Vue 框架         |
+| vite         | `tclib/vite`       | 构建工具         |
+
+## 项目结构
+
+```
+tclib/
+├── package.json          # 统一依赖声明
+├── tsconfig.json         # TypeScript 配置
+├── index.ts              # 全量导出入口
+├── neverthrow.ts         # 子路径模块
+├── zod.ts
+├── ... (其他 20 个库)
+└── README.md
+```
+
+## 配置原理
+
+- **exports 字段**: 定义子路径映射关系，支持 `tclib/zod` 导入方式
+- **type: module**: 启用 ESM 模块系统
+- **Tree-shaking**: 每个模块仅做简单转发，构建工具可自动优化
+
+## 添加新库
+
+要添加新库，只需：
+
+1. 在 `package.json` 的 `dependencies` 中添加库及版本
+2. 在 `exports` 中添加路径映射
+3. 创建对应的 `*.ts` 转发文件：
+   ```typescript
+   export * from "your-library"
+   ```
+4. 在 `index.ts` 中添加导出行
+
+## 版本管理
+
+所有依赖版本统一在 `package.json` 中管理，确保项目内一致性。

package/animejs.ts

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

package/big.ts

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

package/clipboardy.ts

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

package/comctx.ts

@@ -0,0 +1,2 @@
+export { defineProxy, checkMessage, MESSAGE_TYPE, MESSAGE_SENDER } from 'comctx';
+export type { Adapter, Context, Message, MessageMeta, MessageType, MessageSender, OffMessage, OnMessage, Options, SendMessage } from 'comctx';

package/dayjs.ts

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

package/effector.ts

@@ -0,0 +1,2 @@
+export { createEvent, createStore, createEffect, createDomain, sample, combine, attach, merge, split, forward, guard, restore, scopeBind, allSettled, fork, serialize, hydrate, clearNode, withRegion, launch, is } from 'effector';
+export type { Event, Store, Effect, Domain, Scope, Unit, EventCallable, StoreWritable } from 'effector';

package/es-toolkit.ts

@@ -0,0 +1,112 @@
+export {
+  chunk,
+  compact,
+  countBy,
+  difference,
+  differenceBy,
+  differenceWith,
+  drop,
+  dropRight,
+  dropRightWhile,
+  dropWhile,
+  fill,
+  flatten,
+  flattenDeep,
+  groupBy,
+  head,
+  initial,
+  intersection,
+  intersectionBy,
+  intersectionWith,
+  isSubset,
+  keyBy,
+  last,
+  maxBy,
+  minBy,
+  orderBy,
+  partition,
+  pullAt,
+  sample,
+  sampleSize,
+  shuffle,
+  sortBy,
+  tail,
+  take,
+  takeRight,
+  takeRightWhile,
+  takeWhile,
+  union,
+  unionBy,
+  unionWith,
+  uniq,
+  uniqBy,
+  uniqWith,
+  unzip,
+  unzipWith,
+  without,
+  xor,
+  xorBy,
+  xorWith,
+  zip,
+  zipObject,
+  zipWith,
+
+  debounce,
+  throttle,
+  once,
+  noop,
+  identity,
+  range,
+
+  clone,
+  cloneDeep,
+  isEqual,
+  isPlainObject,
+  merge,
+  omit,
+  omitBy,
+  pick,
+  pickBy,
+  invert,
+  mapKeys,
+  mapValues,
+
+  camelCase,
+  capitalize,
+  kebabCase,
+  lowerCase,
+  lowerFirst,
+  snakeCase,
+  startCase,
+  upperCase,
+  upperFirst,
+  trim,
+  trimEnd,
+  trimStart,
+  pad,
+
+  mean,
+  meanBy,
+  sum,
+  sumBy,
+  round,
+  clamp,
+  random,
+  randomInt,
+
+  delay,
+  timeout,
+  retry,
+
+  isNil,
+  isNull,
+  isUndefined,
+  isString,
+  isBoolean,
+  isFunction,
+  isDate,
+  isRegExp,
+  isSymbol,
+  isLength,
+  isTypedArray,
+} from 'es-toolkit';

package/exome.ts

@@ -0,0 +1,2 @@
+export { Exome, addMiddleware, getExomeId, onAction, subscribe, update, runMiddleware } from 'exome';
+export type { Middleware } from 'exome';

package/magic-regexp.ts

@@ -0,0 +1,2 @@
+export { createRegExp, exactly, oneOrMore, anyOf, char, charIn, charNotIn, word, wordChar, wordBoundary, digit, whitespace, letter, tab, linefeed, carriageReturn, not, maybe, global, multiline, caseInsensitive, sticky, unicode, dotAll, withIndices } from 'magic-regexp';
+export type { Input, MagicRegExp } from 'magic-regexp';

package/marked.ts

@@ -0,0 +1,2 @@
+export { marked, Marked, Lexer, Parser, Tokenizer, Renderer, TextRenderer, Hooks, getDefaults, setOptions, use, parse, parseInline, lexer, parser, walkTokens } from 'marked';
+export type { Token, Tokens, TokensList, MarkedExtension, MarkedOptions, RendererObject, TokenizerObject } from 'marked';

package/nanoid.ts

@@ -0,0 +1 @@
+export { nanoid, customAlphabet, customRandom, urlAlphabet, random } from 'nanoid';

package/nanostores.ts

@@ -0,0 +1,2 @@
+export { atom, map, deepMap, computed, onMount, onSet, onNotify, onStart, onStop, listenKeys, keepMount, task, startTask, allTasks, cleanTasks, batched, STORE_UNMOUNT_DELAY } from 'nanostores';
+export type { Atom, MapStore, DeepMapStore, ReadableAtom, WritableAtom, PreinitializedWritableAtom, MapStoreKeys, AnyStore, Store, StoreValue } from 'nanostores';

package/neverthrow.ts

@@ -0,0 +1,15 @@
+export {
+  ok,
+  err,
+  Ok,
+  Err,
+  Result,
+  ResultAsync,
+  okAsync,
+  errAsync,
+  fromPromise,
+  fromSafePromise,
+  fromThrowable,
+  safeTry,
+} from 'neverthrow';
+export type { Result as ResultType } from 'neverthrow';

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "tcdona_unilib",
+  "version": "1.0.0",
+  "description": "Unified dependency aggregation layer for shared libraries",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    "./neverthrow": "./neverthrow.ts",
+    "./zod": "./zod.ts",
+    "./zx": "./zx.ts",
+    "./dayjs": "./dayjs.ts",
+    "./big.js": "./big.ts",
+    "./nanoid": "./nanoid.ts",
+    "./nanostores": "./nanostores.ts",
+    "./animejs": "./animejs.ts",
+    "./clipboardy": "./clipboardy.ts",
+    "./marked": "./marked.ts",
+    "./pathe": "./pathe.ts",
+    "./prettier": "./prettier.ts",
+    "./turndown": "./turndown.ts",
+    "./effector": "./effector.ts",
+    "./comctx": "./comctx.ts",
+    "./estk": "./es-toolkit.ts",
+    "./magicreg": "./magic-regexp.ts",
+    "./exome": "./exome.ts",
+    "./vue": "./vue.ts",
+    "./vite": "./vite.ts"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^20.10.6"
+  },
+  "dependencies": {
+    "@types/big.js": "^6.2.2",
+    "@types/turndown": "^5.0.6",
+    "animejs": "^4.1.3",
+    "big.js": "^7.0.1",
+    "clipboardy": "^5.0.2",
+    "comctx": "^1.4.3",
+    "dayjs": "^1.11.19",
+    "effector": "^23.4.4",
+    "es-toolkit": "^1.43.0",
+    "exome": "^2.8.0",
+    "magic-regexp": "^0.10.0",
+    "marked": "^17.0.1",
+    "nanoid": "^5.1.6",
+    "nanostores": "^1.1.0",
+    "neverthrow": "^8.2.0",
+    "pathe": "^2.0.3",
+    "prettier": "^3.7.4",
+    "turndown": "^7.2.2",
+    "vite": "^7.3.0",
+    "vue": "^3.5.26",
+    "zod": "^4.2.1",
+    "zx": "^8.8.5"
+  }
+}

package/pathe.ts

@@ -0,0 +1 @@
+export { basename, delimiter, dirname, extname, format, isAbsolute, join, normalize, normalizeString, parse, relative, resolve, sep, toNamespacedPath } from 'pathe';

package/prettier.ts

@@ -0,0 +1,2 @@
+export { format, formatWithCursor, check, resolveConfig, resolveConfigFile, clearConfigCache, getFileInfo, getSupportInfo, doc, version } from 'prettier';
+export type { Options, Plugin, Printer, Parser, SupportLanguage, SupportOption } from 'prettier';

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": false,
+  },
+  "include": [
+    "*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/turndown.ts

@@ -0,0 +1 @@
+export { default as TurndownService } from 'turndown';

package/vite.ts

@@ -0,0 +1,54 @@
+export {
+  defineConfig,
+  loadConfigFromFile,
+  loadEnv,
+  normalizePath,
+  mergeConfig,
+  searchForWorkspaceRoot,
+  send,
+  transformWithEsbuild,
+  resolveConfig,
+  sortUserPlugins,
+  preprocessCSS,
+  createServer,
+  preview,
+  build,
+  buildErrorMessage,
+  createFilter,
+  createLogger,
+  formatPostcssSourceMap,
+  isCSSRequest,
+  parseAst,
+  parseAstAsync,
+} from 'vite';
+
+export type {
+  UserConfig,
+  ConfigEnv,
+  ResolvedConfig,
+  Plugin,
+  PluginOption,
+  HtmlTagDescriptor,
+  IndexHtmlTransform,
+  IndexHtmlTransformContext,
+  IndexHtmlTransformResult,
+  ServerOptions,
+  BuildOptions,
+  PreviewOptions,
+  ResolveOptions,
+  CSSOptions,
+  ESBuildOptions,
+  DepOptimizationOptions,
+  ViteDevServer,
+  PreviewServer,
+  ModuleNode,
+  ModuleGraph,
+  HmrContext,
+  Logger,
+  LogLevel,
+  LogType,
+  Manifest,
+  ManifestChunk,
+  SSROptions,
+  FilterPattern,
+} from 'vite';

package/vue.ts

@@ -0,0 +1,105 @@
+export {
+  createApp,
+  createSSRApp,
+  defineComponent,
+  defineAsyncComponent,
+  defineCustomElement,
+  
+  ref,
+  reactive,
+  readonly,
+  computed,
+  watch,
+  watchEffect,
+  watchPostEffect,
+  watchSyncEffect,
+  
+  shallowRef,
+  shallowReactive,
+  shallowReadonly,
+  triggerRef,
+  toRef,
+  toRefs,
+  toValue,
+  toRaw,
+  markRaw,
+  isRef,
+  isReactive,
+  isReadonly,
+  isProxy,
+  unref,
+  customRef,
+  effectScope,
+  getCurrentScope,
+  onScopeDispose,
+  
+  provide,
+  inject,
+  hasInjectionContext,
+  
+  h,
+  mergeProps,
+  cloneVNode,
+  isVNode,
+  resolveComponent,
+  resolveDirective,
+  withDirectives,
+  withModifiers,
+  
+  onMounted,
+  onUpdated,
+  onUnmounted,
+  onBeforeMount,
+  onBeforeUpdate,
+  onBeforeUnmount,
+  onActivated,
+  onDeactivated,
+  onErrorCaptured,
+  onRenderTracked,
+  onRenderTriggered,
+  onServerPrefetch,
+  
+  nextTick,
+  
+  Transition,
+  TransitionGroup,
+  KeepAlive,
+  Teleport,
+  Suspense,
+  
+  Fragment,
+  Text,
+  Comment,
+  Static,
+  
+  useCssModule,
+  useCssVars,
+  useSlots,
+  useAttrs,
+  useModel,
+  useTemplateRef,
+  useId,
+  
+  version,
+} from 'vue';
+
+export type {
+  App,
+  Component,
+  ComponentPublicInstance,
+  ComputedRef,
+  DefineComponent,
+  Directive,
+  InjectionKey,
+  Plugin,
+  PropType,
+  Ref,
+  SetupContext,
+  ShallowRef,
+  Slots,
+  VNode,
+  WatchCallback,
+  WatchOptions,
+  WatchSource,
+  WritableComputedRef,
+} from 'vue';

package/zod.ts

@@ -0,0 +1,2 @@
+export { z } from 'zod';
+export type { ZodSchema, ZodType, ZodObject, ZodArray, ZodString, ZodNumber, ZodBoolean, ZodEnum, ZodUnion, ZodIntersection, ZodOptional, ZodNullable, ZodDefault, ZodError, ZodIssue, infer as ZodInfer } from 'zod';

package/zx.ts

@@ -0,0 +1 @@
+export { $, cd, chalk, echo, fs, glob, os, path, question, sleep, spinner, stdin, within, argv, fetch, which, nothrow, quiet, retry, expBackoff, ProcessOutput, ProcessPromise } from 'zx';