@nokecy/qc-ui-components 2.0.0-beta.1 → 2.0.0-beta.3

package/dist/cjs/ag-grid-plus/ag-gridPlus.js

@@ -9,6 +9,7 @@ var _agGridReact = require("ag-grid-react");
 var _antd = require("antd");
 var _react = _interopRequireWildcard(require("react"));
 var _agGridEnterprise = require("ag-grid-enterprise");
+var _agGridLicenseNotice = require("./utils/agGridLicenseNotice");
 var _theme = require("./theme");
 var _density = require("./density");
 var _rowColors = require("./rowColors");
@@ -78,7 +79,8 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-// AG-Grid v33+ 需要显式注册模块
+// AG-Grid v33+ 需要显式注册模块；组件库不内置 license key，未授权时的试用提示统一收敛
+(0, _agGridLicenseNotice.installAgGridLicenseNotice)();
 _agGridCommunity.ModuleRegistry.registerModules([_agGridEnterprise.AllEnterpriseModule]);
 
 // 导入 AG-Grid v33 主题

package/dist/cjs/ag-grid-plus/index.d.ts

@@ -16,3 +16,4 @@ export type { LocalStorageAdapterConfig } from "./shared/storage/localStorageAda
 export type { GlobalConfigPermissions } from "./shared/permissions/globalConfigPermissions";
 export type { EntityExtensionField, EntityExtensionConfig, HostEntityExtensions } from "./types";
 export { fieldToColumnDef, getEntityExtensionColumns } from "./utils/entityExtensionColumns";
+export { setAgGridLicenseKey } from "./utils/agGridLicenseNotice";

package/dist/cjs/ag-grid-plus/index.js

@@ -81,6 +81,12 @@ Object.defineProperty(exports, "getEntityExtensionColumns", {
     return _entityExtensionColumns.getEntityExtensionColumns;
   }
 });
+Object.defineProperty(exports, "setAgGridLicenseKey", {
+  enumerable: true,
+  get: function get() {
+    return _agGridLicenseNotice.setAgGridLicenseKey;
+  }
+});
 Object.defineProperty(exports, "toTree", {
   enumerable: true,
   get: function get() {
@@ -114,4 +120,5 @@ var _useSchemeManager = require("./context/useSchemeManager");
 var _localStorageAdapter = require("./shared/storage/localStorageAdapter");
 var _backendApiAdapter = require("./shared/storage/backendApiAdapter");
 var _entityExtensionColumns = require("./utils/entityExtensionColumns");
+var _agGridLicenseNotice = require("./utils/agGridLicenseNotice");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

package/dist/cjs/ag-grid-plus/index.less

@@ -85,6 +85,14 @@
   text-align: right !important;
 }
 
+// AG Grid Enterprise 试用水印：组件库不内置 license key（授权由宿主通过 setAgGridLicenseKey 注入），
+// 未注入时 AG Grid 会在每个表格实例里叠一层 .ag-watermark。AgGridPlus 有 .qc-table-container 外壳，
+// 但 ArrayTable / 只读预览直接渲染 AgGridReact、不带该外壳，按容器限定会漏掉它们。
+// 组件库在模块顶层注册 AllEnterpriseModule，企业模块是全局生效的，因此这里统一关闭所有实例的水印。
+.ag-watermark {
+  display: none !important;
+}
+
 // 空态浮层里的「重试」「新建」「清空筛选」要能点：AG-Grid 给 .ag-overlay 设了 pointer-events: none，
 // 只给加载浮层放开，空态浮层里的按钮因此点不到。只放开可交互元素，空白处仍穿透到表格。@author nokecy
 .ag-overlay-no-rows-wrapper :is(button, a, input, [role='button']) {

package/dist/cjs/ag-grid-plus/utils/agGridLicenseNotice.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 安装一次 console.error 过滤：只吞 AG Grid 的 license 星号框，其余错误保持原参数、
+ * 原调用对象输出，不改变业务日志。多个组件库副本/重复 import 只包一层。
+ */
+export declare function installAgGridLicenseNotice(): void;
+/** 注入正式 AG Grid Enterprise license key；注入后不再静默任何控制台输出。 */
+export declare function setAgGridLicenseKey(licenseKey: string): void;

package/dist/cjs/ag-grid-plus/utils/agGridLicenseNotice.js

@@ -0,0 +1,105 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.installAgGridLicenseNotice = installAgGridLicenseNotice;
+exports.setAgGridLicenseKey = setAgGridLicenseKey;
+var _agGridEnterprise = require("ag-grid-enterprise");
+/**
+ * AG Grid Enterprise 试用提示收敛（组件库内统一处理，宿主不必再各自 patch node_modules）。
+ *
+ * ag-gridPlus.tsx 在模块顶层注册 AllEnterpriseModule，但组件库不内置 license key——
+ * 授权由宿主决定。未注入 key 时，AG Grid 会在每个表格实例创建时打印一整块星号框
+ * （"AG Grid Enterprise License / License Key Not Found"），并在表格右下角渲染
+ * .ag-watermark（5 秒后淡出）。
+ *
+ * 这里只在没有正式 key 时静默这块提示，水印由同目录 index.less 关闭。宿主拿到正式
+ * 授权后调用 setAgGridLicenseKey()，静默立即停用，AG Grid 恢复常规行为。
+ */
+
+var STATE_KEY = '__qcUiAgGridLicenseNotice__';
+/** license 星号框同一批输出允许的最长间隔（毫秒）：块内分隔行可能异步到达。 */
+var BANNER_WINDOW_MS = 1000;
+
+/** 星号框正文行：`**** AG Grid Enterprise License ****` / `* ... trial. *`。 */
+function isLicenseLine(text) {
+  return /^\*+.*\*+$/.test(text) && /license|trial|watermark|ag-grid/i.test(text);
+}
+
+/** 星号框分隔行（整行都是星号）。 */
+function isBannerLine(text) {
+  return /^\*+$/.test(text);
+}
+
+/**
+ * 安装一次 console.error 过滤：只吞 AG Grid 的 license 星号框，其余错误保持原参数、
+ * 原调用对象输出，不改变业务日志。多个组件库副本/重复 import 只包一层。
+ */
+function installAgGridLicenseNotice() {
+  if (typeof console === 'undefined') return;
+  var host = globalThis;
+  if (host[STATE_KEY]) return;
+  var originalError = console.error;
+  var state = {
+    originalError: originalError,
+    licensed: false
+  };
+  host[STATE_KEY] = state;
+
+  // 星号框第一行是纯星号、出现在关键词行之前：先暂存，确认是 license 块后丢弃；
+  // 若是别的来源打印的星号行，则在当前同步任务结束前原样补输出。
+  var pending = [];
+  var flushScheduled = false;
+  var lastLicenseAt = 0;
+  var flush = function flush() {
+    var lines = pending;
+    pending = [];
+    for (var _i = 0, _lines = lines; _i < _lines.length; _i++) {
+      var args = _lines[_i];
+      originalError.apply(console, args);
+    }
+  };
+  var scheduleFlush = function scheduleFlush() {
+    if (flushScheduled) return;
+    flushScheduled = true;
+    queueMicrotask(function () {
+      flushScheduled = false;
+      flush();
+    });
+  };
+  console.error = function () {
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    if (state.licensed) {
+      flush();
+      originalError.apply(console, args);
+      return;
+    }
+    var text = args.length === 1 && typeof args[0] === 'string' ? args[0].trim() : '';
+    if (isLicenseLine(text)) {
+      lastLicenseAt = Date.now();
+      pending = [];
+      return;
+    }
+    if (isBannerLine(text)) {
+      if (Date.now() - lastLicenseAt < BANNER_WINDOW_MS) return;
+      pending.push(args);
+      scheduleFlush();
+      return;
+    }
+    flush();
+    originalError.apply(console, args);
+  };
+}
+
+/** 注入正式 AG Grid Enterprise license key；注入后不再静默任何控制台输出。 */
+function setAgGridLicenseKey(licenseKey) {
+  var key = licenseKey === null || licenseKey === void 0 ? void 0 : licenseKey.trim();
+  if (!key) return;
+  _agGridEnterprise.LicenseManager.setLicenseKey(key);
+  var host = globalThis;
+  var state = host[STATE_KEY];
+  if (state) state.licensed = true;
+}

package/dist/cjs/index.d.ts

@@ -40,6 +40,7 @@ export type { SemanticPreset } from "./ag-grid-plus/utils/valueEnumColor";
 export { StatusPill, STATUS_PILL } from "./ag-grid-plus/utils/statusPill";
 export type { StatusKey } from "./ag-grid-plus/utils/statusPill";
 export { getQcColDefProp } from "./ag-grid-plus/utils/agGridCompat";
+export { setAgGridLicenseKey } from "./ag-grid-plus/index";
 export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./shared/contrast";
 export { BusinessDecimal, decimal, decimalText, nonNegativeDecimal, roundDecimal, sumDecimals, formatDecimal } from "./shared/businessDecimal";
 export type { DecimalValue } from "./shared/businessDecimal";

package/dist/cjs/index.js

@@ -14,6 +14,7 @@ var _exportNames = {
   useGridSchemes: true,
   LocalStorageSchemeAdapter: true,
   BackendApiSchemeAdapter: true,
+  setAgGridLicenseKey: true,
   ArrayTable: true,
   ArrayTableIndex: true,
   ColumnPresets: true,
@@ -429,6 +430,12 @@ Object.defineProperty(exports, "semanticTextColors", {
     return _valueEnumColor.semanticTextColors;
   }
 });
+Object.defineProperty(exports, "setAgGridLicenseKey", {
+  enumerable: true,
+  get: function get() {
+    return _index.setAgGridLicenseKey;
+  }
+});
 Object.defineProperty(exports, "sumDecimals", {
   enumerable: true,
   get: function get() {

package/dist/esm/ag-grid-plus/ag-gridPlus.js

@@ -23,8 +23,10 @@ import { AgGridReact } from 'ag-grid-react';
 import { Spin, Pagination, Card, Tag, Popover, Badge, Button, theme } from 'antd';
 import React, { useCallback, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
 import { AllEnterpriseModule } from "ag-grid-enterprise";
+import { installAgGridLicenseNotice } from "./utils/agGridLicenseNotice";
 
-// AG-Grid v33+ 需要显式注册模块
+// AG-Grid v33+ 需要显式注册模块；组件库不内置 license key，未授权时的试用提示统一收敛
+installAgGridLicenseNotice();
 ModuleRegistry.registerModules([AllEnterpriseModule]);
 
 // 导入 AG-Grid v33 主题

package/dist/esm/ag-grid-plus/index.d.ts

@@ -16,3 +16,4 @@ export type { LocalStorageAdapterConfig } from "./shared/storage/localStorageAda
 export type { GlobalConfigPermissions } from "./shared/permissions/globalConfigPermissions";
 export type { EntityExtensionField, EntityExtensionConfig, HostEntityExtensions } from "./types";
 export { fieldToColumnDef, getEntityExtensionColumns } from "./utils/entityExtensionColumns";
+export { setAgGridLicenseKey } from "./utils/agGridLicenseNotice";

package/dist/esm/ag-grid-plus/index.js

@@ -20,5 +20,8 @@ export { BackendApiSchemeAdapter } from "./shared/storage/backendApiAdapter";
 // 实体扩展列工具函数 @author nokecy
 export { fieldToColumnDef, getEntityExtensionColumns } from "./utils/entityExtensionColumns";
 
+// 正式 AG Grid Enterprise 授权入口：宿主注入 key 后组件库不再静默试用提示。
+export { setAgGridLicenseKey } from "./utils/agGridLicenseNotice";
+
 // 注意: 旧的查询方案管理功能已废弃
 // 相关导出已移除，请使用集中式方案管理 API (useSchemeManager/useGridSchemes)

package/dist/esm/ag-grid-plus/index.less

@@ -85,6 +85,14 @@
   text-align: right !important;
 }
 
+// AG Grid Enterprise 试用水印：组件库不内置 license key（授权由宿主通过 setAgGridLicenseKey 注入），
+// 未注入时 AG Grid 会在每个表格实例里叠一层 .ag-watermark。AgGridPlus 有 .qc-table-container 外壳，
+// 但 ArrayTable / 只读预览直接渲染 AgGridReact、不带该外壳，按容器限定会漏掉它们。
+// 组件库在模块顶层注册 AllEnterpriseModule，企业模块是全局生效的，因此这里统一关闭所有实例的水印。
+.ag-watermark {
+  display: none !important;
+}
+
 // 空态浮层里的「重试」「新建」「清空筛选」要能点：AG-Grid 给 .ag-overlay 设了 pointer-events: none，
 // 只给加载浮层放开，空态浮层里的按钮因此点不到。只放开可交互元素，空白处仍穿透到表格。@author nokecy
 .ag-overlay-no-rows-wrapper :is(button, a, input, [role='button']) {

package/dist/esm/ag-grid-plus/utils/agGridLicenseNotice.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 安装一次 console.error 过滤：只吞 AG Grid 的 license 星号框，其余错误保持原参数、
+ * 原调用对象输出，不改变业务日志。多个组件库副本/重复 import 只包一层。
+ */
+export declare function installAgGridLicenseNotice(): void;
+/** 注入正式 AG Grid Enterprise license key；注入后不再静默任何控制台输出。 */
+export declare function setAgGridLicenseKey(licenseKey: string): void;

package/dist/esm/ag-grid-plus/utils/agGridLicenseNotice.js

@@ -0,0 +1,97 @@
+/**
+ * AG Grid Enterprise 试用提示收敛（组件库内统一处理，宿主不必再各自 patch node_modules）。
+ *
+ * ag-gridPlus.tsx 在模块顶层注册 AllEnterpriseModule，但组件库不内置 license key——
+ * 授权由宿主决定。未注入 key 时，AG Grid 会在每个表格实例创建时打印一整块星号框
+ * （"AG Grid Enterprise License / License Key Not Found"），并在表格右下角渲染
+ * .ag-watermark（5 秒后淡出）。
+ *
+ * 这里只在没有正式 key 时静默这块提示，水印由同目录 index.less 关闭。宿主拿到正式
+ * 授权后调用 setAgGridLicenseKey()，静默立即停用，AG Grid 恢复常规行为。
+ */
+import { LicenseManager } from 'ag-grid-enterprise';
+var STATE_KEY = '__qcUiAgGridLicenseNotice__';
+/** license 星号框同一批输出允许的最长间隔（毫秒）：块内分隔行可能异步到达。 */
+var BANNER_WINDOW_MS = 1000;
+
+/** 星号框正文行：`**** AG Grid Enterprise License ****` / `* ... trial. *`。 */
+function isLicenseLine(text) {
+  return /^\*+.*\*+$/.test(text) && /license|trial|watermark|ag-grid/i.test(text);
+}
+
+/** 星号框分隔行（整行都是星号）。 */
+function isBannerLine(text) {
+  return /^\*+$/.test(text);
+}
+
+/**
+ * 安装一次 console.error 过滤：只吞 AG Grid 的 license 星号框，其余错误保持原参数、
+ * 原调用对象输出，不改变业务日志。多个组件库副本/重复 import 只包一层。
+ */
+export function installAgGridLicenseNotice() {
+  if (typeof console === 'undefined') return;
+  var host = globalThis;
+  if (host[STATE_KEY]) return;
+  var originalError = console.error;
+  var state = {
+    originalError: originalError,
+    licensed: false
+  };
+  host[STATE_KEY] = state;
+
+  // 星号框第一行是纯星号、出现在关键词行之前：先暂存，确认是 license 块后丢弃；
+  // 若是别的来源打印的星号行，则在当前同步任务结束前原样补输出。
+  var pending = [];
+  var flushScheduled = false;
+  var lastLicenseAt = 0;
+  var flush = function flush() {
+    var lines = pending;
+    pending = [];
+    for (var _i = 0, _lines = lines; _i < _lines.length; _i++) {
+      var args = _lines[_i];
+      originalError.apply(console, args);
+    }
+  };
+  var scheduleFlush = function scheduleFlush() {
+    if (flushScheduled) return;
+    flushScheduled = true;
+    queueMicrotask(function () {
+      flushScheduled = false;
+      flush();
+    });
+  };
+  console.error = function () {
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    if (state.licensed) {
+      flush();
+      originalError.apply(console, args);
+      return;
+    }
+    var text = args.length === 1 && typeof args[0] === 'string' ? args[0].trim() : '';
+    if (isLicenseLine(text)) {
+      lastLicenseAt = Date.now();
+      pending = [];
+      return;
+    }
+    if (isBannerLine(text)) {
+      if (Date.now() - lastLicenseAt < BANNER_WINDOW_MS) return;
+      pending.push(args);
+      scheduleFlush();
+      return;
+    }
+    flush();
+    originalError.apply(console, args);
+  };
+}
+
+/** 注入正式 AG Grid Enterprise license key；注入后不再静默任何控制台输出。 */
+export function setAgGridLicenseKey(licenseKey) {
+  var key = licenseKey === null || licenseKey === void 0 ? void 0 : licenseKey.trim();
+  if (!key) return;
+  LicenseManager.setLicenseKey(key);
+  var host = globalThis;
+  var state = host[STATE_KEY];
+  if (state) state.licensed = true;
+}

package/dist/esm/index.d.ts

@@ -40,6 +40,7 @@ export type { SemanticPreset } from "./ag-grid-plus/utils/valueEnumColor";
 export { StatusPill, STATUS_PILL } from "./ag-grid-plus/utils/statusPill";
 export type { StatusKey } from "./ag-grid-plus/utils/statusPill";
 export { getQcColDefProp } from "./ag-grid-plus/utils/agGridCompat";
+export { setAgGridLicenseKey } from "./ag-grid-plus/index";
 export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./shared/contrast";
 export { BusinessDecimal, decimal, decimalText, nonNegativeDecimal, roundDecimal, sumDecimals, formatDecimal } from "./shared/businessDecimal";
 export type { DecimalValue } from "./shared/businessDecimal";

package/dist/esm/index.js

@@ -36,6 +36,7 @@ export * from "./documentPage/index";
 export { semanticTextColors, toGridTextColor, gridValueEnum } from "./ag-grid-plus/utils/valueEnumColor";
 export { StatusPill, STATUS_PILL } from "./ag-grid-plus/utils/statusPill";
 export { getQcColDefProp } from "./ag-grid-plus/utils/agGridCompat";
+export { setAgGridLicenseKey } from "./ag-grid-plus/index";
 export { contrastRatio, relativeLuminance, darkenUntilContrast, lightenUntilContrast, toRgb, toHsl, fromHsl } from "./shared/contrast";
 export { BusinessDecimal, decimal, decimalText, nonNegativeDecimal, roundDecimal, sumDecimals, formatDecimal } from "./shared/businessDecimal";
 export * from "./formily/index";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nokecy/qc-ui-components",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.3",
   "description": "QC_UI backend-neutral React components",
   "license": "MIT",
   "private": false,