@breadstone/mosaik-elements-foundation 0.0.147 → 0.0.149

package/Controls/Components/Selectors/DataTable/DataTableElement.js

@@ -24,9 +24,89 @@ import { TableRowElement } from '../Table/TableRowElement';
 import { Themeable } from '../../../Behaviors/Themeable';
 // #endregion
 /**
- * Data Table - A structured representation of tabular data, often used to display data in rows and columns.
+ * DataTable - A comprehensive data presentation component for displaying structured information in rows and columns.
  *
+ * Provides advanced data table functionality including sorting, filtering, pagination, and selection
+ * capabilities. Designed for displaying large datasets with efficient rendering and user interaction
+ * features for data analysis and management tasks.
+ *
+ * @name DataTableElement
  * @element mosaik-data-table
+ * @category Selectors
+ *
+ * @slot - Default content area for custom table content and additional elements
+ * @slot header - Table header area for titles, filters, and actions
+ * @slot footer - Table footer area for pagination, totals, and summary information
+ *
+ * @csspart table - Main table container element
+ * @csspart header - Table header section
+ * @csspart body - Table body containing data rows
+ * @csspart footer - Table footer section
+ * @csspart row - Individual table row
+ * @csspart cell - Individual table cell
+ * @csspart sort-button - Sortable column header buttons
+ * @csspart pagination - Pagination controls container
+ *
+ * @cssprop --data-table-border-color - Color for table borders and grid lines
+ * @cssprop --data-table-header-background - Background color for table headers
+ * @cssprop --data-table-row-background - Background color for table rows
+ * @cssprop --data-table-row-background-hover - Hover state background for rows
+ * @cssprop --data-table-row-background-selected - Selected row background color
+ * @cssprop --data-table-cell-padding - Internal padding for table cells
+ * @cssprop --data-table-header-font-weight - Font weight for header text
+ *
+ * @dependency TableElement - Base table structure and layout
+ * @dependency TableHeaderElement - For table header rows and column definitions
+ * @dependency TableRowElement - For data rows and content presentation
+ * @dependency TableCellElement - For individual data cells and content
+ *
+ * @example
+ * ```html
+ * <!-- Basic data table with auto-generated columns -->
+ * <mosaik-data-table
+ *   items='[
+ *     {"id": 1, "name": "John Doe", "email": "john@example.com", "role": "Admin"},
+ *     {"id": 2, "name": "Jane Smith", "email": "jane@example.com", "role": "User"}
+ *   ]'
+ *   auto-generate-columns="true"
+ *   sortable="true">
+ * </mosaik-data-table>
+ *
+ * <!-- Data table with custom column definitions -->
+ * <mosaik-data-table
+ *   items="users"
+ *   selectable="true"
+ *   paginated="true"
+ *   page-size="25">
+ *   <div slot="header">
+ *     <mosaik-text variant="headline">User Management</mosaik-text>
+ *     <mosaik-button onclick="addUser()">Add User</mosaik-button>
+ *   </div>
+ * </mosaik-data-table>
+ *
+ * <!-- Data table with filtering and actions -->
+ * <mosaik-data-table
+ *   items="products"
+ *   alternating="true"
+ *   multi-select="true"
+ *   searchable="true">
+ *   <div slot="header">
+ *     <mosaik-search-box placeholder="Search products..." onInput="filterProducts"></mosaik-search-box>
+ *     <div class="table-actions">
+ *       <mosaik-button appearance="soft">Export</mosaik-button>
+ *       <mosaik-button appearance="primary">Bulk Edit</mosaik-button>
+ *     </div>
+ *   </div>
+ *   <div slot="footer">
+ *     <mosaik-text variant="caption">Showing 1-25 of 150 products</mosaik-text>
+ *   </div>
+ * </mosaik-data-table>
+ *
+ * <!-- Data table with custom cell renderers -->
+ * <mosaik-data-table items="orders" expandable-rows="true">
+ *   <!-- Custom column templates would be defined via column definitions -->
+ * </mosaik-data-table>
+ * ```
  *
  * @public
  */
@@ -184,12 +264,18 @@ let DataTableElement = class DataTableElement extends Themeable(Disableable(Item
     }
 };
 __decorate([
-    Attribute({ type: Boolean, useDefault: true }),
+    Attribute({
+        type: Boolean,
+        useDefault: true
+    }),
     __metadata("design:type", Boolean),
     __metadata("design:paramtypes", [Boolean])
 ], DataTableElement.prototype, "alternating", null);
 __decorate([
-    Attribute({ type: Boolean, useDefault: true }),
+    Attribute({
+        type: Boolean,
+        useDefault: true
+    }),
     __metadata("design:type", Boolean),
     __metadata("design:paramtypes", [Boolean])
 ], DataTableElement.prototype, "autoGenerateColumns", null);
@@ -199,7 +285,10 @@ __decorate([
     __metadata("design:paramtypes", [Array])
 ], DataTableElement.prototype, "columnDefinitions", null);
 __decorate([
-    Attribute({ type: Boolean, useDefault: true }),
+    Attribute({
+        type: Boolean,
+        useDefault: true
+    }),
     __metadata("design:type", Boolean),
     __metadata("design:paramtypes", [])
 ], DataTableElement.prototype, "sorted", null);

package/Controls/Components/Selectors/DataTable/DataTableElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataTableElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/DataTable/DataTableElement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DataTableElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/DataTable/DataTableElement.ts"],"names":[],"mappings":"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"}

package/Controls/Components/Selectors/List/ListElement.d.ts

@@ -5,14 +5,104 @@ import { ListItemElement } from './ListItemElement';
 import { ListElementIntl } from './ListElementIntl';
 declare const ListElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Disableable").IDisableableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Filterable").IFilterableProps) & (abstract new () => SelectorElement<any>) & import("../../../Behaviors/Themeable").IThemeableCtor;
 /**
- * List - A container for displaying a collection of related items in a vertical or horizontal layout. Lists are often used to present data, navigation options, or other grouped content.
+ * List - A versatile container component for displaying collections of interactive items in organized layouts.
  *
+ * Presents ordered or unordered collections of related content items with support for selection,
+ * filtering, grouping, and navigation. Optimized for accessibility and keyboard interaction
+ * with flexible styling options for various content types.
+ *
+ * @name ListElement
  * @element mosaik-list
- * @category Selector
+ * @category Selectors
+ *
+ * @slot - Default content area for list items and groups
+ * @slot filter - Filter controls and search functionality area
+ * @slot empty - Empty state content when no items are available
+ * @slot header - Header content above the list items
+ * @slot footer - Footer content below the list items
+ *
+ * @csspart container - Main list container element
+ * @csspart items - Container for all list items
+ * @csspart filter - Filter controls container
+ * @csspart empty-state - Empty state container
+ * @csspart scrollable - Scrollable content area
+ *
+ * @cssprop --list-padding - Internal padding for the list container
+ * @cssprop --list-item-spacing - Vertical spacing between list items
+ * @cssprop --list-background - Background color for the list
+ * @cssprop --list-border-radius - Border radius for list styling
+ * @cssprop --list-max-height - Maximum height before scrolling activates
+ * @cssprop --list-scrollbar-width - Width of the scrollbar
+ *
+ * @keyhandle ArrowUp - Navigates to the previous item
+ * @keyhandle ArrowDown - Navigates to the next item
+ * @keyhandle Home - Navigates to the first item
+ * @keyhandle End - Navigates to the last item
+ * @keyhandle Space - Toggles selection of the focused item
+ * @keyhandle Enter - Activates the focused item
+ *
+ * @dependency ListItemElement - For individual selectable items within the list
+ * @dependency ListItemGroupElement - For organizing items into logical groups
+ * @dependency TextBoxElement - For search and filter functionality
+ * @dependency SpacerElement - For layout spacing between groups
+ *
+ * @example
+ * ```html
+ * <!-- Simple navigation list -->
+ * <mosaik-list>
+ *   <mosaik-list-item value="dashboard">
+ *     <mosaik-icon slot="prefix" data="home"></mosaik-icon>
+ *     Dashboard
+ *   </mosaik-list-item>
+ *   <mosaik-list-item value="analytics">
+ *     <mosaik-icon slot="prefix" data="chart-bar"></mosaik-icon>
+ *     Analytics
+ *   </mosaik-list-item>
+ *   <mosaik-list-item value="settings">
+ *     <mosaik-icon slot="prefix" data="cog"></mosaik-icon>
+ *     Settings
+ *   </mosaik-list-item>
+ * </mosaik-list>
+ *
+ * <!-- Multi-select list with filtering -->
+ * <mosaik-list selection-mode="multiple" filterable="true">
+ *   <mosaik-text-box slot="filter" placeholder="Search contacts..." />
+ *   <mosaik-list-item-group label="Favorites">
+ *     <mosaik-list-item value="john">
+ *       <mosaik-avatar slot="prefix" src="john.jpg"></mosaik-avatar>
+ *       John Smith
+ *       <mosaik-text slot="suffix">john@example.com</mosaik-text>
+ *     </mosaik-list-item>
+ *   </mosaik-list-item-group>
+ *   <mosaik-list-item-group label="Colleagues">
+ *     <mosaik-list-item value="jane">Jane Doe</mosaik-list-item>
+ *     <mosaik-list-item value="mike">Mike Johnson</mosaik-list-item>
+ *   </mosaik-list-item-group>
+ * </mosaik-list>
+ *
+ * <!-- Action list with descriptions -->
+ * <mosaik-list>
+ *   <mosaik-list-item value="export">
+ *     <mosaik-icon slot="prefix" data="download"></mosaik-icon>
+ *     Export Data
+ *     <mosaik-text slot="suffix" variant="caption">Download your data as CSV</mosaik-text>
+ *   </mosaik-list-item>
+ *   <mosaik-list-item value="import">
+ *     <mosaik-icon slot="prefix" data="upload"></mosaik-icon>
+ *     Import Data
+ *     <mosaik-text slot="suffix" variant="caption">Upload data from file</mosaik-text>
+ *   </mosaik-list-item>
+ * </mosaik-list>
  *
- * @slot - The default slot.
- * @slot filter - The filter slot.
- * @slot empty - The empty slot.
+ * <!-- List with empty state -->
+ * <mosaik-list>
+ *   <mosaik-empty-state slot="empty">
+ *     <mosaik-icon slot="icon" data="inbox"></mosaik-icon>
+ *     <mosaik-text slot="header">No items found</mosaik-text>
+ *     <mosaik-text slot="content">Add some items to get started</mosaik-text>
+ *   </mosaik-empty-state>
+ * </mosaik-list>
+ * ```
  *
  * @public
  */

package/Controls/Components/Selectors/List/ListElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ListElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/List/ListElement.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;;AAMpD;;;;;;;;;;;GAWG;AACH,qBAmBa,WACT,SAAQ,gBACR,YAAW,iBAAiB;IAI5B,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAoC;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAClE,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,MAAM,CAAgB;IAM9B;;OAEG;;IAgBH;;;;;;;;OAQG;IAGH,WAA2B,EAAE,IAAI,MAAM,CAEtC;IAED;;;;;OAKG;IACH,IACW,aAAa,IAAI,aAAa,CAExC;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,aAAa,EAK5C;IAED;;;;;OAKG;IACH,IACW,KAAK,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAKpC;IAED;;;;;OAKG;IACH,IAAoB,KAAK,IAAI,KAAK,CAAC,eAAe,CAAC,CAIlD;IAED;;;;;OAKG;IACH,IAAW,IAAI,IAAI,eAAe,CAEjC;IAMD;;;OAGG;cACgB,cAAc,IAAI,IAAI;IAuBzC;;OAEG;IAEH,SAAS,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI;IAS1F;;OAEG;IAEH,SAAS,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAItE;;OAEG;IAEH,SAAS,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBlE;;OAEG;IACH,OAAO,CAAC,YAAY;CAcvB;AAED;;GAEG;AACH,yBAAiB,WAAW,CAAC;IACzB,KAAY,KAAK,GAAG,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,qBAAqB;QAE3B,aAAa,EAAE,WAAW,CAAC;KAC9B;CACJ"}
+{"version":3,"file":"ListElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/List/ListElement.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;;AAMpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqGG;AACH,qBAmBa,WACT,SAAQ,gBACR,YAAW,iBAAiB;IAI5B,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAoC;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAClE,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,MAAM,CAAgB;IAM9B;;OAEG;;IAgBH;;;;;;;;OAQG;IAGH,WAA2B,EAAE,IAAI,MAAM,CAEtC;IAED;;;;;OAKG;IACH,IACW,aAAa,IAAI,aAAa,CAExC;IAED,IAAW,aAAa,CAAC,KAAK,EAAE,aAAa,EAK5C;IAED;;;;;OAKG;IACH,IACW,KAAK,IAAI,MAAM,GAAG,IAAI,CAEhC;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAKpC;IAED;;;;;OAKG;IACH,IAAoB,KAAK,IAAI,KAAK,CAAC,eAAe,CAAC,CAIlD;IAED;;;;;OAKG;IACH,IAAW,IAAI,IAAI,eAAe,CAEjC;IAMD;;;OAGG;cACgB,cAAc,IAAI,IAAI;IAuBzC;;OAEG;IAEH,SAAS,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI;IAS1F;;OAEG;IAEH,SAAS,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAItE;;OAEG;IAEH,SAAS,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBlE;;OAEG;IACH,OAAO,CAAC,YAAY;CAcvB;AAED;;GAEG;AACH,yBAAiB,WAAW,CAAC;IACzB,KAAY,KAAK,GAAG,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,qBAAqB;QAE3B,aAAa,EAAE,WAAW,CAAC;KAC9B;CACJ"}

package/Controls/Components/Selectors/List/ListElement.js

@@ -29,14 +29,104 @@ import { IntlController } from '../../../../Intl/IntlController';
 import { SpacerElement } from '../../Primitives/Spacer/SpacerElement';
 // #endregion
 /**
- * List - A container for displaying a collection of related items in a vertical or horizontal layout. Lists are often used to present data, navigation options, or other grouped content.
+ * List - A versatile container component for displaying collections of interactive items in organized layouts.
  *
+ * Presents ordered or unordered collections of related content items with support for selection,
+ * filtering, grouping, and navigation. Optimized for accessibility and keyboard interaction
+ * with flexible styling options for various content types.
+ *
+ * @name ListElement
  * @element mosaik-list
- * @category Selector
+ * @category Selectors
+ *
+ * @slot - Default content area for list items and groups
+ * @slot filter - Filter controls and search functionality area
+ * @slot empty - Empty state content when no items are available
+ * @slot header - Header content above the list items
+ * @slot footer - Footer content below the list items
+ *
+ * @csspart container - Main list container element
+ * @csspart items - Container for all list items
+ * @csspart filter - Filter controls container
+ * @csspart empty-state - Empty state container
+ * @csspart scrollable - Scrollable content area
+ *
+ * @cssprop --list-padding - Internal padding for the list container
+ * @cssprop --list-item-spacing - Vertical spacing between list items
+ * @cssprop --list-background - Background color for the list
+ * @cssprop --list-border-radius - Border radius for list styling
+ * @cssprop --list-max-height - Maximum height before scrolling activates
+ * @cssprop --list-scrollbar-width - Width of the scrollbar
+ *
+ * @keyhandle ArrowUp - Navigates to the previous item
+ * @keyhandle ArrowDown - Navigates to the next item
+ * @keyhandle Home - Navigates to the first item
+ * @keyhandle End - Navigates to the last item
+ * @keyhandle Space - Toggles selection of the focused item
+ * @keyhandle Enter - Activates the focused item
+ *
+ * @dependency ListItemElement - For individual selectable items within the list
+ * @dependency ListItemGroupElement - For organizing items into logical groups
+ * @dependency TextBoxElement - For search and filter functionality
+ * @dependency SpacerElement - For layout spacing between groups
+ *
+ * @example
+ * ```html
+ * <!-- Simple navigation list -->
+ * <mosaik-list>
+ *   <mosaik-list-item value="dashboard">
+ *     <mosaik-icon slot="prefix" data="home"></mosaik-icon>
+ *     Dashboard
+ *   </mosaik-list-item>
+ *   <mosaik-list-item value="analytics">
+ *     <mosaik-icon slot="prefix" data="chart-bar"></mosaik-icon>
+ *     Analytics
+ *   </mosaik-list-item>
+ *   <mosaik-list-item value="settings">
+ *     <mosaik-icon slot="prefix" data="cog"></mosaik-icon>
+ *     Settings
+ *   </mosaik-list-item>
+ * </mosaik-list>
+ *
+ * <!-- Multi-select list with filtering -->
+ * <mosaik-list selection-mode="multiple" filterable="true">
+ *   <mosaik-text-box slot="filter" placeholder="Search contacts..." />
+ *   <mosaik-list-item-group label="Favorites">
+ *     <mosaik-list-item value="john">
+ *       <mosaik-avatar slot="prefix" src="john.jpg"></mosaik-avatar>
+ *       John Smith
+ *       <mosaik-text slot="suffix">john@example.com</mosaik-text>
+ *     </mosaik-list-item>
+ *   </mosaik-list-item-group>
+ *   <mosaik-list-item-group label="Colleagues">
+ *     <mosaik-list-item value="jane">Jane Doe</mosaik-list-item>
+ *     <mosaik-list-item value="mike">Mike Johnson</mosaik-list-item>
+ *   </mosaik-list-item-group>
+ * </mosaik-list>
+ *
+ * <!-- Action list with descriptions -->
+ * <mosaik-list>
+ *   <mosaik-list-item value="export">
+ *     <mosaik-icon slot="prefix" data="download"></mosaik-icon>
+ *     Export Data
+ *     <mosaik-text slot="suffix" variant="caption">Download your data as CSV</mosaik-text>
+ *   </mosaik-list-item>
+ *   <mosaik-list-item value="import">
+ *     <mosaik-icon slot="prefix" data="upload"></mosaik-icon>
+ *     Import Data
+ *     <mosaik-text slot="suffix" variant="caption">Upload data from file</mosaik-text>
+ *   </mosaik-list-item>
+ * </mosaik-list>
  *
- * @slot - The default slot.
- * @slot filter - The filter slot.
- * @slot empty - The empty slot.
+ * <!-- List with empty state -->
+ * <mosaik-list>
+ *   <mosaik-empty-state slot="empty">
+ *     <mosaik-icon slot="icon" data="inbox"></mosaik-icon>
+ *     <mosaik-text slot="header">No items found</mosaik-text>
+ *     <mosaik-text slot="content">Add some items to get started</mosaik-text>
+ *   </mosaik-empty-state>
+ * </mosaik-list>
+ * ```
  *
  * @public
  */

package/Controls/Components/Selectors/List/ListElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"ListElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/List/ListElement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ListElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/List/ListElement.ts"],"names":[],"mappings":"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"}

package/Controls/Components/Selectors/Menu/MenuElement.d.ts

@@ -3,11 +3,70 @@ import { CustomElement } from '../../Abstracts/CustomElement';
 import type { IMenuElementProps } from './IMenuElementProps';
 declare const MenuElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Disableable").IDisableableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Insetable").IInsetableProps) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
 /**
- * Menu - A list of options or actions presented to users.
+ * Menu - A vertical list container for presenting navigation options and actionable commands.
  *
+ * Provides structured menu layouts with support for menu items, dividers, and hierarchical organization.
+ * Handles selection states, keyboard navigation, and accessibility features. Essential for context menus,
+ * navigation menus, and dropdown command lists.
+ *
+ * @name MenuElement
  * @element mosaik-menu
+ * @category Selectors
+ *
+ * @csspart menu - The main menu container element
+ * @csspart menu-list - Container for menu items and content
+ *
+ * @cssprop --menu-background-color - Background color of the menu container
+ * @cssprop --menu-border-color - Border color around the menu
+ * @cssprop --menu-border-radius - Border radius for menu corners
+ * @cssprop --menu-padding - Internal padding of the menu
+ * @cssprop --menu-min-width - Minimum width constraint for the menu
+ * @cssprop --menu-max-height - Maximum height before scrolling
+ * @cssprop --menu-item-height - Standard height for menu items
+ * @cssprop --menu-divider-color - Color of menu section dividers
+ *
+ * @example
+ * ```html
+ * <!-- Basic context menu -->
+ * <mosaik-menu>
+ *   <mosaik-menu-item>Cut</mosaik-menu-item>
+ *   <mosaik-menu-item>Copy</mosaik-menu-item>
+ *   <mosaik-menu-item>Paste</mosaik-menu-item>
+ *   <mosaik-divider></mosaik-divider>
+ *   <mosaik-menu-item disabled>Delete</mosaik-menu-item>
+ * </mosaik-menu>
+ *
+ * <!-- Navigation menu with icons -->
+ * <mosaik-menu>
+ *   <mosaik-menu-item selected>
+ *     <mosaik-icon slot="prefix" data="home"></mosaik-icon>
+ *     Home
+ *   </mosaik-menu-item>
+ *   <mosaik-menu-item>
+ *     <mosaik-icon slot="prefix" data="user"></mosaik-icon>
+ *     Profile
+ *   </mosaik-menu-item>
+ *   <mosaik-menu-item>
+ *     <mosaik-icon slot="prefix" data="settings"></mosaik-icon>
+ *     Settings
+ *   </mosaik-menu-item>
+ * </mosaik-menu>
+ *
+ * <!-- Hierarchical menu with submenus -->
+ * <mosaik-menu>
+ *   <mosaik-menu-item>File</mosaik-menu-item>
+ *   <mosaik-menu-item>
+ *     Edit
+ *     <mosaik-menu slot="submenu">
+ *       <mosaik-menu-item>Undo</mosaik-menu-item>
+ *       <mosaik-menu-item>Redo</mosaik-menu-item>
+ *     </mosaik-menu>
+ *   </mosaik-menu-item>
+ *   <mosaik-menu-item>View</mosaik-menu-item>
+ * </mosaik-menu>
+ * ```
  *
- * @fires activated - Called when the element is activated.
+ * @fires activated - Emitted when a menu item is activated or selected
  *
  * @public
  */

package/Controls/Components/Selectors/Menu/MenuElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MenuElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/Menu/MenuElement.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2B,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAInG,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;;AAS7D;;;;;;;;GAQG;AACH,qBAUa,WACT,SAAQ,gBACR,YAAW,iBAAiB;IAI5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAM/D;;OAEG;;IAWH;;;;;;;OAOG;IACH,WAAkB,EAAE,IAAI,MAAM,CAE7B;IAED;;;;;;;OAOG;IACH,IACW,SAAS,IAAI,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAExD;IAMD;;;OAGG;IACI,YAAY,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;CAYtC;AAED;;GAEG;AACH,yBAAiB,WAAW,CAAC;IACzB,KAAY,KAAK,GAAG,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,aAAa,EAAE,WAAW,CAAC;KAC9B;IAED,UAAU,mBAAmB;QACzB,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;KACxC;CACJ"}
+{"version":3,"file":"MenuElement.d.ts","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/Menu/MenuElement.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2B,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAInG,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;;AAS7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,qBAUa,WACT,SAAQ,gBACR,YAAW,iBAAiB;IAI5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAM/D;;OAEG;;IAWH;;;;;;;OAOG;IACH,WAAkB,EAAE,IAAI,MAAM,CAE7B;IAED;;;;;;;OAOG;IACH,IACW,SAAS,IAAI,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAExD;IAMD;;;OAGG;IACI,YAAY,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;CAYtC;AAED;;GAEG;AACH,yBAAiB,WAAW,CAAC;IACzB,KAAY,KAAK,GAAG,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,aAAa,EAAE,WAAW,CAAC;KAC9B;IAED,UAAU,mBAAmB;QACzB,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;KACxC;CACJ"}

package/Controls/Components/Selectors/Menu/MenuElement.js

@@ -21,11 +21,70 @@ import { menuElementCosmopolitanStyle } from './Themes/MenuElement.Cosmopolitan'
 import { Themeable } from '../../../Behaviors/Themeable';
 // #endregion
 /**
- * Menu - A list of options or actions presented to users.
+ * Menu - A vertical list container for presenting navigation options and actionable commands.
  *
+ * Provides structured menu layouts with support for menu items, dividers, and hierarchical organization.
+ * Handles selection states, keyboard navigation, and accessibility features. Essential for context menus,
+ * navigation menus, and dropdown command lists.
+ *
+ * @name MenuElement
  * @element mosaik-menu
+ * @category Selectors
+ *
+ * @csspart menu - The main menu container element
+ * @csspart menu-list - Container for menu items and content
+ *
+ * @cssprop --menu-background-color - Background color of the menu container
+ * @cssprop --menu-border-color - Border color around the menu
+ * @cssprop --menu-border-radius - Border radius for menu corners
+ * @cssprop --menu-padding - Internal padding of the menu
+ * @cssprop --menu-min-width - Minimum width constraint for the menu
+ * @cssprop --menu-max-height - Maximum height before scrolling
+ * @cssprop --menu-item-height - Standard height for menu items
+ * @cssprop --menu-divider-color - Color of menu section dividers
+ *
+ * @example
+ * ```html
+ * <!-- Basic context menu -->
+ * <mosaik-menu>
+ *   <mosaik-menu-item>Cut</mosaik-menu-item>
+ *   <mosaik-menu-item>Copy</mosaik-menu-item>
+ *   <mosaik-menu-item>Paste</mosaik-menu-item>
+ *   <mosaik-divider></mosaik-divider>
+ *   <mosaik-menu-item disabled>Delete</mosaik-menu-item>
+ * </mosaik-menu>
+ *
+ * <!-- Navigation menu with icons -->
+ * <mosaik-menu>
+ *   <mosaik-menu-item selected>
+ *     <mosaik-icon slot="prefix" data="home"></mosaik-icon>
+ *     Home
+ *   </mosaik-menu-item>
+ *   <mosaik-menu-item>
+ *     <mosaik-icon slot="prefix" data="user"></mosaik-icon>
+ *     Profile
+ *   </mosaik-menu-item>
+ *   <mosaik-menu-item>
+ *     <mosaik-icon slot="prefix" data="settings"></mosaik-icon>
+ *     Settings
+ *   </mosaik-menu-item>
+ * </mosaik-menu>
+ *
+ * <!-- Hierarchical menu with submenus -->
+ * <mosaik-menu>
+ *   <mosaik-menu-item>File</mosaik-menu-item>
+ *   <mosaik-menu-item>
+ *     Edit
+ *     <mosaik-menu slot="submenu">
+ *       <mosaik-menu-item>Undo</mosaik-menu-item>
+ *       <mosaik-menu-item>Redo</mosaik-menu-item>
+ *     </mosaik-menu>
+ *   </mosaik-menu-item>
+ *   <mosaik-menu-item>View</mosaik-menu-item>
+ * </mosaik-menu>
+ * ```
  *
- * @fires activated - Called when the element is activated.
+ * @fires activated - Emitted when a menu item is activated or selected
  *
  * @public
  */

package/Controls/Components/Selectors/Menu/MenuElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"MenuElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/Menu/MenuElement.ts"],"names":[],"mappings":"AAAA,kBAAkB;;;;;;;;;;AAElB,OAAO,EAAE,IAAI,EAAE,MAAM,6CAA6C,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAA+B,MAAM,6BAA6B,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,aAAa;AAEb;;;;;;;;GAQG;AAWI,IAAM,WAAW,GAAjB,MAAM,WACT,SAAQ,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAGxD,iBAAiB;IAEA,UAAU,CAAoC;IAE/D,aAAa;IAEb,eAAe;IAEf;;OAEG;IACH;QACI,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAuB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrE,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB;;;;;;;OAOG;IACI,MAAM,KAAK,EAAE;QAChB,OAAO,aAAa,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,IACW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;OAGG;IACI,YAAY,CAAC,CAAQ;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAyB,CAAC;QAE3C,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;CAIJ,CAAA;AAzBG;IAAC,IAAI,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;;;4CAGhC;AAhDQ,WAAW;IAVvB,SAAS,CAAC;QACP,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,mBAAmB;QAC7B,MAAM,EAAE;YACJ,GAAG,EAAE,mBAAmB;YACxB,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,4BAA4B;SAC7C;QACD,OAAO,EAAE,EAAE;KACd,CAAC;;GACW,WAAW,CAsEvB"}
+{"version":3,"file":"MenuElement.js","sourceRoot":"","sources":["../../../../../src/Controls/Components/Selectors/Menu/MenuElement.ts"],"names":[],"mappings":"AAAA,kBAAkB;;;;;;;;;;AAElB,OAAO,EAAE,IAAI,EAAE,MAAM,6CAA6C,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAA+B,MAAM,6BAA6B,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,aAAa;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAWI,IAAM,WAAW,GAAjB,MAAM,WACT,SAAQ,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAGxD,iBAAiB;IAEA,UAAU,CAAoC;IAE/D,aAAa;IAEb,eAAe;IAEf;;OAEG;IACH;QACI,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAuB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrE,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB;;;;;;;OAOG;IACI,MAAM,KAAK,EAAE;QAChB,OAAO,aAAa,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,IACW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;OAGG;IACI,YAAY,CAAC,CAAQ;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAyB,CAAC;QAE3C,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;CAIJ,CAAA;AAzBG;IAAC,IAAI,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;;;4CAGhC;AAhDQ,WAAW;IAVvB,SAAS,CAAC;QACP,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,mBAAmB;QAC7B,MAAM,EAAE;YACJ,GAAG,EAAE,mBAAmB;YACxB,KAAK,EAAE,qBAAqB;YAC5B,YAAY,EAAE,4BAA4B;SAC7C;QACD,OAAO,EAAE,EAAE;KACd,CAAC;;GACW,WAAW,CAsEvB"}

package/Controls/Components/Selectors/TabStrip/TabStripElement.d.ts

@@ -8,7 +8,78 @@ import { ITabStripElementProps } from './ITabStripElementProps';
 import { TabStripItemElement } from './TabStripItemElement';
 declare const TabStripElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Slottable").ISlottableProps & ISlottable) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Disableable").IDisableableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Variantable").IVariantableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/Appearanceable").IAppearanceableProps) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
 /**
- * Tab Strip - A navigation element used to switch between different sections of content.
+ * TabStrip - A navigation container for organizing and switching between related content panels.
+ *
+ * Provides tab-based navigation with keyboard support, visual indicators, and flexible placement options.
+ * Manages tab selection states and coordinates with tab panel content. Essential for organizing
+ * complex interfaces with multiple related views or data sets.
+ *
+ * @name TabStripElement
+ * @element mosaik-tab-strip
+ * @category Selectors
+ *
+ * @csspart tab-strip - The main tab strip container
+ * @csspart tab-list - Container for the tab buttons
+ * @csspart indicator - Active tab indicator element
+ * @csspart overflow - Overflow controls for scrollable tabs
+ *
+ * @cssprop --tab-strip-background-color - Background color of the tab strip
+ * @cssprop --tab-strip-border-color - Border color for tab strip edges
+ * @cssprop --tab-strip-gap - Spacing between individual tabs
+ * @cssprop --tab-strip-padding - Internal padding of the tab strip
+ * @cssprop --tab-indicator-color - Color of the active tab indicator
+ * @cssprop --tab-indicator-height - Height of the tab indicator bar
+ * @cssprop --tab-selected-background - Background color of selected tabs
+ * @cssprop --tab-hover-background - Background color on tab hover
+ *
+ * @dependency InkBarElement - Provides the active tab indicator animation
+ *
+ * @example
+ * ```html
+ * <!-- Basic horizontal tab strip -->
+ * <mosaik-tab-strip>
+ *   <mosaik-tab-strip-item selected>Overview</mosaik-tab-strip-item>
+ *   <mosaik-tab-strip-item>Details</mosaik-tab-strip-item>
+ *   <mosaik-tab-strip-item>Settings</mosaik-tab-strip-item>
+ * </mosaik-tab-strip>
+ *
+ * <!-- Tab strip with indicator -->
+ * <mosaik-tab-strip has-indicator placement="top">
+ *   <mosaik-tab-strip-item>Dashboard</mosaik-tab-strip-item>
+ *   <mosaik-tab-strip-item>Analytics</mosaik-tab-strip-item>
+ *   <mosaik-tab-strip-item>Reports</mosaik-tab-strip-item>
+ *   <mosaik-tab-strip-item disabled>Admin</mosaik-tab-strip-item>
+ * </mosaik-tab-strip>
+ *
+ * <!-- Vertical tab navigation -->
+ * <div class="app-layout">
+ *   <mosaik-tab-strip placement="left" has-indicator>
+ *     <mosaik-tab-strip-item selected>
+ *       <mosaik-icon slot="icon" data="home"></mosaik-icon>
+ *       Home
+ *     </mosaik-tab-strip-item>
+ *     <mosaik-tab-strip-item>
+ *       <mosaik-icon slot="icon" data="user"></mosaik-icon>
+ *       Profile
+ *     </mosaik-tab-strip-item>
+ *     <mosaik-tab-strip-item>
+ *       <mosaik-icon slot="icon" data="settings"></mosaik-icon>
+ *       Settings
+ *     </mosaik-tab-strip-item>
+ *   </mosaik-tab-strip>
+ *   <div class="content-area">
+ *     <!-- Tab panel content -->
+ *   </div>
+ * </div>
+ *
+ * <!-- Scrollable tab strip for many tabs -->
+ * <mosaik-tab-strip variant="scrollable">
+ *   <mosaik-tab-strip-item>Tab 1</mosaik-tab-strip-item>
+ *   <mosaik-tab-strip-item>Tab 2</mosaik-tab-strip-item>
+ *   <mosaik-tab-strip-item>Tab 3</mosaik-tab-strip-item>
+ *   <!-- More tabs... -->
+ * </mosaik-tab-strip>
+ * ```
  *
  * @public
  */