evidence-binder/registry/capabilities/capability.evidence.rect-registry.md

id	name	summary	owner	status	domain	tags	maturity	external_evidence	discovery	availability	relations	evidence	consumer_guidance	promotion_history
capability.evidence.rect-registry	Visual-Guide Rect Registry	Coordinates field, evidence-card, and highlight rectangles from independent renderers so an SVG overlay can draw the active visual guide without polling.	evidence-binder	draft	infotech	rect-registry visual-guide overlay active-state citation-evidence	discovery availability current target confidence rationale D3 D5 high SharedContracts section 7, SCOPE.md, the extraction inventory, and the reference-UI ADR define the cross-renderer contract, ownership boundary, invalidation model, and coupling risk. Systematic use-case and alternative research beyond the citation workspace has not been recorded. current target confidence rationale A2 A2 high The TypeScript package exports the rect registry, event pump, React hooks, and SVG overlay as source modules consumed by the citation-evidence umbrella. The capability is naturally a library rather than a CLI or service.	completeness reliability level confidence basis satisfied_expectations broken_expectations out_of_scope_expectations C3 medium scope_vs_intent_and_consumer_expectations register and resolve field, evidence-card, and highlight rectangles notify consumers on registration, removal, and explicit invalidation throttle viewport change pumps with requestAnimationFrame draw the active field-to-card-to-highlight guide through the SVG overlay broader renderer and layout variants have not been exercised outside the umbrella workspace document highlight resolution evidence-card and viewer rendering ownership polling-based geometry ownership inside the overlay level confidence basis evidence known_reliability_risks R3 medium consumer_quality_signals tests integration suites src/visual-guide/rect-registry.test.ts src/visual-guide/react-hooks.dom.test.tsx src/visual-guide/Overlay.dom.test.tsx consumer mode citation-evidence form, evidence-card, and highlight bridges reliability evidence comes from one browser application and its automated DOM tests unusual transforms and multi-window layouts are not represented in current evidence	intent includes excludes assumptions use_cases research_memos Decouple independently rendered fields, evidence cards, and document highlights by giving them one invalidation-aware geometry registry for the active visual guide. rectangle registration and lookup for the three canonical rect kinds change subscriptions and explicit invalidation viewport event pumps and React registration hooks SVG overlay rendering for the active triple source selector resolution and scrolling ownership of evidence-card or viewer components application-level active-state persistence each renderer can supply a current DOMRect through a callback the host mounts one registry shared by participating renderers the host drives active target, evidence, and annotation state connect an active form field to its evidence card and source highlight redraw guide geometry after scroll, resize, focus, or explicit invalidation let renderer bridges publish geometry without importing each other	current_level target_level current_artifacts target_artifacts consumption_modes A2 A2 src/visual-guide/rect-registry.ts src/visual-guide/events.ts src/visual-guide/react-hooks.ts src/visual-guide/Overlay.tsx source module React hook React component	depends_on supports related_to capability.evidence.binding	documentation tests consumer_feedback bug_reports incidents README.md SCOPE.md docs/extraction-inventory.md docs/adr/ADR-0001-reference-ui-surface.md ../citation-evidence/wiki/SharedContracts.md src/visual-guide/rect-registry.test.ts src/visual-guide/react-hooks.dom.test.tsx src/visual-guide/Overlay.dom.test.tsx citation-evidence composes field, evidence-card, and highlight bridges through this registry	recommended_for not_recommended_for known_limitations React applications drawing active relationships across independently rendered panes citation-evidence consumers using the canonical field, evidence-card, and highlight rect kinds non-DOM renderers without a DOMRect-compatible adapter applications expecting the registry to resolve selectors or own scrolling evidence is limited to one internal browser application transformed and multi-window layout behavior is not explicitly tested

Visual-Guide Rect Registry

Overview

This capability provides the shared geometry contract for the visual guide. Independent field, evidence-card, and highlight renderers publish callbacks into one registry; hooks and event pumps invalidate it, and the overlay draws the active relationship without owning those renderers or polling their geometry.

Assessment notes

Discovery

The contract and the coupling problem it solves are explicit and implemented, supporting D3. Promotion to D5 requires a broader, prioritized use-case and layout-variant catalogue.

Availability

The registry, hooks, and overlay are directly consumable TypeScript and React source modules. A2 is the natural target for this embedded UI capability.

Completeness

The canonical three-leg visual-guide path works and has focused coverage. The assessment remains C3 because only the umbrella layout and browser context have supplied consumer evidence.

Reliability

Registry, event-pump, hook, and overlay tests plus the umbrella integration support R3 for normal internal use. Confidence remains medium until independent consumers or broader layout evidence exist.

Promotion checklist

• ID follows the capability identifier pattern
• Maturity enums match the capability maturity standard
• External evidence is separate from internal maturity
• Relations reference an indexed capability ID
• Index entry points to this file