chore: follow the general comments style

src/shared/ui/index.ts

@@ -1,28 +1,150 @@
-export { default as Badge } from './Badge/Badge.svelte';
 export {
+    /**
+     * Pill-shaped status indicator
+     */
+    default as Badge,
+} from './Badge/Badge.svelte';
+export {
+    /**
+     * Main action trigger
+     */
     Button,
+    /**
+     * Horizontal layout for related buttons
+     */
     ButtonGroup,
+    /**
+     * Button optimized for single-icon display
+     */
     IconButton,
+    /**
+     * State-aware toggle switch
+     */
     ToggleButton,
 } from './Button';
-export { default as ComboControl } from './ComboControl/ComboControl.svelte';
-export { default as ContentEditable } from './ContentEditable/ContentEditable.svelte';
-export { default as ControlGroup } from './ControlGroup/ControlGroup.svelte';
-export { default as Divider } from './Divider/Divider.svelte';
-export { default as FilterGroup } from './FilterGroup/FilterGroup.svelte';
-export { default as Footnote } from './Footnote/Footnote.svelte';
-export { default as Input } from './Input/Input.svelte';
-export { default as Label } from './Label/Label.svelte';
-export { default as Loader } from './Loader/Loader.svelte';
-export { default as Logo } from './Logo/Logo.svelte';
-export { default as PerspectivePlan } from './PerspectivePlan/PerspectivePlan.svelte';
-export { default as SearchBar } from './SearchBar/SearchBar.svelte';
-export { default as Section } from './Section/Section.svelte';
-export type { TitleStatusChangeHandler } from './Section/types';
-export { default as SidebarContainer } from './SidebarContainer/SidebarContainer.svelte';
-export { default as Skeleton } from './Skeleton/Skeleton.svelte';
-export { default as Slider } from './Slider/Slider.svelte';
-export { default as Stat } from './Stat/Stat.svelte';
-export { default as StatGroup } from './Stat/StatGroup.svelte';
-export { default as TechText } from './TechText/TechText.svelte';
-export { default as VirtualList } from './VirtualList/VirtualList.svelte';
+export {
+    /**
+     * Input with associated increment/decrement controls
+     */
+    default as ComboControl,
+} from './ComboControl/ComboControl.svelte';
+export {
+    /**
+     * Rich text input using contenteditable attribute
+     */
+    default as ContentEditable,
+} from './ContentEditable/ContentEditable.svelte';
+export {
+    /**
+     * Semantic grouping for related UI controls
+     */
+    default as ControlGroup,
+} from './ControlGroup/ControlGroup.svelte';
+export {
+    /**
+     * Simple horizontal line separator
+     */
+    default as Divider,
+} from './Divider/Divider.svelte';
+export {
+    /**
+     * Filterable property set with selection logic
+     */
+    default as FilterGroup,
+} from './FilterGroup/FilterGroup.svelte';
+export {
+    /**
+     * Small text for secondary meta-information
+     */
+    default as Footnote,
+} from './Footnote/Footnote.svelte';
+export {
+    /**
+     * Design-system standard text input
+     */
+    default as Input,
+} from './Input/Input.svelte';
+export {
+    /**
+     * Text label for input fields
+     */
+    default as Label,
+} from './Label/Label.svelte';
+export {
+    /**
+     * Full-page or component-level progress spinner
+     */
+    default as Loader,
+} from './Loader/Loader.svelte';
+export {
+    /**
+     * Main application logo
+     */
+    default as Logo,
+} from './Logo/Logo.svelte';
+export {
+    /**
+     * 3D perspective background/container
+     */
+    default as PerspectivePlan,
+} from './PerspectivePlan/PerspectivePlan.svelte';
+export {
+    /**
+     * Specialized input with search icon and clear state
+     */
+    default as SearchBar,
+} from './SearchBar/SearchBar.svelte';
+export {
+    /**
+     * Content section with header and optional title tracking
+     */
+    default as Section,
+} from './Section/Section.svelte';
+export {
+    /**
+     * Callback for section visibility status changes
+     */
+    type TitleStatusChangeHandler,
+} from './Section/types';
+export {
+    /**
+     * Structural sidebar component
+     */
+    default as SidebarContainer,
+} from './SidebarContainer/SidebarContainer.svelte';
+export {
+    /**
+     * Loading placeholder with pulsing animation
+     */
+    default as Skeleton,
+} from './Skeleton/Skeleton.svelte';
+export {
+    /**
+     * Range selector with numeric feedback
+     */
+    default as Slider,
+} from './Slider/Slider.svelte';
+export {
+    /**
+     * Individual numeric statistic display
+     */
+    default as Stat,
+} from './Stat/Stat.svelte';
+export {
+    /**
+     * Grouping for multiple statistics
+     */
+    default as StatGroup,
+} from './Stat/StatGroup.svelte';
+export {
+    /**
+     * Mono-spaced technical/metadata text
+     */
+    default as TechText,
+} from './TechText/TechText.svelte';
+export {
+    /**
+     * High-performance list renderer for large datasets
+     */
+    default as VirtualList,
+} from './VirtualList/VirtualList.svelte';