fix(plugin-detail): a returnType currency formula reads as money in related lists and the quick-look panel - #27800

domain:ui#2 · os-bill · session_01Utp6CY2n1JmZZKrHgtp9jC

Requested by Bill · project thread
Refs #27430 (row 1's remainder only; rows 2 to 4 stay open)
Refs #27494

Clause-②: no
Metadata-protocol: none

维护者速读

• 改了什么：声明了 returnType: 'currency' 的公式字段（如「剩余预算」），在相关列表的单元格和快速查看面板里现在显示为货币 $90,000.00，与它所依据的货币字段一致；声明为 number 或未声明的公式仍显示普通数字。
• 为什么改：这两处各自从一份手挑的键列表重建字段，漏了 returnType，公式单元格已有的货币分支看不到它。列表网格和记录页已在 fix(plugin-grid, plugin-detail): a returnType currency formula reads as money in list cells and on the record page #27689 修好，这是 console analytics: a formula declared returnType currency renders as a bare number, a KPI tile cannot show its description, percent fields always draw a progress bar, and report charts cannot split a series by a second dimension #27430 第 1 行剩下的两处。
• 风险与回滚：只多转发一个已在 spec 中声明的键，不改 spec、不加新的金额格式化器；只影响声明了 returnType 的公式字段的显示。回滚即 revert 本 PR。
• 先看：ui/packages/plugin-detail/src/RelatedList.tsx 中 makeCell 字段包里 currencyConfig 旁新增的一行；RecordDetailPanel.tsx 中 buildRecordDetailFields 新增的一行。
• 两分钟验证：pnpm --dir ui exec vitest run packages/plugin-detail/src/__tests__/formulaReturnTypeRelay-27430.test.tsx，预期 4 个用例全部通过。
• 需要你做的：无，席位落地。

What changes

Triage ruling (6495354739 on #27494): the formula cell reads returnType and uses the currency field's existing currency face. PR #27689 did that for the list grid's configured columns and the record page's ENRICHED_FIELD_METADATA_KEYS. Two more places in @object-ui/plugin-detail rebuild a field from a hand-picked key list and dropped returnType, so FormulaCellRenderer / FormulaField's existing currency branch never saw it:

1. RelatedList.tsx, the makeCell field bag: returnType is forwarded beside currencyConfig, only when the def declares it (the bag's own ...(x && { k }) idiom).
2. RecordDetailPanel.tsx, buildRecordDetailFields (the quick-look overlay, a published export): returnType is copied beside currencyConfig.

No second money formatter, no spec change, no new key. buildRecordDetailFields's signature and return type (Array of Record string-to-any) are unchanged, so Clause-②: no; returnType is already a declared FieldSchema key, so Metadata-protocol: none.

Changeset: @object-ui/plugin-detail patch.

Tests

New ui/packages/plugin-detail/src/__tests__/formulaReturnTypeRelay-27430.test.tsx, the same pin shape as #27689 (a formula with returnType: 'currency', currencyConfig: { currencyMode: 'fixed', defaultCurrency: 'USD' }, scale: 2, value 90000; a returnType: 'number' control at 1234.5):

• CONTROL: the fixture formula is spec-valid (FieldSchema.safeParse).
• buildRecordDetailFields carries returnType for both formulas.
• RecordDetailPanel draws $90,000.00 beside $150,000.00; the number formula draws 1,234.50 with no currency sign.
• RelatedList table cells: $90,000.00; the number formula cell is 1,234.50 with no currency sign.

Ablation (scripts/ablation-replace.mjs, each fix line deleted on its own, anchor 1 to 0, restored to the HEAD blob with git diff HEAD empty; vitest resolves the package from src):

• RelatedList line deleted: 1 failed, 3 passed; the cells read ["Tower","$150,000.00","90,000.00","1,234.50"].
• RecordDetailPanel line deleted: 2 failed, 2 passed (expected undefined to be 'currency'; the panel text lacks $90,000.00).

Acceptance notes

• The related list's page totals (BodyTableTotals) sum only TOTALLED_FIELD_TYPES and take the currency from a currency field's def; a formula column gets no total, as before. Not changed here.

Verification

Generated by Claude Code