@deepseek-ai/dsh-util-workspace-path 0.1.7-rc.1 → 0.2.0-rc.1

package/README.i18n.yaml

@@ -1,6 +1,25 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/util/workspace-path/README.md
-README.md: 2de3157ee8bbe5ea216be303c1a1520d4b92126c
-README.zh.md: b46402b0ecf4025224768a29af1ea984ff7d497f
+/:
+  en: e8d97ffa99a57ab7
+  zh: 2d7247c47412c30a
+/dsh-util-workspace-path:
+  en: 328c592b68c88e44
+  zh: 7a2f03def21b86fe
+/dsh-util-workspace-path/summary:
+  en: ffdecddc9c4957ad
+  zh: 33cf84892aa5e669
+/dsh-util-workspace-path/table-of-contents:
+  en: e8236aa6cbcb7dca
+  zh: 500e57982344c0fa
+/dsh-util-workspace-path/file-addresses:
+  en: fa695bca8bd534e0
+  zh: d8feffb4794adfcd
+/dsh-util-workspace-path/known-limitations-and-deferred-work:
+  en: 1e6d448f4f0030c4
+  zh: c050dd5e470fe47b
+/dsh-util-workspace-path/known-limitations-and-deferred-work/dev-note:
+  en: cfc7173facebc57c
+  zh: 4ea51377d7c9c147

package/README.md

@@ -26,7 +26,7 @@ A resource address is `dsh-resource://<type>/…`, and the type — the URI host
 
 `sessionFileAddress(sessionId, path)` normalizes `\` to `/` and drops leading `./`, but preserves leading `/` characters. Every id and path segment is component-encoded with `:` kept literal. `fileAddressFor(sessionId, cwd, path)` always builds a Session address: paths inside `cwd` become relative; other absolute paths, including when `cwd` is unknown, stay absolute within that Session address. `absoluteFileAddress(absolutePath)` builds only the Session-less form. `parseFileAddress(address)` checks the exact file-address prefix, ignores query and fragment suffixes, decodes each segment, and returns `{ scope, sessionId, path }` for a Session address or `{ scope, path }` for the Session-less form. Another type or scheme, an unknown scope, a missing id or path, or a malformed escape returns `undefined`.
 
-`fileMediaUrl(base, path)` builds an authenticated file-route URL from an already-decoded absolute path. It preserves literal percent signs and deployment prefixes, and rejects non-HTTP application bases, relative paths, network-path prefixes, and control characters. Markdown owners decode authored URLs before calling it; native file-card paths are passed unchanged.
+`fileMediaUrl(base, path)` builds an authenticated file-route URL from an already-decoded absolute path. It accepts HTTP(S) application bases and the Desktop `dsh-app://app/` origin, preserves literal percent signs and deployment prefixes, and rejects other application bases, relative paths, network-path prefixes, and control characters. Markdown owners decode authored URLs before calling it; native file-card paths are passed unchanged.
 
 -----
 

package/README.zh.md

@@ -26,7 +26,7 @@ kind: "package-library"
 
 `sessionFileAddress(sessionId, path)` 将 `\` 归一为 `/`，去掉前导 `./`，但保留前导 `/` 字符。id 和每个路径段都做组件编码，`:` 保持字面。`fileAddressFor(sessionId, cwd, path)` 始终构造 Session 地址：`cwd` 内的路径转为相对路径；其他绝对路径（包括 `cwd` 未知时）仍作为该 Session 地址内的绝对路径。`absoluteFileAddress(absolutePath)` 只构造不带 Session 的形式。`parseFileAddress(address)` 检查精确的文件地址前缀、忽略查询与片段后缀、逐段解码，并为 Session 地址返回 `{ scope, sessionId, path }`，为不带 Session 的形式返回 `{ scope, path }`。其他 type 或 scheme、未知作用域、缺 id 或路径，或错误转义都返回 `undefined`。
 
-`fileMediaUrl(base, path)` 从已解码的绝对路径生成带认证文件路由的 URL，保留字面量百分号与部署前缀，并拒绝非 HTTP 应用基址、相对路径、网络路径前缀和控制字符。Markdown 调用方先解码所写 URL；原生文件卡片路径原样传入。
+`fileMediaUrl(base, path)` 从已解码的绝对路径生成带认证文件路由的 URL，支持 HTTP(S) 应用基址与桌面端 `dsh-app://app/` 来源，保留字面量百分号与部署前缀，并拒绝其他应用基址、相对路径、网络路径前缀和控制字符。Markdown 调用方先解码所写 URL；原生文件卡片路径原样传入。
 
 -----
 

package/lib/index.js

@@ -188,12 +188,12 @@ function relativizeToCwd(text, cwd) {
 }
 /**
 * Address a decoded absolute file path through the authenticated file route.
-* @param base - HTTP(S) application base, including its deployment prefix.
+* @param base - HTTP(S) application base, including its deployment prefix, or `dsh-app://app/`.
 * @param path - Native file path; URL escapes in authored Markdown must already be decoded.
 * @returns File URL, or undefined for unsupported transports and non-absolute paths.
 */
 function fileMediaUrl(base, path) {
-	if (!/^https?:/u.test(base) || !isAbsoluteWorkspacePath(path) || /^[/\\]{2}/u.test(path) || /[\u0000-\u001f\u007f]/u.test(path)) return void 0;
+	if (!/^https?:/u.test(base) && !base.startsWith("dsh-app://app/") || !isAbsoluteWorkspacePath(path) || /^[/\\]{2}/u.test(path) || /[\u0000-\u001f\u007f]/u.test(path)) return void 0;
 	return new URL(`api/file?path=${encodeURIComponent(path)}`, base).href;
 }
 //#endregion

package/lib/types/index.d.ts

@@ -59,7 +59,7 @@ export declare function fileAddressFor(sessionId: string, cwd: string | undefine
 export declare function relativizeToCwd(text: string, cwd: string | undefined): string;
 /**
  * Address a decoded absolute file path through the authenticated file route.
- * @param base - HTTP(S) application base, including its deployment prefix.
+ * @param base - HTTP(S) application base, including its deployment prefix, or `dsh-app://app/`.
  * @param path - Native file path; URL escapes in authored Markdown must already be decoded.
  * @returns File URL, or undefined for unsupported transports and non-absolute paths.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-util-workspace-path",
   "description": "Browser-safe Workspace path and display helpers",
-  "version": "0.1.7-rc.1",
+  "version": "0.2.0-rc.1",
   "publishConfig": {
     "access": "public"
   },