django-admin-react 1.1.0__tar.gz → 1.2.0__tar.gz

{django_admin_react-1.1.0 → django_admin_react-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: django-admin-react
-Version: 1.1.0
+Version: 1.2.0
 Summary: A drop-in React single-page admin for Django, driven entirely by ModelAdmin.
 License: MIT
 Keywords: django,admin,react,spa,tailwind
@@ -298,30 +298,58 @@ urlpatterns = [
 ]
 ```
 
-#### Legacy-admin escape hatch (optional)
+#### Experience-toggle strip (optional)
 
-During the rollout, show an in-SPA banner on every page that links to
-**the same page** in the original admin. End-users with muscle memory
-for `/admin/` (or bookmarks pointing at it) can return to the classic
-surface in one click while you close feature gaps in the SPA:
+During the rollout, show a thin **persistent** strip at the top of
+every page on **both** admins that links to the same page on the
+other admin. Users can switch surfaces in one click, regardless of
+which one they're on:
 
 ```python
 # settings.py
 DJANGO_ADMIN_REACT = {
-    "LEGACY_ADMIN_URL_PREFIX": "admin/",   # the legacy admin's mount
+    "LEGACY_ADMIN_URL_PREFIX": "admin/",     # the legacy admin's mount
+    "REACT_ADMIN_URL_PREFIX":  "admin2/",    # this package's mount
 }
 ```
 
-The value must match the prefix you mounted the legacy admin under in
-`urls.py`. When set, the SPA renders a thin notice banner at the top
-of every page linking the matching legacy URL (computed by swapping
-the prefix — both admins honour the same `app_label/model_name/...`
-URL shape). The banner is dismissible per session (`sessionStorage`),
-so each session shows it once and a user who forgot the escape hatch
-exists is reminded the next time they log in.
+Both values must match the prefixes you used in `urls.py`. When set:
 
-When you remove the setting (or set it to `None`), the banner
-disappears on the next page load — completing the migration.
+- The **React SPA** renders a strip linking the same path under the
+  legacy admin's mount (with `?query=string` preserved and a trailing
+  slash, since Django admin URLs require one).
+- The **legacy Django admin** renders the mirror strip linking the
+  matching React URL.
+
+Set `LEGACY_ADMIN_URL_PREFIX` alone if you only want the SPA → legacy
+direction (reverse direction stays off).
+
+##### `INSTALLED_APPS` ordering
+
+For the legacy-side strip, list `django_admin_react` **before**
+`django.contrib.admin`. Django's template loader resolves
+`admin/base_site.html` left-to-right and the first match wins —
+the package's override of that template injects the strip:
+
+```python
+INSTALLED_APPS = [
+    "django_admin_react",            # ← BEFORE django.contrib.admin
+    "django.contrib.admin",
+    # ...
+]
+```
+
+If you don't enable the legacy-side strip (`REACT_ADMIN_URL_PREFIX`
+unset) the ordering doesn't matter — the override is a no-op for
+consumers who haven't opted in.
+
+##### UX contract
+
+The strip is **subtle and persistent**: one line tall, neutral
+chrome, no dismiss control. Operators turn it on/off via the
+settings; end-users do not. When you remove the settings (or set
+them to `None`), the strips disappear on the next page load —
+completing the migration.
 
 ---
 

{django_admin_react-1.1.0 → django_admin_react-1.2.0}/README.md

@@ -265,30 +265,58 @@ urlpatterns = [
 ]
 ```
 
-#### Legacy-admin escape hatch (optional)
+#### Experience-toggle strip (optional)
 
-During the rollout, show an in-SPA banner on every page that links to
-**the same page** in the original admin. End-users with muscle memory
-for `/admin/` (or bookmarks pointing at it) can return to the classic
-surface in one click while you close feature gaps in the SPA:
+During the rollout, show a thin **persistent** strip at the top of
+every page on **both** admins that links to the same page on the
+other admin. Users can switch surfaces in one click, regardless of
+which one they're on:
 
 ```python
 # settings.py
 DJANGO_ADMIN_REACT = {
-    "LEGACY_ADMIN_URL_PREFIX": "admin/",   # the legacy admin's mount
+    "LEGACY_ADMIN_URL_PREFIX": "admin/",     # the legacy admin's mount
+    "REACT_ADMIN_URL_PREFIX":  "admin2/",    # this package's mount
 }
 ```
 
-The value must match the prefix you mounted the legacy admin under in
-`urls.py`. When set, the SPA renders a thin notice banner at the top
-of every page linking the matching legacy URL (computed by swapping
-the prefix — both admins honour the same `app_label/model_name/...`
-URL shape). The banner is dismissible per session (`sessionStorage`),
-so each session shows it once and a user who forgot the escape hatch
-exists is reminded the next time they log in.
+Both values must match the prefixes you used in `urls.py`. When set:
 
-When you remove the setting (or set it to `None`), the banner
-disappears on the next page load — completing the migration.
+- The **React SPA** renders a strip linking the same path under the
+  legacy admin's mount (with `?query=string` preserved and a trailing
+  slash, since Django admin URLs require one).
+- The **legacy Django admin** renders the mirror strip linking the
+  matching React URL.
+
+Set `LEGACY_ADMIN_URL_PREFIX` alone if you only want the SPA → legacy
+direction (reverse direction stays off).
+
+##### `INSTALLED_APPS` ordering
+
+For the legacy-side strip, list `django_admin_react` **before**
+`django.contrib.admin`. Django's template loader resolves
+`admin/base_site.html` left-to-right and the first match wins —
+the package's override of that template injects the strip:
+
+```python
+INSTALLED_APPS = [
+    "django_admin_react",            # ← BEFORE django.contrib.admin
+    "django.contrib.admin",
+    # ...
+]
+```
+
+If you don't enable the legacy-side strip (`REACT_ADMIN_URL_PREFIX`
+unset) the ordering doesn't matter — the override is a no-op for
+consumers who haven't opted in.
+
+##### UX contract
+
+The strip is **subtle and persistent**: one line tall, neutral
+chrome, no dismiss control. Operators turn it on/off via the
+settings; end-users do not. When you remove the settings (or set
+them to `None`), the strips disappear on the next page load —
+completing the migration.
 
 ---
 

{django_admin_react-1.1.0 → django_admin_react-1.2.0}/django_admin_react/conf.py

@@ -118,6 +118,17 @@ DEFAULTS: dict[str, Any] = {
     # mapping). When the matching legacy route doesn't exist, the
     # legacy admin 404s — same outcome as visiting that URL directly.
     "LEGACY_ADMIN_URL_PREFIX": None,
+    # ``REACT_ADMIN_URL_PREFIX`` — sibling of ``LEGACY_ADMIN_URL_PREFIX``
+    # (#584). When **both** are set, the legacy Django admin renders a
+    # mirror strip at the top of every page linking the same path under
+    # the React admin's mount — so a user on either surface can swap
+    # to the other in one click. The value is the prefix the SPA was
+    # mounted at in ``urls.py`` — e.g. ``"admin2/"`` for
+    # ``urlpatterns = [path("admin2/", include("django_admin_react.urls")), ...]``.
+    # When only ``LEGACY_ADMIN_URL_PREFIX`` is set, only the SPA-side
+    # strip renders (reverse direction stays off — no implicit guess
+    # at the consumer's chosen mount).
+    "REACT_ADMIN_URL_PREFIX": None,
     "PWA_NAME": None,
     "PWA_SHORT_NAME": None,
     "PWA_ICONS": None,
@@ -142,6 +153,7 @@ class _PackageSettings:
     REACT_LOGIN: bool = DEFAULTS["REACT_LOGIN"]
     API_URL_PREFIX: str | None = DEFAULTS["API_URL_PREFIX"]
     LEGACY_ADMIN_URL_PREFIX: str | None = DEFAULTS["LEGACY_ADMIN_URL_PREFIX"]
+    REACT_ADMIN_URL_PREFIX: str | None = DEFAULTS["REACT_ADMIN_URL_PREFIX"]
     PWA_NAME: str | None = DEFAULTS["PWA_NAME"]
     PWA_SHORT_NAME: str | None = DEFAULTS["PWA_SHORT_NAME"]
     PWA_ICONS: list[dict[str, str]] | None = DEFAULTS["PWA_ICONS"]

{django_admin_react-1.1.0 → django_admin_react-1.2.0}/django_admin_react/static/admin_react/.vite/manifest.json

@@ -1,6 +1,6 @@
 {
   "../../packages/details/src/JsonViewer.tsx": {
-    "file": "assets/JsonViewer-7Pvk14Q0.js",
+    "file": "assets/JsonViewer-LPoiv-e5.js",
     "name": "JsonViewer",
     "src": "../../packages/details/src/JsonViewer.tsx",
     "isDynamicEntry": true,
@@ -9,7 +9,7 @@
     ]
   },
   "index.html": {
-    "file": "assets/index-BAk9ZaWt.js",
+    "file": "assets/index-BkdeALer.js",
     "name": "index",
     "src": "index.html",
     "isEntry": true,
@@ -17,7 +17,7 @@
       "../../packages/details/src/JsonViewer.tsx"
     ],
     "css": [
-      "assets/index-CAPQqmPH.css"
+      "assets/index-DMT_bXJw.css"
     ]
   }
 }

django_admin_react-1.1.0/django_admin_react/static/admin_react/assets/JsonViewer-7Pvk14Q0.js → django_admin_react-1.2.0/django_admin_react/static/admin_react/assets/JsonViewer-LPoiv-e5.js

@@ -1 +1 @@
-import{c as x,r as l,j as e,C as h}from"./index-BAk9ZaWt.js";const p=[["path",{d:"m9 18 6-6-6-6",key:"mthhwq"}]],g=x("chevron-right",p);const y=[["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],j=x("copy",y);function N({raw:r,parsed:t}){const[s,c]=l.useState(!1);async function a(){try{await navigator.clipboard.writeText(r),c(!0),setTimeout(()=>c(!1),2e3)}catch{}}return e.jsxs("div",{className:"relative w-full overflow-x-auto rounded border border-gray-200 bg-gray-50 p-3 font-mono text-xs leading-relaxed text-gray-800 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-200",children:[e.jsx("button",{type:"button",onClick:a,"aria-label":"Copy JSON",title:s?"Copied":"Copy",className:"absolute right-2 top-2 inline-flex h-6 w-6 items-center justify-center rounded border border-gray-300 bg-white text-gray-600 hover:bg-gray-100 dark:border-gray-600 dark:bg-gray-800 dark:text-gray-300 dark:hover:bg-gray-700",children:s?e.jsx(h,{className:"h-3.5 w-3.5 text-green-600","aria-hidden":!0}):e.jsx(j,{className:"h-3.5 w-3.5","aria-hidden":!0})}),e.jsx(o,{value:t,depth:0})]})}function o({value:r,depth:t}){return r===null?e.jsx("span",{className:"text-purple-600 dark:text-purple-400",children:"null"}):typeof r=="boolean"?e.jsx("span",{className:"text-purple-600 dark:text-purple-400",children:r?"true":"false"}):typeof r=="number"?e.jsx("span",{className:"text-blue-700",children:String(r)}):typeof r=="string"?e.jsxs("span",{className:"text-green-700 dark:text-green-400",children:['"',r,'"']}):Array.isArray(r)?e.jsx(u,{value:r,depth:t}):typeof r=="object"?e.jsx(m,{value:r,depth:t}):e.jsx("span",{className:"text-gray-500",children:String(r)})}function m({value:r,depth:t}){const s=Object.keys(r),[c,a]=l.useState(t<2);return s.length===0?e.jsx("span",{className:"text-gray-500",children:"{}"}):e.jsx(d,{open:c,onToggle:()=>a(n=>!n),collapsedLabel:`{…} ${s.length} ${s.length===1?"key":"keys"}`,openBracket:"{",closeBracket:"}",depth:t,children:s.map((n,i)=>e.jsxs("div",{className:"pl-4",children:[e.jsxs("span",{className:"text-rose-700 dark:text-rose-400",children:['"',n,'"']}),e.jsx("span",{className:"text-gray-500",children:": "}),e.jsx(o,{value:r[n],depth:t+1}),i<s.length-1?e.jsx("span",{className:"text-gray-500",children:","}):null]},n))})}function u({value:r,depth:t}){const[s,c]=l.useState(t<2);return r.length===0?e.jsx("span",{className:"text-gray-500",children:"[]"}):e.jsx(d,{open:s,onToggle:()=>c(a=>!a),collapsedLabel:`[…] ${r.length} ${r.length===1?"item":"items"}`,openBracket:"[",closeBracket:"]",depth:t,children:r.map((a,n)=>e.jsxs("div",{className:"pl-4",children:[e.jsx(o,{value:a,depth:t+1}),n<r.length-1?e.jsx("span",{className:"text-gray-500",children:","}):null]},n))})}function d({open:r,onToggle:t,collapsedLabel:s,openBracket:c,closeBracket:a,depth:n,children:i}){return e.jsxs("span",{children:[e.jsx("button",{type:"button",onClick:t,"aria-expanded":r,className:"inline-flex items-center align-baseline text-gray-500 hover:text-gray-800 dark:hover:text-gray-200",children:e.jsx(g,{className:`h-3 w-3 shrink-0 transition-transform ${r?"rotate-90":""}`,"aria-hidden":!0})}),e.jsx("span",{className:"text-gray-500",children:c}),r?e.jsxs(e.Fragment,{children:[i,e.jsx("div",{className:n===0?"":"pl-0",children:e.jsx("span",{className:"text-gray-500",children:a})})]}):e.jsxs(e.Fragment,{children:[e.jsx("span",{className:"px-1 text-gray-500",children:s}),e.jsx("span",{className:"text-gray-500",children:a})]})]})}export{N as default};
+import{c as x,r as l,j as e,C as h}from"./index-BkdeALer.js";const p=[["path",{d:"m9 18 6-6-6-6",key:"mthhwq"}]],g=x("chevron-right",p);const y=[["rect",{width:"14",height:"14",x:"8",y:"8",rx:"2",ry:"2",key:"17jyea"}],["path",{d:"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2",key:"zix9uf"}]],j=x("copy",y);function N({raw:r,parsed:t}){const[s,c]=l.useState(!1);async function a(){try{await navigator.clipboard.writeText(r),c(!0),setTimeout(()=>c(!1),2e3)}catch{}}return e.jsxs("div",{className:"relative w-full overflow-x-auto rounded border border-gray-200 bg-gray-50 p-3 font-mono text-xs leading-relaxed text-gray-800 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-200",children:[e.jsx("button",{type:"button",onClick:a,"aria-label":"Copy JSON",title:s?"Copied":"Copy",className:"absolute right-2 top-2 inline-flex h-6 w-6 items-center justify-center rounded border border-gray-300 bg-white text-gray-600 hover:bg-gray-100 dark:border-gray-600 dark:bg-gray-800 dark:text-gray-300 dark:hover:bg-gray-700",children:s?e.jsx(h,{className:"h-3.5 w-3.5 text-green-600","aria-hidden":!0}):e.jsx(j,{className:"h-3.5 w-3.5","aria-hidden":!0})}),e.jsx(o,{value:t,depth:0})]})}function o({value:r,depth:t}){return r===null?e.jsx("span",{className:"text-purple-600 dark:text-purple-400",children:"null"}):typeof r=="boolean"?e.jsx("span",{className:"text-purple-600 dark:text-purple-400",children:r?"true":"false"}):typeof r=="number"?e.jsx("span",{className:"text-blue-700",children:String(r)}):typeof r=="string"?e.jsxs("span",{className:"text-green-700 dark:text-green-400",children:['"',r,'"']}):Array.isArray(r)?e.jsx(u,{value:r,depth:t}):typeof r=="object"?e.jsx(m,{value:r,depth:t}):e.jsx("span",{className:"text-gray-500",children:String(r)})}function m({value:r,depth:t}){const s=Object.keys(r),[c,a]=l.useState(t<2);return s.length===0?e.jsx("span",{className:"text-gray-500",children:"{}"}):e.jsx(d,{open:c,onToggle:()=>a(n=>!n),collapsedLabel:`{…} ${s.length} ${s.length===1?"key":"keys"}`,openBracket:"{",closeBracket:"}",depth:t,children:s.map((n,i)=>e.jsxs("div",{className:"pl-4",children:[e.jsxs("span",{className:"text-rose-700 dark:text-rose-400",children:['"',n,'"']}),e.jsx("span",{className:"text-gray-500",children:": "}),e.jsx(o,{value:r[n],depth:t+1}),i<s.length-1?e.jsx("span",{className:"text-gray-500",children:","}):null]},n))})}function u({value:r,depth:t}){const[s,c]=l.useState(t<2);return r.length===0?e.jsx("span",{className:"text-gray-500",children:"[]"}):e.jsx(d,{open:s,onToggle:()=>c(a=>!a),collapsedLabel:`[…] ${r.length} ${r.length===1?"item":"items"}`,openBracket:"[",closeBracket:"]",depth:t,children:r.map((a,n)=>e.jsxs("div",{className:"pl-4",children:[e.jsx(o,{value:a,depth:t+1}),n<r.length-1?e.jsx("span",{className:"text-gray-500",children:","}):null]},n))})}function d({open:r,onToggle:t,collapsedLabel:s,openBracket:c,closeBracket:a,depth:n,children:i}){return e.jsxs("span",{children:[e.jsx("button",{type:"button",onClick:t,"aria-expanded":r,className:"inline-flex items-center align-baseline text-gray-500 hover:text-gray-800 dark:hover:text-gray-200",children:e.jsx(g,{className:`h-3 w-3 shrink-0 transition-transform ${r?"rotate-90":""}`,"aria-hidden":!0})}),e.jsx("span",{className:"text-gray-500",children:c}),r?e.jsxs(e.Fragment,{children:[i,e.jsx("div",{className:n===0?"":"pl-0",children:e.jsx("span",{className:"text-gray-500",children:a})})]}):e.jsxs(e.Fragment,{children:[e.jsx("span",{className:"px-1 text-gray-500",children:s}),e.jsx("span",{className:"text-gray-500",children:a})]})]})}export{N as default};