@aglyn/plugins-mui 1.0.0-beta.217 → 1.0.0-beta.219

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/function-controls.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 type * as Aglyn from '@aglyn/aglyn'\nimport Chip from '@mui/material/Chip'\nimport FormControlLabel from '@mui/material/FormControlLabel'\nimport Stack from '@mui/material/Stack'\nimport Switch from '@mui/material/Switch'\nimport TextField from '@mui/material/TextField'\nimport Typography from '@mui/material/Typography'\nimport { useId } from 'react'\n\n/**\n * How one function parameter is ASKED (AGL-3202), shared by the Function\n * Widget, which asks every parameter in a row, and the Function Input\n * element, which asks one wherever the author put it.\n */\n\n/** The control a parameter is drawn as. `auto` follows the parameter. */\nexport type FunctionControlKind =\n  | 'auto'\n  | 'number'\n  | 'text'\n  | 'select'\n  | 'chips'\n  | 'switch'\n\nexport const FUNCTION_CONTROL_KINDS: readonly FunctionControlKind[] = [\n  'auto',\n  'number',\n  'text',\n  'select',\n  'chips',\n  'switch',\n]\n\n/** What each input starts with: the parameter's own default, or nothing. */\nexport function initialFunctionArguments(\n  definition: Aglyn.HostFunction | undefined,\n): Record<string, string> {\n  const args: Record<string, string> = {}\n  for (const parameter of definition?.parameters ?? []) {\n    if (parameter.defaultValue != null && parameter.defaultValue !== '') {\n      args[parameter.name] = String(parameter.defaultValue)\n    } else if (parameter.options?.length) {\n      // A select always shows a choice, so the function has to receive the\n      // one on screen — not an empty string the visitor never saw.\n      args[parameter.name] = String(parameter.options[0].value)\n    }\n  }\n  return args\n}\n\n/** A result as a visitor reads it. */\nexport function displayFunctionValue(\n  value: number | string | boolean | undefined,\n): string {\n  if (typeof value === 'boolean') return value ? 'Yes' : 'No'\n  return value == null ? '' : String(value)\n}\n\n/**\n * Whether a result counts as \"yes\" for an element that shows or hides on it.\n * The strings a function is likely to have built — `'false'`, `'0'`, `'no'` —\n * read as no, because a text local is the only way a function can carry a\n * flag it computed from text.\n */\nexport function isFunctionValueTruthy(\n  value: number | string | boolean | undefined,\n): boolean {\n  if (typeof value === 'boolean') return value\n  if (typeof value === 'number') return value !== 0 && !Number.isNaN(value)\n  const text = String(value ?? '').trim().toLowerCase()\n  return text !== '' && text !== 'false' && text !== '0' && text !== 'no'\n}\n\n/** `control: auto` resolved against what the parameter is. */\nexport function resolveFunctionControl(\n  control: FunctionControlKind | undefined,\n  parameter: Pick<Aglyn.HostFunctionParameter, 'type' | 'options'> | undefined,\n  hasChoices: boolean,\n): Exclude<FunctionControlKind, 'auto'> {\n  if (control && control !== 'auto') return control\n  if (hasChoices || parameter?.options?.length) return 'select'\n  if (parameter?.type === 'boolean') return 'switch'\n  if (parameter?.type === 'number') return 'number'\n  return 'text'\n}\n\n/** Two values name the same choice: \"25\" and 25.0 are one quick pick. */\nfunction sameChoice(left: string, right: string): boolean {\n  if (left === right) return true\n  if (left.trim() === '' || right.trim() === '') return false\n  const a = Number(left)\n  const b = Number(right)\n  return Number.isFinite(a) && Number.isFinite(b) && a === b\n}\n\nexport interface FunctionParameterControlProps {\n  /** The parameter's identifier; the label when nothing better is given. */\n  name: string\n  type?: Aglyn.FunctionValueType\n  required?: boolean\n  control?: FunctionControlKind\n  label?: string\n  hideLabel?: boolean\n  /** The choices offered by a select or a row of chips. */\n  options?: Aglyn.HostFunctionParameterOption[]\n  value: string\n  onChange: (value: string) => void\n  /** The besigner draws the control so it can be designed around; it is inert. */\n  disabled?: boolean\n  width?: number | string\n}\n\n/**\n * One parameter, drawn as what it is.\n *\n * - **select** is NATIVE. A portal-mounted menu is one more thing a\n *   transformed or clipped ancestor can misplace, and on a phone the platform\n *   picker is the better control.\n * - **chips** are quick picks: buttons that SET the value, pressed when the\n *   value matches. They are how a number box gets \"10 · 25 · 50 · 100\"\n *   beside it — two controls on one parameter, which is why this takes a\n *   value and an onChange and holds no state of its own.\n */\nexport function FunctionParameterControl(props: FunctionParameterControlProps) {\n  const {\n    name,\n    type,\n    required,\n    control,\n    label,\n    hideLabel,\n    options = [],\n    value,\n    onChange,\n    disabled,\n    width,\n  } = props\n  const groupLabelId = useId()\n  const text = label?.trim() || name\n  const kind = resolveFunctionControl(control, { type, options }, options.length > 0)\n  if (kind === 'chips') {\n    return (\n      <Stack spacing={0.75} role=\"group\" aria-labelledby={groupLabelId}>\n        <Typography\n          id={groupLabelId}\n          variant=\"caption\"\n          color=\"text.secondary\"\n          sx={hideLabel ? visuallyHidden : { fontWeight: 500 }}\n        >\n          {text}\n        </Typography>\n        <Stack direction=\"row\" spacing={0.75} sx={{ flexWrap: 'wrap', rowGap: 0.75 }}>\n          {options.map((option) => {\n            const pressed = sameChoice(value, option.value)\n            return (\n              <Chip\n                key={option.value}\n                label={option.label?.trim() || option.value}\n                size=\"small\"\n                clickable={!disabled}\n                disabled={disabled}\n                color={pressed ? 'primary' : 'default'}\n                variant={pressed ? 'filled' : 'outlined'}\n                aria-pressed={pressed}\n                onClick={() => onChange(option.value)}\n              />\n            )\n          })}\n        </Stack>\n      </Stack>\n    )\n  }\n  if (kind === 'switch') {\n    return (\n      <FormControlLabel\n        label={text}\n        disabled={disabled}\n        control={\n          <Switch\n            checked={value === 'true'}\n            onChange={(event) => onChange(event.target.checked ? 'true' : 'false')}\n          />\n        }\n      />\n    )\n  }\n  if (kind === 'select') {\n    return (\n      <TextField\n        select\n        label={hideLabel ? undefined : text}\n        required={Boolean(required)}\n        value={value}\n        disabled={disabled}\n        onChange={(event) => onChange(event.target.value)}\n        size=\"small\"\n        slotProps={{\n          select: { native: true },\n          htmlInput: hideLabel ? { 'aria-label': text } : undefined,\n        }}\n        sx={{ minWidth: width ?? 200 }}\n      >\n        {options.map((option) => (\n          <option key={option.value} value={option.value}>\n            {option.label?.trim() || option.value}\n          </option>\n        ))}\n      </TextField>\n    )\n  }\n  return (\n    <TextField\n      label={hideLabel ? undefined : text}\n      required={Boolean(required)}\n      value={value}\n      disabled={disabled}\n      onChange={(event) => onChange(event.target.value)}\n      size=\"small\"\n      type={kind === 'number' ? 'number' : undefined}\n      slotProps={{\n        htmlInput: {\n          ...(kind === 'number' ? { inputMode: 'decimal' } : {}),\n          ...(hideLabel ? { 'aria-label': text } : {}),\n        },\n      }}\n      sx={{ width: width ?? (label ? 200 : 140) }}\n    />\n  )\n}\n\nconst visuallyHidden = {\n  border: 0,\n  clip: 'rect(0 0 0 0)',\n  height: '1px',\n  margin: '-1px',\n  overflow: 'hidden',\n  padding: 0,\n  position: 'absolute',\n  whiteSpace: 'nowrap',\n  width: '1px',\n} as const\n"],"names":["Chip","FormControlLabel","Stack","Switch","TextField","Typography","useId","FUNCTION_CONTROL_KINDS","initialFunctionArguments","definition","args","parameter","parameters","defaultValue","name","String","options","length","value","displayFunctionValue","isFunctionValueTruthy","Number","isNaN","text","trim","toLowerCase","resolveFunctionControl","control","hasChoices","type","sameChoice","left","right","a","b","isFinite","FunctionParameterControl","props","required","label","hideLabel","onChange","disabled","width","groupLabelId","kind","spacing","role","aria-labelledby","id","variant","color","sx","visuallyHidden","fontWeight","direction","flexWrap","rowGap","map","option","pressed","size","clickable","aria-pressed","onClick","checked","event","target","select","undefined","Boolean","slotProps","native","htmlInput","minWidth","inputMode","border","clip","height","margin","overflow","padding","position","whiteSpace"],"mappings":"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"}

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

@@ -1,110 +0,0 @@
-/**
- * @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 { type ReactNode } from 'react';
-import { type FunctionControlKind } from './function-controls';
-/**
- * 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.
- */
-export declare const SCOPE_ID: Aglyn.ComponentId;
-export declare const INPUT_ID: Aglyn.ComponentId;
-export declare const OUTPUT_ID: Aglyn.ComponentId;
-export declare const SHOW_ID: Aglyn.ComponentId;
-export interface FunctionScopeProps {
-    /** Name of the site function every element inside is bound to. */
-    functionName?: string;
-    children?: ReactNode;
-    /** Injected at compose (attachFunctionDefinitions); never authored. */
-    definition?: Aglyn.HostFunction;
-    /** The site variables the function names; injected beside `definition`. */
-    globals?: Record<string, number | string | boolean>;
-}
-declare const FunctionScope: import("react").ForwardRefExoticComponent<FunctionScopeProps & import("react").RefAttributes<HTMLDivElement>>;
-export interface FunctionInputProps {
-    /** The function parameter this control asks. */
-    parameter?: string;
-    control?: FunctionControlKind;
-    /** Overrides the parameter's own label. */
-    label?: string;
-    hideLabel?: boolean;
-    /**
-     * Overrides the parameter's own choices, as `value: Label, value: Label`.
-     * This is how quick picks are given: `10, 25, 50, 100` beside a number box.
-     */
-    choices?: string;
-}
-declare const FunctionInput: import("react").ForwardRefExoticComponent<FunctionInputProps & import("react").RefAttributes<HTMLDivElement>>;
-export interface FunctionOutputProps {
-    /** A parameter or variable of the function; empty is its return value. */
-    name?: string;
-    /** What the besigner shows in the result's place, e.g. `$625`. */
-    placeholder?: string;
-    /** Read a change aloud. One result per calculator, usually the sentence. */
-    announce?: boolean;
-    element?: '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 declare function renderFunctionEmphasis(text: string): ReactNode;
-declare const FunctionOutput: import("react").ForwardRefExoticComponent<FunctionOutputProps & import("react").RefAttributes<HTMLElement>>;
-export interface FunctionShowProps {
-    /** A parameter or variable of the function. */
-    when?: string;
-    /** Show while the value is NOT truthy instead. */
-    invert?: boolean;
-    children?: ReactNode;
-}
-declare const FunctionShow: import("react").ForwardRefExoticComponent<FunctionShowProps & import("react").RefAttributes<HTMLDivElement>>;
-export declare const schema: Aglyn.ComponentSchema<FunctionScopeProps>;
-export declare const functionInputSchema: Aglyn.ComponentSchema<FunctionInputProps>;
-export declare const functionOutputSchema: Aglyn.ComponentSchema<FunctionOutputProps>;
-export declare const functionShowSchema: Aglyn.ComponentSchema<FunctionShowProps>;
-export declare const presets: Aglyn.PresetSchema[];
-export declare const functionInputPresets: Aglyn.PresetSchema[];
-export declare const functionOutputPresets: Aglyn.PresetSchema[];
-export declare const functionShowPresets: Aglyn.PresetSchema[];
-export { FunctionInput, FunctionOutput, FunctionShow };
-export default FunctionScope;

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

@@ -1,478 +0,0 @@
-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