Update Admin Section types and add Number and EmptyState types

[kyledurand]

What

Regenerates the Admin Section type definitions from admin-ui-components 2.21.2, picking up the header work that has landed in Polaris since these types were last generated (1.25.0), and adds the missing Number and EmptyState definitions from the same generator run.

Section

New API surface for s-section:

Addition	Kind	Notes
subheading	property	Supporting text under the heading. Not a heading: no document-outline entry, doesn't shift child heading levels, not announced as part of the heading.
primaryAction	slot	Main call-to-action.
secondaryActions	slot	Alternative/supporting actions. A ButtonGroup holding an action plus an icon-only Menu activator renders as one segmented group.
graphic	slot	Decorative visual before the heading. Single icon-only Badge with size="large"; not rendered without a heading.
accessory	slot	Contextual info inline beside the heading text. Badge, Icon, Button, Menu, Text, Avatar, Thumbnail.
supplemental	slot	Status/metadata for the section as a whole, at the inline-end of the header. Badge, Avatar, Text, Icon, Thumbnail.

<Section heading="Payment" subheading="Captured 2 days ago">
  <Badge slot="graphic" icon="credit-card" size="large" />
  <Badge slot="accessory">Paid</Badge>
  <Text slot="supplemental">$248.00</Text>
  <Button slot="primaryAction">Refund</Button>
  Content
</Section>

Number and EmptyState (net new)

Both are in the Polaris 3P allowlist (UI_EXTENSIONS_COMPONENTS in admin-ui-components/lib/uiExtensionsBundlePlugin.js) but had never been generated onto any definition surface, so an extension author writing s-number or s-empty-state got no types at all.

s-number — no slots:

Property	Type	Notes
tone	'auto' | 'neutral' | 'info' | 'success' | 'warning' | 'caution' | 'critical'	Default 'auto'.
color	'base' | 'subdued'	Default 'base'.
fontSize	'auto' | 'small-200' | 'small-100' | 'small' | 'base' | 'large' | 'large-100'	Default 'auto'; also applies matching line-height and letter-spacing.
fontWeight	'auto' | 'base' | 'medium' | 'semibold' | 'bold'	Default 'auto'.
dir, accessibilityVisibility	inherited from TextProps	Required<Pick<TextProps, …>>.
id, lang, children	inherited from TextProps	The component styles the value passed in and renders it as given — format and localize it yourself.

s-empty-state:

Addition	Kind	Notes
heading	property	Required on the element; optional in JSX props.
graphic	slot	A single Image or Icon, directly or as the only child of a wrapper.
subheading	slot	Supporting text below the heading. Text and Link.
primaryAction	slot	A single Button with variant="primary".
secondaryActions	slot	A single Button with variant="secondary" or "auto" — despite the plural name, only one renders.

<EmptyState heading="No orders yet">
  <Icon slot="graphic" type="orders" />
  <Text slot="subheading">Orders will show up here once customers start buying.</Text>
  <Button slot="primaryAction" variant="primary">Create order</Button>
</EmptyState>

How

# in libraries/javascript/polaris (shop/world)
pnpm build:definitions --configComponents=Section
pnpm build:definitions --configComponents=Number,EmptyState

Note for anyone reproducing this: there is no -- before --configComponents. Under pnpm 11 the extra -- makes rollup treat the flag as a positional path. documentation/extensions-architecture.md in the Polaris zone is stale on this.

Scope note

The generator also rewrites surfaces/admin/components.d.ts and surfaces/admin/components/shared.d.ts in full. Both are still generated from 1.25.0 and have since accumulated hand-written docs polish (Description improvements, Use 'web components' terminology, Fix broken web-components doc links). Regenerating them here would be +7.9k/-2.5k and +4.2k/-1.3k and would revert all of that, so this PR is scoped to the per-component files — the same shape as 6ed2ff9, which exposed Popover.

Bringing those two files back in sync with Polaris is real work that deserves its own PR.

Follow-ups

• shopify.dev docs are not affected by this PR. docs/surfaces/admin/build-docs.mjs:51 generates from src/surfaces/admin/components.d.ts, not from the per-component file. That aggregate still has SectionSlots (@publicDocs) declaring only children, and RequiredSectionProps listing primaryAction/secondaryActions but not subheading, graphic, accessory, or supplemental — so the docs continue to describe Section at 1.25.0 until components.d.ts is regenerated. Number and EmptyState are absent from that aggregate entirely, so they get no docs page from this PR either.
• Number and EmptyState are not in admin/components/StandardComponents.ts. This PR ships their types; it does not add either to the standard admin extension component set. Section was already there, so it needs no component-set change. Exposing the two new ones is a deliberate separate decision, the shape 6ed2ff9 used for Popover.
• Note that Section.d.ts, Number.d.ts, and EmptyState.d.ts import PreactCustomElement and RenderImpl from ./shared.d.ts, which does not export them; Number.d.ts and EmptyState.d.ts additionally import TextProps and EmptyStateProps$1, which shared.d.ts only has as unexported TextProps$1 / EmptyStateProps$1. None of this errors because skipLibCheck: true (@shopify/typescript-configs/base.json), and Popover.d.ts already ships the identical dangling imports. It resolves when shared.d.ts is regenerated.
• shop/world: the admin-web remote definitions for s-section, s-number, and s-empty-state need the matching properties and slots. That change can only land after this merges and admin-web bumps @shopify/ui-extensions-next past 2026.10.0-rc.8.

Testing

• prettier --check clean on the changed files.
• Section is already in StandardComponents.ts, so no component-set change is needed.

[kyledurand]

/snapit

[shopify-github-actions-access]

🫰✨ Thanks @kyledurand! Your snapshots have been published to npm.

Test the snapshots by updating your package.json with the newly published versions:

"@shopify/ui-extensions": "0.0.0-snapshot-20260902134640",
"@shopify/ui-extensions-tester": "0.0.0-snapshot-20260902134640"