Skip to content

feat: add off-cycle payroll flow skeleton and state machine#1055

Draft
jeffredodd wants to merge 4 commits intojdj/SDK-345-extract-payroll-execution-flowfrom
jdj/SDK-345-off-cycle-flow-skeleton
Draft

feat: add off-cycle payroll flow skeleton and state machine#1055
jeffredodd wants to merge 4 commits intojdj/SDK-345-extract-payroll-execution-flowfrom
jdj/SDK-345-off-cycle-flow-skeleton

Conversation

@jeffredodd
Copy link
Contributor

Summary

  • Adds the OffCyclePayrollFlow component with a state machine to manage off-cycle payroll steps (create → payroll execution)
  • Introduces OffCycleFlow and CreateOffCyclePayroll placeholder components for the off-cycle flow
  • Extends PayrollExecutionFlow to accept an optional onBack prop for navigation from child flows
  • Adds breadcrumb helper utilities and new component event constants for off-cycle payroll

Test plan

  • Verify OffCycleFlow Storybook story renders correctly
  • Verify state machine transitions via unit tests (offCycleStateMachine.test.ts)
  • Confirm PayrollExecutionFlow onBack callback works when navigating back from off-cycle flow

Made with Cursor

@jeffredodd jeffredodd marked this pull request as draft February 9, 2026 00:32
@jeffredodd jeffredodd force-pushed the jdj/SDK-345-off-cycle-flow-skeleton branch from c3fa3b0 to ea4cfc5 Compare February 9, 2026 00:39
@jeffredodd jeffredodd force-pushed the jdj/SDK-345-extract-payroll-execution-flow branch 2 times, most recently from 6b6b028 to e2d6362 Compare February 10, 2026 01:48
jeffredodd and others added 3 commits February 12, 2026 15:33
Introduce the off-cycle payroll flow structure: a two-state machine
(createOffCyclePayroll -> done), flow orchestrator that transitions
into PayrollExecutionFlow, breadcrumb composition via prependBreadcrumbs,
and a Storybook story for visual verification. The creation UI is a
placeholder that will be fleshed out in a follow-up PR.

Co-authored-by: Cursor <cursoragent@cursor.com>
Move UI components, orchestration logic, stories, and breadcrumb
helpers to follow-up branch (jdj/SDK-345-off-cycle-flow-ui). Keep
only the state machine, type definitions, and event constants.

Co-authored-by: Cursor <cursoragent@cursor.com>
…patterns

Update OffCycleFlowProps.onEvent to use OnEventType<EventType, unknown>
and rewrite state machine tests to use createService/send helper pattern.

Co-authored-by: Cursor <cursoragent@cursor.com>
Wire up the off-cycle flow skeleton with presentational components
and state machine transitions. The OffCycleFlow composes
PayrollExecutionFlow as a nested child flow with breadcrumb
prefixing, matching the pattern used by PayrollFlow.

Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant