@longzai-intelligence-taro/config 0.0.1 → 0.0.2

package/README.md

@@ -1,28 +1,75 @@
-# @longzai-intelligence-taro/config
+# Longzai Intelligence Taro Config
 
-Taro 构建配置封装包。对 `@tarojs/cli` 的 `defineConfig` 与类型（`UserConfigExport`、`UserConfigFn`、`ConfigEnv`）做一层 re-export，作为各项目 `apps/miniprogram/config/` 的统一配置入口。
+Longzai Intelligence Taro 构建配置封装包，为各项目 miniprogram 提供对标生产形态的公共基础配置预设，消除 config 三件套的重复样板。
+
+## 创建初衷
+
+各项目 miniprogram 的 Taro 构建配置存在大量逐字节相同的样板（设计稿基准、技术栈、postcss、别名等），分散在各项目 config 目录难以维护。本包将这些组织级通用约定提取为预设，base 对标 ktv 生产形态（移除项目专属项后保留通用部分），消费方任何字段皆可覆盖，预设非锁定。
+
+## 工作范围
+
+提供 base 预设（`createBaseConfig`）、配置定义函数（`defineConfig`）、版本读取工具（`readAppVersion`）与环境预设（`devPreset`、`prodPreset`），覆盖 miniprogram 构建配置的组织级通用部分；项目专属配置（UI 库兼容、环境变量注入、缓存隔离等）由消费方覆盖。
+
+## peerDependency
+
+依赖 `@tarojs/cli@^4.0.0`，由消费方项目（miniprogram）安装。
 
 ## 用法
 
+`defineConfig` 支持两种形态。
+
+### 对象形态
+
+自动注入 base 预设并深合并，消费方字段覆盖预设：
+
 ```ts
-// apps/miniprogram/config/index.ts
-import { defineConfig, type UserConfigExport } from '@longzai-intelligence-taro/config';
+import { defineConfig } from '@longzai-intelligence-taro/config';
 
-export default defineConfig<'taro'>(async (merge) => {
-  const base: UserConfigExport<'taro'> = { /* ... */ };
-  return merge({}, base, process.env.NODE_ENV === 'development' ? devConfig : prodConfig);
+export default defineConfig({
+  projectName: 'longzai-intelligence-foo-miniprogram',
 });
 ```
 
+### 回调形态
+
+透传 `@tarojs/cli` 原生 defineConfig，消费方在回调内自由组装动态逻辑（版本注入、环境变量、缓存隔离等）：
+
 ```ts
-// apps/miniprogram/config/dev.ts
-import { defineConfig } from '@longzai-intelligence-taro/config';
+import { createBaseConfig, defineConfig } from '@longzai-intelligence-taro/config';
 
 export default defineConfig(async (merge) => {
-  return merge({}, { mini: {}, h5: {} });
+  return merge({}, createBaseConfig(), {
+    projectName: 'longzai-intelligence-foo-miniprogram',
+    compiler: { type: 'webpack5', prebundle: { exclude: ['some-ui-lib'] } },
+  });
 });
 ```
 
-## peerDependency
+## 导出 API
 
-依赖 `@tarojs/cli@^4.0.0`，由消费方项目（miniprogram）安装。
+### `defineConfig(config)`
+
+支持对象（自动注入 base 预设深合并）与回调（透传原生）两种形态。
+
+### `createBaseConfig()`
+
+对标 ktv 生产形态的 base 预设，包含以下组织级通用约定：
+
+- 设计稿基准 designWidth 750、sourceRoot/outputRoot 为 src/dist。
+- framework 为 react、compiler 为 webpack5。
+- 缓存 enable 为 true。
+- mini/h5 postcss（pxtransform、autoprefixer、cssModules）。
+- `@`→src 别名。
+- APP_VERSION 版本注入（构建期读取消费方 package.json）。
+
+### `readAppVersion()`
+
+读取消费方 package.json 的 version。
+
+### `devPreset`、`prodPreset`
+
+dev/prod 环境预设。
+
+### `UserConfigExport`、`UserConfigFn`、`ConfigEnv`
+
+re-export `@tarojs/cli` 类型。

package/dist/base.config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Taro 小程序公共基础配置
+ *
+ * 严格对标 ktv 生产形态（apps/taro-app/config/index.ts 的 getBaseConfig），
+ * 移除 ktv 项目专属项（@taroify 相关、TARO_APP_* 注入、api/store 缓存隔离、React 18 alias 等），
+ * 保留组织级通用约定作为预设。消费方任何字段皆可覆盖，预设非锁定。
+ */
+import type { IProjectConfig } from '@tarojs/taro/types/compile';
+/**
+ * LZI miniprogram 公共基础配置预设
+ *
+ * 对标 ktv getBaseConfig 的组织级通用部分：设计稿基准、目录、技术栈、
+ * webpack5 持久化缓存开关、mini/h5 postcss、@ 别名、APP_VERSION 版本注入。
+ * 项目专属配置（prebundle exclude、缓存 name 隔离、环境变量注入、UI 库兼容等）由消费方覆盖。
+ *
+ * @returns 可作为 defineConfig 传参基础部分的配置对象
+ */
+export declare function createBaseConfig(): IProjectConfig;
+//# sourceMappingURL=base.config.d.ts.map

package/dist/base.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.config.d.ts","sourceRoot":"","sources":["../src/base.config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAiEjD","sourcesContent":["/**\n * Taro 小程序公共基础配置\n *\n * 严格对标 ktv 生产形态（apps/taro-app/config/index.ts 的 getBaseConfig），\n * 移除 ktv 项目专属项（@taroify 相关、TARO_APP_* 注入、api/store 缓存隔离、React 18 alias 等），\n * 保留组织级通用约定作为预设。消费方任何字段皆可覆盖，预设非锁定。\n */\n\nimport type { IProjectConfig } from '@tarojs/taro/types/compile';\n\nimport path from 'node:path';\n\nimport { readAppVersion } from './version.utils.js';\n\n/**\n * LZI miniprogram 公共基础配置预设\n *\n * 对标 ktv getBaseConfig 的组织级通用部分：设计稿基准、目录、技术栈、\n * webpack5 持久化缓存开关、mini/h5 postcss、@ 别名、APP_VERSION 版本注入。\n * 项目专属配置（prebundle exclude、缓存 name 隔离、环境变量注入、UI 库兼容等）由消费方覆盖。\n *\n * @returns 可作为 defineConfig 传参基础部分的配置对象\n */\nexport function createBaseConfig(): IProjectConfig {\n  return {\n    designWidth: 750,\n    deviceRatio: {\n      640: 2.34 / 2,\n      750: 1,\n      375: 2,\n      828: 1.81 / 2,\n    },\n    sourceRoot: 'src',\n    outputRoot: 'dist',\n    copy: {\n      patterns: [],\n      options: {},\n    },\n    framework: 'react',\n    compiler: {\n      type: 'webpack5',\n    },\n    cache: {\n      enable: true,\n    },\n    defineConstants: {\n      /**\n       * 应用版本号，构建期从消费方 package.json 读取并静态注入，\n       * 运行时代码通过 APP_VERSION 访问\n       */\n      APP_VERSION: JSON.stringify(readAppVersion()),\n    },\n    mini: {\n      postcss: {\n        pxtransform: {\n          enable: true,\n          config: {},\n        },\n        cssModules: {\n          enable: false,\n          config: {\n            namingPattern: 'module',\n            generateScopedName: '[name]__[local]___[hash:base64:5]',\n          },\n        },\n      },\n    },\n    h5: {\n      publicPath: '/',\n      staticDirectory: 'static',\n      postcss: {\n        autoprefixer: {\n          enable: true,\n          config: {},\n        },\n        cssModules: {\n          enable: false,\n          config: {\n            namingPattern: 'module',\n            generateScopedName: '[name]__[local]___[hash:base64:5]',\n          },\n        },\n      },\n    },\n    alias: {\n      '@': path.resolve(process.cwd(), 'src'),\n    },\n  };\n}\n"]}

package/dist/base.config.js

@@ -0,0 +1,85 @@
+/**
+ * Taro 小程序公共基础配置
+ *
+ * 严格对标 ktv 生产形态（apps/taro-app/config/index.ts 的 getBaseConfig），
+ * 移除 ktv 项目专属项（@taroify 相关、TARO_APP_* 注入、api/store 缓存隔离、React 18 alias 等），
+ * 保留组织级通用约定作为预设。消费方任何字段皆可覆盖，预设非锁定。
+ */
+import path from 'node:path';
+import { readAppVersion } from './version.utils.js';
+/**
+ * LZI miniprogram 公共基础配置预设
+ *
+ * 对标 ktv getBaseConfig 的组织级通用部分：设计稿基准、目录、技术栈、
+ * webpack5 持久化缓存开关、mini/h5 postcss、@ 别名、APP_VERSION 版本注入。
+ * 项目专属配置（prebundle exclude、缓存 name 隔离、环境变量注入、UI 库兼容等）由消费方覆盖。
+ *
+ * @returns 可作为 defineConfig 传参基础部分的配置对象
+ */
+export function createBaseConfig() {
+    return {
+        designWidth: 750,
+        deviceRatio: {
+            640: 2.34 / 2,
+            750: 1,
+            375: 2,
+            828: 1.81 / 2,
+        },
+        sourceRoot: 'src',
+        outputRoot: 'dist',
+        copy: {
+            patterns: [],
+            options: {},
+        },
+        framework: 'react',
+        compiler: {
+            type: 'webpack5',
+        },
+        cache: {
+            enable: true,
+        },
+        defineConstants: {
+            /**
+             * 应用版本号，构建期从消费方 package.json 读取并静态注入，
+             * 运行时代码通过 APP_VERSION 访问
+             */
+            APP_VERSION: JSON.stringify(readAppVersion()),
+        },
+        mini: {
+            postcss: {
+                pxtransform: {
+                    enable: true,
+                    config: {},
+                },
+                cssModules: {
+                    enable: false,
+                    config: {
+                        namingPattern: 'module',
+                        generateScopedName: '[name]__[local]___[hash:base64:5]',
+                    },
+                },
+            },
+        },
+        h5: {
+            publicPath: '/',
+            staticDirectory: 'static',
+            postcss: {
+                autoprefixer: {
+                    enable: true,
+                    config: {},
+                },
+                cssModules: {
+                    enable: false,
+                    config: {
+                        namingPattern: 'module',
+                        generateScopedName: '[name]__[local]___[hash:base64:5]',
+                    },
+                },
+            },
+        },
+        alias: {
+            '@': path.resolve(process.cwd(), 'src'),
+        },
+    };
+}
+//# sourceMappingURL=base.config.js.map

package/dist/base.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.config.js","sourceRoot":"","sources":["../src/base.config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE;YACX,GAAG,EAAE,IAAI,GAAG,CAAC;YACb,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,IAAI,GAAG,CAAC;SACd;QACD,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,MAAM;QAClB,IAAI,EAAE;YACJ,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,EAAE;SACZ;QACD,SAAS,EAAE,OAAO;QAClB,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU;SACjB;QACD,KAAK,EAAE;YACL,MAAM,EAAE,IAAI;SACb;QACD,eAAe,EAAE;YACf;;;eAGG;YACH,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;SAC9C;QACD,IAAI,EAAE;YACJ,OAAO,EAAE;gBACP,WAAW,EAAE;oBACX,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,EAAE;iBACX;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,KAAK;oBACb,MAAM,EAAE;wBACN,aAAa,EAAE,QAAQ;wBACvB,kBAAkB,EAAE,mCAAmC;qBACxD;iBACF;aACF;SACF;QACD,EAAE,EAAE;YACF,UAAU,EAAE,GAAG;YACf,eAAe,EAAE,QAAQ;YACzB,OAAO,EAAE;gBACP,YAAY,EAAE;oBACZ,MAAM,EAAE,IAAI;oBACZ,MAAM,EAAE,EAAE;iBACX;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,KAAK;oBACb,MAAM,EAAE;wBACN,aAAa,EAAE,QAAQ;wBACvB,kBAAkB,EAAE,mCAAmC;qBACxD;iBACF;aACF;SACF;QACD,KAAK,EAAE;YACL,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC;SACxC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Taro 小程序公共基础配置\n *\n * 严格对标 ktv 生产形态（apps/taro-app/config/index.ts 的 getBaseConfig），\n * 移除 ktv 项目专属项（@taroify 相关、TARO_APP_* 注入、api/store 缓存隔离、React 18 alias 等），\n * 保留组织级通用约定作为预设。消费方任何字段皆可覆盖，预设非锁定。\n */\n\nimport type { IProjectConfig } from '@tarojs/taro/types/compile';\n\nimport path from 'node:path';\n\nimport { readAppVersion } from './version.utils.js';\n\n/**\n * LZI miniprogram 公共基础配置预设\n *\n * 对标 ktv getBaseConfig 的组织级通用部分：设计稿基准、目录、技术栈、\n * webpack5 持久化缓存开关、mini/h5 postcss、@ 别名、APP_VERSION 版本注入。\n * 项目专属配置（prebundle exclude、缓存 name 隔离、环境变量注入、UI 库兼容等）由消费方覆盖。\n *\n * @returns 可作为 defineConfig 传参基础部分的配置对象\n */\nexport function createBaseConfig(): IProjectConfig {\n  return {\n    designWidth: 750,\n    deviceRatio: {\n      640: 2.34 / 2,\n      750: 1,\n      375: 2,\n      828: 1.81 / 2,\n    },\n    sourceRoot: 'src',\n    outputRoot: 'dist',\n    copy: {\n      patterns: [],\n      options: {},\n    },\n    framework: 'react',\n    compiler: {\n      type: 'webpack5',\n    },\n    cache: {\n      enable: true,\n    },\n    defineConstants: {\n      /**\n       * 应用版本号，构建期从消费方 package.json 读取并静态注入，\n       * 运行时代码通过 APP_VERSION 访问\n       */\n      APP_VERSION: JSON.stringify(readAppVersion()),\n    },\n    mini: {\n      postcss: {\n        pxtransform: {\n          enable: true,\n          config: {},\n        },\n        cssModules: {\n          enable: false,\n          config: {\n            namingPattern: 'module',\n            generateScopedName: '[name]__[local]___[hash:base64:5]',\n          },\n        },\n      },\n    },\n    h5: {\n      publicPath: '/',\n      staticDirectory: 'static',\n      postcss: {\n        autoprefixer: {\n          enable: true,\n          config: {},\n        },\n        cssModules: {\n          enable: false,\n          config: {\n            namingPattern: 'module',\n            generateScopedName: '[name]__[local]___[hash:base64:5]',\n          },\n        },\n      },\n    },\n    alias: {\n      '@': path.resolve(process.cwd(), 'src'),\n    },\n  };\n}\n"]}

package/dist/define.config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Taro miniprogram 配置定义
+ *
+ * 在 @tarojs/cli 的 defineConfig 之上提供 LZI 公共 base 预设：
+ * - 传入对象：自动与 base 预设、dev/prod 预设深合并（消费方字段覆盖预设），返回完整配置
+ * - 传入回调：透传给 @tarojs/cli 原生 defineConfig，消费方在回调内自行用 createBaseConfig 等
+ * 预设组装，完全掌控动态逻辑（版本注入、环境变量、缓存隔离等）
+ *
+ * 两种形态的 base 始终是预设而非锁定——消费方任何字段都可覆盖。
+ */
+import type { IProjectConfig } from '@tarojs/taro/types/compile';
+import { type UserConfigExport, type UserConfigFn } from '@tarojs/cli';
+/**
+ * miniprogram 配置定义
+ *
+ * @example
+ *   对象形态（自动注入 base 预设）
+ *   ```ts
+ *   import { defineConfig } from '@longzai-intelligence-taro/config';
+ *   export default defineConfig({ projectName: 'longzai-intelligence-foo-miniprogram' });
+ *   ```
+ *
+ * @example
+ *   回调形态（消费方完全掌控，base 预设作起点）
+ *   ```ts
+ *   import { createBaseConfig, defineConfig } from '@longzai-intelligence-taro/config';
+ *   export default defineConfig(async (merge) => {
+ *   return merge({}, createBaseConfig(), { /* 项目专属动态配置 *\/ });
+ *   });
+ *   ```
+ *
+ * @param config - 静态配置对象（与 base 预设深合并，同名字段以本参数为准），或
+ *   回调函数（透传 @tarojs/cli 原生 defineConfig，回调内自由组装）
+ * @returns 可直接 `export default` 的 UserConfigExport
+ */
+export declare function defineConfig(config: Partial<IProjectConfig> | UserConfigFn): UserConfigExport;
+//# sourceMappingURL=define.config.d.ts.map

package/dist/define.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.config.d.ts","sourceRoot":"","sources":["../src/define.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAerB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,YAAY,GAAG,gBAAgB,CAuB7F","sourcesContent":["/**\n * Taro miniprogram 配置定义\n *\n * 在 @tarojs/cli 的 defineConfig 之上提供 LZI 公共 base 预设：\n * - 传入对象：自动与 base 预设、dev/prod 预设深合并（消费方字段覆盖预设），返回完整配置\n * - 传入回调：透传给 @tarojs/cli 原生 defineConfig，消费方在回调内自行用 createBaseConfig 等\n * 预设组装，完全掌控动态逻辑（版本注入、环境变量、缓存隔离等）\n *\n * 两种形态的 base 始终是预设而非锁定——消费方任何字段都可覆盖。\n */\n\nimport type { IProjectConfig } from '@tarojs/taro/types/compile';\n\nimport {\n  defineConfig as defineTaroConfig,\n  type UserConfigExport,\n  type UserConfigFn,\n} from '@tarojs/cli';\n\nimport { createBaseConfig } from './base.config.js';\nimport { devPreset, prodPreset } from './presets.js';\n\n/**\n * 判断入参是否为回调形态（类型守卫，替代 as 断言）\n *\n * @param config - defineConfig 入参\n * @returns 是否为函数（回调形态）\n */\nfunction isUserConfigFn(config: Partial<IProjectConfig> | UserConfigFn): config is UserConfigFn {\n  return typeof config === 'function';\n}\n\n/**\n * miniprogram 配置定义\n *\n * @example\n *   对象形态（自动注入 base 预设）\n *   ```ts\n *   import { defineConfig } from '@longzai-intelligence-taro/config';\n *   export default defineConfig({ projectName: 'longzai-intelligence-foo-miniprogram' });\n *   ```\n *\n * @example\n *   回调形态（消费方完全掌控，base 预设作起点）\n *   ```ts\n *   import { createBaseConfig, defineConfig } from '@longzai-intelligence-taro/config';\n *   export default defineConfig(async (merge) => {\n *   return merge({}, createBaseConfig(), { /* 项目专属动态配置 *\\/ });\n *   });\n *   ```\n *\n * @param config - 静态配置对象（与 base 预设深合并，同名字段以本参数为准），或\n *   回调函数（透传 @tarojs/cli 原生 defineConfig，回调内自由组装）\n * @returns 可直接 `export default` 的 UserConfigExport\n */\nexport function defineConfig(config: Partial<IProjectConfig> | UserConfigFn): UserConfigExport {\n  if (isUserConfigFn(config)) {\n    return defineTaroConfig(config);\n  }\n\n  /**\n   * 消费方项目专属配置（静态对象形态）\n   */\n  const projectConfig = config;\n\n  return defineTaroConfig(async (merge) => {\n    /**\n     * LZI 公共基础配置预设\n     */\n    const base = createBaseConfig();\n\n    /**\n     * 按 NODE_ENV 选取的环境预设\n     */\n    const envPreset = process.env.NODE_ENV === 'development' ? devPreset : prodPreset;\n\n    return merge({}, base, envPreset, projectConfig);\n  });\n}\n"]}

package/dist/define.config.js

@@ -0,0 +1,66 @@
+/**
+ * Taro miniprogram 配置定义
+ *
+ * 在 @tarojs/cli 的 defineConfig 之上提供 LZI 公共 base 预设：
+ * - 传入对象：自动与 base 预设、dev/prod 预设深合并（消费方字段覆盖预设），返回完整配置
+ * - 传入回调：透传给 @tarojs/cli 原生 defineConfig，消费方在回调内自行用 createBaseConfig 等
+ * 预设组装，完全掌控动态逻辑（版本注入、环境变量、缓存隔离等）
+ *
+ * 两种形态的 base 始终是预设而非锁定——消费方任何字段都可覆盖。
+ */
+import { defineConfig as defineTaroConfig, } from '@tarojs/cli';
+import { createBaseConfig } from './base.config.js';
+import { devPreset, prodPreset } from './presets.js';
+/**
+ * 判断入参是否为回调形态（类型守卫，替代 as 断言）
+ *
+ * @param config - defineConfig 入参
+ * @returns 是否为函数（回调形态）
+ */
+function isUserConfigFn(config) {
+    return typeof config === 'function';
+}
+/**
+ * miniprogram 配置定义
+ *
+ * @example
+ *   对象形态（自动注入 base 预设）
+ *   ```ts
+ *   import { defineConfig } from '@longzai-intelligence-taro/config';
+ *   export default defineConfig({ projectName: 'longzai-intelligence-foo-miniprogram' });
+ *   ```
+ *
+ * @example
+ *   回调形态（消费方完全掌控，base 预设作起点）
+ *   ```ts
+ *   import { createBaseConfig, defineConfig } from '@longzai-intelligence-taro/config';
+ *   export default defineConfig(async (merge) => {
+ *   return merge({}, createBaseConfig(), { /* 项目专属动态配置 *\/ });
+ *   });
+ *   ```
+ *
+ * @param config - 静态配置对象（与 base 预设深合并，同名字段以本参数为准），或
+ *   回调函数（透传 @tarojs/cli 原生 defineConfig，回调内自由组装）
+ * @returns 可直接 `export default` 的 UserConfigExport
+ */
+export function defineConfig(config) {
+    if (isUserConfigFn(config)) {
+        return defineTaroConfig(config);
+    }
+    /**
+     * 消费方项目专属配置（静态对象形态）
+     */
+    const projectConfig = config;
+    return defineTaroConfig(async (merge) => {
+        /**
+         * LZI 公共基础配置预设
+         */
+        const base = createBaseConfig();
+        /**
+         * 按 NODE_ENV 选取的环境预设
+         */
+        const envPreset = process.env.NODE_ENV === 'development' ? devPreset : prodPreset;
+        return merge({}, base, envPreset, projectConfig);
+    });
+}
+//# sourceMappingURL=define.config.js.map

package/dist/define.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.config.js","sourceRoot":"","sources":["../src/define.config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,YAAY,IAAI,gBAAgB,GAGjC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,SAAS,cAAc,CAAC,MAA8C;IACpE,OAAO,OAAO,MAAM,KAAK,UAAU,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,YAAY,CAAC,MAA8C;IACzE,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM,aAAa,GAAG,MAAM,CAAC;IAE7B,OAAO,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACtC;;WAEG;QACH,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;QAEhC;;WAEG;QACH,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAElF,OAAO,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Taro miniprogram 配置定义\n *\n * 在 @tarojs/cli 的 defineConfig 之上提供 LZI 公共 base 预设：\n * - 传入对象：自动与 base 预设、dev/prod 预设深合并（消费方字段覆盖预设），返回完整配置\n * - 传入回调：透传给 @tarojs/cli 原生 defineConfig，消费方在回调内自行用 createBaseConfig 等\n * 预设组装，完全掌控动态逻辑（版本注入、环境变量、缓存隔离等）\n *\n * 两种形态的 base 始终是预设而非锁定——消费方任何字段都可覆盖。\n */\n\nimport type { IProjectConfig } from '@tarojs/taro/types/compile';\n\nimport {\n  defineConfig as defineTaroConfig,\n  type UserConfigExport,\n  type UserConfigFn,\n} from '@tarojs/cli';\n\nimport { createBaseConfig } from './base.config.js';\nimport { devPreset, prodPreset } from './presets.js';\n\n/**\n * 判断入参是否为回调形态（类型守卫，替代 as 断言）\n *\n * @param config - defineConfig 入参\n * @returns 是否为函数（回调形态）\n */\nfunction isUserConfigFn(config: Partial<IProjectConfig> | UserConfigFn): config is UserConfigFn {\n  return typeof config === 'function';\n}\n\n/**\n * miniprogram 配置定义\n *\n * @example\n *   对象形态（自动注入 base 预设）\n *   ```ts\n *   import { defineConfig } from '@longzai-intelligence-taro/config';\n *   export default defineConfig({ projectName: 'longzai-intelligence-foo-miniprogram' });\n *   ```\n *\n * @example\n *   回调形态（消费方完全掌控，base 预设作起点）\n *   ```ts\n *   import { createBaseConfig, defineConfig } from '@longzai-intelligence-taro/config';\n *   export default defineConfig(async (merge) => {\n *   return merge({}, createBaseConfig(), { /* 项目专属动态配置 *\\/ });\n *   });\n *   ```\n *\n * @param config - 静态配置对象（与 base 预设深合并，同名字段以本参数为准），或\n *   回调函数（透传 @tarojs/cli 原生 defineConfig，回调内自由组装）\n * @returns 可直接 `export default` 的 UserConfigExport\n */\nexport function defineConfig(config: Partial<IProjectConfig> | UserConfigFn): UserConfigExport {\n  if (isUserConfigFn(config)) {\n    return defineTaroConfig(config);\n  }\n\n  /**\n   * 消费方项目专属配置（静态对象形态）\n   */\n  const projectConfig = config;\n\n  return defineTaroConfig(async (merge) => {\n    /**\n     * LZI 公共基础配置预设\n     */\n    const base = createBaseConfig();\n\n    /**\n     * 按 NODE_ENV 选取的环境预设\n     */\n    const envPreset = process.env.NODE_ENV === 'development' ? devPreset : prodPreset;\n\n    return merge({}, base, envPreset, projectConfig);\n  });\n}\n"]}

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 /**
- * Taro 构建配置封装
+ * Taro 构建配置封装入口
  *
- * @description 对 `@tarojs/cli` 的 `defineConfig` / `UserConfigExport` 做一层 re-export，
- * 放宽泛型约束（允许消费方传入 `'taro'` 等自定义编译器标识），统一 miniprogram 的配置入口。
+ * 导出预置 LZI 公共基础配置的 defineConfig，以及 base/preset 构建块，
+ * 消除各项目 miniprogram config 三件套的重复样板。用法与 @tarojs/cli 的 defineConfig 一致。
  */
-export { defineConfig, type ConfigEnv, type UserConfigExport, type UserConfigFn, } from '@tarojs/cli';
+export type { ConfigEnv, UserConfigExport, UserConfigFn } from '@tarojs/cli';
+export { defineConfig } from './define.config.js';
+export { createBaseConfig } from './base.config.js';
+export { readAppVersion } from './version.utils.js';
+export { devPreset, prodPreset } from './presets.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC","sourcesContent":["/**\n * Taro 构建配置封装\n *\n * @description 对 `@tarojs/cli` 的 `defineConfig` / `UserConfigExport` 做一层 re-export，\n * 放宽泛型约束（允许消费方传入 `'taro'` 等自定义编译器标识），统一 miniprogram 的配置入口。\n */\n\nexport {\n  defineConfig,\n  type ConfigEnv,\n  type UserConfigExport,\n  type UserConfigFn,\n} from '@tarojs/cli';\n"]}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Taro 构建配置封装入口\n *\n * 导出预置 LZI 公共基础配置的 defineConfig，以及 base/preset 构建块，\n * 消除各项目 miniprogram config 三件套的重复样板。用法与 @tarojs/cli 的 defineConfig 一致。\n */\n\nexport type { ConfigEnv, UserConfigExport, UserConfigFn } from '@tarojs/cli';\n\nexport { defineConfig } from './define.config.js';\n\nexport { createBaseConfig } from './base.config.js';\n\nexport { readAppVersion } from './version.utils.js';\n\nexport { devPreset, prodPreset } from './presets.js';\n"]}

package/dist/index.js

@@ -1,8 +1,11 @@
 /**
- * Taro 构建配置封装
+ * Taro 构建配置封装入口
  *
- * @description 对 `@tarojs/cli` 的 `defineConfig` / `UserConfigExport` 做一层 re-export，
- * 放宽泛型约束（允许消费方传入 `'taro'` 等自定义编译器标识），统一 miniprogram 的配置入口。
+ * 导出预置 LZI 公共基础配置的 defineConfig，以及 base/preset 构建块，
+ * 消除各项目 miniprogram config 三件套的重复样板。用法与 @tarojs/cli 的 defineConfig 一致。
  */
-export { defineConfig, } from '@tarojs/cli';
+export { defineConfig } from './define.config.js';
+export { createBaseConfig } from './base.config.js';
+export { readAppVersion } from './version.utils.js';
+export { devPreset, prodPreset } from './presets.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,GAIb,MAAM,aAAa,CAAC","sourcesContent":["/**\n * Taro 构建配置封装\n *\n * @description 对 `@tarojs/cli` 的 `defineConfig` / `UserConfigExport` 做一层 re-export，\n * 放宽泛型约束（允许消费方传入 `'taro'` 等自定义编译器标识），统一 miniprogram 的配置入口。\n */\n\nexport {\n  defineConfig,\n  type ConfigEnv,\n  type UserConfigExport,\n  type UserConfigFn,\n} from '@tarojs/cli';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Taro 构建配置封装入口\n *\n * 导出预置 LZI 公共基础配置的 defineConfig，以及 base/preset 构建块，\n * 消除各项目 miniprogram config 三件套的重复样板。用法与 @tarojs/cli 的 defineConfig 一致。\n */\n\nexport type { ConfigEnv, UserConfigExport, UserConfigFn } from '@tarojs/cli';\n\nexport { defineConfig } from './define.config.js';\n\nexport { createBaseConfig } from './base.config.js';\n\nexport { readAppVersion } from './version.utils.js';\n\nexport { devPreset, prodPreset } from './presets.js';\n"]}

package/dist/presets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Taro 开发/生产环境预设配置
+ *
+ * 替代原 miniprogram 中 `config/dev.ts`、`config/prod.ts` 通过 `import devConfig from '../dev'`
+ * 引用的死引用（项目根 dev.ts/prod.ts 实际不存在）。此预设提供 merge 用的标准环境覆盖项。
+ */
+import type { IProjectConfig } from '@tarojs/taro/types/compile';
+/**
+ * 开发环境预设：开启日志输出
+ */
+export declare const devPreset: Partial<IProjectConfig>;
+/**
+ * 生产环境预设：关闭日志输出
+ */
+export declare const prodPreset: Partial<IProjectConfig>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,cAAc,CAO7C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,cAAc,CAO9C,CAAC","sourcesContent":["/**\n * Taro 开发/生产环境预设配置\n *\n * 替代原 miniprogram 中 `config/dev.ts`、`config/prod.ts` 通过 `import devConfig from '../dev'`\n * 引用的死引用（项目根 dev.ts/prod.ts 实际不存在）。此预设提供 merge 用的标准环境覆盖项。\n */\n\nimport type { IProjectConfig } from '@tarojs/taro/types/compile';\n\n/**\n * 开发环境预设：开启日志输出\n */\nexport const devPreset: Partial<IProjectConfig> = {\n  logger: {\n    quiet: false,\n    stats: true,\n  },\n  mini: {},\n  h5: {},\n};\n\n/**\n * 生产环境预设：关闭日志输出\n */\nexport const prodPreset: Partial<IProjectConfig> = {\n  logger: {\n    quiet: false,\n    stats: false,\n  },\n  mini: {},\n  h5: {},\n};\n"]}

package/dist/presets.js

@@ -0,0 +1,29 @@
+/**
+ * Taro 开发/生产环境预设配置
+ *
+ * 替代原 miniprogram 中 `config/dev.ts`、`config/prod.ts` 通过 `import devConfig from '../dev'`
+ * 引用的死引用（项目根 dev.ts/prod.ts 实际不存在）。此预设提供 merge 用的标准环境覆盖项。
+ */
+/**
+ * 开发环境预设：开启日志输出
+ */
+export const devPreset = {
+    logger: {
+        quiet: false,
+        stats: true,
+    },
+    mini: {},
+    h5: {},
+};
+/**
+ * 生产环境预设：关闭日志输出
+ */
+export const prodPreset = {
+    logger: {
+        quiet: false,
+        stats: false,
+    },
+    mini: {},
+    h5: {},
+};
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAA4B;IAChD,MAAM,EAAE;QACN,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,IAAI;KACZ;IACD,IAAI,EAAE,EAAE;IACR,EAAE,EAAE,EAAE;CACP,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAA4B;IACjD,MAAM,EAAE;QACN,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;KACb;IACD,IAAI,EAAE,EAAE;IACR,EAAE,EAAE,EAAE;CACP,CAAC","sourcesContent":["/**\n * Taro 开发/生产环境预设配置\n *\n * 替代原 miniprogram 中 `config/dev.ts`、`config/prod.ts` 通过 `import devConfig from '../dev'`\n * 引用的死引用（项目根 dev.ts/prod.ts 实际不存在）。此预设提供 merge 用的标准环境覆盖项。\n */\n\nimport type { IProjectConfig } from '@tarojs/taro/types/compile';\n\n/**\n * 开发环境预设：开启日志输出\n */\nexport const devPreset: Partial<IProjectConfig> = {\n  logger: {\n    quiet: false,\n    stats: true,\n  },\n  mini: {},\n  h5: {},\n};\n\n/**\n * 生产环境预设：关闭日志输出\n */\nexport const prodPreset: Partial<IProjectConfig> = {\n  logger: {\n    quiet: false,\n    stats: false,\n  },\n  mini: {},\n  h5: {},\n};\n"]}

package/dist/version.utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 应用版本元信息读取
+ *
+ * 构建期从消费方 miniprogram 的 package.json 读取 version，
+ * 供 defineConstants 注入运行时 APP_VERSION。与 Taro 构建配置骨架分离。
+ */
+/**
+ * 读取消费方 miniprogram 的 package.json 并提取 version
+ *
+ * Taro 在 miniprogram 目录执行构建，process.cwd() 即该目录；
+ * 读取其 package.json 的 version 字段。
+ *
+ * @returns 应用版本号
+ * @throws {@link Error} package.json 缺失 version 字段或解析失败时抛出
+ */
+export declare function readAppVersion(): string;
+//# sourceMappingURL=version.utils.d.ts.map

package/dist/version.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.utils.d.ts","sourceRoot":"","sources":["../src/version.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmCH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAoBvC","sourcesContent":["/**\n * 应用版本元信息读取\n *\n * 构建期从消费方 miniprogram 的 package.json 读取 version，\n * 供 defineConstants 注入运行时 APP_VERSION。与 Taro 构建配置骨架分离。\n */\n\nimport { readFileSync } from 'node:fs';\nimport path from 'node:path';\n\n/**\n * 判断值是否为非空字符串\n *\n * @param value - 待判断的值\n * @returns 是否为长度大于 0 的字符串\n */\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * 从未知结构中安全取出 version 字段（类型守卫，无 as 断言）\n *\n * @param parsed - JSON.parse 的结果\n * @returns version 值（无法判定时为 undefined）\n */\nfunction extractVersion(parsed: unknown): unknown {\n  if (typeof parsed !== 'object' || parsed === null) {\n    return undefined;\n  }\n\n  /**\n   * 按键取值，in 操作符天然收窄对象类型，无需断言\n   */\n  if ('version' in parsed) {\n    return parsed.version;\n  }\n  return undefined;\n}\n\n/**\n * 读取消费方 miniprogram 的 package.json 并提取 version\n *\n * Taro 在 miniprogram 目录执行构建，process.cwd() 即该目录；\n * 读取其 package.json 的 version 字段。\n *\n * @returns 应用版本号\n * @throws {@link Error} package.json 缺失 version 字段或解析失败时抛出\n */\nexport function readAppVersion(): string {\n  /**\n   * package.json 文件绝对路径\n   */\n  const pkgPath = path.resolve(process.cwd(), 'package.json');\n\n  /**\n   * package.json 解析结果\n   */\n  const parsed: unknown = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n\n  /**\n   * 待校验的 version 值（从解析结果按结构取出）\n   */\n  const versionCandidate = extractVersion(parsed);\n\n  if (!isNonEmptyString(versionCandidate)) {\n    throw new Error(`package.json 缺失 version 字段: ${pkgPath}`);\n  }\n  return versionCandidate;\n}\n"]}

package/dist/version.utils.js

@@ -0,0 +1,63 @@
+/**
+ * 应用版本元信息读取
+ *
+ * 构建期从消费方 miniprogram 的 package.json 读取 version，
+ * 供 defineConstants 注入运行时 APP_VERSION。与 Taro 构建配置骨架分离。
+ */
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * 判断值是否为非空字符串
+ *
+ * @param value - 待判断的值
+ * @returns 是否为长度大于 0 的字符串
+ */
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+/**
+ * 从未知结构中安全取出 version 字段（类型守卫，无 as 断言）
+ *
+ * @param parsed - JSON.parse 的结果
+ * @returns version 值（无法判定时为 undefined）
+ */
+function extractVersion(parsed) {
+    if (typeof parsed !== 'object' || parsed === null) {
+        return undefined;
+    }
+    /**
+     * 按键取值，in 操作符天然收窄对象类型，无需断言
+     */
+    if ('version' in parsed) {
+        return parsed.version;
+    }
+    return undefined;
+}
+/**
+ * 读取消费方 miniprogram 的 package.json 并提取 version
+ *
+ * Taro 在 miniprogram 目录执行构建，process.cwd() 即该目录；
+ * 读取其 package.json 的 version 字段。
+ *
+ * @returns 应用版本号
+ * @throws {@link Error} package.json 缺失 version 字段或解析失败时抛出
+ */
+export function readAppVersion() {
+    /**
+     * package.json 文件绝对路径
+     */
+    const pkgPath = path.resolve(process.cwd(), 'package.json');
+    /**
+     * package.json 解析结果
+     */
+    const parsed = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    /**
+     * 待校验的 version 值（从解析结果按结构取出）
+     */
+    const versionCandidate = extractVersion(parsed);
+    if (!isNonEmptyString(versionCandidate)) {
+        throw new Error(`package.json 缺失 version 字段: ${pkgPath}`);
+    }
+    return versionCandidate;
+}
+//# sourceMappingURL=version.utils.js.map

package/dist/version.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.utils.js","sourceRoot":"","sources":["../src/version.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,MAAe;IACrC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B;;OAEG;IACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAE5D;;OAEG;IACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnE;;OAEG;IACH,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC","sourcesContent":["/**\n * 应用版本元信息读取\n *\n * 构建期从消费方 miniprogram 的 package.json 读取 version，\n * 供 defineConstants 注入运行时 APP_VERSION。与 Taro 构建配置骨架分离。\n */\n\nimport { readFileSync } from 'node:fs';\nimport path from 'node:path';\n\n/**\n * 判断值是否为非空字符串\n *\n * @param value - 待判断的值\n * @returns 是否为长度大于 0 的字符串\n */\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * 从未知结构中安全取出 version 字段（类型守卫，无 as 断言）\n *\n * @param parsed - JSON.parse 的结果\n * @returns version 值（无法判定时为 undefined）\n */\nfunction extractVersion(parsed: unknown): unknown {\n  if (typeof parsed !== 'object' || parsed === null) {\n    return undefined;\n  }\n\n  /**\n   * 按键取值，in 操作符天然收窄对象类型，无需断言\n   */\n  if ('version' in parsed) {\n    return parsed.version;\n  }\n  return undefined;\n}\n\n/**\n * 读取消费方 miniprogram 的 package.json 并提取 version\n *\n * Taro 在 miniprogram 目录执行构建，process.cwd() 即该目录；\n * 读取其 package.json 的 version 字段。\n *\n * @returns 应用版本号\n * @throws {@link Error} package.json 缺失 version 字段或解析失败时抛出\n */\nexport function readAppVersion(): string {\n  /**\n   * package.json 文件绝对路径\n   */\n  const pkgPath = path.resolve(process.cwd(), 'package.json');\n\n  /**\n   * package.json 解析结果\n   */\n  const parsed: unknown = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n\n  /**\n   * 待校验的 version 值（从解析结果按结构取出）\n   */\n  const versionCandidate = extractVersion(parsed);\n\n  if (!isNonEmptyString(versionCandidate)) {\n    throw new Error(`package.json 缺失 version 字段: ${pkgPath}`);\n  }\n  return versionCandidate;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence-taro/config",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Taro 构建配置封装 - re-export @tarojs/cli 的 defineConfig 与类型",
   "keywords": [
     "config",
@@ -9,6 +9,10 @@
     "taroutils"
   ],
   "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,21 +22,19 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
   "scripts": {
     "build": "tsgo --build tsconfig/build.json --force",
     "build:prod": "bun run build",
     "typecheck": "tsgo --noEmit -p tsconfig/app.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
     "prepublishOnly": "bun run build:prod",
     "clean": "lzi-dev-cli clean"
   },
-  "peerDependencies": {
+  "devDependencies": {
     "@tarojs/cli": "^4.0.0"
   },
-  "devDependencies": {
+  "peerDependencies": {
     "@tarojs/cli": "^4.0.0"
   }
 }