@dashadmin/dash-admin 1.3.26 → 1.3.28

package/README.md

@@ -0,0 +1,36 @@
+# @dashadmin/dash-admin
+
+> The Dash admin application shell — a batteries-included, react-admin based admin UI.
+
+## Overview
+
+Top-level composition package that wires together state, auth, data providers, layout, theming and the auto-admin engine into a single mountable `DASHAdmin` component. This is the main entry point most applications consume.
+
+## Key exports & features
+
+- `DASHAdmin` root component (resources, routing, layout, providers)
+- Built-in `DashThemeProvider` / `useDashThemeContext` theming context
+- Auth flows: login, recover password, verify account, change password
+- Integrates `dash-admin-state`, `dash-auto-admin`, `dash-auth`, `dash-components`, `dash-dialog`, `dash-modal`
+
+## Installation
+
+```bash
+# From the public npm registry
+npm install @dashadmin/dash-admin
+
+# Or the local Verdaccio registry (unscoped)
+npm install dash-admin --registry http://localhost:4873
+```
+
+## Internal Dash dependencies
+
+`@dashadmin/dash-admin-state`, `@dashadmin/dash-auto-admin`, `@dashadmin/dash-constants`, `@dashadmin/dash-dialog`, `@dashadmin/dash-styles`, `@dashadmin/dash-modal`, `@dashadmin/dash-components`, `@dashadmin/dash-axios-hook`, `@dashadmin/dash-utils`, `@dashadmin/dash-auth`
+
+## Development & publishing
+
+This package is part of the **dash-frontend-core** monorepo. See [`DEVELOPMENT.md`](../../DEVELOPMENT.md) for the source-modification workflow, local Verdaccio publishing, npm publishing and version-bump policy.
+
+---
+
+_Part of the [Dash Framework](https://www.npmjs.com/org/dashadmin) · `@dashadmin` scope._

package/dist/RoutingWrapper.js

@@ -2,6 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import { useEffect, useState, useRef } from "react";
 import { BrowserRouter, Route, Routes, useLocation } from "react-router-dom";
 import { AnimatePresence } from "framer-motion";
+import { DASHAdminSystemConstants } from "dash-constants";
 import MotionWrapper from "./layout/MotionWrapper";
 const RoutingWrapper = ({
   Wrapper,
@@ -18,7 +19,7 @@ const RoutingWrapper = ({
 const AnimatedRoutesWrapper = ({ children }) => {
   const location = useLocation();
   let method = "wait";
-  let transitionEnabled = true;
+  let transitionEnabled = DASHAdminSystemConstants.system.PAGE_TRANSITIONS;
   const pathParts = location.pathname.split("/");
   const lastPart = pathParts[pathParts.length - 1];
   const [show, setShow] = useState(true);

package/dist/config/DASHAdminSystemConstants.js

@@ -1,3 +1,4 @@
+var _a;
 const getEnvironmentVariable = (environmentVariable) => {
   const unvalidatedEnvironmentVariable = process.env[environmentVariable];
   return unvalidatedEnvironmentVariable || null;
@@ -30,8 +31,9 @@ const system = {
   DEFAULT_PER_PAGE: Number(getEnv("DEFAULT_PER_PAGE")) || null,
   //URL_PREFIX: getEnv('DASH_ADMIN_URL_PREFIX') || '#/',
   URL_PREFIX: getEnv("DASH_ADMIN_URL_PREFIX") || "/",
-  //PAGE_TRANSITIONS: JSON.parse(getEnv('PAGE_TRANSITIONS')) || false,
-  PAGE_TRANSITIONS: false,
+  // Route/page transition animations. Disable via env for low-powered devices
+  // (Raspberry Pi). Defaults true when unset; only "false" turns it off.
+  PAGE_TRANSITIONS: String((_a = getEnv("PAGE_TRANSITIONS")) != null ? _a : "true").toLowerCase() !== "false",
   GOOGLE_SIGNUP: JSON.parse(getEnv("APP_GOOGLE_SIGNUP")) || false,
   RECAPTCHA_ENABLED: JSON.parse(getEnv("APP_RECAPTCHA_ENABLED")) || false,
   RECAPTCHA_TOKEN: getEnv("APP_RECAPTCHA_TOKEN") || "UNSET",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dashadmin/dash-admin",
-	"version": "1.3.26",
+	"version": "1.3.28",
 	"main": "dist/index.js",
 	"type": "module",
 	"scripts": {
@@ -35,6 +35,11 @@
 		"@rollup/plugin-node-resolve": "latest",
 		"@rollup/plugin-replace": "latest",
 		"@rollup/plugin-typescript": "latest",
+		"@dashadmin/dash-admin-state": "workspace:*",
+		"@dashadmin/dash-auto-admin": "workspace:*",
+		"@dashadmin/dash-constants": "workspace:*",
+		"@dashadmin/dash-dialog": "workspace:*",
+		"@dashadmin/dash-styles": "workspace:*",
 		"framer-motion": "latest",
 		"prop-types": "latest",
 		"query-string": "latest",
@@ -54,11 +59,6 @@
 		"rollup-plugin-dts": "latest",
 		"rollup-plugin-peer-deps-external": "latest",
 		"rollup-plugin-svg": "latest",
-		"@dashadmin/dash-admin-state": "workspace:*",
-		"@dashadmin/dash-auto-admin": "workspace:*",
-		"@dashadmin/dash-constants": "workspace:*",
-		"@dashadmin/dash-dialog": "workspace:*",
-		"@dashadmin/dash-styles": "workspace:*",
 		"@dashadmin/dash-modal": "workspace:*",
 		"@dashadmin/dash-components": "workspace:*",
 		"@dashadmin/dash-axios-hook": "workspace:*",
@@ -76,6 +76,8 @@
 		"@types/react-dom": "latest",
 		"@zerollup/ts-transform-paths": "latest",
 		"babel-loader": "latest",
+		"@dashadmin/dash-eslint": "workspace:*",
+		"@dashadmin/dash-tsconfig": "workspace:*",
 		"eslint": "latest",
 		"eslint-config-airbnb": "latest",
 		"eslint-config-airbnb-typescript": "latest",
@@ -89,6 +91,7 @@
 		"eslint-plugin-prettier": "latest",
 		"eslint-plugin-react": "latest",
 		"eslint-plugin-react-hooks": "latest",
+		"@dashadmin/dash-prettier": "workspace:*",
 		"query-string": "latest",
 		"react-dom": "latest",
 		"rollup": "latest",
@@ -103,10 +106,7 @@
 		"tsc": "latest",
 		"tsc-alias": "latest",
 		"ttypescript": "latest",
-		"typescript": "latest",
-		"@dashadmin/dash-eslint": "workspace:*",
-		"@dashadmin/dash-tsconfig": "workspace:*",
-		"@dashadmin/dash-prettier": "workspace:*"
+		"typescript": "latest"
 	},
 	"eslintConfig": {
 		"extends": "react-app"

package/src/RoutingWrapper.tsx

@@ -2,6 +2,7 @@ import { PropsWithChildren, useEffect, useState, useRef } from "react";
 import { BrowserRouter, Route, Routes, useLocation } from "react-router-dom";
 
 import { AnimatePresence } from "framer-motion";
+import { DASHAdminSystemConstants } from "dash-constants";
 import MotionWrapper from "./layout/MotionWrapper";
 
 /**
@@ -72,7 +73,10 @@ const RoutingWrapper: React.FC<IDASHRoutingWrapper> = ({
 export const AnimatedRoutesWrapper: React.FC<PropsWithChildren> = ({ children }) => {
     const location = useLocation();
     let method = "wait";
-    let transitionEnabled = true;
+    // Driven by env: DASHAdminSystemConstants.system.PAGE_TRANSITIONS reads
+    // `<PREFIX>PAGE_TRANSITIONS` (default true). Set to false for Raspberry Pi
+    // / low-powered terminals to skip framer-motion route animations.
+    let transitionEnabled = DASHAdminSystemConstants.system.PAGE_TRANSITIONS;
     const pathParts = location.pathname.split('/');
     const lastPart = pathParts[pathParts.length - 1];
     const [show, setShow] = useState(true); // Initialize as true

package/src/config/DASHAdminSystemConstants.tsx

@@ -53,8 +53,9 @@ const system = {
   DEFAULT_PER_PAGE: Number(getEnv('DEFAULT_PER_PAGE')) || null,
   //URL_PREFIX: getEnv('DASH_ADMIN_URL_PREFIX') || '#/',
   URL_PREFIX: getEnv('DASH_ADMIN_URL_PREFIX') || '/',
-  //PAGE_TRANSITIONS: JSON.parse(getEnv('PAGE_TRANSITIONS')) || false,
-  PAGE_TRANSITIONS: false,
+  // Route/page transition animations. Disable via env for low-powered devices
+  // (Raspberry Pi). Defaults true when unset; only "false" turns it off.
+  PAGE_TRANSITIONS: String(getEnv('PAGE_TRANSITIONS') ?? 'true').toLowerCase() !== 'false',
 
   GOOGLE_SIGNUP: JSON.parse(getEnv('APP_GOOGLE_SIGNUP')) || false,
   RECAPTCHA_ENABLED: JSON.parse(getEnv('APP_RECAPTCHA_ENABLED')) || false,