@aglyn/plugins-crm 1.0.0-beta.221 → 1.0.0-beta.223

package/src/lib/components/picklist-select.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/crm/src/lib/components/picklist-select.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'use client'\n\nimport {\n  type CrmPicklist,\n  type CrmPicklistId,\n  crmPicklistDefinition,\n  crmPicklistOptions,\n  groupPicklistOptions,\n  type PicklistOption,\n} from '@aglyn/aglyn'\nimport { ListItemText, ListSubheader, MenuItem, TextField } from '@mui/material'\nimport { type ReactNode, useMemo } from 'react'\n\nexport interface CrmPicklistSelectProps {\n  /** Which of the CRM's standard picklists the field is. */\n  picklistId: CrmPicklistId\n  picklist: CrmPicklist\n  /** The label the record holds, or `''` for none. */\n  value: string\n  onChange: (label: string) => void\n  /**\n   * What the record held when the form opened. Kept in the menu while the\n   * list no longer offers it — deactivated, or written before the list\n   * held it — so the select shows what is stored until somebody changes it.\n   */\n  stored?: string\n  disabled?: boolean\n  helperText?: string\n  error?: boolean\n  /** The field's label, when a record names it otherwise than the list does. */\n  label?: string\n}\n\n/** How a kept value that the list does not offer reads in the menu and the field. */\nfunction optionText(option: PicklistOption): string {\n  if (option.inactive) return `${option.label} (inactive)`\n  if (option.unlisted) return `${option.label} (not in the list)`\n  return option.label\n}\n\n/**\n * A standard picklist's select (AGL-3298, AGL-3510): the org's active\n * values in the order the Fields page keeps them, a \"None\" to clear, and\n * the record's own value when the list would not otherwise show it —\n * marked, and selectable only as what it already is. A definition with\n * groups lists its values under a heading per group, in the definition's\n * order, with ungrouped values last.\n *\n * MUI's select `TextField`, the control every CRM form in this plugin uses\n * for a fixed choice, so it sizes, labels and disables like its neighbors.\n */\nexport function CrmPicklistSelect(props: CrmPicklistSelectProps) {\n  const { picklistId, picklist, value, onChange, stored, disabled, helperText, error, label } = props\n  const definition = crmPicklistDefinition(picklistId)\n  const options = useMemo(\n    () => crmPicklistOptions(picklist, stored || value),\n    [picklist, stored, value],\n  )\n  const selected = options.find((option) => option.label === value)\n\n  const item = (option: PicklistOption) => (\n    <MenuItem\n      key={option.label}\n      value={option.label}\n      // A kept value is shown so the record reads true, not offered as a\n      // choice for a record that does not hold it already.\n      disabled={(option.inactive || option.unlisted) && option.label !== (stored || value)}\n    >\n      <ListItemText\n        primary={optionText(option)}\n        slotProps={\n          option.inactive || option.unlisted ? { primary: { color: 'text.secondary' } } : undefined\n        }\n      />\n    </MenuItem>\n  )\n  // The menu's children flat — a Select reads its options from its direct\n  // children, so the headings sit between them rather than around them.\n  const groups = definition?.groups ?? []\n  const items: ReactNode[] = groups.length\n    ? groupPicklistOptions(options, groups).flatMap((section) => [\n        <ListSubheader key={`group:${section.group?.id ?? ''}`}>\n          {section.group?.label ?? 'No group'}\n        </ListSubheader>,\n        ...section.options.map(item),\n      ])\n    : options.map(item)\n\n  return (\n    <TextField\n      select\n      size=\"small\"\n      label={label ?? definition?.label ?? 'Value'}\n      value={selected ? value : ''}\n      onChange={(event) => onChange(String(event.target.value))}\n      disabled={disabled}\n      helperText={helperText}\n      error={error}\n      fullWidth\n      slotProps={{\n        select: {\n          displayEmpty: true,\n          renderValue: (current) => {\n            const option = options.find((entry) => entry.label === current)\n            return option ? optionText(option) : 'None'\n          },\n        },\n        inputLabel: { shrink: true },\n      }}\n    >\n      <MenuItem value=\"\">\n        <ListItemText primary=\"None\" slotProps={{ primary: { color: 'text.secondary' } }} />\n      </MenuItem>\n      {items}\n    </TextField>\n  )\n}\nCrmPicklistSelect.displayName = 'CrmPicklistSelect'\n\nexport default CrmPicklistSelect\n"],"names":["crmPicklistDefinition","crmPicklistOptions","groupPicklistOptions","ListItemText","ListSubheader","MenuItem","TextField","useMemo","optionText","option","inactive","label","unlisted","CrmPicklistSelect","props","picklistId","picklist","value","onChange","stored","disabled","helperText","error","definition","options","selected","find","item","primary","slotProps","color","undefined","groups","items","length","flatMap","section","group","id","map","select","size","event","String","target","fullWidth","displayEmpty","renderValue","current","entry","inputLabel","shrink","displayName"],"mappings":"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"}

package/src/lib/components/picklist-values-card.d.ts

@@ -0,0 +1,34 @@
+import { type CrmPicklistId } from '@aglyn/aglyn';
+export interface PicklistValuesCardProps {
+    /** Which of the CRM's standard picklists this card manages. */
+    picklistId: CrmPicklistId;
+    /** The mounted site, or `null` at the organization level. */
+    hostId: string | null;
+    /** The org whose list this is; `null` while it settles. */
+    orgId: string | null;
+    /** The site a newly written list records as its definer — the Fields page's own. */
+    createHostId: string | null;
+}
+/**
+ * ONE STANDARD PICKLIST'S VALUES (AGL-3298, AGL-3510) — Salesforce's
+ * picklist value set for a standard field, managed on the Fields tab of the
+ * object the field belongs to.
+ *
+ * Standard values are marked, and cannot be deleted — every org has them —
+ * but rename, reorder, regroup, deactivate and default are theirs as much
+ * as an added value's. Every move that touches only the LIST — add,
+ * reorder by drag or arrows, sort A–Z, activate, deactivate, group,
+ * default — is one client write of the whole document, guarded against a
+ * cached read like every seeded save on the Fields page. The two that
+ * change RECORDS — rename, and delete with a replacement — go to
+ * `crm/picklist-values`, which rewrites the list and every record the
+ * definition's targets name together; see that route.
+ *
+ * An org that has never edited the list reads the standard values, and the
+ * first move here writes them down as the org's own.
+ */
+export declare function PicklistValuesCard(props: PicklistValuesCardProps): import("react").JSX.Element;
+export declare namespace PicklistValuesCard {
+    var displayName: string;
+}
+export default PicklistValuesCard;

package/src/lib/components/{lead-source-values-card.js → picklist-values-card.js}

@@ -16,7 +16,7 @@
  */ 'use client';
 import { _ as _extends } from "@swc/helpers/_/_extends";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { CRM_COLLECTIONS, CRM_LEAD_SOURCE_PICKLIST, CRM_LEAD_TEXT_MAX, crmPicklistActiveValues, newResourceScopeFields, ORG_SCOPE_TOKEN } from "@aglyn/aglyn";
+import { CRM_COLLECTIONS, CRM_LEAD_TEXT_MAX, isStandardPicklistValueId, newResourceScopeFields, ORG_SCOPE_TOKEN } from "@aglyn/aglyn";
 import { mdiArrowDown, mdiArrowUp, mdiDeleteOutline, mdiDragVertical, mdiEyeOffOutline, mdiEyeOutline, mdiPencilOutline, mdiStarOutline } from "@aglyn/shared-data-mdi";
 import { MdiIcon, SrOnly } from "@aglyn/shared-ui-jsx";
 import RowActionsMenu from "@aglyn/shared-ui-jsx/components/row-actions-menu.component";
@@ -27,44 +27,92 @@ import { useFirestore, useUser, writeGuardedBySeed } from "@aglyn/tenant-feature
 import { Button, Chip, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, IconButton, MenuItem, Stack, TableBody, TableCell, TableHead, TableRow, TextField, Typography } from "@mui/material";
 import { doc, serverTimestamp, setDoc } from "firebase/firestore";
 import { useCallback, useState } from "react";
-import { useLeadSourcePicklist } from "../hooks/use-lead-source-picklist.js";
-import { addPicklistValue, crmLeadSourceValuesRouteUrl, movePicklistValue, setPicklistDefault, setPicklistValueActive, sortPicklistValues } from "../model/lead-source-values.js";
+import { useCrmPicklist } from "../hooks/use-crm-picklist.js";
+import { addPicklistValue, crmPicklistValuesRouteUrl, movePicklistValue, picklistAddableMeanings, picklistMeaningLabel, picklistReplacements, setPicklistDefault, setPicklistValueActive, setPicklistValueGroup, sortPicklistValues } from "../model/picklist-values.js";
 import { crmTaskCallScope } from "../model/task-routes.js";
+/** Each object's noun, singular and plural, for the card's sentences. */ const OBJECT_NOUNS = {
+    contact: [
+        'contact',
+        'contacts'
+    ],
+    company: [
+        'company',
+        'companies'
+    ],
+    deal: [
+        'deal',
+        'deals'
+    ],
+    lead: [
+        'lead',
+        'leads'
+    ],
+    task: [
+        'task',
+        'tasks'
+    ]
+};
+/** "a", "a and b", "a, b and c". */ function sentenceList(words) {
+    var _words_;
+    return words.length < 2 ? (_words_ = words[0]) != null ? _words_ : '' : `${words.slice(0, -1).join(', ')} and ${words[words.length - 1]}`;
+}
+/** The objects whose records hold the field's label, in the definition's order. */ function targetObjects(definition) {
+    return [
+        ...new Set(definition.targets.map((target)=>target.object))
+    ];
+}
 /**
- * THE LEAD SOURCE VALUES (AGL-3298) — Salesforce's Lead Source picklist,
- * managed where the org's lead fields are.
+ * ONE STANDARD PICKLIST'S VALUES (AGL-3298, AGL-3510) — Salesforce's
+ * picklist value set for a standard field, managed on the Fields tab of the
+ * object the field belongs to.
  *
- * Every move that touches only the LIST — add, reorder by drag or arrows,
- * sort A–Z, activate, deactivate, default — is one client write of the
- * whole document, guarded against a cached read like every seeded save on
- * the Fields page. The two that change RECORDS — rename, and delete with a
- * replacement — go to `crm/lead-source-values`, which rewrites the list and
- * every lead and contact holding the old label together; see that route.
+ * Standard values are marked, and cannot be deleted — every org has them —
+ * but rename, reorder, regroup, deactivate and default are theirs as much
+ * as an added value's. Every move that touches only the LIST — add,
+ * reorder by drag or arrows, sort A–Z, activate, deactivate, group,
+ * default — is one client write of the whole document, guarded against a
+ * cached read like every seeded save on the Fields page. The two that
+ * change RECORDS — rename, and delete with a replacement — go to
+ * `crm/picklist-values`, which rewrites the list and every record the
+ * definition's targets name together; see that route.
  *
- * An org that has never edited its list reads the starter set, and the
- * first move here writes it down as the org's own.
- */ export function LeadSourceValuesCard(props) {
-    var _ref;
-    const { hostId, orgId, createHostId } = props;
+ * An org that has never edited the list reads the standard values, and the
+ * first move here writes them down as the org's own.
+ */ export function PicklistValuesCard(props) {
+    var _definition_groups, _definition_meanings, _ref;
+    const { picklistId, hostId, orgId, createHostId } = props;
     const firestore = useFirestore();
     const { data: user } = useUser();
     const { enqueueSnackbar } = useSnackbar();
-    const { picklist, stored, ready, fromCache } = useLeadSourcePicklist(orgId);
+    const { definition, picklist, stored, ready, fromCache } = useCrmPicklist(picklistId, orgId);
     const [busy, setBusy] = useState(false);
     const [nameDialog, setNameDialog] = useState(null);
     const [draftName, setDraftName] = useState('');
+    const [draftGroup, setDraftGroup] = useState('');
+    const [draftMeaning, setDraftMeaning] = useState('');
     const [nameError, setNameError] = useState('');
     const [deleting, setDeleting] = useState(null);
     const [replaceWith, setReplaceWith] = useState('');
     const [dragFrom, setDragFrom] = useState(null);
+    const groups = (_definition_groups = definition.groups) != null ? _definition_groups : [];
+    const meanings = (_definition_meanings = definition.meanings) != null ? _definition_meanings : [];
+    // An added value may not take a meaning only the platform sets (AGL-3512).
+    const addableMeanings = picklistAddableMeanings(definition);
+    const [noun, nouns] = OBJECT_NOUNS[definition.object];
+    const holders = targetObjects(definition).map((object)=>OBJECT_NOUNS[object]);
+    // A list of suggestions only — a task's subjects (AGL-3517) — that no record holds.
+    const suggestions = holders.length === 0;
+    const field = definition.label.toLowerCase();
+    const failed = `The ${definition.plural} could not be saved.`;
+    const isStandard = (value)=>isStandardPicklistValueId(definition, value.id);
     /** Write the whole list — the list-only moves above. */ const save = useCallback(async (next, done)=>{
         if (!orgId || busy) return;
         setBusy(true);
         try {
             const verdict = await writeGuardedBySeed({
-                subject: 'lead source list',
+                subject: `${field} list`,
                 fromCache
-            }, ()=>setDoc(doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.picklists, CRM_LEAD_SOURCE_PICKLIST), _extends({
+            }, ()=>setDoc(doc(firestore, 'orgs', orgId, CRM_COLLECTIONS.picklists, picklistId), _extends({
                     values: next.values,
                     defaultValueId: next.defaultValueId,
                     updatedAt: serverTimestamp()
@@ -89,7 +137,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
             });
         } catch (error) {
             console.error(error);
-            enqueueSnackbar('The lead sources could not be saved.', {
+            enqueueSnackbar(failed, {
                 variant: 'error',
                 allowDuplicate: true
             });
@@ -99,27 +147,32 @@ import { crmTaskCallScope } from "../model/task-routes.js";
     }, [
         orgId,
         busy,
+        field,
         fromCache,
         firestore,
+        picklistId,
         stored,
         createHostId,
-        enqueueSnackbar
+        enqueueSnackbar,
+        failed
     ]);
     /** A rename or a delete — the moves that change records too. */ const post = useCallback(async (request)=>{
         const scope = crmTaskCallScope(hostId, orgId);
         if (!scope || busy) return null;
         setBusy(true);
         try {
-            const response = await authorizedFetch(user, crmLeadSourceValuesRouteUrl(), {
+            const response = await authorizedFetch(user, crmPicklistValuesRouteUrl(), {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json'
                 },
-                body: JSON.stringify(_extends({}, request, scope))
+                body: JSON.stringify(_extends({}, request, {
+                    picklistId
+                }, scope))
             });
             const payload = await response.json().catch(()=>({}));
             if (!response.ok) {
-                enqueueSnackbar(payload.error || 'The lead sources could not be saved.', {
+                enqueueSnackbar(payload.error || failed, {
                     variant: 'warning',
                     persist: false
                 });
@@ -128,7 +181,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
             return payload;
         } catch (error) {
             console.error(error);
-            enqueueSnackbar('The lead sources could not be saved.', {
+            enqueueSnackbar(failed, {
                 variant: 'error',
                 allowDuplicate: true
             });
@@ -141,14 +194,27 @@ import { crmTaskCallScope } from "../model/task-routes.js";
         orgId,
         busy,
         user,
-        enqueueSnackbar
+        picklistId,
+        enqueueSnackbar,
+        failed
     ]);
-    const moved = (result)=>{
-        const records = result.leads + result.contacts;
-        return records ? ` — ${result.leads.toLocaleString()} lead${result.leads === 1 ? '' : 's'} and ` + `${result.contacts.toLocaleString()} contact${result.contacts === 1 ? '' : 's'} updated` : '';
+    /** " — 2 leads and 1 contact updated", or nothing when no record held the value. */ const moved = (result)=>{
+        const counts = targetObjects(definition).map((object)=>{
+            var _ref;
+            var _result_updated;
+            const count = (_ref = (_result_updated = result.updated) == null ? void 0 : _result_updated[object]) != null ? _ref : 0;
+            const [one, many] = OBJECT_NOUNS[object];
+            return {
+                count,
+                text: `${count.toLocaleString()} ${count === 1 ? one : many}`
+            };
+        });
+        return counts.some((entry)=>entry.count) ? ` — ${sentenceList(counts.map((entry)=>entry.text))} updated` : '';
     };
     const openAdd = ()=>{
         setDraftName('');
+        setDraftGroup('');
+        setDraftMeaning('');
         setNameError('');
         setNameDialog({
             mode: 'add'
@@ -165,7 +231,10 @@ import { crmTaskCallScope } from "../model/task-routes.js";
     const submitName = async ()=>{
         if (!nameDialog) return;
         if (nameDialog.mode === 'add') {
-            const move = addPicklistValue(picklist, draftName);
+            const move = addPicklistValue(definition, picklist, draftName, {
+                group: draftGroup || null,
+                meaning: draftMeaning || null
+            });
             if (move.ok === false) return void setNameError(move.error);
             setNameDialog(null);
             await save(move.picklist, `“${draftName.trim()}” added`);
@@ -204,7 +273,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
     const move = (from, to)=>void save(movePicklistValue(picklist, from, to), 'Order saved');
     const rowActions = (value)=>{
         const isDefault = picklist.defaultValueId === value.id;
-        return [
+        const items = [
             {
                 key: 'rename',
                 label: 'Rename',
@@ -224,7 +293,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                 }),
                 disabled: busy || !isDefault && !value.active,
                 disabledReason: !value.active ? 'An inactive value cannot be the default' : undefined,
-                onClick: ()=>void save(setPicklistDefault(picklist, isDefault ? null : value.id), isDefault ? 'Default cleared' : `New leads start as “${value.label}”`)
+                onClick: ()=>void save(setPicklistDefault(picklist, isDefault ? null : value.id), isDefault ? 'Default cleared' : `New ${nouns} start as “${value.label}”`)
             },
             {
                 key: 'active',
@@ -235,8 +304,11 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                 }),
                 disabled: busy,
                 onClick: ()=>void save(setPicklistValueActive(picklist, value.id, !value.active), value.active ? `“${value.label}” deactivated` : `“${value.label}” activated`)
-            },
-            {
+            }
+        ];
+        // A standard value is every organization's: it is deactivated, never deleted.
+        if (!isStandard(value)) {
+            items.push({
                 key: 'delete',
                 label: 'Delete…',
                 icon: /*#__PURE__*/ _jsx(MdiIcon, {
@@ -246,10 +318,13 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                 destructive: true,
                 disabled: busy,
                 onClick: ()=>openDelete(value)
-            }
-        ];
+            });
+        }
+        return items;
     };
-    const replacements = crmPicklistActiveValues(picklist).filter((value)=>value.id !== (deleting == null ? void 0 : deleting.id));
+    const replacements = deleting ? picklistReplacements(definition, picklist, deleting.id) : [];
+    const columns = 4 + (groups.length ? 1 : 0) + (meanings.length ? 1 : 0);
+    const heldBy = sentenceList(holders.map(([, many])=>many)).replace(/^./, (letter)=>letter.toUpperCase());
     return /*#__PURE__*/ _jsxs(Stack, {
         spacing: 1.5,
         children: [
@@ -271,12 +346,12 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                         children: [
                             /*#__PURE__*/ _jsx(Typography, {
                                 variant: "subtitle1",
-                                children: 'Lead source values'
+                                children: `${definition.label} values`
                             }),
                             /*#__PURE__*/ _jsx(Typography, {
                                 variant: "body2",
                                 color: "text.secondary",
-                                children: 'The choices in every lead’s Lead source select, in this order. ' + 'An import or an API write naming anything else is refused. ' + 'A deactivated value stays on the records that hold it.'
+                                children: (suggestions ? `The suggestions every ${noun}’s ${definition.label} offers, in this order. ` + 'Any text may still be typed, and renaming or deleting a suggestion ' + `changes no ${noun}. ` : `The choices in every ${noun}’s ${definition.label} select, in this order. ` + (definition.restricted ? 'An import or an API write naming anything else is refused. ' : '') + 'A deactivated value stays on the records that hold it. ') + 'Standard values come with every organization and cannot be deleted; ' + 'add your own beside them.'
                             })
                         ]
                     }),
@@ -306,7 +381,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
             }),
             !ready ? null : /*#__PURE__*/ _jsxs(ScrollTable, {
                 size: "small",
-                "aria-label": "Lead source values",
+                "aria-label": `${definition.label} values`,
                 children: [
                     /*#__PURE__*/ _jsx(TableHead, {
                         children: /*#__PURE__*/ _jsxs(TableRow, {
@@ -320,6 +395,12 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                                 /*#__PURE__*/ _jsx(TableCell, {
                                     children: 'Value'
                                 }),
+                                groups.length ? /*#__PURE__*/ _jsx(TableCell, {
+                                    children: 'Group'
+                                }) : null,
+                                meanings.length ? /*#__PURE__*/ _jsx(TableCell, {
+                                    children: 'Means'
+                                }) : null,
                                 /*#__PURE__*/ _jsx(TableCell, {
                                     children: 'Status'
                                 }),
@@ -333,15 +414,17 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                         children: [
                             picklist.values.length === 0 ? /*#__PURE__*/ _jsx(TableRow, {
                                 children: /*#__PURE__*/ _jsx(TableCell, {
-                                    colSpan: 4,
+                                    colSpan: columns,
                                     children: /*#__PURE__*/ _jsx(Typography, {
                                         variant: "body2",
                                         color: "text.secondary",
-                                        children: 'No values yet. Add one, and every lead can be given it.'
+                                        children: `No values yet. Add one, and every ${noun} can be given it.`
                                     })
                                 })
                             }) : null,
-                            picklist.values.map((value, index)=>/*#__PURE__*/ _jsxs(TableRow, {
+                            picklist.values.map((value, index)=>{
+                                var _value_group;
+                                return /*#__PURE__*/ _jsxs(TableRow, {
                                     hover: true,
                                     // Native drag and drop for a pointer; the arrows beside the
                                     // handle are the same move for a keyboard or a touch screen.
@@ -415,12 +498,70 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                                                 ]
                                             })
                                         }),
+                                        /*#__PURE__*/ _jsx(TableCell, {
+                                            children: /*#__PURE__*/ _jsxs(Stack, {
+                                                direction: "row",
+                                                spacing: 1,
+                                                sx: {
+                                                    alignItems: 'center'
+                                                },
+                                                children: [
+                                                    /*#__PURE__*/ _jsx(Typography, {
+                                                        variant: "body2",
+                                                        children: value.label
+                                                    }),
+                                                    isStandard(value) ? /*#__PURE__*/ _jsx(Chip, {
+                                                        size: "small",
+                                                        variant: "outlined",
+                                                        label: "Standard"
+                                                    }) : null
+                                                ]
+                                            })
+                                        }),
+                                        groups.length ? /*#__PURE__*/ _jsx(TableCell, {
+                                            sx: {
+                                                minWidth: 150
+                                            },
+                                            children: /*#__PURE__*/ _jsxs(TextField, {
+                                                select: true,
+                                                size: "small",
+                                                variant: "standard",
+                                                value: (_value_group = value.group) != null ? _value_group : '',
+                                                disabled: busy || !orgId,
+                                                onChange: (event)=>{
+                                                    var _groups_find;
+                                                    const group = String(event.target.value) || null;
+                                                    const name = (_groups_find = groups.find((entry)=>entry.id === group)) == null ? void 0 : _groups_find.label;
+                                                    void save(setPicklistValueGroup(definition, picklist, value.id, group), name ? `“${value.label}” is ${name}` : `“${value.label}” has no group`);
+                                                },
+                                                fullWidth: true,
+                                                slotProps: {
+                                                    select: {
+                                                        displayEmpty: true,
+                                                        'aria-label': `Group of ${value.label}`
+                                                    }
+                                                },
+                                                children: [
+                                                    /*#__PURE__*/ _jsx(MenuItem, {
+                                                        value: "",
+                                                        children: 'None'
+                                                    }),
+                                                    groups.map((group)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                                            value: group.id,
+                                                            children: group.label
+                                                        }, group.id))
+                                                ]
+                                            })
+                                        }) : null,
+                                        meanings.length ? // What the value means to the CRM: fixed for a standard value, and
+                                        // chosen when an added one is made.
                                         /*#__PURE__*/ _jsx(TableCell, {
                                             children: /*#__PURE__*/ _jsx(Typography, {
                                                 variant: "body2",
-                                                children: value.label
+                                                color: value.meaning ? 'text.primary' : 'text.secondary',
+                                                children: value.meaning ? picklistMeaningLabel(definition, value.meaning) : '—'
                                             })
-                                        }),
+                                        }) : null,
                                         /*#__PURE__*/ _jsx(TableCell, {
                                             children: /*#__PURE__*/ _jsxs(Stack, {
                                                 direction: "row",
@@ -461,7 +602,8 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                                             })
                                         })
                                     ]
-                                }, value.id))
+                                }, value.id);
+                            })
                         ]
                     })
                 ]
@@ -469,7 +611,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
             ready && !stored ? /*#__PURE__*/ _jsx(Typography, {
                 variant: "caption",
                 color: "text.secondary",
-                children: 'This is the starter list. Your first change here makes it your organization’s own.'
+                children: 'These are the standard values. Your first change here makes the list your ' + 'organization’s own.'
             }) : null,
             /*#__PURE__*/ _jsxs(Dialog, {
                 open: nameDialog !== null,
@@ -478,7 +620,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                 maxWidth: "xs",
                 children: [
                     /*#__PURE__*/ _jsx(DialogTitle, {
-                        children: (nameDialog == null ? void 0 : nameDialog.mode) === 'rename' ? `Rename “${nameDialog.value.label}”` : 'Add a lead source'
+                        children: (nameDialog == null ? void 0 : nameDialog.mode) === 'rename' ? `Rename “${nameDialog.value.label}”` : `Add a ${field}`
                     }),
                     /*#__PURE__*/ _jsx(DialogContent, {
                         children: /*#__PURE__*/ _jsxs(Stack, {
@@ -487,9 +629,9 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                                 pt: 1
                             },
                             children: [
-                                (nameDialog == null ? void 0 : nameDialog.mode) === 'rename' ? /*#__PURE__*/ _jsx(DialogContentText, {
+                                (nameDialog == null ? void 0 : nameDialog.mode) === 'rename' && !suggestions ? /*#__PURE__*/ _jsx(DialogContentText, {
                                     variant: "body2",
-                                    children: 'Every lead and contact holding this value is updated to the new name.'
+                                    children: `Every ${sentenceList(holders.map(([one])=>one))} holding this value ` + 'is updated to the new name.'
                                 }) : null,
                                 /*#__PURE__*/ _jsx(TextField, {
                                     size: "small",
@@ -511,7 +653,48 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                                     },
                                     autoFocus: true,
                                     fullWidth: true
-                                })
+                                }),
+                                (nameDialog == null ? void 0 : nameDialog.mode) === 'add' && groups.length ? /*#__PURE__*/ _jsxs(TextField, {
+                                    select: true,
+                                    size: "small",
+                                    label: "Group",
+                                    value: draftGroup,
+                                    onChange: (event)=>setDraftGroup(String(event.target.value)),
+                                    fullWidth: true,
+                                    slotProps: {
+                                        select: {
+                                            displayEmpty: true
+                                        },
+                                        inputLabel: {
+                                            shrink: true
+                                        }
+                                    },
+                                    children: [
+                                        /*#__PURE__*/ _jsx(MenuItem, {
+                                            value: "",
+                                            children: 'None'
+                                        }),
+                                        groups.map((group)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                                value: group.id,
+                                                children: group.label
+                                            }, group.id))
+                                    ]
+                                }) : null,
+                                (nameDialog == null ? void 0 : nameDialog.mode) === 'add' && meanings.length ? /*#__PURE__*/ _jsx(TextField, {
+                                    select: true,
+                                    size: "small",
+                                    label: "Means",
+                                    value: draftMeaning,
+                                    onChange: (event)=>{
+                                        setDraftMeaning(String(event.target.value));
+                                        setNameError('');
+                                    },
+                                    fullWidth: true,
+                                    children: addableMeanings.map((meaning)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                            value: meaning,
+                                            children: picklistMeaningLabel(definition, meaning)
+                                        }, meaning))
+                                }) : null
                             ]
                         })
                     }),
@@ -549,9 +732,9 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                             children: [
                                 /*#__PURE__*/ _jsx(DialogContentText, {
                                     variant: "body2",
-                                    children: 'The value leaves the list for good. Leads and contacts that hold it ' + 'are moved to the value you pick here, or cleared. To keep it on ' + 'those records instead, deactivate it.'
+                                    children: suggestions ? `The suggestion leaves the list for good. No ${noun} changes.` : `The value leaves the list for good. ${heldBy} that hold it ` + (meanings.length ? 'are moved to the value you pick here, which means the same. ' : 'are moved to the value you pick here, or cleared. ') + 'To keep it on those records instead, deactivate it.'
                                 }),
-                                /*#__PURE__*/ _jsxs(TextField, {
+                                suggestions ? null : /*#__PURE__*/ _jsxs(TextField, {
                                     select: true,
                                     size: "small",
                                     label: "Replace it on existing records with",
@@ -567,7 +750,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                                         }
                                     },
                                     children: [
-                                        /*#__PURE__*/ _jsx(MenuItem, {
+                                        meanings.length ? null : /*#__PURE__*/ _jsx(MenuItem, {
                                             value: "",
                                             children: 'None — clear it'
                                         }),
@@ -589,7 +772,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
                             /*#__PURE__*/ _jsx(Button, {
                                 variant: "contained",
                                 color: "error",
-                                disabled: busy,
+                                disabled: busy || meanings.length > 0 && !replaceWith,
                                 onClick: ()=>void submitDelete(),
                                 children: 'Delete value'
                             })
@@ -600,7 +783,7 @@ import { crmTaskCallScope } from "../model/task-routes.js";
         ]
     });
 }
-LeadSourceValuesCard.displayName = 'LeadSourceValuesCard';
-export default LeadSourceValuesCard;
+PicklistValuesCard.displayName = 'PicklistValuesCard';
+export default PicklistValuesCard;
 
-//# sourceMappingURL=lead-source-values-card.js.map
+//# sourceMappingURL=picklist-values-card.js.map