@mog-sdk/spreadsheet-contracts 0.1.12

package/dist/wordart/presets.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Warp Preset Type Definitions
+ *
+ * This file contains type definitions for warp presets used in WordArt.
+ * These types define the structure of preset metadata and categorization.
+ *
+ * IMPORTANT: This file contains ONLY type definitions (no runtime data).
+ * The actual WARP_PRESETS Map with 35 preset configurations belongs in
+ * engine/src/wordart/presets.ts and will be implemented as part of 02-TEXT-WARPING.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.78 (ST_TextShapeType) for preset specs
+ */
+import type { AdjustmentValues, TextWarpPreset } from './types';
+/**
+ * Defines the valid range for an adjustment value.
+ *
+ * Each warp preset can have 0-2 adjustment handles that control its shape.
+ * This interface defines the min/max bounds for each adjustment value.
+ *
+ * @example
+ * // Arc height adjustment from 0% to 100%
+ * const arcRange: AdjustmentRange = { min: 0, max: 100 };
+ *
+ * // Wave amplitude that can go negative
+ * const waveRange: AdjustmentRange = { min: -100, max: 100 };
+ */
+export interface AdjustmentRange {
+    /** Minimum allowed value for this adjustment */
+    min: number;
+    /** Maximum allowed value for this adjustment */
+    max: number;
+}
+/**
+ * Categories for organizing warp presets in the gallery UI.
+ *
+ * - 'basic': No transformation (textPlain only)
+ * - 'follow-path': Text follows a curved path (arcs, circles, rings)
+ * - 'warp': Text is geometrically distorted (waves, inflate/deflate, triangles)
+ * - 'perspective': Text has perspective/fade effects (slants, cascades, fades)
+ *
+ * @example
+ * // Category counts:
+ * // basic: 1 (textPlain)
+ * // follow-path: 10 (arcs, circles, buttons, rings)
+ * // warp: 16 (waves, inflate/deflate, triangles, chevrons)
+ * // perspective: 8 (fades, slants, cascades)
+ */
+export type WarpCategory = 'basic' | 'follow-path' | 'warp' | 'perspective';
+/**
+ * Metadata definition for a warp preset.
+ *
+ * Contains all the information needed to display and configure a warp preset
+ * in the UI, including display name, description, adjustment parameters, and
+ * category for gallery organization.
+ *
+ * NOTE: This is a TYPE definition only. The actual preset data (WARP_PRESETS Map)
+ * is implemented in engine/src/wordart/presets.ts, not in contracts.
+ * Contracts package contains only types, no runtime data.
+ *
+ * @example
+ * // Example preset definition (for reference - actual data is in engine/)
+ * const archUpPreset: WarpPresetDefinition = {
+ *   id: 'textArchUp',
+ *   name: 'Arch Up',
+ *   description: 'Text curves upward along an arc',
+ *   adjustmentCount: 1,
+ *   defaultAdjustments: { adj1: 50 },
+ *   adjustmentRanges: { adj1: { min: 0, max: 100 } },
+ *   category: 'follow-path'
+ * };
+ */
+export interface WarpPresetDefinition {
+    /**
+     * Unique preset identifier matching the TextWarpPreset type.
+     * This is the value stored in WordArtConfig.warpPreset.
+     */
+    id: TextWarpPreset;
+    /**
+     * Human-readable display name for the preset.
+     * Shown in the WordArt gallery and format panel.
+     *
+     * @example 'Arch Up', 'Wave 1', 'Inflate'
+     */
+    name: string;
+    /**
+     * Description text for gallery tooltips.
+     * Provides users with a brief explanation of the effect.
+     *
+     * @example 'Text curves upward along an arc'
+     */
+    description: string;
+    /**
+     * Number of adjustment handles this preset supports.
+     * - 0: No adjustments (e.g., textPlain)
+     * - 1: Single adjustment (e.g., textArchUp has arc height)
+     * - 2: Two adjustments (e.g., textWave1 has amplitude and frequency)
+     */
+    adjustmentCount: 0 | 1 | 2;
+    /**
+     * Default values for the adjustment handles.
+     * Applied when the preset is first selected.
+     *
+     * @example { adj1: 50 } for single-adjustment presets
+     * @example { adj1: 20, adj2: 0 } for dual-adjustment presets
+     */
+    defaultAdjustments: AdjustmentValues;
+    /**
+     * Optional min/max ranges for each adjustment value.
+     * Used for UI sliders and validation.
+     * If not specified, the adjustment has no enforced range.
+     */
+    adjustmentRanges?: {
+        /** Range for primary adjustment (if preset has adjustmentCount >= 1) */
+        adj1?: AdjustmentRange;
+        /** Range for secondary adjustment (if preset has adjustmentCount >= 2) */
+        adj2?: AdjustmentRange;
+    };
+    /**
+     * Category for organizing presets in the gallery UI.
+     * Presets are grouped by category for easier browsing.
+     */
+    category: WarpCategory;
+    /**
+     * Optional thumbnail image for the gallery.
+     * Can be a base64-encoded data URL or a URL path to an image asset.
+     * Used for visual preview in the WordArt gallery picker.
+     *
+     * @example 'data:image/png;base64,iVBORw0KGgo...'
+     * @example '/assets/wordart/thumbnails/arch-up.png'
+     */
+    thumbnail?: string;
+}
+//# sourceMappingURL=presets.d.ts.map

package/dist/wordart/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/wordart/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAMhE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,aAAa,CAAC;AAM5E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,EAAE,EAAE,cAAc,CAAC;IAEnB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE3B;;;;;;OAMG;IACH,kBAAkB,EAAE,gBAAgB,CAAC;IAErC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE;QACjB,wEAAwE;QACxE,IAAI,CAAC,EAAE,eAAe,CAAC;QACvB,0EAA0E;QAC1E,IAAI,CAAC,EAAE,eAAe,CAAC;KACxB,CAAC;IAEF;;;OAGG;IACH,QAAQ,EAAE,YAAY,CAAC;IAEvB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/wordart/types.d.ts

@@ -0,0 +1,444 @@
+/**
+ * WordArt Types
+ *
+ * Implements DrawingML text warp and effects from ECMA-376 Part 1.
+ * WordArt is NOT a separate floating object type - it's a configuration
+ * that can be applied to TextBoxObject to add warping and effects.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10 (Text Body Properties)
+ * @see ECMA-376 Part 1, Section 20.1.10.78 (ST_TextShapeType)
+ */
+/**
+ * Text warp preset types from ECMA-376 DrawingML specification.
+ * Canonical source for ST_TextShapeType (dml-main.xsd, Section 20.1.10.78).
+ *
+ * These define how text is geometrically transformed along a path.
+ * Each preset has its own algorithm for computing the warp path.
+ *
+ * Note: Includes 'textNoShape' for OOXML compatibility - this represents
+ * text with no warp transformation applied (distinct from 'textPlain').
+ *
+ * An identical type exists in the auto-generated bridge file
+ * (rust-bridge/bridge-ts/generated/ooxml-types.ts) with PascalCase casing.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.78 (ST_TextShapeType)
+ */
+export type TextWarpPreset = 'textNoShape' | 'textPlain' | 'textArchUp' | 'textArchDown' | 'textCircle' | 'textButton' | 'textArchUpPour' | 'textArchDownPour' | 'textCirclePour' | 'textButtonPour' | 'textCurveUp' | 'textCurveDown' | 'textWave1' | 'textWave2' | 'textDoubleWave1' | 'textWave4' | 'textInflate' | 'textDeflate' | 'textInflateBottom' | 'textDeflateBottom' | 'textInflateTop' | 'textDeflateTop' | 'textDeflateInflate' | 'textDeflateInflateDeflate' | 'textFadeRight' | 'textFadeLeft' | 'textFadeUp' | 'textFadeDown' | 'textSlantUp' | 'textSlantDown' | 'textCascadeUp' | 'textCascadeDown' | 'textTriangle' | 'textTriangleInverted' | 'textChevron' | 'textChevronInverted' | 'textRingInside' | 'textRingOutside' | 'textStop' | 'textCanUp' | 'textCanDown';
+/**
+ * Adjustment values for fine-tuning warp parameters.
+ *
+ * Each warp preset has 0-2 adjustment handles that control its shape.
+ * Values are percentages (typically 0-100) or absolute values depending on preset.
+ * The specific meaning of each adjustment depends on the preset type.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.9.9 (CT_GeomGuideList)
+ *
+ * @example
+ * // textArchUp has one adjustment (arc height)
+ * { adj1: 50 }  // 50% arc height
+ *
+ * @example
+ * // textWave1 has two adjustments (amplitude, frequency)
+ * { adj1: 20, adj2: 30 }
+ */
+export interface AdjustmentValues {
+    /**
+     * Primary adjustment value.
+     * Meaning depends on the warp preset:
+     * - Arc presets: arc height/curvature
+     * - Wave presets: amplitude
+     * - Inflate/deflate: bulge amount
+     * - Fade presets: fade percentage
+     */
+    adj1?: number;
+    /**
+     * Secondary adjustment value.
+     * Meaning depends on the warp preset:
+     * - Wave presets: phase offset
+     * - Pour presets: inner radius
+     * - Some geometric presets: secondary parameter
+     */
+    adj2?: number;
+}
+/**
+ * Transform for a single character/glyph in warped text.
+ *
+ * When text is warped, each character needs individual positioning
+ * and transformation to follow the warp path correctly.
+ */
+export interface GlyphTransform {
+    /** Character index in the text string (0-based) */
+    charIndex: number;
+    /** X position along the warp path in pixels */
+    x: number;
+    /** Y position along the warp path in pixels */
+    y: number;
+    /** Rotation angle in radians (tangent to the warp path) */
+    rotation: number;
+    /**
+     * Horizontal scale factor for perspective effects.
+     * Values > 1 stretch horizontally, < 1 compress.
+     */
+    scaleX: number;
+    /**
+     * Vertical scale factor for perspective effects.
+     * Values > 1 stretch vertically, < 1 compress.
+     */
+    scaleY: number;
+    /**
+     * Opacity for this glyph (0-1).
+     * Used for fade effects where characters gradually become transparent.
+     */
+    opacity?: number;
+}
+/**
+ * Computed warp path for rendering.
+ *
+ * The warp algorithm transforms text bounding boxes into distorted paths.
+ * This is the output of the warp computation, used by the renderer.
+ * Contains SVG path data for the warp envelope and per-glyph transforms.
+ */
+export interface WarpedTextPath {
+    /**
+     * SVG path data for the top edge of the text block.
+     * Used for clipping and visual effects.
+     */
+    topPath: string;
+    /**
+     * SVG path data for the bottom edge of the text block.
+     * Used for clipping and visual effects.
+     */
+    bottomPath: string;
+    /**
+     * Transform matrix for each character/glyph position.
+     * Ordered by character index in the text string.
+     */
+    glyphTransforms: GlyphTransform[];
+    /**
+     * Overall bounds after warping (in pixels).
+     * Used for hit testing and layout calculations.
+     */
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Original text bounds before warping (in pixels).
+     * Useful for calculating relative offsets.
+     */
+    originalBounds?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Fill type discriminator for WordArt text.
+ * @see ECMA-376 Part 1, Section 20.1.8 (Fill Properties)
+ */
+export type WordArtFillType = 'solid' | 'gradient' | 'pattern' | 'none';
+/**
+ * Gradient type for gradient fills.
+ * @see ECMA-376 Part 1, Section 20.1.8.41 (CT_LinearGradientFill)
+ */
+export type GradientType = 'linear' | 'radial' | 'path';
+/** Tile flip mode for pattern and texture fills. Maps to ST_TileFlipMode (ECMA-376, dml-main.xsd). Uses lowercase variants; bridge uses PascalCase. */
+export type TileFlipMode = 'none' | 'x' | 'y' | 'xy';
+/** GradientStop — WordArt layer. Maps to CT_GradientStop (dml-main.xsd:1539) with position as 0-100% + CSS color. */
+export interface GradientStop {
+    /** Position along gradient (0-100 as percentage) */
+    position: number;
+    /** Color at this position (CSS color string: hex, rgb, rgba, hsl, named) */
+    color: string;
+    /** Opacity at this position (0-1, where 1 is fully opaque) */
+    opacity?: number;
+}
+/**
+ * Solid fill — post-theme-resolution using CSS color strings. The OOXML raw version (with DrawingColor) is in the generated ooxml-types.ts bridge.
+ * @see ECMA-376 Part 1, Section 20.1.8.51 (CT_SolidColorFillProperties)
+ */
+export interface SolidFill {
+    type: 'solid';
+    /** Fill color (CSS color string: hex, rgb, rgba, hsl, named) */
+    color: string;
+    /** Opacity (0-1, where 0 is fully transparent, 1 is fully opaque) */
+    opacity?: number;
+}
+/**
+ * Gradient fill — post-theme-resolution using CSS color strings. The OOXML raw version (with DrawingColor) is in the generated ooxml-types.ts bridge.
+ * @see ECMA-376 Part 1, Section 20.1.8.33 (CT_GradientFillProperties)
+ */
+export interface GradientFill {
+    type: 'gradient';
+    /** Type of gradient (linear, radial, or path-based) */
+    gradientType: GradientType;
+    /**
+     * Angle in degrees for linear gradients.
+     * 0 = left to right, 90 = top to bottom, 180 = right to left, 270 = bottom to top.
+     */
+    angle?: number;
+    /**
+     * Gradient stops (minimum 2 required).
+     * Defines the colors and their positions along the gradient.
+     */
+    stops: GradientStop[];
+    /**
+     * Focus point X for radial gradients (0-100 as percentage).
+     * Defines the horizontal center of the radial gradient.
+     */
+    focusX?: number;
+    /**
+     * Focus point Y for radial gradients (0-100 as percentage).
+     * Defines the vertical center of the radial gradient.
+     */
+    focusY?: number;
+    /**
+     * Whether the gradient should rotate with the shape.
+     * Default is true.
+     */
+    rotateWithShape?: boolean;
+}
+/**
+ * Pattern types from DrawingML.
+ * These are predefined hatch and fill patterns.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.10.46 (ST_PresetPatternVal)
+ */
+export type PatternType = 'pct5' | 'pct10' | 'pct20' | 'pct25' | 'pct30' | 'pct40' | 'pct50' | 'pct60' | 'pct70' | 'pct75' | 'pct80' | 'pct90' | 'horz' | 'vert' | 'ltHorz' | 'ltVert' | 'dkHorz' | 'dkVert' | 'narHorz' | 'narVert' | 'dashHorz' | 'dashVert' | 'cross' | 'dnDiag' | 'upDiag' | 'ltDnDiag' | 'ltUpDiag' | 'dkDnDiag' | 'dkUpDiag' | 'wdDnDiag' | 'wdUpDiag' | 'dashDnDiag' | 'dashUpDiag' | 'diagCross' | 'smCheck' | 'lgCheck' | 'smGrid' | 'lgGrid' | 'dotGrid' | 'smConfetti' | 'lgConfetti' | 'horzBrick' | 'diagBrick' | 'solidDmnd' | 'openDmnd' | 'dotDmnd' | 'plaid' | 'sphere' | 'weave' | 'divot' | 'shingle' | 'wave' | 'trellis' | 'zigZag';
+/**
+ * Pattern fill — post-theme-resolution using CSS color strings. The OOXML raw version (with DrawingColor) is in the generated ooxml-types.ts bridge.
+ * @see ECMA-376 Part 1, Section 20.1.8.47 (CT_PatternFillProperties)
+ */
+export interface PatternFill {
+    type: 'pattern';
+    /** Pattern type (matches DrawingML preset patterns) */
+    pattern: PatternType;
+    /** Foreground color (CSS color string: hex, rgb, rgba, hsl, named) */
+    fgColor: string;
+    /** Background color (CSS color string: hex, rgb, rgba, hsl, named) */
+    bgColor: string;
+    /** Opacity for the entire pattern (0-1) */
+    opacity?: number;
+}
+/**
+ * No fill (transparent).
+ * Text will be rendered without any fill color.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.8.45 (CT_NoFillProperties)
+ */
+export interface NoFill {
+    type: 'none';
+}
+/**
+ * Union type for all fill types.
+ * Used for WordArt text fill configuration.
+ */
+export type WordArtFill = SolidFill | GradientFill | PatternFill | NoFill;
+/**
+ * Line dash style for outlines.
+ * @see ECMA-376 Part 1, Section 20.1.10.48 (ST_PresetLineDashVal)
+ */
+export type LineDash = 'solid' | 'dot' | 'dash' | 'dashDot' | 'lgDash' | 'lgDashDot' | 'lgDashDotDot' | 'sysDash' | 'sysDot' | 'sysDashDot' | 'sysDashDotDot';
+/** Line cap style. Maps to ST_LineCap (ECMA-376, dml-main.xsd). Uses lowercase variants; bridge uses PascalCase. */
+export type LineCap = 'flat' | 'round' | 'square';
+/** Line join style. Maps to EG_LineJoinProperties (ECMA-376, dml-main.xsd). Uses lowercase variants; bridge uses tagged union. */
+export type LineJoin = 'bevel' | 'miter' | 'round';
+/** Compound line type for multi-line strokes. Maps to ST_CompoundLine (ECMA-376, dml-main.xsd). Uses camelCase variants; bridge uses PascalCase. */
+export type CompoundLine = 'sng' | 'dbl' | 'thickThin' | 'thinThick' | 'tri';
+/**
+ * WordArt text outline configuration.
+ * Defines the stroke/border around text characters.
+ *
+ * @see ECMA-376 Part 1, Section 20.1.8.38 (CT_LineProperties)
+ */
+export interface WordArtOutline {
+    /**
+     * Outline width in points (1pt = 1/72 inch).
+     * Typical values range from 0.5 to 6 points.
+     */
+    width: number;
+    /** Outline color (CSS color string: hex, rgb, rgba, hsl, named) */
+    color: string;
+    /** Opacity (0-1, where 0 is fully transparent, 1 is fully opaque) */
+    opacity?: number;
+    /** Dash style (default: 'solid') */
+    dash?: LineDash;
+    /** Line cap style (default: 'flat') */
+    cap?: LineCap;
+    /** Line join style (default: 'round') */
+    join?: LineJoin;
+    /**
+     * Miter limit for miter joins.
+     * When the miter length exceeds this ratio of the line width,
+     * the join is rendered as a bevel instead.
+     */
+    miterLimit?: number;
+    /** Compound line type for multi-stroke outlines */
+    compound?: CompoundLine;
+}
+import type { TextEffects } from './effects';
+export type { TextEffects };
+/**
+ * WordArt configuration for a TextBoxObject.
+ *
+ * When applied to a TextBoxObject, this config transforms regular text
+ * into stylized WordArt with warping, fills, and effects.
+ *
+ * This is the main configuration type for WordArt - it contains all
+ * the settings needed to render text with decorative styling.
+ *
+ * @see ECMA-376 Part 1, Section 21.1.2.2.33 (txBody - Text Body)
+ *
+ * @example
+ * // Basic WordArt with arch warp
+ * const config: WordArtConfig = {
+ *   warpPreset: 'textArchUp',
+ *   warpAdjustments: { adj1: 50 },
+ *   fill: { type: 'gradient', gradientType: 'linear', angle: 90, stops: [...] },
+ *   outline: { width: 1.5, color: '#000000' }
+ * };
+ *
+ * @example
+ * // WordArt with effects
+ * const config: WordArtConfig = {
+ *   warpPreset: 'textWave1',
+ *   fill: { type: 'solid', color: '#FF6600' },
+ *   effects: {
+ *     outerShadow: { blurRadius: 40000, distance: 25000, direction: 45, color: '#000000', opacity: 0.35 }
+ *   }
+ * };
+ */
+export interface WordArtConfig {
+    /**
+     * Text warp preset type.
+     * Determines the geometric transformation applied to the text.
+     */
+    warpPreset: TextWarpPreset;
+    /**
+     * Fine-tune warp parameters.
+     * Values depend on the preset type.
+     */
+    warpAdjustments?: AdjustmentValues;
+    /**
+     * Text fill (solid, gradient, pattern, or none).
+     * Defines how the interior of text characters is colored.
+     */
+    fill: WordArtFill;
+    /**
+     * Text outline/stroke.
+     * Defines the border around text characters.
+     */
+    outline?: WordArtOutline;
+    /**
+     * Text effects (shadow, glow, reflection, bevel, 3D).
+     * Adds visual effects to the text.
+     */
+    effects?: TextEffects;
+    /**
+     * Whether text follows the warp path exactly (true) or flows naturally (false).
+     *
+     * - `true` (default): Each glyph is positioned and rotated to follow the warp path
+     *   tangent. Used for arc, circle, and path-following effects where text should
+     *   curve with the path. The rotation of each character matches the path direction.
+     *
+     * - `false`: Text maintains its baseline orientation while the overall shape is
+     *   warped. Used for inflate/deflate effects where text distorts but doesn't rotate.
+     *   Characters remain upright even as they are scaled/positioned along the path.
+     */
+    followPath?: boolean;
+    /**
+     * Text anchoring within the warp bounds.
+     * Controls where text is positioned within the warped area.
+     */
+    anchor?: 'top' | 'middle' | 'bottom';
+    /**
+     * Text direction.
+     * Affects how text flows within the warp.
+     */
+    textDirection?: 'ltr' | 'rtl';
+    /**
+     * Normalize letter heights across different characters.
+     * When true, all characters are scaled to have the same height.
+     */
+    normalizeHeights?: boolean;
+}
+import type { WarpPresetDefinition } from './presets';
+/**
+ * Bridge interface for WordArt warp computation.
+ *
+ * The bridge provides methods for computing warp paths and retrieving preset
+ * definitions. It can be used in background threads for heavy computation
+ * without blocking the main thread.
+ *
+ * IMPORTANT: This interface returns portable WarpedTextPath data structures
+ * rather than browser-specific Path2D objects. The conversion to Path2D
+ * happens in the renderer layer for optimal performance in the browser.
+ *
+ * @see WarpedTextPath for the output data structure
+ * @see WarpPresetDefinition for preset metadata
+ */
+export interface IWordArtBridge {
+    /**
+     * Compute the warp path for text with the given configuration.
+     *
+     * This is the core warp computation method. It takes text content,
+     * WordArt configuration, font size, and bounding box dimensions,
+     * and returns a WarpedTextPath with SVG path data and glyph transforms.
+     *
+     * @param text The text content to warp
+     * @param config The WordArt configuration containing warp preset and adjustments
+     * @param fontSize The font size in pixels (affects glyph spacing and scaling)
+     * @param bounds The bounding box dimensions for the warped text
+     * @returns Computed warp path with SVG paths and per-glyph transforms
+     *
+     * @example
+     * const warpedPath = bridge.computeWarpPath(
+     *   'Hello World',
+     *   { warpPreset: 'textArchUp', fill: { type: 'solid', color: '#000' } },
+     *   36,
+     *   { width: 200, height: 100 }
+     * );
+     */
+    computeWarpPath(text: string, config: WordArtConfig, fontSize: number, bounds: {
+        width: number;
+        height: number;
+    }): WarpedTextPath;
+    /**
+     * Get the preset definition for a warp preset type.
+     *
+     * Returns metadata about the preset including display name, description,
+     * default adjustment values, and category. Returns undefined if the
+     * preset type is not recognized.
+     *
+     * @param preset The warp preset identifier
+     * @returns Preset definition or undefined if not found
+     *
+     * @example
+     * const def = bridge.getPresetDefinition('textArchUp');
+     * if (def) {
+     *   console.log(def.name); // 'Arch Up'
+     *   console.log(def.defaultAdjustments); // { adj1: 50 }
+     * }
+     */
+    getPresetDefinition(preset: TextWarpPreset): WarpPresetDefinition | undefined;
+    /**
+     * Get the default WordArt configuration.
+     *
+     * Returns a configuration with sensible defaults for creating new WordArt:
+     * - warpPreset: 'textPlain' (no warp)
+     * - fill: Blue gradient
+     * - effects: Subtle outer shadow
+     *
+     * @returns Default WordArt configuration
+     *
+     * @example
+     * const config = bridge.getDefaultConfig();
+     * // Customize from defaults
+     * config.warpPreset = 'textArchUp';
+     */
+    getDefaultConfig(): WordArtConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/wordart/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/wordart/types.ts"],"names":[],"mappings":"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"}