diff --git a/.fallowrc.jsonc b/.fallowrc.jsonc
index 3a9925d703..3b9d615a64 100644
--- a/.fallowrc.jsonc
+++ b/.fallowrc.jsonc
@@ -55,6 +55,11 @@
"packages/studio/src/hooks/gsapRuntimePreview.ts",
// TEMP(studio-dnd): shipped unwired ahead of the NLE integration;
// consumers land in studio-dnd/pr07-nle-integration-wiring, which removes this block.
+ "packages/studio/src/components/nle/AssetPreviewOverlay.tsx",
+ "packages/studio/src/player/components/timelineClipDragTypes.ts",
+ "packages/studio/src/utils/assetPreviewStore.ts",
+ // TEMP(studio-dnd): shipped unwired ahead of the NLE integration;
+ // consumers land in studio-dnd/pr07-nle-integration-wiring, which removes this block.
"packages/studio/src/components/editor/CanvasContextMenu.tsx",
],
"ignorePatterns": [
diff --git a/packages/studio/src/components/nle/AssetPreviewOverlay.tsx b/packages/studio/src/components/nle/AssetPreviewOverlay.tsx
new file mode 100644
index 0000000000..5364289f15
--- /dev/null
+++ b/packages/studio/src/components/nle/AssetPreviewOverlay.tsx
@@ -0,0 +1,147 @@
+/**
+ * CapCut-style asset preview overlay rendered inside PreviewPane.
+ *
+ * Shown when the user clicks an asset card that has NOT yet been added to the
+ * timeline. Displays the media (image / video / audio) without modifying the
+ * composition — no undo entry, no file mutation.
+ *
+ * Dismiss: X button, Escape key, or click on the scrim.
+ * Switching to another not-added asset replaces the current preview.
+ */
+import { useEffect, useCallback } from "react";
+import { VIDEO_EXT, IMAGE_EXT } from "../../utils/mediaTypes";
+import { useAssetPreviewStore } from "../../utils/assetPreviewStore";
+
+function basename(path: string): string {
+ return path.split("/").pop() ?? path;
+}
+
+type AssetKind = "image" | "video" | "audio";
+
+function resolveAssetKind(path: string): AssetKind {
+ if (VIDEO_EXT.test(path)) return "video";
+ if (IMAGE_EXT.test(path)) return "image";
+ return "audio";
+}
+
+/** The media element for a previewed asset, chosen by kind. */
+function AssetPreviewMedia({
+ kind,
+ serveUrl,
+ name,
+}: {
+ kind: AssetKind;
+ serveUrl: string;
+ name: string;
+}) {
+ if (kind === "image") {
+ return (
+
+ );
+ }
+ if (kind === "video") {
+ return (
+
+ );
+ }
+ return (
+
+ );
+}
+
+export function AssetPreviewOverlay() {
+ const previewAsset = useAssetPreviewStore((s) => s.previewAsset);
+ const previewProjectId = useAssetPreviewStore((s) => s.previewProjectId);
+ const clearPreviewAsset = useAssetPreviewStore((s) => s.clearPreviewAsset);
+
+ const handleKeyDown = useCallback(
+ (e: KeyboardEvent) => {
+ if (e.key === "Escape") clearPreviewAsset();
+ },
+ [clearPreviewAsset],
+ );
+
+ useEffect(() => {
+ if (!previewAsset) return;
+ window.addEventListener("keydown", handleKeyDown);
+ return () => window.removeEventListener("keydown", handleKeyDown);
+ }, [previewAsset, handleKeyDown]);
+
+ if (!previewAsset || !previewProjectId) return null;
+
+ const encodedAsset = previewAsset.split("/").map(encodeURIComponent).join("/");
+ const serveUrl = `/api/projects/${previewProjectId}/preview/${encodedAsset}`;
+ const name = basename(previewAsset);
+
+ return (
+
+ {/* Close button */}
+
+
+ {/* Media */}
+
e.stopPropagation()}
+ >
+
+
+ {/* Filename label */}
+
+ {name}
+
+
+
+ );
+}
diff --git a/packages/studio/src/player/components/timelineClipDragTypes.ts b/packages/studio/src/player/components/timelineClipDragTypes.ts
new file mode 100644
index 0000000000..397ed87f13
--- /dev/null
+++ b/packages/studio/src/player/components/timelineClipDragTypes.ts
@@ -0,0 +1,54 @@
+import type { TimelineElement } from "../store/playerStore";
+import type { TimelineSnapType } from "./timelineSnapping";
+import type { BlockedTimelineEditIntent } from "./timelineEditing";
+
+/* ── Shared clip-drag state types ───────────────────────────────── */
+export interface DraggedClipState {
+ element: TimelineElement;
+ originClientX: number;
+ originClientY: number;
+ originScrollLeft: number;
+ originScrollTop: number;
+ pointerClientX: number;
+ pointerClientY: number;
+ pointerOffsetX: number;
+ pointerOffsetY: number;
+ previewStart: number;
+ previewTrack: number;
+ /**
+ * When non-null, the drop inserts a NEW track at this visual row boundary
+ * (0 = above the top lane, trackOrder.length = below the bottom) instead of
+ * landing on previewTrack. Drives the insertion-line indicator.
+ */
+ insertRow: number | null;
+ /** Snap target the clip will land on, for the guide highlight. */
+ snapTime: number | null;
+ snapType: TimelineSnapType | null;
+ started: boolean;
+}
+
+export interface ResizingClipState {
+ element: TimelineElement;
+ edge: "start" | "end";
+ originClientX: number;
+ /**
+ * scrollLeft at gesture start. Edge auto-scroll moves the content under a
+ * stationary pointer, so the trim math folds (current − origin) scrollLeft
+ * into the pointer x — mirroring resolveTimelineMove's scroll compensation.
+ * Optional so pre-existing constructors/tests stay valid; when absent the
+ * first preview update captures the current scrollLeft.
+ */
+ originScrollLeft?: number;
+ previewStart: number;
+ previewDuration: number;
+ previewPlaybackStart?: number;
+ started: boolean;
+}
+
+export interface BlockedClipState {
+ element: TimelineElement;
+ intent: BlockedTimelineEditIntent;
+ originClientX: number;
+ originClientY: number;
+ started: boolean;
+}
diff --git a/packages/studio/src/utils/assetPreviewStore.ts b/packages/studio/src/utils/assetPreviewStore.ts
new file mode 100644
index 0000000000..e0022182e4
--- /dev/null
+++ b/packages/studio/src/utils/assetPreviewStore.ts
@@ -0,0 +1,31 @@
+/**
+ * Tiny Zustand slice that carries the "asset preview overlay" state.
+ *
+ * When a user clicks an asset card that has NOT yet been added to the
+ * timeline the overlay fires up: a dark scrim + centered media element
+ * (img / video / audio) + filename label rendered inside PreviewPane.
+ *
+ * State lives here so AssetsTab (sidebar) and PreviewPane (preview column)
+ * can communicate without prop-drilling through the multi-layer EditorShell
+ * tree. The store is project-scoped: clearing it on project change keeps
+ * stale previews from bleeding across projects.
+ */
+import { create } from "zustand";
+
+interface AssetPreviewState {
+ /** Project-relative asset path currently being previewed, or null. */
+ previewAsset: string | null;
+ /** projectId for which the preview was opened (used to build the serve URL). */
+ previewProjectId: string | null;
+ /** Open a media preview for the given asset. */
+ setPreviewAsset: (asset: string, projectId: string) => void;
+ /** Close the preview overlay. */
+ clearPreviewAsset: () => void;
+}
+
+export const useAssetPreviewStore = create((set) => ({
+ previewAsset: null,
+ previewProjectId: null,
+ setPreviewAsset: (asset, projectId) => set({ previewAsset: asset, previewProjectId: projectId }),
+ clearPreviewAsset: () => set({ previewAsset: null, previewProjectId: null }),
+}));