@igstack/app-catalog-test-kit 0.18.6

package/dist/esm/tools/CatalogTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatalogTools.js","sources":["../../../src/tools/CatalogTools.ts"],"sourcesContent":["import { fireEvent, screen, within } from '@testing-library/react'\nimport userEvent from '@testing-library/user-event'\n\nexport interface TableRow {\n  name: string\n  description: string\n}\n\nexport class CatalogTools {\n  private user = userEvent.setup()\n\n  /**\n   * Click an app row by display name.\n   * Works against both the table/grid view and the launcher home (#38), which\n   * renders app rows as buttons rather than a <table>.\n   * Throws with list of visible apps if name not found.\n   */\n  async openApp(name: string): Promise<void> {\n    const table = this.getCatalogTable()\n    if (table) {\n      const rows = within(table).getAllByRole('row')\n      for (const row of rows) {\n        const nameEl = row.querySelector('.font-medium')\n        if (nameEl?.textContent.trim() === name) {\n          await this.user.click(row)\n          return\n        }\n      }\n    } else {\n      // Launcher home: rows are buttons titled \"View <name>\".\n      const btn = screen.queryByTitle(`View ${name}`)\n      if (btn) {\n        await this.user.click(btn)\n        return\n      }\n    }\n\n    const visibleNames = this.getTableData().map((r) => r.name)\n    throw new Error(\n      `App \"${name}\" not found. Visible apps: [${visibleNames.join(', ')}]`,\n    )\n  }\n\n  /**\n   * Type into the search input.\n   */\n  async search(text: string): Promise<void> {\n    const input = screen.getByLabelText('Search apps')\n    fireEvent.change(input, { target: { value: text } })\n  }\n\n  /** The catalog search input. */\n  getSearchInput(): HTMLInputElement {\n    return screen.getByLabelText<HTMLInputElement>('Search apps')\n  }\n\n  /**\n   * Parse the catalog table into structured data.\n   * Skips group header rows (colspan rows).\n   */\n  getTableData(): TableRow[] {\n    const table = this.getCatalogTable()\n    if (!table) {\n      // Check if there's a global error — throw with details for debugging\n      const bodyText = document.body.textContent\n      if (\n        bodyText.includes('Something went wrong') ||\n        bodyText.includes('Ooops')\n      ) {\n        throw new Error(\n          `Cannot read table — global error on page: ${bodyText.slice(0, 500)}`,\n        )\n      }\n      // Launcher home (#38): no <table>; read the app row buttons instead.\n      const launcherRows = this.getLauncherRows()\n      if (launcherRows.length > 0) return launcherRows\n      throw new Error('No table or launcher rows found on page')\n    }\n\n    const rows = within(table).getAllByRole('row')\n    const result: TableRow[] = []\n\n    for (const row of rows) {\n      const cells = within(row).queryAllByRole('cell')\n      // Skip header rows and group header rows (single cell with colspan)\n      if (cells.length < 2) continue\n\n      const nameEl = cells[0]?.querySelector('.font-medium')\n      if (!nameEl) continue\n\n      result.push({\n        name: nameEl.textContent.trim(),\n        description: cells[1]?.textContent.trim() ?? '',\n      })\n    }\n\n    return result\n  }\n\n  /**\n   * The secondary \"open in new tab\" launch link for a row, by app name.\n   * Returns null if the row has no launch link.\n   */\n  getLaunchLink(name: string): HTMLAnchorElement | null {\n    // The launch link's aria-label starts with \"Open <name> in a new tab\" and\n    // may append the destination URL, e.g. \"… in a new tab (foo.example.com)\".\n    return screen.queryByLabelText<HTMLAnchorElement>(\n      new RegExp(`^Open ${name} in a new tab`),\n    )\n  }\n\n  /**\n   * Whether the right detail panel is currently visible.\n   */\n  isDetailPanelOpen(): boolean {\n    return !!screen.queryByLabelText('Close details panel')\n  }\n\n  /** Whether the \"Show Deprecated Apps\" toggle is currently checked. */\n  isShowDeprecatedChecked(): boolean {\n    const cb = screen.getByRole('checkbox', { name: /Show Deprecated Apps/i })\n    return (\n      cb.getAttribute('aria-checked') === 'true' ||\n      cb.getAttribute('data-state') === 'checked'\n    )\n  }\n\n  /** Whether the \"showing deprecated matches\" fallback notice is visible. */\n  hasDeprecatedFallbackNotice(): boolean {\n    return !!screen.queryByText(/showing deprecated matches/i)\n  }\n\n  /** Whether the \"No apps found\" empty state or search-morph \"No results for\" is visible. */\n  isEmptyStateVisible(): boolean {\n    return (\n      !!screen.queryByText(/No apps found/i) ||\n      !!screen.queryByText(/No results for/i)\n    )\n  }\n\n  /**\n   * Whether the onboarding/welcome card is visible.\n   */\n  isOnboardingVisible(): boolean {\n    return !!screen.queryByText('Welcome to App Catalog')\n  }\n\n  /**\n   * Read app rows from the launcher home (#38): buttons titled \"View <name>\".\n   * Name is the first `.font-semibold`/`.font-bold` span; description the\n   * `.text-muted-foreground` span. Deduped by name (an app can appear both in\n   * \"Your apps\" and \"Browse all\").\n   */\n  private getLauncherRows(): TableRow[] {\n    const buttons = Array.from(\n      document.querySelectorAll<HTMLElement>('button[title^=\"View \"]'),\n    )\n    const seen = new Set<string>()\n    const result: TableRow[] = []\n    for (const btn of buttons) {\n      const name = (btn.getAttribute('title') ?? '')\n        .replace(/^View\\s+/, '')\n        .trim()\n      if (!name || seen.has(name)) continue\n      seen.add(name)\n      const descEl = btn.querySelector('.text-muted-foreground')\n      result.push({ name, description: descEl?.textContent.trim() ?? '' })\n    }\n    return result\n  }\n\n  /**\n   * Get expandable subresource rows shown under parents in search results.\n   * Returns null if no sub-rows are visible.\n   */\n  getSubResourceRows(): {\n    visible: number\n    total: number\n    hasExpandRow: boolean\n    names: string[]\n  } | null {\n    const subButtons = Array.from(\n      document.querySelectorAll<HTMLButtonElement>(\n        'button[class*=\"border-l-2\"]',\n      ),\n    )\n    if (subButtons.length === 0) return null\n\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    const getText = (el: HTMLButtonElement) => (el.textContent ?? '').trim()\n    const isExpandRow = (el: HTMLButtonElement) => getText(el).startsWith('...')\n\n    const expandButton = subButtons.find(isExpandRow)\n    const hasExpandRow = !!expandButton\n\n    let hiddenCount = 0\n    if (expandButton) {\n      const match = /\\d+/.exec(getText(expandButton))\n      hiddenCount = match?.[0] ? parseInt(match[0], 10) : 0\n    }\n\n    const visibleSubs = subButtons.filter((b) => !isExpandRow(b))\n\n    return {\n      visible: visibleSubs.length,\n      total: visibleSubs.length + hiddenCount,\n      hasExpandRow,\n      names: visibleSubs.map((b) => getText(b)),\n    }\n  }\n\n  async clickSubResource(displayName: string): Promise<void> {\n    const subButtons = Array.from(\n      document.querySelectorAll<HTMLButtonElement>(\n        'button[class*=\"border-l-2\"]',\n      ),\n    )\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    const getText = (el: HTMLButtonElement) => (el.textContent ?? '').trim()\n    const target = subButtons.find(\n      (b) =>\n        getText(b) === displayName && !getText(b).trimStart().startsWith('...'),\n    )\n    if (!target) {\n      throw new Error(\n        `Sub-resource \"${displayName}\" not found in search result rows`,\n      )\n    }\n    await this.user.click(target)\n  }\n\n  async expandSubResources(): Promise<void> {\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    const getText = (el: HTMLButtonElement) => (el.textContent ?? '').trim()\n    const expandButtons = Array.from(\n      document.querySelectorAll<HTMLButtonElement>(\n        'button[class*=\"border-l-2\"]',\n      ),\n    ).filter((b) => getText(b).trimStart().startsWith('...'))\n    if (expandButtons.length === 0) {\n      throw new Error('No expand (\"...N more\") button found')\n    }\n    await this.user.click(expandButtons[0]!)\n  }\n\n  /**\n   * Get the main catalog table (first table on page, skipping sub-resource tables in detail panel).\n   */\n  private getCatalogTable(): HTMLElement | null {\n    const tables = screen.queryAllByRole('table')\n    // The catalog table is the first table; sub-resource tables appear later in the detail panel\n    return tables[0] ?? null\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/tools/ErrorTools.d.ts

@@ -0,0 +1,15 @@
+export interface GlobalError {
+    title: string;
+    message: string;
+    element: HTMLElement;
+}
+/**
+ * Find the global error on page.
+ *
+ * Checks for:
+ * 1. Our custom DefaultErrorComponent (role="alert" with "Ooops!")
+ * 2. TanStack Router's built-in error boundary ("Something went wrong!")
+ *
+ * Throws with page content dump if no error is found — makes debugging easier.
+ */
+export declare function getGlobalError(): GlobalError;

package/dist/esm/tools/ErrorTools.js

@@ -0,0 +1,34 @@
+import { screen } from "@testing-library/react";
+function getGlobalError() {
+  const alertElement = screen.queryByRole("alert");
+  if (alertElement) {
+    const messageEl = alertElement.querySelector("i");
+    return {
+      title: "Ooops!",
+      message: (messageEl == null ? void 0 : messageEl.textContent) ?? alertElement.textContent,
+      element: alertElement
+    };
+  }
+  const bodyText = document.body.textContent;
+  if (bodyText.includes("Something went wrong")) {
+    const codeEl = document.querySelector("code");
+    const errorContainer = document.querySelector('[style*="padding"]') ?? document.body;
+    return {
+      title: "Something went wrong!",
+      message: (codeEl == null ? void 0 : codeEl.textContent) ?? bodyText,
+      element: errorContainer
+    };
+  }
+  const body = document.body.innerHTML;
+  const snippet = body.length > 2e3 ? body.slice(0, 2e3) + "..." : body;
+  throw new Error(
+    `No global error found on page. Expected a role="alert" or "Something went wrong" element.
+
+Page content:
+${snippet}`
+  );
+}
+export {
+  getGlobalError
+};
+//# sourceMappingURL=ErrorTools.js.map

package/dist/esm/tools/ErrorTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorTools.js","sources":["../../../src/tools/ErrorTools.ts"],"sourcesContent":["import { screen } from '@testing-library/react'\n\nexport interface GlobalError {\n  title: string\n  message: string\n  element: HTMLElement\n}\n\n/**\n * Find the global error on page.\n *\n * Checks for:\n * 1. Our custom DefaultErrorComponent (role=\"alert\" with \"Ooops!\")\n * 2. TanStack Router's built-in error boundary (\"Something went wrong!\")\n *\n * Throws with page content dump if no error is found — makes debugging easier.\n */\nexport function getGlobalError(): GlobalError {\n  // Check our custom error component first\n  const alertElement = screen.queryByRole('alert')\n  if (alertElement) {\n    const messageEl = alertElement.querySelector('i')\n    return {\n      title: 'Ooops!',\n      message: messageEl?.textContent ?? alertElement.textContent,\n      element: alertElement,\n    }\n  }\n\n  // Check TanStack Router's built-in error boundary\n  const bodyText = document.body.textContent\n  if (bodyText.includes('Something went wrong')) {\n    const codeEl = document.querySelector('code')\n    const errorContainer =\n      document.querySelector('[style*=\"padding\"]') ?? document.body\n    return {\n      title: 'Something went wrong!',\n      message: codeEl?.textContent ?? bodyText,\n      element: errorContainer as HTMLElement,\n    }\n  }\n\n  // No error found — dump page for debugging\n  const body = document.body.innerHTML\n  const snippet = body.length > 2000 ? body.slice(0, 2000) + '...' : body\n  throw new Error(\n    `No global error found on page. Expected a role=\"alert\" or \"Something went wrong\" element.\\n\\nPage content:\\n${snippet}`,\n  )\n}\n"],"names":[],"mappings":";AAiBO,SAAS,iBAA8B;AAE5C,QAAM,eAAe,OAAO,YAAY,OAAO;AAC/C,MAAI,cAAc;AAChB,UAAM,YAAY,aAAa,cAAc,GAAG;AAChD,WAAO;AAAA,MACL,OAAO;AAAA,MACP,UAAS,uCAAW,gBAAe,aAAa;AAAA,MAChD,SAAS;AAAA,IAAA;AAAA,EAEb;AAGA,QAAM,WAAW,SAAS,KAAK;AAC/B,MAAI,SAAS,SAAS,sBAAsB,GAAG;AAC7C,UAAM,SAAS,SAAS,cAAc,MAAM;AAC5C,UAAM,iBACJ,SAAS,cAAc,oBAAoB,KAAK,SAAS;AAC3D,WAAO;AAAA,MACL,OAAO;AAAA,MACP,UAAS,iCAAQ,gBAAe;AAAA,MAChC,SAAS;AAAA,IAAA;AAAA,EAEb;AAGA,QAAM,OAAO,SAAS,KAAK;AAC3B,QAAM,UAAU,KAAK,SAAS,MAAO,KAAK,MAAM,GAAG,GAAI,IAAI,QAAQ;AACnE,QAAM,IAAI;AAAA,IACR;AAAA;AAAA;AAAA,EAA+G,OAAO;AAAA,EAAA;AAE1H;"}

package/dist/esm/tools/GalleryTools.d.ts

@@ -0,0 +1,6 @@
+export declare class GalleryTools {
+    private user;
+    clickNext(): Promise<void>;
+    clickPrev(): Promise<void>;
+    isOpen(): boolean;
+}

package/dist/esm/tools/GalleryTools.js

@@ -0,0 +1,22 @@
+import { screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+class GalleryTools {
+  constructor() {
+    this.user = userEvent.setup();
+  }
+  async clickNext() {
+    const nextBtn = screen.getByRole("button", { name: /next/i });
+    await this.user.click(nextBtn);
+  }
+  async clickPrev() {
+    const prevBtn = screen.getByRole("button", { name: /prev/i });
+    await this.user.click(prevBtn);
+  }
+  isOpen() {
+    return !!(screen.queryByRole("button", { name: /next/i }) && screen.queryByRole("button", { name: /prev/i }));
+  }
+}
+export {
+  GalleryTools
+};
+//# sourceMappingURL=GalleryTools.js.map

package/dist/esm/tools/GalleryTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GalleryTools.js","sources":["../../../src/tools/GalleryTools.ts"],"sourcesContent":["import { screen } from '@testing-library/react'\nimport userEvent from '@testing-library/user-event'\n\nexport class GalleryTools {\n  private user = userEvent.setup()\n\n  async clickNext(): Promise<void> {\n    const nextBtn = screen.getByRole('button', { name: /next/i })\n    await this.user.click(nextBtn)\n  }\n\n  async clickPrev(): Promise<void> {\n    const prevBtn = screen.getByRole('button', { name: /prev/i })\n    await this.user.click(prevBtn)\n  }\n\n  isOpen(): boolean {\n    // Detect the SCREENSHOT gallery specifically — not just any [role=\"dialog\"]\n    // (the app detail card is also a dialog now, #38). The gallery is the only\n    // dialog with next/prev navigation controls.\n    return !!(\n      screen.queryByRole('button', { name: /next/i }) &&\n      screen.queryByRole('button', { name: /prev/i })\n    )\n  }\n}\n"],"names":[],"mappings":";;AAGO,MAAM,aAAa;AAAA,EAAnB,cAAA;AACL,SAAQ,OAAO,UAAU,MAAA;AAAA,EAAM;AAAA,EAE/B,MAAM,YAA2B;AAC/B,UAAM,UAAU,OAAO,UAAU,UAAU,EAAE,MAAM,SAAS;AAC5D,UAAM,KAAK,KAAK,MAAM,OAAO;AAAA,EAC/B;AAAA,EAEA,MAAM,YAA2B;AAC/B,UAAM,UAAU,OAAO,UAAU,UAAU,EAAE,MAAM,SAAS;AAC5D,UAAM,KAAK,KAAK,MAAM,OAAO;AAAA,EAC/B;AAAA,EAEA,SAAkB;AAIhB,WAAO,CAAC,EACN,OAAO,YAAY,UAAU,EAAE,MAAM,QAAA,CAAS,KAC9C,OAAO,YAAY,UAAU,EAAE,MAAM,SAAS;AAAA,EAElD;AACF;"}

package/dist/esm/tools/suppressConsole.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Suppress console output matching the given patterns for the current test only.
+ * Automatically resumes after the test completes (pass or fail).
+ *
+ * Usage:
+ *   suppressConsole(/Failed to fetch/)
+ *   suppressConsole([/Failed to fetch/, /error boundary/])
+ */
+export declare function suppressConsole(patterns: RegExp | RegExp[]): void;
+/**
+ * Suppress console output matching the given patterns for ALL tests in this file.
+ * Call at the top level of `describe()` or at module scope.
+ * Does NOT auto-clear between tests.
+ *
+ * Usage:
+ *   suppressConsoleGlobal(/Background sync failed/)
+ *   suppressConsoleGlobal([/Background sync/, /some other noise/])
+ */
+export declare function suppressConsoleGlobal(patterns: RegExp | RegExp[]): void;

package/dist/esm/tools/suppressConsole.js

@@ -0,0 +1,44 @@
+import { afterEach } from "vitest";
+const globalPatterns = [];
+let testPatterns = [];
+const originals = {
+  log: console.log.bind(console),
+  warn: console.warn.bind(console),
+  error: console.error.bind(console),
+  debug: console.debug.bind(console)
+};
+function isSuppressed(args) {
+  const all = [...globalPatterns, ...testPatterns];
+  if (all.length === 0) return false;
+  const text = args.map(String).join(" ");
+  return all.some((p) => p.test(text));
+}
+let installed = false;
+function installOnce() {
+  if (installed) return;
+  installed = true;
+  for (const method of ["log", "warn", "error", "debug"]) {
+    const original = originals[method];
+    console[method] = (...args) => {
+      if (!isSuppressed(args)) original(...args);
+    };
+  }
+  afterEach(() => {
+    testPatterns = [];
+  });
+}
+function suppressConsole(patterns) {
+  installOnce();
+  const arr = Array.isArray(patterns) ? patterns : [patterns];
+  testPatterns.push(...arr);
+}
+function suppressConsoleGlobal(patterns) {
+  installOnce();
+  const arr = Array.isArray(patterns) ? patterns : [patterns];
+  globalPatterns.push(...arr);
+}
+export {
+  suppressConsole,
+  suppressConsoleGlobal
+};
+//# sourceMappingURL=suppressConsole.js.map

package/dist/esm/tools/suppressConsole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppressConsole.js","sources":["../../../src/tools/suppressConsole.ts"],"sourcesContent":["import { afterEach } from 'vitest'\n\nconst globalPatterns: RegExp[] = []\nlet testPatterns: RegExp[] = []\n\nconst originals = {\n  log: console.log.bind(console),\n  warn: console.warn.bind(console),\n  error: console.error.bind(console),\n  debug: console.debug.bind(console),\n}\n\nfunction isSuppressed(args: unknown[]): boolean {\n  const all = [...globalPatterns, ...testPatterns]\n  if (all.length === 0) return false\n  const text = args.map(String).join(' ')\n  return all.some((p) => p.test(text))\n}\n\nlet installed = false\n\nfunction installOnce() {\n  if (installed) return\n  installed = true\n\n  for (const method of ['log', 'warn', 'error', 'debug'] as const) {\n    const original = originals[method]\n    console[method] = (...args: unknown[]) => {\n      if (!isSuppressed(args)) original(...args)\n    }\n  }\n\n  // Auto-clear test-scoped patterns after each test (global patterns persist)\n  afterEach(() => {\n    testPatterns = []\n  })\n}\n\n/**\n * Suppress console output matching the given patterns for the current test only.\n * Automatically resumes after the test completes (pass or fail).\n *\n * Usage:\n *   suppressConsole(/Failed to fetch/)\n *   suppressConsole([/Failed to fetch/, /error boundary/])\n */\nexport function suppressConsole(patterns: RegExp | RegExp[]): void {\n  installOnce()\n  const arr = Array.isArray(patterns) ? patterns : [patterns]\n  testPatterns.push(...arr)\n}\n\n/**\n * Suppress console output matching the given patterns for ALL tests in this file.\n * Call at the top level of `describe()` or at module scope.\n * Does NOT auto-clear between tests.\n *\n * Usage:\n *   suppressConsoleGlobal(/Background sync failed/)\n *   suppressConsoleGlobal([/Background sync/, /some other noise/])\n */\nexport function suppressConsoleGlobal(patterns: RegExp | RegExp[]): void {\n  installOnce()\n  const arr = Array.isArray(patterns) ? patterns : [patterns]\n  globalPatterns.push(...arr)\n}\n"],"names":[],"mappings":";AAEA,MAAM,iBAA2B,CAAA;AACjC,IAAI,eAAyB,CAAA;AAE7B,MAAM,YAAY;AAAA,EAChB,KAAK,QAAQ,IAAI,KAAK,OAAO;AAAA,EAC7B,MAAM,QAAQ,KAAK,KAAK,OAAO;AAAA,EAC/B,OAAO,QAAQ,MAAM,KAAK,OAAO;AAAA,EACjC,OAAO,QAAQ,MAAM,KAAK,OAAO;AACnC;AAEA,SAAS,aAAa,MAA0B;AAC9C,QAAM,MAAM,CAAC,GAAG,gBAAgB,GAAG,YAAY;AAC/C,MAAI,IAAI,WAAW,EAAG,QAAO;AAC7B,QAAM,OAAO,KAAK,IAAI,MAAM,EAAE,KAAK,GAAG;AACtC,SAAO,IAAI,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC;AACrC;AAEA,IAAI,YAAY;AAEhB,SAAS,cAAc;AACrB,MAAI,UAAW;AACf,cAAY;AAEZ,aAAW,UAAU,CAAC,OAAO,QAAQ,SAAS,OAAO,GAAY;AAC/D,UAAM,WAAW,UAAU,MAAM;AACjC,YAAQ,MAAM,IAAI,IAAI,SAAoB;AACxC,UAAI,CAAC,aAAa,IAAI,EAAG,UAAS,GAAG,IAAI;AAAA,IAC3C;AAAA,EACF;AAGA,YAAU,MAAM;AACd,mBAAe,CAAA;AAAA,EACjB,CAAC;AACH;AAUO,SAAS,gBAAgB,UAAmC;AACjE,cAAA;AACA,QAAM,MAAM,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,QAAQ;AAC1D,eAAa,KAAK,GAAG,GAAG;AAC1B;AAWO,SAAS,sBAAsB,UAAmC;AACvE,cAAA;AACA,QAAM,MAAM,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,QAAQ;AAC1D,iBAAe,KAAK,GAAG,GAAG;AAC5B;"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@igstack/app-catalog-test-kit",
+  "version": "0.18.6",
+  "description": "Integration test harness for App Catalog: mock backend, mock network and page objects",
+  "homepage": "https://github.com/lislon/app-catalog",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lislon/app-catalog.git",
+    "directory": "packages/test-kit"
+  },
+  "license": "MIT",
+  "author": "Igor Golovin",
+  "sideEffects": [
+    "./src/setup/*",
+    "./dist/esm/setup/*"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "my-custom-condition": "./src/index.ts",
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    },
+    "./setup": {
+      "my-custom-condition": "./src/setup/testSetup.ts",
+      "import": {
+        "types": "./dist/esm/setup/testSetup.d.ts",
+        "default": "./dist/esm/setup/testSetup.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "clean": "premove ./dist ./coverage ./dist-ts",
+    "compile": "tsc --build",
+    "fix": "prettier --write ./src ./tests && eslint --fix ./src ./tests",
+    "test": "pnpm run test:unit",
+    "test:eslint": "eslint ./src ./tests --max-warnings=0",
+    "test:types": "tsc --noEmit",
+    "test:unit": "vitest --run",
+    "test:unit:dev": "vitest"
+  },
+  "dependencies": {
+    "@tanstack/react-query": "catalog:",
+    "@tanstack/react-router": "catalog:",
+    "@testing-library/jest-dom": "catalog:",
+    "@testing-library/react": "catalog:",
+    "@testing-library/user-event": "^14.6.1",
+    "@trpc/client": "catalog:",
+    "fake-indexeddb": "^6.2.4",
+    "msw": "^2.12.14",
+    "msw-trpc": "^2.0.1",
+    "superjson": "catalog:"
+  },
+  "devDependencies": {
+    "@igstack/app-catalog-backend-core": "workspace:*",
+    "@igstack/app-catalog-frontend-core": "workspace:*",
+    "@tanstack/vite-config": "catalog:",
+    "@types/node": "catalog:",
+    "@types/react": "catalog:",
+    "@vitejs/plugin-react": "catalog:",
+    "jsdom": "^25.0.1",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vitest": "catalog:"
+  },
+  "peerDependencies": {
+    "@igstack/app-catalog-backend-core": "workspace:^",
+    "@igstack/app-catalog-frontend-core": "workspace:^",
+    "jsdom": ">=25",
+    "react": "catalog:",
+    "react-dom": "catalog:",
+    "vitest": "catalog:"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/src/harness/MockBackendVerifier.ts

@@ -0,0 +1,14 @@
+import type { Resource } from '@igstack/app-catalog-backend-core'
+import type { MockDb } from '../mock-backend/MockDb'
+
+export class MockBackendVerifier {
+  constructor(readonly db: MockDb) {}
+
+  apps(): Resource[] {
+    return this.db.getResources()
+  }
+
+  getApp(slug: string): Resource {
+    return this.db.getResource(slug)
+  }
+}

package/src/harness/given.tsx

@@ -0,0 +1,212 @@
+import { render, screen, waitFor } from '@testing-library/react'
+import { createMemoryHistory } from '@tanstack/react-router'
+import { createTRPCClient, httpLink } from '@trpc/client'
+import { QueryClient } from '@tanstack/react-query'
+import type { TRPCRouter } from '@igstack/app-catalog-backend-core'
+import { setupServer } from 'msw/node'
+import type { SetupServer } from 'msw/node'
+
+import {
+  AcDb,
+  App,
+  SEARCH_STORAGE_KEY,
+  createAcRouter,
+} from '@igstack/app-catalog-frontend-core/internal'
+
+import { MockDb } from '../mock-backend/MockDb'
+import { MockUserContext } from '../mock-backend/MockUserContext'
+import { MockService } from '../mock-backend/MockService'
+import {
+  MockBackendConfigurer,
+  resetConfigurerCounter,
+} from '../mock-backend/MockBackendConfigurer'
+import { BrowserStateCfg } from '../mock-backend/BrowserStateCfg'
+import { NetworkConfigurerCfg } from '../mock-network/NetworkConfigurerCfg'
+import type { ConfigurerContext, Magazine } from '../mock-backend/magazines'
+import { makeNetworkReplyWithCatalog } from '../mock-network/makeNetworkReplyWithCatalog'
+import { MockBackendVerifier } from './MockBackendVerifier'
+import { getGlobalError } from '../tools/ErrorTools'
+import type { GlobalError } from '../tools/ErrorTools'
+import { browserState } from '../tools/BrowserState'
+import { CatalogTools } from '../tools/CatalogTools'
+import { AppDetailTools } from '../tools/AppDetailTools'
+import { GalleryTools } from '../tools/GalleryTools'
+
+export interface GivenResult {
+  ui: UiTools
+  backend: MockBackendVerifier
+  router: ReturnType<typeof createAcRouter>
+}
+
+export interface UiTools {
+  catalog: CatalogTools
+  app: AppDetailTools
+  gallery: GalleryTools
+  globalError: () => GlobalError
+}
+
+// Track active resources for cleanup
+let activeServer: SetupServer | null = null
+let activeDb: AcDb | null = null
+
+export async function cleanupTestResources(): Promise<void> {
+  if (activeServer) {
+    activeServer.close()
+    activeServer = null
+  }
+  if (activeDb) {
+    activeDb.close()
+    await activeDb.delete()
+    activeDb = null
+  }
+}
+
+export async function given(
+  magazine: Magazine,
+  opts: { initialRoute?: string; seedSearch?: string } = {},
+): Promise<GivenResult> {
+  // Clean up any previous resources
+  await cleanupTestResources()
+  resetConfigurerCounter()
+
+  // 1. Create cfg objects (data carriers)
+  const db = new MockDb()
+  const userContext = new MockUserContext()
+  const backendCfg = new MockBackendConfigurer(db, userContext)
+  const browserStateCfg = new BrowserStateCfg()
+  const networkCfg = new NetworkConfigurerCfg()
+
+  const ctx: ConfigurerContext = { backendCfg, browserStateCfg, networkCfg }
+
+  // 2. Run magazine configurer — populates all three cfg objects
+  magazine(ctx)
+
+  // 3. Materialize backend service
+  const service = new MockService(db, userContext)
+
+  // 4. Apply browser state using data from backend service
+  if (browserStateCfg.shouldDismissOnboarding) {
+    browserState.dismissOnboarding()
+  }
+  if (browserStateCfg.shouldSeedOfflineData) {
+    await browserState.seedCatalogCache(service.getAppCatalogData())
+  }
+  for (const [key, value] of browserStateCfg.localStorageItems) {
+    localStorage.setItem(key, value)
+  }
+
+  // Seed the persisted catalog search (#27): simulates a returning user who had
+  // typed a query before navigating. Backs the same sessionStorage key the
+  // provider reads, so the search input repopulates without any `?q=` in the URL.
+  if (opts.seedSearch !== undefined) {
+    sessionStorage.setItem(SEARCH_STORAGE_KEY, opts.seedSearch)
+  }
+
+  // 5. Build network catalog from backend service, then apply overrides
+  const catalog = makeNetworkReplyWithCatalog(service)
+  for (const override of networkCfg.overrides) {
+    override(catalog, service)
+  }
+
+  // 6. Set up MSW server
+  const server = setupServer(...catalog.getHandlers())
+  server.listen({
+    onUnhandledRequest: (req) => {
+      console.warn(`[MSW] Unhandled: ${req.method} ${req.url}`)
+    },
+  })
+  activeServer = server
+
+  // 7. Create real app infrastructure
+  const trpcClient = createTRPCClient<TRPCRouter>({
+    links: [
+      httpLink({
+        url: 'http://localhost/api/trpc',
+      }),
+    ],
+  })
+
+  const acDb = new AcDb()
+  activeDb = acDb
+  const queryClient = new QueryClient({
+    defaultOptions: {
+      queries: {
+        retry: false,
+        gcTime: 0,
+        meta: { db: acDb, trpcClient },
+      },
+    },
+  })
+
+  const router = createAcRouter({
+    history: createMemoryHistory({
+      initialEntries: [opts.initialRoute ?? '/catalog/apps'],
+    }),
+    context: {
+      queryClient,
+      trpcClient,
+      db: acDb,
+      plugins: [],
+      boostrapHealth: {},
+    },
+  })
+
+  // 7b. Seed auth user in localStorage for optimistic rendering
+  //     (mirrors real-app behavior where localStorage caches the user after first login)
+  const sessionResponse = service.getSessionResponse()
+  if (
+    sessionResponse &&
+    typeof sessionResponse === 'object' &&
+    'user' in sessionResponse
+  ) {
+    localStorage.setItem(
+      'ac_auth_user',
+      JSON.stringify((sessionResponse as { user: unknown }).user),
+    )
+  }
+
+  // 8. Render
+  render(
+    <App
+      router={router}
+      queryClient={queryClient}
+      trpcClient={trpcClient}
+      db={acDb}
+    />,
+  )
+
+  // 9. Wait for initial load (either data loaded or error shown)
+  await waitFor(
+    () => {
+      const hasAlert = screen.queryByRole('alert')
+      const hasTable = screen.queryAllByRole('table').length > 0
+      const hasSearchbox = screen.queryByLabelText('Search apps')
+      const hasTanstackError = document.body.textContent.includes(
+        'Something went wrong',
+      )
+      const hasNotFound = document.body.textContent.includes('404 Not Found')
+      if (
+        !hasAlert &&
+        !hasTable &&
+        !hasSearchbox &&
+        !hasTanstackError &&
+        !hasNotFound
+      ) {
+        throw new Error('Still loading...')
+      }
+    },
+    { timeout: 10000 },
+  )
+
+  // 10. Return tools
+  const backend = new MockBackendVerifier(db)
+
+  const ui: UiTools = {
+    catalog: new CatalogTools(),
+    app: new AppDetailTools(),
+    gallery: new GalleryTools(),
+    globalError: () => getGlobalError(),
+  }
+
+  return { ui, backend, router }
+}

package/src/index.ts

@@ -0,0 +1,44 @@
+/**
+ * Integration test harness for App Catalog.
+ *
+ * `given(...)` mounts the real `App` against a mock backend and mock network,
+ * and hands back page objects (`ui.catalog`, `ui.app`, ...) to drive it with.
+ * Consumers supply `vitest`, `jsdom` and the setup file:
+ *
+ *   // vite.config.ts
+ *   test: {
+ *     environment: 'jsdom',
+ *     setupFiles: ['@igstack/app-catalog-test-kit/setup'],
+ *   }
+ */
+export { given, cleanupTestResources } from './harness/given'
+export type { GivenResult, UiTools } from './harness/given'
+export { MockBackendVerifier } from './harness/MockBackendVerifier'
+
+export { magazine } from './mock-backend/magazines'
+export type { ConfigurerContext, Magazine } from './mock-backend/magazines'
+export {
+  MockBackendConfigurer,
+  resetConfigurerCounter,
+} from './mock-backend/MockBackendConfigurer'
+export { MockDb } from './mock-backend/MockDb'
+export { MockService } from './mock-backend/MockService'
+export { MockUserContext } from './mock-backend/MockUserContext'
+export type { UserConfig } from './mock-backend/MockUserContext'
+export { BrowserStateCfg } from './mock-backend/BrowserStateCfg'
+
+export { NetworkConfigurerCfg } from './mock-network/NetworkConfigurerCfg'
+export type { NetworkOverrideFn } from './mock-network/NetworkConfigurerCfg'
+export { NetworkCatalog } from './mock-network/NetworkCatalog'
+export type { NetworkInterceptor } from './mock-network/NetworkCatalog'
+export { SharedNetwork } from './mock-network/SharedNetwork'
+export { makeNetworkReplyWithCatalog } from './mock-network/makeNetworkReplyWithCatalog'
+export * from './mock-network/errorFactories'
+
+export { CatalogTools } from './tools/CatalogTools'
+export { AppDetailTools } from './tools/AppDetailTools'
+export { GalleryTools } from './tools/GalleryTools'
+export { getGlobalError } from './tools/ErrorTools'
+export type { GlobalError } from './tools/ErrorTools'
+export { browserState } from './tools/BrowserState'
+export { suppressConsole, suppressConsoleGlobal } from './tools/suppressConsole'

package/src/mock-backend/BrowserStateCfg.ts

@@ -0,0 +1,35 @@
+/**
+ * Data-carrier that collects browser state configuration.
+ * Does not execute anything — `given()` materializes it after backend is ready.
+ */
+export class BrowserStateCfg {
+  private _offlineData = false
+  private _onboardingDismissed = false
+  private _localStorage = new Map<string, string>()
+
+  /** Seed IndexedDB with current backend data (simulates returning user) */
+  withOfflineData(): void {
+    this._offlineData = true
+  }
+
+  /** Mark onboarding as dismissed */
+  dismissOnboarding(): void {
+    this._onboardingDismissed = true
+  }
+
+  /** Set an arbitrary localStorage item */
+  withLocalStorageItem(key: string, value: string): void {
+    this._localStorage.set(key, value)
+  }
+
+  // Read-only accessors for given() to materialize
+  get shouldSeedOfflineData(): boolean {
+    return this._offlineData
+  }
+  get shouldDismissOnboarding(): boolean {
+    return this._onboardingDismissed
+  }
+  get localStorageItems(): Map<string, string> {
+    return this._localStorage
+  }
+}