@eeacms/volto-cca-policy 1.0.3 → 1.0.5

package/theme/globals/navigator.less

@@ -8,6 +8,39 @@
 @navigatorIconBackgroundColor: #f5f9fb;
 @navigatorIconColor: #7890a2;
 
+.navigator-small-clear-button() {
+  display: inline-flex;
+  width: 28px;
+  height: 28px;
+  min-height: 28px;
+  align-items: center;
+  justify-content: center;
+  padding: 0 !important;
+  border: 0;
+  border-radius: 50%;
+  margin: 0 !important;
+  background: transparent;
+  box-shadow: none;
+  color: #607482;
+  line-height: 1;
+
+  i.icon {
+    display: block;
+    width: auto;
+    height: auto;
+    margin: 0 !important;
+    font-size: 1rem;
+    line-height: 1;
+  }
+
+  &:hover,
+  &:focus {
+    background: #e8f0f5;
+    box-shadow: none;
+    color: #30495b;
+  }
+}
+
 .navigator-tool-icon {
   display: inline-flex;
   flex: 0 0 auto;
@@ -16,7 +49,7 @@
   box-sizing: border-box;
   border: 1px solid @navigatorIconBorderColor;
   border-radius: 4px;
-  background-color: #fff;
+  background-color: #f7f8fa;
   color: @navigatorIconColor;
 
   i.icon {
@@ -77,6 +110,10 @@
     margin: 0 !important;
   }
 
+  .navigator-tool-icon {
+    background-color: #fff;
+  }
+
   .compare-panel-content {
     padding: 1rem;
   }
@@ -154,37 +191,8 @@
   }
 
   .ui.button.compare-panel-tool-clear {
-    display: inline-flex;
-    width: 28px;
-    height: 28px;
-    min-height: 28px;
+    .navigator-small-clear-button();
     flex: 0 0 auto;
-    align-items: center;
-    justify-content: center;
-    padding: 0 !important;
-    border: 0;
-    border-radius: 50%;
-    margin: 0 !important;
-    background: transparent;
-    box-shadow: none;
-    color: #607482;
-    line-height: 1;
-
-    i.icon {
-      display: block;
-      width: auto;
-      height: auto;
-      margin: 0 !important;
-      font-size: 1rem;
-      line-height: 1;
-    }
-
-    &:hover,
-    &:focus {
-      background: #e8f0f5;
-      box-shadow: none;
-      color: #30495b;
-    }
   }
 
   .compare-panel-actions {
@@ -206,15 +214,12 @@
     }
   }
 
-  .ui.button.compare-panel-submit {
-    margin: 0;
-  }
-
-  .compare-panel-clear-all {
+  .ui.button.compare-panel-clear-all {
     padding: 0;
     margin: 0;
-    background: transparent;
-    color: @linkColor;
+    border: none;
+    background: none !important;
+    color: @primaryColor;
 
     &:hover,
     &:focus {
@@ -320,7 +325,8 @@
     table-layout: fixed;
 
     thead th,
-    tbody td {
+    tbody td,
+    tbody th {
       border-color: @navigatorBorderColor;
     }
 
@@ -335,15 +341,18 @@
       vertical-align: bottom;
     }
 
-    tbody td {
+    tbody td,
+    tbody th {
       min-height: 84px;
       padding: 1.35rem 1.25rem;
       line-height: 1.45;
       vertical-align: top;
       background: #fff;
+      font-weight: inherit;
+      text-align: left;
     }
 
-    tbody td:first-child {
+    tbody th:first-child {
       background: @navigatorCriteriaBackgroundColor;
     }
   }
@@ -430,40 +439,136 @@
   }
 }
 
-body.searchlib-page .searchapp-navigatorCatalogueSearch {
-  .back-link {
-    display: none;
+.navigator-catalogue-map {
+  display: grid;
+  width: 100%;
+  height: 600px;
+  min-height: 600px;
+  align-items: stretch;
+  gap: 1.5rem;
+  grid-template-columns: minmax(0, 4fr) minmax(12rem, 1fr);
+
+  .ol-map-wrapper,
+  .ol-map {
+    height: 600px;
   }
 
-  .search-input,
-  .sui-search-box {
-    margin-bottom: 2rem;
+  .navigator-catalogue-map-canvas {
+    position: relative;
+    min-width: 0;
+    height: 100%;
+  }
+
+  .ol-map {
+    width: 100%;
+    height: 100%;
   }
 
-  .navigator-catalogue-map-placeholder {
+  .ol-layer {
+    transition: opacity 0.3s ease;
+  }
+}
+
+.navigator-catalogue-map-loading {
+  text-align: center;
+  display: flex;
+  flex-direction: column;
+  gap: 1em;
+}
+.navigator-catalogue-map-tooltip {
+  position: absolute;
+  z-index: 1000;
+  min-width: 200px;
+  max-width: 280px;
+  padding: 1em;
+  margin-top: -10px;
+  margin-left: 15px;
+  background: #fff;
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.15);
+  pointer-events: auto;
+
+  .tooltip-header {
+    font-size: 16px;
+  }
+
+  .tooltip-body {
+    margin: 1em 0;
+    font-size: 0.875rem;
+  }
+
+  .tooltip-actions {
+    .ui.button {
+      width: 100%;
+      margin: 0;
+    }
+  }
+
+  .ui.button.tooltip-close {
+    .navigator-small-clear-button();
+    position: absolute;
+    top: 0.5rem;
+    right: 0.5rem;
+  }
+}
+
+.navigator-catalogue-map-legend {
+  font-size: 16px;
+
+  .legend-title {
+    margin-top: 0;
+  }
+
+  .legend-item {
     display: flex;
-    min-height: 320px;
     align-items: center;
-    justify-content: center;
-    border: 1px dashed @navigatorBorderColor;
-    color: @navigatorMetaTextColor;
-    gap: 1rem;
+    padding: 0.2rem 0;
+    gap: 0.5rem;
 
-    i.icon {
-      color: @secondaryColor;
-      font-size: 2.5rem;
+    .legend-color {
+      display: inline-block;
+      width: 16px;
+      height: 16px;
+      flex-shrink: 0;
     }
+  }
+}
 
-    h3 {
-      margin-bottom: 0.25rem;
-      color: @primaryColor;
-    }
+@media only screen and (max-width: 768px) {
+  .navigator-catalogue-map {
+    height: auto;
+    min-height: 0;
+    grid-template-columns: minmax(0, 1fr);
 
-    p {
-      margin: 0;
+    .navigator-catalogue-map-canvas {
+      height: 400px;
+      min-height: 350px;
     }
   }
 
+  .navigator-catalogue-map-tooltip {
+    top: auto !important;
+    bottom: 1rem;
+    left: 50% !important;
+    margin-left: 0;
+    transform: translateX(-50%);
+  }
+
+  .navigator-catalogue-map-legend {
+    width: 100%;
+    box-sizing: border-box;
+  }
+}
+
+body.searchlib-page .searchapp-navigatorCatalogueSearch {
+  .back-link {
+    display: none;
+  }
+
+  .search-input,
+  .sui-search-box {
+    margin-bottom: 2rem;
+  }
+
   .ui.right.sidebar {
     background-color: #fff;
     box-shadow: -4px 0 4px rgba(0, 0, 0, 0.25);
@@ -588,7 +693,7 @@ body.searchlib-page .searchapp-navigatorCatalogueSearch {
   }
 
   .license-type {
-    gap: 0.5em;
+    gap: 0.7em;
   }
 
   .navigator-catalogue-cycle-elements {
@@ -663,7 +768,6 @@ body.searchlib-page .searchapp-navigatorCatalogueSearch {
   min-height: 24px;
   align-items: center;
   padding: 0 0.45rem;
-  border-radius: 2px;
   font-weight: 500;
   font-size: 12px;
 
@@ -687,12 +791,22 @@ body.searchlib-page .searchapp-navigatorCatalogueSearch {
     background: #ddd8f5;
     color: #51458a;
   }
+
+  &.more {
+    border: 0;
+    cursor: pointer;
+    font-family: inherit;
+  }
 }
 
 .navigator-guide-search {
   .navigator-guide-header {
     margin-bottom: 2rem;
     text-align: center;
+
+    h2 {
+      margin-top: 0.5em;
+    }
   }
 
   .navigator-guide-preview-header {
@@ -705,10 +819,11 @@ body.searchlib-page .searchapp-navigatorCatalogueSearch {
 
   .navigator-guide-eyebrow,
   .navigator-guide-preview-label {
-    font-size: 0.75rem;
+    font-size: 13px;
     font-weight: 700;
     letter-spacing: 0.08em;
     text-transform: uppercase;
+    color: @navigatorAccentColor;
   }
 
   .navigator-guide-layout {
@@ -902,7 +1017,6 @@ body.searchlib-page .searchapp-navigatorCatalogueSearch {
     &.selected {
       border-color: @primaryColor;
       background: fade(@primaryColor, 5%);
-      font-weight: 500;
     }
 
     > span {

package/artifacts/BLOCKS.md

@@ -1,167 +0,0 @@
-# Custom Blocks in `volto-cca-policy`
-
-This addon registers **20 custom blocks** and extends **2 existing blocks** (Listing, Tabs Block) with new variations.
-All blocks are installed via `src/components/manage/Blocks/index.js`.
-
----
-
-## Custom Blocks
-
-### AST Navigation
-- **Block ID:** `astNavigation`
-- **Group:** `site`
-- **Restricted to:** Mission pages (via `blockAvailableInMission`)
-- **What it does:** Renders a visual navigation map (logo map) for the *Adaptation Support Tool (AST)*. Supports two image types (`ast` and `uast`). Editors configure 6 linked items that map to clickable regions on the logo image. Clicking a region navigates to the corresponding content page.
-
-### C3S Indicators Glossary
-- **Block ID:** `c3SIndicatorsGlossaryBlock`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Displays a glossary table of C3S (Copernicus Climate Change Service) indicator terms. The content is provided by a server-side `@components` view (`c3s_indicators_glossary_table`) and rendered as raw HTML.
-
-### C3S Indicators Listing
-- **Block ID:** `c3SIndicatorListingBlock`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Renders a description and a linked list of C3S indicators. Content (description text + item list with URLs) is provided by the server-side `@components` view `c3s_indicators_listing`.
-
-### C3S Indicators Overview
-- **Block ID:** `c3SIndicatorsOverviewBlock`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Displays an HTML description/overview of C3S indicators, fetched from the server-side `@components` view `c3s_indicators_overview`.
-
-### Case Study Explorer
-- **Block ID:** `caseStudyExplorer`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** An interactive map-based explorer for climate adaptation case studies. Loads case study data from an ArcGIS JSON endpoint (`@@case-studies-map.arcgis.json`). Provides filter controls (sectors, impacts, etc.) and an interactive map with clickable features. Supports URL-based filter parameters.
-
-### Collection Statistics
-- **Block ID:** `collectionStats`
-- **Group:** `site`
-- **What it does:** Displays aggregated statistics for a content collection. Shows two groups of stats with icons and counts:
-  - **Health impacts:** Climate-sensitive diseases, Heat, Wildfires, Droughts and floods, Air pollution and aero-allergens
-  - **Content types:** Adaptation options, Case studies, Guidance, Indicators, Information portals, Organisations, Publications, Research projects, Tools, Videos
-- Stats are computed from query stats via `getQueryStats` and can link to filtered search results.
-
-### Content Links
-- **Block ID:** `contentLinks`
-- **Group:** `site`
-- **Variations:**
-  - `default` — Simple list of linked content items
-  - `navigationList` — Navigation-style list with active-state highlighting based on current URL
-  - `dropdown` — Dropdown selector for linking to content items (with configurable placeholder text)
-- **What it does:** Displays a set of manually selected content items as links. Useful for sidebars, navigation menus, or quick-access link groups.
-
-### Country Map Heat Index
-- **Block ID:** `countryMapHeatIndex`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** An interactive OpenLayers map of European countries colored by heat index data. Fetches metadata from `@@countries-heat-index-json`. Countries are highlighted with tooltips and are clickable, navigating to the respective country page. Includes a filter control and supports lazy loading via visibility sensor.
-
-### Country Map Observatory
-- **Block ID:** `countryMapObservatory`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** An interactive OpenLayers map for the Health Observatory section. Renders EU countries with metadata from `@@countries-metadata-extract-2025`. Supports thematic map modes (e.g., "National adaptation policy"), tooltips, and click-to-navigate interactions. Uses WMS tile sources and lazy loading.
-
-### Country Map Profile
-- **Block ID:** `countryMapProfile`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** An interactive OpenLayers map for country profiles. Renders EU countries with metadata from `@@countries-metadata-extract-2025` (including flag images). Supports thematic map modes, tooltips, click-to-navigate, and a filter control. Uses WMS tile sources and lazy loading.
-
-### Country Profile Detail
-- **Block ID:** `countryProfileDetail`
-- **Group:** `site`
-- **What it does:** Renders the detailed country profile content provided by a server-side `@components` view (`countryprofile.html`). Displays tabbed sections with accordions, including a language disclaimer for non-English content and optional top messages/accordions.
-
-### Data Connected Embed Block
-- **Block ID:** `data_connected_embed` (extends `@eeacms/volto-datablocks`)
-- **What it does:** Customizes the data-connected embed block from `volto-datablocks` to inject the current page language (`lang`) as an additional query parameter. This ensures embedded data visualizations respect the page's language context. Wraps the base `ViewEmbedBlock` with Redux connectivity and `injectIntl`.
-
-### ECDE Indicators
-- **Block ID:** `ecdeIndicators`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Embeds European Climate Data Explorer (ECDE) indicator visualizations from the Copernicus Climate Data Store (CDS). Loads region data from an EEA ArcGIS service and renders interactive CDS toolbox apps (e.g., growing degree days, mean temperature) for selected European NUTS regions.
-
-### Filter AceContent
-- **Block ID:** `filterAceContent`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **Variations:**
-  - `simpleListing` — Listing view (default)
-  - `simpleCards` — Card grid view
-- **What it does:** Provides a faceted search/filter interface for ACE (Adaptation Content Exchange) content. Supports filtering by bio-regions, countries, climate impacts, sectors, element types, funding programmes, macro-regions, key types, and free-text search. Uses a custom select widget with styled dropdowns.
-
-### Flourish Visualization
-- **Block ID:** `FlourishEmbedBlock`
-- **Group:** `site`
-- **What it does:** Embeds interactive data visualizations from [Flourish.studio](https://flourish.studio). Editors paste a Flourish embed code, and the block extracts the visualization URL, wraps it in an iframe with privacy protection (lazy loading via consent gate), and displays it at a fixed height of 980px.
-
-### RAST (Related And Sub-Tree) Block
-- **Block ID:** `rastBlock`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Renders a contextual navigation block showing related content and sub-items from a configurable root path. Supports skipping specific items and optionally showing subfolders. Uses `ContextNavigation` and `RASTAccordion` components to display a hierarchical accordion-style navigation tree.
-
-### Read More
-- **Block ID:** `readMoreBlock`
-- **Group:** `site`
-- **What it does:** Creates a collapsible "read more" section. Wraps all preceding sibling blocks in a height-constrained container with an expand/collapse button. Configurable properties include open/closed labels, button position, and initial height.
-
-### Redirection Block
-- **Block ID:** `redirectBlock`
-- **Group:** `site`
-- **What it does:** Automatically redirects anonymous users to a configured target URL. Logged-in users (editors) see a discreet notice showing the redirect target instead of being redirected, so they can still edit the page.
-
-### Relevant AceContent
-- **Block ID:** `relevantAceContent`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Displays a list of relevant ACE (Adaptation Content Exchange) items. Supports two modes: manually selected items and dynamically searched results (by element type, sector, search type, special tags, or search text). Can combine both modes. Renders as a simple linked list.
-
-### Search AceContent
-- **Block ID:** `searchAceContent`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Displays search results from the ACE content search API. Shows results as a linked list with translated labels and counts. Includes a "Share your information" button linking to the share page.
-
-### Tabs Block — Spotlight Variation
-- **Block ID:** `tabs_block` (extends `@eeacms/volto-tabs-block`)
-- **Variation added:** `spotlight`
-- **What it does:** Adds a "Spotlight" variation to the standard tabs block. Renders tab content with a spotlight-style layout featuring configurable icons or images (with position and size options), simple markdown support, and scroll-to-target behavior.
-
-### Trans Region Select
-- **Block ID:** `transRegionSelect`
-- **Group:** `site`
-- **Restricted to:** Mission pages
-- **What it does:** Renders a dropdown selector for transnational regions. Fetches region data from the content's `@components` view (`transnationalregion`) and provides a dropdown with links to each region's page, plus a default "Other regions" option.
-
----
-
-## Extended Standard Blocks
-
-### Listing (standard Volto block — extended)
-The standard Volto `listing` block is extended with **6 new variations**:
-
-| Variation | Description |
-|-----------|-------------|
-| `dropdown` | Renders listed items as a dropdown selector with a configurable placeholder text |
-| `organisationCards` | Displays items as a 4-column card grid with logo/image and description (for organisations) |
-| `indicatorCards` | Displays C3S/Lancet Countdown indicators as styled cards with title and description |
-| `eventCards` | Displays events as cards with date info, contact details, event URL, and EEA branding |
-| `eventAccordion` | Displays events in an accordion layout with formatted date ranges and "read more" expand |
-| `simpleListing` | Plain text list of linked items (minimal styling) |
-| `simpleCards` | Generic 4-column card grid with image/logo and title |
-
-Additionally, the listing block's `noResultsComponent` is overridden to render nothing (instead of showing "No results" text).
-
----
-
-## Shared Utilities
-
-- **`withResponsiveContainer.js`** — HOC that wraps map blocks in a responsive container (used by Country Map blocks)
-- **`withVisibilitySensor.jsx`** — HOC that defers map initialization until the block is visible in the viewport (lazy loading)

package/artifacts/link-integrity-workflow/README.md

@@ -1,76 +0,0 @@
-# Link Integrity Workflow warning Specification
-
-## Overview
-
-To prevent breaking the browsing experience of public (anonymous) website visitors, Climate-ADAPT intercepts workflow transitions that limit content visibility (such as changing a state to **Private**, **Reject**, or **Retract**). 
-
-Before finalizing these transitions, the system performs an asynchronous backend check using the Plone link integrity relation catalog (`@linkintegrity`) to discover if any other published pages link to the target item. If referencing items are found, the user is presented with a warning modal detailing the pages that link to the item, allowing them to either cancel or proceed anyway.
-
----
-
-## Architectural Workflow
-
-```mermaid
-sequenceDiagram
-    autonumber
-    actor Editor
-    participant WorkflowDropdown as Workflow Dropdown (Workflow.jsx)
-    participant API as Plone REST API (/@linkintegrity)
-    participant WarningModal as Warning Modal (WorkflowLinkIntegrityModal.jsx)
-
-    Editor->>WorkflowDropdown: Select "Make Private" / "Reject" / "Retract"
-    WorkflowDropdown->>API: Dispatch linkIntegrityCheck([UID])
-    WorkflowDropdown->>WarningModal: Open Warning Modal (with Loader active)
-    Note over WarningModal: Action buttons are disabled during check
-
-    alt No breaches exist
-        API-->>WorkflowDropdown: Return 0 breaches
-        WorkflowDropdown->>WorkflowDropdown: Auto-execute workflow transition
-        WorkflowDropdown->>WarningModal: Close Modal automatically
-        WorkflowDropdown-->>Editor: Show success toast
-    else Breaches exist
-        API-->>WorkflowDropdown: Return breach details
-        WorkflowDropdown->>WarningModal: Deactivate Loader & enable confirm
-        WarningModal-->>Editor: Render list of linking pages & warning copy
-        
-        alt Editor clicks "Cancel"
-            Editor->>WarningModal: Click "Cancel"
-            WarningModal->>WorkflowDropdown: Reset pending transition & close modal
-        else Editor clicks "Change state anyway"
-            Editor->>WarningModal: Click "Change state anyway"
-            WarningModal->>WorkflowDropdown: Trigger onOk() -> executeTransition()
-            WorkflowDropdown->>WorkflowDropdown: Execute workflow transition
-            WorkflowDropdown->>WarningModal: Close Modal
-            WorkflowDropdown-->>Editor: Show success toast
-        end
-    end
-```
-
----
-
-## Implementation Details
-
-### 1. Workflow Interception (Customization)
-*   **Path**: [Workflow.jsx](file:///home/tibi/work/eea.docker.plone-climateadapt/cca/frontend/src/addons/volto-cca-policy/src/customizations/volto/components/manage/Workflow/Workflow.jsx)
-*   **Role**: Shadows Volto core's workflow select component. Intercepts transitions containing state keys (`private`, `reject`, `retract`) or URL suffixes (`/reject`, `/retract`). Dispatches `linkIntegrityCheck` and manages `pendingOption` state. Executes transition automatically if 0 breaches are found.
-
-### 2. Warning Modal Component
-*   **Path**: [WorkflowLinkIntegrityModal.jsx](file:///home/tibi/work/eea.docker.plone-climateadapt/cca/frontend/src/addons/volto-cca-policy/src/components/manage/Workflow/WorkflowLinkIntegrityModal.jsx)
-*   **Role**: A plain HTML overlay dialog rendered via `ReactDOM.createPortal` into a `<div>` appended to `document.body`. Zero `semantic-ui-react` dependencies — no `Confirm`, `Modal`, or `Portal`.
-*   **Why not `semantic-ui-react`?** The `Confirm` and `Modal` components use internal Portals, auto-controlled state, and shorthand factory systems that made click handlers unreliable in the toolbar dropdown context. The Toolbar's global `document mousedown` handler (`handleClickOutside`) would intercept clicks, close the menu, and unmount the modal before `onConfirm` could fire.
-*   **Key implementation details**:
-    *   **Portal rendering** — renders at `document.body` level with `z-index: 10000`, placing it outside the toolbar dropdown's DOM subtree and CSS stacking context so it appears as a proper full-page overlay.
-    *   **Capture-phase `mousedown` guard** — a `capture=true` listener on the portal root calls `e.stopPropagation()`, preventing the Toolbar's `handleClickOutside` from firing while the modal is open.
-    *   **Synchronous breach derivation** — `computeBreaches()` computes `brokenReferences` and `breaches` during render (no `useEffect` + `useState`), so the data is always in sync with `loading` in the same render cycle. This prevents a race condition where `loading` becomes `false` but `brokenReferences` is still `0`, causing premature modal closure.
-    *   **Inline styles** — all CSS is embedded via a `<style>` tag, no external stylesheet dependency.
-*   **Key UX Features**:
-    *   Maintains button state `disabled: loading` during ongoing checks to prevent premature actions.
-    *   Renders a CSS spinner and loading text during the check.
-    *   Displays the exact list of referencing (source) items and target sub-items.
-    *   Displays the warning copy:
-        > *"By changing the state, we're not breaking references, but may break user experience for final Anonymous users. There are {brokenReferences} {variation} to this item:"*
-    *   Closes on backdrop click, button click, or `Escape` key.
-
-### 3. Unit Verification Suite
-*   **Path**: [WorkflowLinkIntegrityModal.test.jsx](file:///home/tibi/work/eea.docker.plone-climateadapt/cca/frontend/src/addons/volto-cca-policy/src/components/manage/Workflow/WorkflowLinkIntegrityModal.test.jsx)
-*   **Role**: Houses Jest/React Testing Library assertions verifying loading indicator visibility, auto-proceed behavior with 0 breaches, warnings list aggregation for multiple breaches, and confirm button presence.

package/artifacts/link-integrity-workflow/index.md

@@ -1,33 +0,0 @@
-# Link Integrity & Workflow Documentation Index
-
-This directory houses the research, analysis, and specifications for Plone/Volto Link Integrity tracking and the "Warn Before Private" workflow state transition verification feature.
-
-Below is an overview of the role and purpose of each document in this directory:
-
----
-
-## 📖 Document Catalog
-
-### 1. [README.md](./README.md)
-*   **Role**: **Feature Specification & Technical Implementation Guide**
-*   **Description**: High-level specification outlining the "Warn before private" workflow transition warning system. It explains how workflow transitions to private or retracted states are intercepted to check for breaches, contains a Mermaid sequence diagram of the operational flow, and details pointers to the exact implementation files (`Workflow.jsx`, `WorkflowLinkIntegrityModal.jsx`, and the unit test suite).
-
-### 2. [understanding-link-integrity.md](./understanding-link-integrity.md)
-*   **Role**: **Initial Research & Mechanics Overview**
-*   **Description**: Explains the underlying mechanics of Plone's `plone.app.linkintegrity` package, the `@linkintegrity` and `@relations` REST API endpoints, how internal references are stored in the `zc.relation` catalog using `isReferencing`, and proposes the initial architectural solution for shadowing the Volto toolbar component.
-
-### 3. [volto-block-link-discovery.md](./volto-block-link-discovery.md)
-*   **Role**: **Block Parser Link Extraction Specs**
-*   **Description**: Detailed specifications on how the Plone backend's block-to-HTML parser (via `plone.volto`) parses internal links and retrieves referencing UIDs from complex Volto blocks (e.g. Columns, Teasers, Maps) to keep the relation catalog accurately indexed.
-
-### 4. [volto-block-link-analysis.md](./volto-block-link-analysis.md)
-*   **Role**: **Technical Analysis of Internal Linking**
-*   **Description**: Analyzes how internal links are serialized, stored, and resolved within customized layouts. Explains matching strategies for Dexterity schemas and Choice relation fields.
-
-### 5. [link-integrity-blocks-report.md](./link-integrity-blocks-report.md)
-*   **Role**: **Volto Blocks Reference Index**
-*   **Description**: A quick-reference status report listing the Volto blocks whose internal link fields are covered by link integrity tracking and validation rules.
-
-### 6. [link-integrity-block-fields-report.md](./link-integrity-block-fields-report.md)
-*   **Role**: **Field Mapping Specification**
-*   **Description**: A comprehensive deep-dive report mapping exactly which fields and properties within the custom blocks schemas are indexed and tracked by the link integrity processor.