@love-sqjm/magic 2026.4.15

package/script/util/bun-fs.js

@@ -0,0 +1,40 @@
+import { readFileSync, writeFileSync, mkdirSync, rmSync, cpSync, existsSync } from "bun:fs";
+
+export const bunFS = {
+    readFileSync( path ) {
+        return readFileSync( path ).toString();
+    },
+
+    writeFileSync( path, data ) {
+        writeFileSync( path, data );
+    },
+
+    existsSync( path ) {
+        return existsSync( path );
+    },
+
+    mkdirSync( path, options = {} ) {
+        mkdirSync( path, options );
+    },
+
+    rmSync( path, options = {} ) {
+        rmSync( path, options );
+    },
+
+    cpSync( src, dest, options = {} ) {
+        cpSync( src, dest, options );
+    },
+
+    appendFileSync( path, data ) {
+        if ( existsSync( path ) ) {
+            const existing = readFileSync( path );
+            writeFileSync( path, existing + data );
+        } else {
+            writeFileSync( path, data );
+        }
+    }
+};
+
+export function computeHash( content ) {
+    return Bun.hash( content ).toString( 16 );
+}

package/script/util/copy-dir.js

@@ -0,0 +1,21 @@
+import fs from "node:fs";
+import path from "node:path";
+
+export function copyDir( src, dest ) {
+    if ( !fs.existsSync( dest ) ) {
+        fs.mkdirSync( dest, { recursive : true } );
+    }
+
+    const files = fs.readdirSync( src, { withFileTypes : true } );
+
+    files.forEach( file => {
+        const srcPath = path.join( src, file.name );
+        const destPath = path.join( dest, file.name );
+
+        if ( file.isDirectory() ) {
+            copyDir( srcPath, destPath );
+        } else {
+            fs.copyFileSync( srcPath, destPath );
+        }
+    } );
+}

package/script/util/create-simple-dom-element.js

@@ -0,0 +1,23 @@
+import { getFirstObjectKey } from "./get-first-object-key.js";
+
+/**
+ * 创建一个简单的 Dom 元素
+ * @param obj {object}
+ * @param obj.attrs {Array<{ [key: string]: string }>}
+ * @param obj.one {boolean}
+ * @param obj.tag {string}
+ * @param obj.content {string}
+ * @returns {string}
+ */
+export function createSimpleDomElement( obj ) {
+    let attrs = "";
+    obj.attrs.forEach( ( attr ) => {
+        const name = getFirstObjectKey( attr );
+        attrs += `${ name }="${ attr[ name ] }"`;
+    } );
+
+    if ( obj.one ) {
+        return `<${ obj.tag } ${ attrs }/>`
+    }
+    return `<${ obj.tag } ${ attrs }>${ obj.content || "" }</${ obj.tag }>`
+}

package/script/util/file-util.js

@@ -0,0 +1,95 @@
+import fs from "node:fs";
+import path from "node:path";
+import * as readline from "node:readline";
+
+/**
+ * 创建文件及其所有必需的目录路径
+ * 如果文件已存在，则不会覆盖
+ * @param {string} filePath - 要创建的文件的路径
+ * @param {string} data - 要写入文件的数据
+ */
+function createFileWithDirectories( filePath, data ) {
+    const directoryPath = path.dirname( filePath );
+
+    function createDirectories( dirPath ) {
+        if ( !fs.existsSync( dirPath ) ) {
+            createDirectories( path.dirname( dirPath ) );
+            fs.mkdirSync( dirPath );
+        }
+    }
+
+    createDirectories( directoryPath );
+
+    if ( !fs.existsSync( filePath ) ) fs.writeFileSync( filePath, data );
+}
+
+/**
+ * 复制文件及其所有必需的目录路径
+ * 如果目标文件已存在，则会被覆盖
+ * @param {string} srcPath - 源文件的路径
+ * @param {string} targetPath - 目标文件的路径
+ */
+function copyFileWithDirectories( srcPath, targetPath ) {
+    const directoryPath = path.dirname( targetPath );
+
+    function createDirectories( dirPath ) {
+        if ( !fs.existsSync( dirPath ) ) {
+            createDirectories( path.dirname( dirPath ) );
+            fs.mkdirSync( dirPath );
+        }
+    }
+
+    createDirectories( directoryPath );
+
+    fs.copyFileSync( srcPath, targetPath );
+}
+
+/**
+ * 读取文件的第一行内容
+ * @param {string} filePath
+ * @returns {Promise<string>}
+ */
+function readFileLine( filePath ) {
+    const fileStream = fs.createReadStream( filePath );
+
+    const reader = readline.createInterface( {
+        input : fileStream,
+        crlfDelay : Infinity
+    } );
+
+    return new Promise( ( resolve, reject ) => {
+        reader.on( 'line', ( line ) => {
+            resolve( line );
+            reader.close();
+        } );
+
+        reader.on( 'error', ( error ) => {
+            reject( error );
+        } );
+
+        reader.on( 'close', () => {
+            fileStream.destroy();
+        } );
+    } );
+}
+
+/**
+ * 获取文件的完整扩展名
+ * @param {string} filePath - 文件的路径
+ * @returns {string} - 文件的扩展名
+ */
+function getExtensionName( filePath ) {
+    const name = path.basename( filePath );
+    const lastDotIndex = name.lastIndexOf( '.' );
+    if ( lastDotIndex === -1 || lastDotIndex === name.length - 1 ) {
+        return name;
+    }
+    return name.substring( lastDotIndex + 1 );
+}
+
+export const fileUtil = {
+    createFileWithDirectories,
+    copyFileWithDirectories,
+    readFileLine,
+    getExtensionName
+};

package/script/util/filtration-file.js

@@ -0,0 +1,20 @@
+import FastGlob from 'fast-glob';
+
+/**
+ * 按照配置过滤文件
+ * @param rootDir {string}
+ * @param exclude {object}
+ * @param exclude.dir {string[]}
+ * @param exclude.file {string[]}
+ * @returns {string[]}
+ */
+export function filtrationFile( rootDir, exclude ) {
+    return FastGlob.sync( [ '**/*' ], {
+        cwd : rootDir,
+        onlyFiles : true,
+        ignore : [
+            ...exclude.dir,
+            ...exclude.file
+        ]
+    } );
+}

package/script/util/get-dir-all-file.js

@@ -0,0 +1,28 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * 获取一个文件夹下的所有文件路径
+ * @param dir {string}
+ * @returns {string[]}
+ */
+export function getDirAllFile( dir ) {
+    const arr = [];
+
+    function it( currentPath ) {
+        try {
+            fs.readdirSync( currentPath ).forEach( file => {
+                const filePath = path.join( currentPath, file );
+                if ( fs.statSync( filePath ).isDirectory() )
+                    it( filePath );
+                else
+                    arr.push( filePath );
+            } );
+        } catch ( e ) {
+            throw `无法读取目录: ${ e }`;
+        }
+    }
+
+    it( dir );
+    return arr;
+}

package/script/util/get-first-object-key.js

@@ -0,0 +1,9 @@
+/**
+ * 获取一个对象的第一个键名字
+ * @param obj {object}
+ * @returns {string|undefined}
+ */
+export function getFirstObjectKey( obj ) {
+    const keys = Object.keys( obj );
+    return keys.length > 0 ? keys[ 0 ] : undefined;
+}

package/script/util/is-empty-object.js

@@ -0,0 +1,8 @@
+/**
+ * 判断一个对象的键长度是否为 0
+ * @param obj {object}
+ * @returns {boolean}
+ */
+export function isEmptyObject( obj ) {
+    return Object.keys( obj ).length === 0;
+}

package/script/util/is-string-over-size.js

@@ -0,0 +1,4 @@
+export const isStringOverSize = ( str, maxSize ) => {
+    const byteLength = new TextEncoder().encode( str ).length;
+    return byteLength > maxSize;
+}

package/script/util/is.js

@@ -0,0 +1,18 @@
+/**
+ * @param target {function}
+ * @param succeed {function}
+ * @param fail {function}
+ * @returns {boolean}
+ */
+export function is( target, succeed = () => true, fail = () => false ) {
+    if ( typeof target !== "function" ) {
+        throw "Error: target must be a function";
+    }
+    const {
+        bool,
+        result
+    } = target();
+    if ( bool )
+        return succeed( result );
+    return fail( result );
+}

package/script/util/logging.js

@@ -0,0 +1,142 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+export class Logging {
+    #IS_USE = false;
+
+    constructor( name, logPath, option ) {
+        this.oldCount = 1;
+        this.logPath = path.normalize( logPath );
+        this.oldData = null;
+        this.name = name;
+        this.option = Object.assign( {
+            maxSize : 2 * 1024
+        }, option );
+
+        try {
+            if ( fs.existsSync( this.logPath ) ) {
+                const stats = fs.statSync( this.logPath );
+                if ( stats.size > this.option.maxSize ) {
+                    fs.writeFileSync( this.logPath, this.fileHead( name ) );
+                }
+            } else {
+                fs.writeFileSync( this.logPath, this.fileHead( name ) );
+            }
+        } catch ( e ) {
+            console.error( "Error initializing log file:", e );
+        }
+    }
+
+    get isUse() {
+        return this.#IS_USE;
+    }
+
+    get outFile() {
+        return {
+            log : ( ...args ) => {
+                this.write( this.body( 'LOG', args ), args.join( ' ' ) );
+            },
+            error : ( ...args ) => {
+                this.write( this.body( 'ERROR', args ), args.join( ' ' ) );
+            },
+            warning : ( ...args ) => {
+                this.write( this.body( 'WARNING', args ), args.join( ' ' ) );
+            },
+            info : ( ...args ) => {
+                this.write( this.body( 'INFO', args ), args.join( ' ' ) );
+            }
+        }
+    }
+
+    get outConsole() {
+        return {
+            log : console.log,
+            error : console.error,
+            warning : console.warn,
+            info : console.info
+        }
+    }
+
+    fileHead( name ) {
+        return `Logging - 1.0.0 [${ name }]\n`;
+    }
+
+    getDate() {
+        const date = new Date();
+        return date.toISOString().replace( 'T', ' ' ).substring( 0, 19 );
+    }
+
+    head( level ) {
+        return `[${ this.getDate() }] [${ level.toUpperCase() }] > `;
+    }
+
+    body( level, data ) {
+        let str = "";
+
+        const toString = ( item ) => {
+            try {
+                if ( typeof item === 'string' ) str += `${ item } `;
+                else if ( typeof item === 'object' ) str += JSON.stringify( item ) + " ";
+                else str += `${ item } `;
+            } catch ( e ) {
+                str += `${ item } `;
+            }
+        };
+
+        data.forEach( toString );
+
+        if ( str.trim() === "" ) return false;
+        return this.head( level ) + str.trim();
+    }
+
+    write( data, _data ) {
+        if ( data === false ) return;
+        if ( this.oldData === _data ) {
+            this.oldCount++;
+            return;
+        }
+        if ( this.oldCount !== 1 ) {
+            fs.appendFileSync( this.logPath, `${ this.oldCount }...^\n` );
+        }
+        this.oldCount = 1;
+        this.oldData = _data;
+        fs.appendFileSync( this.logPath, data + '\n' );
+        this.#IS_USE = true;
+    }
+
+    log( ...args ) {
+        console.log( ...args );
+        this.write( this.body( 'LOG', args ), args.join( ' ' ) );
+    }
+
+    error( ...args ) {
+        console.error( ...args );
+        this.write( this.body( 'ERROR', args ), args.join( ' ' ) );
+    }
+
+    warning( ...args ) {
+        console.warn( ...args );
+        this.write( this.body( 'WARNING', args ), args.join( ' ' ) );
+    }
+
+    info( ...args ) {
+        console.info( ...args );
+        this.write( this.body( 'INFO', args ), args.join( ' ' ) );
+    }
+
+    remove() {
+        try {
+            fs.unlinkSync( this.logPath );
+        } catch ( e ) {
+            console.error( "Error removing log file:", e );
+        }
+    }
+
+    clear() {
+        try {
+            fs.writeFileSync( this.logPath, this.fileHead( this.name ) );
+        } catch ( e ) {
+            console.error( "Error clearing log file:", e );
+        }
+    }
+}

package/script/util/task.js

@@ -0,0 +1,16 @@
+import { printf } from "../global/printf.js";
+
+/**
+ * 运行一个任务
+ * @param func {function}
+ * @param name {string|boolean}
+ */
+export function task( func, name = false ) {
+    try {
+        ( typeof func === "function" ) && func();
+    } catch ( e ) {
+        printf.error( e );
+        console.info( `任务 ${ name } 出错啦 ~~o(>_<)o ~~` );
+        throw "";
+    }
+}

package/script/util/traversal.js

@@ -0,0 +1,28 @@
+import { isEmptyObject } from "./is-empty-object.js";
+
+/**
+ * @param obj {object}
+ * @param callback {function}
+ * @param emCallback {function}
+ * @returns {{value: *, index: number, key: string}|undefined}
+ */
+function object( obj, callback = () => {}, emCallback = () => {} ) {
+    if ( isEmptyObject( obj ) ) {
+        return emCallback();
+    }
+    let i = 0;
+    for ( const objKey in obj ) {
+        const r = callback( obj[ objKey ], i++, objKey );
+        if ( r === "return" ) return {
+            value : obj[ objKey ],
+            index : i,
+            key : objKey
+        };
+        else if ( r === "break" ) break;
+        else if ( r === "continue" ) continue;
+    }
+}
+
+export const traversal = {
+    object
+};

package/template/platform-config/node-webkit

@@ -0,0 +1,23 @@
+app = "nw.exe"
+name = "$name"
+version = "1.0.0"
+description = ""
+author = ""
+license = ""
+domain = "$name"
+chromium-args = "--enable-gpu-rasterization --enable-zero-copy"
+js-flags = "--harmony_collections --jit"
+"node.js" = true
+
+[build.platform.config.webkit]
+plugin = true
+
+[build.platform.config.window]
+icon = "icon.png"
+width = 1000
+height = 700
+min_width = 1000
+min_height = 700
+frame = true
+transparent = false
+position = "center"

package/template/platform-config/web

@@ -0,0 +1 @@
+server = { port = 8088, host = "127.0.0.1" }

package/template/project-base/app.xml

@@ -0,0 +1,5 @@
+<app lang="zh">
+    <title>$name</title>
+    <import>
+    </import>
+</app>

package/template/project-base/build.module.toml

@@ -0,0 +1,37 @@
+# 配置
+[config]
+# 项目名字
+name = "$name"
+# 源码目录
+src = "app"
+version = "1.0.0"
+description = ""
+author = ""
+license = ""
+
+# 构建配置
+[build]
+# 构建目录名
+out = "$name-module"
+# 发布模式 debug | release
+model = "debug"
+
+# 构建平台
+[build.platform]
+target = "$target"
+
+# 排除项
+[build.exclude]
+file = []
+dir = []
+
+# 优化
+[build.optimize]
+# 编译 default-theme 文件
+out-default-theme = true
+
+# 压缩代码
+[build.optimize.min-code]
+js = false
+css = false
+html = false

package/template/project-base/build.toml

@@ -0,0 +1,43 @@
+# 配置
+[config]
+# 项目名字
+name = "$name"
+# 源码目录
+src = "app"
+# 入口文件名
+main = "index"
+
+# 构建配置
+[build]
+# 构建目录名
+out = "build"
+# 发布模式 debug | release
+model = "debug"
+
+# 构建平台
+[build.platform]
+target = "$target"
+
+# 构建导入
+[build.import]
+module = []
+
+# 排除项
+[build.exclude]
+file = []
+dir = []
+
+# 优化
+[build.optimize]
+# 编译 default-theme 文件
+out-default-theme = true
+
+# 压缩代码
+[build.optimize.min-code]
+js = false
+css = false
+html = false
+
+# 构建平台配置
+[build.platform.config]
+$config

package/template/runtime/runtime.css

@@ -0,0 +1,3 @@
+body > m-cache-element:first-child {
+    display: none !important;
+}