@siyahi/ui 0.1.8-next.4 → 0.1.9-next.2

package/dist/lib/chart-series.d.ts

@@ -1,7 +1,10 @@
 import { ReactNode } from "react";
 //#region src/lib/chart-series.d.ts
-/** The colours a series may take: the five chart slots, and muted for an "Other" past five. */
-export type ChartColor = "var(--chart-1)" | "var(--chart-2)" | "var(--chart-3)" | "var(--chart-4)" | "var(--chart-5)" | "var(--muted-foreground)";
+/**
+ * The colours a series may take: the five chart slots, muted for an "Other" past five, and the two meaning
+ * colours for a gain and a loss.
+ */
+export type ChartColor = "var(--chart-1)" | "var(--chart-2)" | "var(--chart-3)" | "var(--chart-4)" | "var(--chart-5)" | "var(--muted-foreground)" | "var(--positive)" | "var(--negative)";
 /** The fields of a row that hold numbers: the ones a series can plot. */
 type NumericKey<T> = { [K in keyof T]-?: T[K] extends number | null | undefined ? K : never; }[keyof T] & string;
 /** One series: the field it plots, its name in the legend and tooltip, and its colour. */
@@ -9,6 +12,8 @@ export interface ChartSeriesItem<T> {
   key: NumericKey<T>;
   label: string;
   color: ChartColor;
+  /** A bar below zero takes this colour instead, such as var(--negative) for a loss beside var(--positive). */
+  negativeColor?: ChartColor;
 }
 /**
  * The series in draw, stack and legend order; give the slots in order from
@@ -16,6 +21,23 @@ export interface ChartSeriesItem<T> {
  * number-like keys such as "2024" first whatever order the page wrote them in.
  */
 export type ChartSeries<T> = readonly ChartSeriesItem<T>[];
+/**
+ * A labelled line across the plot: a level on the value axis (y), such as a limit, or a point on the x axis, such
+ * as an event. A level is dashed, an event solid.
+ */
+export type ChartReferenceLine = ({
+  y: number;
+  x?: never;
+} | {
+  x: number | string;
+  y?: never;
+}) & {
+  label?: string;
+  /** "strong" draws it in the text colour, for the line that matters most; "muted" by default. */
+  emphasis?: "muted" | "strong";
+  /** Where the label sits against the line. Defaults to insideTopLeft. */
+  labelPosition?: "insideTopLeft" | "insideTopRight" | "insideBottomLeft" | "insideBottomRight";
+};
 /** What BarChartCard, AreaChartCard and LineChartCard all take. */
 export interface SeriesChartProps<T extends object, K extends keyof T> {
   title: ReactNode;
@@ -27,14 +49,44 @@ export interface SeriesChartProps<T extends object, K extends keyof T> {
   /** The field the x axis reads: a month, an hour of day, a price bucket. One row per value; a repeated value is hidden behind the first. */
   xKey: K;
   series: ChartSeries<NoInfer<T>>;
-  /** The x axis ticks and the tooltip's heading. Defaults to the value as text. */
+  /** The x axis ticks, and the tooltip's heading unless xTooltipFormatter is set. Defaults to the value as text. */
   xFormatter?: (value: T[K]) => string;
+  /** The tooltip's heading, when it should say more than a tick: "19:34:13 IST, 10 s average" against "19:34". */
+  xTooltipFormatter?: (value: T[K]) => string;
   /** A series' value in the tooltip, and the y axis unless yTickFormatter is set. Defaults to the locale's numbers. */
   valueFormatter?: (value: number) => string;
   /** The y axis, when its ticks should be shorter than the tooltip's figures: moneyCompact against money. */
   yTickFormatter?: (value: number) => string;
+  /** A fixed range for the value axis, such as [0, 100] for a percentage; by default it fits the data. */
+  yDomain?: [number, number];
+  /** Where the value axis puts its ticks, such as [0, 25, 50, 75, 100]. */
+  yTicks?: readonly number[];
   /** Height of the plot and legend, in pixels. */
   height: number;
+  /** A second line under each x tick, so a row's figure reads without a hover: "FY24" then "▲₹1.2L". */
+  xTickDetail?: (row: T) => string;
+  /** A title under the x axis, such as "Hour of day (IST)". Not drawn on sideways bars. */
+  xLabel?: string;
+  /** A title beside the value axis, read bottom to top, such as "Orders". Not drawn on sideways bars. */
+  yLabel?: string;
+  /** Limits and events to mark on the plot. A zero line draws by itself when a value goes below zero. */
+  referenceLines?: readonly ChartReferenceLine[];
+  /** Shown in the plot's place, at its height, while the data loads or after it failed to. */
+  placeholder?: ReactNode;
+  /** Lines under the chart, such as a caption or a takeaway, in the card's footer. */
+  footer?: ReactNode;
 }
+/** A numeric x axis, for samples in time or any measure where a mark can sit between two rows. */
+export interface NumericXProps {
+  /** The x axis runs over this range of the xKey field, which must hold numbers; without it the axis is one slot per row. */
+  xDomain?: [number, number];
+  /** Where the x axis puts its ticks, in the xKey field's units. */
+  xTicks?: readonly number[];
+}
+/**
+ * How a line or an area's edge joins its points: "linear" draws straight segments, as measured samples should
+ * be drawn; "monotone", the default, smooths between them without overshooting a point.
+ */
+export type ChartCurve = "monotone" | "linear";
 //#endregion
 export {};

package/dist/lib/format.d.ts

@@ -9,6 +9,8 @@ export declare function money(value: number, locale?: SiyahiLocale, fractionDigi
  * `Delta`, which adds the arrow.
  */
 export declare function moneyCompact(value: number, locale?: SiyahiLocale): string;
+/** A whole count with the locale's grouping: 1,53,110 in en-IN. */
+export declare function count(value: number, locale?: SiyahiLocale): string;
 /** A fraction as a percentage: 0.1234 is 12.3%. */
 export declare function pct(value: number, locale?: SiyahiLocale, fractionDigits?: number): string;
 export interface TimeOptions {
@@ -18,6 +20,7 @@ export interface TimeOptions {
 /** A 24-hour time in the locale's zone, with the zone written: 14:30 IST. */
 export declare function time(value: Date | number | string, locale?: SiyahiLocale, { withDate }?: TimeOptions): string;
 export interface Formatters {
+  count: (value: number) => string;
   money: (value: number, fractionDigits?: number) => string;
   moneyCompact: (value: number) => string;
   pct: (value: number, fractionDigits?: number) => string;

package/dist/lib/format.js

@@ -26,6 +26,10 @@ function moneyCompact(value, locale = defaultLocale) {
 		maximumFractionDigits: 1
 	}).format(value);
 }
+/** A whole count with the locale's grouping: 1,53,110 in en-IN. */
+function count(value, locale = defaultLocale) {
+	return new Intl.NumberFormat(locale.numberLocale, { maximumFractionDigits: 0 }).format(value);
+}
 /** A fraction as a percentage: 0.1234 is 12.3%. */
 function pct(value, locale = defaultLocale, fractionDigits = 1) {
 	return new Intl.NumberFormat(locale.numberLocale, {
@@ -54,6 +58,7 @@ function time(value, locale = defaultLocale, { withDate = false } = {}) {
 function useFormat() {
 	const locale = useLocale();
 	return useMemo(() => ({
+		count: (value) => count(value, locale),
 		money: (value, fractionDigits) => money(value, locale, fractionDigits),
 		moneyCompact: (value) => moneyCompact(value, locale),
 		pct: (value, fractionDigits) => pct(value, locale, fractionDigits),
@@ -61,4 +66,4 @@ function useFormat() {
 	}), [locale]);
 }
 //#endregion
-export { money, moneyCompact, pct, time, useFormat };
+export { count, money, moneyCompact, pct, time, useFormat };

package/dist/lib/treemap.d.ts

@@ -18,6 +18,10 @@ export declare function layout<T extends {
   weight: number;
   group?: string;
 }>(items: T[], width: number, height: number): Layout<T>;
+export declare const HEAT_STEPS = 5;
+/** The range the heat scale uses: one that is not a positive number falls back to ±5%. */
+export declare const heatRange: (range?: number) => number;
+export declare const heatFill: (side: "positive" | "negative", step: number) => string;
 export declare function heat(change: number | null, range?: number): string;
 //#endregion
 export {};

package/dist/lib/treemap.js

@@ -31,10 +31,15 @@ function layout(items, width, height) {
 		}])
 	};
 }
-function heat(change, range = .05) {
+const DEFAULT_RANGE = .05;
+const HEAT_STEPS = 5;
+/** The range the heat scale uses: one that is not a positive number falls back to ±5%. */
+const heatRange = (range = DEFAULT_RANGE) => Number.isFinite(range) && range > 0 ? range : DEFAULT_RANGE;
+const heatFill = (side, step) => `color-mix(in oklab, var(--${side}) ${step * 12}%, var(--card))`;
+function heat(change, range) {
 	if (!change) return "var(--muted)";
-	const mix = Math.min(5, Math.ceil(Math.abs(change) / (Number.isFinite(range) && range > 0 ? range : .05) * 5)) * 12;
-	return `color-mix(in oklab, var(${change > 0 ? "--positive" : "--negative"}) ${mix}%, var(--card))`;
+	const step = Math.min(5, Math.ceil(Math.abs(change) / heatRange(range) * 5));
+	return heatFill(change > 0 ? "positive" : "negative", step);
 }
 //#endregion
-export { heat, layout };
+export { HEAT_STEPS, heat, heatFill, heatRange, layout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siyahi/ui",
-  "version": "0.1.8-next.4",
+  "version": "0.1.9-next.2",
   "description": "Stock shadcn/ui on Base UI and Tailwind v4, a finance theme, a few compositions and formatters.",
   "keywords": [
     "base-ui",

package/registry.lock.json

@@ -41,6 +41,14 @@
       "copied": "2026-10-20",
       "sha256": "bc19cf1f5e486fa11273e7d7ed620eb7b82ba360f72e5a15e6bf488f992d16ce"
     },
+    {
+      "file": "src/components/registry/dashboardcn/distribution-bar.tsx",
+      "registry": "@dashboardcn/distribution-bar",
+      "origin": "https://dashboardcn.com/r/distribution-bar.json",
+      "licence": "MIT, Copyright (c) 2026 dashboardcn contributors, https://github.com/NoahGdev/dashboardcn/blob/main/LICENSE",
+      "copied": "2026-10-22",
+      "sha256": "9028368f1363732cef765dabad2eca3ba98b608f1e237123b09df701c41c8b5a"
+    },
     {
       "file": "src/components/registry/heatmap/calendar-heatmap.tsx",
       "registry": "@heatmap/calendar-heatmap",
@@ -65,6 +73,14 @@
       "copied": "2026-10-20",
       "sha256": "b7af6139e3764e1479880fb232988e758edb27ce4e4280d9e0349cbdf9b3d30c"
     },
+    {
+      "file": "src/components/registry/minidev/copy-button.tsx",
+      "registry": "@minidev/copy-button",
+      "origin": "https://ui.minidev.pro/r/copy-button.json",
+      "licence": "MIT, Copyright (c) 2026 MiniDev, https://github.com/amankaushik481/minidev-ui/blob/main/LICENSE",
+      "copied": "2026-10-22",
+      "sha256": "67f491ea6c947ebf3bf058423a373347badd49ad07861e022599ebdbb11cab44"
+    },
     {
       "file": "src/components/registry/niko-table/components/data-table-column-actions.tsx",
       "registry": "@niko-table/data-table",
@@ -153,6 +169,14 @@
       "copied": "2026-10-20",
       "sha256": "8b0c9768a5f1b90d7b4e2bf467a32ca86a43d5d546653f3a64d7abea277aa68b"
     },
+    {
+      "file": "src/components/registry/niko-table/components/data-table-search-filter.tsx",
+      "registry": "@niko-table/data-table-search-filter",
+      "origin": "https://niko-table.com/r/data-table-search-filter.json",
+      "licence": "MIT, Copyright (c) 2025 Semir N., original work (c) 2025 WebDevSimplified, https://github.com/Semkoo/niko-table-registry/blob/main/LICENSE",
+      "copied": "2026-10-22",
+      "sha256": "5aeb91ef34ff0dd87a92f1ad7ebd4500e8733b8ae30ecf836eae78304a10fad0"
+    },
     {
       "file": "src/components/registry/niko-table/components/data-table-toolbar-section.tsx",
       "registry": "@niko-table/data-table",
@@ -257,6 +281,14 @@
       "copied": "2026-10-20",
       "sha256": "dba551593726fa342b8c61daf5e5b9c79125df391af8ed31504e7dfedf7a71ba"
     },
+    {
+      "file": "src/components/registry/niko-table/filters/table-search-filter.tsx",
+      "registry": "@niko-table/data-table-search-filter",
+      "origin": "https://niko-table.com/r/data-table-search-filter.json",
+      "licence": "MIT, Copyright (c) 2025 Semir N., original work (c) 2025 WebDevSimplified, https://github.com/Semkoo/niko-table-registry/blob/main/LICENSE",
+      "copied": "2026-10-22",
+      "sha256": "c672763c02894a579f6cc7cddbe5fc17149b1eef484f992b9a35441b4e3b1c42"
+    },
     {
       "file": "src/components/registry/niko-table/hooks/use-derived-column-title.ts",
       "registry": "@niko-table/data-table",