@idevconn/create-icore 0.3.1 → 0.4.1

package/templates/libs/template-shared/src/lib/abilities/ability-provider.tsx

@@ -1,7 +1,7 @@
 import { AbilityProvider as CaslAbilityProvider, Can } from '@casl/react';
 import type { ReactNode } from 'react';
 import { useMemo } from 'react';
-import { defineAbilitiesFor, type AppAbility } from '@icore/shared';
+import { defineAbilitiesFor, type AppAbility } from '@icore/shared/client';
 import { useAuthStore } from '../stores/auth.store.js';
 
 export { Can };

package/templates/libs/vite-plugins/README.md

@@ -0,0 +1,7 @@
+# vite-plugins
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build vite-plugins` to build the library.

package/templates/libs/vite-plugins/eslint.config.mjs

@@ -0,0 +1,19 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: ['{projectRoot}/eslint.config.{js,cjs,mjs,ts,cts,mts}'],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/templates/libs/vite-plugins/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@icore/vite-plugins",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "main": "./src/index.mjs",
+  "types": "./src/index.d.mts",
+  "peerDependencies": {
+    "tslib": "^2.3.0",
+    "vite": "^8.0.0",
+    "vitest": "~4.1.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": false
+    }
+  }
+}

package/templates/libs/vite-plugins/project.json

@@ -0,0 +1,19 @@
+{
+  "name": "vite-plugins",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/vite-plugins/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/libs/vite-plugins",
+        "main": "libs/vite-plugins/src/index.ts",
+        "tsConfig": "libs/vite-plugins/tsconfig.lib.json",
+        "assets": ["libs/vite-plugins/*.md"]
+      }
+    }
+  }
+}

package/templates/libs/vite-plugins/src/index.d.mts

@@ -0,0 +1,21 @@
+import type { Plugin } from 'vite';
+import type { UserConfig } from 'vitest/config';
+
+export declare function noServerModulesPlugin(): Plugin;
+
+export declare function injectAppVersionPlugin(pkg: { version: string }): Plugin;
+
+export declare function commonDefines(pkg: {
+  version: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+}): Record<string, string>;
+
+export declare function commonManualChunks(
+  uiChunkFn?: (id: string) => string | undefined,
+): (id: string) => string | undefined;
+
+export declare function commonTestConfig(
+  name: string,
+  coverageDir: string,
+): NonNullable<UserConfig['test']>;

package/templates/libs/vite-plugins/src/index.mjs

@@ -0,0 +1,106 @@
+// @icore/vite-plugins — shared Vite plugin helpers for iCore client templates.
+// Plain ESM (no TypeScript syntax) so vite.config.mts can import it directly.
+
+const SERVER_ONLY_RE = /^(@nestjs\/|firebase-admin$|bullmq$|ioredis$)/;
+
+/**
+ * Fails the Vite build if server-only modules are imported in client code.
+ * @returns {import('vite').Plugin}
+ */
+export function noServerModulesPlugin() {
+  return {
+    name: 'no-server-modules',
+    enforce: 'pre',
+    resolveId(id, importer) {
+      if (SERVER_ONLY_RE.test(id)) {
+        throw new Error(
+          `Server-only module "${id}" imported in client code` +
+            (importer ? ` (from ${importer})` : '') +
+            `. Use @icore/shared/client instead of @icore/shared for browser-safe imports.`,
+        );
+      }
+    },
+  };
+}
+
+/**
+ * Replaces %APP_VERSION% in index.html with the root package.json version.
+ * @param {{ version: string }} pkg
+ * @returns {import('vite').Plugin}
+ */
+export function injectAppVersionPlugin(pkg) {
+  return {
+    name: 'inject-app-version-meta',
+    transformIndexHtml(html) {
+      return html.replace('%APP_VERSION%', pkg.version);
+    },
+  };
+}
+
+/**
+ * Returns Vite `define` entries shared by all iCore client templates.
+ * Each template spreads this and adds its own UI-lib-specific entry.
+ *
+ * @param {{ version: string, dependencies?: Record<string,string>, devDependencies?: Record<string,string> }} pkg
+ * @returns {Record<string, string>}
+ */
+export function commonDefines(pkg) {
+  const dep = (name) =>
+    JSON.stringify(pkg.dependencies?.[name] ?? pkg.devDependencies?.[name] ?? '?');
+  return {
+    'import.meta.env.VITE_APP_VERSION': JSON.stringify(pkg.version),
+    'import.meta.env.VITE_DEP_REACT': dep('react'),
+    'import.meta.env.VITE_DEP_VITE': dep('vite'),
+    'import.meta.env.VITE_DEP_TANSTACK_ROUTER': dep('@tanstack/react-router'),
+    'import.meta.env.VITE_DEP_TANSTACK_QUERY': dep('@tanstack/react-query'),
+    'import.meta.env.VITE_DEP_ZUSTAND': dep('zustand'),
+    'import.meta.env.VITE_DEP_CASL': dep('@casl/ability'),
+  };
+}
+
+/**
+ * Returns a manualChunks function with the common vendor splits pre-applied.
+ * Pass a `uiChunkFn` to add UI-library-specific splits before the fallback.
+ *
+ * @param {(id: string) => string | undefined} [uiChunkFn]
+ * @returns {(id: string) => string | undefined}
+ */
+export function commonManualChunks(uiChunkFn) {
+  return (id) => {
+    if (!id.includes('node_modules')) return undefined;
+    if (id.includes('/react/') || id.includes('/react-dom/') || id.includes('scheduler'))
+      return 'vendor-react';
+    if (id.includes('@tanstack')) return 'vendor-tanstack';
+    if (id.includes('i18next') || id.includes('react-i18next')) return 'vendor-i18n';
+    if (id.includes('@casl')) return 'vendor-casl';
+    if (uiChunkFn) {
+      const chunk = uiChunkFn(id);
+      if (chunk) return chunk;
+    }
+    if (id.includes('zustand')) return 'vendor-state';
+    if (id.includes('@idevconn')) return 'vendor-idevconn';
+    return 'vendor-core';
+  };
+}
+
+/**
+ * Returns a vitest `test` configuration block shared by all iCore client templates.
+ *
+ * @param {string} name  - project name (e.g. 'client-shadcn')
+ * @param {string} coverageDir - relative path to coverage output dir
+ * @returns {import('vitest/config').UserConfig['test']}
+ */
+export function commonTestConfig(name, coverageDir) {
+  return {
+    name,
+    watch: false,
+    globals: true,
+    environment: 'jsdom',
+    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory: coverageDir,
+      provider: 'v8',
+    },
+  };
+}

package/templates/libs/vite-plugins/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}

package/templates/libs/vite-plugins/tsconfig.lib.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/tsconfig.base.json

@@ -13,6 +13,7 @@
     "baseUrl": ".",
     "paths": {
       "@icore/shared": ["./libs/shared/src/index.ts"],
+      "@icore/shared/client": ["./libs/shared/src/client.ts"],
       "@icore/auth-supabase": ["./libs/auth-strategies/supabase/src/index.ts"],
       "@icore/auth-client": ["./libs/auth-client/src/index.ts"],
       "@icore/package.json": ["./package.json"],
@@ -27,7 +28,8 @@
       "@icore/db-firestore": ["./libs/db-strategies/firestore/src/index.ts"],
       "@icore/payment-client": ["./libs/payment-client/src/index.ts"],
       "@icore/notes-client": ["./libs/notes-client/src/index.ts"],
-      "@icore/jobs-client": ["./libs/jobs-client/src/index.ts"]
+      "@icore/jobs-client": ["./libs/jobs-client/src/index.ts"],
+      "@icore/vite-plugins": ["./libs/vite-plugins/src/index.d.mts"]
     }
   },
   "exclude": ["node_modules", "dist", ".nx"]