cx 26.7.6 → 26.9.0

package/build/charts/axis/NumericScale.d.ts

@@ -0,0 +1,59 @@
+import { Stack } from "./Stack";
+export declare class NumericScale {
+    min: number;
+    max: number;
+    snapToTicks: number;
+    tickDivisions: number[][];
+    minLabelDistance: number;
+    minLabelTickSize: number;
+    minTickDistance: number;
+    minTickStep: number;
+    tickSizes: number[];
+    normalized: boolean;
+    inverted: boolean;
+    minValue?: number;
+    maxValue?: number;
+    minValuePadded: number;
+    maxValuePadded: number;
+    stacks: Record<string, Stack>;
+    lowerDeadZone: number;
+    upperDeadZone: number;
+    origin: number;
+    scale: {
+        factor: number;
+        min: number;
+        max: number;
+        minPadding: number;
+        maxPadding: number;
+    };
+    a: number;
+    b: number;
+    shouldUpdate: boolean;
+    reset(min: number, max: number, snapToTicks: number, tickDivisions: number[][], minTickDistance: number, minTickStep: number, minLabelDistance: number, minLabelTickSize: number, normalized: boolean, inverted: boolean, lowerDeadZone: number, upperDeadZone: number): void;
+    map(v: number, offset?: number): number;
+    decodeValue(n: number): number;
+    encodeValue(v: number): number;
+    constrainValue(v: number): number;
+    trackValue(v: number, offset?: number, constrain?: boolean): number;
+    hash(): any;
+    isSame(x: any): boolean;
+    measure(a: number, b: number): void;
+    getScale(tickSizes?: number[]): {
+        factor: number;
+        min: number;
+        max: number;
+        minPadding: number;
+        maxPadding: number;
+    };
+    acknowledge(value: number, width?: number, offset?: number): void;
+    getStack(name: string): Stack;
+    stacknowledge(name: string, ordinal: any, value: any): any;
+    stack(name: string, ordinal: any, value: any): number | null;
+    findTickSize(minPxDist: number): number | undefined;
+    getTickSizes(): number[];
+    calculateTicks(): void;
+    getTicks(tickSizes: number[]): number[][];
+    mapGridlines(): number[];
+    book(): void;
+}
+//# sourceMappingURL=NumericScale.d.ts.map

package/build/charts/axis/NumericScale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumericScale.d.ts","sourceRoot":"","sources":["../../../src/charts/axis/NumericScale.ts"],"names":[],"mappings":"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"}

package/build/charts/axis/NumericScale.js

@@ -0,0 +1,254 @@
+import { Stack } from "./Stack";
+import { isNumber } from "../../util/isNumber";
+import { Console } from "../../util/Console";
+export class NumericScale {
+    min;
+    max;
+    snapToTicks;
+    tickDivisions;
+    minLabelDistance;
+    minLabelTickSize;
+    minTickDistance;
+    minTickStep;
+    tickSizes;
+    normalized;
+    inverted;
+    minValue;
+    maxValue;
+    minValuePadded;
+    maxValuePadded;
+    stacks;
+    lowerDeadZone;
+    upperDeadZone;
+    origin;
+    scale;
+    a;
+    b;
+    shouldUpdate;
+    reset(min, max, snapToTicks, tickDivisions, minTickDistance, minTickStep, minLabelDistance, minLabelTickSize, normalized, inverted, lowerDeadZone, upperDeadZone) {
+        this.min = min;
+        this.max = max;
+        this.snapToTicks = snapToTicks;
+        this.tickDivisions = tickDivisions;
+        this.minLabelDistance = minLabelDistance;
+        this.minLabelTickSize = minLabelTickSize;
+        this.minTickDistance = minTickDistance;
+        this.minTickStep = minTickStep;
+        this.tickSizes = [];
+        this.normalized = normalized;
+        this.inverted = inverted;
+        delete this.minValue;
+        delete this.maxValue;
+        this.stacks = {};
+        this.lowerDeadZone = lowerDeadZone || 0;
+        this.upperDeadZone = upperDeadZone || 0;
+    }
+    map(v, offset = 0) {
+        return this.origin + (v + offset - this.scale.min + this.scale.minPadding) * this.scale.factor;
+    }
+    decodeValue(n) {
+        return n;
+    }
+    encodeValue(v) {
+        return v;
+    }
+    constrainValue(v) {
+        return Math.max(this.scale.min, Math.min(this.scale.max, v));
+    }
+    trackValue(v, offset = 0, constrain = false) {
+        let value = (v - this.origin) / this.scale.factor - offset + this.scale.min - this.scale.minPadding;
+        if (constrain)
+            value = this.constrainValue(value);
+        return value;
+    }
+    hash() {
+        let r = {
+            origin: this.origin,
+            factor: this.scale.factor,
+            min: this.scale.min,
+            max: this.scale.max,
+            minPadding: this.scale.minPadding,
+            maxPadding: this.scale.maxPadding,
+        };
+        r.stacks = Object.keys(this.stacks)
+            .map((s) => this.stacks[s].info?.join(","))
+            .join(":");
+        return r;
+    }
+    isSame(x) {
+        let hash = this.hash();
+        let same = x && !Object.keys(hash).some((k) => x[k] !== hash[k]);
+        this.shouldUpdate = !same;
+        return same;
+    }
+    measure(a, b) {
+        this.a = a;
+        this.b = b;
+        if (this.minValue != null && this.min == null)
+            this.min = this.minValue;
+        if (this.maxValue != null && this.max == null)
+            this.max = this.maxValue;
+        for (let s in this.stacks) {
+            let info = this.stacks[s].measure(this.normalized);
+            let [min, max] = info;
+            if (this.min == null || min < this.min)
+                this.min = min;
+            if (this.max == null || max > this.max)
+                this.max = max;
+            this.stacks[s].info = info;
+        }
+        if (this.min == null)
+            this.min = 0;
+        if (this.max == null)
+            this.max = this.normalized ? 1 : 100;
+        if (this.min == this.max) {
+            if (this.min == 0) {
+                this.min = -1;
+                this.max = 1;
+            }
+            else {
+                let delta = Math.abs(this.min) * 0.1;
+                this.min -= delta;
+                this.max += delta;
+            }
+        }
+        this.origin = this.inverted ? this.b : this.a;
+        this.scale = this.getScale();
+        this.calculateTicks();
+    }
+    getScale(tickSizes) {
+        let { min, max } = this;
+        let smin = min;
+        let smax = max;
+        let tickSize;
+        if (tickSizes && isNumber(this.snapToTicks) && tickSizes.length > 0) {
+            tickSize = tickSizes[Math.min(tickSizes.length - 1, this.snapToTicks)];
+            smin = Math.floor(smin / tickSize) * tickSize;
+            smax = Math.ceil(smax / tickSize) * tickSize;
+        }
+        else {
+            if (this.minValue === min)
+                smin = this.minValuePadded;
+            if (this.maxValue === max)
+                smax = this.maxValuePadded;
+        }
+        let minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded) : 0;
+        let maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded - smax) : 0;
+        let sign = this.b > this.a ? 1 : -1;
+        let factor = smin < smax
+            ? (Math.abs(this.b - this.a) - this.lowerDeadZone - this.upperDeadZone) /
+                (smax - smin + minPadding + maxPadding)
+            : 0;
+        if (factor < 0)
+            factor = 0;
+        if (factor > 0 && (this.lowerDeadZone > 0 || this.upperDeadZone > 0)) {
+            while (factor * (min - smin) < this.lowerDeadZone)
+                smin -= this.lowerDeadZone / factor;
+            while (factor * (smax - max) < this.upperDeadZone)
+                smax += this.upperDeadZone / factor;
+            if (tickSize > 0 && isNumber(this.snapToTicks)) {
+                smin = Math.floor(smin / tickSize) * tickSize;
+                smax = Math.ceil(smax / tickSize) * tickSize;
+                minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded) : 0;
+                maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded - smax) : 0;
+            }
+            factor = smin < smax ? Math.abs(this.b - this.a) / (smax - smin + minPadding + maxPadding) : 0;
+        }
+        return {
+            factor: sign * (this.inverted ? -factor : factor),
+            min: smin,
+            max: smax,
+            minPadding,
+            maxPadding,
+        };
+    }
+    acknowledge(value, width = 0, offset = 0) {
+        if (value == null)
+            return;
+        if (this.minValue == null || value < this.minValue) {
+            this.minValue = value;
+            this.minValuePadded = value + offset - width / 2;
+        }
+        if (this.maxValue == null || value > this.maxValue) {
+            this.maxValue = value;
+            this.maxValuePadded = value + offset + width / 2;
+        }
+    }
+    getStack(name) {
+        let s = this.stacks[name];
+        if (!s)
+            s = this.stacks[name] = new Stack();
+        return s;
+    }
+    stacknowledge(name, ordinal, value) {
+        return this.getStack(name).acknowledge(ordinal, value);
+    }
+    stack(name, ordinal, value) {
+        let v = this.getStack(name).stack(ordinal, value);
+        return v != null ? this.map(v) : null;
+    }
+    findTickSize(minPxDist) {
+        return this.tickSizes.find((a) => a >= this.minLabelTickSize && a * Math.abs(this.scale.factor) >= minPxDist);
+    }
+    getTickSizes() {
+        return this.tickSizes;
+    }
+    calculateTicks() {
+        let dist = this.minLabelDistance / Math.abs(this.scale.factor);
+        let unit = Math.pow(10, Math.floor(Math.log10(dist)));
+        let bestLabelDistance = Infinity;
+        let bestTicks = [];
+        let bestScale = this.scale;
+        for (let i = 0; i < this.tickDivisions.length; i++) {
+            let divs = this.tickDivisions[i];
+            let tickSizes = divs.filter((ts) => ts >= this.minTickStep).map((ts) => ts * unit);
+            let scale = this.getScale(tickSizes);
+            tickSizes.forEach((size, level) => {
+                let labelDistance = size * Math.abs(scale.factor);
+                if (labelDistance >= this.minLabelDistance && labelDistance < bestLabelDistance) {
+                    bestScale = scale;
+                    bestTicks = tickSizes;
+                    bestLabelDistance = labelDistance;
+                }
+            });
+        }
+        this.scale = bestScale;
+        this.tickSizes = bestTicks.filter((ts) => ts >= this.minTickStep && ts * Math.abs(bestScale.factor) >= this.minTickDistance);
+        if (this.tickSizes.length > 0) {
+            let max = this.tickSizes[this.tickSizes.length - 1];
+            this.tickSizes.push(2 * max);
+            this.tickSizes.push(5 * max);
+            this.tickSizes.push(10 * max);
+            let min = this.tickSizes[0];
+            let minDist = min * Math.abs(bestScale.factor);
+            if (min / 10 >= this.minTickStep && minDist / 10 >= this.minTickDistance)
+                this.tickSizes.splice(0, 0, min / 10);
+            else if (min / 5 >= this.minTickStep && minDist / 5 >= this.minTickDistance)
+                this.tickSizes.splice(0, 0, min / 5);
+            else if (min / 2 >= this.minTickStep && minDist / 2 >= this.minTickDistance)
+                this.tickSizes.splice(0, 0, min / 2);
+        }
+    }
+    getTicks(tickSizes) {
+        return tickSizes.map((size) => {
+            let start = Math.ceil((this.scale.min - this.scale.minPadding) / size);
+            let end = Math.floor((this.scale.max + this.scale.maxPadding) / size);
+            let result = [];
+            for (let i = start; i <= end; i++)
+                result.push(i * size + 0);
+            return result;
+        });
+    }
+    mapGridlines() {
+        let size = this.tickSizes[0];
+        let start = Math.ceil((this.scale.min - this.scale.minPadding) / size);
+        let end = Math.floor((this.scale.max + this.scale.maxPadding) / size);
+        let result = [];
+        for (let i = start; i <= end; i++)
+            result.push(this.map(i * size));
+        return result;
+    }
+    book() {
+        Console.warn("NumericAxis does not support the autoSize flag for column and bar graphs.");
+    }
+}

package/build/jsx-dev-runtime.d.ts

@@ -1,5 +1,6 @@
 import { jsx } from "./jsx-runtime";
 export declare const jsxDEV: typeof jsx;
 export declare const jsxsDEV: typeof jsx;
-export { Fragment, JSX } from "./jsx-runtime";
+export { Fragment } from "./jsx-runtime";
+export type { JSX } from "./jsx-runtime";
 //# sourceMappingURL=jsx-dev-runtime.d.ts.map

package/build/jsx-dev-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAQ,MAAM,eAAe,CAAC;AAE1C,eAAO,MAAM,MAAM,YAAM,CAAC;AAC1B,eAAO,MAAM,OAAO,YAAO,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAQ,MAAM,eAAe,CAAC;AAE1C,eAAO,MAAM,MAAM,YAAM,CAAC;AAC1B,eAAO,MAAM,OAAO,YAAO,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC"}

package/build/svg/Svg.d.ts

@@ -1,4 +1,5 @@
 /** @jsxImportSource react */
+import { StringProp } from "../ui/Prop";
 import { RenderingContext } from "../ui/RenderingContext";
 import { BoundedObject, BoundedObjectConfig, BoundedObjectInstance, SvgRenderingContext } from "./BoundedObject";
 import { Rect } from "./util/Rect";
@@ -13,6 +14,13 @@ interface SvgInstance extends BoundedObjectInstance {
     clipRectId?: number;
 }
 export interface SvgConfig extends BoundedObjectConfig {
+    /** ARIA role for the `svg` element. Defaults to `img` when `ariaLabel` is set. */
+    role?: StringProp;
+    /**
+     * Accessible name for the `svg` element. Setting it announces the drawing as a single graphic
+     * instead of as its individual shapes, which is also how a tagged PDF export tags it.
+     */
+    ariaLabel?: StringProp;
     /** Set to `true` to automatically calculate width based on the measured height and `aspectRatio`. */
     autoWidth?: boolean;
     /** Set to `true` to automatically calculate height based on the measured width and `aspectRatio`. */
@@ -39,6 +47,7 @@ export declare class Svg extends BoundedObject<SvgConfig, SvgInstance> {
     aspectRatio?: number;
     onWheelActive?: (e: WheelEvent, instance: SvgInstance) => void;
     constructor(config?: SvgConfig);
+    declareData(...args: any[]): void;
     initState(context: RenderingContext, instance: SvgInstance): void;
     explore(context: SvgRenderingContext, instance: SvgInstance): void;
     exploreCleanup(context: SvgRenderingContext, instance: SvgInstance): void;

package/build/svg/Svg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Svg.d.ts","sourceRoot":"","sources":["../../src/svg/Svg.tsx"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,UAAU,WAAY,SAAQ,qBAAqB;IAChD,KAAK,EAAE;QACJ,IAAI,EAAE;YACH,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SACjB,CAAC;KACJ,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAU,SAAQ,mBAAmB;IACnD,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qGAAqG;IACrG,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACvD,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1D,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACrD,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7D;AAED,qBAAa,GAAI,SAAQ,aAAa,CAAC,SAAS,EAAE,WAAW,CAAC;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;gBAE3D,MAAM,CAAC,EAAE,SAAS;IAI9B,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW;IAQ1D,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAK3D,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAIlE,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAqB3D,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAMlE,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM;CAkBtE"}
+{"version":3,"file":"Svg.d.ts","sourceRoot":"","sources":["../../src/svg/Svg.tsx"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjH,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,UAAU,WAAY,SAAQ,qBAAqB;IAChD,KAAK,EAAE;QACJ,IAAI,EAAE;YACH,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SACjB,CAAC;KACJ,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAU,SAAQ,mBAAmB;IACnD,kFAAkF;IAClF,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,UAAU,CAAC;IAEvB,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qGAAqG;IACrG,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACvD,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1D,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACzD,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACxD,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACrD,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7D;AAED,qBAAa,GAAI,SAAQ,aAAa,CAAC,SAAS,EAAE,WAAW,CAAC;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;gBAE3D,MAAM,CAAC,EAAE,SAAS;IAI9B,WAAW,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAU1B,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW;IAQ1D,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAK3D,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAIlE,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAqB3D,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW;IAMlE,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM;CAkBtE"}

package/build/svg/Svg.js

@@ -8,6 +8,12 @@ export class Svg extends BoundedObject {
     constructor(config) {
         super(config);
     }
+    declareData(...args) {
+        return super.declareData({
+            role: undefined,
+            ariaLabel: undefined,
+        }, ...args);
+    }
     initState(context, instance) {
         const size = {
             width: 0,
@@ -70,6 +76,8 @@ class SvgComponent extends VDOM.Component {
     render() {
         const { instance, data, size, children, eventHandlers } = this.props;
         const { widget } = instance;
+        // An unnamed drawing is left alone: `role="img"` would hide its text and put nothing in its place.
+        const role = data.role ?? (data.ariaLabel ? "img" : undefined);
         const defs = [];
         for (const k in instance.clipRects) {
             let cr = instance.clipRects[k];
@@ -89,7 +97,7 @@ class SvgComponent extends VDOM.Component {
         //parent div is needed because clientWidth doesn't work on the svg element in FF
         return (_jsx("div", { ref: (el) => {
                 this.el = el;
-            }, className: data.classNames, style: style, ...eventHandlers, children: size.width > 0 && size.height > 0 && (_jsxs("svg", { children: [_jsx("defs", { children: defs }), children] })) }));
+            }, className: data.classNames, style: style, ...eventHandlers, children: size.width > 0 && size.height > 0 && (_jsxs("svg", { role: role, "aria-label": data.ariaLabel, children: [_jsx("defs", { children: defs }), children] })) }));
     }
     onResize() {
         const { instance } = this.props;

package/build/ui/index.d.ts

@@ -38,6 +38,7 @@ export * from "./tpl";
 export * from "./expr";
 export * from "./exprHelpers";
 import { computable } from "../data/computable";
-import { createAccessorModelProxy, createModel, AccessorChain } from "../data/createAccessorModelProxy";
-export { computable, createAccessorModelProxy, createModel, AccessorChain };
+import { createAccessorModelProxy, createModel } from "../data/createAccessorModelProxy";
+export { computable, createAccessorModelProxy, createModel };
+export type { AccessorChain } from "../data/createAccessorModelProxy";
 //# sourceMappingURL=index.d.ts.map

package/build/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAE5B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAE/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACJ,wBAAwB,EACxB,WAAW,EACX,aAAa,EACf,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kCAAkC,CAAC;AACjD,cAAc,aAAa,CAAC;AAE5B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAE/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAEhC,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,WAAW,EAAE,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC"}

package/build/ui/index.js

@@ -39,5 +39,5 @@ export * from "./expr";
 export * from "./exprHelpers";
 //re-export computable here
 import { computable } from "../data/computable";
-import { createAccessorModelProxy, createModel, } from "../data/createAccessorModelProxy";
+import { createAccessorModelProxy, createModel } from "../data/createAccessorModelProxy";
 export { computable, createAccessorModelProxy, createModel };

package/build/util/DOM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DOM.d.ts","sourceRoot":"","sources":["../../src/util/DOM.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACzG,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAa5F,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AAC9G,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAWjG,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;AAC7G,wBAAgB,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AASjG,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;AAC5G,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;AAKxG,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAElD;AAID,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,WAAW,CAS1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAElE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAExE"}
+{"version":3,"file":"DOM.d.ts","sourceRoot":"","sources":["../../src/util/DOM.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AACzG,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAa5F,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;AAC9G,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AAWjG,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;AAC7G,wBAAgB,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,GAAG,IAAI,CAAC;AASjG,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;AAC5G,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;AAKxG,wBAAgB,SAAS,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAE9C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAElD;AAID,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,WAAW,CAS1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAElE;AAMD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAQxE"}

package/build/util/DOM.js

@@ -1,4 +1,5 @@
 import { isNumber } from "../util/isNumber";
+import { getActiveElement } from "./getActiveElement";
 export function findFirst(el, condition) {
     if (condition(el))
         return el;
@@ -33,10 +34,10 @@ export function closestParent(el, condition) {
     return el && closest(el.parentElement, condition);
 }
 export function isFocused(el) {
-    return document.activeElement == el;
+    return getActiveElement() == el;
 }
 export function isFocusedDeep(el) {
-    return document.activeElement == el || (!!document.activeElement && el.contains(document.activeElement));
+    return isSelfOrDescendant(el, getActiveElement());
 }
 const focusableWithoutTabIndex = ["INPUT", "SELECT", "TEXTAREA", "A", "BUTTON"];
 export function isFocusable(el) {
@@ -54,11 +55,22 @@ export function isFocusable(el) {
  * @returns {Element}
  */
 export function getFocusedElement() {
-    return document.activeElement;
+    return getActiveElement();
 }
 export function isDescendant(el, descEl) {
     return el.contains(descEl);
 }
+//`descEl` may live in a different document than `el` (e.g. focus is inside a same-origin
+//iframe) - Node.contains never crosses document boundaries, so walk out through each
+//frame's <iframe> element in its parent document until we either cross into el's document
+//or run out of ancestor frames.
 export function isSelfOrDescendant(el, descEl) {
-    return el == descEl || el.contains(descEl);
+    let node = descEl;
+    while (node) {
+        if (el == node || el.contains(node))
+            return true;
+        let win = node.ownerDocument?.defaultView;
+        node = win?.frameElement;
+    }
+    return false;
 }

package/build/util/getActiveElement.d.ts

@@ -1,2 +1,2 @@
-export declare function getActiveElement(): Element;
+export declare function getActiveElement(doc?: Document): Element;
 //# sourceMappingURL=getActiveElement.d.ts.map

package/build/util/getActiveElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getActiveElement.d.ts","sourceRoot":"","sources":["../../src/util/getActiveElement.ts"],"names":[],"mappings":"AACA,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}
+{"version":3,"file":"getActiveElement.d.ts","sourceRoot":"","sources":["../../src/util/getActiveElement.ts"],"names":[],"mappings":"AACA,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,QAAmB,GAAG,OAAO,CAgBlE"}

package/build/util/getActiveElement.js

@@ -1,4 +1,16 @@
 //IE sometimes returns null while other browsers always return document.body.
-export function getActiveElement() {
-    return document.activeElement ?? document.body;
+export function getActiveElement(doc = document) {
+    let active = doc.activeElement ?? doc.body;
+    //when focus is inside a same-origin iframe, `doc.activeElement` only reports the
+    //<iframe> element itself - drill into its own document to find the element that's
+    //actually focused there (recursively, in case of nested iframes)
+    if (active && active.tagName === "IFRAME") {
+        const iframe = active;
+        let frameDoc = iframe.contentDocument;
+        if (frameDoc) {
+            const inner = getActiveElement(frameDoc);
+            return inner ?? active;
+        }
+    }
+    return active;
 }

package/build/widgets/form/TextArea.d.ts

@@ -3,6 +3,10 @@ import { TextField, TextFieldConfig } from "./TextField";
 import { FieldInstance } from "./Field";
 import type { RenderingContext } from "../../ui/RenderingContext";
 import { NumberProp } from "../../ui/Prop";
+/**
+ * `trim` applies to the commit that ends the edit, not to intermediate `input` commits. Whitespace
+ * inside the text is never touched.
+ */
 export interface TextAreaConfig extends TextFieldConfig {
     /** Specifies the number of visible lines. */
     rows?: NumberProp;

package/build/widgets/form/TextArea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextArea.d.ts","sourceRoot":"","sources":["../../../src/widgets/form/TextArea.tsx"],"names":[],"mappings":"AAAA,6BAA6B;AAG7B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,aAAa,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAalE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,cAAe,SAAQ,eAAe;IACpD,6CAA6C;IAC7C,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,QAAS,SAAQ,SAAS,CAAC,cAAc,CAAC;gBACxC,MAAM,CAAC,EAAE,cAAc;IAInC,WAAW,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAMrD,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI;IAM/E,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS;IAYvG,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,SAAS;CAGpG"}
+{"version":3,"file":"TextArea.d.ts","sourceRoot":"","sources":["../../../src/widgets/form/TextArea.tsx"],"names":[],"mappings":"AAAA,6BAA6B;AAG7B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAmB,aAAa,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAclE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACpD,6CAA6C;IAC7C,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,QAAS,SAAQ,SAAS,CAAC,cAAc,CAAC;gBACxC,MAAM,CAAC,EAAE,cAAc;IAInC,WAAW,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI;IAMrD,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,IAAI;IAM/E,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS;IAYvG,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,SAAS;CAGpG"}

package/build/widgets/form/TextArea.js

@@ -8,6 +8,7 @@ import { stopPropagation } from "../../util/eventCallbacks";
 import { KeyCode } from "../../util/KeyCode";
 import { autoFocus } from "../autoFocus";
 import { getActiveElement } from "../../util/getActiveElement";
+import { isString } from "../../util/isString";
 export class TextArea extends TextField {
     constructor(config) {
         super(config);
@@ -103,8 +104,13 @@ class Input extends VDOM.Component {
             });
         }
         if (instance.widget.reactOn.indexOf(change) != -1) {
-            let value = inputValue || widget.emptyValue;
+            // Trimming on `input` would strip whitespace the user is still typing, so a trailing
+            // newline could never be entered.
+            let text = change != "input" && data.trim && isString(inputValue) ? inputValue.trim() : inputValue;
+            let value = text || widget.emptyValue;
             instance.set("value", value);
+            if (this.input && text != inputValue)
+                this.input.value = text;
         }
     }
     onFocus() {

package/build/widgets/grid/Grid.d.ts

@@ -13,10 +13,11 @@ import type { KeySelection } from "../../ui/selection/KeySelection";
 import type { PropertySelection } from "../../ui/selection/PropertySelection";
 import { WidgetConfig } from "../../ui/Widget";
 import { DragEvent, DragEndEvent } from "../drag-drop/ops";
-import { GridRow, GridRowConfig, GridRowInstance } from "./GridRow";
+import { GridRow, GridRowInstance } from "./GridRow";
+import type { GridRowConfig } from "./GridRow";
 import { CreateConfig } from "../../util";
 import type { TreeAdapter } from "../../ui/adapter/TreeAdapter";
-export { GridRowConfig };
+export type { GridRowConfig };
 export type GridFetchRecordsResult<T> = T[] | {
     records: T[];
     lastPage?: boolean;
@@ -151,7 +152,16 @@ export interface GridColumnConfig {
     children?: ChildNode | ChildNode[];
     key?: string;
     pad?: boolean;
+    /**
+     * Record field used for sorting instead of `field` or the displayed `value`.
+     * Use it when the column displays a computed value but should sort by raw data.
+     * Sort key precedence: `sortValue` > `sortField` > `value` > `field`.
+     */
     sortField?: string;
+    /**
+     * Selector (binding, template, expression or computable) used for sorting instead
+     * of `field`, `sortField` or the displayed `value`. Takes the highest precedence.
+     */
     sortValue?: Prop<any>;
     style?: StyleProp;
     trimWhitespace?: boolean;