# ValueSwap

Swap text or a status at a brief fade-through while reserving both values' space.

Page: https://20cuts.com/docs/components/value-swap

## Installation

Run from your product repository:

```sh
npx -y https://20cuts.com/releases/v0.3.0/20cuts-create-0.3.0.tgz video/20cuts
cd video/20cuts
npm ci
npm run studio
```

The installer includes this component, its source dependencies, runnable examples,
and skills for Codex and Claude Code. If 20cuts is already installed, import the
component from its existing source directory.

## Usage

```tsx
import { ValueSwap } from "./system/motion";

export default function VideoScene() {
  return (
    <ValueSwap from="Processing" to="Published" at={1.8} duration={0.6} style={{fontSize: 80}} />
  );
}
```


## Props

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| from (required) | ReactNode | None | Content before the change. |
| to (required) | ReactNode | None | Content after the change. |
| at | number | 0 | Start time in seconds within the current Remotion Sequence. |
| duration | number | 0.5 | Animation duration in seconds. |
| style | CSSProperties | None | Styles applied to the component wrapper. |

Both values share one grid cell, reserving the larger value's space throughout the change.

## Complete example

This is the source of the fictional component demonstration. Replace its content
with supported behavior and assets from your product.

```tsx
import React, { type CSSProperties, type ReactNode } from "react";

import { AbsoluteFill } from "remotion";

import { ValueSwap } from "./system";

const ink = "#141414", lime = "#b6f36b";

const center: CSSProperties = { display: "flex", alignItems: "center", justifyContent: "center" };

function Stage({ children, dark = false, style }: {
    children: ReactNode;
    dark?: boolean;
    style?: CSSProperties;
}) {
    return <AbsoluteFill style={{ fontFamily: "Arial, Helvetica, sans-serif", color: dark ? "#fff" : ink, background: dark ? ink : "#f7f7f5", ...center, ...style }}>{children}</AbsoluteFill>;
}

export function ValueSwapExample() { return <Stage dark><div style={{ textAlign: "center" }}><div style={{ fontSize: 28, color: "#aaa", marginBottom: 32 }}>One less step.</div><ValueSwap from="In progress" to="Published" at={1.8} duration={0.8} style={{ fontSize: 100, fontWeight: 650, letterSpacing: "-0.055em", color: lime }}/></div></Stage>; }
```

Save it as src/ValueSwapExample.tsx. This demonstration uses
1280×720, 30fps and 180 frames.
For a separate entry point, replace src/index.tsx with this registration, then
run npm run studio:

```tsx
import { Composition, registerRoot } from "remotion";
import { ValueSwapExample } from "./ValueSwapExample";

registerRoot(() => (
  <Composition
    id="ValueSwapExample"
    component={ValueSwapExample}
    width={1280}
    height={720}
    fps={30}
    durationInFrames={180}
  />
));
```

## Source

- https://20cuts.com/animation-system/library/source/motion/effects.tsx
- https://20cuts.com/animation-system/library/source/motion/core.ts

## Agent instructions

Use the 20cuts ValueSwap component in this project's Remotion composition. Change a product status from its real pending state to its real result using a 0.6-second fade-through; avoid a layout jump. Keep motion frame-driven and put timing in seconds relative to the current Sequence. Use the product's actual copy and assets. Preview the composition before rendering.