@devcabs/folio-engine 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,15 @@
+import React from 'react';
+export interface PageNotFoundProps {
+    onReturn?: () => void;
+    title?: string;
+    description?: string;
+    errorCode?: string;
+    returnLabel?: string;
+    className?: string;
+}
+/**
+ * PageNotFound Component
+ * Dignified 404 Fallback View adhering to the Modern Academic Editorial design.
+ */
+export declare const PageNotFound: React.FC<PageNotFoundProps>;
+export default PageNotFound;

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

@@ -0,0 +1,25 @@
+import React from 'react';
+export interface ToastProps {
+    message: string;
+    type?: 'success' | 'info' | 'error';
+    durationMs?: number;
+    onDismiss: () => void;
+    actionLabel?: string;
+    onAction?: () => void;
+    playAudio?: boolean;
+}
+/**
+ * Toast Component
+ * Folio Engine — Subtask 5.4: Link Folder Modal & URL Validation Pipeline
+ *
+ * Lightweight, accessible floating feedback capsule:
+ * - Positioned at upper-left of viewport with responsive safe-area insets
+ * - Native Web Audio API subtle chime feedback
+ * - Dedicated color variants for success, error, and info
+ * - Rendered in document.body via createPortal
+ * - ARIA role="status" and aria-live="polite"
+ * - Auto-dismisses with timer teardown
+ * - Adheres strictly to Universal Zero Outline Policy
+ */
+export declare const Toast: React.FC<ToastProps>;
+export default Toast;

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

@@ -0,0 +1,2 @@
+export { Toast } from './Toast';
+export type { ToastProps } from './Toast';

package/dist/components/history/HistoryHubModal.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Folio Engine - History Hub Drawer
+ * Location: src/components/history/HistoryHubModal.tsx
+ * Specification: docs/tasks/plan_history_drawer_redesign.md
+ * Aligned with: docs/00_WORKFLOW.md, docs/05_VISUAL_SPEC.md, docs/07_CODING_STANDARDS.md
+ *
+ * Implements:
+ * 1. Canonical Drawer slide-out container (right position, size="md").
+ * 2. Relative elapsed time format (4h, 3h, 5mo, 2d, 1y) paired with full timestamp.
+ * 3. Canonical Button component for "Restore to Draft" and footer actions.
+ * 4. User changelog description promoted to primary main text.
+ * 5. Elimination of generic "Published Revision" placeholder text.
+ * 6. Stripping parentheses such as "(Default)" from displayed titles.
+ * 7. Removal of verbose baseline description ("Original baseline...").
+ * 8. Confirmation modals for draft restore and factory baseline reset safeguards.
+ * 9. Universal Zero Outline Policy and 100% design token purity.
+ */
+import React from 'react';
+import type { PublishedSnapshot, UnifiedPortalSnapshot } from '../../types/history';
+export interface HistoryHubModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onRestored?: (title: string) => void;
+}
+export type HistoryHubDrawerProps = HistoryHubModalProps;
+/**
+ * Strips parentheses and their enclosed content from text (e.g. "(Default)" -> "").
+ */
+export declare function stripParentheses(text?: string | null): string;
+/**
+ * Compact elapsed time formatter: 4h, 3h, 5mo, 2d, 1y.
+ */
+export declare function formatTimeElapsed(isoDate: string): string;
+/**
+ * Full accessible date/time string.
+ */
+export declare function formatFullTimestamp(isoDate: string): string;
+/**
+ * Extracts the user-meaningful primary text for an item, stripping parentheses and placeholder labels.
+ */
+export declare function getItemPrimaryText(snapshot: PublishedSnapshot | UnifiedPortalSnapshot): string;
+export declare const HistoryHubDrawer: React.FC<HistoryHubDrawerProps>;
+export declare const HistoryHubModal: React.FC<HistoryHubModalProps>;
+export default HistoryHubDrawer;

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

@@ -0,0 +1 @@
+export { HistoryHubModal } from './HistoryHubModal';

package/dist/components/layout/AppFooter.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { NodeCode } from '../../types/node';
+export interface AppFooterProps {
+    orgName?: string;
+    onRoadmapClick?: (e?: React.MouseEvent) => void;
+    onOverviewClick?: (e?: React.MouseEvent) => void;
+    onNodeClick?: (nodeCode: NodeCode, e?: React.MouseEvent) => void;
+}
+export declare const AppFooter: React.FC<AppFooterProps>;
+export default AppFooter;

package/dist/components/layout/AppHeader.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { NavItem } from '../../types/navigation';
+export type { NavItem };
+export interface AppHeaderProps {
+    brandTitle?: string;
+    /** @deprecated Header retains only the primary title; subtitle is no longer displayed. */
+    brandSubtitle?: string;
+    brandLetter?: string;
+    navItems?: NavItem[];
+    mobileOnlyNav?: boolean;
+    onRoadmapClick?: (e?: React.MouseEvent) => void;
+    onOverviewClick?: (e?: React.MouseEvent) => void;
+    onBrandClick?: (e?: React.MouseEvent) => void;
+    ctaLabel?: string;
+    ctaHref?: string;
+    isCtaVisible?: boolean;
+    isCtaRevolving?: boolean;
+    isCtaPulsing?: boolean;
+    onCtaClick?: (e?: React.MouseEvent) => void;
+}
+export declare const AppHeader: React.FC<AppHeaderProps>;
+export default AppHeader;

package/dist/components/layout/EditorialSection.d.ts

@@ -0,0 +1,27 @@
+import React from 'react';
+export interface EditorialSectionProps {
+    /** Required unique anchor element ID */
+    id: string;
+    /** Section title displayed in Table of Contents */
+    title?: string;
+    /** Section number displayed in Table of Contents */
+    number?: string | number;
+    /** Custom semantic element tag (default: 'section') */
+    as?: 'section' | 'article' | 'div';
+    /** Optional custom CSS class */
+    className?: string;
+    /** Optional inline style */
+    style?: React.CSSProperties;
+    /** Children content */
+    children?: React.ReactNode;
+}
+/**
+ * EditorialSection Component (Canonical Layout Primitive)
+ *
+ * Semantic wrapper for editorial content sections:
+ * - Emits data-toc-title and data-toc-number for automated discovery by useAutoTableOfContents
+ * - Enforces zero horizontal borders and spatial breathing room
+ * - Accessible aria-label integration
+ */
+export declare const EditorialSection: React.FC<EditorialSectionProps>;
+export default EditorialSection;

package/dist/components/layout/EditorialSidebar.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { NavItem } from '../../types/navigation';
+export interface EditorialSidebarProps {
+    /** Optional section heading (defaults to "Contents") */
+    title?: string;
+    /** Navigation anchor items */
+    items?: NavItem[];
+    /** Controlled active item ID (if not provided, automatically computed via useScrollspy) */
+    activeId?: string;
+    /** Accent color for the active indicator bar (defaults to var(--folio-primary)) */
+    accentColor?: string;
+    /** Callback fired when an item is selected */
+    onItemClick?: (item: NavItem) => void;
+    /** Optional CSS class name override */
+    className?: string;
+    /** Breadcrumb properties for sticky sidebar integration */
+    nodeNumber?: number;
+    nodeTitle?: string;
+    onBack?: () => void;
+}
+/**
+ * EditorialSidebar Component (Canonical Layout Primitive)
+ *
+ * Reusable side rail navigation for long-form editorial views:
+ * - Sticky position pinned below the AppHeader capsule
+ * - Outermost last branch breadcrumb on top of the sidebar in sticky mode
+ * - Automatic document-order reading-line scrollspy tracking
+ * - Smooth scroll with top navigation offset calculation
+ * - Active state indicator using calm surface tint (zero outline/left highlight)
+ * - Collapses automatically on mobile (< 1024px)
+ * - Universal Zero Outline Policy compliant
+ */
+export declare const EditorialSidebar: React.FC<EditorialSidebarProps>;
+export default EditorialSidebar;

package/dist/components/layout/HeroSection.d.ts

@@ -0,0 +1,2 @@
+export { HeroWelcome as HeroSection, type HeroWelcomeProps as HeroSectionProps } from './HeroWelcome';
+export * from './HeroWelcome';

package/dist/components/layout/HeroWelcome.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+export interface HeroWelcomeProps {
+    kickerText?: React.ReactNode;
+    title?: React.ReactNode;
+    subtitle?: React.ReactNode;
+    onStartJourney?: () => void;
+    heroCtaRef?: React.RefObject<HTMLDivElement | null>;
+    heroSlotRef?: React.RefObject<HTMLDivElement | null>;
+}
+export declare const HeroWelcome: React.FC<HeroWelcomeProps>;
+export default HeroWelcome;

package/dist/components/layout/SearchField.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+export interface SearchFieldProps {
+    placeholder?: string;
+    mobilePlaceholder?: string;
+    onSearch?: (query: string) => void;
+    className?: string;
+}
+export declare const SearchField: React.FC<SearchFieldProps>;
+export default SearchField;

package/dist/components/layout/StatusPill.d.ts

@@ -0,0 +1,2 @@
+export * from '../ui/StatusPill';
+export { default } from '../ui/StatusPill';

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

@@ -0,0 +1,8 @@
+export * from './AppHeader';
+export * from './AppFooter';
+export * from './HeroWelcome';
+export * from './SearchField';
+export * from './EditorialSection';
+export * from './EditorialSidebar';
+export * from './StatusPill';
+export { HeroWelcome as HeroSection, type HeroWelcomeProps as HeroSectionProps } from './HeroWelcome';

package/dist/components/roadmap/RoadmapNode.d.ts

@@ -0,0 +1,30 @@
+import React from "react";
+import type { NodeItem } from "../../types/node";
+export declare const PHOTO_STACKED_BREAKPOINT = 1024;
+export interface RoadmapNodeProps {
+    page: NodeItem;
+    x: number;
+    y: number;
+    trackWidth?: number;
+    flank: "left" | "right" | "center";
+    isActive: boolean;
+    isSelected?: boolean;
+    isConnected?: boolean;
+    onExplore: (pageId: string) => void;
+    onSelectStage?: (stage: number) => void;
+}
+/**
+ * RoadmapNode Component (Phase 4 Subtask 4.2.3)
+ *
+ * Implements Direct Canvas Milestone Stations (Tactile Gateway Nodes):
+ * - Anti-AI-Slop Direct Canvas Editorial Typesetting: Zero rectangular card boxes
+ * - 72px Tactile Portal Ring: Physical milestone anchor with seal color
+ * - Benchmark Monospace Badge: JetBrains Mono tracking
+ * - Layperson Display Title: Plus Jakarta Sans 800 weight with tight tracking
+ * - Source-Bound Community Story Hook: Single-Sentence authentic narrative
+ * - Refined Editorial Action Link: Hairline underline accent with smooth navigation
+ * - Real-time Line Connection Highlighting: Seamless synchronization with serpentine ink
+ * - Universal Zero Outline Policy: outline: none across all states
+ * - ACTIVE, SELECTED Mode: Solid jewel fill highlighting with crisp white numeral text
+ */
+export declare const RoadmapNode: React.NamedExoticComponent<RoadmapNodeProps>;

package/dist/components/roadmap/RoadmapSection.d.ts

@@ -0,0 +1,27 @@
+import React from "react";
+import { type RoadmapScrollZone } from "./use-roadmap-scroll";
+import type { NodeItem } from "../../types/node";
+import type { SerpentineGeneratorOptions } from "./serpentine-generator";
+export type { RoadmapScrollZone };
+export interface RoadmapSectionHandle {
+    scrollToStage: (stage: number, onComplete?: () => void) => void;
+    nextStage: (onComplete?: () => void) => void;
+    prevStage?: (onComplete?: () => void) => void;
+}
+export interface RoadmapSectionProps {
+    nodes?: NodeItem[];
+    options?: SerpentineGeneratorOptions;
+    onStageChange?: (activeStage: number, scrollZone: RoadmapScrollZone) => void;
+    onExploreNode?: (nodeId: string) => void;
+    /** Backwards compatibility alias */
+    onExplorePage?: (pageId: string) => void;
+}
+/**
+ * RoadmapSection Component (Phase 4 Subtask 4.2.1b: Discrete Step Roadmap Engine)
+ *
+ * Viewport stage coordination for the winding progression roadmap:
+ * - Direct milestone coordinate navigation via scrollToStage, nextStage, prevStage
+ * - Dynamic serpentine track and stepping stones rendering for arbitrary N nodes
+ * - Centralized keyboard and gesture locking handled via useDiscreteStepNavigation
+ */
+export declare const RoadmapSection: React.ForwardRefExoticComponent<RoadmapSectionProps & React.RefAttributes<RoadmapSectionHandle>>;

package/dist/components/roadmap/RoadmapTrack.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+import { type SerpentineGeneratorOptions } from "./serpentine-generator";
+import type { NodeItem } from "../../types/node";
+export interface RoadmapTrackProps {
+    nodes?: NodeItem[];
+    activeStage: number;
+    subscribeProgress: (callback: (progress: number) => void) => () => void;
+    className?: string;
+    onNodeClick?: (stage: number) => void;
+    onExplore?: (pageId: string) => void;
+    options?: SerpentineGeneratorOptions;
+}
+/**
+ * RoadmapTrack Component (Phase 4 Subtask 4.2.1a: Natural Flow Engine)
+ *
+ * Implements a natural document flow serpentine track:
+ * - 1:1 Scale-locked vector canvas in natural page flow (zero sticky lock, zero cameraWrapper)
+ * - Layer 1: Foundation Ribbon (wide structural roadbed)
+ * - Layer 2: Institutional Spine (tactile dashed center line)
+ * - Layer 2.5: Golden Glow Aura (Sunburst Gold radiance)
+ * - Layer 3: Dynamic Active Ink (Primary)
+ * - Zero React re-renders during active scrolling (direct DOM mutation on stroke offsets and node data-connected)
+ * - Parameterized to render dynamic node counts N >= 1 without layout shifts or NaN
+ */
+export declare const RoadmapTrack: React.NamedExoticComponent<RoadmapTrackProps>;

package/dist/components/roadmap/serpentine-generator.d.ts

@@ -0,0 +1,60 @@
+/**
+ * serpentine-generator.ts
+ * Real-time mathematical generator for responsive serpentine progression track.
+ *
+ * Computes smooth S-curves and exact milestone coordinates dynamically
+ * based on viewport dimensions. Guaranteed 100% synchronized camera glide
+ * and precision ink touch at all screen sizes.
+ *
+ * Parameterized to support arbitrary sequence length N >= 1.
+ */
+export interface GeneratedNodePoint {
+    stage: number;
+    id: string;
+    x: number;
+    y: number;
+    threshold: number;
+    accentColorVar: string;
+    label: string;
+    flank: "left" | "right" | "center";
+}
+export interface GeneratedRoadmap {
+    pathData: string;
+    totalLength: number;
+    cumLengths: number[];
+    points: GeneratedNodePoint[];
+    totalHeight: number;
+    y0: number;
+    travelY: number;
+}
+export interface SerpentineNodeConfig {
+    stage?: number;
+    id?: string;
+    threshold?: number;
+    accentColorVar?: string;
+    label?: string;
+}
+export interface SerpentineGeneratorOptions {
+    /** Lateral edge padding ratio (default: 0.06 = 6% of container width) */
+    paddingRatio?: number;
+    /** Minimum lateral padding in pixels (default: 48px to prevent node radius clipping) */
+    minPadding?: number;
+    /** Maximum lateral padding in pixels (default: 80px for expansive desktop layout) */
+    maxPadding?: number;
+    /** Corner fillet radius for boxy architectural conduit (default: 36px) */
+    cornerFilletRadius?: number;
+    /** Track style: "conduit" (boxy rounded architectural) | "curved" (classic S-curve) (default: "conduit") */
+    trackStyle?: "conduit" | "curved";
+    /** Number of sequence milestone nodes (default: 5 or nodes.length) */
+    nodeCount?: number;
+    /** Custom node configurations */
+    nodes?: SerpentineNodeConfig[];
+}
+/**
+ * Generates the complete serpentine roadmap layout for any viewport width, height, and sequence length N >= 1
+ */
+export declare function generateSerpentineRoadmap(width: number, viewportHeight: number, options?: SerpentineGeneratorOptions): GeneratedRoadmap;
+/**
+ * Interpolates drawn ink length from normalized scroll progress [0, 1] across N segments
+ */
+export declare function progressToDrawnLength(progress: number, cumLengths: number[]): number;

package/dist/components/roadmap/use-roadmap-scroll.d.ts

@@ -0,0 +1,19 @@
+export type RoadmapScrollZone = 'above' | 'inside' | 'below';
+export interface RoadmapScrollState {
+    progressRef: React.RefObject<number>;
+    activeStage: number;
+    scrollZone: RoadmapScrollZone;
+    isEngineActive: boolean;
+    scrollToStage: (stage: number, onComplete?: () => void) => void;
+    subscribeProgress: (callback: (progress: number) => void) => () => void;
+}
+/**
+ * useRoadmapScroll (Subtask 4.2.1a: Natural Document Flow Engine)
+ *
+ * Replaces locked 500vh viewport camera with a clean, high-performance
+ * natural scroll observer. Progress is calculated relative to the user's
+ * eye-level reading focal line intersecting the milestone nodes.
+ *
+ * Direct DOM subscribers receive 60/120fps progress updates without React re-renders.
+ */
+export declare const useRoadmapScroll: (containerRef: React.RefObject<HTMLElement | null>) => RoadmapScrollState;

package/dist/components/source/EditPhotoModal.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { SourceItem } from '../../types/node';
+export interface EditPhotoModalProps {
+    isOpen: boolean;
+    item?: SourceItem | null;
+    photoItem?: SourceItem | null;
+    onClose: () => void;
+    onSave: (photoId: string, newTitle: string, newDate?: string, newCaption?: string) => Promise<void> | void;
+}
+/**
+ * EditPhotoModal Component
+ *
+ * Editorial modal for coordinator in Developer Mode to edit the narrative
+ * title/caption of synced Google Drive MOV source photos.
+ *
+ * Requirements:
+ * - Consumes canonical Modal component
+ * - Checks useDeveloperMode and auto-closes if Developer Mode is deactivated
+ * - Enforces Universal Zero Outline Policy across all inputs and buttons
+ * - Emits onSave with photoId and cleaned title
+ */
+export declare const EditPhotoModal: React.FC<EditPhotoModalProps>;

package/dist/components/source/LightboxPhotoStrip.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { SourceItem } from '../../types/node';
+export interface LightboxPhotoStripProps {
+    items: SourceItem[];
+    currentIndex: number;
+    accentColor?: string;
+    onNavigate: (newIndex: number) => void;
+}
+/**
+ * LightboxPhotoStrip Component
+ *
+ * Renders a bottom thumbnail ribbon inside SourceLightbox allowing users to preview
+ * all available photographs in the collection, jump directly to any photograph, and
+ * maintain smooth scroll tracking with the active slide.
+ *
+ * Design Standards Enforced:
+ * - Editorial Restraint: Auto-hides when items.length <= 1 (single photo)
+ * - Universal Zero Outline Policy: outline: none across all states
+ * - Fluid Centering & Auto-Scroll: Active thumbnail smoothly centered on slide change
+ * - Full Screen Reader Accessibility: role="tablist" / role="tab" with descriptive labels
+ */
+export declare const LightboxPhotoStrip: React.FC<LightboxPhotoStripProps>;
+export default LightboxPhotoStrip;

package/dist/components/source/LinkFolderModal.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+export interface LinkFolderModalProps {
+    isOpen: boolean;
+    pointId: string;
+    initialTitle?: string;
+    initialUrl?: string;
+    onClose: () => void;
+    onSuccess?: (updatedUrl: string, updatedTitle: string) => void;
+}
+/**
+ * LinkFolderModal Component
+ * Folio Engine — Subtask 5.4: Link Folder Modal & URL Validation Pipeline
+ *
+ * Quiet, restrained editorial dialog for coordinator to connect official Google Drive
+ * Means of Verification (MOV) folders:
+ * 1. Consumes canonical Modal: Reuses viewport portal, scroll locks, and keyboard handling.
+ * 2. Automated Save Verification Gate: Verifies folder existence & public access on Save.
+ * 3. Developer Mode Exit: Auto-closes immediately if developer mode is exited.
+ * 4. Editorial Restraint: Zero ornamental clutter, no meta-narrative, calm color contrast.
+ * 5. Preflight "Test Link": Clean anchor to inspect the folder before saving.
+ * 6. Universal Zero Outline Policy: Strict outline: none across all states.
+ */
+export declare const LinkFolderModal: React.FC<LinkFolderModalProps>;
+export default LinkFolderModal;

package/dist/components/source/SourceCard.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { SourceItem } from '../../types/node';
+export interface SourceCardProps {
+    item: SourceItem;
+    accentColor?: string;
+    onClick?: (item: SourceItem) => void;
+    onEditTitle?: (item: SourceItem) => void;
+    onEditPhoto?: (item: SourceItem) => void;
+    disabled?: boolean;
+    className?: string;
+    overlayCount?: number;
+    aspectRatio?: 'landscape' | 'square' | 'auto';
+    hideCaption?: boolean;
+}
+/**
+ * SourceCard Component
+ *
+ * Canonical Means of Verification (MOV) Photo Presentation:
+ * - Standalone photo card with curved edges
+ * - Sourced from official Google Drive repository
+ * - Detached editorial caption below the photo (not encased inside the curved edges)
+ * - Uniform Administrative Edit Button Standard (strictly '✎ Edit' in Developer Mode)
+ * - Restrained typography: photo caption size
+ * - 4-State interactive matrix: Default, Hover, Active/Pressed, Focus-Visible, Disabled
+ * - Vercel React Best Practices: lazy loading, async decoding, CLS prevention
+ * - Universal Zero Outline Policy & zero horizontal divider lines
+ * - Optional frosted-glass darkened overlay for collage overflow (+N remaining)
+ * - Optional hideCaption to strip filenames/captions and render flush in collage
+ */
+export declare const SourceCard: React.FC<SourceCardProps>;
+export default SourceCard;

package/dist/components/source/SourceFolderAttachment.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+export interface SourceFolderAttachmentProps {
+    /** Canonical point or node identifier (e.g. 'access', 'milestone-1') */
+    pointId: string;
+    /** Custom label override (defaults to live folderTitle or 'Official Google Drive Folder') */
+    label?: string;
+    /** Visual presentation variant */
+    variant?: 'compact' | 'editorial';
+    /** Accent color token or hex for seal tinting */
+    accentColor?: string;
+    /** Optional container class name */
+    className?: string;
+}
+/**
+ * SourceFolderAttachment Component
+ * Folio Engine — Subtask 5.3: Contextual Point Anchor & Integration
+ *
+ * Canonical, accessible Means of Verification (MOV) anchor component:
+ * - Direct 1-tap jump to official Google Drive archives supporting accreditation.
+ * - Public State: Calm, editorial badge opening in a new window with strict security.
+ * - Developer Mode: Discrete uniform '✎ Edit' button for inline folder reassignment.
+ * - Universal Zero Outline Policy: Strict enforcement of outline: none across all states.
+ * - Responsive Adaptability: Compact (pill) and Editorial (card callout) variants.
+ */
+export declare const SourceFolderAttachment: React.FC<SourceFolderAttachmentProps>;

package/dist/components/source/SourceGallery.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { SourceItem } from '../../types/node';
+export interface SourceGalleryProps {
+    nodeId: string;
+    sourceItems: SourceItem[];
+    accentColor?: string;
+    className?: string;
+    editTriggerId?: string;
+}
+/**
+ * SourceGallery Component
+ * Task 4.5.5 / Task 5.3 / Task 6.3: Dynamic Evidence Gallery Integration & Coexistence Switch
+ *
+ * Primary visual showcase of Means of Verification (MOV) on the dedicated Node page:
+ * - Deterministic 5-State Coexistence Switch: Retains curated baseline photos during never_synced
+ *   and sync_error; seamlessly renders live Google Drive photos when synced_success.
+ * - Confirmed Empty State Differentiation: Displays interactive EmptyState with direct
+ *   Google Drive upload CTA when Drive explicitly returns 200 OK with 0 images (synced_empty).
+ * - Elevated Folder Header Presentation: Authentic folder title without generic 'Source' pill.
+ * - Developer Mode '↻ Sync Photos' Affordance: Manual tactile reconciliation trigger with Toast.
+ * - Responsive adaptive card grid (1 col mobile, 2 col tablet/desktop).
+ * - Full-screen photo inspection via SourceLightbox orchestration.
+ * - Universal Zero Outline Policy & zero horizontal dividing lines.
+ */
+export declare const SourceGallery: React.FC<SourceGalleryProps>;
+export default SourceGallery;

package/dist/components/source/SourceImage.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+export interface SourceImageProps {
+    src?: string;
+    fallbackSrc?: string;
+    srcSet?: string;
+    sizes?: string;
+    alt?: string;
+    className?: string;
+    imageClassName?: string;
+    aspectRatio?: string;
+    objectFit?: 'cover' | 'contain';
+    showRetry?: boolean;
+    loading?: 'lazy' | 'eager';
+    decoding?: 'async' | 'sync' | 'auto';
+    onLoad?: () => void;
+    onError?: () => void;
+}
+/**
+ * SourceImage Component
+ *
+ * Fault-tolerant image wrapper with shimmer skeleton placeholders,
+ * GPU-accelerated opacity decoding transition, and graceful retry error boundaries.
+ * Default performance optimization: loading="lazy", decoding="async", responsive srcSet/sizes.
+ */
+export declare const SourceImage: React.FC<SourceImageProps>;
+export default SourceImage;

package/dist/components/source/SourceLightbox.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import type { SourceItem } from '../../types/node';
+export interface SourceLightboxProps {
+    isOpen: boolean;
+    items: SourceItem[];
+    currentIndex: number;
+    driveFolderUrl?: string;
+    accentColor?: string;
+    onClose: () => void;
+    onNavigate: (newIndex: number) => void;
+    onEditSource?: () => void;
+    onEditPhoto?: (item: SourceItem) => void;
+}
+/**
+ * SourceLightbox Component
+ *
+ * Canonical Means of Verification (MOV) Photo Lightbox Modal:
+ * - Browser & hardware Back button synchronization (returns to source page scroll position)
+ * - Native mobile gallery conventions: touch swipe left/right, pull-down dismiss
+ * - Double-click / double-tap zoom toggle (1.5x)
+ * - Single click chrome toggle for distraction-free inspection
+ * - Intrinsic aspect ratio preservation (object-fit: contain)
+ * - Scrollbar-compensated body scroll lock
+ * - ARIA live region announcing photo changes for screen readers
+ * - Universal Zero Outline Policy across all interactive states
+ */
+export declare const SourceLightbox: React.FC<SourceLightboxProps>;
+export default SourceLightbox;

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

@@ -0,0 +1,9 @@
+export { SourceCard, type SourceCardProps } from './SourceCard';
+export { SourceImage, type SourceImageProps } from './SourceImage';
+export { SourceLightbox, type SourceLightboxProps } from './SourceLightbox';
+export { LightboxPhotoStrip, type LightboxPhotoStripProps } from './LightboxPhotoStrip';
+export { SourceGallery, type SourceGalleryProps } from './SourceGallery';
+export { SourceFolderAttachment, type SourceFolderAttachmentProps } from './SourceFolderAttachment';
+export { LinkFolderModal, type LinkFolderModalProps } from './LinkFolderModal';
+export { EditPhotoModal, type EditPhotoModalProps } from './EditPhotoModal';
+export { default } from './SourceGallery';

package/dist/components/ui/AccordionSection.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+export interface AccordionSectionProps {
+    id?: string;
+    name?: string;
+    title: string;
+    defaultOpen?: boolean;
+    isOpen?: boolean;
+    onToggle?: (open: boolean) => void;
+    badge?: React.ReactNode;
+    caption?: string;
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * AccordionSection Component
+ * Canonical UI primitive for collapsible drawer sections with indented subordinate controls.
+ * Supports exclusive single-open groups via the `name` prop.
+ * Strictly adheres to tokens.css, Universal Zero Outline Policy, and Ban on Dividing Lines.
+ */
+export declare const AccordionSection: React.FC<AccordionSectionProps>;
+export default AccordionSection;