@octanejs/visx 0.1.29 → 0.1.31

package/UPSTREAM.md

@@ -1,11 +1,21 @@
 # Upstream Visx audit
 
-This port was audited against two immutable Airbnb Visx revisions:
+## Pin and oracle environment
 
-- release `v4.0.0` at `78839796081beb0370fc928cc922b21908bbabaf`, used as the
-  installed React runtime/type oracle;
-- current 4.x `master` at `485c0359664ee8e612992defb16e1f035ed40b23`, used to
-  pin the public additions awaiting the next registry release.
+| Field | Value |
+|---|---|
+| Package | `@visx/visx` |
+| Version | `4.0.0` |
+| Canonical release commit | `78839796081beb0370fc928cc922b21908bbabaf` |
+| Current-master audit commit | `485c0359664ee8e612992defb16e1f035ed40b23` |
+| React oracle | `react@19.2.7` and `react-dom@19.2.7` |
+| React types oracle | `@types/react@19.2.17` and `@types/react-dom@19.2.3` |
+| Claimed compatibility range | workspace `catalog:default` (`react`/`react-dom` `^19.2.7`, `@types/react` `^19.2.17`) |
+| License | MIT |
+
+Exact lockfile-resolved oracle versions are also recorded as immutable audit
+metadata in [`audit/oracle-environment.json`](./audit/oracle-environment.json)
+and hashed into the parity manifest lanes that inherit them.
 
 ## Public package inventory
 
@@ -50,3 +60,16 @@ Those are the only exclusions. They expose no supported web React library API.
 Behavioral divergences required for deterministic SSR, native Octane events,
 refs-as-props, and animation/measurement adapters are recorded in
 [`status.json`](./status.json) and the package [`README.md`](./README.md).
+
+## Test-suite disposition
+
+The Visx monorepo contains package-local runtime and type suites across the
+feature packages. Those tagged suites have not been vendored and adapted
+one-for-one, so the parity manifest remains `recorded-unverified` with upstream
+runtime and type suites recorded as present.
+
+The bounded harness keeps a single repo-authored differential lane: three exact
+representative public scenarios against `@visx/visx@4.0.0`. Package-authored
+conformance, SSR, and hydration tests stay in ordinary shards and are classified
+as Octane-only framework contracts; they are not claimed as adapted React
+evidence.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/visx",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -123,10 +123,10 @@
     "mitt": "^2.1.0",
     "reduce-css-calc": "^1.3.0",
     "svg-path-properties": "2.0.2",
-    "@octanejs/floating-ui": "0.1.34"
+    "@octanejs/floating-ui": "0.1.36"
   },
   "peerDependencies": {
-    "octane": "0.1.35"
+    "octane": "0.1.37"
   },
   "devDependencies": {
     "@juggle/resize-observer": "^3.4.0",
@@ -149,7 +149,7 @@
     "react-dom": "^19.2.7",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "octane": "0.1.35"
+    "octane": "0.1.37"
   },
   "scripts": {
     "compile:check": "node scripts/check-tsrx-compile.mjs",

package/src/brush/Brush.tsrx

@@ -1,3 +1,5 @@
+// OCTANE DIVERGENCE[visx-functional-controllers-no-class-refs][differential:visx-functional-controllers]:
+// Brush is a functional TSRX controller and intentionally omits upstream's legacy class-instance innerRef handle.
 import type { SVGProps } from 'react';
 import type { OctaneNode } from 'octane';
 import BaseBrush from './BaseBrush.tsrx';

package/src/internal/spring.tsrx

@@ -1,3 +1,5 @@
+// OCTANE DIVERGENCE[visx-react-spring-raf-interpolation][adapted:visx-react-spring-raf]:
+// Numeric RAF interpolation over a fixed 250ms timeline replaces react-spring spring-physics timing.
 import { createElement, useEffect, useRef, useState } from 'octane';
 
 type AnyRecord = Record<string, any>;

package/src/shape/shapes/Pie.tsrx

@@ -5,6 +5,9 @@ import type { AddSVGProps, ArcPathConfig, PiePathConfig } from '../types';
 import usePie from '../react/usePie.tsrx';
 import type { PieArcDatum, UsePieResult } from '../react/usePie.tsrx';
 
+// OCTANE DIVERGENCE[visx-reactnode-to-octane-renderables][types:adapted-reactnode]:
+// children/render-prop returns are OctaneNode rather than React.ReactNode.
+
 export type { PieArcDatum };
 
 type StringAccessor<Datum> = (pieArcDatum: PieArcDatum<Datum>) => string;

package/src/wordcloud/useWordcloud.tsrx

@@ -1,3 +1,5 @@
+// OCTANE DIVERGENCE[visx-deterministic-measurement][adapted:visx-deterministic-measurement]:
+// Deterministic estimated word bounds replace browser/font/d3-cloud packing measurement.
 import { useMemo } from 'octane';
 import getStringWidth from '../text/util/getStringWidth';
 import type { BaseDatum, CloudWord, WordcloudConfig } from './types';

package/src/zoom/Zoom.tsrx

@@ -1,3 +1,5 @@
+// OCTANE DIVERGENCE[visx-native-zoom-gestures][differential:visx-native-gestures]:
+// Zoom attaches native wheel/pointer/touch listeners rather than @use-gesture/react at runtime.
 import { useState, useRef, useCallback, useEffect } from 'octane';
 import type { ReactElement } from 'react';
 import { localPoint } from '@octanejs/visx/event';