Skip to content

🎥 Make videos programmatically with React

Enable cropping for automatic interactive wrappers

JonnyBurgerfb458bc1bab0
diff --git a/packages/core/src/Interactive.tsx b/packages/core/src/Interactive.tsx
index 43bca3ef10..76a245478b 100644
--- a/packages/core/src/Interactive.tsx
+++ b/packages/core/src/Interactive.tsx
@@ -236,13 +236,10 @@ type ComponentWithoutReservedProps<
type AutomaticWrapperReservedKey =
| keyof InteractiveBaseProps
+ | keyof InteractiveCropProps
| keyof InteractivePremountProps
| 'controls';
-type CroppingWrapperReservedKey =
- | AutomaticWrapperReservedKey
- | keyof InteractiveCropProps;
-
type IsAny<Value> = 0 extends 1 & Value ? true : false;
type StyleMemberAcceptsCssProperties<Style> =
@@ -299,26 +296,6 @@ type WithSchema = {
readonly defaultDurationInFrames?: number;
readonly wrapInSequence: true;
},
- ): React.FC<
- React.ComponentPropsWithRef<Component> &
- InteractiveBaseProps &
- InteractivePremountProps
- >;
- <S extends InteractivitySchema, Component extends React.ElementType>(
- options: Omit<
- WithInteractivitySchemaOptions<
- S,
- React.ComponentPropsWithoutRef<Component>
- >,
- 'Component' | 'supportsEffects'
- > & {
- readonly Component: ComponentAcceptingStyle<
- Component,
- CroppingWrapperReservedKey
- >;
- readonly defaultDurationInFrames?: number;
- readonly wrapInSequence: {readonly cropping: true};
- },
): React.FC<
React.ComponentPropsWithRef<Component> &
InteractiveBaseProps &
@@ -338,7 +315,7 @@ type WithSchemaImplementationOptions = Omit<
> & {
readonly Component: React.ComponentType<object>;
readonly defaultDurationInFrames?: number;
- readonly wrapInSequence?: false | true | {readonly cropping: true};
+ readonly wrapInSequence?: false | true;
};
const withSchema: WithSchema = (untypedOptions: unknown) => {
@@ -362,14 +339,12 @@ const withSchema: WithSchema = (untypedOptions: unknown) => {
wrapInSequence: _,
...rest
} = options;
- const cropping =
- typeof options.wrapInSequence === 'object' &&
- options.wrapInSequence.cropping;
type ComponentWrappedInSequenceProps = React.ComponentProps<
typeof Component
> &
InteractiveBaseProps &
- InteractivePremountProps & {
+ InteractivePremountProps &
+ InteractiveCropProps & {
readonly controls: SequenceControls | undefined;
};
const ComponentWrappedInSequence = forwardRef<
@@ -429,22 +404,13 @@ const withSchema: WithSchema = (untypedOptions: unknown) => {
hideWhilePremounted: 'opacity',
});
const croppedStyle = useCropStyle({
- cropLeft: cropping ? cropLeft : undefined,
- cropRight: cropping ? cropRight : undefined,
- cropTop: cropping ? cropTop : undefined,
- cropBottom: cropping ? cropBottom : undefined,
- style: cropping ? premountingStyle : null,
+ cropLeft,
+ cropRight,
+ cropTop,
+ cropBottom,
+ style: premountingStyle,
componentName,
});
- const propsForComponent = cropping
- ? {
- ...componentPropsWithoutCropping,
- style: croppedStyle ?? undefined,
- }
- : {
- ...componentProps,
- style: premountingStyle ?? undefined,
- };
return (
<Freeze frame={freezeFrame} active={isPremountingOrPostmounting}>
@@ -466,7 +432,8 @@ const withSchema: WithSchema = (untypedOptions: unknown) => {
_remotionInternalIsPostmounting={postmountingActive}
>
{React.createElement(Component, {
- ...propsForComponent,
+ ...componentPropsWithoutCropping,
+ style: croppedStyle ?? undefined,
ref,
} as React.ComponentProps<typeof Component>)}
</SequenceWithoutSchema>
@@ -481,7 +448,7 @@ const withSchema: WithSchema = (untypedOptions: unknown) => {
...schema,
...baseSchema,
...premountSchema,
- ...(cropping ? cropSchema : {}),
+ ...cropSchema,
},
supportsEffects: false,
});
diff --git a/packages/docs/docs/interactive-with-schema.mdx b/packages/docs/docs/interactive-with-schema.mdx
index 3a5c327db0..36cee9069b 100644
--- a/packages/docs/docs/interactive-with-schema.mdx
+++ b/packages/docs/docs/interactive-with-schema.mdx
@@ -62,7 +62,7 @@ export const Circle = Interactive.withSchema({
});
```
-The exported `Circle` component accepts `CircleProps`, the common timing props and [`InteractivePremountProps`](/docs/interactive#interactivepremountprops). The wrapper registers the component in the timeline and preserves its source location for Studio edits.
+The exported `Circle` component accepts `CircleProps`, the common timing props, [`InteractivePremountProps`](/docs/interactive#interactivepremountprops) and [`InteractiveCropProps`](/docs/interactive#interactivecropprops). The wrapper registers the component in the timeline and preserves its source location for Studio edits.
## API
@@ -76,7 +76,7 @@ Call `Interactive.withSchema()` with an options object.
The component to wrap.
-With automatic wrapping, it must accept a `style?: React.CSSProperties` prop and apply it to its visual root. The wrapper uses this prop for premounting, postmounting and cropping. It must not declare `controls`, the common timing props or premounting props because the wrapper owns those props. With `wrapInSequence: {cropping: true}`, it must not declare the crop props either. Without automatic wrapping, it must accept `controls`.
+With automatic wrapping, it must accept a `style?: React.CSSProperties` prop and apply it to its visual root. The wrapper uses this prop for premounting, postmounting and cropping. It must not declare `controls`, the common timing props, premounting props or crop props because the wrapper owns those props. Without automatic wrapping, it must accept `controls`.
### `componentName`
@@ -96,46 +96,23 @@ When manually wrapping the component, forward it to the `<Sequence>` that regist
An [`InteractivitySchema`](/docs/interactivity-schema) that describes which props are editable in Remotion Studio.
-With automatic wrapping, [`Interactive.baseSchema`](/docs/interactive#interactivebaseschema) and [`Interactive.premountSchema`](/docs/interactive#interactivepremountschema) are added automatically. With `wrapInSequence: {cropping: true}`, [`Interactive.cropSchema`](/docs/interactive#interactivecropschema) is added as well.
+With automatic wrapping, [`Interactive.baseSchema`](/docs/interactive#interactivebaseschema), [`Interactive.premountSchema`](/docs/interactive#interactivepremountschema) and [`Interactive.cropSchema`](/docs/interactive#interactivecropschema) are added automatically.
When manually wrapping the component, include [`Interactive.baseSchema`](/docs/interactive#interactivebaseschema) for Sequence-like timeline props. Use [`Interactive.transformSchema`](/docs/interactive#interactivetransformschema) if the component accepts a `style` prop and should expose transform controls. Add [`Interactive.premountSchema`](/docs/interactive#interactivepremountschema) with [`InteractivePremountProps`](/docs/interactive#interactivepremountprops) or [`Interactive.cropSchema`](/docs/interactive#interactivecropschema) with [`InteractiveCropProps`](/docs/interactive#interactivecropprops) when the custom wrapper implements those behaviors itself.
For reliable source updates, follow [Interactivity best practices](/docs/studio/interactivity-best-practices): Keep editable values inline, use hardcoded `interpolate()` keyframe arrays, use `translate`, `scale`, `rotate` and `opacity` directly, and avoid animated layout props or `transform` strings.
### `wrapInSequence?`<AvailableFrom v="4.0.530" />
-Set to `true` to wrap `Component` in `<Sequence layout="none">`, add `Interactive.baseSchema` and `Interactive.premountSchema`, and expose the common timing and premounting props on the returned component.
+Set to `true` to wrap `Component` in `<Sequence layout="none">`, add `Interactive.baseSchema`, `Interactive.premountSchema` and `Interactive.cropSchema`, and expose the common timing, premounting and cropping props on the returned component.
Default: `false`. Omit it only when `Component` renders its own [`<Sequence>`](/docs/sequence), for example to support effects, coordinate multiple visual roots or implement custom timeline behavior.
-Both automatic wrapping forms expose [`InteractivePremountProps`](/docs/interactive#interactivepremountprops): `premountFor`, `postmountFor`, `styleWhilePremounted` and `styleWhilePostmounted`. In v4, `premountFor` defaults to `0`. From [v5.0](/docs/5-0-migration), it defaults to one second (`fps` frames). Pass `premountFor={0}` to opt out. `postmountFor` defaults to `0`.
+Automatic wrapping exposes [`InteractivePremountProps`](/docs/interactive#interactivepremountprops): `premountFor`, `postmountFor`, `styleWhilePremounted` and `styleWhilePostmounted`. In v4, `premountFor` defaults to `0`. From [v5.0](/docs/5-0-migration), it defaults to one second (`fps` frames). Pass `premountFor={0}` to opt out. `postmountFor` defaults to `0`.
-#### `cropping`
-
-Set `wrapInSequence` to `{cropping: true}` to additionally add `Interactive.cropSchema` and expose `cropLeft`, `cropRight`, `cropTop` and `cropBottom` on the returned component. Each value is a ratio from `0` to `1` of the corresponding width or height: `0` leaves the edge unchanged and `1` crops it fully.
+It also exposes [`InteractiveCropProps`](/docs/interactive#interactivecropprops): `cropLeft`, `cropRight`, `cropTop` and `cropBottom`. Each value is a ratio from `0` to `1` of the corresponding width or height: `0` leaves the edge unchanged and `1` crops it fully.
The wrapper merges the incoming component `style`, the active premounting or postmounting style, and then the crop style before passing it to `Component`. The crop `clipPath` therefore replaces an earlier inline `style.clipPath`. The generated [`<Sequence>`](/docs/sequence) keeps `layout="none"`.
-```tsx twoslash title="Circle.tsx"
-import type React from 'react';
-import {Interactive} from 'remotion';
-
-type CircleProps = {
- readonly style?: React.CSSProperties;
-};
-
-const CircleInner: React.FC<CircleProps> = ({style}) => <div style={style} />;
-const circleSchema = {};
-// ---cut---
-export const Circle = Interactive.withSchema({
- Component: CircleInner,
- componentName: '<Circle>',
- schema: circleSchema,
- wrapInSequence: {cropping: true},
-});
-```
-
-For cropping to be visible, `Component` must accept `style` and apply it to its visual root.
-
### `supportsEffects`
Required when manually wrapping a component. Set to `true` if the component supports an `effects` prop. Otherwise, set it to `false`.
@@ -144,7 +121,7 @@ Omit it when automatic wrapping is enabled. Components that support effects need
### Return value
-Returns a component with the public props of `Component`. With automatic wrapping, the common timing props from [`<Sequence>`](/docs/sequence) and [`InteractivePremountProps`](/docs/interactive#interactivepremountprops) are also included. The cropping configuration additionally includes [`InteractiveCropProps`](/docs/interactive#interactivecropprops).
+Returns a component with the public props of `Component`. With automatic wrapping, the common timing props from [`<Sequence>`](/docs/sequence), [`InteractivePremountProps`](/docs/interactive#interactivepremountprops) and [`InteractiveCropProps`](/docs/interactive#interactivecropprops) are also included.
### Ref forwarding<AvailableFrom v="4.0.530" />
diff --git a/packages/docs/docs/studio/make-component-interactive.mdx b/packages/docs/docs/studio/make-component-interactive.mdx
index 1a22002b0b..9a700ff1f9 100644
--- a/packages/docs/docs/studio/make-component-interactive.mdx
+++ b/packages/docs/docs/studio/make-component-interactive.mdx
@@ -73,11 +73,13 @@ const badgeSchema = {
[`Interactive.premountSchema`](/docs/interactive#interactivepremountschema) is also added automatically, it allows for [premounting](/docs/player/premounting) components.
+[`Interactive.cropSchema`](/docs/interactive#interactivecropschema) is added automatically as well, allowing the component to be cropped from any side.
+
Include [`Interactive.transformSchema`](/docs/interactive#interactivetransformschema) to allow 2D and 3D transformations.
### Caption fields<AvailableFrom v="4.0.500" />
-Include [`Interactive.captionsSchema`](/docs/interactive#interactivecaptionsschema) when the component accepts [`captions: Caption[]`](/docs/captions/caption) data:
+Include [`Interactive.captionsSchema`](/docs/interactivity-schema#interactivecaptionsschema) when the component accepts [`captions: Caption[]`](/docs/captions/caption) data:
```ts twoslash title="Captions.tsx"
import {Interactive, type InteractivitySchema} from 'remotion';
@@ -147,27 +149,6 @@ export const Badge = Interactive.withSchema({
});
```
-## Enable cropping<AvailableFrom v="4.0.530" />
-
-To make the component croppable, use `wrapInSequence: {cropping: true}`.
-
-```tsx title="Badge.tsx"
-export const Badge = Interactive.withSchema({
- Component: BadgeInner,
- componentName: '<Badge>',
- schema: badgeSchema,
- wrapInSequence: {cropping: true},
-});
-```
-
-This adds [`Interactive.cropSchema`](/docs/interactive#interactivecropschema) and `crop*` props on the returned component.
-
-```tsx title="MyComp.tsx"
-<Badge cropLeft={0.2} cropBottom={0.1}>
- Sale
-</Badge>
-```
-
## Use the component
You can now use the component regularly.
@@ -179,13 +160,7 @@ import {Badge} from './Badge';
export const MyComp = () => {
return (
- <Badge
- from={30}
- durationInFrames={90}
- premountFor={30}
- color="#ff5c7a"
- style={{translate: '120px 80px'}}
- >
+ <Badge from={30} durationInFrames={90} premountFor={30} color="#ff5c7a" cropLeft={0.2} style={{translate: '120px 80px'}}>
Sale
</Badge>
);
diff --git a/packages/docs/elements/guidelines.mdx b/packages/docs/elements/guidelines.mdx
index 467afde365..63e1775938 100644
--- a/packages/docs/elements/guidelines.mdx
+++ b/packages/docs/elements/guidelines.mdx
@@ -52,13 +52,13 @@ Wrap the exported component with [`Interactive.withSchema()`](/docs/interactive-
Use `defaultDurationInFrames` to preserve a component-owned default duration.
-Use `wrapInSequence: {cropping: true}` to also expose crop controls. Omit `wrapInSequence` only when the Element needs effects, coordinates multiple visual roots or implements custom timeline behavior.
+This also exposes crop controls. Omit `wrapInSequence` only when the Element needs effects, coordinates multiple visual roots or implements custom timeline behavior.
When `wrapInSequence` is enabled:
-- `Interactive.withSchema()` adds [`Interactive.baseSchema`](/docs/interactive#interactivebaseschema), [`Interactive.premountSchema`](/docs/interactive#interactivepremountschema), the corresponding props and a `<Sequence layout="none">` automatically.
+- `Interactive.withSchema()` adds [`Interactive.baseSchema`](/docs/interactive#interactivebaseschema), [`Interactive.premountSchema`](/docs/interactive#interactivepremountschema), [`Interactive.cropSchema`](/docs/interactive#interactivecropschema), the corresponding props and a `<Sequence layout="none">` automatically.
- Premounting defaults to `0` frames in v4 and one second in v5. Pass `premountFor={0}` to opt out of the v5 default.
-- The wrapper merges the incoming `style` with active premounting or postmounting styles. The cropping configuration additionally adds [`Interactive.cropSchema`](/docs/interactive#interactivecropschema) and merges the crop style last.
+- The wrapper merges the incoming `style` with active premounting or postmounting styles and the crop style last.
- Pass `style` to the rendered element. Studio discovers its outline automatically. Set the dimensions in the component because Element metadata does not pass them as props.
- Frame-dependent animation inside the component respects `from`, `trimBefore`, `durationInFrames`, `playbackRate`, `loop`, and `freeze` because the generated Sequence is outside it. Its local time is frozen at the first or last frame while premounted or postmounted.
- If the inner component accepts a React ref, refs passed to the exported component are forwarded directly to it.
diff --git a/packages/docs/elements/text/spinning-text-wheel/spinning-text-wheel.tsx b/packages/docs/elements/text/spinning-text-wheel/spinning-text-wheel.tsx
index b1d6102684..08a80c593d 100644
--- a/packages/docs/elements/text/spinning-text-wheel/spinning-text-wheel.tsx
+++ b/packages/docs/elements/text/spinning-text-wheel/spinning-text-wheel.tsx
@@ -6,7 +6,6 @@ import {
spring,
useCurrentFrame,
useVideoConfig,
- type InteractiveBaseProps,
type InteractiveTransformProps,
type InteractivitySchema,
} from 'remotion';
@@ -16,16 +15,10 @@ loadFont('normal', {
subsets: ['latin'],
});
-type SpinningTextWheelOwnProps = InteractiveTransformProps & {
+type SpinningTextWheelProps = InteractiveTransformProps & {
readonly items?: string;
};
-type SpinningTextWheelProps = InteractiveBaseProps & SpinningTextWheelOwnProps;
-
-type InteractiveSpinningTextWheelProps = SpinningTextWheelOwnProps & {
- readonly callerStyle: React.CSSProperties | null;
-};
-
const spinningTextWheelSchema = {
items: {
type: 'text-content',
@@ -33,12 +26,30 @@ const spinningTextWheelSchema = {
description: 'Items (selected first, one per line)',
},
...Interactive.textSchema,
- callerStyle: {type: 'hidden'},
+ 'style.color': {
+ ...Interactive.textSchema['style.color'],
+ default: '#182033',
+ },
+ 'style.fontFamily': {
+ ...Interactive.textSchema['style.fontFamily'],
+ default: 'Mona Sans',
+ },
+ 'style.fontSize': {
+ ...Interactive.textSchema['style.fontSize'],
+ default: 65,
+ },
+ 'style.fontWeight': {
+ ...Interactive.textSchema['style.fontWeight'],
+ default: 700,
+ },
+ 'style.lineHeight': {
+ ...Interactive.textSchema['style.lineHeight'],
+ default: 1,
+ },
...Interactive.transformSchema,
} as const satisfies InteractivitySchema;
-const SpinningTextWheelInner: React.FC<InteractiveSpinningTextWheelProps> = ({
- callerStyle,
+const SpinningTextWheelInner: React.FC<SpinningTextWheelProps> = ({
items = 'Friday\nSaturday\nSunday\nMonday\nTuesday\nWednesday\nThursday',
style,
}) => {
@@ -60,116 +71,76 @@ const SpinningTextWheelInner: React.FC<InteractiveSpinningTextWheelProps> = ({
durationRestThreshold: 0.0001,
});
const rotation = interpolate(progress, [0, 1], [1, 0]);
- const {
- rotate: callerRotate,
- scale: callerScale,
- transform: callerTransform,
- transformBox: callerTransformBox,
- transformOrigin: callerTransformOrigin,
- transformStyle: callerTransformStyle,
- translate: callerTranslate,
- ...callerContentStyle
- } = callerStyle ?? {};
return (
<div
style={{
- rotate: callerRotate,
- scale: callerScale,
- transform: callerTransform,
- transformBox: callerTransformBox,
- transformOrigin: callerTransformOrigin,
- transformStyle: callerTransformStyle,
- translate: callerTranslate,
+ color: '#182033',
+ fontFamily: 'Mona Sans',
+ fontSize: 65,
+ fontWeight: 700,
+ height: 200,
+ lineHeight: 1,
+ maskImage:
+ 'linear-gradient(to bottom, transparent 0%, rgba(0, 0, 0, 1) 30%, rgba(0, 0, 0, 1) 70%, transparent 100%)',
+ overflow: 'hidden',
+ WebkitMaskImage:
+ 'linear-gradient(to bottom, transparent 0%, rgba(0, 0, 0, 1) 30%, rgba(0, 0, 0, 1) 70%, transparent 100%)',
+ perspective: 10000,
+ position: 'relative',
+ width: 400,
+ ...style,
}}
>
- <div
- style={{
- height: 200,
- maskImage:
- 'linear-gradient(to bottom, transparent 0%, rgba(0, 0, 0, 1) 30%, rgba(0, 0, 0, 1) 70%, transparent 100%)',
- overflow: 'hidden',
- WebkitMaskImage:
- 'linear-gradient(to bottom, transparent 0%, rgba(0, 0, 0, 1) 30%, rgba(0, 0, 0, 1) 70%, transparent 100%)',
- perspective: 10000,
- position: 'relative',
- width: 400,
- ...style,
- ...callerContentStyle,
- }}
- >
- {values.map((value, index) => {
- const wheelIndex = index / values.length + rotation;
- const angle = wheelIndex * Math.PI * 2;
- const rotateX = wheelIndex * 360;
+ {values.map((value, index) => {
+ const wheelIndex = index / values.length + rotation;
+ const angle = wheelIndex * Math.PI * 2;
+ const rotateX = wheelIndex * 360;
- return (
+ return (
+ <div
+ key={`${index}-${value}`}
+ style={{
+ alignItems: 'center',
+ backfaceVisibility: 'hidden',
+ display: 'flex',
+ height: '100%',
+ justifyContent: 'center',
+ left: 0,
+ opacity:
+ index === 0
+ ? interpolate(progress, [0.88, 1], [0.28, 1], {
+ extrapolateLeft: 'clamp',
+ extrapolateRight: 'clamp',
+ })
+ : 0.28,
+ position: 'absolute',
+ top: 0,
+ perspective: 1000,
+ transform: `translateZ(${Math.cos(angle) * 100}px) translateY(${Math.sin(angle) * 100}px) rotateX(${rotateX}deg)`,
+ width: '100%',
+ }}
+ >
<div
- key={`${index}-${value}`}
style={{
- alignItems: 'center',
backfaceVisibility: 'hidden',
- display: 'flex',
- height: '100%',
- justifyContent: 'center',
- left: 0,
- opacity:
- index === 0
- ? interpolate(progress, [0.88, 1], [0.28, 1], {
- extrapolateLeft: 'clamp',
- extrapolateRight: 'clamp',
- })
- : 0.28,
- position: 'absolute',
- top: 0,
- perspective: 1000,
- transform: `translateZ(${Math.cos(angle) * 100}px) translateY(${Math.sin(angle) * 100}px) rotateX(${rotateX}deg)`,
+ textAlign: 'center',
+ transform: `rotateX(${-rotateX}deg)`,
width: '100%',
}}
>
- <div
- style={{
- backfaceVisibility: 'hidden',
- textAlign: 'center',
- transform: `rotateX(${-rotateX}deg)`,
- width: '100%',
- }}
- >
- {value}
- </div>
+ {value}
</div>
- );
- })}
- </div>
+ </div>
+ );
+ })}
</div>
);
};
-const InteractiveSpinningTextWheel = Interactive.withSchema({
+export const SpinningTextWheel = Interactive.withSchema({
Component: SpinningTextWheelInner,
componentName: '<SpinningTextWheel>',
schema: spinningTextWheelSchema,
wrapInSequence: true,
});
-
-export const SpinningTextWheel: React.FC<SpinningTextWheelProps> = ({
- style,
- ...props
-}) => {
- return (
- <InteractiveSpinningTextWheel
- items={'Friday\nSaturday\nSunday\nMonday\nTuesday\nWednesday\nThursday'}
- name="Spinning text wheel"
- {...props}
- callerStyle={style ?? null}
- style={{
- color: '#182033',
- fontFamily: 'Mona Sans',
- fontSize: 65,
- fontWeight: 700,
- lineHeight: 1,
- translate: '0px 0px',
- }}
- />
- );
-};
diff --git a/packages/maptiler/src/MapViewport.tsx b/packages/maptiler/src/MapViewport.tsx
index 3e36531d30..432ca65b28 100644
--- a/packages/maptiler/src/MapViewport.tsx
+++ b/packages/maptiler/src/MapViewport.tsx
@@ -6,6 +6,7 @@ import {
Interactive,
useDelayRender,
type InteractiveBaseProps,
+ type InteractiveCropProps,
type InteractivePremountProps,
type InteractivitySchema,
type SequenceControls,
@@ -33,6 +34,7 @@ export type MapViewportMapOptions = Omit<
export type MapAdministrativeBorders = 'all' | 'country-only' | 'none';
export type MapViewportProps = InteractiveBaseProps &
+ InteractiveCropProps &
InteractivePremountProps & {
readonly apiKey: string | null;
readonly backgroundColor?: string;
@@ -208,7 +210,10 @@ const MissingApiKey = () => {
type MapViewportContentProps = Omit<
MapViewportProps,
- keyof InteractiveBaseProps | keyof InteractivePremountProps | 'controls'
+ | keyof InteractiveBaseProps
+ | keyof InteractiveCropProps
+ | keyof InteractivePremountProps
+ | 'controls'
> & {
readonly style?: CSSProperties;
};
diff --git a/packages/skills/skills/remotion-interactivity/SKILL.md b/packages/skills/skills/remotion-interactivity/SKILL.md
index 8f57940a9b..877472b9f5 100644
--- a/packages/skills/skills/remotion-interactivity/SKILL.md
+++ b/packages/skills/skills/remotion-interactivity/SKILL.md
@@ -305,13 +305,13 @@ Render separate elements if one version should have effects and another should n
## Making your own component interactive
-When using `Interactive.withSchema()`, set `wrapInSequence: true`. This adds `Interactive.baseSchema` and `Interactive.premountSchema`, wraps the component in `<Sequence layout="none">` and exposes standard timeline and mounting controls. The component must accept a `style?: React.CSSProperties` prop and apply it to its visual root so the wrapper can apply premounting styles.
+When using `Interactive.withSchema()`, set `wrapInSequence: true`. This adds `Interactive.baseSchema`, `Interactive.premountSchema` and `Interactive.cropSchema`, wraps the component in `<Sequence layout="none">` and exposes standard timeline, mounting and cropping controls. The component must accept a `style?: React.CSSProperties` prop and apply it to its visual root so the wrapper can apply premounting and crop styles.
Use `defaultDurationInFrames` when the generated Sequence needs a default duration.
-To also expose crop controls, set `wrapInSequence: {cropping: true}`. This adds `Interactive.cropSchema` and crop props automatically. The generated Sequence remains `layout="none"`; the wrapper merges the premounting and crop styles into the component's `style`.
+Automatic wrapping exposes `InteractivePremountProps`: `premountFor`, `postmountFor`, `styleWhilePremounted` and `styleWhilePostmounted`. In v4, `premountFor` defaults to `0`. In v5, it defaults to one second (`fps` frames); pass `premountFor={0}` to opt out. `postmountFor` defaults to `0`.
-Both automatic wrapping forms expose `InteractivePremountProps`: `premountFor`, `postmountFor`, `styleWhilePremounted` and `styleWhilePostmounted`. In v4, `premountFor` defaults to `0`. In v5, it defaults to one second (`fps` frames); pass `premountFor={0}` to opt out. `postmountFor` defaults to `0`.
+It also exposes `InteractiveCropProps`: `cropLeft`, `cropRight`, `cropTop` and `cropBottom`. The wrapper merges the premounting and crop styles into the component's `style`.
If the wrapped component accepts a React ref, automatic wrapping forwards refs directly to it.