Added #

• FrameForgeStrings fields are now mutable so a host app can localize the built-in editor widgets (PageList, quick switcher, rename dialog) once at startup — e.g. assigning Russian labels in an admin app.

Added #

• Master-detail page navigation for layouts with many component pages (50+):
  • PageList widget — searchable, virtualized list of pages with the current page highlighted (theme-aware Material 3 colors), add-page toolbar button, double-tap rename and a context menu (rename / duplicate / delete).
  • PageQuickSwitcher + showPageQuickSwitcher() — quick page switcher dialog (Ctrl+K) with keyboard navigation over RawAutocomplete.
  • GlobalKeyboardHandler now opens the quick switcher on Ctrl+K (requires the editor Scaffold to keep kNodeEditorWidgetKey).
  • FrameForgeStrings — centralized user-facing strings for the new widgets; fields are mutable so a host app can localize the built-in editor widgets once at startup, e.g. assigning Russian labels in the admin app (first step towards full localization, see doc/ux_audit.md).
• LayoutModel.componentPages — all component pages in order.
• LayoutModel.nextPageName() — unique auto-generated page names (page, page 2, ...).
• LayoutModel.copyPage() — deep copy of a page with fresh unique ids.
• LayoutModelController.switchPage() — single entry point for switching the current page (updates curPage, curPageType and selection).
• LayoutModelController.currentComponentPage — the component page currently open, with fallbacks when the selection lives outside component pages.
• LayoutModelController.addPage() / duplicatePage() / renamePage() / deletePage() — undoable page operations (delete keeps at least one page and selects the neighbour).
• Example app: the Pages tab is now master-detail (PageList + component tree of the current page only) instead of the full tree of all pages.
• Tests for page management (test/page_management_test.dart).

Fixed #

• items.dart: tapping a page row in the tree now switches the editor to that page via switchPage (the previous curPageType is ComponentPage check was always false).
• items.dart / process_items.dart: context menu no longer crashes with a null position when opened without a prior mouse hover (menu key / keyboard).

Added #

• SourceReference class — typed reference to source variables, replacing plain string source properties on components. Supports variableName, mapKey, and nullable fields.
• SourceVariableGroup — a container for organizing source variables into logical groups within a SourcePage. Groups can be nested.
• SourceVariableType marker class with a predefined list of supported types (String, int, double, bool, List, Map).
• nullable and possibleValues properties on SourceVariable.
• PropertySourceWidget — hierarchical navigator for selecting source variables, with breadcrumb navigation, group drill-down, Map key selection, and nullable toggle.
• PropertySourceVariableTypeWidget — dropdown widget for selecting SourceVariable type.
• SourceVariableGroupMenu — context menu for adding variables and sub-groups inside a group.
• Auto-sync: LayoutModel now automatically creates missing SourceVariable entries from component source references and removes root-level duplicates that exist inside groups.
• Example JSON button (TemplateAppbarExampleJsonButton) — generates and displays a sample JSON based on the current source variable definitions.

Changed #

• All component source properties (ComponentGroup, ComponentTable, ComponentText, FormCheckbox, FormExpandbleList, FormHiddenField, FormRadio, FormSliderButton, FormTextField) now use SourceReference instead of plain String.
• Item.operator[] returns SourceReference.toString() for source properties to maintain backward compatibility.
• Library exports sorted alphabetically; added exports for SourceReference, SourceVariableGroup, and SourceVariableType.
• library frame_forge; changed to library; (unnamed library).
• Serialization (FromMapToMap) updated to handle SourceReference and SourceVariableType round-trip.

Fixed #

• Fixed source import from XML: when <source> has attributes (variableName, mapKey, nullable), correctly extract variable name instead of dumping the raw map
• Fallback: if sourceV2 is absent, automatically create it from source (supports both plain string and Map with attributes)

Added #

• image widget with property: fitbox and data as Uint8List

Changed #

• Improved label rendering in FormSliderButtonWidget: the selected label now appears above others, with full width and animation, while other labels dynamically calculate their width and do not overlap. UX is improved for both long and short label lists.

Added #

• active colors for thumb for slider button

Added #

• hintText and initialValue for FormSliderButton
• isRequired (boolean) property for FormTextField to mark fields as required.
• function and inputId properties in Root for handle template data via a user-defined function.

Changed #

• inputId property now supports multiple IDs (List<String>) with graceful backward compatibility for legacy single String values.

Fixed #

• Normalized dynamic list values in PropertyListWidget to avoid type cast errors when legacy data provides a single String or nested list structure.
• Fixed fromMap deserialization to preserve constructor default properties (textFunction, link, inputId) when loading legacy data without these fields. Properties from constructors now merge with loaded data instead of being discarded.

Added #

• PropertyBoolWidget — a new property editor widget for boolean attributes.
• isRequired (boolean) property for FormTextField to mark fields as required.
• textFunction property in ComponentText for generating text via a user-defined function.
• inputId property in ComponentText to link a text component to an input field.
• source property and unified property keys (text, source, alignment).
• alignment property added to FormTextField (text alignment).

Changed #

• Interface property keys and labels migrated to English (lang change to en).
• Updated example example/web/index.html (metadata/structure updates).

Removed #

• lib/src/layout_model/item_list_wrapper.dart removed.
• lib/src/layout_model/mobile_download_service.dart removed.

Refactor #

• Consolidated and standardized text and form component properties (consistent keys and naming).

• Fixed text alignment in components
• Fixed keyboard handler to avoid conflicts with text field editing
• Сhanged source component

• fix borderRadius error in new stylePage
• remove border attributes from componentGroup
• fix menu actions: copy, cut
• add controller for resize and move
• add show the selected item on top
• add service-oriented architecture with dependency injection
• implement global keyboard handler with international layout support
• add undo/redo system
• add comprehensive interface abstractions
• update documentation with detailed features
• fix Russian keyboard layout compatibility (Ctrl+Z -> Ctrl+Я)

• fix switch between ComponentPage
• fix textAlignt in ComponentText
• add to Style "BorderSide" (LTRB)
• fix view of TextComponent
• add a decoration widget as a wrapper for components and implement it in ComponentTextWidget, ComponentGroup, SliderButton
• add attributes for SliderButton: activeColor, inactiveColor, thumbColor
• fix resize and move events to register in controller only on end
• enhanced API documentation coverage with comprehensive dartdoc comments
• canvas rendering optimization
• add to controller: move/moveById/resize/resizeById methods and sealed ChangeItem with ChangeEvent, MoveEvent, ResizeEvent, AttributeChangeEvent. Move business logic out of UI.
• refactor new event type of properties, add reusable textfield like size, offset, padding, marging, border, borderRadius and InputTextPropertyWidget
• add compatibility for border radius values from older versions
• improved public API documentation for better pub.flutter-io.cn compliance
• added detailed class descriptions and parameter documentation

Technical #

• Code formatting improvements across all files

• Multi-language documentation (English and Russian)
• MIT license

Changed #

• Migrated from deprecated dart:html to modern package:web for web compatibility
• Improved static analysis compliance
• Enhanced cross-platform file operations with conditional imports

Technical #

• Universal file picker service with platform-specific implementations:
  • Web: HTML5 File API with modern web standards
  • Mobile/Desktop: file_picker package for native functionality
• Event bus system for component communication
• Controller-based architecture for better separation of concerns
• Comprehensive static analysis fixes

Repository #

• Migrated from layout_editor to dedicated frame_forge repository
• Updated package configuration and dependencies
• Added proper pub.flutter-io.cn compliance

• Initial release of Frame Forge - DSL Model with UI editor
• Added layout model controller and components
• Support for mobile and desktop screen sizes
• File import/export functionality
• Canvas with drag and drop support
• Component styling and theming
• Form field components (text fields, checkboxes, radio buttons, etc.)
• Expandable widget implementation without rxdart dependency
• Removed heavy dependencies (rxdart, dio, permission_handler) for lighter package

Added #

• Initial development version
• Basic project structure
• Core components foundation