@simplysm/sd-cli 13.0.98 → 13.0.99

package/README.md

@@ -1,6 +1,6 @@
 # @simplysm/sd-cli
 
-CLI tool -- monorepo build, dev server, publish, and code quality tooling for Simplysm projects.
+Simplysm package - CLI tool. Provides monorepo build, dev server, publish, and code quality tooling for Simplysm projects. Also exports configuration types and a Vite config factory for client packages.
 
 ## Installation
 
@@ -10,128 +10,258 @@ npm install @simplysm/sd-cli
 
 ## API Overview
 
-### Configuration Types
+### Config Types
 
 | API | Type | Description |
 |-----|------|-------------|
-| `BuildTarget` | type | Build target: `"node"`, `"browser"`, `"neutral"` |
-| `SdNpmPublishConfig` | interface | npm registry publish configuration |
-| `SdPublishConfig` | type | Union of all publish configs (npm, local-directory, storage) |
-| `SdLocalDirectoryPublishConfig` | interface | Copy to local directory publish configuration |
-| `SdStoragePublishConfig` | interface | FTP/FTPS/SFTP publish configuration |
-| `SdPostPublishScriptConfig` | interface | Post-publish script configuration |
+| `SdConfig` | interface | Top-level `sd.config.ts` configuration |
+| `SdConfigFn` | type | Function signature for `sd.config.ts` default export |
+| `SdConfigParams` | interface | Parameters passed to `SdConfigFn` |
+| `SdPackageConfig` | type | Union of all package config types |
 | `SdBuildPackageConfig` | interface | Package config for node/browser/neutral targets |
-| `SdCapacitorSignConfig` | interface | Capacitor Android APK/AAB signing configuration |
-| `SdCapacitorPermission` | interface | Capacitor Android permission configuration |
-| `SdCapacitorIntentFilter` | interface | Capacitor Android Intent Filter configuration |
-| `SdCapacitorAndroidConfig` | interface | Capacitor Android platform configuration |
-| `SdCapacitorConfig` | interface | Capacitor configuration (appId, plugins, icon, platform) |
-| `SdElectronConfig` | interface | Electron configuration (appId, portable, installer) |
-| `SdClientPackageConfig` | interface | Client package configuration (Vite dev server) |
-| `SdServerPackageConfig` | interface | Server package configuration (Fastify server) |
-| `SdWatchHookConfig` | interface | Watch hook configuration for scripts packages |
-| `SdScriptsPackageConfig` | interface | Scripts-only package configuration |
-| `SdPackageConfig` | type | Union of all package configs |
-| `SdConfig` | interface | Root `sd.config.ts` configuration |
-| `SdConfigParams` | interface | Parameters passed to sd.config.ts function |
-| `SdConfigFn` | type | Type of the default export function in sd.config.ts |
+| `SdClientPackageConfig` | interface | Client package config (Vite dev server) |
+| `SdServerPackageConfig` | interface | Server package config (Fastify server) |
+| `SdScriptsPackageConfig` | interface | Scripts-only package config |
+| `BuildTarget` | type | Build target type (`"node" \| "browser" \| "neutral"`) |
+| `SdPublishConfig` | type | Union of all publish config types |
+| `SdNpmPublishConfig` | interface | npm registry publish config |
+| `SdLocalDirectoryPublishConfig` | interface | Local directory publish config |
+| `SdStoragePublishConfig` | interface | FTP/FTPS/SFTP publish config |
+| `SdPostPublishScriptConfig` | interface | Post-publish script config |
+| `SdCapacitorConfig` | interface | Capacitor configuration |
+| `SdCapacitorAndroidConfig` | interface | Capacitor Android platform config |
+| `SdCapacitorSignConfig` | interface | Capacitor Android signing config |
+| `SdCapacitorPermission` | interface | Capacitor Android permission config |
+| `SdCapacitorIntentFilter` | interface | Capacitor Android Intent Filter config |
+| `SdElectronConfig` | interface | Electron configuration |
+| `SdWatchHookConfig` | interface | Watch hook config for scripts packages |
 
 ### Vite Utilities
 
 | API | Type | Description |
 |-----|------|-------------|
-| `ViteConfigOptions` | interface | Options for creating Vite config |
-| `createViteConfig` | function | Create Vite config for SolidJS + TailwindCSS client packages |
+| `createViteConfig` | function | Create Vite config for SolidJS + Tailwind client packages |
+| `ViteConfigOptions` | interface | Options for `createViteConfig` |
 
-## `BuildTarget`
+---
 
-```typescript
-type BuildTarget = "node" | "browser" | "neutral";
-```
+### `SdConfig`
 
-## `SdPublishConfig`
-
-```typescript
-type SdPublishConfig =
-  | SdNpmPublishConfig
-  | SdLocalDirectoryPublishConfig
-  | SdStoragePublishConfig;
-```
+| Field | Type | Description |
+|-------|------|-------------|
+| `packages` | `Record<string, SdPackageConfig \| undefined>` | Per-package configuration (key: subdirectory name under `packages/`) |
+| `replaceDeps` | `Record<string, string>?` | Dependency replacement config (symlink local sources) |
+| `postPublish` | `SdPostPublishScriptConfig[]?` | Scripts to execute after deployment |
 
-## `SdPackageConfig`
+### `SdConfigFn`
 
 ```typescript
-type SdPackageConfig =
-  | SdBuildPackageConfig
-  | SdClientPackageConfig
-  | SdServerPackageConfig
-  | SdScriptsPackageConfig;
+type SdConfigFn = (params: SdConfigParams) => SdConfig | Promise<SdConfig>
 ```
 
-## `SdConfig`
-
-```typescript
-interface SdConfig {
-  packages: Record<string, SdPackageConfig | undefined>;
-  replaceDeps?: Record<string, string>;
-  postPublish?: SdPostPublishScriptConfig[];
-}
-```
+### `SdConfigParams`
 
-Root configuration type for `sd.config.ts`. The `packages` field maps package subdirectory names (e.g., `"core-common"`) to their build configuration. The `replaceDeps` field enables local symlink replacement for development.
+| Field | Type | Description |
+|-------|------|-------------|
+| `cwd` | `string` | Current working directory |
+| `dev` | `boolean` | Development mode flag |
+| `options` | `string[]` | Additional options (from CLI `-o` flag) |
 
-## `SdConfigFn`
+### `BuildTarget`
 
 ```typescript
-type SdConfigFn = (params: SdConfigParams) => SdConfig | Promise<SdConfig>;
+type BuildTarget = "node" | "browser" | "neutral"
 ```
 
-The `sd.config.ts` file must default-export a function of this type.
-
-## `SdConfigParams`
+### `SdPackageConfig`
 
 ```typescript
-interface SdConfigParams {
-  cwd: string;
-  dev: boolean;
-  options: string[];
-}
+type SdPackageConfig =
+  | SdBuildPackageConfig
+  | SdClientPackageConfig
+  | SdServerPackageConfig
+  | SdScriptsPackageConfig
 ```
 
-## `ViteConfigOptions`
+### `SdBuildPackageConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `target` | `BuildTarget` | Build target |
+| `publish` | `SdPublishConfig?` | Publish configuration |
+| `copySrc` | `string[]?` | Glob patterns for files to copy from `src/` to `dist/` |
+
+### `SdClientPackageConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `target` | `"client"` | Build target |
+| `server` | `string \| number` | Server package name or Vite port number |
+| `env` | `Record<string, string>?` | Environment variables for build |
+| `publish` | `SdPublishConfig?` | Publish configuration |
+| `capacitor` | `SdCapacitorConfig?` | Capacitor configuration |
+| `electron` | `SdElectronConfig?` | Electron configuration |
+| `configs` | `Record<string, unknown>?` | Runtime config (written to `dist/.config.json`) |
+| `exclude` | `string[]?` | Packages to exclude from Vite optimizeDeps |
+
+### `SdServerPackageConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `target` | `"server"` | Build target |
+| `env` | `Record<string, string>?` | Environment variables for build |
+| `publish` | `SdPublishConfig?` | Publish configuration |
+| `configs` | `Record<string, unknown>?` | Runtime config (written to `dist/.config.json`) |
+| `externals` | `string[]?` | External modules for esbuild |
+| `pm2` | `{ name?: string; ignoreWatchPaths?: string[] }?` | PM2 configuration |
+| `packageManager` | `"volta" \| "mise"?` | Package manager setting |
+
+### `SdScriptsPackageConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `target` | `"scripts"` | Build target |
+| `publish` | `SdPublishConfig?` | Publish configuration |
+| `watch` | `SdWatchHookConfig?` | Watch hook configuration |
+
+### `SdWatchHookConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `target` | `string[]` | Glob patterns to watch (relative to package directory) |
+| `cmd` | `string` | Command to execute on change |
+| `args` | `string[]?` | Command arguments |
+
+### `SdPublishConfig`
 
 ```typescript
-interface ViteConfigOptions {
-  pkgDir: string;
-  name: string;
-  tsconfigPath: string;
-  compilerOptions: Record<string, unknown>;
-  env?: Record<string, string>;
-  mode: "build" | "dev";
-  serverPort?: number;
-  replaceDeps?: string[];
-  onScopeRebuild?: () => void;
-  outDir?: string;
-  base?: string;
-}
+type SdPublishConfig = SdNpmPublishConfig | SdLocalDirectoryPublishConfig | SdStoragePublishConfig
 ```
 
-## `createViteConfig`
+### `SdNpmPublishConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"npm"` | Publish type |
+
+### `SdLocalDirectoryPublishConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"local-directory"` | Publish type |
+| `path` | `string` | Target path (supports `%VER%`, `%PROJECT%` substitution) |
+
+### `SdStoragePublishConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"ftp" \| "ftps" \| "sftp"` | Protocol type |
+| `host` | `string` | Server hostname |
+| `port` | `number?` | Server port |
+| `path` | `string?` | Remote path |
+| `user` | `string?` | Username |
+| `password` | `string?` | Password |
+
+### `SdPostPublishScriptConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `type` | `"script"` | Config type |
+| `cmd` | `string` | Command to execute |
+| `args` | `string[]` | Script arguments (supports `%VER%`, `%PROJECT%` substitution) |
+
+### `SdCapacitorConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `appId` | `string` | App ID (e.g., `"com.example.app"`) |
+| `appName` | `string` | App name |
+| `plugins` | `Record<string, Record<string, unknown> \| true>?` | Capacitor plugin configuration |
+| `icon` | `string?` | App icon path (relative to package directory) |
+| `debug` | `boolean?` | Debug build flag |
+| `platform` | `{ android?: SdCapacitorAndroidConfig }?` | Per-platform configuration |
+
+### `SdCapacitorAndroidConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `config` | `Record<string, string>?` | AndroidManifest.xml application tag attributes |
+| `bundle` | `boolean?` | AAB bundle build flag (false for APK) |
+| `intentFilters` | `SdCapacitorIntentFilter[]?` | Intent Filter configuration |
+| `sign` | `SdCapacitorSignConfig?` | APK/AAB signing configuration |
+| `sdkVersion` | `number?` | Android SDK version (minSdk, targetSdk) |
+| `permissions` | `SdCapacitorPermission[]?` | Additional permission configuration |
+
+### `SdCapacitorSignConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `keystore` | `string` | Keystore file path (relative to package directory) |
+| `storePassword` | `string` | Keystore password |
+| `alias` | `string` | Key alias |
+| `password` | `string` | Key password |
+| `keystoreType` | `string?` | Keystore type (default: `"jks"`) |
+
+### `SdCapacitorPermission`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | `string` | Permission name (e.g., `"CAMERA"`) |
+| `maxSdkVersion` | `number?` | Maximum SDK version |
+| `ignore` | `string?` | `tools:ignore` attribute value |
+
+### `SdCapacitorIntentFilter`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `action` | `string?` | Intent action (e.g., `"android.intent.action.VIEW"`) |
+| `category` | `string?` | Intent category (e.g., `"android.intent.category.DEFAULT"`) |
+
+### `SdElectronConfig`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `appId` | `string` | Electron app ID |
+| `portable` | `boolean?` | Portable `.exe` (true) or NSIS installer (false) |
+| `installerIcon` | `string?` | Installer icon path (`.ico`, relative to package directory) |
+| `reinstallDependencies` | `string[]?` | npm packages to include in Electron |
+| `postInstallScript` | `string?` | npm postinstall script |
+| `nsisOptions` | `Record<string, unknown>?` | NSIS options |
+| `env` | `Record<string, string>?` | Environment variables |
+
+### `ViteConfigOptions`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `pkgDir` | `string` | Package directory path |
+| `name` | `string` | Package name |
+| `tsconfigPath` | `string` | tsconfig.json path |
+| `compilerOptions` | `Record<string, unknown>` | TypeScript compiler options |
+| `env` | `Record<string, string>?` | Environment variables |
+| `mode` | `"build" \| "dev"` | Build or dev mode |
+| `serverPort` | `number?` | Server port in dev mode (0 for auto-assign) |
+| `replaceDeps` | `string[]?` | Array of replaceDeps package names |
+| `onScopeRebuild` | `(() => void)?` | Callback when replaceDeps package dist changes |
+| `outDir` | `string?` | Override `build.outDir` |
+| `base` | `string?` | Override base path |
+| `exclude` | `string[]?` | Packages to exclude from optimizeDeps |
+
+### `createViteConfig`
 
 ```typescript
-function createViteConfig(options: ViteConfigOptions): ViteUserConfig;
+function createViteConfig(options: ViteConfigOptions): ViteUserConfig
 ```
 
-Create Vite config for SolidJS + TailwindCSS client packages. Includes plugins for tsconfig paths, SolidJS, PWA, scope package watching, Tailwind config dependency tracking, and public-dev directory serving.
+Creates a Vite config for SolidJS + Tailwind CSS client packages. Includes plugins for tsconfig paths, SolidJS, PWA, Tailwind config deps watching, scope package watching, and public-dev directory serving.
 
 ## Usage Examples
 
-### Define sd.config.ts
+### sd.config.ts
 
 ```typescript
-import type { SdConfigFn } from "@simplysm/sd-cli";
+import type { SdConfigFn, SdConfigParams } from "@simplysm/sd-cli";
 
-const config: SdConfigFn = (params) => ({
+const config: SdConfigFn = (params: SdConfigParams) => ({
   packages: {
     "core-common": { target: "neutral" },
     "core-node": { target: "node" },
@@ -144,57 +274,22 @@ const config: SdConfigFn = (params) => ({
       pm2: { name: "my-app" },
     },
   },
-  replaceDeps: {
-    "@simplysm/*": "../simplysm/packages/*",
-  },
 });
 
 export default config;
 ```
 
-### Create a Vite config for a client package
+### Custom Vite config
 
 ```typescript
 import { createViteConfig } from "@simplysm/sd-cli";
 
 const config = createViteConfig({
-  pkgDir: "/path/to/my-client",
+  pkgDir: "/path/to/package",
   name: "my-client",
-  tsconfigPath: "/path/to/my-client/tsconfig.json",
+  tsconfigPath: "/path/to/tsconfig.json",
   compilerOptions: { jsx: "preserve" },
   mode: "dev",
   serverPort: 3000,
 });
 ```
-
-### Configure Capacitor build
-
-```typescript
-import type { SdConfigFn } from "@simplysm/sd-cli";
-
-const config: SdConfigFn = (params) => ({
-  packages: {
-    "my-app": {
-      target: "client",
-      server: "my-server",
-      capacitor: {
-        appId: "com.example.myapp",
-        appName: "My App",
-        icon: "resources/icon.png",
-        platform: {
-          android: {
-            sign: {
-              keystore: "keystore.jks",
-              storePassword: "pass",
-              alias: "key0",
-              password: "pass",
-            },
-          },
-        },
-      },
-    },
-  },
-});
-
-export default config;
-```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-cli",
-  "version": "13.0.98",
+  "version": "13.0.99",
   "description": "Simplysm package - CLI tool",
   "author": "simplysm",
   "license": "Apache-2.0",
@@ -14,7 +14,6 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "docs",
     "src",
     "templates",
     "tests"
@@ -43,9 +42,9 @@
     "vite-plugin-solid": "^2.11.11",
     "vite-tsconfig-paths": "^6.1.1",
     "yargs": "^18.0.0",
-    "@simplysm/core-common": "13.0.98",
-    "@simplysm/core-node": "13.0.98",
-    "@simplysm/storage": "13.0.98"
+    "@simplysm/core-common": "13.0.99",
+    "@simplysm/core-node": "13.0.99",
+    "@simplysm/storage": "13.0.99"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",

package/templates/init/package.json.hbs

@@ -15,19 +15,18 @@
     "lint:fix": "sd-cli lint --fix",
     "check": "sd-cli check",
     "test": "vitest run",
-    "test:e2e": "vitest run -c vitest-e2e.config.ts",
     "postinstall": "playwright-cli install --skills"
   },
   "devDependencies": {
-    "@simplysm/lint": "~13.0.98",
-    "@simplysm/sd-cli": "~13.0.98",
-    "@simplysm/sd-claude": "~13.0.98",
+    "@simplysm/lint": "~13.0.99",
+    "@simplysm/sd-cli": "~13.0.99",
+    "@simplysm/sd-claude": "~13.0.99",
     "@playwright/cli": "^0.1.1",
     "@types/node": "^20.19.37",
     "eslint": "^9.39.4",
     "prettier": "^3.8.1",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^6.1.1",
-    "vitest": "^4.1.0",
+    "vitest": "^4.1.0"
   }
 }

package/templates/init/packages/client-admin/package.json.hbs

@@ -6,13 +6,13 @@
   "private": true,
   "dependencies": {
     "@{{projectName}}/db-main": "workspace:*",
-    "@simplysm/core-browser": "~13.0.98",
-    "@simplysm/core-common": "~13.0.98",
-    "@simplysm/excel": "~13.0.98",
-    "@simplysm/orm-common": "~13.0.98",
-    "@simplysm/service-client": "~13.0.98",
-    "@simplysm/service-common": "~13.0.98",
-    "@simplysm/solid": "~13.0.98",
+    "@simplysm/core-browser": "~13.0.99",
+    "@simplysm/core-common": "~13.0.99",
+    "@simplysm/excel": "~13.0.99",
+    "@simplysm/orm-common": "~13.0.99",
+    "@simplysm/service-client": "~13.0.99",
+    "@simplysm/service-common": "~13.0.99",
+    "@simplysm/solid": "~13.0.99",
     "@solid-primitives/event-listener": "^2.4.5",
     "@solidjs/router": "^0.15.4",
     "@tabler/icons-solidjs": "^3.40.0",

package/templates/init/packages/db-main/package.json.hbs

@@ -7,7 +7,7 @@
     ".": "./src/index.ts"
   },
   "dependencies": {
-    "@simplysm/core-common": "~13.0.98",
-    "@simplysm/orm-common": "~13.0.98"
+    "@simplysm/core-common": "~13.0.99",
+    "@simplysm/orm-common": "~13.0.99"
   }
 }

package/templates/init/packages/server/package.json.hbs

@@ -5,11 +5,11 @@
   "private": true,
   "dependencies": {
     "@{{projectName}}/db-main": "workspace:*",
-    "@simplysm/core-common": "~13.0.98",
-    "@simplysm/excel": "~13.0.98",
-    "@simplysm/orm-common": "~13.0.98",
-    "@simplysm/orm-node": "~13.0.98",
-    "@simplysm/service-server": "~13.0.98",
+    "@simplysm/core-common": "~13.0.99",
+    "@simplysm/excel": "~13.0.99",
+    "@simplysm/orm-common": "~13.0.99",
+    "@simplysm/orm-node": "~13.0.99",
+    "@simplysm/service-server": "~13.0.99",
     "bcrypt": "^6.0.0",
     "pg": "^8.20.0",
     "pg-copy-streams": "^7.0.0"

package/templates/init/pnpm-workspace.yaml

@@ -1,7 +1,6 @@
 packages:
   - packages/*
   - tests/*
-  - tests-e2e
 
 onlyBuiltDependencies:
   - "@simplysm/sd-claude"

package/templates/init/tsconfig.json.hbs

@@ -34,7 +34,6 @@
     "packages/*/src/**/*.tsx",
     "packages/*/tests/**/*.ts",
     "packages/*/tests/**/*.tsx",
-    "tests/**/*.ts",
-    "tests-e2e/**/*.ts"
+    "tests/**/*.ts"
   ]
 }

package/templates/init/tests-e2e/package.json.hbs

@@ -1,16 +0,0 @@
-{
-  "name": "@{{projectName}}-test/e2e",
-  "version": "1.0.0",
-  "description": "{{projectName}} E2E tests",
-  "type": "module",
-  "private": true,
-  "dependencies": {
-    "@{{projectName}}/db-main": "workspace:*",
-    "@simplysm/orm-node": "~13.0.98",
-    "bcrypt": "^6.0.0",
-    "playwright": "^1.58.2"
-  },
-  "devDependencies": {
-    "@types/bcrypt": "^6.0.0"
-  }
-}

package/templates/init/tests-e2e/src/e2e.spec.ts

@@ -1,36 +0,0 @@
-import { describe, inject, beforeAll, afterAll } from "vitest";
-import { chromium, type Browser, type BrowserContext, type Page } from "playwright";
-import { loginTests } from "./login";
-import { employeeCrudTests } from "./employee-crud";
-
-const ctx = {} as { page: Page; baseUrl: string };
-
-let browser: Browser;
-let context: BrowserContext;
-
-describe("E2E", () => {
-  beforeAll(async () => {
-    ctx.baseUrl = inject("baseUrl");
-    browser = await chromium.launch({ headless: true });
-    context = await browser.newContext();
-    ctx.page = await context.newPage();
-    ctx.page.setDefaultTimeout(500);
-
-    // Output browser console errors to test console
-    ctx.page.on("pageerror", (err) => {
-      console.error(`[PAGE_ERROR] ${err.message}`);
-    });
-    ctx.page.on("console", (msg) => {
-      if (msg.type() === "error") {
-        console.error(`[CONSOLE_ERROR] ${msg.text()}`);
-      }
-    });
-  });
-
-  afterAll(async () => {
-    await browser.close();
-  });
-
-  loginTests(ctx);
-  employeeCrudTests(ctx);
-});

package/templates/init/tests-e2e/src/employee-crud.ts

@@ -1,204 +0,0 @@
-import { describe, it, expect, beforeAll } from "vitest";
-import type { Page } from "playwright";
-
-export function employeeCrudTests(ctx: { page: Page; baseUrl: string }) {
-  describe("EmployeeSheet CRUD", () => {
-    const sheetSelector = '[data-sheet="employee-page-sheet"]';
-
-    function sheetRows() {
-      return ctx.page.locator(`${sheetSelector} tbody tr`);
-    }
-
-    function dialogLocator() {
-      return ctx.page.locator("[data-dialog-panel]").last();
-    }
-
-    async function waitForSheetLoaded() {
-      await sheetRows().first().waitFor({ timeout: 1000 });
-    }
-
-    async function waitForBusyDone() {
-      await ctx.page.waitForTimeout(50);
-      await ctx.page.waitForFunction(() => !document.querySelector(".animate-spin"));
-    }
-
-    async function waitForDialogClosed() {
-      await ctx.page.waitForFunction(
-        () =>
-          document.querySelectorAll("[data-dialog-panel]").length === 0 &&
-          document.querySelectorAll("[data-dialog-backdrop]").length === 0,
-      );
-    }
-
-    async function assertNotification(text: string) {
-      const alert = ctx.page
-        .locator("[data-notification-banner]")
-        .filter({ hasText: text })
-        .first();
-      await alert.waitFor();
-      const closeButtons = ctx.page.locator(
-        '[data-notification-banner] button[aria-label="알림 닫기"]',
-      );
-      const count = await closeButtons.count();
-      for (let i = count - 1; i >= 0; i--) {
-        await closeButtons
-          .nth(i)
-          .click()
-          .catch(() => {});
-      }
-      await ctx.page.waitForFunction(
-        () => document.querySelectorAll("[data-notification-banner]").length === 0,
-      );
-    }
-
-    async function clickSearch() {
-      await ctx.page.getByRole("button", { name: "조회" }).click();
-      await waitForBusyDone();
-    }
-
-    async function clickAdd() {
-      await ctx.page.getByRole("button", { name: /등록/ }).click();
-      await dialogLocator().waitFor();
-    }
-
-    async function clickEditRow(rowIndex: number) {
-      await sheetRows().nth(rowIndex).locator("a").first().click();
-      await dialogLocator().waitFor();
-      await waitForBusyDone();
-    }
-
-    async function fillDialogField(label: string, value: string) {
-      const dlg = dialogLocator();
-      const th = dlg.locator("th").filter({ hasText: label });
-      const td = th.locator("xpath=following-sibling::td[1]");
-      const field = td.locator("input:not([aria-hidden])").first();
-      await field.fill(value);
-    }
-
-    async function clickDialogSubmit() {
-      await dialogLocator().getByRole("button", { name: "확인" }).click();
-    }
-
-    async function closeDialog() {
-      await ctx.page.keyboard.press("Escape");
-      await waitForDialogClosed();
-    }
-
-    beforeAll(async () => {
-      await ctx.page.goto(`${ctx.baseUrl}/#/home/base/employee`);
-      await waitForSheetLoaded();
-    });
-
-    describe("Create", () => {
-      it("새 직원 등록", async () => {
-        await clickAdd();
-
-        await fillDialogField("이름", "E2E테스트유저");
-        await fillDialogField("이메일", "e2e@test.com");
-
-        await clickDialogSubmit();
-        await assertNotification("저장되었습니다");
-        await waitForDialogClosed();
-        await clickSearch();
-
-        const firstCell = sheetRows().first().locator("td").nth(1);
-        await expect(firstCell.textContent()).resolves.toContain("E2E테스트유저");
-      });
-    });
-
-    describe("Read / Filter", () => {
-      it("검색어 필터링", async () => {
-        const searchInput = ctx.page.locator("form").first().locator("input").first();
-        await searchInput.fill("E2E테스트");
-        await clickSearch();
-
-        const rowCount = await sheetRows().count();
-        expect(rowCount).toBe(1);
-        await expect(sheetRows().first().locator("td").nth(1).textContent()).resolves.toContain(
-          "E2E테스트유저",
-        );
-
-        await searchInput.fill("");
-        await clickSearch();
-        const allRowCount = await sheetRows().count();
-        expect(allRowCount).toBe(2);
-      });
-    });
-
-    describe("Update", () => {
-      it("기존 유저 이름 수정", async () => {
-        await clickEditRow(0);
-
-        await fillDialogField("이름", "E2E수정유저");
-
-        await clickDialogSubmit();
-        await assertNotification("저장되었습니다");
-        await waitForDialogClosed();
-        await clickSearch();
-
-        await expect(sheetRows().first().locator("td").nth(1).textContent()).resolves.toContain(
-          "E2E수정유저",
-        );
-      });
-    });
-
-    describe("Delete", () => {
-      it("유저 soft delete", async () => {
-        await clickEditRow(0);
-
-        await dialogLocator().getByRole("button", { name: "삭제" }).click();
-        await assertNotification("삭제되었습니다");
-        await waitForDialogClosed();
-        await clickSearch();
-
-        const rowCount = await sheetRows().count();
-        expect(rowCount).toBe(1);
-        await expect(sheetRows().first().locator("td").nth(1).textContent()).resolves.toContain(
-          "테스트",
-        );
-      });
-
-      it("삭제항목 포함 필터로 삭제된 유저 확인", async () => {
-        await ctx.page.getByText("삭제항목 포함").click();
-        await clickSearch();
-
-        const rowCount = await sheetRows().count();
-        expect(rowCount).toBe(2);
-
-        await ctx.page.getByText("삭제항목 포함").click();
-        await clickSearch();
-      });
-    });
-
-    describe("Error cases", () => {
-      it("이름 중복 에러", async () => {
-        await clickAdd();
-        await fillDialogField("이름", "테스트");
-        await clickDialogSubmit();
-        await assertNotification("동일한 이름이 이미 등록되어 있습니다");
-
-        await closeDialog();
-      });
-
-      it("이메일 중복 에러", async () => {
-        await clickAdd();
-        await fillDialogField("이름", "고유이름");
-        await fillDialogField("이메일", "admin@test.com");
-        await clickDialogSubmit();
-        await assertNotification("동일한 이메일이 이미 등록되어 있습니다");
-
-        await closeDialog();
-      });
-
-      it("자기 자신 삭제 불가", async () => {
-        await clickEditRow(0);
-        await waitForBusyDone();
-
-        const deleteBtn = dialogLocator().getByRole("button", { name: "삭제" });
-        expect(await deleteBtn.count()).toBe(0);
-
-        await closeDialog();
-      });
-    });
-  });
-}

package/templates/init/tests-e2e/src/login.ts

@@ -1,61 +0,0 @@
-import { describe, expect, it } from "vitest";
-import type { Page } from "playwright";
-
-export function loginTests(ctx: { page: Page; baseUrl: string }) {
-  describe("Login", () => {
-    it("/ 접속 시 /login으로 리다이렉트", async () => {
-      await ctx.page.goto(`${ctx.baseUrl}/`, { timeout: 5000 });
-      await ctx.page.waitForURL(`${ctx.baseUrl}/#/login`);
-      await expect(
-        ctx.page.getByRole("button", { name: "로그인" }).textContent(),
-      ).resolves.toContain("로그인");
-    });
-
-    it("토큰 없이 /home/main 접근 시 /login으로 리다이렉트", async () => {
-      await ctx.page.goto(`${ctx.baseUrl}/#/home/main`);
-      await ctx.page.waitForURL(`${ctx.baseUrl}/#/login`);
-      await expect(
-        ctx.page.getByRole("button", { name: "로그인" }).textContent(),
-      ).resolves.toContain("로그인");
-    });
-
-    it("틀린 비밀번호 시 에러 메시지", async () => {
-      await ctx.page.getByPlaceholder("이메일을 입력하세요").fill("admin@test.com");
-      await ctx.page.getByPlaceholder("비밀번호를 입력하세요").fill("wrongpassword");
-      await ctx.page.getByRole("button", { name: "로그인" }).click();
-
-      const notification = ctx.page.getByRole("alert");
-      await notification.waitFor({ timeout: 1000 });
-      await expect(notification.textContent()).resolves.toContain(
-        "이메일 또는 비밀번호가 올바르지 않습니다",
-      );
-    });
-
-    it("올바른 자격 증명으로 로그인 성공", async () => {
-      await ctx.page.goto(`${ctx.baseUrl}/#/login`);
-      await ctx.page.getByRole("button", { name: "로그인" }).waitFor({ timeout: 2000 });
-
-      await ctx.page.getByPlaceholder("이메일을 입력하세요").fill("admin@test.com");
-      await ctx.page.getByPlaceholder("비밀번호를 입력하세요").fill("test1234");
-      await ctx.page.getByRole("button", { name: "로그인" }).click({ timeout: 2000 });
-
-      await ctx.page.waitForURL(`${ctx.baseUrl}/#/home/main`, { timeout: 2000 });
-      const mainContent = ctx.page.locator("main").last();
-      await expect(mainContent.locator("h1").textContent()).resolves.toContain("테스트");
-    });
-
-    it("마지막 로그인 이메일 기억", async () => {
-      const lastLoginEmail = await ctx.page.evaluate(() =>
-        JSON.parse(localStorage.getItem("client-admin.last-login-email") ?? "null"),
-      );
-      expect(lastLoginEmail).toBe("admin@test.com");
-    });
-
-    it("페이지 새로고침 시 자동 로그인", async () => {
-      await ctx.page.reload();
-      await ctx.page.waitForURL(`${ctx.baseUrl}/#/home/main`, { timeout: 2000 });
-      const mainContent = ctx.page.locator("main").last();
-      await expect(mainContent.locator("h1").textContent()).resolves.toContain("테스트");
-    });
-  });
-}

package/templates/init/tests-e2e/vitest.setup.ts.hbs

@@ -1,220 +0,0 @@
-import { type ChildProcess, spawn, execSync } from "child_process";
-import path from "path";
-import { fileURLToPath } from "url";
-import { createDbConn, createOrm } from "@simplysm/orm-node";
-import { MainDbContext } from "@{{projectName}}/db-main";
-import bcrypt from "bcrypt";
-import { chromium } from "playwright";
-import type { TestProject } from "vitest/node";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const rootDir = path.resolve(__dirname, "..");
-
-const DB_CONFIG = {
-  dialect: "postgresql" as const,
-  host: "localhost",
-  port: 5432,
-  username: "postgres",
-  password: "1234",
-  database: "{{projectName}}-test",
-};
-
-const TEST_USER = {
-  name: "테스트",
-  email: "admin@test.com",
-  password: "test1234",
-};
-
-let devServerProcess: ChildProcess | undefined;
-
-function killProcessTree(proc: ChildProcess): void {
-  if (proc.pid == null) return;
-  try {
-    if (process.platform === "win32") {
-      execSync(`taskkill /T /F /PID ${proc.pid}`, { stdio: "ignore" });
-    } else {
-      process.kill(-proc.pid, "SIGTERM");
-    }
-  } catch {
-    /* 무시 */
-  }
-}
-
-function stripAnsi(str: string): string {
-  return str.replace(/\x1B\[[0-9;]*m/g, "");
-}
-
-function waitForServerUrl(process: ChildProcess, timeout: number): Promise<string> {
-  return new Promise((resolve, reject) => {
-    let settled = false;
-    let output = "";
-
-    const timer = setTimeout(() => {
-      if (!settled) {
-        settled = true;
-        reject(
-          new Error(`dev 서버 URL 대기 시간 초과 (${timeout}ms)\n출력:\n${output.slice(-2000)}`),
-        );
-      }
-    }, timeout);
-
-    function onData(data: Buffer) {
-      const text = stripAnsi(data.toString());
-      console.log(text);
-      output += text;
-
-      const urlMatch = text.match(/http:\/\/localhost:\d+\/client-admin\/?/);
-      if (urlMatch && !settled) {
-        settled = true;
-        clearTimeout(timer);
-        resolve(urlMatch[0].endsWith("/") ? urlMatch[0].slice(0, -1) : urlMatch[0]);
-      }
-    }
-
-    process.stdout?.on("data", onData);
-    process.stderr?.on("data", onData);
-
-    process.on("exit", (code) => {
-      if (!settled) {
-        settled = true;
-        clearTimeout(timer);
-        reject(
-          new Error(`dev 서버가 비정상 종료됨 (code: ${code})\n출력:\n${output.slice(-2000)}`),
-        );
-      }
-    });
-  });
-}
-
-async function warmup(baseUrl: string, timeout: number): Promise<void> {
-  const browser = await chromium.launch({ headless: true });
-  try {
-    const page = await browser.newPage();
-    await page.goto(baseUrl, { timeout });
-
-    const result = await Promise.race([
-      page
-        .locator(".app-loading")
-        .waitFor({ state: "detached", timeout })
-        .then(() => "ready" as const),
-      page
-        .locator("vite-error-overlay")
-        .waitFor({ state: "attached", timeout })
-        .then(async () => {
-          const errorText = await page
-            .locator("vite-error-overlay")
-            .evaluate((el) => el.shadowRoot?.textContent ?? "");
-          return `error:${errorText}` as const;
-        }),
-    ]);
-
-    if (result.startsWith("error:")) {
-      throw new Error(`Vite 빌드 에러:\n${result.slice(6).slice(0, 2000)}`);
-    }
-  } finally {
-    await browser.close();
-  }
-}
-
-export async function setup(project: TestProject) {
-  // 1. 테스트 DB 생성 (없으면)
-  console.log("[e2e] 테스트 DB 확인...");
-  const adminConn = await createDbConn({ ...DB_CONFIG, database: "postgres" });
-  await adminConn.connect();
-  try {
-    const result = await adminConn.executeParametrized(
-      `SELECT 1 FROM pg_database WHERE datname = $1`,
-      [DB_CONFIG.database],
-    );
-    if (result[0].length === 0) {
-      await adminConn.execute([`CREATE DATABASE "${DB_CONFIG.database}"`]);
-      console.log(`[e2e] DB "${DB_CONFIG.database}" 생성됨.`);
-    } else {
-      console.log(`[e2e] DB "${DB_CONFIG.database}" 이미 존재.`);
-    }
-  } finally {
-    await adminConn.close();
-  }
-
-  // 2. DB 초기화 및 시딩
-  const orm = createOrm(MainDbContext, DB_CONFIG);
-  await orm.connectWithoutTransaction(async (db) => {
-    await db.initialize({ force: true });
-
-    // 권한그룹 생성
-    await db.role().insert([{ name: "관리자" }]);
-    const role = (await db.role().first())!;
-
-    // 전체 권한 부여
-    await db.rolePermission().insert([
-      { roleId: role.id, code: "/home/base/employee/use", valueJson: "true" },
-      { roleId: role.id, code: "/home/base/employee/edit", valueJson: "true" },
-      { roleId: role.id, code: "/home/base/employee/auth/use", valueJson: "true" },
-      { roleId: role.id, code: "/home/base/employee/auth/edit", valueJson: "true" },
-      { roleId: role.id, code: "/home/base/employee/personal/use", valueJson: "true" },
-      { roleId: role.id, code: "/home/base/employee/personal/edit", valueJson: "true" },
-      { roleId: role.id, code: "/home/base/employee/payroll/use", valueJson: "true" },
-      { roleId: role.id, code: "/home/base/employee/payroll/edit", valueJson: "true" },
-    ]);
-
-    // 테스트 유저 생성 (roleId 포함)
-    const encryptedPassword = await bcrypt.hash(TEST_USER.password, 10);
-    await db.employee().insert([
-      {
-        name: TEST_USER.name,
-        email: TEST_USER.email,
-        encryptedPassword,
-        roleId: role.id,
-        isDeleted: false,
-      },
-    ]);
-  });
-  console.log("[e2e] DB 초기화 및 시딩 완료.");
-
-  // 3. dev 서버 시작
-  console.log("[e2e] dev 서버 시작...");
-  devServerProcess = spawn("node", ["node_modules/@simplysm/sd-cli/dist/sd-cli.js", "dev"], {
-    cwd: rootDir,
-    stdio: "pipe",
-    ...(process.platform !== "win32" ? { detached: true } : {}),
-    env: {
-      ...process.env,
-      DB_DATABASE: DB_CONFIG.database,
-      DB_PORT: String(DB_CONFIG.port),
-      NODE_ENV: undefined, // consola가 콘솔을 강제로 warn이상으로 설정하지 못하도록 하기 위함
-      TEST: undefined, // consola가 콘솔을 강제로 warn이상으로 설정하지 못하도록 하기 위함
-    },
-  });
-
-  let baseUrl: string;
-  try {
-    // 4. stdout에서 URL 파싱 (90초 타임아웃)
-    baseUrl = await waitForServerUrl(devServerProcess, 90_000);
-    console.log(`[e2e] dev 서버 URL 감지: ${baseUrl}`);
-
-    // 5. Playwright warmup — Vite 빌드 트리거 및 에러 감지 (60초 타임아웃)
-    console.log("[e2e] Vite 빌드 warmup...");
-    await warmup(baseUrl, 60_000);
-    console.log("[e2e] warmup 완료. 테스트 시작 준비됨.");
-
-    project.provide("baseUrl", baseUrl);
-  } catch (err) {
-    killProcessTree(devServerProcess);
-    devServerProcess = undefined;
-    throw err;
-  }
-}
-
-export function teardown() {
-  if (devServerProcess != null) {
-    console.log("[e2e] dev 서버 종료...");
-    killProcessTree(devServerProcess);
-    devServerProcess = undefined;
-  }
-}
-
-declare module "vitest" {
-  export interface ProvidedContext {
-    baseUrl: string;
-  }
-}

package/templates/init/vitest-e2e.config.ts

@@ -1,23 +0,0 @@
-import { defineConfig } from "vitest/config";
-import tsconfigPaths from "vite-tsconfig-paths";
-
-export default defineConfig({
-  plugins: [
-    tsconfigPaths({
-      root: ".",
-      projects: ["./tsconfig.json"],
-    }),
-  ],
-  define: {
-    "process.env.DEV": JSON.stringify("true"),
-    "process.env.VER": JSON.stringify("1.0.0-test"),
-  },
-  test: {
-    globals: true,
-    environment: "node",
-    include: ["tests-e2e/src/**/*.spec.ts"],
-    globalSetup: "./tests-e2e/vitest.setup.ts",
-    fileParallelism: false,
-    testTimeout: 30000,
-  },
-});