sctj-components 1.0.0 → 1.0.1

package/PUBLISH_GUIDE.md

@@ -205,12 +205,159 @@ npm view your-package-name
 npm install your-package-name
 ```
 
-## 🔄 更新版本
+## 🔄 更新版本的标准流程
 
-1. 修改代码
-2. 更新版本号：`npm version patch/minor/major`
-3. 构建：`npm run build:lib`
-4. 发布：`npm publish`
+### 完整操作步骤
+
+#### 1. 修改代码
+```bash
+# 在 src/ 目录下修改组件代码
+# 更新文档（如 README.md）如果需要
+```
+
+#### 2. 更新版本号
+
+根据变更类型选择合适的版本号更新方式：
+
+```bash
+# 补丁版本 (1.0.0 -> 1.0.1) - 修复 bug、小改动
+npm version patch
+
+# 次版本 (1.0.0 -> 1.1.0) - 新功能、向后兼容的改动
+npm version minor
+
+# 主版本 (1.0.0 -> 2.0.0) - 重大变更、不向后兼容
+npm version major
+```
+
+**或者手动修改 `package.json` 中的 `version` 字段**：
+```json
+{
+  "version": "1.0.1"
+}
+```
+
+**注意**：`npm version` 命令会自动：
+- 更新 `package.json` 中的版本号
+- 创建一个 Git commit（如果使用 `npm version`）
+- 创建 Git tag（如果使用 `npm version`）
+
+#### 3. 构建组件库
+```bash
+npm run build:lib
+```
+
+这会生成 `lib/` 目录下的构建文件。
+
+#### 4. 提交到 Git（如果使用 `npm version`，这一步可能已自动完成）
+
+```bash
+# 查看更改
+git status
+
+# 添加更改的文件
+git add .
+
+# 提交（如果使用 npm version，可能已经有 commit）
+git commit -m "chore: 发布版本 1.0.1"
+
+# 推送代码和标签
+git push
+git push --tags
+```
+
+#### 5. 发布到 npm
+
+```bash
+# 发布正式版本（latest）
+npm publish
+
+# 或发布测试版本
+npm publish --tag beta
+```
+
+### 版本号规则（语义化版本）
+
+遵循 [语义化版本规范](https://semver.org/lang/zh-CN/)：
+
+- **主版本号（Major）**：不兼容的 API 修改
+  - 例如：`1.0.0` → `2.0.0`
+  - 使用：`npm version major`
+
+- **次版本号（Minor）**：向后兼容的功能性新增
+  - 例如：`1.0.0` → `1.1.0`
+  - 使用：`npm version minor`
+
+- **补丁版本号（Patch）**：向后兼容的问题修正
+  - 例如：`1.0.0` → `1.0.1`
+  - 使用：`npm version patch`
+
+### 快速更新流程（推荐）
+
+```bash
+# 1. 修改代码后，更新版本号（会自动创建 commit 和 tag）
+npm version patch  # 或 minor、major
+
+# 2. 构建（prepublishOnly 脚本会自动执行，但手动构建可以提前检查）
+npm run build:lib
+
+# 3. 推送到 Git
+git push
+git push --tags
+
+# 4. 发布到 npm
+npm publish
+```
+
+### 使用 prepublishOnly 脚本（已配置）
+
+你的 `package.json` 中已经配置了 `prepublishOnly`：
+
+```json
+{
+  "scripts": {
+    "prepublishOnly": "npm run build:lib"
+  }
+}
+```
+
+这意味着执行 `npm publish` 时会**自动**先执行 `npm run build:lib`，所以可以省略手动构建步骤：
+
+```bash
+# 简化流程
+npm version patch
+git push && git push --tags
+npm publish
+```
+
+### 发布到私有 npm 源
+
+如果使用私有源：
+
+```bash
+# 1. 更新版本号
+npm version patch
+
+# 2. 推送代码
+git push && git push --tags
+
+# 3. 发布到私有源（如果已配置 .npmrc，直接 publish 即可）
+npm publish
+
+# 或指定私有源
+npm publish --registry=https://your-private-registry-url
+```
+
+### 版本更新检查清单
+
+- [ ] 代码修改完成并测试通过
+- [ ] 更新版本号（使用 `npm version` 或手动修改）
+- [ ] 构建成功（`npm run build:lib`）
+- [ ] 检查 `lib/` 目录文件是否正确生成
+- [ ] 提交代码到 Git（如果使用 `npm version` 已自动完成）
+- [ ] 推送代码和标签到远程仓库
+- [ ] 发布到 npm（正式版或测试版）
+- [ ] 验证发布成功（`npm view sctj-components`）
 
 ## ⚠️ 常见问题
 

package/lib/sctj-components.es.js

@@ -20,7 +20,7 @@ const _export_sfc = (sfc, props) => {
   return target;
 };
 const _hoisted_1$n = { class: "dict-tag-container" };
-const _hoisted_2$e = ["index"];
+const _hoisted_2$f = ["index"];
 const _sfc_main$t = {
   __name: "index",
   props: {
@@ -49,7 +49,7 @@ const _sfc_main$t = {
                 key: item.value,
                 index: index2,
                 class: normalizeClass(item.elTagClass)
-              }, toDisplayString(item.label), 11, _hoisted_2$e)) : (openBlock(), createBlock(_component_el_tag, {
+              }, toDisplayString(item.label), 11, _hoisted_2$f)) : (openBlock(), createBlock(_component_el_tag, {
                 "disable-transitions": true,
                 key: item.value + "",
                 index: index2,
@@ -235,7 +235,7 @@ const _sfc_main$r = defineComponent({
   }
 });
 const _hoisted_1$l = ["xlink:href", "fill"];
-function _sfc_render$2(_ctx, _cache, $props, $setup, $data, $options) {
+function _sfc_render$1(_ctx, _cache, $props, $setup, $data, $options) {
   return openBlock(), createElementBlock("svg", {
     class: normalizeClass(_ctx.svgClass),
     "aria-hidden": "true"
@@ -246,13 +246,13 @@ function _sfc_render$2(_ctx, _cache, $props, $setup, $data, $options) {
     }, null, 8, _hoisted_1$l)
   ], 2);
 }
-const SCTJSvgIcon = /* @__PURE__ */ _export_sfc(_sfc_main$r, [["render", _sfc_render$2]]);
+const SCTJSvgIcon = /* @__PURE__ */ _export_sfc(_sfc_main$r, [["render", _sfc_render$1]]);
 const index$2 = "";
 const index$1 = "";
 const index_vue_vue_type_style_index_0_scoped_ca0fa60b_lang = "";
 const index_vue_vue_type_style_index_1_lang = "";
 const _hoisted_1$k = { class: "upload-file" };
-const _hoisted_2$d = { class: "el-upload__tip" };
+const _hoisted_2$e = { class: "el-upload__tip" };
 const _hoisted_3$c = { style: { "color": "#f56c6c" } };
 const _hoisted_4$a = { style: { "color": "#f56c6c" } };
 const _hoisted_5$8 = ["title"];
@@ -523,7 +523,7 @@ const _sfc_main$q = {
           unref(showTip) ? {
             name: "tip",
             fn: withCtx(() => [
-              createElementVNode("div", _hoisted_2$d, [
+              createElementVNode("div", _hoisted_2$e, [
                 createTextVNode(" \u8BF7\u4E0A\u4F20 "),
                 __props.fileSize ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
                   createTextVNode(" \u5927\u5C0F\u4E0D\u8D85\u8FC7 "),
@@ -633,7 +633,7 @@ const _sfc_main$q = {
 const SCTJFileUpload = /* @__PURE__ */ _export_sfc(_sfc_main$q, [["__scopeId", "data-v-ca0fa60b"]]);
 const index_vue_vue_type_style_index_0_scoped_13e683b8_lang = "";
 const _hoisted_1$j = { class: "component-upload-image" };
-const _hoisted_2$c = {
+const _hoisted_2$d = {
   key: 0,
   class: "el-upload__tip"
 };
@@ -892,7 +892,7 @@ const _sfc_main$p = {
           ]),
           _: 1
         }, 8, ["disabled", "action", "limit", "http-request", "headers", "file-list", "class"]),
-        unref(showTip) ? (openBlock(), createElementBlock("div", _hoisted_2$c, [
+        unref(showTip) ? (openBlock(), createElementBlock("div", _hoisted_2$d, [
           createTextVNode(" \u8BF7\u4E0A\u4F20 "),
           props.fileSize ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [
             createTextVNode(" \u5927\u5C0F\u4E0D\u8D85\u8FC7 "),
@@ -1066,7 +1066,7 @@ for (const path in modules) {
 const index_vue_vue_type_style_index_0_scoped_f1b4799d_lang = "";
 const _withScopeId$7 = (n) => (pushScopeId("data-v-f1b4799d"), n = n(), popScopeId(), n);
 const _hoisted_1$h = { class: "icon-body" };
-const _hoisted_2$b = /* @__PURE__ */ _withScopeId$7(() => /* @__PURE__ */ createElementVNode("i", { class: "el-icon-search el-input__icon" }, null, -1));
+const _hoisted_2$c = /* @__PURE__ */ _withScopeId$7(() => /* @__PURE__ */ createElementVNode("i", { class: "el-icon-search el-input__icon" }, null, -1));
 const _hoisted_3$a = { class: "icon-list" };
 const _hoisted_4$8 = ["onClick"];
 const _sfc_main$n = {
@@ -1106,7 +1106,7 @@ const _sfc_main$n = {
           onInput: filterIcons
         }, {
           suffix: withCtx(() => [
-            _hoisted_2$b
+            _hoisted_2$c
           ]),
           _: 1
         }, 8, ["modelValue"]),
@@ -1155,12 +1155,12 @@ function useMobile() {
     checkIsMobile
   };
 }
-const index_vue_vue_type_style_index_0_scoped_84111394_lang = "";
+const index_vue_vue_type_style_index_0_scoped_6e30b57f_lang = "";
 const _hoisted_1$g = {
   key: 0,
   class: "search-container"
 };
-const _hoisted_2$a = {
+const _hoisted_2$b = {
   key: 1,
   class: "custom-drawer"
 };
@@ -1175,9 +1175,6 @@ const _sfc_main$m = {
   emits: ["update:visible"],
   setup(__props, { emit }) {
     const { isMobile } = useMobile();
-    watch$1(isMobile, (newVal) => {
-      emit("update:visible", !newVal);
-    }, { immediate: true });
     const close = () => {
       emit("update:visible", false);
     };
@@ -1193,7 +1190,7 @@ const _sfc_main$m = {
         })
       ], 512)), [
         [vShow, __props.visible]
-      ]) : (openBlock(), createElementBlock("div", _hoisted_2$a, [
+      ]) : (openBlock(), createElementBlock("div", _hoisted_2$b, [
         createVNode(_component_el_drawer, {
           "model-value": __props.visible,
           title: "\u7B5B\u9009\u6761\u4EF6",
@@ -1209,7 +1206,7 @@ const _sfc_main$m = {
     };
   }
 };
-const SCTJSearch = /* @__PURE__ */ _export_sfc(_sfc_main$m, [["__scopeId", "data-v-84111394"]]);
+const SCTJSearch = /* @__PURE__ */ _export_sfc(_sfc_main$m, [["__scopeId", "data-v-6e30b57f"]]);
 const _sfc_main$l = {
   __name: "index",
   props: {
@@ -1640,23 +1637,14 @@ const SCTJTable = /* @__PURE__ */ _export_sfc(_sfc_main$k, [["__scopeId", "data-
 const index_vue_vue_type_style_index_0_scoped_45fb95db_lang = "";
 const _sfc_main$j = {};
 const _hoisted_1$e = { class: "table-container" };
-function _sfc_render$1(_ctx, _cache) {
-  return openBlock(), createElementBlock("div", _hoisted_1$e, [
-    renderSlot(_ctx.$slots, "default", {}, void 0, true)
-  ]);
-}
-const SCTJTableContainer = /* @__PURE__ */ _export_sfc(_sfc_main$j, [["render", _sfc_render$1], ["__scopeId", "data-v-45fb95db"]]);
-const index_vue_vue_type_style_index_0_scoped_12330962_lang = "";
-const _sfc_main$i = {};
-const _hoisted_1$d = { class: "table-page-container" };
 function _sfc_render(_ctx, _cache) {
-  return openBlock(), createElementBlock("div", _hoisted_1$d, [
+  return openBlock(), createElementBlock("div", _hoisted_1$e, [
     renderSlot(_ctx.$slots, "default", {}, void 0, true)
   ]);
 }
-const SCTJTablePageContainer = /* @__PURE__ */ _export_sfc(_sfc_main$i, [["render", _sfc_render], ["__scopeId", "data-v-12330962"]]);
+const SCTJTableContainer = /* @__PURE__ */ _export_sfc(_sfc_main$j, [["render", _sfc_render], ["__scopeId", "data-v-45fb95db"]]);
 const index_vue_vue_type_style_index_0_scoped_f8b93d19_lang = "";
-const _sfc_main$h = {
+const _sfc_main$i = {
   __name: "index",
   props: {
     showSearch: {
@@ -1796,10 +1784,10 @@ const _sfc_main$h = {
     };
   }
 };
-const SCTJRightToolbar = /* @__PURE__ */ _export_sfc(_sfc_main$h, [["__scopeId", "data-v-f8b93d19"]]);
+const SCTJRightToolbar = /* @__PURE__ */ _export_sfc(_sfc_main$i, [["__scopeId", "data-v-f8b93d19"]]);
 const index_vue_vue_type_style_index_0_scoped_056cfdde_lang = "";
-const _hoisted_1$c = { class: "table-top-action-container" };
-const _sfc_main$g = {
+const _hoisted_1$d = { class: "table-top-action-container" };
+const _sfc_main$h = {
   __name: "index",
   props: {
     showSearch: {
@@ -1826,7 +1814,7 @@ const _sfc_main$g = {
       emit("refresh");
     };
     return (_ctx, _cache) => {
-      return openBlock(), createElementBlock("div", _hoisted_1$c, [
+      return openBlock(), createElementBlock("div", _hoisted_1$d, [
         renderSlot(_ctx.$slots, "left", {}, void 0, true),
         renderSlot(_ctx.$slots, "right", {}, () => [
           createVNode(SCTJRightToolbar, {
@@ -1840,7 +1828,58 @@ const _sfc_main$g = {
     };
   }
 };
-const SCTJTableTopActionContainer = /* @__PURE__ */ _export_sfc(_sfc_main$g, [["__scopeId", "data-v-056cfdde"]]);
+const SCTJTableTopActionContainer = /* @__PURE__ */ _export_sfc(_sfc_main$h, [["__scopeId", "data-v-056cfdde"]]);
+const index_vue_vue_type_style_index_0_scoped_cd968be9_lang = "";
+const _hoisted_1$c = { class: "table-page-container" };
+const _hoisted_2$a = { style: { "flex": "1", "height": "0" } };
+const _sfc_main$g = {
+  __name: "index",
+  props: {
+    showSearch: {
+      type: Boolean,
+      default: true
+    }
+  },
+  emits: ["refresh", "update:showSearch"],
+  setup(__props, { emit }) {
+    const props = __props;
+    const { isMobile } = useMobile();
+    const refresh = () => {
+      emit("refresh");
+    };
+    const outSearch = computed$1({
+      get() {
+        return props.showSearch;
+      },
+      set(val) {
+        emit("update:showSearch", val);
+      }
+    });
+    watch$1(isMobile, (newVal) => {
+      emit("update:showSearch", !newVal);
+    }, { immediate: true });
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("div", _hoisted_1$c, [
+        renderSlot(_ctx.$slots, "search", {}, void 0, true),
+        createVNode(SCTJTableTopActionContainer, {
+          showSearch: unref(outSearch),
+          "onUpdate:showSearch": _cache[0] || (_cache[0] = ($event) => isRef(outSearch) ? outSearch.value = $event : null),
+          onRefresh: refresh
+        }, {
+          left: withCtx(() => [
+            renderSlot(_ctx.$slots, "btn", {}, void 0, true)
+          ]),
+          _: 3
+        }, 8, ["showSearch"]),
+        createElementVNode("div", _hoisted_2$a, [
+          renderSlot(_ctx.$slots, "table", {}, void 0, true)
+        ]),
+        renderSlot(_ctx.$slots, "default", {}, void 0, true)
+      ]);
+    };
+  }
+};
+const SCTJTablePageContainer = /* @__PURE__ */ _export_sfc(_sfc_main$g, [["__scopeId", "data-v-cd968be9"]]);
 const _sfc_main$f = {
   __name: "index",
   setup(__props) {