semiotic 3.0.0 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "semiotic",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "The semiotic JavaScript data visualization framework",
   "main": "dist/semiotic.min.js",
   "module": "dist/semiotic.module.min.js",
@@ -42,7 +42,7 @@
       "default": "./dist/realtime.module.min.js"
     },
     "./server": {
-      "types": "./dist/server.d.ts",
+      "types": "./dist/semiotic-server.d.ts",
       "import": "./dist/server.module.min.js",
       "require": "./dist/server.min.js",
       "default": "./dist/server.module.min.js"
@@ -59,6 +59,12 @@
       "require": "./dist/semiotic-data.min.js",
       "default": "./dist/semiotic-data.module.min.js"
     },
+    "./geo": {
+      "types": "./dist/semiotic-geo.d.ts",
+      "import": "./dist/geo.module.min.js",
+      "require": "./dist/geo.min.js",
+      "default": "./dist/geo.module.min.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -78,14 +84,14 @@
     "build": "parcel build --target website",
     "build:analyze": "node scripts/build.mjs --analyze",
     "build:prod": "node scripts/build.mjs --production",
-    "test": "jest --config jest.config.js",
+    "test": "vitest run",
     "pretest:dist": "node scripts/build.mjs",
     "test:dist": "playwright test",
     "bench": "vitest bench",
     "bench:ui": "vitest bench --ui",
     "bench:baseline": "vitest bench --run && node scripts/save-baseline.js",
     "bench:compare": "vitest bench --run && node scripts/compare-baseline.js",
-    "serve-examples": "npm run dist && parcel serve integration-tests/index.html integration-tests/xy-examples/index.html integration-tests/ordinal-examples/index.html integration-tests/network-examples/index.html integration-tests/viz-examples/index.html integration-tests/hoc-legend-examples/index.html --dist-dir .parcel-cache/integration-tests",
+    "serve-examples": "npm run dist && parcel serve integration-tests/index.html integration-tests/xy-examples/index.html integration-tests/ordinal-examples/index.html integration-tests/network-examples/index.html integration-tests/viz-examples/index.html integration-tests/hoc-legend-examples/index.html integration-tests/coordinated-examples/index.html integration-tests/accessibility-examples/index.html integration-tests/geo-examples/index.html integration-tests/realtime-examples/index.html integration-tests/streaming-regression-examples/index.html --dist-dir .parcel-cache/integration-tests",
     "dist": "node scripts/build.mjs",
     "dist:prod": "node scripts/build.mjs --production",
     "lint": "eslint src",
@@ -97,10 +103,15 @@
     "docs:dev": "parcel serve --target website --no-cache --port 3000",
     "website:start": "npm run dist:prod && parcel serve --target website --no-cache",
     "website:start:clean": "npm run clean && npm run dist:prod && parcel serve --target website --no-cache",
-    "website:build": "npm run dist:prod && parcel build --target website && node scripts/prerender.mjs",
+    "generate:ssr-gallery": "npx tsx scripts/ssr-gallery.tsx > docs/public/ssr-gallery.html 2>/dev/null",
+    "website:build": "npm run dist:prod && npm run generate:ssr-gallery && parcel build --target website && node scripts/prerender.mjs",
     "build:mcp": "tsc -p tsconfig.mcp.json",
+    "docs:api": "typedoc",
+    "docs:api:json": "typedoc --json docs/build/api/api.json",
     "typescript": "tsc --noEmit",
-    "prepublishOnly": "node scripts/build.mjs --production"
+    "check:schema": "node scripts/check-schema-freshness.js",
+    "release:check": "npm run lint && npm run typescript && npm run test && npm run check:schema && node scripts/build.mjs --production && npm pack --dry-run",
+    "prepublishOnly": "npm run lint && npm run typescript && npm run test && npm run check:schema && node scripts/build.mjs --production"
   },
   "targets": {
     "website": {
@@ -114,7 +125,8 @@
     }
   },
   "alias": {
-    "semiotic": "./src/components/semiotic.ts"
+    "semiotic": "./src/components/semiotic.ts",
+    "semiotic/geo": "./src/components/semiotic-geo.ts"
   },
   "repository": {
     "type": "git",
@@ -129,21 +141,18 @@
   ],
   "license": "Apache-2.0",
   "devDependencies": {
-    "@babel/core": "^7.24.4",
-    "@babel/preset-env": "^7.24.4",
-    "@babel/preset-react": "^7.24.1",
     "@parcel/transformer-inline-string": "^2.16.4",
     "@playwright/test": "^1.17.1",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^1.0.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^14.3.0",
-    "@testing-library/user-event": "^14.4.3",
     "@types/d3-array": "^3.2.0",
     "@types/d3-brush": "^3.0.0",
     "@types/d3-chord": "^3.0.0",
     "@types/d3-force": "^3.0.0",
     "@types/d3-format": "^3.0.0",
+    "@types/d3-geo": "^3.1.0",
     "@types/d3-hierarchy": "^3.1.0",
     "@types/d3-interpolate": "^3.0.0",
     "@types/d3-scale": "^4.0.9",
@@ -151,36 +160,34 @@
     "@types/d3-selection": "^3.0.0",
     "@types/d3-shape": "^3.1.0",
     "@types/d3-time-format": "^4.0.0",
-    "@types/jest": "^29.5.14",
+    "@types/d3-zoom": "^3.0.8",
     "@types/node": "^20.19.35",
     "@types/react": "^18.3.28",
     "@types/react-dom": "^18.3.7",
     "@types/seedrandom": "^3.0.5",
+    "@types/topojson-client": "^3.1.5",
     "@typescript-eslint/eslint-plugin": "^5.4.6",
+    "@typescript-eslint/parser": "^5.4.6",
+    "@vitest/coverage-v8": "^4.1.0",
     "@vitest/ui": "^4.0.18",
-    "babel-jest": "^29.7.0",
     "d3-dsv": "1.0.5",
     "d3-flextree-v4": "^1.0.1",
-    "dagre": "^0.8.2",
     "eslint": "^8.0.0",
     "eslint-plugin-react": "^7.27.1",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^30.2.0",
+    "jsdom": "^26.1.0",
     "marked": "4.0.10",
-    "material-design-icons-svg": "1.1.2",
     "parcel": "^2.16.4",
     "playwright-chromium": "^1.17.1",
     "prettier": "^3.8.1",
     "react": "^18.1.0",
     "react-dom": "^18.1.0",
     "react-router-dom": "^6.2.1",
-    "resize-observer-polyfill": "^1.5.1",
     "rollup": "^4.59.0",
     "rollup-plugin-auto-external": "^2.0.0",
     "rollup-plugin-typescript2": "^0.34.1",
     "rollup-plugin-visualizer": "^7.0.0",
     "seedrandom": "^3.0.5",
-    "ts-jest": "^29.4.6",
+    "typedoc": "^0.28.17",
     "typescript": "~5.9.3",
     "vitest": "^4.0.18"
   },
@@ -190,19 +197,26 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "@types/d3-quadtree": "^3.0.6",
     "d3-array": "^3.2.4",
     "d3-brush": "^3.0.0",
     "d3-chord": "^3.0.1",
     "d3-force": "^3.0.0",
     "d3-format": "^3.1.0",
+    "d3-geo": "^3.1.1",
     "d3-hierarchy": "^3.1.2",
     "d3-interpolate": "^3.0.1",
+    "d3-quadtree": "^3.0.1",
     "d3-scale": "^4.0.2",
     "d3-scale-chromatic": "^3.1.0",
     "d3-selection": "^3.0.0",
     "d3-shape": "^3.2.0",
+    "d3-tile": "^1.0.0",
     "d3-time-format": "^4.1.0",
-    "regression": "^2.0.1"
+    "d3-zoom": "^3.0.0",
+    "regression": "^2.0.1",
+    "topojson-client": "^3.1.0",
+    "world-atlas": "^2.0.2"
   },
   "browserslist": {
     "development": [

package/dist/Legend.d.ts

@@ -1,3 +0,0 @@
-import * as React from "react";
-import { LegendProps } from "./types/legendTypes";
-export default function Legend(props: LegendProps): React.JSX.Element;

package/dist/stream/DataSourceAdapter.d.ts

@@ -1,35 +0,0 @@
-import type { Changeset } from "./types";
-export type ChangesetCallback<T> = (changeset: Changeset<T>) => void;
-export declare class DataSourceAdapter<T = Record<string, any>> {
-    private callback;
-    private lastBoundedData;
-    private chunkTimer;
-    constructor(callback: ChangesetCallback<T>);
-    /** Clear the dedup cache so the next setBoundedData call re-ingests even the same reference.
-     *  Also cancels any in-flight progressive chunking. */
-    clearLastData(): void;
-    /**
-     * Ingest a bounded data array (from props).
-     *
-     * Small datasets emit a single changeset synchronously.
-     * Large datasets (> CHUNK_THRESHOLD) are split into chunks that render
-     * progressively: the first chunk fires immediately (bounded: true to
-     * reset + seed the buffer), subsequent chunks arrive on successive
-     * animation frames (bounded: false so they append without clearing).
-     */
-    setBoundedData(data: T[]): void;
-    /**
-     * Push a single datum (streaming mode).
-     * Emits a micro-changeset with `bounded: false`.
-     */
-    push(datum: T): void;
-    /**
-     * Push multiple data (streaming batch).
-     * Emits a single changeset with `bounded: false`.
-     */
-    pushMany(data: T[]): void;
-    /**
-     * Reset the adapter state.
-     */
-    clear(): void;
-}

package/dist/stream/SVGOverlay.d.ts

@@ -1,56 +0,0 @@
-import * as React from "react";
-import type { StreamScales, MarginalGraphicsConfig } from "./types";
-import type { AnnotationContext } from "../realtime/types";
-import type { ReactNode } from "react";
-import type { LegendGroup } from "../types/legendTypes";
-export interface AxisConfig {
-    orient: "left" | "right" | "top" | "bottom";
-    label?: string;
-    ticks?: number;
-    tickFormat?: (d: any) => string;
-    baseline?: boolean | "under";
-    jaggedBase?: boolean;
-}
-interface SVGOverlayProps {
-    width: number;
-    height: number;
-    totalWidth: number;
-    totalHeight: number;
-    margin: {
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    };
-    scales: StreamScales | null;
-    showAxes?: boolean;
-    axes?: AxisConfig[];
-    xLabel?: string;
-    yLabel?: string;
-    xFormat?: (d: any) => string;
-    yFormat?: (d: any) => string;
-    showGrid?: boolean;
-    title?: string | ReactNode;
-    legend?: ReactNode | {
-        legendGroups: LegendGroup[];
-    };
-    foregroundGraphics?: ReactNode;
-    marginalGraphics?: MarginalGraphicsConfig;
-    xValues?: number[];
-    yValues?: number[];
-    annotations?: Record<string, any>[];
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
-    annotationFrame?: number;
-    xAccessor?: string;
-    yAccessor?: string;
-    annotationData?: Record<string, any>[];
-    pointNodes?: {
-        pointId?: string;
-        x: number;
-        y: number;
-        r: number;
-    }[];
-    children?: ReactNode;
-}
-export declare function SVGOverlay(props: SVGOverlayProps): React.JSX.Element | null;
-export {};

package/dist/stream/layouts/forceLayoutPlugin.d.ts

@@ -1,9 +0,0 @@
-import type { NetworkLayoutPlugin } from "../networkTypes";
-/**
- * Force-directed layout plugin — uses d3-force for physics-based node positioning.
- *
- * Produces circle scene nodes and line scene edges. Runs the force simulation
- * synchronously for a configurable number of iterations, using phyllotaxis
- * spiral for deterministic initial positions.
- */
-export declare const forceLayoutPlugin: NetworkLayoutPlugin;

package/dist/stream/renderers/areaCanvasRenderer.d.ts

@@ -1,7 +0,0 @@
-import type { StreamRendererFn } from "./types";
-/**
- * Canvas area renderer.
- * Renders AreaSceneNode as filled regions between topPath and bottomPath.
- * Supports both overlapping areas and stacked areas.
- */
-export declare const areaCanvasRenderer: StreamRendererFn;

package/dist/types/legendTypes.d.ts

@@ -1,20 +0,0 @@
-export type SupportedLegendGlyphs = "fill" | "line";
-export type ItemType = SupportedLegendGlyphs | Function;
-export interface LegendItem {
-    label: string;
-}
-export interface LegendGroup {
-    type?: ItemType;
-    styleFn: Function;
-    items: LegendItem[];
-    label: string;
-}
-export interface LegendProps {
-    legendGroups?: LegendGroup[];
-    customClickBehavior?: Function;
-    title?: string;
-    width?: number;
-    height?: number;
-    orientation?: string;
-    position?: "left" | "right";
-}