# Slasher Open Standard — Documentation Portal

**Slasher** (`@suitenumerique/blocknote-sources` / `@blocknote/xl-external-sources`) is an open source community extension and lightweight SDK (`@suitenumerique/slash-sources-sdk` < 5 kB) that connects rich text editors with verified remote public registries, legal databases, and enterprise APIs.

🔗 **Quick Resources:** [Architecture Overview](/00-overview) • [Provider SDK](/02-provider-sdk) • [OpenAPI Specification](/openapi) • [Multi-Country Presets](/04-presets)

---

## 🏛️ 3-Tier Architecture

<Mermaid chart={`flowchart TD
    subgraph Editor["📝 Rich Text Editor (React 18 / 19)"]
        SlashCommand["Type '/' or Trigger Shortcut"] --> Popover["Accessible Floating Popover (cmdk + ARIA)"]
        Popover --> Block["Universal Connected Block (Callout, Card, Inline)"]
    end

    subgraph Core["📦 Decoupled Packages (DINUM & Community)"]
        SDK["🛠️ Provider SDK (@suitenumerique/slash-sources-sdk)"]
        Proxy["🐍 Resilient Backend Proxy (django-lasuite-sources)"]
    end

    subgraph GlobalData["🌍 Sovereign & Global APIs (53 Connectors)"]
        EU["🇪🇺 EUR-Lex & TED Open Data"]
        CA["🇨🇦 Justice Laws Canada & StatsCan"]
        FR["🇫🇷 BAN, Légifrance & BOAMP"]
        DE["🇩🇪 Destatis & GovData Germany"]
        NL["🇳🇱 Wettenbank & KVK Netherlands"]
        ES["🇪🇸 BOE & Registro Mercantil Spain"]
    end

    Popover --> SDK
    SDK --> Proxy
    Proxy --> EU & CA & FR & DE & NL & ES`} />

---

## ✨ Key Features

<FeatureGrid cols={2}>
  <FeatureCard
    title="3 Switchable Display Formats"
    description="Switch seamlessly between Callout (institutional quote), Card (3-column metadata grid), and Inline Mention (compact inline pill) on any block."
    icon="layout"
  />
  <FeatureCard
    title="WAI-ARIA & Keyboard Accessible"
    description="Fully accessible floating popover with cmdk autocomplete, focus trapping, screen-reader announcements, and arrow key navigation."
    icon="check-circle"
  />
  <FeatureCard
    title="Multi-Country Sovereign Presets"
    description="Out-of-the-box verified datasets for France 🇫🇷, Germany 🇩🇪, Netherlands 🇳🇱, Spain 🇪🇸, Canada 🇨🇦, and the European Union 🇪🇺."
    icon="globe"
  />
  <FeatureCard
    title="Native Document Exporters"
    description="Lossless vector exporters for PDF (@react-pdf/renderer), Word DOCX (docx), and LibreOffice ODF/ODT (fflate XML)."
    icon="file-text"
  />
</FeatureGrid>

---

## 🎮 Interactive Live Playground

Try typing `/` in the editor below or click the quick insertion buttons:

<BlockNoteSlashPlayground />

---

## 🎨 Design System, UX Flow & Interactive Prototype

The universal specification of **Connected Blocks** and the **BlockNote External Sources Extension** is fully prototyped in Figma following sovereign design guidelines:

- 📐 **Figma Design & Mockups :** [La Suite — Loi/Source — Feature Flow & Mockups](https://www.figma.com/design/mDkEb8Pl4A4DFeQ7Xez11d/La-Suite-%25E2%2580%2594-Loi-Source-%25E2%2580%2594-Feature-Flow---Mockups?node-id=2273-6883&t=6IRdUmyY2ONJPlD1-0)
- 🚀 **Interactive Figma Prototype :** [Launch Interactive Demo](https://www.figma.com/proto/mDkEb8Pl4A4DFeQ7Xez11d/La-Suite-%E2%80%94-Loi-Source-%E2%80%94-Feature-Flow-and-Mockups?node-id=2267-12521&t=6IRdUmyY2ONJPlD1-0&scaling=min-zoom&content-scaling=fixed&page-id=0%3A1&fuid=1039480416252129992)

---

## 🧭 Navigation & Language Switch

- 🇫🇷 **French Documentation (Socle Souverain DINUM) :** [/fr](/fr)
- 🇬🇧 **English Documentation (Universal Standard) :** [/en](/en)
