@gusto/embedded-react-sdk 0.48.0 → 0.48.2

package/dist/components/Payroll/OffCycle/OffCycleFlowComponents.d.ts

@@ -2,17 +2,37 @@ import { OffCycleReason } from '../OffCycleReasonSelection';
 import { FlowContextInterface } from '../../Flow/useFlow';
 import { OnEventType } from '../../Base/useBase';
 import { EventType } from '../../../shared/constants';
+/**
+ * Flow context shared across the off-cycle payroll flow steps.
+ *
+ * @public
+ */
 export interface OffCycleFlowContextInterface extends FlowContextInterface {
+    /** The associated company identifier. */
     companyId: string;
+    /** Identifier of the off-cycle payroll created during the flow; set once creation completes. */
     payrollUuid?: string;
+    /** Pre-selected off-cycle reason (bonus or correction). */
     payrollType?: OffCycleReason;
+    /** Whether to show reimbursement fields throughout the execution steps. Defaults to true. */
     withReimbursements?: boolean;
 }
+/**
+ * Props for {@link OffCycleFlow}.
+ *
+ * @public
+ */
 export interface OffCycleFlowProps {
+    /** The associated company identifier. */
     companyId: string;
+    /** Optional pre-selected off-cycle reason. When provided, the creation form starts with this reason selected. */
     payrollType?: OffCycleReason;
+    /** Callback invoked when the flow emits an event. See the events table on {@link OffCycleFlow}. */
     onEvent: OnEventType<EventType, unknown>;
+    /** Optional flag to show/hide reimbursement fields throughout the flow. Defaults to true. */
     withReimbursements?: boolean;
 }
+/** @internal */
 export declare function OffCycleCreationContextual(): import("react").JSX.Element;
+/** @internal */
 export declare function OffCycleExecutionContextual(): import("react").JSX.Element;

package/dist/components/Payroll/OffCycle/OffCycleFlowComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCycleFlowComponents.js","sources":["../../../../src/components/Payroll/OffCycle/OffCycleFlowComponents.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { usePayrollsGetSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsGet'\nimport { OffCycleCreation } from '../OffCycleCreation'\nimport {\n  PayrollExecutionFlow,\n  type PayrollExecutionFlowProps,\n} from '../PayrollExecutionFlow/PayrollExecutionFlow'\nimport type { OffCycleReason } from '../OffCycleReasonSelection'\nimport { isDismissalPayroll } from '../helpers'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport type { EventType } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\nimport { BaseComponent } from '@/components/Base/Base'\n\nexport interface OffCycleFlowContextInterface extends FlowContextInterface {\n  companyId: string\n  payrollUuid?: string\n  payrollType?: OffCycleReason\n  withReimbursements?: boolean\n}\n\nexport interface OffCycleFlowProps {\n  companyId: string\n  payrollType?: OffCycleReason\n  onEvent: OnEventType<EventType, unknown>\n  withReimbursements?: boolean\n}\n\nexport function OffCycleCreationContextual() {\n  const { companyId, payrollType, onEvent } = useFlow<OffCycleFlowContextInterface>()\n  return (\n    <OffCycleCreation\n      companyId={ensureRequired(companyId)}\n      payrollType={payrollType}\n      onEvent={onEvent}\n    />\n  )\n}\n\nexport function OffCycleExecutionContextual() {\n  const { companyId, payrollUuid, onEvent, withReimbursements, header } =\n    useFlow<OffCycleFlowContextInterface>()\n\n  const resolvedCompanyId = ensureRequired(companyId)\n  const resolvedPayrollId = ensureRequired(payrollUuid)\n\n  const offCycleRootBreadcrumb =\n    header?.type === 'breadcrumbs' ? header.breadcrumbs?.['createOffCyclePayroll']?.[0] : undefined\n  const prefixBreadcrumbs = useMemo(\n    () => (offCycleRootBreadcrumb ? [offCycleRootBreadcrumb] : undefined),\n    [offCycleRootBreadcrumb],\n  )\n\n  return (\n    <BaseComponent onEvent={onEvent}>\n      <OffCycleExecutionWithData\n        companyId={resolvedCompanyId}\n        payrollId={resolvedPayrollId}\n        onEvent={onEvent}\n        withReimbursements={withReimbursements}\n        prefixBreadcrumbs={prefixBreadcrumbs}\n      />\n    </BaseComponent>\n  )\n}\n\ntype OffCycleExecutionWithDataProps = Pick<\n  PayrollExecutionFlowProps,\n  'companyId' | 'payrollId' | 'onEvent' | 'prefixBreadcrumbs' | 'withReimbursements'\n>\n\nfunction OffCycleExecutionWithData({\n  companyId,\n  payrollId,\n  ...rest\n}: OffCycleExecutionWithDataProps) {\n  const { data } = usePayrollsGetSuspense({ companyId, payrollId })\n  const initialPayPeriod = data.payrollShow?.payPeriod\n\n  return (\n    <PayrollExecutionFlow\n      companyId={companyId}\n      payrollId={payrollId}\n      initialPayPeriod={initialPayPeriod}\n      isDismissalPayroll={isDismissalPayroll(data.payrollShow?.offCycleReason)}\n      {...rest}\n    />\n  )\n}\n"],"names":["OffCycleCreationContextual","companyId","payrollType","onEvent","useFlow","jsx","OffCycleCreation","ensureRequired","OffCycleExecutionContextual","payrollUuid","withReimbursements","header","resolvedCompanyId","resolvedPayrollId","offCycleRootBreadcrumb","prefixBreadcrumbs","useMemo","BaseComponent","OffCycleExecutionWithData","payrollId","rest","data","usePayrollsGetSuspense","initialPayPeriod","PayrollExecutionFlow","isDismissalPayroll"],"mappings":";;;;;;;;;AA6BO,SAASA,IAA6B;AAC3C,QAAM,EAAE,WAAAC,GAAW,aAAAC,GAAa,SAAAC,EAAA,IAAYC,EAAA;AAC5C,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAeN,CAAS;AAAA,MACnC,aAAAC;AAAA,MACA,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;AAEO,SAASK,IAA8B;AAC5C,QAAM,EAAE,WAAAP,GAAW,aAAAQ,GAAa,SAAAN,GAAS,oBAAAO,GAAoB,QAAAC,EAAA,IAC3DP,EAAA,GAEIQ,IAAoBL,EAAeN,CAAS,GAC5CY,IAAoBN,EAAeE,CAAW,GAE9CK,IACJH,GAAQ,SAAS,gBAAgBA,EAAO,aAAc,wBAA2B,CAAC,IAAI,QAClFI,IAAoBC;AAAA,IACxB,MAAOF,IAAyB,CAACA,CAAsB,IAAI;AAAA,IAC3D,CAACA,CAAsB;AAAA,EAAA;AAGzB,SACE,gBAAAT,EAACY,KAAc,SAAAd,GACb,UAAA,gBAAAE;AAAA,IAACa;AAAA,IAAA;AAAA,MACC,WAAWN;AAAA,MACX,WAAWC;AAAA,MACX,SAAAV;AAAA,MACA,oBAAAO;AAAA,MACA,mBAAAK;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;AAOA,SAASG,EAA0B;AAAA,EACjC,WAAAjB;AAAA,EACA,WAAAkB;AAAA,EACA,GAAGC;AACL,GAAmC;AACjC,QAAM,EAAE,MAAAC,EAAA,IAASC,EAAuB,EAAE,WAAArB,GAAW,WAAAkB,GAAW,GAC1DI,IAAmBF,EAAK,aAAa;AAE3C,SACE,gBAAAhB;AAAA,IAACmB;AAAA,IAAA;AAAA,MACC,WAAAvB;AAAA,MACA,WAAAkB;AAAA,MACA,kBAAAI;AAAA,MACA,oBAAoBE,EAAmBJ,EAAK,aAAa,cAAc;AAAA,MACtE,GAAGD;AAAA,IAAA;AAAA,EAAA;AAGV;"}
+{"version":3,"file":"OffCycleFlowComponents.js","sources":["../../../../src/components/Payroll/OffCycle/OffCycleFlowComponents.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { usePayrollsGetSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsGet'\nimport { OffCycleCreation } from '../OffCycleCreation'\nimport {\n  PayrollExecutionFlow,\n  type PayrollExecutionFlowProps,\n} from '../PayrollExecutionFlow/PayrollExecutionFlow'\nimport type { OffCycleReason } from '../OffCycleReasonSelection'\nimport { isDismissalPayroll } from '../helpers'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport type { EventType } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\nimport { BaseComponent } from '@/components/Base/Base'\n\n/**\n * Flow context shared across the off-cycle payroll flow steps.\n *\n * @public\n */\nexport interface OffCycleFlowContextInterface extends FlowContextInterface {\n  /** The associated company identifier. */\n  companyId: string\n  /** Identifier of the off-cycle payroll created during the flow; set once creation completes. */\n  payrollUuid?: string\n  /** Pre-selected off-cycle reason (bonus or correction). */\n  payrollType?: OffCycleReason\n  /** Whether to show reimbursement fields throughout the execution steps. Defaults to true. */\n  withReimbursements?: boolean\n}\n\n/**\n * Props for {@link OffCycleFlow}.\n *\n * @public\n */\nexport interface OffCycleFlowProps {\n  /** The associated company identifier. */\n  companyId: string\n  /** Optional pre-selected off-cycle reason. When provided, the creation form starts with this reason selected. */\n  payrollType?: OffCycleReason\n  /** Callback invoked when the flow emits an event. See the events table on {@link OffCycleFlow}. */\n  onEvent: OnEventType<EventType, unknown>\n  /** Optional flag to show/hide reimbursement fields throughout the flow. Defaults to true. */\n  withReimbursements?: boolean\n}\n\n/** @internal */\nexport function OffCycleCreationContextual() {\n  const { companyId, payrollType, onEvent } = useFlow<OffCycleFlowContextInterface>()\n  return (\n    <OffCycleCreation\n      companyId={ensureRequired(companyId)}\n      payrollType={payrollType}\n      onEvent={onEvent}\n    />\n  )\n}\n\n/** @internal */\nexport function OffCycleExecutionContextual() {\n  const { companyId, payrollUuid, onEvent, withReimbursements, header } =\n    useFlow<OffCycleFlowContextInterface>()\n\n  const resolvedCompanyId = ensureRequired(companyId)\n  const resolvedPayrollId = ensureRequired(payrollUuid)\n\n  const offCycleRootBreadcrumb =\n    header?.type === 'breadcrumbs' ? header.breadcrumbs?.['createOffCyclePayroll']?.[0] : undefined\n  const prefixBreadcrumbs = useMemo(\n    () => (offCycleRootBreadcrumb ? [offCycleRootBreadcrumb] : undefined),\n    [offCycleRootBreadcrumb],\n  )\n\n  return (\n    <BaseComponent onEvent={onEvent}>\n      <OffCycleExecutionWithData\n        companyId={resolvedCompanyId}\n        payrollId={resolvedPayrollId}\n        onEvent={onEvent}\n        withReimbursements={withReimbursements}\n        prefixBreadcrumbs={prefixBreadcrumbs}\n      />\n    </BaseComponent>\n  )\n}\n\ntype OffCycleExecutionWithDataProps = Pick<\n  PayrollExecutionFlowProps,\n  'companyId' | 'payrollId' | 'onEvent' | 'prefixBreadcrumbs' | 'withReimbursements'\n>\n\nfunction OffCycleExecutionWithData({\n  companyId,\n  payrollId,\n  ...rest\n}: OffCycleExecutionWithDataProps) {\n  const { data } = usePayrollsGetSuspense({ companyId, payrollId })\n  const initialPayPeriod = data.payrollShow?.payPeriod\n\n  return (\n    <PayrollExecutionFlow\n      companyId={companyId}\n      payrollId={payrollId}\n      initialPayPeriod={initialPayPeriod}\n      isDismissalPayroll={isDismissalPayroll(data.payrollShow?.offCycleReason)}\n      {...rest}\n    />\n  )\n}\n"],"names":["OffCycleCreationContextual","companyId","payrollType","onEvent","useFlow","jsx","OffCycleCreation","ensureRequired","OffCycleExecutionContextual","payrollUuid","withReimbursements","header","resolvedCompanyId","resolvedPayrollId","offCycleRootBreadcrumb","prefixBreadcrumbs","useMemo","BaseComponent","OffCycleExecutionWithData","payrollId","rest","data","usePayrollsGetSuspense","initialPayPeriod","PayrollExecutionFlow","isDismissalPayroll"],"mappings":";;;;;;;;;AAgDO,SAASA,IAA6B;AAC3C,QAAM,EAAE,WAAAC,GAAW,aAAAC,GAAa,SAAAC,EAAA,IAAYC,EAAA;AAC5C,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,WAAWC,EAAeN,CAAS;AAAA,MACnC,aAAAC;AAAA,MACA,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASK,IAA8B;AAC5C,QAAM,EAAE,WAAAP,GAAW,aAAAQ,GAAa,SAAAN,GAAS,oBAAAO,GAAoB,QAAAC,EAAA,IAC3DP,EAAA,GAEIQ,IAAoBL,EAAeN,CAAS,GAC5CY,IAAoBN,EAAeE,CAAW,GAE9CK,IACJH,GAAQ,SAAS,gBAAgBA,EAAO,aAAc,wBAA2B,CAAC,IAAI,QAClFI,IAAoBC;AAAA,IACxB,MAAOF,IAAyB,CAACA,CAAsB,IAAI;AAAA,IAC3D,CAACA,CAAsB;AAAA,EAAA;AAGzB,SACE,gBAAAT,EAACY,KAAc,SAAAd,GACb,UAAA,gBAAAE;AAAA,IAACa;AAAA,IAAA;AAAA,MACC,WAAWN;AAAA,MACX,WAAWC;AAAA,MACX,SAAAV;AAAA,MACA,oBAAAO;AAAA,MACA,mBAAAK;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;AAOA,SAASG,EAA0B;AAAA,EACjC,WAAAjB;AAAA,EACA,WAAAkB;AAAA,EACA,GAAGC;AACL,GAAmC;AACjC,QAAM,EAAE,MAAAC,EAAA,IAASC,EAAuB,EAAE,WAAArB,GAAW,WAAAkB,GAAW,GAC1DI,IAAmBF,EAAK,aAAa;AAE3C,SACE,gBAAAhB;AAAA,IAACmB;AAAA,IAAA;AAAA,MACC,WAAAvB;AAAA,MACA,WAAAkB;AAAA,MACA,kBAAAI;AAAA,MACA,oBAAoBE,EAAmBJ,EAAK,aAAa,cAAc;AAAA,MACtE,GAAGD;AAAA,IAAA;AAAA,EAAA;AAGV;"}

package/dist/components/Payroll/OffCycle/offCycleStateMachine.d.ts

@@ -1,5 +1,7 @@
 import { BreadcrumbNodes } from '../../Common/FlowBreadcrumbs/FlowBreadcrumbsTypes';
+/** @internal */
 export declare const offCycleBreadcrumbsNodes: BreadcrumbNodes;
+/** @internal */
 export declare const offCycleMachine: {
     createOffCyclePayroll: import('robot3').MachineState<any>;
     execution: import('robot3').MachineState<any>;

package/dist/components/Payroll/OffCycle/offCycleStateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"offCycleStateMachine.js","sources":["../../../../src/components/Payroll/OffCycle/offCycleStateMachine.ts"],"sourcesContent":["import { state, transition, reduce, guard } from 'robot3'\nimport {\n  OffCycleCreationContextual,\n  OffCycleExecutionContextual,\n  type OffCycleFlowContextInterface,\n} from './OffCycleFlowComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\nimport type { BreadcrumbNodes } from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport { patchBreadcrumbsHeader } from '@/helpers/breadcrumbHelpers'\n\nexport const offCycleBreadcrumbsNodes: BreadcrumbNodes = {\n  createOffCyclePayroll: {\n    parent: null,\n    item: {\n      id: 'createOffCyclePayroll',\n      label: 'createOffCyclePayroll.breadcrumbLabel',\n      namespace: 'Payroll.OffCycle',\n      onNavigate: ((ctx: OffCycleFlowContextInterface) => ({\n        ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: 'createOffCyclePayroll' }),\n        component: OffCycleCreationContextual,\n        payrollUuid: undefined,\n      })) as (context: unknown) => unknown,\n    },\n  },\n}\n\nfunction toCreationReducer(ctx: OffCycleFlowContextInterface): OffCycleFlowContextInterface {\n  return {\n    ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: 'createOffCyclePayroll' }),\n    component: OffCycleCreationContextual,\n    payrollUuid: undefined,\n  }\n}\n\nconst creationBreadcrumbTransition = transition(\n  componentEvents.BREADCRUMB_NAVIGATE,\n  'createOffCyclePayroll',\n  guard(\n    (_ctx: OffCycleFlowContextInterface, ev: { payload: { key: string } }) =>\n      ev.payload.key === 'createOffCyclePayroll',\n  ),\n  reduce(toCreationReducer),\n)\n\nexport const offCycleMachine = {\n  createOffCyclePayroll: state<MachineTransition>(\n    transition(\n      componentEvents.OFF_CYCLE_CREATED,\n      'execution',\n      reduce(\n        (\n          ctx: OffCycleFlowContextInterface,\n          ev: { payload?: { payrollUuid?: string } },\n        ): OffCycleFlowContextInterface => ({\n          ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: undefined }),\n          payrollUuid: ev.payload?.payrollUuid,\n          component: OffCycleExecutionContextual,\n        }),\n      ),\n    ),\n  ),\n\n  execution: state<MachineTransition>(creationBreadcrumbTransition),\n}\n"],"names":["offCycleBreadcrumbsNodes","ctx","patchBreadcrumbsHeader","OffCycleCreationContextual","toCreationReducer","creationBreadcrumbTransition","transition","componentEvents","guard","_ctx","ev","reduce","offCycleMachine","state","OffCycleExecutionContextual"],"mappings":";;;;AAWO,MAAMA,IAA4C;AAAA,EACvD,uBAAuB;AAAA,IACrB,QAAQ;AAAA,IACR,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,WAAW;AAAA,MACX,aAAa,CAACC,OAAuC;AAAA,QACnD,GAAGC,EAAuBD,GAAK,EAAE,qBAAqB,yBAAyB;AAAA,QAC/E,WAAWE;AAAA,QACX,aAAa;AAAA,MAAA;AAAA,IACf;AAAA,EACF;AAEJ;AAEA,SAASC,EAAkBH,GAAiE;AAC1F,SAAO;AAAA,IACL,GAAGC,EAAuBD,GAAK,EAAE,qBAAqB,yBAAyB;AAAA,IAC/E,WAAWE;AAAA,IACX,aAAa;AAAA,EAAA;AAEjB;AAEA,MAAME,IAA+BC;AAAA,EACnCC,EAAgB;AAAA,EAChB;AAAA,EACAC;AAAA,IACE,CAACC,GAAoCC,MACnCA,EAAG,QAAQ,QAAQ;AAAA,EAAA;AAAA,EAEvBC,EAAOP,CAAiB;AAC1B,GAEaQ,IAAkB;AAAA,EAC7B,uBAAuBC;AAAA,IACrBP;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAI;AAAA,QACE,CACEV,GACAS,OACkC;AAAA,UAClC,GAAGR,EAAuBD,GAAK,EAAE,qBAAqB,QAAW;AAAA,UACjE,aAAaS,EAAG,SAAS;AAAA,UACzB,WAAWI;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAGF,WAAWD,EAAyBR,CAA4B;AAClE;"}
+{"version":3,"file":"offCycleStateMachine.js","sources":["../../../../src/components/Payroll/OffCycle/offCycleStateMachine.ts"],"sourcesContent":["import { state, transition, reduce, guard } from 'robot3'\nimport {\n  OffCycleCreationContextual,\n  OffCycleExecutionContextual,\n  type OffCycleFlowContextInterface,\n} from './OffCycleFlowComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\nimport type { BreadcrumbNodes } from '@/components/Common/FlowBreadcrumbs/FlowBreadcrumbsTypes'\nimport { patchBreadcrumbsHeader } from '@/helpers/breadcrumbHelpers'\n\n/** @internal */\nexport const offCycleBreadcrumbsNodes: BreadcrumbNodes = {\n  createOffCyclePayroll: {\n    parent: null,\n    item: {\n      id: 'createOffCyclePayroll',\n      label: 'createOffCyclePayroll.breadcrumbLabel',\n      namespace: 'Payroll.OffCycle',\n      onNavigate: ((ctx: OffCycleFlowContextInterface) => ({\n        ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: 'createOffCyclePayroll' }),\n        component: OffCycleCreationContextual,\n        payrollUuid: undefined,\n      })) as (context: unknown) => unknown,\n    },\n  },\n}\n\nfunction toCreationReducer(ctx: OffCycleFlowContextInterface): OffCycleFlowContextInterface {\n  return {\n    ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: 'createOffCyclePayroll' }),\n    component: OffCycleCreationContextual,\n    payrollUuid: undefined,\n  }\n}\n\nconst creationBreadcrumbTransition = transition(\n  componentEvents.BREADCRUMB_NAVIGATE,\n  'createOffCyclePayroll',\n  guard(\n    (_ctx: OffCycleFlowContextInterface, ev: { payload: { key: string } }) =>\n      ev.payload.key === 'createOffCyclePayroll',\n  ),\n  reduce(toCreationReducer),\n)\n\n/** @internal */\nexport const offCycleMachine = {\n  createOffCyclePayroll: state<MachineTransition>(\n    transition(\n      componentEvents.OFF_CYCLE_CREATED,\n      'execution',\n      reduce(\n        (\n          ctx: OffCycleFlowContextInterface,\n          ev: { payload?: { payrollUuid?: string } },\n        ): OffCycleFlowContextInterface => ({\n          ...patchBreadcrumbsHeader(ctx, { currentBreadcrumbId: undefined }),\n          payrollUuid: ev.payload?.payrollUuid,\n          component: OffCycleExecutionContextual,\n        }),\n      ),\n    ),\n  ),\n\n  execution: state<MachineTransition>(creationBreadcrumbTransition),\n}\n"],"names":["offCycleBreadcrumbsNodes","ctx","patchBreadcrumbsHeader","OffCycleCreationContextual","toCreationReducer","creationBreadcrumbTransition","transition","componentEvents","guard","_ctx","ev","reduce","offCycleMachine","state","OffCycleExecutionContextual"],"mappings":";;;;AAYO,MAAMA,IAA4C;AAAA,EACvD,uBAAuB;AAAA,IACrB,QAAQ;AAAA,IACR,MAAM;AAAA,MACJ,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,WAAW;AAAA,MACX,aAAa,CAACC,OAAuC;AAAA,QACnD,GAAGC,EAAuBD,GAAK,EAAE,qBAAqB,yBAAyB;AAAA,QAC/E,WAAWE;AAAA,QACX,aAAa;AAAA,MAAA;AAAA,IACf;AAAA,EACF;AAEJ;AAEA,SAASC,EAAkBH,GAAiE;AAC1F,SAAO;AAAA,IACL,GAAGC,EAAuBD,GAAK,EAAE,qBAAqB,yBAAyB;AAAA,IAC/E,WAAWE;AAAA,IACX,aAAa;AAAA,EAAA;AAEjB;AAEA,MAAME,IAA+BC;AAAA,EACnCC,EAAgB;AAAA,EAChB;AAAA,EACAC;AAAA,IACE,CAACC,GAAoCC,MACnCA,EAAG,QAAQ,QAAQ;AAAA,EAAA;AAAA,EAEvBC,EAAOP,CAAiB;AAC1B,GAGaQ,IAAkB;AAAA,EAC7B,uBAAuBC;AAAA,IACrBP;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAI;AAAA,QACE,CACEV,GACAS,OACkC;AAAA,UAClC,GAAGR,EAAuBD,GAAK,EAAE,qBAAqB,QAAW;AAAA,UACjE,aAAaS,EAAG,SAAS;AAAA,UACzB,WAAWI;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAGF,WAAWD,EAAyBR,CAA4B;AAClE;"}

package/dist/components/Payroll/OffCycleCreation/OffCycleCreation.d.ts

@@ -1,2 +1,22 @@
 import { OffCycleCreationProps } from './OffCycleCreationTypes';
+/**
+ * Creation form for off-cycle (bonus or correction) payrolls.
+ *
+ * Walks the user through configuring pay period dates, selecting a reason, choosing
+ * employees, and setting deduction and tax withholding preferences, then submits the
+ * resulting payroll for execution.
+ *
+ * @remarks
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `offCycle/created` | The off-cycle payroll has been created | `{ payrollUuid: string }` |
+ *
+ * Changing the reason updates the deduction and withholding defaults — `'bonus'` skips
+ * regular deductions and uses the supplemental withholding rate; `'correction'` includes
+ * regular deductions and uses the regular rate.
+ *
+ * @param props - {@link OffCycleCreationProps} plus base component props.
+ * @returns The off-cycle payroll creation form.
+ * @public
+ */
 export declare function OffCycleCreation(props: OffCycleCreationProps): import("react").JSX.Element;

package/dist/components/Payroll/OffCycleCreation/OffCycleCreation.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCycleCreation.js","sources":["../../../../src/components/Payroll/OffCycleCreation/OffCycleCreation.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState } from 'react'\nimport { FormProvider, useForm, type Resolver } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport { z } from 'zod'\nimport { useTranslation } from 'react-i18next'\nimport { usePayrollsCreateOffCycleMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsCreateOffCycle'\nimport {\n  OffCycleReason as ApiOffCycleReason,\n  WithholdingPayPeriod,\n} from '@gusto/embedded-api-v-2025-11-15/models/operations/postv1companiescompanyidpayrolls'\nimport { RFCDate } from '@gusto/embedded-api-v-2025-11-15/types/rfcdate'\nimport { useEmployeesListSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesList'\nimport { OFF_CYCLE_REASON_DEFAULTS, type OffCycleReason } from '../OffCycleReasonSelection'\nimport {\n  createOffCyclePayPeriodDateFormSchema,\n  type OffCyclePayrollDateType,\n} from '../OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormTypes'\nimport { useOffCyclePayPeriodDateValidation } from '../OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation'\nimport type { OffCycleTaxWithholdingConfig } from '../OffCycleTaxWithholdingTable/OffCycleTaxWithholdingTableTypes'\nimport type { OffCycleCreationFormData, OffCycleCreationProps } from './OffCycleCreationTypes'\nimport { OffCycleCreationPresentation } from './OffCycleCreationPresentation'\nimport { useCompanyPaymentSpeed } from '@/hooks/useCompanyPaymentSpeed'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { Form } from '@/components/Common/Form'\nimport type { MultiSelectComboBoxOption } from '@/components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes'\n\nconst LOCAL_TO_API_REASON: Record<OffCycleReason, ApiOffCycleReason> = {\n  bonus: ApiOffCycleReason.Bonus,\n  correction: ApiOffCycleReason.Correction,\n}\n\nexport function OffCycleCreation(props: OffCycleCreationProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ dictionary, companyId, payrollType = 'bonus' }: OffCycleCreationProps) {\n  useComponentDictionary('Payroll.OffCycleCreation', dictionary)\n  useI18n('Payroll.OffCycleCreation')\n  useI18n('Payroll.OffCycleReasonSelection')\n  useI18n('Payroll.OffCyclePayPeriodDateForm')\n  useI18n('Payroll.OffCycleDeductionsSetting')\n  useI18n('Payroll.EmployeeSelection')\n\n  const { t } = useTranslation('Payroll.OffCyclePayPeriodDateForm')\n  const { t: tCreation } = useTranslation('Payroll.OffCycleCreation')\n  const { onEvent, baseSubmitHandler } = useBase()\n\n  const { paymentSpeedDays } = useCompanyPaymentSpeed(companyId)\n\n  const { minCheckDate, today } = useOffCyclePayPeriodDateValidation(paymentSpeedDays)\n  const { mutateAsync: createOffCyclePayroll, isPending } = usePayrollsCreateOffCycleMutation()\n\n  const [taxWithholdingConfig, setTaxWithholdingConfig] = useState<OffCycleTaxWithholdingConfig>({\n    withholdingPayPeriod: WithholdingPayPeriod.EveryOtherWeek,\n    withholdingRate: OFF_CYCLE_REASON_DEFAULTS[payrollType].withholdingType,\n  })\n  const [isTaxWithholdingModalOpen, setIsTaxWithholdingModalOpen] = useState(false)\n\n  const handleTaxWithholdingEditClick = useCallback(() => {\n    setIsTaxWithholdingModalOpen(true)\n  }, [])\n\n  const handleTaxWithholdingModalDone = useCallback((config: OffCycleTaxWithholdingConfig) => {\n    setTaxWithholdingConfig(config)\n    setIsTaxWithholdingModalOpen(false)\n  }, [])\n\n  const handleTaxWithholdingModalCancel = useCallback(() => {\n    setIsTaxWithholdingModalOpen(false)\n  }, [])\n\n  const { data: employeesData } = useEmployeesListSuspense({\n    companyId,\n    onboardedActive: true,\n  })\n\n  const employees: MultiSelectComboBoxOption[] = useMemo(() => {\n    const employeeList = employeesData.showEmployees ?? []\n    return [...employeeList]\n      .sort((a, b) => {\n        const lastNameComparison = a.lastName.localeCompare(b.lastName)\n        if (lastNameComparison !== 0) return lastNameComparison\n        return a.firstName.localeCompare(b.firstName)\n      })\n      .map(employee => {\n        const fullName = [employee.firstName, employee.lastName].filter(Boolean).join(' ')\n        return {\n          label: fullName,\n          value: employee.uuid,\n        }\n      })\n  }, [employeesData])\n\n  const translateValidation = (key: string, options?: Record<string, unknown>): string =>\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    t(key as any, options as any) as string\n\n  const dynamicResolver: Resolver<OffCycleCreationFormData> = (values, context, options) => {\n    const reason = values.reason\n    const isCheckOnly = values.isCheckOnly\n    const resolvedPayrollType: OffCyclePayrollDateType =\n      reason === 'correction' ? 'correction' : payrollType\n\n    const dateSchema = createOffCyclePayPeriodDateFormSchema(\n      translateValidation,\n      resolvedPayrollType,\n      isCheckOnly ? today : minCheckDate,\n      paymentSpeedDays,\n    )\n    const schema = z\n      .object({\n        reason: z.enum(['bonus', 'correction']),\n        skipRegularDeductions: z.boolean(),\n        includeAllEmployees: z.boolean(),\n        selectedEmployeeUuids: z.array(z.string()),\n      })\n      .and(dateSchema)\n      .superRefine((data, ctx) => {\n        if (!data.includeAllEmployees && data.selectedEmployeeUuids.length === 0) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['selectedEmployeeUuids'],\n            message: tCreation('errors.noEmployeesSelected'),\n          })\n        }\n      })\n\n    return zodResolver(schema)(values, context, options)\n  }\n\n  const methods = useForm<OffCycleCreationFormData>({\n    resolver: dynamicResolver,\n    defaultValues: {\n      reason: payrollType,\n      isCheckOnly: false,\n      startDate: null,\n      endDate: null,\n      checkDate: null,\n      skipRegularDeductions: OFF_CYCLE_REASON_DEFAULTS[payrollType].skipDeductions,\n      includeAllEmployees: false,\n      selectedEmployeeUuids: [],\n    },\n  })\n\n  const watchedReason = methods.watch('reason')\n\n  useEffect(() => {\n    methods.setValue(\n      'skipRegularDeductions',\n      OFF_CYCLE_REASON_DEFAULTS[watchedReason].skipDeductions,\n    )\n    setTaxWithholdingConfig(prev => ({\n      ...prev,\n      withholdingRate: OFF_CYCLE_REASON_DEFAULTS[watchedReason].withholdingType,\n    }))\n  }, [watchedReason, methods])\n\n  const onSubmit = async (data: OffCycleCreationFormData) => {\n    const reason = data.reason\n    const checkDate = data.checkDate!\n    const startDate = data.startDate!\n    const endDate = data.endDate!\n    const employeeUuids = data.includeAllEmployees\n      ? employees.map(e => e.value)\n      : data.selectedEmployeeUuids.length > 0\n        ? data.selectedEmployeeUuids\n        : undefined\n\n    await baseSubmitHandler(data, async () => {\n      const response = await createOffCyclePayroll({\n        request: {\n          companyId,\n          requestBody: {\n            offCycle: true,\n            offCycleReason: LOCAL_TO_API_REASON[reason],\n            startDate: new RFCDate(startDate),\n            endDate: new RFCDate(endDate),\n            checkDate: new RFCDate(checkDate),\n            skipRegularDeductions: data.skipRegularDeductions,\n            isCheckOnlyPayroll: data.isCheckOnly,\n            employeeUuids,\n            withholdingPayPeriod: taxWithholdingConfig.withholdingPayPeriod,\n            fixedWithholdingRate: taxWithholdingConfig.withholdingRate === 'supplemental',\n          },\n        },\n      })\n\n      const payrollUuid =\n        response.payrollUnprocessed?.payrollUuid ?? response.payrollUnprocessed?.uuid\n\n      if (!payrollUuid) {\n        throw new SDKInternalError(tCreation('errors.missingPayrollId'))\n      }\n\n      onEvent(componentEvents.OFF_CYCLE_CREATED, { payrollUuid })\n    })\n  }\n\n  return (\n    <FormProvider {...methods}>\n      <Form onSubmit={methods.handleSubmit(onSubmit)}>\n        <OffCycleCreationPresentation\n          employees={employees}\n          isPending={isPending}\n          taxWithholdingConfig={taxWithholdingConfig}\n          isTaxWithholdingModalOpen={isTaxWithholdingModalOpen}\n          onTaxWithholdingEditClick={handleTaxWithholdingEditClick}\n          onTaxWithholdingModalDone={handleTaxWithholdingModalDone}\n          onTaxWithholdingModalCancel={handleTaxWithholdingModalCancel}\n        />\n      </Form>\n    </FormProvider>\n  )\n}\n"],"names":["LOCAL_TO_API_REASON","ApiOffCycleReason","OffCycleCreation","props","jsx","BaseComponent","Root","dictionary","companyId","payrollType","useComponentDictionary","useI18n","t","useTranslation","tCreation","onEvent","baseSubmitHandler","useBase","paymentSpeedDays","useCompanyPaymentSpeed","minCheckDate","today","useOffCyclePayPeriodDateValidation","createOffCyclePayroll","isPending","usePayrollsCreateOffCycleMutation","taxWithholdingConfig","setTaxWithholdingConfig","useState","WithholdingPayPeriod","OFF_CYCLE_REASON_DEFAULTS","isTaxWithholdingModalOpen","setIsTaxWithholdingModalOpen","handleTaxWithholdingEditClick","useCallback","handleTaxWithholdingModalDone","config","handleTaxWithholdingModalCancel","employeesData","useEmployeesListSuspense","employees","useMemo","a","b","lastNameComparison","employee","translateValidation","key","options","methods","useForm","values","context","reason","isCheckOnly","dateSchema","createOffCyclePayPeriodDateFormSchema","schema","z","data","ctx","zodResolver","watchedReason","useEffect","prev","onSubmit","checkDate","startDate","endDate","employeeUuids","e","response","RFCDate","payrollUuid","SDKInternalError","componentEvents","FormProvider","Form","OffCycleCreationPresentation"],"mappings":"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"}
+{"version":3,"file":"OffCycleCreation.js","sources":["../../../../src/components/Payroll/OffCycleCreation/OffCycleCreation.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState } from 'react'\nimport { FormProvider, useForm, type Resolver } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport { z } from 'zod'\nimport { useTranslation } from 'react-i18next'\nimport { usePayrollsCreateOffCycleMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsCreateOffCycle'\nimport {\n  OffCycleReason as ApiOffCycleReason,\n  WithholdingPayPeriod,\n} from '@gusto/embedded-api-v-2025-11-15/models/operations/postv1companiescompanyidpayrolls'\nimport { RFCDate } from '@gusto/embedded-api-v-2025-11-15/types/rfcdate'\nimport { useEmployeesListSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/employeesList'\nimport { OFF_CYCLE_REASON_DEFAULTS, type OffCycleReason } from '../OffCycleReasonSelection'\nimport {\n  createOffCyclePayPeriodDateFormSchema,\n  type OffCyclePayrollDateType,\n} from '../OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormTypes'\nimport { useOffCyclePayPeriodDateValidation } from '../OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation'\nimport type { OffCycleTaxWithholdingConfig } from '../OffCycleTaxWithholdingTable/OffCycleTaxWithholdingTableTypes'\nimport type { OffCycleCreationFormData, OffCycleCreationProps } from './OffCycleCreationTypes'\nimport { OffCycleCreationPresentation } from './OffCycleCreationPresentation'\nimport { useCompanyPaymentSpeed } from '@/hooks/useCompanyPaymentSpeed'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { Form } from '@/components/Common/Form'\nimport type { MultiSelectComboBoxOption } from '@/components/Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes'\n\nconst LOCAL_TO_API_REASON: Record<OffCycleReason, ApiOffCycleReason> = {\n  bonus: ApiOffCycleReason.Bonus,\n  correction: ApiOffCycleReason.Correction,\n}\n\n/**\n * Creation form for off-cycle (bonus or correction) payrolls.\n *\n * Walks the user through configuring pay period dates, selecting a reason, choosing\n * employees, and setting deduction and tax withholding preferences, then submits the\n * resulting payroll for execution.\n *\n * @remarks\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `offCycle/created` | The off-cycle payroll has been created | `{ payrollUuid: string }` |\n *\n * Changing the reason updates the deduction and withholding defaults — `'bonus'` skips\n * regular deductions and uses the supplemental withholding rate; `'correction'` includes\n * regular deductions and uses the regular rate.\n *\n * @param props - {@link OffCycleCreationProps} plus base component props.\n * @returns The off-cycle payroll creation form.\n * @public\n */\nexport function OffCycleCreation(props: OffCycleCreationProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ dictionary, companyId, payrollType = 'bonus' }: OffCycleCreationProps) {\n  useComponentDictionary('Payroll.OffCycleCreation', dictionary)\n  useI18n('Payroll.OffCycleCreation')\n  useI18n('Payroll.OffCycleReasonSelection')\n  useI18n('Payroll.OffCyclePayPeriodDateForm')\n  useI18n('Payroll.OffCycleDeductionsSetting')\n  useI18n('Payroll.EmployeeSelection')\n\n  const { t } = useTranslation('Payroll.OffCyclePayPeriodDateForm')\n  const { t: tCreation } = useTranslation('Payroll.OffCycleCreation')\n  const { onEvent, baseSubmitHandler } = useBase()\n\n  const { paymentSpeedDays } = useCompanyPaymentSpeed(companyId)\n\n  const { minCheckDate, today } = useOffCyclePayPeriodDateValidation(paymentSpeedDays)\n  const { mutateAsync: createOffCyclePayroll, isPending } = usePayrollsCreateOffCycleMutation()\n\n  const [taxWithholdingConfig, setTaxWithholdingConfig] = useState<OffCycleTaxWithholdingConfig>({\n    withholdingPayPeriod: WithholdingPayPeriod.EveryOtherWeek,\n    withholdingRate: OFF_CYCLE_REASON_DEFAULTS[payrollType].withholdingType,\n  })\n  const [isTaxWithholdingModalOpen, setIsTaxWithholdingModalOpen] = useState(false)\n\n  const handleTaxWithholdingEditClick = useCallback(() => {\n    setIsTaxWithholdingModalOpen(true)\n  }, [])\n\n  const handleTaxWithholdingModalDone = useCallback((config: OffCycleTaxWithholdingConfig) => {\n    setTaxWithholdingConfig(config)\n    setIsTaxWithholdingModalOpen(false)\n  }, [])\n\n  const handleTaxWithholdingModalCancel = useCallback(() => {\n    setIsTaxWithholdingModalOpen(false)\n  }, [])\n\n  const { data: employeesData } = useEmployeesListSuspense({\n    companyId,\n    onboardedActive: true,\n  })\n\n  const employees: MultiSelectComboBoxOption[] = useMemo(() => {\n    const employeeList = employeesData.showEmployees ?? []\n    return [...employeeList]\n      .sort((a, b) => {\n        const lastNameComparison = a.lastName.localeCompare(b.lastName)\n        if (lastNameComparison !== 0) return lastNameComparison\n        return a.firstName.localeCompare(b.firstName)\n      })\n      .map(employee => {\n        const fullName = [employee.firstName, employee.lastName].filter(Boolean).join(' ')\n        return {\n          label: fullName,\n          value: employee.uuid,\n        }\n      })\n  }, [employeesData])\n\n  const translateValidation = (key: string, options?: Record<string, unknown>): string =>\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    t(key as any, options as any) as string\n\n  const dynamicResolver: Resolver<OffCycleCreationFormData> = (values, context, options) => {\n    const reason = values.reason\n    const isCheckOnly = values.isCheckOnly\n    const resolvedPayrollType: OffCyclePayrollDateType =\n      reason === 'correction' ? 'correction' : payrollType\n\n    const dateSchema = createOffCyclePayPeriodDateFormSchema(\n      translateValidation,\n      resolvedPayrollType,\n      isCheckOnly ? today : minCheckDate,\n      paymentSpeedDays,\n    )\n    const schema = z\n      .object({\n        reason: z.enum(['bonus', 'correction']),\n        skipRegularDeductions: z.boolean(),\n        includeAllEmployees: z.boolean(),\n        selectedEmployeeUuids: z.array(z.string()),\n      })\n      .and(dateSchema)\n      .superRefine((data, ctx) => {\n        if (!data.includeAllEmployees && data.selectedEmployeeUuids.length === 0) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['selectedEmployeeUuids'],\n            message: tCreation('errors.noEmployeesSelected'),\n          })\n        }\n      })\n\n    return zodResolver(schema)(values, context, options)\n  }\n\n  const methods = useForm<OffCycleCreationFormData>({\n    resolver: dynamicResolver,\n    defaultValues: {\n      reason: payrollType,\n      isCheckOnly: false,\n      startDate: null,\n      endDate: null,\n      checkDate: null,\n      skipRegularDeductions: OFF_CYCLE_REASON_DEFAULTS[payrollType].skipDeductions,\n      includeAllEmployees: false,\n      selectedEmployeeUuids: [],\n    },\n  })\n\n  const watchedReason = methods.watch('reason')\n\n  useEffect(() => {\n    methods.setValue(\n      'skipRegularDeductions',\n      OFF_CYCLE_REASON_DEFAULTS[watchedReason].skipDeductions,\n    )\n    setTaxWithholdingConfig(prev => ({\n      ...prev,\n      withholdingRate: OFF_CYCLE_REASON_DEFAULTS[watchedReason].withholdingType,\n    }))\n  }, [watchedReason, methods])\n\n  const onSubmit = async (data: OffCycleCreationFormData) => {\n    const reason = data.reason\n    const checkDate = data.checkDate!\n    const startDate = data.startDate!\n    const endDate = data.endDate!\n    const employeeUuids = data.includeAllEmployees\n      ? employees.map(e => e.value)\n      : data.selectedEmployeeUuids.length > 0\n        ? data.selectedEmployeeUuids\n        : undefined\n\n    await baseSubmitHandler(data, async () => {\n      const response = await createOffCyclePayroll({\n        request: {\n          companyId,\n          requestBody: {\n            offCycle: true,\n            offCycleReason: LOCAL_TO_API_REASON[reason],\n            startDate: new RFCDate(startDate),\n            endDate: new RFCDate(endDate),\n            checkDate: new RFCDate(checkDate),\n            skipRegularDeductions: data.skipRegularDeductions,\n            isCheckOnlyPayroll: data.isCheckOnly,\n            employeeUuids,\n            withholdingPayPeriod: taxWithholdingConfig.withholdingPayPeriod,\n            fixedWithholdingRate: taxWithholdingConfig.withholdingRate === 'supplemental',\n          },\n        },\n      })\n\n      const payrollUuid =\n        response.payrollUnprocessed?.payrollUuid ?? response.payrollUnprocessed?.uuid\n\n      if (!payrollUuid) {\n        throw new SDKInternalError(tCreation('errors.missingPayrollId'))\n      }\n\n      onEvent(componentEvents.OFF_CYCLE_CREATED, { payrollUuid })\n    })\n  }\n\n  return (\n    <FormProvider {...methods}>\n      <Form onSubmit={methods.handleSubmit(onSubmit)}>\n        <OffCycleCreationPresentation\n          employees={employees}\n          isPending={isPending}\n          taxWithholdingConfig={taxWithholdingConfig}\n          isTaxWithholdingModalOpen={isTaxWithholdingModalOpen}\n          onTaxWithholdingEditClick={handleTaxWithholdingEditClick}\n          onTaxWithholdingModalDone={handleTaxWithholdingModalDone}\n          onTaxWithholdingModalCancel={handleTaxWithholdingModalCancel}\n        />\n      </Form>\n    </FormProvider>\n  )\n}\n"],"names":["LOCAL_TO_API_REASON","ApiOffCycleReason","OffCycleCreation","props","jsx","BaseComponent","Root","dictionary","companyId","payrollType","useComponentDictionary","useI18n","t","useTranslation","tCreation","onEvent","baseSubmitHandler","useBase","paymentSpeedDays","useCompanyPaymentSpeed","minCheckDate","today","useOffCyclePayPeriodDateValidation","createOffCyclePayroll","isPending","usePayrollsCreateOffCycleMutation","taxWithholdingConfig","setTaxWithholdingConfig","useState","WithholdingPayPeriod","OFF_CYCLE_REASON_DEFAULTS","isTaxWithholdingModalOpen","setIsTaxWithholdingModalOpen","handleTaxWithholdingEditClick","useCallback","handleTaxWithholdingModalDone","config","handleTaxWithholdingModalCancel","employeesData","useEmployeesListSuspense","employees","useMemo","a","b","lastNameComparison","employee","translateValidation","key","options","methods","useForm","values","context","reason","isCheckOnly","dateSchema","createOffCyclePayPeriodDateFormSchema","schema","z","data","ctx","zodResolver","watchedReason","useEffect","prev","onSubmit","checkDate","startDate","endDate","employeeUuids","e","response","RFCDate","payrollUuid","SDKInternalError","componentEvents","FormProvider","Form","OffCycleCreationPresentation"],"mappings":"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"}

package/dist/components/Payroll/OffCycleCreation/OffCycleCreationPresentation.d.ts

@@ -1,2 +1,3 @@
 import { OffCycleCreationPresentationProps } from './OffCycleCreationTypes';
+/** @internal */
 export declare function OffCycleCreationPresentation({ employees, isPending, taxWithholdingConfig, isTaxWithholdingModalOpen, onTaxWithholdingEditClick, onTaxWithholdingModalDone, onTaxWithholdingModalCancel, }: OffCycleCreationPresentationProps): import("react").JSX.Element;

package/dist/components/Payroll/OffCycleCreation/OffCycleCreationPresentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCycleCreationPresentation.js","sources":["../../../../src/components/Payroll/OffCycleCreation/OffCycleCreationPresentation.tsx"],"sourcesContent":["import { useCallback, useMemo } from 'react'\nimport { useFormContext } from 'react-hook-form'\nimport { useTranslation } from 'react-i18next'\nimport { OffCycleReasonSelectionPresentation } from '../OffCycleReasonSelection'\nimport { OffCyclePayPeriodDateFormPresentation } from '../OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormPresentation'\nimport { OffCycleTaxWithholdingTable } from '../OffCycleTaxWithholdingTable'\nimport { OffCycleTaxWithholdingModal } from '../OffCycleTaxWithholdingModal'\nimport {\n  WAGE_TYPE_CATEGORIES,\n  type WageTypeGroup,\n} from '../OffCycleTaxWithholdingTable/OffCycleTaxWithholdingTableTypes'\nimport type {\n  OffCycleCreationFormData,\n  OffCycleCreationPresentationProps,\n} from './OffCycleCreationTypes'\nimport styles from './OffCycleCreationPresentation.module.scss'\nimport { useI18n } from '@/i18n'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { Flex, RadioGroupField, SwitchField, MultiSelectComboBoxField } from '@/components/Common'\n\nexport function OffCycleCreationPresentation({\n  employees,\n  isPending,\n  taxWithholdingConfig,\n  isTaxWithholdingModalOpen,\n  onTaxWithholdingEditClick,\n  onTaxWithholdingModalDone,\n  onTaxWithholdingModalCancel,\n}: OffCycleCreationPresentationProps) {\n  useI18n('Payroll.OffCycleCreation')\n  useI18n('Payroll.OffCycleDeductionsSetting')\n  useI18n('Payroll.EmployeeSelection')\n  useI18n('Payroll.OffCycleTaxWithholding')\n  const { t } = useTranslation('Payroll.OffCycleCreation')\n  const { t: tDeductions } = useTranslation('Payroll.OffCycleDeductionsSetting')\n  const { t: tEmployees } = useTranslation('Payroll.EmployeeSelection')\n  const { t: tWithholding } = useTranslation('Payroll.OffCycleTaxWithholding')\n  const { Heading, Text, Button } = useComponentContext()\n\n  const wageTypeGroups: WageTypeGroup[] = useMemo(\n    () =>\n      WAGE_TYPE_CATEGORIES.map(category => {\n        const group: WageTypeGroup = {\n          category,\n          label: tWithholding(`wageTypeGroups.${category}.label`),\n        }\n        if (category === 'regular' || category === 'supplemental') {\n          group.description = tWithholding(`wageTypeGroups.${category}.description`)\n        }\n        return group\n      }),\n    [tWithholding],\n  )\n\n  const { setValue, watch } = useFormContext<OffCycleCreationFormData>()\n  const includeAllEmployees = watch('includeAllEmployees')\n\n  const handleToggleIncludeAll = useCallback(\n    (checked: boolean) => {\n      if (checked) {\n        setValue('selectedEmployeeUuids', [])\n      }\n    },\n    [setValue],\n  )\n\n  const deductionsOptions = [\n    {\n      value: false,\n      label: tDeductions('options.include.label'),\n    },\n    {\n      value: true,\n      label: tDeductions('options.skip.label'),\n    },\n  ]\n\n  return (\n    <Flex flexDirection=\"column\" gap={32}>\n      <Flex flexDirection=\"column\" gap={4}>\n        <Heading as=\"h2\">{t('pageTitle')}</Heading>\n        <Text variant=\"supporting\">{t('pageDescription')}</Text>\n      </Flex>\n\n      <Flex flexDirection=\"column\" gap={20}>\n        <Flex flexDirection=\"column\" gap={4}>\n          <Heading as=\"h3\">{t('payPeriodSectionTitle')}</Heading>\n          <Text variant=\"supporting\">{t('payPeriodSectionDescription')}</Text>\n        </Flex>\n        <OffCyclePayPeriodDateFormPresentation />\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <Flex flexDirection=\"column\" gap={20}>\n        <OffCycleReasonSelectionPresentation name=\"reason\" />\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <Flex flexDirection=\"column\" gap={12}>\n        <Heading as=\"h3\">{tEmployees('sectionTitle')}</Heading>\n        <SwitchField\n          name=\"includeAllEmployees\"\n          label={t('includeAllEmployeesLabel')}\n          onChange={handleToggleIncludeAll}\n        />\n        {!includeAllEmployees && (\n          <MultiSelectComboBoxField\n            name=\"selectedEmployeeUuids\"\n            label={tEmployees('sectionTitle')}\n            shouldVisuallyHideLabel\n            placeholder={tEmployees('searchPlaceholder')}\n            options={employees}\n          />\n        )}\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <Flex flexDirection=\"column\" gap={20}>\n        <RadioGroupField<boolean>\n          name=\"skipRegularDeductions\"\n          label={tDeductions('title')}\n          description={tDeductions('description')}\n          options={deductionsOptions}\n          convertValueToString={value => String(value)}\n        />\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <OffCycleTaxWithholdingTable\n        wageTypeGroups={wageTypeGroups}\n        config={taxWithholdingConfig}\n        onEditClick={onTaxWithholdingEditClick}\n      />\n      {isTaxWithholdingModalOpen && (\n        <OffCycleTaxWithholdingModal\n          isOpen\n          defaultConfig={taxWithholdingConfig}\n          onDone={onTaxWithholdingModalDone}\n          onCancel={onTaxWithholdingModalCancel}\n        />\n      )}\n\n      <Flex justifyContent=\"flex-end\" gap={12}>\n        <Button type=\"submit\" isLoading={isPending} isDisabled={isPending}>\n          {t('continueCta')}\n        </Button>\n      </Flex>\n    </Flex>\n  )\n}\n"],"names":["OffCycleCreationPresentation","employees","isPending","taxWithholdingConfig","isTaxWithholdingModalOpen","onTaxWithholdingEditClick","onTaxWithholdingModalDone","onTaxWithholdingModalCancel","useI18n","t","useTranslation","tDeductions","tEmployees","tWithholding","Heading","Text","Button","useComponentContext","wageTypeGroups","useMemo","WAGE_TYPE_CATEGORIES","category","group","setValue","watch","useFormContext","includeAllEmployees","handleToggleIncludeAll","useCallback","checked","deductionsOptions","jsxs","Flex","jsx","OffCyclePayPeriodDateFormPresentation","styles","OffCycleReasonSelectionPresentation","SwitchField","MultiSelectComboBoxField","RadioGroupField","value","OffCycleTaxWithholdingTable","OffCycleTaxWithholdingModal"],"mappings":"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"}
+{"version":3,"file":"OffCycleCreationPresentation.js","sources":["../../../../src/components/Payroll/OffCycleCreation/OffCycleCreationPresentation.tsx"],"sourcesContent":["import { useCallback, useMemo } from 'react'\nimport { useFormContext } from 'react-hook-form'\nimport { useTranslation } from 'react-i18next'\nimport { OffCycleReasonSelectionPresentation } from '../OffCycleReasonSelection'\nimport { OffCyclePayPeriodDateFormPresentation } from '../OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormPresentation'\nimport { OffCycleTaxWithholdingTable } from '../OffCycleTaxWithholdingTable'\nimport { OffCycleTaxWithholdingModal } from '../OffCycleTaxWithholdingModal'\nimport {\n  WAGE_TYPE_CATEGORIES,\n  type WageTypeGroup,\n} from '../OffCycleTaxWithholdingTable/OffCycleTaxWithholdingTableTypes'\nimport type {\n  OffCycleCreationFormData,\n  OffCycleCreationPresentationProps,\n} from './OffCycleCreationTypes'\nimport styles from './OffCycleCreationPresentation.module.scss'\nimport { useI18n } from '@/i18n'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { Flex, RadioGroupField, SwitchField, MultiSelectComboBoxField } from '@/components/Common'\n\n/** @internal */\nexport function OffCycleCreationPresentation({\n  employees,\n  isPending,\n  taxWithholdingConfig,\n  isTaxWithholdingModalOpen,\n  onTaxWithholdingEditClick,\n  onTaxWithholdingModalDone,\n  onTaxWithholdingModalCancel,\n}: OffCycleCreationPresentationProps) {\n  useI18n('Payroll.OffCycleCreation')\n  useI18n('Payroll.OffCycleDeductionsSetting')\n  useI18n('Payroll.EmployeeSelection')\n  useI18n('Payroll.OffCycleTaxWithholding')\n  const { t } = useTranslation('Payroll.OffCycleCreation')\n  const { t: tDeductions } = useTranslation('Payroll.OffCycleDeductionsSetting')\n  const { t: tEmployees } = useTranslation('Payroll.EmployeeSelection')\n  const { t: tWithholding } = useTranslation('Payroll.OffCycleTaxWithholding')\n  const { Heading, Text, Button } = useComponentContext()\n\n  const wageTypeGroups: WageTypeGroup[] = useMemo(\n    () =>\n      WAGE_TYPE_CATEGORIES.map(category => {\n        const group: WageTypeGroup = {\n          category,\n          label: tWithholding(`wageTypeGroups.${category}.label`),\n        }\n        if (category === 'regular' || category === 'supplemental') {\n          group.description = tWithholding(`wageTypeGroups.${category}.description`)\n        }\n        return group\n      }),\n    [tWithholding],\n  )\n\n  const { setValue, watch } = useFormContext<OffCycleCreationFormData>()\n  const includeAllEmployees = watch('includeAllEmployees')\n\n  const handleToggleIncludeAll = useCallback(\n    (checked: boolean) => {\n      if (checked) {\n        setValue('selectedEmployeeUuids', [])\n      }\n    },\n    [setValue],\n  )\n\n  const deductionsOptions = [\n    {\n      value: false,\n      label: tDeductions('options.include.label'),\n    },\n    {\n      value: true,\n      label: tDeductions('options.skip.label'),\n    },\n  ]\n\n  return (\n    <Flex flexDirection=\"column\" gap={32}>\n      <Flex flexDirection=\"column\" gap={4}>\n        <Heading as=\"h2\">{t('pageTitle')}</Heading>\n        <Text variant=\"supporting\">{t('pageDescription')}</Text>\n      </Flex>\n\n      <Flex flexDirection=\"column\" gap={20}>\n        <Flex flexDirection=\"column\" gap={4}>\n          <Heading as=\"h3\">{t('payPeriodSectionTitle')}</Heading>\n          <Text variant=\"supporting\">{t('payPeriodSectionDescription')}</Text>\n        </Flex>\n        <OffCyclePayPeriodDateFormPresentation />\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <Flex flexDirection=\"column\" gap={20}>\n        <OffCycleReasonSelectionPresentation name=\"reason\" />\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <Flex flexDirection=\"column\" gap={12}>\n        <Heading as=\"h3\">{tEmployees('sectionTitle')}</Heading>\n        <SwitchField\n          name=\"includeAllEmployees\"\n          label={t('includeAllEmployeesLabel')}\n          onChange={handleToggleIncludeAll}\n        />\n        {!includeAllEmployees && (\n          <MultiSelectComboBoxField\n            name=\"selectedEmployeeUuids\"\n            label={tEmployees('sectionTitle')}\n            shouldVisuallyHideLabel\n            placeholder={tEmployees('searchPlaceholder')}\n            options={employees}\n          />\n        )}\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <Flex flexDirection=\"column\" gap={20}>\n        <RadioGroupField<boolean>\n          name=\"skipRegularDeductions\"\n          label={tDeductions('title')}\n          description={tDeductions('description')}\n          options={deductionsOptions}\n          convertValueToString={value => String(value)}\n        />\n      </Flex>\n\n      <hr className={styles.divider} />\n\n      <OffCycleTaxWithholdingTable\n        wageTypeGroups={wageTypeGroups}\n        config={taxWithholdingConfig}\n        onEditClick={onTaxWithholdingEditClick}\n      />\n      {isTaxWithholdingModalOpen && (\n        <OffCycleTaxWithholdingModal\n          isOpen\n          defaultConfig={taxWithholdingConfig}\n          onDone={onTaxWithholdingModalDone}\n          onCancel={onTaxWithholdingModalCancel}\n        />\n      )}\n\n      <Flex justifyContent=\"flex-end\" gap={12}>\n        <Button type=\"submit\" isLoading={isPending} isDisabled={isPending}>\n          {t('continueCta')}\n        </Button>\n      </Flex>\n    </Flex>\n  )\n}\n"],"names":["OffCycleCreationPresentation","employees","isPending","taxWithholdingConfig","isTaxWithholdingModalOpen","onTaxWithholdingEditClick","onTaxWithholdingModalDone","onTaxWithholdingModalCancel","useI18n","t","useTranslation","tDeductions","tEmployees","tWithholding","Heading","Text","Button","useComponentContext","wageTypeGroups","useMemo","WAGE_TYPE_CATEGORIES","category","group","setValue","watch","useFormContext","includeAllEmployees","handleToggleIncludeAll","useCallback","checked","deductionsOptions","jsxs","Flex","jsx","OffCyclePayPeriodDateFormPresentation","styles","OffCycleReasonSelectionPresentation","SwitchField","MultiSelectComboBoxField","RadioGroupField","value","OffCycleTaxWithholdingTable","OffCycleTaxWithholdingModal"],"mappings":"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"}

package/dist/components/Payroll/OffCycleCreation/OffCycleCreationTypes.d.ts

@@ -3,22 +3,46 @@ import { OffCyclePayPeriodDateFormData, OffCyclePayrollDateType } from '../OffCy
 import { OffCycleTaxWithholdingConfig } from '../OffCycleTaxWithholdingTable/OffCycleTaxWithholdingTableTypes';
 import { MultiSelectComboBoxOption } from '../../Common/UI/MultiSelectComboBox/MultiSelectComboBoxTypes';
 import { BaseComponentInterface } from '../../Base/Base';
+/**
+ * Props for the {@link OffCycleCreation} component.
+ *
+ * @public
+ */
 export interface OffCycleCreationProps extends BaseComponentInterface<'Payroll.OffCycleCreation'> {
+    /** The associated company identifier. */
     companyId: string;
+    /** Pre-selected off-cycle reason. The creation form starts with this reason selected. Defaults to `'bonus'`. */
     payrollType?: OffCyclePayrollDateType;
 }
+/**
+ * Form values collected by the {@link OffCycleCreation} component.
+ *
+ * @public
+ */
 export interface OffCycleCreationFormData extends OffCyclePayPeriodDateFormData {
+    /** The off-cycle reason — `'bonus'` or `'correction'`. */
     reason: OffCycleReason;
+    /** When `true`, regular deductions are skipped for this payroll. */
     skipRegularDeductions: boolean;
+    /** When `true`, every onboarded active employee is included in the payroll. */
     includeAllEmployees: boolean;
+    /** Employee UUIDs to include. Only consulted when `includeAllEmployees` is `false`. */
     selectedEmployeeUuids: string[];
 }
+/** @internal */
 export interface OffCycleCreationPresentationProps {
+    /** Selectable employees rendered in the multi-select. */
     employees: MultiSelectComboBoxOption[];
+    /** Whether the off-cycle create mutation is in flight. */
     isPending?: boolean;
+    /** Current tax withholding configuration shown in the table. */
     taxWithholdingConfig: OffCycleTaxWithholdingConfig;
+    /** Whether the tax withholding edit modal is open. */
     isTaxWithholdingModalOpen: boolean;
+    /** Fires when the user clicks the edit affordance on the tax withholding table. */
     onTaxWithholdingEditClick: () => void;
+    /** Fires when the user confirms a new tax withholding configuration in the modal. */
     onTaxWithholdingModalDone: (config: OffCycleTaxWithholdingConfig) => void;
+    /** Fires when the user dismisses the tax withholding modal without saving. */
     onTaxWithholdingModalCancel: () => void;
 }

package/dist/components/Payroll/OffCycleCreation/index.d.ts

@@ -1,3 +1,3 @@
 import "./types/i18next.d.ts"
 export { OffCycleCreation } from './OffCycleCreation';
-export type { OffCycleCreationProps, OffCycleCreationFormData, OffCycleCreationPresentationProps, } from './OffCycleCreationTypes';
+export type { OffCycleCreationProps, OffCycleCreationFormData } from './OffCycleCreationTypes';

package/dist/components/Payroll/OffCycleDeductionsSetting/OffCycleDeductionsSetting.d.ts

@@ -1,2 +1,18 @@
 import { OffCycleDeductionsSettingProps } from './types';
+/**
+ * Radio control for choosing whether an off-cycle payroll skips regular deductions and contributions.
+ *
+ * @remarks
+ * Taxes are always included regardless of the selection. Selecting "Skip" blocks all regular
+ * deductions and contributions except 401(k); selecting "Include" runs all regular deductions
+ * and contributions normally.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `offCycle/deductionsChange` | Fired when the deduction preference changes | {@link OffCycleDeductionsSettingChangePayload} |
+ *
+ * @param props - {@link OffCycleDeductionsSettingProps}
+ * @returns The rendered radio group.
+ * @public
+ */
 export declare function OffCycleDeductionsSetting({ dictionary, skipRegularDeductions, onEvent, }: OffCycleDeductionsSettingProps): import("react").JSX.Element;

package/dist/components/Payroll/OffCycleDeductionsSetting/OffCycleDeductionsSetting.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCycleDeductionsSetting.js","sources":["../../../../src/components/Payroll/OffCycleDeductionsSetting/OffCycleDeductionsSetting.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport type { OffCycleDeductionsSettingProps } from './types'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ntype DeductionsValue = 'include' | 'skip'\n\nexport function OffCycleDeductionsSetting({\n  dictionary,\n  skipRegularDeductions,\n  onEvent,\n}: OffCycleDeductionsSettingProps) {\n  useComponentDictionary('Payroll.OffCycleDeductionsSetting', dictionary)\n  useI18n('Payroll.OffCycleDeductionsSetting')\n\n  const { t } = useTranslation('Payroll.OffCycleDeductionsSetting')\n  const { RadioGroup } = useComponentContext()\n\n  const options = useMemo(\n    () => [\n      {\n        value: 'include' as const,\n        label: t('options.include.label'),\n      },\n      {\n        value: 'skip' as const,\n        label: t('options.skip.label'),\n      },\n    ],\n    [t],\n  )\n\n  const handleChange = (value: string) => {\n    onEvent(componentEvents.OFF_CYCLE_DEDUCTIONS_CHANGE, {\n      skipRegularDeductions: value === 'skip',\n    })\n  }\n\n  const selectedValue: DeductionsValue = skipRegularDeductions ? 'skip' : 'include'\n\n  return (\n    <RadioGroup\n      label={t('title')}\n      description={t('description')}\n      options={options}\n      value={selectedValue}\n      onChange={handleChange}\n    />\n  )\n}\n"],"names":["OffCycleDeductionsSetting","dictionary","skipRegularDeductions","onEvent","useComponentDictionary","useI18n","t","useTranslation","RadioGroup","useComponentContext","options","useMemo","handleChange","value","componentEvents","selectedValue","jsx"],"mappings":";;;;;;AASO,SAASA,EAA0B;AAAA,EACxC,YAAAC;AAAA,EACA,uBAAAC;AAAA,EACA,SAAAC;AACF,GAAmC;AACjC,EAAAC,EAAuB,qCAAqCH,CAAU,GACtEI,EAAQ,mCAAmC;AAE3C,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,mCAAmC,GAC1D,EAAE,YAAAC,EAAA,IAAeC,EAAA,GAEjBC,IAAUC;AAAA,IACd,MAAM;AAAA,MACJ;AAAA,QACE,OAAO;AAAA,QACP,OAAOL,EAAE,uBAAuB;AAAA,MAAA;AAAA,MAElC;AAAA,QACE,OAAO;AAAA,QACP,OAAOA,EAAE,oBAAoB;AAAA,MAAA;AAAA,IAC/B;AAAA,IAEF,CAACA,CAAC;AAAA,EAAA,GAGEM,IAAe,CAACC,MAAkB;AACtC,IAAAV,EAAQW,EAAgB,6BAA6B;AAAA,MACnD,uBAAuBD,MAAU;AAAA,IAAA,CAClC;AAAA,EACH,GAEME,IAAiCb,IAAwB,SAAS;AAExE,SACE,gBAAAc;AAAA,IAACR;AAAA,IAAA;AAAA,MACC,OAAOF,EAAE,OAAO;AAAA,MAChB,aAAaA,EAAE,aAAa;AAAA,MAC5B,SAAAI;AAAA,MACA,OAAOK;AAAA,MACP,UAAUH;AAAA,IAAA;AAAA,EAAA;AAGhB;"}
+{"version":3,"file":"OffCycleDeductionsSetting.js","sources":["../../../../src/components/Payroll/OffCycleDeductionsSetting/OffCycleDeductionsSetting.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport type { OffCycleDeductionsSettingProps } from './types'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ntype DeductionsValue = 'include' | 'skip'\n\n/**\n * Radio control for choosing whether an off-cycle payroll skips regular deductions and contributions.\n *\n * @remarks\n * Taxes are always included regardless of the selection. Selecting \"Skip\" blocks all regular\n * deductions and contributions except 401(k); selecting \"Include\" runs all regular deductions\n * and contributions normally.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `offCycle/deductionsChange` | Fired when the deduction preference changes | {@link OffCycleDeductionsSettingChangePayload} |\n *\n * @param props - {@link OffCycleDeductionsSettingProps}\n * @returns The rendered radio group.\n * @public\n */\nexport function OffCycleDeductionsSetting({\n  dictionary,\n  skipRegularDeductions,\n  onEvent,\n}: OffCycleDeductionsSettingProps) {\n  useComponentDictionary('Payroll.OffCycleDeductionsSetting', dictionary)\n  useI18n('Payroll.OffCycleDeductionsSetting')\n\n  const { t } = useTranslation('Payroll.OffCycleDeductionsSetting')\n  const { RadioGroup } = useComponentContext()\n\n  const options = useMemo(\n    () => [\n      {\n        value: 'include' as const,\n        label: t('options.include.label'),\n      },\n      {\n        value: 'skip' as const,\n        label: t('options.skip.label'),\n      },\n    ],\n    [t],\n  )\n\n  const handleChange = (value: string) => {\n    onEvent(componentEvents.OFF_CYCLE_DEDUCTIONS_CHANGE, {\n      skipRegularDeductions: value === 'skip',\n    })\n  }\n\n  const selectedValue: DeductionsValue = skipRegularDeductions ? 'skip' : 'include'\n\n  return (\n    <RadioGroup\n      label={t('title')}\n      description={t('description')}\n      options={options}\n      value={selectedValue}\n      onChange={handleChange}\n    />\n  )\n}\n"],"names":["OffCycleDeductionsSetting","dictionary","skipRegularDeductions","onEvent","useComponentDictionary","useI18n","t","useTranslation","RadioGroup","useComponentContext","options","useMemo","handleChange","value","componentEvents","selectedValue","jsx"],"mappings":";;;;;;AAyBO,SAASA,EAA0B;AAAA,EACxC,YAAAC;AAAA,EACA,uBAAAC;AAAA,EACA,SAAAC;AACF,GAAmC;AACjC,EAAAC,EAAuB,qCAAqCH,CAAU,GACtEI,EAAQ,mCAAmC;AAE3C,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,mCAAmC,GAC1D,EAAE,YAAAC,EAAA,IAAeC,EAAA,GAEjBC,IAAUC;AAAA,IACd,MAAM;AAAA,MACJ;AAAA,QACE,OAAO;AAAA,QACP,OAAOL,EAAE,uBAAuB;AAAA,MAAA;AAAA,MAElC;AAAA,QACE,OAAO;AAAA,QACP,OAAOA,EAAE,oBAAoB;AAAA,MAAA;AAAA,IAC/B;AAAA,IAEF,CAACA,CAAC;AAAA,EAAA,GAGEM,IAAe,CAACC,MAAkB;AACtC,IAAAV,EAAQW,EAAgB,6BAA6B;AAAA,MACnD,uBAAuBD,MAAU;AAAA,IAAA,CAClC;AAAA,EACH,GAEME,IAAiCb,IAAwB,SAAS;AAExE,SACE,gBAAAc;AAAA,IAACR;AAAA,IAAA;AAAA,MACC,OAAOF,EAAE,OAAO;AAAA,MAChB,aAAaA,EAAE,aAAa;AAAA,MAC5B,SAAAI;AAAA,MACA,OAAOK;AAAA,MACP,UAAUH;AAAA,IAAA;AAAA,EAAA;AAGhB;"}

package/dist/components/Payroll/OffCycleDeductionsSetting/types.d.ts

@@ -1,10 +1,23 @@
 import { CommonComponentInterface } from '../../Base/Base';
 import { OnEventType } from '../../Base/useBase';
 import { EventType } from '../../../shared/constants';
+/**
+ * Props for {@link OffCycleDeductionsSetting}.
+ *
+ * @public
+ */
 export interface OffCycleDeductionsSettingProps extends CommonComponentInterface<'Payroll.OffCycleDeductionsSetting'> {
+    /** Whether regular deductions are currently being skipped. */
     skipRegularDeductions: boolean;
+    /** Event handler invoked when the deduction preference changes. See the events table on {@link OffCycleDeductionsSetting}. */
     onEvent: OnEventType<EventType, unknown>;
 }
+/**
+ * Payload emitted by {@link OffCycleDeductionsSetting} on the `offCycle/deductionsChange` event.
+ *
+ * @public
+ */
 export interface OffCycleDeductionsSettingChangePayload {
+    /** Whether the user selected to skip regular deductions. */
     skipRegularDeductions: boolean;
 }

package/dist/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormPresentation.d.ts

@@ -1 +1,2 @@
+/** @internal */
 export declare function OffCyclePayPeriodDateFormPresentation(): import("react").JSX.Element;

package/dist/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormPresentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCyclePayPeriodDateFormPresentation.js","sources":["../../../../src/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormPresentation.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport styles from './OffCyclePayPeriodDateFormPresentation.module.scss'\nimport { useI18n } from '@/i18n'\nimport { CheckboxField, DatePickerField } from '@/components/Common'\n\nexport function OffCyclePayPeriodDateFormPresentation() {\n  useI18n('Payroll.OffCyclePayPeriodDateForm')\n  const { t } = useTranslation('Payroll.OffCyclePayPeriodDateForm')\n\n  return (\n    <div className={styles.root}>\n      <div className={styles.dateFields}>\n        <DatePickerField name=\"startDate\" label={t('startDateLabel')} isRequired />\n        <DatePickerField name=\"endDate\" label={t('endDateLabel')} isRequired />\n      </div>\n\n      <div className={styles.checkDateField}>\n        <DatePickerField name=\"checkDate\" label={t('checkDateLabel')} isRequired />\n      </div>\n\n      <CheckboxField\n        name=\"isCheckOnly\"\n        label={t('checkOnlyLabel')}\n        description={t('checkOnlyDescription')}\n      />\n    </div>\n  )\n}\n"],"names":["OffCyclePayPeriodDateFormPresentation","useI18n","t","useTranslation","jsxs","styles","jsx","DatePickerField","CheckboxField"],"mappings":";;;;;;;;AAKO,SAASA,IAAwC;AACtD,EAAAC,EAAQ,mCAAmC;AAC3C,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,mCAAmC;AAEhE,SACE,gBAAAC,EAAC,OAAA,EAAI,WAAWC,EAAO,MACrB,UAAA;AAAA,IAAA,gBAAAD,EAAC,OAAA,EAAI,WAAWC,EAAO,YACrB,UAAA;AAAA,MAAA,gBAAAC,EAACC,GAAA,EAAgB,MAAK,aAAY,OAAOL,EAAE,gBAAgB,GAAG,YAAU,IAAC;AAAA,MACzE,gBAAAI,EAACC,KAAgB,MAAK,WAAU,OAAOL,EAAE,cAAc,GAAG,YAAU,GAAA,CAAC;AAAA,IAAA,GACvE;AAAA,IAEA,gBAAAI,EAAC,OAAA,EAAI,WAAWD,EAAO,gBACrB,UAAA,gBAAAC,EAACC,GAAA,EAAgB,MAAK,aAAY,OAAOL,EAAE,gBAAgB,GAAG,YAAU,IAAC,GAC3E;AAAA,IAEA,gBAAAI;AAAA,MAACE;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,OAAON,EAAE,gBAAgB;AAAA,QACzB,aAAaA,EAAE,sBAAsB;AAAA,MAAA;AAAA,IAAA;AAAA,EACvC,GACF;AAEJ;"}
+{"version":3,"file":"OffCyclePayPeriodDateFormPresentation.js","sources":["../../../../src/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormPresentation.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport styles from './OffCyclePayPeriodDateFormPresentation.module.scss'\nimport { useI18n } from '@/i18n'\nimport { CheckboxField, DatePickerField } from '@/components/Common'\n\n/** @internal */\nexport function OffCyclePayPeriodDateFormPresentation() {\n  useI18n('Payroll.OffCyclePayPeriodDateForm')\n  const { t } = useTranslation('Payroll.OffCyclePayPeriodDateForm')\n\n  return (\n    <div className={styles.root}>\n      <div className={styles.dateFields}>\n        <DatePickerField name=\"startDate\" label={t('startDateLabel')} isRequired />\n        <DatePickerField name=\"endDate\" label={t('endDateLabel')} isRequired />\n      </div>\n\n      <div className={styles.checkDateField}>\n        <DatePickerField name=\"checkDate\" label={t('checkDateLabel')} isRequired />\n      </div>\n\n      <CheckboxField\n        name=\"isCheckOnly\"\n        label={t('checkOnlyLabel')}\n        description={t('checkOnlyDescription')}\n      />\n    </div>\n  )\n}\n"],"names":["OffCyclePayPeriodDateFormPresentation","useI18n","t","useTranslation","jsxs","styles","jsx","DatePickerField","CheckboxField"],"mappings":";;;;;;;;AAMO,SAASA,IAAwC;AACtD,EAAAC,EAAQ,mCAAmC;AAC3C,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,mCAAmC;AAEhE,SACE,gBAAAC,EAAC,OAAA,EAAI,WAAWC,EAAO,MACrB,UAAA;AAAA,IAAA,gBAAAD,EAAC,OAAA,EAAI,WAAWC,EAAO,YACrB,UAAA;AAAA,MAAA,gBAAAC,EAACC,GAAA,EAAgB,MAAK,aAAY,OAAOL,EAAE,gBAAgB,GAAG,YAAU,IAAC;AAAA,MACzE,gBAAAI,EAACC,KAAgB,MAAK,WAAU,OAAOL,EAAE,cAAc,GAAG,YAAU,GAAA,CAAC;AAAA,IAAA,GACvE;AAAA,IAEA,gBAAAI,EAAC,OAAA,EAAI,WAAWD,EAAO,gBACrB,UAAA,gBAAAC,EAACC,GAAA,EAAgB,MAAK,aAAY,OAAOL,EAAE,gBAAgB,GAAG,YAAU,IAAC,GAC3E;AAAA,IAEA,gBAAAI;AAAA,MAACE;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,OAAON,EAAE,gBAAgB;AAAA,QACzB,aAAaA,EAAE,sBAAsB;AAAA,MAAA;AAAA,IAAA;AAAA,EACvC,GACF;AAEJ;"}

package/dist/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormTypes.d.ts

@@ -1,15 +1,32 @@
 import { z } from 'zod';
+/**
+ * Off-cycle payroll reason that drives pay-period date validation rules.
+ *
+ * @remarks
+ * `'bonus'` is used for paying a bonus, gift, or commission. `'correction'` is used for running a correction payment and constrains the start date to today or earlier.
+ *
+ * @public
+ */
 export type OffCyclePayrollDateType = 'bonus' | 'correction';
+/**
+ * Pay-period date selections collected for an off-cycle payroll.
+ *
+ * @public
+ */
 export interface OffCyclePayPeriodDateFormData {
+    /** When true, all employees are paid by check rather than direct deposit; start and end dates become optional and the check date may be today or any future date. */
     isCheckOnly: boolean;
+    /** Beginning of the pay period; required unless `isCheckOnly` is true, and cannot be in the future when the payroll type is `'correction'`. */
     startDate: Date | null;
+    /** End of the pay period; required unless `isCheckOnly` is true, and must be on or after `startDate`. */
     endDate: Date | null;
+    /** Date employees will be paid; must be at least the company's ACH lead time of business days from today for direct deposit, unless `isCheckOnly` is true. */
     checkDate: Date | null;
 }
+/** @internal */
 export declare const createOffCyclePayPeriodDateFormSchema: (t: (key: string, options?: Record<string, unknown>) => string, payrollType: OffCyclePayrollDateType, minCheckDate: Date, paymentSpeedDays?: number) => z.ZodObject<{
     isCheckOnly: z.ZodBoolean;
     startDate: z.ZodNullable<z.ZodDate>;
     endDate: z.ZodNullable<z.ZodDate>;
     checkDate: z.ZodNullable<z.ZodDate>;
 }, z.core.$strip>;
-export type OffCyclePayPeriodDateFormSchema = ReturnType<typeof createOffCyclePayPeriodDateFormSchema>;

package/dist/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCyclePayPeriodDateFormTypes.js","sources":["../../../../src/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormTypes.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport type OffCyclePayrollDateType = 'bonus' | 'correction'\n\nexport interface OffCyclePayPeriodDateFormData {\n  isCheckOnly: boolean\n  startDate: Date | null\n  endDate: Date | null\n  checkDate: Date | null\n}\n\nexport const createOffCyclePayPeriodDateFormSchema = (\n  t: (key: string, options?: Record<string, unknown>) => string,\n  payrollType: OffCyclePayrollDateType,\n  minCheckDate: Date,\n  paymentSpeedDays?: number,\n) => {\n  return z\n    .object({\n      isCheckOnly: z.boolean(),\n      startDate: z.date().nullable(),\n      endDate: z.date().nullable(),\n      checkDate: z.date().nullable(),\n    })\n    .superRefine((data, ctx) => {\n      if (!data.startDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['startDate'],\n          message: t('validations.startDateRequired'),\n        })\n      }\n\n      if (!data.endDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['endDate'],\n          message: t('validations.endDateRequired'),\n        })\n      }\n\n      if (data.startDate && data.endDate && data.endDate < data.startDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['endDate'],\n          message: t('validations.endDateAfterStart'),\n        })\n      }\n\n      if (payrollType === 'correction' && data.startDate) {\n        const today = new Date()\n        today.setHours(0, 0, 0, 0)\n        if (data.startDate > today) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['startDate'],\n            message: t('validations.startDateNotFuture'),\n          })\n        }\n      }\n\n      if (!data.checkDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['checkDate'],\n          message: t('validations.checkDateRequired'),\n        })\n      } else {\n        const checkDateNormalized = new Date(data.checkDate)\n        checkDateNormalized.setHours(0, 0, 0, 0)\n        const minCheckDateNormalized = new Date(minCheckDate)\n        minCheckDateNormalized.setHours(0, 0, 0, 0)\n\n        if (checkDateNormalized < minCheckDateNormalized) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['checkDate'],\n            message: data.isCheckOnly\n              ? t('validations.checkDateNotPast')\n              : t('validations.checkDateAchLeadTime', { count: paymentSpeedDays ?? 2 }),\n          })\n        }\n      }\n    })\n}\n\nexport type OffCyclePayPeriodDateFormSchema = ReturnType<\n  typeof createOffCyclePayPeriodDateFormSchema\n>\n"],"names":["createOffCyclePayPeriodDateFormSchema","t","payrollType","minCheckDate","paymentSpeedDays","z","data","ctx","today","checkDateNormalized","minCheckDateNormalized"],"mappings":";AAWO,MAAMA,IAAwC,CACnDC,GACAC,GACAC,GACAC,MAEOC,EACJ,OAAO;AAAA,EACN,aAAaA,EAAE,QAAA;AAAA,EACf,WAAWA,EAAE,KAAA,EAAO,SAAA;AAAA,EACpB,SAASA,EAAE,KAAA,EAAO,SAAA;AAAA,EAClB,WAAWA,EAAE,KAAA,EAAO,SAAA;AAAS,CAC9B,EACA,YAAY,CAACC,GAAMC,MAAQ;AAyB1B,MAxBKD,EAAK,aACRC,EAAI,SAAS;AAAA,IACX,MAAMF,EAAE,aAAa;AAAA,IACrB,MAAM,CAAC,WAAW;AAAA,IAClB,SAASJ,EAAE,+BAA+B;AAAA,EAAA,CAC3C,GAGEK,EAAK,WACRC,EAAI,SAAS;AAAA,IACX,MAAMF,EAAE,aAAa;AAAA,IACrB,MAAM,CAAC,SAAS;AAAA,IAChB,SAASJ,EAAE,6BAA6B;AAAA,EAAA,CACzC,GAGCK,EAAK,aAAaA,EAAK,WAAWA,EAAK,UAAUA,EAAK,aACxDC,EAAI,SAAS;AAAA,IACX,MAAMF,EAAE,aAAa;AAAA,IACrB,MAAM,CAAC,SAAS;AAAA,IAChB,SAASJ,EAAE,+BAA+B;AAAA,EAAA,CAC3C,GAGCC,MAAgB,gBAAgBI,EAAK,WAAW;AAClD,UAAME,wBAAY,KAAA;AAClB,IAAAA,EAAM,SAAS,GAAG,GAAG,GAAG,CAAC,GACrBF,EAAK,YAAYE,KACnBD,EAAI,SAAS;AAAA,MACX,MAAMF,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,WAAW;AAAA,MAClB,SAASJ,EAAE,gCAAgC;AAAA,IAAA,CAC5C;AAAA,EAEL;AAEA,MAAI,CAACK,EAAK;AACR,IAAAC,EAAI,SAAS;AAAA,MACX,MAAMF,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,WAAW;AAAA,MAClB,SAASJ,EAAE,+BAA+B;AAAA,IAAA,CAC3C;AAAA,OACI;AACL,UAAMQ,IAAsB,IAAI,KAAKH,EAAK,SAAS;AACnD,IAAAG,EAAoB,SAAS,GAAG,GAAG,GAAG,CAAC;AACvC,UAAMC,IAAyB,IAAI,KAAKP,CAAY;AACpD,IAAAO,EAAuB,SAAS,GAAG,GAAG,GAAG,CAAC,GAEtCD,IAAsBC,KACxBH,EAAI,SAAS;AAAA,MACX,MAAMF,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,WAAW;AAAA,MAClB,SAASC,EAAK,cACVL,EAAE,8BAA8B,IAChCA,EAAE,oCAAoC,EAAE,OAAOG,KAAoB,EAAA,CAAG;AAAA,IAAA,CAC3E;AAAA,EAEL;AACF,CAAC;"}
+{"version":3,"file":"OffCyclePayPeriodDateFormTypes.js","sources":["../../../../src/components/Payroll/OffCyclePayPeriodDateForm/OffCyclePayPeriodDateFormTypes.ts"],"sourcesContent":["import { z } from 'zod'\n\n/**\n * Off-cycle payroll reason that drives pay-period date validation rules.\n *\n * @remarks\n * `'bonus'` is used for paying a bonus, gift, or commission. `'correction'` is used for running a correction payment and constrains the start date to today or earlier.\n *\n * @public\n */\nexport type OffCyclePayrollDateType = 'bonus' | 'correction'\n\n/**\n * Pay-period date selections collected for an off-cycle payroll.\n *\n * @public\n */\nexport interface OffCyclePayPeriodDateFormData {\n  /** When true, all employees are paid by check rather than direct deposit; start and end dates become optional and the check date may be today or any future date. */\n  isCheckOnly: boolean\n  /** Beginning of the pay period; required unless `isCheckOnly` is true, and cannot be in the future when the payroll type is `'correction'`. */\n  startDate: Date | null\n  /** End of the pay period; required unless `isCheckOnly` is true, and must be on or after `startDate`. */\n  endDate: Date | null\n  /** Date employees will be paid; must be at least the company's ACH lead time of business days from today for direct deposit, unless `isCheckOnly` is true. */\n  checkDate: Date | null\n}\n\n/** @internal */\nexport const createOffCyclePayPeriodDateFormSchema = (\n  t: (key: string, options?: Record<string, unknown>) => string,\n  payrollType: OffCyclePayrollDateType,\n  minCheckDate: Date,\n  paymentSpeedDays?: number,\n) => {\n  return z\n    .object({\n      isCheckOnly: z.boolean(),\n      startDate: z.date().nullable(),\n      endDate: z.date().nullable(),\n      checkDate: z.date().nullable(),\n    })\n    .superRefine((data, ctx) => {\n      if (!data.startDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['startDate'],\n          message: t('validations.startDateRequired'),\n        })\n      }\n\n      if (!data.endDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['endDate'],\n          message: t('validations.endDateRequired'),\n        })\n      }\n\n      if (data.startDate && data.endDate && data.endDate < data.startDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['endDate'],\n          message: t('validations.endDateAfterStart'),\n        })\n      }\n\n      if (payrollType === 'correction' && data.startDate) {\n        const today = new Date()\n        today.setHours(0, 0, 0, 0)\n        if (data.startDate > today) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['startDate'],\n            message: t('validations.startDateNotFuture'),\n          })\n        }\n      }\n\n      if (!data.checkDate) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['checkDate'],\n          message: t('validations.checkDateRequired'),\n        })\n      } else {\n        const checkDateNormalized = new Date(data.checkDate)\n        checkDateNormalized.setHours(0, 0, 0, 0)\n        const minCheckDateNormalized = new Date(minCheckDate)\n        minCheckDateNormalized.setHours(0, 0, 0, 0)\n\n        if (checkDateNormalized < minCheckDateNormalized) {\n          ctx.addIssue({\n            code: z.ZodIssueCode.custom,\n            path: ['checkDate'],\n            message: data.isCheckOnly\n              ? t('validations.checkDateNotPast')\n              : t('validations.checkDateAchLeadTime', { count: paymentSpeedDays ?? 2 }),\n          })\n        }\n      }\n    })\n}\n"],"names":["createOffCyclePayPeriodDateFormSchema","t","payrollType","minCheckDate","paymentSpeedDays","z","data","ctx","today","checkDateNormalized","minCheckDateNormalized"],"mappings":";AA6BO,MAAMA,IAAwC,CACnDC,GACAC,GACAC,GACAC,MAEOC,EACJ,OAAO;AAAA,EACN,aAAaA,EAAE,QAAA;AAAA,EACf,WAAWA,EAAE,KAAA,EAAO,SAAA;AAAA,EACpB,SAASA,EAAE,KAAA,EAAO,SAAA;AAAA,EAClB,WAAWA,EAAE,KAAA,EAAO,SAAA;AAAS,CAC9B,EACA,YAAY,CAACC,GAAMC,MAAQ;AAyB1B,MAxBKD,EAAK,aACRC,EAAI,SAAS;AAAA,IACX,MAAMF,EAAE,aAAa;AAAA,IACrB,MAAM,CAAC,WAAW;AAAA,IAClB,SAASJ,EAAE,+BAA+B;AAAA,EAAA,CAC3C,GAGEK,EAAK,WACRC,EAAI,SAAS;AAAA,IACX,MAAMF,EAAE,aAAa;AAAA,IACrB,MAAM,CAAC,SAAS;AAAA,IAChB,SAASJ,EAAE,6BAA6B;AAAA,EAAA,CACzC,GAGCK,EAAK,aAAaA,EAAK,WAAWA,EAAK,UAAUA,EAAK,aACxDC,EAAI,SAAS;AAAA,IACX,MAAMF,EAAE,aAAa;AAAA,IACrB,MAAM,CAAC,SAAS;AAAA,IAChB,SAASJ,EAAE,+BAA+B;AAAA,EAAA,CAC3C,GAGCC,MAAgB,gBAAgBI,EAAK,WAAW;AAClD,UAAME,wBAAY,KAAA;AAClB,IAAAA,EAAM,SAAS,GAAG,GAAG,GAAG,CAAC,GACrBF,EAAK,YAAYE,KACnBD,EAAI,SAAS;AAAA,MACX,MAAMF,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,WAAW;AAAA,MAClB,SAASJ,EAAE,gCAAgC;AAAA,IAAA,CAC5C;AAAA,EAEL;AAEA,MAAI,CAACK,EAAK;AACR,IAAAC,EAAI,SAAS;AAAA,MACX,MAAMF,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,WAAW;AAAA,MAClB,SAASJ,EAAE,+BAA+B;AAAA,IAAA,CAC3C;AAAA,OACI;AACL,UAAMQ,IAAsB,IAAI,KAAKH,EAAK,SAAS;AACnD,IAAAG,EAAoB,SAAS,GAAG,GAAG,GAAG,CAAC;AACvC,UAAMC,IAAyB,IAAI,KAAKP,CAAY;AACpD,IAAAO,EAAuB,SAAS,GAAG,GAAG,GAAG,CAAC,GAEtCD,IAAsBC,KACxBH,EAAI,SAAS;AAAA,MACX,MAAMF,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,WAAW;AAAA,MAClB,SAASC,EAAK,cACVL,EAAE,8BAA8B,IAChCA,EAAE,oCAAoC,EAAE,OAAOG,KAAoB,EAAA,CAAG;AAAA,IAAA,CAC3E;AAAA,EAEL;AACF,CAAC;"}

package/dist/components/Payroll/OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation.d.ts

@@ -1,4 +1,4 @@
-export declare const DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS = 2;
+/** @internal */
 export declare function useOffCyclePayPeriodDateValidation(paymentSpeedDays?: number): {
     today: Date;
     minCheckDate: Date;

package/dist/components/Payroll/OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation.js

@@ -13,7 +13,6 @@ function a(o = i) {
   };
 }
 export {
-  i as DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS,
   a as useOffCyclePayPeriodDateValidation
 };
 //# sourceMappingURL=useOffCyclePayPeriodDateValidation.js.map

package/dist/components/Payroll/OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOffCyclePayPeriodDateValidation.js","sources":["../../../../src/components/Payroll/OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation.ts"],"sourcesContent":["import { useMemo } from 'react'\nimport { addBusinessDays } from '@/helpers/dateFormatting'\n\nexport const DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS = 2\n\nexport function useOffCyclePayPeriodDateValidation(\n  paymentSpeedDays = DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS,\n) {\n  const today = useMemo(() => {\n    const now = new Date()\n    now.setHours(0, 0, 0, 0)\n    return now\n  }, [])\n\n  const minCheckDate = useMemo(() => {\n    return addBusinessDays(today, paymentSpeedDays)\n  }, [today, paymentSpeedDays])\n\n  return {\n    today,\n    minCheckDate,\n    paymentSpeedDays,\n  }\n}\n"],"names":["DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS","useOffCyclePayPeriodDateValidation","paymentSpeedDays","today","useMemo","now","minCheckDate","addBusinessDays"],"mappings":";;AAGO,MAAMA,IAAsC;AAE5C,SAASC,EACdC,IAAmBF,GACnB;AACA,QAAMG,IAAQC,EAAQ,MAAM;AAC1B,UAAMC,wBAAU,KAAA;AAChB,WAAAA,EAAI,SAAS,GAAG,GAAG,GAAG,CAAC,GAChBA;AAAA,EACT,GAAG,CAAA,CAAE,GAECC,IAAeF,EAAQ,MACpBG,EAAgBJ,GAAOD,CAAgB,GAC7C,CAACC,GAAOD,CAAgB,CAAC;AAE5B,SAAO;AAAA,IACL,OAAAC;AAAA,IACA,cAAAG;AAAA,IACA,kBAAAJ;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useOffCyclePayPeriodDateValidation.js","sources":["../../../../src/components/Payroll/OffCyclePayPeriodDateForm/useOffCyclePayPeriodDateValidation.ts"],"sourcesContent":["import { useMemo } from 'react'\nimport { addBusinessDays } from '@/helpers/dateFormatting'\n\nconst DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS = 2\n\n/** @internal */\nexport function useOffCyclePayPeriodDateValidation(\n  paymentSpeedDays = DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS,\n) {\n  const today = useMemo(() => {\n    const now = new Date()\n    now.setHours(0, 0, 0, 0)\n    return now\n  }, [])\n\n  const minCheckDate = useMemo(() => {\n    return addBusinessDays(today, paymentSpeedDays)\n  }, [today, paymentSpeedDays])\n\n  return {\n    today,\n    minCheckDate,\n    paymentSpeedDays,\n  }\n}\n"],"names":["DEFAULT_ACH_LEAD_TIME_BUSINESS_DAYS","useOffCyclePayPeriodDateValidation","paymentSpeedDays","today","useMemo","now","minCheckDate","addBusinessDays"],"mappings":";;AAGA,MAAMA,IAAsC;AAGrC,SAASC,EACdC,IAAmBF,GACnB;AACA,QAAMG,IAAQC,EAAQ,MAAM;AAC1B,UAAMC,wBAAU,KAAA;AAChB,WAAAA,EAAI,SAAS,GAAG,GAAG,GAAG,CAAC,GAChBA;AAAA,EACT,GAAG,CAAA,CAAE,GAECC,IAAeF,EAAQ,MACpBG,EAAgBJ,GAAOD,CAAgB,GAC7C,CAACC,GAAOD,CAAgB,CAAC;AAE5B,SAAO;AAAA,IACL,OAAAC;AAAA,IACA,cAAAG;AAAA,IACA,kBAAAJ;AAAA,EAAA;AAEJ;"}

package/dist/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelection.d.ts

@@ -1,2 +1,17 @@
 import { OffCycleReasonSelectionProps } from './types';
+/**
+ * Presents the reason selection UI for choosing between a bonus and correction off-cycle payment.
+ *
+ * @remarks
+ * Selecting a reason emits the recommended deduction and withholding defaults alongside the chosen value
+ * so a surrounding form can update its state to match.
+ *
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `offCycle/selectReason` | Fired when the user selects a reason | {@link SelectReasonPayload} |
+ *
+ * @param props - Component props including `companyId` and standard `onEvent`/`dictionary` handlers.
+ * @returns The rendered reason selection UI.
+ * @public
+ */
 export declare function OffCycleReasonSelection(props: OffCycleReasonSelectionProps): import("react").JSX.Element;

package/dist/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelection.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCycleReasonSelection.js","sources":["../../../../src/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelection.tsx"],"sourcesContent":["import { useCallback } from 'react'\nimport { FormProvider, useForm } from 'react-hook-form'\nimport { OffCycleReasonSelectionPresentation } from './OffCycleReasonSelectionPresentation'\nimport {\n  OFF_CYCLE_REASON_DEFAULTS,\n  type OffCycleReason,\n  type OffCycleReasonSelectionProps,\n} from './types'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\n\nexport function OffCycleReasonSelection(props: OffCycleReasonSelectionProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ dictionary }: OffCycleReasonSelectionProps) {\n  useComponentDictionary('Payroll.OffCycleReasonSelection', dictionary)\n  useI18n('Payroll.OffCycleReasonSelection')\n\n  const { onEvent } = useBase()\n  const methods = useForm<{ reason: OffCycleReason | '' }>({\n    defaultValues: { reason: '' },\n  })\n\n  const handleReasonChange = useCallback(\n    (reason: OffCycleReason) => {\n      const defaults = OFF_CYCLE_REASON_DEFAULTS[reason]\n      onEvent(componentEvents.OFF_CYCLE_SELECT_REASON, {\n        reason,\n        defaults,\n      })\n    },\n    [onEvent],\n  )\n\n  return (\n    <FormProvider {...methods}>\n      <OffCycleReasonSelectionPresentation name=\"reason\" onChange={handleReasonChange} />\n    </FormProvider>\n  )\n}\n"],"names":["OffCycleReasonSelection","props","jsx","BaseComponent","Root","dictionary","useComponentDictionary","useI18n","onEvent","useBase","methods","useForm","handleReasonChange","useCallback","reason","defaults","OFF_CYCLE_REASON_DEFAULTS","componentEvents","FormProvider","OffCycleReasonSelectionPresentation"],"mappings":";;;;;;;;;AAaO,SAASA,EAAwBC,GAAqC;AAC3E,SACE,gBAAAC,EAACC,KAAe,GAAGF,GACjB,4BAACG,GAAA,EAAM,GAAGH,GAAO,EAAA,CACnB;AAEJ;AAEA,SAASG,EAAK,EAAE,YAAAC,KAA4C;AAC1D,EAAAC,EAAuB,mCAAmCD,CAAU,GACpEE,EAAQ,iCAAiC;AAEzC,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GACdC,IAAUC,EAAyC;AAAA,IACvD,eAAe,EAAE,QAAQ,GAAA;AAAA,EAAG,CAC7B,GAEKC,IAAqBC;AAAA,IACzB,CAACC,MAA2B;AAC1B,YAAMC,IAAWC,EAA0BF,CAAM;AACjD,MAAAN,EAAQS,EAAgB,yBAAyB;AAAA,QAC/C,QAAAH;AAAA,QACA,UAAAC;AAAA,MAAA,CACD;AAAA,IACH;AAAA,IACA,CAACP,CAAO;AAAA,EAAA;AAGV,SACE,gBAAAN,EAACgB,GAAA,EAAc,GAAGR,GAChB,UAAA,gBAAAR,EAACiB,KAAoC,MAAK,UAAS,UAAUP,EAAA,CAAoB,EAAA,CACnF;AAEJ;"}
+{"version":3,"file":"OffCycleReasonSelection.js","sources":["../../../../src/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelection.tsx"],"sourcesContent":["import { useCallback } from 'react'\nimport { FormProvider, useForm } from 'react-hook-form'\nimport { OffCycleReasonSelectionPresentation } from './OffCycleReasonSelectionPresentation'\nimport {\n  OFF_CYCLE_REASON_DEFAULTS,\n  type OffCycleReason,\n  type OffCycleReasonSelectionProps,\n} from './types'\nimport { BaseComponent } from '@/components/Base/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { useComponentDictionary, useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\n\n/**\n * Presents the reason selection UI for choosing between a bonus and correction off-cycle payment.\n *\n * @remarks\n * Selecting a reason emits the recommended deduction and withholding defaults alongside the chosen value\n * so a surrounding form can update its state to match.\n *\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `offCycle/selectReason` | Fired when the user selects a reason | {@link SelectReasonPayload} |\n *\n * @param props - Component props including `companyId` and standard `onEvent`/`dictionary` handlers.\n * @returns The rendered reason selection UI.\n * @public\n */\nexport function OffCycleReasonSelection(props: OffCycleReasonSelectionProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ dictionary }: OffCycleReasonSelectionProps) {\n  useComponentDictionary('Payroll.OffCycleReasonSelection', dictionary)\n  useI18n('Payroll.OffCycleReasonSelection')\n\n  const { onEvent } = useBase()\n  const methods = useForm<{ reason: OffCycleReason | '' }>({\n    defaultValues: { reason: '' },\n  })\n\n  const handleReasonChange = useCallback(\n    (reason: OffCycleReason) => {\n      const defaults = OFF_CYCLE_REASON_DEFAULTS[reason]\n      onEvent(componentEvents.OFF_CYCLE_SELECT_REASON, {\n        reason,\n        defaults,\n      })\n    },\n    [onEvent],\n  )\n\n  return (\n    <FormProvider {...methods}>\n      <OffCycleReasonSelectionPresentation name=\"reason\" onChange={handleReasonChange} />\n    </FormProvider>\n  )\n}\n"],"names":["OffCycleReasonSelection","props","jsx","BaseComponent","Root","dictionary","useComponentDictionary","useI18n","onEvent","useBase","methods","useForm","handleReasonChange","useCallback","reason","defaults","OFF_CYCLE_REASON_DEFAULTS","componentEvents","FormProvider","OffCycleReasonSelectionPresentation"],"mappings":";;;;;;;;;AA4BO,SAASA,EAAwBC,GAAqC;AAC3E,SACE,gBAAAC,EAACC,KAAe,GAAGF,GACjB,4BAACG,GAAA,EAAM,GAAGH,GAAO,EAAA,CACnB;AAEJ;AAEA,SAASG,EAAK,EAAE,YAAAC,KAA4C;AAC1D,EAAAC,EAAuB,mCAAmCD,CAAU,GACpEE,EAAQ,iCAAiC;AAEzC,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GACdC,IAAUC,EAAyC;AAAA,IACvD,eAAe,EAAE,QAAQ,GAAA;AAAA,EAAG,CAC7B,GAEKC,IAAqBC;AAAA,IACzB,CAACC,MAA2B;AAC1B,YAAMC,IAAWC,EAA0BF,CAAM;AACjD,MAAAN,EAAQS,EAAgB,yBAAyB;AAAA,QAC/C,QAAAH;AAAA,QACA,UAAAC;AAAA,MAAA,CACD;AAAA,IACH;AAAA,IACA,CAACP,CAAO;AAAA,EAAA;AAGV,SACE,gBAAAN,EAACgB,GAAA,EAAc,GAAGR,GAChB,UAAA,gBAAAR,EAACiB,KAAoC,MAAK,UAAS,UAAUP,EAAA,CAAoB,EAAA,CACnF;AAEJ;"}

package/dist/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelectionPresentation.d.ts

@@ -3,5 +3,6 @@ interface OffCycleReasonSelectionPresentationProps {
     name: string;
     onChange?: (value: OffCycleReason) => void;
 }
+/** @internal */
 export declare function OffCycleReasonSelectionPresentation({ name, onChange, }: OffCycleReasonSelectionPresentationProps): import("react").JSX.Element;
 export {};

package/dist/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelectionPresentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffCycleReasonSelectionPresentation.js","sources":["../../../../src/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelectionPresentation.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport type { OffCycleReason } from './types'\nimport { RadioGroupField } from '@/components/Common'\n\ninterface OffCycleReasonSelectionPresentationProps {\n  name: string\n  onChange?: (value: OffCycleReason) => void\n}\n\nexport function OffCycleReasonSelectionPresentation({\n  name,\n  onChange,\n}: OffCycleReasonSelectionPresentationProps) {\n  const { t } = useTranslation('Payroll.OffCycleReasonSelection')\n\n  const options = useMemo(\n    () => [\n      {\n        value: 'correction' as OffCycleReason,\n        label: t('options.correction.label'),\n        description: t('options.correction.description'),\n      },\n      {\n        value: 'bonus' as OffCycleReason,\n        label: t('options.bonus.label'),\n        description: t('options.bonus.description'),\n      },\n    ],\n    [t],\n  )\n\n  return (\n    <RadioGroupField<OffCycleReason>\n      name={name}\n      label={t('title')}\n      options={options}\n      isRequired\n      onChange={onChange}\n    />\n  )\n}\n"],"names":["OffCycleReasonSelectionPresentation","name","onChange","t","useTranslation","options","useMemo","jsx","RadioGroupField"],"mappings":";;;;;AAUO,SAASA,EAAoC;AAAA,EAClD,MAAAC;AAAA,EACA,UAAAC;AACF,GAA6C;AAC3C,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,iCAAiC,GAExDC,IAAUC;AAAA,IACd,MAAM;AAAA,MACJ;AAAA,QACE,OAAO;AAAA,QACP,OAAOH,EAAE,0BAA0B;AAAA,QACnC,aAAaA,EAAE,gCAAgC;AAAA,MAAA;AAAA,MAEjD;AAAA,QACE,OAAO;AAAA,QACP,OAAOA,EAAE,qBAAqB;AAAA,QAC9B,aAAaA,EAAE,2BAA2B;AAAA,MAAA;AAAA,IAC5C;AAAA,IAEF,CAACA,CAAC;AAAA,EAAA;AAGJ,SACE,gBAAAI;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,MAAAP;AAAA,MACA,OAAOE,EAAE,OAAO;AAAA,MAChB,SAAAE;AAAA,MACA,YAAU;AAAA,MACV,UAAAH;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"OffCycleReasonSelectionPresentation.js","sources":["../../../../src/components/Payroll/OffCycleReasonSelection/OffCycleReasonSelectionPresentation.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport type { OffCycleReason } from './types'\nimport { RadioGroupField } from '@/components/Common'\n\ninterface OffCycleReasonSelectionPresentationProps {\n  name: string\n  onChange?: (value: OffCycleReason) => void\n}\n\n/** @internal */\nexport function OffCycleReasonSelectionPresentation({\n  name,\n  onChange,\n}: OffCycleReasonSelectionPresentationProps) {\n  const { t } = useTranslation('Payroll.OffCycleReasonSelection')\n\n  const options = useMemo(\n    () => [\n      {\n        value: 'correction' as OffCycleReason,\n        label: t('options.correction.label'),\n        description: t('options.correction.description'),\n      },\n      {\n        value: 'bonus' as OffCycleReason,\n        label: t('options.bonus.label'),\n        description: t('options.bonus.description'),\n      },\n    ],\n    [t],\n  )\n\n  return (\n    <RadioGroupField<OffCycleReason>\n      name={name}\n      label={t('title')}\n      options={options}\n      isRequired\n      onChange={onChange}\n    />\n  )\n}\n"],"names":["OffCycleReasonSelectionPresentation","name","onChange","t","useTranslation","options","useMemo","jsx","RadioGroupField"],"mappings":";;;;;AAWO,SAASA,EAAoC;AAAA,EAClD,MAAAC;AAAA,EACA,UAAAC;AACF,GAA6C;AAC3C,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,iCAAiC,GAExDC,IAAUC;AAAA,IACd,MAAM;AAAA,MACJ;AAAA,QACE,OAAO;AAAA,QACP,OAAOH,EAAE,0BAA0B;AAAA,QACnC,aAAaA,EAAE,gCAAgC;AAAA,MAAA;AAAA,MAEjD;AAAA,QACE,OAAO;AAAA,QACP,OAAOA,EAAE,qBAAqB;AAAA,QAC9B,aAAaA,EAAE,2BAA2B;AAAA,MAAA;AAAA,IAC5C;AAAA,IAEF,CAACA,CAAC;AAAA,EAAA;AAGJ,SACE,gBAAAI;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,MAAAP;AAAA,MACA,OAAOE,EAAE,OAAO;AAAA,MAChB,SAAAE;AAAA,MACA,YAAU;AAAA,MACV,UAAAH;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Payroll/OffCycleReasonSelection/types.d.ts

@@ -1,15 +1,58 @@
 import { BaseComponentInterface } from '../../Base/Base';
+/**
+ * Reason for running an off-cycle payroll.
+ *
+ * `bonus` covers bonuses, gifts, or commissions; `correction` covers any payroll run outside the regular pay schedule.
+ *
+ * @public
+ */
 export type OffCycleReason = 'bonus' | 'correction';
+/**
+ * Tax withholding rate applied to an off-cycle payroll.
+ *
+ * `supplemental` applies the IRS supplemental withholding rate; `regular` applies the employee's regular withholding rate.
+ *
+ * @public
+ */
 export type WithholdingType = 'supplemental' | 'regular';
+/**
+ * Recommended deduction and withholding defaults paired with an off-cycle reason.
+ *
+ * @public
+ */
 export interface OffCycleReasonDefaults {
+    /** Whether regular deductions and contributions should be skipped for this payroll. */
     skipDeductions: boolean;
+    /** Withholding rate to apply for this payroll. */
     withholdingType: WithholdingType;
 }
+/**
+ * Default deduction and withholding settings keyed by off-cycle reason.
+ *
+ * @remarks
+ * `bonus` defaults to skipping regular deductions and using the supplemental withholding rate.
+ * `correction` defaults to including regular deductions and using the regular withholding rate.
+ *
+ * @public
+ */
 export declare const OFF_CYCLE_REASON_DEFAULTS: Record<OffCycleReason, OffCycleReasonDefaults>;
+/**
+ * Payload emitted with the `offCycle/selectReason` event when a reason is chosen.
+ *
+ * @public
+ */
 export interface SelectReasonPayload {
+    /** The reason the user selected. */
     reason: OffCycleReason;
+    /** Recommended deduction and withholding defaults for the selected reason. */
     defaults: OffCycleReasonDefaults;
 }
+/**
+ * Props for the {@link OffCycleReasonSelection} component.
+ *
+ * @public
+ */
 export interface OffCycleReasonSelectionProps extends BaseComponentInterface<'Payroll.OffCycleReasonSelection'> {
+    /** The associated company identifier. */
     companyId: string;
 }