@hpyperry/dsh-ref-lib 0.7.0

package/lib/validate.js

@@ -0,0 +1,35 @@
+/**
+ * 跨 node/client 共享的**零依赖**校验与消毒纯函数。
+ *
+ * node half（service/logic/render）与 client half（client/data.ts）分属两个构建
+ * 产物，无法共享带 node 依赖的模块；本模块只依赖类型（spec.ts，type-only 导入
+ * 在打包时被擦除），两半均可直接引用——消除 `isRefLibEntry` 在 logic.ts 与
+ * client/data.ts 中的逐字重复，控制字符集合也在此统一维护。
+ * @module @hpyperry/dsh-ref-lib/src/validate
+ */
+/**
+ * 不可见控制字符集合（提示词注入卫生）：
+ * C0（\u0000-\u001f）、DEL（\u007f）、C1（\u0080-\u009f）、行/段分隔符
+ * （\u2028/\u2029——旧实现遗漏，同样能破坏注入格式）。
+ * 用于 add 拒绝（service.ts）与渲染层兜底消毒（render.ts）。
+ */
+const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
+const CONTROL_CHARACTERS_GLOBAL = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/g;
+/** 文本是否含不可见控制字符。 */
+export function hasControlCharacters(text) {
+    return CONTROL_CHARACTERS.test(text);
+}
+/** 把全部不可见控制字符替换为 U+FFFD（路径/备注最终会进入系统提示词，兜底消毒）。 */
+export function sanitizeControlCharacters(text) {
+    return text.replace(CONTROL_CHARACTERS_GLOBAL, '\uFFFD');
+}
+/** 校验一个未知对象是否为合法条目（宽松：仅要求 id/path 字符串、note 可选字符串）。 */
+export function isRefLibEntry(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const { id, path, note } = value;
+    if (typeof id !== 'string' || typeof path !== 'string')
+        return false;
+    return note === undefined || typeof note === 'string';
+}
+//# sourceMappingURL=validate.js.map

package/lib/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,0CAA0C,CAAA;AACrE,MAAM,yBAAyB,GAAG,2CAA2C,CAAA;AAE7E,oBAAoB;AACpB,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,OAAO,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAA;AAC1D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAyD,CAAA;IACpF,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACpE,OAAO,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAA;AACvD,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@hpyperry/dsh-ref-lib",
+  "version": "0.7.0",
+  "description": "只读参考库插件：UI 交互式管理（应用内目录浏览器/系统选择器/手动路径直加）+ systemPrompt 注入 + per-session sidecar 持久化",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "tsc && tsdown",
+    "build:node": "tsc",
+    "build:client": "tsdown",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.31",
+    "eslint": "^10.8.1",
+    "prettier": "^3.9.6",
+    "react": "^18.3.1",
+    "tsdown": "^0.22.14",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.67.0",
+    "vitest": "^4.0.0"
+  }
+}