dwa

Author: NextdoorPsycho

lib/components/inspector/scoreboard_inspector.dart

@@ -86,8 +86,8 @@ class _ScoreboardInspectorState extends State<ScoreboardInspector> {
         required: true,
         trailing: const HuiFieldHelp('scoreboard.title'),
         help:
-            'Centered above the lines. The rendered form is cut at 32 '
-            'characters, colour codes included.',
+            'Centered above the lines. The rendered form is safely capped '
+            'at 32 UTF-16 units, colour codes included.',
         control: dom.div(<Widget>[
           TextInput(
             value: doc.title,
@@ -106,7 +106,7 @@ class _ScoreboardInspectorState extends State<ScoreboardInspector> {
           ),
           dom.div(classes: 'hui-hologram-line-preview', <Widget>[
             GlossTextLine(
-              render: renderGlossLine(
+              render: renderGlossScoreboardTitle(
                 doc.title,
                 animations: _store.workspaceAnimations,
                 emoji: _store.workspaceEmoji,
@@ -183,7 +183,7 @@ class _ScoreboardInspectorState extends State<ScoreboardInspector> {
         ),
         dom.div(classes: 'hui-hologram-line-preview', <Widget>[
           GlossTextLine(
-            render: renderGlossLine(
+            render: renderGlossScoreboardLine(
               line,
               animations: _store.workspaceAnimations,
               emoji: _store.workspaceEmoji,

lib/components/scoreboard/scoreboard_view.dart

@@ -1,13 +1,12 @@
 /// The scoreboard surface: a vanilla-style sidebar mock, right-anchored the
 /// way the client draws it.
 ///
-/// Fidelity notes, all from `BoardService.java`: the title renders through
-/// the text pipeline and is cut at 32 characters INCLUDING colour codes
-/// (`MAX_TITLE_LENGTH`, line 40-41,363-367); at most 15 lines reach the
-/// client (`MAX_LINES`, line 377-380); every line renders through the same
-/// pipeline per viewer, so `|animation.<id>|` references play here through
-/// the workspace-scoped resolver exactly as they would in game. The dimmed
-/// score column stands in for the vanilla sidebar's row scores.
+/// The title renders through Gloss's text pipeline, then VolmLib safely caps
+/// it at 32 UTF-16 units including colour codes. At most 15 lines reach the
+/// client; VolmLib maps every rendered line into
+/// its 16-character team prefix plus 16-character suffix, including carried
+/// colour codes. The dimmed score column stands in for the vanilla sidebar's
+/// row scores.
 ///
 /// Owns a playback clock while any rendered line (or the title) plays an
 /// animation and the store's animations toggle is on. Mounted only while the
@@ -134,7 +133,7 @@ class _ScoreboardViewState extends State<ScoreboardView> {
             child: dom.div(classes: 'hui-scoreboard-sidebar', <Widget>[
               dom.div(classes: 'hui-scoreboard-title', <Widget>[
                 GlossTextLine(
-                  render: renderGlossLine(
+                  render: renderGlossScoreboardTitle(
                     doc.title,
                     animations: animations,
                     emoji: emoji,
@@ -146,7 +145,7 @@ class _ScoreboardViewState extends State<ScoreboardView> {
                 dom.div(classes: 'hui-scoreboard-row', <Widget>[
                   dom.span(classes: 'hui-scoreboard-row-text', <Widget>[
                     GlossTextLine(
-                      render: renderGlossLine(
+                      render: renderGlossScoreboardLine(
                         doc.lines[index],
                         animations: animations,
                         emoji: emoji,
@@ -181,15 +180,17 @@ class _ScoreboardViewState extends State<ScoreboardView> {
   String _readout(GlossScoreboardDoc doc, int clipped, bool titleTruncated) {
     final List<String> parts = <String>[
       doc.primary ? 'primary' : 'not primary',
-      doc.hideNumbers ? 'score numbers hidden' : 'score numbers visible',
+      doc.hideNumbers
+          ? 'score numbers hidden on supported runtimes'
+          : 'score numbers visible',
       doc.permissionGated
           ? 'needs $glossBoardPermissionNodePrefix${doc.effectivePermission}'
           : 'everyone',
       if (doc.effectiveGroups.isNotEmpty)
         'groups: ${doc.effectiveGroups.join(', ')}',
       if (clipped > 0)
         '$clipped line${clipped == 1 ? '' : 's'} past the 15-line render cap',
-      if (titleTruncated) 'title cut at 32 rendered characters in game',
+      if (titleTruncated) 'title exceeds the 32-unit in-game cap',
     ];
     return parts.join(' · ');
   }

lib/config/field_docs.dart

@@ -502,21 +502,24 @@ const Map<String, HuiFieldDoc> huiFieldDocs = <String, HuiFieldDoc>{
   'scoreboard.title': HuiFieldDoc(
     title: 'Title',
     body:
-        'Rendered through the text pipeline per viewer, then cut at 32 '
-        'characters WITH the colour codes still counted — an & code costs 2 '
+        'Rendered through the text pipeline per viewer, then safely capped '
+        'at 32 UTF-16 units WITH the colour codes still counted — an & code costs 2 '
         'and a [RRGGBB] tag costs 14 of the budget, so a hex-coloured title '
         'has 18 characters left. {{ code }} evaluates before that cut, so a '
-        'time-driven colour or calculated title is measured after rendering.',
-    citation: 'BoardService.java:363-367',
+        'time-driven colour or calculated title is measured after rendering. '
+        'Line breaks become spaces.',
+    citation: 'Board.java:201-206',
   ),
   'scoreboard.lines': HuiFieldDoc(
     title: 'Lines',
     body:
         'Top to bottom, each through the text pipeline per viewer — '
         'placeholders, |animation.<id>|, metrics, colours and {{ code }} all '
-        'work. Code can call papi/papiNumber, metric, bar, select, mix and '
-        'the math library. Only the first 15 lines reach the client.',
-    citation: 'BoardService.java:377-380',
+        'work. VolmLib renders each row as a 16-character team prefix plus '
+        'a 16-character suffix; inherited colour and format codes consume '
+        'suffix space. Line breaks become spaces, rows never wrap, and only '
+        'the first 15 lines reach the client.',
+    citation: 'BoardEntry.java:24-40',
   ),
   'scoreboard.primary': HuiFieldDoc(
     title: 'Primary board',

lib/config/gloss_templates.dart

@@ -130,7 +130,7 @@ const String kGlossScoreboardShowcaseJson = r'''
     "",
     "|animation.rainbow|&lLIVE EVENT",
     "&d:heart: &fWelcome!",
-    "[55FFFF]play.example.net"
+    "&bplay.example.net"
   ],
   "primary": true,
   "hideNumbers": true,