Skip to content

Build your own AI office with Univer Office SDK. Bring editing, calculation, collaboration, and file processing into your product for people and AI agents. Built on an extensible open-source core.

docs(core): define Base table name constraints (#7494)

Univer8cf9bca49e5b
diff --git a/packages/core/src/bases/typedef.ts b/packages/core/src/bases/typedef.ts
index 96983ac20d..a5cd369d83 100644
--- a/packages/core/src/bases/typedef.ts
+++ b/packages/core/src/bases/typedef.ts
@@ -315,8 +315,18 @@ export interface IBaseSnapshot {
export interface ITableSnapshot {
id: TableId;
+ /**
+ * Human-readable display name, subject to Excel worksheet name rules because
+ * each Base table is exported as a worksheet. Names must be unique within the
+ * Base, ignoring case. Do not use this value as a structured-reference identifier.
+ */
name: string;
- /** Stable canonical name used by formulas and exported structured references. */
+ /**
+ * Persisted stable identifier used by formulas and exported structured references.
+ *
+ * Historical snapshots may omit this field. Use `getBaseFormulaTableName()` when a
+ * resolved formula identifier is required.
+ */
formulaName?: string;
fields: Record<FieldId, IFieldSnapshot>;
fieldOrder: FieldId[];