@yuku123/z-meta-component 0.1.1 → 0.1.2

package/dist/ComponentDoc-IVc3HvAO.js

@@ -0,0 +1,564 @@
+import { Routes as oe, Route as g, Navigate as de } from "react-router-dom";
+import { Tag as d, Alert as le, Table as F, Tooltip as ce, Typography as pe } from "antd";
+import { createRequest as ue } from "@yuku123/z-frontend-common";
+import { PagedTable as T, ComponentDoc as me } from "@yuku123/z-frontend-common/ui";
+import fe, { useState as xe, useEffect as ge } from "react";
+const u = ue({ baseURL: "/meta" });
+function Ce(t) {
+  t && t.apiBase !== void 0 && (u.defaults.baseURL = t.apiBase);
+}
+var w = { exports: {} }, k = {};
+/**
+ * @license React
+ * react-jsx-runtime.production.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var Y;
+function _e() {
+  if (Y) return k;
+  Y = 1;
+  var t = Symbol.for("react.transitional.element"), a = Symbol.for("react.fragment");
+  function c(p, l, m) {
+    var E = null;
+    if (m !== void 0 && (E = "" + m), l.key !== void 0 && (E = "" + l.key), "key" in l) {
+      m = {};
+      for (var j in l)
+        j !== "key" && (m[j] = l[j]);
+    } else m = l;
+    return l = m.ref, {
+      $$typeof: t,
+      type: p,
+      key: E,
+      ref: l !== void 0 ? l : null,
+      props: m
+    };
+  }
+  return k.Fragment = a, k.jsx = c, k.jsxs = c, k;
+}
+var h = {};
+/**
+ * @license React
+ * react-jsx-runtime.development.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+var $;
+function ye() {
+  return $ || ($ = 1, process.env.NODE_ENV !== "production" && (function() {
+    function t(e) {
+      if (e == null) return null;
+      if (typeof e == "function")
+        return e.$$typeof === re ? null : e.displayName || e.name || null;
+      if (typeof e == "string") return e;
+      switch (e) {
+        case R:
+          return "Fragment";
+        case H:
+          return "Profiler";
+        case V:
+          return "StrictMode";
+        case Q:
+          return "Suspense";
+        case ee:
+          return "SuspenseList";
+        case ne:
+          return "Activity";
+        case ae:
+          return "ViewTransition";
+      }
+      if (typeof e == "object")
+        switch (typeof e.tag == "number" && console.error(
+          "Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."
+        ), e.$$typeof) {
+          case J:
+            return "Portal";
+          case Z:
+            return e.displayName || "Context";
+          case X:
+            return (e._context.displayName || "Context") + ".Consumer";
+          case K:
+            var r = e.render;
+            return e = e.displayName, e || (e = r.displayName || r.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
+          case te:
+            return r = e.displayName || null, r !== null ? r : t(e.type) || "Memo";
+          case v:
+            r = e._payload, e = e._init;
+            try {
+              return t(e(r));
+            } catch {
+            }
+        }
+      return null;
+    }
+    function a(e) {
+      return "" + e;
+    }
+    function c(e) {
+      try {
+        a(e);
+        var r = !1;
+      } catch {
+        r = !0;
+      }
+      if (r) {
+        r = console;
+        var i = r.error, s = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
+        return i.call(
+          r,
+          "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
+          s
+        ), a(e);
+      }
+    }
+    function p(e) {
+      if (e === R) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === v)
+        return "<...>";
+      try {
+        var r = t(e);
+        return r ? "<" + r + ">" : "<...>";
+      } catch {
+        return "<...>";
+      }
+    }
+    function l() {
+      var e = P.A;
+      return e === null ? null : e.getOwner();
+    }
+    function m() {
+      return Error("react-stack-top-frame");
+    }
+    function E(e) {
+      if (z.call(e, "key")) {
+        var r = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (r && r.isReactWarning) return !1;
+      }
+      return e.key !== void 0;
+    }
+    function j(e, r) {
+      function i() {
+        N || (N = !0, console.error(
+          "%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",
+          r
+        ));
+      }
+      i.isReactWarning = !0, Object.defineProperty(e, "key", {
+        get: i,
+        configurable: !0
+      });
+    }
+    function B() {
+      var e = t(this.type);
+      return D[e] || (D[e] = !0, console.error(
+        "Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release."
+      )), e = this.props.ref, e !== void 0 ? e : null;
+    }
+    function W(e, r, i, s, x, f) {
+      var o = i.ref;
+      return e = {
+        $$typeof: C,
+        type: e,
+        key: r,
+        props: i,
+        _owner: s
+      }, (o !== void 0 ? o : null) !== null ? Object.defineProperty(e, "ref", {
+        enumerable: !1,
+        get: B
+      }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: 0
+      }), Object.defineProperty(e, "_debugInfo", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: null
+      }), Object.defineProperty(e, "_debugStack", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: x
+      }), Object.defineProperty(e, "_debugTask", {
+        configurable: !1,
+        enumerable: !1,
+        writable: !0,
+        value: f
+      }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
+    }
+    function L(e, r, i, s, x, f) {
+      var o = r.children;
+      if (o !== void 0)
+        if (s)
+          if (ie(o)) {
+            for (s = 0; s < o.length; s++)
+              O(o[s]);
+            Object.freeze && Object.freeze(o);
+          } else
+            console.error(
+              "React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead."
+            );
+        else O(o);
+      if (z.call(r, "key")) {
+        o = t(e);
+        var y = Object.keys(r).filter(function(se) {
+          return se !== "key";
+        });
+        s = 0 < y.length ? "{key: someKey, " + y.join(": ..., ") + ": ...}" : "{key: someKey}", U[o + s] || (y = 0 < y.length ? "{" + y.join(": ..., ") + ": ...}" : "{}", console.error(
+          `A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`,
+          s,
+          o,
+          y,
+          o
+        ), U[o + s] = !0);
+      }
+      if (o = null, i !== void 0 && (c(i), o = "" + i), E(r) && (c(r.key), o = "" + r.key), "key" in r) {
+        i = {};
+        for (var A in r)
+          A !== "key" && (i[A] = r[A]);
+      } else i = r;
+      return o && j(
+        i,
+        typeof e == "function" ? e.displayName || e.name || "Unknown" : e
+      ), W(
+        e,
+        o,
+        i,
+        l(),
+        x,
+        f
+      );
+    }
+    function O(e) {
+      S(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === v && (e._payload.status === "fulfilled" ? S(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
+    }
+    function S(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === C;
+    }
+    var b = fe, C = Symbol.for("react.transitional.element"), J = Symbol.for("react.portal"), R = Symbol.for("react.fragment"), V = Symbol.for("react.strict_mode"), H = Symbol.for("react.profiler"), X = Symbol.for("react.consumer"), Z = Symbol.for("react.context"), K = Symbol.for("react.forward_ref"), Q = Symbol.for("react.suspense"), ee = Symbol.for("react.suspense_list"), te = Symbol.for("react.memo"), v = Symbol.for("react.lazy"), ne = Symbol.for("react.activity"), ae = Symbol.for("react.view_transition"), re = Symbol.for("react.client.reference"), P = b.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, z = Object.prototype.hasOwnProperty, ie = Array.isArray, I = console.createTask ? console.createTask : function() {
+      return null;
+    };
+    b = {
+      react_stack_bottom_frame: function(e) {
+        return e();
+      }
+    };
+    var N, D = {}, G = b.react_stack_bottom_frame.bind(
+      b,
+      m
+    )(), M = I(p(m)), U = {};
+    h.Fragment = R, h.jsx = function(e, r, i) {
+      var s = 1e4 > P.recentlyCreatedOwnerStacks++;
+      if (s) {
+        var x = Error.stackTraceLimit;
+        Error.stackTraceLimit = 10;
+        var f = Error("react-stack-top-frame");
+        Error.stackTraceLimit = x;
+      } else f = G;
+      return L(
+        e,
+        r,
+        i,
+        !1,
+        f,
+        s ? I(p(e)) : M
+      );
+    }, h.jsxs = function(e, r, i) {
+      var s = 1e4 > P.recentlyCreatedOwnerStacks++;
+      if (s) {
+        var x = Error.stackTraceLimit;
+        Error.stackTraceLimit = 10;
+        var f = Error("react-stack-top-frame");
+        Error.stackTraceLimit = x;
+      } else f = G;
+      return L(
+        e,
+        r,
+        i,
+        !0,
+        f,
+        s ? I(p(e)) : M
+      );
+    };
+  })()), h;
+}
+var q;
+function Te() {
+  return q || (q = 1, process.env.NODE_ENV === "production" ? w.exports = _e() : w.exports = ye()), w.exports;
+}
+var n = Te();
+const _ = {
+  appPage: (t, a) => u.get("/meta-app/list", { params: { pageNum: t, pageSize: a } }),
+  appGet: (t) => u.get("/meta-app/get", { params: { id: t } }),
+  tenantPage: (t, a) => u.get("/meta-tenant/list", { params: { pageNum: t, pageSize: a } }),
+  dictTypePage: (t, a, c) => u.get("/dict/type/list", { params: { pageNum: t, pageSize: a, dictName: c } }),
+  dictItemsByCode: (t) => u.get("/dict/items/get", { params: { dictCode: t } }),
+  dictItemsByTypeId: (t) => u.get("/dict/item/list", { params: { dictId: t } }),
+  interfacePage: (t, a) => u.get("/interface/list", { params: { pageNum: t, pageSize: a } }),
+  interfaceByApp: (t) => u.get("/interface/app/list", { params: { appId: t } }),
+  privateConfigPage: (t, a) => u.get("/private-config/list", { params: { pageNum: t, pageSize: a } }),
+  bizModels: () => u.get("/meta/models")
+}, Ee = (t) => t === 1 ? /* @__PURE__ */ n.jsx(d, { color: "success", children: "启用" }) : /* @__PURE__ */ n.jsx(d, { color: "default", children: "停用" });
+function je() {
+  return /* @__PURE__ */ n.jsx(
+    T,
+    {
+      title: "应用元数据",
+      description: "z-meta 登记在册的应用（数据源 GET /api/meta-app/list）",
+      load: (t, a) => _.appPage(t, a),
+      columns: [
+        { title: "应用编码", dataIndex: "app_code", key: "app_code", width: 180 },
+        { title: "应用名称", dataIndex: "app_name", key: "app_name" },
+        { title: "类型", dataIndex: "app_type", key: "app_type", width: 100, render: (t) => /* @__PURE__ */ n.jsx(d, { children: t }) },
+        {
+          title: "入口地址",
+          dataIndex: "base_url",
+          key: "base_url",
+          ellipsis: !0,
+          render: (t) => t || "-"
+        },
+        { title: "负责人", dataIndex: "owner", key: "owner", width: 110 },
+        { title: "状态", dataIndex: "status", key: "status", width: 90, render: Ee },
+        { title: "描述", dataIndex: "description", key: "description", ellipsis: !0 },
+        { title: "创建时间", dataIndex: "gmt_create", key: "gmt_create", width: 170 }
+      ]
+    }
+  );
+}
+function ke() {
+  return /* @__PURE__ */ n.jsx(
+    T,
+    {
+      title: "租户管理",
+      description: "z-meta 租户台账（数据源 GET /api/meta-tenant/list）",
+      load: (t, a) => _.tenantPage(t, a),
+      columns: [
+        { title: "租户编码", dataIndex: "tenant_code", key: "tenant_code", width: 160 },
+        { title: "租户名称", dataIndex: "tenant_name", key: "tenant_name" },
+        {
+          title: "类型",
+          dataIndex: "tenant_type",
+          key: "tenant_type",
+          width: 110,
+          render: (t) => t ? /* @__PURE__ */ n.jsx(d, { children: t }) : "-"
+        },
+        {
+          title: "状态",
+          dataIndex: "status",
+          key: "status",
+          width: 90,
+          render: (t) => t === 1 ? /* @__PURE__ */ n.jsx(d, { color: "success", children: "正常" }) : /* @__PURE__ */ n.jsx(d, { children: "停用" })
+        },
+        { title: "到期时间", dataIndex: "expire_time", key: "expire_time", width: 170, render: (t) => t || "长期" },
+        { title: "描述", dataIndex: "description", key: "description", ellipsis: !0 },
+        { title: "创建时间", dataIndex: "gmt_create", key: "gmt_create", width: 170 }
+      ]
+    }
+  );
+}
+function he({ dictCode: t }) {
+  const [a, c] = xe({ loading: !0, rows: [], error: null });
+  return ge(() => {
+    let p = !1;
+    return c({ loading: !0, rows: [], error: null }), _.dictItemsByCode(t).then((l) => {
+      p || c({ loading: !1, rows: l || [], error: null });
+    }).catch((l) => {
+      p || c({ loading: !1, rows: [], error: l });
+    }), () => {
+      p = !0;
+    };
+  }, [t]), a.error ? /* @__PURE__ */ n.jsx(
+    le,
+    {
+      type: "error",
+      showIcon: !0,
+      message: `字典项加载失败：${a.error.message || a.error}`
+    }
+  ) : /* @__PURE__ */ n.jsx(
+    F,
+    {
+      size: "small",
+      rowKey: "id",
+      loading: a.loading,
+      dataSource: a.rows,
+      pagination: !1,
+      columns: [
+        { title: "项编码", dataIndex: "item_code", key: "item_code", width: 180 },
+        { title: "项名称", dataIndex: "item_name", key: "item_name" },
+        { title: "值", dataIndex: "item_value", key: "item_value", width: 120 },
+        { title: "排序", dataIndex: "sort_order", key: "sort_order", width: 80 },
+        {
+          title: "状态",
+          dataIndex: "status",
+          key: "status",
+          width: 90,
+          render: (p) => p === 1 ? /* @__PURE__ */ n.jsx(d, { color: "success", children: "启用" }) : /* @__PURE__ */ n.jsx(d, { children: "停用" })
+        }
+      ],
+      locale: { emptyText: `字典 ${t} 下暂无字典项` }
+    }
+  );
+}
+function be() {
+  return /* @__PURE__ */ n.jsx(
+    T,
+    {
+      title: "数据字典",
+      description: "字典类型台账；展开行按 dict_code 实时拉取字典项（GET /api/dict/type/list + /api/dict/items/get）",
+      load: (t, a) => _.dictTypePage(t, a),
+      columns: [
+        { title: "字典编码", dataIndex: "dict_code", key: "dict_code", width: 200 },
+        { title: "字典名称", dataIndex: "dict_name", key: "dict_name" },
+        {
+          title: "值类型",
+          dataIndex: "dict_type",
+          key: "dict_type",
+          width: 110,
+          render: (t) => t ? /* @__PURE__ */ n.jsx(d, { children: t }) : "-"
+        },
+        {
+          title: "状态",
+          dataIndex: "status",
+          key: "status",
+          width: 90,
+          render: (t) => t === 1 ? /* @__PURE__ */ n.jsx(d, { color: "success", children: "启用" }) : /* @__PURE__ */ n.jsx(d, { children: "停用" })
+        },
+        { title: "描述", dataIndex: "description", key: "description", ellipsis: !0 },
+        { title: "更新时间", dataIndex: "gmt_modified", key: "gmt_modified", width: 170 }
+      ],
+      expandable: {
+        expandedRowRender: (t) => /* @__PURE__ */ n.jsx(he, { dictCode: t.dict_code }),
+        rowExpandable: (t) => !!t.dict_code
+      }
+    }
+  );
+}
+function we() {
+  return /* @__PURE__ */ n.jsx(
+    T,
+    {
+      title: "接口台账",
+      description: "z-meta 登记的业务接口清单（数据源 GET /api/interface/list）",
+      load: (t, a) => _.interfacePage(t, a),
+      columns: [
+        { title: "接口名称", dataIndex: "api_name", key: "api_name" },
+        { title: "方法", dataIndex: "api_method", key: "api_method", width: 90, render: (t) => /* @__PURE__ */ n.jsx(d, { children: t }) },
+        { title: "路径", dataIndex: "api_path", key: "api_path", ellipsis: !0 },
+        { title: "版本", dataIndex: "api_version", key: "api_version", width: 90 },
+        { title: "鉴权", dataIndex: "auth_type", key: "auth_type", width: 120 },
+        {
+          title: "状态",
+          key: "status",
+          width: 120,
+          render: (t, a) => a.deprecated === 1 ? /* @__PURE__ */ n.jsx(d, { color: "warning", children: "已废弃" }) : a.status === 1 ? /* @__PURE__ */ n.jsx(d, { color: "success", children: "启用" }) : /* @__PURE__ */ n.jsx(d, { children: "停用" })
+        },
+        { title: "描述", dataIndex: "description", key: "description", ellipsis: !0 }
+      ]
+    }
+  );
+}
+function Re() {
+  return /* @__PURE__ */ n.jsx(
+    T,
+    {
+      title: "私有配置",
+      description: "应用私有键值配置（数据源 GET /api/private-config/list）",
+      load: (t, a) => _.privateConfigPage(t, a),
+      columns: [
+        { title: "配置键", dataIndex: "config_key", key: "config_key", width: 240 },
+        {
+          title: "配置值",
+          dataIndex: "config_value",
+          key: "config_value",
+          ellipsis: !0,
+          render: (t) => t ? /* @__PURE__ */ n.jsx(ce, { title: t, children: /* @__PURE__ */ n.jsx(pe.Text, { code: !0, copyable: { text: t }, children: t }) }) : "-"
+        },
+        { title: "描述", dataIndex: "description", key: "description", ellipsis: !0 },
+        { title: "更新时间", dataIndex: "gmt_modified", key: "gmt_modified", width: 170 }
+      ]
+    }
+  );
+}
+function ve() {
+  return /* @__PURE__ */ n.jsx(
+    T,
+    {
+      title: "业务模型",
+      description: "z-meta 的结构化业务模型清单（数据源 GET /api/meta/models，字段随模型一次性返回）",
+      load: () => _.bizModels(),
+      rowKey: "code",
+      columns: [
+        { title: "模型编码", dataIndex: "code", key: "code", width: 200 },
+        { title: "模型名称", dataIndex: "name", key: "name", width: 180 },
+        {
+          title: "所属模块",
+          dataIndex: "module",
+          key: "module",
+          width: 160,
+          render: (t) => /* @__PURE__ */ n.jsx(d, { color: "blue", children: t })
+        },
+        { title: "实体类", dataIndex: "class_name", key: "class_name", ellipsis: !0 },
+        {
+          title: "字段数",
+          key: "fieldCount",
+          width: 90,
+          render: (t, a) => (a.fields || []).length
+        },
+        { title: "描述", dataIndex: "description", key: "description", ellipsis: !0 }
+      ],
+      expandable: {
+        rowExpandable: (t) => (t.fields || []).length > 0,
+        expandedRowRender: (t) => /* @__PURE__ */ n.jsx(
+          F,
+          {
+            size: "small",
+            rowKey: (a) => `${t.code}:${a.field_name}`,
+            dataSource: t.fields || [],
+            pagination: !1,
+            columns: [
+              { title: "字段名", dataIndex: "name", key: "name", width: 160 },
+              { title: "属性", dataIndex: "field_name", key: "field_name", width: 200 },
+              { title: "类型", dataIndex: "type", key: "type", width: 120, render: (a) => /* @__PURE__ */ n.jsx(d, { children: a }) },
+              { title: "关联模型", dataIndex: "ref_model", key: "ref_model", render: (a) => a || "-" },
+              { title: "字典", dataIndex: "dict_code", key: "dict_code", render: (a) => a || "-" }
+            ]
+          }
+        )
+      }
+    }
+  );
+}
+function ze() {
+  return /* @__PURE__ */ n.jsxs(oe, { children: [
+    /* @__PURE__ */ n.jsx(g, { index: !0, element: /* @__PURE__ */ n.jsx(de, { to: "app", replace: !0 }) }),
+    /* @__PURE__ */ n.jsx(g, { path: "app", element: /* @__PURE__ */ n.jsx(je, {}) }),
+    /* @__PURE__ */ n.jsx(g, { path: "tenant", element: /* @__PURE__ */ n.jsx(ke, {}) }),
+    /* @__PURE__ */ n.jsx(g, { path: "dict", element: /* @__PURE__ */ n.jsx(be, {}) }),
+    /* @__PURE__ */ n.jsx(g, { path: "interface", element: /* @__PURE__ */ n.jsx(we, {}) }),
+    /* @__PURE__ */ n.jsx(g, { path: "private-config", element: /* @__PURE__ */ n.jsx(Re, {}) }),
+    /* @__PURE__ */ n.jsx(g, { path: "models", element: /* @__PURE__ */ n.jsx(ve, {}) })
+  ] });
+}
+const Pe = "# z-meta-component\n\nz-meta（元数据中心）跨仓唯一前端面：把「租户 / 应用 / 数据字典 / 接口台账 / 私有配置 / 业务模型」\n这一整套元数据页面收敛成一个可复用的 React 组件包。\n\n- **npm 包名**：`@yuku123/z-meta-component`\n- **宿主接入**：`@yuku123/z-meta-component/pages`（manifest + API），主壳可只取 `ComponentDocPage`\n- **后端**：z-opc 主进程 8888 的元数据接口，请求实例 `baseURL='/meta'`，前缀由 `configureMeta` 注入\n- **技术栈**：React 19 + antd 6 + react-router-dom 7 + vite（library mode，双入口 `.` / `./pages`）\n\n---\n\n## 一、能力概览\n\n路由前缀 `/z-meta`，菜单与路由在 `src/pages-manifest.jsx` 里声明。\n\n| 页面 | 路由（相对 `/z-meta/*`） | 源文件 | 能力 |\n|------|--------------------------|--------|------|\n| 登录 | `login` | `pages/login/Login.jsx` | 用户名密码登录（suit 侧单独挂这条路由） |\n| 首页 | `home` | `pages/HomePage.jsx` | 入口卡片页 |\n| 概览 | `dashboard` | `pages/Dashboard.jsx` | 租户 / 应用 / 字典 / 接口四张统计卡（当前为静态占位值） |\n| 租户管理 | `tenant` | `pages/tenant/TenantList.jsx` | 租户台账的增删改查 |\n| 应用管理 | `app` | `pages/application/AppList.jsx` | 应用台账的增删改查 |\n| 字典管理 | `dict` | `pages/dict/DictList.jsx` | 字典类型 + 字典项两级增删改查 |\n| 接口管理 | `api` | `pages/api/ApiList.jsx` | 接口台账的增删改查 |\n| 应用元数据（只读台账） | `*/app` | `pages/AppList.jsx` | 只读应用列表（基座 `PagedTable`） |\n| 租户管理（只读台账） | `*/tenant` | `pages/TenantList.jsx` | 只读租户列表（基座 `PagedTable`） |\n| 数据字典（只读台账） | `*/dict` | `pages/DictList.jsx` | 只读字典类型列表，展开行按 `dict_code` 实时拉字典项 |\n| 接口台账 | `*/interface` | `pages/InterfaceList.jsx` | 只读业务接口清单（基座 `PagedTable`） |\n| 私有配置 | `*/private-config` | `pages/PrivateConfigList.jsx` | 只读应用私有键值配置（基座 `PagedTable`） |\n| 业务模型 | `*/models` | `pages/BizModels.jsx` | 只读结构化业务模型清单（含字段数） |\n| 组件文档 | `docs` | `pages/ComponentDoc.jsx` | 本文件渲染页（左侧 240px TOC + 右侧正文） |\n\n`src/pages/MetaApp.jsx` 是只读台账一组的子路由挂载点（`app` / `tenant` / `dict` / `interface` /\n`private-config` / `models`），被 `routes` 里的 `/z-meta/:rest*` 承接，同时从包根具名导出。\n\n> ⚠ **两套同名页面并存**：manifest 里 `/z-meta/tenant`、`/z-meta/app`、`/z-meta/dict`、`/z-meta/api`\n> 挂的是 `pages/{tenant,application,dict,api}/` 下的**可写 CRUD 版**；`MetaApp` 里的\n> `app` / `tenant` / `dict` 挂的是 `pages/` 根目录下的**只读台账版**。路由不同、行为不同，别混。\n\n## 二、导出面\n\n```js\n// 主入口（. 桶）\nimport {configureMeta, MetaApp, ComponentDocPage} from '@yuku123/z-meta-component'\n\n// 宿主组装面（./pages 桶）\nimport {menuItems, routes, HomePage, LoginPage, Dashboard} from '@yuku123/z-meta-component/pages'\n```\n\n`./pages` 桶 = `export * from './pages-manifest.jsx'` 的整份转发 + `configureMeta` 再导出。\n**不要再手挑名字** —— 之前手挑过一次，manifest 新增的 `HomePage` / `LoginPage` 没被转发，\nrollup 直接报 `LoginPage is not exported by dist/pages.js`。\n\n## 三、API 端点\n\n`src/services/api.js` 的 `metaApi`（下表是代码里写的路径，请求实例 `baseURL='/meta'`）：\n\n| 方法 | 路径 | 说明 |\n|---|---|---|\n| GET | `/meta-app/list` | 应用列表（query `pageNum` / `pageSize`） |\n| GET | `/meta-app/get` | 应用详情（query `id`） |\n| GET | `/meta-tenant/list` | 租户列表（query `pageNum` / `pageSize`） |\n| GET | `/dict/type/list` | 字典类型列表（query `pageNum` / `pageSize` / `dictName`） |\n| GET | `/dict/items/get` | 按 `dict_code` 取字典项（query `dictCode`） |\n| GET | `/dict/item/list` | 按字典类型 id 取字典项（query `dictId`） |\n| GET | `/interface/list` | 接口台账列表 |\n| GET | `/interface/app/list` | 按应用查接口（query `appId`） |\n| GET | `/private-config/list` | 私有配置列表 |\n| GET | `/meta/models` | 业务模型清单 |\n\n可写 CRUD 版页面（`pages/{tenant,application,dict,api}/`）不走 `metaApi`，而是直接用\n`services/request.js` 的实例，路径如下：\n\n| 方法 | 路径 | 说明 |\n|---|---|---|\n| GET | `/tenant/list` | 租户列表 |\n| POST | `/tenant` | 新建租户 |\n| PUT | `/tenant/{id}` | 修改租户 |\n| DELETE | `/tenant/{id}` | 删除租户 |\n| GET | `/app/list` | 应用列表 |\n| POST | `/app` | 新建应用 |\n| PUT | `/app/{id}` | 修改应用 |\n| DELETE | `/app/{id}` | 删除应用 |\n| GET | `/interface/list` | 接口列表 |\n| POST | `/interface` | 新建接口 |\n| PUT | `/interface/{id}` | 修改接口 |\n| DELETE | `/interface/{id}` | 删除接口 |\n| GET | `/dict/type/list` | 字典类型列表 |\n| POST | `/dict/type` | 新建字典类型 |\n| PUT | `/dict/type/{id}` | 修改字典类型 |\n| DELETE | `/dict/type/{id}` | 删除字典类型 |\n| GET | `/dict/item/list` | 字典项列表 |\n| POST | `/dict/item` | 新建字典项 |\n| PUT | `/dict/item/{id}` | 修改字典项 |\n| DELETE | `/dict/item/{id}` | 删除字典项 |\n\n## 四、页面说明\n\n### 4.1 概览\n\n四张统计卡（租户数量 / 应用数量 / 字典数量 / 接口数量）。⚠ 当前卡里的数值是**写死的占位值**\n（租户 1、其余 0），不接后端 —— 展示真实数值的页面是 `MetaApp` 下的只读台账。\n\n### 4.2 租户 / 应用 / 接口管理（可写）\n\n标准台账页：列表 + 新建 / 编辑弹窗 + 删除（`Popconfirm` 二次确认）。列表统一用基座 `ListTable`。\n\n### 4.3 字典管理（可写）\n\n两级结构：字典类型为父行，字典项按类型展开。类型与字典项各自支持增删改查。\n\n### 4.4 只读台账一组\n\n`pages/AppList.jsx` / `TenantList.jsx` / `InterfaceList.jsx` / `PrivateConfigList.jsx` /\n`BizModels.jsx` 都是基座 `PagedTable` 的薄用法：给 `title` / `description` / `load` / `columns` 即可。\n`description` 里写明了各自的数据源端点，方便排查。\n\n### 4.5 数据字典（只读台账）\n\n字典类型列表，展开行按 `dict_code` 实时拉字典项（`GET /dict/type/list` + `GET /dict/items/get`）。\n\n### 4.6 业务模型\n\n结构化业务模型清单，`fields` 一次性返回，表格里用 `(r.fields || []).length` 显示字段数。\n\n### 4.7 组件文档\n\n本文件。内容以 `?raw` 在编译期内联，零额外请求；左侧 240px TOC 随滚动联动。\n\n## 五、配置\n\n| 配置项 | 默认值 | 说明 |\n|---|---|---|\n| `configureMeta({apiBase})` | `'/meta'` | 改写请求实例的 `baseURL`，宿主换挂载前缀时用 |\n| token 存储键 | `token` | 基座默认键，token 注入与 401 处理统一走共享拦截器 |\n| 鉴权头 | `Authorization: Bearer` | 基座拦截器自动附加 |\n\n## 六、已知限制\n\n- **同名两套页面**（可写 CRUD 版 vs 只读台账版）并存，改动前先确认改的是哪一套，路由前缀不同。\n- 概览页的统计数字是写死的占位值，不是实时数据。\n- `api.js` 里 `metaApi` 的路径带了 `meta-` 段（如 `/meta-app/list`），叠加请求实例的 `baseURL='/meta'`\n  后实际请求路径是 `/meta/meta-app/list`；而 CRUD 页直连的路径是 `/meta/app/list`。\n  两套路径口径不同，**与后端真实路由的对应关系建议实测核对一次**（`api.js` 顶注称这些路径\n  已在 2026-09-24 用 `/actuator/mappings` 核对过）。\n- `metaApi` 里没有删除 / 更新方法，写操作全在页面里直连 request —— 收口 API 层时要一并搬。\n- `api/ApiList.jsx` 仍用 antd 静态 `message`（antd 6 会告警），未迁到 `App.useApp()`。\n- 组件包必须 external 基座；`vite.config.js` 的 `external` 是**精确字符串匹配**，\n  `@yuku123/z-frontend-common/ui` 与 `/ui/echarts` 两个子路径必须逐个列出，漏一个基座就会被复制进 dist。\n\n## 七、变更记录\n\n| 版本 | 变更 |\n|---|---|\n| 0.1.1 | 新增组件文档页 `ComponentDocPage`（lead 008 §7）：`src/DOC.md` + 基座 `ComponentDoc` 薄包装 |\n| 0.1.0 | 首版：元数据中心页面集 + manifest + 自洽 request |\n";
+function Ne() {
+  return /* @__PURE__ */ n.jsx(me, { markdown: Pe, title: "组件文档 — z-meta" });
+}
+export {
+  Ne as C,
+  ze as M,
+  Ce as c,
+  n as j,
+  u as r
+};

package/dist/index.js

@@ -1,5 +1,6 @@
-import { M as o, c as p } from "./MetaApp-DCN9NQdA.js";
+import { C as o, M as p, c as t } from "./ComponentDoc-IVc3HvAO.js";
 export {
-  o as MetaApp,
-  p as configureMeta
+  o as ComponentDocPage,
+  p as MetaApp,
+  t as configureMeta
 };