refactor(scenerystack): standardize namespace, StringManager, main, and Colors

Align all simulations to canonical SceneryStack registration patterns:
PascalCase namespace modules with matching package identifiers (no
self-registration), module-scoped StringManager properties, screen
backgroundColorProperty from Colors, scenerystack/scenery imports, and
profileColor() color factories.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: veillette

src/TrackLabColors.ts

@@ -5,8 +5,8 @@
  * support for different color profiles (default and projector mode).
  */
 
-import { Color, ProfileColorProperty } from "scenerystack";
-import trackLab from "./TrackLabNamespace.js";
+import { Color, ProfileColorProperty } from "scenerystack/scenery";
+import TrackLabNamespace from "./TrackLabNamespace.js";
 
 // ── Base colors ───────────────────────────────────────────────────────────
 const BLACK = new Color(0, 0, 0);
@@ -18,7 +18,7 @@ function profileColor(
   defaultColor: Color | string,
   projectorColor: Color | string,
 ): ProfileColorProperty {
-  return new ProfileColorProperty(trackLab, name, {
+  return new ProfileColorProperty(TrackLabNamespace, name, {
     default: defaultColor,
     projector: projectorColor,
   });
@@ -316,7 +316,4 @@ const TrackLabColors = {
   ),
 };
 
-// Register the namespace
-trackLab.register("TrackLabColors", TrackLabColors);
-
 export default TrackLabColors;

src/TrackLabNamespace.ts

@@ -1,9 +1,16 @@
 /**
  * TrackLabNamespace.ts
  *
- * Creates and exports the global trackLab namespace for registering tandem-tracked singletons.
+ * The SceneryStack Namespace for this simulation. It is used as the first
+ * argument to ProfileColorProperty (so color names are scoped to this sim)
+ * and optionally for registering objects with the PhET-iO API.
+ *
+ * ── How to customize ─────────────────────────────────────────────────────────
+ * Change the string argument to match your simulation's identifier, using the
+ * same kebab-case name as in package.json and src/init.ts.
  */
-
 import { Namespace } from "scenerystack/phet-core";
 
-export default new Namespace("trackLab");
+const TrackLabNamespace = new Namespace("track-lab");
+
+export default TrackLabNamespace;

src/i18n/StringManager.ts

@@ -18,7 +18,7 @@ import { init, madeWithSceneryStackSplashDataURI } from "scenerystack/init";
 init({
   // Internal identifier used by SceneryStack for URL parameters and phetmarks.
   // Use kebab-case matching the package.json "name" field.
-  name: "trackLab",
+  name: "track-lab",
 
   // Displayed in the About dialog (Help menu → About).
   version: "0.1.0",

src/init.ts

@@ -7,7 +7,7 @@
  */
 
 import { BooleanProperty } from "scenerystack/axon";
-import trackLab from "../TrackLabNamespace.js";
+import TrackLabNamespace from "../TrackLabNamespace.js";
 import trackLabQueryParameters from "./trackLabQueryParameters.js";
 
 export class TrackLabPreferencesModel {
@@ -53,4 +53,4 @@ export class TrackLabPreferencesModel {
   }
 }
 
-trackLab.register("TrackLabPreferencesModel", TrackLabPreferencesModel);
+TrackLabNamespace.register("TrackLabPreferencesModel", TrackLabPreferencesModel);

src/preferences/TrackLabPreferencesModel.ts

@@ -13,7 +13,7 @@ import { PhetFont } from "scenerystack/scenery-phet";
 import { Checkbox } from "scenerystack/sun";
 import { StringManager } from "../i18n/StringManager.js";
 import TrackLabColors from "../TrackLabColors.js";
-import trackLab from "../TrackLabNamespace.js";
+import TrackLabNamespace from "../TrackLabNamespace.js";
 import type { TrackLabPreferencesModel } from "./TrackLabPreferencesModel.js";
 
 export class TrackLabPreferencesNode extends VBox {
@@ -141,4 +141,4 @@ export class TrackLabPreferencesNode extends VBox {
   }
 }
 
-trackLab.register("TrackLabPreferencesNode", TrackLabPreferencesNode);
+TrackLabNamespace.register("TrackLabPreferencesNode", TrackLabPreferencesNode);

src/preferences/TrackLabPreferencesNode.ts

@@ -3,7 +3,7 @@
  */
 
 import { QueryStringMachine } from "scenerystack/query-string-machine";
-import trackLab from "../TrackLabNamespace.js";
+import TrackLabNamespace from "../TrackLabNamespace.js";
 
 const trackLabQueryParameters = QueryStringMachine.getAll({
   enableAutoTracking: {
@@ -31,6 +31,6 @@ const trackLabQueryParameters = QueryStringMachine.getAll({
   },
 });
 
-trackLab.register("trackLabQueryParameters", trackLabQueryParameters);
+TrackLabNamespace.register("trackLabQueryParameters", trackLabQueryParameters);
 
 export default trackLabQueryParameters;

src/preferences/trackLabQueryParameters.ts

@@ -7,7 +7,7 @@
 
 import { Screen, type ScreenOptions } from "scenerystack/sim";
 import type { TrackLabPreferencesModel } from "../preferences/TrackLabPreferencesModel.js";
-import trackLab from "../TrackLabNamespace.js";
+import TrackLabNamespace from "../TrackLabNamespace.js";
 import { SimModel } from "./model/SimModel.js";
 import { SimScreenView } from "./view/SimScreenView.js";
 
@@ -30,4 +30,4 @@ export class SimScreen extends Screen<SimModel, SimScreenView> {
   }
 }
 
-trackLab.register("SimScreen", SimScreen);
+TrackLabNamespace.register("SimScreen", SimScreen);

src/screen-name/SimScreen.ts

@@ -18,7 +18,7 @@ import type { ChartRectangle, ChartTransform } from "scenerystack/bamboo";
 import { Range, Vector2 } from "scenerystack/dot";
 import { DragListener, type Pointer, type Rectangle } from "scenerystack/scenery";
 import { GRAPH_ZOOM_FACTOR } from "../../TrackLabConstants.js";
-import trackLab from "../../TrackLabNamespace.js";
+import TrackLabNamespace from "../../TrackLabNamespace.js";
 import type GraphDataManager from "./GraphDataManager.js";
 import type { ChartConfig, GraphDimensions } from "./GraphInteractionHandler.js";
 
@@ -284,4 +284,4 @@ export default class AxisGestureHandler {
   }
 }
 
-trackLab.register("AxisGestureHandler", AxisGestureHandler);
+TrackLabNamespace.register("AxisGestureHandler", AxisGestureHandler);

src/screen-name/graph/AxisGestureHandler.ts

@@ -58,7 +58,7 @@ import { ChartTransform, LinePlot } from "scenerystack/bamboo";
 import { Range } from "scenerystack/dot";
 import { Node } from "scenerystack/scenery";
 import { StringManager } from "../../i18n/StringManager.js";
-import trackLab from "../../TrackLabNamespace.js";
+import TrackLabNamespace from "../../TrackLabNamespace.js";
 import GraphControlsPanel from "./GraphControlsPanel.js";
 import GraphDataManager from "./GraphDataManager.js";
 import GraphInteractionHandler from "./GraphInteractionHandler.js";
@@ -421,4 +421,4 @@ export default class ConfigurableGraph extends Node {
 }
 
 // Register with namespace for debugging accessibility
-trackLab.register("ConfigurableGraph", ConfigurableGraph);
+TrackLabNamespace.register("ConfigurableGraph", ConfigurableGraph);