create-procode 1.0.0 → 1.1.0

package/src/deps.mjs

@@ -1,195 +1,208 @@
-/**
- * Dependency set for a generated ProCode app.
- *
- * By default the CLI resolves it at scaffold time with resolveDependencySet():
- * the newest published version of each ProCode package, plus the peers and
- * bundled packages THOSE versions declare — so an app scaffolded after a
- * library release gets that release and the peers it was built against, with
- * no generator update. The constants below are the fallback (--no-latest, or
- * the registry is unreachable): the set verified against a running ProCode
- * host app (vsbackoffice / WorksLogicERP, 2026-10-08) at core 2.5.0 /
- * kendo-widget 2.11.0 / vs-template 2.13.1 / vs-theme 2.6.0.
- *
- * Three rules encoded here, each of which is a hard failure if broken:
- *
- *  1. React stays on 18. All three runtime libraries declare `react ^18.2.0`
- *     as a peer; React 19 installs cleanly and then fails at runtime.
- *  2. `react-redux` stays on 8.x. On 9.x you get two Provider contexts, the
- *     core's store becomes invisible to your components, and every screen
- *     renders blank with nothing in the console.
- *  3. `@progress/kendo-theme-default` is a MISSING peer declaration, not an
- *     optional extra — the widget library's SCSS imports it by name, so
- *     leaving it out is a hard build failure on the first `npm run dev`.
- */
-
-/** The four ProCode packages. */
-export const PROCODE = {
-  "procode-lowcode-core": "^2.5.0",
-  "procode-lowcode-kendo-widget": "^2.11.0",
-  "procode-vs-template": "^2.13.1",
-  "procode-vs-theme": "^2.6.0",
-};
-
-/** Every peer the four packages declare. peerDependenciesMeta is empty on all
- *  four — nothing here is optional. */
-export const DECLARED_PEERS = {
-  react: "^18.2.0",
-  "react-dom": "^18.2.0",
-  "react-router-dom": "^6.22.3",
-  axios: "^1.6.7",
-  "@progress/kendo-data-query": "^1.7.1",
-  "@progress/kendo-svg-icons": "^4.5.0",
-  "@progress/kendo-react-buttons": "^12.1.0",
-  "@progress/kendo-react-charts": "^12.1.0",
-  "@progress/kendo-react-common": "^12.1.0",
-  "@progress/kendo-react-conversational-ui": "^12.1.0",
-  "@progress/kendo-react-data-tools": "^12.1.0",
-  "@progress/kendo-react-dateinputs": "^12.1.0",
-  "@progress/kendo-react-dialogs": "^12.1.0",
-  "@progress/kendo-react-dropdowns": "^12.1.0",
-  "@progress/kendo-react-editor": "^12.1.0",
-  "@progress/kendo-react-gauges": "^12.1.0",
-  "@progress/kendo-react-grid": "^12.1.0",
-  "@progress/kendo-react-inputs": "^12.1.0",
-  "@progress/kendo-react-layout": "^12.1.0",
-  "@progress/kendo-react-listview": "^12.1.0",
-};
-
-/** Required at runtime or build time, but NOT declared as a peer by anything. */
-export const UNDECLARED_BUT_REQUIRED = {
-  "@progress/kendo-theme-default": "^12.1.0",
-  "@progress/kendo-licensing": "^1.11.3",
-  "@progress/kendo-react-labels": "^12.1.0",
-  "@progress/kendo-intl": "^3.1.1",
-  "react-toastify": "^11.0.5",
-  sass: "^1.38.0",
-};
-
-export const DEV_DEPS = {
-  // vite.config.ts imports node:url.
-  "@types/node": "^24.9.2",
-  "@types/react": "^18.2.43",
-  "@types/react-dom": "^18.2.17",
-  "@vitejs/plugin-react": "^4.2.1",
-  typescript: "^5.2.2",
-  vite: "^5.2.0",
-};
-
-export const LINT_DEV_DEPS = {
-  eslint: "^8.57.0",
-  "@typescript-eslint/eslint-plugin": "^7.2.0",
-  "@typescript-eslint/parser": "^7.2.0",
-  "eslint-plugin-react-hooks": "^4.6.0",
-  "eslint-plugin-react-refresh": "^0.4.6",
-};
-
-/** Bundled INSIDE the libraries. Listed for documentation only — do not add
- *  them to a generated package.json, and never bump them independently. */
-export const BUNDLED_DO_NOT_ADD = {
-  "procode-lowcode-core": {
-    "@reduxjs/toolkit": "^1.9.1",
-    "react-redux": "^8.0.5",
-    "redux-saga": "^1.2.3",
-    uuid: "^11.1.1",
-  },
-  "procode-lowcode-kendo-widget": { lodash: "^4.17.21", uuid: "^11.1.1" },
-  "procode-vs-template": {
-    lodash: "^4.17.21",
-    "react-beautiful-dnd": "^13.1.1",
-    uuid: "^11.1.1",
-  },
-  "procode-vs-theme": {},
-};
-
-const sortKeys = (obj) =>
-  Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
-
-/** The tested set, used with --no-latest or when the registry is unreachable. */
-export const PINNED_SET = {
-  procode: PROCODE,
-  peers: DECLARED_PEERS,
-  extras: UNDECLARED_BUT_REQUIRED,
-  bundled: BUNDLED_DO_NOT_ADD,
-  source: "pinned",
-};
-
-/** Lowest version a range admits, as [major, minor, patch]; [0,0,0] if none. */
-const floorOf = (range) => (String(range).match(/(\d+)\.(\d+)\.(\d+)/) ?? [0, 0, 0, 0]).slice(1).map(Number);
-const newer = (a, b) => {
-  const [x, y] = [floorOf(a), floorOf(b)];
-  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] > y[i] ? a : b;
-  return a;
-};
-
-/**
- * Ask the registry for the newest published version of each ProCode package,
- * and derive everything else from those manifests:
- *
- *   peers   every peerDependency the four declare; where two declare the same
- *           peer, the range with the higher floor wins (vs-template wants
- *           react-router-dom ^6.22.3 where core wants ^6.6.1).
- *   extras  required but undeclared. kendo-theme-default and kendo-react-labels
- *           follow the kendo-react range the widget library declares — the
- *           theme's major must match the components' major. The rest stay on
- *           their tested pins.
- *   bundled each package's own dependencies, for the _procodeBundled note.
- *
- * Uses the registry npm/npx was invoked with (npm_config_registry), so a
- * mirror or proxy registry is honoured. Throws on any failure; the caller
- * falls back to PINNED_SET.
- */
-export async function resolveDependencySet({ registry, timeoutMs = 10000 } = {}) {
-  const base = String(registry || process.env.npm_config_registry || "https://registry.npmjs.org/").replace(/\/?$/, "/");
-
-  const manifests = await Promise.all(
-    Object.keys(PROCODE).map(async (name) => {
-      const res = await fetch(base + name.replace("/", "%2f") + "/latest", {
-        headers: { accept: "application/json" },
-        signal: AbortSignal.timeout(timeoutMs),
-      });
-      if (!res.ok) throw new Error(name + ": HTTP " + res.status + " from " + base);
-      const manifest = await res.json();
-      if (typeof manifest?.version !== "string") throw new Error(name + ": no version in the registry response");
-      return manifest;
-    }),
-  );
-
-  const procode = {};
-  const peers = {};
-  const bundled = {};
-  for (const m of manifests) {
-    procode[m.name] = "^" + m.version;
-    bundled[m.name] = m.dependencies ?? {};
-    for (const [peer, range] of Object.entries(m.peerDependencies ?? {})) {
-      peers[peer] = peers[peer] ? newer(peers[peer], range) : range;
-    }
-  }
-
-  const extras = { ...UNDECLARED_BUT_REQUIRED };
-  const kendoReact = Object.entries(peers).find(([n]) => n.startsWith("@progress/kendo-react-"))?.[1];
-  if (kendoReact) {
-    extras["@progress/kendo-theme-default"] = kendoReact;
-    extras["@progress/kendo-react-labels"] = kendoReact;
-  }
-
-  return { procode, peers, extras, bundled, source: "latest" };
-}
-
-/** `set` is PINNED_SET or what resolveDependencySet() returned. */
-export function buildDependencies(set = PINNED_SET) {
-  return sortKeys({ ...set.procode, ...set.peers, ...set.extras });
-}
-
-/**
- * The React type packages follow the React major the libraries declare, so a
- * future move off React 18 does not leave @types/react behind.
- */
-export function buildDevDependencies({ lint = true, set = PINNED_SET } = {}) {
-  const devDeps = { ...DEV_DEPS, ...(lint ? LINT_DEV_DEPS : {}) };
-  const reactMajor = floorOf(set.peers.react ?? "")[0];
-  if (reactMajor && reactMajor !== floorOf(DEV_DEPS["@types/react"])[0]) {
-    devDeps["@types/react"] = "^" + reactMajor + ".0.0";
-    devDeps["@types/react-dom"] = "^" + reactMajor + ".0.0";
-  }
-  return sortKeys(devDeps);
-}
+/**
+ * Dependency set for a generated ProCode app.
+ *
+ * By default the CLI resolves it at scaffold time with resolveDependencySet():
+ * the newest published version of each ProCode package, plus the peers and
+ * bundled packages THOSE versions declare — so an app scaffolded after a
+ * library release gets that release and the peers it was built against, with
+ * no generator update. The constants below are the fallback (--no-latest, or
+ * the registry is unreachable): the set verified against a running ProCode
+ * host app (vsbackoffice / WorksLogicERP, 2026-10-28) at core 2.5.2 /
+ * kendo-widget 3.0.0 / vs-template 2.14.1 / vs-theme 2.6.1 — KendoReact 16.2.0
+ * with kendo-theme-default 14.7.0, and react-router-dom 7.
+ *
+ * Three rules encoded here, each of which is a hard failure if broken:
+ *
+ *  1. React stays on 18. All three runtime libraries declare `react ^18.2.0`
+ *     as a peer; React 19 installs cleanly and then fails at runtime.
+ *  2. `react-redux` stays on 8.x. On 9.x you get two Provider contexts, the
+ *     core's store becomes invisible to your components, and every screen
+ *     renders blank with nothing in the console.
+ *  3. `@progress/kendo-theme-default` is a MISSING peer declaration, not an
+ *     optional extra — the widget library's SCSS imports it by name, so
+ *     leaving it out is a hard build failure on the first `npm run dev`.
+ */
+
+/** The four ProCode packages. */
+export const PROCODE = {
+  "procode-lowcode-core": "^2.7.0",
+  "procode-lowcode-kendo-widget": "^3.2.0",
+  "procode-vs-template": "^2.15.1",
+  "procode-vs-theme": "^2.7.1",
+};
+
+/** Every peer the four packages declare. peerDependenciesMeta is empty on all
+ *  four — nothing here is optional. */
+export const DECLARED_PEERS = {
+  react: "^18.2.0",
+  "react-dom": "^18.2.0",
+  "react-router-dom": "^6.22.3 || ^7.18.0",
+  axios: "^1.6.7",
+  "@progress/kendo-data-query": "^1.7.2",
+  "@progress/kendo-svg-icons": "^4.9.0 || ^5.0.0",
+  "@progress/kendo-react-buttons": "^16.2.0",
+  "@progress/kendo-react-charts": "^16.2.0",
+  "@progress/kendo-react-common": "^16.2.0",
+  "@progress/kendo-react-conversational-ui": "^16.2.0",
+  "@progress/kendo-react-data-tools": "^16.2.0",
+  "@progress/kendo-react-dateinputs": "^16.2.0",
+  "@progress/kendo-react-dialogs": "^16.2.0",
+  "@progress/kendo-react-dropdowns": "^16.2.0",
+  "@progress/kendo-react-editor": "^16.2.0",
+  "@progress/kendo-react-gauges": "^16.2.0",
+  "@progress/kendo-react-grid": "^16.2.0",
+  "@progress/kendo-react-inputs": "^16.2.0",
+  "@progress/kendo-react-intl": "^16.2.0",
+  "@progress/kendo-react-layout": "^16.2.0",
+  "@progress/kendo-react-listview": "^16.2.0",
+  "@progress/kendo-react-popup": "^16.2.0",
+  "@progress/kendo-react-upload": "^16.2.0",
+};
+
+/** Required at runtime or build time, but NOT declared as a peer by anything. */
+export const UNDECLARED_BUT_REQUIRED = {
+  // NOT the KendoReact major: from KendoReact 13 the theme versions apart
+  // (KendoReact 16.2 ships against theme 14.7, and no theme 16 exists).
+  "@progress/kendo-theme-default": "^14.7.0",
+  // A peer of kendo-react-grid 16 that nothing in ProCode declares.
+  "@progress/kendo-csv": "^1.0.0",
+  "@progress/kendo-licensing": "^1.11.3",
+  "@progress/kendo-react-labels": "^16.2.0",
+  "@progress/kendo-intl": "^3.2.1",
+  "react-toastify": "^11.0.5",
+  sass: "^1.38.0",
+};
+
+export const DEV_DEPS = {
+  // vite.config.ts imports node:url.
+  "@types/node": "^24.9.2",
+  "@types/react": "^18.2.43",
+  "@types/react-dom": "^18.2.17",
+  "@vitejs/plugin-react": "^4.2.1",
+  typescript: "^5.2.2",
+  vite: "^5.2.0",
+};
+
+/** `npm test`. vitest 1.x is the line that runs on Vite 5 (DEV_DEPS.vite). */
+export const TEST_DEV_DEPS = {
+  vitest: "^1.6.0",
+};
+
+export const LINT_DEV_DEPS = {
+  eslint: "^8.57.0",
+  "@typescript-eslint/eslint-plugin": "^7.2.0",
+  "@typescript-eslint/parser": "^7.2.0",
+  "eslint-plugin-react-hooks": "^4.6.0",
+  "eslint-plugin-react-refresh": "^0.4.6",
+};
+
+/** Bundled INSIDE the libraries. Listed for documentation only — do not add
+ *  them to a generated package.json, and never bump them independently. */
+export const BUNDLED_DO_NOT_ADD = {
+  "procode-lowcode-core": {
+    "@reduxjs/toolkit": "^1.9.1",
+    "react-redux": "^8.0.5",
+    "redux-saga": "^1.2.3",
+    uuid: "^11.1.1",
+  },
+  "procode-lowcode-kendo-widget": { lodash: "^4.17.21", uuid: "^11.1.1" },
+  "procode-vs-template": {
+    lodash: "^4.17.21",
+    "react-beautiful-dnd": "^13.1.1",
+    uuid: "^11.1.1",
+  },
+  "procode-vs-theme": {},
+};
+
+const sortKeys = (obj) =>
+  Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+
+/** The tested set, used with --no-latest or when the registry is unreachable. */
+export const PINNED_SET = {
+  procode: PROCODE,
+  peers: DECLARED_PEERS,
+  extras: UNDECLARED_BUT_REQUIRED,
+  bundled: BUNDLED_DO_NOT_ADD,
+  source: "pinned",
+};
+
+/** Lowest version a range admits, as [major, minor, patch]; [0,0,0] if none. */
+const floorOf = (range) => (String(range).match(/(\d+)\.(\d+)\.(\d+)/) ?? [0, 0, 0, 0]).slice(1).map(Number);
+const newer = (a, b) => {
+  const [x, y] = [floorOf(a), floorOf(b)];
+  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] > y[i] ? a : b;
+  return a;
+};
+
+/**
+ * Ask the registry for the newest published version of each ProCode package,
+ * and derive everything else from those manifests:
+ *
+ *   peers   every peerDependency the four declare; where two declare the same
+ *           peer, the range with the higher floor wins (vs-template wants
+ *           react-router-dom ^6.22.3 where core wants ^6.6.1).
+ *   extras  required but undeclared. kendo-react-labels follows the
+ *           kendo-react range the widget library declares (KendoReact 16 wants
+ *           exact siblings). kendo-theme-default does NOT: its major stopped
+ *           tracking KendoReact's at 13, so it stays on its tested pin and is
+ *           bumped by hand with the widget library. The rest stay pinned too.
+ *   bundled each package's own dependencies, for the _procodeBundled note.
+ *
+ * Uses the registry npm/npx was invoked with (npm_config_registry), so a
+ * mirror or proxy registry is honoured. Throws on any failure; the caller
+ * falls back to PINNED_SET.
+ */
+export async function resolveDependencySet({ registry, timeoutMs = 10000 } = {}) {
+  const base = String(registry || process.env.npm_config_registry || "https://registry.npmjs.org/").replace(/\/?$/, "/");
+
+  const manifests = await Promise.all(
+    Object.keys(PROCODE).map(async (name) => {
+      const res = await fetch(base + name.replace("/", "%2f") + "/latest", {
+        headers: { accept: "application/json" },
+        signal: AbortSignal.timeout(timeoutMs),
+      });
+      if (!res.ok) throw new Error(name + ": HTTP " + res.status + " from " + base);
+      const manifest = await res.json();
+      if (typeof manifest?.version !== "string") throw new Error(name + ": no version in the registry response");
+      return manifest;
+    }),
+  );
+
+  const procode = {};
+  const peers = {};
+  const bundled = {};
+  for (const m of manifests) {
+    procode[m.name] = "^" + m.version;
+    bundled[m.name] = m.dependencies ?? {};
+    for (const [peer, range] of Object.entries(m.peerDependencies ?? {})) {
+      peers[peer] = peers[peer] ? newer(peers[peer], range) : range;
+    }
+  }
+
+  const extras = { ...UNDECLARED_BUT_REQUIRED };
+  const kendoReact = Object.entries(peers).find(([n]) => n.startsWith("@progress/kendo-react-"))?.[1];
+  if (kendoReact) {
+    extras["@progress/kendo-react-labels"] = kendoReact;
+  }
+
+  return { procode, peers, extras, bundled, source: "latest" };
+}
+
+/** `set` is PINNED_SET or what resolveDependencySet() returned. */
+export function buildDependencies(set = PINNED_SET) {
+  return sortKeys({ ...set.procode, ...set.peers, ...set.extras });
+}
+
+/**
+ * The React type packages follow the React major the libraries declare, so a
+ * future move off React 18 does not leave @types/react behind.
+ */
+export function buildDevDependencies({ lint = true, tests = true, set = PINNED_SET } = {}) {
+  const devDeps = { ...DEV_DEPS, ...(lint ? LINT_DEV_DEPS : {}), ...(tests ? TEST_DEV_DEPS : {}) };
+  const reactMajor = floorOf(set.peers.react ?? "")[0];
+  if (reactMajor && reactMajor !== floorOf(DEV_DEPS["@types/react"])[0]) {
+    devDeps["@types/react"] = "^" + reactMajor + ".0.0";
+    devDeps["@types/react-dom"] = "^" + reactMajor + ".0.0";
+  }
+  return sortKeys(devDeps);
+}