Add "default" initialize property to QCBX

specifyweb/frontend/js_src/lib/components/FormEditor/viewSpec.ts

@@ -862,6 +862,7 @@ const queryComboBoxSpec = (
       syncers.maybe(syncers.toBoolean),
       syncers.default<boolean>(true)
     ),
+    defaultRecord: syncers.xmlAttribute('initialize default', 'skip'),
     legacyHelpContext: syncers.xmlAttribute('initialize hc', 'skip'),
     // Make query compatible with multiple ORMs
     legacyAdjustQuery: pipe(

specifyweb/frontend/js_src/lib/components/FormFields/index.tsx

@@ -151,10 +151,12 @@ const fieldRenderers: {
       hasEditButton,
       hasSearchButton,
       hasViewButton,
+      defaultRecord,
     },
   }) {
     return field === undefined || !field.isRelationship ? null : (
       <QueryComboBox
+        defaultRecord={defaultRecord}
         field={field}
         forceCollection={undefined}
         formType={formType}

specifyweb/frontend/js_src/lib/components/FormParse/fields.ts

@@ -61,6 +61,7 @@ export type FieldTypes = {
       readonly hasViewButton: boolean;
       readonly typeSearch: string | undefined;
       readonly searchView: string | undefined;
+      readonly defaultRecord: string | undefined;
     }
   >;
   readonly Text: State<
@@ -246,6 +247,7 @@ const processFieldType: {
             : getProperty('viewBtn')?.toLowerCase() === 'true',
         typeSearch: getProperty('name'),
         searchView: getProperty('searchView'),
+        defaultRecord: getProperty('default'),
       };
     } else {
       console.error('QueryComboBox can only be used to display a relationship');

specifyweb/frontend/js_src/lib/components/Forms/generateFormDefinition.ts

@@ -218,6 +218,7 @@ function generateForm(
                         typeSearch: undefined,
                         searchView: undefined,
                         isReadOnly: mode === 'view',
+                        defaultRecord: undefined,
                       },
                       isRequired: false,
                       viewName: undefined,

specifyweb/frontend/js_src/lib/components/Merging/CompareField.tsx

@@ -130,6 +130,7 @@ function fieldToDefinition(
       hasViewButton: false,
       typeSearch: undefined,
       searchView: undefined,
+      defaultRecord: undefined,
     };
   else if (field.type === 'java.lang.Boolean')
     return {

specifyweb/frontend/js_src/lib/components/Preferences/UserDefinitions.tsx

@@ -65,9 +65,10 @@ const isDarkMode = ({
 }: PreferencesVisibilityContext): boolean => isDarkMode || isRedirecting;
 
 // Navigator may not be defined in some environments, like non-browser environments
-const altKeyName = typeof navigator !== 'undefined' && navigator?.userAgent?.includes('Mac')
-  ? 'Option'
-  : 'Alt';
+const altKeyName =
+  typeof navigator !== 'undefined' && navigator?.userAgent?.includes('Mac')
+    ? 'Option'
+    : 'Alt';
 
 /**
  * Have to be careful as preferences may be used before schema is loaded

specifyweb/frontend/js_src/lib/components/QueryComboBox/helpers.ts

@@ -230,3 +230,61 @@ export function pendingValueToResource(
     typeof fieldName === 'string' ? { [fieldName]: pendingValue } : {}
   );
 }
+
+const DEFAULT_RECORD_PRESETS = {
+  CURRENT_AGENT: () => userInformation.agent.resource_uri,
+  CURRENT_USER: () => userInformation.resource_uri,
+  BLANK: () => null,
+} as const;
+type DefaultRecordPreset = keyof typeof DEFAULT_RECORD_PRESETS;
+
+export function useQueryComboBoxDefaults({
+  resource,
+  field,
+  defaultRecord,
+}: {
+  readonly resource: SpecifyResource<AnySchema> | undefined;
+  readonly field: Relationship;
+  readonly defaultRecord?: string | undefined;
+}): void {
+  if (resource === undefined || !resource.isNew()) return;
+
+  if (defaultRecord !== undefined) {
+    const defaultUri: string | null =
+      defaultRecord in DEFAULT_RECORD_PRESETS
+        ? DEFAULT_RECORD_PRESETS[defaultRecord as DefaultRecordPreset]()
+        : defaultRecord;
+
+    resource.set(field.name, resource.get(field.name) ?? defaultUri, {
+      silent: true,
+    });
+    // The following cases need to be kept for outdated forms that do not use the defaultRecord property.
+  } else if (field.name === 'cataloger') {
+    const record = toTable(resource, 'CollectionObject');
+    record?.set(
+      'cataloger',
+      record?.get('cataloger') ?? userInformation.agent.resource_uri,
+      {
+        silent: true,
+      }
+    );
+  } else if (field.name === 'specifyUser') {
+    const record = toTable(resource, 'RecordSet');
+    record?.set(
+      'specifyUser',
+      record?.get('specifyUser') ?? userInformation.resource_uri,
+      {
+        silent: true,
+      }
+    );
+  } else if (field.name === 'receivedBy') {
+    const record = toTable(resource, 'LoanReturnPreparation');
+    record?.set(
+      'receivedBy',
+      record?.get('receivedBy') ?? userInformation.agent.resource_uri,
+      {
+        silent: true,
+      }
+    );
+  }
+}

specifyweb/frontend/js_src/lib/components/QueryComboBox/index.tsx

@@ -12,7 +12,7 @@ import type { RA } from '../../utils/types';
 import { filterArray, localized } from '../../utils/types';
 import { DataEntry } from '../Atoms/DataEntry';
 import { LoadingContext, ReadOnlyContext } from '../Core/Contexts';
-import { backboneFieldSeparator, toTable } from '../DataModel/helpers';
+import { backboneFieldSeparator } from '../DataModel/helpers';
 import type { AnySchema } from '../DataModel/helperTypes';
 import type { SpecifyResource } from '../DataModel/legacyTypes';
 import {
@@ -47,6 +47,7 @@ import {
   getRelatedCollectionId,
   makeComboBoxQuery,
   pendingValueToResource,
+  useQueryComboBoxDefaults,
 } from './helpers';
 import type { TypeSearch } from './spec';
 import { useCollectionRelationships } from './useCollectionRelationships';
@@ -72,6 +73,7 @@ export function QueryComboBox({
   typeSearch: initialTypeSearch,
   forceCollection,
   searchView,
+  defaultRecord,
   relatedTable: initialRelatedTable,
 }: {
   readonly id: string | undefined;
@@ -87,41 +89,10 @@ export function QueryComboBox({
   readonly typeSearch: TypeSearch | string | undefined;
   readonly forceCollection: number | undefined;
   readonly searchView?: string;
+  readonly defaultRecord?: string | undefined;
   readonly relatedTable?: SpecifyTable | undefined;
 }): JSX.Element {
-  React.useEffect(() => {
-    if (resource === undefined || !resource.isNew()) return;
-    if (field.name === 'cataloger') {
-      const record = toTable(resource, 'CollectionObject');
-      record?.set(
-        'cataloger',
-        record?.get('cataloger') ?? userInformation.agent.resource_uri,
-        {
-          silent: true,
-        }
-      );
-    }
-    if (field.name === 'specifyUser') {
-      const record = toTable(resource, 'RecordSet');
-      record?.set(
-        'specifyUser',
-        record?.get('specifyUser') ?? userInformation.resource_uri,
-        {
-          silent: true,
-        }
-      );
-    }
-    if (field.name === 'receivedBy') {
-      const record = toTable(resource, 'LoanReturnPreparation');
-      record?.set(
-        'receivedBy',
-        record?.get('receivedBy') ?? userInformation.agent.resource_uri,
-        {
-          silent: true,
-        }
-      );
-    }
-  }, [resource, field]);
+  useQueryComboBoxDefaults({ resource, field, defaultRecord });
 
   const treeData = useTreeData(resource, field);
   const collectionRelationships = useCollectionRelationships(resource);
@@ -264,29 +235,32 @@ export function QueryComboBox({
     (typeof typeSearch === 'object' ? typeSearch?.table : undefined) ??
     field.relatedTable;
 
-    const [fetchedTreeDefinition] = useAsyncState(
-      React.useCallback(async () => {
-        if (resource?.specifyTable === tables.Determination) {
-          return resource.collection?.related?.specifyTable === tables.CollectionObject
-            ? (resource.collection?.related as SpecifyResource<CollectionObject>)
-                .rgetPromise('collectionObjectType')
-                .then(
-                  (
-                    collectionObjectType:
-                      | SpecifyResource<CollectionObjectType>
-                      | undefined
-                  ) => collectionObjectType?.get('taxonTreeDef')
-                )
-            : undefined;
-        } else if (resource?.specifyTable === tables.Taxon) {
-          const definition = resource.get('definition')
-          const parentDefinition = (resource?.independentResources?.parent as SpecifyResource<AnySchema>)?.get?.('definition');
-          return definition || parentDefinition;
+  const [fetchedTreeDefinition] = useAsyncState(
+    React.useCallback(async () => {
+      if (resource?.specifyTable === tables.Determination) {
+        return resource.collection?.related?.specifyTable ===
+          tables.CollectionObject
+          ? (resource.collection?.related as SpecifyResource<CollectionObject>)
+              .rgetPromise('collectionObjectType')
+              .then(
+                (
+                  collectionObjectType:
+                    | SpecifyResource<CollectionObjectType>
+                    | undefined
+                ) => collectionObjectType?.get('taxonTreeDef')
+              )
+          : undefined;
+      } else if (resource?.specifyTable === tables.Taxon) {
+        const definition = resource.get('definition');
+        const parentDefinition = (
+          resource?.independentResources?.parent as SpecifyResource<AnySchema>
+        )?.get?.('definition');
+        return definition || parentDefinition;
       }
-        return undefined;
-      }, [resource, resource?.collection?.related?.get('collectionObjectType')]),
-      false
-    );
+      return undefined;
+    }, [resource, resource?.collection?.related?.get('collectionObjectType')]),
+    false
+  );
 
   // Tree Definition passed by a parent QCBX in the component tree
   const parentTreeDefinition = React.useContext(TreeDefinitionContext);

specifyweb/frontend/js_src/lib/components/RouterCommands/SwitchCollection.tsx

@@ -42,8 +42,8 @@ export function SwitchCollectionCommand(): null {
           body: collectionId!.toString(),
           errorMode: 'dismissible',
         })
-        .then(clearAllCache)
-        .then(() => globalThis.location.replace(nextUrl)),
+          .then(clearAllCache)
+          .then(() => globalThis.location.replace(nextUrl)),
       [collectionId, nextUrl]
     ),
     true