create-qs 0.8.24 → 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.24");
+  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.24", "-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.24",
+  "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

@@ -230,12 +230,29 @@ connect with your usual client using the host, port, user and password from that
 
 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/`, add `--fresh` to the start command for one start

package/template/default/pnpm-workspace.yaml

@@ -28,10 +28,10 @@ catalogs:
     "@qs-elements/web": "1.0.163"
     "@qs-elements/web-preact": "1.0.163"
   quicksilver:
-    "@qs-platform/cli": "0.8.24"
-    "@qs-platform/preset-vite-web": "0.8.24"
-    "@qs-platform/web-module-core": "0.8.24"
-    "@qs-platform/web-module-org": "0.8.24"
+    "@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

@@ -64,6 +64,18 @@ rebuild the database from init and demo data, start once with `pnpm dev --fresh`
 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