@igstack/app-catalog-test-kit 0.18.6

package/dist/esm/setup/testSetup.js

@@ -0,0 +1,58 @@
+import "fake-indexeddb/auto";
+import "./polyfillLocalStorage.js";
+import { vi, afterEach } from "vitest";
+import { cleanup } from "@testing-library/react";
+import { cleanupTestResources } from "../harness/given.js";
+import React from "react";
+vi.mock("~/assets/app-catalog.svg?react", () => ({
+  default: (props) => React.createElement("svg", { "data-testid": "svg-mock", ...props })
+}));
+Element.prototype.scrollIntoView = vi.fn();
+afterEach(async () => {
+  cleanup();
+  await cleanupTestResources();
+  localStorage.clear();
+  sessionStorage.clear();
+});
+Object.defineProperty(window, "matchMedia", {
+  writable: true,
+  value: (query) => ({
+    matches: false,
+    media: query,
+    onchange: null,
+    addListener: () => {
+    },
+    removeListener: () => {
+    },
+    addEventListener: () => {
+    },
+    removeEventListener: () => {
+    },
+    dispatchEvent: () => false
+  })
+});
+globalThis.IntersectionObserver = class IntersectionObserver {
+  constructor() {
+    this.root = null;
+    this.rootMargin = "";
+    this.thresholds = [];
+  }
+  observe() {
+  }
+  unobserve() {
+  }
+  disconnect() {
+  }
+  takeRecords() {
+    return [];
+  }
+};
+globalThis.ResizeObserver = class ResizeObserver {
+  observe() {
+  }
+  unobserve() {
+  }
+  disconnect() {
+  }
+};
+//# sourceMappingURL=testSetup.js.map

package/dist/esm/setup/testSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testSetup.js","sources":["../../../src/setup/testSetup.ts"],"sourcesContent":["import 'fake-indexeddb/auto'\nimport './polyfillLocalStorage'\nimport { afterEach, vi } from 'vitest'\nimport { cleanup } from '@testing-library/react'\nimport { cleanupTestResources } from '../harness/given'\nimport React from 'react'\n\n// Mock SVG React component imports (vite-plugin-svgr ?react suffix)\nvi.mock('~/assets/app-catalog.svg?react', () => ({\n  default: (props: React.SVGProps<SVGSVGElement>) =>\n    React.createElement('svg', { 'data-testid': 'svg-mock', ...props }),\n}))\n\n// Mock scrollIntoView — not implemented in jsdom\nElement.prototype.scrollIntoView = vi.fn()\n\n// Clean up after each test\nafterEach(async () => {\n  cleanup()\n  await cleanupTestResources()\n  localStorage.clear()\n  sessionStorage.clear()\n})\n\n// Mock window.matchMedia — required by embla-carousel in jsdom environment\nObject.defineProperty(window, 'matchMedia', {\n  writable: true,\n  value: (query: string) => ({\n    matches: false,\n    media: query,\n    onchange: null,\n    addListener: () => {},\n    removeListener: () => {},\n    addEventListener: () => {},\n    removeEventListener: () => {},\n    dispatchEvent: () => false,\n  }),\n})\n\n// Mock IntersectionObserver — required by embla-carousel SlidesInView in jsdom\nglobalThis.IntersectionObserver = class IntersectionObserver {\n  observe() {}\n  unobserve() {}\n  disconnect() {}\n  takeRecords() {\n    return []\n  }\n  readonly root = null\n  readonly rootMargin = ''\n  readonly thresholds = []\n} as unknown as typeof IntersectionObserver\n\n// Mock ResizeObserver — required by embla-carousel ResizeHandler in jsdom\nglobalThis.ResizeObserver = class ResizeObserver {\n  observe() {}\n  unobserve() {}\n  disconnect() {}\n} as unknown as typeof ResizeObserver\n"],"names":[],"mappings":";;;;;;AAQA,GAAG,KAAK,kCAAkC,OAAO;AAAA,EAC/C,SAAS,CAAC,UACR,MAAM,cAAc,OAAO,EAAE,eAAe,YAAY,GAAG,MAAA,CAAO;AACtE,EAAE;AAGF,QAAQ,UAAU,iBAAiB,GAAG,GAAA;AAGtC,UAAU,YAAY;AACpB,UAAA;AACA,QAAM,qBAAA;AACN,eAAa,MAAA;AACb,iBAAe,MAAA;AACjB,CAAC;AAGD,OAAO,eAAe,QAAQ,cAAc;AAAA,EAC1C,UAAU;AAAA,EACV,OAAO,CAAC,WAAmB;AAAA,IACzB,SAAS;AAAA,IACT,OAAO;AAAA,IACP,UAAU;AAAA,IACV,aAAa,MAAM;AAAA,IAAC;AAAA,IACpB,gBAAgB,MAAM;AAAA,IAAC;AAAA,IACvB,kBAAkB,MAAM;AAAA,IAAC;AAAA,IACzB,qBAAqB,MAAM;AAAA,IAAC;AAAA,IAC5B,eAAe,MAAM;AAAA,EAAA;AAEzB,CAAC;AAGD,WAAW,uBAAuB,MAAM,qBAAqB;AAAA,EAA3B,cAAA;AAOhC,SAAS,OAAO;AAChB,SAAS,aAAa;AACtB,SAAS,aAAa,CAAA;AAAA,EAAC;AAAA,EARvB,UAAU;AAAA,EAAC;AAAA,EACX,YAAY;AAAA,EAAC;AAAA,EACb,aAAa;AAAA,EAAC;AAAA,EACd,cAAc;AACZ,WAAO,CAAA;AAAA,EACT;AAIF;AAGA,WAAW,iBAAiB,MAAM,eAAe;AAAA,EAC/C,UAAU;AAAA,EAAC;AAAA,EACX,YAAY;AAAA,EAAC;AAAA,EACb,aAAa;AAAA,EAAC;AAChB;"}

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

@@ -0,0 +1,63 @@
+export interface AppVisibleData {
+    title: string;
+    description: string | null;
+    url: string | null;
+    tags: string[];
+    screenshots: {
+        count: number;
+    };
+    deprecation: {
+        type: string;
+        comment: string;
+    } | null;
+}
+export declare class AppDetailTools {
+    private user;
+    /**
+     * Scrape all visible data from the app detail panel into a structured object.
+     */
+    getVisibleData(): AppVisibleData;
+    /**
+     * Get the sub-resources section data from the detail panel.
+     * Returns null if no sub-resources section is visible.
+     */
+    getSubResources(): {
+        total: number;
+        visible: number;
+        names: string[];
+    } | null;
+    /**
+     * Read the "How to get access" section text from the detail panel.
+     * Returns null if the section is not present.
+     */
+    getAccessText(): string | null;
+    screenshots: {
+        /**
+         * Click the screenshot preview to open the gallery modal.
+         */
+        open: () => Promise<void>;
+    };
+    /** Click the "View replacement: <App>" link in a deprecated app's panel. */
+    clickViewReplacement(): Promise<void>;
+    /** The title shown in the currently open detail panel (empty if none). */
+    getOpenTitle(): string;
+    /**
+     * The prominent primary "Open" button in the app detail card.
+     * Returns the anchor element when the app has an appUrl, null otherwise.
+     */
+    getOpenButton(): HTMLAnchorElement | null;
+    /**
+     * Get sub-resource detail panel data when a sub-resource is selected.
+     * Returns null if the sub-resource detail panel is not shown.
+     */
+    getSubResourceDetail(): {
+        subResourceName: string;
+        hasStep1: boolean;
+        hasStep2: boolean;
+        backButtonLabel: string | null;
+    } | null;
+    clickBackToParent(): Promise<void>;
+    private getPanel;
+    private findHeading;
+    private getNextSiblingText;
+}

package/dist/esm/tools/AppDetailTools.js

@@ -0,0 +1,180 @@
+import { screen } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+class AppDetailTools {
+  constructor() {
+    this.user = userEvent.setup();
+    this.screenshots = {
+      /**
+       * Click the screenshot preview to open the gallery modal.
+       */
+      open: async () => {
+        const panel = this.getPanel();
+        const screenshotArea = panel.querySelector(".cursor-pointer");
+        if (!screenshotArea) {
+          throw new Error("No clickable screenshot found in detail panel");
+        }
+        await this.user.click(screenshotArea);
+      }
+    };
+  }
+  /**
+   * Scrape all visible data from the app detail panel into a structured object.
+   */
+  getVisibleData() {
+    const panel = this.getPanel();
+    const titleEl = panel.querySelector(".text-2xl");
+    const title = (titleEl == null ? void 0 : titleEl.textContent.trim()) ?? "";
+    const descHeading = this.findHeading(panel, "Description");
+    const description = descHeading ? this.getNextSiblingText(descHeading) : null;
+    const urlLink = panel.querySelector('a[href][target="_blank"]');
+    const url = (urlLink == null ? void 0 : urlLink.getAttribute("href")) ?? null;
+    const tagsHeading = this.findHeading(panel, "Tags");
+    const tags = [];
+    if (tagsHeading) {
+      const container = tagsHeading.nextElementSibling;
+      if (container) {
+        container.querySelectorAll('[class*="badge"], [data-slot="badge"]').forEach((badge) => {
+          const text = badge.textContent.trim();
+          if (text) tags.push(text);
+        });
+      }
+    }
+    const screenshotHeading = this.findHeading(panel, "Screenshots");
+    let screenshotCount = 0;
+    if (screenshotHeading) {
+      const match = screenshotHeading.textContent.match(/\((\d+)\)/);
+      screenshotCount = (match == null ? void 0 : match[1]) ? parseInt(match[1], 10) : 0;
+    }
+    let deprecation = null;
+    const deprecationEl = panel.querySelector(
+      '[class*="border-destructive"], [class*="border-yellow"]'
+    );
+    if (deprecationEl) {
+      const typeEl = deprecationEl.querySelector("h3");
+      const commentEl = deprecationEl.querySelector("p");
+      deprecation = {
+        type: (typeEl == null ? void 0 : typeEl.textContent.toLowerCase().includes("discouraged")) ? "discouraged" : "deprecated",
+        comment: (commentEl == null ? void 0 : commentEl.textContent.trim()) ?? ""
+      };
+    }
+    return {
+      title,
+      description,
+      url,
+      tags,
+      screenshots: { count: screenshotCount },
+      deprecation
+    };
+  }
+  /**
+   * Get the sub-resources section data from the detail panel.
+   * Returns null if no sub-resources section is visible.
+   */
+  getSubResources() {
+    const panel = this.getPanel();
+    const heading = Array.from(panel.querySelectorAll("div")).find(
+      (el) => el.textContent.match(/Sub-Resources \(\d+ of \d+\)/)
+    );
+    if (!heading) return null;
+    const match = heading.textContent.match(/Sub-Resources \((\d+) of (\d+)\)/);
+    const visible = (match == null ? void 0 : match[1]) ? parseInt(match[1], 10) : 0;
+    const total = (match == null ? void 0 : match[2]) ? parseInt(match[2], 10) : 0;
+    const names = [];
+    const rows = panel.querySelectorAll("table tbody tr");
+    rows.forEach((row) => {
+      const nameCell = row.querySelector("td .font-medium");
+      if (nameCell == null ? void 0 : nameCell.textContent) {
+        names.push(nameCell.textContent.trim());
+      }
+    });
+    return { total, visible, names };
+  }
+  /**
+   * Read the "How to get access" section text from the detail panel.
+   * Returns null if the section is not present.
+   */
+  getAccessText() {
+    const panel = this.getPanel();
+    const heading = this.findHeading(panel, "How to get access");
+    if (!heading) return null;
+    const container = heading.parentElement ?? heading;
+    return container.textContent.trim();
+  }
+  /** Click the "View replacement: <App>" link in a deprecated app's panel. */
+  async clickViewReplacement() {
+    const btn = screen.getByRole("button", { name: /View replacement:/i });
+    await this.user.click(btn);
+  }
+  /** The title shown in the currently open detail panel (empty if none). */
+  getOpenTitle() {
+    var _a;
+    const panel = this.getPanel();
+    return ((_a = panel.querySelector(".text-2xl")) == null ? void 0 : _a.textContent.trim()) ?? "";
+  }
+  /**
+   * The prominent primary "Open" button in the app detail card.
+   * Returns the anchor element when the app has an appUrl, null otherwise.
+   */
+  getOpenButton() {
+    const panel = this.getPanel();
+    return panel.querySelector('[aria-label^="Open "]') ?? null;
+  }
+  /**
+   * Get sub-resource detail panel data when a sub-resource is selected.
+   * Returns null if the sub-resource detail panel is not shown.
+   */
+  getSubResourceDetail() {
+    const panel = document.querySelector(
+      '[aria-label^="Back to "]'
+    );
+    if (!panel) return null;
+    const backButtonEl = document.querySelector(
+      '[aria-label^="Back to "]'
+    );
+    const backButtonLabel = (backButtonEl == null ? void 0 : backButtonEl.getAttribute("aria-label")) ?? null;
+    const h2 = document.querySelector("h2.text-xl");
+    const subResourceName = ((h2 == null ? void 0 : h2.textContent) ?? "").trim();
+    const stepBadges = Array.from(
+      document.querySelectorAll("span.rounded-full")
+    );
+    const getText = (el) => (el.textContent ?? "").trim();
+    const hasStep1 = stepBadges.some((el) => getText(el) === "1");
+    const hasStep2 = stepBadges.some((el) => getText(el) === "2");
+    return { subResourceName, hasStep1, hasStep2, backButtonLabel };
+  }
+  async clickBackToParent() {
+    const backButton = document.querySelector(
+      '[aria-label^="Back to "]'
+    );
+    if (!backButton) {
+      throw new Error("Back-to-parent button not found in detail panel");
+    }
+    await this.user.click(backButton);
+  }
+  getPanel() {
+    const closeButton = screen.queryByLabelText("Close details panel");
+    if (!closeButton) {
+      throw new Error("App detail panel is not open");
+    }
+    const panel = closeButton.closest('[class*="overflow-y-auto"]');
+    if (!panel) {
+      throw new Error("Could not find detail panel container");
+    }
+    return panel;
+  }
+  findHeading(container, text) {
+    const headings = container.querySelectorAll("h3");
+    for (const h of headings) {
+      if (h.textContent.includes(text)) return h;
+    }
+    return null;
+  }
+  getNextSiblingText(heading) {
+    const sibling = heading.nextElementSibling;
+    return (sibling == null ? void 0 : sibling.textContent.trim()) ?? null;
+  }
+}
+export {
+  AppDetailTools
+};
+//# sourceMappingURL=AppDetailTools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppDetailTools.js","sources":["../../../src/tools/AppDetailTools.ts"],"sourcesContent":["import { screen } from '@testing-library/react'\nimport userEvent from '@testing-library/user-event'\n\nexport interface AppVisibleData {\n  title: string\n  description: string | null\n  url: string | null\n  tags: string[]\n  screenshots: { count: number }\n  deprecation: { type: string; comment: string } | null\n}\n\nexport class AppDetailTools {\n  private user = userEvent.setup()\n\n  /**\n   * Scrape all visible data from the app detail panel into a structured object.\n   */\n  getVisibleData(): AppVisibleData {\n    const panel = this.getPanel()\n\n    // Title: the large text in the header area\n    const titleEl = panel.querySelector('.text-2xl')\n    const title = titleEl?.textContent.trim() ?? ''\n\n    // Description\n    const descHeading = this.findHeading(panel, 'Description')\n    const description = descHeading\n      ? this.getNextSiblingText(descHeading)\n      : null\n\n    // URL\n    const urlLink = panel.querySelector('a[href][target=\"_blank\"]')\n    const url = urlLink?.getAttribute('href') ?? null\n\n    // Tags\n    const tagsHeading = this.findHeading(panel, 'Tags')\n    const tags: string[] = []\n    if (tagsHeading) {\n      const container = tagsHeading.nextElementSibling\n      if (container) {\n        container\n          .querySelectorAll('[class*=\"badge\"], [data-slot=\"badge\"]')\n          .forEach((badge) => {\n            const text = badge.textContent.trim()\n            if (text) tags.push(text)\n          })\n      }\n    }\n\n    // Screenshots\n    const screenshotHeading = this.findHeading(panel, 'Screenshots')\n    let screenshotCount = 0\n    if (screenshotHeading) {\n      const match = screenshotHeading.textContent.match(/\\((\\d+)\\)/)\n      screenshotCount = match?.[1] ? parseInt(match[1], 10) : 0\n    }\n\n    // Deprecation\n    let deprecation: AppVisibleData['deprecation'] = null\n    const deprecationEl = panel.querySelector(\n      '[class*=\"border-destructive\"], [class*=\"border-yellow\"]',\n    )\n    if (deprecationEl) {\n      const typeEl = deprecationEl.querySelector('h3')\n      const commentEl = deprecationEl.querySelector('p')\n      deprecation = {\n        type: typeEl?.textContent.toLowerCase().includes('discouraged')\n          ? 'discouraged'\n          : 'deprecated',\n        comment: commentEl?.textContent.trim() ?? '',\n      }\n    }\n\n    return {\n      title,\n      description,\n      url,\n      tags,\n      screenshots: { count: screenshotCount },\n      deprecation,\n    }\n  }\n\n  /**\n   * Get the sub-resources section data from the detail panel.\n   * Returns null if no sub-resources section is visible.\n   */\n  getSubResources(): {\n    total: number\n    visible: number\n    names: string[]\n  } | null {\n    const panel = this.getPanel()\n    const heading = Array.from(panel.querySelectorAll('div')).find((el) =>\n      el.textContent.match(/Sub-Resources \\(\\d+ of \\d+\\)/),\n    )\n    if (!heading) return null\n\n    const match = heading.textContent.match(/Sub-Resources \\((\\d+) of (\\d+)\\)/)\n    const visible = match?.[1] ? parseInt(match[1], 10) : 0\n    const total = match?.[2] ? parseInt(match[2], 10) : 0\n\n    const names: string[] = []\n    const rows = panel.querySelectorAll('table tbody tr')\n    rows.forEach((row) => {\n      const nameCell = row.querySelector('td .font-medium')\n      if (nameCell?.textContent) {\n        names.push(nameCell.textContent.trim())\n      }\n    })\n\n    return { total, visible, names }\n  }\n\n  /**\n   * Read the \"How to get access\" section text from the detail panel.\n   * Returns null if the section is not present.\n   */\n  getAccessText(): string | null {\n    const panel = this.getPanel()\n    const heading = this.findHeading(panel, 'How to get access')\n    if (!heading) return null\n    // The section is the heading plus its following content wrapper.\n    const container = heading.parentElement ?? heading\n    return container.textContent.trim()\n  }\n\n  screenshots = {\n    /**\n     * Click the screenshot preview to open the gallery modal.\n     */\n    open: async (): Promise<void> => {\n      const panel = this.getPanel()\n      const screenshotArea = panel.querySelector('.cursor-pointer')\n      if (!screenshotArea) {\n        throw new Error('No clickable screenshot found in detail panel')\n      }\n      await this.user.click(screenshotArea)\n    },\n  }\n\n  /** Click the \"View replacement: <App>\" link in a deprecated app's panel. */\n  async clickViewReplacement(): Promise<void> {\n    const btn = screen.getByRole('button', { name: /View replacement:/i })\n    await this.user.click(btn)\n  }\n\n  /** The title shown in the currently open detail panel (empty if none). */\n  getOpenTitle(): string {\n    const panel = this.getPanel()\n    return panel.querySelector('.text-2xl')?.textContent.trim() ?? ''\n  }\n\n  /**\n   * The prominent primary \"Open\" button in the app detail card.\n   * Returns the anchor element when the app has an appUrl, null otherwise.\n   */\n  getOpenButton(): HTMLAnchorElement | null {\n    const panel = this.getPanel()\n    return (\n      panel.querySelector<HTMLAnchorElement>('[aria-label^=\"Open \"]') ?? null\n    )\n  }\n\n  /**\n   * Get sub-resource detail panel data when a sub-resource is selected.\n   * Returns null if the sub-resource detail panel is not shown.\n   */\n  getSubResourceDetail(): {\n    subResourceName: string\n    hasStep1: boolean\n    hasStep2: boolean\n    backButtonLabel: string | null\n  } | null {\n    const panel = document.querySelector<HTMLElement>(\n      '[aria-label^=\"Back to \"]',\n    )\n    if (!panel) return null\n\n    const backButtonEl = document.querySelector<HTMLElement>(\n      '[aria-label^=\"Back to \"]',\n    )\n    const backButtonLabel = backButtonEl?.getAttribute('aria-label') ?? null\n\n    // Sub-resource name: h2 in the detail panel area\n    const h2 = document.querySelector('h2.text-xl')\n    const subResourceName = (h2?.textContent ?? '').trim()\n\n    // Step badges: circles with \"1\" and \"2\" text\n    const stepBadges = Array.from(\n      document.querySelectorAll<HTMLElement>('span.rounded-full'),\n    )\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    const getText = (el: HTMLElement) => (el.textContent ?? '').trim()\n    const hasStep1 = stepBadges.some((el) => getText(el) === '1')\n    const hasStep2 = stepBadges.some((el) => getText(el) === '2')\n\n    return { subResourceName, hasStep1, hasStep2, backButtonLabel }\n  }\n\n  async clickBackToParent(): Promise<void> {\n    const backButton = document.querySelector<HTMLButtonElement>(\n      '[aria-label^=\"Back to \"]',\n    )\n    if (!backButton) {\n      throw new Error('Back-to-parent button not found in detail panel')\n    }\n    await this.user.click(backButton)\n  }\n\n  private getPanel(): HTMLElement {\n    const closeButton = screen.queryByLabelText('Close details panel')\n    if (!closeButton) {\n      throw new Error('App detail panel is not open')\n    }\n    // The panel is the closest scrollable container\n    const panel = closeButton.closest('[class*=\"overflow-y-auto\"]')\n    if (!panel) {\n      throw new Error('Could not find detail panel container')\n    }\n    return panel as HTMLElement\n  }\n\n  private findHeading(\n    container: HTMLElement,\n    text: string,\n  ): HTMLElement | null {\n    const headings = container.querySelectorAll('h3')\n    for (const h of headings) {\n      if (h.textContent.includes(text)) return h as HTMLElement\n    }\n    return null\n  }\n\n  private getNextSiblingText(heading: HTMLElement): string | null {\n    const sibling = heading.nextElementSibling\n    return sibling?.textContent.trim() ?? null\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,25 @@
+import { AppCatalogData } from '@igstack/app-catalog-backend-core';
+/**
+ * Pre-populate the browser's local state to simulate a returning user.
+ * Call before `given()` to set up IndexedDB cache and localStorage flags.
+ *
+ * Usage:
+ *   await browserState.seedCatalogCache(data)
+ *   browserState.dismissOnboarding()
+ */
+export declare const browserState: {
+    /**
+     * Seed the IndexedDB cache with app catalog data,
+     * as if the user has previously loaded the app.
+     */
+    seedCatalogCache(data: AppCatalogData): Promise<void>;
+    /**
+     * Mark the onboarding card as dismissed in localStorage,
+     * as if the user has already seen and closed it.
+     */
+    dismissOnboarding(): void;
+    /**
+     * Simulate a returning user: onboarding dismissed + catalog data cached.
+     */
+    returningUser(data: AppCatalogData): Promise<void>;
+};

package/dist/esm/tools/BrowserState.js

@@ -0,0 +1,30 @@
+import { AcDb, dbCacheDbKeys } from "@igstack/app-catalog-frontend-core/internal";
+const browserState = {
+  /**
+   * Seed the IndexedDB cache with app catalog data,
+   * as if the user has previously loaded the app.
+   */
+  async seedCatalogCache(data) {
+    const db = new AcDb();
+    await db.appCatalog.put(data, dbCacheDbKeys.AppCatalog);
+    db.close();
+  },
+  /**
+   * Mark the onboarding card as dismissed in localStorage,
+   * as if the user has already seen and closed it.
+   */
+  dismissOnboarding() {
+    localStorage.setItem("app-catalog-onboarding-dismissed", "true");
+  },
+  /**
+   * Simulate a returning user: onboarding dismissed + catalog data cached.
+   */
+  async returningUser(data) {
+    this.dismissOnboarding();
+    await this.seedCatalogCache(data);
+  }
+};
+export {
+  browserState
+};
+//# sourceMappingURL=BrowserState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserState.js","sources":["../../../src/tools/BrowserState.ts"],"sourcesContent":["import type { AppCatalogData } from '@igstack/app-catalog-backend-core'\nimport {\n  AcDb,\n  dbCacheDbKeys,\n} from '@igstack/app-catalog-frontend-core/internal'\n\n/**\n * Pre-populate the browser's local state to simulate a returning user.\n * Call before `given()` to set up IndexedDB cache and localStorage flags.\n *\n * Usage:\n *   await browserState.seedCatalogCache(data)\n *   browserState.dismissOnboarding()\n */\nexport const browserState = {\n  /**\n   * Seed the IndexedDB cache with app catalog data,\n   * as if the user has previously loaded the app.\n   */\n  async seedCatalogCache(data: AppCatalogData): Promise<void> {\n    const db = new AcDb()\n    await db.appCatalog.put(data, dbCacheDbKeys.AppCatalog)\n    db.close()\n  },\n\n  /**\n   * Mark the onboarding card as dismissed in localStorage,\n   * as if the user has already seen and closed it.\n   */\n  dismissOnboarding(): void {\n    localStorage.setItem('app-catalog-onboarding-dismissed', 'true')\n  },\n\n  /**\n   * Simulate a returning user: onboarding dismissed + catalog data cached.\n   */\n  async returningUser(data: AppCatalogData): Promise<void> {\n    this.dismissOnboarding()\n    await this.seedCatalogCache(data)\n  },\n}\n"],"names":[],"mappings":";AAcO,MAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA,EAK1B,MAAM,iBAAiB,MAAqC;AAC1D,UAAM,KAAK,IAAI,KAAA;AACf,UAAM,GAAG,WAAW,IAAI,MAAM,cAAc,UAAU;AACtD,OAAG,MAAA;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,oBAA0B;AACxB,iBAAa,QAAQ,oCAAoC,MAAM;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAc,MAAqC;AACvD,SAAK,kBAAA;AACL,UAAM,KAAK,iBAAiB,IAAI;AAAA,EAClC;AACF;"}

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

@@ -0,0 +1,67 @@
+export interface TableRow {
+    name: string;
+    description: string;
+}
+export declare class CatalogTools {
+    private user;
+    /**
+     * Click an app row by display name.
+     * Works against both the table/grid view and the launcher home (#38), which
+     * renders app rows as buttons rather than a <table>.
+     * Throws with list of visible apps if name not found.
+     */
+    openApp(name: string): Promise<void>;
+    /**
+     * Type into the search input.
+     */
+    search(text: string): Promise<void>;
+    /** The catalog search input. */
+    getSearchInput(): HTMLInputElement;
+    /**
+     * Parse the catalog table into structured data.
+     * Skips group header rows (colspan rows).
+     */
+    getTableData(): TableRow[];
+    /**
+     * The secondary "open in new tab" launch link for a row, by app name.
+     * Returns null if the row has no launch link.
+     */
+    getLaunchLink(name: string): HTMLAnchorElement | null;
+    /**
+     * Whether the right detail panel is currently visible.
+     */
+    isDetailPanelOpen(): boolean;
+    /** Whether the "Show Deprecated Apps" toggle is currently checked. */
+    isShowDeprecatedChecked(): boolean;
+    /** Whether the "showing deprecated matches" fallback notice is visible. */
+    hasDeprecatedFallbackNotice(): boolean;
+    /** Whether the "No apps found" empty state or search-morph "No results for" is visible. */
+    isEmptyStateVisible(): boolean;
+    /**
+     * Whether the onboarding/welcome card is visible.
+     */
+    isOnboardingVisible(): boolean;
+    /**
+     * Read app rows from the launcher home (#38): buttons titled "View <name>".
+     * Name is the first `.font-semibold`/`.font-bold` span; description the
+     * `.text-muted-foreground` span. Deduped by name (an app can appear both in
+     * "Your apps" and "Browse all").
+     */
+    private getLauncherRows;
+    /**
+     * Get expandable subresource rows shown under parents in search results.
+     * Returns null if no sub-rows are visible.
+     */
+    getSubResourceRows(): {
+        visible: number;
+        total: number;
+        hasExpandRow: boolean;
+        names: string[];
+    } | null;
+    clickSubResource(displayName: string): Promise<void>;
+    expandSubResources(): Promise<void>;
+    /**
+     * Get the main catalog table (first table on page, skipping sub-resource tables in detail panel).
+     */
+    private getCatalogTable;
+}

package/dist/esm/tools/CatalogTools.js

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