Web migration

.github/workflows/dart.yml

@@ -1,7 +1,7 @@
 name: Dart CI
 
 env:
-  DART_VERSION: "3.6.2"
+  DART_VERSION: "latest"
 
 on:
   push:
@@ -74,8 +74,10 @@ jobs:
         run: dart pub get
       - name: Upgrade dependencies
         run: dart pub upgrade
-      - name: Run tests (Chrome)
-        run: dart test --platform chrome --coverage=./coverage
+      - name: Run tests (Chrome Wasm)
+        run: dart test --platform chrome --compiler dart2wasm
+      - name: Run tests (Chrome JS)
+        run: dart test --platform chrome --compiler dart2js --coverage=./coverage
       - name: Generate coverage report
         run: |
           dart pub global activate coverage

CHANGELOG.md

@@ -1,3 +1,304 @@
+## 3.0.0
+
+- Release v3.0.0
+
+- Dependencies:
+  - Updated `dom_tools` from `^3.0.0-beta.19` to `^3.0.0`.
+  - Updated `dom_builder` from `^3.0.0-beta.11` to `^3.0.0`.
+
+## 3.0.0-beta.20
+
+- `UIEventHandler`:
+  - Added `unregisterEventListener` and `clearEventListeners` methods.
+
+- `EventHandlerPrivate`:
+  - Changed `_eventListeners` to nullable and lazily initialized.
+  - Added `_unregisterEventListener` and `_clearEventListeners` implementations.
+
+- `ElementProvider` and `CSSProvider`:
+  - Updated calls to `buildDOM` to include `treeMap` and `setTreeMapRoot` parameters.
+
+- `UIComponent`:
+  - Replaced `Expando` with `DualWeakMap` for static field `_asyncRenderingZoneComponent`.
+  - Added `_domTreeMap` field and `domTreeMap` getter for lazy DOM tree mapping.
+  - Added `domTreeMapIfInitialized` getter and static `domTreeMapDummy`.
+  - Replaced `Expando` with `DualWeakMap` for `_contentsUIComponents`.
+  - Updated parent setting methods to use named parameter `addToParent`.
+  - Added `_resolveParentFromParentUIComponent` to better resolve `_parent`.
+  - Updated many list conversions from `.toList()` to `.asListViewFixed` for performance.
+  - Added `_onRender` and `_onChange` lazy event streams.
+  - Added `_renderedUIRoots` and `_renderedUIComponents` sets to track rendering.
+  - Improved `_markRenderTime` and rendering finish notification logic.
+  - Added `dispose` and `_recycle` methods for lifecycle management.
+  - Added static `purgeGlobals` to clear global UI state.
+  - Updated rendering and async content handling to use nullable collections.
+  - Updated event listener attachment to use `addEventListenerTyped`.
+
+- `bones_ui_extension.dart`:
+  - Added `ElementStreamExtension` and `StreamSubscriptionExtension` to track subscriptions in `DOMTreeMap`.
+
+- `UIDOMGenerator`:
+  - Updated `addExternalElementToElement` and `toElements` to accept `treeMap` and `context` parameters.
+  - Updated calls to `buildDOM` to pass `treeMap` and `setTreeMapRoot`.
+
+- `UIRootComponent`:
+  - Changed `_uiComponentsTree` to nullable and lazily initialized.
+  - Added `_onPurgedUIComponents` callback to dispose purged components.
+  - Updated methods to safely handle nullable `_uiComponentsTree`.
+  - Added `purgeRoot` method to purge tree and global UI state.
+
+- Added `_UIDOMTreeReferenceMap` subclass to prevent premature purging of components not fully initialized or disposed.
+
+- `UIButtonBase` and `UIButtonLoader`:
+  - Updated event listener attachment to use `addEventListenerTyped`.
+  - Fixed null safety and type checks for button elements.
+
+- `UICapture`:
+  - Added new `CaptureDataFormat.urlOrBlobUrl` format.
+  - Added `selectedFileDataAsURLOrDataURLBase64` getter.
+  - Updated `_readFile` and `_filterCapturedData` to support new format and improved async flow with `_yeld` helper.
+  - Updated `_CapturedData` class to store optional MIME type and support new format.
+  - Improved data format conversions to preserve MIME type.
+  - Added helper `_yeld` function for async yielding.
+
+- `UIDialogBase`:
+  - Fixed background color style to use `rgb` when alpha is 1.0.
+
+- `_CanvasEditImage`:
+  - Added delayed `_configure` call after construction.
+  - Updated `_updateCanvasDimension` to return bool indicating if dimension changed.
+  - Improved zoom and translate setters to avoid unnecessary renders.
+
+- `InputConfig`:
+  - Added optional `parent` parameter to rendering methods.
+  - Updated DOM building calls to pass `treeMap` and `setTreeMapRoot`.
+  - Updated `_resolveValueText` to use `parent` for intl message resolution.
+
+- `UIInputTable`:
+  - Updated rendering of inputs and labels to pass `domTreeMap` and `setTreeMapRoot`.
+
+- `UILoading`:
+  - Updated `asDIVElement` buildDOM calls to pass `treeMap` and `setTreeMapRoot`.
+
+- `MasonryItem` and `_MasonryRenderItem`:
+  - Updated DOM generation calls to pass `treeMap` and `setTreeMapRoot`.
+
+- `UITemplateElementGenerator`:
+  - Updated DOM generation calls to pass `treeMap`, `context`, and `setTreeMapRoot`.
+  - Updated template building to use `dsxResolution` enum instead of boolean flags.
+
+- `pubspec.yaml`:
+  - Updated dependencies:
+    - `web_utils`: ^1.0.21
+    - `dom_tools`: ^3.0.0-beta.19
+    - `dom_builder`: ^3.0.0-beta.11
+    - `swiss_knife`: ^3.3.5
+    - `statistics`: ^1.2.1
+    - `test`: ^1.29.0
+    - `test_api`: ^0.7.9
+    - `test_core`: ^0.6.15
+    - `build_web_compilers`: ^4.4.11
+    - `build_runner`: ^2.11.1
+    - `dependency_validator`: ^5.0.4
+
+## 3.0.0-beta.19
+
+- dom_tools: ^3.0.0-beta.13
+- dom_builder: ^3.0.0-beta.7
+- web_utils: ^1.0.19
+
+## 3.0.0-beta.18
+
+- `UIDOMGenerator`:
+  - `toElements`:
+    - Fix resolution of `UIComponent`, calling `UIComponent.ensureRendered` before return `UIComponent.content`.
+
+- dom_builder: ^3.0.0-beta.6
+
+## 3.0.0-beta.17
+
+- `UIComponent`:
+  - `getFieldElementTyped`: use `asElementOfNullable`.
+
+- web_utils: ^1.0.18
+
+## 3.0.0-beta.16
+
+- `UIDOMGenerator`:
+  - `addExternalElementToElement`: improve external element resolution.
+  - `attachFutureElement`: improve element resolution.
+
+- js_interop_utils: ^1.0.9
+- web_utils: ^1.0.17
+- dom_tools: ^3.0.0-beta.12
+- dom_builder: ^3.0.0-beta.5
+- expressions: ^0.2.5+3
+- collection: ^1.19.1
+- test: ^1.28.0
+- test_api: ^0.7.8
+- test_core: ^0.6.14
+
+- build_web_compilers: ^4.4.3
+- build_runner: ^2.10.4
+- dependency_validator: ^5.0.3
+
+## 3.0.0-beta.15
+
+- Merge 2.5.21
+  - `InputConfig`:
+      - Added field `precision`.
+      - Added support for type `decimal`.
+
+## 3.0.0-beta.14
+
+- Merge 2.5.20:
+  - `UIComponent`:
+      - Optimize `findChildDeep` with a BFS queue.
+
+## 3.0.0-beta.13
+
+- Merge 2.5.19:
+  - `UIComponent`:
+      - `_getContentChildrenImpl`, `_findInContentChildDeepImpl`, `_findChildrenDeepImpl`, `_listFieldsEntriesInContentDeepImpl`: Switched to iterative breadth-first search for up to 10× faster element lookup in deep UI trees.
+      - `getFields`, `getFieldElementByValue`, `getElementFieldName`, `getFieldsElementsMap`, `parseChildElementValue`:
+          - added parameter `resolveUIComponents = true`.
+
+- test: ^1.26.3
+- test_api: ^0.7.7
+- test_core: ^0.6.12
+
+## 3.0.0-beta.12
+
+- Merge 2.5.17:
+  - `UIDialog`:
+      - Added properties `autoScrollY` and `autoScrollX`.
+
+- dom_tools: ^3.0.0-beta.11
+- swiss_knife: ^3.3.1
+
+- build_web_compilers: ^4.2.0
+- build_runner: ^2.5.4
+
+## 3.0.0-beta.11
+
+- Merge 2.5.16:
+  - `UIComponent`:
+    - Optimized `subUIComponentsDeeply` and `getRenderedUIComponents`
+      - Both now return `Iterable<UIComponent>`.
+      - `subUIComponentsDeeply` is optimized as a lazy `sync*` generator and recursively calls `subElem.subUIComponentsDeeply`.
+    - Improve `_resolveUIRootComponent`.
+    - `_callRenderImpl`: fix issue when `parent` is passed on constructor but it's already appended in a sub-element.
+
+    - test: ^1.26.2
+    - test_api: ^0.7.6
+    - test_core: ^0.6.11
+
+    - dependency_validator: ^5.0.2
+
+## 3.0.0-beta.10
+
+- `UISVG`:
+  - replace `createHTML` with `createElement` for SVG element creation.
+
+- `UIComponent`:
+  - replace `append` with `appendChild` for DOM consistency.
+
+- js_interop_utils: ^1.0.8
+- web_utils: ^1.0.15
+- dom_tools: ^3.0.0-beta.10
+- archive: ^4.0.7
+- test: ^1.26.2
+- test_api: ^0.7.6
+- test_core: ^0.6.11
+
+- build_web_compilers: ^4.1.5
+
+## 3.0.0-beta.9
+
+- Merge v2.5.15
+  - `UIComponent`:
+    - Added `renderedElementsAsync`.
+  - `UIDialogBase`:
+    - Added `configureButtons` to configure the buttons `onClick`.
+    - `posRender` and `posAsyncRender` calls `configureButtons`.
+
+- js_interop_utils: ^1.0.7
+- web_utils: ^1.0.14
+- dom_tools: ^3.0.0-beta.9
+- dom_builder: ^3.0.0-beta.4
+- archive: ^4.0.5 
+
+## 3.0.0-beta.8
+
+- web_utils: ^1.0.12
+- dom_tools: ^3.0.0-beta.8
+- project_template: ^1.1.1
+- archive: ^4.0.4
+
+- dependency_validator: ^5.0.2
+
+## 3.0.0-beta.7
+
+✨♻️ refactor(bones_ui_test_tools):
+  - Standardize `selectNonTyped` and rename it to `select`.
+  - Standardize `selectNonTypedAll` / `selectAllNonTyped` and rename it to `selectAll`.
+  - Ensure that `selectTyped` exists where `querySelectorTyped` exists.
+
+- web_utils: ^1.0.11
+
+## 3.0.0-beta.6
+
+- Avoids using `identical` with `Element` (`JSObject`) to avoid inconsistencies in Wasm.
+
+- dom_tools: ^3.0.0-beta.7
+- dom_builder: ^3.0.0-beta.3
+- web: ^1.1.1
+- mercury_client: ^2.3.0
+
+## 3.0.0-beta.5
+
+- web_utils: ^1.0.9
+- intl_messages: ^3.0.0-beta.1
+- dom_tools: ^3.0.0-beta.5
+- swiss_knife: ^3.3.0
+- statistics: ^1.2.0
+- resource_portable: ^3.1.2
+- intl: ^0.20.2
+
+## 3.0.0-beta.4
+
+- js_interop_utils: ^1.0.6
+
+##  3.0.0-beta.3
+
+- web_utils: ^1.0.7
+- mercury_client: ^2.2.5
+
+## 3.0.0-beta.2
+
+- web_utils: ^1.0.6
+- dom_tools: ^3.0.0-beta.4
+- dom_builder: ^3.0.0-beta.2
+
+## 3.0.0-beta.1
+
+- CI: test with `dart2js` and `dart2wasm` (on Chrome).
+
+- sdk: '>=3.6.0 <4.0.0'
+
+- js_interop_utils: ^1.0.5
+- web_utils: ^1.0.5
+- dom_tools: ^3.0.0-beta.3
+- dom_builder: ^3.0.0-beta.1
+- web: ^1.1.0
+- collection: ^1.19.0
+- test: ^1.25.15
+- stream_channel: ^2.1.4
+
+- lints: ^5.1.1
+- build_web_compilers: ^4.1.1
+- build_runner: ^2.4.15
+
 ## 2.5.21
 
 - `InputConfig`:

bones_ui.iml

@@ -6,7 +6,6 @@
       <excludeFolder url="file://$MODULE_DIR$/.dart_tool" />
       <excludeFolder url="file://$MODULE_DIR$/.pub" />
       <excludeFolder url="file://$MODULE_DIR$/build" />
-      <excludeFolder url="file://$MODULE_DIR$/coverage" />
     </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />

bump.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+APIKEY=$1
+shift  # remove the first argument (API key) from "$@"
+
+## dart pub global activate dart_bump
+
+dart_bump . \
+  --extra-file "lib/src/bones_ui.dart=static\\s+const\\s+String\\s+version\\s+=\\s+['\"]([\\w.\\-]+)['\"]" \
+  --api-key $APIKEY \
+  "$@"

dart_test.yaml

@@ -20,3 +20,4 @@ define_platforms:
         linux: firefox-esr
 
 platforms: [chrome]
+compilers: [dart2js, dart2wasm]

example/main.dart

@@ -1,10 +1,8 @@
-import 'dart:html';
-
 import 'package:bones_ui/bones_ui_kit.dart';
 
 void main() async {
   // Create `bones_ui` root and initialize it:
-  var root = MyRoot(querySelector('#output'));
+  var root = MyRoot(document.querySelector('#output'));
   root.initialize();
 }
 
@@ -162,7 +160,7 @@ class MyComponents extends UIComponent {
       '<hr>',
       UIButton(content, 'UIButton')
         ..onClick.listen((event) => _showAlert('<b>UIButton Clicked:</b>',
-            'x: ${event.client.x}<br> y: ${event.client.y}')),
+            'x: ${event.clientX}<br> y: ${event.clientY}')),
       '<hr>',
       UIInputTable(content, [
         InputConfig('name', 'Name', type: 'text'),

lib/bones_ui_kit.dart

@@ -7,8 +7,10 @@ export 'package:dom_builder/dom_builder.dart';
 export 'package:dom_tools/dom_tools.dart';
 export 'package:dynamic_call/dynamic_call.dart';
 export 'package:html_unescape/html_unescape.dart';
-export 'package:json_object_mapper/json_object_mapper.dart';
+export 'package:js_interop_utils/js_interop_utils.dart';
 export 'package:mercury_client/mercury_client.dart';
 export 'package:swiss_knife/swiss_knife.dart';
+export 'package:web_utils/web_utils.dart'
+    hide CSS, HttpStatus, HttpRequest, Credential, MimeType, Geolocation;
 
 export 'bones_ui.dart';

lib/bones_ui_test.dart

@@ -2,10 +2,11 @@
 library;
 
 export 'dart:async';
-export 'dart:html';
 
 export 'package:dom_builder/dom_builder.dart';
 export 'package:dom_tools/dom_tools.dart';
+export 'package:web_utils/web_utils.dart'
+    hide CSS, HttpStatus, HttpRequest, MimeType;
 
 export 'bones_ui.dart';
 export 'src/bones_ui_test_tools.dart';