767 improve vite plugin build strategy

documentation/docs/develop/writing-functions.md

@@ -72,13 +72,17 @@ Functions can return any value that can be [(de)serialized](./data-sharing.md#au
 
 ### Arrow functions
 
-Arrow functions are supported, but come with an important limitation. Jitar uses the function's `this` to pass context information (headers) for creating remote calls. Array functions do not have a `this` and can't provide any context.
+Arrow functions are NOT supported by the segmentation system, but can be safely used inside a segment.
 
 ```ts
-export const sayHello = (name: string) => { /* … */ };
+// src/domain/sayHello.ts
+export const sayHello = async (name: string): Promise<string> =>
+{
+    return `Hello, ${name}!`;
+};
 ```
 
-This example works with the default Jitar setup, but will break when using [middleware](./middleware) that sets additional headers like authorization. To avoid this we recommend using normal functions in any situation.
+Trying to segment this function results into an error a build level.
 
 ### Importing and calling
 

documentation/docs/fundamentals/building-blocks.md

@@ -41,7 +41,7 @@ To ensure your application can be broken into segments and keeps working after d
 1. Must be exported (named or as default)
 1. Must be stateless / pure (don't depend on global values)
 
-As long as you follow these rules, all will be fine. One thing to keep in mind is that arrow functions are supported, but can only be safely used in a non-distributed context. Meaning that the function does not call another function that might be in another segment. Besides that, we don't like to mix styles and recommend writing normal functions in any case.
+As long as you follow these rules, all will be fine. One thing to keep in mind is that arrow functions are NOT supported for segmentation. Besides that, we don't like to mix styles and recommend writing normal functions in any case.
 
 More in depth information on writing functions and the rules can be found in the [DEVELOP section](../develop/writing-functions).
 

documentation/docs/integrate/vite-plugin.md

@@ -43,9 +43,10 @@ const JITAR_SEGMENTS = ['frontend'];
 const JITAR_MIDDLEWARES = ['./requesterMiddleware'];
 
 const jitarConfig: JitarConfig = {
-  sourceDir: 'src',
-  targetDir: 'dist',
-  jitarDir: 'domain',
+  projectRoot: '../../',
+  sourceRoot: '../',
+  configurationFile: './jitar.json',
+  environmentFile: './dev.env',
   jitarUrl: JITAR_URL,
   segments: JITAR_SEGMENTS,
   middleware: JITAR_MIDDLEWARES
@@ -63,11 +64,12 @@ export default defineConfig({
 });
 ``` 
 
-The plugin configuration has 6 parameters:
+The plugin configuration has 5 parameters:
 
-1. sourceDir - The directory of the app source files. In most cases this is the `src` folder.
-1. targetDir - The directory of the output folder of the Vite build. This is the folder that Jitar uses as input for creating its cache.
-1. jitarDir - The directory of the source files used by Jitar. This path is relative to the source root. We like to use `domain` (which points to `src/domain`), but feel free to use something else.
+1. projectRoot - The root directory of the the project relative to the Vite configuration.
+1. sourceRoot - The source directory relative to the Vite configuration.
+1. configurationFile - The Jitar configuration file relative to the project root. Jitar uses `./jitar.json` by default.
+1. environmentFile - The environment file relative to the project root. Is only loaded when configured.
 1. jitarUrl - The URL of the Jitar instance. Jitar uses by default `http://localhost:3000`, but can be configured differently.
 1. segments - The segments to use for the client app. This is an array of strings. The default is an empty array.
 1. middlewares - The middlewares to use for calling remote procedures. This is an array of strings. The default is an empty array.

examples/access-protection/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }

examples/data-transportation/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }

examples/error-handling/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }

examples/health-checks/tsconfig.json

@@ -1,15 +1,9 @@
 {
+  "extends": "../../tsconfig.json",
   "compilerOptions":
   {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": ["cache", "dist", "node_modules"]
-}
+  "include": ["./src"]
+}

examples/hello-world/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }

examples/load-balancing/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }

examples/middleware/tsconfig.json

@@ -1,15 +1,9 @@
 {
+  "extends": "../../tsconfig.json",
   "compilerOptions":
   {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": ["cache", "dist", "node_modules"]
-}
+  "include": ["./src"]
+}

examples/multi-version/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }

examples/resources/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }

examples/segmentation/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "es2022",
-    "rootDir": "./src/",
-    "moduleResolution": "node",
-    "outDir": "./dist",
-    "removeComments": true,
-    "forceConsistentCasingInFileNames": true,
-    "strict": true,
-    "skipLibCheck": true
+  "extends": "../../tsconfig.json",
+  "compilerOptions":
+  {
+    "rootDir": "./src",
+    "outDir": "./dist"
   },
-  "exclude": [
-    "cache",
-    "dist",
-    "node_modules",
-    "segments"
-  ]
+  "include": ["./src"]
 }