@jskit-ai/jskit-cli 0.2.136 → 0.2.137

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/jskit-cli",
-  "version": "0.2.136",
+  "version": "0.2.137",
   "description": "Bundle and package orchestration CLI for JSKIT apps.",
   "type": "module",
   "files": [
@@ -14,15 +14,16 @@
   "exports": {
     ".": "./src/index.js",
     "./server": "./src/server/index.js",
-    "./client": "./src/client/index.js"
+    "./client": "./src/client/index.js",
+    "./test/playwright": "./src/test/playwright.js"
   },
   "scripts": {
     "test": "node --test"
   },
   "dependencies": {
-    "@jskit-ai/jskit-catalog": "0.1.131",
+    "@jskit-ai/jskit-catalog": "0.1.132",
     "@jskit-ai/kernel": "0.1.121",
-    "@jskit-ai/shell-web": "0.1.120",
+    "@jskit-ai/shell-web": "0.1.121",
     "@vue/compiler-sfc": "^3.5.29",
     "ts-morph": "^28.0.0",
     "yaml": "^2.8.3"

package/src/test/playwright.js

@@ -0,0 +1,95 @@
+const DEFAULT_LOCAL_BASE_URL = "http://127.0.0.1:4173";
+const DEFAULT_SMOKE_PATH = "/home";
+const DEFAULT_VIEWPORTS = Object.freeze([
+  Object.freeze({ name: "compact", width: 390, height: 844 }),
+  Object.freeze({ name: "medium", width: 768, height: 1024 }),
+  Object.freeze({ name: "expanded", width: 1280, height: 900 })
+]);
+
+function normalizeBaseUrl(value) {
+  return String(value || "").trim().replace(/\/+$/u, "");
+}
+
+function createJskitPlaywrightConfig({ env = process.env } = {}) {
+  const managedBaseUrl = normalizeBaseUrl(env.PLAYWRIGHT_BASE_URL);
+  const baseURL = managedBaseUrl || DEFAULT_LOCAL_BASE_URL;
+  const storageState = String(env.JSKIT_PLAYWRIGHT_STORAGE_STATE || "").trim();
+
+  return {
+    testDir: "./tests/e2e",
+    timeout: 60_000,
+    expect: {
+      timeout: 10_000
+    },
+    use: {
+      baseURL,
+      headless: true,
+      ...(storageState ? { storageState } : {})
+    },
+    ...(managedBaseUrl ? {} : {
+      webServer: {
+        command: "npm run build && node ./bin/server.js",
+        env: {
+          PORT: "4173"
+        },
+        url: `${baseURL}/api/health`,
+        reuseExistingServer: true,
+        timeout: 180_000
+      }
+    })
+  };
+}
+
+async function expectNoHorizontalOverflow(page, expect) {
+  const metrics = await page.evaluate(() => ({
+    clientWidth: document.documentElement.clientWidth,
+    scrollWidth: document.documentElement.scrollWidth
+  }));
+
+  expect(metrics.scrollWidth).toBeLessThanOrEqual(metrics.clientWidth + 1);
+}
+
+async function expectVisibleTapTargets(page, expect) {
+  const heights = await page.locator("a[href], button, [role='button'], .v-btn, .v-list-item").evaluateAll(
+    (elements) => elements
+      .filter((element) => {
+        const rect = element.getBoundingClientRect();
+        const style = window.getComputedStyle(element);
+        return style.display !== "none" && style.visibility !== "hidden" && rect.width > 0 && rect.height > 0;
+      })
+      .map((element) => element.getBoundingClientRect().height)
+  );
+
+  for (const height of heights) {
+    expect(height).toBeGreaterThanOrEqual(48);
+  }
+}
+
+function runGeneratedAppSmoke({ test, expect, expectedText } = {}) {
+  if (!test || !expect || !String(expectedText || "").trim()) {
+    throw new Error("runGeneratedAppSmoke requires Playwright test, expect, and expectedText.");
+  }
+
+  const smokePath = String(process.env.JSKIT_PLAYWRIGHT_SMOKE_PATH || DEFAULT_SMOKE_PATH);
+
+  test.describe("generated app responsive smoke", () => {
+    for (const viewport of DEFAULT_VIEWPORTS) {
+      test(`${viewport.name} home route renders without horizontal overflow`, async ({ page }) => {
+        await page.setViewportSize({ width: viewport.width, height: viewport.height });
+        await page.goto(smokePath);
+        await expect(page.locator("body")).toBeVisible();
+        await expect(page.getByText(expectedText)).toBeVisible();
+        await expect(page.locator(".generated-ui-screen").first()).toBeVisible();
+        await expectVisibleTapTargets(page, expect);
+        await expectNoHorizontalOverflow(page, expect);
+      });
+    }
+  });
+}
+
+export {
+  createJskitPlaywrightConfig,
+  DEFAULT_LOCAL_BASE_URL,
+  DEFAULT_VIEWPORTS,
+  runGeneratedAppSmoke
+};