gears: added package with set of gears for compose

config/detekt/detekt.yml

@@ -433,6 +433,7 @@ naming:
     active: true
     excludes: ['**/test/**', '**/androidTest/**', '**/commonTest/**', '**/jvmTest/**', '**/jsTest/**', '**/iosTest/**']
     functionPattern: '([a-z][a-zA-Z0-9]*)|(`.*`)'
+    ignoreAnnotated: ['Composable']
     excludeClassPattern: '$^'
   FunctionParameterNaming:
     active: true

gears/build.gradle.kts

@@ -0,0 +1,3 @@
+// For some reason gradle.properties in this project doesn't affect its subprojects
+val gearsGroup = group
+subprojects { group = gearsGroup }

gears/compose/CHANGELOG.md

@@ -0,0 +1,7 @@
+## Unreleased
+
+### Changed
+
+- Create gears.compose
+  added:
+  - `FixedFontScaleContainer` - A container that fixes the font scale, ignoring values, that are set in the phone's system settings

gears/compose/README.md

@@ -0,0 +1,44 @@
+# compose-ktx <GitHub path="RedMadRobot/redmadrobot-android-ktx/tree/main/compose-ktx"/>
+[![Version](https://img.shields.io/maven-central/v/com.redmadrobot.extensions/compose-ktx?style=flat-square)][mavenCentral]
+[![License](https://img.shields.io/github/license/RedMadRobot/redmadrobot-android-ktx?style=flat-square)][license]
+
+---
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [Contributing](#contributing)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+A set of gears for compose.
+
+## Installation
+
+Add the dependency:
+```groovy
+repositories {
+    mavenCentral()
+    google()
+}
+
+dependencies {
+    implementation("com.redmadrobot.gears:compose:<version>")
+}
+```
+
+## Usage
+
+|      Gear       | Description |
+|:--------------------|:-----------|
+| `FixedFontScaleContainer` | A container that fixes the font scale, ignoring values, that are set in the phone's system settings |
+
+## Contributing
+
+Merge requests are welcome.
+For major changes, please open an issue first to discuss what you would like to change.
+
+
+[mavenCentral]: https://search.maven.org/artifact/com.redmadrobot.extensions/compose-ktx
+[license]: ../LICENSE

gears/compose/build.gradle.kts

@@ -0,0 +1,29 @@
+plugins {
+    id("com.redmadrobot.android-library")
+    id("com.redmadrobot.publish")
+    convention.library.android
+}
+
+version = "1.6.6-0"
+description = "A set of gears for compose"
+
+redmadrobot {
+    android.minSdk = 21
+}
+
+android {
+    namespace = "$group.compose"
+
+    buildFeatures {
+        compose = true
+    }
+
+    composeOptions {
+        kotlinCompilerExtensionVersion = androidx.versions.compose.compiler.get()
+    }
+}
+
+dependencies {
+    api(androidx.compose.ui)
+    api(androidx.compose.runtime)
+}

gears/compose/src/main/kotlin/FixedFontScaleContainer.kt

@@ -0,0 +1,43 @@
+package com.redmadrobot.extensions.compose
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.ui.platform.LocalDensity
+import androidx.compose.ui.unit.Density
+
+/**
+ * A container that fixes the font scale, ignoring values,
+ * that are set in the phone's system settings
+ */
+@Composable
+public fun FixedFontScaleContainer(
+    content: @Composable () -> Unit,
+) {
+    val fixedFontScaleDensity = Density(LocalDensity.current.density)
+    CompositionLocalProvider(
+        LocalDensity provides fixedFontScaleDensity,
+        content = content,
+    )
+}
+
+/**
+ * A container that restricts the font scale, ignoring values,
+ * that are set in the phone's system settings
+ *
+ * @param limit - the upper limit of font enlargement
+ */
+@Composable
+public fun LimitedFontScaleContainer(
+    limit: Float,
+    content: @Composable () -> Unit,
+) {
+    val fontScale = LocalDensity.current.fontScale.coerceAtMost(limit)
+    val fixedFontScaleDensity = Density(
+        density = LocalDensity.current.density,
+        fontScale = fontScale,
+    )
+    CompositionLocalProvider(
+        LocalDensity provides fixedFontScaleDensity,
+        content = content,
+    )
+}

gears/gradle.properties

@@ -0,0 +1 @@
+group=com.redmadrobot.gears

settings.gradle.kts

@@ -34,4 +34,5 @@ include(
     ":ktx:lifecycle-livedata-ktx",
     ":ktx:resources-ktx",
     ":ktx:viewbinding-ktx",
+    ":gears:compose",
 )