pptx-glimpse 1.1.2 → 3.0.0

package/dist/index.d.cts

@@ -1,207 +1,7 @@
-/**
- * テキスト→パス変換用のフォントリゾルバーコンテキスト。
- * 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;
-}
+export { C as ConversionDiagnostic, a as ConvertOptions, D as DEFAULT_FONT_MAPPING, F as FontBuffer, b as FontMapping, L as LogLevel, O as OpentypeSetup, P as PngConversionReport, S as SlideImage, d as SlideSupportCoverage, e as SlideSvg, h as SupportCoverage, i as SupportCoverageCounts, j as SvgConversionReport, U as UsedFonts, W as WarningEntry, k as WarningSummary, l as clearFontCache, m as collectUsedFonts, n as convertPptxToPng, p as convertPptxToSvg, q as createFontMapping, r as createOpentypeSetupFromBuffers, s as createOpentypeTextMeasurerFromBuffers, t as getMappedFont, u as getWarningEntries, v as getWarningSummary } from './font-collector-DYooJP6L.cjs';
 
-/**
- * PPTX フォント名 → OSS 代替フォント (Google Fonts) のマッピング。
- * ユーザーが拡張・上書き可能。
- */
-/** フォントマッピングテーブルの型 */
-type FontMapping = Record<string, string>;
-/** デフォルトのフォントマッピングテーブル */
-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 ResvgWasmInput = ArrayBuffer | Uint8Array | Response;
 
-/**
- * テキストの幅と行高さを計測するインターフェース。
- * デフォルトでは静的フォントメトリクスによる計測が使われる。
- * ユーザーが独自の実装を 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;
-}
+declare function initResvgWasm(wasm?: ResvgWasmInput): Promise<void>;
 
-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;
-    private warnedFonts;
-    /**
-     * @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 resolveBoldFont;
-    private resolveFont;
-}
-
-/** フォントバッファの入力形式 */
-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>;
-/**
- * フォントオブジェクトキャッシュをクリアする。
- * 通常は呼び出す必要はないが、フォントのインストール/アンインストール後に
- * 強制的に再読み込みしたい場合に使用する。
- */
-declare function clearFontCache(): void;
-
-/**
- * resvg-wasm の WASM モジュールを初期化する。
- * 明示的に呼び出さなくても、初回の PNG 変換時に自動的に初期化される。
- * アプリケーション起動時に初期化しておきたい場合に使用する。
- */
-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 };
+export { type ResvgWasmInput, initResvgWasm };

package/dist/index.d.ts

@@ -1,207 +1,7 @@
-/**
- * テキスト→パス変換用のフォントリゾルバーコンテキスト。
- * 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;
-}
+export { C as ConversionDiagnostic, a as ConvertOptions, D as DEFAULT_FONT_MAPPING, F as FontBuffer, b as FontMapping, L as LogLevel, O as OpentypeSetup, P as PngConversionReport, S as SlideImage, d as SlideSupportCoverage, e as SlideSvg, h as SupportCoverage, i as SupportCoverageCounts, j as SvgConversionReport, U as UsedFonts, W as WarningEntry, k as WarningSummary, l as clearFontCache, m as collectUsedFonts, n as convertPptxToPng, p as convertPptxToSvg, q as createFontMapping, r as createOpentypeSetupFromBuffers, s as createOpentypeTextMeasurerFromBuffers, t as getMappedFont, u as getWarningEntries, v as getWarningSummary } from './font-collector-DYooJP6L.js';
 
-/**
- * PPTX フォント名 → OSS 代替フォント (Google Fonts) のマッピング。
- * ユーザーが拡張・上書き可能。
- */
-/** フォントマッピングテーブルの型 */
-type FontMapping = Record<string, string>;
-/** デフォルトのフォントマッピングテーブル */
-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 ResvgWasmInput = ArrayBuffer | Uint8Array | Response;
 
-/**
- * テキストの幅と行高さを計測するインターフェース。
- * デフォルトでは静的フォントメトリクスによる計測が使われる。
- * ユーザーが独自の実装を 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;
-}
+declare function initResvgWasm(wasm?: ResvgWasmInput): Promise<void>;
 
-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;
-    private warnedFonts;
-    /**
-     * @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 resolveBoldFont;
-    private resolveFont;
-}
-
-/** フォントバッファの入力形式 */
-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>;
-/**
- * フォントオブジェクトキャッシュをクリアする。
- * 通常は呼び出す必要はないが、フォントのインストール/アンインストール後に
- * 強制的に再読み込みしたい場合に使用する。
- */
-declare function clearFontCache(): void;
-
-/**
- * resvg-wasm の WASM モジュールを初期化する。
- * 明示的に呼び出さなくても、初回の PNG 変換時に自動的に初期化される。
- * アプリケーション起動時に初期化しておきたい場合に使用する。
- */
-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 };
+export { type ResvgWasmInput, initResvgWasm };