feat: add the snippets plugin (B2)

plugins/snippets/tests/frontend/activate.test.tsx

@@ -0,0 +1,84 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { screen } from "@testing-library/react";
+import {
+  renderWithApp,
+  type RenderedPluginApp,
+} from "@termix/plugin-sdk/testing";
+import type { PluginManifest } from "@termix/plugin-sdk/manifest";
+import * as plugin from "../../src/frontend/index";
+import manifestJson from "../../manifest.json";
+import locales from "../../locales/en.json";
+
+const manifest = manifestJson as unknown as PluginManifest;
+
+const declared = (views?: Array<{ id: string }>) =>
+  (views ?? []).map((view) => view.id).sort();
+
+let rendered: RenderedPluginApp | null = null;
+
+afterEach(async () => {
+  await rendered?.deactivate();
+  rendered = null;
+});
+
+describe(`${manifest.id} activate`, () => {
+  it("activates and registers only views its manifest declares", async () => {
+    rendered = await renderWithApp(plugin, { manifest, locales });
+    const contributes = manifest.contributes as unknown as Record<
+      string,
+      Array<{ id: string }> | undefined
+    >;
+    const panels = declared(contributes.panels);
+    for (const id of rendered.registered.panels()) expect(panels).toContain(id);
+  });
+
+  it("registers the rail item gated on the view permission", async () => {
+    rendered = await renderWithApp(plugin, { manifest, locales });
+    const railItem = rendered.registered
+      .railItems()
+      .find((i) => i.id === "snippets");
+    expect(railItem).toBeDefined();
+    expect(railItem?.permission).toBe("snippets.view");
+  });
+
+  it("registers the snippets.resolveForTerminal action", async () => {
+    rendered = await renderWithApp(plugin, { manifest, locales });
+    expect(rendered.registered.actions()).toContain(
+      "snippets.resolveForTerminal",
+    );
+  });
+
+  it("removes everything it registered on deactivate", async () => {
+    const app = await renderWithApp(plugin, { manifest, locales });
+    await app.deactivate();
+    expect(app.registered.panels()).toEqual([]);
+    expect(app.registered.railItems()).toEqual([]);
+    expect(app.registered.actions()).toEqual([]);
+  });
+});
+
+describe("snippets panel", () => {
+  it("renders the empty state when the user has no snippets", async () => {
+    const api = {
+      get: vi.fn(async () => ({ data: [] })),
+    };
+    rendered = await renderWithApp(plugin, {
+      manifest,
+      locales,
+      api: api as never,
+      permissions: ["snippets.view", "snippets.create"],
+    });
+    rendered.renderPanel("snippets", { active: true });
+    await expect(screen.findByPlaceholderText(/search/i)).resolves.toBeTruthy();
+  });
+
+  it("renders nothing without the view permission", async () => {
+    rendered = await renderWithApp(plugin, {
+      manifest,
+      locales,
+      permissions: [],
+    });
+    const panel = rendered.renderPanel("snippets", { active: true });
+    expect(panel.textContent).toBe("");
+  });
+});

plugins/snippets/tests/frontend/snippet-variables.test.ts

@@ -0,0 +1,79 @@
+import { describe, it, expect } from "vitest";
+import {
+  extractSnippetInputs,
+  hasSnippetInputs,
+  resolveSnippetContent,
+} from "../../src/frontend/snippet-variables";
+
+describe("extractSnippetInputs", () => {
+  it("extracts a single unlabeled input", () => {
+    expect(extractSnippetInputs("ping $INPUT_1")).toEqual([
+      { key: "INPUT_1", label: "Input 1" },
+    ]);
+  });
+
+  it("extracts a labeled input using brace syntax", () => {
+    expect(
+      extractSnippetInputs("nc -zv $HOST ${INPUT_1:Port to check}"),
+    ).toEqual([{ key: "INPUT_1", label: "Port to check" }]);
+  });
+
+  it("plain (non-braced) references have no label", () => {
+    expect(extractSnippetInputs("echo $INPUT_2")).toEqual([
+      { key: "INPUT_2", label: "Input 2" },
+    ]);
+  });
+
+  it("de-duplicates repeated references and preserves first-seen order", () => {
+    expect(
+      extractSnippetInputs("$INPUT_2 then $INPUT_1 then $INPUT_2 again"),
+    ).toEqual([
+      { key: "INPUT_2", label: "Input 2" },
+      { key: "INPUT_1", label: "Input 1" },
+    ]);
+  });
+
+  it("returns an empty array when there are no placeholders", () => {
+    expect(extractSnippetInputs("uptime")).toEqual([]);
+  });
+});
+
+describe("hasSnippetInputs", () => {
+  it("returns true when a snippet has an input placeholder", () => {
+    expect(hasSnippetInputs("echo $INPUT_1")).toBe(true);
+  });
+
+  it("returns false when a snippet has no input placeholder", () => {
+    expect(hasSnippetInputs("echo $HOST")).toBe(false);
+  });
+});
+
+describe("resolveSnippetContent", () => {
+  const host = { ip: "10.0.0.5", username: "root", port: 22, name: "web-01" };
+
+  it("substitutes host variables", () => {
+    expect(
+      resolveSnippetContent("ssh $USER@$HOST -p $PORT # $NAME", host),
+    ).toBe("ssh root@10.0.0.5 -p 22 # web-01");
+  });
+
+  it("supports brace syntax for host variables", () => {
+    expect(resolveSnippetContent("ping ${HOST}", host)).toBe("ping 10.0.0.5");
+  });
+
+  it("substitutes input placeholders", () => {
+    expect(
+      resolveSnippetContent("nc -zv $HOST ${INPUT_1:Port}", host, {
+        INPUT_1: "8080",
+      }),
+    ).toBe("nc -zv 10.0.0.5 8080");
+  });
+
+  it("leaves host variables literal when no host context is given", () => {
+    expect(resolveSnippetContent("ping $HOST", null)).toBe("ping $HOST");
+  });
+
+  it("leaves input placeholders literal when no value was supplied", () => {
+    expect(resolveSnippetContent("echo $INPUT_1", null)).toBe("echo $INPUT_1");
+  });
+});