@udi-organization/udi-package 1.0.76 → 1.0.78

package/README.md

@@ -1,472 +1,312 @@
 # @udi-organization/udi-package
 
-> 基於 React 的 UI 組件庫，提供 UdiTable、Button 等可重用組件，支持 ESM 和 CommonJS 模組格式
+[![npm version](https://img.shields.io/npm/v/@udi-organization/udi-package)](https://www.npmjs.com/package/@udi-organization/udi-package)
 
-[![npm version](https://img.shields.io/npm/v/@udi-organization/udi-package.svg)](https://www.npmjs.com/package/@udi-organization/udi-package)
-[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+UDI 共用元件套件，供各前端專案（client）使用。
 
-## 📦 套件資訊
-
-- **套件名稱**: `@udi-organization/udi-package`
-- **發布平台**: [npm Registry](https://www.npmjs.com/package/@udi-organization/udi-package)
-- **倉庫位置**: [GitLab](https://gitlab.com/udi3732104/udi-package/-/tree/main?ref_type=heads)
-
-## 🎯 核心特性
-
-- **集中管理**: 統一維護跨專案共用的 Component 與 Utils Function
-- **提升效率**: 避免重複開發，加速專案迭代
-- **自動化發布**: 透過 GitLab CI/CD 實現自動化版本管理與發布
-- **雙模式開發**: 支援正常模式與 Link 模式，滿足不同開發場景
-- **完整測試**: 使用 Jest 進行單元測試，確保代碼品質
+---
 
-## 📋 目錄
+## 目錄
 
-- [快速開始](#快速開始)
+- [元件使用指南](#元件使用指南)
+  - [UdiTable](#uditable)
+  - [useUdiTableSync（兩表格同步）](#useuditable sync兩表格同步)
+  - [useUdiTableSyncMutipleTable（多表格同步）](#useuditablesyncmutipletable多表格同步)
 - [專案結構](#專案結構)
-- [環境設定](#環境設定)
-- [開發模式](#開發模式)
-- [測試](#測試)
+- [前置作業](#前置作業)
+- [開發流程](#開發流程)
+  - [Link 模式（本地即時開發）](#link-模式本地即時開發)
+  - [Release 模式（使用 npm 正式版）](#release-模式使用-npm-正式版)
+- [版本資訊](#版本資訊)
 - [版本發布](#版本發布)
-- [前端專案整合](#前端專案整合)
-- [CI/CD 自動化](#cicd-自動化)
-- [常見問題](#常見問題)
+  - [測試版（Alpha / Beta）](#測試版alpha--beta)
+  - [正式版（自動 CI/CD）](#正式版自動-cicd)
+- [Pre-push Hook 說明](#pre-push-hook-說明)
+- [CI/CD 設定](#cicd-設定)
+  - [npm Automation Token](#npm-automation-token)
+  - [GitLab CI/CD Variables](#gitlab-cicd-variables)
 
 ---
 
-## 🚀 快速開始
+## 元件使用指南
 
-### 安裝套件
+### 安裝與引入
 
 ```bash
-npm install @udi-organization/udi-package --legacy-peer
+npm install @udi-organization/udi-package --legacy-peer-deps
 ```
 
-### 使用範例
-
-```jsx
-import { UdiTable, Button } from '@udi-organization/udi-package';
-import { useUdiTableSync } from '@udi-organization/udi-package';
-
-function MyComponent() {
-  const tableProps = useUdiTableSync({
-    /* ... */
-  });
-
-  return (
-    <div>
-      <Button>Click Me</Button>
-      <UdiTable {...tableProps} />
-    </div>
-  );
-}
+```js
+import { UdiTable, useUdiTableSync, useUdiTableSyncMutipleTable } from '@udi-organization/udi-package';
 ```
 
 ---
 
-## 📁 專案結構
-
-```
-udi-package/
-├── src/                          # 📝 源代碼目錄
-│   ├── index.js                 # 套件入口，導出所有組件
-│   ├── Button.jsx               # Button 組件
-│   ├── lib/                     # 工具函數庫
-│   │   └── tr.js               # 翻譯工具
-│   └── udiTable/                # UdiTable 組件模組
-│       ├── UdiTable.jsx         # 主組件
-│       ├── mockFn.js            # 測試用 mock 函數
-│       └── hooks/               # 自定義 React Hooks
-│           ├── useTableSort.js
-│           ├── useTablePagination.js
-│           ├── useDataRequest.js
-│           ├── useUdiTableSync.js
-│           └── useUdiTableSyncMutipleTable.js
-│
-├── dev/                          # 🛠️ 本地開發環境
-│   ├── index.html               # 開發用 HTML 模板
-│   └── main.jsx                 # 開發入口文件
-│
-├── dist/                         # 📦 編譯輸出目錄（自動生成）
-│   ├── index.cjs.js             # CommonJS 格式
-│   ├── index.cjs.js.map
-│   ├── index.esm.js             # ES Module 格式
-│   └── index.esm.js.map
-│
-├── .husky/                       # 🔐 Git Hooks
-│   └── pre-push                 # 自動版本管理 Hook
-│
-├── rollup.config.js             # 📦 套件打包配置
-├── webpack.config.js            # 🔧 本地開發服務器配置
-├── jest.config.cjs              # 🧪 測試配置
-├── .gitlab-ci.yml               # 🚀 GitLab CI/CD 配置
-├── package.json
-└── README.md
-```
-
-### 架構說明
-
-#### 編譯工具分工
-
-| 工具 | 用途 | 輸出 |
-|------|------|------|
-| **Rollup** | 編譯套件為標準 npm 包格式 | `dist/index.cjs.js`、`dist/index.esm.js` |
-| **Webpack** | 提供本地開發環境，支持熱更新 | `dist-dev/bundle.js` (僅開發用) |
-
-#### 開發模式
 
-1. **正常開發模式**: 使用 npm 官方發布的套件版本
-2. **Link 開發模式**: 使用本地 udi-package 進行即時開發
 
-#### 工作目錄結構要求
+## 專案結構
 
 ```
-workspace/
-├── udi-package/              # 套件專案
-├── imp-frontend/             # 前端專案 A
-├── other-frontend/           # 前端專案 B
-└── ...
+udi-package/          ← 套件端（本專案）
+web-frontend/         ← 客戶端（前端專案）
 ```
 
-⚠️ **重要**: `udi-package` 必須與前端專案放在同一層級，因為 Docker volume 映射需要固定路徑 `/udi-package`
+> **重要**：`udi-package` 需與前端專案放在同一層目錄，Docker volume 映射時會依此固定路徑抓取。
 
 ---
 
-## 🔧 環境設定
+## 前置作業
 
-### 前置要求
+1. **加入 npm 開發組織**
+   1. 使用公司 email 建立 npm 帳號：[https://www.npmjs.com](https://www.npmjs.com)
+   2. 請管理員邀請加入組織 `@udi-organization`
+   3. 執行登入並確認身份：
+      ```bash
+      npm login
+      npm whoami
+      ```
 
-| 工具 | 版本要求 |
-|------|----------|
-| Node.js | >= 20.x |
-| npm | >= 9.x |
-| Git | >= 2.x |
+2. **設定 CI/CD Token**（團隊中只需一人設定，詳見[下方說明](#cicd-設定)）
 
-```bash
-git clone https://gitlab.com/udi3732104/udi-package.git
-cd udi-package
-```
+---
 
-### 2. 安裝依賴
+## 開發流程
 
-```bash
-npm install
-```
+### Link 模式（本地即時開發）
+
+在 `udi-package` 有持續變動時使用，client 端會直接讀取本地 `dist/` 資料夾。
 
-### 3. 驗證環境
+**套件端（udi-package）：**
 
 ```bash
-# 執行測試
-npm test
+# 持續監聽並自動編譯（推薦）
+npm run watch
 
-# 構建套件
+# 或單次編譯
 npm run build
 ```
 
----
+**客戶端（web-frontend）：**
 
-## 💻 開發模式
+```bash
+# 切換至 link 模式並啟動開發伺服器
+npm run dev-udi
 
-### 模式 1：獨立開發套件（推薦用於組件開發）
+# 只切換至 link 模式，不啟動開發伺服器
+npm run dev-udi-o
+```
 
-適用於開發新組件或修改現有組件時的獨立測試。
+> `dev-udi` 執行流程：
+> 1. 解除安裝 npm 上的 `@udi-organization/udi-package`
+> 2. 在 `/udi-package` 執行 `sudo npm link`（建立全域連結）
+> 3. 在 `/build` 執行 `npm link @udi-organization/udi-package`（套用本地連結）
+> 4. 啟動 webpack dev server
 
-```bash
-# 啟動本地開發服務器（Webpack）
-npm run dev
-```
+> **注意**：link 模式會將 `@udi-organization/udi-package` 從 `package.json` 中移除，改用本地路徑作為依賴。**git push 前必須先切換回 release 模式。**
 
-- 服務器運行於 `http://localhost:3000`
-- 支持熱模組替換（HMR）
-- 編輯 [dev/main.jsx](dev/main.jsx) 來測試組件
+---
 
-### 模式 2：與前端專案聯動開發（使用 npm link）
+### Release 模式（使用 npm 正式版）
 
-適用於需要在實際專案中測試套件的情況。
+套件開發完畢、測試通過後，client 端切換回從 npm 取得套件。
 
-#### 步驟 1：在套件專案中建立鏈接
+**客戶端（web-frontend）：**
 
 ```bash
-cd /path/to/udi-package
+# 安裝最新版並啟動開發伺服器
+npm run get-udi
 
-# 建立全局鏈接
-sudo npm link
+# 只安裝最新版，不啟動開發伺服器
+npm run get-udi-o
 
-# 啟動監聽模式（自動編譯變更）
-npm run watch
+# 安裝指定版本（測試版或特定版本）
+npm install @udi-organization/udi-package@<版號> --legacy-peer-deps
 ```
 
-> `npm run watch` 會監聽 [src/](src/) 目錄的變更，並自動使用 Rollup 編譯到 [dist/](dist/)
+---
 
-#### 步驟 2：在前端專案中使用鏈接
+## 版本資訊
 
-```bash
-cd /path/to/your-frontend-project
+### 當前版本
 
-# 移除 npm 安裝的套件
-npm uninstall @udi-organization/udi-package --legacy-peer
+於 `package.json` 查看目前版號：
 
-# 鏈接本地套件
-npm link @udi-organization/udi-package --legacy-peer
-
-# 啟動開發服務器
-npm run dev-normal
+```bash
+node -p "require('./package.json').version"
 ```
 
-#### 步驟 3：完成開發後恢復正常模式
+或至 npm 查詢已發布的最新版本：
 
 ```bash
-# 取消鏈接
-npm unlink @udi-organization/udi-package
-
-# 重新安裝 npm 套件
-npm install @udi-organization/udi-package@latest --legacy-peer
+npm view @udi-organization/udi-package version          # 最新正式版
+npm view @udi-organization/udi-package dist-tags        # 所有 tag（latest / alpha / beta）
+npm view @udi-organization/udi-package versions --json  # 完整版本列表
 ```
 
 ---
 
-## 🧪 測試
-
-本專案使用 Jest 進行單元測試，配置詳見 [jest.config.cjs](jest.config.cjs)。
+### 版號格式（SemVer）
 
-### 執行測試
-
-```bash
-# 執行所有測試
-npm test
+本套件遵循 [語意化版本（Semantic Versioning）](https://semver.org/lang/zh-TW/)：
 
-# 監聽模式（開發時推薦）
-npm run test:watch
-
-# 生成測試覆蓋率報告
-npm run test:coverage
 ```
+major.minor.patch[-prerelease.N]
 
-### 測試文件位置
-
-測試文件與源文件放在同一目錄，命名規則：`*.test.js`
-
-```
-src/udiTable/hooks/
-├── useTableSort.js
-└── useTableSort.test.js
+範例：
+  1.0.76              正式版
+  1.0.77-alpha.1      alpha 測試版第 1 次
+  1.0.77-alpha.2      alpha 測試版第 2 次（重複執行 npm run alpha）
+  1.0.77-beta.1       beta 測試版第 1 次
 ```
 
 ---
 
-## 📦 版本發布
-
-### 發布流程概覽
-
-本專案支持 **本地手動發布** 和 **GitLab CI/CD 自動發布** 兩種方式。
-
-### 方式 1：GitLab CI/CD 自動發布（推薦）
-
-#### 自動發布觸發條件
-
-當你 push 到 `dev` 分支時，會自動觸發 CI/CD Pipeline：
+### 版號遞增規則
 
-```bash
-# 提交變更
-git add .
-git commit -m "feat: 新增功能"
+| 版號類型 | 觸發方式 | 範例 |
+|----------|----------|------|
+| **patch**（修補） | 推送至 `dev` 分支時由 pre-push hook 自動遞增 | `1.0.76` → `1.0.77` |
+| **minor**（次版本） | 手動執行 `npm run release-minor` | `1.0.76` → `1.1.0` |
+| **major**（主版本） | 手動執行 `npm run release-major` | `1.0.76` → `2.0.0` |
+| **alpha**（測試版） | 手動執行 `npm run alpha` | `1.0.76` → `1.0.77-alpha.1` |
+| **beta**（測試版） | 手動執行 `npm run beta` | `1.0.76` → `1.0.77-beta.1` |
 
-# 推送到 dev 分支（自動觸發發布）
-git push origin dev
-```
+> 預發布版本（alpha/beta）推送至 GitLab `dev` 分支前，pre-push hook 會自動切回正式版號。
 
-#### 自動發布流程
+---
 
-1. **Pre-Push Hook 檢查** ([.husky/pre-push](.husky/pre-push))
-   - ✅ 執行測試（測試失敗則取消 push）
-   - 🔢 自動版本遞增（`npm version patch`）
-   - 🚀 將版本 commit 推送到 GitLab
+## 版本發布
 
-2. **GitLab CI/CD Pipeline** (5 個階段，詳見 [.gitlab-ci.yml](.gitlab-ci.yml))
-   - **Install**: 安裝依賴
-   - **Test**: 執行單元測試
-   - **Version**: 檢查版本是否存在，若存在則自動遞增
-   - **Build**: 編譯套件（Rollup）
-   - **Deploy**: 發布到 npm
+### 測試版（Alpha / Beta）
 
-### 方式 2：本地手動發布（適用於緊急修復）
+開發中需要讓 client 端測試時，發布測試版本至 npm。**測試版無須推送至 GitLab。**
 
 ```bash
-# Patch 版本遞增（1.0.0 -> 1.0.1）
-npm run release
+# 步驟 1：產生測試版版號（可重複執行以遞增版號）
+npm run alpha
+# 範例：1.0.75 → 1.0.76-alpha.1 → 1.0.76-alpha.2
 
-# Minor 版本遞增（1.0.0 -> 1.1.0）
-npm run release-minor
-
-# Major 版本遞增（1.0.0 -> 2.0.0）
-npm run release-major
+# 步驟 2：編譯並推送至 npm
+npm run alpha:publish
 ```
 
-**執行內容**：
-1. 執行測試（`npm test`）
-2. 編譯套件（`npm run build`）
-3. 版本號遞增（`npm version patch/minor/major`）
-4. 發布到 npm（`npm publish --access public`）
-
-### 跳過 CI/CD 自動發布
-
-在 commit 訊息中加入 `[skip ci]`：
+Beta 版同理：
 
 ```bash
-git commit -m "docs: 更新 README [skip ci]"
-git push origin dev
+npm run beta
+npm run beta:publish
 ```
 
----
-
-## 🔗 前端專案整合
-
-### 在前端專案中安裝套件
+發布後，於 `package.json` 確認版號，並通知 client 端執行：
 
 ```bash
-npm install @udi-organization/udi-package@latest --legacy-peer
+npm install @udi-organization/udi-package@<版號> --legacy-peer-deps
 ```
 
-> `--legacy-peer` 用於處理 peer dependencies 版本衝突
-
-### 導入並使用組件
+---
 
-```jsx
-// 導入組件
-import { UdiTable, Button } from '@udi-organization/udi-package';
+### 正式版（自動 CI/CD）
 
-// 導入 Hooks
-import {
-  useUdiTableSync,
-  useUdiTableSyncMutipleTable
-} from '@udi-organization/udi-package';
+確認測試通過後，推送至 GitLab `dev` 分支即可自動觸發 CI/CD 流程。
 
-function MyComponent() {
-  const tableProps = useUdiTableSync({
-    // 配置選項...
-  });
+**流程如下：**
 
-  return (
-    <div>
-      <Button>Click Me</Button>
-      <UdiTable {...tableProps} />
-    </div>
-  );
-}
-```
-
-### 前端專案配置（推薦設定）
-
-在前端專案的 [package.json](package.json) 中添加以下 scripts：
-
-```json
-{
-  "scripts": {
-    "dev": "npm i @udi-organization/udi-package@latest --legacy-peer && npm run dev-normal",
-    "dev-udi": "npm uninstall @udi-organization/udi-package --legacy-peer && cd /udi-package && sudo npm link && cd /build && npm link @udi-organization/udi-package --legacy-peer && npm run dev-normal",
-    "dev-normal": "webpack-dev-server --mode=development",
-    "get-udi": "npm i @udi-organization/udi-package@latest --legacy-peer",
-    "get-udi-o": "npm i @udi-organization/udi-package@latest --legacy-peer",
-    "dev-udi-o": "npm uninstall @udi-organization/udi-package --legacy-peer && cd /udi-package && sudo npm link && cd /build && npm link @udi-organization/udi-package --legacy-peer",
-  }
-}
-```
-
-**指令說明**：
-
-| 指令 | 用途 | 使用場景 |
-|-----|------|----------|
-| `npm run dev` | 正常開發模式（含啟動服務器） | 不需要修改 udi-package |
-| `npm run dev-udi` | Link 模式（含啟動服務器） | 需要同時開發套件和專案 |
-| `npm run dev-normal` | 啟動開發服務器 | 內部使用，不直接調用 |
-| `npm run get-udi` | 更新套件到最新版本 | 更新依賴或退出 Link 模式 |
-| `npm run get-udi-o` | 僅安裝最新套件（不啟動） | 單純更新套件版本 |
-| `npm run dev-udi-o` | 僅設置 Link 模式（不啟動） | 需要 Link 但手動啟動服務器 |
+1. 執行 `git push`（推送到 `dev` 分支）
+2. Pre-push hook 自動執行測試，並遞增 patch 版號後推送
+3. GitLab CI/CD 自動執行：
+   - 安裝依賴 → 執行測試 → 管理版號 → 編譯套件 → 發布至 npm
 
+> **注意**：若當前版號為 alpha/beta 預發布版本，pre-push hook 會先自動切回正式版號並合併至最近一次 commit，然後要求重新執行 `git push`。
 
 ---
 
-## 🤖 CI/CD 自動化
+## Pre-push Hook 說明
 
-### 環境變數設定（僅發布者需要）
+Push 到 `dev` 分支時，husky pre-push hook 會自動執行以下動作：
 
-#### 1. npm 帳號設定
+| 情境 | 行為 |
+|------|------|
+| 一般 commit 推送到 `dev` | 執行測試 → 自動遞增 patch 版號 → 推送版號 commit → 觸發 CI/CD |
+| 推送到非 `dev` 分支 | 只執行測試，不自動打版號 |
+| 版號為 alpha/beta 時推送 | 自動切回正式版、合併至最近 commit，提示重新 push |
 
-**建立 npm 帳號**：
-1. 前往 [https://www.npmjs.com](https://www.npmjs.com/) 註冊帳號
-2. 組織管理員邀請加入 `@udi-organization`
-
-**登入驗證**：
-```bash
-# 登入 npm
-npm login
+> Hook 完成推送後會以 `exit 1` 結束，終端機會出現 error 訊息，**這是預期行為**，實際推送已成功完成，可忽略此錯誤。
 
-# 驗證登入狀態
-npm whoami
-```
-
-#### 2. 建立 npm Access Token
+---
 
-1. 前往 [https://www.npmjs.com](https://www.npmjs.com/) 登入
-2. 點擊右上角頭像 → **"Access Tokens"**
-3. 點擊 **"Generate New Token"** → 選擇 **"Classic Token"**
-4. **選擇 Token 類型**: ✅ **Automation** (CI/CD 專用)
-5. 複製 Token（例如：`npm_xxxxxxxxxxxx`）
+## CI/CD 設定
 
-⚠️ **重要**: 離開頁面後就看不到了，請立即複製
+> 團隊中只需一人設定，完成後所有成員皆可享有自動發布功能。
 
-#### 3. 在 GitLab 設定環境變數
+### npm Automation Token
 
-| 變數名稱 | 用途 | 必要性 |
-|---------|------|--------|
-| `NPM_TOKEN` | npm 認證 token | **必要** |
-| `CI_PUSH_TOKEN` | GitLab push token（用於回推版本更新） | 選用 |
+1. 登入 [https://www.npmjs.com](https://www.npmjs.com)
+2. 右上角頭像 → **Access Tokens** → **Generate New Token**
+3. 選擇 **Classic Token** → 選擇 **Automation** 類型
+4. 複製產生的 token（格式：`npm_xxxxxxxxxxxx`）
+   > ⚠️ 離開頁面後無法再次查看，請立即複製
 
-**設定步驟**：
+---
 
-1. 進入 GitLab 專案
-2. **Settings** → **CI/CD** → **Variables** → **Expand**
-3. 點擊 **"Add variable"**
-4. 填入資訊：
-   - **Key**: `NPM_TOKEN`
-   - **Value**: (貼上剛才的 token)
-   - **Type**: Variable
-   - ✅ 勾選 **"Mask variable"**
-   - ✅ 勾選 **"Protect variable"**
-5. 點擊 **"Add variable"**
+### GitLab CI/CD Variables
 
-### GitLab CI/CD Pipeline 說明
+需設定兩個 Variables：`NPM_TOKEN` 和 `CI_PUSH_TOKEN`
 
-詳細配置見 [.gitlab-ci.yml](.gitlab-ci.yml)
+#### 設定 NPM_TOKEN
 
-#### Pipeline 階段
+1. 進入 GitLab 專案 **udi / udi-package**
+2. 左側選單 → **Settings** → **CI/CD** → **Variables** → **Add variable**
+3. 填入：
 
-```mermaid
-graph LR
-    A[Install] --> B[Test]
-    B --> C[Version]
-    C --> D[Build]
-    D --> E[Deploy]
-```
+   | 欄位 | 值 |
+   |------|----|
+   | Key | `NPM_TOKEN` |
+   | Value | 上一步複製的 `npm_xxxx...` |
+   | Flags | ✅ Mask variable、✅ Protect variable |
 
-| 階段 | 說明 | 關鍵操作 |
-|------|------|----------|
-| **Install** | 安裝依賴 | `npm ci` |
-| **Test** | 執行測試 | `npm test` |
-| **Version** | 版本管理 | 檢查並遞增版本號 |
-| **Build** | 構建套件 | `npm run build` (Rollup) |
-| **Deploy** | 發布到 npm | `npm publish --access public` |
+#### 設定 CI_PUSH_TOKEN（GitLab Personal Access Token）
 
-#### Pre-Push Hook 流程
+1. GitLab 右上角頭像 → **Edit Profile** → **Access Tokens** → **Add new token**
+2. 填入：
 
-當執行 `git push origin dev` 時：
+   | 欄位 | 值 |
+   |------|----|
+   | Token name | `CI Push Token` |
+   | Expiration date | 設定一年後 |
+   | Scopes | ✅ `write_repository` |
 
-```bash
-✅ 1. 檢測分支（只在 dev 分支執行）
-✅ 2. 檢查 commit 訊息（避免無限循環）
-🧪 3. 執行測試（npm test）
-🔢 4. 版本遞增（npm version patch）
-🚀 5. 自動推送到 GitLab
-```
+3. 複製產生的 token（格式：`glpat-xxxxxxxxxxxxxxxxxxxx`）
+4. 回到專案 **Settings** → **CI/CD** → **Variables** → **Add variable**，填入：
 
+   | 欄位 | 值 |
+   |------|----|
+   | Key | `CI_PUSH_TOKEN` |
+   | Value | 上方複製的 `glpat-xxxx...` |
+   | Flags | ✅ Mask variable、✅ Protect variable |
 
+---
 
+## Scripts 速查
+
+### 套件端（udi-package）
+
+| 指令 | 說明 |
+|------|------|
+| `npm run dev` | 啟動本地 webpack dev server（元件開發用沙箱） |
+| `npm run build` | 單次編譯，輸出至 `dist/` |
+| `npm run watch` | 持續監聽並自動編譯 |
+| `npm run test` | 執行 Jest 單元測試 |
+| `npm run alpha` | 產生 alpha 測試版版號 |
+| `npm run alpha:publish` | 編譯並推送 alpha 版至 npm |
+| `npm run beta` | 產生 beta 測試版版號 |
+| `npm run beta:publish` | 編譯並推送 beta 版至 npm |
+
+### 客戶端（web-frontend）
+
+| 指令 | 說明 |
+|------|------|
+| `npm run dev` | 一般開發模式（使用 npm 版套件） |
+| `npm run dev-udi` | **Link 模式**：連結本地套件並啟動 dev server |
+| `npm run dev-udi-o` | **Link 模式**：只連結本地套件，不啟動 dev server |
+| `npm run get-udi` | 從 npm 安裝最新版套件並啟動 dev server |
+| `npm run get-udi-o` | 從 npm 安裝最新版套件（不啟動 dev server） |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@udi-organization/udi-package",
-  "version": "1.0.76",
+  "version": "1.0.78",
   "description": "package for udi",
   "repository": {
     "type": "gitlab",