pptx-glimpse 1.1.1 → 1.1.2

package/dist/index.d.cts

@@ -1,3 +1,21 @@
+/**
+ * テキスト→パス変換用のフォントリゾルバーコンテキスト。
+ * 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;
+    getAdvanceWidth(text: string, fontSize: number): number;
+}
+interface TextPathFontResolver {
+    resolveFont(fontFamily: string | null | undefined, fontFamilyEa: string | null | undefined, jpanFallback?: string | null): OpentypeFullFont | null;
+}
+
 /**
  * PPTX フォント名 → OSS 代替フォント (Google Fonts) のマッピング。
  * ユーザーが拡張・上書き可能。
@@ -13,84 +31,6 @@ declare const DEFAULT_FONT_MAPPING: Readonly<FontMapping>;
 declare function createFontMapping(userMapping?: FontMapping): FontMapping;
 declare function getMappedFont(fontFamily: string | null | undefined, mapping: FontMapping): string | null;
 
-type LogLevel = "off" | "warn" | "debug";
-interface WarningEntry {
-    /** The feature key, e.g. "sp.style", "bodyPr@vert" */
-    feature: string;
-    /** Human-readable description */
-    message: string;
-    /** Location context, e.g. "Slide 1" */
-    context?: string;
-}
-interface WarningSummary {
-    totalCount: number;
-    features: {
-        feature: string;
-        message: string;
-        count: number;
-    }[];
-}
-declare function getWarningSummary(): WarningSummary;
-declare function getWarningEntries(): readonly WarningEntry[];
-
-interface ConvertOptions {
-    /** 変換対象のスライド番号 (1始まり)。未指定で全スライド */
-    slides?: number[];
-    /** 出力画像の幅 (ピクセル)。デフォルト: 960 */
-    width?: number;
-    /** 出力画像の高さ (ピクセル)。widthと同時指定時はwidthが優先 */
-    height?: number;
-    /** 警告ログレベル。デフォルト: "off" */
-    logLevel?: LogLevel;
-    /** 追加のフォントディレクトリパス。システムフォントに加えて検索する */
-    fontDirs?: string[];
-    /** PPTX フォント名 → OSS 代替フォントのカスタムマッピング。デフォルトマッピングにマージされる */
-    fontMapping?: FontMapping;
-    /** true のとき OS のシステムフォントをスキャンせず fontDirs のみを使用する */
-    skipSystemFonts?: boolean;
-    /**
-     * SVG でのテキスト出力方式。デフォルト: "path"
-     * - "path": グリフをアウトライン化した <path> として出力する。フォント環境に依存しない
-     * - "text": ネイティブ <text> 要素 + サブセット化フォントの @font-face (data URI) 埋め込みで出力する。
-     *   ブラウザでのインライン表示時にネイティブテキスト描画 (ヒンティング等) が効き、テキスト選択も可能になる。
-     *   <img src="...svg"> 参照やサニタイズ環境では期待どおり描画されないことがある。
-     *   convertPptxToPng では無視され、常に "path" で変換される (resvg は @font-face を解釈しないため)
-     */
-    textOutput?: "path" | "text";
-}
-interface SlideSvg {
-    slideNumber: number;
-    svg: string;
-}
-interface SlideImage {
-    slideNumber: number;
-    png: Buffer;
-    width: number;
-    height: number;
-}
-declare function convertPptxToSvg(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideSvg[]>;
-declare function convertPptxToPng(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideImage[]>;
-
-/** フォント収集結果 */
-interface UsedFonts {
-    /** テーマで定義されたフォント */
-    theme: {
-        majorFont: string;
-        minorFont: string;
-        majorFontEa: string | null;
-        minorFontEa: string | null;
-        majorFontCs: string | null;
-        minorFontCs: string | null;
-    };
-    /** テキストランやテーマで使用されているフォント名の一覧（重複なし、ソート済み） */
-    fonts: string[];
-}
-/**
- * PPTX をパースして使用されているフォント名を収集する。
- * レンダリングは行わないため軽量。
- */
-declare function collectUsedFonts(input: Buffer | Uint8Array): UsedFonts;
-
 /**
  * テキストの幅と行高さを計測するインターフェース。
  * デフォルトでは静的フォントメトリクスによる計測が使われる。
@@ -149,24 +89,6 @@ declare class OpentypeTextMeasurer implements TextMeasurer {
     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;
-    getAdvanceWidth(text: string, fontSize: number): number;
-}
-interface TextPathFontResolver {
-    resolveFont(fontFamily: string | null | undefined, fontFamilyEa: string | null | undefined, jpanFallback?: string | null): OpentypeFullFont | null;
-}
-
 /** フォントバッファの入力形式 */
 interface FontBuffer {
     name?: string;
@@ -204,4 +126,82 @@ declare function clearFontCache(): void;
  */
 declare function initResvgWasm(): Promise<void>;
 
+type LogLevel = "off" | "warn" | "debug";
+interface WarningEntry {
+    /** The feature key, e.g. "sp.style", "bodyPr@vert" */
+    feature: string;
+    /** Human-readable description */
+    message: string;
+    /** Location context, e.g. "Slide 1" */
+    context?: string;
+}
+interface WarningSummary {
+    totalCount: number;
+    features: {
+        feature: string;
+        message: string;
+        count: number;
+    }[];
+}
+declare function getWarningSummary(): WarningSummary;
+declare function getWarningEntries(): readonly WarningEntry[];
+
+interface ConvertOptions {
+    /** 変換対象のスライド番号 (1始まり)。未指定で全スライド */
+    slides?: number[];
+    /** 出力画像の幅 (ピクセル)。デフォルト: 960 */
+    width?: number;
+    /** 出力画像の高さ (ピクセル)。widthと同時指定時はwidthが優先 */
+    height?: number;
+    /** 警告ログレベル。デフォルト: "off" */
+    logLevel?: LogLevel;
+    /** 追加のフォントディレクトリパス。システムフォントに加えて検索する */
+    fontDirs?: string[];
+    /** PPTX フォント名 → OSS 代替フォントのカスタムマッピング。デフォルトマッピングにマージされる */
+    fontMapping?: FontMapping;
+    /** true のとき OS のシステムフォントをスキャンせず fontDirs のみを使用する */
+    skipSystemFonts?: boolean;
+    /**
+     * SVG でのテキスト出力方式。デフォルト: "path"
+     * - "path": グリフをアウトライン化した <path> として出力する。フォント環境に依存しない
+     * - "text": ネイティブ <text> 要素 + サブセット化フォントの @font-face (data URI) 埋め込みで出力する。
+     *   ブラウザでのインライン表示時にネイティブテキスト描画 (ヒンティング等) が効き、テキスト選択も可能になる。
+     *   <img src="...svg"> 参照やサニタイズ環境では期待どおり描画されないことがある。
+     *   convertPptxToPng では無視され、常に "path" で変換される (resvg は @font-face を解釈しないため)
+     */
+    textOutput?: "path" | "text";
+}
+interface SlideSvg {
+    slideNumber: number;
+    svg: string;
+}
+interface SlideImage {
+    slideNumber: number;
+    png: Buffer;
+    width: number;
+    height: number;
+}
+declare function convertPptxToSvg(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideSvg[]>;
+declare function convertPptxToPng(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideImage[]>;
+
+/** フォント収集結果 */
+interface UsedFonts {
+    /** テーマで定義されたフォント */
+    theme: {
+        majorFont: string;
+        minorFont: string;
+        majorFontEa: string | null;
+        minorFontEa: string | null;
+        majorFontCs: string | null;
+        minorFontCs: string | null;
+    };
+    /** テキストランやテーマで使用されているフォント名の一覧（重複なし、ソート済み） */
+    fonts: string[];
+}
+/**
+ * PPTX をパースして使用されているフォント名を収集する。
+ * レンダリングは行わないため軽量。
+ */
+declare function collectUsedFonts(input: Buffer | Uint8Array): UsedFonts;
+
 export { type ConvertOptions, DEFAULT_FONT_MAPPING, type FontBuffer, type FontMapping, type LogLevel, type OpentypeSetup, type SlideImage, type SlideSvg, type UsedFonts, type WarningEntry, type WarningSummary, clearFontCache, collectUsedFonts, convertPptxToPng, convertPptxToSvg, createFontMapping, createOpentypeSetupFromBuffers, createOpentypeTextMeasurerFromBuffers, getMappedFont, getWarningEntries, getWarningSummary, initResvgWasm };

package/dist/index.d.ts

@@ -1,3 +1,21 @@
+/**
+ * テキスト→パス変換用のフォントリゾルバーコンテキスト。
+ * 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;
+    getAdvanceWidth(text: string, fontSize: number): number;
+}
+interface TextPathFontResolver {
+    resolveFont(fontFamily: string | null | undefined, fontFamilyEa: string | null | undefined, jpanFallback?: string | null): OpentypeFullFont | null;
+}
+
 /**
  * PPTX フォント名 → OSS 代替フォント (Google Fonts) のマッピング。
  * ユーザーが拡張・上書き可能。
@@ -13,84 +31,6 @@ declare const DEFAULT_FONT_MAPPING: Readonly<FontMapping>;
 declare function createFontMapping(userMapping?: FontMapping): FontMapping;
 declare function getMappedFont(fontFamily: string | null | undefined, mapping: FontMapping): string | null;
 
-type LogLevel = "off" | "warn" | "debug";
-interface WarningEntry {
-    /** The feature key, e.g. "sp.style", "bodyPr@vert" */
-    feature: string;
-    /** Human-readable description */
-    message: string;
-    /** Location context, e.g. "Slide 1" */
-    context?: string;
-}
-interface WarningSummary {
-    totalCount: number;
-    features: {
-        feature: string;
-        message: string;
-        count: number;
-    }[];
-}
-declare function getWarningSummary(): WarningSummary;
-declare function getWarningEntries(): readonly WarningEntry[];
-
-interface ConvertOptions {
-    /** 変換対象のスライド番号 (1始まり)。未指定で全スライド */
-    slides?: number[];
-    /** 出力画像の幅 (ピクセル)。デフォルト: 960 */
-    width?: number;
-    /** 出力画像の高さ (ピクセル)。widthと同時指定時はwidthが優先 */
-    height?: number;
-    /** 警告ログレベル。デフォルト: "off" */
-    logLevel?: LogLevel;
-    /** 追加のフォントディレクトリパス。システムフォントに加えて検索する */
-    fontDirs?: string[];
-    /** PPTX フォント名 → OSS 代替フォントのカスタムマッピング。デフォルトマッピングにマージされる */
-    fontMapping?: FontMapping;
-    /** true のとき OS のシステムフォントをスキャンせず fontDirs のみを使用する */
-    skipSystemFonts?: boolean;
-    /**
-     * SVG でのテキスト出力方式。デフォルト: "path"
-     * - "path": グリフをアウトライン化した <path> として出力する。フォント環境に依存しない
-     * - "text": ネイティブ <text> 要素 + サブセット化フォントの @font-face (data URI) 埋め込みで出力する。
-     *   ブラウザでのインライン表示時にネイティブテキスト描画 (ヒンティング等) が効き、テキスト選択も可能になる。
-     *   <img src="...svg"> 参照やサニタイズ環境では期待どおり描画されないことがある。
-     *   convertPptxToPng では無視され、常に "path" で変換される (resvg は @font-face を解釈しないため)
-     */
-    textOutput?: "path" | "text";
-}
-interface SlideSvg {
-    slideNumber: number;
-    svg: string;
-}
-interface SlideImage {
-    slideNumber: number;
-    png: Buffer;
-    width: number;
-    height: number;
-}
-declare function convertPptxToSvg(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideSvg[]>;
-declare function convertPptxToPng(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideImage[]>;
-
-/** フォント収集結果 */
-interface UsedFonts {
-    /** テーマで定義されたフォント */
-    theme: {
-        majorFont: string;
-        minorFont: string;
-        majorFontEa: string | null;
-        minorFontEa: string | null;
-        majorFontCs: string | null;
-        minorFontCs: string | null;
-    };
-    /** テキストランやテーマで使用されているフォント名の一覧（重複なし、ソート済み） */
-    fonts: string[];
-}
-/**
- * PPTX をパースして使用されているフォント名を収集する。
- * レンダリングは行わないため軽量。
- */
-declare function collectUsedFonts(input: Buffer | Uint8Array): UsedFonts;
-
 /**
  * テキストの幅と行高さを計測するインターフェース。
  * デフォルトでは静的フォントメトリクスによる計測が使われる。
@@ -149,24 +89,6 @@ declare class OpentypeTextMeasurer implements TextMeasurer {
     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;
-    getAdvanceWidth(text: string, fontSize: number): number;
-}
-interface TextPathFontResolver {
-    resolveFont(fontFamily: string | null | undefined, fontFamilyEa: string | null | undefined, jpanFallback?: string | null): OpentypeFullFont | null;
-}
-
 /** フォントバッファの入力形式 */
 interface FontBuffer {
     name?: string;
@@ -204,4 +126,82 @@ declare function clearFontCache(): void;
  */
 declare function initResvgWasm(): Promise<void>;
 
+type LogLevel = "off" | "warn" | "debug";
+interface WarningEntry {
+    /** The feature key, e.g. "sp.style", "bodyPr@vert" */
+    feature: string;
+    /** Human-readable description */
+    message: string;
+    /** Location context, e.g. "Slide 1" */
+    context?: string;
+}
+interface WarningSummary {
+    totalCount: number;
+    features: {
+        feature: string;
+        message: string;
+        count: number;
+    }[];
+}
+declare function getWarningSummary(): WarningSummary;
+declare function getWarningEntries(): readonly WarningEntry[];
+
+interface ConvertOptions {
+    /** 変換対象のスライド番号 (1始まり)。未指定で全スライド */
+    slides?: number[];
+    /** 出力画像の幅 (ピクセル)。デフォルト: 960 */
+    width?: number;
+    /** 出力画像の高さ (ピクセル)。widthと同時指定時はwidthが優先 */
+    height?: number;
+    /** 警告ログレベル。デフォルト: "off" */
+    logLevel?: LogLevel;
+    /** 追加のフォントディレクトリパス。システムフォントに加えて検索する */
+    fontDirs?: string[];
+    /** PPTX フォント名 → OSS 代替フォントのカスタムマッピング。デフォルトマッピングにマージされる */
+    fontMapping?: FontMapping;
+    /** true のとき OS のシステムフォントをスキャンせず fontDirs のみを使用する */
+    skipSystemFonts?: boolean;
+    /**
+     * SVG でのテキスト出力方式。デフォルト: "path"
+     * - "path": グリフをアウトライン化した <path> として出力する。フォント環境に依存しない
+     * - "text": ネイティブ <text> 要素 + サブセット化フォントの @font-face (data URI) 埋め込みで出力する。
+     *   ブラウザでのインライン表示時にネイティブテキスト描画 (ヒンティング等) が効き、テキスト選択も可能になる。
+     *   <img src="...svg"> 参照やサニタイズ環境では期待どおり描画されないことがある。
+     *   convertPptxToPng では無視され、常に "path" で変換される (resvg は @font-face を解釈しないため)
+     */
+    textOutput?: "path" | "text";
+}
+interface SlideSvg {
+    slideNumber: number;
+    svg: string;
+}
+interface SlideImage {
+    slideNumber: number;
+    png: Buffer;
+    width: number;
+    height: number;
+}
+declare function convertPptxToSvg(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideSvg[]>;
+declare function convertPptxToPng(input: Buffer | Uint8Array, options?: ConvertOptions): Promise<SlideImage[]>;
+
+/** フォント収集結果 */
+interface UsedFonts {
+    /** テーマで定義されたフォント */
+    theme: {
+        majorFont: string;
+        minorFont: string;
+        majorFontEa: string | null;
+        minorFontEa: string | null;
+        majorFontCs: string | null;
+        minorFontCs: string | null;
+    };
+    /** テキストランやテーマで使用されているフォント名の一覧（重複なし、ソート済み） */
+    fonts: string[];
+}
+/**
+ * PPTX をパースして使用されているフォント名を収集する。
+ * レンダリングは行わないため軽量。
+ */
+declare function collectUsedFonts(input: Buffer | Uint8Array): UsedFonts;
+
 export { type ConvertOptions, DEFAULT_FONT_MAPPING, type FontBuffer, type FontMapping, type LogLevel, type OpentypeSetup, type SlideImage, type SlideSvg, type UsedFonts, type WarningEntry, type WarningSummary, clearFontCache, collectUsedFonts, convertPptxToPng, convertPptxToSvg, createFontMapping, createOpentypeSetupFromBuffers, createOpentypeTextMeasurerFromBuffers, getMappedFont, getWarningEntries, getWarningSummary, initResvgWasm };