@the-syllabus/analysis-renderers 0.2.0

package/dist/sub-renderers/SubRenderers.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SubRenderers — Section-level rendering components for accordion sections.
+ *
+ * These are small, focused renderers that handle one section's data within
+ * an accordion. The AccordionRenderer dispatches to these based on
+ * config.section_renderers[sectionKey].renderer_type.
+ *
+ * Available sub-renderers:
+ *   chip_grid        — Array of strings/objects → weighted chip cloud
+ *   definition_list  — Array of "Term: Definition" strings or objects → glossary layout
+ *   mini_card_list   — Array of objects → hero + grid insight cards
+ *   key_value_table  — Object or [{key, value}] → styled two-column table
+ *   prose_block      — String → formatted analysis with lede, blockquotes
+ *   stat_row         — Object → monospace stat cards
+ *   comparison_panel — Array of objects → side-by-side comparison with headers
+ *   timeline_strip   — Array of objects with stages → evolution arc with progression
+ *   evidence_trail   — Vertical chain of evidence steps with dot markers and connectors
+ *   ordered_flow     — Ordered sequence of content units with connecting line and category badges
+ *   intensity_matrix      — Dashboard rows with horizontal intensity bars for quantitative dimensions
+ *   move_repertoire       — Grouped card list with collapsible category headers and count badges
+ *   dialectical_pair      — Two-panel tension visualization for thesis/antithesis contrasts
+ *   rich_description_list — Stacked items with colored borders for paragraph-length descriptions
+ *   phase_timeline        — Connected timeline with prominent phase nodes for temporal data
+ *   distribution_summary  — Visual bar chart with dominant highlight, counts, and optional narrative
+ */
+import React from 'react';
+import type { SubRendererProps } from '../types';
+export type { SubRendererProps } from '../types';
+export declare function resolveSubRenderer(rendererType: string): React.FC<SubRendererProps> | null;
+/**
+ * Auto-detect the best sub-renderer for a data shape.
+ * Used by AccordionRenderer when no section_renderer is explicitly configured.
+ *
+ * Decision tree:
+ *   string → prose_block
+ *   string[] → chip_grid
+ *   object[] with nested array fields → timeline_strip (concept evolution, stage progressions)
+ *   object[] with title+description → mini_card_list
+ *   object[] short items (≤3 fields, all short) → chip_grid
+ *   flat object (no nested arrays) → key_value_table
+ *   object with only numeric values → stat_row
+ */
+export declare function autoDetectSubRenderer(data: unknown): string | null;
+/**
+ * Visual distribution bar chart with optional dominant pattern highlight
+ * and collapsible narrative. Configurable via JSON view definitions.
+ *
+ * Data shape (object):
+ *   {
+ *     distribution: Record<string, number> | Array<{ key: string; count: number; major_count?: number }>
+ *     dominant?: string
+ *     narrative?: string
+ *   }
+ *
+ * Field mapping config (for data that doesn't use these exact field names):
+ *   distribution_field?: string   -- field name for distribution data (default: "distribution")
+ *   dominant_field?: string       -- field name for dominant item (default: "dominant")
+ *   narrative_field?: string      -- field name for narrative text (default: "narrative")
+ *
+ * Display config:
+ *   category?: string            -- design token category for colors (e.g., "tactic", "relationship")
+ *   dominant_label?: string       -- label above dominant value (default: "Dominant")
+ *   count_noun?: string           -- noun for total count (default: "items")
+ *   type_noun?: string            -- noun for type count (default: "types")
+ *   severity_value?: string       -- label for severity badges (default: "major")
+ *
+ * Interactive mode (passed by CardGridRenderer via _ prefix):
+ *   _onFilterClick?: (key: string) => void   -- makes bars clickable
+ *   _activeFilter?: string | null            -- highlights active bar
+ *   _groups?: Group[]                        -- live groups (overrides distribution field)
+ */
+export declare function DistributionSummary({ data, config }: SubRendererProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=SubRenderers.d.ts.map

package/dist/sub-renderers/SubRenderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubRenderers.d.ts","sourceRoot":"","sources":["../../src/sub-renderers/SubRenderers.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AAKxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAKjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA0BjD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAE1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA0ClE;AAknGD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,gBAAgB,kDAuJrE"}