pptx-glimpse 0.2.2 → 0.3.0

package/README.md

@@ -2,9 +2,11 @@
 
 [![npm](https://img.shields.io/npm/v/pptx-glimpse)](https://www.npmjs.com/package/pptx-glimpse)
 
-A Node.js library to render PPTX as SVG / PNG.
+A lightweight JavaScript library for rendering PowerPoint (.pptx) files as SVG or PNG in Node.js. No LibreOffice required.
 
-[Demo](https://pptx-glimpse.vercel.app/) | [npm](https://www.npmjs.com/package/pptx-glimpse)
+**[Try the Demo](https://pptx-glimpse.vercel.app/)** | [npm](https://www.npmjs.com/package/pptx-glimpse)
+
+![pptx-glimpse demo](https://raw.githubusercontent.com/hirokisakabe/pptx-glimpse/main/docs/demo.gif)
 
 ## Motivation
 

package/dist/index.cjs

@@ -35,6 +35,8 @@ __export(index_exports, {
   convertPptxToPng: () => convertPptxToPng,
   convertPptxToSvg: () => convertPptxToSvg,
   createFontMapping: () => createFontMapping,
+  createOpentypeSetupFromBuffers: () => createOpentypeSetupFromBuffers,
+  createOpentypeTextMeasurerFromBuffers: () => createOpentypeTextMeasurerFromBuffers,
   getMappedFont: () => getMappedFont,
   getWarningEntries: () => getWarningEntries,
   getWarningSummary: () => getWarningSummary
@@ -8110,6 +8112,108 @@ function collectFontFilePaths(additionalDirs) {
   return result;
 }
 
+// src/font/ttc-parser.ts
+var TTC_TAG = 1953784678;
+function isTtcBuffer(data) {
+  const view = toDataView(data);
+  if (view.byteLength < 4) return false;
+  return view.getUint32(0) === TTC_TAG;
+}
+function extractTtcFonts(data) {
+  const view = toDataView(data);
+  const bytes = toUint8Array(data);
+  if (view.byteLength < 12) return [];
+  if (view.getUint32(0) !== TTC_TAG) return [];
+  const numFonts = view.getUint32(8);
+  if (numFonts === 0) return [];
+  const headerEnd = 12 + numFonts * 4;
+  if (view.byteLength < headerEnd) return [];
+  const results = [];
+  for (let i = 0; i < numFonts; i++) {
+    try {
+      const fontOffset = view.getUint32(12 + i * 4);
+      const extracted = extractSingleFont(view, bytes, fontOffset);
+      if (extracted) results.push(extracted);
+    } catch {
+    }
+  }
+  return results;
+}
+function extractSingleFont(view, bytes, fontOffset) {
+  if (fontOffset + 12 > view.byteLength) return null;
+  const sfVersion = view.getUint32(fontOffset);
+  const numTables = view.getUint16(fontOffset + 4);
+  if (numTables === 0) return null;
+  const tableRecordsStart = fontOffset + 12;
+  const tableRecordsEnd = tableRecordsStart + numTables * 16;
+  if (tableRecordsEnd > view.byteLength) return null;
+  const tables = [];
+  for (let i = 0; i < numTables; i++) {
+    const recOffset = tableRecordsStart + i * 16;
+    const tableOffset = view.getUint32(recOffset + 8);
+    const tableLength = view.getUint32(recOffset + 12);
+    if (tableOffset > view.byteLength || tableLength > view.byteLength - tableOffset) {
+      return null;
+    }
+    tables.push({
+      tag: view.getUint32(recOffset),
+      checkSum: view.getUint32(recOffset + 4),
+      offset: tableOffset,
+      length: tableLength
+    });
+  }
+  const headerSize = 12 + numTables * 16;
+  let dataSize = 0;
+  for (const table of tables) {
+    dataSize += alignTo4(table.length);
+  }
+  const totalSize = headerSize + dataSize;
+  const output = new ArrayBuffer(totalSize);
+  const outView = new DataView(output);
+  const outBytes = new Uint8Array(output);
+  outView.setUint32(0, sfVersion);
+  outView.setUint16(4, numTables);
+  const { searchRange, entrySelector, rangeShift } = calcOffsetTableFields(numTables);
+  outView.setUint16(6, searchRange);
+  outView.setUint16(8, entrySelector);
+  outView.setUint16(10, rangeShift);
+  let currentDataOffset = headerSize;
+  for (let i = 0; i < numTables; i++) {
+    const table = tables[i];
+    const recOffset = 12 + i * 16;
+    outView.setUint32(recOffset, table.tag);
+    outView.setUint32(recOffset + 4, table.checkSum);
+    outView.setUint32(recOffset + 8, currentDataOffset);
+    outView.setUint32(recOffset + 12, table.length);
+    outBytes.set(bytes.subarray(table.offset, table.offset + table.length), currentDataOffset);
+    currentDataOffset += alignTo4(table.length);
+  }
+  return output;
+}
+function alignTo4(n) {
+  return n + 3 & ~3;
+}
+function calcOffsetTableFields(numTables) {
+  let searchRange = 16;
+  let entrySelector = 0;
+  while (searchRange * 2 <= numTables * 16) {
+    searchRange *= 2;
+    entrySelector++;
+  }
+  const rangeShift = numTables * 16 - searchRange;
+  return { searchRange, entrySelector, rangeShift };
+}
+function toDataView(data) {
+  if (data instanceof Uint8Array) {
+    return new DataView(data.buffer, data.byteOffset, data.byteLength);
+  }
+  return new DataView(data);
+}
+function toUint8Array(data) {
+  if (data instanceof Uint8Array) return data;
+  return new Uint8Array(data);
+}
+
 // src/font/opentype-helpers.ts
 async function tryLoadOpentype() {
   try {
@@ -8136,6 +8240,63 @@ function toArrayBuffer(data) {
   if (data instanceof ArrayBuffer) return data;
   return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
 }
+function parseFontBuffer(arrayBuffer, opentype) {
+  if (isTtcBuffer(arrayBuffer)) {
+    const results = [];
+    for (const buf of extractTtcFonts(arrayBuffer)) {
+      try {
+        results.push(opentype.parse(buf));
+      } catch {
+      }
+    }
+    return results;
+  }
+  return [opentype.parse(arrayBuffer)];
+}
+async function createOpentypeTextMeasurerFromBuffers(fontBuffers, fontMapping) {
+  const setup = await createOpentypeSetupFromBuffers(fontBuffers, fontMapping);
+  return setup?.measurer ?? null;
+}
+async function createOpentypeSetupFromBuffers(fontBuffers, fontMapping) {
+  if (fontBuffers.length === 0) return null;
+  const opentype = await tryLoadOpentype();
+  if (!opentype) return null;
+  const mapping = createFontMapping(fontMapping);
+  const reverseMap = buildReverseMapping(mapping);
+  const measurerFonts = /* @__PURE__ */ new Map();
+  const resolverFonts = /* @__PURE__ */ new Map();
+  let firstMeasurerFont = null;
+  let firstResolverFont = null;
+  for (const buffer of fontBuffers) {
+    try {
+      const arrayBuffer = toArrayBuffer(buffer.data);
+      const isTtc = isTtcBuffer(arrayBuffer);
+      const fonts = parseFontBuffer(arrayBuffer, opentype);
+      for (const font of fonts) {
+        if (!firstMeasurerFont) firstMeasurerFont = font;
+        if (!firstResolverFont) firstResolverFont = font;
+        if (isTtc) {
+          const fontFamily = font.names.fontFamily;
+          if (fontFamily) {
+            for (const name of Object.values(fontFamily)) {
+              registerFont(name, font, reverseMap, measurerFonts, resolverFonts);
+            }
+          }
+        } else if (buffer.name) {
+          registerFont(buffer.name, font, reverseMap, measurerFonts, resolverFonts);
+        }
+      }
+    } catch {
+    }
+  }
+  if (measurerFonts.size === 0 && !firstMeasurerFont) return null;
+  const measurer = new OpentypeTextMeasurer(measurerFonts, firstMeasurerFont ?? void 0);
+  const fontResolver = new DefaultTextPathFontResolver(
+    resolverFonts,
+    firstResolverFont ?? void 0
+  );
+  return { measurer, fontResolver };
+}
 function registerFont(name, font, reverseMap, measurerFonts, resolverFonts) {
   const fullFont = font;
   if (!measurerFonts.has(name)) {
@@ -8167,13 +8328,15 @@ async function createOpentypeSetupFromSystem(additionalFontDirs, fontMapping) {
     try {
       const data = await (0, import_promises.readFile)(filePath);
       const arrayBuffer = toArrayBuffer(data);
-      const font = opentype.parse(arrayBuffer);
-      if (!firstMeasurerFont) firstMeasurerFont = font;
-      if (!firstResolverFont) firstResolverFont = font;
-      const fontFamily = font.names.fontFamily;
-      if (fontFamily) {
-        for (const name of Object.values(fontFamily)) {
-          registerFont(name, font, reverseMap, measurerFonts, resolverFonts);
+      const fonts = parseFontBuffer(arrayBuffer, opentype);
+      for (const font of fonts) {
+        if (!firstMeasurerFont) firstMeasurerFont = font;
+        if (!firstResolverFont) firstResolverFont = font;
+        const fontFamily = font.names.fontFamily;
+        if (fontFamily) {
+          for (const name of Object.values(fontFamily)) {
+            registerFont(name, font, reverseMap, measurerFonts, resolverFonts);
+          }
         }
       }
     } catch {
@@ -8319,6 +8482,8 @@ function collectFontsFromTextBody(textBody, fonts) {
   convertPptxToPng,
   convertPptxToSvg,
   createFontMapping,
+  createOpentypeSetupFromBuffers,
+  createOpentypeTextMeasurerFromBuffers,
   getMappedFont,
   getWarningEntries,
   getWarningSummary

package/dist/index.d.cts

@@ -84,4 +84,101 @@ interface UsedFonts {
  */
 declare function collectUsedFonts(input: Buffer | Uint8Array): UsedFonts;
 
-export { type ConvertOptions, DEFAULT_FONT_MAPPING, type FontMapping, type LogLevel, type SlideImage, type SlideSvg, type UsedFonts, type WarningEntry, type WarningSummary, collectUsedFonts, convertPptxToPng, convertPptxToSvg, createFontMapping, getMappedFont, getWarningEntries, getWarningSummary };
+/**
+ * テキストの幅と行高さを計測するインターフェース。
+ * デフォルトでは静的フォントメトリクスによる計測が使われる。
+ * ユーザーが独自の実装を ConvertOptions.textMeasurer に渡すことで、
+ * Canvas API や opentype.js など任意の計測バックエンドに差し替えられる。
+ */
+interface TextMeasurer {
+    /**
+     * テキストの推定幅をピクセル単位で返す。
+     * @param text - 計測対象のテキスト
+     * @param fontSizePt - フォントサイズ (ポイント)
+     * @param bold - 太字かどうか
+     * @param fontFamily - ラテン文字用フォントファミリー名
+     * @param fontFamilyEa - 東アジア文字用フォントファミリー名
+     */
+    measureTextWidth(text: string, fontSizePt: number, bold: boolean, fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    /**
+     * フォントの自然な行高さ比率 (行高さ / フォントサイズ) を返す。
+     * メトリクスが不明な場合は 1.2 をフォールバック値として返す。
+     * @param fontFamily - ラテン文字用フォントファミリー名
+     * @param fontFamilyEa - 東アジア文字用フォントファミリー名
+     */
+    getLineHeightRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    /**
+     * フォントの ascender 比率 (ascender / unitsPerEm) を返す。
+     * 1行目のベースラインオフセット計算に使用する。
+     * メトリクスが不明な場合は 1.0 をフォールバック値として返す。
+     * @param fontFamily - ラテン文字用フォントファミリー名
+     * @param fontFamilyEa - 東アジア文字用フォントファミリー名
+     */
+    getAscenderRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+}
+
+interface OpentypeGlyph {
+    advanceWidth?: number;
+}
+interface OpentypeFont {
+    unitsPerEm: number;
+    ascender: number;
+    descender: number;
+    stringToGlyphs(text: string): OpentypeGlyph[];
+}
+declare class OpentypeTextMeasurer implements TextMeasurer {
+    private fonts;
+    private defaultFont;
+    /**
+     * @param fonts - フォント名 → opentype.js Font オブジェクトのマップ
+     * @param defaultFont - フォールバックフォント（省略可）
+     */
+    constructor(fonts: Map<string, OpentypeFont>, defaultFont?: OpentypeFont);
+    measureTextWidth(text: string, fontSizePt: number, bold: boolean, fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    getLineHeightRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    getAscenderRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    private resolveFont;
+}
+
+/**
+ * テキスト→パス変換用のフォントリゾルバーコンテキスト。
+ * opentype.js の getPath() メソッドを持つ Font オブジェクトへのアクセスを提供する。
+ */
+interface OpentypePath {
+    toPathData(decimalPlaces?: number): string;
+}
+interface OpentypeFullFont {
+    unitsPerEm: number;
+    ascender: number;
+    descender: number;
+    getPath(text: string, x: number, y: number, fontSize: number): OpentypePath;
+}
+interface TextPathFontResolver {
+    resolveFont(fontFamily: string | null | undefined, fontFamilyEa: string | null | undefined): OpentypeFullFont | null;
+}
+
+/** フォントバッファの入力形式 */
+interface FontBuffer {
+    name?: string;
+    data: ArrayBuffer | Uint8Array;
+}
+/**
+ * フォントバッファ配列から OpentypeTextMeasurer を構築する。
+ *
+ * 内部で opentype.js を動的 import してフォントをパースする。
+ * opentype.js が利用不可な場合は null を返す。
+ */
+declare function createOpentypeTextMeasurerFromBuffers(fontBuffers: FontBuffer[], fontMapping?: FontMapping): Promise<OpentypeTextMeasurer | null>;
+interface OpentypeSetup {
+    measurer: OpentypeTextMeasurer;
+    fontResolver: TextPathFontResolver;
+}
+/**
+ * フォントバッファ配列から OpentypeTextMeasurer と TextPathFontResolver を同時に構築する。
+ *
+ * opentype.parse() が返すオブジェクトは OpentypeFont と OpentypeFullFont の両方を満たすため、
+ * 同じ Font オブジェクトを measurer と fontResolver の両方に渡す。
+ */
+declare function createOpentypeSetupFromBuffers(fontBuffers: FontBuffer[], fontMapping?: FontMapping): Promise<OpentypeSetup | null>;
+
+export { type ConvertOptions, DEFAULT_FONT_MAPPING, type FontBuffer, type FontMapping, type LogLevel, type OpentypeSetup, type SlideImage, type SlideSvg, type UsedFonts, type WarningEntry, type WarningSummary, collectUsedFonts, convertPptxToPng, convertPptxToSvg, createFontMapping, createOpentypeSetupFromBuffers, createOpentypeTextMeasurerFromBuffers, getMappedFont, getWarningEntries, getWarningSummary };

package/dist/index.d.ts

@@ -84,4 +84,101 @@ interface UsedFonts {
  */
 declare function collectUsedFonts(input: Buffer | Uint8Array): UsedFonts;
 
-export { type ConvertOptions, DEFAULT_FONT_MAPPING, type FontMapping, type LogLevel, type SlideImage, type SlideSvg, type UsedFonts, type WarningEntry, type WarningSummary, collectUsedFonts, convertPptxToPng, convertPptxToSvg, createFontMapping, getMappedFont, getWarningEntries, getWarningSummary };
+/**
+ * テキストの幅と行高さを計測するインターフェース。
+ * デフォルトでは静的フォントメトリクスによる計測が使われる。
+ * ユーザーが独自の実装を ConvertOptions.textMeasurer に渡すことで、
+ * Canvas API や opentype.js など任意の計測バックエンドに差し替えられる。
+ */
+interface TextMeasurer {
+    /**
+     * テキストの推定幅をピクセル単位で返す。
+     * @param text - 計測対象のテキスト
+     * @param fontSizePt - フォントサイズ (ポイント)
+     * @param bold - 太字かどうか
+     * @param fontFamily - ラテン文字用フォントファミリー名
+     * @param fontFamilyEa - 東アジア文字用フォントファミリー名
+     */
+    measureTextWidth(text: string, fontSizePt: number, bold: boolean, fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    /**
+     * フォントの自然な行高さ比率 (行高さ / フォントサイズ) を返す。
+     * メトリクスが不明な場合は 1.2 をフォールバック値として返す。
+     * @param fontFamily - ラテン文字用フォントファミリー名
+     * @param fontFamilyEa - 東アジア文字用フォントファミリー名
+     */
+    getLineHeightRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    /**
+     * フォントの ascender 比率 (ascender / unitsPerEm) を返す。
+     * 1行目のベースラインオフセット計算に使用する。
+     * メトリクスが不明な場合は 1.0 をフォールバック値として返す。
+     * @param fontFamily - ラテン文字用フォントファミリー名
+     * @param fontFamilyEa - 東アジア文字用フォントファミリー名
+     */
+    getAscenderRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+}
+
+interface OpentypeGlyph {
+    advanceWidth?: number;
+}
+interface OpentypeFont {
+    unitsPerEm: number;
+    ascender: number;
+    descender: number;
+    stringToGlyphs(text: string): OpentypeGlyph[];
+}
+declare class OpentypeTextMeasurer implements TextMeasurer {
+    private fonts;
+    private defaultFont;
+    /**
+     * @param fonts - フォント名 → opentype.js Font オブジェクトのマップ
+     * @param defaultFont - フォールバックフォント（省略可）
+     */
+    constructor(fonts: Map<string, OpentypeFont>, defaultFont?: OpentypeFont);
+    measureTextWidth(text: string, fontSizePt: number, bold: boolean, fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    getLineHeightRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    getAscenderRatio(fontFamily?: string | null, fontFamilyEa?: string | null): number;
+    private resolveFont;
+}
+
+/**
+ * テキスト→パス変換用のフォントリゾルバーコンテキスト。
+ * opentype.js の getPath() メソッドを持つ Font オブジェクトへのアクセスを提供する。
+ */
+interface OpentypePath {
+    toPathData(decimalPlaces?: number): string;
+}
+interface OpentypeFullFont {
+    unitsPerEm: number;
+    ascender: number;
+    descender: number;
+    getPath(text: string, x: number, y: number, fontSize: number): OpentypePath;
+}
+interface TextPathFontResolver {
+    resolveFont(fontFamily: string | null | undefined, fontFamilyEa: string | null | undefined): OpentypeFullFont | null;
+}
+
+/** フォントバッファの入力形式 */
+interface FontBuffer {
+    name?: string;
+    data: ArrayBuffer | Uint8Array;
+}
+/**
+ * フォントバッファ配列から OpentypeTextMeasurer を構築する。
+ *
+ * 内部で opentype.js を動的 import してフォントをパースする。
+ * opentype.js が利用不可な場合は null を返す。
+ */
+declare function createOpentypeTextMeasurerFromBuffers(fontBuffers: FontBuffer[], fontMapping?: FontMapping): Promise<OpentypeTextMeasurer | null>;
+interface OpentypeSetup {
+    measurer: OpentypeTextMeasurer;
+    fontResolver: TextPathFontResolver;
+}
+/**
+ * フォントバッファ配列から OpentypeTextMeasurer と TextPathFontResolver を同時に構築する。
+ *
+ * opentype.parse() が返すオブジェクトは OpentypeFont と OpentypeFullFont の両方を満たすため、
+ * 同じ Font オブジェクトを measurer と fontResolver の両方に渡す。
+ */
+declare function createOpentypeSetupFromBuffers(fontBuffers: FontBuffer[], fontMapping?: FontMapping): Promise<OpentypeSetup | null>;
+
+export { type ConvertOptions, DEFAULT_FONT_MAPPING, type FontBuffer, type FontMapping, type LogLevel, type OpentypeSetup, type SlideImage, type SlideSvg, type UsedFonts, type WarningEntry, type WarningSummary, collectUsedFonts, convertPptxToPng, convertPptxToSvg, createFontMapping, createOpentypeSetupFromBuffers, createOpentypeTextMeasurerFromBuffers, getMappedFont, getWarningEntries, getWarningSummary };

package/dist/index.js

@@ -8067,6 +8067,108 @@ function collectFontFilePaths(additionalDirs) {
   return result;
 }
 
+// src/font/ttc-parser.ts
+var TTC_TAG = 1953784678;
+function isTtcBuffer(data) {
+  const view = toDataView(data);
+  if (view.byteLength < 4) return false;
+  return view.getUint32(0) === TTC_TAG;
+}
+function extractTtcFonts(data) {
+  const view = toDataView(data);
+  const bytes = toUint8Array(data);
+  if (view.byteLength < 12) return [];
+  if (view.getUint32(0) !== TTC_TAG) return [];
+  const numFonts = view.getUint32(8);
+  if (numFonts === 0) return [];
+  const headerEnd = 12 + numFonts * 4;
+  if (view.byteLength < headerEnd) return [];
+  const results = [];
+  for (let i = 0; i < numFonts; i++) {
+    try {
+      const fontOffset = view.getUint32(12 + i * 4);
+      const extracted = extractSingleFont(view, bytes, fontOffset);
+      if (extracted) results.push(extracted);
+    } catch {
+    }
+  }
+  return results;
+}
+function extractSingleFont(view, bytes, fontOffset) {
+  if (fontOffset + 12 > view.byteLength) return null;
+  const sfVersion = view.getUint32(fontOffset);
+  const numTables = view.getUint16(fontOffset + 4);
+  if (numTables === 0) return null;
+  const tableRecordsStart = fontOffset + 12;
+  const tableRecordsEnd = tableRecordsStart + numTables * 16;
+  if (tableRecordsEnd > view.byteLength) return null;
+  const tables = [];
+  for (let i = 0; i < numTables; i++) {
+    const recOffset = tableRecordsStart + i * 16;
+    const tableOffset = view.getUint32(recOffset + 8);
+    const tableLength = view.getUint32(recOffset + 12);
+    if (tableOffset > view.byteLength || tableLength > view.byteLength - tableOffset) {
+      return null;
+    }
+    tables.push({
+      tag: view.getUint32(recOffset),
+      checkSum: view.getUint32(recOffset + 4),
+      offset: tableOffset,
+      length: tableLength
+    });
+  }
+  const headerSize = 12 + numTables * 16;
+  let dataSize = 0;
+  for (const table of tables) {
+    dataSize += alignTo4(table.length);
+  }
+  const totalSize = headerSize + dataSize;
+  const output = new ArrayBuffer(totalSize);
+  const outView = new DataView(output);
+  const outBytes = new Uint8Array(output);
+  outView.setUint32(0, sfVersion);
+  outView.setUint16(4, numTables);
+  const { searchRange, entrySelector, rangeShift } = calcOffsetTableFields(numTables);
+  outView.setUint16(6, searchRange);
+  outView.setUint16(8, entrySelector);
+  outView.setUint16(10, rangeShift);
+  let currentDataOffset = headerSize;
+  for (let i = 0; i < numTables; i++) {
+    const table = tables[i];
+    const recOffset = 12 + i * 16;
+    outView.setUint32(recOffset, table.tag);
+    outView.setUint32(recOffset + 4, table.checkSum);
+    outView.setUint32(recOffset + 8, currentDataOffset);
+    outView.setUint32(recOffset + 12, table.length);
+    outBytes.set(bytes.subarray(table.offset, table.offset + table.length), currentDataOffset);
+    currentDataOffset += alignTo4(table.length);
+  }
+  return output;
+}
+function alignTo4(n) {
+  return n + 3 & ~3;
+}
+function calcOffsetTableFields(numTables) {
+  let searchRange = 16;
+  let entrySelector = 0;
+  while (searchRange * 2 <= numTables * 16) {
+    searchRange *= 2;
+    entrySelector++;
+  }
+  const rangeShift = numTables * 16 - searchRange;
+  return { searchRange, entrySelector, rangeShift };
+}
+function toDataView(data) {
+  if (data instanceof Uint8Array) {
+    return new DataView(data.buffer, data.byteOffset, data.byteLength);
+  }
+  return new DataView(data);
+}
+function toUint8Array(data) {
+  if (data instanceof Uint8Array) return data;
+  return new Uint8Array(data);
+}
+
 // src/font/opentype-helpers.ts
 async function tryLoadOpentype() {
   try {
@@ -8093,6 +8195,63 @@ function toArrayBuffer(data) {
   if (data instanceof ArrayBuffer) return data;
   return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
 }
+function parseFontBuffer(arrayBuffer, opentype) {
+  if (isTtcBuffer(arrayBuffer)) {
+    const results = [];
+    for (const buf of extractTtcFonts(arrayBuffer)) {
+      try {
+        results.push(opentype.parse(buf));
+      } catch {
+      }
+    }
+    return results;
+  }
+  return [opentype.parse(arrayBuffer)];
+}
+async function createOpentypeTextMeasurerFromBuffers(fontBuffers, fontMapping) {
+  const setup = await createOpentypeSetupFromBuffers(fontBuffers, fontMapping);
+  return setup?.measurer ?? null;
+}
+async function createOpentypeSetupFromBuffers(fontBuffers, fontMapping) {
+  if (fontBuffers.length === 0) return null;
+  const opentype = await tryLoadOpentype();
+  if (!opentype) return null;
+  const mapping = createFontMapping(fontMapping);
+  const reverseMap = buildReverseMapping(mapping);
+  const measurerFonts = /* @__PURE__ */ new Map();
+  const resolverFonts = /* @__PURE__ */ new Map();
+  let firstMeasurerFont = null;
+  let firstResolverFont = null;
+  for (const buffer of fontBuffers) {
+    try {
+      const arrayBuffer = toArrayBuffer(buffer.data);
+      const isTtc = isTtcBuffer(arrayBuffer);
+      const fonts = parseFontBuffer(arrayBuffer, opentype);
+      for (const font of fonts) {
+        if (!firstMeasurerFont) firstMeasurerFont = font;
+        if (!firstResolverFont) firstResolverFont = font;
+        if (isTtc) {
+          const fontFamily = font.names.fontFamily;
+          if (fontFamily) {
+            for (const name of Object.values(fontFamily)) {
+              registerFont(name, font, reverseMap, measurerFonts, resolverFonts);
+            }
+          }
+        } else if (buffer.name) {
+          registerFont(buffer.name, font, reverseMap, measurerFonts, resolverFonts);
+        }
+      }
+    } catch {
+    }
+  }
+  if (measurerFonts.size === 0 && !firstMeasurerFont) return null;
+  const measurer = new OpentypeTextMeasurer(measurerFonts, firstMeasurerFont ?? void 0);
+  const fontResolver = new DefaultTextPathFontResolver(
+    resolverFonts,
+    firstResolverFont ?? void 0
+  );
+  return { measurer, fontResolver };
+}
 function registerFont(name, font, reverseMap, measurerFonts, resolverFonts) {
   const fullFont = font;
   if (!measurerFonts.has(name)) {
@@ -8124,13 +8283,15 @@ async function createOpentypeSetupFromSystem(additionalFontDirs, fontMapping) {
     try {
       const data = await readFile(filePath);
       const arrayBuffer = toArrayBuffer(data);
-      const font = opentype.parse(arrayBuffer);
-      if (!firstMeasurerFont) firstMeasurerFont = font;
-      if (!firstResolverFont) firstResolverFont = font;
-      const fontFamily = font.names.fontFamily;
-      if (fontFamily) {
-        for (const name of Object.values(fontFamily)) {
-          registerFont(name, font, reverseMap, measurerFonts, resolverFonts);
+      const fonts = parseFontBuffer(arrayBuffer, opentype);
+      for (const font of fonts) {
+        if (!firstMeasurerFont) firstMeasurerFont = font;
+        if (!firstResolverFont) firstResolverFont = font;
+        const fontFamily = font.names.fontFamily;
+        if (fontFamily) {
+          for (const name of Object.values(fontFamily)) {
+            registerFont(name, font, reverseMap, measurerFonts, resolverFonts);
+          }
         }
       }
     } catch {
@@ -8275,6 +8436,8 @@ export {
   convertPptxToPng,
   convertPptxToSvg,
   createFontMapping,
+  createOpentypeSetupFromBuffers,
+  createOpentypeTextMeasurerFromBuffers,
   getMappedFont,
   getWarningEntries,
   getWarningSummary

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pptx-glimpse",
-  "version": "0.2.2",
-  "description": "A Node.js library to render PPTX as SVG / PNG.",
+  "version": "0.3.0",
+  "description": "A lightweight JavaScript library for rendering PowerPoint (.pptx) files as SVG or PNG in Node.js. No LibreOffice required.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -24,6 +24,7 @@
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
+    "knip": "knip",
     "dev": "tsx scripts/dev-server.ts",
     "render": "tsx scripts/test-render.ts",
     "inspect": "tsx scripts/inspect-pptx.ts",
@@ -75,6 +76,7 @@
     "eslint": "^9.0.0",
     "eslint-config-prettier": "^10.0.0",
     "jszip": "^3.10.1",
+    "knip": "^5.85.0",
     "pixelmatch": "^7.1.0",
     "prettier": "^3.0.0",
     "tsup": "^8.0.0",