django-admin-modern-view 0.2.1__py3-none-any.whl

django_admin_modern_view/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.1"

django_admin_modern_view/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+
+
+class DjangoAdminModernViewConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "django_admin_modern_view"
+    verbose_name = "Django Admin Modern View"
+
+    def ready(self):
+        from . import checks  # noqa: F401  (registers Django system checks)

django_admin_modern_view/checks.py

@@ -0,0 +1,55 @@
+"""Django system checks that catch the one setup mistake this package
+can't work around: app ordering.
+
+Django's app_dirs template loader resolves ``admin/*.html`` overrides by
+walking INSTALLED_APPS in order and using the first match. If
+django_admin_modern_view isn't listed before django.contrib.admin, its template
+overrides silently lose to Django's own — the admin just looks
+unstyled, with no error to point at why.
+"""
+from django.apps import apps
+from django.conf import settings
+from django.core.checks import Warning, register
+
+
+@register()
+def check_app_order(app_configs, **kwargs):
+    installed = list(settings.INSTALLED_APPS)
+    try:
+        admin_index = next(
+            i for i, name in enumerate(installed)
+            if name == "django.contrib.admin" or name.startswith("django.contrib.admin.")
+        )
+    except StopIteration:
+        return []  # django.contrib.admin isn't installed; nothing to check
+
+    try:
+        our_index = next(
+            i for i, name in enumerate(installed)
+            if name == "django_admin_modern_view" or name.startswith("django_admin_modern_view.")
+        )
+    except StopIteration:
+        our_index = None  # resolved via AppConfig path instead of the bare name
+
+    if our_index is None:
+        try:
+            our_index = installed.index(apps.get_app_config("django_admin_modern_view").name)
+        except LookupError:
+            return []
+
+    if our_index > admin_index:
+        return [
+            Warning(
+                "django_admin_modern_view is listed after django.contrib.admin in "
+                "INSTALLED_APPS.",
+                hint=(
+                    "Move 'django_admin_modern_view' above 'django.contrib.admin' in "
+                    "INSTALLED_APPS. Django's template loader picks the "
+                    "first admin/*.html it finds by app order, so this "
+                    "package's overrides (topbar, command palette, dashboard) "
+                    "will otherwise be silently ignored."
+                ),
+                id="django_admin_modern_view.W001",
+            )
+        ]
+    return []

django_admin_modern_view/services/command_registry.py

@@ -0,0 +1,78 @@
+"""Central registry for the Modern Admin command palette (Ctrl+K).
+
+Commands are plain dicts so they serialize straight to JSON for the
+frontend. Registered commands are merged with commands auto-derived
+from the Django admin site (navigation + "create" actions) on every
+request, so palette content always reflects the logged-in user's
+permissions.
+"""
+from django.urls import reverse
+
+_registered_commands = []
+
+
+def register_command(id, label, category="General", shortcut=None, url=None, icon=None, keywords=""):
+    """Register a custom command shown in the command palette.
+
+    Example:
+        register_command(
+            id="create_user",
+            label="Create User",
+            category="Actions",
+            url="/admin/auth/user/add/",
+        )
+    """
+    _registered_commands.append({
+        "id": id,
+        "label": label,
+        "category": category,
+        "shortcut": shortcut,
+        "url": url,
+        "icon": icon or "",
+        "keywords": keywords,
+    })
+
+
+def get_registered_commands():
+    return list(_registered_commands)
+
+
+def get_commands_for_request(request):
+    """Build the full palette command list for the current user."""
+    from django.contrib import admin
+
+    commands = [{
+        "id": "nav:dashboard",
+        "label": "Dashboard",
+        "category": "Navigation",
+        "shortcut": None,
+        "url": reverse("admin:index"),
+        "icon": "home",
+        "keywords": "home dashboard",
+    }]
+
+    for app in admin.site.get_app_list(request):
+        for model in app["models"]:
+            if model.get("admin_url"):
+                commands.append({
+                    "id": f"nav:{app['app_label']}.{model['object_name']}",
+                    "label": model["name"],
+                    "category": "Navigation",
+                    "shortcut": None,
+                    "url": model["admin_url"],
+                    "icon": "list",
+                    "keywords": f"{app['name']} {model['name']}",
+                })
+            if model.get("add_url"):
+                commands.append({
+                    "id": f"create:{app['app_label']}.{model['object_name']}",
+                    "label": f"Create {model['name']}",
+                    "category": "Actions",
+                    "shortcut": None,
+                    "url": model["add_url"],
+                    "icon": "plus",
+                    "keywords": f"add new {model['name']}",
+                })
+
+    commands.extend(get_registered_commands())
+    return commands

django_admin_modern_view/services/search.py

@@ -0,0 +1,101 @@
+"""Global search service (Phase 5).
+
+Searches across models registered with the Django admin. Any
+ModelAdmin that defines `search_fields` is auto-registered on app
+startup so search works with zero extra config; `register_global_search`
+lets you register a model explicitly (custom fields/label) or a model
+that isn't registered with the admin at all.
+
+Kept deliberately decoupled from the ORM implementation so it can
+later be swapped for Postgres full text search / Meilisearch /
+OpenSearch without touching the view or the frontend contract.
+"""
+from django.db.models import Q
+
+_registry = []
+_autodiscovered = False
+
+
+def register_global_search(model, fields, label=None):
+    if any(entry["model"] is model for entry in _registry):
+        return
+    _registry.append({
+        "model": model,
+        "fields": list(fields),
+        "label": label or str(model._meta.verbose_name_plural).title(),
+    })
+
+
+def autodiscover_from_admin():
+    """Auto-register every ModelAdmin that defines search_fields.
+
+    Called lazily (on first search) rather than from AppConfig.ready():
+    django_admin_modern_view is listed before django.contrib.admin in
+    INSTALLED_APPS so that its template overrides win, but that also
+    means its ready() runs before admin.autodiscover() has populated
+    admin.site._registry.
+    """
+    global _autodiscovered
+    from django.contrib import admin
+
+    for model, model_admin in admin.site._registry.items():
+        search_fields = getattr(model_admin, "search_fields", None)
+        if search_fields:
+            register_global_search(model, search_fields)
+    _autodiscovered = True
+
+
+def _ensure_autodiscovered():
+    if not _autodiscovered:
+        autodiscover_from_admin()
+
+
+def _q_for_field(field, query):
+    if field.startswith("^"):
+        return Q(**{f"{field[1:]}__istartswith": query})
+    if field.startswith("="):
+        return Q(**{f"{field[1:]}__iexact": query})
+    if field.startswith("@"):
+        return Q(**{f"{field[1:]}__search": query})
+    return Q(**{f"{field}__icontains": query})
+
+
+def _admin_url_for(model, obj):
+    from django.urls import NoReverseMatch, reverse
+
+    opts = model._meta
+    try:
+        return reverse(f"admin:{opts.app_label}_{opts.model_name}_change", args=[obj.pk])
+    except NoReverseMatch:
+        return None
+
+
+def global_search(request, query, per_model_limit=5):
+    from django.contrib import admin
+
+    _ensure_autodiscovered()
+    results = []
+    for entry in _registry:
+        model = entry["model"]
+        model_admin = admin.site._registry.get(model)
+        if model_admin is not None and not model_admin.has_view_permission(request):
+            continue
+
+        q_obj = Q()
+        for field in entry["fields"]:
+            q_obj |= _q_for_field(field, query)
+
+        try:
+            queryset = model._default_manager.filter(q_obj)[:per_model_limit]
+        except Exception:
+            continue
+
+        for obj in queryset:
+            results.append({
+                "type": entry["label"],
+                "label": str(obj),
+                "description": entry["label"],
+                "url": _admin_url_for(model, obj),
+            })
+
+    return results

django_admin_modern_view/static/django_admin_modern_view/css/base.css

@@ -0,0 +1,69 @@
+/* Global typography + surface tweaks layered on top of Django's admin/css/base.css */
+
+body {
+    font-family: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    -webkit-font-smoothing: antialiased;
+}
+
+a:link,
+a:visited {
+    text-decoration: none;
+}
+
+a:hover {
+    text-decoration: underline;
+}
+
+#content {
+    padding: 24px 32px;
+}
+
+#content h1 {
+    font-size: 21px;
+    font-weight: 700;
+    letter-spacing: -0.01em;
+    color: var(--body-loud-color);
+}
+
+.breadcrumbs {
+    font-size: 12.5px;
+    padding: 10px 0 0;
+}
+
+.module {
+    border-radius: var(--radius-md);
+    box-shadow: var(--shadow-sm);
+    border: 1px solid var(--border-color);
+    overflow: hidden;
+}
+
+.module h2,
+.module caption,
+.inline-group h2 {
+    border-radius: 0;
+}
+
+.button,
+input[type="submit"],
+input[type="button"],
+.submit-row input,
+a.button {
+    border-radius: var(--radius-sm);
+    transition: background-color 0.15s ease, box-shadow 0.15s ease;
+}
+
+.object-tools a,
+.object-tools a:link {
+    border-radius: var(--radius-sm);
+}
+
+/* Focus visibility (Section 20: accessibility) */
+a:focus-visible,
+button:focus-visible,
+input:focus-visible,
+select:focus-visible,
+textarea:focus-visible,
+[tabindex]:focus-visible {
+    outline: 2px solid var(--primary);
+    outline-offset: 2px;
+}

django_admin_modern_view/static/django_admin_modern_view/css/command-palette.css

@@ -0,0 +1,151 @@
+/* Phase 4: command palette + generic modal/overlay styles */
+
+.ma-overlay {
+    position: fixed;
+    inset: 0;
+    z-index: 1000;
+    display: none;
+    align-items: flex-start;
+    justify-content: center;
+    padding-top: 12vh;
+    background: var(--overlay-bg);
+}
+
+.ma-overlay.ma-open {
+    display: flex;
+}
+
+.ma-palette {
+    width: 100%;
+    max-width: 600px;
+    max-height: 60vh;
+    display: flex;
+    flex-direction: column;
+    background: var(--surface-raised);
+    border-radius: var(--radius-lg);
+    box-shadow: var(--shadow-lg);
+    overflow: hidden;
+}
+
+.ma-palette__input-row {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 14px 16px;
+    border-bottom: 1px solid var(--border-color);
+}
+
+.ma-palette__input-row svg {
+    flex: 0 0 auto;
+    color: var(--body-quiet-color);
+}
+
+.ma-palette__input {
+    flex: 1 1 auto;
+    border: none;
+    background: transparent;
+    color: var(--body-fg);
+    font-size: 15px;
+    outline: none;
+}
+
+.ma-palette__results {
+    overflow-y: auto;
+    padding: 8px;
+}
+
+.ma-palette__group-label {
+    padding: 8px 10px 4px;
+    font-size: 11px;
+    font-weight: 700;
+    letter-spacing: 0.05em;
+    text-transform: uppercase;
+    color: var(--body-quiet-color);
+}
+
+.ma-palette__item {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 9px 10px;
+    border-radius: var(--radius-sm);
+    cursor: pointer;
+    color: var(--body-fg);
+    font-size: 13.5px;
+}
+
+.ma-palette__item:hover,
+.ma-palette__item.ma-active {
+    background: var(--selected-bg);
+}
+
+.ma-palette__item-icon {
+    flex: 0 0 auto;
+    width: 16px;
+    text-align: center;
+    color: var(--body-quiet-color);
+}
+
+.ma-palette__item-label {
+    flex: 1 1 auto;
+}
+
+.ma-palette__item-desc {
+    color: var(--body-quiet-color);
+    font-size: 12px;
+}
+
+.ma-palette__empty {
+    padding: 24px;
+    text-align: center;
+    color: var(--body-quiet-color);
+    font-size: 13px;
+}
+
+.ma-palette__footer {
+    display: flex;
+    gap: 14px;
+    padding: 8px 14px;
+    border-top: 1px solid var(--border-color);
+    font-size: 11px;
+    color: var(--body-quiet-color);
+}
+
+/* Generic modal (shortcut help, confirmations) */
+.ma-modal {
+    width: 100%;
+    max-width: 480px;
+    background: var(--surface-raised);
+    border-radius: var(--radius-lg);
+    box-shadow: var(--shadow-lg);
+    padding: 20px 22px;
+}
+
+.ma-modal__title {
+    margin: 0 0 14px;
+    font-size: 15px;
+    font-weight: 600;
+}
+
+.ma-shortcut-row {
+    display: flex;
+    justify-content: space-between;
+    padding: 6px 0;
+    font-size: 13px;
+}
+
+.ma-shortcut-row + .ma-shortcut-row {
+    border-top: 1px solid var(--hairline-color);
+}
+
+.ma-shortcut-group + .ma-shortcut-group {
+    margin-top: 14px;
+}
+
+.ma-shortcut-group__title {
+    font-size: 11px;
+    font-weight: 700;
+    letter-spacing: 0.05em;
+    text-transform: uppercase;
+    color: var(--body-quiet-color);
+}

django_admin_modern_view/static/django_admin_modern_view/css/forms.css

@@ -0,0 +1,189 @@
+/* Phase 8: enhanced forms — sticky save bar + dirty-state pill.
+   Works with Django's existing .submit-row, no template override. */
+
+.submit-row {
+    position: sticky;
+    /* Stop above the fixed .ma-statusbar (layout.css) instead of
+       underneath/behind it — both pinning to bottom:0 made them
+       overlap. */
+    bottom: var(--statusbar-height);
+    z-index: 100;
+    border-radius: var(--radius-md);
+    box-shadow: var(--shadow-md);
+    align-items: center;
+}
+
+.ma-dirty-indicator {
+    display: none;
+    align-items: center;
+    gap: 6px;
+    margin-right: auto;
+    padding-left: 4px;
+    font-size: 12.5px;
+    color: var(--warning);
+}
+
+.ma-dirty-indicator::before {
+    content: "";
+    width: 7px;
+    height: 7px;
+    border-radius: 50%;
+    background: currentColor;
+}
+
+.submit-row.ma-dirty .ma-dirty-indicator {
+    display: flex;
+}
+
+fieldset.module {
+    margin-bottom: 16px;
+}
+
+.form-row {
+    border-bottom-color: var(--hairline-color);
+}
+
+/* Modern text inputs / textareas / selects. Excludes buttons and the
+   checkbox/radio/file inputs, which keep their native controls. */
+input:not([type="submit"]):not([type="button"]):not([type="checkbox"]):not([type="radio"]):not([type="file"]),
+textarea,
+select,
+.vTextField,
+.vDateField,
+.vTimeField,
+.vURLField {
+    background: var(--surface-raised);
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-sm);
+    padding: 8px 10px;
+    font-size: 13.5px;
+}
+
+select {
+    padding-top: 6px;
+    padding-bottom: 6px;
+}
+
+select[multiple] {
+    padding: 6px;
+}
+
+input:focus,
+textarea:focus,
+select:focus {
+    border-color: var(--primary);
+    box-shadow: 0 0 0 3px rgba(79, 70, 229, 0.15);
+    outline: none;
+}
+
+html[data-theme="dark"] input:focus,
+html[data-theme="dark"] textarea:focus,
+html[data-theme="dark"] select:focus {
+    box-shadow: 0 0 0 3px rgba(129, 140, 248, 0.25);
+}
+
+.errorlist {
+    border-radius: var(--radius-sm);
+    overflow: hidden;
+}
+
+/* Related-object widgets: FK <select> + add/change/view icon buttons */
+.related-widget-wrapper {
+    align-items: center;
+}
+
+.related-widget-wrapper select {
+    min-width: 260px;
+}
+
+.related-widget-wrapper-link {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 28px;
+    height: 28px;
+    border-radius: var(--radius-sm);
+    background: var(--darkened-bg);
+    border: 1px solid var(--border-color);
+}
+
+.related-widget-wrapper-link:hover {
+    background: var(--selected-bg);
+}
+
+.related-widget-wrapper-link img {
+    width: 14px;
+    height: 14px;
+}
+
+/* Filter-horizontal / filter-vertical (m2m selector) */
+.selector-available-title,
+.selector-chosen-title {
+    border-radius: var(--radius-sm) var(--radius-sm) 0 0;
+    border: 1px solid var(--border-color);
+    border-bottom: none;
+}
+
+.selector-chosen-title {
+    background: var(--primary);
+    color: var(--primary-fg);
+}
+
+.selector-chosen-title label {
+    color: var(--primary-fg);
+}
+
+.selector-available-title {
+    background: var(--darkened-bg);
+}
+
+.selector .selector-filter {
+    background: var(--surface-raised);
+    border-color: var(--border-color);
+}
+
+.selector select {
+    background: var(--surface-raised);
+    border: 1px solid var(--border-color);
+    border-radius: 0 0 var(--radius-sm) var(--radius-sm);
+}
+
+.selector ul.selector-chooser {
+    background: var(--surface-raised);
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-lg);
+    box-shadow: var(--shadow-sm);
+}
+
+.selector-add,
+.selector-remove {
+    border-radius: var(--radius-sm);
+}
+
+.selector-chosen .list-footer-display {
+    border-radius: 0 0 var(--radius-sm) var(--radius-sm);
+}
+
+/* Icon-only chrome (related-object icons, calendar/clock shortcuts, search
+   lookup icon) ships as dark-stroke SVGs meant for a light page — Django's
+   own dark_mode.css doesn't invert them, so they go nearly invisible on a
+   dark surface. Brighten them only in dark mode. */
+html[data-theme="dark"] .related-widget-wrapper-link img,
+html[data-theme="dark"] .related-lookup,
+html[data-theme="dark"] .selector-add,
+html[data-theme="dark"] .selector-remove,
+html[data-theme="dark"] .datetimeshortcuts img,
+html[data-theme="dark"] .calendar-shortcuts img {
+    filter: invert(1) brightness(1.5);
+}
+
+@media (prefers-color-scheme: dark) {
+    :root:not([data-theme="light"]) .related-widget-wrapper-link img,
+    :root:not([data-theme="light"]) .related-lookup,
+    :root:not([data-theme="light"]) .selector-add,
+    :root:not([data-theme="light"]) .selector-remove,
+    :root:not([data-theme="light"]) .datetimeshortcuts img,
+    :root:not([data-theme="light"]) .calendar-shortcuts img {
+        filter: invert(1) brightness(1.5);
+    }
+}