@cratis/scene.blueprint.default 4.32.0 → 4.33.0

package/dist/esm/foundation/SavedViewsMenu.js

@@ -0,0 +1,196 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { useMemo, useState, useId, useRef, useEffect } from 'react';
+import { useValueOutput } from '@cratis/scene.react';
+import { readComponentState, ComponentState } from './ComponentState.js';
+import { FoundationIcon } from './FoundationIcon.js';
+import { readFoundationStrings } from './foundationStrings.js';
+import { readPermissionRule, PermissionRule } from './PermissionRule.js';
+import { FoundationFrame } from './StateFrame.js';
+import { readOptionalString } from '../shell/elementProperties.js';
+import { readViews } from './viewModel.js';
+
+/** The output a menu action is published under: `save` or `manage`, which the host acts on. */ const savedViewActionOutput = 'action';
+/**
+ * The `savedViewsMenu` component: a list's saved views as a menu button, with the current view as its label.
+ *
+ * `views` are the choices (id, label, description) and `activeView` the one in force. Choosing a view publishes its id as the `value`
+ * output and runs the behaviors attached to the element, so a screen binds its query to the view. The menu follows the ARIA menu
+ * pattern: arrows, Home and End move, Enter chooses, Escape closes and returns focus to the button. "Save current view" and
+ * "Manage views" publish `save` or `manage` on the `action` output, and each honours its own permission rule (`savePermission`,
+ * `managePermission`): hidden, or disabled with the reason.
+ */ function SavedViewsMenu({ element, interactions, bindingOutputs }) {
+    const views = useMemo(()=>readViews(element.properties.views), [
+        element.properties.views
+    ]);
+    const suppliedActive = readOptionalString(element, 'activeView') ?? views[0]?.id;
+    const [active, setActive] = useState(suppliedActive);
+    const [open, setOpen] = useState(false);
+    const strings = readFoundationStrings(element);
+    const state = readComponentState(element, views.length > 0);
+    const menuId = useId();
+    const button = useRef(null);
+    const menu = useRef(null);
+    const rules = {
+        save: readPermissionRule(element, 'savePermission'),
+        manage: readPermissionRule(element, 'managePermission')
+    };
+    useEffect(()=>setActive(suppliedActive), [
+        suppliedActive
+    ]);
+    useValueOutput(bindingOutputs, active);
+    useEffect(()=>{
+        if (open) menu.current?.querySelector('[role^="menuitem"]:not([aria-disabled="true"])')?.focus();
+    }, [
+        open
+    ]);
+    const items = ()=>Array.from(menu.current?.querySelectorAll('[role^="menuitem"]:not([aria-disabled="true"])') ?? []);
+    const move = (event)=>{
+        const entries = items();
+        const index = entries.indexOf(document.activeElement);
+        const target = event.key === 'ArrowDown' ? (index + 1) % entries.length : event.key === 'ArrowUp' ? (index - 1 + entries.length) % entries.length : event.key === 'Home' ? 0 : event.key === 'End' ? entries.length - 1 : -1;
+        if (target >= 0) {
+            event.preventDefault();
+            entries[target]?.focus();
+        }
+        if (event.key === 'Escape') {
+            setOpen(false);
+            button.current?.focus();
+        }
+        if (event.key === 'Tab') setOpen(false);
+    };
+    const choose = (id)=>{
+        setActive(id);
+        setOpen(false);
+        button.current?.focus();
+        interactions?.onSelect?.();
+    };
+    const run = (action)=>{
+        bindingOutputs?.setOutput(savedViewActionOutput, action);
+        setOpen(false);
+        button.current?.focus();
+        interactions?.onClick?.({
+            stopPropagation: ()=>undefined
+        });
+    };
+    const label = views.find((view)=>view.id === active)?.label ?? strings.viewsDefault;
+    return /*#__PURE__*/ jsx(FoundationFrame, {
+        element: element,
+        interactions: interactions,
+        name: "saved-views",
+        state: state,
+        skeleton: [
+            45
+        ],
+        children: state !== ComponentState.Loading && /*#__PURE__*/ jsxs("div", {
+            className: "foundation-popover-host",
+            children: [
+                /*#__PURE__*/ jsxs("button", {
+                    ref: button,
+                    type: "button",
+                    className: "foundation-button",
+                    "data-emphasis": "secondary",
+                    "aria-haspopup": "menu",
+                    "aria-expanded": open,
+                    "aria-controls": menuId,
+                    onClick: ()=>setOpen(!open),
+                    onKeyDown: (event)=>{
+                        if (event.key === 'ArrowDown' && !open) {
+                            event.preventDefault();
+                            setOpen(true);
+                        }
+                    },
+                    children: [
+                        /*#__PURE__*/ jsx("span", {
+                            className: "foundation-visually-hidden",
+                            children: `${strings.viewsLabel}: `
+                        }),
+                        /*#__PURE__*/ jsx("span", {
+                            children: label
+                        }),
+                        /*#__PURE__*/ jsx(FoundationIcon, {
+                            name: "chevron-down"
+                        })
+                    ]
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    id: menuId,
+                    ref: menu,
+                    className: "foundation-popover",
+                    role: "menu",
+                    "aria-label": strings.viewsLabel,
+                    hidden: !open,
+                    onKeyDown: move,
+                    children: [
+                        views.length === 0 && /*#__PURE__*/ jsx("span", {
+                            className: "foundation-count",
+                            children: strings.viewsNone
+                        }),
+                        views.map((view)=>/*#__PURE__*/ jsxs("button", {
+                                type: "button",
+                                role: "menuitemradio",
+                                "aria-checked": view.id === active,
+                                className: "foundation-menu-item",
+                                tabIndex: -1,
+                                onClick: ()=>choose(view.id),
+                                children: [
+                                    /*#__PURE__*/ jsx("span", {
+                                        className: "foundation-menu-check",
+                                        children: view.id === active && /*#__PURE__*/ jsx(FoundationIcon, {
+                                            name: "check"
+                                        })
+                                    }),
+                                    /*#__PURE__*/ jsx("span", {
+                                        children: view.label
+                                    }),
+                                    view.description && /*#__PURE__*/ jsx("span", {
+                                        className: "foundation-count",
+                                        children: view.description
+                                    })
+                                ]
+                            }, view.id)),
+                        (rules.save !== PermissionRule.Hidden || rules.manage !== PermissionRule.Hidden) && /*#__PURE__*/ jsx("hr", {
+                            className: "foundation-separator"
+                        }),
+                        rules.save !== PermissionRule.Hidden && /*#__PURE__*/ jsxs("button", {
+                            type: "button",
+                            role: "menuitem",
+                            className: "foundation-menu-item",
+                            tabIndex: -1,
+                            "aria-disabled": rules.save === PermissionRule.Disabled || undefined,
+                            title: rules.save === PermissionRule.Disabled ? strings.disabledNoPermission : undefined,
+                            onClick: rules.save === PermissionRule.Enabled ? ()=>run('save') : undefined,
+                            children: [
+                                /*#__PURE__*/ jsx("span", {
+                                    className: "foundation-menu-check"
+                                }),
+                                /*#__PURE__*/ jsx("span", {
+                                    children: strings.viewsSave
+                                })
+                            ]
+                        }),
+                        rules.manage !== PermissionRule.Hidden && /*#__PURE__*/ jsxs("button", {
+                            type: "button",
+                            role: "menuitem",
+                            className: "foundation-menu-item",
+                            tabIndex: -1,
+                            "aria-disabled": rules.manage === PermissionRule.Disabled || undefined,
+                            title: rules.manage === PermissionRule.Disabled ? strings.disabledNoPermission : undefined,
+                            onClick: rules.manage === PermissionRule.Enabled ? ()=>run('manage') : undefined,
+                            children: [
+                                /*#__PURE__*/ jsx("span", {
+                                    className: "foundation-menu-check"
+                                }),
+                                /*#__PURE__*/ jsx("span", {
+                                    children: strings.viewsManage
+                                })
+                            ]
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+
+export { SavedViewsMenu, savedViewActionOutput };
+//# sourceMappingURL=SavedViewsMenu.js.map

package/dist/esm/foundation/SavedViewsMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SavedViewsMenu.js","sources":["../../../foundation/SavedViewsMenu.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { KeyboardEvent, useEffect, useId, useMemo, useRef, useState } from 'react';\nimport { RegisteredComponentProps, useValueOutput } from '@cratis/scene.react';\nimport { ComponentState, readComponentState } from './ComponentState';\nimport { FoundationIcon } from './FoundationIcon';\nimport { readFoundationStrings } from './foundationStrings';\nimport { PermissionRule, readPermissionRule } from './PermissionRule';\nimport { FoundationFrame } from './StateFrame';\nimport { readOptionalString } from '../shell/elementProperties';\nimport { readViews } from './viewModel';\n\n/** The output a menu action is published under: `save` or `manage`, which the host acts on. */\nexport const savedViewActionOutput = 'action';\n\n/**\n * The `savedViewsMenu` component: a list's saved views as a menu button, with the current view as its label.\n *\n * `views` are the choices (id, label, description) and `activeView` the one in force. Choosing a view publishes its id as the `value`\n * output and runs the behaviors attached to the element, so a screen binds its query to the view. The menu follows the ARIA menu\n * pattern: arrows, Home and End move, Enter chooses, Escape closes and returns focus to the button. \"Save current view\" and\n * \"Manage views\" publish `save` or `manage` on the `action` output, and each honours its own permission rule (`savePermission`,\n * `managePermission`): hidden, or disabled with the reason.\n */\nexport function SavedViewsMenu({ element, interactions, bindingOutputs }: RegisteredComponentProps) {\n    const views = useMemo(() => readViews(element.properties.views), [element.properties.views]);\n    const suppliedActive = readOptionalString(element, 'activeView') ?? views[0]?.id;\n    const [active, setActive] = useState<string | undefined>(suppliedActive);\n    const [open, setOpen] = useState(false);\n    const strings = readFoundationStrings(element);\n    const state = readComponentState(element, views.length > 0);\n    const menuId = useId();\n    const button = useRef<HTMLButtonElement>(null);\n    const menu = useRef<HTMLDivElement>(null);\n    const rules = { save: readPermissionRule(element, 'savePermission'), manage: readPermissionRule(element, 'managePermission') };\n\n    useEffect(() => setActive(suppliedActive), [suppliedActive]);\n    useValueOutput(bindingOutputs, active);\n    useEffect(() => { if (open) menu.current?.querySelector<HTMLElement>('[role^=\"menuitem\"]:not([aria-disabled=\"true\"])')?.focus(); }, [open]);\n\n    const items = () => Array.from(menu.current?.querySelectorAll<HTMLElement>('[role^=\"menuitem\"]:not([aria-disabled=\"true\"])') ?? []);\n    const move = (event: KeyboardEvent) => {\n        const entries = items();\n        const index = entries.indexOf(document.activeElement as HTMLElement);\n        const target = event.key === 'ArrowDown' ? (index + 1) % entries.length : event.key === 'ArrowUp' ? (index - 1 + entries.length) % entries.length\n            : event.key === 'Home' ? 0 : event.key === 'End' ? entries.length - 1 : -1;\n\n        if (target >= 0) { event.preventDefault(); entries[target]?.focus(); }\n        if (event.key === 'Escape') { setOpen(false); button.current?.focus(); }\n        if (event.key === 'Tab') setOpen(false);\n    };\n    const choose = (id: string) => { setActive(id); setOpen(false); button.current?.focus(); interactions?.onSelect?.(); };\n    const run = (action: 'save' | 'manage') => { bindingOutputs?.setOutput(savedViewActionOutput, action); setOpen(false); button.current?.focus(); interactions?.onClick?.({ stopPropagation: () => undefined }); };\n    const label = views.find(view => view.id === active)?.label ?? strings.viewsDefault;\n\n    return (\n        <FoundationFrame element={element} interactions={interactions} name='saved-views' state={state} skeleton={[45]}>\n            {state !== ComponentState.Loading && (\n                <div className='foundation-popover-host'>\n                    <button ref={button} type='button' className='foundation-button' data-emphasis='secondary' aria-haspopup='menu' aria-expanded={open} aria-controls={menuId}\n                        onClick={() => setOpen(!open)} onKeyDown={event => { if (event.key === 'ArrowDown' && !open) { event.preventDefault(); setOpen(true); } }}>\n                        <span className='foundation-visually-hidden'>{`${strings.viewsLabel}: `}</span>\n                        <span>{label}</span>\n                        <FoundationIcon name='chevron-down' />\n                    </button>\n                    <div id={menuId} ref={menu} className='foundation-popover' role='menu' aria-label={strings.viewsLabel} hidden={!open} onKeyDown={move}>\n                        {views.length === 0 && <span className='foundation-count'>{strings.viewsNone}</span>}\n                        {views.map(view => (\n                            <button key={view.id} type='button' role='menuitemradio' aria-checked={view.id === active} className='foundation-menu-item' tabIndex={-1} onClick={() => choose(view.id)}>\n                                <span className='foundation-menu-check'>{view.id === active && <FoundationIcon name='check' />}</span>\n                                <span>{view.label}</span>\n                                {view.description && <span className='foundation-count'>{view.description}</span>}\n                            </button>\n                        ))}\n                        {(rules.save !== PermissionRule.Hidden || rules.manage !== PermissionRule.Hidden) && <hr className='foundation-separator' />}\n                        {rules.save !== PermissionRule.Hidden && (\n                            <button type='button' role='menuitem' className='foundation-menu-item' tabIndex={-1} aria-disabled={rules.save === PermissionRule.Disabled || undefined}\n                                title={rules.save === PermissionRule.Disabled ? strings.disabledNoPermission : undefined} onClick={rules.save === PermissionRule.Enabled ? () => run('save') : undefined}>\n                                <span className='foundation-menu-check' /><span>{strings.viewsSave}</span>\n                            </button>\n                        )}\n                        {rules.manage !== PermissionRule.Hidden && (\n                            <button type='button' role='menuitem' className='foundation-menu-item' tabIndex={-1} aria-disabled={rules.manage === PermissionRule.Disabled || undefined}\n                                title={rules.manage === PermissionRule.Disabled ? strings.disabledNoPermission : undefined} onClick={rules.manage === PermissionRule.Enabled ? () => run('manage') : undefined}>\n                                <span className='foundation-menu-check' /><span>{strings.viewsManage}</span>\n                            </button>\n                        )}\n                    </div>\n                </div>\n            )}\n        </FoundationFrame>\n    );\n}\n"],"names":["savedViewActionOutput","SavedViewsMenu","element","interactions","bindingOutputs","views","useMemo","readViews","properties","suppliedActive","readOptionalString","id","active","setActive","useState","open","setOpen","strings","readFoundationStrings","state","readComponentState","length","menuId","useId","button","useRef","menu","rules","save","readPermissionRule","manage","useEffect","useValueOutput","current","querySelector","focus","items","Array","from","querySelectorAll","move","event","entries","index","indexOf","document","activeElement","target","key","preventDefault","choose","onSelect","run","action","setOutput","onClick","stopPropagation","undefined","label","find","view","viewsDefault","_jsx","FoundationFrame","name","skeleton","ComponentState","Loading","_jsxs","div","className","ref","type","data-emphasis","aria-haspopup","aria-expanded","aria-controls","onKeyDown","span","viewsLabel","FoundationIcon","role","aria-label","hidden","viewsNone","map","aria-checked","tabIndex","description","PermissionRule","Hidden","hr","aria-disabled","Disabled","title","disabledNoPermission","Enabled","viewsSave","viewsManage"],"mappings":"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"}

package/dist/esm/foundation/chartGeometry.d.ts

@@ -0,0 +1,34 @@
+export declare enum ChartKind {
+    Line = "line",
+    Bar = "bar",
+    Stacked = "stacked",
+    Donut = "donut",
+    Funnel = "funnel"
+}
+export interface ChartSeries {
+    name: string;
+    values: number[];
+}
+export interface ChartScale {
+    maximum: number;
+    ticks: number[];
+}
+export declare function niceScale(maximum: number, target?: number): ChartScale;
+export declare function readSeries(value: unknown): ChartSeries[];
+export declare function dataMaximum(kind: ChartKind, series: ChartSeries[], categoryCount: number): number;
+export interface DonutSlice {
+    index: number;
+    value: number;
+    share: number;
+    start: number;
+    end: number;
+}
+export declare function donutSlices(values: number[]): DonutSlice[];
+export declare function ringPath(centerX: number, centerY: number, outer: number, inner: number, start: number, end: number): string;
+export interface FunnelStage {
+    index: number;
+    value: number;
+    widthRatio: number;
+}
+export declare function funnelStages(values: number[]): FunnelStage[];
+//# sourceMappingURL=chartGeometry.d.ts.map

package/dist/esm/foundation/chartGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartGeometry.d.ts","sourceRoot":"","sources":["../../../foundation/chartGeometry.ts"],"names":[],"mappings":"AAIA,oBAAY,SAAS;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,MAAM,WAAW;CACpB;AAGD,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAGD,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAGD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,UAAU,CAWjE;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CASxD;AAGD,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAMjG;AAGD,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf;AAGD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAa1D;AAGD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAS3H;AAGD,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAG5D"}

package/dist/esm/foundation/chartGeometry.js

@@ -0,0 +1,93 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The kinds of chart the wrapper draws (spec Part B 2.3: line, bar, stacked, donut, funnel). */ var ChartKind = /*#__PURE__*/ function(ChartKind) {
+    ChartKind["Line"] = "line";
+    ChartKind["Bar"] = "bar";
+    ChartKind["Stacked"] = "stacked";
+    ChartKind["Donut"] = "donut";
+    ChartKind["Funnel"] = "funnel";
+    return ChartKind;
+}({});
+/** Builds a scale from zero to a rounded-up maximum of the values, in about `target` steps. */ function niceScale(maximum, target = 4) {
+    if (!Number.isFinite(maximum) || maximum <= 0) return {
+        maximum: 1,
+        ticks: [
+            0,
+            1
+        ]
+    };
+    const rough = maximum / target;
+    const magnitude = 10 ** Math.floor(Math.log10(rough));
+    const residual = rough / magnitude;
+    const step = (residual <= 1 ? 1 : residual <= 2 ? 2 : residual <= 5 ? 5 : 10) * magnitude;
+    const top = Math.ceil(maximum / step) * step;
+    const ticks = [];
+    for(let tick = 0; tick <= top + step / 2; tick += step)ticks.push(Number(tick.toFixed(10)));
+    return {
+        maximum: top,
+        ticks
+    };
+}
+/** Reads series out of a property value, dropping anything that is not a named list of numbers, so a half-bound chart draws what it has. */ function readSeries(value) {
+    if (!Array.isArray(value)) return [];
+    return value.flatMap((entry)=>{
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];
+        const { name, values } = entry;
+        if (typeof name !== 'string' || !Array.isArray(values)) return [];
+        return [
+            {
+                name,
+                values: values.map((item)=>typeof item === 'number' && Number.isFinite(item) ? item : 0)
+            }
+        ];
+    });
+}
+/** The extent of the values a chart of this kind has to fit: stacked series add up, the others are compared one by one. */ function dataMaximum(kind, series, categoryCount) {
+    if (kind === "stacked") {
+        return Math.max(0, ...Array.from({
+            length: categoryCount
+        }, (_, index)=>series.reduce((sum, item)=>sum + Math.max(0, item.values[index] ?? 0), 0)));
+    }
+    return Math.max(0, ...series.flatMap((item)=>item.values));
+}
+/** Divides the positive values into slices that together make one turn. */ function donutSlices(values) {
+    const positive = values.map((value)=>Math.max(0, value));
+    const total = positive.reduce((sum, value)=>sum + value, 0);
+    if (total === 0) return [];
+    let angle = 0;
+    return positive.flatMap((value, index)=>{
+        if (value === 0) return [];
+        const share = value / total;
+        const slice = {
+            index,
+            value,
+            share,
+            start: angle,
+            end: angle + share * Math.PI * 2
+        };
+        angle = slice.end;
+        return [
+            slice
+        ];
+    });
+}
+/** The SVG path of a ring segment between two radii; a full turn is drawn as two halves, because one arc cannot start and end on the same point. */ function ringPath(centerX, centerY, outer, inner, start, end) {
+    const point = (radius, angle)=>`${(centerX + radius * Math.sin(angle)).toFixed(2)} ${(centerY - radius * Math.cos(angle)).toFixed(2)}`;
+    if (end - start >= Math.PI * 2 - 1e-6) {
+        const middle = start + Math.PI;
+        return `${ringPath(centerX, centerY, outer, inner, start, middle)} ${ringPath(centerX, centerY, outer, inner, middle, end)}`;
+    }
+    const large = end - start > Math.PI ? 1 : 0;
+    return `M ${point(outer, start)} A ${outer} ${outer} 0 ${large} 1 ${point(outer, end)} L ${point(inner, end)} A ${inner} ${inner} 0 ${large} 0 ${point(inner, start)} Z`;
+}
+/** Sizes the stages of a funnel against the largest value. */ function funnelStages(values) {
+    const maximum = Math.max(0, ...values);
+    return values.map((value, index)=>({
+            index,
+            value,
+            widthRatio: maximum === 0 ? 0 : Math.max(0, value) / maximum
+        }));
+}
+
+export { ChartKind, dataMaximum, donutSlices, funnelStages, niceScale, readSeries, ringPath };
+//# sourceMappingURL=chartGeometry.js.map

package/dist/esm/foundation/chartGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartGeometry.js","sources":["../../../foundation/chartGeometry.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/** The kinds of chart the wrapper draws (spec Part B 2.3: line, bar, stacked, donut, funnel). */\nexport enum ChartKind {\n    Line = 'line',\n    Bar = 'bar',\n    Stacked = 'stacked',\n    Donut = 'donut',\n    Funnel = 'funnel',\n}\n\n/** One named series of values, one per category. */\nexport interface ChartSeries {\n    name: string;\n    values: number[];\n}\n\n/** A rounded-up axis maximum and the tick values below it, so an axis reads 0, 25, 50, 75, 100 and not 0, 23.4, 46.8. */\nexport interface ChartScale {\n    maximum: number;\n    ticks: number[];\n}\n\n/** Builds a scale from zero to a rounded-up maximum of the values, in about `target` steps. */\nexport function niceScale(maximum: number, target = 4): ChartScale {\n    if (!Number.isFinite(maximum) || maximum <= 0) return { maximum: 1, ticks: [0, 1] };\n\n    const rough = maximum / target;\n    const magnitude = 10 ** Math.floor(Math.log10(rough));\n    const residual = rough / magnitude;\n    const step = (residual <= 1 ? 1 : residual <= 2 ? 2 : residual <= 5 ? 5 : 10) * magnitude;\n    const top = Math.ceil(maximum / step) * step;\n    const ticks: number[] = [];\n    for (let tick = 0; tick <= top + step / 2; tick += step) ticks.push(Number(tick.toFixed(10)));\n    return { maximum: top, ticks };\n}\n\n/** Reads series out of a property value, dropping anything that is not a named list of numbers, so a half-bound chart draws what it has. */\nexport function readSeries(value: unknown): ChartSeries[] {\n    if (!Array.isArray(value)) return [];\n\n    return value.flatMap((entry): ChartSeries[] => {\n        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];\n        const { name, values } = entry as Record<string, unknown>;\n        if (typeof name !== 'string' || !Array.isArray(values)) return [];\n        return [{ name, values: values.map(item => (typeof item === 'number' && Number.isFinite(item) ? item : 0)) }];\n    });\n}\n\n/** The extent of the values a chart of this kind has to fit: stacked series add up, the others are compared one by one. */\nexport function dataMaximum(kind: ChartKind, series: ChartSeries[], categoryCount: number): number {\n    if (kind === ChartKind.Stacked) {\n        return Math.max(0, ...Array.from({ length: categoryCount }, (_, index) => series.reduce((sum, item) => sum + Math.max(0, item.values[index] ?? 0), 0)));\n    }\n\n    return Math.max(0, ...series.flatMap(item => item.values));\n}\n\n/** A slice of a donut, in radians clockwise from the top. */\nexport interface DonutSlice {\n    index: number;\n    value: number;\n    share: number;\n    start: number;\n    end: number;\n}\n\n/** Divides the positive values into slices that together make one turn. */\nexport function donutSlices(values: number[]): DonutSlice[] {\n    const positive = values.map(value => Math.max(0, value));\n    const total = positive.reduce((sum, value) => sum + value, 0);\n    if (total === 0) return [];\n\n    let angle = 0;\n    return positive.flatMap((value, index) => {\n        if (value === 0) return [];\n        const share = value / total;\n        const slice = { index, value, share, start: angle, end: angle + share * Math.PI * 2 };\n        angle = slice.end;\n        return [slice];\n    });\n}\n\n/** The SVG path of a ring segment between two radii; a full turn is drawn as two halves, because one arc cannot start and end on the same point. */\nexport function ringPath(centerX: number, centerY: number, outer: number, inner: number, start: number, end: number): string {\n    const point = (radius: number, angle: number) => `${(centerX + radius * Math.sin(angle)).toFixed(2)} ${(centerY - radius * Math.cos(angle)).toFixed(2)}`;\n    if (end - start >= Math.PI * 2 - 1e-6) {\n        const middle = start + Math.PI;\n        return `${ringPath(centerX, centerY, outer, inner, start, middle)} ${ringPath(centerX, centerY, outer, inner, middle, end)}`;\n    }\n\n    const large = end - start > Math.PI ? 1 : 0;\n    return `M ${point(outer, start)} A ${outer} ${outer} 0 ${large} 1 ${point(outer, end)} L ${point(inner, end)} A ${inner} ${inner} 0 ${large} 0 ${point(inner, start)} Z`;\n}\n\n/** One stage of a funnel: a centered bar whose width is its share of the widest stage. */\nexport interface FunnelStage {\n    index: number;\n    value: number;\n    widthRatio: number;\n}\n\n/** Sizes the stages of a funnel against the largest value. */\nexport function funnelStages(values: number[]): FunnelStage[] {\n    const maximum = Math.max(0, ...values);\n    return values.map((value, index) => ({ index, value, widthRatio: maximum === 0 ? 0 : Math.max(0, value) / maximum }));\n}\n"],"names":["ChartKind","niceScale","maximum","target","Number","isFinite","ticks","rough","magnitude","Math","floor","log10","residual","step","top","ceil","tick","push","toFixed","readSeries","value","Array","isArray","flatMap","entry","name","values","map","item","dataMaximum","kind","series","categoryCount","max","from","length","_","index","reduce","sum","donutSlices","positive","total","angle","share","slice","start","end","PI","ringPath","centerX","centerY","outer","inner","point","radius","sin","cos","middle","large","funnelStages","widthRatio"],"mappings":"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"}

package/dist/esm/foundation/columnModel.d.ts

@@ -0,0 +1,11 @@
+export interface ChooserColumn {
+    id: string;
+    label: string;
+    visible: boolean;
+    locked: boolean;
+}
+export declare function readColumns(value: unknown): ChooserColumn[];
+export declare const visibleColumnIds: (columns: ChooserColumn[]) => string[];
+export declare function moveColumn(columns: ChooserColumn[], index: number, direction: -1 | 1): ChooserColumn[];
+export declare const toggleColumn: (columns: ChooserColumn[], index: number) => ChooserColumn[];
+//# sourceMappingURL=columnModel.d.ts.map

package/dist/esm/foundation/columnModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnModel.d.ts","sourceRoot":"","sources":["../../../foundation/columnModel.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACnB;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,EAAE,CAS3D;AAGD,eAAO,MAAM,gBAAgB,YAAa,aAAa,EAAE,KAAG,MAAM,EAAuE,CAAC;AAG1I,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,aAAa,EAAE,CAOtG;AAGD,eAAO,MAAM,YAAY,YAAa,aAAa,EAAE,SAAS,MAAM,KAAG,aAAa,EAC4C,CAAC"}

package/dist/esm/foundation/columnModel.js

@@ -0,0 +1,38 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** One column a table could show. */ /** Reads columns out of a property value; a column is visible unless it says otherwise, and a locked column is always visible. */ function readColumns(value) {
+    if (!Array.isArray(value)) return [];
+    return value.flatMap((entry)=>{
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];
+        const { id, label, visible, locked } = entry;
+        if (typeof id !== 'string' || id.length === 0) return [];
+        return [
+            {
+                id,
+                label: typeof label === 'string' && label.length > 0 ? label : id,
+                visible: locked === true || visible !== false,
+                locked: locked === true
+            }
+        ];
+    });
+}
+/** The ids of the visible columns, in order: what the chooser publishes and a table binds its columns to. */ const visibleColumnIds = (columns)=>columns.filter((column)=>column.visible).map((column)=>column.id);
+/** Moves a column one place up or down, staying where it is at either end. */ function moveColumn(columns, index, direction) {
+    const target = index + direction;
+    if (target < 0 || target >= columns.length) return columns;
+    const result = [
+        ...columns
+    ];
+    [result[index], result[target]] = [
+        result[target],
+        result[index]
+    ];
+    return result;
+}
+/** Shows or hides a column; a locked column cannot be hidden. */ const toggleColumn = (columns, index)=>columns.map((column, position)=>position === index && !column.locked ? {
+            ...column,
+            visible: !column.visible
+        } : column);
+
+export { moveColumn, readColumns, toggleColumn, visibleColumnIds };
+//# sourceMappingURL=columnModel.js.map

package/dist/esm/foundation/columnModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnModel.js","sources":["../../../foundation/columnModel.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/** One column a table could show. */\nexport interface ChooserColumn {\n    id: string;\n    label: string;\n    visible: boolean;\n    locked: boolean;\n}\n\n/** Reads columns out of a property value; a column is visible unless it says otherwise, and a locked column is always visible. */\nexport function readColumns(value: unknown): ChooserColumn[] {\n    if (!Array.isArray(value)) return [];\n\n    return value.flatMap((entry): ChooserColumn[] => {\n        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];\n        const { id, label, visible, locked } = entry as Record<string, unknown>;\n        if (typeof id !== 'string' || id.length === 0) return [];\n        return [{ id, label: typeof label === 'string' && label.length > 0 ? label : id, visible: locked === true || visible !== false, locked: locked === true }];\n    });\n}\n\n/** The ids of the visible columns, in order: what the chooser publishes and a table binds its columns to. */\nexport const visibleColumnIds = (columns: ChooserColumn[]): string[] => columns.filter(column => column.visible).map(column => column.id);\n\n/** Moves a column one place up or down, staying where it is at either end. */\nexport function moveColumn(columns: ChooserColumn[], index: number, direction: -1 | 1): ChooserColumn[] {\n    const target = index + direction;\n    if (target < 0 || target >= columns.length) return columns;\n\n    const result = [...columns];\n    [result[index], result[target]] = [result[target], result[index]];\n    return result;\n}\n\n/** Shows or hides a column; a locked column cannot be hidden. */\nexport const toggleColumn = (columns: ChooserColumn[], index: number): ChooserColumn[] =>\n    columns.map((column, position) => (position === index && !column.locked ? { ...column, visible: !column.visible } : column));\n"],"names":["readColumns","value","Array","isArray","flatMap","entry","id","label","visible","locked","length","visibleColumnIds","columns","filter","column","map","moveColumn","index","direction","target","result","toggleColumn","position"],"mappings":"AAAA;AACA;AAEA,yKASO,SAASA,YAAYC,KAAc,EAAA;AACtC,IAAA,IAAI,CAACC,KAAAA,CAAMC,OAAO,CAACF,KAAAA,CAAAA,EAAQ,OAAO,EAAE;IAEpC,OAAOA,KAAAA,CAAMG,OAAO,CAAC,CAACC,KAAAA,GAAAA;QAClB,IAAI,OAAOA,KAAAA,KAAU,QAAA,IAAYA,KAAAA,KAAU,IAAA,IAAQH,MAAMC,OAAO,CAACE,KAAAA,CAAAA,EAAQ,OAAO,EAAE;QAClF,MAAM,EAAEC,EAAE,EAAEC,KAAK,EAAEC,OAAO,EAAEC,MAAM,EAAE,GAAGJ,KAAAA;QACvC,IAAI,OAAOC,OAAO,QAAA,IAAYA,EAAAA,CAAGI,MAAM,KAAK,CAAA,EAAG,OAAO,EAAE;QACxD,OAAO;AAAC,YAAA;AAAEJ,gBAAAA,EAAAA;AAAIC,gBAAAA,KAAAA,EAAO,OAAOA,KAAAA,KAAU,QAAA,IAAYA,MAAMG,MAAM,GAAG,IAAIH,KAAAA,GAAQD,EAAAA;gBAAIE,OAAAA,EAASC,MAAAA,KAAW,QAAQD,OAAAA,KAAY,KAAA;AAAOC,gBAAAA,MAAAA,EAAQA,MAAAA,KAAW;AAAK;AAAE,SAAA;AAC9J,IAAA,CAAA,CAAA;AACJ;AAEA,8GACO,MAAME,gBAAAA,GAAmB,CAACC,OAAAA,GAAuCA,OAAAA,CAAQC,MAAM,CAACC,CAAAA,SAAUA,MAAAA,CAAON,OAAO,EAAEO,GAAG,CAACD,CAAAA,MAAAA,GAAUA,MAAAA,CAAOR,EAAE;AAExI,+EACO,SAASU,UAAAA,CAAWJ,OAAwB,EAAEK,KAAa,EAAEC,SAAiB,EAAA;AACjF,IAAA,MAAMC,SAASF,KAAAA,GAAQC,SAAAA;AACvB,IAAA,IAAIC,SAAS,CAAA,IAAKA,MAAAA,IAAUP,OAAAA,CAAQF,MAAM,EAAE,OAAOE,OAAAA;AAEnD,IAAA,MAAMQ,MAAAA,GAAS;AAAIR,QAAAA,GAAAA;AAAQ,KAAA;IAC3B,CAACQ,MAAM,CAACH,KAAAA,CAAM,EAAEG,MAAM,CAACD,MAAAA,CAAO,CAAC,GAAG;AAACC,QAAAA,MAAM,CAACD,MAAAA,CAAO;AAAEC,QAAAA,MAAM,CAACH,KAAAA;AAAO,KAAA;IACjE,OAAOG,MAAAA;AACX;AAEA,kEACO,MAAMC,eAAe,CAACT,OAAAA,EAA0BK,QACnDL,OAAAA,CAAQG,GAAG,CAAC,CAACD,QAAQQ,QAAAA,GAAcA,QAAAA,KAAaL,SAAS,CAACH,MAAAA,CAAOL,MAAM,GAAG;AAAE,YAAA,GAAGK,MAAM;YAAEN,OAAAA,EAAS,CAACM,OAAON;AAAQ,SAAA,GAAIM,MAAAA;;"}

package/dist/esm/foundation/filterModel.d.ts

@@ -0,0 +1,33 @@
+export declare enum FilterFieldType {
+    Text = "text",
+    Number = "number",
+    Date = "date",
+    Select = "select",
+    Boolean = "boolean"
+}
+export interface FilterField {
+    name: string;
+    label: string;
+    type: FilterFieldType;
+    options: string[];
+}
+export interface FilterCondition {
+    field: string;
+    operator: string;
+    value: string;
+}
+export interface FilterGroup {
+    operator: 'and' | 'or';
+    conditions: FilterCondition[];
+    groups: FilterGroup[];
+}
+export declare const maximumFilterDepth = 3;
+export declare const emptyFilter: () => FilterGroup;
+export declare const filterOperators: Record<FilterFieldType, string[]>;
+export declare const valuelessOperators: string[];
+export declare function readFilterFields(value: unknown): FilterField[];
+export declare function normalizeFilter(value: unknown, fields: FilterField[], depth?: number): FilterGroup;
+export declare function countActiveConditions(group: FilterGroup): number;
+export declare function updateGroupAt(root: FilterGroup, path: number[], change: (group: FilterGroup) => FilterGroup): FilterGroup;
+export declare function newCondition(fields: FilterField[]): FilterCondition;
+//# sourceMappingURL=filterModel.d.ts.map

package/dist/esm/foundation/filterModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterModel.d.ts","sourceRoot":"","sources":["../../../foundation/filterModel.ts"],"names":[],"mappings":"AAIA,oBAAY,eAAe;IACvB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB;AAGD,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,WAAW;IACxB,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB;AAGD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAGpC,eAAO,MAAM,WAAW,QAAO,WAAgE,CAAC;AAGhG,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,CAM7D,CAAC;AAGF,eAAO,MAAM,kBAAkB,UAA+B,CAAC;AAG/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CAc9D;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,SAAI,GAAG,WAAW,CAoB7F;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAGhE;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GAAG,WAAW,CAKzH;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,CAGnE"}

package/dist/esm/foundation/filterModel.js

@@ -0,0 +1,112 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** What a filterable field holds, which decides the operators offered for it. */ var FilterFieldType = /*#__PURE__*/ function(FilterFieldType) {
+    FilterFieldType["Text"] = "text";
+    FilterFieldType["Number"] = "number";
+    FilterFieldType["Date"] = "date";
+    FilterFieldType["Select"] = "select";
+    FilterFieldType["Boolean"] = "boolean";
+    return FilterFieldType;
+}({});
+/** The deepest a group may nest; deeper filters are unreadable, and a runaway value is cut rather than rendered forever. */ const maximumFilterDepth = 3;
+/** An empty group. */ const emptyFilter = ()=>({
+        operator: 'and',
+        conditions: [],
+        groups: []
+    });
+/** The operators of each field type, in the order they are offered; the first is the default. */ const filterOperators = {
+    ["text"]: [
+        'contains',
+        'equals',
+        'notEquals',
+        'startsWith',
+        'isEmpty'
+    ],
+    ["number"]: [
+        'equals',
+        'notEquals',
+        'greater',
+        'greaterOrEqual',
+        'less',
+        'lessOrEqual'
+    ],
+    ["date"]: [
+        'on',
+        'before',
+        'after'
+    ],
+    ["select"]: [
+        'is',
+        'isNot'
+    ],
+    ["boolean"]: [
+        'true',
+        'false'
+    ]
+};
+/** The operators that need no value to compare with. */ const valuelessOperators = [
+    'isEmpty',
+    'true',
+    'false'
+];
+/** Reads fields out of a property value, dropping entries without a name, and defaulting what is unknown to text. */ function readFilterFields(value) {
+    if (!Array.isArray(value)) return [];
+    return value.flatMap((entry)=>{
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];
+        const { name, label, type, options } = entry;
+        if (typeof name !== 'string' || name.length === 0) return [];
+        return [
+            {
+                name,
+                label: typeof label === 'string' && label.length > 0 ? label : name,
+                type: Object.values(FilterFieldType).includes(type) ? type : "text",
+                options: Array.isArray(options) ? options.filter((option)=>typeof option === 'string') : []
+            }
+        ];
+    });
+}
+/** Reads a filter out of a property value, keeping the conditions on known fields with operators their type offers. */ function normalizeFilter(value, fields, depth = 1) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) return emptyFilter();
+    const { operator, conditions, groups } = value;
+    return {
+        operator: operator === 'or' ? 'or' : 'and',
+        conditions: Array.isArray(conditions) ? conditions.flatMap((entry)=>{
+            if (typeof entry !== 'object' || entry === null) return [];
+            const condition = entry;
+            const field = fields.find((candidate)=>candidate.name === condition.field);
+            if (!field) return [];
+            const operators = filterOperators[field.type];
+            return [
+                {
+                    field: field.name,
+                    operator: typeof condition.operator === 'string' && operators.includes(condition.operator) ? condition.operator : operators[0],
+                    value: typeof condition.value === 'string' ? condition.value : typeof condition.value === 'number' ? String(condition.value) : ''
+                }
+            ];
+        }) : [],
+        groups: depth < maximumFilterDepth && Array.isArray(groups) ? groups.map((group)=>normalizeFilter(group, fields, depth + 1)) : []
+    };
+}
+/** How many conditions are in force: a condition that needs a value and has none is not filtering anything. */ function countActiveConditions(group) {
+    const own = group.conditions.filter((condition)=>valuelessOperators.includes(condition.operator) || condition.value.trim().length > 0).length;
+    return own + group.groups.reduce((sum, nested)=>sum + countActiveConditions(nested), 0);
+}
+/** Applies a change to the group at a path of nested group indexes, leaving the rest as it was. */ function updateGroupAt(root, path, change) {
+    if (path.length === 0) return change(root);
+    const [index, ...rest] = path;
+    return {
+        ...root,
+        groups: root.groups.map((group, position)=>position === index ? updateGroupAt(group, rest, change) : group)
+    };
+}
+/** A new condition on the first field, with that field's default operator. */ function newCondition(fields) {
+    const field = fields[0];
+    return {
+        field: field?.name ?? '',
+        operator: field ? filterOperators[field.type][0] : 'contains',
+        value: ''
+    };
+}
+
+export { FilterFieldType, countActiveConditions, emptyFilter, filterOperators, maximumFilterDepth, newCondition, normalizeFilter, readFilterFields, updateGroupAt, valuelessOperators };
+//# sourceMappingURL=filterModel.js.map

package/dist/esm/foundation/filterModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterModel.js","sources":["../../../foundation/filterModel.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/** What a filterable field holds, which decides the operators offered for it. */\nexport enum FilterFieldType {\n    Text = 'text',\n    Number = 'number',\n    Date = 'date',\n    Select = 'select',\n    Boolean = 'boolean',\n}\n\n/** A field a filter can be built on. */\nexport interface FilterField {\n    name: string;\n    label: string;\n    type: FilterFieldType;\n    options: string[];\n}\n\n/** One test of a field. */\nexport interface FilterCondition {\n    field: string;\n    operator: string;\n    value: string;\n}\n\n/** Conditions and nested groups joined by AND or OR. */\nexport interface FilterGroup {\n    operator: 'and' | 'or';\n    conditions: FilterCondition[];\n    groups: FilterGroup[];\n}\n\n/** The deepest a group may nest; deeper filters are unreadable, and a runaway value is cut rather than rendered forever. */\nexport const maximumFilterDepth = 3;\n\n/** An empty group. */\nexport const emptyFilter = (): FilterGroup => ({ operator: 'and', conditions: [], groups: [] });\n\n/** The operators of each field type, in the order they are offered; the first is the default. */\nexport const filterOperators: Record<FilterFieldType, string[]> = {\n    [FilterFieldType.Text]: ['contains', 'equals', 'notEquals', 'startsWith', 'isEmpty'],\n    [FilterFieldType.Number]: ['equals', 'notEquals', 'greater', 'greaterOrEqual', 'less', 'lessOrEqual'],\n    [FilterFieldType.Date]: ['on', 'before', 'after'],\n    [FilterFieldType.Select]: ['is', 'isNot'],\n    [FilterFieldType.Boolean]: ['true', 'false'],\n};\n\n/** The operators that need no value to compare with. */\nexport const valuelessOperators = ['isEmpty', 'true', 'false'];\n\n/** Reads fields out of a property value, dropping entries without a name, and defaulting what is unknown to text. */\nexport function readFilterFields(value: unknown): FilterField[] {\n    if (!Array.isArray(value)) return [];\n\n    return value.flatMap((entry): FilterField[] => {\n        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];\n        const { name, label, type, options } = entry as Record<string, unknown>;\n        if (typeof name !== 'string' || name.length === 0) return [];\n        return [{\n            name,\n            label: typeof label === 'string' && label.length > 0 ? label : name,\n            type: (Object.values(FilterFieldType) as string[]).includes(type as string) ? (type as FilterFieldType) : FilterFieldType.Text,\n            options: Array.isArray(options) ? options.filter((option): option is string => typeof option === 'string') : [],\n        }];\n    });\n}\n\n/** Reads a filter out of a property value, keeping the conditions on known fields with operators their type offers. */\nexport function normalizeFilter(value: unknown, fields: FilterField[], depth = 1): FilterGroup {\n    if (typeof value !== 'object' || value === null || Array.isArray(value)) return emptyFilter();\n\n    const { operator, conditions, groups } = value as Record<string, unknown>;\n    return {\n        operator: operator === 'or' ? 'or' : 'and',\n        conditions: Array.isArray(conditions) ? conditions.flatMap((entry): FilterCondition[] => {\n            if (typeof entry !== 'object' || entry === null) return [];\n            const condition = entry as Record<string, unknown>;\n            const field = fields.find(candidate => candidate.name === condition.field);\n            if (!field) return [];\n            const operators = filterOperators[field.type];\n            return [{\n                field: field.name,\n                operator: typeof condition.operator === 'string' && operators.includes(condition.operator) ? condition.operator : operators[0],\n                value: typeof condition.value === 'string' ? condition.value : typeof condition.value === 'number' ? String(condition.value) : '',\n            }];\n        }) : [],\n        groups: depth < maximumFilterDepth && Array.isArray(groups) ? groups.map(group => normalizeFilter(group, fields, depth + 1)) : [],\n    };\n}\n\n/** How many conditions are in force: a condition that needs a value and has none is not filtering anything. */\nexport function countActiveConditions(group: FilterGroup): number {\n    const own = group.conditions.filter(condition => valuelessOperators.includes(condition.operator) || condition.value.trim().length > 0).length;\n    return own + group.groups.reduce((sum, nested) => sum + countActiveConditions(nested), 0);\n}\n\n/** Applies a change to the group at a path of nested group indexes, leaving the rest as it was. */\nexport function updateGroupAt(root: FilterGroup, path: number[], change: (group: FilterGroup) => FilterGroup): FilterGroup {\n    if (path.length === 0) return change(root);\n\n    const [index, ...rest] = path;\n    return { ...root, groups: root.groups.map((group, position) => (position === index ? updateGroupAt(group, rest, change) : group)) };\n}\n\n/** A new condition on the first field, with that field's default operator. */\nexport function newCondition(fields: FilterField[]): FilterCondition {\n    const field = fields[0];\n    return { field: field?.name ?? '', operator: field ? filterOperators[field.type][0] : 'contains', value: '' };\n}\n"],"names":["FilterFieldType","maximumFilterDepth","emptyFilter","operator","conditions","groups","filterOperators","valuelessOperators","readFilterFields","value","Array","isArray","flatMap","entry","name","label","type","options","length","Object","values","includes","filter","option","normalizeFilter","fields","depth","condition","field","find","candidate","operators","String","map","group","countActiveConditions","own","trim","reduce","sum","nested","updateGroupAt","root","path","change","index","rest","position","newCondition"],"mappings":"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"}