@ankhorage/zora 22.0.82 → 22.1.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 22.1.1
+
+### Patch Changes
+
+- 903db75: Update dependencies: `@ankhorage/utility`.
+
+## 22.1.0
+
+### Minor Changes
+
+- 7439ab2: Expose rendered GraphView node measurements through the public controller so consumers can compare selected node geometry with the viewport without accessing the backing renderer.
+
 ## 22.0.82
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/zora
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v22.0.82](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v22.1.1](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
 
 Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.
 

package/dist/features/graph-view/adapters/inbound/web-artifact/createGraphController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createGraphController.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAGhF,kGAAkG;AAClG,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,IAAI,EACR,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAClC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI;;qBA8CjC,kBAAkB;gBASvB,OAAO;EAwBtB"}
+{"version":3,"file":"createGraphController.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAGhF,kGAAkG;AAClG,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,IAAI,EACR,aAAa,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAClC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI;;qBAiDjC,kBAAkB;gBASvB,OAAO;EAwBtB"}

package/dist/features/graph-view/adapters/inbound/web-artifact/createGraphController.js

@@ -22,6 +22,9 @@ export function createGraphController(cy, fitPaddingRef, optimizeFit) {
                 padding: options?.padding ?? fitPaddingRef.current,
             }, state.fitZoom);
         },
+        measureNodes(nodeIds) {
+            return measureRenderedNodes(cy, nodeIds);
+        },
         getViewport() {
             return { pan: cy.pan(), zoom: cy.zoom() / state.scale };
         },
@@ -76,6 +79,26 @@ export function createGraphController(cy, fitPaddingRef, optimizeFit) {
         },
     };
 }
+/*** Measure rendered node geometry for public consumers while keeping Cytoscape private. */
+function measureRenderedNodes(cy, nodeIds) {
+    const viewport = { width: cy.width(), height: cy.height() };
+    if (viewport.width <= 0 || viewport.height <= 0 || nodeIds.length === 0)
+        return null;
+    const nodes = [...new Set(nodeIds)].flatMap((id) => {
+        const node = cy.getElementById(id);
+        if (!node.isNode())
+            return [];
+        const bounds = node.renderedBoundingBox();
+        return [
+            {
+                id,
+                position: node.renderedPosition(),
+                size: { width: bounds.w, height: bounds.h },
+            },
+        ];
+    });
+    return nodes.length === 0 ? null : { nodes, viewport };
+}
 /*** Keep pointer, wheel, and programmatic zoom on the same limits in the engine's native units. */
 function applyZoomLimits(cy, state) {
     const min = state.min * state.scale;

package/dist/features/graph-view/adapters/inbound/web-artifact/createGraphController.js.map

@@ -1 +1 @@
-{"version":3,"file":"createGraphController.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphController.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CACnC,EAAQ,EACR,aAAkC,EAClC,WAAoD;IAEpD,MAAM,KAAK,GAAG;QACZ,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,CAAC;QACN,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,QAAQ;QACjB,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,QAAQ;KAClB,CAAC;IACF,MAAM,UAAU,GAAwB;QACtC,GAAG,CAAC,OAAO;YACT,IAAI,OAAO,EAAE,eAAe,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,CAAC;gBACxE,WAAW,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,gBAAgB,CACd,EAAE,EACF;gBACE,OAAO,EAAE,OAAO,EAAE,OAAO;gBACzB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,aAAa,CAAC,OAAO;aACnD,EACD,KAAK,CAAC,OAAO,CACd,CAAC;QACJ,CAAC;QACD,WAAW;YACT,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;QACD,YAAY;YACV,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9E,CAAC;QACD,MAAM,CAAC,GAAG;YACR,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;QACD,OAAO,CAAC,IAAI;YACV,eAAe,CAAC,EAAE,EAAE,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,MAAM;YACX,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;IAEF,OAAO;QACL,UAAU;QACV,SAAS,CAAC,KAAyB;YACjC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,cAAc,CAAC;YACnD,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;YAClC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAC/B,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC;YACjE,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;YAC9D,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YACrC,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,CAAC,GAAY;YACjB,MAAM,WAAW,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;YAC5C,MAAM,KAAK,GAAG,EAAE;iBACb,KAAK,EAAE;iBACP,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;iBAClE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;iBACjE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;YACvD,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM;gBAC/B,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;gBACzF,CAAC,CAAC,CAAC,CAAC;YACN,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM;gBAC1B,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7E,CAAC,CAAC,QAAQ,CAAC;YACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ;gBAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;gBACpE,CAAC,CAAC,CAAC,CAAC;YACN,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,GAAG;gBAAE,UAAU,CAAC,GAAG,EAAE,CAAC;iBACrB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACxB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/C,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,SAAS,eAAe,CACtB,EAAQ,EACR,KAKC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;IACpC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,wFAAwF;AACxF,SAAS,YAAY,CAAC,KAAyB,EAAE,QAAgB;IAC/D,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,EAAQ,EAAE,OAAe;IAC/C,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;IACvC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;IACzC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,SAAS,eAAe,CAAC,EAAQ,EAAE,IAAY;IAC7C,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC","sourcesContent":["import type { Core } from 'cytoscape';\n\nimport type { GraphViewController, GraphViewFitOptions } from '../../../../../types/graph-view';\nimport type { GraphRuntimeUpdate } from '../../../../../types/graphViewRuntime';\nimport { fitGraphViewport } from './fitGraphViewport';\n\n/*** Own viewport units and limits alongside the public controller, without exposing Cytoscape. */\nexport function createGraphController(\n  cy: Core,\n  fitPaddingRef: { current: number },\n  optimizeFit?: (options: GraphViewFitOptions) => void,\n) {\n  const state = {\n    scale: 1,\n    relative: false,\n    min: 0.05,\n    max: 2,\n    readableSize: 0,\n    fitSize: Infinity,\n    readableZoom: 0,\n    fitZoom: Infinity,\n  };\n  const controller: GraphViewController = {\n    fit(options) {\n      if (options?.optimizeSpacing && !options.nodeIds?.length && optimizeFit) {\n        optimizeFit(options);\n        return;\n      }\n      fitGraphViewport(\n        cy,\n        {\n          nodeIds: options?.nodeIds,\n          padding: options?.padding ?? fitPaddingRef.current,\n        },\n        state.fitZoom,\n      );\n    },\n    getViewport() {\n      return { pan: cy.pan(), zoom: cy.zoom() / state.scale };\n    },\n    getZoomRange() {\n      return { min: cy.minZoom() / state.scale, max: cy.maxZoom() / state.scale };\n    },\n    setPan(pan) {\n      cy.pan(pan);\n    },\n    setZoom(zoom) {\n      setCenteredZoom(cy, zoom * state.scale);\n    },\n    zoomBy(factor) {\n      setCenteredZoom(cy, cy.zoom() * factor);\n    },\n  };\n\n  return {\n    controller,\n    configure(input: GraphRuntimeUpdate) {\n      state.relative = input.zoomMode === 'fit-relative';\n      state.min = input.minZoom ?? 0.05;\n      state.max = input.maxZoom ?? 2;\n      state.readableSize = positiveSize(input.minReadableLabelSize, 0);\n      state.fitSize = positiveSize(input.maxFitLabelSize, Infinity);\n      if (!state.relative) state.scale = 1;\n      applyZoomLimits(cy, state);\n    },\n    settle(fit: boolean) {\n      const logicalZoom = cy.zoom() / state.scale;\n      const fonts = cy\n        .nodes()\n        .filter((node) => !node.isParent() && Boolean(node.style('label')))\n        .map((node) => Number.parseFloat(String(node.style('font-size'))))\n        .filter((size) => Number.isFinite(size) && size > 0);\n      state.readableZoom = fonts.length\n        ? state.readableSize / fonts.reduce((minimum, size) => Math.min(minimum, size), Infinity)\n        : 0;\n      state.fitZoom = fonts.length\n        ? state.fitSize / fonts.reduce((maximum, size) => Math.max(maximum, size), 0)\n        : Infinity;\n      state.scale = state.relative\n        ? Math.min(getNodeFitZoom(cy, fitPaddingRef.current), state.fitZoom)\n        : 1;\n      applyZoomLimits(cy, state);\n      if (fit) controller.fit();\n      else if (state.relative) {\n        setCenteredZoom(cy, logicalZoom * state.scale);\n        cy.center(cy.nodes());\n      }\n    },\n  };\n}\n\n/*** Keep pointer, wheel, and programmatic zoom on the same limits in the engine's native units. */\nfunction applyZoomLimits(\n  cy: Core,\n  state: {\n    readonly min: number;\n    readonly max: number;\n    readonly scale: number;\n    readonly readableZoom: number;\n  },\n) {\n  const min = state.min * state.scale;\n  cy.minZoom(Math.min(cy.minZoom(), min));\n  cy.maxZoom(Math.max(min, state.max * state.scale, state.readableZoom));\n  cy.minZoom(min);\n}\n\n/*** Ignore invalid optional typography targets at the public configuration boundary. */\nfunction positiveSize(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;\n}\n\n/***\n * Recompute the fit reference only after layout or resize, never on every pan/zoom event.\n * Cache the geometry-derived scale in the viewport owner; labels are included, edges excluded.\n */\nfunction getNodeFitZoom(cy: Core, padding: number): number {\n  if (cy.nodes().empty()) return 1;\n  const bounds = cy.nodes().boundingBox();\n  const width = cy.width() - 2 * padding;\n  const height = cy.height() - 2 * padding;\n  if (width <= 0 || height <= 0 || bounds.w <= 0 || bounds.h <= 0) return 1;\n  return Math.min(width / bounds.w, height / bounds.h);\n}\n\n/*** Zoom around the visible viewport center instead of its top-left corner. */\nfunction setCenteredZoom(cy: Core, zoom: number) {\n  cy.zoom({ level: zoom, renderedPosition: { x: cy.width() / 2, y: cy.height() / 2 } });\n}\n"]}
+{"version":3,"file":"createGraphController.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphController.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Core } from 'cytoscape';\n\nimport type {\n  GraphViewController,\n  GraphViewFitOptions,\n  GraphViewMeasurement,\n} from '../../../../../types/graph-view';\nimport type { GraphRuntimeUpdate } from '../../../../../types/graphViewRuntime';\nimport { fitGraphViewport } from './fitGraphViewport';\n\n/*** Own viewport units and limits alongside the public controller, without exposing Cytoscape. */\nexport function createGraphController(\n  cy: Core,\n  fitPaddingRef: { current: number },\n  optimizeFit?: (options: GraphViewFitOptions) => void,\n) {\n  const state = {\n    scale: 1,\n    relative: false,\n    min: 0.05,\n    max: 2,\n    readableSize: 0,\n    fitSize: Infinity,\n    readableZoom: 0,\n    fitZoom: Infinity,\n  };\n  const controller: GraphViewController = {\n    fit(options) {\n      if (options?.optimizeSpacing && !options.nodeIds?.length && optimizeFit) {\n        optimizeFit(options);\n        return;\n      }\n      fitGraphViewport(\n        cy,\n        {\n          nodeIds: options?.nodeIds,\n          padding: options?.padding ?? fitPaddingRef.current,\n        },\n        state.fitZoom,\n      );\n    },\n    measureNodes(nodeIds) {\n      return measureRenderedNodes(cy, nodeIds);\n    },\n    getViewport() {\n      return { pan: cy.pan(), zoom: cy.zoom() / state.scale };\n    },\n    getZoomRange() {\n      return { min: cy.minZoom() / state.scale, max: cy.maxZoom() / state.scale };\n    },\n    setPan(pan) {\n      cy.pan(pan);\n    },\n    setZoom(zoom) {\n      setCenteredZoom(cy, zoom * state.scale);\n    },\n    zoomBy(factor) {\n      setCenteredZoom(cy, cy.zoom() * factor);\n    },\n  };\n\n  return {\n    controller,\n    configure(input: GraphRuntimeUpdate) {\n      state.relative = input.zoomMode === 'fit-relative';\n      state.min = input.minZoom ?? 0.05;\n      state.max = input.maxZoom ?? 2;\n      state.readableSize = positiveSize(input.minReadableLabelSize, 0);\n      state.fitSize = positiveSize(input.maxFitLabelSize, Infinity);\n      if (!state.relative) state.scale = 1;\n      applyZoomLimits(cy, state);\n    },\n    settle(fit: boolean) {\n      const logicalZoom = cy.zoom() / state.scale;\n      const fonts = cy\n        .nodes()\n        .filter((node) => !node.isParent() && Boolean(node.style('label')))\n        .map((node) => Number.parseFloat(String(node.style('font-size'))))\n        .filter((size) => Number.isFinite(size) && size > 0);\n      state.readableZoom = fonts.length\n        ? state.readableSize / fonts.reduce((minimum, size) => Math.min(minimum, size), Infinity)\n        : 0;\n      state.fitZoom = fonts.length\n        ? state.fitSize / fonts.reduce((maximum, size) => Math.max(maximum, size), 0)\n        : Infinity;\n      state.scale = state.relative\n        ? Math.min(getNodeFitZoom(cy, fitPaddingRef.current), state.fitZoom)\n        : 1;\n      applyZoomLimits(cy, state);\n      if (fit) controller.fit();\n      else if (state.relative) {\n        setCenteredZoom(cy, logicalZoom * state.scale);\n        cy.center(cy.nodes());\n      }\n    },\n  };\n}\n\n/*** Measure rendered node geometry for public consumers while keeping Cytoscape private. */\nfunction measureRenderedNodes(cy: Core, nodeIds: readonly string[]): GraphViewMeasurement | null {\n  const viewport = { width: cy.width(), height: cy.height() };\n  if (viewport.width <= 0 || viewport.height <= 0 || nodeIds.length === 0) return null;\n\n  const nodes = [...new Set(nodeIds)].flatMap((id) => {\n    const node = cy.getElementById(id);\n    if (!node.isNode()) return [];\n\n    const bounds = node.renderedBoundingBox();\n    return [\n      {\n        id,\n        position: node.renderedPosition(),\n        size: { width: bounds.w, height: bounds.h },\n      },\n    ];\n  });\n  return nodes.length === 0 ? null : { nodes, viewport };\n}\n\n/*** Keep pointer, wheel, and programmatic zoom on the same limits in the engine's native units. */\nfunction applyZoomLimits(\n  cy: Core,\n  state: {\n    readonly min: number;\n    readonly max: number;\n    readonly scale: number;\n    readonly readableZoom: number;\n  },\n) {\n  const min = state.min * state.scale;\n  cy.minZoom(Math.min(cy.minZoom(), min));\n  cy.maxZoom(Math.max(min, state.max * state.scale, state.readableZoom));\n  cy.minZoom(min);\n}\n\n/*** Ignore invalid optional typography targets at the public configuration boundary. */\nfunction positiveSize(value: number | undefined, fallback: number): number {\n  return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;\n}\n\n/***\n * Recompute the fit reference only after layout or resize, never on every pan/zoom event.\n * Cache the geometry-derived scale in the viewport owner; labels are included, edges excluded.\n */\nfunction getNodeFitZoom(cy: Core, padding: number): number {\n  if (cy.nodes().empty()) return 1;\n  const bounds = cy.nodes().boundingBox();\n  const width = cy.width() - 2 * padding;\n  const height = cy.height() - 2 * padding;\n  if (width <= 0 || height <= 0 || bounds.w <= 0 || bounds.h <= 0) return 1;\n  return Math.min(width / bounds.w, height / bounds.h);\n}\n\n/*** Zoom around the visible viewport center instead of its top-left corner. */\nfunction setCenteredZoom(cy: Core, zoom: number) {\n  cy.zoom({ level: zoom, renderedPosition: { x: cy.width() / 2, y: cy.height() / 2 } });\n}\n"]}

package/dist/features/graph-view/public.d.ts

@@ -1,3 +1,3 @@
-export type { GraphViewCallbacks, GraphViewController, GraphViewEdge, GraphViewElementEvent, GraphViewElementEventType, GraphViewFitOptions, GraphViewLayoutName, GraphViewNode, GraphViewNodeRenderContext, GraphViewPoint, GraphViewProps, GraphViewRenderedNode, GraphViewSize, GraphViewStyleRule, GraphViewViewport, } from '../../types/graph-view';
+export type { GraphViewCallbacks, GraphViewController, GraphViewEdge, GraphViewElementEvent, GraphViewElementEventType, GraphViewFitOptions, GraphViewLayoutName, GraphViewMeasurement, GraphViewNode, GraphViewNodeMeasurement, GraphViewNodeRenderContext, GraphViewPoint, GraphViewProps, GraphViewRenderedNode, GraphViewSize, GraphViewStyleRule, GraphViewViewport, } from '../../types/graph-view';
 export { GraphView } from './adapters/inbound/web-artifact/GraphView';
 //# sourceMappingURL=public.d.ts.map

package/dist/features/graph-view/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/graph-view/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/features/graph-view/public.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACxB,0BAA0B,EAC1B,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/features/graph-view/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/graph-view/public.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC","sourcesContent":["export type {\n  GraphViewCallbacks,\n  GraphViewController,\n  GraphViewEdge,\n  GraphViewElementEvent,\n  GraphViewElementEventType,\n  GraphViewFitOptions,\n  GraphViewLayoutName,\n  GraphViewNode,\n  GraphViewNodeRenderContext,\n  GraphViewPoint,\n  GraphViewProps,\n  GraphViewRenderedNode,\n  GraphViewSize,\n  GraphViewStyleRule,\n  GraphViewViewport,\n} from '../../types/graph-view';\nexport { GraphView } from './adapters/inbound/web-artifact/GraphView';\n"]}
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/features/graph-view/public.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC","sourcesContent":["export type {\n  GraphViewCallbacks,\n  GraphViewController,\n  GraphViewEdge,\n  GraphViewElementEvent,\n  GraphViewElementEventType,\n  GraphViewFitOptions,\n  GraphViewLayoutName,\n  GraphViewMeasurement,\n  GraphViewNode,\n  GraphViewNodeMeasurement,\n  GraphViewNodeRenderContext,\n  GraphViewPoint,\n  GraphViewProps,\n  GraphViewRenderedNode,\n  GraphViewSize,\n  GraphViewStyleRule,\n  GraphViewViewport,\n} from '../../types/graph-view';\nexport { GraphView } from './adapters/inbound/web-artifact/GraphView';\n"]}

package/dist/types/graph-view.d.ts

@@ -40,6 +40,15 @@ export interface GraphViewRenderedNode {
     readonly selected: boolean;
     readonly zoom: number;
 }
+export interface GraphViewNodeMeasurement {
+    readonly id: string;
+    readonly position: GraphViewPoint;
+    readonly size: GraphViewSize;
+}
+export interface GraphViewMeasurement {
+    readonly nodes: readonly GraphViewNodeMeasurement[];
+    readonly viewport: GraphViewSize;
+}
 export interface GraphViewViewport {
     readonly zoom: number;
     readonly pan: GraphViewPoint;
@@ -56,6 +65,8 @@ export interface GraphViewElementEvent {
 }
 export interface GraphViewController {
     fit(options?: GraphViewFitOptions): void;
+    /** Measure rendered node geometry without exposing the backing graph engine. */
+    measureNodes?(nodeIds: readonly string[]): GraphViewMeasurement | null;
     getViewport(): GraphViewViewport;
     getZoomRange(): {
         readonly min: number;

package/dist/types/graph-view.d.ts.map

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

package/dist/types/graph-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-view.js","sourceRoot":"","sources":["../../src/types/graph-view.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nexport type GraphViewLayoutName = 'breadthfirst' | 'circle' | 'concentric' | 'elk' | 'grid';\nexport type GraphViewElementEventType =\n  'press' | 'double-press' | 'select' | 'unselect' | 'pointer-enter' | 'pointer-leave';\n\nexport interface GraphViewNode {\n  readonly id: string;\n  readonly label?: string;\n  readonly parentId?: string;\n  readonly classes?: string;\n  readonly data?: Readonly<Record<string, unknown>>;\n}\n\nexport interface GraphViewEdge {\n  readonly id?: string;\n  readonly source: string;\n  readonly target: string;\n  readonly classes?: string;\n  readonly data?: Readonly<Record<string, unknown>>;\n}\n\nexport interface GraphViewStyleRule {\n  readonly selector: string;\n  readonly style: Readonly<Record<string, unknown>>;\n}\n\nexport interface GraphViewPoint {\n  readonly x: number;\n  readonly y: number;\n}\n\nexport interface GraphViewSize {\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface GraphViewNodeRenderContext {\n  readonly hovered: boolean;\n  readonly node: GraphViewNode;\n  readonly selected: boolean;\n  readonly zoom: number;\n}\n\nexport interface GraphViewRenderedNode {\n  readonly hovered: boolean;\n  readonly id: string;\n  readonly position: GraphViewPoint;\n  readonly selected: boolean;\n  readonly zoom: number;\n}\n\nexport interface GraphViewViewport {\n  readonly zoom: number;\n  readonly pan: GraphViewPoint;\n}\n\nexport interface GraphViewFitOptions {\n  /** Optimize existing layout spacing without rerunning its algorithm; whole-graph fits only. */\n  readonly optimizeSpacing?: boolean;\n  readonly nodeIds?: readonly string[];\n  readonly padding?: number;\n}\n\nexport interface GraphViewElementEvent {\n  readonly id: string;\n  readonly type: GraphViewElementEventType;\n}\n\nexport interface GraphViewController {\n  fit(options?: GraphViewFitOptions): void;\n  getViewport(): GraphViewViewport;\n  getZoomRange(): { readonly min: number; readonly max: number };\n  setPan(pan: GraphViewPoint): void;\n  setZoom(zoom: number): void;\n  zoomBy(factor: number): void;\n}\n\nexport interface GraphViewProps {\n  readonly nodes: readonly GraphViewNode[];\n  readonly edges: readonly GraphViewEdge[];\n  readonly layout?: GraphViewLayoutName;\n  readonly layoutOptions?: Readonly<Record<string, unknown>>;\n  readonly spacingFactor?: number;\n  readonly styleRules?: readonly GraphViewStyleRule[];\n  readonly selectedNodeIds?: readonly string[];\n  readonly renderNode?: (context: GraphViewNodeRenderContext) => React.ReactNode;\n  readonly getNodeSize?: (node: GraphViewNode) => GraphViewSize | undefined;\n  readonly fitPadding?: number;\n  readonly minZoom?: number;\n  readonly maxZoom?: number;\n  readonly minReadableLabelSize?: number;\n  readonly maxFitLabelSize?: number;\n  /** Zoom values and bounds use the full-node fit as 1 when fit-relative is selected. */\n  readonly zoomMode?: 'absolute' | 'fit-relative';\n  /** Measure plain labels before layout instead of estimating width from character count. */\n  readonly sizeNodesToLabels?: boolean;\n  readonly className?: string;\n  readonly style?: React.CSSProperties;\n  readonly ariaLabel?: string;\n  readonly onReady?: (controller: GraphViewController) => void;\n  readonly onLayoutComplete?: (controller: GraphViewController) => void;\n  readonly onNodeEvent?: (event: GraphViewElementEvent) => void;\n  readonly onEdgeEvent?: (event: GraphViewElementEvent) => void;\n  readonly onViewportChange?: (viewport: GraphViewViewport) => void;\n  readonly onSpacingFactorChange?: (spacingFactor: number) => void;\n}\n\nexport type GraphViewCallbacks = Pick<\n  GraphViewProps,\n  | 'onEdgeEvent'\n  | 'onLayoutComplete'\n  | 'onNodeEvent'\n  | 'onReady'\n  | 'onViewportChange'\n  | 'onSpacingFactorChange'\n>;\n"]}
+{"version":3,"file":"graph-view.js","sourceRoot":"","sources":["../../src/types/graph-view.ts"],"names":[],"mappings":"","sourcesContent":["import type React from 'react';\n\nexport type GraphViewLayoutName = 'breadthfirst' | 'circle' | 'concentric' | 'elk' | 'grid';\nexport type GraphViewElementEventType =\n  'press' | 'double-press' | 'select' | 'unselect' | 'pointer-enter' | 'pointer-leave';\n\nexport interface GraphViewNode {\n  readonly id: string;\n  readonly label?: string;\n  readonly parentId?: string;\n  readonly classes?: string;\n  readonly data?: Readonly<Record<string, unknown>>;\n}\n\nexport interface GraphViewEdge {\n  readonly id?: string;\n  readonly source: string;\n  readonly target: string;\n  readonly classes?: string;\n  readonly data?: Readonly<Record<string, unknown>>;\n}\n\nexport interface GraphViewStyleRule {\n  readonly selector: string;\n  readonly style: Readonly<Record<string, unknown>>;\n}\n\nexport interface GraphViewPoint {\n  readonly x: number;\n  readonly y: number;\n}\n\nexport interface GraphViewSize {\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface GraphViewNodeRenderContext {\n  readonly hovered: boolean;\n  readonly node: GraphViewNode;\n  readonly selected: boolean;\n  readonly zoom: number;\n}\n\nexport interface GraphViewRenderedNode {\n  readonly hovered: boolean;\n  readonly id: string;\n  readonly position: GraphViewPoint;\n  readonly selected: boolean;\n  readonly zoom: number;\n}\n\nexport interface GraphViewNodeMeasurement {\n  readonly id: string;\n  readonly position: GraphViewPoint;\n  readonly size: GraphViewSize;\n}\n\nexport interface GraphViewMeasurement {\n  readonly nodes: readonly GraphViewNodeMeasurement[];\n  readonly viewport: GraphViewSize;\n}\n\nexport interface GraphViewViewport {\n  readonly zoom: number;\n  readonly pan: GraphViewPoint;\n}\n\nexport interface GraphViewFitOptions {\n  /** Optimize existing layout spacing without rerunning its algorithm; whole-graph fits only. */\n  readonly optimizeSpacing?: boolean;\n  readonly nodeIds?: readonly string[];\n  readonly padding?: number;\n}\n\nexport interface GraphViewElementEvent {\n  readonly id: string;\n  readonly type: GraphViewElementEventType;\n}\n\nexport interface GraphViewController {\n  fit(options?: GraphViewFitOptions): void;\n  /** Measure rendered node geometry without exposing the backing graph engine. */\n  measureNodes?(nodeIds: readonly string[]): GraphViewMeasurement | null;\n  getViewport(): GraphViewViewport;\n  getZoomRange(): { readonly min: number; readonly max: number };\n  setPan(pan: GraphViewPoint): void;\n  setZoom(zoom: number): void;\n  zoomBy(factor: number): void;\n}\n\nexport interface GraphViewProps {\n  readonly nodes: readonly GraphViewNode[];\n  readonly edges: readonly GraphViewEdge[];\n  readonly layout?: GraphViewLayoutName;\n  readonly layoutOptions?: Readonly<Record<string, unknown>>;\n  readonly spacingFactor?: number;\n  readonly styleRules?: readonly GraphViewStyleRule[];\n  readonly selectedNodeIds?: readonly string[];\n  readonly renderNode?: (context: GraphViewNodeRenderContext) => React.ReactNode;\n  readonly getNodeSize?: (node: GraphViewNode) => GraphViewSize | undefined;\n  readonly fitPadding?: number;\n  readonly minZoom?: number;\n  readonly maxZoom?: number;\n  readonly minReadableLabelSize?: number;\n  readonly maxFitLabelSize?: number;\n  /** Zoom values and bounds use the full-node fit as 1 when fit-relative is selected. */\n  readonly zoomMode?: 'absolute' | 'fit-relative';\n  /** Measure plain labels before layout instead of estimating width from character count. */\n  readonly sizeNodesToLabels?: boolean;\n  readonly className?: string;\n  readonly style?: React.CSSProperties;\n  readonly ariaLabel?: string;\n  readonly onReady?: (controller: GraphViewController) => void;\n  readonly onLayoutComplete?: (controller: GraphViewController) => void;\n  readonly onNodeEvent?: (event: GraphViewElementEvent) => void;\n  readonly onEdgeEvent?: (event: GraphViewElementEvent) => void;\n  readonly onViewportChange?: (viewport: GraphViewViewport) => void;\n  readonly onSpacingFactorChange?: (spacingFactor: number) => void;\n}\n\nexport type GraphViewCallbacks = Pick<\n  GraphViewProps,\n  | 'onEdgeEvent'\n  | 'onLayoutComplete'\n  | 'onNodeEvent'\n  | 'onReady'\n  | 'onViewportChange'\n  | 'onSpacingFactorChange'\n>;\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/zora",
   "type": "module",
-  "version": "22.0.82",
+  "version": "22.1.1",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -45,7 +45,7 @@
     "@ankhorage/game": "^0.1.2",
     "@ankhorage/runtime": "^3.0.59",
     "@ankhorage/surface": "^9.1.112",
-    "@ankhorage/utility": "^1.9.82",
+    "@ankhorage/utility": "^1.9.83",
     "expo-document-picker": "~57.0.3",
     "expo-image-picker": "~57.0.20",
     "chess.js": "^1.4.0"
@@ -124,7 +124,7 @@
     "version-packages": "ankhorage-changeset version"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^2.1.6",
+    "@ankhorage/devtools": "^2.1.7",
     "@ankhorage/paradox": "^0.2.27",
     "@react-native-vector-icons/fontawesome": "^13.1.4",
     "@react-native-vector-icons/fontawesome5": "^13.1.4",

package/src/features/graph-view/adapters/inbound/web-artifact/createGraphController.test.ts

@@ -105,3 +105,42 @@ test('caps automatic label size for tiny graphs and expands manual zoom for larg
     cy.destroy();
   }
 });
+
+test('measures requested rendered nodes without exposing Cytoscape', () => {
+  const cy = cytoscape({
+    headless: true,
+    styleEnabled: true,
+    layout: { name: 'preset' },
+    elements: [
+      { data: { id: 'a' }, position: { x: 40, y: 60 } },
+      { data: { id: 'b' }, position: { x: 240, y: 180 } },
+    ],
+    style: [{ selector: 'node', style: { width: 40, height: 30 } }],
+  });
+  cy.width = () => 800;
+  cy.height = () => 600;
+  const { controller } = createGraphController(cy, { current: 50 });
+
+  try {
+    const measurement = controller.measureNodes?.(['a', 'missing']);
+    const node = cy.getElementById('a');
+    const bounds = node.renderedBoundingBox();
+
+    expect(measurement).toEqual({
+      viewport: { width: 800, height: 600 },
+      nodes: [
+        {
+          id: 'a',
+          position: node.renderedPosition(),
+          size: { width: bounds.w, height: bounds.h },
+        },
+      ],
+    });
+    expect(controller.measureNodes?.([])).toBeNull();
+
+    cy.width = () => 0;
+    expect(controller.measureNodes?.(['a'])).toBeNull();
+  } finally {
+    cy.destroy();
+  }
+});

package/src/features/graph-view/adapters/inbound/web-artifact/createGraphController.ts

@@ -1,6 +1,10 @@
 import type { Core } from 'cytoscape';
 
-import type { GraphViewController, GraphViewFitOptions } from '../../../../../types/graph-view';
+import type {
+  GraphViewController,
+  GraphViewFitOptions,
+  GraphViewMeasurement,
+} from '../../../../../types/graph-view';
 import type { GraphRuntimeUpdate } from '../../../../../types/graphViewRuntime';
 import { fitGraphViewport } from './fitGraphViewport';
 
@@ -35,6 +39,9 @@ export function createGraphController(
         state.fitZoom,
       );
     },
+    measureNodes(nodeIds) {
+      return measureRenderedNodes(cy, nodeIds);
+    },
     getViewport() {
       return { pan: cy.pan(), zoom: cy.zoom() / state.scale };
     },
@@ -89,6 +96,27 @@ export function createGraphController(
   };
 }
 
+/*** Measure rendered node geometry for public consumers while keeping Cytoscape private. */
+function measureRenderedNodes(cy: Core, nodeIds: readonly string[]): GraphViewMeasurement | null {
+  const viewport = { width: cy.width(), height: cy.height() };
+  if (viewport.width <= 0 || viewport.height <= 0 || nodeIds.length === 0) return null;
+
+  const nodes = [...new Set(nodeIds)].flatMap((id) => {
+    const node = cy.getElementById(id);
+    if (!node.isNode()) return [];
+
+    const bounds = node.renderedBoundingBox();
+    return [
+      {
+        id,
+        position: node.renderedPosition(),
+        size: { width: bounds.w, height: bounds.h },
+      },
+    ];
+  });
+  return nodes.length === 0 ? null : { nodes, viewport };
+}
+
 /*** Keep pointer, wheel, and programmatic zoom on the same limits in the engine's native units. */
 function applyZoomLimits(
   cy: Core,

package/src/features/graph-view/public.ts

@@ -6,7 +6,9 @@ export type {
   GraphViewElementEventType,
   GraphViewFitOptions,
   GraphViewLayoutName,
+  GraphViewMeasurement,
   GraphViewNode,
+  GraphViewNodeMeasurement,
   GraphViewNodeRenderContext,
   GraphViewPoint,
   GraphViewProps,

package/src/types/graph-view.ts

@@ -50,6 +50,17 @@ export interface GraphViewRenderedNode {
   readonly zoom: number;
 }
 
+export interface GraphViewNodeMeasurement {
+  readonly id: string;
+  readonly position: GraphViewPoint;
+  readonly size: GraphViewSize;
+}
+
+export interface GraphViewMeasurement {
+  readonly nodes: readonly GraphViewNodeMeasurement[];
+  readonly viewport: GraphViewSize;
+}
+
 export interface GraphViewViewport {
   readonly zoom: number;
   readonly pan: GraphViewPoint;
@@ -69,6 +80,8 @@ export interface GraphViewElementEvent {
 
 export interface GraphViewController {
   fit(options?: GraphViewFitOptions): void;
+  /** Measure rendered node geometry without exposing the backing graph engine. */
+  measureNodes?(nodeIds: readonly string[]): GraphViewMeasurement | null;
   getViewport(): GraphViewViewport;
   getZoomRange(): { readonly min: number; readonly max: number };
   setPan(pan: GraphViewPoint): void;

package/web-dist/components/graph-view/GraphView.d.ts

@@ -16,4 +16,4 @@ import type { GraphViewProps } from './GraphView.types-0';
  * cramped layouts but cannot repair non-uniform overlaps.
  */
 export declare function GraphView(props: GraphViewProps): React.JSX.Element;
-export type { GraphViewCallbacks, GraphViewController, GraphViewEdge, GraphViewElementEvent, GraphViewElementEventType, GraphViewFitOptions, GraphViewLayoutName, GraphViewNode, GraphViewNodeRenderContext, GraphViewPoint, GraphViewProps, GraphViewRenderedNode, GraphViewSize, GraphViewStyleRule, GraphViewViewport } from './GraphView.types-0';
+export type { GraphViewCallbacks, GraphViewController, GraphViewEdge, GraphViewElementEvent, GraphViewElementEventType, GraphViewFitOptions, GraphViewLayoutName, GraphViewMeasurement, GraphViewNode, GraphViewNodeMeasurement, GraphViewNodeRenderContext, GraphViewPoint, GraphViewProps, GraphViewRenderedNode, GraphViewSize, GraphViewStyleRule, GraphViewViewport } from './GraphView.types-0';

package/web-dist/components/graph-view/GraphView.js

@@ -122630,6 +122630,9 @@ function createGraphController(cy, fitPaddingRef, optimizeFit) {
         padding: options?.padding ?? fitPaddingRef.current
       }, state.fitZoom);
     },
+    measureNodes(nodeIds) {
+      return measureRenderedNodes(cy, nodeIds);
+    },
     getViewport() {
       return { pan: cy.pan(), zoom: cy.zoom() / state.scale };
     },
@@ -122674,6 +122677,25 @@ function createGraphController(cy, fitPaddingRef, optimizeFit) {
     }
   };
 }
+function measureRenderedNodes(cy, nodeIds) {
+  const viewport = { width: cy.width(), height: cy.height() };
+  if (viewport.width <= 0 || viewport.height <= 0 || nodeIds.length === 0)
+    return null;
+  const nodes = [...new Set(nodeIds)].flatMap((id) => {
+    const node = cy.getElementById(id);
+    if (!node.isNode())
+      return [];
+    const bounds = node.renderedBoundingBox();
+    return [
+      {
+        id,
+        position: node.renderedPosition(),
+        size: { width: bounds.w, height: bounds.h }
+      }
+    ];
+  });
+  return nodes.length === 0 ? null : { nodes, viewport };
+}
 function applyZoomLimits(cy, state) {
   const min = state.min * state.scale;
   cy.minZoom(Math.min(cy.minZoom(), min));

package/web-dist/components/graph-view/GraphView.types-0.d.ts

@@ -40,6 +40,15 @@ export interface GraphViewRenderedNode {
     readonly selected: boolean;
     readonly zoom: number;
 }
+export interface GraphViewNodeMeasurement {
+    readonly id: string;
+    readonly position: GraphViewPoint;
+    readonly size: GraphViewSize;
+}
+export interface GraphViewMeasurement {
+    readonly nodes: readonly GraphViewNodeMeasurement[];
+    readonly viewport: GraphViewSize;
+}
 export interface GraphViewViewport {
     readonly zoom: number;
     readonly pan: GraphViewPoint;
@@ -56,6 +65,8 @@ export interface GraphViewElementEvent {
 }
 export interface GraphViewController {
     fit(options?: GraphViewFitOptions): void;
+    /** Measure rendered node geometry without exposing the backing graph engine. */
+    measureNodes?(nodeIds: readonly string[]): GraphViewMeasurement | null;
     getViewport(): GraphViewViewport;
     getZoomRange(): {
         readonly min: number;