aurochs 0.6.4 → 0.7.0

package/dist/@aurochs-renderer/docx/src/react/DocumentRenderer.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+import { PageLayout, SelectionRect, CursorCoordinates } from '@aurochs-office/text-layout';
+export type DocumentRendererProps = {
+    /** All pages in the document */
+    readonly pages: readonly PageLayout[];
+    /** Selection rectangles */
+    readonly selection?: readonly SelectionRect[];
+    /** Cursor coordinates */
+    readonly cursor?: CursorCoordinates;
+    /** Whether cursor should blink */
+    readonly showCursor?: boolean;
+    /** Page click handler */
+    readonly onPageClick?: (pageIndex: number, x: number, y: number) => void;
+    /** Page double-click handler */
+    readonly onPageDoubleClick?: (pageIndex: number, x: number, y: number) => void;
+};
+/**
+ * Renders all pages of a DOCX document.
+ */
+export declare function DocumentRenderer({ pages, selection, cursor, showCursor, onPageClick, onPageDoubleClick, }: DocumentRendererProps): ReactNode;

package/dist/@aurochs-renderer/docx/src/react/PageRenderer.d.ts

@@ -0,0 +1,22 @@
+import { ReactNode } from 'react';
+import { PageLayout, SelectionRect, CursorCoordinates } from '@aurochs-office/text-layout';
+export type PageRendererProps = {
+    /** Page layout data */
+    readonly page: PageLayout;
+    /** Page index */
+    readonly pageIndex: number;
+    /** Selection rectangles on this page */
+    readonly selection?: readonly SelectionRect[];
+    /** Cursor coordinates if on this page */
+    readonly cursor?: CursorCoordinates;
+    /** Whether cursor should blink */
+    readonly showCursor?: boolean;
+    /** Page click handler */
+    readonly onClick?: (pageIndex: number, x: number, y: number) => void;
+    /** Page double-click handler */
+    readonly onDoubleClick?: (pageIndex: number, x: number, y: number) => void;
+};
+/**
+ * Renders a single page of a DOCX document.
+ */
+export declare function PageRenderer({ page, pageIndex, selection, cursor, showCursor, onClick, onDoubleClick, }: PageRendererProps): ReactNode;

package/dist/@aurochs-renderer/docx/src/react/context/docx-drawing-ml-adapter.d.ts

@@ -0,0 +1,52 @@
+import { DrawingMLRenderContext } from '@aurochs-renderer/drawing-ml/react';
+import { ColorContext } from '@aurochs-office/drawing-ml/domain/color-context';
+import { DocxDrawingRenderContext, DocxResourceResolver } from './types';
+/**
+ * Create a DrawingML render context from DOCX drawing context.
+ *
+ * This adapter bridges DOCX-specific context to the format-agnostic
+ * DrawingML rendering context used by shared rendering components.
+ *
+ * @param docxContext - DOCX drawing render context
+ * @returns DrawingML render context suitable for DrawingMLProvider
+ *
+ * @example
+ * ```tsx
+ * function DocxDrawingRenderer({ docxContext }: Props) {
+ *   const drawingMLContext = createDrawingMLContextFromDocx(docxContext);
+ *
+ *   return (
+ *     <DrawingMLProvider {...drawingMLContext}>
+ *       <SharedDrawingComponent />
+ *     </DrawingMLProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function createDrawingMLContextFromDocx(docxContext: DocxDrawingRenderContext): Omit<DrawingMLRenderContext, "getNextId"> & {
+    getNextId: (prefix: string) => string;
+};
+/**
+ * Create an empty DOCX resource resolver (for testing).
+ */
+export declare function createEmptyDocxResourceResolver(): DocxResourceResolver;
+/**
+ * Create a DOCX resource resolver from relationship data and file reader.
+ *
+ * @param relationships - Document relationships array
+ * @param readFile - Function to read file content from package
+ * @param getMimeType - Function to get MIME type from path
+ * @returns Resource resolver for DOCX drawings
+ */
+export declare function createDocxResourceResolver(relationships: ReadonlyMap<string, {
+    target: string;
+    type: string;
+}>, readFile: (path: string) => Uint8Array | null, getMimeType: (path: string) => string | undefined): DocxResourceResolver;
+/**
+ * Create an empty color context (for testing or when no theme is available).
+ */
+export declare function createEmptyColorContext(): ColorContext;
+/**
+ * Create a default DOCX drawing render context for testing.
+ */
+export declare function createDefaultDocxDrawingContext(): DocxDrawingRenderContext;

package/dist/@aurochs-renderer/docx/src/react/context/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file DOCX Drawing Context Module
+ *
+ * Exports context types and adapter for DOCX drawing rendering.
+ */
+export type { DocxResourceResolver, DocxRenderWarning, DocxWarningCollector, DocxPageSize, DocxPageMargins, DocxDrawingRenderContext, } from './types';
+export { createDrawingMLContextFromDocx, createEmptyDocxResourceResolver, createDocxResourceResolver, createEmptyColorContext, createDefaultDocxDrawingContext, } from './docx-drawing-ml-adapter';

package/dist/@aurochs-renderer/docx/src/react/drawing/AnchorDrawing.d.ts

@@ -0,0 +1,26 @@
+import { DocxAnchorDrawing } from '@aurochs-office/docx/domain/drawing';
+import { DocxResourceResolver } from '../context';
+/**
+ * Props for AnchorDrawing component.
+ */
+export type AnchorDrawingProps = {
+    /** Anchor drawing data */
+    readonly drawing: DocxAnchorDrawing;
+    /** Computed X position in pixels (from layout) */
+    readonly x: number;
+    /** Computed Y position in pixels (from layout) */
+    readonly y: number;
+    /** Resource resolver for images */
+    readonly resources: DocxResourceResolver;
+    /** Unique ID prefix for clip paths */
+    readonly idPrefix?: string;
+};
+/**
+ * Renders an anchor drawing (wp:anchor) as SVG group.
+ */
+declare function AnchorDrawingBase({ drawing, x, y, resources, idPrefix }: AnchorDrawingProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Memoized AnchorDrawing component.
+ */
+export declare const AnchorDrawing: import('react').MemoExoticComponent<typeof AnchorDrawingBase>;
+export {};

package/dist/@aurochs-renderer/docx/src/react/drawing/ChartPlaceholder.d.ts

@@ -0,0 +1,34 @@
+import { DocxChart } from '@aurochs-office/docx/domain/drawing';
+import { Chart } from '@aurochs-office/chart/domain';
+import { DocxDrawingRenderContext } from '../context';
+/**
+ * Props for ChartPlaceholder component.
+ */
+export type ChartPlaceholderProps = {
+    /** Chart reference data */
+    readonly chart: DocxChart;
+    /** Width in pixels */
+    readonly width: number;
+    /** Height in pixels */
+    readonly height: number;
+    /** X position in pixels */
+    readonly x?: number;
+    /** Y position in pixels */
+    readonly y?: number;
+    /** Parsed chart data (optional - when provided, renders actual chart) */
+    readonly chartData?: Chart;
+    /** DOCX drawing render context (required when chartData is provided) */
+    readonly renderContext?: DocxDrawingRenderContext;
+};
+/**
+ * Renders a chart placeholder as SVG elements.
+ *
+ * When chartData and renderContext are provided, renders the actual chart.
+ * Otherwise, renders a placeholder with information about the chart reference.
+ */
+declare function ChartPlaceholderBase({ chart, width, height, x, y, chartData, renderContext, }: ChartPlaceholderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Memoized ChartPlaceholder component.
+ */
+export declare const ChartPlaceholder: import('react').MemoExoticComponent<typeof ChartPlaceholderBase>;
+export {};

package/dist/@aurochs-renderer/docx/src/react/drawing/FloatingImageOverlay.d.ts

@@ -0,0 +1,20 @@
+import { PositionedFloatingImage } from '@aurochs-office/text-layout';
+/**
+ * Props for FloatingImageOverlay component.
+ */
+export type FloatingImageOverlayProps = {
+    /** Array of positioned floating images to render */
+    readonly images: readonly PositionedFloatingImage[];
+    /** Unique ID prefix for clip paths */
+    readonly idPrefix?: string;
+};
+/**
+ * Renders all floating images as an overlay.
+ * Images are sorted by z-index (relativeHeight) and behindDoc flag.
+ */
+declare function FloatingImageOverlayBase({ images, idPrefix }: FloatingImageOverlayProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Memoized FloatingImageOverlay component.
+ */
+export declare const FloatingImageOverlay: import('react').MemoExoticComponent<typeof FloatingImageOverlayBase>;
+export {};

package/dist/@aurochs-renderer/docx/src/react/drawing/InlineDrawing.d.ts

@@ -0,0 +1,26 @@
+import { DocxInlineDrawing } from '@aurochs-office/docx/domain/drawing';
+import { DocxResourceResolver } from '../context';
+/**
+ * Props for InlineDrawing component.
+ */
+export type InlineDrawingProps = {
+    /** Inline drawing data */
+    readonly drawing: DocxInlineDrawing;
+    /** X position in pixels (from text layout) */
+    readonly x: number;
+    /** Y position in pixels (from text layout) */
+    readonly y: number;
+    /** Resource resolver for images */
+    readonly resources: DocxResourceResolver;
+    /** Unique ID prefix for clip paths */
+    readonly idPrefix?: string;
+};
+/**
+ * Renders an inline drawing (wp:inline) as SVG group.
+ */
+declare function InlineDrawingBase({ drawing, x, y, resources, idPrefix }: InlineDrawingProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Memoized InlineDrawing component.
+ */
+export declare const InlineDrawing: import('react').MemoExoticComponent<typeof InlineDrawingBase>;
+export {};

package/dist/@aurochs-renderer/docx/src/react/drawing/Picture.d.ts

@@ -0,0 +1,25 @@
+import { DrawingPicture } from '@aurochs-office/ooxml/domain/drawing';
+/**
+ * Props for Picture component.
+ */
+export type PictureProps = {
+    /** Picture data from drawing */
+    readonly picture: DrawingPicture;
+    /** Width in pixels */
+    readonly width: number;
+    /** Height in pixels */
+    readonly height: number;
+    /** Resolved image URL (data URL or path) */
+    readonly imageUrl: string | undefined;
+    /** Unique ID for clip path */
+    readonly clipId?: string;
+};
+/**
+ * Renders a picture (pic:pic) as SVG image element.
+ */
+declare function PictureBase({ picture, width, height, imageUrl, clipId }: PictureProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Memoized Picture component.
+ */
+export declare const Picture: import('react').MemoExoticComponent<typeof PictureBase>;
+export {};

package/dist/@aurochs-renderer/docx/src/react/drawing/TextBox.d.ts

@@ -0,0 +1,25 @@
+import { DocxTextBoxContent, DocxBodyProperties } from '@aurochs-office/docx/domain/drawing';
+/**
+ * Props for TextBox component.
+ */
+export type TextBoxProps = {
+    /** Text box content */
+    readonly content: DocxTextBoxContent;
+    /** Body properties (layout constraints) */
+    readonly bodyPr?: DocxBodyProperties;
+    /** Container width in pixels */
+    readonly width: number;
+    /** Container height in pixels */
+    readonly height: number;
+    /** Unique ID prefix for clip paths */
+    readonly idPrefix?: string;
+};
+/**
+ * Renders text box content as SVG text elements.
+ */
+declare function TextBoxBase({ content, bodyPr, width, height, idPrefix }: TextBoxProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Memoized TextBox component.
+ */
+export declare const TextBox: import('react').MemoExoticComponent<typeof TextBoxBase>;
+export {};

package/dist/@aurochs-renderer/docx/src/react/drawing/WordprocessingShape.d.ts

@@ -0,0 +1,23 @@
+import { DocxWordprocessingShape } from '@aurochs-office/docx/domain/drawing';
+/**
+ * Props for WordprocessingShape component.
+ */
+export type WordprocessingShapeProps = {
+    /** Shape data */
+    readonly shape: DocxWordprocessingShape;
+    /** Width in pixels */
+    readonly width: number;
+    /** Height in pixels */
+    readonly height: number;
+    /** Unique ID prefix for patterns/gradients */
+    readonly idPrefix?: string;
+};
+/**
+ * Renders a WordprocessingML shape (wps:wsp) as SVG elements.
+ */
+declare function WordprocessingShapeBase({ shape, width, height, idPrefix }: WordprocessingShapeProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Memoized WordprocessingShape component.
+ */
+export declare const WordprocessingShape: import('react').MemoExoticComponent<typeof WordprocessingShapeBase>;
+export {};

package/dist/@aurochs-renderer/docx/src/react/drawing/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file DOCX Drawing Components Module
+ *
+ * React components for rendering DrawingML elements in DOCX documents.
+ *
+ * @see ECMA-376 Part 1, Section 20.4 (DrawingML - WordprocessingML Drawing)
+ */
+export { Picture, type PictureProps } from './Picture';
+export { InlineDrawing, type InlineDrawingProps } from './InlineDrawing';
+export { AnchorDrawing, type AnchorDrawingProps } from './AnchorDrawing';
+export { FloatingImageOverlay, type FloatingImageOverlayProps } from './FloatingImageOverlay';
+export { WordprocessingShape, type WordprocessingShapeProps } from './WordprocessingShape';
+export { ChartPlaceholder, type ChartPlaceholderProps } from './ChartPlaceholder';
+export { TextBox, type TextBoxProps } from './TextBox';

package/dist/@aurochs-renderer/docx/src/react/hooks/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @file React hooks for DOCX rendering
+ */
+export { type DocumentLayoutMode, type UseDocumentLayoutOptions, type DocumentLayoutResult, useDocumentLayout, createParagraphKey, haveParagraphsChanged, } from './useDocumentLayout';

package/dist/@aurochs-renderer/docx/src/react/hooks/useDocumentLayout.d.ts

@@ -0,0 +1,47 @@
+import { DocxParagraph } from '@aurochs-office/docx/domain/paragraph';
+import { DocxSectionProperties } from '@aurochs-office/docx/domain/section';
+import { DocxNumbering } from '@aurochs-office/docx/domain/numbering';
+import { Pixels } from '@aurochs-office/drawing-ml/domain/units';
+import { LayoutParagraphResult, LayoutParagraphInput, PagedLayoutResult, PageFlowConfig } from '@aurochs-office/text-layout';
+export type DocumentLayoutMode = "paged" | "continuous";
+export type UseDocumentLayoutOptions = {
+    /** Paragraphs to layout */
+    readonly paragraphs: readonly DocxParagraph[];
+    /** Content width in pixels (without margins) - overrides sectPr if provided */
+    readonly contentWidth?: Pixels;
+    /** Layout mode */
+    readonly mode?: DocumentLayoutMode;
+    /** Page configuration (for paged mode) - overrides sectPr if provided */
+    readonly pageConfig?: PageFlowConfig;
+    /** Section properties from the document - used to derive page config */
+    readonly sectPr?: DocxSectionProperties;
+    /** Numbering definitions from the document - for list rendering */
+    readonly numbering?: DocxNumbering;
+};
+export type DocumentLayoutResult = {
+    /** Paged layout result */
+    readonly pagedLayout: PagedLayoutResult;
+    /** Flat layout result (all paragraphs) */
+    readonly paragraphs: readonly LayoutParagraphResult[];
+    /** Total document height */
+    readonly totalHeight: Pixels;
+    /** Layout inputs (for cursor/selection calculations) */
+    readonly layoutInputs: readonly LayoutParagraphInput[];
+};
+/**
+ * Hook for computing document layout.
+ *
+ * Page configuration is determined in this order:
+ * 1. Explicit pageConfig parameter (highest priority)
+ * 2. sectPr from the document
+ * 3. DEFAULT_PAGE_FLOW_CONFIG (ECMA-376 specification defaults)
+ */
+export declare function useDocumentLayout({ paragraphs, contentWidth: explicitContentWidth, mode, pageConfig: explicitPageConfig, sectPr, numbering, }: UseDocumentLayoutOptions): DocumentLayoutResult;
+/**
+ * Create a stable key for paragraph array for caching.
+ */
+export declare function createParagraphKey(paragraphs: readonly DocxParagraph[]): string;
+/**
+ * Check if paragraphs have changed significantly.
+ */
+export declare function haveParagraphsChanged(prev: readonly DocxParagraph[], next: readonly DocxParagraph[]): boolean;

package/dist/@aurochs-renderer/docx/src/react/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file React components for DOCX rendering
+ */
+export { type PageRendererProps, PageRenderer } from './PageRenderer';
+export { type DocumentRendererProps, DocumentRenderer } from './DocumentRenderer';
+export { type DocumentLayoutMode, type UseDocumentLayoutOptions, type DocumentLayoutResult, useDocumentLayout, createParagraphKey, haveParagraphsChanged, } from './hooks';
+export { type DocxResourceResolver, type DocxRenderWarning, type DocxWarningCollector, type DocxPageSize, type DocxPageMargins, type DocxDrawingRenderContext, createDrawingMLContextFromDocx, createEmptyDocxResourceResolver, createDocxResourceResolver, createEmptyColorContext, createDefaultDocxDrawingContext, } from './context';
+export { Picture, type PictureProps, InlineDrawing, type InlineDrawingProps, AnchorDrawing, type AnchorDrawingProps, FloatingImageOverlay, type FloatingImageOverlayProps, WordprocessingShape, type WordprocessingShapeProps, ChartPlaceholder, type ChartPlaceholderProps, } from './drawing';

package/dist/@aurochs-renderer/pptx/src/animation/browser-effects.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @file Browser Animation Effects
+ *
+ * JS-based animation effects using requestAnimationFrame.
+ * All 15 effects from MS-OE376 Part 4 Section 4.6.3.
+ *
+ * @see MS-OE376 Part 4 Section 4.6.3
+ * @see ECMA-376 Part 1, Section 19.5.3 (p:animEffect)
+ */
+export type BrowserEffectType = "fade" | "slide" | "wipe" | "blinds" | "box" | "checkerboard" | "circle" | "diamond" | "dissolve" | "strips" | "wheel" | "plus" | "barn" | "randombar" | "wedge";
+export type BrowserEffectDirection = string;
+export type ParsedFilter = {
+    type: BrowserEffectType;
+    direction: string;
+};
+/**
+ * Parse filter string to effect type and direction.
+ * @see MS-OE376 Part 4 Section 4.6.3
+ */
+export declare function parseFilter(filter: string): ParsedFilter;
+/**
+ * Fade effect - simple opacity transition.
+ * @see MS-OE376 Part 4 Section 4.6.3 - fade filter (no subtypes)
+ */
+export declare function animateFade(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Slide effect - fly in/out from direction.
+ * @see MS-OE376 Part 4 Section 4.6.3 - slide filter
+ */
+export declare function animateSlide(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Wipe effect - reveal with clip-path.
+ * @see MS-OE376 Part 4 Section 4.6.3 - wipe filter
+ */
+export declare function animateWipe(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Blinds effect - horizontal or vertical blinds.
+ * @see MS-OE376 Part 4 Section 4.6.3 - blinds filter
+ */
+export declare function animateBlinds(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Box effect - expand/contract from center.
+ * @see MS-OE376 Part 4 Section 4.6.3 - box filter
+ */
+export declare function animateBox(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Circle effect - circular reveal from center.
+ * @see MS-OE376 Part 4 Section 4.6.3 - circle filter
+ */
+export declare function animateCircle(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Diamond effect - diamond-shaped reveal from center.
+ * @see MS-OE376 Part 4 Section 4.6.3 - diamond filter
+ */
+export declare function animateDiamond(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Dissolve effect - pixelated dissolve (approximated with blur).
+ * @see MS-OE376 Part 4 Section 4.6.3 - dissolve filter
+ */
+export declare function animateDissolve(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Strips effect - diagonal strips.
+ * @see MS-OE376 Part 4 Section 4.6.3 - strips filter
+ */
+export declare function animateStrips(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Wheel effect - rotating wheel reveal.
+ * @see MS-OE376 Part 4 Section 4.6.3 - wheel filter
+ */
+export declare function animateWheel(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Plus effect - plus/cross shape from center.
+ * @see MS-OE376 Part 4 Section 4.6.3 - plus filter
+ */
+export declare function animatePlus(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Barn effect - barn door opening/closing.
+ * @see MS-OE376 Part 4 Section 4.6.3 - barn filter
+ */
+export declare function animateBarn(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Randombar effect - random horizontal or vertical bars.
+ * @see MS-OE376 Part 4 Section 4.6.3 - randombar filter
+ */
+export declare function animateRandombar(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Wedge effect - wedge shape from center.
+ * @see MS-OE376 Part 4 Section 4.6.3 - wedge filter
+ */
+export declare function animateWedge(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Checkerboard effect - checkerboard pattern reveal.
+ * @see MS-OE376 Part 4 Section 4.6.3 - checkerboard filter
+ */
+export declare function animateCheckerboard(el: HTMLElement | SVGElement, duration: number, direction: string): Promise<void>;
+/**
+ * Apply effect by type.
+ * @see MS-OE376 Part 4 Section 4.6.3
+ */
+export declare function applyBrowserEffect({ el, type, duration, direction, }: {
+    el: HTMLElement | SVGElement;
+    type: BrowserEffectType;
+    duration: number;
+    direction: string;
+}): Promise<void>;

package/dist/@aurochs-renderer/pptx/src/animation/click-groups.d.ts

@@ -0,0 +1,38 @@
+import { TimeNode } from '@aurochs-office/pptx/domain/animation';
+/**
+ * Click group for step-by-step animation playback.
+ *
+ * Represents a group of animations that play on a single click/tap in PowerPoint.
+ * In ECMA-376, these are `clickEffect` nodes within the `mainSeq` sequence.
+ *
+ * @see ECMA-376 Part 1, Section 19.5.33 (cTn nodeType)
+ */
+export type ClickGroup = {
+    /** 0-based group index */
+    readonly index: number;
+    /** Time nodes to play for this click */
+    readonly nodes: readonly TimeNode[];
+    /** Whether this group auto-advances without waiting for click */
+    readonly isAutoAdvance: boolean;
+};
+/**
+ * Timing-like object for extraction.
+ */
+export type TimingLike = {
+    readonly rootTimeNode?: TimeNode;
+};
+/**
+ * Extract click groups from timing tree.
+ *
+ * Click groups represent sets of animations that play together on a single
+ * click/tap. In PowerPoint, each click advances through these groups.
+ *
+ * @example
+ * ```typescript
+ * const groups = extractClickGroups(timing);
+ * // groups[0] = first click group
+ * // groups[1] = second click group
+ * // etc.
+ * ```
+ */
+export declare function extractClickGroups(timing: TimingLike | null): ClickGroup[];

package/dist/@aurochs-renderer/pptx/src/animation/color-interpolate.d.ts

@@ -0,0 +1,70 @@
+import { AnimateColorBehavior, AnimateColorSpace, AnimateColorDirection } from '@aurochs-office/pptx/domain/animation';
+import { HslColor, RgbColor } from '@aurochs/color';
+/**
+ * Parsed color with alpha
+ */
+export type ParsedColor = {
+    readonly rgb: RgbColor;
+    readonly alpha: number;
+};
+/**
+ * Parse a color string into RGB values.
+ *
+ * Supported formats:
+ * - "#RRGGBB" (hex)
+ * - "#RGB" (short hex)
+ * - "#AARRGGBB" (hex with alpha)
+ * - "rgb(r, g, b)"
+ * - "rgba(r, g, b, a)"
+ * - "hsl(h, s%, l%)"
+ * - "hsla(h, s%, l%, a)"
+ * - Named colors
+ *
+ * @param color - Color string
+ * @returns Parsed color or undefined if unparseable
+ */
+export declare function parseColor(color: string | undefined): ParsedColor | undefined;
+/**
+ * Interpolate between two RGB colors.
+ *
+ * @param from - Start color
+ * @param to - End color
+ * @param t - Progress (0-1)
+ * @returns Interpolated color
+ */
+export declare function lerpRGB(from: RgbColor, to: RgbColor, t: number): RgbColor;
+/**
+ * Interpolate between two HSL colors with direction control.
+ *
+ * @param from - Start color (h: 0-360, s/l: 0-1)
+ * @param to - End color (h: 0-360, s/l: 0-1)
+ * @param t - Progress (0-1)
+ * @param direction - Hue rotation direction: "cw" (clockwise) or "ccw" (counter-clockwise)
+ * @returns Interpolated color
+ */
+export declare function lerpHSL({ from, to, t, direction, }: {
+    from: HslColor;
+    to: HslColor;
+    t: number;
+    direction?: AnimateColorDirection;
+}): HslColor;
+/** Interpolate between two parsed colors and return a CSS color string */
+export declare function interpolateColor({ from, to, t, colorSpace, direction, }: {
+    from: ParsedColor;
+    to: ParsedColor;
+    t: number;
+    colorSpace?: AnimateColorSpace;
+    direction?: AnimateColorDirection;
+}): string;
+/**
+ * Convert RGB to hex string using existing utility.
+ */
+export declare function rgbToHexString(rgb: RgbColor): string;
+/**
+ * Create an animation function for color animation.
+ *
+ * @param behavior - AnimateColorBehavior from timing tree
+ * @param element - Target DOM element
+ * @returns Animation update function (progress: 0-1) => void
+ */
+export declare function createColorAnimationFunction(behavior: AnimateColorBehavior, element: HTMLElement | SVGElement): (progress: number) => void;