Filmstrip timeline clips

Frames edge to edge, cropped to fill, with the name in its own 15px band above the picture.

audited 4 boundariestrusting 0not exercised 4decisions 0Studio @ 45b8e171e2792c89cc63b4d136de41eae6194b25
In one breath. Studio owns the name and picture wrapper; thumbnail components own cropping; a host can replace the content and override the CSS tokens.

Where the value travels

flowchart LR A[App or host] --> B[TimelinePane] --> C[TimelineClip] C --> D[renderClipChildren] D --> E[useRenderClipContent] E --> F[Thumbnail components] G[Host CSS overrides] --> C classDef audited fill:#e8f6ee,stroke:#178a5a,color:#0f3d28 class A,B,C,D,E,F,G audited

Source reachability is audited. No running build has been exercised.

The contract, per boundary

1. Clip-content callback

The same callback builds picture content for Studio and embedding hosts.

renderClipContent(element, clipStyle, context)

if (!pid) return null;

return createElement(CompositionThumbnail, {
  previewUrl: buildProjectApiPath(pid, `/preview/comp/${encodePreviewPath(compSrc)}`),
  label: "",
  labelColor: style.label,
producer: src/hooks/useRenderClipContent.ts:136,166; accepting call: src/player/components/timelineClipChildren.tsx:67; app handoff: src/App.tsx:530; pane: src/components/nle/TimelinePane.tsx:107; package export: src/index.ts:67
exists: yesreachable: source auditedwritten/read: yesruntime: not exercised

2. Picture wrapper and name

The clip button supplies the name separately. The content wrapper currently fills the whole button.

const showLabel = ladder === "labeled";
{showLabel && <span className="timeline-clip__label">{displayLabel}</span>}

<div
  className="absolute inset-0 overflow-hidden"
  style={{ borderRadius: "inherit", pointerEvents: "none" }}
>
name producer and consumer: src/player/components/TimelineClip.tsx:74,212; content consumer: src/player/components/timelineClipChildren.tsx:63; name paint: src/styles/components.css:334
exists: yesreachable: source auditedwritten/read: yesruntime: not exercised

3. Frame layout and fit

Video and image tiles already fill their rectangles. Composition tiles contain the picture, which leaves letterboxing.

const frameW = Math.max(minFrameWidth, Math.round(clipHeight * safeAspect));
const frameCount = measured ? Math.max(1, Math.ceil(containerWidth / frameW)) : 1;

// CompositionThumbnail rendered image class:
className="absolute inset-0 h-full w-full object-contain"
layout producer: src/player/components/thumbnailUtils.ts:75; consumer: CompositionThumbnail.tsx:161; image consumer: CompositionThumbnail.tsx:185; video and image fit: VideoThumbnail.tsx:138, ImageThumbnail.tsx:61
exists: yesreachable: source auditedwritten/read: yesruntime: not exercised

4. Theme and host overrides

Changing the Studio defaults alone does not change an embedding host that writes its own token values or selection styles.

--timeline-clip-radius: 8px;
--timeline-clip-audio-radius: 21px;

clipRadius: "var(--timeline-clip-radius)",

.timeline-clip.is-selected {
  outline: 1.5px solid var(--timeline-clip-selection);
  outline-offset: -1.5px;
}
token producer: src/styles/theme.css:122; token consumer: src/player/components/timelineTheme.ts:73, TimelineClip.tsx:109; selection consumer: src/styles/components.css:307; package exports: package.json:39-43. Host override audit is local only; runtime propagation has not been tested.
exists: yesreachable: source auditedwritten/read: yesruntime: not exercised

How it says no

SignalOwnerMeaning
nulluseRenderClipContent:142No active project. No picture returned.
Hidden thumbnail modeuseRenderClipContent:148Pictures are suppressed; sound content follows the existing waveform path.
Loading or error snapshotThumbnail componentA picture is not ready. The band must keep its geometry while the existing loading/error state paints below.
Under 60pxclipWidthLadderThe baseline hides the label. The approved Filmstrip keeps the name band for visual clips; audio retains the width ladder. The full name remains on the button's accessible label and title.

Approved specification

Match the selected Filmstrip prototype: a dark 15px name band, no picture dimming, zero frame gap, a 1px selection ring, and 12px corners on video and image clips. Audio keeps its current radius. Composition pictures keep contain fitting.

The band-colour ambiguity is resolved. No open product decision remains.

Coverage, honestly

AuditedThe callback producer, both app and host handoffs, picture wrapper, thumbnail layout, CSS paint, package exports, and host overrides.
TrustingNone of the load-bearing claims above rely on comments or mocks.
Not exercisedStudio and host rendered builds, browser layout, selection/trim/fade hit targets, light and dark contrast, narrow clips.

What would prove this page wrong