@ankhorage/zora 20.1.6 → 20.2.1

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

@@ -0,0 +1,30 @@
+import { type CytoscapeOptions } from 'cytoscape';
+import type { GraphViewCallbacks, GraphViewEdge, GraphViewElementEventType, GraphViewLayoutName, GraphViewNode, GraphViewRenderedNode, GraphViewSize, GraphViewStyleRule } from './GraphView';
+type GraphContainer = NonNullable<CytoscapeOptions['container']>;
+type RenderedNodeListener = (nodes: readonly GraphViewRenderedNode[]) => void;
+interface GraphRuntimeUpdate {
+    readonly edges: readonly GraphViewEdge[];
+    readonly fitPadding?: number;
+    readonly layout?: GraphViewLayoutName;
+    readonly layoutOptions?: Readonly<Record<string, unknown>>;
+    readonly maxZoom?: number;
+    readonly minZoom?: number;
+    readonly nodes: readonly GraphViewNode[];
+    readonly richNodeRendering: boolean;
+    readonly spacingFactor?: number;
+    readonly styleRules?: readonly GraphViewStyleRule[];
+}
+export interface GraphRuntime {
+    destroy(): void;
+    handleOverlayNodeEvent(id: string, type: GraphViewElementEventType): void;
+    setNodeSize(id: string, size: GraphViewSize): void;
+    setSelectedNodeIds(nodeIds: readonly string[] | undefined): void;
+    subscribeRenderedNodes(listener: RenderedNodeListener): () => void;
+    update(input: GraphRuntimeUpdate): void;
+}
+/*** Create one Cytoscape runtime that exclusively owns layout, fit, resize, and disposal. */
+export declare function createGraphRuntime(container: GraphContainer, callbacksRef: {
+    current: GraphViewCallbacks;
+}): GraphRuntime;
+export {};
+//# sourceMappingURL=createGraphRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createGraphRuntime.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphRuntime.ts"],"names":[],"mappings":"AAAA,OAAkB,EAAa,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAOxE,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAQrB,KAAK,cAAc,GAAG,WAAW,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;AACjE,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,KAAK,IAAI,CAAC;AAE9E,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,IAAI,IAAI,CAAC;IAChB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC1E,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACnD,kBAAkB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC;IACjE,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IACnE,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACzC;AAoBD,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAC5C,YAAY,CAmBd"}

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

@@ -0,0 +1,222 @@
+import cytoscape, {} from 'cytoscape';
+import elk from 'cytoscape-elk';
+import { bindGraphEvents } from './bindGraphEvents';
+import { createGraphController } from './createGraphController';
+import { createGraphResizeObserver } from './createGraphResizeObserver';
+import { fitGraphViewport } from './fitGraphViewport';
+import { readGraphRenderedNodes } from './readGraphRenderedNodes';
+import { runGraphLayout } from './runGraphLayout';
+import { scheduleGraphFrame } from './scheduleGraphFrame';
+import { syncGraphElements } from './syncGraphElements';
+cytoscape.use(elk);
+/*** Create one Cytoscape runtime that exclusively owns layout, fit, resize, and disposal. */
+export function createGraphRuntime(container, callbacksRef) {
+    const cy = cytoscape({
+        container,
+        elements: [],
+        minZoom: 0.05,
+        maxZoom: 2,
+        selectionType: 'additive',
+        userPanningEnabled: true,
+    });
+    const state = createRuntimeState(cy, container, callbacksRef);
+    return {
+        destroy: () => destroyRuntime(state),
+        handleOverlayNodeEvent: (id, type) => handleOverlayNodeEvent(state, id, type),
+        setNodeSize: (id, size) => setNodeSize(state, id, size),
+        setSelectedNodeIds: (nodeIds) => setSelectedNodeIds(state, nodeIds),
+        subscribeRenderedNodes: (listener) => subscribeRenderedNodes(state, listener),
+        update: (input) => updateRuntime(state, input),
+    };
+}
+/*** Build the mutable state shared by the single graph-runtime owner. */
+function createRuntimeState(cy, container, callbacksRef) {
+    const fitPaddingRef = { current: 50 };
+    const controller = createGraphController(cy, fitPaddingRef);
+    const layoutRunningRef = { current: false };
+    const readyRef = { current: false };
+    const renderedNodeListeners = new Set();
+    const stateBase = {
+        callbacksRef,
+        controller,
+        cy,
+        fitPaddingRef,
+        generationRef: { current: 0 },
+        hoveredNodeIds: new Set(),
+        latestUpdateRef: { current: null },
+        layoutRef: { current: null },
+        layoutRunningRef,
+        nodeSizes: new Map(),
+        readyRef,
+        relayoutScheduledRef: { current: false },
+        renderedNodeListeners,
+    };
+    const unbindEvents = bindGraphEvents(cy, callbacksRef, controller, () => emitRenderedNodes(stateBase));
+    const resizeObserver = createGraphResizeObserver({
+        container,
+        cy,
+        fitPaddingRef,
+        layoutRunningRef,
+        onViewportSettled: () => emitRenderedNodes(stateBase),
+        readyRef,
+    });
+    return { ...stateBase, resizeObserver, unbindEvents };
+}
+/*** Apply one graph update and start exactly one new layout generation. */
+function updateRuntime(state, input) {
+    if (state.cy.destroyed())
+        return;
+    stopCurrentLayout(state);
+    state.latestUpdateRef.current = input;
+    state.fitPaddingRef.current = input.fitPadding ?? 50;
+    state.cy.minZoom(input.minZoom ?? 0.05);
+    state.cy.maxZoom(input.maxZoom ?? 2);
+    syncGraphElements(state.cy, input.nodes, input.edges);
+    applyGraphStyles(state.cy, input.styleRules, input.richNodeRendering);
+    applyKnownNodeSizes(state);
+    startCurrentLayout(state, input);
+}
+/*** Start a generation-safe layout whose completion is the only normal automatic fit trigger. */
+function startCurrentLayout(state, input) {
+    const generation = state.generationRef.current + 1;
+    state.generationRef.current = generation;
+    state.layoutRunningRef.current = true;
+    state.cy.resize();
+    state.layoutRef.current = runGraphLayout(state.cy, {
+        layout: input.layout ?? 'concentric',
+        layoutOptions: input.layoutOptions,
+        spacingFactor: input.spacingFactor ?? 1,
+    }, () => completeCurrentLayout(state, generation));
+}
+/*** Settle only the latest layout generation and fit once from node bounds. */
+function completeCurrentLayout(state, generation) {
+    state.layoutRef.current = null;
+    scheduleGraphFrame(() => {
+        if (state.cy.destroyed() || generation !== state.generationRef.current)
+            return;
+        state.cy.resize();
+        state.layoutRunningRef.current = false;
+        if (!hasUsableViewport(state.cy))
+            return;
+        fitGraphViewport(state.cy, { padding: state.fitPaddingRef.current });
+        emitRenderedNodes(state);
+        if (!state.readyRef.current) {
+            state.readyRef.current = true;
+            state.callbacksRef.current.onReady?.(state.controller);
+        }
+        state.callbacksRef.current.onLayoutComplete?.(state.controller);
+    });
+}
+/*** Stop the current layout and invalidate every stale completion callback. */
+function stopCurrentLayout(state) {
+    state.generationRef.current += 1;
+    state.layoutRunningRef.current = false;
+    state.layoutRef.current?.stop();
+    state.layoutRef.current = null;
+}
+/*** Apply consumer styles and hide native node paint only when React rich nodes are active. */
+function applyGraphStyles(cy, rules, richNodeRendering) {
+    const styles = [...(rules ?? [])];
+    if (richNodeRendering) {
+        styles.push({
+            selector: 'node',
+            style: {
+                'background-opacity': 0,
+                'border-width': 0,
+                label: '',
+                'overlay-opacity': 0,
+            },
+        });
+    }
+    if (styles.length > 0)
+        cy.style(styles).update();
+}
+/*** Synchronize controlled selection without rerunning layout. */
+function setSelectedNodeIds(state, nodeIds) {
+    if (state.cy.destroyed() || nodeIds === undefined)
+        return;
+    const selectedIds = new Set(nodeIds);
+    state.cy.nodes().forEach((node) => {
+        if (selectedIds.has(node.id()))
+            node.select();
+        else
+            node.unselect();
+    });
+    emitRenderedNodes(state);
+}
+/*** Persist one rich-node size and schedule at most one relayout for changed geometry. */
+function setNodeSize(state, id, size) {
+    const previous = state.nodeSizes.get(id);
+    if (previous?.width === size.width && previous.height === size.height)
+        return;
+    state.nodeSizes.set(id, size);
+    applyNodeSize(state.cy, id, size);
+    scheduleMeasuredNodeRelayout(state);
+}
+/*** Apply every known rich-node size after Cytoscape elements are replaced. */
+function applyKnownNodeSizes(state) {
+    for (const [id, size] of state.nodeSizes)
+        applyNodeSize(state.cy, id, size);
+}
+/*** Apply one measured model-space size as a Cytoscape per-node style bypass. */
+function applyNodeSize(cy, id, size) {
+    const node = cy.getElementById(id);
+    if (node.empty())
+        return;
+    node.style({ height: size.height, width: size.width });
+}
+/*** Coalesce DOM measurements into one follow-up layout generation. */
+function scheduleMeasuredNodeRelayout(state) {
+    if (state.relayoutScheduledRef.current)
+        return;
+    state.relayoutScheduledRef.current = true;
+    scheduleGraphFrame(() => {
+        state.relayoutScheduledRef.current = false;
+        const input = state.latestUpdateRef.current;
+        if (input === null || state.cy.destroyed())
+            return;
+        stopCurrentLayout(state);
+        startCurrentLayout(state, input);
+    });
+}
+/*** Subscribe one React overlay to rendered node state without exposing the Cytoscape core. */
+function subscribeRenderedNodes(state, listener) {
+    state.renderedNodeListeners.add(listener);
+    listener(readGraphRenderedNodes(state.cy, state.hoveredNodeIds));
+    return () => {
+        state.renderedNodeListeners.delete(listener);
+    };
+}
+/*** Publish current rendered node positions only to active rich-node subscribers. */
+function emitRenderedNodes(state) {
+    if (state.renderedNodeListeners.size === 0)
+        return;
+    const nodes = readGraphRenderedNodes(state.cy, state.hoveredNodeIds);
+    for (const listener of state.renderedNodeListeners)
+        listener(nodes);
+}
+/*** Translate one rich-overlay event back into normal graph selection and callbacks. */
+function handleOverlayNodeEvent(state, id, type) {
+    if (type === 'pointer-enter')
+        state.hoveredNodeIds.add(id);
+    if (type === 'pointer-leave')
+        state.hoveredNodeIds.delete(id);
+    if (type === 'press')
+        state.cy.getElementById(id).select();
+    state.callbacksRef.current.onNodeEvent?.({ id, type });
+    emitRenderedNodes(state);
+}
+/*** Return whether Cytoscape currently has dimensions suitable for fitting. */
+function hasUsableViewport(cy) {
+    return cy.width() > 0 && cy.height() > 0;
+}
+/*** Dispose all runtime resources in the reverse order they were acquired. */
+function destroyRuntime(state) {
+    state.resizeObserver?.disconnect();
+    stopCurrentLayout(state);
+    state.unbindEvents();
+    state.renderedNodeListeners.clear();
+    if (!state.cy.destroyed())
+        state.cy.destroy();
+}
+//# sourceMappingURL=createGraphRuntime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createGraphRuntime.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphRuntime.ts"],"names":[],"mappings":"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","sourcesContent":["import cytoscape, { type Core, type CytoscapeOptions } from 'cytoscape';\nimport elk from 'cytoscape-elk';\n\nimport { bindGraphEvents } from './bindGraphEvents';\nimport { createGraphController } from './createGraphController';\nimport { createGraphResizeObserver, type GraphResizeObserver } from './createGraphResizeObserver';\nimport { fitGraphViewport } from './fitGraphViewport';\nimport type {\n  GraphViewCallbacks,\n  GraphViewEdge,\n  GraphViewElementEventType,\n  GraphViewLayoutName,\n  GraphViewNode,\n  GraphViewRenderedNode,\n  GraphViewSize,\n  GraphViewStyleRule,\n} from './GraphView';\nimport { readGraphRenderedNodes } from './readGraphRenderedNodes';\nimport { runGraphLayout } from './runGraphLayout';\nimport { scheduleGraphFrame } from './scheduleGraphFrame';\nimport { syncGraphElements } from './syncGraphElements';\n\ncytoscape.use(elk as cytoscape.Ext);\n\ntype GraphContainer = NonNullable<CytoscapeOptions['container']>;\ntype RenderedNodeListener = (nodes: readonly GraphViewRenderedNode[]) => void;\n\ninterface GraphRuntimeUpdate {\n  readonly edges: readonly GraphViewEdge[];\n  readonly fitPadding?: number;\n  readonly layout?: GraphViewLayoutName;\n  readonly layoutOptions?: Readonly<Record<string, unknown>>;\n  readonly maxZoom?: number;\n  readonly minZoom?: number;\n  readonly nodes: readonly GraphViewNode[];\n  readonly richNodeRendering: boolean;\n  readonly spacingFactor?: number;\n  readonly styleRules?: readonly GraphViewStyleRule[];\n}\n\nexport interface GraphRuntime {\n  destroy(): void;\n  handleOverlayNodeEvent(id: string, type: GraphViewElementEventType): void;\n  setNodeSize(id: string, size: GraphViewSize): void;\n  setSelectedNodeIds(nodeIds: readonly string[] | undefined): void;\n  subscribeRenderedNodes(listener: RenderedNodeListener): () => void;\n  update(input: GraphRuntimeUpdate): void;\n}\n\ninterface GraphRuntimeState {\n  readonly callbacksRef: { current: GraphViewCallbacks };\n  readonly controller: ReturnType<typeof createGraphController>;\n  readonly cy: Core;\n  readonly fitPaddingRef: { current: number };\n  readonly generationRef: { current: number };\n  readonly hoveredNodeIds: Set<string>;\n  readonly latestUpdateRef: { current: GraphRuntimeUpdate | null };\n  readonly layoutRef: { current: ReturnType<typeof runGraphLayout> | null };\n  readonly layoutRunningRef: { current: boolean };\n  readonly nodeSizes: Map<string, GraphViewSize>;\n  readonly readyRef: { current: boolean };\n  readonly relayoutScheduledRef: { current: boolean };\n  readonly renderedNodeListeners: Set<RenderedNodeListener>;\n  readonly resizeObserver: GraphResizeObserver | null;\n  readonly unbindEvents: () => void;\n}\n\n/*** Create one Cytoscape runtime that exclusively owns layout, fit, resize, and disposal. */\nexport function createGraphRuntime(\n  container: GraphContainer,\n  callbacksRef: { current: GraphViewCallbacks },\n): GraphRuntime {\n  const cy = cytoscape({\n    container,\n    elements: [],\n    minZoom: 0.05,\n    maxZoom: 2,\n    selectionType: 'additive',\n    userPanningEnabled: true,\n  });\n  const state = createRuntimeState(cy, container, callbacksRef);\n\n  return {\n    destroy: () => destroyRuntime(state),\n    handleOverlayNodeEvent: (id, type) => handleOverlayNodeEvent(state, id, type),\n    setNodeSize: (id, size) => setNodeSize(state, id, size),\n    setSelectedNodeIds: (nodeIds) => setSelectedNodeIds(state, nodeIds),\n    subscribeRenderedNodes: (listener) => subscribeRenderedNodes(state, listener),\n    update: (input) => updateRuntime(state, input),\n  };\n}\n\n/*** Build the mutable state shared by the single graph-runtime owner. */\nfunction createRuntimeState(\n  cy: Core,\n  container: GraphContainer,\n  callbacksRef: { current: GraphViewCallbacks },\n): GraphRuntimeState {\n  const fitPaddingRef = { current: 50 };\n  const controller = createGraphController(cy, fitPaddingRef);\n  const layoutRunningRef = { current: false };\n  const readyRef = { current: false };\n  const renderedNodeListeners = new Set<RenderedNodeListener>();\n  const stateBase = {\n    callbacksRef,\n    controller,\n    cy,\n    fitPaddingRef,\n    generationRef: { current: 0 },\n    hoveredNodeIds: new Set<string>(),\n    latestUpdateRef: { current: null as GraphRuntimeUpdate | null },\n    layoutRef: { current: null as ReturnType<typeof runGraphLayout> | null },\n    layoutRunningRef,\n    nodeSizes: new Map<string, GraphViewSize>(),\n    readyRef,\n    relayoutScheduledRef: { current: false },\n    renderedNodeListeners,\n  };\n  const unbindEvents = bindGraphEvents(cy, callbacksRef, controller, () =>\n    emitRenderedNodes(stateBase),\n  );\n  const resizeObserver = createGraphResizeObserver({\n    container,\n    cy,\n    fitPaddingRef,\n    layoutRunningRef,\n    onViewportSettled: () => emitRenderedNodes(stateBase),\n    readyRef,\n  });\n\n  return { ...stateBase, resizeObserver, unbindEvents };\n}\n\n/*** Apply one graph update and start exactly one new layout generation. */\nfunction updateRuntime(state: GraphRuntimeState, input: GraphRuntimeUpdate) {\n  if (state.cy.destroyed()) return;\n  stopCurrentLayout(state);\n  state.latestUpdateRef.current = input;\n  state.fitPaddingRef.current = input.fitPadding ?? 50;\n  state.cy.minZoom(input.minZoom ?? 0.05);\n  state.cy.maxZoom(input.maxZoom ?? 2);\n  syncGraphElements(state.cy, input.nodes, input.edges);\n  applyGraphStyles(state.cy, input.styleRules, input.richNodeRendering);\n  applyKnownNodeSizes(state);\n  startCurrentLayout(state, input);\n}\n\n/*** Start a generation-safe layout whose completion is the only normal automatic fit trigger. */\nfunction startCurrentLayout(state: GraphRuntimeState, input: GraphRuntimeUpdate) {\n  const generation = state.generationRef.current + 1;\n  state.generationRef.current = generation;\n  state.layoutRunningRef.current = true;\n  state.cy.resize();\n  state.layoutRef.current = runGraphLayout(\n    state.cy,\n    {\n      layout: input.layout ?? 'concentric',\n      layoutOptions: input.layoutOptions,\n      spacingFactor: input.spacingFactor ?? 1,\n    },\n    () => completeCurrentLayout(state, generation),\n  );\n}\n\n/*** Settle only the latest layout generation and fit once from node bounds. */\nfunction completeCurrentLayout(state: GraphRuntimeState, generation: number) {\n  state.layoutRef.current = null;\n  scheduleGraphFrame(() => {\n    if (state.cy.destroyed() || generation !== state.generationRef.current) return;\n    state.cy.resize();\n    state.layoutRunningRef.current = false;\n    if (!hasUsableViewport(state.cy)) return;\n    fitGraphViewport(state.cy, { padding: state.fitPaddingRef.current });\n    emitRenderedNodes(state);\n\n    if (!state.readyRef.current) {\n      state.readyRef.current = true;\n      state.callbacksRef.current.onReady?.(state.controller);\n    }\n    state.callbacksRef.current.onLayoutComplete?.(state.controller);\n  });\n}\n\n/*** Stop the current layout and invalidate every stale completion callback. */\nfunction stopCurrentLayout(state: GraphRuntimeState) {\n  state.generationRef.current += 1;\n  state.layoutRunningRef.current = false;\n  state.layoutRef.current?.stop();\n  state.layoutRef.current = null;\n}\n\n/*** Apply consumer styles and hide native node paint only when React rich nodes are active. */\nfunction applyGraphStyles(\n  cy: Core,\n  rules: readonly GraphViewStyleRule[] | undefined,\n  richNodeRendering: boolean,\n) {\n  const styles = [...(rules ?? [])];\n  if (richNodeRendering) {\n    styles.push({\n      selector: 'node',\n      style: {\n        'background-opacity': 0,\n        'border-width': 0,\n        label: '',\n        'overlay-opacity': 0,\n      },\n    });\n  }\n  if (styles.length > 0) cy.style(styles).update();\n}\n\n/*** Synchronize controlled selection without rerunning layout. */\nfunction setSelectedNodeIds(state: GraphRuntimeState, nodeIds: readonly string[] | undefined) {\n  if (state.cy.destroyed() || nodeIds === undefined) return;\n  const selectedIds = new Set(nodeIds);\n  state.cy.nodes().forEach((node) => {\n    if (selectedIds.has(node.id())) node.select();\n    else node.unselect();\n  });\n  emitRenderedNodes(state);\n}\n\n/*** Persist one rich-node size and schedule at most one relayout for changed geometry. */\nfunction setNodeSize(state: GraphRuntimeState, id: string, size: GraphViewSize) {\n  const previous = state.nodeSizes.get(id);\n  if (previous?.width === size.width && previous.height === size.height) return;\n  state.nodeSizes.set(id, size);\n  applyNodeSize(state.cy, id, size);\n  scheduleMeasuredNodeRelayout(state);\n}\n\n/*** Apply every known rich-node size after Cytoscape elements are replaced. */\nfunction applyKnownNodeSizes(state: GraphRuntimeState) {\n  for (const [id, size] of state.nodeSizes) applyNodeSize(state.cy, id, size);\n}\n\n/*** Apply one measured model-space size as a Cytoscape per-node style bypass. */\nfunction applyNodeSize(cy: Core, id: string, size: GraphViewSize) {\n  const node = cy.getElementById(id);\n  if (node.empty()) return;\n  node.style({ height: size.height, width: size.width });\n}\n\n/*** Coalesce DOM measurements into one follow-up layout generation. */\nfunction scheduleMeasuredNodeRelayout(state: GraphRuntimeState) {\n  if (state.relayoutScheduledRef.current) return;\n  state.relayoutScheduledRef.current = true;\n  scheduleGraphFrame(() => {\n    state.relayoutScheduledRef.current = false;\n    const input = state.latestUpdateRef.current;\n    if (input === null || state.cy.destroyed()) return;\n    stopCurrentLayout(state);\n    startCurrentLayout(state, input);\n  });\n}\n\n/*** Subscribe one React overlay to rendered node state without exposing the Cytoscape core. */\nfunction subscribeRenderedNodes(state: GraphRuntimeState, listener: RenderedNodeListener) {\n  state.renderedNodeListeners.add(listener);\n  listener(readGraphRenderedNodes(state.cy, state.hoveredNodeIds));\n  return () => {\n    state.renderedNodeListeners.delete(listener);\n  };\n}\n\n/*** Publish current rendered node positions only to active rich-node subscribers. */\nfunction emitRenderedNodes(\n  state: Pick<GraphRuntimeState, 'cy' | 'hoveredNodeIds' | 'renderedNodeListeners'>,\n) {\n  if (state.renderedNodeListeners.size === 0) return;\n  const nodes = readGraphRenderedNodes(state.cy, state.hoveredNodeIds);\n  for (const listener of state.renderedNodeListeners) listener(nodes);\n}\n\n/*** Translate one rich-overlay event back into normal graph selection and callbacks. */\nfunction handleOverlayNodeEvent(\n  state: GraphRuntimeState,\n  id: string,\n  type: GraphViewElementEventType,\n) {\n  if (type === 'pointer-enter') state.hoveredNodeIds.add(id);\n  if (type === 'pointer-leave') state.hoveredNodeIds.delete(id);\n  if (type === 'press') state.cy.getElementById(id).select();\n  state.callbacksRef.current.onNodeEvent?.({ id, type });\n  emitRenderedNodes(state);\n}\n\n/*** Return whether Cytoscape currently has dimensions suitable for fitting. */\nfunction hasUsableViewport(cy: Core): boolean {\n  return cy.width() > 0 && cy.height() > 0;\n}\n\n/*** Dispose all runtime resources in the reverse order they were acquired. */\nfunction destroyRuntime(state: GraphRuntimeState) {\n  state.resizeObserver?.disconnect();\n  stopCurrentLayout(state);\n  state.unbindEvents();\n  state.renderedNodeListeners.clear();\n  if (!state.cy.destroyed()) state.cy.destroy();\n}\n"]}

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

@@ -0,0 +1,5 @@
+import type { ElementDefinition } from 'cytoscape';
+import type { GraphViewEdge, GraphViewNode } from './GraphView';
+/*** Convert plain graph data into renderable Cytoscape elements without impossible compound edges. */
+export declare function createRenderableGraphElements(nodes: readonly GraphViewNode[], edges: readonly GraphViewEdge[]): ElementDefinition[];
+//# sourceMappingURL=createRenderableGraphElements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createRenderableGraphElements.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createRenderableGraphElements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,sGAAsG;AACtG,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,iBAAiB,EAAE,CAoBrB"}

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

@@ -0,0 +1,51 @@
+/*** Convert plain graph data into renderable Cytoscape elements without impossible compound edges. */
+export function createRenderableGraphElements(nodes, edges) {
+    const nodeIds = new Set(nodes.map((node) => node.id));
+    const parentById = new Map(nodes.flatMap((node) => (node.parentId ? [[node.id, node.parentId]] : [])));
+    const nodeElements = nodes.map((node) => ({
+        group: 'nodes',
+        classes: node.classes,
+        data: {
+            ...(node.data ?? {}),
+            id: node.id,
+            label: node.label ?? node.id,
+            ...(node.parentId ? { parent: node.parentId } : {}),
+        },
+    }));
+    const edgeElements = edges.flatMap((edge, index) => createEdgeElement(edge, index, nodeIds, parentById));
+    return [...nodeElements, ...edgeElements];
+}
+/*** Build one edge unless one endpoint owns the other in the compound hierarchy. */
+function createEdgeElement(edge, index, nodeIds, parentById) {
+    if (!nodeIds.has(edge.source) || !nodeIds.has(edge.target))
+        return [];
+    if (isAncestor(edge.source, edge.target, parentById))
+        return [];
+    if (isAncestor(edge.target, edge.source, parentById))
+        return [];
+    return [
+        {
+            group: 'edges',
+            classes: edge.classes,
+            data: {
+                ...(edge.data ?? {}),
+                id: edge.id ?? `${edge.source}->${edge.target}:${index}`,
+                source: edge.source,
+                target: edge.target,
+            },
+        },
+    ];
+}
+/*** Return whether a node appears in another node's compound parent chain. */
+function isAncestor(possibleAncestor, nodeId, parentById) {
+    const visited = new Set();
+    let current = parentById.get(nodeId);
+    while (current !== undefined && !visited.has(current)) {
+        if (current === possibleAncestor)
+            return true;
+        visited.add(current);
+        current = parentById.get(current);
+    }
+    return false;
+}
+//# sourceMappingURL=createRenderableGraphElements.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createRenderableGraphElements.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createRenderableGraphElements.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ElementDefinition } from 'cytoscape';\n\nimport type { GraphViewEdge, GraphViewNode } from './GraphView';\n\n/*** Convert plain graph data into renderable Cytoscape elements without impossible compound edges. */\nexport function createRenderableGraphElements(\n  nodes: readonly GraphViewNode[],\n  edges: readonly GraphViewEdge[],\n): ElementDefinition[] {\n  const nodeIds = new Set(nodes.map((node) => node.id));\n  const parentById = new Map(\n    nodes.flatMap((node) => (node.parentId ? [[node.id, node.parentId] as const] : [])),\n  );\n  const nodeElements: ElementDefinition[] = nodes.map((node) => ({\n    group: 'nodes',\n    classes: node.classes,\n    data: {\n      ...(node.data ?? {}),\n      id: node.id,\n      label: node.label ?? node.id,\n      ...(node.parentId ? { parent: node.parentId } : {}),\n    },\n  }));\n  const edgeElements = edges.flatMap((edge, index) =>\n    createEdgeElement(edge, index, nodeIds, parentById),\n  );\n\n  return [...nodeElements, ...edgeElements];\n}\n\n/*** Build one edge unless one endpoint owns the other in the compound hierarchy. */\nfunction createEdgeElement(\n  edge: GraphViewEdge,\n  index: number,\n  nodeIds: ReadonlySet<string>,\n  parentById: ReadonlyMap<string, string>,\n): ElementDefinition[] {\n  if (!nodeIds.has(edge.source) || !nodeIds.has(edge.target)) return [];\n  if (isAncestor(edge.source, edge.target, parentById)) return [];\n  if (isAncestor(edge.target, edge.source, parentById)) return [];\n\n  return [\n    {\n      group: 'edges',\n      classes: edge.classes,\n      data: {\n        ...(edge.data ?? {}),\n        id: edge.id ?? `${edge.source}->${edge.target}:${index}`,\n        source: edge.source,\n        target: edge.target,\n      },\n    },\n  ];\n}\n\n/*** Return whether a node appears in another node's compound parent chain. */\nfunction isAncestor(\n  possibleAncestor: string,\n  nodeId: string,\n  parentById: ReadonlyMap<string, string>,\n): boolean {\n  const visited = new Set<string>();\n  let current = parentById.get(nodeId);\n\n  while (current !== undefined && !visited.has(current)) {\n    if (current === possibleAncestor) return true;\n    visited.add(current);\n    current = parentById.get(current);\n  }\n\n  return false;\n}\n"]}

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

@@ -0,0 +1,5 @@
+import type { Core } from 'cytoscape';
+import type { GraphViewFitOptions } from './GraphView';
+/*** Fit the requested visible nodes and never include edge geometry in viewport bounds. */
+export declare function fitGraphViewport(cy: Core, options?: GraphViewFitOptions): boolean;
+//# sourceMappingURL=fitGraphViewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fitGraphViewport.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/fitGraphViewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAOrF"}

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

@@ -0,0 +1,18 @@
+/*** Fit the requested visible nodes and never include edge geometry in viewport bounds. */
+export function fitGraphViewport(cy, options = {}) {
+    if (cy.destroyed())
+        return false;
+    const nodes = getFitNodes(cy, options.nodeIds);
+    if (nodes.empty())
+        return false;
+    cy.fit(nodes, options.padding ?? 50);
+    return true;
+}
+/*** Resolve an optional node-id target without ever adding edges to the fit collection. */
+function getFitNodes(cy, nodeIds) {
+    if (nodeIds === undefined || nodeIds.length === 0)
+        return cy.nodes();
+    const requestedIds = new Set(nodeIds);
+    return cy.nodes().filter((node) => requestedIds.has(node.id()));
+}
+//# sourceMappingURL=fitGraphViewport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fitGraphViewport.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/fitGraphViewport.ts"],"names":[],"mappings":"AAIA,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,EAAQ,EAAE,UAA+B,EAAE;IAC1E,IAAI,EAAE,CAAC,SAAS,EAAE;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAEhC,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2FAA2F;AAC3F,SAAS,WAAW,CAAC,EAAQ,EAAE,OAAsC;IACnE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC;IACrE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC","sourcesContent":["import type { Core } from 'cytoscape';\n\nimport type { GraphViewFitOptions } from './GraphView';\n\n/*** Fit the requested visible nodes and never include edge geometry in viewport bounds. */\nexport function fitGraphViewport(cy: Core, options: GraphViewFitOptions = {}): boolean {\n  if (cy.destroyed()) return false;\n  const nodes = getFitNodes(cy, options.nodeIds);\n  if (nodes.empty()) return false;\n\n  cy.fit(nodes, options.padding ?? 50);\n  return true;\n}\n\n/*** Resolve an optional node-id target without ever adding edges to the fit collection. */\nfunction getFitNodes(cy: Core, nodeIds: readonly string[] | undefined) {\n  if (nodeIds === undefined || nodeIds.length === 0) return cy.nodes();\n  const requestedIds = new Set(nodeIds);\n  return cy.nodes().filter((node) => requestedIds.has(node.id()));\n}\n"]}

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

@@ -0,0 +1,5 @@
+import type { Core } from 'cytoscape';
+import type { GraphViewRenderedNode } from './GraphView';
+/*** Read React-overlay node state from Cytoscape's authoritative rendered positions. */
+export declare function readGraphRenderedNodes(cy: Core, hoveredNodeIds: ReadonlySet<string>): readonly GraphViewRenderedNode[];
+//# sourceMappingURL=readGraphRenderedNodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readGraphRenderedNodes.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/readGraphRenderedNodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,wFAAwF;AACxF,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,IAAI,EACR,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAClC,SAAS,qBAAqB,EAAE,CAWlC"}

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

@@ -0,0 +1,14 @@
+/*** Read React-overlay node state from Cytoscape's authoritative rendered positions. */
+export function readGraphRenderedNodes(cy, hoveredNodeIds) {
+    if (cy.destroyed())
+        return [];
+    const zoom = cy.zoom();
+    return cy.nodes().map((node) => ({
+        hovered: hoveredNodeIds.has(node.id()),
+        id: node.id(),
+        position: node.renderedPosition(),
+        selected: node.selected(),
+        zoom,
+    }));
+}
+//# sourceMappingURL=readGraphRenderedNodes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readGraphRenderedNodes.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/readGraphRenderedNodes.ts"],"names":[],"mappings":"AAIA,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CACpC,EAAQ,EACR,cAAmC;IAEnC,IAAI,EAAE,CAAC,SAAS,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAEvB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACtC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;QACb,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;QACzB,IAAI;KACL,CAAC,CAAC,CAAC;AACN,CAAC","sourcesContent":["import type { Core } from 'cytoscape';\n\nimport type { GraphViewRenderedNode } from './GraphView';\n\n/*** Read React-overlay node state from Cytoscape's authoritative rendered positions. */\nexport function readGraphRenderedNodes(\n  cy: Core,\n  hoveredNodeIds: ReadonlySet<string>,\n): readonly GraphViewRenderedNode[] {\n  if (cy.destroyed()) return [];\n  const zoom = cy.zoom();\n\n  return cy.nodes().map((node) => ({\n    hovered: hoveredNodeIds.has(node.id()),\n    id: node.id(),\n    position: node.renderedPosition(),\n    selected: node.selected(),\n    zoom,\n  }));\n}\n"]}

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

@@ -0,0 +1,14 @@
+import type { Core } from 'cytoscape';
+import type { GraphViewLayoutName } from './GraphView';
+interface RunGraphLayoutInput {
+    readonly layout: GraphViewLayoutName;
+    readonly layoutOptions?: Readonly<Record<string, unknown>>;
+    readonly spacingFactor: number;
+}
+interface GraphLayoutSession {
+    stop(): void;
+}
+/*** Run one Cytoscape layout with automatic fitting disabled and explicit stop ownership. */
+export declare function runGraphLayout(cy: Core, input: RunGraphLayoutInput, onComplete: () => void): GraphLayoutSession;
+export {};
+//# sourceMappingURL=runGraphLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runGraphLayout.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/runGraphLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0B,MAAM,WAAW,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,UAAU,kBAAkB;IAC1B,IAAI,IAAI,IAAI,CAAC;CACd;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAC5B,EAAE,EAAE,IAAI,EACR,KAAK,EAAE,mBAAmB,EAC1B,UAAU,EAAE,MAAM,IAAI,GACrB,kBAAkB,CAWpB"}

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

@@ -0,0 +1,34 @@
+/*** Run one Cytoscape layout with automatic fitting disabled and explicit stop ownership. */
+export function runGraphLayout(cy, input, onComplete) {
+    const layout = cy.layout(createLayoutOptions(input));
+    const handleStop = () => onComplete();
+    cy.one('layoutstop', handleStop);
+    layout.run();
+    return {
+        stop() {
+            stopGraphLayout(cy, layout, handleStop);
+        },
+    };
+}
+/*** Build layout options while reserving fit ownership for the graph runtime. */
+function createLayoutOptions(input) {
+    return {
+        ...(input.layoutOptions ?? {}),
+        name: input.layout,
+        spacingFactor: input.spacingFactor,
+        nodeDimensionsIncludeLabels: true,
+        fit: false,
+        animate: false,
+    };
+}
+/*** Stop one layout without allowing its stale layout-stop callback to escape. */
+function stopGraphLayout(cy, layout, handleStop) {
+    cy.off('layoutstop', handleStop);
+    try {
+        layout.stop();
+    }
+    catch {
+        // Cytoscape may already have disposed a superseded layout.
+    }
+}
+//# sourceMappingURL=runGraphLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runGraphLayout.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/runGraphLayout.ts"],"names":[],"mappings":"AAcA,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAC5B,EAAQ,EACR,KAA0B,EAC1B,UAAsB;IAEtB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;IACtC,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,EAAE,CAAC;IAEb,OAAO;QACL,IAAI;YACF,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,SAAS,mBAAmB,CAAC,KAA0B;IACrD,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;QAC9B,IAAI,EAAE,KAAK,CAAC,MAAM;QAClB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,2BAA2B,EAAE,IAAI;QACjC,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,SAAS,eAAe,CAAC,EAAQ,EAAE,MAAe,EAAE,UAAsB;IACxE,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC","sourcesContent":["import type { Core, LayoutOptions, Layouts } from 'cytoscape';\n\nimport type { GraphViewLayoutName } from './GraphView';\n\ninterface RunGraphLayoutInput {\n  readonly layout: GraphViewLayoutName;\n  readonly layoutOptions?: Readonly<Record<string, unknown>>;\n  readonly spacingFactor: number;\n}\n\ninterface GraphLayoutSession {\n  stop(): void;\n}\n\n/*** Run one Cytoscape layout with automatic fitting disabled and explicit stop ownership. */\nexport function runGraphLayout(\n  cy: Core,\n  input: RunGraphLayoutInput,\n  onComplete: () => void,\n): GraphLayoutSession {\n  const layout = cy.layout(createLayoutOptions(input));\n  const handleStop = () => onComplete();\n  cy.one('layoutstop', handleStop);\n  layout.run();\n\n  return {\n    stop() {\n      stopGraphLayout(cy, layout, handleStop);\n    },\n  };\n}\n\n/*** Build layout options while reserving fit ownership for the graph runtime. */\nfunction createLayoutOptions(input: RunGraphLayoutInput): LayoutOptions {\n  return {\n    ...(input.layoutOptions ?? {}),\n    name: input.layout,\n    spacingFactor: input.spacingFactor,\n    nodeDimensionsIncludeLabels: true,\n    fit: false,\n    animate: false,\n  };\n}\n\n/*** Stop one layout without allowing its stale layout-stop callback to escape. */\nfunction stopGraphLayout(cy: Core, layout: Layouts, handleStop: () => void) {\n  cy.off('layoutstop', handleStop);\n  try {\n    layout.stop();\n  } catch {\n    // Cytoscape may already have disposed a superseded layout.\n  }\n}\n"]}

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

@@ -0,0 +1,3 @@
+/*** Schedule one graph-runtime callback after browser paint with a non-browser fallback. */
+export declare function scheduleGraphFrame(callback: () => void): void;
+//# sourceMappingURL=scheduleGraphFrame.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleGraphFrame.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/scheduleGraphFrame.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,QAWtD"}

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

@@ -0,0 +1,10 @@
+/*** Schedule one graph-runtime callback after browser paint with a non-browser fallback. */
+export function scheduleGraphFrame(callback) {
+    const frame = globalThis.requestAnimationFrame;
+    if (frame) {
+        frame(callback);
+        return;
+    }
+    setTimeout(callback, 0);
+}
+//# sourceMappingURL=scheduleGraphFrame.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleGraphFrame.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/scheduleGraphFrame.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,CAAC,QAAoB;IACrD,MAAM,KAAK,GACT,UAGD,CAAC,qBAAqB,CAAC;IACxB,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IACD,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["/*** Schedule one graph-runtime callback after browser paint with a non-browser fallback. */\nexport function scheduleGraphFrame(callback: () => void) {\n  const frame = (\n    globalThis as unknown as {\n      requestAnimationFrame?: (scheduled: () => void) => number;\n    }\n  ).requestAnimationFrame;\n  if (frame) {\n    frame(callback);\n    return;\n  }\n  setTimeout(callback, 0);\n}\n"]}

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

@@ -0,0 +1,5 @@
+import type { Core } from 'cytoscape';
+import type { GraphViewEdge, GraphViewNode } from './GraphView';
+/*** Replace Cytoscape elements from the current plain graph projection in one batch. */
+export declare function syncGraphElements(cy: Core, nodes: readonly GraphViewNode[], edges: readonly GraphViewEdge[]): void;
+//# sourceMappingURL=syncGraphElements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syncGraphElements.d.ts","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/syncGraphElements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,wFAAwF;AACxF,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,IAAI,EACR,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,QAShC"}

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

@@ -0,0 +1,12 @@
+import { createRenderableGraphElements } from './createRenderableGraphElements';
+/*** Replace Cytoscape elements from the current plain graph projection in one batch. */
+export function syncGraphElements(cy, nodes, edges) {
+    if (cy.destroyed())
+        return;
+    const elements = createRenderableGraphElements(nodes, edges);
+    cy.batch(() => {
+        cy.elements().remove();
+        cy.add(elements);
+    });
+}
+//# sourceMappingURL=syncGraphElements.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"syncGraphElements.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/syncGraphElements.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAGhF,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAC/B,EAAQ,EACR,KAA+B,EAC/B,KAA+B;IAE/B,IAAI,EAAE,CAAC,SAAS,EAAE;QAAE,OAAO;IAE3B,MAAM,QAAQ,GAAG,6BAA6B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC7D,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QACZ,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QACvB,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { Core } from 'cytoscape';\n\nimport { createRenderableGraphElements } from './createRenderableGraphElements';\nimport type { GraphViewEdge, GraphViewNode } from './GraphView';\n\n/*** Replace Cytoscape elements from the current plain graph projection in one batch. */\nexport function syncGraphElements(\n  cy: Core,\n  nodes: readonly GraphViewNode[],\n  edges: readonly GraphViewEdge[],\n) {\n  if (cy.destroyed()) return;\n\n  const elements = createRenderableGraphElements(nodes, edges);\n  cy.batch(() => {\n    cy.elements().remove();\n    cy.add(elements);\n  });\n}\n"]}

package/dist/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"materializeWebComponentArtifactAsync.d.ts","sourceRoot":"","sources":["../../../../../src/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sDAAsD,CAAC;AAE/G,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AAED,8FAA8F;AAC9F,wBAAsB,oCAAoC,CACxD,KAAK,EAAE,oCAAoC,EAC3C,UAAU,EAAE,kCAAkC,GAC7C,OAAO,CAAC,qCAAqC,CAAC,CAwChD"}
+{"version":3,"file":"materializeWebComponentArtifactAsync.d.ts","sourceRoot":"","sources":["../../../../../src/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sDAAsD,CAAC;AAE/G,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AAED,8FAA8F;AAC9F,wBAAsB,oCAAoC,CACxD,KAAK,EAAE,oCAAoC,EAC3C,UAAU,EAAE,kCAAkC,GAC7C,OAAO,CAAC,qCAAqC,CAAC,CA4ChD"}

package/dist/features/web-component-artifact/application/use-cases/materializeWebComponentArtifactAsync.js

@@ -1,7 +1,7 @@
 /*** Materialize one replaceable web-only component artifact from the published ZORA build. */
 export async function materializeWebComponentArtifactAsync(input, fileSystem) {
-    const artifact = resolveWebArtifact(input.component);
-    const sourceDirectory = fileSystem.joinPath(input.packageRoot, 'web-dist', artifact.directory);
+    const sourceDirectory = fileSystem.joinPath(input.packageRoot, 'web-dist', input.component);
+    const artifact = await readWebArtifactDefinitionAsync(sourceDirectory, input.component, fileSystem);
     await fileSystem.ensureDirectoryAsync(input.outputDirectory);
     const createdFiles = await Promise.all(artifact.files.map(async (fileName) => {
         const sourcePath = fileSystem.joinPath(sourceDirectory, fileName);
@@ -25,15 +25,30 @@ export async function materializeWebComponentArtifactAsync(input, fileSystem) {
         platform: 'web',
     };
 }
-/*** Resolve the canonical packaged web artifact for a requested component. */
-function resolveWebArtifact(component) {
-    if (component === 'tree-view') {
-        return {
-            directory: 'tree-view',
-            files: ['TreeView.js', 'TreeView.d.ts'],
-        };
+/*** Read one packaged artifact manifest so new web components require no CLI branching. */
+async function readWebArtifactDefinitionAsync(sourceDirectory, component, fileSystem) {
+    const manifestPath = fileSystem.joinPath(sourceDirectory, 'artifact.json');
+    const manifestSource = await readWebArtifactManifestSourceAsync(manifestPath, component, fileSystem);
+    const parsed = JSON.parse(manifestSource);
+    if (parsed.component !== component ||
+        !Array.isArray(parsed.files) ||
+        parsed.files.length === 0 ||
+        !parsed.files.every((fileName) => typeof fileName === 'string' && fileName.length > 0)) {
+        throw new Error(`Invalid ZORA web artifact manifest: ${component}`);
+    }
+    return {
+        component,
+        files: parsed.files,
+    };
+}
+/*** Read an artifact manifest and translate missing packages into the CLI-facing error. */
+async function readWebArtifactManifestSourceAsync(manifestPath, component, fileSystem) {
+    try {
+        return await fileSystem.readTextFileAsync(manifestPath);
+    }
+    catch {
+        throw new Error(`Unsupported ZORA web component: ${component}`);
     }
-    throw new Error(`Unsupported ZORA web component: ${component}`);
 }
 /*** Add a generated-file marker without changing the compiled artifact semantics. */
 function createGeneratedSource(packageVersion, source) {