@fundar/data-chart-telling 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.6.0] - 2026-11-02
+
+### Added
+
+- Every legend section takes `enabled`, on unless set: `legend: { series: { enabled: false } }` leaves the series section off the automatic legend, and `color`, `opacity`, `r` and `symbol` (with a `match`, to pick one of several) do the same for theirs. A section added through `legend.sections` takes it too.
+
 ## [1.5.0] - 2026-10-31
 
 ### Changed

package/dist/layout/legend/LegendState.svelte.d.ts

@@ -77,7 +77,8 @@ export declare class LegendState {
      * scale, each titled by its field name (see `legend.pretty`);
      * then `extension.sections`. A lone series, with nothing else to tell it
      * from, shows no discrete section; with other sections beside it, the
-     * discrete one is titled `legend.seriesTitle`.
+     * discrete one is titled `legend.seriesTitle`. A section whose adjustment sets
+     * `enabled: false` is left out.
      */
     sections(extension?: LegendExtension): LegendSection[];
     /**

package/dist/layout/legend/LegendState.svelte.js

@@ -195,7 +195,8 @@ export class LegendState {
      * scale, each titled by its field name (see `legend.pretty`);
      * then `extension.sections`. A lone series, with nothing else to tell it
      * from, shows no discrete section; with other sections beside it, the
-     * discrete one is titled `legend.seriesTitle`.
+     * discrete one is titled `legend.seriesTitle`. A section whose adjustment sets
+     * `enabled: false` is left out.
      */
     sections(extension) {
         const entries = this.entries;
@@ -286,7 +287,7 @@ export class LegendState {
                 }
             ]
             : [];
-        return [...discrete, ...others];
+        return [...discrete, ...others].filter((section) => section.enabled !== false);
     }
     /** What `override` changes in the section titled `title`: the entries that match it, in order, merged. */
     static #adjustment(override, title, format) {

package/dist/types/layout/legend.d.ts

@@ -91,6 +91,7 @@ export type DiscreteInteractiveConfig = {
 };
 export type DiscreteLegendSection = {
     type: 'discrete';
+    enabled?: boolean;
     title?: string;
     items: LegendItem[];
     columns?: number;
@@ -112,6 +113,7 @@ export type ContinuousInteractiveConfig = {
 };
 export type ContinuousLegendSection = {
     type: 'continuous';
+    enabled?: boolean;
     title?: string;
     /** The channel the section reads, which tells apart automatic sections that share a title. */
     channel?: Exclude<LegendChannel, 'series'>;
@@ -138,6 +140,7 @@ export type ContinuousLegendSection = {
  */
 export type SizeLegendSection = {
     type: 'size';
+    enabled?: boolean;
     title?: string;
     /** The channel the section reads, which tells apart automatic sections that share a title. */
     channel?: Exclude<LegendChannel, 'series'>;
@@ -162,6 +165,7 @@ export type SizeLegendSection = {
  */
 export type SymbolLegendSection = {
     type: 'symbol';
+    enabled?: boolean;
     title?: string;
     /** The channel the section reads, which tells apart automatic sections that share a title. */
     channel?: Exclude<LegendChannel, 'series'>;
@@ -276,7 +280,7 @@ export type LegendOverride<TSection extends {
  * takes what both sections share, plus each one's own - what a section lacks
  * is ignored. `interactive` takes either section's options.
  */
-export type ColorOverride = Omit<ContinuousLegendSection, 'type' | 'min' | 'max' | 'colorMin' | 'colorMax' | 'scheme' | 'pivot' | 'opacity' | 'interactive'> & Pick<DiscreteLegendSection, 'layout' | 'navButton'> & {
+export type ColorOverride = Omit<ContinuousLegendSection, 'type' | 'min' | 'max' | 'colorMin' | 'colorMax' | 'scheme' | 'pivot' | 'opacity' | 'interactive'> & Pick<DiscreteLegendSection, 'layout' | 'navButton' | 'enabled'> & {
     interactive?: ContinuousInteractiveConfig & DiscreteInteractiveConfig;
     /** Adjusts only the continuous section titled so. */
     match?: string;

package/docs/legend.md

@@ -101,6 +101,15 @@ legend={{
 
 Each key is the name of the channel (the plot's own prop: `r` for the size section) and adjusts the section that channel draws: any section field except what the plots compute (items, ranges, domains). An entry with `match` adjusts only the section whose title matches; a list of entries adjusts several.
 
+### Leaving a section disabled
+
+Every section takes `enabled`, on unless set. `enabled: false` leaves that section off the legend, while the others stay:
+
+```ts
+legend={{ series: { enabled: false } }}                       // no series section
+legend={{ color: { match: 'temperature', enabled: false } }}  // not that ramp
+```
+
 ### Turning series off from code
 
 `off` turns series off as if the reader had clicked them, without a click: a list of names (each dimmed, to `legend.disabledOpacity`), or a name → opacity or name → action map, where an action is the same `{ mode: 'dim' | 'hide' | 'omit' }` a toggle does. `highlight` is its inverse: it keeps the series it names on and dims all the others. An `off` entry for a series wins over `highlight`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fundar/data-chart-telling",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Declarative charts, maps and small multiples for Svelte, built on svelteplot.",
   "license": "MIT",
   "author": "Ezequiel Puerta",