hd-attribute-set 0.1.0 → 0.1.3

package/dist/hd-attribute-set.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./utils.cjs"),i=require("./use-permission-CbbVGG4p.cjs"),s="0.1.3";exports.debounce=e.debounce;exports.deepClone=e.deepClone;exports.isEmail=e.isEmail;exports.isEmpty=e.isEmpty;exports.isIdCard=e.isIdCard;exports.isPhone=e.isPhone;exports.listToTree=e.listToTree;exports.sleep=e.sleep;exports.throttle=e.throttle;exports.uniqueBy=e.uniqueBy;exports.DEFAULT_PERMISSION_CONFIG=i.DEFAULT_PERMISSION_CONFIG;exports.normalizePermissionId=i.normalizePermissionId;exports.resolvePermissionConfig=i.resolvePermissionConfig;exports.useMemoizedFn=i.useMemoizedFn;exports.usePermission=i.usePermission;exports.version=s;

package/dist/hd-attribute-set.js

@@ -1,35 +1,21 @@
-import { jsxs as s, Fragment as i, jsx as r } from "react/jsx-runtime";
-import { Divider as n, Empty as l, Descriptions as h } from "antd";
-function m({ items: a, title: t, column: d = 2, bordered: c = !0, emptyText: p = "暂无属性" }) {
-  return !a || a.length === 0 ? /* @__PURE__ */ s("div", { className: "hd-attribute-set", children: [
-    t && /* @__PURE__ */ s(i, { children: [
-      /* @__PURE__ */ r("div", { className: "hd-attribute-set__title", children: t }),
-      /* @__PURE__ */ r(n, { style: { margin: "8px 0 16px" } })
-    ] }),
-    /* @__PURE__ */ r(l, { image: l.PRESENTED_IMAGE_SIMPLE, description: p })
-  ] }) : /* @__PURE__ */ s("div", { className: "hd-attribute-set", children: [
-    t && /* @__PURE__ */ s(i, { children: [
-      /* @__PURE__ */ r("div", { className: "hd-attribute-set__title", children: t }),
-      /* @__PURE__ */ r(n, { style: { margin: "8px 0 16px" } })
-    ] }),
-    /* @__PURE__ */ r(
-      h,
-      {
-        size: "small",
-        column: d,
-        bordered: c,
-        items: a.map((e) => ({
-          key: e.key,
-          label: e.label,
-          children: e.render ? e.render(e.value) : e.value ?? "-",
-          span: e.span
-        }))
-      }
-    )
-  ] });
-}
-const v = "0.1.0";
+import { debounce as i, deepClone as r, isEmail as n, isEmpty as a, isIdCard as m, isPhone as t, listToTree as l, sleep as d, throttle as p, uniqueBy as u } from "./utils.js";
+import { D as P, n as C, r as E, u as f, a as x } from "./use-permission-DHvtS-2I.js";
+const e = "0.1.3";
 export {
-  m as AttributeSet,
-  v as version
+  P as DEFAULT_PERMISSION_CONFIG,
+  i as debounce,
+  r as deepClone,
+  n as isEmail,
+  a as isEmpty,
+  m as isIdCard,
+  t as isPhone,
+  l as listToTree,
+  C as normalizePermissionId,
+  E as resolvePermissionConfig,
+  d as sleep,
+  p as throttle,
+  u as uniqueBy,
+  f as useMemoizedFn,
+  x as usePermission,
+  e as version
 };

package/dist/hooks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * hooks 统一出口（barrel 文件）
+ * 新增 hook 文件后，只需在此处加一行 `export * from './xxx';`
+ * 即可从 'hd-attribute-set/hooks' 子路径引入。
+ */
+export * from './use-memoized-fn';
+export * from './use-permission';

package/dist/hooks/use-memoized-fn.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 返回引用稳定的函数：外层引用永远不变，内部始终执行最新的实现。
+ * 用于替代 ahooks 的 useMemoizedFn，避免组件库引入额外运行时依赖。
+ *
+ * @example
+ * const handleClick = useMemoizedFn((id: string) => { ... });
+ */
+export declare function useMemoizedFn<T extends (...args: any[]) => any>(fn: T): T;
+export default useMemoizedFn;

package/dist/hooks/use-permission.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 权限判断 hook（与 redux / ahooks 解耦版）
+ * 权限配置由调用方通过参数传入，可以是 redux 中的 accessConfig，也可以是任意数据源。
+ *
+ * @example
+ * // 直接传 redux 中的数据
+ * const accessConfig = useAppSelector(selectAccessConfig);
+ * const { shouldShowButton, isNoPermissionShow } = usePermission(accessConfig);
+ *
+ * @example
+ * // 传 getter：每次调用时取最新值，避免闭包拿到旧数据
+ * const { hasPermission } = usePermission(() => store.getState().auth.userInfo?.accessConfig);
+ */
+/** 权限配置（一般来自 redux 的 accessConfig） */
+export interface PermissionConfig {
+    /** 无权限时是否在页面上展示（由消费方决定提示 / 禁用） */
+    noPermissionShow?: boolean;
+    /** 当前用户拥有的权限编号列表 */
+    list?: (number | string)[];
+    /** 是否拥有全部权限 */
+    selectAll?: boolean;
+}
+/** 权限配置来源：直接传对象，或传 getter（每次调用读取最新值，适配 redux / context 等外部数据源） */
+export type PermissionConfigSource = PermissionConfig | (() => PermissionConfig | null | undefined);
+export interface UsePermissionReturn {
+    /** 检查是否有权限 */
+    hasPermission: (permissionId?: number | string) => boolean;
+    /** 检查按钮是否应该显示 */
+    shouldShowButton: (permissionId?: number | string) => boolean;
+    /** 检查菜单是否应该显示 */
+    shouldShowMenu: (permissionId?: number | string) => {
+        noPermissionShow: boolean;
+        hasPerm: boolean;
+    };
+    /** 检查没权限时是否需要在页面上提示 / 禁用 */
+    isNoPermissionShow: (permissionId?: number | string) => boolean;
+}
+/** 没有权限配置时的兜底：视为拥有全部权限 */
+export declare const DEFAULT_PERMISSION_CONFIG: PermissionConfig;
+/**
+ * 权限编号归一化：平台权限编号是「定长分层编号」（导航 60000 → 二级菜单 62000 → 三级菜单 62100 → 按钮 62101），
+ * 而菜单配置里的三级菜单编号可能多补一位 0（如 621000），导致精确比较匹配不上、有权限的菜单显示不出来。
+ * 这里去掉编号末尾的补位 0（621000 与 62100 都归一化为 621）后再比较一次。
+ */
+export declare const normalizePermissionId: (permissionId: number | string) => string;
+/** 解析权限配置（支持 getter，保证拿到外部数据源的最新值） */
+export declare const resolvePermissionConfig: (source?: PermissionConfigSource) => PermissionConfig;
+export declare function usePermission(source?: PermissionConfigSource): UsePermissionReturn;
+export default usePermission;

package/dist/hooks.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./use-permission-CbbVGG4p.cjs");exports.DEFAULT_PERMISSION_CONFIG=e.DEFAULT_PERMISSION_CONFIG;exports.normalizePermissionId=e.normalizePermissionId;exports.resolvePermissionConfig=e.resolvePermissionConfig;exports.useMemoizedFn=e.useMemoizedFn;exports.usePermission=e.usePermission;

package/dist/hooks.d.ts

@@ -0,0 +1,2 @@
+export * from './hooks/index'
+export {}

package/dist/hooks.js

@@ -0,0 +1,8 @@
+import { D as i, n as o, r, u as a, a as n } from "./use-permission-DHvtS-2I.js";
+export {
+  i as DEFAULT_PERMISSION_CONFIG,
+  o as normalizePermissionId,
+  r as resolvePermissionConfig,
+  a as useMemoizedFn,
+  n as usePermission
+};

package/dist/index.d.ts

@@ -1,2 +1,8 @@
-export * from './components/attribute-set';
+/**
+ * 包主入口（根路径）
+ * - utils / hooks 都可以从根入口引入
+ * - 也保留子路径引入：'hd-attribute-set/utils'、'hd-attribute-set/hooks'
+ */
+export * from './utils';
+export * from './hooks';
 export declare const version: string;

package/dist/use-permission-CbbVGG4p.cjs

@@ -0,0 +1 @@
+"use strict";const f=require("react");function r(n){const e=f.useRef(n);e.current=n;const s=f.useRef(null);return s.current||(s.current=(...u)=>{var i;return(i=e.current)==null?void 0:i.call(e,...u)}),s.current}const P={noPermissionShow:!0,list:[],selectAll:!0},m=n=>String(n).replace(/0+$/,""),c=n=>(typeof n=="function"?n():n)||P;function g(n){const e=r(o=>{if(!o)return!0;const t=c(n);if(t.selectAll)return!0;const l=t.list||[];if(l.includes(Number(o)))return!0;const S=m(o);return l.some(h=>m(h)===S)}),s=r(o=>e(o)),u=r(o=>({noPermissionShow:!!c(n).noPermissionShow,hasPerm:e(o)})),i=r(o=>!!c(n).noPermissionShow&&!e(o));return{hasPermission:e,shouldShowButton:s,shouldShowMenu:u,isNoPermissionShow:i}}exports.DEFAULT_PERMISSION_CONFIG=P;exports.normalizePermissionId=m;exports.resolvePermissionConfig=c;exports.useMemoizedFn=r;exports.usePermission=g;

package/dist/use-permission-DHvtS-2I.js

@@ -0,0 +1,47 @@
+import { useRef as l } from "react";
+function i(n) {
+  const o = l(n);
+  o.current = n;
+  const r = l(null);
+  return r.current || (r.current = (...c) => {
+    var s;
+    return (s = o.current) == null ? void 0 : s.call(o, ...c);
+  }), r.current;
+}
+const P = {
+  noPermissionShow: !0,
+  list: [],
+  selectAll: !0
+}, f = (n) => String(n).replace(/0+$/, ""), u = (n) => (typeof n == "function" ? n() : n) || P;
+function g(n) {
+  const o = i((e) => {
+    if (!e)
+      return !0;
+    const t = u(n);
+    if (t.selectAll)
+      return !0;
+    const m = t.list || [];
+    if (m.includes(Number(e)))
+      return !0;
+    const a = f(e);
+    return m.some((h) => f(h) === a);
+  }), r = i(
+    (e) => o(e)
+  ), c = i((e) => ({
+    noPermissionShow: !!u(n).noPermissionShow,
+    hasPerm: o(e)
+  })), s = i((e) => !!u(n).noPermissionShow && !o(e));
+  return {
+    hasPermission: o,
+    shouldShowButton: r,
+    shouldShowMenu: c,
+    isNoPermissionShow: s
+  };
+}
+export {
+  P as D,
+  g as a,
+  f as n,
+  u as r,
+  i as u
+};

package/dist/utils/fn.d.ts

@@ -0,0 +1,9 @@
+/** 防抖 */
+export declare function debounce<T extends (...args: never[]) => void>(fn: T, wait?: number): {
+    (...args: Parameters<T>): void;
+    cancel(): void;
+};
+/** 节流 */
+export declare function throttle<T extends (...args: never[]) => void>(fn: T, wait?: number): (...args: Parameters<T>) => void;
+/** 睡眠 */
+export declare function sleep(ms: number): Promise<void>;

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * utils 统一出口（barrel 文件）
+ * 新增工具文件后，只需在此处加一行 `export * from './xxx';`
+ * 即可从包根路径或 'hd-attribute-set/utils' 子路径引入。
+ */
+export * from './validate';
+export * from './object';
+export * from './fn';

package/dist/utils/object.d.ts

@@ -0,0 +1,13 @@
+/** 深拷贝：优先 structuredClone，失败降级 JSON */
+export declare function deepClone<T>(source: T): T;
+/** 数组去重（按 key 或值） */
+export declare function uniqueBy<T>(list: T[], key?: keyof T): T[];
+/** 数组转树（扁平结构构建树形结构） */
+export interface TreeNode<T> extends Record<string, unknown> {
+    children?: TreeNode<T>[];
+}
+export declare function listToTree<T extends Record<string, unknown>>(list: T[], { idKey, parentKey, childrenKey }?: {
+    idKey?: string | undefined;
+    parentKey?: string | undefined;
+    childrenKey?: string | undefined;
+}): TreeNode<T>[];

package/dist/utils/validate.d.ts

@@ -0,0 +1,8 @@
+/** 判断空值：undefined / null / 空字符串 / 空数组 / 空 MapSet / 空对象 */
+export declare function isEmpty(value: unknown): boolean;
+/** 手机号校验（中国大陆） */
+export declare function isPhone(value: string): boolean;
+/** 身份证校验（18 位） */
+export declare function isIdCard(value: string): boolean;
+/** 邮箱校验 */
+export declare function isEmail(value: string): boolean;

package/dist/utils.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function f(t){return t==null||t===""?!0:Array.isArray(t)?t.length===0:t instanceof Map||t instanceof Set?t.size===0:typeof t=="object"?Object.keys(t).length===0:!1}function d(t){return/^1[3-9]\d{9}$/.test(t)}function a(t){return/^\d{17}[\dXx]$/.test(t)}function l(t){return/^[\w.+-]+@[\w-]+(\.[\w-]+)+$/.test(t)}function p(t){if(typeof structuredClone=="function")try{return structuredClone(t)}catch{}return JSON.parse(JSON.stringify(t))}function h(t,n){if(!n)return Array.from(new Set(t));const e=new Set;return t.filter(o=>{const r=o[n];return e.has(r)?!1:(e.add(r),!0)})}function m(t,{idKey:n="id",parentKey:e="parentId",childrenKey:o="children"}={}){const r=new Map,s=[];return t.forEach(i=>{r.set(i[n],{...i,[o]:[]})}),t.forEach(i=>{const u=r.get(i[n]),c=r.get(i[e]);c?c[o].push(u):s.push(u)}),s}function y(t,n=300){let e;const o=(...r)=>{e&&clearTimeout(e),e=setTimeout(()=>t(...r),n)};return o.cancel=()=>{e&&clearTimeout(e),e=void 0},o}function w(t,n=300){let e=0;return(...o)=>{const r=Date.now();r-e>=n&&(e=r,t(...o))}}function T(t){return new Promise(n=>setTimeout(n,t))}exports.debounce=y;exports.deepClone=p;exports.isEmail=l;exports.isEmpty=f;exports.isIdCard=a;exports.isPhone=d;exports.listToTree=m;exports.sleep=T;exports.throttle=w;exports.uniqueBy=h;

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export * from './utils/index'
+export {}

package/dist/utils.js

@@ -0,0 +1,68 @@
+function f(t) {
+  return t == null || t === "" ? !0 : Array.isArray(t) ? t.length === 0 : t instanceof Map || t instanceof Set ? t.size === 0 : typeof t == "object" ? Object.keys(t).length === 0 : !1;
+}
+function d(t) {
+  return /^1[3-9]\d{9}$/.test(t);
+}
+function a(t) {
+  return /^\d{17}[\dXx]$/.test(t);
+}
+function p(t) {
+  return /^[\w.+-]+@[\w-]+(\.[\w-]+)+$/.test(t);
+}
+function h(t) {
+  if (typeof structuredClone == "function")
+    try {
+      return structuredClone(t);
+    } catch {
+    }
+  return JSON.parse(JSON.stringify(t));
+}
+function l(t, e) {
+  if (!e) return Array.from(new Set(t));
+  const n = /* @__PURE__ */ new Set();
+  return t.filter((o) => {
+    const r = o[e];
+    return n.has(r) ? !1 : (n.add(r), !0);
+  });
+}
+function w(t, { idKey: e = "id", parentKey: n = "parentId", childrenKey: o = "children" } = {}) {
+  const r = /* @__PURE__ */ new Map(), s = [];
+  return t.forEach((i) => {
+    r.set(i[e], { ...i, [o]: [] });
+  }), t.forEach((i) => {
+    const u = r.get(i[e]), c = r.get(i[n]);
+    c ? c[o].push(u) : s.push(u);
+  }), s;
+}
+function m(t, e = 300) {
+  let n;
+  const o = (...r) => {
+    n && clearTimeout(n), n = setTimeout(() => t(...r), e);
+  };
+  return o.cancel = () => {
+    n && clearTimeout(n), n = void 0;
+  }, o;
+}
+function y(t, e = 300) {
+  let n = 0;
+  return (...o) => {
+    const r = Date.now();
+    r - n >= e && (n = r, t(...o));
+  };
+}
+function T(t) {
+  return new Promise((e) => setTimeout(e, t));
+}
+export {
+  m as debounce,
+  h as deepClone,
+  p as isEmail,
+  f as isEmpty,
+  a as isIdCard,
+  d as isPhone,
+  w as listToTree,
+  T as sleep,
+  y as throttle,
+  l as uniqueBy
+};

package/package.json

@@ -1,69 +1,89 @@
-{
-  "name": "hd-attribute-set",
-  "version": "0.1.0",
-  "description": "属性集组件库，基于 React + antd",
-  "keywords": [
-    "react",
-    "component",
-    "antd",
-    "attribute-set"
-  ],
-  "license": "MIT",
-  "author": "szldjd",
-  "repository": {
-    "type": "git",
-    "url": "https://cnb.cool/szldjd/fee/hd-attribute-set"
-  },
-  "bugs": {
-    "url": "https://cnb.cool/szldjd/fee/hd-attribute-set/-/issues"
-  },
-  "homepage": "https://cnb.cool/szldjd/fee/hd-attribute-set",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "type": "module",
-  "sideEffects": [
-    "**/*.css",
-    "**/*.less"
-  ],
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "main": "dist/hd-attribute-set.umd.cjs",
-  "module": "dist/hd-attribute-set.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/hd-attribute-set.js",
-      "require": "./dist/hd-attribute-set.umd.cjs"
-    },
-    "./dist/*": "./dist/*",
-    "./dist/hd-attribute-set.css": "./dist/hd-attribute-set.css"
-  },
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc --noEmit && vite build",
-    "preview": "vite preview",
-    "prepublishOnly": "npm run build"
-  },
-  "peerDependencies": {
-    "antd": ">=5.0.0",
-    "react": ">=17.0.0",
-    "react-dom": ">=17.0.0"
-  },
-  "devDependencies": {
-    "@types/react": "^18.3.0",
-    "@types/react-dom": "^18.3.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "antd": "^5.21.0",
-    "less": "^4.2.0",
-    "react": "^18.3.0",
-    "react-dom": "^18.3.0",
-    "typescript": "^5.5.0",
-    "vite": "^5.4.0",
-    "vite-plugin-dts": "^4.2.0"
-  }
-}
+{
+  "name": "hd-attribute-set",
+  "version": "0.1.3",
+  "description": "属性集组件库，基于 React + antd",
+  "keywords": [
+    "react",
+    "component",
+    "antd",
+    "attribute-set"
+  ],
+  "license": "MIT",
+  "author": "szldjd",
+  "repository": {
+    "type": "git",
+    "url": "https://cnb.cool/szldjd/fee/hd-attribute-set"
+  },
+  "bugs": {
+    "url": "https://cnb.cool/szldjd/fee/hd-attribute-set/-/issues"
+  },
+  "homepage": "https://cnb.cool/szldjd/fee/hd-attribute-set",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css",
+    "**/*.less"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "dist/hd-attribute-set.cjs",
+  "module": "dist/hd-attribute-set.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/hd-attribute-set.js",
+      "require": "./dist/hd-attribute-set.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js",
+      "require": "./dist/utils.cjs"
+    },
+    "./hooks": {
+      "types": "./dist/hooks.d.ts",
+      "import": "./dist/hooks.js",
+      "require": "./dist/hooks.cjs"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "typesVersions": {
+    "*": {
+      "utils": [
+        "./dist/utils.d.ts"
+      ],
+      "hooks": [
+        "./dist/hooks.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "antd": ">=5.0.0",
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@types/node": "^20.14.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "antd": "^5.21.0",
+    "less": "^4.2.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "typescript": "^5.5.0",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^4.2.0"
+  }
+}

package/readme.md

@@ -0,0 +1,113 @@
+# hd-attribute-set
+
+基于 **TypeScript** 的工具/组件库，使用 Vite 库模式构建，通过 [CNB 云原生构建](https://docs.cnb.cool/) 自动发布到 npm。
+
+## 目录结构
+
+```
+├── .cnb.yml                # CNB 云原生构建流水线配置
+├── index.html              # 本地调试入口（playground）
+├── src
+│   ├── index.ts            # 包主入口（构建产物入口）
+│   ├── App.tsx / main.tsx  # 调试页面
+│   ├── utils               # 公共工具方法（多文件）
+│   │   ├── index.ts        # 统一出口（barrel）
+│   │   ├── format.ts
+│   │   ├── validate.ts
+│   │   ├── object.ts
+│   │   └── fn.ts
+│   └── hooks               # 业务 Hook（解耦后版本）
+│       ├── index.ts
+│       ├── use-btn-deal.ts
+│       ├── use-permission.ts
+│       ├── use-row-selection.ts
+│       └── use-memoized-fn.ts
+├── vite.config.ts          # Vite 配置（lib 模式，多入口）
+└── tsconfig.json
+```
+
+## 本地开发
+
+```bash
+npm install
+npm run dev            # 启动 playground 调试
+npm run build          # 构建产物到 dist/
+npm pack --dry-run     # 查看将要发布到 npm 的文件清单
+```
+
+## 新增工具方法
+
+1. 在 `src/utils/` 下新建文件（如 `string.ts`）并 `export` 方法；
+2. 在 `src/utils/index.ts` 加一行 `export * from './string';`；
+3. `npm run build`，新方法即自动出现在包根路径与 `hd-attribute-set/utils` 两个入口。
+
+## 在其他项目中使用
+
+安装：
+
+```bash
+npm i hd-attribute-set
+```
+
+引入方式（三个入口，按需选择）：
+
+```ts
+// 1. 根路径：通用工具
+import { formatMoney, version } from 'hd-attribute-set';
+
+// 2. utils 子路径
+import { isEmail, listToTree } from 'hd-attribute-set/utils';
+
+// 3. hooks 子路径（已对权限/按钮/表格做解耦，可与任意数据源配合）
+import { useBtnDeal, usePermission, useRowSelection } from 'hd-attribute-set/hooks';
+```
+
+CommonJS 环境：
+
+```js
+const { formatMoney } = require('hd-attribute-set');
+const { isPhone } = require('hd-attribute-set/utils');
+const { useBtnDeal } = require('hd-attribute-set/hooks');
+```
+
+### hooks 用法示例
+
+> 所有 hooks 都已与 Redux/ahooks 解耦，权限数据通过 `getAccessConfig` 注入。
+
+```tsx
+import { useSelector } from 'react-redux';
+import { useBtnDeal, usePermission } from 'hd-attribute-set/hooks';
+
+// 接 Redux
+const access = useSelector(s => s.auth.accessConfig);
+const { controlShowStatus } = useBtnDeal(() => access);
+// 或接任意数据源
+const { hasPermission } = usePermission(() => ({ noPermissionShow: true, list: [], selectAll: true }));
+
+const [editVisible, editBtn] = controlShowStatus({
+  type: 'edit',
+  detail: rowData,
+  configBtns: btnConfigs,   // 来自后端/配置的按钮列表
+});
+{editVisible && <Button {...editBtn}>编辑</Button>}
+```
+
+## 发布到 npm（云原生构建）
+
+1. 在 npmjs.com 生成 Access Token（Classic Token 选 **Automation**，或 Granular Token 勾选 **Read and write**）。
+2. 在 CNB 仓库设置中配置环境变量 `NPM_TOKEN`（或放入密钥仓库，并在 `.cnb.yml` 的 `tag_push` 中增加 `imports` 指向密钥仓库）。
+3. push 到 `main` 分支会自动执行安装 + 构建校验；发布正式版时推送 tag：
+
+```bash
+npm version patch        # 0.1.0 -> 0.1.1，自动提交 tag
+git push origin main --tags
+```
+
+流水线将自动构建并执行 `npm publish`（`prepublishOnly` 也会兜底执行构建）。
+
+## 发布前检查清单
+
+- [ ] `package.json` 的 `version` 已升版（与 tag 一致）。
+- [ ] `npm run build` 通过，`dist` 含 `hd-attribute-set.js/.cjs`、`utils.js/.cjs` 及对应 `.d.ts`。
+- [ ] `npm pack --dry-run` 中仅包含 `dist` 与 `README.md`，无源码泄露。
+- [ ] 如使用了组件，需确认使用方已安装 `antd`（peer 依赖，不打包进产物）。

package/README.md

@@ -1,62 +0,0 @@
-# hd-attribute-set
-
-基于 **React + TypeScript + antd** 的属性集组件库，使用 Vite 库模式构建，通过 [CNB 云原生构建](https://docs.cnb.cool/) 自动发布到 npm。
-
-## 目录结构
-
-```
-├── .cnb.yml                # CNB 云原生构建流水线配置
-├── index.html              # 本地调试入口（playground）
-├── src
-│   ├── index.ts            # 组件库入口（构建产物入口）
-│   ├── App.tsx             # 调试页面
-│   ├── main.tsx            # 调试页面挂载入口
-│   └── components
-│       └── attribute-set   # 属性集组件（antd）
-├── vite.config.ts          # Vite 配置（lib 模式）
-└── tsconfig.json
-```
-
-## 本地开发
-
-```bash
-npm install
-npm run dev      # 启动 playground 调试组件
-npm run build    # 构建产物到 dist/（ESM + UMD + CSS + 类型声明）
-npm pack --dry-run   # 查看将要发布到 npm 的文件清单
-```
-
-## 使用示例
-
-```tsx
-import { AttributeSet } from 'hd-attribute-set';
-import 'hd-attribute-set/dist/hd-attribute-set.css';
-
-<AttributeSet
-  title="基础属性"
-  items={[
-    { key: 'cpu', label: 'CPU', value: '8 核' },
-    { key: 'memory', label: '内存', value: '16 GB' },
-  ]}
-/>
-```
-
-## 发布到 npm（云原生构建）
-
-1. 在 npmjs.com 生成 Access Token。
-2. 在 CNB 仓库设置中配置环境变量 `NPM_TOKEN`（或放入密钥仓库，并在 `.cnb.yml` 的 `tag_push` 中增加 `imports` 指向密钥仓库）。
-3. push 到 `main` 分支会自动执行安装 + 构建校验；发布正式版时推送 tag：
-
-```bash
-npm version patch        # 0.1.0 -> 0.1.1，自动提交 tag
-git push origin main --tags
-```
-
-流水线将自动构建并执行 `npm publish`（`prepublishOnly` 也会兜底执行构建）。
-
-## 发布前检查清单
-
-- [ ] `package.json` 的 `version` 已升版（与 tag 一致）。
-- [ ] `npm run build` 通过，`dist` 含 `hd-attribute-set.js`、`hd-attribute-set.umd.cjs`、`hd-attribute-set.css`、`index.d.ts`。
-- [ ] `npm pack --dry-run` 中仅包含 `dist` 与 `README.md`，无源码泄露。
-- [ ] 使用方已安装 `antd`（peer 依赖，不在包内打包）。

package/dist/components/attribute-set/index.d.ts

@@ -1,7 +0,0 @@
-import { AttributeItem, AttributeSetProps } from './types';
-export type { AttributeItem, AttributeSetProps };
-/**
- * 属性集组件：以 antd Descriptions 展示一组键值属性
- */
-export declare function AttributeSet({ items, title, column, bordered, emptyText }: AttributeSetProps): import("react").JSX.Element;
-export default AttributeSet;

package/dist/components/attribute-set/types.d.ts

@@ -1,27 +0,0 @@
-import { ReactNode } from 'react';
-/** 单个属性项 */
-export interface AttributeItem {
-    /** 唯一标识 */
-    key: string;
-    /** 属性名 */
-    label: ReactNode;
-    /** 属性值 */
-    value?: ReactNode;
-    /** 自定义渲染 */
-    render?: (value?: ReactNode) => ReactNode;
-    /** Descriptions 的栅格跨度 */
-    span?: number;
-}
-/** AttributeSet 组件属性 */
-export interface AttributeSetProps {
-    /** 属性集标题 */
-    title?: ReactNode;
-    /** 属性项列表 */
-    items: AttributeItem[];
-    /** 每行列数，默认 2 */
-    column?: number;
-    /** 是否显示边框，默认 true */
-    bordered?: boolean;
-    /** 空数据提示文案 */
-    emptyText?: string;
-}

package/dist/hd-attribute-set.css

@@ -1 +0,0 @@
-.hd-attribute-set__title{font-size:16px;font-weight:600}

package/dist/hd-attribute-set.umd.cjs

@@ -1 +0,0 @@
-(function(r,e){typeof exports=="object"&&typeof module<"u"?e(exports,require("react/jsx-runtime"),require("antd")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","antd"],e):(r=typeof globalThis<"u"?globalThis:r||self,e(r.HdAttributeSet={},r.jsxRuntime,r.antd))})(this,function(r,e,s){"use strict";function n({items:d,title:i,column:l=2,bordered:c=!0,emptyText:p="暂无属性"}){return!d||d.length===0?e.jsxs("div",{className:"hd-attribute-set",children:[i&&e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"hd-attribute-set__title",children:i}),e.jsx(s.Divider,{style:{margin:"8px 0 16px"}})]}),e.jsx(s.Empty,{image:s.Empty.PRESENTED_IMAGE_SIMPLE,description:p})]}):e.jsxs("div",{className:"hd-attribute-set",children:[i&&e.jsxs(e.Fragment,{children:[e.jsx("div",{className:"hd-attribute-set__title",children:i}),e.jsx(s.Divider,{style:{margin:"8px 0 16px"}})]}),e.jsx(s.Descriptions,{size:"small",column:l,bordered:c,items:d.map(t=>({key:t.key,label:t.label,children:t.render?t.render(t.value):t.value??"-",span:t.span}))})]})}const a="0.1.0";r.AttributeSet=n,r.version=a,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})});