@supersoniks/concorde 5.0.5 → 5.1.0

package/docs/src/core/components/ui/modal/modal.md

@@ -1,62 +1,68 @@
-# Modal
-
-**`sonic-modal`** presents focused content in a `<dialog>` overlay with backdrop, enter/exit animation, and a built-in close control. Compose **`sonic-modal-title`** / **`sonic-modal-subtitle`** / **`sonic-modal-content`** / **`sonic-modal-actions`**, or use the default slot. Call **`show()`** on the element to open; use **`hideModal`** on action buttons or **`hide()`** from script. Set **`forceAction`** when dismissal must go through explicit actions only. Imperative dialogs: **`Modal.create()`** (also **`window.SonicModal`**).
-
-## Basic example
-
-Click the trigger to open. **`sonic-modal-actions`** lays out footer buttons; **`hideModal`** closes the modal on click. Scope form state with **`formDataProvider`** on **`sonic-modal-actions`** so child **`sonic-button`** elements share one publisher.
+## Modal
 
 <sonic-code>
   <template>
     <sonic-button onclick="document.getElementById('modalExample').show()">
-      Open modal
+      Simple modal
     </sonic-button>
     <sonic-modal id="modalExample">
-      <sonic-modal-title>
-        Export ready
-        <sonic-badge type="success" size="sm">New</sonic-badge>
-      </sonic-modal-title>
-      <sonic-modal-subtitle>Your report finished processing.</sonic-modal-subtitle>
+      <sonic-modal-title
+        >Lorem ipsum dolor sit amet <sonic-badge type="danger" size="sm">+33</sonic-badge></sonic-modal-title
+      >
+      <sonic-modal-subtitle>Donec sed vestibulum augue.</sonic-modal-subtitle>
       <sonic-modal-content>
-        Download the CSV now or review the summary in your dashboard before sharing.
+        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed eget quam eu mi luctus faucibus.
       </sonic-modal-content>
       <sonic-modal-actions formDataProvider="ModalMiniForm">
-        <sonic-button minWidth="8rem" value="true" name="click">
-          Save draft
+        <sonic-button FormCheckable  minWidth="8rem" value="true" name="click">
+          Click don't close
         </sonic-button>
-        <sonic-button minWidth="8rem" type="success" hideModal>Download</sonic-button>
+        <sonic-button minWidth="8rem" type="success" hideModal>Confirm</sonic-button>
       </sonic-modal-actions>
     </sonic-modal>
   </template>
 </sonic-code>
 
-## Scrollable content
 
-Long copy scrolls inside the dialog. Default **`maxHeight`** is `90vh`. Default **`align`** is `left`.
+## Long text
 
 <sonic-code>
   <template>
-    <sonic-button onclick="document.getElementById('modalText').show()">Venue details</sonic-button>
+    <sonic-button onclick="document.getElementById('modalText').show()"> Long text </sonic-button>
     <sonic-modal align="left" id="modalText">
-      <sonic-modal-title>Hours and tickets</sonic-modal-title>
+      <sonic-modal-title>Infos et tarifs </sonic-modal-title>
       <sonic-modal-content>
         <div class="prose">
           <p>
-            <strong>Opening hours</strong><br />
-            Wednesday–Saturday, 1:30 p.m.–7:00 p.m.; Sunday, 1:30 p.m.–6:00 p.m.
+            <strong>Horaires d’ouverture </strong><br />
+            Du mercredi au samedi de 13h30 à 19h et le dimanche de 13h30 à 18h<br />
+            + horaires spécifiques pour événements ou festivals&nbsp;
           </p>
           <p>
-            <strong>Ticketing</strong><br />
-            Some events require online or box-office reservations. Prices vary by event; booking ahead is recommended when capacity is limited.
+            <strong> Billetterie&nbsp;<br /></strong>
+            La participation à certains événements et activités est soumise à un système de billetterie avec achats ou
+            réservations disponibles en ligne ou au guichet.&nbsp;&nbsp;<strong><br /></strong>
           </p>
           <p>
-            <strong>Contact</strong><br />
-            tickets@example.com · +33 3 28 33 48 33
+            Les tarifs (Tarif plein / Tarif Réduit / Tarif Spécifique) sont indiqués pour chaque événement et peuvent
+            varier selon la nature de l’événement. Les tarifs sont identiques en ligne et au guichet. Il est néanmoins
+            conseillé de réserver les billets en avance pour s’assurer une place.
           </p>
           <p>
-            <strong>Access</strong><br />
-            14 Place Faidherbe, 59100 Roubaix<br />
-            Metro line 2, Eurotéléport stop
+            L’accès au Skatepark, Fablab et Halle C sont soumis à adhésions. Les adhésions sont gratuites et
+            nominatives. Elle donnent accès aux espaces dans la limite des places disponibles.
+          </p>
+          <p>
+            <strong>+ d’infos <br /></strong>billetterie@laconditionpublique.com <br />+33 (0)328334833&nbsp;
+          </p>
+          <br />
+          <p>
+            <strong>Accès <br /></strong>14, place Faidherbe <br />59100 Roubaix <br />Métro / Tram : Arrêt
+            Eurotéléport, Ligne 2 <br />Bus / V’Lille : Arrêt Condition Publique&nbsp;
+          </p>
+          <p>
+            Accès handicapés : nous contacter avant votre venue au 03 28 33 48 33 ou par mail
+            billetterie@laconditionpublique.com
           </p>
         </div>
       </sonic-modal-content>
@@ -66,44 +72,33 @@ Long copy scrolls inside the dialog. Default **`maxHeight`** is `90vh`. Default
 
 ## Force action
 
-With **`forceAction`**, backdrop click, Escape, and the default close button are disabled. Provide **`sonic-modal-actions`** (or **`sonic-modal-close`**) so users can finish the flow.
-
 <sonic-code>
   <template>
-    <sonic-button onclick="document.getElementById('force').show()">Cookie consent</sonic-button>
+    <sonic-button onclick="document.getElementById('force').show()"> Force action to close</sonic-button>
     <sonic-modal forceAction id="force">
-      <sonic-modal-title>Allow analytics cookies?</sonic-modal-title>
+      <sonic-modal-title>Do you want some cookies ? </sonic-modal-title>
       <sonic-modal-content>
-        We use cookies to measure traffic and improve the product. You can change this later in settings.
+        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed eget quam eu mi luctus faucibus.
       </sonic-modal-content>
-      <sonic-modal-actions>
-        <sonic-button hideModal minWidth="8rem">Decline</sonic-button>
-        <sonic-button hideModal minWidth="8rem" type="success">Accept</sonic-button>
+      <sonic-modal-actions >
+        <sonic-button hideModal minWidth="8rem"> Nope </sonic-button>
+        <sonic-button hideModal minWidth="8rem" type="success">Hell yes !</sonic-button>
       </sonic-modal-actions>
     </sonic-modal>
+    </sonic-modal>
   </template>
 </sonic-code>
 
 ## Custom dimensions
 
-Set **`width`** / **`height`** / **`maxWidth`** / **`maxHeight`** (CSS lengths). On narrow viewports the panel becomes a bottom sheet. Use **`rounded="none"`** for edge-to-edge media.
-
 <sonic-code>
   <template>
-    <sonic-button onclick="document.getElementById('CustomWidth').show()">Image preview</sonic-button>
-    <sonic-modal
-      rounded="none"
-      maxHeight="50vh"
-      maxWidth="90vw"
-      width="100%"
-      height="100%"
-      id="CustomWidth"
-    >
+    <sonic-button onclick="document.getElementById('CustomWidth').show()"> Custom width </sonic-button>
+    <sonic-modal maxHeight="50vh" maxWidth="90vw" width="100%" height="100%" id="CustomWidth">
       <sonic-image
         cover
         objectPosition="center 20%"
         src="https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg"
-        alt="View from an airplane window"
       ></sonic-image>
     </sonic-modal>
   </template>
@@ -111,125 +106,14 @@ Set **`width`** / **`height`** / **`maxWidth`** / **`maxHeight`** (CSS lengths).
 
 ## Fullscreen
 
-**`fullscreen`** fills the viewport and hides the backdrop.
-
 <sonic-code>
   <template>
-    <sonic-button onclick="document.getElementById('Fullscreen').show()">Fullscreen</sonic-button>
+    <sonic-button onclick="document.getElementById('Fullscreen').show()"> Fullscreen </sonic-button>
     <sonic-modal fullscreen id="Fullscreen">
       <sonic-image
         cover
         src="https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg"
-        alt="View from an airplane window"
       ></sonic-image>
     </sonic-modal>
   </template>
-</sonic-code>
-
-## Programmatic creation
-
-Use **`Modal.create(options)`** when there is no modal in the template—for confirmations, toasts that need a follow-up, or one-off flows from script. The modal is appended to the nearest **`sonic-theme`** pop container (same as declarative modals), opened automatically, and returns the **`sonic-modal`** instance. Set **`removeOnHide: true`** to detach it from the DOM after close. In the browser, **`window.SonicModal`** is the same class after the module loads.
-
-Pass **`title`** / **`subtitle`** / **`content`** / **`actions`** as HTML strings (or Lit template results from application code). Put **`hideModal`** on action buttons in the **`actions`** string so clicks close the dialog.
-
-<sonic-code>
-  <template>
-    <sonic-button
-      onclick="window.SonicModal.create({
-        title: 'Send invite?',
-        subtitle: 'The recipient can join immediately.',
-        content: 'We will email an invitation to alex@example.com.',
-        actions: '&lt;sonic-button hideModal minWidth=\'8rem\'&gt;Cancel&lt;/sonic-button&gt;&lt;sonic-button hideModal minWidth=\'8rem\' type=\'success\'&gt;Send&lt;/sonic-button&gt;',
-        removeOnHide: true
-      })"
-    >
-      Open programmatic modal
-    </sonic-button>
-  </template>
-</sonic-code>
-
-<sonic-code language="javascript">
-  <template>
-import { Modal } from "@supersoniks/concorde/core/components/ui/modal/modal";
-
-const modal = Modal.create({
-  title: "Delete project?",
-  subtitle: "This cannot be undone.",
-  content: "<p>All files in <strong>Acme HQ</strong> will be removed.</p>",
-  actions: `
-    <sonic-button hideModal minWidth="8rem">Cancel</sonic-button>
-    <sonic-button hideModal minWidth="8rem" type="danger">Delete</sonic-button>
-  `,
-  removeOnHide: true,
-  forceAction: false,
-  maxWidth: "min(100vw, 28rem)",
-});
-
-modal.addEventListener("hidden", () => {
-  console.log("Modal removed from the DOM");
-});
-
-// Or close from script: await modal.hide(); await modal.dispose();
-  </template>
-</sonic-code>
-
-## API reference
-
-### `sonic-modal`
-
-| Attribute | Values | Description |
-|----------|---------|-------------|
-| `align` | `left` (default) · `center` · `right` | Align title and slotted content |
-| `maxWidth` | CSS length (default `min(100vw, 40rem)`) | Dialog max width |
-| `maxHeight` | CSS length (default `90vh`) | Scrollable body max height |
-| `width` | CSS length (default `100%`) | Dialog width |
-| `height` | CSS length (default `fit-content`) | Dialog height |
-| `paddingX` · `paddingY` | CSS length | Override content padding (`--sc-modal-px` / `--sc-modal-py`) |
-| `zIndex` | CSS number | Stacking order (default `990`) |
-| `effect` | `slide` (default) · `fade` · `none` | Open/close animation |
-| `fullscreen` | boolean | Full viewport; no backdrop |
-| `forceAction` | boolean | Disable overlay, Escape, and default close button |
-| `noCloseButton` | boolean | Hide built-in close when not **`forceAction`** |
-| `closeButtonType` | **`sonic-button`** `type` | Style of built-in close |
-| `visible` | boolean | When toggled, opens or closes the dialog |
-| `removeOnHide` | boolean | Remove element from DOM after close |
-| `removeHashOnHide` | boolean | Clear URL hash on close |
-| `closeOnLocationChange` | boolean | Close when app location changes |
-| `resetDataProviderOnHide` | string | Reset named **`formDataProvider`** on close |
-| `rounded` | `none` | Square dialog corners (useful for full-bleed media) |
-
-| Slot | Description |
-|------|-------------|
-| *(default)* | Additional markup alongside structured children |
-
-| Event | Description |
-|-------|-------------|
-| `show` | Fired when open animation completes |
-| `hide` | Fired when close starts |
-| `hidden` | Fired when close finishes |
-
-Methods: **`show()`** · **`hide()`** · **`dispose()`** (hide and remove). Static **`Modal.create(options)`** appends a modal to the theme pop container and opens it. **`options`** / **`styleSheet`** are JavaScript-only.
-
-### `sonic-modal-title` · `sonic-modal-subtitle` · `sonic-modal-content`
-
-| Slot | Description |
-|------|-------------|
-| *(default)* | Title, subtitle, or main body content |
-
-### `sonic-modal-actions`
-
-| Slot | Description |
-|------|-------------|
-| *(default)* | Footer actions (typically **`sonic-button`**) |
-
-Put **`hideModal`** on a **`sonic-button`** to close the parent modal on click. Ancestor **`formDataProvider`** on this element is inherited by child form controls.
-
-### `sonic-modal-close`
-
-Rendered automatically unless **`forceAction`** or **`noCloseButton`** is set. Calls **`hide()`** on the parent modal.
-
-| Attribute | Values | Description |
-|----------|---------|-------------|
-| `type` | **`sonic-button`** `type` | Close button color |
-| `reset` | string | Passed to inner **`sonic-button`** **`reset`** |
-| `translation` | UI label object | Overrides default close **`aria-label`** |
+</sonic-code>

package/docs/src/core/components/ui/pop/pop.md

@@ -1,294 +1,96 @@
 # Pop
 
-**`sonic-pop`** anchors floating panels to a trigger: put the control in the **default slot** and the panel in **`slot="content"`** (menus, forms, custom markup). Click toggles open/closed unless **`manual`** is set; default **`placement`** is **`bottom`** (start-aligned). Position updates while open and flips inside the viewport when space is tight.
-
-## Basic example
-
+## Placement
 <sonic-code>
   <template>
-    <sonic-pop class="inline-block">
-      <sonic-button>Notifications</sonic-button>
+    <sonic-pop class="inline-block" placement="left">
+      <sonic-button>Left</sonic-button>
       <sonic-menu slot="content">
-        <sonic-menu-item>
-          <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-          Notifications
-        </sonic-menu-item>
-        <sonic-menu-item>
-          <sonic-icon library="iconoir" name="settings" slot="prefix"></sonic-icon>
-          Settings
-        </sonic-menu-item>
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
+    <sonic-pop class="inline-block" placement="right">
+      <sonic-button>Right</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
+    <sonic-pop class="inline-block" placement="top">
+      <sonic-button>Top</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
+    <sonic-pop class="inline-block" placement="bottom">
+      <sonic-button>Bottom</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
       </sonic-menu>
     </sonic-pop>
-  </template>
-</sonic-code>
-
-## Placement
-
-Use **`top`** · **`bottom`** · **`left`** · **`right`** for the main axis. Add **`-start`** · **`-center`** · **`-end`** to align along the trigger edge. With no align suffix, content aligns to **`start`**. Legacy space syntax (`placement="bottom center"`) still works but is deprecated—prefer **`bottom-center`**.
-
-<sonic-code>
-  <template>
-    <div class="flex flex-wrap gap-2">
-      <sonic-pop class="inline-block" placement="left">
-        <sonic-button>Left</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" placement="right">
-        <sonic-button>Right</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" placement="top">
-        <sonic-button>Top</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" placement="bottom">
-        <sonic-button>Bottom</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-    </div>
-  </template>
-</sonic-code>
-
-### Center-aligned sides
-
-<sonic-code>
-  <template>
-    <div class="flex flex-wrap gap-2">
-      <sonic-pop class="inline-block" placement="bottom-center">
-        <sonic-button>Bottom center</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" placement="top-center">
-        <sonic-button>Top center</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" placement="left-center">
-        <sonic-button>Left center</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" placement="right-center">
-        <sonic-button>Right center</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-    </div>
   </template>
 </sonic-code>
 
 ## Shadow
-
-Default **`shadow`** is **`lg`**. The shadow applies to the floating **`content`** panel.
-
-<sonic-code>
-  <template>
-    <div class="flex flex-wrap gap-2">
-      <sonic-pop class="inline-block" shadow="none" placement="top">
-        <sonic-button>None</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" shadow="sm" placement="top">
-        <sonic-button>Small</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" shadow="md" placement="top">
-        <sonic-button>Medium</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block" shadow="lg" placement="top">
-        <sonic-button>Large</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-    </div>
-  </template>
-</sonic-code>
-
-## Inline
-
-By default the host is middle-aligned with siblings. Set **`inline`** to baseline-align the trigger inside running text.
-
 <sonic-code>
   <template>
-    <p>
-      The Concorde flew from Paris to
-      <sonic-pop inline>
-        <sonic-button variant="link">New York</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>See flights</sonic-menu-item>
-          <sonic-menu-item>Book a seat</sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      in about 3.5 hours.
-    </p>
+    <sonic-pop class="inline-block" shadow="none" placement='top' >
+      <sonic-button>None</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
+    <sonic-pop class="inline-block" shadow="sm"  placement='top'>
+      <sonic-button>Small</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
+    <sonic-pop class="inline-block" shadow="md"  placement='top'>
+      <sonic-button>Medium</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
+    <sonic-pop class="inline-block" shadow="lg"  placement='top'>
+      <sonic-button>Large</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
   </template>
 </sonic-code>
 
-## No toggle
-
-With **`noToggle`**, a click on the trigger still opens the pop but does not close it when it is already open. Use **`hide()`** or an outside click to dismiss.
-
+## noToggle
 <sonic-code>
   <template>
-    <div class="flex flex-wrap gap-2">
-      <sonic-pop class="inline-block" noToggle>
-        <sonic-button>No toggle on click</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-      <sonic-pop class="inline-block">
-        <sonic-button>Default toggle on click</sonic-button>
-        <sonic-menu slot="content">
-          <sonic-menu-item>
-            <sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>
-            Notifications
-          </sonic-menu-item>
-        </sonic-menu>
-      </sonic-pop>
-    </div>
+    <sonic-pop class="inline-block"  noToggle>
+      <sonic-button>No toggle on click</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
+    <sonic-pop class="inline-block" >
+      <sonic-button>Default toggle on click</sonic-button>
+      <sonic-menu slot="content">
+        <sonic-menu-item><sonic-icon library="iconoir" name="bell-notification" slot="prefix"></sonic-icon>Notifications</sonic-menu-item>
+      </sonic-menu>
+    </sonic-pop>
   </template>
 </sonic-code>
 
-## Manual control
-
-Set **`manual`** to disable built-in click and keyboard toggle on the trigger. Call **`show()`** and **`hide()`** on the element instead. The pop dispatches **`show`** when it opens and **`hide`** when it closes.
-
-Click **Click to open pop** to open the panel programmatically.
 
+## manual
 <sonic-code>
   <template>
     <sonic-pop class="inline-block" manual id="manualPop">
-      <sonic-button onclick="alert('Custom action without opening the pop')">Manual trigger</sonic-button>
+      <sonic-button onclick="alert('customAction without opening Pop content')">Manual doesn't open on click</sonic-button>
       <sonic-menu slot="content">
-        <sonic-menu-item>It worked!</sonic-menu-item>
+        <sonic-menu-item>Hourra !</sonic-menu-item>
       </sonic-menu>
     </sonic-pop>
-    <sonic-button onclick="document.getElementById('manualPop').show()" class="ml-5" variant="outline">
+    <sonic-button onclick="document.getElementById('manualPop').show()" class="ml-5"  variant="outline">
       <sonic-icon name="sparkles" library="custom"></sonic-icon>
       Click to open pop
     </sonic-button>
   </template>
-</sonic-code>
-
-## Keep open on select
-
-By default, a click inside **`content`** closes the pop (same as an outside click). Set **`data-on-select="keep"`** on the panel or a descendant to keep it open while selecting checkboxes, toggles, or menu items.
-
-<sonic-code>
-  <template>
-    <div class="flex flex-wrap gap-2">
-      <sonic-pop class="inline-block">
-        <sonic-button>Closes on select</sonic-button>
-        <div slot="content" class="grid gap-2 p-3">
-          <sonic-checkbox>Option A</sonic-checkbox>
-          <sonic-checkbox>Option B</sonic-checkbox>
-        </div>
-      </sonic-pop>
-      <sonic-pop class="inline-block">
-        <sonic-button>Stays open on select</sonic-button>
-        <div slot="content" class="grid gap-2 p-3" data-on-select="keep">
-          <sonic-checkbox>Option A</sonic-checkbox>
-          <sonic-checkbox>Option B</sonic-checkbox>
-        </div>
-      </sonic-pop>
-    </div>
-  </template>
-</sonic-code>
-
-## Keyboard and dismissal
-
-**`ArrowDown`** on the trigger opens the pop when it is closed. **`Escape`** closes the most recently opened pop (capture phase, before ancestors such as **`sonic-modal`**) and returns focus to that trigger. Multiple pops on the page stack in open order for Escape.
-
-<sonic-code>
-  <template>
-    <sonic-pop class="inline-block">
-      <sonic-button>Focus me — ArrowDown opens, Escape closes</sonic-button>
-      <sonic-menu slot="content">
-        <sonic-menu-item>First item</sonic-menu-item>
-        <sonic-menu-item>Second item</sonic-menu-item>
-      </sonic-menu>
-    </sonic-pop>
-  </template>
-</sonic-code>
-
-## API reference
-
-| Attribute | Values | Description |
-|----------|---------|-------------|
-| `placement` | `bottom` (default) · `top` · `left` · `right` · `top-start` · `top-center` · `top-end` · `bottom-start` · `bottom-center` · `bottom-end` · `left-start` · `left-center` · `left-end` · `right-start` · `right-center` · `right-end` | Side and alignment relative to the trigger; repositions while open and flips within the viewport |
-| `shadow` | `none` · `sm` · `md` · `lg` (default `lg`) | Box shadow on the **`content`** panel |
-| `inline` | boolean | Baseline-align the host for inline triggers |
-| `noToggle` | boolean | When open, trigger click does not close the pop |
-| `manual` | boolean | Disable default trigger toggle; use **`show()`** / **`hide()`** |
-
-| Slot | Description |
-|------|-------------|
-| *(default)* | Trigger; listens for **`click`** and **`keydown`** (`ArrowDown` opens when closed) unless **`manual`** |
-| `content` | Floating panel; receives focus **`tabindex="0"`** while open |
-
-**Methods:** **`show()`** · **`hide()`** on the host element.
-
-**Events:** **`show`** · **`hide`** (non-bubbling **`CustomEvent`**).
-
-**Content attribute:** **`data-on-select="keep"`** on **`content`** or descendants prevents close-on-click inside the panel.
+</sonic-code>