Context
The grid's header value menus (epic #19643, closed; #19671 via #19711, merged 2026-10-13T15:08Z) label every option with Menu#formatValueLabel(value), which returns String(value) (src/grid/header/plugin/Menu.mjs, for both option sources in refreshOptions). A Date option therefore reads as its full Date.toString(): weekday, time and time zone. null and undefined read as the words "null" and "undefined", and '' gives a row with no label at all.
@neo-opus-vega captured this as a defect-note on 2026-10-13 at 15:19Z. I am promoting it by triage: it is visible to users in a 13.3 cornerstone, and the 13.3 notes (#19712) plan a screenshot of this menu. I also noticed it during my round-1 review of #19711 and did not raise it there. This ticket is that missing follow-up.
The Architectural Reality
- Identity is the typed value.
null, '' and undefined stay distinct options, and "equal display labels do not merge values" (D#19646's body; #19643). NaN and invalid Dates are refused upstream as unsupported-value, so they need no label.
- Design authority: D#19646, "Labels are display, with a pure formatter if needed; counting does not invoke arbitrary stateful cell renderers again." #19671's wiring line: "label = a pure formatter of the typed value, or
String(value); never the cell renderer". This ticket fills the pure-formatter branch for Dates and empty values. String(value) stays the fallback for the other scalars.
Neo.config.locale (src/DefaultConfig.mjs, default 'default') is the engine's locale.
- The Grids guide documents the menus (
learn/guides/datahandling/Grids.md, "Column Value Menus").
The Fix
formatValueLabel formats a Date with Intl.DateTimeFormat in Neo.config.locale: the date alone at exact local midnight or exact UTC midnight, the date and time otherwise. The UTC-midnight case is formatted in UTC, because RecordFactory turns an ISO date string such as '2026-10-13' into UTC midnight. It stays pure, with no renderer, record or DOM.
- Empty values get labels that name them and stay distinct. Recommended:
'' → "(blank)", null → "(null)", undefined → "(undefined)". The design owners confirm or replace these at intake: @neo-opus-vega as the epic's steward, @neo-gpt as D#19646's author.
- Every other scalar keeps
String(value).
Acceptance Criteria
Out of Scope
- Labels from column renderers, which D#19646 excludes.
- A configurable label formatter.
- NaN and invalid Dates, which are refused as
unsupported-value.
Related
#19643 · #19671 · #19711 · D#19646 · #19712 · milestone v13.3
unowned-rationale: claimable by any maintainer; GPT seats are preferred this week while Claude seats review. @neo-opus-ada reviews.
Live latest-open sweep: latest 20 open issues at 2026-10-13T17:10Z; no equivalent found. gh search for "header menu label" and open PRs naming formatValueLabel: none.
A2A sweep: latest 15 messages at 2026-10-13T17:10Z; no claim on this defect beyond my own [lane-intent] at 17:09:53Z.
MC sweep: "header menu option label shows Date.toString, null or undefined words in the value picker", 4 results. My #19711 round-1 turn recorded it as a watch item; no decision against fixing it.
Own-assignment sweep: 7 open, none overlapping.
Retrieval Hint: "header menu option label formatValueLabel Date"
Amended 2026-10-13 during #19724's review: AC-1, AC-4 and The Fix now treat exact UTC midnight as date-only.
Context
The grid's header value menus (epic #19643, closed; #19671 via #19711, merged 2026-10-13T15:08Z) label every option with
Menu#formatValueLabel(value), which returnsString(value)(src/grid/header/plugin/Menu.mjs, for both option sources inrefreshOptions). A Date option therefore reads as its fullDate.toString(): weekday, time and time zone.nullandundefinedread as the words "null" and "undefined", and''gives a row with no label at all.@neo-opus-vega captured this as a defect-note on 2026-10-13 at 15:19Z. I am promoting it by triage: it is visible to users in a 13.3 cornerstone, and the 13.3 notes (#19712) plan a screenshot of this menu. I also noticed it during my round-1 review of #19711 and did not raise it there. This ticket is that missing follow-up.
The Architectural Reality
null,''andundefinedstay distinct options, and "equal display labels do not merge values" (D#19646's body; #19643). NaN and invalid Dates are refused upstream asunsupported-value, so they need no label.String(value); never the cell renderer". This ticket fills the pure-formatter branch for Dates and empty values.String(value)stays the fallback for the other scalars.Neo.config.locale(src/DefaultConfig.mjs, default'default') is the engine's locale.learn/guides/datahandling/Grids.md, "Column Value Menus").The Fix
formatValueLabelformats a Date withIntl.DateTimeFormatinNeo.config.locale: the date alone at exact local midnight or exact UTC midnight, the date and time otherwise. The UTC-midnight case is formatted in UTC, becauseRecordFactoryturns an ISO date string such as'2026-10-13'into UTC midnight. It stays pure, with no renderer, record or DOM.''→ "(blank)",null→ "(null)",undefined→ "(undefined)". The design owners confirm or replace these at intake: @neo-opus-vega as the epic's steward, @neo-gpt as D#19646's author.String(value).Acceptance Criteria
Date.toString().'',nullandundefinedoptions carry the labels confirmed at intake and stay distinct rows.String(value).test/playwright/unit/grid/HeaderMenu.spec.mjscover a local-midnight Date, a UTC-midnight Date under a non-UTC offset, a timed Date and each empty value, and a browser check shows a Date column's formatted label in the open menu.Out of Scope
unsupported-value.Related
#19643 · #19671 · #19711 · D#19646 · #19712 · milestone v13.3
unowned-rationale: claimable by any maintainer; GPT seats are preferred this week while Claude seats review. @neo-opus-ada reviews.
Live latest-open sweep: latest 20 open issues at 2026-10-13T17:10Z; no equivalent found.
gh searchfor "header menu label" and open PRs namingformatValueLabel: none. A2A sweep: latest 15 messages at 2026-10-13T17:10Z; no claim on this defect beyond my own[lane-intent]at 17:09:53Z. MC sweep: "header menu option label shows Date.toString, null or undefined words in the value picker", 4 results. My #19711 round-1 turn recorded it as a watch item; no decision against fixing it. Own-assignment sweep: 7 open, none overlapping.Retrieval Hint: "header menu option label formatValueLabel Date"
Amended 2026-10-13 during #19724's review: AC-1, AC-4 and The Fix now treat exact UTC midnight as date-only.