@arbidocs/blocks 0.5.119 → 0.5.121

package/dist/presentation/persistence.js

@@ -0,0 +1,141 @@
+"use client";
+import {
+  SLIDE_LAYOUTS
+} from "./model.js";
+import { parseTheme } from "./theme.js";
+import { parseBackground, parseBoxes } from "./saved-boxes.js";
+const PRESENTATIONS_FOLDER = "Presentations";
+const TEMPLATES_FOLDER = `${PRESENTATIONS_FOLDER}/Templates`;
+const EXPORTS_FOLDER = `${PRESENTATIONS_FOLDER}/Exports`;
+import { LEGACY_PRESENTATION_SUFFIX, PRESENTATION_FILE_SUFFIX } from "./panel-id.js";
+const PRESENTATION_ATTACHMENT = "arbi-presentation.json";
+const FORMAT = "arbi-presentation";
+function serializePresentation(snapshot) {
+  const index = new Map(snapshot.clips.map((clip, i) => [clip.id, i]));
+  return {
+    format: FORMAT,
+    version: 1,
+    title: snapshot.title,
+    captions: snapshot.captions,
+    ...snapshot.labelColumn ? { labelColumn: snapshot.labelColumn } : {},
+    ...snapshot.theme ? { theme: snapshot.theme } : {},
+    clips: snapshot.clips.map((clip) => ({
+      kind: clip.kind,
+      documentId: clip.documentId,
+      ...clip.version !== void 0 ? { version: clip.version } : {},
+      fileName: clip.fileName,
+      page: clip.page,
+      rect: clip.rect,
+      aspect: clip.aspect,
+      caption: clip.caption,
+      ...clip.start !== void 0 ? { start: clip.start } : {},
+      ...clip.zoomBase !== void 0 ? { zoomBase: clip.zoomBase } : {},
+      ...clip.media ? { media: clip.media } : {},
+      ...clip.plain ? { plain: true } : {}
+    })),
+    slides: snapshot.slides.map((slide, i) => ({
+      caption: slide.caption,
+      auto: slide.auto,
+      layout: slide.layout ?? "clips",
+      ...slide.points ? { points: slide.points } : {},
+      items: slide.items.filter((item) => index.has(item.clipId)).map((item) => ({ clip: index.get(item.clipId), frame: item.frame })),
+      ...slide.boxes?.length ? { boxes: slide.boxes.map(({ id: _id, ...box }) => (void _id, box)) } : {},
+      ...slide.background ? { background: slide.background } : {},
+      ...slide.notes?.trim() ? { notes: slide.notes } : {},
+      ...snapshot.fingerprints?.[i] ? { fingerprint: snapshot.fingerprints[i] } : {}
+    })),
+    ...usedMedia(snapshot) ? { media: usedMedia(snapshot) } : {}
+  };
+}
+function usedMedia(snapshot) {
+  const media = snapshot.media ?? {};
+  const keys = /* @__PURE__ */ new Set();
+  for (const clip of snapshot.clips) if (clip.media) keys.add(clip.media);
+  for (const slide of snapshot.slides) if (slide.background?.image) keys.add(slide.background.image);
+  const used = Object.fromEntries(
+    [...keys].filter((key) => media[key]).map((key) => [key, media[key]])
+  );
+  return Object.keys(used).length ? used : void 0;
+}
+const isNumber = (v) => typeof v === "number" && Number.isFinite(v);
+const isRect = (v) => {
+  const r = v;
+  return !!r && isNumber(r.x) && isNumber(r.y) && isNumber(r.w) && isNumber(r.h) && r.w > 0 && r.h > 0;
+};
+const isFrame = (v) => {
+  const f = v;
+  return !!f && isNumber(f.x) && isNumber(f.y) && isNumber(f.w) && f.w > 0;
+};
+function parsePresentation(text) {
+  const data = JSON.parse(text);
+  if (data?.format !== FORMAT || data.version !== 1) throw new Error("Not a presentation file");
+  const clips = Array.isArray(data.clips) ? data.clips : [];
+  const slides = Array.isArray(data.slides) ? data.slides : [];
+  const media = data.media && typeof data.media === "object" ? Object.fromEntries(
+    Object.entries(data.media).filter(
+      ([, url]) => typeof url === "string" && url.startsWith("data:image/")
+    )
+  ) : {};
+  for (const clip of clips) {
+    if (!["pdf", "image", "video"].includes(clip.kind) || typeof clip.documentId !== "string" || clip.media !== void 0 && !media[clip.media] || !isRect(clip.rect) || !isNumber(clip.aspect) || !isNumber(clip.page)) {
+      throw new Error("The presentation file is damaged");
+    }
+  }
+  for (const slide of slides) {
+    if (!Array.isArray(slide.items)) throw new Error("The presentation file is damaged");
+    for (const item of slide.items) {
+      if (!isNumber(item.clip) || !clips[item.clip] || !isFrame(item.frame)) {
+        throw new Error("The presentation file is damaged");
+      }
+    }
+  }
+  return {
+    format: FORMAT,
+    version: 1,
+    title: typeof data.title === "string" ? data.title : "Presentation",
+    captions: data.captions !== false,
+    ...data.theme !== void 0 ? { theme: parseTheme(data.theme) } : {},
+    ...typeof data.labelColumn === "string" && data.labelColumn ? { labelColumn: data.labelColumn } : {},
+    clips,
+    slides: slides.map((slide) => {
+      const { boxes, background, fingerprint, notes, ...rest } = slide;
+      const parsedBoxes = parseBoxes(boxes);
+      const parsedBackground = parseBackground(background, media);
+      return {
+        ...rest,
+        layout: SLIDE_LAYOUTS.includes(slide.layout) ? slide.layout : "clips",
+        ...typeof slide.points === "string" && slide.points ? { points: slide.points } : {},
+        ...parsedBoxes.length ? { boxes: parsedBoxes } : {},
+        ...parsedBackground ? { background: parsedBackground } : {},
+        ...typeof fingerprint === "string" ? { fingerprint } : {},
+        ...typeof notes === "string" && notes.trim() ? { notes } : {}
+      };
+    }),
+    ...Object.keys(media).length ? { media } : {},
+    ...data.slidesStale === true ? { slidesStale: true } : {}
+  };
+}
+function safeFileStem(title) {
+  return title.replace(/[\\/:*?"<>|]+/g, " ").trim() || "Presentation";
+}
+function presentationFileName(title) {
+  return `${safeFileStem(title)}.pptx`;
+}
+function presentationTitle(fileName) {
+  for (const suffix of [PRESENTATION_FILE_SUFFIX, LEGACY_PRESENTATION_SUFFIX, ".pptx", ".pdf"]) {
+    if (fileName.endsWith(suffix)) return fileName.slice(0, -suffix.length);
+  }
+  return fileName;
+}
+export {
+  EXPORTS_FOLDER,
+  PRESENTATIONS_FOLDER,
+  PRESENTATION_ATTACHMENT,
+  TEMPLATES_FOLDER,
+  parsePresentation,
+  presentationFileName,
+  presentationTitle,
+  safeFileStem,
+  serializePresentation
+};
+//# sourceMappingURL=persistence.js.map

package/dist/presentation/persistence.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/persistence.ts"],
+  "sourcesContent": ["/**\n * A presentation saved as a document of the workspace's `Presentations` folder,\n * `<title>.presentation.pdf`: a PDF of its slides (each an image as presented, redactions burnt in,\n * its words searchable), with its editable data attached to the PDF as `arbi-presentation.json`\n * (the format below; see docs/presentation-format.md). One file: viewing, searching, downloading,\n * copying and versions are a PDF's, and the editable data can never part from its slides.\n *\n * The data holds references, never pixels: for each clip its source document (and version), page,\n * area and label; for each slide its title and where its clips sit. Opening it fetches the sources\n * again (so clips stay sharp and editable) and reads their redactions again (so a newer redaction\n * applies too).\n *\n * Agents and the API: read and write the attachment with any PDF library. Changing the data cannot\n * redraw the slides (that needs the sources and their redactions, decrypted in the app), so set\n * `slidesStale: true`: the editor says so on opening, and its next save draws them again.\n */\n\nimport {\n  SLIDE_LAYOUTS,\n  type Clip,\n  type ClipKind,\n  type Frame,\n  type Rect,\n  type SlideLayout,\n} from './model'\nimport { parseTheme, type Theme } from './theme'\nimport { parseBackground, parseBoxes, type SavedBox } from './saved-boxes'\nimport type { SlideBackground, SlideBox } from './boxes'\n\nexport const PRESENTATIONS_FOLDER = 'Presentations'\n/**\n * Templates: presentations kept here are offered by New from template (their look and slides,\n * without clips). A firm keeps its house look by keeping one here.\n */\nexport const TEMPLATES_FOLDER = `${PRESENTATIONS_FOLDER}/Templates`\n/** Exported PDFs and PowerPoint decks: kept apart, so they are not taken for presentations. */\nexport const EXPORTS_FOLDER = `${PRESENTATIONS_FOLDER}/Exports`\nimport { LEGACY_PRESENTATION_SUFFIX, PRESENTATION_FILE_SUFFIX } from './panel-id'\n\n/** The name of the editable data attached to a presentation's PDF. */\nexport const PRESENTATION_ATTACHMENT = 'arbi-presentation.json'\nconst FORMAT = 'arbi-presentation'\n\nexport interface SavedClip {\n  kind: ClipKind\n  documentId: string\n  version?: number\n  fileName: string\n  page: number\n  rect: Rect\n  aspect: number\n  caption: string\n  start?: number\n  zoomBase?: number\n  /** An image embedded in the presentation (a key of `media`); `documentId` is empty. */\n  media?: string\n  /** Drawn as it is (no frame finish, no label). */\n  plain?: boolean\n}\n\nexport interface SavedSlide {\n  caption: string\n  auto: boolean\n  /** Absent in files saved before layouts: 'clips'. */\n  layout?: SlideLayout\n  /** One point per line (a subtitle on a title or section slide). */\n  points?: string\n  /** `clip` is an index into `clips`. */\n  items: { clip: number; frame: Frame }[]\n  /** Its text boxes and shapes (`boxes`). */\n  boxes?: SavedBox[]\n  background?: SlideBackground\n  /** Speaker notes. */\n  notes?: string\n  /**\n   * What its PowerPoint slide looked like when saved (`slideFingerprint`): a slide whose\n   * fingerprint no longer matches was changed in PowerPoint, and is imported again.\n   */\n  fingerprint?: string\n}\n\nexport interface SavedPresentation {\n  format: typeof FORMAT\n  version: 1\n  title: string\n  captions: boolean\n  /** The annotation column (tag id) whose value leads each clip's label, e.g. its exhibit number. */\n  labelColumn?: string\n  /** Absent in files saved before themes: the default theme. */\n  theme?: Theme\n  clips: SavedClip[]\n  slides: SavedSlide[]\n  /** Images embedded in the presentation (an imported deck's pictures), as data URLs. */\n  media?: Record<string, string>\n  /** The data was changed outside the editor (an agent): the PDF's slides do not show it yet. */\n  slidesStale?: boolean\n}\n\nexport interface PresentationSnapshot {\n  title: string\n  captions: boolean\n  labelColumn?: string | null\n  theme?: Theme\n  clips: readonly Clip[]\n  slides: readonly {\n    caption: string\n    auto: boolean\n    layout?: SlideLayout\n    points?: string\n    items: { clipId: string; frame: Frame }[]\n    boxes?: readonly SlideBox[]\n    background?: SlideBackground\n    notes?: string\n  }[]\n  /** Embedded images by key (data URLs). */\n  media?: Readonly<Record<string, string>>\n  /** Each slide's PowerPoint fingerprint, as just written (`slideFingerprint`). */\n  fingerprints?: readonly string[]\n}\n\n/** The presentation as saved: references only. */\nexport function serializePresentation(snapshot: PresentationSnapshot): SavedPresentation {\n  const index = new Map(snapshot.clips.map((clip, i) => [clip.id, i]))\n  return {\n    format: FORMAT,\n    version: 1,\n    title: snapshot.title,\n    captions: snapshot.captions,\n    ...(snapshot.labelColumn ? { labelColumn: snapshot.labelColumn } : {}),\n    ...(snapshot.theme ? { theme: snapshot.theme } : {}),\n    clips: snapshot.clips.map((clip) => ({\n      kind: clip.kind,\n      documentId: clip.documentId,\n      ...(clip.version !== undefined ? { version: clip.version } : {}),\n      fileName: clip.fileName,\n      page: clip.page,\n      rect: clip.rect,\n      aspect: clip.aspect,\n      caption: clip.caption,\n      ...(clip.start !== undefined ? { start: clip.start } : {}),\n      ...(clip.zoomBase !== undefined ? { zoomBase: clip.zoomBase } : {}),\n      ...(clip.media ? { media: clip.media } : {}),\n      ...(clip.plain ? { plain: true } : {}),\n    })),\n    slides: snapshot.slides.map((slide, i) => ({\n      caption: slide.caption,\n      auto: slide.auto,\n      layout: slide.layout ?? 'clips',\n      ...(slide.points ? { points: slide.points } : {}),\n      items: slide.items\n        .filter((item) => index.has(item.clipId))\n        .map((item) => ({ clip: index.get(item.clipId)!, frame: item.frame })),\n      ...(slide.boxes?.length\n        ? { boxes: slide.boxes.map(({ id: _id, ...box }) => (void _id, box)) }\n        : {}),\n      ...(slide.background ? { background: slide.background } : {}),\n      ...(slide.notes?.trim() ? { notes: slide.notes } : {}),\n      ...(snapshot.fingerprints?.[i] ? { fingerprint: snapshot.fingerprints[i] } : {}),\n    })),\n    ...(usedMedia(snapshot) ? { media: usedMedia(snapshot) } : {}),\n  }\n}\n\n/** The embedded images still used (by a clip or a slide's background), or none. */\nfunction usedMedia(snapshot: PresentationSnapshot): Record<string, string> | undefined {\n  const media = snapshot.media ?? {}\n  const keys = new Set<string>()\n  for (const clip of snapshot.clips) if (clip.media) keys.add(clip.media)\n  for (const slide of snapshot.slides) if (slide.background?.image) keys.add(slide.background.image)\n  const used = Object.fromEntries(\n    [...keys].filter((key) => media[key]).map((key) => [key, media[key]])\n  )\n  return Object.keys(used).length ? used : undefined\n}\n\nconst isNumber = (v: unknown): v is number => typeof v === 'number' && Number.isFinite(v)\nconst isRect = (v: unknown): v is Rect => {\n  const r = v as Rect | null\n  return (\n    !!r && isNumber(r.x) && isNumber(r.y) && isNumber(r.w) && isNumber(r.h) && r.w > 0 && r.h > 0\n  )\n}\nconst isFrame = (v: unknown): v is Frame => {\n  const f = v as Frame | null\n  return !!f && isNumber(f.x) && isNumber(f.y) && isNumber(f.w) && f.w > 0\n}\n\n/** A saved presentation read from a file, checked; throws on anything else. */\nexport function parsePresentation(text: string): SavedPresentation {\n  const data = JSON.parse(text) as Partial<SavedPresentation>\n  if (data?.format !== FORMAT || data.version !== 1) throw new Error('Not a presentation file')\n  const clips = Array.isArray(data.clips) ? data.clips : []\n  const slides = Array.isArray(data.slides) ? data.slides : []\n  const media =\n    data.media && typeof data.media === 'object'\n      ? Object.fromEntries(\n          Object.entries(data.media).filter(\n            ([, url]) => typeof url === 'string' && url.startsWith('data:image/')\n          )\n        )\n      : {}\n  for (const clip of clips) {\n    if (\n      !['pdf', 'image', 'video'].includes(clip.kind) ||\n      typeof clip.documentId !== 'string' ||\n      (clip.media !== undefined && !media[clip.media]) ||\n      !isRect(clip.rect) ||\n      !isNumber(clip.aspect) ||\n      !isNumber(clip.page)\n    ) {\n      throw new Error('The presentation file is damaged')\n    }\n  }\n  for (const slide of slides) {\n    if (!Array.isArray(slide.items)) throw new Error('The presentation file is damaged')\n    for (const item of slide.items) {\n      if (!isNumber(item.clip) || !clips[item.clip] || !isFrame(item.frame)) {\n        throw new Error('The presentation file is damaged')\n      }\n    }\n  }\n  return {\n    format: FORMAT,\n    version: 1,\n    title: typeof data.title === 'string' ? data.title : 'Presentation',\n    captions: data.captions !== false,\n    ...(data.theme !== undefined ? { theme: parseTheme(data.theme) } : {}),\n    ...(typeof data.labelColumn === 'string' && data.labelColumn\n      ? { labelColumn: data.labelColumn }\n      : {}),\n    clips,\n    slides: slides.map((slide) => {\n      const { boxes, background, fingerprint, notes, ...rest } = slide\n      const parsedBoxes = parseBoxes(boxes)\n      const parsedBackground = parseBackground(background, media)\n      return {\n        ...rest,\n        layout: SLIDE_LAYOUTS.includes(slide.layout as SlideLayout) ? slide.layout : 'clips',\n        ...(typeof slide.points === 'string' && slide.points ? { points: slide.points } : {}),\n        ...(parsedBoxes.length ? { boxes: parsedBoxes } : {}),\n        ...(parsedBackground ? { background: parsedBackground } : {}),\n        ...(typeof fingerprint === 'string' ? { fingerprint } : {}),\n        ...(typeof notes === 'string' && notes.trim() ? { notes } : {}),\n      }\n    }),\n    ...(Object.keys(media).length ? { media } : {}),\n    ...(data.slidesStale === true ? { slidesStale: true } : {}),\n  }\n}\n\n/** A title as a file name stem (characters a file name can hold). */\nexport function safeFileStem(title: string): string {\n  return title.replace(/[\\\\/:*?\"<>|]+/g, ' ').trim() || 'Presentation'\n}\n\n/** \"Opening statement\" \u2192 \"Opening statement.pptx\": a presentation is a PowerPoint file. */\nexport function presentationFileName(title: string): string {\n  return `${safeFileStem(title)}.pptx`\n}\n\n/** The title of a saved presentation, from its file name (older names too). */\nexport function presentationTitle(fileName: string): string {\n  for (const suffix of [PRESENTATION_FILE_SUFFIX, LEGACY_PRESENTATION_SUFFIX, '.pptx', '.pdf']) {\n    if (fileName.endsWith(suffix)) return fileName.slice(0, -suffix.length)\n  }\n  return fileName\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,22 @@
+/**
+ * A presentation's editable data inside its PowerPoint file: a custom XML part, the Office way for
+ * an application to keep its own data in a document (PowerPoint keeps it when it saves the file).
+ *
+ *   customXml/itemN.xml            <arbiPresentation xmlns="urn:arbi:presentation:v1">…json…</…>
+ *   customXml/itemPropsN.xml       its properties (schema reference)
+ *   customXml/_rels/itemN.xml.rels
+ *   ppt/_rels/presentation.xml.rels  a customXml relationship from the presentation to it
+ *
+ * The data is the same JSON a saved presentation always had (`persistence`), XML-escaped.
+ */
+/** The custom XML part's root namespace: what marks a PowerPoint file as an ARBI presentation. */
+export declare const PRESENTATION_XML_NS = "urn:arbi:presentation:v1";
+/** A PowerPoint file (any zip) by its first bytes ("PK\x03\x04"). */
+export declare const isZipBytes: (bytes: Uint8Array) => boolean;
+/** The editable data in a PowerPoint file (its JSON), or null when it has none (another deck). */
+export declare function readPptxPresentationData(file: Blob | Uint8Array): Promise<string | null>;
+/**
+ * The PowerPoint file with `json` as its editable data (replacing data it had): the part, its
+ * properties, and the relationships and content type that make it part of the package.
+ */
+export declare function writePptxPresentationData(file: Blob, json: string): Promise<Blob>;

package/dist/presentation/pptx-data.js

@@ -0,0 +1,83 @@
+"use client";
+const PRESENTATION_XML_NS = "urn:arbi:presentation:v1";
+const RELS_NS = "http://schemas.openxmlformats.org/package/2006/relationships";
+const CUSTOM_XML_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml";
+const CUSTOM_XML_PROPS_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXmlProps";
+const CUSTOM_XML_PROPS_TYPE = "application/vnd.openxmlformats-officedocument.customXmlProperties+xml";
+const escapeXml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+const unescapeXml = (text) => text.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&amp;/g, "&");
+const ROOT = /<arbiPresentation\b[^>]*xmlns="urn:arbi:presentation:v1"[^>]*>([\s\S]*?)<\/arbiPresentation>/;
+async function loadZip(file) {
+  const { default: JSZip } = await import("jszip");
+  return JSZip.loadAsync(file instanceof Blob ? await file.arrayBuffer() : file);
+}
+const isZipBytes = (bytes) => bytes[0] === 80 && bytes[1] === 75 && bytes[2] === 3 && bytes[3] === 4;
+async function readPptxPresentationData(file) {
+  const zip = await loadZip(file);
+  for (const name of Object.keys(zip.files)) {
+    if (!/^customXml\/item\d+\.xml$/.test(name)) continue;
+    const match = ROOT.exec(await zip.file(name).async("string"));
+    if (match) return unescapeXml(match[1]);
+  }
+  return null;
+}
+async function writePptxPresentationData(file, json) {
+  const zip = await loadZip(file);
+  let index = 1;
+  for (const name of Object.keys(zip.files)) {
+    const match = /^customXml\/item(\d+)\.xml$/.exec(name);
+    if (!match) continue;
+    if (ROOT.test(await zip.file(name).async("string"))) {
+      index = Number(match[1]);
+      break;
+    }
+    index = Math.max(index, Number(match[1]) + 1);
+  }
+  const item = `customXml/item${index}.xml`;
+  const props = `customXml/itemProps${index}.xml`;
+  zip.file(
+    item,
+    `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<arbiPresentation xmlns="${PRESENTATION_XML_NS}">${escapeXml(json)}</arbiPresentation>`
+  );
+  zip.file(
+    props,
+    `<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<ds:datastoreItem ds:itemID="{8B1C2E5A-7D40-4E9B-A1F3-0C6D2B9E4A71}" xmlns:ds="http://schemas.openxmlformats.org/officeDocument/2006/customXml"><ds:schemaRefs><ds:schemaRef ds:uri="${PRESENTATION_XML_NS}"/></ds:schemaRefs></ds:datastoreItem>`
+  );
+  zip.file(
+    `customXml/_rels/item${index}.xml.rels`,
+    `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="${RELS_NS}"><Relationship Id="rId1" Type="${CUSTOM_XML_PROPS_REL}" Target="itemProps${index}.xml"/></Relationships>`
+  );
+  const typesName = "[Content_Types].xml";
+  let types = await zip.file(typesName).async("string");
+  if (!types.includes(`PartName="/${props}"`)) {
+    types = types.replace(
+      "</Types>",
+      `<Override PartName="/${props}" ContentType="${CUSTOM_XML_PROPS_TYPE}"/></Types>`
+    );
+    zip.file(typesName, types);
+  }
+  const relsName = "ppt/_rels/presentation.xml.rels";
+  let rels = await zip.file(relsName).async("string");
+  if (!rels.includes(`Target="../${item}"`)) {
+    rels = rels.replace(
+      "</Relationships>",
+      `<Relationship Id="rIdArbiPresentation" Type="${CUSTOM_XML_REL}" Target="../${item}"/></Relationships>`
+    );
+    zip.file(relsName, rels);
+  }
+  return zip.generateAsync({
+    type: "blob",
+    mimeType: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    compression: "DEFLATE"
+  });
+}
+export {
+  PRESENTATION_XML_NS,
+  isZipBytes,
+  readPptxPresentationData,
+  writePptxPresentationData
+};
+//# sourceMappingURL=pptx-data.js.map

package/dist/presentation/pptx-data.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presentation/pptx-data.ts"],
+  "sourcesContent": ["/**\n * A presentation's editable data inside its PowerPoint file: a custom XML part, the Office way for\n * an application to keep its own data in a document (PowerPoint keeps it when it saves the file).\n *\n *   customXml/itemN.xml            <arbiPresentation xmlns=\"urn:arbi:presentation:v1\">\u2026json\u2026</\u2026>\n *   customXml/itemPropsN.xml       its properties (schema reference)\n *   customXml/_rels/itemN.xml.rels\n *   ppt/_rels/presentation.xml.rels  a customXml relationship from the presentation to it\n *\n * The data is the same JSON a saved presentation always had (`persistence`), XML-escaped.\n */\n\n/** The custom XML part's root namespace: what marks a PowerPoint file as an ARBI presentation. */\nexport const PRESENTATION_XML_NS = 'urn:arbi:presentation:v1'\n\nconst RELS_NS = 'http://schemas.openxmlformats.org/package/2006/relationships'\nconst CUSTOM_XML_REL =\n  'http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml'\nconst CUSTOM_XML_PROPS_REL =\n  'http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXmlProps'\nconst CUSTOM_XML_PROPS_TYPE =\n  'application/vnd.openxmlformats-officedocument.customXmlProperties+xml'\n\nconst escapeXml = (text: string) =>\n  text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')\n\nconst unescapeXml = (text: string) =>\n  text\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&apos;/g, \"'\")\n    .replace(/&amp;/g, '&')\n\nconst ROOT =\n  /<arbiPresentation\\b[^>]*xmlns=\"urn:arbi:presentation:v1\"[^>]*>([\\s\\S]*?)<\\/arbiPresentation>/\n\nasync function loadZip(file: Blob | Uint8Array) {\n  const { default: JSZip } = await import('jszip')\n  return JSZip.loadAsync(file instanceof Blob ? await file.arrayBuffer() : file)\n}\n\n/** A PowerPoint file (any zip) by its first bytes (\"PK\\x03\\x04\"). */\nexport const isZipBytes = (bytes: Uint8Array): boolean =>\n  bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 0x03 && bytes[3] === 0x04\n\n/** The editable data in a PowerPoint file (its JSON), or null when it has none (another deck). */\nexport async function readPptxPresentationData(file: Blob | Uint8Array): Promise<string | null> {\n  const zip = await loadZip(file)\n  for (const name of Object.keys(zip.files)) {\n    if (!/^customXml\\/item\\d+\\.xml$/.test(name)) continue\n    const match = ROOT.exec(await zip.file(name)!.async('string'))\n    if (match) return unescapeXml(match[1])\n  }\n  return null\n}\n\n/**\n * The PowerPoint file with `json` as its editable data (replacing data it had): the part, its\n * properties, and the relationships and content type that make it part of the package.\n */\nexport async function writePptxPresentationData(file: Blob, json: string): Promise<Blob> {\n  const zip = await loadZip(file)\n  // An earlier copy of the data goes; any other custom XML part stays as it is.\n  let index = 1\n  for (const name of Object.keys(zip.files)) {\n    const match = /^customXml\\/item(\\d+)\\.xml$/.exec(name)\n    if (!match) continue\n    if (ROOT.test(await zip.file(name)!.async('string'))) {\n      index = Number(match[1])\n      break\n    }\n    index = Math.max(index, Number(match[1]) + 1)\n  }\n  const item = `customXml/item${index}.xml`\n  const props = `customXml/itemProps${index}.xml`\n  zip.file(\n    item,\n    `<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n<arbiPresentation xmlns=\"${PRESENTATION_XML_NS}\">${escapeXml(json)}</arbiPresentation>`\n  )\n  zip.file(\n    props,\n    `<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\\n<ds:datastoreItem ds:itemID=\"{8B1C2E5A-7D40-4E9B-A1F3-0C6D2B9E4A71}\" xmlns:ds=\"http://schemas.openxmlformats.org/officeDocument/2006/customXml\"><ds:schemaRefs><ds:schemaRef ds:uri=\"${PRESENTATION_XML_NS}\"/></ds:schemaRefs></ds:datastoreItem>`\n  )\n  zip.file(\n    `customXml/_rels/item${index}.xml.rels`,\n    `<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\\n<Relationships xmlns=\"${RELS_NS}\"><Relationship Id=\"rId1\" Type=\"${CUSTOM_XML_PROPS_REL}\" Target=\"itemProps${index}.xml\"/></Relationships>`\n  )\n\n  const typesName = '[Content_Types].xml'\n  let types = await zip.file(typesName)!.async('string')\n  if (!types.includes(`PartName=\"/${props}\"`)) {\n    types = types.replace(\n      '</Types>',\n      `<Override PartName=\"/${props}\" ContentType=\"${CUSTOM_XML_PROPS_TYPE}\"/></Types>`\n    )\n    zip.file(typesName, types)\n  }\n\n  const relsName = 'ppt/_rels/presentation.xml.rels'\n  let rels = await zip.file(relsName)!.async('string')\n  if (!rels.includes(`Target=\"../${item}\"`)) {\n    rels = rels.replace(\n      '</Relationships>',\n      `<Relationship Id=\"rIdArbiPresentation\" Type=\"${CUSTOM_XML_REL}\" Target=\"../${item}\"/></Relationships>`\n    )\n    zip.file(relsName, rels)\n  }\n\n  return zip.generateAsync({\n    type: 'blob',\n    mimeType: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n    compression: 'DEFLATE',\n  })\n}\n"],
+  "mappings": ";AAaO,MAAM,sBAAsB;AAEnC,MAAM,UAAU;AAChB,MAAM,iBACJ;AACF,MAAM,uBACJ;AACF,MAAM,wBACJ;AAEF,MAAM,YAAY,CAAC,SACjB,KAAK,QAAQ,MAAM,OAAO,EAAE,QAAQ,MAAM,MAAM,EAAE,QAAQ,MAAM,MAAM;AAExE,MAAM,cAAc,CAAC,SACnB,KACG,QAAQ,SAAS,GAAG,EACpB,QAAQ,SAAS,GAAG,EACpB,QAAQ,WAAW,GAAG,EACtB,QAAQ,WAAW,GAAG,EACtB,QAAQ,UAAU,GAAG;AAE1B,MAAM,OACJ;AAEF,eAAe,QAAQ,MAAyB;AAC9C,QAAM,EAAE,SAAS,MAAM,IAAI,MAAM,OAAO,OAAO;AAC/C,SAAO,MAAM,UAAU,gBAAgB,OAAO,MAAM,KAAK,YAAY,IAAI,IAAI;AAC/E;AAGO,MAAM,aAAa,CAAC,UACzB,MAAM,CAAC,MAAM,MAAQ,MAAM,CAAC,MAAM,MAAQ,MAAM,CAAC,MAAM,KAAQ,MAAM,CAAC,MAAM;AAG9E,eAAsB,yBAAyB,MAAiD;AAC9F,QAAM,MAAM,MAAM,QAAQ,IAAI;AAC9B,aAAW,QAAQ,OAAO,KAAK,IAAI,KAAK,GAAG;AACzC,QAAI,CAAC,4BAA4B,KAAK,IAAI,EAAG;AAC7C,UAAM,QAAQ,KAAK,KAAK,MAAM,IAAI,KAAK,IAAI,EAAG,MAAM,QAAQ,CAAC;AAC7D,QAAI,MAAO,QAAO,YAAY,MAAM,CAAC,CAAC;AAAA,EACxC;AACA,SAAO;AACT;AAMA,eAAsB,0BAA0B,MAAY,MAA6B;AACvF,QAAM,MAAM,MAAM,QAAQ,IAAI;AAE9B,MAAI,QAAQ;AACZ,aAAW,QAAQ,OAAO,KAAK,IAAI,KAAK,GAAG;AACzC,UAAM,QAAQ,8BAA8B,KAAK,IAAI;AACrD,QAAI,CAAC,MAAO;AACZ,QAAI,KAAK,KAAK,MAAM,IAAI,KAAK,IAAI,EAAG,MAAM,QAAQ,CAAC,GAAG;AACpD,cAAQ,OAAO,MAAM,CAAC,CAAC;AACvB;AAAA,IACF;AACA,YAAQ,KAAK,IAAI,OAAO,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC;AAAA,EAC9C;AACA,QAAM,OAAO,iBAAiB,KAAK;AACnC,QAAM,QAAQ,sBAAsB,KAAK;AACzC,MAAI;AAAA,IACF;AAAA,IACA;AAAA,2BAAqF,mBAAmB,KAAK,UAAU,IAAI,CAAC;AAAA,EAC9H;AACA,MAAI;AAAA,IACF;AAAA,IACA;AAAA,uLAAgP,mBAAmB;AAAA,EACrQ;AACA,MAAI;AAAA,IACF,uBAAuB,KAAK;AAAA,IAC5B;AAAA,wBAAkF,OAAO,mCAAmC,oBAAoB,sBAAsB,KAAK;AAAA,EAC7K;AAEA,QAAM,YAAY;AAClB,MAAI,QAAQ,MAAM,IAAI,KAAK,SAAS,EAAG,MAAM,QAAQ;AACrD,MAAI,CAAC,MAAM,SAAS,cAAc,KAAK,GAAG,GAAG;AAC3C,YAAQ,MAAM;AAAA,MACZ;AAAA,MACA,wBAAwB,KAAK,kBAAkB,qBAAqB;AAAA,IACtE;AACA,QAAI,KAAK,WAAW,KAAK;AAAA,EAC3B;AAEA,QAAM,WAAW;AACjB,MAAI,OAAO,MAAM,IAAI,KAAK,QAAQ,EAAG,MAAM,QAAQ;AACnD,MAAI,CAAC,KAAK,SAAS,cAAc,IAAI,GAAG,GAAG;AACzC,WAAO,KAAK;AAAA,MACV;AAAA,MACA,gDAAgD,cAAc,gBAAgB,IAAI;AAAA,IACpF;AACA,QAAI,KAAK,UAAU,IAAI;AAAA,EACzB;AAEA,SAAO,IAAI,cAAc;AAAA,IACvB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,aAAa;AAAA,EACf,CAAC;AACH;",
+  "names": []
+}

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

@@ -0,0 +1,90 @@
+/**
+ * Reading a PowerPoint package's XML: its parts and relationships, and DrawingML's colours, fills,
+ * outlines and theme (colour scheme, fonts) as PowerPoint resolves them. What `import-pptx` builds
+ * slides from.
+ */
+import type JSZip from 'jszip';
+export declare const NS: {
+    a: string;
+    p: string;
+    r: string;
+};
+/** EMUs per point. */
+export declare const EMU_PER_POINT = 12700;
+/** The element's child elements named `name` (by local name, any namespace). */
+export declare function kids(element: Element | null | undefined, name?: string): Element[];
+/** The first child element named `name`. */
+export declare function kid(element: Element | null | undefined, name: string): Element | null;
+/** The element at a path of child names (`path(sp, 'spPr', 'xfrm')`). */
+export declare function path(element: Element | null | undefined, ...names: string[]): Element | null;
+/** A numeric attribute, or `fallback`. */
+export declare function numAttr(element: Element | null | undefined, name: string, fallback?: number): number;
+/** A relationship id attribute (`r:embed`, `r:id`…). */
+export declare const relAttr: (element: Element | null | undefined, name: string) => string | null;
+/** A truthy OOXML boolean attribute ("1", "true"). */
+export declare const boolAttr: (element: Element | null | undefined, name: string) => boolean | undefined;
+/** A package: its parts parsed on demand and its relationships resolved. */
+export declare class Package {
+    readonly zip: JSZip;
+    private parsed;
+    private rels;
+    constructor(zip: JSZip);
+    xml(part: string): Promise<Document | null>;
+    bytes(part: string): Promise<Uint8Array | null>;
+    /** A part's relationships by id, their targets resolved to part names. */
+    relationships(part: string): Promise<Map<string, {
+        target: string;
+        type: string;
+        external: boolean;
+    }>>;
+    /** The first relationship of `part` whose type ends with `type` ("/slideLayout"). */
+    related(part: string, type: string): Promise<string | null>;
+}
+/** A relationship target resolved against the part's folder ("../media/a.png" → "ppt/media/a.png"). */
+export declare function resolvePart(dir: string, target: string): string;
+export interface Color {
+    hex: string;
+    alpha: number;
+}
+export interface DeckTheme {
+    /** Scheme colours by name (dk1, lt1, accent1…), and the master's mapping (bg1 → lt1…). */
+    scheme: Record<string, string>;
+    map: Record<string, string>;
+    majorFont: string;
+    minorFont: string;
+    /** The theme's line widths (lnStyleLst), in points, by style index (1-based). */
+    lineWidths: number[];
+}
+/** The colour a DrawingML colour element names (srgbClr, schemeClr…), its modifiers applied. */
+export declare function readColor(element: Element | null, theme: DeckTheme, placeholder?: Color): Color | null;
+/** The colour inside an element that holds one (solidFill, a style ref…). */
+export declare function colorIn(element: Element | null, theme: DeckTheme, placeholder?: Color): Color | null;
+export type Fill = {
+    kind: 'none';
+} | {
+    kind: 'solid';
+    color: Color;
+} | {
+    kind: 'gradient';
+    from: Color;
+    to: Color;
+    angle: number;
+} | {
+    kind: 'image';
+    embed: string;
+    srcRect: Element | null;
+};
+/** The fill an element holding fill properties (spPr, bgPr, tcPr) sets, if any. */
+export declare function readFill(element: Element | null, theme: DeckTheme, placeholder?: Color): Fill | null;
+/** An outline (a:ln), if it draws: its colour, width (points) and dash. */
+export declare function readLine(ln: Element | null, theme: DeckTheme, placeholder?: Color): {
+    color: Color;
+    width: number;
+    dash: boolean;
+} | null | undefined;
+/** A deck's theme, from the theme part its master uses, with the master's colour map. */
+export declare function readTheme(pkg: Package, master: string): Promise<DeckTheme>;
+/** A typeface as named in a run, the theme's fonts resolved. */
+export declare function typefaceOf(name: string | null | undefined, theme: DeckTheme): string | undefined;
+/** A media part as a data URL (null for formats a browser cannot show: EMF, WMF, TIFF). */
+export declare function mediaDataUrl(pkg: Package, part: string): Promise<string | null>;