@shopify/polaris-types 1.0.4 → 1.0.5

package/dist/polaris.d.ts

@@ -202,7 +202,7 @@ interface BackgroundProps {
  */
 type ToneKeyword = 'auto' | 'neutral' | 'info' | 'success' | 'caution' | 'warning' | 'critical' | 'accent' | 'custom';
 
-declare const privateIconArray: readonly ["adjust", "affiliate", "airplane", "alert-bubble", "alert-circle", "alert-diamond", "alert-location", "alert-octagon", "alert-octagon-filled", "alert-triangle", "alert-triangle-filled", "align-horizontal-centers", "app-extension", "apps", "archive", "arrow-down", "arrow-down-circle", "arrow-down-right", "arrow-left", "arrow-left-circle", "arrow-right", "arrow-right-circle", "arrow-up", "arrow-up-circle", "arrow-up-right", "arrows-in-horizontal", "arrows-out-horizontal", "asterisk", "attachment", "automation", "backspace", "bag", "bank", "barcode", "battery-low", "bill", "blank", "blog", "bolt", "bolt-filled", "book", "book-open", "bug", "bullet", "business-entity", "button", "button-press", "calculator", "calendar", "calendar-check", "calendar-compare", "calendar-list", "calendar-time", "camera", "camera-flip", "caret-down", "caret-left", "caret-right", "caret-up", "cart", "cart-abandoned", "cart-discount", "cart-down", "cart-filled", "cart-sale", "cart-send", "cart-up", "cash-dollar", "cash-euro", "cash-pound", "cash-rupee", "cash-yen", "catalog-product", "categories", "channels", "channels-filled", "chart-cohort", "chart-donut", "chart-funnel", "chart-histogram-first", "chart-histogram-first-last", "chart-histogram-flat", "chart-histogram-full", "chart-histogram-growth", "chart-histogram-last", "chart-histogram-second-last", "chart-horizontal", "chart-line", "chart-popular", "chart-stacked", "chart-vertical", "chat", "chat-new", "chat-referral", "check", "check-circle", "check-circle-filled", "checkbox", "chevron-down", "chevron-down-circle", "chevron-left", "chevron-left-circle", "chevron-right", "chevron-right-circle", "chevron-up", "chevron-up-circle", "circle", "circle-dashed", "clipboard", "clipboard-check", "clipboard-checklist", "clock", "clock-list", "clock-revert", "code", "code-add", "collection", "collection-featured", "collection-list", "collection-reference", "color", "color-none", "compass", "complete", "compose", "confetti", "connect", "content", "contract", "corner-pill", "corner-round", "corner-square", "credit-card", "credit-card-cancel", "credit-card-percent", "credit-card-reader", "credit-card-reader-chip", "credit-card-reader-tap", "credit-card-secure", "credit-card-tap-chip", "crop", "currency-convert", "cursor", "cursor-banner", "cursor-option", "data-presentation", "data-table", "database", "database-add", "database-connect", "delete", "delivered", "delivery", "desktop", "disabled", "disabled-filled", "discount", "discount-add", "discount-automatic", "discount-code", "discount-remove", "dns-settings", "dock-floating", "dock-side", "domain", "domain-landing-page", "domain-new", "domain-redirect", "download", "drag-drop", "drag-handle", "drawer", "duplicate", "edit", "email", "email-follow-up", "email-newsletter", "empty", "enabled", "enter", "envelope", "envelope-soft-pack", "eraser", "exchange", "exit", "export", "external", "eye-check-mark", "eye-dropper", "eye-dropper-list", "eye-first", "eyeglasses", "fav", "favicon", "file", "file-list", "filter", "filter-active", "flag", "flip-horizontal", "flip-vertical", "flower", "folder", "folder-add", "folder-down", "folder-remove", "folder-up", "food", "foreground", "forklift", "forms", "games", "gauge", "geolocation", "gift", "gift-card", "git-branch", "git-commit", "git-repository", "globe", "globe-asia", "globe-europe", "globe-lines", "globe-list", "graduation-hat", "grid", "hashtag", "hashtag-decimal", "hashtag-list", "heart", "hide", "hide-filled", "home", "home-filled", "icons", "identity-card", "image", "image-add", "image-alt", "image-explore", "image-magic", "image-none", "image-with-text-overlay", "images", "import", "in-progress", "incentive", "incoming", "incomplete", "info", "info-filled", "inheritance", "inventory", "inventory-edit", "inventory-list", "inventory-transfer", "inventory-updated", "iq", "key", "keyboard", "keyboard-filled", "keyboard-hide", "keypad", "label-printer", "language", "language-translate", "layout-block", "layout-buy-button", "layout-buy-button-horizontal", "layout-buy-button-vertical", "layout-column-1", "layout-columns-2", "layout-columns-3", "layout-footer", "layout-header", "layout-logo-block", "layout-popup", "layout-rows-2", "layout-section", "layout-sidebar-left", "layout-sidebar-right", "lightbulb", "link", "link-list", "list-bulleted", "list-bulleted-filled", "list-numbered", "live", "live-critical", "live-none", "location", "location-none", "lock", "map", "markets", "markets-euro", "markets-rupee", "markets-yen", "maximize", "measurement-size", "measurement-size-list", "measurement-volume", "measurement-volume-list", "measurement-weight", "measurement-weight-list", "media-receiver", "megaphone", "mention", "menu", "menu-filled", "menu-horizontal", "menu-vertical", "merge", "metafields", "metaobject", "metaobject-list", "metaobject-reference", "microphone", "microphone-muted", "minimize", "minus", "minus-circle", "mobile", "money", "money-none", "money-split", "moon", "nature", "note", "note-add", "notification", "number-one", "order", "order-batches", "order-draft", "order-filled", "order-first", "order-fulfilled", "order-repeat", "order-unfulfilled", "orders-status", "organization", "outdent", "outgoing", "package", "package-cancel", "package-fulfilled", "package-on-hold", "package-reassign", "package-returned", "page", "page-add", "page-attachment", "page-clock", "page-down", "page-heart", "page-list", "page-reference", "page-remove", "page-report", "page-up", "pagination-end", "pagination-start", "paint-brush-flat", "paint-brush-round", "paper-check", "partially-complete", "passkey", "paste", "pause-circle", "payment", "payment-capture", "payout", "payout-dollar", "payout-euro", "payout-pound", "payout-rupee", "payout-yen", "person", "person-add", "person-exit", "person-filled", "person-list", "person-lock", "person-remove", "person-segment", "personalized-text", "phablet", "phone", "phone-down", "phone-down-filled", "phone-in", "phone-out", "pin", "pin-remove", "plan", "play", "play-circle", "plus", "plus-circle", "plus-circle-down", "plus-circle-filled", "plus-circle-up", "point-of-sale", "point-of-sale-register", "price-list", "print", "product", "product-add", "product-cost", "product-filled", "product-list", "product-reference", "product-remove", "product-return", "product-unavailable", "profile", "profile-filled", "question-circle", "question-circle-filled", "radio-control", "receipt", "receipt-dollar", "receipt-euro", "receipt-folded", "receipt-paid", "receipt-pound", "receipt-refund", "receipt-rupee", "receipt-yen", "receivables", "redo", "referral-code", "refresh", "remove-background", "reorder", "replace", "replay", "reset", "return", "reward", "rocket", "rotate-left", "rotate-right", "sandbox", "save", "savings", "scan-qr-code", "search", "search-add", "search-list", "search-recent", "search-resource", "select", "send", "settings", "share", "shield-check-mark", "shield-none", "shield-pending", "shield-person", "shipping-label", "shipping-label-cancel", "shopcodes", "slideshow", "smiley-happy", "smiley-joy", "smiley-neutral", "smiley-sad", "social-ad", "social-post", "sort", "sort-ascending", "sort-descending", "sound", "split", "sports", "star", "star-circle", "star-filled", "star-half", "star-list", "status", "status-active", "stop-circle", "store", "store-import", "store-managed", "store-online", "sun", "table", "table-masonry", "tablet", "target", "tax", "team", "text", "text-align-center", "text-align-left", "text-align-right", "text-block", "text-bold", "text-color", "text-font", "text-font-list", "text-grammar", "text-in-columns", "text-in-rows", "text-indent", "text-indent-remove", "text-italic", "text-quote", "text-title", "text-underline", "text-with-image", "theme", "theme-cart", "theme-edit", "theme-store", "theme-template", "three-d-environment", "thumbs-down", "thumbs-up", "tip-jar", "toggle-off", "toggle-on", "transaction", "transaction-fee-add", "transaction-fee-dollar", "transaction-fee-euro", "transaction-fee-pound", "transaction-fee-rupee", "transaction-fee-yen", "transfer", "transfer-in", "transfer-internal", "transfer-out", "truck", "undo", "unknown-device", "unlock", "upload", "variant", "variant-list", "video", "video-list", "view", "viewport-narrow", "viewport-short", "viewport-tall", "viewport-wide", "wallet", "wand", "watch", "wifi", "work", "work-list", "wrench", "x", "x-circle", "x-circle-filled"];
+declare const privateIconArray: readonly ["adjust", "affiliate", "airplane", "alert-bubble", "alert-circle", "alert-diamond", "alert-location", "alert-octagon", "alert-octagon-filled", "alert-triangle", "alert-triangle-filled", "align-horizontal-centers", "app-extension", "apps", "archive", "arrow-down", "arrow-down-circle", "arrow-down-right", "arrow-left", "arrow-left-circle", "arrow-right", "arrow-right-circle", "arrow-up", "arrow-up-circle", "arrow-up-right", "arrows-in-horizontal", "arrows-out-horizontal", "asterisk", "attachment", "automation", "backspace", "bag", "bank", "barcode", "battery-low", "bill", "blank", "blog", "bolt", "bolt-filled", "book", "book-open", "brain", "bug", "bullet", "business-entity", "button", "button-press", "calculator", "calendar", "calendar-check", "calendar-compare", "calendar-list", "calendar-time", "camera", "camera-flip", "caret-down", "caret-left", "caret-right", "caret-up", "cart", "cart-abandoned", "cart-discount", "cart-down", "cart-filled", "cart-sale", "cart-send", "cart-up", "cash-dollar", "cash-euro", "cash-pound", "cash-rupee", "cash-yen", "catalog-product", "categories", "channels", "channels-filled", "chart-cohort", "chart-donut", "chart-funnel", "chart-histogram-first", "chart-histogram-first-last", "chart-histogram-flat", "chart-histogram-full", "chart-histogram-growth", "chart-histogram-last", "chart-histogram-second-last", "chart-horizontal", "chart-line", "chart-popular", "chart-stacked", "chart-vertical", "chat", "chat-new", "chat-referral", "check", "check-circle", "check-circle-filled", "checkbox", "chevron-down", "chevron-down-circle", "chevron-left", "chevron-left-circle", "chevron-right", "chevron-right-circle", "chevron-up", "chevron-up-circle", "circle", "circle-dashed", "clipboard", "clipboard-check", "clipboard-checklist", "clock", "clock-list", "clock-revert", "code", "code-add", "collection", "collection-featured", "collection-list", "collection-reference", "color", "color-none", "compass", "complete", "compose", "confetti", "connect", "content", "contract", "corner-pill", "corner-round", "corner-square", "credit-card", "credit-card-cancel", "credit-card-percent", "credit-card-reader", "credit-card-reader-chip", "credit-card-reader-tap", "credit-card-secure", "credit-card-tap-chip", "crop", "currency-convert", "cursor", "cursor-banner", "cursor-option", "data-presentation", "data-table", "database", "database-add", "database-connect", "delete", "delivered", "delivery", "desktop", "disabled", "disabled-filled", "discount", "discount-add", "discount-automatic", "discount-code", "discount-remove", "dns-settings", "dock-floating", "dock-side", "domain", "domain-landing-page", "domain-new", "domain-redirect", "download", "drag-drop", "drag-handle", "drawer", "duplicate", "edit", "email", "email-follow-up", "email-newsletter", "empty", "enabled", "enter", "envelope", "envelope-soft-pack", "eraser", "exchange", "exit", "export", "external", "eye-check-mark", "eye-dropper", "eye-dropper-list", "eye-first", "eyeglasses", "fav", "favicon", "file", "file-list", "filter", "filter-active", "flag", "flip-horizontal", "flip-vertical", "flower", "folder", "folder-add", "folder-down", "folder-remove", "folder-up", "food", "foreground", "forklift", "forms", "games", "gauge", "geolocation", "gift", "gift-card", "git-branch", "git-commit", "git-repository", "globe", "globe-asia", "globe-europe", "globe-lines", "globe-list", "graduation-hat", "grid", "hashtag", "hashtag-decimal", "hashtag-list", "heart", "hide", "hide-filled", "home", "home-filled", "icons", "identity-card", "image", "image-add", "image-alt", "image-explore", "image-magic", "image-none", "image-with-text-overlay", "images", "import", "in-progress", "incentive", "incoming", "incomplete", "info", "info-filled", "inheritance", "inventory", "inventory-edit", "inventory-list", "inventory-transfer", "inventory-updated", "iq", "key", "keyboard", "keyboard-filled", "keyboard-hide", "keypad", "label-printer", "language", "language-translate", "layout-block", "layout-buy-button", "layout-buy-button-horizontal", "layout-buy-button-vertical", "layout-column-1", "layout-columns-2", "layout-columns-3", "layout-footer", "layout-header", "layout-logo-block", "layout-popup", "layout-rows-2", "layout-section", "layout-sidebar-left", "layout-sidebar-right", "layer", "lightbulb", "link", "link-list", "list-bulleted", "list-bulleted-filled", "list-numbered", "live", "live-critical", "live-none", "location", "location-none", "lock", "map", "markets", "markets-euro", "markets-rupee", "markets-yen", "maximize", "measurement-size", "measurement-size-list", "measurement-volume", "measurement-volume-list", "measurement-weight", "measurement-weight-list", "media-receiver", "megaphone", "mention", "menu", "menu-filled", "menu-horizontal", "menu-vertical", "merge", "metafields", "metaobject", "metaobject-list", "metaobject-reference", "microphone", "microphone-muted", "minimize", "minus", "minus-circle", "mobile", "money", "money-none", "money-split", "moon", "nature", "note", "note-add", "notification", "number-one", "order", "order-batches", "order-draft", "order-filled", "order-first", "order-fulfilled", "order-repeat", "order-unfulfilled", "orders-status", "organization", "outdent", "outgoing", "package", "package-cancel", "package-fulfilled", "package-on-hold", "package-reassign", "package-returned", "page", "page-add", "page-attachment", "page-clock", "page-down", "page-heart", "page-list", "page-reference", "page-remove", "page-report", "page-up", "pagination-end", "pagination-start", "paint-brush-flat", "paint-brush-round", "paper-check", "partially-complete", "passkey", "paste", "pause-circle", "payment", "payment-capture", "payout", "payout-dollar", "payout-euro", "payout-pound", "payout-rupee", "payout-yen", "person", "person-add", "person-exit", "person-filled", "person-list", "person-lock", "person-remove", "person-segment", "personalized-text", "phablet", "phone", "phone-down", "phone-down-filled", "phone-in", "phone-out", "pin", "pin-remove", "plan", "play", "play-circle", "plus", "plus-circle", "plus-circle-down", "plus-circle-filled", "plus-circle-up", "point-of-sale", "point-of-sale-register", "price-list", "print", "product", "product-add", "product-cost", "product-filled", "product-list", "product-reference", "product-remove", "product-return", "product-unavailable", "profile", "profile-filled", "question-circle", "question-circle-filled", "radio-control", "receipt", "receipt-dollar", "receipt-euro", "receipt-folded", "receipt-paid", "receipt-pound", "receipt-refund", "receipt-rupee", "receipt-yen", "receivables", "redo", "referral-code", "refresh", "remove-background", "reorder", "replace", "replay", "reset", "return", "reward", "rocket", "rotate-left", "rotate-right", "sandbox", "save", "savings", "scan-qr-code", "search", "search-add", "search-list", "search-recent", "search-resource", "select", "send", "settings", "share", "shield-check-mark", "shield-none", "shield-pending", "shield-person", "shipping-label", "shipping-label-cancel", "shopcodes", "slideshow", "smiley-happy", "smiley-joy", "smiley-neutral", "smiley-sad", "social-ad", "social-post", "sort", "sort-ascending", "sort-descending", "sound", "split", "sports", "star", "star-circle", "star-filled", "star-half", "star-list", "status", "status-active", "stop-circle", "store", "store-import", "store-managed", "store-online", "sun", "table", "table-masonry", "tablet", "target", "tax", "team", "text", "text-align-center", "text-align-left", "text-align-right", "text-block", "text-bold", "text-color", "text-font", "text-font-list", "text-grammar", "text-in-columns", "text-in-rows", "text-indent", "text-indent-remove", "text-italic", "text-quote", "text-title", "text-underline", "text-with-image", "theme", "theme-cart", "theme-edit", "theme-store", "theme-template", "three-d-environment", "thumbs-down", "thumbs-up", "tip-jar", "toggle-off", "toggle-on", "transaction", "transaction-fee-add", "transaction-fee-dollar", "transaction-fee-euro", "transaction-fee-pound", "transaction-fee-rupee", "transaction-fee-yen", "transfer", "transfer-in", "transfer-internal", "transfer-out", "truck", "undo", "unknown-device", "unlock", "upload", "variant", "variant-list", "video", "video-list", "view", "viewport-narrow", "viewport-short", "viewport-tall", "viewport-wide", "wallet", "wand", "watch", "wifi", "work", "work-list", "wrench", "x", "x-circle", "x-circle-filled"];
 type IconType$1 = (typeof privateIconArray)[number];
 
 /**
@@ -1024,8 +1024,14 @@ interface FieldErrorProps {
     /**
      * Indicate an error to the user. The field will be given a specific stylistic treatment
      * to communicate problems that have to be resolved immediately.
+     *
+     * @implementation (string) The error is a simple string that will be displayed to the user.
+     *
+     * @implementation (ComponentChildren) Behaves as a slot: any elements passed
+     * are rendered as the error content (subject to surface constraints); there
+     * is no coercion to a string.
      */
-    error?: string;
+    error?: string | ComponentChildren;
 }
 interface BasicFieldProps extends FieldErrorProps, LabelAccessibilityVisibilityProps {
     /**
@@ -1039,8 +1045,14 @@ interface BasicFieldProps extends FieldErrorProps, LabelAccessibilityVisibilityP
     required?: boolean;
     /**
      * Content to use as the field label.
+     *
+     * @implementation (string) The label is a simple string that will be displayed to the user.
+     *
+     * @implementation (ComponentChildren) Behaves as a slot: any elements passed
+     * are rendered as the label content (subject to surface constraints); there
+     * is no coercion to a string.
      */
-    label?: string;
+    label?: string | ComponentChildren;
 }
 interface FieldDetailsProps {
     /**
@@ -1049,8 +1061,14 @@ interface FieldDetailsProps {
      * to offer more information or instructions to the user.
      *
      * This will also be exposed to screen reader users.
+     *
+     * @implementation (string) The details is a simple string that will be displayed to the user.
+     *
+     * @implementation (ComponentChildren) Behaves as a slot: any elements passed
+     * are rendered as the details content (subject to surface constraints); there
+     * is no coercion to a string.
      */
-    details?: string;
+    details?: string | ComponentChildren;
 }
 interface FieldProps extends BasicFieldProps, InputProps, FocusEventProps, FieldDetailsProps {
     /**
@@ -1194,11 +1212,17 @@ interface BaseOptionProps extends BaseSelectableProps {
      */
     defaultSelected?: boolean;
 }
-interface BaseCheckableProps extends BaseSelectableProps, InteractionProps {
+interface BaseCheckableProps extends BaseSelectableProps, FocusEventProps, LabelAccessibilityVisibilityProps, InteractionProps {
     /**
      * Visual content to use as the control label.
+     *
+     * @implementation (string) The label is a simple string that will be displayed to the user.
+     *
+     * @implementation (ComponentChildren) Behaves as a slot: any elements passed
+     * are rendered as the label content (subject to surface constraints); there
+     * is no coercion to a string.
      */
-    label?: string;
+    label?: string | ComponentChildren;
     /**
      * Whether the control is active.
      *
@@ -2188,7 +2212,7 @@ interface MenuProps$1 extends GlobalProps {
      */
     accessibilityLabel?: string;
     /**
-     * The children define the actions to render inside the Menu. Only Button components are allowed as children of a Menu, and these Buttons can perform actions (using `onClick`) or link to other parts of the application (using `to`/ `href`). Any other component placed here will be ignored.
+     * The children define the actions to render inside the Menu. Only Button and SearchField components are allowed as children of a Menu, and these Buttons can perform actions (using `onClick`) or link to other parts of the application (using `to`/ `href`). Any other component placed here will be ignored.
      */
     children?: ComponentChildren;
 }
@@ -2240,6 +2264,10 @@ interface MoneyFieldProps$1 extends GlobalProps, BaseTextFieldProps, NumberConst
      *
      * When set to 'auto', the field will display the currency code of the shop.
      * If no currency code is set for the shop, resolve to 'XXX' the explicit non value.
+     *
+     * This value will match the global currency code of the shop, so if you need to know the currency code of the field,
+     * you can read the value from those APIs.
+     *
      * @default 'auto'
      */
     currencyCode?: CurrencyCode | 'auto';
@@ -2342,6 +2370,12 @@ interface PageProps$1 extends GlobalProps, ActionSlots {
      * @default 'base'
      */
     inlineSize?: SizeKeyword;
+    /**
+     * A slot for content that comes before the main content, such as an `s-banner`.
+     *
+     * @implementation surfaces could restrict the content of this slot to certain elements, such as only allowing an `s-banner`.
+     */
+    supplementalStart?: ComponentChildren;
 }
 
 interface ParagraphProps$1 extends GlobalProps, BaseTypographyProps, BlockTypographyProps, AccessibilityVisibilityProps {
@@ -2561,6 +2595,7 @@ interface PaginationProps {
      */
     loading?: boolean;
 }
+type ComputedTableVariant = 'list' | 'table';
 interface TableProps$1 extends GlobalProps, PaginationProps {
     /**
      * The content of the Table.
@@ -2573,13 +2608,22 @@ interface TableProps$1 extends GlobalProps, PaginationProps {
     /**
      * Sets the layout of the Table.
      *
-     * - `list`: The Table is always displayed as a list.
-     * - `table`: The Table is always displayed as a table.
+     * - `list`: The Table is displayed as a list.
+     * - `table`: The Table is displayed as a table.
      * - `auto`: The Table is displayed as a table on wide devices and as a list on narrow devices.
      *
      * @default 'auto'
      */
-    variant?: 'list' | 'table' | 'auto';
+    variant?: ComputedTableVariant | 'auto';
+    /**
+     * The currently-used variant of the Table.
+     * This is only a getter; you cannot set it.
+     */
+    computedVariant?: ComputedTableVariant;
+    /**
+     * Event is emitted when the computed variant of the Table changes.
+     */
+    onComputedVariantChange?: (event: Event) => void;
 }
 
 interface TableBodyProps$1 extends GlobalProps {
@@ -2803,6 +2847,7 @@ type URLAutocompleteField = ExtractStrict<AnyAutocompleteField, 'url' | 'photo'
 
 type Styles = string;
 declare const shadowRootSymbol: unique symbol;
+declare const flushRenderSymbol: unique symbol;
 type RenderImpl = Omit<ShadowRootInit, 'mode'> & {
     ShadowRoot: (element: any) => ComponentChildren$1;
     styles?: Styles;
@@ -2828,13 +2873,39 @@ interface ClickOptions {
  * While this class could be used in both Node and the browser, the constructor will only be used in the browser.
  * So we give it a type of HTMLElement to avoid typing issues later where it's used, which will only happen in the browser.
  */
-declare const BaseClass$3: typeof globalThis.HTMLElement;
-declare abstract class PreactCustomElement extends BaseClass$3 {
+declare const BaseClass$2: typeof globalThis.HTMLElement;
+declare abstract class PreactCustomElement extends BaseClass$2 {
     /** @private */
     static get observedAttributes(): string[];
     /** @private */
     [shadowRootSymbol]: ShadowRoot | null;
+    /**
+     * A promise that resolves after the next render completes.
+     * Useful for non-React consumers who need to wait for the shadow DOM
+     * to be populated after setting properties.
+     */
+    get updateComplete(): Promise<void>;
     constructor({ styles, ShadowRoot: renderFunction, delegatesFocus, globalShadowCSS, ...options }: RenderImpl);
+    /**
+     * Flush any pending render synchronously.
+     *
+     * Called by reactWrap's useLayoutEffect after all props are set,
+     * ensuring the shadow DOM is populated before the consumer's
+     * useLayoutEffect fires. The version counter invalidates any
+     * pending microtask so the total render count stays at 1.
+     *
+     * Uses a Symbol key so this method is not callable by external
+     * consumers — only internal code that imports flushRenderSymbol
+     * can invoke it.
+     *
+     * Guarded by #hasPendingRender to avoid spurious Preact re-renders.
+     * React creates a new props object reference on every parent render,
+     * so reactWrap's useLayoutEffect (which depends on [props]) fires
+     * even when no prop *values* changed. Without the guard, every
+     * unrelated parent re-render would trigger a full Preact
+     * reconciliation — proportional to parent re-render frequency.
+     */
+    [flushRenderSymbol](): void;
     /** @private */
     setAttribute(name: string, value: string): void;
     /** @private */
@@ -2911,21 +2982,73 @@ declare global {
     }
 }
 
+/**
+ * An event object with a strongly-typed `currentTarget` property that references the specific HTML element that triggered the event.
+ *
+ * This type extends the standard DOM `Event` interface and ensures type safety when accessing the element that fired the event.
+ */
 type CallbackEvent<T extends keyof HTMLElementTagNameMap> = Event & {
     currentTarget: HTMLElementTagNameMap[T];
 };
+/**
+ * A toggle event with a strongly-typed `currentTarget` property.
+ * Extends the `ToggleEvent` interface with type-safe access to the element that triggered the toggle.
+ */
 type CallbackToggleEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends ToggleEvent = ToggleEvent> = TEvent & {
     currentTarget: HTMLElementTagNameMap[TTagName];
 };
+/**
+ * A function that handles events from UI components.
+ *
+ * This type represents an event listener callback that receives a `CallbackEvent` with a strongly-typed `currentTarget`.
+ * Use this for component event handlers like `click`, `focus`, `blur`, and other DOM events.
+ *
+ * @example
+ * const handleClick: CallbackEventListener<'button'> = (event) => {
+ *   console.log('Button clicked:', event.currentTarget);
+ * };
+ */
 type CallbackEventListener<T extends keyof HTMLElementTagNameMap> = (EventListener & {
     (event: CallbackEvent<T>): void;
 }) | null;
 type FieldReactProps<T extends keyof HTMLElementTagNameMap> = {
+    /**
+     * A callback fired when the user makes changes to the field value. This fires before `onChange`.
+     */
     onInput?: ((event: CallbackEvent<T>) => void) | null;
+    /**
+     * A callback fired when the user has finished editing the field, such as when they blur the field.
+     */
     onChange?: ((event: CallbackEvent<T>) => void) | null;
+    /**
+     * A callback fired when the field receives focus.
+     */
     onFocus?: ((event: CallbackEvent<T>) => void) | null;
+    /**
+     * A callback fired when the field loses focus.
+     */
     onBlur?: ((event: CallbackEvent<T>) => void) | null;
 };
+/**
+ * Props for field slot content (label, error, details) that accept
+ * either a string or JSX content in the React wrapper.
+ *
+ * Internal use only — not exported publicly. External consumers receive
+ * string-only types via FieldSlotPreactProps.
+ */
+type FieldSlotInternalReactProps = {
+    error?: preact.ComponentChildren;
+    details?: preact.ComponentChildren;
+};
+/**
+ * Preact JSX string-only versions of field slot props.
+ * Used in Preact module declarations after Omit-ing the ComponentChildren
+ * versions (required by force-omit-react-slots lint rule).
+ */
+type FieldSlotPreactProps = {
+    error?: string;
+    details?: string;
+};
 /** Used when an element does not have children. */
 interface PreactBaseElementProps<TClass extends HTMLElement> {
     /** Assigns a unique key to this element. */
@@ -2959,6 +3082,10 @@ interface PolarisGlobal {
             moreActions: string;
             /** Template for the add value chip. Use `{label}` as the placeholder. */
             addValue: string;
+            /** Template for the edit value button in inline layout. Use `{label}` as the placeholder. */
+            editValue: string;
+            /** Label shown when a read-only multi picker field has no values. */
+            none: string;
         };
         pagination: {
             goToNextPage: string;
@@ -2975,6 +3102,7 @@ interface PolarisGlobal {
             hueSliderLabel: string;
             alphaSliderLabel: string;
             thumbDescription: string;
+            thumbLabel: string;
         };
         colorField: {
             colorPreviewDescription: string;
@@ -3088,7 +3216,7 @@ declare module 'preact' {
     }
 }
 
-type IconType = "adjust" | "affiliate" | "airplane" | "alert-bubble" | "alert-circle" | "alert-diamond" | "alert-location" | "alert-octagon" | "alert-octagon-filled" | "alert-triangle" | "align-horizontal-centers" | "app-extension" | "apps" | "archive" | "arrow-down" | "arrow-down-circle" | "arrow-left" | "arrow-left-circle" | "arrow-right" | "arrow-right-circle" | "arrow-up" | "arrow-up-circle" | "arrow-up-right" | "arrows-in-horizontal" | "arrows-out-horizontal" | "asterisk" | "attachment" | "automation" | "backspace" | "bag" | "bank" | "barcode" | "bill" | "blank" | "blog" | "bolt" | "bolt-filled" | "book" | "book-open" | "bug" | "bullet" | "business-entity" | "button" | "button-press" | "calculator" | "calendar" | "calendar-check" | "calendar-compare" | "calendar-list" | "calendar-time" | "camera" | "camera-flip" | "caret-down" | "caret-left" | "caret-right" | "caret-up" | "cart" | "cart-abandoned" | "cart-discount" | "cart-down" | "cart-sale" | "cart-up" | "cash-dollar" | "cash-euro" | "cash-pound" | "cash-rupee" | "cash-yen" | "catalog-product" | "categories" | "channels" | "channels-filled" | "chart-cohort" | "chart-donut" | "chart-funnel" | "chart-histogram-first" | "chart-histogram-first-last" | "chart-histogram-flat" | "chart-histogram-full" | "chart-histogram-growth" | "chart-histogram-last" | "chart-histogram-second-last" | "chart-horizontal" | "chart-line" | "chart-popular" | "chart-stacked" | "chart-vertical" | "chat" | "chat-new" | "chat-referral" | "check" | "check-circle" | "check-circle-filled" | "checkbox" | "chevron-down" | "chevron-down-circle" | "chevron-left" | "chevron-left-circle" | "chevron-right" | "chevron-right-circle" | "chevron-up" | "chevron-up-circle" | "circle" | "circle-dashed" | "clipboard" | "clipboard-check" | "clipboard-checklist" | "clock" | "clock-list" | "clock-revert" | "code" | "code-add" | "collection" | "collection-featured" | "collection-list" | "collection-reference" | "color" | "color-none" | "compass" | "compose" | "confetti" | "connect" | "content" | "contract" | "corner-pill" | "corner-round" | "corner-square" | "credit-card" | "credit-card-cancel" | "credit-card-percent" | "credit-card-reader" | "credit-card-reader-chip" | "credit-card-reader-tap" | "credit-card-secure" | "credit-card-tap-chip" | "crop" | "currency-convert" | "cursor" | "cursor-banner" | "cursor-option" | "data-presentation" | "data-table" | "database" | "database-add" | "database-connect" | "delete" | "delivery" | "desktop" | "disabled" | "discount" | "discount-add" | "discount-code" | "dns-settings" | "dock-floating" | "dock-side" | "domain" | "domain-landing-page" | "domain-new" | "domain-redirect" | "download" | "drag-drop" | "drag-handle" | "duplicate" | "edit" | "email" | "email-follow-up" | "email-newsletter" | "enabled" | "enter" | "envelope" | "envelope-soft-pack" | "eraser" | "exchange" | "exit" | "export" | "external" | "eye-check-mark" | "eye-dropper" | "eye-dropper-list" | "eye-first" | "eyeglasses" | "favicon" | "file" | "file-list" | "filter" | "filter-active" | "flag" | "flip-horizontal" | "flip-vertical" | "flower" | "folder" | "folder-add" | "folder-down" | "folder-remove" | "folder-up" | "food" | "foreground" | "forklift" | "forms" | "games" | "gauge" | "gift-card" | "git-branch" | "git-commit" | "git-repository" | "globe" | "globe-asia" | "globe-europe" | "globe-lines" | "globe-list" | "grid" | "hashtag" | "hashtag-decimal" | "hashtag-list" | "heart" | "hide" | "hide-filled" | "home" | "icons" | "identity-card" | "image" | "image-add" | "image-alt" | "image-explore" | "image-magic" | "image-none" | "image-with-text-overlay" | "images" | "import" | "in-progress" | "incentive" | "incoming" | "incomplete" | "info" | "inheritance" | "inventory" | "inventory-updated" | "iq" | "key" | "keyboard" | "keyboard-filled" | "keyboard-hide" | "label-printer" | "language" | "language-translate" | "layout-block" | "layout-buy-button" | "layout-buy-button-horizontal" | "layout-buy-button-vertical" | "layout-column-1" | "layout-columns-2" | "layout-columns-3" | "layout-footer" | "layout-header" | "layout-logo-block" | "layout-popup" | "layout-rows-2" | "layout-section" | "layout-sidebar-left" | "layout-sidebar-right" | "lightbulb" | "link" | "link-list" | "list-bulleted" | "list-numbered" | "live" | "location" | "location-none" | "lock" | "map" | "markets" | "markets-euro" | "markets-rupee" | "markets-yen" | "maximize" | "measurement-size" | "measurement-size-list" | "measurement-volume" | "measurement-volume-list" | "measurement-weight" | "measurement-weight-list" | "media-receiver" | "megaphone" | "mention" | "menu" | "menu-horizontal" | "menu-vertical" | "merge" | "metafields" | "metaobject" | "metaobject-list" | "metaobject-reference" | "microphone" | "microphone-muted" | "minimize" | "minus" | "minus-circle" | "mobile" | "money" | "money-none" | "moon" | "nature" | "note" | "note-add" | "notification" | "number-one" | "order" | "order-batches" | "order-draft" | "order-first" | "order-fulfilled" | "order-repeat" | "order-unfulfilled" | "orders-status" | "organization" | "outdent" | "outgoing" | "package" | "package-fulfilled" | "package-on-hold" | "package-returned" | "page" | "page-add" | "page-attachment" | "page-clock" | "page-down" | "page-heart" | "page-list" | "page-reference" | "page-remove" | "page-report" | "page-up" | "pagination-end" | "pagination-start" | "paint-brush-flat" | "paint-brush-round" | "paper-check" | "passkey" | "paste" | "pause-circle" | "payment" | "payment-capture" | "payout" | "payout-dollar" | "payout-euro" | "payout-pound" | "payout-rupee" | "payout-yen" | "person" | "person-add" | "person-exit" | "person-list" | "person-lock" | "person-remove" | "person-segment" | "personalized-text" | "phone" | "phone-down" | "phone-down-filled" | "phone-in" | "phone-out" | "pin" | "pin-remove" | "plan" | "play" | "play-circle" | "plus" | "plus-circle" | "plus-circle-down" | "plus-circle-filled" | "plus-circle-up" | "point-of-sale" | "price-list" | "print" | "product" | "product-add" | "product-cost" | "product-list" | "product-reference" | "product-remove" | "product-return" | "product-unavailable" | "profile" | "profile-filled" | "question-circle" | "question-circle-filled" | "radio-control" | "receipt" | "receipt-dollar" | "receipt-euro" | "receipt-paid" | "receipt-pound" | "receipt-refund" | "receipt-rupee" | "receipt-yen" | "receivables" | "redo" | "referral-code" | "refresh" | "remove-background" | "replace" | "replay" | "reset" | "return" | "reward" | "rocket" | "rotate-left" | "rotate-right" | "sandbox" | "save" | "search" | "search-add" | "search-list" | "search-recent" | "search-resource" | "select" | "send" | "settings" | "share" | "shield-check-mark" | "shield-none" | "shield-pending" | "shield-person" | "shipping-label" | "shopcodes" | "slideshow" | "smiley-happy" | "smiley-joy" | "smiley-neutral" | "smiley-sad" | "social-ad" | "social-post" | "sort" | "sort-ascending" | "sort-descending" | "sound" | "split" | "sports" | "star" | "star-filled" | "star-list" | "status" | "status-active" | "stop-circle" | "store" | "store-import" | "store-managed" | "store-online" | "sun" | "table" | "table-masonry" | "tablet" | "target" | "tax" | "team" | "text" | "text-align-center" | "text-align-left" | "text-align-right" | "text-block" | "text-bold" | "text-color" | "text-font" | "text-font-list" | "text-grammar" | "text-in-columns" | "text-in-rows" | "text-indent" | "text-italic" | "text-quote" | "text-title" | "text-underline" | "text-with-image" | "theme" | "theme-cart" | "theme-edit" | "theme-store" | "theme-template" | "three-d-environment" | "thumbs-down" | "thumbs-up" | "tip-jar" | "toggle-off" | "toggle-on" | "transaction" | "transaction-fee-dollar" | "transaction-fee-euro" | "transaction-fee-pound" | "transaction-fee-rupee" | "transaction-fee-yen" | "transfer" | "transfer-in" | "transfer-internal" | "transfer-out" | "undo" | "unknown-device" | "unlock" | "upload" | "variant" | "variant-list" | "video" | "video-list" | "view" | "viewport-narrow" | "viewport-short" | "viewport-tall" | "viewport-wide" | "wallet" | "wand" | "watch" | "wifi" | "work" | "work-list" | "wrench" | "x" | "x-circle";
+type IconType = "adjust" | "affiliate" | "airplane" | "alert-bubble" | "alert-circle" | "alert-diamond" | "alert-location" | "alert-octagon" | "alert-octagon-filled" | "alert-triangle" | "align-horizontal-centers" | "app-extension" | "apps" | "archive" | "arrow-down" | "arrow-down-circle" | "arrow-left" | "arrow-left-circle" | "arrow-right" | "arrow-right-circle" | "arrow-up" | "arrow-up-circle" | "arrow-up-right" | "arrows-in-horizontal" | "arrows-out-horizontal" | "asterisk" | "attachment" | "automation" | "backspace" | "bag" | "bank" | "barcode" | "bill" | "blank" | "blog" | "bolt" | "bolt-filled" | "book" | "book-open" | "brain" | "bug" | "bullet" | "business-entity" | "button" | "button-press" | "calculator" | "calendar" | "calendar-check" | "calendar-compare" | "calendar-list" | "calendar-time" | "camera" | "camera-flip" | "caret-down" | "caret-left" | "caret-right" | "caret-up" | "cart" | "cart-abandoned" | "cart-discount" | "cart-down" | "cart-sale" | "cart-up" | "cash-dollar" | "cash-euro" | "cash-pound" | "cash-rupee" | "cash-yen" | "catalog-product" | "categories" | "channels" | "channels-filled" | "chart-cohort" | "chart-donut" | "chart-funnel" | "chart-histogram-first" | "chart-histogram-first-last" | "chart-histogram-flat" | "chart-histogram-full" | "chart-histogram-growth" | "chart-histogram-last" | "chart-histogram-second-last" | "chart-horizontal" | "chart-line" | "chart-popular" | "chart-stacked" | "chart-vertical" | "chat" | "chat-new" | "chat-referral" | "check" | "check-circle" | "check-circle-filled" | "checkbox" | "chevron-down" | "chevron-down-circle" | "chevron-left" | "chevron-left-circle" | "chevron-right" | "chevron-right-circle" | "chevron-up" | "chevron-up-circle" | "circle" | "circle-dashed" | "clipboard" | "clipboard-check" | "clipboard-checklist" | "clock" | "clock-list" | "clock-revert" | "code" | "code-add" | "collection" | "collection-featured" | "collection-list" | "collection-reference" | "color" | "color-none" | "compass" | "compose" | "confetti" | "connect" | "content" | "contract" | "corner-pill" | "corner-round" | "corner-square" | "credit-card" | "credit-card-cancel" | "credit-card-percent" | "credit-card-reader" | "credit-card-reader-chip" | "credit-card-reader-tap" | "credit-card-secure" | "credit-card-tap-chip" | "crop" | "currency-convert" | "cursor" | "cursor-banner" | "cursor-option" | "data-presentation" | "data-table" | "database" | "database-add" | "database-connect" | "delete" | "delivery" | "desktop" | "disabled" | "discount" | "discount-add" | "discount-code" | "dns-settings" | "dock-floating" | "dock-side" | "domain" | "domain-landing-page" | "domain-new" | "domain-redirect" | "download" | "drag-drop" | "drag-handle" | "duplicate" | "edit" | "email" | "email-follow-up" | "email-newsletter" | "enabled" | "enter" | "envelope" | "envelope-soft-pack" | "eraser" | "exchange" | "exit" | "export" | "external" | "eye-check-mark" | "eye-dropper" | "eye-dropper-list" | "eye-first" | "eyeglasses" | "favicon" | "file" | "file-list" | "filter" | "filter-active" | "flag" | "flip-horizontal" | "flip-vertical" | "flower" | "folder" | "folder-add" | "folder-down" | "folder-remove" | "folder-up" | "food" | "foreground" | "forklift" | "forms" | "games" | "gauge" | "gift-card" | "git-branch" | "git-commit" | "git-repository" | "globe" | "globe-asia" | "globe-europe" | "globe-lines" | "globe-list" | "grid" | "hashtag" | "hashtag-decimal" | "hashtag-list" | "heart" | "hide" | "hide-filled" | "home" | "icons" | "identity-card" | "image" | "image-add" | "image-alt" | "image-explore" | "image-magic" | "image-none" | "image-with-text-overlay" | "images" | "import" | "in-progress" | "incentive" | "incoming" | "incomplete" | "info" | "inheritance" | "inventory" | "inventory-updated" | "iq" | "key" | "keyboard" | "keyboard-filled" | "keyboard-hide" | "label-printer" | "language" | "language-translate" | "layer" | "layout-block" | "layout-buy-button" | "layout-buy-button-horizontal" | "layout-buy-button-vertical" | "layout-column-1" | "layout-columns-2" | "layout-columns-3" | "layout-footer" | "layout-header" | "layout-logo-block" | "layout-popup" | "layout-rows-2" | "layout-section" | "layout-sidebar-left" | "layout-sidebar-right" | "lightbulb" | "link" | "link-list" | "list-bulleted" | "list-numbered" | "live" | "location" | "location-none" | "lock" | "map" | "markets" | "markets-euro" | "markets-rupee" | "markets-yen" | "maximize" | "measurement-size" | "measurement-size-list" | "measurement-volume" | "measurement-volume-list" | "measurement-weight" | "measurement-weight-list" | "media-receiver" | "megaphone" | "mention" | "menu" | "menu-horizontal" | "menu-vertical" | "merge" | "metafields" | "metaobject" | "metaobject-list" | "metaobject-reference" | "microphone" | "microphone-muted" | "minimize" | "minus" | "minus-circle" | "mobile" | "money" | "money-none" | "moon" | "nature" | "note" | "note-add" | "notification" | "number-one" | "order" | "order-batches" | "order-draft" | "order-first" | "order-fulfilled" | "order-repeat" | "order-unfulfilled" | "orders-status" | "organization" | "outdent" | "outgoing" | "package" | "package-fulfilled" | "package-on-hold" | "package-returned" | "page" | "page-add" | "page-attachment" | "page-clock" | "page-down" | "page-heart" | "page-list" | "page-reference" | "page-remove" | "page-report" | "page-up" | "pagination-end" | "pagination-start" | "paint-brush-flat" | "paint-brush-round" | "paper-check" | "passkey" | "paste" | "pause-circle" | "payment" | "payment-capture" | "payout" | "payout-dollar" | "payout-euro" | "payout-pound" | "payout-rupee" | "payout-yen" | "person" | "person-add" | "person-exit" | "person-list" | "person-lock" | "person-remove" | "person-segment" | "personalized-text" | "phone" | "phone-down" | "phone-down-filled" | "phone-in" | "phone-out" | "pin" | "pin-remove" | "plan" | "play" | "play-circle" | "plus" | "plus-circle" | "plus-circle-down" | "plus-circle-filled" | "plus-circle-up" | "point-of-sale" | "price-list" | "print" | "product" | "product-add" | "product-cost" | "product-list" | "product-reference" | "product-remove" | "product-return" | "product-unavailable" | "profile" | "profile-filled" | "question-circle" | "question-circle-filled" | "radio-control" | "receipt" | "receipt-dollar" | "receipt-euro" | "receipt-paid" | "receipt-pound" | "receipt-refund" | "receipt-rupee" | "receipt-yen" | "receivables" | "redo" | "referral-code" | "refresh" | "remove-background" | "replace" | "replay" | "reset" | "return" | "reward" | "rocket" | "rotate-left" | "rotate-right" | "sandbox" | "save" | "search" | "search-add" | "search-list" | "search-recent" | "search-resource" | "select" | "send" | "settings" | "share" | "shield-check-mark" | "shield-none" | "shield-pending" | "shield-person" | "shipping-label" | "shopcodes" | "slideshow" | "smiley-happy" | "smiley-joy" | "smiley-neutral" | "smiley-sad" | "social-ad" | "social-post" | "sort" | "sort-ascending" | "sort-descending" | "sound" | "split" | "sports" | "star" | "star-filled" | "star-list" | "status" | "status-active" | "stop-circle" | "store" | "store-import" | "store-managed" | "store-online" | "sun" | "table" | "table-masonry" | "tablet" | "target" | "tax" | "team" | "text" | "text-align-center" | "text-align-left" | "text-align-right" | "text-block" | "text-bold" | "text-color" | "text-font" | "text-font-list" | "text-grammar" | "text-in-columns" | "text-in-rows" | "text-indent" | "text-italic" | "text-quote" | "text-title" | "text-underline" | "text-with-image" | "theme" | "theme-cart" | "theme-edit" | "theme-store" | "theme-template" | "three-d-environment" | "thumbs-down" | "thumbs-up" | "tip-jar" | "toggle-off" | "toggle-on" | "transaction" | "transaction-fee-dollar" | "transaction-fee-euro" | "transaction-fee-pound" | "transaction-fee-rupee" | "transaction-fee-yen" | "transfer" | "transfer-in" | "transfer-internal" | "transfer-out" | "undo" | "unknown-device" | "unlock" | "upload" | "variant" | "variant-list" | "video" | "video-list" | "view" | "viewport-narrow" | "viewport-short" | "viewport-tall" | "viewport-wide" | "wallet" | "wand" | "watch" | "wifi" | "work" | "work-list" | "wrench" | "x" | "x-circle";
 
 interface IconProps extends Required<Pick<IconProps$1, 'type' | 'tone' | 'color' | 'size' | 'interestFor'>> {
     /**
@@ -3567,6 +3695,7 @@ interface PreactCheckboxProps extends Required<Pick<CheckboxProps$1, 'accessibil
     value: Required<CheckboxProps$1>['value'];
 }
 declare class PreactCheckboxElement extends PreactInputElement implements PreactCheckboxProps {
+    onblur: CallbackEventListener<'input'>;
     get checked(): boolean;
     set checked(checked: PreactCheckboxProps['checked']);
     /**
@@ -3589,18 +3718,25 @@ declare class PreactCheckboxElement extends PreactInputElement implements Preact
 interface CheckboxProps extends PreactCheckboxProps {
     indeterminate: Required<CheckboxProps$1>['indeterminate'];
     defaultIndeterminate: Required<CheckboxProps$1>['defaultIndeterminate'];
+    labelAccessibilityVisibility: Required<CheckboxProps$1>['labelAccessibilityVisibility'];
 }
 
 declare const tagName$Q = "s-checkbox";
-interface ReactProps$Q extends Partial<CheckboxProps>, Pick<CheckboxProps$1, 'id'> {
+interface ReactProps$Q extends Partial<Omit<CheckboxProps, 'error' | 'details'>>, Pick<CheckboxProps$1, 'id'>, FieldSlotInternalReactProps {
     onChange?: ((event: CallbackEvent<typeof tagName$Q>) => void) | null;
     onInput?: ((event: CallbackEvent<typeof tagName$Q>) => void) | null;
+    onBlur?: ((event: CallbackEvent<typeof tagName$Q>) => void) | null;
 }
 
-declare class Checkbox extends PreactCheckboxElement implements CheckboxProps {
+declare abstract class CheckboxBase extends PreactCheckboxElement implements Pick<CheckboxProps, 'defaultIndeterminate' | 'indeterminate' | 'labelAccessibilityVisibility'> {
     get indeterminate(): CheckboxProps["indeterminate"];
     set indeterminate(indeterminate: CheckboxProps['indeterminate']);
     defaultIndeterminate: CheckboxProps['defaultIndeterminate'];
+    labelAccessibilityVisibility: CheckboxProps['labelAccessibilityVisibility'];
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class Checkbox extends CheckboxBase implements CheckboxProps {
     constructor();
 }
 declare global {
@@ -3611,12 +3747,12 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$Q]: ReactProps$Q & PreactBaseElementProps<Checkbox>;
+            [tagName$Q]: Omit<ReactProps$Q, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<Checkbox>;
         }
     }
 }
 
-interface ChipProps extends Required<Pick<ChipProps$1, 'color' | 'accessibilityLabel'>> {
+interface ChipProps extends Required<Pick<ChipProps$1, 'color' | 'accessibilityLabel' | 'removable'>> {
 }
 
 declare const tagName$P = "s-chip";
@@ -3631,12 +3767,15 @@ interface ReactProps$P extends Partial<ChipProps>, Pick<ChipProps$1, 'id' | 'chi
      * Only accepts `Icon` components.
      */
     graphic?: ComponentChildren$1;
+    onRemove?: ((event: CallbackEvent<typeof tagName$P>) => void) | null;
 }
 
 declare class Chip extends PolarisCustomElement implements ChipProps {
     color: ChipProps['color'];
     accessibilityLabel: ChipProps['accessibilityLabel'];
-    constructor();
+    removable: ChipProps['removable'];
+    onremove: CallbackEventListener<typeof tagName$P> | null;
+    constructor(renderImpl?: Omit<RenderImpl, 'globalShadowCSS'>);
 }
 declare global {
     interface HTMLElementTagNameMap {
@@ -3723,13 +3862,26 @@ interface ReactProps$N extends Partial<ChoiceListProps>, Pick<ChoiceListProps$1,
 }
 
 declare const internals$3: unique symbol;
-declare class BaseClass$2 extends PolarisCustomElement {
+declare class BaseClass$1 extends PolarisCustomElement {
     static formAssociated: boolean;
     constructor(renderImpl: RenderImpl);
     /** @private */
     [internals$3]: ElementInternals;
 }
-declare class ChoiceList extends BaseClass$2 implements ChoiceListProps {
+declare class ChoiceList extends BaseClass$1 implements ChoiceListProps {
+    /**
+     * Wraps change and input event listeners so they only fire when the event
+     * was dispatched directly on this ChoiceList (event.eventPhase === Event.AT_TARGET).
+     *
+     * This prevents form events from elements inside secondary content (e.g.
+     * TextField, native <input>) from being mistakenly treated as ChoiceList
+     * value-change events, while still allowing those events to bubble normally
+     * through the DOM (preserving React's event delegation).
+     * @private
+     */
+    addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
+    /** @private */
+    removeEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void;
     disabled: ChoiceListProps['disabled'];
     name: ChoiceListProps['name'];
     error: ChoiceListProps['error'];
@@ -3823,17 +3975,19 @@ interface ReactProps$L extends Partial<ClickableChipProps>, Pick<ClickableChipPr
     onAfterHide?: ((event: CallbackEvent<typeof tagName$L>) => void) | null;
 }
 
-declare const ClickableChip_base: (abstract new (renderImpl: Omit<RenderImpl, "globalShadowCSS">) => PolarisCustomElement & PreactOverlayControlProps) & Pick<typeof PolarisCustomElement, "prototype" | "observedAttributes">;
-declare class ClickableChip extends ClickableChip_base implements ClickableChipProps {
-    color: ClickableChipProps['color'];
+declare const ClickableChipBase_base: (abstract new (renderImpl: Omit<RenderImpl, "globalShadowCSS">) => PolarisCustomElement & PreactOverlayControlProps) & Pick<typeof PolarisCustomElement, "prototype" | "observedAttributes">;
+declare abstract class ClickableChipBase<TTagName extends keyof HTMLElementTagNameMap> extends ClickableChipBase_base implements Pick<ClickableChipProps, 'accessibilityLabel' | 'removable' | 'hidden' | 'disabled' | 'href'> {
     accessibilityLabel: ClickableChipProps['accessibilityLabel'];
     removable: ClickableChipProps['removable'];
     hidden: ClickableChipProps['hidden'];
     disabled: ClickableChipProps['disabled'];
     href: ClickableChipProps['href'];
-    onclick: CallbackEventListener<typeof tagName$L> | null;
-    onremove: CallbackEventListener<typeof tagName$L> | null;
-    onafterhide: CallbackEventListener<typeof tagName$L> | null;
+    abstract color: string;
+    constructor(renderImpl: Omit<RenderImpl, 'globalShadowCSS'>);
+}
+
+declare class ClickableChip extends ClickableChipBase<typeof tagName$L> implements ClickableChipProps {
+    color: ClickableChipProps['color'];
     constructor();
 }
 declare global {
@@ -3912,21 +4066,25 @@ declare class PreactFieldElement<Autocomplete extends string = string> extends P
 type ColorFieldProps = PreactFieldProps<Required<ColorFieldProps$1>['autocomplete']> & Required<Pick<ColorFieldProps$1, 'alpha' | 'value' | 'defaultValue'>>;
 
 declare const tagName$K = "s-color-field";
-interface ReactProps$K extends Partial<Omit<ColorFieldProps, 'accessory'>>, Pick<ColorFieldProps$1, 'id' | 'alpha' | 'value' | 'defaultValue'>, FieldReactProps<typeof tagName$K> {
+interface ReactProps$K extends Partial<Omit<ColorFieldProps, 'accessory' | 'error' | 'details'>>, Pick<ColorFieldProps$1, 'id' | 'alpha' | 'value' | 'defaultValue'>, FieldReactProps<typeof tagName$K>, FieldSlotInternalReactProps {
     onInput?: (event: CallbackEvent<typeof tagName$K>) => void;
     onChange?: (event: CallbackEvent<typeof tagName$K>) => void;
 }
 
-declare class ColorField extends PreactFieldElement<ColorFieldProps['autocomplete']> implements ColorFieldProps {
+declare abstract class ColorFieldBase extends PreactFieldElement<ColorFieldProps['autocomplete']> implements Pick<ColorFieldProps, 'alpha' | 'value'> {
     alpha: ColorFieldProps['alpha'];
     get value(): string;
     set value(value: string);
     /** @private */
     formResetCallback(): void;
-    constructor();
+    constructor(renderImpl: RenderImpl);
     /** @private */
     setInternalValue(value: string, normalize: boolean): void;
 }
+
+declare class ColorField extends ColorFieldBase implements ColorFieldProps {
+    constructor();
+}
 declare global {
     interface HTMLElementTagNameMap {
         [tagName$K]: ColorField;
@@ -3935,7 +4093,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$K]: ReactProps$K & PreactBaseElementProps<ColorField>;
+            [tagName$K]: Omit<ReactProps$K, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<ColorField>;
         }
     }
 }
@@ -3950,13 +4108,13 @@ interface ReactProps$J extends Partial<ColorPickerProps>, Pick<ColorPickerProps$
 }
 
 declare const internals$2: unique symbol;
-declare class BaseClass$1 extends PolarisCustomElement {
+declare class BaseClass extends PolarisCustomElement {
     static formAssociated: boolean;
     constructor(renderImpl: RenderImpl);
     /** @private */
     [internals$2]: ElementInternals;
 }
-declare class ColorPicker extends BaseClass$1 implements ColorPickerProps {
+declare class ColorPicker extends BaseClass implements ColorPickerProps {
     alpha: boolean;
     onchange: CallbackEventListener<typeof tagName$J> | null;
     oninput: CallbackEventListener<typeof tagName$J> | null;
@@ -3984,7 +4142,7 @@ interface DateFieldProps extends PreactFieldProps<DateAutocompleteField>, Requir
 }
 
 declare const tagName$I = "s-date-field";
-interface ReactProps$I extends Partial<DateFieldProps>, Pick<DateFieldProps$1, 'id'> {
+interface ReactProps$I extends Partial<Omit<DateFieldProps, 'error' | 'details'>>, Pick<DateFieldProps$1, 'id'>, FieldSlotInternalReactProps {
     onBlur?: ((event: CallbackEvent<typeof tagName$I>) => void) | null;
     onChange?: ((event: CallbackEvent<typeof tagName$I>) => void) | null;
     onFocus?: ((event: CallbackEvent<typeof tagName$I>) => void) | null;
@@ -3993,7 +4151,7 @@ interface ReactProps$I extends Partial<DateFieldProps>, Pick<DateFieldProps$1, '
     onViewChange?: ((event: CallbackEvent<typeof tagName$I>) => void) | null;
 }
 
-declare class DateField extends PreactFieldElement<DateFieldProps['autocomplete']> implements DateFieldProps {
+declare abstract class DateFieldBase extends PreactFieldElement<DateFieldProps['autocomplete']> implements Pick<DateFieldProps, 'allow' | 'disallow' | 'allowDays' | 'disallowDays' | 'view' | 'defaultView'> {
     allow: DateFieldProps['allow'];
     disallow: DateFieldProps['disallow'];
     allowDays: DateFieldProps['allowDays'];
@@ -4001,8 +4159,10 @@ declare class DateField extends PreactFieldElement<DateFieldProps['autocomplete'
     set view(view: string);
     get view(): string;
     defaultView: DateFieldProps['defaultView'];
-    onviewchange: CallbackEventListener<typeof tagName$I> | null;
-    oninvalid: CallbackEventListener<typeof tagName$I> | null;
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class DateField extends DateFieldBase implements DateFieldProps {
     constructor();
 }
 declare global {
@@ -4013,7 +4173,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$I]: ReactProps$I & PreactBaseElementProps<DateField>;
+            [tagName$I]: Omit<ReactProps$I, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<DateField>;
         }
     }
 }
@@ -4033,13 +4193,11 @@ interface ReactProps$H extends Partial<DatePickerProps>, Pick<DatePickerProps$1,
 
 declare const internals$1: unique symbol;
 declare const dirtyStateSymbol: unique symbol;
-declare class BaseClass extends PolarisCustomElement {
+declare abstract class DatePickerBase<TagName extends 's-date-picker' | 's-internal-date-picker'> extends PolarisCustomElement implements DatePickerProps {
     static formAssociated: boolean;
     constructor(renderImpl: RenderImpl);
     /** @private */
     [internals$1]: ElementInternals;
-}
-declare class DatePicker extends BaseClass implements DatePickerProps {
     defaultView: string;
     set view(view: string);
     get view(): string;
@@ -4056,11 +4214,9 @@ declare class DatePicker extends BaseClass implements DatePickerProps {
     [dirtyStateSymbol]: boolean;
     /** @private */
     formResetCallback(): void;
-    onviewchange: CallbackEventListener<typeof tagName$H> | null;
-    onfocus: CallbackEventListener<typeof tagName$H> | null;
-    onblur: CallbackEventListener<typeof tagName$H> | null;
-    oninput: CallbackEventListener<typeof tagName$H> | null;
-    onchange: CallbackEventListener<typeof tagName$H> | null;
+}
+
+declare class DatePicker extends DatePickerBase<typeof tagName$H> implements DatePickerProps {
     constructor();
 }
 declare global {
@@ -4109,11 +4265,27 @@ interface DropZoneProps extends Required<Pick<DropZoneProps$1, 'accept' | 'acces
 declare const tagName$F = "s-drop-zone";
 interface ReactProps$F extends Partial<DropZoneProps>, Pick<DropZoneProps$1, 'id'> {
     /**
-     * Content to include inside the DropZone container
+     * Content to display inside the drop zone, such as upload instructions, file type icons,
+     * or previews of selected files. When provided, replaces the default upload prompt.
      */
     children?: ComponentChildren$1;
+    /**
+     * A callback fired when the user selects files through the file picker or drops valid
+     * files onto the drop zone. Access the selected files through `event.currentTarget.files`.
+     * Use to process uploads, generate previews, or validate file contents.
+     */
     onChange?: ((event: CallbackEvent<typeof tagName$F>) => void) | null;
+    /**
+     * A callback fired when files are selected or dropped. Similar to `onChange` but may
+     * fire more frequently during drag operations. Use when you need immediate feedback as
+     * files are being dragged over the drop zone.
+     */
     onInput?: ((event: CallbackEvent<typeof tagName$F>) => void) | null;
+    /**
+     * A callback fired when dropped or selected files don't match the `accept` criteria.
+     * Use to display error messages explaining which file types are allowed. Rejected files
+     * are not added to the `files` array.
+     */
     onDropRejected?: ((event: CallbackEvent<typeof tagName$F>) => void) | null;
 }
 
@@ -4169,13 +4341,17 @@ declare module 'preact' {
 type EmailFieldProps = PreactFieldProps<Required<EmailFieldProps$1>['autocomplete']> & Required<Pick<EmailFieldProps$1, 'maxLength' | 'minLength'>>;
 
 declare const tagName$E = "s-email-field";
-interface ReactProps$E extends Partial<Omit<EmailFieldProps, 'accessory'>>, Pick<EmailFieldProps$1, 'id'>, FieldReactProps<typeof tagName$E> {
+interface ReactProps$E extends Partial<Omit<EmailFieldProps, 'accessory' | 'error' | 'details'>>, Pick<EmailFieldProps$1, 'id'>, FieldReactProps<typeof tagName$E>, FieldSlotInternalReactProps {
 }
 
-declare class EmailField extends PreactFieldElement<EmailFieldProps['autocomplete']> implements EmailFieldProps {
+declare abstract class EmailFieldBase extends PreactFieldElement<EmailFieldProps['autocomplete']> implements Pick<EmailFieldProps, 'autocomplete' | 'maxLength' | 'minLength'> {
     autocomplete: EmailFieldProps['autocomplete'];
     maxLength: EmailFieldProps['maxLength'];
     minLength: EmailFieldProps['minLength'];
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class EmailField extends EmailFieldBase implements EmailFieldProps {
     constructor();
 }
 declare global {
@@ -4186,7 +4362,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$E]: ReactProps$E & PreactBaseElementProps<EmailField>;
+            [tagName$E]: Omit<ReactProps$E, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<EmailField>;
         }
     }
 }
@@ -4613,29 +4789,52 @@ interface ModalProps extends Pick<RequiredAlignedModalProps, 'accessibilityLabel
      * Adjust the size of the Modal.
      */
     size: Extract<ModalProps$1['size'], 'small-100' | 'small' | 'base' | 'large' | 'large-100'>;
+    /**
+     * Places the Modal on the block axis on a large screen
+     * @default 'center'
+     */
+    alignSelf: 'center' | 'start';
 }
 
 declare const tagName$v = "s-modal";
 interface ReactProps$v extends Partial<ModalProps>, Pick<ModalProps$1, 'id' | 'children'> {
     /**
-     * The content of the Modal.
+     * The content displayed within the modal, typically including form fields, informational
+     * text, or interactive elements that require focused user attention.
      */
     children?: ComponentChildren$1;
     /**
-     * The primary action to perform.
-     *
-     * Only a `Button` with a variant of `primary` is allowed.
+     * The main action button displayed in the modal footer, representing the primary action
+     * users should take. Only accepts a button component with a `variant` of `primary`. This action
+     * should align with the modal's main purpose, such as "Save", "Confirm", or "Submit".
      */
     primaryAction?: ComponentChildren$1;
     /**
-     * The secondary actions to perform.
-     *
-     * Only `Button` elements with a variant of `secondary` or `auto` are allowed.
+     * Additional action buttons displayed in the modal footer, providing alternative or
+     * supporting actions such as "Cancel" or "Learn more". Only accepts button components
+     * with a `variant` of `secondary` or `auto`. These are visually de-emphasized compared
+     * to the primary action to establish clear hierarchy.
      */
     secondaryActions?: ComponentChildren$1;
+    /**
+     * A callback fired when the modal closes.
+     * Use to perform cleanup or trigger side effects when the modal is dismissed.
+     */
     onHide?: ((event: CallbackEvent<typeof tagName$v>) => void) | null;
+    /**
+     * A callback fired when the modal starts to open, before any entrance animation begins.
+     * Use to prepare content or fetch data needed for the modal.
+     */
     onShow?: ((event: CallbackEvent<typeof tagName$v>) => void) | null;
+    /**
+     * A callback fired after the modal has fully closed and any exit animation completes.
+     * Use to reset form state, clear temporary data, or update the page after dismissal.
+     */
     onAfterHide?: ((event: CallbackEvent<typeof tagName$v>) => void) | null;
+    /**
+     * A callback fired after the modal has fully opened and any entrance animation completes.
+     * Use to focus an input field or initialize content once the modal is visible.
+     */
     onAfterShow?: ((event: CallbackEvent<typeof tagName$v>) => void) | null;
 }
 
@@ -4650,16 +4849,20 @@ declare const focusedElement: unique symbol;
 declare const rootActivator: unique symbol;
 declare const onEscape: unique symbol;
 declare const nestedModals: unique symbol;
+declare const onKeyUp: unique symbol;
 declare const onBackdropClick: unique symbol;
 declare const abortController: unique symbol;
 declare const onChildModalChange: unique symbol;
 declare const childrenRerenderObserver: unique symbol;
 declare const shadowDomRerenderObserver: unique symbol;
+declare const focusTrapHandler: unique symbol;
+declare const ensureDialogRef: unique symbol;
 declare abstract class ModalBase<TTagName extends keyof HTMLElementTagNameMap> extends PreactOverlayElement implements Pick<ModalProps, 'accessibilityLabel' | 'heading' | 'padding' | 'size'> {
     accessibilityLabel: ModalProps['accessibilityLabel'];
     heading: ModalProps['heading'];
     padding: ModalProps['padding'];
     size: ModalProps['size'];
+    alignSelf: ModalProps['alignSelf'];
     /** @private */
     [abortController]: AbortController;
     /** @private */
@@ -4674,12 +4877,45 @@ declare abstract class ModalBase<TTagName extends keyof HTMLElementTagNameMap> e
     [childrenRerenderObserver]: MutationObserver;
     /** @private */
     [shadowDomRerenderObserver]: MutationObserver;
+    /**
+     * Focus trap keydown handler reference, stored for cleanup.
+     *
+     * The focus trap is managed imperatively here in ModalBase rather than
+     * via a Preact useEffect in foundation.tsx. This is because aftershow
+     * (fired after CSS animations complete) and useEffect (fired after
+     * Preact's async effect scheduling) are independent async chains with
+     * no synchronization — the useEffect could run before or after
+     * aftershow, making tests non-deterministic.
+     *
+     * By attaching the focus trap in the same .then() chain as aftershow,
+     * we guarantee it is active before aftershow dispatches.
+     *
+     * Lifecycle (mirrors the old useEffect's isActiveModal dependency):
+     * - Attached: in aftershow chain, right before aftershow dispatches
+     * - Detached: on dismiss(), disconnectedCallback(), or child modal open
+     * - Re-attached: when all child modals close
+     * @private
+     */
+    [focusTrapHandler]: ((event: KeyboardEvent) => void) | null;
     /** @private */
     [onEscape]: (event: KeyboardEvent) => void;
     /** @private */
+    [onKeyUp]: (event: KeyboardEvent) => void;
+    /** @private */
     [onBackdropClick]: (event: MouseEvent) => void;
     /** @private */
     [onChildModalChange]: EventListenerOrEventListenerObject;
+    /**
+     * Ensures `this[dialog]` is set by synchronously querying the shadow DOM
+     * and attaching event listeners if needed.
+     * Works around a Safari timing issue where the MutationObserver callback
+     * (which normally sets `this[dialog]`) may not have fired yet when
+     * `show()` / `dismiss()` run — especially when `heading` or
+     * `accessibilityLabel` adds child custom-elements whose own lifecycle
+     * microtasks can delay the observer.
+     * @private
+     */
+    [ensureDialogRef](): void;
     /** @private */
     get [isOpen](): boolean;
     /** @private */
@@ -4691,7 +4927,9 @@ declare abstract class ModalBase<TTagName extends keyof HTMLElementTagNameMap> e
     /** @private */
     [hide](): Promise<void>;
     showOverlay(): void;
-    hideOverlay(): void;
+    hideOverlay({ force }?: {
+        force?: boolean;
+    }): void;
     toggleOverlay(): void;
     /** @private */
     connectedCallback(): void;
@@ -4722,15 +4960,19 @@ interface MoneyFieldProps extends Omit<PreactFieldProps, 'value'>, Pick<Required
 }
 
 declare const tagName$u = "s-money-field";
-interface ReactProps$u extends Partial<MoneyFieldProps>, FieldReactProps<typeof tagName$u>, Pick<MoneyFieldProps$1, 'id'> {
+interface ReactProps$u extends Partial<Omit<MoneyFieldProps, 'error' | 'details'>>, FieldReactProps<typeof tagName$u>, Pick<MoneyFieldProps$1, 'id'>, FieldSlotInternalReactProps {
 }
 
-declare class MoneyField extends PreactFieldElement<MoneyFieldProps['autocomplete']> implements MoneyFieldProps {
+declare abstract class MoneyFieldBase extends PreactFieldElement<MoneyFieldProps['autocomplete']> implements Pick<MoneyFieldProps, 'max' | 'min' | 'currencyCode' | 'value'> {
     max: MoneyFieldProps['max'];
     min: MoneyFieldProps['min'];
     currencyCode: MoneyFieldProps['currencyCode'];
     get value(): string;
     set value(value: string);
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class MoneyField extends MoneyFieldBase implements MoneyFieldProps {
     constructor();
 }
 declare global {
@@ -4741,7 +4983,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$u]: ReactProps$u & PreactBaseElementProps<MoneyField>;
+            [tagName$u]: Omit<ReactProps$u, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<MoneyField>;
         }
     }
 }
@@ -4751,10 +4993,10 @@ interface NumberFieldProps extends Omit<PreactFieldProps<Required<NumberFieldPro
 }
 
 declare const tagName$t = "s-number-field";
-interface ReactProps$t extends Partial<NumberFieldProps>, Pick<NumberFieldProps$1, 'id'>, FieldReactProps<typeof tagName$t> {
+interface ReactProps$t extends Partial<Omit<NumberFieldProps, 'error' | 'details'>>, Pick<NumberFieldProps$1, 'id'>, FieldReactProps<typeof tagName$t>, FieldSlotInternalReactProps {
 }
 
-declare class NumberField extends PreactFieldElement<NumberFieldProps['autocomplete']> implements NumberFieldProps {
+declare abstract class NumberFieldBase extends PreactFieldElement<NumberFieldProps['autocomplete']> implements Pick<NumberFieldProps, 'inputMode' | 'step' | 'max' | 'min' | 'prefix' | 'suffix' | 'value'> {
     get value(): string;
     set value(value: string);
     inputMode: NumberFieldProps['inputMode'];
@@ -4763,6 +5005,10 @@ declare class NumberField extends PreactFieldElement<NumberFieldProps['autocompl
     min: NumberFieldProps['min'];
     prefix: NumberFieldProps['prefix'];
     suffix: NumberFieldProps['suffix'];
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class NumberField extends NumberFieldBase implements NumberFieldProps {
     constructor();
 }
 declare global {
@@ -4773,7 +5019,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$t]: ReactProps$t & PreactBaseElementProps<NumberField>;
+            [tagName$t]: Omit<ReactProps$t, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<NumberField>;
         }
     }
 }
@@ -4876,32 +5122,32 @@ interface PageProps extends Required<Pick<PageProps$1, 'inlineSize' | 'heading'>
 declare const tagName$p = "s-page";
 interface ReactProps$p extends Partial<PageProps>, Pick<PageProps$1, 'id' | 'children'> {
     /**
-     * The content of the Page.
+     * The main content of the page, typically containing the primary information, forms,
+     * or interactive elements that fulfill the page's purpose.
      */
     children?: ComponentChildren$1;
     /**
-     * The content to display in the aside section of the page.
-     *
-     * This slot is only rendered when `inlineSize` is "base".
+     * Supplementary content displayed in a sidebar alongside the main content. Use for
+     * related information, navigation aids, or contextual actions that support the main content.
+     * This slot is only rendered when `inlineSize` is set to `base`.
      */
     aside?: ComponentChildren$1;
     /**
-     * The primary action for the page.
-     *
-     * Only accepts a single `Button` component with a `variant` of `primary`.
-     *
+     * The main action button displayed in the page header, representing the primary action
+     * users can take on this page. Only accepts a single button component with a `variant` of `primary`.
+     * Common examples include "Create", "Save", or "Add".
      */
     primaryAction?: ComponentChildren$1;
     /**
-     * Secondary actions for the page.
-     *
-     * Only accepts `ButtonGroup` and `Button` components with a `variant` of `secondary` or `auto`.
+     * Additional action buttons displayed in the page header, providing alternative or supporting
+     * actions. Only accepts button group and button components with a `variant` of `secondary`
+     * or `auto`. These are visually de-emphasized compared to the primary action.
      */
     secondaryActions?: ComponentChildren$1;
     /**
-     * Navigations back actions for the page.
-     *
-     * Only accepts `Link` components.
+     * Navigation links that help users understand their location within the app and navigate
+     * back to parent pages. Only accepts link components. Typically displays as a back arrow
+     * or breadcrumb trail in the page header.
      */
     breadcrumbActions?: ComponentChildren$1;
 }
@@ -4975,12 +5221,16 @@ declare module 'preact' {
 type PasswordFieldProps = PreactFieldProps<Required<PasswordFieldProps$1>['autocomplete']> & Required<Pick<PasswordFieldProps$1, 'defaultValue' | 'details' | 'disabled' | 'error' | 'labelAccessibilityVisibility' | 'minLength' | 'maxLength' | 'label' | 'name' | 'placeholder' | 'readOnly' | 'required' | 'value'>>;
 
 declare const tagName$n = "s-password-field";
-interface ReactProps$n extends Partial<PasswordFieldProps>, Pick<PasswordFieldProps$1, 'id'>, FieldReactProps<typeof tagName$n> {
+interface ReactProps$n extends Partial<Omit<PasswordFieldProps, 'error' | 'details'>>, Pick<PasswordFieldProps$1, 'id'>, FieldReactProps<typeof tagName$n>, FieldSlotInternalReactProps {
 }
 
-declare class PasswordField extends PreactFieldElement<PasswordFieldProps['autocomplete']> implements PasswordFieldProps {
+declare abstract class PasswordFieldBase extends PreactFieldElement<PasswordFieldProps['autocomplete']> implements Pick<PasswordFieldProps, 'maxLength' | 'minLength'> {
     maxLength: PasswordFieldProps['maxLength'];
     minLength: PasswordFieldProps['minLength'];
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class PasswordField extends PasswordFieldBase implements PasswordFieldProps {
     constructor();
 }
 declare global {
@@ -4991,7 +5241,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$n]: ReactProps$n & PreactBaseElementProps<PasswordField>;
+            [tagName$n]: Omit<ReactProps$n, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<PasswordField>;
         }
     }
 }
@@ -5002,14 +5252,39 @@ interface PopoverProps extends Required<Pick<PopoverProps$1, 'blockSize' | 'inli
 declare const tagName$m = "s-popover";
 interface ReactProps$m extends Partial<PopoverProps>, Pick<PopoverProps$1, 'id' | 'children'> {
     /**
-     * The content of the Popover.
+     * The content displayed within the popover, which appears in an overlay positioned relative
+     * to its trigger element. Typically contains menus, action lists, or supplementary information.
      */
     children?: ComponentChildren$1;
+    /**
+     * A callback fired immediately when the popover starts to hide, before any exit animation.
+     * Use to perform cleanup or save state before the popover dismisses.
+     */
     onHide?: (event: CallbackEvent<typeof tagName$m>) => void | null;
+    /**
+     * A callback fired immediately when the popover starts to show, before any entrance animation.
+     * Use to prepare content or update positioning logic.
+     */
     onShow?: (event: CallbackEvent<typeof tagName$m>) => void | null;
+    /**
+     * A callback fired after the popover has fully hidden and any exit animation completes.
+     * Use to reset selections or update the trigger button state.
+     */
     onAfterHide?: (event: CallbackEvent<typeof tagName$m>) => void | null;
+    /**
+     * A callback fired after the popover has fully shown and any entrance animation completes.
+     * Use to focus an element inside the popover or announce content to screen readers.
+     */
     onAfterShow?: (event: CallbackEvent<typeof tagName$m>) => void | null;
+    /**
+     * A callback fired when the popover visibility toggles. Use for unified open/close
+     * handling when you don't need separate show and hide logic.
+     */
     onToggle?: (event: CallbackToggleEvent<typeof tagName$m>) => void | null;
+    /**
+     * A callback fired after the popover visibility toggle completes and any animation finishes.
+     * Use for post-transition updates.
+     */
     onAfterToggle?: (event: CallbackToggleEvent<typeof tagName$m>) => void | null;
 }
 
@@ -5233,7 +5508,7 @@ type SearchFieldProps = PreactFieldProps<
 Required<TextFieldProps$1>['autocomplete']> & Required<Pick<TextFieldProps$1, 'defaultValue' | 'details' | 'disabled' | 'error' | 'labelAccessibilityVisibility' | 'minLength' | 'maxLength' | 'label' | 'name' | 'placeholder' | 'readOnly' | 'required' | 'value'>>;
 
 declare const tagName$i = "s-search-field";
-interface ReactProps$i extends Partial<SearchFieldProps>, Pick<TextFieldProps$1, 'id'>, FieldReactProps<typeof tagName$i> {
+interface ReactProps$i extends Partial<Omit<SearchFieldProps, 'error' | 'details'>>, Pick<TextFieldProps$1, 'id'>, FieldReactProps<typeof tagName$i>, FieldSlotInternalReactProps {
 }
 
 declare abstract class SearchFieldBase extends PreactFieldElement<SearchFieldProps['autocomplete']> implements Pick<SearchFieldProps, 'maxLength' | 'minLength'> {
@@ -5253,7 +5528,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$i]: ReactProps$i & PreactBaseElementProps<SearchField>;
+            [tagName$i]: Omit<ReactProps$i, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<SearchField>;
         }
     }
 }
@@ -5306,7 +5581,7 @@ interface SelectProps extends Omit<PreactInputProps, 'value'>, Required<Pick<Sel
 }
 
 declare const tagName$g = "s-select";
-interface ReactProps$g extends Partial<SelectProps>, Pick<SelectProps$1, 'id' | 'children'> {
+interface ReactProps$g extends Partial<Omit<SelectProps, 'error' | 'details'>>, Pick<SelectProps$1, 'id' | 'children'>, FieldSlotInternalReactProps {
     /**
      * The options a user can select from.
      *
@@ -5363,7 +5638,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$g]: ReactProps$g & PreactBaseElementPropsWithChildren<Select>;
+            [tagName$g]: Omit<ReactProps$g, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementPropsWithChildren<Select>;
         }
     }
 }
@@ -5502,6 +5777,7 @@ declare const tagName$d = "s-switch";
 interface ReactProps$d extends Partial<SwitchProps>, Pick<SwitchProps$1, 'id'> {
     onChange?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
     onInput?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
+    onBlur?: ((event: CallbackEvent<typeof tagName$d>) => void) | null;
 }
 
 declare abstract class SwitchBase extends PreactCheckboxElement implements Pick<SwitchProps, 'labelAccessibilityVisibility'> {
@@ -5789,13 +6065,17 @@ declare module 'preact' {
 type TextAreaProps = PreactFieldProps<Required<TextAreaProps$1>['autocomplete']> & Required<Pick<TextAreaProps$1, 'maxLength' | 'minLength' | 'rows'>>;
 
 declare const tagName$5 = "s-text-area";
-interface ReactProps$5 extends Partial<TextAreaProps>, Pick<TextAreaProps$1, 'id'>, FieldReactProps<typeof tagName$5> {
+interface ReactProps$5 extends Partial<Omit<TextAreaProps, 'error' | 'details'>>, Pick<TextAreaProps$1, 'id'>, FieldReactProps<typeof tagName$5>, FieldSlotInternalReactProps {
 }
 
-declare class TextArea extends PreactFieldElement<TextAreaProps['autocomplete']> implements TextAreaProps {
+declare abstract class TextAreaBase extends PreactFieldElement<TextAreaProps['autocomplete']> implements Pick<TextAreaProps, 'maxLength' | 'minLength' | 'rows'> {
     maxLength: TextAreaProps['maxLength'];
     minLength: TextAreaProps['minLength'];
     rows: TextAreaProps['rows'];
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class TextArea extends TextAreaBase implements TextAreaProps {
     constructor();
 }
 declare global {
@@ -5806,7 +6086,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$5]: ReactProps$5 & PreactBaseElementProps<TextArea>;
+            [tagName$5]: Omit<ReactProps$5, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<TextArea>;
         }
     }
 }
@@ -5816,7 +6096,7 @@ type TextFieldProps = PreactFieldProps<
 Required<TextFieldProps$1>['autocomplete']> & Required<Pick<TextFieldProps$1, 'icon' | 'maxLength' | 'minLength' | 'prefix' | 'suffix'>>;
 
 declare const tagName$4 = "s-text-field";
-interface ReactProps$4 extends Partial<Omit<TextFieldProps, 'accessory'>>, Pick<TextFieldProps$1, 'id'>, FieldReactProps<typeof tagName$4> {
+interface ReactProps$4 extends Partial<Omit<TextFieldProps, 'accessory' | 'error' | 'details'>>, Pick<TextFieldProps$1, 'id'>, FieldReactProps<typeof tagName$4>, FieldSlotInternalReactProps {
     /**
      * The accessory to display in the text field.
      */
@@ -5843,7 +6123,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$4]: Omit<ReactProps$4, 'accessory'> & PreactBaseElementPropsWithChildren<TextField>;
+            [tagName$4]: Omit<ReactProps$4, 'accessory' | 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementPropsWithChildren<TextField>;
         }
     }
 }
@@ -5911,13 +6191,17 @@ declare module 'preact' {
 type URLFieldProps = PreactFieldProps<Required<URLFieldProps$1>['autocomplete']> & Required<Pick<URLFieldProps$1, 'maxLength' | 'minLength'>>;
 
 declare const tagName$1 = "s-url-field";
-interface ReactProps$1 extends Partial<Omit<URLFieldProps, 'accessory'>>, Pick<URLFieldProps$1, 'id'>, FieldReactProps<typeof tagName$1> {
+interface ReactProps$1 extends Partial<Omit<URLFieldProps, 'accessory' | 'error' | 'details'>>, Pick<URLFieldProps$1, 'id'>, FieldReactProps<typeof tagName$1>, FieldSlotInternalReactProps {
 }
 
-declare class URLField extends PreactFieldElement<URLFieldProps['autocomplete']> implements URLFieldProps {
+declare abstract class URLFieldBase extends PreactFieldElement<URLFieldProps['autocomplete']> implements Pick<URLFieldProps, 'autocomplete' | 'maxLength' | 'minLength'> {
     autocomplete: URLFieldProps['autocomplete'];
     maxLength: URLFieldProps['maxLength'];
     minLength: URLFieldProps['minLength'];
+    constructor(renderImpl: RenderImpl);
+}
+
+declare class URLField extends URLFieldBase implements URLFieldProps {
     constructor();
 }
 declare global {
@@ -5928,7 +6212,7 @@ declare global {
 declare module 'preact' {
     namespace createElement.JSX {
         interface IntrinsicElements {
-            [tagName$1]: ReactProps$1 & PreactBaseElementProps<URLField>;
+            [tagName$1]: Omit<ReactProps$1, 'error' | 'details'> & FieldSlotPreactProps & PreactBaseElementProps<URLField>;
         }
     }
 }
@@ -6115,14 +6399,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$Q]: ReactProps$Q & ReactBaseElementProps<Checkbox>;
+            [tagName$Q]: Omit<ReactProps$Q, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<Checkbox>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$Q]: ReactProps$Q & ReactBaseElementProps<Checkbox>;
+            [tagName$Q]: Omit<ReactProps$Q, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<Checkbox>;
         }
     }
 }
@@ -6199,14 +6483,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$K]: ReactProps$K & ReactBaseElementProps<ColorField>;
+            [tagName$K]: Omit<ReactProps$K, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<ColorField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$K]: ReactProps$K & ReactBaseElementProps<ColorField>;
+            [tagName$K]: Omit<ReactProps$K, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<ColorField>;
         }
     }
 }
@@ -6227,14 +6511,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$I]: ReactProps$I & ReactBaseElementProps<DateField>;
+            [tagName$I]: Omit<ReactProps$I, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<DateField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$I]: ReactProps$I & ReactBaseElementProps<DateField>;
+            [tagName$I]: Omit<ReactProps$I, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<DateField>;
         }
     }
 }
@@ -6283,14 +6567,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$E]: ReactProps$E & ReactBaseElementProps<EmailField>;
+            [tagName$E]: Omit<ReactProps$E, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<EmailField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$E]: ReactProps$E & ReactBaseElementProps<EmailField>;
+            [tagName$E]: Omit<ReactProps$E, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<EmailField>;
         }
     }
 }
@@ -6423,28 +6707,28 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$u]: ReactProps$u & ReactBaseElementProps<MoneyField>;
+            [tagName$u]: Omit<ReactProps$u, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<MoneyField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$u]: ReactProps$u & ReactBaseElementProps<MoneyField>;
+            [tagName$u]: Omit<ReactProps$u, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<MoneyField>;
         }
     }
 }
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$t]: ReactProps$t & ReactBaseElementProps<NumberField>;
+            [tagName$t]: Omit<ReactProps$t, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<NumberField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$t]: ReactProps$t & ReactBaseElementProps<NumberField>;
+            [tagName$t]: Omit<ReactProps$t, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<NumberField>;
         }
     }
 }
@@ -6521,14 +6805,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$n]: ReactProps$n & ReactBaseElementProps<PasswordField>;
+            [tagName$n]: Omit<ReactProps$n, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<PasswordField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$n]: ReactProps$n & ReactBaseElementProps<PasswordField>;
+            [tagName$n]: Omit<ReactProps$n, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<PasswordField>;
         }
     }
 }
@@ -6591,14 +6875,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$i]: ReactProps$i & ReactBaseElementProps<SearchField>;
+            [tagName$i]: Omit<ReactProps$i, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<SearchField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$i]: ReactProps$i & ReactBaseElementProps<SearchField>;
+            [tagName$i]: Omit<ReactProps$i, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<SearchField>;
         }
     }
 }
@@ -6619,14 +6903,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$g]: ReactProps$g & ReactBaseElementPropsWithChildren<Select>;
+            [tagName$g]: Omit<ReactProps$g, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementPropsWithChildren<Select>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$g]: ReactProps$g & ReactBaseElementPropsWithChildren<Select>;
+            [tagName$g]: Omit<ReactProps$g, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementPropsWithChildren<Select>;
         }
     }
 }
@@ -6773,28 +7057,28 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$5]: ReactProps$5 & ReactBaseElementProps<TextArea>;
+            [tagName$5]: Omit<ReactProps$5, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<TextArea>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$5]: ReactProps$5 & ReactBaseElementProps<TextArea>;
+            [tagName$5]: Omit<ReactProps$5, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<TextArea>;
         }
     }
 }
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$4]: Omit<ReactProps$4, 'accessory'> & ReactBaseElementPropsWithChildren<TextField>;
+            [tagName$4]: Omit<ReactProps$4, 'accessory' | 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementPropsWithChildren<TextField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$4]: Omit<ReactProps$4, 'accessory'> & ReactBaseElementPropsWithChildren<TextField>;
+            [tagName$4]: Omit<ReactProps$4, 'accessory' | 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementPropsWithChildren<TextField>;
         }
     }
 }
@@ -6829,14 +7113,14 @@ declare global {
 declare module 'react' {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$1]: ReactProps$1 & ReactBaseElementProps<URLField>;
+            [tagName$1]: Omit<ReactProps$1, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<URLField>;
         }
     }
 }
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            [tagName$1]: ReactProps$1 & ReactBaseElementProps<URLField>;
+            [tagName$1]: Omit<ReactProps$1, 'error' | 'details'> & FieldSlotPreactProps & ReactBaseElementProps<URLField>;
         }
     }
 }