Development (#113)

Author: PHKenny

.github/workflows/checks.yaml

@@ -25,5 +25,110 @@ jobs:
       - name: Install dependencies
         run: flutter pub get
 
-      - name: Run checks
+      - name: Run analyze
         run: flutter analyze
+
+      - name: Run tests
+        run: flutter test --machine --coverage > test-results.json
+
+      - name: Publish test results
+        uses: dorny/test-reporter@v1
+        if: always()
+        with:
+          name: Unit Tests
+          path: test-results.json
+          reporter: flutter-json
+
+      - name: Upload coverage
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: flutter-coverage
+          path: coverage/lcov.info
+          retention-days: 1
+
+  coverage-comment:
+    runs-on: ubuntu-latest
+    needs: lint-dart
+    if: always() && github.event_name == 'pull_request'
+
+    steps:
+      - name: Download coverage
+        uses: actions/download-artifact@v4
+        with:
+          name: flutter-coverage
+          path: coverage
+        continue-on-error: true
+
+      - name: Install lcov
+        run: sudo apt-get update && sudo apt-get install -y lcov
+
+      - name: Parse coverage
+        id: coverage
+        run: |
+          if [ -f coverage/lcov.info ]; then
+            # Use lcov to get summary (more reliable than grep)
+            COVERAGE_SUMMARY=$(lcov --summary coverage/lcov.info 2>&1)
+
+            # Extract line coverage percentage
+            COVERAGE_PCT=$(echo "$COVERAGE_SUMMARY" | grep -oP 'lines\.*: \K[\d.]+(?=%)')
+            COVERAGE_PCT=${COVERAGE_PCT:-0.0}
+
+            # Extract hit/total counts
+            LINES_HIT=$(grep -o 'DA:' coverage/lcov.info | wc -l)
+            LINES_TOTAL=$(grep -o 'LF:' coverage/lcov.info | wc -l)
+
+            echo "coverage_pct=$COVERAGE_PCT" >> $GITHUB_OUTPUT
+            echo "lines_hit=$LINES_HIT" >> $GITHUB_OUTPUT
+            echo "lines_total=$LINES_TOTAL" >> $GITHUB_OUTPUT
+          else
+            echo "coverage_pct=0.0" >> $GITHUB_OUTPUT
+            echo "lines_hit=0" >> $GITHUB_OUTPUT
+            echo "lines_total=0" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Post coverage comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const coveragePct = '${{ steps.coverage.outputs.coverage_pct }}';
+            const linesHit = '${{ steps.coverage.outputs.lines_hit }}';
+            const linesTotal = '${{ steps.coverage.outputs.lines_total }}';
+            const linesMissing = parseInt(linesTotal) - parseInt(linesHit);
+
+            const body = `## 📊 Coverage Report
+
+            | Metric | Value |
+            |--------|-------|
+            | **Coverage** | **${coveragePct}%** |
+            | Lines covered | ${linesHit} / ${linesTotal} |
+            | Lines missing | ${linesMissing} |
+
+            <sub>🤖 Coverage report from [checks workflow](${context.payload.repository.html_url}/actions/runs/${context.runId})</sub>`;
+
+            // Find existing comment
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+
+            const existing = comments.find(c =>
+              c.user.type === 'Bot' && c.body.includes('## 📊 Coverage Report')
+            );
+
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id,
+                body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body,
+              });
+            }

.gitignore

@@ -47,4 +47,11 @@ credentials.json
 # FVM Version Cache
 .fvm/
 
-.vscode/settings.json
+.vscode/settings.json
+
+ignoreme.dart
+
+# Claude Code
+.claude/settings.local.json
+
+coverage/

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 7.5.9
+
+- Added `ThemedPasswordInput` widget with built-in password visibility toggle, strength level indicator, and requirement validation (lowercase, uppercase, digit, special character). Supports `LayrzAppLocalizations` for i18n.
+
 ## 7.5.8
 
 - Upgraded `google_fonts` dependency to `^8.0.0` to support latest font features and improvements.

CLAUDE.md

@@ -0,0 +1,63 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**layrz_theme** is a Flutter widget library (published on pub.dev) that implements the Layrz design standard following Material Design 3 guidelines. It provides inputs, layout systems, tables, theme generators, maps, and more. SDK constraints: Dart >=3.10.0, Flutter >=3.38.1.
+
+## Commands
+
+```bash
+flutter pub get                          # Install dependencies
+flutter analyze                          # Lint (this is what CI runs on PRs)
+flutter test                             # Run all tests
+flutter test test/color_test.dart        # Run a single test file
+```
+
+**Example app:**
+```bash
+cd example && flutter pub get && flutter run
+```
+
+## Architecture
+
+### Module System
+
+The library is organized as a set of sub-libraries under `lib/src/`. Each module directory contains a barrel file (e.g., `inputs.dart`, `layout.dart`) that uses Dart's `library` + `part` directives to compose its implementation files. The top-level `lib/layrz_theme.dart` re-exports all sub-libraries.
+
+**To add a new widget to an existing module:** create the implementation file in the appropriate subdirectory, then add a `part` directive in the module's barrel file.
+
+### Key Modules
+
+| Module | Purpose |
+|--------|---------|
+| `inputs/` | Form inputs (text, number, select, pickers, code editor, etc.) — largest module (~95 part files) |
+| `layout/` | App shell with multiple navigation styles (sidebar, dual bar, mini, bottom nav), breadcrumbs, AppBar |
+| `theme/` | Light/dark Material 3 theme generation, color constants, font config via Google Fonts |
+| `table2/` | Advanced data table with sorting, filtering, multi-select, infinite scroll, controller pattern |
+| `extensions/` | Extension methods on Color, DateTime, Widget, String |
+| `helpers/` | Utilities for shadows, avatars, colors, file handling |
+| `map/` | Flutter Map integration with toolbar and controls |
+| `colorblindness/` | Color blindness simulation filters (6 modes with adjustable strength) |
+
+### Patterns
+
+- **Responsive breakpoints:** `kExtraSmallGrid` (600), `kSmallGrid` (960), `kMediumGrid` (1264), `kLargeGrid` (1904) — used with `LayoutBuilder` throughout.
+- **Theme colors:** `kPrimaryColor` (#001e60), `kAccentColor` (#FF8200).
+- **State management:** Uses `layrz_state` package. Example app has `AppStore` for theme/colorblind mode.
+- **Platform-conditional imports:** File handling uses `if (dart.library.js_interop)` for web vs native.
+- **Input pattern:** Widgets accept optional external `FocusNode`/`TextEditingController`; only internally-created controllers are disposed.
+- **Enum-based styling:** Components use style enums (e.g., `ThemedButtonStyle`, `ThemedInputStyle`) for variant selection.
+
+## Code Style
+
+- Formatter: 120-char page width, trailing commas preserved (`analysis_options.yaml`)
+- Linter: `flutter_lints` package
+- Use modern Dart dot shorthand syntax
+
+## CI
+
+- PRs to `main`, `next`, `development` run `flutter analyze` and `flutter test` (Flutter 3.38.8 stable)
+- Test results published as check run + PR comment with summary
+- Version tags (`v*.*.*`) trigger publish to pub.dev and deploy example to GitHub Pages

Makefile

@@ -0,0 +1,17 @@
+.PHONY: analyze
+analyze:
+	flutter analyze
+
+.PHONY: test
+test:
+	flutter test
+
+.PHONY: coverage
+coverage:
+	flutter test --coverage
+	@dart run tools/coverage_report.dart
+
+.PHONY: coverage-summary
+coverage-summary:
+	flutter test --coverage
+	@dart run tools/coverage_report.dart --summary

example/lib/router.dart

@@ -145,7 +145,7 @@ final goRoutes = [
 ];
 
 final router = GoRouter(
-  initialLocation: kDebugMode ? '/inputs/chips' : '/',
+  initialLocation: kDebugMode ? '/inputs/text' : '/',
   errorPageBuilder: (context, state) => customTransitionBuilder(context, state, const NotFoundView()),
   routes: goRoutes,
 );

example/lib/views/inputs/src/text.dart

@@ -10,6 +10,7 @@ class TextInputView extends StatefulWidget {
 class _TextInputViewState extends State<TextInputView> {
   num? _value;
   String? _text;
+  String _password = "Abc123!@#";
   Duration? _dur = const Duration();
   @override
   Widget build(BuildContext context) {
@@ -187,6 +188,22 @@ class _TextInputViewState extends State<TextInputView> {
               value: _dur,
               onChanged: (value) => setState(() => _dur = value),
             ),
+            const SizedBox(height: 10),
+            Text(
+              "Finally, you can also use ThemedPasswordInput to handle passwords easly, like the following example:",
+              style: Theme.of(context).textTheme.titleMedium?.copyWith(
+                fontWeight: FontWeight.bold,
+              ),
+            ),
+            const SizedBox(height: 10),
+            ThemedPasswordInput(
+              labelText: "Password field",
+              value: _password,
+              onChanged: (value) {
+                debugPrint("Value: $value");
+                setState(() => _password = value);
+              },
+            ),
           ],
         ),
       ),

example/pubspec.lock

@@ -374,7 +374,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "7.5.8"
+    version: "7.5.9"
   leak_tracker:
     dependency: transitive
     description:

ignoreme.dart

@@ -54,6 +54,7 @@ part 'src/general/radio_input.dart';
 part 'src/general/search_input.dart';
 part 'src/general/select_input.dart';
 part 'src/general/multiselect_input.dart';
+part 'src/general/password_input.dart';
 
 // Not-reviewed inputs (Basically not documented and/or upgraded to new format)
 part 'src/code_editor.dart';