@dataelvisliang/embedding-atlas 0.15.0-highlight.2 → 0.16.1-highlight.0

package/dist/component.js

@@ -1,4 +1,4 @@
-import { l as s, s as o, Z as i, u as d } from "./chunk-tn9RgvOq.js";
+import { l as s, s as o, Z as i, u as d } from "./chunk-DZZQiXk1.js";
 export {
   s as EmbeddingView,
   o as EmbeddingViewMosaic,

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { Coordinator } from '@uwdata/mosaic-core';
+import { JSONSchema7 } from 'json-schema';
+import { Readable } from 'svelte/store';
 import { Selection as Selection_2 } from '@uwdata/mosaic-core';
 
 declare type AdditionalHeaderContentClass = new (node: HTMLElement, props: AdditionalHeaderContentProps) => {
@@ -38,7 +40,7 @@ declare interface Axis {
     labelMaxWidth?: number;
 }
 
-declare type BuiltinChartSpec = ChartSpec | ContentViewerSpec | CountPlotSpec | EmbeddingSpec | MarkdownSpec | PredicatesSpec | TableSpec;
+export declare type BuiltinChartSpec = ChartSpec | ContentViewerSpec | CountPlotSpec | EmbeddingSpec | MarkdownSpec | PredicatesSpec | TableSpec;
 
 declare interface Cache_2 {
     /** Gets an object from the cache with the given key. Returns `null` if the entry is not found. */
@@ -247,7 +249,7 @@ export declare interface DataPoint {
 
 export declare type DataPointID = string | number | bigint;
 
-/** Data value */
+/** Data value (a value in the data domain, which can be mapped to the visual domain through a scale) */
 declare type DataValue = string | number | [number, number];
 
 export declare function defaultCategoryColors(count: number): string[];
@@ -349,6 +351,8 @@ export declare interface EmbeddingAtlasProps {
     onExportApplication?: (() => Promise<void>) | null;
     /** A callback when the state of the viewer changes. You may serialize the state to JSON and load it back. */
     onStateChange?: ((state: EmbeddingAtlasState) => void) | null;
+    /** Model context API where the component will register its tools to. */
+    modelContext?: ModelContextAPI | null;
     /** A cache to speed up initialization of the viewer. */
     cache?: Cache_2 | null;
     /**
@@ -380,7 +384,7 @@ export declare interface EmbeddingAtlasState {
 
 declare interface EmbeddingSpec {
     type: "embedding";
-    title: string;
+    title?: string;
     data: {
         x: string;
         y: string;
@@ -635,7 +639,7 @@ export declare interface EmbeddingViewTheme {
 
 /** Encoding */
 declare type Encoding = {
-    /** The data field */
+    /** The data field to encode */
     field: SQLField;
     bin?: {
         /** Desired bin count */
@@ -653,6 +657,7 @@ declare type Encoding = {
     /** Normalize the value by x or y */
     normalize?: "x" | "y";
 } | {
+    /** The data value to encode */
     value: DataValue;
 };
 
@@ -716,7 +721,7 @@ export declare interface Label {
 declare interface Layer {
     /** Data source, default to the main data table */
     from?: SQLTable;
-    /** Filter the data. Use $filter to refer to the shared filter */
+    /** Filter the data. Use $filter to refer to the shared filter (a cross-filter) */
     filter?: "$filter";
     /** Mark type */
     mark: MarkType;
@@ -735,6 +740,8 @@ declare interface Layer {
     width?: Dimension;
     /** Height of bar / rect marks */
     height?: Dimension;
+    /** Size (area) of point marks, default 100. */
+    size?: number;
     /** Encoding */
     encoding?: Partial<Record<Attribute, Encoding>>;
 }
@@ -760,9 +767,9 @@ declare interface MarkStyle {
     /** Stroke cap */
     strokeCap?: "butt" | "round" | "square";
     /** Stroke join */
-    strokeJoin?: "round" | "miter-clip" | "miter" | "bevel";
-    /** Paint order */
-    paintOrder?: string;
+    strokeJoin?: "round" | "miter" | "bevel";
+    /** Paint order, default is `fill stroke`, fill first, then stroke. */
+    paintOrder?: "fill stroke" | "stroke fill";
     /** Opacity */
     opacity?: number;
 }
@@ -772,6 +779,32 @@ declare type MarkType = "bar" | "rect" | "line" | "area" | "point" | "rule";
 
 export declare function maxDensityModeCategories(): number;
 
+declare interface MCPContext {
+    tools?: MCPTool[];
+}
+
+/** Tool definition interface */
+declare interface MCPTool {
+    /** Unique name for the tool */
+    name: string;
+    /** The title of the tool */
+    title?: string;
+    /** Natural language description of what the tool does */
+    description: string;
+    /** JSON Schema defining the input parameters */
+    inputSchema: JSONSchema7;
+    /** JSON Schema defining the output parameters */
+    outputSchema?: JSONSchema7;
+    /** Function that implements the tool and returns a result */
+    execute: (input: any, agent: unknown) => Promise<ToolResponse>;
+}
+
+/** A type that mirrors the current design in the upcoming navigator.modelContext API */
+declare interface ModelContextAPI {
+    provideContext(context: MCPContext): void;
+    readonly connectionStatus?: Readable<"connecting" | "connected" | "closed" | "error">;
+}
+
 export declare interface OverlayProxy {
     location: (x: number, y: number) => {
         x: number;
@@ -1016,6 +1049,17 @@ declare interface ThemeConfig_2 {
     rowHoverColor?: string;
 }
 
+/** Tool response format */
+declare interface ToolResponse {
+    content: Array<{
+        type: "text" | "image" | "video";
+        text?: string;
+        url?: string;
+        [key: string]: any;
+    }>;
+    isError?: boolean;
+}
+
 export declare interface UMAP {
     /** The current epoch number */
     get epoch(): number;

package/dist/index.js

@@ -1,9 +1,9 @@
-import { l as s, s as r, Z as o, u as t } from "./chunk-tn9RgvOq.js";
-import { J as i, f } from "./chunk-ssRSlsnF.js";
-import { S as l, O as g } from "./chunk-CNWfCa2H.js";
+import { l as s, s as r, Z as o, u as t } from "./chunk-DZZQiXk1.js";
+import { J as i, f } from "./chunk-DoyQAvDN.js";
+import { l as m, W as g } from "./chunk-CQWmKO2N.js";
 import { createKNN as x, createUMAP as C } from "./umap.js";
 export {
-  l as EmbeddingAtlas,
+  m as EmbeddingAtlas,
   s as EmbeddingView,
   r as EmbeddingViewMosaic,
   i as Table,

package/dist/react.d.ts

@@ -1,4 +1,6 @@
 import { Coordinator } from '@uwdata/mosaic-core';
+import { JSONSchema7 } from 'json-schema';
+import { Readable } from 'svelte/store';
 import { Selection as Selection_3 } from '@uwdata/mosaic-core';
 
 declare type AdditionalHeaderContentClass = new (node: HTMLElement, props: AdditionalHeaderContentProps) => {
@@ -38,7 +40,7 @@ declare interface Axis {
     labelMaxWidth?: number;
 }
 
-declare type BuiltinChartSpec = ChartSpec | ContentViewerSpec | CountPlotSpec | EmbeddingSpec | MarkdownSpec | PredicatesSpec | TableSpec;
+export declare type BuiltinChartSpec = ChartSpec | ContentViewerSpec | CountPlotSpec | EmbeddingSpec | MarkdownSpec | PredicatesSpec | TableSpec;
 
 declare interface Cache_2 {
     /** Gets an object from the cache with the given key. Returns `null` if the entry is not found. */
@@ -247,7 +249,7 @@ export declare interface DataPoint {
 
 export declare type DataPointID = string | number | bigint;
 
-/** Data value */
+/** Data value (a value in the data domain, which can be mapped to the visual domain through a scale) */
 declare type DataValue = string | number | [number, number];
 
 export declare function defaultCategoryColors(count: number): string[];
@@ -342,6 +344,8 @@ export declare interface EmbeddingAtlasProps {
     onExportApplication?: (() => Promise<void>) | null;
     /** A callback when the state of the viewer changes. You may serialize the state to JSON and load it back. */
     onStateChange?: ((state: EmbeddingAtlasState) => void) | null;
+    /** Model context API where the component will register its tools to. */
+    modelContext?: ModelContextAPI | null;
     /** A cache to speed up initialization of the viewer. */
     cache?: Cache_2 | null;
     /**
@@ -373,7 +377,7 @@ export declare interface EmbeddingAtlasState {
 
 declare interface EmbeddingSpec {
     type: "embedding";
-    title: string;
+    title?: string;
     data: {
         x: string;
         y: string;
@@ -616,7 +620,7 @@ export declare interface EmbeddingViewTheme {
 
 /** Encoding */
 declare type Encoding = {
-    /** The data field */
+    /** The data field to encode */
     field: SQLField;
     bin?: {
         /** Desired bin count */
@@ -634,6 +638,7 @@ declare type Encoding = {
     /** Normalize the value by x or y */
     normalize?: "x" | "y";
 } | {
+    /** The data value to encode */
     value: DataValue;
 };
 
@@ -697,7 +702,7 @@ export declare interface Label {
 declare interface Layer {
     /** Data source, default to the main data table */
     from?: SQLTable;
-    /** Filter the data. Use $filter to refer to the shared filter */
+    /** Filter the data. Use $filter to refer to the shared filter (a cross-filter) */
     filter?: "$filter";
     /** Mark type */
     mark: MarkType;
@@ -716,6 +721,8 @@ declare interface Layer {
     width?: Dimension;
     /** Height of bar / rect marks */
     height?: Dimension;
+    /** Size (area) of point marks, default 100. */
+    size?: number;
     /** Encoding */
     encoding?: Partial<Record<Attribute, Encoding>>;
 }
@@ -741,9 +748,9 @@ declare interface MarkStyle {
     /** Stroke cap */
     strokeCap?: "butt" | "round" | "square";
     /** Stroke join */
-    strokeJoin?: "round" | "miter-clip" | "miter" | "bevel";
-    /** Paint order */
-    paintOrder?: string;
+    strokeJoin?: "round" | "miter" | "bevel";
+    /** Paint order, default is `fill stroke`, fill first, then stroke. */
+    paintOrder?: "fill stroke" | "stroke fill";
     /** Opacity */
     opacity?: number;
 }
@@ -753,6 +760,32 @@ declare type MarkType = "bar" | "rect" | "line" | "area" | "point" | "rule";
 
 export declare function maxDensityModeCategories(): number;
 
+declare interface MCPContext {
+    tools?: MCPTool[];
+}
+
+/** Tool definition interface */
+declare interface MCPTool {
+    /** Unique name for the tool */
+    name: string;
+    /** The title of the tool */
+    title?: string;
+    /** Natural language description of what the tool does */
+    description: string;
+    /** JSON Schema defining the input parameters */
+    inputSchema: JSONSchema7;
+    /** JSON Schema defining the output parameters */
+    outputSchema?: JSONSchema7;
+    /** Function that implements the tool and returns a result */
+    execute: (input: any, agent: unknown) => Promise<ToolResponse>;
+}
+
+/** A type that mirrors the current design in the upcoming navigator.modelContext API */
+declare interface ModelContextAPI {
+    provideContext(context: MCPContext): void;
+    readonly connectionStatus?: Readable<"connecting" | "connected" | "closed" | "error">;
+}
+
 export declare interface OverlayProxy {
     location: (x: number, y: number) => {
         x: number;
@@ -991,6 +1024,17 @@ declare interface ThemeConfig_2 {
     rowHoverColor?: string;
 }
 
+/** Tool response format */
+declare interface ToolResponse {
+    content: Array<{
+        type: "text" | "image" | "video";
+        text?: string;
+        url?: string;
+        [key: string]: any;
+    }>;
+    isError?: boolean;
+}
+
 export declare interface UMAP {
     /** The current epoch number */
     get epoch(): number;

package/dist/react.js

@@ -1,10 +1,10 @@
-import { useRef as n, useEffect as a, createElement as m } from "react";
-import { l, s as d } from "./chunk-tn9RgvOq.js";
-import { Z as A, u as J } from "./chunk-tn9RgvOq.js";
-import { J as u } from "./chunk-ssRSlsnF.js";
-import { f as R } from "./chunk-ssRSlsnF.js";
-import { S as p } from "./chunk-CNWfCa2H.js";
-import { O as V } from "./chunk-CNWfCa2H.js";
+import { useRef as n, useEffect as a, createElement as l } from "react";
+import { l as m, s as d } from "./chunk-DZZQiXk1.js";
+import { Z as A, u as J } from "./chunk-DZZQiXk1.js";
+import { J as u } from "./chunk-DoyQAvDN.js";
+import { f as R } from "./chunk-DoyQAvDN.js";
+import { l as p } from "./chunk-CQWmKO2N.js";
+import { W } from "./chunk-CQWmKO2N.js";
 import { createKNN as D, createUMAP as K } from "./umap.js";
 function e(s, f = "div", i = { display: "flex" }) {
   return (t) => {
@@ -16,14 +16,14 @@ function e(s, f = "div", i = { display: "flex" }) {
       };
     }, []), a(() => {
       r.current?.update(t);
-    }, [t]), m(f, { ref: o, style: i });
+    }, [t]), l(f, { ref: o, style: i });
   };
 }
 const E = e(p, "div", {
   display: "flex",
   width: "100%",
   height: "100%"
-}), b = e(l), h = e(d), w = e(u);
+}), b = e(m), h = e(d), w = e(u);
 export {
   E as EmbeddingAtlas,
   b as EmbeddingView,
@@ -32,7 +32,7 @@ export {
   D as createKNN,
   K as createUMAP,
   A as defaultCategoryColors,
-  V as defaultCharts,
+  W as defaultCharts,
   R as findClusters,
   J as maxDensityModeCategories
 };

package/dist/viewer.d.ts

@@ -1,4 +1,6 @@
 import { Coordinator } from '@uwdata/mosaic-core';
+import { JSONSchema7 } from 'json-schema';
+import { Readable } from 'svelte/store';
 
 declare type AggregateFn = "count" | "distinct" | "min" | "max" | "mean" | "average" | "median" | "stdev" | "stdevp" | "variance" | "variancep" | "sum" | "product" | "quantile" | "ecdf-value" | "ecdf-rank";
 
@@ -24,7 +26,7 @@ declare interface Axis {
     labelMaxWidth?: number;
 }
 
-declare type BuiltinChartSpec = ChartSpec | ContentViewerSpec | CountPlotSpec | EmbeddingSpec | MarkdownSpec | PredicatesSpec | TableSpec;
+export declare type BuiltinChartSpec = ChartSpec | ContentViewerSpec | CountPlotSpec | EmbeddingSpec | MarkdownSpec | PredicatesSpec | TableSpec;
 
 declare interface Cache_2 {
     /** Gets an object from the cache with the given key. Returns `null` if the entry is not found. */
@@ -142,7 +144,7 @@ declare interface CustomCellProps {
     };
 }
 
-/** Data value */
+/** Data value (a value in the data domain, which can be mapped to the visual domain through a scale) */
 declare type DataValue = string | number | [number, number];
 
 /** Returns a list of default charts for a given data table. */
@@ -242,6 +244,8 @@ export declare interface EmbeddingAtlasProps {
     onExportApplication?: (() => Promise<void>) | null;
     /** A callback when the state of the viewer changes. You may serialize the state to JSON and load it back. */
     onStateChange?: ((state: EmbeddingAtlasState) => void) | null;
+    /** Model context API where the component will register its tools to. */
+    modelContext?: ModelContextAPI | null;
     /** A cache to speed up initialization of the viewer. */
     cache?: Cache_2 | null;
     /**
@@ -273,7 +277,7 @@ export declare interface EmbeddingAtlasState {
 
 declare interface EmbeddingSpec {
     type: "embedding";
-    title: string;
+    title?: string;
     data: {
         x: string;
         y: string;
@@ -324,7 +328,7 @@ declare interface EmbeddingViewConfig {
 
 /** Encoding */
 declare type Encoding = {
-    /** The data field */
+    /** The data field to encode */
     field: SQLField;
     bin?: {
         /** Desired bin count */
@@ -342,6 +346,7 @@ declare type Encoding = {
     /** Normalize the value by x or y */
     normalize?: "x" | "y";
 } | {
+    /** The data value to encode */
     value: DataValue;
 };
 
@@ -364,7 +369,7 @@ declare interface Label {
 declare interface Layer {
     /** Data source, default to the main data table */
     from?: SQLTable;
-    /** Filter the data. Use $filter to refer to the shared filter */
+    /** Filter the data. Use $filter to refer to the shared filter (a cross-filter) */
     filter?: "$filter";
     /** Mark type */
     mark: MarkType;
@@ -383,6 +388,8 @@ declare interface Layer {
     width?: Dimension;
     /** Height of bar / rect marks */
     height?: Dimension;
+    /** Size (area) of point marks, default 100. */
+    size?: number;
     /** Encoding */
     encoding?: Partial<Record<Attribute, Encoding>>;
 }
@@ -408,9 +415,9 @@ declare interface MarkStyle {
     /** Stroke cap */
     strokeCap?: "butt" | "round" | "square";
     /** Stroke join */
-    strokeJoin?: "round" | "miter-clip" | "miter" | "bevel";
-    /** Paint order */
-    paintOrder?: string;
+    strokeJoin?: "round" | "miter" | "bevel";
+    /** Paint order, default is `fill stroke`, fill first, then stroke. */
+    paintOrder?: "fill stroke" | "stroke fill";
     /** Opacity */
     opacity?: number;
 }
@@ -418,6 +425,32 @@ declare interface MarkStyle {
 /** Mark type */
 declare type MarkType = "bar" | "rect" | "line" | "area" | "point" | "rule";
 
+declare interface MCPContext {
+    tools?: MCPTool[];
+}
+
+/** Tool definition interface */
+declare interface MCPTool {
+    /** Unique name for the tool */
+    name: string;
+    /** The title of the tool */
+    title?: string;
+    /** Natural language description of what the tool does */
+    description: string;
+    /** JSON Schema defining the input parameters */
+    inputSchema: JSONSchema7;
+    /** JSON Schema defining the output parameters */
+    outputSchema?: JSONSchema7;
+    /** Function that implements the tool and returns a result */
+    execute: (input: any, agent: unknown) => Promise<ToolResponse>;
+}
+
+/** A type that mirrors the current design in the upcoming navigator.modelContext API */
+declare interface ModelContextAPI {
+    provideContext(context: MCPContext): void;
+    readonly connectionStatus?: Readable<"connecting" | "connected" | "closed" | "error">;
+}
+
 declare interface PredicatesSpec {
     type: "predicates";
     title?: string;
@@ -499,6 +532,17 @@ declare interface TableSpec {
     columns: string[];
 }
 
+/** Tool response format */
+declare interface ToolResponse {
+    content: Array<{
+        type: "text" | "image" | "video";
+        text?: string;
+        url?: string;
+        [key: string]: any;
+    }>;
+    isError?: boolean;
+}
+
 /** Widget for editing a chart */
 declare type Widget = {
     type: "scale.type";

package/dist/viewer.js

@@ -1,4 +1,4 @@
-import { S as t, O as d } from "./chunk-CNWfCa2H.js";
+import { l as t, W as d } from "./chunk-CQWmKO2N.js";
 export {
   t as EmbeddingAtlas,
   d as defaultCharts

package/package.json

@@ -1,92 +1,92 @@
-{
-  "name": "@dataelvisliang/embedding-atlas",
-  "version": "0.15.0-highlight.2",
-  "type": "module",
-  "license": "MIT",
-  "description": "Components for interactive embedding visualization (fork with highlight prop support)",
-  "keywords": [
-    "embedding",
-    "visualization",
-    "highlight"
-  ],
-  "homepage": "https://github.com/dataelvisliang/embedding-atlas",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/dataelvisliang/embedding-atlas.git"
-  },
-  "author": {
-    "name": "Donghao Ren",
-    "email": "donghao.ren@gmail.com"
-  },
-  "contributors": [
-    {
-      "name": "Halden Lin",
-      "email": "halden.lin@gmail.com"
-    },
-    {
-      "name": "Fred Hohman",
-      "email": "fredhohman@apple.com"
-    },
-    {
-      "name": "Dominik Moritz",
-      "email": "domoritz@gmail.com"
-    },
-    {
-      "name": "Elvis Liang"
-    }
-  ],
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "check": "svelte-check",
-    "package": "npm run build && publint",
-    "preview": "vite preview"
-  },
-  "files": [
-    "dist",
-    "svelte"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./react": {
-      "types": "./dist/react.d.ts",
-      "default": "./dist/react.js"
-    },
-    "./svelte": {
-      "types": "./svelte/index.d.ts",
-      "svelte": "./svelte/index.js",
-      "default": "./svelte/index.js"
-    }
-  },
-  "dependencies": {},
-  "peerDependencies": {
-    "@uwdata/mosaic-core": ">=0.19.0",
-    "@uwdata/mosaic-spec": ">=0.19.0",
-    "@uwdata/mosaic-sql": ">=0.19.0",
-    "@uwdata/vgplot": ">=0.19.0",
-    "react": ">=17.0.0",
-    "svelte": ">=5.0.0"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    },
-    "svelte": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@embedding-atlas/component": "*",
-    "@embedding-atlas/viewer": "*",
-    "@embedding-atlas/table": "*",
-    "@embedding-atlas/umap-wasm": "*",
-    "tslib": "^2.8.1",
-    "typescript": "^5.9.2",
-    "vite": "^7.0.6",
-    "vite-plugin-dts": "^4.5.4",
-    "svelte-check": "^4.3.1"
-  }
-}
+{
+  "name": "@dataelvisliang/embedding-atlas",
+  "version": "0.16.1-highlight.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Components for interactive embedding visualization (fork with highlight prop support)",
+  "keywords": [
+    "embedding",
+    "visualization",
+    "highlight"
+  ],
+  "homepage": "https://github.com/dataelvisliang/embedding-atlas",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dataelvisliang/embedding-atlas.git"
+  },
+  "author": {
+    "name": "Donghao Ren",
+    "email": "donghao.ren@gmail.com"
+  },
+  "contributors": [
+    {
+      "name": "Halden Lin",
+      "email": "halden.lin@gmail.com"
+    },
+    {
+      "name": "Fred Hohman",
+      "email": "fredhohman@apple.com"
+    },
+    {
+      "name": "Dominik Moritz",
+      "email": "domoritz@gmail.com"
+    },
+    {
+      "name": "Elvis Liang"
+    }
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "check": "svelte-check",
+    "package": "npm run build && publint",
+    "preview": "vite preview"
+  },
+  "files": [
+    "dist",
+    "svelte"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    },
+    "./svelte": {
+      "types": "./svelte/index.d.ts",
+      "svelte": "./svelte/index.js",
+      "default": "./svelte/index.js"
+    }
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@uwdata/mosaic-core": ">=0.19.0",
+    "@uwdata/mosaic-spec": ">=0.19.0",
+    "@uwdata/mosaic-sql": ">=0.19.0",
+    "@uwdata/vgplot": ">=0.19.0",
+    "react": ">=17.0.0",
+    "svelte": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@embedding-atlas/component": "*",
+    "@embedding-atlas/viewer": "*",
+    "@embedding-atlas/table": "*",
+    "@embedding-atlas/umap-wasm": "*",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.2",
+    "vite": "^7.0.6",
+    "vite-plugin-dts": "^4.5.4",
+    "svelte-check": "^4.3.1"
+  }
+}