diff --git a/packages/ui-extensions/src/surfaces/checkout/components/Paragraph.d.ts b/packages/ui-extensions/src/surfaces/checkout/components/Paragraph.d.ts index 05ce0d573e..f6c366fc13 100644 --- a/packages/ui-extensions/src/surfaces/checkout/components/Paragraph.d.ts +++ b/packages/ui-extensions/src/surfaces/checkout/components/Paragraph.d.ts @@ -37,6 +37,17 @@ declare const tagName = "s-paragraph"; export interface ParagraphProps extends Pick { color?: Extract; tone?: Extract; + /** + * The semantic type and styling treatment for the paragraph content. + * + * Other presentation properties on `s-paragraph` override the default styling. + * + * - `paragraph`: A semantic type that indicates the text is a structural grouping of related content. + * - `small`: A semantic type that indicates the text is considered less important than the main content, but is still necessary for the reader to understand. + * + * @default 'paragraph' + */ + type?: Extract; } /** @publicDocs */ export interface ParagraphElement extends ParagraphProps, Omit { diff --git a/packages/ui-extensions/src/surfaces/checkout/components/Text.d.ts b/packages/ui-extensions/src/surfaces/checkout/components/Text.d.ts index 492ee18704..ae215fbea0 100644 --- a/packages/ui-extensions/src/surfaces/checkout/components/Text.d.ts +++ b/packages/ui-extensions/src/surfaces/checkout/components/Text.d.ts @@ -37,6 +37,22 @@ declare const tagName = "s-text"; export interface TextProps extends Pick { color?: Extract; tone?: Extract; + /** + * The semantic type and styling treatment for the text content. + * + * Other presentation properties on text override the default styling. + * + * - `address`: A semantic type that indicates the text is contact information. Typically used for addresses. + * - `redundant`: A semantic type that indicates the text is no longer accurate or no longer relevant. One such use-case is discounted prices. + * - `mark`: A semantic type that indicates the text is marked or highlighted and relevant to the user's current action. + * - `emphasis`: A semantic type that indicates emphatic stress. Typically for words that have a stressed emphasis compared to surrounding text. + * - `offset`: A semantic type that indicates an offset from the normal prose of the text. + * - `small`: A semantic type that indicates the text is considered less important than the main content, but is still necessary for the reader to understand. + * - `strong`: A semantic type that indicates strong importance, seriousness, or urgency. + * - `generic`: No additional semantics or styling is applied. + * + * @default 'generic' + */ type?: Extract; } /** @publicDocs */