Add series data entry feature

specifyweb/frontend/js_src/lib/components/FormEditor/Create.tsx

@@ -2,8 +2,8 @@ import React from 'react';
 import { useOutletContext } from 'react-router';
 import { useNavigate } from 'react-router-dom';
 import type { LocalizedString } from 'typesafe-i18n';
-import { useAsyncState } from '../../hooks/useAsyncState';
 
+import { useAsyncState } from '../../hooks/useAsyncState';
 import { useBooleanState } from '../../hooks/useBooleanState';
 import { useId } from '../../hooks/useId';
 import { commonText } from '../../localization/common';

specifyweb/frontend/js_src/lib/components/FormSliders/RecordSelectorFromIds.tsx

@@ -48,6 +48,7 @@ export function RecordSelectorFromIds<SCHEMA extends AnySchema>({
   onClone: handleClone,
   onDelete: handleDelete,
   onFetch: handleFetch,
+  onCarryBulk: handleCarryBulk,
   ...rest
 }: Omit<RecordSelectorProps<SCHEMA>, 'index' | 'records'> & {
   /*
@@ -74,6 +75,7 @@ export function RecordSelectorFromIds<SCHEMA extends AnySchema>({
   readonly onFetch?: (
     index: number
   ) => Promise<RA<number | undefined> | undefined>;
+  readonly onCarryBulk?: (ids: RA<number>) => void;
 }): JSX.Element | null {
   const [records, setRecords] = React.useState<
     RA<SpecifyResource<SCHEMA> | undefined>
@@ -233,12 +235,14 @@ export function RecordSelectorFromIds<SCHEMA extends AnySchema>({
           </div>
         )}
         isDependent={isDependent}
+        isInRecordSet={!isNewRecordSet}
         isLoading={isLoading || isExternalLoading}
         isSubForm={false}
         resource={resource}
         title={title}
         viewName={viewName}
         onAdd={handleClone}
+        onCarryBulk={handleCarryBulk}
         onClose={handleClose}
         onDeleted={
           resource?.isNew() === true || hasTablePermission(table.name, 'delete')

specifyweb/frontend/js_src/lib/components/FormSliders/RecordSet.tsx

@@ -23,6 +23,7 @@ import type { SpecifyResource } from '../DataModel/legacyTypes';
 import {
   createResource,
   deleteResource,
+  fetchResource,
   getResourceViewUrl,
 } from '../DataModel/resource';
 import { serializeResource } from '../DataModel/serializers';
@@ -306,8 +307,23 @@ function RecordSet<SCHEMA extends AnySchema>({
   }
 
   async function createNewRecordSet(
-    ids: RA<number | undefined>
+    ids: RA<number | undefined>,
+    fromBulkCarry: boolean = false
   ): Promise<void> {
+    if (
+      fromBulkCarry &&
+      typeof ids[0] === 'number' &&
+      typeof ids.at(-1) === 'number'
+    ) {
+      const startingResource = fetchResource('CollectionObject', ids[0]);
+      const endingResource = fetchResource('CollectionObject', ids.at(-1)!);
+      const startingResourceCatNumber = (await startingResource).catalogNumber;
+      const endingResourceCatNumber = (await endingResource).catalogNumber;
+      recordSet.set(
+        'name',
+        `Batch #${startingResourceCatNumber} - #${endingResourceCatNumber}`
+      );
+    }
     await recordSet.save();
     await addIdsToRecordSet(ids);
     navigate(`/specify/record-set/${recordSet.id}/`);
@@ -397,6 +413,9 @@ function RecordSet<SCHEMA extends AnySchema>({
                 })
             : undefined
         }
+        onCarryBulk={(ids) => {
+          loading(createNewRecordSet(ids, true));
+        }}
         onClone={(newResource): void => go(totalCount, 'new', newResource)}
         onClose={handleClose}
         onDelete={

specifyweb/frontend/js_src/lib/components/Forms/ResourceView.tsx

@@ -7,6 +7,7 @@ import { useIsModified } from '../../hooks/useIsModified';
 import { useTriggerState } from '../../hooks/useTriggerState';
 import { commonText } from '../../localization/common';
 import { formsText } from '../../localization/forms';
+import type { RA } from '../../utils/types';
 import { Container } from '../Atoms';
 import { Button } from '../Atoms/Button';
 import { className } from '../Atoms/className';
@@ -112,6 +113,8 @@ export function ResourceView<SCHEMA extends AnySchema>({
   isCollapsed,
   preHeaderButtons,
   containerRef,
+  onCarryBulk: handleCarryBulk,
+  isInRecordSet,
 }: {
   readonly isLoading?: boolean;
   readonly resource: SpecifyResource<SCHEMA> | undefined;
@@ -136,6 +139,8 @@ export function ResourceView<SCHEMA extends AnySchema>({
   readonly isCollapsed?: boolean;
   readonly preHeaderButtons?: JSX.Element | undefined;
   readonly containerRef?: React.RefObject<HTMLDivElement>;
+  readonly onCarryBulk?: (ids: RA<number>) => void;
+  readonly isInRecordSet?: boolean;
 }): JSX.Element {
   const [isDeleted, setDeleted, setNotDeleted] = useBooleanState();
   // Remove isDeleted status when resource changes
@@ -225,8 +230,10 @@ export function ResourceView<SCHEMA extends AnySchema>({
     ) : (
       <SaveButton
         form={formElement}
+        isInRecordSet={isInRecordSet}
         resource={resource}
         onAdd={handleAdd}
+        onCarryBulk={handleCarryBulk}
         onSaved={(): void => {
           const printOnSave = userPreferences.get(
             'form',

specifyweb/frontend/js_src/lib/components/Forms/Save.tsx

@@ -9,9 +9,11 @@ import { commonText } from '../../localization/common';
 import { formsText } from '../../localization/forms';
 import { smoothScroll } from '../../utils/dom';
 import { listen } from '../../utils/events';
+import type { RA, WritableArray } from '../../utils/types';
 import { replaceKey } from '../../utils/utils';
 import { Button } from '../Atoms/Button';
 import { className } from '../Atoms/className';
+import { Input, Label } from '../Atoms/Form';
 import { Submit } from '../Atoms/Submit';
 import { LoadingContext } from '../Core/Contexts';
 import type { AnySchema } from '../DataModel/helperTypes';
@@ -55,6 +57,8 @@ export function SaveButton<SCHEMA extends AnySchema = AnySchema>({
   onSaving: handleSaving,
   onSaved: handleSaved,
   onAdd: handleAdd,
+  onCarryBulk: handleCarryBulk,
+  isInRecordSet,
 }: {
   readonly resource: SpecifyResource<SCHEMA>;
   readonly form: HTMLFormElement;
@@ -73,6 +77,8 @@ export function SaveButton<SCHEMA extends AnySchema = AnySchema>({
   readonly onAdd?: (newResource: SpecifyResource<SCHEMA>) => void;
   // Only display save blockers for a given field
   readonly filterBlockers?: LiteralField | Relationship;
+  readonly onCarryBulk?: (ids: RA<number>) => void;
+  readonly isInRecordSet?: boolean;
 }): JSX.Element {
   const id = useId('save-button');
   const saveRequired = useIsModified(resource);
@@ -195,7 +201,10 @@ export function SaveButton<SCHEMA extends AnySchema = AnySchema>({
   const copyButton = (
     label: LocalizedString,
     description: LocalizedString,
-    handleClick: () => Promise<SpecifyResource<SCHEMA>>
+    handleClick: () =>
+      | Promise<RA<SpecifyResource<SCHEMA>>>
+      | Promise<SpecifyResource<SCHEMA>>,
+    originalResourceId?: number
   ): JSX.Element => (
     <ButtonComponent
       className={saveBlocked ? '!cursor-not-allowed' : undefined}
@@ -204,17 +213,69 @@ export function SaveButton<SCHEMA extends AnySchema = AnySchema>({
       onClick={(): void => {
         // Scroll to the top of the form on clone
         smoothScroll(form, 0);
-        loading(handleClick().then(handleAdd));
+        loading(
+          handleClick()
+            .then((result) => {
+              const ids: WritableArray<number> = [];
+              if (originalResourceId !== undefined) {
+                ids.push(originalResourceId);
+              }
+              if (Array.isArray(result)) {
+                result.forEach((newResource) => {
+                  handleAdd?.(newResource);
+                  ids.push(newResource.id);
+                });
+              } else {
+                handleAdd?.(result);
+              }
+              return ids;
+            })
+            .then((ids) => {
+              if (handleCarryBulk && ids.length > 2) {
+                handleCarryBulk(ids);
+              }
+            })
+        );
       }}
     >
       {label}
     </ButtonComponent>
   );
 
+  const [carryForwardAmount, setCarryForwardAmount] = React.useState<number>(2);
+  const [showBulkCarryInput, setBulkCarryInput] = React.useState(false);
+
   return (
     <>
       {typeof handleAdd === 'function' && canCreate ? (
         <>
+          {resource.specifyTable.name === 'CollectionObject' &&
+          !isInRecordSet &&
+          !showBulkCarryInput &&
+          !resource.needsSaved ? (
+            <Button.Save
+              title={commonText.bulkCarry()}
+              onClick={() => setBulkCarryInput(true)}
+            >
+              {commonText.bulkCarry()}
+            </Button.Save>
+          ) : null}
+          {resource.specifyTable.name === 'CollectionObject' &&
+          !isInRecordSet &&
+          showBulkCarryInput ? (
+            <Label.Inline>
+              {commonText.bulkCarry()}
+              <Input.Generic
+                type="number"
+                value={carryForwardAmount}
+                onValueChange={(value): void =>
+                  carryForwardAmount === undefined
+                    ? setCarryForwardAmount(2)
+                    : setCarryForwardAmount(Number.parseInt(value))
+                }
+              />
+            </Label.Inline>
+          ) : null}
           {showClone &&
             copyButton(
               formsText.clone(),
@@ -225,7 +286,29 @@ export function SaveButton<SCHEMA extends AnySchema = AnySchema>({
             copyButton(
               formsText.carryForward(),
               formsText.carryForwardDescription(),
-              async () => resource.clone(false)
+              resource.specifyTable.name === 'CollectionObject' &&
+                carryForwardAmount > 2
+                ? async () => {
+                    const clones = Array.from(
+                      { length: carryForwardAmount },
+                      async () => {
+                        const clonedResource = await resource.clone(false);
+                        const formatter = clonedResource.specifyTable
+                          .strictGetLiteralField('catalogNumber')
+                          .getUiFormatter()!;
+                        const wildCard = formatter.valueOrWild();
+                        await clonedResource.set(
+                          'catalogNumber',
+                          wildCard as never
+                        );
+                        await clonedResource.save();
+                        return clonedResource;
+                      }
+                    );
+                    return Promise.all(clones);
+                  }
+                : async () => resource.clone(false),
+              resource.id
             )}
           {showAdd &&
             copyButton(

specifyweb/frontend/js_src/lib/localization/common.ts

@@ -682,6 +682,7 @@ export const commonText = createDictionary({
     'ru-ru': 'Массовый выбор',
     'uk-ua': 'Масовий вибір',
   },
+  bulkCarry: { 'en-us': 'Bulk Carry' },
   bulkReturn: {
     'en-us': 'Bulk Return',
     'de-ch': 'Massenrücksendung',