feat(stepper): add stepper plugin metadata resolution

src/plugins.ts

@@ -1,7 +1,9 @@
-import { IPluginDefinition } from "./types";
+import { stepperPlugin } from "./plugins/stepper";
+import type { IPluginDefinition } from "./types";
 import { generatePluginMap } from "./util";
 
 export const plugins: IPluginDefinition[] = [
+    stepperPlugin,
 ];
 
 export const pluginMap: Map<string, IPluginDefinition> = /*#__PURE__*/ generatePluginMap(plugins);

src/plugins/stepper.ts

@@ -0,0 +1,18 @@
+import { type IPluginDefinition, PluginType } from "../types";
+
+/**
+ * The Stepper (substitution visualizer) host plugin.
+ *
+ * Only a WEB resolution is provided: the runner half is bundled into each language's evaluator (it
+ * extends `@sourceacademy/runner-stepper`), and the evaluator pulls in this web half by calling
+ * `hostLoadPlugin("stepper")`. The id must match `STEPPER_DIRECTORY_ID` from
+ * `@sourceacademy/common-stepper`.
+ */
+export const stepperPlugin: IPluginDefinition = {
+    id: "stepper",
+    name: "Stepper",
+    description: "Visualises the step-by-step substitution evaluation of a program.",
+    resolutions: {
+        [PluginType.WEB]: "https://source-academy.github.io/plugins/web/stepper/dist/index.mjs",
+    },
+};

src/util.ts

@@ -1,4 +1,4 @@
-import { IPluginDefinition } from "./types";
+import type { IPluginDefinition } from "./types";
 
 export function generatePluginMap(plugins: IPluginDefinition[]): Map<string, IPluginDefinition> {
     return new Map(plugins.map(plugin => [plugin.id, plugin]));