Merge branch 'main' into locfiles/51ffd811-bddd-40b6-bb03-6b932057433a

Author: compulim

.eslintrc.react.yml

@@ -118,6 +118,13 @@ rules:
     - warn
     - additionalHooks: ^(useLiveRegion|useMemoized|use(\w+)Updater)$
 
+  # The rule is preventing read access to refs inside the render loop.
+  # For optimization, we are heavy on ref usage.
+  react-hooks/refs: off
+
+  # This rule does not understand validateProps and falsely claim validateProps is causing mutations.
+  react-hooks/preserve-manual-memoization: off
+
   # Conflicts with Adaptive Card schema.
   # react/forbid-prop-types: error
 

.github/PULL_REQUEST_TEMPLATE.md

@@ -18,25 +18,23 @@
 
 <!-- Please list the changes in a concise manner. -->
 
-## -
-
--
+- 
 
 <!-- For bugs, add the bug repro as a test. Otherwise, add tests to futureproof your work. -->
 
--  [ ] I have added tests and executed them locally
--  [ ] I have updated `CHANGELOG.md`
--  [ ] I have updated documentation
+- [ ] I have added tests and executed them locally
+- [ ] I have updated `CHANGELOG.md`
+- [ ] I have updated documentation
 
 ## Review Checklist
 
 > This section is for contributors to review your work.
 
--  [ ] Accessibility reviewed (tab order, content readability, alt text, color contrast)
--  [ ] Browser and platform compatibilities reviewed
--  [ ] CSS styles reviewed (minimal rules, no `z-index`)
--  [ ] Documents reviewed (docs, samples, live demo)
--  [ ] Internationalization reviewed (strings, unit formatting)
--  [ ] `package.json` and `package-lock.json` reviewed
--  [ ] Security reviewed (no data URIs, check for nonce leak)
--  [ ] Tests reviewed (coverage, legitimacy)
+- [ ] Accessibility reviewed (tab order, content readability, alt text, color contrast)
+- [ ] Browser and platform compatibilities reviewed
+- [ ] CSS styles reviewed (minimal rules, no `z-index`)
+- [ ] Documents reviewed (docs, samples, live demo)
+- [ ] Internationalization reviewed (strings, unit formatting)
+- [ ] `package.json` and `package-lock.json` reviewed
+- [ ] Security reviewed (no data URIs, check for nonce leak)
+- [ ] Tests reviewed (coverage, legitimacy)

.github/workflows/pull-request-validation.yml

@@ -22,7 +22,7 @@ defaults:
 env:
   CI_PULL_REQUEST: 1 # Skip nightly tests
   NODE_ENV: test # Add instrumentation code
-  node-version: 18.20 # Need to bump jest@29 to resolve something in https://github.com/facebook/react-native/issues/35701
+  node-version: 24
 
 permissions:
   contents: read
@@ -145,6 +145,7 @@ jobs:
           --forceExit \
           --logHeapUsage \
           --runInBand \
+          --silent \
           --testPathPattern=/packages/\
         timeout-minutes: 10
 
@@ -154,7 +155,7 @@ jobs:
           ls -laR .
 
           mv lcov.info lcov-unit.info
-          mv result.trx result-unit.trx
+        # mv result.trx result-unit.trx
         working-directory: ./coverage
 
       - if: always()
@@ -164,7 +165,7 @@ jobs:
           name: test-result-unit
           path: |
             ./coverage/lcov-*.info
-            ./coverage/result-*.trx
+          # ./coverage/result-*.trx
 
   type-definitions-test:
     name: Type definitions test
@@ -228,7 +229,7 @@ jobs:
       - run: npm clean-install --strict-peer-deps
 
       - name: Run docker compose build
-        run: docker compose -f docker-compose-wsl2.yml build --build-arg REGISTRY=mcr.microsoft.com/mirror/docker/library
+        run: docker compose -f docker-compose-wsl2.yml build --build-arg REGISTRY=mcr.microsoft.com
 
       - name: Run docker compose up
         run: docker compose -f docker-compose-wsl2.yml up --detach --scale chrome=2
@@ -255,7 +256,8 @@ jobs:
             --forceExit \
             --logHeapUsage \
             --runInBand \
-            --shard=${{ format('{0}/{1}', matrix.shard-index, matrix.shard-count) }}
+            --shard=${{ format('{0}/{1}', matrix.shard-index, matrix.shard-count) }} \
+            --silent
         timeout-minutes: 10
 
       - if: always()
@@ -268,7 +270,7 @@ jobs:
           ls -laR .
 
           mv lcov.info lcov-${{ matrix.shard-index }}.info
-          mv result.trx result-${{ matrix.shard-index }}.trx
+        # mv result.trx result-${{ matrix.shard-index }}.trx
         working-directory: ./coverage
 
       - if: always()
@@ -278,7 +280,7 @@ jobs:
           name: test-result-html-${{ matrix.shard-index }}
           path: |
             ./coverage/lcov-*.info
-            ./coverage/result-*.trx
+          # ./coverage/result-*.trx
 
       - if: failure()
         name: Upload test snapshot diffs

ACHIEVEMENTS.md

@@ -4,7 +4,7 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 <!-- Template for future additions. Add new to the top of a corresponding section.
 
-## 🏆 \[Achievement Title]
+### 🏆 \[Achievement Title]
 
 **Goal:** Briefly describe the purpose of the change.
 **By:** [@username](https://github.com/username) in [PR #XXXX](https://github.com/microsoft/BotFramework-WebChat/pull/XXXX)
@@ -17,25 +17,44 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ## 🧱 Architecture & Core Systems
 
+### 🌐 ES Modules Browser Build
+
+**Goal:** Ship first-class `<script type="module">` bundles for modern browsers.
+**By:** [@compulim](https://github.com/compulim) in [PR #5592](https://github.com/microsoft/BotFramework-WebChat/pull/5592), [#5593](https://github.com/microsoft/BotFramework-WebChat/pull/5593), [#5595](https://github.com/microsoft/BotFramework-WebChat/pull/5595), [#5600](https://github.com/microsoft/BotFramework-WebChat/pull/5600), [#5602](https://github.com/microsoft/BotFramework-WebChat/pull/5602)
+
+- Delivered browser-ready ES module builds with vendor chunking for optimal caching.
+- Introduced new export entries and reworked external API.
+- Added documentation for all available Web Chat inclusion options.
+
+### 🧠 Part Grouping for Chain-of-Thought
+
+**Goal:** Organize multi-part reasoning flows into collapsible groups within the transcript.
+**By:** [@OEvgeny](https://github.com/OEvgeny) in [PR #5553](https://github.com/microsoft/BotFramework-WebChat/pull/5553), [#5585](https://github.com/microsoft/BotFramework-WebChat/pull/5585), [#5590](https://github.com/microsoft/BotFramework-WebChat/pull/5590), [#5608](https://github.com/microsoft/BotFramework-WebChat/pull/5608)
+
+- Added logical grouping and context so activities can self-organize via `Message` entity metadata.
+- Introduced a way to render grouped activities and group-aware focus management to keep grouped conversations accessible.
+- Reworked fluent-theme approach to decorating activities.
+- Extended activity ordering to honor entity `position` fields when rendering grouped messages.
+
 ### 🛠️ Migration to `micromark`
 
-**Goal:** Replace `markdown-it` with a modern and extensible markdown parser.  
+**Goal:** Replace `markdown-it` with a modern and extensible markdown parser.
 **By:** [@compulim](https://github.com/compulim) in [PR #5330](https://github.com/microsoft/BotFramework-WebChat/pull/5330)
 
 - Switched to `micromark`, enabling MathML support and consistent parsing.
 - Foundation for better Markdown extensibility and performance.
 
 ### 🧼 HTML Content Transformer Middleware
 
-**Goal:** Move HTML sanitization into a dedicated middleware layer.  
+**Goal:** Move HTML sanitization into a dedicated middleware layer.
 **By:** [@compulim](https://github.com/compulim) in [PR #5338](https://github.com/microsoft/BotFramework-WebChat/pull/5338)
 
 - Clean separation of concerns for Markdown rendering and sanitation.
 - Easier customization and more secure rendering.
 
 ### 🧩 Migration to npm Workspaces
 
-**Goal:** Modernize monorepo tooling for better dependency and package management.  
+**Goal:** Modernize monorepo tooling for better dependency and package management.
 **By:** [@compulim](https://github.com/compulim) in [PR #5301](https://github.com/microsoft/BotFramework-WebChat/pull/5301)
 
 - Dropped Lerna in favor of native npm workspaces.
@@ -47,15 +66,15 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ### 🎨 Icon Customization via CSS Variables
 
-**Goal:** Enable developers to customize Web Chat and Fluent theme icons without JavaScript overrides.  
+**Goal:** Enable developers to customize Web Chat and Fluent theme icons without JavaScript overrides.
 **By:** [@OEvgeny](https://github.com/OEvgeny) in [PR #5413](https://github.com/microsoft/BotFramework-WebChat/pull/5413), [#5502](https://github.com/microsoft/BotFramework-WebChat/pull/5502)
 
 - Introduced CSS variable-based icon customization system for Web Chat and Fluent theme.
 - Reworked existing icons and fully enabled across Web Chat components.
 
 ### 📎 Attachment Preview for `sendAttachmentOn: "send"`
 
-**Goal:** Improve multi-file upload UX by introducing persistent attachment previews.  
+**Goal:** Improve multi-file upload UX by introducing persistent attachment previews.
 **By:** [@compulim](https://github.com/compulim), [@OEvgeny](https://github.com/OEvgeny) in [PR #5464](https://github.com/microsoft/BotFramework-WebChat/pull/5464), [#5491](https://github.com/microsoft/BotFramework-WebChat/pull/5491), [#5492](https://github.com/microsoft/BotFramework-WebChat/pull/5492)
 
 - Added `SendBoxAttachmentBar` to allow users to preview and remove attachments before sending.
@@ -64,7 +83,7 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ### 🧾 Code Block Rendering & Highlighting System
 
-**Goal:** Unify and polish code block rendering across Markdown and UI components.  
+**Goal:** Unify and polish code block rendering across Markdown and UI components.
 **By:** [@OEvgeny](https://github.com/OEvgeny), [@compulim](https://github.com/compulim) in [PR #5334](https://github.com/microsoft/BotFramework-WebChat/pull/5334), [#5335](https://github.com/microsoft/BotFramework-WebChat/pull/5335), [#5336](https://github.com/microsoft/BotFramework-WebChat/pull/5336), [#5389](https://github.com/microsoft/BotFramework-WebChat/pull/5389)
 
 - Introduced syntax highlighting for markdown blocks using Shiki.
@@ -73,23 +92,23 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ### ✨ Fluent Theme Overhaul
 
-**Goal:** Expand and refine Fluent UI styling across all components.  
+**Goal:** Expand and refine Fluent UI styling across all components.
 **By:** [@OEvgeny](https://github.com/OEvgeny) in [PR #5258](https://github.com/microsoft/BotFramework-WebChat/pull/5258) and others
 
 - Introduced "Copilot" variant and transcript-wide theming.
 - Improved accessibility, visual consistency, and component modularity.
 
 ### 🧱 Decorator System for Activity Styling
 
-**Goal:** Enable pluggable, dynamic visual enhancements per activity.  
+**Goal:** Enable pluggable, dynamic visual enhancements per activity.
 **By:** [@OEvgeny](https://github.com/OEvgeny) in [PR #5205](https://github.com/microsoft/BotFramework-WebChat/pull/5205), [#5312](https://github.com/microsoft/BotFramework-WebChat/pull/5312)
 
 - Introduced `WebChatDecorator` and `ActivityDecorator`.
 - Supports animated borders and style options with minimal code changes.
 
 ### 🗂️ Starter Prompts
 
-**Goal:** Enhance onboarding by offering users suggested starter prompts before interaction.  
+**Goal:** Enhance onboarding by offering users suggested starter prompts before interaction.
 **By:** [@compulim](https://github.com/compulim), [@OEvgeny](https://github.com/OEvgeny)
 
 - Experimental pre-chat messages added in [PR #5255](https://github.com/microsoft/BotFramework-WebChat/pull/5255) and [#5263](https://github.com/microsoft/BotFramework-WebChat/pull/5263)
@@ -101,15 +120,15 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ### 🎙️ Speech Recognition Enhancements
 
-**Goal:** Improve real-world usability of voice input.  
+**Goal:** Improve real-world usability of voice input.
 **By:** [@compulim](https://github.com/compulim), [@RushikeshGavali](https://github.com/RushikeshGavali) in [PR #5400](https://github.com/microsoft/BotFramework-WebChat/pull/5400), [#5426](https://github.com/microsoft/BotFramework-WebChat/pull/5426)
 
 - Support for initial silence timeout and continuous barge-in mode.
 - Makes Azure Speech more responsive and accessible.
 
 ### 🔊 Centralized Live Region Announcements
 
-**Goal:** Improve screen reader support via centralized ARIA updates.  
+**Goal:** Improve screen reader support via centralized ARIA updates.
 **By:** [@OEvgeny](https://github.com/OEvgeny) in [PR #5251](https://github.com/microsoft/BotFramework-WebChat/pull/5251)
 
 - Added `usePushToLiveRegion` hook.
@@ -121,15 +140,15 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ### 🧩 Shadow DOM Support
 
-**Goal:** Enable safe embedding of Web Chat in custom element trees.  
+**Goal:** Enable safe embedding of Web Chat in custom element trees.
 **By:** [@OEvgeny](https://github.com/OEvgeny) in [PR #5196](https://github.com/microsoft/BotFramework-WebChat/pull/5196)
 
 - Added `stylesRoot`, `ThemeProvider.styles`, and nonce support.
 - Ensures style encapsulation and isolation in Web Component environments.
 
 ### 🧮 TeX/MathML Markdown Support
 
-**Goal:** Support use cases requiring math rendering.  
+**Goal:** Support use cases requiring math rendering.
 **By:** [@compulim](https://github.com/compulim), [@OEvgeny](https://github.com/OEvgeny) in [PR #5332](https://github.com/microsoft/BotFramework-WebChat/pull/5332), [#5381](https://github.com/microsoft/BotFramework-WebChat/pull/5381)
 
 - Integrated `katex` via `micromark-extension-math`.
@@ -139,27 +158,26 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ## 🚀 Performance & Developer Experience
 
-
 ### 🧩 Introduction of PolyMiddleware
 
-**Goal:** Enable composable, reusable, and unified way for managing middleware.  
+**Goal:** Enable composable, reusable, and unified way for managing middleware.
 **By:** [@compulim](https://github.com/compulim) in [PR #5515](https://github.com/microsoft/BotFramework-WebChat/pull/5515), [#5566](https://github.com/microsoft/BotFramework-WebChat/pull/5566)
 
 - Allows multiple middleware to be composed and applied from a single place.
 - Simplifies extension, testing, and maintenance of middleware logic.
-- Lays groundwork for Web Chat becomoming an UI orchestration.
+- Lays groundwork for Web Chat becoming a UI orchestration layer.
 
 ### 🧠 Memoization & Hook Optimizations
 
-**Goal:** Reduce rerenders and memory footprint.  
+**Goal:** Reduce rerenders and memory footprint.
 **By:** [@OEvgeny](https://github.com/OEvgeny), [@compulim](https://github.com/compulim) across [#5163](https://github.com/microsoft/BotFramework-WebChat/pull/5163), [#5183](https://github.com/microsoft/BotFramework-WebChat/pull/5183), [#5190](https://github.com/microsoft/BotFramework-WebChat/pull/5190)
 
 - Rewrote key hooks (`useActivityWithRenderer`, `useMemoized`) for efficiency.
 - Prevents excessive renders in large conversations.
 
 ### 🧮 Multi-Dimensional Grouping Support
 
-**Goal:** Improve activity grouping logic and performance.  
+**Goal:** Improve activity grouping logic and performance.
 **By:** [@compulim](https://github.com/compulim) in [PR #5471](https://github.com/microsoft/BotFramework-WebChat/pull/5471)
 
 - Added `styleOptions.groupActivitiesBy` and `useGroupActivitiesByName` hook.
@@ -169,10 +187,19 @@ A curated list of major achievements by the Web Chat team. This document celebra
 
 ### 🧪 `valibot` Props Validation
 
-**Goal:** Modernize runtime prop validation for performance and clarity.  
+**Goal:** Modernize runtime prop validation for performance and clarity.
 **By:** [@compulim](https://github.com/compulim) in [PR #5476](https://github.com/microsoft/BotFramework-WebChat/pull/5476)
 
 - Introduced `valibot` to improve schema-based prop safety.
 - Reduces runtime errors and simplifies validation logic.
 
+### 🧪 `html2` test infrastructure
+
+**Goal:** Modernize WebDriver test infrastructure to prioritize debuggability and reproducibility.
+**By:** [@compulim](https://github.com/compulim) in [PR #5311](https://github.com/microsoft/BotFramework-WebChat/pull/5311), along with migrations [PR #5541](https://github.com/microsoft/BotFramework-WebChat/pull/5541), [PR #5543](https://github.com/microsoft/BotFramework-WebChat/pull/5543), [PR #5544](https://github.com/microsoft/BotFramework-WebChat/pull/5544), [PR #5545](https://github.com/microsoft/BotFramework-WebChat/pull/5545), [PR #5546](https://github.com/microsoft/BotFramework-WebChat/pull/5546), [PR #5547](https://github.com/microsoft/BotFramework-WebChat/pull/5547), [PR #5548](https://github.com/microsoft/BotFramework-WebChat/pull/5548), [PR #5549](https://github.com/microsoft/BotFramework-WebChat/pull/5549), [PR #5550](https://github.com/microsoft/BotFramework-WebChat/pull/5550), [PR #5576](https://github.com/microsoft/BotFramework-WebChat/pull/5576), [PR #5577](https://github.com/microsoft/BotFramework-WebChat/pull/5577), [PR #5649](https://github.com/microsoft/BotFramework-WebChat/pull/5649), [PR #5651](https://github.com/microsoft/BotFramework-WebChat/pull/5651), [PR #5652](https://github.com/microsoft/BotFramework-WebChat/pull/5652), [PR #5653](https://github.com/microsoft/BotFramework-WebChat/pull/5653)
+
+- Eliminate `.js` entry file.
+- Put screenshots side-by-side with test to improve debuggability.
+- Improves debuggability by running tests directly in browser.
+
 ---