@jzg223/design-runtime 0.0.1 → 0.1.0-rc.2

package/dist/board/theme-host.js

@@ -0,0 +1,129 @@
+import { getHostBoard } from "../host.js";
+import { themeOf, setThemeTokens } from "../board-engine/schema.js";
+import { parseManifest } from "../board-engine/theme-manifest.js";
+const CHART_VAR_PREFIX = "--brd-chart-";
+const SCHEME_VAR = "--brd-scheme";
+const TOOLTIP_BG_VAR = "--brd-tooltip-bg";
+const TOOLTIP_BORDER_VAR = "--brd-tooltip-border";
+const FRAME_VAR_1 = "--brd-frame-1";
+const FRAME_VAR_2 = "--brd-frame-2";
+const DECO_VAR_1 = "--brd-deco-1";
+const DECO_VAR_2 = "--brd-deco-2";
+const DEFAULT_THEME_BASE = "/board/theme/";
+function themeBaseUrl() {
+  const injected = String(getHostBoard().themeBaseUrl ?? "").trim();
+  let raw = injected;
+  if (!raw && typeof window !== "undefined") {
+    const cfg = window._CONFIG ?? {};
+    raw = String(cfg.VUE_APP_THEME_BASE_URL ?? "").trim();
+  }
+  const base = raw || DEFAULT_THEME_BASE;
+  try {
+    const docBase = typeof document !== "undefined" ? document.baseURI : void 0;
+    return new URL(base.replace(/\/+$/, "") + "/", docBase).href;
+  } catch {
+    return base.replace(/\/+$/, "") + "/";
+  }
+}
+const registered = {};
+const cssLoading = /* @__PURE__ */ new Map();
+let manifestPromise = null;
+function readThemeTokens(code) {
+  if (typeof document === "undefined" || !code) return null;
+  const probe = document.createElement("div");
+  probe.setAttribute("data-board-theme", code);
+  probe.style.cssText = "position:absolute;left:-9999px;top:-9999px;width:0;height:0;";
+  document.body.appendChild(probe);
+  const cs = getComputedStyle(probe);
+  const pick = (name) => String(cs.getPropertyValue(name) || "").trim();
+  const colors = [];
+  for (let i = 1; i <= 8; i++) {
+    const v = pick(CHART_VAR_PREFIX + i);
+    if (v) colors.push(v);
+  }
+  const scheme = pick(SCHEME_VAR);
+  const frame1 = pick(FRAME_VAR_1);
+  const frame2 = pick(FRAME_VAR_2);
+  const deco1 = pick(DECO_VAR_1);
+  const deco2 = pick(DECO_VAR_2);
+  const tokens = {
+    // 少于 3 个颜色当"没读到"（宁可回落内置主题调色板，也不要半个调色板）
+    colors: colors.length >= 3 ? colors : null,
+    dark: scheme ? scheme !== "light" : null,
+    bg: pick("--brd-bg") || null,
+    tooltipBg: pick(TOOLTIP_BG_VAR) || null,
+    tooltipBorder: pick(TOOLTIP_BORDER_VAR) || null,
+    frameColors: frame1 ? [frame1, frame2 || "transparent"] : null,
+    decoColors: deco1 ? [deco1, deco2 || deco1] : null
+  };
+  document.body.removeChild(probe);
+  return tokens;
+}
+function ensureTheme(code) {
+  const key = String(code ?? "");
+  if (registered[key]) return themeOf(key);
+  registered[key] = true;
+  const tokens = readThemeTokens(key);
+  if (tokens) setThemeTokens(key, tokens);
+  return themeOf(key);
+}
+function ensureThemeCss(code) {
+  const key = String(code ?? "").trim();
+  if (!key || typeof document === "undefined") return Promise.resolve(false);
+  const url = new URL(`${key}.css`, themeBaseUrl()).href;
+  const exist = document.querySelector(
+    `link[data-board-theme-css="${key}"], link[href$="/${key}.css"]`
+  );
+  if (exist) return Promise.resolve(true);
+  const pending = cssLoading.get(key);
+  if (pending) return pending;
+  const task = new Promise((resolve) => {
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = url;
+    link.setAttribute("data-board-theme-css", key);
+    let timer;
+    const done = (ok) => {
+      clearTimeout(timer);
+      resolve(ok);
+    };
+    timer = setTimeout(() => done(false), 3e3);
+    link.onload = () => done(true);
+    link.onerror = () => done(false);
+    document.head.appendChild(link);
+  }).then((ok) => {
+    registered[key] = false;
+    ensureTheme(key);
+    return ok;
+  });
+  cssLoading.set(key, task);
+  return task;
+}
+function loadManifest() {
+  if (manifestPromise) return manifestPromise;
+  manifestPromise = (async () => {
+    try {
+      const res = await fetch(themeBaseUrl() + "index.json", { cache: "no-store" });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return parseManifest(await res.json());
+    } catch (error) {
+      console.warn("[design-board] 读不到主题清单 index.json（只列内置主题）：", (error == null ? void 0 : error.message) ?? error);
+      return [];
+    }
+  })();
+  return manifestPromise;
+}
+function resetThemeFileCache() {
+  manifestPromise = null;
+  cssLoading.clear();
+  Object.keys(registered).forEach((k) => delete registered[k]);
+}
+export {
+  DEFAULT_THEME_BASE,
+  ensureTheme,
+  ensureThemeCss,
+  loadManifest,
+  readThemeTokens,
+  resetThemeFileCache,
+  themeBaseUrl
+};

package/dist/board-engine/asset.js

@@ -0,0 +1,32 @@
+const ASSET_PREFIX = "asset:";
+function isAssetRef(v) {
+  return typeof v === "string" && v.slice(0, ASSET_PREFIX.length) === ASSET_PREFIX;
+}
+function assetPath(v) {
+  return isAssetRef(v) ? String(v).slice(ASSET_PREFIX.length) : "";
+}
+function toAssetRef(path) {
+  const p = String(path ?? "").replace(/^\/+/, "");
+  return p ? ASSET_PREFIX + p : "";
+}
+function assetName(v) {
+  if (!isAssetRef(v)) return "";
+  const p = assetPath(v);
+  const i = p.lastIndexOf("/");
+  return i >= 0 ? p.slice(i + 1) : p;
+}
+function assetUrl(v, base) {
+  const s = typeof v === "string" ? v.trim() : "";
+  if (!s) return "";
+  if (!isAssetRef(s)) return s;
+  const prefix = String(base ?? "").replace(/\/+$/, "");
+  return `${prefix}/design/board/asset/file?path=${encodeURIComponent(assetPath(s))}`;
+}
+export {
+  ASSET_PREFIX,
+  assetName,
+  assetPath,
+  assetUrl,
+  isAssetRef,
+  toAssetRef
+};

package/dist/board-engine/chart-option.js

@@ -0,0 +1,377 @@
+import { themeOf, measureLabel } from "./schema.js";
+function fmtNum(v, numFormat) {
+  if (v === null || v === void 0 || v === "") return v;
+  const n = Number(v);
+  if (Number.isNaN(n)) return v;
+  const f = String(numFormat || "");
+  const m = /\.(\d+)/.exec(f);
+  const dec = m ? m[1].length : null;
+  if (f.indexOf("%") >= 0) return (n * 100).toFixed(dec === null ? 0 : dec) + "%";
+  const digits = dec === null ? Number.isInteger(n) ? 0 : 2 : dec;
+  const s = n.toFixed(digits);
+  return f.indexOf(",") >= 0 ? s.replace(/\B(?=(\d{3})+(?!\d))/g, ",") : s;
+}
+function withAlpha(color, a) {
+  const m = /^#([0-9a-fA-F]{6})$/.exec(String(color || ""));
+  if (!m) return color;
+  const n = parseInt(m[1], 16);
+  return `rgba(${n >> 16 & 255}, ${n >> 8 & 255}, ${n & 255}, ${a})`;
+}
+function barFill(color, horizontal) {
+  return {
+    type: "linear",
+    x: 0,
+    y: 0,
+    x2: horizontal ? 1 : 0,
+    y2: horizontal ? 0 : 1,
+    colorStops: [
+      { offset: 0, color: withAlpha(color, 0.98) },
+      { offset: 1, color: withAlpha(color, 0.45) }
+    ]
+  };
+}
+function buildChartOption(rows, columns, part, themeCode, opts) {
+  var _a;
+  const theme = themeOf(themeCode);
+  const data = part.data || {};
+  const view = part.view || {};
+  const chart = view.chart || "bar";
+  const narrow = !!(opts && opts.narrow);
+  const dims = (data.dims || []).slice();
+  const measures = (data.measures || []).slice();
+  const dim = dims[0];
+  const measure = measures[0];
+  const aliasOf = (name) => {
+    const c = (columns || []).find((x) => x.name === name);
+    return c && c.alias || name;
+  };
+  const labelOfMeasure = (m) => measureLabel(m, aliasOf(m && (m.alias || m.field)));
+  const dimName = dim ? aliasOf(dim) : "";
+  const measureName = measure ? aliasOf(measure.alias || measure.field) : "";
+  const valueOf = (row, key) => {
+    if (!key) return null;
+    if (row[key] !== void 0) return row[key];
+    const hit = Object.keys(row).find((k) => k.toLowerCase() === String(key).toLowerCase());
+    return hit ? row[hit] : null;
+  };
+  const categories = rows.map((r) => String(valueOf(r, dim) === null ? "" : valueOf(r, dim)));
+  const values = rows.map((r) => {
+    const v = valueOf(r, measure ? measure.alias || measure.field : "");
+    const n = Number(v);
+    return Number.isNaN(n) ? 0 : n;
+  });
+  (_a = (columns || []).find((c) => c.name === (measure && (measure.alias || measure.field)))) == null ? void 0 : _a.numFormat;
+  const cartesian = ["bar", "hbar", "line", "area"].indexOf(chart) >= 0;
+  const msList = cartesian ? measures.filter((m) => m && m.field) : [];
+  const MIX_TYPES = ["bar", "line", "area"];
+  const seriesTypeOf = (m, base) => m && MIX_TYPES.indexOf(m.type) >= 0 ? m.type : base;
+  const seriesOfMeasure = (type, extra, styleOf) => (msList.length ? msList : [measure || {}]).map((m, i) => {
+    var _a2;
+    const key = m.alias || m.field;
+    const fmt = (_a2 = (columns || []).find((c) => c.name === key)) == null ? void 0 : _a2.numFormat;
+    const data2 = rows.map((r) => {
+      const n = Number(valueOf(r, key));
+      return Number.isNaN(n) ? 0 : n;
+    });
+    const ex = Object.assign({}, extra);
+    const exLabel = ex.label;
+    delete ex.label;
+    const color = theme.colors[i % theme.colors.length];
+    const styled = typeof styleOf === "function" ? styleOf(color) : {};
+    return Object.assign({
+      name: msList.length ? labelOfMeasure(m) : measureName,
+      type: seriesTypeOf(m, type),
+      // 双 Y 轴：第二个度量挂到右轴（更多度量仍放左轴）
+      yAxisIndex: view.dualAxis && msList.length > 1 && i === 1 ? 1 : 0,
+      // 堆叠：同一个 stack 名才会叠起来
+      stack: view.stack ? "total" : void 0,
+      label: Object.assign({ show: !!view.showLabel, color: theme.text, formatter: (p) => fmtNum(p.value, fmt) }, exLabel || {}),
+      data: data2
+    }, ex, styled);
+  });
+  const yAxisOf = (extra) => {
+    if (view.dualAxis && msList.length > 1) {
+      return [
+        Object.assign({ type: "value" }, valueAxis, {}),
+        Object.assign({ type: "value" }, valueAxis, { splitLine: { show: false } }, {})
+      ];
+    }
+    return Object.assign({ type: "value" }, valueAxis, {});
+  };
+  ({
+    color: theme.text
+  });
+  const axisCommon = {
+    axisLine: { show: false },
+    axisTick: { show: false },
+    axisLabel: { color: theme.subText, fontSize: 12, fontFamily: "微软雅黑" },
+    splitLine: { show: false }
+  };
+  const valueAxis = {
+    ...axisCommon,
+    splitLine: { lineStyle: { color: theme.splitLine, type: "dashed" } }
+  };
+  const tooltip = {
+    trigger: ["pie", "donut", "rose", "funnel", "pyramid"].indexOf(chart) >= 0 ? "item" : "axis",
+    // 深色半透明提示框：ECharts 默认白底方框在深色大屏上非常跳（用户截图里那个就是）
+    backgroundColor: theme.tooltipBg || "rgba(9,17,31,0.94)",
+    borderColor: theme.tooltipBorder || theme.splitLine,
+    borderWidth: 1,
+    padding: [8, 12],
+    textStyle: { color: theme.text, fontSize: 12, fontFamily: "微软雅黑" },
+    extraCssText: "border-radius:10px;box-shadow:0 12px 30px rgba(2,8,20,0.45);backdrop-filter:blur(8px);",
+    axisPointer: {
+      type: "line",
+      lineStyle: { color: theme.splitLine, width: 1, type: "dashed" },
+      label: { backgroundColor: theme.colors[0], color: "#fff", borderRadius: 4, padding: [3, 6] }
+    }
+  };
+  const legend = {
+    show: view.showLegend !== false,
+    textStyle: { color: theme.subText, fontSize: 12, fontFamily: "微软雅黑" },
+    icon: "circle",
+    itemWidth: 8,
+    itemHeight: 8,
+    itemGap: 16,
+    // 窄屏图例挪到底部横排：右侧竖排图例在 366px 宽里会吃掉 1/3 宽度
+    top: narrow ? void 0 : 2,
+    bottom: narrow ? 0 : void 0,
+    type: "scroll"
+  };
+  switch (chart) {
+    case "pie":
+    case "donut":
+    case "rose": {
+      const isDonut = chart === "donut";
+      const tooManyLabels = categories.length > 8;
+      const bottomLegend = narrow || tooManyLabels;
+      return {
+        color: theme.colors,
+        tooltip,
+        legend: bottomLegend ? { ...legend, orient: "horizontal", left: "center" } : { ...legend, orient: "vertical", right: 8, top: "middle" },
+        series: [
+          {
+            type: "pie",
+            radius: isDonut ? ["42%", "68%"] : chart === "rose" ? ["18%", "70%"] : "68%",
+            center: bottomLegend ? ["50%", "42%"] : ["40%", "52%"],
+            roseType: chart === "rose" ? "radius" : void 0,
+            avoidLabelOverlap: true,
+            // 扇形之间留 2px 底色缝 + 圆角：比"紧贴 + 1px 描边"现代得多；再加同色辉光（大屏观感）
+            itemStyle: {
+              borderColor: theme.bg || "#070c18",
+              borderWidth: 2,
+              borderRadius: 6,
+              shadowBlur: 16,
+              shadowColor: withAlpha(theme.colors[0], 0.55)
+            },
+            // 类目太多 → 干脆不画；窄屏 → 放进扇形里（外侧会被容器裁掉）
+            label: tooManyLabels ? { show: false } : narrow ? { show: view.showLabel !== false, position: "inside", color: "#fff", fontSize: 12, formatter: "{b}\n{d}%" } : { show: view.showLabel !== false, color: theme.text, fontSize: 12, formatter: "{b}\n{d}%" },
+            labelLine: { lineStyle: { color: theme.splitLine } },
+            data: rows.map((r, i) => ({
+              name: categories[i],
+              value: values[i]
+            }))
+          }
+        ]
+      };
+    }
+    case "funnel":
+    case "pyramid": {
+      const isPyramid = chart === "pyramid";
+      return {
+        color: theme.colors,
+        tooltip,
+        legend,
+        series: [
+          {
+            type: "funnel",
+            left: "12%",
+            width: "76%",
+            top: 40,
+            bottom: 16,
+            sort: isPyramid ? "ascending" : "descending",
+            gap: isPyramid ? 0 : 2,
+            label: Object.assign(
+              { color: theme.text, fontSize: 12, formatter: "{b}: {c}" },
+              // 金字塔的段是上窄下宽，标签放外面会被裁 ⇒ 默认放段内居中
+              isPyramid ? { position: "inside", color: "#04121f", fontWeight: 600 } : {}
+            ),
+            itemStyle: isPyramid ? { borderColor: "rgba(7,12,24,0.6)", borderWidth: 1 } : { borderColor: theme.bg || "#070c18", borderWidth: 2, borderRadius: 4 },
+            data: rows.map((r, i) => ({ name: categories[i], value: values[i] }))
+          }
+        ]
+      };
+    }
+    case "radar": {
+      const max = Math.max(1, ...values);
+      return {
+        color: theme.colors,
+        tooltip,
+        legend,
+        radar: {
+          indicator: rows.map((r, i) => ({ name: categories[i], max: Math.ceil(max * 1.2) })),
+          axisName: { color: theme.subText },
+          splitLine: { lineStyle: { color: theme.splitLine } },
+          splitArea: { areaStyle: { color: ["transparent"] } },
+          axisLine: { lineStyle: { color: theme.splitLine } }
+        },
+        series: [
+          {
+            type: "radar",
+            areaStyle: { opacity: 0.25 },
+            data: [{ value: values, name: measureName }]
+          }
+        ]
+      };
+    }
+    case "scatter": {
+      return {
+        color: theme.colors,
+        tooltip,
+        grid: { left: 50, right: 20, top: 40, bottom: 40 },
+        xAxis: { type: "category", data: categories, ...axisCommon, name: dimName, nameTextStyle: { color: theme.subText } },
+        yAxis: { type: "value", ...valueAxis, name: measureName, nameTextStyle: { color: theme.subText } },
+        series: [{ type: "scatter", symbolSize: 11, itemStyle: { color: withAlpha(theme.colors[0], 0.85), borderColor: theme.colors[0], borderWidth: 1 }, data: values }]
+      };
+    }
+    case "gauge": {
+      const last = values.length ? values[values.length - 1] : 0;
+      const max = Math.max(1, ...values);
+      return {
+        color: theme.colors,
+        series: [
+          {
+            type: "gauge",
+            min: 0,
+            max: Math.ceil(max * 1.2),
+            progress: {
+              show: true,
+              width: 14,
+              roundCap: true,
+              itemStyle: { color: barFill(theme.colors[0], false) }
+            },
+            axisLine: { roundCap: true, lineStyle: { width: 14, color: [[1, theme.splitLine]] } },
+            axisLabel: { color: theme.subText, fontSize: 10, distance: 16 },
+            axisTick: { show: false },
+            splitLine: { length: 10, lineStyle: { color: theme.splitLine } },
+            pointer: { width: 4, length: "58%", itemStyle: { color: theme.colors[0] } },
+            anchor: { show: true, size: 10, itemStyle: { color: theme.colors[0] } },
+            detail: { valueAnimation: true, color: theme.text, fontSize: 26, fontWeight: 600, offsetCenter: [0, "68%"] },
+            title: { color: theme.subText, fontSize: 12, offsetCenter: [0, "90%"] },
+            // 中心的名称优先用配置里的显示名（measure.label，如「平均年龄」）：
+            // 度量别名（alias）是 SQL 列别名、只能是字母数字下划线，拿它当标题会显示成 avg_age / cnt。
+            data: [{ value: last, name: measure && measure.label || measureName }]
+          }
+        ]
+      };
+    }
+    case "ring": {
+      const pct = Math.max(0, Math.min(100, values.length ? Number(values[values.length - 1]) : 0));
+      return {
+        color: theme.colors,
+        series: [
+          {
+            type: "gauge",
+            startAngle: 90,
+            endAngle: -270,
+            min: 0,
+            max: 100,
+            radius: "82%",
+            pointer: { show: false },
+            progress: { show: true, overlap: false, roundCap: true, clip: false, width: 10, itemStyle: { color: barFill(theme.colors[0], false) } },
+            axisLine: { lineStyle: { width: 10, color: [[1, theme.splitLine]] } },
+            splitLine: { show: false },
+            axisTick: { show: false },
+            axisLabel: { show: false },
+            anchor: { show: false },
+            detail: {
+              valueAnimation: true,
+              offsetCenter: [0, 0],
+              color: theme.text,
+              fontSize: 26,
+              fontWeight: 600,
+              formatter: (v) => Number(v).toFixed(1) + "%"
+            },
+            title: { show: false },
+            data: [{ value: pct, name: measure && measure.label || measureName }]
+          }
+        ]
+      };
+    }
+    case "line":
+    case "area": {
+      return {
+        color: theme.colors,
+        tooltip,
+        legend,
+        grid: { left: 56, right: view.dualAxis && msList.length > 1 ? 48 : 24, top: 40, bottom: 36 },
+        xAxis: { type: "category", data: categories, boundaryGap: false, ...axisCommon },
+        yAxis: yAxisOf(),
+        series: seriesOfMeasure("line", {
+          smooth: !!view.smooth,
+          showSymbol: rows.length <= 40,
+          symbolSize: 6
+        }, (c) => ({
+          itemStyle: { color: c, shadowBlur: 14, shadowColor: withAlpha(c, 0.65) },
+          // 发光线：shadowBlur 让折线在大屏上"亮"起来（纯色细线在深色底上太安静）
+          lineStyle: { width: 2.5, color: c, shadowBlur: 12, shadowColor: withAlpha(c, 0.75) },
+          // 面积图：从主题色渐到透明（比原来整块 0.22 透明度干净很多）
+          areaStyle: chart === "area" ? {
+            color: {
+              type: "linear",
+              x: 0,
+              y: 0,
+              x2: 0,
+              y2: 1,
+              colorStops: [{ offset: 0, color: withAlpha(c, 0.42) }, { offset: 1, color: withAlpha(c, 0.02) }]
+            }
+          } : void 0
+        }))
+      };
+    }
+    case "hbar": {
+      return {
+        color: theme.colors,
+        tooltip,
+        legend,
+        grid: { left: 90, right: 30, top: 40, bottom: 30 },
+        xAxis: yAxisOf(),
+        yAxis: { type: "category", data: categories, ...axisCommon },
+        series: seriesOfMeasure("bar", {
+          barMaxWidth: 22,
+          label: { show: !!view.showLabel, position: "right", color: theme.text }
+        }, (c) => ({ itemStyle: { borderRadius: [0, 6, 6, 0], color: barFill(c, true), shadowBlur: 12, shadowColor: withAlpha(c, 0.45), shadowOffsetX: 2 } }))
+      };
+    }
+    case "bar":
+    default: {
+      return {
+        color: theme.colors,
+        tooltip,
+        legend,
+        // 类目多的时候不能让每个标签都画（原来写死 interval:0）：28 个系统名列在几百像素宽的
+        // 部件里会糊成一团黑块。>10 个类目就交给 ECharts 自动抽稀，并斜排。
+        grid: { left: 56, right: view.dualAxis && msList.length > 1 ? 48 : 24, top: 40, bottom: 36 },
+        xAxis: {
+          type: "category",
+          data: categories,
+          ...axisCommon,
+          axisLabel: {
+            color: theme.subText,
+            interval: categories.length > 10 ? "auto" : 0,
+            rotate: categories.length > 8 ? 30 : 0
+          }
+        },
+        yAxis: yAxisOf(),
+        series: seriesOfMeasure("bar", {
+          barMaxWidth: 34,
+          label: { show: !!view.showLabel, position: "top", color: theme.text }
+        }, (c) => ({ itemStyle: { borderRadius: [6, 6, 0, 0], color: barFill(c, false), shadowBlur: 12, shadowColor: withAlpha(c, 0.45), shadowOffsetY: 2 } }))
+      };
+    }
+  }
+}
+export {
+  buildChartOption,
+  fmtNum
+};

package/dist/board-engine/data-hub.js

@@ -0,0 +1,67 @@
+function buildPartQuery(part, params = {}) {
+  const d = part == null ? void 0 : part.data;
+  if (!d || !d.setId) return null;
+  const measures = (d.measures ?? []).filter((m) => m && m.field);
+  const first = measures[0];
+  return {
+    setId: d.setId,
+    dims: (d.dims ?? []).filter(Boolean),
+    measures,
+    filters: (d.filters ?? []).filter((f) => f && f.field),
+    // 部件自身参数优先，其次看板级「筛选方案」参数
+    params: { ...params, ...d.params ?? {} },
+    orderField: d.orderField || (first ? first.alias || first.field : ""),
+    orderDesc: !!d.orderDesc,
+    limit: d.limit || 1e3
+  };
+}
+function createBoardDataHub(options) {
+  const ttl = options.ttl ?? 1500;
+  const now = options.now ?? (() => Date.now());
+  const inflight = /* @__PURE__ */ new Map();
+  const cache = /* @__PURE__ */ new Map();
+  const currentParams = () => {
+    var _a;
+    return ((_a = options.params) == null ? void 0 : _a.all()) ?? {};
+  };
+  return {
+    queryOf(part) {
+      return buildPartQuery(part, currentParams());
+    },
+    async fetch(part, force) {
+      const body = buildPartQuery(part, currentParams());
+      if (!body) return null;
+      const key = JSON.stringify(body);
+      if (!force) {
+        const hit = cache.get(key);
+        if (hit && now() - hit.t < ttl) return hit.v;
+      }
+      const running = inflight.get(key);
+      if (running) return running;
+      const task = options.fetchData(body).then((res) => {
+        const v = res ?? null;
+        cache.set(key, { t: now(), v });
+        return v;
+      }).catch((error) => {
+        console.warn("[design-board] 部件取数失败：", error);
+        return null;
+      }).then((v) => {
+        inflight.delete(key);
+        return v;
+      });
+      inflight.set(key, task);
+      return task;
+    },
+    clear() {
+      cache.clear();
+      inflight.clear();
+    },
+    stats() {
+      return { cacheSize: cache.size, inflightSize: inflight.size };
+    }
+  };
+}
+export {
+  buildPartQuery,
+  createBoardDataHub
+};

package/dist/board-engine/datav-meta.js

@@ -0,0 +1,51 @@
+const DATAV_BORDER_META = {
+  1: "圆角切角",
+  2: "内衬双层直角",
+  3: "双层叠框",
+  4: "左上折角",
+  5: "上下亮线",
+  6: "细描边＋顶光",
+  7: "渐变描边",
+  8: "上下短亮线",
+  9: "四角括号",
+  10: "圆角发光",
+  11: "箭头面板（重）",
+  12: "圆角发光（细）",
+  13: "切角面板"
+};
+const DATAV_DECORATION_META = {
+  1: { label: "飞线点阵", size: [260, 60] },
+  2: { label: "中分横线", size: [280, 40] },
+  3: { label: "频谱条", size: [300, 35] },
+  4: { label: "竖向分隔线", size: [16, 140] },
+  5: { label: "阶梯折线", size: [280, 60] },
+  6: { label: "声波条", size: [300, 35] },
+  7: { label: "角标箭头（固定 21×20）", size: [60, 60] },
+  8: { label: "流线", size: [280, 70] },
+  9: { label: "科技环（正方形）", size: [150, 150] },
+  10: { label: "横轴双线", size: [280, 60] },
+  11: { label: "箭头框", size: [280, 80] },
+  12: { label: "雷达扫描（正方形）", size: [170, 170] }
+};
+const DATAV_BORDER_DEFAULT = 8;
+const DATAV_DECORATION_DEFAULT = 5;
+function datavBorderLabel(n) {
+  return DATAV_BORDER_META[Number(n)] ?? `边框 ${Number(n) || DATAV_BORDER_DEFAULT}`;
+}
+function datavDecorationLabel(n) {
+  const m = DATAV_DECORATION_META[Number(n)] ?? DATAV_DECORATION_META[DATAV_DECORATION_DEFAULT];
+  return m.label;
+}
+function datavDecorationSizeOf(n) {
+  const m = DATAV_DECORATION_META[Number(n)] ?? DATAV_DECORATION_META[DATAV_DECORATION_DEFAULT];
+  return [m.size[0], m.size[1]];
+}
+export {
+  DATAV_BORDER_DEFAULT,
+  DATAV_BORDER_META,
+  DATAV_DECORATION_DEFAULT,
+  DATAV_DECORATION_META,
+  datavBorderLabel,
+  datavDecorationLabel,
+  datavDecorationSizeOf
+};