@kenyaemr/esm-imaging-orders-app 4.0.1-pre.1

package/src/form/imaging-orders/add-imaging-orders/imaging-order-form.scss

@@ -0,0 +1,79 @@
+@use '@carbon/layout';
+@use '@carbon/type';
+@use '@carbon/colors';
+
+.orderForm {
+  flex-grow: 1;
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+
+  :global(.cds--css-grid) {
+    max-width: unset;
+  }
+
+  :global(.cds--css-grid-column) {
+    margin: 0 layout.$spacing-03 !important;
+  }
+
+  :global(.cds--subgrid) {
+    margin: 0 calc(layout.$spacing-03 * -1) !important;
+  }
+
+  :global(.cds--number--nosteppers.cds--number input[type='number']) {
+    padding-right: layout.$spacing-05;
+  }
+
+  :global(.cds--number__control-btn) {
+    border: 0;
+  }
+}
+
+.form {
+  margin: layout.$spacing-05;
+}
+
+.gridRow {
+  padding: 0px;
+
+  :global(.cds--number) {
+    display: inline-block;
+  }
+}
+
+.field {
+  margin-bottom: layout.$spacing-05;
+}
+
+.buttonSet {
+  :global(.cds--btn) {
+    width: 50%;
+    max-width: unset;
+  }
+}
+
+.errorContainer {
+  margin: 1rem;
+}
+
+.errorNotification {
+  margin: 0.5rem 0;
+}
+
+/* Tablet */
+:global(.omrs-breakpoint-lt-desktop) {
+  .orderForm {
+    height: calc(100vh - 6rem - var(--workspace-header-height));
+    background-color: #ededed;
+  }
+
+  .buttonSet {
+    padding: layout.$spacing-06 layout.$spacing-05;
+    background-color: colors.$gray-10;
+  }
+
+  .errorContainer {
+    margin: 1rem;
+    margin-bottom: calc(var(--bottom-nav-height) + 1rem);
+  }
+}

package/src/form/imaging-orders/add-imaging-orders/imaging-order.ts

@@ -0,0 +1,19 @@
+import { type ImagingOrderBasketItem } from '../../../types';
+import { type ImagingType } from './useImagingTypes';
+
+// See the Urgency enum in https://github.com/openmrs/openmrs-core/blob/492dcd35b85d48730bd19da48f6db146cc882c22/api/src/main/java/org/openmrs/Order.java
+export const priorityOptions = [
+  { value: 'ROUTINE', label: 'Routine' },
+  { value: 'STAT', label: 'Stat' },
+  { value: 'ON_SCHEDULED_DATE', label: 'Scheduled' },
+];
+
+// TODO add priority option `{ value: "ON_SCHEDULED_DATE", label: "On scheduled date" }` once the form supports a date.
+export function createEmptyLabOrder(testType: ImagingType, orderer: string): ImagingOrderBasketItem {
+  return {
+    action: 'NEW',
+    display: testType.label,
+    testType,
+    orderer,
+  };
+}

package/src/form/imaging-orders/add-imaging-orders/imaging-type-search.scss

@@ -0,0 +1,115 @@
+@use '@carbon/layout';
+@use '@carbon/type';
+@use '@openmrs/esm-styleguide/src/vars' as *;
+
+/** For TestTypeSearchResults */
+
+.container {
+  margin: layout.$spacing-03 layout.$spacing-05;
+}
+
+.divider {
+  border: 0;
+  border-top: 1px solid $color-gray-30;
+  width: 66%;
+}
+
+.desktopDivider {
+  margin: layout.$spacing-07 auto layout.$spacing-05;
+}
+
+.tabletDivider {
+  margin: layout.$spacing-08 auto layout.$spacing-06;
+}
+
+.searchResultsCount {
+  @include type.type-style('body-compact-01');
+  color: $text-02;
+}
+
+.orderBasketSearchResultsHeader {
+  display: flex;
+  justify-content: space-between;
+  margin-bottom: layout.$spacing-03;
+  align-items: center;
+}
+
+/** For TestTypeSearchResultItem */
+
+.searchResultTile {
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+  border: 1px solid $grey-2;
+  &:not(:last-of-type) {
+    margin-bottom: layout.$spacing-03;
+  }
+}
+
+.tabletSearchResultTile {
+  margin-top: 5px;
+  background-color: $ui-02;
+}
+
+.searchResultTileContent {
+  padding: layout.$spacing-03 layout.$spacing-05;
+}
+
+.searchResultActions {
+  border-top: 1px solid $grey-2;
+  padding: 0 layout.$spacing-05;
+  display: flex;
+  justify-content: flex-end;
+}
+
+.searchResultSkeletonWrapper {
+  margin: layout.$spacing-03 1rem layout.$spacing-03;
+
+  :global(.cds--skeleton__text) {
+    margin: 0;
+  }
+
+  .searchResultCntSkeleton {
+    margin-right: layout.$spacing-07;
+  }
+
+  .skeletonTile {
+    display: flex;
+    align-items: center;
+  }
+}
+
+.emptyState {
+  margin: layout.$spacing-05;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  padding: layout.$spacing-07;
+  border: 1px solid $ui-03;
+  text-align: center;
+  background-color: $ui-01;
+}
+
+:global(.omrs-breakpoint-lt-small-desktop) .emptyState {
+  background-color: $ui-02;
+}
+
+.link {
+  color: $interactive-01;
+  text-decoration: underline;
+  cursor: pointer;
+}
+
+.resultsContainer {
+  overflow-y: scroll;
+}
+
+.resultsContainer::-webkit-scrollbar {
+  width: layout.$spacing-03;
+}
+
+.resultsContainer::-webkit-scrollbar-thumb {
+  background: $ui-04;
+  border-radius: layout.$spacing-02;
+}

package/src/form/imaging-orders/add-imaging-orders/imaging-type-search.tsx

@@ -0,0 +1,235 @@
+import React, { useCallback, useMemo, useRef, useState } from 'react';
+import classNames from 'classnames';
+import { useTranslation } from 'react-i18next';
+import { Button, ButtonSkeleton, Search, SkeletonText, Tile } from '@carbon/react';
+import { ArrowRight, ShoppingCartArrowDown, ShoppingCartArrowUp } from '@carbon/react/icons';
+import { useDebounce, useLayoutType, useSession, ResponsiveWrapper, closeWorkspace } from '@openmrs/esm-framework';
+import { launchPatientWorkspace, useOrderBasket } from '@openmrs/esm-patient-common-lib';
+import { prepImagingOrderPostData } from '../api';
+import { type ImagingType, useImagingTypes } from './useImagingTypes';
+import { createEmptyLabOrder } from './imaging-order';
+import styles from './imaging-type-search.scss';
+import { type ImagingOrderBasketItem } from '../../../types';
+
+export interface TestTypeSearchProps {
+  openLabForm: (searchResult: ImagingOrderBasketItem) => void;
+}
+
+export function TestTypeSearch({ openLabForm }: TestTypeSearchProps) {
+  const { t } = useTranslation();
+  const [searchTerm, setSearchTerm] = useState('');
+  const debouncedSearchTerm = useDebounce(searchTerm);
+  const searchInputRef = useRef(null);
+
+  const focusAndClearSearchInput = () => {
+    setSearchTerm('');
+    searchInputRef.current?.focus();
+  };
+
+  const handleSearchTermChange = (event: React.ChangeEvent<HTMLInputElement>) => {
+    setSearchTerm(event.target.value ?? '');
+  };
+
+  return (
+    <>
+      <ResponsiveWrapper>
+        <Search
+          autoFocus
+          size="lg"
+          placeholder={t('searchFieldPlaceholder', 'Search for an imaging test')}
+          labelText={t('searchFieldPlaceholder', 'Search for an imaging test')}
+          onChange={handleSearchTermChange}
+          ref={searchInputRef}
+          value={searchTerm}
+        />
+      </ResponsiveWrapper>
+      <TestTypeSearchResults
+        searchTerm={debouncedSearchTerm}
+        openOrderForm={openLabForm}
+        focusAndClearSearchInput={focusAndClearSearchInput}
+      />
+    </>
+  );
+}
+
+interface TestTypeSearchResultsProps {
+  searchTerm: string;
+  openOrderForm: (searchResult: ImagingOrderBasketItem) => void;
+  focusAndClearSearchInput: () => void;
+}
+
+function TestTypeSearchResults({ searchTerm, openOrderForm, focusAndClearSearchInput }: TestTypeSearchResultsProps) {
+  const { t } = useTranslation();
+  const isTablet = useLayoutType() === 'tablet';
+  const { testTypes, isLoading, error } = useImagingTypes(searchTerm);
+
+  if (isLoading) {
+    return <TestTypeSearchSkeleton />;
+  }
+
+  if (error) {
+    return (
+      <Tile className={styles.emptyState}>
+        <div>
+          <h4 className={styles.productiveHeading01}>
+            {t('errorFetchingTestTypes', 'Error fetching results for "{{searchTerm}}"', {
+              searchTerm,
+            })}
+          </h4>
+          <p className={styles.bodyShort01}>
+            <span>{t('trySearchingAgain', 'Please try searching again')}</span>
+          </p>
+        </div>
+      </Tile>
+    );
+  }
+
+  return (
+    <>
+      {testTypes?.length ? (
+        <div className={styles.container}>
+          {searchTerm && (
+            <div className={styles.orderBasketSearchResultsHeader}>
+              <span className={styles.searchResultsCount}>
+                {t('searchResultsMatchesForTerm', '{{count}} results for "{{searchTerm}}"', {
+                  count: testTypes?.length,
+                  searchTerm,
+                })}
+              </span>
+              <Button kind="ghost" onClick={focusAndClearSearchInput} size={isTablet ? 'md' : 'sm'}>
+                {t('clearSearchResults', 'Clear Results')}
+              </Button>
+            </div>
+          )}
+          <div className={styles.resultsContainer}>
+            {testTypes.map((testType) => (
+              <TestTypeSearchResultItem key={testType.conceptUuid} testType={testType} openOrderForm={openOrderForm} />
+            ))}
+          </div>
+        </div>
+      ) : (
+        <Tile className={styles.emptyState}>
+          <div>
+            <h4 className={styles.productiveHeading01}>
+              {t('noResultsForTestTypeSearch', 'No results to display for "{{searchTerm}}"', {
+                searchTerm,
+              })}
+            </h4>
+            <p className={styles.bodyShort01}>
+              <span>{t('tryTo', 'Try to')}</span>{' '}
+              <span className={styles.link} role="link" tabIndex={0} onClick={focusAndClearSearchInput}>
+                {t('searchAgain', 'search again')}
+              </span>{' '}
+              <span>{t('usingADifferentTerm', 'using a different term')}</span>
+            </p>
+          </div>
+        </Tile>
+      )}
+      <hr className={classNames(styles.divider, isTablet ? styles.tabletDivider : styles.desktopDivider)} />
+    </>
+  );
+}
+
+interface TestTypeSearchResultItemProps {
+  testType: ImagingType;
+  openOrderForm: (searchResult: ImagingOrderBasketItem) => void;
+}
+
+const TestTypeSearchResultItem: React.FC<TestTypeSearchResultItemProps> = ({ testType, openOrderForm }) => {
+  const isTablet = useLayoutType() === 'tablet';
+  const session = useSession();
+  const { orders, setOrders } = useOrderBasket<ImagingOrderBasketItem>('imaging', prepImagingOrderPostData);
+  const testTypeAlreadyInBasket = useMemo(
+    () => orders?.some((order) => order.testType.conceptUuid === testType.conceptUuid),
+    [orders, testType],
+  );
+
+  const createLabOrder = useCallback(
+    (testType: ImagingType) => {
+      return createEmptyLabOrder(testType, session.currentProvider.uuid);
+    },
+    [session.currentProvider?.uuid],
+  );
+
+  const { t } = useTranslation();
+
+  const addToBasket = useCallback(() => {
+    const labOrder = createLabOrder(testType);
+    labOrder.isOrderIncomplete = true;
+    setOrders([...orders, labOrder]);
+    closeWorkspace('add-imaging-order', {
+      ignoreChanges: true,
+      onWorkspaceClose: () => launchPatientWorkspace('order-basket'),
+    });
+  }, [orders, setOrders, createLabOrder, testType]);
+
+  const removeFromBasket = useCallback(() => {
+    setOrders(orders.filter((order) => order.testType.conceptUuid !== testType.conceptUuid));
+  }, [orders, setOrders, testType.conceptUuid]);
+
+  return (
+    <Tile
+      className={classNames(styles.searchResultTile, {
+        [styles.tabletSearchResultTile]: isTablet,
+      })}
+      key={testType.conceptUuid}
+      role="listitem">
+      <div className={classNames(styles.searchResultTileContent, styles.text02)}>
+        <p>
+          <span className={styles.productiveHeading01}>{testType.label}</span>{' '}
+        </p>
+      </div>
+      <div className={styles.searchResultActions}>
+        {testTypeAlreadyInBasket ? (
+          <Button
+            kind="danger--ghost"
+            renderIcon={(props) => <ShoppingCartArrowUp size={16} {...props} />}
+            onClick={() => removeFromBasket()}>
+            {t('removeFromBasket', 'Remove from basket')}
+          </Button>
+        ) : (
+          <Button
+            kind="ghost"
+            renderIcon={(props) => <ShoppingCartArrowDown size={16} {...props} />}
+            onClick={() => addToBasket()}>
+            {t('directlyAddToBasket', 'Add to basket')}
+          </Button>
+        )}
+        <Button
+          kind="ghost"
+          renderIcon={(props) => <ArrowRight size={16} {...props} />}
+          onClick={() => openOrderForm(createLabOrder(testType))}>
+          {t('goToDrugOrderForm', 'Order form')}
+        </Button>
+      </div>
+    </Tile>
+  );
+};
+
+const TestTypeSearchSkeleton = () => {
+  const isTablet = useLayoutType() === 'tablet';
+  const tileClassName = `${isTablet ? `${styles.tabletSearchResultTile}` : `${styles.desktopSearchResultTile}`} ${
+    styles.skeletonTile
+  }`;
+  return (
+    <div className={styles.searchResultSkeletonWrapper}>
+      <div className={styles.orderBasketSearchResultsHeader}>
+        <SkeletonText className={styles.searchResultCntSkeleton} />
+        <ButtonSkeleton size={isTablet ? 'md' : 'sm'} />
+      </div>
+      <Tile className={tileClassName}>
+        <SkeletonText />
+      </Tile>
+      <Tile className={tileClassName}>
+        <SkeletonText />
+      </Tile>
+      <Tile className={tileClassName}>
+        <SkeletonText />
+      </Tile>
+      <Tile className={tileClassName}>
+        <SkeletonText />
+      </Tile>
+      <hr className={classNames(styles.divider, isTablet ? styles.tabletDivider : styles.desktopDivider)} />
+    </div>
+  );
+};

package/src/form/imaging-orders/add-imaging-orders/useImagingTypes.ts

@@ -0,0 +1,89 @@
+import { useEffect, useMemo } from 'react';
+import useSWRImmutable from 'swr/immutable';
+import fuzzy from 'fuzzy';
+import { type FetchResponse, openmrsFetch, useConfig, restBaseUrl, reportError } from '@openmrs/esm-framework';
+import { type Concept } from '../../../types';
+import { type ImagingConfig } from '../../../config-schema';
+
+type ConceptResult = FetchResponse<Concept>;
+type ConceptResults = FetchResponse<{ setMembers: Array<Concept> }>;
+
+export interface ImagingType {
+  label: string;
+  conceptUuid: string;
+}
+
+export interface UseImagingType {
+  testTypes: Array<ImagingType>;
+  isLoading: boolean;
+  error: Error;
+}
+
+function openmrsFetchMultiple(urls: Array<string>) {
+  // SWR has an RFC for `useSWRList`:
+  // https://github.com/vercel/swr/discussions/1988
+  // If that ever is implemented we should switch to using that.
+  return Promise.all(urls.map((url) => openmrsFetch<{ results: Array<Concept> }>(url)));
+}
+
+function useImagingConceptsSWR(labOrderableConcepts?: Array<string>) {
+  const config = useConfig<ImagingConfig>();
+  const { data, isLoading, error } = useSWRImmutable(
+    () =>
+      labOrderableConcepts
+        ? labOrderableConcepts.map((c) => `${restBaseUrl}/concept/${c}`)
+        : `${restBaseUrl}/concept/${config.radiologyConceptSetUuid}?v=custom:setMembers`,
+    (labOrderableConcepts ? openmrsFetchMultiple : openmrsFetch) as any,
+    {
+      shouldRetryOnError(err) {
+        return err instanceof Response;
+      },
+    },
+  );
+
+  const results = useMemo(() => {
+    if (isLoading || error) {
+      return null;
+    }
+    return labOrderableConcepts
+      ? (data as Array<ConceptResult>)?.flatMap((d) => d.data.setMembers)
+      : (data as ConceptResults)?.data.setMembers ?? ([] as Concept[]);
+  }, [data, isLoading, error, labOrderableConcepts]);
+
+  return {
+    data: results,
+    isLoading,
+    error,
+  };
+}
+
+export function useImagingTypes(searchTerm = ''): UseImagingType {
+  const { labOrderableConcepts } = useConfig<ImagingConfig>().orders;
+
+  const { data, isLoading, error } = useImagingConceptsSWR(labOrderableConcepts.length ? labOrderableConcepts : null);
+
+  useEffect(() => {
+    if (error) {
+      reportError(error);
+    }
+  }, [error]);
+
+  const testConcepts = useMemo(() => {
+    return data?.map((concept) => ({
+      label: concept.display,
+      conceptUuid: concept.uuid,
+    }));
+  }, [data]);
+
+  const filteredTestTypes = useMemo(() => {
+    return searchTerm && !isLoading && !error
+      ? fuzzy.filter(searchTerm, testConcepts, { extract: (c) => c.label }).map((result) => result.original)
+      : testConcepts;
+  }, [testConcepts, searchTerm, isLoading, error]);
+
+  return {
+    testTypes: filteredTestTypes,
+    isLoading: isLoading,
+    error: error,
+  };
+}