@jskit-ai/create-app 0.1.133 → 0.1.136

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/create-app",
-  "version": "0.1.133",
+  "version": "0.1.136",
   "description": "Scaffold JSKIT app shells.",
   "type": "module",
   "files": [
@@ -20,7 +20,7 @@
     "./client": "./src/client/index.js"
   },
   "dependencies": {
-    "@jskit-ai/jskit-cli": "0.2.136"
+    "@jskit-ai/jskit-cli": "0.2.139"
   },
   "engines": {
     "node": "^22.12.0 || ^24.0.0 || ^26.0.0"

package/src/server/index.js

@@ -16,7 +16,6 @@ const DEFAULT_INITIAL_BUNDLES = "none";
 const DEFAULT_PLAYWRIGHT_VERSION = "1.61.1";
 const INITIAL_BUNDLE_PRESETS = new Set(["none", "auth"]);
 const TENANCY_MODES = new Set(["none", "personal", "workspaces"]);
-const EXACT_SEMVER_PATTERN = /^\d+\.\d+\.\d+$/u;
 const ALLOWED_EXISTING_TARGET_ENTRIES = new Set([".git"]);
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
 const TEMPLATES_ROOT = path.join(PACKAGE_ROOT, "templates");
@@ -57,12 +56,12 @@ function normalizeTenancyMode(value, { showUsage = true } = {}) {
 
 function normalizePlaywrightVersion(value, { showUsage = true } = {}) {
   const normalized = String(value || "").trim();
-  if (EXACT_SEMVER_PATTERN.test(normalized)) {
+  if (normalized === DEFAULT_PLAYWRIGHT_VERSION) {
     return normalized;
   }
 
   throw createCliError(
-    `Invalid --playwright-version value "${value}". Expected an exact x.y.z version.`,
+    `Invalid --playwright-version value "${value}". JSKIT requires ${DEFAULT_PLAYWRIGHT_VERSION}.`,
     { showUsage }
   );
 }
@@ -262,7 +261,7 @@ function printUsage(stream = process.stderr) {
   stream.write("  --title <text>     App title used for template replacements\n");
   stream.write("  --target <path>    Target directory (default: ./<app-name>)\n");
   stream.write("  --initial-bundles <preset>  Optional initial setup preset: none | auth (default: none)\n");
-  stream.write(`  --playwright-version <x.y.z>  Exact Playwright test version (default: ${DEFAULT_PLAYWRIGHT_VERSION})\n`);
+  stream.write(`  --playwright-version <version>  Supported Playwright test version (${DEFAULT_PLAYWRIGHT_VERSION})\n`);
   stream.write("  --tenancy-mode <mode>  Optional config seed: none | personal | workspaces\n");
   stream.write("  --force            Allow writing into a non-empty target directory\n");
   stream.write("  --dry-run          Print planned writes without changing the filesystem\n");

package/templates/ai-seed/AGENTS.md

@@ -7,6 +7,5 @@ Keep this stage minimal:
 - Decide the app name and tenancy mode.
 - Promote the directory into a real scaffold with `npx @jskit-ai/create-app <app-name> --target . --force --tenancy-mode <mode>`.
 - Run `npm install`.
-- If local JSKIT checkout links are used, run `npm run devlinks` immediately afterward.
 
 After the real scaffold exists, follow the generated app `AGENTS.md` and JSKIT agent docs. Do not continue from this seed file as a workflow source of truth.

package/templates/base-shell/.jskit/lock.json

@@ -48,7 +48,13 @@
               "value": "0.x"
             }
           },
-          "devDependencies": {},
+          "devDependencies": {
+            "@playwright/test": {
+              "hadPrevious": true,
+              "previousValue": "__PLAYWRIGHT_VERSION__",
+              "value": "__PLAYWRIGHT_VERSION__"
+            }
+          },
           "scripts": {}
         },
         "text": {

package/templates/base-shell/package.json

@@ -12,7 +12,6 @@
     "server:all": "node ./bin/server.js",
     "server:home": "SERVER_SURFACE=home node ./bin/server.js",
     "start": "node ./bin/server.js",
-    "devlinks": "jskit app link-local-packages",
     "dev": "vite",
     "dev:all": "vite",
     "dev:home": "VITE_SURFACE=home vite",

package/templates/base-shell/playwright.config.mjs

@@ -0,0 +1,4 @@
+import { defineConfig } from "@playwright/test";
+import { createJskitPlaywrightConfig } from "@jskit-ai/jskit-cli/test/playwright";
+
+export default defineConfig(createJskitPlaywrightConfig());

package/templates/base-shell/tests/e2e/base-shell.spec.ts

@@ -1,57 +1,4 @@
 import { expect, test } from "@playwright/test";
+import { runGeneratedAppSmoke } from "@jskit-ai/jskit-cli/test/playwright";
 
-const BASE_URL = String(process.env.PLAYWRIGHT_BASE_URL || "http://127.0.0.1:5173").replace(/\/+$/u, "");
-const SMOKE_PATH = String(process.env.JSKIT_PLAYWRIGHT_SMOKE_PATH || "/home");
-
-const viewports = [
-  { name: "compact", width: 390, height: 844 },
-  { name: "medium", width: 768, height: 1024 },
-  { name: "expanded", width: 1280, height: 900 }
-];
-
-async function expectNoHorizontalOverflow(page) {
-  const metrics = await page.evaluate(() => ({
-    clientWidth: document.documentElement.clientWidth,
-    scrollWidth: document.documentElement.scrollWidth
-  }));
-
-  expect(metrics.scrollWidth).toBeLessThanOrEqual(metrics.clientWidth + 1);
-}
-
-async function expectGeneratedScreenContract(page) {
-  const screen = page.locator(".generated-ui-screen").first();
-
-  await expect(screen).toBeVisible();
-  await expect(screen).toHaveClass(/generated-ui-screen--app/u);
-  await expect(screen.locator("h1").first()).toBeVisible();
-}
-
-async function expectVisibleTapTargets(page) {
-  const targetHeights = 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 targetHeights) {
-    expect(height).toBeGreaterThanOrEqual(48);
-  }
-}
-
-test.describe("generated base app responsive smoke", () => {
-  for (const viewport of viewports) {
-    test(`${viewport.name} home route renders without horizontal overflow`, async ({ page }) => {
-      await page.setViewportSize({ width: viewport.width, height: viewport.height });
-      await page.goto(`${BASE_URL}${SMOKE_PATH}`);
-      await expect(page.locator("body")).toBeVisible();
-      await expect(page.getByText("Ready")).toBeVisible();
-      await expectGeneratedScreenContract(page);
-      await expectVisibleTapTargets(page);
-      await expectNoHorizontalOverflow(page);
-    });
-  }
-});
+runGeneratedAppSmoke({ test, expect, expectedText: "Ready" });

package/templates/base-shell/tests/server/minimalShell.validator.test.js

@@ -9,7 +9,6 @@ const __dirname = path.dirname(__filename);
 const APP_ROOT = path.resolve(__dirname, "../..");
 
 const EXPECTED_MANAGED_SCRIPTS = Object.freeze({
-  devlinks: "jskit app link-local-packages",
   verify: "jskit app verify && npm run --if-present verify:app",
   release: "jskit app release",
   "jskit:update": "jskit app update-packages"

package/templates/minimal-shell/package.json

@@ -12,7 +12,6 @@
     "server:all": "node ./bin/server.js",
     "server:home": "SERVER_SURFACE=home node ./bin/server.js",
     "start": "node ./bin/server.js",
-    "devlinks": "jskit app link-local-packages",
     "dev": "vite",
     "dev:all": "vite",
     "dev:home": "VITE_SURFACE=home vite",

package/templates/minimal-shell/playwright.config.mjs

@@ -0,0 +1,4 @@
+import { defineConfig } from "@playwright/test";
+import { createJskitPlaywrightConfig } from "@jskit-ai/jskit-cli/test/playwright";
+
+export default defineConfig(createJskitPlaywrightConfig());

package/templates/minimal-shell/tests/e2e/base-shell.spec.ts

@@ -1,57 +1,4 @@
 import { expect, test } from "@playwright/test";
+import { runGeneratedAppSmoke } from "@jskit-ai/jskit-cli/test/playwright";
 
-const BASE_URL = String(process.env.PLAYWRIGHT_BASE_URL || "http://127.0.0.1:5173").replace(/\/+$/u, "");
-const SMOKE_PATH = String(process.env.JSKIT_PLAYWRIGHT_SMOKE_PATH || "/home");
-
-const viewports = [
-  { name: "compact", width: 390, height: 844 },
-  { name: "medium", width: 768, height: 1024 },
-  { name: "expanded", width: 1280, height: 900 }
-];
-
-async function expectNoHorizontalOverflow(page) {
-  const metrics = await page.evaluate(() => ({
-    clientWidth: document.documentElement.clientWidth,
-    scrollWidth: document.documentElement.scrollWidth
-  }));
-
-  expect(metrics.scrollWidth).toBeLessThanOrEqual(metrics.clientWidth + 1);
-}
-
-async function expectGeneratedScreenContract(page) {
-  const screen = page.locator(".generated-ui-screen").first();
-
-  await expect(screen).toBeVisible();
-  await expect(screen).toHaveClass(/generated-ui-screen--app/u);
-  await expect(screen.locator("h1").first()).toBeVisible();
-}
-
-async function expectVisibleTapTargets(page) {
-  const targetHeights = 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 targetHeights) {
-    expect(height).toBeGreaterThanOrEqual(48);
-  }
-}
-
-test.describe("generated base app responsive smoke", () => {
-  for (const viewport of viewports) {
-    test(`${viewport.name} home route renders without horizontal overflow`, async ({ page }) => {
-      await page.setViewportSize({ width: viewport.width, height: viewport.height });
-      await page.goto(`${BASE_URL}${SMOKE_PATH}`);
-      await expect(page.locator("body")).toBeVisible();
-      await expect(page.getByText("Home base")).toBeVisible();
-      await expectGeneratedScreenContract(page);
-      await expectVisibleTapTargets(page);
-      await expectNoHorizontalOverflow(page);
-    });
-  }
-});
+runGeneratedAppSmoke({ test, expect, expectedText: "Home base" });

package/templates/minimal-shell/tests/server/minimalShell.validator.test.js

@@ -9,7 +9,6 @@ const __dirname = path.dirname(__filename);
 const APP_ROOT = path.resolve(__dirname, "../..");
 
 const EXPECTED_MANAGED_SCRIPTS = Object.freeze({
-  devlinks: "jskit app link-local-packages",
   verify: "jskit app verify && npm run --if-present verify:app",
   release: "jskit app release",
   "jskit:update": "jskit app update-packages"