oipage 1.6.0 → 1.7.0-alpha.1

package/.github/FUNDING.yml

@@ -1,12 +1,12 @@
-# These are supported funding model platforms
-
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
 custom: ['https://zxl20070701.github.io/notebook/home.html']

package/AUTHORS.txt

@@ -1,6 +1,6 @@
-Authors ordered by first contribution.
-
-zxl20070701 <1904314465@qq.com> <https://github.com/zxl20070701>
-
------------------------------------------------------
-We thank all of them for their contributions!
+Authors ordered by first contribution.
+
+zxl20070701 <1904314465@qq.com> <https://github.com/zxl20070701>
+
+-----------------------------------------------------
+We thank all of them for their contributions!

package/CHANGELOG

@@ -1,137 +1,144 @@
-v1.0.0:
-    date:2025-02-13
-    changes:
-      - 原v0.x的功能将独立一个分支继续维护：https://github.com/oi-contrib/OIPage/blob/v0.x/CHANGELOG
-        （v0.x保持对零碎方法这种形式的支持和维护，此版本开始将作为一个框架或一个系统的工具箱以提供更高效的使用方式，这是一次彻底的非兼容改造）
-      - 初始化版本（v1.x）
-        1、API功能（浏览器）
-          * animation 动画
-          * getStyle 获取节点样式
-          * setStyle 设置节点样式
-          * onReady 加载完毕执行
-          * throttle 节流函数
-        2、API功能（Node.js）
-          * animation 动画
-          * deeplog 进度打印
-          * linglog 单行打印
-          * throttle 节流函数
-        3、命令（oipage-cli）
-          * serve 开发服务器
-v1.1.0:
-    date:2025-02-18
-    changes:
-      - 修复bug
-        1、通过路径类型判断以修复开发服务器无法设置绝对路径问题
-      - 优化改造
-        1、使用流读取以使开发服务器支持大文件下载
-          （同时添加下载进度可查）
-      - 新增功能
-        1、API功能（Node.js）
-          * disk 磁盘相关操作
-            （包括：deleteDisk、copyDisk）
-          * logform 表单输入
-        2、命令（oipage-cli）
-          * dist 磁盘操作
-          * run 运行多命令
-v1.2.0:
-    date:2025-02-25
-    changes:
-      - 优化改造
-        1、优化npm包目录结构等
-      - 新增功能
-        1、开发服务器
-          * 添加配置文件
-            （oipage-cli serve --config ./oipage.config.js）
-          * 新增对node_modules包引入支持
-v1.2.1:
-    date:2025-03-06
-    changes:
-      - 修复bug
-        1、开发服务器
-          * 修复路径不存在时未正确同步修改浏览器地址问题
-v1.3.0:（已废弃，请用1.3.1代替）
-    date:2025-05-18
-    changes:
-      - 修复bug
-        1、开发服务器
-          * 修复服务器根路径判断错误导致node_modules包查找错误问题
-        2、修复animation动画types类型定义错误问题
-      - 新增功能
-        1、API功能（浏览器）
-          * reader 文本分析读取器
-          * performChunk 空闲执行分片函数
-          * strToJson JSON字符串解析
-        2、API功能（Node.js）
-          * reader 文本分析读取器
-          * strToJson JSON字符串解析
-        3、开发服务器
-          * 新增 devServer.intercept 请求拦截
-          * 新增对 if-modified-since和last-modified 之304协商缓存的支持
-v1.3.1:
-    date:2025-05-23
-    changes:
-      - 修复bug
-        1、开发服务器
-          * 由于是否入口判断导致import语句未正确解析
-          * 修复 Last-Modified 格式不规范导致的运行报错
-v1.4.0:
-    date:2025-09-02
-    changes:
-      - 修复bug
-        1、修复logform运行报错
-      - 新增功能
-        1、API功能（浏览器）
-          * dateFormat 日期格式化
-          * numberFormat 数字格式化
-          * XHRIntercept XHR拦截
-        2、API功能（Node.js）
-          * dateFormat 日期格式化
-          * numberFormat 数字格式化
-        3、开发服务器
-          * 新增 serve.d.ts 以支持作为API在TypeScript中环境
-            （仅对内使用，未正式对外暴露API相关文档）
-          * 添加304是否启用开关
-          * 应用市场（website内置网站）
-v1.4.1:
-    date:2025-09-02
-    changes:
-        - 修复bug
-          1、修复开发服务器大文件丢失文件大小问题
-v1.5.0:
-    date:2025-11-13
-    changes:
-        - 修复bug
-          1、修复404网站在手机浏览器显示高问题
-          2、服务器响应类型由 Content-type 改为 Content-Type
-          3、修复dateFormat第二个参数无法缺省报错
-          4、修复numberFormat不支持负数问题
-        - 优化改造
-          1、优化run命令日志打印
-        - 新增功能
-          1、开发服务器 / 应用市场
-            * 群聊天
-            * 图片编辑器
-            * 图片转PDF
-          2、API功能（Node.js）
-            * disk 磁盘相关操作
-            （包括：moveDisk、listDisk）
-v1.6.0:
-    date:2025-12-14
-    changes:
-        - 修复bug
-          1、修复logform在run下无法正常使用问题
-            （关联issue： https://github.com/oi-contrib/OIPage/issues/4 ）
-          2、修复服务器错误修改XHR等请求数据问题
-        - 优化改造
-          1、命令行帮助打印更可读
-        - 新增功能
-          1、命令（oipage-cli）
-            * disk 
-                --link 创建磁盘链接
-                --delempty 删除空文件夹 
-            * network 网络相关
-            * run 支持动态参数
-              （关联issue： https://github.com/oi-contrib/OIPage/issues/5 ）
-          2、API功能（Node.js）
-            * disk 磁盘相关操作
-            （包括：linkDisk）
+v1.0.0:
+    date:2025-02-13
+    changes:
+      - 原v0.x的功能将独立一个分支继续维护：https://github.com/oi-contrib/OIPage/blob/v0.x/CHANGELOG
+        （v0.x保持对零碎方法这种形式的支持和维护，此版本开始将作为一个框架或一个系统的工具箱以提供更高效的使用方式，这是一次彻底的非兼容改造）
+      - 初始化版本（v1.x）
+        1、API功能（浏览器）
+          * animation 动画
+          * getStyle 获取节点样式
+          * setStyle 设置节点样式
+          * onReady 加载完毕执行
+          * throttle 节流函数
+        2、API功能（Node.js）
+          * animation 动画
+          * deeplog 进度打印
+          * linglog 单行打印
+          * throttle 节流函数
+        3、命令（oipage-cli）
+          * serve 开发服务器
+v1.1.0:
+    date:2025-02-18
+    changes:
+      - 修复bug
+        1、通过路径类型判断以修复开发服务器无法设置绝对路径问题
+      - 优化改造
+        1、使用流读取以使开发服务器支持大文件下载
+          （同时添加下载进度可查）
+      - 新增功能
+        1、API功能（Node.js）
+          * disk 磁盘相关操作
+            （包括：deleteDisk、copyDisk）
+          * logform 表单输入
+        2、命令（oipage-cli）
+          * dist 磁盘操作
+          * run 运行多命令
+v1.2.0:
+    date:2025-02-25
+    changes:
+      - 优化改造
+        1、优化npm包目录结构等
+      - 新增功能
+        1、开发服务器
+          * 添加配置文件
+            （oipage-cli serve --config ./oipage.config.js）
+          * 新增对node_modules包引入支持
+v1.2.1:
+    date:2025-03-06
+    changes:
+      - 修复bug
+        1、开发服务器
+          * 修复路径不存在时未正确同步修改浏览器地址问题
+v1.3.0:（已废弃，请用1.3.1代替）
+    date:2025-05-18
+    changes:
+      - 修复bug
+        1、开发服务器
+          * 修复服务器根路径判断错误导致node_modules包查找错误问题
+        2、修复animation动画types类型定义错误问题
+      - 新增功能
+        1、API功能（浏览器）
+          * reader 文本分析读取器
+          * performChunk 空闲执行分片函数
+          * strToJson JSON字符串解析
+        2、API功能（Node.js）
+          * reader 文本分析读取器
+          * strToJson JSON字符串解析
+        3、开发服务器
+          * 新增 devServer.intercept 请求拦截
+          * 新增对 if-modified-since和last-modified 之304协商缓存的支持
+v1.3.1:
+    date:2025-05-23
+    changes:
+      - 修复bug
+        1、开发服务器
+          * 由于是否入口判断导致import语句未正确解析
+          * 修复 Last-Modified 格式不规范导致的运行报错
+v1.4.0:
+    date:2025-09-02
+    changes:
+      - 修复bug
+        1、修复logform运行报错
+      - 新增功能
+        1、API功能（浏览器）
+          * dateFormat 日期格式化
+          * numberFormat 数字格式化
+          * XHRIntercept XHR拦截
+        2、API功能（Node.js）
+          * dateFormat 日期格式化
+          * numberFormat 数字格式化
+        3、开发服务器
+          * 新增 serve.d.ts 以支持作为API在TypeScript中环境
+            （仅对内使用，未正式对外暴露API相关文档）
+          * 添加304是否启用开关
+          * 应用市场（website内置网站）
+v1.4.1:
+    date:2025-09-02
+    changes:
+        - 修复bug
+          1、修复开发服务器大文件丢失文件大小问题
+v1.5.0:
+    date:2025-11-13
+    changes:
+        - 修复bug
+          1、修复404网站在手机浏览器显示高问题
+          2、服务器响应类型由 Content-type 改为 Content-Type
+          3、修复dateFormat第二个参数无法缺省报错
+          4、修复numberFormat不支持负数问题
+        - 优化改造
+          1、优化run命令日志打印
+        - 新增功能
+          1、开发服务器 / 应用市场
+            * 群聊天
+            * 图片编辑器
+            * 图片转PDF
+          2、API功能（Node.js）
+            * disk 磁盘相关操作
+            （包括：moveDisk、listDisk）
+v1.6.0:
+    date:2025-12-14
+    changes:
+        - 修复bug
+          1、修复logform在run下无法正常使用问题
+            （关联issue： https://github.com/oi-contrib/OIPage/issues/4 ）
+          2、修复服务器错误修改XHR等请求数据问题
+        - 优化改造
+          1、命令行帮助打印更可读
+        - 新增功能
+          1、命令（oipage-cli）
+            * disk 
+                --link 创建磁盘链接
+                --delempty 删除空文件夹 
+            * network 网络相关
+            * run 支持动态参数
+              （关联issue： https://github.com/oi-contrib/OIPage/issues/5 ）
+          2、API功能（Node.js）
+            * disk 磁盘相关操作
+            （包括：linkDisk）
+v1.7.0:
+    date:
+    changes:
+        - 新增功能
+          1、API功能（Node.js）
+            * remote HTTP请求
+            （包括：get、post）

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) zxl20070701 走一步，再走一步
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) zxl20070701 走一步，再走一步
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -1,95 +1,95 @@
--   💘 开源不易，去 <i>[Github给个Star](https://github.com/oi-contrib/OIPage) </i>吧！
-
-<img src='https://oi-contrib.github.io/OIPage/images/logo.png' height='100px'/>
-
-<p>
-    <a href="https://zxl20070701.github.io/toolbox/#/npm-download?packages=oipage&interval=7">
-        <img src="https://img.shields.io/npm/dm/oipage.svg" alt="downloads">
-    </a>
-    <a href="https://www.npmjs.com/package/oipage">
-        <img src="https://img.shields.io/npm/v/oipage.svg" alt="npm">
-    </a>
-    <a href="https://github.com/oi-contrib/OIPage/issues">
-        <img src="https://img.shields.io/github/issues/oi-contrib/OIPage" alt="issue">
-    </a>
-    <a href="https://github.com/oi-contrib/OIPage" target='_blank'>
-        <img alt="GitHub repo stars" src="https://img.shields.io/github/stars/oi-contrib/OIPage?style=social">
-    </a>
-    <a href="https://github.com/oi-contrib/OIPage">
-        <img src="https://img.shields.io/github/forks/oi-contrib/OIPage" alt="forks">
-    </a>
-     <a href="https://gitee.com/oi-contrib/OIPage" target='_blank'>
-        <img alt="Gitee repo stars" src="https://gitee.com/oi-contrib/OIPage/badge/star.svg">
-    </a>
-    <a href="https://gitee.com/oi-contrib/OIPage">
-        <img src="https://gitee.com/oi-contrib/OIPage/badge/fork.svg" alt="forks">
-    </a>
-</p>
-
-<img src="https://nodei.co/npm/oipage.png?downloads=true&amp;downloadRank=true&amp;stars=true" alt="NPM">
-
-# [OIPage](https://github.com/oi-contrib/OIPage)
-前端网页或应用快速开发助手，包括开发服务器、辅助命令、实用API等。官网地址：[https://oi-contrib.github.io/OIPage](https://oi-contrib.github.io/OIPage)
-
-## 如何使用？
-
-你可以作为一个命令行使用，那么你需要全局安装：
-
-```shell
-npm install -g oipage
-```
-
-也可以作为项目开发中的一个功能加强，在 package.json 中配置命令或nodejs文件中引入需要的模块使用，那么就在项目中执行安装命令：
-
-```shell
-npm install oipage --save
-```
-
-安装后，就可以直接作为命令行使用了。你可以打印帮助查看：
-
-```shell
-oipage-cli
-```
-
-比如会出现类似下列内容：
-
-```
-OIPage@v1.2.0
-
-可以使用的命令如下：
-
-【1】oipage-cli serve 开发服务器
-    --port|-p 端口号
-    --baseUrl 服务器根目录
-......
-```
-
-根据提示我们知道，比如第一个命令，其提供了一个快速访问本地资源服务器的功能，比如执行：
-
-```shell
-oipage-cli serve -p 8080
-```
-
-启动成功后，直接访问： http://localhost:8080/ 即可。
-
-如果你需要在项目中使用，我们也提供了一些有用的API，具体可以访问[ 在线文档 ](https://oi-contrib.github.io/OIPage)进行了解。
-
-## 应用市场
-
-为了方便日常使用，内置了一个应用市场网站，比如有如下功能：
-
-### 群聊天
-
-<img src="./snipping/chart.png" />
-
-### 图片编辑器
-
-<img src="./snipping/image-editor.png" />
-
-已有功能或更多功能我们将根据实际情况逐步完善和维护，当然，你可以通过 [issue](https://github.com/oi-contrib/OIPage/issues) 给我们留言，告诉我们你的改进意见。
-
-## 版权
-
-MIT License
-
-Copyright (c) [zxl20070701](https://zxl20070701.github.io/notebook/home.html) 走一步，再走一步
+-   💘 开源不易，去 <i>[Github给个Star](https://github.com/oi-contrib/OIPage) </i>吧！
+
+<img src='https://oi-contrib.github.io/OIPage/images/logo.png' height='100px'/>
+
+<p>
+    <a href="https://zxl20070701.github.io/toolbox/#/npm-download?packages=oipage&interval=7">
+        <img src="https://img.shields.io/npm/dm/oipage.svg" alt="downloads">
+    </a>
+    <a href="https://www.npmjs.com/package/oipage">
+        <img src="https://img.shields.io/npm/v/oipage.svg" alt="npm">
+    </a>
+    <a href="https://github.com/oi-contrib/OIPage/issues">
+        <img src="https://img.shields.io/github/issues/oi-contrib/OIPage" alt="issue">
+    </a>
+    <a href="https://github.com/oi-contrib/OIPage" target='_blank'>
+        <img alt="GitHub repo stars" src="https://img.shields.io/github/stars/oi-contrib/OIPage?style=social">
+    </a>
+    <a href="https://github.com/oi-contrib/OIPage">
+        <img src="https://img.shields.io/github/forks/oi-contrib/OIPage" alt="forks">
+    </a>
+     <a href="https://gitee.com/oi-contrib/OIPage" target='_blank'>
+        <img alt="Gitee repo stars" src="https://gitee.com/oi-contrib/OIPage/badge/star.svg">
+    </a>
+    <a href="https://gitee.com/oi-contrib/OIPage">
+        <img src="https://gitee.com/oi-contrib/OIPage/badge/fork.svg" alt="forks">
+    </a>
+</p>
+
+<img src="https://nodei.co/npm/oipage.png?downloads=true&amp;downloadRank=true&amp;stars=true" alt="NPM">
+
+# [OIPage](https://github.com/oi-contrib/OIPage)
+前端网页或应用快速开发助手，包括开发服务器、辅助命令、实用API等。官网地址：[https://oi-contrib.github.io/OIPage](https://oi-contrib.github.io/OIPage)
+
+## 如何使用？
+
+你可以作为一个命令行使用，那么你需要全局安装：
+
+```shell
+npm install -g oipage
+```
+
+也可以作为项目开发中的一个功能加强，在 package.json 中配置命令或nodejs文件中引入需要的模块使用，那么就在项目中执行安装命令：
+
+```shell
+npm install oipage --save
+```
+
+安装后，就可以直接作为命令行使用了。你可以打印帮助查看：
+
+```shell
+oipage-cli
+```
+
+比如会出现类似下列内容：
+
+```
+OIPage@v1.2.0
+
+可以使用的命令如下：
+
+【1】oipage-cli serve 开发服务器
+    --port|-p 端口号
+    --baseUrl 服务器根目录
+......
+```
+
+根据提示我们知道，比如第一个命令，其提供了一个快速访问本地资源服务器的功能，比如执行：
+
+```shell
+oipage-cli serve -p 8080
+```
+
+启动成功后，直接访问： http://localhost:8080/ 即可。
+
+如果你需要在项目中使用，我们也提供了一些有用的API，具体可以访问[ 在线文档 ](https://oi-contrib.github.io/OIPage)进行了解。
+
+## 应用市场
+
+为了方便日常使用，内置了一个应用市场网站，比如有如下功能：
+
+### 群聊天
+
+<img src="./snipping/chart.png" />
+
+### 图片编辑器
+
+<img src="./snipping/image-editor.png" />
+
+已有功能或更多功能我们将根据实际情况逐步完善和维护，当然，你可以通过 [issue](https://github.com/oi-contrib/OIPage/issues) 给我们留言，告诉我们你的改进意见。
+
+## 版权
+
+MIT License
+
+Copyright (c) [zxl20070701](https://zxl20070701.github.io/notebook/home.html) 走一步，再走一步

package/bin/WebSocket/decodeWsFrame.js

@@ -1,43 +1,43 @@
-
-// 处理收到的数据
-module.exports = function decodeWsFrame(data) {
-    let start = 0;
-    let frame = {
-        isFinal: (data[start] & 0x80) === 0x80,
-        opcode: data[start++] & 0xF,
-        masked: (data[start] & 0x80) === 0x80,
-        payloadLen: data[start++] & 0x7F,
-        maskingKey: '',
-        payloadData: null
-    };
-
-    if (frame.payloadLen === 126) {
-        frame.payloadLen = (data[start++] << 8) + data[start++];
-    } else if (frame.payloadLen === 127) {
-        frame.payloadLen = 0;
-        for (let i = 7; i >= 0; --i) {
-            frame.payloadLen += (data[start++] << (i * 8));
-        }
-    }
-
-    if (frame.payloadLen) {
-        if (frame.masked) {
-            const maskingKey = [
-                data[start++],
-                data[start++],
-                data[start++],
-                data[start++]
-            ];
-
-            frame.maskingKey = maskingKey;
-
-            frame.payloadData = data
-                .slice(start, start + frame.payloadLen)
-                .map((byte, idx) => byte ^ maskingKey[idx % 4]);
-        } else {
-            frame.payloadData = data.slice(start, start + frame.payloadLen);
-        }
-    }
-
-    return frame;
-};
+
+// 处理收到的数据
+module.exports = function decodeWsFrame(data) {
+    let start = 0;
+    let frame = {
+        isFinal: (data[start] & 0x80) === 0x80,
+        opcode: data[start++] & 0xF,
+        masked: (data[start] & 0x80) === 0x80,
+        payloadLen: data[start++] & 0x7F,
+        maskingKey: '',
+        payloadData: null
+    };
+
+    if (frame.payloadLen === 126) {
+        frame.payloadLen = (data[start++] << 8) + data[start++];
+    } else if (frame.payloadLen === 127) {
+        frame.payloadLen = 0;
+        for (let i = 7; i >= 0; --i) {
+            frame.payloadLen += (data[start++] << (i * 8));
+        }
+    }
+
+    if (frame.payloadLen) {
+        if (frame.masked) {
+            const maskingKey = [
+                data[start++],
+                data[start++],
+                data[start++],
+                data[start++]
+            ];
+
+            frame.maskingKey = maskingKey;
+
+            frame.payloadData = data
+                .slice(start, start + frame.payloadLen)
+                .map((byte, idx) => byte ^ maskingKey[idx % 4]);
+        } else {
+            frame.payloadData = data.slice(start, start + frame.payloadLen);
+        }
+    }
+
+    return frame;
+};