@porsche-design-system/components-react 4.0.0-beta.2 → 4.0.0-beta.4

package/esm/lib/components/fieldset.wrapper.d.ts

@@ -2,15 +2,15 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaRole, FieldsetLabelSize, FieldsetState } from '../types';
 export type PFieldsetProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaRole<"radiogroup">;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
-     * The size of the label text.
+     * Controls the size of the label text.
      */
     labelSize?: FieldsetLabelSize;
     /**
@@ -28,15 +28,15 @@ export type PFieldsetProps = BaseProps & {
 };
 export declare const PFieldset: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaRole<"radiogroup">;
     /**
-     * The label text.
+     * Text content for a user-facing label.
      */
     label?: string;
     /**
-     * The size of the label text.
+     * Controls the size of the label text.
      */
     labelSize?: FieldsetLabelSize;
     /**

package/esm/lib/components/flag.wrapper.d.ts

@@ -1,5 +1,5 @@
 import type { BaseProps } from '../../BaseProps';
-import type { SelectedAriaAttributes, FlagAriaAttribute, FlagName, FlagSize } from '../types';
+import type { SelectedAriaAttributes, FlagAriaAttribute, FlagName, BreakpointCustomizable, FlagSize } from '../types';
 export type PFlagProps = BaseProps & {
     /**
      * A map of ARIA attributes to enhance the flag's accessibility. For example, use `{ 'aria-label': 'German flag' }` to provide a descriptive label for screen readers.
@@ -10,9 +10,9 @@ export type PFlagProps = BaseProps & {
      */
     name?: FlagName;
     /**
-     * The size of the flag. Pre-defined sizes are aligned with the Porsche Next typescale. Available values are `small`, `medium`, `large`, etc.
+     * Defines the size of the flag, aligned with the typographic scale used by components such as p-icon, p-spinner, p-text, and p-heading. When set to `inherit`, the size is derived from a custom font-size defined on a parent element, calculated against the global line-height (based on `ex`-unit) to remain visually consistent with other typographic-scale-based components.
      */
-    size?: FlagSize;
+    size?: BreakpointCustomizable<FlagSize>;
 };
 export declare const PFlag: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
@@ -24,7 +24,7 @@ export declare const PFlag: import("react").ForwardRefExoticComponent<Omit<impor
      */
     name?: FlagName;
     /**
-     * The size of the flag. Pre-defined sizes are aligned with the Porsche Next typescale. Available values are `small`, `medium`, `large`, etc.
+     * Defines the size of the flag, aligned with the typographic scale used by components such as p-icon, p-spinner, p-text, and p-heading. When set to `inherit`, the size is derived from a custom font-size defined on a parent element, calculated against the global line-height (based on `ex`-unit) to remain visually consistent with other typographic-scale-based components.
      */
-    size?: FlagSize;
+    size?: BreakpointCustomizable<FlagSize>;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/flag.wrapper.mjs

@@ -4,7 +4,7 @@ import { forwardRef, useRef } from 'react';
 import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PFlag = /*#__PURE__*/ forwardRef(({ aria, name = 'de', size = 'small', className, ...rest }, ref) => {
+const PFlag = /*#__PURE__*/ forwardRef(({ aria, name = 'de', size = 'sm', className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     const WebComponentTag = usePrefix('p-flag');
     const propsToSync = [aria, name, size];

package/esm/lib/components/flyout.wrapper.d.ts

@@ -2,7 +2,7 @@ import type { BaseProps } from '../../BaseProps';
 import type { SelectedAriaAttributes, FlyoutAriaAttribute, FlyoutBackdrop, FlyoutBackground, FlyoutFooterBehavior, FlyoutMotionHiddenEndEventDetail, FlyoutMotionVisibleEndEventDetail, FlyoutPosition } from '../types';
 export type PFlyoutProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<FlyoutAriaAttribute>;
     /**
@@ -44,7 +44,7 @@ export type PFlyoutProps = BaseProps & {
 };
 export declare const PFlyout: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<FlyoutAriaAttribute>;
     /**

package/esm/lib/components/heading.wrapper.d.ts

@@ -1,48 +1,64 @@
 import type { BaseProps } from '../../BaseProps';
-import type { HeadingAlign, HeadingColor, BreakpointCustomizable, HeadingSize, HeadingTag } from '../types';
+import type { HeadingAlign, HeadingColor, HeadingHyphens, BreakpointCustomizable, HeadingSize, HeadingTag, HeadingWeight } from '../types';
 export type PHeadingProps = BaseProps & {
     /**
-     * Text alignment of the component.
+     * Text alignment of the heading. Use 'start' for left-aligned text (in LTR), 'center' for centered, 'end' for right-aligned (in LTR), or 'inherit' to adopt the parent's alignment.
      */
     align?: HeadingAlign;
     /**
-     * Basic text color variations.
+     * Text color of the heading. Use 'primary' for default, 'contrast-higher' / 'contrast-high' / 'contrast-medium' for alternative emphasis levels, or 'inherit' to adopt the parent's color.
      */
     color?: HeadingColor;
     /**
-     * Adds an ellipsis to a single line of text if it overflows.
+     * Adds an ellipsis to a single line of text if it overflows the container width. When enabled, the text is truncated to a single line with `text-overflow: ellipsis`. Cannot be combined with multi-line content.
      */
     ellipsis?: boolean;
     /**
-     * Size of the component. Also defines the size for specific breakpoints, like {base: "small", l: "medium"}. You always need to provide a base value when doing this.
+     * Controls the hyphenation behavior of the heading. Use 'auto' to let the browser automatically hyphenate words at appropriate points, 'manual' to only hyphenate at manually inserted hyphenation points (e.g. `­`), 'none' to disable hyphenation entirely, or 'inherit' to adopt the parent's hyphenation setting.
+     */
+    hyphens?: HeadingHyphens;
+    /**
+     * Size of the heading. Also defines the size for specific breakpoints, like {base: "md", l: "2xl"}. You always need to provide a base value when doing this. Use 'inherit' to adopt the parent's font size.
      */
     size?: BreakpointCustomizable<HeadingSize>;
     /**
-     * Sets a heading tag, so it fits correctly within the outline of the page.
+     * Sets the HTML heading tag (h1 - h6) to ensure the correct document outline and semantic hierarchy. If not set, the tag is automatically inferred from the `size` property (e.g. '2xl' maps to 'h2', 'md' to 'h5', 'sm' to 'h6').
      */
     tag?: HeadingTag;
+    /**
+     * The font weight of the heading. Use 'normal' for regular weight, 'semibold' for slightly emphasized text, or 'bold' for strong emphasis. For `size` values of 'sm' or smaller, it's recommended to use 'semibold' for better readability.
+     */
+    weight?: HeadingWeight;
 };
 export declare const PHeading: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Text alignment of the component.
+     * Text alignment of the heading. Use 'start' for left-aligned text (in LTR), 'center' for centered, 'end' for right-aligned (in LTR), or 'inherit' to adopt the parent's alignment.
      */
     align?: HeadingAlign;
     /**
-     * Basic text color variations.
+     * Text color of the heading. Use 'primary' for default, 'contrast-higher' / 'contrast-high' / 'contrast-medium' for alternative emphasis levels, or 'inherit' to adopt the parent's color.
      */
     color?: HeadingColor;
     /**
-     * Adds an ellipsis to a single line of text if it overflows.
+     * Adds an ellipsis to a single line of text if it overflows the container width. When enabled, the text is truncated to a single line with `text-overflow: ellipsis`. Cannot be combined with multi-line content.
      */
     ellipsis?: boolean;
     /**
-     * Size of the component. Also defines the size for specific breakpoints, like {base: "small", l: "medium"}. You always need to provide a base value when doing this.
+     * Controls the hyphenation behavior of the heading. Use 'auto' to let the browser automatically hyphenate words at appropriate points, 'manual' to only hyphenate at manually inserted hyphenation points (e.g. `&shy;`), 'none' to disable hyphenation entirely, or 'inherit' to adopt the parent's hyphenation setting.
+     */
+    hyphens?: HeadingHyphens;
+    /**
+     * Size of the heading. Also defines the size for specific breakpoints, like {base: "md", l: "2xl"}. You always need to provide a base value when doing this. Use 'inherit' to adopt the parent's font size.
      */
     size?: BreakpointCustomizable<HeadingSize>;
     /**
-     * Sets a heading tag, so it fits correctly within the outline of the page.
+     * Sets the HTML heading tag (h1 - h6) to ensure the correct document outline and semantic hierarchy. If not set, the tag is automatically inferred from the `size` property (e.g. '2xl' maps to 'h2', 'md' to 'h5', 'sm' to 'h6').
      */
     tag?: HeadingTag;
+    /**
+     * The font weight of the heading. Use 'normal' for regular weight, 'semibold' for slightly emphasized text, or 'bold' for strong emphasis. For `size` values of 'sm' or smaller, it's recommended to use 'semibold' for better readability.
+     */
+    weight?: HeadingWeight;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/heading.wrapper.mjs

@@ -4,13 +4,13 @@ import { forwardRef, useRef } from 'react';
 import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PHeading = /*#__PURE__*/ forwardRef(({ align = 'start', color = 'primary', ellipsis = false, size = 'xx-large', tag, className, ...rest }, ref) => {
+const PHeading = /*#__PURE__*/ forwardRef(({ align = 'start', color = 'primary', ellipsis = false, hyphens = 'none', size = '2xl', tag, weight = 'normal', className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     const WebComponentTag = usePrefix('p-heading');
-    const propsToSync = [align, color, ellipsis, size, tag];
+    const propsToSync = [align, color, ellipsis, hyphens, size, tag, weight];
     useBrowserLayoutEffect(() => {
         const { current } = elementRef;
-        ['align', 'color', 'ellipsis', 'size', 'tag'].forEach((propName, i) => (current[propName] = propsToSync[i]));
+        ['align', 'color', 'ellipsis', 'hyphens', 'size', 'tag', 'weight'].forEach((propName, i) => (current[propName] = propsToSync[i]));
     }, propsToSync);
     const props = {
         ...rest,

package/esm/lib/components/icon.wrapper.d.ts

@@ -1,8 +1,8 @@
 import type { BaseProps } from '../../BaseProps';
-import type { SelectedAriaAttributes, IconAriaAttribute, IconColor, IconName, IconSize } from '../types';
+import type { SelectedAriaAttributes, IconAriaAttribute, IconColor, IconName, BreakpointCustomizable, IconSize } from '../types';
 export type PIconProps = BaseProps & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<IconAriaAttribute>;
     /**
@@ -14,9 +14,9 @@ export type PIconProps = BaseProps & {
      */
     name?: IconName;
     /**
-     * The size of the icon.
+     * Defines the size of the icon, aligned with the typographic scale used by components such as p-spinner, p-flag, p-text, and p-heading. When set to `inherit`, the size is derived from a custom font-size defined on a parent element, calculated against the global line-height (based on `ex`-unit) to remain visually consistent with other typographic-scale-based components.
      */
-    size?: IconSize;
+    size?: BreakpointCustomizable<IconSize>;
     /**
      * Specifies a whole icon path which can be used for custom icons.
      */
@@ -24,7 +24,7 @@ export type PIconProps = BaseProps & {
 };
 export declare const PIcon: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Add ARIA attributes.
+     * Sets ARIA attributes.
      */
     aria?: SelectedAriaAttributes<IconAriaAttribute>;
     /**
@@ -36,9 +36,9 @@ export declare const PIcon: import("react").ForwardRefExoticComponent<Omit<impor
      */
     name?: IconName;
     /**
-     * The size of the icon.
+     * Defines the size of the icon, aligned with the typographic scale used by components such as p-spinner, p-flag, p-text, and p-heading. When set to `inherit`, the size is derived from a custom font-size defined on a parent element, calculated against the global line-height (based on `ex`-unit) to remain visually consistent with other typographic-scale-based components.
      */
-    size?: IconSize;
+    size?: BreakpointCustomizable<IconSize>;
     /**
      * Specifies a whole icon path which can be used for custom icons.
      */

package/esm/lib/components/icon.wrapper.mjs

@@ -4,7 +4,7 @@ import { forwardRef, useRef } from 'react';
 import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PIcon = /*#__PURE__*/ forwardRef(({ aria, color = 'primary', name = 'arrow-right', size = 'small', source, className, ...rest }, ref) => {
+const PIcon = /*#__PURE__*/ forwardRef(({ aria, color = 'primary', name = 'arrow-right', size = 'sm', source, className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     const WebComponentTag = usePrefix('p-icon');
     const propsToSync = [aria, color, name, size, source];

package/esm/lib/components/input-date.wrapper.d.ts

@@ -2,11 +2,11 @@ import type { BaseProps } from '../../BaseProps';
 import type { BreakpointCustomizable, InputDateBlurEventDetail, InputDateChangeEventDetail, InputDateInputEventDetail, InputDateState } from '../types';
 export type PInputDateProps = BaseProps & {
     /**
-     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., auto-complete='bday' for a birthday).
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='bday' for a birthday).
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -14,7 +14,7 @@ export type PInputDateProps = BaseProps & {
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -22,7 +22,7 @@ export type PInputDateProps = BaseProps & {
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -50,11 +50,11 @@ export type PInputDateProps = BaseProps & {
      */
     name: string;
     /**
-     * Emitted when the number input has lost focus.
+     * Emitted when the date input has lost focus.
      */
     onBlur?: (event: CustomEvent<InputDateBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the date input loses focus after its value was changed.
      */
     onChange?: (event: CustomEvent<InputDateChangeEventDetail>) => void;
     /**
@@ -84,11 +84,11 @@ export type PInputDateProps = BaseProps & {
 };
 export declare const PInputDate: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., auto-complete='bday' for a birthday).
+     * Provides a hint to the browser about what type of data the field expects, which can assist with autofill features (e.g., autocomplete='bday' for a birthday).
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -96,7 +96,7 @@ export declare const PInputDate: import("react").ForwardRefExoticComponent<Omit<
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -104,7 +104,7 @@ export declare const PInputDate: import("react").ForwardRefExoticComponent<Omit<
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -132,11 +132,11 @@ export declare const PInputDate: import("react").ForwardRefExoticComponent<Omit<
      */
     name: string;
     /**
-     * Emitted when the number input has lost focus.
+     * Emitted when the date input has lost focus.
      */
     onBlur?: (event: CustomEvent<InputDateBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the date input loses focus after its value was changed.
      */
     onChange?: (event: CustomEvent<InputDateChangeEventDetail>) => void;
     /**

package/esm/lib/components/input-email.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PInputEmailProps = BaseProps & {
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -14,7 +14,7 @@ export type PInputEmailProps = BaseProps & {
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -22,7 +22,7 @@ export type PInputEmailProps = BaseProps & {
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -50,7 +50,7 @@ export type PInputEmailProps = BaseProps & {
      */
     minLength?: number;
     /**
-     * A boolean value that, if present, it allows the user to enter a list of multiple email addresses, separated by commas (and optional whitespace). The browser will validate each email address in the list.
+     * Allows the user to enter a list of email addresses separated by commas (and optional whitespace). The browser validates each email address in the list.
      */
     multiple?: boolean;
     /**
@@ -100,7 +100,7 @@ export declare const PInputEmail: import("react").ForwardRefExoticComponent<Omit
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -108,7 +108,7 @@ export declare const PInputEmail: import("react").ForwardRefExoticComponent<Omit
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -116,7 +116,7 @@ export declare const PInputEmail: import("react").ForwardRefExoticComponent<Omit
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -144,7 +144,7 @@ export declare const PInputEmail: import("react").ForwardRefExoticComponent<Omit
      */
     minLength?: number;
     /**
-     * A boolean value that, if present, it allows the user to enter a list of multiple email addresses, separated by commas (and optional whitespace). The browser will validate each email address in the list.
+     * Allows the user to enter a list of email addresses separated by commas (and optional whitespace). The browser validates each email address in the list.
      */
     multiple?: boolean;
     /**

package/esm/lib/components/input-month.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PInputMonthProps = BaseProps & {
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -14,7 +14,7 @@ export type PInputMonthProps = BaseProps & {
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -22,7 +22,7 @@ export type PInputMonthProps = BaseProps & {
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -34,7 +34,7 @@ export type PInputMonthProps = BaseProps & {
      */
     loading?: boolean;
     /**
-     * Specifies the latest month that can be selected. The value must be a month string in YYYY-MM format(e.g., max='2024-12').
+     * Specifies the latest month that can be selected. The value must be a month string in YYYY-MM format (e.g., max='2024-12').
      */
     max?: string;
     /**
@@ -50,11 +50,11 @@ export type PInputMonthProps = BaseProps & {
      */
     name: string;
     /**
-     * Emitted when the number input has lost focus.
+     * Emitted when the month input has lost focus.
      */
     onBlur?: (event: CustomEvent<InputMonthBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the month input loses focus after its value was changed.
      */
     onChange?: (event: CustomEvent<InputMonthChangeEventDetail>) => void;
     /**
@@ -88,7 +88,7 @@ export declare const PInputMonth: import("react").ForwardRefExoticComponent<Omit
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -96,7 +96,7 @@ export declare const PInputMonth: import("react").ForwardRefExoticComponent<Omit
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -104,7 +104,7 @@ export declare const PInputMonth: import("react").ForwardRefExoticComponent<Omit
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -116,7 +116,7 @@ export declare const PInputMonth: import("react").ForwardRefExoticComponent<Omit
      */
     loading?: boolean;
     /**
-     * Specifies the latest month that can be selected. The value must be a month string in YYYY-MM format(e.g., max='2024-12').
+     * Specifies the latest month that can be selected. The value must be a month string in YYYY-MM format (e.g., max='2024-12').
      */
     max?: string;
     /**
@@ -132,11 +132,11 @@ export declare const PInputMonth: import("react").ForwardRefExoticComponent<Omit
      */
     name: string;
     /**
-     * Emitted when the number input has lost focus.
+     * Emitted when the month input has lost focus.
      */
     onBlur?: (event: CustomEvent<InputMonthBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the month input loses focus after its value was changed.
      */
     onChange?: (event: CustomEvent<InputMonthChangeEventDetail>) => void;
     /**

package/esm/lib/components/input-number.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PInputNumberProps = BaseProps & {
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -18,7 +18,7 @@ export type PInputNumberProps = BaseProps & {
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -26,7 +26,7 @@ export type PInputNumberProps = BaseProps & {
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -86,7 +86,7 @@ export type PInputNumberProps = BaseProps & {
      */
     step?: number;
     /**
-     * The number input value.
+     * The value of the number input.
      */
     value?: string;
 };
@@ -96,7 +96,7 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -108,7 +108,7 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -116,7 +116,7 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -176,7 +176,7 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     step?: number;
     /**
-     * The number input value.
+     * The value of the number input.
      */
     value?: string;
 } & {

package/esm/lib/components/input-password.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PInputPasswordProps = BaseProps & {
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -14,7 +14,7 @@ export type PInputPasswordProps = BaseProps & {
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -22,7 +22,7 @@ export type PInputPasswordProps = BaseProps & {
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**
@@ -92,7 +92,7 @@ export declare const PInputPassword: import("react").ForwardRefExoticComponent<O
      */
     autoComplete?: string;
     /**
-     * A boolean value that, if present, renders the input field as a compact version.
+     * Displays the input field in compact mode.
      */
     compact?: boolean;
     /**
@@ -100,7 +100,7 @@ export declare const PInputPassword: import("react").ForwardRefExoticComponent<O
      */
     description?: string;
     /**
-     * A boolean value that, if present, makes the input field unusable and unclickable. The value will not be submitted with the form.
+     * Disables the input field. The value will not be submitted with the form.
      */
     disabled?: boolean;
     /**
@@ -108,7 +108,7 @@ export declare const PInputPassword: import("react").ForwardRefExoticComponent<O
      */
     form?: string;
     /**
-     * Controls the visibility of the label.
+     * Shows or hides the label. For better accessibility, it is recommended to show the label.
      */
     hideLabel?: BreakpointCustomizable<boolean>;
     /**