Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
import type { FrameSpan } from "@hypit/composition";
import type {
FontArtifactRef,
SynchronizedMedia,
} from "@hypit/media";
import type { BlobRef } from "@hypit/hypit/protocol";
import type { SpatialFrame } from "@hypit/spatial";
import type { TemporalInstant, TemporalWindow } from "@hypit/temporal";
export type RankingVariant = "tier-board" | "column" | "top-three";
export type RankingHeader = {
readonly id: string;
readonly variant: RankingVariant;
};
export type TriggeredRankingScheduleEntry = {
readonly itemId: string;
readonly triggerFrame: number;
readonly stage: FrameSpan;
readonly cumulative: FrameSpan;
readonly settled: FrameSpan;
};
export type TriggeredRankingSchedule = {
readonly id: string;
readonly variant: "top-three";
readonly outer: FrameSpan;
readonly terminalFrame: number;
readonly entries: readonly TriggeredRankingScheduleEntry[];
};
export type TriggeredRankingCandidate = {
readonly itemId: string;
readonly activation: TemporalInstant;
};
export type TriggeredRankingCandidateSet = {
readonly entries: readonly TriggeredRankingCandidate[];
};
export type RankingWindowInput = {
readonly itemId: string;
readonly window: TemporalWindow;
};
export type RankingWindowSet = {
readonly entries: readonly RankingWindowInput[];
};
export type TierBoardWindowSet = RankingWindowSet;
export type ColumnWindowSet = RankingWindowSet;
export type WindowedRankingScheduleEntry =
| {
readonly itemId: string;
readonly mode: "preset";
readonly settled: FrameSpan;
}
| {
readonly itemId: string;
readonly mode: "reveal";
readonly window: FrameSpan;
readonly settled: FrameSpan;
};
export type TierBoardSchedule = {
readonly id: string;
readonly variant: "tier-board";
readonly outer: FrameSpan;
readonly entries: readonly WindowedRankingScheduleEntry[];
};
export type ColumnSchedule = {
readonly id: string;
readonly variant: "column";
readonly outer: FrameSpan;
readonly entries: readonly WindowedRankingScheduleEntry[];
};
export type RankingSchedule = TriggeredRankingSchedule | TierBoardSchedule | ColumnSchedule;
export type RankingTextStyle = {
readonly fonts: readonly FontArtifactRef[];
readonly sizePx: number;
readonly weight: number;
readonly color: string;
readonly lineHeight: number;
};
export type RankingBoardPaint = {
readonly background: string;
readonly borderColor: string;
readonly borderWidthPx: number;
readonly radiusPx: number;
readonly shadow: {
readonly offsetX: number;
readonly offsetY: number;
readonly blurPx: number;
readonly spreadPx: number;
readonly color: string;
};
};
export type RankingMotionStyle = {
readonly appearFrames: number;
readonly moveFrames: number;
readonly easing: "linear" | "ease-in" | "ease-out" | "ease-in-out";
};
export type TierBoardMotionStyle = {
readonly appearFrames: number;
readonly moveFrames: number;
};
export type RankingSoundStyle = {
readonly appearGain: number;
readonly moveGain: number;
readonly fadeFrames: number;
};
export type TierRowStyle = {
readonly id: string;
readonly label: string;
readonly color: string;
};
export type TierBoardStyle = {
readonly rows: readonly TierRowStyle[];
readonly fonts: readonly FontArtifactRef[];
readonly labelTextColor: string;
readonly labelSizeRatio: number;
readonly labelLineHeight: number;
readonly boardColor: string;
readonly borderColor: string;
readonly borderWidthPx: number;
readonly labelWidthRatio?: number;
readonly stagePoint: { readonly x: number; readonly y: number };
readonly stageSizePx: number;
readonly iconRadiusRatio: number;
readonly iconFit: "contain" | "cover";
readonly motion: TierBoardMotionStyle;
readonly boardStackingOrder: number;
readonly stageStackingOrder: number;
readonly itemStackingOrder: number;
};
export type ColumnStyle = {
readonly board: RankingBoardPaint;
readonly text: RankingTextStyle;
readonly rankColors: readonly string[];
readonly paddingPx: number;
readonly rowHeightPx: number;
readonly rowGapPx: number;
readonly iconSizePx: number;
readonly iconRadiusPx: number;
readonly iconFit: "contain" | "cover";
readonly stagePoint: { readonly x: number; readonly y: number };
readonly stageSizePx: number;
readonly motion: RankingMotionStyle;
readonly boardStackingOrder: number;
readonly stageStackingOrder: number;
readonly itemStackingOrder: number;
};
export type TopThreeStyle = {
readonly text: RankingTextStyle;
readonly slotColors: readonly string[];
readonly centerX: number;
readonly baselineY: number;
readonly slotGapPx: number;
readonly iconSizePx: number;
readonly iconRadiusPx: number;
readonly iconFit: "contain" | "cover";
readonly ringWidthPx: number;
readonly labelGapPx: number;
readonly motion: RankingMotionStyle;
readonly boardStackingOrder: number;
readonly itemStackingOrder: number;
};
type TierBoardItemBase = {
readonly variant: "tier-board";
readonly id: string;
readonly tier: string;
readonly stackingOrder?: number;
};
export type TierBoardItemSpec = TierBoardItemBase & (
| { readonly preset: true }
| { readonly preset: false; readonly entry: "direct" | "drop" }
);
export type ColumnItemSpec = {
readonly variant: "column";
readonly id: string;
readonly label: string;
readonly rank: number;
readonly preset: boolean;
readonly stackingOrder?: number;
};
export type TopThreeItemSpec = {
readonly variant: "top-three";
readonly id: string;
readonly label: string;
readonly stackingOrder?: number;
};
export type RankingItemSpec = TierBoardItemSpec | ColumnItemSpec | TopThreeItemSpec;
/** Structural half of an Item whose visible copy arrives on a Text graph edge. */
export type RankingTextItemShell =
| Omit<ColumnItemSpec, "label">
| Omit<TopThreeItemSpec, "label">;
export type RankingItemSpecSet = {
readonly variant: RankingVariant;
readonly items: readonly RankingItemSpec[];
};
export type TierBoardItem = TierBoardItemSpec & { readonly icon: BlobRef };
export type ColumnItem = ColumnItemSpec & { readonly icon?: BlobRef };
export type TopThreeItem = TopThreeItemSpec & { readonly icon?: BlobRef };
export type TierBoardItemSet = {
readonly items: readonly TierBoardItem[];
};
export type ColumnItemSet = {
readonly items: readonly ColumnItem[];
};
export type TopThreeItemSet = {
readonly items: readonly TopThreeItem[];
};
export type TierBoardProgram = {
readonly id: string;
readonly within: SpatialFrame;
readonly frame: SpatialFrame;
readonly schedule: TierBoardSchedule;
readonly style: TierBoardStyle;
readonly items: readonly TierBoardItem[];
};
export type ColumnProgram = {
readonly id: string;
readonly within: SpatialFrame;
readonly frame: SpatialFrame;
readonly schedule: ColumnSchedule;
readonly style: ColumnStyle;
readonly items: readonly ColumnItem[];
};
export type TopThreeProgram = {
readonly id: string;
readonly frame: SpatialFrame;
readonly schedule: TriggeredRankingSchedule;
readonly style: TopThreeStyle;
readonly items: readonly TopThreeItem[];
};
export type RankingProgram = TierBoardProgram | ColumnProgram | TopThreeProgram;
export type RankingSoundEvent = {
readonly id: string;
readonly itemId: string;
readonly kind: "appear" | "move";
readonly frame: number;
};
export type RankingSoundEventPlan = {
readonly id: string;
readonly variant: RankingVariant;
readonly events: readonly RankingSoundEvent[];
};
export type RankingSoundSet = {
readonly appear?: SynchronizedMedia;
readonly move?: SynchronizedMedia;
};