allyhub 0.5.0 → 0.7.0

package/dist/node_modules/@allyhub-next/slides-core/dist/api.d.ts

@@ -1,21 +1,37 @@
-import type { AnimationEffect, AnimationFile, LineDash, TransitionFile, LineEnd, ShapeGeometry, TextAlign, ThemeColor } from "@allyhub-next/formats";
+import type { Numbering, AnimationEffect, AnimationFile, LineDash, TransitionFile, LineEnd, ShapeGeometry, TextAlign, ThemeColor } from "@allyhub-next/formats";
 import type { Anchor, AutoSize, FillType, PlaceholderType, ShapeType } from "./enums.js";
-import type { Color, ComponentContext, DeckDef, FontDef, Frame, FreeformPath, GeneratedSlideDef, GeneratorContext, LayoutDef, MasterDef, ParagraphDef, TableCellDef, TableDef, ParagraphFormatDef, PropSpec, RunDef, ShapeDef, TextFrameDef } from "./model.js";
-import type { ChartType } from "@allyhub-next/formats";
-import { Chart, type CategoryChartData } from "./chart-api.js";
+import type { Color, ComponentContext, DeckDef, FontDef, Frame, GradientDef, FreeformPath, GeneratedSlideDef, GeneratorContext, LayoutDef, MasterDef, ParagraphDef, TableCellDef, TableDef, ParagraphFormatDef, PropSpec, RunDef, ShapeDef, TextFrameDef } from "./model.js";
+import type { SheetChartType } from "@allyhub-next/formats";
+import { Chart, type CategoryChartData, type XyChartData } from "./chart-api.js";
 import type { ThemeInput } from "./theme.js";
-import { type Length, type SlideSizeName } from "./units.js";
-/** python-pptx's `RGBColor(r, g, b)` and `RGBColor.from_string("3C2F80")`: a colour as `#RRGGBB`. */
-export declare const RGBColor: ((r: number, g: number, b: number) => string) & {
-    from_string: (s: string) => string;
-};
-/** A colour (python-pptx's `ColorFormat`): the theme's, or RGB. */
+import { type Length, type LengthValue, type SlideSizeName } from "./units.js";
+/** python-pptx's `RGBColor`: called or made with `new`, a colour as `#RRGGBB`. */
+export interface RGBColorMaker {
+    (r: number, g: number, b: number): string;
+    new (r: number, g: number, b: number): string;
+    from_string(s: string): string;
+}
+/**
+ * python-pptx's `RGBColor(r, g, b)` and `RGBColor.from_string("3C2F80")`:
+ * a colour as `#RRGGBB`; `new RGBColor(r, g, b)` makes the same (a String
+ * object, which the API takes as its text).
+ */
+export declare const RGBColor: RGBColorMaker;
+/** A colour (python-pptx's `ColorFormat`): the theme's, lighter or darker by its brightness, or RGB. */
 export declare class ColorFormat {
     private readonly read;
     private readonly write;
     constructor(read: () => Color | undefined, write: (c: Color | undefined) => void);
     get theme_color(): ThemeColor | undefined;
+    /** As python-pptx's: a theme colour changed to another keeps its brightness. */
     set theme_color(c: ThemeColor | undefined);
+    /**
+     * Lighter (up to 1, white) or darker (down to -1, black), 0 for neither:
+     * PowerPoint's "Lighter 40%" is 0.4, "Darker 25%" -0.25 (`a:lumMod` and
+     * `a:lumOff`). A theme colour's; setting `rgb` takes it away.
+     */
+    get brightness(): number;
+    set brightness(v: number);
     /** `#RRGGBB`; python-pptx's `RGBColor`, here a string (RGBColor(…) makes one). */
     get rgb(): string | undefined;
     set rgb(v: string | undefined);
@@ -25,9 +41,18 @@ export declare class Font {
     private readonly def;
     constructor(def: FontDef);
     private _set;
+    /** A line through it (PowerPoint's Strikethrough). */
+    get strike(): boolean | undefined;
+    set strike(v: boolean | undefined);
+    /** Raised or lowered, a share of its size: superscript 0.3, subscript -0.25. */
+    get baseline(): number | undefined;
+    set baseline(v: number | undefined);
+    /** The colour behind it, as RGBColor gives one. */
+    get highlight(): string | undefined;
+    set highlight(v: string | undefined);
     get name(): string | undefined;
     set name(v: string | undefined);
-    get size(): Length | undefined;
+    get size(): LengthValue | undefined;
     set size(v: Length | undefined);
     get bold(): boolean | undefined;
     set bold(v: boolean | undefined);
@@ -37,17 +62,25 @@ export declare class Font {
     get underline(): boolean | undefined;
     set underline(v: boolean | undefined);
     /** Space added between letters, a Length (negative tightens): PowerPoint's Character Spacing, which python-pptx has no name for. */
-    get spacing(): Length | undefined;
+    get spacing(): LengthValue | undefined;
     set spacing(v: Length | undefined);
     get color(): ColorFormat;
 }
 /** python-pptx's `_Run`. */
+/** python-pptx's `_Hyperlink`: what a run opens. */
+export declare class Hyperlink {
+    private readonly def;
+    constructor(def: RunDef);
+    get address(): string | undefined;
+    set address(v: string | undefined);
+}
 export declare class Run {
     private readonly def;
     constructor(def: RunDef);
     get text(): string;
     set text(v: string);
     get font(): Font;
+    get hyperlink(): Hyperlink;
 }
 /** What a paragraph and a list style's level share: alignment, spacing, its runs' font. */
 declare abstract class Format {
@@ -56,11 +89,11 @@ declare abstract class Format {
     get alignment(): TextAlign | undefined;
     set alignment(v: TextAlign | undefined);
     /** A number of lines (1.5), or a Length (Pt(18)) for a fixed height. */
-    get line_spacing(): number | undefined;
+    get line_spacing(): number | LengthValue | undefined;
     set line_spacing(v: number | undefined);
-    get space_before(): Length | undefined;
+    get space_before(): LengthValue | undefined;
     set space_before(v: Length | undefined);
-    get space_after(): Length | undefined;
+    get space_after(): LengthValue | undefined;
     set space_after(v: Length | undefined);
     /** Its runs' default character properties (`a:defRPr`). */
     get font(): Font;
@@ -89,16 +122,19 @@ export declare class Paragraph extends Format {
 export declare class ListLevel extends Format {
     protected readonly fmt: ParagraphFormatDef;
     constructor(def: ParagraphFormatDef);
+    /** Counted in place of a bullet (`a:buAutoNum`): "arabicPeriod", "alphaLcPeriod"… */
+    get numbered(): Numbering | undefined;
+    set numbered(v: Numbering | undefined);
     /** Its bullet character, or null for none (`a:buChar`, `a:buNone`). */
     get bullet(): string | null | undefined;
     set bullet(v: string | null | undefined);
     get bullet_font(): string | undefined;
     set bullet_font(v: string | undefined);
     /** Where its lines start (`@marL`). */
-    get margin_left(): Length | undefined;
+    get margin_left(): LengthValue | undefined;
     set margin_left(v: Length | undefined);
     /** Its first line from margin_left (`@indent`; negative hangs it, for a bullet). */
-    get indent(): Length | undefined;
+    get indent(): LengthValue | undefined;
     set indent(v: Length | undefined);
 }
 /** A list style's nine levels, level 0 first. */
@@ -140,13 +176,13 @@ export declare class TextFrame {
     set auto_size(v: AutoSize | undefined);
     get word_wrap(): boolean | undefined;
     set word_wrap(v: boolean | undefined);
-    get margin_left(): Length;
+    get margin_left(): LengthValue;
     set margin_left(v: Length);
-    get margin_top(): Length;
+    get margin_top(): LengthValue;
     set margin_top(v: Length);
-    get margin_right(): Length;
+    get margin_right(): LengthValue;
     set margin_right(v: Length);
-    get margin_bottom(): Length;
+    get margin_bottom(): LengthValue;
     set margin_bottom(v: Length);
 }
 /** python-pptx's `FillFormat`, for a solid fill and none. */
@@ -154,16 +190,52 @@ export declare class FillFormat {
     private readonly read;
     private readonly write;
     private readonly start;
-    constructor(read: () => Color | null | undefined, write: (v: Color | null) => void, start?: Color);
+    /** The shape it fills: only a shape's has a gradient and a transparency. */
+    private readonly shape;
+    constructor(read: () => Color | null | undefined, write: (v: Color | null) => void, start?: Color, shape?: ShapeDef);
     /** A solid fill; its colour is fore_color. */
     solid(): void;
     /** No fill (python-pptx's `background()`: transparent). */
     background(): void;
-    /** MSO_FILL.SOLID, MSO_FILL.BACKGROUND, or undefined while it is inherited. */
+    private _shape;
+    /** A gradient fill, of two of the theme's colours until gradient_stops says otherwise. */
+    gradient(): void;
+    /** A gradient's degrees, clockwise from left to right. python-pptx's run the other way. */
+    get gradient_angle(): number;
+    set gradient_angle(v: number);
+    /** A gradient's stops: `[{ at, color, transparency }]`, `at` and `transparency` shares. */
+    get gradient_stops(): GradientDef["stops"];
+    set gradient_stops(v: GradientDef["stops"]);
+    private _gradient;
+    /** How much of the fill shows through, a share (PowerPoint's Transparency). */
+    get transparency(): number;
+    set transparency(v: number);
+    /** MSO_FILL.SOLID, MSO_FILL.BACKGROUND, MSO_FILL.GRADIENT, or undefined while it is inherited. */
     get type(): FillType | undefined;
     /** A solid fill's colour; python-pptx refuses it for another fill: call solid() first. */
     get fore_color(): ColorFormat;
 }
+/**
+ * python-pptx's `ShadowFormat`: a shape's shadow. Its `inherit` is there; what
+ * a shadow is made of, python-pptx has no API for.
+ */
+export declare class ShadowFormat {
+    private readonly def;
+    constructor(def: ShapeDef);
+    private _shadow;
+    /** Whether it has none of its own; false gives it SHADOW_DEFAULTS. */
+    get inherit(): boolean;
+    set inherit(v: boolean);
+    get blur_radius(): LengthValue;
+    set blur_radius(v: Length);
+    get distance(): LengthValue;
+    set distance(v: Length);
+    get angle(): number;
+    set angle(v: number);
+    get transparency(): number;
+    set transparency(v: number);
+    get color(): ColorFormat;
+}
 /** python-pptx's `LineFormat`: a shape's outline. */
 export declare class LineFormat {
     private readonly def;
@@ -171,7 +243,7 @@ export declare class LineFormat {
     /** Its colour; setting one makes the line solid. */
     get color(): ColorFormat;
     get fill(): FillFormat;
-    get width(): Length;
+    get width(): LengthValue;
     set width(v: Length);
     /** Its dashes (MSO_LINE), or null for its theme's. */
     get dash_style(): LineDash | null;
@@ -191,8 +263,8 @@ export declare class Background {
     });
     get fill(): FillFormat;
 }
-/** A geometry's adjustments and what each is when not set (PresentationML's presets). */
-export declare const ADJUSTMENT_DEFAULTS: Partial<Record<ShapeGeometry, number[]>>;
+/** A geometry's adjustments when none is set: its preset's own (ECMA-376's definitions), python-pptx's shares. */
+export declare const adjustmentDefaults: (geometry: string) => number[];
 /** python-pptx's `Adjustments`: `shape.adjustments[0] = 0.1`. */
 export declare class Adjustments {
     [i: number]: number;
@@ -227,13 +299,13 @@ export declare class Shape {
         type: PlaceholderType;
         idx: number;
     };
-    get left(): Length;
+    get left(): LengthValue;
     set left(v: Length);
-    get top(): Length;
+    get top(): LengthValue;
     set top(v: Length);
-    get width(): Length;
+    get width(): LengthValue;
     set width(v: Length);
-    get height(): Length;
+    get height(): LengthValue;
     set height(v: Length);
     /** Degrees clockwise about its centre; python-pptx's, kept from 0 up to 360. */
     get rotation(): number;
@@ -245,6 +317,7 @@ export declare class Shape {
     set text(v: string);
     get fill(): FillFormat;
     get line(): LineFormat;
+    get shadow(): ShadowFormat;
     /** Its geometry's adjustments: `adjustments[0] = 0.1` sets a rounded rectangle's corner. */
     get adjustments(): Adjustments;
 }
@@ -286,14 +359,14 @@ export declare class GroupShape {
     get shape_type(): ShapeType;
     get name(): string;
     set name(v: string);
-    get left(): Length;
+    get left(): LengthValue;
     /** Moves its shapes with it. */
     set left(v: Length);
-    get top(): Length;
+    get top(): LengthValue;
     /** Moves its shapes with it. */
     set top(v: Length);
-    get width(): Length;
-    get height(): Length;
+    get width(): LengthValue;
+    get height(): LengthValue;
 }
 /** python-pptx's `_Cell`. */
 export declare class Cell {
@@ -309,13 +382,13 @@ export declare class Cell {
     /** Its edges, each a colour and a width; python-pptx has none (`a:lnL`…). */
     get borders(): NonNullable<TableCellDef["borders"]>;
     set borders(v: NonNullable<TableCellDef["borders"]>);
-    get margin_left(): Length;
+    get margin_left(): LengthValue;
     set margin_left(v: Length);
-    get margin_right(): Length;
+    get margin_right(): LengthValue;
     set margin_right(v: Length);
-    get margin_top(): Length;
+    get margin_top(): LengthValue;
     set margin_top(v: Length);
-    get margin_bottom(): Length;
+    get margin_bottom(): LengthValue;
     set margin_bottom(v: Length);
     get vertical_anchor(): Anchor | undefined;
     set vertical_anchor(v: Anchor | undefined);
@@ -333,7 +406,7 @@ export declare class Column {
     private readonly def;
     private readonly at;
     constructor(def: TableDef, at: number);
-    get width(): Length;
+    get width(): LengthValue;
     set width(v: Length);
 }
 /** python-pptx's `_Row`. */
@@ -342,7 +415,7 @@ export declare class Row {
     private readonly at;
     constructor(def: TableDef, at: number);
     private get row();
-    get height(): Length;
+    get height(): LengthValue;
     set height(v: Length);
 }
 /** python-pptx's `Table`. */
@@ -406,12 +479,16 @@ export declare class ShapeCollection implements Iterable<Shape> {
     /** A table of equal columns and rows (python-pptx's add_table), in `.table`; unlike python-pptx's it has no style, so its look is its cells'. */
     add_table(rows: number, cols: number, left: Length, top: Length, width: Length, height: Length): Shape;
     /** A chart (python-pptx's add_chart), in `.chart`; PowerPoint opens it as its own, with its numbers in a workbook. */
-    add_chart(chart_type: ChartType, x: Length, y: Length, cx: Length, cy: Length, chart_data: CategoryChartData): Shape;
+    add_chart(chart_type: SheetChartType, x: Length, y: Length, cx: Length, cy: Length, chart_data: CategoryChartData | XyChartData): Shape;
     /** A group of shapes (python-pptx's add_group_shape): what is added to its `shapes` is in it. */
     add_group_shape(): GroupShape;
     /** A freeform's builder (python-pptx's build_freeform): filled and outlined as an autoshape. */
     build_freeform(start_x?: number, start_y?: number, scale?: number | readonly [number, number]): FreeformBuilder;
-    /** A straight line from one point to another (MSO_CONNECTOR.STRAIGHT). */
+    /**
+     * A connector from one point to another: MSO_CONNECTOR's straight line,
+     * elbow or curve, or a connector's preset by name where python-pptx has
+     * none (`straightConnector1`, `bentConnector2`…`5`, `curvedConnector2`…`5`).
+     */
     add_connector(connector_type: ShapeGeometry, begin_x: Length, begin_y: Length, end_x: Length, end_y: Length): Shape;
     /** A component of the presentation (`prs.components.add`), drawn by its code in the frame (an extension). */
     add_component(component: string, left: Length, top: Length, width: Length, height: Length, props?: Record<string, unknown>): Shape;
@@ -587,9 +664,9 @@ export declare class Presentation {
     readonly _ctx: Context;
     constructor(size: readonly [Length, Length], base: string);
     get _def(): DeckDef;
-    get slide_width(): Length;
+    get slide_width(): LengthValue;
     set slide_width(v: Length);
-    get slide_height(): Length;
+    get slide_height(): LengthValue;
     set slide_height(v: Length);
     get slide_masters(): SlideMasters;
     /** The first master (python-pptx's `slide_master`). */

package/dist/node_modules/@allyhub-next/slides-core/dist/api.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{MSO_CONNECTOR as k,MSO_SHAPE as $,MSO_SHAPE_TYPE as F,PP_PLACEHOLDER as M}from"./enums.js";import{Chart as R}from"./chart-api.js";import{AUTOSHAPE_STYLE as c,CONNECTOR_STYLE as O,FOOTER_IDX as L,OFFICE_TEXT_STYLES as N,TEXT_INSETS as _,TEXTBOX_FRAME as z}from"./office.js";import{masterPlaceholder as T}from"./placeholders.js";import{strict as a}from"./strict.js";import{EMU_PER_PT as v,SLIDE_SIZES as S}from"./units.js";class C extends Error{constructor(t){super(`${t} (allyhub slides capabilities lists what the API holds).`),this.name="Unsupported"}}const m=i=>{throw new C(i)},G=/^#?[0-9a-f]{6}$/iu,j=i=>{if(!G.test(i))throw new Error(`rgb ${i} is not RRGGBB.`);return`#${i.replace("#","").toUpperCase()}`};export const RGBColor=Object.assign((i,t,e)=>{for(const s of[i,t,e])if(!Number.isInteger(s)||s<0||s>255)throw new Error(`RGBColor(${String(i)}, ${String(t)}, ${String(e)}): each is 0 to 255.`);return`#${[i,t,e].map(s=>s.toString(16).padStart(2,"0")).join("").toUpperCase()}`},{from_string:i=>j(i)});export class ColorFormat{read;write;constructor(t,e){return this.read=t,this.write=e,a(this,"ColorFormat")}get theme_color(){const t=this.read();return typeof t=="string"?t:void 0}set theme_color(t){this.write(t)}get rgb(){const t=this.read();return typeof t=="object"?t.rgb:void 0}set rgb(t){this.write(t===void 0?void 0:{rgb:j(t)})}}export class Font{def;constructor(t){return this.def=t,a(this,"Font")}_set(t,e){e===void 0?Reflect.deleteProperty(this.def,t):this.def[t]=e}get name(){return this.def.name}set name(t){this._set("name",t)}get size(){return this.def.size}set size(t){this._set("size",t)}get bold(){return this.def.bold}set bold(t){this._set("bold",t)}get italic(){return this.def.italic}set italic(t){this._set("italic",t)}get underline(){return this.def.underline}set underline(t){this._set("underline",t)}get spacing(){return this.def.spacing}set spacing(t){this._set("spacing",t)}get color(){return new ColorFormat(()=>this.def.rgb!==void 0?{rgb:this.def.rgb}:this.def.color,t=>{delete this.def.color,delete this.def.rgb,typeof t=="string"?this.def.color=t:t&&(this.def.rgb=t.rgb)})}}export class Run{def;constructor(t){return this.def=t,a(this,"_Run")}get text(){return this.def.text}set text(t){this.def.text=t}get font(){return this.def.font??={},new Font(this.def.font)}}const I=i=>{if(!Number.isFinite(i)||i<=0)throw new Error(`line_spacing ${String(i)} is not over 0.`);return Number.isInteger(i)&&i>=v?{fixed:i}:{lines:i}},D=i=>i===void 0?void 0:"lines"in i?i.lines:i.fixed,A=i=>i.split(/\n|\v/u).flatMap((t,e)=>[...e>0?[{text:"\v"}]:[],...t===""?[]:[{text:t}]]);class P{_set(t,e){e===void 0?Reflect.deleteProperty(this.fmt,t):this.fmt[t]=e}get alignment(){return this.fmt.alignment}set alignment(t){this._set("alignment",t)}get line_spacing(){return D(this.fmt.line_spacing)}set line_spacing(t){this._set("line_spacing",t===void 0?void 0:I(t))}get space_before(){return this.fmt.space_before}set space_before(t){this._set("space_before",t)}get space_after(){return this.fmt.space_after}set space_after(t){this._set("space_after",t)}get font(){return this.fmt.font??={},new Font(this.fmt.font)}}export class Paragraph extends P{fmt;constructor(t){return super(),this.fmt=t,a(this,"_Paragraph")}get text(){return this.fmt.runs.map(t=>t.text).join("")}set text(t){this.fmt.runs=A(t)}get runs(){return this.fmt.runs.filter(t=>t.text!=="\v").map(t=>new Run(t))}add_run(){const t={text:""};return this.fmt.runs.push(t),new Run(t)}add_line_break(){this.fmt.runs.push({text:"\v"})}clear(){return this.fmt.runs=[],this}get level(){return this.fmt.level}set level(t){if(!Number.isInteger(t)||t<0||t>8)throw new Error(`level ${String(t)} is not 0 to 8.`);this.fmt.level=t}}export class ListLevel extends P{fmt;constructor(t){return super(),this.fmt=t,a(this,"ListLevel")}get bullet(){return this.fmt.bullet}set bullet(t){this._set("bullet",t)}get bullet_font(){return this.fmt.bullet_font}set bullet_font(t){this._set("bullet_font",t)}get margin_left(){return this.fmt.margin_left}set margin_left(t){this._set("margin_left",t)}get indent(){return this.fmt.indent}set indent(t){this._set("indent",t)}}const y=i=>Object.freeze(i.map(t=>new ListLevel(t))),B=()=>Array.from({length:9},()=>({})),x=()=>({paragraphs:[],levels:B()});export class TextFrame{def;constructor(t){return this.def=t,a(this,"TextFrame")}_set(t,e){e===void 0?Reflect.deleteProperty(this.def,t):this.def[t]=e}get text(){return this.def.paragraphs.map(t=>t.runs.map(e=>e.text).join("")).join(`
+import{themeColor as O,themeColorOf as T}from"@allyhub-next/chart";import{presetAdjustments as z}from"@allyhub-next/ooxml/geometry";import{MSO_CONNECTOR as G,MSO_SHAPE as M,MSO_SHAPE_TYPE as I,PP_PLACEHOLDER as j}from"./enums.js";import{Chart as B}from"./chart-api.js";import{AUTOSHAPE_STYLE as p,SHADOW_DEFAULTS as v,CONNECTOR_GEOMETRIES as D,CONNECTOR_STYLE as P,FOOTER_IDX as H,isConnectorGeometry as R,OFFICE_TEXT_STYLES as U,placeholderLevels as X,TEXT_INSETS as w,TEXTBOX_FRAME as Y}from"./office.js";import{masterPlaceholder as A}from"./placeholders.js";import{strict as o}from"./strict.js";import{EMU_PER_PT as F,SLIDE_SIZES as k,length as d,lengthOr as y}from"./units.js";class J extends Error{constructor(t){super(`${t} (allyhub slides capabilities lists what the API holds).`),this.name="Unsupported"}}const m=i=>{throw new J(i)},Z=/^#?[0-9a-f]{6}$/iu,C=i=>{if(!Z.test(i))throw new Error(`rgb ${i} is not RRGGBB.`);return`#${i.replace("#","").toUpperCase()}`};export const RGBColor=Object.assign(function(t,e,s){for(const h of[t,e,s])if(!Number.isInteger(h)||h<0||h>255)throw new Error(`RGBColor(${String(t)}, ${String(e)}, ${String(s)}): each is 0 to 255.`);const r=`#${[t,e,s].map(h=>h.toString(16).padStart(2,"0")).join("").toUpperCase()}`;return new.target===void 0?r:new String(r)},{from_string:i=>C(i)});export class ColorFormat{read;write;constructor(t,e){return this.read=t,this.write=e,o(this,"ColorFormat")}get theme_color(){const t=this.read();return t===void 0?void 0:T(t)}set theme_color(t){this.write(t===void 0?void 0:O(t,this.brightness))}get brightness(){const t=this.read();return typeof t=="object"&&"brightness"in t?t.brightness:0}set brightness(t){if(!(t>=-1&&t<=1))throw new RangeError(`brightness ${String(t)} is not a number from -1.0 to 1.0.`);const e=this.read();if(e===void 0)throw new TypeError("There is no colour to set the brightness of: set theme_color first.");const s=T(e);if(s!==void 0)this.write(O(s,t));else if(t!==0)throw new TypeError("Only a theme colour has a brightness here, so an RGB colour does not: set theme_color first, or rgb to the colour it makes.")}get rgb(){const t=this.read();return typeof t=="object"&&"rgb"in t?t.rgb:void 0}set rgb(t){this.write(t===void 0?void 0:{rgb:C(t)})}}export class Font{def;constructor(t){return this.def=t,o(this,"Font")}_set(t,e){e===void 0?Reflect.deleteProperty(this.def,t):this.def[t]=e}get strike(){return this.def.strike}set strike(t){this._set("strike",t)}get baseline(){return this.def.baseline}set baseline(t){this._set("baseline",t)}get highlight(){return this.def.highlight}set highlight(t){this._set("highlight",t)}get name(){return this.def.name}set name(t){this._set("name",t)}get size(){return y(this.def.size)}set size(t){this._set("size",t)}get bold(){return this.def.bold}set bold(t){this._set("bold",t)}get italic(){return this.def.italic}set italic(t){this._set("italic",t)}get underline(){return this.def.underline}set underline(t){this._set("underline",t)}get spacing(){return y(this.def.spacing)}set spacing(t){this._set("spacing",t)}get color(){return new ColorFormat(()=>this.def.color,t=>{this._set("color",t)})}}export class Hyperlink{def;constructor(t){return this.def=t,o(this,"_Hyperlink")}get address(){return this.def.font?.link}set address(t){this.def.font??={},t===void 0?Reflect.deleteProperty(this.def.font,"link"):this.def.font.link=t}}export class Run{def;constructor(t){return this.def=t,o(this,"_Run")}get text(){return this.def.text}set text(t){this.def.text=t}get font(){return this.def.font??={},new Font(this.def.font)}get hyperlink(){return new Hyperlink(this.def)}}const q=i=>{if(!Number.isFinite(i)||i<=0)throw new Error(`line_spacing ${String(i)} is not over 0.`);return Number.isInteger(i)&&i>=F?{fixed:i}:{lines:i}},K=i=>i===void 0?void 0:"lines"in i?i.lines:d(i.fixed),N=i=>i.split(/\n|\v/u).flatMap((t,e)=>[...e>0?[{text:"\v"}]:[],...t===""?[]:[{text:t}]]);class L{_set(t,e){e===void 0?Reflect.deleteProperty(this.fmt,t):this.fmt[t]=e}get alignment(){return this.fmt.alignment}set alignment(t){this._set("alignment",t)}get line_spacing(){return K(this.fmt.line_spacing)}set line_spacing(t){this._set("line_spacing",t===void 0?void 0:q(t))}get space_before(){return y(this.fmt.space_before)}set space_before(t){this._set("space_before",t)}get space_after(){return y(this.fmt.space_after)}set space_after(t){this._set("space_after",t)}get font(){return this.fmt.font??={},new Font(this.fmt.font)}}export class Paragraph extends L{fmt;constructor(t){return super(),this.fmt=t,o(this,"_Paragraph")}get text(){return this.fmt.runs.map(t=>t.text).join("")}set text(t){this.fmt.runs=N(t)}get runs(){return this.fmt.runs.filter(t=>t.text!=="\v").map(t=>new Run(t))}add_run(){const t={text:""};return this.fmt.runs.push(t),new Run(t)}add_line_break(){this.fmt.runs.push({text:"\v"})}clear(){return this.fmt.runs=[],this}get level(){return this.fmt.level}set level(t){if(!Number.isInteger(t)||t<0||t>8)throw new Error(`level ${String(t)} is not 0 to 8.`);this.fmt.level=t}}export class ListLevel extends L{fmt;constructor(t){return super(),this.fmt=t,o(this,"ListLevel")}get numbered(){return this.fmt.numbered}set numbered(t){this._set("numbered",t)}get bullet(){return this.fmt.bullet}set bullet(t){this._set("bullet",t)}get bullet_font(){return this.fmt.bullet_font}set bullet_font(t){this._set("bullet_font",t)}get margin_left(){return y(this.fmt.margin_left)}set margin_left(t){this._set("margin_left",t)}get indent(){return y(this.fmt.indent)}set indent(t){this._set("indent",t)}}const S=i=>Object.freeze(i.map(t=>new ListLevel(t))),W=()=>Array.from({length:9},()=>({})),E=()=>({paragraphs:[],levels:W()});export class TextFrame{def;constructor(t){return this.def=t,o(this,"TextFrame")}_set(t,e){e===void 0?Reflect.deleteProperty(this.def,t):this.def[t]=e}get text(){return this.def.paragraphs.map(t=>t.runs.map(e=>e.text).join("")).join(`
 `)}set text(t){this.def.paragraphs=t.split(`
-`).map(e=>({runs:A(e),level:0}))}get paragraphs(){return this.def.paragraphs.length===0&&this.def.paragraphs.push({runs:[],level:0}),this.def.paragraphs.map(t=>new Paragraph(t))}add_paragraph(){this.def.paragraphs.length===0&&this.def.paragraphs.push({runs:[],level:0});const t={runs:[],level:0};return this.def.paragraphs.push(t),new Paragraph(t)}clear(){const t=this.def.paragraphs[0];this.def.paragraphs=t?[{...t,runs:[]}]:[]}fit_text(t,e=18,s,r){this.def.auto_size="text",this.def.word_wrap=!0;for(const n of this.def.paragraphs)for(const h of n.runs)h.font={...h.font,size:Math.trunc(e*v),...t===void 0?{}:{name:t},...s===void 0?{}:{bold:s},...r===void 0?{}:{italic:r}}}get list_style(){return y(this.def.levels)}get vertical_anchor(){return this.def.vertical_anchor}set vertical_anchor(t){this._set("vertical_anchor",t)}get auto_size(){return this.def.auto_size}set auto_size(t){this._set("auto_size",t)}get word_wrap(){return this.def.word_wrap}set word_wrap(t){this._set("word_wrap",t)}get margin_left(){return this.def.margin_left??_.left}set margin_left(t){this.def.margin_left=t}get margin_top(){return this.def.margin_top??_.top}set margin_top(t){this.def.margin_top=t}get margin_right(){return this.def.margin_right??_.right}set margin_right(t){this.def.margin_right=t}get margin_bottom(){return this.def.margin_bottom??_.bottom}set margin_bottom(t){this.def.margin_bottom=t}}export class FillFormat{read;write;start;constructor(t,e,s="lt1"){return this.read=t,this.write=e,this.start=s,a(this,"FillFormat")}solid(){const t=this.read();t==null&&this.write(this.start)}background(){this.write(null)}get type(){const t=this.read();return t===void 0?void 0:t===null?"background":"solid"}get fore_color(){const t=this.read();if(t==null)throw new TypeError("This fill is not solid, so it has no fore_color: call fill.solid() first.");return new ColorFormat(()=>this.read()??void 0,e=>{this.write(e??this.start)})}}export class LineFormat{def;constructor(t){return this.def=t,a(this,"LineFormat")}get color(){return new ColorFormat(()=>this.def.line??void 0,t=>{this.def.line=t??null})}get fill(){return new FillFormat(()=>this.def.line,t=>{this.def.line=t},"dk1")}get width(){return this.def.line_width??0}set width(t){this.def.line_width=t}get dash_style(){return this.def.line_dash??null}set dash_style(t){t===null?delete this.def.line_dash:this.def.line_dash=t}get begin_arrow(){return this.def.line_begin??"none"}set begin_arrow(t){this.def.line_begin=t}get end_arrow(){return this.def.line_end??"none"}set end_arrow(t){this.def.line_end=t}}export class Background{holder;constructor(t){return this.holder=t,a(this,"_Background")}get fill(){return new FillFormat(()=>this.holder.background,t=>{this.holder.background=t??"lt1"})}}export const ADJUSTMENT_DEFAULTS={roundRect:[.16667]};export class Adjustments{def;constructor(t){return this.def=t,a(this,"Adjustments",{index:e=>this._values()[e],setIndex:(e,s)=>{this._set(e,Number(s))}})}_values(){return this.def.adjustments??[...ADJUSTMENT_DEFAULTS[this.def.geometry??"rect"]??[]]}get length(){return this._values().length}_set(t,e){const s=this._values();if(t<0||t>=s.length)throw new RangeError(`adjustments[${String(t)}]: ${this.def.geometry??"this shape"} has ${String(s.length)}.`);if(!Number.isFinite(e))throw new Error(`adjustments[${String(t)}] = ${String(e)} is not a number.`);s[t]=e,this.def.adjustments=s}}const U={left:0,top:0,width:0,height:0};export class Shape{def;inherit;constructor(t,e=()=>{}){return this.def=t,this.inherit=e,a(this,"Shape")}get _def(){return this.def}_frame(){return this.def.frame??this.inherit()??U}_own(){return this.def.frame??={...this._frame()},this.def.frame}get name(){return this.def.name}set name(t){this.def.name=t}get shape_type(){return this.def.path?"freeform":this.def.geometry==="line"?"line":this.def.kind}get is_placeholder(){return this.def.kind==="placeholder"}get has_table(){return this.def.table!==void 0}get has_chart(){return this.def.chart!==void 0}get chart(){if(!this.def.chart)throw new Error(`${this.def.name} is not a chart.`);return new R(this.def.chart)}get table(){if(!this.def.table)throw new Error(`${this.def.name} is not a table.`);return new Table(this.def.table)}get placeholder_format(){if(!this.def.placeholder)throw new Error(`${this.def.name} is not a placeholder.`);return{...this.def.placeholder}}get left(){return this._frame().left}set left(t){this._own().left=t}get top(){return this._frame().top}set top(t){this._own().top=t}get width(){return this._frame().width}set width(t){this._own().width=t}get height(){return this._frame().height}set height(t){this._own().height=t}get rotation(){return this.def.rotation??0}set rotation(t){if(!Number.isFinite(t))throw new Error(`${this.def.name}: rotation is a number of degrees.`);const e=(Math.trunc(t*6e4)%216e5+216e5)%216e5/6e4;e===0?Reflect.deleteProperty(this.def,"rotation"):this.def.rotation=e}get has_text_frame(){return this.def.text!==void 0}get text_frame(){if(!this.def.text)throw new Error(`${this.def.name} (a ${this.shape_type}) has no text frame: has_text_frame is false.`);return new TextFrame(this.def.text)}get text(){return this.text_frame.text}set text(t){this.text_frame.text=t}get fill(){return new FillFormat(()=>this.def.fill,t=>{this.def.fill=t})}get line(){return new LineFormat(this.def)}get adjustments(){return new Adjustments(this.def)}}const H=i=>typeof i=="number"&&Number.isFinite(i),p=(i,t,e,s,{line:r=!1}={})=>{for(const[n,h]of Object.entries({left:i,top:t,width:e,height:s}))if(!H(h))throw new Error(`${n} ${String(h)} is not a length (Emu, Inches, Pt, Cm, Mm).`);if(r?e<0||s<0:e<=0||s<=0)throw new Error("A shape's width and height are over 0.");return{left:Math.trunc(i),top:Math.trunc(t),width:Math.trunc(e),height:Math.trunc(s)}},X=new Set(Object.values($));export class FreeformBuilder{steps;sx;sy;make;constructor(t,e,s){return this.steps=[{op:"move",x:t[0],y:t[1]}],[this.sx,this.sy]=typeof e=="number"?[e,e]:e,this.make=s,a(this,"FreeformBuilder")}add_line_segments(t,e=!0){for(const[s,r]of t)this.steps.push({op:"line",x:s,y:r});return e&&this.steps.push({op:"close"}),this}add_curve_segment(t,e,s,r,n,h){return this.steps.push({op:"curve",x1:t,y1:e,x2:s,y2:r,x:n,y:h}),this}move_to(t,e){return this.steps.push({op:"move",x:t,y:e}),this}convert_to_shape(t=0,e=0){this.steps.length<2&&m("convert_to_shape(): a freeform needs a segment.");const s=this.steps.flatMap(o=>o.op==="close"?[]:o.op==="curve"?[[o.x1,o.y1],[o.x2,o.y2],[o.x,o.y]]:[[o.x,o.y]]),r=s.map(o=>o[0]),n=s.map(o=>o[1]),h=Math.min(...r),d=Math.min(...n),l=Math.max(...r)-h,f=Math.max(...n)-d,u=(o,g)=>({x:o-h,y:g-d});return this.make({w:l,h:f,steps:this.steps.map(o=>{if(o.op==="close")return o;if(o.op!=="curve")return{op:o.op,...u(o.x,o.y)};const g=u(o.x1,o.y1),b=u(o.x2,o.y2);return{op:"curve",x1:g.x,y1:g.y,x2:b.x,y2:b.y,...u(o.x,o.y)}})},p(Math.round(h*this.sx)+t,Math.round(d*this.sy)+e,Math.round(l*this.sx),Math.round(f*this.sy)))}}export class GroupShape{list;_name;make;constructor(t,e,s){return this.list=t,this._name=e,this.make=s,a(this,"GroupShape")}members(){return this.list.filter(t=>t.group===this._name)}box(){const t=this.members().flatMap(r=>r.frame?[r.frame]:[]),e=Math.min(...t.map(r=>r.left)),s=Math.min(...t.map(r=>r.top));return{left:t.length>0?e:0,top:t.length>0?s:0,right:Math.max(0,...t.map(r=>r.left+r.width)),bottom:Math.max(0,...t.map(r=>r.top+r.height))}}get shapes(){return this.make(this._name)}get shape_type(){return F.GROUP}get name(){return this._name}set name(t){for(const e of this.members())e.group=t;this._name=t}get left(){return this.box().left}set left(t){const e=t-this.box().left;for(const s of this.members())s.frame&&(s.frame.left+=e)}get top(){return this.box().top}set top(t){const e=t-this.box().top;for(const s of this.members())s.frame&&(s.frame.top+=e)}get width(){const t=this.box();return t.right-t.left}get height(){const t=this.box();return t.bottom-t.top}}export class Cell{def;table;row;col;constructor(t,e,s,r){return this.def=t,this.table=e,this.row=s,this.col=r,a(this,"_Cell")}get text_frame(){return new TextFrame(this.def.text)}get text(){return this.text_frame.text}set text(t){this.text_frame.text=t}get fill(){return new FillFormat(()=>this.def.fill,t=>{this.def.fill=t})}get borders(){return this.def.borders??{}}set borders(t){this.def.borders=t}get margin_left(){return this.def.text.margin_left??_.left}set margin_left(t){this.def.text.margin_left=t}get margin_right(){return this.def.text.margin_right??_.right}set margin_right(t){this.def.text.margin_right=t}get margin_top(){return this.def.text.margin_top??_.top}set margin_top(t){this.def.text.margin_top=t}get margin_bottom(){return this.def.text.margin_bottom??_.bottom}set margin_bottom(t){this.def.text.margin_bottom=t}get vertical_anchor(){return this.def.text.vertical_anchor}set vertical_anchor(t){t===void 0?delete this.def.text.vertical_anchor:this.def.text.vertical_anchor=t}get is_merge_origin(){return(this.def.span_width??1)>1||(this.def.span_height??1)>1}get is_spanned(){return this.def.spanned===!0}get span_width(){return this.def.span_width??1}get span_height(){return this.def.span_height??1}merge(t){const e=[this.row,t.row].sort((l,f)=>l-f),s=[this.col,t.col].sort((l,f)=>l-f),[r=0,n=0]=e,[h=0,d=0]=s;for(let l=r;l<=n;l++)for(let f=h;f<=d;f++){const u=this.table.rows[l]?.cells[f];u&&(l===r&&f===h?(d>h&&(u.span_width=d-h+1),n>r&&(u.span_height=n-r+1)):u.spanned=!0)}}split(){const t=this.span_width,e=this.span_height;delete this.def.span_width,delete this.def.span_height;for(let s=this.row;s<this.row+e;s++)for(let r=this.col;r<this.col+t;r++){const n=this.table.rows[s]?.cells[r];n&&delete n.spanned}}}export class Column{def;at;constructor(t,e){return this.def=t,this.at=e,a(this,"_Column")}get width(){return this.def.columns[this.at]??0}set width(t){this.def.columns[this.at]=t}}export class Row{def;at;constructor(t,e){return this.def=t,this.at=e,a(this,"_Row")}get row(){const t=this.def.rows[this.at];if(!t)throw new Error(`The table has no row ${String(this.at)}.`);return t}get height(){return this.row.height}set height(t){this.row.height=t}}export class Table{def;constructor(t){return this.def=t,a(this,"Table")}cell(t,e){const s=this.def.rows[t]?.cells[e];if(!s)throw new Error(`cell(): the table has ${String(this.def.rows.length)} rows and ${String(this.def.columns.length)} columns.`);return new Cell(s,this.def,t,e)}*iter_cells(){for(let t=0;t<this.def.rows.length;t++)for(let e=0;e<this.def.columns.length;e++)yield this.cell(t,e)}get columns(){return this.def.columns.map((t,e)=>new Column(this.def,e))}get rows(){return this.def.rows.map((t,e)=>new Row(this.def,e))}flag(t){return this.def[t]===!0}get first_row(){return this.flag("first_row")}set first_row(t){this.def.first_row=t}get first_col(){return this.flag("first_col")}set first_col(t){this.def.first_col=t}get last_row(){return this.flag("last_row")}set last_row(t){this.def.last_row=t}get last_col(){return this.flag("last_col")}set last_col(t){this.def.last_col=t}get horz_banding(){return this.flag("horz_banding")}set horz_banding(t){this.def.horz_banding=t}get vert_banding(){return this.flag("vert_banding")}set vert_banding(t){this.def.vert_banding=t}}function J(i,t,e=[]){const s=new Set([...i,...e].map(n=>n.name));let r=1;for(;s.has(`${t}-${String(r)}`);)r++;return`${t}-${String(r)}`}export class ShapeCollection{list;base;components;inherit;group;under;constructor(t,e,s,r=()=>{},n=()=>[],h){return this.list=t,this.base=e,this.components=s,this.inherit=r,this.under=n,this.group=h,a(this,"SlideShapes",{index:d=>this._at(d)})}_wrap(t){return new Shape(t,()=>this.inherit(t))}_at(t){const e=this.list[t];return e?this._wrap(e):void 0}*[Symbol.iterator](){for(const t of this.list)yield this._wrap(t)}get length(){return this.list.length}get(t){const e=this.list.find(s=>s.name===t);return e?this._wrap(e):void 0}get title(){const t=this.list.find(e=>e.placeholder?.type==="title"||e.placeholder?.type==="ctrTitle");return t?this._wrap(t):void 0}get placeholders(){return new Placeholders(this.list,this.inherit)}_add(t,e){const s={name:J(this.list,t,this.under()),...e,...this.group===void 0?{}:{group:this.group}};return this.list.push(s),this._wrap(s)}add_textbox(t,e,s,r){return this._add("textbox",{kind:"textbox",frame:p(t,e,s,r),text:{...x(),...z}})}add_picture(t,e,s,r,n){return(r===void 0||n===void 0)&&m("add_picture() takes a width and a height here: a picture's own size is not read while a deck's code runs"),this._add("picture",{kind:"picture",frame:p(e,s,r??0,n??0),media:{path:t,base:this.base}})}add_movie(t,e,s,r,n,h={}){return this._add("movie",{kind:"movie",frame:p(e,s,r,n),media:{path:t,base:this.base,...h.poster_frame_time===void 0?{}:{poster:h.poster_frame_time}}})}add_shape(t,e,s,r,n){X.has(t)||m(`add_shape(): ${t} is not one of MSO_SHAPE's ${Object.keys($).join(", ")}`);const h=x();return h.vertical_anchor=c.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:c.alignment}],this._add("shape",{kind:"autoshape",frame:p(e,s,r,n),geometry:t,fill:c.fill,line:c.line,line_width:c.line_width,text:h})}add_table(t,e,s,r,n,h){(t<1||e<1)&&m("add_table(): a table has at least a row and a column.");const d=Math.floor(n/e),l=Math.floor(h/t);return this._add("table",{kind:"table",frame:p(s,r,n,h),table:{columns:Array.from({length:e},()=>d),rows:Array.from({length:t},()=>({height:l,cells:Array.from({length:e},()=>({text:x()}))}))}})}add_chart(t,e,s,r,n,h){return this._add("chart",{kind:"chart",frame:p(e,s,r,n),chart:{type:t,categories:[...h.categories],series:h._series()}})}add_group_shape(){this.group!==void 0&&m("add_group_shape(): a group here holds shapes, not another group.");let t=1;for(;this.list.some(e=>e.group===`group-${String(t)}`);)t++;return new GroupShape(this.list,`group-${String(t)}`,e=>new ShapeCollection(this.list,this.base,this.components,this.inherit,this.under,e))}build_freeform(t=0,e=0,s=1){return new FreeformBuilder([t,e],s,(r,n)=>{const h=x();return h.vertical_anchor=c.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:c.alignment}],this._add("freeform",{kind:"autoshape",frame:n,path:r,fill:c.fill,line:c.line,line_width:c.line_width,text:h})})}add_connector(t,e,s,r,n){t!==k.STRAIGHT&&m(`add_connector(): ${t} is not one of MSO_CONNECTOR's ${Object.keys(k).join(", ")}`);const h=p(Math.min(e,r),Math.min(s,n),Math.abs(r-e),Math.abs(n-s),{line:!0}),d=r<e,l=n<s;return this._add("connector",{kind:"autoshape",frame:h,geometry:"line",...d||l?{flip:{...d?{h:d}:{},...l?{v:l}:{}}}:{},line:O.line,line_width:O.line_width})}add_component(t,e,s,r,n,h={}){if(!Object.hasOwn(this.components(),t))throw new Error(`add_component(): the presentation has no component ${t}; add it with prs.components.add("${t}", { … }) first.`);return this._add(t,{kind:"component",frame:p(e,s,r,n),component:{name:t,props:h}})}}export const NAME_OF_TYPE={title:"title",ctrTitle:"title",subTitle:"subtitle",body:"body",pic:"picture",media:"media",obj:"content",dt:"date",ftr:"footer",sldNum:"slide-number"};export class Placeholders{list;inherit;constructor(t,e=()=>{}){return this.list=t,this.inherit=e,a(this,"placeholders",{index:s=>this.get(s)})}_wrap(t){return new Shape(t,()=>this.inherit(t))}*[Symbol.iterator](){for(const t of this.list)t.kind==="placeholder"&&(yield this._wrap(t))}get length(){return this.list.filter(t=>t.kind==="placeholder").length}get(t){const e=this.list.find(s=>s.kind==="placeholder"&&(typeof t=="number"?s.placeholder?.idx===t:s.name===t||s.placeholder?.type===t));return e?this._wrap(e):void 0}add(t,e,s,r,n,h={}){const d=typeof e=="object"?e:h,l=typeof e=="object"?void 0:e;Object.values(M).includes(t)||m(`placeholders.add(): ${t} is not one of PP_PLACEHOLDER's ${Object.keys(M).join(", ")}`);const f=this.list.filter(w=>w.kind==="placeholder"),u=new Set(f.map(w=>w.placeholder?.idx));let o=t==="title"||t==="ctrTitle"?0:L[t]??1;for(;u.has(o)&&o!==0;)o++;if(u.has(o))throw new Error("A layout has one title placeholder (idx 0).");const g=d.name??NAME_OF_TYPE[t];if(this.list.some(w=>w.name===g))throw new Error(`Two shapes are ${g}: give the placeholder a name ({ name }).`);const b=[l,s,r,n].filter(w=>w!==void 0);if(b.length!==0&&b.length!==4)throw new Error("placeholders.add(type, left, top, width, height): give all four, or none to take the master's frame.");const E={name:g,kind:"placeholder",placeholder:{type:t,idx:o},...b.length===4?{frame:p(l??0,s??0,r??0,n??0)}:{},text:x()};return this.list.push(E),this._wrap(E)}}export class SlideLayout{def;master;ctx;constructor(t,e,s){return this.def=t,this.master=e,this.ctx=s,a(this,"SlideLayout")}get _def(){return this.def}inherit=t=>t.placeholder?T(this.master._def,t.placeholder.type)?.frame:void 0;get name(){return this.def.name}get slide_master(){return this.master}get display_master_shapes(){return this.def.display_master_shapes??!0}set display_master_shapes(t){t?delete this.def.display_master_shapes:this.def.display_master_shapes=!1}get background(){return new Background(this.def)}get placeholders(){return new Placeholders(this.def.shapes,this.inherit)}get shapes(){return new ShapeCollection(this.def.shapes,this.ctx.base,this.ctx.components,this.inherit,()=>this.master._def.shapes)}}export class SlideLayouts{list;make;constructor(t,e){return this.list=t,this.make=e,a(this,"SlideLayouts",{index:s=>this.list[s]})}*[Symbol.iterator](){yield*this.list}get length(){return this.list.length}get_by_name(t,e){return this.list.find(s=>s.name===t)??e}index(t){const e=this.list.indexOf(t);if(e<0)throw new Error(`${t.name} is not among these layouts.`);return e}add(t,e){if(!this.make)throw new Error("A layout is added to a master: master.slide_layouts.add(name).");const s=this.make(t);return e?.(s),s}}export class TextStyles{def;constructor(t){return this.def=t,a(this,"text_styles")}get title_style(){return y(this.def.title)}get body_style(){return y(this.def.body)}get other_style(){return y(this.def.other)}}export class SlideMaster{def;layouts=[];ctx;allLayouts;constructor(t,e,s){return this.def=t,this.ctx=e,this.allLayouts=s,a(this,"SlideMaster")}get _def(){return this.def}get name(){return this.def.name}get background(){return new Background(this.def)}get placeholders(){return new Placeholders(this.def.shapes)}get shapes(){return new ShapeCollection(this.def.shapes,this.ctx.base,this.ctx.components)}get text_styles(){return new TextStyles(this.def.text_styles)}get slide_layouts(){return new SlideLayouts(this.layouts,t=>{if(this.allLayouts.some(r=>r.name===t))throw new Error(`Two layouts are "${t}": a layout's name is unique in the deck, as slides.yaml names it.`);const e={name:t,master:this.def.name,shapes:[]};this.def.layouts.push(e);const s=new SlideLayout(e,this,this.ctx);return this.layouts.push(s),this.allLayouts.push(s),s})}}export class SlideMasters{list;make;constructor(t,e){return this.list=t,this.make=e,a(this,"SlideMasters",{index:s=>this.list[s]})}*[Symbol.iterator](){yield*this.list}get length(){return this.list.length}index(t){return this.list.indexOf(t)}add(t,e){const s=this.make(t);return e?.(s),s}}export class GeneratedSlide{own;def;layout;constructor(t,e,s){this.def=t,this.layout=e,this.own=e._def.shapes.filter(n=>n.kind==="placeholder").map(n=>({name:n.name,kind:"placeholder",...n.placeholder?{placeholder:{...n.placeholder}}:{},text:x()}));const r=n=>{const h=e._def.shapes.find(d=>d.kind==="placeholder"&&d.placeholder?.idx===n.placeholder?.idx);return h?h.frame??(h.placeholder?T(e.slide_master._def,h.placeholder.type)?.frame:void 0):void 0};return this._shapes=new ShapeCollection(this.own,s.base,s.components,r,()=>[...e.slide_master._def.shapes,...e._def.shapes]),this._placeholders=new Placeholders(this.own,r),a(this,"Slide")}_shapes;_placeholders;get shapes(){return this._shapes}get placeholders(){return this._placeholders}get slide_id(){return this.def.id}get slide_layout(){return this.layout}get has_notes_slide(){return this.def.notes!==void 0}get notes_slide(){const t=this.def;return{notes_text_frame:{get text(){return t.notes??""},set text(e){t.notes=e}}}}get transition(){return this.def.transition}set transition(t){t===void 0?delete this.def.transition:this.def.transition=t}get animations(){return new Animations(this.def.animations??=[])}_done(){const t={},e=[];for(const s of this.own)s.kind==="placeholder"&&s.placeholder?(s.text?.paragraphs.some(r=>r.runs.length>0)&&(t[s.placeholder.idx]=s.text.paragraphs),s.frame&&e.push({...s,text:x()})):e.push(s);return{...this.def,shapes:e,text:t}}}export class Animations{list;constructor(t){return this.list=t,a(this,"Animations")}add(t,e,s={}){this.list.push({shape:typeof t=="string"?t:t.name,effect:e,...s})}get length(){return this.list.length}}class Y{gen;constructor(t){return this.gen=t,a(this,"slides")}add_slide(t,e){return this.gen._add(t,e)}}export class Generator{list=[];prs;ctx;constructor(t,e){return this.prs=t,this.ctx=e,a(this,"Generator")}data(t){return this.ctx.data(t)}get slides(){return new Y(this)}_add(t,e){const s=typeof t=="string"?this.prs._layout(t):t;if(!s)throw new Error(`add_slide(): the presentation has no layout ${typeof t=="string"?t:t.name}.`);if(!/^[A-Za-z0-9_-]+$/u.test(e))throw new Error(`add_slide(): ${e} is not an id of letters, digits, _ and -.`);if(this.list.some(n=>n.slide_id===e))throw new Error(`add_slide(): two slides are ${e}.`);const r=new GeneratedSlide({id:e,layout:s.name,shapes:[],text:{}},s,this.prs._ctx);return this.list.push(r),r}_made(){return this.list.map(t=>t._done())}}const Z=()=>JSON.parse(JSON.stringify(N));export class Presentation{masters=[];layouts=[];def;_ctx;constructor(t,e){return this.def={slide_width:t[0],slide_height:t[1],masters:[],components:{},generators:{}},this._ctx={base:e,components:()=>this.def.components},a(this,"Presentation")}get _def(){return this.def}get slide_width(){return this.def.slide_width}set slide_width(t){this.def.slide_width=t}get slide_height(){return this.def.slide_height}set slide_height(t){this.def.slide_height=t}get slide_masters(){return new SlideMasters(this.masters,t=>{if(this.masters.some(r=>r.name===t))throw new Error(`Two masters are "${t}".`);const e={name:t,background:"lt1",text_styles:Z(),shapes:[],layouts:[]};this.def.masters.push(e);const s=new SlideMaster(e,this._ctx,this.layouts);return this.masters.push(s),s})}get slide_master(){const t=this.masters[0];if(!t)throw new Error("The presentation has no master yet: prs.slide_masters.add(name) makes one.");return t}get slide_layouts(){const t=this.masters[0];return t?t.slide_layouts:new SlideLayouts([])}get slides(){return m("A deck's slides are slides.yaml's, in order, each on a layout, and their words the script's; slides made from data are a generator's (prs.generators.add)")}save(){return m("A deck is not saved by its code: allyhub render writes its PDF, pictures and PPTX")}get theme(){return this.def.theme??={},this.def.theme}set theme(t){this.def.theme=t}get components(){return a({add:(t,e)=>{if(Object.hasOwn(this.def.components,t))throw new Error(`Two components are "${t}".`);if(typeof e.layers!="function")throw new Error(`Component ${t} draws with its layers function.`);this.def.components[t]={name:t,props:e.props??{},layers:e.layers}}},"components")}get generators(){return a({add:(t,e)=>{if(Object.hasOwn(this.def.generators,t))throw new Error(`Two generators are "${t}".`);this.def.generators[t]={name:t,make:s=>{const r=new Generator(this,s);return e(r),r._made()}}}},"generators")}_layout(t){return this.layouts.find(e=>e.name===t)}}export const DECK_BRAND="__allyhubDeck";export function isDeck(i){return typeof i=="object"&&i!==null&&DECK_BRAND in i}export const presentationFor=i=>(t,e)=>{const[s,r]=typeof t=="function"?[{},t]:[t,e];if(typeof r!="function")throw new Error("An item's slides.ts exports one deck: export default presentation({ size }, (prs) => { … masters, layouts, components … }); its slides are slides.yaml.");if(typeof s.size=="string"&&!Object.hasOwn(S,s.size))throw new Error(`presentation(): size ${s.size} is not one of ${Object.keys(S).join(", ")}, or { width, height } in EMU.`);return{[DECK_BRAND]:!0,kind:"slides",options:s,build:r,written:{file:i}}};export function evaluateDeck(i){const t=i.options.size??"16:9",e=typeof t=="string"?S[t]:[t.width,t.height],s=i.written.file.split("/").slice(0,-1).join("/"),r=new Presentation(e,s);return i.options.theme&&(r.theme=JSON.parse(JSON.stringify(i.options.theme))),i.build(r),r._def}
+`).map(e=>({runs:N(e),level:0}))}get paragraphs(){return this.def.paragraphs.length===0&&this.def.paragraphs.push({runs:[],level:0}),this.def.paragraphs.map(t=>new Paragraph(t))}add_paragraph(){this.def.paragraphs.length===0&&this.def.paragraphs.push({runs:[],level:0});const t={runs:[],level:0};return this.def.paragraphs.push(t),new Paragraph(t)}clear(){const t=this.def.paragraphs[0];this.def.paragraphs=t?[{...t,runs:[]}]:[]}fit_text(t,e=18,s,r){this.def.auto_size="text",this.def.word_wrap=!0;for(const n of this.def.paragraphs)for(const h of n.runs)h.font={...h.font,size:Math.trunc(e*F),...t===void 0?{}:{name:t},...s===void 0?{}:{bold:s},...r===void 0?{}:{italic:r}}}get list_style(){return S(this.def.levels)}get vertical_anchor(){return this.def.vertical_anchor}set vertical_anchor(t){this._set("vertical_anchor",t)}get auto_size(){return this.def.auto_size}set auto_size(t){this._set("auto_size",t)}get word_wrap(){return this.def.word_wrap}set word_wrap(t){this._set("word_wrap",t)}get margin_left(){return d(this.def.margin_left??w.left)}set margin_left(t){this.def.margin_left=t}get margin_top(){return d(this.def.margin_top??w.top)}set margin_top(t){this.def.margin_top=t}get margin_right(){return d(this.def.margin_right??w.right)}set margin_right(t){this.def.margin_right=t}get margin_bottom(){return d(this.def.margin_bottom??w.bottom)}set margin_bottom(t){this.def.margin_bottom=t}}export class FillFormat{read;write;start;shape;constructor(t,e,s="lt1",r){return this.read=t,this.write=e,this.start=s,this.shape=r,o(this,"FillFormat")}solid(){const t=this.read();this.shape&&Reflect.deleteProperty(this.shape,"gradient"),t==null&&this.write(this.start)}background(){this.shape&&Reflect.deleteProperty(this.shape,"gradient"),this.write(null)}_shape(t){if(!this.shape)throw new TypeError(`Only a shape's fill has ${t}.`);return this.shape}gradient(){this._shape("a gradient").gradient??={angle:90,stops:[{at:0,color:"accent1"},{at:1,color:"accent2"}]}}get gradient_angle(){return this._gradient().angle}set gradient_angle(t){this._gradient().angle=t}get gradient_stops(){return this._gradient().stops}set gradient_stops(t){if(t.length<2)throw new Error("A gradient has two stops at least.");this._gradient().stops=t.map(e=>({...e}))}_gradient(){const{gradient:t}=this._shape("a gradient");if(!t)throw new TypeError("This fill is no gradient: call fill.gradient() first.");return t}get transparency(){return this._shape("a transparency").fill_transparency??0}set transparency(t){if(!(t>=0&&t<=1))throw new Error(`A transparency is a share, 0 to 1, not ${String(t)}.`);this._shape("a transparency").fill_transparency=t}get type(){if(this.shape?.gradient)return"gradient";const t=this.read();return t===void 0?void 0:t===null?"background":"solid"}get fore_color(){const t=this.read();if(t==null)throw new TypeError("This fill is not solid, so it has no fore_color: call fill.solid() first.");return new ColorFormat(()=>this.read()??void 0,e=>{this.write(e??this.start)})}}export class ShadowFormat{def;constructor(t){return this.def=t,o(this,"ShadowFormat")}_shadow(){return this.def.shadow??={...v},this.def.shadow}get inherit(){return this.def.shadow===void 0}set inherit(t){t?Reflect.deleteProperty(this.def,"shadow"):this._shadow()}get blur_radius(){return d(this._shadow().blur)}set blur_radius(t){this._shadow().blur=t}get distance(){return d(this._shadow().distance)}set distance(t){this._shadow().distance=t}get angle(){return this._shadow().angle}set angle(t){this._shadow().angle=t}get transparency(){return this._shadow().transparency}set transparency(t){this._shadow().transparency=t}get color(){const t=this._shadow();return new ColorFormat(()=>t.color,e=>{t.color=e??v.color})}}export class LineFormat{def;constructor(t){return this.def=t,o(this,"LineFormat")}get color(){return new ColorFormat(()=>this.def.line??void 0,t=>{this.def.line=t??null})}get fill(){return new FillFormat(()=>this.def.line,t=>{this.def.line=t},"dk1")}get width(){return d(this.def.line_width??0)}set width(t){this.def.line_width=t}get dash_style(){return this.def.line_dash??null}set dash_style(t){t===null?delete this.def.line_dash:this.def.line_dash=t}get begin_arrow(){return this.def.line_begin??"none"}set begin_arrow(t){this.def.line_begin=t}get end_arrow(){return this.def.line_end??"none"}set end_arrow(t){this.def.line_end=t}}export class Background{holder;constructor(t){return this.holder=t,o(this,"_Background")}get fill(){return new FillFormat(()=>this.holder.background,t=>{this.holder.background=t??"lt1"})}}export const adjustmentDefaults=i=>z(i).map(t=>t.value/1e5);export class Adjustments{def;constructor(t){return this.def=t,o(this,"Adjustments",{index:e=>this._values()[e],setIndex:(e,s)=>{this._set(e,Number(s))}})}_values(){return this.def.adjustments??adjustmentDefaults(this.def.geometry??"rect")}get length(){return this._values().length}_set(t,e){const s=this._values();if(t<0||t>=s.length)throw new RangeError(`adjustments[${String(t)}]: ${this.def.geometry??"this shape"} has ${String(s.length)}.`);if(!Number.isFinite(e))throw new Error(`adjustments[${String(t)}] = ${String(e)} is not a number.`);s[t]=e,this.def.adjustments=s}}const Q={left:0,top:0,width:0,height:0};export class Shape{def;inherit;constructor(t,e=()=>{}){return this.def=t,this.inherit=e,o(this,"Shape")}get _def(){return this.def}_frame(){return this.def.frame??this.inherit()??Q}_own(){return this.def.frame??={...this._frame()},this.def.frame}get name(){return this.def.name}set name(t){this.def.name=t}get shape_type(){return this.def.path?"freeform":R(this.def.geometry)?"line":this.def.kind}get is_placeholder(){return this.def.kind==="placeholder"}get has_table(){return this.def.table!==void 0}get has_chart(){return this.def.chart!==void 0}get chart(){if(!this.def.chart)throw new Error(`${this.def.name} is not a chart.`);return new B(this.def.chart)}get table(){if(!this.def.table)throw new Error(`${this.def.name} is not a table.`);return new Table(this.def.table)}get placeholder_format(){if(!this.def.placeholder)throw new Error(`${this.def.name} is not a placeholder.`);return o({...this.def.placeholder},"_PlaceholderFormat")}get left(){return d(this._frame().left)}set left(t){this._own().left=t}get top(){return d(this._frame().top)}set top(t){this._own().top=t}get width(){return d(this._frame().width)}set width(t){this._own().width=t}get height(){return d(this._frame().height)}set height(t){this._own().height=t}get rotation(){return this.def.rotation??0}set rotation(t){if(!Number.isFinite(t))throw new Error(`${this.def.name}: rotation is a number of degrees.`);const e=(Math.trunc(t*6e4)%216e5+216e5)%216e5/6e4;e===0?Reflect.deleteProperty(this.def,"rotation"):this.def.rotation=e}get has_text_frame(){return this.def.text!==void 0}get text_frame(){if(!this.def.text)throw new Error(`${this.def.name} (a ${this.shape_type}) has no text frame: has_text_frame is false.`);return new TextFrame(this.def.text)}get text(){return this.text_frame.text}set text(t){this.text_frame.text=t}get fill(){return new FillFormat(()=>this.def.fill,t=>{this.def.fill=t},"lt1",this.def)}get line(){return new LineFormat(this.def)}get shadow(){return new ShadowFormat(this.def)}get adjustments(){return new Adjustments(this.def)}}const V=i=>typeof i=="number"&&Number.isFinite(i),g=(i,t,e,s,{line:r=!1}={})=>{for(const[n,h]of Object.entries({left:i,top:t,width:e,height:s}))if(!V(h))throw new Error(`${n} ${String(h)} is not a length (Emu, Inches, Pt, Cm, Mm).`);if(r?e<0||s<0:e<=0||s<=0)throw new Error("A shape's width and height are over 0.");return{left:Math.trunc(i),top:Math.trunc(t),width:Math.trunc(e),height:Math.trunc(s)}},tt=new Set(Object.values(M));export class FreeformBuilder{steps;sx;sy;make;constructor(t,e,s){return this.steps=[{op:"move",x:t[0],y:t[1]}],[this.sx,this.sy]=typeof e=="number"?[e,e]:e,this.make=s,o(this,"FreeformBuilder")}add_line_segments(t,e=!0){for(const[s,r]of t)this.steps.push({op:"line",x:s,y:r});return e&&this.steps.push({op:"close"}),this}add_curve_segment(t,e,s,r,n,h){return this.steps.push({op:"curve",x1:t,y1:e,x2:s,y2:r,x:n,y:h}),this}move_to(t,e){return this.steps.push({op:"move",x:t,y:e}),this}convert_to_shape(t=0,e=0){this.steps.length<2&&m("convert_to_shape(): a freeform needs a segment.");const s=this.steps.flatMap(a=>a.op==="close"?[]:a.op==="curve"?[[a.x1,a.y1],[a.x2,a.y2],[a.x,a.y]]:[[a.x,a.y]]),r=s.map(a=>a[0]),n=s.map(a=>a[1]),h=Math.min(...r),l=Math.min(...n),f=Math.max(...r)-h,u=Math.max(...n)-l,c=(a,_)=>({x:a-h,y:_-l});return this.make({w:f,h:u,steps:this.steps.map(a=>{if(a.op==="close")return a;if(a.op!=="curve")return{op:a.op,...c(a.x,a.y)};const _=c(a.x1,a.y1),x=c(a.x2,a.y2);return{op:"curve",x1:_.x,y1:_.y,x2:x.x,y2:x.y,...c(a.x,a.y)}})},g(Math.round(h*this.sx)+t,Math.round(l*this.sy)+e,Math.round(f*this.sx),Math.round(u*this.sy)))}}export class GroupShape{list;_name;make;constructor(t,e,s){return this.list=t,this._name=e,this.make=s,o(this,"GroupShape")}members(){return this.list.filter(t=>t.group===this._name)}box(){const t=this.members().flatMap(r=>r.frame?[r.frame]:[]),e=Math.min(...t.map(r=>r.left)),s=Math.min(...t.map(r=>r.top));return{left:t.length>0?e:0,top:t.length>0?s:0,right:Math.max(0,...t.map(r=>r.left+r.width)),bottom:Math.max(0,...t.map(r=>r.top+r.height))}}get shapes(){return this.make(this._name)}get shape_type(){return I.GROUP}get name(){return this._name}set name(t){for(const e of this.members())e.group=t;this._name=t}get left(){return d(this.box().left)}set left(t){const e=t-this.box().left;for(const s of this.members())s.frame&&(s.frame.left+=e)}get top(){return d(this.box().top)}set top(t){const e=t-this.box().top;for(const s of this.members())s.frame&&(s.frame.top+=e)}get width(){const t=this.box();return d(t.right-t.left)}get height(){const t=this.box();return d(t.bottom-t.top)}}export class Cell{def;table;row;col;constructor(t,e,s,r){return this.def=t,this.table=e,this.row=s,this.col=r,o(this,"_Cell")}get text_frame(){return new TextFrame(this.def.text)}get text(){return this.text_frame.text}set text(t){this.text_frame.text=t}get fill(){return new FillFormat(()=>this.def.fill,t=>{this.def.fill=t})}get borders(){return this.def.borders??{}}set borders(t){this.def.borders=t}get margin_left(){return d(this.def.text.margin_left??w.left)}set margin_left(t){this.def.text.margin_left=t}get margin_right(){return d(this.def.text.margin_right??w.right)}set margin_right(t){this.def.text.margin_right=t}get margin_top(){return d(this.def.text.margin_top??w.top)}set margin_top(t){this.def.text.margin_top=t}get margin_bottom(){return d(this.def.text.margin_bottom??w.bottom)}set margin_bottom(t){this.def.text.margin_bottom=t}get vertical_anchor(){return this.def.text.vertical_anchor}set vertical_anchor(t){t===void 0?delete this.def.text.vertical_anchor:this.def.text.vertical_anchor=t}get is_merge_origin(){return(this.def.span_width??1)>1||(this.def.span_height??1)>1}get is_spanned(){return this.def.spanned===!0}get span_width(){return this.def.span_width??1}get span_height(){return this.def.span_height??1}merge(t){const e=[this.row,t.row].sort((f,u)=>f-u),s=[this.col,t.col].sort((f,u)=>f-u),[r=0,n=0]=e,[h=0,l=0]=s;for(let f=r;f<=n;f++)for(let u=h;u<=l;u++){const c=this.table.rows[f]?.cells[u];c&&(f===r&&u===h?(l>h&&(c.span_width=l-h+1),n>r&&(c.span_height=n-r+1)):c.spanned=!0)}}split(){const t=this.span_width,e=this.span_height;delete this.def.span_width,delete this.def.span_height;for(let s=this.row;s<this.row+e;s++)for(let r=this.col;r<this.col+t;r++){const n=this.table.rows[s]?.cells[r];n&&delete n.spanned}}}export class Column{def;at;constructor(t,e){return this.def=t,this.at=e,o(this,"_Column")}get width(){return d(this.def.columns[this.at]??0)}set width(t){this.def.columns[this.at]=t}}export class Row{def;at;constructor(t,e){return this.def=t,this.at=e,o(this,"_Row")}get row(){const t=this.def.rows[this.at];if(!t)throw new Error(`The table has no row ${String(this.at)}.`);return t}get height(){return d(this.row.height)}set height(t){this.row.height=t}}export class Table{def;constructor(t){return this.def=t,o(this,"Table")}cell(t,e){const s=this.def.rows[t]?.cells[e];if(!s)throw new Error(`cell(): the table has ${String(this.def.rows.length)} rows and ${String(this.def.columns.length)} columns.`);return new Cell(s,this.def,t,e)}*iter_cells(){for(let t=0;t<this.def.rows.length;t++)for(let e=0;e<this.def.columns.length;e++)yield this.cell(t,e)}get columns(){return this.def.columns.map((t,e)=>new Column(this.def,e))}get rows(){return this.def.rows.map((t,e)=>new Row(this.def,e))}flag(t){return this.def[t]===!0}get first_row(){return this.flag("first_row")}set first_row(t){this.def.first_row=t}get first_col(){return this.flag("first_col")}set first_col(t){this.def.first_col=t}get last_row(){return this.flag("last_row")}set last_row(t){this.def.last_row=t}get last_col(){return this.flag("last_col")}set last_col(t){this.def.last_col=t}get horz_banding(){return this.flag("horz_banding")}set horz_banding(t){this.def.horz_banding=t}get vert_banding(){return this.flag("vert_banding")}set vert_banding(t){this.def.vert_banding=t}}function et(i,t,e=[]){const s=new Set([...i,...e].map(n=>n.name));let r=1;for(;s.has(`${t}-${String(r)}`);)r++;return`${t}-${String(r)}`}export class ShapeCollection{list;base;components;inherit;group;under;constructor(t,e,s,r=()=>{},n=()=>[],h){return this.list=t,this.base=e,this.components=s,this.inherit=r,this.under=n,this.group=h,o(this,"SlideShapes",{index:l=>this._at(l)})}_wrap(t){return new Shape(t,()=>this.inherit(t))}_at(t){const e=this.list[t];return e?this._wrap(e):void 0}*[Symbol.iterator](){for(const t of this.list)yield this._wrap(t)}get length(){return this.list.length}get(t){const e=this.list.find(s=>s.name===t);return e?this._wrap(e):void 0}get title(){const t=this.list.find(e=>e.placeholder?.type==="title"||e.placeholder?.type==="ctrTitle");return t?this._wrap(t):void 0}get placeholders(){return new Placeholders(this.list,this.inherit)}_add(t,e){const s={name:et(this.list,t,this.under()),...e,...this.group===void 0?{}:{group:this.group}};return this.list.push(s),this._wrap(s)}add_textbox(t,e,s,r){return this._add("textbox",{kind:"textbox",frame:g(t,e,s,r),text:{...E(),...Y}})}add_picture(t,e,s,r,n){return(r===void 0||n===void 0)&&m("add_picture() takes a width and a height here: a picture's own size is not read while a deck's code runs"),this._add("picture",{kind:"picture",frame:g(e,s,r??0,n??0),media:{path:t,base:this.base}})}add_movie(t,e,s,r,n,h={}){return this._add("movie",{kind:"movie",frame:g(e,s,r,n),media:{path:t,base:this.base,...h.poster_frame_time===void 0?{}:{poster:h.poster_frame_time}}})}add_shape(t,e,s,r,n){tt.has(t)||m(`add_shape(): ${t} is not one of MSO_SHAPE's ${Object.keys(M).join(", ")}`);const h=E();return h.vertical_anchor=p.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:p.alignment}],this._add("shape",{kind:"autoshape",frame:g(e,s,r,n),geometry:t,fill:p.fill,line:p.line,line_width:p.line_width,text:h})}add_table(t,e,s,r,n,h){(t<1||e<1)&&m("add_table(): a table has at least a row and a column.");const l=Math.floor(n/e),f=Math.floor(h/t);return this._add("table",{kind:"table",frame:g(s,r,n,h),table:{columns:Array.from({length:e},()=>l),rows:Array.from({length:t},()=>({height:f,cells:Array.from({length:e},()=>({text:E()}))}))}})}add_chart(t,e,s,r,n,h){return this._add("chart",{kind:"chart",frame:g(e,s,r,n),chart:{type:t,categories:[...h.categories],series:h._series()}})}add_group_shape(){this.group!==void 0&&m("add_group_shape(): a group here holds shapes, not another group.");let t=1;for(;this.list.some(e=>e.group===`group-${String(t)}`);)t++;return new GroupShape(this.list,`group-${String(t)}`,e=>new ShapeCollection(this.list,this.base,this.components,this.inherit,this.under,e))}build_freeform(t=0,e=0,s=1){return new FreeformBuilder([t,e],s,(r,n)=>{const h=E();return h.vertical_anchor=p.vertical_anchor,h.paragraphs=[{runs:[],level:0,alignment:p.alignment}],this._add("freeform",{kind:"autoshape",frame:n,path:r,fill:p.fill,line:p.line,line_width:p.line_width,text:h})})}add_connector(t,e,s,r,n){R(t)||m(`add_connector(): ${t} is not one of MSO_CONNECTOR's ${Object.keys(G).join(", ")}, nor a connector's preset (${D.join(", ")})`);const h=g(Math.min(e,r),Math.min(s,n),Math.abs(r-e),Math.abs(n-s),{line:!0}),l=r<e,f=n<s;return this._add("connector",{kind:"autoshape",frame:h,geometry:t,...l||f?{flip:{...l?{h:l}:{},...f?{v:f}:{}}}:{},line:P.line,line_width:P.line_width})}add_component(t,e,s,r,n,h={}){if(!Object.hasOwn(this.components(),t))throw new Error(`add_component(): the presentation has no component ${t}; add it with prs.components.add("${t}", { … }) first.`);return this._add(t,{kind:"component",frame:g(e,s,r,n),component:{name:t,props:h}})}}export const NAME_OF_TYPE={title:"title",ctrTitle:"title",subTitle:"subtitle",body:"body",pic:"picture",media:"media",obj:"content",dt:"date",ftr:"footer",sldNum:"slide-number"};export class Placeholders{list;inherit;constructor(t,e=()=>{}){return this.list=t,this.inherit=e,o(this,"placeholders",{index:s=>this.get(s)})}_wrap(t){return new Shape(t,()=>this.inherit(t))}*[Symbol.iterator](){for(const t of this.list)t.kind==="placeholder"&&(yield this._wrap(t))}get length(){return this.list.filter(t=>t.kind==="placeholder").length}get(t){const e=this.list.find(s=>s.kind==="placeholder"&&(typeof t=="number"?s.placeholder?.idx===t:s.name===t||s.placeholder?.type===t));return e?this._wrap(e):void 0}add(t,e,s,r,n,h={}){const l=typeof e=="object"?e:h,f=typeof e=="object"?void 0:e;Object.values(j).includes(t)||m(`placeholders.add(): ${t} is not one of PP_PLACEHOLDER's ${Object.keys(j).join(", ")}`);const u=this.list.filter(b=>b.kind==="placeholder"),c=new Set(u.map(b=>b.placeholder?.idx));let a=t==="title"||t==="ctrTitle"?0:H[t]??1;for(;c.has(a)&&a!==0;)a++;if(c.has(a))throw new Error("A layout has one title placeholder (idx 0).");const _=l.name??NAME_OF_TYPE[t];if(this.list.some(b=>b.name===_))throw new Error(`Two shapes are ${_}: give the placeholder a name ({ name }).`);const x=[f,s,r,n].filter(b=>b!==void 0);if(x.length!==0&&x.length!==4)throw new Error("placeholders.add(type, left, top, width, height): give all four, or none to take the master's frame.");const $={name:_,kind:"placeholder",placeholder:{type:t,idx:a},...x.length===4?{frame:g(f??0,s??0,r??0,n??0)}:{},text:{paragraphs:[],levels:X(t)}};return this.list.push($),this._wrap($)}}export class SlideLayout{def;master;ctx;constructor(t,e,s){return this.def=t,this.master=e,this.ctx=s,o(this,"SlideLayout")}get _def(){return this.def}inherit=t=>t.placeholder?A(this.master._def,t.placeholder.type)?.frame:void 0;get name(){return this.def.name}get slide_master(){return this.master}get display_master_shapes(){return this.def.display_master_shapes??!0}set display_master_shapes(t){t?delete this.def.display_master_shapes:this.def.display_master_shapes=!1}get background(){return new Background(this.def)}get placeholders(){return new Placeholders(this.def.shapes,this.inherit)}get shapes(){return new ShapeCollection(this.def.shapes,this.ctx.base,this.ctx.components,this.inherit,()=>this.master._def.shapes)}}export class SlideLayouts{list;make;constructor(t,e){return this.list=t,this.make=e,o(this,"SlideLayouts",{index:s=>this.list[s]})}*[Symbol.iterator](){yield*this.list}get length(){return this.list.length}get_by_name(t,e){return this.list.find(s=>s.name===t)??e}index(t){const e=this.list.indexOf(t);if(e<0)throw new Error(`${t.name} is not among these layouts.`);return e}add(t,e){if(!this.make)throw new Error("A layout is added to a master: master.slide_layouts.add(name).");const s=this.make(t);return e?.(s),s}}export class TextStyles{def;constructor(t){return this.def=t,o(this,"text_styles")}get title_style(){return S(this.def.title)}get body_style(){return S(this.def.body)}get other_style(){return S(this.def.other)}}export class SlideMaster{def;layouts=[];ctx;allLayouts;constructor(t,e,s){return this.def=t,this.ctx=e,this.allLayouts=s,o(this,"SlideMaster")}get _def(){return this.def}get name(){return this.def.name}get background(){return new Background(this.def)}get placeholders(){return new Placeholders(this.def.shapes)}get shapes(){return new ShapeCollection(this.def.shapes,this.ctx.base,this.ctx.components)}get text_styles(){return new TextStyles(this.def.text_styles)}get slide_layouts(){return new SlideLayouts(this.layouts,t=>{if(this.allLayouts.some(r=>r.name===t))throw new Error(`Two layouts are "${t}": a layout's name is unique in the deck, as slides.yaml names it.`);const e={name:t,master:this.def.name,shapes:[]};this.def.layouts.push(e);const s=new SlideLayout(e,this,this.ctx);return this.layouts.push(s),this.allLayouts.push(s),s})}}export class SlideMasters{list;make;constructor(t,e){return this.list=t,this.make=e,o(this,"SlideMasters",{index:s=>this.list[s]})}*[Symbol.iterator](){yield*this.list}get length(){return this.list.length}index(t){return this.list.indexOf(t)}add(t,e){const s=this.make(t);return e?.(s),s}}export class GeneratedSlide{own;def;layout;constructor(t,e,s){this.def=t,this.layout=e,this.own=e._def.shapes.filter(n=>n.kind==="placeholder").map(n=>({name:n.name,kind:"placeholder",...n.placeholder?{placeholder:{...n.placeholder}}:{},text:E()}));const r=n=>{const h=e._def.shapes.find(l=>l.kind==="placeholder"&&l.placeholder?.idx===n.placeholder?.idx);return h?h.frame??(h.placeholder?A(e.slide_master._def,h.placeholder.type)?.frame:void 0):void 0};return this._shapes=new ShapeCollection(this.own,s.base,s.components,r,()=>[...e.slide_master._def.shapes,...e._def.shapes]),this._placeholders=new Placeholders(this.own,r),o(this,"Slide")}_shapes;_placeholders;get shapes(){return this._shapes}get placeholders(){return this._placeholders}get slide_id(){return this.def.id}get slide_layout(){return this.layout}get has_notes_slide(){return this.def.notes!==void 0}get notes_slide(){const t=this.def;return o({notes_text_frame:o({get text(){return t.notes??""},set text(e){t.notes=e}},"TextFrame")},"NotesSlide")}get transition(){return this.def.transition}set transition(t){t===void 0?delete this.def.transition:this.def.transition=t}get animations(){return new Animations(this.def.animations??=[])}_done(){const t={},e=[];for(const s of this.own)s.kind==="placeholder"&&s.placeholder?(s.text?.paragraphs.some(r=>r.runs.length>0)&&(t[s.placeholder.idx]=s.text.paragraphs),s.frame&&e.push({...s,text:E()})):e.push(s);return{...this.def,shapes:e,text:t}}}export class Animations{list;constructor(t){return this.list=t,o(this,"Animations")}add(t,e,s={}){this.list.push({shape:typeof t=="string"?t:t.name,effect:e,...s})}get length(){return this.list.length}}class st{gen;constructor(t){return this.gen=t,o(this,"slides")}add_slide(t,e){return this.gen._add(t,e)}}export class Generator{list=[];prs;ctx;constructor(t,e){return this.prs=t,this.ctx=e,o(this,"Generator")}data(t){return this.ctx.data(t)}get slides(){return new st(this)}_add(t,e){const s=typeof t=="string"?this.prs._layout(t):t;if(!s)throw new Error(`add_slide(): the presentation has no layout ${typeof t=="string"?t:t.name}.`);if(!/^[A-Za-z0-9_-]+$/u.test(e))throw new Error(`add_slide(): ${e} is not an id of letters, digits, _ and -.`);if(this.list.some(n=>n.slide_id===e))throw new Error(`add_slide(): two slides are ${e}.`);const r=new GeneratedSlide({id:e,layout:s.name,shapes:[],text:{}},s,this.prs._ctx);return this.list.push(r),r}_made(){return this.list.map(t=>t._done())}}const rt=()=>JSON.parse(JSON.stringify(U));export class Presentation{masters=[];layouts=[];def;_ctx;constructor(t,e){return this.def={slide_width:t[0],slide_height:t[1],masters:[],components:{},generators:{}},this._ctx={base:e,components:()=>this.def.components},o(this,"Presentation")}get _def(){return this.def}get slide_width(){return d(this.def.slide_width)}set slide_width(t){this.def.slide_width=t}get slide_height(){return d(this.def.slide_height)}set slide_height(t){this.def.slide_height=t}get slide_masters(){return new SlideMasters(this.masters,t=>{if(this.masters.some(r=>r.name===t))throw new Error(`Two masters are "${t}".`);const e={name:t,background:"lt1",text_styles:rt(),shapes:[],layouts:[]};this.def.masters.push(e);const s=new SlideMaster(e,this._ctx,this.layouts);return this.masters.push(s),s})}get slide_master(){const t=this.masters[0];if(!t)throw new Error("The presentation has no master yet: prs.slide_masters.add(name) makes one.");return t}get slide_layouts(){const t=this.masters[0];return t?t.slide_layouts:new SlideLayouts([])}get slides(){return m("A deck's slides are slides.yaml's, in order, each on a layout, and their words the script's; slides made from data are a generator's (prs.generators.add)")}save(){return m("A deck is not saved by its code: allyhub render writes its PDF, pictures and PPTX")}get theme(){return this.def.theme??={},this.def.theme}set theme(t){this.def.theme=t}get components(){return o({add:(t,e)=>{if(Object.hasOwn(this.def.components,t))throw new Error(`Two components are "${t}".`);if(typeof e.layers!="function")throw new Error(`Component ${t} draws with its layers function.`);this.def.components[t]={name:t,props:e.props??{},layers:e.layers}}},"components")}get generators(){return o({add:(t,e)=>{if(Object.hasOwn(this.def.generators,t))throw new Error(`Two generators are "${t}".`);this.def.generators[t]={name:t,make:s=>{const r=new Generator(this,s);return e(r),r._made()}}}},"generators")}_layout(t){return this.layouts.find(e=>e.name===t)}}export const DECK_BRAND="__allyhubDeck";export function isDeck(i){return typeof i=="object"&&i!==null&&DECK_BRAND in i}export const presentationFor=i=>(t,e)=>{const[s,r]=typeof t=="function"?[{},t]:[t,e];if(typeof r!="function")throw new Error("An item's slides.ts exports one deck: export default presentation({ size }, (prs) => { … masters, layouts, components … }); its slides are slides.yaml.");if(typeof s.size=="string"&&!Object.hasOwn(k,s.size))throw new Error(`presentation(): size ${s.size} is not one of ${Object.keys(k).join(", ")}, or { width, height } in EMU.`);return{[DECK_BRAND]:!0,kind:"slides",options:s,build:r,written:{file:i}}};export function evaluateDeck(i){const t=i.options.size??"16:9",e=typeof t=="string"?k[t]:[t.width,t.height],s=i.written.file.split("/").slice(0,-1).join("/"),r=new Presentation(e,s);return i.options.theme&&(r.theme=JSON.parse(JSON.stringify(i.options.theme))),i.build(r),r._def}

package/dist/node_modules/@allyhub-next/slides-core/dist/capabilities.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{Animations as d,Background as l,Cell as p,ColorFormat as h,Column as m,FillFormat as y,Font as c,FreeformBuilder as _,GeneratedSlide as f,Generator as u,GroupShape as g,LineFormat as S,ListLevel as b,Paragraph as w,Placeholders as O,Presentation as L,Row as A,Run as P,Shape as E,ShapeCollection as x,SlideLayout as C,SlideLayouts as T,SlideMaster as M,SlideMasters as R,Table as v,TextFrame as k,TextStyles as I}from"./api.js";import{CategoryChartData as F,Chart as B,ChartAxis as G,ChartLegend as D,ChartPlot as H,ChartSeries as N,DataLabels as j}from"./chart-api.js";import{MSO_ANCHOR as W,MSO_ARROWHEAD as X,MSO_AUTO_SIZE as z,MSO_CONNECTOR as U,MSO_FILL as Y,MSO_LINE as Z,MSO_SHAPE as K,MSO_SHAPE_TYPE as q,MSO_THEME_COLOR as J,PP_ALIGN as Q,PP_PLACEHOLDER as V,THEME_FONT as $,XL_CHART_TYPE as ee,XL_LABEL_POSITION as te,XL_LEGEND_POSITION as ae}from"./enums.js";import{publicNames as o}from"./strict.js";const a={Presentation:{theme:"The theme's colours (dk1…folHlink) and fonts (major, minor), over the project's look.",components:"components.add(name, { props, layers }): a shape drawn by code, by the layer contract.",generators:"generators.add(name, (g) => { g.data(path); g.slides.add_slide(layout, id) … }): slides made from data, placed in slides.yaml as one block."},SlideMasters:{add:"add(name): a master, with Office's text styles and no placeholders yet."},_Cell:{borders:"Its edges: { left, right, top, bottom }, each { color, width } (a:lnL…)."},LineFormat:{begin_arrow:"What the end of the line where it starts has (MSO_ARROWHEAD): PowerPoint's Begin Arrow type (a:headEnd).",end_arrow:"What the end of the line where it ends has (MSO_ARROWHEAD): PowerPoint's End Arrow type (a:tailEnd)."},FreeformBuilder:{add_curve_segment:"add_curve_segment(x1, y1, x2, y2, x, y): a cubic Bézier segment by its two control points (a:cubicBezTo)."},Font:{spacing:"Space added between letters, a Length, negative to tighten (PowerPoint's Character Spacing, a:rPr spc)."},SlideMaster:{text_styles:"Its text styles (p:txStyles): title_style, body_style, other_style, nine ListLevels each, Office's to start with."},SlideLayouts:{add:"add(name): a layout on this master."},SlideLayout:{display_master_shapes:"Whether its master's shapes are drawn on its slides, true unless set: PowerPoint's Hide Background Graphics (@showMasterSp)."},placeholders:{add:"add(PP_PLACEHOLDER.X, left?, top?, width?, height?, { name }): a placeholder on a master or a layout; a layout's without a frame takes its master's of its base type."},SlideShapes:{add_component:"add_component(name, left, top, width, height, props): a component of the presentation in a frame.",get:"get(name): a shape by its name."},TextFrame:{list_style:"Its list style (a:lstStyle): nine ListLevels, level 0 first, what its paragraphs take where they set nothing."},ListLevel:{"*":"A level of a list style: alignment, line_spacing, space_before, space_after, font, bullet (a character, or null for none), bullet_font, margin_left, indent."},text_styles:{"*":"title_style, body_style, other_style: a master's text styles, nine ListLevels each."},Animations:{"*":"A generated slide's Animation Pane: add(shape, effect, { start, direction, duration, delay, paragraph, path }), in order."},Slide:{animations:"Its Animation Pane, which python-pptx has no API for.",transition:"How it comes on from the slide before: { type, direction, duration }, which python-pptx has no API for."},Generator:{"*":"What a generator's function is given: data(path), and slides.add_slide(layout, id)."}},se={Presentation:{slides:"A deck's slides are slides.yaml's, their words the script's; slides from data are a generator's.",save:"A deck is not saved by its code: allyhub render writes its files."}},oe={Presentation:L.prototype,SlideMasters:R.prototype,SlideMaster:M.prototype,SlideLayouts:T.prototype,SlideLayout:C.prototype,Slide:f.prototype,placeholders:O.prototype,SlideShapes:x.prototype,Shape:E.prototype,TextFrame:k.prototype,_Paragraph:w.prototype,_Run:P.prototype,Font:c.prototype,ColorFormat:h.prototype,FillFormat:y.prototype,LineFormat:S.prototype,FreeformBuilder:_.prototype,GroupShape:g.prototype,Table:v.prototype,CategoryChartData:F.prototype,Chart:B.prototype,Plot:H.prototype,Series:N.prototype,DataLabels:j.prototype,Legend:D.prototype,Axis:G.prototype,_Cell:p.prototype,_Column:m.prototype,_Row:A.prototype,_Background:l.prototype},re={Animations:d.prototype,ListLevel:b.prototype,text_styles:I.prototype,Generator:u.prototype},ne=()=>{const e={};for(const[t,r]of Object.entries(oe)){const n=a[t]??{},i=se[t]??{};e[t]=o(r).filter(s=>!Object.hasOwn(n,s)&&!Object.hasOwn(i,s))}return e};export const CAPABILITIES={reference:{library:"python-pptx",version:"1.0.2",docs:"https://python-pptx.readthedocs.io/"},holds:ne(),enums:Object.fromEntries(Object.entries({MSO_THEME_COLOR:J,PP_ALIGN:Q,MSO_ANCHOR:W,MSO_AUTO_SIZE:z,PP_PLACEHOLDER:V,MSO_SHAPE:K,MSO_CONNECTOR:U,MSO_SHAPE_TYPE:q,MSO_FILL:Y,MSO_LINE:Z,XL_CHART_TYPE:ee,XL_LABEL_POSITION:te,XL_LEGEND_POSITION:ae,MSO_ARROWHEAD:X,THEME_FONT:$}).map(([e,t])=>[e,Object.keys(t)])),units:["Emu","Inches","Pt","Cm","Mm","Centipoints","RGBColor"],differs:["The entry is export default presentation({ size, theme }, (prs) => { … }), not Presentation(path): a deck is made by its code, never opened from a template. Its masters and layouts are made with the additions below; its slides are slides.yaml's.","A name python-pptx has that is not held throws where it is used, naming what the class holds; python-pptx's x[i] is held where it indexes (slide_masters[0], slide_layouts[0], placeholders[idx], shapes[0]), and len(x) is x.length.","Lengths are numbers of EMU, made by python-pptx's functions (Inches(1), Pt(12)): no .inches or .pt on them; divide by 914400 or 12700.",`An enumeration's members are PresentationML's values (MSO_THEME_COLOR.ACCENT_1 is "accent1", PP_ALIGN.CENTER "ctr"), not integers; TEXT_1 and BACKGROUND_1 are dk1 and lt1, a master's standard colour map. MSO_SHAPE_TYPE.COMPONENT is a component's.`,`A colour's rgb is "#RRGGBB": RGBColor(r, g, b) and RGBColor.from_string("RRGGBB") make one.`,"line_spacing is a number of lines, or a Length of Pt(1) and over for a fixed height (python-pptx tells them apart by type).","add_picture() takes both width and height: a picture's own size is not read while a deck's code runs.","add_movie(movie_file, left, top, width, height, { poster_frame_time }) takes a video file, its poster a moment of it in seconds, not poster_frame_image.","A shape's name is its kind and a number (textbox-1, shape-2), and a placeholder's its type's (title, body, subtitle): slides.yaml and the script name shapes by name.","fit_text() sets the frame to shrink its text when it is drawn (MSO_AUTO_SIZE.TEXT_TO_FIT_SHAPE) from max_size: it reads no font file.","Font.underline is a single underline or none.","A chart holds column, bar, line, area, pie and doughnut types; it has no 3D, no scatter and no second axis. slides.yaml's chart can read its numbers from a project file: data, categories and series name it and its columns.","A table has no style, where python-pptx's starts with Medium Style 2: its look is its cells' (fill, borders, text), and first_row and the like say what its rows are and paint nothing. add_table returns its shape, whose .table is the table.","A group is its shapes: they are listed with the shapes the group is among, drawn as they are, and a group holds no group; its box is theirs, so left and top move them and width and height only read.","A presentation is 16:9 (12192000 × 6858000) and its theme Office 2013–2022's over the project's look; python-pptx's template is 4:3 with Office 2007's.","prs.slide_layouts and prs.slide_master are the first master's, as python-pptx's; a generator's add_slide also takes a layout of any master by name."],adds:{...a,...Object.fromEntries(Object.entries(re).map(([e,t])=>[e,{...a[e]??{},names:o(t).join(", ")}]))}};
+import{Animations as l,Background as d,Cell as p,ColorFormat as h,Column as m,FillFormat as c,Font as y,FreeformBuilder as u,GeneratedSlide as _,Generator as f,GroupShape as g,Hyperlink as b,LineFormat as w,ListLevel as S,ShadowFormat as L,Paragraph as O,Placeholders as A,Presentation as C,Row as P,Run as E,Shape as x,ShapeCollection as T,SlideLayout as R,SlideLayouts as k,SlideMaster as M,SlideMasters as v,Table as F,TextFrame as I,TextStyles as G}from"./api.js";import{CategoryChartData as B,Chart as H,XyChartData as D,XySeriesData as N,ChartAxis as j,ChartFormat as X,ChartLegend as W,MajorGridlines as z,TickLabels as U,ChartPlot as Y,ChartSeries as Z,DataLabels as K}from"./chart-api.js";import{MSO_ANCHOR as V,MSO_ARROWHEAD as q,MSO_AUTO_SIZE as J,MSO_CONNECTOR as Q,MSO_FILL as $,MSO_LINE as ee,MSO_SHAPE as te,MSO_SHAPE_TYPE as ae,MSO_THEME_COLOR as oe,PP_ALIGN as se,PP_PLACEHOLDER as re,THEME_FONT as ne,XL_CHART_TYPE as ie,XL_LABEL_POSITION as le,XL_LEGEND_POSITION as de}from"./enums.js";import{publicNames as s}from"./strict.js";const a={Presentation:{theme:"The theme's colours (dk1…folHlink) and fonts (major, minor), over the project's look.",components:"components.add(name, { props, layers }): a shape drawn by code, by the layer contract.",generators:"generators.add(name, (g) => { g.data(path); g.slides.add_slide(layout, id) … }): slides made from data, placed in slides.yaml as one block."},SlideMasters:{add:"add(name): a master, with Office's text styles and no placeholders yet."},_Cell:{borders:"Its edges: { left, right, top, bottom }, each { color, width } (a:lnL…)."},LineFormat:{begin_arrow:"What the end of the line where it starts has (MSO_ARROWHEAD): PowerPoint's Begin Arrow type (a:headEnd).",end_arrow:"What the end of the line where it ends has (MSO_ARROWHEAD): PowerPoint's End Arrow type (a:tailEnd)."},FillFormat:{transparency:"How much of the fill shows through, a share: PowerPoint's Transparency (a:alpha).",gradient_stops:"Its stops, [{ at, color, transparency }], `at` and `transparency` shares; python-pptx's stops can only be read and changed in place."},ShadowFormat:{blur_radius:"How far the shadow blurs, a Length (a:outerShdw blurRad).",distance:"How far it falls from the shape, a Length (dist).",angle:"The way it falls, degrees clockwise from the right (dir).",transparency:"How much shows through it, a share (a:alpha).",color:"Its colour, a ColorFormat."},FreeformBuilder:{add_curve_segment:"add_curve_segment(x1, y1, x2, y2, x, y): a cubic Bézier segment by its two control points (a:cubicBezTo)."},Font:{strike:"A line through it (@strike).",baseline:"Raised or lowered, a share of its size: superscript 0.3, subscript -0.25 (@baseline).",highlight:"The colour behind it, #RRGGBB as RGBColor gives one (a:highlight).",spacing:"Space added between letters, a Length, negative to tighten (PowerPoint's Character Spacing, a:rPr spc)."},SlideMaster:{text_styles:"Its text styles (p:txStyles): title_style, body_style, other_style, nine ListLevels each, Office's to start with."},SlideLayouts:{add:"add(name): a layout on this master."},SlideLayout:{display_master_shapes:"Whether its master's shapes are drawn on its slides, true unless set: PowerPoint's Hide Background Graphics (@showMasterSp)."},placeholders:{add:"add(PP_PLACEHOLDER.X, left?, top?, width?, height?, { name }): a placeholder on a master or a layout; a layout's without a frame takes its master's of its base type."},SlideShapes:{add_component:"add_component(name, left, top, width, height, props): a component of the presentation in a frame.",get:"get(name): a shape by its name."},TextFrame:{list_style:"Its list style (a:lstStyle): nine ListLevels, level 0 first, what its paragraphs take where they set nothing."},ListLevel:{"*":"A level of a list style: alignment, line_spacing, space_before, space_after, font, bullet (a character, or null for none), bullet_font, numbered (a:buAutoNum: arabicPeriod, alphaLcPeriod…), margin_left, indent."},text_styles:{"*":"title_style, body_style, other_style: a master's text styles, nine ListLevels each."},Animations:{"*":"A generated slide's Animation Pane: add(shape, effect, { start, direction, duration, delay, paragraph, path }), in order."},Slide:{animations:"Its Animation Pane, which python-pptx has no API for.",transition:"How it comes on from the slide before: { type, direction, duration }, which python-pptx has no API for."},Generator:{"*":"What a generator's function is given: data(path), and slides.add_slide(layout, id)."}},pe={Presentation:{slides:"A deck's slides are slides.yaml's, their words the script's; slides from data are a generator's.",save:"A deck is not saved by its code: allyhub render writes its files."}},he={Presentation:C.prototype,SlideMasters:v.prototype,SlideMaster:M.prototype,SlideLayouts:k.prototype,SlideLayout:R.prototype,Slide:_.prototype,placeholders:A.prototype,SlideShapes:T.prototype,Shape:x.prototype,TextFrame:I.prototype,_Paragraph:O.prototype,_Run:E.prototype,_Hyperlink:b.prototype,Font:y.prototype,ColorFormat:h.prototype,FillFormat:c.prototype,LineFormat:w.prototype,ShadowFormat:L.prototype,FreeformBuilder:u.prototype,GroupShape:g.prototype,Table:F.prototype,CategoryChartData:B.prototype,XyChartData:D.prototype,XySeriesData:N.prototype,Chart:H.prototype,Plot:Y.prototype,Series:Z.prototype,DataLabels:K.prototype,Legend:W.prototype,Axis:j.prototype,TickLabels:U.prototype,MajorGridlines:z.prototype,ChartFormat:X.prototype,_Cell:p.prototype,_Column:m.prototype,_Row:P.prototype,_Background:d.prototype},me={Animations:l.prototype,ListLevel:S.prototype,text_styles:G.prototype,Generator:f.prototype},ce=()=>{const e={};for(const[t,r]of Object.entries(he)){const n=a[t]??{},i=pe[t]??{};e[t]=s(r).filter(o=>!Object.hasOwn(n,o)&&!Object.hasOwn(i,o))}return e};export const CAPABILITIES={reference:{library:"python-pptx",version:"1.0.2",docs:"https://python-pptx.readthedocs.io/"},holds:ce(),enums:Object.fromEntries(Object.entries({MSO_THEME_COLOR:oe,PP_ALIGN:se,MSO_ANCHOR:V,MSO_AUTO_SIZE:J,PP_PLACEHOLDER:re,MSO_SHAPE:te,MSO_CONNECTOR:Q,MSO_SHAPE_TYPE:ae,MSO_FILL:$,MSO_LINE:ee,XL_CHART_TYPE:ie,XL_LABEL_POSITION:le,XL_LEGEND_POSITION:de,MSO_ARROWHEAD:q,THEME_FONT:ne}).map(([e,t])=>[e,Object.keys(t)])),units:["Emu","Inches","Pt","Cm","Mm","Centipoints","RGBColor"],differs:["The entry is export default presentation({ size, theme }, (prs) => { … }), not Presentation(path): a deck is made by its code, never opened from a template. Its masters and layouts are made with the additions below; its slides are slides.yaml's.","A name python-pptx has that is not held throws where it is used, naming what the class holds; python-pptx's x[i] is held where it indexes (slide_masters[0], slide_layouts[0], placeholders[idx], shapes[0]), and len(x) is x.length.","A Length (what Inches(1) and Pt(12) give, and what a length reads, shape.width) is a Number of EMU with python-pptx's emu, inches, cm, mm, pt, centipoints and twips. Arithmetic on Lengths gives a plain number, as python's int does; two Lengths of one value are ===, and one is compared with a plain number by its .emu.",`An enumeration's members are PresentationML's values (MSO_THEME_COLOR.ACCENT_1 is "accent1", PP_ALIGN.CENTER "ctr"), not integers; TEXT_1 and BACKGROUND_1 are dk1 and lt1, a master's standard colour map. MSO_SHAPE_TYPE.COMPONENT is a component's.`,`A colour's rgb is "#RRGGBB": RGBColor(r, g, b), new RGBColor(r, g, b) and RGBColor.from_string("RRGGBB") make one.`,"A colour's brightness is a theme colour's: python-pptx also gives an RGB colour one, which is refused here (set rgb to the colour it makes).","line_spacing is a number of lines, or a Length of Pt(1) and over for a fixed height (python-pptx tells them apart by type).","add_picture() takes both width and height: a picture's own size is not read while a deck's code runs.","add_connector() takes MSO_CONNECTOR's STRAIGHT, ELBOW and CURVE, and also a connector's preset by name where python-pptx has none (straightConnector1, bentConnector2 to 5, curvedConnector2 to 5); a connector's adjustments (an elbow's middle) are its shape.adjustments.","add_movie(movie_file, left, top, width, height, { poster_frame_time }) takes a video file, its poster a moment of it in seconds, not poster_frame_image.","A shape's name is its kind and a number (textbox-1, shape-2), and a placeholder's its type's (title, body, subtitle): slides.yaml and the script name shapes by name.","fit_text() sets the frame to shrink its text when it is drawn (MSO_AUTO_SIZE.TEXT_TO_FIT_SHAPE) from max_size: it reads no font file.","Font.underline is a single underline or none.","A chart holds column, bar, line, area, pie, doughnut and XY scatter types; it has no 3D, no bubble, no radar and no second axis. slides.yaml's chart can read its numbers from a project file: data, categories and series name it and its columns.","A table has no style, where python-pptx's starts with Medium Style 2: its look is its cells' (fill, borders, text), and first_row and the like say what its rows are and paint nothing. add_table returns its shape, whose .table is the table.","A group is its shapes: they are listed with the shapes the group is among, drawn as they are, and a group holds no group; its box is theirs, so left and top move them and width and height only read.","A presentation is 16:9 (12192000 × 6858000) and its theme Office 2013–2022's over the project's look; python-pptx's template is 4:3 with Office 2007's.","prs.slide_layouts and prs.slide_master are the first master's, as python-pptx's; a generator's add_slide also takes a layout of any master by name."],adds:{...a,...Object.fromEntries(Object.entries(me).map(([e,t])=>[e,{...a[e]??{},names:s(t).join(", ")}]))}};