@arbidocs/blocks 0.5.120 → 0.5.122

package/dist/presentation/slide-layout.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/slide-layout.ts"],
+  "sourcesContent": ["/**\n * Where a slide's parts go, by its layout: its title, the accent rule, its text (points, or a\n * subtitle), the logo in the footer, and the room its clips are arranged in. One description,\n * drawn by the stage, the saved PDF and the PowerPoint export alike.\n *\n * All positions are fractions of the stage (x, w of its width; y, h of its height); type sizes\n * are fractions of the stage width.\n */\n\nimport { CAPTION_SPACE, STAGE_MARGIN, type Reserve, type Slide, type SlideLayout } from './model'\nimport type { LogoCorner } from './theme'\n\n/** Text sits this far in from the stage's sides: a generous margin. */\nconst TEXT_INSET = 0.06\n\nexport interface TextBox {\n  x: number\n  y: number\n  w: number\n  h: number\n  /** Type size, a fraction of the stage width. */\n  size: number\n  weight: 400 | 600 | 700\n  align: 'left' | 'center'\n  tone: 'title' | 'body' | 'muted'\n  /** Lines start with a bullet in the accent colour. */\n  bullets?: boolean\n  /** Line height, a multiple of the type size. */\n  leading: number\n  /** Where the text sits in its box, top to bottom (default top). */\n  anchor?: 'top' | 'middle' | 'bottom'\n}\n\nexport interface Box {\n  x: number\n  y: number\n  w: number\n  h: number\n}\n\nexport interface SlideGeometry {\n  /** Where its title goes (none on a blank slide: its text is in its boxes). */\n  title: TextBox | null\n  /** The accent rule (under or above the title), when the slide shows a title. */\n  rule: Box | null\n  /** Where its points (or subtitle) go, if this layout has text. */\n  text: TextBox | null\n  logo: Box | null\n  /** The room its clips keep free (they are arranged in the rest). */\n  reserve: Reserve\n}\n\nexport const LAYOUT_INFO: Record<SlideLayout, { label: string; text?: string }> = {\n  clips: { label: 'Title and clips' },\n  points: { label: 'Clips and points', text: 'One point per line' },\n  compare: { label: 'Side by side' },\n  title: { label: 'Title slide', text: 'Subtitle' },\n  section: { label: 'Section', text: 'Subtitle' },\n  free: { label: 'Blank' },\n}\n\n/** The footer's height while a logo shows. */\nconst FOOTER = 0.085\n\nexport function slideGeometry(\n  /** `items`, when given: a points slide with none puts its text across the slide. */\n  slide: Pick<Slide, 'layout' | 'caption'> & { items?: readonly unknown[] },\n  options: { labels: boolean; logo: LogoCorner | null }\n): SlideGeometry {\n  const below = options.labels ? CAPTION_SPACE : 0\n  const bottom = options.logo ? FOOTER : 0\n  const logo: Box | null = options.logo\n    ? {\n        x: options.logo === 'bl' ? TEXT_INSET : 1 - TEXT_INSET - 0.16,\n        y: 1 - 0.03 - 0.055,\n        w: 0.16,\n        h: 0.055,\n      }\n    : null\n  const hasTitle = slide.caption.trim() !== ''\n\n  // Blank: nothing of its own but the logo; whatever is placed on it goes anywhere.\n  if (slide.layout === 'free') {\n    return { title: null, rule: null, text: null, logo, reserve: { top: 0, below, bottom } }\n  }\n\n  if (slide.layout === 'title' || slide.layout === 'section') {\n    const centred = slide.layout === 'title'\n    const title: TextBox = centred\n      ? {\n          x: 0.1,\n          y: 0.28,\n          w: 0.8,\n          h: 0.2,\n          size: 0.052,\n          weight: 700,\n          align: 'center',\n          tone: 'title',\n          leading: 1.1,\n          // Just above the rule, however many lines it takes.\n          anchor: 'bottom',\n        }\n      : {\n          x: TEXT_INSET + 0.02,\n          y: 0.36,\n          w: 0.8,\n          h: 0.18,\n          size: 0.046,\n          weight: 700,\n          align: 'left',\n          tone: 'title',\n          leading: 1.1,\n        }\n    return {\n      title,\n      rule: centred\n        ? { x: 0.47, y: 0.505, w: 0.06, h: 0.007 }\n        : { x: TEXT_INSET + 0.02, y: 0.33, w: 0.07, h: 0.008 },\n      text: {\n        x: title.x,\n        y: centred ? 0.545 : 0.555,\n        w: title.w,\n        h: 0.1,\n        size: 0.021,\n        weight: 400,\n        align: title.align,\n        tone: 'muted',\n        leading: 1.3,\n      },\n      logo,\n      // Clips, if any, go under the text.\n      reserve: { top: 0.62, below, bottom },\n    }\n  }\n\n  const title: TextBox = {\n    x: TEXT_INSET,\n    y: 0.05,\n    w: 1 - 2 * TEXT_INSET,\n    h: 0.075,\n    size: 0.03,\n    weight: 600,\n    align: 'left',\n    tone: 'title',\n    leading: 1.15,\n  }\n  const top = hasTitle ? 0.14 : 0\n  // Clips line up with the slide's text (its title, its points); with none, they take the room.\n  const inset = hasTitle || slide.layout === 'points' ? TEXT_INSET - STAGE_MARGIN : 0\n  const geometry: SlideGeometry = {\n    title,\n    rule: hasTitle ? { x: TEXT_INSET, y: 0.128, w: 0.045, h: 0.006 } : null,\n    text: null,\n    logo,\n    reserve: { top, below, bottom, inset },\n  }\n  if (slide.layout === 'points' && slide.items && slide.items.length === 0) {\n    // Points alone: across the slide, under its title (no room kept for clips that are not there).\n    const y = STAGE_MARGIN + top\n    geometry.text = {\n      x: TEXT_INSET,\n      y,\n      w: 1 - 2 * TEXT_INSET,\n      h: 1 - y - STAGE_MARGIN - bottom,\n      size: 0.024,\n      weight: 400,\n      align: 'left',\n      tone: 'body',\n      bullets: true,\n      leading: 1.45,\n    }\n    return geometry\n  }\n  if (slide.layout === 'points') {\n    const y = STAGE_MARGIN + top\n    geometry.text = {\n      x: 0.6,\n      y,\n      w: 1 - 0.6 - TEXT_INSET,\n      h: 1 - y - STAGE_MARGIN - bottom - below,\n      // Level with the clips, which are centred in their room.\n      anchor: 'middle',\n      size: 0.0195,\n      weight: 400,\n      align: 'left',\n      tone: 'body',\n      bullets: true,\n      leading: 1.45,\n    }\n    geometry.reserve = { ...geometry.reserve, right: 0.4 - inset }\n  }\n  if (slide.layout === 'compare') geometry.reserve = { ...geometry.reserve, columns: 2 }\n  return geometry\n}\n\n/** The lines of a slide's text (blank lines dropped). */\nexport const textLines = (text: string): string[] =>\n  text\n    .split('\\n')\n    .map((line) => line.trim())\n    .filter(Boolean)\n"],
+  "mappings": "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",
+  "names": ["title"]
+}

package/dist/presentation/stage-videos.d.ts

@@ -0,0 +1,5 @@
+/** The presented stage's videos, which the presenter plays and pauses with Space. */
+/** Marks the stage's videos, for the presenter's Space key. */
+export declare const STAGE_VIDEO_ATTRIBUTE = "data-presentation-video";
+/** Play the presented stage's videos, or pause them if any is playing. */
+export declare function toggleStageVideos(doc: Document): boolean;

package/dist/presentation/stage-videos.js

@@ -0,0 +1,19 @@
+"use client";
+const STAGE_VIDEO_ATTRIBUTE = "data-presentation-video";
+function toggleStageVideos(doc) {
+  const videos = Array.from(
+    doc.querySelectorAll(`video[${STAGE_VIDEO_ATTRIBUTE}]`)
+  );
+  if (!videos.length) return false;
+  const playing = videos.some((video) => !video.paused);
+  for (const video of videos) {
+    if (playing) video.pause();
+    else void video.play().catch(() => void 0);
+  }
+  return true;
+}
+export {
+  STAGE_VIDEO_ATTRIBUTE,
+  toggleStageVideos
+};
+//# sourceMappingURL=stage-videos.js.map

package/dist/presentation/stage-videos.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/stage-videos.ts"],
+  "sourcesContent": ["/** The presented stage's videos, which the presenter plays and pauses with Space. */\n\n/** Marks the stage's videos, for the presenter's Space key. */\nexport const STAGE_VIDEO_ATTRIBUTE = 'data-presentation-video'\n\n/** Play the presented stage's videos, or pause them if any is playing. */\nexport function toggleStageVideos(doc: Document): boolean {\n  const videos = Array.from(\n    doc.querySelectorAll<HTMLVideoElement>(`video[${STAGE_VIDEO_ATTRIBUTE}]`)\n  )\n  if (!videos.length) return false\n  const playing = videos.some((video) => !video.paused)\n  for (const video of videos) {\n    if (playing) video.pause()\n    else void video.play().catch(() => undefined)\n  }\n  return true\n}\n"],
+  "mappings": ";AAGO,MAAM,wBAAwB;AAG9B,SAAS,kBAAkB,KAAwB;AACxD,QAAM,SAAS,MAAM;AAAA,IACnB,IAAI,iBAAmC,SAAS,qBAAqB,GAAG;AAAA,EAC1E;AACA,MAAI,CAAC,OAAO,OAAQ,QAAO;AAC3B,QAAM,UAAU,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,MAAM;AACpD,aAAW,SAAS,QAAQ;AAC1B,QAAI,QAAS,OAAM,MAAM;AAAA,QACpB,MAAK,MAAM,KAAK,EAAE,MAAM,MAAM,MAAS;AAAA,EAC9C;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/presentation/store.d.ts

@@ -0,0 +1,203 @@
+/**
+ * The presentation of this session: the clips taken, the slides they are arranged on, the slide on
+ * the stage, whether the stage is blanked and whether the presentation window presents (shows only
+ * the stage, for sharing) or edits. Clips taken in the app's viewer land in it at once.
+ *
+ * Kept in memory only: a clip holds the decrypted PDF it is drawn from, so nothing is written to
+ * storage, and everything is cleared when the session signs out (`ConnectedPresentation`).
+ */
+import { type Alignment, type Clip, type Rect, type Reserve, type Frame, type Slide, type SlideLayout } from './model';
+import { type Theme } from './theme';
+import { type SlideBackground, type SlideBox } from './boxes';
+import type { SavedBox } from './saved-boxes';
+/** A slide holds a handful of clips: more would be too small to read on a shared screen. */
+export declare const MAX_ITEMS_PER_SLIDE = 6;
+export type NewClip = Omit<Clip, 'id' | 'caption'> & {
+    caption?: string;
+};
+export type FrameCommand = 'fullWidth' | 'fullHeight' | 'fit';
+interface PresentationState {
+    clips: Clip[];
+    slides: Slide[];
+    /** Index of the slide on the stage. */
+    current: number;
+    /** The stage shows nothing (black) while true. */
+    blank: boolean;
+    captions: boolean;
+    /** One look for every slide: background, typeface, accent, logo. Saved. */
+    theme: Theme;
+    /** The theme's logo image (this session only; fetched by the host from `theme.logo`). */
+    logoImage: Blob | null;
+    /**
+     * The annotation column (a tag's id) whose value for each clip's document leads its label: an
+     * Exhibit column's "R-100". Saved with the presentation.
+     */
+    labelColumn: string | null;
+    /** Each clip document's value in `labelColumn`, kept current by the host (not saved). */
+    columnValues: Readonly<Record<string, string>>;
+    /** Present mode: the presentation window shows only the stage (what is shared). */
+    presenting: boolean;
+    /** The presentation's name (its file's, once saved). */
+    title: string;
+    /** The document it is saved as, once saved: saving again adds a version to it. */
+    savedId: string | null;
+    /** Which version of that document this is (as opened or saved), when known. */
+    version: number | null;
+    /**
+     * The document (or draft) this presentation is edited as, in the viewer: its slides tab shows
+     * it. Null: clips gathered with no presentation open yet (a new one takes them).
+     */
+    boundTo: string | null;
+    /** The presentation as last opened or saved (serialised), to tell unsaved changes; null: never. */
+    clean: string | null;
+    /**
+     * A message for the presentation window itself (saved, failed…): the app's notifications show in
+     * the app's window, out of sight behind a popped-out presentation.
+     */
+    notice: {
+        text: string;
+        kind: 'success' | 'error';
+        id: number;
+    } | null;
+    /** The clip being dragged from the tray, while it is (the drop targets light up). */
+    dragging: string | null;
+    /** Images embedded in the presentation (an imported deck's pictures), as data URLs, by key. */
+    media: Readonly<Record<string, string>>;
+}
+interface PresentationActions {
+    /** Add a clip; it is placed on the current slide while that has fewer than two. */
+    addClip(clip: NewClip): string;
+    removeClip(clipId: string): void;
+    setCaption(clipId: string, caption: string): void;
+    /** Put a clip on the current slide (at a point, when dropped there). */
+    place(clipId: string, at?: {
+        x: number;
+        y: number;
+    }): void;
+    unplace(clipId: string): void;
+    /** Move or resize a clip by hand: the slide stops arranging itself. */
+    setFrame(clipId: string, frame: Frame): void;
+    applyFrame(clipId: string, command: FrameCommand): void;
+    /** Overlapping clips: this one on top of the others (later items are drawn over earlier ones). */
+    bringToFront(clipId: string): void;
+    /** Overlapping clips: this one under the others. */
+    sendToBack(clipId: string): void;
+    /**
+     * Scroll what a clip shows over its page, image or video by `dx, dy` (fractions of the source),
+     * its size kept and kept within the source: e.g. to show the lines above or below a passage.
+     */
+    panClip(clipId: string, dx: number, dy: number): void;
+    /**
+     * Zoom what a clip shows by `factor` (2: twice as close) about its centre: its area over the
+     * source shrinks or grows, its shape kept, never past the source's edges.
+     */
+    zoomClip(clipId: string, factor: number): void;
+    /** Zoom a clip to `percent` of how close it was cut (100: as cut), about its centre. */
+    setClipZoom(clipId: string, percent: number): void;
+    /** Align a clip on the stage (inside the margins and the slide's reserved room). */
+    align(clipId: string, alignment: Alignment): void;
+    /** Nudge a clip by `dx, dy` (stage fractions), kept on the stage, not snapped. */
+    nudge(clipId: string, dx: number, dy: number): void;
+    /** The current slide's caption (shown across its top; empty for none). */
+    /** A slide's title (default the current slide's). */
+    setSlideCaption(caption: string, index?: number): void;
+    /** The current slide's layout: it is arranged for it again. */
+    setSlideLayout(layout: SlideLayout, index?: number): void;
+    /** The current slide's text (its points, or subtitle). */
+    setSlidePoints(points: string, index?: number): void;
+    /** Change the theme; slides arranging themselves make room for a logo (or give it back). */
+    setTheme(change: Partial<Theme>): void;
+    setLogoImage(image: Blob | null): void;
+    /** Arrange the current slide automatically again. */
+    arrange(): void;
+    /** A new slide after the current one (by default with the current slide's layout). */
+    addSlide(layout?: SlideLayout, after?: number): void;
+    /** Remove a slide (default the current one); the last one left is emptied instead. */
+    removeSlide(index?: number): void;
+    /** A copy of a slide (its title, points and clips), right after it. */
+    duplicateSlide(index: number): void;
+    /** Move a slide to `to` (the others shift up or down). */
+    moveSlide(index: number, to: number): void;
+    goTo(index: number): void;
+    setBlank(blank: boolean): void;
+    setCaptions(captions: boolean): void;
+    setLabelColumn(tagId: string | null): void;
+    setColumnValues(values: Readonly<Record<string, string>>): void;
+    setPresenting(presenting: boolean): void;
+    setDragging(clipId: string | null): void;
+    setTitle(title: string): void;
+    notify(text: string, kind: 'success' | 'error'): void;
+    clearNotice(id: number): void;
+    /** Show another part of an image or video clip's source (a new crop): its area and shape. */
+    cropClip(clipId: string, rect: Rect, aspect: number): void;
+    /**
+     * A clip reshaped on the current slide (`reshapeFrame`): it shows `rect` of its source, in
+     * `frame`, at the same scale and zoom. Slides arranging themselves arrange around its new shape.
+     */
+    reshapeClip(clipId: string, frame: Frame, rect: Rect, aspect: number): void;
+    /** A text box or shape on a slide (default the current one), on top; resolves with its id. */
+    addBox(box: Omit<SlideBox, 'id'>, index?: number): string;
+    /** Change a box (wherever it is). */
+    updateBox(boxId: string, change: (box: SlideBox) => SlideBox): void;
+    /** Type a box's text (one paragraph per line, each keeping its style). */
+    setBoxText(boxId: string, text: string): void;
+    removeBox(boxId: string): void;
+    /** A box over the slide's clips and other boxes, or under them all. */
+    restackBox(boxId: string, to: 'front' | 'back'): void;
+    /** A slide's speaker notes (default the current slide's). */
+    setSlideNotes(notes: string, index?: number): void;
+    /** A slide's own background (none: the theme's). */
+    setSlideBackground(background: SlideBackground | undefined, index?: number): void;
+    /** Saved as this document (under this title), as its `version`. */
+    setSaved(savedId: string, title: string, version?: number | null): void;
+    /** Edited as this document or draft (see `boundTo`). */
+    bind(boundTo: string | null): void;
+    /** Clips gathered before (with no presentation open), added to the tray, not placed. */
+    adoptClips(clips: readonly Clip[]): void;
+    /** Replace the presentation with one opened from a file (its clips' sources fetched). */
+    load(opened: {
+        title: string;
+        /** The document it is saved as; null for a new one (from a template). */
+        savedId: string | null;
+        /** Its version, when known. */
+        version?: number | null;
+        /** Edited as (default `savedId`): an older file opened unsaved is still its own. */
+        boundTo?: string | null;
+        captions: boolean;
+        labelColumn?: string | null;
+        theme?: Theme;
+        clips: Omit<Clip, 'id'>[];
+        slides: {
+            caption: string;
+            auto: boolean;
+            layout?: SlideLayout;
+            points?: string;
+            items: {
+                clip: number;
+                frame: Frame;
+            }[];
+            boxes?: readonly SavedBox[];
+            background?: SlideBackground;
+            notes?: string;
+        }[];
+        media?: Readonly<Record<string, string>>;
+    }): void;
+    reset(): void;
+}
+export type PresentationStore = PresentationState & PresentationActions;
+/** What arranging a slide depends on besides its clips: labels shown, a logo in the footer. */
+type Look = Pick<PresentationState, 'captions' | 'theme'>;
+/**
+ * The room a slide keeps free of clips: its title and text (by its layout), each clip's label
+ * under it, the footer while a logo shows.
+ */
+export declare const reserveOf: (slide: Pick<Slide, "caption" | "layout">, look: Look) => Reserve;
+export declare const usePresentation: import("zustand").UseBoundStore<import("zustand").StoreApi<PresentationStore>>;
+/** The slide on the stage. */
+export declare const currentSlide: (state: PresentationState) => Slide | undefined;
+/**
+ * The presentation has changes not saved: since it was opened or saved; or, never saved, anything
+ * in it at all (a clip, a title, a point).
+ */
+export declare function hasUnsavedChanges(state: PresentationState): boolean;
+export {};