@wiajs/core 1.2.1 → 1.2.3

package/.oxfmtrc.jsonc

@@ -0,0 +1,47 @@
+{
+  // https://unpkg.com/oxfmt@0.35.0/configuration_schema.json
+  "$schema": "../../node_modules/oxfmt/configuration_schema.json",
+  "printWidth": 120,
+  "semi": false, // 强制去除分号，保持 JS/TS 的现代感与简洁
+  "singleQuote": true, // 推荐使用单引号，视觉干扰比双引号少
+  "arrowParens": "avoid",
+  "bracketSameLine": true,
+  "bracketSpacing": false, // 去除对象字面量中的空格，保持紧凑
+  "jsxBracketSameLine": true,
+  "jsxSingleQuote": true,
+  "trailingComma": "es5", // 去除尾逗号，保持代码简洁
+  // 导入排序：极度紧凑
+  "sortImports": {
+    "newlinesBetween": false,      // 核心：去除不同组导入之间的空行，压缩垂直空间
+    "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
+    "caseSensitive": false,
+  },
+  // Package.json 排序：工程标准化
+  "sortPackageJson": {
+    "sortScripts": true, // 必须：脚本有序化，方便维护
+  },
+  // 3. Tailwind 类名排序：样式一致性
+  "sortTailwindcss": {
+    // 1. 覆盖所有类名可能出现的逻辑场景
+    "functions": ["clsx", "cn", "cva", "twMerge", "tw"],
+    // 2. 适配所有可能的属性（如某些库使用的 tw 属性）
+    "attributes": ["class", "className", "tw"],
+    // 3. 保持紧凑：自动去重，自动压缩空格
+    "preserveDuplicates": false,
+    "preserveWhitespace": false,
+    // 4. 如果是 Tailwind v4，指向你的 CSS 入口
+    // "stylesheet": "src/index.css"
+  },
+  "ignorePatterns": [
+    "apps/",
+    "assets/",
+    "dist/",
+    "docs/_layouts/",
+    "node_modules/",
+    "patches/",
+    "pnpm-lock.yaml/",
+    "Swabble/",
+    "vendor/",
+    "**/*.min.js",
+  ],
+}

package/.oxlintrc.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "../../node_modules/oxlint/configuration_schema.json",
+  "plugins": ["unicorn", "typescript", "oxc", "react"],
+  "env": {
+    "browser": true,
+    "node": true,
+    "es2022": true
+  },
+  "categories": {
+    "correctness": "error", // 代码正确性相关的规则，必须修复
+    "perf": "error", // 性能相关的规则，建议修复
+    "suspicious": "error", // 可能存在问题的代码模式，建议修复
+    "pedantic": "off", // 推荐设为 off：避免因为琐碎的规则干扰开发流程。
+    "style": "off", // 代码风格相关的规则，保持一致性，建议修复
+    "restriction": "off" // 可能限制开发者的规则，视项目需求开启
+  },
+  "extends": ["recommended"],
+  "rules": {
+    // --- 代码风格 ---
+    "curly": ["error", "multi-or-nest"], // 紧凑风格：单行不加大括号，多行嵌套才加
+    "eqeqeq": ["error", "always", {"null": "ignore"}], // 强制全等，但允许对 null 进行模糊匹配
+    "no-var": "error",
+    "prefer-const": "error",
+    "no-debugger": "off", // 开发阶段允许 debugger
+
+    /* --- 兼容旧版项目中的特殊处理 --- */
+    "no-console": "off", // 开发阶段允许 console
+    "eslint-plugin-unicorn/prefer-array-find": "off", // .filter()[0]
+    "eslint/no-shadow": "off", // 局部变量覆盖外层变量名
+    "eslint/no-await-in-loop": "off", // 循环中的 await
+    "eslint/no-new": "off",
+    "eslint/no-unmodified-loop-condition": "error", // 防止死循环
+    "typescript/no-unnecessary-boolean-literal-compare": "off", // 禁止不必要的布尔比较
+    "typescript/no-unsafe-type-assertion": "off", // as 给 TS 留一点“逃生舱”
+    "typescript/no-extraneous-class": "off", // 只包含静态成员的类
+    "typescript/no-explicit-any": "warn", // 禁止使用 any 类型
+
+    /* --- 性能与现代语法优化 (Unicorn & OXC) --- */
+    "oxc/no-accumulating-spread": "off", // 允许在迭代中使用解构（平衡性能与可读性）
+    "oxc/no-async-endpoint-handlers": "warn", // 异步后端处理函数中可能的未捕获错误
+    "oxc/no-map-spread": "off", // .map() 回调中直接返回解构的对象
+    "unicorn/consistent-function-scoping": "off", // 函数提升到最外层
+    "unicorn/prefer-module": "off", // 强制使用 ES 模块
+    "unicorn/require-post-message-target-origin": "warn", // 基本的安全防范
+    "unicorn/prefer-array-to-sorted": "off", // 数组排序时直接调用 .sort()，不需要先创建新数组
+    "unicorn/no-array-sort": "off", // 允许使用 .sort()，性能更好
+    "object-shorthand": ["warn", "always"], // 强制对象简写，保持代码紧凑
+    "arrow-body-style": ["warn", "as-needed"], // 只有必要时才写 return，缩短函数长度
+
+    /* --- React 适配 --- */
+    "react/jsx-no-undef": "error",
+    "react/react-in-jsx-scope": "off", // 现代 React (Next.js/Bun) 不需要 import React
+    "react/jsx-key": "error",
+
+    /* --- 变量管理 --- */
+    "no-unused-vars": [
+      "warn",
+      {
+        "vars": "local",
+        "args": "after-used",
+        "argsIgnorePattern": "^_", // 允许下划线开头的未用参数
+        "ignoreRestSiblings": true
+      }
+    ]
+  },
+  // 排除检查的文件/目录
+  "ignorePatterns": [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/vendor/**",
+    "**/assets/**",
+    "**/*.min.js",
+    "pnpm-lock.yaml",
+    "yarn.lock",
+    "package-lock.json"
+  ]
+}

package/dist/core.cjs

@@ -1,6 +1,6 @@
 /*!
-  * wia core v1.2.1
-  * (c) 2015-2025 Sibyl Yu and contributors
+  * wia core v1.2.3
+  * (c) 2015-2026 Sibyl Yu and contributors
   * Released under the MIT License.
   */
 'use strict';
@@ -2075,6 +2075,228 @@ class Event {
   }
 }
 
+/*!
+  * wia util v3.4.25
+  * (c) 2018-2024 Yan (Sibyl) Yu and Yuxi (Evan) You and wia/vue contributors
+  * Released under the MIT License.
+  */
+/**
+ * Created by way on 10/6/16.
+ * Part of the code comes from @vue/shared
+ */
+
+
+/**
+ * 前端日志输出，封装 console日志，简化代码，支持模块或直接输出
+ * 调用时，描述字符串后置，便于可选缺省，输出时，自带前置，类似 后端pino，保持前后端一致性
+ * m 为模块，fn 为函数名称
+ */
+class Log {
+  /** @type {string} 模块 */
+  m = ''
+
+  /** @type {string} 函数 */
+  fn = ''
+
+  /**
+   * @param {string} m 模块
+   */
+  constructor(m) {
+    this.m = m;
+  }
+
+  /**
+   * get log desc
+   * 描述字符串后置调用，前置显示
+   * @param {*[]} args
+   * @returns {string}
+   */
+  getDesc(args) {
+    let R = '';
+    try {
+      const _ = this;
+      const { m } = _;
+      let fn = '',
+        desc = '';
+
+      if (args.length > 1) {
+        const last = args.at(-1);
+        if (typeof last === 'object') {
+          ;({ desc, fn } = last);
+        } else if (typeof last === 'string') desc = last;
+        if (desc || fn) {
+          fn = fn || _.fn;
+          _.fn = fn;
+          args.pop();
+        }
+      }
+      fn = fn || _.fn;
+      if (m) desc = `${desc}[${m}${fn ? ':' + fn : ''}]`; // eslint-disable-line
+      R = desc;
+    } catch (e) {
+      console.error(`getDesc exp:${e.message}`);
+    }
+
+    return R
+  }
+
+  /** @param {...any} args - params */
+  log(...args) {
+    const _ = this;
+    const last = args.at(-1);
+    // clear fn
+    if (args.length === 1 && typeof last === 'object' && last.fn) _.fn = '';
+    else {
+      const desc = _.getDesc(args);
+      console.log(desc, ...args);
+    }
+  }
+
+  /** @param {...any} args - params */
+  debug(...args) {
+    const _ = this;
+    const desc = _.getDesc(args);
+    if (desc) console.log(desc, ...args);
+    else console.log(...args);
+  }
+
+  /** @param {...any} args - params */
+  info(...args) {
+    const _ = this;
+    const desc = _.getDesc(args);
+    if (desc) console.info(desc, ...args);
+    else console.log(...args);
+  }
+
+  /** @param {...any} args - params */
+  warn(...args) {
+    const _ = this;
+    const { desc, arg } = _.getDesc(args);
+    if (desc) console.warn(desc, ...arg);
+    else console.log(...args);
+  }
+
+  /** @param {...any} args - params */
+  trace(...args) {
+    const _ = this;
+    const { desc, arg } = _.getDesc(args);
+    if (desc) console.trace(desc, ...arg);
+    else console.trace(...args);
+  }
+
+  /** @param {...any} args - params */
+  error(...args) {
+    const _ = this;
+    const desc = _.getDesc(args);
+    if (desc) console.error(desc, ...args);
+    else console.log(...args);
+  }
+
+  /**
+   * 用于 catch(e) log.err(e)
+   * @param {...any} args - params */
+  err(...args) {
+    const _ = this;
+    const first = args?.[0];
+    if (
+      first instanceof Error ||
+      (first && first.message && first.cause && first.stack)
+    )
+      args[0] = { exp: args[0].message };
+    _.error(...args);
+  }
+}
+
+function getDesc(args) {
+  let desc = '';
+  const last = args.at(-1);
+  if (typeof last === 'string') {
+    desc = last;
+    args.pop();
+  }
+  return desc
+}
+
+/**
+ * 标准日志输出或构建模块日志类实例，用于模块中带[m:xxx]标记日志输出
+ * 启用 {f:fn} 标记时，需在函数尾部清除f（log({f:''})），否则会溢出到其他函数
+ * @param {...any} args - params
+ * returns {*}
+ */
+function log(...args) {
+  const last = args.at(-1);
+
+  // 全局日志
+  if (args.length !== 1 || !last?.m) {
+    const desc = getDesc(args);
+    desc ? console.log(desc, ...args) : console.log(...args);
+    return
+  }
+
+  // 唯一 m 属性，则构造新的 log 实例，这种写法，能被jsDoc识别子属性
+  const lg = new Log(last?.m);
+  /** @param {*} args2 */
+  const R = (...args2) => lg.log(...args2);
+  R.debug = lg.debug.bind(lg);
+  R.info = lg.info.bind(lg);
+  R.warn = lg.warn.bind(lg);
+  R.info = lg.info.bind(lg);
+  R.trace = lg.trace.bind(lg);
+  R.error = lg.error.bind(lg);
+  R.err = lg.err.bind(lg);
+
+  return R
+}
+
+/**
+ * 用于 catch(e) log.err(e)
+ * @param {...any} args - params */
+log.err = (...args) => {
+  const desc = getDesc(args);
+  const first = args?.[0];
+  if (
+    first instanceof Error ||
+    (first && first.message && first.cause && first.stack)
+  )
+    args[0] = { exp: args[0].message };
+  desc ? console.error(desc, ...args) : console.error(...args);
+};
+
+/**
+ * @param {...any} args - params */
+log.error = (...args) => {
+  const desc = getDesc(args);
+  desc ? console.error(desc, ...args) : console.error(...args);
+};
+
+/**
+ * @param {...any} args - params */
+log.warn = (...args) => {
+  const desc = getDesc(args);
+  desc ? console.warn(desc, ...args) : console.warn(...args);
+};
+
+/**
+ * @param {...any} args - params */
+log.info = (...args) => {
+  const desc = getDesc(args);
+  desc ? console.info(desc, ...args) : console.info(...args);
+};
+
+/**
+ * @param {...any} args - params */
+log.debug = (...args) => {
+  const desc = getDesc(args);
+  desc ? console.log(desc, ...args) : console.log(...args);
+};
+
+/**
+ * @param {...any} args - params */
+log.trace = (...args) => {
+  const desc = getDesc(args);
+  desc ? console.trace(desc, ...args) : console.trace(...args);
+};
+
 /**
  * 所有页面从该类继承，并必须实现 load 事件！
  * 事件
@@ -2145,16 +2367,16 @@ class Page extends Event {
    * 在已经加载就绪的视图上操作
    * @param {*} view 页面层的 Dom 对象，已经使用`$(#page-name)`，做了处理
    * @param {*} param go 函数的参数，或 网址中 url 中的参数
-   * @param {*} back 是否为回退，A->B, B->A，这种操作属于回退
+   * @param {*} lastPath 前路由的路径，go 函数的参数，或 网址中 url 中的参数
    */
-  ready(view, param, back) {
+  ready(view, param, lastPath) {
     // $.assign(this, {page, param, back});
     // $.assign(this.data, param);
     // 隐藏所有模板
     this.init();
-    this.emit('local::ready', view, param, back);
+    this.emit('local::ready', view, param, lastPath);
     // 向上触发跨页面事件，存在安全问题
-    this.emit('pageReady', this, view, param, back);
+    this.emit('pageReady', this, view, param, lastPath);
   }
 
   /**
@@ -2168,29 +2390,29 @@ class Page extends Event {
 
   // 显示已加载的页面
   // view：页面Dom层，param：参数
-  show(view, param) {
+  show(view, param, lastPath) {
     // 隐藏所有模板
     view.qus('[name$=-tp]').hide();
     // 防止空链接，刷新页面
     view.qus('a[href=""]').attr('href', 'javascript:;');
     // this.init();
     if (this.reset) this.reset();
-    this.emit('local::show', view, param);
+    this.emit('local::show', view, param, lastPath);
     // 向上触发跨页面事件，存在安全问题
-    this.emit('pageShow', this, view, param);
+    this.emit('pageShow', this, view, param, lastPath);
   }
 
   // 回退显示已加载的页面
   // view：页面Dom层，param：参数
-  back(view, param) {
+  back(view, param, lastPath) {
     // 隐藏所有模板
     view.qus('[name$=-tp]').hide();
     // 防止空链接，刷新页面
     view.qus('a[href=""]').attr('href', 'javascript:;');
 
-    this.emit('local::back', view, param);
+    this.emit('local::back', view, param, lastPath);
     // 向上触发跨页面事件，存在安全问题
-    this.emit('pageBack', this, view, param);
+    this.emit('pageBack', this, view, param, lastPath);
   }
 
   change(view, param, lastParam) {
@@ -2212,6 +2434,77 @@ class Page extends Event {
   }
 }
 
+/**
+ * 页面工厂函数
+ * 自动处理类的继承、日志注入、生命周期事件绑定
+ * @param {Object} def - 页面默认配置
+ * @param {Object} hooks - 业务钩子函数集合 { init, bind, show... }
+ */
+function page(def, hooks = {}) {
+  // 自动根据配置创建当前页面的专属日志实例
+  const _log = log({m: `${def.name}`});
+
+  return class extends Page {
+    constructor(opts = {}) {
+      const opt = {...def, ...opts};
+      super(opt.app, opt.name, opt.title);
+      this.opt = opt;
+
+      // ✨ 魔法 1：利用 page.js 内置的 Event 机制，全自动挂载无侵入日志！
+      this.on('local::load', param => _log({param}, 'load'));
+      this.on('local::ready', (v, param, lastPath) => _log({v, param, lastPath, id: this.id}, 'ready'));
+      this.on('local::show', (v, param, lastPath) => _log({v, param, lastPath, id: this.id}, 'show'));
+      this.on('local::change', (v, param, lastParam) => _log({v, param, lastParam}, 'change'));
+      this.on('local::back', (v, param, lastPath) => _log({v, param, lastPath, id: this.id}, 'back'));
+      this.on('local::hide', v => _log({v, id: this.id}, 'hide'));
+      this.on('local::unload', v => _log({v, id: this.id}, 'unload'));
+    }
+
+    // 映射其他生命周期到业务 hooks
+    load(param) {
+      super.load(param);
+      if (hooks.load) hooks.load({param, pg: this, log: _log});
+    }
+
+    // ✨ 魔法 2：统一调度业务代码的 init 和 bind，提供优雅的上下文
+    async ready(v, param, lastPath) {
+      super.ready(v, param, lastPath);
+
+      // 组装上下文对象供业务使用
+      const ctx = {v, pg: this, param, lastPath, log: _log};
+
+      // 自动按顺序执行业务层的初始化和事件绑定
+      if (hooks.init) await hooks.init(ctx);
+      if (hooks.bind) hooks.bind(ctx);
+    }
+
+    show(v, param, lastPath) {
+      super.show(v, param, lastPath);
+      if (hooks.show) hooks.show({v, pg: this, param, lastPath, log: _log});
+    }
+
+    change(v, param, lastParam) {
+      super.change(v, param, lastParam);
+      if (hooks.change) hooks.change({v, pg: this, param, lastParam, log: _log});
+    }
+
+    back(v, param, lastPath) {
+      super.back(v, param, lastPath);
+      if (hooks.back) hooks.back({v, pg: this, param, lastPath, log: _log});
+    }
+
+    hide(v, param) {
+      super.hide(v, param);
+      if (hooks.hide) hooks.hide({v, pg: this, param, log: _log});
+    }
+
+    unload(v) {
+      super.unload(v);
+      if (hooks.unload) hooks.unload({v, pg: this, log: _log});
+    }
+  }
+}
+
 /**
  * Wia app、router等继承类，通过模块化扩展类功能
  * 使用 use 装载，注解可能完成类似功能
@@ -4420,3 +4713,4 @@ exports.Support = Support;
 exports.Utils = Utils;
 exports.jsx = jsx;
 exports.loadModule = loadModule;
+exports.page = page;