@ankhorage/zora 22.0.81 → 22.1.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 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
+
+- 37b8d04: Reveal controlled TreeView selections in standalone web artifacts without changing expansion ownership.
+
 ## 22.0.81
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/zora
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v22.0.81](././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.0](././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":"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","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/features/tree-view/adapters/inbound/web-artifact/TreeView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../../../src/features/tree-view/adapters/inbound/web-artifact/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,WAAW,YAAY,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IACvD,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IAC9D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,KAAK,IAAI,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC3E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EAAE,EACpD,KAAK,EACL,UAAU,EACV,WAAW,EAAE,qBAAqB,EAClC,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,kBAA6B,EAC7B,SAAS,EACT,KAAK,EACL,SAAkB,GACnB,EAAE,aAAa,CAAC,GAAG,CAAC,qBAqCpB"}
+{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../../../../../src/features/tree-view/adapters/inbound/web-artifact/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,WAAW,YAAY,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IACvD,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IAC9D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,EAAE,KAAK,IAAI,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC3E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,EAAE,EACpD,KAAK,EACL,UAAU,EACV,WAAW,EAAE,qBAAqB,EAClC,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,kBAA6B,EAC7B,SAAS,EACT,KAAK,EACL,SAAkB,GACnB,EAAE,aAAa,CAAC,GAAG,CAAC,qBAwCpB"}

package/dist/features/tree-view/adapters/inbound/web-artifact/TreeView.js

@@ -8,6 +8,7 @@ import { TreeItemRow } from './TreeItemRow';
  */
 export function TreeView({ nodes, selectedId, expandedIds: controlledExpandedIds, defaultExpandedIds, onSelect, onExpandedChange, renderItem, expansionIndicator = 'folder', className, style, ariaLabel = 'Tree', }) {
     const [internalExpandedIds, setInternalExpandedIds] = React.useState(defaultExpandedIds ?? []);
+    const rootRef = React.useRef(null);
     const isControlled = controlledExpandedIds !== undefined;
     const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;
     const handleToggleExpand = React.useCallback((id) => {
@@ -16,10 +17,22 @@ export function TreeView({ nodes, selectedId, expandedIds: controlledExpandedIds
             setInternalExpandedIds(nextExpandedIds);
         onExpandedChange?.(nextExpandedIds);
     }, [expandedIds, isControlled, onExpandedChange]);
-    return (<div aria-label={ariaLabel} className={className} role="tree" style={{ ...TREE_STYLE, ...style }}>
+    useSelectedTreeItemReveal(rootRef, selectedId, expandedIds);
+    return (<div ref={rootRef} aria-label={ariaLabel} className={className} role="tree" style={{ ...TREE_STYLE, ...style }}>
       {nodes.map((node) => (<TreeItemRow key={node.id} depth={0} expandedIds={expandedIds} expansionIndicator={expansionIndicator} node={node} onSelect={onSelect} onToggleExpand={handleToggleExpand} renderItem={renderItem} selectedId={selectedId}/>))}
     </div>);
 }
+/*** Reveal a controlled selection after it is rendered without changing expansion ownership. */
+function useSelectedTreeItemReveal(rootRef, selectedId, expandedIds) {
+    React.useEffect(() => {
+        if (selectedId === undefined)
+            return;
+        const root = rootRef.current;
+        root
+            ?.querySelector('[role="treeitem"][aria-selected="true"]')
+            ?.scrollIntoView({ block: 'nearest', inline: 'nearest' });
+    }, [expandedIds, rootRef, selectedId]);
+}
 const TREE_STYLE = {
     display: 'flex',
     flexDirection: 'column',

package/dist/features/tree-view/adapters/inbound/web-artifact/TreeView.js.map

@@ -1 +1 @@
-{"version":3,"file":"TreeView.js","sourceRoot":"","sources":["../../../../../../src/features/tree-view/adapters/inbound/web-artifact/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAkC5C;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAA8B,EACpD,KAAK,EACL,UAAU,EACV,WAAW,EAAE,qBAAqB,EAClC,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,kBAAkB,GAAG,QAAQ,EAC7B,SAAS,EACT,KAAK,EACL,SAAS,GAAG,MAAM,GACC;IACnB,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAClE,kBAAkB,IAAI,EAAE,CACzB,CAAC;IACF,MAAM,YAAY,GAAG,qBAAqB,KAAK,SAAS,CAAC;IACzD,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAC/E,MAAM,kBAAkB,GAAG,KAAK,CAAC,WAAW,CAC1C,CAAC,EAAO,EAAE,EAAE;QACV,MAAM,eAAe,GAAG,iBAAiB,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,YAAY;YAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;QAC3D,gBAAgB,EAAE,CAAC,eAAe,CAAC,CAAC;IACtC,CAAC,EACD,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAC9C,CAAC;IAEF,OAAO,CACL,CAAC,GAAG,CACF,UAAU,CAAC,CAAC,SAAS,CAAC,CACtB,SAAS,CAAC,CAAC,SAAS,CAAC,CACrB,IAAI,CAAC,MAAM,CACX,KAAK,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,EAAE,CAAC,CAEnC;MAAA,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,CAAC,WAAW,CACV,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACb,KAAK,CAAC,CAAC,CAAC,CAAC,CACT,WAAW,CAAC,CAAC,WAAW,CAAC,CACzB,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CACvC,IAAI,CAAC,CAAC,IAAI,CAAC,CACX,QAAQ,CAAC,CAAC,QAAQ,CAAC,CACnB,cAAc,CAAC,CAAC,kBAAkB,CAAC,CACnC,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,UAAU,CAAC,CAAC,UAAU,CAAC,EACvB,CACH,CAAC,CACJ;IAAA,EAAE,GAAG,CAAC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,QAAQ,EAAE,CAAC;CAC2B,CAAC","sourcesContent":["import React from 'react';\n\nimport { toggleExpandedIds } from '../../../utils/toggleExpandedIds';\nimport { TreeItemRow } from './TreeItemRow';\n\nexport interface TreeItemNode<TId extends string = string> {\n  readonly id: TId;\n  readonly label: React.ReactNode;\n  readonly icon?: React.ReactNode;\n  readonly children?: readonly TreeItemNode<TId>[];\n  readonly disabled?: boolean;\n  readonly meta?: React.ReactNode;\n  readonly actions?: React.ReactNode;\n}\n\nexport interface TreeItemRenderProps<TId extends string = string> {\n  readonly node: TreeItemNode<TId>;\n  readonly depth: number;\n  readonly selected: boolean;\n  readonly expanded: boolean;\n  readonly hasChildren: boolean;\n}\n\nexport interface TreeViewProps<TId extends string = string> {\n  readonly nodes: readonly TreeItemNode<TId>[];\n  readonly selectedId?: TId;\n  readonly expandedIds?: readonly TId[];\n  readonly defaultExpandedIds?: readonly TId[];\n  readonly onSelect?: (id: TId) => void;\n  readonly onExpandedChange?: (ids: readonly TId[]) => void;\n  readonly renderItem?: (props: TreeItemRenderProps<TId>) => React.ReactNode;\n  readonly expansionIndicator?: 'chevron' | 'folder';\n  readonly className?: string;\n  readonly style?: React.CSSProperties;\n  readonly ariaLabel?: string;\n}\n\n/***\n * Render the standalone browser TreeView artifact without React Native runtime dependencies.\n * expansionIndicator Use `chevron` beside custom node icons, or `folder` (default) for\n * built-in folder/file indicators. Expansion is leading and independent from row selection.\n */\nexport function TreeView<TId extends string = string>({\n  nodes,\n  selectedId,\n  expandedIds: controlledExpandedIds,\n  defaultExpandedIds,\n  onSelect,\n  onExpandedChange,\n  renderItem,\n  expansionIndicator = 'folder',\n  className,\n  style,\n  ariaLabel = 'Tree',\n}: TreeViewProps<TId>) {\n  const [internalExpandedIds, setInternalExpandedIds] = React.useState<readonly TId[]>(\n    defaultExpandedIds ?? [],\n  );\n  const isControlled = controlledExpandedIds !== undefined;\n  const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;\n  const handleToggleExpand = React.useCallback(\n    (id: TId) => {\n      const nextExpandedIds = toggleExpandedIds(expandedIds, id);\n      if (!isControlled) setInternalExpandedIds(nextExpandedIds);\n      onExpandedChange?.(nextExpandedIds);\n    },\n    [expandedIds, isControlled, onExpandedChange],\n  );\n\n  return (\n    <div\n      aria-label={ariaLabel}\n      className={className}\n      role=\"tree\"\n      style={{ ...TREE_STYLE, ...style }}\n    >\n      {nodes.map((node) => (\n        <TreeItemRow\n          key={node.id}\n          depth={0}\n          expandedIds={expandedIds}\n          expansionIndicator={expansionIndicator}\n          node={node}\n          onSelect={onSelect}\n          onToggleExpand={handleToggleExpand}\n          renderItem={renderItem}\n          selectedId={selectedId}\n        />\n      ))}\n    </div>\n  );\n}\n\nconst TREE_STYLE = {\n  display: 'flex',\n  flexDirection: 'column',\n  minWidth: 0,\n} as const satisfies React.CSSProperties;\n"]}
+{"version":3,"file":"TreeView.js","sourceRoot":"","sources":["../../../../../../src/features/tree-view/adapters/inbound/web-artifact/TreeView.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\n\nimport { toggleExpandedIds } from '../../../utils/toggleExpandedIds';\nimport { TreeItemRow } from './TreeItemRow';\n\nexport interface TreeItemNode<TId extends string = string> {\n  readonly id: TId;\n  readonly label: React.ReactNode;\n  readonly icon?: React.ReactNode;\n  readonly children?: readonly TreeItemNode<TId>[];\n  readonly disabled?: boolean;\n  readonly meta?: React.ReactNode;\n  readonly actions?: React.ReactNode;\n}\n\nexport interface TreeItemRenderProps<TId extends string = string> {\n  readonly node: TreeItemNode<TId>;\n  readonly depth: number;\n  readonly selected: boolean;\n  readonly expanded: boolean;\n  readonly hasChildren: boolean;\n}\n\nexport interface TreeViewProps<TId extends string = string> {\n  readonly nodes: readonly TreeItemNode<TId>[];\n  readonly selectedId?: TId;\n  readonly expandedIds?: readonly TId[];\n  readonly defaultExpandedIds?: readonly TId[];\n  readonly onSelect?: (id: TId) => void;\n  readonly onExpandedChange?: (ids: readonly TId[]) => void;\n  readonly renderItem?: (props: TreeItemRenderProps<TId>) => React.ReactNode;\n  readonly expansionIndicator?: 'chevron' | 'folder';\n  readonly className?: string;\n  readonly style?: React.CSSProperties;\n  readonly ariaLabel?: string;\n}\n\n/***\n * Render the standalone browser TreeView artifact without React Native runtime dependencies.\n * expansionIndicator Use `chevron` beside custom node icons, or `folder` (default) for\n * built-in folder/file indicators. Expansion is leading and independent from row selection.\n */\nexport function TreeView<TId extends string = string>({\n  nodes,\n  selectedId,\n  expandedIds: controlledExpandedIds,\n  defaultExpandedIds,\n  onSelect,\n  onExpandedChange,\n  renderItem,\n  expansionIndicator = 'folder',\n  className,\n  style,\n  ariaLabel = 'Tree',\n}: TreeViewProps<TId>) {\n  const [internalExpandedIds, setInternalExpandedIds] = React.useState<readonly TId[]>(\n    defaultExpandedIds ?? [],\n  );\n  const rootRef = React.useRef<HTMLDivElement | null>(null);\n  const isControlled = controlledExpandedIds !== undefined;\n  const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;\n  const handleToggleExpand = React.useCallback(\n    (id: TId) => {\n      const nextExpandedIds = toggleExpandedIds(expandedIds, id);\n      if (!isControlled) setInternalExpandedIds(nextExpandedIds);\n      onExpandedChange?.(nextExpandedIds);\n    },\n    [expandedIds, isControlled, onExpandedChange],\n  );\n  useSelectedTreeItemReveal(rootRef, selectedId, expandedIds);\n\n  return (\n    <div\n      ref={rootRef}\n      aria-label={ariaLabel}\n      className={className}\n      role=\"tree\"\n      style={{ ...TREE_STYLE, ...style }}\n    >\n      {nodes.map((node) => (\n        <TreeItemRow\n          key={node.id}\n          depth={0}\n          expandedIds={expandedIds}\n          expansionIndicator={expansionIndicator}\n          node={node}\n          onSelect={onSelect}\n          onToggleExpand={handleToggleExpand}\n          renderItem={renderItem}\n          selectedId={selectedId}\n        />\n      ))}\n    </div>\n  );\n}\n\n/*** Reveal a controlled selection after it is rendered without changing expansion ownership. */\nfunction useSelectedTreeItemReveal<TId extends string>(\n  rootRef: React.RefObject<HTMLDivElement | null>,\n  selectedId: TId | undefined,\n  expandedIds: readonly TId[],\n) {\n  React.useEffect(() => {\n    if (selectedId === undefined) return;\n    const root = rootRef.current as unknown as TreeViewQueryableElement | null;\n    root\n      ?.querySelector('[role=\"treeitem\"][aria-selected=\"true\"]')\n      ?.scrollIntoView({ block: 'nearest', inline: 'nearest' });\n  }, [expandedIds, rootRef, selectedId]);\n}\n\nconst TREE_STYLE = {\n  display: 'flex',\n  flexDirection: 'column',\n  minWidth: 0,\n} as const satisfies React.CSSProperties;\n\ninterface TreeViewQueryableElement {\n  querySelector(selector: string): TreeViewRevealTarget | null;\n}\n\ninterface TreeViewRevealTarget {\n  scrollIntoView(options: { readonly block: 'nearest'; readonly inline: 'nearest' }): void;\n}\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.81",
+  "version": "22.1.0",
   "description": "Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.",
   "homepage": "https://github.com/ankhorage/zora#readme",
   "bugs": {
@@ -124,7 +124,7 @@
     "version-packages": "ankhorage-changeset version"
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^2.1.4",
+    "@ankhorage/devtools": "^2.1.6",
     "@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/features/tree-view/adapters/inbound/web-artifact/TreeView.test.tsx

@@ -66,6 +66,46 @@ test('expands from the leading control without selecting the row, including keyb
   }
 });
 
+test('reveals a controlled selection when expansion makes the row renderable', async () => {
+  const browserWindow = new Window();
+  const keys = ['window', 'document', 'Node', 'navigator', 'IS_REACT_ACT_ENVIRONMENT'] as const;
+  const previous = keys.map(
+    (key) => [key, Object.getOwnPropertyDescriptor(globalThis, key)] as const,
+  );
+  Object.assign(globalThis, {
+    IS_REACT_ACT_ENVIRONMENT: true,
+    window: browserWindow,
+    document: browserWindow.document,
+    Node: browserWindow.Node,
+    navigator: browserWindow.navigator,
+  });
+  const reveals: unknown[] = [];
+  browserWindow.HTMLElement.prototype.scrollIntoView = (options) => reveals.push(options);
+  const host = document.createElement('div');
+  document.body.appendChild(host);
+  const root = createRoot(host);
+  const interactAsync = (action: () => void) => act(() => Promise.resolve().then(action));
+  const nodes = [{ id: 'src', label: 'source', children: [{ id: 'leaf', label: 'leaf' }] }];
+  try {
+    await interactAsync(() =>
+      root.render(<TreeView expandedIds={[]} nodes={nodes} selectedId="leaf" />),
+    );
+    expect(reveals).toEqual([]);
+
+    await interactAsync(() =>
+      root.render(<TreeView expandedIds={['src']} nodes={nodes} selectedId="leaf" />),
+    );
+    expect(reveals).toEqual([{ block: 'nearest', inline: 'nearest' }]);
+  } finally {
+    await interactAsync(() => root.unmount());
+    browserWindow.close();
+    for (const [key, descriptor] of previous) {
+      if (descriptor) Object.defineProperty(globalThis, key, descriptor);
+      else Reflect.deleteProperty(globalThis, key);
+    }
+  }
+});
+
 test('renders a standalone web tree without a ZORA or React Native provider', () => {
   const markup = renderToStaticMarkup(
     <TreeView

package/src/features/tree-view/adapters/inbound/web-artifact/TreeView.tsx

@@ -56,6 +56,7 @@ export function TreeView<TId extends string = string>({
   const [internalExpandedIds, setInternalExpandedIds] = React.useState<readonly TId[]>(
     defaultExpandedIds ?? [],
   );
+  const rootRef = React.useRef<HTMLDivElement | null>(null);
   const isControlled = controlledExpandedIds !== undefined;
   const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;
   const handleToggleExpand = React.useCallback(
@@ -66,9 +67,11 @@ export function TreeView<TId extends string = string>({
     },
     [expandedIds, isControlled, onExpandedChange],
   );
+  useSelectedTreeItemReveal(rootRef, selectedId, expandedIds);
 
   return (
     <div
+      ref={rootRef}
       aria-label={ariaLabel}
       className={className}
       role="tree"
@@ -91,8 +94,31 @@ export function TreeView<TId extends string = string>({
   );
 }
 
+/*** Reveal a controlled selection after it is rendered without changing expansion ownership. */
+function useSelectedTreeItemReveal<TId extends string>(
+  rootRef: React.RefObject<HTMLDivElement | null>,
+  selectedId: TId | undefined,
+  expandedIds: readonly TId[],
+) {
+  React.useEffect(() => {
+    if (selectedId === undefined) return;
+    const root = rootRef.current as unknown as TreeViewQueryableElement | null;
+    root
+      ?.querySelector('[role="treeitem"][aria-selected="true"]')
+      ?.scrollIntoView({ block: 'nearest', inline: 'nearest' });
+  }, [expandedIds, rootRef, selectedId]);
+}
+
 const TREE_STYLE = {
   display: 'flex',
   flexDirection: 'column',
   minWidth: 0,
 } as const satisfies React.CSSProperties;
+
+interface TreeViewQueryableElement {
+  querySelector(selector: string): TreeViewRevealTarget | null;
+}
+
+interface TreeViewRevealTarget {
+  scrollIntoView(options: { readonly block: 'nearest'; readonly inline: 'nearest' }): void;
+}

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;

package/web-dist/components/tree-view/TreeView.js

@@ -229,6 +229,7 @@ function TreeView({
   ariaLabel = "Tree"
 }) {
   const [internalExpandedIds, setInternalExpandedIds] = React2.useState(defaultExpandedIds ?? []);
+  const rootRef = React2.useRef(null);
   const isControlled = controlledExpandedIds !== undefined;
   const expandedIds = isControlled ? controlledExpandedIds : internalExpandedIds;
   const handleToggleExpand = React2.useCallback((id) => {
@@ -237,7 +238,9 @@ function TreeView({
       setInternalExpandedIds(nextExpandedIds);
     onExpandedChange?.(nextExpandedIds);
   }, [expandedIds, isControlled, onExpandedChange]);
+  useSelectedTreeItemReveal(rootRef, selectedId, expandedIds);
   return /* @__PURE__ */ jsx3("div", {
+    ref: rootRef,
     "aria-label": ariaLabel,
     className,
     role: "tree",
@@ -254,6 +257,14 @@ function TreeView({
     }, node.id))
   });
 }
+function useSelectedTreeItemReveal(rootRef, selectedId, expandedIds) {
+  React2.useEffect(() => {
+    if (selectedId === undefined)
+      return;
+    const root = rootRef.current;
+    root?.querySelector('[role="treeitem"][aria-selected="true"]')?.scrollIntoView({ block: "nearest", inline: "nearest" });
+  }, [expandedIds, rootRef, selectedId]);
+}
 var TREE_STYLE = {
   display: "flex",
   flexDirection: "column",