@jimka/typescript-ui 0.1.1 → 0.2.0

package/dist/lib/primitive.es.js

@@ -1,2 +1,2 @@
-import{a as e,c as t,i as n,n as r,o as i,r as a,s as o,t as s}from"./Position-DJKB0N3l.js";import{t as c}from"./Placement-7kqdaK4Z.js";var Point=class extends t{_x;_y;constructor(e,t){super(),this._x=e??0,this._y=t??0}getX(){return this._x??0}getY(){return this._y??0}render(){return this.getX()+` `+this.getY()}};export{r as Insets,c as Placement,Point,s as Position,e as UNBOUNDED,a as borderSideWidth,n as borderToStyle,i as isUnbounded,o as saturate};
+import{a as e,c as t,i as n,n as r,o as i,r as a,s as o,t as s}from"./Position-A39T7-_1.js";import{t as c}from"./Placement-7kqdaK4Z.js";var Point=class extends t{_x;_y;constructor(e,t){super(),this._x=e??0,this._y=t??0}getX(){return this._x??0}getY(){return this._y??0}render(){return this.getX()+` `+this.getY()}};export{r as Insets,c as Placement,Point,s as Position,e as UNBOUNDED,a as borderSideWidth,n as borderToStyle,i as isUnbounded,o as saturate};
 //# sourceMappingURL=primitive.es.js.map

package/dist/lib/router.es.js

@@ -1,2 +1,2 @@
-import{t as e}from"./DOM-DeF_dWe2.js";import{t}from"./ListenerBag-WPdKuuds.js";function normalizePath(e){let t=e.startsWith(`#`)?e.slice(1):e,n=t.indexOf(`?`);return n>=0&&(t=t.slice(0,n)),`/`+splitPath(t).join(`/`)}function splitPath(e){return e.split(`/`).filter(e=>e.length>0)}function compilePattern(e){let t=normalizePath(e),n=splitPath(t),r=n.map((t,r)=>{if(t===`*`){if(r!==n.length-1)throw Error(`RoutePattern: "*" is only valid as the final segment of "${e}"`);return{kind:`catchAll`,value:``}}return t.startsWith(`:`)?{kind:`param`,value:t.slice(1)}:{kind:`static`,value:t}});return{pattern:t,key:r.map(e=>e.kind===`static`?e.value:e.kind===`param`?`:`:`*`).join(`/`),segments:r}}function matchPattern(e,t){let n=e.segments,r=n.length>0&&n.at(-1).kind===`catchAll`,i=r?n.length-1:n.length;if(r?t.length<i:t.length!==i)return null;let a={};for(let e=0;e<i;e+=1){let r=n[e],i=t[e];if(r.kind===`static`){if(r.value!==i)return null}else r.kind===`param`&&(a[r.value]=decodeSegment(i))}return a}function decodeSegment(e){try{return decodeURIComponent(e)}catch{return e}}var n={static:2,param:1,catchAll:0};function rankAt(e,t){return t>=e.length?3:n[e[t].kind]}function selectPattern(e,t){let n=splitPath(t),r=null,i=null;for(let t of e){let e=matchPattern(t,n);e!==null&&(r===null||isMoreSpecific(t.segments,r.segments))&&(r=t,i=e)}return r===null?null:{compiled:r,params:i}}function isMoreSpecific(e,t){let n=Math.max(e.length,t.length);for(let r=0;r<n;r+=1){let n=rankAt(e,r),i=rankAt(t,r);if(n!==i)return n>i}return!1}var Router=class{_routes=new Map;_listeners=new t;_started=!1;_onHashChange=()=>this.handleHashChange();constructor(e){this.applyOptions(e??{})}register(e,t){let n=compilePattern(e),r=this._routes.get(n.key);return r!==void 0&&r.pattern!==n.pattern&&console.warn(`Router: "${r.pattern}" and "${n.pattern}" have the same specificity; "${n.pattern}" replaces it.`),this._routes.set(n.key,{...n,handler:t}),this}start(){return this._started?(console.warn(`Router: start() called on an already-started router; ignoring.`),this):(this._started=!0,this.applyCurrentRoute(),e.sink.addListener(e.source.getWindow(),`hashchange`,this._onHashChange),this)}stop(){return this._started?(e.sink.removeListener(e.source.getWindow(),`hashchange`,this._onHashChange),this._started=!1,this):this}navigate(t,n){let r=`#/`+splitPath(normalizePath(t)).map(e=>encodeURIComponent(e)).join(`/`);return n?.replace===!0?e.sink.replaceLocationHash(r):e.sink.setLocationHash(r),this}getPath(){return normalizePath(e.source.getLocationHash())}on(e,t){return this._listeners.add(e,t),this}off(e,t){return this._listeners.remove(e,t),this}emit(e,t){this._listeners.fire(e,t)}applyCurrentRoute(){let e=this.getPath(),t=selectPattern(Array.from(this._routes.values()),e);if(t===null){this.emit(`nomatch`,e);return}let n={pattern:t.compiled.pattern,params:t.params,path:e};t.compiled.handler(t.params,e),this.emit(`navigate`,n)}applyOptions(e){if(e.routes!==void 0)for(let t of Object.keys(e.routes))this.register(t,e.routes[t]);if(e.listeners!==void 0)for(let t of Object.keys(e.listeners)){let n=e.listeners[t];n!==void 0&&this._listeners.add(t,n)}}handleHashChange(){this.applyCurrentRoute()}};export{Router};
+import{t as e}from"./DOM-CGn7xyTw.js";import{t}from"./ListenerBag-WPdKuuds.js";function normalizePath(e){let t=e.startsWith(`#`)?e.slice(1):e,n=t.indexOf(`?`);return n>=0&&(t=t.slice(0,n)),`/`+splitPath(t).join(`/`)}function splitPath(e){return e.split(`/`).filter(e=>e.length>0)}function compilePattern(e){let t=normalizePath(e),n=splitPath(t),r=n.map((t,r)=>{if(t===`*`){if(r!==n.length-1)throw Error(`RoutePattern: "*" is only valid as the final segment of "${e}"`);return{kind:`catchAll`,value:``}}return t.startsWith(`:`)?{kind:`param`,value:t.slice(1)}:{kind:`static`,value:t}});return{pattern:t,key:r.map(e=>e.kind===`static`?e.value:e.kind===`param`?`:`:`*`).join(`/`),segments:r}}function matchPattern(e,t){let n=e.segments,r=n.length>0&&n.at(-1).kind===`catchAll`,i=r?n.length-1:n.length;if(r?t.length<i:t.length!==i)return null;let a={};for(let e=0;e<i;e+=1){let r=n[e],i=t[e];if(r.kind===`static`){if(r.value!==i)return null}else r.kind===`param`&&(a[r.value]=decodeSegment(i))}return a}function decodeSegment(e){try{return decodeURIComponent(e)}catch{return e}}var n={static:2,param:1,catchAll:0};function rankAt(e,t){return t>=e.length?3:n[e[t].kind]}function selectPattern(e,t){let n=splitPath(t),r=null,i=null;for(let t of e){let e=matchPattern(t,n);e!==null&&(r===null||isMoreSpecific(t.segments,r.segments))&&(r=t,i=e)}return r===null?null:{compiled:r,params:i}}function isMoreSpecific(e,t){let n=Math.max(e.length,t.length);for(let r=0;r<n;r+=1){let n=rankAt(e,r),i=rankAt(t,r);if(n!==i)return n>i}return!1}var Router=class{_routes=new Map;_listeners=new t;_started=!1;_onHashChange=()=>this.handleHashChange();constructor(e){this.applyOptions(e??{})}register(e,t){let n=compilePattern(e),r=this._routes.get(n.key);return r!==void 0&&r.pattern!==n.pattern&&console.warn(`Router: "${r.pattern}" and "${n.pattern}" have the same specificity; "${n.pattern}" replaces it.`),this._routes.set(n.key,{...n,handler:t}),this}start(){return this._started?(console.warn(`Router: start() called on an already-started router; ignoring.`),this):(this._started=!0,this.applyCurrentRoute(),e.sink.addListener(e.source.getWindow(),`hashchange`,this._onHashChange),this)}stop(){return this._started?(e.sink.removeListener(e.source.getWindow(),`hashchange`,this._onHashChange),this._started=!1,this):this}navigate(t,n){let r=`#/`+splitPath(normalizePath(t)).map(e=>encodeURIComponent(e)).join(`/`);return n?.replace===!0?e.sink.replaceLocationHash(r):e.sink.setLocationHash(r),this}getPath(){return normalizePath(e.source.getLocationHash())}on(e,t){return this._listeners.add(e,t),this}off(e,t){return this._listeners.remove(e,t),this}emit(e,t){this._listeners.fire(e,t)}applyCurrentRoute(){let e=this.getPath(),t=selectPattern(Array.from(this._routes.values()),e);if(t===null){this.emit(`nomatch`,e);return}let n={pattern:t.compiled.pattern,params:t.params,path:e};t.compiled.handler(t.params,e),this.emit(`navigate`,n)}applyOptions(e){if(e.routes!==void 0)for(let t of Object.keys(e.routes))this.register(t,e.routes[t]);if(e.listeners!==void 0)for(let t of Object.keys(e.listeners)){let n=e.listeners[t];n!==void 0&&this._listeners.add(t,n)}}handleHashChange(){this.applyCurrentRoute()}};export{Router};
 //# sourceMappingURL=router.es.js.map

package/dist/lib/types/component/button/Button.d.ts

@@ -1,4 +1,5 @@
 import { Component, ComponentOptions } from "../../core/Component.js";
+import { Event } from "../../core/Event.js";
 import { Text } from "../../component/input/Text.js";
 import { Glyph } from "../../component/display/Glyph.js";
 import { FillType } from "../../layout/FillType.js";
@@ -7,7 +8,7 @@ import { BorderOptions } from "../../primitive/Border.js";
 import { Insets } from "../../primitive/Insets.js";
 import { Size } from "../../primitive/Size.js";
 export type ButtonEvent = "action";
-export type ClickListener = (event: MouseEvent) => void;
+export type ClickListener = (event: MouseEvent) => Event.ListenerResult;
 export interface ButtonOptions extends ComponentOptions {
     text?: string;
     description?: string;
@@ -98,7 +99,7 @@ declare class Button<TOptions extends ButtonOptions = ButtonOptions> extends Com
     on(event: "action", listener: ClickListener): this;
     off(event: "action", listener: ClickListener): this;
     click(): this;
-    addPointerDownListener(listener: Function): this;
+    addPointerDownListener(listener: Event.Listener): this;
     isChromeless(): boolean;
     setChromeless(value: boolean): this;
     private _clearChrome;
@@ -110,7 +111,7 @@ declare class Button<TOptions extends ButtonOptions = ButtonOptions> extends Com
     private _applyFlatChrome;
     private _resolveInsets;
     setInsets(insets: Insets): this;
-    setPreferredSize(width: number, height: number): this;
+    setPreferredSize(size: Size): this;
     getPreferredSize(): Size | null;
     protected recomputePreferredSize(): void;
     protected computePreferredSize(): {

package/dist/lib/types/component/chart/AbstractChart.d.ts

@@ -100,6 +100,6 @@ export declare abstract class AbstractChart<O extends AbstractChartOptions = Abs
         x: number;
         y: number;
     } | null;
-    dispose(): void;
+    protected destructor(): void;
 }
 export {};

package/dist/lib/types/component/chart/ChartLegend.d.ts

@@ -31,7 +31,7 @@ declare class ChartLegend extends Panel<ChartLegendOptions> {
     on(event: "toggle", listener: (seriesIndex: number) => void): this;
     off(event: "toggle", listener: (seriesIndex: number) => void): this;
     protected emit(event: ChartLegendEvent, seriesIndex: number): void;
-    dispose(): void;
+    protected destructor(): void;
 }
 declare const ChartLegendCallable: import("../../core/Callable.js").Callable<typeof ChartLegend>;
 type ChartLegendCallable = ChartLegend;

package/dist/lib/types/component/container/DialogBackdrop.d.ts

@@ -1,9 +1,10 @@
 import { Component, ComponentOptions } from "../../core/Component.js";
+import { Event } from "../../core/Event.js";
 interface DialogBackdropOptions extends ComponentOptions {
 }
 declare class DialogBackdrop extends Component<DialogBackdropOptions> {
     constructor(options?: DialogBackdropOptions);
-    addClickListener(listener: Function): this;
+    addClickListener(listener: Event.Listener): this;
     resize(): void;
     destroy(): void;
 }

package/dist/lib/types/component/container/MenuItem.d.ts

@@ -56,7 +56,7 @@ declare class MenuItem extends Component {
     isSeparator(): boolean;
     isEnabled(): boolean;
     activate(): void;
-    dispose(): void;
+    protected destructor(): void;
     getBaseline(): number | null;
     doLayout(): this;
 }

package/dist/lib/types/component/container/ScrollStrip.d.ts

@@ -52,6 +52,7 @@ declare class ScrollStrip extends Panel<ScrollStripOptions> {
     private trailClicked;
     revealItem(itemElement: Handle): void;
     containsArrow(target: EventTarget | null): boolean;
+    protected destructor(): void;
 }
 declare const ScrollStripCallable: import("../../core/Callable.js").Callable<typeof ScrollStrip>;
 type ScrollStripCallable = ScrollStrip;

package/dist/lib/types/component/container/SplitGutter.d.ts

@@ -1,6 +1,7 @@
 import { Component, ComponentOptions } from "../../core/Component.js";
 import type { Handle } from "../../core/DOM.js";
 import { CollapseDirection } from "../../component/container/CollapseButton.js";
+import { Event } from "../../core/Event.js";
 export type SplitGutterEvent = "dragstart" | "drag" | "dragend" | "collapse";
 export interface SplitGutterOptions extends ComponentOptions {
     orientation?: string;
@@ -52,8 +53,8 @@ declare class SplitGutter extends Component<SplitGutterOptions> {
     destroy(): void;
     private _dispatchDrag;
     onDragStart(evnt: MouseEvent): void;
-    onDragStop(e?: Event): void;
-    onDrag(evnt: MouseEvent): void;
+    onDragStop(): Event.ListenerResult;
+    onDrag(evnt: MouseEvent): Event.ListenerResult;
     private dragCursor;
     private applyCursor;
     render(): Handle;

package/dist/lib/types/component/container/TabBar.d.ts

@@ -46,7 +46,6 @@ declare class TabBar extends Container<TabBarOptions> {
     private _fixedWidth;
     private _underBorderFullWidth;
     private _underBorderFromTheme;
-    private _themeCleanup;
     private _indicator;
     private _side;
     private _align;
@@ -74,7 +73,7 @@ declare class TabBar extends Container<TabBarOptions> {
     private dispatchBarOptions;
     setBarSurfaceColor(color: string): this;
     protected init(element?: Handle): this;
-    dispose(): this;
+    protected destructor(): void;
     private applyUnderBorder;
     setWidthMode(mode: TabWidthMode): this;
     getWidthMode(): TabWidthMode;

package/dist/lib/types/component/container/TabPanel.d.ts

@@ -1,11 +1,13 @@
 import { Container, ContainerOptions } from "../../core/Container.js";
 import { Component } from "../../core/Component.js";
+import type { ComponentFactory } from "../../core/Component.js";
 import { Tab, TabOptions } from "../../layout/Tab.js";
 export interface TabEntryConfig {
     label: string;
-    component: Component;
+    component: Component | ComponentFactory;
     closeable?: boolean;
     glyph?: string;
+    lazy?: boolean;
 }
 export interface TabPanelOptions extends ContainerOptions {
     tabs?: TabEntryConfig[];
@@ -14,11 +16,12 @@ export interface TabPanelOptions extends ContainerOptions {
 }
 declare class TabPanel<TOptions extends TabPanelOptions = TabPanelOptions> extends Container<TOptions> {
     constructor(options?: TOptions);
-    addTab(component: Component, label: string, options?: {
+    addTab(component: Component | ComponentFactory, label: string, options?: {
         closeable?: boolean;
         glyph?: string;
+        lazy?: boolean;
     }): this;
-    addLazyTab(factory: () => Component, label: string, options?: {
+    addLazyTab(factory: ComponentFactory, label: string, options?: {
         closeable?: boolean;
         glyph?: string;
     }): this;

package/dist/lib/types/component/container/WindowBorder.d.ts

@@ -1,4 +1,5 @@
 import { Component, ComponentOptions } from "../../core/Component.js";
+import { Event } from "../../core/Event.js";
 export type WindowBorderEvent = "drag";
 export declare enum Direction {
     NORTH = 0,
@@ -34,7 +35,7 @@ declare class WindowBorder extends Component<WindowBorderOptions> {
     isSnapTarget(): boolean;
     setSnapTarget(value: boolean): this;
     onDragStart(): void;
-    onDragStop(e?: Event): void;
+    onDragStop(): Event.ListenerResult;
     private dragCursor;
     render(): import("../../core/DOM.js").Handle;
 }

package/dist/lib/types/component/container/WindowHeader.d.ts

@@ -1,5 +1,6 @@
 import { Header, HeaderOptions } from "../../component/display/Header.js";
 import type { Handle } from "../../core/DOM.js";
+import { Event } from "../../core/Event.js";
 import { Glyph } from "../../component/display/Glyph.js";
 export interface WindowHeaderOptions extends HeaderOptions {
     closeable?: boolean;
@@ -37,7 +38,7 @@ declare class WindowHeader extends Header {
     addExitButtonListener(listener: Function): this;
     addMinimizeButtonListener(listener: Function): this;
     addMaximizeButtonListener(listener: Function): this;
-    addHeaderDoubleClickListener(listener: Function): this;
+    addHeaderDoubleClickListener(listener: Event.Listener): this;
     getMinContentWidth(textBudget?: number): number;
     getMinimizeButtonElement(): Handle | undefined;
     getMaximizeButtonElement(): Handle | undefined;

package/dist/lib/types/component/display/Glyph.d.ts

@@ -1,5 +1,6 @@
 import { Component, ComponentOptions } from "../../core/Component.js";
 import type { Handle } from "../../core/DOM.js";
+import { Size } from "../../primitive/Size.js";
 import { NamedGlyphDef } from "../../component/display/Glyphs.js";
 export type GlyphAnimation = "spin" | "pulse" | "beat";
 export interface GlyphOptions extends ComponentOptions {
@@ -18,7 +19,7 @@ declare class Glyph extends Component<GlyphOptions> {
     static register(...defs: NamedGlyphDef[]): void;
     static unregister(name: string): void;
     constructor(name: string, options?: GlyphOptions);
-    setPreferredSize(width: number, height: number): this;
+    setPreferredSize(size: Size): this;
     getBaseline(): number | null;
     getGlyphName(): string;
     getFontSize(): number | null;

package/dist/lib/types/component/display/Markdown.d.ts

@@ -23,7 +23,7 @@ declare class Markdown extends Component<MarkdownOptions> {
     getMinSize(): Size | null;
     getPreferredSize(): Size | null;
     setWidth(width: number): this;
-    dispose(): void;
+    protected destructor(): void;
     private measureContentHeight;
     protected render(): Handle;
     private create;

package/dist/lib/types/component/display/PaginationBar.d.ts

@@ -15,7 +15,7 @@ declare class PaginationBar extends Component<PaginationBarOptions> {
     private readonly _onStoreUpdate;
     constructor(store: AbstractStore, options?: PaginationBarOptions);
     protected applyOptions(options: PaginationBarOptions): this;
-    dispose(): void;
+    protected destructor(): void;
     private refresh;
 }
 declare const PaginationBarCallable: import("../../core/Callable.js").Callable<typeof PaginationBar>;

package/dist/lib/types/component/display/SpinnerWrap.d.ts

@@ -0,0 +1,2 @@
+import { Component } from "../../core/Component.js";
+export declare function createSpinnerWrap(): Component;

package/dist/lib/types/component/display/Video.d.ts

@@ -50,7 +50,7 @@ declare class Video extends Component<VideoOptions> {
     off(event: VideoMediaEvent, listener: () => void): this;
     protected emit(event: VideoMediaEvent): void;
     protected init(element?: Handle): this;
-    dispose(): void;
+    protected destructor(): void;
     private buildMediaHandlers;
     private replayMediaOptions;
     private attachMediaListeners;

package/dist/lib/types/component/display/VideoPlayer.d.ts

@@ -73,7 +73,7 @@ declare class VideoPlayer extends Component<VideoPlayerOptions> {
     off(event: VideoPlayerEvent, listener: () => void): this;
     protected emit(event: VideoPlayerEvent): void;
     protected init(element?: Handle): this;
-    dispose(): void;
+    protected destructor(): void;
     private syncFromState;
     private syncFromVideo;
     private buildControlBar;

package/dist/lib/types/component/editor/CodeEditor.d.ts

@@ -14,6 +14,7 @@ export interface CodeEditorOptions extends ComponentOptions {
 declare class CodeEditor extends Component<CodeEditorOptions> {
     private _view;
     private _flashOverlay;
+    private _flashAnimation;
     private readonly _langCompartment;
     private readonly _readOnlyCompartment;
     private readonly _themeCompartment;
@@ -38,7 +39,7 @@ declare class CodeEditor extends Component<CodeEditorOptions> {
     off(event: "readonlyedit", listener: () => void): this;
     protected emit(event: "change", payload: CodeEditorChange): void;
     protected emit(event: "readonlyedit"): void;
-    dispose(): void;
+    protected destructor(): void;
     private claimScrollableWheel;
     private mount;
     private mountFlashOverlay;

package/dist/lib/types/component/editor/MarkdownEditor.d.ts

@@ -47,7 +47,7 @@ declare class MarkdownEditor extends Component<MarkdownEditorOptions> {
     protected emit(event: MarkdownEditorEvent, payload: MarkdownEditorChange): void;
     setContentEditable(contentEditable: boolean): this;
     getContentEditable(): boolean;
-    dispose(): void;
+    protected destructor(): void;
     private ensureEditor;
     private mountWysiwyg;
     private handleChange;

package/dist/lib/types/component/input/Checkbox.d.ts

@@ -1,5 +1,6 @@
 import { AbstractBooleanInput, AbstractBooleanInputOptions } from "../../component/input/AbstractBooleanInput.js";
 import { Component } from "../../core/Component.js";
+import { Event } from "../../core/Event.js";
 export interface CheckboxOptions extends AbstractBooleanInputOptions {
     selected?: boolean;
     value?: boolean;
@@ -25,7 +26,7 @@ declare class Checkbox<TOptions extends CheckboxOptions = CheckboxOptions> exten
     isIndeterminate(): boolean;
     setIndeterminate(value: boolean): this;
     setAnimated(value: boolean): this;
-    on(event: "action", listener: Function): this;
+    on(event: "action", listener: Event.Listener): this;
     on(event: "change", listener: (value: boolean) => void): this;
     on(event: "binding", listener: () => void): this;
     off(event: "action" | "change" | "binding", listener: Function): this;

package/dist/lib/types/component/input/Link.d.ts

@@ -15,7 +15,7 @@ declare class Link extends Text<LinkOptions> {
     on(event: "action", listener: ClickListener): this;
     off(event: "action", listener: ClickListener): this;
     click(): this;
-    dispose(): void;
+    protected destructor(): void;
     private handleKeyDown;
 }
 declare const LinkCallable: import("../../core/Callable.js").Callable<typeof Link>;

package/dist/lib/types/component/input/RadioButton.d.ts

@@ -1,5 +1,6 @@
 import { AbstractBooleanInput, AbstractBooleanInputOptions } from "../../component/input/AbstractBooleanInput.js";
 import { Component } from "../../core/Component.js";
+import { Event } from "../../core/Event.js";
 export interface RadioButtonOptions extends AbstractBooleanInputOptions {
     selected?: boolean;
     value?: boolean;
@@ -25,7 +26,7 @@ declare class RadioButton<TOptions extends RadioButtonOptions = RadioButtonOptio
     setRadioName(name: string): this;
     clearRadioName(): this;
     getRadioName(): string | null;
-    on(event: "action", listener: Function): this;
+    on(event: "action", listener: Event.Listener): this;
     on(event: "change", listener: (value: boolean) => void): this;
     on(event: "binding", listener: () => void): this;
     off(event: "action" | "change" | "binding", listener: Function): this;

package/dist/lib/types/component/input/Slider.d.ts

@@ -1,4 +1,5 @@
 import { AbstractInput, AbstractInputOptions } from "../../component/input/AbstractInput.js";
+import { Event } from "../../core/Event.js";
 import type { AxisOrientation } from "../../primitive/Axis.js";
 export interface SliderOptions extends AbstractInputOptions {
     value?: number;
@@ -41,7 +42,7 @@ declare class Slider<TOptions extends SliderOptions = SliderOptions> extends Abs
     setOrientation(orientation: AxisOrientation): this;
     isShowTicks(): boolean;
     setShowTicks(value: boolean): this;
-    on(event: "action", listener: Function): this;
+    on(event: "action", listener: Event.Listener): this;
     on(event: "change", listener: (value: number) => void): this;
     on(event: "binding", listener: () => void): this;
     off(event: "action" | "change" | "binding", listener: Function): this;

package/dist/lib/types/component/input/Text.d.ts

@@ -23,7 +23,6 @@ declare class Text<TOptions extends TextOptions = TextOptions> extends Component
     private _hasExplicitPreferredSize;
     private _fontSizeCSSVar;
     private _fontSizeCSSRule;
-    private readonly _unsubscribeTheme;
     private _lineHeightCSSVar;
     private _lineHeightCSSRule;
     private _measuredBaseline;
@@ -39,7 +38,7 @@ declare class Text<TOptions extends TextOptions = TextOptions> extends Component
     private readThemeLineHeightPx;
     getElement(createIfMissing?: boolean): Handle | undefined;
     private resolveBoundFontSizePx;
-    setPreferredSize(width: number, height: number): this;
+    setPreferredSize(size: Size): this;
     private setCalculatedSize;
     private calculateSize;
     measure(): void;
@@ -89,7 +88,6 @@ declare class Text<TOptions extends TextOptions = TextOptions> extends Component
     setLineClamp(lines: number): this;
     clearLineClamp(): this;
     applyStyle(element: Handle): this;
-    dispose(): void;
     protected render(): Handle;
 }
 declare const TextCallable: import("../../core/Callable.js").Callable<typeof Text>;

package/dist/lib/types/component/input/TextInput.d.ts

@@ -1,5 +1,6 @@
 import { AbstractInput, AbstractInputOptions } from "../../component/input/AbstractInput.js";
 import type { Handle } from "../../core/DOM.js";
+import { Event } from "../../core/Event.js";
 export interface TextInputOptions extends AbstractInputOptions {
     type?: string;
     text?: string;
@@ -18,8 +19,8 @@ declare class TextInput<TOptions extends TextInputOptions = TextInputOptions> ex
     constructor(options?: TOptions, subclassDefaults?: Partial<TOptions>);
     protected onInput(): void;
     protected applyOptions(options: TOptions): this;
-    on(event: "action", listener: Function): this;
-    on(event: "keydown", listener: (e: KeyboardEvent) => void): this;
+    on(event: "action", listener: Event.Listener): this;
+    on(event: "keydown", listener: (e: KeyboardEvent) => Event.ListenerResult): this;
     on(event: "change", listener: (value: string) => void): this;
     on(event: "binding", listener: () => void): this;
     off(event: "action" | "keydown" | "change" | "binding", listener: Function): this;

package/dist/lib/types/component/list/AbstractSelectableList.d.ts

@@ -2,6 +2,7 @@ import { AbstractInput, AbstractInputOptions } from "../../component/input/Abstr
 import { Component } from "../../core/Component.js";
 import type { Handle } from "../../core/DOM.js";
 import { Panel } from "../../core/Panel.js";
+import { Event } from "../../core/Event.js";
 import { AbstractStore } from "../../data/AbstractStore.js";
 import { ModelRecord } from "../../data/ModelRecord.js";
 import { ListItemRenderer } from "../../component/list/ListItemRenderer.js";
@@ -103,7 +104,7 @@ declare abstract class AbstractSelectableList<TValue, TOptions extends AbstractS
     getSelectedRecord(): ModelRecord | undefined;
     getSelectedIndex(): number;
     setSelectedIndex(idx: number, fireEvent?: boolean): this;
-    on(event: "action", listener: Function): this;
+    on(event: "action", listener: Event.Listener): this;
     on(event: "change", listener: (value: TValue) => void): this;
     on(event: "binding", listener: () => void): this;
     on(event: "contextmenu", listener: (index: number, event: MouseEvent) => void): this;

package/dist/lib/types/component/menubar/MenuBarButton.d.ts

@@ -11,7 +11,7 @@ declare class MenuBarButton extends Button<MenuBarButtonOptions> {
         height: number;
     };
     setActive(active: boolean): this;
-    dispose(): void;
+    protected destructor(): void;
 }
 declare const MenuBarButtonCallable: import("../../core/Callable.js").Callable<typeof MenuBarButton>;
 type MenuBarButtonCallable = MenuBarButton;

package/dist/lib/types/core/AnimatedDropdown.d.ts

@@ -1,4 +1,5 @@
 import { Component, ComponentOptions } from "../core/Component.js";
+import { Animation } from "../core/Animation.js";
 import { DismissableLayer, LayerDismissMode } from "../core/LayerManager.js";
 import { type Rect, type Handle } from "../core/DOM.js";
 export interface AnimatedDropdownOptions extends ComponentOptions {
@@ -17,6 +18,8 @@ declare class AnimatedDropdown<TOptions extends AnimatedDropdownOptions = Animat
     private _open;
     private _closeHandler;
     private _anchorElement;
+    private _showAnimation;
+    private _hideAnimation;
     constructor(options?: AnimatedDropdownOptions, subclassDefaults?: Partial<AnimatedDropdownOptions>);
     protected applyOptions(options: TOptions): this;
     setAnimated(value: boolean): this;
@@ -33,6 +36,7 @@ declare class AnimatedDropdown<TOptions extends AnimatedDropdownOptions = Animat
     placeAnchored(rect: Rect): this;
     protected onShowComplete(): void;
     protected onHideComplete(): void;
+    protected destructor(): void;
     getLayerElement(): Handle | null;
     getDismissMode(): LayerDismissMode;
     requestClose(): void;
@@ -41,8 +45,8 @@ declare class AnimatedDropdown<TOptions extends AnimatedDropdownOptions = Animat
     setCloseHandler(handler: (() => void) | null): this;
     setAnchorElement(el: Handle | null): this;
 }
-export declare function fadeShow(component: Component, options?: FadeOptions): void;
-export declare function fadeHideAndDetach(component: Component, options?: FadeOptions): void;
+export declare function fadeShow(component: Component, options?: FadeOptions): Animation.CancelHandle;
+export declare function fadeHideAndDetach(component: Component, options?: FadeOptions): Animation.CancelHandle;
 declare const AnimatedDropdownCallable: import("../core/Callable.js").Callable<typeof AnimatedDropdown>;
 type AnimatedDropdownCallable<TOptions extends AnimatedDropdownOptions = AnimatedDropdownOptions> = AnimatedDropdown<TOptions>;
 export { AnimatedDropdown as _AnimatedDropdown, AnimatedDropdownCallable as AnimatedDropdown };

package/dist/lib/types/core/Animation.d.ts

@@ -1,4 +1,5 @@
 import { Component } from "../core/Component.js";
+import type { ComponentFactory } from "../core/Component.js";
 import type { Handle } from "../core/DOM.js";
 export declare namespace Animation {
     interface PlayConfig {
@@ -11,7 +12,7 @@ export declare namespace Animation {
         fallbackBufferMs?: number;
     }
     function isReducedMotion(): boolean;
-    function play(el: Handle, config: PlayConfig): void;
+    function play(el: Handle, config: PlayConfig): CancelHandle;
     interface AfterTransitionConfig {
         component: Component;
         property?: string;
@@ -19,7 +20,7 @@ export declare namespace Animation {
         fallbackBufferMs?: number;
         onComplete: () => void;
     }
-    function afterTransition(config: AfterTransitionConfig): void;
+    function afterTransition(config: AfterTransitionConfig): CancelHandle;
     interface TweenConfig<T extends {
         [K in keyof T]: number;
     }> {
@@ -30,18 +31,20 @@ export declare namespace Animation {
         onStep: (values: T) => void;
         onComplete?: () => void;
     }
-    interface TweenHandle {
+    interface CancelHandle {
         cancel(): void;
     }
     function tween<T extends {
         [K in keyof T]: number;
-    }>(config: TweenConfig<T>): TweenHandle;
+    }>(config: TweenConfig<T>): CancelHandle;
     interface MaterializeConfig {
         host: Component;
-        factory: () => Component;
+        factory: ComponentFactory;
         spinnerComponent: Component;
         fadeMs?: number;
         onReady?: (component: Component) => void;
+        onError?: (error: unknown) => void;
+        isStale?: () => boolean;
     }
-    function materialize(config: MaterializeConfig): void;
+    function materialize(config: MaterializeConfig): CancelHandle;
 }

package/dist/lib/types/core/Component.d.ts

@@ -7,6 +7,7 @@ import { BaseObject } from "../core/BaseObject.js";
 import { LayoutConstraints } from "../layout/LayoutConstraints.js";
 import { Position } from "../primitive/Position.js";
 import { Aria } from "../core/Aria.js";
+import { Event } from "../core/Event.js";
 import { StyleRule } from "../core/StyleTarget.js";
 export interface Comparator<V, U> {
     (a: V, b: U): number;
@@ -20,8 +21,9 @@ export interface PerimeterSize {
     bottom: number;
     left: number;
 }
+export type ComponentFactory = () => Component | Promise<Component>;
 export interface ConstrainedComponent {
-    component: Component;
+    component: Component | ComponentFactory;
     constraints?: LayoutConstraints;
 }
 export interface ComponentStyleRuleSpec {
@@ -61,7 +63,7 @@ export interface ComponentOptions {
     id?: string;
     name?: string | null;
     attributes?: Record<string, string>;
-    components?: Array<Component | ConstrainedComponent>;
+    components?: Array<Component | ComponentFactory | ConstrainedComponent>;
     styleRules?: ComponentStyleRuleSpec[];
 }
 declare class Component<TOptions extends ComponentOptions = ComponentOptions> extends BaseObject {
@@ -73,6 +75,7 @@ declare class Component<TOptions extends ComponentOptions = ComponentOptions> ex
     private readonly _themeCleanups;
     private _tag;
     private _attributes;
+    private _elementAttributes;
     private _boxSizing;
     private _left;
     private _top;
@@ -125,6 +128,7 @@ declare class Component<TOptions extends ComponentOptions = ComponentOptions> ex
     protected applyChromeOptions(options: TOptions): void;
     protected applyListeners(listeners: Record<string, ((...args: any[]) => void) | undefined> | undefined): void;
     protected subscribeTheme(listener: () => void): void;
+    dispose(): void;
     protected destructor(): void;
     protected trackHandle(handle: Handle): Handle;
     private trackSelector;
@@ -231,14 +235,15 @@ declare class Component<TOptions extends ComponentOptions = ComponentOptions> ex
     getPreferredSizeConstraint(): Size | null;
     getPreferredSize(): Size | null;
     private clampPreferredToConstraints;
-    setPreferredSize(width: number, height: number): this;
+    setPreferredSize(size: Size): this;
+    clearPreferredSize(): this;
     getMinSizeConstraint(): Size | null;
     getMaxSizeConstraint(): Size | null;
     private mergeConstraintSize;
     getMinSize(): Size | null;
-    setMinSize(width: number, height: number): this;
+    setMinSize(size: Size): this;
     getMaxSize(): Size | null;
-    setMaxSize(width: number, height: number): this;
+    setMaxSize(size: Size): this;
     getInnerSize(): Size | null;
     getBorderSize(): PerimeterSize;
     private estimateBorderSideWidth;
@@ -331,10 +336,10 @@ declare class Component<TOptions extends ComponentOptions = ComponentOptions> ex
     private materialiseDeferredRules;
     sync(): void;
     getParentComponent(): Component | null;
-    addComponents(...specs: Array<Component | ConstrainedComponent | Array<Component | ConstrainedComponent>>): this;
+    addComponents(...specs: Array<Component | ComponentFactory | ConstrainedComponent | Array<Component | ComponentFactory | ConstrainedComponent>>): this;
     private wireChild;
     private unwireChild;
-    addComponent(component: Component, constraints?: LayoutConstraints): this;
+    addComponent(component: Component | ComponentFactory, constraints?: LayoutConstraints): this;
     insertComponent(component: Component, index: number, constraints?: LayoutConstraints): this;
     moveComponent(child: Component, index?: number, constraints?: LayoutConstraints): this;
     removeComponent(component: Component): LayoutConstraints | undefined;
@@ -359,10 +364,10 @@ declare class Component<TOptions extends ComponentOptions = ComponentOptions> ex
     static afterNextLayout(callback: () => void): void;
     flushLayout(): this;
     static flushEffectiveVisibility(): void;
-    addMouseDownListener(listener: Function): this;
-    removeMouseDownListener(listener: Function): this;
-    addMouseDownSubtreeListener(listener: Function): this;
-    removeMouseDownSubtreeListener(listener: Function): this;
+    addMouseDownListener(listener: Event.Listener): this;
+    removeMouseDownListener(listener: Event.Listener): this;
+    addMouseDownSubtreeListener(listener: Event.Listener): this;
+    removeMouseDownSubtreeListener(listener: Event.Listener): this;
     protected init(element?: Handle): this;
     protected createRootElement(): Handle;
     protected render(): Handle;