Assembly part

Composition

A persistent native component moving between a floating organism and its measured layout.

React · copy into your project · light and dark themes

Try it

Loading preview…

Take it with you

Copy the example, API and usage notes for your editor or AI assistant.

Add to your project

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/assembly-part.json

The command includes the component’s shared dependencies. Your project keeps editable source files.

Include the complete example

This example also composes button, icon. Install its parts together:

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/assembly-part.json https://luv-jeri.github.io/cojeev-ui/r/button.json https://luv-jeri.github.io/cojeev-ui/r/icon.json

Using assembly part

Use this primitive inside a measured composition. Preserve stable part identity while target geometry changes.
asChild retains the native interactive element. Assembly controls manage its interactivity during travel.

API

Compose the exported parts below. The prop types are read from the React source during the registry build.

Native element or underlying primitive props are inherited where declared, including accessible labels, event handlers and refs.

AssemblyPartProps

Prop	Type	Required
`children`	`React.ReactElement`	Yes
`identity`	`string`	Yes
`transitionKey` Marks a new composition even when a reused part has identical target geometry.	`string`	No
`rect`	`AssemblyRect`	Yes
`from` Initial geometry for a newly introduced native part; existing roots keep current motion values.	`AssemblyRect`	No
`fromContour`	`AssemblyContour`	No
`contour`	`AssemblyContour`	No
`radius`	`number`	No
`reveal`	`boolean`	No
`interactive`	`boolean`	No
`immediate`	`boolean`	No
`duration`	`number`	No
`delay`	`number`	No
`curve` Curved travel strength from 0 (straight) to 1.	`number`	No
`onProgress`	`(progress:number)=>void`	No
`release` Give native paint, clipping, focus and hover motion back after arrival.	`boolean`	No
`floating`	`boolean`	No
`tone`	`"pink"\|"blue"\|"olive"\|"yellow"`	No
`onRest`	`()=>void`	No
`className`	`string`	No

Accessibility

Settled parts retain native keyboard behaviour. Moving parts are inert until placed.

States and appearance

restinteractivereduced-motion

For conditional content, keep a MotionPresence boundary around keyed MotionSurface children. The shared entrance and exit states work with native primitives and respect your motion preference.

Try pointer and keyboard interaction, and switch the appearance control in the navigation to compare light and dark mode. Motion respects reduced motion preferences.