create-qs 0.8.23 → 0.8.26

package/index.js

@@ -894,6 +894,133 @@ var MultiselectPrompt = class {
 function multiselect(options) {
   return new MultiselectPrompt(options).run();
 }
+var SelectPrompt = class {
+  rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  message;
+  items;
+  cursor;
+  state = "init";
+  constructor(options) {
+    if (options.items.length === 0) {
+      throw new Error("select: items must not be empty");
+    }
+    this.message = options.message;
+    this.items = options.items.map((c) => ({ ...c }));
+    const defaultIndex = options.default !== void 0 ? this.items.findIndex((it) => it.value === options.default) : -1;
+    this.cursor = defaultIndex >= 0 ? defaultIndex : 0;
+    readline.emitKeypressEvents(process.stdin, this.rl);
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+  }
+  async run() {
+    process.stdout.write(hideCursor());
+    this.render();
+    return new Promise((resolve3, reject) => {
+      let resolved = false;
+      const cleanup = () => {
+        process.stdin.removeListener("keypress", handleKeypress);
+        process.stdin.removeListener("data", handleData);
+      };
+      const safeResolve = (value) => {
+        if (!resolved) {
+          resolved = true;
+          cleanup();
+          resolve3(value);
+        }
+      };
+      const safeReject = (reason) => {
+        if (!resolved) {
+          resolved = true;
+          cleanup();
+          reject(reason);
+        }
+      };
+      const handleKeypress = (_str, key) => {
+        if (resolved) {
+          return;
+        }
+        if (key.name === "up") {
+          this.moveCursor(-1);
+        } else if (key.name === "down") {
+          this.moveCursor(1);
+        } else if (key.name === "return") {
+          process.stdout.write(up());
+          safeResolve(this.finish());
+        } else if (key.ctrl && key.name === "c") {
+          this.state = "cancelled";
+          this.exit();
+          safeReject(new PromptCancelled());
+        }
+        this.render();
+      };
+      const handleData = (data) => {
+        if (resolved) {
+          return;
+        }
+        const str = data.toString();
+        if (str === "\n" || str === "\r" || str === "\r\n") {
+          process.stdout.write(down());
+          safeResolve(this.finish());
+        }
+      };
+      process.stdin.on("keypress", handleKeypress);
+      process.stdin.on("data", handleData);
+    });
+  }
+  render() {
+    const hint = chalk4.dim(promptTexts().selectHelp);
+    if (this.state === "init") {
+      this.state = "select";
+      console.log(chalk4.cyan("? ") + chalk4.bold(this.message) + chalk4.dim(" \u203A"));
+      console.log("  " + hint);
+      this.writeItems();
+    } else if (this.state === "select") {
+      process.stdout.write(upStart(this.items.length + 1));
+      console.log(chalk4.cyan("? ") + chalk4.bold(this.message) + chalk4.dim(" \u203A"));
+      console.log("  " + hint + clearLineFromCursor());
+      this.writeItems();
+    } else {
+      process.stdout.write(down() + upClear(this.items.length + 2));
+      console.log(this.state === "cancelled" ? cancelledLine(this.message) : chalk4.green("\u2714 ") + chalk4.bold(this.message) + chalk4.dim(" \xB7 ") + chalk4.green(this.getSelectedItem().name));
+    }
+  }
+  writeItems() {
+    this.items.forEach((item, index) => this.writeItem(item, index));
+    process.stdout.write(up());
+  }
+  writeItem(item, index) {
+    const isSelected = index === this.cursor;
+    if (isSelected) {
+      console.log(`  ${chalk4.cyan("\u276F")} ${item.name}`);
+    } else {
+      console.log(`    ${item.name}`);
+    }
+  }
+  moveCursor(direction) {
+    const length = this.items.length;
+    this.cursor = (this.cursor + direction + length) % length;
+  }
+  getSelectedItem() {
+    return this.items[this.cursor];
+  }
+  finish() {
+    this.state = "finished";
+    this.exit();
+    return this.getSelectedItem().value;
+  }
+  exit() {
+    this.rl.close();
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(false);
+    }
+    process.stdin.removeAllListeners("keypress");
+    process.stdout.write(showCursor());
+  }
+};
+function select(options) {
+  return new SelectPrompt(options).run();
+}
 var INDENT = "  ";
 var MAX_COLUMNS = 100;
 function renderCode(line, color = chalk4.cyan) {
@@ -998,6 +1125,11 @@ var HINTS = {
     "zh-TW": "\u672C\u7522\u54C1\u76F8\u4F9D\u7684\u6A21\u7D44\uFF0C\u5F8C\u7E8C\u53EF\u518D\u884C\u65B0\u589E\u3002",
     "en-US": "Modules this product depends on. More can be added later."
   },
+  jsonsLocale: {
+    "zh-CN": "\u6570\u636E\u6587\u4EF6\u4E2D\u663E\u793A\u6587\u672C\u7684\u8BED\u8A00\uFF0C\u5373\u5355\u5143\u540D\u3001\u83DC\u5355\u3001\u6587\u6848\u7B49\u7684\u4E66\u5199\u8BED\u8A00\u3002\u5B89\u88C5\u65F6\u53EF\u4EE5\u53E6\u9009\u4EA7\u54C1\u8BED\u8A00\uFF0C\u7FFB\u8BD1\u8868\u63D0\u4F9B\u5176\u5B83\u8BED\u8A00\u3002\u26A0 \u66F4\u6539\u8981\u91CD\u5199\u5168\u90E8\u6570\u636E\u6587\u4EF6\u4E0E\u7FFB\u8BD1\u8868\u3002",
+    "zh-TW": "\u8CC7\u6599\u6A94\u4E2D\u986F\u793A\u6587\u5B57\u7684\u8A9E\u8A00\uFF0C\u5373\u55AE\u5143\u540D\u3001\u9078\u55AE\u3001\u6587\u6848\u7B49\u7684\u66F8\u5BEB\u8A9E\u8A00\u3002\u5B89\u88DD\u6642\u53EF\u4EE5\u53E6\u9078\u7522\u54C1\u8A9E\u8A00\uFF0C\u7FFB\u8B6F\u8868\u63D0\u4F9B\u5176\u4ED6\u8A9E\u8A00\u3002\u26A0 \u66F4\u6539\u8981\u91CD\u5BEB\u5168\u90E8\u8CC7\u6599\u6A94\u8207\u7FFB\u8B6F\u8868\u3002",
+    "en-US": "The language of the display texts in data files: unit names, menus, messages. Installations may pick another product language, and translation tables supply the others. \u26A0 Changing it means rewriting every data file and translation table."
+  },
   moduleMenu: {
     "zh-CN": "\u672C\u6A21\u5757\u5728\u5DE6\u4FA7\u5BFC\u822A\u4E2D\u7684\u4E00\u7EA7\u5165\u53E3\uFF0C\u4E0E\u5E73\u53F0\u5185\u7F6E\u7684\u5165\u53E3\u5E76\u5217\u3002\u540E\u7EED\u521B\u5EFA\u7684\u9875\u9762\u53EF\u6302\u8F7D\u4E8E\u5176\u4E0B\uFF0C\u540D\u79F0\u4E0E\u5B58\u5E9F\u5747\u53EF\u968F\u65F6\u8C03\u6574\u3002",
     "zh-TW": "\u672C\u6A21\u7D44\u5728\u5DE6\u5074\u5C0E\u89BD\u5217\u4E2D\u7684\u4E00\u7D1A\u5165\u53E3\uFF0C\u8207\u5E73\u53F0\u5167\u5EFA\u7684\u5165\u53E3\u4E26\u5217\u3002\u5F8C\u7E8C\u5EFA\u7ACB\u7684\u9801\u9762\u53EF\u639B\u8F09\u65BC\u5176\u4E0B\uFF0C\u540D\u7A31\u8207\u5B58\u5EE2\u5747\u53EF\u96A8\u6642\u8ABF\u6574\u3002",
@@ -1033,6 +1165,7 @@ var TEXTS = {
     "zh-TW": "\u70BA\u672C\u6A21\u7D44\u5EFA\u7ACB\u9802\u5C64\u9078\u55AE",
     "en-US": "Create a top-level menu for this module"
   },
+  "label.jsonsLocale": { "zh-CN": "\u6570\u636E\u6587\u4EF6\u7684\u7F16\u5199\u8BED\u8A00", "zh-TW": "\u8CC7\u6599\u6A94\u7684\u66F8\u5BEB\u8A9E\u8A00", "en-US": "Language of data files" },
   "label.moduleMenuName": { "zh-CN": "\u9876\u5C42\u83DC\u5355\u540D\u79F0", "zh-TW": "\u9802\u5C64\u9078\u55AE\u540D\u7A31", "en-US": "Top-level menu name" },
   // 校验
   "validate.empty": { "zh-CN": "{0}\u4E0D\u80FD\u4E3A\u7A7A", "zh-TW": "{0}\u4E0D\u80FD\u70BA\u7A7A", "en-US": "{0} must be a non-empty string" },
@@ -1211,6 +1344,17 @@ function printHint2(step) {
   printHint(HINTS[step][language]);
 }
 
+// src/collect/jsons-locale.ts
+var JSONS_LOCALES = ["zh-CN", "zh-TW"];
+var JSONS_LOCALE_NAMES = {
+  "zh-CN": "\u7B80\u4F53\u4E2D\u6587",
+  "zh-TW": "\u7E41\u9AD4\u4E2D\u6587"
+};
+function orderJsonsLocales(uiLanguage) {
+  const preferred = uiLanguage === "zh-TW" ? "zh-TW" : "zh-CN";
+  return [preferred, ...JSONS_LOCALES.filter((locale) => locale !== preferred)];
+}
+
 // src/collect/summary.ts
 function row(step, value) {
   return { label: t(`label.${step}`), value };
@@ -1229,6 +1373,7 @@ function summaryRows(options) {
     row("apiArtifactId", options.apiArtifactId),
     row("webModulePackage", options.webModulePackage),
     row("platformModules", options.platformModules.join(", ")),
+    row("jsonsLocale", JSONS_LOCALE_NAMES[options.jsonsLocale] ?? options.jsonsLocale),
     { label: t("label.moduleMenuName"), value: options.moduleMenu ?? t("summary.noMenu") }
   ];
 }
@@ -1422,6 +1567,7 @@ var FLAGS = {
   apiArtifactId: "--api-artifact-id",
   webModulePackage: "--web-module-package",
   platformModules: "--modules",
+  jsonsLocale: "--jsons-locale",
   moduleMenu: "--module-menu"
 };
 async function ask(args, step, options) {
@@ -1537,6 +1683,25 @@ async function collectPlatformModules(args) {
   const codes = await multiselect({ message: t("label.platformModules"), items });
   return resolvePlatformModules(codes).map((module) => module.code);
 }
+async function collectJsonsLocale(args) {
+  const ordered = orderJsonsLocales(language);
+  if (args.jsonsLocale !== void 0) {
+    const value = args.jsonsLocale.trim();
+    if (!JSONS_LOCALES.includes(value)) {
+      throw new UsageError(`--jsons-locale must be one of ${JSONS_LOCALES.join(", ")}, got '${args.jsonsLocale}'`);
+    }
+    return value;
+  }
+  if (args.yes) {
+    return ordered[0];
+  }
+  printHint2("jsonsLocale");
+  return select({
+    message: t("label.jsonsLocale"),
+    default: ordered[0],
+    items: ordered.map((locale) => ({ name: JSONS_LOCALE_NAMES[locale], value: locale }))
+  });
+}
 async function collectModuleMenu(args, options) {
   if (args.moduleMenu === false) {
     return void 0;
@@ -1584,6 +1749,7 @@ async function collectProjectOptions(args) {
   options.apiArtifactId = await collectApiArtifactId(args, options);
   options.webModulePackage = await collectWebModulePackage(args, options);
   options.platformModules = await collectPlatformModules(args);
+  options.jsonsLocale = await collectJsonsLocale(args);
   options.moduleMenu = await collectModuleMenu(args, options);
   options.template = "default";
   printSummary(t("summary.title"), summaryRows(options));
@@ -1804,9 +1970,10 @@ async function processFiles(options) {
   variables.set("WEB_PACKAGE_NAME", options.webModulePackage);
   variables.set("API_PACKAGE", options.apiPackage);
   variables.set("API_ARTIFACT_ID", options.apiArtifactId);
-  variables.set("QUICKSILVER_VERSION", "0.8.23");
+  variables.set("QUICKSILVER_VERSION", "0.8.26");
   variables.set("MODULE_ID", randomUUID());
   variables.set("DB_PREFIX", toDbPrefix(options.name));
+  variables.set("JSONS_LOCALE", options.jsonsLocale);
   const menu = renderModuleMenu(options.moduleMenu, options.platformModules);
   variables.set("MODULE_MENU", menu.text);
   variables.set("MODULE_DEFAULT_MENU", menu.menuId ? `default_menu_id: '${menu.menuId}', ` : "");
@@ -1866,7 +2033,7 @@ if (process.argv.some((arg) => arg === "--version" || arg === "-v")) {
   console.log(getCliVersion());
   process.exit(0);
 }
-var program = new Command().name("create-qs").description("Create a new Quicksilver application").version("0.8.23", "-v, --version").argument("[project-name]", "Name of the project").option("-c, --module-code <code>", "Full module code (e.g., power_crm.sales)").option("-d, --module-directory <directory>", "Module directory name (e.g., sales)").option("-n, --module-namespace <code>", "Prefix of unit/table, defaults to the initials of the module code (e.g., pcs)").option("-p, --api-package <package>", "JVM package for Kotlin files (e.g., com.company.crm)").option("-a, --api-artifact-id <artifactId>", "Module artifact ID in repository (e.g., power-crm-module-sales)").option("-w, --web-module-package <package>", "Web module package name (e.g., @powercrm/module-sales-web)").option("-m, --modules <codes>", "Modules to depend on, comma separated (e.g., quicksilver.org)").option("--module-menu <name>", "Create the module's top-level menu in the left nav, with this label").option("--no-module-menu", "Do not create a top-level menu").option("-y, --yes", "Skip prompts and use defaults").action(async (projectName, options) => {
+var program = new Command().name("create-qs").description("Create a new Quicksilver application").version("0.8.26", "-v, --version").argument("[project-name]", "Name of the project").option("-c, --module-code <code>", "Full module code (e.g., power_crm.sales)").option("-d, --module-directory <directory>", "Module directory name (e.g., sales)").option("-n, --module-namespace <code>", "Prefix of unit/table, defaults to the initials of the module code (e.g., pcs)").option("-p, --api-package <package>", "JVM package for Kotlin files (e.g., com.company.crm)").option("-a, --api-artifact-id <artifactId>", "Module artifact ID in repository (e.g., power-crm-module-sales)").option("-w, --web-module-package <package>", "Web module package name (e.g., @powercrm/module-sales-web)").option("-m, --modules <codes>", "Modules to depend on, comma separated (e.g., quicksilver.org)").option("--module-menu <name>", "Create the module's top-level menu in the left nav, with this label").option("--no-module-menu", "Do not create a top-level menu").option("--jsons-locale <locale>", "Language of the display texts in data files: zh-CN or zh-TW. Changing it later means rewriting every data file").option("-y, --yes", "Skip prompts and use defaults").action(async (projectName, options) => {
   applyPromptTexts();
   console.log(chalk4.cyan(`
 ${t("banner")}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-qs",
-  "version": "0.8.23",
+  "version": "0.8.26",
   "description": "Create a full-stack Quicksilver project with a single command",
   "type": "module",
   "bin": {

package/template/default/.quicksilver/manual/en-US/00-setup.md

@@ -117,7 +117,7 @@ power-crm/
 ├── modules/sales/              Business module, where most day-to-day development happens
 │   ├── module.yaml             Module identity: id, code, namespaces, dependencies, web package name
 │   ├── api/                    Backend (Kotlin + Spring Boot)
-│   │   └── data/init/          ← initial data: tables.jsons (optional), units/ (one file per unit) and rows/
+│   │   └── data/init/          ← initial data: tables.jsons (optional), units/ (one file per unit), rows/ and views.jsons (optional)
 │   └── web/                    Frontend (Preact + TypeScript)
 │       └── src/module.ts       Registry of pages, plugins, components, styles and icons
 ├── run/

package/template/default/.quicksilver/manual/zh-CN/00-setup.md

@@ -117,7 +117,7 @@ power-crm/
 ├── modules/sales/              业务模块，日常开发主要在此进行
 │   ├── module.yaml             模块标识，包括 id、code、namespaces、依赖、Web 包名
 │   ├── api/                    后端（Kotlin + Spring Boot）
-│   │   └── data/init/          ← 初始化数据：tables.jsons（可选）、units/（每个单元一个文件）与 rows/
+│   │   └── data/init/          ← 初始化数据：tables.jsons（可选）、units/（每个单元一个文件）、rows/ 与 views.jsons（可选）
 │   └── web/                    前端（Preact + TypeScript）
 │       └── src/module.ts       页面、插件、组件、样式、图标的注册表
 ├── run/

package/template/default/.quicksilver/manual/zh-TW/00-setup.md

@@ -117,7 +117,7 @@ power-crm/
 ├── modules/sales/              業務模組，日常開發主要在此進行
 │   ├── module.yaml             模組識別，包括 id、code、namespaces、相依、Web 套件名稱
 │   ├── api/                    後端（Kotlin + Spring Boot）
-│   │   └── data/init/          ← 初始化資料：tables.jsons（可選）、units/（每個單元一個檔案）與 rows/
+│   │   └── data/init/          ← 初始化資料：tables.jsons（可選）、units/（每個單元一個檔案）、rows/ 與 views.jsons（可選）
 │   └── web/                    前端（Preact + TypeScript）
 │       └── src/module.ts       頁面、外掛、元件、樣式、圖示的註冊表
 ├── run/

package/template/default/AGENTS.md

@@ -105,6 +105,7 @@ Project scripts (see `scripts` in `package.json`; the database dialect scripts l
 ```bash
 pnpm dev                    # Full dev environment (API + web), ports 6286 / 6288
 pnpm dev:h2                 # A second, isolated instance (own database and Atomikos directory)
+pnpm dev:fresh              # A separate instance (ports 6280 / 6281) whose own database is rebuilt from init and demo data at every start
 pnpm build                  # Full build (backend + frontend)
 pnpm test:api               # Backend tests
 pnpm lint                   # ESLint (pnpm lint:fix to autofix)
@@ -175,16 +176,17 @@ you are unsure what a target would actually do.
 **An AI agent starts `pnpm dev:h2`, never `pnpm dev`.**
 
 `pnpm dev` (web 6286 / api 6288) belongs to the person you are working with. It may well be running
-already, and it is backed by the H2 file database `run/api/local/data/h2/database1`, which keeps
+already, and it is backed by the H2 file database `run/api/local/data/h2/dev`, which keeps
 their data between starts: with `auto-init.draft-sync: true`, every start runs the upgrade drafts that
 changed since the last one. Starting or restarting it yourself interrupts them and runs your
 half-finished drafts against their data, so taking it over does not just steal a port.
 
-`pnpm dev:h2` (6210 / 6211) is the isolated instance: its own database (`database2`), its own log
+`pnpm dev:h2` (6210 / 6211) is the isolated instance: its own database (`h2`), its own log
 directory and its own Atomikos directory, so it can run side by side with theirs. The other dialect
 scripts (`dev:postgresql` 6220/6221, `dev:mariadb` 6230/6231, `dev:mssql` 6240/6241, `dev:oracle`
 6250/6251) are equally isolated, but they need a real server: fill in the placeholders in
-`run/api/config/application-<dialect>.yaml` first.
+`run/api/config/application-<dialect>.yaml` first. `pnpm dev:fresh` (6280 / 6281) is isolated in the
+same way, on the H2 database `fresh`, which it drops and rebuilds from init and demo data at every start.
 
 Two more rules:
 
@@ -194,6 +196,9 @@ Two more rules:
   something in 9000–9999; if it is still taken, Vite fails outright — pick another.
 - **Stop the server you started.** Especially after Playwright: leaving it running holds the port
   and the database file.
+- **Rebuild when the database no longer matches the branch.** After switching branches, or when
+  earlier experiments left the database in a state you cannot explain, start once with
+  `pnpm dev:h2 --fresh`. Draft sync never undoes a change that was taken out of a draft.
 
 ## Signing in locally
 
@@ -219,22 +224,39 @@ The profile file is the source of truth for where the data actually lives. Read
 started) and take the datasource from there; note that paths in it are relative to `run/api`, which
 is the working directory of the API process.
 
-For the default H2 profiles that means a file — `run/api/local/data/h2/database1` for `pnpm dev`,
-`database2` for `pnpm dev:h2` — which you can open with any H2 client. For the other dialects,
+For the default H2 profiles that means a file — `run/api/local/data/h2/dev` for `pnpm dev`,
+`h2` for `pnpm dev:h2` — which you can open with any H2 client. For the other dialects,
 connect with your usual client using the host, port, user and password from that same file.
 
 The development database is kept between starts. With `auto-init.draft-sync: true`, every start runs
 each module draft `data/upgrade/draft.jsons` that changed since the last start, and data entered by hand
-or through the UI stays. **Write every data change into the draft as well as into `data/init/`**: a
-change made only in `data/init/` reaches neither this database nor installed environments, and the
-startup log lists such files. The two do not always hold the same commands. A removal takes the rows
-out of `data/init/` and writes `$delete`, `@drop_column` or `@drop_table` into the draft. A fix to
-existing data, such as filling a new column, goes into the draft only. Changes to `data/demo/` stay
-out of the draft, since demo data runs on fresh installs only. Imperative commands in a draft (`@sql`,
+or through the UI stays. Data files follow four rules:
+
+1. **`data/init/` holds the final state.** A fresh install runs only `data/init/`.
+2. **The draft holds the rows you added or changed in `data/init/` this time.** `data/init/views.jsons`
+   is the exception: it never goes into the draft, since the platform converges the views to it on
+   every start. When a dropped or renamed column or table is used by one of those views, rewrite the
+   view's definition in `views.jsons` in the same change. A row nested in `$add` (the unit row, a field, a form item, a list field and so on)
+   goes into the draft as a standalone row carrying the id of its parent, for example a field row
+   with `unit_id`. A rename works the same way: write the new `table_name` or `column_name` in the
+   unit row or the field row, and the platform renames the table or the column.
+3. **What `data/init/` cannot express goes into the draft only.** That is removals (take the rows out
+   of `data/init/` and write `$delete`, `@drop_column` or `@drop_table` into the draft), fixes to
+   existing data such as filling a new column, `@alter_column` to shorten a column, change a default
+   or make a column of a plain table NOT NULL, and `@rename_table`, `@rename_column` and
+   `@alter_primary_key` for plain tables.
+4. **The platform does the rest.** That covers tables and columns, derived tables, indexes, i18n
+   views, dropping the views that depend on a changed table and rebuilding them afterwards, and the
+   references kept by name when something is renamed.
+
+A change made only in `data/init/` reaches neither this database nor installed environments, and the
+startup log lists such files. A mistake fails the precheck or the run, and the error says how to
+write it instead. Changes to `data/demo/` stay out of the draft, since demo data runs on fresh
+installs only. Imperative commands in a draft (`@sql`,
 `$update`, `$delete` ...) run once per `$key`; to run a changed one again, give it a new `$key`.
 `$place` is the exception: it runs again whenever its draft runs. To rebuild the database from the
-data files under `data/init/` and `data/demo/`, set `drop-first: true` in a profile override for one
-start, then set it back.
+data files under `data/init/` and `data/demo/`, add `--fresh` to the start command for one start
+(`pnpm dev:h2 --fresh`). It changes no config file, and the next start without it keeps the data again.
 
 ## Development skills
 

package/template/default/modules/{{MODULE_DIRECTORY}}/api/data/demo/README.md

@@ -5,7 +5,7 @@ This folder holds demo data, rows that exist only to show and test the product,
 - Put the rows in `.jsons` files in this folder or in subfolders of it. Other files, such as this README, are skipped.
 - On a fresh install of the module, the files run after everything in `data/init/`, sorted by name level by level with each subfolder run where it sorts, and they can refer to rows written there.
 - Development and test profiles load demo data, as set by `quicksilver.datasource.auto-init.demo-data` in `run/api/config/application-dev.yaml`. On a production install the installer asks first, and does not load it by default.
-- A module that is already installed never loads demo data. Draft sync does not run these files either, so an existing database does not pick up files added or changed here. To load them, set `drop-first: true` for one start, then set it back to `false`. The rebuild clears the whole development database, including rows entered through the UI.
+- A module that is already installed never loads demo data. Draft sync does not run these files either, so an existing database does not pick up files added or changed here. To load them, start once with `pnpm dev --fresh`, or add `--fresh` to the dialect script you use. The rebuild clears the whole development database, including rows entered through the UI.
 - Do not copy demo rows into `data/upgrade/draft.jsons`. Upgrades never load demo data.
 
 The rules for data files are in section 10 of [`.agents/skills/qs-jsons/references/json-command.md`](../../../../../.agents/skills/qs-jsons/references/json-command.md), and in the developer manual at [`.quicksilver/manual/en-US/06-data.md`](../../../../../.quicksilver/manual/en-US/06-data.md). Both are written by `pnpm install`.

package/template/default/package.json

@@ -10,6 +10,7 @@
   "scripts": {
     "// --- start dev servers -------------------------------------------": "",
     "dev": "quicksilver dev",
+    "dev:fresh": "PORT=6280 API_PORT=6281 SPRING_PROFILES_ACTIVE=dev,fresh quicksilver dev --fresh",
     "dev:h2": "PORT=6210 API_PORT=6211 SPRING_PROFILES_ACTIVE=dev,h2 quicksilver dev",
     "dev:postgresql": "PORT=6220 API_PORT=6221 SPRING_PROFILES_ACTIVE=dev,postgresql quicksilver dev",
     "dev:mariadb": "PORT=6230 API_PORT=6231 SPRING_PROFILES_ACTIVE=dev,mariadb quicksilver dev",

package/template/default/pnpm-workspace.yaml

@@ -25,13 +25,13 @@ catalogs:
   client:
     "@qs-charts/adapter-preact": "0.2.11"
     "@qs-charts/core": "0.2.11"
-    "@qs-elements/web": "1.0.158"
-    "@qs-elements/web-preact": "1.0.158"
+    "@qs-elements/web": "1.0.163"
+    "@qs-elements/web-preact": "1.0.163"
   quicksilver:
-    "@qs-platform/cli": "0.8.23"
-    "@qs-platform/preset-vite-web": "0.8.23"
-    "@qs-platform/web-module-core": "0.8.23"
-    "@qs-platform/web-module-org": "0.8.23"
+    "@qs-platform/cli": "0.8.26"
+    "@qs-platform/preset-vite-web": "0.8.26"
+    "@qs-platform/web-module-core": "0.8.26"
+    "@qs-platform/web-module-org": "0.8.26"
   tooling:
     "@types/node": "^26.4.0"
     "sass": "^1.103.1"

package/template/default/quicksilver.yaml

@@ -7,6 +7,14 @@ names:
   maven-group: {{API_PACKAGE}}
   maven-prefix: {{PROJECT_CODE}}
 
+i18n:
+  # Language of the display texts in data files, the same for every module of the project.
+  # Changing it later means rewriting every data file and translation table.
+  jsons-locale: {{JSONS_LOCALE}}
+  # Languages the product supports. Installations pick the product language from them.
+  # Add zh-CN, zh-TW or en-US once data/i18n.tsv of every module carries its translations.
+  locales: [{{JSONS_LOCALE}}]
+
 packaging:
   archive-name: {{PROJECT_CODE}}
   fixed-modules: [{{PLATFORM_MODULE_CODES_QUOTED}}, '{{MODULE_CODE}}']

package/template/default/run/api/config/README.md

@@ -33,7 +33,7 @@ database after this project — a project called `power-crm` gets `power_crm_dev
 Quicksilver products can share one database server without colliding. Two files sit outside that
 rule: Oracle, whose "database" is a PDB with a name fixed by the container image (`FREEPDB1`), and
 the H2 profiles, whose databases are plain files under this project's own `local/data/h2/`
-(`database1` for `dev`, `database2` for `dev:h2`) and so have nothing to collide with. The
+(`dev` for `pnpm dev`, `h2` for `pnpm dev:h2`) and so have nothing to collide with. The
 datasource list is replaced as a whole, so when you change one entry, keep the other one listed
 as well.
 
@@ -60,16 +60,28 @@ dialects. Every other dialect listed above ships with its driver.
 
 The `dev` profile turns on `draft-sync` and turns off `drop-first`. Every start runs the upgrade
 drafts that changed since the last start, and keeps the data already in the dev database. To
-rebuild the database from init and demo data, set `drop-first: true` for one start and then set it
-back. Switching `draft-sync` on or off also needs one such rebuild: the two modes record drafts
-differently, and startup refuses a database built in the other mode.
+rebuild the database from init and demo data, start once with `pnpm dev --fresh`, or add `--fresh` to
+a dialect script, as in `pnpm dev:h2 --fresh`. The option turns `drop-first` on for that start only
+and changes no config file. Switching `draft-sync` on or off also needs one such rebuild: the two
+modes record drafts differently, and startup refuses a database built in the other mode.
+`drop-first` is refused outside development mode, so a production configuration that turns it on
+fails at startup.
+
+## Views
+
+The views a module declares in `data/init/views.jsons` are synced on every start: missing views are
+created, views whose definition changed are replaced, and views taken out of the file are dropped.
+When a view fails to build, for example because its definition uses a column that no longer exists,
+startup fails by default, and the error names the module, the view, the definition and the reason
+given by the database. Set `quicksilver.datasource.fail-on-view-sync-error: false` to log the error
+and start anyway. The view and the views that depend on it then stay missing until a later start
+builds them.
 
 ## Local edits
 
 `application-dev.yaml` is committed, but **by convention your local edits to it are not** — a
-different database host, `drop-first` turned on for a rebuild, a different
-`fail-on-unregistered-data-source`. Commit it only when you are deliberately changing the team
-default, and say so in the commit message.
+different database host, a different `fail-on-unregistered-data-source`. Commit it only when you
+are deliberately changing the team default, and say so in the commit message.
 
 For an override that never enters version control, point `QUICKSILVER_CONFIG_LOCATION` at a config
 directory of your own: it is appended to the tail of `spring.config.location`, so it wins over

package/template/default/run/api/config/application-dev.yaml

@@ -10,11 +10,11 @@ quicksilver:
     # Keep the quotes around passwords: special characters (# : @ ...) then paste in as is.
     items:
       - code: metadata
-        url: "jdbc:h2:./local/data/h2/database1;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
+        url: "jdbc:h2:./local/data/h2/dev;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
         user: sa
         password: "sa"
       - code: business
-        url: "jdbc:h2:./local/data/h2/database1;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
+        url: "jdbc:h2:./local/data/h2/dev;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
         user: sa
         password: "sa"
     # Each ac_table row records the datasource its table lives in. When a row names a code that is
@@ -27,15 +27,16 @@ quicksilver:
       # only when quicksilver.application.mode is development. In production the installer does it.
       enabled: true
       # Drop the tables and views that Quicksilver manages before provisioning, so the database is
-      # rebuilt from init and demo data. Set drop-first: true for one start, then set it back to false.
+      # rebuilt from init and demo data. Keep it false here. To rebuild, start once with
+      # `pnpm dev --fresh`, or add --fresh to a dialect script, which turns it on for that start only.
       drop-first: false
       # Draft sync. Every start runs the upgrade drafts that changed since the last start. Data in
       # the dev database is kept, including rows entered through the UI. Switching draft-sync on or
-      # off needs one rebuild with drop-first.
+      # off needs one rebuild with --fresh.
       draft-sync: true
       # Demo data: on a fresh install of a module, the .jsons files in its data/demo/ run after its
       # init. A database that already exists does not pick up demo files added later, rebuild it with
-      # drop-first as described above.
+      # --fresh as described above.
       demo-data: true
   webhook:
     # Webhook targets that resolve to a private or loopback address (10.0.0.0/8, 127.0.0.0/8, ...)

package/template/default/run/api/config/application-fresh.yaml

@@ -0,0 +1,23 @@
+#
+# Overlay for the `fresh` profile used by `pnpm dev:fresh`: only the keys that differ from
+# application-dev.yaml, everything else is inherited key by key. It has a database of its own, which
+# the script drops and rebuilds from init and demo data at every start, so the `pnpm dev` database
+# is never touched.
+#
+logging:
+  file.path: local/log/application/fresh
+
+quicksilver:
+  datasource:
+    # Keep the quotes around passwords: special characters (# : @ ...) then paste in as is.
+    items:
+      - code: metadata
+        url: "jdbc:h2:./local/data/h2/fresh;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
+        user: sa
+        password: "sa"
+      - code: business
+        url: "jdbc:h2:./local/data/h2/fresh;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
+        user: sa
+        password: "sa"
+    atomikos:
+      log_base_dir: local/log/atomikos/fresh

package/template/default/run/api/config/application-h2.yaml

@@ -11,11 +11,11 @@ quicksilver:
     # Keep the quotes around passwords: special characters (# : @ ...) then paste in as is.
     items:
       - code: metadata
-        url: "jdbc:h2:./local/data/h2/database2;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
+        url: "jdbc:h2:./local/data/h2/h2;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
         user: sa
         password: "sa"
       - code: business
-        url: "jdbc:h2:./local/data/h2/database2;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
+        url: "jdbc:h2:./local/data/h2/h2;DB_CLOSE_ON_EXIT=FALSE;DATABASE_TO_UPPER=false;MODE=MySQL"
         user: sa
         password: "sa"
     atomikos: