@orbcharts/core 3.0.6 → 4.0.0-pre-alpha.0

package/dist/src/utils/commonUtils.d.ts

@@ -1,9 +1,7 @@
+import { DeepPartial } from '../types/Common';
+
 export declare function isPlainObject(variable: any): boolean;
 export declare function isFunction(fn: any): boolean;
 export declare function isDom(obj: any): boolean;
-export declare function mergeOptionsWithDefault<Options extends {
-    [key: string]: any;
-}>(options: {
-    [key: string]: any;
-}, defaultOptions: Options): Options;
+export declare function deepOverwrite<DeepRecord extends Record<string, any>>(full: DeepRecord, options: DeepPartial<DeepRecord>): DeepRecord;
 export declare function formatCommaNumber(num?: number): string;

package/dist/src/utils/dom-lifecycle.d.ts

@@ -0,0 +1,37 @@
+/**
+ * DOM 元素生命週期管理工具
+ * 提供類似 D3.js 的 enter/update/exit 模式
+ */
+/**
+ * 比較兩個數組是否相等
+ */
+export declare function arraysEqual<T>(a: T[], b: T[]): boolean;
+/**
+ * 高效的元素重新排序函數，使用最少的 DOM 操作
+ */
+export declare function reorderElements<T extends Element>(parent: Element, targetOrder: string[], elementsRef: Record<string, T>): void;
+/**
+ * 元素工廠函數類型
+ */
+export type ElementFactory<T extends Element> = (id: string) => T;
+/**
+ * 生命週期鉤子函數類型
+ */
+export interface LifecycleHooks<T extends Element> {
+    /** 元素進入時的回調 */
+    onEnter?: (element: T, id: string) => void;
+    /** 元素更新時的回調 */
+    onUpdate?: (element: T, id: string) => void;
+    /** 元素退出前的回調 */
+    onExit?: (element: T, id: string) => void;
+}
+/**
+ * D3.js 風格的元素生命週期管理：處理 enter/update/exit
+ *
+ * @param parent 父容器元素
+ * @param targetIds 目標元素 ID 列表（按順序）
+ * @param elementsRef 元素引用字典
+ * @param createElement 元素創建工廠函數
+ * @param hooks 生命週期鉤子函數（可選）
+ */
+export declare function handleElementLifecycle<T extends Element>(parent: Element, targetIds: string[], elementsRef: Record<string, T>, createElement: ElementFactory<T>, hooks?: LifecycleHooks<T>): void;

package/dist/src/utils/dom.d.ts

@@ -0,0 +1,6 @@
+export declare function createSVG(className?: string): SVGSVGElement;
+export declare function createCanvasElement(className?: string): HTMLCanvasElement;
+export declare function createSVGGroup(className?: string): SVGGElement;
+export declare function createCanvas(className?: string): HTMLCanvasElement;
+export declare function createDiv(className?: string): HTMLDivElement;
+export declare function removeElementChildren(el: HTMLElement | Element): void;

package/dist/src/utils/index.d.ts

@@ -1,4 +1,8 @@
+export * from './aggregateUtils';
+export * from './colorUtils';
 export * from './commonUtils';
-export * from './d3Scale';
+export * from './dom';
+export * from './errorMessage';
 export * from './observables';
 export * from './orbchartsUtils';
+export * from './validator';

package/dist/src/utils/observables.d.ts

@@ -1,27 +1,3 @@
-import { Subject, Observable } from 'rxjs';
-import { ChartType, ChartParams, ComputedDatumTypeMap, ContainerPositionScaled, DataFormatterContainer, EventTypeMap, Layout } from '../../lib/core-types';
+import { Observable } from 'rxjs';
 
 export declare function resizeObservable(elem: HTMLElement | Element): Observable<DOMRectReadOnly>;
-export declare const highlightObservable: <T extends ChartType, D>({ datumList$, fullChartParams$, event$ }: {
-    datumList$: Observable<D[]>;
-    fullChartParams$: Observable<ChartParams>;
-    event$: Subject<EventTypeMap<T>>;
-}) => Observable<D[]>;
-export declare const seriesDataMapObservable: <DatumType extends ComputedDatumTypeMap<"series" | "grid">>({ datumList$ }: {
-    datumList$: Observable<DatumType[]>;
-}) => Observable<Map<string, DatumType[]>>;
-export declare const groupDataMapObservable: <DatumType extends ComputedDatumTypeMap<"grid">>({ datumList$ }: {
-    datumList$: Observable<DatumType[]>;
-}) => Observable<Map<string, DatumType[]>>;
-export declare const categoryDataMapObservable: <DatumType extends ComputedDatumTypeMap<"multiValue" | "relationship" | "tree">>({ datumList$ }: {
-    datumList$: Observable<DatumType[]>;
-}) => Observable<Map<string, DatumType[]>>;
-export declare const textSizePxObservable: (chartParams$: Observable<ChartParams>) => Observable<number>;
-export declare const containerSizeObservable: ({ layout$, containerPosition$, container$ }: {
-    layout$: Observable<Layout>;
-    containerPosition$: Observable<ContainerPositionScaled[]>;
-    container$: Observable<DataFormatterContainer>;
-}) => Observable<{
-    width: number;
-    height: number;
-}>;

package/dist/src/utils/orbchartsUtils.d.ts

@@ -1,53 +1,2 @@
-import { ChartType, ChartParams, DatumValue, DataSeries, DataGrid, DataGridDatum, DataMultiGrid, DataMultiValue, ComputedXYDatumMultiValue, DataFormatterContainer, SeriesDirection, DataFormatterGridGrid, ContainerPosition, ContainerPositionScaled, Layout } from '../../lib/core-types';
-import * as d3 from 'd3';
-export declare function formatValueToLabel(value: any, valueFormatter: string | ((text: d3.NumberValue) => string)): string;
-export declare function createDefaultDatumId(chartTypeOrPrefix: string, levelOneIndex: number, levelTwoIndex?: number, levelThreeIndex?: number): string;
-export declare function createDefaultSeriesLabel(chartTypeOrPrefix: string, seriesIndex: number): string;
-export declare function createDefaultGroupLabel(chartTypeOrPrefix: string, groupIndex: number): string;
-export declare function createDefaultCategoryLabel(): string;
-export declare function createDefaultValueLabel(chartTypeOrPrefix: string, valueIndex: number): string;
-export declare function createGridSeriesLabels({ transposedDataGrid, dataFormatterGrid, chartType }: {
-    transposedDataGrid: DataGridDatum[][];
-    dataFormatterGrid: DataFormatterGridGrid;
-    chartType?: ChartType;
-}): string[];
-export declare function createMultiGridSeriesLabels({ transposedDataGrid, dataFormatterGrid, chartType, gridIndex }: {
-    transposedDataGrid: DataGridDatum[][];
-    dataFormatterGrid: DataFormatterGridGrid;
-    chartType?: ChartType;
-    gridIndex?: number;
-}): string[];
-export declare function createGridGroupLabels({ transposedDataGrid, dataFormatterGrid, chartType }: {
-    transposedDataGrid: DataGridDatum[][];
-    dataFormatterGrid: DataFormatterGridGrid;
-    chartType?: ChartType;
-}): string[];
-export declare function createMultiGridGroupLabels({ transposedDataGrid, dataFormatterGrid, chartType, gridIndex }: {
-    transposedDataGrid: DataGridDatum[][];
-    dataFormatterGrid: DataFormatterGridGrid;
-    chartType?: ChartType;
-    gridIndex?: number;
-}): string[];
-export declare function getMinMax(data: number[]): [number, number];
-export declare function getMinMaxValue(data: DatumValue[]): [number, number];
-export declare function getMinMaxSeries(data: DataSeries): [number, number];
-export declare function getMinMaxGrid(data: DataGrid): [number, number];
-export declare function getMinMaxMultiGrid(data: DataMultiGrid): [number, number];
-export declare function getMinMaxMultiValue(data: DataMultiValue, valueIndex: number): [number, number];
-export declare function getMinMaxMultiValueXY({ data, minX, maxX, minY, maxY }: {
-    data: ComputedXYDatumMultiValue[][];
-    minX: number;
-    maxX: number;
-    minY: number;
-    maxY: number;
-}): {
-    minXDatum: ComputedXYDatumMultiValue;
-    maxXDatum: ComputedXYDatumMultiValue;
-    minYDatum: ComputedXYDatumMultiValue;
-    maxYDatum: ComputedXYDatumMultiValue;
-    filteredData: ComputedXYDatumMultiValue[][];
-};
-export declare function transposeData<T>(seriesDirection: SeriesDirection, data: T[][]): T[][];
-export declare function seriesColorPredicate(seriesIndex: number, chartParams: ChartParams): string;
-export declare function calcContainerPosition(layout: Layout, container: DataFormatterContainer, amount: number): ContainerPosition[];
-export declare function calcContainerPositionScaled(layout: Layout, container: DataFormatterContainer, amount: number): ContainerPositionScaled[];
+export declare function createPluginClassName(pluginName: string): string;
+export declare function createLayerClassName(pluginName: string, layerName: string): string;

package/dist/src/utils/validator.d.ts

@@ -1,3 +1,3 @@
-import { ValidatorResult, ValidatorRule } from '../../lib/core-types';
+import { ValidatorResult, ValidatorRule } from '../types';
 
-export declare function validateColumns<T>(data: T, rules: Partial<ValidatorRule<T>>): ValidatorResult;
+export declare function validateObject<T>(data: T, rules: Partial<ValidatorRule<T>>): ValidatorResult;

package/dist/test/aggregateTest.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,46 +1,59 @@
-{
-  "name": "@orbcharts/core",
-  "version": "3.0.6",
-  "description": "Core codes for OrbCharts",
-  "author": "Blue Planet Inc.",
-  "license": "Apache-2.0",
-  "keywords": [
-    "d3",
-    "rxjs",
-    "typescript",
-    "svg",
-    "visualization",
-    "infographic",
-    "graph",
-    "chart"
-  ],
-  "private": false,
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "*"
-  ],
-  "main": "./dist/orbcharts-core.umd.js",
-  "module": "./dist/orbcharts-core.es.js",
-  "types": "./dist/src/index.d.ts",
-  "unpkg": "./dist/orbcharts-core.umd.js",
-  "jsdelivr": "./dist/orbcharts-core.umd.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "vite build --mode production"
-  },
-  "devDependencies": {
-    "@types/d3": "^7.4.0",
-    "ts-loader": "^9.4.2",
-    "typescript": "^5.0.4",
-    "vite": "^5.3.5",
-    "vite-plugin-dts": "^3.7.3"
-  },
-  "dependencies": {
-    "@orbcharts/core-types": "^3.0.4",
-    "d3": "^7.8.5",
-    "rxjs": "^7.8.1"
-  }
-}
+{
+  "name": "@orbcharts/core",
+  "version": "4.0.0-pre-alpha.0",
+  "description": "Core codes for OrbCharts",
+  "author": "Blue Planet Inc.",
+  "license": "Apache-2.0",
+  "keywords": [
+    "d3",
+    "rxjs",
+    "typescript",
+    "svg",
+    "visualization",
+    "infographic",
+    "graph",
+    "chart"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/orbcharts-core.es.js",
+      "default": "./dist/orbcharts-core.umd.js"
+    },
+    "./types": {
+      "development": "./src/types/index.ts",
+      "types": "./dist/src/types/index.d.ts",
+      "default": "./src/types/index.ts"
+    },
+    "./types/*": "./src/types/*.ts",
+    "./*": "./src/*.ts"
+  },
+  "main": "./dist/orbcharts-core.umd.js",
+  "module": "./dist/orbcharts-core.es.js",
+  "types": "./dist/src/index.d.ts",
+  "unpkg": "./dist/orbcharts-core.umd.js",
+  "jsdelivr": "./dist/orbcharts-core.umd.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "vite build --mode production"
+  },
+  "devDependencies": {
+    "ts-loader": "^9.4.2",
+    "typescript": "^5.9.2",
+    "vite": "^5.3.5",
+    "vite-plugin-dts": "^3.7.3"
+  },
+  "dependencies": {
+    "rxjs": "^7.8.2"
+  }
+}

package/src/OrbCharts.ts

@@ -0,0 +1,35 @@
+import type {
+  DeepPartial,
+  Size,
+  ChartEntity,
+  ChartContext,
+  PartialChartOptions,
+  Encoding,
+  PluginEntity,
+  RawData,
+  Theme,
+  SizeConfig
+} from './types'
+import { createChart } from './chart/createChart'
+
+export class OrbCharts implements ChartEntity {
+  resize: (sizeConfig: SizeConfig) => void
+  setData: (data: RawData) => void
+  // setEncoding: (partial: DeepPartial<Encoding>) => void
+  updateEncoding: (patch: DeepPartial<Encoding>) => void
+  forceReplaceEncoding: (full: Encoding) => void
+  getEncoding: () => Readonly<Encoding>
+  setPlugins: (plugins: PluginEntity<any, any, any>[]) => void
+  addPlugin: (plugin: PluginEntity<any, any, any>) => void
+  removePlugin: (id: string) => void
+  // setTheme: (theme: Theme) => void
+  updateTheme: (patch: DeepPartial<Theme>) => void
+  forceReplaceTheme: (full: Theme) => void
+  getTheme: () => Readonly<Theme>
+  destroy: () => void;
+  context: ChartContext<unknown>
+
+  constructor(element: HTMLElement | Element, options?: PartialChartOptions) {
+    return createChart(element, options)
+  }
+}