xshell 1.0.180 → 1.0.181

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xshell",
-    "version": "1.0.180",
+    "version": "1.0.181",
     "type": "module",
     "main": "./index.js",
     "bin": {

package/path.d.ts

@@ -55,7 +55,7 @@ export declare function extname(path: string): string;
 /** `/` */
 export declare const sep = "/";
 /** The platform-specific file delimiter. ';' or ':'. */
-export declare const delimiter: ";" | ":";
+export declare const delimiter: ":" | ";";
 /** Returns an object from a path string - the opposite of format().
     @param path path to evaluate.
     @throws {TypeError} if `path` is not a string. */
@@ -83,7 +83,7 @@ export declare let path: {
     basename: typeof basename;
     extname: typeof extname;
     sep: string;
-    delimiter: ";" | ":";
+    delimiter: ":" | ";";
     parse: typeof parse;
     format: typeof format;
     toNamespacedPath: typeof toNamespacedPath;

package/server.d.ts

@@ -117,7 +117,7 @@ export declare class Server {
             )
             return
         } */
-    try_send(ctx: Context, fpd_root: string, fp: string, log_404: boolean): Promise<boolean>;
+    try_send(ctx: Context, fpd_root: string, fp: string, log_404: boolean, assets_root?: string): Promise<boolean>;
     /** 将 body 设置为 fp 所指文件的 ReadStream
         检查 fp 是否合法，设置对应的 content-type，支持缓存，支持分块下载
         - ctx: Koa.Context
@@ -125,11 +125,13 @@ export declare class Server {
         - options?:
             - root?: 只能访问 root 下面的文件
             - absolute?: `false` 使用绝对路径指定发送的文件
-            - download?: `undefined` 在 response.headers 中加上 content-disposition: attachment 指示浏览器下载文件 */
-    fsend(ctx: Context, fp: string, { root, absolute, download, }?: {
+            - download?: `undefined` 在 response.headers 中加上 content-disposition: attachment 指示浏览器下载文件
+            - assets_root?: 替换模板 xxx.template.html 中 {root} 占位符 */
+    fsend(ctx: Context, fp: string, { root, absolute, download, assets_root, }?: {
         root?: string;
         absolute?: boolean;
         download?: boolean;
+        assets_root?: string;
     }): Promise<string>;
     /** - range: 取值为逗号分割的多个可用端口或端口区间 (不能含有空格，包含区间右值)，比如：`8321,8322,8300-8310,11000-11999
         - reverse?: `false` 在 range 内从后往前尝试 */

package/server.js

@@ -535,14 +535,14 @@ export class Server {
             )
             return
         } */
-    async try_send(ctx, fpd_root, fp, log_404) {
+    async try_send(ctx, fpd_root, fp, log_404, assets_root) {
         const { request: { _path, path, method }, response, } = ctx;
         if (response.body !== undefined || response.status !== 404)
             return true;
         if (method !== 'HEAD' && method !== 'GET')
             return false;
         try {
-            await this.fsend(ctx, fp, { root: fpd_root });
+            await this.fsend(ctx, fp, { root: fpd_root, assets_root });
             return true;
         }
         catch (error) {
@@ -564,8 +564,9 @@ export class Server {
         - options?:
             - root?: 只能访问 root 下面的文件
             - absolute?: `false` 使用绝对路径指定发送的文件
-            - download?: `undefined` 在 response.headers 中加上 content-disposition: attachment 指示浏览器下载文件 */
-    async fsend(ctx, fp, { root, absolute, download, } = {}) {
+            - download?: `undefined` 在 response.headers 中加上 content-disposition: attachment 指示浏览器下载文件
+            - assets_root?: 替换模板 xxx.template.html 中 {root} 占位符 */
+    async fsend(ctx, fp, { root, absolute, download, assets_root, } = {}) {
         assert(absolute || root?.isdir, t('fsend 必须传 absolute 选项或 root 文件夹'));
         const { request, request: { method } } = ctx;
         let { response } = ctx;
@@ -624,6 +625,11 @@ export class Server {
             // 以上会自动设置 response.body = null
             return fp;
         }
+        if (assets_root) {
+            response.body = (await fread(fp, { print: false }))
+                .replaceAll('{root}', assets_root);
+            return fp;
+        }
         const range_header = request.headers.range;
         if (range_header)
             try {

package/utils.browser.d.ts

@@ -75,7 +75,7 @@ export declare function encode(str: string): Uint8Array;
     在流式处理 (buffer 可能不完整) 时，应使用独立的 TextDecoder 实例调用 decode(buffer, { stream: true }) */
 export declare function decode(buffer: Uint8Array): string;
 /** 字符串字典序比较 */
-export declare function strcmp(l: string, r: string): 1 | 0 | -1;
+export declare function strcmp(l: string, r: string): 0 | 1 | -1;
 /** 比较 1.10.02 这种版本号
     - l, r: 两个版本号字符串
     - loose?: 宽松模式，允许两个版本号格式（位数）不一致 */

package/utils.d.ts

@@ -42,7 +42,7 @@ export declare function filter_values<TObj extends Record<string, any>>(obj: TOb
 /** 忽略对象中的 keys, 返回新对象 */
 export declare function omit<TObj>(obj: TObj, omit_keys: string[]): TObj;
 /** 字符串字典序比较 */
-export declare function strcmp(l: string, r: string): 1 | 0 | -1;
+export declare function strcmp(l: string, r: string): 0 | 1 | -1;
 /** 比较 1.10.02 这种版本号
     - l, r: 两个版本号字符串
     - loose?: 宽松模式，允许两个版本号格式（位数）不一致 */