Share target-aware framebuffer copy bridge

docs/modernization/build-inventory.md

@@ -447,9 +447,10 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.p
   RGBA8 region-update helper that uses the tested texture-update dispatch for
   canvas undo, layer restore, and flood-fill texture writes. 2D
   framebuffer-to-texture copies used by retained canvas, transform,
-  layer-conversion, panorama UI, and brush-preview paths now execute through a
-  tested `pp_renderer_gl` dispatch via `copy_framebuffer_to_texture_2d`; the
-  retained cube-map framebuffer copy remains tracked by `DEBT-0036`. It also
+  layer-conversion, panorama UI, brush-preview, and CanvasLayer cube-face paths
+  now execute through a tested `pp_renderer_gl` dispatch via the target-aware
+  retained framebuffer-copy utility bridge. That bridge remains retained until
+  renderer services own copy execution under `DEBT-0036`. It also
   validates renderer API primitive-topology to OpenGL draw-mode mapping, Shape
   index-type, fill/stroke primitive-mode, buffer target, static upload usage,
   and vertex attribute component/normalization mapping used by
@@ -522,8 +523,9 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.p
   clear, clear-color query/restore, and RGBA8 read/write pixel mapping. Their
   active-texture, cube-texture binding, viewport, blend capability,
   clear-color, and color-buffer clear adapter endpoints now share
-  `legacy_ui_gl_dispatch`; the retained cube-face framebuffer-to-texture copy
-  remains tracked by DEBT-0036.
+  `legacy_ui_gl_dispatch`; the cube-face framebuffer-to-texture copy now uses
+  the shared retained target-aware utility bridge and remains tracked by
+  DEBT-0036.
   `NodePanelGrid` heightmap preview and lightmap baking also consume
   backend-owned texture readback formats, sampler filters, depth/blend state,
   depth clears, viewport queries, color-mask booleans, active texture units,
@@ -565,8 +567,8 @@ powershell -ExecutionPolicy Bypass -File scripts\automation\apple-remote-build.p
   `CanvasLayer` cube/equirect generation and frame clears also share the bridge
   for active texture, cube texture binding, viewport execution, blend
   capability execution, clear-color query/restore, and color-buffer clear
-  adapter endpoints, while its cube-face framebuffer-to-texture copy remains a
-  retained local copy bridge.
+  adapter endpoints, while its cube-face framebuffer-to-texture copy uses the
+  shared retained target-aware utility bridge.
   `NodePanelGrid` heightmap draw and bake setup also shares it for active
   texture, depth/blend capability query/apply, viewport query/execution, depth
   clears, and color-write-mask adapter endpoints.

docs/modernization/roadmap.md

@@ -1153,10 +1153,11 @@ also live in `pp_renderer_gl`. Depth renderbuffer allocation/storage/delete and
 framebuffer depth attach/detach sequences used by retained `RTT` and canvas
 object-drawing helpers now execute through tested `pp_renderer_gl` dispatch
 contracts. 2D framebuffer-to-texture
-copies used by canvas, transform, layer-conversion, panorama UI, and brush
-preview paths now route through a tested `pp_renderer_gl` copy dispatch via the
-retained `copy_framebuffer_to_texture_2d` utility bridge; the remaining cube-map
-copy is tracked under `DEBT-0036`. RTT render-target clear, masked color clear
+copies used by canvas, transform, layer-conversion, panorama UI, brush preview,
+and CanvasLayer cube-face generation paths now route through a tested
+`pp_renderer_gl` copy dispatch via the retained target-aware framebuffer-copy
+utility bridge. The copy bridge remains retained until renderer services own
+cube and 2D framebuffer copy commands under `DEBT-0036`. RTT render-target clear, masked color clear
 with color-write-mask restore, and texture bind/unbind dispatch now execute
 through `pp_renderer_gl`; renderer API render-pass color/depth/stencil
 clear-mask and clear-value mapping, and color-write-mask query tokens also live
@@ -1232,8 +1233,9 @@ viewport execution, cube texture binding, color-buffer clears, clear-color
 query/restore, and RGBA8 read/write pixel mapping to `pp_renderer_gl`. Its
 active-texture, cube-texture binding, viewport, blend capability, clear-color,
 and color-buffer clear adapter endpoints now share `legacy_ui_gl_dispatch`;
-the retained cube-face framebuffer-to-texture copy remains tracked under
-DEBT-0036 until a renderer-owned cube copy command replaces it.
+the cube-face framebuffer-to-texture copy now uses the shared retained
+target-aware utility bridge and remains tracked under DEBT-0036 until a
+renderer-owned cube copy command replaces it.
 `NodePanelGrid` heightmap preview and lightmap baking now delegate texture
 readback formats, sampler filters, depth/blend state, depth clears, viewport
 queries, color-mask booleans, active texture units, and float render-target
@@ -2501,8 +2503,9 @@ Results:
   `legacy_ui_gl_dispatch` for active-texture selection, cube texture binding,
   viewport execution, blend capability execution, clear-color query/restore,
   and color-buffer clear adapter endpoints backed by tested renderer GL
-  backend dispatch contracts. The cube-face framebuffer-to-texture copy remains
-  the retained local copy bridge tracked by DEBT-0036.
+  backend dispatch contracts. The cube-face framebuffer-to-texture copy now
+  uses the shared retained target-aware utility bridge and remains tracked by
+  DEBT-0036 until renderer services own copy execution.
 - `NodePanelGrid` live heightmap drawing and bake setup now route depth/blend
   state, depth clears, color-write-mask toggles, active texture selection, and
   bake viewport execution through tested renderer GL backend dispatch