Version 6

.gitattributes

@@ -0,0 +1 @@
+**/snapshots/**/*.png filter=lfs diff=lfs merge=lfs -text

.github/workflows/build.yml

@@ -13,6 +13,6 @@ jobs:
       - name: set up JDK
         uses: actions/setup-java@v1
         with:
-          java-version: 11
+          java-version: 17
       - name: Build with Gradle
         run: ./gradlew check --stacktrace

.github/workflows/pull-request.yml

@@ -12,6 +12,6 @@ jobs:
       - name: set up JDK
         uses: actions/setup-java@v1
         with:
-          java-version: 11
+          java-version: 17
       - name: Build with Gradle
         run: ./gradlew check --stacktrace

.gitignore

@@ -6,3 +6,5 @@
 **/build
 /captures
 .externalNativeBuild
+
+/.maven

.run/sample.run.xml

@@ -10,11 +10,12 @@
     <option name="ALWAYS_INSTALL_WITH_PM" value="false" />
     <option name="CLEAR_APP_STORAGE" value="false" />
     <option name="DYNAMIC_FEATURES_DISABLED_LIST" value="" />
-    <option name="ACTIVITY_EXTRA_FLAGS" value="--es aid &quot;20230715105856&quot;" />
+    <option name="ACTIVITY_EXTRA_FLAGS" value="--es aid &quot;20241211001529&quot;" />
     <option name="MODE" value="default_activity" />
+    <option name="RESTORE_ENABLED" value="false" />
+    <option name="RESTORE_FILE" value="" />
     <option name="CLEAR_LOGCAT" value="false" />
     <option name="SHOW_LOGCAT_AUTOMATICALLY" value="false" />
-    <option name="INSPECTION_WITHOUT_ACTIVITY_RESTART" value="false" />
     <option name="TARGET_SELECTION_MODE" value="DEVICE_AND_SNAPSHOT_COMBO_BOX" />
     <option name="SELECTED_CLOUD_MATRIX_CONFIGURATION_ID" value="-1" />
     <option name="SELECTED_CLOUD_MATRIX_PROJECT_ID" value="" />
@@ -25,21 +26,30 @@
       <option name="WORKING_DIR" value="" />
       <option name="TARGET_LOGGING_CHANNELS" value="lldb process:gdb-remote packets" />
       <option name="SHOW_OPTIMIZED_WARNING" value="true" />
+      <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+      <option name="DEBUG_SANDBOX_SDK" value="false" />
     </Auto>
     <Hybrid>
       <option name="USE_JAVA_AWARE_DEBUGGER" value="false" />
       <option name="SHOW_STATIC_VARS" value="true" />
       <option name="WORKING_DIR" value="" />
       <option name="TARGET_LOGGING_CHANNELS" value="lldb process:gdb-remote packets" />
       <option name="SHOW_OPTIMIZED_WARNING" value="true" />
+      <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+      <option name="DEBUG_SANDBOX_SDK" value="false" />
     </Hybrid>
-    <Java />
+    <Java>
+      <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+      <option name="DEBUG_SANDBOX_SDK" value="false" />
+    </Java>
     <Native>
       <option name="USE_JAVA_AWARE_DEBUGGER" value="false" />
       <option name="SHOW_STATIC_VARS" value="true" />
       <option name="WORKING_DIR" value="" />
       <option name="TARGET_LOGGING_CHANNELS" value="lldb process:gdb-remote packets" />
       <option name="SHOW_OPTIMIZED_WARNING" value="true" />
+      <option name="ATTACH_ON_WAIT_FOR_DEBUGGER" value="false" />
+      <option name="DEBUG_SANDBOX_SDK" value="false" />
     </Native>
     <Profilers>
       <option name="ADVANCED_PROFILING_ENABLED" value="false" />
@@ -48,7 +58,6 @@
       <option name="STARTUP_CPU_PROFILING_CONFIGURATION_NAME" value="Callstack Sample" />
       <option name="STARTUP_NATIVE_MEMORY_PROFILING_ENABLED" value="false" />
       <option name="NATIVE_MEMORY_SAMPLE_RATE_BYTES" value="2048" />
-      <option name="PROFILING_MODE" value="NOT_SET" />
     </Profilers>
     <option name="DEEP_LINK" value="" />
     <option name="ACTIVITY_CLASS" value="" />

CHANGELOG.md

@@ -1,5 +1,133 @@
 # Changelog
 
+# 5.1
+### Added
+* new \[`adapt-kt`] kotlin module (includes `AdaptGetter`, sample:`AdaptGetterSample`)
+* \[`adapt-ui`] `App`, `Colors`, `Dimens`, `Strings`, `ViewStyles`, `TextSizes`, `TextStyles`
+* \[`adapt-ui`] `ViewElement.backgroundColor`, `ViewElement.backgroundGradient`, `ViewElement.foregroundColor` builders:
+   ```kotlin
+   Text()
+     .backgroundColor { primary }
+     .backgroundGradient { 
+        linear {
+           edges { top to bottom }
+             .setColors(orange, primary, accent) 
+        } 
+     }
+     .foregroundColor { accent }
+   ```
+* \[`adapt-ui`] `ViewElement.elevation`:
+   ```kotlin
+   Text().elevation { barElevation }
+   ```
+* \[`adapt-ui`] `ViewElement.overScrollMode`:
+  ```kotlin
+  Text()
+    .overScrollMode { ifContentScrolls }
+  ```
+* \[`adapt-ui`] `ViewElement.scrollBarStyle`:
+  ```kotlin
+  Text().scrollBarStyle { outsideOverlay }
+  ```
+* \[`adapt-ui`] `ViewElement.scrollBarsEnabled`
+* \[`adapt-ui`] `ViewElement.requestFocus`
+* \[`adapt-ui`] accessibility:
+  ```kotlin
+  Text()
+    .accessibilityImportant { yes }
+    .accessibilityLiveRegion { polite }
+  ```
+* \[`adapt-ui`] `Image.imageScaleType`, `Image.imageTint`:
+  ```kotlin
+  Image()
+    .imageScaleType { fitCenter }
+    .imageTint { accent }
+  ```
+* \[`adapt-ui`] `stackGravity` for `HStack`, `VStack`:
+  ```kotlin
+  VStack {}.stackGravity { center.horizontal }
+  HStack {}.stackGravity { top.leading }
+  ```
+* \[`adapt-ui`] `Text`:
+  ```kotlin
+  Text()
+    .textEllipsize { end }
+    .textHyphenationFrequency { normal }
+    .textBreakStrategy { simple }
+    .textJustificationMode { interWord }
+    .textInputType { text.capWords }
+    .textImeOptions { noFullScreen.noExtractUi.actionUnspecified }
+  ```
+* \[`adapt-ui`] `ViewElement.onViewStateChange`:
+  ```kotlin
+  Text()
+    .onViewStateChange { view, viewState ->
+       val y = if (viewState.isPressed) -2 else 0
+       view.translationY = y.dip.toFloat()
+    }
+  ```
+* \[`adapt-ui`] `VStackContentMeasuredLast` element and `LinearLayoutContentMeasuredLast` widget
+* \[`adapt-ui`] `VStackReverseDrawingOrder` element and `LinearLayoutReverseDrawingOrder` widget
+* \[`adapt-ui`] `ZStackSquare` element and `SquareFrameLayout` widget
+* \[`adapt-ui`] `ZStackWrapHeightOrScroll` element and `FrameLayoutWrapHeightOrScroll` widget
+* \[`adapt-ui`] `Grid` element and `GridLayout` widget
+* \[`adapt-ui`] `Web` element to build `WebView`
+* \[`adapt-ui`] `ElementItem.onRefReady`
+* \[`adapt-ui`] `PreviewViewCustomization` to customize how view is drawn in layout-preview pane
+* \[`adapt-ui`] `ColorStateListFactory`, `DrawableStateListFactory`, `ShapeStateListFactory` along with state builders:
+  ```kotlin
+  Text()
+    .backgroundWithState {
+      activated = Rectangle()
+      default = Circle()
+    }
+    .backgroundColorWithState {
+      activated.enabled = accent
+      default = black
+    }
+    // in similar way:
+    .foregroundWithState {}
+    .foregroundColorWithState {}
+    // Text
+    .textColorWithState {}
+
+  Image()
+    .imageTintWithState {}
+  ```
+* \[`adapt-ui`] `ViewState` to replace `DrawableState`, unified semantics for color, drawable, shape builder with state
+* \[`adapt-ui`] `PorterDuffModeFactory` to create `PorterDuff.Mode`
+* \[`adapt-ui-flex`] - element configurations:
+   ```kotlin
+   Flex {
+     View()
+       .layoutFlexAlignSelf { stretch }
+   }.indent()
+     .flexDirection { row }
+     .flexWrap { wrap }
+     .flexJustifyContent { center }
+     .flexAlignItems { center }
+     .flexAlignContent { center }
+   ```
+
+### Changed
+* `AdaptViewGroup`, if configured `Adapt` is empty then supporting `viewGroup` 
+   visibility will be set to `View.GONE` automatically. Configure `AdaptViewGroup.Configuration`
+   with `hideIfEmpty(false)` to disable 
+* `ViewGroup.addOnHierarchyChangeListener` utility to register multiple `OnHierarchyChangeListener`
+* `View.addOnFocusChangedListener` utility to register multiple `OnFocusChangedListener`
+* `ViewFlag` utility
+* \[`adapt-ui-flex`] `Flex`element is using `wrap` for flex-wrap by default
+
+### Deprecated
+* \[`adapt-ui`] `ViewFactoryConstants` `FILL` and `WRAP` to lowercase: `fill` and `wrap`:
+  ```kotlin
+  Text().layout(fill, wrap)
+  ```
+* `DrawableState` is deprecated in favor of `ViewState`
+* `io.noties.adapt.ui.util.ColorStateListBuilder` is deprecated in favor of `io.noties.adapt.ui.state.ColorStateListFactory`
+* \[`adapt-ui`] `ViewElement.background(color: Int)` in favor of `ViewElement.backgroundColor(color: Int)`
+
+
 # 5.0.0
 ### Changed
 * `Text`: `.textFont` => `.textTypeface`

LIVE_TEMPLATES.md

@@ -15,7 +15,7 @@ class $SAMPLE_NAME$: io.noties.adapt.sample.samples.adaptui.AdaptUISampleView()
     }
 }
 
-@io.noties.adapt.sample.util.Preview
+@io.noties.adapt.preview.Preview
 @Suppress("ClassName", "unused")
 private class Preview__$SAMPLE_NAME$(
     context: android.content.Context,