@qoretechnologies/reqraft 0.10.66-pr.145.gcb1e59d → 0.10.66

package/src/components/form/fields/allowed-values/AllowedValues.tsx

@@ -1,321 +0,0 @@
-// Ported verbatim from qorus-ide `src/components/AllowedValues/index.tsx`
-// (FIELD_STACK_REPORT batch). Markup, props and the debounced local-value
-// flow are preserved. Seams (IDE-only infrastructure, same classes as the
-// ExpressionBuilder port):
-// - `useSavedValues` — saved-values storage is the host's; a field that shows
-//   saved values reads them from `SavedValuesContext` (see `savedValues.ts`).
-// - `useSubscriptionEvents` (CONNECTION_DELETED pruning) — dropped.
-// - `ConnectionManagement` per-item actions — dropped (actions omitted).
-// - `Select` → reqraft `SelectFormField` (`items` instead of `defaultItems`,
-//   single-arg `onChange`; `type`/`closeCollectionOnUnMount` not forwarded).
-import { ReqoreCheckbox, ReqoreControlGroup } from '@qoretechnologies/reqore';
-import { IReqoreButtonProps } from '@qoretechnologies/reqore/dist/components/Button';
-import { IQorusAllowedValue, TQorusType } from '@qoretechnologies/ts-toolkit';
-import { size as count, isEqual } from 'lodash';
-import { memo, useMemo } from 'react';
-import {
-  getSelectItemShortDescription,
-  getSelectItemUnavailability,
-  UNAVAILABLE_ITEM_CLASS,
-} from '../select/SelectCollection';
-import { ISelectFormFieldItem, SelectFormField as Select } from '../select/Select';
-import { useAllowedValueAvailability } from '../../engine/OptionFieldMessages';
-import { ChoiceGroupHeading, useSelectedChoiceIntent } from '../ChoiceGroupHeading';
-import type { IReqraftAllowedValue } from '../Field';
-import { allowedValueOf } from '../../../../helpers/allowedValues';
-import { useSavedValueChoices } from './savedValues';
-
-export interface IFieldAllowedValuesProps extends Pick<
-  IReqoreButtonProps,
-  'size' | 'disabled' | 'readOnly'
-> {
-  items: IQorusAllowedValue[];
-  type: TQorusType;
-  value: unknown;
-  name?: string;
-  onChange: (name: string, value: unknown) => void;
-  allowCreation?: boolean;
-  showDescription?: boolean;
-  app?: string;
-  action?: string;
-  showSavedValues?: boolean;
-  forceDropdown?: boolean;
-  [key: string]: any;
-}
-
-const DISALLOW_COMPACT_AO_TYPES = ['connection'];
-
-/**
- * Whether a creatable field's value is carried by the chip picker rather than
- * by a raw editor with a suggestion list beside it.
- *
- * String-valued only, and only with something to suggest. Every other shape a
- * creatable field can declare either does not fit a one-line chip (a document
- * — `long-string`, `binary`, `data`; a hash; a list) or would come back out of
- * one as a string (a number, a date), and a field with nothing to offer is
- * better served by the editor it has always had. Those keep today's rendering:
- * the raw editor, with the saved-and-suggested picker under it.
- *
- * `select-string` counts, and leaving it out was the bug. A picker field
- * declares its storage type (`*string`) and its `ui_type` (`select-string`),
- * and by the time a schema reaches here the two have been flattened to one:
- * `type` arrives as `select-string`. So this returned false for every such
- * field and NEITHER renderer stood down — the picker drew the value, and the
- * saved-and-suggested list drew the same candidates again underneath it. A
- * test's Service and Method fields showed 183 and 7 items twice over, in two
- * controls that set one value. A select-string's value IS a string and fits the
- * chip, which is the only thing this predicate is really asking.
- *
- * Both the renderer of the picker (`FieldAllowedValues`) and the renderer of
- * the raw editor (`AutoFormField`, `FormField`) ask this, so that exactly one
- * of them draws the value.
- */
-export const rendersCreatableValueSelect = (
-  type?: string,
-  allowCreation?: boolean,
-  items?: unknown[]
-): boolean =>
-  !!allowCreation && (type === 'string' || type === 'select-string') && count(items) > 0;
-
-/**
- * Field types whose own editor draws their choices: an enum's radio group, and the
- * multi-select a list of choices is picked with. For these the single-choice picker
- * below is not the editor — drawn in its place, a field holding SEVERAL choices
- * (a key's permissions) could be given only one.
- */
-export const DRAWS_OWN_CHOICES_TYPES: readonly string[] = ['enum', 'select-array', 'multi-select'];
-
-export const FieldAllowedValuesCheckGroup = memo(
-  ({
-    items,
-    multiSelect,
-    onChange,
-    name,
-    value,
-    label,
-    ...rest
-  }: Partial<Omit<IFieldAllowedValuesProps, 'items'>> & {
-    multiSelect?: boolean;
-    items: ISelectFormFieldItem[];
-    /**
-     * The field's own name, used as the group's heading.
-     *
-     * A picker headed by what it IS beats one headed by a generic instruction:
-     * "Select one:" says nothing the shape of a radio group has not already
-     * said, and in a container that absorbs a sibling it forced the field's name
-     * to be printed a second time beside the group. Falls back to the
-     * instruction when a field declares no display name.
-     */
-    label?: string;
-  }) => {
-    const selectedChoiceIntent = useSelectedChoiceIntent();
-
-    return (
-      <ReqoreControlGroup vertical size={rest.size || 'small'} gapSize='tiny'>
-        <ChoiceGroupHeading>
-          {label ? `${label}:`
-          : multiSelect ? 'Select one or more:'
-          : 'Select one:'}
-        </ChoiceGroupHeading>
-        {items?.map((item) => {
-          const unavailable = getSelectItemUnavailability(item);
-
-          return (
-            <ReqoreCheckbox
-              margin='right'
-              key={item.value?.toString()}
-              label={item.display_name || JSON.stringify(item.value)}
-              tooltip={getSelectItemShortDescription(item)}
-              /* The reason is IN the row: a checkbox has no body to put it in,
-                 and a hover is the one affordance a touch screen and a keyboard
-                 never reach. */
-              description={unavailable?.content}
-              className={unavailable ? UNAVAILABLE_ITEM_CLASS : undefined}
-              /* `labelEffect`, not `effect`: a non-switch `ReqoreCheckbox`
-                 destructures `effect` out and never applies it, so the dimming
-                 this asked for never appeared. The NAME is also the right
-                 thing to dim — `description` above carries the reason, and a
-                 reason has to stay readable. */
-              labelEffect={unavailable ? { opacity: 0.55 } : undefined}
-              uncheckedIcon={unavailable ? 'LockLine' : undefined}
-              /* The FIELD's `disabled` still goes through reqore — a field nobody
-                 may edit has no explanation to protect. A refused VALUE never
-                 does: `DisabledElement` is `pointer-events: none` and would take
-                 its tooltip with it. */
-              disabled={rest.disabled}
-              /* `cursor: not-allowed` from reqore's own `ReadOnlyElement`,
-                 which keeps the pointer events the tooltip is read through.
-                 It does not withhold `onClick` — the handler below does. */
-              readOnly={rest.readOnly || !!unavailable}
-              intent={selectedChoiceIntent(item.value === value)}
-              // `isEqual`, and only once there is a value to match. The single
-              // -select branch compared JSON.stringify(value) with
-              // JSON.stringify(item.value), and JSON.stringify(undefined) is
-              // undefined — so an unset field whose items carry no resolved value
-              // compared undefined with undefined and reported EVERY option as
-              // checked, on a field that was simultaneously "This field is
-              // required". Nothing selected must read as nothing selected.
-              checked={
-                multiSelect
-                  ? Array.isArray(value) && value.some((v) => isEqual(v, item.value))
-                  : value !== undefined && value !== null && isEqual(value, item.value)
-              }
-              onClick={
-                unavailable ? undefined : (
-                  () => {
-                    if (multiSelect) {
-                      let newValue: unknown[] = Array.isArray(value) ? [...value] : [];
-
-                      if (newValue.some((v) => isEqual(v, item.value))) {
-                        newValue = newValue.filter((v) => !isEqual(v, item.value));
-                      } else {
-                        newValue.push(item.value);
-                      }
-
-                      onChange(name, newValue);
-                    } else {
-                      onChange(name, isEqual(value, item.value) ? undefined : item.value);
-                    }
-                  }
-                )
-              }
-            />
-          );
-        })}
-      </ReqoreControlGroup>
-    );
-  }
-);
-
-export const FieldAllowedValues = memo(
-  ({
-    items = [],
-    type,
-    onChange,
-    value,
-    allowCreation,
-    showSavedValues,
-    showDescription,
-    forceDropdown,
-    size,
-    disabled,
-    name,
-    readOnly,
-    label,
-  }: IFieldAllowedValuesProps) => {
-    /* Resolved against the form this field stands in — the value's own
-       `depends_on`, and a refusal the server had already decided. Both end up
-       as one state on the item: no click handler, and a reason to read. */
-    const availability = useAllowedValueAvailability(items as IReqraftAllowedValue[]);
-    const savedValues = useSavedValueChoices(type);
-    const offersSavedValues = !!showSavedValues && !readOnly && !disabled && count(savedValues) > 0;
-
-    const fullItems = useMemo(() => {
-      const result = [
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        ...items.map(({ metadata, value, ...rest }, index) => {
-          const resolved = availability[index];
-
-          return {
-            value: allowedValueOf({ value, name: rest.name }),
-            ...rest,
-            disabled: rest.disabled || resolved?.available === false,
-            unavailable:
-              resolved && !resolved.available ?
-                {
-                  title: resolved.title,
-                  content: resolved.reason as string,
-                  intent: resolved.intent,
-                }
-              : undefined,
-          };
-        }),
-      ] as ISelectFormFieldItem[];
-
-      if (offersSavedValues) {
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        result.push(...savedValues.map(({ valueType, ...saved }) => saved));
-      }
-
-      return result;
-    }, [JSON.stringify(items), availability, type, value, offersSavedValues, savedValues]);
-
-    const style = useMemo(() => ({ width: '100%' }), []);
-
-    if (
-      !count(fullItems) ||
-      DRAWS_OWN_CHOICES_TYPES.includes(type as string) ||
-      (!count(items) && !offersSavedValues)
-    ) {
-      return null;
-    }
-
-    // Creatable, and the value fits a chip: ONE control that both holds the
-    // value and offers the candidates, instead of a raw editor with a
-    // value-less suggestion picker beside it. The author sees what is set
-    // without having to read a path out of a text box.
-    if (rendersCreatableValueSelect(type, allowCreation, items)) {
-      return (
-        <Select
-          items={fullItems}
-          value={value}
-          onChange={(value) => onChange(name, value)}
-          canCreateItems
-          fluid
-          fixed={false}
-          showDescription={Boolean(showDescription || showDescription === undefined)}
-          style={style}
-          size={size}
-          disabled={disabled || readOnly}
-        />
-      );
-    }
-
-    // These are simple allowed values
-    if (count(items) && !allowCreation) {
-      if (count(fullItems) <= 3 && !DISALLOW_COMPACT_AO_TYPES.includes(type)) {
-        return (
-          <FieldAllowedValuesCheckGroup
-            items={fullItems}
-            onChange={onChange}
-            value={value}
-            name={name}
-            label={label}
-          />
-        );
-      }
-
-      return (
-        <Select
-          items={fullItems}
-          value={value}
-          onChange={(value) => onChange(name, value)}
-          fluid
-          fixed={false}
-          showDescription={Boolean(showDescription || showDescription === undefined)}
-          forceDropdown={forceDropdown}
-          style={style}
-          size={size}
-          disabled={disabled}
-        />
-      );
-    }
-
-    return (
-      <Select
-        items={fullItems}
-        onChange={(value) => onChange(name, value)}
-        fluid
-        fixed={false}
-        showDescription={false}
-        forceDropdown={forceDropdown}
-        style={style}
-        minimal
-        placeholder={'Saved & Suggested Values'}
-        size={size}
-        disabled={disabled}
-        icon='SaveFill'
-      />
-    );
-  }
-);

package/src/components/form/fields/allowed-values/savedValues.ts

@@ -1,64 +0,0 @@
-import { createContext, useContext, useMemo } from 'react';
-import { ISelectFormFieldItem } from '../select/Select';
-
-/**
- * SEAM (reqraft): values a person saved to reuse in other fields.
- *
- * Where they are kept is the host's business — the IDE stores them in the
- * user's settings — so this package draws them and asks the host to save one;
- * it never stores anything itself. Without a provider a form offers neither,
- * which is what it did before the seam existed (`showSavedValues` and
- * `allowSaving` were inert).
- */
-export interface ISavedValueChoice extends ISelectFormFieldItem {
-  /** The type of the saved value: a field offers only the values of its own type. */
-  valueType?: string;
-}
-
-export interface ISavedValues {
-  /** Every saved value, drawn as choices by a field that shows saved values. */
-  items: ISavedValueChoice[];
-  /** Saves a field's current value; the host asks what to call it. */
-  saveValue?: (field: { value: unknown; type?: string }) => void;
-  /** The label of the row-menu item that saves a value. */
-  saveLabel?: string;
-}
-
-export const SavedValuesContext = createContext<ISavedValues | undefined>(undefined);
-
-const NO_SAVED_VALUES: ISavedValueChoice[] = [];
-
-/**
- * The editors that all store text. A field's type names its EDITOR, so a rich-text
- * field reports `richtext` while the value saved from it, or from a plain string
- * field, is text all the same; matching the names exactly offered no saved text to
- * the rich-text fields most text is written in.
- */
-const TEXT_TYPES = new Set([
-  'string',
-  'richtext',
-  'long-string',
-  'email',
-  'uri',
-  'url',
-  'uuid',
-  'hostname',
-  'ipv4',
-  'ipv6',
-  'phone',
-]);
-
-const storedKind = (type?: string) => (type && TEXT_TYPES.has(type) ? 'string' : type);
-
-/** The saved values a field of `type` can choose from. */
-export const useSavedValueChoices = (type?: string): ISavedValueChoice[] => {
-  const items = useContext(SavedValuesContext)?.items;
-  return useMemo(
-    () =>
-      !items ? NO_SAVED_VALUES
-      : type ?
-        items.filter((item) => !item.valueType || storedKind(item.valueType) === storedKind(type))
-      : items,
-    [items, type]
-  );
-};

package/src/components/form/fields/array/ArrayAuto.tsx

@@ -1,237 +0,0 @@
-// Ported verbatim from qorus-ide `src/components/Field/arrayAuto.tsx`
-// (FIELD_STACK_REPORT batch) — the panel-per-item list editor the IDE's auto
-// field renders for typed lists (each item is a full
-// `TemplateField component={auto}` with templates and expressions).
-//
-// This intentionally coexists with reqraft's own compact `ArrayAutoField`
-// (tags + renderItem seam), which `Field.tsx` — reqraft's dispatcher — keeps
-// using. The ported auto field uses THIS one, matching the IDE 1:1.
-//
-// Seams: `IField`/`IFieldChange` types folded in locally; the IDE's debug
-// `console.log`s removed; `StyledPairField` return-type annotation dropped.
-import {
-  ReqoreButton,
-  ReqoreControlGroup,
-  ReqorePanel,
-  ReqoreTag,
-  ReqoreVerticalSpacer,
-  useReqoreProperty,
-} from '@qoretechnologies/reqore';
-import { isEqual, map, size } from 'lodash';
-import { useEffect, useState } from 'react';
-import { useDebounce } from 'react-use';
-import { useEmittedValues } from '../emittedValues';
-import { validateFieldWithResult } from '../../../../helpers/validations';
-import { useWhyDidYouUpdate } from '../../../../hooks/useWhyDidYouUpdate';
-// Direct imports — the cycle (ArrayAuto → TemplateField/auto → ArrayAuto) is
-// safe the same way Field → AutoFormField → Field is.
-import { recordIdentity } from '../../engine/readFirst';
-import { AutoFormField } from '../auto/AutoFormField';
-import { TemplateField } from '../template/TemplateField';
-
-export const allowedTypes: string[] = ['string', 'int', 'float', 'date', 'file'];
-const defaultValueByType = {
-  string: undefined,
-  int: undefined,
-  float: undefined,
-  date: undefined,
-  file: undefined,
-  hash: {},
-  list: [],
-};
-
-export interface IArrayAutoProps {
-  name?: string;
-  onChange?: (name: string, value: any[]) => void;
-  value?: any[];
-  default_value?: any;
-  display_name?: string;
-  type?: string;
-  /** Render each row's `arg_schema` sub-form in compact (read-first) mode,
-   *  matching the parent engine. Deliberately NOT destructured below: it rides
-   *  `...rest` into each row's `TemplateField` -> `AutoFormField`, whose `hash`
-   *  case hands it to the nested `FormEngine`. Destructuring it here would break
-   *  that chain and silently return every row to the classic layout. */
-  compact?: boolean;
-  [key: string]: any;
-}
-
-export const ArrayAuto = ({
-  name,
-  onChange,
-  value = [],
-  default_value,
-  display_name,
-  ...rest
-}: IArrayAutoProps): any => {
-  const confirmAction = useReqoreProperty('confirmAction');
-  const [localValue, setLocalValue] = useState(value);
-  // The row this component just created, so its sub-form can open the field it
-  // cannot be saved without. Only a row added HERE gets it: the rows already in
-  // the value were added by an earlier session (or arrived from the server), and
-  // opening one of those on mount would be this component reopening a decision
-  // the author already made.
-  const [justAddedIndex, setJustAddedIndex] = useState<number | undefined>(undefined);
-
-  useWhyDidYouUpdate(`Array Auto ${name}`, {
-    name,
-    onChange,
-    value,
-    default_value,
-    display_name,
-    ...rest,
-  });
-
-  // The parent's echo of an emit still in flight is not a change: copying it
-  // over the local list lost what was edited since. See `EmittedValues`.
-  const emitted = useEmittedValues<unknown>(isEqual);
-
-  useEffect(() => {
-    if (emitted.isEcho(value)) {
-      return;
-    }
-    setLocalValue(value);
-  }, [JSON.stringify(value)]);
-
-  useDebounce(
-    () => {
-      emitted.record(localValue);
-      onChange?.(name, localValue);
-    },
-    300,
-    [JSON.stringify(localValue)]
-  );
-
-  const addValue: () => void = () => {
-    setJustAddedIndex(localValue.length);
-    setLocalValue([...localValue, defaultValueByType[rest.type]]);
-  };
-
-  const handleRemoveClick: (id: number) => void = (id) => {
-    setLocalValue(localValue.filter((_, idx) => idx !== id));
-  };
-
-  const handleChange: (idx: string, itemValue: any) => void = (idx, itemValue) => {
-    const newValues = [...localValue];
-
-    newValues[idx] = itemValue;
-
-    setLocalValue(newValues);
-  };
-
-  const showValidationMessage = (value) => {
-    const validationResult = validateFieldWithResult(rest.type, value);
-
-    if (!validationResult.isValid) {
-      return (
-        <ReqoreControlGroup vertical>
-          <ReqoreVerticalSpacer height={5} />
-          <ReqoreTag
-            intent='danger'
-            size='tiny'
-            minimal
-            icon='ErrorWarningLine'
-            label={validationResult.reason}
-          />
-        </ReqoreControlGroup>
-      );
-    }
-
-    return null;
-  };
-
-  // Render list of auto fields
-  return (
-    <ReqoreControlGroup vertical fluid>
-      {map(localValue, (val: string | number, idx: string) => {
-        // The same field the collapsed preview promotes, resolved by the same
-        // definition — see `recordIdentity`. A list of seven methods headed
-        // `#1 … #7` makes the reader open each one to find out which is which,
-        // and heading them differently in the preview and the editor would make
-        // one item answer to two names.
-        const identity =
-          val && typeof val === 'object' && !Array.isArray(val)
-            ? recordIdentity(val as Record<string, unknown>, rest.arg_schema)
-            : undefined;
-
-        return (
-        <ReqorePanel
-          key={idx}
-          // `#N` stays as the fallback: a row whose identifying field is still
-          // empty (one just added) has nothing to be called yet, and a blank
-          // heading would be worse than a number.
-          label={identity?.text || `#${idx + 1}`}
-          tooltip={identity?.label}
-          unMountContentOnCollapse={false}
-          // The position moves to the badge once the name owns the heading, so
-          // "which of these is third" stays answerable.
-          badge={identity ? `#${idx + 1}` : display_name || name}
-          collapsible
-          responsiveActions={false}
-          responsiveTitle={false}
-          className='array-auto-item'
-          collapseButtonProps={{
-            transparent: true,
-            style: {
-              paddingLeft: 0,
-              paddingRight: 0,
-              minWidth: '10px',
-            },
-          }}
-          size='small'
-          minimal
-          actions={[
-            {
-              show: size(localValue) !== 1 && !rest.disabled && !rest.readOnly,
-              icon: 'DeleteBinLine',
-              intent: 'danger',
-              className: 'array-auto-item-remove',
-              tooltip: 'Remove item',
-              onClick: () =>
-                confirmAction({
-                  onConfirm: () => handleRemoveClick(Number(idx)),
-                }),
-              minimal: true,
-            },
-          ]}
-        >
-          <TemplateField
-            key={idx}
-            component={AutoFormField}
-            {...rest}
-            fluid
-            allowCustomValues
-            allowFunctions
-            allowTemplates
-            defaultType={rest.type}
-            name={`${name}-${idx}`}
-            // AFTER `{...rest}` on purpose: this is the one prop that differs
-            // per row, and spreading rest over it would give every row the same
-            // answer. Rides TemplateField's `rest` into the row's AutoFormField,
-            // which hands it to the row's nested FormEngine (case 'hash').
-            expandFirstRequired={Number(idx) === justAddedIndex}
-            value={val}
-            onChange={(_name, value) => handleChange(idx, value)}
-          />
-          {showValidationMessage(val)}
-        </ReqorePanel>
-        );
-      })}
-      <ReqoreControlGroup fluid>
-        <ReqoreButton
-          onClick={addValue}
-          icon='AddLine'
-          rightIcon='AddLine'
-          textAlign='center'
-          customTheme={{
-            main: '#22273b',
-          }}
-          size={rest.size}
-          disabled={rest.disabled || rest.readOnly}
-        >
-          Add new item {display_name || name ? `for "${display_name || name}"` : null}
-        </ReqoreButton>
-      </ReqoreControlGroup>
-    </ReqoreControlGroup>
-  );
-};