feat: Major STAC framework refactoring - Introduce stac_core package and Dart-to-JSON conversion #354

divyanshub024 · 2025-09-22T14:37:32Z

Description

This PR introduces Dart-to-JSON export functionality for Stac, along with multiple bug fixes. This PR represents a comprehensive refactoring of the Stac framework, introducing significant architectural improvements and a new DSL-based approach for widget and action definitions.

�� Key Features & Changes

New Architecture

Introduce stac_core package: Centralized core models, widgets, and actions with proper separation of concerns
DSL Support: Complete DSL implementation for all STAC widgets and actions with JSON serialization
Enhanced Framework: New StacService for improved asset handling and network requests
Action System: Unified StacAction base class with centralized action types

Major Refactoring

Widget Migration: Moved all widget models from stac to stac_core package
Parser Architecture: Refactored type parsers with centralized foundation classes
Theme System: Enhanced theme handling with improved serialization
Code Generation: Streamlined freezed/json_annotation code generation

Platform Improvements

iOS Compatibility: Updated deployment target to iOS 13.0 across all projects
Dependency Management: Improved melos managed dependency overrides
Build System: Enhanced build configurations and LLDB debugging support

Widget & Action Enhancements

New Widgets: Added new widgets including StacTab, StacTable, StacCarouselView, StacGridView, etc.
Action Improvements: Enhanced StacSnackBarAction with routing capabilities
Form Support: Complete form validation and input handling system
Navigation: Improved navigation actions and routing

Breaking Changes

StacTextSpan: The data property has been renamed to text for better clarity and consistency
StacShapeBorder: Updated shape border implementation with improved type safety and serialization
StacGradient: Now requires explicit gradient type specification in JSON for better type safety and performance

Related Issues

Closes #130

Type of Change

New feature (non-breaking change which adds functionality)
Bug fix (non-breaking change which fixes an issue)
Breaking change (fix or feature that would cause existing functionality to change)
Code refactor
Build configuration change
Documentation
Chore

… implementations

…ext.dart

…oss examples and core packages

… optional systemOverlayStyle

- Added StacRow model for Stac DSL - Added foll. enums - StacMainAxisAlignment - StacMainAxisSize - StacCrossAxisAlignment - StacVerticalDirection - made type field static in StacElement

…rove system UI overlay style handling

Added StacRow, StacColumn, StacPadding, StacSizedBox to DSL

… dv/stac-export

…adjust stac_models dependency version

…ype' is included in JSON output

…idgets and parsers for improved consistency

refactor: Streamline toJson & remove StacDouble Type

- added StacStackFit enum - added parse ext fn for StacStacFit

Added StacStack, StacPositioned, StacExpanded, StacSpacer

added StacFlexFit enum and parsing extension for it

Updated StacTextStyle and StacGradient

BugFixes for Stac DSL

…rom the movie_app example

Refactor type parsers

…r default case

…ype for routing

… type for consistency

…ase instead of null; simplify onRefresh parsing in StacRefreshIndicator

…ust Podfile configurations for compatibility. Also, add custom LLDB initialization for debugging in Runner scheme.

Stac DSL fixes

coderabbitai · 2025-09-22T14:37:40Z

Important

Review skipped

More than 25% of the files skipped due to max files limit. The review is being skipped to prevent a low-quality review.

111 files out of 294 files are above the max files limit of 100. Please upgrade to Pro plan to get higher limits.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch dv/stac-export

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

divyanshub024 · 2025-09-22T14:41:47Z

@coderabbitai help

coderabbitai · 2025-09-22T14:41:55Z

Chat

There are 3 ways to chat with CodeRabbit:

Review comments: Directly reply to a review comment made by CodeRabbit. Example:
- I pushed a fix in commit <commit_id>, please review it.
- Open a follow-up GitHub issue for this discussion.
Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
- @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
- @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

CodeRabbit commands

These commands are invoked using PR/Issue comments.

@coderabbitai pause to pause the reviews on a PR.
@coderabbitai resume to resume the paused reviews.
@coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
@coderabbitai full review to do a full review from scratch and review all the files again.
@coderabbitai summary to regenerate the summary of the PR.
@coderabbitai evaluate custom pre-merge check --instructions <custom-checks-instructions> --name <custom-checks-title> [--mode <error|warning>] to validate the custom pre-merge checks instructions. Defaults to error when --mode is omitted.
- @coderabbitai ignore pre-merge checks to override pre-merge checks and get an approval on PR.
- @coderabbitai run pre-merge checks to run pre-merge checks on the pull request.
@coderabbitai generate docstrings to generate docstrings for this PR.
@coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
@coderabbitai generate unit tests to generate unit tests for this PR.
@coderabbitai resolve to resolve all the CodeRabbit review comments.
@coderabbitai configuration to show the current CodeRabbit configuration for the repository.
@coderabbitai help to get help.

Other keywords and placeholders

Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit configuration file (`.coderabbit.yaml`)

You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
Please see the configuration documentation for more information.
If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, support, documentation and community

Visit our status page to check the current availability of CodeRabbit.
Create a ticket on our support page for assistance with any issues or questions.
Visit our documentation site for detailed information on how to use CodeRabbit.
Join our Discord community to connect with other users and get help from the community.
Follow us on X/Twitter for updates and announcements.

divyanshub024 · 2025-09-22T14:42:16Z

@coderabbitai review

coderabbitai · 2025-09-22T14:42:24Z

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

divyanshub024 and others added 30 commits July 15, 2025 12:27

feat: initialize stac packages with basic project structure

0e7318d

feat: initialize stac_export package

623524a

refactor: migrate stac_models to stac_export package with core widget…

dfaeac8

… implementations

refactor: remove unused StacText and StacTextSpan classes from stac_t…

716110b

…ext.dart

refactor: update pubspec files and improve widget implementations acr…

6338608

…oss examples and core packages

refactor: simplify StacGallery layout and update StacAppBarParser for…

dac0747

… optional systemOverlayStyle

Added StacRow

0d10b38

- Added StacRow model for Stac DSL - Added foll. enums - StacMainAxisAlignment - StacMainAxisSize - StacCrossAxisAlignment - StacVerticalDirection - made type field static in StacElement

Added StacColumn to DSL

910db7a

Added SizedBox to DSL

1fa7be4

Added StacPadding to DSL

9bd56af

Formatting Fixes

d3f267e

refactor: update StacGallery layout, enhance StacImageParser, and imp…

cd76eb0

…rove system UI overlay style handling

Merge branch 'dv/stac-export' into dsl-widgets

39856bf

Reverted static type in StacWidget

50a3eaf

Merge pull request #316 from StacDev/dsl-widgets

7f1b3bc

Added StacRow, StacColumn, StacPadding, StacSizedBox to DSL

Merge branch 'dv/stac-export' of https://github.com/StacDev/stac into…

8c0e01c

… dv/stac-export

refactor: remove debug print statement, update analysis options, and …

3f7f4c0

…adjust stac_models dependency version

refactor: streamline toJson methods across Stac widgets and ensure 't…

58a8a86

…ype' is included in JSON output

refactor: remove StacDouble type and replace with double in various w…

0b5a95b

…idgets and parsers for improved consistency

Merge pull request #318 from StacDev/dv/stac-dsl-buttons

0dd8a81

refactor: Streamline toJson & remove StacDouble Type

added StacStack to DSL

b4dce3f

- added StacStackFit enum - added parse ext fn for StacStacFit

added StacPositioned to DSL

eed0509

added StacExpanded to DSL

e422337

added StacSpacer to DSL

cc8668e

formatting

e1d8a20

ported from StacDouble to @DoubleConverter

16f28bf

removed manual type key addition in JSON conversion

d96a504

Merge pull request #317 from StacDev/layout-and-structure-widgets

6053500

Added StacStack, StacPositioned, StacExpanded, StacSpacer

added StacFlexible to DSL

a749166

added StacFlexFit enum and parsing extension for it

added StacAspectRatio to DSL

5a98648

divyanshub024 and others added 18 commits September 12, 2025 16:13

Remove pubspec.lock file from stac_cli package

e7eabc4

BugFixes for Stac DSL

c0075ab

Updated StacTextStyle and StacGradient

logger override

e2aab5b

fix: Correct path format for stac_logger dependency override

731e987

Replaced StacTextStyleConverter logic with StacTextStyle.fromJson

8917eb2

if base style is null we return null instead of copyWithStyle

835ac0a

Merge pull request #350 from StacDev/mn/stac-text-style-changes

b2b66b0

BugFixes for Stac DSL

Refactor type parsers

912dca0

Remove unused files: default_stac_options.dart and hello_world.dart f…

2b5ece5

…rom the movie_app example

Merge pull request #351 from StacDev/dv/stac-refactoring

fc43301

Refactor type parsers

Remove unused logging statement from Stac class

ec4bfe6

Update StacImageParser to return _networkImage instead of SizedBox fo…

422f3e0

…r default case

Enhance StacSnackBarAction by extending StacAction and adding actionT…

7c3c6ea

…ype for routing

Remove unused clipBehavior property from align_example.json

4367922

Update list_tile_example.json to replace image leading type with icon…

a10e9e3

… type for consistency

Update StacDecorationImageParser to return NetworkImage for default c…

55ca999

…ase instead of null; simplify onRefresh parsing in StacRefreshIndicator

Update iOS deployment target to 13.0 across multiple projects and adj…

00eabbf

…ust Podfile configurations for compatibility. Also, add custom LLDB initialization for debugging in Runner scheme.

Merge pull request #353 from StacDev/dv/stac-fixes

d8017a4

Stac DSL fixes

divyanshub024 marked this pull request as ready for review September 22, 2025 14:38

divyanshub024 requested a review from Potatomonsta September 22, 2025 14:38

Potatomonsta approved these changes Sep 22, 2025

View reviewed changes

divyanshub024 changed the title ~~[breaking-changes] Stac Dart-To-Json export and bug fixes~~ [breaking-changes] Add Dart-to-JSON export for Stac and fix related bugs Sep 22, 2025

divyanshub024 changed the title ~~[breaking-changes] Add Dart-to-JSON export for Stac and fix related bugs~~ feat: Major STAC framework refactoring - Introduce stac_core package and Dart-to-JSON conversion Sep 22, 2025

divyanshub024 merged commit ab84efb into dev Sep 22, 2025
5 checks passed

divyanshub024 deleted the dv/stac-export branch September 22, 2025 15:01

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

feat: Major STAC framework refactoring - Introduce stac_core package and Dart-to-JSON conversion #354

feat: Major STAC framework refactoring - Introduce stac_core package and Dart-to-JSON conversion #354

Uh oh!

divyanshub024 commented Sep 22, 2025 •

edited

Loading

Uh oh!

coderabbitai bot commented Sep 22, 2025 •

edited

Loading

Review skipped

Uh oh!

divyanshub024 commented Sep 22, 2025

Uh oh!

coderabbitai bot commented Sep 22, 2025

Uh oh!

divyanshub024 commented Sep 22, 2025

Uh oh!

coderabbitai bot commented Sep 22, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

feat: Major STAC framework refactoring - Introduce stac_core package and Dart-to-JSON conversion #354

feat: Major STAC framework refactoring - Introduce stac_core package and Dart-to-JSON conversion #354

Uh oh!

Conversation

divyanshub024 commented Sep 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

�� Key Features & Changes

New Architecture

Major Refactoring

Platform Improvements

Widget & Action Enhancements

Breaking Changes

Related Issues

Type of Change

Uh oh!

coderabbitai bot commented Sep 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

divyanshub024 commented Sep 22, 2025

Uh oh!

coderabbitai bot commented Sep 22, 2025

Chat

CodeRabbit commands

Other keywords and placeholders

CodeRabbit configuration file (.coderabbit.yaml)

Status, support, documentation and community

Uh oh!

divyanshub024 commented Sep 22, 2025

Uh oh!

coderabbitai bot commented Sep 22, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

divyanshub024 commented Sep 22, 2025 •

edited

Loading

coderabbitai bot commented Sep 22, 2025 •

edited

Loading

CodeRabbit configuration file (`.coderabbit.yaml`)