wagtail-developer-reference 0.1.0__tar.gz → 0.1.2__tar.gz

{wagtail_developer_reference-0.1.0/wagtail_developer_reference.egg-info → wagtail_developer_reference-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wagtail-developer-reference
-Version: 0.1.0
+Version: 0.1.2
 Summary: A visual auditing tool for Wagtail developers to track Page models and StreamField blocks.
 Author-email: Four Digits <info@fourdigits.nl>
 Project-URL: Homepage, https://github.com/fourdigits/wagtail-developer-reference
@@ -14,9 +14,11 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.10
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: wagtail>=4.1
+Requires-Dist: wagtail<7.5,>=4.1
 Provides-Extra: dev
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
@@ -37,6 +39,9 @@ In large Wagtail projects, it’s easy to lose track of where specific blocks ar
 
 ## Installation
 
+Compatibility: Python 3.9+ and Wagtail 4.1 through 7.4 LTS. Wagtail 7.4
+itself requires Python 3.10+.
+
 1. Add \`wagtail_developer_reference\` to your \`INSTALLED_APPS\`:
    \`\`\`python
    INSTALLED_APPS = [
@@ -45,9 +50,24 @@ In large Wagtail projects, it’s easy to lose track of where specific blocks ar
    ]
    \`\`\`
 
-2. **Usage:**
-   * Login to the Wagtail Admin as a **superuser**.
+2. Run migrations so Django creates the package permission:
+   ```bash
+   python manage.py migrate
+   ```
+
+3. Grant access in the Django admin:
+   * Open a user or group in the Django admin.
+   * Assign **Wagtail developer reference | developer reference access | Can access the
+     Wagtail developer reference**.
+
+4. **Usage:**
+   * Login to the Wagtail Admin with an account that has that permission explicitly
+     assigned.
    * Find the **"System Registry"** item in the sidebar menu.
 
+By default, no account can see the menu item or access the URLs. Superusers are not
+granted access automatically by this package; assign the permission directly or
+through a group.
+
 ## License
 **Internal Use Only** - Copyright © 2026 Fourdigits. All rights reserved.

{wagtail_developer_reference-0.1.0 → wagtail_developer_reference-0.1.2}/README.md

@@ -13,6 +13,9 @@ In large Wagtail projects, it’s easy to lose track of where specific blocks ar
 
 ## Installation
 
+Compatibility: Python 3.9+ and Wagtail 4.1 through 7.4 LTS. Wagtail 7.4
+itself requires Python 3.10+.
+
 1. Add \`wagtail_developer_reference\` to your \`INSTALLED_APPS\`:
    \`\`\`python
    INSTALLED_APPS = [
@@ -21,9 +24,24 @@ In large Wagtail projects, it’s easy to lose track of where specific blocks ar
    ]
    \`\`\`
 
-2. **Usage:**
-   * Login to the Wagtail Admin as a **superuser**.
+2. Run migrations so Django creates the package permission:
+   ```bash
+   python manage.py migrate
+   ```
+
+3. Grant access in the Django admin:
+   * Open a user or group in the Django admin.
+   * Assign **Wagtail developer reference | developer reference access | Can access the
+     Wagtail developer reference**.
+
+4. **Usage:**
+   * Login to the Wagtail Admin with an account that has that permission explicitly
+     assigned.
    * Find the **"System Registry"** item in the sidebar menu.
 
+By default, no account can see the menu item or access the URLs. Superusers are not
+granted access automatically by this package; assign the permission directly or
+through a group.
+
 ## License
 **Internal Use Only** - Copyright © 2026 Fourdigits. All rights reserved.

{wagtail_developer_reference-0.1.0 → wagtail_developer_reference-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "wagtail-developer-reference"
-version = "0.1.0"
+version = "0.1.2"
 description = "A visual auditing tool for Wagtail developers to track Page models and StreamField blocks."
 readme = "README.md"
 authors = [{name = "Four Digits", email = "info@fourdigits.nl" }]
@@ -14,13 +14,15 @@ classifiers = [
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12"
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14"
 ]
 keywords = ["django", "wagtail", "audit", "streamfield"]
 dependencies = [
-    "wagtail>=4.1",
+    "wagtail>=4.1,<7.5",
 ]
-requires-python = ">=3.10"
+requires-python = ">=3.9"
 
 [project.optional-dependencies]
 dev = [
@@ -44,7 +46,7 @@ include = ["wagtail_developer_reference*"]
 
 [tool.ruff]
 line-length = 88
-target-version = "py310"
+target-version = "py39"
 
 [tool.ruff.lint]
-select = ["E", "F", "W", "I"]
+select = ["E", "F", "W", "I"]

{wagtail_developer_reference-0.1.0 → wagtail_developer_reference-0.1.2}/setup.py

@@ -1,11 +1,11 @@
-from setuptools import setup, find_packages
+from setuptools import find_packages, setup
 
 setup(
     name="wagtail-developer-reference",
-    version="0.1.0",
+    version="0.1.2",
     packages=find_packages(),
     include_package_data=True,
     install_requires=[
-        "wagtail>=4.1",
+        "wagtail>=4.1,<7.5",
     ],
-)
+)

wagtail_developer_reference-0.1.2/wagtail_developer_reference/__init__.py

@@ -0,0 +1 @@
+__version__: str = "0.1.2"

wagtail_developer_reference-0.1.2/wagtail_developer_reference/apps.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from django.apps import AppConfig
+
+
+class WagtailDeveloperReferenceConfig(AppConfig):
+    default_auto_field: str = "django.db.models.BigAutoField"
+    name: str = "wagtail_developer_reference"
+    verbose_name: str = "Wagtail developer reference"

wagtail_developer_reference-0.1.2/wagtail_developer_reference/migrations/0001_initial.py

@@ -0,0 +1,39 @@
+# Generated manually for wagtail-developer-reference.
+
+from django.db import migrations
+from django.db import models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="DeveloperReferencePermission",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "developer reference access",
+                "verbose_name_plural": "developer reference access",
+                "permissions": (
+                    (
+                        "access_developer_reference",
+                        "Can access the Wagtail developer reference",
+                    ),
+                ),
+                "default_permissions": (),
+                "managed": False,
+            },
+        ),
+    ]

wagtail_developer_reference-0.1.2/wagtail_developer_reference/migrations/__init__.py

@@ -0,0 +1 @@
+

wagtail_developer_reference-0.1.2/wagtail_developer_reference/models.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from django.db import models
+
+
+class DeveloperReferencePermission(models.Model):
+    class Meta:
+        default_permissions: tuple[str, ...] = ()
+        managed: bool = False
+        permissions: tuple[tuple[str, str], ...] = (
+            (
+                "access_developer_reference",
+                "Can access the Wagtail developer reference",
+            ),
+        )
+        verbose_name: str = "developer reference access"
+        verbose_name_plural: str = "developer reference access"

wagtail_developer_reference-0.1.2/wagtail_developer_reference/wagtail_hooks.py

@@ -0,0 +1,334 @@
+from __future__ import annotations
+
+import inspect
+from collections.abc import Iterable
+from typing import Any, Literal, TypedDict
+
+from django.contrib.auth.decorators import user_passes_test
+from django.core.exceptions import PermissionDenied
+from django.db.models import Field
+from django.http import HttpRequest, HttpResponse
+from django.shortcuts import render
+from django.template.loader import get_template
+from django.urls import path
+from django.urls import reverse
+from django.urls.resolvers import URLPattern
+from wagtail import hooks
+from wagtail.admin.menu import MenuItem
+from wagtail.blocks import StructBlock
+from wagtail.fields import StreamField
+from wagtail.models import Page
+from wagtail.models import Site, get_page_models
+
+
+ACCESS_PERMISSION_APP_LABEL: str = "wagtail_developer_reference"
+ACCESS_PERMISSION_CODENAME: str = "access_developer_reference"
+ACCESS_PERMISSION_MODEL: str = "developerreferencepermission"
+FieldCategory = Literal["structure", "metadata"]
+ComponentType = Literal["PAGE", "BLOCK"]
+
+
+class UsageData(TypedDict):
+    live: int
+    total: int
+    draft: int
+
+
+class FieldGroups(TypedDict):
+    structure: list[str]
+    metadata: list[str]
+
+
+class AuditItem(TypedDict):
+    site_name: str
+    hierarchy: str
+    clean_name: str
+    type: ComponentType
+    fields: FieldGroups
+    usage: UsageData
+    template: str
+
+
+def user_can_access_developer_reference(user: Any) -> bool:
+    if not getattr(user, "is_authenticated", False):
+        return False
+    if not getattr(user, "is_active", False):
+        return False
+
+    user_has_permission = user.user_permissions.filter(
+        codename=ACCESS_PERMISSION_CODENAME,
+        content_type__app_label=ACCESS_PERMISSION_APP_LABEL,
+        content_type__model=ACCESS_PERMISSION_MODEL,
+    ).exists()
+    group_has_permission = user.groups.filter(
+        permissions__codename=ACCESS_PERMISSION_CODENAME,
+        permissions__content_type__app_label=ACCESS_PERMISSION_APP_LABEL,
+        permissions__content_type__model=ACCESS_PERMISSION_MODEL,
+    ).exists()
+    return user_has_permission or group_has_permission
+
+
+def require_developer_reference_access(user: Any) -> bool:
+    if user_can_access_developer_reference(user):
+        return True
+    raise PermissionDenied
+
+
+class WagtailAuditor:
+    def __init__(self) -> None:
+        self.results: list[AuditItem] = []
+        self.seen_blocks: set[str] = set()
+        self.all_page_models: list[type[Page]] = get_page_models()
+        self.sites: Iterable[Site] = Site.objects.all()
+        self.models_with_streamfields: list[type[Page]] = [
+            model
+            for model in self.all_page_models
+            if any(isinstance(field, StreamField) for field in model._meta.get_fields())
+        ]
+        self.excluded_fields: set[str] = {
+            "path",
+            "depth",
+            "numchild",
+            "content_type",
+            "page_ptr",
+            "go_live_at",
+            "expire_at",
+            "show_in_menus",
+            "first_published_at",
+            "last_published_at",
+            "latest_revision_created_at",
+        }
+
+    def get_template_path(self, template_name: str | None) -> str:
+        if not template_name:
+            return "Default Rendering"
+        try:
+            return get_template(template_name).origin.name
+        except Exception:
+            return "Template not found"
+
+    def _analyze_model_field(
+        self,
+        field: Field[Any, Any],
+    ) -> tuple[str | None, FieldCategory | None]:
+        if field.name in self.excluded_fields:
+            return None, None
+        if not field.is_relation or field.many_to_one:
+            label = getattr(field, "verbose_name", field.name)
+            if hasattr(label, "__str__"):
+                label = str(label).capitalize()
+            field_type = type(field).__name__
+            is_structure = "StreamField" in field_type or "RichTextField" in field_type
+            category = "structure" if is_structure else "metadata"
+            return f"{label} ({field_type})", category
+        return None, None
+
+    def get_internal_structure(self, object_instance: Any) -> FieldGroups:
+        structure_fields: list[str] = []
+        metadata_fields: list[str] = []
+
+        if hasattr(object_instance, "child_blocks"):
+            for name, block in object_instance.child_blocks.items():
+                label = getattr(block.meta, "label", name)
+                structure_fields.append(f"{label} ({type(block).__name__})")
+        elif hasattr(object_instance, "_meta"):
+            for field in object_instance._meta.get_fields():
+                info, category = self._analyze_model_field(field)
+                if category == "structure":
+                    structure_fields.append(info)
+                elif category == "metadata":
+                    metadata_fields.append(info)
+
+        return {"structure": structure_fields, "metadata": metadata_fields}
+
+    def _get_usage_for_site(
+        self,
+        model: type[Page],
+        site: Site,
+        block_name: str | None = None,
+    ) -> UsageData:
+        queryset = model.objects.descendant_of(site.root_page)
+        if block_name:
+            search_key = f'"{block_name}"'
+            fields = model._meta.get_fields()
+            stream_fields: list[str] = [
+                f.name for f in fields if isinstance(f, StreamField)
+            ]
+            total_count = 0
+            live_count = 0
+            for field_name in stream_fields:
+                total_count += queryset.filter(
+                    **{f"{field_name}__icontains": search_key}
+                ).count()
+                live_count += queryset.live().filter(
+                    **{f"{field_name}__icontains": search_key}
+                ).count()
+        else:
+            total_count = queryset.count()
+            live_count = queryset.live().count()
+        return {
+            "live": live_count,
+            "total": total_count,
+            "draft": total_count - live_count,
+        }
+
+    def process_block(
+        self,
+        block_name: str,
+        block_object: Any,
+        parent_label: str,
+        site: Site,
+    ) -> None:
+        is_class = inspect.isclass(block_object)
+        block_class = (
+            block_object.__name__ if is_class else block_object.__class__.__name__
+        )
+        signature = f"{site.id}_{block_class}_{block_name}"
+        if signature in self.seen_blocks:
+            return
+
+        site_usage = {"live": 0, "total": 0, "draft": 0}
+        for model in self.models_with_streamfields:
+            usage_data = self._get_usage_for_site(model, site, block_name)
+            site_usage["live"] += usage_data["live"]
+            site_usage["total"] += usage_data["total"]
+            site_usage["draft"] += usage_data["draft"]
+
+        block_label = str(getattr(block_object.meta, "label", block_name))
+        self.results.append(
+            {
+                "site_name": str(site),
+                "hierarchy": f"{parent_label} → {block_label}",
+                "clean_name": block_name,
+                "type": "BLOCK",
+                "fields": self.get_internal_structure(block_object),
+                "usage": site_usage,
+                "template": self.get_template_path(
+                    getattr(block_object.meta, "template", None)
+                ),
+            }
+        )
+        self.seen_blocks.add(signature)
+
+        if isinstance(block_object, StructBlock):
+            for child_name, child_object in block_object.child_blocks.items():
+                self.process_block(child_name, child_object, parent_label, site)
+
+    def run(self) -> list[AuditItem]:
+        for site in self.sites:
+            for model in self.all_page_models:
+                usage_data = self._get_usage_for_site(model, site)
+                default_tpl = f"{model._meta.app_label}/{model._meta.model_name}.html"
+                self.results.append(
+                    {
+                        "site_name": str(site),
+                        "hierarchy": str(model._meta.verbose_name).title(),
+                        "clean_name": model.__name__,
+                        "type": "PAGE",
+                        "fields": self.get_internal_structure(model),
+                        "usage": usage_data,
+                        "template": self.get_template_path(
+                            getattr(model, "template", default_tpl)
+                        ),
+                    }
+                )
+                for field in model._meta.get_fields():
+                    if isinstance(field, StreamField):
+                        child_blocks = field.stream_block.child_blocks.items()
+                        for block_name, block_object in child_blocks:
+                            self.process_block(
+                                block_name,
+                                block_object,
+                                str(model._meta.verbose_name).title(),
+                                site,
+                            )
+        return self.results
+
+
+@user_passes_test(require_developer_reference_access)
+def developer_reference_view(request: HttpRequest) -> HttpResponse:
+    auditor = WagtailAuditor()
+    audit_results = auditor.run()
+    sorted_results = sorted(
+        audit_results,
+        key=lambda item: (item["site_name"], item["hierarchy"]),
+    )
+    return render(request, "index.html", {"audit_data": sorted_results})
+
+
+@user_passes_test(require_developer_reference_access)
+def developer_usage_detail_view(
+    request: HttpRequest,
+    component_type: str,
+    component_name: str,
+) -> HttpResponse:
+    site_filter_name = request.GET.get("site")
+    found_pages: list[Page] = []
+    if component_type == "PAGE":
+        target_model = next(
+            (model for model in get_page_models() if model.__name__ == component_name),
+            None,
+        )
+        if target_model:
+            found_pages = list(target_model.objects.all())
+    else:
+        search_key = f'"{component_name}"'
+        for model in get_page_models():
+            stream_fields = [
+                f.name
+                for f in model._meta.get_fields()
+                if isinstance(f, StreamField)
+            ]
+            for field_name in stream_fields:
+                found_pages.extend(
+                    list(
+                        model.objects.filter(
+                            **{f"{field_name}__icontains": search_key}
+                        )
+                    )
+                )
+
+    if site_filter_name:
+        found_pages = [
+            page
+            for page in found_pages
+            if str(page.get_site()) == site_filter_name
+        ]
+
+    unique_pages = {page.id: page for page in found_pages}.values()
+    return render(
+        request,
+        "detail.html",
+        {
+            "component_name": component_name,
+            "pages": unique_pages,
+        },
+    )
+
+
+@hooks.register("register_admin_urls")
+def register_admin_urls() -> list[URLPattern]:
+    return [
+        path("developer-reference/", developer_reference_view, name="dev_reference"),
+        path(
+            "developer-reference/<str:component_type>/<str:component_name>/",
+            developer_usage_detail_view,
+            name="dev_usage_detail",
+        ),
+    ]
+
+
+class DeveloperReferenceMenuItem(MenuItem):
+    def is_shown(self, request: HttpRequest) -> bool:
+        return user_can_access_developer_reference(request.user)
+
+
+@hooks.register("register_admin_menu_item")
+def register_menu() -> MenuItem:
+    url = reverse("dev_reference")
+    return DeveloperReferenceMenuItem(
+        "System Registry",
+        url,
+        icon_name="code",
+        order=10000,
+    )

{wagtail_developer_reference-0.1.0 → wagtail_developer_reference-0.1.2/wagtail_developer_reference.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wagtail-developer-reference
-Version: 0.1.0
+Version: 0.1.2
 Summary: A visual auditing tool for Wagtail developers to track Page models and StreamField blocks.
 Author-email: Four Digits <info@fourdigits.nl>
 Project-URL: Homepage, https://github.com/fourdigits/wagtail-developer-reference
@@ -14,9 +14,11 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.10
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: wagtail>=4.1
+Requires-Dist: wagtail<7.5,>=4.1
 Provides-Extra: dev
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
@@ -37,6 +39,9 @@ In large Wagtail projects, it’s easy to lose track of where specific blocks ar
 
 ## Installation
 
+Compatibility: Python 3.9+ and Wagtail 4.1 through 7.4 LTS. Wagtail 7.4
+itself requires Python 3.10+.
+
 1. Add \`wagtail_developer_reference\` to your \`INSTALLED_APPS\`:
    \`\`\`python
    INSTALLED_APPS = [
@@ -45,9 +50,24 @@ In large Wagtail projects, it’s easy to lose track of where specific blocks ar
    ]
    \`\`\`
 
-2. **Usage:**
-   * Login to the Wagtail Admin as a **superuser**.
+2. Run migrations so Django creates the package permission:
+   ```bash
+   python manage.py migrate
+   ```
+
+3. Grant access in the Django admin:
+   * Open a user or group in the Django admin.
+   * Assign **Wagtail developer reference | developer reference access | Can access the
+     Wagtail developer reference**.
+
+4. **Usage:**
+   * Login to the Wagtail Admin with an account that has that permission explicitly
+     assigned.
    * Find the **"System Registry"** item in the sidebar menu.
 
+By default, no account can see the menu item or access the URLs. Superusers are not
+granted access automatically by this package; assign the permission directly or
+through a group.
+
 ## License
 **Internal Use Only** - Copyright © 2026 Fourdigits. All rights reserved.

{wagtail_developer_reference-0.1.0 → wagtail_developer_reference-0.1.2}/wagtail_developer_reference.egg-info/SOURCES.txt

@@ -4,11 +4,14 @@ pyproject.toml
 setup.py
 wagtail_developer_reference/__init__.py
 wagtail_developer_reference/apps.py
+wagtail_developer_reference/models.py
 wagtail_developer_reference/wagtail_hooks.py
 wagtail_developer_reference.egg-info/PKG-INFO
 wagtail_developer_reference.egg-info/SOURCES.txt
 wagtail_developer_reference.egg-info/dependency_links.txt
 wagtail_developer_reference.egg-info/requires.txt
 wagtail_developer_reference.egg-info/top_level.txt
+wagtail_developer_reference/migrations/0001_initial.py
+wagtail_developer_reference/migrations/__init__.py
 wagtail_developer_reference/templates/detail.html
 wagtail_developer_reference/templates/index.html

{wagtail_developer_reference-0.1.0 → wagtail_developer_reference-0.1.2}/wagtail_developer_reference.egg-info/requires.txt

@@ -1,4 +1,4 @@
-wagtail>=4.1
+wagtail<7.5,>=4.1
 
 [dev]
 ruff

wagtail_developer_reference-0.1.0/wagtail_developer_reference/apps.py

@@ -1,4 +0,0 @@
-from django.apps import AppConfig
-
-class WagtailDeveloperReferenceConfig(AppConfig):
-    name = "wagtail_developer_reference"

wagtail_developer_reference-0.1.0/wagtail_developer_reference/wagtail_hooks.py

@@ -1,185 +0,0 @@
-import inspect
-
-from django.contrib.auth.decorators import user_passes_test
-from django.core.exceptions import PermissionDenied
-from django.shortcuts import render
-from django.template.loader import get_template
-from django.urls import path
-from wagtail import hooks
-from wagtail.admin.menu import MenuItem
-from wagtail.blocks import StructBlock
-from wagtail.fields import StreamField
-from wagtail.models import Site, get_page_models
-
-
-def is_superuser(user):
-    if user.is_superuser:
-        return True
-    raise PermissionDenied
-
-
-class WagtailAuditor:
-    def __init__(self):
-        self.results = []
-        self.seen_blocks = set()
-        self.all_page_models = get_page_models()
-        self.sites = Site.objects.all()
-        self.models_with_streamfields = [
-            model for model in self.all_page_models
-            if any(isinstance(field, StreamField) for field in model._meta.get_fields())
-        ]
-        self.excluded_fields = {
-            "path", "depth", "numchild", "content_type", "page_ptr",
-            "go_live_at", "expire_at", "show_in_menus", "first_published_at",
-            "last_published_at", "latest_revision_created_at",
-        }
-
-    def get_template_path(self, template_name):
-        if not template_name:
-            return "Default Rendering"
-        try:
-            return get_template(template_name).origin.name
-        except Exception:
-            return "Template not found"
-
-    def _analyze_model_field(self, field):
-        if field.name in self.excluded_fields:
-            return None, None
-        if not field.is_relation or field.many_to_one:
-            label = getattr(field, "verbose_name", field.name)
-            if hasattr(label, "__str__"):
-                label = str(label).capitalize()
-            field_type = type(field).__name__
-            is_structure = "StreamField" in field_type or "RichTextField" in field_type
-            category = "structure" if is_structure else "metadata"
-            return f"{label} ({field_type})", category
-        return None, None
-
-    def get_internal_structure(self, object_instance):
-        structure_fields = []
-        metadata_fields = []
-
-        if hasattr(object_instance, "child_blocks"):
-            for name, block in object_instance.child_blocks.items():
-                label = getattr(block.meta, "label", name)
-                structure_fields.append(f"{label} ({type(block).__name__})")
-        elif hasattr(object_instance, "_meta"):
-            for field in object_instance._meta.get_fields():
-                info, category = self._analyze_model_field(field)
-                if category == "structure":
-                    structure_fields.append(info)
-                elif category == "metadata":
-                    metadata_fields.append(info)
-
-        return {"structure": structure_fields, "metadata": metadata_fields}
-
-    def _get_usage_for_site(self, model, site, block_name=None):
-        queryset = model.objects.descendant_of(site.root_page)
-        if block_name:
-            search_key = f'"{block_name}"'
-            fields = model._meta.get_fields()
-            stream_fields = [f.name for f in fields if isinstance(f, StreamField)]
-            total_count = 0
-            live_count = 0
-            for field_name in stream_fields:
-                total_count += queryset.filter(**{f"{field_name}__icontains": search_key}).count()
-                live_count += queryset.live().filter(**{f"{field_name}__icontains": search_key}).count()
-        else:
-            total_count = queryset.count()
-            live_count = queryset.live().count()
-        return {"live": live_count, "total": total_count, "draft": total_count - live_count}
-
-    def process_block(self, block_name, block_object, parent_label, site):
-        is_class = inspect.isclass(block_object)
-        block_class = block_object.__name__ if is_class else block_object.__class__.__name__
-        signature = f"{site.id}_{block_class}_{block_name}"
-        if signature in self.seen_blocks:
-            return
-
-        site_usage = {"live": 0, "total": 0, "draft": 0}
-        for model in self.models_with_streamfields:
-            usage_data = self._get_usage_for_site(model, site, block_name)
-            site_usage["live"] += usage_data["live"]
-            site_usage["total"] += usage_data["total"]
-            site_usage["draft"] += usage_data["draft"]
-
-        self.results.append({
-            "site_name": str(site),
-            "hierarchy": f"{parent_label} → {str(getattr(block_object.meta, 'label', block_name))}",
-            "clean_name": block_name,
-            "type": "BLOCK",
-            "fields": self.get_internal_structure(block_object),
-            "usage": site_usage,
-            "template": self.get_template_path(getattr(block_object.meta, "template", None)),
-        })
-        self.seen_blocks.add(signature)
-
-        if isinstance(block_object, StructBlock):
-            for child_name, child_object in block_object.child_blocks.items():
-                self.process_block(child_name, child_object, parent_label, site)
-
-    def run(self):
-        for site in self.sites:
-            for model in self.all_page_models:
-                usage_data = self._get_usage_for_site(model, site)
-                default_tpl = f"{model._meta.app_label}/{model._meta.model_name}.html"
-                self.results.append({
-                    "site_name": str(site),
-                    "hierarchy": str(model._meta.verbose_name).title(),
-                    "clean_name": model.__name__,
-                    "type": "PAGE",
-                    "fields": self.get_internal_structure(model),
-                    "usage": usage_data,
-                    "template": self.get_template_path(getattr(model, "template", default_tpl)),
-                })
-                for field in model._meta.get_fields():
-                    if isinstance(field, StreamField):
-                        for block_name, block_object in field.stream_block.child_blocks.items():
-                            self.process_block(block_name, block_object, str(model._meta.verbose_name).title(), site)
-        return self.results
-
-
-@user_passes_test(is_superuser)
-def developer_reference_view(request):
-    auditor = WagtailAuditor()
-    audit_results = auditor.run()
-    sorted_results = sorted(audit_results, key=lambda item: (item["site_name"], item["hierarchy"]))
-    return render(request, "index.html", {"audit_data": sorted_results})
-
-
-@user_passes_test(is_superuser)
-def developer_usage_detail_view(request, component_type, component_name):
-    site_filter_name = request.GET.get('site')
-    found_pages = []
-    if component_type == "PAGE":
-        target_model = next((model for model in get_page_models() if model.__name__ == component_name), None)
-        if target_model:
-            found_pages = target_model.objects.all()
-    else:
-        search_key = f'"{component_name}"'
-        for model in get_page_models():
-            stream_fields = [f.name for f in model._meta.get_fields() if isinstance(f, StreamField)]
-            for field_name in stream_fields:
-                found_pages.extend(list(model.objects.filter(**{f"{field_name}__icontains": search_key})))
-
-    if site_filter_name:
-        found_pages = [page for page in found_pages if str(page.get_site()) == site_filter_name]
-
-    unique_pages = {page.id: page for page in found_pages}.values()
-    return render(request, "detail.html", {
-        "component_name": component_name,
-        "pages": unique_pages
-    })
-
-
-@hooks.register("register_admin_urls")
-def register_admin_urls():
-    return [
-        path("developer-reference/", developer_reference_view, name="dev_reference"),
-        path("developer-reference/<str:component_type>/<str:component_name>/", developer_usage_detail_view, name="dev_usage_detail"),
-    ]
-
-
-@hooks.register("register_admin_menu_item")
-def register_menu():
-    return MenuItem("System Registry", "/admin/developer-reference/", icon_name="code", order=10000)