Docs/UI: credits + changelog; fix code preview init

Author: BF6 Portal Developer

CHANGELOG.md

@@ -0,0 +1,37 @@
+# Changelog
+
+This project follows a pragmatic changelog style (human-written notes) rather than auto-generated commit dumps.
+
+## Unreleased (planned for v1.2.9)
+
+### 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
+- Add explicit credit for the **Portal Docs** dataset used to populate block help/tooltips:
+  - https://github.com/battlefield-portal-community/portal-docs
+
+### CI/CD
+- GitHub Actions: release automation on tag push (creates GitHub Release and uploads Windows artifacts).
+
+### Notes / Investigations log
+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.8
+
+### Features & Improvements
+- 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
+- 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
+- A persistent vertical scrollbar may still appear next to the toolbox flyout in certain states.

README.md

@@ -4,12 +4,15 @@
 ![License](https://img.shields.io/badge/license-ISC-green.svg)
 
 Release notes: see `docs/RELEASE_NOTES_1.2.8.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
 
-![BF6Portal Tool editor screenshot](docs/screenshots/editor.png)
+<img src="docs/screenshots/editor.png" alt="BF6Portal Tool editor screenshot" width="1100" />
+
+> Note: The repo currently includes a tiny placeholder image. Replace `docs/screenshots/editor.png` with a real screenshot any time.
 
 ## Features
 
@@ -77,6 +80,11 @@ The installer output is written to `dist/`.
 
 Utilities live in `tools/` (used to generate/inspect blocks/toolboxes from Portal data).
 
+## 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
+
 ## License
 
 ISC

TODO.md

@@ -4,3 +4,9 @@
     - **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.
+
+## Upcoming (target: v1.2.9)
+
+- [ ] **Selection Lists:** dropdowns can get stuck on “(loading selection lists…)” in some builds; improve runtime asset loading for Electron `file://`.
+- [ ] **Presets:** saving after editing a loaded preset should always work (save-as copy / overwrite flow).
+- [ ] **Credits:** add explicit credit/link for Portal Docs data source in About modal and repo README.

docs/RELEASE_NOTES_1.2.8.md

@@ -2,7 +2,7 @@
 
 ## Screenshot
 
-![BF6Portal Tool editor screenshot](screenshots/editor.png)
+<img src="screenshots/editor.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.
@@ -19,5 +19,9 @@
 - **Scrollbar Styling:** Applied CSS fixes to suppress unwanted scrollbars on the toolbox container (work in progress).
 - **Presets dropdown restored:** Built-in presets (Rush/Conquest/Breakthrough) are visible again and **locked** from deletion; user presets can be saved/deleted normally.
 
+## 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/screenshots/editor.png

@@ -656,6 +656,14 @@
             >BattlefieldPortalHub</a>
             discord team.
           </div>
+          <div style="margin-top: 8px; font-size: 0.98em; opacity: 0.92;">
+            Portal data/help powered by <a
+              href="https://github.com/battlefield-portal-community/portal-docs"
+              target="_blank"
+              rel="noopener noreferrer"
+              style="color:#b0e0ff; font-weight: bold; text-decoration: underline;"
+            >battlefield-portal-community/portal-docs</a>.
+          </div>
         </div>
       </div>
     </div>

web_ui/index.html

@@ -148,7 +148,9 @@ function scheduleCodePreviewRefresh() {
 }
 
 function initLiveCodePreview() {
+    if (window.__bf6LiveCodePreviewBound) return;
     if (!window.workspace || typeof window.workspace.addChangeListener !== 'function') return;
+    window.__bf6LiveCodePreviewBound = true;
     // Initial render
     scheduleCodePreviewRefresh();
     window.workspace.addChangeListener(() => {

web_ui/main.js

@@ -30,6 +30,15 @@ import './components/MenuBar.css';
 // Expose toolbox globally for legacy scripts
 (window as any).TOOLBOX_CONFIG = toolbox;
 
+// This repo's shipped `web_ui/dist/index.html` currently loads both:
+// - legacy global Blockly via <script src="blockly/...">
+// - this webpack bundle which imports Blockly from node_modules
+// To avoid subtle mismatches (e.g., code preview / save using a different Blockly instance
+// than the workspace was created with), we deliberately point the global `window.Blockly`
+// at the same instance used by this bundle.
+(window as any).Blockly = Blockly;
+(window as any).__bf6_blockly = Blockly;
+
 let menuBar: MenuBar | undefined;
 
 // Initialize Menu Bar
@@ -152,6 +161,17 @@ try {
   // Expose workspace globally
   (window as any).workspace = ws;
 
+  // Legacy `web_ui/main.js` owns the Code Preview drawer implementation.
+  // When the workspace is created by this bundle, explicitly kick the preview on.
+  try {
+    const g: any = window as any;
+    if (typeof g.initLiveCodePreview === 'function') {
+      g.initLiveCodePreview();
+    }
+  } catch (e) {
+    console.warn('[BF6] Failed to init live code preview:', e);
+  }
+
     // Presets dropdown (3 locked built-ins + user save/delete).
     // NOTE: We bind in capture phase to prevent legacy `web_ui/main.js` handlers
     // (which use global Blockly) from interfering with this webpack/TS workspace.

web_ui/src/index.ts

@@ -573,15 +573,15 @@ function saveCurrentWorkspaceAsPreset(workspace: AnyWorkspace) {
   if (selected.kind === 'builtin' && (selected as any).name) defaultName = `${(selected as any).name} (Copy)`;
   if (selected.kind === 'user' && (selected as any).name) defaultName = (selected as any).name;
 
-  let name = prompt('Preset name:', defaultName);
-  if (!name) return;
-  name = name.trim();
+  const raw = prompt('Preset name:', defaultName);
+  if (raw == null) return;
+  let name = raw.trim();
   if (!name) return;
 
   // Prevent overwriting built-ins by name.
   if (builtins.some((b) => b.name.toLowerCase() === name.toLowerCase())) {
-    alert('That name matches a locked built-in preset. Please choose a different name (it will be saved as a new preset).');
-    return;
+    // Friendly UX: don't hard-block. Auto-suffix so users can quickly save a copy.
+    name = `${name} (Copy)`;
   }
 
   const user = loadUserPresets();
@@ -652,8 +652,19 @@ export function initPresetsUI(workspace: AnyWorkspace) {
     saveBtn.addEventListener(
       'click',
       (e) => {
+        e.preventDefault();
         e.stopImmediatePropagation();
-        saveCurrentWorkspaceAsPreset(workspace);
+        e.stopPropagation();
+        try {
+          saveCurrentWorkspaceAsPreset(workspace);
+        } catch (err) {
+          console.warn('[BF6] Save preset failed:', err);
+          try {
+            alert(`Save preset failed: ${String((err as any)?.message || err)}`);
+          } catch {
+            // ignore
+          }
+        }
       },
       true
     );

web_ui/src/presets.ts

@@ -75,9 +75,30 @@ function parseSelectionListsMarkdown(md: string): SelectionListMap {
 }
 
 async function fetchText(url: string): Promise<string> {
-  const res = await fetch(url, { cache: 'no-store' });
-  if (!res.ok) throw new Error(`HTTP ${res.status} for ${url}`);
-  return await res.text();
+  // Primary path: browser/Electron fetch.
+  try {
+    const res = await fetch(url, { cache: 'no-store' });
+    if (!res.ok) throw new Error(`HTTP ${res.status} for ${url}`);
+    return await res.text();
+  } catch (e) {
+    // Electron file:// can be flaky with fetch for local assets. Since this app
+    // runs with Node integration enabled, fall back to fs when available.
+    try {
+      const g: any = globalThis as any;
+      const req = g?.require;
+      if (typeof req !== 'function') throw e;
+
+      const fs = req('fs') as typeof import('fs');
+      const path = req('path') as typeof import('path');
+      const { fileURLToPath } = req('url') as typeof import('url');
+
+      const assetUrl = new URL(url, window.location.href);
+      const assetPath = fileURLToPath(assetUrl);
+      return fs.readFileSync(path.resolve(assetPath), 'utf8');
+    } catch {
+      throw e;
+    }
+  }
 }
 
 export async function preloadSelectionLists(): Promise<void> {