@aglyn/plugins-mui 1.0.0-beta.143

package/src/lib/components/function-scope.js

@@ -0,0 +1,478 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @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 * as Aglyn from "@aglyn/aglyn";
+import { mdiCalculatorVariantOutline, mdiEyeOutline, mdiFormTextbox, mdiFunctionVariant } from "@aglyn/shared-data-mdi";
+import Box from "@mui/material/Box";
+import { createContext, forwardRef, Fragment, useCallback, useContext, useMemo, useState } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { generatePresetId } from "../utils/generate-preset-id.js";
+import { FUNCTION_CONTROL_KINDS, FunctionParameterControl, displayFunctionValue, initialFunctionArguments, isFunctionValueTruthy } from "./function-controls.js";
+/**
+ * A CALCULATOR AN AUTHOR LAYS OUT (AGL-3202).
+ *
+ * The Function Widget draws a whole calculator itself: inputs in a row, a
+ * button, a result. That is the right block for "a quote in a sidebar" and
+ * the wrong one for the page that prompted this — a comparison with a number
+ * box AND quick picks on the same value, two questions asked as lists, a
+ * table of five rows where four can be filtered away, one row highlighted, a
+ * sentence under it and a footnote that changes with the choices. No amount
+ * of options on one block reaches that, and it should not have to: laying
+ * things out is what the canvas is for.
+ *
+ * So the pieces are separate elements, and one function binds them:
+ *
+ * - **Calculator** (`functionScope`) holds the function, the visitor's
+ *   answers and the live result, and is an ordinary container.
+ * - **Calculator Input** (`functionInput`) asks ONE parameter, as a number
+ *   box, a list, a switch or a row of quick-pick chips. Two inputs may ask
+ *   the same parameter; they stay in step because the answer lives above
+ *   them.
+ * - **Calculator Result** (`functionOutput`) shows one named value, styled
+ *   like any text.
+ * - **Show When** (`functionShow`) is a container that appears only while a
+ *   named value is truthy — a table row a filter can remove.
+ *
+ * Everything between them is whatever the author builds: stacks, grids,
+ * headings, borders. The design is theirs and the arithmetic is the site's
+ * function, reading the site's variables.
+ */ // Component ids are persisted in screen documents; never rename.
+export const SCOPE_ID = 'functionScope';
+export const INPUT_ID = 'functionInput';
+export const OUTPUT_ID = 'functionOutput';
+export const SHOW_ID = 'functionShow';
+const FunctionScopeContext = /*#__PURE__*/ createContext(null);
+const FunctionScope = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const { functionName: _functionName, children, definition, globals } = props, rest = _object_without_properties_loose(props, [
+        "functionName",
+        "children",
+        "definition",
+        "globals"
+    ]);
+    const [args, setArgs] = useState(()=>initialFunctionArguments(definition));
+    const setArgument = useCallback((name, value)=>{
+        setArgs((previous)=>_extends({}, previous, {
+                [name]: value
+            }));
+    }, []);
+    // Always live: a calculator laid out on a page has no single place a
+    // "Calculate" button would obviously go, and every result can be on
+    // screen at once. The Function Widget is the block with a button.
+    const run = useMemo(()=>definition ? Aglyn.evaluateHostFunction(definition, args, {
+            globals
+        }) : null, [
+        definition,
+        args,
+        globals
+    ]);
+    const value = useMemo(()=>({
+            definition,
+            args,
+            setArgument,
+            run
+        }), [
+        definition,
+        args,
+        setArgument,
+        run
+    ]);
+    return /*#__PURE__*/ _jsx(FunctionScopeContext.Provider, {
+        value: value,
+        children: /*#__PURE__*/ _jsx(Box, _extends({
+            ref: ref
+        }, rest, {
+            children: children
+        }))
+    });
+});
+FunctionScope.displayName = 'AglynFunctionScope';
+const FunctionInput = /*#__PURE__*/ forwardRef((props, ref)=>{
+    var _ref, _ref1;
+    var _scope_definition_parameters, _scope_definition;
+    const { parameter, control, label, hideLabel, choices } = props, rest = _object_without_properties_loose(props, [
+        "parameter",
+        "control",
+        "label",
+        "hideLabel",
+        "choices"
+    ]);
+    const scope = useContext(FunctionScopeContext);
+    const { suppressNavigation } = useContext(Aglyn.ScreenLinkContext);
+    const name = String(parameter != null ? parameter : '').trim();
+    const declared = scope == null ? void 0 : (_scope_definition = scope.definition) == null ? void 0 : (_scope_definition_parameters = _scope_definition.parameters) == null ? void 0 : _scope_definition_parameters.find((candidate)=>candidate.name === name);
+    const ownChoices = useMemo(()=>Aglyn.parseFunctionParameterOptions(choices), [
+        choices
+    ]);
+    const options = ownChoices.length ? ownChoices : (_ref = declared == null ? void 0 : declared.options) != null ? _ref : [];
+    // No function to ask on behalf of: the besigner, or a page whose function
+    // was deleted. In the besigner the control is still DRAWN, from its own
+    // attributes, so a calculator can be designed before it works. On a
+    // published page a control that can set nothing is residue, not a
+    // question, and a visitor is shown nothing.
+    const inert = !(scope == null ? void 0 : scope.definition) || !declared;
+    if (inert && !suppressNavigation) return null;
+    return /*#__PURE__*/ _jsx(Box, _extends({
+        ref: ref
+    }, rest, {
+        children: /*#__PURE__*/ _jsx(FunctionParameterControl, {
+            name: name || 'parameter',
+            type: declared == null ? void 0 : declared.type,
+            required: declared == null ? void 0 : declared.required,
+            control: control,
+            label: (label == null ? void 0 : label.trim()) || (declared == null ? void 0 : declared.label),
+            hideLabel: Boolean(hideLabel),
+            options: options,
+            value: inert ? '' : (_ref1 = scope == null ? void 0 : scope.args[name]) != null ? _ref1 : '',
+            onChange: (next)=>scope == null ? void 0 : scope.setArgument(name, next),
+            disabled: inert,
+            width: "100%"
+        })
+    }));
+});
+FunctionInput.displayName = 'AglynFunctionInput';
+const OUTPUT_ELEMENTS = [
+    'div',
+    'p',
+    'span'
+];
+/**
+ * `**like this**` becomes emphasis, and nothing else is markup. The value is
+ * text a function built — often from what a visitor typed — so it is split
+ * into React nodes and never parsed as HTML.
+ */ export function renderFunctionEmphasis(text) {
+    const parts = text.split(/\*\*(.+?)\*\*/g);
+    if (parts.length === 1) return text;
+    return parts.map((part, index)=>index % 2 === 1 ? /*#__PURE__*/ _jsx("strong", {
+            children: part
+        }, index) : /*#__PURE__*/ _jsx(Fragment, {
+            children: part
+        }, index));
+}
+const FunctionOutput = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const { name, placeholder, announce, element } = props, rest = _object_without_properties_loose(props, [
+        "name",
+        "placeholder",
+        "announce",
+        "element"
+    ]);
+    const scope = useContext(FunctionScopeContext);
+    const { suppressNavigation } = useContext(Aglyn.ScreenLinkContext);
+    const key = String(name != null ? name : '').trim();
+    const run = scope == null ? void 0 : scope.run;
+    let text = '';
+    if (run == null ? void 0 : run.ok) {
+        text = displayFunctionValue(key ? run.scope[key] : run.value);
+    } else if (suppressNavigation || !(scope == null ? void 0 : scope.definition)) {
+        // Designing: show what will stand here. On a published page a missing
+        // function shows nothing rather than a placeholder dressed as a price.
+        text = suppressNavigation ? placeholder || (key ? `{${key}}` : '{result}') : '';
+    }
+    if (!text) return null;
+    const tag = OUTPUT_ELEMENTS.includes(element) ? element : 'div';
+    return /*#__PURE__*/ _jsx(Box, _extends({
+        ref: ref,
+        component: tag
+    }, announce ? {
+        'aria-live': 'polite'
+    } : {}, rest, {
+        children: renderFunctionEmphasis(text)
+    }));
+});
+FunctionOutput.displayName = 'AglynFunctionOutput';
+const FunctionShow = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const { when, invert, children } = props, rest = _object_without_properties_loose(props, [
+        "when",
+        "invert",
+        "children"
+    ]);
+    const scope = useContext(FunctionScopeContext);
+    const key = String(when != null ? when : '').trim();
+    const run = scope == null ? void 0 : scope.run;
+    // With nothing to decide on — no function, a failed run, no name — the
+    // contents SHOW. Hiding is the exceptional state, and a designer has to
+    // be able to see the row they are laying out.
+    const decided = Boolean((run == null ? void 0 : run.ok) && key);
+    const truthy = (run == null ? void 0 : run.ok) ? isFunctionValueTruthy(run.scope[key]) : true;
+    if (decided && truthy === Boolean(invert)) return null;
+    return /*#__PURE__*/ _jsx(Box, _extends({
+        ref: ref
+    }, rest, {
+        children: children
+    }));
+});
+FunctionShow.displayName = 'AglynFunctionShow';
+// ── Schemas ────────────────────────────────────────────────────────────────
+const ICON_COLOR = '#7b1fa2';
+const CONTROL_LABELS = {
+    auto: 'Automatic',
+    number: 'Number box',
+    text: 'Text box',
+    select: 'List',
+    chips: 'Quick picks',
+    switch: 'Switch'
+};
+export const schema = {
+    $id: SCOPE_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Calculator',
+    description: 'A container bound to one of your functions. Put Calculator Inputs and ' + 'Calculator Results anywhere inside it and lay them out however you like.',
+    category: Aglyn.ComponentCategory.INPUT,
+    icon: {
+        path: mdiCalculatorVariantOutline.path,
+        sx: {
+            color: ICON_COLOR
+        }
+    },
+    attributes: [
+        {
+            name: 'functionName',
+            description: 'Name of a function from the site’s Functions card. Every input and ' + 'result inside this container reads it.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'Function name'
+        }
+    ]
+};
+export const functionInputSchema = {
+    $id: INPUT_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Calculator Input',
+    description: 'Asks one parameter of the Calculator it sits in: a number box, a list, ' + 'a switch, or quick-pick chips.',
+    category: Aglyn.ComponentCategory.INPUT,
+    icon: {
+        path: mdiFormTextbox.path,
+        sx: {
+            color: ICON_COLOR
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'parameter',
+            description: 'The function parameter this control sets.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'Parameter'
+        },
+        {
+            name: 'control',
+            description: 'Automatic follows the parameter: a list when it has choices, a ' + 'number box for a number, a switch for a true/false. Quick picks ' + 'are buttons that set the value, for beside a number box.',
+            component: Aglyn.FieldComponentType.SELECT,
+            label: 'Ask as',
+            options: FUNCTION_CONTROL_KINDS.map((kind)=>({
+                    value: kind,
+                    label: CONTROL_LABELS[kind]
+                }))
+        },
+        {
+            name: 'choices',
+            description: 'The choices for a list or quick picks, as "value: Label, value: ' + 'Label" — or just "10, 25, 50, 100". Leave empty to use the ' + 'choices the function gives the parameter.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'Choices'
+        },
+        {
+            name: 'label',
+            description: 'Shown above the control instead of the parameter’s own label.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'Label'
+        },
+        {
+            name: 'hideLabel',
+            description: 'If true, the label is not drawn. It is still read to assistive ' + 'technology, so give one either way.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            label: 'Hide the label?'
+        }
+    ]
+};
+export const functionOutputSchema = {
+    $id: OUTPUT_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Calculator Result',
+    description: 'Shows one value from the Calculator it sits in, updated as the visitor ' + 'answers. Style it like any text.',
+    category: Aglyn.ComponentCategory.INPUT,
+    icon: {
+        path: mdiFunctionVariant.path,
+        sx: {
+            color: ICON_COLOR
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'name',
+            description: 'A parameter or variable of the function. Leave empty for the ' + 'function’s return value. Text the function wraps in **two ' + 'asterisks** is emphasized; nothing appears while the value is empty.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'Value'
+        },
+        {
+            name: 'placeholder',
+            description: 'What the besigner shows here, e.g. $625. Visitors never see it.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'Placeholder'
+        },
+        {
+            name: 'element',
+            description: 'The HTML element. Use span inside a line of text.',
+            component: Aglyn.FieldComponentType.SELECT,
+            label: 'Element',
+            options: [
+                {
+                    value: 'div',
+                    label: 'Block (div)'
+                },
+                {
+                    value: 'p',
+                    label: 'Paragraph (p)'
+                },
+                {
+                    value: 'span',
+                    label: 'Inline (span)'
+                }
+            ]
+        },
+        {
+            name: 'announce',
+            description: 'If true, a screen reader reads each change. Turn it on for one ' + 'result per calculator — usually the sentence, not every number.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            label: 'Read changes aloud?'
+        }
+    ]
+};
+export const functionShowSchema = {
+    $id: SHOW_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Show When',
+    description: 'A container inside a Calculator that appears only while one of the ' + 'function’s values is true, non-zero or non-empty.',
+    category: Aglyn.ComponentCategory.INPUT,
+    icon: {
+        path: mdiEyeOutline.path,
+        sx: {
+            color: ICON_COLOR
+        }
+    },
+    attributes: [
+        {
+            name: 'when',
+            description: 'A parameter or variable of the function. The contents show while ' + 'it is true, a number other than zero, or text that is not empty.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'Show when'
+        },
+        {
+            name: 'invert',
+            description: 'If true, the contents show while the value is NOT true.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            label: 'Show when it is not?'
+        }
+    ]
+};
+export const presets = [
+    {
+        $id: generatePresetId(SCOPE_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Calculator',
+        pluginId: BUNDLE_ID,
+        description: 'A container bound to a function — lay out inputs and results inside',
+        category: Aglyn.ComponentCategory.INPUT,
+        icon: {
+            path: mdiCalculatorVariantOutline.path,
+            sx: {
+                color: ICON_COLOR
+            }
+        },
+        data: {
+            $id: null,
+            componentId: SCOPE_ID,
+            pluginId: BUNDLE_ID,
+            props: {}
+        }
+    }
+];
+export const functionInputPresets = [
+    {
+        $id: generatePresetId(INPUT_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Calculator Input',
+        pluginId: BUNDLE_ID,
+        description: 'Asks one parameter of the Calculator it sits in',
+        category: Aglyn.ComponentCategory.INPUT,
+        icon: {
+            path: mdiFormTextbox.path,
+            sx: {
+                color: ICON_COLOR
+            }
+        },
+        data: {
+            $id: null,
+            componentId: INPUT_ID,
+            pluginId: BUNDLE_ID,
+            props: {
+                control: 'auto'
+            }
+        }
+    }
+];
+export const functionOutputPresets = [
+    {
+        $id: generatePresetId(OUTPUT_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Calculator Result',
+        pluginId: BUNDLE_ID,
+        description: 'Shows one value from the Calculator it sits in',
+        category: Aglyn.ComponentCategory.INPUT,
+        icon: {
+            path: mdiFunctionVariant.path,
+            sx: {
+                color: ICON_COLOR
+            }
+        },
+        data: {
+            $id: null,
+            componentId: OUTPUT_ID,
+            pluginId: BUNDLE_ID,
+            props: {}
+        }
+    }
+];
+export const functionShowPresets = [
+    {
+        $id: generatePresetId(SHOW_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Show When',
+        pluginId: BUNDLE_ID,
+        description: 'Appears only while a Calculator value is true',
+        category: Aglyn.ComponentCategory.INPUT,
+        icon: {
+            path: mdiEyeOutline.path,
+            sx: {
+                color: ICON_COLOR
+            }
+        },
+        data: {
+            $id: null,
+            componentId: SHOW_ID,
+            pluginId: BUNDLE_ID,
+            props: {}
+        }
+    }
+];
+export { FunctionInput, FunctionOutput, FunctionShow };
+export default FunctionScope;
+
+//# sourceMappingURL=function-scope.js.map

package/src/lib/components/function-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/function-scope.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\nimport * as Aglyn from '@aglyn/aglyn'\nimport {\n  mdiCalculatorVariantOutline,\n  mdiEyeOutline,\n  mdiFormTextbox,\n  mdiFunctionVariant,\n} from '@aglyn/shared-data-mdi'\nimport Box from '@mui/material/Box'\nimport {\n  createContext,\n  forwardRef,\n  Fragment,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n  type ReactNode,\n} from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { generatePresetId } from '../utils/generate-preset-id'\nimport {\n  FUNCTION_CONTROL_KINDS,\n  FunctionParameterControl,\n  displayFunctionValue,\n  initialFunctionArguments,\n  isFunctionValueTruthy,\n  type FunctionControlKind,\n} from './function-controls'\n\n/**\n * A CALCULATOR AN AUTHOR LAYS OUT (AGL-3202).\n *\n * The Function Widget draws a whole calculator itself: inputs in a row, a\n * button, a result. That is the right block for \"a quote in a sidebar\" and\n * the wrong one for the page that prompted this — a comparison with a number\n * box AND quick picks on the same value, two questions asked as lists, a\n * table of five rows where four can be filtered away, one row highlighted, a\n * sentence under it and a footnote that changes with the choices. No amount\n * of options on one block reaches that, and it should not have to: laying\n * things out is what the canvas is for.\n *\n * So the pieces are separate elements, and one function binds them:\n *\n * - **Calculator** (`functionScope`) holds the function, the visitor's\n *   answers and the live result, and is an ordinary container.\n * - **Calculator Input** (`functionInput`) asks ONE parameter, as a number\n *   box, a list, a switch or a row of quick-pick chips. Two inputs may ask\n *   the same parameter; they stay in step because the answer lives above\n *   them.\n * - **Calculator Result** (`functionOutput`) shows one named value, styled\n *   like any text.\n * - **Show When** (`functionShow`) is a container that appears only while a\n *   named value is truthy — a table row a filter can remove.\n *\n * Everything between them is whatever the author builds: stacks, grids,\n * headings, borders. The design is theirs and the arithmetic is the site's\n * function, reading the site's variables.\n */\n\n// Component ids are persisted in screen documents; never rename.\nexport const SCOPE_ID: Aglyn.ComponentId = 'functionScope'\nexport const INPUT_ID: Aglyn.ComponentId = 'functionInput'\nexport const OUTPUT_ID: Aglyn.ComponentId = 'functionOutput'\nexport const SHOW_ID: Aglyn.ComponentId = 'functionShow'\n\ninterface FunctionScopeValue {\n  definition?: Aglyn.HostFunction\n  args: Record<string, string>\n  setArgument: (name: string, value: string) => void\n  run: Aglyn.FunctionRunResult | null\n}\n\nconst FunctionScopeContext = createContext<FunctionScopeValue | null>(null)\n\n// ── Calculator ─────────────────────────────────────────────────────────────\n\nexport interface FunctionScopeProps {\n  /** Name of the site function every element inside is bound to. */\n  functionName?: string\n  children?: ReactNode\n  /** Injected at compose (attachFunctionDefinitions); never authored. */\n  definition?: Aglyn.HostFunction\n  /** The site variables the function names; injected beside `definition`. */\n  globals?: Record<string, number | string | boolean>\n}\n\nconst FunctionScope = forwardRef<HTMLDivElement, FunctionScopeProps>(\n  (props, ref) => {\n    const { functionName: _functionName, children, definition, globals, ...rest } = props\n    const [args, setArgs] = useState<Record<string, string>>(() =>\n      initialFunctionArguments(definition),\n    )\n    const setArgument = useCallback((name: string, value: string) => {\n      setArgs((previous) => ({ ...previous, [name]: value }))\n    }, [])\n    // Always live: a calculator laid out on a page has no single place a\n    // \"Calculate\" button would obviously go, and every result can be on\n    // screen at once. The Function Widget is the block with a button.\n    const run = useMemo(\n      () =>\n        definition\n          ? Aglyn.evaluateHostFunction(definition, args, { globals })\n          : null,\n      [definition, args, globals],\n    )\n    const value = useMemo(\n      () => ({ definition, args, setArgument, run }),\n      [definition, args, setArgument, run],\n    )\n    return (\n      <FunctionScopeContext.Provider value={value}>\n        <Box ref={ref} {...rest}>\n          {children}\n        </Box>\n      </FunctionScopeContext.Provider>\n    )\n  },\n)\nFunctionScope.displayName = 'AglynFunctionScope'\n\n// ── Calculator Input ───────────────────────────────────────────────────────\n\nexport interface FunctionInputProps {\n  /** The function parameter this control asks. */\n  parameter?: string\n  control?: FunctionControlKind\n  /** Overrides the parameter's own label. */\n  label?: string\n  hideLabel?: boolean\n  /**\n   * Overrides the parameter's own choices, as `value: Label, value: Label`.\n   * This is how quick picks are given: `10, 25, 50, 100` beside a number box.\n   */\n  choices?: string\n}\n\nconst FunctionInput = forwardRef<HTMLDivElement, FunctionInputProps>(\n  (props, ref) => {\n    const { parameter, control, label, hideLabel, choices, ...rest } = props\n    const scope = useContext(FunctionScopeContext)\n    const { suppressNavigation } = useContext(Aglyn.ScreenLinkContext)\n    const name = String(parameter ?? '').trim()\n    const declared = scope?.definition?.parameters?.find(\n      (candidate) => candidate.name === name,\n    )\n    const ownChoices = useMemo(\n      () => Aglyn.parseFunctionParameterOptions(choices),\n      [choices],\n    )\n    const options = ownChoices.length ? ownChoices : (declared?.options ?? [])\n    // No function to ask on behalf of: the besigner, or a page whose function\n    // was deleted. In the besigner the control is still DRAWN, from its own\n    // attributes, so a calculator can be designed before it works. On a\n    // published page a control that can set nothing is residue, not a\n    // question, and a visitor is shown nothing.\n    const inert = !scope?.definition || !declared\n    if (inert && !suppressNavigation) return null\n    return (\n      <Box ref={ref} {...rest}>\n        <FunctionParameterControl\n          name={name || 'parameter'}\n          type={declared?.type}\n          required={declared?.required}\n          control={control}\n          label={label?.trim() || declared?.label}\n          hideLabel={Boolean(hideLabel)}\n          options={options}\n          value={inert ? '' : (scope?.args[name] ?? '')}\n          onChange={(next) => scope?.setArgument(name, next)}\n          disabled={inert}\n          width=\"100%\"\n        />\n      </Box>\n    )\n  },\n)\nFunctionInput.displayName = 'AglynFunctionInput'\n\n// ── Calculator Result ──────────────────────────────────────────────────────\n\nexport interface FunctionOutputProps {\n  /** A parameter or variable of the function; empty is its return value. */\n  name?: string\n  /** What the besigner shows in the result's place, e.g. `$625`. */\n  placeholder?: string\n  /** Read a change aloud. One result per calculator, usually the sentence. */\n  announce?: boolean\n  element?: 'div' | 'p' | 'span'\n}\n\nconst OUTPUT_ELEMENTS = ['div', 'p', 'span'] as const\n\n/**\n * `**like this**` becomes emphasis, and nothing else is markup. The value is\n * text a function built — often from what a visitor typed — so it is split\n * into React nodes and never parsed as HTML.\n */\nexport function renderFunctionEmphasis(text: string): ReactNode {\n  const parts = text.split(/\\*\\*(.+?)\\*\\*/g)\n  if (parts.length === 1) return text\n  return parts.map((part, index) =>\n    index % 2 === 1 ? (\n      <strong key={index}>{part}</strong>\n    ) : (\n      <Fragment key={index}>{part}</Fragment>\n    ),\n  )\n}\n\nconst FunctionOutput = forwardRef<HTMLElement, FunctionOutputProps>(\n  (props, ref) => {\n    const { name, placeholder, announce, element, ...rest } = props\n    const scope = useContext(FunctionScopeContext)\n    const { suppressNavigation } = useContext(Aglyn.ScreenLinkContext)\n    const key = String(name ?? '').trim()\n    const run = scope?.run\n    let text = ''\n    if (run?.ok) {\n      text = displayFunctionValue(key ? run.scope[key] : run.value)\n    } else if (suppressNavigation || !scope?.definition) {\n      // Designing: show what will stand here. On a published page a missing\n      // function shows nothing rather than a placeholder dressed as a price.\n      text = suppressNavigation ? placeholder || (key ? `{${key}}` : '{result}') : ''\n    }\n    if (!text) return null\n    const tag = OUTPUT_ELEMENTS.includes(element as (typeof OUTPUT_ELEMENTS)[number])\n      ? element\n      : 'div'\n    return (\n      <Box\n        ref={ref}\n        component={tag}\n        {...(announce ? { 'aria-live': 'polite' as const } : {})}\n        {...rest}\n      >\n        {renderFunctionEmphasis(text)}\n      </Box>\n    )\n  },\n)\nFunctionOutput.displayName = 'AglynFunctionOutput'\n\n// ── Show When ──────────────────────────────────────────────────────────────\n\nexport interface FunctionShowProps {\n  /** A parameter or variable of the function. */\n  when?: string\n  /** Show while the value is NOT truthy instead. */\n  invert?: boolean\n  children?: ReactNode\n}\n\nconst FunctionShow = forwardRef<HTMLDivElement, FunctionShowProps>(\n  (props, ref) => {\n    const { when, invert, children, ...rest } = props\n    const scope = useContext(FunctionScopeContext)\n    const key = String(when ?? '').trim()\n    const run = scope?.run\n    // With nothing to decide on — no function, a failed run, no name — the\n    // contents SHOW. Hiding is the exceptional state, and a designer has to\n    // be able to see the row they are laying out.\n    const decided = Boolean(run?.ok && key)\n    const truthy = run?.ok ? isFunctionValueTruthy(run.scope[key]) : true\n    if (decided && truthy === Boolean(invert)) return null\n    return (\n      <Box ref={ref} {...rest}>\n        {children}\n      </Box>\n    )\n  },\n)\nFunctionShow.displayName = 'AglynFunctionShow'\n\n// ── Schemas ────────────────────────────────────────────────────────────────\n\nconst ICON_COLOR = '#7b1fa2'\n\nconst CONTROL_LABELS: Record<FunctionControlKind, string> = {\n  auto: 'Automatic',\n  number: 'Number box',\n  text: 'Text box',\n  select: 'List',\n  chips: 'Quick picks',\n  switch: 'Switch',\n}\n\nexport const schema: Aglyn.ComponentSchema<FunctionScopeProps> = {\n  $id: SCOPE_ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Calculator',\n  description:\n    'A container bound to one of your functions. Put Calculator Inputs and ' +\n    'Calculator Results anywhere inside it and lay them out however you like.',\n  category: Aglyn.ComponentCategory.INPUT,\n  icon: { path: mdiCalculatorVariantOutline.path, sx: { color: ICON_COLOR } },\n  attributes: [\n    {\n      name: 'functionName',\n      description:\n        'Name of a function from the site’s Functions card. Every input and ' +\n        'result inside this container reads it.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Function name',\n    },\n  ],\n}\n\nexport const functionInputSchema: Aglyn.ComponentSchema<FunctionInputProps> = {\n  $id: INPUT_ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Calculator Input',\n  description:\n    'Asks one parameter of the Calculator it sits in: a number box, a list, ' +\n    'a switch, or quick-pick chips.',\n  category: Aglyn.ComponentCategory.INPUT,\n  icon: { path: mdiFormTextbox.path, sx: { color: ICON_COLOR } },\n  flags: { selfClosing: Aglyn.FEATURE_FLAG.ENABLED },\n  attributes: [\n    {\n      name: 'parameter',\n      description: 'The function parameter this control sets.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Parameter',\n    },\n    {\n      name: 'control',\n      description:\n        'Automatic follows the parameter: a list when it has choices, a ' +\n        'number box for a number, a switch for a true/false. Quick picks ' +\n        'are buttons that set the value, for beside a number box.',\n      component: Aglyn.FieldComponentType.SELECT,\n      label: 'Ask as',\n      options: FUNCTION_CONTROL_KINDS.map((kind) => ({\n        value: kind,\n        label: CONTROL_LABELS[kind],\n      })),\n    },\n    {\n      name: 'choices',\n      description:\n        'The choices for a list or quick picks, as \"value: Label, value: ' +\n        'Label\" — or just \"10, 25, 50, 100\". Leave empty to use the ' +\n        'choices the function gives the parameter.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Choices',\n    },\n    {\n      name: 'label',\n      description: 'Shown above the control instead of the parameter’s own label.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Label',\n    },\n    {\n      name: 'hideLabel',\n      description:\n        'If true, the label is not drawn. It is still read to assistive ' +\n        'technology, so give one either way.',\n      component: Aglyn.FieldComponentType.SWITCH,\n      label: 'Hide the label?',\n    },\n  ],\n}\n\nexport const functionOutputSchema: Aglyn.ComponentSchema<FunctionOutputProps> = {\n  $id: OUTPUT_ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Calculator Result',\n  description:\n    'Shows one value from the Calculator it sits in, updated as the visitor ' +\n    'answers. Style it like any text.',\n  category: Aglyn.ComponentCategory.INPUT,\n  icon: { path: mdiFunctionVariant.path, sx: { color: ICON_COLOR } },\n  flags: { selfClosing: Aglyn.FEATURE_FLAG.ENABLED },\n  attributes: [\n    {\n      name: 'name',\n      description:\n        'A parameter or variable of the function. Leave empty for the ' +\n        'function’s return value. Text the function wraps in **two ' +\n        'asterisks** is emphasized; nothing appears while the value is empty.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Value',\n    },\n    {\n      name: 'placeholder',\n      description: 'What the besigner shows here, e.g. $625. Visitors never see it.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Placeholder',\n    },\n    {\n      name: 'element',\n      description: 'The HTML element. Use span inside a line of text.',\n      component: Aglyn.FieldComponentType.SELECT,\n      label: 'Element',\n      options: [\n        { value: 'div', label: 'Block (div)' },\n        { value: 'p', label: 'Paragraph (p)' },\n        { value: 'span', label: 'Inline (span)' },\n      ],\n    },\n    {\n      name: 'announce',\n      description:\n        'If true, a screen reader reads each change. Turn it on for one ' +\n        'result per calculator — usually the sentence, not every number.',\n      component: Aglyn.FieldComponentType.SWITCH,\n      label: 'Read changes aloud?',\n    },\n  ],\n}\n\nexport const functionShowSchema: Aglyn.ComponentSchema<FunctionShowProps> = {\n  $id: SHOW_ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Show When',\n  description:\n    'A container inside a Calculator that appears only while one of the ' +\n    'function’s values is true, non-zero or non-empty.',\n  category: Aglyn.ComponentCategory.INPUT,\n  icon: { path: mdiEyeOutline.path, sx: { color: ICON_COLOR } },\n  attributes: [\n    {\n      name: 'when',\n      description:\n        'A parameter or variable of the function. The contents show while ' +\n        'it is true, a number other than zero, or text that is not empty.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Show when',\n    },\n    {\n      name: 'invert',\n      description: 'If true, the contents show while the value is NOT true.',\n      component: Aglyn.FieldComponentType.SWITCH,\n      label: 'Show when it is not?',\n    },\n  ],\n}\n\nexport const presets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(SCOPE_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Calculator',\n    pluginId: BUNDLE_ID,\n    description: 'A container bound to a function — lay out inputs and results inside',\n    category: Aglyn.ComponentCategory.INPUT,\n    icon: { path: mdiCalculatorVariantOutline.path, sx: { color: ICON_COLOR } },\n    data: { $id: null, componentId: SCOPE_ID, pluginId: BUNDLE_ID, props: {} },\n  },\n]\n\nexport const functionInputPresets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(INPUT_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Calculator Input',\n    pluginId: BUNDLE_ID,\n    description: 'Asks one parameter of the Calculator it sits in',\n    category: Aglyn.ComponentCategory.INPUT,\n    icon: { path: mdiFormTextbox.path, sx: { color: ICON_COLOR } },\n    data: { $id: null, componentId: INPUT_ID, pluginId: BUNDLE_ID, props: { control: 'auto' } },\n  },\n]\n\nexport const functionOutputPresets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(OUTPUT_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Calculator Result',\n    pluginId: BUNDLE_ID,\n    description: 'Shows one value from the Calculator it sits in',\n    category: Aglyn.ComponentCategory.INPUT,\n    icon: { path: mdiFunctionVariant.path, sx: { color: ICON_COLOR } },\n    data: { $id: null, componentId: OUTPUT_ID, pluginId: BUNDLE_ID, props: {} },\n  },\n]\n\nexport const functionShowPresets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(SHOW_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Show When',\n    pluginId: BUNDLE_ID,\n    description: 'Appears only while a Calculator value is true',\n    category: Aglyn.ComponentCategory.INPUT,\n    icon: { path: mdiEyeOutline.path, sx: { color: ICON_COLOR } },\n    data: { $id: null, componentId: SHOW_ID, pluginId: BUNDLE_ID, props: {} },\n  },\n]\n\nexport { FunctionInput, FunctionOutput, FunctionShow }\nexport default FunctionScope\n"],"names":["Aglyn","mdiCalculatorVariantOutline","mdiEyeOutline","mdiFormTextbox","mdiFunctionVariant","Box","createContext","forwardRef","Fragment","useCallback","useContext","useMemo","useState","BUNDLE_ID","generatePresetId","FUNCTION_CONTROL_KINDS","FunctionParameterControl","displayFunctionValue","initialFunctionArguments","isFunctionValueTruthy","SCOPE_ID","INPUT_ID","OUTPUT_ID","SHOW_ID","FunctionScopeContext","FunctionScope","props","ref","functionName","_functionName","children","definition","globals","rest","args","setArgs","setArgument","name","value","previous","run","evaluateHostFunction","Provider","displayName","FunctionInput","scope","parameter","control","label","hideLabel","choices","suppressNavigation","ScreenLinkContext","String","trim","declared","parameters","find","candidate","ownChoices","parseFunctionParameterOptions","options","length","inert","type","required","Boolean","onChange","next","disabled","width","OUTPUT_ELEMENTS","renderFunctionEmphasis","text","parts","split","map","part","index","strong","FunctionOutput","placeholder","announce","element","key","ok","tag","includes","component","FunctionShow","when","invert","decided","truthy","ICON_COLOR","CONTROL_LABELS","auto","number","select","chips","switch","schema","$id","pluginId","description","category","ComponentCategory","INPUT","icon","path","sx","color","attributes","FieldComponentType","TEXT_FIELD","functionInputSchema","flags","selfClosing","FEATURE_FLAG","ENABLED","SELECT","kind","SWITCH","functionOutputSchema","functionShowSchema","presets","NodeType","PRESET","data","componentId","functionInputPresets","functionOutputPresets","functionShowPresets"],"mappings":"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"}

package/src/lib/components/function-widget.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @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 * as Aglyn from '@aglyn/aglyn';
+export declare const ID: Aglyn.ComponentId;
+export interface FunctionWidgetProps {
+    /** Name of the host function to run (Functions card on the dashboard). */
+    functionName?: string;
+    title?: string;
+    buttonLabel?: string;
+    resultLabel?: string;
+    /**
+     * Several named results instead of one (AGL-3202): one per line, as
+     * `name | Label`, where the name is a parameter or variable of the
+     * function. Empty shows the return value alone, as it always has.
+     */
+    outputs?: string;
+    /** Recompute as the visitor types; no button (AGL-3202). */
+    autoRun?: boolean;
+    /**
+     * Injected at tenant compose time (attachFunctionDefinitions) — never
+     * authored directly. Editor canvas renders without it (inert preview).
+     */
+    definition?: Aglyn.HostFunction;
+    /**
+     * The site variables this function reads, by name (AGL-3202). Injected
+     * beside `definition`, and only the ones its expressions name.
+     */
+    globals?: Record<string, number | string | boolean>;
+}
+/** One row of the `outputs` attribute. */
+export interface FunctionWidgetOutput {
+    name: string;
+    label: string;
+}
+/**
+ * `name | Label` per line. A line with no bar labels the row with the name,
+ * and a name may appear once: the second copy of a row is a typo, not a
+ * second result.
+ */
+export declare function parseFunctionWidgetOutputs(text: string | undefined): FunctionWidgetOutput[];
+/**
+ * Interactive function widget (Component Builder wiring, AGL-93): renders
+ * an input per function parameter and runs the host function client-side
+ * through the shared safe evaluator — a no-code calculator/logic block
+ * (quote estimators, eligibility checks, counters). The definition is
+ * injected server-side at compose; in the besigner the widget shows a
+ * static preview.
+ *
+ * WHAT A REAL CALCULATOR NEEDED (AGL-3202). The first one built on this
+ * compared five platforms, and the widget could ask for nothing but free
+ * text, labeled with the parameter's identifier, and could answer with
+ * nothing but one line. So a parameter now renders as what it IS — a number
+ * box, a yes/no switch, a choice list — under the label its author wrote;
+ * `outputs` lists several named results; and `autoRun` recomputes as the
+ * visitor types. All three are opt-in: a widget that sets none of them
+ * renders and behaves exactly as it did.
+ */
+declare const FunctionWidget: import("react").ForwardRefExoticComponent<FunctionWidgetProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const schema: Aglyn.ComponentSchema<FunctionWidgetProps>;
+export declare const presets: Aglyn.PresetSchema[];
+export default FunctionWidget;