@gientech/modual 2.0.5 → 2.0.7

package/README.md

@@ -8,6 +8,8 @@ Gientech 多模块集成包，提供聊天、数据库、文件预览等业务
 npm install @gientech/modual
 ```
 
+**⚠️ 安装问题？** 如果使用 Yarn 安装时遇到 hoisting 错误，请查看 [安装故障排除指南](./INSTALL_TROUBLESHOOTING.md)。
+
 ## 🏗️ 打包逻辑
 
 ### 多入口打包架构
@@ -638,6 +640,122 @@ npm install styled-components@^6.1.19 --save
 
 **注意**：这个警告通常不会影响功能，但会增加 bundle 大小。建议修复。
 
+### Q: Yarn 安装时报错 "Invariant Violation: expected hoisted manifest"
+
+**错误信息**：
+```
+error Invariant Violation: expected hoisted manifest for "@gientech/modual#@mxmweb/zui-components#@mxmweb/zui-elements"
+```
+
+**原因**：这是因为 `@mxmweb/zui-components` 和 `@mxmweb/zui-elements` 同时出现在 `dependencies` 和 `peerDependencies` 中，导致 Yarn 的 hoisting 算法无法正确解析依赖关系。
+
+**解决方案**（用户端，无需修改包配置）：
+
+#### 方案一：使用 `resolutions` 强制版本（推荐，适用于 Yarn）
+
+在用户项目的 `package.json` 中添加 `resolutions` 字段：
+
+```json
+{
+  "resolutions": {
+    "@mxmweb/zui-components": "1.2.5",
+    "@mxmweb/zui-elements": "1.1.5",
+    "@mxmweb/zui-icons": "1.2.2",
+    "@mxmweb/zui-layouts": "1.3.1",
+    "@mxmweb/zui-theme": "2.1.5"
+  }
+}
+```
+
+然后重新安装：
+
+```bash
+yarn install
+```
+
+#### 方案二：使用 `.yarnrc.yml` 配置（适用于 Yarn 2+ / Berry）
+
+在项目根目录创建或修改 `.yarnrc.yml` 文件：
+
+```yaml
+nodeLinker: node-modules
+
+packageExtensions:
+  "@gientech/modual@*":
+    peerDependencies:
+      "@mxmweb/zui-components": "*"
+      "@mxmweb/zui-elements": "*"
+```
+
+然后重新安装：
+
+```bash
+yarn install
+```
+
+#### 方案三：使用 npm 或 pnpm（推荐）
+
+如果使用 Yarn 遇到问题，可以切换到 npm 或 pnpm：
+
+```bash
+# 使用 npm
+npm install @gientech/modual
+
+# 或使用 pnpm
+pnpm install @gientech/modual
+```
+
+#### 方案四：手动安装 peerDependencies
+
+先安装 `@gientech/modual` 的 peerDependencies，然后再安装包本身：
+
+```bash
+# 先安装 peerDependencies
+yarn add @mxmweb/zui-components@1.2.5 \
+         @mxmweb/zui-elements@1.1.5 \
+         @mxmweb/zui-icons@1.2.2 \
+         @mxmweb/zui-layouts@1.3.1 \
+         @mxmweb/zui-theme@2.1.5
+
+# 再安装 @gientech/modual
+yarn add @gientech/modual
+```
+
+#### 方案五：使用 `--ignore-scripts` 和手动安装
+
+```bash
+# 先清理
+rm -rf node_modules yarn.lock
+
+# 使用 --ignore-scripts 安装
+yarn install --ignore-scripts
+
+# 手动安装缺失的依赖
+yarn add @mxmweb/zui-components@1.2.5 \
+         @mxmweb/zui-elements@1.1.5 \
+         @mxmweb/zui-icons@1.2.2 \
+         @mxmweb/zui-layouts@1.3.1 \
+         @mxmweb/zui-theme@2.1.5
+```
+
+**推荐方案**：
+
+- **Yarn 1.x**：使用方案一（`resolutions`）
+- **Yarn 2+ / Berry**：使用方案二（`.yarnrc.yml`）
+- **新项目**：使用方案三（npm 或 pnpm）
+
+**验证安装**：
+
+安装完成后，验证依赖是否正确：
+
+```bash
+# 检查依赖树
+yarn list --pattern "@mxmweb/zui-*"
+
+# 或使用 npm
+npm ls @mxmweb/zui-components @mxmweb/zui-elements
+```
+
 ## 📄 许可证
 
 MIT

package/{dist/assets/GientechStreamReader-DUCq-O5X.js → assets/GientechStreamReader-Dx72IaEx.js}

@@ -1,4 +1,4 @@
-var zn=Object.defineProperty;var Sn=m=>{throw TypeError(m)};var Gn=(m,a,A)=>a in m?zn(m,a,{enumerable:!0,configurable:!0,writable:!0,value:A}):m[a]=A;var ee=(m,a,A)=>Gn(m,typeof a!="symbol"?a+"":a,A),an=(m,a,A)=>a.has(m)||Sn("Cannot "+A);var R=(m,a,A)=>(an(m,a,"read from private field"),A?A.call(m):a.get(m)),Ot=(m,a,A)=>a.has(m)?Sn("Cannot add the same private member more than once"):a instanceof WeakSet?a.add(m):a.set(m,A),It=(m,a,A,f)=>(an(m,a,"write to private field"),f?f.call(m,A):a.set(m,A),A),Dt=(m,a,A)=>(an(m,a,"access private method"),A);var on=(m,a,A,f)=>({set _(_){It(m,a,_,A)},get _(){return R(m,a,f)}});import{jsxs,jsx,Fragment}from"react/jsx-runtime";import React__default,{forwardRef,createElement,useState,useRef,useEffect,useCallback,useMemo}from"react";import{a as createLucideIcon,a7 as getAugmentedNamespace,d as dt$1,b as axios}from"./index-g-SUxfJH.js";import{j as j6,X as Xs}from"./index-KCfkkJKb.js";import{c as ChevronRight}from"./index-B2yNvzjy.js";import{X}from"./x-CnaaLGJF.js";/**
+var zn=Object.defineProperty;var Sn=m=>{throw TypeError(m)};var Gn=(m,a,A)=>a in m?zn(m,a,{enumerable:!0,configurable:!0,writable:!0,value:A}):m[a]=A;var ee=(m,a,A)=>Gn(m,typeof a!="symbol"?a+"":a,A),an=(m,a,A)=>a.has(m)||Sn("Cannot "+A);var R=(m,a,A)=>(an(m,a,"read from private field"),A?A.call(m):a.get(m)),Ot=(m,a,A)=>a.has(m)?Sn("Cannot add the same private member more than once"):a instanceof WeakSet?a.add(m):a.set(m,A),It=(m,a,A,f)=>(an(m,a,"write to private field"),f?f.call(m,A):a.set(m,A),A),Dt=(m,a,A)=>(an(m,a,"access private method"),A);var on=(m,a,A,f)=>({set _(_){It(m,a,_,A)},get _(){return R(m,a,f)}});import{jsxs,jsx,Fragment}from"react/jsx-runtime";import React__default,{forwardRef,createElement,useState,useRef,useEffect,useCallback,useMemo}from"react";import{a as createLucideIcon,a7 as getAugmentedNamespace,d as dt$1,b as axios}from"./index-g-SUxfJH.js";import{j as j6,X as Xs}from"./index-D4pXe94o.js";import{c as ChevronRight}from"./index-B2yNvzjy.js";import{X}from"./x-CnaaLGJF.js";/**
  * @license lucide-react v0.456.0 - ISC
  *
  * This source code is licensed under the ISC license.

package/{dist/assets/index-QI9biQrR.js → assets/index-BbNz3Zrz.js}

@@ -1,4 +1,4 @@
-import{jsx as a,jsxs as O,Fragment as he}from"react/jsx-runtime";import*as j from"react";import{isValidElement as $e,useMemo as ie,useState as h,useRef as Ce,useCallback as ue,useEffect as xe}from"react";import{u as Ve}from"./index-CpW6Dhpp.js";import{F as Pe,J as K,C as Re,T as je,U as We,m as Ue}from"./index-B2yNvzjy.js";import{a as He,g as Ge,m as Ze,$ as qe,a0 as Ye,r as Ke,a1 as Xe,a2 as Je,a3 as Qe,l as et,f as le,a4 as tt,u as ut,a5 as at,T as ce,Z as st,o as ot,M as nt,b as rt,a6 as it,i as be}from"./index-g-SUxfJH.js";import{O as we}from"./index-ZopkeZtI.js";/* empty css              */import{s as Y,M as ye}from"./style-CGmZ5osp.js";import{I as ke}from"./index-KCfkkJKb.js";import{D as Ie}from"./index-D72cKELw.js";import{X as ge}from"./x-CnaaLGJF.js";import"react-dom";import{B as De,T as Te}from"./index-DdVFXD_y.js";/**
+import{jsx as a,jsxs as O,Fragment as he}from"react/jsx-runtime";import*as j from"react";import{isValidElement as $e,useMemo as ie,useState as h,useRef as Ce,useCallback as ue,useEffect as xe}from"react";import{u as Ve}from"./index-CpW6Dhpp.js";import{F as Pe,J as K,C as Re,T as je,U as We,m as Ue}from"./index-B2yNvzjy.js";import{a as He,g as Ge,m as Ze,$ as qe,a0 as Ye,r as Ke,a1 as Xe,a2 as Je,a3 as Qe,l as et,f as le,a4 as tt,u as ut,a5 as at,T as ce,Z as st,o as ot,M as nt,b as rt,a6 as it,i as be}from"./index-g-SUxfJH.js";import{O as we}from"./index-ZopkeZtI.js";/* empty css              */import{s as Y,M as ye}from"./style-CGmZ5osp.js";import{I as ke}from"./index-D4pXe94o.js";import{D as Ie}from"./index-D72cKELw.js";import{X as ge}from"./x-CnaaLGJF.js";import"react-dom";import{B as De,T as Te}from"./index-DdVFXD_y.js";/**
  * @license lucide-react v0.456.0 - ISC
  *
  * This source code is licensed under the ISC license.