@kala-ui/react-app 0.1.0-beta.0 → 0.1.0-beta.10

package/CHANGELOG.md

@@ -1,5 +1,88 @@
 # @kala-ui/react-app
 
+## 0.1.0-beta.10
+
+### Patch Changes
+
+- Fixes
+- Updated dependencies
+  - @kala-ui/react@0.1.0-beta.9
+
+## 0.1.0-beta.9
+
+### Patch Changes
+
+- Updated dependencies
+  - @kala-ui/react@0.1.0-beta.8
+
+## 0.1.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies
+  - @kala-ui/react@0.1.0-beta.7
+
+## 0.1.0-beta.7
+
+### Patch Changes
+
+- Updated dependencies [8382731]
+  - @kala-ui/react@0.1.0-beta.6
+
+## 0.1.0-beta.6
+
+### Patch Changes
+
+- new changes
+- Updated dependencies
+  - @kala-ui/react@0.1.0-beta.5
+  - @kala-ui/react-hooks@0.1.0-beta.1
+
+## 0.1.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [5ecd609]
+- Updated dependencies [ed367cc]
+  - @kala-ui/react@0.1.0-beta.4
+
+## 0.1.0-beta.4
+
+### Patch Changes
+
+- Updated dependencies
+  - @kala-ui/react@0.1.0-beta.3
+
+## 0.1.0-beta.3
+
+### Minor Changes
+
+- NavLink: optional anchor mode. Passing `href` renders a real `<a>` (default button behavior unchanged otherwise) so top-level navigation targets keep native middle-click/clone-tab semantics. In anchor mode: `active` sets `aria-current="page"`; button-only props (`type`, `disabled`) are never spread onto the anchor (`disabled` degrades to `aria-disabled` + pointer-events styling); a plain left-click is preventDefaulted for client-side routing while modifier/middle clicks stay native. Nested-collapse (chevron toggle) remains button-mode-only.
+
+## 0.1.0-beta.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @kala-ui/react@0.1.0-beta.2
+
+## 0.1.0-beta.1
+
+### Minor Changes
+
+- b5cd997: Add stable `data-kala-component` identification attributes to every component root.
+  
+  Every component (and each compound part, e.g. `dialog-content`, `card-header`, `data-table-toolbar`) now renders `data-kala-component="<kebab-name>"` on its root element. This is a guaranteed-stable public API for DevTools debugging, e2e selectors, and targeted consumer CSS overrides.
+  
+  - No styling or behavior changes — the attribute is identification only.
+  - The ad-hoc `data-comp` markers previously used by a few components were migrated to `data-kala-component` (update any selectors that queried `[data-comp='...']`).
+  - shadcn-compatible `data-slot` attributes are unchanged.
+
+### Patch Changes
+
+- Updated dependencies [b5cd997]
+  - @kala-ui/react@0.1.0-beta.1
+
 ## 0.1.0-beta.0
 
 ### Added

package/README.md

@@ -4,18 +4,18 @@ App-level composite components for [Kala UI](https://github.com/krr2020/kala-ui)
 
 ## What's inside
 
-- **Application chrome** — `AppShell`, `Header`, `Sidebar`, `Footer`, `Navigation`, `NavLink`
+- **Application chrome** — `AppShell`, `Header`, `Sidebar`, `Footer`, `Navigation`, `NavLink` (plus the `isActivePath` routing helper from `@kala-ui/react-app/lib/active-path`)
 - **Data-heavy composites** — `DataTable` (sorting / filtering / pagination / selection / server-side), `Dnd` (dnd-kit sortable lists and boards)
-- **Charts** — `AreaChart`, `BarChart`, `LineChart`, `DonutChart`, `RadialBarChart`, `SparklineChart` (ApexCharts wrappers, theme-aware)
+- **Charts** — `AreaChart`, `BarChart`, `LineChart`, `DonutChart`, `RadialBarChart`, `SparklineChart` (ApexCharts wrappers, theme-aware, lazy-loaded)
 - **Dashboard & domain widgets** — `MetricCard`, `SessionCard`, `UserMenuDropdown`, `SocialLoginButton(s)`
 
 ## Installation
 
 ```bash
-pnpm add @kala-ui/react-app @kala-ui/react
+pnpm add @kala-ui/react-app@beta @kala-ui/react@beta
 ```
 
-Import the core stylesheet first, then this package's utilities:
+Requires React 19.2+. Import the core stylesheet first, then this package's utilities (theme, tokens, preflight and `kala-*` helpers ship once via the core):
 
 ```css
 @import "@kala-ui/react/styles";
@@ -29,6 +29,11 @@ import { Button, ThemeProvider } from "@kala-ui/react";
 import { AppShell, DataTable } from "@kala-ui/react-app";
 ```
 
+Every component has a subpath export (`@kala-ui/react-app/<component>`) plus
+the barrel. All component modules ship a `"use client"` banner, so they import
+cleanly into React Server Component apps — charts lazy-load ApexCharts on the
+client only.
+
 See the repository README and [THEMING.md](https://github.com/krr2020/kala-ui/blob/main/THEMING.md) for theming, dark mode and framework integration.
 
 ## License

package/dist/components/app-shell/app-shell.d.ts

@@ -1,30 +1,11 @@
 import * as React from "react";
-export interface AppShellProps extends React.ComponentProps<"div"> {
-    /** Header configuration */
-    header?: {
-        height: number | string;
-    };
-    /**
-     * Navbar configuration. The navbar sits off-canvas below `breakpoint`
-     * and reserves Main's left padding from it upward.
-     */
-    navbar?: {
-        width: number | string;
-        breakpoint?: "sm" | "md" | "lg" | "xl";
-    };
-    /** Aside configuration. Mirrors the navbar on the right edge. */
-    aside?: {
-        width: number | string;
-        breakpoint?: "sm" | "md" | "lg" | "xl";
-    };
-    /** Footer configuration */
-    footer?: {
-        height: number | string;
-    };
-    /** Padding for the main content */
-    padding?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
-}
-declare function AppShellBase({ children, className, header, navbar, aside, footer, padding, ref, ...props }: AppShellProps): React.JSX.Element;
+import type { AppShellAsideProps, AppShellFooterProps, AppShellHeaderProps, AppShellMainProps, AppShellNavbarProps, AppShellProps } from "./app-shell.types";
+declare function AppShellBase({ children, className, style, slotStyles: slotStylesRaw, header, navbar, aside, footer, padding, ref, ...props }: AppShellProps): React.JSX.Element;
+declare function AppShellHeader({ ref, className, withBorder, slotStyles: slotStylesRaw, ...props }: AppShellHeaderProps): React.JSX.Element | null;
+declare function AppShellNavbar({ ref, className, withBorder, slotStyles: slotStylesRaw, ...props }: AppShellNavbarProps): React.JSX.Element | null;
+declare function AppShellAside({ ref, className, withBorder, slotStyles: slotStylesRaw, ...props }: AppShellAsideProps): React.JSX.Element | null;
+declare function AppShellMain({ ref, className, slotStyles: slotStylesRaw, ...props }: AppShellMainProps): React.JSX.Element;
+declare function AppShellFooter({ ref, className, withBorder, slotStyles: slotStylesRaw, ...props }: AppShellFooterProps): React.JSX.Element | null;
 export declare const AppShell: typeof AppShellBase & {
     Header: typeof AppShellHeader;
     Navbar: typeof AppShellNavbar;
@@ -32,23 +13,4 @@ export declare const AppShell: typeof AppShellBase & {
     Aside: typeof AppShellAside;
     Footer: typeof AppShellFooter;
 };
-export interface AppShellHeaderProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
-    withBorder?: boolean;
-}
-declare function AppShellHeader({ ref, className, withBorder, ...props }: AppShellHeaderProps): React.JSX.Element | null;
-export interface AppShellNavbarProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
-    withBorder?: boolean;
-}
-declare function AppShellNavbar({ ref, className, withBorder, ...props }: AppShellNavbarProps): React.JSX.Element | null;
-export interface AppShellAsideProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
-    withBorder?: boolean;
-}
-declare function AppShellAside({ ref, className, withBorder, ...props }: AppShellAsideProps): React.JSX.Element | null;
-export interface AppShellMainProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
-}
-declare function AppShellMain({ ref, className, ...props }: AppShellMainProps): React.JSX.Element;
-export interface AppShellFooterProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
-    withBorder?: boolean;
-}
-declare function AppShellFooter({ ref, className, withBorder, ...props }: AppShellFooterProps): React.JSX.Element | null;
-export {};
+export type { AppShellAsideProps, AppShellFooterProps, AppShellHeaderProps, AppShellMainProps, AppShellNavbarProps, AppShellProps, } from "./app-shell.types";

package/dist/components/app-shell/app-shell.js

@@ -1,19 +1,14 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Box } from "@kala-ui/react/box";
+import { useSlotStyles } from "@kala-ui/react/kala-provider";
+import { applySlot } from "@kala-ui/react/lib/slot-styles";
 import { cn } from "@kala-ui/react/lib/utils";
 import * as React from "react";
+import { appShellStyles } from "../../config/app-shell.js";
 const AppShellContext = React.createContext({});
-function AppShellBase({ children, className, header, navbar, aside, footer, padding = "md", ref, ...props }) {
-    // Convert padding to Tailwind class or CSS value
-    const _paddingClasses = {
-        none: "p-0",
-        xs: "p-2",
-        sm: "p-3",
-        md: "p-4",
-        lg: "p-6",
-        xl: "p-8",
-    };
+function AppShellBase({ children, className, style, slotStyles: slotStylesRaw, header, navbar, aside, footer, padding = "md", ref, ...props }) {
+    const slotStyles = useSlotStyles("app-shell", slotStylesRaw);
     const cssVars = {
         "--app-shell-header-height": typeof header?.height === "number"
             ? `${header.height}px`
@@ -28,64 +23,68 @@ function AppShellBase({ children, className, header, navbar, aside, footer, padd
             ? `${aside.width}px`
             : (aside?.width ?? "0px"),
     };
-    return (_jsx(AppShellContext.Provider, { value: { header, navbar, aside, footer, padding }, children: _jsx(Box, { ref: ref, className: cn("flex min-h-screen flex-col bg-background text-foreground", className), style: cssVars, ...props, children: children }) }));
+    const root = applySlot(cn(appShellStyles.base, className), slotStyles?.root);
+    return (_jsx(AppShellContext.Provider, { "data-kala-component": "app-shell-base", value: { header, navbar, aside, footer, padding }, children: _jsx(Box, { "data-kala-component": "app-shell", ref: ref, className: root.className, style: { ...cssVars, ...root.style }, ...props, children: children }) }));
 }
-export const AppShell = Object.assign(AppShellBase, {
-    Header: AppShellHeader,
-    Navbar: AppShellNavbar,
-    Main: AppShellMain,
-    Aside: AppShellAside,
-    Footer: AppShellFooter,
-});
-function AppShellHeader({ ref, className, withBorder = true, ...props }) {
+// --- Subcomponents ---
+function AppShellHeader({ ref, className, withBorder = true, slotStyles: slotStylesRaw, ...props }) {
     const { header } = React.useContext(AppShellContext);
+    const slotStyles = useSlotStyles("app-shell", slotStylesRaw);
     if (!header)
         return null;
-    return (_jsx(Box, { as: "header", ref: ref, className: cn("fixed top-0 left-0 right-0 z-50 flex items-center bg-background px-4", withBorder && "border-b", className), style: { height: "var(--app-shell-header-height)" }, ...props }));
+    const part = applySlot(cn(appShellStyles.header, withBorder && appShellStyles.headerBorder, className), slotStyles?.header);
+    return (_jsx(Box, { "data-kala-component": "app-shell-header", as: "header", ref: ref, className: part.className, style: { height: "var(--app-shell-header-height)", ...part.style }, ...props }));
 }
-function AppShellNavbar({ ref, className, withBorder = true, ...props }) {
+function AppShellNavbar({ ref, className, withBorder = true, slotStyles: slotStylesRaw, ...props }) {
     const { navbar } = React.useContext(AppShellContext);
+    const slotStyles = useSlotStyles("app-shell", slotStylesRaw);
     if (!navbar)
         return null;
-    // Off-canvas below the configured breakpoint, docked from it upward.
     const variant = `${navbar.breakpoint ?? "md"}:`;
-    return (_jsx(Box, { as: "nav", ref: ref, className: cn("fixed left-0 z-40 flex flex-col bg-background transition-transform duration-300 ease-in-out", withBorder && "border-r", "-translate-x-full", `${variant}translate-x-0`, className), style: {
+    const part = applySlot(cn(appShellStyles.navbar, withBorder && appShellStyles.navbarBorder, "-translate-x-full", `${variant}translate-x-0`, className), slotStyles?.navbar);
+    return (_jsx(Box, { "data-kala-component": "app-shell-navbar", as: "nav", ref: ref, className: part.className, style: {
             width: "var(--app-shell-navbar-width)",
             top: "var(--app-shell-header-height)",
             height: "calc(100vh - var(--app-shell-header-height))",
+            ...part.style,
         }, ...props }));
 }
-function AppShellAside({ ref, className, withBorder = true, ...props }) {
+function AppShellAside({ ref, className, withBorder = true, slotStyles: slotStylesRaw, ...props }) {
     const { aside } = React.useContext(AppShellContext);
+    const slotStyles = useSlotStyles("app-shell", slotStylesRaw);
     if (!aside)
         return null;
     const variant = `${aside.breakpoint ?? "md"}:`;
-    return (_jsx(Box, { as: "aside", ref: ref, className: cn("fixed right-0 z-40 flex flex-col bg-background transition-transform duration-300 ease-in-out", withBorder && "border-l", "translate-x-full", `${variant}translate-x-0`, className), style: {
+    const part = applySlot(cn(appShellStyles.aside, withBorder && appShellStyles.asideBorder, "translate-x-full", `${variant}translate-x-0`, className), slotStyles?.aside);
+    return (_jsx(Box, { "data-kala-component": "app-shell-aside", as: "aside", ref: ref, className: part.className, style: {
             width: "var(--app-shell-aside-width)",
             top: "var(--app-shell-header-height)",
             height: "calc(100vh - var(--app-shell-header-height))",
+            ...part.style,
         }, ...props }));
 }
-function AppShellMain({ ref, className, ...props }) {
+function AppShellMain({ ref, className, slotStyles: slotStylesRaw, ...props }) {
     const { header, navbar, aside, footer, padding } = React.useContext(AppShellContext);
-    const paddingClasses = {
-        none: "p-0",
-        xs: "p-2",
-        sm: "p-3",
-        md: "p-4",
-        lg: "p-6",
-        xl: "p-8",
-    };
-    return (_jsx(Box, { as: "main", ref: ref, className: cn("flex-1 transition-all duration-300 ease-in-out", padding && paddingClasses[padding], header && "pt-[var(--app-shell-header-height)]", footer && "pb-[var(--app-shell-footer-height)]", 
-        // Side offsets only reserve space while the fixed panels are
-        // actually docked (breakpoint and up).
-        navbar &&
-            `${navbar.breakpoint ?? "md"}:pl-[var(--app-shell-navbar-width)]`, aside &&
-            `${aside.breakpoint ?? "md"}:pr-[var(--app-shell-aside-width)]`, className), ...props }));
+    const slotStyles = useSlotStyles("app-shell", slotStylesRaw);
+    const part = applySlot(cn(appShellStyles.main, padding && appShellStyles.padding[padding], header && "pt-[var(--app-shell-header-height)]", footer && "pb-[var(--app-shell-footer-height)]", 
+    // Side offsets only reserve space while the fixed panels are
+    // actually docked (breakpoint and up).
+    navbar &&
+        `${navbar.breakpoint ?? "md"}:pl-[var(--app-shell-navbar-width)]`, aside && `${aside.breakpoint ?? "md"}:pr-[var(--app-shell-aside-width)]`, className), slotStyles?.main);
+    return (_jsx(Box, { "data-kala-component": "app-shell-main", as: "main", ref: ref, className: part.className, style: part.style, ...props }));
 }
-function AppShellFooter({ ref, className, withBorder = true, ...props }) {
+function AppShellFooter({ ref, className, withBorder = true, slotStyles: slotStylesRaw, ...props }) {
     const { footer } = React.useContext(AppShellContext);
+    const slotStyles = useSlotStyles("app-shell", slotStylesRaw);
     if (!footer)
         return null;
-    return (_jsx(Box, { as: "footer", ref: ref, className: cn("fixed bottom-0 left-0 right-0 z-50 flex items-center bg-background px-4", withBorder && "border-t", className), style: { height: "var(--app-shell-footer-height)" }, ...props }));
+    const part = applySlot(cn(appShellStyles.footer, withBorder && appShellStyles.footerBorder, className), slotStyles?.footer);
+    return (_jsx(Box, { "data-kala-component": "app-shell-footer", as: "footer", ref: ref, className: part.className, style: { height: "var(--app-shell-footer-height)", ...part.style }, ...props }));
 }
+export const AppShell = Object.assign(AppShellBase, {
+    Header: AppShellHeader,
+    Navbar: AppShellNavbar,
+    Main: AppShellMain,
+    Aside: AppShellAside,
+    Footer: AppShellFooter,
+});

package/dist/components/app-shell/app-shell.types.d.ts

@@ -0,0 +1,45 @@
+import type { SlotStyles } from "@kala-ui/react/lib/slot-styles";
+import type * as React from "react";
+export interface AppShellProps extends React.ComponentProps<"div"> {
+    header?: {
+        height: number | string;
+    };
+    /**
+     * Navbar configuration. The navbar sits off-canvas below `breakpoint`
+     * and reserves Main's left padding from it upward.
+     */
+    navbar?: {
+        width: number | string;
+        breakpoint?: "sm" | "md" | "lg" | "xl";
+    };
+    /** Aside configuration. Mirrors the navbar on the right edge. */
+    aside?: {
+        width: number | string;
+        breakpoint?: "sm" | "md" | "lg" | "xl";
+    };
+    footer?: {
+        height: number | string;
+    };
+    padding?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
+    /** Per-part overrides: root, header, navbar, aside, main, footer. */
+    slotStyles?: SlotStyles;
+}
+export interface AppShellHeaderProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
+    withBorder?: boolean;
+    slotStyles?: SlotStyles;
+}
+export interface AppShellNavbarProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
+    withBorder?: boolean;
+    slotStyles?: SlotStyles;
+}
+export interface AppShellAsideProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
+    withBorder?: boolean;
+    slotStyles?: SlotStyles;
+}
+export interface AppShellMainProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
+    slotStyles?: SlotStyles;
+}
+export interface AppShellFooterProps extends React.HTMLAttributes<HTMLElement>, React.RefAttributes<HTMLElement> {
+    withBorder?: boolean;
+    slotStyles?: SlotStyles;
+}

package/dist/components/app-shell/app-shell.types.js

@@ -0,0 +1,2 @@
+"use client";
+export {};

package/dist/components/app-shell/index.d.ts

@@ -1 +1,2 @@
 export * from "./app-shell";
+export type { AppShellAsideProps, AppShellFooterProps, AppShellHeaderProps, AppShellMainProps, AppShellNavbarProps, AppShellProps, } from "./app-shell.types";

package/dist/components/charts/area-chart.d.ts

@@ -3,4 +3,4 @@
  * Beautiful area charts with gradient fills, perfect for time series and trends
  */
 import type { AreaChartProps } from "./chart.types";
-export declare function AreaChart({ series, categories, colors, height, width, className, title, subtitle, toolbar, animations, curve, stacked, dataLabels, yAxisLabel, referenceLines, isLoading, emptyMessage, options: customOptions, }: AreaChartProps): import("react").JSX.Element;
+export declare function AreaChart({ series, categories, colors, height, width, className, title, subtitle, toolbar, animations, curve, stacked, dataLabels, yAxisLabel, referenceLines, slotStyles, isLoading, emptyMessage, options: customOptions, }: AreaChartProps): import("react").JSX.Element;

package/dist/components/charts/area-chart.js

@@ -7,9 +7,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "@kala-ui/react/lib/utils";
 import { useMemo } from "react";
+import { chartStyles } from "../../config/charts.js";
 import { Chart, getTooltipTheme } from "./chart.js";
 import { useThemeAwareChart } from "./use-theme-aware-chart.js";
-import { getDefaultChartOptions } from "./utils.js";
+import { getDefaultChartOptions } from "./chart-utils.js";
 /**
  * Check if series data is empty (no series or all series have empty data arrays)
  */
@@ -18,7 +19,7 @@ function isSeriesEmpty(series) {
         return true;
     return series.every((s) => !s.data || (Array.isArray(s.data) && s.data.length === 0));
 }
-export function AreaChart({ series, categories, colors, height = 350, width = "100%", className, title, subtitle, toolbar = false, animations = true, curve = "smooth", stacked = false, dataLabels = false, yAxisLabel, referenceLines = [], isLoading, emptyMessage, options: customOptions, }) {
+export function AreaChart({ series, categories, colors, height = 350, width = "100%", className, title, subtitle, toolbar = false, animations = true, curve = "smooth", stacked = false, dataLabels = false, yAxisLabel, referenceLines = [], slotStyles, isLoading, emptyMessage, options: customOptions, }) {
     const { colors: themeColors } = useThemeAwareChart();
     const isEmpty = !isLoading && isSeriesEmpty(series);
     const chartOptions = useMemo(() => {
@@ -168,5 +169,5 @@ export function AreaChart({ series, categories, colors, height = 350, width = "1
         referenceLines,
         customOptions,
     ]);
-    return (_jsx(Chart, { className: cn("w-full", className), options: chartOptions, series: series, type: "area", height: height, width: width, isLoading: isLoading, isEmpty: isEmpty, emptyMessage: emptyMessage }));
+    return (_jsx(Chart, { "data-kala-component": "charts-area-chart", className: cn(chartStyles.root, className), slotStyles: slotStyles, options: chartOptions, series: series, type: "area", height: height, width: width, isLoading: isLoading, isEmpty: isEmpty, emptyMessage: emptyMessage }));
 }

package/dist/components/charts/bar-chart.d.ts

@@ -3,4 +3,4 @@
  * Vertical and horizontal bar charts for comparing values across categories
  */
 import type { BarChartProps } from "./chart.types";
-export declare function BarChart({ series, categories, colors, height, width, className, title, subtitle, toolbar, animations, horizontal, stacked, dataLabels, barWidth, isLoading, emptyMessage, options: customOptions, }: BarChartProps): import("react").JSX.Element;
+export declare function BarChart({ series, categories, colors, height, width, className, title, subtitle, toolbar, animations, horizontal, stacked, dataLabels, barWidth, slotStyles, isLoading, emptyMessage, options: customOptions, }: BarChartProps): import("react").JSX.Element;

package/dist/components/charts/bar-chart.js

@@ -7,9 +7,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { cn } from "@kala-ui/react/lib/utils";
 import { useMemo } from "react";
+import { chartStyles } from "../../config/charts.js";
 import { Chart, getTooltipTheme } from "./chart.js";
 import { useThemeAwareChart } from "./use-theme-aware-chart.js";
-import { getDefaultChartOptions } from "./utils.js";
+import { getDefaultChartOptions } from "./chart-utils.js";
 /**
  * Check if series data is empty (no series or all series have empty data arrays)
  */
@@ -18,7 +19,7 @@ function isSeriesEmpty(series) {
         return true;
     return series.every((s) => !s.data || (Array.isArray(s.data) && s.data.length === 0));
 }
-export function BarChart({ series, categories, colors, height = 350, width = "100%", className, title, subtitle, toolbar = false, animations = true, horizontal = false, stacked = false, dataLabels = false, barWidth = 70, isLoading, emptyMessage, options: customOptions, }) {
+export function BarChart({ series, categories, colors, height = 350, width = "100%", className, title, subtitle, toolbar = false, animations = true, horizontal = false, stacked = false, dataLabels = false, barWidth = 70, slotStyles, isLoading, emptyMessage, options: customOptions, }) {
     const { colors: themeColors } = useThemeAwareChart();
     const isEmpty = !isLoading && isSeriesEmpty(series);
     const chartOptions = useMemo(() => {
@@ -149,5 +150,5 @@ export function BarChart({ series, categories, colors, height = 350, width = "10
         subtitle,
         customOptions,
     ]);
-    return (_jsx(Chart, { className: cn("w-full", className), options: chartOptions, series: series, type: "bar", height: height, width: width, isLoading: isLoading, isEmpty: isEmpty, emptyMessage: emptyMessage }));
+    return (_jsx(Chart, { "data-kala-component": "charts-bar-chart", className: cn(chartStyles.root, className), slotStyles: slotStyles, options: chartOptions, series: series, type: "bar", height: height, width: width, isLoading: isLoading, isEmpty: isEmpty, emptyMessage: emptyMessage }));
 }

package/dist/components/charts/chart-skeleton.d.ts

@@ -4,33 +4,12 @@
  * including chart area, legend, and optional table below
  */
 export interface ChartSkeletonProps {
-    /**
-     * Height of the chart area (default: 350)
-     */
     height?: number;
-    /**
-     * Show legend skeleton (default: true)
-     */
     showLegend?: boolean;
-    /**
-     * Number of legend items to show (default: 4)
-     */
     legendCount?: number;
-    /**
-     * Show table skeleton below chart
-     */
     showTable?: boolean;
-    /**
-     * Number of table rows to show (default: 5)
-     */
     tableRows?: number;
-    /**
-     * Number of table columns to show (default: 3)
-     */
     tableColumns?: number;
-    /**
-     * Custom CSS class
-     */
     className?: string;
 }
 export declare function ChartSkeleton({ height, showLegend, legendCount, showTable, tableRows, tableColumns, className, }: ChartSkeletonProps): import("react").JSX.Element;

package/dist/components/charts/chart-skeleton.js

@@ -8,6 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cn } from "@kala-ui/react/lib/utils";
 import { Skeleton } from "@kala-ui/react/skeleton";
 import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from "@kala-ui/react/table";
+import { chartSkeletonStyles } from "../../config/charts.js";
 export function ChartSkeleton({ height = 350, showLegend = true, legendCount = 4, showTable = false, tableRows = 5, tableColumns = 3, className, }) {
-    return (_jsxs("div", { className: cn("w-full space-y-4", className), children: [_jsx("div", { className: "w-full rounded-lg border bg-card kala-surface-card", style: { height: `${height}px` }, children: _jsx("div", { className: "flex items-center justify-center h-full", children: _jsx(Skeleton, { className: "h-full w-full" }) }) }), showLegend && (_jsx("div", { className: "flex gap-4 justify-center mt-4", children: Array.from({ length: legendCount }).map((_, i) => (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Skeleton, { className: "h-3 w-3 rounded-full" }), _jsx(Skeleton, { className: "h-4 w-16" })] }, `legend-${i}`))) })), showTable && (_jsx("div", { className: "mt-6", children: _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsx(TableRow, { children: Array.from({ length: tableColumns }).map((_, index) => (_jsx(TableHead, { children: _jsx(Skeleton, { className: "h-4 w-24" }) }, `header-${index}`))) }) }), _jsx(TableBody, { children: Array.from({ length: tableRows }).map((_, rowIndex) => (_jsx(TableRow, { className: "border-0", children: Array.from({ length: tableColumns }).map((_, colIndex) => (_jsx(TableCell, { children: _jsx(Skeleton, { className: "h-4 w-20" }) }, `cell-${rowIndex}-${colIndex}`))) }, `row-${rowIndex}`))) })] }) }))] }));
+    return (_jsxs("div", { "data-kala-component": "charts-chart-skeleton", className: cn(chartSkeletonStyles.root, className), children: [_jsx("div", { className: chartSkeletonStyles.frame, style: { height: `${height}px` }, children: _jsx("div", { className: chartSkeletonStyles.frameInner, children: _jsx(Skeleton, { className: chartSkeletonStyles.frameFill }) }) }), showLegend && (_jsx("div", { className: chartSkeletonStyles.legendRow, children: Array.from({ length: legendCount }).map((_, i) => (_jsxs("div", { className: chartSkeletonStyles.legendItem, children: [_jsx(Skeleton, { className: chartSkeletonStyles.legendDot }), _jsx(Skeleton, { className: chartSkeletonStyles.legendLabel })] }, `legend-${i}`))) })), showTable && (_jsx("div", { className: chartSkeletonStyles.tableWrap, children: _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsx(TableRow, { children: Array.from({ length: tableColumns }).map((_, index) => (_jsx(TableHead, { children: _jsx(Skeleton, { className: chartSkeletonStyles.tableHead }) }, `header-${index}`))) }) }), _jsx(TableBody, { children: Array.from({ length: tableRows }).map((_, rowIndex) => (_jsx(TableRow, { className: chartSkeletonStyles.tableRow, children: Array.from({ length: tableColumns }).map((_, colIndex) => (_jsx(TableCell, { children: _jsx(Skeleton, { className: chartSkeletonStyles.tableCell }) }, `cell-${rowIndex}-${colIndex}`))) }, `row-${rowIndex}`))) })] }) }))] }));
 }

package/dist/components/charts/chart-utils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Chart Utilities
+ * Helper functions and default configurations for charts
+ */
+import type { ApexOptions } from "apexcharts";
+/**
+ * Get default chart options that match our design system
+ * @param theme - Optional theme override, otherwise detects from DOM
+ */
+export declare function getDefaultChartOptions(theme?: "light" | "dark" | "neutral" | "accent"): ApexOptions;
+/**
+ * Default color palette matching design tokens
+ * @param theme - Optional theme override, otherwise detects from DOM
+ * @deprecated Use getChartColors() instead for theme-aware colors
+ */
+export declare function defaultColors(theme?: "light" | "dark" | "neutral" | "accent"): {
+    primary: import("./theme-utils").ColorPalette;
+    success: import("./theme-utils").ColorPalette;
+    warning: import("./theme-utils").ColorPalette;
+    destructive: import("./theme-utils").ColorPalette;
+    info: import("./theme-utils").ColorPalette;
+    mixed: import("./theme-utils").ColorPalette;
+};
+/**
+ * Format number with appropriate units
+ */
+export declare function formatNumber(value: number): string;
+/**
+ * Format currency values
+ */
+export declare function formatCurrency(value: number, currency?: string): string;
+/**
+ * Format percentage values
+ */
+export declare function formatPercentage(value: number, decimals?: number): string;
+/**
+ * Generate gradient colors for area charts
+ */
+export declare function createGradient(_color: string, opacity?: number): {
+    type: "gradient";
+    gradient: {
+        shadeIntensity: number;
+        opacityFrom: number;
+        opacityTo: number;
+        stops: number[];
+    };
+};
+/**
+ * Get responsive breakpoints for charts
+ */
+export declare function getResponsiveOptions(): ApexResponsive[];
+interface ApexResponsive {
+    breakpoint: number;
+    options: ApexOptions;
+}
+export {};