@particle-academy/fancy-echarts 2.0.2 → 3.0.1

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import React$1, { RefObject } from 'react';
+import React$1, { RefObject, ReactNode } from 'react';
 import { EChartsOption } from 'echarts';
 export { ECharts as EChartsInstance, EChartsOption } from 'echarts';
 import { EChartsType } from 'echarts/core';
@@ -6,6 +6,7 @@ import { LineChart, BarChart, PieChart, ScatterChart, RadarChart, HeatmapChart,
 export { BarChart, BoxplotChart, CandlestickChart, CustomChart, EffectScatterChart, FunnelChart, GaugeChart, GraphChart, HeatmapChart, LineChart, MapChart, ParallelChart, PictorialBarChart, PieChart, RadarChart, SankeyChart, ScatterChart, SunburstChart, ThemeRiverChart, TreemapChart } from 'echarts/charts';
 import { GridComponent, TooltipComponent, TitleComponent, LegendComponent, DataZoomComponent, ToolboxComponent, VisualMapComponent, GeoComponent, ParallelComponent, CalendarComponent, GraphicComponent, PolarComponent, RadarComponent, DatasetComponent, MarkLineComponent, MarkPointComponent, MarkAreaComponent, TimelineComponent, BrushComponent, SingleAxisComponent } from 'echarts/components';
 export { CalendarComponent, DataZoomComponent, DatasetComponent, GeoComponent, GraphicComponent, GridComponent, LegendComponent, PolarComponent, TitleComponent, ToolboxComponent, TooltipComponent, VisualMapComponent } from 'echarts/components';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { CanvasRenderer, SVGRenderer } from 'echarts/renderers';
 
 interface EChartBaseProps {
@@ -224,4 +225,248 @@ declare function registerTheme(name: string, theme: object): void;
 /** Register all built-in theme presets */
 declare function registerBuiltinThemes(): void;
 
-export { type ChartDivProps, EChart, EChart3D, type EChartBaseProps, type EChartComponentProps, EChartGraphic, type EChartGraphicProps, type GraphicElement, type SeriesComponentProps, type UseEChartsOptions, type UseEChartsReturn, darkTheme, pastelTheme, registerAll, registerBuiltinThemes, registerCharts, registerComponents, registerTheme, useECharts, useResizeObserver, vintageTheme };
+interface ViewportState {
+    panX: number;
+    panY: number;
+    zoom: number;
+}
+
+type DiagramType = "erd" | "flowchart" | "general";
+/** ERD/UML shorthand — sets fromMarker/toMarker (and lineStyle for some). */
+type RelationType = "one-to-one" | "one-to-many" | "many-to-one" | "many-to-many" | "association" | "aggregation" | "composition" | "inheritance" | "implementation" | "dependency" | "custom";
+/** Shape painted at each line endpoint. Strings prefixed `emoji:` render the
+ *  rest of the string as text at the endpoint (e.g. `emoji:🎯`). */
+type MarkerType = "none" | "arrow" | "arrow-open" | "circle" | "circle-open" | "square" | "square-open" | "diamond" | "diamond-open" | "triangle" | "triangle-open" | "one" | "many" | "optional-one" | "optional-many" | "cross" | (string & {});
+type LineStyle = "solid" | "dashed" | "dotted";
+type RoutingMode = "manhattan" | "bezier" | "straight";
+type ExportFormat = "erd" | "uml" | "dfd";
+interface DiagramFieldData {
+    name: string;
+    type?: string;
+    primary?: boolean;
+    foreign?: boolean;
+    nullable?: boolean;
+}
+interface DiagramEntityData {
+    /** Unique identifier. Defaults to `name` if omitted. */
+    id?: string;
+    name: string;
+    fields?: DiagramFieldData[];
+    x?: number;
+    y?: number;
+}
+interface DiagramRelationData {
+    /** Unique identifier. Auto-generated if omitted. */
+    id?: string;
+    from: string;
+    to: string;
+    fromField?: string;
+    toField?: string;
+    type: RelationType;
+    fromMarker?: MarkerType;
+    toMarker?: MarkerType;
+    lineStyle?: LineStyle;
+    routing?: RoutingMode;
+    color?: string;
+    label?: string;
+}
+interface DiagramSchema {
+    entities: DiagramEntityData[];
+    relations: DiagramRelationData[];
+}
+interface DiagramContextValue {
+    diagramType: DiagramType;
+    schema: DiagramSchema;
+    downloadableRef: React.RefObject<boolean>;
+    importableRef: React.RefObject<boolean>;
+    exportFormats: ExportFormat[];
+    onImport?: (schema: DiagramSchema) => void;
+}
+interface DiagramProps {
+    children?: ReactNode;
+    schema?: DiagramSchema;
+    type?: DiagramType;
+    viewport?: ViewportState;
+    defaultViewport?: ViewportState;
+    onViewportChange?: (viewport: ViewportState) => void;
+    downloadable?: boolean;
+    importable?: boolean;
+    exportFormats?: ExportFormat[];
+    onImport?: (schema: DiagramSchema) => void;
+    minimap?: boolean;
+    className?: string;
+}
+interface DiagramEntityProps {
+    children?: ReactNode;
+    /** Unique identifier. Defaults to `name` if omitted. */
+    id?: string;
+    name: string;
+    x?: number;
+    y?: number;
+    color?: string;
+    /** Allow drag-to-move */
+    draggable?: boolean;
+    /** Called when the entity is dragged to a new position */
+    onPositionChange?: (x: number, y: number) => void;
+    className?: string;
+}
+interface DiagramFieldProps {
+    name: string;
+    type?: string;
+    primary?: boolean;
+    foreign?: boolean;
+    nullable?: boolean;
+    className?: string;
+}
+interface DiagramRelationProps {
+    from: string;
+    to: string;
+    fromField?: string;
+    toField?: string;
+    /** ERD/UML shorthand. Provides defaults for fromMarker/toMarker/lineStyle. */
+    type?: RelationType;
+    /** Override start endpoint marker. */
+    fromMarker?: MarkerType;
+    /** Override end endpoint marker. */
+    toMarker?: MarkerType;
+    /** Line style — solid (default), dashed, dotted. */
+    lineStyle?: LineStyle;
+    /** Routing algorithm — manhattan (default), bezier, straight. */
+    routing?: RoutingMode;
+    /** Stroke color. Defaults to a zinc gray. */
+    color?: string;
+    /** Stroke width. Default 2. */
+    strokeWidth?: number;
+    label?: string;
+    className?: string;
+}
+interface DiagramToolbarProps {
+    className?: string;
+}
+
+declare function DiagramEntity({ children, id: idProp, name, x, y, color, draggable, onPositionChange, className, }: DiagramEntityProps): react_jsx_runtime.JSX.Element;
+declare namespace DiagramEntity {
+    var displayName: string;
+}
+
+declare function DiagramField({ name, type, primary, foreign, nullable, className, }: DiagramFieldProps): react_jsx_runtime.JSX.Element;
+declare namespace DiagramField {
+    var displayName: string;
+}
+
+declare function DiagramRelation({ from, to, fromField: fromFieldProp, toField: toFieldProp, type, fromMarker: fromMarkerProp, toMarker: toMarkerProp, lineStyle: lineStyleProp, routing, color, strokeWidth, label, }: DiagramRelationProps): react_jsx_runtime.JSX.Element | null;
+declare namespace DiagramRelation {
+    var _isCanvasEdge: boolean;
+    var displayName: string;
+}
+
+declare function DiagramToolbar({ className }: DiagramToolbarProps): react_jsx_runtime.JSX.Element | null;
+declare namespace DiagramToolbar {
+    var displayName: string;
+}
+
+declare function DiagramRoot({ children, schema, type, viewport, defaultViewport, onViewportChange, downloadable, importable, exportFormats, onImport, minimap, className, }: DiagramProps): react_jsx_runtime.JSX.Element;
+declare const Diagram: typeof DiagramRoot & {
+    Entity: typeof DiagramEntity;
+    Field: typeof DiagramField;
+    Relation: typeof DiagramRelation;
+    Toolbar: typeof DiagramToolbar;
+};
+
+declare function useDiagram(): DiagramContextValue;
+
+/**
+ * ERD/UML preset of {@link Diagram}. Pre-applies the most common defaults for
+ * data-modeling diagrams: type="erd", downloadable, ERD + UML export formats,
+ * minimap on. Pass any DiagramProps to override.
+ */
+declare function DataDiagram(props: DiagramProps): react_jsx_runtime.JSX.Element;
+declare namespace DataDiagram {
+    var Entity: typeof DiagramEntity;
+    var Field: typeof DiagramField;
+    var Relation: typeof DiagramRelation;
+    var Toolbar: typeof DiagramToolbar;
+    var displayName: string;
+}
+
+interface FlowchartNode {
+    id: string;
+    label: string;
+    x?: number;
+    y?: number;
+    color?: string;
+}
+interface FlowchartEdge {
+    from: string;
+    to: string;
+    /** Defaults to "association" (line with arrow on `to` end). */
+    type?: RelationType;
+    label?: string;
+}
+interface FlowchartProps {
+    nodes: FlowchartNode[];
+    edges: FlowchartEdge[];
+    /** Defaults to "manhattan". */
+    routing?: RoutingMode;
+    downloadable?: boolean;
+    minimap?: boolean;
+    className?: string;
+}
+/**
+ * Boxes-and-arrows flowchart. Thin schema adapter over {@link Diagram} —
+ * each node becomes a label-only entity, each edge becomes a relation.
+ */
+declare function Flowchart({ nodes, edges, routing, downloadable, minimap, className, }: FlowchartProps): react_jsx_runtime.JSX.Element;
+declare namespace Flowchart {
+    var displayName: string;
+}
+
+interface MindmapNode {
+    id: string;
+    label: string;
+    color?: string;
+    children?: MindmapNode[];
+}
+
+interface MindmapProps {
+    root: MindmapNode;
+    /** Override the default ring radii (level 0 is always center). */
+    radii?: number[];
+    downloadable?: boolean;
+    minimap?: boolean;
+    className?: string;
+}
+/**
+ * Radial mindmap. Root at center; children fan outward on concentric rings
+ * using bezier-routed connectors. Angular wedges are sized by subtree leaf
+ * count so dense branches get more room than sparse ones.
+ */
+declare function Mindmap({ root, radii, downloadable, minimap, className, }: MindmapProps): react_jsx_runtime.JSX.Element;
+declare namespace Mindmap {
+    var displayName: string;
+}
+
+interface OrgChartNode {
+    id: string;
+    label: string;
+    color?: string;
+    children?: OrgChartNode[];
+}
+
+interface OrgChartProps {
+    root: OrgChartNode;
+    downloadable?: boolean;
+    minimap?: boolean;
+    className?: string;
+}
+/**
+ * Top-down hierarchy diagram. Each parent sits centered over the span of its
+ * descendants; manhattan-routed connectors with an open triangle on the
+ * child end give it a UML-inheritance feel.
+ */
+declare function OrgChart({ root, downloadable, minimap, className, }: OrgChartProps): react_jsx_runtime.JSX.Element;
+declare namespace OrgChart {
+    var displayName: string;
+}
+
+export { type ChartDivProps, DataDiagram, Diagram, type DiagramContextValue, type DiagramEntityData, type DiagramEntityProps, type DiagramFieldData, type DiagramFieldProps, type DiagramProps, type DiagramRelationData, type DiagramRelationProps, type DiagramSchema, type DiagramToolbarProps, type DiagramType, EChart, EChart3D, type EChartBaseProps, type EChartComponentProps, EChartGraphic, type EChartGraphicProps, type ExportFormat, Flowchart, type FlowchartEdge, type FlowchartNode, type FlowchartProps, type GraphicElement, type LineStyle, type MarkerType, Mindmap, type MindmapNode, type MindmapProps, OrgChart, type OrgChartNode, type OrgChartProps, type RelationType, type RoutingMode, type SeriesComponentProps, type UseEChartsOptions, type UseEChartsReturn, type ViewportState, darkTheme, pastelTheme, registerAll, registerBuiltinThemes, registerCharts, registerComponents, registerTheme, useDiagram, useECharts, useResizeObserver, vintageTheme };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import React$1, { RefObject } from 'react';
+import React$1, { RefObject, ReactNode } from 'react';
 import { EChartsOption } from 'echarts';
 export { ECharts as EChartsInstance, EChartsOption } from 'echarts';
 import { EChartsType } from 'echarts/core';
@@ -6,6 +6,7 @@ import { LineChart, BarChart, PieChart, ScatterChart, RadarChart, HeatmapChart,
 export { BarChart, BoxplotChart, CandlestickChart, CustomChart, EffectScatterChart, FunnelChart, GaugeChart, GraphChart, HeatmapChart, LineChart, MapChart, ParallelChart, PictorialBarChart, PieChart, RadarChart, SankeyChart, ScatterChart, SunburstChart, ThemeRiverChart, TreemapChart } from 'echarts/charts';
 import { GridComponent, TooltipComponent, TitleComponent, LegendComponent, DataZoomComponent, ToolboxComponent, VisualMapComponent, GeoComponent, ParallelComponent, CalendarComponent, GraphicComponent, PolarComponent, RadarComponent, DatasetComponent, MarkLineComponent, MarkPointComponent, MarkAreaComponent, TimelineComponent, BrushComponent, SingleAxisComponent } from 'echarts/components';
 export { CalendarComponent, DataZoomComponent, DatasetComponent, GeoComponent, GraphicComponent, GridComponent, LegendComponent, PolarComponent, TitleComponent, ToolboxComponent, TooltipComponent, VisualMapComponent } from 'echarts/components';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 export { CanvasRenderer, SVGRenderer } from 'echarts/renderers';
 
 interface EChartBaseProps {
@@ -224,4 +225,248 @@ declare function registerTheme(name: string, theme: object): void;
 /** Register all built-in theme presets */
 declare function registerBuiltinThemes(): void;
 
-export { type ChartDivProps, EChart, EChart3D, type EChartBaseProps, type EChartComponentProps, EChartGraphic, type EChartGraphicProps, type GraphicElement, type SeriesComponentProps, type UseEChartsOptions, type UseEChartsReturn, darkTheme, pastelTheme, registerAll, registerBuiltinThemes, registerCharts, registerComponents, registerTheme, useECharts, useResizeObserver, vintageTheme };
+interface ViewportState {
+    panX: number;
+    panY: number;
+    zoom: number;
+}
+
+type DiagramType = "erd" | "flowchart" | "general";
+/** ERD/UML shorthand — sets fromMarker/toMarker (and lineStyle for some). */
+type RelationType = "one-to-one" | "one-to-many" | "many-to-one" | "many-to-many" | "association" | "aggregation" | "composition" | "inheritance" | "implementation" | "dependency" | "custom";
+/** Shape painted at each line endpoint. Strings prefixed `emoji:` render the
+ *  rest of the string as text at the endpoint (e.g. `emoji:🎯`). */
+type MarkerType = "none" | "arrow" | "arrow-open" | "circle" | "circle-open" | "square" | "square-open" | "diamond" | "diamond-open" | "triangle" | "triangle-open" | "one" | "many" | "optional-one" | "optional-many" | "cross" | (string & {});
+type LineStyle = "solid" | "dashed" | "dotted";
+type RoutingMode = "manhattan" | "bezier" | "straight";
+type ExportFormat = "erd" | "uml" | "dfd";
+interface DiagramFieldData {
+    name: string;
+    type?: string;
+    primary?: boolean;
+    foreign?: boolean;
+    nullable?: boolean;
+}
+interface DiagramEntityData {
+    /** Unique identifier. Defaults to `name` if omitted. */
+    id?: string;
+    name: string;
+    fields?: DiagramFieldData[];
+    x?: number;
+    y?: number;
+}
+interface DiagramRelationData {
+    /** Unique identifier. Auto-generated if omitted. */
+    id?: string;
+    from: string;
+    to: string;
+    fromField?: string;
+    toField?: string;
+    type: RelationType;
+    fromMarker?: MarkerType;
+    toMarker?: MarkerType;
+    lineStyle?: LineStyle;
+    routing?: RoutingMode;
+    color?: string;
+    label?: string;
+}
+interface DiagramSchema {
+    entities: DiagramEntityData[];
+    relations: DiagramRelationData[];
+}
+interface DiagramContextValue {
+    diagramType: DiagramType;
+    schema: DiagramSchema;
+    downloadableRef: React.RefObject<boolean>;
+    importableRef: React.RefObject<boolean>;
+    exportFormats: ExportFormat[];
+    onImport?: (schema: DiagramSchema) => void;
+}
+interface DiagramProps {
+    children?: ReactNode;
+    schema?: DiagramSchema;
+    type?: DiagramType;
+    viewport?: ViewportState;
+    defaultViewport?: ViewportState;
+    onViewportChange?: (viewport: ViewportState) => void;
+    downloadable?: boolean;
+    importable?: boolean;
+    exportFormats?: ExportFormat[];
+    onImport?: (schema: DiagramSchema) => void;
+    minimap?: boolean;
+    className?: string;
+}
+interface DiagramEntityProps {
+    children?: ReactNode;
+    /** Unique identifier. Defaults to `name` if omitted. */
+    id?: string;
+    name: string;
+    x?: number;
+    y?: number;
+    color?: string;
+    /** Allow drag-to-move */
+    draggable?: boolean;
+    /** Called when the entity is dragged to a new position */
+    onPositionChange?: (x: number, y: number) => void;
+    className?: string;
+}
+interface DiagramFieldProps {
+    name: string;
+    type?: string;
+    primary?: boolean;
+    foreign?: boolean;
+    nullable?: boolean;
+    className?: string;
+}
+interface DiagramRelationProps {
+    from: string;
+    to: string;
+    fromField?: string;
+    toField?: string;
+    /** ERD/UML shorthand. Provides defaults for fromMarker/toMarker/lineStyle. */
+    type?: RelationType;
+    /** Override start endpoint marker. */
+    fromMarker?: MarkerType;
+    /** Override end endpoint marker. */
+    toMarker?: MarkerType;
+    /** Line style — solid (default), dashed, dotted. */
+    lineStyle?: LineStyle;
+    /** Routing algorithm — manhattan (default), bezier, straight. */
+    routing?: RoutingMode;
+    /** Stroke color. Defaults to a zinc gray. */
+    color?: string;
+    /** Stroke width. Default 2. */
+    strokeWidth?: number;
+    label?: string;
+    className?: string;
+}
+interface DiagramToolbarProps {
+    className?: string;
+}
+
+declare function DiagramEntity({ children, id: idProp, name, x, y, color, draggable, onPositionChange, className, }: DiagramEntityProps): react_jsx_runtime.JSX.Element;
+declare namespace DiagramEntity {
+    var displayName: string;
+}
+
+declare function DiagramField({ name, type, primary, foreign, nullable, className, }: DiagramFieldProps): react_jsx_runtime.JSX.Element;
+declare namespace DiagramField {
+    var displayName: string;
+}
+
+declare function DiagramRelation({ from, to, fromField: fromFieldProp, toField: toFieldProp, type, fromMarker: fromMarkerProp, toMarker: toMarkerProp, lineStyle: lineStyleProp, routing, color, strokeWidth, label, }: DiagramRelationProps): react_jsx_runtime.JSX.Element | null;
+declare namespace DiagramRelation {
+    var _isCanvasEdge: boolean;
+    var displayName: string;
+}
+
+declare function DiagramToolbar({ className }: DiagramToolbarProps): react_jsx_runtime.JSX.Element | null;
+declare namespace DiagramToolbar {
+    var displayName: string;
+}
+
+declare function DiagramRoot({ children, schema, type, viewport, defaultViewport, onViewportChange, downloadable, importable, exportFormats, onImport, minimap, className, }: DiagramProps): react_jsx_runtime.JSX.Element;
+declare const Diagram: typeof DiagramRoot & {
+    Entity: typeof DiagramEntity;
+    Field: typeof DiagramField;
+    Relation: typeof DiagramRelation;
+    Toolbar: typeof DiagramToolbar;
+};
+
+declare function useDiagram(): DiagramContextValue;
+
+/**
+ * ERD/UML preset of {@link Diagram}. Pre-applies the most common defaults for
+ * data-modeling diagrams: type="erd", downloadable, ERD + UML export formats,
+ * minimap on. Pass any DiagramProps to override.
+ */
+declare function DataDiagram(props: DiagramProps): react_jsx_runtime.JSX.Element;
+declare namespace DataDiagram {
+    var Entity: typeof DiagramEntity;
+    var Field: typeof DiagramField;
+    var Relation: typeof DiagramRelation;
+    var Toolbar: typeof DiagramToolbar;
+    var displayName: string;
+}
+
+interface FlowchartNode {
+    id: string;
+    label: string;
+    x?: number;
+    y?: number;
+    color?: string;
+}
+interface FlowchartEdge {
+    from: string;
+    to: string;
+    /** Defaults to "association" (line with arrow on `to` end). */
+    type?: RelationType;
+    label?: string;
+}
+interface FlowchartProps {
+    nodes: FlowchartNode[];
+    edges: FlowchartEdge[];
+    /** Defaults to "manhattan". */
+    routing?: RoutingMode;
+    downloadable?: boolean;
+    minimap?: boolean;
+    className?: string;
+}
+/**
+ * Boxes-and-arrows flowchart. Thin schema adapter over {@link Diagram} —
+ * each node becomes a label-only entity, each edge becomes a relation.
+ */
+declare function Flowchart({ nodes, edges, routing, downloadable, minimap, className, }: FlowchartProps): react_jsx_runtime.JSX.Element;
+declare namespace Flowchart {
+    var displayName: string;
+}
+
+interface MindmapNode {
+    id: string;
+    label: string;
+    color?: string;
+    children?: MindmapNode[];
+}
+
+interface MindmapProps {
+    root: MindmapNode;
+    /** Override the default ring radii (level 0 is always center). */
+    radii?: number[];
+    downloadable?: boolean;
+    minimap?: boolean;
+    className?: string;
+}
+/**
+ * Radial mindmap. Root at center; children fan outward on concentric rings
+ * using bezier-routed connectors. Angular wedges are sized by subtree leaf
+ * count so dense branches get more room than sparse ones.
+ */
+declare function Mindmap({ root, radii, downloadable, minimap, className, }: MindmapProps): react_jsx_runtime.JSX.Element;
+declare namespace Mindmap {
+    var displayName: string;
+}
+
+interface OrgChartNode {
+    id: string;
+    label: string;
+    color?: string;
+    children?: OrgChartNode[];
+}
+
+interface OrgChartProps {
+    root: OrgChartNode;
+    downloadable?: boolean;
+    minimap?: boolean;
+    className?: string;
+}
+/**
+ * Top-down hierarchy diagram. Each parent sits centered over the span of its
+ * descendants; manhattan-routed connectors with an open triangle on the
+ * child end give it a UML-inheritance feel.
+ */
+declare function OrgChart({ root, downloadable, minimap, className, }: OrgChartProps): react_jsx_runtime.JSX.Element;
+declare namespace OrgChart {
+    var displayName: string;
+}
+
+export { type ChartDivProps, DataDiagram, Diagram, type DiagramContextValue, type DiagramEntityData, type DiagramEntityProps, type DiagramFieldData, type DiagramFieldProps, type DiagramProps, type DiagramRelationData, type DiagramRelationProps, type DiagramSchema, type DiagramToolbarProps, type DiagramType, EChart, EChart3D, type EChartBaseProps, type EChartComponentProps, EChartGraphic, type EChartGraphicProps, type ExportFormat, Flowchart, type FlowchartEdge, type FlowchartNode, type FlowchartProps, type GraphicElement, type LineStyle, type MarkerType, Mindmap, type MindmapNode, type MindmapProps, OrgChart, type OrgChartNode, type OrgChartProps, type RelationType, type RoutingMode, type SeriesComponentProps, type UseEChartsOptions, type UseEChartsReturn, type ViewportState, darkTheme, pastelTheme, registerAll, registerBuiltinThemes, registerCharts, registerComponents, registerTheme, useDiagram, useECharts, useResizeObserver, vintageTheme };