@cascivo/charts 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -2004,12 +2004,18 @@ interface SparklineBaseProps {
    * 120px rather than a container-filling chart. Pass a number to change it. The
    * catalogue-wide "omit for a responsive chart" note does not apply to this chart.
    *
-   * @defaultValue `80`
+   * @defaultValue `120`
    * @see the component manifest
    */
   width?: number;
   height?: number;
   color?: string;
+  /**
+   * Show dot at last data point
+   *
+   * @defaultValue `true`
+   * @see the component manifest
+   */
   endDot?: boolean;
 }
 /**
@@ -2118,6 +2124,23 @@ interface KpiProps {
   sparkline?: readonly number[];
   className?: string;
 }
+/**
+ * A metric tile with its own card chrome: label, then value and delta on one line, then an
+ * optional sparkline below.
+ *
+ * ## `Kpi` or `Stat`? Pick one per app.
+ *
+ * `Stat` (`@cascivo/react`) is the sibling tile, and they are **not two skins of one
+ * component**. `Kpi` takes a numeric `delta` and formats it for you (sign, arrow, colour,
+ * unit) and always brings card chrome. `Stat` takes a pre-formatted `string` delta, stacks
+ * value → delta → help text, puts its `visual` in a trailing slot, and is layout-only unless
+ * you set `card`.
+ *
+ * `<Stat card>` matches this component's **chrome** — surface, border, radius, padding — and
+ * not its layout, so a `Stat` row and a `Kpi` row in one app still read as two tile designs
+ * (2026-08-14 report §6). Use `Kpi` when you have a numeric delta and a sparkline; use `Stat`
+ * otherwise; do not mix them.
+ */
 declare function Kpi({
   value,
   label,
@@ -2299,7 +2322,12 @@ interface ComboChartProps {
   line: ComboChartPoint[];
   title: string;
   description?: string;
-  /** Measure the line on its own right-hand axis (use when the two metrics differ in scale). */
+  /**
+   * Render line on a secondary right y-axis
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
   secondAxis?: boolean;
   /** Legend label for the bar series. Defaults to `'Bars'`. */
   barsLabel?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascivo/charts",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "private": false,
   "description": "Chart components built from scratch — scales, shapes, and signal-driven rendering, zero dependencies. Colors come from @cascivo/themes; components from @cascivo/react. Docs offline: npx @cascivo/docs",
   "keywords": [
@@ -45,8 +45,8 @@
     "provenance": true
   },
   "dependencies": {
-    "@cascivo/core": "^0.17.0",
-    "@cascivo/i18n": "^0.17.0"
+    "@cascivo/core": "^0.18.0",
+    "@cascivo/i18n": "^0.18.0"
   },
   "devDependencies": {
     "@preact/signals": "^2",