Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

7.5 KB
Raw Blame
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;
};