All files / metadata/src/displayset splitImageIdsBySplitRules.ts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
import { groupInstancesBySplitRules } from './groupInstancesBySplitRules';
import { resolveInstances } from './resolveInstances';
import type {
  InstanceGroup,
  NaturalizedInstance,
  SplitContext,
  SplitRule,
} from './types';
 
export type SplitImageIdsBySplitRulesOptions = SplitContext & {
  splitRules: SplitRule[];
  onMissingImageId?: (imageId: string) => void;
  /**
   * Called for each resolved instance that matches no split rule (and so
   * produces no display set), e.g. a non-image SOP. Surfaces silent drops.
   */
  onUnmatchedInstance?: (instance: NaturalizedInstance) => void;
};
 
/**
 * Primary entrypoint: splits a series represented by metadata imageIds into instance groups.
 */
export function splitImageIdsBySplitRules(
  imageIds: string[],
  options: SplitImageIdsBySplitRulesOptions
): InstanceGroup[] {
  const {
    getNaturalizedInstance,
    splitRules,
    onMissingImageId,
    onUnmatchedInstance,
  } = options;
 
  const instances = resolveInstances(imageIds, getNaturalizedInstance, {
    onMissing: onMissingImageId,
  });
 
  if (!instances.length) {
    return [];
  }
 
  return groupInstancesBySplitRules(instances, splitRules, onUnmatchedInstance);
}