@firestitch/report 18.6.1 → 18.8.0

package/app/reports/export/report-pptx.service.d.ts

@@ -1,21 +1,45 @@
+import { ReportLocaleTag } from '../interfaces/report.interface';
 import { CollectedReport } from './report-export-collector.service';
 import * as i0 from "@angular/core";
 export declare const PPTX_LIST_ROWS = 100;
+export declare const PPTX_AUTO_LABEL_MAX_POINTS = 24;
+export declare function pptxRunOptions(options: Record<string, unknown>, valueLocale?: ReportLocaleTag): Record<string, unknown>;
 export declare class ReportPptxService {
     export(collected: CollectedReport): Promise<void>;
     private _titleSlide;
     private _renderText;
     private _tokens;
     private _renderComponent;
+    private _lineRuns;
     private _renderChart;
+    private _legendPosition;
+    private _referenceLines;
+    private _statLines;
+    private _constantEntry;
+    private _measureFormatCodes;
+    private _withDataLabels;
+    private _percentAxisOptions;
+    private _twoAxesOptions;
+    private _rankAxisOptions;
     private _categoryOrderOptions;
+    private _valueAxisCode;
     private _addChart;
+    private _entryPlan;
+    private _dataLabelPosition;
+    private _lineOptions;
     private _renderWaterfall;
     private _waterfallSeries;
     private _categoryLabels;
     private _axisTextOptions;
+    private _categoryTitleOptions;
+    private _valueAxisRangeOptions;
     private _renderTable;
     private _renderKpi;
+    private _kpiDelta;
+    private _estimatedWidth;
+    private _fitEstimate;
+    private _kpiTarget;
+    private _kpiSparkline;
     private _slug;
     static ɵfac: i0.ɵɵFactoryDeclaration<ReportPptxService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ReportPptxService>;

package/app/reports/format.d.ts

@@ -1,8 +1,69 @@
-import { Report } from './interfaces/report.interface';
-export declare function formatMeasureValue(value: unknown, format?: string, precision?: number, ratioPercent?: boolean): string;
+import { ReportNumberUnits } from './enums/report-number-units.enum';
+import { ChartGranularity, ChartMeasure, ComparisonAgainst, ComparisonNoteCode, ComparisonOffset, ComponentComparison, KpiNoteCode, NumberFormatSpec, OutputMeta, OutputRole, Report, ReportCurrencyCode, ReportFormatContext, ReportLocaleTag, WindowMeta, WindowNoteCode } from './interfaces/report.interface';
+export declare const REPORT_FALLBACK_LOCALE: ReportLocaleTag;
+export declare const REPORT_FALLBACK_CURRENCY: ReportCurrencyCode;
+export declare const DEFAULT_FORMAT_CONTEXT: Readonly<ReportFormatContext>;
+export declare function resolveReportLocale(tag: string | null | undefined): ReportLocaleTag;
+export declare function resolveReportCurrency(code: string | null | undefined): ReportCurrencyCode;
+export declare function resolveFormatContext(report: Pick<Report, 'effectiveLocale' | 'effectiveCurrency' | 'percentFormat'>): ReportFormatContext;
+export declare function numberFormat(locale: string, options: Intl.NumberFormatOptions): Intl.NumberFormat;
+export declare function dateFormat(locale: string, options: Intl.DateTimeFormatOptions, timeZone?: string): Intl.DateTimeFormat;
+export type ResolvedUnits = ReportNumberUnits.None | ReportNumberUnits.Thousands | ReportNumberUnits.Millions;
+export interface FormatNumberOptions {
+    empty?: string;
+    units?: ResolvedUnits;
+    decimals?: number | null;
+    signed?: boolean;
+}
+export interface ChartNumberFormat {
+    units: ResolvedUnits;
+    decimals: number | null;
+}
+export declare function toFiniteNumber(value: unknown): number | null;
+export declare function hasNumberFormat(spec?: NumberFormatSpec | null): boolean;
+export declare function resolveUnits(units: ReportNumberUnits | null | undefined, magnitude: number, decimals: number): ResolvedUnits;
+export declare function formatNumber(value: unknown, spec: NumberFormatSpec | null | undefined, context: ReportFormatContext, options?: FormatNumberOptions): string;
+export interface OutputValueOptions {
+    measureSpec?: NumberFormatSpec | null;
+    prior?: unknown;
+    floor?: string | null;
+    empty?: string;
+}
+export interface FormattedOutputValue {
+    text: string;
+    title: string | null;
+}
+export declare function formatOutputValue(value: unknown, output: OutputMeta | null | undefined, spec: NumberFormatSpec | null | undefined, context: ReportFormatContext, options?: OutputValueOptions): FormattedOutputValue;
+export declare function laneOutputAlias(outputs: Record<string, OutputMeta> | null | undefined, alias: string, role: OutputRole): string | null;
+export declare function axisNumberFormat(measures: ChartMeasure[]): NumberFormatSpec | null;
+export declare function resolveChartNumberFormat(spec: NumberFormatSpec, peak: number, context: ReportFormatContext): ChartNumberFormat;
+export declare function numberFormatCode(spec: NumberFormatSpec, context: ReportFormatContext, chart: ChartNumberFormat, series: (number | null)[][], stacked: boolean): string;
+export declare function formatPlainNumber(value: unknown, locale: ReportLocaleTag): string;
 export declare const AXIS_SEPARATOR_THRESHOLD = 1000;
 export declare function chartAxisFormatCode(series: (number | null)[][], stacked: boolean): string;
+export declare function chartValuePeak(series: (number | null)[][], stacked: boolean): number;
 export declare function resolveReportTimezone(report: Pick<Report, 'effectiveTimezone' | 'timezone'>): string;
-export declare function formatReportDate(value: unknown, timezone: string): string;
+export declare const DAY_SHORT: Intl.DateTimeFormatOptions;
+export declare const DAY_LONG: Intl.DateTimeFormatOptions;
+export declare const MONTH_LONG: Intl.DateTimeFormatOptions;
+export declare const MONTH_YEAR: Intl.DateTimeFormatOptions;
+export declare const MONTH_DAY: Intl.DateTimeFormatOptions;
+export declare function formatLocalDate(date: Date, locale: ReportLocaleTag, options: Intl.DateTimeFormatOptions, timeZone?: string): string;
+export declare function formatReportDate(value: unknown, timezone: string, locale: ReportLocaleTag): string;
+export declare const TIME_SHORT: Intl.DateTimeFormatOptions;
+export declare function formatDayRange(start: string | null | undefined, end: string | null | undefined, locale: ReportLocaleTag, options?: Intl.DateTimeFormatOptions): string;
+export declare function formatThroughTime(through: string | null | undefined, timezone: string, locale: ReportLocaleTag): string;
+export declare function formatDayWindow(meta: {
+    start: string | null;
+    end: string | null;
+    through?: string | null;
+}, timezone: string, locale: ReportLocaleTag): string;
+export declare function localeName(tag: ReportLocaleTag): string;
+export declare function currencyName(code: ReportCurrencyCode): string;
+export declare function comparisonOffsetLabel(offset: ComparisonOffset): string;
+export declare function comparisonNoteText(code: ComparisonNoteCode, comparison?: ComponentComparison | null): string;
+export declare function windowText(meta: WindowMeta, locale: ReportLocaleTag, granularity?: ChartGranularity | null): string;
+export declare function windowNoteText(code: WindowNoteCode, meta: WindowMeta, locale: ReportLocaleTag, granularity?: ChartGranularity | null): string;
+export declare function kpiNoteText(code: KpiNoteCode, against?: ComparisonAgainst | null): string;
 export declare function getTimezoneLabel(timezone: string): string;
 export declare function getZonedNow(timezone: string): Date;

package/app/reports/interfaces/report-chat-viewer-filter.interface.d.ts

@@ -1,7 +1,9 @@
+import { ReportRelativeRange } from './report.interface';
 export interface ReportChatViewerFilter {
     groupId: number;
     start?: string;
     end?: string;
     values?: unknown[];
     value?: string;
+    preset?: ReportRelativeRange;
 }

package/app/reports/interfaces/report.interface.d.ts

@@ -1,10 +1,23 @@
-export type ReportLayout = 'freeform' | 'flow';
+import { ReportChangePolarity } from '../enums/report-change-polarity.enum';
+import { ReportChartColor } from '../enums/report-chart-color.enum';
+import { ReportChartDataLabels } from '../enums/report-chart-data-labels.enum';
+import { ReportChartDateLabel } from '../enums/report-chart-date-label.enum';
+import { ReportChartLineStyle } from '../enums/report-chart-line-style.enum';
+import { ReportChartMarkStat } from '../enums/report-chart-mark-stat.enum';
+import { ReportListColumnFormat } from '../enums/report-list-column-format.enum';
+import { ReportNumberUnits } from '../enums/report-number-units.enum';
+import { ReportValueFormat } from '../enums/report-value-format.enum';
+export type ReportLocaleTag = string;
+export type ReportCurrencyCode = string;
 export interface Report {
     id: number;
     name: string;
-    layout: ReportLayout;
     timezone: string | null;
     effectiveTimezone?: string;
+    locale?: ReportLocaleTag | null;
+    effectiveLocale?: ReportLocaleTag;
+    currency?: ReportCurrencyCode | null;
+    effectiveCurrency?: ReportCurrencyCode;
     percentFormat?: 'ratio';
     config: ReportConfig;
     pageWidth: number;
@@ -17,6 +30,20 @@ export interface ReportMaster {
     id: number;
     components: ReportComponent[];
 }
+export interface ReportFormatContext {
+    locale: ReportLocaleTag;
+    currency: ReportCurrencyCode;
+    ratioPercent: boolean;
+}
+export interface ReportLocaleOption {
+    locale: ReportLocaleTag;
+    defaultCurrency: ReportCurrencyCode;
+}
+export interface ReportLocales {
+    defaultLocale: ReportLocaleTag;
+    options: ReportLocaleOption[];
+    currencies: ReportCurrencyCode[];
+}
 export interface ReportHeaderFooter {
     headerHeight: number;
     footerHeight: number;
@@ -59,8 +86,6 @@ export interface ReportComponent {
     w: number;
     h: number;
     autoHeight: boolean;
-    flowWidth: number;
-    order: number;
     sql: string | null;
     config: ChartConfig & ListConfig & KpiConfig & TextConfig & ComponentLayoutConfig & Record<string, unknown>;
     filters: ReportFilter[];
@@ -82,6 +107,12 @@ export interface ComponentLayoutConfig {
 export interface ComponentSettings {
     title: string;
     padding: ComponentPadding;
+    kpi?: KpiCardSettings;
+}
+export interface KpiCardSettings {
+    increaseIs: ReportChangePolarity | null;
+    target: KpiTargetConfig | null;
+    sparkline: KpiSparklineConfig | null;
 }
 export type LegendPosition = 'top' | 'bottom' | 'left' | 'right' | 'hidden';
 export type ChartGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
@@ -98,6 +129,7 @@ export interface ChartConfig {
         kind?: 'category' | 'time';
         granularity?: ChartGranularity;
         label?: string;
+        dateLabel?: ReportChartDateLabel;
     };
     measures?: ChartMeasure[];
     splitBy?: {
@@ -109,25 +141,53 @@ export interface ChartConfig {
     };
     orientation?: 'vertical' | 'horizontal';
     stacked?: boolean;
+    percentStacked?: boolean;
+    dataLabels?: ReportChartDataLabels;
+    valueAxis?: ChartValueAxis;
+    secondaryAxis?: ChartValueAxis;
+    references?: ChartReference[];
     legend?: LegendPosition;
     sort?: ReportSort;
     limit?: number;
 }
-export interface ChartMeasure {
+export interface ChartValueAxis {
+    label?: string;
+    min?: number;
+    max?: number;
+    interval?: number;
+}
+export interface ChartReference {
+    value: number;
+    label: string;
+    to?: number;
+    secondary?: boolean;
+}
+export interface NumberFormatSpec {
+    format?: ReportValueFormat | ReportListColumnFormat;
+    precision?: number;
+    units?: ReportNumberUnits;
+}
+export interface ChartMeasure extends NumberFormatSpec {
     column: string;
     aggregation?: 'sum' | 'count' | 'avg' | 'min' | 'max';
     label?: string;
     type?: AxisChartType;
-    format?: 'number' | 'percent' | 'currency';
-    precision?: number;
+    format?: ReportValueFormat;
+    secondary?: boolean;
+    color?: ReportChartColor;
+    line?: ReportChartLineStyle;
+    markers?: boolean;
+    markLine?: ReportChartMarkStat;
+}
+export interface ListColumn extends NumberFormatSpec {
+    column: string;
+    label?: string;
+    format?: ReportListColumnFormat;
+    sortColumn?: string;
+    wrap?: boolean;
 }
 export interface ListConfig {
-    columns?: {
-        column: string;
-        label?: string;
-        format?: 'date';
-        sortColumn?: string;
-    }[];
+    columns?: ListColumn[];
     rowBy?: {
         column: string;
         label?: string;
@@ -135,11 +195,27 @@ export interface ListConfig {
     pivotBy?: {
         column: string;
     };
-    sort?: ReportSort;
+    sort?: ReportSort | ReportSort[];
+    pinnedColumns?: number | null;
     pageSize?: number;
+    totals?: boolean;
+    cellFormat?: NumberFormatSpec & {
+        format?: ReportValueFormat;
+    };
 }
 export interface KpiConfig {
     measure?: ChartMeasure;
+    increaseIs?: ReportChangePolarity | null;
+    target?: KpiTargetConfig | null;
+    sparkline?: KpiSparklineConfig | null;
+}
+export interface KpiTargetConfig {
+    value: number;
+    label?: string | null;
+}
+export interface KpiSparklineConfig {
+    granularity?: ChartGranularity | null;
+    periods?: number | null;
 }
 export interface ReportSort {
     column: string;
@@ -190,14 +266,19 @@ export interface FilterGroupValue {
     value?: string;
     preset?: string;
 }
+export type ReportRelativeRange = 'thisWeek' | 'lastWeek' | 'last7Days' | 'last30Days' | 'last3Months' | 'last6Months' | 'last12Months' | 'thisMonth' | 'thisQuarter' | 'thisYear' | 'yearToDate';
 export interface ReportUrlParams {
     groups: Map<number, string>;
     listSorts: Map<number, string>;
+    listSearches: Map<number, string>;
+    listHidden: Map<number, string>;
     groupBy: string | null;
 }
 export interface ReportUrlSnapshot {
     groups: Map<number, FilterGroupValue | null>;
     listSorts: Map<number, ReportSort>;
+    listSearches: Map<number, string>;
+    listHidden: Map<number, string[]>;
     frequency: ChartGranularity | null;
 }
 export interface ResolvedFilterValue {
@@ -206,12 +287,15 @@ export interface ResolvedFilterValue {
     end?: string;
     values?: unknown[];
     value?: string;
+    preset?: ReportRelativeRange;
 }
 export interface ComponentDataState {
     sort?: ReportSort;
     page?: number;
     pageSize?: number;
     frequency?: ChartGranularity;
+    search?: string;
+    hiddenColumns?: string[];
 }
 export interface ComponentData {
     columns: string[];
@@ -223,6 +307,113 @@ export interface ComponentData {
     };
     truncated: boolean;
     granularity?: ChartGranularity | null;
+    searchNote?: string | null;
+    totals?: Record<string, unknown> | null;
+    totalsNote?: string | null;
+    timeframe?: ComponentTimeframe | null;
+    comparison?: ComponentComparison | null;
+    outputs?: Record<string, OutputMeta>;
+    cellMeasures?: Record<string, string>;
+    windows?: Record<string, WindowMeta>;
+    kpi?: ComponentKpi | null;
+    partialPeriod?: string | null;
+}
+export type TimeframeSource = 'filter' | 'range' | 'fixed' | 'none';
+export interface ComponentTimeframe {
+    column: string;
+    start: string | null;
+    end: string | null;
+    through: string | null;
+    range: ReportRelativeRange | null;
+    source: TimeframeSource;
+}
+export type ComparisonMode = 'range' | 'series' | 'as_of';
+export type ComparisonAlign = 'to_date' | 'full';
+export type ComparisonAgainst = 'previous_period' | 'previous_week' | 'previous_month' | 'previous_quarter' | 'previous_year' | 'range';
+export type ComparisonNoteCode = 'no_window' | 'unit_inferred' | 'window_in_future' | 'other_date_filter' | 'grain_followed';
+export interface ComparisonWindow {
+    start: string;
+    end: string;
+    through: string | null;
+}
+export interface ComparisonOffset {
+    against: ComparisonAgainst;
+    unit: ChartGranularity | null;
+    count: number | null;
+}
+export interface ComponentComparison {
+    mode: ComparisonMode;
+    timezone: string;
+    align: ComparisonAlign;
+    current: ComparisonWindow | null;
+    priors: ComparisonWindow[];
+    offsets: ComparisonOffset[];
+    floor: string | null;
+    notes: ComparisonNoteCode[];
+}
+export type OutputKind = 'value' | 'rank' | 'share';
+export type OutputRole = 'current' | 'prior' | 'change' | 'percent_change';
+export type OutputRankMethod = 'competition' | 'dense';
+export interface OutputRank {
+    method: OutputRankMethod;
+    direction: 'asc' | 'desc';
+    within: string[];
+}
+export interface OutputShare {
+    within: string[];
+}
+export interface OutputMeta {
+    measure: string;
+    kind: OutputKind;
+    role: OutputRole | null;
+    offset: number | null;
+    window: boolean;
+    rank: OutputRank | null;
+    share: OutputShare | null;
+}
+export type WindowKind = 'running' | 'to_date' | 'rolling';
+export type WindowNoteCode = 'snapped_start' | 'span_converted' | 'grain_too_coarse' | 'equal_grain_plain' | 'own_filter_caps_lead_in' | 'week_by_monday' | 'incomplete_head';
+export interface WindowMeta {
+    kind: WindowKind;
+    periods: number | null;
+    unit: ChartGranularity | null;
+    drawnPeriods: number | null;
+    resetEvery: ChartGranularity | null;
+    average: boolean;
+    fromBeginning: boolean;
+    dateColumn: string | null;
+    start: string | null;
+    end: string | null;
+    leadIn: string | null;
+    notes: WindowNoteCode[];
+    description: string;
+}
+export type KpiDeltaShow = 'change' | 'percent_change';
+export type KpiNoteCode = 'no_prior_data' | 'up_from_zero' | 'no_change' | 'no_data_either' | 'sign_change';
+export interface ComponentKpiTarget {
+    value: number;
+    label: string | null;
+    progress: number | null;
+    met: boolean | null;
+}
+export interface ComponentKpiSparklinePoint {
+    period: string;
+    value: number | null;
+}
+export interface ComponentKpiSparkline {
+    granularity: ChartGranularity;
+    partial: boolean;
+    points: ComponentKpiSparklinePoint[];
+}
+export interface ComponentKpi {
+    value: number | null;
+    prior: number | null;
+    change: number | null;
+    percentChange: number | null;
+    show: KpiDeltaShow;
+    note: KpiNoteCode | null;
+    target: ComponentKpiTarget | null;
+    sparkline: ComponentKpiSparkline | null;
 }
 export interface ComponentExportResponse {
     url: string;

package/app/reports/kpi-card.d.ts

@@ -0,0 +1,48 @@
+import { ReportChangePolarity } from './enums/report-change-polarity.enum';
+import { ReportKpiTrend } from './enums/report-kpi-trend.enum';
+import { ChartGranularity, ComponentData, KpiCardSettings, KpiConfig, ReportFormatContext } from './interfaces/report.interface';
+export declare const KPI_SPARKLINE_DEFAULT_GRANULARITY: ChartGranularity;
+export declare const KPI_SPARKLINE_DEFAULT_PERIODS = 12;
+export interface KpiCardContext {
+    format: ReportFormatContext;
+    timezone: string;
+}
+export interface KpiCardDelta {
+    text: string;
+    trend: ReportKpiTrend;
+    tone: ReportChangePolarity;
+    compared: string;
+}
+export interface KpiCardTarget {
+    text: string;
+    progress: string;
+    fill: number | null;
+    tone: ReportChangePolarity;
+}
+export interface KpiCardSparkline {
+    values: (number | null)[];
+    partial: boolean;
+}
+export interface KpiCardView {
+    value: string;
+    label: string;
+    delta: KpiCardDelta | null;
+    window: string;
+    target: KpiCardTarget | null;
+    sparkline: KpiCardSparkline | null;
+}
+export interface KpiSparklinePoint {
+    x: number;
+    y: number;
+}
+export interface KpiSparklineGeometry {
+    lines: string[];
+    dots: KpiSparklinePoint[];
+    last: (KpiSparklinePoint & {
+        hollow: boolean;
+    }) | null;
+}
+export declare function kpiCardView(config: KpiConfig | null | undefined, data: ComponentData | null | undefined, context: KpiCardContext): KpiCardView;
+export declare function kpiSparklineGeometry(values: (number | null)[], partial: boolean): KpiSparklineGeometry;
+export declare function kpiCardSettings(config: KpiConfig | null | undefined): KpiCardSettings;
+export declare function sameKpiCardSettings(a: KpiCardSettings, b: KpiCardSettings): boolean;

package/app/reports/layout.d.ts

@@ -1,14 +1,5 @@
-import { Report, ReportPage } from './interfaces/report.interface';
-export declare const FLOW_PADDING = 0.25;
 export declare const DEFAULT_COMPONENT_PADDING = 0.125;
 export declare const DEFAULT_HEADING_SIZE = 16;
-export interface ComponentGeometry {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
-export declare function pageGeometry(report: Report, page: ReportPage): Map<number, ComponentGeometry>;
 export declare const PAGE_DIMENSION_MIN = 1;
 export declare const PAGE_DIMENSION_MAX = 50;
 export declare const HEADER_FOOTER_MAX = 3;

package/app/reports/list-config.d.ts

@@ -0,0 +1,16 @@
+import { ComponentData, ListColumn, ListConfig, NumberFormatSpec, OutputMeta, ReportSort } from './interfaces/report.interface';
+export declare const MAX_PINNED_COLUMNS = 3;
+export declare function listSortTerms(config: ListConfig | null | undefined): ReportSort[];
+export declare function listHideableColumns(config: ListConfig | null | undefined): string[];
+export declare function listHiddenColumns(config: ListConfig | null | undefined, names: readonly string[]): string[];
+export declare function listPinnedColumns(config: ListConfig | null | undefined): number;
+export declare function columnClasses(column: ListColumn, index: number, pinned: number): string;
+export declare const LIST_TOTAL_LABEL = "Total";
+export declare function listTotalsLabelColumn(columns: readonly ListColumn[], totals: Record<string, unknown> | null | undefined): string | null;
+export interface ListOutputColumn {
+    output: OutputMeta;
+    measureSpec: NumberFormatSpec | null;
+    priorAlias: string | null;
+    floor: string | null;
+}
+export declare function listOutputColumns(columns: readonly ListColumn[], data: Pick<ComponentData, 'outputs' | 'cellMeasures' | 'comparison'> | null | undefined, authored: readonly ListColumn[]): Record<string, ListOutputColumn>;

package/app/reports/option-builder.d.ts

@@ -1,17 +1,67 @@
 import type { EChartsOption } from 'echarts';
-import { AxisChartType, ChartConfig, ChartGranularity, ComponentData, LegendPosition, ListConfig, ReportComponent, WaterfallStepKind } from './interfaces/report.interface';
+import { ReportChartDataLabels } from './enums/report-chart-data-labels.enum';
+import { ReportChartDateLabel } from './enums/report-chart-date-label.enum';
+import { ReportChartLineStyle } from './enums/report-chart-line-style.enum';
+import { ReportChartMarkStat } from './enums/report-chart-mark-stat.enum';
+import { AxisChartType, ChartConfig, ChartGranularity, ChartMeasure, ChartValueAxis, ComponentData, LegendPosition, ListColumn, ListConfig, ReportComponent, ReportFormatContext, ReportLocaleTag, WaterfallStepKind } from './interfaces/report.interface';
+export declare const PERCENT_AXIS_MAX = 1;
+export declare const PERCENT_AXIS_INTERVAL = 0.25;
+export declare const RANK_AXIS_MIN = 1;
+export declare const STAT_LABEL: Record<ReportChartMarkStat, string>;
+export type ValueAxisIndex = 0 | 1;
+export interface DrawnReference {
+    label: string;
+    low: number;
+    high: number;
+    band: boolean;
+    axisIndex: ValueAxisIndex;
+}
+interface DataLabelParams {
+    value?: unknown;
+    data?: unknown;
+    dataIndex?: number;
+}
+export type DataLabelFormatter = (params: DataLabelParams) => string;
+export type DataLabelPosition = 'top' | 'inside' | 'outside';
+export interface DataLabel<P extends DataLabelPosition = DataLabelPosition> {
+    show: true;
+    position: P;
+    fontSize: number;
+    formatter: DataLabelFormatter;
+}
+export interface SeriesDataLabels {
+    text: Omit<DataLabel, 'position'>;
+    hideOverlap: boolean;
+    lastOnly: boolean;
+}
+export type PercentShares = Map<number, (number | null)[]>;
 export declare function isColorBy(config: ChartConfig): boolean;
 export declare function colorByColumn(config: ChartConfig): string | undefined;
 export interface ExtractedChartSeries {
     categories: string[];
-    series: {
-        name: string;
-        values: (number | null)[];
-        type?: AxisChartType;
-    }[];
+    series: ExtractedChartSeriesItem[];
+}
+export interface ExtractedChartSeriesItem {
+    name: string;
+    values: (number | null)[];
+    type?: AxisChartType;
+    measure: ChartMeasure;
+    measureIndex: number;
 }
 export declare function extractChartSeries(component: ReportComponent, data: ComponentData): ExtractedChartSeries;
+export declare function seriesColor(series: ExtractedChartSeriesItem): string | undefined;
+export declare function seriesHex(series: ExtractedChartSeriesItem, index: number): string;
+export declare function measureLineStyle(measure: ChartMeasure | undefined): ReportChartLineStyle | undefined;
+export declare function measureMarkStat(measure: ChartMeasure | undefined): ReportChartMarkStat | undefined;
+export declare function seriesStat(values: (number | null)[], stat: ReportChartMarkStat): number | null;
+export declare function drawsStatLines(config: ChartConfig): boolean;
+export declare function colorByValues(extracted: ExtractedChartSeries): (number | null)[];
+export declare function chartReferences(config: ChartConfig, twoAxes: boolean): DrawnReference[];
+export declare function percentShares(values: (number | null)[][]): (number | null)[][];
+export declare function percentStackedShares(extracted: ExtractedChartSeries, config: ChartConfig): PercentShares | null;
+export declare function percentAxisMin(shares: PercentShares): number;
 export declare function seriesTypes(extracted: ExtractedChartSeries, chartType: AxisChartType): AxisChartType[];
+export declare function seriesAxisIndexes(extracted: ExtractedChartSeries, config: ChartConfig): ValueAxisIndex[];
 export interface WaterfallStep {
     category: string;
     start: number;
@@ -24,8 +74,25 @@ export interface ExtractedWaterfall {
 }
 export declare const WATERFALL_TOTAL_LABEL = "Total";
 export declare function extractWaterfall(component: ReportComponent, data: ComponentData): ExtractedWaterfall;
-export declare function buildChartOption(component: ReportComponent, data: ComponentData): EChartsOption;
+export declare function buildChartOption(component: ReportComponent, data: ComponentData, context: ReportFormatContext): EChartsOption;
+export declare function priorSeriesStyles(config: ChartConfig, data: ComponentData, extracted: ExtractedChartSeries): {
+    colors: string[];
+    priors: boolean[];
+} | null;
+export declare function rankValueAxes(extracted: ExtractedChartSeries, data: ComponentData, config: ChartConfig): boolean[];
+export declare function referencePeak(references: DrawnReference[], axisIndex: ValueAxisIndex): number;
 export declare function resolveLegendPosition(config: ChartConfig, seriesCount: number, colorBy?: boolean): LegendPosition;
+export declare function dataLabelOption(mode: ReportChartDataLabels | undefined, formatter: DataLabelFormatter): SeriesDataLabels | null;
+export declare function valueAxisRange(axis: ChartValueAxis | undefined): {
+    min?: number;
+    max?: number;
+    interval?: number;
+};
 export declare function spansMultipleYears(categories: string[]): boolean;
-export declare function formatPeriodLabel(value: string, granularity: ChartGranularity, multiYear: boolean): string;
-export declare function pivotHeadings(config: ListConfig, data: ComponentData): string[];
+export declare function chartDateLabel(config: ChartConfig | undefined): ReportChartDateLabel;
+export declare function formatPeriodLabel(value: string, granularity: ChartGranularity, multiYear: boolean, locale: ReportLocaleTag, dateLabel?: ReportChartDateLabel): string;
+export declare function pivotHeadings(config: ListConfig, data: ComponentData, locale: ReportLocaleTag): string[];
+export declare function pivotColumnSpecs(config: ListConfig, data: ComponentData, locale: ReportLocaleTag): (ListColumn & {
+    numeric: boolean;
+})[];
+export {};

package/app/reports/output-notes.d.ts

@@ -0,0 +1,14 @@
+import { ComponentData, ReportLocaleTag } from './interfaces/report.interface';
+export type ComponentNoteData = Pick<ComponentData, 'comparison' | 'timeframe' | 'outputs' | 'cellMeasures' | 'windows' | 'granularity' | 'kpi'>;
+export interface ComponentNoteContext {
+    locale: ReportLocaleTag;
+    timezone: string;
+}
+export interface ComponentNoteParts {
+    windows?: boolean;
+    windowDescriptions?: boolean;
+    windowNotes?: boolean;
+}
+export declare function componentNoteLines(data: ComponentNoteData | null | undefined, context: ComponentNoteContext, parts?: ComponentNoteParts): string[];
+export declare function outputColumnNote(column: string, data: ComponentNoteData | null | undefined, locale: ReportLocaleTag): string;
+export declare function componentWindowsLine(data: ComponentNoteData, context: ComponentNoteContext): string;

package/app/reports/pipes/report-date.pipe.d.ts

@@ -1,7 +1,8 @@
 import { PipeTransform } from '@angular/core';
+import { ReportLocaleTag } from '../interfaces/report.interface';
 import * as i0 from "@angular/core";
 export declare class ReportDatePipe implements PipeTransform {
-    transform(value: unknown, timezone: string): string;
+    transform(value: unknown, timezone: string, locale: ReportLocaleTag): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<ReportDatePipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<ReportDatePipe, "fsReportDate", true>;
 }

package/app/reports/pipes/report-number.pipe.d.ts

@@ -0,0 +1,8 @@
+import { PipeTransform } from '@angular/core';
+import { NumberFormatSpec, ReportFormatContext } from '../interfaces/report.interface';
+import * as i0 from "@angular/core";
+export declare class ReportNumberPipe implements PipeTransform {
+    transform(value: unknown, column: NumberFormatSpec, context: ReportFormatContext): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportNumberPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<ReportNumberPipe, "fsReportNumber", true>;
+}