ranuts 0.1.0-alpha.9 → 0.2.0-alpha.1

package/dist/plugins/vite-plugins-banner.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from 'vite';
+export default function vitePluginBanner(): Plugin;

package/dist/rolldown-runtime-I3TIJKkN.js

@@ -0,0 +1 @@
+var e=Object.defineProperty,r=(e,r)=>()=>(r||(e((r={exports:{}}).exports,r),e=null),r.exports),t=(r,t)=>{let o={};for(var a in r)e(o,a,{get:r[a],enumerable:!0});return t||e(o,Symbol.toStringTag,{value:"Module"}),o};export{t as n,r as t};

package/dist/src/node/appendFile.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description: 给一个已经存在的文件追加内容
+ * @param {string} path 文件路径
+ * @param {string} content 新加的内容
+ * @return {Promise}
+ */
+export declare const appendFile: (path: string, content: string) => Promise<Ranuts.Identification>;

package/dist/src/node/body.d.ts

@@ -0,0 +1,9 @@
+import type { MiddlewareFunction } from '@/node/server';
+interface ServerBody {
+    uploadDir: string;
+    encoding: BufferEncoding;
+    urlencoded: boolean;
+    json: boolean;
+}
+declare const bodyMiddleware: (options?: Partial<ServerBody>) => MiddlewareFunction;
+export default bodyMiddleware;

package/dist/src/node/color.d.ts

@@ -0,0 +1,7 @@
+declare const _default: Record<string, (input: string) => string | StringConstructor> & {
+    isColorSupported: boolean;
+    reset: (s: string) => string;
+    bold: (input: string) => string;
+    dim: (input: string) => string;
+};
+export default _default;

package/dist/src/node/command.d.ts

@@ -0,0 +1,8 @@
+export declare const runCommand: (command: string, args: string[]) => Promise<void>;
+interface PromptOption {
+    message: string;
+    defaultResponse: string;
+    stream: NodeJS.ReadWriteStream;
+}
+export declare const prompt: ({ message, stream, defaultResponse }: PromptOption) => Promise<boolean>;
+export {};

package/dist/src/node/ctx2req.d.ts

@@ -0,0 +1,5 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { MiddlewareFunction } from '@/node/server';
+type ConnectMiddleware = (req: IncomingMessage, res: ServerResponse, next?: Function) => void;
+declare function connect(connectMiddleware: ConnectMiddleware): MiddlewareFunction;
+export default connect;

package/dist/src/node/fileInfo.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description: 查询一个文件的详细信息，一般用于区分文件还是目录（data.isDirectory()）
+ * @param {string} path 文件路径
+ * @return {Promise}
+ */
+declare const queryFileInfo: (path: string) => Promise<Ranuts.Identification>;
+export default queryFileInfo;

package/dist/src/node/fs.d.ts

@@ -0,0 +1,7 @@
+import fs from 'node:fs';
+import type { Noop } from '@/utils/noop';
+export type FilePromiseResult = Promise<Ranuts.Identification> & {
+    abort?: Noop;
+};
+export type Error = NodeJS.ErrnoException | null;
+export default fs;

package/dist/src/node/get.d.ts

@@ -0,0 +1,10 @@
+interface Request {
+    url: string;
+}
+interface Response {
+    success: boolean;
+    data: unknown;
+    message: string;
+}
+declare const get: ({ url }: Request) => Promise<Response>;
+export default get;

package/dist/src/node/getIPAdress.d.ts

@@ -0,0 +1 @@
+export declare const getIPAdress: () => string | undefined;

package/dist/src/node/index.d.ts

@@ -0,0 +1,25 @@
+import Server from './server';
+import { appendFile } from './appendFile';
+import colors from './color';
+import body from './body';
+import { prompt, runCommand } from './command';
+import connect from './ctx2req';
+import queryFileInfo from './fileInfo';
+import get from './get';
+import { getIPAdress } from './getIPAdress';
+import isColorSupported from './isColorSupported';
+import paresUrl from './paresUrl';
+import readDir from './readDir';
+import readFile from './readFile';
+import Router from './router';
+import staticMiddleware from './send';
+import startTask from './startTask';
+import { readStream, writeStream } from './stream';
+import taskEnd from './taskEnd';
+import { traverse, traverseSync } from './traverse';
+import watchFile from './watchFile';
+import WSS from './ws';
+import writeFile from './writeFile';
+import type { Context } from './server';
+export { appendFile, colors, body, prompt, runCommand, connect, queryFileInfo, get, getIPAdress, isColorSupported, paresUrl, readDir, Router, readFile, staticMiddleware, Server, startTask, readStream, writeStream, taskEnd, traverse, traverseSync, watchFile, WSS, writeFile, };
+export type { Context };

package/dist/src/node/index.js

@@ -0,0 +1 @@
+import{P as e,S as t,r as n,x as r}from"../../color-CRdlaDqQ.js";import{Socket as o}from"node:net";import s from"node:http";import i from"node:os";import a,{createReadStream as c,createWriteStream as d,readdir as l,readdirSync as u,stat as f,statSync as h}from"node:fs";import p from"node:tty";import m,{hrtime as w}from"node:process";import g from"node:child_process";import y from"node:readline";import b from"node:https";import E,{join as v,resolve as x}from"node:path";import{promisify as S}from"node:util";import{Buffer as T}from"node:buffer";import P from"node:crypto";function O(){const e=i.networkInterfaces();for(const t in e){const n=e[t];if(n)for(let e=0;e<n.length;e++){const t=n[e];if("IPv4"===t.family&&"127.0.0.1"!==t.address&&!t.internal)return t.address}}}var q=class{middleware;ctx;constructor(){const e=new s.IncomingMessage(new o),t=new s.ServerResponse(e);this.ctx={ipv4:O,req:e,res:t},this.middleware=[]}use(e){if(!e)throw new Error("the use function has an incorrect argument");this.middleware.push(e)}listen(...e){const t=function(e){if(!Array.isArray(e))throw new TypeError("Middleware stack must be an array!");for(const t of e)if("function"!=typeof t)throw new TypeError("Middleware must be composed of functions!");return function(t,n){let r=-1;function o(s){if(s<=r)return Promise.reject(/* @__PURE__ */new Error("next() called multiple times"));r=s;let i=e[s];if(s===e.length&&n&&(i=n),!i)return Promise.resolve();try{return Promise.resolve(i(t,o.bind(null,s+1)))}catch(a){return Promise.reject(a)}}return o(0)}}(this.middleware);return s.createServer((e,n)=>{this.ctx.req=e,this.ctx.res=n,t(this.ctx).catch(C)}).listen(...e)}};function C(e){console.error(e.stack||e.toString())}var H=a,M=(e,t="utf-8")=>{const n=new AbortController,r=n.signal,o=new Promise((o,s)=>{H.readFile(e,{encoding:t,signal:r},(e,t)=>{e?(n.abort(),s({success:!1,_identification:!1,data:e})):o({success:!0,_identification:!0,data:t})})});return o.abort=n.abort,o},_=(e,t)=>new Promise((n,r)=>{H.appendFile(e,t,t=>{t?r({success:!1,_identification:!1,data:t}):M(e).then(e=>{n(e)})})}),F=m?.env&&!("NO_COLOR"in m.env||m.argv.includes("--no-color"))&&("FORCE_COLOR"in m.env||m.argv.includes("--color")||"win32"===m.platform||p.isatty(1)&&"dumb"!==m.env.TERM||"CI"in m.env),U=(e,t,n=e)=>r=>{const o=""+r,s=o.indexOf(t,e.length);return~s?e+j(o,t,n,s)+t:e+o+t},j=(e,t,n,r)=>{const o=e.substring(0,r)+n,s=e.substring(r+t.length),i=s.indexOf(t);return~i?o+j(s,t,n,i):o+s},k=Object.assign({},((e=F)=>{const t={};return Object.keys(n).forEach(r=>t[r]=e?U(n[r][0],n[r][1]):String),t})(),((e=F)=>({isColorSupported:e,reset:e?e=>`${n.reset[0]}${e}${n.reset[1]}`:String,bold:e?U(n.bold[0],n.bold[1],`${n.bold[1]}${n.bold[0]}`):String,dim:e?U(n.dim[0],n.dim[1],`${n.dim[1]}${n.dim[0]}`):String}))()),$=(t={})=>{const{uploadDir:n=".",encoding:r="",json:o=!0}=t;return(t,s)=>{const{req:i,res:c}=t,{url:d,method:l}=i,[u="",f=""]=d?.split("?")||[],h=f?new URLSearchParams(f):{};t.request||(t.request={}),t.request.method=l,t.request.path=u,t.request.url=d,t.request.query=h;const p=i.headers["content-type"];if("application/json"===p){r?i.setEncoding(r):i.setEncoding("utf-8");let e="";i.on("data",t=>{e+=t}),i.on("end",()=>{c.setHeader("content-type","application/json;charset=UTF-8");try{t.request.body=o?JSON.parse(e):e}catch{t.request.body=e}s()})}if(p?.includes("multipart/form-data;")){const[t,o]=i.headers["content-type"]?.split(";").map(e=>e.trim())||[],[d,l]=o.split("=");r?i.setEncoding(r):i.setEncoding("binary");let u="";i.on("data",e=>{u+=e}),i.on("end",()=>{const t={};u.split("\r\n").slice(0,4).forEach(n=>{Object.assign(t,e(n,";",/=|:/))});const r=t["Content-Type"],o=Buffer.from(t.filename,"latin1").toString("utf8"),i=u.indexOf(r)+r.length,d=u.substring(i).replace(/^\s+/,""),f=d.substring(0,d.indexOf(`--${l}--`));a.writeFile(`${n}/${o}`,f,{encoding:"binary"},e=>{if(e)throw e;c.setHeader("content-type","application/json;charset=UTF-8"),s()})})}}},I=(e,t)=>new Promise((n,r)=>{const o=g.spawn(e,t,{stdio:"inherit",shell:!1});o.on("error",e=>r(e)),o.on("exit",e=>0===e?n():r(/* @__PURE__ */new Error(`Command exited with code ${e}`)))}),A=({message:e,stream:t=process.stderr,defaultResponse:n="Y"})=>{const r=y.createInterface({input:process.stdin,output:t});return new Promise(t=>{r.question(`${e} `,e=>{r.close();const o=(e||n).toLowerCase();t("y"===o||"yes"===o)})})},B=()=>{};function D(e,t,n){return t(e.req,e.res,B),n()}function L(e,t,n){return new Promise((r,o)=>{t(e.req,e.res,e=>{e?o(e):r(n())})})}function R(e){const t=e.length<3?D:L;return function(n,r){return t(n,e,r)}}var N=e=>new Promise((t,n)=>{H.stat(e,(e,r)=>{e?n({success:!1,_identification:!1,data:e}):t({success:!0,_identification:!0,data:r})})}),K=({url:e})=>new Promise((t,n)=>{b.get(e,e=>{const n=[];e.on("data",e=>{n.push(e)}),e.on("end",()=>{const{data:e=[]}=JSON.parse(Buffer.concat(n).toString());e.forEach(e=>{}),t({success:!0,data:e,message:"request success"})})}).on("error",e=>{e.message,n({success:!1,data:e,message:e.message})})}),z=()=>{const e=i.networkInterfaces();for(const t in e){const n=e[t];for(let e=0;e<n.length;e++){const t=n[e];if("IPv4"===t.family&&"127.0.0.1"!==t.address&&!t.internal)return t.address}}};function J(e){const t=e.url;if(void 0===t)return;let n=e._parsedUrl;if(n&&n._raw===t)return n;n={},n.query=n.search=void 0,n.href=n.path=n.pathname=t;const r=t.indexOf("?",1);return-1!==r&&(n.search=t.substring(r),n.query=n.search.substring(1),n.pathname=t.substring(0,r)),n._raw=t,e._parsedUrl=n}var W=e=>{const{dirPath:t}=e;try{return H.readdirSync(t)}catch(n){throw n}},G=class{ctx;map;methods;paths;constructor(){this.map=/* @__PURE__ */new Map,this.methods=/* @__PURE__ */new Set,this.paths=/* @__PURE__ */new Set}get(e,t){this.addHandlerToMap("GET")(e,t)}post(e,t){this.addHandlerToMap("POST")(e,t)}put(e,t){this.addHandlerToMap("PUT")(e,t)}patch(e,t){this.addHandlerToMap("PATCH")(e,t)}del(e,t){this.addHandlerToMap("DELETE")(e,t)}head(e,t){this.addHandlerToMap("HEAD")(e,t)}options(e,t){this.addHandlerToMap("OPTIONS")(e,t)}addHandlerToMap(e){return this.methods.add(e),(t,n)=>{this.paths.add(t);let r=this.map.get(e);r||(r=/* @__PURE__ */new Map,this.map.set(e,r)),r.set(t,n)}}routes(){return(e,t)=>{this.ctx=e;const{path:n,method:r}=e.request,o=this.map.get(r),s=o?o.get(n):t;s&&s(e,t)}}allowedMethods(){return e=>{const{res:t}=e,{path:n,method:r}=e.request;!this.methods.has(r)&&this.paths.has(n)&&(t.statusCode=405,t.end("405, method is not allowed")),this.methods.has(r)&&!this.paths.has(n)&&(t.statusCode=404,t.end("404, the request address does not exist")),this.methods.has(r)||this.paths.has(n)||(t.statusCode=501,t.end("501, not support the functionality needed to satisfy the request"))}}},Y=(e={})=>{const{pathname:n,fileTypes:o={}}=e;return async(e,s)=>{try{const{req:i,res:c}=e;if(i.url){const e="text/html",s=n||process.cwd(),d=E.normalize(E.resolve(s)),l=E.extname(i.url).slice(1);Object.keys(o).forEach(e=>t(e,o[e]));const u=l?r(l):e;if(!Boolean(u))return c.writeHead(404,{"Content-Type":"text/html"}),void c.end("404: File not found");let f=i.url;if("/"===i.url)f="index.html";else if(!l)try{a.accessSync(E.join(d,i.url+".html"),a.constants.F_OK),f=i.url+".html"}catch{f=E.join(i.url,"index.html")}const h=E.join(d,f);if(!E.normalize(E.resolve(h)).startsWith(d))return c.writeHead(404,{"Content-Type":"text/html"}),void c.end("404: File not found");a.readFile(h,(e,t)=>{e?(c.writeHead(404,{"Content-Type":"text/html"}),c.end("404: File not found")):(c.writeHead(200,{"Content-Type":u}),c.end(t))})}await s()}catch{}}},Q=()=>{if("undefined"!=typeof window){const e=window.performance.now();return Symbol.for(`${e}`)}if("undefined"!=typeof process){const e=w.bigint();return Symbol.for(`${e}`)}return Symbol.for(`${Date.now()}`)},V=e=>{const{path:t}=e;if(t)return c(t);throw new Error("path is not defined")},X=e=>{const{path:t}=e;if(t)return d(t);throw new Error("path is not defined")},Z=e=>{const t=Symbol.keyFor(e);return"undefined"!=typeof window&&t?window.performance.now()-Number(t):"undefined"!=typeof process&&t?w.bigint()-BigInt(t):Date.now()-Number(t)},ee=S(f),te=S(l);async function ne(e,t,n=""){e=x(".",e);const r=await te(e);await Promise.all(r.map(async r=>{const o=v(e,r),s=await ee(o);return s.isDirectory()?ne(o,t,v(n,r)):t(v(n,r),o,s)}))}function re(e,t,n=""){e=x(".",e);const r=u(e);let o,s,i=0;for(;i<r.length;i++)o=v(e,r[i]),s=h(o),s.isDirectory()?re(o,t,v(n,r[i])):t(v(n,r[i]),o,s)}var oe=(e,t=20)=>new Promise(n=>{H.watchFile(e,{interval:t},(t,r)=>{t.mtime!==r.mtime?(H.unwatchFile(e),n({success:!0,_identification:!0,data:{},message:"file is changed"})):n({success:!1,_identification:!1,data:{},message:"file is not changed"})})});function se(e,t){const n=T.byteLength(e);let r=null;if(n>65535?(r=T.alloc(10+n),r[1]=127,r.writeUInt32BE(n,6),r.write(e,10)):n>125?(r=T.alloc(4+n),r[1]=126,r.writeUInt16BE(n,2),r.write(e,4)):(r=T.alloc(2+n),r[1]=n,r.write(e,2)),t){const e=t.opcode;e&&e<15&&e>=0&&(r[0]=128|e)}else r[0]=129;return r}function ie(e,t){if(!t)return e;const n=T.from(e);for(let r=0;r<n.length;++r)n[r]=n[r]^t[r%4];return n}function ae(){const e={};this.on=(t,n)=>{e[t]?e[t].push(n):e[t]=[n]},this.off=(t,n)=>{const r=e[t],o=r.indexOf(n);r&&-1!==o&&r.splice(o,1)},this.emit=(t,n)=>{e[t]&&e[t].forEach(e=>e(n))}}function ce(e){ae.call(this);const t=[];this.server=e,this.clients=t,this.broadcast=e=>{t.forEach(t=>{t.send(e)})},e.on("upgrade",(e,n)=>{n.write(["HTTP/1.1 101 Switching Protocols","Upgrade: websocket","Connection: Upgrade","Sec-WebSocket-Accept: "+P.createHash("sha1").update(e.headers["sec-websocket-key"]+"258EAFA5-E914-47DA-95CA-C5AB0DC85B11").digest("base64")].join("\n")+"\n\n");const r={send(e,t){n.write(se(e,t))},ping(){n.write(se("",{opcode:9}))},pong(){n.write(se("",{opcode:10}))},close(){if(-1===t.indexOf(r))return!1;t.splice(t.indexOf(r),1),n.write(se("",{opcode:8})),r.emit("close"),n.destroy()},socket:n};ae.call(r),this.emit("connect",r),t.push(r);let o=T.allocUnsafe(0),s=T.allocUnsafe(0);const i=[];let a=!0;function c(){const e=function(e){const t=T.from(e),n=127&t[1];let r=0,o=0;const s=t[1]>=128;return 127===n?(r=t.readUInt32BE(6),o=10):126===n?(r=t.readUInt16BE(2),o=4):(r=n,o=2),{fin:t[0]>=128,opcode:15&t[0],mask:s,maskKey:s?t.subarray(o,o+(s?4:0)):null,len7:n,len:r,lenMeta:o+(s?4:0)}}(o);i.push({l:e.lenMeta,f:()=>{a=!1,i.push({l:e.len,f:t=>{if(s=T.concat([s,ie(t,e.maskKey)]),a=!0,e.fin){if(8===e.opcode)return r.close();if(9===e.opcode)return r.pong();r.emit("message",s),s=T.allocUnsafe(0)}}})}})}n.on("data",e=>{for(o=T.concat([o,e]),a&&c();i[0]&&o.byteLength>=i[0].l;){const e=i[0].l;i[0].f(o.subarray(0,e)),o=o.subarray(e),i.splice(0,1)}}),n.on("end",()=>{r.close()}),n.on("error",e=>{r.emit("error",e),r.close()})})}var de=(e,t)=>new Promise((n,r)=>{H.writeFile(e,t,{mode:438,flag:"w+",encoding:"utf-8"},o=>{if(o)throw r({success:!1,_identification:!1,data:o}),o;n({success:!0,_identification:!1,data:{path:e,content:t}})})});export{G as Router,q as Server,ce as WSS,_ as appendFile,$ as body,k as colors,R as connect,K as get,z as getIPAdress,F as isColorSupported,J as paresUrl,A as prompt,N as queryFileInfo,W as readDir,M as readFile,V as readStream,I as runCommand,Q as startTask,Y as staticMiddleware,Z as taskEnd,ne as traverse,re as traverseSync,oe as watchFile,de as writeFile,X as writeStream};

package/dist/src/node/isColorSupported.d.ts

@@ -0,0 +1,2 @@
+declare const isColorSupported: boolean;
+export default isColorSupported;

package/dist/src/node/paresUrl.d.ts

@@ -0,0 +1,19 @@
+import type { IncomingMessage } from 'node:http';
+interface ParseUrl {
+    search?: string;
+    query?: string;
+    pathname?: string;
+    path?: string;
+    href?: string;
+    _raw?: string;
+}
+interface Req extends IncomingMessage {
+    _parsedUrl?: ParseUrl;
+}
+/**
+ * @description: 解析 IncomingMessage 类型的请求url，返回的类型永远是 ParseUrl
+ * @param {Req} req
+ * @return {ParseUrl}
+ */
+export default function (req: Req): ParseUrl | undefined;
+export {};

package/dist/src/node/readDir.d.ts

@@ -0,0 +1,6 @@
+interface Options {
+    dirPath: string;
+    ignores?: Array<string>;
+}
+declare const readDir: (options: Options) => Array<string>;
+export default readDir;

package/dist/src/node/readFile.d.ts

@@ -0,0 +1,9 @@
+import type { FilePromiseResult } from '@/node/fs';
+/**
+ * @description: 读取一个文件，读取成功返回状态码和文件内容
+ * @param {string} path 文件路径
+ * @param {string} format 读取格式，默认utf-8
+ * @return {Promise}
+ */
+declare const readFile: (path: string, format?: BufferEncoding) => FilePromiseResult;
+export default readFile;

package/dist/src/node/router.d.ts

@@ -0,0 +1,42 @@
+import type { Context, MiddlewareFunction, Next } from '@/node/server';
+/**
+ * @description:
+ *
+ * Basic usage:
+ *
+ * ```javascript
+ * import Server from '@/server/server'
+ * import Router from '@/server/router'
+ *
+ * const app = new Server();
+ * const router = new Router();
+ *
+ * router.get('/', (ctx, next) => {
+ *   // ctx.router available
+ * });
+ *
+ * app
+ *   .use(router.routes())
+ *   .use(router.allowedMethods());
+ * ```
+ * @return {*}
+ */
+type Handler = (ctx: Context, next: Next) => void;
+declare class Router {
+    ctx?: Context;
+    map: Map<string, Map<string, Handler>>;
+    methods: Set<string>;
+    paths: Set<string>;
+    constructor();
+    get(url: string, handler: Handler): void;
+    post(url: string, handler: Handler): void;
+    put(url: string, handler: Handler): void;
+    patch(url: string, handler: Handler): void;
+    del(url: string, handler: Handler): void;
+    head(url: string, handler: Handler): void;
+    options(url: string, handler: Handler): void;
+    private addHandlerToMap;
+    routes(): MiddlewareFunction;
+    allowedMethods(): MiddlewareFunction;
+}
+export default Router;

package/dist/src/node/send.d.ts

@@ -0,0 +1,7 @@
+import type { MiddlewareFunction } from '@/node/server';
+interface Option {
+    pathname: string;
+    fileTypes: Record<string, string>;
+}
+declare const staticMiddleware: (option?: Partial<Option>) => MiddlewareFunction;
+export default staticMiddleware;

package/dist/src/node/server.d.ts

@@ -0,0 +1,18 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import http from 'node:http';
+export type Next = () => Promise<never> | Promise<void>;
+export type MiddlewareFunction = (ctx: Context, next: Next) => void | Promise<void>;
+export interface Context {
+    [x: string]: any;
+    ipv4: () => string | undefined;
+    req: IncomingMessage;
+    res: ServerResponse;
+}
+declare class Server {
+    middleware: Array<MiddlewareFunction>;
+    ctx: Context;
+    constructor();
+    use(handle: MiddlewareFunction): void;
+    listen(...args: any): http.Server;
+}
+export default Server;

package/dist/src/node/startTask.d.ts

@@ -0,0 +1,2 @@
+declare const startTask: () => symbol;
+export default startTask;

package/dist/src/node/stream.d.ts

@@ -0,0 +1,15 @@
+import type { ReadStream, WriteStream } from 'node:fs';
+interface ReadOption {
+    path: string;
+    encoding: string;
+    start: number;
+    end: number;
+    highWaterMark: number;
+}
+interface WriteOption {
+    path: string;
+    encoding: string;
+}
+export declare const readStream: (option: ReadOption) => ReadStream;
+export declare const writeStream: (option: WriteOption) => WriteStream;
+export {};

package/dist/src/node/taskEnd.d.ts

@@ -0,0 +1,2 @@
+declare const taskEnd: (symbol: symbol) => number | bigint;
+export default taskEnd;

package/dist/src/node/traverse.d.ts

@@ -0,0 +1,17 @@
+import type { Stats } from 'node:fs';
+type Caller = (relPath: string, absPath: string, stats: Stats) => any;
+/**
+ * @description: 递归遍历每一个目录，为找到的文件都执行一个函数
+ * @param {string} dir
+ * @param {Caller} callback
+ * @param {*} pre
+ */
+export declare function traverse(dir: string, callback: Caller, pre?: string): Promise<any>;
+/**
+ * @description: 同步方法，递归遍历每一个目录，为找到的文件都执行一个函数
+ * @param {string} dir
+ * @param {Caller} callback
+ * @param {*} pre
+ */
+export declare function traverseSync(dir: string, callback: Caller, pre?: string): void;
+export {};

package/dist/src/node/watchFile.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @description: 观察一个文件是否被改变，返回状态
+ * @param {string} path 监听的文件路径
+ * @param {number} interval 监听的时间，单位毫秒，默认 20 毫秒
+ * @return {Promise}
+ */
+declare const watchFile: (path: string, interval?: number) => Promise<Ranuts.Identification>;
+export default watchFile;

package/dist/src/node/writeFile.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @description: 根据文件路径创建文件，如果文件存在会清空再写入，如果不存在会创建
+ * @param {string} path 文件路径
+ * @param {string} content 文件内容
+ * @return {Promise}
+ */
+declare const writeFile: (path: string, content: string) => Promise<Ranuts.Identification>;
+export default writeFile;

package/dist/src/node/ws.d.ts

@@ -0,0 +1,8 @@
+import type http from 'node:http';
+/**
+ * Create a WebSocket Server
+ * @constructor
+ * @param { http.Server } server server from http(s).createServer()
+ */
+declare function WSS(this: any, server: http.Server): void;
+export default WSS;

package/dist/src/utils/audioRecorder.d.ts

@@ -0,0 +1,16 @@
+export declare const webmFixDuration: (blob: Blob, duration: number, type?: string) => Promise<Blob>;
+/**
+ * @description: 录音
+ * @return {*}
+ */
+export declare class AudioRecorder {
+    startTime: number;
+    chunks: Blob[];
+    mediaRecorder?: MediaRecorder;
+    blob?: Blob;
+    constructor();
+    private init;
+    start(): MediaRecorder | undefined;
+    pause(): MediaRecorder | undefined;
+    stop(): Blob | undefined;
+}

package/dist/src/utils/behavior.d.ts

@@ -0,0 +1,15 @@
+export declare const handleClick: (hooks?: (event: MouseEvent) => void) => void;
+/**
+ * @description: 获取地区经纬度（会弹出提示让用户授权）
+ * @return {*}
+ */
+export declare const getRegionalLatitudeAndLongitude: () => Promise<GeolocationPosition>;
+export declare const webglVendor: () => {
+    vendor: string;
+    renderer: string;
+} | null;
+export declare const canvasVendor: () => string | null;
+/**
+ * @description: 音频指纹，1.生成音频信息流 (三角波)，对其进行 FFT 变换，计算 SHA 值作为指纹。2.生成音频信息流（正弦波），进行动态压缩处理，计算 MD5 值。
+ */
+export declare const audioVendor: () => Promise<string>;

package/dist/src/utils/bom.d.ts

@@ -0,0 +1,294 @@
+/**
+ * @description: 覆盖浏览器的后退事件
+ * @param {*} callback
+ * @return {*}
+ */
+export declare const retain: (callback?: () => void) => void;
+/**
+ * @description: 获取指定的 cookie
+ * @param {string} objName
+ * @return {*}
+ */
+export declare const getCookie: (objName: string) => string;
+export interface RequestUrlToArraybufferOption {
+    responseType: XMLHttpRequestResponseType;
+    method: string;
+    withCredentials: boolean;
+    headers: Record<string, string>;
+    body: string;
+    onProgress?: Function;
+}
+export interface requestUrlToArraybufferReturn extends BaseReturn {
+    data: Blob;
+}
+export interface BaseReturn {
+    success: boolean;
+    message?: string;
+}
+/**
+ * @description: url 转 arrayBuffer
+ * @param {string} src
+ * @param {RequestUrlToArraybufferOption} options
+ * @return {*}
+ */
+export declare const requestUrlToBuffer: (src: string, options: Partial<RequestUrlToArraybufferOption>) => Promise<requestUrlToArraybufferReturn>;
+export interface Context {
+    backingStorePixelRatio: number;
+    webkitBackingStorePixelRatio: number;
+    mozBackingStorePixelRatio: number;
+    msBackingStorePixelRatio: number;
+    oBackingStorePixelRatio: number;
+}
+/**
+ * @description: 获取分辨率
+ * @param {CanvasRenderingContext2D} context
+ * @return {*}
+ */
+export declare const getPixelRatio: (context: CanvasRenderingContext2D & Partial<Context>) => number;
+export declare const createObjectURL: (src: Blob | ArrayBuffer | Response) => Promise<string>;
+/**
+ * @description: 计算每毫秒的帧率，每秒的帧率需要乘 1000
+ * @return {*}
+ */
+export declare const getFrame: (n?: number) => Promise<number>;
+/**
+ * @description: Gets the current environment configuration
+ * @return {string}
+ */
+export declare const getHost: (env?: string) => string | undefined;
+/**
+ * @description: 将 url 上的字符串转换成对象
+ * @param {string} url
+ * @param {*} string
+ * @return {*}
+ */
+export declare const getAllQueryString: (url?: string) => Record<string, string>;
+/**
+ * @description: 将 url 上的字符串转换成对象
+ * @param {string} url
+ * @param {*} string
+ * @return {*}
+ */
+export declare const getQuery: (url?: string) => Record<string, string>;
+/**
+ * @description: 将一个对象转换成 querystring，拼接到 url 后面
+ * @return {*}
+ */
+export declare function appendUrl(url: string, params?: Record<string, string>): string;
+/**
+ * @description: 移除拖拽事件的阴影
+ * @param {DragEvent} event
+ * @return {*}
+ */
+export declare const removeGhosting: (event: DragEvent) => void;
+export declare function getCookieByName(name: string): string;
+interface ClientRatio {
+    width: number;
+    height: number;
+}
+/**
+ * 跨浏览器获取可视窗口大小
+ */
+export declare const getWindow: () => ClientRatio;
+/**
+ * @description: 返回当前网络状态，当前吞吐量，是否切换网络
+ */
+export declare const connection: () => number | undefined;
+/**
+ * Encode a URL to a percent-encoded form, excluding already-encoded sequences.
+ *
+ * This function will take an already-encoded URL and encode all the non-URL
+ * code points. This function will not encode the "%" character unless it is
+ * not part of a valid sequence (`%20` will be left as-is, but `%foo` will
+ * be encoded as `%25foo`).
+ *
+ * This encode is meant to be "safe" and does not throw errors. It will try as
+ * hard as it can to properly encode the given URL, including replacing any raw,
+ * unpaired surrogate pairs with the Unicode replacement character prior to
+ * encoding.
+ *
+ * @param {string} url
+ * @return {string}
+ * @public
+ */
+export declare function encodeUrl(url: string): string;
+interface Options {
+    url?: string;
+    duration?: number;
+    count?: number;
+}
+interface ReturnType {
+    ping: number;
+    jitter: number;
+}
+/**
+ * @description: 图片请求
+ * @param {string} url
+ * @return {Promise<ImageLoadError | number>}
+ */
+export declare const imageRequest: (url?: string) => Promise<number>;
+/**
+ * @description: 间隔一定时间，执行指定的函数
+ * @param {HandlerFunction} handler
+ * @param {array} params
+ */
+export declare const durationHandler: <T, U>(handler: (...args: T[]) => U, ...params: T[]) => ((a: number) => Promise<U>);
+/**
+ * @description: 通过请求来测试当前网络的 ping 值
+ * @param {*} options
+ */
+export declare const networkSpeed: (options: Options) => Promise<ReturnType>;
+export declare const isSafari: () => boolean | undefined | string;
+export interface MessageHandler<T = unknown, R = unknown> {
+    (payload: T): Promise<R> | R;
+}
+export interface MessageData<T = unknown> {
+    type: string;
+    payload: T;
+    id?: string;
+    isResponse?: boolean;
+    isError?: boolean;
+    /** 通道标识：用于隔离同一窗口上的多个 bridge（默认 DEFAULT_CHANNEL） */
+    channel?: string;
+    /** 发送方实例 id：用于避免 bridge 处理自己发出的请求（自答自问） */
+    senderId?: string;
+}
+export interface PendingRequest<R = unknown> {
+    resolve: (value: R) => void;
+    reject: (error: unknown) => void;
+}
+export declare const BRIDGE_MARKER = "__ranuts_bridge__";
+export declare const DEFAULT_CHANNEL = "default";
+/**
+ * Bridge 注册事件，供 client 消费
+ */
+export declare class PostMessageBridge {
+    private targetWindow;
+    private targetOrigin;
+    private messageHandlers;
+    private pendingRequests;
+    private channel;
+    private senderId;
+    private available;
+    constructor(targetWindow?: Window, targetOrigin?: string, channel?: string);
+    private post;
+    receive: (event: MessageEvent) => void;
+    on: <T = unknown, R = unknown>(type: string, handler: MessageHandler<T, R>) => void;
+    off: (type: string) => void;
+    send: <T = unknown, R = unknown>(type: string, payload: T) => Promise<R>;
+    broadcast: <T = unknown>(data: {
+        type: string;
+        payload: T;
+    }) => void;
+    destroy: () => void;
+}
+export interface BridgeManagerOptions {
+    id?: string;
+    targetOrigin?: string;
+    targetWindow?: Window;
+    /** 通道标识：需要隔离同一窗口上的多个连接时显式指定，两端须一致 */
+    channel?: string;
+}
+export declare class BridgeManager {
+    private static instance;
+    private bridges;
+    private constructor();
+    static getInstance(): BridgeManager;
+    connectClient: ({ id, targetOrigin, targetWindow, channel, }: BridgeManagerOptions) => {
+        bridge: PostMessageBridge;
+        id: string;
+    };
+    getClient: (id: string) => PostMessageBridge | undefined;
+    removeClient: (id: string) => void;
+    removeAllClient: () => void;
+    broadcast: <T = unknown>(payload: {
+        type: string;
+        payload: T;
+    }) => void;
+    sendTo: <T = unknown, R = unknown>(id: string, type: string, payload: T) => Promise<R>;
+}
+export declare const bridgeManager: BridgeManager;
+export interface BroadcastPayload {
+    type: string;
+    payload: unknown;
+}
+export interface CallToPayload<T = unknown> {
+    id: string;
+    type: string;
+    payload: T;
+}
+export declare const Client: {
+    connect: ({ id, targetWindow, targetOrigin, channel, }: BridgeManagerOptions) => {
+        bridge: PostMessageBridge;
+        id: string;
+    };
+    remove: (id: string) => void;
+    removeAll: () => void;
+    /** 广播消息到所有 Platform */
+    broadcast: (payload: BroadcastPayload) => void;
+    /** 发送消息到指定 Platform */
+    call: <T = unknown, R = unknown>({ id, type, payload }: CallToPayload<T>) => Promise<R>;
+    /** 广播消息到所有所有可以接收消息的窗口 (为了安全考虑，不建议使用) */
+    broadcastToAll: (payload: BroadcastPayload) => void;
+};
+export declare const initPlatform: <T = unknown, R = unknown>(events: Record<string, MessageHandler<T, R>>) => {
+    destroy: () => void;
+};
+export declare const Platform: {
+    init: <T = unknown, R = unknown>(events: Record<string, MessageHandler<T, R>>) => {
+        destroy: () => void;
+    };
+};
+/**
+ * 基于 MessagePort 的点对点桥接（方案 B，作为新 API 提供）。
+ *
+ * 与 PostMessageBridge 的「全局广播 + 过滤」不同，MessagePort 是浏览器提供的
+ * 私有点对点信道：只有握手时拿到 port 的双方能通信。因此天然规避了
+ * 跨窗口串消息、来源伪造、同窗口多桥串台、自答自问等问题，也无需 origin 过滤、
+ * 无需协议标记、无需 base64——payload 直接走结构化克隆。
+ *
+ * 典型用法：
+ *   // A 窗口（发起方）
+ *   const bridge = openPortBridge({ targetWindow: iframe.contentWindow, targetOrigin });
+ *   const res = await bridge.send('ping', { n: 1 });
+ *
+ *   // B 窗口（接收方）
+ *   const bridge = await acceptPortBridge({ targetOrigin });
+ *   bridge.on('ping', ({ n }) => n + 1);
+ *
+ * 也可用于已有 port 的场景（Web Worker / SharedWorker）：createPortBridge(port)。
+ */
+export interface PortBridge {
+    on: <T = unknown, R = unknown>(type: string, handler: MessageHandler<T, R>) => void;
+    off: (type: string) => void;
+    send: <T = unknown, R = unknown>(type: string, payload: T) => Promise<R>;
+    broadcast: <T = unknown>(data: {
+        type: string;
+        payload: T;
+    }) => void;
+    destroy: () => void;
+}
+export interface OpenPortBridgeOptions {
+    targetWindow: Window;
+    targetOrigin?: string;
+    /** 连接名：一个页面里区分多个独立 port 连接，两端须一致（默认 'default'） */
+    name?: string;
+}
+export interface AcceptPortBridgeOptions {
+    targetOrigin?: string;
+    name?: string;
+}
+/**
+ * 在任意 MessagePort 上构建 bridge（Web Worker / SharedWorker 或已握手的 port）。
+ */
+export declare const createPortBridge: (port: MessagePort) => PortBridge;
+/**
+ * 发起方：创建 MessageChannel，把一端交给目标窗口，自己持有另一端。
+ */
+export declare const openPortBridge: ({ targetWindow, targetOrigin, name, }: OpenPortBridgeOptions) => PortBridge;
+/**
+ * 接收方：等待发起方递来的 port，握手完成后返回 bridge。
+ * 返回的 Promise 在收到匹配 name 的握手消息后 resolve。
+ */
+export declare const acceptPortBridge: ({ targetOrigin, name, }?: AcceptPortBridgeOptions) => Promise<PortBridge>;
+export {};