feat(apollo-react): expose canvas handle positioning utility

[SreedharAvvari]

Summary

• Moved the existing calculateGridAlignedHandlePositions logic from ButtonHandleStyleUtils into src/canvas/utils/handle-positioning.ts so it can be shared with consumers.
• This is a 1:1 move of the existing handle positioning algorithm and its behavior tests, not a rewrite.
• Re-exported calculateGridAlignedHandlePositions from the public canvas utils barrel, making it available from @uipath/apollo-react/canvas/utils and the root canvas barrel.
• Kept the small snap helper internal to handle-positioning.ts; NodeUtils.snapToGrid is not changed.
• Updated ButtonHandle and SmartHandle to use the moved helper for rendering.

Why

Downstream canvas layout/tidy code needs to align with Apollo's actual rendered side-handle slots without duplicating the placement math.

Validation

• pnpm --dir packages/apollo-react exec vitest --run src/canvas/components/ButtonHandle src/canvas/utils/handle-positioning.test.ts
• pnpm --dir packages/apollo-react exec tsc --noEmit --pretty false --project tsconfig.json
• pnpm --dir packages/apollo-react exec biome check src/canvas/components/ButtonHandle/ButtonHandle.tsx src/canvas/components/ButtonHandle/SmartHandle.tsx src/canvas/components/ButtonHandle/ButtonHandleStyleUtils.ts src/canvas/components/ButtonHandle/ButtonHandleStyleUtils.test.ts src/canvas/utils/index.ts src/canvas/utils/handle-positioning.ts src/canvas/utils/handle-positioning.test.ts

[github-actions]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (PT)
apollo-design	🟢 Ready	Preview, Logs	Jun 12, 2026, 06:13:04 AM
apollo-docs	🟢 Ready	Preview, Logs	Jun 12, 2026, 06:13:04 AM
apollo-landing	🟢 Ready	Preview, Logs	Jun 12, 2026, 06:13:04 AM
apollo-vertex	🟢 Ready	Preview, Logs	Jun 12, 2026, 06:13:04 AM

[github-actions]

Dependency License Review

• ✅ 1922 package(s) scanned
• ✅ No license issues found
• ⚠️ 2 package(s) excluded (see details below)

License distribution

License	Packages
MIT	1692
ISC	89
Apache-2.0	55
BSD-3-Clause	27
BSD-2-Clause	23
BlueOak-1.0.0	8
MPL-2.0	4
MIT-0	3
CC0-1.0	3
MIT OR Apache-2.0	2
(MIT OR Apache-2.0)	2
Unlicense	2
LGPL-3.0-or-later	1
Python-2.0	1
CC-BY-4.0	1
(MPL-2.0 OR Apache-2.0)	1
Unknown	1
Artistic-2.0	1
(WTFPL OR MIT)	1
(BSD-2-Clause OR MIT OR Apache-2.0)	1
CC-BY-3.0	1
0BSD	1
(MIT OR CC0-1.0)	1
MIT AND ISC	1

Excluded packages

Package	Version	License	Reason
@img/sharp-libvips-linux-x64	1.2.4	LGPL-3.0-or-later	LGPL pre-built binary, not linked
khroma	2.1.0	Unknown	MIT per GitHub repo, missing license field in package.json

[github-actions]

📦 Dev Packages

🧹 Dev packages cleaned up after PR close.

Last updated: 2026-06-12 20:35:27 PT

[Copilot]

Pull request overview

This PR extracts the grid-aligned side-handle slot positioning logic into a dedicated canvas utility and exposes it publicly so downstream canvas layout/tidy code can match Apollo’s rendered handle placement without duplicating the math.

Changes:

• Added calculateGridAlignedHandlePositions to src/canvas/utils/handle-positioning.ts with dedicated unit tests.
• Re-exported calculateGridAlignedHandlePositions from the public canvas utils barrel (and therefore from the root canvas barrel).
• Updated ButtonHandle/SmartHandle to consume the shared helper; moved snapToGrid tests into NodeUtils.test.ts and removed the old helper implementation from ButtonHandleStyleUtils.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/apollo-react/src/canvas/utils/NodeUtils.ts	Extends snapToGrid to accept a custom grid size parameter.
packages/apollo-react/src/canvas/utils/NodeUtils.test.ts	Adds unit tests covering snapToGrid default/custom grid behavior.
packages/apollo-react/src/canvas/utils/index.ts	Re-exports calculateGridAlignedHandlePositions from the public utils barrel.
packages/apollo-react/src/canvas/utils/handle-positioning.ts	Introduces the extracted public handle positioning utility.
packages/apollo-react/src/canvas/utils/handle-positioning.test.ts	Adds focused tests for handle positioning behavior and edge cases.
packages/apollo-react/src/canvas/components/ButtonHandle/ButtonHandle.tsx	Switches to importing handle positioning from the shared util.
packages/apollo-react/src/canvas/components/ButtonHandle/SmartHandle.tsx	Switches to importing handle positioning from the shared util.
packages/apollo-react/src/canvas/components/ButtonHandle/ButtonHandleStyleUtils.ts	Removes the previous in-file snapToGrid and positioning helper implementation.
packages/apollo-react/src/canvas/components/ButtonHandle/ButtonHandleStyleUtils.test.ts	Removes tests that were relocated to NodeUtils / handle-positioning tests.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 6 comments.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.