@jimka/typescript-ui 0.1.0 → 0.1.1

package/dist/lib/VBox-CdV9VGxR.js

@@ -0,0 +1,2 @@
+import{a as e,o as t}from"./Position-DJKB0N3l.js";import{d as n,f as r}from"./Component-Bs6TvaGZ.js";import{t as i}from"./BoxLayout-8ryMD4j5.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-CdV9VGxR.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VBox-CdV9VGxR.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/VirtualRowView-C18j90n5.js

@@ -0,0 +1,2 @@
+import{t as e}from"./DOM-DeF_dWe2.js";import{t}from"./Component-Bs6TvaGZ.js";import{t as n}from"./VirtualScroller-BKMvTisA.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-C18j90n5.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualRowView-C18j90n5.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-BKMvTisA.js

@@ -0,0 +1,2 @@
+import{t as e}from"./DOM-DeF_dWe2.js";import{l as t}from"./Position-DJKB0N3l.js";import{m as n,p as r,y as i}from"./Component-Bs6TvaGZ.js";import{i as a,n as o,r as s,t as c}from"./Scrollbar-DQdCdj94.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(t,n,a){this._owner=t,this._onScroll=a;let s=e.sink.createElement(`div`);e.sink.apply(s,{style:{position:`absolute`,top:`0`,left:`0`,width:`100%`,height:`100%`,overflow:`hidden`}}),e.sink.appendChild(n,s),this._clipBox=s;let l=e.sink.createElement(`div`);e.sink.apply(l,{style:{position:`absolute`,top:`0`,left:`0`,width:`100%`,transform:`translate3d(0, 0, 0)`,willChange:`transform`}}),e.sink.appendChild(s,l),this._rowsContainer=l;let u=e.sink.createElement(`div`);e.sink.apply(u,{style:{position:`absolute`,top:`0`,left:`0`,width:`100%`,height:`100%`,pointerEvents:`none`,boxShadow:o()}}),e.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`),e.sink.appendChild(n,this._scrollbarV.getElement(!0)),this._scrollbarV.on(`scroll`,e=>{this._smooth.reset(),this.setScrollY(e)}),this._scrollbarH=new c(`horizontal`),e.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(e){let n=Math.max(0,this._contentHeight-this.effectiveViewportH()),r=t.clamp(e,0,n);return r===this._scrollY?this:(this._scrollY=r,this.updateTransform(),this._onScroll(),this)}setScrollX(e){let n=Math.max(0,this._contentWidth-this.effectiveViewportW()),r=t.clamp(e,0,n);return r===this._scrollX?this:(this._scrollX=r,this.updateTransform(),this._onScroll(),this)}clampAxis(e,n){let r=e===`x`?Math.max(0,this._contentWidth-this.effectiveViewportW()):Math.max(0,this._contentHeight-this.effectiveViewportH());return t.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(t,n){this._contentWidth=t,this._contentHeight=n;let r=this._scrollbarV.getTrackWidth(),i=this._owner.getWidth(),a=this._owner.getHeight(),{effW:o,effH:s}=this.computeScrollbarVisibility(t,n),c=Math.max(0,n-s),l=Math.max(0,t-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,t,this._scrollX),e.sink.apply(this._clipBox,{style:{width:o+`px`,height:s+`px`}}),this.updateShadows()}updateTransform(){e.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(t,n,r){let i=Math.round(r*100);this._shadowEdges[t]!==i&&(this._shadowEdges[t]=i,e.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 t=!1,n=0,r=0,a=0,o=0,s=[],c=null,cancelMomentum=()=>{c!==null&&(e.sink.cancelAnimationFrame(c),c=null)};i.addSubtreeListener(this._owner,`touchstart`,e=>{e.touches.length===1&&(cancelMomentum(),this._smooth.reset(),t=!0,n=e.touches[0].clientY,r=e.touches[0].clientX,a=this._scrollY,o=this._scrollX,s=[{time:performance.now(),x:r,y:n}])}),i.addSubtreeListener(this._owner,`touchmove`,e=>{if(!t||e.touches.length!==1)return;let i=e.touches[0].clientY,c=e.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 t=s[s.length-1];if(performance.now()-t.time>50)return;let n=t.time-80,r=s.length-1;for(;r>0&&s[r-1].time>=n;)r--;let i=s[r],a=t.time-i.time;if(a<=0)return;let o=(i.y-t.y)/a,l=(i.x-t.x)/a;if(Math.sqrt(l*l+o*o)<.1)return;let u=performance.now(),step=()=>{let t=performance.now(),n=t-u;u=t;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=e.sink.requestAnimationFrame(step)};c=e.sink.requestAnimationFrame(step)};i.addSubtreeListener(this._owner,`touchend`,()=>{t&&(t=!1,startMomentum())}),i.addSubtreeListener(this._owner,`touchcancel`,()=>{t=!1,cancelMomentum()})}};export{VirtualScroller as t};
+//# sourceMappingURL=VirtualScroller-BKMvTisA.js.map

package/dist/lib/VirtualScroller-BKMvTisA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VirtualScroller-BKMvTisA.js","names":[],"sources":["../../src/typescript/lib/component/container/VirtualScroller.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Component } from \"~/core/Component.js\";\nimport { Util } from \"~/core/Util.js\";\nimport { DOM } from \"~/core/DOM.js\";\nimport type { Handle } from \"~/core/DOM.js\";\nimport { Event } from \"~/core/Event.js\";\nimport { SmoothScroller, consumeWheel } from \"~/core/SmoothScroller.js\";\nimport { Scrollbar } from \"~/component/container/Scrollbar.js\";\nimport { scrollShadowBoxShadow, scrollShadowEdgeValue, scrollShadowRamp } from \"~/core/ScrollShadow.js\";\n\n/** Per-edge scroll-shadow strength cache, quantised to a whole percent (0–100). */\ntype ScrollShadowEdges = { top: number; bottom: number; left: number; right: number };\n\n// VirtualScroller is a plain helper, not a Component: it owns and lays out raw\n// `clipBox` / `rowsContainer` `HTMLElement`s it creates directly, so the\n// Component style setters don't apply and direct `.style` writes are correct.\n\n/**\n * Callback fired by {@link VirtualScroller} whenever the scroll position\n * changes via user input (wheel, touch, momentum, scrollbar). The owner\n * should re-render its visible window in response.\n *\n * @category Components\n */\nexport type VirtualScrollerOnScroll = () => void;\n\n/**\n * Shared scroll machinery for transform-based virtual lists (e.g. table body,\n * tree). Owns the rows-container element, two custom {@link Scrollbar} overlays\n * (vertical + horizontal), and the wheel/touch handlers with 2-axis fling\n * momentum.\n *\n * The owner component:\n * 1. Constructs a VirtualScroller from its `init()` with the owner element and\n *    a callback that re-renders the visible window.\n * 2. Appends pool rows into {@link getRowsContainer}.\n * 3. Reads {@link getScrollX} / {@link getScrollY} to determine the visible window.\n * 4. Calls {@link clampToContent} at the start of `renderWindow` (so scroll\n *    positions are sane before being used).\n * 5. Calls {@link layoutScrollbars} at the end of `renderWindow` with the\n *    current content sizes; the scroller applies the final clamp and positions\n *    the scrollbars.\n *\n * @category Components\n */\nexport class VirtualScroller {\n\n    private _owner          : Component;\n    private _onScroll       : VirtualScrollerOnScroll;\n    private _clipBox        : Handle;\n    private _rowsContainer  : Handle;\n    private _scrollbarV     : Scrollbar;\n    private _scrollbarH     : Scrollbar;\n    private _scrollX        : number = 0;\n    private _scrollY        : number = 0;\n    private _contentWidth   : number = 0;\n    private _contentHeight  : number = 0;\n    private _smooth         : SmoothScroller;\n    private _shadowOverlay  : Handle;\n    private _shadowEdges     : ScrollShadowEdges = { top: 0, bottom: 0, left: 0, right: 0 };\n\n    /**\n     * Constructs a VirtualScroller and attaches it to the owner element.\n     *\n     * @param owner - The component being scrolled (used for `getWidth`/`getHeight`).\n     * @param element - The owner's root DOM element. Must already exist; call\n     * this from the owner's `init()` after `super.init(element)`.\n     * @param onScroll - Callback invoked when scroll position changes via\n     * user input.\n     */\n    constructor(owner: Component, element: Handle, onScroll: VirtualScrollerOnScroll) {\n        this._owner    = owner;\n        this._onScroll = onScroll;\n\n        // Two-element wrapper: the outer `clipBox` carries `overflow:hidden`\n        // sized to the effective viewport so the Scrollbar widgets — positioned\n        // by `layoutScrollbars` at `(outerW - trackW, outerH - trackW)` — sit\n        // in their own reserved band rather than overlaying the rightmost\n        // column / bottom row. The inner `rowsContainer` carries the scroll\n        // transform; the transform cannot sit on the same element as\n        // `overflow:hidden` because CSS clipping happens in the element's own\n        // LOCAL coordinate system before its transform applies — splitting\n        // the two roles lets the transform shift the rows around inside a\n        // stable clip.\n        const clipBox = DOM.sink.createElement(\"div\");\n        DOM.sink.apply(clipBox, { style: { position: \"absolute\", top: \"0\", left: \"0\", width: \"100%\", height: \"100%\", overflow: \"hidden\" } });\n        DOM.sink.appendChild(element, clipBox);\n        this._clipBox = clipBox;\n\n        const container = DOM.sink.createElement(\"div\");\n        DOM.sink.apply(container, { style: { position: \"absolute\", top: \"0\", left: \"0\", width: \"100%\", transform: \"translate3d(0, 0, 0)\", willChange: \"transform\" } });\n        DOM.sink.appendChild(clipBox, container);\n        this._rowsContainer = container;\n\n        // Position-aware edge shadows, matching the native-scroll `Panel` cue.\n        // The overlay is a sibling of `rowsContainer` inside the `clipBox`, so it\n        // is clipped to the effective viewport and — being outside the scrolled\n        // `rowsContainer` — is not shifted by the scroll transform; sizing it to\n        // 100% tracks the clip box that `layoutScrollbars` resizes to the\n        // effective viewport. It paints above the rows (appended last) and is\n        // inert to the pointer. Each edge is a `box-shadow` layer gated by a\n        // custom property; `updateShadows` flips the property per scroll/resize.\n        const shadowOverlay = DOM.sink.createElement(\"div\");\n        DOM.sink.apply(shadowOverlay, { style: {\n            position:      \"absolute\",\n            top:           \"0\",\n            left:          \"0\",\n            width:         \"100%\",\n            height:        \"100%\",\n            pointerEvents: \"none\",\n            boxShadow:     scrollShadowBoxShadow(),\n        } });\n        DOM.sink.appendChild(clipBox, shadowOverlay);\n        this._shadowOverlay = shadowOverlay;\n\n        // Drives wheel-initiated scrolling through an eased RAF loop. The seam\n        // delegates to the existing setScrollX/Y (which clamp, write the\n        // transform, and fire onScroll, so the virtual window re-renders every\n        // frame) and clamps targets against the same effective-viewport bounds.\n        this._smooth = new SmoothScroller({\n            read:  (axis) => axis === \"x\" ? this._scrollX : this._scrollY,\n            write: (axis, value) => axis === \"x\" ? this.setScrollX(value) : this.setScrollY(value),\n            clamp: (axis, value) => this.clampAxis(axis, value),\n        });\n\n        this._scrollbarV = new Scrollbar(\"vertical\");\n        DOM.sink.appendChild(element, this._scrollbarV.getElement(true)!);\n        this._scrollbarV.on(\"scroll\", (p: number) => {\n            this._smooth.reset();\n            this.setScrollY(p);\n        });\n\n        this._scrollbarH = new Scrollbar(\"horizontal\");\n        DOM.sink.appendChild(element, this._scrollbarH.getElement(true)!);\n        this._scrollbarH.on(\"scroll\", (p: number) => {\n            this._smooth.reset();\n            this.setScrollX(p);\n        });\n\n        this._owner.setTouchAction(\"none\");\n\n        // Subtree because wheel events fire on whichever descendant of the\n        // owner the pointer is over (a row, a cell, …) — not the owner root.\n        // passive: false so onWheel can preventDefault the native page scroll.\n        Event.addSubtreeListener(\n            this._owner,\n            \"wheel\",\n            (e: WheelEvent) => this.onWheel(e),\n            { passive: false }\n        );\n\n        this.attachTouchHandlers();\n    }\n\n    /**\n     * Returns the two created container handles (clip box and rows container).\n     * The owning component tracks these via `trackHandle` so they are released\n     * with the owner — on its destructor or, for a discarded owner, on GC — and\n     * not left pinned in the registry. The scroller is not a `Component`, so it\n     * cannot track its own handles.\n     *\n     * @returns The scroller's owned element handles.\n     */\n    ownedHandles(): readonly Handle[] {\n        return [this._clipBox, this._rowsContainer, this._shadowOverlay];\n    }\n\n    /**\n     * Returns the rows-container element. Owners append pool rows here so\n     * they participate in the transform-based scroll.\n     *\n     * @returns The rows-container DOM element.\n     */\n    getRowsContainer(): Handle {\n        return this._rowsContainer;\n    }\n\n    /**\n     * Returns the current vertical scroll position in pixels.\n     *\n     * @returns The current `scrollY`.\n     */\n    getScrollY(): number {\n        return this._scrollY;\n    }\n\n    /**\n     * Returns the current horizontal scroll position in pixels.\n     *\n     * @returns The current `scrollX`.\n     */\n    getScrollX(): number {\n        return this._scrollX;\n    }\n\n    /**\n     * Sets the vertical scroll position. Clamped against the last-known\n     * content height and the *effective* viewport height (full owner height\n     * minus the horizontal scrollbar's reservation when that bar is visible),\n     * so the maximum reachable scroll position matches what the vertical\n     * scrollbar's thumb tops out at. Triggers the owner's `onScroll` callback\n     * if the position changed.\n     *\n     * @param y - The new scroll position in pixels.\n     */\n    setScrollY(y: number): this {\n        const maxScroll = Math.max(0, this._contentHeight - this.effectiveViewportH());\n        const next      = Util.clamp(y, 0, maxScroll);\n\n        if (next === this._scrollY) {\n            return this;\n        }\n\n        this._scrollY = next;\n        this.updateTransform();\n        this._onScroll();\n\n        return this;\n    }\n\n    /**\n     * Sets the horizontal scroll position. Clamped against the last-known\n     * content width and the *effective* viewport width (full owner width\n     * minus the vertical scrollbar's reservation when that bar is visible),\n     * so the maximum reachable scroll position matches what the horizontal\n     * scrollbar's thumb tops out at. Triggers the owner's `onScroll` callback\n     * if the position changed.\n     *\n     * @param x - The new scroll position in pixels.\n     */\n    setScrollX(x: number): this {\n        const maxScroll = Math.max(0, this._contentWidth - this.effectiveViewportW());\n        const next      = Util.clamp(x, 0, maxScroll);\n\n        if (next === this._scrollX) {\n            return this;\n        }\n\n        this._scrollX = next;\n        this.updateTransform();\n        this._onScroll();\n\n        return this;\n    }\n\n    /**\n     * Clamps a requested position for one axis to its `[0, max]` range, using\n     * the same effective-viewport bounds as `setScrollX/Y` so the eased wheel\n     * target converges exactly where the scrollbar thumb tops out.\n     *\n     * @param axis - The axis to clamp (`\"x\"` or `\"y\"`).\n     * @param value - The requested position in pixels.\n     *\n     * @returns The clamped position in pixels.\n     */\n    private clampAxis(axis: \"x\" | \"y\", value: number): number {\n        const max = axis === \"x\"\n            ? Math.max(0, this._contentWidth  - this.effectiveViewportW())\n            : Math.max(0, this._contentHeight - this.effectiveViewportH());\n\n        return Util.clamp(value, 0, max);\n    }\n\n    /**\n     * Aborts any in-flight eased wheel animation and re-seeds it from the live\n     * position. Call before a programmatic scroll jump (e.g. `scrollToRecord`)\n     * so a lingering ease can't snap the position back afterward.\n     */\n    resetWheelEase(): void {\n        this._smooth.reset();\n    }\n\n    /**\n     * Decides whether each scrollbar should be visible given the current\n     * content size, accounting for the mutual dependency between the two\n     * axes — if one bar is visible, its track-width reservation shrinks\n     * the cross-axis viewport, which can in turn force the other bar to\n     * become visible. Two iterations are sufficient: each pass can only\n     * promote one flag from false to true.\n     */\n    private computeScrollbarVisibility(contentWidth: number, contentHeight: number): { vVisible: boolean, hVisible: boolean, effW: number, effH: number } {\n        const outerH = this._owner.getHeight() || 0;\n        const outerW = this._owner.getWidth()  || 0;\n        const trackW = this._scrollbarV.getTrackWidth();\n\n        let vVisible = false;\n        let hVisible = false;\n        for (let i = 0; i < 2; i++) {\n            const effH: number = outerH - (hVisible ? trackW : 0);\n            const effW: number = outerW - (vVisible ? trackW : 0);\n\n            vVisible = contentHeight > effH;\n            hVisible = contentWidth  > effW;\n        }\n\n        const effH = outerH - (hVisible ? trackW : 0);\n        const effW = outerW - (vVisible ? trackW : 0);\n\n        return { vVisible, hVisible, effW, effH };\n    }\n\n    /**\n     * Effective vertical viewport — the owner height minus the horizontal\n     * scrollbar's track-width reservation when that bar would be visible.\n     * Single source of truth so the clamps in `setScrollY` agree with what\n     * the vertical scrollbar's `setMetrics` is fed.\n     */\n    private effectiveViewportH(): number {\n        return this.computeScrollbarVisibility(this._contentWidth, this._contentHeight).effH;\n    }\n\n    /**\n     * Effective horizontal viewport — see {@link effectiveViewportH}.\n     */\n    private effectiveViewportW(): number {\n        return this.computeScrollbarVisibility(this._contentWidth, this._contentHeight).effW;\n    }\n\n    /**\n     * Effective viewport width for the last-known content metrics — the owner\n     * width minus the vertical scrollbar's track reservation when that bar is\n     * visible. Owners that size fill-width rows (e.g. the\n     * [`Tree`](/api/component/tree/classes/Tree)) base their row width on this so\n     * content does not run under the vertical bar, which would otherwise force a\n     * spurious horizontal bar for the reserved band. Reads the current\n     * `_contentWidth` / `_contentHeight`; callers refresh those via\n     * {@link clampToContent} at the top of their render pass before querying.\n     * The public face of `effectiveViewportW` (same value; that stays the\n     * internal clamp helper).\n     *\n     * @returns The effective viewport width in pixels.\n     */\n    getViewportWidth(): number {\n        return this.effectiveViewportW();\n    }\n\n    /**\n     * Clamps the current `scrollX` / `scrollY` against the new content size\n     * and the *effective* viewport on each axis (which subtracts the\n     * cross-axis scrollbar's track-width when that bar is visible). Call at\n     * the start of `renderWindow` so scrollX/Y are within range before being\n     * used for window calculations — important when content has shrunk since\n     * the last frame. Uses the same effective-viewport reasoning as\n     * `setScrollX/Y` so the clamps agree and scrollX/Y aren't pulled back to\n     * a smaller bound than the scrollbar's own `setMetrics` expects (which\n     * would leave the thumb stopping short of the end-arrow). Does not fire\n     * `onScroll`.\n     *\n     * @param contentWidth - The total scrollable content width in pixels.\n     * @param contentHeight - The total scrollable content height in pixels.\n     */\n    clampToContent(contentWidth: number, contentHeight: number): void {\n        this._contentWidth  = contentWidth;\n        this._contentHeight = contentHeight;\n\n        const maxY = Math.max(0, contentHeight - this.effectiveViewportH());\n        const maxX = Math.max(0, contentWidth  - this.effectiveViewportW());\n\n        let changed = false;\n        if (this._scrollY > maxY) {\n            this._scrollY = maxY;\n            changed = true;\n        }\n        if (this._scrollX > maxX) {\n            this._scrollX = maxX;\n            changed = true;\n        }\n        if (changed) {\n            this.updateTransform();\n        }\n    }\n\n    /**\n     * Tight clamp using effective viewports (each axis subtracts the\n     * cross-axis scrollbar's track width when it is visible), then positions\n     * the scrollbars and pushes metrics. Call at end of `renderWindow`.\n     *\n     * @param contentWidth - The total scrollable content width in pixels.\n     * @param contentHeight - The total scrollable content height in pixels.\n     */\n    layoutScrollbars(contentWidth: number, contentHeight: number): void {\n        this._contentWidth  = contentWidth;\n        this._contentHeight = contentHeight;\n\n        const trackW = this._scrollbarV.getTrackWidth();\n        const outerW = this._owner.getWidth();\n        const outerH = this._owner.getHeight();\n\n        const { effW, effH } = this.computeScrollbarVisibility(contentWidth, contentHeight);\n\n        const maxY = Math.max(0, contentHeight - effH);\n        const maxX = Math.max(0, contentWidth  - effW);\n        if (this._scrollY > maxY || this._scrollX > maxX) {\n            if (this._scrollY > maxY) this._scrollY = maxY;\n            if (this._scrollX > maxX) this._scrollX = maxX;\n            this.updateTransform();\n        }\n\n        this._scrollbarV.setX(Math.max(0, outerW - trackW));\n        this._scrollbarV.setHeight(effH);\n        this._scrollbarV.setMetrics(effH, contentHeight, this._scrollY);\n\n        this._scrollbarH.setY(Math.max(0, outerH - trackW));\n        this._scrollbarH.setWidth(effW);\n        this._scrollbarH.setMetrics(effW, contentWidth, this._scrollX);\n\n        // Resize the clip box to the effective viewport so cells translated\n        // by the horizontal scroll can't bleed under the vertical scrollbar\n        // (and rows beyond the bottom can't bleed under the horizontal\n        // scrollbar). When neither bar is visible this collapses to the\n        // full owner size, matching the previous `width/height: 100%`\n        // behaviour.\n        DOM.sink.apply(this._clipBox, { style: { width: effW + \"px\", height: effH + \"px\" } });\n\n        // Content size / viewport may have changed without the scroll position\n        // moving (so `updateTransform` did not run above) — refresh the shadow\n        // edges against the new extremes.\n        this.updateShadows();\n    }\n\n    /**\n     * Writes the current `scrollX` / `scrollY` into the rows-container\n     * transform.\n     */\n    private updateTransform(): void {\n        DOM.sink.apply(this._rowsContainer, { style: { transform: `translate3d(${-this._scrollX}px, ${-this._scrollY}px, 0)` } });\n        this.updateShadows();\n    }\n\n    /**\n     * Recomputes each scroll-shadow edge's strength from the current scroll\n     * position, content size, and effective viewport, then lights only the\n     * edges that have hidden content past them. Cheap on a no-op scroll: an\n     * edge whose quantised strength is unchanged skips the DOM write (see\n     * {@link setShadowEdge}). Called on every scroll ({@link updateTransform})\n     * and whenever the content/viewport metrics change ({@link layoutScrollbars}).\n     */\n    private updateShadows(): void {\n        const { effW, effH } = this.computeScrollbarVisibility(this._contentWidth, this._contentHeight);\n\n        const maxX = Math.max(0, this._contentWidth  - effW);\n        const maxY = Math.max(0, this._contentHeight - effH);\n\n        this.setShadowEdge(\"top\",    \"--ts-ss-top\",    scrollShadowRamp(this._scrollY));\n        this.setShadowEdge(\"bottom\", \"--ts-ss-bottom\", scrollShadowRamp(maxY - this._scrollY));\n        this.setShadowEdge(\"left\",   \"--ts-ss-left\",   scrollShadowRamp(this._scrollX));\n        this.setShadowEdge(\"right\",  \"--ts-ss-right\",  scrollShadowRamp(maxX - this._scrollX));\n    }\n\n    /**\n     * Sets a single edge's shadow strength by scaling the theme shadow colour\n     * toward transparent. Strength is quantised to a whole percent so an\n     * in-ramp scroll only repaints when the visible strength actually changes;\n     * at zero the property is unset so the `box-shadow` layer falls back to\n     * `transparent`.\n     *\n     * @param edge - The edge whose cached strength this updates.\n     * @param property - The overlay custom property backing that edge's shadow.\n     * @param strength - The target strength in the range 0–1.\n     */\n    private setShadowEdge(edge: keyof ScrollShadowEdges, property: string, strength: number): void {\n        const percent = Math.round(strength * 100);   // quantise: 0–1 → 0–100%\n\n        if (this._shadowEdges[edge] === percent) {\n            return;\n        }\n\n        this._shadowEdges[edge] = percent;\n        DOM.sink.apply(this._shadowOverlay, { style: { [property]: scrollShadowEdgeValue(percent) } });\n    }\n\n    /**\n     * Eases wheel input into the scroll position through the {@link SmoothScroller}.\n     * Shift+wheel without an explicit deltaX is treated as horizontal scroll.\n     * Claims the event so an ancestor scroll container doesn't also scroll it.\n     *\n     * @param e - The wheel event.\n     */\n    private onWheel(e: WheelEvent): void {\n        if (!consumeWheel(e)) {\n            return;\n        }\n\n        e.preventDefault();\n\n        if (e.shiftKey && e.deltaY !== 0 && e.deltaX === 0) {\n            this._smooth.scrollBy(e.deltaY, 0);\n\n            return;\n        }\n\n        this._smooth.scrollBy(e.deltaX, e.deltaY);\n    }\n\n    /**\n     * Installs the touch handlers: 1:1 finger drag scrolls both axes, and on\n     * release a 2D fling momentum decays per frame until it falls below\n     * threshold or hits a scroll boundary.\n     */\n    private attachTouchHandlers(): void {\n        let touchActive       = false;\n        let touchStartY       = 0;\n        let touchStartX       = 0;\n        let touchStartScrollY = 0;\n        let touchStartScrollX = 0;\n        let touchSamples      : Array<{ time: number, x: number, y: number }> = [];\n        let momentumRaf       : number | null = null;\n\n        const cancelMomentum = (): void => {\n            if (momentumRaf !== null) {\n                DOM.sink.cancelAnimationFrame(momentumRaf);\n                momentumRaf = null;\n            }\n        };\n\n        // Subtree because touch events fire on descendants of the owner\n        // (rows / cells) — not the owner root.\n        Event.addSubtreeListener(this._owner, \"touchstart\", (e: TouchEvent) => {\n            if (e.touches.length !== 1) {\n                return;\n            }\n            cancelMomentum();\n            this._smooth.reset();\n            touchActive       = true;\n            touchStartY       = e.touches[0].clientY;\n            touchStartX       = e.touches[0].clientX;\n            touchStartScrollY = this._scrollY;\n            touchStartScrollX = this._scrollX;\n            touchSamples      = [{ time: performance.now(), x: touchStartX, y: touchStartY }];\n        });\n\n        Event.addSubtreeListener(this._owner, \"touchmove\", (e: TouchEvent) => {\n            if (!touchActive || e.touches.length !== 1) {\n                return;\n            }\n            const y   = e.touches[0].clientY;\n            const x   = e.touches[0].clientX;\n            const now = performance.now();\n\n            touchSamples.push({ time: now, x: x, y: y });\n            while (touchSamples.length > 1 && touchSamples[0].time < now - 150) {\n                touchSamples.shift();\n            }\n\n            this.setScrollY(touchStartScrollY + (touchStartY - y));\n            this.setScrollX(touchStartScrollX + (touchStartX - x));\n        });\n\n        const startMomentum = (): void => {\n            if (touchSamples.length < 2) {\n                return;\n            }\n\n            const last = touchSamples[touchSamples.length - 1];\n\n            const PAUSE_THRESHOLD = 50;\n            if (performance.now() - last.time > PAUSE_THRESHOLD) {\n                return;\n            }\n\n            const VELOCITY_WINDOW = 80;\n            const cutoff          = last.time - VELOCITY_WINDOW;\n            let firstIdx          = touchSamples.length - 1;\n            while (firstIdx > 0 && touchSamples[firstIdx - 1].time >= cutoff) {\n                firstIdx--;\n            }\n            const first = touchSamples[firstIdx];\n            const dt    = last.time - first.time;\n            if (dt <= 0) {\n                return;\n            }\n\n            let velocityY = (first.y - last.y) / dt;\n            let velocityX = (first.x - last.x) / dt;\n\n            const MIN_VELOCITY  = 0.1;\n            const FRICTION      = 0.95;\n            const STOP_VELOCITY = 0.02;\n\n            const initialSpeed = Math.sqrt(velocityX * velocityX + velocityY * velocityY);\n            if (initialSpeed < MIN_VELOCITY) {\n                return;\n            }\n\n            let lastT = performance.now();\n            const step = (): void => {\n                const now   = performance.now();\n                const frame = now - lastT;\n                lastT       = now;\n\n                const decay = Math.pow(FRICTION, frame / 16.667);\n                velocityY *= decay;\n                velocityX *= decay;\n\n                const speed = Math.sqrt(velocityX * velocityX + velocityY * velocityY);\n                if (speed < STOP_VELOCITY) {\n                    momentumRaf = null;\n                    return;\n                }\n\n                const beforeY = this._scrollY;\n                const beforeX = this._scrollX;\n                this.setScrollY(this._scrollY + velocityY * frame);\n                this.setScrollX(this._scrollX + velocityX * frame);\n                if (this._scrollY === beforeY) {\n                    velocityY = 0;\n                }\n                if (this._scrollX === beforeX) {\n                    velocityX = 0;\n                }\n                if (velocityY === 0 && velocityX === 0) {\n                    momentumRaf = null;\n                    return;\n                }\n\n                momentumRaf = DOM.sink.requestAnimationFrame(step);\n            };\n\n            momentumRaf = DOM.sink.requestAnimationFrame(step);\n        };\n\n        Event.addSubtreeListener(this._owner, \"touchend\", () => {\n            if (!touchActive) {\n                return;\n            }\n            touchActive = false;\n            startMomentum();\n        });\n\n        Event.addSubtreeListener(this._owner, \"touchcancel\", () => {\n            touchActive = false;\n            cancelMomentum();\n        });\n    }\n}\n"],"mappings":"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"}

package/dist/lib/component/button.es.js

@@ -1,2 +1,2 @@
-import{u as e}from"../Position-B-WfZYAJ.js";import{f as t,y as n}from"../Component-BR2f0Itb.js";import{t as r}from"../Glyph-WUqTF_Z9.js";import{t as i}from"../Button-DEUtBqK4.js";import{n as a,r as o,t as s}from"../TabButton-pZKFYg7b.js";import{t as c}from"../Menu-Wz4MK6sA.js";import{t as l}from"../MenuButton-JQQaKThJ.js";import{caret_down as u}from"../glyphs/solid/caret_down.es.js";r.register(u);var d=`caret-down`,f=16,SplitButton=class extends i{_chevron;_menu=null;_onChevronClick=()=>{this._toggleMenu()};constructor(e,t){super(e,t),this._menuItems??=[],this._chevron=new r(d),this._chevron.setPreferredSize(f,f),this._chevron.setCursor(`pointer`),this._chevron.setPointerEvents(`auto`),this._chevron.setTransition(`transform 200ms ease`),this._content.addComponent(this._chevron),n.addSubtreeListener(this._chevron,`click`,this._onChevronClick)}setMenuItems(e){return this._menuItems=e,this._options.menuItems=e,this}getMenuItems(){return this._menuItems}applyOptions(e){return super.applyOptions(e),e.menuItems!==void 0&&this.setMenuItems(e.menuItems),this}_afterRebuildContentRow(){this._chevron&&this._content.addComponent(this._chevron)}_toggleMenu(){if(!this.getElement())return;let t=e.source.getViewportRect(this);this._menu??=new c,this._setChevronOpen(!0),this._menu.toggleFor(this._chevron.getElement(!0),t,this._menuItems,()=>{this._setChevronOpen(!1)})}_setChevronOpen(e){this._chevron.setTransform(e?`rotate(180deg)`:`rotate(0deg)`)}},p=t(SplitButton);export{i as Button,l as MenuButton,p as SplitButton,s as TabButton,a as TabCloseButton,o as ToggleButton};
+import{t as e}from"../DOM-DeF_dWe2.js";import{f as t,y as n}from"../Component-Bs6TvaGZ.js";import{t as r}from"../Glyph-6Ki3A1_a.js";import{t as i}from"../Button-Cdq2ySPL.js";import{n as a,r as o,t as s}from"../TabButton-DqYDfN7P.js";import{t as c}from"../Menu-BdnwRY0M.js";import{t as l}from"../MenuButton-D15cSbMf.js";import{caret_down as u}from"../glyphs/solid/caret_down.es.js";r.register(u);var d=`caret-down`,f=16,SplitButton=class extends i{_chevron;_menu=null;_onChevronClick=()=>{this._toggleMenu()};constructor(e,t){super(e,t),this._menuItems??=[],this._chevron=new r(d),this._chevron.setPreferredSize(f,f),this._chevron.setCursor(`pointer`),this._chevron.setPointerEvents(`auto`),this._chevron.setTransition(`transform 200ms ease`),this._content.addComponent(this._chevron),n.addSubtreeListener(this._chevron,`click`,this._onChevronClick)}setMenuItems(e){return this._menuItems=e,this._options.menuItems=e,this}getMenuItems(){return this._menuItems}applyOptions(e){return super.applyOptions(e),e.menuItems!==void 0&&this.setMenuItems(e.menuItems),this}_afterRebuildContentRow(){this._chevron&&this._content.addComponent(this._chevron)}_toggleMenu(){if(!this.getElement())return;let t=e.source.getViewportRect(this);this._menu??=new c,this._setChevronOpen(!0),this._menu.toggleFor(this._chevron.getElement(!0),t,this._menuItems,()=>{this._setChevronOpen(!1)})}_setChevronOpen(e){this._chevron.setTransform(e?`rotate(180deg)`:`rotate(0deg)`)}},p=t(SplitButton);export{i as Button,l as MenuButton,p as SplitButton,s as TabButton,a as TabCloseButton,o as ToggleButton};
 //# sourceMappingURL=button.es.js.map

package/dist/lib/component/button.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"button.es.js","names":[],"sources":["../../../src/typescript/lib/component/button/SplitButton.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Event } from \"~/core/Event.js\";\nimport { Button, ButtonOptions } from \"~/component/button/Button.js\";\nimport { DOM } from \"~/core/DOM.js\";\nimport { Glyph } from \"~/component/display/Glyph.js\";\nimport { Menu } from \"~/overlay/Menu.js\";\nimport { MenuItemConfig } from \"~/component/container/MenuItem.js\";\nimport { callable } from \"~/core/Callable.js\";\nimport { caret_down } from \"~/glyphs/solid/caret_down.js\";\n\n// Register the trailing chevron eagerly at module load — same pattern as\n// `TabCloseButton` registering its `xmark` — so `new SplitButton()` always\n// resolves the chevron without the consumer pre-registering a glyph.\nGlyph.register(caret_down);\n\n/** Registry name of the trailing dropdown chevron glyph. */\nconst CHEVRON_GLYPH = \"caret-down\";\n\n/**\n * Square pixel size of the trailing chevron glyph. Pinned (not\n * line-height-tracked like the leading glyph) so the dropdown affordance stays\n * a constant, comfortably-clickable size across themes; 16px matches the\n * compact icon-button glyph size a flat toolbar uses.\n */\nconst CHEVRON_SIZE = 16;\n\n/**\n * Duration in milliseconds of the chevron's open/close spin. Matches the\n * framework's shared 200ms indicator transition (see `AccordionIndicator`) so\n * the caret animates at the same cadence as other dropdown / expand affordances.\n */\nconst CHEVRON_SPIN_MS = 200;\n\n/**\n * Construction-time options for {@link SplitButton}.\n *\n * @category Components\n */\nexport interface SplitButtonOptions extends ButtonOptions {\n    /** Items shown in the dropdown opened by the trailing chevron. */\n    menuItems?: MenuItemConfig[];\n}\n\n/**\n * A push button with a trailing dropdown chevron. The main button face fires\n * the primary `\"action\"` event exactly like [`Button`](/api/component/button/classes/Button);\n * clicking the chevron zone instead opens a rebuild-mode\n * [`Menu`](/api/overlay/classes/Menu) of [`MenuItemConfig`](/api/component/container/interfaces/MenuItemConfig)\n * rows anchored under the button.\n *\n * The chevron is a child [`Glyph`](/api/component/display/classes/Glyph) inside\n * Button's single `<button>` element (one DOM element per class is preserved):\n * it rides the content row beside the leading glyph and title. A subtree\n * listener on the chevron catches its click (which the SVG `<use>` retargets to\n * an id-less inner element), while the button face's exact-target `\"action\"`\n * only fires for a click on the `<button>` itself — distinguishing the dropdown\n * gesture from the primary action with no hit-testing coordinates.\n *\n * Dropping a `SplitButton` into a flat [`ToolBar`](/api/component/menubar/classes/ToolBar)\n * flattens it like any other `Button`; the chevron is part of the content row,\n * so it inherits the flat appearance with no extra wiring.\n *\n * @example\n * ```typescript\n * import { SplitButton } from '@jimka/typescript-ui/component/button';\n *\n * const save = new SplitButton('Save', {\n *     menuItems: [\n *         { text: 'Save As…',  action: () => saveAs()  },\n *         { text: 'Save All',  action: () => saveAll() },\n *     ],\n * });\n * save.on('action', () => save());\n * toolbar.addComponent(save);\n * ```\n *\n * @category Components\n */\nclass SplitButton extends Button<SplitButtonOptions> {\n\n    /**\n     * The trailing dropdown chevron — a child of Button's `_content` row.\n     * Clicks on it land on the id-less inner element the SVG `<use>` retargets\n     * to, so they are caught with a *subtree* listener rather than an\n     * exact-target one; that same retargeting is why a chevron click never\n     * matches the button face's exact-target `\"action\"`, which is what\n     * distinguishes the dropdown gesture from the primary action without\n     * hit-testing.\n     */\n    private _chevron!: Glyph;\n\n    /**\n     * Lazily-created rebuild-mode dropdown, reused across opens. `null` until\n     * the chevron is first clicked so a button whose dropdown is never opened\n     * allocates no menu panel.\n     */\n    private _menu: Menu | null = null;\n\n    /**\n     * Cached dropdown items. `declare` rather than initialized: `setMenuItems`\n     * can fire from the super-cascade via `applyOptions`, and an `= []`\n     * initializer would run after `super()` returns and clobber the cascaded\n     * value (the class-field super-cascade trap).\n     */\n    private declare _menuItems: MenuItemConfig[];\n\n    /**\n     * Bound chevron-click handler. Held on the instance so it is a stable\n     * reference for the named-listener contract. Delegates to `_toggleMenu`,\n     * which opens the dropdown or closes it if this chevron already opened it.\n     */\n    private readonly _onChevronClick: () => void = () => { this._toggleMenu(); };\n\n    /**\n     * Constructs a SplitButton.\n     *\n     * @param text - Optional button title.\n     * @param options - Optional options bag, including `menuItems` for the dropdown.\n     */\n    constructor(text?: string, options?: SplitButtonOptions) {\n        super(text, options);\n\n        // Default the cache when neither the super-cascade nor a caller set it.\n        this._menuItems ??= [];\n\n        // Build the chevron after super() so the content row exists. It rides\n        // the row like the leading glyph; appending it last places it after the\n        // title in the single `<button>`. A *subtree* listener catches the click\n        // the SVG `<use>` retargets to its id-less inner element — an\n        // exact-target listener on the glyph would never match it — while that\n        // same retargeting keeps the click off the button face's `\"action\"`.\n        this._chevron = new Glyph(CHEVRON_GLYPH);\n        this._chevron.setPreferredSize(CHEVRON_SIZE, CHEVRON_SIZE);\n        this._chevron.setCursor(\"pointer\");\n        // Button sets its whole `_content` row to `pointer-events: none` so face\n        // clicks fall through to the `<button>`; the chevron inherits that and\n        // would never receive its own click. Re-enable it here — an outer\n        // `<svg>` with `auto` is hittable across its full box (not just the\n        // painted caret pixels) — so the chevron reliably catches the click.\n        this._chevron.setPointerEvents(\"auto\");\n        // Fixed transform transition; `_setChevronOpen` toggles the rotation so\n        // the caret spins between its closed (down) and open (up) states.\n        this._chevron.setTransition(\"transform \" + CHEVRON_SPIN_MS + \"ms ease\");\n\n        this._content.addComponent(this._chevron);\n\n        Event.addSubtreeListener(this._chevron, \"click\", this._onChevronClick);\n    }\n\n    /**\n     * Replaces the dropdown items shown when the chevron is clicked.\n     *\n     * @param items - The new item configurations.\n     *\n     * @returns This button, for method chaining.\n     */\n    setMenuItems(items: MenuItemConfig[]): this {\n        this._menuItems = items;\n        this._options.menuItems = items;\n\n        return this;\n    }\n\n    /**\n     * Returns the current dropdown items.\n     *\n     * @returns The item configurations shown by the chevron dropdown.\n     */\n    getMenuItems(): MenuItemConfig[] {\n        return this._menuItems;\n    }\n\n    /**\n     * Applies a {@link SplitButtonOptions} bag, dispatching `menuItems` after\n     * the inherited Button fields cascade.\n     *\n     * @param options - The options bag carrying the values to apply.\n     *\n     * @returns This button, for method chaining.\n     */\n    protected applyOptions(options: SplitButtonOptions): this {\n        super.applyOptions(options);\n\n        if (options.menuItems !== undefined) {\n            this.setMenuItems(options.menuItems);\n        }\n\n        return this;\n    }\n\n    /**\n     * Re-appends the trailing chevron after the inherited content-row rebuild.\n     * Button's `_rebuildContentRow` empties `_content` wholesale (on a\n     * `setGlyph` / `setDescription` / writing-mode change), which would detach\n     * the chevron; re-appending it last keeps the dropdown affordance trailing\n     * the title across those mutations.\n     *\n     * @remarks Guarded on `_chevron` because the rebuilds dispatched during the\n     * super-cascade run before the constructor builds the chevron; those skip,\n     * and the constructor appends it once afterwards.\n     */\n    protected override _afterRebuildContentRow(): void {\n        if (this._chevron) {\n            this._content.addComponent(this._chevron);\n        }\n    }\n\n    /**\n     * Toggles the rebuild-mode dropdown anchored under the button's bottom-left\n     * corner: opens it, or closes it if this chevron already opened it. No-op\n     * when there is no DOM element yet (the button is unattached) so an anchor\n     * rect can always be read.\n     */\n    private _toggleMenu(): void {\n        const el = this.getElement();\n        if (!el) {\n            return;\n        }\n\n        const rect = DOM.source.getViewportRect(this);\n\n        this._menu ??= new Menu();\n\n        // Optimistically spin the caret to its open state. `toggleFor` excludes\n        // the chevron from the menu's outside-click dismissal and remembers it as\n        // the opener, so a second chevron press closes the dropdown; on that\n        // close the menu's onClose spins the caret back down, correcting this\n        // optimistic spin-up when the press toggled shut rather than open.\n        this._setChevronOpen(true);\n\n        this._menu.toggleFor(\n            this._chevron.getElement(true)!,\n            rect,\n            this._menuItems,\n            () => { this._setChevronOpen(false); }\n        );\n    }\n\n    /**\n     * Rotates the chevron between its closed (caret-down) and open (caret-up)\n     * states, animated by the transform transition set at construction.\n     *\n     * @param open - `true` to point the caret up (dropdown open), `false` down.\n     */\n    private _setChevronOpen(open: boolean): void {\n        this._chevron.setTransform(open ? \"rotate(180deg)\" : \"rotate(0deg)\");\n    }\n}\n\nconst SplitButtonCallable = callable(SplitButton);\ntype SplitButtonCallable = SplitButton;\nexport {\n    SplitButton         as _SplitButton,\n    SplitButtonCallable as SplitButton\n};\n"],"mappings":"kYAcA,EAAM,SAAS,CAAU,EAGzB,IAAM,EAAgB,aAQhB,EAAe,GAsDf,YAAN,cAA0B,CAA2B,CAWjD,SAOA,MAA6B,KAe7B,oBAAqD,CAAE,KAAK,YAAY,CAAG,EAQ3E,YAAY,EAAe,EAA8B,CACrD,MAAM,EAAM,CAAO,EAGnB,KAAK,aAAe,CAAC,EAQrB,KAAK,SAAW,IAAI,EAAM,CAAa,EACvC,KAAK,SAAS,iBAAiB,EAAc,CAAY,EACzD,KAAK,SAAS,UAAU,SAAS,EAMjC,KAAK,SAAS,iBAAiB,MAAM,EAGrC,KAAK,SAAS,cAAc,sBAA0C,EAEtE,KAAK,SAAS,aAAa,KAAK,QAAQ,EAExC,EAAM,mBAAmB,KAAK,SAAU,QAAS,KAAK,eAAe,CACzE,CASA,aAAa,EAA+B,CAIxC,MAHA,MAAK,WAAa,EAClB,KAAK,SAAS,UAAY,EAEnB,IACX,CAOA,cAAiC,CAC7B,OAAO,KAAK,UAChB,CAUA,aAAuB,EAAmC,CAOtD,OANA,MAAM,aAAa,CAAO,EAEtB,EAAQ,YAAc,IAAA,IACtB,KAAK,aAAa,EAAQ,SAAS,EAGhC,IACX,CAaA,yBAAmD,CAC3C,KAAK,UACL,KAAK,SAAS,aAAa,KAAK,QAAQ,CAEhD,CAQA,aAA4B,CAExB,GAAI,CADO,KAAK,WACX,EACD,OAGJ,IAAM,EAAO,EAAI,OAAO,gBAAgB,IAAI,EAE5C,KAAK,QAAU,IAAI,EAOnB,KAAK,gBAAgB,EAAI,EAEzB,KAAK,MAAM,UACP,KAAK,SAAS,WAAW,EAAI,EAC7B,EACA,KAAK,eACC,CAAE,KAAK,gBAAgB,EAAK,CAAG,CACzC,CACJ,CAQA,gBAAwB,EAAqB,CACzC,KAAK,SAAS,aAAa,EAAO,iBAAmB,cAAc,CACvE,CACJ,EAEM,EAAsB,EAAS,WAAW"}
+{"version":3,"file":"button.es.js","names":[],"sources":["../../../src/typescript/lib/component/button/SplitButton.ts"],"sourcesContent":["// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0\n\nimport { Event } from \"~/core/Event.js\";\nimport { Button, ButtonOptions } from \"~/component/button/Button.js\";\nimport { DOM } from \"~/core/DOM.js\";\nimport { Glyph } from \"~/component/display/Glyph.js\";\nimport { Menu } from \"~/overlay/Menu.js\";\nimport { MenuItemConfig } from \"~/component/container/MenuItem.js\";\nimport { callable } from \"~/core/Callable.js\";\nimport { caret_down } from \"~/glyphs/solid/caret_down.js\";\n\n// Register the trailing chevron eagerly at module load — same pattern as\n// `TabCloseButton` registering its `xmark` — so `new SplitButton()` always\n// resolves the chevron without the consumer pre-registering a glyph.\nGlyph.register(caret_down);\n\n/** Registry name of the trailing dropdown chevron glyph. */\nconst CHEVRON_GLYPH = \"caret-down\";\n\n/**\n * Square pixel size of the trailing chevron glyph. Pinned (not\n * line-height-tracked like the leading glyph) so the dropdown affordance stays\n * a constant, comfortably-clickable size across themes; 16px matches the\n * compact icon-button glyph size a flat toolbar uses.\n */\nconst CHEVRON_SIZE = 16;\n\n/**\n * Duration in milliseconds of the chevron's open/close spin. Matches the\n * framework's shared 200ms indicator transition (see `AccordionIndicator`) so\n * the caret animates at the same cadence as other dropdown / expand affordances.\n */\nconst CHEVRON_SPIN_MS = 200;\n\n/**\n * Construction-time options for {@link SplitButton}.\n *\n * @category Components\n */\nexport interface SplitButtonOptions extends ButtonOptions {\n    /** Items shown in the dropdown opened by the trailing chevron. */\n    menuItems?: MenuItemConfig[];\n}\n\n/**\n * A push button with a trailing dropdown chevron. The main button face fires\n * the primary `\"action\"` event exactly like [`Button`](/api/component/button/classes/Button);\n * clicking the chevron zone instead opens a rebuild-mode\n * [`Menu`](/api/overlay/classes/Menu) of [`MenuItemConfig`](/api/component/container/interfaces/MenuItemConfig)\n * rows anchored under the button.\n *\n * The chevron is a child [`Glyph`](/api/component/display/classes/Glyph) inside\n * Button's single `<button>` element (one DOM element per class is preserved):\n * it rides the content row beside the leading glyph and title. A subtree\n * listener on the chevron catches its click (which the SVG `<use>` retargets to\n * an id-less inner element), while the button face's exact-target `\"action\"`\n * only fires for a click on the `<button>` itself — distinguishing the dropdown\n * gesture from the primary action with no hit-testing coordinates.\n *\n * Dropping a `SplitButton` into a flat [`ToolBar`](/api/component/menubar/classes/ToolBar)\n * flattens it like any other `Button`; the chevron is part of the content row,\n * so it inherits the flat appearance with no extra wiring.\n *\n * @example\n * ```typescript\n * import { SplitButton } from '@jimka/typescript-ui/component/button';\n *\n * const save = new SplitButton('Save', {\n *     menuItems: [\n *         { text: 'Save As…',  action: () => saveAs()  },\n *         { text: 'Save All',  action: () => saveAll() },\n *     ],\n * });\n * save.on('action', () => save());\n * toolbar.addComponent(save);\n * ```\n *\n * @category Components\n */\nclass SplitButton extends Button<SplitButtonOptions> {\n\n    /**\n     * The trailing dropdown chevron — a child of Button's `_content` row.\n     * Clicks on it land on the id-less inner element the SVG `<use>` retargets\n     * to, so they are caught with a *subtree* listener rather than an\n     * exact-target one; that same retargeting is why a chevron click never\n     * matches the button face's exact-target `\"action\"`, which is what\n     * distinguishes the dropdown gesture from the primary action without\n     * hit-testing.\n     */\n    private _chevron!: Glyph;\n\n    /**\n     * Lazily-created rebuild-mode dropdown, reused across opens. `null` until\n     * the chevron is first clicked so a button whose dropdown is never opened\n     * allocates no menu panel.\n     */\n    private _menu: Menu | null = null;\n\n    /**\n     * Cached dropdown items. `declare` rather than initialized: `setMenuItems`\n     * can fire from the super-cascade via `applyOptions`, and an `= []`\n     * initializer would run after `super()` returns and clobber the cascaded\n     * value (the class-field super-cascade trap).\n     */\n    private declare _menuItems: MenuItemConfig[];\n\n    /**\n     * Bound chevron-click handler. Held on the instance so it is a stable\n     * reference for the named-listener contract. Delegates to `_toggleMenu`,\n     * which opens the dropdown or closes it if this chevron already opened it.\n     */\n    private readonly _onChevronClick: () => void = () => { this._toggleMenu(); };\n\n    /**\n     * Constructs a SplitButton.\n     *\n     * @param text - Optional button title.\n     * @param options - Optional options bag, including `menuItems` for the dropdown.\n     */\n    constructor(text?: string, options?: SplitButtonOptions) {\n        super(text, options);\n\n        // Default the cache when neither the super-cascade nor a caller set it.\n        this._menuItems ??= [];\n\n        // Build the chevron after super() so the content row exists. It rides\n        // the row like the leading glyph; appending it last places it after the\n        // title in the single `<button>`. A *subtree* listener catches the click\n        // the SVG `<use>` retargets to its id-less inner element — an\n        // exact-target listener on the glyph would never match it — while that\n        // same retargeting keeps the click off the button face's `\"action\"`.\n        this._chevron = new Glyph(CHEVRON_GLYPH);\n        this._chevron.setPreferredSize(CHEVRON_SIZE, CHEVRON_SIZE);\n        this._chevron.setCursor(\"pointer\");\n        // Button sets its whole `_content` row to `pointer-events: none` so face\n        // clicks fall through to the `<button>`; the chevron inherits that and\n        // would never receive its own click. Re-enable it here — an outer\n        // `<svg>` with `auto` is hittable across its full box (not just the\n        // painted caret pixels) — so the chevron reliably catches the click.\n        this._chevron.setPointerEvents(\"auto\");\n        // Fixed transform transition; `_setChevronOpen` toggles the rotation so\n        // the caret spins between its closed (down) and open (up) states.\n        this._chevron.setTransition(\"transform \" + CHEVRON_SPIN_MS + \"ms ease\");\n\n        this._content.addComponent(this._chevron);\n\n        Event.addSubtreeListener(this._chevron, \"click\", this._onChevronClick);\n    }\n\n    /**\n     * Replaces the dropdown items shown when the chevron is clicked.\n     *\n     * @param items - The new item configurations.\n     *\n     * @returns This button, for method chaining.\n     */\n    setMenuItems(items: MenuItemConfig[]): this {\n        this._menuItems = items;\n        this._options.menuItems = items;\n\n        return this;\n    }\n\n    /**\n     * Returns the current dropdown items.\n     *\n     * @returns The item configurations shown by the chevron dropdown.\n     */\n    getMenuItems(): MenuItemConfig[] {\n        return this._menuItems;\n    }\n\n    /**\n     * Applies a {@link SplitButtonOptions} bag, dispatching `menuItems` after\n     * the inherited Button fields cascade.\n     *\n     * @param options - The options bag carrying the values to apply.\n     *\n     * @returns This button, for method chaining.\n     */\n    protected applyOptions(options: SplitButtonOptions): this {\n        super.applyOptions(options);\n\n        if (options.menuItems !== undefined) {\n            this.setMenuItems(options.menuItems);\n        }\n\n        return this;\n    }\n\n    /**\n     * Re-appends the trailing chevron after the inherited content-row rebuild.\n     * Button's `_rebuildContentRow` empties `_content` wholesale (on a\n     * `setGlyph` / `setDescription` / writing-mode change), which would detach\n     * the chevron; re-appending it last keeps the dropdown affordance trailing\n     * the title across those mutations.\n     *\n     * @remarks Guarded on `_chevron` because the rebuilds dispatched during the\n     * super-cascade run before the constructor builds the chevron; those skip,\n     * and the constructor appends it once afterwards.\n     */\n    protected override _afterRebuildContentRow(): void {\n        if (this._chevron) {\n            this._content.addComponent(this._chevron);\n        }\n    }\n\n    /**\n     * Toggles the rebuild-mode dropdown anchored under the button's bottom-left\n     * corner: opens it, or closes it if this chevron already opened it. No-op\n     * when there is no DOM element yet (the button is unattached) so an anchor\n     * rect can always be read.\n     */\n    private _toggleMenu(): void {\n        const el = this.getElement();\n        if (!el) {\n            return;\n        }\n\n        const rect = DOM.source.getViewportRect(this);\n\n        this._menu ??= new Menu();\n\n        // Optimistically spin the caret to its open state. `toggleFor` excludes\n        // the chevron from the menu's outside-click dismissal and remembers it as\n        // the opener, so a second chevron press closes the dropdown; on that\n        // close the menu's onClose spins the caret back down, correcting this\n        // optimistic spin-up when the press toggled shut rather than open.\n        this._setChevronOpen(true);\n\n        this._menu.toggleFor(\n            this._chevron.getElement(true)!,\n            rect,\n            this._menuItems,\n            () => { this._setChevronOpen(false); }\n        );\n    }\n\n    /**\n     * Rotates the chevron between its closed (caret-down) and open (caret-up)\n     * states, animated by the transform transition set at construction.\n     *\n     * @param open - `true` to point the caret up (dropdown open), `false` down.\n     */\n    private _setChevronOpen(open: boolean): void {\n        this._chevron.setTransform(open ? \"rotate(180deg)\" : \"rotate(0deg)\");\n    }\n}\n\nconst SplitButtonCallable = callable(SplitButton);\ntype SplitButtonCallable = SplitButton;\nexport {\n    SplitButton         as _SplitButton,\n    SplitButtonCallable as SplitButton\n};\n"],"mappings":"6XAcA,EAAM,SAAS,CAAU,EAGzB,IAAM,EAAgB,aAQhB,EAAe,GAsDf,YAAN,cAA0B,CAA2B,CAWjD,SAOA,MAA6B,KAe7B,oBAAqD,CAAE,KAAK,YAAY,CAAG,EAQ3E,YAAY,EAAe,EAA8B,CACrD,MAAM,EAAM,CAAO,EAGnB,KAAK,aAAe,CAAC,EAQrB,KAAK,SAAW,IAAI,EAAM,CAAa,EACvC,KAAK,SAAS,iBAAiB,EAAc,CAAY,EACzD,KAAK,SAAS,UAAU,SAAS,EAMjC,KAAK,SAAS,iBAAiB,MAAM,EAGrC,KAAK,SAAS,cAAc,sBAA0C,EAEtE,KAAK,SAAS,aAAa,KAAK,QAAQ,EAExC,EAAM,mBAAmB,KAAK,SAAU,QAAS,KAAK,eAAe,CACzE,CASA,aAAa,EAA+B,CAIxC,MAHA,MAAK,WAAa,EAClB,KAAK,SAAS,UAAY,EAEnB,IACX,CAOA,cAAiC,CAC7B,OAAO,KAAK,UAChB,CAUA,aAAuB,EAAmC,CAOtD,OANA,MAAM,aAAa,CAAO,EAEtB,EAAQ,YAAc,IAAA,IACtB,KAAK,aAAa,EAAQ,SAAS,EAGhC,IACX,CAaA,yBAAmD,CAC3C,KAAK,UACL,KAAK,SAAS,aAAa,KAAK,QAAQ,CAEhD,CAQA,aAA4B,CAExB,GAAI,CADO,KAAK,WACX,EACD,OAGJ,IAAM,EAAO,EAAI,OAAO,gBAAgB,IAAI,EAE5C,KAAK,QAAU,IAAI,EAOnB,KAAK,gBAAgB,EAAI,EAEzB,KAAK,MAAM,UACP,KAAK,SAAS,WAAW,EAAI,EAC7B,EACA,KAAK,eACC,CAAE,KAAK,gBAAgB,EAAK,CAAG,CACzC,CACJ,CAQA,gBAAwB,EAAqB,CACzC,KAAK,SAAS,aAAa,EAAO,iBAAmB,cAAc,CACvE,CACJ,EAEM,EAAsB,EAAS,WAAW"}