@qqi/log 1.0.0 → 1.1.1

package/es/index.js

@@ -1,102 +1,2 @@
-import { createConstructor, getRandomString } from 'a-js-tools';
-import { setType } from './setType.js';
-import { blankCall } from './blankCall.js';
-import { managePrint } from './managePrint.js';
-import { isUndefined, isBoolean, isString } from 'a-type-of-js';
-import { platform } from './platform.js';
-import { esc } from '@color-pen/static';
-
-/**
- *
- * 创建 dev log 工厂函数
- *
- * @param options - 配置项
- * @returns - dev log 工厂函数
- */
-function Dog(options) {
-    if (isUndefined(options))
-        options = {
-            name: getRandomString(10),
-            type: false,
-        };
-    if (isBoolean(options))
-        options = {
-            name: getRandomString(10),
-            type: options,
-        };
-    if (isString(options))
-        options = {
-            name: options,
-            type: false,
-        };
-    let { name = '', type = false } = options;
-    // 处理 name
-    name = name.trim().replace(/\s+/g, '_');
-    /**  当前获取环境值  */
-    const _env = (platform === 'node' &&
-        (globalThis?.process.env[name.toUpperCase().concat('_DEV')] ??
-            globalThis?.process.env[name.toLowerCase().concat('_dev')])) ||
-        false;
-    const env = _env === 'false' ? false : _env === 'true' ? true : _env;
-    /**  默认 node 环境以获取到的环境值为准，而非 node 环境默认开启，并通过自定义的 @qqi/babel-plugin-remove-dog-calls 来进行过滤正式环境（环境值需要自定义） */
-    type = platform === 'node' ? setType(env ?? type) : true;
-    /// 原始的调用方法，在 type 值变化时会触发该值的更替
-    // 私有方法 error
-    const _privateFunc = {
-        error: blankCall,
-        warn: blankCall,
-        info: blankCall,
-    };
-    managePrint(type, _privateFunc, name);
-    /**  本体方法  */
-    const dog = (...str) => {
-        Reflect.apply(_privateFunc.info, this, str);
-    };
-    // 设置 prototype
-    Object.setPrototypeOf(dog, this);
-    // 设置属性和方法
-    Object.defineProperties(this, {
-        type: {
-            get() {
-                return type || false;
-            },
-            set(value) {
-                const new_type = setType(value);
-                if (new_type !== type) {
-                    type = new_type;
-                    managePrint(type, _privateFunc, name);
-                }
-            },
-        },
-        error: {
-            value: (...str) => Reflect.apply(_privateFunc.error, this, str),
-            configurable: false,
-            enumerable: false,
-            writable: false,
-        },
-        warn: {
-            value: (...str) => Reflect.apply(_privateFunc.warn, this, str),
-            configurable: false,
-            enumerable: false,
-            writable: false,
-        },
-    });
-    return dog;
-}
-Dog.prototype.clear = () => {
-    if (platform === 'browser') {
-        console.clear();
-    }
-    else {
-        console.log(esc.concat('c'));
-    }
-};
-/**
- *
- * @param options 配置项
- * @returns 函数对象
- *
- */
-const DogConstructor = createConstructor(Dog);
-
-export { DogConstructor as Dog };
+export { Dog } from './core.js';
+export { DogVirtual } from './virtual-dog.js';

package/es/rollup.config.d.ts

@@ -0,0 +1,17 @@
+declare namespace _default {
+    namespace input {
+        let index: string;
+    }
+    let output: {
+        format: string;
+        entryFileNames: string;
+        preserveModules: boolean;
+        preserveModulesRoot: string;
+        sourcemap: boolean;
+        exports: string;
+        dir: string;
+    }[];
+    let external: (id: string) => boolean;
+    let plugins: import("rollup").Plugin<any>[];
+}
+export default _default;

package/es/rollup.config.eg.d.ts

@@ -0,0 +1,14 @@
+declare namespace _default {
+    let input: string;
+    namespace output {
+        let format: string;
+        let entryFileNames: string;
+        let preserveModules: boolean;
+        let sourcemap: boolean;
+        let exports: string;
+        let dir: string;
+    }
+    let external: (id: string) => boolean;
+    let plugins: import("rollup").Plugin<any>[];
+}
+export default _default;

package/es/src/core.d.ts

@@ -0,0 +1,9 @@
+import { DevLog, DogOptions } from './type';
+/**
+ *
+ * @param options 配置项
+ * @returns 函数对象
+ *
+ */
+declare const DogConstructor: import("a-js-tools").CreateConstructor<DevLog, [options?: DogOptions | undefined]>;
+export { DogConstructor as Dog };

package/es/src/index.d.ts

@@ -1,10 +1,15 @@
-import { DevLog, DogOptions } from './type';
 /**
- *
- * @param options 配置项
- * @returns 函数对象
- *
+ * @packageDocumentation
+ * @module @qqi/log/index
+ * @file index.ts
+ * @description _
+ * @author MrMudBean <Mr.MudBean@outlook.com>
+ * @license MIT
+ * @copyright 2026 ©️ MrMudBean
+ * @since 2026-01-28 04:52
+ * @version 1.1.0
+ * @lastModified 2026-01-28 04:53
  */
-declare const DogConstructor: import("a-js-tools").CreateConstructor<DevLog, [options?: DogOptions | undefined]>;
-export { DogConstructor as Dog };
+export { Dog } from './core';
+export { DogVirtual } from './virtual-dog';
 export type { DevLogType, DevLog } from './type';

package/es/src/type.d.ts

@@ -2,14 +2,20 @@ export type DevLogType = boolean | 'info' | 'error' | 'all' | 'warn';
 export type DevLog = {
     /**  打印信息本当作为 info 信息，在 type 为 `false`、`error`、`warn` 时不打印   */
     (...str: unknown[]): void;
+    /**  当打印的版本为错误信息，在 type 为 `false`、`error`、`warn` 时不打印  */
+    info: (...str: unknown[]) => void;
     /**  当打印的版本为错误信息，在 type 为 `false`、`info`、`warn` 时不打印  */
     error: (...str: unknown[]) => void;
     /**  当打印的版本为警示信息，在 type 为 `false`、`info`、`error` 时不打印  */
     warn: (...str: unknown[]) => void;
     /**  node 平台执行依据  */
-    name: '';
+    name: string;
+    /** 同名（方法）折叠 */
+    fold: boolean;
     /**  开启打印的类型  */
     type: DevLogType;
+    /** 当前标记的名 */
+    mark: string;
     /**  清除控制台  */
     clear: () => void;
 };
@@ -21,16 +27,12 @@ export interface PrivateFunc {
 }
 export type DogOptions = {
     /**
-     * ### 类型
-     *
+     * ## 类型
      * 但是该值将被传入的系统参数覆盖
-     *
      */
     type?: DevLogType;
-    /**
-     * 该值将以 name_dev 的形式配置允许打印
-     *
-     *
-     */
+    /**  该值将以 name_dev 的形式配置允许打印 */
     name?: string;
+    /** 同名文件打印消息是否折叠（控制台效果不明显） */
+    fold?: boolean;
 } | string | boolean;

package/es/src/util.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @packageDocumentation
+ * @module @qqi/log/util
+ * @file util.ts
+ * @description 工具
+ * @author MrMudBean <Mr.MudBean@outlook.com>
+ * @license MIT
+ * @copyright 2026 ©️ MrMudBean
+ * @since 2026-01-28 03:11
+ * @version 1.0.1
+ * @lastModified 2026-01-28 04:34
+ */
+import { DevLogType } from '@qqi/log';
+import { DogOptions } from './type';
+export declare const typeList: DevLogType[];
+/**
+ * ## 解析参数
+ * @param options
+ */
+export declare function parseOption(options?: DogOptions): {
+    name?: string;
+    type?: DevLogType;
+    fold?: boolean;
+};
+/**
+ * 获取当前的环境变量
+ * @param name
+ */
+export declare function getEnv(name?: string): DevLogType;
+export declare const platform: string;
+/**
+ * 设置 type 的类型
+ * @param type 新的类型
+ */
+export declare function setType(type: DevLogType): DevLogType;

package/es/src/virtual-dog.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @packageDocumentation
+ * @module @qqi/log/virtual-dog
+ * @file virtual-dog.ts
+ * @description _
+ * @author MrMudBean <Mr.MudBean@outlook.com>
+ * @license MIT
+ * @copyright 2026 ©️ MrMudBean
+ * @since 2026-01-28 04:52
+ * @version 1.1.0
+ * @lastModified 2026-01-28 04:53
+ */
+import { DevLog } from './type';
+/** 虚拟狗，没有实现不打印 */
+declare const DogVirtualConstructor: import("a-js-tools").CreateConstructor<DevLog, []>;
+export { DogVirtualConstructor as DogVirtual };

package/es/util.js

@@ -0,0 +1,81 @@
+import { isNode, getRandomString } from 'a-js-tools';
+import { isUndefined, isBoolean, isString } from 'a-type-of-js';
+
+/**
+ * @packageDocumentation
+ * @module @qqi/log/util
+ * @file util.ts
+ * @description 工具
+ * @author MrMudBean <Mr.MudBean@outlook.com>
+ * @license MIT
+ * @copyright 2026 ©️ MrMudBean
+ * @since 2026-01-28 03:11
+ * @version 1.0.1
+ * @lastModified 2026-01-28 04:34
+ */
+var typeList = [
+    false,
+    true,
+    'all',
+    'info',
+    'error',
+    'warn',
+];
+/**
+ * ## 解析参数
+ * @param options
+ */
+function parseOption(options) {
+    var result = {
+        name: getRandomString(10),
+        type: false,
+        fold: false,
+    };
+    if (isUndefined(options))
+        return result;
+    if (isBoolean(options)) {
+        result.type = options;
+        return result;
+    }
+    if (isString(options)) {
+        // 处理 name
+        result.name = options.trim().replace(/\s+/g, '_');
+        return result;
+    }
+    if (isString(options.name)) {
+        result.name = options.name.trim().replace(/\s+/g, '_');
+        return result;
+    }
+    return options;
+}
+/**
+ * 获取当前的环境变量
+ * @param name
+ */
+function getEnv(name) {
+    var _a;
+    if (name === void 0) { name = getRandomString(10); }
+    /**  当前获取环境值  */
+    var _env = false;
+    if (platform === 'node' && ((_a = globalThis === null || globalThis === void 0 ? void 0 : globalThis.process) === null || _a === void 0 ? void 0 : _a.env)) {
+        var processEnv = process.env;
+        _env =
+            processEnv[name.toUpperCase().concat('_DEV')] ||
+                processEnv[name.toLowerCase().concat('_dev')] ||
+                false;
+    }
+    var env = _env === 'false' ? false : _env === 'true' ? true : _env;
+    return env;
+}
+var platform = isNode() ? 'node' : 'browser';
+/**
+ * 设置 type 的类型
+ * @param type 新的类型
+ */
+function setType(type) {
+    if (typeList.includes(type))
+        return type;
+    return false;
+}
+
+export { getEnv, parseOption, platform, setType, typeList };

package/es/virtual-dog.js

@@ -0,0 +1,58 @@
+import { createConstructor } from 'a-js-tools';
+
+/**
+ * @packageDocumentation
+ * @module @qqi/log/virtual-dog
+ * @file virtual-dog.ts
+ * @description _
+ * @author MrMudBean <Mr.MudBean@outlook.com>
+ * @license MIT
+ * @copyright 2026 ©️ MrMudBean
+ * @since 2026-01-28 04:52
+ * @version 1.1.0
+ * @lastModified 2026-01-28 04:53
+ */
+/**
+ *
+ */
+function DogVirtualImt() {
+    /**
+     *  模拟类的构建
+     * @param _arg
+     */
+    var _dev = function () {
+    };
+    Object.setPrototypeOf(_dev, this);
+    Object.defineProperties(this, {
+        info: {
+            value: function () {
+            },
+            configurable: false,
+            writable: false,
+        },
+        warn: {
+            value: function () {
+            },
+            configurable: false,
+            writable: false,
+        },
+        error: {
+            value: function () {
+            },
+            configurable: false,
+            writable: false,
+        },
+        type: {
+            get: function () {
+                return false;
+            },
+            set: function (_) { },
+        },
+    });
+    return _dev;
+}
+DogVirtualImt.prototype.clear = console.clear;
+/** 虚拟狗，没有实现不打印 */
+var DogVirtualConstructor = createConstructor(DogVirtualImt);
+
+export { DogVirtualConstructor as DogVirtual };

package/package.json

@@ -1,10 +1,15 @@
 {
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "name": "@qqi/log",
   "main": "cjs/index.js",
   "module": "es/index.js",
   "types": "es/src/index.d.ts",
+  "author": {
+    "name": "泥豆君",
+    "email": "Mr.MudBean@outlook.com",
+    "url": "https://earthnut.dev"
+  },
   "description": "原 @qqi/dev-log 中的 log 部分",
   "sideEffects": false,
   "license": "MIT",
@@ -38,7 +43,8 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/MrMudBean/qqi.git"
+    "url": "git+https://github.com/MrMudBean/qqi.git",
+    "directory": "packages/log"
   },
   "publishConfig": {
     "access": "public",

package/cjs/blankCall.js

@@ -1,11 +0,0 @@
-'use strict';
-
-/**
- *
- * 空函数
- *
- */
-function blankCall(...str) {
-}
-
-exports.blankCall = blankCall;

package/cjs/managePrint.js

@@ -1,53 +0,0 @@
-'use strict';
-
-var aTypeOfJs = require('a-type-of-js');
-var notSupport = require('./notSupport.js');
-var platform = require('./platform.js');
-var blankCall = require('./blankCall.js');
-var printError = require('./printError.js');
-var printWarn = require('./printWarn.js');
-var printInfo = require('./printInfo.js');
-var setType = require('./setType.js');
-
-/**  管理是否打印  */
-function managePrint(type, privateFunc, name) {
-    if (platform.platform === 'node') {
-        const dev = globalThis?.process.env[name.toUpperCase().concat('_DEV')] ||
-            globalThis?.process.env[name.toLowerCase().concat('_dev')];
-        /// 当前禁止使用打印
-        /// node 环境未配置 NAME_DEV 环境变量
-        /// 显式配置 NAME_DEV 环境变量为 false
-        if (type === false || aTypeOfJs.isUndefined(dev) || dev === 'false') {
-            return Reflect.apply(notSupport.notSupport, privateFunc, []);
-        }
-        /// 将显示配置环境变量的值给 type
-        if ([...setType.typeList, 'true', 'false'].includes(dev)) {
-            type = dev === 'true' ? 'all' : dev;
-        }
-        privateFunc.info = ['all', 'info', true].includes(type)
-            ? printInfo.printInfo
-            : blankCall.blankCall;
-        privateFunc.error = ['all', 'error', true].includes(type)
-            ? printError.printError
-            : blankCall.blankCall;
-        privateFunc.warn = ['all', 'warn', true].includes(type)
-            ? printWarn.printWarn
-            : blankCall.blankCall;
-    }
-    // 在 非 node 环境始终执行，搭配 @qqi/babel-plugin-remove-dog-calls 使用
-    else {
-        if (type === false)
-            return Reflect.apply(notSupport.notSupport, privateFunc, []);
-        privateFunc.info = ['all', 'info', true].includes(type)
-            ? printInfo.printInfo
-            : blankCall.blankCall;
-        privateFunc.error = ['all', 'error', true].includes(type)
-            ? printError.printError
-            : blankCall.blankCall;
-        privateFunc.warn = ['all', 'warn', true].includes(type)
-            ? printWarn.printWarn
-            : blankCall.blankCall;
-    }
-}
-
-exports.managePrint = managePrint;

package/cjs/notSupport.js

@@ -1,14 +0,0 @@
-'use strict';
-
-var blankCall = require('./blankCall.js');
-
-/**
- * 当前环境不支持
- *
- * 三个方法都是空方法
- */
-function notSupport() {
-    this.error = this.info = this.warn = blankCall.blankCall;
-}
-
-exports.notSupport = notSupport;

package/cjs/parseError.js

@@ -1,42 +0,0 @@
-'use strict';
-
-var colorPen = require('color-pen');
-
-/**
- *
- * 解析 error
- *
- */
-function parseError(type) {
-    try {
-        throw new Error();
-    }
-    catch (error) {
-        const parseErrorResult = (error.stack?.split('\n') || []).map(item => {
-            const reg = /at\s(.*)\s\((.*):(\d*):(\d*)\)/;
-            const res = reg.exec(item);
-            if (res) {
-                return {
-                    name: res[1],
-                    path: res[2],
-                    line: res[3],
-                    column: res[4],
-                };
-            }
-            return {
-                name: '',
-            };
-        });
-        const result = parseErrorResult.filter(e => e.name !== '' && e.path !== undefined);
-        const res = result[3] ?? result[2] ?? result[1] ?? result[0];
-        const startStr = ` ${type === 'info' ? '💡' : type === 'error' ? '❌' : '⚠️ '} ${new Date().toLocaleString()} `;
-        const printStartPenStr = (type === 'info'
-            ? colorPen.pen.bgCyan.brightWhite
-            : type === 'error'
-                ? colorPen.pen.bgBlack.red
-                : colorPen.pen.bgBrightYellow.brightGreen)(startStr);
-        console.log(`${printStartPenStr} ${res?.name ?? ''}  ${res?.line?.concat(' 行')} ${res?.column?.concat(' 列')}`);
-    }
-}
-
-exports.parseError = parseError;

package/cjs/platform.js

@@ -1,7 +0,0 @@
-'use strict';
-
-var aJsTools = require('a-js-tools');
-
-const platform = aJsTools.isNode() ? 'node' : 'browser';
-
-exports.platform = platform;

package/cjs/printError.js

@@ -1,15 +0,0 @@
-'use strict';
-
-var parseError = require('./parseError.js');
-
-/**
- *
- * 打印 error 信息
- *
- */
-function printError(...str) {
-    parseError.parseError('error');
-    console.error(...str);
-}
-
-exports.printError = printError;

package/cjs/printInfo.js

@@ -1,15 +0,0 @@
-'use strict';
-
-var parseError = require('./parseError.js');
-
-/**
- *
- * 打印 info 消息
- *
- */
-function printInfo(...str) {
-    parseError.parseError('info');
-    console.info(...str);
-}
-
-exports.printInfo = printInfo;

package/cjs/printWarn.js

@@ -1,15 +0,0 @@
-'use strict';
-
-var parseError = require('./parseError.js');
-
-/**
- *
- * 打印 warn 信息
- *
- */
-function printWarn(...str) {
-    parseError.parseError('warn');
-    console.warn(...str);
-}
-
-exports.printWarn = printWarn;

package/cjs/setType.js

@@ -1,21 +0,0 @@
-'use strict';
-
-const typeList = [
-    false,
-    true,
-    'all',
-    'info',
-    'error',
-    'warn',
-];
-/**
- * 设置 type 的类型
- */
-function setType(type) {
-    if (typeList.includes(type))
-        return type;
-    return false;
-}
-
-exports.setType = setType;
-exports.typeList = typeList;

package/es/blankCall.js

@@ -1,9 +0,0 @@
-/**
- *
- * 空函数
- *
- */
-function blankCall(...str) {
-}
-
-export { blankCall };