Components has no stable pass-through slot contract for unstyled rendering

[woksin]

Problem / motivation

This issue promotes a previously recorded upstream item from a production Cratis consumer. The complete evidence, proposed seam and limits follow.

Status: Open upstream improvement · filing in progress 2026-08-10
Product: Components / PrimeReact integration
Class: Styling compatibility seam

Gap and Ada cost

Ada renders PrimeReact unstyled through a pass-through preset keyed by data-pc-section and data-p-* slots.
Neither Components nor PrimeReact gives the consumer a stable slot compatibility contract, so an ordinary upgrade
can silently leave a widget bare while build, lint and component specs stay green. Ada must run a manual visual
sweep across Button, Dialog, DataTable/paginator/menubar, Dropdown, Calendar, Checkbox and Toast at three
breakpoints on every relevant release.

Requested seam

Publish/version the slot contract Components relies on and provide a machine-readable compatibility check or
rendered contract suite consumers can run against an unstyled preset. Announce slot changes as compatibility work.

Honest limits

Ada has paid repeated manual verification cost but has not recorded a shipped production regression from a slot
rename. The request is a stable verification surface, not ownership of Ada's theme.

[woksin]

Genuinely blocked on #107 — and this is a design request rather than a defect, which the body itself concedes ("Ada has paid repeated manual verification cost but has not recorded a shipped production regression from a slot rename").

The pt contract measurably changes between the pinned primereact@10.9.8 and 11. Evidence from #107's own diff of Source/.storybook/pt-preset.ts — stronger than release notes because it is this repo's own mapping: inputtextarea → textarea; dropdown → select, and inside it input→value, trigger→dropdown, panel→popup, item→option; the entire menubar block deleted with the note "PrimeReact 11 removed Menubar". primereact@11.1.0 sits on @primereact/core + @primereact/headless, and #107 migrates the library to the compositional/headless components — that layer is what emits the slots. 75 pt/unstyled sites across the source ride on it.

Publishing a slot contract now would ratify v10 keys that #107 renames wholesale.

Proposal: re-scope this as a deliverable of the v11 migration rather than a parallel effort — promote pt-preset.ts out of .storybook/ into a published, versioned contract plus a rendered unstyled-contract suite, authored against v11 keys.