@devcabs/folio-engine 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { ScatterPoint } from '../../types/chart';
+export interface ScatterPlotProps {
+    points?: ScatterPoint[];
+    xLabel?: string;
+    yLabel?: string;
+    unit?: string;
+    accentColor?: string;
+    curveInterpolation?: 'none' | 'linear' | 'smooth' | 'polynomial' | 'straight';
+    loessBandwidth?: number;
+    showAreaFill?: boolean;
+    markerSize?: 'compact' | 'regular' | 'prominent';
+    autoScaleY?: boolean;
+    autoScaleX?: boolean;
+    startAtZero?: boolean;
+    startAtZeroX?: boolean;
+    showCorrelationChip?: boolean;
+    showReferenceGuide?: boolean;
+    onSelectPoint?: (point: ScatterPoint) => void;
+}
+export declare const ScatterPlot: React.FC<ScatterPlotProps>;

package/dist/components/chart/drawer/controls/BarVisualControls.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface BarVisualControlsProps {
+    barOrientation: 'vertical' | 'horizontal';
+    setBarOrientation: (val: 'vertical' | 'horizontal') => void;
+    stacked: boolean;
+    setStacked: (val: boolean) => void;
+}
+export declare const BarVisualControls: React.FC<BarVisualControlsProps>;
+export {};

package/dist/components/chart/drawer/controls/ChartTitlesSection.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { ChartType } from '../../../../types/chart';
+interface ChartTitlesSectionProps {
+    titleOverride: string;
+    setTitleOverride: (val: string) => void;
+    subtitleOverride: string;
+    setSubtitleOverride: (val: string) => void;
+    xLabel?: string;
+    setXLabel?: (val: string) => void;
+    yLabel?: string;
+    setYLabel?: (val: string) => void;
+    chartType?: ChartType;
+}
+export declare const ChartTitlesSection: React.FC<ChartTitlesSectionProps>;
+export {};

package/dist/components/chart/drawer/controls/DonutVisualControls.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+interface DonutVisualControlsProps {
+    donutVariant: 'donut' | 'pie';
+    setDonutVariant: (val: 'donut' | 'pie') => void;
+}
+export declare const DonutVisualControls: React.FC<DonutVisualControlsProps>;
+export {};

package/dist/components/chart/drawer/controls/HistogramVisualControls.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface HistogramVisualControlsProps {
+    curveInterpolation: 'smooth' | 'straight' | 'linear' | 'none' | 'polynomial';
+    setCurveInterpolation: (val: 'smooth' | 'straight' | 'linear' | 'none' | 'polynomial') => void;
+    showReferenceGuide: boolean;
+    setShowReferenceGuide: (val: boolean) => void;
+    showSummaryStats: boolean;
+    setShowSummaryStats: (val: boolean) => void;
+    showMedianMode: boolean;
+    setShowMedianMode: (val: boolean) => void;
+}
+export declare const HistogramVisualControls: React.FC<HistogramVisualControlsProps>;
+export {};

package/dist/components/chart/drawer/controls/LineVisualControls.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface LineVisualControlsProps {
+    curveInterpolation: 'smooth' | 'straight' | 'linear' | 'none' | 'polynomial';
+    setCurveInterpolation: (val: 'smooth' | 'straight' | 'linear' | 'none' | 'polynomial') => void;
+    markerSize: 'compact' | 'regular' | 'prominent';
+    setMarkerSize: (val: 'compact' | 'regular' | 'prominent') => void;
+    showAreaFill: boolean;
+    setShowAreaFill: (val: boolean) => void;
+    startAtZero: boolean;
+    setStartAtZero: (val: boolean) => void;
+    setAutoScaleY: (val: boolean) => void;
+}
+export declare const LineVisualControls: React.FC<LineVisualControlsProps>;
+export {};

package/dist/components/chart/drawer/controls/ScatterDataControls.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+interface ScatterDataControlsProps {
+    effectiveScatterX: number;
+    setScatterXColIndex: (val: number) => void;
+    effectiveScatterY: number;
+    setScatterYColIndex: (val: number) => void;
+    effectiveScatterLabel: number;
+    setScatterLabelColIndex: (val: number) => void;
+    scatterGroupColIndex?: number;
+    setScatterGroupColIndex: (val?: number) => void;
+    detectedColumns: Array<{
+        index: number;
+        label: string;
+    }>;
+}
+export declare const ScatterDataControls: React.FC<ScatterDataControlsProps>;
+export {};

package/dist/components/chart/drawer/controls/ScatterVisualControls.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+interface ScatterVisualControlsProps {
+    curveInterpolation: 'smooth' | 'straight' | 'linear' | 'none' | 'polynomial';
+    setCurveInterpolation: (val: 'smooth' | 'straight' | 'linear' | 'none' | 'polynomial') => void;
+    markerSize: 'compact' | 'regular' | 'prominent';
+    setMarkerSize: (val: 'compact' | 'regular' | 'prominent') => void;
+    loessBandwidth: number;
+    setLoessBandwidth: (val: number) => void;
+    showAreaFill: boolean;
+    setShowAreaFill: (val: boolean) => void;
+    showCorrelationChip: boolean;
+    setShowCorrelationChip: (val: boolean) => void;
+    showReferenceGuide: boolean;
+    setShowReferenceGuide: (val: boolean) => void;
+    startAtZero: boolean;
+    setStartAtZero: (val: boolean) => void;
+    setAutoScaleY: (val: boolean) => void;
+    startAtZeroX: boolean;
+    setStartAtZeroX: (val: boolean) => void;
+    setAutoScaleX: (val: boolean) => void;
+}
+export declare const ScatterVisualControls: React.FC<ScatterVisualControlsProps>;
+export {};

package/dist/components/chart/drawer/controls/SortingAndOrderControls.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { ChartType } from '../../../../types/chart';
+interface SortingAndOrderControlsProps {
+    chartType: ChartType;
+    sortBy: 'none' | 'asc' | 'desc' | 'category-asc' | 'category-desc';
+    setSortBy: (val: 'none' | 'asc' | 'desc' | 'category-asc' | 'category-desc') => void;
+    sortField: string;
+    setSortField: (val: string) => void;
+    sortDirection: 'asc' | 'desc';
+    setSortDirection: (val: 'asc' | 'desc') => void;
+    categoryColIndex: number;
+    detectedColumns: Array<{
+        index: number;
+        label: string;
+    }>;
+}
+export declare const SortingAndOrderControls: React.FC<SortingAndOrderControlsProps>;
+export {};

package/dist/components/chart/drawer/controls/StandardDataControls.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { ChartType } from '../../../../types/chart';
+interface StandardDataControlsProps {
+    chartType: ChartType;
+    categoryColIndex: number;
+    setCategoryColIndex: (val: number) => void;
+    detectedColumns: Array<{
+        index: number;
+        label: string;
+    }>;
+    includedSeriesIndices: number[] | undefined;
+    setIncludedSeriesIndices: (val: number[] | undefined) => void;
+    binStrategy: 'auto' | 'custom';
+    setBinStrategy: (val: 'auto' | 'custom') => void;
+    customBinMode: 'step' | 'count';
+    setCustomBinMode: (val: 'step' | 'count') => void;
+    bucketSize: number | '';
+    setBucketSize: (val: number | '') => void;
+    binCount: number | '';
+    setBinCount: (val: number | '') => void;
+    histogramYMode: 'frequency' | 'relative';
+    setHistogramYMode: (val: 'frequency' | 'relative') => void;
+    groupOthers: boolean;
+    setGroupOthers: (val: boolean) => void;
+    sortField: string;
+    setSortField: (val: string) => void;
+    accentColor: string;
+    handleToggleSeries: (colIdx: number) => void;
+}
+export declare const StandardDataControls: React.FC<StandardDataControlsProps>;
+export {};

package/dist/components/chart/drawer/hooks/useChartConfigForm.d.ts

@@ -0,0 +1,156 @@
+import type { SheetChartConfig, ChartType } from '../../../../types/chart';
+import type { NodeCode } from '../../../../types/node';
+export interface FormSnapshot {
+    sheetUrl: string;
+    tabName: string;
+    sheetGid: string;
+    range: string;
+    chartType: ChartType;
+    unit: string;
+    titleOverride: string;
+    subtitleOverride: string;
+    barVariant: 'standard' | 'progress';
+    targetValue: number | undefined;
+    targetLabel: string;
+    categoryColIndex: number;
+    includedSeriesIndices: number[] | undefined;
+    sortBy: 'none' | 'asc' | 'desc' | 'category-asc' | 'category-desc';
+    sortField: string;
+    sortDirection: 'asc' | 'desc';
+    orientation: 'vertical' | 'horizontal';
+    barOrientation: 'vertical' | 'horizontal';
+    stacked: boolean;
+    showValues: boolean;
+    lastModifiedTime: string | undefined;
+    excludeSummaryRows: boolean;
+    transpose: boolean;
+    curveInterpolation: 'smooth' | 'straight' | 'linear' | 'none' | 'polynomial';
+    showAreaFill: boolean;
+    markerSize: 'compact' | 'regular' | 'prominent';
+    autoScaleY: boolean;
+    startAtZero: boolean;
+    scatterXColIndex?: number;
+    scatterYColIndex?: number;
+    scatterLabelColIndex?: number;
+    scatterGroupColIndex?: number;
+    autoScaleX: boolean;
+    startAtZeroX: boolean;
+    loessBandwidth: number;
+    showCorrelationChip: boolean;
+    donutVariant: 'donut' | 'pie';
+    groupOthers: boolean;
+    binStrategy: 'auto' | 'custom';
+    customBinMode: 'step' | 'count';
+    binCount: number;
+    bucketSize: number;
+    histogramYMode: 'frequency' | 'relative';
+    showSummaryStats: boolean;
+    showMedianMode: boolean;
+    showReferenceGuide: boolean;
+    xLabel: string;
+    yLabel: string;
+}
+export declare function createSnapshotFromConfig(cfg?: SheetChartConfig): FormSnapshot;
+export declare function useChartConfigForm(initialConfig?: SheetChartConfig): {
+    sheetUrl: string;
+    setSheetUrl: import("react").Dispatch<import("react").SetStateAction<string>>;
+    tabName: string;
+    setTabName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    sheetGid: string;
+    setSheetGid: import("react").Dispatch<import("react").SetStateAction<string>>;
+    range: string;
+    setRange: import("react").Dispatch<import("react").SetStateAction<string>>;
+    chartType: ChartType;
+    setChartType: import("react").Dispatch<import("react").SetStateAction<ChartType>>;
+    unit: string;
+    setUnit: import("react").Dispatch<import("react").SetStateAction<string>>;
+    titleOverride: string;
+    setTitleOverride: import("react").Dispatch<import("react").SetStateAction<string>>;
+    subtitleOverride: string;
+    setSubtitleOverride: import("react").Dispatch<import("react").SetStateAction<string>>;
+    xLabel: string;
+    setXLabel: import("react").Dispatch<import("react").SetStateAction<string>>;
+    yLabel: string;
+    setYLabel: import("react").Dispatch<import("react").SetStateAction<string>>;
+    excludeSummaryRows: boolean;
+    setExcludeSummaryRows: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    transpose: boolean;
+    setTranspose: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    barVariant: "standard" | "progress";
+    setBarVariant: import("react").Dispatch<import("react").SetStateAction<"standard" | "progress">>;
+    targetValue: number | undefined;
+    setTargetValue: import("react").Dispatch<import("react").SetStateAction<number | undefined>>;
+    targetLabel: string;
+    setTargetLabel: import("react").Dispatch<import("react").SetStateAction<string>>;
+    categoryColIndex: number;
+    setCategoryColIndex: import("react").Dispatch<import("react").SetStateAction<number>>;
+    includedSeriesIndices: number[] | undefined;
+    setIncludedSeriesIndices: import("react").Dispatch<import("react").SetStateAction<number[] | undefined>>;
+    sortBy: "none" | "asc" | "desc" | "category-asc" | "category-desc";
+    setSortBy: import("react").Dispatch<import("react").SetStateAction<"none" | "asc" | "desc" | "category-asc" | "category-desc">>;
+    sortField: string;
+    setSortField: import("react").Dispatch<import("react").SetStateAction<string>>;
+    sortDirection: "asc" | "desc";
+    setSortDirection: import("react").Dispatch<import("react").SetStateAction<"asc" | "desc">>;
+    barOrientation: "vertical" | "horizontal";
+    setBarOrientation: import("react").Dispatch<import("react").SetStateAction<"vertical" | "horizontal">>;
+    stacked: boolean;
+    setStacked: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    showValues: boolean;
+    setShowValues: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    lastModifiedTime: string | undefined;
+    setLastModifiedTime: import("react").Dispatch<import("react").SetStateAction<string | undefined>>;
+    curveInterpolation: "none" | "smooth" | "straight" | "linear" | "polynomial";
+    setCurveInterpolation: import("react").Dispatch<import("react").SetStateAction<"none" | "smooth" | "straight" | "linear" | "polynomial">>;
+    showAreaFill: boolean;
+    setShowAreaFill: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    markerSize: "compact" | "regular" | "prominent";
+    setMarkerSize: import("react").Dispatch<import("react").SetStateAction<"compact" | "regular" | "prominent">>;
+    autoScaleY: boolean;
+    setAutoScaleY: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    startAtZero: boolean;
+    setStartAtZero: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    scatterXColIndex: number | undefined;
+    setScatterXColIndex: import("react").Dispatch<import("react").SetStateAction<number | undefined>>;
+    scatterYColIndex: number | undefined;
+    setScatterYColIndex: import("react").Dispatch<import("react").SetStateAction<number | undefined>>;
+    scatterLabelColIndex: number | undefined;
+    setScatterLabelColIndex: import("react").Dispatch<import("react").SetStateAction<number | undefined>>;
+    scatterGroupColIndex: number | undefined;
+    setScatterGroupColIndex: import("react").Dispatch<import("react").SetStateAction<number | undefined>>;
+    autoScaleX: boolean;
+    setAutoScaleX: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    startAtZeroX: boolean;
+    setStartAtZeroX: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    loessBandwidth: number;
+    setLoessBandwidth: import("react").Dispatch<import("react").SetStateAction<number>>;
+    showCorrelationChip: boolean;
+    setShowCorrelationChip: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    donutVariant: "donut" | "pie";
+    setDonutVariant: import("react").Dispatch<import("react").SetStateAction<"donut" | "pie">>;
+    groupOthers: boolean;
+    setGroupOthers: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    binStrategy: "auto" | "custom";
+    setBinStrategy: import("react").Dispatch<import("react").SetStateAction<"auto" | "custom">>;
+    customBinMode: "step" | "count";
+    setCustomBinMode: import("react").Dispatch<import("react").SetStateAction<"step" | "count">>;
+    binCount: number | "";
+    setBinCount: import("react").Dispatch<import("react").SetStateAction<number | "">>;
+    bucketSize: number | "";
+    setBucketSize: import("react").Dispatch<import("react").SetStateAction<number | "">>;
+    histogramYMode: "frequency" | "relative";
+    setHistogramYMode: import("react").Dispatch<import("react").SetStateAction<"frequency" | "relative">>;
+    showSummaryStats: boolean;
+    setShowSummaryStats: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    showMedianMode: boolean;
+    setShowMedianMode: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    showReferenceGuide: boolean;
+    setShowReferenceGuide: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    savedSnapshot: FormSnapshot;
+    setSavedSnapshot: import("react").Dispatch<import("react").SetStateAction<FormSnapshot>>;
+    hasUnsavedChanges: boolean;
+    resetForm: (cfg?: SheetChartConfig) => void;
+    markAsSaved: (cfg: SheetChartConfig) => void;
+    buildConfigPayload: (chartId: string, nodeId: NodeCode, effectiveScatterX?: number, effectiveScatterY?: number, effectiveScatterLabel?: number) => SheetChartConfig;
+};
+export type ChartConfigFormReturn = ReturnType<typeof useChartConfigForm>;

package/dist/components/chart/drawer/hooks/useLiveMatrixSync.d.ts

@@ -0,0 +1,21 @@
+interface UseLiveMatrixSyncProps {
+    sheetUrl: string;
+    tabName: string;
+    sheetGid: string;
+    range: string;
+    previewMatrix?: (string | number | null)[][] | null | undefined;
+}
+export declare function useLiveMatrixSync({ sheetUrl, tabName, sheetGid, range, previewMatrix, }: UseLiveMatrixSyncProps): {
+    fetchedMatrix: (string | number | null)[][];
+    fullMatrix: (string | number | null)[][];
+    isSyncing: boolean;
+    liveMatrix: (string | number | null)[][];
+    activeMatrix: (string | number | null)[][];
+    detectedColumns: {
+        index: number;
+        label: string;
+    }[];
+    detectedRange: string | null;
+    executeSync: (targetUrl?: string, targetTab?: string, targetGid?: string) => Promise<void>;
+};
+export {};

package/dist/components/chart/drawer/hooks/useSheetVerification.d.ts

@@ -0,0 +1,26 @@
+import type { SheetChartConfig } from '../../../../types/chart';
+import { type SheetMetadataTab } from '../../../../services/sheetsVerificationService';
+export type AccessStatus = 'idle' | 'checking' | 'public' | 'restricted' | 'invalid';
+interface UseSheetVerificationProps {
+    sheetUrl: string;
+    tabName: string;
+    sheetGid: string;
+    initialConfig?: SheetChartConfig;
+    setTabName: (name: string) => void;
+    setSheetGid: (gid: string) => void;
+    setLastModifiedTime: (time?: string) => void;
+    onAutoSelectTab?: (tabTitle: string, gid: string) => void;
+}
+export declare function useSheetVerification({ sheetUrl, tabName, sheetGid, initialConfig, setTabName, setSheetGid, setLastModifiedTime, onAutoSelectTab, }: UseSheetVerificationProps): {
+    accessStatus: AccessStatus;
+    setAccessStatus: import("react").Dispatch<import("react").SetStateAction<AccessStatus>>;
+    statusMessage: string;
+    setStatusMessage: import("react").Dispatch<import("react").SetStateAction<string>>;
+    discoveredTabs: SheetMetadataTab[];
+    setDiscoveredTabs: import("react").Dispatch<import("react").SetStateAction<SheetMetadataTab[]>>;
+    isStep1Valid: boolean;
+    executeVerification: (urlToVerify: string) => Promise<void>;
+    handleTabChange: (e: React.ChangeEvent<HTMLSelectElement>) => void;
+    resetVerification: (newUrl?: string, newTabName?: string, newGid?: string) => void;
+};
+export {};

package/dist/components/chart/drawer/index.d.ts

@@ -0,0 +1,17 @@
+export { useChartConfigForm, type ChartConfigFormReturn, type FormSnapshot, createSnapshotFromConfig } from './hooks/useChartConfigForm';
+export { useSheetVerification, type AccessStatus } from './hooks/useSheetVerification';
+export { useLiveMatrixSync } from './hooks/useLiveMatrixSync';
+export { Step1SourceRange } from './panels/Step1SourceRange';
+export { Step1Source } from './panels/Step1Source';
+export { Step2DataRange } from './panels/Step2DataRange';
+export { Step3ChartSetup, type ChartSetupSubTab } from './panels/Step3ChartSetup';
+export { Step4Review } from './panels/Step4Review';
+export { BarVisualControls } from './controls/BarVisualControls';
+export { LineVisualControls } from './controls/LineVisualControls';
+export { DonutVisualControls } from './controls/DonutVisualControls';
+export { HistogramVisualControls } from './controls/HistogramVisualControls';
+export { ScatterVisualControls } from './controls/ScatterVisualControls';
+export { ChartTitlesSection } from './controls/ChartTitlesSection';
+export { ScatterDataControls } from './controls/ScatterDataControls';
+export { StandardDataControls } from './controls/StandardDataControls';
+export { SortingAndOrderControls } from './controls/SortingAndOrderControls';

package/dist/components/chart/drawer/panels/Step1Source.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { SheetMetadataTab } from '../../../../services/sheetsVerificationService';
+import type { AccessStatus } from '../hooks/useSheetVerification';
+interface Step1SourceProps {
+    sheetUrl: string;
+    setSheetUrl: (url: string) => void;
+    accessStatus: AccessStatus;
+    statusMessage: string;
+    discoveredTabs: SheetMetadataTab[];
+    tabName: string;
+    setTabName: (tab: string) => void;
+    executeVerification: (url: string) => void;
+    handleTabChange: (e: React.ChangeEvent<HTMLSelectElement>) => void;
+    onResync?: () => void;
+    isSyncing?: boolean;
+}
+export declare const Step1Source: React.FC<Step1SourceProps>;
+export {};

package/dist/components/chart/drawer/panels/Step1SourceRange.d.ts

@@ -0,0 +1,32 @@
+import React from 'react';
+import { type SheetMetadataTab } from '../../../../services/sheetsVerificationService';
+import type { AccessStatus } from '../hooks/useSheetVerification';
+export interface Step1SourceRangeProps {
+    sheetUrl: string;
+    setSheetUrl: (url: string) => void;
+    accessStatus: AccessStatus;
+    statusMessage: string;
+    discoveredTabs: SheetMetadataTab[];
+    tabName: string;
+    sheetGid?: string;
+    setTabName: (tab: string) => void;
+    executeVerification: (url: string) => void;
+    handleTabChange: (e: React.ChangeEvent<HTMLSelectElement>) => void;
+    onResync?: () => void;
+    isSyncing?: boolean;
+    range: string;
+    isRangeValid: boolean;
+    isSelectingRange: boolean;
+    setIsSelectingRange: (val: boolean | ((prev: boolean) => boolean)) => void;
+    executeSync: (url?: string, tab?: string, gid?: string) => Promise<void> | void;
+}
+/**
+ * Step1SourceRange Component
+ * Folio Engine — Task 13.1: Full-Viewport Edge-to-Edge Spreadsheet Studio
+ *
+ * Streamlines Google Sheet connection and cell range selection into
+ * a single focused setup panel. Range selection is triggered interactively
+ * across the wide edge-to-edge sheet preview on the left.
+ */
+export declare const Step1SourceRange: React.FC<Step1SourceRangeProps>;
+export default Step1SourceRange;

package/dist/components/chart/drawer/panels/Step2DataRange.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+interface Step2DataRangeProps {
+    range: string;
+    setRange: (val: string) => void;
+    isRangeValid: boolean;
+    executeSync: () => void;
+    isSyncing: boolean;
+    excludeSummaryRows: boolean;
+    setExcludeSummaryRows: (val: boolean) => void;
+    transpose: boolean;
+    setTranspose: (val: boolean) => void;
+    liveMatrix: (string | number | null)[][];
+}
+export declare const Step2DataRange: React.FC<Step2DataRangeProps>;
+export {};

package/dist/components/chart/drawer/panels/Step3ChartSetup.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { ChartConfigFormReturn } from '../hooks/useChartConfigForm';
+export type ChartSetupSubTab = 'style' | 'data' | 'sorting';
+interface Step3ChartSetupProps {
+    form: ChartConfigFormReturn;
+    detectedColumns: Array<{
+        index: number;
+        label: string;
+    }>;
+    accentColor: string;
+    setupSubTab: ChartSetupSubTab;
+    setSetupSubTab: (tab: ChartSetupSubTab) => void;
+    handleSubTabKeyDown: (e: React.KeyboardEvent) => void;
+    handleToggleSeries: (colIdx: number) => void;
+}
+export declare const Step3ChartSetup: React.FC<Step3ChartSetupProps>;
+export {};

package/dist/components/chart/drawer/panels/Step4Review.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ChartType, ChartDataset } from '../../../../types/chart';
+interface Step4ReviewProps {
+    isSyncing: boolean;
+    previewDataset: ChartDataset | null;
+    chartType: ChartType;
+    accentColor: string;
+    range: string;
+}
+export declare const Step4Review: React.FC<Step4ReviewProps>;
+export {};

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

@@ -0,0 +1,22 @@
+/**
+ * Pure SVG Chart Presentation Layer & Data Visualizers
+ * Folio Engine
+ * Document Reference: docs/tasks/task7_3_pure_svg_visualizers_mobile_purge.md &
+ *                     docs/tasks/task7_4_drawer_range_matrix_supabase_deploy.md &
+ *                     docs/tasks/task7_8_5_canonical_chart_drawer_elements.md
+ */
+export { BarChart, type BarChartProps } from './BarChart';
+export { LineChart, type LineChartProps } from './LineChart';
+export { DonutChart, type DonutChartProps } from './DonutChart';
+export { ScatterPlot, type ScatterPlotProps } from './ScatterPlot';
+export { HistogramChart, type HistogramChartProps } from './HistogramChart';
+export { ChartTooltip, type ChartTooltipProps } from './ChartTooltip';
+export { ChartRouter, type ChartRouterProps } from './ChartRouter';
+export { RangePreviewMatrix, type RangePreviewMatrixProps } from './RangePreviewMatrix';
+export { ChartConfigDrawer, type ChartConfigDrawerProps } from './ChartConfigDrawer';
+export { ChartCard, type ChartCardProps } from './ChartCard';
+export { DataPendingCard, type DataPendingCardProps } from './DataPendingCard';
+export { ChartGhostWireframe, type ChartGhostWireframeProps } from './ChartGhostWireframe';
+export { ChartSortingControls, type ChartSortingControlsProps, type ChartSortingSeriesOption } from './ChartSortingControls';
+export { ChartLegend, type ChartLegendProps, type ChartLegendItem } from './ChartLegend';
+export { ChartTableModal, type ChartTableModalProps } from './ChartTableModal';

package/dist/components/dev/DevActionAffordance.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { DevActionAffordanceProps } from '../../types/developer';
+export declare const DevActionAffordance: React.FC<DevActionAffordanceProps>;
+export default DevActionAffordance;

package/dist/components/dev/DevExitConfirmModal.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+/**
+ * DevExitConfirmModal Component
+ * Folio Engine — Developer Mode Exit Safeguard
+ *
+ * Implements:
+ * Case A (Clean State): 1-click confirmation "Exit Developer Mode"
+ * Case B (Dirty State): "You have unpublished changes. Drafts will not be kept once you exit."
+ *   - [Publish & Exit]
+ *   - [Discard Draft & Exit]
+ *   - [Keep Editing]
+ */
+export declare const DevExitConfirmModal: React.FC;
+export default DevExitConfirmModal;

package/dist/components/dev/DevLockBlockedModal.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const DevLockBlockedModal: React.FC;
+export default DevLockBlockedModal;

package/dist/components/dev/DevModeBadge.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const DevModeBadge: React.FC;
+export default DevModeBadge;

package/dist/components/dev/DevPinModal.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const DevPinModal: React.FC;
+export default DevPinModal;

package/dist/components/dev/DevPublishModal.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { PublishedSnapshot } from '../../types/history';
+export interface DevPublishModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onPublished?: (snapshot: PublishedSnapshot, cloudSynced?: boolean) => void;
+}
+export declare const DevPublishModal: React.FC<DevPublishModalProps>;
+export default DevPublishModal;

package/dist/components/dev/UniversalEditModal.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { CanvasModalMode, CanvasModalElementType, CanvasElementFormData } from '../../types/canvas';
+import type { DevEditType, DevLinkData, DevImageData, DevFileData } from '../../types/developer';
+export interface UniversalEditModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    mode?: CanvasModalMode;
+    elementType?: CanvasModalElementType | null;
+    nodeId?: string;
+    itemId?: string;
+    initialData?: CanvasElementFormData;
+    targetSectionId?: string;
+    targetIndex?: number;
+    targetSubsectionId?: string;
+    onSubmit?: (data: CanvasElementFormData) => void;
+    onResetToDefault?: () => void;
+    pointId?: string;
+    type?: DevEditType;
+    currentValue?: string | DevLinkData | DevImageData | DevFileData;
+    defaultValue?: string | DevLinkData | DevImageData | DevFileData;
+    title?: string;
+    isSection?: boolean;
+    isNumbered?: boolean;
+    defaultNumbered?: boolean;
+    onNumberedChange?: (isNumbered: boolean) => void;
+    onSave?: (newValue: string, type?: DevEditType, data?: DevLinkData | DevImageData | DevFileData) => void;
+    onReset?: () => void;
+}
+/**
+ * UniversalEditModal Component
+ * Folio Engine — Task 10.6: Universal Edit Modal Unification
+ *
+ * Unifies all portal and canvas edit affordances into a single canonical modal:
+ * - Handles Dynamic Canvas Elements (Section, Subsection, Narrative Text, Photo, Gallery)
+ * - Handles Generic Portal Strings (Hero titles, Mission/Vision, Roadmap milestones, Footer, Links, Documents)
+ * - Strict Draft-Only persistence: All mutations target the draft sandbox
+ * - Universal Zero Outline Policy, 100% Token Purity, Zero Divider Lines
+ */
+export declare const UniversalEditModal: React.FC<UniversalEditModalProps>;
+export default UniversalEditModal;

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

@@ -0,0 +1,8 @@
+export { DevPinModal } from './DevPinModal';
+export { DevModeBadge } from './DevModeBadge';
+export { DevActionAffordance } from './DevActionAffordance';
+export { UniversalEditModal } from './UniversalEditModal';
+export type { UniversalEditModalProps } from './UniversalEditModal';
+export { DevLockBlockedModal } from './DevLockBlockedModal';
+export { DevExitConfirmModal } from './DevExitConfirmModal';
+export { DevPublishModal } from './DevPublishModal';

package/dist/components/feedback/EmptyState.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+export interface EmptyStateProps {
+    title?: string;
+    description?: string;
+    actionText?: string;
+    actionLabel?: string;
+    variant?: string;
+    onAction?: () => void;
+    className?: string;
+    [key: string]: any;
+}
+export declare const EmptyState: React.FC<EmptyStateProps>;
+export default EmptyState;