@ankhorage/zora 21.0.22 → 21.1.0

package/dist/features/game/utils/useGameEntityAnimatedStyle.js

@@ -0,0 +1,52 @@
+import { Animated } from 'react-native';
+import { resolveGameEntityMotionPlan } from './resolveGameEntityMotionPlan';
+import { useAnimatedGameEntityValue } from './useAnimatedGameEntityValue';
+import { useGameEntityMotionProgress } from './useGameEntityMotionProgress';
+import { useGameReducedMotion } from './useGameReducedMotion';
+/*** Compose bound GameEntity values with optional relative presentation motion. */
+export function useGameEntityAnimatedStyle(input) {
+    const reduceMotion = useGameReducedMotion();
+    const plan = resolveGameEntityMotionPlan(input, reduceMotion);
+    const values = {
+        x: useAnimatedGameEntityValue(input.x ?? 0, plan.transitionDurationMs, plan.transitionEasing),
+        y: useAnimatedGameEntityValue(input.y ?? 0, plan.transitionDurationMs, plan.transitionEasing),
+        opacity: useAnimatedGameEntityValue(input.opacity ?? 1, plan.transitionDurationMs, plan.transitionEasing),
+        scale: useAnimatedGameEntityValue(input.scale ?? 1, plan.transitionDurationMs, plan.transitionEasing),
+        rotation: useAnimatedGameEntityValue(input.rotation ?? 0, plan.transitionDurationMs, plan.transitionEasing),
+        progress: useGameEntityMotionProgress(plan),
+    };
+    return createGameEntityAnimatedStyle(values, input);
+}
+/*** Build one animated React Native style from base values and relative motion progress. */
+function createGameEntityAnimatedStyle(values, input) {
+    const left = Animated.add(values.x, Animated.multiply(values.progress, input.motionOffsetX ?? 0));
+    const top = Animated.add(values.y, Animated.multiply(values.progress, input.motionOffsetY ?? 0));
+    const opacity = Animated.add(values.opacity, Animated.multiply(values.progress, input.motionOpacityDelta ?? 0));
+    const scale = Animated.add(values.scale, Animated.multiply(values.progress, input.motionScaleDelta ?? 0));
+    const rotation = Animated.add(values.rotation, Animated.multiply(values.progress, input.motionRotationDelta ?? 0));
+    return {
+        left: left.interpolate({
+            inputRange: [-10_000, 10_000],
+            outputRange: ['-10000%', '10000%'],
+        }),
+        top: top.interpolate({
+            inputRange: [-10_000, 10_000],
+            outputRange: ['-10000%', '10000%'],
+        }),
+        opacity: opacity.interpolate({
+            inputRange: [0, 1],
+            outputRange: [0, 1],
+            extrapolate: 'clamp',
+        }),
+        transform: [
+            { scale },
+            {
+                rotate: rotation.interpolate({
+                    inputRange: [-36_000, 36_000],
+                    outputRange: ['-36000deg', '36000deg'],
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=useGameEntityAnimatedStyle.js.map

package/dist/features/game/utils/useGameEntityAnimatedStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameEntityAnimatedStyle.js","sourceRoot":"","sources":["../../../../src/features/game/utils/useGameEntityAnimatedStyle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAW9D,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,KAAsB;IAC/D,MAAM,YAAY,GAAG,oBAAoB,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,MAAM,GAA6B;QACvC,CAAC,EAAE,0BAA0B,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,gBAAgB,CAAC;QAC7F,CAAC,EAAE,0BAA0B,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,gBAAgB,CAAC;QAC7F,OAAO,EAAE,0BAA0B,CACjC,KAAK,CAAC,OAAO,IAAI,CAAC,EAClB,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,gBAAgB,CACtB;QACD,KAAK,EAAE,0BAA0B,CAC/B,KAAK,CAAC,KAAK,IAAI,CAAC,EAChB,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,gBAAgB,CACtB;QACD,QAAQ,EAAE,0BAA0B,CAClC,KAAK,CAAC,QAAQ,IAAI,CAAC,EACnB,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,gBAAgB,CACtB;QACD,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC;KAC5C,CAAC;IAEF,OAAO,6BAA6B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,4FAA4F;AAC5F,SAAS,6BAA6B,CAAC,MAAgC,EAAE,KAAsB;IAC7F,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAC1B,MAAM,CAAC,OAAO,EACd,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC,CAClE,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACxB,MAAM,CAAC,KAAK,EACZ,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAChE,CAAC;IACF,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAC3B,MAAM,CAAC,QAAQ,EACf,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC,CACnE,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;YACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;YAC7B,WAAW,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;SACnC,CAAC;QACF,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC;YACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;YAC7B,WAAW,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;SACnC,CAAC;QACF,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC;YAC3B,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAClB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACnB,WAAW,EAAE,OAAO;SACrB,CAAC;QACF,SAAS,EAAE;YACT,EAAE,KAAK,EAAE;YACT;gBACE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC;oBAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;oBAC7B,WAAW,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;iBACvC,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { Animated } from 'react-native';\n\nimport type { GameEntityProps } from '../../../types/gamePresentation';\nimport { resolveGameEntityMotionPlan } from './resolveGameEntityMotionPlan';\nimport { useAnimatedGameEntityValue } from './useAnimatedGameEntityValue';\nimport { useGameEntityMotionProgress } from './useGameEntityMotionProgress';\nimport { useGameReducedMotion } from './useGameReducedMotion';\n\ninterface GameEntityAnimatedValues {\n  readonly x: Animated.Value;\n  readonly y: Animated.Value;\n  readonly opacity: Animated.Value;\n  readonly scale: Animated.Value;\n  readonly rotation: Animated.Value;\n  readonly progress: Animated.Value;\n}\n\n/*** Compose bound GameEntity values with optional relative presentation motion. */\nexport function useGameEntityAnimatedStyle(input: GameEntityProps) {\n  const reduceMotion = useGameReducedMotion();\n  const plan = resolveGameEntityMotionPlan(input, reduceMotion);\n  const values: GameEntityAnimatedValues = {\n    x: useAnimatedGameEntityValue(input.x ?? 0, plan.transitionDurationMs, plan.transitionEasing),\n    y: useAnimatedGameEntityValue(input.y ?? 0, plan.transitionDurationMs, plan.transitionEasing),\n    opacity: useAnimatedGameEntityValue(\n      input.opacity ?? 1,\n      plan.transitionDurationMs,\n      plan.transitionEasing,\n    ),\n    scale: useAnimatedGameEntityValue(\n      input.scale ?? 1,\n      plan.transitionDurationMs,\n      plan.transitionEasing,\n    ),\n    rotation: useAnimatedGameEntityValue(\n      input.rotation ?? 0,\n      plan.transitionDurationMs,\n      plan.transitionEasing,\n    ),\n    progress: useGameEntityMotionProgress(plan),\n  };\n\n  return createGameEntityAnimatedStyle(values, input);\n}\n\n/*** Build one animated React Native style from base values and relative motion progress. */\nfunction createGameEntityAnimatedStyle(values: GameEntityAnimatedValues, input: GameEntityProps) {\n  const left = Animated.add(values.x, Animated.multiply(values.progress, input.motionOffsetX ?? 0));\n  const top = Animated.add(values.y, Animated.multiply(values.progress, input.motionOffsetY ?? 0));\n  const opacity = Animated.add(\n    values.opacity,\n    Animated.multiply(values.progress, input.motionOpacityDelta ?? 0),\n  );\n  const scale = Animated.add(\n    values.scale,\n    Animated.multiply(values.progress, input.motionScaleDelta ?? 0),\n  );\n  const rotation = Animated.add(\n    values.rotation,\n    Animated.multiply(values.progress, input.motionRotationDelta ?? 0),\n  );\n\n  return {\n    left: left.interpolate({\n      inputRange: [-10_000, 10_000],\n      outputRange: ['-10000%', '10000%'],\n    }),\n    top: top.interpolate({\n      inputRange: [-10_000, 10_000],\n      outputRange: ['-10000%', '10000%'],\n    }),\n    opacity: opacity.interpolate({\n      inputRange: [0, 1],\n      outputRange: [0, 1],\n      extrapolate: 'clamp',\n    }),\n    transform: [\n      { scale },\n      {\n        rotate: rotation.interpolate({\n          inputRange: [-36_000, 36_000],\n          outputRange: ['-36000deg', '36000deg'],\n        }),\n      },\n    ],\n  };\n}\n"]}

package/dist/features/game/utils/useGameEntityMeasurement.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { View } from 'react-native';
+/*** Register one optional measurable GameEntity view inside its local Game scope. */
+export declare function useGameEntityMeasurement(elementRef: React.RefObject<View | null>, measurementId: string | undefined): void;
+//# sourceMappingURL=useGameEntityMeasurement.d.ts.map

package/dist/features/game/utils/useGameEntityMeasurement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameEntityMeasurement.d.ts","sourceRoot":"","sources":["../../../../src/features/game/utils/useGameEntityMeasurement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAKzC,qFAAqF;AACrF,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,EACxC,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,IAAI,CAQN"}

package/dist/features/game/utils/useGameEntityMeasurement.js

@@ -0,0 +1,14 @@
+import React from 'react';
+import { measureGameEntity } from '../adapters/inbound/measureGameEntity';
+import { GameRuntimeContext } from '../composition/GameRuntimeContext';
+/*** Register one optional measurable GameEntity view inside its local Game scope. */
+export function useGameEntityMeasurement(elementRef, measurementId) {
+    const runtime = React.useContext(GameRuntimeContext);
+    const registerMeasurement = runtime?.registerMeasurement;
+    React.useEffect(() => {
+        if (measurementId === undefined || registerMeasurement === undefined)
+            return undefined;
+        return registerMeasurement(measurementId, () => measureGameEntity(elementRef.current));
+    }, [elementRef, measurementId, registerMeasurement]);
+}
+//# sourceMappingURL=useGameEntityMeasurement.js.map

package/dist/features/game/utils/useGameEntityMeasurement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameEntityMeasurement.js","sourceRoot":"","sources":["../../../../src/features/game/utils/useGameEntityMeasurement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,qFAAqF;AACrF,MAAM,UAAU,wBAAwB,CACtC,UAAwC,EACxC,aAAiC;IAEjC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACrD,MAAM,mBAAmB,GAAG,OAAO,EAAE,mBAAmB,CAAC;IAEzD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,aAAa,KAAK,SAAS,IAAI,mBAAmB,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACvF,OAAO,mBAAmB,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACzF,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC;AACvD,CAAC","sourcesContent":["import React from 'react';\nimport type { View } from 'react-native';\n\nimport { measureGameEntity } from '../adapters/inbound/measureGameEntity';\nimport { GameRuntimeContext } from '../composition/GameRuntimeContext';\n\n/*** Register one optional measurable GameEntity view inside its local Game scope. */\nexport function useGameEntityMeasurement(\n  elementRef: React.RefObject<View | null>,\n  measurementId: string | undefined,\n): void {\n  const runtime = React.useContext(GameRuntimeContext);\n  const registerMeasurement = runtime?.registerMeasurement;\n\n  React.useEffect(() => {\n    if (measurementId === undefined || registerMeasurement === undefined) return undefined;\n    return registerMeasurement(measurementId, () => measureGameEntity(elementRef.current));\n  }, [elementRef, measurementId, registerMeasurement]);\n}\n"]}

package/dist/features/game/utils/useGameEntityMotionProgress.d.ts

@@ -0,0 +1,5 @@
+import { Animated } from 'react-native';
+import type { GameEntityMotionPlan } from './resolveGameEntityMotionPlan';
+/*** Drive one optional relative GameEntity motion timeline without changing game-session state. */
+export declare function useGameEntityMotionProgress(plan: GameEntityMotionPlan): Animated.Value;
+//# sourceMappingURL=useGameEntityMotionProgress.d.ts.map

package/dist/features/game/utils/useGameEntityMotionProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameEntityMotionProgress.d.ts","sourceRoot":"","sources":["../../../../src/features/game/utils/useGameEntityMotionProgress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAU,MAAM,cAAc,CAAC;AAGhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAU1E,mGAAmG;AACnG,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAAC,KAAK,CAmDtF"}

package/dist/features/game/utils/useGameEntityMotionProgress.js

@@ -0,0 +1,87 @@
+import React from 'react';
+import { Animated, Easing } from 'react-native';
+/*** Drive one optional relative GameEntity motion timeline without changing game-session state. */
+export function useGameEntityMotionProgress(plan) {
+    const [progress] = React.useState(() => new Animated.Value(0));
+    const signature = createMotionSignature(plan);
+    const previousSignature = React.useRef(signature);
+    const { motionEnabled, motionPaused, motionDurationMs, motionDelayMs, motionEasing, motionRepeat, motionAlternate, } = plan;
+    React.useEffect(() => {
+        progress.stopAnimation();
+        if (!motionEnabled) {
+            progress.setValue(0);
+            return undefined;
+        }
+        if (previousSignature.current !== signature) {
+            progress.setValue(0);
+            previousSignature.current = signature;
+        }
+        if (motionPaused)
+            return undefined;
+        const animation = createMotionAnimation(progress, {
+            durationMs: motionDurationMs,
+            delayMs: motionDelayMs,
+            easing: motionEasing,
+            repeat: motionRepeat,
+            alternate: motionAlternate,
+        });
+        animation.start();
+        return () => animation.stop();
+    }, [
+        motionAlternate,
+        motionDelayMs,
+        motionDurationMs,
+        motionEasing,
+        motionEnabled,
+        motionPaused,
+        motionRepeat,
+        progress,
+        signature,
+    ]);
+    return progress;
+}
+/*** Create the one-shot or repeating React Native motion sequence for one entity. */
+function createMotionAnimation(progress, input) {
+    const forward = () => Animated.timing(progress, {
+        toValue: 1,
+        duration: input.durationMs,
+        easing: resolveMotionEasing(input.easing),
+        useNativeDriver: false,
+    });
+    const reverse = () => Animated.timing(progress, {
+        toValue: 0,
+        duration: input.durationMs,
+        easing: resolveMotionEasing(input.easing),
+        useNativeDriver: false,
+    });
+    const movement = input.alternate
+        ? Animated.loop(Animated.sequence([forward(), reverse()]))
+        : input.repeat
+            ? Animated.loop(forward())
+            : forward();
+    return input.delayMs === 0
+        ? movement
+        : Animated.sequence([Animated.delay(input.delayMs), movement]);
+}
+/*** Create a stable signature for motion parameters that should restart the relative timeline. */
+function createMotionSignature(plan) {
+    return [
+        plan.motionDurationMs,
+        plan.motionDelayMs,
+        plan.motionEasing,
+        plan.motionEnabled,
+        plan.motionRepeat,
+        plan.motionAlternate,
+    ].join(':');
+}
+/*** Map serializable timeline easing names onto React Native easing functions. */
+function resolveMotionEasing(easing) {
+    if (easing === 'ease-in')
+        return Easing.in(Easing.ease);
+    if (easing === 'ease-out')
+        return Easing.out(Easing.ease);
+    if (easing === 'ease-in-out')
+        return Easing.inOut(Easing.ease);
+    return Easing.linear;
+}
+//# sourceMappingURL=useGameEntityMotionProgress.js.map

package/dist/features/game/utils/useGameEntityMotionProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameEntityMotionProgress.js","sourceRoot":"","sources":["../../../../src/features/game/utils/useGameEntityMotionProgress.ts"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\nimport { Animated, Easing } from 'react-native';\n\nimport type { GameEntityEasing } from '../../../types/gamePresentation';\nimport type { GameEntityMotionPlan } from './resolveGameEntityMotionPlan';\n\ninterface MotionAnimationInput {\n  readonly durationMs: number;\n  readonly delayMs: number;\n  readonly easing: GameEntityEasing;\n  readonly repeat: boolean;\n  readonly alternate: boolean;\n}\n\n/*** Drive one optional relative GameEntity motion timeline without changing game-session state. */\nexport function useGameEntityMotionProgress(plan: GameEntityMotionPlan): Animated.Value {\n  const [progress] = React.useState(() => new Animated.Value(0));\n  const signature = createMotionSignature(plan);\n  const previousSignature = React.useRef(signature);\n  const {\n    motionEnabled,\n    motionPaused,\n    motionDurationMs,\n    motionDelayMs,\n    motionEasing,\n    motionRepeat,\n    motionAlternate,\n  } = plan;\n\n  React.useEffect(() => {\n    progress.stopAnimation();\n\n    if (!motionEnabled) {\n      progress.setValue(0);\n      return undefined;\n    }\n\n    if (previousSignature.current !== signature) {\n      progress.setValue(0);\n      previousSignature.current = signature;\n    }\n\n    if (motionPaused) return undefined;\n\n    const animation = createMotionAnimation(progress, {\n      durationMs: motionDurationMs,\n      delayMs: motionDelayMs,\n      easing: motionEasing,\n      repeat: motionRepeat,\n      alternate: motionAlternate,\n    });\n    animation.start();\n    return () => animation.stop();\n  }, [\n    motionAlternate,\n    motionDelayMs,\n    motionDurationMs,\n    motionEasing,\n    motionEnabled,\n    motionPaused,\n    motionRepeat,\n    progress,\n    signature,\n  ]);\n\n  return progress;\n}\n\n/*** Create the one-shot or repeating React Native motion sequence for one entity. */\nfunction createMotionAnimation(progress: Animated.Value, input: MotionAnimationInput) {\n  const forward = () =>\n    Animated.timing(progress, {\n      toValue: 1,\n      duration: input.durationMs,\n      easing: resolveMotionEasing(input.easing),\n      useNativeDriver: false,\n    });\n  const reverse = () =>\n    Animated.timing(progress, {\n      toValue: 0,\n      duration: input.durationMs,\n      easing: resolveMotionEasing(input.easing),\n      useNativeDriver: false,\n    });\n  const movement = input.alternate\n    ? Animated.loop(Animated.sequence([forward(), reverse()]))\n    : input.repeat\n      ? Animated.loop(forward())\n      : forward();\n\n  return input.delayMs === 0\n    ? movement\n    : Animated.sequence([Animated.delay(input.delayMs), movement]);\n}\n\n/*** Create a stable signature for motion parameters that should restart the relative timeline. */\nfunction createMotionSignature(plan: GameEntityMotionPlan): string {\n  return [\n    plan.motionDurationMs,\n    plan.motionDelayMs,\n    plan.motionEasing,\n    plan.motionEnabled,\n    plan.motionRepeat,\n    plan.motionAlternate,\n  ].join(':');\n}\n\n/*** Map serializable timeline easing names onto React Native easing functions. */\nfunction resolveMotionEasing(easing: GameEntityEasing) {\n  if (easing === 'ease-in') return Easing.in(Easing.ease);\n  if (easing === 'ease-out') return Easing.out(Easing.ease);\n  if (easing === 'ease-in-out') return Easing.inOut(Easing.ease);\n  return Easing.linear;\n}\n"]}

package/dist/features/game/utils/useGameReducedMotion.d.ts

@@ -0,0 +1,3 @@
+/*** Track the cross-platform system reduced-motion preference for game presentation. */
+export declare function useGameReducedMotion(): boolean;
+//# sourceMappingURL=useGameReducedMotion.d.ts.map

package/dist/features/game/utils/useGameReducedMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameReducedMotion.d.ts","sourceRoot":"","sources":["../../../../src/features/game/utils/useGameReducedMotion.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,wBAAgB,oBAAoB,IAAI,OAAO,CAU9C"}

package/dist/features/game/utils/useGameReducedMotion.js

@@ -0,0 +1,13 @@
+import React from 'react';
+import { AccessibilityInfo } from 'react-native';
+/*** Track the cross-platform system reduced-motion preference for game presentation. */
+export function useGameReducedMotion() {
+    const [reduceMotion, setReduceMotion] = React.useState(false);
+    React.useEffect(() => {
+        void AccessibilityInfo.isReduceMotionEnabled().then(setReduceMotion);
+        const subscription = AccessibilityInfo.addEventListener('reduceMotionChanged', setReduceMotion);
+        return () => subscription.remove();
+    }, []);
+    return reduceMotion;
+}
+//# sourceMappingURL=useGameReducedMotion.js.map

package/dist/features/game/utils/useGameReducedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameReducedMotion.js","sourceRoot":"","sources":["../../../../src/features/game/utils/useGameReducedMotion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,wFAAwF;AACxF,MAAM,UAAU,oBAAoB;IAClC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9D,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,KAAK,iBAAiB,CAAC,qBAAqB,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACrE,MAAM,YAAY,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,qBAAqB,EAAE,eAAe,CAAC,CAAC;QAChG,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,YAAY,CAAC;AACtB,CAAC","sourcesContent":["import React from 'react';\nimport { AccessibilityInfo } from 'react-native';\n\n/*** Track the cross-platform system reduced-motion preference for game presentation. */\nexport function useGameReducedMotion(): boolean {\n  const [reduceMotion, setReduceMotion] = React.useState(false);\n\n  React.useEffect(() => {\n    void AccessibilityInfo.isReduceMotionEnabled().then(setReduceMotion);\n    const subscription = AccessibilityInfo.addEventListener('reduceMotionChanged', setReduceMotion);\n    return () => subscription.remove();\n  }, []);\n\n  return reduceMotion;\n}\n"]}

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

@@ -97,13 +97,13 @@ export interface GraphViewProps {
 export type GraphViewCallbacks = Pick<GraphViewProps, 'onEdgeEvent' | 'onLayoutComplete' | 'onNodeEvent' | 'onReady' | 'onViewportChange' | 'onSpacingFactorChange'>;
 /***
  * Render a browser graph while one runtime owns Cytoscape layout, viewport, and disposal.
- * @config zoomMode Use `fit-relative` to make controller zoom, events and min/max limits relative
+ * zoomMode Use `fit-relative` to make controller zoom, events and min/max limits relative
  * to the visible-node fit (1 = fit). The default `absolute` keeps engine-space zoom units.
- * @config sizeNodesToLabels Opt in to renderer-measured plain labels, including bold and Unicode
+ * sizeNodesToLabels Opt in to renderer-measured plain labels, including bold and Unicode
  * text. Keep padding in styleRules. Compound and rich-node dimensions retain their existing owners.
- * @config minReadableLabelSize Expand the manual zoom ceiling until plain labels reach this CSS-pixel size.
- * @config maxFitLabelSize Cap automatic fitting at this plain-label CSS-pixel size, leaving whitespace for tiny graphs.
- * @config onSpacingFactorChange Receive the spacing accepted by explicit fit({ optimizeSpacing: true }).
+ * minReadableLabelSize Expand the manual zoom ceiling until plain labels reach this CSS-pixel size.
+ * maxFitLabelSize Cap automatic fitting at this plain-label CSS-pixel size, leaving whitespace for tiny graphs.
+ * onSpacingFactorChange Receive the spacing accepted by explicit fit({ optimizeSpacing: true }).
  * Ordinary zoom never adjusts spacing or relayouts. Explicit optimization preserves layout ordering
  * and uses bounded collision checks including labels and compound siblings; it can recover uniformly
  * cramped layouts but cannot repair non-uniform overlaps.

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

@@ -3,13 +3,13 @@ import { createGraphRuntime } from './createGraphRuntime';
 import { GraphNodeOverlay } from './GraphNodeOverlay';
 /***
  * Render a browser graph while one runtime owns Cytoscape layout, viewport, and disposal.
- * @config zoomMode Use `fit-relative` to make controller zoom, events and min/max limits relative
+ * zoomMode Use `fit-relative` to make controller zoom, events and min/max limits relative
  * to the visible-node fit (1 = fit). The default `absolute` keeps engine-space zoom units.
- * @config sizeNodesToLabels Opt in to renderer-measured plain labels, including bold and Unicode
+ * sizeNodesToLabels Opt in to renderer-measured plain labels, including bold and Unicode
  * text. Keep padding in styleRules. Compound and rich-node dimensions retain their existing owners.
- * @config minReadableLabelSize Expand the manual zoom ceiling until plain labels reach this CSS-pixel size.
- * @config maxFitLabelSize Cap automatic fitting at this plain-label CSS-pixel size, leaving whitespace for tiny graphs.
- * @config onSpacingFactorChange Receive the spacing accepted by explicit fit({ optimizeSpacing: true }).
+ * minReadableLabelSize Expand the manual zoom ceiling until plain labels reach this CSS-pixel size.
+ * maxFitLabelSize Cap automatic fitting at this plain-label CSS-pixel size, leaving whitespace for tiny graphs.
+ * onSpacingFactorChange Receive the spacing accepted by explicit fit({ optimizeSpacing: true }).
  * Ordinary zoom never adjusts spacing or relayouts. Explicit optimization preserves layout ordering
  * and uses bounded collision checks including labels and compound siblings; it can recover uniformly
  * cramped layouts but cannot repair non-uniform overlaps.

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

@@ -1 +1 @@
-{"version":3,"file":"GraphView.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/GraphView.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { CytoscapeOptions } from 'cytoscape';\nimport React from 'react';\n\nimport { createGraphRuntime, type GraphRuntime } from './createGraphRuntime';\nimport { GraphNodeOverlay } from './GraphNodeOverlay';\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\ntype GraphContainer = NonNullable<CytoscapeOptions['container']>;\n\n/***\n * Render a browser graph while one runtime owns Cytoscape layout, viewport, and disposal.\n * @config zoomMode Use `fit-relative` to make controller zoom, events and min/max limits relative\n * to the visible-node fit (1 = fit). The default `absolute` keeps engine-space zoom units.\n * @config sizeNodesToLabels Opt in to renderer-measured plain labels, including bold and Unicode\n * text. Keep padding in styleRules. Compound and rich-node dimensions retain their existing owners.\n * @config minReadableLabelSize Expand the manual zoom ceiling until plain labels reach this CSS-pixel size.\n * @config maxFitLabelSize Cap automatic fitting at this plain-label CSS-pixel size, leaving whitespace for tiny graphs.\n * @config onSpacingFactorChange Receive the spacing accepted by explicit fit({ optimizeSpacing: true }).\n * Ordinary zoom never adjusts spacing or relayouts. Explicit optimization preserves layout ordering\n * and uses bounded collision checks including labels and compound siblings; it can recover uniformly\n * cramped layouts but cannot repair non-uniform overlaps.\n */\nexport function GraphView(props: GraphViewProps) {\n  const { containerRef, renderedNodes, runtimeRef } = useGraphViewRuntime(props);\n\n  return (\n    <div\n      aria-label={props.ariaLabel ?? 'Graph'}\n      className={props.className}\n      role=\"application\"\n      style={{\n        height: '100%',\n        minHeight: 0,\n        minWidth: 0,\n        position: 'relative',\n        width: '100%',\n        ...props.style,\n      }}\n    >\n      <div ref={containerRef} style={{ height: '100%', width: '100%' }} />\n      {props.renderNode ? (\n        <GraphNodeOverlay\n          nodes={props.nodes}\n          renderedNodes={renderedNodes}\n          renderNode={props.renderNode}\n          onNodeEvent={(id, type) => runtimeRef.current?.handleOverlayNodeEvent(id, type)}\n          onNodeSize={(id, size) => runtimeRef.current?.setNodeSize(id, size)}\n        />\n      ) : null}\n    </div>\n  );\n}\n\n/*** Compose React synchronization around the single imperative graph runtime. */\nfunction useGraphViewRuntime(props: GraphViewProps) {\n  const containerRef = React.useRef<GraphContainer | null>(null);\n  const runtimeRef = React.useRef<GraphRuntime | null>(null);\n  const callbacksRef = useGraphCallbacksRef(props);\n  const [renderedNodes, setRenderedNodes] = React.useState<readonly GraphViewRenderedNode[]>([]);\n\n  useRuntimeLifecycle(containerRef, runtimeRef, callbacksRef);\n  useRuntimeGraphUpdate(runtimeRef, props);\n  useRuntimeSelection(runtimeRef, props.selectedNodeIds);\n  useRenderedNodeSubscription(runtimeRef, props.renderNode, setRenderedNodes);\n  useKnownNodeSizes(runtimeRef, props.nodes, props.getNodeSize);\n\n  return { containerRef, renderedNodes, runtimeRef };\n}\n\n/*** Keep the callback ref current without mutating refs during render. */\nfunction useGraphCallbacksRef(props: GraphViewProps) {\n  const callbacksRef = React.useRef<GraphViewCallbacks>(readCallbacks(props));\n  const {\n    onEdgeEvent,\n    onLayoutComplete,\n    onNodeEvent,\n    onReady,\n    onViewportChange,\n    onSpacingFactorChange,\n  } = props;\n\n  React.useEffect(() => {\n    callbacksRef.current = {\n      onEdgeEvent,\n      onLayoutComplete,\n      onNodeEvent,\n      onReady,\n      onViewportChange,\n      onSpacingFactorChange,\n    };\n  }, [\n    onEdgeEvent,\n    onLayoutComplete,\n    onNodeEvent,\n    onReady,\n    onViewportChange,\n    onSpacingFactorChange,\n  ]);\n\n  return callbacksRef;\n}\n\n/*** Create and dispose the runtime only with the underlying browser container lifetime. */\nfunction useRuntimeLifecycle(\n  containerRef: { current: GraphContainer | null },\n  runtimeRef: { current: GraphRuntime | null },\n  callbacksRef: { current: GraphViewCallbacks },\n) {\n  React.useEffect(() => {\n    const container = containerRef.current;\n    if (container === null) return;\n    const runtime = createGraphRuntime(container, callbacksRef);\n    runtimeRef.current = runtime;\n    return () => {\n      runtime.destroy();\n      runtimeRef.current = null;\n    };\n  }, [callbacksRef, containerRef, runtimeRef]);\n}\n\n/*** Synchronize graph data and layout policy without exposing Cytoscape to React. */\nfunction useRuntimeGraphUpdate(\n  runtimeRef: { current: GraphRuntime | null },\n  props: GraphViewProps,\n) {\n  const {\n    edges,\n    fitPadding,\n    layout,\n    layoutOptions,\n    maxZoom,\n    minReadableLabelSize,\n    maxFitLabelSize,\n    minZoom,\n    zoomMode,\n    sizeNodesToLabels,\n    nodes,\n    renderNode,\n    spacingFactor,\n    styleRules,\n  } = props;\n\n  React.useEffect(() => {\n    runtimeRef.current?.update({\n      edges,\n      fitPadding,\n      layout,\n      layoutOptions,\n      maxZoom,\n      minReadableLabelSize,\n      maxFitLabelSize,\n      minZoom,\n      zoomMode,\n      sizeNodesToLabels,\n      nodes,\n      richNodeRendering: renderNode !== undefined,\n      spacingFactor,\n      styleRules,\n    });\n  }, [\n    edges,\n    fitPadding,\n    layout,\n    layoutOptions,\n    maxZoom,\n    minReadableLabelSize,\n    maxFitLabelSize,\n    minZoom,\n    zoomMode,\n    sizeNodesToLabels,\n    nodes,\n    renderNode,\n    runtimeRef,\n    spacingFactor,\n    styleRules,\n  ]);\n}\n\n/*** Synchronize optional controlled selection independently from graph layout. */\nfunction useRuntimeSelection(\n  runtimeRef: { current: GraphRuntime | null },\n  selectedNodeIds: readonly string[] | undefined,\n) {\n  React.useEffect(() => {\n    runtimeRef.current?.setSelectedNodeIds(selectedNodeIds);\n  }, [runtimeRef, selectedNodeIds]);\n}\n\n/*** Subscribe the optional rich-node overlay to rendered runtime positions. */\nfunction useRenderedNodeSubscription(\n  runtimeRef: { current: GraphRuntime | null },\n  renderNode: GraphViewProps['renderNode'],\n  setRenderedNodes: (nodes: readonly GraphViewRenderedNode[]) => void,\n) {\n  React.useEffect(() => {\n    const runtime = runtimeRef.current;\n    if (runtime === null || renderNode === undefined) {\n      setRenderedNodes([]);\n      return;\n    }\n    return runtime.subscribeRenderedNodes(setRenderedNodes);\n  }, [renderNode, runtimeRef, setRenderedNodes]);\n}\n\n/*** Seed known rich-node dimensions without requiring DOM measurement. */\nfunction useKnownNodeSizes(\n  runtimeRef: { current: GraphRuntime | null },\n  nodes: readonly GraphViewNode[],\n  getNodeSize: GraphViewProps['getNodeSize'],\n) {\n  React.useEffect(() => {\n    const runtime = runtimeRef.current;\n    if (runtime === null || getNodeSize === undefined) return;\n    for (const node of nodes) {\n      const size = getNodeSize(node);\n      if (size) runtime.setNodeSize(node.id, size);\n    }\n  }, [getNodeSize, nodes, runtimeRef]);\n}\n\n/*** Read callback props for the initial runtime callback-ref value. */\nfunction readCallbacks(props: GraphViewProps): GraphViewCallbacks {\n  return {\n    onEdgeEvent: props.onEdgeEvent,\n    onLayoutComplete: props.onLayoutComplete,\n    onNodeEvent: props.onNodeEvent,\n    onReady: props.onReady,\n    onViewportChange: props.onViewportChange,\n    onSpacingFactorChange: props.onSpacingFactorChange,\n  };\n}\n"]}
+{"version":3,"file":"GraphView.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/GraphView.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { CytoscapeOptions } from 'cytoscape';\nimport React from 'react';\n\nimport { createGraphRuntime, type GraphRuntime } from './createGraphRuntime';\nimport { GraphNodeOverlay } from './GraphNodeOverlay';\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\ntype GraphContainer = NonNullable<CytoscapeOptions['container']>;\n\n/***\n * Render a browser graph while one runtime owns Cytoscape layout, viewport, and disposal.\n * zoomMode Use `fit-relative` to make controller zoom, events and min/max limits relative\n * to the visible-node fit (1 = fit). The default `absolute` keeps engine-space zoom units.\n * sizeNodesToLabels Opt in to renderer-measured plain labels, including bold and Unicode\n * text. Keep padding in styleRules. Compound and rich-node dimensions retain their existing owners.\n * minReadableLabelSize Expand the manual zoom ceiling until plain labels reach this CSS-pixel size.\n * maxFitLabelSize Cap automatic fitting at this plain-label CSS-pixel size, leaving whitespace for tiny graphs.\n * onSpacingFactorChange Receive the spacing accepted by explicit fit({ optimizeSpacing: true }).\n * Ordinary zoom never adjusts spacing or relayouts. Explicit optimization preserves layout ordering\n * and uses bounded collision checks including labels and compound siblings; it can recover uniformly\n * cramped layouts but cannot repair non-uniform overlaps.\n */\nexport function GraphView(props: GraphViewProps) {\n  const { containerRef, renderedNodes, runtimeRef } = useGraphViewRuntime(props);\n\n  return (\n    <div\n      aria-label={props.ariaLabel ?? 'Graph'}\n      className={props.className}\n      role=\"application\"\n      style={{\n        height: '100%',\n        minHeight: 0,\n        minWidth: 0,\n        position: 'relative',\n        width: '100%',\n        ...props.style,\n      }}\n    >\n      <div ref={containerRef} style={{ height: '100%', width: '100%' }} />\n      {props.renderNode ? (\n        <GraphNodeOverlay\n          nodes={props.nodes}\n          renderedNodes={renderedNodes}\n          renderNode={props.renderNode}\n          onNodeEvent={(id, type) => runtimeRef.current?.handleOverlayNodeEvent(id, type)}\n          onNodeSize={(id, size) => runtimeRef.current?.setNodeSize(id, size)}\n        />\n      ) : null}\n    </div>\n  );\n}\n\n/*** Compose React synchronization around the single imperative graph runtime. */\nfunction useGraphViewRuntime(props: GraphViewProps) {\n  const containerRef = React.useRef<GraphContainer | null>(null);\n  const runtimeRef = React.useRef<GraphRuntime | null>(null);\n  const callbacksRef = useGraphCallbacksRef(props);\n  const [renderedNodes, setRenderedNodes] = React.useState<readonly GraphViewRenderedNode[]>([]);\n\n  useRuntimeLifecycle(containerRef, runtimeRef, callbacksRef);\n  useRuntimeGraphUpdate(runtimeRef, props);\n  useRuntimeSelection(runtimeRef, props.selectedNodeIds);\n  useRenderedNodeSubscription(runtimeRef, props.renderNode, setRenderedNodes);\n  useKnownNodeSizes(runtimeRef, props.nodes, props.getNodeSize);\n\n  return { containerRef, renderedNodes, runtimeRef };\n}\n\n/*** Keep the callback ref current without mutating refs during render. */\nfunction useGraphCallbacksRef(props: GraphViewProps) {\n  const callbacksRef = React.useRef<GraphViewCallbacks>(readCallbacks(props));\n  const {\n    onEdgeEvent,\n    onLayoutComplete,\n    onNodeEvent,\n    onReady,\n    onViewportChange,\n    onSpacingFactorChange,\n  } = props;\n\n  React.useEffect(() => {\n    callbacksRef.current = {\n      onEdgeEvent,\n      onLayoutComplete,\n      onNodeEvent,\n      onReady,\n      onViewportChange,\n      onSpacingFactorChange,\n    };\n  }, [\n    onEdgeEvent,\n    onLayoutComplete,\n    onNodeEvent,\n    onReady,\n    onViewportChange,\n    onSpacingFactorChange,\n  ]);\n\n  return callbacksRef;\n}\n\n/*** Create and dispose the runtime only with the underlying browser container lifetime. */\nfunction useRuntimeLifecycle(\n  containerRef: { current: GraphContainer | null },\n  runtimeRef: { current: GraphRuntime | null },\n  callbacksRef: { current: GraphViewCallbacks },\n) {\n  React.useEffect(() => {\n    const container = containerRef.current;\n    if (container === null) return;\n    const runtime = createGraphRuntime(container, callbacksRef);\n    runtimeRef.current = runtime;\n    return () => {\n      runtime.destroy();\n      runtimeRef.current = null;\n    };\n  }, [callbacksRef, containerRef, runtimeRef]);\n}\n\n/*** Synchronize graph data and layout policy without exposing Cytoscape to React. */\nfunction useRuntimeGraphUpdate(\n  runtimeRef: { current: GraphRuntime | null },\n  props: GraphViewProps,\n) {\n  const {\n    edges,\n    fitPadding,\n    layout,\n    layoutOptions,\n    maxZoom,\n    minReadableLabelSize,\n    maxFitLabelSize,\n    minZoom,\n    zoomMode,\n    sizeNodesToLabels,\n    nodes,\n    renderNode,\n    spacingFactor,\n    styleRules,\n  } = props;\n\n  React.useEffect(() => {\n    runtimeRef.current?.update({\n      edges,\n      fitPadding,\n      layout,\n      layoutOptions,\n      maxZoom,\n      minReadableLabelSize,\n      maxFitLabelSize,\n      minZoom,\n      zoomMode,\n      sizeNodesToLabels,\n      nodes,\n      richNodeRendering: renderNode !== undefined,\n      spacingFactor,\n      styleRules,\n    });\n  }, [\n    edges,\n    fitPadding,\n    layout,\n    layoutOptions,\n    maxZoom,\n    minReadableLabelSize,\n    maxFitLabelSize,\n    minZoom,\n    zoomMode,\n    sizeNodesToLabels,\n    nodes,\n    renderNode,\n    runtimeRef,\n    spacingFactor,\n    styleRules,\n  ]);\n}\n\n/*** Synchronize optional controlled selection independently from graph layout. */\nfunction useRuntimeSelection(\n  runtimeRef: { current: GraphRuntime | null },\n  selectedNodeIds: readonly string[] | undefined,\n) {\n  React.useEffect(() => {\n    runtimeRef.current?.setSelectedNodeIds(selectedNodeIds);\n  }, [runtimeRef, selectedNodeIds]);\n}\n\n/*** Subscribe the optional rich-node overlay to rendered runtime positions. */\nfunction useRenderedNodeSubscription(\n  runtimeRef: { current: GraphRuntime | null },\n  renderNode: GraphViewProps['renderNode'],\n  setRenderedNodes: (nodes: readonly GraphViewRenderedNode[]) => void,\n) {\n  React.useEffect(() => {\n    const runtime = runtimeRef.current;\n    if (runtime === null || renderNode === undefined) {\n      setRenderedNodes([]);\n      return;\n    }\n    return runtime.subscribeRenderedNodes(setRenderedNodes);\n  }, [renderNode, runtimeRef, setRenderedNodes]);\n}\n\n/*** Seed known rich-node dimensions without requiring DOM measurement. */\nfunction useKnownNodeSizes(\n  runtimeRef: { current: GraphRuntime | null },\n  nodes: readonly GraphViewNode[],\n  getNodeSize: GraphViewProps['getNodeSize'],\n) {\n  React.useEffect(() => {\n    const runtime = runtimeRef.current;\n    if (runtime === null || getNodeSize === undefined) return;\n    for (const node of nodes) {\n      const size = getNodeSize(node);\n      if (size) runtime.setNodeSize(node.id, size);\n    }\n  }, [getNodeSize, nodes, runtimeRef]);\n}\n\n/*** Read callback props for the initial runtime callback-ref value. */\nfunction readCallbacks(props: GraphViewProps): GraphViewCallbacks {\n  return {\n    onEdgeEvent: props.onEdgeEvent,\n    onLayoutComplete: props.onLayoutComplete,\n    onNodeEvent: props.onNodeEvent,\n    onReady: props.onReady,\n    onViewportChange: props.onViewportChange,\n    onSpacingFactorChange: props.onSpacingFactorChange,\n  };\n}\n"]}

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

@@ -2,7 +2,7 @@ import type { Core } from 'cytoscape';
 /***
  * Optimize settled layout spacing around readable label bounds instead of full node clearance.
  * Compound containment stays intentional while sibling groups retain non-overlapping boundaries.
- * @performance Cytoscape geometry is measured once, then bounded pure numeric trials reuse the
+ * Cytoscape geometry is measured once, then bounded pure numeric trials reuse the
  * immutable snapshot. No layout reruns, zoom work, or intermediate frames are painted.
  */
 export declare function compactGraphSpacing(cy: Core, spacingFactor: number): number;

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

@@ -7,7 +7,7 @@ const SEARCH_ITERATIONS = 8;
 /***
  * Optimize settled layout spacing around readable label bounds instead of full node clearance.
  * Compound containment stays intentional while sibling groups retain non-overlapping boundaries.
- * @performance Cytoscape geometry is measured once, then bounded pure numeric trials reuse the
+ * Cytoscape geometry is measured once, then bounded pure numeric trials reuse the
  * immutable snapshot. No layout reruns, zoom work, or intermediate frames are painted.
  */
 export function compactGraphSpacing(cy, spacingFactor) {

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

@@ -1 +1 @@
-{"version":3,"file":"compactGraphSpacing.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/compactGraphSpacing.ts"],"names":[],"mappings":"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","sourcesContent":["import { findMinimumAcceptedNumber } from '@ankhorage/utility/algorithms';\nimport type { Core, NodeSingular } from 'cytoscape';\n\nconst LABEL_OVERLAP_RATIO = 0.12;\nconst MAX_EXPANSION_ATTEMPTS = 8;\nconst MAX_NODE_COUNT = 2000;\nconst MAX_PAIR_CHECKS = 200000;\nconst SEARCH_ITERATIONS = 8;\n\n/***\n * Optimize settled layout spacing around readable label bounds instead of full node clearance.\n * Compound containment stays intentional while sibling groups retain non-overlapping boundaries.\n * @performance Cytoscape geometry is measured once, then bounded pure numeric trials reuse the\n * immutable snapshot. No layout reruns, zoom work, or intermediate frames are painted.\n */\nexport function compactGraphSpacing(cy: Core, spacingFactor: number): number {\n  const leaves = cy.nodes(':childless');\n  if (leaves.length < 2 || cy.nodes().length > MAX_NODE_COUNT || cy.nodes(':locked').length > 0)\n    return spacingFactor;\n\n  const bounds = leaves.boundingBox();\n  const center = { x: (bounds.x1 + bounds.x2) / 2, y: (bounds.y1 + bounds.y2) / 2 };\n  const leafGeometry = leaves.map(readLeafGeometry);\n  const groups = cy.nodes(':parent').map((node) =>\n    readGroupGeometry(\n      node.id(),\n      node.ancestors().map((parent) => parent.id()),\n      node.boundingBox(),\n      leafGeometry,\n    ),\n  );\n  const accepts = (factor: number) =>\n    !hasUnsafeCollisions(resolveCollisionBoxes(leafGeometry, groups, center, factor));\n  const currentAccepted = accepts(1);\n  const minimum = currentAccepted ? Math.min(1, 0.1 / spacingFactor) : 1;\n  const maximum = currentAccepted ? 1 : findExpansionMaximum(accepts);\n  if (maximum === undefined) return spacingFactor;\n\n  const factor = findMinimumAcceptedNumber({\n    minimum,\n    maximum,\n    iterations: SEARCH_ITERATIONS,\n    accepts,\n  });\n  if (factor === undefined) return spacingFactor;\n\n  applyScale(cy, leafGeometry, center, factor);\n  return spacingFactor * factor;\n}\n\ninterface Point {\n  readonly x: number;\n  readonly y: number;\n}\n\ninterface Bounds {\n  readonly x1: number;\n  readonly y1: number;\n  readonly x2: number;\n  readonly y2: number;\n  readonly w: number;\n  readonly h: number;\n}\n\ninterface Insets {\n  readonly left: number;\n  readonly right: number;\n  readonly top: number;\n  readonly bottom: number;\n}\n\ninterface LeafGeometry {\n  readonly id: string;\n  readonly ancestors: ReadonlySet<string>;\n  readonly position: Point;\n  readonly labelBox: Bounds;\n  readonly nodeBox: Bounds;\n}\n\ninterface GroupGeometry {\n  readonly id: string;\n  readonly ancestors: ReadonlySet<string>;\n  readonly descendants: readonly LeafGeometry[];\n  readonly insets: Insets;\n}\n\ninterface CollisionBox {\n  readonly id: string;\n  readonly ancestors: ReadonlySet<string>;\n  readonly kind: 'label' | 'group';\n  readonly box: Bounds;\n}\n\n/*** Read one leaf's immutable position, hierarchy and renderer-measured label geometry. */\nfunction readLeafGeometry(node: NodeSingular): LeafGeometry {\n  const nodeBox = node.boundingBox({\n    includeLabels: true,\n    includeOverlays: false,\n    includeUnderlays: false,\n  });\n  const labelBox = node.boundingBox({\n    includeNodes: false,\n    includeEdges: false,\n    includeLabels: true,\n    includeOverlays: false,\n    includeUnderlays: false,\n  });\n  return {\n    id: node.id(),\n    ancestors: new Set(node.ancestors().map((parent) => parent.id())),\n    position: { ...node.position() },\n    labelBox: isUsableBox(labelBox) ? labelBox : nodeBox,\n    nodeBox,\n  };\n}\n\n/*** Capture one compound group's descendant geometry and constant renderer-owned outer insets. */\nfunction readGroupGeometry(\n  id: string,\n  ancestorIds: readonly string[],\n  parentBox: Bounds,\n  leaves: readonly LeafGeometry[],\n): GroupGeometry {\n  const descendants = leaves.filter((leaf) => leaf.ancestors.has(id));\n  const descendantUnion = unionBounds(descendants.map((leaf) => leaf.nodeBox)) ?? parentBox;\n  return {\n    id,\n    ancestors: new Set(ancestorIds),\n    descendants,\n    insets: {\n      left: Math.max(0, descendantUnion.x1 - parentBox.x1),\n      right: Math.max(0, parentBox.x2 - descendantUnion.x2),\n      top: Math.max(0, descendantUnion.y1 - parentBox.y1),\n      bottom: Math.max(0, parentBox.y2 - descendantUnion.y2),\n    },\n  };\n}\n\n/*** Resolve immutable label and compound boxes for one candidate uniform spacing factor. */\nfunction resolveCollisionBoxes(\n  leaves: readonly LeafGeometry[],\n  groups: readonly GroupGeometry[],\n  center: Point,\n  factor: number,\n): readonly CollisionBox[] {\n  const labels = leaves.map((leaf) => ({\n    id: leaf.id,\n    ancestors: leaf.ancestors,\n    kind: 'label' as const,\n    box: shiftBounds(leaf.labelBox, leaf.position, center, factor),\n  }));\n  const compoundBoxes = groups.flatMap((group) => {\n    const descendants = group.descendants.map((leaf) =>\n      shiftBounds(leaf.nodeBox, leaf.position, center, factor),\n    );\n    const union = unionBounds(descendants);\n    if (!union) return [];\n    return [\n      {\n        id: group.id,\n        ancestors: group.ancestors,\n        kind: 'group' as const,\n        box: expandBounds(union, group.insets),\n      },\n    ];\n  });\n  return [...labels, ...compoundBoxes];\n}\n\n/*** Find the first bounded expansion factor that makes the pure geometry snapshot acceptable. */\nfunction findExpansionMaximum(accepts: (factor: number) => boolean): number | undefined {\n  return Array.from({ length: MAX_EXPANSION_ATTEMPTS }, (_, index) => 2 ** (index + 1)).find(\n    accepts,\n  );\n}\n\n/***\n * Sweep resolved boxes by x extent and stop conservatively if the pair-check budget is exhausted.\n * Local loop counters are intentionally mutable on this performance-critical boundary.\n */\nfunction hasUnsafeCollisions(boxes: readonly CollisionBox[]): boolean {\n  const sorted = [...boxes].sort((first, second) => first.box.x1 - second.box.x1);\n  const budget = { remaining: MAX_PAIR_CHECKS };\n  for (const [index, first] of sorted.entries()) {\n    for (let next = index + 1; next < sorted.length; next += 1) {\n      const second = sorted.at(next);\n      if (!second) break;\n      if (second.box.x1 >= first.box.x2) break;\n      budget.remaining -= 1;\n      if (budget.remaining < 0) return true;\n      if (isIntentionalContainment(first, second)) continue;\n      if (isUnsafeOverlap(first, second)) return true;\n    }\n  }\n  return false;\n}\n\n/*** Ignore intentional compound containment while retaining sibling and unrelated separation. */\nfunction isIntentionalContainment(first: CollisionBox, second: CollisionBox): boolean {\n  return first.ancestors.has(second.id) || second.ancestors.has(first.id);\n}\n\n/*** Permit only a small bounded label-label overlap; every other intersection remains unsafe. */\nfunction isUnsafeOverlap(first: CollisionBox, second: CollisionBox): boolean {\n  const overlapWidth =\n    Math.min(first.box.x2, second.box.x2) - Math.max(first.box.x1, second.box.x1);\n  const overlapHeight =\n    Math.min(first.box.y2, second.box.y2) - Math.max(first.box.y1, second.box.y1);\n  if (overlapWidth <= 0 || overlapHeight <= 0) return false;\n  if (first.kind !== 'label' || second.kind !== 'label') return true;\n  const widthRatio = overlapWidth / Math.min(first.box.w, second.box.w);\n  const heightRatio = overlapHeight / Math.min(first.box.h, second.box.h);\n  return widthRatio > LABEL_OVERLAP_RATIO && heightRatio > LABEL_OVERLAP_RATIO;\n}\n\n/*** Shift one fixed renderer box with its leaf center under uniform radial scaling. */\nfunction shiftBounds(box: Bounds, position: Point, center: Point, factor: number): Bounds {\n  const dx = (position.x - center.x) * (factor - 1);\n  const dy = (position.y - center.y) * (factor - 1);\n  return {\n    x1: box.x1 + dx,\n    y1: box.y1 + dy,\n    x2: box.x2 + dx,\n    y2: box.y2 + dy,\n    w: box.w,\n    h: box.h,\n  };\n}\n\n/*** Expand a descendant union by the compound renderer's measured outer insets. */\nfunction expandBounds(box: Bounds, insets: Insets): Bounds {\n  const x1 = box.x1 - insets.left;\n  const y1 = box.y1 - insets.top;\n  const x2 = box.x2 + insets.right;\n  const y2 = box.y2 + insets.bottom;\n  return { x1, y1, x2, y2, w: x2 - x1, h: y2 - y1 };\n}\n\n/*** Return the immutable union of measured boxes, or undefined for an empty collection. */\nfunction unionBounds(boxes: readonly Bounds[]): Bounds | undefined {\n  if (boxes.length === 0) return undefined;\n  const x1 = Math.min(...boxes.map((box) => box.x1));\n  const y1 = Math.min(...boxes.map((box) => box.y1));\n  const x2 = Math.max(...boxes.map((box) => box.x2));\n  const y2 = Math.max(...boxes.map((box) => box.y2));\n  return { x1, y1, x2, y2, w: x2 - x1, h: y2 - y1 };\n}\n\n/*** Return whether renderer measurement produced a non-empty label box. */\nfunction isUsableBox(box: Bounds): boolean {\n  return box.w > 0 && box.h > 0;\n}\n\n/*** Apply the accepted factor once, preserving node dimensions, hierarchy, ordering and edge data. */\nfunction applyScale(\n  cy: Core,\n  leaves: readonly LeafGeometry[],\n  center: Point,\n  factor: number,\n): void {\n  const positions = new Map(leaves.map((leaf) => [leaf.id, leaf.position]));\n  cy.batch(() => {\n    cy.nodes()\n      .not(':parent')\n      .positions((node) => {\n        const original = positions.get(node.id()) ?? node.position();\n        return {\n          x: center.x + (original.x - center.x) * factor,\n          y: center.y + (original.y - center.y) * factor,\n        };\n      });\n  });\n}\n"]}
+{"version":3,"file":"compactGraphSpacing.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/compactGraphSpacing.ts"],"names":[],"mappings":"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","sourcesContent":["import { findMinimumAcceptedNumber } from '@ankhorage/utility/algorithms';\nimport type { Core, NodeSingular } from 'cytoscape';\n\nconst LABEL_OVERLAP_RATIO = 0.12;\nconst MAX_EXPANSION_ATTEMPTS = 8;\nconst MAX_NODE_COUNT = 2000;\nconst MAX_PAIR_CHECKS = 200000;\nconst SEARCH_ITERATIONS = 8;\n\n/***\n * Optimize settled layout spacing around readable label bounds instead of full node clearance.\n * Compound containment stays intentional while sibling groups retain non-overlapping boundaries.\n * Cytoscape geometry is measured once, then bounded pure numeric trials reuse the\n * immutable snapshot. No layout reruns, zoom work, or intermediate frames are painted.\n */\nexport function compactGraphSpacing(cy: Core, spacingFactor: number): number {\n  const leaves = cy.nodes(':childless');\n  if (leaves.length < 2 || cy.nodes().length > MAX_NODE_COUNT || cy.nodes(':locked').length > 0)\n    return spacingFactor;\n\n  const bounds = leaves.boundingBox();\n  const center = { x: (bounds.x1 + bounds.x2) / 2, y: (bounds.y1 + bounds.y2) / 2 };\n  const leafGeometry = leaves.map(readLeafGeometry);\n  const groups = cy.nodes(':parent').map((node) =>\n    readGroupGeometry(\n      node.id(),\n      node.ancestors().map((parent) => parent.id()),\n      node.boundingBox(),\n      leafGeometry,\n    ),\n  );\n  const accepts = (factor: number) =>\n    !hasUnsafeCollisions(resolveCollisionBoxes(leafGeometry, groups, center, factor));\n  const currentAccepted = accepts(1);\n  const minimum = currentAccepted ? Math.min(1, 0.1 / spacingFactor) : 1;\n  const maximum = currentAccepted ? 1 : findExpansionMaximum(accepts);\n  if (maximum === undefined) return spacingFactor;\n\n  const factor = findMinimumAcceptedNumber({\n    minimum,\n    maximum,\n    iterations: SEARCH_ITERATIONS,\n    accepts,\n  });\n  if (factor === undefined) return spacingFactor;\n\n  applyScale(cy, leafGeometry, center, factor);\n  return spacingFactor * factor;\n}\n\ninterface Point {\n  readonly x: number;\n  readonly y: number;\n}\n\ninterface Bounds {\n  readonly x1: number;\n  readonly y1: number;\n  readonly x2: number;\n  readonly y2: number;\n  readonly w: number;\n  readonly h: number;\n}\n\ninterface Insets {\n  readonly left: number;\n  readonly right: number;\n  readonly top: number;\n  readonly bottom: number;\n}\n\ninterface LeafGeometry {\n  readonly id: string;\n  readonly ancestors: ReadonlySet<string>;\n  readonly position: Point;\n  readonly labelBox: Bounds;\n  readonly nodeBox: Bounds;\n}\n\ninterface GroupGeometry {\n  readonly id: string;\n  readonly ancestors: ReadonlySet<string>;\n  readonly descendants: readonly LeafGeometry[];\n  readonly insets: Insets;\n}\n\ninterface CollisionBox {\n  readonly id: string;\n  readonly ancestors: ReadonlySet<string>;\n  readonly kind: 'label' | 'group';\n  readonly box: Bounds;\n}\n\n/*** Read one leaf's immutable position, hierarchy and renderer-measured label geometry. */\nfunction readLeafGeometry(node: NodeSingular): LeafGeometry {\n  const nodeBox = node.boundingBox({\n    includeLabels: true,\n    includeOverlays: false,\n    includeUnderlays: false,\n  });\n  const labelBox = node.boundingBox({\n    includeNodes: false,\n    includeEdges: false,\n    includeLabels: true,\n    includeOverlays: false,\n    includeUnderlays: false,\n  });\n  return {\n    id: node.id(),\n    ancestors: new Set(node.ancestors().map((parent) => parent.id())),\n    position: { ...node.position() },\n    labelBox: isUsableBox(labelBox) ? labelBox : nodeBox,\n    nodeBox,\n  };\n}\n\n/*** Capture one compound group's descendant geometry and constant renderer-owned outer insets. */\nfunction readGroupGeometry(\n  id: string,\n  ancestorIds: readonly string[],\n  parentBox: Bounds,\n  leaves: readonly LeafGeometry[],\n): GroupGeometry {\n  const descendants = leaves.filter((leaf) => leaf.ancestors.has(id));\n  const descendantUnion = unionBounds(descendants.map((leaf) => leaf.nodeBox)) ?? parentBox;\n  return {\n    id,\n    ancestors: new Set(ancestorIds),\n    descendants,\n    insets: {\n      left: Math.max(0, descendantUnion.x1 - parentBox.x1),\n      right: Math.max(0, parentBox.x2 - descendantUnion.x2),\n      top: Math.max(0, descendantUnion.y1 - parentBox.y1),\n      bottom: Math.max(0, parentBox.y2 - descendantUnion.y2),\n    },\n  };\n}\n\n/*** Resolve immutable label and compound boxes for one candidate uniform spacing factor. */\nfunction resolveCollisionBoxes(\n  leaves: readonly LeafGeometry[],\n  groups: readonly GroupGeometry[],\n  center: Point,\n  factor: number,\n): readonly CollisionBox[] {\n  const labels = leaves.map((leaf) => ({\n    id: leaf.id,\n    ancestors: leaf.ancestors,\n    kind: 'label' as const,\n    box: shiftBounds(leaf.labelBox, leaf.position, center, factor),\n  }));\n  const compoundBoxes = groups.flatMap((group) => {\n    const descendants = group.descendants.map((leaf) =>\n      shiftBounds(leaf.nodeBox, leaf.position, center, factor),\n    );\n    const union = unionBounds(descendants);\n    if (!union) return [];\n    return [\n      {\n        id: group.id,\n        ancestors: group.ancestors,\n        kind: 'group' as const,\n        box: expandBounds(union, group.insets),\n      },\n    ];\n  });\n  return [...labels, ...compoundBoxes];\n}\n\n/*** Find the first bounded expansion factor that makes the pure geometry snapshot acceptable. */\nfunction findExpansionMaximum(accepts: (factor: number) => boolean): number | undefined {\n  return Array.from({ length: MAX_EXPANSION_ATTEMPTS }, (_, index) => 2 ** (index + 1)).find(\n    accepts,\n  );\n}\n\n/***\n * Sweep resolved boxes by x extent and stop conservatively if the pair-check budget is exhausted.\n * Local loop counters are intentionally mutable on this performance-critical boundary.\n */\nfunction hasUnsafeCollisions(boxes: readonly CollisionBox[]): boolean {\n  const sorted = [...boxes].sort((first, second) => first.box.x1 - second.box.x1);\n  const budget = { remaining: MAX_PAIR_CHECKS };\n  for (const [index, first] of sorted.entries()) {\n    for (let next = index + 1; next < sorted.length; next += 1) {\n      const second = sorted.at(next);\n      if (!second) break;\n      if (second.box.x1 >= first.box.x2) break;\n      budget.remaining -= 1;\n      if (budget.remaining < 0) return true;\n      if (isIntentionalContainment(first, second)) continue;\n      if (isUnsafeOverlap(first, second)) return true;\n    }\n  }\n  return false;\n}\n\n/*** Ignore intentional compound containment while retaining sibling and unrelated separation. */\nfunction isIntentionalContainment(first: CollisionBox, second: CollisionBox): boolean {\n  return first.ancestors.has(second.id) || second.ancestors.has(first.id);\n}\n\n/*** Permit only a small bounded label-label overlap; every other intersection remains unsafe. */\nfunction isUnsafeOverlap(first: CollisionBox, second: CollisionBox): boolean {\n  const overlapWidth =\n    Math.min(first.box.x2, second.box.x2) - Math.max(first.box.x1, second.box.x1);\n  const overlapHeight =\n    Math.min(first.box.y2, second.box.y2) - Math.max(first.box.y1, second.box.y1);\n  if (overlapWidth <= 0 || overlapHeight <= 0) return false;\n  if (first.kind !== 'label' || second.kind !== 'label') return true;\n  const widthRatio = overlapWidth / Math.min(first.box.w, second.box.w);\n  const heightRatio = overlapHeight / Math.min(first.box.h, second.box.h);\n  return widthRatio > LABEL_OVERLAP_RATIO && heightRatio > LABEL_OVERLAP_RATIO;\n}\n\n/*** Shift one fixed renderer box with its leaf center under uniform radial scaling. */\nfunction shiftBounds(box: Bounds, position: Point, center: Point, factor: number): Bounds {\n  const dx = (position.x - center.x) * (factor - 1);\n  const dy = (position.y - center.y) * (factor - 1);\n  return {\n    x1: box.x1 + dx,\n    y1: box.y1 + dy,\n    x2: box.x2 + dx,\n    y2: box.y2 + dy,\n    w: box.w,\n    h: box.h,\n  };\n}\n\n/*** Expand a descendant union by the compound renderer's measured outer insets. */\nfunction expandBounds(box: Bounds, insets: Insets): Bounds {\n  const x1 = box.x1 - insets.left;\n  const y1 = box.y1 - insets.top;\n  const x2 = box.x2 + insets.right;\n  const y2 = box.y2 + insets.bottom;\n  return { x1, y1, x2, y2, w: x2 - x1, h: y2 - y1 };\n}\n\n/*** Return the immutable union of measured boxes, or undefined for an empty collection. */\nfunction unionBounds(boxes: readonly Bounds[]): Bounds | undefined {\n  if (boxes.length === 0) return undefined;\n  const x1 = Math.min(...boxes.map((box) => box.x1));\n  const y1 = Math.min(...boxes.map((box) => box.y1));\n  const x2 = Math.max(...boxes.map((box) => box.x2));\n  const y2 = Math.max(...boxes.map((box) => box.y2));\n  return { x1, y1, x2, y2, w: x2 - x1, h: y2 - y1 };\n}\n\n/*** Return whether renderer measurement produced a non-empty label box. */\nfunction isUsableBox(box: Bounds): boolean {\n  return box.w > 0 && box.h > 0;\n}\n\n/*** Apply the accepted factor once, preserving node dimensions, hierarchy, ordering and edge data. */\nfunction applyScale(\n  cy: Core,\n  leaves: readonly LeafGeometry[],\n  center: Point,\n  factor: number,\n): void {\n  const positions = new Map(leaves.map((leaf) => [leaf.id, leaf.position]));\n  cy.batch(() => {\n    cy.nodes()\n      .not(':parent')\n      .positions((node) => {\n        const original = positions.get(node.id()) ?? node.position();\n        return {\n          x: center.x + (original.x - center.x) * factor,\n          y: center.y + (original.y - center.y) * factor,\n        };\n      });\n  });\n}\n"]}

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

@@ -89,7 +89,7 @@ function positiveSize(value, fallback) {
 }
 /***
  * Recompute the fit reference only after layout or resize, never on every pan/zoom event.
- * @performance Cache the geometry-derived scale in the viewport owner; labels are included, edges excluded.
+ * Cache the geometry-derived scale in the viewport owner; labels are included, edges excluded.
  */
 function getNodeFitZoom(cy, padding) {
     if (cy.nodes().empty())

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 { GraphRuntimeUpdate } from '../../../../../types/graphViewRuntime';\nimport { fitGraphViewport } from './fitGraphViewport';\nimport type { GraphViewController, GraphViewFitOptions } from './GraphView';\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 * @performance 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":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CACnC,EAAQ,EACR,aAAkC,EAClC,WAAoD;IAEpD,MAAM,KAAK,GAAG;QACZ,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,CAAC;QACN,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,QAAQ;QACjB,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,QAAQ;KAClB,CAAC;IACF,MAAM,UAAU,GAAwB;QACtC,GAAG,CAAC,OAAO;YACT,IAAI,OAAO,EAAE,eAAe,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,CAAC;gBACxE,WAAW,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,gBAAgB,CACd,EAAE,EACF;gBACE,OAAO,EAAE,OAAO,EAAE,OAAO;gBACzB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,aAAa,CAAC,OAAO;aACnD,EACD,KAAK,CAAC,OAAO,CACd,CAAC;QACJ,CAAC;QACD,WAAW;YACT,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;QACD,YAAY;YACV,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9E,CAAC;QACD,MAAM,CAAC,GAAG;YACR,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;QACD,OAAO,CAAC,IAAI;YACV,eAAe,CAAC,EAAE,EAAE,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,MAAM;YACX,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;IAEF,OAAO;QACL,UAAU;QACV,SAAS,CAAC,KAAyB;YACjC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,cAAc,CAAC;YACnD,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;YAClC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAC/B,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC;YACjE,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;YAC9D,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YACrC,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,CAAC,GAAY;YACjB,MAAM,WAAW,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;YAC5C,MAAM,KAAK,GAAG,EAAE;iBACb,KAAK,EAAE;iBACP,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;iBAClE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;iBACjE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;YACvD,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM;gBAC/B,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC;gBACzF,CAAC,CAAC,CAAC,CAAC;YACN,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM;gBAC1B,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7E,CAAC,CAAC,QAAQ,CAAC;YACb,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ;gBAC1B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;gBACpE,CAAC,CAAC,CAAC,CAAC;YACN,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC3B,IAAI,GAAG;gBAAE,UAAU,CAAC,GAAG,EAAE,CAAC;iBACrB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACxB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC/C,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,SAAS,eAAe,CACtB,EAAQ,EACR,KAKC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;IACpC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACvE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,wFAAwF;AACxF,SAAS,YAAY,CAAC,KAAyB,EAAE,QAAgB;IAC/D,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,EAAQ,EAAE,OAAe;IAC/C,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;IACvC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;IACzC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,SAAS,eAAe,CAAC,EAAQ,EAAE,IAAY;IAC7C,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;AACxF,CAAC","sourcesContent":["import type { Core } from 'cytoscape';\n\nimport type { GraphRuntimeUpdate } from '../../../../../types/graphViewRuntime';\nimport { fitGraphViewport } from './fitGraphViewport';\nimport type { GraphViewController, GraphViewFitOptions } from './GraphView';\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"]}

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

@@ -1,7 +1,7 @@
 import type { Core } from 'cytoscape';
 /***
  * Keeps self-loop control points outside the rendered node, independent of label size and direction.
- * @performance Reconcile loop geometry only after size/style/layout changes, never on pan or zoom.
+ * Reconcile loop geometry only after size/style/layout changes, never on pan or zoom.
  * Preserve valid dependencies and configured larger loops; do not hide edges or silence warnings.
  */
 export declare function createGraphLoopSizer(cy: Core): {

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

@@ -1,6 +1,6 @@
 /***
  * Keeps self-loop control points outside the rendered node, independent of label size and direction.
- * @performance Reconcile loop geometry only after size/style/layout changes, never on pan or zoom.
+ * Reconcile loop geometry only after size/style/layout changes, never on pan or zoom.
  * Preserve valid dependencies and configured larger loops; do not hide edges or silence warnings.
  */
 export function createGraphLoopSizer(cy) {

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

@@ -1 +1 @@
-{"version":3,"file":"createGraphLoopSizer.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphLoopSizer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Core } from 'cytoscape';\n\n/***\n * Keeps self-loop control points outside the rendered node, independent of label size and direction.\n * @performance Reconcile loop geometry only after size/style/layout changes, never on pan or zoom.\n * Preserve valid dependencies and configured larger loops; do not hide edges or silence warnings.\n */\nexport function createGraphLoopSizer(cy: Core) {\n  const configured = new Map<string, { step: number; distance: number }>();\n\n  /*** Releases only this owner's overrides before a new stylesheet is applied. */\n  function reset() {\n    for (const id of configured.keys()) {\n      cy.getElementById(id).removeStyle('control-point-step-size control-point-distances');\n    }\n    configured.clear();\n  }\n\n  /*** Reconciles loop clearances, including compound bounds after layout completion. */\n  function update() {\n    const loops = cy.edges(':loop');\n    const active = new Set(loops.map((edge) => edge.id()));\n    for (const id of configured.keys()) {\n      if (active.has(id)) continue;\n      cy.getElementById(id).removeStyle('control-point-step-size control-point-distances');\n      configured.delete(id);\n    }\n    cy.batch(() => {\n      loops.forEach((edge) => {\n        const node = edge.source();\n        const original = configured.get(edge.id()) ?? {\n          step: Number.parseFloat(String(edge.style('control-point-step-size'))) || 40,\n          distance: Number.parseFloat(String(edge.style('control-point-distances'))) || 40,\n        };\n        configured.set(edge.id(), original);\n        const clearance = Math.max(\n          16,\n          edge.width() * Number.parseFloat(String(edge.style('arrow-scale'))) * 2,\n        );\n        const minimum = (Math.hypot(node.outerWidth(), node.outerHeight()) / 2 + clearance) / 1.4;\n        const step = Math.max(original.step, minimum);\n        const distance = Math.max(original.distance, minimum);\n        if (Number.parseFloat(String(edge.style('control-point-step-size'))) !== step)\n          edge.style('control-point-step-size', step);\n        if (Number.parseFloat(String(edge.style('control-point-distances'))) !== distance)\n          edge.style('control-point-distances', distance);\n      });\n    });\n  }\n\n  return { reset, update };\n}\n"]}
+{"version":3,"file":"createGraphLoopSizer.js","sourceRoot":"","sources":["../../../../../../src/features/graph-view/adapters/inbound/web-artifact/createGraphLoopSizer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Core } from 'cytoscape';\n\n/***\n * Keeps self-loop control points outside the rendered node, independent of label size and direction.\n * Reconcile loop geometry only after size/style/layout changes, never on pan or zoom.\n * Preserve valid dependencies and configured larger loops; do not hide edges or silence warnings.\n */\nexport function createGraphLoopSizer(cy: Core) {\n  const configured = new Map<string, { step: number; distance: number }>();\n\n  /*** Releases only this owner's overrides before a new stylesheet is applied. */\n  function reset() {\n    for (const id of configured.keys()) {\n      cy.getElementById(id).removeStyle('control-point-step-size control-point-distances');\n    }\n    configured.clear();\n  }\n\n  /*** Reconciles loop clearances, including compound bounds after layout completion. */\n  function update() {\n    const loops = cy.edges(':loop');\n    const active = new Set(loops.map((edge) => edge.id()));\n    for (const id of configured.keys()) {\n      if (active.has(id)) continue;\n      cy.getElementById(id).removeStyle('control-point-step-size control-point-distances');\n      configured.delete(id);\n    }\n    cy.batch(() => {\n      loops.forEach((edge) => {\n        const node = edge.source();\n        const original = configured.get(edge.id()) ?? {\n          step: Number.parseFloat(String(edge.style('control-point-step-size'))) || 40,\n          distance: Number.parseFloat(String(edge.style('control-point-distances'))) || 40,\n        };\n        configured.set(edge.id(), original);\n        const clearance = Math.max(\n          16,\n          edge.width() * Number.parseFloat(String(edge.style('arrow-scale'))) * 2,\n        );\n        const minimum = (Math.hypot(node.outerWidth(), node.outerHeight()) / 2 + clearance) / 1.4;\n        const step = Math.max(original.step, minimum);\n        const distance = Math.max(original.distance, minimum);\n        if (Number.parseFloat(String(edge.style('control-point-step-size'))) !== step)\n          edge.style('control-point-step-size', step);\n        if (Number.parseFloat(String(edge.style('control-point-distances'))) !== distance)\n          edge.style('control-point-distances', distance);\n      });\n    });\n  }\n\n  return { reset, update };\n}\n"]}