react-reason-editor-sidebar 0.1.0

package/dist/Sidebar.d.ts

@@ -0,0 +1,2 @@
+import type { SidebarProps } from './layout/sidebar/types';
+export declare const Sidebar: ({ documents, activeId, activeDocument, onSelect, onAdd, onDelete, onDuplicate, onSetExpandedFolders, onMove, onManageTags, onRename, onSearchFocus, isOpen, onOpenChange, isMobile, leftPanels, onLeftPanelsChange, rightPanels, onRightPanelsChange, onSettingsClick, onRestore, newDocumentId, showDynamicIsland, onToggleDynamicIsland, activeFileSourceId, onFileSourceChange, headings, onNavigate, editorRef, openTabs, activeTab, onTabChange, onTabClose, onTabsClose, onTabRename, onSplitRight, onReopenLastClosed, canReopenLastClosed, aiProps, tipsProps, topicsProps, tabItems, onNewChat, }: SidebarProps) => import("react").JSX.Element;

package/dist/SidebarContent.d.ts

@@ -0,0 +1,7 @@
+import type { SidebarContentProps } from './layout/sidebar/types';
+import './split-pane.css';
+/**
+ * Renders the enabled panels for one side of the layout, stacked in a
+ * resizable vertical split when more than one panel is active.
+ */
+export declare const SidebarContent: ({ panels, persistenceKey, activeDocuments, activeId, activeDocument, headings, isMobile, onSelect, onAdd, onDelete, onDuplicate, onMove, onManageTags, onRename, onOpenChange, treeRef, onExpandStateChange, onSetExpandedFolders, outlineRef, editorRef, openTabs, activeTab, onTabChange, onTabClose, onTabsClose, onTabRename, onSplitRight, onReopenLastClosed, canReopenLastClosed, onNavigate, aiProps, tipsProps, topicsProps, tabItems, onNewChat, onFileManagerOpen, deletedDocs, onRestore, }: SidebarContentProps) => import("react").JSX.Element;

package/dist/SidebarFooter.d.ts

@@ -0,0 +1,37 @@
+import type { Document } from './documents/DocumentTree';
+import type { SidebarPanelType } from './layout/sidebar/types';
+/** Props for the {@link SidebarFooter} component. */
+interface SidebarFooterProps {
+    /** Panels currently visible in the left sidebar. */
+    leftPanels: SidebarPanelType[];
+    /** Changes which panels are visible in the left sidebar. */
+    onLeftPanelsChange: (panels: SidebarPanelType[]) => void;
+    /** Panels currently visible in the right sidebar. */
+    rightPanels: SidebarPanelType[];
+    /** Changes which panels are visible in the right sidebar. */
+    onRightPanelsChange: (panels: SidebarPanelType[]) => void;
+    /** Suppresses the settings button when `true` (mobile layout). */
+    isMobile?: boolean;
+    /** Soft-deleted documents shown in the trash dropdown. */
+    deletedDocs: Document[];
+    /** Restores a soft-deleted document by ID. */
+    onRestore?: (id: string) => void;
+    /** Opens the settings dialog, optionally navigating to a specific section. */
+    onSettingsClick?: (section?: string) => void;
+    /** Logged-in user info, or null/undefined when not authenticated. */
+    user?: {
+        name?: string;
+        email?: string;
+    } | null;
+    /** Called when the user clicks "Login". */
+    onLogin?: () => void;
+    /** Called when the user clicks "Sign Out". */
+    onSignOut?: () => void;
+}
+/**
+ * Compact icon row pinned to the bottom of the sidebar. Includes a trash
+ * dropdown (restore deleted docs), settings button, and a panel view
+ * dropdown.
+ */
+export declare const SidebarFooter: ({ leftPanels, onLeftPanelsChange, rightPanels, onRightPanelsChange, isMobile, deletedDocs, onRestore, onSettingsClick, user, onLogin, onSignOut, }: SidebarFooterProps) => import("react").JSX.Element;
+export {};

package/dist/SidebarToolbar.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @module SidebarToolbar
+ * @description Compact icon toolbar rendered at the top of the sidebar. Shows
+ * context-sensitive controls based on `leftPanels`: file-source switcher, search,
+ * and expand/collapse buttons. The file-tree actions (new file/folder, trash,
+ * file manager) render here only when the "Files" panel — which hosts them in
+ * its own header — is hidden.
+ */
+import { RefObject } from 'react';
+import type { AnyFileSource } from './app-types/fileSource';
+import type { DocumentTreeHandle } from './file-tree/filetree';
+import type { OutlineViewHandle } from './search/OutlineView';
+import type { SidebarPanelType, OpenTabItem } from './layout/sidebar/types';
+import type { Document } from './documents/DocumentTree';
+/** Props for the {@link SidebarToolbar} component. */
+interface SidebarToolbarProps {
+    /** Panels currently visible in the left sidebar — controls which toolbar buttons are shown. */
+    leftPanels: SidebarPanelType[];
+    /** Changes which panels are visible in the left sidebar. */
+    onLeftPanelsChange: (panels: SidebarPanelType[]) => void;
+    /** Panels currently visible in the right sidebar. */
+    rightPanels: SidebarPanelType[];
+    /** Changes which panels are visible in the right sidebar. */
+    onRightPanelsChange: (panels: SidebarPanelType[]) => void;
+    /** ID of the currently selected document (used when creating a new sibling). */
+    activeId: string | null;
+    /** Creates a new note (`isFolder=false`) or folder (`isFolder=true`) under `parentId`. */
+    onAdd: (parentId: string | null, isFolder?: boolean) => void;
+    /** Focuses the sidebar search input. */
+    onSearchFocus: () => void;
+    /** Opens the file manager modal. */
+    onFileManagerOpen: () => void;
+    /** Available file source configurations. */
+    sources: AnyFileSource[];
+    /** The currently active file source object, or `null` if none selected. */
+    activeSource: AnyFileSource | null;
+    /** ID of the currently active file source. */
+    activeFileSourceId: string;
+    /** Called when the user selects a different file source from the dropdown. */
+    onFileSourceChange?: (sourceId: string) => void;
+    /** Selects a source by ID and updates the active source state. */
+    onSourceSelect: (sourceId: string) => void;
+    /** Whether all tree nodes are currently expanded (drives the toggle icon). */
+    allExpanded: boolean;
+    /** Tooltip label describing what the expand-all toggle will do next (cycles by folder level). */
+    expandToggleLabel: string;
+    /** Whether all outline entries are currently expanded. */
+    outlineExpanded: boolean;
+    /** Steps the tree to its next expansion level (wraps to fully collapsed). */
+    onToggleAllExpanded: () => void;
+    /** Toggles expand/collapse of all outline entries. */
+    onToggleOutlineExpanded: () => void;
+    /** Ref forwarded to the `FileTree` for imperative operations. */
+    treeRef: RefObject<DocumentTreeHandle | null>;
+    /** Ref forwarded to the `OutlineView` for imperative operations. */
+    outlineRef: RefObject<OutlineViewHandle | null>;
+    /** Soft-deleted documents shown in the trash dropdown. */
+    deletedDocs?: Document[];
+    /** Restores a soft-deleted document by ID. */
+    onRestore?: (id: string) => void;
+    /** Whether the floating reading-progress island is currently visible. */
+    showDynamicIsland?: boolean;
+    /** Toggles the floating reading-progress island. */
+    onToggleDynamicIsland?: () => void;
+    /** Opens the settings dialog, optionally navigating to a specific section. */
+    onSettingsClick?: (section?: string) => void;
+    /** Suppresses the settings button when `true` (mobile layout). */
+    isMobile?: boolean;
+    /** All currently open tab IDs. */
+    openTabs?: string[];
+    /** ID of the currently active tab. */
+    activeTab?: string | null;
+    /** Switches to a tab by ID. */
+    onTabChange?: (id: string) => void;
+    /** Closes a tab by ID. */
+    onTabClose?: (id: string) => void;
+    /** All documents (used for tab title lookup). */
+    documents?: Document[];
+    /** Unified tab list (files + chats). Overrides file-only tab derivation when set. */
+    tabItems?: OpenTabItem[];
+}
+/**
+ * Sidebar toolbar strip. Renders different button sets based on which
+ * panels are active in `leftPanels`: the files/open-tabs panel shows
+ * file-source, search, file-manager, new-file/folder, and collapse-all
+ * buttons; the outline panel additionally shows an expand/collapse toggle.
+ */
+export declare const SidebarToolbar: ({ leftPanels, onLeftPanelsChange, rightPanels, onRightPanelsChange, activeId, onAdd, onSearchFocus, onFileManagerOpen, sources, activeSource, activeFileSourceId, onFileSourceChange, onSourceSelect, allExpanded, expandToggleLabel, outlineExpanded, onToggleAllExpanded, onToggleOutlineExpanded, treeRef, outlineRef, deletedDocs, onRestore, showDynamicIsland, onToggleDynamicIsland, onSettingsClick, isMobile, openTabs, activeTab, onTabChange, onTabClose, documents, tabItems, }: SidebarToolbarProps) => import("react").JSX.Element;
+export {};

package/dist/SidebarViewMenu.d.ts

@@ -0,0 +1,20 @@
+import type { SidebarPanelType } from './layout/sidebar/types';
+/** Props for the {@link SidebarViewMenu} component. */
+interface SidebarViewMenuProps {
+    leftPanels: SidebarPanelType[];
+    onLeftPanelsChange: (panels: SidebarPanelType[]) => void;
+    rightPanels: SidebarPanelType[];
+    onRightPanelsChange: (panels: SidebarPanelType[]) => void;
+    /** Whether the floating reading-progress island is currently visible. */
+    showDynamicIsland?: boolean;
+    /** Toggles the floating reading-progress island. */
+    onToggleDynamicIsland?: () => void;
+    /** Classes applied to the trigger button (callers use different sizing). */
+    triggerClassName?: string;
+    /** Tooltip placement for the trigger button. */
+    tooltipSide?: 'top' | 'bottom';
+    /** Menu content alignment relative to the trigger. */
+    align?: 'start' | 'end';
+}
+export declare const SidebarViewMenu: ({ leftPanels, onLeftPanelsChange, rightPanels, onRightPanelsChange, showDynamicIsland, onToggleDynamicIsland, triggerClassName, tooltipSide, align, }: SidebarViewMenuProps) => import("react").JSX.Element;
+export {};

package/dist/app-types/fileSource.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @module app-types/fileSource
+ * @description TypeScript types for all supported file-source providers:
+ * SSH, S3, R2, B2, Google Docs, Turso DB, and the AnyFileSource union.
+ */
+export type FileSourceType = 'local' | 'ssh' | 's3' | 'r2' | 'b2' | 'gdocs' | 'turso';
+export interface SSHCredentials {
+    /** SSH host name or IP address. */
+    host: string;
+    /** SSH port used for connection. */
+    port: number;
+    /** SSH user account name. */
+    username: string;
+    /** Optional password for password-based auth. */
+    password?: string;
+    /** Optional private key contents for key-based auth. */
+    privateKey?: string;
+    /** Optional passphrase for the private key. */
+    passphrase?: string;
+    /** Optional base path used as the root directory. */
+    basePath?: string;
+}
+export interface S3Credentials {
+    /** AWS access key ID or S3-compatible key ID. */
+    accessKeyId: string;
+    /** AWS secret access key or S3-compatible secret. */
+    secretAccessKey: string;
+    /** Region where the bucket is hosted. */
+    region: string;
+    /** Bucket name to read/write files from. */
+    bucket: string;
+    /** Optional custom endpoint for S3-compatible providers. */
+    endpoint?: string;
+    /** Optional base path prefix inside the bucket. */
+    basePath?: string;
+}
+export interface R2Credentials {
+    /** Cloudflare account ID owning the R2 bucket. */
+    accountId: string;
+    /** R2 access key ID. */
+    accessKeyId: string;
+    /** R2 secret access key. */
+    secretAccessKey: string;
+    /** R2 bucket name. */
+    bucket: string;
+    /** Optional path prefix inside the bucket. */
+    basePath?: string;
+}
+export interface B2Credentials {
+    /** Backblaze access key ID. */
+    accessKeyId: string;
+    /** Backblaze secret access key. */
+    secretAccessKey: string;
+    /** Backblaze B2 bucket name. */
+    bucket: string;
+    endpoint?: string;
+    /** Optional path prefix inside the bucket. */
+    basePath?: string;
+}
+export interface GoogleDocsCredentials {
+    /** OAuth access token for Google API requests. */
+    accessToken?: string;
+    /** OAuth refresh token to renew expired access tokens. */
+    refreshToken?: string;
+    /** Connected Google account email. */
+    email?: string;
+    folderIds?: string[];
+    /** Indicates whether the Google connection is active. */
+    isAuthenticated: boolean;
+}
+export interface TursoDBCredentials {
+    /** Turso database endpoint URL. */
+    endpoint: string;
+    /** Optional Turso auth token for protected instances. */
+    authToken?: string;
+    /** Optional database name when endpoint hosts multiple DBs. */
+    database?: string;
+    enableGoogleDocsSync?: boolean;
+}
+export interface FileSource {
+    /** Unique source identifier. */
+    id: string;
+    /** Human-readable source label shown in UI. */
+    name: string;
+    /** Source backend type discriminator. */
+    type: FileSourceType;
+    /** Backend-specific connection credentials. */
+    credentials?: SSHCredentials | S3Credentials | R2Credentials | B2Credentials | GoogleDocsCredentials | TursoDBCredentials;
+    /** Marks this source as the default selection. */
+    isDefault?: boolean;
+    /** ISO timestamp when the source was created. */
+    createdAt: string;
+    /** ISO timestamp when the source was last updated. */
+    updatedAt: string;
+}
+export interface LocalFileSource extends FileSource {
+    type: 'local';
+    credentials: undefined;
+}
+export interface SSHFileSource extends FileSource {
+    type: 'ssh';
+    credentials: SSHCredentials;
+}
+export interface S3FileSource extends FileSource {
+    type: 's3';
+    credentials: S3Credentials;
+}
+export interface R2FileSource extends FileSource {
+    type: 'r2';
+    credentials: R2Credentials;
+}
+export interface B2FileSource extends FileSource {
+    type: 'b2';
+    credentials: B2Credentials;
+}
+export interface GoogleDocsFileSource extends FileSource {
+    type: 'gdocs';
+    credentials: GoogleDocsCredentials;
+}
+export interface TursoDBFileSource extends FileSource {
+    type: 'turso';
+    credentials: TursoDBCredentials;
+}
+export type AnyFileSource = LocalFileSource | SSHFileSource | S3FileSource | R2FileSource | B2FileSource | GoogleDocsFileSource | TursoDBFileSource;

package/dist/app-types/toc.d.ts

@@ -0,0 +1,2 @@
+/** Table of contents entry: [id, text, headingTag] where id is "{level}:{index}:{text}" and headingTag is "h1"–"h6" */
+export type TocEntry = [string, string, string];

package/dist/app-ui/FileTypeIcon.d.ts

@@ -0,0 +1,11 @@
+declare const SIZES: {
+    readonly sm: 14;
+    readonly md: 18;
+    readonly lg: 24;
+};
+interface FileTypeIconProps {
+    filename: string;
+    size?: keyof typeof SIZES | number;
+}
+export declare function FileTypeIcon({ filename, size }: FileTypeIconProps): import("react").JSX.Element;
+export {};

package/dist/app-ui/alert-dialog.d.ts

@@ -0,0 +1,14 @@
+import * as React from "react";
+import * as AlertDialogPrimitive from "@radix-ui/react-alert-dialog";
+declare function AlertDialog({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Root>): React.JSX.Element;
+declare function AlertDialogTrigger({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Trigger>): React.JSX.Element;
+declare function AlertDialogPortal({ ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Portal>): React.JSX.Element;
+declare function AlertDialogOverlay({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Overlay>): React.JSX.Element;
+declare function AlertDialogContent({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Content>): React.JSX.Element;
+declare function AlertDialogHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function AlertDialogFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function AlertDialogTitle({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Title>): React.JSX.Element;
+declare function AlertDialogDescription({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Description>): React.JSX.Element;
+declare function AlertDialogAction({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Action>): React.JSX.Element;
+declare function AlertDialogCancel({ className, ...props }: React.ComponentProps<typeof AlertDialogPrimitive.Cancel>): React.JSX.Element;
+export { AlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, };

package/dist/app-ui/badge.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @module app-ui/badge
+ * @description Small status-label badge with variant styles (default, secondary, outline, destructive).
+ */
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "destructive" | "outline" | "secondary" | "new" | "beta" | "highlight" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+export { Badge, badgeVariants };

package/dist/app-ui/button.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module app-ui/button
+ * @description Versatile button with size and variant props built on Radix Slot + CVA.
+ */
+import * as React from "react";
+import { type VariantProps } from "class-variance-authority";
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "sm" | "lg" | "default" | "icon" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface ButtonProps extends React.ComponentProps<"button">, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+declare function Button({ className, variant, size, asChild, ...props }: ButtonProps): React.JSX.Element;
+export { Button, buttonVariants };

package/dist/app-ui/context-menu.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @module app-ui/context-menu
+ * @description Radix UI ContextMenu primitives for right-click menus with Tailwind styling.
+ */
+import * as React from "react";
+import * as ContextMenuPrimitive from "@radix-ui/react-context-menu";
+declare const ContextMenu: React.FC<ContextMenuPrimitive.ContextMenuProps>;
+declare const ContextMenuTrigger: React.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuTriggerProps & React.RefAttributes<HTMLSpanElement>>;
+declare const ContextMenuGroup: React.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuGroupProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuPortal: React.FC<ContextMenuPrimitive.ContextMenuPortalProps>;
+declare const ContextMenuSub: React.FC<ContextMenuPrimitive.ContextMenuSubProps>;
+declare const ContextMenuRadioGroup: React.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuSubTrigger: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSubTriggerProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    inset?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuSubContent: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSubContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuContent: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuItem: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    inset?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuCheckboxItem: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuRadioItem: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuRadioItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuLabel: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    inset?: boolean;
+} & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuSeparator: React.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuShortcut: ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>) => React.JSX.Element;
+export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuCheckboxItem, ContextMenuRadioItem, ContextMenuLabel, ContextMenuSeparator, ContextMenuShortcut, ContextMenuGroup, ContextMenuPortal, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuRadioGroup, };

package/dist/app-ui/dialog.d.ts

@@ -0,0 +1,15 @@
+import * as React from "react";
+import * as DialogPrimitive from "@radix-ui/react-dialog";
+declare function Dialog({ ...props }: React.ComponentProps<typeof DialogPrimitive.Root>): React.JSX.Element;
+declare function DialogTrigger({ ...props }: React.ComponentProps<typeof DialogPrimitive.Trigger>): React.JSX.Element;
+declare function DialogPortal({ ...props }: React.ComponentProps<typeof DialogPrimitive.Portal>): React.JSX.Element;
+declare function DialogClose({ ...props }: React.ComponentProps<typeof DialogPrimitive.Close>): React.JSX.Element;
+declare function DialogOverlay({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Overlay>): React.JSX.Element;
+declare function DialogContent({ className, children, hideCloseButton, ...props }: React.ComponentProps<typeof DialogPrimitive.Content> & {
+    hideCloseButton?: boolean;
+}): React.JSX.Element;
+declare function DialogHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function DialogFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function DialogTitle({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Title>): React.JSX.Element;
+declare function DialogDescription({ className, ...props }: React.ComponentProps<typeof DialogPrimitive.Description>): React.JSX.Element;
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, };

package/dist/app-ui/dropdown-menu.d.ts

@@ -0,0 +1,25 @@
+import * as React from "react";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Root>): React.JSX.Element;
+declare function DropdownMenuPortal({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Portal>): React.JSX.Element;
+declare function DropdownMenuTrigger({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Trigger>): React.JSX.Element;
+declare function DropdownMenuContent({ className, sideOffset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Content>): React.JSX.Element;
+declare function DropdownMenuGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Group>): React.JSX.Element;
+declare function DropdownMenuItem({ className, inset, variant, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Item> & {
+    inset?: boolean;
+    variant?: "default" | "destructive";
+}): React.JSX.Element;
+declare function DropdownMenuCheckboxItem({ className, children, checked, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.CheckboxItem>): React.JSX.Element;
+declare function DropdownMenuRadioGroup({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioGroup>): React.JSX.Element;
+declare function DropdownMenuRadioItem({ className, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.RadioItem>): React.JSX.Element;
+declare function DropdownMenuLabel({ className, inset, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Label> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSeparator({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Separator>): React.JSX.Element;
+declare function DropdownMenuShortcut({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
+declare function DropdownMenuSub({ ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.Sub>): React.JSX.Element;
+declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubTrigger> & {
+    inset?: boolean;
+}): React.JSX.Element;
+declare function DropdownMenuSubContent({ className, ...props }: React.ComponentProps<typeof DropdownMenuPrimitive.SubContent>): React.JSX.Element;
+export { DropdownMenu, DropdownMenuPortal, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuGroup, DropdownMenuLabel, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent, };

package/dist/app-ui/input.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @module app-ui/input
+ * @description Styled single-line text input with focus ring and disabled state.
+ */
+import * as React from "react";
+declare function Input({ className, type, ...props }: React.ComponentProps<"input">): React.JSX.Element;
+export { Input };

package/dist/app-ui/sheet.d.ts

@@ -0,0 +1,13 @@
+import * as React from "react";
+import * as SheetPrimitive from "@radix-ui/react-dialog";
+declare function Sheet({ ...props }: React.ComponentProps<typeof SheetPrimitive.Root>): React.JSX.Element;
+declare function SheetTrigger({ ...props }: React.ComponentProps<typeof SheetPrimitive.Trigger>): React.JSX.Element;
+declare function SheetClose({ ...props }: React.ComponentProps<typeof SheetPrimitive.Close>): React.JSX.Element;
+declare function SheetContent({ className, children, side, ...props }: React.ComponentProps<typeof SheetPrimitive.Content> & {
+    side?: "top" | "right" | "bottom" | "left";
+}): React.JSX.Element;
+declare function SheetHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function SheetFooter({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
+declare function SheetTitle({ className, ...props }: React.ComponentProps<typeof SheetPrimitive.Title>): React.JSX.Element;
+declare function SheetDescription({ className, ...props }: React.ComponentProps<typeof SheetPrimitive.Description>): React.JSX.Element;
+export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription, };

package/dist/app-ui/tooltip.d.ts

@@ -0,0 +1,7 @@
+import * as React from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+declare function TooltipProvider({ delayDuration, ...props }: React.ComponentProps<typeof TooltipPrimitive.Provider>): React.JSX.Element;
+declare function Tooltip({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Root>): React.JSX.Element;
+declare function TooltipTrigger({ ...props }: React.ComponentProps<typeof TooltipPrimitive.Trigger>): React.JSX.Element;
+declare function TooltipContent({ className, sideOffset, children, ...props }: React.ComponentProps<typeof TooltipPrimitive.Content>): React.JSX.Element;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/app-ui/tree.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @module app-ui/tree
+ * @description Headless-tree-compatible generic tree rendering primitives.
+ */
+import type { ItemInstance } from "@headless-tree/core";
+import * as React from "react";
+interface TreeProps extends React.HTMLAttributes<HTMLDivElement> {
+    indent?: number;
+    tree?: any;
+}
+declare function Tree({ indent, tree, className, ...props }: TreeProps): React.JSX.Element;
+interface TreeItemProps<T = any> extends React.HTMLAttributes<HTMLButtonElement> {
+    item: ItemInstance<T>;
+    indent?: number;
+    asChild?: boolean;
+}
+declare function TreeItem<T = any>({ item, className, asChild, children, ...props }: Omit<TreeItemProps<T>, "indent">): React.JSX.Element;
+interface TreeItemLabelProps<T = any> extends React.HTMLAttributes<HTMLSpanElement> {
+    item?: ItemInstance<T>;
+}
+declare function TreeItemLabel<T = any>({ item: propItem, children, className, ...props }: TreeItemLabelProps<T>): React.JSX.Element | null;
+declare function TreeDragLine({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element | null;
+export { Tree, TreeItem, TreeItemLabel, TreeDragLine };

package/dist/app-utils/file-sources/sources.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @module app-utils/file-sources/sources
+ * @description CRUD helpers for AnyFileSource records stored in
+ * localStorage. Manages the active source ID and provides typed
+ * get/add/update/delete operations.
+ */
+import { AnyFileSource } from '../../app-types/fileSource';
+/**
+ * Get all file sources from localStorage
+ */
+export declare function getFileSources(): AnyFileSource[];
+/**
+ * Save file sources to localStorage
+ */
+export declare function saveFileSources(sources: AnyFileSource[]): void;
+/**
+ * Add a new file source
+ */
+export declare function addFileSource(source: Omit<AnyFileSource, 'id' | 'createdAt' | 'updatedAt'>): AnyFileSource;
+/**
+ * Update an existing file source
+ */
+export declare function updateFileSource(id: string, updates: Partial<AnyFileSource>): void;
+/**
+ * Delete a file source
+ */
+export declare function deleteFileSource(id: string): void;
+/**
+ * Get the currently active file source ID
+ */
+export declare function getActiveFileSourceId(): string;
+/**
+ * Set the active file source ID
+ */
+export declare function setActiveFileSourceId(id: string): void;
+/**
+ * Get the currently active file source
+ */
+export declare function getActiveFileSource(): AnyFileSource;
+/**
+ * Test connection to a file source (placeholder - would need backend implementation)
+ */
+export declare function testFileSourceConnection(source: AnyFileSource): Promise<boolean>;

package/dist/app-utils/utils.d.ts

@@ -0,0 +1 @@
+export declare function cn(...inputs: (string | boolean | undefined | null)[]): string;

package/dist/dialogs/FileManagerModal.d.ts

@@ -0,0 +1,11 @@
+import "@svar-ui/react-filemanager/all.css";
+import "./filemanager.css";
+import type { Document } from "../documents/DocumentTree";
+interface FileManagerModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    documents?: Document[];
+    onSelectDocument?: (docId: string) => void;
+}
+export declare function FileManagerModal({ open, onOpenChange, documents, onSelectDocument, }: FileManagerModalProps): import("react").JSX.Element;
+export {};

package/dist/dialogs/filemanager-data.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module filemanager-data
+ * @description Static seed data and type definitions for the FileManagerModal
+ * demo: sample folders, files, and breadcrumb paths.
+ */
+import type { Document } from '../documents/DocumentTree';
+export interface FileItem {
+    id: string;
+    parent?: string;
+    type: "folder" | "file";
+    date?: Date;
+    size?: number;
+}
+export declare function convertDocumentsToFileItems(documents: Document[]): FileItem[];
+export declare function getData(documents?: Document[]): FileItem[];
+/** Returns a map from file path → document ID for reverse-lookup when a file is opened. */
+export declare function getPathToDocIdMap(documents: Document[]): Map<string, string>;

package/dist/documents/DocumentTree.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Core document entity shared across the application.
+ * A document may be a regular note or a folder (when `isFolder` is `true`).
+ */
+export interface Document {
+    /** Unique string identifier, typically derived from `Date.now()`. */
+    id: string;
+    /** Human-readable title shown in the sidebar and tab bar. */
+    title: string;
+    /** Serialised HTML content of the document body. */
+    content: string;
+    /** ID of the parent document, or `null` for root-level entries. */
+    parentId: string | null;
+    /** Nested children populated by the tree-builder; not persisted directly. */
+    children?: Document[];
+    /** Whether the tree node is currently open (showing children). */
+    isExpanded?: boolean;
+    /** When `true`, the item acts as a folder container rather than a note. */
+    isFolder?: boolean;
+    /** Archived status — archived items may be hidden from the main view. */
+    isArchived?: boolean;
+    /** Soft-deleted flag — items are moved to trash before permanent deletion. */
+    isDeleted?: boolean;
+    /** List of user-defined tag strings. */
+    tags?: string[];
+    /** Sharing/visibility configuration for this document. */
+    sharing?: {
+        /** Whether the document is publicly accessible via its share link. */
+        isPublic: boolean;
+        /** Per-user sharing entries. */
+        sharedWith?: Array<{
+            /** Recipient e-mail address. */
+            email: string;
+            /** Access level granted to the recipient. */
+            role: 'viewer' | 'editor' | 'commentor';
+            /** ISO timestamp when access was granted. */
+            sharedAt: string;
+        }>;
+        /** Publicly-accessible share URL. */
+        shareLink?: string;
+        /** Linked Google Docs file identifier. */
+        googleDocId?: string;
+    };
+}
+/** Props for the {@link DocumentTree} component. */
+interface DocumentTreeProps {
+    documents: Document[];
+    activeId: string | null;
+    onSelect: (id: string) => void;
+    onAdd: (parentId: string | null) => void;
+    onDelete: (id: string) => void;
+    onToggleExpand: (id: string) => void;
+}
+/**
+ * Renders the complete document hierarchy as a scrollable sidebar panel.
+ * Root-level documents are iterated and each is rendered as a `TreeNode`.
+ */
+export declare const DocumentTree: ({ documents, activeId, onSelect, onAdd, onDelete, onToggleExpand, }: DocumentTreeProps) => import("react").JSX.Element;
+export {};

package/dist/documents/defaultDocuments.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module defaultDocuments
+ * @description Provides the seed document list used to pre-populate the editor
+ * in a fresh environment with example content, folders, and nested notes.
+ */
+import type { Document } from "./DocumentTree";
+/**
+ * Initial set of example documents shown to first-time users.
+ * Includes a welcome note, two folder nodes (Projects, Research), and
+ * several child notes with sample HTML content.
+ */
+export declare const defaultDocuments: Document[];