showcase: no view authors an `emptyState`, so the `objects._views.<view>.emptyState` translation surface has no fixture to test

[huangyiirene]

Observation-class finding, filed unassigned per Prime Directive #10. Found while reconciling the i18n checklist for #7686 (item 3); recorded there as a waiver, not fixed, because showcase code is outside that card's declared file surface.

What

packages/spec/src/system/translation.zod.ts declares a per-view empty-state translation surface:

objects.<object>._views.<view_name>.emptyState.title
objects.<object>._views.<view_name>.emptyState.message

No view in examples/app-showcase authors an emptyState at all — a grep for emptyState across examples/app-showcase/src returns nothing, in the view definitions and in src/system/translations/index.ts alike. The declared group therefore has no reachable instance on the stock fixture: a zero-row view renders the console's own built-in placeholder, which is console chrome and not a resolution of this key.

Why it is worth writing down

The QA run #7640 tried to drive this variant of i18n.surface-matrix and could not — there is no translated key to render, so the clause lands blocked(fixture) on every run rather than testing the resolver. The checklist now waives it explicitly (i18n.surface-matrix → fixtures.knownGaps, revision 3), which stops each sweep from rediscovering it, but the waiver is a debt marker: paying it down means authoring one emptyState onto a showcase view plus its zh-CN bundle entry, after which the waiver flips back to a live clause.

Note examples/app-showcase/src/coverage.ts does not track emptyState either, so the showcase's demonstrated-or-waived ratchet does not currently see this gap from its side.

Not a defect today

Nothing a user hits: the spec declares the surface, and an app that authors an emptyState presumably gets it translated — that is exactly what no fixture proves either way. The cost is a permanently unprovable clause in the i18n matrix. Recording it so triage grades it rather than leaving it inside a checklist waiver.

Options, not a decision

• Author the fixture — add emptyState: { title, message } to one showcase view (a filtered slice that is genuinely empty on seed data reads best) and the matching objects.<object>._views.<view>.emptyState entry to the zh-CN bundle. Un-waives the clause and demonstrates the surface.
• Leave it waived — accept that this one group is asserted by the spec's own tests rather than by an end-to-end run, and keep the knownGap as the record.

Source: QA run #7640 · checklist card #7686.

[claude]

Findings triage — routing repair only (route A): appended domain:devx. The finding grade is unchanged and no ownership is taken.

Landing anchor: paying the debt means authoring one emptyState onto a showcase view plus its zh-CN bundle entry — examples/app-showcase/src/** QA-fixture work, routed to the devx lane like the sibling seed-fixture card #7746.

Stale-premise check on origin/main @ 8f1851e: git grep emptyState -- examples/app-showcase/src returns zero hits (counter-check that the scanner works: the surface itself is declared at packages/spec/src/system/translation.zod.ts:185-186, and the alias table at :191 maps empty/emptyMessage onto it). The fixture gap stands as filed.

本评论来自分诊座位 Routine（#5474 试点），不构成认领。

---

Generated by Claude Code

[os-zhuang]

Findings triage round, 2026-08-11 (maintainer-directed). Graded: hold — fixture gap only, no user-facing behaviour; take it with the next i18n checklist round or showcase view work, where authoring one emptyState costs nothing extra.

---

Generated by Claude Code

[hotlong]

Findings-round promotion: pm:queue (domain:devx kept, type Task).

The hold's ride-along strategy has one measured miss: the named sibling showcase-fixture card #7746 closed 2026-08-11 via merged PR #7789 without picking this up — so "take it with the next showcase work" demonstrably doesn't self-execute, and the card promotes on its own.

Premise re-verified on origin/main: zero emptyState hits across all of examples/, while the surface is fully declared (translation.zod.ts:185-195), authorable (view.zod.ts:1459) and documented (references/ui/view.mdx:511,599). Landing: one emptyState on a showcase view (examples/app-showcase/src/ui/views/*.view.ts) + its en/zh-CN entries under _views.<view>.emptyState.{title,message} in src/system/translations/index.ts, which already carries _views blocks to extend. Size XS.

Lane note (flag only): examples/** sits loosely in devx by QA-fixture precedent (#7746) — precedent kept, not re-litigated here.

本评论来自分诊座位（scheduled session session_01DLzE5XVRASxFotEU1h9cjH），不构成认领。

---

Generated by Claude Code