@object-ui/core 13.1.0 → 14.0.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @object-ui/core
 
+## 14.0.0
+
+### Patch Changes
+
+- 443360a: Action params support a `visible` CEL predicate — the param dialog omits a param
+  when it evaluates false, against the same scope as action `visible` (features /
+  user / app / data). Fixes the create-user form offering a **Phone Number** field
+  the default backend rejects ("Phone numbers require the phoneNumber auth plugin"):
+  paired with the framework gating that param on `features.phoneNumber`, the form
+  now follows the plugin — no phone field unless the opt-in phoneNumber auth plugin
+  is loaded. `filterVisibleParams` is exported + unit-tested (feature-off hides,
+  feature-on shows, malformed predicate fails open).
+- 05e56ca: 导出/导入模板的下载文件名与内容本地化。
+
+  **导出文件名**:CSV/Excel/JSON 导出下载不再是 `<对象名>.<扩展名>`(如 `contracts.csv`),改为「对象显示名-视图名-时间戳.扩展名」(如 `任务-In Progress-20260714-153045.xlsx`);`exportOptions.fileNamePrefix` 配置仍优先(且作为完整前缀,不再追加视图名)。视图名与对象名重复时自动省略;`@object-ui/core` 新增 `buildExportFileName(ext, { prefix, label, objectName, viewLabel }, now?)` 与 `sanitizeFileNameBase(raw)`,ObjectGrid 与 ListView 的所有导出路径(服务端流式与前端兜底)统一走它。app-shell/plugin-view 的 ObjectView 现将当前视图的显示标签写进传给 ListView 的 schema(`label`),使导出文件名能区分同一对象的不同保存视图。
+
+  **导入模板**:「下载模板」修复两处英文漏出——示例行的 select/多选取值改为优先取选项**显示标签**(如 `准备中`)而非 ASCII slug(`prepare`,服务端导入两者都接受);模板文件名本地化为 `{{object}}-导入模板.csv`(新增 i18n key `grid.import.templateFileName`,英文回退 `{{object}}-import-template.csv`)。
+
+- Updated dependencies [86c69c3]
+- Updated dependencies [6a74160]
+  - @object-ui/types@14.0.0
+
+## 13.2.0
+
+### Patch Changes
+
+- @object-ui/types@13.2.0
+
 ## 13.1.0
 
 ### Patch Changes

package/dist/actions/ActionRunner.d.ts

@@ -250,6 +250,14 @@ export interface ActionParamDef {
     helpText?: string;
     placeholder?: string;
     validation?: string;
+    /**
+     * Visibility predicate (CEL) evaluated against the same scope as action
+     * `visible` (`current_user` / `app` / `data` / `features`). When it evaluates
+     * false the param dialog omits this param — used to hide a param the backend
+     * only accepts under an opt-in capability (e.g. `create_user.phoneNumber`
+     * gated on `features.phoneNumber`). Absent = always visible.
+     */
+    visible?: string;
     /** Object name the lookup picker queries (`reference_to` on the field). */
     referenceTo?: string;
     /** Field on the referenced record used as the human label (default `name`). */

package/dist/index.d.ts

@@ -43,3 +43,4 @@ export * from './utils/compare-to.js';
 export * from './utils/chart-series.js';
 export * from './utils/dataset-format.js';
 export * from './utils/record-title.js';
+export * from './utils/export-filename.js';

package/dist/index.js

@@ -42,3 +42,4 @@ export * from './utils/compare-to.js';
 export * from './utils/chart-series.js';
 export * from './utils/dataset-format.js';
 export * from './utils/record-title.js';
+export * from './utils/export-filename.js';

package/dist/utils/export-filename.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Download filename builder for data exports (csv / xlsx / json).
+ *
+ * Exports used to download as `<objectApiName>.<ext>` (e.g. `contracts.csv`),
+ * which reads poorly for end users and silently collides in the Downloads
+ * folder. This builds `<base>-<YYYYMMDD>-<HHMMSS>.<ext>` where the base falls
+ * back through: explicit configured prefix (`exportOptions.fileNamePrefix`) →
+ * translated object label (e.g. 合同) → object API name → 'export'.
+ */
+/**
+ * Sanitize a candidate base name for cross-platform filesystem safety while
+ * keeping non-ASCII letters (e.g. Chinese object labels) intact. Returns an
+ * empty string when nothing usable survives, so callers can fall through.
+ */
+export declare function sanitizeFileNameBase(raw: string | undefined | null): string;
+export interface ExportFileNameParts {
+    /** Explicit prefix from view config (`exportOptions.fileNamePrefix`) — wins when set. */
+    prefix?: string;
+    /** Human-readable (translated) object label — the preferred base. */
+    label?: string;
+    /** Object API name — fallback when no label is available. */
+    objectName?: string;
+    /**
+     * Active list-view label (e.g. `In Progress`), appended after the object
+     * base so exports from different saved views don't read identically.
+     * Skipped when it duplicates the base, and not appended to an explicit
+     * `prefix` (configured prefixes are authoritative as-is).
+     */
+    viewLabel?: string;
+}
+/**
+ * Build `<base>-<YYYYMMDD>-<HHMMSS>.<ext>` in the user's local time, e.g.
+ * `合同-进行中-20260714-153045.xlsx`. The timestamp keeps repeated exports of
+ * the same object distinct and sortable.
+ */
+export declare function buildExportFileName(ext: string, parts?: ExportFileNameParts, now?: Date): string;

package/dist/utils/export-filename.js

@@ -0,0 +1,50 @@
+/**
+ * Download filename builder for data exports (csv / xlsx / json).
+ *
+ * Exports used to download as `<objectApiName>.<ext>` (e.g. `contracts.csv`),
+ * which reads poorly for end users and silently collides in the Downloads
+ * folder. This builds `<base>-<YYYYMMDD>-<HHMMSS>.<ext>` where the base falls
+ * back through: explicit configured prefix (`exportOptions.fileNamePrefix`) →
+ * translated object label (e.g. 合同) → object API name → 'export'.
+ */
+/** Windows-reserved + control characters that cannot appear in a filename. */
+const ILLEGAL_FILENAME_CHARS = /[\\\/:*?"<>|\u0000-\u001f]+/g;
+/** Longest base we emit — keeps the full name comfortably under OS limits. */
+const MAX_BASE_LENGTH = 80;
+/**
+ * Sanitize a candidate base name for cross-platform filesystem safety while
+ * keeping non-ASCII letters (e.g. Chinese object labels) intact. Returns an
+ * empty string when nothing usable survives, so callers can fall through.
+ */
+export function sanitizeFileNameBase(raw) {
+    if (!raw)
+        return '';
+    return String(raw)
+        .replace(ILLEGAL_FILENAME_CHARS, '_')
+        .replace(/\s+/g, ' ')
+        .replace(/_{2,}/g, '_')
+        // Leading/trailing dots, underscores and spaces are dropped: Windows
+        // strips trailing dots/spaces, and a leading dot hides the file on unix.
+        .replace(/^[\s._-]+|[\s._-]+$/g, '')
+        .slice(0, MAX_BASE_LENGTH);
+}
+/**
+ * Build `<base>-<YYYYMMDD>-<HHMMSS>.<ext>` in the user's local time, e.g.
+ * `合同-进行中-20260714-153045.xlsx`. The timestamp keeps repeated exports of
+ * the same object distinct and sortable.
+ */
+export function buildExportFileName(ext, parts = {}, now = new Date()) {
+    const prefix = sanitizeFileNameBase(parts.prefix);
+    let base = prefix ||
+        sanitizeFileNameBase(parts.label) ||
+        sanitizeFileNameBase(parts.objectName) ||
+        'export';
+    const view = sanitizeFileNameBase(parts.viewLabel);
+    if (!prefix && view && view.toLowerCase() !== base.toLowerCase()) {
+        base = `${base}-${view}`.slice(0, MAX_BASE_LENGTH);
+    }
+    const pad = (n) => String(n).padStart(2, '0');
+    const stamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
+        `-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    return `${base}-${stamp}.${ext}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/core",
-  "version": "13.1.0",
+  "version": "14.0.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -25,11 +25,11 @@
     }
   },
   "dependencies": {
-    "@objectstack/formula": "^12.3.0",
-    "@objectstack/spec": "^13.0.0",
+    "@objectstack/formula": "^14.6.0",
+    "@objectstack/spec": "^14.6.0",
     "lodash": "^4.18.1",
     "zod": "^4.4.3",
-    "@object-ui/types": "13.1.0"
+    "@object-ui/types": "14.0.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3",