@progress/kendo-angular-navigation 19.1.2-develop.3 → 19.1.2-develop.5

package/actionsheet/actionsheet.component.d.ts

@@ -13,7 +13,13 @@ import { ActionSheetViewComponent } from './actionsheet-view.component';
 import * as i0 from "@angular/core";
 /**
  * Represents the [Kendo UI ActionSheet component for Angular](slug:overview_actionsheet).
- * Used to display a set of choices related to a task the user initiates.
+ * Use this component to display a set of choices related to a user-initiated task in a modal sheet that slides up from the bottom of the screen.
+ *
+ * @example
+ * ```html
+ * <kendo-actionsheet [items]="actionItems" [expanded]="true">
+ * </kendo-actionsheet>
+ * ```
  */
 export declare class ActionSheetComponent implements AfterViewInit, OnDestroy, OnChanges {
     element: ElementRef;
@@ -35,51 +41,47 @@ export declare class ActionSheetComponent implements AfterViewInit, OnDestroy, O
      */
     direction: string;
     /**
-     * Specifies the ActionSheet action buttons.
+     * Specifies the action buttons displayed in the ActionSheet footer.
      */
     actions: ActionSheetAction[];
     /**
-     * Specifies the layout of the action buttons.
-     * By default, the action buttons are rendered horizontally and stretched.
+     * Configures the layout of the action buttons in the footer. By default, actions are arranged horizontally and stretched to fill the container.
      */
     actionsLayout: ActionSheetActionsLayout;
     /**
-     * Specifies if the ActionSheet is closed on overlay click.
+     * Determines whether the ActionSheet closes when the overlay is clicked.
      *
      * @default false
      */
     overlayClickClose: boolean;
     /**
-     * Specifies the text that is rendered as title.
+     * Sets the title text displayed in the ActionSheet header.
      */
     title: string;
     /**
-     * Specifies the text that is rendered under the title.
+     * Sets the subtitle text displayed below the title in the header.
      */
     subtitle: string;
     /**
-     * The collection of items that will be rendered in the ActionSheet.
+     * Provides the collection of items rendered in the ActionSheet content area.
      */
     items: Array<ActionSheetItem>;
     /**
-     * The CSS classes that will be rendered on the inner ActionSheet element.
-     * Supports the type of values that are supported by [ngClass](link:site.data.urls.angular['ngclassapi']).
+     * Applies CSS classes to the inner ActionSheet element. Accepts any value supported by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     cssClass: any;
     /**
-     * The inline styles that will be rendered on the inner ActionSheet element.
-     * Supports the type of values that are supported by [ngStyle](link:site.data.urls.angular['ngstyleapi']).
+     * Applies inline styles to the inner ActionSheet element. Accepts any value supported by [`ngStyle`](link:site.data.urls.angular['ngstyleapi']).
      */
     cssStyle: any;
     /**
-     * Configures the ActionSheet opening and closing animations ([see example](slug:animations_actionsheet)).
-     * By default, the animations are turned off. The default animations' duration is `300ms`.
+     * Configures the opening and closing animations for the ActionSheet ([see example](slug:animations_actionsheet)).
      *
      * @default true
      */
     animation: boolean | ActionSheetAnimation;
     /**
-     * Specifies the state of the ActionSheet.
+     * Controls whether the ActionSheet is expanded or collapsed.
      *
      * @default false
      */
@@ -88,7 +90,6 @@ export declare class ActionSheetComponent implements AfterViewInit, OnDestroy, O
      * Sets the `aria-labelledby` attribute of the ActionSheet wrapper element.
      * Use this option when the built-in header element is replaced through the [`ActionSheetHeaderTemplate`](slug:api_navigation_actionsheetheadertemplatedirective)
      * or [`ActionSheetContentTemplate`](slug:api_navigation_actionsheetcontenttemplatedirective).
-     *
      */
     titleId: string;
     /**
@@ -99,7 +100,7 @@ export declare class ActionSheetComponent implements AfterViewInit, OnDestroy, O
     initialFocus: boolean;
     /**
      * Fires when the `expanded` property of the component is updated.
-     * Used to provide a two-way binding for the `expanded` property.
+     * You can use this event to provide two-way binding for the `expanded` property.
      */
     expandedChange: EventEmitter<boolean>;
     /**

package/actionsheet/models/actionsheet-action-layout.d.ts

@@ -3,32 +3,34 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Defines the possible orientations for the ActionSheet action buttons.
- * - `horizontal`: The actions are laid out in a horizontal row.
- * - `vertical`: The actions are stacked vertically.
+ * Defines the possible orientations for ActionSheet action buttons.
+ * - `horizontal`—Lays out actions in a horizontal row.
+ * - `vertical`—Stacks actions vertically.
  */
 export type ActionSheetActionsOrientation = 'horizontal' | 'vertical';
 /**
  * Defines the possible alignments for the ActionSheet action buttons.
- * - `start`: Aligns the actions to the start of the container.
- * - `center`: Centers the actions within the container.
- * - `end`: Aligns the actions to the end of the container.
- * - `stretched`: Stretches the actions to fill the available space.
- * - `justify`: Justifies the actions to distribute them evenly across the container.
+ * - `start`—Aligns actions to the start of the container.
+ * - `center`—Centers actions within the container.
+ * - `end`—Aligns actions to the end of the container.
+ * - `stretched`—Stretches actions to fill the available space.
+ * - `justify`—Distributes actions evenly across the container.
  */
 export type ActionSheetActionsAlignment = 'start' | 'center' | 'end' | 'stretched' | 'justify';
 /**
- * Represents the layout configuration for the ActionSheet action buttons.
+ * Represents the layout configuration options for the ActionSheet action buttons.
  */
 export interface ActionSheetActionsLayout {
     /**
-     * The orientation of the actions.
-     * Defaults to `horizontal` if not specified.
+     * Specifies the orientation of the actions.
+     *
+     * @default horizontal
      */
     orientation?: ActionSheetActionsOrientation;
     /**
-     * The alignment of the actions within the container.
-     * Defaults to `stretched` if not specified.
+     * Specifies the alignment of the actions within the container.
+     *
+     * @default stretched
      */
     alignment?: ActionSheetActionsAlignment;
 }

package/actionsheet/models/actionsheet-action.d.ts

@@ -5,60 +5,39 @@
 import { ButtonFillMode, ButtonSize, ButtonThemeColor } from "@progress/kendo-angular-buttons";
 import { SVGIcon } from "@progress/kendo-svg-icons";
 /**
- * The settings for the ActionSheet action buttons.
+ * Describes the configuration for an ActionSheet action button.
  */
 export interface ActionSheetAction {
     /**
-     * The unique identifier of the action button.
+     * Specifies the unique identifier of the action button.
      */
     id?: string | number;
     /**
-     * The text of the action button.
+     * Sets the text content of the action button.
      */
     text?: string;
     /**
-     * The font icon of the action button.
+     * Sets the [font icon](slug:icon_list) for the action button.
      */
     icon?: string;
     /**
-     * The SVG icon of the action button.
+     * Specifies an [`SVGIcon`](slug:api_icons_svgicon) for the action button.
      */
     svgIcon?: SVGIcon;
     /**
-     * The title of the action button. The title shows as the default tooltip for the action button.
+     * Specifies the `title` attribute for the action button. The title appears as the default tooltip.
      */
     title?: string;
     /**
-     * The size of the action button. The supported values are:
-     * - `small`
-     * - `medium`
-     * - `large`
-     * - `none`
+     * Sets the size of the action button.
      */
     size?: ButtonSize;
     /**
-     * The fill mode of the action button. The supported values are:
-     * - `flat`
-     * - `outline`
-     * - `solid`
-     * - `link`
-     * - `clear`
-     * - `none`
+     * Defines the fill mode of the action button.
      */
     fillMode?: ButtonFillMode;
     /**
-     * The theme color of the action button. The possible values are:
-     * - `base`: Applies coloring based on the base theme color.
-     * - `primary`: Applies coloring based on the primary theme color.
-     * - `secondary`: Applies coloring based on the secondary theme color.
-     * - `tertiary`: Applies coloring based on the tertiary theme color.
-     * - `info`: Applies coloring based on the info theme color.
-     * - `success`: Applies coloring based on the success theme color.
-     * - `warning`: Applies coloring based on the warning theme color.
-     * - `error`: Applies coloring based on the error theme color.
-     * - `dark`: Applies coloring based on the dark theme color.
-     * - `light`: Applies coloring based on the light theme color.
-     * - `inverse`: Applies coloring based on the inverse theme color.
+     * Specifies the theme color of the action button.
      */
     themeColor?: ButtonThemeColor;
 }

package/actionsheet/models/actionsheet-item.interface.d.ts

@@ -5,7 +5,7 @@
 import { SVGIcon } from '@progress/kendo-svg-icons';
 import { ActionSheetItemGroup } from "./group";
 /**
- * An interface for the ActionSheet items.
+ * Represents the configuration for an ActionSheet item.
  */
 export interface ActionSheetItem {
     /**
@@ -13,50 +13,45 @@ export interface ActionSheetItem {
      */
     title?: string;
     /**
-     * Defines the name for an existing icon in a Kendo UI theme.
-     * The icon is rendered inside the ActionSheet item by a `span.k-icon` element.
+     * Defines the name of an existing [font icon](slug:icon_list) to render inside the item. The icon is rendered in a `span.k-icon` element.
      */
     icon?: string;
     /**
-     * Defines an [`SVGIcon`](slug:api_icons_svgicon) to be rendered within the ActionSheet item.
+     * Defines an [`SVGIcon`](slug:api_icons_svgicon) to render within the ActionSheet item.
      */
     svgIcon?: SVGIcon;
     /**
-     * Defines a CSS class — or multiple classes separated by spaces —
-     * which are applied to a span element inside the ActionSheet item.
-     * Allows the usage of custom icons.
+     * Defines one or more CSS classes to apply to a span element inside the item. Allows using custom icons.
      */
     iconClass?: string;
     /**
-     * Defines the group of the item.
-     * Items can be segregated in two groups - `top` and `bottom` -
-     * each specifying whether the ActionSheet item will be rendered over the separator or under it.
+     * Specifies the group for the item. Use `top` to render the item above the separator, or `bottom` to render below it.
      */
     group?: ActionSheetItemGroup;
     /**
-     * Specifies additional text rendered under the item's title.
+     * Sets additional text rendered below the item's title.
      */
     description?: string;
     /**
-     * Specifies if the ActionSheet item is initially disabled.
+     * Specifies whether the ActionSheet item is initially disabled.
+     *
+     * @default false
      */
     disabled?: boolean;
     /**
-     * Specifies the size of the icon. Accepts any valid font-size value.
+     * Defines the size of the icon. Accepts any valid CSS font-size value.
      */
     iconSize?: string;
     /**
-     * Specifies the color of the icon. Available options are `inherit`, `default`, `primary`, `secondary`, `tertiary`, `info`, `success`, `warning`, `error`, `dark`, `light`, `inverted` or any hexadecimal value.
+     * Sets the color of the icon. Accepts `inherit`, `default`, `primary`, `secondary`, `tertiary`, `info`, `success`, `warning`, `error`, `dark`, `light`, `inverted`, or any hexadecimal value.
      */
     iconColor?: string;
     /**
-     * The CSS classes that will be rendered on the item.
-     * Supports the type of values that are supported by [ngClass](link:site.data.urls.angular['ngclassapi']).
+     * Specifies the CSS classes to apply to the item. Supports all value types accepted by [`ngClass`](link:site.data.urls.angular['ngclassapi']).
      */
     cssClass?: any;
     /**
-     * The CSS styles that will be rendered on the item.
-     * Supports the type of values that are supported by [ngStyle](link:site.data.urls.angular['ngstyleapi']).
+     * Specifies the CSS styles to apply to the item. Supports all value types accepted by [`ngStyle`](link:site.data.urls.angular['ngstyleapi']).
      */
     cssStyle?: any;
 }

package/actionsheet/models/animation.d.ts

@@ -3,11 +3,13 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * The settings for the opening and closing animations of the ActionSheet ([see example]({% slug animations_actionsheet %})).
+ * Represents the settings of the opening and closing animations for the ActionSheet ([see example](slug:animations_actionsheet)).
  */
 export interface ActionSheetAnimation {
     /**
-     * Defines the duration of the ActionSheet opening and closing animations in milliseconds.
+     * Specifies the duration of the ActionSheet opening and closing animations in milliseconds.
+     *
+     * @default 300
      */
     duration?: number;
 }

package/actionsheet/models/group.d.ts

@@ -2,4 +2,10 @@
 * Copyright © 2025 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
+/**
+ * Defines the group for an ActionSheet item.
+ *
+ * - `top`—Renders the item above the separator.
+ * - `bottom`—Renders the item below the separator.
+ */
 export type ActionSheetItemGroup = 'top' | 'bottom';

package/actionsheet/models/item-click.event.d.ts

@@ -4,15 +4,17 @@
 *-------------------------------------------------------------------------------------------*/
 import { ActionSheetItem } from './actionsheet-item.interface';
 /**
- * Arguments for the `itemClick` event of the ActionSheet.
+ * Provides the event data for the `itemClick` event of the ActionSheet component.
+ *
+ * Use this event to access the clicked item and the original DOM event.
  */
 export declare class ActionSheetItemClickEvent {
     /**
-     * The ActionSheet item that was clicked.
+     * Provides the ActionSheet item that was clicked.
      */
     item: ActionSheetItem;
     /**
-     * The DOM event that triggered the `itemClick` event.
+     * Represents the original DOM event that triggered the `itemClick` event.
      */
     originalEvent: any;
 }

package/actionsheet/templates/actionsheet-template.d.ts

@@ -5,9 +5,18 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the content of the ActionSheet.
+ * Represents a template for customizing the overall content of the ActionSheet.
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoActionSheetTemplate` directive inside the `<kendo-actionsheet>` tag.
+ *
+ * @example
+ * ```html
+ * <kendo-actionsheet>
+ *   <ng-template kendoActionSheetTemplate>
+ *     <div>Custom ActionSheet content</div>
+ *   </ng-template>
+ * </kendo-actionsheet>
+ * ```
  */
 export declare class ActionSheetTemplateDirective {
     templateRef: TemplateRef<any>;

package/actionsheet/templates/content-template.directive.d.ts

@@ -5,9 +5,18 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the items list content of the ActionSheet.
+ * Represents a template for customizing the list content of the ActionSheet items.
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoActionSheetContentTemplate` directive inside the `<kendo-actionsheet>` tag.
+ *
+ * @example
+ * ```html
+ * <kendo-actionsheet [items]="items">
+ *   <ng-template kendoActionSheetContentTemplate>
+ *     <div>Custom content here</div>
+ *   </ng-template>
+ * </kendo-actionsheet>
+ * ```
  */
 export declare class ActionSheetContentTemplateDirective {
     templateRef: TemplateRef<any>;

package/actionsheet/templates/footer-template.directive.d.ts

@@ -5,9 +5,18 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the footer of the ActionSheet.
+ * Represents a template for customizing the footer of the ActionSheet.
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoActionSheetFooterTemplate` directive inside the `<kendo-actionsheet>` tag.
+ *
+ * @example
+ * ```html
+ * <kendo-actionsheet>
+ *   <ng-template kendoActionSheetFooterTemplate>
+ *     <button kendoButton>Custom Footer Button</button>
+ *   </ng-template>
+ * </kendo-actionsheet>
+ * ```
  */
 export declare class ActionSheetFooterTemplateDirective {
     templateRef: TemplateRef<any>;

package/actionsheet/templates/header-template.directive.d.ts

@@ -5,9 +5,18 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the header content of the ActionSheet. Utilizing the template overrides both the `title` and `subtitle` of the ActionSheet.
+ * Represents a template for customizing the header content of the ActionSheet. If you implement this template, it will override the `title` and `subtitle` of the ActionSheet.
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoActionSheetHeaderTemplate` directive inside the `<kendo-actionsheet>` tag.
+ *
+ * @example
+ * ```html
+ * <kendo-actionsheet>
+ *   <ng-template kendoActionSheetHeaderTemplate>
+ *     <h3>Custom Header</h3>
+ *   </ng-template>
+ * </kendo-actionsheet>
+ * ```
  */
 export declare class ActionSheetHeaderTemplateDirective {
     templateRef: TemplateRef<any>;

package/actionsheet/templates/item-template.directive.d.ts

@@ -5,9 +5,18 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * Represents a template that defines the item content of the ActionSheet.
+ * Represents a template for customizing the content of each ActionSheet item.
  * To define the template, nest an `<ng-template>` tag
  * with the `kendoActionSheetItemTemplate` directive inside the `<kendo-actionsheet>` tag.
+ *
+ * @example
+ * ```html
+ * <kendo-actionsheet [items]="items">
+ *   <ng-template kendoActionSheetItemTemplate let-item>
+ *     <span>{{ item.title }} (custom)</span>
+ *   </ng-template>
+ * </kendo-actionsheet>
+ * ```
  */
 export declare class ActionSheetItemTemplateDirective {
     templateRef: TemplateRef<any>;

package/actionsheet.module.d.ts

@@ -11,35 +11,22 @@ import * as i5 from "./actionsheet/templates/content-template.directive";
 import * as i6 from "./actionsheet/templates/footer-template.directive";
 import * as i7 from "./actionsheet/templates/actionsheet-template";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
+ * Represents the [`NgModule`](link:site.data.urls.angular['ngmoduleapi'])
  * definition for the ActionSheet component.
  *
  * @example
- *
- * ```ts-no-run
- * // Import the ActionSheet module
+ * ```typescript
  * import { ActionSheetModule } from '@progress/kendo-angular-navigation';
- *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
  * import { BrowserModule } from '@angular/platform-browser';
- *
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, ActionSheetModule], // import ActionSheet module
+ * @NgModule({
+ *     declarations: [AppComponent],
+ *     imports:      [BrowserModule, ActionSheetModule],
  *     bootstrap:    [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 export declare class ActionSheetModule {

package/appbar/appbar-section.component.d.ts

@@ -6,20 +6,16 @@ import * as i0 from "@angular/core";
 /**
  * Represents the [Kendo UI AppBarSection component for Angular]({% slug contentarrangement_appbar %}#toc-sections).
  *
- * @example
+ * Use the AppBarSection component to group content, actions, or navigation items within the AppBar.
  *
- * ```ts-no-run
- *  * _@Component({
- *    selector: 'my-app',
- *    template: `
- *        <kendo-appbar>
- *            <kendo-appbar-section>
- *                <h2>Page Title</h2>
- *            </kendo-appbar-section>
- *        </kendo-appbar>
- *    `
- * })
- * class AppComponent {}
+ * @example
+ * ```html
+ * <kendo-appbar>
+ *    <kendo-appbar-section>
+ *         <h2>Page Title</h2>
+ *     </kendo-appbar-section>
+ * </kendo-appbar>
+ * ```
  */
 export declare class AppBarSectionComponent {
     hostClass: boolean;

package/appbar/appbar-spacer.component.d.ts

@@ -6,30 +6,22 @@ import { Renderer2, ElementRef, AfterViewInit } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
  * Represents the [Kendo UI AppBarSpacer component for Angular]({% slug contentarrangement_appbar %}#toc-spacings).
- * Used to give additional white space between the AppBar sections and provides a way for customizing its width.
  *
- * @example
+ * Use the AppBarSpacer component to add white space between AppBar sections and customize its width.
  *
- * ```ts-no-run
- *  * _@Component({
- *    selector: 'my-app',
- *    template: `
- *        <kendo-appbar>
- *            <kendo-appbar-section>
- *                 <button kendoButton fillMode="flat">
- *                     <kendo-icon name="menu"></kendo-icon>
- *                 </button>
- *            </kendo-appbar-section>
+ * @example
+ * ```html
+ * <kendo-appbar>
+ *    <kendo-appbar-section>
+ *        <button kendoButton fillMode="flat" [svgIcon]="menuIcon"></button>
+ *    </kendo-appbar-section>
  *
- *            <kendo-appbar-spacer></kendo-appbar-spacer>
+ *    <kendo-appbar-spacer></kendo-appbar-spacer>
  *
- *            <kendo-appbar-section>
- *                <h2>Page Title</h2>
- *            </kendo-appbar-section>
- *        </kendo-appbar>
- *    `
- * })
- * class AppComponent {}
+ *     <kendo-appbar-section>
+ *          <h2>Page Title</h2>
+ *     </kendo-appbar-section>
+ * </kendo-appbar>
  * ```
  */
 export declare class AppBarSpacerComponent implements AfterViewInit {
@@ -40,7 +32,7 @@ export declare class AppBarSpacerComponent implements AfterViewInit {
     /**
      * Specifies the width of the AppBarSpacer.
      *
-     * If not set, the AppBarSpacer will take all the available space.
+     * If not set, the AppBarSpacer will take all of the available space.
      */
     width: string;
     constructor(renderer: Renderer2, element: ElementRef);

package/appbar/appbar.component.d.ts

@@ -10,7 +10,20 @@ import { AppBarPositionMode } from './models/position-mode';
 import * as i0 from "@angular/core";
 /**
  * Represents the [Kendo UI AppBar component for Angular]({% slug overview_appbar %}).
- * Used to display information, actions, branding titles and additional navigation on the current screen.
+ *
+ * Use the AppBar component to display information, actions, brand titles, and additional navigation on the current screen.
+ *
+ * @example
+ * ```html
+ * <kendo-appbar>
+ *    <kendo-appbar-section>
+ *        <h2>Page Title</h2>
+ *    </kendo-appbar-section>
+ * </kendo-appbar>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link AppBarSectionComponent}, {@link AppBarSpacerComponent}
  */
 export declare class AppBarComponent implements AfterViewInit, OnDestroy {
     private localizationService;
@@ -25,40 +38,21 @@ export declare class AppBarComponent implements AfterViewInit, OnDestroy {
      * Specifies the position of the AppBar
      * ([see example]({% slug positioning_appbar %}#toc-position)).
      *
-     * * The possible values are:
-     * * `top` (Default)&mdash;Positions the AppBar at the top of the content.
-     *    Setting the `position` property to `top` requires adding the Appbar component before the page content.
-     *    The position property applies CSS `top: 0` style in [`fixed mode`](slug:api_navigation_appbarcomponent#toc-positionmode) and also adds a `box-shadow` to the bottom of the AppBar.
-     *
-     * * `bottom`&mdash;Positions the AppBar at the bottom of the content.
-     *    Setting the `position` property to `bottom` requires adding the Appbar component after the page content.
-     *   The position property applies CSS `bottom: 0` style in [`fixed mode`](slug:api_navigation_appbarcomponent#toc-positionmode) and also adds a `box-shadow ` to the top of the AppBar.
-     *
+     * @default 'top'
      */
     set position(position: AppBarPosition);
     get position(): AppBarPosition;
     /**
-     * Specifies the positionMode of the AppBar
-     * ([see example](slug:positioning_appbar#toc-position-mode)).
+     * Sets the position mode of the AppBar ([see example](slug:positioning_appbar#toc-position-mode)).
      *
-     * * The possible values are:
-     * * `static` (Default)&mdash;Does not position the AppBar in any special way. It is positioned according to the normal flow of the page.
-     * * `sticky`&mdash;Positions the AppBar based on the user's scroll position. A sticky element toggles between static and fixed CSS [`position`](https://developer.mozilla.org/en-US/docs/Web/CSS/position) property, depending on the scroll position.
-     * * `fixed`&mdash;Positions the AppBar relative to the viewport. It always stays in the same place even if the page is scrolled.
+     * @default 'static'
      */
     set positionMode(positionMode: AppBarPositionMode);
     get positionMode(): AppBarPositionMode;
     /**
-     * Specifies the theme color of the AppBar.
-     * The theme color will be applied as background color of the component.
-     *
-     *
-     * * The possible values are:
-     * * `light` (Default)&mdash;Applies coloring based on light theme color.
-     * * `dark`&mdash;Applies coloring based on dark theme color.
-     * * `inherit`&mdash; Applies inherited coloring value.
-     * * `primary`&mdash; Applies primary coloring value.
+     * Sets the theme color of the AppBar. The theme color is applied as the background color of the component.
      *
+     * @default 'light'
      */
     set themeColor(themeColor: AppBarThemeColor);
     get themeColor(): AppBarThemeColor;