Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 19 additions & 26 deletions .github/workflows/export-gate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,18 @@ on:
push:
paths:
- 'ReaUI_Builder.html'
- 'tools/export-gate/export_gate.js'
- 'tools/export-gate/**'
- '.github/workflows/export-gate.yml'
pull_request:
paths:
- 'ReaUI_Builder.html'
- 'tools/export-gate/export_gate.js'
- 'tools/export-gate/**'
- '.github/workflows/export-gate.yml'

jobs:
gate:
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v4
with:
Expand All @@ -24,35 +27,25 @@ jobs:

- name: Install jsdom
working-directory: tools/export-gate
run: npm install jsdom
run: npm install --no-save jsdom@26.1.0

# Push to main (or any push with no prior version to diff against): smoke-test only.
# Fails the build on SCRIPT/GENERATOR THROW or non-deterministic generator output.
- name: Smoke check current build
if: github.event_name == 'push'
- name: Run full export gate on current build
run: node tools/export-gate/export_gate.js ReaUI_Builder.html

# PR: diff the PR's version of the file against main's version. A diff is expected
# for a feature/fix PR — this step only fails on SCRIPT/GENERATOR THROW, not on
# CHANGED. Read the log for what actually differs; only an *unintended* widget
# changing is a regression.
- name: Fetch base version of the build
- name: Compare PR against base build
if: github.event_name == 'pull_request'
run: git show origin/${{ github.base_ref }}:ReaUI_Builder.html > base_ReaUI_Builder.html

- name: Diff against base branch
if: github.event_name == 'pull_request'
# CHANGED (exit 1, no THROW text) is expected for most PRs — logged for a human to
# read, not a CI failure. SCRIPT THROW / GENERATOR THROW is a real failure and must
# still fail the job even though both cases share exit code 1, so check the output
# text rather than the exit code alone.
shell: bash
run: |
git show origin/${{ github.base_ref }}:ReaUI_Builder.html > base_ReaUI_Builder.html
set +e
OUTPUT=$(node tools/export-gate/export_gate.js base_ReaUI_Builder.html ReaUI_Builder.html 2>&1)
node tools/export-gate/export_gate.js base_ReaUI_Builder.html ReaUI_Builder.html > export_gate_diff.log 2>&1
STATUS=$?
echo "$OUTPUT"
if echo "$OUTPUT" | grep -q "THROW"; then
echo "::error::export_gate reported a THROW — this is a real failure, not an expected export diff."
exit 1
set -e
cat export_gate_diff.log
if [ "$STATUS" -ge 2 ]; then
echo "::error::Export gate encountered a failure (exit $STATUS)"
exit "$STATUS"
fi
if [ "$STATUS" -eq 1 ]; then
echo "::warning::Export/model outputs changed relative to base. Review the diff above."
fi
exit 0
21 changes: 21 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,27 @@ e.g. `1.0.70`).

## [Unreleased]

## [2.2.3] - 2026-11-13

Stability and audit-remediation release. No project format migration or intended new widget families.

### Fixed
- F01: Ignore stale asynchronous project loads instead of overwriting newer work or history.
- F02: Detect undersized or negative-width adaptive controls inside Table cells, improve geometry diagnostics, and correct nested Table padding in generated Lua.
- F03: Validate Table column sizing consistently on project load and before export, rejecting invalid and surplus configurations.
- F04: Keep Copy/Download disabled after failed generation, even when Preflight is rerun.
- Restore unsaved-change detection, fallback file-read failure handling, and tab presence after back/forward-cache restore.

### Improved
- Cache repeated adaptive geometry work during Preflight and render large diagnostic lists progressively (200 initial rows, all issues retained).
- Add regression coverage for load/recovery, column validation, nested Tables, export gating, and responsive layouts.
- Update export-gate fixture ordering in v13 to recalculate Table cell geometry after changing Table properties; preserves original v12 for historical reproduction. This is a test-harness fix, not a change to the exported Lua engine.

### Verification and remaining scope
- The accepted v2.2.3 HTML differs from dev.6 only in its build-version string.
- Manual browser and REAPER acceptance completed; Chromium-adapted export gate v13 reports 36/36 tested scenes and cross-checks PASS.
- The unmodified Node/jsdom gate and Windows-specific native checks had not been executed in the local release QA environment; GitHub Actions is configured to run the full gate with five repository example fixtures.

## [2.2.0] - 2026-10-15

### Added
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ The editor runs from a single local HTML file. No installation, server, or build
<img alt="ReaUI Builder" src="assets/reaui-builder-logo-light.svg" width="960">
</picture>

**Version 2.2.0** · [Builder HTML](ReaUI_Builder.html) · [English manual](manuals/ReaUI_Builder_Manual_en.md) · [Русское руководство](manuals/ReaUI_Builder_Manual_ru.md) · [Web version](https://patch-34.github.io/reauibuilder)
**Version 2.2.3** · [Release notes](RELEASE_NOTES_2_2_3.md) · [Builder HTML](ReaUI_Builder.html) · [English manual](manuals/ReaUI_Builder_Manual_en.md) · [Русское руководство](manuals/ReaUI_Builder_Manual_ru.md) · [Web version](https://patch-34.github.io/reauibuilder)

## Contents

Expand Down Expand Up @@ -171,7 +171,7 @@ See REAPER's [ReaScript documentation](https://www.reaper.fm/sdk/reascript/reasc

## Current limitations

Version 2.2.0 has the following limitations:
Version 2.2.3 has the following limitations:

- **Preview is approximate.** Group, Table, ColorPicker, and TextWrapped use placeholders. ColorEdit does not reflect all display flags in Preview.
- **Combo and ListBox use placeholder items.** Replace their item strings in the generated code.
Expand All @@ -190,6 +190,6 @@ Check the exported interface in REAPER before distributing your script. The manu
- [English user guide — version 2.2.0](manuals/ReaUI_Builder_Manual_en.md)
- [Русское руководство — версия 2.2.0](manuals/ReaUI_Builder_Manual_ru.md)

Read the Markdown manuals directly on GitHub. They include the full widget catalog, inspector reference, flags, keyboard shortcuts, and export examples. The same manual is also available inside Builder through **Help → User Manual ↗**.
The manuals document the interface through v2.2.0; v2.2.3 is a stability release with no new widget families. Read the Markdown manuals directly on GitHub. They include the full widget catalog, inspector reference, flags, keyboard shortcuts, and export examples. The same manual is also available inside Builder through **Help → User Manual ↗**.

Use **Help → Report a Bug…** in Builder when preparing a report. It assembles a ready-to-send report from the last 50 logged actions, the build number, and the current window size; add a short description of what happened and, optionally, check **Include my layout** to attach the whole project. Copy the report and send it to the listed address. For export problems, also mention the REAPER and ReaImGui versions.
19 changes: 19 additions & 0 deletions RELEASE_NOTES_2_2_3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# ReaUI Builder v2.2.3

This maintenance release focuses on reliability, predictable export, and safer project handling.

**Highlights**

- Protects unsaved work from stale asynchronous project loads.
- Detects invalid adaptive TableCell geometry before a broken Lua script can be exported.
- Validates Table column configurations consistently during load and Preflight.
- Prevents Copy/Download from reopening after a failed generation.
- Improves table diagnostics and fixes nested-table padding in exported Lua.
- Speeds up repeated Preflight and displays large diagnostic lists progressively.
- Strengthens recovery and file-handling behavior across browser lifecycle events.

The project JSON format is unchanged. Existing projects can be opened in the new version. As always, retain backups of important projects and test generated UI in REAPER.

**Verification:** 11/11 independent Chromium regression suites passed; 12 Lua syntax checks passed. Manual browser and REAPER acceptance was reported as passed. The historical export-gate tool and Windows native matrix were not rerun in this package's automated validation; details are recorded in the technical report.

Download the single `ReaUI_Builder_2_2_3.html` file and open it locally. No build step or server is needed.
504 changes: 444 additions & 60 deletions ReaUI_Builder.html

Large diffs are not rendered by default.

Loading
Loading