@rokkit/graph 1.6.0 → 1.7.0

package/dist/types.d.ts

@@ -21,6 +21,41 @@ export type GraphNode = {
     group?: string;
     /** Closed vocabulary — table | view | matview | function | procedure | enum. */
     kind?: string;
+    /**
+     * A quantity this node carries — declarations in a module, rows in a table, bytes in a
+     * bundle. Drives size in `points` (`sizeBy: 'weight'`) and the sequential colour channel.
+     *
+     * Optional because most graphs have no such number, and degree stays the default so no
+     * existing caller changes. A node without one sizes at the floor rather than vanishing.
+     */
+    weight?: number;
+    /**
+     * Named quantities this node carries — `{ declarations: 900, unresolved: 0.9 }`.
+     *
+     * A bag rather than more fields because size and shade are INDEPENDENT measures with
+     * different ranges, and the control that motivates them switches between several at
+     * runtime: naming a key re-runs the layout, where re-mapping `fields` would re-normalize
+     * the whole model on every toggle. `weight` remains the named default for size.
+     */
+    measures?: Record<string, number>;
+    /**
+     * This node's OWN full path, outermost first and INCLUDING itself —
+     * `['dbd', 'core', 'lexer', 'parse']`.
+     *
+     * `group` is one flat key and a codebase is containment six deep: project › repository ›
+     * folder › module › file › symbol. A path needs nothing to exist that does not, and cannot
+     * dangle the way a `parent` id can. A node without one sits at the root.
+     *
+     * **Containment is PREFIX**, which is what makes a container an ordinary node: anything
+     * whose path extends past this one is inside it. A container therefore keeps its own id,
+     * label, note, measures and edges — there is no id convention to satisfy and no second
+     * kind of node. A prefix nothing declares is synthesised, so the easy case still needs
+     * only leaves.
+     *
+     * Accepts a delimited STRING too (`'dbd/core/lexer/parse'`), since that is how a file path
+     * arrives. See `GraphFields.pathDelimiter`.
+     */
+    path?: string[];
     rows: GraphRow[];
     note?: string;
     /** Source fields the map did not claim, passed through untouched. */
@@ -85,8 +120,17 @@ export type GraphProps = {
     arrange?: import('./layout/types.js').Arrange;
     /** Outer grouping axis — `group` (default) or `kind`. */
     groupBy?: import('./layout/types.js').NodeAxis;
+    /** Paint each card with its group's ramp — schema stays visible in a clusterless layout. */
+    groupTint?: boolean;
     /** Subdivide each cluster by a second axis. Omit for one level. */
     nestBy?: import('./layout/types.js').NodeAxis;
+    /**
+     * `points` only — what a node's size encodes. `degree` (default) counts edges, `weight`
+     * reads `GraphNode.weight`, and any other string names a key in `GraphNode.measures`.
+     */
+    sizeBy?: string;
+    /** How the measure maps onto area — `linear` (default) or `log`. */
+    sizeScale?: 'linear' | 'log';
     edgeStyle?: import('./layout/types.js').EdgeStyle;
     /** `neighborhood` only — the node the view centres on. Defaults to the selection. */
     focus?: string | null;
@@ -99,16 +143,16 @@ export type GraphProps = {
      */
     zoom?: number;
     /** Built-in zoom controls, ctrl/pinch-wheel zoom and drag-to-pan. Default true. */
+    /** Ctrl/pinch-wheel zoom and drag-to-pan. The BUTTON bar is `ZoomControl`, placed by you. */
     zoomable?: boolean;
-    /** Built-in names/keys/all detail toggle on the canvas. Default true. */
-    densityToggle?: boolean;
     /**
      * Draw an arrowhead at each edge's target instead of a plain anchor dot. Default true —
      * an edge is directed, and two identical dots discard that.
      */
     arrows?: boolean;
     label?: string;
-    onselect?: (id: string) => void;
+    /** Fires on selection AND on clear, where it receives `null`. */
+    onselect?: (id: string | null) => void;
     /** Icon class per node kind and row badge, merged over the built-in map. */
     icons?: Record<string, string>;
     class?: string;
@@ -123,6 +167,14 @@ export type GraphFields = {
     label?: string;
     group?: string;
     kind?: string;
+    /** Path to a per-node quantity — see `GraphNode.weight`. */
+    weight?: string;
+    /** Path to a containment chain — see `GraphNode.path`. */
+    path?: string;
+    /** Separator when `path` resolves to a STRING rather than an array. Defaults to `/`. */
+    pathDelimiter?: string;
+    /** Path to an object of named quantities — see `GraphNode.measures`. */
+    measures?: string;
     rows?: string;
     note?: string;
     /** Row-level paths, read against each entry of the `rows` array. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rokkit/graph",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Node-link diagram components — pluggable layouts, ER/schema views",
   "repository": {
     "type": "git",
@@ -20,6 +20,11 @@
       "svelte": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./icons": {
+      "types": "./dist/icons.d.ts",
+      "svelte": "./dist/icons.js",
+      "default": "./dist/icons.js"
+    },
     "./schema": {
       "types": "./dist/schema/index.d.ts",
       "svelte": "./dist/schema/index.js",
@@ -41,10 +46,10 @@
     "check:types": "tsc --noEmit"
   },
   "dependencies": {
-    "@rokkit/core": "1.6.0"
+    "@rokkit/core": "1.7.0"
   },
   "peerDependencies": {
-    "@rokkit/ui": "1.6.0",
+    "@rokkit/ui": "1.7.0",
     "svelte": "^5.0.0"
   },
   "peerDependenciesMeta": {
@@ -53,7 +58,7 @@
     }
   },
   "devDependencies": {
-    "@rokkit/ui": "1.6.0",
+    "@rokkit/ui": "1.7.0",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "svelte": "^5.55.7",