wexample-wex-addon-dev-flutter 0.0.56__tar.gz

wexample_wex_addon_dev_flutter-0.0.56/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.1
+Name: wexample-wex-addon-dev-flutter
+Version: 0.0.56
+Summary: Python dev addon for wex
+Author-Email: weeger <contact@wexample.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
+Requires-Python: >=3.10
+Requires-Dist: attrs>=23.1.0
+Requires-Dist: cattrs>=23.1.0
+Requires-Dist: wexample-filestate-flutter==0.0.13
+Requires-Dist: wexample-wex-addon-app==0.0.54
+Requires-Dist: wexample-wex-core==6.0.66
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Description-Content-Type: text/markdown
+
+# wexample-wex-addon-dev-flutter
+
+Version: 0.0.56
+
+Python dev addon for wex
+
+## Table of Contents
+
+- [Status Compatibility](#status-compatibility)
+- [Api Reference](#api-reference)
+- [Tests](#tests)
+- [Code Quality](#code-quality)
+- [Versioning](#versioning)
+- [Changelog](#changelog)
+- [Migration Notes](#migration-notes)
+- [Roadmap](#roadmap)
+- [Security](#security)
+- [Privacy](#privacy)
+- [Support](#support)
+- [Contribution Guidelines](#contribution-guidelines)
+- [Maintainers](#maintainers)
+- [License](#license)
+- [Useful Links](#useful-links)
+- [Suite Integration](#suite-integration)
+- [Compatibility Matrix](#compatibility-matrix)
+- [Dependencies](#dependencies)
+- [Suite Signature](#suite-signature)
+
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## API Reference
+
+Full API documentation is available in the source code docstrings.
+
+Key modules and classes are documented with type hints for better IDE support.
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Code Quality & Typing
+
+All the suite packages follow strict quality standards:
+
+- **Type hints**: Full type coverage with mypy validation
+- **Code formatting**: Enforced with black and isort
+- **Linting**: Comprehensive checks with custom scripts and tools
+- **Testing**: High test coverage requirements
+
+These standards ensure reliability and maintainability across the suite.
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history and release notes.
+
+Major changes are documented with migration guides when applicable.
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_flutter/issues) for upcoming features and improvements.
+
+## Security Policy
+
+### Reporting Vulnerabilities
+
+If you discover a security vulnerability, please email contact@wexample.com.
+
+**Do not** open public issues for security vulnerabilities.
+
+We take security seriously and will respond promptly to verified reports.
+
+## Privacy & Telemetry
+
+This package does **not** collect any telemetry or usage data.
+
+Your privacy is respected — no data is transmitted to external services.
+
+## Support Channels
+
+- **GitHub Issues**: Bug reports and feature requests
+- **GitHub Discussions**: Questions and community support
+- **Documentation**: Comprehensive guides and API reference
+- **Email**: contact@wexample.com for general inquiries
+
+Community support is available through GitHub Discussions.
+
+## Contribution Guidelines
+
+We welcome contributions to the Wexample suite!
+
+### How to Contribute
+
+1. **Fork** the repository
+2. **Create** a feature branch
+3. **Make** your changes
+4. **Test** thoroughly
+5. **Submit** a pull request
+
+## Maintainers & Authors
+
+Maintained by the Wexample team and community contributors.
+
+See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-wex-addon-dev-flutter
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-flutter/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-flutter/discussions
+- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-flutter](https://pypi.org/project/wexample-wex-addon-dev-flutter/)
+
+## Integration in the Suite
+
+This package is part of the **Wexample Suite** — a collection of high-quality Python packages designed to work seamlessly together.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Compatibility Matrix
+
+This package is part of the Wexample suite and is compatible with other suite packages.
+
+Refer to each package's documentation for specific version compatibility requirements.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- cattrs: >=23.1.0
+- wexample-filestate-flutter: ==0.0.13
+- wexample-wex-addon-app: ==0.0.54
+- wexample-wex-core: ==6.0.66
+
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+

wexample_wex_addon_dev_flutter-0.0.56/README.md

@@ -0,0 +1,223 @@
+# wexample-wex-addon-dev-flutter
+
+Version: 0.0.56
+
+Python dev addon for wex
+
+## Table of Contents
+
+- [Status Compatibility](#status-compatibility)
+- [Api Reference](#api-reference)
+- [Tests](#tests)
+- [Code Quality](#code-quality)
+- [Versioning](#versioning)
+- [Changelog](#changelog)
+- [Migration Notes](#migration-notes)
+- [Roadmap](#roadmap)
+- [Security](#security)
+- [Privacy](#privacy)
+- [Support](#support)
+- [Contribution Guidelines](#contribution-guidelines)
+- [Maintainers](#maintainers)
+- [License](#license)
+- [Useful Links](#useful-links)
+- [Suite Integration](#suite-integration)
+- [Compatibility Matrix](#compatibility-matrix)
+- [Dependencies](#dependencies)
+- [Suite Signature](#suite-signature)
+
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## API Reference
+
+Full API documentation is available in the source code docstrings.
+
+Key modules and classes are documented with type hints for better IDE support.
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Code Quality & Typing
+
+All the suite packages follow strict quality standards:
+
+- **Type hints**: Full type coverage with mypy validation
+- **Code formatting**: Enforced with black and isort
+- **Linting**: Comprehensive checks with custom scripts and tools
+- **Testing**: High test coverage requirements
+
+These standards ensure reliability and maintainability across the suite.
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed version history and release notes.
+
+Major changes are documented with migration guides when applicable.
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_flutter/issues) for upcoming features and improvements.
+
+## Security Policy
+
+### Reporting Vulnerabilities
+
+If you discover a security vulnerability, please email contact@wexample.com.
+
+**Do not** open public issues for security vulnerabilities.
+
+We take security seriously and will respond promptly to verified reports.
+
+## Privacy & Telemetry
+
+This package does **not** collect any telemetry or usage data.
+
+Your privacy is respected — no data is transmitted to external services.
+
+## Support Channels
+
+- **GitHub Issues**: Bug reports and feature requests
+- **GitHub Discussions**: Questions and community support
+- **Documentation**: Comprehensive guides and API reference
+- **Email**: contact@wexample.com for general inquiries
+
+Community support is available through GitHub Discussions.
+
+## Contribution Guidelines
+
+We welcome contributions to the Wexample suite!
+
+### How to Contribute
+
+1. **Fork** the repository
+2. **Create** a feature branch
+3. **Make** your changes
+4. **Test** thoroughly
+5. **Submit** a pull request
+
+## Maintainers & Authors
+
+Maintained by the Wexample team and community contributors.
+
+See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-wex-addon-dev-flutter
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-flutter/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-flutter/discussions
+- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-flutter](https://pypi.org/project/wexample-wex-addon-dev-flutter/)
+
+## Integration in the Suite
+
+This package is part of the **Wexample Suite** — a collection of high-quality Python packages designed to work seamlessly together.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Compatibility Matrix
+
+This package is part of the Wexample suite and is compatible with other suite packages.
+
+Refer to each package's documentation for specific version compatibility requirements.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- cattrs: >=23.1.0
+- wexample-filestate-flutter: ==0.0.13
+- wexample-wex-addon-app: ==0.0.54
+- wexample-wex-core: ==6.0.66
+
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+

wexample_wex_addon_dev_flutter-0.0.56/pyproject.toml

@@ -0,0 +1,88 @@
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[project]
+name = "wexample-wex-addon-dev-flutter"
+version = "0.0.56"
+description = "Python dev addon for wex"
+authors = [
+    { name = "weeger", email = "contact@wexample.com" },
+]
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "attrs>=23.1.0",
+    "cattrs>=23.1.0",
+    "wexample-filestate-flutter==0.0.13",
+    "wexample-wex-addon-app==0.0.54",
+    "wexample-wex-core==6.0.66",
+]
+
+[project.readme]
+file = "README.md"
+content-type = "text/markdown"
+
+[project.license]
+text = "MIT"
+
+[project.urls]
+homepage = "https://github.com/wexample/python-wex-dev-python"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "pytest-cov",
+]
+
+[tool.setuptools.packages.find]
+include = [
+    "*",
+]
+exclude = [
+    "wexample_wex_addon_dev_flutter.testing*",
+]
+
+[tool.pdm]
+distribution = true
+
+[tool.pdm.build]
+package-dir = "src"
+packages = [
+    { include = "wexample_wex_addon_dev_flutter", from = "src" },
+]
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+]
+pythonpath = [
+    "src",
+]
+
+[tool.coverage.run]
+source = [
+    "wexample_wex_addon_dev_flutter",
+]
+omit = [
+    "*/tests/*",
+    "*/.venv/*",
+    "*/venv/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/config_value/__init__.py

@@ -0,0 +1 @@
+

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/config_value/flutter_package_readme_config_value.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from wexample_helpers.decorator.base_class import base_class
+from wexample_wex_addon_app.config_value.app_readme_config_value import (
+    AppReadmeConfigValue,
+)
+
+
+@base_class
+class FlutterPackageReadmeContentConfigValue(AppReadmeConfigValue):
+    """README generation for Flutter packages."""
+
+    def _get_app_description(self) -> str:
+        return self.workdir.get_app_config().get("description", "")

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/file/__init__.py

@@ -0,0 +1 @@
+

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/file/flutter_pubspec_yaml_file.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+from wexample_filestate.item.file.yaml_file import YamlFile
+from wexample_helpers.decorator.base_class import base_class
+
+
+@base_class
+class FlutterPubspecYamlFile(YamlFile):
+    def get_dependencies_versions(
+        self, optional: bool = False, group: str = "dev"
+    ) -> dict[str, str]:
+        config = self.read_config()
+
+        dependencies = config.search(path="dependencies").get_dict_or_default(
+            default={}
+        )
+        dev_dependencies = config.search(path="dev_dependencies").get_dict_or_default(
+            default={}
+        )
+
+        merged = dict(dependencies)
+
+        if group == "dev":
+            merged.update(dev_dependencies)
+
+        return merged

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/flutter_addon_manager.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from wexample_wex_core.common.abstract_addon_manager import AbstractAddonManager
+
+
+class FlutterAddonManager(AbstractAddonManager):
+    pass

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/workdir/__init__.py

@@ -0,0 +1 @@
+

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/workdir/flutter_package_workdir.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_addon_dev_flutter.workdir.flutter_workdir import FlutterWorkdir
+
+if TYPE_CHECKING:
+    from wexample_filestate.config_value.readme_content_config_value import (
+        ReadmeContentConfigValue,
+    )
+    from wexample_wex_addon_app.workdir.framework_packages_suite_workdir import (
+        FrameworkPackageSuiteWorkdir,
+    )
+
+
+class FlutterPackageWorkdir(FlutterWorkdir):
+    def _get_readme_content(self) -> ReadmeContentConfigValue | None:
+        from wexample_wex_addon_dev_flutter.config_value.flutter_package_readme_config_value import (
+            FlutterPackageReadmeContentConfigValue,
+        )
+
+        return FlutterPackageReadmeContentConfigValue(workdir=self)
+
+    def _get_suite_package_workdir_class(self) -> type[FrameworkPackageSuiteWorkdir]:
+        from wexample_wex_addon_dev_flutter.workdir.flutter_packages_suite_workdir import (
+            FlutterPackagesSuiteWorkdir,
+        )
+
+        return FlutterPackagesSuiteWorkdir

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/workdir/flutter_packages_suite_workdir.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_addon_app.workdir.framework_packages_suite_workdir import (
+    FrameworkPackageSuiteWorkdir,
+)
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+    from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
+
+
+class FlutterPackagesSuiteWorkdir(FrameworkPackageSuiteWorkdir):
+    def _child_is_package_directory(self, entry: Path) -> bool:
+        return entry.is_dir() and (entry / "pubspec.yaml").is_file()
+
+    def _get_children_package_directory_name(self) -> str:
+        return "flutter"
+
+    def _get_children_package_workdir_class(self) -> type[CodeBaseWorkdir]:
+        from wexample_wex_addon_dev_flutter.workdir.flutter_package_workdir import (
+            FlutterPackageWorkdir,
+        )
+
+        return FlutterPackageWorkdir

wexample_wex_addon_dev_flutter-0.0.56/src/wexample_wex_addon_dev_flutter/workdir/flutter_workdir.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_config.options_provider.abstract_options_provider import (
+    AbstractOptionsProvider,
+)
+from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
+
+if TYPE_CHECKING:
+    from wexample_config.const.types import DictConfig
+    from wexample_filestate.option.children_file_factory_option import (
+        ChildrenFileFactoryOption,
+    )
+
+    from wexample_wex_addon_dev_flutter.file.flutter_pubspec_yaml_file import (
+        FlutterPubspecYamlFile,
+    )
+
+
+class FlutterWorkdir(CodeBaseWorkdir):
+    def get_app_config_file(self, reload: bool = True) -> FlutterPubspecYamlFile:
+        from wexample_wex_addon_dev_flutter.file.flutter_pubspec_yaml_file import (
+            FlutterPubspecYamlFile,
+        )
+
+        config_file = self.find_by_type(FlutterPubspecYamlFile)
+        # Read once to populate content with file source.
+        config_file.read_text(reload=reload)
+        return config_file
+
+    def get_dependencies_versions(self) -> dict[str, str]:
+        return self.get_app_config_file().get_dependencies_versions()
+
+    def get_main_code_file_extension(self) -> str:
+        return "dart"
+
+    def get_options_providers(self) -> list[type[AbstractOptionsProvider]]:
+        from wexample_filestate_flutter.options_provider.flutter_options_provider import (
+            FlutterOptionsProvider,
+        )
+
+        options = super().get_options_providers()
+
+        options.extend(
+            [
+                FlutterOptionsProvider,
+            ]
+        )
+
+        return options
+
+    def prepare_value(self, raw_value: DictConfig | None = None) -> DictConfig:
+        from wexample_filestate.const.disk import DiskItemType
+        from wexample_helpers.helpers.array import array_dict_get_by
+
+        from wexample_wex_addon_dev_flutter.file.flutter_pubspec_yaml_file import (
+            FlutterPubspecYamlFile,
+        )
+
+        raw_value = super().prepare_value(raw_value=raw_value)
+
+        children = raw_value["children"]
+
+        children.append(
+            {
+                "class": FlutterPubspecYamlFile,
+                "name": "pubspec.yaml",
+                "type": DiskItemType.FILE,
+                "should_exist": True,
+            }
+        )
+
+        # Add common Flutter ignores
+        array_dict_get_by("name", ".gitignore", children).setdefault(
+            "should_contain_lines", []
+        ).extend(
+            [
+                ".dart_tool/",
+                "build/",
+                ".packages",
+                ".flutter-plugins",
+                ".flutter-plugins-dependencies",
+                ".flutter-plugins-android",
+                ".flutter-plugins-ios",
+            ]
+        )
+
+        children.extend(
+            [
+                {
+                    "name": "lib",
+                    "type": DiskItemType.DIRECTORY,
+                    "should_exist": True,
+                    "children": [
+                        self._create_flutter_file_children_filter(),
+                    ],
+                },
+                {
+                    "name": "test",
+                    "type": DiskItemType.DIRECTORY,
+                    "should_exist": True,
+                    "children": [
+                        self._create_flutter_file_children_filter(),
+                    ],
+                },
+            ]
+        )
+
+        return raw_value
+
+    def _create_flutter_file_children_filter(self) -> ChildrenFileFactoryOption:
+        from wexample_filestate.const.disk import DiskItemType
+        from wexample_filestate.option.children_filter_option import (
+            ChildrenFilterOption,
+        )
+        from wexample_filestate_flutter.file.flutter_file import FlutterFile
+        from wexample_filestate_flutter.option.flutter.dart_format_option import (
+            DartFormatOption,
+        )
+
+        return ChildrenFilterOption(
+            pattern={
+                "class": FlutterFile,
+                "type": DiskItemType.FILE,
+                "flutter": [
+                    DartFormatOption.get_name(),
+                ],
+            },
+            name_pattern=r"^.*\.dart$",
+            recursive=True,
+        )