@arbidocs/blocks 0.5.120 → 0.5.121

package/dist/presentation/boxes.d.ts

@@ -0,0 +1,105 @@
+/**
+ * A slide's text boxes and shapes: what a PowerPoint slide is made of besides pictures, so a deck
+ * imported from PowerPoint keeps its look and its words stay editable. A box sits in a frame of its
+ * own (fractions of the stage, its height free), holds styled text (paragraphs of runs) and can be
+ * a shape (a rectangle, a rounded one, an ellipse, a line) with a fill and an outline.
+ *
+ * Type sizes are points on PowerPoint's widescreen slide (13.333 × 7.5 in), so they read the same
+ * here, in the saved PDF and in an exported deck.
+ */
+/** A box's place: left, top, width and height as fractions of the stage. */
+export interface BoxFrame {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export type BoxShape = 'text' | 'rect' | 'roundRect' | 'ellipse' | 'line';
+export type TextAlign = 'left' | 'center' | 'right' | 'justify';
+export type BoxAnchor = 'top' | 'middle' | 'bottom';
+export interface TextRun {
+    text: string;
+    /** Points on the widescreen slide; absent: `DEFAULT_TEXT_SIZE`. */
+    size?: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    /** `#rrggbb`; absent: the theme's body text colour. */
+    color?: string;
+    /** A typeface name; absent: the theme's. */
+    font?: string;
+}
+export interface Paragraph {
+    runs: TextRun[];
+    align?: TextAlign;
+    /** Its indent level (0 is the outermost). */
+    level?: number;
+    bullet?: boolean;
+}
+export interface SlideBox {
+    id: string;
+    frame: BoxFrame;
+    shape: BoxShape;
+    /** Degrees, clockwise. */
+    rotation?: number;
+    flipH?: boolean;
+    flipV?: boolean;
+    /** `#rrggbb`; absent: no fill. */
+    fill?: string;
+    /** The fill's opacity, 0–1 (default 1). */
+    fillAlpha?: number;
+    line?: {
+        color: string;
+        width: number;
+        dash?: boolean;
+    };
+    paragraphs: Paragraph[];
+    anchor?: BoxAnchor;
+    /** Room between the box's edge and its text, in points (default `DEFAULT_INSET`). */
+    inset?: number;
+    /** The slide's title or body text (a PowerPoint placeholder): what an outline reads. */
+    role?: 'title' | 'body';
+    /** Drawn over the slide's clips (default: under them). */
+    front?: boolean;
+}
+/** A slide's own background, over the theme's: an image (a media key), a gradient or a colour. */
+export interface SlideBackground {
+    color?: string;
+    gradient?: {
+        from: string;
+        to: string;
+        angle: number;
+    };
+    image?: string;
+}
+/** PowerPoint's widescreen slide in points: type sizes are measured against it. */
+export declare const SLIDE_POINTS: {
+    w: number;
+    h: number;
+};
+export declare const DEFAULT_TEXT_SIZE = 18;
+export declare const DEFAULT_INSET = 7.2;
+/** The smallest a box can be made (fractions of the stage). */
+export declare const MIN_BOX = 0.02;
+/** A size in points as a fraction of the stage width (the stage's `cqw` / 100). */
+export declare const pointsToStage: (points: number) => number;
+/** The text of a box, one line per paragraph. */
+export declare const boxText: (box: Pick<SlideBox, "paragraphs">) => string;
+/**
+ * New text typed into a box: one paragraph per line, each keeping the style of the paragraph it
+ * replaces (its first run's type, its alignment, level and bullet), so retyping keeps the look.
+ */
+export declare function withText(box: SlideBox, text: string): SlideBox;
+/** Every run of a box changed by `change` (bold, a size, a colour: the whole box at once). */
+export declare function styleRuns(box: SlideBox, change: (run: TextRun) => TextRun): SlideBox;
+/** A box's first run (what its style controls show). */
+export declare const firstRun: (box: SlideBox) => TextRun | undefined;
+/** The box moved by `dx, dy`, kept on the stage. */
+export declare function moveBox(frame: BoxFrame, dx: number, dy: number): BoxFrame;
+/** A box handle: a corner or a side's middle. */
+export type BoxHandle = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w';
+/** The box resized from `handle` by `dx, dy` (its shape is free; the opposite side stays put). */
+export declare function stretchBox(frame: BoxFrame, handle: BoxHandle, dx: number, dy: number): BoxFrame;
+export declare const nextBoxId: () => string;
+/** A new box of `shape`, in the middle of the slide, ready to type in. */
+export declare function newBox(shape: BoxShape, accent: string): SlideBox;

package/dist/presentation/boxes.js

@@ -0,0 +1,103 @@
+"use client";
+const SLIDE_POINTS = { w: 960, h: 540 };
+const DEFAULT_TEXT_SIZE = 18;
+const DEFAULT_INSET = 7.2;
+const MIN_BOX = 0.02;
+const pointsToStage = (points) => points / SLIDE_POINTS.w;
+const boxText = (box) => box.paragraphs.map((paragraph) => paragraph.runs.map((run) => run.text).join("")).join("\n");
+function withText(box, text) {
+  const lines = text.split("\n");
+  const fallback = box.paragraphs[box.paragraphs.length - 1] ?? { runs: [{ text: "" }] };
+  const paragraphs = lines.map((line, index) => {
+    const before = box.paragraphs[index] ?? fallback;
+    const { text: _old, ...style } = before.runs[0] ?? { text: "" };
+    void _old;
+    return { ...before, runs: [{ ...style, text: line }] };
+  });
+  return { ...box, paragraphs };
+}
+function styleRuns(box, change) {
+  return {
+    ...box,
+    paragraphs: box.paragraphs.map((paragraph) => ({
+      ...paragraph,
+      runs: paragraph.runs.map(change)
+    }))
+  };
+}
+const firstRun = (box) => box.paragraphs.find((paragraph) => paragraph.runs.length)?.runs[0];
+const clamp = (value, min, max) => max < min ? (min + max) / 2 : Math.min(Math.max(value, min), max);
+function moveBox(frame, dx, dy) {
+  return {
+    ...frame,
+    x: clamp(frame.x + dx, -frame.w / 2, 1 - frame.w / 2),
+    y: clamp(frame.y + dy, -frame.h / 2, 1 - frame.h / 2)
+  };
+}
+function stretchBox(frame, handle, dx, dy) {
+  let { x, y, w, h } = frame;
+  if (handle.includes("w")) {
+    const right = x + w;
+    x = Math.min(x + dx, right - MIN_BOX);
+    w = right - x;
+  } else if (handle.includes("e")) {
+    w = Math.max(MIN_BOX, w + dx);
+  }
+  if (handle.startsWith("n")) {
+    const bottom = y + h;
+    y = Math.min(y + dy, bottom - MIN_BOX);
+    h = bottom - y;
+  } else if (handle.startsWith("s")) {
+    h = Math.max(MIN_BOX, h + dy);
+  }
+  return { x, y, w, h };
+}
+let sequence = 0;
+const nextBoxId = () => `box-${Date.now().toString(36)}-${++sequence}`;
+function newBox(shape, accent) {
+  const id = nextBoxId();
+  if (shape === "text") {
+    return {
+      id,
+      shape,
+      frame: { x: 0.3, y: 0.42, w: 0.4, h: 0.12 },
+      paragraphs: [{ runs: [{ text: "", size: 24 }] }],
+      front: true
+    };
+  }
+  if (shape === "line") {
+    return {
+      id,
+      shape,
+      frame: { x: 0.35, y: 0.5, w: 0.3, h: 0 },
+      line: { color: accent, width: 2 },
+      paragraphs: [],
+      front: true
+    };
+  }
+  return {
+    id,
+    shape,
+    frame: { x: 0.35, y: 0.35, w: 0.3, h: 0.3 },
+    fill: accent,
+    paragraphs: [{ runs: [{ text: "", size: 20, color: "#ffffff" }], align: "center" }],
+    anchor: "middle",
+    front: false
+  };
+}
+export {
+  DEFAULT_INSET,
+  DEFAULT_TEXT_SIZE,
+  MIN_BOX,
+  SLIDE_POINTS,
+  boxText,
+  firstRun,
+  moveBox,
+  newBox,
+  nextBoxId,
+  pointsToStage,
+  stretchBox,
+  styleRuns,
+  withText
+};
+//# sourceMappingURL=boxes.js.map

package/dist/presentation/boxes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/boxes.ts"],
+  "sourcesContent": ["/**\n * A slide's text boxes and shapes: what a PowerPoint slide is made of besides pictures, so a deck\n * imported from PowerPoint keeps its look and its words stay editable. A box sits in a frame of its\n * own (fractions of the stage, its height free), holds styled text (paragraphs of runs) and can be\n * a shape (a rectangle, a rounded one, an ellipse, a line) with a fill and an outline.\n *\n * Type sizes are points on PowerPoint's widescreen slide (13.333 \u00D7 7.5 in), so they read the same\n * here, in the saved PDF and in an exported deck.\n */\n\n/** A box's place: left, top, width and height as fractions of the stage. */\nexport interface BoxFrame {\n  x: number\n  y: number\n  w: number\n  h: number\n}\n\nexport type BoxShape = 'text' | 'rect' | 'roundRect' | 'ellipse' | 'line'\nexport type TextAlign = 'left' | 'center' | 'right' | 'justify'\nexport type BoxAnchor = 'top' | 'middle' | 'bottom'\n\nexport interface TextRun {\n  text: string\n  /** Points on the widescreen slide; absent: `DEFAULT_TEXT_SIZE`. */\n  size?: number\n  bold?: boolean\n  italic?: boolean\n  underline?: boolean\n  /** `#rrggbb`; absent: the theme's body text colour. */\n  color?: string\n  /** A typeface name; absent: the theme's. */\n  font?: string\n}\n\nexport interface Paragraph {\n  runs: TextRun[]\n  align?: TextAlign\n  /** Its indent level (0 is the outermost). */\n  level?: number\n  bullet?: boolean\n}\n\nexport interface SlideBox {\n  id: string\n  frame: BoxFrame\n  shape: BoxShape\n  /** Degrees, clockwise. */\n  rotation?: number\n  flipH?: boolean\n  flipV?: boolean\n  /** `#rrggbb`; absent: no fill. */\n  fill?: string\n  /** The fill's opacity, 0\u20131 (default 1). */\n  fillAlpha?: number\n  line?: { color: string; width: number; dash?: boolean }\n  paragraphs: Paragraph[]\n  anchor?: BoxAnchor\n  /** Room between the box's edge and its text, in points (default `DEFAULT_INSET`). */\n  inset?: number\n  /** The slide's title or body text (a PowerPoint placeholder): what an outline reads. */\n  role?: 'title' | 'body'\n  /** Drawn over the slide's clips (default: under them). */\n  front?: boolean\n}\n\n/** A slide's own background, over the theme's: an image (a media key), a gradient or a colour. */\nexport interface SlideBackground {\n  color?: string\n  gradient?: { from: string; to: string; angle: number }\n  image?: string\n}\n\n/** PowerPoint's widescreen slide in points: type sizes are measured against it. */\nexport const SLIDE_POINTS = { w: 960, h: 540 }\nexport const DEFAULT_TEXT_SIZE = 18\nexport const DEFAULT_INSET = 7.2\n/** The smallest a box can be made (fractions of the stage). */\nexport const MIN_BOX = 0.02\n\n/** A size in points as a fraction of the stage width (the stage's `cqw` / 100). */\nexport const pointsToStage = (points: number): number => points / SLIDE_POINTS.w\n\n/** The text of a box, one line per paragraph. */\nexport const boxText = (box: Pick<SlideBox, 'paragraphs'>): string =>\n  box.paragraphs.map((paragraph) => paragraph.runs.map((run) => run.text).join('')).join('\\n')\n\n/**\n * New text typed into a box: one paragraph per line, each keeping the style of the paragraph it\n * replaces (its first run's type, its alignment, level and bullet), so retyping keeps the look.\n */\nexport function withText(box: SlideBox, text: string): SlideBox {\n  const lines = text.split('\\n')\n  const fallback = box.paragraphs[box.paragraphs.length - 1] ?? { runs: [{ text: '' }] }\n  const paragraphs = lines.map((line, index) => {\n    const before = box.paragraphs[index] ?? fallback\n    const { text: _old, ...style } = before.runs[0] ?? { text: '' }\n    void _old\n    return { ...before, runs: [{ ...style, text: line }] }\n  })\n  return { ...box, paragraphs }\n}\n\n/** Every run of a box changed by `change` (bold, a size, a colour: the whole box at once). */\nexport function styleRuns(box: SlideBox, change: (run: TextRun) => TextRun): SlideBox {\n  return {\n    ...box,\n    paragraphs: box.paragraphs.map((paragraph) => ({\n      ...paragraph,\n      runs: paragraph.runs.map(change),\n    })),\n  }\n}\n\n/** A box's first run (what its style controls show). */\nexport const firstRun = (box: SlideBox): TextRun | undefined =>\n  box.paragraphs.find((paragraph) => paragraph.runs.length)?.runs[0]\n\nconst clamp = (value: number, min: number, max: number) =>\n  max < min ? (min + max) / 2 : Math.min(Math.max(value, min), max)\n\n/** The box moved by `dx, dy`, kept on the stage. */\nexport function moveBox(frame: BoxFrame, dx: number, dy: number): BoxFrame {\n  return {\n    ...frame,\n    x: clamp(frame.x + dx, -frame.w / 2, 1 - frame.w / 2),\n    y: clamp(frame.y + dy, -frame.h / 2, 1 - frame.h / 2),\n  }\n}\n\n/** A box handle: a corner or a side's middle. */\nexport type BoxHandle = 'nw' | 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w'\n\n/** The box resized from `handle` by `dx, dy` (its shape is free; the opposite side stays put). */\nexport function stretchBox(frame: BoxFrame, handle: BoxHandle, dx: number, dy: number): BoxFrame {\n  let { x, y, w, h } = frame\n  if (handle.includes('w')) {\n    const right = x + w\n    x = Math.min(x + dx, right - MIN_BOX)\n    w = right - x\n  } else if (handle.includes('e')) {\n    w = Math.max(MIN_BOX, w + dx)\n  }\n  if (handle.startsWith('n')) {\n    const bottom = y + h\n    y = Math.min(y + dy, bottom - MIN_BOX)\n    h = bottom - y\n  } else if (handle.startsWith('s')) {\n    h = Math.max(MIN_BOX, h + dy)\n  }\n  return { x, y, w, h }\n}\n\nlet sequence = 0\nexport const nextBoxId = (): string => `box-${Date.now().toString(36)}-${++sequence}`\n\n/** A new box of `shape`, in the middle of the slide, ready to type in. */\nexport function newBox(shape: BoxShape, accent: string): SlideBox {\n  const id = nextBoxId()\n  if (shape === 'text') {\n    return {\n      id,\n      shape,\n      frame: { x: 0.3, y: 0.42, w: 0.4, h: 0.12 },\n      paragraphs: [{ runs: [{ text: '', size: 24 }] }],\n      front: true,\n    }\n  }\n  if (shape === 'line') {\n    return {\n      id,\n      shape,\n      frame: { x: 0.35, y: 0.5, w: 0.3, h: 0 },\n      line: { color: accent, width: 2 },\n      paragraphs: [],\n      front: true,\n    }\n  }\n  return {\n    id,\n    shape,\n    frame: { x: 0.35, y: 0.35, w: 0.3, h: 0.3 },\n    fill: accent,\n    paragraphs: [{ runs: [{ text: '', size: 20, color: '#ffffff' }], align: 'center' }],\n    anchor: 'middle',\n    front: false,\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/presentation/draw-boxes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A slide's text boxes and shapes drawn on a canvas, as the stage draws them (`StageBox`): for the
+ * saved PDF's pages. Text wraps by words across runs of different type.
+ */
+import { type SlideBox } from './boxes';
+export declare function drawBox(context: CanvasRenderingContext2D, box: SlideBox, width: number, height: number, themeFont: string): void;
+/** The words a box shows, for a searchable PDF. */
+export declare const boxWords: (box: SlideBox) => string[];

package/dist/presentation/draw-boxes.js

@@ -0,0 +1,130 @@
+"use client";
+import {
+  DEFAULT_INSET,
+  DEFAULT_TEXT_SIZE,
+  pointsToStage
+} from "./boxes.js";
+import { TEXT_COLORS } from "./theme.js";
+const LINE_HEIGHT = 1.2;
+function fontOf(run, themeFont, width) {
+  const size = pointsToStage(run.size ?? DEFAULT_TEXT_SIZE) * width;
+  const family = run.font ? `"${run.font}", ${themeFont}` : themeFont;
+  return `${run.italic ? "italic " : ""}${run.bold ? 700 : 400} ${size}px ${family}`;
+}
+function outline(context, box, w, h) {
+  context.beginPath();
+  if (box.shape === "ellipse") context.ellipse(w / 2, h / 2, w / 2, h / 2, 0, 0, Math.PI * 2);
+  else if (box.shape === "roundRect") context.roundRect(0, 0, w, h, Math.min(w, h) / 6);
+  else context.rect(0, 0, w, h);
+}
+function drawBox(context, box, width, height, themeFont) {
+  const { frame } = box;
+  const w = frame.w * width;
+  const h = frame.h * height;
+  context.save();
+  context.translate(frame.x * width + w / 2, frame.y * height + h / 2);
+  if (box.rotation) context.rotate(box.rotation * Math.PI / 180);
+  context.translate(-w / 2, -h / 2);
+  const lineWidth = box.line ? Math.max(1, pointsToStage(box.line.width) * width) : 0;
+  if (box.shape === "line") {
+    context.strokeStyle = box.line?.color ?? TEXT_COLORS.body;
+    context.lineWidth = lineWidth || 1;
+    if (box.line?.dash) context.setLineDash([lineWidth * 3, lineWidth * 2]);
+    context.beginPath();
+    context.moveTo(0, box.flipV ? h : 0);
+    context.lineTo(w, box.flipV ? 0 : h);
+    context.stroke();
+    context.restore();
+    return;
+  }
+  if (box.fill) {
+    context.globalAlpha = box.fillAlpha ?? 1;
+    context.fillStyle = box.fill;
+    outline(context, box, w, h);
+    context.fill();
+    context.globalAlpha = 1;
+  }
+  if (box.line && lineWidth) {
+    context.strokeStyle = box.line.color;
+    context.lineWidth = lineWidth;
+    if (box.line.dash) context.setLineDash([lineWidth * 3, lineWidth * 2]);
+    outline(context, box, w, h);
+    context.stroke();
+    context.setLineDash([]);
+  }
+  const inset = pointsToStage(box.inset ?? DEFAULT_INSET) * width;
+  const room = w - 2 * inset;
+  context.textBaseline = "alphabetic";
+  const lines = [];
+  for (const paragraph of box.paragraphs) {
+    const size = pointsToStage(paragraph.runs[0]?.size ?? DEFAULT_TEXT_SIZE) * width;
+    const indent = (paragraph.level ?? 0) * 0.5 * size + (paragraph.bullet ? size * 0.9 : 0);
+    const words = [];
+    for (const run of paragraph.runs) {
+      context.font = fontOf(run, themeFont, width);
+      for (const part of run.text.split(/(\s+)/).filter(Boolean)) {
+        words.push({ text: part, run, width: context.measureText(part).width });
+      }
+    }
+    let line = [];
+    let used = 0;
+    let first = true;
+    const flush = () => {
+      lines.push({
+        pieces: line,
+        size,
+        align: paragraph.align ?? "left",
+        indent,
+        ...first && paragraph.bullet ? { bullet: paragraph.runs[0] } : {}
+      });
+      first = false;
+      line = [];
+      used = 0;
+    };
+    for (const word of words) {
+      if (used + word.width > room - indent && line.length && word.text.trim()) flush();
+      if (!line.length && !word.text.trim()) continue;
+      line.push(word);
+      used += word.width;
+    }
+    flush();
+  }
+  const total = lines.reduce((sum, line) => sum + line.size * LINE_HEIGHT, 0);
+  const free = h - 2 * inset - total;
+  let y = inset + (box.anchor === "middle" ? free / 2 : box.anchor === "bottom" ? free : 0);
+  context.save();
+  context.beginPath();
+  context.rect(0, 0, w, h);
+  context.clip();
+  for (const line of lines) {
+    const lineWidth2 = line.pieces.reduce((sum, piece) => sum + piece.width, 0);
+    const space = room - line.indent;
+    let x = inset + line.indent + (line.align === "center" ? (space - lineWidth2) / 2 : line.align === "right" ? space - lineWidth2 : 0);
+    const baseline = y + line.size * (LINE_HEIGHT - 0.2);
+    if (line.bullet) {
+      context.font = fontOf(line.bullet, themeFont, width);
+      context.fillStyle = line.bullet.color ?? TEXT_COLORS.body;
+      context.fillText("\u2022", inset + line.indent - line.size * 0.9, baseline);
+    }
+    for (const piece of line.pieces) {
+      context.font = fontOf(piece.run, themeFont, width);
+      context.fillStyle = piece.run.color ?? TEXT_COLORS.body;
+      context.fillText(piece.text, x, baseline);
+      if (piece.run.underline) {
+        context.fillRect(x, baseline + line.size * 0.08, piece.width, Math.max(1, line.size * 0.05));
+      }
+      x += piece.width;
+    }
+    y += line.size * LINE_HEIGHT;
+  }
+  context.restore();
+  context.restore();
+}
+const boxWords = (box) => box.paragraphs.map(
+  (paragraph) => paragraph.runs.map((run) => run.text).join("").trim()
+).filter(Boolean);
+export {
+  boxWords,
+  drawBox
+};
+//# sourceMappingURL=draw-boxes.js.map

package/dist/presentation/draw-boxes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/draw-boxes.ts"],
+  "sourcesContent": ["/**\n * A slide's text boxes and shapes drawn on a canvas, as the stage draws them (`StageBox`): for the\n * saved PDF's pages. Text wraps by words across runs of different type.\n */\n\nimport {\n  DEFAULT_INSET,\n  DEFAULT_TEXT_SIZE,\n  pointsToStage,\n  type SlideBox,\n  type TextRun,\n} from './boxes'\nimport { TEXT_COLORS } from './theme'\n\nconst LINE_HEIGHT = 1.2\n\nfunction fontOf(run: TextRun, themeFont: string, width: number): string {\n  const size = pointsToStage(run.size ?? DEFAULT_TEXT_SIZE) * width\n  const family = run.font ? `\"${run.font}\", ${themeFont}` : themeFont\n  return `${run.italic ? 'italic ' : ''}${run.bold ? 700 : 400} ${size}px ${family}`\n}\n\ninterface Piece {\n  text: string\n  run: TextRun\n  width: number\n}\n\n/** The box's outline path (its shape) at `x, y, w, h`. */\nfunction outline(context: CanvasRenderingContext2D, box: SlideBox, w: number, h: number) {\n  context.beginPath()\n  if (box.shape === 'ellipse') context.ellipse(w / 2, h / 2, w / 2, h / 2, 0, 0, Math.PI * 2)\n  else if (box.shape === 'roundRect') context.roundRect(0, 0, w, h, Math.min(w, h) / 6)\n  else context.rect(0, 0, w, h)\n}\n\nexport function drawBox(\n  context: CanvasRenderingContext2D,\n  box: SlideBox,\n  width: number,\n  height: number,\n  themeFont: string\n): void {\n  const { frame } = box\n  const w = frame.w * width\n  const h = frame.h * height\n  context.save()\n  context.translate(frame.x * width + w / 2, frame.y * height + h / 2)\n  if (box.rotation) context.rotate((box.rotation * Math.PI) / 180)\n  context.translate(-w / 2, -h / 2)\n\n  const lineWidth = box.line ? Math.max(1, pointsToStage(box.line.width) * width) : 0\n  if (box.shape === 'line') {\n    context.strokeStyle = box.line?.color ?? TEXT_COLORS.body\n    context.lineWidth = lineWidth || 1\n    if (box.line?.dash) context.setLineDash([lineWidth * 3, lineWidth * 2])\n    context.beginPath()\n    context.moveTo(0, box.flipV ? h : 0)\n    context.lineTo(w, box.flipV ? 0 : h)\n    context.stroke()\n    context.restore()\n    return\n  }\n  if (box.fill) {\n    context.globalAlpha = box.fillAlpha ?? 1\n    context.fillStyle = box.fill\n    outline(context, box, w, h)\n    context.fill()\n    context.globalAlpha = 1\n  }\n  if (box.line && lineWidth) {\n    context.strokeStyle = box.line.color\n    context.lineWidth = lineWidth\n    if (box.line.dash) context.setLineDash([lineWidth * 3, lineWidth * 2])\n    outline(context, box, w, h)\n    context.stroke()\n    context.setLineDash([])\n  }\n\n  // The text: each paragraph wrapped to the box (inside its inset), placed by its anchor.\n  const inset = pointsToStage(box.inset ?? DEFAULT_INSET) * width\n  const room = w - 2 * inset\n  context.textBaseline = 'alphabetic'\n  const lines: {\n    pieces: Piece[]\n    size: number\n    align: string\n    indent: number\n    bullet?: TextRun\n  }[] = []\n  for (const paragraph of box.paragraphs) {\n    const size = pointsToStage(paragraph.runs[0]?.size ?? DEFAULT_TEXT_SIZE) * width\n    const indent = (paragraph.level ?? 0) * 0.5 * size + (paragraph.bullet ? size * 0.9 : 0)\n    const words: Piece[] = []\n    for (const run of paragraph.runs) {\n      context.font = fontOf(run, themeFont, width)\n      for (const part of run.text.split(/(\\s+)/).filter(Boolean)) {\n        words.push({ text: part, run, width: context.measureText(part).width })\n      }\n    }\n    let line: Piece[] = []\n    let used = 0\n    let first = true\n    const flush = () => {\n      lines.push({\n        pieces: line,\n        size,\n        align: paragraph.align ?? 'left',\n        indent,\n        ...(first && paragraph.bullet ? { bullet: paragraph.runs[0] } : {}),\n      })\n      first = false\n      line = []\n      used = 0\n    }\n    for (const word of words) {\n      if (used + word.width > room - indent && line.length && word.text.trim()) flush()\n      if (!line.length && !word.text.trim()) continue\n      line.push(word)\n      used += word.width\n    }\n    flush()\n  }\n  const total = lines.reduce((sum, line) => sum + line.size * LINE_HEIGHT, 0)\n  const free = h - 2 * inset - total\n  let y = inset + (box.anchor === 'middle' ? free / 2 : box.anchor === 'bottom' ? free : 0)\n  context.save()\n  context.beginPath()\n  context.rect(0, 0, w, h)\n  context.clip()\n  for (const line of lines) {\n    const lineWidth = line.pieces.reduce((sum, piece) => sum + piece.width, 0)\n    const space = room - line.indent\n    let x =\n      inset +\n      line.indent +\n      (line.align === 'center'\n        ? (space - lineWidth) / 2\n        : line.align === 'right'\n          ? space - lineWidth\n          : 0)\n    const baseline = y + line.size * (LINE_HEIGHT - 0.2)\n    if (line.bullet) {\n      context.font = fontOf(line.bullet, themeFont, width)\n      context.fillStyle = line.bullet.color ?? TEXT_COLORS.body\n      context.fillText('\u2022', inset + line.indent - line.size * 0.9, baseline)\n    }\n    for (const piece of line.pieces) {\n      context.font = fontOf(piece.run, themeFont, width)\n      context.fillStyle = piece.run.color ?? TEXT_COLORS.body\n      context.fillText(piece.text, x, baseline)\n      if (piece.run.underline) {\n        context.fillRect(x, baseline + line.size * 0.08, piece.width, Math.max(1, line.size * 0.05))\n      }\n      x += piece.width\n    }\n    y += line.size * LINE_HEIGHT\n  }\n  context.restore()\n  context.restore()\n}\n\n/** The words a box shows, for a searchable PDF. */\nexport const boxWords = (box: SlideBox): string[] =>\n  box.paragraphs\n    .map((paragraph) =>\n      paragraph.runs\n        .map((run) => run.text)\n        .join('')\n        .trim()\n    )\n    .filter(Boolean)\n"],
+  "mappings": "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",
+  "names": ["lineWidth"]
+}

package/dist/presentation/export-boxes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A slide's text boxes and shapes as PowerPoint's own: editable text (each run's type, colour and
+ * weight, each paragraph's alignment, level and bullet) in a shape with its fill and outline, so a
+ * deck imported from PowerPoint goes back to PowerPoint as it came.
+ */
+import type PptxGenJS from 'pptxgenjs';
+import { type SlideBox } from './boxes';
+type Slide = ReturnType<PptxGenJS['addSlide']>;
+export declare function addBox(pptx: PptxGenJS, page: Slide, box: SlideBox, themeFont: string): void;
+export {};

package/dist/presentation/export-boxes.js

@@ -0,0 +1,74 @@
+"use client";
+import { DEFAULT_INSET, DEFAULT_TEXT_SIZE } from "./boxes.js";
+import { TEXT_COLORS } from "./theme.js";
+const SLIDE_INCHES = { w: 13.333, h: 7.5 };
+const hex = (color) => color.replace("#", "").toUpperCase();
+function addBox(pptx, page, box, themeFont) {
+  const { frame } = box;
+  const place = {
+    x: frame.x * SLIDE_INCHES.w,
+    y: frame.y * SLIDE_INCHES.h,
+    w: Math.max(0.01, frame.w * SLIDE_INCHES.w),
+    h: frame.h * SLIDE_INCHES.h,
+    ...box.rotation ? { rotate: box.rotation } : {},
+    ...box.flipH ? { flipH: true } : {},
+    ...box.flipV ? { flipV: true } : {}
+  };
+  const line = box.line ? {
+    color: hex(box.line.color),
+    width: box.line.width,
+    ...box.line.dash ? { dashType: "dash" } : {}
+  } : void 0;
+  if (box.shape === "line") {
+    page.addShape(pptx.ShapeType.line, {
+      ...place,
+      line: line ?? { color: hex(TEXT_COLORS.body), width: 1 }
+    });
+    return;
+  }
+  const shape = box.shape === "ellipse" ? pptx.ShapeType.ellipse : box.shape === "roundRect" ? pptx.ShapeType.roundRect : pptx.ShapeType.rect;
+  const fill = box.fill ? {
+    color: hex(box.fill),
+    ...box.fillAlpha !== void 0 ? { transparency: Math.round((1 - box.fillAlpha) * 100) } : {}
+  } : void 0;
+  const runs = [];
+  box.paragraphs.forEach((paragraph, p) => {
+    const last = p === box.paragraphs.length - 1;
+    const paragraphRuns = paragraph.runs.length ? paragraph.runs : [{ text: "" }];
+    paragraphRuns.forEach((run, r) => {
+      runs.push({
+        text: run.text,
+        options: {
+          fontSize: run.size ?? DEFAULT_TEXT_SIZE,
+          fontFace: run.font ?? themeFont,
+          color: hex(run.color ?? TEXT_COLORS.body),
+          ...run.bold ? { bold: true } : {},
+          ...run.italic ? { italic: true } : {},
+          ...run.underline ? { underline: { style: "sng" } } : {},
+          align: paragraph.align ?? "left",
+          ...paragraph.level ? { indentLevel: paragraph.level } : {},
+          ...paragraph.bullet && r === 0 ? { bullet: true } : {},
+          ...r === paragraphRuns.length - 1 && !last ? { breakLine: true } : {}
+        }
+      });
+    });
+  });
+  const text = runs.some((run) => run.text);
+  if (!text && box.shape === "text") return;
+  page.addText(text ? runs : "", {
+    ...place,
+    shape,
+    ...fill ? { fill } : {},
+    ...line ? { line } : {},
+    // Its part in the slide (its title, its body), kept by name: read back when imported.
+    ...box.role ? { objectName: `ARBI ${box.role}` } : {},
+    valign: box.anchor ?? "top",
+    margin: box.inset ?? DEFAULT_INSET,
+    lineSpacingMultiple: 1,
+    fit: "none"
+  });
+}
+export {
+  addBox
+};
+//# sourceMappingURL=export-boxes.js.map

package/dist/presentation/export-boxes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/export-boxes.ts"],
+  "sourcesContent": ["/**\n * A slide's text boxes and shapes as PowerPoint's own: editable text (each run's type, colour and\n * weight, each paragraph's alignment, level and bullet) in a shape with its fill and outline, so a\n * deck imported from PowerPoint goes back to PowerPoint as it came.\n */\n\nimport type PptxGenJS from 'pptxgenjs'\nimport { DEFAULT_INSET, DEFAULT_TEXT_SIZE, type SlideBox } from './boxes'\nimport { TEXT_COLORS } from './theme'\n\n/** PowerPoint's widescreen slide, in inches. */\nconst SLIDE_INCHES = { w: 13.333, h: 7.5 }\nconst hex = (color: string) => color.replace('#', '').toUpperCase()\n\ntype Slide = ReturnType<PptxGenJS['addSlide']>\n\nexport function addBox(pptx: PptxGenJS, page: Slide, box: SlideBox, themeFont: string): void {\n  const { frame } = box\n  const place = {\n    x: frame.x * SLIDE_INCHES.w,\n    y: frame.y * SLIDE_INCHES.h,\n    w: Math.max(0.01, frame.w * SLIDE_INCHES.w),\n    h: frame.h * SLIDE_INCHES.h,\n    ...(box.rotation ? { rotate: box.rotation } : {}),\n    ...(box.flipH ? { flipH: true } : {}),\n    ...(box.flipV ? { flipV: true } : {}),\n  }\n  const line = box.line\n    ? {\n        color: hex(box.line.color),\n        width: box.line.width,\n        ...(box.line.dash ? { dashType: 'dash' as const } : {}),\n      }\n    : undefined\n  if (box.shape === 'line') {\n    page.addShape(pptx.ShapeType.line, {\n      ...place,\n      line: line ?? { color: hex(TEXT_COLORS.body), width: 1 },\n    })\n    return\n  }\n  const shape =\n    box.shape === 'ellipse'\n      ? pptx.ShapeType.ellipse\n      : box.shape === 'roundRect'\n        ? pptx.ShapeType.roundRect\n        : pptx.ShapeType.rect\n  const fill = box.fill\n    ? {\n        color: hex(box.fill),\n        ...(box.fillAlpha !== undefined\n          ? { transparency: Math.round((1 - box.fillAlpha) * 100) }\n          : {}),\n      }\n    : undefined\n  const runs: PptxGenJS.TextProps[] = []\n  box.paragraphs.forEach((paragraph, p) => {\n    const last = p === box.paragraphs.length - 1\n    const paragraphRuns = paragraph.runs.length ? paragraph.runs : [{ text: '' }]\n    paragraphRuns.forEach((run, r) => {\n      runs.push({\n        text: run.text,\n        options: {\n          fontSize: run.size ?? DEFAULT_TEXT_SIZE,\n          fontFace: run.font ?? themeFont,\n          color: hex(run.color ?? TEXT_COLORS.body),\n          ...(run.bold ? { bold: true } : {}),\n          ...(run.italic ? { italic: true } : {}),\n          ...(run.underline ? { underline: { style: 'sng' as const } } : {}),\n          align: paragraph.align ?? 'left',\n          ...(paragraph.level ? { indentLevel: paragraph.level } : {}),\n          ...(paragraph.bullet && r === 0 ? { bullet: true } : {}),\n          ...(r === paragraphRuns.length - 1 && !last ? { breakLine: true } : {}),\n        },\n      })\n    })\n  })\n  const text = runs.some((run) => run.text)\n  if (!text && box.shape === 'text') return\n  page.addText(text ? runs : '', {\n    ...place,\n    shape,\n    ...(fill ? { fill } : {}),\n    ...(line ? { line } : {}),\n    // Its part in the slide (its title, its body), kept by name: read back when imported.\n    ...(box.role ? { objectName: `ARBI ${box.role}` } : {}),\n    valign: box.anchor ?? 'top',\n    margin: box.inset ?? DEFAULT_INSET,\n    lineSpacingMultiple: 1,\n    fit: 'none',\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/presentation/export-pptx.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The presentation as a PowerPoint deck (.pptx), drawn from the same geometry as the stage and the
+ * saved PDF: each slide's themed background (an image, painted as the PDF's is), its title, rule
+ * and points as real, editable PowerPoint text in the theme's typeface, each clip as an image
+ * (redactions burnt in, at 1.5× the size it is shown, so it stays sharp on a projector) with its
+ * label, and the logo. PptxGenJS is loaded only when a deck is exported.
+ */
+import { type Clip, type Slide } from './model';
+import { type SlideLook } from './render-slides';
+export interface DeckContent {
+    title: string;
+    slides: readonly Slide[];
+    clips: readonly Clip[];
+}
+/** The deck as a .pptx file. */
+export declare function buildPptx(deck: DeckContent, look: SlideLook): Promise<Blob>;