@jimka/typescript-ui 0.1.0

package/dist/lib/Text-D1RrBY52.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text-D1RrBY52.js","names":[],"sources":["../../src/typescript/lib/component/input/Text.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Component, ComponentOptions } from \"~/core/Component.js\";\nimport { ThemeManager } from \"~/core/Theme.js\";\nimport { DOM } from \"~/core/DOM.js\";\nimport type { Handle } from \"~/core/DOM.js\";\nimport { Util } from \"~/core/Util.js\";\nimport { Size } from \"~/primitive/Size.js\";\nimport { callable } from \"~/core/Callable.js\";\n\n/**\n * Construction-time options for {@link Text}.\n *\n * @category Components\n */\nexport interface TextOptions extends ComponentOptions {\n    tag?:            string;\n    text?:           string;\n    textAlign?:      string;\n    textShadow?:     string;\n    fontFamily?:     string;\n    fontSize?:       number | string;\n    fontWeight?:     string;\n    fontStyle?:      string;\n    fontVariant?:    string;\n    fontStretch?:    string;\n    fontKerning?:    string;\n    fontSizeAdjust?: string;\n    lineHeight?:     number | string;\n    textOverflow?:   string;\n    whiteSpace?:     string;\n    /**\n     * When `true` (default), the text is single-line + clipped + ellipsised\n     * when its rendered width is below its natural width, and `minSize.width`\n     * is capped at `100` so parent layouts can shrink the text past its\n     * natural width.\n     *\n     * When `false`, no ellipsis is applied and `minSize.width` reports the\n     * full natural width — the text refuses to be squeezed, forcing the\n     * parent to widen (used by [`Button`](/api/component/button/classes/Button)\n     * for the label so the button grows to fit its text instead of clipping).\n     */\n    truncate?:       boolean;\n}\n\n/**\n * Module-level class defaults forwarded to `super` via the options bag so the\n * `applyOptions` cascade dispatches each setter once with the final value.\n *\n * `fontFamily` and `lineHeight` are intentionally **omitted**:\n *\n * - `fontFamily` must remain a getter-fallback only. Routing it through\n *   `setFontFamily(...)` would write the literal `var(--ts-ui-font-family, …)`\n *   onto every Text's CSS rule, blocking a parent's `font-family` override\n *   from cascading through.\n * - `lineHeight` is theme-derived (`readThemeLineHeightPx()`), so the value\n *   isn't known at module load. It is resolved lazily on first\n *   `calculateSize()` (post-attach), keeping construction JS-only per\n *   ARCHITECTURE.md \"Defer DOM work to render time\".\n */\nconst _defaultTextOptions: Partial<TextOptions> = {\n    tag:            \"span\",\n    textAlign:      \"left\",\n    fontKerning:    \"auto\",\n    fontSize:       14,\n    fontSizeAdjust: \"none\",\n    fontStretch:    \"normal\",\n    fontStyle:      \"normal\",\n    fontVariant:    \"normal\",\n    fontWeight:     \"normal\",\n    truncate:       true,\n};\n\n// Upper bound for the auto-derived `minSize.width` from text measurement —\n// short labels report their full measured width (so they're never truncated\n// when the container has room), longer text caps here so the parent layout\n// always has room to shrink the Text below its natural width.\nconst TEXT_AUTO_MIN_WIDTH_CAP_PX = 100;\n\n// Default theme-tracking line-height rule: the control's own font size plus the\n// `--ts-ui-line-padding` leading, so the line box scales per font size. `1em`\n// resolves against the element's own font-size at both render and measure time.\n// `2px` is the shipped `--ts-ui-line-padding` default, used only if the var is\n// absent. A control overrides this with an explicit px via `setLineHeight`.\nconst ADDITIVE_LINE_HEIGHT_RULE = \"calc(1em + var(--ts-ui-line-padding, 2px))\";\n\n/**\n * A text-displaying component with comprehensive font and layout controls.\n *\n * Uses an off-screen probe element to measure text dimensions and automatically\n * updates the preferred size whenever the text or a font property changes.\n *\n * `Text` subscribes to {@link ThemeManager} on construction so it re-measures itself\n * on every theme change. Components that create `Text` instances dynamically and\n * remove them from the page should call `text.dispose()` to detach the listener.\n *\n * @category Components\n */\nclass Text<TOptions extends TextOptions = TextOptions> extends Component<TOptions> {\n\n    private _hasExplicitPreferredSize: boolean = false;\n    private _fontSizeCSSVar : string | null = \"--ts-ui-font-size\";\n    private _fontSizeCSSRule: string | null = \"var(--ts-ui-font-size, 14px)\";\n    private readonly _unsubscribeTheme: () => void;\n    private _lineHeightCSSVar : string | null = null;\n    private _lineHeightCSSRule: string | null = ADDITIVE_LINE_HEIGHT_RULE;\n    private _measuredBaseline: number | null = null;\n    private _measuredMinSize: Size | null = null;\n    private _autoMeasure: boolean = true;\n    private _measurementDirty: boolean = true;\n    private _wordBreak: string | null = null;\n    private _lineClamp: number | null = null;\n    private _textOverflow: string | null = null;\n    private _truncate: boolean = true;\n\n    // `NoInfer` on `options` keeps a partial options literal from narrowing\n    // TOptions to just the keys it carries: `new Text(\"x\", { fontWeight: \"600\" })`\n    // must stay a `Text<TextOptions>` (assignable to Component), not a\n    // `Text<{ fontWeight: string }>` (whose narrowed option type is not). Subclasses\n    // still fix TOptions through `extends Text<MyOptions>`, not argument inference.\n    constructor(text?: String, options?: NoInfer<TOptions>, subclassDefaults?: Partial<TOptions>) {\n        super(\n            options,\n            { ..._defaultTextOptions, ...(subclassDefaults ?? {}) } as Partial<TOptions>,\n        );\n\n        // Carve-out fallbacks — see `_defaultTextOptions` for why these two\n        // don't ride the merge-defaults cascade. Both are consulted by their\n        // getters as a fallback when `_options.X` is undefined.\n        //\n        // Note: the cascade-driven `setFontSize(14)` clobbers `fontSizeCSSVar`\n        // and `fontSizeCSSRule` to null, but Text's field initializers (which\n        // run after super returns) restore both to their var-binding values —\n        // so theme reactivity is preserved by the DOM `var(...)` binding even\n        // though the cascade temporarily writes a literal.\n        //\n        // `_defaultOptions.lineHeight` is resolved lazily on first\n        // `calculateSize()` (post-attach) — see ARCHITECTURE.md \"Defer DOM\n        // work to render time\".\n        this._defaultOptions.fontFamily = \"var(--ts-ui-font-family, system-ui, sans-serif)\";\n\n        this.clearInsets();\n        this.setElementCSSRule(\"lineHeight\", this._lineHeightCSSRule);\n\n        this._unsubscribeTheme = ThemeManager.onThemeChange(() => {\n            if (this._fontSizeCSSVar) {\n                // Resolve from the element's computed font-size (the cascade has\n                // applied the new var by the time onThemeChange fires); the root\n                // custom property reads back as an unevaluated calc() string.\n                const resolved = this.resolveBoundFontSizePx();\n\n                if (resolved !== null) {\n                    // Route to `_options` so the post-cascade explicit value\n                    // (set by `setFontSize(14)` during applyOptions) is\n                    // overwritten on theme change. Writing to `_defaultOptions`\n                    // here would be shadowed by `_options.fontSize = 14` in\n                    // the `getFontSize` fallback, breaking re-flow.\n                    this._options.fontSize = resolved as TOptions[\"fontSize\"];\n                }\n            }\n\n            if (this._lineHeightCSSVar) {\n                this._defaultOptions.lineHeight = this.readThemeLineHeightPx();\n            }\n\n            this.calculateSize();\n        });\n\n        // Positional `text` constructor argument: write to the bag only when\n        // the caller didn't also pass `options.text` (which would have been\n        // dispatched via super's applyOptions cascade and should win).\n        if (text !== undefined && this._options.text === undefined) {\n            this.setText(text);\n        }\n\n        // Off-screen text measurement is deferred until the first\n        // getPreferredSize / getBaseline call so construction stays JS-only\n        // (no forced layout from `DOM.source.measureText`).\n        this._measurementDirty = true;\n    }\n\n    /**\n     * Applies a {@link TextOptions} bag to this component, dispatching font and\n     * text properties to their corresponding setters after the inherited\n     * Component fields have been applied.\n     *\n     * @param options - The options bag carrying the values to apply.\n     */\n    protected applyOptions(options: TOptions): this {\n        super.applyOptions(options);\n\n        // Dispatch only caller-supplied values. Class-level font defaults (e.g.\n        // the 14px size, a subclass's bold weight) are resolved lazily by the\n        // font getters' `_defaultOptions` fallback, which `applyStyle` re-reads\n        // at render — so they never enter `_options`.\n        if (options.text !== undefined) {\n            this.setText(options.text);\n        }\n\n        if (options.textAlign !== undefined) {\n            this.setTextAlign(options.textAlign);\n        }\n\n        if (options.textShadow !== undefined) {\n            this.setTextShadow(options.textShadow);\n        }\n\n        if (options.fontFamily !== undefined) {\n            this.setFontFamily(options.fontFamily);\n        }\n\n        if (options.fontSize !== undefined) {\n            this.setFontSize(options.fontSize);\n        }\n\n        if (options.fontWeight !== undefined) {\n            this.setFontWeight(options.fontWeight);\n        }\n\n        if (options.fontStyle !== undefined) {\n            this.setFontStyle(options.fontStyle);\n        }\n\n        if (options.fontVariant !== undefined) {\n            this.setFontVariant(options.fontVariant);\n        }\n\n        if (options.fontStretch !== undefined) {\n            this.setFontStretch(options.fontStretch);\n        }\n\n        if (options.fontKerning !== undefined) {\n            this.setFontKerning(options.fontKerning);\n        }\n\n        if (options.fontSizeAdjust !== undefined) {\n            this.setFontSizeAdjust(options.fontSizeAdjust);\n        }\n\n        if (options.lineHeight !== undefined) {\n            this.setLineHeight(options.lineHeight);\n        }\n\n        if (options.textOverflow !== undefined) {\n            this.setTextOverflow(options.textOverflow);\n        }\n\n        if (options.whiteSpace !== undefined) {\n            this.setWhiteSpace(options.whiteSpace);\n        }\n\n        // `truncate` carries a class default (true) and applies its CSS\n        // (white-space / overflow / text-overflow) imperatively via the setter\n        // with no render re-read, so always dispatch the caller value or the\n        // default — otherwise a default-truncating Text never gets the CSS.\n        this.setTruncate(options.truncate ?? this._defaultOptions.truncate!);\n\n        return this;\n    }\n\n    /**\n     * Resolves this `Text`'s line box height in pixels under the additive\n     * leading model.\n     *\n     * @returns `Util.lineHeightPx(fontSize)` — the control's own font size plus\n     * the `--ts-ui-line-padding` leading — for the default theme-tracking case.\n     * A legacy custom line-height var binding resolves that var as a fixed line\n     * box instead, falling back to the additive value when it is unparseable.\n     *\n     * @remarks `_options.fontSize` is always a resolved px number here (a CSS\n     * var passed to `setFontSize` is resolved and stored as a number), so the\n     * leading scales with the control's actual font size — a 12px button title\n     * and a 14px label get proportionate line boxes from the one token. This is\n     * the same arithmetic `Util.lineHeightPx` applies for input box heights, so\n     * a `Text` measures and renders at the line height a sibling input expects.\n     */\n    private readThemeLineHeightPx(): number {\n        // `_options.fontSize` is the resolved px the bound var evaluates to —\n        // `setFontSize`/`onThemeChange` populate it through the probe-backed\n        // `resolveBoundFontSizePx`, so it is correct even pre-attach (a calc()\n        // token included). No element read here: a parent reads this at\n        // construction, before this Text's own element is styled.\n        const fs = (this._options.fontSize as number | undefined) ?? (this._defaultOptions.fontSize as number | undefined) ?? 14;\n\n        if (this._lineHeightCSSVar) {\n            const raw    = DOM.source.getThemeVar(this._lineHeightCSSVar);\n            const parsed = parseFloat(raw);\n\n            if (!isNaN(parsed)) {\n                return parsed;\n            }\n        }\n\n        return Util.lineHeightPx({ fontSizePx: fs });\n    }\n\n    /**\n     * Returns the DOM element handle.\n     *\n     * @param createIfMissing - Optional. When true, renders the element if it does not yet exist.\n     *\n     * @returns The component's element handle.\n     */\n    getElement(createIfMissing: boolean = false): Handle | undefined {\n        return super.getElement(createIfMissing);\n    }\n\n    /**\n     * Resolves the bound font-size var to a px number. A simple var (e.g. the\n     * `--ts-ui-font-size` base) parses straight off the document root; a relative\n     * font token's var holds a `calc(...)` that `getPropertyValue` returns\n     * unevaluated (so `parseFloat` reads `NaN`), so it falls back to a\n     * cascade-evaluating probe via `DOM.source.resolveFontSizePx`. The probe path\n     * works **pre-attach** — before this component's own element is styled —\n     * which is when a parent (e.g. a `Header`) first reads the line-box size.\n     *\n     * @returns The resolved font size in px, or `null` when no var is bound (an\n     *   explicit numeric size was set instead) — callers keep the cached number.\n     */\n    private resolveBoundFontSizePx(): number | null {\n        if (!this._fontSizeCSSVar) return null;   // explicit px size — no var bound\n\n        const raw = parseFloat(DOM.source.getThemeVar(this._fontSizeCSSVar));\n        if (!isNaN(raw)) return raw;              // simple var — cheap, no probe\n\n        return DOM.source.resolveFontSizePx(this._fontSizeCSSRule ?? `var(${this._fontSizeCSSVar})`);\n    }\n\n    /**\n     * Sets the preferred size from an explicit caller, locking it against automatic recalculation.\n     *\n     * @returns This component, for method chaining.\n     */\n    setPreferredSize(width: number, height: number): this {\n        this._hasExplicitPreferredSize = true;\n        super.setPreferredSize(width, height);\n\n        return this;\n    }\n\n    /**\n     * Updates the preferred size from a measurement only when no explicit size has been set.\n     */\n    private setCalculatedSize(width: number, height: number): void {\n        if (!this._hasExplicitPreferredSize) {\n            super.setPreferredSize(width, height);\n        }\n    }\n\n    /**\n     * Measures the text using an off-screen probe element and sets the preferred size.\n     *\n     * @remarks Creates a temporary fixed-positioned invisible `<span>`, appends it to the body\n     * to obtain its bounding rect, then removes it. Sets preferred size to (0, 0) when no text is set.\n     * No-op when {@link setAutoMeasure} is `false` — the parent layout is expected to size this Text.\n     */\n    private calculateSize(): void {\n        this._measurementDirty = false;\n\n        // First-read deferral: populate the default line-height the first\n        // time we measure, when the component is attached and\n        // `getComputedStyle` is safe. Subsequent reads come through the\n        // `ThemeManager.onThemeChange` callback above. Placed before the\n        // `_autoMeasure` gate so non-measuring `Text` instances still get\n        // a resolved value populated for `getLineHeight()` callers.\n        if (this._defaultOptions.lineHeight === undefined) {\n            this._defaultOptions.lineHeight = this.readThemeLineHeightPx();\n        }\n\n        if (!this._autoMeasure) {\n            return;\n        }\n\n        // Floor the reported minimum height to one line so a single-line label\n        // is never squeezed below its line box (the measured height is 0 for\n        // empty text and unset before the first probe).\n        const lineHeightPx  = this.getLineHeight() ?? this.readThemeLineHeightPx();\n        const minLineHeight = Math.ceil(lineHeightPx);\n\n        const text = this._options.text;\n        if (text) {\n            // Natural (single-line) measurement establishes the preferred WIDTH\n            // and the baseline; the height then follows the box's current width,\n            // growing when a wrapping run has been laid out narrower than natural.\n            const natural = DOM.source.measureText(text.toString(), this.measureOptions());\n            const height  = this.measuredHeight(text.toString(), natural.width, natural.height);\n\n            this._measuredBaseline = natural.baseline;\n            this.setCalculatedSize(natural.width, height);\n            // Store the measured floor as per-instance derived state (like\n            // `_measuredBaseline`), kept out of `_defaultOptions`, which holds\n            // the class-level Text defaults rather than per-instance\n            // measurements. `getMinSize` folds this into the inherited min.\n            // When truncation is disabled, report the full natural width so the\n            // parent layout widens to fit instead of squeezing the text;\n            // otherwise cap it so the parent can shrink the text past its\n            // natural width.\n            const autoMinWidth = this._truncate\n                ? Math.min(natural.width, TEXT_AUTO_MIN_WIDTH_CAP_PX)\n                : natural.width;\n            this._measuredMinSize = {\n                width:  autoMinWidth,\n                height: Math.max(height, minLineHeight),\n            };\n        } else {\n            // No glyphs means no baseline — report null so HBox doesn't try\n            // to baseline-align surrounding components against an empty box.\n            // Reserve no line height either: an empty Text (e.g. the label slot\n            // of an icon-only button) must collapse so it doesn't inflate the\n            // container and knock the icon off-centre. The one-line floor only\n            // applies once there is text to keep on its line.\n            this._measuredBaseline = null;\n            this.setCalculatedSize(0, 0);\n            this._measuredMinSize = { width: 0, height: 0 };\n        }\n    }\n\n    /**\n     * Forces a one-off text measurement that ignores {@link setAutoMeasure}.\n     * Use when the caller has opted out of auto-measure but needs an up-to-date\n     * preferred size after a programmatic text change.\n     */\n    measure(): void {\n        const wasAuto = this._autoMeasure;\n        this._autoMeasure = true;\n        this.calculateSize();\n        this._autoMeasure = wasAuto;\n    }\n\n    /**\n     * Returns the visual baseline of the rendered text, accounting for any\n     * border, padding, or framework insets on this component.\n     *\n     * @returns The baseline offset from the component's outer top, in pixels,\n     * or `null` when no text has been measured yet.\n     *\n     * @remarks Forces a measurement when the cached value is stale — the\n     * off-screen probe is deferred from construction so first-call timing\n     * shifts to whoever asks for a size first (usually `doLayout`).\n     */\n    getBaseline(): number | null {\n        if (this._measurementDirty) {\n            this.calculateSize();\n        }\n\n        return this.wrapInnerBaseline(this._measuredBaseline);\n    }\n\n    /**\n     * Builds the font/line-height option bag for a {@link DOM.measureText} probe\n     * from this Text's resolved styling. Shared by the natural (single-line)\n     * measurement and the wrap-aware height re-measurement in\n     * {@link measuredHeight}, which adds a `maxWidth`.\n     *\n     * @returns The measure options (font family/size/weight/style/variant/stretch\n     *   and line height), each `undefined` when unset so the probe's own default\n     *   applies.\n     */\n    private measureOptions() {\n        const fontSize   = this.getFontSize();\n        const lineHeight = this.getLineHeight();\n\n        return {\n            fontFamily : this.getFontFamily()  ?? undefined,\n            fontSize   : this._fontSizeCSSRule ?? (fontSize !== null ? `${fontSize}px` : undefined),\n            fontWeight : this.getFontWeight()  ?? undefined,\n            fontStyle  : this.getFontStyle()   ?? undefined,\n            fontVariant: this.getFontVariant() ?? undefined,\n            fontStretch: this.getFontStretch() ?? undefined,\n            lineHeight : this._lineHeightCSSRule ?? (lineHeight !== null ? `${lineHeight}px` : undefined),\n        };\n    }\n\n    /**\n     * Whether this Text wraps onto multiple lines — i.e. its `white-space` is a\n     * wrapping value rather than `nowrap`/`pre`. Only a wrapping Text's height\n     * depends on the width it is given.\n     *\n     * @returns `true` when the text soft-wraps at its box width.\n     */\n    private isWrapping(): boolean {\n        const ws = this.getWhiteSpace();\n\n        return ws === \"normal\" || ws === \"pre-wrap\" || ws === \"pre-line\" || ws === \"break-spaces\";\n    }\n\n    /**\n     * The height the text needs given its current laid-out width.\n     *\n     * A `nowrap` label — or one not yet given a width, or in a vertical writing\n     * mode — is width-independent, so its natural single-line height stands. A\n     * wrapping label whose box is narrower than its natural run re-measures at\n     * the current inner width (its own border/insets removed): the extra lines\n     * make it taller. The re-measure uses the same line-height as the render, so\n     * the reported height matches what is drawn — line-height is the per-line\n     * unit the whole calculation stacks.\n     *\n     * @param text - The text run being measured.\n     * @param naturalWidth - The natural single-line width (nowrap), the wrap threshold.\n     * @param naturalHeight - The natural single-line height, used when it does not wrap.\n     * @returns The height (px) at the current width; floored at one line.\n     */\n    private measuredHeight(text: string, naturalWidth: number, naturalHeight: number): number {\n        if (!this.isWrapping() || this.isVerticalWritingMode()) {\n            return naturalHeight;\n        }\n\n        const width = this.getWidth();\n\n        if (Number.isNaN(width)) {\n            return naturalHeight;\n        }\n\n        const perimeter  = this.getPerimeterSize();\n        const innerWidth = width - perimeter.left - perimeter.right;\n\n        // Wide enough for the whole run on one line → no wrapping; keep the exact\n        // single-line height and skip a redundant probe.\n        if (innerWidth >= naturalWidth) {\n            return naturalHeight;\n        }\n\n        const wrapped       = DOM.source.measureText(text, { ...this.measureOptions(), maxWidth: innerWidth });\n        const minLineHeight = Math.ceil(this.getLineHeight() ?? this.readThemeLineHeightPx());\n\n        return Math.max(wrapped.height, minLineHeight);\n    }\n\n    /**\n     * Sets the laid-out width and, for a wrapping Text, re-measures at the new\n     * width so its preferred height tracks the number of wrapped lines.\n     *\n     * A wrapping run's height depends on the width it is given, but the\n     * preferred-size protocol resolves heights bottom-up before widths are\n     * assigned top-down — so the height is only knowable once the box has a\n     * width. Re-measuring here updates the preferred height, and\n     * `Component.setPreferredSize` fires the ancestor notify, so the parent\n     * re-lays-out one pass later at the taller height (the box's own min height\n     * also rises, so the current pass already reserves the room rather than\n     * clipping). A `nowrap` label's height is width-independent, so its width\n     * changes need no re-measure. Idempotent once the width settles: an\n     * unchanged width re-measures to the same height and the notify is suppressed.\n     *\n     * @param width - The new outer width in pixels.\n     * @returns This component, for chaining.\n     */\n    override setWidth(width: number): this {\n        const previous = this.getWidth();\n\n        super.setWidth(width);\n\n        if (this.isWrapping() && this.getWidth() !== previous) {\n            this._measurementDirty = true;\n            // Re-measure now (at the new width) so the updated preferred height\n            // propagates before the next layout pass reads it.\n            this.calculateSize();\n        }\n\n        return this;\n    }\n\n    /**\n     * Returns the preferred size, lazily measuring the text on the first call.\n     *\n     * @returns The preferred Size, or `null` per the inherited contract.\n     *\n     * @remarks Construction no longer eagerly probes `document.body` for text\n     * dimensions; the first reader of the preferred size pays the measurement\n     * cost. After attach this is `doLayout`, so the probe happens at layout\n     * time rather than construction time.\n     */\n    getPreferredSize() {\n        if (this._measurementDirty) {\n            this.calculateSize();\n        }\n\n        const size = super.getPreferredSize();\n\n        // `measureTextMetrics` always measures the run horizontally. A vertical\n        // writing mode rotates it onto the block axis, so the natural text length\n        // becomes the height and the line box becomes the width — swap to report\n        // the on-screen extents.\n        if (size && this.isVerticalWritingMode()) {\n            return { width: size.height, height: size.width };\n        }\n\n        return size;\n    }\n\n    /**\n     * Whether the active {@link Component.setWritingMode | writing mode} rotates\n     * the text run onto the block (vertical) axis, so the measured horizontal\n     * extents must be swapped to describe the on-screen size.\n     *\n     * @returns `true` for a `vertical-*` or `sideways-*` writing mode.\n     */\n    private isVerticalWritingMode(): boolean {\n        const mode = this.getWritingMode();\n\n        return mode !== null && (mode.startsWith(\"vertical\") || mode.startsWith(\"sideways\"));\n    }\n\n    /**\n     * Returns the effective minimum size, folding the measured one-line height\n     * floor (from `calculateSize`) into the inherited component/layout minimum.\n     *\n     * @returns The minimum `{width, height}`, never shorter than one line of\n     * text, or `null` only when neither a measurement nor an inherited minimum\n     * exists.\n     *\n     * @remarks Only the **height** floor participates in the hard minimum —\n     * text cannot render below its line box without clipping. The measured\n     * width is deliberately *not* folded in: surfacing each label's natural\n     * width as a hard minimum would stop parent layouts (e.g. an equal-mode tab\n     * bar) from compressing short labels to fit, which is why `Text.minSize`\n     * has historically reported a zero width. The floor is per-instance derived\n     * state held in `_measuredMinSize`, not a class default, so it lives outside\n     * `_defaultOptions`. An explicit caller `setMinSize` taller than the floor\n     * still wins via `Math.max`; a value shorter than one line is lifted to it.\n     */\n    getMinSize(): Size | null {\n        if (this._measurementDirty) {\n            this.calculateSize();\n        }\n\n        const measured = this._measuredMinSize;\n        const base     = super.getMinSize();\n\n        if (!measured) {\n            return base;\n        }\n\n        // Vertical writing mode: the one-line floor guards the line *thickness*,\n        // which is now the width rather than the height (the length runs down the\n        // block axis and stays freely compressible).\n        if (this.isVerticalWritingMode()) {\n            if (!base) {\n                return { width: measured.height, height: 0 };\n            }\n\n            return {\n                width:  Math.max(base.width, measured.height),\n                height: base.height,\n            };\n        }\n\n        if (!base) {\n            return { width: 0, height: measured.height };\n        }\n\n        return {\n            width:  base.width,\n            height: Math.max(base.height, measured.height),\n        };\n    }\n\n    /**\n     * Returns the current text content, or an empty string if none is set.\n     *\n     * @returns The current text string, or \"\" if no text is set.\n     */\n    getText() {\n        return this._options.text || \"\";\n    }\n\n    /**\n     * Sets the text content, recalculates the preferred size, and updates the DOM element.\n     *\n     * @param text - The new text to display.\n     *\n     * @returns This component, for method chaining.\n     */\n    setText(text: String): this {\n        this._options.text = (text || \"\") as TOptions[\"text\"];\n\n        this._measurementDirty = true;\n        (this.getParentComponent() ?? this).scheduleLayout();\n\n        let element = this.getElement();\n        if (!element) {\n            return this;\n        }\n\n        DOM.sink.apply(element, { text: text.valueOf() });\n\n        return this;\n    }\n\n    /**\n     * Enables or disables automatic text measurement on `setText`.\n     *\n     * @param enabled - When `false`, `setText` skips the off-screen probe and\n     *                  leaves preferred size and baseline unchanged. Use only when\n     *                  the parent layout (e.g. [`Fit`](/api/layout/classes/Fit)) sizes this Text from\n     *                  the container, so the measured preferred size is unused.\n     *\n     * @returns This component, for method chaining.\n     */\n    setAutoMeasure(enabled: boolean): this {\n        this._autoMeasure = enabled;\n\n        return this;\n    }\n\n    /**\n     * Returns the current CSS text-align value.\n     *\n     * @returns The CSS text-align string, or null if not set.\n     */\n    getTextAlign() {\n        return this._options.textAlign ?? this._defaultOptions.textAlign ?? null;\n    }\n\n    /**\n     * Sets the CSS text-align and updates the component's CSS rule.\n     *\n     * @param align - A CSS text-align value (e.g. \"left\", \"center\", \"right\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setTextAlign(align: string): this {\n        this._options.textAlign = align;\n\n        this.setElementCSSRule(\"textAlign\", align);\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS text-shadow value.\n     *\n     * @returns The CSS text-shadow string, or null if not set.\n     */\n    getTextShadow() {\n        return this._options.textShadow ?? null;\n    }\n\n    /**\n     * Sets the CSS text-shadow and updates the component's CSS rule.\n     *\n     * @param shadow - A CSS text-shadow value.\n     *\n     * @returns This component, for method chaining.\n     */\n    setTextShadow(shadow: string): this {\n        this._options.textShadow = shadow;\n\n        this.setElementCSSRule(\"textShadow\", shadow);\n\n        return this;\n    }\n\n    /**\n     * Removes the text-shadow CSS property from the component's CSS rule.\n     *\n     * @returns This component, for method chaining.\n     */\n    clearTextShadow(): this {\n        if (this._options.textShadow === undefined) {\n            return this;\n        }\n\n        this._options.textShadow = undefined;\n        this.setElementCSSRule(\"textShadow\", null);\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS font-family value.\n     *\n     * @returns The CSS font-family string, or null if not set.\n     */\n    getFontFamily() {\n        return this._options.fontFamily ?? this._defaultOptions.fontFamily ?? null;\n    }\n\n    /**\n     * Sets the CSS font-family, updates the rule, and recalculates preferred size.\n     *\n     * @param value - The CSS font-family string (e.g. \"sans-serif\", \"'Arial', sans-serif\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontFamily(value: string): this {\n        this._options.fontFamily = value;\n\n        this.setElementCSSRule(\"fontFamily\", value);\n\n        this._measurementDirty = true;\n        (this.getParentComponent() ?? this).scheduleLayout();\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS font-kerning value.\n     *\n     * @returns The CSS font-kerning string, or null if not set.\n     */\n    getFontKerning() {\n        return this._options.fontKerning ?? this._defaultOptions.fontKerning ?? null;\n    }\n\n    /**\n     * Sets the CSS font-kerning and updates the component's CSS rule.\n     *\n     * @param value - A CSS font-kerning value (e.g. \"auto\", \"normal\", \"none\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontKerning(value: string): this {\n        this._options.fontKerning = value;\n\n        this.setElementCSSRule(\"fontKerning\", value);\n\n        return this;\n    }\n\n    /**\n     * Returns the font size in pixels.\n     *\n     * @returns The font size as a number, or null if not set.\n     */\n    getFontSize() {\n        return (this._options.fontSize as number | undefined) ?? (this._defaultOptions.fontSize as number | undefined) ?? null;\n    }\n\n    /**\n     * Sets the font size. Pass a number for an explicit pixel value, or a CSS variable name\n     * (e.g. `\"--ts-ui-header-font-size\"`) to bind to a theme token.\n     *\n     * @param value - Pixel size as a number, or a CSS custom property name as a string.\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontSize(value: number | string): this {\n        if (typeof value === 'number') {\n            this._options.fontSize = value as TOptions[\"fontSize\"];\n            this._fontSizeCSSVar    = null;\n            this._fontSizeCSSRule   = null;\n            this.setElementCSSRule(\"fontSize\", value + \"px\");\n        } else {\n            const fallbackPx      = (this.getFontSize() as number | undefined) ?? 14;\n            this._fontSizeCSSVar  = value;\n            this._fontSizeCSSRule = `var(${value}, ${fallbackPx}px)`;\n            this.setElementCSSRule(\"fontSize\", this._fontSizeCSSRule);\n\n            // Cache the resolved px so line-box/baseline math has the real size\n            // even pre-attach — resolveBoundFontSizePx probes the cascade for a\n            // calc()-valued token rather than parseFloat-ing its raw var string.\n            const resolved = this.resolveBoundFontSizePx();\n            if (resolved !== null) {\n                this._options.fontSize = resolved as TOptions[\"fontSize\"];\n            }\n        }\n\n        this._measurementDirty = true;\n        (this.getParentComponent() ?? this).scheduleLayout();\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS font-size-adjust value.\n     *\n     * @returns The CSS font-size-adjust string, or null if not set.\n     */\n    getFontSizeAdjust() {\n        return this._options.fontSizeAdjust ?? this._defaultOptions.fontSizeAdjust ?? null;\n    }\n\n    /**\n     * Sets the CSS font-size-adjust and updates the component's CSS rule.\n     *\n     * @param value - A CSS font-size-adjust value.\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontSizeAdjust(value: string): this {\n        this._options.fontSizeAdjust = value;\n\n        this.setElementCSSRule(\"fontSizeAdjust\", value);\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS font-stretch value.\n     *\n     * @returns The CSS font-stretch string, or null if not set.\n     */\n    getFontStretch() {\n        return this._options.fontStretch ?? this._defaultOptions.fontStretch ?? null;\n    }\n\n    /**\n     * Sets the CSS font-stretch and updates the component's CSS rule.\n     *\n     * @param value - A CSS font-stretch value (e.g. \"normal\", \"condensed\", \"expanded\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontStretch(value: string): this {\n        this._options.fontStretch = value;\n\n        this.setElementCSSRule(\"fontStretch\", value);\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS font-style value (e.g. \"normal\", \"italic\").\n     *\n     * @returns The CSS font-style string, or null if not set.\n     */\n    getFontStyle() {\n        return this._options.fontStyle ?? this._defaultOptions.fontStyle ?? null;\n    }\n\n    /**\n     * Sets the CSS font-style and updates the component's CSS rule.\n     *\n     * @param value - A CSS font-style value (e.g. \"normal\", \"italic\", \"oblique\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontStyle(value: string): this {\n        this._options.fontStyle = value;\n\n        this.setElementCSSRule(\"fontStyle\", value);\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS font-variant value.\n     *\n     * @returns The CSS font-variant string, or null if not set.\n     */\n    getFontVariant() {\n        return this._options.fontVariant ?? this._defaultOptions.fontVariant ?? null;\n    }\n\n    /**\n     * Sets the CSS font-variant and updates the component's CSS rule.\n     *\n     * @param value - A CSS font-variant value (e.g. \"normal\", \"small-caps\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontVariant(value: string): this {\n        this._options.fontVariant = value;\n\n        this.setElementCSSRule(\"fontVariant\", value);\n\n        return this;\n    }\n\n    /**\n     * Returns the CSS font-weight value.\n     *\n     * @returns The CSS font-weight string, or null if not set.\n     */\n    getFontWeight() {\n        return this._options.fontWeight ?? this._defaultOptions.fontWeight ?? null;\n    }\n\n    /**\n     * Sets the CSS font-weight, updates the rule, and recalculates preferred size.\n     *\n     * @param value - A CSS font-weight value (e.g. \"normal\", \"bold\", \"700\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setFontWeight(value: string): this {\n        this._options.fontWeight = value;\n\n        this.setElementCSSRule(\"fontWeight\", value);\n\n        this._measurementDirty = true;\n        (this.getParentComponent() ?? this).scheduleLayout();\n\n        return this;\n    }\n\n    /**\n     * Returns the line height in pixels, or null if not set.\n     *\n     * @returns The line height as a number, or null if not set.\n     */\n    getLineHeight() {\n        return (this._options.lineHeight as number | undefined) ?? (this._defaultOptions.lineHeight as number | undefined) ?? null;\n    }\n\n    /**\n     * Sets the line height. Pass a number for an explicit fixed pixel value\n     * (which stops tracking the theme — this is the per-control override of the\n     * additive default), or a CSS variable name to bind the line box to a\n     * custom token, resolved as a fixed line box for measurement.\n     *\n     * @param value - Pixel value as a number, or a CSS custom property name as a string.\n     *\n     * @returns This component, for method chaining.\n     */\n    setLineHeight(value: number | string): this {\n        if (typeof value === 'number') {\n            // Idempotent re-apply: a no-op numeric line-height must not re-arm\n            // the layout flush. CellRenderer.doLayout syncs the Text child's\n            // line-height to the cell height on every pass; without this guard\n            // that unconditional scheduleLayout below re-dirtied the renderer\n            // each frame, spinning a silent CPU-pinning relayout loop. Only skip\n            // when already in pure-numeric mode with the same value (the initial\n            // additive-rule state has a non-null _lineHeightCSSRule, so the first\n            // apply still runs). Mirrors the framework's \"unchanged value → early\n            // return before scheduleLayout\" idiom (Card.setVisibleComponentId).\n            if (this._options.lineHeight === value && this._lineHeightCSSVar === null && this._lineHeightCSSRule === null) {\n                return this;\n            }\n\n            this._options.lineHeight = value as TOptions[\"lineHeight\"];\n            this._lineHeightCSSVar    = null;\n            this._lineHeightCSSRule   = null;\n            this.setElementCSSRule(\"lineHeight\", value + \"px\");\n        } else {\n            this._lineHeightCSSVar    = value;\n            this._lineHeightCSSRule   = `var(${value}, ${ADDITIVE_LINE_HEIGHT_RULE})`;\n            this._options.lineHeight = this.readThemeLineHeightPx() as TOptions[\"lineHeight\"];\n            this.setElementCSSRule(\"lineHeight\", this._lineHeightCSSRule);\n        }\n\n        this._measurementDirty = true;\n        (this.getParentComponent() ?? this).scheduleLayout();\n\n        return this;\n    }\n\n    /**\n     * Sets the line-height equal to the given pixel height so a single-line\n     * text sits vertically centred in a fixed-height inline box.\n     *\n     * @param px - Pixel value matching the container's height, or `null` to\n     *             revert to the theme's additive line box (font size +\n     *             `--ts-ui-line-padding`).\n     *\n     * @returns This component, for method chaining.\n     *\n     * @example\n     * ```typescript\n     * const label = new Text(\"File\");\n     * label.centerInHeight(28);\n     * ```\n     */\n    centerInHeight(px: number | null): this {\n        if (px === null) {\n            this._lineHeightCSSVar   = null;\n            this._lineHeightCSSRule  = ADDITIVE_LINE_HEIGHT_RULE;\n            this._options.lineHeight = this.readThemeLineHeightPx() as TOptions[\"lineHeight\"];\n            this.setElementCSSRule(\"lineHeight\", this._lineHeightCSSRule);\n\n            this._measurementDirty = true;\n            (this.getParentComponent() ?? this).scheduleLayout();\n\n            return this;\n        }\n\n        return this.setLineHeight(px);\n    }\n\n    /**\n     * Returns the CSS text-overflow value last passed to {@link setTextOverflow},\n     * or `null` if not set.\n     *\n     * @returns The text-overflow string, or null.\n     */\n    getTextOverflow(): string | null {\n        return this._textOverflow;\n    }\n\n    /**\n     * Sets the CSS text-overflow property and updates the component's CSS rule.\n     *\n     * @param value - A CSS text-overflow value (e.g. \"clip\", \"ellipsis\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setTextOverflow(value: string): this {\n        this._textOverflow = value;\n\n        this.setElementCSSRule(\"textOverflow\", value);\n\n        return this;\n    }\n\n    /**\n     * Removes the text-overflow CSS property from the component's CSS rule.\n     *\n     * @returns This component, for method chaining.\n     */\n    clearTextOverflow(): this {\n        if (this._textOverflow === null) {\n            return this;\n        }\n\n        this._textOverflow = null;\n        this.setElementCSSRule(\"textOverflow\", null);\n\n        return this;\n    }\n\n    /**\n     * Returns whether single-line truncation + ellipsis is enabled (default `true`).\n     *\n     * @returns `true` when the text clips with \"…\" once narrower than its\n     *   natural width; `false` when the text refuses to shrink past its\n     *   natural width.\n     */\n    isTruncate(): boolean {\n        return this._truncate;\n    }\n\n    /**\n     * Toggles single-line truncation mode. When `true`, the text renders as\n     * single-line + `overflow: hidden` + `text-overflow: ellipsis` and reports\n     * `minSize.width = Math.min(natural, 100)`. When `false`, those CSS\n     * properties are cleared and the text reports its full natural width as\n     * `minSize.width` so parent layouts widen to fit instead of clipping.\n     *\n     * @param value - `true` to enable ellipsised truncation, `false` to\n     *   disable (the text expands to its natural width).\n     *\n     * @returns This component, for method chaining.\n     */\n    setTruncate(value: boolean): this {\n        this._truncate = value;\n\n        if (value) {\n            this.setWhiteSpace(\"nowrap\");\n            this.setOverflow(\"hidden\");\n            this.setTextOverflow(\"ellipsis\");\n        } else {\n            this.setElementCSSRule(\"whiteSpace\",   null);\n            this.setOverflow(\"visible\");\n            this.setElementCSSRule(\"textOverflow\", null);\n            this._textOverflow = null;\n        }\n\n        // The auto-min cap depends on `_truncate`; re-measure so the parent\n        // layout sees the new floor on the next layout pass.\n        this._measurementDirty = true;\n        (this.getParentComponent() ?? this).scheduleLayout();\n\n        return this;\n    }\n\n    /**\n     * Returns the current CSS `word-break` value, or null if not set.\n     *\n     * @returns The word-break string, or null.\n     */\n    getWordBreak(): string | null {\n        return this._wordBreak;\n    }\n\n    /**\n     * Sets the CSS `word-break` property on the component's CSS rule.\n     *\n     * @param value - A CSS word-break value (e.g. \"break-word\", \"normal\", \"keep-all\").\n     *\n     * @returns This component, for method chaining.\n     */\n    setWordBreak(value: string): this {\n        if (this._wordBreak === value) {\n            return this;\n        }\n\n        this._wordBreak = value;\n        this.setElementCSSRule(\"wordBreak\", value);\n\n        return this;\n    }\n\n    /**\n     * Returns the current line-clamp line count, or null if no clamp is applied.\n     *\n     * @returns The maximum line count, or null.\n     */\n    getLineClamp(): number | null {\n        return this._lineClamp;\n    }\n\n    /**\n     * Clamps the rendered text to a maximum line count via CSS line-clamp.\n     *\n     * Writes `display: -webkit-box`, `-webkit-box-orient: vertical`,\n     * `-webkit-line-clamp`, `overflow: hidden`, and `text-overflow: ellipsis`\n     * in a single call. Use {@link clearLineClamp} to remove the clamp.\n     *\n     * @param lines - The maximum number of lines to display before the ellipsis.\n     *\n     * @returns This component, for method chaining.\n     */\n    setLineClamp(lines: number): this {\n        if (this._lineClamp === lines) {\n            return this;\n        }\n\n        this._lineClamp = lines;\n        this.setElementCSSRules({\n            display: \"-webkit-box\",\n            webkitBoxOrient: \"vertical\",\n            webkitLineClamp: String(lines),\n            overflow: \"hidden\",\n            textOverflow: \"ellipsis\"\n        });\n\n        return this;\n    }\n\n    /**\n     * Removes the line-clamp styling previously applied by {@link setLineClamp}.\n     *\n     * @returns This component, for method chaining.\n     */\n    clearLineClamp(): this {\n        if (this._lineClamp === null) {\n            return this;\n        }\n\n        this._lineClamp = null;\n        this.setElementCSSRules({\n            display: null,\n            webkitBoxOrient: null,\n            webkitLineClamp: null,\n            overflow: null,\n            textOverflow: null\n        });\n\n        return this;\n    }\n\n    /**\n     * Applies all text-specific style properties to the element's CSS rule in addition to base styles.\n     *\n     * @param element - The element handle to apply styles to.\n     */\n    applyStyle(element: Handle): this {\n        super.applyStyle(element);\n\n        const fontSize   = this.getFontSize();\n        const lineHeight = this.getLineHeight();\n\n        this.setElementCSSRules({\n            fontFamily:     this.getFontFamily()    ?? '',\n            textAlign:      this.getTextAlign()     ?? '',\n            textShadow:     this.getTextShadow()    ?? '',\n            fontKerning:    this.getFontKerning()   ?? '',\n            fontSize:       this._fontSizeCSSRule    ?? (fontSize !== null ? `${fontSize}px` : ''),\n            fontSizeAdjust: this.getFontSizeAdjust() ?? '',\n            fontStretch:    this.getFontStretch()   ?? '',\n            fontStyle:      this.getFontStyle()     ?? '',\n            fontVariant:    this.getFontVariant()   ?? '',\n            fontWeight:     this.getFontWeight()    ?? '',\n            lineHeight:     this._lineHeightCSSRule  ?? (lineHeight !== null ? `${lineHeight}px` : '')\n        });\n\n        return this;\n    }\n\n    /**\n     * Removes the theme-change listener. Call when the component is permanently removed.\n     */\n    dispose() {\n        this._unsubscribeTheme();\n    }\n\n    /**\n     * Renders the element and sets its text content.\n     *\n     * @returns The created element with textContent initialised.\n     */\n    protected render() {\n        let element = super.render();\n\n        DOM.sink.apply(element, { text: this.getText().valueOf() });\n\n        return element;\n    }\n}\n\nconst TextCallable = callable(Text);\ntype TextCallable<TOptions extends TextOptions = TextOptions> = Text<TOptions>;\nexport {\n    Text         as _Text,\n    TextCallable as Text\n};\n"],"mappings":"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"}

package/dist/lib/Tooltip-4lU_tf6r.js

@@ -0,0 +1,3 @@
+import{l as e,u as t}from"./Position-B-WfZYAJ.js";import{h as n,t as r,y as i}from"./Component-BR2f0Itb.js";import{t as a}from"./Text-D1RrBY52.js";var o=9e3,s=9800,c=1e4,l=11e3,u=12e3,d=new r,f;(function(e){let n=[],r=new WeakMap,a=0,f=null,p=!1;e.Band={Window:o,Popover:s,Dropdown:c,Dialog:l,Tooltip:u};function bandFor(e,t){return e?e.band:t}function register(e){if(r.has(e))return;let t=n.length>0?n[n.length-1]:null,i=e.isLayerRoot?.()?null:t,o=bandFor(i,e.getBand?.()??c),s={layer:e,parent:i,children:[],band:o,zIndex:o+ ++a};r.set(e,s),n.push(s),i&&i.children.push(s),p||installListeners()}e.register=register;function mount(e){t.source.contains(t.source.getDocumentElement(),e)||t.sink.appendChild(t.source.getDocumentElement(),e)}e.mount=mount;function unregister(e){let t=r.get(e);if(!t)return;r.delete(e);let i=n.indexOf(t);if(i>=0&&n.splice(i,1),t.parent){let e=t.parent.children.indexOf(t);e>=0&&t.parent.children.splice(e,1)}f===e&&(f=null),n.length===0&&p&&uninstallListeners()}e.unregister=unregister;function containsAcrossLayers(e,n){if(!n)return!1;let i=r.get(e);if(!i){let r=e.getLayerElement();return r?t.source.contains(r,n):!1}return nodeContains(i,n)}e.containsAcrossLayers=containsAcrossLayers;function getTopLayer(){return n.length>0?n[n.length-1].layer:null}e.getTopLayer=getTopLayer;function bringToFront(e){let t=r.get(e);t&&(restampSubtree(t),markActive(e))}e.bringToFront=bringToFront;function getZIndex(e){let t=r.get(e);return t?t.zIndex:c}e.getZIndex=getZIndex;function restampSubtree(e){let walk=e=>{e.zIndex=e.band+ ++a,e.layer.onZIndexChanged?.(e.zIndex);for(let t of e.children)walk(t)};walk(e)}function nodeContains(e,n){let r=e.layer.getLayerElement();if(r&&t.source.contains(r,n))return!0;for(let t of e.children)if(nodeContains(t,n))return!0;return!1}function markActive(e){f!==e&&(deactivateActive(),f=e,e.onActivate&&e.onActivate(!0))}function deactivateActive(){f&&f.onActivate&&f.onActivate(!1),f=null}function activatableAncestor(e){let t=e;for(;t;){if(t.layer.onActivate)return t.layer;t=t.parent}return null}function handleOutside(e,r){let i=n.slice().reverse(),a=!1,o=!1;for(let n of i){let i=n.layer.getDismissMode();if(containsAcrossLayers(n.layer,e)){markActive(activatableAncestor(n)??n.layer),a=!0,o=!0;break}let s=n.layer.getAnchorElement?.();if(s&&e&&t.source.contains(s,e)){o=!0;break}if(i===`manual`||i===`modal`||!(r?i===`blur`:i===`click-outside`||i===`blur`)){if(i===`modal`){o=!0;break}continue}n.layer.requestClose()}!a&&!o&&!r&&deactivateActive()}function onPointerDown(e){handleOutside(e.target===null?null:t.source.intern(e.target),!1)}function onWindowBlur(e){t.source.isWindow(e.target===null?null:t.source.intern(e.target))&&handleOutside(null,!1)}function onFocusIn(e){handleOutside(e.target===null?null:t.source.intern(e.target),!0)}function onKeyDown(e){if(e.key===`Escape`){for(let e=n.length-1;e>=0;e--)if(n[e].layer.getDismissMode()!==`manual`){n[e].layer.requestClose();return}}}function installListeners(){i.addViewportListener(d,`pointerdown`,onPointerDown),i.addViewportListener(d,`focusin`,onFocusIn),i.addViewportListener(d,`keydown`,onKeyDown),i.addViewportListener(d,`blur`,onWindowBlur),p=!0}function uninstallListeners(){i.removeViewportListener(d,`pointerdown`,onPointerDown),i.removeViewportListener(d,`focusin`,onFocusIn),i.removeViewportListener(d,`keydown`,onKeyDown),i.removeViewportListener(d,`blur`,onWindowBlur),p=!1}})(f||={});function positionAdjacent(e,t,n,r,i){let a=t+i,o=r-a,s=e-i;return n<=o?a:n<=s?e-n-i:o>=s?Math.max(0,r-n):0}function positionAligned(e,t,n,r,i){if(e>=i&&e+n<=r-i)return e;let a=t-n;return a>=i&&a+n<=r-i?a:clampAxis(e,n,r,i)}function clampAxis(t,n,r,i){return e.clamp(t,i,Math.max(i,r-n-i))}function positionFlexibleAnchored(e,t,n,r,i){let a=r-t-i,o=e-i;return n<=a||a>=o?{start:t,available:a}:{start:e-Math.min(n,o),available:o}}function positionAnchored(e,t,n,r){let i=r.gap??0,a=r.margin??0;if(r.axis===`vertical`){let r=positionAdjacent(e.top,e.bottom,t.height,n.height,i);return{x:positionAligned(e.left,e.right,t.width,n.width,a),y:r}}return{x:positionAdjacent(e.left,e.right,t.width,n.width,i),y:positionAligned(e.top,e.bottom,t.height,n.height,a)}}var p=100,m=class Tooltip extends r{static instance=null;static showTimer=null;static attachments=new Map;static elementAttachments=new Map;static activeElement=null;static watching=!1;static _onAnchorWatch=()=>{Tooltip.activeElement!==null&&!t.source.isConnected(Tooltip.activeElement)&&Tooltip.hide()};static dismissing=!1;static H_PADDING=16;static V_PADDING=8;static MAX_WIDTH=300;static ITEM_HEIGHT=20;static CURSOR_LEFT=4;static CURSOR_RIGHT=12;static CURSOR_UP=0;static CURSOR_DOWN=12;static CURSOR_GAP=2;_text;_lineCount=1;_perLine=Tooltip.ITEM_HEIGHT;constructor(){super(),this.setVisible(!1),this.setZIndex(f.Band.Tooltip),this.setBackgroundColor(`var(--ts-ui-tooltip-bg, rgb(255, 255, 240))`),this.setForegroundColor(`var(--ts-ui-tooltip-color, rgb(0, 0, 0))`),this.setBorder({border:`1px solid var(--ts-ui-tooltip-border, rgb(180, 180, 100))`}),this.setShadow(`var(--ts-ui-tooltip-shadow, 1px 2px 4px rgba(0, 0, 0, 0.2))`),this.setBorderRadius(`var(--ts-ui-border-radius, 4px)`),this.setPointerEvents(`none`),this.setContain(`layout paint`),this._text=new a,this._text.setPointerEvents(`none`),this._text.setWhiteSpace(`pre-wrap`),this.addComponent(this._text)}static getInstance(){return Tooltip.instance||=new Tooltip,Tooltip.instance}static show(r,a,o){Tooltip.showTimer!==null&&(clearTimeout(Tooltip.showTimer),Tooltip.showTimer=null);let s=Tooltip.getInstance(),c=s.isVisible()&&!Tooltip.dismissing;s._text.setText(r);let l=r.split(`
+`),u=l.reduce((t,n)=>Math.max(t,e.measureTextWidth(n)),0);s._perLine=s._perLineHeight();let d=Math.min(Tooltip.MAX_WIDTH,u+Tooltip.H_PADDING);if(u+Tooltip.H_PADDING>Tooltip.MAX_WIDTH){let e=d-Tooltip.H_PADDING,n=t.source.measureText(r,{maxWidth:e}).height;s._lineCount=Math.max(l.length,Math.round(n/s._perLine))}else s._lineCount=l.length;let m=s._lineCount*s._perLine+Tooltip.V_PADDING;s._lineCount===1&&(m=Math.max(m,Tooltip.ITEM_HEIGHT+Tooltip.V_PADDING)),s.setWidth(d),s.setHeight(m);let h=t.source.getViewportSize(),g=e.clamp(a,0,h.width),_=e.clamp(o,0,h.height);s.setX(positionAdjacent(g-Tooltip.CURSOR_LEFT,g+Tooltip.CURSOR_RIGHT,d,h.width,Tooltip.CURSOR_GAP)),s.setY(positionAdjacent(_-Tooltip.CURSOR_UP,_+Tooltip.CURSOR_DOWN,m,h.height,Tooltip.CURSOR_GAP));let v=s.getElement(!0);if(s.scheduleLayout(),f.mount(v),s.setVisible(!0),Tooltip.watching||=(i.addViewportListener(s,`mousemove`,Tooltip._onAnchorWatch),!0),Tooltip.dismissing=!1,c){t.sink.apply(v,{style:{opacity:`1`}});return}n.play(v,{from:{opacity:`0`},to:{opacity:`1`},durationMs:p,properties:[`opacity`]})}static hide(){Tooltip.showTimer!==null&&(clearTimeout(Tooltip.showTimer),Tooltip.showTimer=null);let e=Tooltip.getInstance(),t=e.getElement();Tooltip.watching&&=(i.removeViewportListener(e,`mousemove`,Tooltip._onAnchorWatch),!1),Tooltip.activeElement=null,t&&(Tooltip.dismissing=!0,n.play(t,{to:{opacity:`0`},durationMs:p,properties:[`opacity`],onComplete:()=>{Tooltip.dismissing&&(Tooltip.dismissing=!1,e.setVisible(!1),e.removeElement())}}))}static attach(e,t,n){Tooltip.detach(e);let r=0,a=0,mouseoverFn=i=>{Tooltip.showTimer===null&&(r=i.clientX,a=i.clientY,Tooltip.showTimer=setTimeout(()=>{Tooltip._applyColors(n),Tooltip.activeElement=e.getElement()??null,Tooltip.show(t,r,a),Tooltip.showTimer=null},500))},mousemoveFn=e=>{r=e.clientX,a=e.clientY},mouseoutFn=()=>{Tooltip.hide()},mousedownFn=()=>{Tooltip.hide()};i.addListener(e,`mouseover`,mouseoverFn),i.addListener(e,`mousemove`,mousemoveFn),i.addListener(e,`mouseout`,mouseoutFn),i.addListener(e,`mousedown`,mousedownFn),Tooltip.attachments.set(e.getId(),{text:t,colors:n,mouseoverFn,mousemoveFn,mouseoutFn,mousedownFn})}static detach(e){let t=e.getId(),n=Tooltip.attachments.get(t);n&&(i.removeListener(e,`mouseover`,n.mouseoverFn),i.removeListener(e,`mousemove`,n.mousemoveFn),i.removeListener(e,`mouseout`,n.mouseoutFn),i.removeListener(e,`mousedown`,n.mousedownFn),Tooltip.attachments.delete(t),Tooltip.hide())}static _applyColors(e){let t=Tooltip.getInstance();t.setBackgroundColor(e?.background??`var(--ts-ui-tooltip-bg, rgb(255, 255, 240))`),t.setForegroundColor(e?.color??`var(--ts-ui-tooltip-color, rgb(0, 0, 0))`),t.setBorder({border:`1px solid ${e?.border??`var(--ts-ui-tooltip-border, rgb(180, 180, 100))`}`})}static attachToElement(e,n){let r=Tooltip.elementAttachments.get(e),i=Tooltip.activeElement===e,a=r?r.lastX:0,o=r?r.lastY:0;Tooltip.detachElement(e);let s={text:n,showTimer:null,lastX:a,lastY:o,mouseoverFn:function onTooltipMouseOver(t){s.showTimer===null&&(s.lastX=t.clientX,s.lastY=t.clientY,s.showTimer=setTimeout(function onTooltipShowTimer(){Tooltip.activeElement=e,Tooltip.show(s.text,s.lastX,s.lastY),s.showTimer=null},500))},mousemoveFn:function onTooltipMouseMove(e){s.lastX=e.clientX,s.lastY=e.clientY},mouseoutFn:function onTooltipMouseOut(){s.showTimer!==null&&(clearTimeout(s.showTimer),s.showTimer=null),Tooltip.activeElement===e&&(Tooltip.activeElement=null),Tooltip.hide()},mousedownFn:function onTooltipMouseDown(){s.showTimer!==null&&(clearTimeout(s.showTimer),s.showTimer=null),Tooltip.hide()}};t.sink.addListener(e,`mouseover`,s.mouseoverFn),t.sink.addListener(e,`mousemove`,s.mousemoveFn),t.sink.addListener(e,`mouseout`,s.mouseoutFn),t.sink.addListener(e,`mousedown`,s.mousedownFn),Tooltip.elementAttachments.set(e,s),i&&(Tooltip.activeElement=e,Tooltip.show(n,s.lastX,s.lastY))}static detachElement(e){let n=Tooltip.elementAttachments.get(e);n&&(t.sink.removeListener(e,`mouseover`,n.mouseoverFn),t.sink.removeListener(e,`mousemove`,n.mousemoveFn),t.sink.removeListener(e,`mouseout`,n.mouseoutFn),t.sink.removeListener(e,`mousedown`,n.mousedownFn),n.showTimer!==null&&(clearTimeout(n.showTimer),n.showTimer=null),Tooltip.elementAttachments.delete(e),Tooltip.activeElement===e&&(Tooltip.activeElement=null))}_perLineHeight(){let{height:e}=t.source.measureText(`X`);return Math.ceil(e)}doLayout(){return super.doLayout(),this._text.setX(Tooltip.H_PADDING/2),this._text.setY(Tooltip.V_PADDING/2),this._text.setWidth(Math.max(0,this.getWidth()-Tooltip.H_PADDING)),this._text.setHeight(this._lineCount*this._perLine),this}};export{f as a,positionFlexibleAnchored as i,positionAligned as n,positionAnchored as r,m as t};
+//# sourceMappingURL=Tooltip-4lU_tf6r.js.map

package/dist/lib/Tooltip-4lU_tf6r.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tooltip-4lU_tf6r.js","names":[],"sources":["../../src/typescript/lib/core/LayerManager.ts","../../src/typescript/lib/core/OverlayPosition.ts","../../src/typescript/lib/overlay/Tooltip.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Component } from \"~/core/Component.js\";\nimport { Event } from \"~/core/Event.js\";\nimport { DOM } from \"~/core/DOM.js\";\nimport type { Handle } from \"~/core/DOM.js\";\n\n/**\n * How a layer responds to an outside interaction.\n *\n * - `\"click-outside\"`: dismissed when a `pointerdown` lands outside the\n *   layer's subtree (and its anchor); ignores focus moves.\n * - `\"blur\"`: dismissed when either a `pointerdown` or a focus move lands\n *   outside the layer's subtree (and its anchor).\n * - `\"manual\"`: never dismissed by the document-level handlers; the host\n *   drives its own teardown.\n * - `\"modal\"`: never dismissed by an outside `pointerdown` or focus move\n *   (the layer captures the interaction); only Escape, routed through the\n *   keydown handler, asks it to close.\n *\n * @category Core\n */\nexport type LayerDismissMode = \"click-outside\" | \"blur\" | \"manual\" | \"modal\";\n\n/**\n * A portaled overlay surface that participates in the runtime layer tree.\n * Implemented by [`AnimatedDropdown`](/api/core/classes/AnimatedDropdown),\n * [`Popover`](/api/overlay/classes/Popover),\n * [`Dialog`](/api/overlay/classes/Dialog), and\n * [`Window`](/api/overlay/classes/Window).\n *\n * A surface registers itself with {@link LayerManager.register} from its\n * show path and unregisters with {@link LayerManager.unregister} from its\n * hide path. The manager then owns the z-index stamp, the activation\n * marking, and the dismissal decision — calling {@link DismissableLayer.requestClose}\n * (advisory) when an outside interaction meets the layer's\n * {@link LayerDismissMode}.\n *\n * @category Core\n */\nexport interface DismissableLayer {\n    /** The layer's root element (already mounted on `documentElement`). */\n    getLayerElement(): Handle | null;\n\n    /** Dismiss policy consulted by the document-level interaction handlers. */\n    getDismissMode(): LayerDismissMode;\n\n    /** Advisory request to close; the surface runs its own teardown + unregister. */\n    requestClose(): void;\n\n    /**\n     * Optional anchor element excluded from \"outside\" tests so the trigger\n     * click that opened the layer does not immediately re-close it.\n     */\n    getAnchorElement?(): Handle | null;\n\n    /**\n     * Optional activation hook. The manager calls it with `true` when this\n     * layer becomes the active (topmost containing) layer for a pointer /\n     * focus interaction and `false` when it is superseded. Surfaces that\n     * carry an active-state affordance (e.g. a window title bar) map it to\n     * their own toggle; surfaces without one omit the method.\n     */\n    onActivate?(active: boolean): void;\n\n    /**\n     * Optional re-stamp hook. The manager calls it with a fresh z-index when\n     * {@link LayerManager.bringToFront} re-allocates the layer (or one of its\n     * ancestors) while it is already shown, so the surface can mirror the new\n     * value onto its element through its own typed `setZIndex`. Surfaces that\n     * only read z once in their show path (and never get raised afterwards)\n     * may omit it.\n     */\n    onZIndexChanged?(zIndex: number): void;\n\n    /**\n     * Optional z-index band hint. Returns one of {@link LayerManager.Band}'s\n     * values so an unrelated peer layer stacks in its surface family's band\n     * (Window < Popover < dropdown < Dialog). Omitted surfaces default to the\n     * dropdown band. A nested layer ignores its own band and inherits its\n     * opener's, so this only matters for top-level (unparented) registrations.\n     */\n    getBand?(): number;\n\n    /**\n     * Optional top-level hint. Returns `true` for a surface that is an\n     * independent peer rather than a layer opened from another — a window is\n     * not a child of whatever happened to be topmost when it appeared. Such a\n     * layer registers as a tree root, so raising it does not drag an unrelated\n     * peer up with it (see {@link LayerManager.bringToFront}). Omitted surfaces\n     * register under the current topmost layer (the opened-from edge).\n     */\n    isLayerRoot?(): boolean;\n}\n\n/**\n * Node in the runtime layer tree. Generalizes the per-host `LayerEntry`\n * that `AnimatedDropdown` previously kept module-private: `children` are the\n * layers opened while this one was topmost, `band` is the z-index band base\n * the layer was assigned (inherited from its opener), and `zIndex` is the\n * band + counter stamp the manager assigned at register time.\n */\ninterface LayerNode {\n    layer:    DismissableLayer;\n    parent:   LayerNode | null;\n    children: LayerNode[];\n    band:     number;\n    zIndex:   number;\n}\n\n// Z-index bands. Plain module constants because z-index is not themed\n// anywhere today (Theme.ts carries no z-index tokens; the values were inline\n// per class). The bands reconcile the four historical bases into one\n// ascending allocator and preserve relative order between unrelated peers:\n//   Window 9000  <  Popover 9800  <  dropdowns 10000  <  Dialog 11000.\n// A nested child inherits its opener's band but always lands above it because\n// it registers later and so draws a higher counter. The 200-1000 gap between\n// bands leaves headroom for the monotonic `_zCounter`; it is not reset, on the\n// assumption a single session opens far fewer than 200 unrelated layers in the\n// same band before a reload — the historical inline values made the same bet.\nconst Z_BAND_WINDOW:   number = 9000;\nconst Z_BAND_POPOVER:  number = 9800;\nconst Z_BAND_DROPDOWN: number = 10000;\nconst Z_BAND_DIALOG:   number = 11000;\n// Above every managed layer: a tooltip is a transient, non-interactive\n// affordance that must float over even a modal Dialog and its backdrop. Not a\n// registered layer band — exposed so the Tooltip singleton stamps itself here\n// rather than carrying a magic number that could fall below the Dialog band.\nconst Z_BAND_TOOLTIP:  number = 12000;\n\n/**\n * Sentinel `Component` used as the registration key for the manager's three\n * document-level listeners. `Event.addViewportListener` binds a listener to a\n * `Component`, but the manager's handlers are module-global (one per type, not\n * per layer), so a single stable sentinel owns them — mirroring `Window`'s\n * `_viewportListenerOwner`. The install/teardown lifecycle keys off the tree\n * being non-empty rather than any individual layer.\n */\nconst _listenerOwner: Component = new Component();\n\n/**\n * Central registry and document-level interaction broker for portaled overlay\n * surfaces. Owns one runtime layer tree (push-on-register /\n * link-under-current-topmost / pop-on-unregister), one z-index allocator with\n * reserved bands, and a single set of document-level `pointerdown` / `focusin`\n * / `keydown` listeners installed on the first register and removed on the\n * last unregister.\n *\n * The relationship the tree captures — the runtime \"opened-from\" edge (which\n * layer was topmost when this one opened) — is distinct from the static\n * component hierarchy and changes per activation, so it lives here rather than\n * in the component tree. Containment queries hop across portaled descendant\n * layers via {@link LayerManager.containsAcrossLayers}, which is the single\n * place cross-portal containment is reasoned about.\n *\n * @category Core\n */\nexport namespace LayerManager {\n\n    // LIFO stack of open layers in register order; the last entry is topmost.\n    const _stack: LayerNode[] = [];\n\n    // Membership + node lookup keyed by the layer instance, generalizing the\n    // per-host `_entryByLayer` WeakMap.\n    const _nodeByLayer: WeakMap<DismissableLayer, LayerNode> = new WeakMap();\n\n    // Ascending per-register counter; combined with a band base to stamp z.\n    let _zCounter: number = 0;\n\n    // The layer currently marked active (received the last `onActivate(true)`).\n    let _activeLayer: DismissableLayer | null = null;\n\n    let _listenersInstalled: boolean = false;\n\n    /**\n     * The four z-index bands a surface returns from\n     * {@link DismissableLayer.getBand}. Exposed so each surface can tag itself\n     * without re-declaring the constants. Reconciles the historical inline\n     * bases (Window 9000, Popover 9998, dropdowns 10050, Dialog 10101) into\n     * one ascending allocator.\n     */\n    export const Band = {\n        Window:   Z_BAND_WINDOW,\n        Popover:  Z_BAND_POPOVER,\n        Dropdown: Z_BAND_DROPDOWN,\n        Dialog:   Z_BAND_DIALOG,\n        Tooltip:  Z_BAND_TOOLTIP,\n    } as const;\n\n    /**\n     * Picks the z-index band for a layer. A nested layer inherits its\n     * opener's band so it stays in the same stacking neighbourhood (and rises\n     * above the opener because it registers later); an unrelated peer uses its\n     * own surface-type band from {@link DismissableLayer.getBand}.\n     */\n    function bandFor(parent: LayerNode | null, ownBand: number): number {\n        return parent ? parent.band : ownBand;\n    }\n\n    /**\n     * Pushes `layer` as a child of the current topmost layer — unless it\n     * declares itself a top-level peer via\n     * {@link DismissableLayer.isLayerRoot}, in which case it registers as a\n     * tree root — assigns its band-based z-index, and installs the\n     * document-level listeners on the first call. A duplicate register (e.g. a\n     * `showAnimated` that cancels an in-flight fade-out) is a no-op so the tree\n     * never double-pushes.\n     *\n     * @param layer - The surface entering the layer tree.\n     */\n    export function register(layer: DismissableLayer): void {\n        if (_nodeByLayer.has(layer)) {\n            return;\n        }\n\n        const topmost = _stack.length > 0 ? _stack[_stack.length - 1] : null;\n        const parent  = layer.isLayerRoot?.() ? null : topmost;\n        const band    = bandFor(parent, layer.getBand?.() ?? Z_BAND_DROPDOWN);\n        const zIndex = band + (++_zCounter);\n\n        const node: LayerNode = { layer, parent, children: [], band, zIndex };\n\n        _nodeByLayer.set(layer, node);\n        _stack.push(node);\n\n        if (parent) {\n            parent.children.push(node);\n        }\n\n        if (!_listenersInstalled) {\n            installListeners();\n        }\n    }\n\n    /**\n     * Appends a portaled overlay element to `document.documentElement` if it is\n     * not already contained there. The single home for the \"portal mount\"\n     * idiom every floating surface used to inline. Idempotent — a surface that\n     * re-shows after detach re-appends, and one already mounted is left alone.\n     * Does **not** register the layer; surfaces still call {@link register}\n     * explicitly.\n     *\n     * @param el - The overlay element to portal onto the document root.\n     */\n    export function mount(el: Handle): void {\n        if (!DOM.source.contains(DOM.source.getDocumentElement(), el)) {\n            DOM.sink.appendChild(DOM.source.getDocumentElement(), el);\n        }\n    }\n\n    /**\n     * Pops `layer` from the tree (and unlinks it from its parent's child\n     * list), clears it as active if it was, and removes the document-level\n     * listeners on the last call.\n     *\n     * @param layer - The surface leaving the layer tree.\n     */\n    export function unregister(layer: DismissableLayer): void {\n        const node = _nodeByLayer.get(layer);\n\n        if (!node) {\n            return;\n        }\n\n        _nodeByLayer.delete(layer);\n\n        const idx = _stack.indexOf(node);\n\n        if (idx >= 0) {\n            _stack.splice(idx, 1);\n        }\n\n        if (node.parent) {\n            const ci = node.parent.children.indexOf(node);\n\n            if (ci >= 0) {\n                node.parent.children.splice(ci, 1);\n            }\n        }\n\n        if (_activeLayer === layer) {\n            _activeLayer = null;\n        }\n\n        if (_stack.length === 0 && _listenersInstalled) {\n            uninstallListeners();\n        }\n    }\n\n    /**\n     * Returns true when `node` is inside `layer`'s own element OR inside any\n     * descendant layer's element. This is the only cross-portal containment\n     * hop in the framework: a `pointerdown` or focus move that lands in a\n     * child layer (e.g. a dropdown opened from inside a popover) counts as\n     * inside the ancestor so the ancestor stays open.\n     *\n     * @param layer - The layer whose subtree is tested.\n     * @param node - The DOM node receiving the interaction.\n     * @returns True when `node` is inside `layer` or any descendant layer.\n     */\n    export function containsAcrossLayers(layer: DismissableLayer, node: Handle | null): boolean {\n        if (!node) {\n            return false;\n        }\n\n        const layerNode = _nodeByLayer.get(layer);\n\n        if (!layerNode) {\n            const el = layer.getLayerElement();\n\n            return el ? DOM.source.contains(el, node) : false;\n        }\n\n        return nodeContains(layerNode, node);\n    }\n\n    /**\n     * Returns the topmost currently-registered layer, or null when none is\n     * open.\n     *\n     * @returns The topmost open layer, or null.\n     */\n    export function getTopLayer(): DismissableLayer | null {\n        return _stack.length > 0 ? _stack[_stack.length - 1].layer : null;\n    }\n\n    /**\n     * Re-stamps `layer` (and its descendant layers) with fresh top-of-band\n     * z-indices and marks it active. Used by surfaces that raise on click\n     * (e.g. a window brought to front), so the raised layer — and anything it\n     * opened — jumps above its band peers without disturbing other bands.\n     *\n     * @param layer - The layer to raise and activate.\n     */\n    export function bringToFront(layer: DismissableLayer): void {\n        const node = _nodeByLayer.get(layer);\n\n        if (!node) {\n            return;\n        }\n\n        restampSubtree(node);\n        markActive(layer);\n    }\n\n    /**\n     * Returns the z-index currently assigned to `layer`, for surfaces that\n     * mirror it elsewhere. Falls back to the dropdown band when the layer is\n     * not registered.\n     *\n     * @param layer - The layer whose stamp to read.\n     * @returns The assigned z-index.\n     */\n    export function getZIndex(layer: DismissableLayer): number {\n        const node = _nodeByLayer.get(layer);\n\n        return node ? node.zIndex : Z_BAND_DROPDOWN;\n    }\n\n    /**\n     * Re-stamps `node`'s subtree from a fresh top-of-band counter run so the\n     * raised layer and its descendants ascend together, preserving their\n     * relative order. Each re-stamped layer is notified via\n     * {@link DismissableLayer.onZIndexChanged} so it can mirror the new value\n     * through its own typed `setZIndex` (the manager never writes the DOM).\n     */\n    function restampSubtree(node: LayerNode): void {\n        const walk = (n: LayerNode): void => {\n            n.zIndex = n.band + (++_zCounter);\n            n.layer.onZIndexChanged?.(n.zIndex);\n\n            for (const child of n.children) {\n                walk(child);\n            }\n        };\n\n        walk(node);\n    }\n\n    /** True when `node` (or a descendant layer) contains `target`. */\n    function nodeContains(node: LayerNode, target: Handle): boolean {\n        const el = node.layer.getLayerElement();\n\n        if (el && DOM.source.contains(el, target)) {\n            return true;\n        }\n\n        for (const child of node.children) {\n            if (nodeContains(child, target)) {\n                return true;\n            }\n        }\n\n        return false;\n    }\n\n    /** Marks `layer` active and deactivates the previously-active layer. */\n    function markActive(layer: DismissableLayer): void {\n        if (_activeLayer === layer) {\n            return;\n        }\n\n        deactivateActive();\n\n        _activeLayer = layer;\n\n        if (layer.onActivate) {\n            layer.onActivate(true);\n        }\n    }\n\n    /** Deactivates the currently-active layer, if any. */\n    function deactivateActive(): void {\n        if (_activeLayer && _activeLayer.onActivate) {\n            _activeLayer.onActivate(false);\n        }\n\n        _activeLayer = null;\n    }\n\n    /**\n     * Walks up the \"opened-from\" chain from `node` and returns the nearest\n     * ancestor-or-self layer that carries an activation affordance\n     * ({@link DismissableLayer.onActivate}), or `null` if none does. A layer\n     * opened inside a window resolves to that window, so the window stays\n     * active while its descendant holds focus — interacting with a child layer\n     * must not darken the title bar of the window that owns it.\n     */\n    function activatableAncestor(node: LayerNode): DismissableLayer | null {\n        let cur: LayerNode | null = node;\n\n        while (cur) {\n            if (cur.layer.onActivate) {\n                return cur.layer;\n            }\n\n            cur = cur.parent;\n        }\n\n        return null;\n    }\n\n    /**\n     * Walks the stack top-down for a pointer / focus interaction at `target`,\n     * dismissing each topmost layer whose dismiss mode and containment test\n     * say the interaction landed outside it, and marking the topmost\n     * containing layer active. `focusOnly` is true for the `focusin` pass, so\n     * only `\"blur\"` layers act on it (a `\"click-outside\"` layer ignores focus\n     * moves).\n     */\n    function handleOutside(target: Handle | null, focusOnly: boolean): void {\n        // Snapshot top-down so requestClose-driven unregisters don't disturb\n        // the walk; re-read containment against the live tree each step.\n        const snapshot  = _stack.slice().reverse();\n        let activated   = false;\n        let landedInside = false;\n\n        for (const node of snapshot) {\n            const mode = node.layer.getDismissMode();\n\n            if (containsAcrossLayers(node.layer, target)) {\n                // Activation belongs to the nearest activatable ancestor (the\n                // window a child layer was opened from), not the innermost\n                // containing layer; fall back to the layer itself when nothing\n                // up the chain carries an activation affordance, preserving the\n                // prior behaviour for standalone layers.\n                markActive(activatableAncestor(node) ?? node.layer);\n                activated    = true;\n                landedInside = true;\n\n                break;\n            }\n\n            const anchor = node.layer.getAnchorElement?.();\n\n            if (anchor && target && DOM.source.contains(anchor, target)) {\n                landedInside = true;\n\n                break;\n            }\n\n            const dismissable = mode === \"click-outside\" || mode === \"blur\";\n            const acts        = focusOnly ? mode === \"blur\" : dismissable;\n\n            if (mode === \"manual\" || mode === \"modal\" || !acts) {\n                // Modal captures the interaction: an outside pointer/focus on a\n                // modal must not fall through to dismiss layers beneath it.\n                if (mode === \"modal\") {\n                    landedInside = true;\n\n                    break;\n                }\n\n                continue;\n            }\n\n            node.layer.requestClose();\n        }\n\n        // An interaction that landed outside every layer's subtree (and any\n        // anchor / modal capture) deactivates the active layer — e.g. an\n        // empty-viewport click that should drop a window's active title-bar\n        // highlight. A focus move to a non-layer element (focusOnly) does not\n        // deactivate, so tabbing through page chrome doesn't flicker the\n        // active window.\n        if (!activated && !landedInside && !focusOnly) {\n            deactivateActive();\n        }\n    }\n\n    /** Document `pointerdown` handler — see {@link handleOutside}. */\n    function onPointerDown(e: PointerEvent): void {\n        handleOutside(e.target === null ? null : DOM.source.intern(e.target), false);\n    }\n\n    /**\n     * Window `blur` handler. When the whole browser window loses focus (the user\n     * clicks another application or alt-tabs away) no in-page `pointerdown` or\n     * `focusin` fires, so an open layer would otherwise stay up. Treat it as an\n     * interaction landing outside every layer, dismissing each `\"click-outside\"`\n     * / `\"blur\"` layer while a `\"modal\"` shields those beneath it and `\"manual\"`\n     * layers (windows) are left open.\n     *\n     * @remarks Viewport listeners are capture-phase, so element blurs from within\n     * the page surface here too; only a genuine window blur (`target` is the\n     * window itself) should dismiss layers.\n     */\n    function onWindowBlur(e: FocusEvent): void {\n        if (!DOM.source.isWindow(e.target === null ? null : DOM.source.intern(e.target))) {\n            return;\n        }\n\n        handleOutside(null, false);\n    }\n\n    /** Document `focusin` handler — only `\"blur\"` layers act on it. */\n    function onFocusIn(e: FocusEvent): void {\n        handleOutside(e.target === null ? null : DOM.source.intern(e.target), true);\n    }\n\n    /** Document `keydown` handler — Escape asks the topmost non-manual layer to close. */\n    function onKeyDown(e: KeyboardEvent): void {\n        if (e.key !== \"Escape\") {\n            return;\n        }\n\n        for (let i = _stack.length - 1; i >= 0; i--) {\n            const mode = _stack[i].layer.getDismissMode();\n\n            if (mode === \"manual\") {\n                continue;\n            }\n\n            _stack[i].layer.requestClose();\n\n            return;\n        }\n    }\n\n    /** Installs the three document-level listeners against the sentinel owner. */\n    function installListeners(): void {\n        Event.addViewportListener(_listenerOwner, \"pointerdown\", onPointerDown);\n        Event.addViewportListener(_listenerOwner, \"focusin\",     onFocusIn);\n        Event.addViewportListener(_listenerOwner, \"keydown\",     onKeyDown);\n        Event.addViewportListener(_listenerOwner, \"blur\",        onWindowBlur);\n\n        _listenersInstalled = true;\n    }\n\n    /** Removes the three document-level listeners. */\n    function uninstallListeners(): void {\n        Event.removeViewportListener(_listenerOwner, \"pointerdown\", onPointerDown);\n        Event.removeViewportListener(_listenerOwner, \"focusin\",     onFocusIn);\n        Event.removeViewportListener(_listenerOwner, \"keydown\",     onKeyDown);\n        Event.removeViewportListener(_listenerOwner, \"blur\",        onWindowBlur);\n\n        _listenersInstalled = false;\n    }\n}\n","// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Util } from \"~/core/Util.js\";\nimport type { Rect } from \"~/core/DOM.js\";\nimport type { Size } from \"~/primitive/Size.js\";\n\n/**\n * The primary growth axis for an anchored overlay.\n *\n * @category Core\n */\nexport type AnchorAxis = \"vertical\" | \"horizontal\";\n\n/**\n * Options controlling how {@link positionAnchored} places an element against an\n * anchor rect.\n *\n * @category Core\n */\nexport interface AnchorOptions {\n    /** Primary growth axis: `\"vertical\"` grows below/above, `\"horizontal\"` right/left. */\n    axis:    AnchorAxis;\n    /** Gap in px between the anchor edge and the element on the primary axis. Default 0. */\n    gap?:    number;\n    /** Viewport-edge margin in px kept on the cross axis. Default 0. */\n    margin?: number;\n}\n\n/**\n * Chooses a top-left coordinate on the primary axis. Prefers growing past the\n * anchor's far edge (`farEdge + gap`); flips to the near edge\n * (`nearEdge - extent - gap`) only when the far side lacks room AND the near\n * side has it. When neither side fits, saturates on-screen toward the side with\n * more room — pinned to the viewport's far end when the far side is roomier,\n * otherwise to `0` — so the element never overflows off-screen.\n *\n * @param nearEdge - The anchor's near edge (top / left) on this axis.\n * @param farEdge - The anchor's far edge (bottom / right) on this axis.\n * @param extent - The element's size on this axis.\n * @param viewportExtent - The viewport's size on this axis.\n * @param gap - Gap in px kept between the anchor edge and the element.\n * @returns The chosen top-left coordinate on this axis.\n *\n * @category Core\n */\nexport function positionAdjacent(nearEdge: number, farEdge: number, extent: number, viewportExtent: number, gap: number): number {\n    const farStart  = farEdge + gap;\n    const spaceFar  = viewportExtent - farStart;\n    const spaceNear = nearEdge - gap;\n\n    if (extent <= spaceFar) {\n        return farStart;\n    }\n\n    if (extent <= spaceNear) {\n        return nearEdge - extent - gap;\n    }\n\n    // Neither side fits: pin to whichever side has more room, saturated so the\n    // element stays on-screen (mirrors placeAnchored's spaceBelow/spaceAbove\n    // fallback, axis-agnostic).\n    if (spaceFar >= spaceNear) {\n        return Math.max(0, viewportExtent - extent);\n    }\n\n    return 0;\n}\n\n/**\n * Chooses a top-left coordinate on the cross axis for a **fixed-size** element\n * that ALIGNS WITH (and overlaps) its anchor rather than sitting beside it.\n * Prefers the element's near edge flush with the anchor's near edge\n * (`nearEdge`); flips to the element's FAR edge flush with the anchor's far\n * edge (`farEdge - extent`) only when the near alignment overflows the\n * viewport. This is alignment, not adjacency — the element overlaps the\n * anchor either way; only which pair of edges is made flush changes. It is\n * fixed-size and returns no `available` (contrast {@link\n * positionFlexibleAnchored}); `margin` binds on **this** axis. When neither\n * alignment fits on-screen (an anchor whose own far edge is off-viewport, or\n * an element wider than the viewport), falls back to {@link clampAxis} — the\n * right answer when no placement fits, not a flip substitute.\n *\n * @param nearEdge - The anchor's near edge (left / top) on this axis.\n * @param farEdge - The anchor's far edge (right / bottom) on this axis.\n * @param extent - The element's fixed size on this axis.\n * @param viewportExtent - The viewport's size on this axis.\n * @param margin - Viewport-edge margin in px kept on this axis.\n * @returns The chosen top-left coordinate on this axis.\n *\n * @category Core\n */\nexport function positionAligned(\n    nearEdge: number, farEdge: number, extent: number, viewportExtent: number, margin: number,\n): number {\n    // Preferred: the element's near edge aligns with the anchor's near edge.\n    if (nearEdge >= margin && nearEdge + extent <= viewportExtent - margin) {\n        return nearEdge;\n    }\n\n    // Flipped: the element's FAR edge aligns with the anchor's far edge. Note this\n    // is alignment, not adjacency — the element overlaps the anchor either way; only\n    // which pair of edges is made flush changes.\n    const farStart = farEdge - extent;\n\n    if (farStart >= margin && farStart + extent <= viewportExtent - margin) {\n        return farStart;\n    }\n\n    // Neither alignment fits on-screen (an anchor whose own far edge is off-viewport,\n    // or an element wider than the viewport): fall back to the clamp. Clamping is the\n    // right answer when NO placement fits — it is only wrong as a substitute for a flip.\n    return clampAxis(nearEdge, extent, viewportExtent, margin);\n}\n\n/**\n * Clamps a top-left coordinate into `[margin, extent - size - margin]`, pinning\n * to `margin` (top-aligned) when the element is larger than the available span\n * so the coordinate never goes below `margin` and off-screen. The upper bound is\n * floored to `margin` before clamping, because `Util.clamp` resolves a `min >\n * max` range to the max — the opposite of the `Math.max(margin, Math.min(...))`\n * this replaces; flooring keeps `min <= max`, so an over-large element pins to\n * `margin` and the caller's height-cap / scroll carries the overflow.\n *\n * @param value - The proposed coordinate.\n * @param size - The element's extent on this axis.\n * @param extent - The viewport's extent on this axis.\n * @param margin - Viewport-edge margin kept on this axis.\n * @returns The clamped coordinate.\n */\nfunction clampAxis(value: number, size: number, extent: number, margin: number): number {\n    return Util.clamp(value, margin, Math.max(margin, extent - size - margin));\n}\n\n/**\n * The chosen coordinate for a size-flexible anchored element, plus the room\n * available on the side it landed on.\n *\n * @category Core\n */\nexport interface FlexiblePlacement {\n    /** Top-left coordinate on the primary axis. */\n    start:     number;\n    /** Room (px) on the side actually chosen — the caller's height/width cap. */\n    available: number;\n}\n\n/**\n * Chooses a top-left coordinate on the primary axis for a **size-flexible**\n * element — one whose extent may be capped and the overflow scrolled, rather\n * than being placed at a fixed size. Grows from `farEdge`; flips to end at\n * `nearEdge` only when the content overflows the far room **and** the near\n * side is roomier. Unlike {@link positionAdjacent}, the far-fits check is against the\n * *room*, not the raw `extent` — so a flip that still doesn't fully fit on\n * the near side still flips (and clamps) rather than falling back to filling\n * the viewport over the anchor. The returned `available` is the room on the\n * chosen side, so a caller that caps the extent measures the correct side —\n * re-deriving it from `start` would measure the wrong side for a flipped\n * element. `viewportMargin` binds on **this** (primary) axis, unlike\n * {@link positionAnchored}'s cross-axis-only `margin`. Always flush against\n * the anchor edge — no `gap` parameter, because every current caller sits\n * flush.\n *\n * @param nearEdge - The anchor's near edge (top / left) on this axis — the\n *   edge a flipped element's far edge meets.\n * @param farEdge - The anchor's far edge (bottom / right) on this axis — the\n *   edge an unflipped element grows from.\n * @param extent - The element's unclamped preferred size on this axis.\n * @param viewportExtent - The viewport's size on this axis.\n * @param viewportMargin - Viewport-edge margin in px kept on this axis.\n * @returns The chosen coordinate and the room available at it.\n *\n * @category Core\n */\nexport function positionFlexibleAnchored(\n    nearEdge:       number,\n    farEdge:        number,\n    extent:         number,\n    viewportExtent: number,\n    viewportMargin: number,\n): FlexiblePlacement {\n    const roomFar  = viewportExtent - farEdge - viewportMargin;\n    const roomNear = nearEdge - viewportMargin;\n\n    if (extent <= roomFar || roomFar >= roomNear) {\n        return { start: farEdge, available: roomFar };\n    }\n\n    return { start: nearEdge - Math.min(extent, roomNear), available: roomNear };\n}\n\n/**\n * Places an element of `size` against `anchorRect` inside `viewport`. On the\n * primary axis it grows past the anchor's far edge (below / right), flipping to\n * the near edge (above / left) only when the far side lacks room AND the near\n * side has more; on the cross axis it aligns to the anchor's near edge,\n * flipping to align with the anchor's far edge when the near alignment\n * overflows, and clamping only when neither alignment fits. Pure — all\n * viewport reads are supplied by the caller, so it is directly unit-testable\n * with no DOM.\n *\n * @param anchorRect - The anchor element's bounding rect.\n * @param size - The element's width/height to place.\n * @param viewport - The viewport size to clamp/flip within.\n * @param opts - Axis, gap, and cross-axis margin.\n * @returns The resolved top-left `{ x, y }` for the element.\n *\n * @category Core\n */\nexport function positionAnchored(anchorRect: Rect, size: Size, viewport: Size, opts: AnchorOptions): { x: number; y: number } {\n    const gap    = opts.gap    ?? 0;\n    const margin = opts.margin ?? 0;\n\n    if (opts.axis === \"vertical\") {\n        const y = positionAdjacent(anchorRect.top, anchorRect.bottom, size.height, viewport.height, gap);\n        const x = positionAligned(anchorRect.left, anchorRect.right, size.width, viewport.width, margin);\n\n        return { x, y };\n    }\n\n    const x = positionAdjacent(anchorRect.left, anchorRect.right, size.width, viewport.width, gap);\n    const y = positionAligned(anchorRect.top, anchorRect.bottom, size.height, viewport.height, margin);\n\n    return { x, y };\n}\n","// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Component } from \"~/core/Component.js\";\nimport { DOM, type Handle } from \"~/core/DOM.js\";\nimport { Event } from \"~/core/Event.js\";\nimport { LayerManager } from \"~/core/LayerManager.js\";\nimport { positionAdjacent } from \"~/core/OverlayPosition.js\";\nimport { Util } from \"~/core/Util.js\";\nimport { Animation } from \"~/core/Animation.js\";\nimport { Text } from \"~/component/input/Text.js\";\n\nconst TOOLTIP_ANIM_DURATION_MS: number = 100;\n\n/**\n * Optional color overrides for a tooltip attachment.\n *\n * When provided to {@link Tooltip.attach}, these replace the default theme variables\n * for the duration that the tooltip is shown for that component.\n *\n * @category Core\n */\nexport interface TooltipColors {\n    /** CSS color for the tooltip background. */\n    background?: string;\n    /** CSS color for the tooltip text. */\n    color?: string;\n    /** CSS color for the tooltip border. */\n    border?: string;\n}\n\n/** Internal record of a component's tooltip attachment. */\ninterface TooltipAttachment {\n    text        : string;\n    colors      : TooltipColors | undefined;\n    mouseoverFn : (e: MouseEvent) => void;\n    mousemoveFn : (e: MouseEvent) => void;\n    mouseoutFn  : () => void;\n    mousedownFn : () => void;\n}\n\n/** Internal record of a raw-element tooltip attachment. */\ninterface ElementTooltipAttachment {\n    text        : string;\n    mouseoverFn : (e: MouseEvent) => void;\n    mousemoveFn : (e: MouseEvent) => void;\n    mouseoutFn  : () => void;\n    mousedownFn : () => void;\n    showTimer   : ReturnType<typeof setTimeout> | null;\n    lastX       : number;\n    lastY       : number;\n}\n\n/**\n * A singleton floating tooltip that appears near the cursor after a short delay.\n *\n * Use `Tooltip.attach(component, text)` to wire hover listeners onto any component.\n * For manual control use `Tooltip.show(text, x, y)` and `Tooltip.hide()` directly.\n *\n * @example\n * ```typescript\n * Tooltip.attach(myButton, 'Save the document');\n * ```\n *\n * @category Core\n */\n// Intentional exception to the `callable()`-wrap rule: `Tooltip` has a private\n// constructor and is used only through its static methods (`show` / `attach` /\n// …), so there is no public `new Tooltip()` / `Tooltip(...)` surface to wrap.\n// The singleton is exported directly (see `overlay/index.ts`).\nexport class Tooltip extends Component {\n\n    private static instance: Tooltip | null = null;\n    private static showTimer: ReturnType<typeof setTimeout> | null = null;\n    private static attachments: Map<string, TooltipAttachment> = new Map();\n    private static elementAttachments: Map<Handle, ElementTooltipAttachment> = new Map();\n    private static activeElement: Handle | null = null;\n\n    // True while the anchor-watch viewport listener is installed (only while a\n    // tooltip is shown). See _onAnchorWatch.\n    private static watching: boolean = false;\n\n    /**\n     * Hides the tooltip when its anchor element has left the DOM. The browser\n     * fires no `mouseout` when an element is removed under a stationary pointer,\n     * so a tooltip whose anchor vanishes would otherwise linger; this runs on\n     * pointer movement while a tooltip is shown and dismisses it once the anchor\n     * is no longer connected.\n     */\n    private static readonly _onAnchorWatch = (): void => {\n        if (Tooltip.activeElement !== null && !DOM.source.isConnected(Tooltip.activeElement)) {\n            Tooltip.hide();\n        }\n    };\n\n    // Set true while a fade-out is in flight; reset to false when the fade-out\n    // completes (so the deferred removeElement fires) or when a fresh `show()`\n    // re-displays the tooltip mid-fade (the deferred removeElement is then\n    // skipped because the tooltip is back on screen).\n    private static dismissing: boolean = false;\n\n    private static readonly H_PADDING: number = 16;\n    private static readonly V_PADDING: number = 8;\n    private static readonly MAX_WIDTH: number = 300;\n    private static readonly ITEM_HEIGHT: number = 20;\n\n    // Clearance kept free around the pointer *hotspot* (the arrow's tip, the\n    // hand's fingertip) — the coordinate `show` is handed. The cursor glyph\n    // hangs down and to the right of its hotspot, so this box is deliberately\n    // NOT centred on it: nothing sits above the tip, and only a few px reach\n    // left of it. A box symmetric about the hotspot would push a flipped\n    // tooltip visibly further from the cursor than an unflipped one, since the\n    // same gap spans glyph on one side and empty space on the other.\n    //\n    // These are clearance, not glyph metrics: DOWN is shorter than the ~24px\n    // glyph on purpose, so an unflipped tooltip keeps sitting alongside the\n    // pointer's lower half (where it tapers and hides nothing) rather than\n    // being pushed clear of it. No API reports the live cursor's size or\n    // hotspot, so the numbers approximate the platform defaults.\n    private static readonly CURSOR_LEFT: number = 4;\n    private static readonly CURSOR_RIGHT: number = 12;\n    private static readonly CURSOR_UP: number = 0;\n    private static readonly CURSOR_DOWN: number = 12;\n    private static readonly CURSOR_GAP: number = 2;\n\n    private _text: Text;\n\n    // Number of `\\n`-separated lines in the text currently shown. Cached by\n    // `show()` (which knows the raw string) and read by `doLayout()` (which\n    // only sees the committed size) so the label's height tracks the line\n    // count. 1 for a single-line tooltip — the unchanged legacy case.\n    private _lineCount: number = 1;\n\n    // Resolved per-line pixel height of the tooltip text, set by `show()` from\n    // the live additive line box and read by `doLayout()`. Replaces the\n    // fixed `ITEM_HEIGHT` multiplier, which over-allocated ~3px/line and left\n    // a trailing empty line on multi-line tooltips.\n    private _perLine: number = Tooltip.ITEM_HEIGHT;\n\n    /** Private — use the static methods; only one instance is ever created. */\n    private constructor() {\n        super();\n\n        this.setVisible(false);\n        // Above every managed layer (incl. a modal Dialog and its backdrop) so a\n        // hover tooltip is never occluded.\n        this.setZIndex(LayerManager.Band.Tooltip);\n        this.setBackgroundColor(\"var(--ts-ui-tooltip-bg, rgb(255, 255, 240))\");\n        this.setForegroundColor(\"var(--ts-ui-tooltip-color, rgb(0, 0, 0))\");\n        this.setBorder({ border: \"1px solid var(--ts-ui-tooltip-border, rgb(180, 180, 100))\" });\n        this.setShadow(\"var(--ts-ui-tooltip-shadow, 1px 2px 4px rgba(0, 0, 0, 0.2))\");\n        this.setBorderRadius(\"var(--ts-ui-border-radius, 4px)\");\n        this.setPointerEvents(\"none\");\n        // Top-level overlay, dynamic size — layout+paint containment scopes reflow without\n        // committing to a fixed size.\n        this.setContain(\"layout paint\");\n\n        this._text = new Text();\n        this._text.setPointerEvents(\"none\");\n        // `pre-wrap` preserves explicit `\\n` breaks as real lines *and* wraps\n        // a line that overflows the fixed width — `nowrap` would collapse the\n        // breaks onto one line. A single-line tooltip narrower than MAX_WIDTH\n        // renders identically to the old `nowrap` behaviour.\n        this._text.setWhiteSpace(\"pre-wrap\");\n        this.addComponent(this._text);\n    }\n\n    /**\n     * Returns the single shared `Tooltip` instance, creating it on first call.\n     *\n     * @returns The singleton `Tooltip` component.\n     */\n    private static getInstance(): Tooltip {\n        if (!Tooltip.instance) {\n            Tooltip.instance = new Tooltip();\n        }\n\n        return Tooltip.instance;\n    }\n\n    /**\n     * Immediately shows the tooltip with the given text near the specified coordinates.\n     *\n     * The tooltip sits just past the cursor on each axis — down and to the right —\n     * flipping to sit just before it when there is no room past, so it never covers\n     * the cursor it's hinting at. The clearance is measured from a small box around\n     * the pointer hotspot rather than from the hotspot itself, so a flipped tooltip\n     * hugs the cursor as closely as an unflipped one. A tooltip taller than roughly\n     * half the viewport (an unusually long multi-line label) can still saturate\n     * on-screen rather than flipping cleanly, since its height is uncapped and never\n     * scrolls; this is a known limitation, not a bug to fix here.\n     *\n     * @param text - The string to display inside the tooltip.\n     * @param x - Horizontal viewport coordinate for the tooltip origin.\n     * @param y - Vertical viewport coordinate for the tooltip origin.\n     */\n    static show(text: string, x: number, y: number): void {\n        if (Tooltip.showTimer !== null) {\n            clearTimeout(Tooltip.showTimer);\n            Tooltip.showTimer = null;\n        }\n\n        const inst = Tooltip.getInstance();\n\n        // Whether the tooltip is already on screen (and not mid-dismiss). A\n        // caller that shows on every mousemove — a chart hover — reaches `show`\n        // dozens of times a second; replaying the entrance fade each time would\n        // reset opacity to 0 before the 100 ms fade completes, flickering the\n        // tooltip. When already shown we skip the fade and just reposition/retext.\n        const alreadyShown = inst.isVisible() && !Tooltip.dismissing;\n\n        inst._text.setText(text);\n\n        // Size width to the widest line and height to the line count so a\n        // `\\n`-containing string renders as a multi-line block. A string with\n        // no `\\n` yields a single line and the original single-line sizing.\n        const lines      = text.split(\"\\n\");\n        const widestLine = lines.reduce((max, line) => Math.max(max, Util.measureTextWidth(line)), 0);\n\n        inst._perLine = inst._perLineHeight();\n\n        // No minimum width — the tooltip hugs its content (widest line plus\n        // horizontal padding), capped at MAX_WIDTH. A min-width floor would\n        // pad short labels out to a fixed box wider than their text.\n        const tooltipWidth  = Math.min(Tooltip.MAX_WIDTH, widestLine + Tooltip.H_PADDING);\n\n        // When the widest line is wider than the cap, the label soft-wraps at the\n        // available text width, so the visual line count exceeds the `\\n`-split\n        // count. Measure the wrapped height at that width and derive the real line\n        // count; an uncapped tooltip never wraps, so the split count stands.\n        if (widestLine + Tooltip.H_PADDING > Tooltip.MAX_WIDTH) {\n            const availTextWidth = tooltipWidth - Tooltip.H_PADDING;\n            const wrappedHeight  = DOM.source.measureText(text, { maxWidth: availTextWidth }).height;\n            inst._lineCount      = Math.max(lines.length, Math.round(wrappedHeight / inst._perLine));\n        } else {\n            inst._lineCount = lines.length;\n        }\n\n        // Height hugs the text: one resolved line height per line plus padding.\n        // Floor the single-line case to the legacy ITEM_HEIGHT box so plain\n        // one-line tooltips stay pixel-stable; only multi-line tooltips switch\n        // to the tighter per-line height that removes the trailing gap.\n        let tooltipHeight = inst._lineCount * inst._perLine + Tooltip.V_PADDING;\n        if (inst._lineCount === 1) {\n            tooltipHeight = Math.max(tooltipHeight, Tooltip.ITEM_HEIGHT + Tooltip.V_PADDING);\n        }\n\n        inst.setWidth(tooltipWidth);\n        inst.setHeight(tooltipHeight);\n\n        const vp = DOM.source.getViewportSize();\n\n        // Clamp the cursor into the viewport first: the flip primitive only guarantees\n        // an on-screen result for an in-viewport anchor, and show() is public.\n        const cx = Util.clamp(x, 0, vp.width);\n        const cy = Util.clamp(y, 0, vp.height);\n\n        // Sit past the cursor's clearance box, flipping to sit *before* it when there\n        // is no room past — so the tooltip can never land under the cursor. The box\n        // (not the bare hotspot) is the anchor rect, which is what lets the two sides\n        // differ: the primitive applies one `gap` to whichever edge it picks, and the\n        // asymmetry the cursor actually has lives in the edges. No viewport margin,\n        // since the tooltip may sit flush against an edge.\n        inst.setX(positionAdjacent(\n            cx - Tooltip.CURSOR_LEFT, cx + Tooltip.CURSOR_RIGHT, tooltipWidth,  vp.width,  Tooltip.CURSOR_GAP,\n        ));\n        inst.setY(positionAdjacent(\n            cy - Tooltip.CURSOR_UP,   cy + Tooltip.CURSOR_DOWN,  tooltipHeight, vp.height, Tooltip.CURSOR_GAP,\n        ));\n\n        const el = inst.getElement(true)!;\n\n        inst.scheduleLayout();\n\n        LayerManager.mount(el);\n\n        inst.setVisible(true);\n\n        // Watch for the anchor leaving the DOM while the tooltip is up (a removed\n        // element fires no mouseout), so an orphaned tooltip dismisses on the next\n        // pointer move instead of lingering.\n        if (!Tooltip.watching) {\n            Event.addViewportListener(inst, \"mousemove\", Tooltip._onAnchorWatch);\n            Tooltip.watching = true;\n        }\n\n        // Cancel a pending fade-out's removeElement so a fresh show during the\n        // outgoing transition keeps the element in the DOM.\n        Tooltip.dismissing = false;\n\n        if (alreadyShown) {\n            // Already visible — hold at full opacity; the position/size/text\n            // updates above are all this repeat show needs. No entrance fade.\n            DOM.sink.apply(el, { style: { opacity: \"1\" } });\n\n            return;\n        }\n\n        Animation.play(el, {\n            from:       { opacity: \"0\" },\n            to:         { opacity: \"1\" },\n            durationMs: TOOLTIP_ANIM_DURATION_MS,\n            properties: [\"opacity\"],\n        });\n    }\n\n    /**\n     * Hides and detaches the tooltip.\n     *\n     * Any pending show timer is also cancelled.\n     */\n    static hide(): void {\n        if (Tooltip.showTimer !== null) {\n            clearTimeout(Tooltip.showTimer);\n            Tooltip.showTimer = null;\n        }\n\n        const inst = Tooltip.getInstance();\n        const el   = inst.getElement();\n\n        // The tooltip is going away; stop watching the (now-irrelevant) anchor\n        // and forget it.\n        if (Tooltip.watching) {\n            Event.removeViewportListener(inst, \"mousemove\", Tooltip._onAnchorWatch);\n            Tooltip.watching = false;\n        }\n        Tooltip.activeElement = null;\n\n        if (!el) {\n            return;\n        }\n\n        Tooltip.dismissing = true;\n\n        Animation.play(el, {\n            to:         { opacity: \"0\" },\n            durationMs: TOOLTIP_ANIM_DURATION_MS,\n            properties: [\"opacity\"],\n            onComplete: () => {\n                if (!Tooltip.dismissing) {\n                    return;\n                }\n                Tooltip.dismissing = false;\n                inst.setVisible(false);\n                inst.removeElement();\n            },\n        });\n    }\n\n    /**\n     * Wires `mouseover` and `mouseout` listeners onto `component` so the tooltip\n     * shows automatically after a 500 ms hover delay.\n     *\n     * @remarks Uses `mouseover`/`mouseout` rather than `mouseenter`/`mouseleave`\n     * because the Event system routes through a window-level capture handler, and\n     * the non-bubbling enter/leave events are not reliably seen there in Chrome.\n     *\n     * If `colors` is provided the tooltip uses those colors instead of the default\n     * theme variables while it is showing for this component.\n     *\n     * Calling `attach` on a component that already has an attachment replaces it.\n     *\n     * @param component - The component to attach hover behaviour to.\n     * @param text - The tooltip text to display.\n     * @param colors - Optional color overrides applied while this tooltip is visible.\n     */\n    static attach(component: Component, text: string, colors?: TooltipColors): void {\n        Tooltip.detach(component);\n\n        let cursorX = 0;\n        let cursorY = 0;\n\n        const mouseoverFn = (e: MouseEvent) => {\n            if (Tooltip.showTimer !== null) {\n                return;\n            }\n\n            cursorX = e.clientX;\n            cursorY = e.clientY;\n\n            Tooltip.showTimer = setTimeout(() => {\n                Tooltip._applyColors(colors);\n                // Record the anchor so the anchor-watch dismisses the tooltip if\n                // this component is later removed from the DOM.\n                Tooltip.activeElement = component.getElement() ?? null;\n                Tooltip.show(text, cursorX, cursorY);\n                Tooltip.showTimer = null;\n            }, 500);\n        };\n\n        const mousemoveFn = (e: MouseEvent) => {\n            cursorX = e.clientX;\n            cursorY = e.clientY;\n        };\n\n        const mouseoutFn = () => {\n            Tooltip.hide();\n        };\n\n        // Acting on the component (a click, or the start of a drag) dismisses\n        // its tooltip: once the pointer is pressed the hover hint has served its\n        // purpose and would only obscure the result of the action. `hide` also\n        // cancels a still-pending show timer, so a press during the hover delay\n        // suppresses the tooltip entirely. It stays hidden until the pointer\n        // leaves and re-enters, since no fresh `mouseover` fires under a\n        // stationary cursor.\n        const mousedownFn = () => {\n            Tooltip.hide();\n        };\n\n        Event.addListener(component, \"mouseover\", mouseoverFn);\n        Event.addListener(component, \"mousemove\", mousemoveFn);\n        Event.addListener(component, \"mouseout\", mouseoutFn);\n        Event.addListener(component, \"mousedown\", mousedownFn);\n\n        Tooltip.attachments.set(component.getId(), {\n            text, colors, mouseoverFn, mousemoveFn, mouseoutFn, mousedownFn,\n        });\n    }\n\n    /**\n     * Removes the tooltip attachment from a component, cancelling any pending show\n     * and hiding the tooltip if it is currently visible for this component.\n     *\n     * @param component - The component whose attachment should be removed.\n     */\n    static detach(component: Component): void {\n        const id  = component.getId();\n        const att = Tooltip.attachments.get(id);\n\n        if (!att) {\n            return;\n        }\n\n        Event.removeListener(component, \"mouseover\", att.mouseoverFn);\n        Event.removeListener(component, \"mousemove\", att.mousemoveFn);\n        Event.removeListener(component, \"mouseout\",  att.mouseoutFn);\n        Event.removeListener(component, \"mousedown\", att.mousedownFn);\n\n        Tooltip.attachments.delete(id);\n        Tooltip.hide();\n    }\n\n    /**\n     * Applies optional color overrides to the singleton tooltip instance before it is shown.\n     * Resets to the default theme variables when no overrides are provided.\n     *\n     * @param colors - The color overrides to apply, or `undefined` to use defaults.\n     */\n    private static _applyColors(colors?: TooltipColors): void {\n        const inst = Tooltip.getInstance();\n\n        inst.setBackgroundColor(\n            colors?.background ?? 'var(--ts-ui-tooltip-bg, rgb(255, 255, 240))'\n        );\n        inst.setForegroundColor(\n            colors?.color ?? 'var(--ts-ui-tooltip-color, rgb(0, 0, 0))'\n        );\n        inst.setBorder({ border: `1px solid ${colors?.border ?? 'var(--ts-ui-tooltip-border, rgb(180, 180, 100))'}` });\n    }\n\n    /**\n     * Wires native `mouseover`, `mousemove`, and `mouseout` listeners directly onto\n     * a raw DOM element so the tooltip shows after a 500 ms hover delay.\n     *\n     * @remarks Use this instead of {@link attach} when the element contains child nodes\n     * that would receive the event as `evnt.target` — the Event system's component\n     * listener only matches the exact target id, so `attach` would miss those cases.\n     *\n     * Calling `attachToElement` on an element that already has an attachment\n     * replaces it — the previous listeners are removed and a fresh set is\n     * installed against the new text. If the tooltip is currently visible for\n     * this element when the call happens, it re-renders immediately at the\n     * last known cursor position so the visible text updates without a\n     * re-hover.\n     *\n     * @param element - The element handle to attach hover behaviour to.\n     * @param text - The tooltip text to display.\n     */\n    static attachToElement(element: Handle, text: string): void {\n        const previous  = Tooltip.elementAttachments.get(element);\n        const wasActive = Tooltip.activeElement === element;\n\n        // Carry the previous binding's last cursor coords so the mid-hover\n        // repaint below has real values instead of (0, 0) — detachElement\n        // deletes the WeakMap entry, so the read has to happen first.\n        const carryX = previous ? previous.lastX : 0;\n        const carryY = previous ? previous.lastY : 0;\n\n        Tooltip.detachElement(element);\n\n        const att: ElementTooltipAttachment = {\n            text,\n            showTimer  : null,\n            lastX      : carryX,\n            lastY      : carryY,\n            mouseoverFn: function onTooltipMouseOver(e: MouseEvent): void {\n                if (att.showTimer !== null) {\n                    return;\n                }\n\n                att.lastX = e.clientX;\n                att.lastY = e.clientY;\n\n                att.showTimer = setTimeout(function onTooltipShowTimer(): void {\n                    Tooltip.activeElement = element;\n                    Tooltip.show(att.text, att.lastX, att.lastY);\n                    att.showTimer = null;\n                }, 500);\n            },\n            mousemoveFn: function onTooltipMouseMove(e: MouseEvent): void {\n                att.lastX = e.clientX;\n                att.lastY = e.clientY;\n            },\n            mouseoutFn: function onTooltipMouseOut(): void {\n                if (att.showTimer !== null) {\n                    clearTimeout(att.showTimer);\n                    att.showTimer = null;\n                }\n\n                if (Tooltip.activeElement === element) {\n                    Tooltip.activeElement = null;\n                }\n\n                Tooltip.hide();\n            },\n            // Pressing the element (click or drag start) dismisses its tooltip\n            // and cancels any pending show — see the `attach` counterpart.\n            mousedownFn: function onTooltipMouseDown(): void {\n                if (att.showTimer !== null) {\n                    clearTimeout(att.showTimer);\n                    att.showTimer = null;\n                }\n\n                Tooltip.hide();\n            },\n        };\n\n        DOM.sink.addListener(element, \"mouseover\", att.mouseoverFn);\n        DOM.sink.addListener(element, \"mousemove\", att.mousemoveFn);\n        DOM.sink.addListener(element, \"mouseout\",  att.mouseoutFn);\n        DOM.sink.addListener(element, \"mousedown\", att.mousedownFn);\n\n        Tooltip.elementAttachments.set(element, att);\n\n        // Mid-hover update: if the previous attachment was the active tooltip\n        // target, repaint the visible tooltip with the new text at the last\n        // known cursor coords so the swap is seen without a re-hover.\n        if (wasActive) {\n            Tooltip.activeElement = element;\n            Tooltip.show(text, att.lastX, att.lastY);\n        }\n    }\n\n    /**\n     * Removes an `attachToElement` binding installed on an element handle.\n     *\n     * Detaches the three hover listeners, cancels any pending show timer, and\n     * clears the active-element tracker if it pointed at this element.\n     * Idempotent — calling on an unattached element is a no-op.\n     *\n     * @param element - The element handle whose attachment should be removed.\n     */\n    static detachElement(element: Handle): void {\n        const att = Tooltip.elementAttachments.get(element);\n\n        if (!att) {\n            return;\n        }\n\n        DOM.sink.removeListener(element, \"mouseover\", att.mouseoverFn);\n        DOM.sink.removeListener(element, \"mousemove\", att.mousemoveFn);\n        DOM.sink.removeListener(element, \"mouseout\",  att.mouseoutFn);\n        DOM.sink.removeListener(element, \"mousedown\", att.mousedownFn);\n\n        if (att.showTimer !== null) {\n            clearTimeout(att.showTimer);\n            att.showTimer = null;\n        }\n\n        Tooltip.elementAttachments.delete(element);\n\n        if (Tooltip.activeElement === element) {\n            Tooltip.activeElement = null;\n        }\n    }\n\n    /**\n     * Resolves the tooltip text's rendered per-line height in pixels from the\n     * live additive line box, measured at hover time. Matches the `_text` label\n     * (a default `Text`: 14px font, theme leading) so the box hugs the text\n     * vertically with no trailing gap, and tracks theme/font changes on the next\n     * hover.\n     *\n     * @returns The per-line height in pixels, ceiled to a whole pixel.\n     *\n     * @remarks `measureTextMetrics` already defaults `lineHeight` to\n     * `calc(1em + var(--ts-ui-line-padding, 2px))`, so the line box is left to\n     * that default rather than passed explicitly.\n     */\n    private _perLineHeight(): number {\n        const { height } = DOM.source.measureText(\"X\");\n\n        return Math.ceil(height);\n    }\n\n    /**\n     * Positions the label to fill the tooltip body with uniform padding.\n     *\n     * @returns This component, for method chaining.\n     */\n    doLayout(): this {\n        super.doLayout();\n\n        this._text.setX(Tooltip.H_PADDING / 2);\n        this._text.setY(Tooltip.V_PADDING / 2);\n        this._text.setWidth(Math.max(0, this.getWidth() - Tooltip.H_PADDING));\n        this._text.setHeight(this._lineCount * this._perLine);\n\n        return this;\n    }\n}\n"],"mappings":"mJAwHA,IAAM,EAA0B,IAC1B,EAA0B,KAC1B,EAA0B,IAC1B,EAA0B,KAK1B,EAA0B,KAU1B,EAA4B,IAAI,EAmB/B,eAGH,IAAM,EAAsB,CAAC,EAIvB,EAAqD,IAAI,QAG3D,EAAoB,EAGpB,EAAwC,KAExC,EAA+B,GAStB,EAAA,KAAO,CAChB,OAAU,EACV,QAAU,EACV,SAAU,EACV,OAAU,EACV,QAAU,CACd,EAQA,SAAS,QAAQ,EAA0B,EAAyB,CAChE,OAAO,EAAS,EAAO,KAAO,CAClC,CAaO,SAAS,SAAS,EAA+B,CACpD,GAAI,EAAa,IAAI,CAAK,EACtB,OAGJ,IAAM,EAAU,EAAO,OAAS,EAAI,EAAO,EAAO,OAAS,GAAK,KAC1D,EAAU,EAAM,cAAc,EAAI,KAAO,EACzC,EAAU,QAAQ,EAAQ,EAAM,UAAU,GAAK,CAAe,EAG9D,EAAkB,CAAE,QAAO,SAAQ,SAAU,CAAC,EAAG,OAAM,OAF9C,GAAQ,EAAE,CAE2C,EAEpE,EAAa,IAAI,EAAO,CAAI,EAC5B,EAAO,KAAK,CAAI,EAEZ,GACA,EAAO,SAAS,KAAK,CAAI,EAGxB,GACD,iBAAiB,CAEzB,qBAYO,SAAS,MAAM,EAAkB,CAC/B,EAAI,OAAO,SAAS,EAAI,OAAO,mBAAmB,EAAG,CAAE,GACxD,EAAI,KAAK,YAAY,EAAI,OAAO,mBAAmB,EAAG,CAAE,CAEhE,eASO,SAAS,WAAW,EAA+B,CACtD,IAAM,EAAO,EAAa,IAAI,CAAK,EAEnC,GAAI,CAAC,EACD,OAGJ,EAAa,OAAO,CAAK,EAEzB,IAAM,EAAM,EAAO,QAAQ,CAAI,EAM/B,GAJI,GAAO,GACP,EAAO,OAAO,EAAK,CAAC,EAGpB,EAAK,OAAQ,CACb,IAAM,EAAK,EAAK,OAAO,SAAS,QAAQ,CAAI,EAExC,GAAM,GACN,EAAK,OAAO,SAAS,OAAO,EAAI,CAAC,CAEzC,CAEI,IAAiB,IACjB,EAAe,MAGf,EAAO,SAAW,GAAK,GACvB,mBAAmB,CAE3B,yBAaO,SAAS,qBAAqB,EAAyB,EAA8B,CACxF,GAAI,CAAC,EACD,MAAO,GAGX,IAAM,EAAY,EAAa,IAAI,CAAK,EAExC,GAAI,CAAC,EAAW,CACZ,IAAM,EAAK,EAAM,gBAAgB,EAEjC,OAAO,EAAK,EAAI,OAAO,SAAS,EAAI,CAAI,EAAI,EAChD,CAEA,OAAO,aAAa,EAAW,CAAI,CACvC,6CAQO,SAAS,aAAuC,CACnD,OAAO,EAAO,OAAS,EAAI,EAAO,EAAO,OAAS,EAAE,CAAC,MAAQ,IACjE,2BAUO,SAAS,aAAa,EAA+B,CACxD,IAAM,EAAO,EAAa,IAAI,CAAK,EAE9B,IAIL,eAAe,CAAI,EACnB,WAAW,CAAK,EACpB,6BAUO,SAAS,UAAU,EAAiC,CACvD,IAAM,EAAO,EAAa,IAAI,CAAK,EAEnC,OAAO,EAAO,EAAK,OAAS,CAChC,uBASA,SAAS,eAAe,EAAuB,CAC3C,IAAM,KAAQ,GAAuB,CACjC,EAAE,OAAS,EAAE,MAAQ,EAAE,EACvB,EAAE,MAAM,kBAAkB,EAAE,MAAM,EAElC,IAAK,IAAM,KAAS,EAAE,SAClB,KAAK,CAAK,CAElB,EAEA,KAAK,CAAI,CACb,CAGA,SAAS,aAAa,EAAiB,EAAyB,CAC5D,IAAM,EAAK,EAAK,MAAM,gBAAgB,EAEtC,GAAI,GAAM,EAAI,OAAO,SAAS,EAAI,CAAM,EACpC,MAAO,GAGX,IAAK,IAAM,KAAS,EAAK,SACrB,GAAI,aAAa,EAAO,CAAM,EAC1B,MAAO,GAIf,MAAO,EACX,CAGA,SAAS,WAAW,EAA+B,CAC3C,IAAiB,IAIrB,iBAAiB,EAEjB,EAAe,EAEX,EAAM,YACN,EAAM,WAAW,EAAI,EAE7B,CAGA,SAAS,kBAAyB,CAC1B,GAAgB,EAAa,YAC7B,EAAa,WAAW,EAAK,EAGjC,EAAe,IACnB,CAUA,SAAS,oBAAoB,EAA0C,CACnE,IAAI,EAAwB,EAE5B,KAAO,GAAK,CACR,GAAI,EAAI,MAAM,WACV,OAAO,EAAI,MAGf,EAAM,EAAI,MACd,CAEA,OAAO,IACX,CAUA,SAAS,cAAc,EAAuB,EAA0B,CAGpE,IAAM,EAAY,EAAO,MAAM,CAAC,CAAC,QAAQ,EACrC,EAAc,GACd,EAAe,GAEnB,IAAK,IAAM,KAAQ,EAAU,CACzB,IAAM,EAAO,EAAK,MAAM,eAAe,EAEvC,GAAI,qBAAqB,EAAK,MAAO,CAAM,EAAG,CAM1C,WAAW,oBAAoB,CAAI,GAAK,EAAK,KAAK,EAClD,EAAe,GACf,EAAe,GAEf,KACJ,CAEA,IAAM,EAAS,EAAK,MAAM,mBAAmB,EAE7C,GAAI,GAAU,GAAU,EAAI,OAAO,SAAS,EAAQ,CAAM,EAAG,CACzD,EAAe,GAEf,KACJ,CAKA,GAAI,IAAS,UAAY,IAAS,SAAW,EAFzB,EAAY,IAAS,OADrB,IAAS,iBAAmB,IAAS,QAGL,CAGhD,GAAI,IAAS,QAAS,CAClB,EAAe,GAEf,KACJ,CAEA,QACJ,CAEA,EAAK,MAAM,aAAa,CAC5B,CAQI,CAAC,GAAa,CAAC,GAAgB,CAAC,GAChC,iBAAiB,CAEzB,CAGA,SAAS,cAAc,EAAuB,CAC1C,cAAc,EAAE,SAAW,KAAO,KAAO,EAAI,OAAO,OAAO,EAAE,MAAM,EAAG,EAAK,CAC/E,CAcA,SAAS,aAAa,EAAqB,CAClC,EAAI,OAAO,SAAS,EAAE,SAAW,KAAO,KAAO,EAAI,OAAO,OAAO,EAAE,MAAM,CAAC,GAI/E,cAAc,KAAM,EAAK,CAC7B,CAGA,SAAS,UAAU,EAAqB,CACpC,cAAc,EAAE,SAAW,KAAO,KAAO,EAAI,OAAO,OAAO,EAAE,MAAM,EAAG,EAAI,CAC9E,CAGA,SAAS,UAAU,EAAwB,CACnC,KAAE,MAAQ,SAId,KAAK,IAAI,EAAI,EAAO,OAAS,EAAG,GAAK,EAAG,IACvB,KAAO,EAAE,CAAC,MAAM,eAEzB,IAAS,SAIb,GAAO,EAAE,CAAC,MAAM,aAAa,EAE7B,MAF6B,CAGjC,CACJ,CAGA,SAAS,kBAAyB,CAC9B,EAAM,oBAAoB,EAAgB,cAAe,aAAa,EACtE,EAAM,oBAAoB,EAAgB,UAAe,SAAS,EAClE,EAAM,oBAAoB,EAAgB,UAAe,SAAS,EAClE,EAAM,oBAAoB,EAAgB,OAAe,YAAY,EAErE,EAAsB,EAC1B,CAGA,SAAS,oBAA2B,CAChC,EAAM,uBAAuB,EAAgB,cAAe,aAAa,EACzE,EAAM,uBAAuB,EAAgB,UAAe,SAAS,EACrE,EAAM,uBAAuB,EAAgB,UAAe,SAAS,EACrE,EAAM,uBAAuB,EAAgB,OAAe,YAAY,EAExE,EAAsB,EAC1B,IACH,AAAA,IAAA,CAAA,CAAD,ECrhBA,SAAgB,iBAAiB,EAAkB,EAAiB,EAAgB,EAAwB,EAAqB,CAC7H,IAAM,EAAY,EAAU,EACtB,EAAY,EAAiB,EAC7B,EAAY,EAAW,EAiB7B,OAfI,GAAU,EACH,EAGP,GAAU,EACH,EAAW,EAAS,EAM3B,GAAY,EACL,KAAK,IAAI,EAAG,EAAiB,CAAM,EAGvC,CACX,CAyBA,SAAgB,gBACZ,EAAkB,EAAiB,EAAgB,EAAwB,EACrE,CAEN,GAAI,GAAY,GAAU,EAAW,GAAU,EAAiB,EAC5D,OAAO,EAMX,IAAM,EAAW,EAAU,EAS3B,OAPI,GAAY,GAAU,EAAW,GAAU,EAAiB,EACrD,EAMJ,UAAU,EAAU,EAAQ,EAAgB,CAAM,CAC7D,CAiBA,SAAS,UAAU,EAAe,EAAc,EAAgB,EAAwB,CACpF,OAAO,EAAK,MAAM,EAAO,EAAQ,KAAK,IAAI,EAAQ,EAAS,EAAO,CAAM,CAAC,CAC7E,CA0CA,SAAgB,yBACZ,EACA,EACA,EACA,EACA,EACiB,CACjB,IAAM,EAAW,EAAiB,EAAU,EACtC,EAAW,EAAW,EAM5B,OAJI,GAAU,GAAW,GAAW,EACzB,CAAE,MAAO,EAAS,UAAW,CAAQ,EAGzC,CAAE,MAAO,EAAW,KAAK,IAAI,EAAQ,CAAQ,EAAG,UAAW,CAAS,CAC/E,CAoBA,SAAgB,iBAAiB,EAAkB,EAAY,EAAgB,EAA+C,CAC1H,IAAM,EAAS,EAAK,KAAU,EACxB,EAAS,EAAK,QAAU,EAE9B,GAAI,EAAK,OAAS,WAAY,CAC1B,IAAM,EAAI,iBAAiB,EAAW,IAAK,EAAW,OAAQ,EAAK,OAAQ,EAAS,OAAQ,CAAG,EAG/F,MAAO,CAAE,EAFC,gBAAgB,EAAW,KAAM,EAAW,MAAO,EAAK,MAAO,EAAS,MAAO,CAEhF,EAAG,GAAE,CAClB,CAKA,MAAO,CAAE,EAHC,iBAAiB,EAAW,KAAM,EAAW,MAAO,EAAK,MAAO,EAAS,MAAO,CAGjF,EAAG,EAFF,gBAAgB,EAAW,IAAK,EAAW,OAAQ,EAAK,OAAQ,EAAS,OAAQ,CAE/E,CAAE,CAClB,CCpNA,IAAM,EAAmC,IA0D5B,EAAb,MAAa,gBAAgB,CAAU,CAEnC,OAAe,SAA2B,KAC1C,OAAe,UAAkD,KACjE,OAAe,YAA8C,IAAI,IACjE,OAAe,mBAA4D,IAAI,IAC/E,OAAe,cAA+B,KAI9C,OAAe,SAAoB,GASnC,OAAwB,mBAA6B,CAC7C,QAAQ,gBAAkB,MAAQ,CAAC,EAAI,OAAO,YAAY,QAAQ,aAAa,GAC/E,QAAQ,KAAK,CAErB,EAMA,OAAe,WAAsB,GAErC,OAAwB,UAAoB,GAC5C,OAAwB,UAAoB,EAC5C,OAAwB,UAAoB,IAC5C,OAAwB,YAAsB,GAe9C,OAAwB,YAAsB,EAC9C,OAAwB,aAAuB,GAC/C,OAAwB,UAAoB,EAC5C,OAAwB,YAAsB,GAC9C,OAAwB,WAAqB,EAE7C,MAMA,WAA6B,EAM7B,SAA2B,QAAQ,YAGnC,aAAsB,CAClB,MAAM,EAEN,KAAK,WAAW,EAAK,EAGrB,KAAK,UAAU,EAAa,KAAK,OAAO,EACxC,KAAK,mBAAmB,6CAA6C,EACrE,KAAK,mBAAmB,0CAA0C,EAClE,KAAK,UAAU,CAAE,OAAQ,2DAA4D,CAAC,EACtF,KAAK,UAAU,6DAA6D,EAC5E,KAAK,gBAAgB,iCAAiC,EACtD,KAAK,iBAAiB,MAAM,EAG5B,KAAK,WAAW,cAAc,EAE9B,KAAK,MAAQ,IAAI,EACjB,KAAK,MAAM,iBAAiB,MAAM,EAKlC,KAAK,MAAM,cAAc,UAAU,EACnC,KAAK,aAAa,KAAK,KAAK,CAChC,CAOA,OAAe,aAAuB,CAKlC,MAJA,CACI,QAAQ,WAAW,IAAI,QAGpB,QAAQ,QACnB,CAkBA,OAAO,KAAK,EAAc,EAAW,EAAiB,CAC9C,QAAQ,YAAc,OACtB,aAAa,QAAQ,SAAS,EAC9B,QAAQ,UAAY,MAGxB,IAAM,EAAO,QAAQ,YAAY,EAO3B,EAAe,EAAK,UAAU,GAAK,CAAC,QAAQ,WAElD,EAAK,MAAM,QAAQ,CAAI,EAKvB,IAAM,EAAa,EAAK,MAAM;CAAI,EAC5B,EAAa,EAAM,QAAQ,EAAK,IAAS,KAAK,IAAI,EAAK,EAAK,iBAAiB,CAAI,CAAC,EAAG,CAAC,EAE5F,EAAK,SAAW,EAAK,eAAe,EAKpC,IAAM,EAAgB,KAAK,IAAI,QAAQ,UAAW,EAAa,QAAQ,SAAS,EAMhF,GAAI,EAAa,QAAQ,UAAY,QAAQ,UAAW,CACpD,IAAM,EAAiB,EAAe,QAAQ,UACxC,EAAiB,EAAI,OAAO,YAAY,EAAM,CAAE,SAAU,CAAe,CAAC,CAAC,CAAC,OAClF,EAAK,WAAkB,KAAK,IAAI,EAAM,OAAQ,KAAK,MAAM,EAAgB,EAAK,QAAQ,CAAC,CAC3F,KACI,GAAK,WAAa,EAAM,OAO5B,IAAI,EAAgB,EAAK,WAAa,EAAK,SAAW,QAAQ,UAC1D,EAAK,aAAe,IACpB,EAAgB,KAAK,IAAI,EAAe,QAAQ,YAAc,QAAQ,SAAS,GAGnF,EAAK,SAAS,CAAY,EAC1B,EAAK,UAAU,CAAa,EAE5B,IAAM,EAAK,EAAI,OAAO,gBAAgB,EAIhC,EAAK,EAAK,MAAM,EAAG,EAAG,EAAG,KAAK,EAC9B,EAAK,EAAK,MAAM,EAAG,EAAG,EAAG,MAAM,EAQrC,EAAK,KAAK,iBACN,EAAK,QAAQ,YAAa,EAAK,QAAQ,aAAc,EAAe,EAAG,MAAQ,QAAQ,UAC3F,CAAC,EACD,EAAK,KAAK,iBACN,EAAK,QAAQ,UAAa,EAAK,QAAQ,YAAc,EAAe,EAAG,OAAQ,QAAQ,UAC3F,CAAC,EAED,IAAM,EAAK,EAAK,WAAW,EAAI,EAoB/B,GAlBA,EAAK,eAAe,EAEpB,EAAa,MAAM,CAAE,EAErB,EAAK,WAAW,EAAI,EAKpB,AAEI,QAAQ,YADR,EAAM,oBAAoB,EAAM,YAAa,QAAQ,cAAc,EAChD,IAKvB,QAAQ,WAAa,GAEjB,EAAc,CAGd,EAAI,KAAK,MAAM,EAAI,CAAE,MAAO,CAAE,QAAS,GAAI,CAAE,CAAC,EAE9C,MACJ,CAEA,EAAU,KAAK,EAAI,CACf,KAAY,CAAE,QAAS,GAAI,EAC3B,GAAY,CAAE,QAAS,GAAI,EAC3B,WAAY,EACZ,WAAY,CAAC,SAAS,CAC1B,CAAC,CACL,CAOA,OAAO,MAAa,CACZ,QAAQ,YAAc,OACtB,aAAa,QAAQ,SAAS,EAC9B,QAAQ,UAAY,MAGxB,IAAM,EAAO,QAAQ,YAAY,EAC3B,EAAO,EAAK,WAAW,EAI7B,AAEI,QAAQ,YADR,EAAM,uBAAuB,EAAM,YAAa,QAAQ,cAAc,EACnD,IAEvB,QAAQ,cAAgB,KAEnB,IAIL,QAAQ,WAAa,GAErB,EAAU,KAAK,EAAI,CACf,GAAY,CAAE,QAAS,GAAI,EAC3B,WAAY,EACZ,WAAY,CAAC,SAAS,EACtB,eAAkB,CACT,QAAQ,aAGb,QAAQ,WAAa,GACrB,EAAK,WAAW,EAAK,EACrB,EAAK,cAAc,EACvB,CACJ,CAAC,EACL,CAmBA,OAAO,OAAO,EAAsB,EAAc,EAA8B,CAC5E,QAAQ,OAAO,CAAS,EAExB,IAAI,EAAU,EACV,EAAU,EAER,YAAe,GAAkB,CAC/B,QAAQ,YAAc,OAI1B,EAAU,EAAE,QACZ,EAAU,EAAE,QAEZ,QAAQ,UAAY,eAAiB,CACjC,QAAQ,aAAa,CAAM,EAG3B,QAAQ,cAAgB,EAAU,WAAW,GAAK,KAClD,QAAQ,KAAK,EAAM,EAAS,CAAO,EACnC,QAAQ,UAAY,IACxB,EAAG,GAAG,EACV,EAEM,YAAe,GAAkB,CACnC,EAAU,EAAE,QACZ,EAAU,EAAE,OAChB,EAEM,eAAmB,CACrB,QAAQ,KAAK,CACjB,EASM,gBAAoB,CACtB,QAAQ,KAAK,CACjB,EAEA,EAAM,YAAY,EAAW,YAAa,WAAW,EACrD,EAAM,YAAY,EAAW,YAAa,WAAW,EACrD,EAAM,YAAY,EAAW,WAAY,UAAU,EACnD,EAAM,YAAY,EAAW,YAAa,WAAW,EAErD,QAAQ,YAAY,IAAI,EAAU,MAAM,EAAG,CACvC,OAAM,SAAQ,YAAa,YAAa,WAAY,WACxD,CAAC,CACL,CAQA,OAAO,OAAO,EAA4B,CACtC,IAAM,EAAM,EAAU,MAAM,EACtB,EAAM,QAAQ,YAAY,IAAI,CAAE,EAEjC,IAIL,EAAM,eAAe,EAAW,YAAa,EAAI,WAAW,EAC5D,EAAM,eAAe,EAAW,YAAa,EAAI,WAAW,EAC5D,EAAM,eAAe,EAAW,WAAa,EAAI,UAAU,EAC3D,EAAM,eAAe,EAAW,YAAa,EAAI,WAAW,EAE5D,QAAQ,YAAY,OAAO,CAAE,EAC7B,QAAQ,KAAK,EACjB,CAQA,OAAe,aAAa,EAA8B,CACtD,IAAM,EAAO,QAAQ,YAAY,EAEjC,EAAK,mBACD,GAAQ,YAAc,6CAC1B,EACA,EAAK,mBACD,GAAQ,OAAS,0CACrB,EACA,EAAK,UAAU,CAAE,OAAQ,aAAa,GAAQ,QAAU,mDAAoD,CAAC,CACjH,CAoBA,OAAO,gBAAgB,EAAiB,EAAoB,CACxD,IAAM,EAAY,QAAQ,mBAAmB,IAAI,CAAO,EAClD,EAAY,QAAQ,gBAAkB,EAKtC,EAAS,EAAW,EAAS,MAAQ,EACrC,EAAS,EAAW,EAAS,MAAQ,EAE3C,QAAQ,cAAc,CAAO,EAE7B,IAAM,EAAgC,CAClC,OACA,UAAa,KACb,MAAa,EACb,MAAa,EACb,YAAa,SAAS,mBAAmB,EAAqB,CACtD,EAAI,YAAc,OAItB,EAAI,MAAQ,EAAE,QACd,EAAI,MAAQ,EAAE,QAEd,EAAI,UAAY,WAAW,SAAS,oBAA2B,CAC3D,QAAQ,cAAgB,EACxB,QAAQ,KAAK,EAAI,KAAM,EAAI,MAAO,EAAI,KAAK,EAC3C,EAAI,UAAY,IACpB,EAAG,GAAG,EACV,EACA,YAAa,SAAS,mBAAmB,EAAqB,CAC1D,EAAI,MAAQ,EAAE,QACd,EAAI,MAAQ,EAAE,OAClB,EACA,WAAY,SAAS,mBAA0B,CACvC,EAAI,YAAc,OAClB,aAAa,EAAI,SAAS,EAC1B,EAAI,UAAY,MAGhB,QAAQ,gBAAkB,IAC1B,QAAQ,cAAgB,MAG5B,QAAQ,KAAK,CACjB,EAGA,YAAa,SAAS,oBAA2B,CACzC,EAAI,YAAc,OAClB,aAAa,EAAI,SAAS,EAC1B,EAAI,UAAY,MAGpB,QAAQ,KAAK,CACjB,CACJ,EAEA,EAAI,KAAK,YAAY,EAAS,YAAa,EAAI,WAAW,EAC1D,EAAI,KAAK,YAAY,EAAS,YAAa,EAAI,WAAW,EAC1D,EAAI,KAAK,YAAY,EAAS,WAAa,EAAI,UAAU,EACzD,EAAI,KAAK,YAAY,EAAS,YAAa,EAAI,WAAW,EAE1D,QAAQ,mBAAmB,IAAI,EAAS,CAAG,EAKvC,IACA,QAAQ,cAAgB,EACxB,QAAQ,KAAK,EAAM,EAAI,MAAO,EAAI,KAAK,EAE/C,CAWA,OAAO,cAAc,EAAuB,CACxC,IAAM,EAAM,QAAQ,mBAAmB,IAAI,CAAO,EAE7C,IAIL,EAAI,KAAK,eAAe,EAAS,YAAa,EAAI,WAAW,EAC7D,EAAI,KAAK,eAAe,EAAS,YAAa,EAAI,WAAW,EAC7D,EAAI,KAAK,eAAe,EAAS,WAAa,EAAI,UAAU,EAC5D,EAAI,KAAK,eAAe,EAAS,YAAa,EAAI,WAAW,EAEzD,EAAI,YAAc,OAClB,aAAa,EAAI,SAAS,EAC1B,EAAI,UAAY,MAGpB,QAAQ,mBAAmB,OAAO,CAAO,EAErC,QAAQ,gBAAkB,IAC1B,QAAQ,cAAgB,MAEhC,CAeA,gBAAiC,CAC7B,GAAM,CAAE,UAAW,EAAI,OAAO,YAAY,GAAG,EAE7C,OAAO,KAAK,KAAK,CAAM,CAC3B,CAOA,UAAiB,CAQb,OAPA,MAAM,SAAS,EAEf,KAAK,MAAM,KAAK,QAAQ,UAAY,CAAC,EACrC,KAAK,MAAM,KAAK,QAAQ,UAAY,CAAC,EACrC,KAAK,MAAM,SAAS,KAAK,IAAI,EAAG,KAAK,SAAS,EAAI,QAAQ,SAAS,CAAC,EACpE,KAAK,MAAM,UAAU,KAAK,WAAa,KAAK,QAAQ,EAE7C,IACX,CACJ"}

package/dist/lib/VBox-D5B9ecw0.js

@@ -0,0 +1,2 @@
+import{a as e,o as t}from"./Position-B-WfZYAJ.js";import{d as n,f as r}from"./Component-BR2f0Itb.js";import{t as i}from"./BoxLayout-DgZukB5_.js";var VBox=class extends i{_defaultComponentHeight=100;getContentBaseline(){let e=this.getContainer();if(!e)return null;let t=e.getLaidOutComponents();return t.length===0?null:t[0].getBaseline()}getPreferredSize(){let n=this.getContainer();if(!n)return null;let r=n.getPerimeterSize(),i=n.getLaidOutComponents();if(this._mode===`equal`){let e=0,t=0;for(let n in i){let r=i[n].getPreferredSize();r&&(e=Math.max(e,r.width),t=Math.max(t,r.height))}return{width:e+r.left+r.right,height:i.length*(t+this._spacing)-this._spacing+r.top+r.bottom}}let a=e,o=r.top+r.bottom;for(let e in i){let n=i[e].getPreferredSize();n&&(a=t(a)?Math.min(a,n.width):Math.max(a,n.width),o+=n.height)}return a+=r.left+r.right,o+=this._spacing*(i.length-1),{width:a,height:o}}getMinSize(){let e=this.getContainer();if(!e)return null;let t=e.getPerimeterSize(),n=e.getLaidOutComponents();if(this._mode===`equal`){let e=0,r=0;for(let t in n){let i=n[t].getMinSize();i&&(e=Math.max(e,i.width),r=Math.max(r,i.height))}return{width:e+t.left+t.right,height:n.length*(r+this._spacing)-this._spacing+t.top+t.bottom}}let r=0,i=t.top+t.bottom;for(let e in n){let t=n[e].getMinSize();t&&(r=Math.max(r,t.width),i+=t.height)}return r+=t.left+t.right,i+=this._spacing*(n.length-1),{width:r,height:i}}getMaxSize(){return this.aggregateMaxSize(!1)}computeTotalMinSize(){let e=this.getContainer();if(!e)return{width:0,height:0};let t=e.getLaidOutComponents();if(t.length===0)return{width:0,height:0};let n=0;if(this._mode===`equal`){let e=0;for(let r of t){let t=r.getMinSize();t&&(n=Math.max(n,t.width),e=Math.max(e,t.height))}return{width:n,height:t.length*(e+this._spacing)-this._spacing}}let r=this._spacing*(t.length-1);for(let e of t){let t=e.getMinSize();t&&(n=Math.max(n,t.width),r+=t.height)}return{width:n,height:r}}doLayout(){let e=this.getContainer();if(!e)return;let t=e.getInnerSize();if(!t)return;let n=e.getLaidOutComponents(),r=e.getContentInsets(),i=this.getComponentSpacing(),a=this.inflateForOverflow(t);this._mode===`equal`?this.layoutEqualMode(n,t,a,r,i):this.layoutPreferredMode(n,a,r,i),this.reserveContentFrame()}layoutEqualMode(e,t,r,i,a){let o=this.computeEqualCellHeight(e,t.height,a),s=i.getLeft(),c=i.getTop();if(this.isStretching()){let t=r.width;for(let r of e)this.placeComponent(r,s,c,t,o,n.BOTH),c+=o+a;return}let l=i.getLeft(),u=r.width;for(let t of e){let e=t.getPreferredSize(),r=e?e.width:0,i=this.crossPlacement(t,l,u,r,!1);i?this.placeComponent(t,i.offset,c,i.extent,o,n.BOTH):this.placeComponent(t,s,c,r,o,n.BOTH),c+=o+a}}computeEqualCellHeight(e,t,n){let r=0,i=0;for(let t of e){let e=t.getMinSize();e&&(r=Math.max(r,e.height));let n=t.getPreferredSize();n&&(i=Math.max(i,n.height))}let a=(t-n*(e.length-1))/e.length;return a>=r?a:this.isOverflowingY()&&this._overflowSizing===`preferred`?Math.max(r,i):r}layoutPreferredMode(e,t,r,i){let{totalWeight:a,fixedPreferred:o,fixedMin:s}=this.measureFixedHeights(e,i),{remaining:c,shrinkRatio:l}=this.computeShrink(o,s,t.height,this.isOverflowingY()),u=[];for(let t of e){let e=this.getLayoutConstraints(t)?.weight??0,n=t.getPreferredSize(),r=t.getMinSize(),i=t.getMaxSize();u.push(this.resolveChildHeight(n,r,i,e,a,c,l))}let d=0,f=0;if(a===0){let n=i*(e.length-1);for(let e of u)n+=e;let a=t.height-(r.getTop()+r.getBottom());({lead:d,gap:f}=this.justifyOffsets(n,a,e.length))}let p=r.getLeft(),m=t.width-(r.getLeft()+r.getRight()),h=r.getLeft(),g=r.getTop()+d;for(let r=0;r<e.length;r+=1){let a=e[r],o=a.getPreferredSize(),s=a.getMaxSize(),c;c=!o||this.isStretching()?t.width:Math.min(o.width,t.width),s&&(c=Math.min(c,s.width));let l=o?Math.min(o.width,m):m;s&&(l=Math.min(l,s.width));let d=this.crossPlacement(a,p,m,l,!1);d?this.placeComponent(a,d.offset,g,d.extent,u[r],n.BOTH):this.placeComponent(a,h,g,c,u[r],n.BOTH),g+=u[r],g+=i+f}}measureFixedHeights(e,t){let n=0,r=t*(e.length-1),i=t*(e.length-1);for(let t of e){let e=this.getLayoutConstraints(t)?.weight??0;if(e>0)n+=e;else{let e=t.getPreferredSize(),n=t.getMinSize();r+=this.preferredChildHeight(e,n),i+=n?n.height:0}}return{totalWeight:n,fixedPreferred:r,fixedMin:i}}preferredChildHeight(e,t){let n=(e?e.height:void 0)??(t&&t.height>0?t.height:void 0)??this._defaultComponentHeight;return t?Math.max(n,t.height):n}resolveChildHeight(e,t,n,r,i,a,o){let s;if(r>0&&i>0)s=r/i*a;else{let n=this.preferredChildHeight(e,t);s=n-o*(n-(t?t.height:0))}return t&&(s=Math.max(s,t.height)),n&&(s=Math.min(s,n.height)),s}},a=r(VBox);export{a as n,VBox as t};
+//# sourceMappingURL=VBox-D5B9ecw0.js.map

package/dist/lib/VBox-D5B9ecw0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VBox-D5B9ecw0.js","names":[],"sources":["../../src/typescript/lib/layout/VBox.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { FillType } from \"~/layout/FillType.js\";\nimport { Size, UNBOUNDED, isUnbounded } from \"~/primitive/Size.js\";\nimport { Insets } from \"~/primitive/Insets.js\";\nimport { Component } from \"~/core/Component.js\";\nimport { BoxLayout, BoxLayoutOptions } from \"~/layout/BoxLayout.js\";\nimport { callable } from \"~/core/Callable.js\";\n\n/**\n * Construction-time options for {@link VBox}.\n *\n * @remarks `mode` selects the sizing strategy along the vertical axis.\n * `\"preferred\"` (the default) honours each child's preferred height and\n * supports `weight` cells. `\"equal\"` divides the container height equally\n * and ignores `weight`. `mode` is independent of `stretching` (the cross-axis\n * fill): `stretching` defaults to `false` in both modes, so `\"equal\"` divides\n * the height but leaves children at their preferred width unless\n * `stretching: true` is passed.\n *\n * @category Layouts\n */\nexport interface VBoxOptions extends BoxLayoutOptions {}\n\n/**\n * A layout manager that places children in a single vertical column. The\n * `mode` option selects between preferred-height sequencing (with weight-cell\n * support) and equal-height division of the container.\n *\n * @category Layouts\n */\nclass VBox extends BoxLayout {\n\n    private _defaultComponentHeight: number = 100;\n\n    /**\n     * Returns the column's baseline — the first laid-out child's baseline,\n     * measured from the container's content-top — so a baseline-aware parent\n     * aligns this VBox container by its first row's text baseline rather than\n     * auto-centring the whole container.\n     *\n     * @returns The first child's baseline offset in pixels, or `null` when there\n     * is no container, no laid-out children, or the first child reports no\n     * baseline of its own.\n     *\n     * @remarks Forwards the **first** child's baseline verbatim — unlike\n     * {@link HBox}, which takes the maximum baseline across the row's children.\n     * A column has a single well-defined first row, so forwarding it (including\n     * a `null` when that first row is graphical) is the most predictable\n     * contract. The first child stacks at the container's content-top in every\n     * mode, so its own baseline is already content-relative — `Component`'s\n     * `getBaseline` then adds the container's chrome. Unlike `HBox`, this is not\n     * disabled while stretching: VBox `stretching` fills the cross (width) axis\n     * and leaves each child's height and intrinsic baseline untouched.\n     */\n    getContentBaseline(): number | null {\n        const container = this.getContainer();\n        if (!container) {\n            return null;\n        }\n\n        const components = container.getLaidOutComponents();\n        if (components.length === 0) {\n            return null;\n        }\n\n        return components[0].getBaseline();\n    }\n\n    /**\n     * Returns the preferred size. In `\"preferred\"` mode this is the widest\n     * child width and the sum of child heights plus spacing. In `\"equal\"`\n     * mode height is `count * (maxChildHeight + spacing) - spacing`.\n     *\n     * @returns The preferred `{width, height}`, or `null` if no container is attached.\n     */\n    getPreferredSize(): Size | null {\n        let container = this.getContainer();\n        if (!container) {\n            return null;\n        }\n\n        let perimeterSize = container.getPerimeterSize();\n        let components = container.getLaidOutComponents();\n\n        if (this._mode === \"equal\") {\n            let innerWidth = 0;\n            let innerHeight = 0;\n\n            for (let idx in components) {\n                let component = components[idx];\n                let size = component.getPreferredSize();\n\n                if (size) {\n                    innerWidth  = Math.max(innerWidth,  size.width);\n                    innerHeight = Math.max(innerHeight, size.height);\n                }\n            }\n\n            const width  = innerWidth + perimeterSize.left + perimeterSize.right;\n            const height = components.length * (innerHeight + this._spacing) - this._spacing\n                         + perimeterSize.top + perimeterSize.bottom;\n\n            return { width, height };\n        }\n\n        let width = UNBOUNDED;\n        let height = perimeterSize.top + perimeterSize.bottom;\n\n        for (let idx in components) {\n            let component = components[idx];\n            let size = component.getPreferredSize();\n\n            if (size) {\n                width = isUnbounded(width) ? Math.min(width, size.width) : Math.max(width, size.width);\n                height += size.height;\n            }\n        }\n\n        width += perimeterSize.left + perimeterSize.right;\n        height += this._spacing * (components.length - 1);\n\n        return {\n            width: width,\n            height: height\n        };\n    }\n\n    /**\n     * Returns the minimum size. In `\"preferred\"` mode this is the widest\n     * child minimum width and the sum of child minimum heights plus\n     * spacing. In `\"equal\"` mode height is\n     * `count * (maxChildMinHeight + spacing) - spacing`.\n     *\n     * @returns The minimum `{width, height}`, or `null` if no container is attached.\n     */\n    getMinSize(): Size | null {\n        let container = this.getContainer();\n        if (!container) {\n            return null;\n        }\n\n        let perimeterSize = container.getPerimeterSize();\n        let components = container.getLaidOutComponents();\n\n        if (this._mode === \"equal\") {\n            let innerWidth = 0;\n            let innerHeight = 0;\n\n            for (let idx in components) {\n                let component = components[idx];\n                let size = component.getMinSize();\n\n                if (size) {\n                    innerWidth  = Math.max(innerWidth,  size.width);\n                    innerHeight = Math.max(innerHeight, size.height);\n                }\n            }\n\n            const width  = innerWidth + perimeterSize.left + perimeterSize.right;\n            const height = components.length * (innerHeight + this._spacing) - this._spacing\n                         + perimeterSize.top + perimeterSize.bottom;\n\n            return { width, height };\n        }\n\n        let width = 0;\n        let height = perimeterSize.top + perimeterSize.bottom;\n\n        for (let idx in components) {\n            let component = components[idx];\n            let size = component.getMinSize();\n\n            if (size) {\n                width = Math.max(width, size.width);\n                height += size.height;\n            }\n        }\n\n        width += perimeterSize.left + perimeterSize.right;\n        height += this._spacing * (components.length - 1);\n\n        return {\n            width: width,\n            height: height\n        };\n    }\n\n    /**\n     * Returns the maximum size the column can usefully occupy. Along the main\n     * axis (height) it sums the children's *maximum* heights plus spacing; in\n     * `\"equal\"` mode it is `count * maxChildMaxHeight` plus spacing, since every\n     * cell shares the tallest child's allowance. The cross axis (width) takes\n     * the *largest* child maximum — the widest a child permits the column to\n     * grow to. A child whose maximum is `null` or at the unbounded sentinel\n     * makes that axis unbounded.\n     *\n     * @returns The maximum `{width, height}`, or `null` if no container is attached.\n     */\n    getMaxSize(): Size | null {\n        return this.aggregateMaxSize(false);\n    }\n\n    /**\n     * Computes the children's combined minSize along this manager's geometry.\n     * In `\"preferred\"` mode height is the sum of per-child `minSize.height`\n     * plus spacing. In `\"equal\"` mode height is\n     * `count * maxChildMinHeight + spacing*(n-1)` (VBox distributes height\n     * equally so the per-cell floor is the max of every child's min height).\n     * Width in both modes is the max per-child `minSize.width`. Used by\n     * `doLayout` to inflate the working size when the host has opted into\n     * `setOverflowing` on the corresponding axis.\n     *\n     * @returns The total min-size; `{ width: 0, height: 0 }` when the\n     *   container is absent or has no children.\n     */\n    protected computeTotalMinSize(): Size {\n        const container = this.getContainer();\n        if (!container) {\n            return { width: 0, height: 0 };\n        }\n\n        const components = container.getLaidOutComponents();\n        if (components.length === 0) {\n            return { width: 0, height: 0 };\n        }\n\n        let width = 0;\n\n        if (this._mode === \"equal\") {\n            let maxHeight = 0;\n\n            for (const component of components) {\n                const min = component.getMinSize();\n                if (min) {\n                    width     = Math.max(width,     min.width);\n                    maxHeight = Math.max(maxHeight, min.height);\n                }\n            }\n\n            return {\n                width,\n                height: components.length * (maxHeight + this._spacing) - this._spacing,\n            };\n        }\n\n        let height = this._spacing * (components.length - 1);\n\n        for (const component of components) {\n            const min = component.getMinSize();\n            if (min) {\n                width   = Math.max(width, min.width);\n                height += min.height;\n            }\n        }\n\n        return { width, height };\n    }\n\n    /**\n     * Lays out the children top-to-bottom, dispatching to `layoutEqualMode` or\n     * `layoutPreferredMode` per the sizing mode after inflating the working\n     * size for any scroll-enabled axis.\n     */\n    doLayout(): void {\n        const container = this.getContainer();\n        if (!container) {\n            return;\n        }\n\n        const innerSize = container.getInnerSize();\n        if (!innerSize) {\n            return;\n        }\n\n        const components      = container.getLaidOutComponents();\n        const containerInsets = container.getContentInsets();\n        const spacing         = this.getComponentSpacing();\n\n        // Universal scroll: when the host has opted into per-axis overflow, lay\n        // out against the children's combined minSize so trailing children land\n        // past the viewport and the host's CSS `overflow: auto` scrolls.\n        // `innerSize` stays the real viewport for equal mode's overflow test.\n        const containerSize = this.inflateForOverflow(innerSize);\n\n        if (this._mode === \"equal\") {\n            this.layoutEqualMode(components, innerSize, containerSize, containerInsets, spacing);\n        } else {\n            this.layoutPreferredMode(components, containerSize, containerInsets, spacing);\n        }\n\n        this.reserveContentFrame();\n    }\n\n    /**\n     * Places children in equal-height cells stacked top-to-bottom. Every cell\n     * takes the same height (see {@link VBox.computeEqualCellHeight}); when\n     * stretching, cells fill the container width, otherwise children keep their\n     * preferred width and are left-aligned within the column.\n     *\n     * @param components - The children to place, in order.\n     * @param innerSize - The host's real inner size (pre-inflation), used to\n     *   measure the equal share against the true viewport.\n     * @param containerSize - The working size, possibly inflated for overflow.\n     * @param insets - The container's content insets.\n     * @param spacing - Inter-child spacing in pixels.\n     */\n    private layoutEqualMode(components: Component[], innerSize: Size, containerSize: Size, insets: Insets, spacing: number): void {\n        const cellHeight = this.computeEqualCellHeight(components, innerSize.height, spacing);\n\n        const x = insets.getLeft();\n        let y = insets.getTop();\n\n        if (this.isStretching()) {\n            const cellWidth = containerSize.width;\n\n            for (const component of components) {\n                this.placeComponent(component, x, y, cellWidth, cellHeight, FillType.BOTH);\n\n                y += cellHeight + spacing;\n            }\n\n            return;\n        }\n\n        // Match the equal-stretch band exactly: the stretch branch fills\n        // containerSize.width from insets.left with no right-inset subtraction,\n        // so an EAST/fill align-self child reaches the same trailing edge.\n        const crossLead   = insets.getLeft();\n        const crossExtent = containerSize.width;\n\n        for (const component of components) {\n            const size  = component.getPreferredSize();\n            const width = size ? size.width : 0;\n\n            const cross = this.crossPlacement(component, crossLead, crossExtent, width, false);\n\n            if (cross) {\n                this.placeComponent(component, cross.offset, y, cross.extent, cellHeight, FillType.BOTH);\n            } else {\n                this.placeComponent(component, x, y, width, cellHeight, FillType.BOTH);\n            }\n\n            y += cellHeight + spacing;\n        }\n    }\n\n    /**\n     * Computes the shared cell height for equal mode: the equal share of the\n     * inner height, floored at the tallest child's min height.\n     *\n     * @param components - The children sharing the column.\n     * @param innerHeight - The host's real inner height (pre-inflation).\n     * @param spacing - Inter-child spacing in pixels.\n     * @returns The height every equal-mode cell receives.\n     *\n     * @remarks Three cases drive the floor: (1) the share clears the tallest\n     * child's min height → the column fits, divide equally; (2) the share is\n     * below the min floor, the host scrolls on this axis, and `overflowSizing`\n     * is `\"preferred\"` → every cell takes the tallest child's preferred height\n     * so cells regain preferred size instead of sticking at min while\n     * scrolling; (3) otherwise → clamp to the min floor (a non-scrolling host's\n     * `overflow: hidden` clips the surplus).\n     */\n    private computeEqualCellHeight(components: Component[], innerHeight: number, spacing: number): number {\n        let maxChildMinHeight = 0;\n        let maxChildPreferredHeight = 0;\n\n        for (const component of components) {\n            const min = component.getMinSize();\n            if (min) {\n                maxChildMinHeight = Math.max(maxChildMinHeight, min.height);\n            }\n\n            const pref = component.getPreferredSize();\n            if (pref) {\n                maxChildPreferredHeight = Math.max(maxChildPreferredHeight, pref.height);\n            }\n        }\n\n        const equalShare = (innerHeight - spacing * (components.length - 1)) / components.length;\n\n        if (equalShare >= maxChildMinHeight) {\n            return equalShare;\n        }\n\n        if (this.isOverflowingY() && this._overflowSizing === \"preferred\") {\n            return Math.max(maxChildMinHeight, maxChildPreferredHeight);\n        }\n\n        return maxChildMinHeight;\n    }\n\n    /**\n     * Places children at their preferred heights stacked top-to-bottom. Weight\n     * cells split the space left after the non-weighted children; when the\n     * column overflows, the non-weighted children shrink proportionally toward\n     * their min heights. Children keep their preferred width, or fill the\n     * container width when stretching.\n     *\n     * @param components - The children to place, in order.\n     * @param containerSize - The working size, possibly inflated for overflow.\n     * @param insets - The container's content insets.\n     * @param spacing - Inter-child spacing in pixels.\n     */\n    private layoutPreferredMode(components: Component[], containerSize: Size, insets: Insets, spacing: number): void {\n        const { totalWeight, fixedPreferred, fixedMin } = this.measureFixedHeights(components, spacing);\n\n        const { remaining: remainingHeight, shrinkRatio } = this.computeShrink(\n            fixedPreferred,\n            fixedMin,\n            containerSize.height,\n            this.isOverflowingY()\n        );\n\n        // Pre-pass: resolve each child's height into an array so the trailing\n        // slack can be measured before placement (mirrors HBox's widths[]).\n        const heights: number[] = [];\n\n        for (const component of components) {\n            const weight  = this.getLayoutConstraints(component)?.weight ?? 0;\n            const size    = component.getPreferredSize();\n            const minSize = component.getMinSize();\n            const maxSize = component.getMaxSize();\n\n            heights.push(this.resolveChildHeight(size, minSize, maxSize, weight, totalWeight, remainingHeight, shrinkRatio));\n        }\n\n        // Sum the placed main extents to find the trailing slack, then ask the\n        // shared helper how to distribute it. Weight cells already consume all\n        // slack, so justify is a no-op when any are present.\n        let lead = 0;\n        let gap  = 0;\n\n        if (totalWeight === 0) {\n            let contentHeight = spacing * (components.length - 1);\n\n            for (const h of heights) {\n                contentHeight += h;\n            }\n\n            const innerHeight = containerSize.height - (insets.getTop() + insets.getBottom());\n\n            ({ lead, gap } = this.justifyOffsets(contentHeight, innerHeight, components.length));\n        }\n\n        // Cross band for per-child align-self: the horizontal band trimmed by\n        // both insets. The default path keeps reading containerSize.width\n        // (un-trimmed) to stay byte-identical with today's body.\n        const crossLead   = insets.getLeft();\n        const crossExtent = containerSize.width - (insets.getLeft() + insets.getRight());\n\n        const x = insets.getLeft();\n        let y = insets.getTop() + lead;\n\n        for (let idx = 0; idx < components.length; idx += 1) {\n            const component = components[idx];\n            const size    = component.getPreferredSize();\n            const maxSize = component.getMaxSize();\n\n            // Cross-axis (width): give the child the column's available width —\n            // the full inner width when stretching or sizeless, otherwise its\n            // preferred width capped to the column. Cap to the child's maximum,\n            // but do NOT floor to its minimum: enforcing the minimum here would\n            // dogmatically inflate a child back up to its content size even when\n            // the column is narrower, defeating a scrolling/clipping child. The\n            // child's own setWidth → clampWidth applies its minimum (its content\n            // minimum for a general component, or nothing for a Panel, which fits\n            // its allocation and scrolls). When the host opts into horizontal\n            // scroll, `containerSize` is already inflated to the content extent\n            // upstream, so `min(pref, containerSize)` still yields the full width\n            // without a floor here.\n            let defaultWidth: number;\n\n            if (!size || this.isStretching()) {\n                defaultWidth = containerSize.width;\n            } else {\n                defaultWidth = Math.min(size.width, containerSize.width);\n            }\n\n            if (maxSize) {\n                defaultWidth = Math.min(defaultWidth, maxSize.width);\n            }\n\n            // Align-self sizes from the child's *preferred* width (capped to the\n            // band + max), independent of global stretching, so an anchored child\n            // shrinks-and-anchors even when the column is stretching.\n            let naturalWidth = size ? Math.min(size.width, crossExtent) : crossExtent;\n\n            if (maxSize) {\n                naturalWidth = Math.min(naturalWidth, maxSize.width);\n            }\n\n            const cross = this.crossPlacement(component, crossLead, crossExtent, naturalWidth, false);\n\n            if (cross) {\n                this.placeComponent(component, cross.offset, y, cross.extent, heights[idx], FillType.BOTH);\n            } else {\n                this.placeComponent(component, x, y, defaultWidth, heights[idx], FillType.BOTH);\n            }\n\n            // Advance by the resolved height, not getHeight(): the gap is\n            // measured against the same extent contentHeight summed, so a\n            // placeComponent clamp must not skew the trailing edge.\n            y += heights[idx];\n            y += spacing + gap;\n        }\n    }\n\n    /**\n     * Sums the non-weighted children's preferred and minimum heights (each\n     * including inter-child spacing) and the total weight of the weight cells.\n     *\n     * @param components - The children sharing the column.\n     * @param spacing - Inter-child spacing in pixels.\n     * @returns `totalWeight` of the weight cells, plus the `fixedPreferred` and\n     *   `fixedMin` height totals of the non-weighted children.\n     */\n    private measureFixedHeights(components: Component[], spacing: number): { totalWeight: number; fixedPreferred: number; fixedMin: number } {\n        let totalWeight = 0;\n        let fixedPreferred = spacing * (components.length - 1);\n        let fixedMin       = spacing * (components.length - 1);\n\n        for (const component of components) {\n            const weight = this.getLayoutConstraints(component)?.weight ?? 0;\n\n            if (weight > 0) {\n                totalWeight += weight;\n            } else {\n                const size    = component.getPreferredSize();\n                const minSize = component.getMinSize();\n\n                fixedPreferred += this.preferredChildHeight(size, minSize);\n                fixedMin       += minSize ? minSize.height : 0;\n            }\n        }\n\n        return { totalWeight, fixedPreferred, fixedMin };\n    }\n\n    /**\n     * Resolves a non-weighted child's preferred height, falling back through min\n     * height to `_defaultComponentHeight`.\n     *\n     * @param size - The child's preferred size, or `null`.\n     * @param minSize - The child's minimum size, or `null`.\n     * @returns The height the child contributes before shrinking.\n     *\n     * @remarks Nullish-coalesce, not `||`: a component with an explicit\n     * preferred height of 0 must contribute 0, not fall through to\n     * `_defaultComponentHeight`. The `minSize.height > 0` guard prevents\n     * `LayoutManager._defaultMinSize = {0,0}` from short-circuiting the chain\n     * into a 0 height (which would land a layout-managed Table on a 0 height\n     * even though no preferred size was set).\n     *\n     * The result is floored at the child's own min height: a child placed at\n     * `max(preferred, min)` (see {@link VBox.resolveChildHeight}) must reserve\n     * that same height in the fixed total, or a child reporting `preferred < min`\n     * (a `min ≤ preferred` invariant violation) would be under-reserved and push\n     * the weighted cells out, overflowing the column.\n     */\n    private preferredChildHeight(size: Size | null, minSize: Size | null): number {\n        const preferred = (size ? size.height : undefined)\n            ?? (minSize && minSize.height > 0 ? minSize.height : undefined)\n            ?? this._defaultComponentHeight;\n\n        return minSize ? Math.max(preferred, minSize.height) : preferred;\n    }\n\n    /**\n     * Resolves a child's final height within the column, clamped to its\n     * min/max. Weight cells take a share of `remainingHeight`; non-weighted\n     * children take their preferred height reduced by the shrink ratio toward\n     * their min height.\n     *\n     * @param size - The child's preferred size, or `null`.\n     * @param minSize - The child's minimum size, or `null`.\n     * @param maxSize - The child's maximum size, or `null`.\n     * @param weight - The child's weight constraint (0 when non-weighted).\n     * @param totalWeight - The summed weight of all weight cells.\n     * @param remainingHeight - The space available to weight cells.\n     * @param shrinkRatio - How far (0–1) non-weighted children shrink to min.\n     * @returns The child's height.\n     */\n    private resolveChildHeight(size: Size | null, minSize: Size | null, maxSize: Size | null, weight: number, totalWeight: number, remainingHeight: number, shrinkRatio: number): number {\n        let height: number;\n\n        if (weight > 0 && totalWeight > 0) {\n            height = (weight / totalWeight) * remainingHeight;\n        } else {\n            const pref = this.preferredChildHeight(size, minSize);\n            const min  = minSize ? minSize.height : 0;\n\n            height = pref - shrinkRatio * (pref - min);\n        }\n\n        if (minSize) {\n            height = Math.max(height, minSize.height);\n        }\n\n        if (maxSize) {\n            height = Math.min(height, maxSize.height);\n        }\n\n        return height;\n    }\n}\n\nconst VBoxCallable = callable(VBox);\ntype VBoxCallable = VBox;\nexport {\n    VBox         as _VBox,\n    VBoxCallable as VBox\n};\n"],"mappings":"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"}

package/dist/lib/Validator-Du8PqS5i.js

@@ -0,0 +1,2 @@
+function applyRule(e,t){switch(e.type){case`required`:if(t==null||typeof t==`string`&&t.trim()===``)return{valid:!1,message:e.message??`This field is required.`};break;case`minLength`:if((typeof t==`string`?t:String(t??``)).length<e.min)return{valid:!1,message:e.message??`Minimum length is ${e.min} characters.`};break;case`maxLength`:if((typeof t==`string`?t:String(t??``)).length>e.max)return{valid:!1,message:e.message??`Maximum length is ${e.max} characters.`};break;case`min`:{let n=Number(t);if(isNaN(n)||n<e.min)return{valid:!1,message:e.message??`Value must be at least ${e.min}.`};break}case`max`:{let n=Number(t);if(isNaN(n)||n>e.max)return{valid:!1,message:e.message??`Value must be at most ${e.max}.`};break}case`regex`:{let n=typeof t==`string`?t:String(t??``);if(!e.pattern.test(n))return{valid:!1,message:e.message??`Value does not match the required format.`};break}case`custom`:if(!e.predicate(t))return{valid:!1,message:e.message??`Invalid value.`};break}return{valid:!0,message:``}}export{applyRule as t};
+//# sourceMappingURL=Validator-Du8PqS5i.js.map

package/dist/lib/Validator-Du8PqS5i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator-Du8PqS5i.js","names":[],"sources":["../../src/typescript/lib/validation/Validator.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { ValidationRule } from '~/validation/ValidationRule.js';\nimport { FieldValidationResult } from '~/validation/ValidationResult.js';\n\n/**\n * Evaluates a single {@link ValidationRule} against a field value.\n *\n * This is a stateless pure function — it has no dependency on DOM or components\n * and can be tested independently.\n *\n * @param rule - The rule to evaluate.\n * @param value - The current field value.\n * @returns A {@link FieldValidationResult} with `valid` and `message`.\n */\nexport function applyRule(rule: ValidationRule, value: unknown): FieldValidationResult {\n    switch (rule.type) {\n        case 'required': {\n            const empty = value === null\n                || value === undefined\n                || (typeof value === 'string' && value.trim() === '');\n            if (empty) {\n                return { valid: false, message: rule.message ?? 'This field is required.' };\n            }\n\n            break;\n        }\n\n        case 'minLength': {\n            const str = typeof value === 'string' ? value : String(value ?? '');\n\n            if (str.length < rule.min) {\n                return {\n                    valid  : false,\n                    message: rule.message ?? `Minimum length is ${rule.min} characters.`,\n                };\n            }\n\n            break;\n        }\n\n        case 'maxLength': {\n            const str = typeof value === 'string' ? value : String(value ?? '');\n\n            if (str.length > rule.max) {\n                return {\n                    valid  : false,\n                    message: rule.message ?? `Maximum length is ${rule.max} characters.`,\n                };\n            }\n\n            break;\n        }\n\n        case 'min': {\n            const num = Number(value);\n\n            if (isNaN(num) || num < rule.min) {\n                return {\n                    valid  : false,\n                    message: rule.message ?? `Value must be at least ${rule.min}.`,\n                };\n            }\n\n            break;\n        }\n\n        case 'max': {\n            const num = Number(value);\n\n            if (isNaN(num) || num > rule.max) {\n                return {\n                    valid  : false,\n                    message: rule.message ?? `Value must be at most ${rule.max}.`,\n                };\n            }\n\n            break;\n        }\n\n        case 'regex': {\n            const str = typeof value === 'string' ? value : String(value ?? '');\n\n            if (!rule.pattern.test(str)) {\n                return {\n                    valid  : false,\n                    message: rule.message ?? 'Value does not match the required format.',\n                };\n            }\n\n            break;\n        }\n\n        case 'custom': {\n            if (!rule.predicate(value)) {\n                return { valid: false, message: rule.message ?? 'Invalid value.' };\n            }\n\n            break;\n        }\n    }\n\n    return { valid: true, message: '' };\n}\n"],"mappings":"AAeA,SAAgB,UAAU,EAAsB,EAAuC,CACnF,OAAQ,EAAK,KAAb,CACI,IAAK,WAID,GAHc,GAAU,MAEhB,OAAO,GAAU,UAAY,EAAM,KAAK,IAAM,GAElD,MAAO,CAAE,MAAO,GAAO,QAAS,EAAK,SAAW,yBAA0B,EAG9E,MAGJ,IAAK,YAGD,IAFY,OAAO,GAAU,SAAW,EAAQ,OAAO,GAAS,EAAE,EAAA,CAE1D,OAAS,EAAK,IAClB,MAAO,CACH,MAAS,GACT,QAAS,EAAK,SAAW,qBAAqB,EAAK,IAAI,aAC3D,EAGJ,MAGJ,IAAK,YAGD,IAFY,OAAO,GAAU,SAAW,EAAQ,OAAO,GAAS,EAAE,EAAA,CAE1D,OAAS,EAAK,IAClB,MAAO,CACH,MAAS,GACT,QAAS,EAAK,SAAW,qBAAqB,EAAK,IAAI,aAC3D,EAGJ,MAGJ,IAAK,MAAO,CACR,IAAM,EAAM,OAAO,CAAK,EAExB,GAAI,MAAM,CAAG,GAAK,EAAM,EAAK,IACzB,MAAO,CACH,MAAS,GACT,QAAS,EAAK,SAAW,0BAA0B,EAAK,IAAI,EAChE,EAGJ,KACJ,CAEA,IAAK,MAAO,CACR,IAAM,EAAM,OAAO,CAAK,EAExB,GAAI,MAAM,CAAG,GAAK,EAAM,EAAK,IACzB,MAAO,CACH,MAAS,GACT,QAAS,EAAK,SAAW,yBAAyB,EAAK,IAAI,EAC/D,EAGJ,KACJ,CAEA,IAAK,QAAS,CACV,IAAM,EAAM,OAAO,GAAU,SAAW,EAAQ,OAAO,GAAS,EAAE,EAElE,GAAI,CAAC,EAAK,QAAQ,KAAK,CAAG,EACtB,MAAO,CACH,MAAS,GACT,QAAS,EAAK,SAAW,2CAC7B,EAGJ,KACJ,CAEA,IAAK,SACD,GAAI,CAAC,EAAK,UAAU,CAAK,EACrB,MAAO,CAAE,MAAO,GAAO,QAAS,EAAK,SAAW,gBAAiB,EAGrE,KAER,CAEA,MAAO,CAAE,MAAO,GAAM,QAAS,EAAG,CACtC"}

package/dist/lib/VirtualRowView-Con9SWiU.js

@@ -0,0 +1,2 @@
+import{u as e}from"./Position-B-WfZYAJ.js";import{t}from"./Component-BR2f0Itb.js";import{t as n}from"./VirtualScroller-BPDmO1ir.js";var r=2,VirtualRowView=class extends t{_rowPool=[];_boundIndices=[];_rowGeom=[];_rowDisplayed=[];_scroller=null;initScroller(e){this._scroller=new n(this,e,()=>this.onScrollerTick());for(let e of this._scroller.ownedHandles())this.trackHandle(e)}onScrollerTick(){this.renderWindow()}onPoolRowAdded(){}setScrollX(e){return this._scroller?.resetWheelEase(),this._scroller?.setScrollX(e),this}setScrollY(e){return this._scroller?.resetWheelEase(),this._scroller?.setScrollY(e),this}computeVisibleWindow(e,t,n){let i=this.getRowHeight(),a=Math.max(0,Math.floor(e/i)-r),o=Math.min(n-1,Math.ceil((e+t)/i)+r);return{firstRow:a,lastRow:o,windowSize:o-a+1>0?o-a+1:0}}computePoolTarget(e,t,n){return Math.min(n,Math.max(e,Math.ceil(t/this.getRowHeight())+2*r+2))}computePageSize(){let e=this.getRowHeight();return Math.max(1,Math.floor((this.getHeight()||e)/e))}growRowPool(t){if(!this._scroller||this._rowPool.length>=t)return;let n=this._scroller.getRowsContainer(),r=e.sink.createDocumentFragment();for(;this._rowPool.length<t;){let t=this.createPoolRow(),n=t.getElement(!0);e.sink.appendChild(r,n),t.setY(0),t.setWillChange(`transform`),this._rowPool.push(t),this._boundIndices.push(-1),this._rowGeom.push(null),this._rowDisplayed.push(!1),this.onPoolRowAdded()}e.sink.appendChild(n,r),e.sink.release(r)}positionRow(e,t,n){let r=this._rowPool[e],i=this.getRowHeight(),a=this._rowGeom[e],o=!a||a.ty!==t||a.w!==n||a.h!==i;return o&&(r.setAutoCommitStyle(!1),r.setX(0),r.setTranslate(0,t),r.setWidth(n),r.setHeight(i),r.setAutoCommitStyle(!0),this._rowGeom[e]={ty:t,w:n,h:i}),this._rowDisplayed[e]||(r.setDisplayed(!0),this._rowDisplayed[e]=!0),o}hideExcessPoolRows(e){for(let t=e;t<this._rowPool.length;t++)this._rowDisplayed[t]&&(this._rowPool[t].setDisplayed(!1),this._rowDisplayed[t]=!1),this._boundIndices[t]=-1,this._rowGeom[t]=null}invalidateGeom(){for(let e=0;e<this._rowGeom.length;e++)this._rowGeom[e]=null}scrollRowIntoView(e){if(e<0||!this._scroller)return;let t=this.getRowHeight(),n=e*t,r=n+t,i=this._scroller.getScrollY(),a=this.getHeight(),o=i+a,s=i;n<i?s=n:r>o&&(s=r-a),s!==i&&this.setScrollY(s)}};export{VirtualRowView as t};
+//# sourceMappingURL=VirtualRowView-Con9SWiU.js.map

package/dist/lib/VirtualRowView-Con9SWiU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualRowView-Con9SWiU.js","names":[],"sources":["../../src/typescript/lib/component/shared/VirtualRowView.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Component, ComponentOptions } from \"~/core/Component.js\";\nimport { DOM } from \"~/core/DOM.js\";\nimport type { Handle } from \"~/core/DOM.js\";\nimport { VirtualScroller } from \"~/component/container/VirtualScroller.js\";\n\n/** Number of off-screen rows to render above and below the visible viewport. */\nconst SCROLL_BUFFER = 2;\n\n/**\n * Shared transform-windowed virtual-scroll base for the data views —\n * `table/Body` and `tree/Tree` are its only two subclasses. It owns the\n * recycled row pool (`_rowPool` and the parallel `_boundIndices` / `_rowGeom` /\n * `_rowDisplayed` bookkeeping arrays), the {@link VirtualScroller} wiring, and\n * the window / pool-growth / geometry reconciliation primitives each subclass's\n * render pass composes.\n *\n * Only two things genuinely diverge between the two consumers, so only those\n * are hooks:\n *\n * - **Row height** — `Body` derives it live from the theme line box; `Tree`\n *   uses a fixed constant. Read through {@link getRowHeight} on every call so a\n *   live theme change is honoured.\n * - **Row construction** — the pool-row scaffolding (fragment batching, `setY(0)`\n *   pin, `will-change` promotion, parallel-array bookkeeping) is identical; only\n *   the row object each subclass builds differs. {@link createPoolRow} returns a\n *   fully-constructed, un-appended row and the base owns the rest.\n *\n * The per-frame render pass itself ({@link renderWindow}) stays subclass-specific\n * because the content-width derivation genuinely diverges; the base exposes the\n * shared primitives it calls ({@link computeVisibleWindow},\n * {@link computePoolTarget}, {@link growRowPool}, {@link positionRow},\n * {@link hideExcessPoolRows}).\n *\n * @typeParam TRow - The concrete pooled row component type.\n * @typeParam TOptions - The subclass's options bag.\n *\n * @internal Not barrel-exported; the two subclasses are the only consumers.\n */\nabstract class VirtualRowView<\n    TRow extends Component,\n    TOptions extends ComponentOptions = ComponentOptions,\n> extends Component<TOptions> {\n\n    protected _rowPool      : TRow[]                                              = [];\n    protected _boundIndices : number[]                                           = [];\n    protected _rowGeom      : Array<{ ty: number, w: number, h: number } | null> = [];\n    protected _rowDisplayed : boolean[]                                          = [];\n    protected _scroller     : VirtualScroller | null                             = null;\n\n    /**\n     * Returns the height in pixels of a single row. Read on every window /\n     * geometry calculation, so a subclass that recomputes it (e.g. on a theme\n     * change) reflects the new value immediately.\n     */\n    protected abstract getRowHeight(): number;\n\n    /**\n     * Constructs one pool row, fully wired but not yet appended to the\n     * rows container — the base's {@link growRowPool} owns the append, the\n     * `setY(0)` pin, the `will-change` promotion, and the parallel-array\n     * bookkeeping.\n     */\n    protected abstract createPoolRow(): TRow;\n\n    /**\n     * Recomputes and reconciles the visible row window against the current\n     * scroll position and dataset. Subclass-specific because the content-width\n     * derivation diverges; both implementations compose the shared primitives\n     * on this base.\n     */\n    protected abstract renderWindow(): void;\n\n    /**\n     * Constructs the {@link VirtualScroller} for this view and tracks its\n     * container handles so they are released with the component. The scroller's\n     * onScroll hook is routed through {@link onScrollerTick}.\n     *\n     * @param element - This view's initialised element handle.\n     */\n    protected initScroller(element: Handle): void {\n        this._scroller = new VirtualScroller(this, element, () => this.onScrollerTick());\n\n        // Track the scroller's created container handles so they are released\n        // with this view (on destructor or GC); the scroller is not a Component.\n        for (const handle of this._scroller.ownedHandles()) {\n            this.trackHandle(handle);\n        }\n    }\n\n    /**\n     * Invoked on every scroller tick. Default behaviour re-renders the window;\n     * `Body` overrides it to additionally emit its scroll events.\n     */\n    protected onScrollerTick(): void {\n        this.renderWindow();\n    }\n\n    /**\n     * Hook invoked once per pool slot added by {@link growRowPool}, after the\n     * base parallel arrays have been extended. Default is a no-op; `Body`\n     * overrides it to extend its own `_cellGeom` array in lockstep.\n     */\n    protected onPoolRowAdded(): void {\n        // Default no-op; subclasses that own extra parallel arrays override.\n    }\n\n    /**\n     * Sets the JS-controlled horizontal scroll position. Delegates to the\n     * underlying {@link VirtualScroller}.\n     *\n     * @param x - The new scroll position in pixels.\n     */\n    setScrollX(x: number): this {\n        this._scroller?.resetWheelEase();\n        this._scroller?.setScrollX(x);\n\n        return this;\n    }\n\n    /**\n     * Sets the JS-controlled vertical scroll position. Delegates to the\n     * underlying {@link VirtualScroller}.\n     *\n     * @param y - The new scroll position in pixels.\n     */\n    setScrollY(y: number): this {\n        this._scroller?.resetWheelEase();\n        this._scroller?.setScrollY(y);\n\n        return this;\n    }\n\n    /**\n     * Computes the `[firstRow, lastRow]` data-index window visible in the\n     * current viewport, padded by `SCROLL_BUFFER` on each side and clamped to\n     * the dataset bounds.\n     *\n     * @param scrollY - The current scroll offset in pixels.\n     * @param visibleHeight - The viewport height in pixels.\n     * @param totalRows - The total number of rows in the dataset.\n     * @returns The `firstRow` / `lastRow` data indices and the number of rows in the window.\n     */\n    protected computeVisibleWindow(scrollY: number, visibleHeight: number, totalRows: number): { firstRow: number, lastRow: number, windowSize: number } {\n        const rowHeight = this.getRowHeight();\n        const firstRow  = Math.max(0, Math.floor(scrollY / rowHeight) - SCROLL_BUFFER);\n        const lastRow   = Math.min(\n            totalRows - 1,\n            Math.ceil((scrollY + visibleHeight) / rowHeight) + SCROLL_BUFFER\n        );\n        const windowSize = lastRow - firstRow + 1 > 0 ? lastRow - firstRow + 1 : 0;\n\n        return { firstRow, lastRow, windowSize };\n    }\n\n    /**\n     * Computes the row-pool target size: the max possible window for the\n     * current viewport, not just the current windowSize. windowSize shrinks\n     * near the top/bottom edges of the dataset because firstRow clamps to 0\n     * (and lastRow to totalRows-1); growing only to windowSize would force\n     * regrowth mid-scroll once the user passes a viewport-edge boundary. Pre-\n     * growing pays the per-row first-layout cost once.\n     *\n     * @param windowSize - The current visible-window size.\n     * @param visibleHeight - The viewport height in pixels.\n     * @param totalRows - The total number of rows in the dataset.\n     * @returns The pool target size.\n     */\n    protected computePoolTarget(windowSize: number, visibleHeight: number, totalRows: number): number {\n        return Math.min(\n            totalRows,\n            Math.max(\n                windowSize,\n                Math.ceil(visibleHeight / this.getRowHeight()) + 2 * SCROLL_BUFFER + 2\n            )\n        );\n    }\n\n    /**\n     * Computes the number of whole rows a page-nav keystroke should move by:\n     * one viewport height, floored to at least one row.\n     *\n     * @returns The page size in rows.\n     */\n    protected computePageSize(): number {\n        const rowHeight = this.getRowHeight();\n\n        return Math.max(1, Math.floor((this.getHeight() || rowHeight) / rowHeight));\n    }\n\n    /**\n     * Grows the row pool up to `poolTarget`, batching new row elements through\n     * a {@link DocumentFragment} so the live rows container sees a single\n     * append instead of N. Each new slot pins its static top to 0, promotes it\n     * to its own compositor layer, and extends the parallel bookkeeping arrays\n     * in lockstep.\n     *\n     * @param poolTarget - The target pool size.\n     */\n    protected growRowPool(poolTarget: number): void {\n        if (!this._scroller || this._rowPool.length >= poolTarget) {\n            return;\n        }\n\n        const rowsContainer = this._scroller.getRowsContainer();\n        const growFragment  = DOM.sink.createDocumentFragment();\n\n        while (this._rowPool.length < poolTarget) {\n            const row   = this.createPoolRow();\n            const rowEl = row.getElement(true)!;\n\n            DOM.sink.appendChild(growFragment, rowEl);\n\n            // Pin row's static top to 0 once. Per-frame Y offset comes from\n            // translateY, which is composite-only (avoids layout/paint per\n            // scroll tick).\n            row.setY(0);\n\n            // Pre-promote pooled rows to their own compositor layer so the first\n            // scroll-driven translate doesn't pay a layer-creation cost.\n            row.setWillChange(\"transform\");\n\n            this._rowPool.push(row);\n            this._boundIndices.push(-1);\n            this._rowGeom.push(null);\n            this._rowDisplayed.push(false);\n            this.onPoolRowAdded();\n        }\n\n        DOM.sink.appendChild(rowsContainer, growFragment);\n        DOM.sink.release(growFragment);\n    }\n\n    /**\n     * Positions the pool slot at `slot` to `targetY` and sizes it to `rowWidth`,\n     * writing the translate/size only when the cached geometry differs from the\n     * target, and toggling the row displayed on the false→true edge.\n     *\n     * @param slot - The pool-slot index.\n     * @param targetY - The row's translate-Y offset in pixels.\n     * @param rowWidth - The row's width in pixels.\n     * @returns `true` when the geometry changed (the subclass may need to re-lay\n     *   out the row's children), `false` when it was already at the target.\n     */\n    protected positionRow(slot: number, targetY: number, rowWidth: number): boolean {\n        const row       = this._rowPool[slot];\n        const rowHeight = this.getRowHeight();\n        const prev      = this._rowGeom[slot];\n        const geomChanged = !prev || prev.ty !== targetY || prev.w !== rowWidth || prev.h !== rowHeight;\n\n        if (geomChanged) {\n            row.setAutoCommitStyle(false);\n            row.setX(0);\n            row.setTranslate(0, targetY);\n            row.setWidth(rowWidth);\n            row.setHeight(rowHeight);\n            row.setAutoCommitStyle(true);\n            this._rowGeom[slot] = { ty: targetY, w: rowWidth, h: rowHeight };\n        }\n\n        if (!this._rowDisplayed[slot]) {\n            row.setDisplayed(true);\n            this._rowDisplayed[slot] = true;\n        }\n\n        return geomChanged;\n    }\n\n    /**\n     * Hides pool slots whose index falls outside the visible window and\n     * clears their cached binding so the next bind triggers a full rebuild.\n     *\n     * @param windowSize - The number of pool slots currently in use.\n     */\n    protected hideExcessPoolRows(windowSize: number): void {\n        for (let i = windowSize; i < this._rowPool.length; i++) {\n            if (this._rowDisplayed[i]) {\n                this._rowPool[i].setDisplayed(false);\n                this._rowDisplayed[i] = false;\n            }\n            this._boundIndices[i] = -1;\n            this._rowGeom[i] = null;\n        }\n    }\n\n    /**\n     * Clears the cached row geometry so the next render re-applies positions and\n     * sizes for every slot. `Body` overrides this to additionally clear its\n     * per-cell geometry cache.\n     */\n    protected invalidateGeom(): void {\n        for (let i = 0; i < this._rowGeom.length; i++) {\n            this._rowGeom[i] = null;\n        }\n    }\n\n    /**\n     * Scrolls the view so the row at `index` is fully visible, without moving\n     * the viewport unless necessary. Delegates through {@link VirtualScroller}\n     * so the header translate + scrollbar thumb stay in sync.\n     *\n     * @param index - The data index of the row to reveal. A negative index is a\n     *   no-op (the row is not in the current view).\n     */\n    protected scrollRowIntoView(index: number): void {\n        if (index < 0 || !this._scroller) {\n            return;\n        }\n\n        const rowHeight      = this.getRowHeight();\n        const top            = index * rowHeight;\n        const bottom         = top + rowHeight;\n        const scrollTop      = this._scroller.getScrollY();\n        const viewportHeight = this.getHeight();\n        const visibleBottom  = scrollTop + viewportHeight;\n\n        let target = scrollTop;\n        if (top < scrollTop) {\n            target = top;\n        } else if (bottom > visibleBottom) {\n            target = bottom - viewportHeight;\n        }\n        if (target !== scrollTop) {\n            this.setScrollY(target);\n        }\n    }\n}\n\nexport { VirtualRowView };\n"],"mappings":"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"}

package/dist/lib/VirtualScroller-BPDmO1ir.js

@@ -0,0 +1,2 @@
+import{l as e,u as t}from"./Position-B-WfZYAJ.js";import{m as n,p as r,y as i}from"./Component-BR2f0Itb.js";import{i as a,n as o,r as s,t as c}from"./Scrollbar-DchfiFKC.js";var VirtualScroller=class{_owner;_onScroll;_clipBox;_rowsContainer;_scrollbarV;_scrollbarH;_scrollX=0;_scrollY=0;_contentWidth=0;_contentHeight=0;_smooth;_shadowOverlay;_shadowEdges={top:0,bottom:0,left:0,right:0};constructor(e,n,a){this._owner=e,this._onScroll=a;let s=t.sink.createElement(`div`);t.sink.apply(s,{style:{position:`absolute`,top:`0`,left:`0`,width:`100%`,height:`100%`,overflow:`hidden`}}),t.sink.appendChild(n,s),this._clipBox=s;let l=t.sink.createElement(`div`);t.sink.apply(l,{style:{position:`absolute`,top:`0`,left:`0`,width:`100%`,transform:`translate3d(0, 0, 0)`,willChange:`transform`}}),t.sink.appendChild(s,l),this._rowsContainer=l;let u=t.sink.createElement(`div`);t.sink.apply(u,{style:{position:`absolute`,top:`0`,left:`0`,width:`100%`,height:`100%`,pointerEvents:`none`,boxShadow:o()}}),t.sink.appendChild(s,u),this._shadowOverlay=u,this._smooth=new r({read:e=>e===`x`?this._scrollX:this._scrollY,write:(e,t)=>e===`x`?this.setScrollX(t):this.setScrollY(t),clamp:(e,t)=>this.clampAxis(e,t)}),this._scrollbarV=new c(`vertical`),t.sink.appendChild(n,this._scrollbarV.getElement(!0)),this._scrollbarV.on(`scroll`,e=>{this._smooth.reset(),this.setScrollY(e)}),this._scrollbarH=new c(`horizontal`),t.sink.appendChild(n,this._scrollbarH.getElement(!0)),this._scrollbarH.on(`scroll`,e=>{this._smooth.reset(),this.setScrollX(e)}),this._owner.setTouchAction(`none`),i.addSubtreeListener(this._owner,`wheel`,e=>this.onWheel(e),{passive:!1}),this.attachTouchHandlers()}ownedHandles(){return[this._clipBox,this._rowsContainer,this._shadowOverlay]}getRowsContainer(){return this._rowsContainer}getScrollY(){return this._scrollY}getScrollX(){return this._scrollX}setScrollY(t){let n=Math.max(0,this._contentHeight-this.effectiveViewportH()),r=e.clamp(t,0,n);return r===this._scrollY?this:(this._scrollY=r,this.updateTransform(),this._onScroll(),this)}setScrollX(t){let n=Math.max(0,this._contentWidth-this.effectiveViewportW()),r=e.clamp(t,0,n);return r===this._scrollX?this:(this._scrollX=r,this.updateTransform(),this._onScroll(),this)}clampAxis(t,n){let r=t===`x`?Math.max(0,this._contentWidth-this.effectiveViewportW()):Math.max(0,this._contentHeight-this.effectiveViewportH());return e.clamp(n,0,r)}resetWheelEase(){this._smooth.reset()}computeScrollbarVisibility(e,t){let n=this._owner.getHeight()||0,r=this._owner.getWidth()||0,i=this._scrollbarV.getTrackWidth(),a=!1,o=!1;for(let s=0;s<2;s++){let s=n-(o?i:0),c=r-(a?i:0);a=t>s,o=e>c}let s=n-(o?i:0),c=r-(a?i:0);return{vVisible:a,hVisible:o,effW:c,effH:s}}effectiveViewportH(){return this.computeScrollbarVisibility(this._contentWidth,this._contentHeight).effH}effectiveViewportW(){return this.computeScrollbarVisibility(this._contentWidth,this._contentHeight).effW}getViewportWidth(){return this.effectiveViewportW()}clampToContent(e,t){this._contentWidth=e,this._contentHeight=t;let n=Math.max(0,t-this.effectiveViewportH()),r=Math.max(0,e-this.effectiveViewportW()),i=!1;this._scrollY>n&&(this._scrollY=n,i=!0),this._scrollX>r&&(this._scrollX=r,i=!0),i&&this.updateTransform()}layoutScrollbars(e,n){this._contentWidth=e,this._contentHeight=n;let r=this._scrollbarV.getTrackWidth(),i=this._owner.getWidth(),a=this._owner.getHeight(),{effW:o,effH:s}=this.computeScrollbarVisibility(e,n),c=Math.max(0,n-s),l=Math.max(0,e-o);(this._scrollY>c||this._scrollX>l)&&(this._scrollY>c&&(this._scrollY=c),this._scrollX>l&&(this._scrollX=l),this.updateTransform()),this._scrollbarV.setX(Math.max(0,i-r)),this._scrollbarV.setHeight(s),this._scrollbarV.setMetrics(s,n,this._scrollY),this._scrollbarH.setY(Math.max(0,a-r)),this._scrollbarH.setWidth(o),this._scrollbarH.setMetrics(o,e,this._scrollX),t.sink.apply(this._clipBox,{style:{width:o+`px`,height:s+`px`}}),this.updateShadows()}updateTransform(){t.sink.apply(this._rowsContainer,{style:{transform:`translate3d(${-this._scrollX}px, ${-this._scrollY}px, 0)`}}),this.updateShadows()}updateShadows(){let{effW:e,effH:t}=this.computeScrollbarVisibility(this._contentWidth,this._contentHeight),n=Math.max(0,this._contentWidth-e),r=Math.max(0,this._contentHeight-t);this.setShadowEdge(`top`,`--ts-ss-top`,a(this._scrollY)),this.setShadowEdge(`bottom`,`--ts-ss-bottom`,a(r-this._scrollY)),this.setShadowEdge(`left`,`--ts-ss-left`,a(this._scrollX)),this.setShadowEdge(`right`,`--ts-ss-right`,a(n-this._scrollX))}setShadowEdge(e,n,r){let i=Math.round(r*100);this._shadowEdges[e]!==i&&(this._shadowEdges[e]=i,t.sink.apply(this._shadowOverlay,{style:{[n]:s(i)}}))}onWheel(e){if(n(e)){if(e.preventDefault(),e.shiftKey&&e.deltaY!==0&&e.deltaX===0){this._smooth.scrollBy(e.deltaY,0);return}this._smooth.scrollBy(e.deltaX,e.deltaY)}}attachTouchHandlers(){let e=!1,n=0,r=0,a=0,o=0,s=[],c=null,cancelMomentum=()=>{c!==null&&(t.sink.cancelAnimationFrame(c),c=null)};i.addSubtreeListener(this._owner,`touchstart`,t=>{t.touches.length===1&&(cancelMomentum(),this._smooth.reset(),e=!0,n=t.touches[0].clientY,r=t.touches[0].clientX,a=this._scrollY,o=this._scrollX,s=[{time:performance.now(),x:r,y:n}])}),i.addSubtreeListener(this._owner,`touchmove`,t=>{if(!e||t.touches.length!==1)return;let i=t.touches[0].clientY,c=t.touches[0].clientX,l=performance.now();for(s.push({time:l,x:c,y:i});s.length>1&&s[0].time<l-150;)s.shift();this.setScrollY(a+(n-i)),this.setScrollX(o+(r-c))});let startMomentum=()=>{if(s.length<2)return;let e=s[s.length-1];if(performance.now()-e.time>50)return;let n=e.time-80,r=s.length-1;for(;r>0&&s[r-1].time>=n;)r--;let i=s[r],a=e.time-i.time;if(a<=0)return;let o=(i.y-e.y)/a,l=(i.x-e.x)/a;if(Math.sqrt(l*l+o*o)<.1)return;let u=performance.now(),step=()=>{let e=performance.now(),n=e-u;u=e;let r=.95**(n/16.667);if(o*=r,l*=r,Math.sqrt(l*l+o*o)<.02){c=null;return}let i=this._scrollY,a=this._scrollX;if(this.setScrollY(this._scrollY+o*n),this.setScrollX(this._scrollX+l*n),this._scrollY===i&&(o=0),this._scrollX===a&&(l=0),o===0&&l===0){c=null;return}c=t.sink.requestAnimationFrame(step)};c=t.sink.requestAnimationFrame(step)};i.addSubtreeListener(this._owner,`touchend`,()=>{e&&(e=!1,startMomentum())}),i.addSubtreeListener(this._owner,`touchcancel`,()=>{e=!1,cancelMomentum()})}};export{VirtualScroller as t};
+//# sourceMappingURL=VirtualScroller-BPDmO1ir.js.map