@jimka/typescript-ui 0.1.0 → 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-B-WfZYAJ.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

@@ -0,0 +1,2 @@
+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/router.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.es.js","names":[],"sources":["../../src/typescript/lib/router/RoutePattern.ts","../../src/typescript/lib/router/Router.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\n// Pure route-pattern mechanics behind Router: normalizing a hash/path,\n// compiling a registered pattern into segments + an ambiguity key, matching a\n// path against a compiled pattern, and picking the most specific match. No\n// DOM seam involved — internal to router/, not exported from the barrel.\n\n/** The kind of a single pattern segment. */\nexport type SegmentKind = \"static\" | \"param\" | \"catchAll\";\n\n/** One segment of a compiled pattern. */\nexport interface RouteSegment {\n    kind:  SegmentKind;\n    /** Literal text for \"static\", the parameter name for \"param\", \"\" for \"catchAll\". */\n    value: string;\n}\n\n/** A pattern parsed into segments, plus its ambiguity key. */\nexport interface CompiledPattern {\n    /** The pattern string as registered, after normalization (e.g. \"/data/:id\"). */\n    pattern:  string;\n    /** Ambiguity key: static segments by literal, \"param\" as \":\", \"catchAll\" as \"*\". */\n    key:      string;\n    segments: RouteSegment[];\n}\n\n/**\n * Normalizes a hash or path to a leading-slash, no-trailing-slash path: strips\n * a leading `\"#\"`, discards everything from the first `\"?\"` onward, and\n * collapses empty segments (so a doubled `\"//\"` and a trailing `\"/\"` both\n * disappear). `\"\"`, `\"#\"`, and `\"#/\"` all normalize to `\"/\"`.\n *\n * @param input - The raw hash (with or without its leading `\"#\"`) or path.\n * @returns The normalized path.\n */\nexport function normalizePath(input: string): string {\n    let path = input.startsWith(\"#\") ? input.slice(1) : input;\n    const queryIndex = path.indexOf(\"?\");\n\n    if (queryIndex >= 0) {\n        path = path.slice(0, queryIndex);\n    }\n\n    return \"/\" + splitPath(path).join(\"/\");\n}\n\n/**\n * Splits a normalized path into its non-empty segments.\n *\n * @param path - The path to split.\n * @returns The segments, in order.\n */\nexport function splitPath(path: string): string[] {\n    return path.split(\"/\").filter((segment) => segment.length > 0);\n}\n\n/**\n * Parses a registered pattern into {@link RouteSegment}s and derives its\n * ambiguity key.\n *\n * @param pattern - The pattern string, e.g. `\"/data/rows/:sel\"`.\n * @returns The compiled pattern.\n * @throws If `\"*\"` appears anywhere but the final segment.\n */\nexport function compilePattern(pattern: string): CompiledPattern {\n    const normalized = normalizePath(pattern);\n    const rawSegments = splitPath(normalized);\n\n    const segments: RouteSegment[] = rawSegments.map((raw, i) => {\n        if (raw === \"*\") {\n            if (i !== rawSegments.length - 1) {\n                throw new Error(`RoutePattern: \"*\" is only valid as the final segment of \"${pattern}\"`);\n            }\n\n            return { kind: \"catchAll\", value: \"\" };\n        }\n\n        if (raw.startsWith(\":\")) {\n            return { kind: \"param\", value: raw.slice(1) };\n        }\n\n        return { kind: \"static\", value: raw };\n    });\n\n    const key = segments\n        .map((segment) => segment.kind === \"static\" ? segment.value : segment.kind === \"param\" ? \":\" : \"*\")\n        .join(\"/\");\n\n    return { pattern: normalized, key, segments };\n}\n\n/**\n * Returns the extracted params when `segments` match `compiled`, or `null`\n * when they don't. A trailing `catchAll` segment matches zero or more\n * remaining segments; every other kind requires an exact segment count.\n * Captured `:param` values run through `decodeURIComponent`, falling back to\n * the raw segment text on a malformed escape.\n *\n * @param compiled - The compiled pattern to match against.\n * @param segments - The candidate path's segments (from {@link splitPath}).\n * @returns The extracted params, or `null` when there is no match.\n */\nexport function matchPattern(compiled: CompiledPattern, segments: string[]): Record<string, string> | null {\n    const patternSegments = compiled.segments;\n    const isCatchAll = patternSegments.length > 0 && patternSegments.at(-1)!.kind === \"catchAll\";\n    const staticLength = isCatchAll ? patternSegments.length - 1 : patternSegments.length;\n\n    if (isCatchAll ? segments.length < staticLength : segments.length !== staticLength) {\n        return null;\n    }\n\n    const params: Record<string, string> = {};\n\n    for (let i = 0; i < staticLength; i += 1) {\n        const patternSegment = patternSegments[i];\n        const value = segments[i];\n\n        if (patternSegment.kind === \"static\") {\n            if (patternSegment.value !== value) {\n                return null;\n            }\n        } else if (patternSegment.kind === \"param\") {\n            params[patternSegment.value] = decodeSegment(value);\n        }\n    }\n\n    return params;\n}\n\n/**\n * Decodes a captured path segment, falling back to the raw text when it\n * carries a malformed percent-escape.\n *\n * @param value - The raw segment text.\n * @returns The decoded value, or `value` unchanged on a decode failure.\n */\nfunction decodeSegment(value: string): string {\n    try {\n        return decodeURIComponent(value);\n    } catch {\n        return value;\n    }\n}\n\n/** Rank of each real segment kind: higher wins a specificity tie-break. */\nconst KIND_RANK: Record<SegmentKind, number> = { static: 2, param: 1, catchAll: 0 };\n\n/**\n * Rank of position `i` in `segments`. Reaching the end of the pattern (`i` at\n * or past its length) outranks every real segment kind — see\n * {@link selectPattern}.\n *\n * @param segments - The pattern's segments.\n * @param i - The position to rank.\n * @returns The rank at that position.\n */\nfunction rankAt(segments: readonly RouteSegment[], i: number): number {\n    return i >= segments.length ? 3 : KIND_RANK[segments[i].kind];\n}\n\n/**\n * Returns the highest-ranked pattern in `compiled` that matches `path`, or\n * `null` when none match. Patterns are compared segment by segment from the\n * left via {@link rankAt}; the first position where two matching patterns\n * differ decides the winner. Two patterns can never tie on every position —\n * that would mean identical ambiguity keys, which the route table (see\n * `Router`) forbids. Registration order never affects the result.\n *\n * @param compiled - The candidate compiled patterns.\n * @param path - The normalized path to match.\n * @returns The winning pattern and its extracted params, or `null`.\n */\nexport function selectPattern<T extends CompiledPattern>(\n    compiled: readonly T[],\n    path:     string,\n): { compiled: T; params: Record<string, string> } | null {\n    const segments = splitPath(path);\n\n    let best:       T | null = null;\n    let bestParams: Record<string, string> | null = null;\n\n    for (const candidate of compiled) {\n        const params = matchPattern(candidate, segments);\n\n        if (params === null) {\n            continue;\n        }\n\n        if (best === null || isMoreSpecific(candidate.segments, best.segments)) {\n            best = candidate;\n            bestParams = params;\n        }\n    }\n\n    return best === null ? null : { compiled: best, params: bestParams! };\n}\n\n/**\n * Whether `a` outranks `b` by {@link rankAt} at the first position where they\n * differ.\n *\n * @param a - The candidate pattern's segments.\n * @param b - The current best pattern's segments.\n * @returns `true` when `a` is more specific than `b`.\n */\nfunction isMoreSpecific(a: readonly RouteSegment[], b: readonly RouteSegment[]): boolean {\n    const length = Math.max(a.length, b.length);\n\n    for (let i = 0; i < length; i += 1) {\n        const rankA = rankAt(a, i);\n        const rankB = rankAt(b, i);\n\n        if (rankA !== rankB) {\n            return rankA > rankB;\n        }\n    }\n\n    return false;\n}\n","// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { DOM } from '~/core/DOM.js';\nimport { ListenerBag } from '~/core/ListenerBag.js';\nimport { compilePattern, normalizePath, splitPath, selectPattern, type CompiledPattern } from '~/router/RoutePattern.js';\n\n/** Params extracted from a matched pattern's `:name` segments. */\nexport type RouteParams = Record<string, string>;\n\n/** A registered route's callback: drives whatever it fronts, never builds it. */\nexport type RouteHandler = (params: RouteParams, path: string) => void;\n\n/** The events a {@link Router} emits. */\nexport type RouterEvent = \"navigate\" | \"nomatch\";\n\n/** The pattern and params a navigation resolved to. */\nexport interface RouteMatch {\n    /** The pattern that won, as registered. */\n    pattern: string;\n    params:  RouteParams;\n    /** The normalized path that was matched. */\n    path:    string;\n}\n\n/** Construction options for {@link Router}. */\nexport interface RouterOptions {\n    /** Patterns to `register` at construction, keyed by pattern string. */\n    routes?:    Record<string, RouteHandler>;\n    listeners?: Partial<{\n        navigate: (match: RouteMatch) => void;\n        nomatch:  (path: string) => void;\n    }>;\n}\n\n/** A registered route: its compiled pattern plus the handler it drives. */\ntype CompiledRoute = CompiledPattern & { handler: RouteHandler };\n\n/**\n * Maps the URL hash to a single top-level app section. Patterns are\n * registered with {@link register} (e.g. `\"/data/rows/:sel\"`); on a\n * navigation, the router selects the most specific matching pattern, extracts\n * its `:param` values, and calls that pattern's handler — the handler drives\n * components that already exist, it never builds them.\n *\n * {@link start} reads the current hash, applies the matching route\n * synchronously, then installs the `hashchange` listener; call it once the\n * app has built its component tree and before the first layout pass runs, so\n * the routed section is already selected when that pass runs. {@link stop}\n * removes the listener.\n *\n * It is a plain class (no DOM element, so not `callable()`-wrapped) — it\n * follows the shape of a data store: an options bag, a private listener bag,\n * and typed `on` / `off` / `emit` forwarders.\n *\n * @category Core\n */\nexport class Router {\n\n    private _routes:    Map<string, CompiledRoute> = new Map();\n    private _listeners: ListenerBag<RouterEvent>   = new ListenerBag<RouterEvent>();\n    private _started:   boolean                    = false;\n\n    // Stable reference so add/remove pair up; delegates to a named method.\n    private readonly _onHashChange: () => void = () => this.handleHashChange();\n\n    /**\n     * @param options - Routes and listeners to register at construction.\n     */\n    constructor(options?: RouterOptions) {\n        this.applyOptions(options ?? {});\n    }\n\n    /**\n     * Registers a pattern's handler. Re-registering the exact same pattern\n     * string replaces its handler silently. Registering a *different*\n     * pattern string that collides with an already-registered one on\n     * specificity (e.g. `\"/users/:id\"` and `\"/users/:name\"`) replaces it too,\n     * but logs a warning naming both patterns — that collision usually\n     * signals an authoring mistake.\n     *\n     * @param pattern - The route pattern, e.g. `\"/data/rows/:sel\"`.\n     * @param handler - Called with the extracted params and the normalized\n     * path when this pattern wins a navigation.\n     * @returns This router, for chaining.\n     */\n    register(pattern: string, handler: RouteHandler): this {\n        const compiled = compilePattern(pattern);\n        const existing  = this._routes.get(compiled.key);\n\n        if (existing !== undefined && existing.pattern !== compiled.pattern) {\n            console.warn(`Router: \"${existing.pattern}\" and \"${compiled.pattern}\" have the same specificity; \"${compiled.pattern}\" replaces it.`);\n        }\n\n        this._routes.set(compiled.key, { ...compiled, handler });\n\n        return this;\n    }\n\n    /**\n     * Reads the current hash, applies the matching route synchronously, then\n     * installs the `hashchange` listener. Calling `start()` again on an\n     * already-started router logs a warning and is otherwise a no-op — it\n     * does not install a second listener.\n     *\n     * @returns This router, for chaining.\n     */\n    start(): this {\n        if (this._started) {\n            console.warn(`Router: start() called on an already-started router; ignoring.`);\n\n            return this;\n        }\n\n        this._started = true;\n        this.applyCurrentRoute();\n        DOM.sink.addListener(DOM.source.getWindow(), \"hashchange\", this._onHashChange);\n\n        return this;\n    }\n\n    /**\n     * Removes the `hashchange` listener. Safe to call when never started, or\n     * more than once.\n     *\n     * @returns This router, for chaining.\n     */\n    stop(): this {\n        if (!this._started) {\n            return this;\n        }\n\n        DOM.sink.removeListener(DOM.source.getWindow(), \"hashchange\", this._onHashChange);\n        this._started = false;\n\n        return this;\n    }\n\n    /**\n     * Writes `path` into the hash — pushing a history entry, or replacing the\n     * current one when `options.replace` is `true`. Each segment is\n     * percent-encoded. Writing the path already in the hash is a same-value\n     * write: it fires no `hashchange` and re-runs no handler.\n     *\n     * @param path - The path to navigate to, e.g. `\"/settings\"`.\n     * @param options - `replace` to replace the current history entry instead\n     * of pushing a new one.\n     * @returns This router, for chaining.\n     */\n    navigate(path: string, options?: { replace?: boolean }): this {\n        const segments = splitPath(normalizePath(path));\n        const hash = \"#/\" + segments.map((segment) => encodeURIComponent(segment)).join(\"/\");\n\n        if (options?.replace === true) {\n            DOM.sink.replaceLocationHash(hash);\n        } else {\n            DOM.sink.setLocationHash(hash);\n        }\n\n        return this;\n    }\n\n    /**\n     * The normalized path currently in the hash.\n     *\n     * @returns The current path.\n     */\n    getPath(): string {\n        return normalizePath(DOM.source.getLocationHash());\n    }\n\n    on(event: \"navigate\", listener: (match: RouteMatch) => void): this;\n    on(event: \"nomatch\",  listener: (path: string) => void): this;\n\n    /**\n     * Subscribes a listener to a router event. Listeners fire in\n     * registration order.\n     *\n     * @param event - The event to listen for.\n     * @param listener - The callback to invoke.\n     * @returns This router, for chaining.\n     */\n    on(event: RouterEvent, listener: Function): this {\n        this._listeners.add(event, listener);\n\n        return this;\n    }\n\n    /**\n     * Removes a previously registered listener. No-op if it was never\n     * registered for that event.\n     *\n     * @param event - The event the listener was registered for.\n     * @param listener - The exact callback reference to remove.\n     * @returns This router, for chaining.\n     */\n    off(event: RouterEvent, listener: Function): this {\n        this._listeners.remove(event, listener);\n\n        return this;\n    }\n\n    /**\n     * Notifies all listeners registered for an event, in registration order.\n     *\n     * @param event - The event to emit.\n     * @param payload - The value passed to each listener.\n     */\n    protected emit(event: RouterEvent, payload: unknown): void {\n        this._listeners.fire(event, payload);\n    }\n\n    /**\n     * Reads the current hash and calls the most specific matching pattern's\n     * handler, emitting `\"navigate\"` — or emits `\"nomatch\"` when nothing\n     * matches. Shared by {@link start} and the `hashchange` listener.\n     */\n    private applyCurrentRoute(): void {\n        const path   = this.getPath();\n        const result = selectPattern(Array.from(this._routes.values()), path);\n\n        if (result === null) {\n            this.emit(\"nomatch\", path);\n\n            return;\n        }\n\n        const match: RouteMatch = { pattern: result.compiled.pattern, params: result.params, path };\n\n        result.compiled.handler(result.params, path);\n        this.emit(\"navigate\", match);\n    }\n\n    /**\n     * Applies an {@link RouterOptions} bag: registers `routes`, then wires\n     * `listeners`. Called from the constructor body, after every field\n     * initializer has run.\n     *\n     * @param options - The options bag to apply.\n     */\n    protected applyOptions(options: RouterOptions): void {\n        if (options.routes !== undefined) {\n            for (const pattern of Object.keys(options.routes)) {\n                this.register(pattern, options.routes[pattern]);\n            }\n        }\n\n        if (options.listeners !== undefined) {\n            for (const event of Object.keys(options.listeners) as RouterEvent[]) {\n                const listener = options.listeners[event];\n\n                if (listener !== undefined) {\n                    this._listeners.add(event, listener);\n                }\n            }\n        }\n    }\n\n    private handleHashChange(): void {\n        this.applyCurrentRoute();\n    }\n}\n"],"mappings":"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"}

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(): 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(): 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

@@ -1,8 +1,14 @@
 import { Component, ComponentOptions } from "../../core/Component.js";
 import type { Handle } from "../../core/DOM.js";
 import { Size } from "../../primitive/Size.js";
+export interface MarkdownLinkResolution {
+    href: string;
+    external: boolean;
+}
+export type MarkdownLinkResolver = (href: string) => MarkdownLinkResolution;
 export interface MarkdownOptions extends ComponentOptions {
     markdown?: string;
+    linkResolver?: MarkdownLinkResolver;
 }
 declare class Markdown extends Component<MarkdownOptions> {
     private _contentHandles;
@@ -11,11 +17,13 @@ declare class Markdown extends Component<MarkdownOptions> {
     constructor(markdown?: string, options?: MarkdownOptions);
     protected applyOptions(options: MarkdownOptions): this;
     getMarkdown(): string;
+    setLinkResolver(resolver: MarkdownLinkResolver): this;
+    getLinkResolver(): MarkdownLinkResolver;
     setMarkdown(markdown: string): this;
     getMinSize(): Size | null;
     getPreferredSize(): Size | null;
     setWidth(width: number): this;
-    dispose(): void;
+    protected destructor(): void;
     private measureContentHeight;
     protected render(): Handle;
     private create;
@@ -26,6 +34,8 @@ declare class Markdown extends Component<MarkdownOptions> {
     private appendParagraph;
     private appendList;
     private appendListItem;
+    private appendTable;
+    private appendTableRow;
     private appendBlockquote;
     private appendCode;
     private appendInlineTokens;

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/display/index.d.ts

@@ -12,7 +12,7 @@ export type { GlyphDef, NamedGlyphDef } from '../../component/display/Glyphs.js'
 export { IconText } from '../../component/display/IconText.js';
 export type { IconTextOptions } from '../../component/display/IconText.js';
 export { Markdown } from '../../component/display/Markdown.js';
-export type { MarkdownOptions } from '../../component/display/Markdown.js';
+export type { MarkdownOptions, MarkdownLinkResolution, MarkdownLinkResolver } from '../../component/display/Markdown.js';
 export { IconLabel } from '../../component/display/IconLabel.js';
 export type { IconLabelOptions } from '../../component/display/IconLabel.js';
 export { ProgressBar } from '../../component/display/ProgressBar.js';

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

@@ -16,6 +16,7 @@ export interface MarkdownEditorOptions extends ComponentOptions {
 declare class MarkdownEditor extends Component<MarkdownEditorOptions> {
     private _editor;
     private _unregister;
+    private _unregisterTableView;
     private readonly _listeners;
     private readonly _card;
     private readonly _wysiwyg;
@@ -36,12 +37,17 @@ declare class MarkdownEditor extends Component<MarkdownEditorOptions> {
     toggleOrderedList(): this;
     toggleLink(url: string | null): this;
     setBlockType(type: MarkdownBlockType): this;
+    insertTable(rows: number, columns: number): this;
+    insertTableRow(after?: boolean): this;
+    deleteTableRow(): this;
+    insertTableColumn(after?: boolean): this;
+    deleteTableColumn(): this;
     on(event: MarkdownEditorEvent, listener: (payload: MarkdownEditorChange) => void): this;
     off(event: MarkdownEditorEvent, listener: (payload: MarkdownEditorChange) => void): this;
     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/editor/markdownTableTransformer.d.ts

@@ -0,0 +1,2 @@
+import type { MultilineElementTransformer, Transformer } from "@lexical/markdown";
+export declare function createTableTransformer(getTransformers: () => Transformer[]): MultilineElementTransformer;

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;
 }