Trigger workflow

.github/workflows/develop.yml

@@ -0,0 +1,69 @@
+name: Run the documentation generation tool and push changes to develop branch
+
+on:
+  push:
+    branches: [ "develop" ]
+
+permissions:
+  contents: write
+
+env:
+  SLN_FILE_PATH: 'HorusStudio.Maui.MaterialDesignControls.sln'
+  CSPROJ_FILE_PATH: 'src/HorusStudio.Maui.MaterialDesignControls/HorusStudio.Maui.MaterialDesignControls.csproj'
+  MATERIALDESIGNCONTROLS_DLL_FILE_PATH: 'src/HorusStudio.Maui.MaterialDesignControls/bin/Release/net9.0-android/HorusStudio.Maui.MaterialDesignControls.dll'
+  XMLDOC2MARKDOWN_FILE_PATH: 'tools/XMLDoc2Markdown/XMLDoc2Markdown.dll'
+  DOCUMENTATION_OUTPUT_PATH: 'docs'
+
+jobs:
+  build:
+    runs-on: macos-latest
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: '9.0.x'
+        include-prerelease: true
+
+    - name: Install MAUI workloads
+      run: |
+        echo "📦 Installing MAUI workloads..."
+        dotnet workload install maui
+        dotnet workload restore
+        echo "✅ MAUI workloads installed successfully!"
+
+    - name: Restore dependencies
+      run: |
+        echo "📦 Restoring dependencies..."
+        dotnet restore ${{ env.SLN_FILE_PATH }}
+        echo "✅ Dependencies restored successfully!"
+
+    - name: Build solution
+      run: |
+        echo "📦 Building solution..."
+        dotnet build ${{ env.CSPROJ_FILE_PATH }} -c Release --no-restore
+        echo "✅ Solution built successfully!"
+
+    - name: Unzip the documentation generation tool
+      run: |
+        echo "📦 Unzipping the documentation generation tool..."
+        unzip tools/XMLDoc2Markdown.zip -d tools/
+        echo "✅ Documentation generation tool unzipped successfully!"
+
+    - name: Run the documentation generation tool
+      run: |
+       echo "📦 Running the documentation generation tool..."
+       dotnet ${{ env.XMLDOC2MARKDOWN_FILE_PATH }} ${{ env.MATERIALDESIGNCONTROLS_DLL_FILE_PATH }} ${{ env.DOCUMENTATION_OUTPUT_PATH }} --exclude-class-static="HorusStudio.Maui.MaterialDesignControls.MaterialLightTheme,HorusStudio.Maui.MaterialDesignControls.MaterialDarkTheme,HorusStudio.Maui.MaterialDesignControls.MaterialFontSize,HorusStudio.Maui.MaterialDesignControls.MaterialFontFamily,HorusStudio.Maui.MaterialDesignControls.MaterialElevation,HorusStudio.Maui.MaterialDesignControls.MaterialAnimation,HorusStudio.Maui.MaterialDesignControls.MaterialFontTracking,HorusStudio.Maui.MaterialDesignControls.MaterialIcon,HorusStudio.Maui.MaterialDesignControls.MaterialFormat" --excludeinternal --onlyinternal-members --no-index-page --specific-namespace="HorusStudio.Maui.MaterialDesignControls"
+       echo "✅ Documentation generated successfully!"
+
+    - name: Commit & push changes
+      run: |
+        echo "📦 Committing and pushing changes..."
+        git config user.name "github-actions[bot]"
+        git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+        git add .
+        git commit -m "Auto-generate docs [skip ci]" || echo "No changes to commit"
+        git push origin HEAD:${GITHUB_REF#refs/heads/}
+        echo "✅ Changes committed and pushed successfully!"

.github/workflows/master.yml

@@ -0,0 +1,88 @@
+name: Build, pack and push HorusStudio.Maui.MaterialDesignControls NuGet package
+
+on:
+  push:
+    branches: [ "master" ]
+
+permissions:
+  contents: write
+
+env:
+  SLN_FILE_PATH: 'HorusStudio.Maui.MaterialDesignControls.sln'
+  CSPROJ_FILE_PATH: 'src/HorusStudio.Maui.MaterialDesignControls/HorusStudio.Maui.MaterialDesignControls.csproj'
+
+jobs:
+  build:
+    runs-on: macos-latest
+
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Setup .NET
+      uses: actions/setup-dotnet@v4
+      with:
+        dotnet-version: '9.0.x'
+        include-prerelease: true
+
+    - name: Install MAUI workloads
+      run: |
+        echo "📦 Installing MAUI workloads..."
+        dotnet workload install maui
+        dotnet workload restore
+        echo "✅ MAUI workloads installed successfully!"
+
+    - name: Restore dependencies
+      run: |
+        echo "📦 Restoring dependencies..."
+        dotnet restore ${{ env.SLN_FILE_PATH }}
+        echo "✅ Dependencies restored successfully!"
+
+    - name: Build solution
+      run: |
+        echo "📦 Building solution..."
+        dotnet build ${{ env.CSPROJ_FILE_PATH }} -c Release --no-restore
+        echo "✅ Solution built successfully!"
+
+    - name: Pack NuGet package
+      run: |
+        echo "📦 Packaging NuGet package..."
+        dotnet pack ${{ env.CSPROJ_FILE_PATH }} -c Release -o ./artifacts --no-build
+        echo "✅ NuGet package packed successfully!"
+
+    - name: Publish NuGet package
+      run: |
+        echo "📦 Publishing NuGet package..."
+        dotnet nuget push "./artifacts/*.nupkg" --source "https://api.nuget.org/v3/index.json" --api-key ${{ secrets.NUGET_API_KEY }} --skip-duplicate
+        echo "✅ NuGet package published successfully!"
+
+    - name: Get version from nupkg
+      id: get_version
+      run: |
+        FILE=$(ls ./artifacts/*.nupkg | head -n 1)
+        VERSION=$(echo $FILE | sed -E 's/.*\.([0-9]+\.[0-9]+\.[0-9]+)\.nupkg/\1/')
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+    - name: Create Git tag
+      run: |
+        echo "📦 Creating Git tag..."
+        git config user.name "github-actions[bot]"
+        git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+        git tag -a "v${{ steps.get_version.outputs.version }}" -m "Release v${{ steps.get_version.outputs.version }}"
+        git push origin "v${{ steps.get_version.outputs.version }}"
+        echo "✅ Git tag created and pushed successfully!"
+
+    - name: Create GitHub Release
+      uses: actions/create-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: ${{ steps.get_version.outputs.version }}
+        release_name: ${{ steps.get_version.outputs.version }}
+        body: |
+          ### [NuGet package](https://www.nuget.org/packages/HorusStudio.Maui.MaterialDesignControls/${{ steps.get_version.outputs.version }})
+          #### New features
+          - 
+          #### Bug fixes
+          -
+        draft: true
+        prerelease: false

.gitignore

@@ -322,6 +322,7 @@ __pycache__/
 # Cake - Uncomment if you are using it
 tools/**
 !tools/packages.config
+!tools/XMLDoc2Markdown.zip
 
 # Tabs Studio
 *.tss

README.md

@@ -286,7 +286,7 @@ Find more usages and samples on our [sample app](samples/HorusStudio.Maui.Materi
 
 ## Release notes
 
-Check out our progress [here](ReleaseNotes.md).
+Check out our progress [here](https://github.com/HorusSoftwareUY/Maui.MaterialDesignControls/releases).
 
 ## Developed by
 <a href="http://horus.com.uy"><img src="resources/logo.png" width="200"></a>

docs/Controls/horusstudio.maui.materialdesigncontrols.imaterialsnackbar.md

@@ -30,4 +30,5 @@ private async void DefaultSnackbar()
 
 ## Known issues and pending features
 
-* [macOS] MaterialSnackbar with icons are not shown due to an icon rendering issue
+* [macOS] MaterialSnackbar with icons are not shown due to an icon rendering issue.
+ * Add FontFamily, TextTransform and TextDecorations properties.

docs/Controls/horusstudio.maui.materialdesigncontrols.itouchableview.md

@@ -0,0 +1,48 @@
+# ITouchableView
+
+The ITouchableView interface serves as a base for touchable views.
+
+Namespace: HorusStudio.Maui.MaterialDesignControls
+
+<br>
+
+## Properties
+
+### <a id="properties-isenabled"/>**IsEnabled**
+
+Gets or sets the state when the view is enabled.
+
+Property type: [Boolean](https://learn.microsoft.com/en-us/dotnet/api/system.boolean)<br>
+
+<br>
+
+### <a id="properties-touchanimation"/>**TouchAnimation**
+
+Gets or sets a custom animation to be executed when view is clicked.
+
+Property type: ITouchAnimation<br>
+
+<br>
+
+### <a id="properties-touchanimationtype"/>**TouchAnimationType**
+
+Gets or sets an animation to be executed when view is clicked.
+
+Property type: TouchAnimationTypes<br>
+
+| Name | Value | Description |
+| --- | --: | --- |
+| None | 0 | None: no animation runs. |
+| Fade | 1 | Fade: Represents an animation that simulates a "fade" effect by changing the opacity over the target element. |
+| Scale | 2 | Scale: Represents an animation that simulates a "sink" or "sunken" effect by scaling the target element. |
+| Bounce | 3 | Bounce: Represents an animation that simulates a "sink" or "sunken" effect with a "bounce" effect when the user releases the target element. |
+
+<br>
+
+## Events
+
+### <a id="events-touch"/>**Touch**
+
+Occurs when the view is touched.
+
+<br>

docs/Controls/horusstudio.maui.materialdesigncontrols.materialbutton.md

@@ -429,6 +429,12 @@ Occurs when the button is released.
 
 <br>
 
+### <a id="events-touch"/>**Touch**
+
+Occurs when the button is touched.
+
+<br>
+
 ### <a id="events-unfocused"/>**Unfocused**
 
 Occurs when the button is unfocused.
@@ -442,3 +448,4 @@ Occurs when the button is unfocused.
  * ContentLayout is buggy.
  * Add default Material behavior for pressed state on default styles (v2).
  * [iOS] FontAttributes and SupportingFontAttributes don't work (MAUI issue)
+ * [Android] When placed inside a ScrollView, it will fire Command on drag event as well. This behavior is totally inherited from MAUI Button. If you need to avoid that, we recommend using MaterialCard, MaterialChip, or MaterialViewButton instead.

docs/Controls/horusstudio.maui.materialdesigncontrols.materialcard.md

@@ -200,6 +200,12 @@ Occurs when the card is released.
 
 <br>
 
+### <a id="events-touch"/>**Touch**
+
+Occurs when the card is touched.
+
+<br>
+
 ## Known issues and pending features
 
 * Disable color styles looks a bit weird with the opacities that the guideline specifies, we have to review them.

docs/Controls/horusstudio.maui.materialdesigncontrols.materialcheckbox.md

@@ -241,6 +241,12 @@ Occurs when the checkbox is checked / unchecked
 
 <br>
 
+### <a id="events-touch"/>**Touch**
+
+Occurs when the checkbox is touched.
+
+<br>
+
 ## Known issues and pending features
 
 * [iOS] FontAttributes doesn't work.

docs/Controls/horusstudio.maui.materialdesigncontrols.materialchip.md

@@ -379,3 +379,9 @@ Remarks: If a value is not explicitly set, the control will use the Text propert
 Occurs when the chips is clicked/tapped.
 
 <br>
+
+### <a id="events-touch"/>**Touch**
+
+Occurs when the chip is touched.
+
+<br>