chore: follow the general comments style

src/shared/lib/helpers/createTypographyControl/createTypographyControl.svelte.ts

@@ -34,13 +34,21 @@ import {
  * Defines the bounds and stepping behavior for a control
  */
 export interface ControlDataModel {
-    /** Current numeric value */
+    /**
+     * Initial or current numeric value
+     */
     value: number;
-    /** Minimum allowed value (inclusive) */
+    /**
+     * Lower inclusive bound
+     */
     min: number;
-    /** Maximum allowed value (inclusive) */
+    /**
+     * Upper inclusive bound
+     */
     max: number;
-    /** Step size for increment/decrement operations */
+    /**
+     * Precision for increment/decrement operations
+     */
     step: number;
 }
 
@@ -50,13 +58,21 @@ export interface ControlDataModel {
  * @template T - Type for the control identifier
  */
 export interface ControlModel<T extends string = string> extends ControlDataModel {
-    /** Unique identifier for the control */
+    /**
+     * Unique string identifier for the control
+     */
     id: T;
-    /** ARIA label for the increase button */
+    /**
+     * Label used by screen readers for the increase button
+     */
     increaseLabel?: string;
-    /** ARIA label for the decrease button */
+    /**
+     * Label used by screen readers for the decrease button
+     */
     decreaseLabel?: string;
-    /** ARIA label for the control area */
+    /**
+     * Overall label describing the control's purpose
+     */
     controlLabel?: string;
 }
 
@@ -109,8 +125,7 @@ export function createTypographyControl<T extends ControlDataModel>(
 
     return {
         /**
-         * Current control value (getter/setter)
-         * Setting automatically clamps to bounds and rounds to step precision
+         * Clamped and rounded control value (reactive)
          */
         get value() {
             return value;
@@ -122,27 +137,37 @@ export function createTypographyControl<T extends ControlDataModel>(
             }
         },
 
-        /** Maximum allowed value */
+        /**
+         * Upper limit for the control value
+         */
         get max() {
             return max;
         },
 
-        /** Minimum allowed value */
+        /**
+         * Lower limit for the control value
+         */
         get min() {
             return min;
         },
 
-        /** Step increment size */
+        /**
+         * Configured step increment
+         */
         get step() {
             return step;
         },
 
-        /** Whether the value is at or exceeds the maximum */
+        /**
+         * True if current value is equal to or greater than max
+         */
         get isAtMax() {
             return isAtMax;
         },
 
-        /** Whether the value is at or below the minimum */
+        /**
+         * True if current value is equal to or less than min
+         */
         get isAtMin() {
             return isAtMin;
         },