From 4cf798f0a19cd5d871390aebe19f6ddb2bf11606 Mon Sep 17 00:00:00 2001 From: axiomlogicnexus Date: Wed, 27 May 2026 17:29:03 +0200 Subject: [PATCH] Backfill react-three-fiber reference provenance --- .../HT_REPO_INCORPORATION_AUDIT_2026-05-11.md | 7 +- ...CORPORATION_PROVENANCE_BOARD_2026-05-27.md | 119 ++++++++++++++++++ .../HyperTwist/FEATURE_REGISTRY.md | 1 + 3 files changed, 124 insertions(+), 3 deletions(-) create mode 100644 docs/HYPERTWIST_REACT_THREE_FIBER_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md diff --git a/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md b/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md index 2726982..f0301ce 100644 --- a/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md +++ b/docs/HT_REPO_INCORPORATION_AUDIT_2026-05-11.md @@ -397,14 +397,15 @@ is now explicit too, and the `apache/echarts` analytics and report reference side is now explicit too, and the `Hypercubers/hypercubing.xyz` knowledge, taxonomy, and leaderboard/report reference side is now explicit too, and the `mrdoob/three.js` browser scene and renderer reference side is now explicit -too. +too, and the `pmndrs/react-three-fiber` React renderer and event-bridge +reference side is now explicit too. The next clean bounded move is a source-backed pass on the remaining repo-backed reference-incorporation families whose hierarchy or canon follow-through is still only implicit in `hypertwist-reference-incorporation-targets.json`, starting with -`pmndrs/react-three-fiber` if you want the adjacent React renderer and -event-bridge reference side closed to the same standard. +`pmndrs/xr` if you want the adjacent XR session and immersive-interaction +reference side closed to the same standard. For the readable all-rows follow-up board that pairs this audit with the reset schedule, use: diff --git a/docs/HYPERTWIST_REACT_THREE_FIBER_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md b/docs/HYPERTWIST_REACT_THREE_FIBER_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md new file mode 100644 index 0000000..dd4da1b --- /dev/null +++ b/docs/HYPERTWIST_REACT_THREE_FIBER_REFERENCE_INCORPORATION_PROVENANCE_BOARD_2026-05-27.md @@ -0,0 +1,119 @@ +# HyperTwist react-three-fiber Reference Incorporation Provenance Board - 2026-05-27 + +## Status + +This document is the source-backed provenance and hierarchy note for the live +repo-backed reference-incorporation side currently materialized from +`pmndrs/react-three-fiber`. + +It closes the source-specific reference side that remained implicit after the +landed `Phase 3R-F` packet and the broader live-lane audit. + +It answers one narrow question: + +- does the live `pmndrs/react-three-fiber` reference target reopen already + landed first-party React-side browser renderer, event bridge, pointer, and + camera-store integration implementation, or does it instead need a + reference-side provenance-board and canon backfill + +Result: + +- no product-code reopening is required +- yes reference-side provenance-board and feature-canon backfill is required + +## Source basis + +- `C:\HyperTwist\docs\HT_REPO_INCORPORATION_AUDIT_2026-05-11.md` +- `C:\HyperTwist\docs\HYPERTWIST_PHASE_3R_PACKET_3R_F_BROWSER_SPATIAL_SUPPORT_IMPLEMENTATION_2026-05-13.md` +- `C:\HyperTwist\docs\HYPERTWIST_LIVE_LANES_SOURCE_AND_PRESERVATION_AUDIT_2026-05-13.md` +- `C:\HyperTwist\docs\REPO_LICENSE_TRACKING.md` +- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md` +- `C:\HyperTwist\UnrealHyperTwist\Content\HyperTwistTraining\MaterializedCatalog\hypertwist-reference-incorporation-targets.json` +- `C:\HyperTwist\UnrealHyperTwist\Content\HyperTwistTraining\MaterializedCatalog\raw-extracts\browser-spatial-support-reference-pages.jsonl` + +## Counts confirmed from current first-party materialization + +Current live `pmndrs/react-three-fiber` reference-incorporation targets: + +- `1` total rewritten reference target +- that target is under `Browser 3D and XR Support` +- it stays inside the already-landed `Phase 3R-F` bounded lane + +Exact surface: + +1. `reference/browser-spatial-react-reference-page-renderer` + - `SurfaceType`: `browser-spatial-react-reference` + - `IncorporationChannel`: `browser-spatial-react-contract` + - `TargetAssetFamily`: `renderer-note` + +Important adjacent fact: + +- this target preserves canvas-root configuration, event-manager bridge, + pointer and raycaster routing, and camera/store lifecycle semantics already + enforced by the landed lane +- it stays subordinate to the broader landed browser spatial owner trio and + does not absorb the adjacent `three.js` scene substrate or `xr` + session-store reference slices + +## Slice-local verdict + +| Slice | Primary authority | Secondary value kept | Result | +|---|---|---|---| +| First-party React-side browser renderer, event bridge, pointer, and camera-store integration implementation | first-party current code plus landed `Phase 3R-F` packet | retained `pmndrs/react-three-fiber` reference target stays a subordinate provenance-grounding surface | unchanged live implementation owner | +| Rewritten React renderer and event-bridge grounding | `pmndrs/react-three-fiber` retained permissive lane | factual canvas-root, event-manager, pointer-routing, and camera/store lifecycle semantics are preserved while prose remains first-party | unchanged retained reference-grounding surface beneath first-party contracts | + +## Why no product-code reopening is required + +The live surface here is already a rewritten first-party target, not copied +donor docs, donor demo shell, donor package-marketing copy, or a silent +upstream private fork. + +The checked target explicitly requires: + +- preserving bounded React renderer, event-manager, pointer, and camera/store + lifecycle semantics +- rewriting donor docs or demo wording, donor example framing, and donor + package-marketing copy + +That means the retained surface is provenance and factual grounding, not donor +browser-shell ownership. + +So this pass does not reopen: + +- the closed `Phase 3R-F` first-party browser spatial lane +- the adjacent `mrdoob/three.js` scene substrate slice +- the adjacent `pmndrs/xr` XR-session slice +- any broader React app-shell or editor ownership posture + +## Current exact grounded role + +`pmndrs/react-three-fiber` currently grounds one live rewritten first-party +contract/reference target for `Browser 3D and XR Support`: + +- React scene renderer and event bridge + +This target preserves bounded React-side browser spatial semantics while +keeping all surfaced prose and shell framing first-party. + +## Backfill result + +### Earlier incorporation audit reopened + +- `C:\HyperTwist\docs\HT_REPO_INCORPORATION_AUDIT_2026-05-11.md` + +### Feature canon reopened + +- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md` + +## Final call + +The live `pmndrs/react-three-fiber` reference-incorporation side is now +explicit: + +- `1` rewritten first-party contract/reference target +- it remains inside the landed `Phase 3R-F` browser spatial lane +- canvas-root, event-manager, pointer-routing, and camera/store grounding stay + explicit + +This closes the `pmndrs/react-three-fiber` reference side without reopening +product code. diff --git a/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md b/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md index 10da6ea..d66fb8a 100644 --- a/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md +++ b/docs/v6_5_deep_manual_pack/HyperTwist/FEATURE_REGISTRY.md @@ -140,6 +140,7 @@ Do not collapse those three tiers into one undifferentiated "features" voice. | Rewritten training analytics and report reference grounding | Implemented now | `apache/echarts` retained permissive lane + first-party current code | Current live `Training Analytics` reference side includes four rewritten first-party targets grounded in retained `apache/echarts`: session outcome and progress reporting, analytics data-view and export, timing-trend history and overview interaction, and the optional richer explainer or sidecar boundary. This does not displace the landed `Phase 3R-C` first-party analytics/reporting owner or elevate `ecomfe/echarts-gl` and `ecomfe/zrender` beyond support-only sidecars. | | Browser/spatial/media adjunct surfaces | Implemented now | landed `three.js`, `react-three-fiber`, `xr`, `model-viewer`, `remotion` packets | These are implemented bounded families, not proof of unlimited browser-shell parity. | | Rewritten browser spatial scene and renderer reference grounding | Implemented now | `mrdoob/three.js` retained permissive lane + first-party current code | Current live `Browser 3D and XR Support` reference side includes one rewritten first-party target grounded in retained `mrdoob/three.js`: the browser spatial scene and renderer contract. This does not displace the landed `Phase 3R-F` first-party browser spatial owner trio or absorb the adjacent `react-three-fiber` renderer-bridge and `xr` session slices. | +| Rewritten React-side browser renderer and event-bridge grounding | Implemented now | `pmndrs/react-three-fiber` retained permissive lane + first-party current code | Current live `Browser 3D and XR Support` reference side includes one rewritten first-party target grounded in retained `react-three-fiber`: the React scene renderer and event bridge. This does not displace the landed `Phase 3R-F` first-party browser spatial owner trio or absorb the adjacent `three.js` scene substrate and `xr` session slices. | ## Feature families