@fundar/data-chart-telling 1.6.1 → 1.7.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.7.0] - 2026-11-02
+
+### Added
+
+- `legend.removeItems` leaves automatic items out of the series section by name: a series, or a segment or marker that names itself. A plot that colors its marks through `segments` with a `legend` of their own can list only those, without the one series they come from.
+
 ## [1.6.1] - 2026-11-02
 
 ### Fixed

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`. A section whose adjustment sets
+     * discrete one is titled `legend.seriesTitle`. `extension.removeItems` leaves
+     * automatic items out of it by name. 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`. A section whose adjustment sets
+     * discrete one is titled `legend.seriesTitle`. `extension.removeItems` leaves
+     * automatic items out of it by name. A section whose adjustment sets
      * `enabled: false` is left out.
      */
     sections(extension) {
@@ -203,8 +204,10 @@ export class LegendState {
         const cfg = getConfiguration();
         const format = (title) => LegendText.of(title, cfg);
         const adjust = (channel, title) => LegendState.#adjustment(extension?.[channel], title, format);
+        const removed = new SvelteSet(extension?.removeItems);
         const items = [];
         const ramps = [];
+        let named = false;
         let interactive = false;
         for (const entry of entries) {
             if (entry.type === 'size') {
@@ -268,12 +271,14 @@ export class LegendState {
                 }
                 ramps.push(section);
             }
-            else {
+            else if (!removed.has(entry.name)) {
                 items.push(LegendState.#itemOf(entry));
+                if (entry.type === 'mark')
+                    named = true;
             }
         }
         items.push(...(extension?.items ?? []));
-        const named = entries.some((entry) => entry.type === 'mark') || !!extension?.items?.length;
+        named ||= !!extension?.items?.length;
         const others = [...ramps, ...(extension?.sections ?? [])];
         const title = cfg.legend.seriesTitle.enabled && others.length > 0;
         const discrete = items.length > 1 || (named && items.length > 0)

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

@@ -311,6 +311,7 @@ export type LegendExtension = {
      */
     highlight?: string | string[];
     items?: LegendItem[];
+    removeItems?: string[];
     sections?: LegendSection[];
     series?: Omit<DiscreteLegendSection, 'type' | 'items'>;
     color?: ColorOverride | ColorOverride[];

package/docs/legend.md

@@ -110,6 +110,14 @@ legend={{ series: { enabled: false } }}                       // no series secti
 legend={{ color: { match: 'temperature', enabled: false } }}  // not that ramp
 ```
 
+### Removing items
+
+`removeItems` takes automatic items out of the series section by name - a series, or a segment or marker by the label it names itself with. A name nothing carries is ignored, and items added with `items` stay:
+
+```ts
+legend={{ removeItems: ['2017/18'] }}
+```
+
 ### 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.6.1",
+  "version": "1.7.0",
   "description": "Declarative charts, maps and small multiples for Svelte, built on svelteplot.",
   "license": "MIT",
   "author": "Ezequiel Puerta",