feat: v1.3.0 UI + collections + selection lists

Author: BF6 Portal Developer

CHANGELOG.md

@@ -2,53 +2,87 @@
 
 This project follows a pragmatic changelog style (human-written notes) rather than auto-generated commit dumps.
 
-## Unreleased (planned for v1.3.0)
+## Unreleased
+
+> Target release: **v1.3.0** (first official release). We’re still finishing/polishing this version.
+
+- **UI/UX:** eliminate the persistent toolbox/flyout vertical scrollbar artifact by hiding scrollbar chrome on Blockly’s inner scroll containers (not just the outer toolbox div).
+- **Window default:** app now opens maximized with a 1920×1080 (1080p) target size (clamped to the display work area) so the editor fills the screen by default.
+
+## v1.3.0
+
+### Features & Improvements (v1.3.0)
+
+- **Header/layout cleanup:** brand/logo aligned left, toolbox search moved into the header, and the app version is shown top-right.
+- **Workspace controls in header:** zoom in/out/reset/fit + trash moved to the top-right header to keep the canvas clear.
+- **UI clutter removed:** removed the unused Live Diagnostics overlay and the floating Code Preview button (Code Preview is now a normal header button).
+- **Collections UX:** COLLECTIONS toolbox category now dynamically lists existing collections and includes a “Convert selection to collection” action.
+- **Collections visuals:** collection call/definition blocks are taller (easier to spot in large workspaces).
+- **Variables toolbox:** restored a working VARIABLES category (manage/create button + existing variables listed as pre-filled GET/SET blocks).
+- **Selection Lists:** regenerated `selection-lists.md` so `widget 1` uses the base enum name (no `Item` suffix).
+- **Selection Lists dropdowns:** runtime lookups are now case-insensitive and support alias mapping for mismatched enum names.
+
+### Fixes (v1.3.0)
 
-### Fixes
 - **Selection Lists dropdowns:** address cases where dropdowns get stuck on “(loading selection lists…)” by improving runtime asset loading for Electron `file://` contexts.
 - **Presets:** allow saving after loading and editing a built-in preset (save-as copy / overwrite flow).
 
-### Credits
+- **Presets (Electron file://):** built-in preset loading now falls back to reading JSON from disk when `fetch()` is unavailable/restricted in packaged builds.
+
+- **Electron compatibility:** removed remaining native `prompt()` usage by routing prompts through Blockly dialogs (Electron does not support `window.prompt`).
+- **Presets/imports:** ensure critical Portal structural types (like `modBlock` with a `RULES` statement) are defined before loading templates.
+- **Version label:** app version now resolves in both dev and packaged `app.asar` layouts.
+
+### Credits (v1.3.0)
+
 - Add explicit credit for the **Portal Docs** dataset used to populate block help/tooltips:
-  - https://github.com/battlefield-portal-community/portal-docs
+    - [battlefield-portal-community/portal-docs](https://github.com/battlefield-portal-community/portal-docs)
+
+### CI/CD (v1.3.0)
 
-### CI/CD
 - GitHub Actions: release automation on tag push (creates GitHub Release and uploads Windows artifacts).
 
-### Notes / Investigations log
+### Notes / Investigations log (v1.3.0)
+
 These are the key issues encountered recently and how they were fixed:
+
 - **“Container menuBarContainer not found”**: fixed by guarding MenuBar initialization when optional container isn’t present.
 - **Preset templates failing to load (`MissingConnection` / `modBlock` RULES)**: fixed by ensuring `modBlock` always provides a `RULES` statement input before loading presets.
 - **Packaged app missing `selection-lists.md`**: Electron build excludes `*.md`, so runtime now ships/loads `selection-lists.txt` instead.
 - **Code Preview stopped showing TypeScript**: caused by loading two Blockly instances (global script + webpack import) and serializing a workspace created by the “other” instance. Fixed by making the webpack Blockly instance the global `window.Blockly` and explicitly initializing the preview after workspace creation.
 
 ## v1.2.9
 
-### Features & Improvements
+### Features & Improvements (v1.2.9)
+
 - **Collections / Bookmarks (MVP):** convert a stack into an offscreen collection definition and leave a compact call/bookmark block in place.
-  - Right-click: **Convert to collection (bookmark + move stack)**
-  - Right-click: **Jump to collection definition** (teleport)
+    - Right-click: **Convert to collection (bookmark + move stack)**
+    - Right-click: **Jump to collection definition** (teleport)
 - **Canvas navigation (right-click teleport):** fast jumping around large workspaces.
-  - MOD: jump to the MOD container
-  - Rules: jump to owning Rule / first Rule
-  - Variables: jump between first getter/setter
-  - Generic: jump to stack root
-  - Subroutines: jump Call ↔ Definition
+    - MOD: jump to the MOD container
+    - Rules: jump to owning Rule / first Rule
+    - Variables: jump between first getter/setter
+    - Generic: jump to stack root
+    - Subroutines: jump Call ↔ Definition
+
+### Fixes (v1.2.9)
 
-### Fixes
 - **Portal JSON compatibility:** export wrapped Portal-style JSON (`{"mod":{"blocks":...}}`) and accept both wrapped + raw Blockly workspace JSON on import.
 - **Help system:** stable search input (no scrambled text while typing) and right-click help opens the same local docs as the main Help UI.
 
 ## v1.2.8
 
-### Features & Improvements
+### Features & Improvements (v1.2.8)
+
 - Presets dropdown restored with **3 locked built-ins** (Andy6170 templates) + user save/delete.
 - Placeholder block auto-registration so community templates still render even if some block types are missing.
 - Selection list blocks use dynamic dropdowns (values sourced from `selection-lists` data).
 
-### Fixes
+### Fixes (v1.2.8)
+
 - Guarded UI init to avoid runtime errors when optional containers aren’t present.
 - Improved preset loading resilience and viewport focus (avoid “loaded offscreen / looks empty”).
 
-### Known Issues
+### Known Issues (v1.2.8)
+
 - A persistent vertical scrollbar may still appear next to the toolbox flyout in certain states.

README.md

@@ -1,16 +1,16 @@
 # BF6Portal Tool
 
-![Version](https://img.shields.io/badge/version-1.2.8-blue.svg)
+![Version](https://img.shields.io/badge/version-1.3.0-blue.svg)
 ![License](https://img.shields.io/badge/license-ISC-green.svg)
 
-Release notes: see `docs/RELEASE_NOTES_1.2.8.md`.
+Release notes: see `docs/RELEASE_NOTES_1.3.0.md`.
 Changelog: see `CHANGELOG.md`.
 
 **BF6Portal Tool** is a standalone visual logic editor for **Battlefield 6 Portal**, built with **Electron** + **Google Blockly**. It aims to replicate the Portal Rules Editor workflow in a desktop app, with offline editing and quality-of-life tooling.
 
 ## Screenshot
 
-<img src="docs/screenshots/editor.png" alt="BF6Portal Tool editor screenshot" width="1100" />
+![BF6Portal Tool editor screenshot](docs/screenshots/editor.png)
 
 > Note: The repo currently includes a tiny placeholder image. Replace `docs/screenshots/editor.png` with a real screenshot any time.
 
@@ -20,7 +20,7 @@ Changelog: see `CHANGELOG.md`.
 - **Import compatibility:** loads Blockly JSON exports, including common community/template wrappers like `{ "mod": { ... } }`.
 - **Resilient template loading:** missing block `type`s are auto-registered as **placeholder blocks** so templates can still render.
 - **Presets:** 3 locked built-ins (Andy6170 templates) + user save/delete via `localStorage`.
-- **Help modal + right-click help:** offline docs from `bf6portal_blocks.json` and per-block “Help: <type>”.
+- **Help modal + right-click help:** offline docs from `bf6portal_blocks.json` and per-block “Help: `<type>`”.
 - **Code Preview drawer:** resizable bottom drawer showing a TypeScript export of the current workspace state.
 
 ## Installation & setup
@@ -39,7 +39,7 @@ git clone https://gitlab.com/Neuro1977/bf6-portal-tool.git
 cd BF6Portal-Tool
 ```
 
-2) Install dependencies:
+1) Install dependencies:
 
 ```bash
 npm install
@@ -48,7 +48,7 @@ npm install
 cd ..
 ```
 
-3) Run the app:
+1) Run the app:
 
 ```bash
 npm start
@@ -83,7 +83,7 @@ Utilities live in `tools/` (used to generate/inspect blocks/toolboxes from Porta
 ## Credits
 
 - Block help/tooltips and Portal data are derived from **Portal Docs** by the Battlefield Portal Community:
-	- https://github.com/battlefield-portal-community/portal-docs
+    - [battlefield-portal-community/portal-docs](https://github.com/battlefield-portal-community/portal-docs)
 
 ## License
 

TODO.md

@@ -1,11 +1,14 @@
 # TODO
 
-- [ ] **UI/UX:** Fix persistent vertical scrollbar appearing next to the toolbox flyout after interacting with menus. 
+- [x] **Docs:** keep `CHANGELOG.md` and `docs/RELEASE_NOTES_*.md` aligned with the current shipped app version.
+- [x] **Docs:** update `README.md` version badge + release notes link.
+
+- [x] **UI/UX:** Fix persistent vertical scrollbar appearing next to the toolbox flyout after interacting with menus.
     - **Location:** Left side of the screen, adjacent to the Blockly toolbox category list.
-    - **Current State:** CSS attempts to hide scrollbars on `.blocklyToolboxDiv`, `.blocklyToolbox`, and `.blocklyFlyout` have reduced but not fully eliminated the artifact in some states.
-    - **Potential Cause:** Electron/Chromium native scrollbar rendering on a dynamic container created by Blockly or the custom search bar injection.
+    - **Fix:** Hide scrollbar chrome on the actual inner scroll containers Blockly uses in this build (e.g. `.blocklyToolboxContents`, `.blocklyToolboxContentsWrapper`, `.blocklyTreeRoot`) plus a defensive `::-webkit-scrollbar` rule for nested elements.
+    - **Notes:** This keeps scrolling functional but removes the persistent native scrollbar artifact under Electron/Chromium.
 
-## Upcoming (target: v1.3.0)
+## Completed (v1.3.0)
 
 - [x] **Toolbox search:** restore the search box above the toolbox (above **RULES**) and keep it working in packaged Electron builds.
 
@@ -19,7 +22,16 @@
 
 - [x] **Portal JSON compatibility:** exported/imported workspace JSON matches Portal-style wrapper (`{"mod":{"blocks":...}}`), and importer accepts both wrapped and raw Blockly workspace formats.
 
-- [ ] **TypeScript import:** add a TypeScript → Blocks import flow. For now, show an **Import TS (Coming soon)** button until we can guarantee correctness.
+- [x] **TypeScript import (placeholder):** show an **Import TS (Coming soon)** button until we can guarantee correctness of a full TypeScript → Blocks import flow.
+
+- [x] **Navigation / Teleport (right-click):** jump helpers to quickly move around the canvas.
+    - [x] Subroutines: Call ↔ Definition
+    - [x] MOD: jump to MOD container
+    - [x] Rules: jump to owning Rule / first Rule
+    - [x] Variables: jump between first getter/setter
+    - [x] Generic: jump to stack root
+
+## Next (post v1.3.0)
 
 - [ ] **Collections / Snippets (macro library):** let users save a selection of blocks as a reusable “collection” and insert/execute it later.
     - UX idea: right-click selection / block → **Save as Collection…**, then a toolbox menu **Collections**.
@@ -28,17 +40,11 @@
     - [x] MVP (bookmark-style): new **COLLECT** call block + offscreen **COLLECTION** definition block.
     - [x] Right-click: **Convert to collection (bookmark + move stack)** and **Jump to collection definition**.
     - [x] Codegen: call block inlines the definition stack (recursion guarded).
-    - [ ] Next: make the call block use a dropdown of existing collections (avoid typos).
-    - [ ] Next: optional “Export for Portal” flow that expands collections and strips tool-only blocks.
-
-- [x] **Navigation / Teleport (right-click):** jump helpers to quickly move around the canvas.
-    - [x] Subroutines: Call ↔ Definition
-    - [x] MOD: jump to MOD container
-    - [x] Rules: jump to owning Rule / first Rule
-    - [x] Variables: jump between first getter/setter
-    - [x] Generic: jump to stack root
+    - [x] Next: toolbox **COLLECTIONS** flyout dynamically lists existing collections.
+    - [x] Next: make the call block itself use a dropdown of existing collections (avoid typos), while still allowing manual entry when importing older workspaces.
+    - [x] Next: optional “Export for Portal” flow that expands collections and strips tool-only blocks.
 
-- [ ] **External reference:** review `deluca-mike/bf6-portal-scripting-template` for ideas (TS bundling, debug UI patterns). **Do not reuse code** unless a license/permission is clarified; keep notes/attribution up to date.
+- [ ] **External reference:** review `deluca-mike/bf6-portal-scripting-template` for ideas (TS bundling, debug UI patterns). Permission has been confirmed; still respect any upstream license/restrictions and keep attribution up to date.
 
 - [ ] **Project cleanup / stabilization (v1.3.0 goal):**
     - remove unnecessary comments, dead code paths, and stale file references

docs/RELEASE_NOTES_1.2.9.md

@@ -0,0 +1,37 @@
+# Release Notes - v1.2.9
+
+## Screenshot
+
+<img src="screenshots/editor.png" alt="BF6Portal Tool editor screenshot" width="1100" />
+
+## Highlights
+
+- **Collections / Bookmarks (MVP):** convert a stack into an offscreen collection definition and leave a call/bookmark block in place.
+- **Right-click teleport / navigation:** faster movement around large workspaces (MOD, Rules, Subroutines, stack root, etc.).
+- **Portal JSON compatibility:** exports in Portal wrapper format (`{ "mod": { "blocks": ... } }`) and imports accept multiple common shapes.
+
+## Features & Improvements
+
+- **Collections toolbox improved:** the **COLLECTIONS** category now dynamically lists existing collections and includes a **Convert selection to collection** action.
+- **Collections visuals:** collection call/definition blocks are taller (easier to spot; less “lost in the soup”).
+- **Header/UI polish:**
+  - brand/logo aligned on the left
+  - toolbox search moved into the header
+  - version label shown top-right
+  - Code Preview opened via a normal header button
+- **Variables toolbox restored:** VARIABLES category provides a **New / Manage Variables** button and lists existing variables as pre-filled GET/SET blocks.
+
+## Fixes
+
+- **Selection Lists dataset:** regenerated `selection-lists.md` so `widget 1` uses the base enum name (no `Item` suffix).
+- **Selection Lists dropdown robustness:** case-insensitive lookups + alias mapping for enum naming mismatches.
+- **UI clutter:** removed the unused Live Diagnostics overlay and floating Code Preview toggle.
+
+## Credits
+
+- Portal data and block help/tooltips are derived from **Portal Docs** by the Battlefield Portal Community:
+  - https://github.com/battlefield-portal-community/portal-docs
+
+## Known Issues
+
+- A persistent vertical scrollbar may still appear next to the toolbox flyout in certain states. This is tracked for a future fix.

docs/RELEASE_NOTES_1.3.0.md

@@ -0,0 +1,49 @@
+# Release Notes - v1.3.0
+
+## Highlights
+
+- **Collections / Bookmarks (quality-of-life):** COLLECTIONS is now a dynamic toolbox category with a one-click “Convert selection to collection” action and improved visuals.
+- **Navigation (“teleport”):** right-click jump helpers expanded (MOD / rules / stack root / variables / subroutine call ⇄ definition).
+- **Cleaner workspace controls:** zoom in/out/reset/fit + trash moved to the top-right header (no on-canvas zoom/trash UI).
+- **Preset workflow stability:** built-in presets remain locked, but you can save copies and overwrite your own presets safely.
+- **Import resilience:** community/Portal JSON imports now auto-register placeholder blocks for missing types so templates still load instead of failing hard.
+
+## Changes
+
+### UI / UX
+
+- Header/layout cleanup: brand/logo aligned left, toolbox search moved into the header, app version shown top-right.
+- Reduced UI clutter: Code Preview is a normal header button; removed unused diagnostics overlay.
+- Workspace controls moved to the header (top-right): zoom in/out/reset/fit + trash (Blockly’s on-canvas zoom/trash UI is disabled/hidden).
+- **Default window size / fullscreen feel:** the app now opens maximized with a 1920×1080 (1080p) target size (clamped to your display work area) so it fills the screen on standard 1080p desktops.
+- Fixed the persistent toolbox/flyout vertical scrollbar artifact by hiding native scrollbar chrome on Blockly’s inner scroll containers.
+
+### Collections
+
+- Collection call/definition blocks are taller and more visible.
+- Toolbox flyout lists existing collections and can create one from the current selection.
+- Context menus support convert, jump, and rename flows.
+
+### Variables
+
+- Restored a working VARIABLES category:
+  - “New / Manage Variables” button.
+  - Existing variables appear as pre-filled GET/SET templates.
+- **Electron compatibility:** replaced native `prompt()` flows with a Blockly dialog prompt modal (Electron doesn’t support `window.prompt`).
+
+### Selection Lists
+
+- Regenerated `selection-lists` enums so widget naming is normalized (no `Item` suffix where it shouldn’t be).
+- Runtime dropdown lookup is case-insensitive and supports alias mapping.
+- Packaged builds load `selection-lists.txt` (Electron builds exclude `*.md`).
+
+### Import / Presets compatibility
+
+- Portal/community wrapper formats supported (e.g. `{ "mod": { ... } }`).
+- Placeholder block auto-registration prevents missing block types from breaking loads.
+- Ensured critical Portal structural blocks (like `modBlock` with `RULES`) exist before loading templates.
+- Built-in presets load reliably in packaged Electron builds under `file://` by falling back to disk reads when `fetch()` is unavailable.
+
+## Notes
+
+- Windows icon assets are sourced from the project’s `web_ui/assets/img/` and built into the installer via electron-builder.