chore: follow the general comments style

src/shared/ui/Input/config.ts

@@ -3,7 +3,9 @@ import type {
     InputVariant,
 } from './types';
 
-/** Size-specific layout classes: padding, text size, height, and clear-icon pixel size. */
+/**
+ * Size-specific layout classes: padding, text size, height, and clear-icon pixel size.
+ */
 export const inputSizeConfig: Record<InputSize, { input: string; text: string; height: string; clearIcon: number }> = {
     sm: { input: 'px-3 py-1.5', text: 'text-sm', height: 'h-8', clearIcon: 12 },
     md: { input: 'px-4 py-2', text: 'text-base', height: 'h-10', clearIcon: 14 },
@@ -11,7 +13,9 @@ export const inputSizeConfig: Record<InputSize, { input: string; text: string; h
     xl: { input: 'px-4 py-3', text: 'text-xl md:text-2xl', height: 'h-14', clearIcon: 18 },
 };
 
-/** Variant-specific classes: base background/border, focus ring, and error state. */
+/**
+ * Variant-specific classes: base background/border, focus ring, and error state.
+ */
 export const inputVariantConfig: Record<InputVariant, { base: string; focus: string; error: string }> = {
     default: {
         base: 'bg-paper dark:bg-paper border border-subtle',

src/shared/ui/Input/types.ts

@@ -1,6 +1,8 @@
 export type InputVariant = 'default' | 'underline' | 'filled';
 export type InputSize = 'sm' | 'md' | 'lg' | 'xl';
-/** Convenience map for consumers sizing icons to match the input. */
+/**
+ * Convenience map for consumers sizing icons to match the input.
+ */
 export const inputIconSize: Record<InputSize, number> = {
     sm: 14,
     md: 16,

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';