@devcabs/folio-engine 0.0.0-stage → 0.1.0

package/dist/App.d.ts

@@ -0,0 +1,7 @@
+import { type EngineConfig } from "./config/engine.config";
+import React from 'react';
+export interface AppProps {
+    config?: Partial<EngineConfig>;
+}
+export declare const App: React.FC<AppProps>;
+export default App;

package/dist/components/canvas/CanvasAddBar.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { CanvasElementType } from '../../types/canvas';
+export interface CanvasAddBarProps {
+    onAddElement: (type: CanvasElementType) => void;
+    isInitialStarter?: boolean;
+    accentColor?: string;
+    className?: string;
+    label?: string;
+    barId?: string;
+    activeBarId?: string | null;
+    onToggleActive?: (barId: string, isOpen: boolean) => void;
+}
+/**
+ * CanvasAddBar Component
+ * Folio Engine — Task 8.9: Coordinated Insertion Bar with Viewport-Aware Submenu
+ *
+ * Interactive authoring trigger for coordinators in Developer Mode:
+ * - When Developer Mode is OFF: Returns null (completely invisible to public visitors)
+ * - Initial Starter Mode: Renders an inviting prompt box to add the first section
+ * - Between-Element Mode: Gutter that dynamically reveals a subtle accent guide line
+ *   and centered "+ Add Element" pill button on hover
+ * - 5-Item Palette Popover: Section, Subsection, Text, Photo, Chart (parenthesis-free)
+ * - Photo Sub-Menu: Single Photo vs Photo Gallery with viewport detection (dropup vs dropdown)
+ * - Coordinated active state suppressing sibling hovers and duplicate menus
+ * - Adheres strictly to Universal Zero Outline Policy and design tokens
+ */
+export declare const CanvasAddBar: React.FC<CanvasAddBarProps>;
+export default CanvasAddBar;

package/dist/components/canvas/CanvasAddModal.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import type { CanvasElementType } from '../../types/canvas';
+export type AddModalElementType = CanvasElementType | 'gallery';
+export interface CanvasAddElementPayload {
+    title?: string;
+    isNumbered?: boolean;
+    content?: string;
+    as?: 'p' | 'blockquote';
+    src?: string;
+    alt?: string;
+    caption?: string;
+    showCaption?: boolean;
+    driveUrl?: string;
+    subtitle?: string;
+}
+export interface CanvasAddModalProps {
+    isOpen: boolean;
+    type: AddModalElementType | null;
+    nodeId: string;
+    targetSectionId?: string;
+    targetIndex?: number;
+    targetSubsectionId?: string;
+    onClose: () => void;
+    onConfirmAdd: (type: AddModalElementType, payload: CanvasAddElementPayload, targetSectionId?: string, targetIndex?: number, targetSubsectionId?: string) => void;
+}
+/**
+ * CanvasAddModal Component
+ * Folio Engine — Task 8.11: Required Form Fill Before Adding Elements
+ *
+ * Mandatory creation dialog requiring coordinators in Developer Mode to fill out
+ * the necessary fields (titles, narratives, media) before adding elements to the canvas:
+ * - Empty by default: Never populates fields with generic dummy values
+ * - Enforces required field validation before the Add button is enabled
+ * - Consumes canonical Modal and Button components with 100% token purity
+ * - Adheres strictly to Universal Zero Outline Policy and Absolute Ban on Dividers
+ */
+export declare const CanvasAddModal: React.FC<CanvasAddModalProps>;
+export default CanvasAddModal;

package/dist/components/canvas/CanvasChart.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { ChartElement } from '../../types/canvas';
+export interface CanvasChartProps {
+    element: ChartElement;
+    nodeId: string;
+    nodeTitle?: string;
+    accentColor?: string;
+    isDevMode?: boolean;
+    className?: string;
+}
+/**
+ * CanvasChart Component
+ * Folio Engine — Task 8.3.3: Canvas Leaf Elements (Chart)
+ *
+ * Renders indicator data visualizers on the Dynamic Canvas:
+ * - Wires useSheetChartData with element.chartId and nodeId
+ * - Mounts canonical ChartCard.tsx
+ * - Renders DataPendingCard fallback by default when unconfigured, with '✎ Edit' button wired to ChartConfigDrawer
+ * - Memoized with React.memo (Vercel Best Practice rerender-memo)
+ * - Zero parentheses in UI and Universal Zero Outline Policy adherence
+ */
+export declare const CanvasChart: React.FC<CanvasChartProps>;
+export default CanvasChart;

package/dist/components/canvas/CanvasDeleteConfirmModal.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { CanvasElementType } from '../../types/canvas';
+export interface CanvasDeleteConfirmModalProps {
+    isOpen: boolean;
+    itemType: CanvasElementType;
+    hasChildren?: boolean;
+    onClose: () => void;
+    onConfirm: () => void;
+}
+/**
+ * CanvasDeleteConfirmModal Component
+ * Folio Engine — Task 8.9: Delete Confirmation Modal Safeguard
+ *
+ * Accessible confirmation dialog (role="alertdialog") preventing accidental content deletion:
+ * - Direct consumption of canonical Modal primitive
+ * - Clean academic editorial typography with token-driven styling
+ * - Reassures coordinators that action can be reversed with Undo toast
+ * - Adheres strictly to Universal Zero Outline Policy
+ */
+export declare const CanvasDeleteConfirmModal: React.FC<CanvasDeleteConfirmModalProps>;
+export default CanvasDeleteConfirmModal;

package/dist/components/canvas/CanvasGallery.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { GalleryElement } from '../../types/canvas';
+export interface CanvasGalleryProps {
+    element: GalleryElement;
+    nodeId: string;
+    accentColor?: string;
+    className?: string;
+}
+/**
+ * CanvasGallery Component
+ * Folio Engine — Task 8.9: Canvas Leaf Elements (Photo Gallery)
+ *
+ * Renders full multi-photo source showcase on the Dynamic Canvas:
+ * - Wraps canonical SourceGallery with responsive adaptive collage grid
+ * - Integrated Google Drive photo synchronization and full-screen lightbox
+ * - Memoized with React.memo for re-render efficiency
+ * - 100% token purity and Universal Zero Outline Policy adherence
+ */
+export declare const CanvasGallery: React.FC<CanvasGalleryProps>;
+export default CanvasGallery;

package/dist/components/canvas/CanvasItemControls.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { CanvasElementType } from '../../types/canvas';
+export interface CanvasItemControlsProps {
+    itemId: string;
+    itemType: CanvasElementType;
+    canMoveUp: boolean;
+    canMoveDown: boolean;
+    onMoveUp: () => void;
+    onMoveDown: () => void;
+    onDelete: () => void;
+    onEdit?: () => void;
+    children: React.ReactNode;
+    className?: string;
+    suppressHover?: boolean;
+    sourceParentId?: string;
+    sourceIndex?: number;
+    hasChildren?: boolean;
+    onDropItem?: (sourceItemId: string, targetContainerId: string, targetIndex?: number) => void;
+}
+/**
+ * CanvasItemControls Component
+ * Folio Engine — Task 8.9: Centered Controls, Drag-and-Drop Reordering & Delete Modal
+ *
+ * Authoring controls for canvas elements in Developer Mode:
+ * - HTML5 drag-and-drop grab handle alongside accessible tactile Move Up / Move Down buttons
+ * - Centered vertical & horizontal positioning eliminating collision with top-right edit buttons
+ * - Dedicated SVG trash can icon replacing ambiguous 'X' string
+ * - Accessible CanvasDeleteConfirmModal before executing item deletion
+ * - When Developer Mode is OFF: Only renders children with zero DOM wrapper overhead
+ * - Universal Zero Outline Policy on all controls
+ */
+export declare const CanvasItemControls: React.FC<CanvasItemControlsProps>;
+export default CanvasItemControls;

package/dist/components/canvas/CanvasPhoto.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { PhotoElement } from '../../types/canvas';
+export interface CanvasPhotoProps {
+    element: PhotoElement;
+    nodeId: string;
+    accentColor?: string;
+    isDevMode?: boolean;
+    className?: string;
+    onEdit?: () => void;
+}
+/**
+ * CanvasPhoto Component
+ * Folio Engine — Task 8.3.2 / Task 10.6 / Task 15.4: Canvas Leaf Elements (Photo)
+ *
+ * Renders high-resolution source photographic cards on the Dynamic Canvas:
+ * - Direct integration with canonical SourceLightbox for full-screen inspection
+ * - Responsive edge media proxy delivery (/api/media/drive/:fileId?w=...)
+ * - Pre-baked / dynamically derived srcSet and sizes for mobile bandwidth reduction
+ * - Loading="lazy", decoding="async", and referrerPolicy="no-referrer"
+ * - Graceful fallback to raw Google Drive thumbnail if proxy encounters network interruption
+ * - Support for official Google Drive folder link badge ("Drive Folder ↗")
+ * - Calm placeholder with camera icon when src is empty
+ * - Delegated modal authoring via parent CanvasItemControls toolbar and onEdit prop
+ * - Memoized with React.memo (Vercel Best Practice rerender-memo)
+ * - Zero parentheses in UI and Universal Zero Outline Policy adherence
+ */
+export declare const CanvasPhoto: React.FC<CanvasPhotoProps>;
+export default CanvasPhoto;

package/dist/components/canvas/CanvasSection.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+import type { SectionElement } from '../../types/canvas';
+export interface CanvasSectionProps {
+    section: SectionElement;
+    nodeId: string;
+    nodeTitle?: string;
+    accentColor?: string;
+    isDevMode?: boolean;
+    className?: string;
+    computedNumber?: string | null;
+    children?: React.ReactNode;
+    onEdit?: () => void;
+}
+/**
+ * CanvasSection Component
+ * Folio Engine — Task 8.4.1: Canvas Sectioning & Nesting Containers
+ *
+ * Top-level structural section container for the Dynamic Canvas:
+ * - Renders semantic HTML5 <section id="sec-${id}">
+ * - Exposes data-toc-title, data-toc-number, and data-toc-numbered for automated discovery by useAutoTableOfContents
+ * - Canonical SectionTitle (h2) with toggleable numbering support
+ * - Unnumbered sections cleanly omit data-toc-number and set data-toc-numbered="false"
+ * - Pure spatial separation with zero horizontal divider lines
+ * - Memoized with React.memo for re-render efficiency
+ */
+export declare const CanvasSection: React.FC<CanvasSectionProps>;
+export default CanvasSection;

package/dist/components/canvas/CanvasSubsection.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { SubsectionElement } from '../../types/canvas';
+export interface CanvasSubsectionProps {
+    subsection: SubsectionElement;
+    nodeId: string;
+    accentColor?: string;
+    isDevMode?: boolean;
+    className?: string;
+    children?: React.ReactNode;
+    onEdit?: () => void;
+}
+/**
+ * CanvasSubsection Component
+ * Folio Engine — Task 8.4.2: Canvas Sectioning & Nesting Containers
+ *
+ * Mid-level grouping container for nested initiatives on the Dynamic Canvas:
+ * - Semantic <div role="region" id="subsec-${id}"> container
+ * - Canonical SectionTitle (h3) for hierarchical document outline
+ * - Pure spatial separation without horizontal dividing lines
+ * - Memoized with React.memo for re-render efficiency
+ */
+export declare const CanvasSubsection: React.FC<CanvasSubsectionProps>;
+export default CanvasSubsection;

package/dist/components/canvas/CanvasText.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { TextElement } from '../../types/canvas';
+export interface CanvasTextProps {
+    element: TextElement;
+    nodeId: string;
+    accentColor?: string;
+    isDevMode?: boolean;
+    className?: string;
+    onEdit?: () => void;
+}
+/**
+ * CanvasText Component
+ * Folio Engine — Task 8.3.1: Canvas Leaf Elements (Text)
+ *
+ * Renders editorial narrative paragraphs or pull-quotes on the Dynamic Canvas:
+ * - Direct integration with canonical EditableText and Content DB
+ * - Fraunces serif editorial quote when element.as === 'blockquote'
+ * - Modern Academic Editorial body narrative when element.as === 'p' or default
+ * - Memoized with React.memo (Vercel Best Practice rerender-memo)
+ * - Zero parentheses in UI and Universal Zero Outline Policy adherence
+ */
+export declare const CanvasText: React.FC<CanvasTextProps>;
+export default CanvasText;

package/dist/components/canvas/DocumentCanvas.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+export interface NodeCanvasProps {
+    nodeId: string;
+    nodeTitle: string;
+    accentColor?: string;
+    className?: string;
+}
+/**
+ * DocumentCanvas Component
+ * Folio Engine — Task 9.8: Unified Dynamic Canvas Add & Edit Modals and Drawers Architecture
+ *
+ * Coordinates recursive rendering of dynamic canvas sections, subsections, and leaf elements:
+ * - Reads local-first canvas document via useDocumentCanvas(nodeId)
+ * - Unified CanvasElementModal for both creating and editing elements with dual-store synchronization
+ * - Direct onEdit callbacks eliminating fragile DOM query simulation hacks
+ * - Fast-tracks indicator chart creation directly to ChartConfigDrawer in mode="add"
+ * - Returns clean layout with 0 authoring chrome in public visitor mode
+ */
+export declare const DocumentCanvas: React.FC<NodeCanvasProps>;
+export default DocumentCanvas;

package/dist/components/canvas/HeroPhoto.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+import type { NodeItem, NodeHeroImage } from "../../types/node";
+export interface HeroPhotoProps {
+    node?: Partial<NodeItem>;
+    heroImage?: NodeHeroImage;
+    onExploreNode?: (nodeId: string) => void;
+    className?: string;
+    priority?: boolean;
+    docked?: boolean;
+    focalPoint?: {
+        x: number;
+        y: number;
+    };
+    onClick?: () => void;
+}
+export declare const HeroPhoto: React.FC<HeroPhotoProps>;
+export default HeroPhoto;

package/dist/components/canvas/NodeCanvas.d.ts

@@ -0,0 +1,2 @@
+export { DocumentCanvas as NodeCanvas, type NodeCanvasProps } from "./DocumentCanvas";
+export { DocumentCanvas as default } from "./DocumentCanvas";

package/dist/components/canvas/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Canvas Components Barrel
+ * Folio Engine — Task 18.4: Dynamic Document Canvas Engine
+ */
+export { CanvasText, type CanvasTextProps } from "./CanvasText";
+export { CanvasPhoto, type CanvasPhotoProps } from "./CanvasPhoto";
+export { CanvasGallery, type CanvasGalleryProps } from "./CanvasGallery";
+export { CanvasChart, type CanvasChartProps } from "./CanvasChart";
+export { CanvasSection, type CanvasSectionProps } from "./CanvasSection";
+export { CanvasSubsection, type CanvasSubsectionProps } from "./CanvasSubsection";
+export { CanvasAddBar, type CanvasAddBarProps } from "./CanvasAddBar";
+export { CanvasItemControls, type CanvasItemControlsProps } from "./CanvasItemControls";
+export { CanvasDeleteConfirmModal, type CanvasDeleteConfirmModalProps } from "./CanvasDeleteConfirmModal";
+export { DocumentCanvas, type NodeCanvasProps } from "./DocumentCanvas";
+export { HeroPhoto, type HeroPhotoProps } from "./HeroPhoto";
+export { CanvasAddModal, type CanvasAddModalProps, type CanvasAddElementPayload } from "./CanvasAddModal";
+export { default } from "./DocumentCanvas";

package/dist/components/chart/BarChart.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { ChartSeries } from '../../types/chart';
+export interface BarChartProps {
+    categories: string[];
+    series: ChartSeries[];
+    unit?: string;
+    accentColor?: string;
+    orientation?: 'vertical' | 'horizontal';
+    barOrientation?: 'vertical' | 'horizontal';
+    stacked?: boolean;
+    showValues?: boolean;
+    xLabel?: string;
+    yLabel?: string;
+    onSelectDataPoint?: (point: {
+        category: string;
+        seriesName: string;
+        value: number | null;
+    }) => void;
+    variant?: 'standard' | 'progress';
+    targetValue?: number;
+    targetLabel?: string;
+}
+export declare const BarChart: React.FC<BarChartProps>;

package/dist/components/chart/ChartCard.d.ts

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { ChartDataset, SheetChartConfig } from '../../types/chart';
+import type { NodeCode } from '../../types/node';
+export interface ChartCardProps {
+    chartId: string;
+    dataset?: ChartDataset | null;
+    config?: SheetChartConfig | null;
+    nodeId?: NodeCode;
+    nodeTitle?: string;
+    accentColor?: string;
+    status?: import('../../types/chart').ChartSyncStatus;
+    errorMessage?: string;
+    onConfigUpdated?: (config: SheetChartConfig) => void;
+    onSync?: () => Promise<unknown> | void;
+    isSyncing?: boolean;
+    className?: string;
+    editTriggerId?: string;
+    hideEditButton?: boolean;
+}
+/**
+ * ChartCard Component
+ * Folio Engine — Subtask 7.4.4, 7.7, 7.19 & Task 8.10
+ *
+ * Editorial Bento Card shell for indicator charts.
+ * Adheres to Modern Academic Editorial design standards:
+ * - Minimal header only when data is missing; full header with As of Date when valid
+ * - Uniform Administrative Edit Button ("✎ Edit") in Developer Mode
+ * - 1-Click "View Table" modal & "Download Data (CSV)" public data receipts button (zero URL leaks)
+ * - Dignified fallback with background ghost wireframe (DataPendingCard) when data is pending or problematic
+ * - Suppressed footer when hasData is false (Law of Subtraction)
+ * - Mobile caption purge on screens <= 640px
+ */
+export declare const ChartCard: React.FC<ChartCardProps>;

package/dist/components/chart/ChartConfigDrawer.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { SheetChartConfig } from '../../types/chart';
+import type { NodeCode } from '../../types/node';
+export type WizardStep = 1 | 2;
+export type ChartSetupSubTab = 'style' | 'data' | 'sorting';
+export interface ChartConfigDrawerProps {
+    isOpen: boolean;
+    onClose: () => void;
+    chartId: string;
+    nodeId: NodeCode;
+    initialConfig?: SheetChartConfig;
+    previewMatrix?: (string | number | null)[][];
+    onDeployed?: (config: SheetChartConfig) => void;
+    mode?: 'add' | 'edit';
+}
+export declare const ChartConfigDrawer: React.FC<ChartConfigDrawerProps>;

package/dist/components/chart/ChartGhostWireframe.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+export interface ChartGhostWireframeProps {
+    className?: string;
+}
+/**
+ * ChartGhostWireframe Component
+ * Folio Engine — Task 8.10
+ *
+ * Universal calm, tokenized SVG wireframe skeleton:
+ * - Subtle X/Y baseline axes
+ * - Soft staggered vertical bar silhouettes
+ * - Strictly decorative background (aria-hidden="true")
+ * - Enforces Universal Zero Outline Policy and token purity
+ */
+export declare const ChartGhostWireframe: React.FC<ChartGhostWireframeProps>;
+export default ChartGhostWireframe;

package/dist/components/chart/ChartLegend.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+export declare const CHART_DIMMED_OPACITY = 0.15;
+export interface ChartLegendItem {
+    id: string;
+    name: string;
+    color: string;
+}
+export interface ChartLegendProps {
+    items: ChartLegendItem[];
+    activeIndex?: number | null;
+    onHover?: (index: number | null) => void;
+    className?: string;
+}
+export declare const ChartLegend: React.FC<ChartLegendProps>;

package/dist/components/chart/ChartRouter.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { ChartDataset, ChartType } from '../../types/chart';
+export interface ChartRouterProps {
+    dataset: ChartDataset;
+    overrideType?: ChartType;
+    accentColor?: string;
+}
+export declare const ChartRouter: React.FC<ChartRouterProps>;

package/dist/components/chart/ChartSortingControls.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+export interface ChartSortingSeriesOption {
+    id: string;
+    name: string;
+}
+export interface ChartSortingControlsProps {
+    sortField: string;
+    sortDirection: 'asc' | 'desc';
+    categoryLabel?: string;
+    seriesOptions?: ChartSortingSeriesOption[];
+    onSortFieldChange: (field: string) => void;
+    onSortDirectionChange: (direction: 'asc' | 'desc') => void;
+    className?: string;
+}
+export declare const ChartSortingControls: React.FC<ChartSortingControlsProps>;

package/dist/components/chart/ChartTableModal.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { ChartDataset } from '../../types/chart';
+export interface ChartTableModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    dataset: ChartDataset;
+    title: string;
+    asOfDate?: string;
+    onDownloadCsv?: () => void;
+}
+/**
+ * ChartTableModal Component
+ * Folio Engine — Subtask 7.19
+ *
+ * Full-scale Large Editorial Modal displaying the pure tabular dataset
+ * powering an indicator chart. Gives citizens, teachers, and administrators
+ * immediate visual access to public data tables without downloading files.
+ *
+ * Adheres strictly to Modern Academic Editorial design standards:
+ * - Large responsive dialog layout (max-width ~1000px, 85vh max-height)
+ * - Sticky table headers and row indices for seamless vertical/horizontal touch scroll
+ * - Right-aligned monospace numbers (`var(--font-mono)`)
+ * - Universal Zero Outline Policy (`outline: none;`)
+ * - Polymorphic support for Bar, Line, Donut, Scatter, and Histogram charts
+ */
+export declare const ChartTableModal: React.FC<ChartTableModalProps>;

package/dist/components/chart/ChartTooltip.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+export interface ChartTooltipProps {
+    visible: boolean;
+    x: number;
+    y: number;
+    title?: string;
+    seriesName?: string;
+    value: number | string | null;
+    unit?: string;
+    color?: string;
+}
+export declare const ChartTooltip: React.FC<ChartTooltipProps>;

package/dist/components/chart/DataPendingCard.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { ChartProblemCategory } from '../../types/chart';
+export interface DataPendingCardProps {
+    chartId?: string;
+    nodeTitle?: string;
+    category?: ChartProblemCategory;
+    errorMessage?: string;
+    hasSheetUrl?: boolean;
+    onEdit?: () => void;
+    className?: string;
+    headline?: string;
+    description?: string;
+}
+/**
+ * DataPendingCard Component
+ * Folio Engine — Subtask 7.4.5 & Task 8.10
+ *
+ * Universal dignified chart fallback when an indicator dataset has not yet been linked
+ * or is encountering access/format issues.
+ *
+ * Visual Architecture:
+ * - Background: Universal tokenized SVG ChartGhostWireframe skeleton.
+ * - Public View: Quiet, dignified notice with brand mark.
+ * - Developer Mode: 3-point diagnostic panel with concrete coordinator troubleshooting hints
+ *   and the uniform administrative '✎ Edit' button wired to ChartConfigDrawer.
+ */
+export declare const DataPendingCard: React.FC<DataPendingCardProps>;
+export default DataPendingCard;

package/dist/components/chart/DonutChart.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+export interface DonutChartProps {
+    categories: string[];
+    data: number[];
+    unit?: string;
+    accentColor?: string;
+    donutVariant?: 'donut' | 'pie';
+    groupOthers?: boolean;
+    showValues?: boolean;
+    seriesName?: string;
+    onSelectDataPoint?: (point: {
+        category: string;
+        value: number;
+    }) => void;
+}
+export declare const DonutChart: React.FC<DonutChartProps>;

package/dist/components/chart/HistogramChart.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { ChartSeries, HistogramBin } from '../../types/chart';
+export interface HistogramChartProps {
+    rawValues?: number[];
+    series?: ChartSeries[];
+    unit?: string;
+    accentColor?: string;
+    binStrategy?: 'auto' | 'custom';
+    binCount?: number;
+    bucketSize?: number;
+    histogramYMode?: 'frequency' | 'relative';
+    curveInterpolation?: 'smooth' | 'straight' | 'none';
+    showSummaryStats?: boolean;
+    showMedianMode?: boolean;
+    showReferenceGuide?: boolean;
+    sortBy?: string;
+    sortField?: string;
+    sortDirection?: 'asc' | 'desc';
+    xLabel?: string;
+    yLabel?: string;
+    onSelectBin?: (bin: HistogramBin) => void;
+}
+export declare const HistogramChart: React.FC<HistogramChartProps>;

package/dist/components/chart/LineChart.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { ChartSeries } from '../../types/chart';
+export interface LineChartProps {
+    categories: string[];
+    series: ChartSeries[];
+    unit?: string;
+    accentColor?: string;
+    curveInterpolation?: 'smooth' | 'straight' | 'none';
+    showAreaFill?: boolean;
+    markerSize?: 'compact' | 'regular' | 'prominent';
+    autoScaleY?: boolean;
+    startAtZero?: boolean;
+    showValues?: boolean;
+    xLabel?: string;
+    yLabel?: string;
+    onSelectDataPoint?: (point: {
+        category: string;
+        seriesName: string;
+        value: number | null;
+    }) => void;
+}
+export declare const LineChart: React.FC<LineChartProps>;

package/dist/components/chart/RangePreviewMatrix.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+export interface RangePreviewMatrixProps {
+    matrix: (string | number | null)[][];
+    range?: string;
+    isSelecting?: boolean;
+    onRangeSelect?: (newRange: string) => void;
+    excludeSummaryRows?: boolean;
+    className?: string;
+}
+/**
+ * RangePreviewMatrix Component
+ * Folio Engine — Task 13.1: Full-Viewport Edge-to-Edge Spreadsheet Grid
+ *
+ * Renders the entire Google Sheet without artificial card frames or embellishments.
+ * Supports interactive click-and-drag and two-click highlighting to define
+ * cell bounding box ranges (e.g. A1:D6) in real time.
+ */
+export declare const RangePreviewMatrix: React.FC<RangePreviewMatrixProps>;
+export default RangePreviewMatrix;