feat(sdui): design path for skipped components in codegen

[roblevintennis]

Background

codegen.config.ts maintains a skipComponents list of components excluded from all SDUI generated output because they require JS-tracked mutable state that cannot be expressed in a static AgNode. Issue #375 flagged several of these for future design work. This issue is the actionable follow-up: triage each skipped component, group by effort, and decide which ones are candidates for partial SDUI support.

Current skip list

Component	Reason skipped
Collapsible	requires open/close boolean state
Combobox	complex filtering + multi-select state
Flex	multi-component family (FlexRow/FlexCol/FlexInline) — no single wrapper
Menu	complex open + selected-value state
Pagination	stateful current-page tracking
ScrollProgress	tracks live scroll position — purely behavioral
ScrollToButton	scroll-detection behavioral component
Sidebar	open + collapsed state management
SidebarNav	no Props interface, pure slot composition
Slider	continuous value requires two-way binding
Toast	autoDismiss + open/close lifecycle
VisuallyHidden	no Props interface, pure slot wrapper

Proposed groupings

Group 1 — Achievable with an open prop (low effort)
Collapsible, Menu, Sidebar — the open/close state can be set from a static node prop, similar to how Dialog and Drawer are already supported. The open/close lifecycle fires as action aliases so the consumer can respond.

Group 2 — Requires payload-carrying on_change (medium effort)
Combobox, Slider — need two-way value binding or complex selection state. Depends on the on_change payload standardization tracked in #459.

Group 3 — Pagination — medium effort
Current page state needs to be expressible as a node prop, with on_change carrying the new page value.

Group 4 — Purely behavioral / no Props interface (skip indefinitely)
ScrollProgress, ScrollToButton, SidebarNav, VisuallyHidden — these either have no serializable props or track DOM/browser state that cannot be expressed in a JSON node. Not candidates for SDUI support.

Group 5 — Toast — design needed
autoDismiss + lifecycle complexity puts Toast in a category of its own. Needs a dedicated design discussion before any implementation.

Tasks

• Confirm Group 1 approach (open prop + action aliases) by prototyping Collapsible support — it is the simplest case and a good template
• File sub-issues for each Group 1 component (Collapsible, Menu, Sidebar) once approach is validated
• File sub-issue for Pagination once on_change payload shape is settled (design(sdui): adaptive questionnaire flows via server-side transition logic #459)
• File sub-issue for Combobox and Slider after design(sdui): adaptive questionnaire flows via server-side transition logic #459 on_change work lands
• Mark Group 4 components as permanently skipped with a comment in codegen.config.ts
• File a separate design issue for Toast

Related

• #375 — original stateful component support discussion
• #459 — on_change payload standardization (prerequisite for Group 2/3)
• v2/sdui/schema/scripts/codegen.config.ts — skipComponents list
• SPECIFICATION.md section 4 — Stateful Component Policy

[roblevintennis]

Closing summary

This issue is resolved. Here is what landed and what was consciously deferred.

Merged (PR #471 — issue-460/sdui-skipped-components)

• AgCollapsible — added to codegen as a rendererPrimitive (named summary slot requires a manual case). Full demo with accordion behavior and on_toggle action dispatch across React, Vue, and Lit.
• AgSlider — added to auto-codegen. onChange wired to on_change with { id, value } payload in all three renderers. Folded into the "Stateful components" demo with a live 0–10 count display.
• AgPagination — added to auto-codegen. onPageChange wired to on_change emitting { id, value: page }. No demo fixture (pagination requires a paginated data table to be meaningful as a standalone demo).
• Group 4 permanently skipped — ScrollProgress, ScrollToButton, SidebarNav, VisuallyHidden already had permanent-skip comments in codegen.config.ts.

Deferred with tracking issues

• AgCombobox — feat(sdui): add AgCombobox to codegen #470 (inline options: ComboboxOption[] array requires schema design work before codegen can proceed)
• AgCollapsible focus ring a11y — fix(collapsible): missing focus ring on summary trigger breaks keyboard a11y #469 (core v2/lib fix, separate concern)

Punted indefinitely

• Menu — complex open + selected-value state, no clear static representation
• Sidebar — open + collapsed state management, same constraint
• Toast — autoDismiss + open/close lifecycle needs a dedicated design discussion
• Flex — multi-component family (FlexRow/FlexCol/FlexInline) with no single wrapper; needs its own design session