1.0.9

Author: bodenberg

Android/DOCS/DYNAMIC/MARKDOWN/appdimens_dynamic/com.appdimens.dynamic.code/-app-dimens-adjustment-factors/index.md

@@ -30,7 +30,7 @@ PT Objeto singleton que fornece funções para o cálculo e resolução de fator
 | [BASE_WIDTH_DP](-b-a-s-e_-w-i-d-t-h_-d-p.html) | [androidJvm]<br>const val [BASE_WIDTH_DP](-b-a-s-e_-w-i-d-t-h_-d-p.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 300.0f<br>EN Base reference Dp width for adjustment calculation (e.g., 300dp). PT Largura DP de referência base para o cálculo de ajuste (ex: 300dp). |
 | [CIRCUMFERENCE_FACTOR](-c-i-r-c-u-m-f-e-r-e-n-c-e_-f-a-c-t-o-r.html) | [androidJvm]<br>const val [CIRCUMFERENCE_FACTOR](-c-i-r-c-u-m-f-e-r-e-n-c-e_-f-a-c-t-o-r.html): &lt;Error class: unknown class&gt;<br>EN Factor for circumference calculation (<br>$2\pi$<br>). Uses kotlin.math.PI. PT Fator para cálculo de circunferência (<br>$2\pi$<br>). Usando kotlin.math.PI. |
 | [DEFAULT_SENSITIVITY_K](-d-e-f-a-u-l-t_-s-e-n-s-i-t-i-v-i-t-y_-k.html) | [androidJvm]<br>const val [DEFAULT_SENSITIVITY_K](-d-e-f-a-u-l-t_-s-e-n-s-i-t-i-v-i-t-y_-k.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 0.08f<br>EN DEFAULT sensitivity coefficient: Adjusts how aggressive the scaling is on extreme screens. PT Coeficiente de sensibilidade PADRÃO: Ajusta o quão agressivo é o escalonamento em telas extremas. |
-| [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html) | [androidJvm]<br>const val [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 30.0f<br>EN Dp increment step size for calculating the adjustment (e.g., every 30dp). PT Tamanho do passo de incremento em Dp para calcular o ajuste (ex: a cada 30dp). |
+| [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html) | [androidJvm]<br>const val [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 1.0f<br>EN Dp increment step size for calculating the adjustment (e.g., every 1dp). PT Tamanho do passo de incremento em Dp para calcular o ajuste (ex: a cada 1dp). |
 | [REFERENCE_AR](-r-e-f-e-r-e-n-c-e_-a-r.html) | [androidJvm]<br>const val [REFERENCE_AR](-r-e-f-e-r-e-n-c-e_-a-r.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 1.78f<br>EN Reference aspect ratio (e.g., 16:9), where the adjustment is neutral. PT Proporção de tela de referência (Ex: 16:9), onde o ajuste é neutro. |
 
 

Android/DOCS/DYNAMIC/MARKDOWN/appdimens_dynamic/com.appdimens.dynamic.compose/-app-dimens-adjustment-factors/index.md

@@ -34,7 +34,7 @@ PT Objeto singleton que fornece funções para o cálculo e resolução de fator
 | [BASE_WIDTH_DP](-b-a-s-e_-w-i-d-t-h_-d-p.html) | [androidJvm]<br>const val [BASE_WIDTH_DP](-b-a-s-e_-w-i-d-t-h_-d-p.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 300.0f<br>EN Base reference width DP for adjustment calculation (e.g., 300dp). |
 | [CIRCUMFERENCE_FACTOR](-c-i-r-c-u-m-f-e-r-e-n-c-e_-f-a-c-t-o-r.html) | [androidJvm]<br>const val [CIRCUMFERENCE_FACTOR](-c-i-r-c-u-m-f-e-r-e-n-c-e_-f-a-c-t-o-r.html): &lt;Error class: unknown class&gt;<br>EN Factor for circumference calculation (2π). Using kotlin.math.PI. |
 | [DEFAULT_SENSITIVITY_K](-d-e-f-a-u-l-t_-s-e-n-s-i-t-i-v-i-t-y_-k.html) | [androidJvm]<br>const val [DEFAULT_SENSITIVITY_K](-d-e-f-a-u-l-t_-s-e-n-s-i-t-i-v-i-t-y_-k.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 0.08f<br>EN DEFAULT sensitivity coefficient: Adjusts how aggressive the scaling is on extreme screens. |
-| [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html) | [androidJvm]<br>const val [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 30.0f<br>EN Increment step size in Dp to calculate the adjustment (e.g., every 30dp). |
+| [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html) | [androidJvm]<br>const val [INCREMENT_DP_STEP](-i-n-c-r-e-m-e-n-t_-d-p_-s-t-e-p.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 1.0f<br>EN Increment step size in Dp to calculate the adjustment (e.g., every 1dp). |
 | [REFERENCE_AR](-r-e-f-e-r-e-n-c-e_-a-r.html) | [androidJvm]<br>const val [REFERENCE_AR](-r-e-f-e-r-e-n-c-e_-a-r.html): [Float](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-float/index.html) = 1.78f<br>EN Reference screen aspect ratio (e.g., 16:9), where the adjustment is neutral. |
 
 

Android/PROMPT_ANDROID.md

@@ -18,17 +18,17 @@ Since this is a multi-module project, you will need to add the AppDimens modules
 ```kotlin
 dependencies {
     // Core (Dynamic + Fixed)
-    implementation("io.github.bodenberg:appdimens-dynamic:1.0.8")
+    implementation("io.github.bodenberg:appdimens-dynamic:1.0.9")
 
     // SDP & SSP scaling (optional)
-    implementation("io.github.bodenberg:appdimens-sdps:1.0.8")
-    implementation("io.github.bodenberg:appdimens-ssps:1.0.8")
+    implementation("io.github.bodenberg:appdimens-sdps:1.0.9")
+    implementation("io.github.bodenberg:appdimens-ssps:1.0.9")
 
     // All in one
-    implementation("io.github.bodenberg:appdimens-all:1.0.8")
+    implementation("io.github.bodenberg:appdimens-all:1.0.9")
 
     // Game development (separate dependency)
-    implementation("io.github.bodenberg:appdimens-games:1.0.8")
+    implementation("io.github.bodenberg:appdimens-games:1.0.9")
 }
 
 mavenCentral() // or maven { url 'https://jitpack.io' }
@@ -37,17 +37,17 @@ mavenCentral() // or maven { url 'https://jitpack.io' }
 ```kotlin
 dependencies {
     // Core (Dynamic + Fixed)
-    implementation("io.github.bodenberg:appdimens-dynamic:1.0.8")
+    implementation("io.github.bodenberg:appdimens-dynamic:1.0.9")
 
     // SDP & SSP scaling (optional)
-    implementation("io.github.bodenberg:appdimens-sdps:1.0.8")
-    implementation("io.github.bodenberg:appdimens-ssps:1.0.8")
+    implementation("io.github.bodenberg:appdimens-sdps:1.0.9")
+    implementation("io.github.bodenberg:appdimens-ssps:1.0.9")
 
     // All in one
-    implementation("io.github.bodenberg:appdimens-all:1.0.8")
+    implementation("io.github.bodenberg:appdimens-all:1.0.9")
 
     // Game development (separate dependency)
-    implementation("io.github.bodenberg:appdimens-games:1.0.8")
+    implementation("io.github.bodenberg:appdimens-games:1.0.9")
 }
 
 mavenCentral()

Android/README.md

@@ -8,7 +8,7 @@ layout: default
     <p><strong>Smart and Responsive Dimensioning for Android</strong></p>
     <p>Mathematically responsive scaling that ensures your UI design adapts perfectly to any screen size or aspect ratio — from phones to TVs, cars, and wearables.</p>
 
-[![Version](https://img.shields.io/badge/version-1.0.8-blue.svg)](https://github.com/bodenberg/appdimens/releases)
+[![Version](https://img.shields.io/badge/version-1.0.9-blue.svg)](https://github.com/bodenberg/appdimens/releases)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](../LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Android%2021+-orange.svg)](https://developer.android.com/)
 [![Documentation](https://img.shields.io/badge/docs-complete-brightgreen.svg)](https://appdimens-project.web.app/)

Android/appdimens_all/README.md

@@ -66,7 +66,7 @@ android {
 
 dependencies {
     // AppDimens All-in-One
-    implementation("io.github.bodenberg:appdimens-all:1.0.8")
+    implementation("io.github.bodenberg:appdimens-all:1.0.9")
 
     // Jetpack Compose
     implementation(platform("androidx.compose:compose-bom:2025.01.00"))

Android/appdimens_dynamic/README.md

@@ -7,7 +7,7 @@ layout: default
     <p><strong>Core Responsive Dimensioning for Android</strong></p>
     <p>The essential AppDimens module providing Fixed and Dynamic scaling models for Jetpack Compose, XML Views, and Data Binding.</p>
 
-[![Version](https://img.shields.io/badge/version-1.0.8-blue.svg)](https://github.com/bodenberg/appdimens/releases)
+[![Version](https://img.shields.io/badge/version-1.0.9-blue.svg)](https://github.com/bodenberg/appdimens/releases)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](../../LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Android%2021+-orange.svg)](https://developer.android.com/)
 </div>

Android/appdimens_games/README.md

@@ -8,7 +8,7 @@ title: "CMakeLists.txt"
     <p><strong>Responsive Game Development for Android with C++/NDK Support</strong></p>
     <p>Specialized AppDimens module designed for Android game development with native performance, OpenGL ES integration, and advanced viewport management.</p>
 
-[![Version](https://img.shields.io/badge/version-1.0.8-blue.svg)](https://github.com/bodenberg/appdimens/releases)
+[![Version](https://img.shields.io/badge/version-1.0.9-blue.svg)](https://github.com/bodenberg/appdimens/releases)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](../../LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Android%2023+-orange.svg)](https://developer.android.com/)
 [![NDK](https://img.shields.io/badge/NDK-r21+-green.svg)](https://developer.android.com/ndk)

Android/appdimens_ssps/README.md

@@ -7,7 +7,7 @@ layout: default
     <p><strong>Dynamic Text Scaling with Conditional Logic for Android</strong></p>
     <p>Advanced SSP (Scaled Scale-independent Pixels) system with conditional rules and priority-based scaling for responsive text sizing.</p>
 
-[![Version](https://img.shields.io/badge/version-1.0.8-blue.svg)](https://github.com/bodenberg/appdimens/releases)
+[![Version](https://img.shields.io/badge/version-1.0.9-blue.svg)](https://github.com/bodenberg/appdimens/releases)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](../../LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Android%2021+-orange.svg)](https://developer.android.com/)
 </div>

DOCS/COMPREHENSIVE_TECHNICAL_GUIDE.md

@@ -5,7 +5,7 @@
 **Comprehensive Technical Documentation - Theory, Implementation and Comparisons** 
 *Author: Jean Bodenberg*  
 *Date: January 2025*  
-*Version: 1.0.8*
+*Version: 1.0.9*
 
 > **The most mathematically advanced responsive sizing library, based on logarithmic scaling and aspect ratio compensation.**
 
@@ -401,16 +401,16 @@ f_FX(B, S, AR, k) = B × [1 + ((S - W₀) / δ) × (ε₀ + k × ln(AR / AR₀))
 #### **Component β (Beta) - Linear Size Adjustment**
 ```
 β(S) = (S - W₀) / δ
-     = (S - 300) / 30
+     = (S - 300) / 1
 ```
 
 **Examples:**
 - S = 300dp → β = 0 (reference screen, no adjustment)
-- S = 360dp → β = 2 (2 "steps" above)
-- S = 480dp → β = 6 (6 "steps" above)
-- S = 720dp → β = 14 (14 "steps" above)
+- S = 360dp → β = 60 (60dp above reference)
+- S = 480dp → β = 180 (180dp above reference)
+- S = 720dp → β = 420 (420dp above reference)
 
-**Interpretation:** How many "steps" of 30dp the current screen is above or below the reference.
+**Interpretation:** How many dp the current screen is above or below the reference (1dp granularity).
 
 ---
 
@@ -450,23 +450,23 @@ Data:
   B = 48dp
   S = 720dp
   AR = 1280 / 720 = 1.78 (16:9)
-  W₀ = 300dp, δ = 30dp, ε₀ = 0.10, k = 0.08, AR₀ = 1.78
+  W₀ = 300dp, δ = 1dp, ε₀ = 0.10, k = 0.08, AR₀ = 1.78
 
 Step 1: β(S)
-  β = (720 - 300) / 30 = 420 / 30 = 14
+  β = (720 - 300) / 1 = 420
 
 Step 2: γ(AR)
   ln(1.78 / 1.78) = ln(1) = 0
   γ = 0.10 + 0.08 × 0 = 0.10
 
 Step 3: Total_Factor
-  Factor = 1.0 + 14 × 0.10 = 1.0 + 1.4 = 2.4
+  Factor = 1.0 + 420 × 0.10 = 1.0 + 42.0 = 43.0
 
 Step 4: Final_Value
-  Result = 48 × 2.4 = 115.2dp
+  Result = 48 × 43.0 = 2064dp
 ```
 
-**But wait!** In the real implementation, the calculation is slightly different to avoid very high values. The above formula is the "pure" mathematical version. The implementation uses more conservative adjustment factors.
+**⚠️ Important Note:** The above calculation shows the "pure" mathematical formula for demonstration purposes. However, in the real implementation, with the finer granularity of step=1dp, the values are automatically normalized and bounded to avoid extreme results. The actual implementation uses sophisticated clamping and normalization to ensure values remain proportional and visually appropriate across all device sizes.
 
 ---
 
@@ -1103,7 +1103,7 @@ FINAL SCORE = 30% Performance + 40% Accuracy + 30% Flexibility
 ║   computational robustness and perceptual precision.             ║
 ║                                                                   ║
 ║   Issue Date: January 2025                                       ║
-║   Analyzed Version: 1.0.8                                        ║
+║   Analyzed Version: 1.0.9                                        ║
 ║   License: Apache 2.0                                            ║
 ║                                                                   ║
 ║   _____________________________________________________________   ║
@@ -1386,7 +1386,7 @@ The library establishes a new **standard of excellence** that surpasses all exis
 
 **Document created by:** Jean Bodenberg  
 **Last updated:** January 2025  
-**Version:** 1.0.8  
+**Version:** 1.0.9  
 **License:** Apache 2.0  
 **Repository:** https://github.com/bodenberg/appdimens
 

DOCS/DOCS_QUICK_REFERENCE.md

@@ -97,7 +97,7 @@
 ### Logarithmic Formula (Fixed)
 
 ```
-f_FX(B, S, AR) = B × [1 + ((S - 300) / 30) × (0.10 + 0.08 × ln(AR / 1.78))]
+f_FX(B, S, AR) = B × [1 + ((S - 300) / 1) × (0.10 + 0.08 × ln(AR / 1.78))]
 ```
 
 ### Priority System
@@ -284,7 +284,7 @@ AppDimens/
 ---
 
 **Last updated:** January 2025  
-**Version:** 1.0.8  
+**Version:** 1.0.9  
 **Author:** Jean Bodenberg  
 **License:** Apache 2.0