feat(step-generation): introduce flex stacker fill atomic command creator (#20235)

This PR creates atomic step generation command creators for `fill`
command.

Author: ncdiehl11

step-generation/src/__tests__/flexStackerFill.test.ts

@@ -0,0 +1,79 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+import {
+  FLEX_STACKER_MODULE_TYPE,
+  FLEX_STACKER_MODULE_V1,
+} from '@opentrons/shared-data'
+
+import { flexStackerFill } from '../commandCreators/atomic/flexStackerFill'
+import { getInitialRobotStateStandard, makeContext } from '../fixtures'
+
+import type { InvariantContext, RobotState } from '../types'
+
+const moduleId = 'flexStackerId'
+vi.mock('../robotStateSelectors')
+
+describe('flexStackerStore', () => {
+  let invariantContext: InvariantContext
+  let robotState: RobotState
+  beforeEach(() => {
+    invariantContext = makeContext()
+    robotState = getInitialRobotStateStandard(invariantContext)
+    invariantContext.moduleEntities[moduleId] = {
+      id: moduleId,
+      type: FLEX_STACKER_MODULE_TYPE,
+      model: FLEX_STACKER_MODULE_V1,
+      pythonName: 'mock_flex_stacker_1',
+    }
+  })
+  it('creates flex stacker fill command with count', () => {
+    const result = flexStackerFill(
+      {
+        moduleId,
+        count: 10,
+        strategy: 'manualWithPause',
+      },
+      invariantContext,
+      robotState
+    )
+    expect(result).toEqual({
+      commands: [
+        {
+          commandType: 'flexStacker/fill',
+          key: expect.any(String),
+          params: {
+            moduleId,
+            strategy: 'manualWithPause',
+            count: 10,
+          },
+        },
+      ],
+      python: 'mock_flex_stacker_1.fill(count=10)',
+    })
+  })
+  it('creates flex stacker fill command with message', () => {
+    const result = flexStackerFill(
+      {
+        moduleId,
+        message: 'Filling...',
+        strategy: 'manualWithPause',
+      },
+      invariantContext,
+      robotState
+    )
+    expect(result).toEqual({
+      commands: [
+        {
+          commandType: 'flexStacker/fill',
+          key: expect.any(String),
+          params: {
+            moduleId,
+            strategy: 'manualWithPause',
+            message: 'Filling...',
+          },
+        },
+      ],
+      python: 'mock_flex_stacker_1.fill(message="Filling...")',
+    })
+  })
+})

step-generation/src/commandCreators/atomic/flexStackerFill.ts

@@ -0,0 +1,35 @@
+import { formatPyStr, uuid } from '../../utils'
+
+import type { FlexStackerFillCreateCommand } from '@opentrons/shared-data'
+import type { CommandCreator } from '../../types'
+
+export const flexStackerFill: CommandCreator<
+  FlexStackerFillCreateCommand['params']
+> = (args, invariantContext) => {
+  const { moduleId, message, count, labwareToStore } = args
+  const pythonName = invariantContext.moduleEntities[moduleId].pythonName
+
+  // TODO: add error creators
+
+  const pythonArgs = [
+    ...(count != null ? [`count=${count}`] : []),
+    ...(message != null ? [`message=${formatPyStr(message)}`] : []),
+  ]
+
+  return {
+    commands: [
+      {
+        commandType: 'flexStacker/fill',
+        key: uuid(),
+        params: {
+          moduleId,
+          strategy: 'manualWithPause',
+          message,
+          count,
+          labwareToStore,
+        },
+      },
+    ],
+    python: `${pythonName}.fill(${pythonArgs.join(', ')})`,
+  }
+}