@lilt-ui/charts 0.13.0 → 0.13.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.13.1
+
+- `PriceChartCard` now honors `formatValue` for prices. Instrument comparisons continue to use signed percentages.
+- Documentation examples preserve every preview row and timestamp, including period choices and the home page's selected chart. Copyable files include the client directive.
+- Completed card prop tables, corrected defaults and feature claims, and expanded the npm README and agent references to include the current chart families and companion forms.
+
 ## 0.13.0
 
 Twenty-three new chart families drawn in depth, fourteen new forms for existing charts, and Watch is removed.

package/README.md

@@ -76,7 +76,7 @@ export function VisitorsCard() {
 }
 ```
 
-That's the whole card: the headline, the change chip, value tiles, and hover all come from your rows. `x` and each series `key` are checked against your data, so a typo is a type error, not a blank chart.
+The headline, value tiles, and hover come from your rows. Supply `delta` when you want a change chip, for example `delta={0.082}` for +8.2%. `x` and each series `key` are checked against your data, so a typo is a type error, not a blank chart.
 
 ## Every card, finished
 
@@ -85,16 +85,21 @@ That's the whole card: the headline, the change chip, value tiles, and hover all
   <img alt="Stat cards with sparklines, bars, and a goal meter above a needle bar chart and a retention heatmap" src="https://cdn.jsdelivr.net/npm/@lilt-ui/charts/media/cards-dark.webp" />
 </picture>
 
-| For                  | Cards                                                                   |
-| -------------------- | ----------------------------------------------------------------------- |
-| **Trends**           | Area, Line, Bar, and Combo cards, overlapping, stacked, or as shares    |
-| **At a glance**      | Stat cards with a sparkline, bars, a meter, or a ring                   |
-| **Parts and goals**  | Radial, Treemap, Progress, and Activity ring                            |
-| **Rankings**         | Horizontal bar, with shares and an "Other" row                          |
-| **Flows and change** | Funnel, Sankey, and Slope                                               |
-| **Patterns**         | Heatmap (matrix and calendar), Scatter (points, strip, beeswarm), Radar |
-| **Spread**           | Range (floating bars, error bars, timeline intervals) and Box plot      |
-| **Markets**          | Candlestick, Indicators, Price, Depth, Order book, and Portfolio        |
+| For                  | Cards                                                                                           |
+| -------------------- | ----------------------------------------------------------------------------------------------- |
+| **Trends**           | Area, Line, Bar, and Combo cards, overlapping, stacked, or as shares                            |
+| **At a glance**      | Stat cards with a sparkline, bars, a meter, or a ring                                           |
+| **Parts and goals**  | Radial, Treemap, Progress, and Activity ring                                                    |
+| **Rankings**         | Horizontal bar, with shares and an "Other" row                                                  |
+| **Flows and change** | Funnel, Sankey, and Slope                                                                       |
+| **Patterns**         | Heatmap (matrix and calendar), Scatter (points, strip, beeswarm), Radar                         |
+| **Spread**           | Range (floating bars, error bars, timeline intervals) and Box plot                              |
+| **Markets**          | Candlestick, Indicators, Price, Depth, Order book, and Portfolio                                |
+| **Cool**             | 23 spatial families, from Skyline and Terrain to Chord loom, Sunburst terraces, and Voxel cloud |
+
+### Charts drawn in depth
+
+[Explore the Cool families](https://liltui.vercel.app/charts/skyline): Skyline, Block city, Hex city, Voxel waffle, Terrain, Ridgeline, Spiral year, Event helix, Chord loom, Arc bridges, Rank ribbons, Parallel ribbons, Contour islands, Sunburst terraces, Cluster constellation, Ternary prism, Wind rose, Marimekko blocks, Intersection towers, Horizon folds, Circle archipelago, Helix ribbons, and Voxel cloud. Each is its own card with its own data contract.
 
 ### Companion cards
 
@@ -102,6 +107,8 @@ That's the whole card: the headline, the change chip, value tiles, and hover all
 
 They take the same `depth`, loading, empty, and header props as every other card, plus `onSelectionChange` and `renderReadout` for your own presentation. Treemap areas must be nonnegative, calendar dates are UTC, and timeline durations are measured in milliseconds (displayed as hours by default).
 
+Existing family pages also cover `StreamgraphCard`, `DivergingBarCard`, `MirroredBarCard`, `NestedDonutCard`, `ComparativeFunnelCard`, `GoalPacingCard`, `MilestoneProgressCard`, `ViolinCard`, and `CorrelationMatrixCard`. Line supports indexed growth; Line and unstacked Area accept supplied forecast bands; Horizontal Bar supports lollipops; Scatter supports ordered trails; and Treemap supports group drill-down.
+
 ## Finance charts
 
 Candlesticks, indicators, and order books ship from their own entry point, so apps that never draw a candle never load one:
@@ -160,9 +167,9 @@ Candles draw into a handful of paths however many there are, so years of daily h
 
 ## Built in, one prop away
 
-- **Linked hover.** Give cards the same `sync` name and they read the same moment together.
-- **Targets and forecasts.** `target` draws a goal line and counts the points that reach it. `forecast` marks projected rows and keeps them out of the headline.
-- **Pin and compare.** Click any mark to pin it; press anywhere off the marks, or Escape, to let go. Add `compare` and drag across a chart to see what changed, in the headline or, with `compare="badge"`, in the card's tab.
+- **Linked hover.** Cards with `sync`, including Area, Line, Bar, Combo, and Stat, read the same moment together. Stat also needs `x`.
+- **Targets and forecasts.** On Area, Line, Bar, and Combo cards, `target` draws a goal line and counts the points that reach it. `forecast` marks supplied projected rows and keeps them out of the headline. Lilt does not estimate forecasts.
+- **Pin and compare.** On cards with inspection, click a mark to pin it; press off the marks, or Escape, to let go. Cards with `compare` let you drag across the plot to see what changed, in the headline or, with `compare="badge"`, in the card's tab. Check the family's props for availability.
 - **Honest data.** `null` is a gap, never a zero, and missing values say so.
 - **Loading and empty.** `loading` shows a skeleton that `"shimmer"`s, `"draw"`s, or `"breathe"`s in the chart's own shape, then hands over to the data. A period with no rows shows a still empty state, or your own with `empty`, and the headline reads a dash, never zero.
 - **Long series.** Line and area cards draw tens of thousands of points from four per pixel column; hover, tiles, and exports still read every row.

package/dist/cards/cartesian-card.d.ts

@@ -116,7 +116,7 @@ export interface CartesianCardProps<Row, Key extends NumericKey<Row>> {
     /**
      * Draw a long line or area from each pixel column's first, last, lowest and highest
      * observation, so tens of thousands of points stay fast to hover. The ink is the same, and the
-     * headline, tiles, hover, Watch and exports still read every row. Defaults to true.
+     * headline, tiles, hover and exports still read every row. Defaults to true.
      */
     decimate?: boolean;
     /** Card treatment: `elevated` (default), `outline`, or `ghost` inside your own card. */

package/dist/finance.js

@@ -1107,7 +1107,7 @@ function Pe({ price: e, symbol: t, name: n, icon: r, display: i = "area", versus
 			style: "percent",
 			maximumFractionDigits: 1
 		} : u,
-		formatValue: m ? (e) => h(S)(e) : void 0,
+		formatValue: m ? (e) => h(S)(e) : p.formatValue,
 		locale: d,
 		aggregate: "last",
 		headlineSeries: C(e),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lilt-ui/charts",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Beautiful, key-typed React chart cards with linked hover, targets, forecasts, finance charts, and calm motion.",
   "keywords": [
     "react",
@@ -54,15 +54,6 @@
   "sideEffects": [
     "./dist/styles.css"
   ],
-  "scripts": {
-    "build": "vite build",
-    "prepublishOnly": "pnpm build",
-    "typecheck": "tsc --noEmit && pnpm build && pnpm run typecheck:consumer",
-    "typecheck:consumer": "tsc --noEmit --strict --target ES2022 --module ESNext --moduleResolution Bundler --skipLibCheck consumer/typecheck.ts",
-    "lint": "eslint src",
-    "test": "pnpm build && vitest run",
-    "format:check": "prettier --check src vite.config.ts tsconfig.json"
-  },
   "dependencies": {
     "@number-flow/react": "^0.6.2",
     "d3-array": "^3.2.4",
@@ -76,5 +67,13 @@
   "peerDependencies": {
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit && pnpm build && pnpm run typecheck:consumer",
+    "typecheck:consumer": "tsc --noEmit --strict --target ES2022 --module ESNext --moduleResolution Bundler --skipLibCheck consumer/typecheck.ts",
+    "lint": "eslint src",
+    "test": "pnpm build && vitest run",
+    "format:check": "prettier --check src vite.config.ts tsconfig.json"
   }
-}
+}