rich-react-component 0.3.2 → 0.4.1

package/dist/base/chart/chartTypes.d.ts

@@ -0,0 +1,58 @@
+import { ReactNode } from 'react';
+/**
+ * Small, semantic contracts shared by every chart in the family (doc section
+ * 13 — compose small parts rather than one "MassiveChartProps"). Every
+ * concrete chart (LineChart, BarChart, DonutChart, ...) extends the subset
+ * that applies to it.
+ */
+export type ChartValue = string | number | Date;
+export type ChartTone = "primary" | "success" | "warning" | "danger" | "info" | "secondary";
+/** A row of chart data. Cartesian charts index it by `xKey` + each series' `key`; circular charts by `nameKey`/`valueKey`. */
+export type ChartDatum = Record<string, ChartValue | null | undefined>;
+export interface ChartSeries {
+    key: string;
+    label: string;
+    /** Explicit color — a CSS color or a `var(--rrc-*)` reference. Omitted: the chart's palette token assigns one by index. */
+    color?: string;
+    /** Series sharing a `stackId` stack on top of each other in BarChart/StackedBarChart. */
+    stackId?: string;
+    /** Initial visibility; the legend can still toggle it (uncontrolled unless `hiddenSeriesKeys` is passed). */
+    hidden?: boolean;
+    valueFormatter?: (value: number) => string;
+}
+export interface ChartInteraction {
+    seriesKey: string;
+    datum: ChartDatum;
+    value: number;
+    index: number;
+}
+export interface ChartSliceInteraction {
+    key: string;
+    label: string;
+    value: number;
+    index: number;
+    datum: ChartDatum;
+}
+/** Shared status/infrastructure props every chart composes via `Chart`/`ChartStatus` (doc: don't reimplement per chart type). */
+export interface ChartStatusProps {
+    loading?: boolean;
+    /** Non-empty renders the error state instead of the chart. */
+    error?: ReactNode;
+    /** Shown when `data` (or every series in it) is empty. */
+    emptyMessage?: ReactNode;
+    disabled?: boolean;
+}
+export interface ChartCommonProps extends ChartStatusProps {
+    title?: string;
+    /** Fixed height; width is measured from the container (ResizeObserver, SSR-safe fallback). */
+    height?: number;
+    className?: string;
+    showLegend?: boolean;
+    showTooltip?: boolean;
+    /** Disables the CSS entrance animation; also forced off under `prefers-reduced-motion`. */
+    animate?: boolean;
+    /** Accessible name for the chart region; falls back to `title`. */
+    "aria-label"?: string;
+    /** Palette override, applied to series/slices in order before any per-item `color`. */
+    colors?: string[];
+}

package/dist/base/chart/useChartDimensions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Measures the chart's own container width (doc: responsive width, no global
+ * breakpoint). Reuses `useElementResize` (ResizeObserver with a window-resize
+ * fallback, already SSR-safe) instead of a second measurement strategy.
+ *
+ * Starts at 0 so the very first server/client render emits no SVG at all
+ * (avoids a divide-by-zero layout before the real width is known); the
+ * measured width lands on the next paint, which is invisible to the user.
+ */
+export declare function useChartDimensions(): {
+    containerRef: React.RefObject<HTMLDivElement>;
+    width: number;
+};

package/dist/base/chart/useChartIndexNavigation.d.ts

@@ -0,0 +1,23 @@
+import { KeyboardEvent } from 'react';
+export interface UseChartIndexNavigationOptions {
+    count: number;
+    disabled?: boolean;
+    onActivate?: (index: number) => void;
+    onSelect?: (index: number) => void;
+}
+export interface ChartIndexNavigation {
+    activeIndex: number;
+    setActiveIndex: (index: number) => void;
+    clearActive: () => void;
+    handleKeyDown: (event: KeyboardEvent) => void;
+}
+/**
+ * Roving index navigation shared by every chart shape: Left/Right (or the
+ * next/previous data point) moves the focused/hover point, Home/End jump to
+ * the ends, Enter/Space fires the same callback a mouse click on that point
+ * would (doc: "veri noktasına tıklama" and "klavye ile veri noktaları arasında
+ * hareket" are one interaction model, not two). Used for x-categories in the
+ * cartesian charts (Line/Area/Bar/StackedBar) and for slices in the circular
+ * ones (Donut/Pie) — the math is identical, only what "index" means differs.
+ */
+export declare function useChartIndexNavigation({ count, disabled, onActivate, onSelect }: UseChartIndexNavigationOptions): ChartIndexNavigation;

package/dist/base/index.d.ts

@@ -59,6 +59,34 @@ export * from './IconButton';
 export * from './ListItem';
 export * from './Sparkline';
 export * from './Statistic';
+/**
+ * Chart family (doc: full-size Line/Area/Bar/StackedBar/Donut/Pie, distinct
+ * from the compact `Sparkline`). `Chart` is the shared responsive/status
+ * shell every concrete chart composes and is itself public for a consumer
+ * building a custom visualization; `ChartLegend` is the shared series legend.
+ * The per-chart-type render logic (`chart/*Base.tsx`) stays internal.
+ */
+export { Chart } from './Chart';
+export type { ChartProps } from './Chart';
+export { ChartLegend, legendItemsFromSeries } from './ChartLegend';
+export type { ChartLegendItem, ChartLegendProps } from './ChartLegend';
+export { LineChart } from './LineChart';
+export type { LineChartProps } from './LineChart';
+export { AreaChart } from './AreaChart';
+export type { AreaChartProps } from './AreaChart';
+export { BarChart } from './BarChart';
+export type { BarChartProps } from './BarChart';
+export { StackedBarChart } from './StackedBarChart';
+export type { StackedBarChartProps } from './StackedBarChart';
+export { DonutChart } from './DonutChart';
+export type { DonutChartProps } from './DonutChart';
+export { PieChart } from './PieChart';
+export type { PieChartProps } from './PieChart';
+export type { ChartCommonProps, ChartDatum, ChartInteraction, ChartSeries, ChartSliceInteraction, ChartStatusProps, ChartTone, ChartValue, } from './chart/chartTypes';
+export { Calendar } from './Calendar';
+export type { CalendarEvent, CalendarEventVariant, CalendarProps, CalendarView } from './Calendar';
+export { DocumentViewer } from './DocumentViewer';
+export type { DocumentViewerError, DocumentViewerErrorKind, DocumentViewerLabels, DocumentViewerProps, DocumentViewerSource, } from './DocumentViewer';
 export { AppearanceProvider, useAppearance, createAppearanceInitScript, THEME_MODES, SIDEBAR_PRESENTATIONS, SIDEBAR_TONES } from './Appearance';
 export type { AppearanceContextValue, AppearanceInitScriptOptions, AppearanceProviderProps, AppearanceSettings, AppearanceStorage, ResolvedTheme, SidebarPresentation, SidebarTone, ThemeMode, } from './Appearance';
 export * from './appearanceSchemes';