refactor(dashboard): cut DockLayouts anatomy and wire vocabulary to final form (#17837)

apps/workstation/tour/denseWorkstation.mjs

@@ -14,7 +14,7 @@
  * @type {Object}
  */
 export const initialDocument = Object.freeze({
-    schema: 'neo.harness.dockZone.v1',
+    schema: 'neo.dock.zone.v1',
     root  : 'root',
     items : {
         scale    : {componentRef: 'Scale',     title: '100k Operations Matrix',       kind: 'grid'},

examples/dashboard/choreography/DemoAWorkspace.mjs

@@ -1,11 +1,11 @@
 import ClockPane                          from './ClockPane.mjs';
 import Container                          from '../../../src/container/Base.mjs';
-import DockDragAffordances                from '../../../src/dashboard/DockDragAffordances.mjs';
-import DockDropIndicators                 from '../../../src/dashboard/DockDropIndicators.mjs';
-import DockPreview                        from '../../../src/dashboard/DockPreview.mjs';
+import DockDragAffordances                from '../../../src/dashboard/dock/interaction/DragAffordances.mjs';
+import DockDropIndicators                 from '../../../src/dashboard/dock/interaction/DropIndicators.mjs';
+import DockPreview                        from '../../../src/dashboard/dock/interaction/Preview.mjs';
 import DockService                        from '../../../src/ai/client/DockService.mjs';
-import DockWorkspace                      from '../../../src/dashboard/DockWorkspace.mjs';
-import DockZoneModel                      from '../../../src/dashboard/DockZoneModel.mjs';
+import DockWorkspace                      from '../../../src/dashboard/dock/Workspace.mjs';
+import Document                           from '../../../src/dashboard/dock/model/Document.mjs';
 import TourRunner                         from '../../../src/ai/client/TourRunner.mjs';
 import {demoATourScript, initialDocument} from './demoADockChoreography.mjs';
 import '../../../src/button/Base.mjs';   // registers the `button` ntype the tour bar composes
@@ -16,7 +16,7 @@ import '../../../src/toolbar/Base.mjs';  // registers the `toolbar` ntype the to
  * @summary The Demo-A showcase workspace: the reducer-container that hosts the dock
  * choreography and plays its screenplay through the tour runner.
  *
- * The normative workspace host is the engine class {@link Neo.dashboard.DockWorkspace}, which the
+ * The normative workspace host is the engine class {@link Neo.dashboard.dock.Workspace}, which the
  * docking design record fixes as canonical; this class is one of its CONSUMERS, not the pattern
  * itself. Everything the holder contract requires — the committed dock-zone document as single
  * source of truth, the pure reducer, the read half Neural Link topology calls before any operation
@@ -39,7 +39,7 @@ import '../../../src/toolbar/Base.mjs';  // registers the `toolbar` ntype the to
  * siblings. The `workspace` advisory block of the screenplay (hover-reveal opt-in) is threaded
  * into the projection options — inert until the rail interaction layer lands, correct afterwards.
  * @class Neo.examples.dashboard.choreography.DemoAWorkspace
- * @extends Neo.dashboard.DockWorkspace
+ * @extends Neo.dashboard.dock.Workspace
  */
 class DemoAWorkspace extends DockWorkspace {
     static config = {
@@ -102,7 +102,7 @@ class DemoAWorkspace extends DockWorkspace {
      * The shared drag-affordance gesture controller (owner duck-type: this workspace).
      * Composed in {@link #construct} over the persistent overlay siblings; cleared on every
      * re-projection and destroyed with the workspace.
-     * @member {Neo.dashboard.DockDragAffordances|null} dragAffordances=null
+     * @member {Neo.dashboard.dock.interaction.DragAffordances|null} dragAffordances=null
      */
     dragAffordances = null
 
@@ -120,7 +120,7 @@ class DemoAWorkspace extends DockWorkspace {
 
         let me = this;
 
-        me.dockModel   = DockZoneModel.clone(initialDocument);
+        me.dockModel   = Document.clone(initialDocument);
         me.dockService = Neo.create(DockService, {});
 
         me.tourRunner = Neo.create(TourRunner, {
@@ -377,7 +377,7 @@ class DemoAWorkspace extends DockWorkspace {
 
         if (me.tourRunner.log.length) {
             // restart semantics: reset the stage to the opening document before replaying
-            me.onDockZoneDocumentChange(DockZoneModel.clone(initialDocument));
+            me.onDockZoneDocumentChange(Document.clone(initialDocument));
             await me.refreshPromise
         }
 

examples/dashboard/choreography/demoADockChoreography.mjs

@@ -54,7 +54,7 @@
  * @type {Object}
  */
 export const initialDocument = Object.freeze({
-    schema: 'neo.harness.dockZone.v1',
+    schema: 'neo.dock.zone.v1',
     root  : 'root',
     items : {
         editor  : {componentRef: 'Editor',   title: 'Editor',   kind: 'panel'},

examples/dashboard/crossWindow/DemoBCrossWindowStage.mjs

@@ -1,8 +1,8 @@
 import Container            from '../../../src/container/Base.mjs';
-import DockDropIndicators   from '../../../src/dashboard/DockDropIndicators.mjs';
-import DockPreview          from '../../../src/dashboard/DockPreview.mjs';
-import DockZoneModel        from '../../../src/dashboard/DockZoneModel.mjs';
-import {previewToOperation} from '../../../src/dashboard/dockPreviewContract.mjs';
+import DockDropIndicators   from '../../../src/dashboard/dock/interaction/DropIndicators.mjs';
+import DockPreview          from '../../../src/dashboard/dock/interaction/Preview.mjs';
+import Document             from '../../../src/dashboard/dock/model/Document.mjs';
+import {previewToOperation} from '../../../src/dashboard/dock/model/PreviewContract.mjs';
 
 /**
  * @module Neo.examples.dashboard.crossWindow.DemoBCrossWindowStage
@@ -34,7 +34,7 @@ import {previewToOperation} from '../../../src/dashboard/dockPreviewContract.mjs
  * @param {Object} seams
  * @param {Object} seams.registries Stable host-owned collections, captured once:
  *     `{hosts: Map, participations: Map, geometry: Map, projectionRequests: Map, detachedPanes: Object}`.
- * @param {Neo.dashboard.DockWorkspaceSet} seams.workspaceSet The host's workspace-set registry.
+ * @param {Neo.dashboard.dock.window.WorkspaceSet} seams.workspaceSet The host's workspace-set registry.
  * @param {Object} seams.workspaceIds `{main, popup, popup2}` semantic workspace ids (`popup2`
  *     optional — the stage parameterizes over every popup id the host registers).
  * @param {String} seams.sortGroup The shared cross-window coordinator sort group.
@@ -152,10 +152,10 @@ export function createCrossWindowStage(seams) {
      * @param {String} windowId
      * @param {Neo.container.Base} host
      * @param {Number} generation
-     * @returns {Promise<Neo.dashboard.DockCrossWindowParticipation|null>}
+     * @returns {Promise<Neo.dashboard.dock.window.Participation|null>}
      */
     async function createParticipation(workspaceId, windowId, host, generation) {
-        let Participation = (await import('../../../src/dashboard/DockCrossWindowParticipation.mjs')).default;
+        let Participation = (await import('../../../src/dashboard/dock/window/Participation.mjs')).default;
 
         if (!isTargetCurrent(workspaceId, windowId, host, generation)) {
             return null
@@ -451,11 +451,11 @@ export function createCrossWindowStage(seams) {
         if (descriptor?.operation !== 'transferNode'
             || sourceWorkspaceId !== workspaceIds.popup
             || targetWorkspaceId !== workspaceIds.main
-            || DockZoneModel.resolveStackRoot(sourceBefore) !== descriptor.nodeId) {
+            || Document.resolveStackRoot(sourceBefore) !== descriptor.nodeId) {
             return false
         }
 
-        let nodeIds = DockZoneModel.reachableNodeIds({nodes: sourceBefore.nodes, root: descriptor.nodeId}),
+        let nodeIds = Document.reachableNodeIds({nodes: sourceBefore.nodes, root: descriptor.nodeId}),
             itemIds = [...new Set([...nodeIds].flatMap(nodeId =>
                 sourceBefore.nodes[nodeId]?.type === 'tabs' ? sourceBefore.nodes[nodeId].items || [] : []
             ))];