@agent-scope/render 1.20.4 → 1.20.6

package/dist/index.d.cts

@@ -575,15 +575,21 @@ interface MatrixAxis<T = unknown> {
  */
 interface MatrixRenderer {
     /**
-     * Render a single cell given the merged props for that cell.
+     * Render a single cell given the merged props for this matrix cell.
      *
      * @param props - The combined prop snapshot for this matrix cell.
      *               Keys are axis names; values are the axis value for this cell.
      * @param complexityClass - Routing hint (passed through from the descriptor).
+     * @param renderMode - Requested render backend. `browser` forces the real DOM
+     *                     Playwright path even when the descriptor is classified
+     *                     as simple; this prevents Satori-style placeholder output
+     *                     for rich components such as datepickers.
      * @returns Resolved RenderResult.
      */
-    renderCell(props: Record<string, unknown>, complexityClass: ComplexityClass): Promise<RenderResult>;
+    renderCell(props: Record<string, unknown>, complexityClass: ComplexityClass, renderMode?: RenderMode): Promise<RenderResult>;
 }
+/** Render backend requested by CLI/config callers. */
+type RenderMode = "auto" | "browser";
 /**
  * A single cell in the rendered matrix grid.
  */
@@ -663,12 +669,15 @@ declare class RenderMatrix {
     private readonly renderer;
     private readonly axes;
     private readonly complexityClass;
+    private readonly renderMode;
     /** Maximum number of cells to render in parallel. @default 8 */
     private readonly concurrency;
     constructor(renderer: MatrixRenderer, axes: MatrixAxis[], options?: {
         complexityClass?: ComplexityClass;
         /** Max parallel renders. Default 8. */
         concurrency?: number;
+        /** Force a render backend for every matrix cell. Default: auto. */
+        renderMode?: RenderMode;
     });
     /** Total number of cells (product of all axis cardinalities). */
     get cellCount(): number;
@@ -945,4 +954,4 @@ declare function stressAxis(id: StressCategoryId): {
  */
 declare function extractInlineStyles(element: React.ReactNode, path?: string): Record<string, Record<string, string>>;
 
-export { ALL_CONTEXTS, ALL_CONTEXT_IDS, ALL_STRESS_IDS, ALL_STRESS_PRESETS, type BoundingBox, BrowserPool, type BrowserPoolConfig, COMPOSITION_CONTEXTS, type CaptureOptions, type CellBounds, type CellCoordinateMap, type CompositionContext, type CompositionContextId, type ContainerOptions, type ContainerType, type CrashedRenderResult, type DOMNode, type EnvironmentOptions, type FontEntry, type HeuristicFlag, type MatrixAxis, type MatrixCell, type MatrixRenderer, type MatrixResult, type MatrixStats, type PageSlot, type PoolPreset, type PoolSizeConfig, RenderError, type RenderErrorFields, RenderMatrix, type RenderOptions, type RenderOutcome, type RenderResult, type RendererConfig, type SatoriRenderOptions, SatoriRenderer, type SourceLocation, SpriteSheetGenerator, type SpriteSheetOptions, type SpriteSheetResult, type StressCategoryId, type StressPreset, type SuccessRenderResult, type ViewportOptions, cartesianProduct, clearFontCache, contextAxis, detectHeuristicFlags, extractInlineStyles, fontCacheSize, getContext, getContexts, getStressPreset, getStressPresets, labelForValue, loadFont, safeRender, stressAxis, wrapWithProviders };
+export { ALL_CONTEXTS, ALL_CONTEXT_IDS, ALL_STRESS_IDS, ALL_STRESS_PRESETS, type BoundingBox, BrowserPool, type BrowserPoolConfig, COMPOSITION_CONTEXTS, type CaptureOptions, type CellBounds, type CellCoordinateMap, type CompositionContext, type CompositionContextId, type ContainerOptions, type ContainerType, type CrashedRenderResult, type DOMNode, type EnvironmentOptions, type FontEntry, type HeuristicFlag, type MatrixAxis, type MatrixCell, type MatrixRenderer, type MatrixResult, type MatrixStats, type PageSlot, type PoolPreset, type PoolSizeConfig, RenderError, type RenderErrorFields, RenderMatrix, type RenderMode, type RenderOptions, type RenderOutcome, type RenderResult, type RendererConfig, type SatoriRenderOptions, SatoriRenderer, type SourceLocation, SpriteSheetGenerator, type SpriteSheetOptions, type SpriteSheetResult, type StressCategoryId, type StressPreset, type SuccessRenderResult, type ViewportOptions, cartesianProduct, clearFontCache, contextAxis, detectHeuristicFlags, extractInlineStyles, fontCacheSize, getContext, getContexts, getStressPreset, getStressPresets, labelForValue, loadFont, safeRender, stressAxis, wrapWithProviders };

package/dist/index.d.ts

@@ -575,15 +575,21 @@ interface MatrixAxis<T = unknown> {
  */
 interface MatrixRenderer {
     /**
-     * Render a single cell given the merged props for that cell.
+     * Render a single cell given the merged props for this matrix cell.
      *
      * @param props - The combined prop snapshot for this matrix cell.
      *               Keys are axis names; values are the axis value for this cell.
      * @param complexityClass - Routing hint (passed through from the descriptor).
+     * @param renderMode - Requested render backend. `browser` forces the real DOM
+     *                     Playwright path even when the descriptor is classified
+     *                     as simple; this prevents Satori-style placeholder output
+     *                     for rich components such as datepickers.
      * @returns Resolved RenderResult.
      */
-    renderCell(props: Record<string, unknown>, complexityClass: ComplexityClass): Promise<RenderResult>;
+    renderCell(props: Record<string, unknown>, complexityClass: ComplexityClass, renderMode?: RenderMode): Promise<RenderResult>;
 }
+/** Render backend requested by CLI/config callers. */
+type RenderMode = "auto" | "browser";
 /**
  * A single cell in the rendered matrix grid.
  */
@@ -663,12 +669,15 @@ declare class RenderMatrix {
     private readonly renderer;
     private readonly axes;
     private readonly complexityClass;
+    private readonly renderMode;
     /** Maximum number of cells to render in parallel. @default 8 */
     private readonly concurrency;
     constructor(renderer: MatrixRenderer, axes: MatrixAxis[], options?: {
         complexityClass?: ComplexityClass;
         /** Max parallel renders. Default 8. */
         concurrency?: number;
+        /** Force a render backend for every matrix cell. Default: auto. */
+        renderMode?: RenderMode;
     });
     /** Total number of cells (product of all axis cardinalities). */
     get cellCount(): number;
@@ -945,4 +954,4 @@ declare function stressAxis(id: StressCategoryId): {
  */
 declare function extractInlineStyles(element: React.ReactNode, path?: string): Record<string, Record<string, string>>;
 
-export { ALL_CONTEXTS, ALL_CONTEXT_IDS, ALL_STRESS_IDS, ALL_STRESS_PRESETS, type BoundingBox, BrowserPool, type BrowserPoolConfig, COMPOSITION_CONTEXTS, type CaptureOptions, type CellBounds, type CellCoordinateMap, type CompositionContext, type CompositionContextId, type ContainerOptions, type ContainerType, type CrashedRenderResult, type DOMNode, type EnvironmentOptions, type FontEntry, type HeuristicFlag, type MatrixAxis, type MatrixCell, type MatrixRenderer, type MatrixResult, type MatrixStats, type PageSlot, type PoolPreset, type PoolSizeConfig, RenderError, type RenderErrorFields, RenderMatrix, type RenderOptions, type RenderOutcome, type RenderResult, type RendererConfig, type SatoriRenderOptions, SatoriRenderer, type SourceLocation, SpriteSheetGenerator, type SpriteSheetOptions, type SpriteSheetResult, type StressCategoryId, type StressPreset, type SuccessRenderResult, type ViewportOptions, cartesianProduct, clearFontCache, contextAxis, detectHeuristicFlags, extractInlineStyles, fontCacheSize, getContext, getContexts, getStressPreset, getStressPresets, labelForValue, loadFont, safeRender, stressAxis, wrapWithProviders };
+export { ALL_CONTEXTS, ALL_CONTEXT_IDS, ALL_STRESS_IDS, ALL_STRESS_PRESETS, type BoundingBox, BrowserPool, type BrowserPoolConfig, COMPOSITION_CONTEXTS, type CaptureOptions, type CellBounds, type CellCoordinateMap, type CompositionContext, type CompositionContextId, type ContainerOptions, type ContainerType, type CrashedRenderResult, type DOMNode, type EnvironmentOptions, type FontEntry, type HeuristicFlag, type MatrixAxis, type MatrixCell, type MatrixRenderer, type MatrixResult, type MatrixStats, type PageSlot, type PoolPreset, type PoolSizeConfig, RenderError, type RenderErrorFields, RenderMatrix, type RenderMode, type RenderOptions, type RenderOutcome, type RenderResult, type RendererConfig, type SatoriRenderOptions, SatoriRenderer, type SourceLocation, SpriteSheetGenerator, type SpriteSheetOptions, type SpriteSheetResult, type StressCategoryId, type StressPreset, type SuccessRenderResult, type ViewportOptions, cartesianProduct, clearFontCache, contextAxis, detectHeuristicFlags, extractInlineStyles, fontCacheSize, getContext, getContexts, getStressPreset, getStressPresets, labelForValue, loadFont, safeRender, stressAxis, wrapWithProviders };

package/dist/index.js

@@ -800,6 +800,7 @@ var RenderMatrix = class {
   renderer;
   axes;
   complexityClass;
+  renderMode;
   /** Maximum number of cells to render in parallel. @default 8 */
   concurrency;
   constructor(renderer, axes, options = {}) {
@@ -814,6 +815,7 @@ var RenderMatrix = class {
     this.renderer = renderer;
     this.axes = axes;
     this.complexityClass = options.complexityClass ?? "simple";
+    this.renderMode = options.renderMode ?? "auto";
     this.concurrency = options.concurrency ?? 8;
   }
   // ---------------------------------------------------------------------------
@@ -879,7 +881,7 @@ var RenderMatrix = class {
           const val = combo[axisIdx];
           axisIndices.push(axis ? axis.values.indexOf(val) : -1);
         }
-        const result = await this.renderer.renderCell(props, this.complexityClass);
+        const result = await this.renderer.renderCell(props, this.complexityClass, this.renderMode);
         cells[i] = { props, result, index: i, axisIndices };
       }
     };