@shopify/ui-extensions 2025.10.14 → 2025.10.15

package/build/ts/surfaces/customer-account/api/shared.d.ts

@@ -3,14 +3,7 @@ import type { ApiVersion, Capability, CurrencyCode, Timezone, Country, CountryCo
 import type { SubscribableSignalLike } from '../../checkout/shared';
 export { ApiVersion, Capability, CurrencyCode, Timezone, Country, CountryCode, GraphQLError, StorefrontApiVersion, SubscribableSignalLike, };
 /**
- * A key-value storage object for extension targets.
- *
- * Stored data is only available to this specific app
- * but can be shared across multiple extension targets.
- *
- * The storage backend is implemented with `localStorage` and
- * should persist for ... days
- * However, data persistence isn't guaranteed.
+ * Key-value storage that persists across customer sessions for this extension target. Stored data is scoped to your app and can be shared across multiple extension targets. Data persistence isn't guaranteed.
  */
 export interface Storage {
     /**
@@ -33,6 +26,9 @@ export interface Storage {
      */
     delete(key: string): Promise<void>;
 }
+/**
+ * The buyer's language, represented as a [BCP-47 standard](https://en.wikipedia.org/wiki/IETF_language_tag) language tag.
+ */
 export interface Language {
     /**
      * The [BCP-47](https://en.wikipedia.org/wiki/IETF_language_tag) language tag that identifies the language. This is a standardized code that may include a base language and an optional region subtag separated by a dash. For example, `'en'` represents English and `'en-US'` represents English as used in the United States. The region subtag follows the [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) standard.
@@ -42,11 +38,11 @@ export interface Language {
     isoCode: string;
 }
 /**
- * This defines the i18n.translate() signature.
+ * Translates a key from your extension's locale files into a localized string.
  */
 export interface I18nTranslate {
     /**
-     * This returns a translated string matching a key in a locale file.
+     * Translates a key from your extension's locale files into a localized string. Returns a single string when all replacements are primitives, or an array of elements when replacements include UI components.
      *
      * @example translate("banner.title")
      */
@@ -54,6 +50,9 @@ export interface I18nTranslate {
         [placeholderKey: string]: ReplacementType | string | number;
     }): ReplacementType extends string | number ? string : (string | ReplacementType)[];
 }
+/**
+ * Utilities for translating strings, formatting currencies, numbers, and dates according to the buyer's locale. Use this alongside `localization` to build fully localized extensions.
+ */
 export interface I18n {
     /**
      * Returns a localized number.
@@ -78,14 +77,7 @@ export interface I18n {
         inExtensionLocale?: boolean;
     } & Intl.NumberFormatOptions) => string;
     /**
-     * Returns a localized date value.
-     *
-     * This function behaves like the standard `Intl.DateTimeFormatOptions()` and uses
-     * the buyer's locale by default. Formatting options can be passed in as
-     * options.
-     *
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat0
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat#using_options
+     * Returns a localized date value. This function behaves like the standard [`Intl.DateTimeFormat`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) and uses the buyer's locale by default.
      *
      * @param options.inExtensionLocale - if true, use the extension's locale
      */
@@ -104,7 +96,8 @@ export interface I18n {
     translate: I18nTranslate;
 }
 /**
- * Meta information about an extension target.
+ * Metadata about the running extension, including its API version, target, capabilities, and editor context. Use this to read configuration details or conditionally render content based on where the extension is running.
+ * @publicDocs
  */
 export interface Extension<Target extends ExtensionTarget = ExtensionTarget> {
     /**
@@ -114,12 +107,8 @@ export interface Extension<Target extends ExtensionTarget = ExtensionTarget> {
      */
     apiVersion: ApiVersion;
     /**
-     * The allowed capabilities of the extension, defined
-     * in your [`shopify.extension.toml`](/docs/api/customer-account-ui-extensions/{API_VERSION}#configuration) file.
-     *
-     * * [`api_access`](/docs/api/customer-account-ui-extensions/configuration#api-access): the extension can access the Storefront API.
-     *
-     * * [`network_access`](/docs/api/customer-account-ui-extensions/configuration#network-access): the extension can make external network calls.
+     * The allowed capabilities of the extension, defined in your
+     * [`shopify.extension.toml`](/docs/api/customer-account-ui-extensions/{API_VERSION}/configuration) file.
      */
     capabilities: SubscribableSignalLike<Capability[]>;
     /**
@@ -132,8 +121,7 @@ export interface Extension<Target extends ExtensionTarget = ExtensionTarget> {
      * Whether your extension is currently rendered to the screen.
      *
      * Shopify might render your extension before it's visible in the UI,
-     * typically to pre-render extensions that will appear on a later step of the
-     * checkout.
+     * typically to pre-render extensions that will appear on a later page.
      *
      * Your extension might also continue to run after the buyer has navigated away
      * from where it was rendered. The extension continues running so that
@@ -147,11 +135,9 @@ export interface Extension<Target extends ExtensionTarget = ExtensionTarget> {
     /**
      * The identifier that specifies where in Shopify’s UI your code is being
      * injected. This will be one of the targets you have included in your
-     * extension’s configuration file.
+     * extension’s configuration file. For available targets, see the [extension targets overview](/docs/api/customer-account-ui-extensions/{API_VERSION}/extension-targets-overview). For configuration details, see [targets](/docs/apps/app-extensions/configuration#targets).
      *
      * @example 'customer-account.order-status.block.render'
-     * @see /docs/api/customer-account-ui-extensions/extension-targets-overview
-     * @see /docs/apps/app-extensions/configuration#targets
      */
     target: Target;
     /**
@@ -163,6 +149,9 @@ export interface Extension<Target extends ExtensionTarget = ExtensionTarget> {
      */
     version?: string;
 }
+/**
+ * Information about the editor where the extension is being rendered.
+ */
 export interface Editor {
     /**
      * Indicates whether the extension is rendering in the checkout editor.
@@ -191,6 +180,9 @@ export interface Attribute {
     /**
      * The value associated with the attribute key. This contains the buyer-provided or app-set data for the custom attribute.
      *
+     * Attribute values are always strings. If structured data was stored during
+     * checkout, parse it on read with `JSON.parse()`.
+     *
      * @example 'Happy Birthday!'
      */
     value: string;
@@ -314,22 +306,28 @@ export interface CompanyLocation {
      */
     id: string;
 }
+/**
+ * Authenticates requests between your extension and your app backend by providing signed JWTs.
+ */
 export interface SessionToken {
     /**
      * Requests a session token that hasn't expired. You should call this method every
-     * time you need to make a request to your backend in order to get a valid token.
+     * time you need to make a request to your backend to get a valid token.
      * This method will return cached tokens when possible, so you don’t need to worry
      * about storing these tokens yourself.
      */
     get(): Promise<string>;
 }
+/**
+ * Tracks custom events and sends visitor information to [web pixels](/docs/apps/build/marketing-analytics/pixels).
+ */
 export interface Analytics {
     /**
-     * Publish method to emit analytics events to [Web Pixels](/docs/apps/marketing).
+     * Emits analytics events to [web pixels](/docs/apps/build/marketing-analytics/pixels).
      */
     publish(name: string, data: Record<string, unknown>): Promise<boolean>;
     /**
-     * A method for capturing details about a visitor on the online store.
+     * Submits visitor contact information for marketing attribution and analytics.
      */
     visitor(data: {
         email?: string;
@@ -337,11 +335,11 @@ export interface Analytics {
     }): Promise<VisitorResult>;
 }
 /**
- * Represents a visitor result.
+ * The result of a `visitor()` call, indicating whether the visitor information was accepted or rejected.
  */
 export type VisitorResult = VisitorSuccess | VisitorError;
 /**
- * Represents a successful visitor result.
+ * Returned when visitor information was validated and submitted successfully.
  */
 export interface VisitorSuccess {
     /**
@@ -350,7 +348,7 @@ export interface VisitorSuccess {
     type: 'success';
 }
 /**
- * Represents an unsuccessful visitor result.
+ * Returned when visitor information is invalid and wasn't submitted.
  */
 export interface VisitorError {
     /**
@@ -489,6 +487,9 @@ export interface CustomerPrivacy {
      *
      * @example `{countryCode: 'CA', provinceCode: 'ON'}` for a visitor in Ontario, Canada; `{countryCode: 'US', provinceCode: undefined}` for a visitor in the United States if geolocation fails to detect the state; or `undefined` if neither country nor province is detected or geolocation fails.
      *
+     * Requires level 1 access to protected customer data. `undefined` without
+     * that access. Regional compliance logic can't run without it.
+     *
      * {% include /apps/checkout/privacy-icon.md %} Requires level 1 access to [protected customer data](/docs/apps/store/data-protection/protected-customer-data).
      */
     region?: CustomerPrivacyRegion;
@@ -519,10 +520,26 @@ export interface TrackingConsentChangeResultError {
      */
     message: string;
 }
+/**
+ * The result returned after a toast is displayed, providing a method to dismiss it.
+ *
+ * @hidden
+ */
 export interface ToastApiResult {
+    /**
+     * Dismisses the toast message from the screen.
+     *
+     * @hidden
+     */
     hide: () => void;
 }
+/**
+ * Displays brief, non-blocking messages at the bottom of the page to confirm actions or report errors.
+ */
 export interface ToastApi {
+    /**
+     * Displays a toast message with the specified content. Returns a promise that resolves with a `ToastApiResult` containing a method to dismiss the toast.
+     */
     show: (content: string) => Promise<ToastApiResult>;
 }
 //# sourceMappingURL=shared.d.ts.map

package/build/ts/surfaces/customer-account/api/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/customer-account/api/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/customer-account/api/shared.ts"],"names":[],"mappings":"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"}

package/build/ts/surfaces/customer-account/api/standard-api/standard-api.d.ts

@@ -13,17 +13,15 @@ export interface StandardApi<Target extends ExtensionTarget = ExtensionTarget> {
     /**
      * The identifier that specifies where in Shopify’s UI your code is being
      * injected. This will be one of the targets you have included in your
-     * extension’s configuration file.
+     * extension’s configuration file. For available targets, see the [extension targets overview](/docs/api/customer-account-ui-extensions/{API_VERSION}/extension-targets-overview). For configuration details, see [targets](/docs/apps/app-extensions/configuration#targets).
      *
      * @example 'customer-account.order-status.block.render'
-     * @see https://shopify.dev/docs/api/customer-account-ui-extensions/extension-targets-overview
-     * @see https://shopify.dev/docs/apps/app-extensions/configuration#targets
      *
-     * @deprecated Deprecated as of version `2023-07`, use `extension.target` instead.
+     * @deprecated Use `extension.target` instead.
      */
     extensionPoint: Target;
     /**
-     * Meta information about the extension.
+     * Metadata about the extension, including its target, version, and editor context. Use this to conditionally render content based on where the extension is running.
      */
     extension: Extension;
     /**
@@ -31,66 +29,45 @@ export interface StandardApi<Target extends ExtensionTarget = ExtensionTarget> {
      */
     authenticatedAccount: AuthenticatedAccount;
     /**
-     * The renderer version being used for the extension.
+     * The API version your extension is running against. Use this to conditionally enable features or handle breaking changes when your extension supports multiple API versions.
      *
      * @example 'unstable'
      */
     version: Version;
     /**
-     * Details about the language of the buyer.
+     * The buyer's language, country, and locale context. Use this to adapt your extension to the buyer's region and display localized content.
      */
     localization: Localization;
     /**
-     * Utilities for translating content and formatting values according to the current `localization`
-     * of the user.
+     * Utilities for translating strings, formatting currencies, numbers, and dates according to the buyer's locale. Use this alongside `localization` to build fully localized extensions.
      */
     i18n: I18n;
     /**
-     * Key-value storage for the extension target.
+     * Key-value storage that persists across customer sessions for this extension target. Use this to store preferences, dismiss states, or cached data without requiring a backend call.
      */
     storage: Storage;
     /**
-     * Provides access to session tokens, which can be used to verify token claims on your app's server.
-     *
-     * See [session token examples](https://shopify.dev/docs/api/customer-account-ui-extensions/apis/session-token#examples) for more information.
+     * Authenticates requests between your extension and your app backend. Call `get()` to retrieve a signed JWT containing the customer ID, shop domain, and expiration time, then verify it server-side. See the [Session Token API](/docs/api/customer-account-ui-extensions/{API_VERSION}/target-apis/platform-apis/session-token-api) for more information.
      */
     sessionToken: SessionToken;
     /**
-     * Methods for interacting with [Web Pixels](https://shopify.dev/docs/apps/marketing), such as emitting an event.
+     * Tracks custom events and sends visitor information to [web pixels](/docs/apps/build/marketing-analytics/pixels). Use `publish()` to emit events and `visitor()` to submit visitor data.
      *
-     * > Note: Requires to [connect a third-party domain](https://help.shopify.com/en/manual/domains/add-a-domain/connecting-domains/connect-domain-customer-account) to Shopify for your customer account pages.
+     * > Note: Requires [connecting a third-party domain](https://help.shopify.com/en/manual/domains/add-a-domain/connecting-domains/connect-domain-customer-account) to Shopify for your customer account pages.
      */
     analytics: Analytics;
     /**
-     * The settings matching the settings definition written in the
-     * [`shopify.extension.toml`](/docs/api/customer-account-ui-extensions/{API_VERSION}#configuration) file.
-     *
-     *  See [settings examples](https://shopify.dev/docs/api/customer-account-ui-extensions/apis/order-status-api/settings#examples) for more information.
-     *
-     * > Note: When an extension is being installed in the editor, the settings will be empty until
-     * a merchant sets a value. In that case, this object will be updated in real time as a merchant fills in the settings.
+     * Merchant-defined configuration values for your extension, as specified in the [settings definition](/docs/api/customer-account-ui-extensions/{API_VERSION}/configuration#settings-definition) of your `shopify.extension.toml` file. Settings update in real time as merchants edit them in the extension editor. The value is empty until a merchant sets it.
      */
     settings: SubscribableSignalLike<ExtensionSettings>;
     /**
-     * The Toast API displays a non-disruptive message that displays at the bottom
-     * of the interface to provide quick, at-a-glance feedback on the outcome
-     * of an action.
-     *
-     * How to use:
-     *
-     * - Use toasts to confirm successful actions.
-     *
-     * - Aim for two words.
-     *
-     * - Use noun + past tense verb format. For example, \`Changes saved\`.
-     *
-     * For errors, or information that needs to persist on the page, use a [banner](/docs/api/checkout-ui-extensions/web-components/feedback/banner) component.
+     * Displays brief, non-blocking messages at the bottom of the page to confirm actions or report errors. Use noun + past tense verb format (for example, `Changes saved`). For persistent messages, use a [Banner](/docs/api/customer-account-ui-extensions/{API_VERSION}/ui-components/feedback-and-status-indicators/banner) component instead.
      */
     toast: ToastApi;
     /**
-     * Used to query the Storefront GraphQL API with a prefetched token.
+     * Queries the [Storefront GraphQL API](/docs/api/storefront) directly from your extension using a prefetched token. Use this to fetch product data, collection details, or other storefront information without routing requests through your app backend.
      *
-     * See [storefront api access examples](https://shopify.dev/docs/api/customer-account-ui-extensions/apis/storefront-api#examples) for more information.
+     * Requires the [`api_access` capability](/docs/api/customer-account-ui-extensions/{API_VERSION}/configuration#api-access).
      */
     query: <Data = unknown, Variables = {
         [key: string]: unknown;
@@ -108,7 +85,7 @@ export interface StandardApi<Target extends ExtensionTarget = ExtensionTarget> {
     /**
      * Applies updated tracking consent preferences for the buyer, including their decisions for analytics, marketing, and data sale, along with any custom tracking consent [metafields](/docs/apps/build/custom-data/metafields). Returns a promise that resolves with the result of the consent update.
      *
-     * {% include /apps/checkout/privacy-icon.md %} Requires the [`customer_privacy` capability](/docs/api/customer-account-ui-extensions/latest#configuration) and access to [protected customer data](/docs/apps/store/data-protection/protected-customer-data).
+     * {% include /apps/checkout/privacy-icon.md %} Requires the [`collect_buyer_consent` capability](/docs/apps/build/customer-accounts/capabilities#collect-buyer-consent) and access to [protected customer data](/docs/apps/store/data-protection/protected-customer-data).
      */
     applyTrackingConsentChange: ApplyTrackingConsentChangeType;
 }
@@ -130,27 +107,22 @@ export interface ReturnApi {
 export interface OrderApi {
     orderId: string;
 }
+/**
+ * The buyer's language, country, and locale context. Use this to adapt your extension to the buyer's region and display localized content.
+ */
 export interface Localization {
     /**
      * The language the buyer sees in the customer account hub.
      */
     language: SubscribableSignalLike<Language>;
     /**
-     * This is the buyer's language, as supported by the extension.
-     * If the buyer's actual language isn't supported by the extension,
-     * this is the fallback locale used for translations.
+     * The buyer's language, as supported by the extension. If the buyer's actual language isn't supported by the extension, this is the fallback locale used for translations.
      *
-     * For example, if the buyer's language is 'fr-CA' but your extension
-     * only supports translations for 'fr', then the `isoCode` for this
-     * language is 'fr'. If your extension doesn't provide french
-     * translations at all, this value is the default locale for your
-     * extension (that is, the one matching your .default.json file).
+     * For example, if the buyer's language is 'fr-CA' but your extension only supports translations for 'fr', then the `isoCode` for this language is 'fr'. If your extension doesn't provide French translations at all, this value is the default locale for your extension (that is, the one matching your .default.json file).
      */
     extensionLanguage: SubscribableSignalLike<Language>;
     /**
-     * The country context of the buyer sees in the customer account.
-     * It will update if the buyer changes the country in the customer account
-     * If the country is unknown, then the value is undefined.
+     * The country the buyer sees in the customer account. Updates when the buyer changes their country. The value is `undefined` if the country is unknown.
      */
     country: SubscribableSignalLike<Country | undefined>;
 }
@@ -158,6 +130,9 @@ export interface Localization {
  * An enumerated value representing the type of navigation.
  */
 export type NavigationTypeString = 'push' | 'replace' | 'traverse';
+/**
+ * Options for configuring navigation behavior, including history handling and custom state.
+ */
 export interface NavigationNavigateOptions {
     /**
      * Developer-defined information to be stored in the associated NavigationHistoryEntry once the navigation is complete, retrievable via getState().
@@ -183,6 +158,9 @@ export interface NavigationHistoryEntry {
      */
     getState(): unknown;
 }
+/**
+ * Options for updating the state of the current navigation history entry without performing a navigation.
+ */
 export interface NavigationUpdateCurrentEntryOptions {
     state: unknown;
 }
@@ -199,22 +177,35 @@ export interface NavigationCurrentEntryChangeEvent {
      */
     from: NavigationHistoryEntry;
 }
+/**
+ * Navigates between pages in customer accounts, including other extensions and host pages. Full-page extensions also get access to the current navigation entry and history state.
+ * @publicDocs
+ */
 export interface Navigation {
     /**
-     * The navigate() method navigates to a specific URL, updating any provided state in the history entries list.
+     * Navigates to a specific URL, updating any provided state in the history entries list.
      */
     navigate: NavigateFunction;
     /**
-     * The currentEntry read-only property of the Navigation interface returns a NavigationHistoryEntry object representing the location the user is currently navigated to right now.
+     * The location the user is currently navigated to.
      */
     currentEntry: NavigationHistoryEntry;
     /**
-     * The updateCurrentEntry() method of the Navigation interface updates the state of the currentEntry; used in cases where the state change will be independent of a navigation or reload.
+     * Updates the state of the current entry without performing a navigation or reload.
      */
     updateCurrentEntry(options: NavigationUpdateCurrentEntryOptions): void;
+    /**
+     * Registers a listener that fires when the current history entry changes.
+     */
     addEventListener(type: 'currententrychange', cb: (event: NavigationCurrentEntryChangeEvent) => void): void;
+    /**
+     * Removes a previously registered `currententrychange` listener.
+     */
     removeEventListener(type: 'currententrychange', cb: (event: NavigationCurrentEntryChangeEvent) => void): void;
 }
+/**
+ * A function that navigates to a specific URL, optionally configuring history behavior and custom state.
+ */
 export interface NavigateFunction {
     /**
      * Navigates to a specific URL, updating any provided state in the history entries list.
@@ -222,5 +213,8 @@ export interface NavigateFunction {
      */
     (url: string, options?: NavigationNavigateOptions): void;
 }
+/**
+ * The API version string that identifies which version of the extension API is in use.
+ */
 export type Version = string;
 //# sourceMappingURL=standard-api.d.ts.map

package/build/ts/surfaces/customer-account/api/standard-api/standard-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/customer-account/api/standard-api/standard-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"standard-api.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/customer-account/api/standard-api/standard-api.ts"],"names":[],"mappings":"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"}

package/build/ts/surfaces/customer-account/components/Abbreviation.d.ts

@@ -10,9 +10,7 @@
 /// <reference lib="DOM" />
 import type {AbbreviationProps$1} from './components-shared.d.ts';
 
-/**
- * Used when an element does not have children.
- */
+/** @publicDocs */
 export interface BaseElementProps<TClass = HTMLElement> {
     key?: preact.Key;
     ref?: preact.Ref<TClass>;
@@ -20,14 +18,17 @@ export interface BaseElementProps<TClass = HTMLElement> {
 }
 /**
  * Used when an element has children.
+ * @publicDocs
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
     children?: preact.ComponentChildren;
 }
 
 declare const tagName = "s-abbreviation";
+/** @publicDocs */
 export interface AbbreviationProps extends Pick<AbbreviationProps$1, 'title' | 'id'> {
 }
+/** @publicDocs */
 export interface AbbreviationElement extends AbbreviationProps, Omit<HTMLElement, 'id' | 'title'> {
 }
 declare global {

package/build/ts/surfaces/customer-account/components/Announcement.d.ts

@@ -10,9 +10,7 @@
 /// <reference lib="DOM" />
 import type {AnnouncementProps$1} from './components-shared.d.ts';
 
-/**
- * Used when an element does not have children.
- */
+/** @publicDocs */
 export interface BaseElementProps<TClass = HTMLElement> {
     key?: preact.Key;
     ref?: preact.Ref<TClass>;
@@ -20,68 +18,100 @@ export interface BaseElementProps<TClass = HTMLElement> {
 }
 /**
  * Used when an element has children.
+ * @publicDocs
  */
 export interface BaseElementPropsWithChildren<TClass = HTMLElement> extends BaseElementProps<TClass> {
     children?: preact.ComponentChildren;
 }
+/**
+ * An event type that narrows the `currentTarget` to the specific HTML element associated with the custom element tag. This provides type-safe event handling in callback listeners.
+ * @publicDocs
+ */
 export type CallbackEvent<TTagName extends keyof HTMLElementTagNameMap, TEvent extends Event = Event> = TEvent & {
     currentTarget: HTMLElementTagNameMap[TTagName];
 };
+/**
+ * A typed event listener for custom element events. The listener receives a `CallbackEvent` with the correct `currentTarget` type for the associated custom element tag.
+ * @publicDocs
+ */
 export type CallbackEventListener<TTagName extends keyof HTMLElementTagNameMap, TData = object> = (EventListener & {
     (event: CallbackEvent<TTagName, Event> & TData): void;
 }) | null;
+/**
+ * The visibility state of a toggleable element.
+ *
+ * - `open`: The element is visible and showing its content.
+ * - `closed`: The element is hidden and its content is not visible.
+ */
 export type ToggleState = 'open' | 'closed';
+/**
+ * The event data provided to toggle-related callbacks. Contains the previous and next visibility states of the element.
+ */
 export interface ToggleArgumentsEvent {
+    /**
+     * The visibility state of the element before the toggle occurred.
+     */
     oldState?: ToggleState;
+    /**
+     * The visibility state of the element after the toggle occurred.
+     */
     newState?: ToggleState;
 }
 
 declare const tagName = "s-announcement";
+/** @publicDocs */
 export interface AnnouncementEvents extends Pick<AnnouncementProps$1, 'onAfterToggle' | 'onDismiss' | 'onToggle'> {
 }
+/** @publicDocs */
 export interface AnnouncementElementEvents {
     /**
-     * Callback fired when the element state changes **after** any animations have finished.
+     * A callback that fires when the element state changes, after any toggle animations have finished.
      *
      * - If the element transitioned from hidden to showing, the `oldState` property will be set to `closed` and the
      *   `newState` property will be set to `open`.
      * - If the element transitioned from showing to hidden, the `oldState` property will be set to `open` and the
      *   `newState` will be `closed`.
      *
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState
+     * Learn more about [`newState` property](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState) and [`oldState` property](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState).
      */
     aftertoggle?: CallbackEventListener<typeof tagName, ToggleArgumentsEvent>;
     /**
-     * Callback fired when the announcement is dismissed by the user
-     * (either via the built-in dismiss button or programmatically).
+     * A callback that fires when the announcement is dismissed by the user clicking the close button or by calling the `dismiss()` method programmatically.
      */
     dismiss?: CallbackEventListener<typeof tagName>;
     /**
-     * Callback straight after the element state changes.
+     * A callback that fires immediately when the element state changes, before any animations.
      *
      * - If the element is transitioning from hidden to showing, the `oldState` property will be set to `closed` and the
      *   `newState` property will be set to `open`.
-     * - If the element is transitioning from showing to hidden, then `oldState` property will be set to `open` and the
+     * - If the element is transitioning from showing to hidden, then the `oldState` property will be set to `open` and the
      *   `newState` will be `closed`.
      *
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState
-     * @see https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState
+     * Learn more about the [`toggle` event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event), [`newState` property](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/newState), and [`oldState` property](https://developer.mozilla.org/en-US/docs/Web/API/ToggleEvent/oldState).
      */
     toggle?: CallbackEventListener<typeof tagName, ToggleArgumentsEvent>;
 }
+/** @publicDocs */
 export interface AnnouncementElement extends AnnouncementMethods, Omit<HTMLElement, 'id' | 'ontoggle'> {
     onaftertoggle?: AnnouncementEvents['onAfterToggle'];
     ondismiss?: AnnouncementEvents['onDismiss'];
     ontoggle?: AnnouncementEvents['onToggle'];
 }
+/** @publicDocs */
 export interface AnnouncementProps extends AnnouncementEvents {
 }
+/** @publicDocs */
 export interface AnnouncementMethods {
+    /**
+     * Programmatically dismisses the announcement. This triggers the `dismiss` event callback.
+     */
     dismiss: () => void;
 }
+/** @publicDocs */
 export interface AnnouncementElementMethods {
+    /**
+     * Programmatically dismisses the announcement. This triggers the `dismiss` event callback.
+     */
     dismiss: AnnouncementMethods['dismiss'];
 }
 declare global {