@jimka/typescript-ui 0.1.0 → 0.1.1

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-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};
 //# sourceMappingURL=primitive.es.js.map

package/dist/lib/router.es.js

@@ -0,0 +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};
+//# 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/container/SplitGutter.d.ts

@@ -52,7 +52,7 @@ declare class SplitGutter extends Component<SplitGutterOptions> {
     destroy(): void;
     private _dispatchDrag;
     onDragStart(evnt: MouseEvent): void;
-    onDragStop(): void;
+    onDragStop(e?: Event): void;
     onDrag(evnt: MouseEvent): void;
     private dragCursor;
     private applyCursor;

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

@@ -34,7 +34,7 @@ declare class WindowBorder extends Component<WindowBorderOptions> {
     isSnapTarget(): boolean;
     setSnapTarget(value: boolean): this;
     onDragStart(): void;
-    onDragStop(): void;
+    onDragStop(e?: Event): void;
     private dragCursor;
     render(): import("../../core/DOM.js").Handle;
 }

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,6 +17,8 @@ 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;
@@ -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/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/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,6 +37,11 @@ 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;

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/core/DOM.d.ts

@@ -78,6 +78,8 @@ export interface DOMSink {
     blur(handle: Handle): void;
     setValue(handle: Handle, value: string): void;
     setSelectionRange(handle: Handle, start: number, end: number): void;
+    setLocationHash(hash: string): void;
+    replaceLocationHash(hash: string): void;
     addListener<T extends Event = Event>(target: Handle, type: string, handler: (event: T) => void, options?: boolean | AddEventListenerOptions): void;
     removeListener<T extends Event = Event>(target: Handle, type: string, handler: (event: T) => void, options?: boolean | EventListenerOptions): void;
     dispatchEvent(target: Handle, event: Event): void;
@@ -130,6 +132,7 @@ export interface DOMSource {
     matchMedia(query: string): MediaQueryResult;
     isWindow(target: Handle | null): boolean;
     getWindow(): Handle;
+    getLocationHash(): string;
     contains(ancestor: Handle, node: Handle | null): boolean;
     querySelector(root: Handle, selector: string): Handle | null;
     querySelectorAll(root: Handle, selector: string): Handle[];
@@ -194,6 +197,8 @@ export declare class ProductionDOMSink implements DOMSink {
     blur(handle: Handle): void;
     setValue(handle: Handle, value: string): void;
     setSelectionRange(handle: Handle, start: number, end: number): void;
+    setLocationHash(hash: string): void;
+    replaceLocationHash(hash: string): void;
     addListener<T extends Event = Event>(target: Handle, type: string, handler: (event: T) => void, options?: boolean | AddEventListenerOptions): void;
     removeListener<T extends Event = Event>(target: Handle, type: string, handler: (event: T) => void, options?: boolean | EventListenerOptions): void;
     dispatchEvent(target: Handle, event: Event): void;
@@ -246,6 +251,7 @@ export declare class ProductionDOMSource implements DOMSource {
     matchMedia(query: string): MediaQueryResult;
     isWindow(target: Handle | null): boolean;
     getWindow(): Handle;
+    getLocationHash(): string;
     contains(ancestor: Handle, node: Handle | null): boolean;
     querySelector(root: Handle, selector: string): Handle | null;
     querySelectorAll(root: Handle, selector: string): Handle[];

package/dist/lib/types/overlay/AbstractWindow.d.ts

@@ -158,7 +158,7 @@ export declare abstract class AbstractWindow extends Container<WindowOptions> im
     private clampDragDelta;
     clampPositionToViewport(): this;
     onDrag(e: MouseEvent): void;
-    onMouseUp(): void;
+    onMouseUp(e?: Event): void;
     doLayout(): this;
     render(): Handle;
     private currentRect;

package/dist/lib/types/router/RoutePattern.d.ts

@@ -0,0 +1,18 @@
+export type SegmentKind = "static" | "param" | "catchAll";
+export interface RouteSegment {
+    kind: SegmentKind;
+    value: string;
+}
+export interface CompiledPattern {
+    pattern: string;
+    key: string;
+    segments: RouteSegment[];
+}
+export declare function normalizePath(input: string): string;
+export declare function splitPath(path: string): string[];
+export declare function compilePattern(pattern: string): CompiledPattern;
+export declare function matchPattern(compiled: CompiledPattern, segments: string[]): Record<string, string> | null;
+export declare function selectPattern<T extends CompiledPattern>(compiled: readonly T[], path: string): {
+    compiled: T;
+    params: Record<string, string>;
+} | null;

package/dist/lib/types/router/Router.d.ts

@@ -0,0 +1,36 @@
+export type RouteParams = Record<string, string>;
+export type RouteHandler = (params: RouteParams, path: string) => void;
+export type RouterEvent = "navigate" | "nomatch";
+export interface RouteMatch {
+    pattern: string;
+    params: RouteParams;
+    path: string;
+}
+export interface RouterOptions {
+    routes?: Record<string, RouteHandler>;
+    listeners?: Partial<{
+        navigate: (match: RouteMatch) => void;
+        nomatch: (path: string) => void;
+    }>;
+}
+export declare class Router {
+    private _routes;
+    private _listeners;
+    private _started;
+    private readonly _onHashChange;
+    constructor(options?: RouterOptions);
+    register(pattern: string, handler: RouteHandler): this;
+    start(): this;
+    stop(): this;
+    navigate(path: string, options?: {
+        replace?: boolean;
+    }): this;
+    getPath(): string;
+    on(event: "navigate", listener: (match: RouteMatch) => void): this;
+    on(event: "nomatch", listener: (path: string) => void): this;
+    off(event: RouterEvent, listener: Function): this;
+    protected emit(event: RouterEvent, payload: unknown): void;
+    private applyCurrentRoute;
+    protected applyOptions(options: RouterOptions): void;
+    private handleHashChange;
+}

package/dist/lib/types/router/index.d.ts

@@ -0,0 +1,2 @@
+export { Router } from '../router/Router.js';
+export type { RouteParams, RouteHandler, RouterEvent, RouteMatch, RouterOptions } from '../router/Router.js';

package/dist/lib/validation.es.js

@@ -1 +1 @@
-import{t as e}from"./FieldDecorator-E7WzutjO.js";export{e as FieldDecorator};
+import{t as e}from"./FieldDecorator-Bl0h9UEF.js";export{e as FieldDecorator};

package/llms.txt

@@ -99,14 +99,18 @@ Organized by task. Columns: task → symbol · import subpath · summary · docs
 - Node in a tree store → **TreeNode** · `@jimka/typescript-ui/data` · A node in a TreeStore's hierarchy: a thin structural wrapper around a ModelRecord, carrying parent/child links, depth, and leaf state. The… · docs/data/store.md
 - Relate models (has-many / belongs-to) → **Association** · `@jimka/typescript-ui/data` · Declarative association descriptor; behaviour lives in AbstractModel / ModelRecord / AbstractStore. · docs/data/associations.md
 
+### App shell
+- Map the URL hash to a top-level app section → **Router** · `@jimka/typescript-ui/router` · Maps the URL hash to a single top-level app section. Patterns are registered with register (e.g. `"/data/rows/:sel"`); on a navigation, the… · docs/concepts/routing.md
+
 ## Conventions (hard rules)
 1. Never use CSS flex/grid or `position: relative` — arrange children with a LayoutManager (HBox/VBox/Border/Grid/Split/…). → docs/concepts/layout-system.md
 2. Size with setMinSize/setPreferredSize/setMaxSize honouring min ≤ preferred ≤ max; to scroll, wrap content in a Panel with autoScroll — never `overflow` CSS. → docs/concepts/sizing.md
 3. Construct with the callable + options-bag idiom (`Button({ text })`), not post-construction setters; reserve `setX` for runtime changes. → docs/recipes/component-options.md
-4. Route DOM events through the `Event` class (`Event.addListener`); emit and observe semantic events with `on`/`off`/`emit`. Never call `addEventListener`. → docs/concepts/events.md
-5. Theme through design tokens, never hardcoded colours. → docs/concepts/theming.md
-6. Move data through Model/Store/Binding, not manual DOM writes — bind components to records instead of pushing values by hand. → docs/concepts/data-binding.md
-7. One DOM element per component class; touch the element only at render time, not from a setter dispatched during construction. → docs/concepts/component-lifecycle.md
+4. Mount the top-level layout with `Body.init({ layoutManager, components })` — one call; use `Body.getInstance()` only to reach the body afterwards. → docs/components/Body.md
+5. Route DOM events through the `Event` class (`Event.addListener`); emit and observe semantic events with `on`/`off`/`emit`. Never call `addEventListener`. → docs/concepts/events.md
+6. Theme through design tokens, never hardcoded colours. → docs/concepts/theming.md
+7. Move data through Model/Store/Binding, not manual DOM writes — bind components to records instead of pushing values by hand. → docs/concepts/data-binding.md
+8. One DOM element per component class; touch the element only at render time, not from a setter dispatched during construction. → docs/concepts/component-lifecycle.md
 
 ## Drill down
 - Component & layout detail (options, examples) → docs/components/, docs/layouts/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jimka/typescript-ui",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A web-based layout manager and UI component framework written in TypeScript.",
   "keywords": ["ui", "ui-components", "typescript", "layout", "layout-manager", "widgets", "framework", "dock", "data-table", "retained-mode"],
   "author": "Jimmy Karlsson",
@@ -41,6 +41,10 @@
       "import": "./dist/lib/validation.es.js",
       "types": "./dist/lib/types/validation/index.d.ts"
     },
+    "./router": {
+      "import": "./dist/lib/router.es.js",
+      "types": "./dist/lib/types/router/index.d.ts"
+    },
     "./component/input": {
       "import": "./dist/lib/component/input.es.js",
       "types": "./dist/lib/types/component/input/index.d.ts"
@@ -188,6 +192,7 @@
     "@lexical/markdown": "^0.46.0",
     "@lexical/rich-text": "^0.46.0",
     "@lexical/selection": "^0.46.0",
+    "@lexical/table": "^0.46.0",
     "@lexical/utils": "^0.46.0",
     "@lezer/highlight": "^1.2.3",
     "codemirror": "^6.0.2",