Add renderer sampler state contract

docs/modernization/build-inventory.md

@@ -286,13 +286,14 @@ Known local toolchain state:
   legacy OpenGL implementation files.
 - `pp_renderer_api` exposes a headless `RecordingRenderDevice` that validates
   command order, scissor state, depth state, blend state, texture-slot binding,
-  texture-upload byte counts, readback bounds, frame-capture sources,
-  destination buffer sizes, and render-target blit regions, records
-  render/scissor/depth/blend/texture-bind/upload/readback/frame-capture/blit
-  commands, and records trace markers without a window or GL context.
+  sampler-state binding, texture-upload byte counts, readback bounds,
+  frame-capture sources, destination buffer sizes, and render-target blit
+  regions, records render/scissor/depth/blend/texture-bind/sampler-bind/upload/
+  readback/frame-capture/blit commands, and records trace markers without a
+  window or GL context.
 - `pano_cli record-render` exposes the recording renderer through JSON
-  automation, including scissor/depth/blend/texture-bind/upload/readback/
-  frame-capture/blit command and byte totals, and is covered by
+  automation, including scissor/depth/blend/texture-bind/sampler-bind/upload/
+  readback/frame-capture/blit command and byte totals, and is covered by
   `pano_cli_record_render_smoke` plus
   `pano_cli_record_render_rejects_oversized_target`.
 - `pano_cli simulate-document-history` exposes `pp_document::DocumentHistory`

docs/modernization/roadmap.md

@@ -420,8 +420,8 @@ readback byte-size helpers, texture-upload/readback command validation,
 frame-capture byte-size helpers, frame-capture command validation,
 render-target blit validation, texture-slot binding validation, blend-state
 validation, scissor-state validation, depth-state validation, trace interface
-validation, and the canonical PanoPainter shader catalog now consumed by the
-legacy OpenGL app initialization path.
+validation, sampler-state validation, and the canonical PanoPainter shader
+catalog now consumed by the legacy OpenGL app initialization path.
 `pp_renderer_gl` now exists as the first OpenGL backend library and owns pure
 OpenGL capability detection for framebuffer fetch, map-buffer alignment, and
 float texture support. It also owns the OpenGL texture upload-type mapping used
@@ -724,8 +724,8 @@ Results:
   validation, texture-upload byte-count validation, frame-capture byte-size and
   command-order validation, render-target blit validation, texture-slot binding
   validation, blend-state validation, scissor-state validation, recording
-  scissor/depth/blend/texture-bind/upload/readback/frame-capture/blit command
-  capture, and invalid catalog rejection.
+  scissor/depth/blend/texture/sampler-bind/upload/readback/frame-capture/blit
+  command capture, and invalid catalog rejection.
 - `pp_paint_renderer_compositor_tests` passed.
 - `pp_ui_core_color_tests` passed.
 - `pp_ui_core_layout_value_tests` passed.
@@ -820,15 +820,16 @@ Results:
   implementation files.
 - `pp_renderer_api` now includes a headless `RecordingRenderDevice` with strict
   command-order/scissor-state/depth-state/blend-state/texture-bind/
-  texture-upload/readback/frame-capture/blit validation; it records commands,
-  trace markers, scissor state, depth state, blend state, texture binds,
-  uploads/readbacks, frame captures, and render-target blits, giving automation
-  a backend-neutral render path that does not require a window or GL context.
+  sampler-bind/texture-upload/readback/frame-capture/blit validation; it
+  records commands, trace markers, scissor state, depth state, blend state,
+  texture/sampler binds, uploads/readbacks, frame captures, and render-target
+  blits, giving automation a backend-neutral render path that does not require
+  a window or GL context.
 - `pano_cli record-render` exercises that headless recording renderer and emits
   JSON command counts, target dimensions, backend name, trace/draw summary, and
-  scissor/depth/blend-state plus texture-bind/upload/readback/frame-capture/
-  blit command/byte totals for agent automation, with an expected-failure smoke
-  for oversized render/readback targets.
+  scissor/depth/blend-state plus texture/sampler-bind/upload/readback/
+  frame-capture/blit command/byte totals for agent automation, with an
+  expected-failure smoke for oversized render/readback targets.
 - `pano_cli simulate-document-history` exercises pure document history
   apply/undo/redo behavior and emits JSON layer/frame/history state for agent
   automation.