Split Toolbox groups and add Learn wireframe pages - PR_26155_028-030-toolbox-groups-learn-wireframes

Author: qbytesdq-jpg

assets/theme-v2/js/gamefoundry-partials.js

@@ -34,13 +34,11 @@
         "ratings": "toolbox/ratings/index.html",
         "cloud": "toolbox/cloud/index.html",
         "code": "toolbox/code/index.html",
-        "tool-learn": "toolbox/learn/index.html",
         "midi": "toolbox/midi/index.html",
         "particles": "toolbox/particles/index.html",
         "audio-effects": "toolbox/audio-effects/index.html",
         "speech-to-text": "toolbox/speech-to-text/index.html",
         "text-to-speech": "toolbox/text-to-speech/index.html",
-        "users": "toolbox/users/index.html",
         "environments": "toolbox/environments/index.html",
         "game-migration": "toolbox/game-migration/index.html",
         "platform-settings": "toolbox/platform-settings/index.html",

assets/theme-v2/partials/header-nav.html

@@ -8,23 +8,33 @@
       <div class="nav-item">
         <a data-nav-link data-route="toolbox" href="toolbox/index.html">Toolbox &#9662;</a>
         <div class="sub-menu sub-menu--toolbox" data-toolbox-menu aria-label="Toolbox menu">
+          <div class="nav-item nav-popout-item" data-toolbox-menu-group>
+            <a data-toolbox-menu-group-label data-route="toolbox" href="toolbox/index.html" aria-haspopup="true">Create &#9656;</a>
+            <div class="sub-menu sub-menu--nested" data-toolbox-submenu aria-label="Create tools">
+              <a data-nav-link data-toolbox-menu-item data-route="objects" href="toolbox/objects/index.html">Objects</a>
+              <a data-nav-link data-toolbox-menu-item data-route="characters" href="toolbox/characters/index.html">Characters</a>
+              <a data-nav-link data-toolbox-menu-item data-route="worlds" href="toolbox/worlds/index.html">Worlds</a>
+              <a data-nav-link data-toolbox-menu-item data-route="animations" href="toolbox/animations/index.html">Animations</a>
+              <a data-nav-link data-toolbox-menu-item data-route="ai-assistant" href="toolbox/ai-assistant/index.html">AI Assistant</a>
+            </div>
+          </div>
           <div class="nav-item nav-popout-item" data-toolbox-menu-group>
             <a data-toolbox-menu-group-label data-route="toolbox" href="toolbox/index.html" aria-haspopup="true">Build &#9656;</a>
             <div class="sub-menu sub-menu--nested" data-toolbox-submenu aria-label="Build tools">
-              <a data-nav-link data-toolbox-menu-item data-route="ai-assistant" href="toolbox/ai-assistant/index.html">AI Assistant</a>
               <a data-nav-link data-toolbox-menu-item data-route="project-workspace" href="toolbox/project-workspace/index.html">Project Workspace</a>
               <a data-nav-link data-toolbox-menu-item data-route="game-design" href="toolbox/game-design/index.html">Game Design</a>
               <a data-nav-link data-toolbox-menu-item data-route="game-configuration" href="toolbox/game-configuration/index.html">Game Configuration</a>
+              <a data-nav-link data-toolbox-menu-item data-route="build-game" href="toolbox/build-game/index.html">Build Game</a>
+              <a data-nav-link data-toolbox-menu-item data-route="code" href="toolbox/code/index.html">Custom Extensions</a>
+            </div>
+          </div>
+          <div class="nav-item nav-popout-item" data-toolbox-menu-group>
+            <a data-toolbox-menu-group-label data-route="toolbox" href="toolbox/index.html" aria-haspopup="true">Content &#9656;</a>
+            <div class="sub-menu sub-menu--nested" data-toolbox-submenu aria-label="Content tools">
               <a data-nav-link data-toolbox-menu-item data-route="tool-assets" href="toolbox/assets/index.html">Assets</a>
               <a data-nav-link data-toolbox-menu-item data-route="colors" href="toolbox/colors/index.html">Colors</a>
               <a data-nav-link data-toolbox-menu-item data-route="fonts" href="toolbox/fonts/index.html">Fonts</a>
               <a data-nav-link data-toolbox-menu-item data-route="sprites" href="toolbox/sprites/index.html">Sprites</a>
-              <a data-nav-link data-toolbox-menu-item data-route="characters" href="toolbox/characters/index.html">Characters</a>
-              <a data-nav-link data-toolbox-menu-item data-route="objects" href="toolbox/objects/index.html">Objects</a>
-              <a data-nav-link data-toolbox-menu-item data-route="worlds" href="toolbox/worlds/index.html">Worlds</a>
-              <a data-nav-link data-toolbox-menu-item data-route="animations" href="toolbox/animations/index.html">Animations</a>
-              <a data-nav-link data-toolbox-menu-item data-route="build-game" href="toolbox/build-game/index.html">Build Game</a>
-              <a data-nav-link data-toolbox-menu-item data-route="code" href="toolbox/code/index.html">Custom Extensions</a>
             </div>
           </div>
           <div class="nav-item nav-popout-item" data-toolbox-menu-group>
@@ -60,7 +70,6 @@
               <a data-nav-link data-toolbox-menu-item data-route="tool-community" href="toolbox/community/index.html">Community</a>
               <a data-nav-link data-toolbox-menu-item data-route="languages" href="toolbox/languages/index.html">Languages</a>
               <a data-nav-link data-toolbox-menu-item data-route="cloud" href="toolbox/cloud/index.html">Cloud</a>
-              <a data-nav-link data-toolbox-menu-item data-route="tool-learn" href="toolbox/learn/index.html">Creator Learning</a>
             </div>
           </div>
           <div class="nav-item nav-popout-item" data-toolbox-menu-group>
@@ -71,15 +80,6 @@
               <a data-nav-link data-toolbox-menu-item data-route="ratings" href="toolbox/ratings/index.html">Ratings</a>
             </div>
           </div>
-          <div class="nav-item nav-popout-item" data-toolbox-menu-group data-toolbox-admin-nav-group hidden>
-            <a data-toolbox-menu-group-label data-route="toolbox" href="toolbox/index.html" aria-haspopup="true">Admin &#9656;</a>
-            <div class="sub-menu sub-menu--nested" data-toolbox-submenu aria-label="Admin tools">
-              <a data-nav-link data-toolbox-menu-item data-route="users" href="toolbox/users/index.html">Users</a>
-              <a data-nav-link data-toolbox-menu-item data-route="environments" href="toolbox/environments/index.html">Environments</a>
-              <a data-nav-link data-toolbox-menu-item data-route="game-migration" href="toolbox/game-migration/index.html">Game Migration</a>
-              <a data-nav-link data-toolbox-menu-item data-route="platform-settings" href="toolbox/platform-settings/index.html">Platform Settings</a>
-            </div>
-          </div>
         </div>
       </div>
       <div class="nav-item">
@@ -103,8 +103,11 @@
           <a data-nav-link data-route="admin-branding" href="admin/branding.html">Branding</a>
           <a data-nav-link data-route="admin-controls" href="admin/controls.html">Controls</a>
           <a data-nav-link data-route="admin-design-system" href="admin/design-system.html">Design System</a>
+          <a data-nav-link data-route="environments" href="toolbox/environments/index.html">Environments</a>
+          <a data-nav-link data-route="game-migration" href="toolbox/game-migration/index.html">Game Migration</a>
           <a data-nav-link data-route="admin-grouping-colors" href="admin/grouping-colors.html">Grouping Colors</a>
           <a data-nav-link data-route="admin-moderation" href="admin/moderation.html">Moderation</a>
+          <a data-nav-link data-route="platform-settings" href="toolbox/platform-settings/index.html">Platform Settings</a>
           <a data-nav-link data-route="admin-ratings" href="admin/ratings.html">Ratings</a>
           <a data-nav-link data-route="admin-roles" href="admin/roles.html">Roles</a>
           <a data-nav-link data-route="admin-site-settings" href="admin/site-settings.html">Site Settings</a>

docs_build/dev/reports/learn-wireframe-pages.md

@@ -0,0 +1,55 @@
+# PR_26155_030 Learn Wireframe Pages
+
+## Summary
+
+- Replaced `learn/index.html` with a Theme V2 Learn wireframe hub.
+- Added static Learn tool wireframe pages:
+  - `learn/project-workspace/index.html`
+  - `learn/game-design/index.html`
+  - `learn/game-configuration/index.html`
+  - `learn/assets/index.html`
+  - `learn/colors/index.html`
+  - `learn/objects/index.html`
+  - `learn/worlds/index.html`
+  - `learn/audio/index.html`
+  - `learn/publish/index.html`
+- Removed stale `toolbox/learn/index.html` so Learn is no longer a Toolbox tool.
+
+## Learn Index Sections
+
+- Search documentation
+- Browse by tool
+- Tutorials
+- Videos
+- Examples
+- FAQ
+
+## Tool Learn Page Sections
+
+- Overview
+- Quick Start
+- Common Tasks
+- Related Documentation
+- Related Videos
+- Examples
+
+## Scope Notes
+
+- Pages are fake/static wireframes only.
+- No real search implementation was added.
+- No video embeds were added.
+- No DB, auth, persistence, or runtime behavior was added.
+- No CSS was added or modified.
+
+## Validation Notes
+
+- Playwright targeted checks load `learn/index.html` and every new `learn/*/index.html` page.
+- Playwright verifies shared header/footer, required wireframe headings, no inline script/style/event styling, no video embeds, no failed requests, and no console page errors.
+- `npm run test:workspace-v2`: PASS, 3 tests.
+- `git diff --check`: PASS.
+
+## Manual Test Notes
+
+- Confirmed all Learn pages use `assets/theme-v2/css/theme.css`.
+- Confirmed top-level Learn navigation remains in the shared header.
+- Confirmed Learn is not rendered as a Toolbox tile, group, or submenu item.

docs_build/dev/reports/toolbox-create-build-content-split.md

@@ -0,0 +1,47 @@
+# PR_26155_028 Toolbox Create Build Content Split
+
+## Summary
+
+- Reworked active Toolbox groups to: Create, Build, Content, Media, Test, Share, Account.
+- Removed Admin as a Toolbox group.
+- Kept one top-level Admin navigation area in the shared header.
+- Removed the stale Toolbox Learn route so Learn remains a top-level site navigation item.
+- Kept Arcade out of Toolbox.
+
+## Grouping
+
+- Create: Objects, Characters, Worlds, Animations, AI Assistant.
+- Build: Project Workspace, Game Design, Game Configuration, Build Game, Custom Extensions.
+- Content: Assets, Colors, Fonts, Sprites.
+- Media: Audio, Music, Voices, Videos, MIDI, Particles, Audio Effects, Voice Capture, Voice Output.
+- Test: Game Testing, Controls, Hitboxes, Debug, Performance, Events.
+- Share: Publish, Marketplace, Community, Languages, Cloud.
+- Account: Saved Data, Achievements, Ratings.
+
+## Admin And Learn
+
+- Admin-only Toolbox group entries were removed from the Toolbox renderer and registry.
+- Environments, Game Migration, and Platform Settings are exposed only through the top-level Admin navigation.
+- Users already had a top-level Admin destination at `admin/users.html`; the old `toolbox/users/` shell is not exposed as an active Toolbox item.
+- Learn is exposed through top-level `learn/index.html`, not as a Toolbox tile or Toolbox submenu item.
+
+## Child Capabilities
+
+- Worlds preserves child capability text: Vector, Tilemap, Isometric, Hex.
+- These remain beneath Worlds and are not top-level Toolbox groups.
+
+## Validation Notes
+
+- `node scripts/validate-active-tools-surface.mjs`: PASS, 37 active Toolbox tools.
+- `node scripts/validate-tool-registry.mjs`: PASS.
+- `npm run test:workspace-v2`: PASS, 3 Playwright tests.
+- `git diff --check`: PASS.
+
+## Manual Test Notes
+
+- Confirmed Toolbox view controls remain visible.
+- Confirmed Assets renders under Content.
+- Confirmed Learn is top-level navigation only.
+- Confirmed Admin is not duplicated under Toolbox.
+- Confirmed Arcade is absent from Toolbox.
+- Confirmed no forbidden product suffix label appears in changed active Toolbox or Learn surfaces.

docs_build/dev/reports/toolbox-group-color-consistency.md

@@ -0,0 +1,37 @@
+# PR_26155_029 Toolbox Group Color Consistency
+
+## Summary
+
+- Preserved group-color outlines on Toolbox tiles.
+- Reused existing Theme V2 group color classes.
+- No CSS was added or modified.
+
+## Group Color Mapping
+
+- Create: `tool-group-build-create`
+- Build: `tool-group-development-system`
+- Content: `tool-group-content-assets`
+- Media: `tool-group-media-audio`
+- Test: `tool-group-platform-cloud`
+- Share: `tool-group-community-marketplace`
+- Account: `tool-group-platform-cloud`
+
+## Theme V2 Gap Findings
+
+- No Theme V2 gap was found.
+- Existing Theme V2 group classes and swatches were sufficient for the requested wireframe.
+- No page-local CSS, tool-local CSS, inline styles, or new reusable CSS were introduced.
+
+## Validation Notes
+
+- Playwright verifies every rendered Toolbox tile has a `tool-group-*` class.
+- Playwright verifies Assets uses the Content group class.
+- Playwright verifies Worlds uses the Create group class.
+- Playwright verifies tile border color is not transparent.
+- `npm run test:workspace-v2`: PASS.
+- `git diff --check`: PASS.
+
+## Manual Test Notes
+
+- Toolbox tiles retained visible group-color outlines in Order, Group, Progress, and Build Path modes.
+- The Content group avoids the old Assets > Assets grouping label while keeping the Assets tool label.

learn/assets/index.html

@@ -0,0 +1,80 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Assets Learn - GameFoundryStudio</title>
+    <meta name="description" content="GameFoundryStudio Learn wireframe for Assets.">
+    <link rel="icon" href="/favicon.svg">
+    <link rel="stylesheet" href="../../assets/theme-v2/css/theme.css">
+</head>
+
+<body>
+    <div data-partial="header-nav"></div>
+    <main>
+        <section class="page-title">
+            <div class="container">
+                <div class="kicker">Learn / Assets</div>
+                <h1>Assets</h1>
+                <p class="lede">Prepare reusable art and asset planning workflows.</p>
+            </div>
+        </section>
+        <section class="section">
+            <div class="container">
+                <div class="card-grid">
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Overview</h2>
+                            <p>Assets guidance overview placeholder for the future Learn system.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Quick Start</h2>
+                            <p>Static quick-start checklist for reviewing Assets before real tutorials exist.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Common Tasks</h2>
+                            <p>Task cards will eventually describe frequent Assets creator workflows.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Related Documentation</h2>
+                            <p>Documentation links for Assets will be connected after the docs registry exists.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Related Videos</h2>
+                            <p>Video references for Assets are planned; no embeds are active in this wireframe.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Examples</h2>
+                            <p>Example projects and snippets for Assets will be linked in a future implementation.</p>
+                        </div>
+                    </article>
+                </div>
+            </div>
+        </section>
+        <section class="section">
+            <div class="container callout">
+                <div class="kicker">Related</div>
+                <h2>Continue learning</h2>
+                <div class="content-cluster">
+                    <a class="btn" href="../index.html">All Learn</a>
+                    <a class="btn" href="../../toolbox/assets/index.html">Open Tool</a>
+                </div>
+            </div>
+        </section>
+    </main>
+    <div data-partial="footer"></div>
+    <script src="../../assets/theme-v2/js/gamefoundry-partials.js" defer></script>
+</body>
+
+</html>

learn/audio/index.html

@@ -0,0 +1,80 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Audio Learn - GameFoundryStudio</title>
+    <meta name="description" content="GameFoundryStudio Learn wireframe for Audio.">
+    <link rel="icon" href="/favicon.svg">
+    <link rel="stylesheet" href="../../assets/theme-v2/css/theme.css">
+</head>
+
+<body>
+    <div data-partial="header-nav"></div>
+    <main>
+        <section class="page-title">
+            <div class="container">
+                <div class="kicker">Learn / Audio</div>
+                <h1>Audio</h1>
+                <p class="lede">Plan game sound, music, voice, and audio review workflows.</p>
+            </div>
+        </section>
+        <section class="section">
+            <div class="container">
+                <div class="card-grid">
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Overview</h2>
+                            <p>Audio guidance overview placeholder for the future Learn system.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Quick Start</h2>
+                            <p>Static quick-start checklist for reviewing Audio before real tutorials exist.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Common Tasks</h2>
+                            <p>Task cards will eventually describe frequent Audio creator workflows.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Related Documentation</h2>
+                            <p>Documentation links for Audio will be connected after the docs registry exists.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Related Videos</h2>
+                            <p>Video references for Audio are planned; no embeds are active in this wireframe.</p>
+                        </div>
+                    </article>
+                    <article class="control-card">
+                        <div class="card-body">
+                            <h2>Examples</h2>
+                            <p>Example projects and snippets for Audio will be linked in a future implementation.</p>
+                        </div>
+                    </article>
+                </div>
+            </div>
+        </section>
+        <section class="section">
+            <div class="container callout">
+                <div class="kicker">Related</div>
+                <h2>Continue learning</h2>
+                <div class="content-cluster">
+                    <a class="btn" href="../index.html">All Learn</a>
+                    <a class="btn" href="../../toolbox/audio/index.html">Open Tool</a>
+                </div>
+            </div>
+        </section>
+    </main>
+    <div data-partial="footer"></div>
+    <script src="../../assets/theme-v2/js/gamefoundry-partials.js" defer></script>
+</body>
+
+</html>