add admin UX quick wins: nav guard, block descriptions, input labels

- rename "Providers" to "Print providers" in sidebar (#110)
- add LiveView navigation guard to EditorKeyboard hook — intercepts
  link clicks in capture phase when editor has unsaved changes (#103)
- add description field to all 26 block types, shown as subtitle in
  block picker; filter searches descriptions too (#104)
- add visible column headers (Label / Path) and proper sr-only labels
  with for attributes on nav editor inputs (#106)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

lib/berrypod/pages/block_types.ex

@@ -16,6 +16,7 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "hero" => %{
       name: "Hero banner",
+      description: "Full-width banner with title, description and call-to-action buttons",
       icon: "hero-megaphone",
       allowed_on: :all,
       settings_schema: [
@@ -46,6 +47,7 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "featured_products" => %{
       name: "Featured products",
+      description: "Grid of product cards — choose how many and which style",
       icon: "hero-star",
       allowed_on: :all,
       settings_schema: [
@@ -87,6 +89,7 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "image_text" => %{
       name: "Image + text",
+      description: "Side-by-side image and text with optional link",
       icon: "hero-photo",
       allowed_on: :all,
       settings_schema: [
@@ -100,24 +103,28 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "category_nav" => %{
       name: "Category navigation",
+      description: "Clickable category pills linking to filtered product collections",
       icon: "hero-squares-2x2",
       allowed_on: :all,
       settings_schema: []
     },
     "newsletter_card" => %{
       name: "Newsletter signup",
+      description: "Email signup form for collecting subscriber addresses",
       icon: "hero-envelope",
       allowed_on: :all,
       settings_schema: []
     },
     "social_links_card" => %{
       name: "Social links",
+      description: "Icons linking to your social media profiles",
       icon: "hero-share",
       allowed_on: :all,
       settings_schema: []
     },
     "info_card" => %{
       name: "Info card",
+      description: "Key-value list for shop details like materials, sizing or delivery info",
       icon: "hero-information-circle",
       allowed_on: :all,
       settings_schema: [
@@ -136,12 +143,14 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "trust_badges" => %{
       name: "Trust badges",
+      description: "Icons for free shipping, secure payment and quality guarantees",
       icon: "hero-shield-check",
       allowed_on: :all,
       settings_schema: []
     },
     "reviews_section" => %{
       name: "Customer reviews",
+      description: "Star ratings and customer testimonials",
       icon: "hero-chat-bubble-left-right",
       allowed_on: :all,
       settings_schema: [],
@@ -149,6 +158,7 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "spacer" => %{
       name: "Spacer",
+      description: "Vertical breathing room between blocks",
       icon: "hero-arrows-up-down",
       allowed_on: :all,
       settings_schema: [
@@ -163,6 +173,7 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "divider" => %{
       name: "Divider",
+      description: "Horizontal line, dots or fade to separate sections",
       icon: "hero-minus",
       allowed_on: :all,
       settings_schema: [
@@ -177,6 +188,7 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "button" => %{
       name: "Button",
+      description: "Standalone call-to-action button linking to any page",
       icon: "hero-cursor-arrow-rays",
       allowed_on: :all,
       settings_schema: [
@@ -200,6 +212,7 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "video_embed" => %{
       name: "Video embed",
+      description: "Embedded YouTube or Vimeo video with optional caption",
       icon: "hero-play",
       allowed_on: :all,
       settings_schema: [
@@ -219,24 +232,28 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "product_hero" => %{
       name: "Product hero",
+      description: "Product image gallery, title, price and add-to-cart button",
       icon: "hero-cube",
       allowed_on: ["pdp"],
       settings_schema: []
     },
     "breadcrumb" => %{
       name: "Breadcrumb",
+      description: "Navigation trail showing Home > Category > Product",
       icon: "hero-chevron-right",
       allowed_on: ["pdp"],
       settings_schema: []
     },
     "product_details" => %{
       name: "Product details",
+      description: "Full product description text",
       icon: "hero-document-text",
       allowed_on: ["pdp"],
       settings_schema: []
     },
     "related_products" => %{
       name: "Related products",
+      description: "Products from the same category",
       icon: "hero-squares-plus",
       allowed_on: ["pdp"],
       settings_schema: [],
@@ -247,18 +264,21 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "collection_header" => %{
       name: "Collection header",
+      description: "Category title and product count",
       icon: "hero-tag",
       allowed_on: ["collection"],
       settings_schema: []
     },
     "filter_bar" => %{
       name: "Filter bar",
+      description: "Category filter pills and sort dropdown",
       icon: "hero-funnel",
       allowed_on: ["collection"],
       settings_schema: []
     },
     "product_grid" => %{
       name: "Product grid",
+      description: "Responsive grid of all products in the collection",
       icon: "hero-squares-2x2",
       allowed_on: ["collection"],
       settings_schema: []
@@ -268,12 +288,14 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "cart_items" => %{
       name: "Cart items",
+      description: "List of items in the customer's cart with quantity controls",
       icon: "hero-shopping-cart",
       allowed_on: ["cart"],
       settings_schema: []
     },
     "order_summary" => %{
       name: "Order summary",
+      description: "Subtotal, shipping estimate and checkout button",
       icon: "hero-calculator",
       allowed_on: ["cart"],
       settings_schema: []
@@ -283,6 +305,7 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "contact_form" => %{
       name: "Contact form",
+      description: "Name, email and message form that sends to your inbox",
       icon: "hero-envelope",
       allowed_on: ["contact"],
       settings_schema: [
@@ -291,6 +314,7 @@ defmodule Berrypod.Pages.BlockTypes do
     },
     "order_tracking_card" => %{
       name: "Order tracking",
+      description: "Lets customers look up their order status",
       icon: "hero-truck",
       allowed_on: ["contact"],
       settings_schema: []
@@ -300,6 +324,7 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "content_body" => %{
       name: "Page content",
+      description: "Rich text block with optional image — the main body of a content page",
       icon: "hero-document-text",
       allowed_on: :all,
       settings_schema: [
@@ -319,6 +344,7 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "checkout_result" => %{
       name: "Checkout result",
+      description: "Order confirmation message with order number",
       icon: "hero-check-circle",
       allowed_on: ["checkout_success"],
       settings_schema: []
@@ -328,6 +354,7 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "order_card" => %{
       name: "Order cards",
+      description: "List of past orders with status and totals",
       icon: "hero-clipboard-document-list",
       allowed_on: ["orders"],
       settings_schema: []
@@ -337,6 +364,7 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "order_detail_card" => %{
       name: "Order detail",
+      description: "Full order breakdown with items, shipping and payment info",
       icon: "hero-clipboard-document",
       allowed_on: ["order_detail"],
       settings_schema: []
@@ -346,6 +374,7 @@ defmodule Berrypod.Pages.BlockTypes do
 
     "search_results" => %{
       name: "Search results",
+      description: "Product search results grid with thumbnails and prices",
       icon: "hero-magnifying-glass",
       allowed_on: ["search"],
       settings_schema: []

lib/berrypod_web/components/block_editor_components.ex

@@ -416,7 +416,8 @@ defmodule BerrypodWeb.BlockEditorComponents do
     filtered =
       assigns.allowed_blocks
       |> Enum.filter(fn {_type, def} ->
-        filter == "" or String.contains?(String.downcase(def.name), filter)
+        filter == "" or String.contains?(String.downcase(def.name), filter) or
+          String.contains?(String.downcase(Map.get(def, :description, "")), filter)
       end)
       |> Enum.sort_by(fn {_type, def} -> def.name end)
 
@@ -454,7 +455,10 @@ defmodule BerrypodWeb.BlockEditorComponents do
             class="block-picker-item"
           >
             <.icon name={def.icon} class="size-5" />
-            <span>{def.name}</span>
+            <span class="block-picker-item-name">{def.name}</span>
+            <span :if={def[:description]} class="block-picker-item-desc">
+              {def.description}
+            </span>
           </button>
 
           <p :if={@filtered_blocks == []} class="block-picker-empty">

lib/berrypod_web/components/layouts/admin.html.heex

@@ -91,7 +91,7 @@
               navigate={~p"/admin/providers"}
               class={admin_nav_active?(@current_path, "/admin/providers")}
             >
-              <.icon name="hero-link" class="size-5" /> Providers
+              <.icon name="hero-link" class="size-5" /> Print providers
             </.link>
           </li>
           <li>

lib/berrypod_web/live/admin/navigation.ex

@@ -158,13 +158,19 @@ defmodule BerrypodWeb.Admin.Navigation do
       </h3>
 
       <div class="space-y-2">
+        <div :if={@items != []} class="nav-editor-labels" aria-hidden="true">
+          <span>Label</span>
+          <span>Path</span>
+        </div>
         <div
           :for={{item, idx} <- Enum.with_index(@items)}
           class="nav-editor-item"
         >
           <div class="nav-editor-fields">
+            <label class="sr-only" for={"nav-#{@section}-#{idx}-label"}>Label</label>
             <input
               type="text"
+              id={"nav-#{@section}-#{idx}-label"}
               value={item["label"]}
               placeholder="Label"
               phx-blur="update_item"
@@ -173,8 +179,10 @@ defmodule BerrypodWeb.Admin.Navigation do
               phx-value-field="label"
               class="admin-input nav-editor-input"
             />
+            <label class="sr-only" for={"nav-#{@section}-#{idx}-href"}>Path</label>
             <input
               type="text"
+              id={"nav-#{@section}-#{idx}-href"}
               value={item["href"]}
               placeholder="/path"
               phx-blur="update_item"