Fix Collections UX + Portal export (still 1.3.0)

Author: BF6 Portal Developer

CHANGELOG.md

@@ -16,6 +16,8 @@ This project follows a pragmatic changelog style (human-written notes) rather th
 - **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).
+- **Collections help:** right-click Help now includes local documentation for Collections blocks.
+- **Collections navigation polish:** jump-to-definition is centered and context-menu labels include the collection name.
 - **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.
@@ -34,6 +36,10 @@ This project follows a pragmatic changelog style (human-written notes) rather th
 - **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.
 
+- **Portal export compatibility:** preserve required `extraState` metadata on structural blocks and subroutines so exports import cleanly in the official Portal editor.
+- **Portal export correctness:** expanded collection stacks now reassign block IDs to avoid duplicate IDs.
+- **Collections call-name rendering:** call blocks and flyout entries now reliably display the chosen collection name.
+
 ### Credits (v1.3.0)
 
 - Add explicit credit for the **Portal Docs** dataset used to populate block help/tooltips:

README.md

@@ -22,7 +22,7 @@ Changelog: see `CHANGELOG.md`.
     - save your own presets, overwrite safely, delete user presets
 - **Import / Export:**
     - load `.json` (Blockly workspace JSON) and legacy `.xml`
-    - export Portal JSON (best-effort compatibility wrapper)
+    - export Portal JSON (best-effort compatibility; imports into the official Portal editor for supported templates)
     - TypeScript snapshot export + TypeScript import (round-trip the workspace state)
 - **Variables:** a dedicated VARIABLES toolbox category with:
     - “New / Manage Variables”

docs/RELEASE_NOTES_1.2.8.md

@@ -2,7 +2,7 @@
 
 ## Screenshot
 
-<img src="screenshots/editor.png" alt="BF6Portal Tool editor screenshot" width="1100" />
+<img src="screenshots/UI-overview.png" alt="BF6Portal Tool editor screenshot" width="1100" />
 
 ## Features & Improvements
 - **Refined Toolbox Structure:** The Blockly toolbox has been reorganized to better match the official Battlefield Portal Rules Editor layout.

docs/RELEASE_NOTES_1.2.9.md

@@ -2,7 +2,7 @@
 
 ## Screenshot
 
-<img src="screenshots/editor.png" alt="BF6Portal Tool editor screenshot" width="1100" />
+<img src="screenshots/UI-overview.png" alt="BF6Portal Tool editor screenshot" width="1100" />
 
 ## Highlights
 

docs/RELEASE_NOTES_1.3.0.md

@@ -7,6 +7,7 @@
 - **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.
+- **Portal export compatibility:** exported templates now round-trip more reliably into the official Battlefield Portal editor (preserves critical metadata like `extraState`).
 
 ## Changes
 
@@ -24,6 +25,9 @@
 - 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.
+- **Collection names now render reliably** in the flyout and on spawned call blocks (no more “COLLECT” with a blank name).
+- **Jump-to-definition is centered** (accounts for the fixed header) and the menu label is now contextual (e.g. “Jump to Coll 3”).
+- **Right-click Help** now shows local documentation for Collections blocks.
 
 ### Variables
 
@@ -44,6 +48,8 @@
 - 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.
+- **Portal JSON round-trip:** preserve Portal-required `extraState` on structural blocks and subroutines so exports import cleanly in the official editor.
+- **Export correctness:** expanding collections during export now reassigns block IDs to avoid duplicate IDs.
 - **Performance polish:** reduced redundant toolbox refresh work after programmatic loads.
 - **Console noise reduction:** noisy informational logs during preset loads are now gated behind an opt-in debug flag (`localStorage.bf6_debug = "1"`).
 

docs/screenshots/README.md

@@ -3,8 +3,10 @@
 Drop screenshots for the README/release notes in this folder.
 
 Recommended names:
-- `editor.png` — main editor UI (shows presets dropdown + blocks loaded)
-- `selection-lists.png` — selection list dropdown open
+- `UI-overview.png` — main editor UI overview (used by the main README)
+- `preset-system.png` — presets dropdown system
+- `variables.png` — variables toolbox category
+- `resizeable-codewindow.png` — code preview drawer
+- `colapsable-blocks.png` — collapsing blocks
 
-Note: The repository currently includes a tiny placeholder `editor.png` so documentation renders cleanly.
-Replace it with a real screenshot whenever you're ready.
+Tip: Keep filenames stable so older release notes and README links keep working.