@opentrons/step-generation 0.3.23-alpha.0 → 0.3.25-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +1 -1
  2. package/lib/commandCreators/atomic/__tests__/airGapInPlace.test.d.ts +1 -0
  3. package/lib/commandCreators/atomic/airGapInPlace.d.ts +2 -3
  4. package/lib/commandCreators/atomic/captureImage.d.ts +2 -3
  5. package/lib/commandCreators/atomic/comment.d.ts +3 -2
  6. package/lib/commandCreators/atomic/delay.d.ts +6 -2
  7. package/lib/commandCreators/atomic/disengageMagnet.d.ts +2 -3
  8. package/lib/commandCreators/atomic/dropTipInPlace.d.ts +2 -3
  9. package/lib/commandCreators/atomic/engageMagnet.d.ts +2 -3
  10. package/lib/commandCreators/atomic/flexStackerEmpty.d.ts +6 -3
  11. package/lib/commandCreators/atomic/flexStackerRetrieve.d.ts +2 -3
  12. package/lib/commandCreators/atomic/flexStackerStore.d.ts +2 -3
  13. package/lib/commandCreators/atomic/home.d.ts +4 -2
  14. package/lib/commandCreators/atomic/moveToAddressableArea.d.ts +11 -2
  15. package/lib/commandCreators/atomic/moveToAddressableAreaForDropTip.d.ts +2 -3
  16. package/lib/commandCreators/atomic/thermocyclerCloseLid.d.ts +2 -3
  17. package/lib/commandCreators/atomic/thermocyclerDeactivateBlock.d.ts +2 -3
  18. package/lib/commandCreators/atomic/thermocyclerDeactivateLid.d.ts +2 -3
  19. package/lib/commandCreators/atomic/thermocyclerOpenLid.d.ts +2 -3
  20. package/lib/commandCreators/atomic/thermocyclerSetTargetBlockTemperature.d.ts +2 -3
  21. package/lib/commandCreators/atomic/thermocyclerSetTargetLidTemperature.d.ts +2 -3
  22. package/lib/commandCreators/atomic/thermocyclerStartRunExtendedProfile.d.ts +2 -3
  23. package/lib/commandCreators/atomic/vacuumStartRunProfile.d.ts +8 -2
  24. package/lib/getNextRobotStateAndWarnings/forConfigureNozzleLayout.d.ts +2 -11
  25. package/lib/getNextRobotStateAndWarnings/forDropTip.d.ts +2 -3
  26. package/lib/getNextRobotStateAndWarnings/forMoveLabware.d.ts +2 -3
  27. package/lib/getNextRobotStateAndWarnings/forMoveToAddressableArea.d.ts +4 -2
  28. package/lib/getNextRobotStateAndWarnings/forMoveToWell.d.ts +2 -3
  29. package/lib/getNextRobotStateAndWarnings/forPickUpTip.d.ts +2 -3
  30. package/lib/getNextRobotStateAndWarnings/inPlaceCommandUpdates.d.ts +3 -3
  31. package/lib/getNextRobotStateAndWarnings/magnetUpdates.d.ts +3 -4
  32. package/lib/getNextRobotStateAndWarnings/stackerUpdates.d.ts +22 -7
  33. package/lib/getNextRobotStateAndWarnings/temperatureUpdates.d.ts +4 -5
  34. package/lib/getNextRobotStateAndWarnings/thermocyclerUpdates.d.ts +32 -15
  35. package/lib/getNextRobotStateAndWarnings/vacuumUpdates.d.ts +13 -8
  36. package/lib/index.cjs +105 -105
  37. package/lib/index.mjs +8133 -7182
  38. package/lib/types.d.ts +99 -56
  39. package/package.json +2 -2
package/lib/types.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { ABSORBANCE_READER_TYPE, AddressableArea, CommonArgs, CreateCommand, FLEX_STACKER_MODULE_TYPE, FlexStackerStoredLabwareGroup, HEATERSHAKER_MODULE_TYPE, Height, LabwareDefinition2, LabwareLocation, LabwareMovementStrategy, LoadedLabwareLocation, MAGNETIC_BLOCK_TYPE, MAGNETIC_MODULE_TYPE, ModuleModel, ModuleType, PipetteMount as Mount, NozzleConfigurationStyle, OpentronsAIArgs, PipetteName, PipetteV2Specs, PositionReference, PrimaryNozzleConfigurationStyle, ShakeSpeedParams, StackerStoredLabwareDefinitionURIs, TCExtendedProfileParams, TEMPERATURE_MODULE_TYPE, THERMOCYCLER_MODULE_TYPE, VACUUM_MODULE_TYPE, VacuumRunProfileParams, Width } from '@opentrons/shared-data';
1
+ import type { ABSORBANCE_READER_TYPE, AddressableArea, CommonArgs, CreateCommand, FLEX_STACKER_MODULE_TYPE, FlexStackerStoredLabwareGroup, HEATERSHAKER_MODULE_TYPE, Height, LabwareDefinition2, LabwareLocation, LabwareMovementStrategy, LoadedLabwareLocation, MAGNETIC_BLOCK_TYPE, MAGNETIC_MODULE_TYPE, ModuleModel, ModuleType, PipetteMount as Mount, NozzleConfigurationStyle, OpentronsAIArgs, PipetteName, PipetteV2Specs, PositionReference, PrimaryNozzleConfigurationStyle, ShakeSpeedParams, StackerStoredLabwareDefinitionURIs, TCExtendedProfileParams, TEMPERATURE_MODULE_TYPE, THERMOCYCLER_MODULE_TYPE, VACUUM_MODULE_TYPE, VacuumRunProfileParams, Width, WithRuntimeParameterStrings } from '@opentrons/shared-data';
2
2
  import type { AUTOMATIC, CLEAN, DIRTY, EMPTY, MANUAL, TEMPERATURE_APPROACHING_TARGET, TEMPERATURE_AT_TARGET, TEMPERATURE_DEACTIVATED, VACUUM_MODE_POWER, VACUUM_MODE_PRESSURE, VACUUM_VENT_CLOSED, VACUUM_VENT_OPEN } from './constants';
3
3
  export type DeckSlot = string;
4
4
  type THERMOCYCLER_STATE = 'thermocyclerState';
@@ -443,7 +443,7 @@ export type MixArgs = CommonArgs & {
443
443
  tiprackSelected: string | null;
444
444
  primaryNozzle: PrimaryNozzleConfigurationStyle;
445
445
  };
446
- export type PauseArgs = CommonArgs & {
446
+ export type PauseArgs = WithRuntimeParameterStrings<CommonArgs & {
447
447
  commandCreatorFnName: 'delay';
448
448
  message?: string;
449
449
  seconds?: number;
@@ -453,41 +453,41 @@ export type PauseArgs = CommonArgs & {
453
453
  minutes?: number;
454
454
  seconds?: number;
455
455
  } | null | undefined;
456
- };
457
- export interface WaitForTemperatureArgs extends CommonArgs {
456
+ }>;
457
+ export type WaitForTemperatureArgs = WithRuntimeParameterStrings<CommonArgs & {
458
458
  moduleId: string;
459
459
  commandCreatorFnName: 'waitForTemperature';
460
460
  celsius: number;
461
461
  message?: string;
462
- }
462
+ }>;
463
463
  export interface WaitForModuleTaskArgs extends CommonArgs {
464
464
  commandCreatorFnName: 'waitForModuleTask';
465
465
  /** This step will wait for this to happen before moving on. */
466
466
  waitCondition: 'thermocyclerProfileComplete' | 'vacuumProfileComplete' | 'vacuumStateComplete';
467
467
  moduleId: string;
468
468
  }
469
- export type EngageMagnetArgs = CommonArgs & {
469
+ export type EngageMagnetArgs = WithRuntimeParameterStrings<CommonArgs & {
470
470
  height: number;
471
471
  moduleId: string;
472
472
  commandCreatorFnName: 'engageMagnet';
473
473
  message?: string;
474
- };
475
- export type DisengageMagnetArgs = CommonArgs & {
474
+ }>;
475
+ export type DisengageMagnetArgs = WithRuntimeParameterStrings<CommonArgs & {
476
476
  moduleId: string;
477
477
  commandCreatorFnName: 'disengageMagnet';
478
478
  message?: string;
479
- };
480
- export interface SetTemperatureArgs extends CommonArgs {
479
+ }>;
480
+ export type SetTemperatureArgs = WithRuntimeParameterStrings<CommonArgs & {
481
481
  moduleId: string;
482
482
  commandCreatorFnName: 'setTemperature';
483
483
  celsius: number;
484
484
  message?: string;
485
- }
486
- export interface DeactivateTemperatureArgs extends CommonArgs {
485
+ }>;
486
+ export type DeactivateTemperatureArgs = WithRuntimeParameterStrings<CommonArgs & {
487
487
  moduleId: string;
488
488
  commandCreatorFnName: 'deactivateTemperature';
489
489
  message?: string;
490
- }
490
+ }>;
491
491
  export type SetShakeSpeedArgs = ShakeSpeedParams & {
492
492
  moduleId: string;
493
493
  commandCreatorFnName: 'setShakeSpeed';
@@ -558,66 +558,66 @@ export interface ThermocyclerStateStepArgs extends CommonArgs {
558
558
  lidOpen: boolean;
559
559
  message?: string;
560
560
  }
561
- export interface AbsorbanceReaderInitializeArgs extends CommonArgs {
561
+ export type AbsorbanceReaderInitializeArgs = WithRuntimeParameterStrings<CommonArgs & {
562
562
  moduleId: string;
563
563
  commandCreatorFnName: 'absorbanceReaderInitialize';
564
564
  measureMode: 'single' | 'multi';
565
565
  sampleWavelengths: number[];
566
566
  referenceWavelength?: number | null;
567
567
  message?: string;
568
- }
569
- export interface AbsorbanceReaderReadArgs extends CommonArgs {
568
+ }>;
569
+ export type AbsorbanceReaderReadArgs = WithRuntimeParameterStrings<CommonArgs & {
570
570
  moduleId: string;
571
571
  commandCreatorFnName: 'absorbanceReaderRead';
572
572
  fileName: string | null;
573
573
  message?: string;
574
- }
575
- export interface AbsorbanceReaderLidArgs extends CommonArgs {
574
+ }>;
575
+ export type AbsorbanceReaderLidArgs = WithRuntimeParameterStrings<CommonArgs & {
576
576
  moduleId: string;
577
577
  commandCreatorFnName: 'absorbanceReaderOpenLid' | 'absorbanceReaderCloseLid';
578
578
  message?: string;
579
- }
579
+ }>;
580
580
  export type AbsorbanceReaderArgs = AbsorbanceReaderInitializeArgs | AbsorbanceReaderReadArgs | AbsorbanceReaderLidArgs;
581
- export interface MoveLabwareArgs extends CommonArgs {
581
+ export type MoveLabwareArgs = WithRuntimeParameterStrings<CommonArgs & {
582
582
  commandCreatorFnName: 'moveLabware';
583
583
  labwareId: string;
584
584
  newLocation: LabwareLocation;
585
585
  strategy: LabwareMovementStrategy;
586
- }
587
- export interface CommentArgs extends CommonArgs {
586
+ }>;
587
+ export type CommentArgs = WithRuntimeParameterStrings<CommonArgs & {
588
588
  commandCreatorFnName: 'comment';
589
589
  message: string;
590
- }
591
- export interface CaptureImageArgs extends CommonArgs {
590
+ }>;
591
+ export type CaptureImageArgs = WithRuntimeParameterStrings<CommonArgs & {
592
592
  commandCreatorFnName: 'captureImage';
593
- homeBefore: boolean;
593
+ homeBefore: boolean | string;
594
594
  fileName: string;
595
- resolution: [Width, Height];
596
- zoom: number;
597
- contrast: number;
598
- brightness: number;
599
- saturation: number;
600
- }
601
- export interface FlexStackerEmptyArgs extends CommonArgs {
595
+ resolution: [Width | string, Height | string];
596
+ zoom: number | string;
597
+ contrast: number | string;
598
+ brightness: number | string;
599
+ saturation: number | string;
600
+ }>;
601
+ export type FlexStackerEmptyArgs = WithRuntimeParameterStrings<CommonArgs & {
602
602
  moduleId: string;
603
603
  commandCreatorFnName: 'flexStackerEmpty';
604
604
  interventionMessage: string | null;
605
- }
606
- export interface FlexStackerFillItemsArgs extends CommonArgs {
605
+ }>;
606
+ export type FlexStackerFillItemsArgs = WithRuntimeParameterStrings<CommonArgs & {
607
607
  moduleId: string;
608
608
  commandCreatorFnName: 'flexStackerFillItems';
609
609
  fillLabwareUri: string | null;
610
610
  fillLabwareIds: string[];
611
611
  interventionMessage: string | null;
612
- }
613
- export interface FlexStackerStoreArgs extends CommonArgs {
612
+ }>;
613
+ export type FlexStackerStoreArgs = WithRuntimeParameterStrings<CommonArgs & {
614
614
  moduleId: string;
615
615
  commandCreatorFnName: 'flexStackerStore';
616
- }
617
- export interface FlexStackerRetrieveArgs extends CommonArgs {
616
+ }>;
617
+ export type FlexStackerRetrieveArgs = WithRuntimeParameterStrings<CommonArgs & {
618
618
  moduleId: string;
619
619
  commandCreatorFnName: 'flexStackerRetrieve';
620
- }
620
+ }>;
621
621
  export interface VacuumPumpAdvancedArgs {
622
622
  duration?: number;
623
623
  ventAfter?: boolean;
@@ -632,28 +632,28 @@ export interface VacuumPumpPowerArgs extends CommonArgs, VacuumPumpAdvancedArgs
632
632
  commandCreatorFnName: 'vacuumSetPumpPower';
633
633
  percentPower: number;
634
634
  }
635
- export interface VacuumCloseVentSetPumpPressureArgs extends CommonArgs, VacuumPumpAdvancedArgs {
635
+ export type VacuumCloseVentSetPumpPressureArgs = WithRuntimeParameterStrings<CommonArgs & VacuumPumpAdvancedArgs & {
636
636
  moduleId: string;
637
637
  commandCreatorFnName: 'vacuumCloseVentSetPumpPressure';
638
638
  gaugePressure: number;
639
- }
640
- export interface VacuumCloseVentSetPumpPowerArgs extends CommonArgs, VacuumPumpAdvancedArgs {
639
+ }>;
640
+ export type VacuumCloseVentSetPumpPowerArgs = WithRuntimeParameterStrings<CommonArgs & VacuumPumpAdvancedArgs & {
641
641
  moduleId: string;
642
642
  commandCreatorFnName: 'vacuumCloseVentSetPumpPower';
643
643
  percentPower: number;
644
- }
645
- export interface VacuumOpenVentArgs extends CommonArgs {
644
+ }>;
645
+ export type VacuumOpenVentArgs = WithRuntimeParameterStrings<CommonArgs & {
646
646
  moduleId: string;
647
647
  commandCreatorFnName: 'vacuumOpenVent';
648
- }
649
- export interface VacuumCloseVentArgs extends CommonArgs {
648
+ }>;
649
+ export type VacuumCloseVentArgs = WithRuntimeParameterStrings<CommonArgs & {
650
650
  moduleId: string;
651
651
  commandCreatorFnName: 'vacuumCloseVent';
652
- }
653
- export interface VacuumStopPumpArgs extends CommonArgs {
652
+ }>;
653
+ export type VacuumStopPumpArgs = WithRuntimeParameterStrings<CommonArgs & {
654
654
  moduleId: string;
655
655
  commandCreatorFnName: 'vacuumStopPump';
656
- }
656
+ }>;
657
657
  export interface VacuumPressureData {
658
658
  mode: typeof VACUUM_MODE_PRESSURE;
659
659
  pressureMbar: string | null;
@@ -680,12 +680,12 @@ export interface VacuumStartRunProfileArgs extends CommonArgs {
680
680
  profile: VacuumRunProfileParams['steps'];
681
681
  ventAfter: boolean;
682
682
  }
683
- export interface VacuumCloseVentStartProfileArgs extends CommonArgs {
683
+ export type VacuumCloseVentStartProfileArgs = WithRuntimeParameterStrings<CommonArgs & {
684
684
  moduleId: string;
685
685
  commandCreatorFnName: 'vacuumCloseVentStartProfile';
686
686
  profile: VacuumRunProfileParams['steps'];
687
687
  ventAfter: boolean;
688
- }
688
+ }>;
689
689
  export type VacuumArgs = VacuumPumpArgs | VacuumStartRunProfileArgs | VacuumOpenVentArgs | VacuumCloseVentArgs | VacuumStopPumpArgs;
690
690
  export type FlexStackerArgs = FlexStackerEmptyArgs | FlexStackerFillItemsArgs | FlexStackerRetrieveArgs | FlexStackerStoreArgs;
691
691
  export type CommandCreatorArgs = AbsorbanceReaderInitializeArgs | AbsorbanceReaderReadArgs | AbsorbanceReaderLidArgs | ConsolidateArgs | CaptureImageArgs | DistributeArgs | MixArgs | PauseArgs | WaitForModuleTaskArgs | TransferArgs | EngageMagnetArgs | DisengageMagnetArgs | SetTemperatureArgs | WaitForTemperatureArgs | DeactivateTemperatureArgs | ThermocyclerProfileStepArgs | ThermocyclerStateStepArgs | HeaterShakerArgs | MoveLabwareArgs | CommentArgs | FlexStackerArgs | VacuumArgs | OpentronsAIArgs;
@@ -849,6 +849,28 @@ export interface AbsorbanceReaderReadStepGenArgs {
849
849
  moduleId: string;
850
850
  fileName?: string | null;
851
851
  }
852
+ export interface ThermocyclerSetTargetBlockTemperatureStepGenArgs {
853
+ moduleId: string;
854
+ celsius: number | string;
855
+ }
856
+ export interface ThermocyclerSetTargetLidTemperatureStepGenArgs {
857
+ moduleId: string;
858
+ celsius: number | string;
859
+ }
860
+ export interface ThermocyclerProfileStepStepGenArgs {
861
+ celsius: number | string;
862
+ holdSeconds: number | string;
863
+ }
864
+ export interface ThermocyclerProfileCycleStepGenArgs {
865
+ steps: ThermocyclerProfileStepStepGenArgs[];
866
+ repetitions: number | string;
867
+ }
868
+ export interface ThermocyclerStartRunExtendedProfileStepGenArgs {
869
+ moduleId: string;
870
+ profileElements: Array<ThermocyclerProfileCycleStepGenArgs | ThermocyclerProfileStepStepGenArgs>;
871
+ blockMaxVolumeUl?: number | string;
872
+ taskId?: string | null;
873
+ }
852
874
  export interface ConfigureForVolumeStepGenArgs {
853
875
  pipetteId: string;
854
876
  volume: number | string;
@@ -882,6 +904,9 @@ export interface WaitForTemperatureStepGenArgs {
882
904
  moduleId: string;
883
905
  celsius: number | string;
884
906
  }
907
+ export interface EngageMagnetStepGenArgs extends ModuleStepGenArgs {
908
+ height: number | string;
909
+ }
885
910
  export interface HeaterShakerSetTargetShakeSpeedStepGenArgs {
886
911
  moduleId: string;
887
912
  rpm: number | string;
@@ -916,15 +941,15 @@ export interface PickUpTipStepGenArgs {
916
941
  pipetteId: string;
917
942
  labwareId: string;
918
943
  wellName: string;
919
- primaryNozzle: PrimaryNozzleConfigurationStyle;
920
- nozzles: NozzleConfigurationStyle;
921
- tipTrackingOption?: TipTrackingOption;
944
+ primaryNozzle: string;
945
+ nozzles: string;
946
+ tipTrackingOption?: string;
922
947
  }
923
948
  export interface DropTipStepGenArgs {
924
949
  pipette: string;
925
950
  wellName?: string;
926
951
  dropTipLocation?: string;
927
- isReturnTip?: boolean;
952
+ isReturnTip?: boolean | string;
928
953
  }
929
954
  export interface DispenseWhileTrackingStepGenArgs {
930
955
  pipetteId: string;
@@ -942,7 +967,7 @@ export interface DispenseInPlaceStepGenArgs {
942
967
  flowRate: number | string;
943
968
  pushOut?: number | string;
944
969
  correctionVolume?: number | string;
945
- isAirGap?: boolean;
970
+ isAirGap?: boolean | string;
946
971
  }
947
972
  export interface BlowOutInWellStepGenArgs {
948
973
  pipetteId: string;
@@ -955,6 +980,10 @@ export interface BlowOutInPlaceStepGenArgs {
955
980
  pipetteId: string;
956
981
  flowRate: number | string;
957
982
  }
983
+ export interface DropTipInPlaceStepGenArgs {
984
+ pipetteId: string;
985
+ homeAfter?: boolean | string;
986
+ }
958
987
  export interface AspirateWhileTrackingStepGenArgs {
959
988
  pipetteId: string;
960
989
  volume: number | string;
@@ -988,6 +1017,20 @@ export interface MoveToCoordinatesStepGenArgs {
988
1017
  minimumZHeight?: number | string;
989
1018
  forceDirect?: boolean | string;
990
1019
  }
1020
+ export interface MoveToAddressableAreaForDropTipStepGenArgs {
1021
+ pipetteId: string;
1022
+ addressableAreaName: string;
1023
+ offset?: {
1024
+ x: number | string;
1025
+ y: number | string;
1026
+ z: number | string;
1027
+ };
1028
+ alternateDropLocation?: boolean | string;
1029
+ speed?: number | string;
1030
+ minimumZHeight?: number | string;
1031
+ forceDirect?: boolean | string;
1032
+ ignoreTipConfiguration?: boolean | string;
1033
+ }
991
1034
  export interface MoveToWellStepGenArgs {
992
1035
  pipetteId: string;
993
1036
  labwareId: string;
package/package.json CHANGED
@@ -9,7 +9,7 @@
9
9
  },
10
10
  "name": "@opentrons/step-generation",
11
11
  "productName": "Opentrons Step Generation",
12
- "version": "0.3.23-alpha.0",
12
+ "version": "0.3.25-alpha.0",
13
13
  "description": "Step generation",
14
14
  "main": "lib/index.cjs",
15
15
  "types": "lib/index.d.ts",
@@ -37,7 +37,7 @@
37
37
  "immer": "^10.1.3",
38
38
  "lodash": "4.18.1",
39
39
  "uuid": "14.0.0",
40
- "@opentrons/shared-data": "0.3.23-alpha.0"
40
+ "@opentrons/shared-data": "0.3.25-alpha.0"
41
41
  },
42
42
  "devDependencies": {
43
43
  "@types/lodash": "4.17.24"