fix(docsite): seed OverflowList properties-tab preview with items

[durvesh1992]

Summary

Closes #2872.

OverflowList's children prop is required, so the docsite properties-tab preview rendered an empty list ("can't render standalone"). Add playground.defaults.children (a few Button items) so the interactive preview shows a real, meaningful list.

packages/core/src/OverflowList/OverflowList.doc.mjs — added playground.defaults.children.

Testing

• Added a preview-state test: buildInitialState resolves the seeded children into 3 elements and getMissingRequiredProps is empty. component-preview-state.test.ts — 9/9 pass.
• Regenerated the docsite data and confirmed the playground children are present in the generated component registry.

Note: the properties-tab preview renders client-side, so I verified the fix at the data/logic level (same approach as the Icon/Skeleton preview fix in #3175). A quick visual check on the running docsite is welcome — I couldn't launch a browser in my environment.

Changeset

Included (@astryxdesign/core patch, docs).

[vercel]

Someone is attempting to deploy a commit to the Meta Open Source Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
astryx	Ready	Preview, Comment	Jun 28, 2026 4:42pm

[cixzhang]

Nice! There's a merge conflict.

[cixzhang]

I authorized the preview so we can take a look. We could maybe provide some width to the overflow list's container, and maybe add a default for the overflowRenderer in the playground as well since it only shows one item by default right now. Thanks for working on this!

[durvesh1992]

Thanks for authorizing the preview! Two things, one with a constraint:

1. Width / only one item showing — the list is behavior: 'observeSelf' by default, and in the centered preview it measures ~its own content width and collapses. I can switch the playground default to behavior: 'observeParent' so it sizes to the preview container and shows the full row. (Quick one-line change.)

2. Default overflowRenderer — here's the snag: playground.defaults values are serialized into the generated registry (they go through resolveValue/ElementDescriptors), so they can only be JSON-serializable. overflowRenderer is a (items) => ReactNode function, which can't be expressed there. So the auto-generated Properties preview can't really demonstrate the overflow "+N" affordance.

Given that, I think the cleaner way to show overflow properly (constrained width + a real overflowRenderer "+N" badge) is a dedicated showcase/example block for OverflowList, which is plain code and can include the function. Want me to:

• (a) just add behavior: 'observeParent' here so the Properties preview at least shows the full list, and/or
• (b) add a proper showcase block demonstrating overflow with an overflowRenderer?

Happy to do either/both. (Heads-up: I can't launch a browser in my environment, so I'd lean on your authorized preview to confirm the visual once I push.)

[durvesh1992]

Pushed option (a): added behavior: 'observeParent' to the playground defaults (55ecd0e). That makes the list measure the full-width preview container instead of its own collapsed content box, so the Properties preview should now show the full row instead of just one item.

On the overflowRenderer default — it genuinely can't go in playground.defaults (those are serialized to JSON, and overflowRenderer is a (items) => ReactNode function). To actually demonstrate the "+N" overflow affordance we'd want a dedicated showcase block (plain code, can include the function + a constrained width). Happy to add that as a follow-up if you'd like — just say the word. Could you confirm the preview looks right now?

[cixzhang]

The merge conflicts prevent build. If you're able to rebase I can help reauthorize the preview.

[durvesh1992]

Rebased/merged main in and resolved the conflict — it was component-preview-state.test.ts (my Icon/Skeleton preview tests from #3175 landed on main and overlapped this branch's OverflowList test). Kept all three; component-preview-state.test.ts passes (11/11). Build should be unblocked now — please go ahead and reauthorize the preview whenever you get a chance. 🙏

Recap of what's here: seeded children + behavior: 'observeParent' so the Properties preview shows the full row. (overflowRenderer still can't live in the serialized playground.defaults since it's a function — happy to add a dedicated showcase block for the "+N" overflow demo as a follow-up if you'd like.)

[cixzhang]

I think this is okay for now. Thank you for fixing the preview!

[cixzhang]

Mostly formatting. Unrelated but okay.