CalciteFlowItem.showBackButton causes type error in public types

[maxpatiiuk]

Check existing issues

• I have checked for existing issues to avoid duplicates

Actual Behavior

Consuming Calcite's dev branch typings in JS API produces this TypeScript error:

node_modules/@esri/calcite-components/dist/components/calcite-flow/interfaces.d.ts:3:61 - error TS2344: Type '"selected" | "setFocus" | "beforeBack" | "menuOpen" | "showBackButton"' does not satisfy the constraint 'keyof HTMLCalciteFlowItemElement'.
  Type '"showBackButton"' is not assignable to type 'keyof HTMLCalciteFlowItemElement'.

3 export type FlowItemLike = Pick<HTMLCalciteFlowItemElement, "beforeBack" | "menuOpen" | "setFocus" | "showBackButton" | "selected">;

The showBackButton property is marked as private, which makes it excluded from public typings:

calcite-design-system/packages/calcite-components/src/components/flow-item/flow-item.tsx

Lines 133 to 138 in b280ea4

	/**
	* When `true`, displays a back button in the component's header.
	*
	* @private
	*/
	@property() showBackButton = false;

Solutions:

1. (easy) Mark the showBackButton as @internal rather than @private - it will still be present in the typings, but you can can be excluded when rendering the public documentation.
2. Update the FlowItemLike interface to not rely on showBackButton (or at least not in the way that produces a typescript error when that property is absent)

Expected Behavior

Do not produce TypeScript errors when consuming Calcite typings in a project that has "skipLibCheck": false

Reproduction Sample

(JS API PR 66756)

Reproduction Steps

Simplest way to reproduce is to comment out the showBackButton property from the CalciteFlowItem component to simulate how it would appear in the public typings.

Otherwise, you can try npx build:ts on the calcite-lumina branch in JS API (PR 66756)

Reproduction Version

3.0.0-next.12

Relevant Info

No response

Regression?

No response

Priority impact

impact - p1 - need for current milestone

Impact

No response

Calcite package

• @esri/calcite-components
• @esri/calcite-components-react
• @esri/calcite-design-tokens
• @esri/calcite-ui-icons
• @esri/eslint-plugin-calcite-components

Esri team

ArcGIS Maps SDK for JavaScript

[github-actions]

Installed and assigned for verification.

[DitwanP]

🍡 Verified.