@a3s-lab/office 0.1.0

package/dist/internal/features/work/work-pptx-chart-data-labels.d.ts

@@ -0,0 +1,12 @@
+import type { WorkSlide, WorkSlideChart, WorkSlideChartDataLabels, WorkSlideChartType } from './work-types';
+export interface PptxChartDataLabelDiagnostic {
+    code: string;
+    message: string;
+}
+export interface PptxChartDataLabelReadResult {
+    dataLabels?: WorkSlideChartDataLabels;
+    diagnostics: PptxChartDataLabelDiagnostic[];
+}
+export declare function readPptxChartDataLabels(chartNode: Element | undefined, chartType: WorkSlideChartType): PptxChartDataLabelReadResult;
+export declare function patchPptxChartDataLabels(buffer: ArrayBuffer, slides: readonly WorkSlide[]): Promise<ArrayBuffer>;
+export declare function writePptxChartDataLabels(document: Document, chartNode: Element, chart: WorkSlideChart): void;

package/dist/internal/features/work/work-pptx-chart-import.d.ts

@@ -0,0 +1,11 @@
+import type { WorkSlideChart } from './work-types';
+export interface PptxChartImportDiagnostic {
+    code: string;
+    feature: string;
+    message: string;
+}
+export interface PptxChartImportResult {
+    chart: WorkSlideChart;
+    diagnostics: PptxChartImportDiagnostic[];
+}
+export declare function readPptxChart(document: Document): PptxChartImportResult;

package/dist/internal/features/work/work-pptx-chart-layout-style.d.ts

@@ -0,0 +1,15 @@
+import { type WorkSpreadsheetChartLayout } from './work-spreadsheet-chart-layout';
+import type { WorkSlide, WorkSlideChart, WorkSlideChartSeriesStyle } from './work-types';
+export interface PptxChartFormattingDiagnostic {
+    code: string;
+    message: string;
+}
+export interface PptxChartLayoutStyleReadResult {
+    legendOverlay?: boolean;
+    layout: WorkSpreadsheetChartLayout;
+    seriesStyles: Array<WorkSlideChartSeriesStyle | undefined>;
+    diagnostics: PptxChartFormattingDiagnostic[];
+}
+export declare function readPptxChartLayoutAndSeriesStyles(document: Document, chartNode: Element | undefined, chartType: WorkSlideChart['type'], seriesNodes: readonly Element[]): PptxChartLayoutStyleReadResult;
+export declare function patchPptxChartLayoutAndSeriesStyles(buffer: ArrayBuffer, slides: readonly WorkSlide[]): Promise<ArrayBuffer>;
+export declare function writePptxChartLayoutAndSeriesStyles(document: Document, chartNode: Element, chart: WorkSlideChart): void;

package/dist/internal/features/work/work-pptx-chart-series-analysis.d.ts

@@ -0,0 +1,13 @@
+import { type WorkSlide, type WorkSlideChart, type WorkSpreadsheetErrorBars, type WorkSpreadsheetTrendline } from './work-types';
+export interface PptxChartSeriesAnalysisDiagnostic {
+    code: string;
+    message: string;
+}
+export interface PptxChartSeriesAnalysisReadResult {
+    trendlines?: WorkSpreadsheetTrendline[];
+    errorBars?: WorkSpreadsheetErrorBars[];
+    diagnostics: PptxChartSeriesAnalysisDiagnostic[];
+}
+export declare function readPptxChartSeriesAnalysis(seriesNode: Element, chartType: WorkSlideChart['type']): PptxChartSeriesAnalysisReadResult;
+export declare function patchPptxChartSeriesAnalysis(buffer: ArrayBuffer, slides: readonly WorkSlide[]): Promise<ArrayBuffer>;
+export declare function writePptxChartSeriesAnalysis(document: Document, chartNode: Element, chart: WorkSlideChart): void;

package/dist/internal/features/work/work-pptx-chart-xy.d.ts

@@ -0,0 +1,3 @@
+import type { WorkSlide, WorkSlideChart } from './work-types';
+export declare function patchPptxChartXySettings(buffer: ArrayBuffer, slides: readonly WorkSlide[]): Promise<ArrayBuffer>;
+export declare function writePptxChartXySettings(document: Document, chartNode: Element, chart: WorkSlideChart): void;

package/dist/internal/features/work/work-pptx-comments.d.ts

@@ -0,0 +1,17 @@
+import { type OoxmlPackage, type OoxmlRelationship } from './work-ooxml-package';
+import type { WorkSlide, WorkSlideComment } from './work-types';
+export interface PptxCommentAuthor {
+    id: string;
+    name: string;
+    initials: string;
+}
+export interface PptxSlideCommentReadResult {
+    comments: WorkSlideComment[];
+    hasLegacyComments: boolean;
+    hasUnsupportedThreadedComments: boolean;
+    hasUnreadableComments: boolean;
+    hasMalformedMetadata: boolean;
+}
+export declare function loadPptxCommentAuthors(archive: OoxmlPackage, presentationRelationships: Map<string, OoxmlRelationship>): Promise<Map<string, PptxCommentAuthor>>;
+export declare function readPptxSlideComments(archive: OoxmlPackage, relationships: Map<string, OoxmlRelationship>, authors: Map<string, PptxCommentAuthor>, slideNumber: number, slideWidthEmu: number, slideHeightEmu: number): Promise<PptxSlideCommentReadResult>;
+export declare function patchPptxComments(buffer: ArrayBuffer, slides: readonly WorkSlide[], slideWidth: number, slideHeight: number): Promise<ArrayBuffer>;

package/dist/internal/features/work/work-pptx-export.d.ts

@@ -0,0 +1,4 @@
+import type { WorkArtifact } from './work-types';
+type PptxConstructor = typeof import('pptxgenjs').default;
+export declare function createPptxBlob(artifact: WorkArtifact, PptxGenJS: PptxConstructor): Promise<Blob>;
+export {};

package/dist/internal/features/work/work-pptx-groups.d.ts

@@ -0,0 +1,19 @@
+import type { WorkSlideElement } from './work-types';
+export type PptxExportObjectRole = 'chart' | 'image' | 'line' | 'shape' | 'table' | 'text';
+interface PptxExportBinding {
+    displayName: string;
+    groupPath: string[];
+    groupScope: string;
+    marker: string;
+}
+export declare class PptxGroupExportRegistry {
+    private readonly bindings;
+    private readonly roleCounts;
+    private markerSequence;
+    get size(): number;
+    objectName(scope: string, element: WorkSlideElement, role: PptxExportObjectRole): string | undefined;
+    binding(marker: string): PptxExportBinding | undefined;
+    values(): IterableIterator<PptxExportBinding>;
+}
+export declare function patchPptxNativeGroups(buffer: ArrayBuffer, registry: PptxGroupExportRegistry): Promise<ArrayBuffer>;
+export {};

package/dist/internal/features/work/work-pptx-import.d.ts

@@ -0,0 +1,6 @@
+import type { WorkCompatibilityReport, WorkPresentationContent } from './work-types';
+export interface PptxImportResult {
+    content: WorkPresentationContent;
+    compatibility: WorkCompatibilityReport;
+}
+export declare function importPptxPresentation(file: File): Promise<PptxImportResult>;

package/dist/internal/features/work/work-pptx-layout-export.d.ts

@@ -0,0 +1,13 @@
+import type { PptxGroupExportRegistry } from './work-pptx-groups';
+import type { WorkPresentationContent } from './work-types';
+type PptxConstructor = typeof import('pptxgenjs').default;
+type PptxPresentation = InstanceType<PptxConstructor>;
+export interface PptxLayoutBinding {
+    masterName: string;
+    placeholderNames: Map<string, string>;
+}
+export declare function definePptxSlideLayouts(presentation: PptxPresentation, source: WorkPresentationContent, slideWidth: number, slideHeight: number, groups: PptxGroupExportRegistry): {
+    content: WorkPresentationContent;
+    bindings: Map<string, PptxLayoutBinding>;
+};
+export {};

package/dist/internal/features/work/work-pptx-layout-import.d.ts

@@ -0,0 +1,30 @@
+import { type OoxmlPackage, type OoxmlRelationship } from './work-ooxml-package';
+import { type PptxThemeColors } from './work-pptx-style';
+import type { WorkSlidePlaceholder } from './work-types';
+export interface PptxRawBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation?: number;
+}
+export interface PptxDesignPart {
+    path: string;
+    document: Document;
+    relationships: Map<string, OoxmlRelationship>;
+    name: string;
+    background?: string;
+    showMasterElements: boolean;
+    sourceType?: string;
+}
+export interface PptxSlideInheritance {
+    layout?: PptxDesignPart;
+    master?: PptxDesignPart;
+    placeholders: Map<string, PptxRawBox>;
+}
+export declare function loadPptxSlideInheritance(archive: OoxmlPackage, slideRelationships: Map<string, OoxmlRelationship>, theme: PptxThemeColors): Promise<PptxSlideInheritance>;
+export declare function pptxRawElementBox(node: Element): PptxRawBox | undefined;
+export declare function pptxPlaceholderBox(node: Element, placeholders: Map<string, PptxRawBox>): PptxRawBox | undefined;
+export declare function pptxPlaceholder(node: Element): WorkSlidePlaceholder | undefined;
+export declare function pptxShowsMasterElements(document: Document): boolean;
+export declare function loadPptxDesignPart(archive: OoxmlPackage, path: string, theme: PptxThemeColors, fallbackName: string): Promise<PptxDesignPart | undefined>;

package/dist/internal/features/work/work-pptx-style.d.ts

@@ -0,0 +1,13 @@
+import { type OoxmlPackage, type OoxmlRelationship } from './work-ooxml-package';
+import type { WorkSlideShapeType, WorkSlideTextAlign, WorkSlideVerticalAlign } from './work-types';
+export type PptxThemeColors = Record<string, string>;
+export interface PptxFillValue {
+    color: string;
+    opacity?: number;
+}
+export declare function loadPptxTheme(archive: OoxmlPackage, presentationRelationships: Map<string, OoxmlRelationship>): Promise<PptxThemeColors>;
+export declare function readPptxBackground(document: Document, theme: PptxThemeColors): string | undefined;
+export declare function readPptxFill(container: ParentNode | null | undefined, theme: PptxThemeColors, fallback: string): PptxFillValue;
+export declare function supportedPptxShapeType(value: string): WorkSlideShapeType | undefined;
+export declare function pptxTextAlignment(value: string | null): WorkSlideTextAlign;
+export declare function pptxVerticalAlignment(value: string | null): WorkSlideVerticalAlign;

package/dist/internal/features/work/work-pptx-transition.d.ts

@@ -0,0 +1,13 @@
+import type { WorkSlide, WorkSlideTransition } from './work-types';
+export interface PptxTransitionDiagnostic {
+    code: string;
+    message: string;
+}
+export interface PptxTransitionReadResult {
+    present: boolean;
+    transition?: WorkSlideTransition;
+    diagnostics: PptxTransitionDiagnostic[];
+}
+export declare function readPptxTransition(document: Document): PptxTransitionReadResult;
+export declare function patchPptxTransitions(buffer: ArrayBuffer, slides: WorkSlide[]): Promise<ArrayBuffer>;
+export declare function writePptxTransition(document: Document, transition: WorkSlideTransition | undefined): void;

package/dist/internal/features/work/work-presentation-agent-context.d.ts

@@ -0,0 +1,6 @@
+import type { WorkAgentProposalTarget } from './work-agent-proposal';
+import { type WorkSlide, type WorkSlideElement } from './work-types';
+export declare function presentationAgentSelection(slide: WorkSlide, slideIndex: number, slideCount: number, element?: WorkSlideElement | null): string;
+export declare function presentationAgentProposalTargets(slide: WorkSlide, element?: WorkSlideElement | null): WorkAgentProposalTarget[];
+export declare function presentationNotesProposalTarget(slide: WorkSlide): WorkAgentProposalTarget;
+export declare function presentationElementText(element: WorkSlideElement): string;

package/dist/internal/features/work/work-presentation-chart-axes.d.ts

@@ -0,0 +1,14 @@
+import type { WorkSlideChart, WorkSlideChartAxes, WorkSlideChartType } from './work-types';
+/**
+ * Returns the editable primary axes in their physical bottom/left positions.
+ * Legacy category/value title fields are migrated on read so persisted charts
+ * created before the complete axis model continue to render and export.
+ */
+export declare function presentationChartAxes(chart: WorkSlideChart): WorkSlideChartAxes | undefined;
+/**
+ * Maps category/X and value/Y settings by meaning when the chart type changes.
+ * Axis-less chart types keep a canonical column-style copy so settings survive
+ * a temporary switch to pie or doughnut.
+ */
+export declare function presentationChartAxesForType(chart: WorkSlideChart, targetType: WorkSlideChartType): WorkSlideChartAxes | undefined;
+export declare function withPresentationChartAxes(chart: WorkSlideChart, axes: WorkSlideChartAxes | undefined): WorkSlideChart;

package/dist/internal/features/work/work-presentation-charts.d.ts

@@ -0,0 +1,37 @@
+import { type WorkSpreadsheetChartLayout } from './work-spreadsheet-chart-layout';
+import type { WorkSlideBubbleSizeRepresents, WorkSlideChart, WorkSlideChartDataLabelPosition, WorkSlideChartDataLabels, WorkSlideChartLegendPosition, WorkSlideChartSeries, WorkSlideChartSeriesStyle, WorkSlideChartType, WorkSlideElement, WorkSlideRadarStyle, WorkSlideScatterStyle } from './work-types';
+export declare function createPresentationChartElement(): WorkSlideElement;
+export declare function presentationChartTypeLabel(type: WorkSlideChartType): string;
+export declare function withPresentationChartType(chart: WorkSlideChart, type: WorkSlideChartType): WorkSlideChart;
+export declare function withPresentationChartLayout(chart: WorkSlideChart, change?: Partial<WorkSpreadsheetChartLayout & Pick<WorkSlideChart, 'showLegend'>>): WorkSlideChart;
+export declare function normalizePresentationChartSeriesStyle(style: WorkSlideChartSeriesStyle | undefined, type: WorkSlideChartType): WorkSlideChartSeriesStyle | undefined;
+export declare function withPresentationChartSeriesStyle(chart: WorkSlideChart, seriesIndex: number, style: WorkSlideChartSeriesStyle | undefined): WorkSlideChart;
+export declare function presentationChartSupportsSeriesMarkers(type: WorkSlideChartType): boolean;
+export declare function presentationChartHasCustomSeriesStyles(chart: WorkSlideChart): boolean;
+export declare function parsePresentationChartCategories(value: string): string[];
+export declare function parsePresentationChartValues(value: string): number[];
+export declare function parsePresentationChartValueDraft(value: string): number[] | null;
+export declare function parsePresentationChartXValues(value: string): string[];
+export declare function createPresentationChartSeries(chart: WorkSlideChart): WorkSlideChartSeries;
+export declare function withPresentationChartSeriesAnalysis(chart: WorkSlideChart, seriesIndex: number, analysis: Pick<WorkSlideChartSeries, 'errorBars' | 'trendlines'>): WorkSlideChart;
+export declare function presentationChartTrendlineCount(chart: WorkSlideChart): number;
+export declare function presentationChartErrorBarCount(chart: WorkSlideChart): number;
+export declare function normalizeDoughnutHoleSize(value: number | undefined): number;
+export declare function normalizeRadarStyle(value: WorkSlideRadarStyle | undefined): WorkSlideRadarStyle;
+export declare function normalizePresentationScatterStyle(value: unknown): WorkSlideScatterStyle;
+export declare function normalizePresentationBubbleScale(value: unknown): number;
+export declare function normalizePresentationBubbleSizeRepresents(value: unknown): WorkSlideBubbleSizeRepresents;
+export declare function presentationChartUsesNumericXAxis(type: WorkSlideChartType): boolean;
+export declare function presentationChartXValues(chart: WorkSlideChart): number[];
+export declare function presentationChartBubbleSizes(series: WorkSlideChartSeries): number[];
+export declare function normalizePresentationChartLegendPosition(value: unknown): WorkSlideChartLegendPosition;
+export declare function presentationChartLegendPositionLabel(position: WorkSlideChartLegendPosition): string;
+export declare function presentationChartShowsLegend(chart: WorkSlideChart): boolean;
+export declare function presentationChartSupportsAxisTitles(chart: Pick<WorkSlideChart, 'type'>): boolean;
+export declare function presentationChartDataLabelPositions(type: WorkSlideChartType): readonly WorkSlideChartDataLabelPosition[];
+export declare function normalizePresentationChartDataLabelPosition(value: unknown, type: WorkSlideChartType): WorkSlideChartDataLabelPosition;
+export declare function normalizePresentationChartDataLabels(source: WorkSlideChartDataLabels, type: WorkSlideChartType): WorkSlideChartDataLabels;
+export declare function withPresentationChartDataLabels(chart: WorkSlideChart, dataLabels: WorkSlideChartDataLabels | undefined): WorkSlideChart;
+export declare function presentationChartHasDataLabels(chart: WorkSlideChart): boolean;
+export declare function presentationChartDataLabelPositionLabel(position: WorkSlideChartDataLabelPosition): string;
+export declare function presentationChartDataLabelText(chart: WorkSlideChart, seriesIndex: number, pointIndex: number): string;

package/dist/internal/features/work/work-presentation-clipboard.d.ts

@@ -0,0 +1,26 @@
+import type { WorkSlide, WorkSlideElement } from './work-types';
+export declare const PRESENTATION_OBJECT_OFFSET_STEP = 5;
+export type WorkPresentationClipboardPayload = {
+    kind: 'element';
+    element: WorkSlideElement;
+} | {
+    kind: 'elements';
+    elements: WorkSlideElement[];
+} | {
+    kind: 'slide';
+    slide: WorkSlide;
+};
+export interface WorkPresentationClipboardRead {
+    payload: WorkPresentationClipboardPayload;
+    offset: number;
+}
+export declare function copyPresentationElement(element: WorkSlideElement): void;
+export declare function copyPresentationElements(elements: readonly WorkSlideElement[]): void;
+export declare function copyPresentationSlide(slide: WorkSlide): void;
+export declare function takePresentationClipboard(): WorkPresentationClipboardRead | null;
+export declare function hasPresentationClipboard(): boolean;
+export declare function clearPresentationClipboard(): void;
+export declare function clonePresentationElementForPaste(element: WorkSlideElement, offset: number): WorkSlideElement;
+export declare function clonePresentationElementsForPaste(elements: readonly WorkSlideElement[], offset: number): WorkSlideElement[];
+export declare function clonePresentationSlideForPaste(slide: WorkSlide, existingSlideNames?: readonly string[]): WorkSlide;
+export declare function nextPresentationSlideCopyName(sourceName: string, existingSlideNames: readonly string[]): string;

package/dist/internal/features/work/work-presentation-file-io.d.ts

@@ -0,0 +1,15 @@
+import type { WorkArtifact } from './work-types';
+type PptxConstructor = typeof import('pptxgenjs').default;
+declare global {
+    interface Window {
+        PptxGenJS?: PptxConstructor;
+    }
+}
+export interface WorkPresentationExportOptions {
+    pptxRuntimeUrl?: string;
+}
+export declare const defaultPptxRuntimeUrl: string;
+export declare function importWorkPresentationFile(file: File): Promise<WorkArtifact>;
+export declare function exportWorkPresentationArtifact(artifact: WorkArtifact, options?: WorkPresentationExportOptions): Promise<void>;
+export declare function createWorkPresentationBlob(artifact: WorkArtifact, options?: WorkPresentationExportOptions): Promise<Blob>;
+export {};

package/dist/internal/features/work/work-presentation-groups.d.ts

@@ -0,0 +1,17 @@
+import type { WorkSlideElement } from './work-types';
+export interface PresentationSelectionUnit {
+    key: string;
+    groupId?: string;
+    elements: WorkSlideElement[];
+    elementIds: string[];
+}
+export declare function expandPresentationGroupSelection(elements: readonly WorkSlideElement[], selectedIds: readonly string[]): string[];
+export declare function presentationSelectionUnits(elements: readonly WorkSlideElement[], selectedIds: readonly string[]): PresentationSelectionUnit[];
+export declare function presentationSelectionUnitCount(elements: readonly WorkSlideElement[], selectedIds: readonly string[]): number;
+export declare function canGroupPresentationElements(elements: readonly WorkSlideElement[], selectedIds: readonly string[]): boolean;
+export declare function canUngroupPresentationElements(elements: readonly WorkSlideElement[], selectedIds: readonly string[]): boolean;
+export declare function groupPresentationElements(elements: readonly WorkSlideElement[], selectedIds: readonly string[], groupId: string): WorkSlideElement[];
+export declare function ungroupPresentationElements(elements: readonly WorkSlideElement[], selectedIds: readonly string[]): WorkSlideElement[];
+export declare function remapPresentationGroupPaths(elements: readonly WorkSlideElement[]): WorkSlideElement[];
+export declare function topPresentationGroupId(element: WorkSlideElement): string | undefined;
+export declare function presentationGroupPath(element: WorkSlideElement): string[];

package/dist/internal/features/work/work-presentation-layouts.d.ts

@@ -0,0 +1,13 @@
+import type { WorkPresentationContent, WorkPresentationLayout, WorkPresentationMaster, WorkSlide, WorkSlideElement } from './work-types';
+export declare const DEFAULT_PRESENTATION_MASTER_ID = "presentation-master-default";
+export declare const DEFAULT_PRESENTATION_LAYOUT_ID = "presentation-layout-default";
+export interface WorkPresentationSlideView {
+    background: string;
+    inheritedElements: WorkSlideElement[];
+    placeholderElements: WorkSlideElement[];
+    master?: WorkPresentationMaster;
+    layout?: WorkPresentationLayout;
+}
+export declare function withPresentationDesign(content: WorkPresentationContent): WorkPresentationContent;
+export declare function presentationSlideView(content: WorkPresentationContent, slide: WorkSlide): WorkPresentationSlideView;
+export declare function applyPresentationLayout(content: WorkPresentationContent, slideId: string, layoutId: string): WorkPresentationContent;

package/dist/internal/features/work/work-presentation-transition.d.ts

@@ -0,0 +1,4 @@
+import type { WorkSlideTransition, WorkSlideTransitionType } from './work-types';
+export declare function createWorkSlideTransition(type: WorkSlideTransitionType, previous?: WorkSlideTransition): WorkSlideTransition;
+export declare function slideTransitionDurationMilliseconds(transition: WorkSlideTransition | undefined): number;
+export declare function workSlideTransitionsEqual(left: WorkSlideTransition | undefined, right: WorkSlideTransition | undefined): boolean;

package/dist/internal/features/work/work-presentation-visual-scale.d.ts

@@ -0,0 +1,2 @@
+import type { WorkSlideElement } from './work-types';
+export declare function scaledPresentationVisuals(element: WorkSlideElement, scale: number): Pick<WorkSlideElement, 'fontSize'> & Partial<Pick<WorkSlideElement, 'borderWidth' | 'textRuns'>>;

package/dist/internal/features/work/work-repository.d.ts

@@ -0,0 +1,4 @@
+import type { WorkArtifact } from './work-types';
+export declare function rememberWorkSourceBlob(artifactId: string, source: Blob): void;
+export declare function forgetWorkSourceBlob(artifactId: string): void;
+export declare function readWorkSourceBlob(artifact: WorkArtifact): Promise<Blob>;

package/dist/internal/features/work/work-spreadsheet-agent-context.d.ts

@@ -0,0 +1,15 @@
+import type { Cell, Selection } from '@fortune-sheet/core';
+import type { WorkAgentProposalTarget } from './work-agent-proposal';
+import { type WorkSpreadsheetContent } from './work-types';
+export interface WorkSpreadsheetAgentSelection {
+    sheetId: string;
+    sheetName: string;
+    reference: string;
+    cellCount: number;
+    context: string;
+    clipboard: string;
+    truncated: boolean;
+    proposalTargets: WorkAgentProposalTarget[];
+}
+export declare function spreadsheetAgentSelection(content: WorkSpreadsheetContent, sheetId: string, selection: Pick<Selection, 'row' | 'column'>, maximumCells?: number): WorkSpreadsheetAgentSelection | null;
+export declare function spreadsheetCellSourceText(cell: Cell | null): string;

package/dist/internal/features/work/work-spreadsheet-chart-axis.d.ts

@@ -0,0 +1,42 @@
+import { type WorkSpreadsheetChartAxes, type WorkSpreadsheetChartAxis, type WorkSpreadsheetChartAxisPosition, type WorkSpreadsheetChartType } from './work-types';
+export declare function workSpreadsheetChartAxisIsValueAxis(chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition): boolean;
+export declare function workSpreadsheetChartAxisIsCategoryAxis(chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition): boolean;
+export declare function workSpreadsheetChartAxisShowsMajorGridlinesByDefault(chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition): boolean;
+export declare function workSpreadsheetChartAxisDefaultLabelPosition(chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition): NonNullable<WorkSpreadsheetChartAxis['labelPosition']>;
+export declare function workSpreadsheetChartAxisPositionLabel(position: WorkSpreadsheetChartAxisPosition): string;
+export declare function workSpreadsheetChartAxisLabelPositionLabel(position: NonNullable<WorkSpreadsheetChartAxis['labelPosition']>): string;
+export declare function workSpreadsheetChartAxisTickMarkLabel(tickMark: NonNullable<WorkSpreadsheetChartAxis['majorTickMark']>): string;
+export declare function normalizeWorkSpreadsheetChartAxes(source: WorkSpreadsheetChartAxes | undefined, chartType: WorkSpreadsheetChartType, hasSecondaryAxes?: boolean): WorkSpreadsheetChartAxes | undefined;
+export interface SpreadsheetChartAxisScale {
+    minimum: number;
+    maximum: number;
+    span: number;
+    majorUnit?: number;
+    ticks: number[];
+}
+interface SpreadsheetChartAxisScaleOptions {
+    includeZero?: boolean;
+    paddingRatio?: number;
+}
+interface SpreadsheetChartPlotBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface SpreadsheetChartAxisLabelLayout {
+    x: number;
+    y: number;
+    textAnchor: 'start' | 'middle' | 'end';
+}
+export declare function spreadsheetChartAxisDisplayAttributes(axis: WorkSpreadsheetChartAxis | undefined, chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition): string;
+export declare function spreadsheetChartAxisValueRatio(value: number, scale: SpreadsheetChartAxisScale, axis: WorkSpreadsheetChartAxis | undefined): number;
+export declare function spreadsheetChartCategoryVisualIndex(index: number, count: number, axis: WorkSpreadsheetChartAxis | undefined): number;
+export declare function spreadsheetChartCategoryLabelVisible(index: number, count: number, axis: WorkSpreadsheetChartAxis | undefined): boolean;
+export declare function spreadsheetChartAxisLabelLayout(axis: WorkSpreadsheetChartAxis | undefined, chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition, plot: SpreadsheetChartPlotBounds, tickX: number, tickY: number): SpreadsheetChartAxisLabelLayout | null;
+export declare function spreadsheetChartMajorTickSvg(axis: WorkSpreadsheetChartAxis | undefined, position: WorkSpreadsheetChartAxisPosition, index: number, x: number, y: number): string;
+export declare function spreadsheetChartAxisScale(values: readonly number[], axis: WorkSpreadsheetChartAxis | undefined, options?: SpreadsheetChartAxisScaleOptions): SpreadsheetChartAxisScale;
+export declare function spreadsheetChartAxisGridlinesVisible(axis: WorkSpreadsheetChartAxis | undefined, chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition): boolean;
+export declare function spreadsheetChartAxisScaleAttributes(axis: WorkSpreadsheetChartAxis | undefined, scale: SpreadsheetChartAxisScale, chartType: WorkSpreadsheetChartType, position: WorkSpreadsheetChartAxisPosition): string;
+export declare function formatSpreadsheetChartAxisNumber(value: number, formatCode: string | undefined): string;
+export {};

package/dist/internal/features/work/work-spreadsheet-chart-layout.d.ts

@@ -0,0 +1,29 @@
+import type { WorkSpreadsheetChartType } from './work-types';
+export type WorkSpreadsheetChartLegendPosition = 'right' | 'left' | 'top' | 'bottom' | 'topRight';
+export type WorkSpreadsheetChartGrouping = 'clustered' | 'standard' | 'stacked' | 'percentStacked';
+export interface WorkSpreadsheetChartLayout {
+    legendPosition?: WorkSpreadsheetChartLegendPosition;
+    legendOverlay?: boolean;
+    grouping?: WorkSpreadsheetChartGrouping;
+    gapWidth?: number;
+    overlap?: number;
+    smoothLines?: boolean;
+}
+export type WorkSpreadsheetChartLayoutSource = WorkSpreadsheetChartLayout & {
+    type: WorkSpreadsheetChartType;
+};
+export declare function normalizeWorkSpreadsheetChartLegendPosition(value: unknown): WorkSpreadsheetChartLegendPosition;
+export declare function normalizeWorkSpreadsheetChartLegendOverlay(value: unknown): boolean;
+export declare function workSpreadsheetChartSupportsGrouping(type: WorkSpreadsheetChartType): boolean;
+export declare function workSpreadsheetChartSupportsBarSpacing(type: WorkSpreadsheetChartType): boolean;
+export declare function workSpreadsheetChartSupportsSmoothLines(type: WorkSpreadsheetChartType): boolean;
+export declare function workSpreadsheetChartDefaultGrouping(type: WorkSpreadsheetChartType): WorkSpreadsheetChartGrouping;
+export declare function normalizeWorkSpreadsheetChartGrouping(value: unknown, type: WorkSpreadsheetChartType): WorkSpreadsheetChartGrouping;
+export declare function workSpreadsheetChartGroupingIsStacked(grouping: WorkSpreadsheetChartGrouping): boolean;
+export declare function normalizeWorkSpreadsheetChartGapWidth(value: unknown): number;
+export declare function normalizeWorkSpreadsheetChartOverlap(value: unknown, grouping: WorkSpreadsheetChartGrouping): number;
+export declare function normalizeWorkSpreadsheetChartSmoothLines(value: unknown): boolean;
+export declare function normalizeWorkSpreadsheetChartLayout(source: WorkSpreadsheetChartLayoutSource): WorkSpreadsheetChartLayout;
+export declare function workSpreadsheetChartSupportsSeriesAnalysis(source: WorkSpreadsheetChartLayoutSource): boolean;
+export declare function workSpreadsheetChartLegendPositionLabel(position: WorkSpreadsheetChartLegendPosition): string;
+export declare function workSpreadsheetChartGroupingLabel(grouping: WorkSpreadsheetChartGrouping): string;

package/dist/internal/features/work/work-spreadsheet-chart-legend-svg.d.ts

@@ -0,0 +1,18 @@
+import type { WorkSpreadsheetChart } from './work-types';
+export interface SpreadsheetChartPlotBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface SpreadsheetChartLegendFrame {
+    width: number;
+    height: number;
+    titleHeight: number;
+}
+export interface SpreadsheetChartLegendLayout {
+    plot: SpreadsheetChartPlotBounds;
+    svg: string;
+}
+export declare function spreadsheetChartLegendLayout(chart: WorkSpreadsheetChart, sourcePlot: SpreadsheetChartPlotBounds, frame: SpreadsheetChartLegendFrame): SpreadsheetChartLegendLayout;
+export {};

package/dist/internal/features/work/work-spreadsheet-chart-series-layout.d.ts

@@ -0,0 +1,24 @@
+import { type WorkSpreadsheetChartGrouping } from './work-spreadsheet-chart-layout';
+import type { WorkSpreadsheetChart } from './work-types';
+type SpreadsheetChartSeriesLayoutSource = Pick<WorkSpreadsheetChart, 'categories' | 'grouping' | 'series' | 'type'>;
+export interface SpreadsheetChartSeriesLayoutPoint {
+    categoryIndex: number;
+    rawValue: number;
+    start: number;
+    end: number;
+}
+export interface SpreadsheetChartSeriesLayout {
+    grouping: WorkSpreadsheetChartGrouping;
+    stacked: boolean;
+    categoryCount: number;
+    series: SpreadsheetChartSeriesLayoutPoint[][];
+    scaleValues: number[];
+}
+export interface SpreadsheetChartBarGeometry {
+    barSize: number;
+    renderedSize: number;
+    offset: (seriesIndex: number) => number;
+}
+export declare function spreadsheetChartSeriesLayout(chart: SpreadsheetChartSeriesLayoutSource): SpreadsheetChartSeriesLayout;
+export declare function spreadsheetChartBarGeometry(groupSize: number, seriesCount: number, chart: Pick<WorkSpreadsheetChart, 'gapWidth' | 'overlap' | 'grouping' | 'type'>, maximumBarSize: number): SpreadsheetChartBarGeometry;
+export {};

package/dist/internal/features/work/work-spreadsheet-chart-series-style.d.ts

@@ -0,0 +1,29 @@
+import type { WorkSpreadsheetChartLineDash, WorkSpreadsheetChartMarkerSymbol, WorkSpreadsheetChartSeries, WorkSpreadsheetChartSeriesStyle } from './work-types';
+export interface SpreadsheetChartSeriesFillStyle {
+    color: string;
+    opacity: number;
+    attributes: string;
+}
+export interface SpreadsheetChartSeriesLineStyle {
+    color: string;
+    width: number;
+    dash: WorkSpreadsheetChartLineDash;
+    attributes: string;
+}
+interface SpreadsheetChartMarkerOptions {
+    visible: boolean;
+    defaultSize?: number;
+    attributes?: string;
+}
+export declare function normalizeWorkSpreadsheetChartSeriesStyle(source: WorkSpreadsheetChartSeriesStyle | null | undefined | Record<string, unknown>): WorkSpreadsheetChartSeriesStyle | undefined;
+export declare function normalizeWorkSpreadsheetChartColor(value: unknown): string | undefined;
+export declare function defaultWorkSpreadsheetChartSeriesStyle(seriesIndex: number): WorkSpreadsheetChartSeriesStyle;
+export declare function workSpreadsheetChartSeriesDefaultColor(seriesIndex: number): string;
+export declare function spreadsheetChartSeriesFillStyle(series: WorkSpreadsheetChartSeries, seriesIndex: number, defaultOpacity?: number, defaultColor?: string): SpreadsheetChartSeriesFillStyle;
+export declare function spreadsheetChartSeriesLineStyle(series: WorkSpreadsheetChartSeries, seriesIndex: number, defaultWidth: number, defaultColor?: string): SpreadsheetChartSeriesLineStyle;
+export declare function spreadsheetChartSeriesLegendColor(series: WorkSpreadsheetChartSeries, seriesIndex: number): string;
+export declare function spreadsheetChartSeriesMarkerSvg(series: WorkSpreadsheetChartSeries, seriesIndex: number, x: number, y: number, options: SpreadsheetChartMarkerOptions): string;
+export declare function spreadsheetChartSeriesStyleContext(style: WorkSpreadsheetChartSeriesStyle | undefined): string;
+export declare function workSpreadsheetChartLineDashLabel(dash: WorkSpreadsheetChartLineDash): string;
+export declare function workSpreadsheetChartMarkerSymbolLabel(symbol: WorkSpreadsheetChartMarkerSymbol): string;
+export {};

package/dist/internal/features/work/work-spreadsheet-chart-svg-utils.d.ts

@@ -0,0 +1,7 @@
+export declare const WORK_SPREADSHEET_CHART_COLORS: readonly ["#4f6bed", "#e66c37", "#8f95a3", "#f4b41a", "#36a2ae", "#6a9f4e"];
+export declare function finiteChartNumber(value: number): number;
+export declare function compactChartNumber(value: number): string;
+export declare function truncateChartText(value: string, length: number): string;
+export declare function roundChartNumber(value: number): number;
+export declare function clampChartNumber(value: number, minimum: number, maximum: number): number;
+export declare function escapeChartXml(value: string): string;

package/dist/internal/features/work/work-spreadsheet-chart-svg.d.ts

@@ -0,0 +1,3 @@
+import { type WorkSpreadsheetChart } from './work-types';
+export declare function spreadsheetChartSvgDataUrl(chart: WorkSpreadsheetChart): string;
+export declare function spreadsheetChartSvg(chart: WorkSpreadsheetChart): string;