create-procode 0.0.0-stage → 1.0.0

package/templates/base/src/routes.ts.tmpl

@@ -0,0 +1,20 @@
+import type { CoreProps } from "procode-lowcode-core";
+
+/**
+ * Extra routes beside the core's own `<base>/:parentslug/*` and
+ * `section/:childslug/*`. Each renders the schema getSchemaBySlugService
+ * returns for its `customSlug`, so register that slug in src/Module/index.ts
+ * too, or the route shows the 404 screen.
+ *
+ *   parentSimblingRoutes  beside :parentslug     e.g. { path: "dashboard", customSlug: "home-dashboard" }
+ *   childSimblingRoutes   beside section/:childslug
+ *   childNestedRoutes     under the child route
+ *
+ * ("Simbling" is the library's spelling.) Module scope on purpose: a new object
+ * on any render rebuilds the router and remounts the whole app.
+ */
+export const customRoute: NonNullable<CoreProps["customRoute"]> = {
+  parentSimblingRoutes: [],
+  childSimblingRoutes: [],
+  childNestedRoutes: [],
+};

package/templates/base/src/vite-env.d.ts.tmpl

@@ -0,0 +1,20 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_APPLICATION_CODE: string;
+  readonly VITE_HOMEPAGE: string;
+  readonly VITE_CENTRAL_SERVICE_BASE_URL: string;
+  readonly VITE_PROJECT_ENVIROMENT: string;
+  readonly VITE_TOOL_BASE_URL: string;
+  readonly VITE_TOOL_SCHEMA_FETCH: string;
+  readonly VITE_AUTH_URL: string;
+  readonly VITE_BASE_LOGOUT_URL?: string;
+  readonly VITE_HEADER_SLUG: string;
+  readonly VITE_FOOTER_SLUG: string;
+  readonly VITE_NOTIFICATION_VISIBLE_DURATION?: string;
+  readonly VITE_HARDCODED_TOKEN?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/templates/base/tsconfig.json.tmpl

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": false,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "allowSyntheticDefaultImports": true,
+
+    /* Screens are imported .json files — required, not optional. */
+    "resolveJsonModule": true,
+
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "esModuleInterop": true,
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

package/templates/base/tsconfig.node.json.tmpl

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  },
+  "include": ["vite.config.ts"]
+}

package/templates/base/vite.config.ts.tmpl

@@ -0,0 +1,61 @@
+import { fileURLToPath } from "node:url";
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  // Must match VITE_HOMEPAGE in .env. The app is served from this segment, so a
+  // screen lives at <base>/<slug> — e.g. __BASE_PATH_SLASH__sample.
+  base: "__BASE_PATH_SLASH__",
+
+  plugins: [react()],
+
+  resolve: {
+    alias: [
+      {
+        // procode-lowcode-core exports "./styles" as src/Assets/styles/index.scss,
+        // but the package ships the folder as src/assets/. Windows and macOS
+        // ignore the case and build; Linux (CI, Docker) fails the @import. This
+        // points the import at the real path on every OS.
+        find: /^procode-lowcode-core\/styles$/,
+        replacement: fileURLToPath(
+          new URL("./node_modules/procode-lowcode-core/src/assets/styles/index.scss", import.meta.url),
+        ),
+      },
+    ],
+  },
+
+  build: {
+    // Must stay >= es2018. Object rest/spread is an ES2018 feature, and the
+    // es2015 downlevel transform miscompiles a `const` that declares two rest
+    // patterns at once — it drops bindings and emits a bare `{} = null`, which
+    // throws "Cannot destructure 'null' as it is null" at runtime. Kendo's
+    // CalendarCell.shouldComponentUpdate is written that way, so the date picker
+    // crashes on open in built bundles only — never in dev, which skips this
+    // transform. Do not lower this to chase bundle size.
+    target: "es2020",
+    minify: false,
+  },
+
+  esbuild: {
+    target: "es2020",
+  },
+
+  // The two runtime libraries ship CommonJS-interop shapes that Vite's dep
+  // scanner does not find on its own; pre-bundling them keeps dev reloads fast
+  // and avoids "outdated optimize dep" full-page reloads on every save.
+  optimizeDeps: {
+    include: ["procode-lowcode-kendo-widget", "procode-lowcode-core"],
+  },
+
+  // Some transitive dependencies still reference the Node `global`.
+  define: {
+    global: "globalThis",
+  },
+
+  server: {
+    fs: {
+      allow: ["..", "."],
+    },
+  },
+});