@hypit/hypit 0.1.2 → 0.1.4

package/packages/studio/src/temporal-edit.ts

@@ -0,0 +1,131 @@
+import type { StudioEditHandle, StudioSemanticAnchor, StudioTemporalInstantProjection } from "@hypit/studio-adapter";
+
+export type SemanticTarget =
+  | { readonly kind: "selection"; readonly startAnchorId: string; readonly endAnchorId: string }
+  | { readonly kind: "moment"; readonly anchorId: string };
+
+type Span = { readonly startFrame: number; readonly endFrameExclusive: number };
+
+/** Project only the semantic write exposed by the handle. This does not invert expressions. */
+export function semanticGestureSpan(
+  anchors: readonly StudioSemanticAnchor[], handle: StudioEditHandle, target: SemanticTarget,
+): Span | undefined {
+  const semantic = handle.semantic;
+  const temporal = handle.temporal;
+  if (!semantic || !temporal || target.kind !== semantic.kind) return undefined;
+  const byId = new Map(anchors.map((anchor, order) => [anchor.id, { ...anchor, order }]));
+  let span: Span;
+  if (semantic.kind === "moment" && target.kind === "moment") {
+    const previous = byId.get(semantic.anchorId);
+    const next = byId.get(target.anchorId);
+    if (!previous || !next) return undefined;
+    const delta = next.frame - previous.frame;
+    span = temporal.kind === "instant"
+      ? { startFrame: temporal.frame + delta, endFrameExclusive: temporal.frame + delta + 1 }
+      : { startFrame: temporal.startFrame + delta, endFrameExclusive: temporal.endFrameExclusive + delta };
+  } else if (semantic.kind === "selection" && target.kind === "selection") {
+    const start = byId.get(target.startAnchorId);
+    const end = byId.get(target.endAnchorId);
+    if (!start || !end || start.order > end.order) return undefined;
+    if (temporal.kind === "instant") {
+      if (temporal.authority.kind !== "semantic") return undefined;
+      if (temporal.authority.boundary === "start" && target.endAnchorId !== semantic.endAnchorId
+        || temporal.authority.boundary === "end" && target.startAnchorId !== semantic.startAnchorId) return undefined;
+      const frame = temporal.authority.boundary === "start" ? start.frame : end.frame;
+      span = { startFrame: frame, endFrameExclusive: frame + 1 };
+    } else {
+      if (handle.gesture === "trim-start" && target.endAnchorId !== semantic.endAnchorId
+        || handle.gesture === "trim-end" && target.startAnchorId !== semantic.startAnchorId) return undefined;
+      if (handle.gesture === "move") {
+        const stops = [...new Set(anchors.map((anchor) => anchor.frame))].sort((a, b) => a - b);
+        const previousStart = byId.get(semantic.startAnchorId);
+        const previousEnd = byId.get(semantic.endAnchorId);
+        if (!previousStart || !previousEnd
+          || stops.indexOf(start.frame) - stops.indexOf(previousStart.frame)
+            !== stops.indexOf(end.frame) - stops.indexOf(previousEnd.frame)) return undefined;
+      }
+      span = { startFrame: start.frame, endFrameExclusive: end.frame };
+    }
+  } else return undefined;
+  if (!Number.isSafeInteger(span.startFrame) || span.startFrame < 0
+    || !Number.isSafeInteger(span.endFrameExclusive) || span.endFrameExclusive <= span.startFrame) return undefined;
+  if (temporal.kind === "window"
+    && ((handle.gesture === "trim-start" && span.endFrameExclusive !== temporal.endFrameExclusive)
+      || (handle.gesture === "trim-end" && span.startFrame !== temporal.startFrame))) return undefined;
+  return span;
+}
+
+/** A stop is a frame position; coincident anchors remain distinct choices at that stop. */
+export function chooseSemanticGesture(input: {
+  readonly anchors: readonly StudioSemanticAnchor[];
+  readonly handle: StudioEditHandle;
+  readonly pointerStart: number;
+  readonly pointerNow: number;
+  readonly frameCount: number;
+}): SemanticTarget | undefined {
+  const { anchors, handle } = input;
+  const semantic = handle.semantic;
+  const temporal = handle.temporal;
+  if (!semantic || !temporal) return undefined;
+  const order = new Map(anchors.map((anchor, index) => [anchor.id, index]));
+  const byId = new Map(anchors.map((anchor) => [anchor.id, anchor]));
+  const at = new Map<number, StudioSemanticAnchor[]>();
+  for (const anchor of anchors) at.set(anchor.frame, [...at.get(anchor.frame) ?? [], anchor]);
+  const stops = [...at.keys()].sort((a, b) => a - b);
+  const ranked = (choices: readonly StudioSemanticAnchor[], preferred: StudioSemanticAnchor) => [...choices].sort((a, b) =>
+    Number(a.id !== preferred.id) - Number(b.id !== preferred.id)
+    || Number(a.kind !== preferred.kind) - Number(b.kind !== preferred.kind)
+    || order.get(a.id)! - order.get(b.id)!);
+  const valid = (target: SemanticTarget) => {
+    const span = semanticGestureSpan(anchors, handle, target);
+    return span !== undefined && (temporal.kind === "instant" ? span.startFrame : span.endFrameExclusive) <= input.frameCount;
+  };
+  const delta = input.pointerNow - input.pointerStart;
+  if (semantic.kind === "moment") {
+    const current = byId.get(semantic.anchorId);
+    if (!current) return undefined;
+    const candidates = ranked(anchors, current).sort((a, b) =>
+      Math.abs(a.frame - current.frame - delta) - Math.abs(b.frame - current.frame - delta));
+    return candidates.map((anchor): SemanticTarget => ({ kind: "moment", anchorId: anchor.id })).find(valid);
+  }
+  const start = byId.get(semantic.startAnchorId);
+  const end = byId.get(semantic.endAnchorId);
+  if (!start || !end) return undefined;
+  const target = (a: StudioSemanticAnchor, b: StudioSemanticAnchor): SemanticTarget => ({
+    kind: "selection", startAnchorId: a.id, endAnchorId: b.id,
+  });
+  if (handle.gesture === "move" && temporal.kind === "window") {
+    const first = stops.indexOf(start.frame);
+    const last = stops.indexOf(end.frame);
+    const shifts = stops.map((_, index) => index - first)
+      .filter((shift) => last + shift >= 0 && last + shift < stops.length)
+      .sort((a, b) => Math.abs(stops[first + a]! - start.frame - delta)
+        - Math.abs(stops[first + b]! - start.frame - delta) || Math.abs(a) - Math.abs(b));
+    for (const shift of shifts) {
+      for (const a of ranked(at.get(stops[first + shift]!)!, start)) {
+        for (const b of ranked(at.get(stops[last + shift]!)!, end)) {
+          const candidate = target(a, b);
+          if (valid(candidate)) return candidate;
+        }
+      }
+    }
+    return undefined;
+  }
+  const boundary = temporal.kind === "instant" && temporal.authority.kind === "semantic"
+    ? temporal.authority.boundary : handle.gesture === "trim-start" ? "start" : "end";
+  const current = boundary === "start" ? start : end;
+  const candidates = ranked(anchors, current).sort((a, b) =>
+    Math.abs(a.frame - current.frame - delta) - Math.abs(b.frame - current.frame - delta));
+  return candidates.map((anchor) => boundary === "start" ? target(anchor, end) : target(start, anchor)).find(valid);
+}
+
+
+/** Keep the reference and write its local frame offset; a bare reference starts at zero. */
+export function formatTemporalPointEdit(
+  reference: StudioTemporalInstantProjection["reference"], desired: number, base?: number,
+): string {
+  if (reference === "absolute") return `${desired}f`;
+  if (base === undefined) throw new Error(`The ${reference} projection base is unavailable.`);
+  const offset = desired - base;
+  return `${reference}${offset >= 0 ? "+" : ""}${offset}f`;
+}

package/packages/studio/src/ui/artifact-name.ts

@@ -0,0 +1,80 @@
+/** Two-line label with an expanding editor; the caller owns persistence. */
+export function createArtifactName(options: {
+  readonly name: string;
+  readonly editable: boolean;
+  readonly select: () => void;
+  readonly save: (name: string) => Promise<string>;
+}) {
+  const element = document.createElement("div");
+  element.className = "artifact-copy";
+  const label = document.createElement("button");
+  label.type = "button";
+  label.className = "artifact-name";
+  let name = options.name;
+  const text = document.createElement("span");
+  text.className = "artifact-name-text";
+  text.textContent = name;
+  label.append(text);
+  label.title = options.editable ? `${name}\nDouble-click or press F2 to rename` : `${name}\nNaming is available when this Build finishes`;
+  element.append(label);
+  label.addEventListener("click", (event) => { event.stopPropagation(); options.select(); });
+  let editing = false;
+
+  function edit(): void {
+    if (editing || !options.editable) return;
+    options.select();
+    editing = true;
+    element.classList.add("editing");
+    label.hidden = true;
+    const field = document.createElement("textarea");
+    field.className = "artifact-name-editor";
+    field.value = name;
+    field.rows = 1;
+    field.setAttribute("aria-label", "Display name");
+    const error = document.createElement("span");
+    error.className = "artifact-name-error";
+    error.setAttribute("role", "status");
+    element.append(field, error);
+    const resize = () => { field.style.height = "0px"; field.style.height = `${field.scrollHeight + field.offsetHeight - field.clientHeight}px`; };
+    resize();
+    field.focus();
+    field.setSelectionRange(name.length, name.length);
+    field.addEventListener("input", resize);
+    field.addEventListener("click", (event) => event.stopPropagation());
+    let saving = false;
+    const close = () => {
+      editing = false;
+      field.remove();
+      error.remove();
+      label.hidden = false;
+      element.classList.remove("editing");
+    };
+    const save = async () => {
+      if (!editing || saving) return;
+      const value = field.value.trim();
+      if (value === name) { close(); return; }
+      if (value.length === 0) { error.textContent = "Enter a name."; return; }
+      saving = true;
+      field.readOnly = true;
+      error.textContent = "Saving…";
+      try {
+        name = await options.save(value);
+        text.textContent = name;
+        label.title = `${name}\nDouble-click or press F2 to rename`;
+        close();
+      } catch (cause) {
+        error.textContent = cause instanceof Error ? cause.message : String(cause);
+      } finally {
+        saving = false;
+        field.readOnly = false;
+      }
+    };
+    field.addEventListener("blur", () => { void save(); });
+    field.addEventListener("keydown", (event) => {
+      if (event.key === "Escape" && !saving) { event.preventDefault(); event.stopPropagation(); close(); label.focus(); }
+      else if (event.key === "Enter" && !event.shiftKey) { event.preventDefault(); void save(); }
+    });
+  }
+  label.addEventListener("dblclick", (event) => { event.preventDefault(); event.stopPropagation(); edit(); });
+  return { element, edit };
+}

package/packages/studio/src/ui/artifact-preview.ts

@@ -0,0 +1,99 @@
+import type { StudioArtifactView } from "../shared.js";
+import { audioPreview } from "./material-preview.js";
+
+/** A media viewer only: it does not change the composition or its playhead. */
+export function createArtifactPreview(changed: () => void) {
+  const element = document.createElement("div");
+  element.className = "stage-artifact";
+  element.hidden = true;
+  let selected: StudioArtifactView | undefined;
+  let media: HTMLMediaElement | undefined;
+  let generation = 0;
+
+  function close(): void {
+    generation += 1;
+    selected = undefined;
+    if (media !== undefined) {
+      media.pause();
+      media.removeAttribute("src");
+      media.load();
+    }
+    media = undefined;
+    element.replaceChildren();
+    element.hidden = true;
+  }
+
+  function open(artifact: StudioArtifactView, muted: boolean): void {
+    close();
+    const current = generation;
+    selected = artifact;
+    element.hidden = false;
+    const url = `/__studio/artifact?${new URLSearchParams({ build: artifact.build, output: artifact.output })}`;
+    const error = document.createElement("p");
+    error.className = "stage-media-error";
+    error.hidden = true;
+    error.setAttribute("role", "status");
+    const failed = () => {
+      if (generation !== current) return;
+      error.textContent = "This media could not be opened in the browser.";
+      error.hidden = false;
+      changed();
+    };
+    if (artifact.mediaType.startsWith("image/")) {
+      const image = document.createElement("img");
+      image.alt = artifact.displayName ?? artifact.output;
+      image.addEventListener("error", failed);
+      image.src = url;
+      element.append(image);
+    } else {
+      const audio = artifact.mediaType.startsWith("audio/");
+      const player = document.createElement(audio ? "audio" : "video");
+      media = player;
+      if (player instanceof HTMLVideoElement) player.playsInline = true;
+      player.preload = "metadata";
+      player.muted = muted;
+      for (const event of ["loadedmetadata", "durationchange", "timeupdate", "play", "pause", "ended", "seeking", "seeked"]) {
+        player.addEventListener(event, () => { if (generation === current) changed(); });
+      }
+      player.addEventListener("error", failed);
+      player.src = url;
+      element.append(player);
+      if (audio) {
+        const wave = document.createElement("div");
+        wave.className = "stage-audio-wave";
+        wave.textContent = "Audio";
+        element.append(wave);
+        void audioPreview(url).then((waveform) => {
+          if (generation !== current || waveform === undefined) return;
+          const image = document.createElement("img");
+          image.src = waveform;
+          image.alt = "Audio waveform";
+          wave.replaceChildren(image);
+        });
+      }
+    }
+    element.append(error);
+    changed();
+  }
+
+  function seek(seconds: number): void {
+    if (media === undefined || !Number.isFinite(media.duration)) return;
+    media.currentTime = Math.max(0, Math.min(media.duration, seconds));
+    changed();
+  }
+
+  function toggle(): void {
+    const player = media;
+    if (player === undefined) return;
+    if (!player.paused) player.pause();
+    else {
+      if (player.ended) player.currentTime = 0;
+      void player.play().catch(() => changed());
+    }
+  }
+
+  return { element, open, close, seek, toggle,
+    get selected() { return selected; },
+    get media() { return media; },
+  };
+}

package/packages/studio/src/ui/icons.ts

@@ -14,7 +14,6 @@ const paths: Readonly<Record<string, string>> = {
   results: '<path d="M4 8v12h16V8M3 4h18v4H3zM9 12h6"/>',
   run: '<circle cx="12" cy="12" r="9"/><path d="m10 8 6 4-6 4V8Z"/>',
   image: '<rect x="3" y="4" width="18" height="16" rx="2"/><circle cx="8.5" cy="9" r="2"/><path d="m4 18 5-5 3 3 3-4 5 6"/>',
-  sidebarCollapse: '<rect x="3" y="4" width="18" height="16" rx="2"/><path d="M8 4v16m7-11-3 3 3 3"/>',
   wrap: '<path d="M4 6h16M4 10h12a4 4 0 0 1 0 8h-5m3-3-3 3 3 3M4 14h5M4 18h4"/>',
   timeline: '<path d="M3 6h18M3 12h18M3 18h18"/><path d="M8 4v4M16 10v4M11 16v4"/>',
   minus: '<path d="M5 12h14"/>',
@@ -40,6 +39,11 @@ const paths: Readonly<Record<string, string>> = {
   layers: '<path d="m12 3 9 5-9 5-9-5 9-5Z"/><path d="m3 12 9 5 9-5M3 16l9 5 9-5"/>',
   ranking: '<path d="M5 19V9h4v10M10 19V5h4v14M15 19v-7h4v7M3 19h18"/>',
   refresh: '<path d="M20 7v5h-5M4 17v-5h5"/><path d="M18.5 9a7 7 0 0 0-11.8-2.3L4 9M5.5 15a7 7 0 0 0 11.8 2.3L20 15"/>',
+  check: '<circle cx="12" cy="12" r="9"/><path d="m8 12 3 3 5-6"/>',
+  alert: '<circle cx="12" cy="12" r="9"/><path d="M12 7v6M12 17h.01"/>',
+  arrowRight: '<path d="M5 12h14m-6-6 6 6-6 6"/>',
+  close: '<path d="m6 6 12 12M18 6 6 18"/>',
+  panel: '<rect x="3" y="4" width="18" height="16" rx="2"/><path d="M8 4v16M8 9h13"/>',
 };
 
 export function icon(name: string, className = "icon"): string {