@office-open/core 0.7.1 → 0.8.1

package/dist/{index-C4Wm3RBo.d.mts → index-Bh6s66Up.d.mts}

@@ -1,4 +1,4 @@
-import { b as XmlComponent } from "./index-Borh69Zs.mjs";
+import { b as XmlComponent } from "./index-CoTp4wVf.mjs";
 
 //#region src/chart/axes.d.ts
 /**
@@ -37,10 +37,171 @@ declare class BubbleChart extends XmlComponent {
   constructor(options: BubbleChartOptions$1);
 }
 //#endregion
+//#region src/chart/extensions.d.ts
+declare const TrendlineType: {
+  readonly EXP: "exp";
+  readonly LINEAR: "linear";
+  readonly LOG: "log";
+  readonly MOVING_AVG: "movingAvg";
+  readonly POLY: "poly";
+  readonly POWER: "power";
+};
+type TrendlineType = (typeof TrendlineType)[keyof typeof TrendlineType];
+interface TrendlineOptions {
+  /** Trendline type (default: "linear") */
+  readonly type?: TrendlineType;
+  /** Custom name for the trendline */
+  readonly name?: string;
+  /** Order for polynomial trendlines (default: 2) */
+  readonly order?: number;
+  /** Period for moving average trendlines (default: 2) */
+  readonly period?: number;
+  /** Forward forecast periods */
+  readonly forward?: number;
+  /** Backward forecast periods */
+  readonly backward?: number;
+  /** Intercept value */
+  readonly intercept?: number;
+  /** Display R-squared value */
+  readonly dispRSqr?: boolean;
+  /** Display equation */
+  readonly dispEq?: boolean;
+}
+/**
+ * c:trendline — a trendline on a chart series.
+ *
+ * XSD: CT_Trendline (dml-chart.xsd)
+ */
+declare class Trendline extends XmlComponent {
+  constructor(options: TrendlineOptions);
+}
+declare const ErrorBarDirection: {
+  readonly BOTH: "both";
+  readonly X: "x";
+  readonly Y: "y";
+};
+type ErrorBarDirection = (typeof ErrorBarDirection)[keyof typeof ErrorBarDirection];
+declare const ErrorBarType: {
+  readonly BOTH: "both";
+  readonly MINUS: "minus";
+  readonly PLUS: "plus";
+};
+type ErrorBarType = (typeof ErrorBarType)[keyof typeof ErrorBarType];
+declare const ErrorValueType: {
+  readonly CUST: "cust";
+  readonly FIXED: "fixedVal";
+  readonly PERCENTAGE: "percentage";
+  readonly STD_DEV: "stdDev";
+  readonly STD_ERR: "stdErr";
+};
+type ErrorValueType = (typeof ErrorValueType)[keyof typeof ErrorValueType];
+interface ErrorBarOptions {
+  /** Error bar direction (default: "y") */
+  readonly direction?: ErrorBarDirection;
+  /** Error bar type — both/minus/plus (required) */
+  readonly barType?: ErrorBarType;
+  /** Error value type (default: "stdErr") */
+  readonly valueType?: ErrorValueType;
+  /** Error value (for fixed/percentage/stdDev/stdErr) */
+  readonly value?: number;
+  /** No end cap */
+  readonly noEndCap?: boolean;
+}
+/**
+ * c:errBars — error bars on a chart series.
+ *
+ * XSD: CT_ErrBars (dml-chart.xsd)
+ */
+declare class ErrorBars extends XmlComponent {
+  constructor(options: ErrorBarOptions);
+}
+declare const DataLabelPosition: {
+  readonly BEST_FIT: "bestFit";
+  readonly BOTTOM: "b";
+  readonly CENTER: "ctr";
+  readonly IN_BASE: "inBase";
+  readonly IN_END: "inEnd";
+  readonly LEFT: "l";
+  readonly OUT_END: "outEnd";
+  readonly RIGHT: "r";
+  readonly TOP: "t";
+};
+type DataLabelPosition = (typeof DataLabelPosition)[keyof typeof DataLabelPosition];
+interface DataLabelsOptions {
+  /** Data label position */
+  readonly position?: DataLabelPosition;
+  /** Show value */
+  readonly showVal?: boolean;
+  /** Show category name */
+  readonly showCatName?: boolean;
+  /** Show series name */
+  readonly showSerName?: boolean;
+  /** Show percentage */
+  readonly showPercent?: boolean;
+  /** Show legend key */
+  readonly showLegendKey?: boolean;
+  /** Show bubble size */
+  readonly showBubbleSize?: boolean;
+  /** Separator character */
+  readonly separator?: string;
+  /** Number format */
+  readonly numFmt?: string;
+}
+/**
+ * c:dLbls — data labels settings for a chart series.
+ *
+ * Implements EG_DLblShared group from dml-chart.xsd.
+ */
+declare class DataLabels extends XmlComponent {
+  constructor(options: DataLabelsOptions);
+}
+declare const TimeUnit: {
+  readonly DAYS: "days";
+  readonly MONTHS: "months";
+  readonly YEARS: "years";
+};
+type TimeUnit = (typeof TimeUnit)[keyof typeof TimeUnit];
+/**
+ * c:dateAx — date axis for time-series data.
+ *
+ * XSD: CT_DateAx (dml-chart.xsd)
+ */
+declare class DateAx extends XmlComponent {
+  constructor(axId: number, crossAx: number);
+}
+interface View3DOptions {
+  /** X rotation in degrees (-90 to 90, default: 30) */
+  readonly rotX?: number;
+  /** Y rotation in degrees (0 to 360, default: 0) */
+  readonly rotY?: number;
+  /** Height percentage (5 to 500) */
+  readonly heightPercent?: number;
+  /** Depth percentage (20 to 2000, default: 100) */
+  readonly depthPercent?: number;
+  /** Right angle axes */
+  readonly rightAngleAxes?: boolean;
+  /** Perspective (0 to 240) */
+  readonly perspective?: number;
+}
+/**
+ * c:view3D — 3D view properties for 3D charts.
+ *
+ * XSD: CT_View3D (dml-chart.xsd)
+ */
+declare class View3D extends XmlComponent {
+  constructor(options?: View3DOptions);
+}
+//#endregion
 //#region src/chart/create-chart-type.d.ts
 interface ChartSeriesData {
   readonly name: string;
   readonly values: readonly number[];
+  /** Trendlines for this series */
+  readonly trendlines?: readonly TrendlineOptions[];
+  /** Error bars for this series */
+  readonly errorBars?: ErrorBarOptions;
+  /** Data labels for this series */
+  readonly dataLabels?: DataLabelsOptions;
 }
 type ChartType = "column" | "bar" | "line" | "pie" | "area" | "scatter" | "bubble" | "doughnut" | "radar" | "stock" | "surface";
 type AxisChartType = Exclude<ChartType, "bubble">;
@@ -217,4 +378,4 @@ declare class SurfaceChart extends XmlComponent {
   constructor(options: SurfaceChartOptions);
 }
 //#endregion
-export { CatAx as A, BubbleChartOptions as C, createChartType as D, ChartTypeOptions as E, ValAx as M, BubbleChart as O, AxisChartType as S, ChartType as T, ChartCollection as _, Pie3DChart as a, ChartSpaceOptions as b, LineChart as c, BarChart as d, Area3DChart as f, createStrRef as g, createNumRef as h, RadarChart as i, SerAx as j, BubbleSeriesData as k, DoughnutChart as l, ChartTitle as m, StockChart as n, PieChart as o, AreaChart as p, ScatterChart as r, Line3DChart as s, SurfaceChart as t, Bar3DChart as u, ChartData as v, ChartSeriesData as w, AllChartTypeOptions as x, ChartSpace as y };
+export { DataLabelsOptions as A, TrendlineType as B, BubbleChartOptions as C, createChartType as D, ChartTypeOptions as E, ErrorBars as F, CatAx as G, View3DOptions as H, ErrorValueType as I, SerAx as K, TimeUnit as L, ErrorBarDirection as M, ErrorBarOptions as N, DataLabelPosition as O, ErrorBarType as P, Trendline as R, AxisChartType as S, ChartType as T, BubbleChart as U, View3D as V, BubbleSeriesData as W, ChartCollection as _, Pie3DChart as a, ChartSpaceOptions as b, LineChart as c, BarChart as d, Area3DChart as f, createStrRef as g, createNumRef as h, RadarChart as i, DateAx as j, DataLabels as k, DoughnutChart as l, ChartTitle as m, StockChart as n, PieChart as o, AreaChart as p, ValAx as q, ScatterChart as r, Line3DChart as s, SurfaceChart as t, Bar3DChart as u, ChartData as v, ChartSeriesData as w, AllChartTypeOptions as x, ChartSpace as y, TrendlineOptions as z };

package/dist/index-Cj2Yf5mk.d.mts

@@ -0,0 +1,52 @@
+import { S as Context, x as BaseXmlComponent } from "./index-CoTp4wVf.mjs";
+
+//#region src/theme/theme-options.d.ts
+/**
+ * Theme options for OOXML documents.
+ *
+ * @module
+ */
+/** Color scheme — 12 theme colors (hex without #). */
+interface ColorSchemeOptions {
+  readonly dark1?: string;
+  readonly light1?: string;
+  readonly dark2?: string;
+  readonly light2?: string;
+  readonly accent1?: string;
+  readonly accent2?: string;
+  readonly accent3?: string;
+  readonly accent4?: string;
+  readonly accent5?: string;
+  readonly accent6?: string;
+  readonly hyperlink?: string;
+  readonly followedHyperlink?: string;
+}
+/** Font scheme — 4 font slots (latin + east-asian for major/minor). */
+interface FontSchemeOptions {
+  readonly majorFont?: string;
+  readonly minorFont?: string;
+  readonly majorFontAsian?: string;
+  readonly minorFontAsian?: string;
+}
+/** Theme customization options. */
+interface ThemeOptions {
+  readonly name?: string;
+  readonly colors?: ColorSchemeOptions;
+  readonly fonts?: FontSchemeOptions;
+}
+//#endregion
+//#region src/theme/default-theme.d.ts
+declare class DefaultTheme extends BaseXmlComponent {
+  private readonly xml;
+  constructor(options?: ThemeOptions);
+  toXml(_context: Context): string;
+}
+//#endregion
+//#region src/theme/build-theme-xml.d.ts
+declare function buildThemeXml(options?: ThemeOptions): string;
+//#endregion
+//#region src/theme/default-colors.d.ts
+/** Office 2016+ default theme colors (hex without #). */
+declare const DEFAULT_COLORS: Required<ColorSchemeOptions>;
+//#endregion
+export { FontSchemeOptions as a, ColorSchemeOptions as i, buildThemeXml as n, ThemeOptions as o, DefaultTheme as r, DEFAULT_COLORS as t };

package/dist/{index-Borh69Zs.d.mts → index-CoTp4wVf.d.mts}

@@ -38,10 +38,6 @@ declare abstract class BaseXmlComponent {
   /** The XML element name for this component (e.g., "w:p" for paragraph). */
   protected readonly rootKey: string;
   constructor(rootKey: string);
-  /**
-   * @deprecated Use `toXml()` instead.
-   */
-  prepForXml(_context: Context): IXmlableObject | undefined;
   /**
    * Direct XML serialization. Override in subclasses for zero-allocation output.
    */
@@ -69,17 +65,13 @@ declare abstract class XmlComponent extends BaseXmlComponent {
    */
   root: (BaseXmlComponent | IXmlableObject | string)[];
   constructor(rootKey: string);
-  /**
-   * @deprecated Use `toXml()` instead.
-   */
-  prepForXml(context: Context): IXmlableObject | undefined;
   /**
    * Direct XML serialization — traverses `root` and calls `toXml()` on
    * each child, concatenating the results into a single string.
    */
   toXml(context: Context): string;
   /**
-   * @deprecated Internal use only.
+   * @internal
    */
   addChildElement(child: BaseXmlComponent | string): XmlComponent;
 }
@@ -89,10 +81,6 @@ declare abstract class XmlComponent extends BaseXmlComponent {
 declare abstract class IgnoreIfEmptyXmlComponent extends XmlComponent {
   private readonly includeIfEmpty;
   constructor(rootKey: string, includeIfEmpty?: boolean);
-  /**
-   * @deprecated Use `toXml()` instead.
-   */
-  prepForXml(context: Context): IXmlableObject | undefined;
   /**
    * Suppress empty elements — super.toXml() produces a self-closing tag
    * (`<tag/>`) when there are no child elements; IgnoreIfEmpty returns ""
@@ -200,10 +188,6 @@ declare class ImportedXmlComponent extends XmlComponent {
 declare class ImportedRootElementAttributes extends XmlComponent {
   private readonly _attr?;
   constructor(_attr?: Attributes | undefined);
-  /**
-   * @deprecated Use `toXml()` instead.
-   */
-  prepForXml(_context: Context): IXmlableObject;
   toXml(_context: Context): string;
 }
 //#endregion

package/dist/{index-f_Izh2dj.d.mts → index-D0N5Bw2M.d.mts}

@@ -1,4 +1,4 @@
-import { b as XmlComponent } from "./index-Borh69Zs.mjs";
+import { b as XmlComponent } from "./index-CoTp4wVf.mjs";
 
 //#region src/smartart/categories.d.ts
 /** Layout ID → OOXML category type */
@@ -16,11 +16,13 @@ declare const COLOR_CATEGORIES: Record<string, string>;
  */
 declare function getLayoutXml(layoutId: string): string;
 /**
- * Returns style stub XML with the given uniqueId.
+ * Returns style XML with basic style definitions (fillClrLst, linClrLst, etc.)
+ * that allow PowerPoint to correctly render SmartArt colors and effects.
  */
 declare function getStyleXml(styleId: string): string;
 /**
- * Returns color stub XML with the given uniqueId.
+ * Returns color XML with basic color definitions (fillLst, linLst, etc.)
+ * that allow PowerPoint to correctly render SmartArt with the specified color scheme.
  */
 declare function getColorXml(colorId: string): string;
 /** Minimal drawing cache for SmartArt (Office apps auto-regenerate this on open) */
@@ -31,7 +33,7 @@ declare const DEFAULT_DRAWING_XML: string;
  * dgm:cxn — SmartArt data model connection (edge).
  */
 declare class Connection extends XmlComponent {
-  constructor(modelId: string, srcId: string, destId: string, type?: string, srcOrd?: number, destOrd?: number, parTransId?: string, sibTransId?: string);
+  constructor(modelId: string, srcId: string, destId: string, type?: string, srcOrd?: number, destOrd?: number, parTransId?: string, sibTransId?: string, presId?: string);
 }
 //#endregion
 //#region src/smartart/data-model/data-model.d.ts
@@ -43,11 +45,47 @@ declare class DataModel extends XmlComponent {
 }
 //#endregion
 //#region src/smartart/data-model/point.d.ts
+interface PointPropertySetOptions {
+  readonly presentationAssociationId?: string;
+  readonly presentationName?: string;
+  readonly presentationStyleLabel?: string;
+  readonly presentationStyleIndex?: number;
+  readonly presentationStyleCount?: number;
+  readonly placeholderText?: string;
+  readonly placeholder?: boolean;
+  readonly customAngle?: number;
+  readonly customFlipVertical?: boolean;
+  readonly customFlipHorizontal?: boolean;
+  readonly customSizeX?: number;
+  readonly customSizeY?: number;
+  readonly customScaleX?: number;
+  readonly customScaleY?: number;
+  readonly customText?: boolean;
+  readonly customLinearFactorX?: number;
+  readonly customLinearFactorY?: number;
+  readonly customLinearFactorNeighborX?: number;
+  readonly customLinearFactorNeighborY?: number;
+  readonly customRadialScaleRadius?: number;
+  readonly customRadialScaleIncrement?: number;
+  readonly coherent3DOffset?: boolean;
+  readonly hideGeometry?: boolean;
+  readonly hideLastTransition?: boolean;
+  readonly lockTextEntry?: boolean;
+  readonly moveWith?: string;
+  readonly useDefault?: boolean;
+  readonly zOrderOffset?: number;
+  readonly layoutTypeId?: string;
+  readonly layoutCategoryId?: string;
+  readonly quickStyleTypeId?: string;
+  readonly quickStyleCategoryId?: string;
+  readonly colorStyleTypeId?: string;
+  readonly colorStyleCategoryId?: string;
+}
 /**
  * dgm:pt — SmartArt data model point (node).
  */
 declare class Point extends XmlComponent {
-  constructor(modelId: string, text: string, type?: string);
+  constructor(modelId: string, text: string, type?: string, propertySet?: PointPropertySetOptions);
 }
 /**
  * Transition point (parTrans or sibTrans) — no text body, references a connection.
@@ -84,4 +122,4 @@ interface TreeNode {
  */
 declare const createDataModel: (nodes: readonly TreeNode[], layout?: string, style?: string, color?: string) => DataModel;
 //#endregion
-export { Point as a, Connection as c, getLayoutXml as d, getStyleXml as f, STYLE_CATEGORIES as h, SmartArtData as i, DEFAULT_DRAWING_XML as l, LAYOUT_CATEGORIES as m, createDataModel as n, TransPoint as o, COLOR_CATEGORIES as p, SmartArtCollection as r, DataModel as s, TreeNode as t, getColorXml as u };
+export { Point as a, DataModel as c, getColorXml as d, getLayoutXml as f, STYLE_CATEGORIES as g, LAYOUT_CATEGORIES as h, SmartArtData as i, Connection as l, COLOR_CATEGORIES as m, createDataModel as n, PointPropertySetOptions as o, getStyleXml as p, SmartArtCollection as r, TransPoint as s, TreeNode as t, DEFAULT_DRAWING_XML as u };