@jayyuen66/dsh-plugin-shared 0.1.0

package/config/tsconfig.base.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2024"],
+    "types": ["node"],
+    "strict": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noUncheckedSideEffectImports": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "exactOptionalPropertyTypes": true,
+    "noUncheckedIndexedAccess": true,
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  }
+}

package/config/tsconfig.client.base.json

@@ -0,0 +1,10 @@
+{
+  "//": "target 不覆盖：与官方一致（deepseek-harness/tsconfig.base.json 是 es2024，client 层只加 lib）。本仓的 client 产物由 rolldown 打，构建脚本里没有 target，也没有读 tsconfig ⇒ 这里的 target 只影响类型面，不影响产物语法。旧基线把它钉在 ES2020 是继承来的写法，实测无产物后果，只把 Promise.withResolvers 一类 ES2024 API 判成 TS2550，逼出包级 lint 例外。",
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2024", "DOM", "DOM.Iterable", "ESNext.Disposable"],
+    "types": []
+  }
+}

package/config/vitest.base.ts

@@ -0,0 +1,78 @@
+// shared/config/vitest.base.ts —— 13 个包的 vitest 配置单源。
+//
+// 为什么从"每包一份零 import 的 `.mjs` 纯对象"换成"TS + 共享基模块"：老 README 给出的理由是
+// "vitest 会把配置复制到 `node_modules/.vite-temp/` 再加载，从那里解析 `vitest` 会被 node_modules
+// 边界截断"。在 vitest 5.0.2 上实测三条，全部与该理由相反：
+//   ① `.mjs` 配置里 `import { defineConfig } from "vitest/config"` ⇒ 通过；
+//   ② 配置改名 `.ts` 并同样 import ⇒ 通过；
+//   ③ 两次运行后 `plugins/node_modules/.vite-temp/` 与 `shared/node_modules/.vite-temp/` 都是空目录
+//      （复制路径没有被触发）。
+// 也就是说那是 rolldown-vite 早期版本的行为，在 5.0.2 + Vite 8.3.1 上已经不成立。TS 形态的净收益：
+// 判据能写理由、能被 `defineConfig` 的类型检查、能把 13 份重复的公共面收成一份（owner 口径：
+// 能用 TS 就不用其他格式）。各包配置从此只留**自己的差异**：覆盖率 `include` 的面。
+//
+// 阈值不在这里放宽：四项 100% 是每包都生效的默认，任何包要例外必须在自己的配置里写明理由。
+
+import { defineConfig } from "vitest/config";
+import type { ViteUserConfig } from "vitest/config";
+
+/**
+ * 类型名按实测取（四轮才钉准，过程记在这里免得下次再猜）：
+ *  - `import type { UserConfig } from "vitest/config"` ⇒ TS2305，5.0.2 不导出这个名字；
+ *  - `import type { UserConfig as ViteUserConfig }` 同样 TS2305 —— 它在 `vitest/config` 里的
+ *    **导出名就已经是 `ViteUserConfig`**（源上是 `export { UserConfig as ViteUserConfig } from 'vite'`），
+ *    别名要写在被导入的那一侧，不能自己再造一遍；
+ *  - `Parameters<typeof defineConfig>[0]` ⇒ 合出来是重载联合 `ViteUserConfigExport`（函数类型），
+ *    取 `.test` 直接 TS2339，并级联两条 `no-unsafe-*`；
+ *  - `TestUserConfig` 是 **test 块本身**的类型，不是配置文件对象类型，
+ *    拿它当返回值会在 `exactOptionalPropertyTypes: true` 下报 TS2375。
+ * 正确的那个是 `ViteUserConfig`：vitest 用模块声明合并给它加了 `test?: VitestInlineConfig`，
+ * 也正是 `defineConfig(config: UserConfig): UserConfig` 那条重载吃的形状。
+ */
+type PackageConfig = ViteUserConfig;
+
+/** 覆盖率面与 test 块里真正因包而异的那一项。 */
+export interface PackageVitestOptions {
+  /** `coverage.include` —— 本包该被统计的源文件（各包只有这里不同）。 */
+  coverageInclude: string[];
+  /** 追加/覆盖 test 字段（少用；出现即应在包内配置里写明为什么）。 */
+  test?: PackageConfig["test"];
+}
+
+/**
+ * 公共面：13 份配置里逐字相同的那部分，从今往后才真的只有一处。
+ * `testTimeout: 20_000` 是 12 个包的共同值（vitest 默认 5000），shared 原先没写、
+ * 现在继承这个值只会放宽不会收紧，故不会把任何已过用例变成不稳定。
+ */
+export function definePackageConfig(options: PackageVitestOptions): PackageConfig {
+  const { coverageInclude, test } = options;
+  return defineConfig({
+    test: {
+      include: ["test/**/*.test.ts"],
+      environment: "node",
+      testTimeout: 20_000,
+      coverage: {
+        provider: "v8",
+        include: coverageInclude,
+        exclude: [
+          "test/**",
+          "node_modules/**",
+          "build-client*",
+          "client.js",
+          "agents/**",
+          "scripts/**",
+          "**/*.d.mts",
+        ],
+        reporter: ["text", "json-summary", "json"],
+        reportsDirectory: "coverage",
+        thresholds: {
+          lines: 100,
+          statements: 100,
+          functions: 100,
+          branches: 100,
+        },
+      },
+      ...test,
+    },
+  });
+}

package/dist/canonicalize-region-paths.js

@@ -0,0 +1,63 @@
+//#region lib/canonicalize-region-paths.ts
+/** rolldown 模块标记的前缀。`//#endregion` 与代码里的任何其它行都不在本函数的射程内。 */
+const REGION_MARK = "//#region ";
+/** 路径行首的相对段（`./` 与 `../` 的任意串），收掉后跨包依赖在两处 cwd 下才同形。 */
+const LEADING_RELATIVE_SEGMENTS = /^(?:\.\.?\/)+/u;
+/**
+* 取路径的末段。分隔符两头认：产物里的模块路径由 rolldown 写成 `/`，
+* 而 `import.meta.dirname` 在 Windows 上是 `\`。
+* @param dir - 目录路径
+* @returns 末段；只剩分隔符时为空串
+*/
+function lastSegment(dir) {
+	const trimmed = dir.replace(/[/\\]+$/u, "");
+	const index = Math.max(trimmed.lastIndexOf("/"), trimmed.lastIndexOf("\\"));
+	return index === -1 ? trimmed : trimmed.slice(index + 1);
+}
+/**
+* 行首可被收掉的两枚锚点段：包根的父目录名（DSH_HOME 当 cwd 时多出来那一段）与包名。
+* @param pkgDir - 包根路径（调用方的 import.meta.dirname）
+* @returns 按序待收的段名；空串（pkgDir 只剩分隔符、或压根没有父目录）已剔除
+*/
+function leadingAnchors(pkgDir) {
+	const pkgName = lastSegment(pkgDir);
+	return [lastSegment(pkgDir.slice(0, pkgDir.length - pkgName.length)), pkgName].filter((anchor) => anchor.length > 0);
+}
+/**
+* 依次收掉行首的锚点段（每枚最多一次，且只在整段命中时收）。
+* @param path - 已收掉行首相对段的模块路径
+* @param anchors - 见 {@link leadingAnchors}
+* @returns 相对包根的形状；没有命中时段不变
+*/
+function stripLeadingAnchor(path, anchors) {
+	let rest = path;
+	for (const anchor of anchors) if (rest.startsWith(`${anchor}/`)) rest = rest.slice(anchor.length + 1);
+	return rest;
+}
+/**
+* 折单行：命中 `//#region ` 前缀才动刀，且只动该行之后的那段路径文本。
+* 代码中间的字符串（哪怕原样写着 `//#region foo/`）不在射程内——判据是整行行首。
+* @param line - 产物里的一行
+* @param anchors - 见 {@link leadingAnchors}
+* @returns canonical 形态的那一行
+*/
+function canonicalizeLine(line, anchors) {
+	if (line.startsWith(REGION_MARK)) {
+		const folded = line.slice(10).replace(LEADING_RELATIVE_SEGMENTS, "");
+		return `${REGION_MARK}${stripLeadingAnchor(folded, anchors)}`;
+	}
+	return line;
+}
+/**
+* 产物文本的 canonical 形态：所有 `//#region` 行折成相对包根的形状，其余字节原样保留。
+* @param code - builder 拿到的产物文本
+* @param pkgDir - 包根绝对路径（builder 的 import.meta.dirname）
+* @returns 与 process.cwd() 无关的同一份文本；对 canonical 输入幂等
+*/
+function canonicalizeRegionPaths(code, pkgDir) {
+	const anchors = leadingAnchors(pkgDir);
+	if (anchors.length === 0) return code;
+	return code.split("\n").map((line) => canonicalizeLine(line, anchors)).join("\n");
+}
+//#endregion
+export { canonicalizeRegionPaths };

package/dist/card-apply.js

@@ -0,0 +1,20 @@
+//#region lib/card-apply.ts
+/**
+* apply 幂等守卫：已 claim 返回 false（调用方直接 return），否则占位并
+* 挂 ctx.effect 清理——HMR 重载时 flag 复位，再次 apply 可重新声明。
+* @param ctx   - apply 的 ctx（需要 effect）。
+* @param flag  - globalThis 上的布尔标记键名（如 "__xxxCardApplied"）。
+* @param label - effect 标签（日志/生命周期可观测）。
+* @returns true 表示本次拿到声明权（继续执行），false 表示已被占位。
+*/
+function claimApply(ctx, flag, label) {
+	const marker = globalThis;
+	if (marker[flag] === true) return false;
+	marker[flag] = true;
+	ctx.effect(() => () => {
+		marker[flag] = void 0;
+	}, label);
+	return true;
+}
+//#endregion
+export { claimApply };