angular-my-report 0.1.0 → 0.1.1

package/lib/ui/properties/report-props.component.d.ts

@@ -0,0 +1,34 @@
+import type { BandType, PageSettings, ReportDefinition } from '../../model/types';
+import * as i0 from "@angular/core";
+export declare function removeGroup(r: ReportDefinition, gid: string): void;
+type PageKey = Exclude<keyof PageSettings, 'continuous'>;
+export declare class ReportPropsComponent {
+    private readonly store;
+    protected readonly report: import("@angular/core").WritableSignal<ReportDefinition>;
+    protected readonly labels: Record<BandType, string>;
+    protected readonly optionalBands: BandType[];
+    protected readonly sizeNames: string[];
+    protected readonly pageFields: {
+        key: PageKey;
+        label: string;
+        min: number;
+    }[];
+    protected readonly landscape: import("@angular/core").Signal<boolean>;
+    protected readonly sizeName: import("@angular/core").Signal<string>;
+    protected setName(v: string): void;
+    protected setSize(name: string): void;
+    protected setContinuous(on: boolean): void;
+    protected setOrientation(v: string): void;
+    protected setPage(k: PageKey, min: number, v: number | null): void;
+    protected isVisible(t: BandType): boolean;
+    protected setVisible(t: BandType, on: boolean): void;
+    protected setGroupField(gid: string, v: string): void;
+    protected deleteGroup(gid: string): void;
+    protected addGroup(): void;
+    protected setSort(i: number, k: 'field' | 'direction', v: string): void;
+    protected removeSort(i: number): void;
+    protected addSort(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportPropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ReportPropsComponent, "rpt-report-props", never, {}, {}, never, never, true, never>;
+}
+export {};

package/lib/ui/properties/table-props.component.d.ts

@@ -0,0 +1,31 @@
+import type { FormatKind, HAlign, ReportElement, TableColumn, TableSpec } from '../../model/types';
+import * as i0 from "@angular/core";
+type ColorKey = 'headerBackground' | 'stripeBackground' | 'gridColor' | 'headerColor';
+export declare class TablePropsComponent {
+    private readonly store;
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    protected readonly formatKinds: FormatKind[];
+    protected readonly spec: import("@angular/core").Signal<TableSpec>;
+    protected readonly widths: import("@angular/core").Signal<number[]>;
+    /** Edits the table and keeps the element height in sync with its header/row/footer heights. */
+    protected set(fn: (t: TableSpec, e: ReportElement) => void): void;
+    protected col(i: number, fn: (c: TableColumn) => void): void;
+    protected colorValue(v: string): string;
+    protected flag: (k: "showHeader" | "repeatHeader" | "showFooter", v: boolean) => (t: TableSpec) => boolean;
+    protected color: (k: ColorKey, v: string) => (t: TableSpec) => string;
+    protected rowFill: (v: string) => (_: TableSpec, e: ReportElement) => string;
+    protected setHeader: (v: string) => (c: TableColumn) => string;
+    protected setCell: (v: string) => (c: TableColumn) => string;
+    protected setFooter: (v: string) => (c: TableColumn) => string;
+    protected setAlign: (v: HAlign) => (c: TableColumn) => HAlign;
+    protected setFormat: (v: FormatKind) => (c: TableColumn) => FormatKind;
+    protected height(k: 'headerHeight' | 'rowHeight', v: number | null): void;
+    protected colWidth(i: number, v: number | null): void;
+    protected colDecimals(i: number, v: number | null): void;
+    protected moveColumn(i: number, d: number): void;
+    protected removeColumn(i: number): void;
+    protected addColumn(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TablePropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TablePropsComponent, "rpt-table-props", never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+export {};

package/lib/ui/viewer/page-view.component.d.ts

@@ -0,0 +1,17 @@
+import type { PageBackground, PageSettings, Watermark } from '../../model/types';
+import type { ViewPage } from './render';
+import * as i0 from "@angular/core";
+/** One printed page: background, watermark, bands and their elements. */
+export declare class PageViewComponent {
+    readonly page: import("@angular/core").InputSignal<ViewPage>;
+    readonly settings: import("@angular/core").InputSignal<PageSettings>;
+    readonly watermark: import("@angular/core").InputSignal<Watermark>;
+    readonly background: import("@angular/core").InputSignal<PageBackground>;
+    readonly watermarkText: import("@angular/core").InputSignal<string>;
+    readonly highlights: import("@angular/core").InputSignal<ReadonlySet<string>>;
+    readonly active: import("@angular/core").InputSignal<string | null>;
+    protected readonly contentWidth: import("@angular/core").Signal<number>;
+    protected readonly fit: import("@angular/core").Signal<"none" | "contain" | "cover" | "fill">;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PageViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PageViewComponent, "rpt-page-view", never, { "page": { "alias": "page"; "required": true; "isSignal": true; }; "settings": { "alias": "settings"; "required": true; "isSignal": true; }; "watermark": { "alias": "watermark"; "required": true; "isSignal": true; }; "background": { "alias": "background"; "required": true; "isSignal": true; }; "watermarkText": { "alias": "watermarkText"; "required": false; "isSignal": true; }; "highlights": { "alias": "highlights"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/ui/viewer/render.d.ts

@@ -0,0 +1,43 @@
+import type { ReportDefinition, ReportElement } from '../../model/types';
+import { type Row } from '../../engine/expressions';
+import type { TableRenderData } from '../../engine/table';
+import type { ParamValues } from '../../engine/parameters';
+export interface ViewItem {
+    /** Unique within the document: page:band:element. Used for find highlights. */
+    key: string;
+    el: ReportElement;
+    rows?: Row[];
+    top: number;
+    height: number;
+    content: string;
+    tableData?: TableRenderData;
+    /** Plain text of the item (content or table cells), for Find. */
+    text: string;
+}
+export interface ViewBand {
+    top: number;
+    height: number;
+    items: ViewItem[];
+}
+export interface ViewPage {
+    index: number;
+    height: number;
+    background: boolean;
+    watermark: boolean;
+    bands: ViewBand[];
+}
+/** Group headers as a navigable tree. */
+export interface Bookmark {
+    label: string;
+    page: number;
+    top: number;
+    children: Bookmark[];
+}
+export interface ViewDocument {
+    pages: ViewPage[];
+    bookmarks: Bookmark[];
+    rowCount: number;
+    watermarkText: string;
+}
+/** Lays out and evaluates the whole report into ready-to-draw pages, plus group bookmarks. */
+export declare function buildDocument(report: ReportDefinition, rows: Row[], params: ParamValues, root: unknown): ViewDocument;

package/lib/ui/viewer/viewer.component.d.ts

@@ -0,0 +1,99 @@
+import type { ReportParameter } from '../../model/types';
+import { DesignerStore } from '../designer.store';
+import { type Bookmark } from './render';
+import * as i0 from "@angular/core";
+type ViewMode = 'continuous' | 'single' | 'two';
+type ZoomMode = 'width' | 'page' | number;
+/**
+ * Report viewer: paged view with navigation, zoom, view modes, find, bookmarks, thumbnails,
+ * parameters, print and export. Used standalone (/viewer) and as the designer's preview.
+ */
+export declare class ViewerComponent {
+    protected readonly store: DesignerStore;
+    /** Inside the designer (shows Close) vs. the standalone /viewer page. */
+    readonly embedded: import("@angular/core").InputSignal<boolean>;
+    /** Standalone viewer: shows a "Designer" link to this URL. */
+    readonly designerUrl: import("@angular/core").InputSignal<string | null | undefined>;
+    /** Standalone viewer: shows the Open button for local .report.json files. */
+    readonly allowOpen: import("@angular/core").InputSignal<boolean>;
+    private readonly host;
+    readonly closed: import("@angular/core").OutputEmitterRef<void>;
+    private readonly root;
+    private readonly scroll;
+    private readonly findBox;
+    protected readonly zoomSteps: number[];
+    protected readonly mode: import("@angular/core").WritableSignal<ViewMode>;
+    protected readonly zoomMode: import("@angular/core").WritableSignal<ZoomMode>;
+    protected readonly current: import("@angular/core").WritableSignal<number>;
+    protected readonly sidebar: import("@angular/core").WritableSignal<boolean>;
+    protected readonly sideTab: import("@angular/core").WritableSignal<"bookmarks" | "pages">;
+    protected readonly findOpen: import("@angular/core").WritableSignal<boolean>;
+    protected readonly query: import("@angular/core").WritableSignal<string>;
+    protected readonly matchIndex: import("@angular/core").WritableSignal<number>;
+    protected readonly paramsOpen: import("@angular/core").WritableSignal<boolean>;
+    private readonly viewport;
+    protected readonly settings: import("@angular/core").Signal<import("angular-my-report").PageSettings>;
+    protected readonly watermark: import("@angular/core").Signal<{
+        enabled: boolean;
+        kind: "text" | "image";
+        text: string;
+        image: string;
+        opacity: number;
+        angle: number;
+        fontSize: number;
+        color: string;
+        bold: boolean;
+        imageScale: number;
+        layer: "behind" | "front";
+        pages: "all" | "first";
+    }>;
+    protected readonly background: import("@angular/core").Signal<{
+        enabled: boolean;
+        image: string;
+        fit: "cover" | "contain" | "stretch" | "center";
+        pages: "all" | "first";
+    }>;
+    protected readonly parameters: import("@angular/core").Signal<ReportParameter[]>;
+    protected readonly doc: import("@angular/core").Signal<import("./render").ViewDocument>;
+    protected readonly pageCount: import("@angular/core").Signal<number>;
+    protected readonly shownPages: import("@angular/core").Signal<import("./render").ViewPage[]>;
+    /** Effective zoom factor (fit modes depend on the viewport and the page size). */
+    protected readonly zoom: import("@angular/core").Signal<number>;
+    protected readonly zoomKey: import("@angular/core").Signal<string>;
+    protected readonly thumbScale: import("@angular/core").Signal<number>;
+    protected readonly matches: import("@angular/core").Signal<{
+        key: string;
+        page: number;
+    }[]>;
+    protected readonly highlightSet: import("@angular/core").Signal<ReadonlySet<string>>;
+    protected readonly activeKey: import("@angular/core").Signal<string>;
+    protected readonly draft: import("@angular/core").WritableSignal<Record<string, string>>;
+    constructor();
+    protected choices(p: ReportParameter): string[];
+    protected setDraft(name: string, value: unknown): void;
+    protected applyParams(): void;
+    protected asBookmarks(v: unknown): Bookmark[];
+    protected goTo(index: number, top?: number): void;
+    protected goToBookmark(b: Bookmark): void;
+    /** Continuous modes: the current page is the one at the top third of the viewport. */
+    protected onScroll(): void;
+    protected setMode(m: ViewMode): void;
+    protected setZoom(v: string): void;
+    protected zoomStep(dir: 1 | -1): void;
+    protected toggleFind(): void;
+    protected setQuery(q: string): void;
+    protected findStep(dir: 1 | -1): void;
+    private revealMatch;
+    /** Runs `fn` with every page rendered at 100% (single-page mode would otherwise print one page). */
+    private withAllPages;
+    protected print(): void;
+    protected save(kind: string): void;
+    /** The report's data rows (after the report filter) as CSV. */
+    private csv;
+    protected fullscreen(): void;
+    protected openFile(e: Event): Promise<void>;
+    protected onKey(e: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ViewerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ViewerComponent, "rpt-viewer", never, { "embedded": { "alias": "embedded"; "required": false; "isSignal": true; }; "designerUrl": { "alias": "designerUrl"; "required": false; "isSignal": true; }; "allowOpen": { "alias": "allowOpen"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, never, true, never>;
+}
+export {};

package/lib/ui/viewer.component.d.ts

@@ -0,0 +1,40 @@
+import type { DataSourceType, ReportDefinition } from '../model/types';
+import * as i0 from "@angular/core";
+/**
+ * The report viewer.
+ *
+ * ```html
+ * <myreport-viewer path="/reports/sales.report.json" datasource="/api/orders" type="json" />
+ * <myreport-viewer path="/reports/orders.report.json" datasource="https://host/odata/Orders" type="odata" />
+ * ```
+ */
+export declare class MyReportViewerComponent {
+    private readonly store;
+    /** URL of the .report.json to show. */
+    readonly path: import("@angular/core").InputSignal<string | null | undefined>;
+    /** A report definition (object or JSON string); used when `path` is empty. */
+    readonly report: import("@angular/core").InputSignal<string | ReportDefinition | null | undefined>;
+    /**
+     * The report's data, replacing its own data source: a URL (JSON file/API, or OData service / entity-set URL),
+     * a JSON string, or (as a property) an array/object. Empty = use the report's data source.
+     */
+    readonly datasource: import("@angular/core").InputSignal<unknown>;
+    /** How `datasource` is read: `json` (default) or `odata`. */
+    readonly type: import("@angular/core").InputSignal<DataSourceType | null | undefined>;
+    /** Parameter values: object, JSON string, or query string (`Country=Egypt&Year=2024`). */
+    readonly params: import("@angular/core").InputSignal<string | Record<string, unknown> | null | undefined>;
+    /** Shows a "Designer" link in the toolbar pointing at this URL. */
+    readonly designerUrl: import("@angular/core").InputSignal<string | null | undefined>;
+    /** Shows the toolbar's Open button for local .report.json files (default true). */
+    readonly allowOpen: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** Fires with the report once it is loaded. */
+    readonly loaded: import("@angular/core").OutputEmitterRef<ReportDefinition>;
+    /** Fires with a message when the report or its data could not be loaded. */
+    readonly loadError: import("@angular/core").OutputEmitterRef<string>;
+    /** Fires with the rows once the data is loaded. */
+    readonly dataLoaded: import("@angular/core").OutputEmitterRef<import("../engine/expressions").Row[]>;
+    protected readonly error: import("@angular/core").WritableSignal<string | null>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<MyReportViewerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MyReportViewerComponent, "myreport-viewer", never, { "path": { "alias": "path"; "required": false; "isSignal": true; }; "report": { "alias": "report"; "required": false; "isSignal": true; }; "datasource": { "alias": "datasource"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "params": { "alias": "params"; "required": false; "isSignal": true; }; "designerUrl": { "alias": "designerUrl"; "required": false; "isSignal": true; }; "allowOpen": { "alias": "allowOpen"; "required": false; "isSignal": true; }; }, { "loaded": "loaded"; "loadError": "loadError"; "dataLoaded": "dataLoaded"; }, never, never, true, never>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "angular-my-report",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MyReport banded report designer and viewer for Angular: <myreport-designer> and <myreport-viewer>.",
   "keywords": [
     "angular",
@@ -14,13 +14,24 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@angular/common": ">=19.2.0 <21.0.0",
-    "@angular/core": ">=19.2.0 <21.0.0",
-    "@angular/forms": ">=19.2.0 <21.0.0"
+    "@angular/common": ">=18.1.0 <23.0.0",
+    "@angular/core": ">=18.1.0 <23.0.0",
+    "@angular/forms": ">=18.1.0 <23.0.0"
   },
   "dependencies": {
     "qrcode-generator": "^1.4.4",
     "tslib": "^2.3.0"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "module": "fesm2022/angular-my-report.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/angular-my-report.mjs"
+    }
+  }
 }

package/{src/public-api.ts → public-api.d.ts}

@@ -1,11 +1,6 @@
-/*
- * Public API of @mohamed351/angular
- */
 export { MyReportDesignerComponent } from './lib/ui/designer.component';
 export { MyReportViewerComponent } from './lib/ui/viewer.component';
 export { overrideDataSource, type DataOverride } from './lib/ui/designer.store';
-
-// Report model and engine helpers, for building or processing report definitions in code.
 export * from './lib/model/types';
 export { newReport, sampleReport, emptyDataSource } from './lib/model/defaults';
 export { receiptReport } from './lib/model/factories';

package/ng-package.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
-  "dest": "../../dist/angular",
-  "lib": { "entryFile": "src/public-api.ts" },
-  "allowedNonPeerDependencies": ["qrcode-generator"],
-  "assets": ["README.md"]
-}

package/src/lib/engine/barcode.ts

@@ -1,118 +0,0 @@
-import type { BarcodeSymbology } from '../model/types';
-
-export interface BarcodeResult {
-  /** One char per module: '1' = bar, '0' = space. Empty when `error` is set. */
-  modules: string;
-  /** Human-readable text printed under the bars. */
-  text: string;
-  error?: string;
-}
-
-// Code 128 symbol widths (bar, space, bar, space, bar, space) for values 0–105, then STOP (106).
-const CODE128 = [
-  '212222', '222122', '222221', '121223', '121322', '131222', '122213', '122312', '132212', '221213',
-  '221312', '231212', '112232', '122132', '122231', '113222', '123122', '123221', '223211', '221132',
-  '221231', '213212', '223112', '312131', '311222', '321122', '321221', '312212', '322112', '322211',
-  '212123', '212321', '232121', '111323', '131123', '131321', '112313', '132113', '132311', '211313',
-  '231113', '231311', '112133', '112331', '132131', '113123', '113321', '133121', '313121', '211331',
-  '231131', '213113', '213311', '213131', '311123', '311321', '331121', '312113', '312311', '332111',
-  '314111', '221411', '431111', '111224', '111422', '121124', '121421', '141122', '141221', '112214',
-  '112412', '122114', '122411', '142112', '142211', '241211', '221114', '413111', '241112', '134111',
-  '111242', '121142', '121241', '114212', '124112', '124211', '411212', '421112', '421211', '212141',
-  '214121', '412121', '111143', '111341', '131141', '114113', '114311', '411113', '411311', '113141',
-  '114131', '311141', '411131', '211412', '211214', '211232', '2331112',
-];
-const START_B = 104;
-const START_C = 105;
-const CODE_B = 100;
-const CODE_C = 99;
-const STOP = 106;
-
-const widthsToModules = (w: string) => [...w].map((n, i) => (i % 2 === 0 ? '1' : '0').repeat(Number(n))).join('');
-
-/**
- * Code 128: code set B for text, switching to code set C for runs of 4+ digits (denser).
- * Supports printable ASCII (32–126).
- */
-export function encodeCode128(value: string): BarcodeResult {
-  if (!value) return { modules: '', text: '', error: 'Empty value' };
-  if (![...value].every((c) => c.charCodeAt(0) >= 32 && c.charCodeAt(0) <= 126)) {
-    return { modules: '', text: value, error: 'Code 128 supports printable ASCII only' };
-  }
-  const digitRun = (i: number) => {
-    let n = 0;
-    while (i + n < value.length && value[i + n] >= '0' && value[i + n] <= '9') n++;
-    return n;
-  };
-
-  const codes: number[] = [];
-  let set: 'B' | 'C';
-  let i = 0;
-  const first = digitRun(0);
-  if (first >= 4) {
-    set = 'C';
-    codes.push(START_C);
-  } else {
-    set = 'B';
-    codes.push(START_B);
-  }
-
-  while (i < value.length) {
-    const run = digitRun(i);
-    if (set === 'C') {
-      if (run >= 2) {
-        codes.push(Number(value.slice(i, i + 2)));
-        i += 2;
-        continue;
-      }
-      codes.push(CODE_B);
-      set = 'B';
-    }
-    // Switch to C for a run of >= 4 digits; an odd run keeps its first digit in B.
-    if (run >= 4) {
-      if (run % 2 === 1) {
-        codes.push(value.charCodeAt(i) - 32);
-        i++;
-      }
-      codes.push(CODE_C);
-      set = 'C';
-      continue;
-    }
-    codes.push(value.charCodeAt(i) - 32);
-    i++;
-  }
-
-  const checksum = codes.reduce((sum, c, idx) => sum + c * (idx === 0 ? 1 : idx), 0) % 103;
-  codes.push(checksum, STOP);
-  return { modules: codes.map((c) => widthsToModules(CODE128[c])).join(''), text: value };
-}
-
-const EAN_L = ['0001101', '0011001', '0010011', '0111101', '0100011', '0110001', '0101111', '0111011', '0110111', '0001011'];
-const EAN_R = EAN_L.map((p) => [...p].map((b) => (b === '1' ? '0' : '1')).join(''));
-const EAN_G = EAN_R.map((p) => [...p].reverse().join(''));
-const EAN_PARITY = ['LLLLLL', 'LLGLGG', 'LLGGLG', 'LLGGGL', 'LGLLGG', 'LGGLLG', 'LGGGLL', 'LGLGLG', 'LGLGGL', 'LGGLGL'];
-
-export function ean13CheckDigit(first12: string): number {
-  const sum = [...first12].reduce((s, d, i) => s + Number(d) * (i % 2 === 0 ? 1 : 3), 0);
-  return (10 - (sum % 10)) % 10;
-}
-
-/** EAN-13 from 12 digits (check digit added) or 13 digits (check digit verified). */
-export function encodeEan13(value: string): BarcodeResult {
-  const v = value.replace(/\s+/g, '');
-  if (!/^\d{12,13}$/.test(v)) return { modules: '', text: value, error: 'EAN-13 needs 12 or 13 digits' };
-  const check = ean13CheckDigit(v.slice(0, 12));
-  if (v.length === 13 && Number(v[12]) !== check) return { modules: '', text: value, error: `Invalid check digit (expected ${check})` };
-  const digits = v.slice(0, 12) + check;
-  const parity = EAN_PARITY[Number(digits[0])];
-  let m = '101';
-  for (let k = 1; k <= 6; k++) m += (parity[k - 1] === 'L' ? EAN_L : EAN_G)[Number(digits[k])];
-  m += '01010';
-  for (let k = 7; k <= 12; k++) m += EAN_R[Number(digits[k])];
-  m += '101';
-  return { modules: m, text: digits };
-}
-
-export function encodeBarcode(symbology: BarcodeSymbology, value: string): BarcodeResult {
-  return symbology === 'ean13' ? encodeEan13(value) : encodeCode128(value);
-}

package/src/lib/engine/chart.ts

@@ -1,85 +0,0 @@
-import type { ChartSpec } from '../model/types';
-import { aggregate, getPath, type Row } from './expressions';
-
-/** Validated categorical palette (light surface), assigned in fixed order — never cycled. */
-export const SERIES_COLORS = ['#2a78d6', '#eb6834', '#1baf7a', '#eda100', '#e87ba4', '#008300', '#6250d6', '#e34948'];
-export const OTHER_COLOR = '#9a9a96';
-export const MAX_SERIES = SERIES_COLORS.length;
-
-export interface ChartData {
-  categories: string[];
-  series: { name: string; values: number[]; color: string }[];
-}
-
-const toNum = (v: unknown) => (typeof v === 'number' && Number.isFinite(v) ? v : Number(v) || 0);
-
-/** Groups rows by category and aggregates each value field into a series. */
-export function chartData(spec: ChartSpec, rows: Row[]): ChartData {
-  const pie = spec.type === 'pie' || spec.type === 'doughnut';
-  const fields = (spec.valueFields.filter(Boolean).length ? spec.valueFields.filter(Boolean) : ['']).slice(0, pie ? 1 : MAX_SERIES);
-
-  const groups = new Map<string, Row[]>();
-  for (const r of rows) {
-    const key = spec.categoryField ? String(getPath(r, spec.categoryField) ?? '(blank)') : 'All';
-    let g = groups.get(key);
-    if (!g) groups.set(key, (g = []));
-    g.push(r);
-  }
-  let cats = [...groups.keys()].map((name) => ({
-    name,
-    rows: groups.get(name)!,
-    values: fields.map((f) => toNum(aggregate(spec.aggregate, f, groups.get(name)!))),
-  }));
-
-  if (spec.sort === 'category') cats.sort((a, b) => a.name.localeCompare(b.name, undefined, { numeric: true }));
-  else if (spec.sort === 'valueDesc') cats.sort((a, b) => b.values[0] - a.values[0]);
-  else if (spec.sort === 'valueAsc') cats.sort((a, b) => a.values[0] - b.values[0]);
-
-  // Pie slices beyond the palette (or maxCategories) fold into "Other"; other charts are just truncated.
-  const max = Math.max(1, pie ? Math.min(spec.maxCategories || MAX_SERIES, MAX_SERIES) : spec.maxCategories || 50);
-  if (cats.length > max) {
-    if (pie) {
-      const keep = cats.slice(0, max - 1);
-      const rest = cats.slice(max - 1).flatMap((c) => c.rows);
-      keep.push({ name: 'Other', rows: rest, values: fields.map((f) => toNum(aggregate(spec.aggregate, f, rest))) });
-      cats = keep;
-    } else {
-      cats = cats.slice(0, max);
-    }
-  }
-
-  if (pie) {
-    return {
-      categories: cats.map((c) => c.name),
-      series: [{ name: fields[0] || 'Count', values: cats.map((c) => c.values[0]), color: SERIES_COLORS[0] }],
-    };
-  }
-  return {
-    categories: cats.map((c) => c.name),
-    series: fields.map((f, i) => ({ name: f || 'Count', values: cats.map((c) => c.values[i]), color: SERIES_COLORS[i] })),
-  };
-}
-
-/** Pie slice colors: one fixed-order hue per category, "Other" in neutral gray. */
-export const sliceColor = (name: string, i: number) => (name === 'Other' ? OTHER_COLOR : SERIES_COLORS[i % MAX_SERIES]);
-
-/** "Nice" axis: rounded max and tick step for values in [min, max]. */
-export function niceScale(min: number, max: number, ticks = 5): { min: number; max: number; step: number } {
-  const lo = Math.min(0, min);
-  const hi = Math.max(0, max);
-  if (hi === lo) return { min: lo, max: lo + 1, step: 0.2 };
-  const raw = (hi - lo) / ticks;
-  const mag = Math.pow(10, Math.floor(Math.log10(raw)));
-  const norm = raw / mag;
-  const step = (norm <= 1 ? 1 : norm <= 2 ? 2 : norm <= 2.5 ? 2.5 : norm <= 5 ? 5 : 10) * mag;
-  return { min: Math.floor(lo / step) * step, max: Math.ceil(hi / step) * step, step };
-}
-
-/** Short tick label: 1.2K, 3.4M. */
-export function compactNumber(n: number): string {
-  const a = Math.abs(n);
-  if (a >= 1e9) return +(n / 1e9).toFixed(1) + 'B';
-  if (a >= 1e6) return +(n / 1e6).toFixed(1) + 'M';
-  if (a >= 1e3) return +(n / 1e3).toFixed(1) + 'K';
-  return String(+n.toFixed(2));
-}