@pisell/private-materials 3.4.156 → 3.4.158

package/lib/plus/pisellSupersetDashboard/index.js

@@ -0,0 +1,189 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.js");
+const require_asyncToGenerator = require("../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js");
+const require_useEngineContext = require("../../hooks/useEngineContext.js");
+const require_serve = require("./serve.js");
+const require_locales = require("./locales.js");
+let react = require("react");
+react = require_runtime.__toESM(react);
+let antd = require("antd");
+let _pisell_utils = require("@pisell/utils");
+let lodash = require("lodash");
+let _ant_design_icons = require("@ant-design/icons");
+let _superset_ui_embedded_sdk = require("@superset-ui/embedded-sdk");
+require("./index.less");
+//#region src/plus/pisellSupersetDashboard/index.tsx
+/** 首次获取会话到 SDK 初始化完成的最长等待时间，单位为毫秒。 */
+const INITIALIZATION_TIMEOUT = 6e4;
+/**
+* Superset 报表组件，负责请求会话、挂载报表、续期、状态展示和资源清理。
+* 切店或退出登录时，宿主必须先卸载旧组件，再更新登录态并重新挂载。
+* @param props 页面报表配置、附加样式类名和根容器样式，详见组件属性类型。
+*/
+function PisellSupersetDashboard({ proCodeProps, className, style }) {
+	var _context$appHelper, _context$engine;
+	/** 当前宿主引擎上下文，提供请求服务和显示语言。 */
+	const context = require_useEngineContext.default();
+	/** 当前组件使用的宿主客户端；不写入组件包的共享 request 单例。 */
+	const client = context === null || context === void 0 || (_context$appHelper = context.appHelper) === null || _context$appHelper === void 0 || (_context$appHelper = _context$appHelper.utils) === null || _context$appHelper === void 0 ? void 0 : _context$appHelper.request;
+	_pisell_utils.locales.init(require_locales.default, (context === null || context === void 0 || (_context$engine = context.engine) === null || _context$engine === void 0 || (_context$engine = _context$engine.props) === null || _context$engine === void 0 ? void 0 : _context$engine.locale) || "en");
+	/** 当前报表的嵌入 UUID，用于向业务后端申请会话。 */
+	const dashboardId = proCodeProps === null || proCodeProps === void 0 ? void 0 : proCodeProps.dashboardId;
+	/** 原始 UI 配置对象，完整透传给 SDK，保留调用方的扩展字段。 */
+	const dashboardUiConfig = proCodeProps === null || proCodeProps === void 0 ? void 0 : proCodeProps.dashboardUiConfig;
+	/** UI 配置的深拷贝快照，用于识别嵌套字段变化及原对象上的修改。 */
+	const configSnapshot = (0, react.useRef)((0, lodash.cloneDeep)(dashboardUiConfig));
+	if (!(0, lodash.isEqual)(configSnapshot.current, dashboardUiConfig)) configSnapshot.current = (0, lodash.cloneDeep)(dashboardUiConfig);
+	/** 内容不变时保持引用稳定，作为报表初始化副作用的依赖。 */
+	const stableConfig = configSnapshot.current;
+	/** React 管理的宿主容器；每轮初始化在其中创建独立的 SDK 挂载节点。 */
+	const host = (0, react.useRef)(null);
+	/** 手动重试序号；递增后触发上一轮清理和新一轮初始化。 */
+	const [attempt, setAttempt] = (0, react.useState)(0);
+	/** 是否正在获取会话或等待 SDK 初始化，不代表图表数据的加载进度。 */
+	const [loading, setLoading] = (0, react.useState)(true);
+	/** 当前可展示错误；有明确错误消息时优先展示，否则使用国际化文案。 */
+	const [error, setError] = (0, react.useState)(null);
+	(0, react.useEffect)(() => {
+		setError(null);
+		setLoading(true);
+		if (typeof dashboardId !== "string" || !dashboardId.trim()) {
+			setError({ key: "pisell-superset.missingDashboard" });
+			setLoading(false);
+			return;
+		}
+		if (!client || typeof client.post !== "function") {
+			setError({ key: "pisell-superset.missingRequest" });
+			setLoading(false);
+			return;
+		}
+		/** 本轮初始化和续期共用的取消控制器，与其他组件实例相互独立。 */
+		const controller = new AbortController();
+		/** 本轮专属挂载节点，防止旧异步任务清空新报表的 iframe。 */
+		const mountPoint = document.createElement("div");
+		mountPoint.className = "pisell-superset-dashboard-mount";
+		host.current.appendChild(mountPoint);
+		/** 本轮会话是否失效；失效后禁止继续请求或更新组件状态。 */
+		let stopped = false;
+		/** 已完成初始化的 SDK 实例，用于卸载 iframe 并停止 SDK 续期计时。 */
+		let instance;
+		/** 首次接口返回的令牌，仅供 SDK 第一次取令牌时消费。 */
+		let firstToken;
+		/** 初始化超时计时器；初始化完成或会话结束时清除。 */
+		let timer;
+		/** 使当前会话失效，取消请求并清理令牌、SDK 实例和专属挂载节点。 */
+		const dispose = () => {
+			stopped = true;
+			clearTimeout(timer);
+			controller.abort();
+			firstToken = void 0;
+			instance === null || instance === void 0 || instance.unmount();
+			instance = void 0;
+			mountPoint.replaceChildren();
+			mountPoint.remove();
+		};
+		/** 校验会话仍然有效，阻止旧回调继续执行或返回迟到的令牌。 */
+		const assertActive = () => {
+			if (stopped) throw new Error("Superset session disposed");
+		};
+		/** 统一处理初始化和续期异常；已失效会话的异常不再影响界面。 */
+		const fail = (cause) => {
+			if (stopped) return;
+			dispose();
+			/** 从未知异常中提取消息，兼容 Error 及宿主抛出的业务响应对象。 */
+			const message = cause === null || cause === void 0 ? void 0 : cause.message;
+			setError({
+				key: cause instanceof require_serve.SupersetReportError ? cause.textKey : "pisell-superset.loadFailed",
+				message: typeof message === "string" ? message : void 0
+			});
+			setLoading(false);
+		};
+		/** 请求新的报表会话，并在请求前后校验生命周期，拒绝过期响应。 */
+		const getSession = function() {
+			var _ref = require_asyncToGenerator._asyncToGenerator(function* () {
+				assertActive();
+				/** 经业务成功状态及必填字段校验后的报表会话。 */
+				const session = yield require_serve.getSupersetSession(client, dashboardId, controller.signal);
+				assertActive();
+				return session;
+			});
+			return function getSession() {
+				return _ref.apply(this, arguments);
+			};
+		}();
+		timer = setTimeout(() => {
+			fail(new require_serve.SupersetReportError("pisell-superset.timeout"));
+		}, INITIALIZATION_TIMEOUT);
+		require_asyncToGenerator._asyncToGenerator(function* () {
+			/** 首次会话，包含实际嵌入域名、报表 ID 和当前店铺的访客令牌。 */
+			const session = yield getSession();
+			firstToken = session.guest_token;
+			/** SDK 异步创建的实例，确认会话仍有效后才保存到当前作用域。 */
+			const embedded = yield (0, _superset_ui_embedded_sdk.embedDashboard)({
+				id: session.dashboard_id,
+				supersetDomain: session.superset_domain,
+				mountPoint,
+				dashboardUiConfig,
+				referrerPolicy: "strict-origin-when-cross-origin",
+				fetchGuestToken: function() {
+					var _ref2 = require_asyncToGenerator._asyncToGenerator(function* () {
+						assertActive();
+						if (firstToken !== void 0) {
+							/** 本次要返回的首次令牌；返回前清空缓存，确保只复用一次。 */
+							const token = firstToken;
+							firstToken = void 0;
+							return token;
+						}
+						try {
+							return (yield getSession()).guest_token;
+						} catch (cause) {
+							fail(cause);
+							throw cause;
+						}
+					});
+					return function fetchGuestToken() {
+						return _ref2.apply(this, arguments);
+					};
+				}()
+			});
+			if (stopped) {
+				embedded.unmount();
+				mountPoint.replaceChildren();
+				return;
+			}
+			instance = embedded;
+			clearTimeout(timer);
+			setLoading(false);
+		})().catch(fail);
+		return dispose;
+	}, [
+		dashboardId,
+		stableConfig,
+		client,
+		attempt
+	]);
+	return /* @__PURE__ */ react.default.createElement("div", {
+		className: ["pisell-superset-dashboard", className].filter(Boolean).join(" "),
+		style,
+		"aria-busy": loading
+	}, loading && /* @__PURE__ */ react.default.createElement("div", {
+		className: "pisell-superset-dashboard-status pisell-superset-dashboard-loading",
+		role: "status"
+	}, /* @__PURE__ */ react.default.createElement("div", {
+		className: "pisell-superset-dashboard-loading-icon",
+		"aria-hidden": "true"
+	}, /* @__PURE__ */ react.default.createElement(antd.Spin, { indicator: /* @__PURE__ */ react.default.createElement(_ant_design_icons.LoadingOutlined, {
+		spin: true,
+		style: { fontSize: 36 }
+	}) })), /* @__PURE__ */ react.default.createElement("p", { className: "pisell-superset-dashboard-loading-text" }, _pisell_utils.locales.getText("pisell-superset.loading"))), error && /* @__PURE__ */ react.default.createElement("div", {
+		className: "pisell-superset-dashboard-status",
+		role: "alert"
+	}, /* @__PURE__ */ react.default.createElement("p", null, error.message || _pisell_utils.locales.getText(error.key)), /* @__PURE__ */ react.default.createElement("button", {
+		type: "button",
+		onClick: () => setAttempt((value) => value + 1)
+	}, _pisell_utils.locales.getText("pisell-superset.retry"))), /* @__PURE__ */ react.default.createElement("div", {
+		ref: host,
+		className: "pisell-superset-dashboard-host"
+	}));
+}
+//#endregion
+exports.default = PisellSupersetDashboard;

package/lib/plus/pisellSupersetDashboard/index.less

@@ -0,0 +1,83 @@
+// 报表根容器提供默认占位高度，宿主可以通过 style 覆盖尺寸。
+.pisell-superset-dashboard {
+  position: relative;
+  width: 100%;
+  height: 75vh;
+  min-height: 520px;
+
+  // React 容器、当前会话挂载节点和 SDK iframe 逐层填满可用空间。
+  &-host,
+  &-mount,
+  iframe {
+    width: 100%;
+    height: 100%;
+  }
+
+  // 去掉 iframe 默认边框与行内元素基线留白。
+  iframe {
+    display: block;
+    border: 0;
+  }
+
+  // 加载图标的浅灰圆角底框；图标自身沿用 Ant Design 主题色。
+  &-loading-icon {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 56px;
+    height: 56px;
+    border: 1px solid #eaecf0;
+    border-radius: 16px;
+    background: #f9fafb;
+  }
+
+  // 加载文案使用次级文字颜色，与组件其他状态提示保持一致。
+  &-loading-text {
+    color: #667085;
+    font-size: 18px;
+    font-weight: 500;
+    line-height: 22px;
+  }
+
+  // 加载与失败状态共用遮罩，覆盖未完成初始化或已清理的报表区域。
+  &-status {
+    position: absolute;
+    inset: 0;
+    z-index: 1;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 12px;
+    padding: 24px;
+    text-align: center;
+    background: #fff;
+    color: #475467;
+
+    p {
+      margin: 0;
+    }
+
+    // 错误状态的手动重试按钮。
+    button {
+      padding: 8px 16px;
+      border: 1px solid #d0d5dd;
+      border-radius: 6px;
+      background: #fff;
+      color: inherit;
+      cursor: pointer;
+    }
+  }
+
+  // 加载状态的图标与文案采用稍大的垂直间距。
+  &-loading {
+    gap: 16px;
+  }
+
+  // 尊重系统减少动画偏好，保留图标和文字，只关闭旋转动画。
+  @media (prefers-reduced-motion: reduce) {
+    &-loading-icon .anticon-spin {
+      animation: none;
+    }
+  }
+}

package/lib/plus/pisellSupersetDashboard/locales.js

@@ -0,0 +1,36 @@
+//#region src/plus/pisellSupersetDashboard/locales.ts
+/** 报表加载、配置缺失、接口失败和重试相关的国际化文案。 */
+var locales_default = {
+	en: {
+		"pisell-superset.loading": "Loading report…",
+		"pisell-superset.retry": "Reload report",
+		"pisell-superset.missingDashboard": "Configure a dashboard embedding ID first.",
+		"pisell-superset.missingRequest": "The host has not provided a report request client.",
+		"pisell-superset.requestFailed": "Unable to retrieve the report configuration.",
+		"pisell-superset.invalidResponse": "The report configuration is incomplete.",
+		"pisell-superset.loadFailed": "Report loading or renewal failed. Please reload.",
+		"pisell-superset.timeout": "Report initialization timed out. Please reload."
+	},
+	"zh-CN": {
+		"pisell-superset.loading": "正在加载报表…",
+		"pisell-superset.retry": "重新加载报表",
+		"pisell-superset.missingDashboard": "请先配置报表嵌入 ID。",
+		"pisell-superset.missingRequest": "宿主未提供报表请求客户端。",
+		"pisell-superset.requestFailed": "获取报表配置失败。",
+		"pisell-superset.invalidResponse": "报表配置返回不完整。",
+		"pisell-superset.loadFailed": "报表加载或续期失败，请重新加载。",
+		"pisell-superset.timeout": "报表初始化超时，请重新加载。"
+	},
+	"zh-HK": {
+		"pisell-superset.loading": "正在載入報表…",
+		"pisell-superset.retry": "重新載入報表",
+		"pisell-superset.missingDashboard": "請先設定報表嵌入 ID。",
+		"pisell-superset.missingRequest": "宿主未提供報表請求客戶端。",
+		"pisell-superset.requestFailed": "取得報表設定失敗。",
+		"pisell-superset.invalidResponse": "報表設定回傳不完整。",
+		"pisell-superset.loadFailed": "報表載入或續期失敗，請重新載入。",
+		"pisell-superset.timeout": "報表初始化逾時，請重新載入。"
+	}
+};
+//#endregion
+exports.default = locales_default;

package/lib/plus/pisellSupersetDashboard/serve.js

@@ -0,0 +1,52 @@
+const require_asyncToGenerator = require("../../_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js");
+//#region src/plus/pisellSupersetDashboard/serve.ts
+/** 带有国际化兜底文案键的报表异常，可附带后端返回的可读消息。 */
+var SupersetReportError = class extends Error {
+	/**
+	* @param textKey 错误消息缺省时使用的国际化文案键，同时保存为只读属性。
+	* @param message 优先展示的错误消息；省略时由组件根据 textKey 取文案。
+	*/
+	constructor(textKey, message) {
+		super(message);
+		this.textKey = textKey;
+		this.name = "SupersetReportError";
+	}
+};
+/**
+* 获取指定报表的店铺嵌入会话；每次调用都由后端重新申请 Guest Token。
+* @param client 从当前组件宿主上下文取得的请求客户端。
+* @param dashboardId Superset 报表嵌入 UUID。
+* @param signal 当前会话的取消信号。
+* @returns 已校验必填字段的报表会话。
+* @throws 业务失败或响应不完整时抛出报表异常；宿主请求异常保持原样抛出。
+*/
+function getSupersetSession(_x, _x2, _x3) {
+	return _getSupersetSession.apply(this, arguments);
+}
+function _getSupersetSession() {
+	_getSupersetSession = require_asyncToGenerator._asyncToGenerator(function* (client, dashboardId, signal) {
+		/** 宿主已解包的业务响应；此处类型断言仅描述结构，后续仍需运行时校验。 */
+		const response = yield client.post("/shop/report/superset/embed", { dashboard_id: dashboardId }, {
+			isShopApi: true,
+			fullResult: true,
+			signal
+		});
+		if ((response === null || response === void 0 ? void 0 : response.status) !== true || response.code !== 200) throw new SupersetReportError("pisell-superset.requestFailed", typeof (response === null || response === void 0 ? void 0 : response.message) === "string" ? response.message : void 0);
+		/** 待校验的会话主体；不能假定业务成功就一定包含完整 SDK 参数。 */
+		const session = response.data;
+		if (!session || ![
+			"guest_token",
+			"superset_domain",
+			"dashboard_id"
+		].every((key) => {
+			/** 当前必填字段的原始值，只校验、不改写后端返回内容。 */
+			const value = session[key];
+			return typeof value === "string" && value.trim().length > 0;
+		})) throw new SupersetReportError("pisell-superset.invalidResponse");
+		return session;
+	});
+	return _getSupersetSession.apply(this, arguments);
+}
+//#endregion
+exports.SupersetReportError = SupersetReportError;
+exports.getSupersetSession = getSupersetSession;

package/lib/plus/pisellSupersetDashboard/types.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+
+//#region src/plus/pisellSupersetDashboard/types.d.ts
+/** Superset 报表组件的公开属性，与宿主 proCode 页面传参结构保持一致。 */
+interface PisellSupersetDashboardProps {
+  /** 页面配置；未提供时展示配置缺失提示，不发起业务请求。 */
+  proCodeProps?: {
+    /** Superset 嵌入配置生成的 UUID，不是普通数字报表 ID 或页面 URL。 */dashboardId: string; /** 原样传给 SDK 的 UI 配置，允许扩展字段；缺省时采用 SDK 默认行为。 */
+    dashboardUiConfig?: Record<string, any>;
+  };
+  /** 附加到组件根容器的样式类名。 */
+  className?: string;
+  /** 根容器样式，可覆盖默认宽高和最小高度。 */
+  style?: React.CSSProperties;
+}
+//#endregion
+export { PisellSupersetDashboardProps };

package/lowcode/inventory-item-management/meta.ts

@@ -0,0 +1,20 @@
+export default {
+  componentName: 'InventoryItemManagement',
+  title: '货品管理',
+  category: 'SaaS',
+  devMode: 'proCode',
+  npm: {
+    package: '@pisell/private-materials',
+    version: '1.0.0',
+    exportName: 'InventoryItemManagement',
+    main: 'src/index.tsx',
+    destructuring: true,
+  },
+  configure: { props: [], supports: {}, component: {} },
+  snippets: [
+    {
+      title: '货品管理',
+      schema: { componentName: 'InventoryItemManagement', props: {} },
+    },
+  ],
+};

package/lowcode/inventory-location-management/meta.ts

@@ -0,0 +1,20 @@
+export default {
+  componentName: 'InventoryLocationManagement',
+  title: '仓储位置管理',
+  category: 'SaaS',
+  devMode: 'proCode',
+  npm: {
+    package: '@pisell/private-materials',
+    version: '1.0.0',
+    exportName: 'InventoryLocationManagement',
+    main: 'src/index.tsx',
+    destructuring: true,
+  },
+  configure: { props: [], supports: {}, component: {} },
+  snippets: [
+    {
+      title: '仓储位置管理',
+      schema: { componentName: 'InventoryLocationManagement', props: {} },
+    },
+  ],
+};

package/lowcode/inventory-unit-management/meta.ts

@@ -0,0 +1,20 @@
+export default {
+  componentName: 'InventoryUnitManagement',
+  title: '货品单位管理',
+  category: 'SaaS',
+  devMode: 'proCode',
+  npm: {
+    package: '@pisell/private-materials',
+    version: '1.0.0',
+    exportName: 'InventoryUnitManagement',
+    main: 'src/index.tsx',
+    destructuring: true,
+  },
+  configure: { props: [], supports: {}, component: {} },
+  snippets: [
+    {
+      title: '货品单位管理',
+      schema: { componentName: 'InventoryUnitManagement', props: {} },
+    },
+  ],
+};

package/lowcode/pisell-superset-dashboard/meta.ts

@@ -0,0 +1,75 @@
+import type {
+  IPublicTypeComponentMetadata,
+  IPublicTypeSnippet,
+} from '@alilc/lowcode-types';
+
+/** 低代码物料元数据，描述组件标识、导出位置和编辑器属性面板。 */
+const meta: IPublicTypeComponentMetadata = {
+  componentName: 'PisellSupersetDashboard',
+  title: 'Superset 报表',
+  category: 'SaaS',
+  devMode: 'proCode',
+  npm: {
+    package: '@pisell/private-materials',
+    version: '1.0.0',
+    exportName: 'PisellSupersetDashboard',
+    main: 'src/index.ts',
+    destructuring: true,
+    subName: '',
+  },
+  // 页面配置统一放在 proCodeProps 内，保持编辑器与实际组件 Props 结构一致。
+  configure: {
+    props: [
+      {
+        name: 'proCodeProps',
+        title: '报表配置',
+        setter: {
+          componentName: 'ObjectSetter',
+          props: {
+            config: {
+              items: [
+                {
+                  name: 'dashboardId',
+                  title: '嵌入 UUID',
+                  setter: 'StringSetter',
+                },
+                {
+                  name: 'dashboardUiConfig',
+                  title: 'Dashboard UI 配置',
+                  // JSON 编辑器允许填写任意 SDK UI 扩展字段。
+                  setter: 'JsonSetter',
+                },
+              ],
+            },
+          },
+        },
+      },
+    ],
+    supports: { style: true, className: true },
+    component: {},
+  },
+};
+
+/** 拖入编辑器时生成的默认片段；报表 ID 留空，需接入方填写实际嵌入 UUID。 */
+const snippets: IPublicTypeSnippet[] = [
+  {
+    title: 'Superset 报表',
+    screenshot: '',
+    schema: {
+      componentName: 'PisellSupersetDashboard',
+      props: {
+        proCodeProps: {
+          dashboardId: '',
+          dashboardUiConfig: {
+            filters: { visible: true, expanded: false },
+            hideTitle: true,
+            hideChartControls: true,
+          },
+        },
+      },
+    },
+  },
+];
+
+/** 合并物料描述与默认片段，供低代码构建插件收集。 */
+export default { ...meta, snippets };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pisell/private-materials",
-  "version": "3.4.156",
+  "version": "3.4.158",
   "main": "./lib/index.js",
   "module": "./es/index.js",
   "types": "./lib/index.d.ts",
@@ -10,6 +10,7 @@
     "*.scss"
   ],
   "devDependencies": {
+    "@types/lodash": "4.17.23",
     "@alib/build-scripts": "^0.1.32",
     "@alilc/build-plugin-alt": "^1.3.3",
     "@alilc/lowcode-react-renderer": "^1.1.7",
@@ -61,6 +62,7 @@
     "dist"
   ],
   "dependencies": {
+    "@superset-ui/embedded-sdk": "0.4.0",
     "@adyen/adyen-platform-experience-web": "1.12.2",
     "antd": "5.10.1",
     "@ant-design/icons": "^5.6.1",
@@ -81,8 +83,8 @@
     "styled-components": "^6.0.0-rc.3",
     "@pisell/utils": "3.0.2",
     "@pisell/materials": "3.3.113",
-    "@pisell/date-picker": "3.0.4",
-    "@pisell/icon": "0.0.11"
+    "@pisell/icon": "0.0.11",
+    "@pisell/date-picker": "3.0.4"
   },
   "peerDependencies": {
     "react": "^18.0.0",