entangle-ui 0.6.3 → 0.8.0

package/dist/types/hooks/useKeyboard/useKeyboard.d.ts

@@ -0,0 +1,36 @@
+import { KeyboardState } from './types.js';
+export { AllKeys, ModifierKeys } from './types.js';
+
+/**
+ * Hook for tracking keyboard state including modifier keys and pressed keys.
+ *
+ * Useful for components that need to respond to keyboard modifiers like
+ * Ctrl+drag for snapping, Shift+drag for precision, etc.
+ * @returns Current keyboard state
+ *
+ * @example
+ * ```tsx
+ * // Track all keys and modifiers
+ * const keyboard = useKeyboard();
+ *
+ * const handleMouseMove = (e: MouseEvent) => {
+ *   if (keyboard.ctrl) {
+ *     // Snap to grid
+ *   } else if (keyboard.shift) {
+ *     // Precision mode
+ *   }
+ * };
+ *
+ * // Track only specific keys
+ * const keyboard = useKeyboard({
+ *   trackAllKeys: false,
+ *   trackedKeys: ['Space', 'Enter', 'Escape']
+ * });
+ *
+ * // Check if specific key is pressed
+ * const isSpacePressed = keyboard.pressedKeys.includes('Space');
+ * ```
+ */
+declare const useKeyboard: () => KeyboardState;
+
+export { KeyboardState, useKeyboard };

package/dist/types/hooks/useKeyboard/utils.d.ts

@@ -0,0 +1,6 @@
+import { KeyboardState, AllKeys, ModifierKeys } from './types.js';
+
+declare const isModifierKey: (key: string) => key is ModifierKeys;
+declare const isKeyPressed: (keyboardState: KeyboardState, key: AllKeys) => boolean;
+
+export { isKeyPressed, isModifierKey };

package/dist/types/hooks/useMergedRef/useMergedRef.d.ts

@@ -0,0 +1,22 @@
+import { Ref, RefCallback } from 'react';
+
+/**
+ * Merge multiple refs into a single callback ref. Each provided ref (object
+ * ref, callback ref, or `null`/`undefined`) receives the node when the merged
+ * ref fires.
+ *
+ * Useful when a component needs to keep an internal ref to a DOM node while
+ * also forwarding the same node through an externally supplied `ref` prop
+ * (ref-as-prop in React 19).
+ *
+ * @example
+ * ```tsx
+ * const internalRef = useRef<HTMLDivElement>(null);
+ * const mergedRef = useMergedRef(internalRef, props.ref);
+ *
+ * return <div ref={mergedRef} />;
+ * ```
+ */
+declare function useMergedRef<T>(...refs: Array<Ref<T> | undefined | null>): RefCallback<T>;
+
+export { useMergedRef };

package/dist/types/hooks/useResizeObserver/useResizeObserver.d.ts

@@ -0,0 +1,35 @@
+import { RefObject } from 'react';
+
+interface UseResizeObserverOptions {
+    /**
+     * When false, the observer is not attached. Toggling this from `false` to
+     * `true` (re-)attaches the observer; toggling back disconnects it.
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * Observe size changes on an element. SSR-safe; cleans up on unmount.
+ *
+ * The callback is wrapped in a ref so consumers do not have to memoize it —
+ * the underlying observer never re-subscribes when the callback identity
+ * changes.
+ *
+ * The hook re-checks `ref.current` on every render so it picks up nodes that
+ * mount later (e.g. through conditional rendering). When the observed node
+ * has not changed the only cost is a single identity comparison.
+ *
+ * @example
+ * ```tsx
+ * const ref = useRef<HTMLDivElement>(null);
+ * useResizeObserver(ref, entry => {
+ *   console.log(entry.contentRect.width);
+ * });
+ *
+ * return <div ref={ref} />;
+ * ```
+ */
+declare function useResizeObserver<T extends HTMLElement>(ref: RefObject<T | null>, callback: (entry: ResizeObserverEntry) => void, options?: UseResizeObserverOptions): void;
+
+export { useResizeObserver };
+export type { UseResizeObserverOptions };

package/dist/types/hooks/useTheme/useTheme.d.ts

@@ -0,0 +1,48 @@
+import { UseThemeReturn } from './useTheme.types.js';
+
+/**
+ * Read the current theme at runtime.
+ *
+ * Returns the resolved CSS variable snapshot from `:root`, the detected
+ * theme variant, and helpers for reading individual tokens by path.
+ * Components should prefer compile-time tokens via Vanilla Extract
+ * (`vars.*` from `@/theme`) — reach for `useTheme` only when a runtime
+ * read is genuinely required (canvas drawing, third-party libraries that
+ * take colors as plain strings).
+ *
+ * **Scope:** the hook always reads from `:root` — both the variant and
+ * the resolved values come from `document.documentElement`. A light- or
+ * custom-themed subtree wrapped in `VanillaThemeProvider` will **not** be
+ * reflected here; for that, components inside the subtree should style
+ * via Vanilla Extract `vars.*` (which the browser resolves correctly per
+ * scope) rather than runtime reads.
+ *
+ * **SSR:** returns the dark-theme defaults as a fallback. The hook
+ * re-evaluates against the live DOM on mount via `useLayoutEffect`, so
+ * the second render contains the real values before the browser paints.
+ *
+ * **Reactivity:** v0.8 reads once on mount. Toggling the root theme at
+ * runtime is not reflected — remount the consuming subtree to pick up
+ * the new theme. A `MutationObserver`-based subscription may be added
+ * in a later release if consumer demand emerges.
+ *
+ * @example
+ * ```tsx
+ * const { values, variant, getVar, getToken } = useTheme();
+ *
+ * // Canvas drawing with theme-aware colors
+ * ctx.strokeStyle = values.colors.accent.primary;
+ *
+ * // Conditional logic
+ * if (variant === 'dark') loadDarkAssets();
+ *
+ * // Inline styles that follow theme changes automatically
+ * <div style={{ color: getVar('colors.text.primary') }} />
+ *
+ * // One-off token resolution
+ * const accent = getToken('colors.accent.primary');
+ * ```
+ */
+declare function useTheme(): UseThemeReturn;
+
+export { useTheme };

package/dist/types/hooks/useTheme/useTheme.types.d.ts

@@ -0,0 +1,60 @@
+import { ThemeValues } from '../../theme/createCustomTheme.js';
+
+/**
+ * Same shape as `ThemeValues` but with each leaf widened to `string`.
+ *
+ * `darkThemeValues` is declared `as const`, which makes its leaf types
+ * literal (e.g. `'#007acc'`). At runtime the hook reads arbitrary CSS
+ * custom-property strings from the DOM — those values are not constrained
+ * to the dark-theme literals, so the return type widens to plain strings
+ * to stay sound for light, custom, or computed values.
+ */
+type ResolvedThemeValues = WidenLeaves<ThemeValues>;
+type WidenLeaves<T> = T extends string ? string : T extends number ? number : {
+    -readonly [K in keyof T]: WidenLeaves<T[K]>;
+};
+/**
+ * Detected theme variant.
+ *
+ * Detection is **root-only**: the hook reports `'light'` only when the
+ * `lightThemeClass` produced by `createLightTheme()` is applied to
+ * `document.documentElement` — the same element the hook reads CSS
+ * variable values from. A light-themed subtree wrapped in
+ * `VanillaThemeProvider` does **not** flip this variant, because the
+ * resolved values would still come from the root.
+ *
+ * - `'dark'` — the default; no `lightThemeClass` on `:root`.
+ * - `'light'` — `lightThemeClass` is on `:root`.
+ * - `'custom'` — reserved. v0.8 does not auto-detect themes produced by
+ *   `createCustomTheme(selector, overrides)`; the union member exists so
+ *   future releases can add detection without a breaking type change.
+ */
+type ThemeVariant = 'dark' | 'light' | 'custom';
+interface UseThemeReturn {
+    /** Current root-theme variant. See `ThemeVariant` for detection rules. */
+    variant: ThemeVariant;
+    /** Resolved theme values — CSS variable values read from `:root`. */
+    values: ResolvedThemeValues;
+    /**
+     * Resolve a single token to its current CSS-var value, e.g. `'#007acc'`.
+     *
+     * Falls back to the dark-theme default when the underlying CSS variable
+     * is unset or when no DOM is available (SSR). Returns an empty string
+     * only for paths that don't resolve to a leaf in the theme contract.
+     * Repeated calls for the same path are cached for the life of the hook
+     * instance.
+     */
+    getToken: (path: string) => string;
+    /**
+     * Get the `var(--etui-...)` reference for a token, e.g.
+     * `'var(--etui-color-accent-primary)'`. Useful for inline styles that
+     * must follow theme changes automatically.
+     *
+     * SSR-safe — the returned string is constructed from the contract and
+     * works identically in browser and server rendering. Returns an empty
+     * string only for paths that don't resolve to a leaf in the contract.
+     */
+    getVar: (path: string) => string;
+}
+
+export type { ResolvedThemeValues, ThemeVariant, UseThemeReturn };

package/dist/types/index.d.ts

@@ -1,6 +1,9 @@
 export { ThemeVars, vars } from './theme/contract.css.js';
-export { DarkThemeValues, darkThemeValues } from './theme/darkTheme.css.js';
-export { createCustomTheme } from './theme/createCustomTheme.js';
+export { DarkThemeValues, darkThemeValues } from './theme/darkThemeValues.js';
+export { LightThemeValues, lightThemeValues } from './theme/lightThemeValues.js';
+export { lightThemeClass } from './theme/lightTheme.css.js';
+export { ThemeValues, createCustomTheme } from './theme/createCustomTheme.js';
+export { createLightTheme } from './theme/createLightTheme.js';
 export { VanillaThemeProvider, VanillaThemeProviderProps } from './theme/VanillaThemeProvider.js';
 export { ThemeProvider, ThemeProviderProps } from './theme/ThemeProvider.js';
 export { Accordion } from './components/layout/Accordion/Accordion.js';
@@ -8,8 +11,14 @@ export { AccordionItem } from './components/layout/Accordion/AccordionItem.js';
 export { AccordionTrigger } from './components/layout/Accordion/AccordionTrigger.js';
 export { AccordionContent } from './components/layout/Accordion/AccordionContent.js';
 export { AccordionContentProps, AccordionItemProps, AccordionProps, AccordionSize, AccordionTriggerProps, AccordionVariant } from './components/layout/Accordion/Accordion.types.js';
+export { Divider } from './components/layout/Divider/Divider.js';
+export { DividerOrientation, DividerProps, DividerSpacing, DividerVariant } from './components/layout/Divider/Divider.types.js';
 export { Flex, FlexAlign, FlexAlignContent, FlexDirection, FlexJustify, FlexProps, FlexSpacing, FlexWrap } from './components/layout/Flex/Flex.js';
 export { Grid, GridProps, GridSize, GridSpacing } from './components/layout/Grid/Grid.js';
+export { ListItem } from './components/layout/ListItem/ListItem.js';
+export { ListItemDensity, ListItemProps } from './components/layout/ListItem/ListItem.types.js';
+export { PageHeader } from './components/layout/PageHeader/PageHeader.js';
+export { PageHeaderProps, PageHeaderSize } from './components/layout/PageHeader/PageHeader.types.js';
 export { PanelSurface } from './components/layout/PanelSurface/PanelSurface.js';
 export { PanelSurfaceBodyProps, PanelSurfaceFooterProps, PanelSurfaceHeaderProps, PanelSurfaceProps, PanelSurfaceSize } from './components/layout/PanelSurface/PanelSurface.types.js';
 export { ScrollArea } from './components/layout/ScrollArea/ScrollArea.js';
@@ -19,25 +28,43 @@ export { SplitPane } from './components/layout/SplitPane/SplitPane.js';
 export { SplitPanePanel } from './components/layout/SplitPane/SplitPanePanel.js';
 export { PanelConfig, PanelSize, SplitDirection, SplitPanePanelProps, SplitPaneProps } from './components/layout/SplitPane/SplitPane.types.js';
 export { Stack } from './components/layout/Stack/Stack.js';
+export { Avatar } from './components/primitives/Avatar/Avatar.js';
+export { AvatarGroup } from './components/primitives/Avatar/AvatarGroup.js';
+export { AvatarColor, AvatarGroupProps, AvatarProps, AvatarShape, AvatarSize, AvatarStatus } from './components/primitives/Avatar/Avatar.types.js';
+export { Badge } from './components/primitives/Badge/Badge.js';
+export { BadgeColor, BadgeProps, BadgeSize, BadgeVariant } from './components/primitives/Badge/Badge.types.js';
 export { Button, ButtonProps, ButtonSize, ButtonVariant } from './components/primitives/Button/Button.js';
 export { Checkbox } from './components/primitives/Checkbox/Checkbox.js';
 export { CheckboxGroup } from './components/primitives/Checkbox/CheckboxGroup.js';
 export { CheckboxGroupProps, CheckboxProps, CheckboxSize, CheckboxVariant } from './components/primitives/Checkbox/Checkbox.types.js';
+export { Code } from './components/primitives/Code/Code.js';
+export { CodeProps, CodeSize } from './components/primitives/Code/Code.types.js';
 export { Collapsible } from './components/primitives/Collapsible/Collapsible.js';
 export { CollapsibleProps, CollapsibleSize } from './components/primitives/Collapsible/Collapsible.types.js';
 export { Icon, IconProps, IconSize } from './components/primitives/Icon/Icon.js';
 export { IconButton } from './components/primitives/IconButton/IconButton.js';
 export { Input, InputProps, InputSize } from './components/primitives/Input/Input.js';
+export { Kbd } from './components/primitives/Kbd/Kbd.js';
+export { KbdProps, KbdSize, KbdVariant } from './components/primitives/Kbd/Kbd.types.js';
+export { Link } from './components/primitives/Link/Link.js';
+export { LinkColor, LinkProps, LinkSize, LinkUnderline, LinkVariant } from './components/primitives/Link/Link.types.js';
 export { Paper, PaperElevation, PaperNestLevel, PaperProps, PaperSpacing } from './components/primitives/Paper/Paper.js';
 export { Popover } from './components/primitives/Popover/Popover.js';
 export { PopoverClose } from './components/primitives/Popover/PopoverClose.js';
 export { PopoverContent } from './components/primitives/Popover/PopoverContent.js';
 export { PopoverTrigger } from './components/primitives/Popover/PopoverTrigger.js';
 export { PopoverCloseProps, PopoverContentProps, PopoverPlacement, PopoverProps, PopoverTriggerProps } from './components/primitives/Popover/Popover.types.js';
+export { Radio } from './components/primitives/Radio/Radio.js';
+export { RadioGroup } from './components/primitives/Radio/RadioGroup.js';
+export { RadioGroupOrientation, RadioGroupProps, RadioLabelPosition, RadioProps, RadioSize } from './components/primitives/Radio/Radio.types.js';
 export { Switch, SwitchProps, SwitchSize } from './components/primitives/Switch/Switch.js';
 export { Text, TextAlign, TextColor, TextElement, TextLineHeight, TextProps, TextSize, TextVariant, TextWeight } from './components/primitives/Text/Text.js';
+export { TextArea } from './components/primitives/TextArea/TextArea.js';
+export { TextAreaProps, TextAreaResize, TextAreaSize } from './components/primitives/TextArea/TextArea.types.js';
 export { Tooltip, TooltipProps } from './components/primitives/Tooltip/Tooltip.js';
 export { CollisionAvoidance, TooltipCollisionConfig, TooltipCollisionStrategy, TooltipPlacement } from './components/primitives/Tooltip/types.js';
+export { VisuallyHidden } from './components/primitives/VisuallyHidden/VisuallyHidden.js';
+export { VisuallyHiddenElement, VisuallyHiddenProps } from './components/primitives/VisuallyHidden/VisuallyHidden.types.js';
 export { Brand, DeepPartial, DeepReadonly, KeyOf, LiteralUnion, NonEmptyArray, Prettify, RequireFields, StrictExclude, ValueOf } from './types/utilities.js';
 export { BaseComponent, Size, Variant } from './types/common.js';
 export { ColorPicker } from './components/controls/ColorPicker/ColorPicker.js';
@@ -62,12 +89,20 @@ export { createLinearCurve, domainToCanvas, evaluateCurve, sampleCurve } from '.
 export { CURVE_PRESETS } from './components/controls/CurveEditor/curvePresets.js';
 export { CartesianPicker } from './components/controls/CartesianPicker/CartesianPicker.js';
 export { CartesianPickerInfo, CartesianPickerProps, CartesianPickerSize } from './components/controls/CartesianPicker/CartesianPicker.types.js';
+export { Breadcrumbs } from './components/navigation/Breadcrumbs/Breadcrumbs.js';
+export { BreadcrumbItem } from './components/navigation/Breadcrumbs/BreadcrumbItem.js';
+export { BreadcrumbSeparator } from './components/navigation/Breadcrumbs/BreadcrumbSeparator.js';
+export { BreadcrumbEllipsis } from './components/navigation/Breadcrumbs/BreadcrumbEllipsis.js';
+export { BreadcrumbEllipsisProps, BreadcrumbItemProps, BreadcrumbSeparatorProps, BreadcrumbsProps, BreadcrumbsSize } from './components/navigation/Breadcrumbs/Breadcrumbs.types.js';
 export { ContextMenu } from './components/navigation/ContextMenu/ContextMenu.js';
 export { useContextMenuTarget } from './components/navigation/ContextMenu/useContextMenuTarget.js';
 export { ContextMenuBaseProps, ContextMenuConfig, ContextMenuProps, ContextMenuTargetDetails, UseContextMenuTargetResult } from './components/navigation/ContextMenu/ContextMenu.types.js';
 export { Menu } from './components/navigation/Menu/Menu.js';
 export { useMenu } from './components/navigation/Menu/useMenu.js';
 export { ItemSelectionType, MenuBaseProps, MenuConfig, MenuGroup, MenuItem, MenuProps, MenuSelection, SubmenuTrigger } from './components/navigation/Menu/Menu.types.js';
+export { SegmentedControl } from './components/navigation/SegmentedControl/SegmentedControl.js';
+export { SegmentedControlItem } from './components/navigation/SegmentedControl/SegmentedControlItem.js';
+export { SegmentedControlItemProps, SegmentedControlOrientation, SegmentedControlProps, SegmentedControlSize, SegmentedControlVariant } from './components/navigation/SegmentedControl/SegmentedControl.types.js';
 export { Tabs } from './components/navigation/Tabs/Tabs.js';
 export { TabList } from './components/navigation/Tabs/TabList.js';
 export { Tab } from './components/navigation/Tabs/Tab.js';
@@ -76,12 +111,27 @@ export { TabListProps, TabPanelProps, TabProps, TabsProps, TabsSize, TabsVariant
 export { FormLabel, FormLabelProps } from './components/form/FormLabel.js';
 export { FormHelperText, FormHelperTextProps } from './components/form/FormHelperText.js';
 export { InputWrapper, InputWrapperProps } from './components/form/InputWrapper.js';
+export { Alert } from './components/feedback/Alert/Alert.js';
+export { AlertTitle } from './components/feedback/Alert/AlertTitle.js';
+export { AlertDescription } from './components/feedback/Alert/AlertDescription.js';
+export { AlertActions } from './components/feedback/Alert/AlertActions.js';
+export { AlertActionsProps, AlertAppearance, AlertDescriptionProps, AlertProps, AlertTitleProps, AlertVariant } from './components/feedback/Alert/Alert.types.js';
 export { Dialog } from './components/feedback/Dialog/Dialog.js';
 export { DialogHeader } from './components/feedback/Dialog/DialogHeader.js';
 export { DialogBody } from './components/feedback/Dialog/DialogBody.js';
 export { DialogFooter } from './components/feedback/Dialog/DialogFooter.js';
 export { DialogClose } from './components/feedback/Dialog/DialogClose.js';
 export { DialogBodyProps, DialogFooterProps, DialogHeaderProps, DialogProps, DialogSize } from './components/feedback/Dialog/Dialog.types.js';
+export { EmptyState } from './components/feedback/EmptyState/EmptyState.js';
+export { EmptyStateProps, EmptyStateVariant } from './components/feedback/EmptyState/EmptyState.types.js';
+export { ProgressBar } from './components/feedback/ProgressBar/ProgressBar.js';
+export { CircularProgress } from './components/feedback/ProgressBar/CircularProgress.js';
+export { CircularProgressProps, CircularProgressSize, ProgressBarColor, ProgressBarLabelPosition, ProgressBarProps, ProgressBarSize } from './components/feedback/ProgressBar/ProgressBar.types.js';
+export { Skeleton } from './components/feedback/Skeleton/Skeleton.js';
+export { SkeletonGroup } from './components/feedback/Skeleton/SkeletonGroup.js';
+export { SkeletonAnimation, SkeletonGroupProps, SkeletonProps, SkeletonShape } from './components/feedback/Skeleton/Skeleton.types.js';
+export { Spinner } from './components/feedback/Spinner/Spinner.js';
+export { SpinnerColor, SpinnerProps, SpinnerSize, SpinnerVariant } from './components/feedback/Spinner/Spinner.types.js';
 export { ToastProvider } from './components/feedback/Toast/ToastProvider.js';
 export { useToast } from './components/feedback/Toast/useToast.js';
 export { ToastData, ToastPosition, ToastProviderProps, ToastSeverity, UseToastReturn } from './components/feedback/Toast/Toast.types.js';
@@ -94,6 +144,8 @@ export { PropertyGroupProps, PropertyInspectorSize, PropertyPanelProps, Property
 export { ViewportGizmo } from './components/editor/ViewportGizmo/ViewportGizmo.js';
 export { GizmoAxisColorPreset, GizmoAxisConfig, GizmoHitRegion, GizmoOrientation, GizmoPresetView, GizmoUpAxis, OrbitDelta, ViewportGizmoProps, ViewportGizmoSize } from './components/editor/ViewportGizmo/ViewportGizmo.types.js';
 export { ProjectedArm, Vec3, axisToPresetView, eulerToRotationMatrix, gizmoHitTest, presetViewToOrientation, projectAxes, projectToCanvas, quaternionToEuler } from './components/editor/ViewportGizmo/gizmoMath.js';
+export { TransformControl } from './components/editor/TransformControl/TransformControl.js';
+export { CoordinateSpace, CoordinateSpaceOption, TransformControlProps, TransformLabelsConfig, TransformPrecisionConfig, TransformShowConfig, TransformStepConfig, TransformUnitsConfig, TransformValue } from './components/editor/TransformControl/TransformControl.types.js';
 export { ChatPanel } from './components/editor/ChatPanel/ChatPanel.js';
 export { ChatMessageList } from './components/editor/ChatPanel/ChatMessageList.js';
 export { ChatMessage } from './components/editor/ChatPanel/ChatMessage.js';
@@ -107,10 +159,12 @@ export { ChatContextChip } from './components/editor/ChatPanel/ChatContextChip.j
 export { ChatEmptyState } from './components/editor/ChatPanel/ChatEmptyState.js';
 export { ChatActionBar } from './components/editor/ChatPanel/ChatActionBar.js';
 export { ChatInputToolbar } from './components/editor/ChatPanel/ChatInputToolbar.js';
+export { ChatMarkdownRenderer } from './components/editor/ChatPanel/ChatMarkdownRenderer.js';
 export { useChatMessages } from './components/editor/ChatPanel/useChatMessages.js';
 export { useChatInput } from './components/editor/ChatPanel/useChatInput.js';
 export { useChatScroll } from './components/editor/ChatPanel/useChatScroll.js';
-export { ChatActionBarProps, ChatAttachmentChipProps, ChatAttachmentData, ChatBubbleProps, ChatCodeBlockProps, ChatContextChipProps, ChatEmptyStateProps, ChatInputProps, ChatInputToolbarProps, ChatMessageData, ChatMessageListProps, ChatMessageProps, ChatMessageRole, ChatMessageStatus, ChatPanelDensity, ChatPanelProps, ChatToolCallData, ChatToolCallProps, ChatToolCallStatus, ChatTypingIndicatorProps, UseChatInputOptions, UseChatInputReturn, UseChatMessagesOptions, UseChatMessagesReturn, UseChatScrollOptions, UseChatScrollReturn } from './components/editor/ChatPanel/ChatPanel.types.js';
+export { ChatActionBarProps, ChatAttachmentChipProps, ChatAttachmentData, ChatBubbleProps, ChatCodeBlockProps, ChatContextChipProps, ChatEmptyStateProps, ChatInputProps, ChatInputToolbarProps, ChatMessageData, ChatMessageListProps, ChatMessageListScrollApi, ChatMessageProps, ChatMessageRole, ChatMessageStatus, ChatPanelDensity, ChatPanelProps, ChatToolCallData, ChatToolCallProps, ChatToolCallStatus, ChatTypingIndicatorProps, UseChatInputOptions, UseChatInputReturn, UseChatMessagesOptions, UseChatMessagesReturn, UseChatScrollOptions, UseChatScrollReturn } from './components/editor/ChatPanel/ChatPanel.types.js';
+export { ChatMarkdownRendererProps } from './components/editor/ChatPanel/ChatMarkdownRenderer.types.js';
 export { AppShell, useAppShell } from './components/shell/AppShell/AppShell.js';
 export { AppShellContextValue, AppShellProps, AppShellSlotProps, AppShellToolbarSlotProps, ToolbarPosition } from './components/shell/AppShell/AppShell.types.js';
 export { FloatingManager, FloatingPanel } from './components/shell/FloatingPanel/FloatingPanel.js';
@@ -121,4 +175,22 @@ export { StatusBar } from './components/shell/StatusBar/StatusBar.js';
 export { StatusBarItemProps, StatusBarProps, StatusBarSectionProps, StatusBarSectionSide, StatusBarSize, StatusBarVariant } from './components/shell/StatusBar/StatusBar.types.js';
 export { Toolbar } from './components/shell/Toolbar/Toolbar.js';
 export { ToolbarButtonProps, ToolbarButtonVariant, ToolbarGroupProps, ToolbarOrientation, ToolbarProps, ToolbarSeparatorProps, ToolbarSize, ToolbarSpacerProps, ToolbarToggleProps } from './components/shell/Toolbar/Toolbar.types.js';
+export { useKeyboard } from './hooks/useKeyboard/useKeyboard.js';
+export { AllKeys, KeyCode, KeyboardState, ModifierKeys } from './hooks/useKeyboard/types.js';
+export { UseControlledStateOptions, useControlledState } from './hooks/useControlledState/useControlledState.js';
+export { UseFocusTrapOptions, useFocusTrap } from './hooks/useFocusTrap/useFocusTrap.js';
+export { useMergedRef } from './hooks/useMergedRef/useMergedRef.js';
+export { UseResizeObserverOptions, useResizeObserver } from './hooks/useResizeObserver/useResizeObserver.js';
+export { useDisclosure } from './hooks/useDisclosure/useDisclosure.js';
+export { UseDisclosureOptions, UseDisclosureReturn } from './hooks/useDisclosure/useDisclosure.types.js';
+export { useClipboard } from './hooks/useClipboard/useClipboard.js';
+export { ClipboardStatus, UseClipboardOptions, UseClipboardReturn } from './hooks/useClipboard/useClipboard.types.js';
+export { UseClickOutsideOptions, useClickOutside } from './hooks/useClickOutside/useClickOutside.js';
+export { useHotkey } from './hooks/useHotkey/useHotkey.js';
+export { UseHotkeyOptions } from './hooks/useHotkey/useHotkey.types.js';
+export { useTheme } from './hooks/useTheme/useTheme.js';
+export { ResolvedThemeValues, ThemeVariant, UseThemeReturn } from './hooks/useTheme/useTheme.types.js';
 export { cx as cn, cx } from './utils/cx.js';
+export { Platform, getKeyGlyph, getPlatform, parseShortcut } from './utils/platform.js';
+export { animBlink, animFadeIn, animPulse, animSpin, animWave, blinkKeyframe, fadeInKeyframe, pulseKeyframe, spinKeyframe, waveKeyframe } from './utils/animations.css.js';
+export { isKeyPressed, isModifierKey } from './hooks/useKeyboard/utils.js';

package/dist/types/theme/ThemeProvider.d.ts

@@ -2,12 +2,24 @@ import React from 'react';
 
 interface ThemeProviderProps {
     children: React.ReactNode;
+    /**
+     * When true, apply Entangle's dark-theme scrollbar styling globally
+     * (thin 8px track, muted thumb). The class is added to
+     * `document.body` and removed on unmount.
+     *
+     * Opt-in by design: many app shells run alongside other UI
+     * frameworks where forcing scrollbar styles would be invasive.
+     *
+     * @default false
+     */
+    globalScrollbars?: boolean;
 }
 /**
  * Theme provider for Entangle UI components.
  *
- * The dark theme is applied globally via CSS custom properties on `:root`.
- * This provider is a simple pass-through — most apps don't need it.
+ * The dark theme is applied globally via CSS custom properties on `:root`,
+ * so this provider is a pass-through for most apps. Use it to opt into
+ * additional global behaviors such as native-scrollbar theming.
  *
  * For scoped theme overrides, use `VanillaThemeProvider` with a custom
  * class generated by `createCustomTheme()`.