@simplex-viz/svg 0.1.2 → 0.2.0

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ghackenberg/simplex-viz/main/docs/assets/logo-svg.png" width="640" alt="SimplexViz / svg — @simplex-viz/svg" />
+</p>
+
 # @simplex-viz/svg
 
 Framework-agnostic SVG rendering engine and pluggable `SvgNodeView` architecture for `@simplex-viz/core`. Zero dependency on React—embeds cleanly into Vanilla TypeScript, Vue, Angular, Svelte, Solid, and Web Components.
@@ -6,7 +10,15 @@ Framework-agnostic SVG rendering engine and pluggable `SvgNodeView` architecture
 - **Source & Monorepo:** <https://github.com/ghackenberg/simplex-viz/tree/main/packages/svg>
 - **Companion Packages:** [`@simplex-viz/core`](https://www.npmjs.com/package/@simplex-viz/core) · [`@simplex-viz/react`](https://www.npmjs.com/package/@simplex-viz/react)
 
----
+## Visual Rendering Showcase
+
+While `@simplex-viz/core` computes pure spatial coordinates, `@simplex-viz/svg` turns each frame into live DOM `<svg>` elements inside any browser container or UI framework. The preview below renders its built-in views together in a single viewport:
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ghackenberg/simplex-viz/main/docs/assets/preview-svg.png" width="100%" alt="@simplex-viz/svg rendering showcase showing GeometricShapeSvgView, MultiSectorGlyphSvgView, ClusterAnchorSvgView, and BadgeClusterSvgView" />
+</p>
+
+*Figure: Visual showcase of the four built-in `SvgNodeView` plugins rendered on an OKLab-tinted 60° simplex mesh. Content items mix `GeometricShapeSvgView` (circles, diamonds, hexagons, and stars that morph smoothly via 64-point paths) with `MultiSectorGlyphSvgView` (proportional donut glyphs whose sector arcs encode barycentric topic weights). Topic clusters alternate between compact `ClusterAnchorSvgView` vertex rings and auto-measured `BadgeClusterSvgView` cards sized via offscreen `getBBox()`.*
 
 ## Features
 
@@ -16,27 +28,93 @@ Framework-agnostic SVG rendering engine and pluggable `SvgNodeView` architecture
 - **Centralized root-SVG interactions**: Attaches pointer, click, right-click, wheel, drag-to-pan, and `ResizeObserver` listeners solely on the root `<svg>` element and delegates hit-testing to `@simplex-viz/core`'s exact convex geometry solver.
 - **Four built-in view plugins**: Ready-to-use views for geometric shape morphing, multi-sector topic glyphs, vertex anchors, and dynamic text badges.
 
----
-
 ## Installation
 
+Install `@simplex-viz/svg` alone (`@simplex-viz/core` is installed automatically and key utilities and types are re-exported directly from `@simplex-viz/svg`):
+
 ```bash
-npm install @simplex-viz/core @simplex-viz/svg
+npm install @simplex-viz/svg
 ```
 
----
+## Quickstart (Zero-Config)
+
+### One-Liner Mount (`createSimplexSvg`)
 
-## Quickstart (Vanilla TypeScript)
+Pass a container `HTMLElement` or CSS selector together with an array of `{ id, tags }` items to `createSimplexSvg`. Drag-to-pan, cursor wheel zoom, cluster click-focus, and floating hover tooltips are enabled automatically:
 
 ```ts
-import {
-  SimplexSvgController,
-  GeometricShapeSvgView,
-  ClusterAnchorSvgView,
-  type GeometricShapeVisual,
-  type ClusterAnchorVisual,
+import { createSimplexSvg } from '@simplex-viz/svg';
+
+const items = [
+  { id: '1', label: 'Simplex Mesh', tags: ['geometry', 'triangulation', 'math'] },
+  { id: '2', label: 'OKLab Mixing', tags: ['color', 'geometry', 'perception'] },
+  { id: '3', label: 'SAT Solver', tags: ['collision', 'geometry'] },
+];
+
+const controller = createSimplexSvg('#graph', items);
+```
+
+### Presets, Labels & Custom Domain Records (`SimplexSvgController`)
+
+When you want to pick a built-in visual preset (`'geometric'`, `'glyphs'`, or `'badges'`), display custom labels, or connect records without `{ id, tags }`, pass an options object to `createSimplexSvg` or `new SimplexSvgController(...)`:
+
+```ts
+import { SimplexSvgController } from '@simplex-viz/svg';
+
+interface Article {
+  readonly slug: string;
+  readonly headline: string;
+  readonly topics: readonly string[];
+}
+
+const controller = new SimplexSvgController('#graph', {
+  items: articles,
+  getId: (a) => a.slug,
+  getTags: (a) => a.topics,
+  getLabel: (a) => a.headline,
+  preset: 'glyphs', // 'geometric' | 'glyphs' | 'badges'
+  tooltip: true, // Built-in hover tooltip (or custom formatter)
+});
+```
+
+You can also format hover tooltips yourself without building separate DOM overlays:
+
+```ts
+const controller = new SimplexSvgController('#graph', {
+  items: articles,
+  getId: (a) => a.slug,
+  getTags: (a) => a.topics,
+  preset: 'badges',
+  tooltip: (target) =>
+    target.kind === 'content'
+      ? `${target.item.headline} (${target.layoutContext.tags.length} tags)`
+      : `${target.cluster.defaultLabel}: ${target.cluster.members.length} articles`,
+});
+```
+
+Switch presets or mutate data smoothly at runtime—camera pan/zoom stays intact while springs retarget mid-flight:
+
+```ts
+controller.setPreset('badges');
+controller.addItems({ slug: 'new-1', headline: 'Dual-Layer Crossfade', topics: ['svg', 'animation'] });
+controller.removeItems('old-slug');
+controller.camera.reset();
+```
+
+## Progressive Customization: Custom `VisualResolver` & `SvgNodeView`
+
+Whenever built-in presets are not specific enough, swap in your own `VisualResolver`, view plugins, or root-SVG event handlers without rewriting the container lifecycle.
+
+### Step 1 — Define Your Domain Record & `VisualResolver`
+
+Map each item and topic cluster into typed descriptors for any `SvgNodeView` plugin. Notice that `VisualResolver` and descriptor types can be imported directly from `@simplex-viz/svg`:
+
+```ts
+import type {
+  ClusterAnchorVisual,
+  GeometricShapeVisual,
+  VisualResolver,
 } from '@simplex-viz/svg';
-import type { VisualResolver } from '@simplex-viz/core';
 
 interface Bookmark {
   readonly url: string;
@@ -69,75 +147,70 @@ const visualResolver: VisualResolver<
       ? `${visual.shape}:${visual.radius}:${visual.fillHex}`
       : `${visual.code}:${visual.memberCount}:${visual.colorHex}`,
 };
+```
 
-const container = document.getElementById('graph')!;
+### Step 2 — Mount `SimplexSvgController` with Custom Views
 
-const controller = new SimplexSvgController(container, {
+Pass `visualResolver` together with `contentView` and `clusterView` plugins. You can omit `interactions` to keep default cluster click-focus and cursor zoom, or override individual handlers below:
+
+```ts
+import {
+  SimplexSvgController,
+  GeometricShapeSvgView,
+  ClusterAnchorSvgView,
+} from '@simplex-viz/svg';
+
+const controller = new SimplexSvgController('#graph', {
   items: myBookmarks,
   getId: (b) => b.url,
   getTags: (b) => b.topics,
   visualResolver,
   contentView: new GeometricShapeSvgView(),
   clusterView: new ClusterAnchorSvgView(),
-  meshOptions: {
-    innerPadding: 48,
-    minSideLength: 140,
-    maxSideLength: 280,
-    maxClusters: 10,
-  },
-  layoutOptions: {
-    clusterGapPx: 14,
-    itemGapPx: 5,
-  },
-  interactions: {
-    onContentHover: (ev) => {
-      if (ev) console.log('Hovered item:', ev.item.title, ev.screenPosition);
-    },
-    onLeftClick: (target) => {
-      if (target.kind === 'content') {
-        console.log('Clicked:', target.item.title);
-      } else if (target.kind === 'cluster') {
-        controller.setFocusedClusterUid(target.cluster.clusterUid);
-      } else {
-        controller.setFocusedClusterUid(null);
-      }
-    },
-    onRightClick: (target) => {
-      console.log('Context menu target:', target.kind);
-      return true; // Suppress browser default context menu
-    },
-    onWheel: 'zoom-to-cursor',
-  },
+  meshOptions: { innerPadding: 48, minSideLength: 140, maxSideLength: 280, maxClusters: 10 },
+  layoutOptions: { clusterGapPx: 14, itemGapPx: 5 },
   onMetricsChange: (metrics) => {
     console.log(`Clusters: ${metrics.clusterCount}, Overlaps: ${metrics.overlapCount}`);
   },
 });
+```
 
-// Live mutations & camera controls
-controller.addItems({
-  url: 'https://example.com/oklab',
-  title: 'Perceptual Color Mixing',
-  topics: ['oklab', 'color-science'],
-  minutes: 12,
-});
-controller.removeItems('https://example.com/old');
-controller.camera.reset();
+### Step 3 — Override Hover, Click & Wheel Interactions
+
+Attach custom click, context-menu, and wheel policies at any time via `setInteractions`. Setting `interactions.onLeftClick` overrides the default cluster click-focus toggle:
 
-// Clean up DOM, ResizeObserver, and animation loop on unmount
-// controller.destroy();
+```ts
+controller.setInteractions({
+  onContentHover: (ev) => {
+    if (ev) console.log('Hovered item:', ev.item.title, ev.screenPosition);
+  },
+  onLeftClick: (target) => {
+    if (target.kind === 'content') {
+      console.log('Clicked:', target.item.title);
+    } else if (target.kind === 'cluster') {
+      controller.setFocusedClusterUid(target.cluster.clusterUid);
+    } else {
+      controller.setFocusedClusterUid(null);
+    }
+  },
+  onRightClick: (target) => {
+    console.log('Context menu target:', target.kind);
+    return true; // Suppress browser default context menu
+  },
+  onWheel: 'zoom-to-cursor',
+});
 ```
 
----
+Always call `controller.destroy()` when tearing down your component or view to cancel animations, clean up tooltips, and disconnect `ResizeObserver`.
 
 ## Built-In `SvgNodeView` Plugins
 
 ### 1. `GeometricShapeSvgView`
-Renders `'circle' | 'diamond' | 'star' | 'hexagon'` with analytical convex hulls and **64-point parametric SVG path morphing** between shapes and colors.
+Renders `'circle' | 'diamond' | 'star' | 'hexagon'` with analytical convex hulls and **64-point parametric SVG path morphing** between shapes and colors. Pass a `GeometricShapeVisual` descriptor from `resolveContentVisual` to control polygon kind, radius, fill, and outline stroke:
 
 ```ts
 import type { GeometricShapeVisual } from '@simplex-viz/svg';
 
-// Descriptor shape:
 const visual: GeometricShapeVisual = {
   shape: 'hexagon', // 'circle' | 'diamond' | 'star' | 'hexagon'
   radius: 11,
@@ -148,7 +221,7 @@ const visual: GeometricShapeVisual = {
 ```
 
 ### 2. `MultiSectorGlyphSvgView`
-Renders a multi-colored donut glyph whose sector arc angles match an item's exact barycentric weights across its active simplex unit (vertex, edge, or triangle).
+Renders a multi-colored donut glyph whose sector arc angles match an item's exact barycentric weights across its active simplex unit (vertex, edge, or triangle). Map `ctx.unitClusters` directly into `sectors` as shown below to reflect multi-topic membership visually:
 
 ```ts
 import type { MultiSectorGlyphVisual } from '@simplex-viz/svg';
@@ -165,7 +238,7 @@ const visual: MultiSectorGlyphVisual = {
 ```
 
 ### 3. `BadgeClusterSvgView`
-Renders dynamic pill/card cluster badges sized to their title and metadata line. Intentionally omits `measureConvexHull` so `@simplex-viz/svg` measures the rendered SVG element via `getBBox()`.
+Renders dynamic pill/card cluster badges sized to their title and metadata line. Because it intentionally omits `measureConvexHull`, `@simplex-viz/svg` measures the rendered `<svg>` elements via `getBBox()` so varying title lengths remain strictly overlap-free:
 
 ```ts
 import type { BadgeClusterVisual } from '@simplex-viz/svg';
@@ -179,7 +252,7 @@ const visual: BadgeClusterVisual = {
 ```
 
 ### 4. `ClusterAnchorSvgView`
-Renders calibrated double-ring vertex anchors showing the cluster code and member count.
+Renders calibrated double-ring vertex anchors showing the cluster code and member count. Supply a `ClusterAnchorVisual` descriptor when you want compact circular topic anchors on mesh vertices:
 
 ```ts
 import type { ClusterAnchorVisual } from '@simplex-viz/svg';
@@ -193,33 +266,38 @@ const visual: ClusterAnchorVisual = {
 };
 ```
 
----
-
 ## Writing Custom `SvgNodeView` Plugins
 
 Implement `SvgNodeView<TVisual>` centered around local origin `(0, 0)`. `SvgRendererAdapter` handles world positioning `(x, y)`, solver scale `α`, opacity, and crossfading on the parent `<g>`.
 
+First, define your visual descriptor and an optional analytical hull via `measureConvexHull` (re-exporting `rectToConvexPolygon` straight from `@simplex-viz/svg`, or omit `measureConvexHull` to measure automatically via offscreen `getBBox()`):
+
 ```ts
-import type { SvgNodeView } from '@simplex-viz/svg';
-import { rectToConvexPolygon } from '@simplex-viz/core';
+import { rectToConvexPolygon, type SvgNodeView } from '@simplex-viz/svg';
 
 interface CardVisual {
   readonly title: string;
   readonly colorHex: string;
 }
 
+const getCardWidth = (title: string) => Math.max(80, title.length * 7 + 20);
+```
+
+Next, populate `mountOrUpdate` to construct pure SVG nodes inside `groupEl`, reacting to `state.interaction.isHovered` for instant border emphasis:
+
+```ts
 const SVG_NS = 'http://www.w3.org/2000/svg';
 
 export const CustomCardSvgView: SvgNodeView<CardVisual> = {
   // Optional: omit to measure automatically via offscreen getBBox()
   measureConvexHull: (visual) =>
-    rectToConvexPolygon(Math.max(80, visual.title.length * 7 + 20), 28, 6),
+    rectToConvexPolygon(getCardWidth(visual.title), 28, 6),
 
   mountOrUpdate: (groupEl, visual, state) => {
     const doc = groupEl.ownerDocument;
     while (groupEl.firstChild) groupEl.removeChild(groupEl.firstChild);
 
-    const width = Math.max(80, visual.title.length * 7 + 20);
+    const width = getCardWidth(visual.title);
     const rect = doc.createElementNS(SVG_NS, 'rect');
     rect.setAttribute('x', String(-width / 2));
     rect.setAttribute('y', '-14');
@@ -249,12 +327,15 @@ export const CustomCardSvgView: SvgNodeView<CardVisual> = {
 };
 ```
 
----
+## API Reference (`createSimplexSvg` & `SimplexSvgController`)
 
-## `SimplexSvgController` API Summary
+`SimplexSvgController(target, options)` accepts an `HTMLElement` or CSS selector string. `createSimplexSvg(target, itemsOrOptions)` accepts either a `{ id, tags }` array directly (with `tooltip: true`, cursor zoom, and cluster click-focus enabled) or any `SimplexSvgControllerOptions` object. `@simplex-viz/svg` also re-exports `solveSimplexSnapshot`, geometry hull helpers (`computeConvexHull`, `rectToConvexPolygon`, `regularPolygon`, `starConvexHull`), and core TypeScript types for single-import setups.
 
-| Method / Property | Description |
+| Method / Option | Description |
 | --- | --- |
+| `preset` / `setPreset(preset, getLabel?)` | Switches between `'geometric'`, `'glyphs'`, and `'badges'` with smooth transitions. |
+| `tooltip` / `setTooltip(tooltip)` | Enables a floating DOM hover tooltip (`boolean` or `(target) => string` formatter). |
+| `focusOnClusterClick` | Option (default `true`): toggles cluster focus on click when no custom `interactions.onLeftClick` is provided. |
 | `addItems(items)` | Appends one or more items and triggers an interruptible transition. |
 | `removeItems(ids)` | Removes items by ID and smoothly fades out exiting nodes. |
 | `setItems(items)` | Replaces the entire corpus while preserving matching clusters & items. |
@@ -264,14 +345,12 @@ export const CustomCardSvgView: SvgNodeView<CardVisual> = {
 | `setShowHulls(show)` | Toggles convex bounding hull wireframe overlays. |
 | `setPinnedIds(ids)` / `setHighlightedIds(ids)` | Controls pinned and highlighted visual emphasis states. |
 | `setFocusedClusterUid(uid \| null)` | Isolates a cluster and its members, dimming unrelated nodes. |
-| `setInteractions(handlers)` | Replaces pointer, click, and wheel callbacks dynamically. |
+| `setInteractions(handlers)` | Replaces pointer, click, and wheel callbacks dynamically (`onWheel` defaults to `'zoom-to-cursor'`). |
 | `camera` | Exposes `CameraController` (`zoomToCursor`, `panBy`, `reset`, `getState`, `setState`). |
 | `getMetrics()` / `getClusters()` / `getItems()` | Reads live solver telemetry, clusters, and items. |
 | `getSvgElement()` | Returns the managed root `<svg>` element. |
 | `stepForTest(dtMs)` | Deterministically advances simulation time in unit/DOM tests. |
-| `destroy()` | Cancels `requestAnimationFrame`, disconnects `ResizeObserver`, and removes the `<svg>`. |
-
----
+| `destroy()` | Cancels `requestAnimationFrame`, disconnects `ResizeObserver`, removes tooltips and `<svg>`. |
 
 ## License
 

package/dist/SimplexSvgController.d.ts

@@ -1,38 +1,63 @@
-import { type CameraController, type ClusterDerivationContext, type ClusterDescriptor, type ClusterMetaConfig, type DefaultTaggedItem, type InteractionHandlers, type ItemIdentityConfig, type LayoutMetrics, type LayoutSolverOptions, type MeshOptions, type VisualResolver } from '@simplex-viz/core';
+import { type CameraController, type ClusterDerivationContext, type ClusterDescriptor, type ClusterHoverEvent, type ClusterMetaConfig, type ContentHoverEvent, type DefaultTaggedItem, type InteractionHandlers, type ItemIdentityConfig, type LayoutMetrics, type LayoutSolverOptions, type MeshOptions, type VisualResolver } from '@simplex-viz/core';
+import { type DefaultClusterPresetVisual, type DefaultContentPresetVisual, type SimplexVisualPreset } from './presets';
 import { type SvgRendererOptions } from './SvgRendererAdapter';
-export interface SimplexSvgControllerResolvedOptions<TItem = DefaultTaggedItem, TContentVisual = unknown, TClusterVisual = unknown, TTagMeta = undefined, TClusterMeta = undefined> {
+export type SimplexTooltipFormatter<TItem = DefaultTaggedItem, TContentVisual = DefaultContentPresetVisual, TClusterVisual = DefaultClusterPresetVisual, TTagMeta = undefined, TClusterMeta = undefined> = (target: ({
+    readonly kind: 'content';
+} & ContentHoverEvent<TItem, TContentVisual, TTagMeta, TClusterMeta>) | ({
+    readonly kind: 'cluster';
+} & ClusterHoverEvent<TItem, TClusterVisual, TTagMeta, TClusterMeta>)) => string;
+export interface SimplexSvgControllerResolvedOptions<TItem = DefaultTaggedItem, TContentVisual = DefaultContentPresetVisual, TClusterVisual = DefaultClusterPresetVisual, TTagMeta = undefined, TClusterMeta = undefined> {
     readonly items: readonly TItem[];
     readonly getId?: (item: TItem) => string;
     readonly getTags?: (item: TItem) => readonly string[];
+    readonly getLabel?: (item: TItem) => string;
     readonly deriveClusterMeta?: (ctx: ClusterDerivationContext<TItem, TTagMeta>) => TClusterMeta;
-    readonly visualResolver: VisualResolver<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>;
-    readonly contentView: SvgRendererOptions<TContentVisual, TClusterVisual>['contentView'];
-    readonly clusterView: SvgRendererOptions<TContentVisual, TClusterVisual>['clusterView'];
+    /** Built-in visual preset used when `visualResolver` / views are omitted. Default: `'geometric'`. */
+    readonly preset?: SimplexVisualPreset;
+    /** Optional custom visual resolver (defaults to the active `preset` resolver). */
+    readonly visualResolver?: VisualResolver<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>;
+    /** Optional custom content `SvgNodeView` (defaults to the active `preset` view). */
+    readonly contentView?: SvgRendererOptions<TContentVisual, TClusterVisual>['contentView'];
+    /** Optional custom cluster `SvgNodeView` (defaults to the active `preset` view). */
+    readonly clusterView?: SvgRendererOptions<TContentVisual, TClusterVisual>['clusterView'];
     readonly normalizeTag?: (rawTag: string) => string;
     readonly resolveTagMeta?: (normalizedTag: string) => TTagMeta | undefined;
     readonly meshOptions?: MeshOptions;
     readonly layoutOptions?: LayoutSolverOptions;
     readonly showHulls?: boolean;
+    /**
+     * Automatically toggles cluster focus when clicking a topic cluster (and clears on background click)
+     * unless a custom `interactions.onLeftClick` handler is provided. Default: `true`.
+     */
+    readonly focusOnClusterClick?: boolean;
+    /** Enables a built-in floating DOM hover tooltip (or supply a custom text formatter). Default: `false`. */
+    readonly tooltip?: boolean | SimplexTooltipFormatter<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>;
     readonly interactions?: InteractionHandlers<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>;
     readonly onMetricsChange?: (metrics: LayoutMetrics) => void;
     readonly onClustersChange?: (clusters: readonly ClusterDescriptor<TItem, TTagMeta, TClusterMeta>[]) => void;
     readonly onFpsUpdate?: (fps: number) => void;
 }
-export type SimplexSvgControllerOptions<TItem = DefaultTaggedItem, TContentVisual = unknown, TClusterVisual = unknown, TTagMeta = undefined, TClusterMeta = undefined> = ItemIdentityConfig<TItem> & ClusterMetaConfig<TItem, TTagMeta, TClusterMeta> & Omit<SimplexSvgControllerResolvedOptions<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>, 'getId' | 'getTags' | 'deriveClusterMeta'>;
+export type SimplexSvgControllerOptions<TItem = DefaultTaggedItem, TContentVisual = DefaultContentPresetVisual, TClusterVisual = DefaultClusterPresetVisual, TTagMeta = undefined, TClusterMeta = undefined> = ItemIdentityConfig<TItem> & ClusterMetaConfig<TItem, TTagMeta, TClusterMeta> & Omit<SimplexSvgControllerResolvedOptions<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>, 'getId' | 'getTags' | 'deriveClusterMeta'>;
 /**
  * High-level framework-agnostic SVG graph controller for Vanilla TypeScript, Vue, Angular,
  * Svelte, Web Components, and `@simplex-viz/react`.
  *
- * Attaches centralized pointer, click, contextmenu, wheel, and drag-pan handlers solely on the
- * root `<svg>` element and delegates hit-testing to `@simplex-viz/core`'s convex geometry solver.
+ * Works zero-config with `{ items }` via built-in presets, default zoom/pan/focus interactions,
+ * and optional tooltips, while remaining 100% customizable through `VisualResolver` and `SvgNodeView`.
  */
-export declare class SimplexSvgController<TItem = DefaultTaggedItem, TContentVisual = unknown, TClusterVisual = unknown, TTagMeta = undefined, TClusterMeta = undefined> {
+export declare class SimplexSvgController<TItem = DefaultTaggedItem, TContentVisual = DefaultContentPresetVisual, TClusterVisual = DefaultClusterPresetVisual, TTagMeta = undefined, TClusterMeta = undefined> {
     private readonly containerEl;
     private readonly svgEl;
     private readonly adapter;
     private readonly engine;
     private readonly resizeObserver;
     private readonly onFpsUpdate?;
+    private readonly focusOnClusterClick;
+    private readonly getIdExtractor;
+    private getLabelExtractor?;
+    private tooltipOption;
+    private tooltipEl;
+    private focusedClusterUidState;
     private rafId;
     private lastFrameTs;
     private fpsSamples;
@@ -42,8 +67,14 @@ export declare class SimplexSvgController<TItem = DefaultTaggedItem, TContentVis
     private dragStartX;
     private dragStartY;
     private dragMoved;
-    constructor(containerEl: HTMLElement, options: SimplexSvgControllerOptions<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>);
-    static createFromResolved<TItem = DefaultTaggedItem, TContentVisual = unknown, TClusterVisual = unknown, TTagMeta = undefined, TClusterMeta = undefined>(containerEl: HTMLElement, options: SimplexSvgControllerResolvedOptions<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>): SimplexSvgController<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>;
+    constructor(containerEl: HTMLElement | string, options: SimplexSvgControllerOptions<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>);
+    static createFromResolved<TItem = DefaultTaggedItem, TContentVisual = DefaultContentPresetVisual, TClusterVisual = DefaultClusterPresetVisual, TTagMeta = undefined, TClusterMeta = undefined>(containerEl: HTMLElement | string, options: SimplexSvgControllerResolvedOptions<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>): SimplexSvgController<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>;
+    private wrapInteractions;
+    private formatContentTooltip;
+    private formatClusterTooltip;
+    private ensureTooltipElement;
+    private showTooltip;
+    private hideTooltip;
     get camera(): CameraController;
     getSvgElement(): SVGSVGElement;
     getMetrics(): LayoutMetrics;
@@ -52,6 +83,12 @@ export declare class SimplexSvgController<TItem = DefaultTaggedItem, TContentVis
     addItems(items: TItem | readonly TItem[]): void;
     removeItems(ids: string | readonly string[]): void;
     setItems(items: readonly TItem[]): void;
+    /**
+     * Switches between built-in presets (`'geometric'`, `'glyphs'`, `'badges'`) with smooth
+     * morph/crossfade transitions.
+     */
+    setPreset(preset: SimplexVisualPreset, getLabel?: (item: TItem) => string): void;
+    setTooltip(tooltip: boolean | SimplexTooltipFormatter<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>): void;
     setVisualResolver(resolver: VisualResolver<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>): void;
     setViews(views: Partial<SvgRendererOptions<TContentVisual, TClusterVisual>>): void;
     setSizeMultiplier(multiplier: number): void;
@@ -73,6 +110,17 @@ export declare class SimplexSvgController<TItem = DefaultTaggedItem, TContentVis
     private attachSvgListeners;
     private detachSvgListeners;
     private ensureLoopRunning;
+    /** Helper accessor matching `getId` when external callers inspect items. */
+    getItemId(item: TItem): string;
     destroy(): void;
 }
+/**
+ * Convenience one-liner factory for mounting `@simplex-viz/svg` in Vanilla TypeScript,
+ * Vue, Angular, Svelte, or Web Components.
+ *
+ * Accepts either an array of `{ id, tags }` items directly (with built-in presets,
+ * cursor zoom, and cluster click-focus enabled) or a full options object.
+ */
+export declare function createSimplexSvg<TItem extends DefaultTaggedItem = DefaultTaggedItem>(target: HTMLElement | string, items: readonly TItem[]): SimplexSvgController<TItem, DefaultContentPresetVisual, DefaultClusterPresetVisual>;
+export declare function createSimplexSvg<TItem = DefaultTaggedItem, TContentVisual = DefaultContentPresetVisual, TClusterVisual = DefaultClusterPresetVisual, TTagMeta = undefined, TClusterMeta = undefined>(target: HTMLElement | string, options: SimplexSvgControllerOptions<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>): SimplexSvgController<TItem, TContentVisual, TClusterVisual, TTagMeta, TClusterMeta>;
 //# sourceMappingURL=SimplexSvgController.d.ts.map

package/dist/SimplexSvgController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimplexSvgController.d.ts","sourceRoot":"","sources":["../src/SimplexSvgController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SimplexSvgController.d.ts","sourceRoot":"","sources":["../src/SimplexSvgController.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export * from './types';
 export * from './hullMeasure';
+export * from './presets';
 export * from './SvgRendererAdapter';
 export * from './SimplexSvgController';
 export * from './views/GeometricShapeSvgView';
 export * from './views/MultiSectorGlyphSvgView';
 export * from './views/BadgeClusterSvgView';
 export * from './views/ClusterAnchorSvgView';
+export { solveSimplexSnapshot, computeConvexHull, rectToConvexPolygon, regularPolygon, starConvexHull, type CameraController, type CameraState, type ClusterDescriptor, type ClusterHoverEvent, type ContentHoverEvent, type ContentLayoutContext, type ConvexGeometry, type DefaultTaggedItem, type HitTarget, type InteractionHandlers, type LayoutMetrics, type LayoutSolverOptions, type MeshOptions, type NodeRenderState, type SimplexLayoutSnapshot, type SimplexSnapshotOptions, type VisualResolver, } from '@simplex-viz/core';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}