@opentrons/components 0.1.7-alpha.0 → 0.2.0-alpha.0

package/lib/hardware-sim/Deck/RobotWorkSpace.d.ts

@@ -1,21 +1,37 @@
-import type { ReactNode } from 'react';
-import type { StyleProps } from '../../primitives';
-import type { DeckDefinition, DeckSlot } from '@opentrons/shared-data';
+import type { CSSProperties, ReactNode } from 'react';
+import type { AddressableArea, DeckDefinition } from '@opentrons/shared-data';
 export interface RobotWorkSpaceRenderProps {
-    deckSlotsById: {
-        [slotId: string]: DeckSlot;
-    };
-    getRobotCoordsFromDOMCoords: (domX: number, domY: number) => {
-        x: number;
-        y: number;
+    addressableAreasById: {
+        [addressableAreaId: string]: AddressableArea;
     };
 }
-export interface RobotWorkSpaceProps extends StyleProps {
-    deckDef?: DeckDefinition;
-    viewBox?: string | null;
+type BaseProps = {
     children?: (props: RobotWorkSpaceRenderProps) => ReactNode;
     deckLayerBlocklist?: string[];
+    /** optional boolean to show the OT-2 deck from deck defintion layers */
     showDeckLayers?: boolean;
     id?: string;
-}
-export declare function RobotWorkSpace(props: RobotWorkSpaceProps): JSX.Element | null;
+} & (// Require at least one of deckDef or viewBox,
+{
+    deckDef: DeckDefinition;
+} | {
+    /**
+     * The x/y area to show, in standard SVG `x y xDimension yDimension` syntax.
+     *
+     * Specify coordinates in the Opentrons orientation, not the standard SVG orientation.
+     * So (x, y) is the area's front-left, xDimension extends the viewed area to the
+     * right, and yDimension extends the viewed area to the back.
+     */
+    viewBox: string;
+});
+export type RobotWorkSpaceProps = BaseProps & CSSProperties;
+/**
+ * A wrapper for rendering the robot deck, labware, etc. from a top-down perspective.
+ *
+ * Child SVG components can render themselves in the Opentrons coordinate orientation
+ * (+x to the right of the robot, +y to the back of the robot) and this component will
+ * SVG-transform them so they're displayed the correct way. This is needed because
+ * SVG inverts y compared to Opentrons coordinates.
+ */
+export declare function RobotWorkSpace(props: RobotWorkSpaceProps): JSX.Element;
+export {};

package/lib/hardware-sim/Deck/__tests__/resolveLabwareLocation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/hardware-sim/Deck/resolveLabwareLocation.d.ts

@@ -0,0 +1,20 @@
+import type { ComputeLabwareOriginInput, DeckDefinition, LabwareDefinition, LabwareLocation, LoadedLabware, LoadedModule } from '@opentrons/shared-data';
+/**
+ * Converts a labware location to something that computeLabwareOrigin() can take as
+ * input and compute absolute deck coordinates from.
+ *
+ * This basically just does a lot of tedious lookups to resolve IDs into full definitions.
+ *
+ * Returns "error" if there was a problem doing the conversion, probably because of
+ * some invalid input to this function, like entries missing from `otherLoadedLabware`.
+ * Returns "offDeck" if the labware is known to be off-deck, so it doesn't have
+ * coordinates.
+ */
+export declare function resolveLabwareLocation({ deckDef, targetLabwareDef, targetLabwareLocation, loadedModules, otherLoadedLabware, otherLabwareDefinitions, }: {
+    deckDef: DeckDefinition;
+    targetLabwareDef: LabwareDefinition;
+    targetLabwareLocation: LabwareLocation;
+    loadedModules: LoadedModule[];
+    otherLoadedLabware: LoadedLabware[];
+    otherLabwareDefinitions: LabwareDefinition[];
+}): 'error' | 'offDeck' | ComputeLabwareOriginInput;

package/lib/hardware-sim/DeckConfigurator/AbsorbanceReaderItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface AbsorbanceReaderItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    selected?: boolean;
+}
+export declare function AbsorbanceReaderItem(props: AbsorbanceReaderItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/EmptyConfigItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutId, DeckDefinition, ModuleModel } from '@opentrons/shared-data';
+interface EmptyConfigItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    editableCutoutIds: CutoutId[];
+    moduleModel?: ModuleModel;
+    handleClickAdd: (fixtureLocation: CutoutId, addressableArea: AddressableAreaNamesWithFakes) => void;
+}
+export declare function EmptyConfigItem(props: EmptyConfigItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/FlexStackerItem.d.ts

@@ -0,0 +1,12 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface FlexStackerItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    hasWasteChute: boolean;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    selected?: boolean;
+}
+export declare function FlexStackerItem(props: FlexStackerItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/HeaterShakerItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface HeaterShakerItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    selected?: boolean;
+}
+export declare function HeaterShakerItem(props: HeaterShakerItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/MagneticBlockItem.d.ts

@@ -0,0 +1,12 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface MagneticBlockItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    hasStagingArea?: boolean;
+    selected?: boolean;
+}
+export declare function MagneticBlockItem(props: MagneticBlockItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/StagingAreaConfigItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface StagingAreaConfigItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    selected?: boolean;
+}
+export declare function StagingAreaConfigItem(props: StagingAreaConfigItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/{StaticFixture.d.ts → StaticItem.d.ts}

@@ -8,5 +8,5 @@ interface StaticFixtureProps {
  * this component allows us to add static labeled fixtures to the center column of a deck
  * config map
  */
-export declare function StaticFixture(props: StaticFixtureProps): JSX.Element;
+export declare function StaticItem(props: StaticFixtureProps): JSX.Element;
 export {};

package/lib/hardware-sim/DeckConfigurator/TemperatureModuleItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface TemperatureModuleFixtureProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    selected?: boolean;
+}
+export declare function TemperatureModuleItem(props: TemperatureModuleFixtureProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/ThermocyclerItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface ThermocyclerItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    selected?: boolean;
+}
+export declare function ThermocyclerItem(props: ThermocyclerItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/TrashBinConfigItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface TrashBinConfigItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    addressableAreaId: AddressableAreaNamesWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    selected?: boolean;
+}
+export declare function TrashBinConfigItem(props: TrashBinConfigItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/WasteChuteConfigItem.d.ts

@@ -0,0 +1,11 @@
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckDefinition } from '@opentrons/shared-data';
+interface WasteChuteConfigItemProps {
+    deckDefinition: DeckDefinition;
+    fixtureLocation: CutoutId;
+    cutoutFixtureId: CutoutFixtureIdsWithFakes;
+    handleClickRemove?: (fixtureLocation: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    hasStagingAreas?: boolean;
+    selected?: boolean;
+}
+export declare function WasteChuteConfigFixture(props: WasteChuteConfigItemProps): JSX.Element;
+export {};

package/lib/hardware-sim/DeckConfigurator/constants.d.ts

@@ -5,16 +5,13 @@
 export declare const FIXTURE_HEIGHT = 102;
 export declare const THERMOCYCLER_FIXTURE_HEIGHT = 290;
 export declare const COLUMN_1_SINGLE_SLOT_FIXTURE_WIDTH = 243.5;
-export declare const COLUMN_2_SINGLE_SLOT_FIXTURE_WIDTH = 159;
-export declare const COLUMN_3_SINGLE_SLOT_FIXTURE_WIDTH = 243.5;
-export declare const STAGING_AREA_FIXTURE_WIDTH = 314.5;
+export declare const COLUMN_DEFAULT_SINGLE_SLOT_FIXTURE_WIDTH = 159;
+export declare const LARGE_SINGLE_ITEM_SLOT_WIDTH = 250;
+export declare const THERMOCYCLER_FIXTURE_WIDTH = 243.5;
 export declare const COLUMN_1_X_ADJUSTMENT = -100;
-export declare const COLUMN_2_X_ADJUSTMENT = -15.5;
-export declare const COLUMN_3_X_ADJUSTMENT = -15.5;
+export declare const COLUMN_DEFAULT_X_ADJUSTMENT = -15.5;
+export declare const STACKER_X_ADJUSTMENT = -12.5;
 export declare const Y_ADJUSTMENT = -8;
-export declare const STAGING_AREA_DISPLAY_NAME = "Staging area";
-export declare const TRASH_BIN_DISPLAY_NAME = "Trash bin";
-export declare const WASTE_CHUTE_DISPLAY_NAME = "Waste chute";
 export declare const CONFIG_STYLE_READ_ONLY: import("styled-components").FlattenSimpleInterpolation;
 export declare const CONFIG_STYLE_EDITABLE: import("styled-components").FlattenSimpleInterpolation;
 export declare const CONFIG_STYLE_SELECTED: import("styled-components").FlattenSimpleInterpolation;

package/lib/hardware-sim/DeckConfigurator/index.d.ts

@@ -1,10 +1,10 @@
 import type { ReactNode } from 'react';
-import type { CutoutFixtureId, CutoutId, DeckConfiguration } from '@opentrons/shared-data';
+import type { AddressableAreaNamesWithFakes, CutoutFixtureIdsWithFakes, CutoutId, DeckConfiguration, ModuleModel } from '@opentrons/shared-data';
 export * from './constants';
 interface DeckConfiguratorProps {
     deckConfig: DeckConfiguration;
-    handleClickAdd: (cutoutId: CutoutId) => void;
-    handleClickRemove: (cutoutId: CutoutId, cutoutFixtureId: CutoutFixtureId) => void;
+    handleClickAdd: (cutoutId: CutoutId, addressableAreaId: AddressableAreaNamesWithFakes) => void;
+    handleClickRemove: (cutoutId: CutoutId, cutoutFixtureId: CutoutFixtureIdsWithFakes, addressableAreaId: AddressableAreaNamesWithFakes) => void;
     lightFill?: string;
     darkFill?: string;
     editableCutoutIds?: CutoutId[];
@@ -16,5 +16,6 @@ interface DeckConfiguratorProps {
     }>;
     height?: string;
     selectedCutoutId?: CutoutId;
+    moduleModel?: ModuleModel;
 }
 export declare function DeckConfigurator(props: DeckConfiguratorProps): JSX.Element;

package/lib/hardware-sim/Labware/CalibrationBlockRender.d.ts

@@ -0,0 +1,15 @@
+import type { LabwareDefinition } from '@opentrons/shared-data';
+interface CalibrationBlockRenderProps {
+    /**
+     * Must be a calibration block definition, e.g.
+     * opentrons_calibrationblock_short_side_left or ..._short_side_right.
+     */
+    labwareDef: LabwareDefinition;
+}
+/**
+ * Render a top-down view of an OT-2 calibration block. This displays features specific
+ * to calibration blocks, which the more general <Labware> component doesn't know
+ * about.
+ */
+export declare function CalibrationBlockRender(props: CalibrationBlockRenderProps): JSX.Element | null;
+export {};

package/lib/hardware-sim/Labware/Labware.d.ts

@@ -1,10 +1,11 @@
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
-import type { HighlightedWellLabels, WellMouseEvent, WellFill, WellStroke } from './labwareInternals/types';
 import type { RefObject } from 'react';
+import type { LabwareDefinition } from '@opentrons/shared-data';
+import type { HighlightedWellLabels, WellFill, WellMouseEvent, WellStroke } from './labwareInternals/types';
 export interface LabwareProps {
     /** Labware definition to render */
-    definition: LabwareDefinition2;
-    /** Opional Prop for labware on heater shakers sitting on right side of the deck */
+    definition: LabwareDefinition;
+    positioningMode: 'passThrough' | 'offsetInSlot';
+    /** See docs on LabwareRender. */
     shouldRotateAdapterOrientation?: boolean;
     /** boolean to show well labels */
     showLabels?: boolean;
@@ -30,10 +31,8 @@ export interface LabwareProps {
     isInteractive?: boolean;
 }
 /**
- * a refactor of the legacy LabwareRender component intended to provide predictable styling
- * initial use in ODD well selection component with ODD-specific well label styling
- * consider adding additional styled wells props if used elsewhere
- * @param props
- * @returns
+ * Similar to the LabwareRender component, but with ODD-specific styling.
+ *
+ * For example, hiding the outline of the labware for certain ODD flows.
  */
 export declare const Labware: (props: LabwareProps) => JSX.Element;

package/lib/hardware-sim/Labware/LabwareAdapter/index.d.ts

@@ -1,11 +1,11 @@
 import { Opentrons96DeepWellAdapter } from './Opentrons96DeepWellAdapter';
 import { Opentrons96FlatBottomAdapter } from './Opentrons96FlatBottomAdapter';
-import { OpentronsUniversalFlatAdapter } from './OpentronsUniversalFlatAdapter';
 import { OpentronsAluminumFlatBottomPlate } from './OpentronsAluminumFlatBottomPlate';
+import { OpentronsAutoclavableDeckRiser } from './OpentronsAutoclavableDeckRiser';
 import { OpentronsFlex96TiprackAdapter } from './OpentronsFlex96TiprackAdapter';
 import { OpentronsToughPCRAutoSealingLid } from './OpentronsToughPCRAutoSealingLid';
-import { OpentronsAutoclavableDeckRiser } from './OpentronsAutoclavableDeckRiser';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
+import { OpentronsUniversalFlatAdapter } from './OpentronsUniversalFlatAdapter';
+import type { LabwareDefinition } from '@opentrons/shared-data';
 declare const LABWARE_ADAPTER_LOADNAME_PATHS: {
     opentrons_96_deep_well_adapter: typeof Opentrons96DeepWellAdapter;
     opentrons_96_flat_bottom_adapter: typeof Opentrons96FlatBottomAdapter;
@@ -19,7 +19,7 @@ export type LabwareAdapterLoadName = keyof typeof LABWARE_ADAPTER_LOADNAME_PATHS
 export declare const labwareAdapterLoadNames: string[];
 export interface LabwareAdapterProps {
     labwareLoadName: LabwareAdapterLoadName;
-    definition?: LabwareDefinition2;
+    definition?: LabwareDefinition;
     highlight?: boolean;
     highlightShadow?: boolean;
 }

package/lib/hardware-sim/Labware/LabwareRender.d.ts

@@ -1,7 +1,6 @@
-import type { CSSProperties } from 'styled-components';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
-import type { HighlightedWellLabels, WellMouseEvent, WellFill, WellStroke, WellGroup } from './labwareInternals/types';
-import type { RefObject } from 'react';
+import type { CSSProperties, RefObject } from 'react';
+import type { LabwareDefinition } from '@opentrons/shared-data';
+import type { HighlightedWellLabels, WellFill, WellGroup, WellMouseEvent, WellStroke } from './labwareInternals/types';
 export declare const WELL_LABEL_OPTIONS: {
     readonly SHOW_LABEL_INSIDE: "SHOW_LABEL_INSIDE";
     readonly SHOW_LABEL_OUTSIDE: "SHOW_LABEL_OUTSIDE";
@@ -9,8 +8,50 @@ export declare const WELL_LABEL_OPTIONS: {
 export type WellLabelOption = keyof typeof WELL_LABEL_OPTIONS;
 export interface LabwareRenderProps {
     /** Labware definition to render */
-    definition: LabwareDefinition2;
-    /** Opional Prop for labware on heater shakers sitting on right side of the deck */
+    definition: LabwareDefinition;
+    /**
+     * How the rendered labware should be positioned. Use `passThrough` for new code.
+     *
+     * `passThrough` -
+     *   The origin of the labware will be at the SVG origin. Beware that what
+     *   "the origin of the labware" corresponds to, physically, is not consistent across
+     *   labware. e.g. do not assume that it's always the labware's front-left corner.
+     *
+     *   To render a labware on its own, use the `getLabwareViewBox()` util from
+     *   shared-data to compute the SVG's viewBox around that origin.
+     *
+     *   To render a labware aligned to something like a deck slot or module, wrap this
+     *   component in an SVG transform. Use a util like shared-data's
+     *   `getDeckSlotOriginToLabwareOrigin()` to compute it.
+     *
+     * `offsetInSlot` -
+     *   The SVG origin will be treated as the origin of the slot enclosing the labware.
+     *   The labware will be offset from that origin according to the labware def's
+     *   cornerOffsetFromSlot.
+     *
+     *   To render a labware on its own, set the SVG viewBox's origin to
+     *   definition.cornerOffsetFromSlot.
+     *
+     *   To render a labware aligned to something like a deck slot or module, wrap this
+     *   component in an SVG transform that places the origin of this component at the
+     *   origin of the slot.
+     *
+     *   This is deprecated because it relies on labware schema 2's slot-centric ideas of
+     *   how labware are positioned. It's also clunky when rendering a labware on its
+     *   own.
+     */
+    positioningMode: 'passThrough' | 'offsetInSlot';
+    /**
+     * Special handling for opentrons_universal_flat_adapter. Unlike other labware,
+     * it rotates to match the underlying module, and that rotation actually matters
+     * because it's asymmetrical.
+     *
+     * This should be true if this is that adapter and we're on the left side of the deck,
+     * and false otherwise.
+     *
+     * Ignored if positioningMode is passThrough, in which case it's the caller's
+     * responsibility to do this rotation.
+     */
     shouldRotateAdapterOrientation?: boolean;
     /** option to show well labels inside or outside of labware outline */
     wellLabelOption?: WellLabelOption;

package/lib/hardware-sim/Labware/index.d.ts

@@ -1,5 +1,5 @@
 export * from './labwareInternals/index';
+export * from './CalibrationBlockRender';
 export * from './LabwareRender';
-export * from './LabwareStackRender';
 export * from './Labware';
 export * from './labwareInternals/types';

package/lib/hardware-sim/Labware/labwareInternals/FilledWells.d.ts

@@ -1,8 +1,7 @@
-import type { MemoExoticComponent } from 'react';
-import type { CSSProperties } from 'styled-components';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
+import type { CSSProperties, MemoExoticComponent } from 'react';
+import type { LabwareDefinition } from '@opentrons/shared-data';
 export interface FilledWellsProps {
-    definition: LabwareDefinition2;
+    definition: LabwareDefinition;
     fillByWell: Record<string, CSSProperties['fill']>;
     strokeColor?: string;
 }

package/lib/hardware-sim/Labware/labwareInternals/LabwareOutline.d.ts

@@ -1,12 +1,6 @@
-import type { CSSProperties } from 'styled-components';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
-export interface LabwareOutlineProps {
-    /** Labware definition to outline */
-    definition?: LabwareDefinition2;
-    /** x dimension in mm of this labware, used if definition doesn't supply dimensions, defaults to 127.76 */
-    width?: number;
-    /** y dimension in mm of this labware, used if definition doesn't supply dimensions, defaults to 85.48 */
-    height?: number;
+import type { CSSProperties } from 'react';
+import type { LabwareDefinition } from '@opentrons/shared-data';
+export type LabwareOutlineProps = {
     /** if this labware is a tip rack, darken background and lighten borderx dimension in mm of this labware, used if definition doesn't supply dimensions, defaults to false */
     isTiprack?: boolean;
     /** adds thicker blue border with blur to labware, defaults to false */
@@ -17,5 +11,22 @@ export interface LabwareOutlineProps {
     stroke?: CSSProperties['stroke'];
     fill?: CSSProperties['fill'];
     showRadius?: boolean;
+} & (DefinitionProps | DefinitionReplacementProps);
+interface DefinitionProps {
+    /** Labware definition to outline */
+    definition: LabwareDefinition;
+}
+/** Used for rendering an outline without needing a full labware definition. */
+interface DefinitionReplacementProps {
+    definition?: undefined;
+    /** x dimension in mm of the outline. */
+    width: number;
+    /** y dimension in mm of the outline. */
+    height: number;
+    /** minimum x-coordinate (i.e. the left side) of the outline. */
+    minX: number;
+    /** minimum y-coordinate (i.e. the bottom) of the outline. */
+    minY: number;
 }
 export declare function LabwareOutline(props: LabwareOutlineProps): JSX.Element;
+export {};

package/lib/hardware-sim/Labware/labwareInternals/LabwareWellLabels.d.ts

@@ -1,8 +1,8 @@
 import type { MemoExoticComponent } from 'react';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
+import type { LabwareDefinition } from '@opentrons/shared-data';
 import type { HighlightedWellLabels } from './types';
 interface LabwareWellLabelsProps {
-    definition: LabwareDefinition2;
+    definition: LabwareDefinition;
     highlightedWellLabels?: HighlightedWellLabels;
     wellLabelColor?: string;
 }

package/lib/hardware-sim/Labware/labwareInternals/StaticLabware.d.ts

@@ -1,10 +1,10 @@
+import type { CSSProperties } from 'styled-components';
 import type { MemoExoticComponent } from 'react';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
+import type { LabwareDefinition } from '@opentrons/shared-data';
 import type { WellMouseEvent, WellStroke } from './types';
-import type { CSSProperties } from 'styled-components';
 export interface StaticLabwareProps {
     /** Labware definition to render */
-    definition: LabwareDefinition2;
+    definition: LabwareDefinition;
     /** Add thicker blurred blue border to labware, defaults to false */
     highlight?: boolean;
     /** adds a drop shadow to the highlight border */

package/lib/hardware-sim/Labware/labwareInternals/StrokedWells.d.ts

@@ -1,8 +1,8 @@
-import type { MemoExoticComponent } from 'react';
 import type { CSSProperties } from 'styled-components';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
+import type { MemoExoticComponent } from 'react';
+import type { LabwareDefinition } from '@opentrons/shared-data';
 export interface StrokedWellProps {
-    definition: LabwareDefinition2;
+    definition: LabwareDefinition;
     strokeByWell: Record<string, CSSProperties['stroke']>;
 }
 export declare function StrokedWellsComponent(props: StrokedWellProps): JSX.Element;

package/lib/hardware-sim/Labware/labwareInternals/StyledWells.d.ts

@@ -1,10 +1,10 @@
 import type { CSSProperties, MemoExoticComponent } from 'react';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
+import type { LabwareDefinition } from '@opentrons/shared-data';
 import type { WellGroup } from './types';
 type WellContents = 'tipPresent' | 'tipMissing' | 'defaultWell' | 'disabledWell' | 'highlightedWell' | 'selectedWell';
 export interface StyledWellProps {
     wellContents: WellContents;
-    definition: LabwareDefinition2;
+    definition: LabwareDefinition;
     wells: WellGroup;
 }
 export declare const STYLE_BY_WELL_CONTENTS: {

package/lib/hardware-sim/Labware/labwareInternals/Well.d.ts

@@ -1,8 +1,7 @@
 import type { CSSProperties, MemoExoticComponent } from 'react';
 import type { LabwareWell } from '@opentrons/shared-data';
 import type { WellMouseEvent } from './types';
-import type { StyleProps } from '../../../primitives';
-export interface WellProps extends StyleProps {
+export interface WellProps extends CSSProperties {
     /** Well Name (eg 'A1') */
     wellName: string;
     /** well object from labware definition */

package/lib/hardware-sim/Labware/labwareInternals/WellLabels.d.ts

@@ -1,9 +1,9 @@
 import type { MemoExoticComponent } from 'react';
-import type { LabwareDefinition2 } from '@opentrons/shared-data';
+import type { LabwareDefinition } from '@opentrons/shared-data';
 import type { WellLabelOption } from '../LabwareRender';
 import type { HighlightedWellLabels } from './types';
 export interface WellLabelsProps {
-    definition: LabwareDefinition2;
+    definition: LabwareDefinition;
     wellLabelOption: WellLabelOption;
     highlightedWellLabels?: HighlightedWellLabels;
     wellLabelColor?: string;

package/lib/hardware-sim/Labware/labwareInternals/getTiprackBackgroundColor.d.ts

@@ -0,0 +1 @@
+export declare const getTiprackBackgroundColor: (loadName: string) => string;

package/lib/hardware-sim/Module/FlexStacker.d.ts

@@ -0,0 +1 @@
+export declare function FlexStacker(): JSX.Element;

package/lib/hardware-sim/Module/index.d.ts

@@ -1,6 +1,6 @@
-import { Thermocycler } from './Thermocycler';
 import { HeaterShaker } from './HeaterShaker';
 import { Temperature } from './Temperature';
+import { Thermocycler } from './Thermocycler';
 import type { ComponentProps, ReactNode } from 'react';
 import type { ModuleDefinition } from '@opentrons/shared-data';
 export * from './Thermocycler';
@@ -12,7 +12,29 @@ interface Props {
     innerProps?: ComponentProps<typeof Thermocycler> | ComponentProps<typeof HeaterShaker> | ComponentProps<typeof Temperature> | {};
     statusInfo?: ReactNode;
     children?: ReactNode;
-    targetSlotId?: string;
-    targetDeckId?: string;
+    /**
+     * How child components should be positioned.
+     *
+     * "offsetToSlot" - The SVG origin of a child will be at the labware mating interface of the
+     *   module, which is the front-left (-x, -y) corner of the slot on top of the module.
+     *
+     * todo(mm, 2025-07-21):
+     * 1. Add a "passThrough" mode that disables the "offsetToSlot" behavior,
+     *    to allow child components to replace it with their own SVG transform,
+     *    to support labware schema 3.
+     * 2. Migrate all existing call sites to use "passThrough".
+     * 3. Remove "offsetToSlot".
+     */
+    childrenPositioningMode: 'offsetToSlot';
+    /**
+     * Used for applying slot-specific positioning adjustments.
+     * If you're rendering the module on a deck, supply this for correct positioning.
+     */
+    targetSlotId: string | null;
+    /**
+     * Used for applying slot-specific positioning adjustments.
+     * If you're rendering the module on a deck, supply this for correct positioning.
+     */
+    targetDeckId: string | null;
 }
 export declare const Module: (props: Props) => JSX.Element;

package/lib/hardware-sim/Pipette/PipetteRender.d.ts

@@ -1,6 +1,6 @@
-import type { LabwareDefinition2, PipetteName } from '@opentrons/shared-data';
+import type { LabwareDefinition, PipetteName } from '@opentrons/shared-data';
 interface PipetteRenderProps {
-    labwareDef: LabwareDefinition2;
+    labwareDef: LabwareDefinition;
     pipetteName: PipetteName;
     usingMetalProbe?: boolean;
 }

package/lib/hardware-sim/RobotCoordinateSpace/RobotCoordinateSpace.d.ts

@@ -1,7 +1,9 @@
-import { Svg } from '../../primitives';
-import type { ComponentProps } from 'react';
-interface RobotCoordinateSpaceProps extends ComponentProps<typeof Svg> {
+import type { ReactNode } from 'react';
+interface RobotCoordinateSpaceProps {
     animated?: boolean;
+    children?: ReactNode;
+    height?: string;
+    viewBox?: string;
 }
 export declare function RobotCoordinateSpace(props: RobotCoordinateSpaceProps): JSX.Element;
 export {};

package/lib/hardware-sim/index.d.ts

@@ -1,7 +1,5 @@
 export * from './BaseDeck';
 export * from './BaseDeck/__fixtures__';
-export * from './ProtocolDeck';
-export * from './ProtocolDeck/utils';
 export * from './Deck';
 export * from './DeckConfigurator';
 export * from './DeckSlotLocation';

package/lib/helix-design-system/colors.d.ts

@@ -74,12 +74,13 @@ export declare const transparentBlack80 = "#16212D80";
 /**
  * flex
  */
+export declare const flex40 = "#aae3fc";
 export declare const flex55 = "#0297CC";
 export declare const flex50 = "#00BDFF";
 /**
  * extras
  */
-export declare const transparent = "transparent";
+export declare const transparent = "#00000000";
 export declare const opacity20HexCode = "33";
 export declare const opacity40HexCode = "66";
 export declare const opacity60HexCode = "99";