Initial

resources/app/client/tours/canvas-tour.js

@@ -0,0 +1,40 @@
+/**
+ * A tour for demonstrating an aspect of Canvas functionality.
+ * Automatically activates a certain canvas layer or tool depending on the needs of the step.
+ */
+class CanvasTour extends Tour {
+
+  /** @override */
+  async start() {
+    game.togglePause(false);
+    await super.start();
+  }
+
+  /* -------------------------------------------- */
+
+  /** @override */
+  get canStart() {
+    return !!canvas.scene;
+  }
+
+  /* -------------------------------------------- */
+
+  /** @override */
+  async _preStep() {
+    await super._preStep();
+    this.#activateTool();
+  }
+
+  /* -------------------------------------------- */
+
+  /**
+   * Activate a canvas layer and control for each step
+   */
+  #activateTool() {
+    if ( "layer" in this.currentStep && canvas.scene ) {
+      const layer = canvas[this.currentStep.layer];
+      if ( layer.active ) ui.controls.initialize({tool: this.currentStep.tool});
+      else layer.activate({tool: this.currentStep.tool});
+    }
+  }
+}

resources/app/client/tours/setup-tour.js

@@ -0,0 +1,106 @@
+/**
+ * @typedef {TourConfig} SetupTourConfig
+ * @property {boolean} [closeWindows=true]  Whether to close all open windows before beginning the tour.
+ */
+
+/**
+ * A Tour subclass that handles controlling the UI state of the Setup screen
+ */
+class SetupTour extends Tour {
+
+  /**
+   * Stores a currently open Application for future steps
+   * @type {Application}
+   */
+  focusedApp;
+
+  /* -------------------------------------------- */
+
+  /** @override */
+  get canStart() {
+    return game.view === "setup";
+  }
+
+  /* -------------------------------------------- */
+
+  /** @override */
+  get steps() {
+    return this.config.steps; // A user is always "GM" for Setup Tours
+  }
+
+  /* -------------------------------------------- */
+
+  /** @override */
+  async _preStep() {
+    await super._preStep();
+
+    // Close currently open applications
+    if ( (this.stepIndex === 0) && (this.config.closeWindows !== false) ) {
+      for ( const app of Object.values(ui.windows) ) {
+        app.close();
+      }
+    }
+
+    // Configure specific steps
+    switch ( this.id ) {
+      case "installingASystem": return this._installingASystem();
+      case "creatingAWorld": return this._creatingAWorld();
+    }
+  }
+
+  /* -------------------------------------------- */
+
+  /**
+   * Handle Step setup for the Installing a System Tour
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _installingASystem() {
+    // Activate Systems tab and warm cache
+    if ( this.currentStep.id === "systemsTab" ) {
+      ui.setupPackages.activateTab("systems");
+
+      // noinspection ES6MissingAwait
+      Setup.warmPackages({type: "system"});
+    }
+
+    // Render the InstallPackage app with a filter
+    else if ( this.currentStep.id === "searching" ) {
+      await Setup.browsePackages("system", {search: "Simple Worldbuilding"});
+    }
+  }
+
+  /* -------------------------------------------- */
+
+  /**
+   * Handle Step setup for the Creating a World Tour
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _creatingAWorld() {
+
+    // Activate the World tab
+    if ( this.currentStep.id === "worldTab" ) {
+      ui.setupPackages.activateTab("world");
+    }
+    else if ( this.currentStep.id === "worldTitle" ) {
+      let world = new World({
+        name: "my-first-world",
+        title: "My First World",
+        system: Array.from(game.systems)[0].id,
+        coreVersion: game.release.version,
+        description: game.i18n.localize("SETUP.NueWorldDescription")
+      });
+      const options = {
+        create: true
+      };
+
+      // Render the World configuration application
+      this.focusedApp = new WorldConfig(world, options);
+      await this.focusedApp._render(true);
+    }
+    else if ( this.currentStep.id === "launching" ) {
+      await this.focusedApp.submit();
+    }
+  }
+}

resources/app/client/tours/sidebar-tour.js

@@ -0,0 +1,31 @@
+/**
+ * A Tour subclass for the Sidebar Tour
+ */
+class SidebarTour extends Tour {
+
+  /** @override */
+  async start() {
+    game.togglePause(false);
+    await super.start();
+  }
+
+  /* -------------------------------------------- */
+
+  /** @override */
+  async _preStep() {
+    await super._preStep();
+
+    // Configure specific steps
+    if ( (this.id === "sidebar") || (this.id === "welcome") ) {
+      await this._updateSidebarTab();
+    }
+  }
+
+  /* -------------------------------------------- */
+
+  async _updateSidebarTab() {
+    if ( this.currentStep.sidebarTab ) {
+      ui.sidebar.activateTab(this.currentStep.sidebarTab);
+    }
+  }
+}