Feature/texta selection

docs/TEXT_SELECTION_REGULAR_TEXT.md

@@ -78,6 +78,6 @@ Use this only for custom rendering paths where automatic `text()` extraction is
 
 ## Current scope
 
-- Automatic adapter support is for regular `text()` blocks with `id`.
+- Automatic adapter support covers regular `text()` blocks with `id`.
+- It also covers custom blocks that expose selection geometry through the block registry, including `texta()` once `registerTextaBlockType()` has been called.
 - Cross-block selections are not supported.
-- `texta()` requires custom handling if you need selection behavior equivalent to `text()`.

packages/core/src/core/block-registry.ts

@@ -27,11 +27,23 @@ export interface CustomBlockDebugApi {
   context: RenderContext;
 }
 
+export interface CustomBlockSelectionApi {
+  context?: RenderContext;
+}
+
+export interface CustomBlockSelectionGeometry {
+  blockId: string;
+  layoutSignature: string;
+  rgrclCharacterBounds?: Rc[];
+  resolveCharacterBounds?: () => Rc[];
+}
+
 export interface CustomBlockHandlers {
   render?: (block: CustomBlockDescriptor, api: CustomBlockRenderApi) => void;
   hitTestShape?: (block: CustomBlockDescriptor, xl: number, yl: number, api: CustomBlockHitTestApi) => boolean;
   rcl?: (block: CustomBlockDescriptor) => Rc | null;
   getDebugOutlineBounds?: (block: CustomBlockDescriptor, api: CustomBlockDebugApi) => Rc | null;
+  getSelectionGeometry?: (block: CustomBlockDescriptor, api: CustomBlockSelectionApi) => CustomBlockSelectionGeometry | null;
 }
 
 const mpCustomBlockHandlers = new Map<string, CustomBlockHandlers>();

packages/core/src/index.ts

@@ -56,10 +56,13 @@ export {
 } from './core/block-registry.ts';
 export type {
   BlockLayoutCache,
+  CustomBlockDescriptor,
   CustomBlockHandlers,
   CustomBlockRenderApi,
   CustomBlockHitTestApi,
-  CustomBlockDebugApi
+  CustomBlockDebugApi,
+  CustomBlockSelectionApi,
+  CustomBlockSelectionGeometry
 } from './core/block-registry.ts';
 
 // Block factory functions

packages/demo/component-demo.html

@@ -181,7 +181,7 @@ <h2>Raw Blocks</h2>
 
   <nav class="page-nav">
     <a href="calendar.html">← Calendar</a>
-    <a href="text-selection-debug.html">Text Selection Debug →</a>
+    <a href="text-selection-debug.html">Text Selection Debug (Regular) →</a>
   </nav>
 </body>
 </html>

packages/demo/performance.html

@@ -305,10 +305,11 @@ <h1>Vitrine Performance Test</h1>
         }, blocks)
         ,
 
-        // Text workload to exercise text measurement caches
+        // Keep the text workload invisible so the cache exercise does not clutter the scene.
         group({
           x: 470 + Math.cos(config.time * 0.35) * 120,
           y: 320 + Math.sin(config.time * 0.45) * 70,
+          opacity: 0,
         }, textBlocks)
       ]);