canvasxpress 69.4.0 → 69.6.1

package/package.json

@@ -20,7 +20,7 @@
     "./package.json": "./package.json"
   },
   "title": "CanvasXpress",
-  "version": "69.4.0",
+  "version": "69.6.1",
   "license": "SEE LICENSE IN LICENSE",
   "files": [
     "src",

package/src/canvasXpress.css

@@ -4289,6 +4289,18 @@ svg.cX-DataFilter-Toolbar-ImageNB {
   cursor: pointer;
 }
 
+.cX-DataFilter-Summary {
+  width: 100%;
+  padding: 2px 8px 4px 8px;
+  line-height: 1.2;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  opacity: 0.7;
+  color: var(--cx-datafilter-text-color, var(--cx-font-color));
+  font-size: var(--cx-datafilter-font-size, var(--cx-font-size));
+}
+
 
 .cX-DataFilter-Content {
   box-sizing: border-box;

package/src/canvasXpress.d.mts

@@ -44,9 +44,10 @@ export interface CXEvents {
 export type CXAfterRender = Array<[string, ...unknown[]]>;
 
 /**
- * Every accepted `graphType` (70 values, aliases included —
- * e.g. "Volcano" renders as "Scatter2D"). This union is CLOSED so a misspelled
- * graph type fails to type-check.
+ * Every accepted `graphType` (70 values, aliases and internal
+ * render targets included — e.g. "Volcano" renders as "Scatter2D"), so this count
+ * exceeds the ~40+ distinct user-facing chart types quoted on the website. This
+ * union is CLOSED so a misspelled graph type fails to type-check.
  */
 export type CXGraphType =
   | "Alluvial"
@@ -122,7 +123,7 @@ export type CXGraphType =
 
 /**
  * Full chart configuration — one property per parameter in the CanvasXpress
- * config schema (1691 keys). String enums become open literal
+ * config schema (1692 keys). String enums become open literal
  * unions (except `graphType`, which is closed); `@graphTypes` in a key's JSDoc
  * lists the graph types it applies to (absent = all). The index signature keeps
  * obfuscation aliases and any newer key valid. See `CXConfigFor<G>` for the
@@ -1447,6 +1448,18 @@ export interface CXConfig {
    * @default 1
    */
   dataPointSizeScaleFactor?: number | boolean;
+  /**
+   * Declarative, serializable data selection layer authored on top of the DataFilters engine
+   * (an authoring sugar that de-sugars into filterSmpBy / filterVarBy / filterDataBy — not a
+   * second filter engine). A single object, or an ARRAY of named { name, active, ... } blocks
+   * (the active/first is applied; switch at runtime with applyNamedDataSelection). A block has
+   * keys samples / variables / values; each is { any: [...] } (OR) or { all: [...] } (AND),
+   * and a leaf is { annotation, op, value } where op uses friendly vocab (min, max, exact,
+   * like, not like, between, different). Example: { samples: { all: [ { annotation:
+   * "Treatment", op: "exact", value: ["Control"] } ] } }
+   * @default false
+   */
+  dataSelection?: Record<string, unknown> | unknown[] | boolean | string | number;
   /**
    * Color for the the brand of the data table. Used wherever a non-neutral color is required.
    * Selections, focus outlines and checkboxes use the accent color by default
@@ -4864,7 +4877,7 @@ export interface CXConfig {
    */
   nodeBaseline?: "top" | "middle" | "bottom" | false | (string & {});
   /**
-   * Color for the nodes
+   * Color for the text in node
    * @graphTypes Network
    * @default "rgb(245,245,245)"
    */
@@ -7275,7 +7288,7 @@ export interface CXConfig {
    */
   showRegressionFullRange?: boolean;
   /**
-   * Flag to show/hide the legend sample. Not implemented!!!!!
+   * Flag to show/hide the legend sample
    * @graphTypes Bar, BarLine, Boxplot, Bullet, Cleveland, DotLine … (19 types; see CXGraphTypeKeys)
    * @default true
    */
@@ -10722,6 +10735,7 @@ export type CXKeysDataFilters =
   | "dataFilterTextColor"
   | "dataFilterToolbarBackgroundColor"
   | "dataFilterWidth"
+  | "dataSelection"
   | "filterData"
   | "filterDataBy"
   | "filterEdgeBy"

package/src/canvasXpress.d.ts

@@ -53,9 +53,10 @@ declare namespace CanvasXpress {
   export type CXAfterRender = Array<[string, ...unknown[]]>;
 
   /**
-   * Every accepted `graphType` (70 values, aliases included —
-   * e.g. "Volcano" renders as "Scatter2D"). This union is CLOSED so a misspelled
-   * graph type fails to type-check.
+   * Every accepted `graphType` (70 values, aliases and internal
+   * render targets included — e.g. "Volcano" renders as "Scatter2D"), so this count
+   * exceeds the ~40+ distinct user-facing chart types quoted on the website. This
+   * union is CLOSED so a misspelled graph type fails to type-check.
    */
   export type CXGraphType =
     | "Alluvial"
@@ -131,7 +132,7 @@ declare namespace CanvasXpress {
 
   /**
    * Full chart configuration — one property per parameter in the CanvasXpress
-   * config schema (1691 keys). String enums become open literal
+   * config schema (1692 keys). String enums become open literal
    * unions (except `graphType`, which is closed); `@graphTypes` in a key's JSDoc
    * lists the graph types it applies to (absent = all). The index signature keeps
    * obfuscation aliases and any newer key valid. See `CXConfigFor<G>` for the
@@ -1456,6 +1457,18 @@ declare namespace CanvasXpress {
      * @default 1
      */
     dataPointSizeScaleFactor?: number | boolean;
+    /**
+     * Declarative, serializable data selection layer authored on top of the DataFilters engine
+     * (an authoring sugar that de-sugars into filterSmpBy / filterVarBy / filterDataBy — not a
+     * second filter engine). A single object, or an ARRAY of named { name, active, ... } blocks
+     * (the active/first is applied; switch at runtime with applyNamedDataSelection). A block has
+     * keys samples / variables / values; each is { any: [...] } (OR) or { all: [...] } (AND),
+     * and a leaf is { annotation, op, value } where op uses friendly vocab (min, max, exact,
+     * like, not like, between, different). Example: { samples: { all: [ { annotation:
+     * "Treatment", op: "exact", value: ["Control"] } ] } }
+     * @default false
+     */
+    dataSelection?: Record<string, unknown> | unknown[] | boolean | string | number;
     /**
      * Color for the the brand of the data table. Used wherever a non-neutral color is required.
      * Selections, focus outlines and checkboxes use the accent color by default
@@ -4873,7 +4886,7 @@ declare namespace CanvasXpress {
      */
     nodeBaseline?: "top" | "middle" | "bottom" | false | (string & {});
     /**
-     * Color for the nodes
+     * Color for the text in node
      * @graphTypes Network
      * @default "rgb(245,245,245)"
      */
@@ -7284,7 +7297,7 @@ declare namespace CanvasXpress {
      */
     showRegressionFullRange?: boolean;
     /**
-     * Flag to show/hide the legend sample. Not implemented!!!!!
+     * Flag to show/hide the legend sample
      * @graphTypes Bar, BarLine, Boxplot, Bullet, Cleveland, DotLine … (19 types; see CXGraphTypeKeys)
      * @default true
      */
@@ -10731,6 +10744,7 @@ declare namespace CanvasXpress {
     | "dataFilterTextColor"
     | "dataFilterToolbarBackgroundColor"
     | "dataFilterWidth"
+    | "dataSelection"
     | "filterData"
     | "filterDataBy"
     | "filterEdgeBy"