pptx-ts 0.0.1

package/dist/pres-C5__xkDh.d.ts

@@ -0,0 +1,202 @@
+import { y as WRITE_OUTPUT_TYPE } from "./enums-CvRYniUA.js";
+import { H as HexColor, a as Slide } from "./slide-js0QpRV-.js";
+//#region src/types/theme.d.ts
+/**
+ * Theme color scheme overrides. Each slot maps to one `<a:clrScheme>` entry in `theme1.xml`;
+ * any slot left unset keeps the default Office value. Provide 6-digit hex (no `#`).
+ *
+ * Slot names use the OOXML scheme names. The PowerPoint UI labels them as:
+ * `dk1`=Text/Dark 1, `lt1`=Background/Light 1, `dk2`=Text/Dark 2, `lt2`=Background/Light 2,
+ * `accent1`-`accent6`=Accent 1-6, `hlink`=Hyperlink, `folHlink`=Followed Hyperlink.
+ * @example { accent1: 'C00000', dk2: '1F3864', hlink: '0070C0' }
+ */
+interface ThemeColorScheme {
+  /** Text/Dark 1 (default Office: black via `windowText`) */
+  dk1?: HexColor;
+  /** Background/Light 1 (default Office: white via `window`) */
+  lt1?: HexColor;
+  /** Text/Dark 2 (default Office: `44546A`) */
+  dk2?: HexColor;
+  /** Background/Light 2 (default Office: `E7E6E6`) */
+  lt2?: HexColor;
+  /** Accent 1 (default Office: `4472C4`) */
+  accent1?: HexColor;
+  /** Accent 2 (default Office: `ED7D31`) */
+  accent2?: HexColor;
+  /** Accent 3 (default Office: `A5A5A5`) */
+  accent3?: HexColor;
+  /** Accent 4 (default Office: `FFC000`) */
+  accent4?: HexColor;
+  /** Accent 5 (default Office: `5B9BD5`) */
+  accent5?: HexColor;
+  /** Accent 6 (default Office: `70AD47`) */
+  accent6?: HexColor;
+  /** Hyperlink (default Office: `0563C1`) */
+  hlink?: HexColor;
+  /** Followed Hyperlink (default Office: `954F72`) */
+  folHlink?: HexColor;
+}
+interface ThemeProps {
+  /**
+   * Headings font face name
+   * @example 'Arial Narrow'
+   * @default 'Calibri Light'
+   */
+  headFontFace?: string;
+  /**
+   * Body font face name
+   * @example 'Arial'
+   * @default 'Calibri'
+   */
+  bodyFontFace?: string;
+  /**
+   * Headings East Asian font face — theme `<a:ea>` slot of the major font.
+   * Used for CJK (Chinese/Japanese/Korean) runs that fall back to the theme font.
+   * - leave unset to keep PowerPoint's empty default (auto-resolved per script)
+   * @example 'Yu Gothic'
+   */
+  headFontFaceEA?: string;
+  /**
+   * Body East Asian font face — theme `<a:ea>` slot of the minor font.
+   * Used for CJK (Chinese/Japanese/Korean) runs that fall back to the theme font.
+   * - leave unset to keep PowerPoint's empty default (auto-resolved per script)
+   * @example 'Yu Gothic'
+   */
+  bodyFontFaceEA?: string;
+  /**
+   * Headings complex-script font face — theme `<a:cs>` slot of the major font.
+   * Used for complex scripts such as Arabic, Hebrew, Thai, and Devanagari.
+   * - leave unset to keep PowerPoint's empty default (auto-resolved per script)
+   * @example 'Arial'
+   */
+  headFontFaceCS?: string;
+  /**
+   * Body complex-script font face — theme `<a:cs>` slot of the minor font.
+   * Used for complex scripts such as Arabic, Hebrew, Thai, and Devanagari.
+   * - leave unset to keep PowerPoint's empty default (auto-resolved per script)
+   * @example 'Arial'
+   */
+  bodyFontFaceCS?: string;
+  /**
+   * Theme color scheme overrides written to `ppt/theme/theme1.xml`.
+   * - any unset slot keeps its default Office value
+   * - references such as `SchemeColor.accent1` resolve against these values
+   * @example { accent1: 'C00000', accent2: '00B050', hlink: '0070C0' }
+   */
+  colorScheme?: ThemeColorScheme;
+}
+//#endregion
+//#region src/types/pres.d.ts
+interface WriteBaseProps {
+  /**
+   * Whether to DEFLATE-compress the package (PowerPoint itself always compresses;
+   * set `false` only if export time matters more than file size)
+   * @default true
+   */
+  compression?: boolean;
+  /**
+   * How to handle a media asset (image/audio/video) that fails to load during export.
+   * - `'throw'` (default): reject the export with an error naming the failing asset. A deck
+   *   that silently embeds a broken-image placeholder is a degenerate result, so failing
+   *   loudly is the safe default.
+   * - `'placeholder'`: substitute a broken-image placeholder, emit a `media/load-failed`
+   *   diagnostic (see `setDiagnosticHandler`), and
+   *   continue. Useful for best-effort/batch jobs where one missing asset should not abort
+   *   the whole deck.
+   * @default 'throw'
+   */
+  onMediaError?: 'throw' | 'placeholder';
+}
+interface WriteProps extends WriteBaseProps {
+  /**
+   * Output type
+   * - values: 'arraybuffer' | 'base64' | 'binarystring' | 'blob' | 'nodebuffer' | 'uint8array'
+   * @default 'blob'
+   */
+  outputType?: WRITE_OUTPUT_TYPE;
+}
+interface WriteFileProps extends WriteBaseProps {
+  /**
+   * Export file name
+   * @default 'Presentation.pptx'
+   */
+  fileName?: string;
+}
+/**
+ * One emitted OOXML package part: its full slash-path and already-encoded bytes. Returned by
+ * {@link TsPptx.toParts} for callers that want the raw parts of the `.pptx` OPC package without
+ * zipping (custom containers, streaming, part-level inspection). The bytes are byte-identical to
+ * what `write()` would compress for the same part;
+ * XML parts are UTF-8 (decode with `new TextDecoder().decode(part.data)`), media/font parts are
+ * their raw binary.
+ */
+interface PackagePart {
+  /** Full OOXML package part path, e.g. `ppt/slides/slide1.xml`. */
+  readonly path: string;
+  /** The part's already-encoded bytes: a fresh view per call, safe to keep or transfer. */
+  readonly data: Uint8Array;
+}
+/**
+ * Options for {@link TsPptx.toParts}. A deliberately narrow subset of {@link WriteProps}:
+ * `compression` and `outputType` are zip concerns and do not apply when parts are returned
+ * unzipped, so only media-error handling is exposed.
+ */
+interface PartsProps {
+  /**
+   * How to handle a media asset (image/audio/video) that fails to load. Same semantics as
+   * {@link WriteBaseProps.onMediaError}.
+   * @default 'throw'
+   */
+  onMediaError?: 'throw' | 'placeholder';
+}
+interface SectionProps {
+  /**
+   * Section title
+   */
+  title: string;
+  /**
+   * Section order - uses to add section at any index
+   * - values: 1-n
+   */
+  order?: number;
+}
+interface PresLayout {
+  _sizeW?: number;
+  _sizeH?: number;
+  /**
+   * Layout Name
+   * @example 'LAYOUT_WIDE'
+   */
+  name: string;
+  width: number;
+  height: number;
+}
+type CustomPropertyValue = string | number | boolean | Date;
+interface PresentationProps {
+  author: string;
+  company: string;
+  layout: string;
+  masterSlide: Slide;
+  /**
+   * Presentation's layout
+   * read-only
+   */
+  presLayout: PresLayout;
+  revision: string;
+  /**
+   * Slide number to assign to the first slide (affects the slide-number field displayed in placeholders).
+   * @default 1
+   */
+  firstSlideNum: number;
+  /**
+   * Whether to enable right-to-left mode
+   * @default false
+   */
+  rtlMode: boolean;
+  subject: string;
+  theme: ThemeProps;
+  title: string;
+}
+//#endregion
+export { PresentationProps as a, WriteFileProps as c, ThemeProps as d, PresLayout as i, WriteProps as l, PackagePart as n, SectionProps as o, PartsProps as r, WriteBaseProps as s, CustomPropertyValue as t, ThemeColorScheme as u };
+//# sourceMappingURL=pres-C5__xkDh.d.ts.map

package/dist/pres-C5__xkDh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pres-C5__xkDh.d.ts","names":[],"sources":["../src/types/theme.ts","../src/types/pres.ts"],"mappings":";;;;;;;;;;;;UAgBiB;;EAEhB,MAAM;;EAEN,MAAM;;EAEN,MAAM;;EAEN,MAAM;;EAEN,UAAU;;EAEV,UAAU;;EAEV,UAAU;;EAEV,UAAU;;EAEV,UAAU;;EAEV,UAAU;;EAEV,QAAQ;;EAER,WAAW;;UAEK;;;;;;EAMhB;;;;;;EAMA;;;;;;;EAOA;;;;;;;EAOA;;;;;;;EAOA;;;;;;;EAOA;;;;;;;EAOA,cAAc;;;;UC/EE;;;;;;EAMhB;;;;;;;;;;;;EAYA;;UAEgB,mBAAmB;;;;;;EAMnC,aAAa;;UAEG,uBAAuB;;;;;EAKvC;;;;;;;;;;UAUgB;;WAEP;;WAEA,MAAM;;;;;;;UAOC;;;;;;EAMhB;;UAEgB;;;;EAIhB;;;;;EAKA;;UAEgB;EAChB;EACA;;;;;EAMA;EACA;EACA;;KAEW,kDAAkD;UAE7C;EAChB;EACA;EACA;EACA,aAAa;;;;;EAKb,YAAY;EACZ;;;;;EAKA;;;;;EAKA;EACA;EACA,OAAO;EACP"}