@aglyn/plugins-logic 1.0.0-beta.246 → 1.0.0-beta.249

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-logic",
-  "version": "1.0.0-beta.246",
+  "version": "1.0.0-beta.249",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,13 +25,13 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.246",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.246",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.246",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.246",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.246",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.246",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.246",
+    "@aglyn/aglyn": "1.0.0-beta.249",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.249",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.249",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.249",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.249",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.249",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.249",
     "@swc/helpers": "0.5.23"
   },
   "peerDependencies": {

package/src/lib/components/formula-builder-dialog.component.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { FormulaName } from '../model/formula-names';
+export interface FormulaBuilderDialogProps {
+    /** What the box holds now; offered as a value so formulas can be layered. */
+    current: string;
+    /** Parameters, local variables and site variables, grouped. */
+    names: readonly FormulaName[];
+    /** Receives the expression the builder wrote. */
+    onUse: (expression: string) => void;
+    onClose: () => void;
+}
+/**
+ * The "Build formula" dialog (AGL-3757): pick what to work out — add,
+ * smallest of, format as money — and the values it works on, and the box
+ * gets the expression that does it. Nothing is typed but numbers and text.
+ * Its own chunk, loaded the first time an ƒx button is pressed.
+ */
+export default function FormulaBuilderDialog(props: FormulaBuilderDialogProps): import("react").JSX.Element;

package/src/lib/components/formula-builder-dialog.component.js

@@ -0,0 +1,331 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Dialog, DialogActions, DialogContent, DialogTitle, IconButton, ListSubheader, MenuItem, Stack, TextField, Typography } from "@mui/material";
+import { useState } from "react";
+import { buildFormula, FORMULA_OPERATION_ORDER, FORMULA_OPERATIONS, formulaDraftFor, formulaOperandLabel } from "../model/formula.js";
+const SOURCE_LABELS = {
+    name: 'A value',
+    number: 'A number',
+    text: 'Some text',
+    current: 'What is there now'
+};
+const SEPARATORS = [
+    {
+        value: ' ',
+        label: 'A space'
+    },
+    {
+        value: ', ',
+        label: 'A comma'
+    },
+    {
+        value: ' - ',
+        label: 'A dash'
+    },
+    {
+        value: '',
+        label: 'Nothing'
+    }
+];
+const SYMBOLS = [
+    '$',
+    '€',
+    '£',
+    '¥',
+    ''
+];
+function NameSelect(props) {
+    const { label, value, names, onChange } = props;
+    const items = [];
+    let group = null;
+    for (const option of names){
+        if (option.group !== group) {
+            group = option.group;
+            items.push(/*#__PURE__*/ _jsx(ListSubheader, {
+                children: group
+            }, `group:${group}`));
+        }
+        items.push(/*#__PURE__*/ _jsx(MenuItem, {
+            value: option.value,
+            children: option.label
+        }, option.value));
+    }
+    return /*#__PURE__*/ _jsx(TextField, {
+        select: true,
+        label: label,
+        value: names.some((option)=>option.value === value) ? value : '',
+        onChange: (event)=>onChange(event.target.value),
+        size: "small",
+        sx: {
+            flex: 1
+        },
+        children: items.length ? items : /*#__PURE__*/ _jsx(MenuItem, {
+            disabled: true,
+            children: 'Nothing to pick yet'
+        })
+    });
+}
+function OperandRow(props) {
+    const { label, operand, names, hasCurrent, onChange, onRemove } = props;
+    const sources = Object.keys(SOURCE_LABELS).filter((source)=>source !== 'current' || hasCurrent);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        direction: "row",
+        spacing: 1,
+        sx: {
+            alignItems: 'center'
+        },
+        children: [
+            /*#__PURE__*/ _jsx(TextField, {
+                select: true,
+                label: label,
+                value: operand.source,
+                onChange: (event)=>{
+                    const source = event.target.value;
+                    onChange(source === 'name' ? {
+                        source,
+                        name: ''
+                    } : source === 'current' ? {
+                        source
+                    } : {
+                        source,
+                        value: ''
+                    });
+                },
+                size: "small",
+                sx: {
+                    width: 170
+                },
+                children: sources.map((source)=>/*#__PURE__*/ _jsx(MenuItem, {
+                        value: source,
+                        children: SOURCE_LABELS[source]
+                    }, source))
+            }),
+            operand.source === 'name' ? /*#__PURE__*/ _jsx(NameSelect, {
+                label: "Which",
+                value: operand.name,
+                names: names,
+                onChange: (name)=>onChange({
+                        source: 'name',
+                        name
+                    })
+            }) : operand.source === 'number' ? /*#__PURE__*/ _jsx(TextField, {
+                label: "Number",
+                value: operand.value,
+                onChange: (event)=>onChange({
+                        source: 'number',
+                        value: event.target.value.replace(/[^0-9.-]/g, '')
+                    }),
+                slotProps: {
+                    htmlInput: {
+                        inputMode: 'decimal'
+                    }
+                },
+                size: "small",
+                sx: {
+                    flex: 1
+                }
+            }) : operand.source === 'text' ? /*#__PURE__*/ _jsx(TextField, {
+                label: "Text",
+                value: operand.value,
+                onChange: (event)=>onChange({
+                        source: 'text',
+                        value: event.target.value
+                    }),
+                size: "small",
+                sx: {
+                    flex: 1
+                }
+            }) : /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                sx: {
+                    flex: 1
+                },
+                children: 'The formula already in the box'
+            }),
+            onRemove ? /*#__PURE__*/ _jsx(IconButton, {
+                size: "small",
+                "aria-label": `Remove ${label}`,
+                onClick: onRemove,
+                children: '×'
+            }) : null
+        ]
+    });
+}
+/**
+ * The "Build formula" dialog (AGL-3757): pick what to work out — add,
+ * smallest of, format as money — and the values it works on, and the box
+ * gets the expression that does it. Nothing is typed but numbers and text.
+ * Its own chunk, loaded the first time an ƒx button is pressed.
+ */ export default function FormulaBuilderDialog(props) {
+    var _draft_symbol, _draft_places, _draft_separator;
+    const { current, names, onUse, onClose } = props;
+    const [draft, setDraft] = useState(()=>formulaDraftFor(current.trim() ? 'add' : 'value', undefined, current));
+    const spec = FORMULA_OPERATIONS[draft.operation];
+    const expression = buildFormula(draft, current);
+    const setOperand = (index, operand)=>setDraft((previous)=>_extends({}, previous, {
+                operands: previous.operands.map((item, at)=>at === index ? operand : item)
+            }));
+    return /*#__PURE__*/ _jsxs(Dialog, {
+        open: true,
+        onClose: onClose,
+        fullWidth: true,
+        maxWidth: "sm",
+        children: [
+            /*#__PURE__*/ _jsx(DialogTitle, {
+                children: 'Build formula'
+            }),
+            /*#__PURE__*/ _jsx(DialogContent, {
+                children: /*#__PURE__*/ _jsxs(Stack, {
+                    spacing: 2,
+                    sx: {
+                        pt: 1
+                    },
+                    children: [
+                        /*#__PURE__*/ _jsx(TextField, {
+                            select: true,
+                            label: "Work out",
+                            value: draft.operation,
+                            onChange: (event)=>setDraft(formulaDraftFor(event.target.value, draft, current)),
+                            size: "small",
+                            children: FORMULA_OPERATION_ORDER.map((operation)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                    value: operation,
+                                    children: FORMULA_OPERATIONS[operation].label
+                                }, operation))
+                        }),
+                        draft.operands.map((operand, index)=>/*#__PURE__*/ _jsx(OperandRow, {
+                                label: formulaOperandLabel(draft.operation, index),
+                                operand: operand,
+                                names: names,
+                                hasCurrent: Boolean(current.trim()),
+                                onChange: (next)=>setOperand(index, next),
+                                onRemove: spec.variadic && index >= spec.minOperands ? ()=>setDraft(_extends({}, draft, {
+                                        operands: draft.operands.filter((_, at)=>at !== index)
+                                    })) : undefined
+                            }, index)),
+                        spec.variadic ? /*#__PURE__*/ _jsx(Button, {
+                            size: "small",
+                            sx: {
+                                alignSelf: 'flex-start'
+                            },
+                            onClick: ()=>setDraft(_extends({}, draft, {
+                                    operands: [
+                                        ...draft.operands,
+                                        draft.operation === 'join' ? {
+                                            source: 'text',
+                                            value: ''
+                                        } : {
+                                            source: 'name',
+                                            name: ''
+                                        }
+                                    ]
+                                })),
+                            children: 'Add another'
+                        }) : null,
+                        /*#__PURE__*/ _jsxs(Stack, {
+                            direction: "row",
+                            spacing: 1,
+                            children: [
+                                draft.operation === 'currency' ? /*#__PURE__*/ _jsx(TextField, {
+                                    select: true,
+                                    label: "Sign",
+                                    value: (_draft_symbol = draft.symbol) != null ? _draft_symbol : '$',
+                                    onChange: (event)=>setDraft(_extends({}, draft, {
+                                            symbol: event.target.value
+                                        })),
+                                    size: "small",
+                                    sx: {
+                                        width: 110
+                                    },
+                                    children: SYMBOLS.map((symbol)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                            value: symbol,
+                                            children: symbol || 'None'
+                                        }, symbol || 'none'))
+                                }) : null,
+                                spec.places ? /*#__PURE__*/ _jsx(TextField, {
+                                    select: true,
+                                    label: "Decimal places",
+                                    value: (_draft_places = draft.places) != null ? _draft_places : draft.operation === 'currency' ? 2 : 0,
+                                    onChange: (event)=>setDraft(_extends({}, draft, {
+                                            places: Number(event.target.value)
+                                        })),
+                                    size: "small",
+                                    sx: {
+                                        width: 150
+                                    },
+                                    children: [
+                                        0,
+                                        1,
+                                        2,
+                                        3,
+                                        4
+                                    ].map((places)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                            value: places,
+                                            children: String(places)
+                                        }, places))
+                                }) : null,
+                                draft.operation === 'join' ? /*#__PURE__*/ _jsx(TextField, {
+                                    select: true,
+                                    label: "Between each",
+                                    value: (_draft_separator = draft.separator) != null ? _draft_separator : ' ',
+                                    onChange: (event)=>setDraft(_extends({}, draft, {
+                                            separator: event.target.value
+                                        })),
+                                    size: "small",
+                                    sx: {
+                                        width: 160
+                                    },
+                                    children: SEPARATORS.map((separator)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                            value: separator.value,
+                                            children: separator.label
+                                        }, separator.label))
+                                }) : null
+                            ]
+                        }),
+                        /*#__PURE__*/ _jsx(Typography, {
+                            variant: "caption",
+                            color: "text.secondary",
+                            children: expression ? `The box will read: ${expression}` : 'Choose every value to finish the formula.'
+                        })
+                    ]
+                })
+            }),
+            /*#__PURE__*/ _jsxs(DialogActions, {
+                children: [
+                    /*#__PURE__*/ _jsx(Button, {
+                        onClick: onClose,
+                        children: 'Cancel'
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        variant: "contained",
+                        disabled: !expression,
+                        onClick: ()=>{
+                            if (!expression) return;
+                            onUse(expression);
+                            onClose();
+                        },
+                        children: 'Use formula'
+                    })
+                ]
+            })
+        ]
+    });
+}
+
+//# sourceMappingURL=formula-builder-dialog.component.js.map

package/src/lib/components/formula-builder-dialog.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/logic/src/lib/components/formula-builder-dialog.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n'use client'\n\nimport {\n  Button,\n  Dialog,\n  DialogActions,\n  DialogContent,\n  DialogTitle,\n  IconButton,\n  ListSubheader,\n  MenuItem,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport { type ReactNode, useState } from 'react'\nimport {\n  buildFormula,\n  FORMULA_OPERATION_ORDER,\n  FORMULA_OPERATIONS,\n  type FormulaDraft,\n  type FormulaOperand,\n  type FormulaOperation,\n  formulaDraftFor,\n  formulaOperandLabel,\n} from '../model/formula'\nimport type { FormulaName } from '../model/formula-names'\n\nconst SOURCE_LABELS: Record<FormulaOperand['source'], string> = {\n  name: 'A value',\n  number: 'A number',\n  text: 'Some text',\n  current: 'What is there now',\n}\n\nconst SEPARATORS: { value: string; label: string }[] = [\n  { value: ' ', label: 'A space' },\n  { value: ', ', label: 'A comma' },\n  { value: ' - ', label: 'A dash' },\n  { value: '', label: 'Nothing' },\n]\n\nconst SYMBOLS = ['$', '€', '£', '¥', '']\n\nfunction NameSelect(props: {\n  label: string\n  value: string\n  names: readonly FormulaName[]\n  onChange: (value: string) => void\n}) {\n  const { label, value, names, onChange } = props\n  const items: ReactNode[] = []\n  let group: string | null = null\n  for (const option of names) {\n    if (option.group !== group) {\n      group = option.group\n      items.push(<ListSubheader key={`group:${group}`}>{group}</ListSubheader>)\n    }\n    items.push(\n      <MenuItem key={option.value} value={option.value}>\n        {option.label}\n      </MenuItem>,\n    )\n  }\n  return (\n    <TextField\n      select\n      label={label}\n      value={names.some((option) => option.value === value) ? value : ''}\n      onChange={(event) => onChange(event.target.value)}\n      size=\"small\"\n      sx={{ flex: 1 }}\n    >\n      {items.length ? items : <MenuItem disabled>{'Nothing to pick yet'}</MenuItem>}\n    </TextField>\n  )\n}\n\nfunction OperandRow(props: {\n  label: string\n  operand: FormulaOperand\n  names: readonly FormulaName[]\n  hasCurrent: boolean\n  onChange: (operand: FormulaOperand) => void\n  onRemove?: () => void\n}) {\n  const { label, operand, names, hasCurrent, onChange, onRemove } = props\n  const sources = (Object.keys(SOURCE_LABELS) as FormulaOperand['source'][]).filter(\n    (source) => source !== 'current' || hasCurrent,\n  )\n  return (\n    <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n      <TextField\n        select\n        label={label}\n        value={operand.source}\n        onChange={(event) => {\n          const source = event.target.value as FormulaOperand['source']\n          onChange(\n            source === 'name'\n              ? { source, name: '' }\n              : source === 'current'\n                ? { source }\n                : { source, value: '' },\n          )\n        }}\n        size=\"small\"\n        sx={{ width: 170 }}\n      >\n        {sources.map((source) => (\n          <MenuItem key={source} value={source}>\n            {SOURCE_LABELS[source]}\n          </MenuItem>\n        ))}\n      </TextField>\n      {operand.source === 'name' ? (\n        <NameSelect\n          label=\"Which\"\n          value={operand.name}\n          names={names}\n          onChange={(name) => onChange({ source: 'name', name })}\n        />\n      ) : operand.source === 'number' ? (\n        <TextField\n          label=\"Number\"\n          value={operand.value}\n          onChange={(event) =>\n            onChange({\n              source: 'number',\n              value: event.target.value.replace(/[^0-9.-]/g, ''),\n            })\n          }\n          slotProps={{ htmlInput: { inputMode: 'decimal' } }}\n          size=\"small\"\n          sx={{ flex: 1 }}\n        />\n      ) : operand.source === 'text' ? (\n        <TextField\n          label=\"Text\"\n          value={operand.value}\n          onChange={(event) =>\n            onChange({ source: 'text', value: event.target.value })\n          }\n          size=\"small\"\n          sx={{ flex: 1 }}\n        />\n      ) : (\n        <Typography variant=\"body2\" color=\"text.secondary\" sx={{ flex: 1 }}>\n          {'The formula already in the box'}\n        </Typography>\n      )}\n      {onRemove ? (\n        <IconButton size=\"small\" aria-label={`Remove ${label}`} onClick={onRemove}>\n          {'×'}\n        </IconButton>\n      ) : null}\n    </Stack>\n  )\n}\n\nexport interface FormulaBuilderDialogProps {\n  /** What the box holds now; offered as a value so formulas can be layered. */\n  current: string\n  /** Parameters, local variables and site variables, grouped. */\n  names: readonly FormulaName[]\n  /** Receives the expression the builder wrote. */\n  onUse: (expression: string) => void\n  onClose: () => void\n}\n\n/**\n * The \"Build formula\" dialog (AGL-3757): pick what to work out — add,\n * smallest of, format as money — and the values it works on, and the box\n * gets the expression that does it. Nothing is typed but numbers and text.\n * Its own chunk, loaded the first time an ƒx button is pressed.\n */\nexport default function FormulaBuilderDialog(props: FormulaBuilderDialogProps) {\n  const { current, names, onUse, onClose } = props\n  const [draft, setDraft] = useState<FormulaDraft>(() =>\n    formulaDraftFor(current.trim() ? 'add' : 'value', undefined, current),\n  )\n  const spec = FORMULA_OPERATIONS[draft.operation]\n  const expression = buildFormula(draft, current)\n  const setOperand = (index: number, operand: FormulaOperand) =>\n    setDraft((previous) => ({\n      ...previous,\n      operands: previous.operands.map((item, at) => (at === index ? operand : item)),\n    }))\n  return (\n    <Dialog open onClose={onClose} fullWidth maxWidth=\"sm\">\n      <DialogTitle>{'Build formula'}</DialogTitle>\n      <DialogContent>\n        <Stack spacing={2} sx={{ pt: 1 }}>\n          <TextField\n            select\n            label=\"Work out\"\n            value={draft.operation}\n            onChange={(event) =>\n              setDraft(\n                formulaDraftFor(event.target.value as FormulaOperation, draft, current),\n              )\n            }\n            size=\"small\"\n          >\n            {FORMULA_OPERATION_ORDER.map((operation) => (\n              <MenuItem key={operation} value={operation}>\n                {FORMULA_OPERATIONS[operation].label}\n              </MenuItem>\n            ))}\n          </TextField>\n          {draft.operands.map((operand, index) => (\n            <OperandRow\n              key={index}\n              label={formulaOperandLabel(draft.operation, index)}\n              operand={operand}\n              names={names}\n              hasCurrent={Boolean(current.trim())}\n              onChange={(next) => setOperand(index, next)}\n              onRemove={\n                spec.variadic && index >= spec.minOperands\n                  ? () =>\n                      setDraft({\n                        ...draft,\n                        operands: draft.operands.filter((_, at) => at !== index),\n                      })\n                  : undefined\n              }\n            />\n          ))}\n          {spec.variadic ? (\n            <Button\n              size=\"small\"\n              sx={{ alignSelf: 'flex-start' }}\n              onClick={() =>\n                setDraft({\n                  ...draft,\n                  operands: [\n                    ...draft.operands,\n                    draft.operation === 'join'\n                      ? { source: 'text', value: '' }\n                      : { source: 'name', name: '' },\n                  ],\n                })\n              }\n            >\n              {'Add another'}\n            </Button>\n          ) : null}\n          <Stack direction=\"row\" spacing={1}>\n            {draft.operation === 'currency' ? (\n              <TextField\n                select\n                label=\"Sign\"\n                value={draft.symbol ?? '$'}\n                onChange={(event) => setDraft({ ...draft, symbol: event.target.value })}\n                size=\"small\"\n                sx={{ width: 110 }}\n              >\n                {SYMBOLS.map((symbol) => (\n                  <MenuItem key={symbol || 'none'} value={symbol}>\n                    {symbol || 'None'}\n                  </MenuItem>\n                ))}\n              </TextField>\n            ) : null}\n            {spec.places ? (\n              <TextField\n                select\n                label=\"Decimal places\"\n                value={draft.places ?? (draft.operation === 'currency' ? 2 : 0)}\n                onChange={(event) =>\n                  setDraft({ ...draft, places: Number(event.target.value) })\n                }\n                size=\"small\"\n                sx={{ width: 150 }}\n              >\n                {[0, 1, 2, 3, 4].map((places) => (\n                  <MenuItem key={places} value={places}>\n                    {String(places)}\n                  </MenuItem>\n                ))}\n              </TextField>\n            ) : null}\n            {draft.operation === 'join' ? (\n              <TextField\n                select\n                label=\"Between each\"\n                value={draft.separator ?? ' '}\n                onChange={(event) => setDraft({ ...draft, separator: event.target.value })}\n                size=\"small\"\n                sx={{ width: 160 }}\n              >\n                {SEPARATORS.map((separator) => (\n                  <MenuItem key={separator.label} value={separator.value}>\n                    {separator.label}\n                  </MenuItem>\n                ))}\n              </TextField>\n            ) : null}\n          </Stack>\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {expression\n              ? `The box will read: ${expression}`\n              : 'Choose every value to finish the formula.'}\n          </Typography>\n        </Stack>\n      </DialogContent>\n      <DialogActions>\n        <Button onClick={onClose}>{'Cancel'}</Button>\n        <Button\n          variant=\"contained\"\n          disabled={!expression}\n          onClick={() => {\n            if (!expression) return\n            onUse(expression)\n            onClose()\n          }}\n        >\n          {'Use formula'}\n        </Button>\n      </DialogActions>\n    </Dialog>\n  )\n}\n"],"names":["Button","Dialog","DialogActions","DialogContent","DialogTitle","IconButton","ListSubheader","MenuItem","Stack","TextField","Typography","useState","buildFormula","FORMULA_OPERATION_ORDER","FORMULA_OPERATIONS","formulaDraftFor","formulaOperandLabel","SOURCE_LABELS","name","number","text","current","SEPARATORS","value","label","SYMBOLS","NameSelect","props","names","onChange","items","group","option","push","select","some","event","target","size","sx","flex","length","disabled","OperandRow","operand","hasCurrent","onRemove","sources","Object","keys","filter","source","direction","spacing","alignItems","width","map","replace","slotProps","htmlInput","inputMode","variant","color","aria-label","onClick","FormulaBuilderDialog","draft","onUse","onClose","setDraft","trim","undefined","spec","operation","expression","setOperand","index","previous","operands","item","at","open","fullWidth","maxWidth","pt","Boolean","next","variadic","minOperands","_","alignSelf","symbol","places","Number","String","separator"],"mappings":"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"}

package/src/lib/components/formula-builder.component.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { FormulaName } from '../model/formula-names';
+export interface FormulaBuilderButtonProps {
+    /** What the box holds now; offered as a value so formulas can be layered. */
+    current: string;
+    /** Parameters, local variables and site variables, grouped. */
+    names: readonly FormulaName[];
+    /** Receives the expression the builder wrote. */
+    onUse: (expression: string) => void;
+    /** Called as the dialog opens — where a caller loads names it reads lazily. */
+    onOpen?: () => void;
+}
+/** The ƒx "Build formula" button beside an expression box (AGL-3757). */
+export declare function FormulaBuilderButton(props: FormulaBuilderButtonProps): import("react").JSX.Element;
+export default FormulaBuilderButton;

package/src/lib/components/formula-builder.component.js

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { IconButton, Tooltip, Typography } from "@mui/material";
+import { lazy, Suspense, useState } from "react";
+// The dialog is its own chunk: a function editor that never presses ƒx
+// never downloads it.
+const FormulaBuilderDialog = /*#__PURE__*/ lazy(()=>import("./formula-builder-dialog.component.js"));
+/** The ƒx "Build formula" button beside an expression box (AGL-3757). */ export function FormulaBuilderButton(props) {
+    const { current, names, onUse, onOpen } = props;
+    const [open, setOpen] = useState(false);
+    return /*#__PURE__*/ _jsxs(_Fragment, {
+        children: [
+            /*#__PURE__*/ _jsx(Tooltip, {
+                title: "Build formula",
+                children: /*#__PURE__*/ _jsx(IconButton, {
+                    size: "small",
+                    "aria-label": "Build formula",
+                    onClick: ()=>{
+                        onOpen == null ? void 0 : onOpen();
+                        setOpen(true);
+                    },
+                    children: /*#__PURE__*/ _jsx(Typography, {
+                        component: "span",
+                        sx: {
+                            fontStyle: 'italic',
+                            fontWeight: 600,
+                            lineHeight: 1
+                        },
+                        children: 'ƒx'
+                    })
+                })
+            }),
+            open ? /*#__PURE__*/ _jsx(Suspense, {
+                fallback: null,
+                children: /*#__PURE__*/ _jsx(FormulaBuilderDialog, {
+                    current: current,
+                    names: names,
+                    onUse: onUse,
+                    onClose: ()=>setOpen(false)
+                })
+            }) : null
+        ]
+    });
+}
+export default FormulaBuilderButton;
+
+//# sourceMappingURL=formula-builder.component.js.map

package/src/lib/components/formula-builder.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/logic/src/lib/components/formula-builder.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n'use client'\n\nimport { IconButton, Tooltip, Typography } from '@mui/material'\nimport { lazy, Suspense, useState } from 'react'\nimport type { FormulaName } from '../model/formula-names'\n\n// The dialog is its own chunk: a function editor that never presses ƒx\n// never downloads it.\nconst FormulaBuilderDialog = lazy(() => import('./formula-builder-dialog.component'))\n\nexport interface FormulaBuilderButtonProps {\n  /** What the box holds now; offered as a value so formulas can be layered. */\n  current: string\n  /** Parameters, local variables and site variables, grouped. */\n  names: readonly FormulaName[]\n  /** Receives the expression the builder wrote. */\n  onUse: (expression: string) => void\n  /** Called as the dialog opens — where a caller loads names it reads lazily. */\n  onOpen?: () => void\n}\n\n/** The ƒx \"Build formula\" button beside an expression box (AGL-3757). */\nexport function FormulaBuilderButton(props: FormulaBuilderButtonProps) {\n  const { current, names, onUse, onOpen } = props\n  const [open, setOpen] = useState(false)\n  return (\n    <>\n      <Tooltip title=\"Build formula\">\n        <IconButton\n          size=\"small\"\n          aria-label=\"Build formula\"\n          onClick={() => {\n            onOpen?.()\n            setOpen(true)\n          }}\n        >\n          <Typography\n            component=\"span\"\n            sx={{ fontStyle: 'italic', fontWeight: 600, lineHeight: 1 }}\n          >\n            {'ƒx'}\n          </Typography>\n        </IconButton>\n      </Tooltip>\n      {open ? (\n        <Suspense fallback={null}>\n          <FormulaBuilderDialog\n            current={current}\n            names={names}\n            onUse={onUse}\n            onClose={() => setOpen(false)}\n          />\n        </Suspense>\n      ) : null}\n    </>\n  )\n}\n\nexport default FormulaBuilderButton\n"],"names":["IconButton","Tooltip","Typography","lazy","Suspense","useState","FormulaBuilderDialog","FormulaBuilderButton","props","current","names","onUse","onOpen","open","setOpen","title","size","aria-label","onClick","component","sx","fontStyle","fontWeight","lineHeight","fallback","onClose"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;AAEA,SAASA,UAAU,EAAEC,OAAO,EAAEC,UAAU,QAAQ,gBAAe;AAC/D,SAASC,IAAI,EAAEC,QAAQ,EAAEC,QAAQ,QAAQ,QAAO;AAGhD,uEAAuE;AACvE,sBAAsB;AACtB,MAAMC,qCAAuBH,KAAK,IAAM,MAAM,CAAC;AAa/C,uEAAuE,GACvE,OAAO,SAASI,qBAAqBC,KAAgC;IACnE,MAAM,EAAEC,OAAO,EAAEC,KAAK,EAAEC,KAAK,EAAEC,MAAM,EAAE,GAAGJ;IAC1C,MAAM,CAACK,MAAMC,QAAQ,GAAGT,SAAS;IACjC,qBACE;;0BACE,KAACJ;gBAAQc,OAAM;0BACb,cAAA,KAACf;oBACCgB,MAAK;oBACLC,cAAW;oBACXC,SAAS;wBACPN,0BAAAA;wBACAE,QAAQ;oBACV;8BAEA,cAAA,KAACZ;wBACCiB,WAAU;wBACVC,IAAI;4BAAEC,WAAW;4BAAUC,YAAY;4BAAKC,YAAY;wBAAE;kCAEzD;;;;YAINV,qBACC,KAACT;gBAASoB,UAAU;0BAClB,cAAA,KAAClB;oBACCG,SAASA;oBACTC,OAAOA;oBACPC,OAAOA;oBACPc,SAAS,IAAMX,QAAQ;;iBAGzB;;;AAGV;AAEA,eAAeP,qBAAoB"}