dwa

Author: NextdoorPsycho

README.md

@@ -6,15 +6,15 @@ Version 3.1.0 — a from-scratch rewrite in [arcane_jaspr](https://github.com/Ar
 
 ## Features
 
-- **Visual canvas** in block space: zoom/pan, grid + snapping, drag components, selection, keyboard nudge. Renders text (legacy `&` codes and MiniMessage, in the Minecraft font), item sprites, pixel-art image icons and animated icons at the exact in-game metrics (0.21875 blocks per text line, `uiScale` semantics, hitbox overlays matching the plugin's `debugHitbox`).
+- **Visual canvas** in block space: zoom/pan, grid + snapping, drag components, selection, keyboard nudge. Uses the runtime's documented text-line scale, `uiScale` semantics and hitbox geometry while clearly separating approximations that depend on the Minecraft client.
 - **Linked button hitboxes**: text and image click planes follow the visible render, while an optional custom width and height can replace automatic icon-derived sizing without creating an independent position that can drift away.
-- **Runtime 3D preview**: reproduces the open pose, `followPlayer` position and yaw, fixed / vertical / horizontal / center icon billboards, matching click planes, hover push and nearest-click behavior. PlaceholderAPI tokens remain literal because the browser has no server context; the preview reports their `refreshTicks` cadence instead.
+- **Runtime 3D preview**: simulates the open pose, `followPlayer` position and yaw, fixed / vertical / horizontal / center icon billboards, click planes, hover push and nearest-click behavior. Client text wrapping, culling, brightness, entity models, effects, obstruction and competition between personal menus and boards still require in-game validation. PlaceholderAPI tokens remain literal because the browser has no server context; the preview reports their `refreshTicks` cadence instead.
 - **Full format coverage** as the plugin's Gson actually reads it — all three component types (button / decoration / toggle), all seven authorable icon types (text / textImage / animatedTextImage / item / block / customItem / entity), all six actions (command / sound / message / teleport / connect / navigate), toggle conditions, `maxDistance`, `closeOnDeath`, `closeOnTeleport`, `customModelValue` (the real key — the `customModelData` older files carry is migrated on import).
 - **Code view** with two-way sync, plus split view. Validated menu handoffs retain their exact source formatting and extension keys through storage and export until the first visual edit or explicit Format action.
-- **Validation** engine encoding the plugin's real parsing rules (lowercase registry keys, action source spellings, silent-zero pitfalls like `volume: 0`, legacy and MiniMessage formatting, hitbox overlap warnings).
-- **Image library**: upload validated PNG pixel art, preview exactly as the plugin rasterizes it, export `images.zip` laid out for `plugins/holoui/images/`. Server sync preserves captured PNG, JPEG, GIF, WebP and BMP bytes losslessly.
-- **Workspace**: folders, multiple menus and flow boards, atomic IndexedDB autosave with previous-transaction recovery and cross-tab conflict protection, undo/redo, templates, and searchable catalogs. Existing `holoui.workspace.v1` / `v2` localStorage data migrates once without deleting the rollback copy.
-- **Optional server sync**: capability links opened from `/holoui edit` import an exact menu or persistent world-board graph through the configured relay. Board publication retains the bound no-delete baseline and adds only menus reachable from the board root, leaving unrelated folder documents local. **Publish to Server** appears beside Import and Export only during a live capability session; it durably saves a board project and hot-reloads the running board, while revision conflicts never overwrite local work. Links use the configured HTTPS relay (the plugin defaults to `https://sync.holoui.volmitsoftware.com/v1`) or a localhost HTTP development relay; an unreachable provider is reported without implying that a deployment is available.
+- **Validation** engine aligned with the plugin's authoring contract (lowercase registry keys, action source spellings, silent-zero pitfalls like `volume: 0`, legacy and MiniMessage formatting, hitbox overlap warnings).
+- **Image library**: upload validated PNG pixel art, preview with the plugin's rasterization rules, export `images.zip` laid out for `plugins/holoui/images/`. Server sync preserves captured PNG, JPEG, GIF, WebP and BMP bytes losslessly.
+- **Workspace**: folders, multiple menus and menu flow maps, atomic IndexedDB autosave with previous-transaction recovery and cross-tab conflict protection, undo/redo, templates, and searchable catalogs. Renaming a runtime id updates navigation, linked board roots and sync scope as one checked save; dropped JSON opens as a uniquely named document instead of replacing the active one. Existing `holoui.workspace.v1` / `v2` localStorage data migrates once without deleting the rollback copy.
+- **Optional server sync**: capability links opened from `/holoui edit` import an exact menu or persistent world-board graph through the configured relay. Linked boards expose typed root-menu, transform, follow, audience, permission and range controls, with strict JSON under Advanced. Board publication retains the bound no-delete baseline and adds only menus reachable from the board root, leaving unrelated folder documents local. A labelled **Publish to Server** action appears in the connection bar during a live capability session; it durably saves a board project and hot-reloads the running board, while revision conflicts never overwrite local work. Links use the configured HTTPS relay (the plugin defaults to `https://sync.holoui.volmitsoftware.com/v1`) or a localhost HTTP development relay; an unreachable provider is reported without implying that a deployment is available.
 
 The editor itself remains a static client with no accounts. Normal authoring and autosave are local-only; opening a server-issued capability link enables bounded HTTPS requests to that link's relay until the tab disconnects. Capability tokens stay in the URL fragment and tab `sessionStorage`, never in workspace documents or exported bundles. If tab storage is blocked, the capability stays in the fragment and the sync bar tells you to copy the link before reloading.
 
@@ -45,7 +45,7 @@ The hosted editor is deployed to [holoui.volmitsoftware.com](https://holoui.volm
 lib/model/        HoloUI JSON data model + codec (runtime semantics, unknown-key preserving)
 lib/logic/        validation rules, Minecraft text parser, viewport math, hitbox geometry
 lib/services/     browser storage, image library, catalogs, file transfer, clipboard
-lib/state/        EditorStore, IndexedDB persistence, multi-doc workspace and flow boards
+lib/state/        EditorStore, IndexedDB persistence, multi-doc workspace and menu flow maps
 lib/components/   shell (top bar, shortcuts, palette), canvas, inspector, panels, dialogs
 web/assets/       fonts (Geist, lucide, Minecraft), item/sound catalogs, backdrop, brand
 tool/             asset extraction scripts

lib/components/board/board_view.dart

@@ -44,7 +44,7 @@ class _BoardViewState extends State<BoardView> {
     final WorkspaceBoardDecodeResult? decoded = component.store.activeBoard;
     if (decoded == null) {
       return const dom.div(classes: 'hui-board-empty', <Widget>[
-        Text('Open a flow board to inspect menu navigation.'),
+        Text('Open a menu flow map to inspect menu navigation.'),
       ]);
     }
     final WorkspaceBoardData board = decoded.data;
@@ -77,7 +77,7 @@ class _BoardViewState extends State<BoardView> {
           ArcaneIcon.workflow(size: IconSize.md),
           dom.div(<Widget>[
             dom.h1(<Widget>[
-              Text(component.store.workspace.active?.title ?? 'Board'),
+              Text(component.store.workspace.active?.title ?? 'Menu flow map'),
             ]),
             dom.p(<Widget>[
               Text(

lib/components/dialogs/help_dialog.dart

@@ -292,9 +292,9 @@ class HelpDialog extends StatelessWidget {
       ),
       const HuiSteps(
         steps: <String>[
-          'Run /holoui items on the server to see which providers are '
+          'Run /holoui item status on the server to see which providers are '
               'present, ready, and how many ids they expose.',
-          'Run /holoui items export to write '
+          'Run /holoui item export to write '
               '${huiPluginFolder}custom-items.json.',
           'Open Settings in the hosted editor and import that file. The '
               'plugin does not host or upload it.',
@@ -303,7 +303,7 @@ class HelpDialog extends StatelessWidget {
               'export.',
         ],
       ),
-      const HuiCodeBlock(text: '/holoui items\n/holoui items export'),
+      const HuiCodeBlock(text: '/holoui item status\n/holoui item export'),
     ],
   );
 
@@ -368,8 +368,9 @@ class HelpDialog extends StatelessWidget {
 
 const List<String> _nonFeatureList = <String>[
   'No background: a menu has no panel, colour or image behind its components.',
-  'No per-component scale, rotation or alignment. Size comes from the server '
-      'uiScale and the icon itself.',
+  'No independent component transform beyond offset. Display-backed icons '
+      'can own scale and alignment, while a persistent board rotates and '
+      'scales the whole menu.',
   "No localization of menu text. language.yml only translates the plugin's own "
       'messages, never the contents of a menu.',
   'No per-component permission or visibility rule. The only condition is a '
@@ -388,6 +389,7 @@ const List<String> _nonFeatureList = <String>[
       'whatever its provider plugin builds, but the JSON cannot add to it.',
   'No format version or migration: what you export is exactly what the plugin '
       'reads.',
-  'No external menu-opening trigger other than a command or the Java API. '
-      'Nothing in the JSON opens a menu on join, from a block, or from an NPC.',
+  'Persistent world boards open automatically for eligible nearby players. '
+      'Menu JSON has no join, block or NPC trigger; personal menus still open '
+      'through a command or the Java API.',
 ];

lib/components/dialogs/import_dialog.dart

@@ -191,9 +191,9 @@ class _ImportDialogState extends State<ImportDialog> {
     HuiDialogSection(
       title: 'From a file',
       description:
-          'Dropping a .json file anywhere in the editor does the same '
-          'thing. A menu or a container-preview document both work — '
-          'the shape of the file decides which.',
+          'A menu or a container-preview document both work; the file shape '
+          'decides which. Dropping JSON anywhere creates a new document. This '
+          'dialog replaces the active document only after you confirm below.',
       children: <Widget>[
         dom.div(classes: 'hui-dialog-actions', <Widget>[
           Button(

lib/components/dialogs/settings_dialog.dart

@@ -110,7 +110,7 @@ class SettingsDialog extends StatelessWidget {
     final HuiCustomItemCatalog? parsed = HuiCustomItemCatalog.parse(picked.$2);
     if (parsed == null) {
       toast.error(
-        '${picked.$1} is not a HoloUI custom item catalog. Run /holoui items '
+        '${picked.$1} is not a HoloUI custom item catalog. Run /holoui item '
         'export and pick the file it names.',
       );
       return;
@@ -167,7 +167,7 @@ class SettingsDialog extends StatelessWidget {
         ),
         const dom.p(classes: 'hui-dialog-note', <Widget>[
           Text(
-            'Run /holoui items export on your server, then import '
+            'Run /holoui item export on your server, then import '
             'plugins/holoui/custom-items.json here. The server is still '
             'the only thing that can confirm an id.',
           ),