material 3.2.6 → 3.3.0

package/dist/components/tooltip/constants.d.ts

@@ -1,106 +1,48 @@
-/**
- * Tooltip positions
- * @category Components
- */
 export declare const TOOLTIP_POSITIONS: {
-    /** Position above the target element */
     readonly TOP: "top";
-    /** Position to the right of the target element */
     readonly RIGHT: "right";
-    /** Position below the target element */
     readonly BOTTOM: "bottom";
-    /** Position to the left of the target element */
     readonly LEFT: "left";
-    /** Position above and aligned to the start of the target */
     readonly TOP_START: "top-start";
-    /** Position above and aligned to the end of the target */
     readonly TOP_END: "top-end";
-    /** Position to the right and aligned to the start of the target */
     readonly RIGHT_START: "right-start";
-    /** Position to the right and aligned to the end of the target */
     readonly RIGHT_END: "right-end";
-    /** Position below and aligned to the start of the target */
     readonly BOTTOM_START: "bottom-start";
-    /** Position below and aligned to the end of the target */
     readonly BOTTOM_END: "bottom-end";
-    /** Position to the left and aligned to the start of the target */
     readonly LEFT_START: "left-start";
-    /** Position to the left and aligned to the end of the target */
     readonly LEFT_END: "left-end";
 };
-/**
- * Tooltip visual variants
- * @category Components
- */
 export declare const TOOLTIP_VARIANTS: {
-    /** Standard tooltip with background and arrow */
     readonly DEFAULT: "default";
-    /** Rich tooltip with support for HTML content */
     readonly RICH: "rich";
-    /** Plain text tooltip with minimal styling */
     readonly PLAIN: "plain";
 };
-/**
- * Tooltip events
- * @category Components
- */
 export declare const TOOLTIP_EVENTS: {
-    /** Fired when tooltip becomes visible */
     readonly SHOW: "show";
-    /** Fired when tooltip becomes hidden */
     readonly HIDE: "hide";
-    /** Fired when mouse enters target element */
     readonly ENTER: "enter";
-    /** Fired when mouse leaves target element */
     readonly LEAVE: "leave";
 };
-/**
- * Default configuration values for tooltip
- * @category Components
- */
 export declare const TOOLTIP_DEFAULTS: {
-    /** Default tooltip position */
     readonly POSITION: "bottom";
-    /** Default visual variant */
     readonly VARIANT: "default";
-    /** Default visibility state */
     readonly VISIBLE: false;
-    /** Default show delay in milliseconds */
     readonly SHOW_DELAY: 300;
-    /** Default hide delay in milliseconds */
     readonly HIDE_DELAY: 100;
-    /** Default offset from target in pixels */
     readonly OFFSET: 8;
-    /** Default arrow size in pixels */
     readonly ARROW_SIZE: 8;
-    /** Whether to show tooltip on focus by default */
     readonly SHOW_ON_FOCUS: true;
-    /** Whether to show tooltip on hover by default */
     readonly SHOW_ON_HOVER: true;
 };
-/**
- * CSS class names used by the tooltip component
- * @category Components
- */
 export declare const TOOLTIP_CLASSES: {
-    /** Root element class */
     readonly ROOT: "tooltip";
-    /** Reserved slot; the current tooltip renders content directly in its root. */
     readonly CONTAINER: "tooltip__container";
-    /** Arrow element class */
     readonly ARROW: "tooltip__arrow";
-    /** Reserved slot; the current tooltip renders content directly in its root. */
     readonly CONTENT: "tooltip__content";
-    /** Visible state class */
     readonly VISIBLE: "tooltip--visible";
-    /** Hidden state class */
     readonly HIDDEN: "tooltip--hidden";
-    /** Default variant class */
     readonly DEFAULT: "tooltip--default";
-    /** Rich variant class */
     readonly RICH: "tooltip--rich";
-    /** Plain variant class */
     readonly PLAIN: "tooltip--plain";
-    /** Position prefix - append position name (e.g. tooltip--top) */
     readonly POSITION_PREFIX: "tooltip--";
 };

package/dist/components/tooltip/tooltip.d.ts

@@ -1,8 +1,3 @@
 import { TooltipConfig, TooltipComponent } from "./types.js";
-/**
- * Creates a new Tooltip component
- * @param {TooltipConfig} config - Tooltip configuration object
- * @returns {TooltipComponent} Tooltip component instance
- */
 declare const createTooltip: (config?: TooltipConfig) => TooltipComponent;
 export default createTooltip;

package/dist/components/tooltip/types.d.ts

@@ -1,6 +1,3 @@
-/**
- * Tooltip positions
- */
 export declare const TOOLTIP_POSITIONS: {
     readonly TOP: "top";
     readonly RIGHT: "right";
@@ -15,185 +12,48 @@ export declare const TOOLTIP_POSITIONS: {
     readonly LEFT_START: "left-start";
     readonly LEFT_END: "left-end";
 };
-/**
- * Tooltip variants
- */
 export declare const TOOLTIP_VARIANTS: {
     readonly DEFAULT: "default";
     readonly RICH: "rich";
     readonly PLAIN: "plain";
 };
-/**
- * Default values
- */
 export declare const DEFAULT_SHOW_DELAY = 300;
 export declare const DEFAULT_HIDE_DELAY = 100;
 export declare const DEFAULT_OFFSET = 8;
 export declare const DEFAULT_ARROW_SIZE = 8;
-/**
- * Available Tooltip variants
- */
 export type TooltipVariant = 'default' | 'rich' | 'plain';
-/**
- * Available Tooltip positions
- */
 export type TooltipPosition = typeof TOOLTIP_POSITIONS[keyof typeof TOOLTIP_POSITIONS];
-/**
- * Configuration interface for the Tooltip component
- * @category Components
- */
 export interface TooltipConfig {
-    /**
-     * Tooltip content text
-     * @example 'Delete item'
-     */
     text?: string;
-    /**
-     * HTML element that triggers the tooltip
-     * @example document.querySelector('#my-button')
-     */
     target?: HTMLElement;
-    /**
-     * Tooltip position relative to the target
-     * @default 'bottom'
-     */
     position?: TooltipPosition | string;
-    /**
-     * Tooltip variant that determines visual styling
-     * @default 'default'
-     */
     variant?: TooltipVariant | string;
-    /**
-     * Whether the tooltip is initially visible
-     * @default false
-     */
     visible?: boolean;
-    /**
-     * Show delay in milliseconds
-     * @default 300
-     */
     showDelay?: number;
-    /**
-     * Hide delay in milliseconds
-     * @default 100
-     */
     hideDelay?: number;
-    /**
-     * Whether to show the tooltip on focus
-     * @default true
-     */
     showOnFocus?: boolean;
-    /**
-     * Whether to show the tooltip on hover
-     * @default true
-     */
     showOnHover?: boolean;
-    /**
-     * Additional CSS classes to add to the tooltip
-     */
     class?: string;
-    /**
-     * Component prefix for class names
-     * @default 'mtrl'
-     */
     prefix?: string;
-    /**
-     * Component name used in class generation
-     */
     componentName?: string;
-    /**
-     * Optional z-index for the tooltip
-     */
     zIndex?: number;
-    /**
-     * `"top"` renders the tooltip in place, after its target, and shows it in
-     * the browser's top layer as a `popover="manual"` element: above every
-     * z-index, outside any clipping ancestor, and in the target's tree (a shadow
-     * root's included), so it takes that tree's styles. It is positioned in
-     * viewport coordinates. A tooltip element already in a document when the
-     * target is set stays where its owner put it.
-     *
-     * Where the browser has no popover support, the tooltip behaves as without
-     * it. Unset, the tooltip is appended to `document.body`.
-     */
     layer?: "top";
 }
-/**
- * Tooltip component interface
- * @category Components
- */
 export interface TooltipComponent {
-    /** The tooltip's DOM element */
     element: HTMLElement;
-    /** The tooltip's target element */
     target: HTMLElement | null;
-    /** API for managing component lifecycle */
     lifecycle: {
-        /** Destroys the component and cleans up resources */
         destroy: () => void;
     };
-    /**
-     * Gets a class name with the component's prefix
-     * @param name - Base class name
-     * @returns Prefixed class name
-     */
     getClass: (name: string) => string;
-    /**
-     * Sets the tooltip text content
-     * @param text - New text content
-     * @returns The tooltip component for chaining
-     */
     setText: (text: string) => TooltipComponent;
-    /**
-     * Gets the tooltip text content
-     * @returns Tooltip text content
-     */
     getText: () => string;
-    /**
-     * Sets the tooltip position
-     * @param position - Position value
-     * @returns The tooltip component for chaining
-     */
     setPosition: (position: TooltipPosition) => TooltipComponent;
-    /**
-     * Gets the current tooltip position
-     * @returns Current position
-     */
     getPosition: () => TooltipPosition;
-    /**
-     * Sets the tooltip target element
-     * @param target - Element to attach tooltip to
-     * @returns The tooltip component for chaining
-     */
     setTarget: (target: HTMLElement) => TooltipComponent;
-    /**
-     * Shows the tooltip. Outside the overlays' open and close contract, by
-     * design: it is shown after the show delay and emits no event, so
-     * `isVisible()` is still false when `show()` returns. `show(true)` shows it
-     * at once.
-     * @param immediate - Whether to show immediately (bypassing delay)
-     * @returns The tooltip component for chaining
-     */
     show: (immediate?: boolean) => TooltipComponent;
-    /**
-     * Hides the tooltip, after the hide delay and without an event; `hide(true)`
-     * hides it at once.
-     * @param immediate - Whether to hide immediately (bypassing delay)
-     * @returns The tooltip component for chaining
-     */
     hide: (immediate?: boolean) => TooltipComponent;
-    /**
-     * Checks if the tooltip is currently visible
-     * @returns Whether the tooltip is visible
-     */
     isVisible: () => boolean;
-    /**
-     * Updates the tooltip's position relative to its target
-     * @returns The tooltip component for chaining
-     */
     updatePosition: () => TooltipComponent;
-    /**
-     * Destroys the tooltip component and cleans up resources
-     */
     destroy: () => void;
 }

package/dist/components/top-app-bar/constants.d.ts

@@ -1,74 +1,33 @@
-/**
- * Top App Bar types
- * @category Components
- */
 export declare const TOP_APP_BAR_TYPES: {
-    /** Small height app bar */
     readonly SMALL: "small";
-    /** Medium height app bar */
     readonly MEDIUM: "medium";
-    /** Large height app bar */
     readonly LARGE: "large";
-    /** Center-aligned app bar */
     readonly CENTER: "center";
 };
-/**
- * Top App Bar states
- * @category Components
- */
 export declare const TOP_APP_BAR_STATES: {
-    /** Default state */
     readonly DEFAULT: "default";
-    /** Scrolled state */
     readonly SCROLLED: "scrolled";
-    /** Fixed state */
     readonly FIXED: "fixed";
 };
-/**
- * Default configuration values for top app bar
- * @category Components
- */
 export declare const TOP_APP_BAR_DEFAULTS: {
-    /** Default HTML tag */
     readonly TAG: "header";
-    /** Default bar type */
     readonly TYPE: "small";
-    /** Whether to enable scrolling behavior */
     readonly SCROLLABLE: true;
-    /** Whether to compress medium/large variants on scroll */
     readonly COMPRESSIBLE: true;
-    /** Scroll threshold in pixels to trigger scrolled state */
     readonly SCROLL_THRESHOLD: 4;
 };
-/**
- * CSS class names used by the top app bar component
- * @category Components
- */
 export declare const TOP_APP_BAR_CLASSES: {
-    /** Root element class */
     readonly ROOT: "top-app-bar";
-    /** Small variant class */
     readonly SMALL: "top-app-bar--small";
-    /** Medium variant class */
     readonly MEDIUM: "top-app-bar--medium";
-    /** Large variant class */
     readonly LARGE: "top-app-bar--large";
-    /** Center-aligned variant class */
     readonly CENTER: "top-app-bar--center";
-    /** Scrolled state class */
     readonly SCROLLED: "top-app-bar--scrolled";
-    /** Fixed state class */
     readonly FIXED: "top-app-bar--fixed";
-    /** Row container class */
     readonly ROW: "top-app-bar__row";
-    /** Section container class */
     readonly SECTION: "top-app-bar__section";
-    /** Leading section class */
     readonly SECTION_LEADING: "top-app-bar__section--leading";
-    /** Headline section class */
     readonly SECTION_HEADLINE: "top-app-bar__section--headline";
-    /** Trailing section class */
     readonly SECTION_TRAILING: "top-app-bar__section--trailing";
-    /** Title element class */
     readonly TITLE: "top-app-bar__title";
 };

package/dist/components/top-app-bar/index.d.ts

@@ -1,7 +1,3 @@
-/**
- * @module components/top-app-bar
- * @description Top app bar component for application headers
- */
 import { createTopAppBar } from "./top-app-bar.js";
 export { TOP_APP_BAR_TYPES, TOP_APP_BAR_STATES, TOP_APP_BAR_DEFAULTS, TOP_APP_BAR_CLASSES } from "./constants.js";
 export default createTopAppBar;

package/dist/components/top-app-bar/top-app-bar.d.ts

@@ -1,13 +1,3 @@
-/**
- * @module components/top-app-bar
- * @description Top app bar implementation
- */
 import type { TopAppBarComponent, TopAppBarConfig } from "./types.js";
 export type { TopAppBarComponent };
-/**
- * Creates a top app bar component
- *
- * @param {TopAppBarConfig} config - Configuration options
- * @returns {TopAppBarComponent} Top app bar component instance
- */
 export declare const createTopAppBar: (config?: TopAppBarConfig) => TopAppBarComponent;

package/dist/components/top-app-bar/types.d.ts

@@ -1,119 +1,25 @@
-/**
- * @module components/top-app-bar
- * @description Type definitions for Top App Bar component
- */
 import { ElementComponent } from "../../core/compose/index.js";
-/**
- * Top App Bar types
- * @category Components
- */
 export type TopAppBarType = 'small' | 'medium' | 'large' | 'center';
-/**
- * Configuration options for Top App Bar component
- * @category Components
- */
 export interface TopAppBarConfig {
-    /**
-     * Element to use for the container
-     * @default 'header'
-     */
     tag?: string;
-    /**
-     * Type of top app bar to display
-     * @default 'small'
-     */
     type?: TopAppBarType;
-    /**
-     * Title text to display in the app bar
-     */
     title?: string;
-    /**
-     * Whether to enable scrolling behavior
-     * @default true
-     */
     scrollable?: boolean;
-    /**
-     * Whether to compress medium/large variants to small on scroll
-     * @default true
-     */
     compressible?: boolean;
-    /**
-     * Scroll threshold in pixels to trigger the scrolled state
-     * @default 4
-     */
     scrollThreshold?: number;
-    /**
-     * Additional CSS classes to apply
-     */
     class?: string;
-    /**
-     * Called with the new scrolled state when scrolling changes the bar.
-     * There is no matching event, so this stays a callback rather than a listener.
-     */
     onScroll?: (scrolled: boolean) => void;
-    /**
-     * Component prefix for class names
-     * @default 'mtrl'
-     */
     prefix?: string;
-    /**
-     * Component name for class generation
-     */
     componentName?: string;
 }
-/**
- * Top App Bar component interface
- * @category Components
- */
 export interface TopAppBarComponent extends ElementComponent {
-    /**
-     * Sets the title of the top app bar
-     * @param {string} title - Title text
-     * @returns {TopAppBarComponent} TopAppBarComponent instance for chaining
-     */
     setTitle(title: string): this;
-    /**
-     * Gets the current title
-     * @returns {string} Current title text
-     */
     getTitle: () => string;
-    /**
-     * Adds a leading navigation icon or element
-     * @param {HTMLElement} element - Element to add to the leading section
-     * @returns {TopAppBarComponent} TopAppBarComponent instance for chaining
-     */
     addLeadingElement(element: HTMLElement): this;
-    /**
-     * Adds a trailing action icon or element
-     * @param {HTMLElement} element - Element to add to the trailing section
-     * @returns {TopAppBarComponent} TopAppBarComponent instance for chaining
-     */
     addTrailingElement(element: HTMLElement): this;
-    /**
-     * Changes the top app bar type
-     * @param {TopAppBarType} type - New app bar type
-     * @returns {TopAppBarComponent} TopAppBarComponent instance for chaining
-     */
     setType(type: TopAppBarType): this;
-    /**
-     * Manually sets the scrolled state
-     * @param {boolean} scrolled - Whether to show the scrolled state
-     * @returns {TopAppBarComponent} TopAppBarComponent instance for chaining
-     */
     setScrollState(scrolled: boolean): this;
-    /**
-     * Gets the headline element
-     * @returns {HTMLElement} Headline element
-     */
     getHeadlineElement: () => HTMLElement;
-    /**
-     * Gets the leading container element
-     * @returns {HTMLElement} Leading container element
-     */
     getLeadingContainer: () => HTMLElement;
-    /**
-     * Gets the trailing container element
-     * @returns {HTMLElement} Trailing container element
-     */
     getTrailingContainer: () => HTMLElement;
 }

package/dist/core/canvas/animation.d.ts

@@ -1,23 +1,10 @@
-/**
- * Easing function for smooth animations (Material Design standard)
- * Implements cubic-bezier(0.4, 0, 0.2, 1)
- *
- * @param t Progress value between 0 and 1
- * @returns Eased progress value between 0 and 1
- */
 export declare const easeOutCubic: (t: number) => number;
-/**
- * Standard Material Design animation durations
- */
 export declare const ANIMATION_DURATIONS: {
     SHORT: number;
     MEDIUM: number;
     LONG: number;
     EXTRA_LONG: number;
 };
-/**
- * Common easing functions
- */
 export declare const EASING_FUNCTIONS: {
     linear: (t: number) => number;
     easeIn: (t: number) => number;

package/dist/core/canvas/drawing.d.ts

@@ -1,57 +1,20 @@
-/**
- * Canvas drawing utilities
- * Provides common drawing functions for canvas operations
- */
-/**
- * Creates a rounded rectangle path
- * @param ctx - Canvas 2D rendering context
- * @param x - X coordinate
- * @param y - Y coordinate
- * @param width - Rectangle width
- * @param height - Rectangle height
- * @param radius - Corner radius (can be a number or array of radii)
- */
-export declare const createRoundedRectPath: (ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number | [number, number, number, number]) => void;
-/**
- * Draws a filled rounded rectangle
- * @param ctx - Canvas 2D rendering context
- * @param x - X coordinate
- * @param y - Y coordinate
- * @param width - Rectangle width
- * @param height - Rectangle height
- * @param radius - Corner radius
- * @param fillStyle - Fill color/style
- */
-export declare const fillRoundedRect: (ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number | [number, number, number, number], fillStyle?: string | CanvasGradient | CanvasPattern) => void;
-/**
- * Creates a clipping region with rounded corners
- * @param ctx - Canvas 2D rendering context
- * @param x - X coordinate
- * @param y - Y coordinate
- * @param width - Rectangle width
- * @param height - Rectangle height
- * @param radius - Corner radius
- * @returns Function to restore the canvas state
- */
-export declare const clipRoundedRect: (ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number | [number, number, number, number]) => (() => void);
-/**
- * Draws a rounded rectangle with different left and right radii
- * Useful for track segments that connect to other elements
- * @param ctx - Canvas 2D rendering context
- * @param x - X coordinate
- * @param y - Y coordinate
- * @param width - Rectangle width
- * @param height - Rectangle height
- * @param leftRadius - Left side radius
- * @param rightRadius - Right side radius
- * @param fillStyle - Fill color/style
- */
+export declare const createRoundedRectPath: (ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number | [
+    number,
+    number,
+    number,
+    number
+]) => void;
+export declare const fillRoundedRect: (ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number | [
+    number,
+    number,
+    number,
+    number
+], fillStyle?: string | CanvasGradient | CanvasPattern) => void;
+export declare const clipRoundedRect: (ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number | [
+    number,
+    number,
+    number,
+    number
+]) => (() => void);
 export declare const fillRoundedRectLR: (ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, leftRadius: number, rightRadius: number, fillStyle?: string | CanvasGradient | CanvasPattern) => void;
-/**
- * Clears a canvas with optional background color
- * @param ctx - Canvas 2D rendering context
- * @param width - Canvas width
- * @param height - Canvas height
- * @param backgroundColor - Optional background color
- */
 export declare const clearCanvas: (ctx: CanvasRenderingContext2D, width: number, height: number, backgroundColor?: string) => void;

package/dist/core/canvas/index.d.ts

@@ -1,7 +1,3 @@
-/**
- * Canvas utilities for high-performance rendering
- * Provides tools for drawing, animation, and resize handling
- */
 export * from "./drawing.js";
 export * from "./resize.js";
 export * from "./animation.js";

package/dist/core/canvas/resize.d.ts

@@ -1,14 +1 @@
-/**
- * Canvas resize utilities
- * Provides utilities for observing and handling canvas resize events
- */
-/**
- * Observes resize events on an element and triggers a callback
- * Watches the specified element and debounces resize events
- *
- * @param element - The element to observe for size changes
- * @param canvas - The canvas element (for context)
- * @param onResize - Callback to execute when the element resizes
- * @returns Cleanup function to stop observing
- */
 export declare const observeCanvasResize: (element: HTMLElement, _canvas: HTMLCanvasElement, onResize: () => void) => (() => void);