@mithrl/design-system 0.1.0 → 0.3.0

package/dist/components/workspace-navigation/WorkspaceNavigation.d.ts

@@ -0,0 +1,115 @@
+import { type VariantProps } from "class-variance-authority";
+import { type DragEvent, type HTMLAttributes, type MouseEvent, type MouseEventHandler } from "react";
+import { type IconButtonProps } from "../icon-button/IconButton";
+
+export declare const workspaceNavigationVariants: (props?: ({
+    presentation?: "inline" | "overlay" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type WorkspaceNavigationPresentation = NonNullable<VariantProps<typeof workspaceNavigationVariants>["presentation"]>;
+export type WorkspaceNavigationQuestion = {
+    /** Stable owner-defined identity used for controlled selection. */
+    id: string;
+    /** Visible destination name. Long values use Navigation Item's text fade. */
+    label: string;
+    /** Stable route. Omit only when the owner performs an in-place selection. */
+    href?: string;
+    /** Uses the approved text shimmer and Progress Indicator. */
+    loading?: boolean;
+    /** Enables opening this unopened Question through native drag. */
+    draggable?: boolean;
+    /** Optional explicit name for the product-owned overflow action. */
+    menuActionLabel?: string;
+};
+type NavigationClick = MouseEvent<HTMLAnchorElement | HTMLButtonElement>;
+type MenuClick = MouseEvent<HTMLButtonElement>;
+type QuestionDrag = DragEvent<HTMLAnchorElement | HTMLButtonElement>;
+export type WorkspaceNavigationProps = Omit<HTMLAttributes<HTMLElement>, "children" | "onSelect"> & VariantProps<typeof workspaceNavigationVariants> & {
+    /** Accessible name for the navigation landmark. */
+    "aria-label"?: string;
+    /** Destination for the persistent collection-level route. */
+    allProjectsHref?: string;
+    /** Visible label for the collection-level route. */
+    allProjectsLabel?: string;
+    /** Visible label for the creation action. */
+    newQuestionLabel?: string;
+    /** Stable identity for a controlled New Question dialog trigger. */
+    newQuestionTriggerId?: string;
+    /** Visible heading for the question destination region. */
+    questionsLabel?: string;
+    /** Controlled question destinations in display order. */
+    questions: readonly WorkspaceNavigationQuestion[];
+    /** Controlled current question identity. */
+    selectedQuestionId?: string;
+    /** Controlled Questions currently active in Primary or Secondary panels. */
+    activeQuestionIds?: readonly string[];
+    /** Selects a question without prescribing router ownership. */
+    onQuestionSelect?: (question: WorkspaceNavigationQuestion, event: NavigationClick) => void;
+    /** Opens the product-owned menu for one question. */
+    onQuestionMenuAction?: (question: WorkspaceNavigationQuestion, event: MenuClick) => void;
+    /** Reports the beginning of an enabled Question drag. */
+    onQuestionDragStart?: (question: WorkspaceNavigationQuestion, event: QuestionDrag) => void;
+    /** Reports the end of an enabled Question drag. */
+    onQuestionDragEnd?: (question: WorkspaceNavigationQuestion, event: QuestionDrag) => void;
+    /** Starts a new question. */
+    onNewQuestion: MouseEventHandler<HTMLButtonElement>;
+    /** Reports activation of the All Projects destination. */
+    onAllProjectsClick?: MouseEventHandler<HTMLAnchorElement>;
+    /** Controls the bottom scroll affordance. Auto reflects real overflow. */
+    bottomFade?: "auto" | "always" | "never";
+};
+/**
+ * Project-level destination panel for Workspace. It composes Navigation Item,
+ * Separator, Icon, and Progress Indicator through their public contracts.
+ * App Shell remains responsible for breakpoint selection and overlay placement.
+ */
+export declare const WorkspaceNavigation: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "children" | "onSelect"> & VariantProps<(props?: ({
+    presentation?: "inline" | "overlay" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string> & {
+    /** Accessible name for the navigation landmark. */
+    "aria-label"?: string;
+    /** Destination for the persistent collection-level route. */
+    allProjectsHref?: string;
+    /** Visible label for the collection-level route. */
+    allProjectsLabel?: string;
+    /** Visible label for the creation action. */
+    newQuestionLabel?: string;
+    /** Stable identity for a controlled New Question dialog trigger. */
+    newQuestionTriggerId?: string;
+    /** Visible heading for the question destination region. */
+    questionsLabel?: string;
+    /** Controlled question destinations in display order. */
+    questions: readonly WorkspaceNavigationQuestion[];
+    /** Controlled current question identity. */
+    selectedQuestionId?: string;
+    /** Controlled Questions currently active in Primary or Secondary panels. */
+    activeQuestionIds?: readonly string[];
+    /** Selects a question without prescribing router ownership. */
+    onQuestionSelect?: (question: WorkspaceNavigationQuestion, event: NavigationClick) => void;
+    /** Opens the product-owned menu for one question. */
+    onQuestionMenuAction?: (question: WorkspaceNavigationQuestion, event: MenuClick) => void;
+    /** Reports the beginning of an enabled Question drag. */
+    onQuestionDragStart?: (question: WorkspaceNavigationQuestion, event: QuestionDrag) => void;
+    /** Reports the end of an enabled Question drag. */
+    onQuestionDragEnd?: (question: WorkspaceNavigationQuestion, event: QuestionDrag) => void;
+    /** Starts a new question. */
+    onNewQuestion: MouseEventHandler<HTMLButtonElement>;
+    /** Reports activation of the All Projects destination. */
+    onAllProjectsClick?: MouseEventHandler<HTMLAnchorElement>;
+    /** Controls the bottom scroll affordance. Auto reflects real overflow. */
+    bottomFade?: "auto" | "always" | "never";
+} & import("react").RefAttributes<HTMLElement>>;
+export type WorkspacePanelSide = "navigator" | "explorer";
+export type WorkspacePanelToggleButtonProps = Omit<IconButtonProps, "icon" | "loading" | "size" | "variant"> & {
+    /** Identifies which App Shell panel the animated divider represents. */
+    side: WorkspacePanelSide;
+    /** Controlled visibility state. */
+    expanded: boolean;
+};
+/** App Bar control with the approved moving and shortening panel divider. */
+export declare const WorkspacePanelToggleButton: import("react").ForwardRefExoticComponent<Omit<IconButtonProps, "icon" | "loading" | "size" | "variant"> & {
+    /** Identifies which App Shell panel the animated divider represents. */
+    side: WorkspacePanelSide;
+    /** Controlled visibility state. */
+    expanded: boolean;
+} & import("react").RefAttributes<HTMLButtonElement>>;
+export {};

package/dist/index.d.ts

@@ -3,12 +3,18 @@ export { Button, buttonVariants } from "./components/button/Button";
 export type { ButtonProps, ButtonSize, ButtonVariant, } from "./components/button/Button";
 export { Icon, iconVariants } from "./components/icon/Icon";
 export type { IconGlyphComponent, IconProps, IconSize, } from "./components/icon/Icon";
+export { NavigationItem, navigationItemVariants, } from "./components/navigation-item/NavigationItem";
+export type { NavigationItemPreviewState, NavigationItemProps, } from "./components/navigation-item/NavigationItem";
+export { WorkspaceNavigation, WorkspacePanelToggleButton, workspaceNavigationVariants, } from "./components/workspace-navigation/WorkspaceNavigation";
+export type { WorkspaceNavigationPresentation, WorkspaceNavigationProps, WorkspaceNavigationQuestion, WorkspacePanelSide, WorkspacePanelToggleButtonProps, } from "./components/workspace-navigation/WorkspaceNavigation";
 export { IconButton, iconButtonVariants, } from "./components/icon-button/IconButton";
 export type { IconButtonProps, IconButtonSize, IconButtonVariant, } from "./components/icon-button/IconButton";
 export { SegmentedTabs, segmentedTabsVariants, } from "./components/segmented-tabs/SegmentedTabs";
 export type { SegmentedTabItem, SegmentedTabsActivationMode, SegmentedTabsProps, SegmentedTabsSize, } from "./components/segmented-tabs/SegmentedTabs";
 export { PanelTabs } from "./components/panel-tabs/PanelTabs";
 export type { PanelTabItem, PanelTabsProps, } from "./components/panel-tabs/PanelTabs";
+export { MITHRL_QUESTION_DRAG_TYPE, SecondaryPanel, } from "./components/secondary-panel/SecondaryPanel";
+export type { SecondaryPanelDropTarget, SecondaryPanelProps, SecondaryPanelTab, SecondaryPanelTabKind, } from "./components/secondary-panel/SecondaryPanel";
 export { Switch, ThemeSwitch } from "./components/switch/Switch";
 export type { SwitchProps, ThemeMode, ThemeSwitchProps, } from "./components/switch/Switch";
 export { ToggleButton, toggleButtonVariants, } from "./components/toggle-button/ToggleButton";
@@ -19,6 +25,12 @@ export { TextField, textFieldVariants, } from "./components/text-field/TextField
 export type { TextFieldPreviewState, TextFieldProps, TextFieldStatus, TextFieldSurface, } from "./components/text-field/TextField";
 export { Textarea, textareaVariants } from "./components/textarea/Textarea";
 export type { TextareaPreviewState, TextareaProps, TextareaResize, TextareaStatus, TextareaSurface, } from "./components/textarea/Textarea";
+export { Composer } from "./components/composer/Composer";
+export type { ComposerLabels, ComposerMode, ComposerPreviewState, ComposerProps, ComposerStatus, } from "./components/composer/Composer";
+export { ComposerViewTransition } from "./components/composer/ComposerViewTransition";
+export type { ComposerView, ComposerViewTransitionProps, } from "./components/composer/ComposerViewTransition";
+export { ComposerAttachmentView } from "./components/composer/ComposerAttachmentView";
+export type { ComposerAttachmentViewProps, } from "./components/composer/ComposerAttachmentView";
 export { Select, selectVariants } from "./components/select/Select";
 export type { SelectPreviewState, SelectProps, SelectSize, } from "./components/select/Select";
 export { Link, linkVariants } from "./components/link/Link";
@@ -49,10 +61,16 @@ export { Field } from "./components/field/Field";
 export type { FieldControlProps, FieldControlStatus, FieldProps, FieldRenderProps, FieldSize, FieldState, } from "./components/field/Field";
 export { DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuLinkItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, dropdownMenuContentVariants, } from "./components/dropdown-menu/DropdownMenu";
 export type { DropdownMenuContentProps, DropdownMenuContentWidth, DropdownMenuGroupProps, DropdownMenuItemProps, DropdownMenuItemTone, DropdownMenuLabelProps, DropdownMenuLinkItemProps, DropdownMenuProps, DropdownMenuSeparatorProps, DropdownMenuTriggerProps, } from "./components/dropdown-menu/DropdownMenu";
+export { PopoverSurface } from "./components/popover-surface/PopoverSurface";
+export type { PopoverSurfaceProps } from "./components/popover-surface/PopoverSurface";
+export { ProjectMenu } from "./components/project-menu/ProjectMenu";
+export type { ProjectMenuLabels, ProjectMenuProject, ProjectMenuProps, } from "./components/project-menu/ProjectMenu";
+export { Explorer } from "./components/explorer/Explorer";
+export type { ExplorerLabels, ExplorerProps, ExplorerQuestion, ExplorerScientificOutput, ExplorerScientificOutputFolder, ExplorerScientificOutputNode, ExplorerScientificOutputType, ExplorerUploadFile, ExplorerUploadFileType, ExplorerUploadFolder, ExplorerUploadNode, } from "./components/explorer/Explorer";
 export { AccountMenu } from "./components/account-menu/AccountMenu";
 export type { AccountMenuAction, AccountMenuProps, } from "./components/account-menu/AccountMenu";
 export { GlobalAppBar } from "./components/global-app-bar/GlobalAppBar";
-export type { GlobalAppBarProps } from "./components/global-app-bar/GlobalAppBar";
+export type { GlobalAppBarProjectSelector, GlobalAppBarProjectSelectorPresentation, GlobalAppBarProps, } from "./components/global-app-bar/GlobalAppBar";
 export { ProjectCard } from "./components/project-card/ProjectCard";
 export type { ProjectCardActivity, ProjectCardCreator, ProjectCardMetric, ProjectCardPresentation, ProjectCardPreviewArtwork, ProjectCardPreviewState, ProjectCardProps, } from "./components/project-card/ProjectCard";
 export { UploadQueue, UploadQueueItem } from "./components/upload-queue/UploadQueue";
@@ -65,3 +83,11 @@ export { FileDropzone } from "./components/file-dropzone/FileDropzone";
 export type { FileDropzoneHandle, FileDropzoneProps, FileDropzoneRejection, FileDropzoneRejectionReason, FileDropzoneSelection, FileDropzoneSelectionSource, FileDropzoneState, } from "./components/file-dropzone/FileDropzone";
 export { DialogBackdrop, DialogBody, DialogClose, DialogCloseButton, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogPopup, DialogPortal, DialogRoot, DialogTitle, DialogTrigger, DialogViewport, dialogPopupVariants, } from "./components/dialog/Dialog";
 export type { DialogBackdropProps, DialogBodyProps, DialogCloseButtonProps, DialogCloseProps, DialogContentProps, DialogDescriptionProps, DialogFooterProps, DialogHeaderProps, DialogPopupProps, DialogPortalProps, DialogRootProps, DialogSize, DialogTitleProps, DialogTriggerProps, DialogViewportProps, } from "./components/dialog/Dialog";
+export { ResizableHandle, ResizablePanel, ResizablePanelGroup, } from "./components/resizable-panels/ResizablePanels";
+export type { ResizableHandleProps, ResizablePanelDirection, ResizablePanelGroupProps, ResizablePanelMinimum, ResizablePanelProps, } from "./components/resizable-panels/ResizablePanels";
+export { WorkspaceAppShell } from "./patterns/workspace-app-shell/WorkspaceAppShell";
+export { WorkspaceNewQuestionDialog } from "./patterns/workspace-app-shell/WorkspaceNewQuestionDialog";
+export { WorkspaceQuestionSurface } from "./patterns/workspace-app-shell/WorkspaceQuestionSurface";
+export type { WorkspaceAppShellNavigationRenderContext, WorkspaceAppShellNavigationRenderer, WorkspaceAppShellLayout, WorkspaceAppShellProps, WorkspaceNavigationConfiguration, } from "./patterns/workspace-app-shell/WorkspaceAppShell";
+export type { WorkspaceNewQuestionDialogProps, WorkspaceNewQuestionDraft, } from "./patterns/workspace-app-shell/WorkspaceNewQuestionDialog";
+export type { WorkspaceQuestionSurfacePanel, WorkspaceQuestionSurfaceProps, WorkspaceQuestionSurfaceScroll, } from "./patterns/workspace-app-shell/WorkspaceQuestionSurface";