Merge branch 'next' of github.com:devforth/adminforth into next

Author: ivictbor

adminforth/commands/callTsProxy.js

@@ -3,18 +3,28 @@ import { spawn } from "child_process";
 import path from "path";
 import fs from "fs";
 import chalk from "chalk";
+import dotenv from "dotenv";
 
 const currentFilePath = import.meta.url;
 const currentFileFolder = path.dirname(currentFilePath).replace("file:", "");
 
 export function callTsProxy(tsCode, silent=false) {
 
+  const currentDirectory = process.cwd();
+  const envPath = path.resolve(currentDirectory, ".env");
+  const envLocalPath = path.resolve(currentDirectory, ".env.local");
+  if (fs.existsSync(envLocalPath)) {
+    dotenv.config({ path: envLocalPath, override: true });
+  }
+  if (fs.existsSync(envPath)) {
+    dotenv.config({ path: envPath, override: true });
+  }
+
   process.env.HEAVY_DEBUG && console.log("🌐 Calling tsproxy with code:", path.join(currentFileFolder, "proxy.ts"));
   return new Promise((resolve, reject) => {
-    const child = spawn("tsx", [
-      path.join(currentFileFolder, "proxy.ts")
-    ]);
-
+    const child = spawn("tsx", [path.join(currentFileFolder, "proxy.ts")], {
+      env: process.env,
+    });
     let stdout = "";
     let stderr = "";
 

adminforth/commands/createApp/templates/index.ts.hbs

@@ -3,7 +3,7 @@ import AdminForth from 'adminforth';
 import usersResource from "./resources/adminuser.js";
 import { fileURLToPath } from 'url';
 import path from 'path';
-
+ 
 const ADMIN_BASE_URL = '';
 
 export const admin = new AdminForth({

adminforth/dataConnectors/mongo.ts

@@ -69,6 +69,7 @@ class MongoConnector extends AdminForthBaseConnector implements IAdminForthDataS
             return Number.isInteger(value) ? 'integer' : 'float';
           }
           if (value instanceof Date) return 'datetime';
+          if (value && typeof value === 'object' && ('$numberDecimal' in value || value._bsontype === 'Decimal128')) return 'decimal';
           if (typeof value === 'object') return 'json';
           return 'string';
         }
@@ -89,13 +90,18 @@ class MongoConnector extends AdminForthBaseConnector implements IAdminForthDataS
               sampleValues.set(fullKey, value);
             }
 
-            if (
-              value instanceof Buffer ||
-              (value && typeof value === 'object' && (value as any)._bsontype === 'Decimal128')
-            ) {
+            if (value instanceof Buffer) {
               addType(fullKey, 'json');
               return;
             }
+            if (
+                value &&
+                typeof value === 'object' &&
+                ('$numberDecimal' in value || (value as any)._bsontype === 'Decimal128')
+              ) {
+              addType(fullKey, 'decimal');
+              return;
+            }
 
             if (
               value && 
@@ -104,9 +110,10 @@ class MongoConnector extends AdminForthBaseConnector implements IAdminForthDataS
               !(value instanceof Date)
             ) {
               addType(fullKey, 'json');
-            } else {
-              addType(fullKey, detectType(value));
+              return
             }
+        
+            addType(fullKey, detectType(value));
           });
         }
 
@@ -117,7 +124,7 @@ class MongoConnector extends AdminForthBaseConnector implements IAdminForthDataS
         return Array.from(fieldTypes.entries()).map(([name, types]) => {
           const primaryKey = name === '_id';
 
-          const priority = ['datetime', 'date', 'integer', 'float', 'boolean', 'json', 'string'];
+          const priority = ['datetime', 'date', 'integer', 'float', 'boolean', 'json', 'decimal',  'string'];
 
           const matched = priority.find(t => types.has(t)) || 'string';
 
@@ -129,8 +136,8 @@ class MongoConnector extends AdminForthBaseConnector implements IAdminForthDataS
             datetime: 'DATETIME',
             date: 'DATE',
             json: 'JSON',
+            decimal: 'DECIMAL',
           };
-      
           return {
             name,
             type: typeMap[matched] ?? 'STRING',

adminforth/documentation/blog/2024-10-01-ai-blog/index.md

@@ -199,7 +199,7 @@ model ContentImage {
 Create a migration:
 
 ```bash
-npm run makemigration -- --name add-posts && npm run migrate:local
+npm run makemigration -- --name add-posts ; npm run migrate:local
 ```
 
 

adminforth/documentation/docs/tutorial/001-gettingStarted.md

@@ -89,7 +89,7 @@ This will create a migration file in `migrations` and apply it to the database.
 In future, when you need to add new resources, you need to modify `schema.prisma` (add models, change fields, etc.). After doing any modification you need to create a new migration using next command:
 
 ```bash
-npm run makemigration -- --name init && npm run migrate:local
+npm run makemigration -- --name init ; npm run migrate:local
 ```
 
 Other developers need to pull migration and run `npm run migrateLocal` to apply any unapplied migrations.
@@ -173,7 +173,7 @@ model apartments {
 Run the following command to create a new migration:
 
 ```bash
-npm run makemigration -- --name add-apartments && npm run migrate:local
+npm run makemigration -- --name add-apartments ; npm run migrate:local
 ```
 
 ### Step3. Create the `apartments` resource

adminforth/documentation/docs/tutorial/01-helloWorld.md

@@ -122,7 +122,7 @@ model Post {
 Create database using `prisma migrate`:
 
 ```bash
-npm run makemigration --name init && npm run migrate:local
+npm run makemigration --name init ; npm run migrate:local
 ```
 
 ## Setting up AdminForth

adminforth/documentation/docs/tutorial/03-Customization/01-branding.md

@@ -94,6 +94,26 @@ const admin = new AdminForth({
 Here is how it looks:
 ![AdminForth Themes](image-10.png)
 
+## Single theme
+
+If you want to enforce a consistent theme and disable the theme switcher, you can configure AdminForth to use only one theme variant. 
+
+```ts title='./index.ts'
+
+const admin = new AdminForth({
+  ...
+  customization: {
+  //diff-add
+    singleTheme: "light",
+    styles: {
+      ...
+      }
+    } 
+  },
+  ...
+});
+```
+
 
 ## Square vs rounded buttons?
 
@@ -149,4 +169,52 @@ auth: {
 `loginBackgroundPosition` accepts values:
 
 - `over` - image will be over the whole login page with cover mode
-- `1/2`(default), `3/4`, `2/5`, `3/5` etc. - image will be in the left side of the login page with cover mode
+- `1/2`(default), `3/4`, `2/5`, `3/5` etc. - image will be in the left side of the login page with cover mode
+
+### Disabling background blend mode
+
+When using `loginBackgroundPosition: 'over'`, AdminForth applies a background blend mode by default to ensure text readability over the background image. If you want to disable this blend mode and display the background image without any overlay effects, you can add:
+
+```ts title='./index.ts'
+auth: {
+  ...
+  loginBackgroundImage: '@@/photo-1516501312919-d0cb0b7b60b8.jpeg',
+  loginBackgroundPosition: 'over',
+//diff-add
+  removeBackgroundBlendMode: true,
+}
+
+```
+
+## Custom items in html head
+
+If you want to add custom elements to the HTML head, you can define them in the configuration:
+
+```ts title='./index.ts'
+customization: {
+  customHeadItems: [
+    {
+      tagName: 'link',
+      attributes: {
+        rel: 'stylesheet',
+        href: 'https://example.com/custom.css'
+      }
+    },
+    {
+      tagName: 'script',
+      attributes: {
+        src: 'https://example.com/custom.js',
+        defer: true
+      }
+    },
+    {
+      tagName: 'meta',
+      attributes: {
+        name: 'theme-color',
+        content: ' #000000'
+      }
+    }
+  ]
+}
+
+```

adminforth/documentation/docs/tutorial/03-Customization/13-standardPagesTuning.md

@@ -194,7 +194,7 @@ To open a custom page, return URL to the custom page (can start with https://, o
 //diff-add
         listTableClickUrl: async (record, adminUser) => {
 //diff-add
-          return `https://google.com/search?q=${record.name}`;
+          return `https://google.com/search?q=${record.title}`;
 //diff-add
         }
       }

adminforth/documentation/docs/tutorial/03-Customization/15-afcl.md

@@ -1726,3 +1726,40 @@ import { MixedChart } from '@/afcl'
   </div>
 </div>
 
+## Json Viever
+
+```ts
+import { JsonViever } from '@/afcl'
+```
+
+### Basic
+
+<div class="split-screen" >
+
+  <div>
+  ```html
+      <JsonViewer 
+      :value="[
+        {
+          id: 1,
+          name: 'Alice',
+          meta: {
+            age: 30,
+            hobbies: ['reading', 'biking'],
+          }
+        },
+        {
+          id: 2,
+          name: 'Bob',
+        }
+      ]" 
+      :expandDepth="2" 
+    />
+  ```
+</div>
+  <div>
+    ![Mixed Chart](image-93.png)
+  </div>
+</div>
+
+