d

Author: NextdoorPsycho

.firebaserc

@@ -1,5 +1,5 @@
 {
   "projects": {
-    "default": "gloss-editor"
+    "default": "holoui-editor"
   }
 }

.github/workflows/firebase-hosting.yml

@@ -11,9 +11,10 @@ permissions:
 
 env:
   ARCANE_JASPR_REF: 665652de05c83d51ba26da51a06398bbd1c6f57e
-  FIREBASE_PROJECT_ID: gloss-editor
+  FIREBASE_PROJECT_ID: holoui-editor
   FIREBASE_TOOLS_VERSION: 15.25.1
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+  GLOSS_REPOSITORY: .deps/Gloss
   NODE_VERSION: 22.23.1
 
 concurrency:
@@ -32,6 +33,13 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v6
 
+      - name: Checkout Gloss runtime authority
+        uses: actions/checkout@v6
+        with:
+          repository: VolmitSoftware/Gloss
+          ref: master
+          path: .deps/Gloss
+
       - name: Cache pinned Arcane Jaspr
         id: cache-arcane-jaspr
         uses: actions/cache@v5
@@ -76,7 +84,7 @@ jobs:
       - name: Authenticate to Google Cloud
         uses: google-github-actions/auth@v3
         with:
-          credentials_json: ${{ secrets.FIREBASE_SERVICE_ACCOUNT_GLOSS_EDITOR }}
+          credentials_json: ${{ secrets.FIREBASE_SERVICE_ACCOUNT_HOLOUI_EDITOR }}
 
       - name: Deploy Firebase Hosting
         run: |

README.md

@@ -1,8 +1,8 @@
-# HoloUI Editor
+# Gloss Editor
 
-Visual web editor for [HoloUI](https://github.com/VolmitSoftware/HoloUi) menu configurations. Build holographic menus on a calibrated canvas, edit every field the plugin actually parses, and export `menus/<id>.json` files (plus an `images.zip`) that drop straight into `plugins/holoui/`.
+Visual web editor for [Gloss](https://github.com/VolmitSoftware/Gloss) menu and display configurations. Build holographic menus on a calibrated canvas, edit every field the plugin actually parses, and export documents and images that drop straight into `plugins/Gloss/`.
 
-Version 3.1.0 — a from-scratch rewrite in [arcane_jaspr](https://github.com/ArcaneArts/arcane_jaspr) (Dart, compiled to a fully static site). Replaces the retired Next.js editor.
+Version 4.0.0 — a from-scratch rewrite in [arcane_jaspr](https://github.com/ArcaneArts/arcane_jaspr) (Dart, compiled to a fully static site). Replaces the retired Next.js editor.
 
 ## Features
 
@@ -12,13 +12,13 @@ Version 3.1.0 — a from-scratch rewrite in [arcane_jaspr](https://github.com/Ar
 - **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 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.
+- **Image library**: upload validated PNG pixel art, preview with the plugin's rasterization rules, export `images.zip` laid out for `plugins/Gloss/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 world-panel 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 panels 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.gloss.volmitsoftware.com/v2`) or a localhost HTTP development relay; an unreachable provider is reported without implying that a deployment is available.
+- **Optional server sync**: capability links opened from `/gloss menu edit` import an exact menu or persistent panel graph through the configured relay. Linked panels expose typed root-menu, transform, follow, audience, permission and range controls, with strict JSON under Advanced. Panel publication retains the bound no-delete baseline and adds only menus reachable from the panel 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 panel project and hot-reloads the running panel, while revision conflicts never overwrite local work. Links use the configured HTTPS relay (the plugin defaults to `https://sync.gloss.volmitsoftware.com/v2`) 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.
 
-Sync v1 does not delete captured server resources. A board can add menus only under the displayed `newMenuPrefix`; menus and boards can add images only under `newImagePrefix`. The editor validates exact runtime ids, the whole bound graph, typed world-board JSON, image bytes, immutable constraints and content revisions before publishing. Synced raster assets are limited to 64×64 pixels each and 262,144 stored pixels per project; every repeated text-image component and animated frame is counted again against a 262,144-pixel / 4,096-row runtime-render budget. The protocol safety ceiling is 32 MiB per project; a relay deployment may enforce a lower configured limit and return `413`.
+Sync v2 does not delete captured server resources. A panel can add menus only under the displayed `newMenuPrefix`; menus and panels can add images only under `newImagePrefix`. The editor validates exact runtime ids, the whole bound graph, typed panel JSON, image bytes, immutable constraints and content revisions before publishing. Synced raster assets are limited to 64×64 pixels each and 262,144 stored pixels per project; every repeated text-image component and animated frame is counted again against a 262,144-pixel / 4,096-row runtime-render budget. The protocol safety ceiling is 32 MiB per project; a relay deployment may enforce a lower configured limit and return `413`.
 
 Workspace bundles and server projects span IndexedDB documents and localStorage images. Import and refresh use checked compensation when either write fails, but browsers provide no atomic transaction across those two storage systems; force-closing the browser between their writes can leave a partial import.
 
@@ -36,13 +36,13 @@ dart run jaspr_cli:jaspr build      # static output in build/jaspr/
 
 ## Releasing
 
-The hosted editor is deployed to [holoui.volmitsoftware.com](https://holoui.volmitsoftware.com/) on Firebase Hosting by `.github/workflows/firebase-hosting.yml` after every push to `master`. The workflow analyzes and tests the project before building, deploying, and verifying the custom-domain bundle. It requires the `FIREBASE_SERVICE_ACCOUNT_HOLOUI_EDITOR` repository secret. There are no editor releases: the plugin's `/holoui builder` command links players to the hosted editor.
+The hosted editor is deployed to [gloss.volmitsoftware.com](https://gloss.volmitsoftware.com/) through the existing Firebase `holoui-editor` project and Hosting site by `.github/workflows/firebase-hosting.yml` after every push to `master`. The workflow checks the paired Gloss runtime contract, analyzes and tests the project, then builds, deploys, and verifies the custom-domain bundle. It requires the `FIREBASE_SERVICE_ACCOUNT_HOLOUI_EDITOR` repository secret. There are no editor releases: `/gloss menu builder` links players to the hosted editor.
 
 
 ## Architecture
 
 ```
-lib/model/        HoloUI JSON data model + codec (runtime semantics, unknown-key preserving)
+lib/model/        Gloss menu JSON data model + codec (runtime semantics, unknown-key preserving)
 lib/doctype/      per-kind DocumentTypeAdapter registry (codec, views, capabilities, templates, inspector)
 lib/logic/        validation rules, Minecraft text parser, viewport math, hitbox geometry
 lib/services/     browser storage, image library, catalogs, file transfer, clipboard

firebase.json

@@ -1,6 +1,6 @@
 {
   "hosting": {
-    "site": "gloss-editor",
+    "site": "holoui-editor",
     "public": "build/jaspr",
     "ignore": [
       "firebase.json",

test/emoji_catalog_test.dart

@@ -16,20 +16,25 @@ import 'package:gloss_editor/services/catalogs.dart';
 import 'package:gloss_editor/logic/gloss_text.dart';
 import 'package:test/test.dart';
 
-const String _pluginDefaults = '../Gloss/src/main/resources/defaults/emoji';
+import 'support/gloss_repository.dart';
+
+final String _pluginDefaults = glossRepositoryFilePath(
+  'src/main/resources/defaults/emoji',
+);
 const String _asset = 'web/assets/catalog/emoji.json';
 
 void main() {
-  test('the shipped catalog matches the plugin defaults, entry for entry',
-      () {
+  test('the shipped catalog matches the plugin defaults, entry for entry', () {
     final Directory defaults = Directory(_pluginDefaults);
     expect(defaults.existsSync(), isTrue);
 
     final Map<String, GlossEmojiDoc> expected = <String, GlossEmojiDoc>{};
     for (final FileSystemEntity entity in defaults.listSync()) {
       if (entity is! File || !entity.path.endsWith('.json')) continue;
-      final String name = entity.uri.pathSegments.last
-          .replaceFirst(RegExp(r'\.json$'), '');
+      final String name = entity.uri.pathSegments.last.replaceFirst(
+        RegExp(r'\.json$'),
+        '',
+      );
       expected[name] = decodeGlossEmojiDoc(entity.readAsStringSync());
     }
     expect(expected, isNotEmpty);

test/gloss_templates_test.dart

@@ -17,6 +17,8 @@ import 'package:gloss_editor/logic/validation.dart';
 import 'package:gloss_editor/model/model.dart';
 import 'package:test/test.dart';
 
+import 'support/gloss_repository.dart';
+
 void main() {
   group('hologram blank stays the plugin baseline', () {
     test('embedded copy matches the fixture and the plugin resource', () {
@@ -25,7 +27,7 @@ void main() {
       ).readAsStringSync();
       expect(kGlossHologramBaselineJson, fixture);
       final File plugin = File(
-        '../Gloss/src/main/resources/baselines/hologram.json',
+        glossRepositoryFilePath('src/main/resources/baselines/hologram.json'),
       );
       expect(plugin.existsSync(), isTrue);
       expect(kGlossHologramBaselineJson, plugin.readAsStringSync());
@@ -49,7 +51,9 @@ void main() {
       ).readAsStringSync();
       expect(kGlossAnimationRainbowJson, fixture);
       final File plugin = File(
-        '../Gloss/src/main/resources/defaults/animations/rainbow.json',
+        glossRepositoryFilePath(
+          'src/main/resources/defaults/animations/rainbow.json',
+        ),
       );
       expect(plugin.existsSync(), isTrue);
       expect(kGlossAnimationRainbowJson, plugin.readAsStringSync());
@@ -83,8 +87,9 @@ void main() {
     // The |animation.rainbow| line warns until the workspace has that
     // animation document — deliberate: the template teaches the reference.
     expect(
-      issues.any((HuiIssue issue) =>
-          issue.message.contains('animation.rainbow')),
+      issues.any(
+        (HuiIssue issue) => issue.message.contains('animation.rainbow'),
+      ),
       isTrue,
     );
   });
@@ -96,7 +101,9 @@ void main() {
       ).readAsStringSync();
       expect(kGlossScoreboardDefaultJson, fixture);
       final File plugin = File(
-        '../Gloss/src/main/resources/defaults/boards/default.json',
+        glossRepositoryFilePath(
+          'src/main/resources/defaults/boards/default.json',
+        ),
       );
       expect(plugin.existsSync(), isTrue);
       expect(kGlossScoreboardDefaultJson, plugin.readAsStringSync());
@@ -108,8 +115,11 @@ void main() {
       expect(identical(first, second), isFalse);
       expect(first.title, '&d&lGloss');
       expect(first.lines, hasLength(3));
-      expect(first.primary, isFalse,
-          reason: 'the shipped default never forces a sidebar');
+      expect(
+        first.primary,
+        isFalse,
+        reason: 'the shipped default never forces a sidebar',
+      );
       expect(first.permission, 'default');
       expect(validateScoreboardDoc(first), isEmpty);
     });
@@ -122,7 +132,7 @@ void main() {
       ).readAsStringSync();
       expect(kGlossMotdDefaultJson, fixture);
       final File plugin = File(
-        '../Gloss/src/main/resources/defaults/motd/motd.json',
+        glossRepositoryFilePath('src/main/resources/defaults/motd/motd.json'),
       );
       expect(plugin.existsSync(), isTrue);
       expect(kGlossMotdDefaultJson, plugin.readAsStringSync());
@@ -163,7 +173,7 @@ void main() {
       ).readAsStringSync();
       expect(kGlossEmojiHeartJson, fixture);
       final File plugin = File(
-        '../Gloss/src/main/resources/defaults/emoji/heart.json',
+        glossRepositoryFilePath('src/main/resources/defaults/emoji/heart.json'),
       );
       expect(plugin.existsSync(), isTrue);
       expect(kGlossEmojiHeartJson, plugin.readAsStringSync());
@@ -195,7 +205,9 @@ void main() {
       ).readAsStringSync();
       expect(kGlossBubbleDefaultJson, fixture);
       final File plugin = File(
-        '../Gloss/src/main/resources/defaults/bubbles/default.json',
+        glossRepositoryFilePath(
+          'src/main/resources/defaults/bubbles/default.json',
+        ),
       );
       expect(plugin.existsSync(), isTrue);
       expect(kGlossBubbleDefaultJson, plugin.readAsStringSync());
@@ -222,8 +234,9 @@ void main() {
     expect(doc.select, isNotNull);
     expect(doc.select!.priority, 10);
     expect(
-      validateBubbleStyleDoc(doc)
-          .where((HuiIssue issue) => issue.severity == HuiSeverity.error),
+      validateBubbleStyleDoc(
+        doc,
+      ).where((HuiIssue issue) => issue.severity == HuiSeverity.error),
       isEmpty,
     );
   });
@@ -235,7 +248,9 @@ void main() {
       ).readAsStringSync();
       expect(kGlossTablistDefaultJson, fixture);
       final File plugin = File(
-        '../Gloss/src/main/resources/defaults/tablist/tablist.json',
+        glossRepositoryFilePath(
+          'src/main/resources/defaults/tablist/tablist.json',
+        ),
       );
       expect(plugin.existsSync(), isTrue);
       expect(kGlossTablistDefaultJson, plugin.readAsStringSync());

test/preview_templates_test.dart

@@ -14,6 +14,8 @@ import 'package:gloss_editor/logic/preview_variant_resolver.dart';
 import 'package:gloss_editor/model/preview_doc.dart';
 import 'package:test/test.dart';
 
+import 'support/gloss_repository.dart';
+
 const List<String> _shippedPreviewIds = <String>[
   'beehive',
   'brewing_stand',
@@ -138,7 +140,7 @@ void main() {
         expect(embedded.trim(), fixture.trim());
 
         final File plugin = File(
-          '../Gloss/src/main/resources/previews/$id.json',
+          glossRepositoryFilePath('src/main/resources/previews/$id.json'),
         );
         expect(plugin.existsSync(), isTrue, reason: plugin.path);
         expect(embedded.trim(), plugin.readAsStringSync().trim());

test/support/gloss_repository.dart

@@ -0,0 +1,9 @@
+library;
+
+import 'dart:io';
+
+final String glossRepositoryPath =
+    Platform.environment['GLOSS_REPOSITORY'] ?? '../Gloss';
+
+String glossRepositoryFilePath(String relativePath) =>
+    '$glossRepositoryPath/$relativePath';

test/templates_test.dart

@@ -5,6 +5,8 @@ import 'package:gloss_editor/logic/validation.dart';
 import 'package:gloss_editor/model/model.dart';
 import 'package:test/test.dart';
 
+import 'support/gloss_repository.dart';
+
 void main() {
   test(
     'every starter template builds a fresh menu without validation errors',
@@ -46,7 +48,7 @@ void main() {
     ).readAsStringSync();
     expect(kBlankHologramJson.trim(), fixture.trim());
     final File plugin = File(
-      '../Gloss/src/main/resources/baselines/menu-blank.json',
+      glossRepositoryFilePath('src/main/resources/baselines/menu-blank.json'),
     );
     expect(plugin.existsSync(), isTrue);
     expect(kBlankHologramJson.trim(), plugin.readAsStringSync().trim());

tool/extract_emoji_catalog.dart

@@ -26,7 +26,8 @@ import 'dart:io';
 import 'package:gloss_editor/model/model.dart';
 
 /// Default source, relative to this repo — the plugin checkout sits beside it.
-const String defaultSource = '../Gloss/src/main/resources/defaults/emoji';
+final String defaultSource =
+    '${Platform.environment['GLOSS_REPOSITORY'] ?? '../Gloss'}/src/main/resources/defaults/emoji';
 
 const String outputPath = 'web/assets/catalog/emoji.json';
 
@@ -42,8 +43,10 @@ void main(List<String> args) {
   final List<Map<String, Object?>> entries = <Map<String, Object?>>[];
   for (final FileSystemEntity entity in source.listSync()) {
     if (entity is! File || !entity.path.endsWith('.json')) continue;
-    final String name = entity.uri.pathSegments.last
-        .replaceFirst(RegExp(r'\.json$'), '');
+    final String name = entity.uri.pathSegments.last.replaceFirst(
+      RegExp(r'\.json$'),
+      '',
+    );
     final GlossEmojiDoc doc;
     try {
       doc = decodeGlossEmojiDoc(entity.readAsStringSync());