@arbidocs/blocks 0.5.119 → 0.5.121

package/dist/presentation/model.js

@@ -0,0 +1,271 @@
+"use client";
+const SLIDE_LAYOUTS = [
+  "clips",
+  "points",
+  "compare",
+  "title",
+  "section",
+  "free"
+];
+const STAGE_ASPECT = 16 / 9;
+const STAGE_MARGIN = 0.03;
+const STAGE_GAP = 0.02;
+const MIN_FRAME_WIDTH = 0.05;
+const SNAP_DISTANCE = 0.012;
+const CAPTION_SPACE = 0.06;
+const SLIDE_CAPTION_SPACE = 0.1;
+const NO_RESERVE = { top: 0, below: 0 };
+function frameHeight(frame, aspect) {
+  return frame.w * STAGE_ASPECT / aspect;
+}
+function containWidth(aspect, width, height) {
+  return Math.max(0, Math.min(width, height * aspect / STAGE_ASPECT));
+}
+function autoLayout(aspects, reserve = NO_RESERVE) {
+  const n = aspects.length;
+  if (n === 0) return [];
+  const { top, below, right = 0, bottom = 0, columns, inset = 0 } = reserve;
+  const left = STAGE_MARGIN + inset;
+  const innerW = 1 - 2 * left - right;
+  const innerH = 1 - 2 * STAGE_MARGIN - top - bottom;
+  let best = null;
+  const fixed = columns ? Math.min(columns, n) : 0;
+  for (let cols = fixed || 1; cols <= (fixed || n); cols++) {
+    const rows = Math.ceil(n / cols);
+    const cellW = (innerW - (cols - 1) * STAGE_GAP) / cols;
+    const cellH = (innerH - (rows - 1) * STAGE_GAP) / rows;
+    if (cellW <= 0 || cellH <= below) continue;
+    const frames = [];
+    let area = 0;
+    for (let i = 0; i < n; i++) {
+      const row = Math.floor(i / cols);
+      const inRow = row === rows - 1 ? n - row * cols : cols;
+      const col = i - row * cols;
+      const rowStart = left + (cols - inRow) * (cellW + STAGE_GAP) / 2;
+      const w = containWidth(aspects[i], cellW, cellH - below);
+      const h = frameHeight({ w }, aspects[i]);
+      frames.push({
+        x: rowStart + col * (cellW + STAGE_GAP) + (cellW - w) / 2,
+        y: STAGE_MARGIN + top + row * (cellH + STAGE_GAP) + (cellH - h - below) / 2,
+        w
+      });
+      area += w * h;
+    }
+    if (!best || area > best.area + 1e-9) best = { frames, area };
+  }
+  return best?.frames ?? [];
+}
+function fitFrame(aspect, reserve = NO_RESERVE) {
+  return autoLayout([aspect], reserve)[0];
+}
+function fullWidthFrame(frame, aspect, reserve = NO_RESERVE) {
+  const { top, below, right = 0, bottom = 0, inset = 0 } = reserve;
+  const w = 1 - 2 * (STAGE_MARGIN + inset) - right;
+  const h = frameHeight({ w }, aspect);
+  if (h + below > 1 - 2 * STAGE_MARGIN - top - bottom) return fitFrame(aspect, reserve);
+  const centre = frame.y + frameHeight(frame, aspect) / 2;
+  return {
+    x: STAGE_MARGIN + inset,
+    y: clamp(centre - h / 2, STAGE_MARGIN + top, 1 - STAGE_MARGIN - h - below - bottom),
+    w
+  };
+}
+function fullHeightFrame(frame, aspect, reserve = NO_RESERVE) {
+  const { top, below, right = 0, bottom = 0 } = reserve;
+  const inner = 1 - 2 * STAGE_MARGIN;
+  const w = (inner - top - below - bottom) * aspect / STAGE_ASPECT;
+  if (w > inner - right) return fitFrame(aspect, reserve);
+  const centre = frame.x + frame.w / 2;
+  return {
+    x: clamp(centre - w / 2, STAGE_MARGIN, 1 - STAGE_MARGIN - right - w),
+    y: STAGE_MARGIN + top,
+    w
+  };
+}
+function clamp(value, min, max) {
+  return max < min ? (min + max) / 2 : Math.min(Math.max(value, min), max);
+}
+const SNAP_DISTANCE_Y = SNAP_DISTANCE * STAGE_ASPECT;
+function snapTargets(axis, others) {
+  const targets = [0, STAGE_MARGIN, 0.5, 1 - STAGE_MARGIN, 1];
+  for (const { frame, aspect } of others) {
+    const start = axis === "x" ? frame.x : frame.y;
+    const size = axis === "x" ? frame.w : frameHeight(frame, aspect);
+    targets.push(start, start + size / 2, start + size);
+  }
+  return targets;
+}
+function snapSpan(start, size, targets, distance) {
+  let best = null;
+  let bestDistance = distance;
+  for (const target of targets) {
+    for (const offset of [0, size / 2, size]) {
+      const d = Math.abs(start + offset - target);
+      if (d < bestDistance) {
+        bestDistance = d;
+        best = { start: target - offset, at: target };
+      }
+    }
+  }
+  return best;
+}
+function moveFrame(frame, aspect, dx, dy, others = [], free = false) {
+  const h = frameHeight(frame, aspect);
+  let x = frame.x + dx;
+  let y = frame.y + dy;
+  const guides = [];
+  if (!free) {
+    const sx = snapSpan(x, frame.w, snapTargets("x", others), SNAP_DISTANCE);
+    const sy = snapSpan(y, h, snapTargets("y", others), SNAP_DISTANCE_Y);
+    if (sx) {
+      x = sx.start;
+      guides.push({ axis: "x", at: sx.at });
+    }
+    if (sy) {
+      y = sy.start;
+      guides.push({ axis: "y", at: sy.at });
+    }
+  }
+  return { frame: { x: clamp(x, 0, 1 - frame.w), y: clamp(y, 0, 1 - h), w: frame.w }, guides };
+}
+function resizeFrame(frame, aspect, corner, dx, dy, others = [], free = false) {
+  const h0 = frameHeight(frame, aspect);
+  const west = corner === "nw" || corner === "sw";
+  const north = corner === "nw" || corner === "ne";
+  const anchorX = west ? frame.x + frame.w : frame.x;
+  const anchorY = north ? frame.y + h0 : frame.y;
+  const pointerX = (west ? frame.x : frame.x + frame.w) + dx;
+  const pointerY = (north ? frame.y : frame.y + h0) + dy;
+  const widthOfHeight = (height) => height * aspect / STAGE_ASPECT;
+  let w = Math.max(Math.abs(pointerX - anchorX), widthOfHeight(Math.abs(pointerY - anchorY)));
+  const guides = [];
+  if (!free) {
+    const edgeX = west ? anchorX - w : anchorX + w;
+    const edgeY = north ? anchorY - frameHeight({ w }, aspect) : anchorY + frameHeight({ w }, aspect);
+    const sx = snapSpan(edgeX, 0, snapTargets("x", others), SNAP_DISTANCE);
+    const sy = snapSpan(edgeY, 0, snapTargets("y", others), SNAP_DISTANCE_Y);
+    const dxSnap = sx ? Math.abs(sx.at - edgeX) : Infinity;
+    const dySnap = sy ? Math.abs(sy.at - edgeY) / STAGE_ASPECT : Infinity;
+    if (sx && dxSnap <= dySnap) {
+      w = Math.abs(sx.at - anchorX);
+      guides.push({ axis: "x", at: sx.at });
+    } else if (sy) {
+      w = widthOfHeight(Math.abs(sy.at - anchorY));
+      guides.push({ axis: "y", at: sy.at });
+    }
+  }
+  const maxW = Math.min(west ? anchorX : 1 - anchorX, widthOfHeight(north ? anchorY : 1 - anchorY));
+  w = clamp(w, Math.min(MIN_FRAME_WIDTH, maxW), maxW);
+  const h = frameHeight({ w }, aspect);
+  return { frame: { x: west ? anchorX - w : anchorX, y: north ? anchorY - h : anchorY, w }, guides };
+}
+const MIN_CLIP_SPAN = 0.02;
+function reshapeFrame(frame, clip, edge, dx, dy, others = [], free = false) {
+  const { rect, aspect } = clip;
+  const horizontal = edge === "e" || edge === "w";
+  const far = edge === "e" || edge === "s";
+  const start = horizontal ? frame.x : frame.y;
+  const size = horizontal ? frame.w : frameHeight(frame, aspect);
+  const sourceStart = horizontal ? rect.x : rect.y;
+  const sourceSize = horizontal ? rect.w : rect.h;
+  const scale = size / sourceSize;
+  const axis = horizontal ? "x" : "y";
+  let at = (far ? start + size : start) + (horizontal ? dx : dy);
+  if (!free) {
+    const distance = horizontal ? SNAP_DISTANCE : SNAP_DISTANCE_Y;
+    const snap = snapSpan(at, 0, snapTargets(axis, others), distance);
+    if (snap) at = snap.at;
+  }
+  const least = Math.min(
+    size,
+    Math.max(horizontal ? MIN_FRAME_WIDTH : MIN_FRAME_WIDTH * STAGE_ASPECT, MIN_CLIP_SPAN * scale)
+  );
+  const end = start + size;
+  const most = far ? Math.min(1 - start, (1 - sourceStart) * scale) : Math.min(end, (sourceStart + sourceSize) * scale);
+  const nextSize = clamp(far ? at - start : end - at, least, Math.max(most, size));
+  const nextSourceSize = nextSize / scale;
+  const nextStart = far ? start : end - nextSize;
+  const nextSourceStart = far ? sourceStart : sourceStart + sourceSize - nextSourceSize;
+  const nextRect = horizontal ? { ...rect, x: nextSourceStart, w: nextSourceSize } : { ...rect, y: nextSourceStart, h: nextSourceSize };
+  const sourceAspect = aspect * rect.h / rect.w;
+  const edgeAt = far ? nextStart + nextSize : nextStart;
+  return {
+    frame: horizontal ? { x: nextStart, y: frame.y, w: nextSize } : { x: frame.x, y: nextStart, w: frame.w },
+    rect: nextRect,
+    aspect: sourceAspect * nextRect.w / nextRect.h,
+    // A guide only where the edge did snap (not where a bound stopped it).
+    guides: !free && Math.abs(edgeAt - at) < 1e-9 && snapTargets(axis, others).includes(at) ? [{ axis, at }] : []
+  };
+}
+function alignFrame(frame, aspect, alignment, reserve = NO_RESERVE) {
+  const h = frameHeight(frame, aspect);
+  const right = reserve.right ?? 0;
+  const side = STAGE_MARGIN + (reserve.inset ?? 0);
+  const below = reserve.below + (reserve.bottom ?? 0);
+  switch (alignment) {
+    case "left":
+      return { ...frame, x: side };
+    case "centre":
+      return { ...frame, x: (1 - right - frame.w) / 2 };
+    case "right":
+      return { ...frame, x: 1 - side - right - frame.w };
+    case "top":
+      return { ...frame, y: STAGE_MARGIN + reserve.top };
+    case "middle":
+      return { ...frame, y: (1 + reserve.top - below - h) / 2 };
+    case "bottom":
+      return { ...frame, y: 1 - STAGE_MARGIN - below - h };
+  }
+}
+function dropFrame(aspect, at) {
+  const fit = fitFrame(aspect);
+  const w = Math.min(fit.w, 0.45);
+  const h = frameHeight({ w }, aspect);
+  return { x: clamp(at.x - w / 2, 0, 1 - w), y: clamp(at.y - h / 2, 0, 1 - h), w };
+}
+function defaultCaption(fileName, page) {
+  return `${documentName(fileName)} \xB7 p. ${page}`;
+}
+const documentName = (fileName) => fileName.replace(/\.[a-z0-9]{1,5}$/i, "") || "Document";
+function formatTime(seconds) {
+  const total = Math.max(0, Math.floor(seconds));
+  const h = Math.floor(total / 3600);
+  const m = Math.floor(total % 3600 / 60);
+  const s = String(total % 60).padStart(2, "0");
+  return h ? `${h}:${String(m).padStart(2, "0")}:${s}` : `${m}:${s}`;
+}
+function clipLabel(clip, columnValues) {
+  const value = columnValues[clip.documentId]?.trim();
+  if (!value) return clip.caption;
+  return clip.caption ? `${value} \xB7 ${clip.caption}` : value;
+}
+function mediaCaption(fileName, start) {
+  const name = documentName(fileName);
+  return start === void 0 ? name : `${name} \xB7 ${formatTime(start)}`;
+}
+export {
+  CAPTION_SPACE,
+  MIN_FRAME_WIDTH,
+  NO_RESERVE,
+  SLIDE_CAPTION_SPACE,
+  SLIDE_LAYOUTS,
+  SNAP_DISTANCE,
+  STAGE_ASPECT,
+  STAGE_GAP,
+  STAGE_MARGIN,
+  alignFrame,
+  autoLayout,
+  clipLabel,
+  defaultCaption,
+  dropFrame,
+  fitFrame,
+  formatTime,
+  frameHeight,
+  fullHeightFrame,
+  fullWidthFrame,
+  mediaCaption,
+  moveFrame,
+  reshapeFrame,
+  resizeFrame
+};
+//# sourceMappingURL=model.js.map

package/dist/presentation/model.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/model.ts"],
+  "sourcesContent": ["/**\n * A presentation: clips (a rectangle of a PDF page) arranged on 16:9 slides, shown on a stage that\n * can be shared or projected. A clip is a reference to its source (document, version, page,\n * rectangle), never a picture of it: it is drawn again from the PDF at whatever size it is shown,\n * and a later \"save as PDF\" can embed the same region as vector content.\n *\n * Layout is pure: a frame is the clip's place on the slide as fractions of the stage, and its\n * height always follows from the clip's own aspect, so a clip is never stretched.\n */\n\nimport type { SlideBackground, SlideBox } from './boxes'\n\n/** Fractions of a page or of the stage, origin top-left. */\nexport interface Rect {\n  x: number\n  y: number\n  w: number\n  h: number\n}\n\n/**\n * What a clip is cut from: a PDF page (drawn again from the PDF at the size shown), an image or a\n * video (the original file shown cropped, so at its own resolution; a video plays on the stage).\n */\nexport type ClipKind = 'pdf' | 'image' | 'video'\n\nexport interface Clip {\n  id: string\n  kind: ClipKind\n  documentId: string\n  /** The version clipped; absent = the current version when it was clipped. */\n  version?: number\n  fileName: string\n  /** 1-based page number (1 for an image or a video). */\n  page: number\n  /** The clipped area, as fractions of the displayed page, image or video frame. */\n  rect: Rect\n  /** Width / height of the clipped area as displayed. */\n  aspect: number\n  caption: string\n  /** Redactions over the clipped area (page fractions), painted black wherever it shows. */\n  masks: Rect[]\n  /** The file the clip is cut from (this session only; never stored). */\n  source: Blob\n  /**\n   * The clip's width (a fraction of its source) when it was cut, so its zoom reads against that\n   * (100%); absent = its width now.\n   */\n  zoomBase?: number\n  /** A video clip starts playing here (seconds). */\n  start?: number\n  /**\n   * An image embedded in the presentation itself (a key of its media), not a document: a picture\n   * of a deck imported from PowerPoint. Its `documentId` is empty.\n   */\n  media?: string\n  /**\n   * Drawn as it is: no rounded corners, soft edge, shadow or source label (a picture that is part\n   * of a slide's design, or a part of an imported slide shown as it was).\n   */\n  plain?: boolean\n}\n\n/** A clip's place on a slide: its left, top and width as fractions of the stage. */\nexport interface Frame {\n  x: number\n  y: number\n  w: number\n}\n\nexport interface SlideItem {\n  clipId: string\n  frame: Frame\n}\n\nexport interface Slide {\n  id: string\n  items: SlideItem[]\n  /** Arranged automatically (fit to the stage) until an item is moved by hand. */\n  auto: boolean\n  /** Shown across the top of the slide (e.g. \"Claims and defences\"); empty for none. */\n  caption: string\n  /** Where its title, text and clips go (`slide-layout`). */\n  layout: SlideLayout\n  /** Its text: one point per line (the subtitle on a title or section slide); empty for none. */\n  points: string\n  /** Its text boxes and shapes (`boxes`), in drawing order. */\n  boxes: SlideBox[]\n  /** Its own background, over the theme's (an imported slide's). */\n  background?: SlideBackground\n  /** What the presenter says (speaker notes: not shown on the slide). */\n  notes?: string\n}\n\n/**\n * A slide's layout: a title slide, a section break, clips under a title, clips beside points, or\n * two clips side by side; or blank (`free`): only what is placed on it, its text in boxes (a slide\n * imported from PowerPoint).\n */\nexport type SlideLayout = 'title' | 'section' | 'clips' | 'points' | 'compare' | 'free'\n\nexport const SLIDE_LAYOUTS: readonly SlideLayout[] = [\n  'clips',\n  'points',\n  'compare',\n  'title',\n  'section',\n  'free',\n]\n\n/** The stage is 16:9, the shape of a shared screen or a projector. */\nexport const STAGE_ASPECT = 16 / 9\n/** Space kept clear around the edge of the stage, and between auto-arranged clips. */\nexport const STAGE_MARGIN = 0.03\nexport const STAGE_GAP = 0.02\n/** The smallest a clip can be resized to (fraction of the stage width). */\nexport const MIN_FRAME_WIDTH = 0.05\n/** How close (fraction of the stage) an edge or centre must come to snap. */\nexport const SNAP_DISTANCE = 0.012\n/**\n * Room kept under a clip for its source label (document \u00B7 page), as a fraction of the stage\n * height, while labels show: it sits below the clip, never over it, so it hides nothing.\n */\nexport const CAPTION_SPACE = 0.06\n/** Room kept across the top of a slide for its caption, when it has one (stage height). */\nexport const SLIDE_CAPTION_SPACE = 0.1\n\n/**\n * Room an arrangement keeps free: above the clips and under each clip (stage height), at the right\n * (stage width, e.g. a slide's points) and at the bottom (the footer); `columns` fixes the grid's\n * columns (two clips side by side).\n */\nexport interface Reserve {\n  top: number\n  below: number\n  right?: number\n  bottom?: number\n  columns?: number\n  /** More room on both sides, beyond the stage margin (clips line up with a slide's text). */\n  inset?: number\n}\nexport const NO_RESERVE: Reserve = { top: 0, below: 0 }\n\n/** The frame's height as a fraction of the stage height. */\nexport function frameHeight(frame: Pick<Frame, 'w'>, aspect: number): number {\n  return (frame.w * STAGE_ASPECT) / aspect\n}\n\n/** The widest a clip can be inside a `width \u00D7 height` box (stage fractions). */\nfunction containWidth(aspect: number, width: number, height: number): number {\n  return Math.max(0, Math.min(width, (height * aspect) / STAGE_ASPECT))\n}\n\n/**\n * Clips arranged to fill the stage: every grid of columns \u00D7 rows is tried and the one where the\n * clips are largest wins (two wide clips stack, two tall ones go side by side). Each clip is\n * centred in its cell; a last, shorter row is centred too. `reserve` keeps a band free above the\n * clips (the slide's caption) and room under each clip (its source label).\n */\nexport function autoLayout(aspects: readonly number[], reserve: Reserve = NO_RESERVE): Frame[] {\n  const n = aspects.length\n  if (n === 0) return []\n  const { top, below, right = 0, bottom = 0, columns, inset = 0 } = reserve\n  const left = STAGE_MARGIN + inset\n  const innerW = 1 - 2 * left - right\n  const innerH = 1 - 2 * STAGE_MARGIN - top - bottom\n  let best: { frames: Frame[]; area: number } | null = null\n  const fixed = columns ? Math.min(columns, n) : 0\n  for (let cols = fixed || 1; cols <= (fixed || n); cols++) {\n    const rows = Math.ceil(n / cols)\n    const cellW = (innerW - (cols - 1) * STAGE_GAP) / cols\n    const cellH = (innerH - (rows - 1) * STAGE_GAP) / rows\n    if (cellW <= 0 || cellH <= below) continue\n    const frames: Frame[] = []\n    let area = 0\n    for (let i = 0; i < n; i++) {\n      const row = Math.floor(i / cols)\n      const inRow = row === rows - 1 ? n - row * cols : cols\n      const col = i - row * cols\n      const rowStart = left + ((cols - inRow) * (cellW + STAGE_GAP)) / 2\n      const w = containWidth(aspects[i], cellW, cellH - below)\n      const h = frameHeight({ w }, aspects[i])\n      frames.push({\n        x: rowStart + col * (cellW + STAGE_GAP) + (cellW - w) / 2,\n        y: STAGE_MARGIN + top + row * (cellH + STAGE_GAP) + (cellH - h - below) / 2,\n        w,\n      })\n      area += w * h\n    }\n    // Strictly larger wins, so ties keep fewer columns.\n    if (!best || area > best.area + 1e-9) best = { frames, area }\n  }\n  return best?.frames ?? []\n}\n\n/** As large as the stage allows, centred (keeping `reserve` free). */\nexport function fitFrame(aspect: number, reserve: Reserve = NO_RESERVE): Frame {\n  return autoLayout([aspect], reserve)[0]\n}\n\n/** The full width of the stage (inside the margin), centred on the frame's own height. */\nexport function fullWidthFrame(frame: Frame, aspect: number, reserve: Reserve = NO_RESERVE): Frame {\n  const { top, below, right = 0, bottom = 0, inset = 0 } = reserve\n  const w = 1 - 2 * (STAGE_MARGIN + inset) - right\n  const h = frameHeight({ w }, aspect)\n  // Too tall to be full width: as large as fits instead.\n  if (h + below > 1 - 2 * STAGE_MARGIN - top - bottom) return fitFrame(aspect, reserve)\n  const centre = frame.y + frameHeight(frame, aspect) / 2\n  return {\n    x: STAGE_MARGIN + inset,\n    y: clamp(centre - h / 2, STAGE_MARGIN + top, 1 - STAGE_MARGIN - h - below - bottom),\n    w,\n  }\n}\n\n/** The full height of the stage (inside the margin), centred on the frame's own centre. */\nexport function fullHeightFrame(\n  frame: Frame,\n  aspect: number,\n  reserve: Reserve = NO_RESERVE\n): Frame {\n  const { top, below, right = 0, bottom = 0 } = reserve\n  const inner = 1 - 2 * STAGE_MARGIN\n  const w = ((inner - top - below - bottom) * aspect) / STAGE_ASPECT\n  if (w > inner - right) return fitFrame(aspect, reserve)\n  const centre = frame.x + frame.w / 2\n  return {\n    x: clamp(centre - w / 2, STAGE_MARGIN, 1 - STAGE_MARGIN - right - w),\n    y: STAGE_MARGIN + top,\n    w,\n  }\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n  return max < min ? (min + max) / 2 : Math.min(Math.max(value, min), max)\n}\n\n/** A clip on the slide (the others a moving clip snaps to). */\nexport interface Placed {\n  frame: Frame\n  aspect: number\n}\n\n/** A line a clip snapped to, drawn while it is dragged: `at` is a stage fraction on `axis`. */\nexport interface Guide {\n  axis: 'x' | 'y'\n  at: number\n}\n\n/** The snap distance across the stage height: the same on screen as SNAP_DISTANCE across. */\nconst SNAP_DISTANCE_Y = SNAP_DISTANCE * STAGE_ASPECT\n\n/**\n * What a clip's edges and centre snap to on one axis: the stage's edges, margins and centre line,\n * and the edges and centres of the other clips on the slide.\n */\nfunction snapTargets(axis: Guide['axis'], others: readonly Placed[]): number[] {\n  const targets = [0, STAGE_MARGIN, 0.5, 1 - STAGE_MARGIN, 1]\n  for (const { frame, aspect } of others) {\n    const start = axis === 'x' ? frame.x : frame.y\n    const size = axis === 'x' ? frame.w : frameHeight(frame, aspect)\n    targets.push(start, start + size / 2, start + size)\n  }\n  return targets\n}\n\n/** The nearest snap for a span `start \u2026 start + size` on an axis (its edges or centre), if any. */\nfunction snapSpan(\n  start: number,\n  size: number,\n  targets: readonly number[],\n  distance: number\n): { start: number; at: number } | null {\n  let best: { start: number; at: number } | null = null\n  let bestDistance = distance\n  for (const target of targets) {\n    for (const offset of [0, size / 2, size]) {\n      const d = Math.abs(start + offset - target)\n      if (d < bestDistance) {\n        bestDistance = d\n        best = { start: target - offset, at: target }\n      }\n    }\n  }\n  return best\n}\n\n/**\n * The frame moved by `dx, dy` (stage fractions) and kept on the stage. Unless `free`, its edges\n * and centre snap to the stage's lines and to the other clips', and the lines snapped to are\n * returned as guides.\n */\nexport function moveFrame(\n  frame: Frame,\n  aspect: number,\n  dx: number,\n  dy: number,\n  others: readonly Placed[] = [],\n  free = false\n): { frame: Frame; guides: Guide[] } {\n  const h = frameHeight(frame, aspect)\n  let x = frame.x + dx\n  let y = frame.y + dy\n  const guides: Guide[] = []\n  if (!free) {\n    const sx = snapSpan(x, frame.w, snapTargets('x', others), SNAP_DISTANCE)\n    const sy = snapSpan(y, h, snapTargets('y', others), SNAP_DISTANCE_Y)\n    if (sx) {\n      x = sx.start\n      guides.push({ axis: 'x', at: sx.at })\n    }\n    if (sy) {\n      y = sy.start\n      guides.push({ axis: 'y', at: sy.at })\n    }\n  }\n  return { frame: { x: clamp(x, 0, 1 - frame.w), y: clamp(y, 0, 1 - h), w: frame.w }, guides }\n}\n\n/** A corner a clip is resized from. */\nexport type Corner = 'nw' | 'ne' | 'sw' | 'se'\n\n/**\n * The frame resized by dragging `corner` by `dx, dy`: the opposite corner stays put, the aspect is\n * kept and the clip stays on the stage. Unless `free`, the moving edges snap like a move does.\n */\nexport function resizeFrame(\n  frame: Frame,\n  aspect: number,\n  corner: Corner,\n  dx: number,\n  dy: number,\n  others: readonly Placed[] = [],\n  free = false\n): { frame: Frame; guides: Guide[] } {\n  const h0 = frameHeight(frame, aspect)\n  const west = corner === 'nw' || corner === 'sw'\n  const north = corner === 'nw' || corner === 'ne'\n  // The corner that stays put, and where the dragged one is now.\n  const anchorX = west ? frame.x + frame.w : frame.x\n  const anchorY = north ? frame.y + h0 : frame.y\n  const pointerX = (west ? frame.x : frame.x + frame.w) + dx\n  const pointerY = (north ? frame.y : frame.y + h0) + dy\n  const widthOfHeight = (height: number) => (height * aspect) / STAGE_ASPECT\n  // Follow whichever of the two directions the pointer has gone further in.\n  let w = Math.max(Math.abs(pointerX - anchorX), widthOfHeight(Math.abs(pointerY - anchorY)))\n  const guides: Guide[] = []\n  if (!free) {\n    const edgeX = west ? anchorX - w : anchorX + w\n    const edgeY = north\n      ? anchorY - frameHeight({ w }, aspect)\n      : anchorY + frameHeight({ w }, aspect)\n    const sx = snapSpan(edgeX, 0, snapTargets('x', others), SNAP_DISTANCE)\n    const sy = snapSpan(edgeY, 0, snapTargets('y', others), SNAP_DISTANCE_Y)\n    // The nearer snap wins (distances compared on screen); the other edge follows the aspect.\n    const dxSnap = sx ? Math.abs(sx.at - edgeX) : Infinity\n    const dySnap = sy ? Math.abs(sy.at - edgeY) / STAGE_ASPECT : Infinity\n    if (sx && dxSnap <= dySnap) {\n      w = Math.abs(sx.at - anchorX)\n      guides.push({ axis: 'x', at: sx.at })\n    } else if (sy) {\n      w = widthOfHeight(Math.abs(sy.at - anchorY))\n      guides.push({ axis: 'y', at: sy.at })\n    }\n  }\n  // As large as the stage allows on the dragged side.\n  const maxW = Math.min(west ? anchorX : 1 - anchorX, widthOfHeight(north ? anchorY : 1 - anchorY))\n  w = clamp(w, Math.min(MIN_FRAME_WIDTH, maxW), maxW)\n  const h = frameHeight({ w }, aspect)\n  return { frame: { x: west ? anchorX - w : anchorX, y: north ? anchorY - h : anchorY, w }, guides }\n}\n\n/** An edge a clip is reshaped from. */\nexport type Edge = 'n' | 'e' | 's' | 'w'\n\n/** The least of its source a clip shows, each way (a fraction of the page, image or frame). */\nconst MIN_CLIP_SPAN = 0.02\n\n/**\n * The clip reshaped by dragging `edge` by `dx, dy`, at the same scale: the edge moves on the slide\n * and over the source together, so the clip shows more (or less) of the page beside it, never past\n * the source's edge or the stage's. Unless `free`, the edge snaps like a move does.\n */\nexport function reshapeFrame(\n  frame: Frame,\n  clip: Pick<Clip, 'rect' | 'aspect'>,\n  edge: Edge,\n  dx: number,\n  dy: number,\n  others: readonly Placed[] = [],\n  free = false\n): { frame: Frame; rect: Rect; aspect: number; guides: Guide[] } {\n  const { rect, aspect } = clip\n  const horizontal = edge === 'e' || edge === 'w'\n  const far = edge === 'e' || edge === 's'\n  const start = horizontal ? frame.x : frame.y\n  const size = horizontal ? frame.w : frameHeight(frame, aspect)\n  const sourceStart = horizontal ? rect.x : rect.y\n  const sourceSize = horizontal ? rect.w : rect.h\n  // Stage per source along this axis: kept, so nothing on the clip changes size.\n  const scale = size / sourceSize\n\n  const axis: Guide['axis'] = horizontal ? 'x' : 'y'\n  let at = (far ? start + size : start) + (horizontal ? dx : dy)\n  if (!free) {\n    const distance = horizontal ? SNAP_DISTANCE : SNAP_DISTANCE_Y\n    const snap = snapSpan(at, 0, snapTargets(axis, others), distance)\n    if (snap) at = snap.at\n  }\n  // As far as the stage and the source go; no smaller than a sliver of either.\n  const least = Math.min(\n    size,\n    Math.max(horizontal ? MIN_FRAME_WIDTH : MIN_FRAME_WIDTH * STAGE_ASPECT, MIN_CLIP_SPAN * scale)\n  )\n  const end = start + size\n  const most = far\n    ? Math.min(1 - start, (1 - sourceStart) * scale)\n    : Math.min(end, (sourceStart + sourceSize) * scale)\n  const nextSize = clamp(far ? at - start : end - at, least, Math.max(most, size))\n  const nextSourceSize = nextSize / scale\n  const nextStart = far ? start : end - nextSize\n  const nextSourceStart = far ? sourceStart : sourceStart + sourceSize - nextSourceSize\n\n  const nextRect = horizontal\n    ? { ...rect, x: nextSourceStart, w: nextSourceSize }\n    : { ...rect, y: nextSourceStart, h: nextSourceSize }\n  // The source's own shape (width / height as displayed), from the clip's.\n  const sourceAspect = (aspect * rect.h) / rect.w\n  const edgeAt = far ? nextStart + nextSize : nextStart\n  return {\n    frame: horizontal\n      ? { x: nextStart, y: frame.y, w: nextSize }\n      : { x: frame.x, y: nextStart, w: frame.w },\n    rect: nextRect,\n    aspect: (sourceAspect * nextRect.w) / nextRect.h,\n    // A guide only where the edge did snap (not where a bound stopped it).\n    guides:\n      !free && Math.abs(edgeAt - at) < 1e-9 && snapTargets(axis, others).includes(at)\n        ? [{ axis, at }]\n        : [],\n  }\n}\n\n/** Where a clip can be aligned on the stage. */\nexport type Alignment = 'left' | 'centre' | 'right' | 'top' | 'middle' | 'bottom'\n\n/** The frame aligned on the stage, inside its margins and the slide's reserved room. */\nexport function alignFrame(\n  frame: Frame,\n  aspect: number,\n  alignment: Alignment,\n  reserve: Reserve = NO_RESERVE\n): Frame {\n  const h = frameHeight(frame, aspect)\n  const right = reserve.right ?? 0\n  const side = STAGE_MARGIN + (reserve.inset ?? 0)\n  const below = reserve.below + (reserve.bottom ?? 0)\n  switch (alignment) {\n    case 'left':\n      return { ...frame, x: side }\n    case 'centre':\n      return { ...frame, x: (1 - right - frame.w) / 2 }\n    case 'right':\n      return { ...frame, x: 1 - side - right - frame.w }\n    case 'top':\n      return { ...frame, y: STAGE_MARGIN + reserve.top }\n    case 'middle':\n      return { ...frame, y: (1 + reserve.top - below - h) / 2 }\n    case 'bottom':\n      return { ...frame, y: 1 - STAGE_MARGIN - below - h }\n  }\n}\n\n/** A clip dropped at a point (stage fractions): centred there, at most 45% of the stage wide. */\nexport function dropFrame(aspect: number, at: { x: number; y: number }): Frame {\n  const fit = fitFrame(aspect)\n  const w = Math.min(fit.w, 0.45)\n  const h = frameHeight({ w }, aspect)\n  return { x: clamp(at.x - w / 2, 0, 1 - w), y: clamp(at.y - h / 2, 0, 1 - h), w }\n}\n\n/** \"Exhibit 12.pdf\", page 4 \u2192 \"Exhibit 12 \u00B7 p. 4\". */\nexport function defaultCaption(fileName: string, page: number): string {\n  return `${documentName(fileName)} \u00B7 p. ${page}`\n}\n\nconst documentName = (fileName: string) => fileName.replace(/\\.[a-z0-9]{1,5}$/i, '') || 'Document'\n\n/** \"1:05\" (or \"1:02:05\"): a point in a video. */\nexport function formatTime(seconds: number): string {\n  const total = Math.max(0, Math.floor(seconds))\n  const h = Math.floor(total / 3600)\n  const m = Math.floor((total % 3600) / 60)\n  const s = String(total % 60).padStart(2, '0')\n  return h ? `${h}:${String(m).padStart(2, '0')}:${s}` : `${m}:${s}`\n}\n\n/**\n * A clip's label as shown: its document's value in the presentation's label column (an exhibit\n * number, \"R-100\"), then its own label. `columnValues` maps a document id to that value.\n */\nexport function clipLabel(\n  clip: Pick<Clip, 'caption' | 'documentId'>,\n  columnValues: Readonly<Record<string, string>>\n): string {\n  const value = columnValues[clip.documentId]?.trim()\n  if (!value) return clip.caption\n  return clip.caption ? `${value} \u00B7 ${clip.caption}` : value\n}\n\n/** The source label of a clip of an image (\"Photo 3\") or a video, from where it starts (\"Interview \u00B7 1:05\"). */\nexport function mediaCaption(fileName: string, start?: number): string {\n  const name = documentName(fileName)\n  return start === undefined ? name : `${name} \u00B7 ${formatTime(start)}`\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/presentation/panel-id.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The presentation window's entry points, for any surface. Light: no PDF engine, no presentation
+ * module (that loads with the window or the viewer's slides tab).
+ *
+ * A presentation is edited in the viewer's slides tab, or in a window of its own (`openPresentation`)
+ * beside the documents its clips come from; Present always shows in that window, alone, to share.
+ */
+/** The session's panel for the presentation's own window (`ConnectedPresentation`). */
+export declare const PRESENTATION_PANEL = "presentation-panel";
+/**
+ * The names presentations were saved under before they were known by their folder (a saved
+ * presentation is now `<title>.pdf` in Files › Presentations): `.presentation.pdf`, and
+ * `.presentation.json` (the editable data alone, from before presentations were PDFs).
+ */
+export declare const PRESENTATION_FILE_SUFFIX = ".presentation.pdf";
+export declare const LEGACY_PRESENTATION_SUFFIX = ".presentation.json";
+/** A presentation saved before it was a PDF: its data alone, no slides to view. */
+export declare const isLegacyPresentationFile: (fileName: string | null | undefined) => boolean;
+type Session = {
+    openPanel(panelId: string, mode: 'popout' | 'docked' | 'overlay' | 'main'): void;
+};
+/**
+ * Open the presentation's own window (a pop-out: call it from a click), to edit the presentation
+ * there, or (`present`) only to present it: that window closes when presenting ends. Recorded, so
+ * a window the saved layout restores after a reload, with nothing in it (a presentation lives in
+ * memory), is closed rather than reopened.
+ */
+export declare function openPresentation(session: Session, { present }?: {
+    present?: boolean | undefined;
+}): void;
+export declare const presentationOpenedInThisPage: () => boolean;
+/** The window was opened only to present (it closes when presenting ends). */
+export declare const presentationWindowOnlyPresents: () => boolean;
+export {};

package/dist/presentation/panel-id.js

@@ -0,0 +1,24 @@
+"use client";
+const PRESENTATION_PANEL = "presentation-panel";
+const PRESENTATION_FILE_SUFFIX = ".presentation.pdf";
+const LEGACY_PRESENTATION_SUFFIX = ".presentation.json";
+const isLegacyPresentationFile = (fileName) => !!fileName && fileName.endsWith(LEGACY_PRESENTATION_SUFFIX);
+let openedInThisPage = false;
+let presentOnly = false;
+function openPresentation(session, { present = false } = {}) {
+  openedInThisPage = true;
+  presentOnly = present;
+  session.openPanel(PRESENTATION_PANEL, "popout");
+}
+const presentationOpenedInThisPage = () => openedInThisPage;
+const presentationWindowOnlyPresents = () => presentOnly;
+export {
+  LEGACY_PRESENTATION_SUFFIX,
+  PRESENTATION_FILE_SUFFIX,
+  PRESENTATION_PANEL,
+  isLegacyPresentationFile,
+  openPresentation,
+  presentationOpenedInThisPage,
+  presentationWindowOnlyPresents
+};
+//# sourceMappingURL=panel-id.js.map

package/dist/presentation/panel-id.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/panel-id.ts"],
+  "sourcesContent": ["/**\n * The presentation window's entry points, for any surface. Light: no PDF engine, no presentation\n * module (that loads with the window or the viewer's slides tab).\n *\n * A presentation is edited in the viewer's slides tab, or in a window of its own (`openPresentation`)\n * beside the documents its clips come from; Present always shows in that window, alone, to share.\n */\n\n/** The session's panel for the presentation's own window (`ConnectedPresentation`). */\nexport const PRESENTATION_PANEL = 'presentation-panel'\n\n/**\n * The names presentations were saved under before they were known by their folder (a saved\n * presentation is now `<title>.pdf` in Files \u203A Presentations): `.presentation.pdf`, and\n * `.presentation.json` (the editable data alone, from before presentations were PDFs).\n */\nexport const PRESENTATION_FILE_SUFFIX = '.presentation.pdf'\nexport const LEGACY_PRESENTATION_SUFFIX = '.presentation.json'\n\n/** A presentation saved before it was a PDF: its data alone, no slides to view. */\nexport const isLegacyPresentationFile = (fileName: string | null | undefined): boolean =>\n  !!fileName && fileName.endsWith(LEGACY_PRESENTATION_SUFFIX)\n\ntype Session = { openPanel(panelId: string, mode: 'popout' | 'docked' | 'overlay' | 'main'): void }\n\nlet openedInThisPage = false\nlet presentOnly = false\n\n/**\n * Open the presentation's own window (a pop-out: call it from a click), to edit the presentation\n * there, or (`present`) only to present it: that window closes when presenting ends. Recorded, so\n * a window the saved layout restores after a reload, with nothing in it (a presentation lives in\n * memory), is closed rather than reopened.\n */\nexport function openPresentation(session: Session, { present = false } = {}): void {\n  openedInThisPage = true\n  presentOnly = present\n  session.openPanel(PRESENTATION_PANEL, 'popout')\n}\n\nexport const presentationOpenedInThisPage = (): boolean => openedInThisPage\n\n/** The window was opened only to present (it closes when presenting ends). */\nexport const presentationWindowOnlyPresents = (): boolean => presentOnly\n"],
+  "mappings": ";AASO,MAAM,qBAAqB;AAO3B,MAAM,2BAA2B;AACjC,MAAM,6BAA6B;AAGnC,MAAM,2BAA2B,CAAC,aACvC,CAAC,CAAC,YAAY,SAAS,SAAS,0BAA0B;AAI5D,IAAI,mBAAmB;AACvB,IAAI,cAAc;AAQX,SAAS,iBAAiB,SAAkB,EAAE,UAAU,MAAM,IAAI,CAAC,GAAS;AACjF,qBAAmB;AACnB,gBAAc;AACd,UAAQ,UAAU,oBAAoB,QAAQ;AAChD;AAEO,MAAM,+BAA+B,MAAe;AAGpD,MAAM,iCAAiC,MAAe;",
+  "names": []
+}

package/dist/presentation/persistence.d.ts

@@ -0,0 +1,121 @@
+/**
+ * A presentation saved as a document of the workspace's `Presentations` folder,
+ * `<title>.presentation.pdf`: a PDF of its slides (each an image as presented, redactions burnt in,
+ * its words searchable), with its editable data attached to the PDF as `arbi-presentation.json`
+ * (the format below; see docs/presentation-format.md). One file: viewing, searching, downloading,
+ * copying and versions are a PDF's, and the editable data can never part from its slides.
+ *
+ * The data holds references, never pixels: for each clip its source document (and version), page,
+ * area and label; for each slide its title and where its clips sit. Opening it fetches the sources
+ * again (so clips stay sharp and editable) and reads their redactions again (so a newer redaction
+ * applies too).
+ *
+ * Agents and the API: read and write the attachment with any PDF library. Changing the data cannot
+ * redraw the slides (that needs the sources and their redactions, decrypted in the app), so set
+ * `slidesStale: true`: the editor says so on opening, and its next save draws them again.
+ */
+import { type Clip, type ClipKind, type Frame, type Rect, type SlideLayout } from './model';
+import { type Theme } from './theme';
+import { type SavedBox } from './saved-boxes';
+import type { SlideBackground, SlideBox } from './boxes';
+export declare const PRESENTATIONS_FOLDER = "Presentations";
+/**
+ * Templates: presentations kept here are offered by New from template (their look and slides,
+ * without clips). A firm keeps its house look by keeping one here.
+ */
+export declare const TEMPLATES_FOLDER = "Presentations/Templates";
+/** Exported PDFs and PowerPoint decks: kept apart, so they are not taken for presentations. */
+export declare const EXPORTS_FOLDER = "Presentations/Exports";
+/** The name of the editable data attached to a presentation's PDF. */
+export declare const PRESENTATION_ATTACHMENT = "arbi-presentation.json";
+declare const FORMAT = "arbi-presentation";
+export interface SavedClip {
+    kind: ClipKind;
+    documentId: string;
+    version?: number;
+    fileName: string;
+    page: number;
+    rect: Rect;
+    aspect: number;
+    caption: string;
+    start?: number;
+    zoomBase?: number;
+    /** An image embedded in the presentation (a key of `media`); `documentId` is empty. */
+    media?: string;
+    /** Drawn as it is (no frame finish, no label). */
+    plain?: boolean;
+}
+export interface SavedSlide {
+    caption: string;
+    auto: boolean;
+    /** Absent in files saved before layouts: 'clips'. */
+    layout?: SlideLayout;
+    /** One point per line (a subtitle on a title or section slide). */
+    points?: string;
+    /** `clip` is an index into `clips`. */
+    items: {
+        clip: number;
+        frame: Frame;
+    }[];
+    /** Its text boxes and shapes (`boxes`). */
+    boxes?: SavedBox[];
+    background?: SlideBackground;
+    /** Speaker notes. */
+    notes?: string;
+    /**
+     * What its PowerPoint slide looked like when saved (`slideFingerprint`): a slide whose
+     * fingerprint no longer matches was changed in PowerPoint, and is imported again.
+     */
+    fingerprint?: string;
+}
+export interface SavedPresentation {
+    format: typeof FORMAT;
+    version: 1;
+    title: string;
+    captions: boolean;
+    /** The annotation column (tag id) whose value leads each clip's label, e.g. its exhibit number. */
+    labelColumn?: string;
+    /** Absent in files saved before themes: the default theme. */
+    theme?: Theme;
+    clips: SavedClip[];
+    slides: SavedSlide[];
+    /** Images embedded in the presentation (an imported deck's pictures), as data URLs. */
+    media?: Record<string, string>;
+    /** The data was changed outside the editor (an agent): the PDF's slides do not show it yet. */
+    slidesStale?: boolean;
+}
+export interface PresentationSnapshot {
+    title: string;
+    captions: boolean;
+    labelColumn?: string | null;
+    theme?: Theme;
+    clips: readonly Clip[];
+    slides: readonly {
+        caption: string;
+        auto: boolean;
+        layout?: SlideLayout;
+        points?: string;
+        items: {
+            clipId: string;
+            frame: Frame;
+        }[];
+        boxes?: readonly SlideBox[];
+        background?: SlideBackground;
+        notes?: string;
+    }[];
+    /** Embedded images by key (data URLs). */
+    media?: Readonly<Record<string, string>>;
+    /** Each slide's PowerPoint fingerprint, as just written (`slideFingerprint`). */
+    fingerprints?: readonly string[];
+}
+/** The presentation as saved: references only. */
+export declare function serializePresentation(snapshot: PresentationSnapshot): SavedPresentation;
+/** A saved presentation read from a file, checked; throws on anything else. */
+export declare function parsePresentation(text: string): SavedPresentation;
+/** A title as a file name stem (characters a file name can hold). */
+export declare function safeFileStem(title: string): string;
+/** "Opening statement" → "Opening statement.pptx": a presentation is a PowerPoint file. */
+export declare function presentationFileName(title: string): string;
+/** The title of a saved presentation, from its file name (older names too). */
+export declare function presentationTitle(fileName: string): string;
+export {};