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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: django-admin-react
-Version: 1.0.3
+Version: 1.1.0
 Summary: A drop-in React single-page admin for Django, driven entirely by ModelAdmin.
 License: MIT
 Keywords: django,admin,react,spa,tailwind
@@ -298,6 +298,31 @@ urlpatterns = [
 ]
 ```
 
+#### Legacy-admin escape hatch (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:
+
+```python
+# settings.py
+DJANGO_ADMIN_REACT = {
+    "LEGACY_ADMIN_URL_PREFIX": "admin/",   # the legacy admin'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.
+
+When you remove the setting (or set it to `None`), the banner
+disappears on the next page load — completing the migration.
+
 ---
 
 ## Extend without writing React

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

@@ -265,6 +265,31 @@ urlpatterns = [
 ]
 ```
 
+#### Legacy-admin escape hatch (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:
+
+```python
+# settings.py
+DJANGO_ADMIN_REACT = {
+    "LEGACY_ADMIN_URL_PREFIX": "admin/",   # the legacy admin'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.
+
+When you remove the setting (or set it to `None`), the banner
+disappears on the next page load — completing the migration.
+
 ---
 
 ## Extend without writing React

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

@@ -99,6 +99,25 @@ DEFAULTS: dict[str, Any] = {
     # `django_admin_react.urls` skips the inline `api/v1/` include so
     # there is no double-mount.
     "API_URL_PREFIX": None,
+    # ``LEGACY_ADMIN_URL_PREFIX`` — opt-in escape-hatch banner (#577).
+    # When set, every SPA page renders a thin notice banner at the top
+    # linking to **the same page** under the legacy Django admin's URL
+    # prefix. Useful during a progressive migration: end-users with
+    # muscle memory for ``/admin/`` (or wherever the legacy admin is
+    # mounted) can return to the classic surface in one click, and the
+    # bug list grows from "what they clicked back for." Default
+    # ``None`` keeps behaviour unchanged — no banner, no extra
+    # requests, no SPA overhead.
+    #
+    # The value matches the prefix the consumer registered the legacy
+    # admin under in ``urls.py`` — e.g. ``"admin/"`` for
+    # ``urlpatterns = [path("admin/", legacy_admin.urls), ...]``. The
+    # SPA computes the matching legacy URL by swapping its own mount
+    # for this value (both admins use the same ``app_label/model_name``
+    # URL shape, so it's a straight prefix swap with no per-route
+    # 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,
     "PWA_NAME": None,
     "PWA_SHORT_NAME": None,
     "PWA_ICONS": None,
@@ -122,6 +141,7 @@ class _PackageSettings:
     PRIMARY_COLOR: str = DEFAULTS["PRIMARY_COLOR"]
     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"]
     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/static/admin_react/.vite/manifest.json

@@ -0,0 +1,23 @@
+{
+  "../../packages/details/src/JsonViewer.tsx": {
+    "file": "assets/JsonViewer-7Pvk14Q0.js",
+    "name": "JsonViewer",
+    "src": "../../packages/details/src/JsonViewer.tsx",
+    "isDynamicEntry": true,
+    "imports": [
+      "index.html"
+    ]
+  },
+  "index.html": {
+    "file": "assets/index-BAk9ZaWt.js",
+    "name": "index",
+    "src": "index.html",
+    "isEntry": true,
+    "dynamicImports": [
+      "../../packages/details/src/JsonViewer.tsx"
+    ],
+    "css": [
+      "assets/index-CAPQqmPH.css"
+    ]
+  }
+}

django_admin_react-1.1.0/django_admin_react/static/admin_react/assets/JsonViewer-7Pvk14Q0.js

@@ -0,0 +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};