@supersoniks/concorde 5.0.3 → 5.0.5

package/src/docs/search/docs-search.json

@@ -517,22 +517,12 @@
           }
         }
       },
-      "core/components/ui/icon/icon.md": {
-        "title": "Icon",
-        "hashes": {
-          "custom": {
-            "count": 1,
-            "title": "Custom",
-            "type": "paragraph"
-          }
-        }
-      },
       "core/components/ui/loader/loader.md": {
         "title": "Loader",
         "hashes": {
-          "fixed-mode": {
+          "mode": {
             "count": 1,
-            "title": "Fixed mode",
+            "title": "Mode",
             "type": "paragraph"
           }
         }
@@ -2415,22 +2405,7 @@
     }
   },
   {
-    "search": "Inline message in the page: title (label), body (text or default slot), icon from status. For HTML or actions, use the slot instead of label / text (plain text only).\n",
-    "files": {
-      "core/components/ui/alert/alert.md": {
-        "title": "Alert",
-        "hashes": {
-          "alert": {
-            "count": 1,
-            "title": "",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Use status: default, info, success, warning, error.\n",
+    "search": "Alerts surface important feedback inline—errors, confirmations, or contextual help. Use label / text for simple copy, or the default slot for rich content (links, buttons). Set announce when the message appears after an action so screen readers pick it up.\n",
     "files": {
       "core/components/ui/alert/alert.md": {
         "title": "Alert",
@@ -2580,12 +2555,12 @@
     }
   },
   {
-    "search": "Badge",
+    "search": "Alert messages",
     "files": {
-      "core/components/ui/badge/badge.md": {
-        "title": "Badge",
+      "core/components/ui/alert-messages/alert-messages.md": {
+        "title": "Alert messages",
         "hashes": {
-          "badge": {
+          "alert-messages": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -2595,7 +2570,82 @@
     }
   },
   {
-    "search": "A non-interactive pill for labels, counts, or highlights (counter, status, category). The API mirrors sonic-button (type, variant, size) without focus or click states.\n",
+    "search": "sonic-alert-messages renders a vertical stack of sonic-alert items from a messages array on a linked data provider (typical pattern: submitResultDataProvider after a form submit). Only entries with type="public" are shown. Each alert gets announce so screen readers pick up feedback after the request.\n",
+    "files": {
+      "core/components/ui/alert-messages/alert-messages.md": {
+        "title": "Alert messages",
+        "hashes": {
+          "alert-messages": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Bind dataProvider to the same publisher as submitResultDataProvider. API messages entries need type: public, plus content and optional status (warning · success · error · info).\n",
+    "files": {
+      "core/components/ui/alert-messages/alert-messages.md": {
+        "title": "Alert messages",
+        "hashes": {
+          "with-submit-result": {
+            "count": 1,
+            "title": "With submit result",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "size · background and noIcon apply to every rendered sonic-alert in the list.\n",
+    "files": {
+      "core/components/ui/alert-messages/alert-messages.md": {
+        "title": "Alert messages",
+        "hashes": {
+          "shared-alert-props": {
+            "count": 1,
+            "title": "Shared alert props",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Example JSON on the result publisher (or API response merged into it):\n",
+    "files": {
+      "core/components/ui/alert-messages/alert-messages.md": {
+        "title": "Alert messages",
+        "hashes": {
+          "message-shape": {
+            "count": 1,
+            "title": "Message shape",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "No slots — alerts are generated from messages.\n",
+    "files": {
+      "core/components/ui/alert-messages/alert-messages.md": {
+        "title": "Alert messages",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Badge",
     "files": {
       "core/components/ui/badge/badge.md": {
         "title": "Badge",
@@ -2603,14 +2653,14 @@
           "badge": {
             "count": 1,
             "title": "",
-            "type": "paragraph"
+            "type": "page"
           }
         }
       }
     }
   },
   {
-    "search": "Colors come from theme tokens (--sc-primary, --sc-danger, …) or the semantic type values below. \n",
+    "search": "Badges are compact, non-interactive labels for status, counts, or categories. They mirror sonic-button styling (type, variant, size) without focus rings or click handling—use a button when the control should be actionable.\n",
     "files": {
       "core/components/ui/badge/badge.md": {
         "title": "Badge",
@@ -2640,7 +2690,7 @@
     }
   },
   {
-    "search": "outline — border and text in the type color. ghost — text only, no padding (except in forced-colors mode).\n",
+    "search": "Default variant is filled. outline — border and text in the type color. ghost — text only, no padding (except in forced-colors mode).\n",
     "files": {
       "core/components/ui/badge/badge.md": {
         "title": "Badge",
@@ -2774,6 +2824,96 @@
       }
     }
   },
+  {
+    "search": "sonic-captcha embeds an ALTCHA widget and wires captchaToken / needsCaptchaValidation on the ancestor formDataProvider (or headersDataProvider). sonic-submit waits for a token before sending when validation is required. The widget loads only on HTTPS; on plain HTTP the host renders nothing.\n",
+    "files": {
+      "core/components/ui/captcha/captcha.md": {
+        "title": "Captcha",
+        "hashes": {
+          "captcha": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Live widget calls the Supersoniks challenge service — not part of docs mock API.\n",
+    "files": {
+      "core/components/ui/captcha/captcha.md": {
+        "title": "Captcha",
+        "hashes": {
+          "captcha": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Wrap the form scope and place sonic-submit in the default slot so the challenge appears above the action.\n",
+    "files": {
+      "core/components/ui/captcha/captcha.md": {
+        "title": "Captcha",
+        "hashes": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Optional key skips client-side key generation. When omitted, the component derives an encrypted key on connect (after generateEncryptedKey).\n",
+    "files": {
+      "core/components/ui/captcha/captcha.md": {
+        "title": "Captcha",
+        "hashes": {
+          "encrypted-site-key": {
+            "count": 1,
+            "title": "Encrypted site key",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "On connect (HTTPS only), needsCaptchaValidation is set to true and captchaToken is cleared. When the ALTCHA widget reaches verified, captchaToken is written on the form publisher and sonic-captcha-validate fires (detail.valid · detail.state · optional detail.token / detail.payload). sonic-submit still listens for request_token to refresh the token immediately before send.\n",
+    "files": {
+      "core/components/ui/captcha/captcha.md": {
+        "title": "Captcha",
+        "hashes": {
+          "form-publisher-fields": {
+            "count": 1,
+            "title": "Form publisher fields",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Related: Submit — needsCaptchaValidation and deferred send.\n",
+    "files": {
+      "core/components/ui/captcha/captcha.md": {
+        "title": "Captcha",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Card",
     "files": {
@@ -2790,7 +2930,7 @@
     }
   },
   {
-    "search": "A surface for grouped content: padding, radius, shadow, and semantic type colors via shared theme tokens. Compose sonic-card-header, sonic-card-main, and sonic-card-footer inside the card, or put any markup in the default slot.\n",
+    "search": "Cards group related content on a padded surface with radius, theme type colors, and elevation. Default shadow is lg. Compose sonic-card-header / sonic-card-main / sonic-card-footer, or place any markup in the default slot.\n",
     "files": {
       "core/components/ui/card/card.md": {
         "title": "Card",
@@ -2805,14 +2945,29 @@
     }
   },
   {
-    "search": "Default type is base (page background). Use light for a subtle gray panel, invert / neutral for high-contrast blocks, and primary, info, success, warning, or danger for tinted surfaces (divider tokens apply on colored types).\n",
+    "search": "Default type is base. default and light share the same surface tokens.\n",
     "files": {
       "core/components/ui/card/card.md": {
         "title": "Card",
         "hashes": {
-          "card": {
+          "type": {
             "count": 1,
-            "title": "",
+            "title": "Type",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set shadow to control elevation. Default is lg.\n",
+    "files": {
+      "core/components/ui/card/card.md": {
+        "title": "Card",
+        "hashes": {
+          "shadow": {
+            "count": 1,
+            "title": "Shadow",
             "type": "paragraph"
           }
         }
@@ -2820,7 +2975,7 @@
     }
   },
   {
-    "search": "Quick titles with label and description attributes, or full control through the default slot. slot="suffix" aligns badges or actions on the right; suffix content does not shrink when the title wraps.\n",
+    "search": "Quick titles with label and description, or full control through the default slot. slot="suffix" aligns badges or actions on the right; suffix content does not shrink when the title wraps.\n",
     "files": {
       "core/components/ui/card/card.md": {
         "title": "Card",
@@ -2835,7 +2990,7 @@
     }
   },
   {
-    "search": "label and description accept HTML (rendered as markup). Prefer plain text when possible; use the slot for structured content.\n",
+    "search": "label and description accept HTML (rendered as markup). Prefer plain text when possible; use sonic-card-header-description or the default slot for structured content.\n",
     "files": {
       "core/components/ui/card/card.md": {
         "title": "Card",
@@ -2910,29 +3065,29 @@
     }
   },
   {
-    "search": "Checkbox",
+    "search": "sonic-divider draws a horizontal or vertical rule with optional centered label copy. Use it to separate sections in forms, cards, and sonic-menu. Set label for simple HTML captions or use the default slot for richer markup; default align is center and default lineStyle is solid.\n",
     "files": {
-      "core/components/ui/form/checkbox/checkbox.md": {
-        "title": "Checkbox",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "checkbox": {
+          "divider": {
             "count": 1,
             "title": "",
-            "type": "page"
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Checked blacklistFlags values are sent to the mock API (?blacklistFlags=racist,sexist,…), which excludes jokes whose flags match (see filterDocsJokes in src/docs/mock-api/fixtures.ts).\n",
+    "search": "A bare divider is a full-width line with vertical margin. Omit size to use the host default spacing (0.5rem block margin).\n",
     "files": {
-      "core/components/ui/form/checkbox/checkbox.md": {
-        "title": "Checkbox",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "example-of-use--blacklist--queue": {
+          "basic-example": {
             "count": 1,
-            "title": "Example of use — blacklist + queue",
+            "title": "Basic example",
             "type": "paragraph"
           }
         }
@@ -2940,74 +3095,74 @@
     }
   },
   {
-    "search": "Fieldset",
+    "search": "label renders inside the line (HTML via the same pipeline as other form labels). align controls which side(s) of the line remain visible: left drops the leading segment, right drops the trailing segment, center keeps both.\n",
     "files": {
-      "core/components/ui/form/fieldset/fieldset.md": {
-        "title": "Fieldset",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "fieldset": {
+          "label-and-align": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Label and align",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Form-actions",
+    "search": "size adjusts block margin and label font size. Values follow the shared Concorde scale (2xs … 2xl).\n",
     "files": {
-      "core/components/ui/form/form-actions/form-actions.md": {
-        "title": "Form-actions",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "form-actions": {
+          "size": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Size",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Form-layout",
+    "search": "lineStyle sets the stroke of the rule (solid · dashed · dotted). In HTML use the reflected attribute linestyle (case-insensitive).\n",
     "files": {
-      "core/components/ui/form/form-layout/form-layout.md": {
-        "title": "Form-layout",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "form-layout": {
+          "line-style": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Line style",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Input",
+    "search": "Set vertical for a column rule (for example between toolbar actions). noMargin removes host margin when a parent layout already provides spacing.\n",
     "files": {
-      "core/components/ui/form/input/input.md": {
-        "title": "Input",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "input": {
+          "vertical-and-margin": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Vertical and margin",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Liste des types\n",
+    "search": "Slotted content replaces or augments label. Useful for badges, icons, or mixed markup in menus.\n",
     "files": {
-      "core/components/ui/form/input/input.md": {
-        "title": "Input",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "type": {
+          "default-slot": {
             "count": 1,
-            "title": "Type",
+            "title": "Default slot",
             "type": "paragraph"
           }
         }
@@ -3015,14 +3170,14 @@
     }
   },
   {
-    "search": "Filter with formDataProvider + name="contains" (mock API: substring on joke text). Caption and rows via Lit (@subscribe, .items on sonic-queue):\n",
+    "search": "On sonic-card with semantic type (primary · warning · danger · info · success), the rule uses the card’s text color at reduced opacity so it stays visible on tinted surfaces. label and slotted captions use the same foreground color as surrounding copy.\n",
     "files": {
-      "core/components/ui/form/input/input.md": {
-        "title": "Input",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "example-of-use--search--queue": {
+          "inside-typed-cards": {
             "count": 1,
-            "title": "Example of use — search + queue",
+            "title": "Inside typed cards",
             "type": "paragraph"
           }
         }
@@ -3030,29 +3185,44 @@
     }
   },
   {
-    "search": "Input-autocomplete",
+    "search": "The inner flex container exposes part="divider" for theme overrides.\n",
     "files": {
-      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
-        "title": "Input-autocomplete",
+      "core/components/ui/divider/divider.md": {
+        "title": "Divider",
         "hashes": {
-          "input-autocomplete": {
+          "api-reference": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "API reference",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Champ formulaire + suggestions via queue. Valeur via formDataProvider + name ; la recherche filtre la queue (store interne).\n",
+    "search": "Checkbox",
     "files": {
-      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
-        "title": "Input-autocomplete",
-        "hashes": {
-          "input-autocomplete": {
+      "core/components/ui/form/checkbox/checkbox.md": {
+        "title": "Checkbox",
+        "hashes": {
+          "checkbox": {
             "count": 1,
             "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Checked blacklistFlags values are sent to the mock API (?blacklistFlags=racist,sexist,…), which excludes jokes whose flags match (see filterDocsJokes in src/docs/mock-api/fixtures.ts).\n",
+    "files": {
+      "core/components/ui/form/checkbox/checkbox.md": {
+        "title": "Checkbox",
+        "hashes": {
+          "example-of-use--blacklist--queue": {
+            "count": 1,
+            "title": "Example of use — blacklist + queue",
             "type": "paragraph"
           }
         }
@@ -3060,12 +3230,27 @@
     }
   },
   {
-    "search": "Rendu des lignes : propriété .items (callback Lit) — voir les démos ci-dessous. Mock : serviceURL="/docs-mock-api/geo/".\n",
+    "search": "Fieldset",
     "files": {
-      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
-        "title": "Input-autocomplete",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "input-autocomplete": {
+          "fieldset": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-fieldset groups related form controls with a bordered container and an accessible <fieldset> semantics layer. Put fields in the default slot; add a title with sonic-legend or the shorthand label / description / iconName attributes. Default variant is default. Pair the body with sonic-form-layout for responsive columns.\n",
+    "files": {
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
+        "hashes": {
+          "fieldset": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -3075,14 +3260,14 @@
     }
   },
   {
-    "search": "name = paramètre de recherche = valeur formulaire.\n",
+    "search": "ghost and shadow use a transparent border; shadow also applies --sc-shadow-lg.\n",
     "files": {
-      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
-        "title": "Input-autocomplete",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "simple": {
+          "variant": {
             "count": 1,
-            "title": "Simple",
+            "title": "Variant",
             "type": "paragraph"
           }
         }
@@ -3090,14 +3275,14 @@
     }
   },
   {
-    "search": "Recherche sur nom, valeur formulaire = code. Préremplissage via value.\n",
+    "search": "Set tight to remove horizontal padding and side borders (flat strip inside a parent).\n",
     "files": {
-      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
-        "title": "Input-autocomplete",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "valeur--paramètre-de-recherche": {
+          "tight-layout": {
             "count": 1,
-            "title": "Valeur ≠ paramètre de recherche",
+            "title": "Tight layout",
             "type": "paragraph"
           }
         }
@@ -3105,14 +3290,14 @@
     }
   },
   {
-    "search": "À la fermeture du pop, seule une valeur de la liste (ou vide) est conservée.\n",
+    "search": "Use sonic-legend for the group title. Set label and description for simple copy, or use the default slot for custom markup. Add secondary text with sonic-legend-description. Place actions in slot="suffix" on the legend.\n",
     "files": {
-      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
-        "title": "Input-autocomplete",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "mode-select": {
+          "legend": {
             "count": 1,
-            "title": "Mode select",
+            "title": "Legend",
             "type": "paragraph"
           }
         }
@@ -3120,14 +3305,14 @@
     }
   },
   {
-    "search": "data-keyboard-nav sur le champ et les items (flèches haut / bas).\n",
+    "search": "Attribute values on sonic-legend are rendered as HTML—use only trusted content.\n",
     "files": {
-      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
-        "title": "Input-autocomplete",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "navigation-clavier": {
+          "legend": {
             "count": 1,
-            "title": "Navigation clavier",
+            "title": "Legend",
             "type": "paragraph"
           }
         }
@@ -3135,29 +3320,29 @@
     }
   },
   {
-    "search": "Radio",
+    "search": "When label is set on sonic-fieldset, the component renders sonic-legend for you. Pass description iconName iconLibrary and iconPrefix the same way. Do not combine shorthand label with a separate slotted sonic-legend—you will get two legends.\n",
     "files": {
-      "core/components/ui/form/radio/radio.md": {
-        "title": "Radio",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "radio": {
+          "shorthand-legend-on-the-fieldset": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Shorthand legend on the fieldset",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Same mock filter as Checkbox (blacklistFlags query param). Radio sends one flag at a time.\n",
+    "search": "Use slot="suffix" on sonic-legend for menus or icon buttons aligned to the end of the legend row.\n",
     "files": {
-      "core/components/ui/form/radio/radio.md": {
-        "title": "Radio",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "example-of-use--blacklist--queue": {
+          "legend-actions": {
             "count": 1,
-            "title": "Example of use — blacklist + queue",
+            "title": "Legend actions",
             "type": "paragraph"
           }
         }
@@ -3165,12 +3350,72 @@
     }
   },
   {
-    "search": "Select",
+    "search": "Set form on sonic-fieldset to the id of a <form> elsewhere in the page (same as the native form attribute on <fieldset>). Named fields in the fieldset then belong to that form for submit and constraint validation—for example a toolbar form and a field group rendered lower on the layout.\n",
     "files": {
-      "core/components/ui/form/select/select.md": {
-        "title": "Select",
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
         "hashes": {
-          "select": {
+          "associating-a-distant-form": {
+            "count": 1,
+            "title": "Associating a distant `form`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set disabled on sonic-fieldset to disable the inner <fieldset> and every control in the group (same as a native fieldset). Use it for read-only steps or sections gated by permissions.\n",
+    "files": {
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
+        "hashes": {
+          "disabling-a-group": {
+            "count": 1,
+            "title": "Disabling a group",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The inner <fieldset> carries grouping semantics. disabled is applied on that element so nested controls are disabled in the usual way. sonic-legend renders a native <legend> for the group label.\n",
+    "files": {
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
+        "hashes": {
+          "accessibility": {
+            "count": 1,
+            "title": "Accessibility",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Muted description line below the legend title. No attributes—project content through the default slot.\n",
+    "files": {
+      "core/components/ui/form/fieldset/fieldset.md": {
+        "title": "Fieldset",
+        "hashes": {
+          "sonic-legend-description": {
+            "count": 1,
+            "title": "`sonic-legend-description`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Form actions",
+    "files": {
+      "core/components/ui/form/form-actions/form-actions.md": {
+        "title": "Form actions",
+        "hashes": {
+          "form-actions": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -3180,14 +3425,14 @@
     }
   },
   {
-    "search": "name="lang" is sent as ?lang=fr|en to the doc mock API (filterDocsJokes). Same pattern as Input (contains):\n",
+    "search": "sonic-form-actions lays out submit / cancel and other form footer controls in a wrapping flex row with a small fixed gap. Place it inside sonic-form-layout (full-width row) or any block that should end with actions. Defaults: direction row · justify flex-start · alignItems center.\n",
     "files": {
-      "core/components/ui/form/select/select.md": {
-        "title": "Select",
+      "core/components/ui/form/form-actions/form-actions.md": {
+        "title": "Form actions",
         "hashes": {
-          "example-of-use--language-filter--queue": {
+          "form-actions": {
             "count": 1,
-            "title": "Example of use — language filter + queue",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -3195,12 +3440,87 @@
     }
   },
   {
-    "search": "Switch",
+    "search": "With no attributes, actions align to the start of the row (typical for left-to-right forms).\n",
     "files": {
-      "core/components/ui/form/switch/switch.md": {
-        "title": "Switch",
+      "core/components/ui/form/form-actions/form-actions.md": {
+        "title": "Form actions",
         "hashes": {
-          "switch": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "justify maps to CSS justify-content. Use flex-end for dialog-style footers or center for balanced toolbars.\n",
+    "files": {
+      "core/components/ui/form/form-actions/form-actions.md": {
+        "title": "Form actions",
+        "hashes": {
+          "justify-content": {
+            "count": 1,
+            "title": "Justify content",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "direction maps to flex-direction. row-reverse swaps visual order while keeping DOM order (focus order unchanged).\n",
+    "files": {
+      "core/components/ui/form/form-actions/form-actions.md": {
+        "title": "Form actions",
+        "hashes": {
+          "flex-direction": {
+            "count": 1,
+            "title": "Flex direction",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Combine sonic-button with sonic-divider vertical or other slotted content. Default alignItems center keeps unlike heights aligned on the cross axis.\n",
+    "files": {
+      "core/components/ui/form/form-actions/form-actions.md": {
+        "title": "Form actions",
+        "hashes": {
+          "mixed-controls": {
+            "count": 1,
+            "title": "Mixed controls",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The component exposes a single unnamed slot; there are no named slots. Slotted nodes use the host’s flex gap (0.3rem) and flex-wrap.\n",
+    "files": {
+      "core/components/ui/form/form-actions/form-actions.md": {
+        "title": "Form actions",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Form layout",
+    "files": {
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "form-layout": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -3210,14 +3530,14 @@
     }
   },
   {
-    "search": "Same mock filter as Checkbox; switches can enable several flags (comma-separated in the query).\n",
+    "search": "sonic-form-layout arranges slotted form controls in a responsive CSS grid with consistent vertical spacing. Pair sonic-input · sonic-select and sonic-input-autocomplete fields side by side when the host is wider than 440px; textareas, toggles, dividers, and sonic-form-actions span the full width. Wrap a form or sonic-fieldset body—no attributes are required.\n",
     "files": {
-      "core/components/ui/form/switch/switch.md": {
-        "title": "Switch",
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
         "hashes": {
-          "example-of-use--blacklist--queue": {
+          "form-layout": {
             "count": 1,
-            "title": "Example of use — blacklist + queue",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -3225,27 +3545,1737 @@
     }
   },
   {
-    "search": "Textarea",
+    "search": "Typical registration-style form: short fields flow in two columns on wide layouts; long or grouped blocks stay full width.\n",
     "files": {
-      "core/components/ui/form/textarea/textarea.md": {
-        "title": "Textarea",
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "When the host offsetWidth is greater than 440px, the grid uses two equal columns with slightly larger gap (1.75rem). Below that breakpoint, fields stack in a single column (1.5rem gap).\n",
+    "files": {
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "responsive-columns": {
+            "count": 1,
+            "title": "Responsive columns",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "If the slot contains exactly one direct sonic-input, sonic-select, or sonic-input-autocomplete, the layout stays one column even above the breakpoint so a lone field does not sit in half an empty row.\n",
+    "files": {
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "responsive-columns": {
+            "count": 1,
+            "title": "Responsive columns",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Everything except sonic-input, sonic-select, sonic-input-autocomplete, and slotted elements with class form-item-container is assigned grid-column: 1 / -1. Use this for sonic-textarea, sonic-checkbox, sonic-switch, sonic-form-actions, sonic-divider, and similar blocks.\n",
+    "files": {
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "full-width-slotted-blocks": {
+            "count": 1,
+            "title": "Full-width slotted blocks",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Slotted sonic-divider sets --sc-divider-my: 0 so divider spacing matches the grid rhythm. Slotted sonic-submit uses display: contents so submit controls participate in the grid without an extra wrapper box.\n",
+    "files": {
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "full-width-slotted-blocks": {
+            "count": 1,
+            "title": "Full-width slotted blocks",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Add class form-item-container on a slotted wrapper (for example a div) when a field is not a direct sonic-input / sonic-select / sonic-input-autocomplete but should still share the two-column flow with short inputs.\n",
+    "files": {
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "custom-column-wrapper": {
+            "count": 1,
+            "title": "Custom column wrapper",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "No public attributes — layout follows slotted children and host width.\n",
+    "files": {
+      "core/components/ui/form/form-layout/form-layout.md": {
+        "title": "Form layout",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Input",
+    "files": {
+      "core/components/ui/form/input/input.md": {
+        "title": "Input",
+        "hashes": {
+          "input": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Liste des types\n",
+    "files": {
+      "core/components/ui/form/input/input.md": {
+        "title": "Input",
+        "hashes": {
+          "type": {
+            "count": 1,
+            "title": "Type",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Filter with formDataProvider + name="contains" (mock API: substring on joke text). Caption and rows via Lit (@subscribe, .items on sonic-queue):\n",
+    "files": {
+      "core/components/ui/form/input/input.md": {
+        "title": "Input",
+        "hashes": {
+          "example-of-use--search--queue": {
+            "count": 1,
+            "title": "Example of use — search + queue",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Input-autocomplete",
+    "files": {
+      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
+        "title": "Input-autocomplete",
+        "hashes": {
+          "input-autocomplete": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Champ formulaire + suggestions via queue. Valeur via formDataProvider + name ; la recherche filtre la queue (store interne).\n",
+    "files": {
+      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
+        "title": "Input-autocomplete",
+        "hashes": {
+          "input-autocomplete": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Rendu des lignes : propriété .items (callback Lit) — voir les démos ci-dessous. Mock : serviceURL="/docs-mock-api/geo/".\n",
+    "files": {
+      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
+        "title": "Input-autocomplete",
+        "hashes": {
+          "input-autocomplete": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "name = paramètre de recherche = valeur formulaire.\n",
+    "files": {
+      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
+        "title": "Input-autocomplete",
+        "hashes": {
+          "simple": {
+            "count": 1,
+            "title": "Simple",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Recherche sur nom, valeur formulaire = code. Préremplissage via value.\n",
+    "files": {
+      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
+        "title": "Input-autocomplete",
+        "hashes": {
+          "valeur--paramètre-de-recherche": {
+            "count": 1,
+            "title": "Valeur ≠ paramètre de recherche",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "À la fermeture du pop, seule une valeur de la liste (ou vide) est conservée.\n",
+    "files": {
+      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
+        "title": "Input-autocomplete",
+        "hashes": {
+          "mode-select": {
+            "count": 1,
+            "title": "Mode select",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "data-keyboard-nav sur le champ et les items (flèches haut / bas).\n",
+    "files": {
+      "core/components/ui/form/input-autocomplete/input-autocomplete.md": {
+        "title": "Input-autocomplete",
+        "hashes": {
+          "navigation-clavier": {
+            "count": 1,
+            "title": "Navigation clavier",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Radio",
+    "files": {
+      "core/components/ui/form/radio/radio.md": {
+        "title": "Radio",
+        "hashes": {
+          "radio": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Same mock filter as Checkbox (blacklistFlags query param). Radio sends one flag at a time.\n",
+    "files": {
+      "core/components/ui/form/radio/radio.md": {
+        "title": "Radio",
+        "hashes": {
+          "example-of-use--blacklist--queue": {
+            "count": 1,
+            "title": "Example of use — blacklist + queue",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Select",
+    "files": {
+      "core/components/ui/form/select/select.md": {
+        "title": "Select",
+        "hashes": {
+          "select": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "name="lang" is sent as ?lang=fr|en to the doc mock API (filterDocsJokes). Same pattern as Input (contains):\n",
+    "files": {
+      "core/components/ui/form/select/select.md": {
+        "title": "Select",
+        "hashes": {
+          "example-of-use--language-filter--queue": {
+            "count": 1,
+            "title": "Example of use — language filter + queue",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Switch",
+    "files": {
+      "core/components/ui/form/switch/switch.md": {
+        "title": "Switch",
+        "hashes": {
+          "switch": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Same mock filter as Checkbox; switches can enable several flags (comma-separated in the query).\n",
+    "files": {
+      "core/components/ui/form/switch/switch.md": {
+        "title": "Switch",
+        "hashes": {
+          "example-of-use--blacklist--queue": {
+            "count": 1,
+            "title": "Example of use — blacklist + queue",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Textarea",
+    "files": {
+      "core/components/ui/form/textarea/textarea.md": {
+        "title": "Textarea",
+        "hashes": {
+          "textarea": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Group",
+    "files": {
+      "core/components/ui/group/group.md": {
+        "title": "Group",
+        "hashes": {
+          "group": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-group lays out slotted sonic-button · sonic-input and sonic-select controls in a single horizontal row with shared corner radius (first / middle / last items). Optional label and description follow form field styling. Use it for button groups, radio rows, or input + action toolbars.\n",
+    "files": {
+      "core/components/ui/group/group.md": {
+        "title": "Group",
+        "hashes": {
+          "group": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Pair with sonic-button radio and a shared name; ancestor formDataProvider stores the selected value.\n",
+    "files": {
+      "core/components/ui/group/group.md": {
+        "title": "Group",
+        "hashes": {
+          "radio-group": {
+            "count": 1,
+            "title": "Radio group",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Adjacent link or action buttons without merging into one control.\n",
+    "files": {
+      "core/components/ui/group/group.md": {
+        "title": "Group",
+        "hashes": {
+          "button-group": {
+            "count": 1,
+            "title": "Button group",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Action control before the field. label or description on sonic-group annotate the row.\n",
+    "files": {
+      "core/components/ui/group/group.md": {
+        "title": "Group",
+        "hashes": {
+          "input-actions-prefix": {
+            "count": 1,
+            "title": "Input actions prefix",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Field first, action after (submit, validate, etc.).\n",
+    "files": {
+      "core/components/ui/group/group.md": {
+        "title": "Group",
+        "hashes": {
+          "input-actions-suffix": {
+            "count": 1,
+            "title": "Input actions suffix",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Icon",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "icon": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-icon renders inline SVG icons from the bundled core set or from CDN libraries. Set name (and library / prefix when needed); scale with size. Icons inherit currentColor and are aria-hidden by default—keep visible text nearby or label the control that contains them.\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "icon": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Omit library to use the bundled set in icons.json. Available name values: cancel · check · check-circled-outline · emoji-puzzled · info-empty · loader · minus-small · more-horiz · more-vert · nav-arrow-down · warning-circled-outline.\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "core-library": {
+            "count": 1,
+            "title": "Core library",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set library to load SVGs from a built-in CDN template. prefix falls back to each library’s default when omitted (outline for heroicons, regular for fontAwesome and material, and so on).\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "external-libraries": {
+            "count": 1,
+            "title": "External libraries",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use library="custom" with SVG files on your origin. On an ancestor (for example sonic-scope or sonic-code), set customIconLibraryPath to a URL template with $prefix and $name placeholders, and optionally customIconDefaultPrefix when prefix is omitted.\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "custom-library": {
+            "count": 1,
+            "title": "Custom library",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "<sonic-code\n  customIconLibraryPath="/svg/$prefix/$name.svg"\n  customIconDefaultPrefix="regular"\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "custom-library": {
+            "count": 1,
+            "title": "Custom library",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Omit size for the default scale (1em height). Larger steps use 3xl.\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "size": {
+            "count": 1,
+            "title": "Size",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "On connect, the host sets aria-hidden="true". Treat icons as decorative unless the surrounding control already has an accessible name. Do not rely on sonic-icon alone for meaning—use visible text or aria-label on the parent button / link.\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "accessibility": {
+            "count": 1,
+            "title": "Accessibility",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Ancestor attributes (for library="custom" only): customIconLibraryPath (URL template with $prefix and $name) and customIconDefaultPrefix. May be set on sonic-scope, theme roots, or globally in the document.\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "No slots — the component inlines fetched or bundled SVG markup.\n",
+    "files": {
+      "core/components/ui/icon/icon.md": {
+        "title": "Icon",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Image",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "image": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-image wraps a responsive <img> with aspect ratio, object-fit: cover, optional rounded corners, and load transitions. The host shows a placeholder background (--sc-placeholder-bg) until the asset loads. Default loading is lazy; use loading="eager" for above-the-fold heroes.\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "image": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Omit rounded for square corners. Boolean rounded uses the theme token --sc-rounded. Sizes: sm, md, lg, xl, full (circle — pair with ratio="1/1"), none (explicit reset).\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "rounded": {
+            "count": 1,
+            "title": "Rounded",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "ratio sets CSS aspect-ratio on the image (default auto). The image still fills the host width (width: 100%).\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "aspect-ratio": {
+            "count": 1,
+            "title": "Aspect ratio",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "objectPosition maps to CSS object-position (default center center). Useful on wide crops when the subject sits off-center.\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "object-position": {
+            "count": 1,
+            "title": "Object position",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "cover stretches the image to fill a positioned parent (position: relative + fixed height or inset). Aspect ratio on the host is ignored while cover is set.\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "cover": {
+            "count": 1,
+            "title": "Cover",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set transition to fade (default when the attribute is present) or fade-scale-out. The image stays at opacity: 0 until the browser fires load, then the loaded class runs the animation. Changing src on an existing element does not replay the effect — mount a new sonic-image when you need another entrance (galleries, infinite scroll).\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "load-transition": {
+            "count": 1,
+            "title": "Load transition",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Click Add image to append small thumbnails and replay the transition. Clear resets the row.\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "load-transition": {
+            "count": 1,
+            "title": "Load transition",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Always set meaningful alt text (empty string only for decorative images). \n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "accessibility-and-parts": {
+            "count": 1,
+            "title": "Accessibility and parts",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "No slots — content is driven entirely by attributes on the inner <img>.\n",
+    "files": {
+      "core/components/ui/image/image.md": {
+        "title": "Image",
+        "hashes": {
+          "api-reference": {
+            "count": 2,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Link",
+    "files": {
+      "core/components/ui/link/link.md": {
+        "title": "Link",
+        "hashes": {
+          "link": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Links navigate with inherited typography: internal routes, anchors, or external URLs. The default slot is the anchor label. For in-app routing, pair href with pushstate; use autoActive to reflect the current URL on the host (active).\n",
+    "files": {
+      "core/components/ui/link/link.md": {
+        "title": "Link",
+        "hashes": {
+          "link": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "target="_blank" opens a new browsing context and sets rel="noopener noreferrer".\n",
+    "files": {
+      "core/components/ui/link/link.md": {
+        "title": "Link",
+        "hashes": {
+          "target": {
+            "count": 1,
+            "title": "Target",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set pushstate on same-origin href values to intercept clicks and navigate through Concorde’s client router without a full reload.\n",
+    "files": {
+      "core/components/ui/link/link.md": {
+        "title": "Link",
+        "hashes": {
+          "pushstate": {
+            "count": 1,
+            "title": "Pushstate",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Default autoActive is partial: the host gets active when the current URL starts with href. Style with [&[active]]: utilities or host selectors.\n",
+    "files": {
+      "core/components/ui/link/link.md": {
+        "title": "Link",
+        "hashes": {
+          "autoactive": {
+            "count": 1,
+            "title": "AutoActive",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "strict requires pathname, search, and hash to match. strict-path-only matches pathname and hash but ignores search.\n",
+    "files": {
+      "core/components/ui/link/link.md": {
+        "title": "Link",
+        "hashes": {
+          "autoactive-strict-vs-partial": {
+            "count": 1,
+            "title": "AutoActive strict vs partial",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The inner <a> uses focus-visible outline styling. Set data-aria-label when the slot text is not sufficient on its own.\n",
+    "files": {
+      "core/components/ui/link/link.md": {
+        "title": "Link",
+        "hashes": {
+          "accessibility": {
+            "count": 1,
+            "title": "Accessibility",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Loader",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "loader": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-loader shows a loading animation in the page or as a viewport overlay. Default mode is fixed (centered overlay). Use inline inside lists and fetch placeholders. Pair noDelay when the spinner should appear without the default fade-in wait. For sonic-fetch / sonic-list, set the parent loader attribute instead of embedding a tag manually.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "loader": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Inline loaders fit content areas; they use the theme primary color unless currentColor is set.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "inline — ellipsis animation in the document flow. fixed — centered overlay (position: fixed); default when the tag is omitted.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "mode": {
+            "count": 1,
+            "title": "Mode",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use the checkbox below to toggle a fixed loader over the page (default mode on sonic-loader).\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "mode": {
+            "count": 1,
+            "title": "Mode",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "align only affects mode="inline": left · center (default) · right. Set currentColor so dots follow the host color (for example on a purple parent).\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "inline-alignment-and-color": {
+            "count": 1,
+            "title": "Inline alignment and color",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "By default mode="fixed" waits briefly before fading in. mode="inline" already skips that wait. Set noDelay on fixed (or pass noDelay: true to Loader.show()) to appear immediately.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "nodelay": {
+            "count": 1,
+            "title": "`noDelay`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The animation is aria-hidden by default so screen readers are not spammed on every fetch. Set announce when the loader is injected after user action (for example a global overlay): the host gets role="status", aria-live="polite", and a localized aria-label (“Loading” / “Chargement en cours”, …). For in-button loading, prefer sonic-button loading and aria-busy on the control—not on the loader.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "accessibility-announce": {
+            "count": 1,
+            "title": "Accessibility (`announce`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Import Loader and call Loader.show() / Loader.hide(). hide() is reference-counted: call it once per show(). With no container, the loader is appended to the theme pop container and mode is always fixed. Pass container and mode: "inline" to mount an inline instance in a specific element.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "show-and-hide-programmatically": {
+            "count": 1,
+            "title": "Show and hide programmatically",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Loader.show({\n  mode: "fixed",\n  noDelay: false,\n  announce: true,\n  container: document.querySelector("#foo"),\n});\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "show-and-hide-programmatically": {
+            "count": 1,
+            "title": "Show and hide programmatically",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Loader.hide();\n  \n\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "show-and-hide-programmatically": {
+            "count": 1,
+            "title": "Show and hide programmatically",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-button loading shows an icon spinner and sets aria-busy on the button. sonic-fetch and sonic-list render sonic-loader when their loader attribute is set: true or an empty string maps to fixed; otherwise use inline or fixed.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "composition": {
+            "count": 1,
+            "title": "Composition",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "This component has no slots. The animation markup is internal.\n",
+    "files": {
+      "core/components/ui/loader/loader.md": {
+        "title": "Loader",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Menu",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "menu": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-menu lays out navigation or actions as a direction row or column of sonic-menu-item entries (ghost variant and block shape by default), optional sonic-divider separators, and overflow content in the more slot (popover “…” trigger). Set href / pushstate / autoActive on each sonic-menu-item—same API as sonic-button—not on the menu host.\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "menu": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Default direction is column. Use row for horizontal toolbars or tabs.\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "direction": {
+            "count": 1,
+            "title": "Direction",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "size on the menu propagates to items and the more trigger when they omit their own size.\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "size": {
+            "count": 1,
+            "title": "Size",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Optional shadow wraps the menu surface (no shadow when omitted).\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "shadow": {
+            "count": 1,
+            "title": "Shadow",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "align propagates to items except square / circle shape.\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "align": {
+            "count": 1,
+            "title": "Align",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Assign nodes to slot="more" to show the overflow popover. The trigger appears only when the slot has content. Icon orientation follows direction (vertical ellipsis in a row menu).\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "more": {
+            "count": 1,
+            "title": "More",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "With scrollable, the main slot scrolls with edge fade masks; drag-to-scroll works on pointer devices. When exactly one item is active, the menu scrolls it into view.\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "scrollable": {
+            "count": 1,
+            "title": "Scrollable",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-menu-item extends sonic-button (defaults: variant="ghost", shape="block"). Use the button docs for type, variant, href, pushstate, autoActive, and item slots.\n",
+    "files": {
+      "core/components/ui/menu/menu.md": {
+        "title": "Menu",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Modal",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "modal": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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).\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "modal": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Long copy scrolls inside the dialog. Default maxHeight is 90vh. Default align is left.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "scrollable-content": {
+            "count": 1,
+            "title": "Scrollable content",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "force-action": {
+            "count": 1,
+            "title": "Force action",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set width / height / maxWidth / maxHeight (CSS lengths). On narrow viewports the panel becomes a bottom sheet. Use rounded="none" for edge-to-edge media.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "custom-dimensions": {
+            "count": 1,
+            "title": "Custom dimensions",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "fullscreen fills the viewport and hides the backdrop.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "fullscreen": {
+            "count": 1,
+            "title": "Fullscreen",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "programmatic-creation": {
+            "count": 1,
+            "title": "Programmatic creation",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "programmatic-creation": {
+            "count": 1,
+            "title": "Programmatic creation",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "const modal = Modal.create({\n  title: "Delete project?",\n  subtitle: "This cannot be undone.",\n  content: "All files in Acme HQ will be removed.",\n  actions:     <sonic-button hideModal minWidth="8rem">Cancel</sonic-button>     <sonic-button hideModal minWidth="8rem" type="danger">Delete</sonic-button>  ,\n  removeOnHide: true,\n  forceAction: false,\n  maxWidth: "min(100vw, 28rem)",\n});\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "programmatic-creation": {
+            "count": 1,
+            "title": "Programmatic creation",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "modal.addEventListener("hidden", () => {\n  console.log("Modal removed from the DOM");\n});\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "programmatic-creation": {
+            "count": 1,
+            "title": "Programmatic creation",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "// Or close from script: await modal.hide(); await modal.dispose();\n  \n\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "programmatic-creation": {
+            "count": 1,
+            "title": "Programmatic creation",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "sonic-modal": {
+            "count": 1,
+            "title": "`sonic-modal`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Put hideModal on a sonic-button to close the parent modal on click. Ancestor formDataProvider on this element is inherited by child form controls.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "sonic-modal-actions": {
+            "count": 1,
+            "title": "`sonic-modal-actions`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Rendered automatically unless forceAction or noCloseButton is set. Calls hide() on the parent modal.\n",
+    "files": {
+      "core/components/ui/modal/modal.md": {
+        "title": "Modal",
+        "hashes": {
+          "sonic-modal-close": {
+            "count": 1,
+            "title": "`sonic-modal-close`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Pop",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "pop": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "pop": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "placement": {
+            "count": 1,
+            "title": "Placement",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Default shadow is lg. The shadow applies to the floating content panel.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "shadow": {
+            "count": 1,
+            "title": "Shadow",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "By default the host is middle-aligned with siblings. Set inline to baseline-align the trigger inside running text.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "inline": {
+            "count": 1,
+            "title": "Inline",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "no-toggle": {
+            "count": 1,
+            "title": "No toggle",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "manual-control": {
+            "count": 1,
+            "title": "Manual control",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Click Click to open pop to open the panel programmatically.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "manual-control": {
+            "count": 1,
+            "title": "Manual control",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "keep-open-on-select": {
+            "count": 1,
+            "title": "Keep open on select",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "keyboard-and-dismissal": {
+            "count": 1,
+            "title": "Keyboard and dismissal",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Methods: show() · hide() on the host element.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Events: show · hide (non-bubbling CustomEvent).\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Content attribute: data-on-select="keep" on content or descendants prevents close-on-click inside the panel.\n",
+    "files": {
+      "core/components/ui/pop/pop.md": {
+        "title": "Pop",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Progress",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
+        "hashes": {
+          "progress": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Shows task completion on a value / max scale via a native <progress> bar. Omit value for an indeterminate loading animation. Put primary copy in the default slot and optional secondary text in remaining; set invert when the bar sits on a colored surface such as sonic-card.\n",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
+        "hashes": {
+          "progress": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set value from 0 to max (default 100). Label text uses the type color.\n",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
+        "hashes": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "With no value, the bar animates until progress is known.\n",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
+        "hashes": {
+          "indeterminate": {
+            "count": 1,
+            "title": "Indeterminate",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Semantic color follows type. With no type, behavior is default.\n",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
+        "hashes": {
+          "type": {
+            "count": 1,
+            "title": "Type",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Bar height scales with typography via size. With no size, font size matches md (1rem).\n",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
+        "hashes": {
+          "size": {
+            "count": 1,
+            "title": "Size",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The default slot is the main label (left). remaining is right-aligned with lighter weight—use it for “left to complete” copy.\n",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
+        "hashes": {
+          "default-and-remaining-slots": {
+            "count": 1,
+            "title": "Default and remaining slots",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "On tinted backgrounds, invert adjusts track and fill tokens so the bar stays readable (pair with matching type on sonic-card or similar).\n",
+    "files": {
+      "core/components/ui/progress/progress.md": {
+        "title": "Progress",
         "hashes": {
-          "textarea": {
+          "invert": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Invert",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Group",
+    "search": "Table",
     "files": {
-      "core/components/ui/group/group.md": {
-        "title": "Group",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "group": {
+          "table": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -3255,44 +5285,44 @@
     }
   },
   {
-    "search": "Icon",
+    "search": "sonic-table lays out tabular data with composable sonic-tr / sonic-th / sonic-td children. The root applies shared typography via size, scrolls horizontally when content overflows, and optionally caps height with maxHeight. Pair with sonic-thead and sonic-tbody for structure and with sonic-list to render fetched rows.\n",
     "files": {
-      "core/components/ui/icon/icon.md": {
-        "title": "Icon",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "icon": {
+          "table": {
             "count": 1,
             "title": "",
-            "type": "page"
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Image",
+    "search": "A header row plus body rows is enough for static tables; sonic-thead / sonic-tbody are optional for simple layouts.\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "image": {
+          "basic-example": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Basic example",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Responsive <img> wrapper: aspect ratio, object-fit: cover, rounded corners, and optional fade-in on load. The host uses a light placeholder background (--sc-placeholder-bg) until the file is ready. Default loading is lazy; set loading="eager" for above-the-fold heroes.\n",
+    "search": "Place sonic-list inside sonic-tbody so each item template renders a sonic-tr. sonic-list sets row metadata (even / odd / last) on sonic-tr for striping and borders.\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "image": {
+          "list-and-fetch": {
             "count": 1,
-            "title": "",
+            "title": "List and fetch",
             "type": "paragraph"
           }
         }
@@ -3300,14 +5330,14 @@
     }
   },
   {
-    "search": "Omit rounded for square corners. Boolean rounded uses the theme token --sc-rounded. Sizes: sm, md, lg, xl, full (circle — pair with ratio="1/1"), none (explicit reset).\n",
+    "search": "Default font size is md (omit size). Sizes follow the shared scale (2xs … 2xl).\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "rounded": {
+          "size": {
             "count": 1,
-            "title": "Rounded",
+            "title": "Size",
             "type": "paragraph"
           }
         }
@@ -3315,14 +5345,14 @@
     }
   },
   {
-    "search": "ratio sets CSS aspect-ratio on the image (default auto). The image still fills the host width (width: 100%).\n",
+    "search": "Set bordered on sonic-table for an outer frame and horizontal rules between rows.\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "aspect-ratio": {
+          "bordered": {
             "count": 1,
-            "title": "Aspect ratio",
+            "title": "Bordered",
             "type": "paragraph"
           }
         }
@@ -3330,14 +5360,14 @@
     }
   },
   {
-    "search": "objectPosition maps to CSS object-position (default center center). Useful on wide crops when the subject sits off-center.\n",
+    "search": "maxHeight applies to the scroll container (for example 8rem), so the body scrolls vertically while the table can still scroll horizontally.\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "object-position": {
+          "max-height": {
             "count": 1,
-            "title": "Object position",
+            "title": "Max height",
             "type": "paragraph"
           }
         }
@@ -3345,14 +5375,14 @@
     }
   },
   {
-    "search": "cover stretches the image to fill a positioned parent (position: relative + fixed height or inset). Aspect ratio on the host is ignored while cover is set.\n",
+    "search": "Set type on sonic-th / sonic-td / sonic-tr for semantic text color (primary · info · success · warning · danger · neutral · default).\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "cover": {
+          "type": {
             "count": 1,
-            "title": "Cover",
+            "title": "Type",
             "type": "paragraph"
           }
         }
@@ -3360,14 +5390,14 @@
     }
   },
   {
-    "search": "Set transition to fade (default when the attribute is present) or fade-scale-out. The image stays at opacity: 0 until the browser fires load, then the loaded class runs the animation. Changing src on an existing element does not replay the effect — mount a new sonic-image when you need another entrance (galleries, infinite scroll).\n",
+    "search": "Use colSpan and rowSpan on sonic-th or sonic-td (maps to colspan / rowspan on the cell).\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "load-transition": {
+          "colspan-and-rowspan": {
             "count": 1,
-            "title": "Load transition",
+            "title": "Colspan and rowspan",
             "type": "paragraph"
           }
         }
@@ -3375,14 +5405,14 @@
     }
   },
   {
-    "search": "Click Add image to append small thumbnails and replay the transition. Clear resets the row.\n",
+    "search": "align sets horizontal alignment (left · center · right). minWidth / maxWidth / width set inline dimensions on the cell. vAlign is available on sonic-td only.\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "load-transition": {
+          "cell-alignment-and-width": {
             "count": 1,
-            "title": "Load transition",
+            "title": "Cell alignment and width",
             "type": "paragraph"
           }
         }
@@ -3390,14 +5420,14 @@
     }
   },
   {
-    "search": "Always set meaningful alt text (empty string only for decorative images). \n",
+    "search": "Tables scroll horizontally by default when columns exceed the viewport. Use minWidth on wide columns to preserve readable line length.\n",
     "files": {
-      "core/components/ui/image/image.md": {
-        "title": "Image",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "accessibility-and-parts": {
+          "responsive-layout": {
             "count": 1,
-            "title": "Accessibility and parts",
+            "title": "Responsive layout",
             "type": "paragraph"
           }
         }
@@ -3405,42 +5435,42 @@
     }
   },
   {
-    "search": "Link",
+    "search": "sonic-th uses position: sticky with top: 0 inside the table. For page-level sticky headers, set noCustomScroll on sonic-table and position sonic-thead (for example class="sticky top-16"). Add sonic-caption for a table title below the grid.\n",
     "files": {
-      "core/components/ui/link/link.md": {
-        "title": "Link",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "link": {
+          "sticky-header-and-caption": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Sticky header and caption",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Loader",
+    "search": "sonic-tbody wraps slotted rows in a native <tbody> and applies zebra / hover backgrounds to sonic-tr children.\n",
     "files": {
-      "core/components/ui/loader/loader.md": {
-        "title": "Loader",
+      "core/components/ui/table/table.md": {
+        "title": "Table",
         "hashes": {
-          "loader": {
+          "sonic-thead--sonic-tbody--sonic-tfoot": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "`sonic-thead` · `sonic-tbody` · `sonic-tfoot`",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Menu",
+    "search": "Theme",
     "files": {
-      "core/components/ui/menu/menu.md": {
-        "title": "Menu",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "menu": {
+          "theme": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -3450,44 +5480,44 @@
     }
   },
   {
-    "search": "Modal",
+    "search": "sonic-theme wraps a Concorde UI: it registers --sc-* design tokens and provides the default slot for your app. With no theme attribute (or theme="custom"), only shared primitives and your overrides apply—built-in light / dark / auto palettes are opt-in. Set color and font when the host should carry base text and typography; add Tailwind bg-base and block (or min-h-screen) on the tag for a full surface fill. Popovers, modals, and toasts mount under the nearest connected theme (see Pop container). Import @supersoniks/concorde/theme once at the app entry. For the full public token list and brand overrides, see Customization.\n",
     "files": {
-      "core/components/ui/modal/modal.md": {
-        "title": "Modal",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "modal": {
+          "theme": {
             "count": 1,
             "title": "",
-            "type": "page"
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Pop",
+    "search": "Wrap interactive components so tokens and overlays resolve from one root.\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "pop": {
+          "basic-example": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Basic example",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Default placement is bottom. Placement is written side-align, like sonic-tooltip: side is top, right, bottom or left, align is start, center or end. Without align, content is aligned on the start of the trigger. If there is not enough room, content flips to the opposite side and stays inside the viewport.\n",
+    "search": "Default: omit theme or set theme="custom". The host loads core tokens (--sc-rounded, shadows, form defaults, …) and any --sc-* you set; it does not apply the built-in light or dark palette.\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "placement": {
+          "theme-mode": {
             "count": 1,
-            "title": "Placement",
+            "title": "Theme mode",
             "type": "paragraph"
           }
         }
@@ -3495,14 +5525,14 @@
     }
   },
   {
-    "search": "The former space syntax (placement="bottom center") still works but is deprecated.\n",
+    "search": "Set theme to light or dark for Concorde’s preset palettes. Set theme="auto" to follow prefers-color-scheme (light palette until the OS prefers dark).\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "placement": {
+          "theme-mode": {
             "count": 1,
-            "title": "Placement",
+            "title": "Theme mode",
             "type": "paragraph"
           }
         }
@@ -3510,14 +5540,14 @@
     }
   },
   {
-    "search": "Default shadow is lg.\n",
+    "search": "color sets text from --sc-base-content. font applies --sc-font-family-base, --sc-font-weight-base, and --sc-font-style-base. For the page or shell background, use bg-base on sonic-theme (maps to --sc-base in Tailwind) with block so the host paints the surface. Components keep their own fallbacks when color / font are omitted.\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "shadow": {
+          "presentation": {
             "count": 1,
-            "title": "Shadow",
+            "title": "Presentation",
             "type": "paragraph"
           }
         }
@@ -3525,14 +5555,14 @@
     }
   },
   {
-    "search": "By default, pop is vertically aligned to the middle. Use inline to align it on the text baseline, e.g. inside a sentence.\n",
+    "search": "Override primitives on sonic-theme (or :root / a project stylesheet). Derived radii, shadows, and control rounding are computed from tokens such as --sc-rounded—avoid copying long lists of internal variables unless you have a specific need.\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "inline": {
+          "custom-tokens": {
             "count": 1,
-            "title": "Inline",
+            "title": "Custom tokens",
             "type": "paragraph"
           }
         }
@@ -3540,14 +5570,14 @@
     }
   },
   {
-    "search": "By default, a click inside the content closes the pop, as well as a click outside. Add data-on-select="keep" on the content, or on any of its elements, to keep the pop open when interacting with it.\n",
+    "search": "Theme.getPopContainer() returns the last connected sonic-theme, or document.body if none is connected. When a theme disconnects, the previous connected instance is adopted. Imperative Modal.create() and declarative sonic-modal use the same container.\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "keep-open-on-select": {
+          "pop-container": {
             "count": 1,
-            "title": "Keep open on select",
+            "title": "Pop container",
             "type": "paragraph"
           }
         }
@@ -3555,14 +5585,14 @@
     }
   },
   {
-    "search": "show() and hide() open and close the pop programmatically (see manual above). The pop dispatches a show event when it opens and a hide event when it closes.\n",
+    "search": "On connect, the theme publishes resolved --sc-* values and linked font stylesheet URLs (Google Fonts / Adobe Fonts) to the sonic-theme data channel and **postMessage**s them to same-page iframes. Iframes can request a refresh by posting { type: "GetSonicTheme" }.\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "methods-and-events": {
+          "embedded-iframes": {
             "count": 1,
-            "title": "Methods and events",
+            "title": "Embedded iframes",
             "type": "paragraph"
           }
         }
@@ -3570,14 +5600,14 @@
     }
   },
   {
-    "search": "The content can be styled from outside with ::part(content).\n",
+    "search": "Surface background: Tailwind bg-base on sonic-theme (requires Concorde Tailwind color base → --sc-base).\n",
     "files": {
-      "core/components/ui/pop/pop.md": {
-        "title": "Pop",
+      "core/components/ui/theme/theme.md": {
+        "title": "Theme",
         "hashes": {
-          "styling": {
+          "api-reference": {
             "count": 1,
-            "title": "Styling",
+            "title": "API reference",
             "type": "paragraph"
           }
         }
@@ -3585,12 +5615,12 @@
     }
   },
   {
-    "search": "Progress bar",
+    "search": "Toast",
     "files": {
-      "core/components/ui/progress/progress.md": {
-        "title": "Progress bar",
+      "core/components/ui/toast/toast.md": {
+        "title": "Toast",
         "hashes": {
-          "progress-bar": {
+          "toast": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -3600,12 +5630,12 @@
     }
   },
   {
-    "search": "Displays an indicator showing the completion progress of a task.\n",
+    "search": "Toasts surface short-lived feedback in a fixed stack (bottom-right in the main window). Queue messages with SonicToast.add() on the global SonicToast class—the host sonic-toast is created automatically. Prefer label for a heading; use preserve or interactive text when the user must read or act before dismiss.\n",
     "files": {
-      "core/components/ui/progress/progress.md": {
-        "title": "Progress bar",
+      "core/components/ui/toast/toast.md": {
+        "title": "Toast",
         "hashes": {
-          "progress-bar": {
+          "toast": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -3615,29 +5645,29 @@
     }
   },
   {
-    "search": "Table",
+    "search": "Click the button to show a toast.\n",
     "files": {
-      "core/components/ui/table/table.md": {
-        "title": "Table",
+      "core/components/ui/toast/toast.md": {
+        "title": "Toast",
         "hashes": {
-          "table": {
+          "basic-example": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Basic example",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Values available : primary, info, success, warning, danger\n",
+    "search": "status drives color, icon, and live-region behavior. Omit status or pass an empty string for a neutral toast.\n",
     "files": {
-      "core/components/ui/table/table.md": {
-        "title": "Table",
+      "core/components/ui/toast/toast.md": {
+        "title": "Toast",
         "hashes": {
-          "type": {
+          "status": {
             "count": 1,
-            "title": "Type",
+            "title": "Status",
             "type": "paragraph"
           }
         }
@@ -3645,14 +5675,14 @@
     }
   },
   {
-    "search": "The following attributes will be used to set the style of the component :  \n",
+    "search": "Set label for a bold title above text. title still works but is deprecated—use label in new code.\n",
     "files": {
-      "core/components/ui/table/table.md": {
-        "title": "Table",
+      "core/components/ui/toast/toast.md": {
+        "title": "Toast",
         "hashes": {
-          "cell-style-attributes": {
+          "label": {
             "count": 1,
-            "title": "Cell style attributes",
+            "title": "Label",
             "type": "paragraph"
           }
         }
@@ -3660,14 +5690,14 @@
     }
   },
   {
-    "search": "Every table is responsive by default\n",
+    "search": "text (and label) can include HTML strings. Links and controls in text automatically enable preserve so the toast does not auto-hide while the user interacts.\n",
     "files": {
-      "core/components/ui/table/table.md": {
-        "title": "Table",
+      "core/components/ui/toast/toast.md": {
+        "title": "Toast",
         "hashes": {
-          "responsive": {
+          "html-in-text": {
             "count": 1,
-            "title": "Responsive",
+            "title": "HTML in text",
             "type": "paragraph"
           }
         }
@@ -3675,29 +5705,29 @@
     }
   },
   {
-    "search": "Toast",
+    "search": "Without preserve, toasts auto-hide after about six seconds (timer pauses on hover or focus). Set preserve to keep the toast until the user closes it.\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "toast": {
+          "preserve": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Preserve",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Les statuts disponibles sont : success, error, warning, info ou vide (par défaut).\n",
+    "search": "With dismissForever and a stable id, closing the toast stores dismissal in localStorage—SonicToast.add skips it on later visits. Duplicate payloads (same fields, ignoring id) are not queued twice.\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "statut": {
+          "dismiss-forever": {
             "count": 1,
-            "title": "Statut",
+            "title": "Dismiss forever",
             "type": "paragraph"
           }
         }
@@ -3705,14 +5735,14 @@
     }
   },
   {
-    "search": "Le contenu du toast peut contenir du HTML.\n",
+    "search": "ghost renders a semi-transparent, non-interactive toast—useful for loading or background states. SonicToast.removeAll leaves ghost toasts in place.\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "avec-contenu-html": {
+          "ghost": {
             "count": 1,
-            "title": "Avec contenu HTML",
+            "title": "Ghost",
             "type": "paragraph"
           }
         }
@@ -3720,14 +5750,14 @@
     }
   },
   {
-    "search": "Par défaut, les toasts disparaissent automatiquement. Avec preserve: true, le toast reste affiché jusqu'à ce qu'il soit fermé manuellement.\n",
+    "search": "Use static helpers to clear the stack from app logic (for example after navigation).\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "persistance": {
+          "dismissal": {
             "count": 1,
-            "title": "Persistance",
+            "title": "Dismissal",
             "type": "paragraph"
           }
         }
@@ -3735,14 +5765,14 @@
     }
   },
   {
-    "search": "Avec dismissForever: true et un id, le toast peut être masqué définitivement. Une fois fermé, il ne réapparaîtra plus même après rechargement de la page.\n",
+    "search": "Removes every toast except ghost items.\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "masquer-définitivement": {
+          "remove-all": {
             "count": 1,
-            "title": "Masquer définitivement",
+            "title": "Remove all",
             "type": "paragraph"
           }
         }
@@ -3750,14 +5780,14 @@
     }
   },
   {
-    "search": "Avec ghost: true, le toast devient semi-transparent et non-interactif.\n",
+    "search": "Removes toasts that are not preserve.\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "fantôme": {
+          "remove-temporary-items": {
             "count": 1,
-            "title": "Fantôme",
+            "title": "Remove temporary items",
             "type": "paragraph"
           }
         }
@@ -3765,14 +5795,14 @@
     }
   },
   {
-    "search": "Supprime tous les toasts sauf ceux marqués comme ghost.\n",
+    "search": "Each toast uses role="alert" for error and role="status" otherwise (with aria-live="polite" when applicable). Status icons are decorative (aria-hidden). The close control has an i18n aria-label. When there is no label, a truncated string aria-label may be derived from plain text.\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "tout-supprimer": {
+          "accessibility": {
             "count": 1,
-            "title": "Tout supprimer",
+            "title": "Accessibility",
             "type": "paragraph"
           }
         }
@@ -3780,14 +5810,14 @@
     }
   },
   {
-    "search": "Supprime tous les toasts d'un statut spécifique.\n",
+    "search": "Options passed to SonicToast.add(conf):\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "supprimer-par-statut": {
+          "api-reference": {
             "count": 1,
-            "title": "Supprimer par statut",
+            "title": "API reference",
             "type": "paragraph"
           }
         }
@@ -3795,14 +5825,14 @@
     }
   },
   {
-    "search": "Supprime tous les toasts qui ne sont pas marqués comme preserve.\n",
+    "search": "sonic-toast is mounted automatically; sonic-toast-item is internal. In iframes, toasts can delegate to the parent window via postMessage.\n",
     "files": {
       "core/components/ui/toast/toast.md": {
         "title": "Toast",
         "hashes": {
-          "supprimer-les-éléments-temporaires": {
+          "api-reference": {
             "count": 1,
-            "title": "Supprimer les éléments temporaires",
+            "title": "API reference",
             "type": "paragraph"
           }
         }
@@ -3825,7 +5855,22 @@
     }
   },
   {
-    "search": "By default, tooltip is centered next to its content\n",
+    "search": "Tooltip shows a short label on hover (and on focus when the trigger can receive focus). Wrap the trigger in the default slot—buttons, icons, or plain text. Default placement is top (center-aligned). An empty label hides the bubble the same way as disabled.\n",
+    "files": {
+      "core/components/ui/tooltip/tooltip.md": {
+        "title": "Tooltip",
+        "hashes": {
+          "tooltip": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use top · bottom · left · right for the main axis. Add -start or -end to align the bubble along the anchor edge.\n",
     "files": {
       "core/components/ui/tooltip/tooltip.md": {
         "title": "Tooltip",
@@ -3839,6 +5884,51 @@
       }
     }
   },
+  {
+    "search": "label supports line breaks (\\n in markup or multiline text). Lines are trimmed;   is normalized to spaces. white-space: pre-line preserves breaks in the bubble (max width 18rem).\n",
+    "files": {
+      "core/components/ui/tooltip/tooltip.md": {
+        "title": "Tooltip",
+        "hashes": {
+          "label-formatting": {
+            "count": 1,
+            "title": "Label formatting",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "On non-interactive triggers, set focusable so the host gets tabindex="0" and the tooltip opens on keyboard focus as well as hover.\n",
+    "files": {
+      "core/components/ui/tooltip/tooltip.md": {
+        "title": "Tooltip",
+        "hashes": {
+          "focusable": {
+            "count": 1,
+            "title": "Focusable",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The bubble uses popover="hint" (non-modal, no pointer capture). Prefer focusable when the slotted content is not already focusable. When the Popover API is unavailable, the host falls back to the native title attribute with a single-line label. Opacity transitions respect prefers-reduced-motion.\n",
+    "files": {
+      "core/components/ui/tooltip/tooltip.md": {
+        "title": "Tooltip",
+        "hashes": {
+          "accessibility": {
+            "count": 1,
+            "title": "Accessibility",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Data flow",
     "files": {
@@ -8950,7 +11040,7 @@
     }
   },
   {
-    "search": "Based on lit.dev, Concorde is a collection of web components for shared apps and websites.Build UIs without tying components to a specific host stack, while keeping visual consistency through a small set of CSS variables.\n",
+    "search": "Based on lit.dev, Concorde is a collection of web components for shared apps and websites.Build UIs without tying components to a specific host stack, while keeping visual consistency through the smallest set of CSS variables needed to define a theme.\n",
     "files": {
       "docs/_getting-started/start.md": {
         "title": "Introduction",
@@ -9010,12 +11100,12 @@
     }
   },
   {
-    "search": "Adding styles",
+    "search": "Customization",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "adding-styles": {
+          "customization": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -9025,14 +11115,29 @@
     }
   },
   {
-    "search": "No style crosses the shadow root of a component, except for inheritable properties (which have the "inherit" property possible) and CSS variables.\nProperties integrated via a "slot" remain stylizable in a conventional way.\n",
+    "search": "Concorde components ship with default styles (fallback values in each component and in <sonic-theme>).You do not need to define any CSS variables to get a usable UI.\n",
+    "files": {
+      "docs/_getting-started/theming.md": {
+        "title": "Customization",
+        "hashes": {
+          "theme-first-customization": {
+            "count": 1,
+            "title": "Theme-first customization",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "To align the kit with your brand, override only the essential theme tokens on <sonic-theme>, on :root, or in a project stylesheet.Concorde derives radius steps, button/input rounding, shadows, and most per-component layout from these primitives—do not copy long lists of derived variables unless you have a specific need.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "normal-behavior": {
+          "theme-first-customization": {
             "count": 1,
-            "title": "Normal Behavior",
+            "title": "Theme-first customization",
             "type": "paragraph"
           }
         }
@@ -9040,14 +11145,14 @@
     }
   },
   {
-    "search": "The declaration of reactive properties is useful for selecting a particular configuration that mostly affects a set of properties.\n",
+    "search": "Popovers, modals, and toasts mount under the nearest <sonic-theme>.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "choosing-style-presets-via-reactive-properties": {
+          "theme-first-customization": {
             "count": 1,
-            "title": "Choosing Style Presets via Reactive Properties:",
+            "title": "Theme-first customization",
             "type": "paragraph"
           }
         }
@@ -9055,14 +11160,14 @@
     }
   },
   {
-    "search": "For example, a size property (xs, sm, md, xl) will affect margins, font, line heights to align them with the corresponding CSS vars, which can be customized using the methods mentioned earlier if necessary.\n",
+    "search": "Example (full brand override on <sonic-theme> or :root). Set every essential token below; derived radii and shadows still come from the theme engine—only --sc-rounded is listed here.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "choosing-style-presets-via-reactive-properties": {
+          "customization-example": {
             "count": 1,
-            "title": "Choosing Style Presets via Reactive Properties:",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9070,14 +11175,14 @@
     }
   },
   {
-    "search": "It is recommended to use the {reflect: true} property for reactive properties that have an associated style on the :host(). For example: :host([type='primary']){...}\n",
+    "search": "  /* Text/icons on semantic fills */\n  --sc-primary-content: #fff;\n  --sc-secondary-content: #fff;\n  --sc-info-content: #fff;\n  --sc-danger-content: #fff;\n  --sc-warning-content: #fff;\n  --sc-success-content: #fff;\n  --sc-contrast-content: #fff;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "choosing-style-presets-via-reactive-properties": {
+          "customization-example": {
             "count": 1,
-            "title": "Choosing Style Presets via Reactive Properties:",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9085,14 +11190,14 @@
     }
   },
   {
-    "search": "☢️ Caution: Passing class names via reactive properties / HTML attributes of the component should be avoided as it can quickly lead to difficult-to-manage situations.\n",
+    "search": "  /* Neutral fills */\n  --sc-base: #fff;\n  --sc-base-50: #f6f6f5;\n  --sc-base-100: #ededec;\n  --sc-base-200: #d7d7d4;\n  --sc-base-300: #c8c7c4;\n  --sc-base-400: #a8a7a2;\n  --sc-base-500: #94938c;\n  --sc-base-600: #76756c;\n  --sc-base-700: #59584e;\n  --sc-base-800: #47463b;\n  --sc-base-900: #353429;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "choosing-style-presets-via-reactive-properties": {
+          "customization-example": {
             "count": 1,
-            "title": "Choosing Style Presets via Reactive Properties:",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9100,14 +11205,14 @@
     }
   },
   {
-    "search": "By default, the display property is inline.\nTherefore, be careful to define it according to the needs, as one might mistakenly expect it to be block as with a regular <div>.\n",
+    "search": "  /* Text/icons on neutral surfaces */\n  --sc-base-content: var(--sc-base-900);\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "css-display-property": {
+          "customization-example": {
             "count": 1,
-            "title": "CSS \"display\" Property",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9115,14 +11220,14 @@
     }
   },
   {
-    "search": "☢️ Caution: Defining the display property as contents may seem attractive at first, but:\n",
+    "search": "  /* Typography */\n  --sc-font-family-base: "Oswald", system-ui, -apple-system, "Segoe UI", Roboto,\n    "Helvetica Neue", Arial, sans-serif;\n  --sc-headings-font-family: "alternate-gothic-compressed", system-ui, sans-serif;\n  --sc-headings-line-height: 1.1;\n  --sc-headings-font-weight: bold;\n  --sc-headings-text-transform: none;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "css-display-property": {
+          "customization-example": {
             "count": 1,
-            "title": "CSS \"display\" Property",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9130,14 +11235,14 @@
     }
   },
   {
-    "search": "tailwind has been integrated into Concorde and is available in scoped components (with Shadow DOM).\nTo use it, you need to import the following:\n",
+    "search": "  /* Shape (primitive only) */\n  --sc-rounded: 0;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "tailwind-functional-classes": {
+          "customization-example": {
             "count": 1,
-            "title": "TAILWIND Functional Classes",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9145,14 +11250,14 @@
     }
   },
   {
-    "search": "Then include the tailwind style in the static styles property of the component:\n",
+    "search": "  /* Forms */\n  --sc-border-width: 0.2rem;\n  --sc-form-height: 2em;\n  --sc-input-bg: var(--sc-base);\n  --sc-input-color: var(--sc-base-content);\n  --sc-input-border-color: var(--sc-input-color);\n  --sc-input-active-bg: var(--sc-primary);\n  --sc-input-active-color: var(--sc-primary-content);\n  --sc-input-active-border-color: var(--sc-primary);\n}\n  \n\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "tailwind-functional-classes": {
+          "customization-example": {
             "count": 1,
-            "title": "TAILWIND Functional Classes",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9160,14 +11265,14 @@
     }
   },
   {
-    "search": "Finally, use it in the HTML within the render function:\n",
+    "search": " Palette generator: concordecolors\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "tailwind-functional-classes": {
+          "customization-example": {
             "count": 1,
-            "title": "TAILWIND Functional Classes",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9175,14 +11280,14 @@
     }
   },
   {
-    "search": "The colors from Concorde's theme are referenced in Tailwind's theme.\n",
+    "search": "Without these overrides, components keep Concorde’s per-component fallbacks. Built-in light/dark palettes apply only when you set theme="light", theme="dark", or theme="auto".\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "tailwind-functional-classes": {
+          "customization-example": {
             "count": 1,
-            "title": "TAILWIND Functional Classes",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9190,14 +11295,14 @@
     }
   },
   {
-    "search": "This operation is particularly useful when it comes to adding behavior to a simple existing element.\nIt may also become necessary to establish compatibility with a traditional JS library.\n",
+    "search": "What we intentionally avoid: large public --sc-alert-* / --sc-badge-* APIs or ::part() styling hooks on most components. Prefer attributes (type, status, size, …) and the theme tokens above.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "usefulness": {
+          "customization-example": {
             "count": 1,
-            "title": "Usefulness",
+            "title": "Customization example",
             "type": "paragraph"
           }
         }
@@ -9205,14 +11310,14 @@
     }
   },
   {
-    "search": "For example, with a text input:\n",
+    "search": "These are the smallest set we recommend customizing. Everything else should stay internal to the theme or to components (--sc_* private variables, attributes like type, size, variant).\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "usefulness": {
+          "only-essential-css-variables-public-theme-api": {
             "count": 1,
-            "title": "Usefulness",
+            "title": "Only essential CSS variables (public theme API)",
             "type": "paragraph"
           }
         }
@@ -9220,14 +11325,14 @@
     }
   },
   {
-    "search": "If there is no shadow DOM (see the noShadowDom property of Subscriber):\n",
+    "search": "Tokens without a -content suffix are fill / background colors.Tokens with -content are text and icons on top of the matching fill (solid buttons, badges, alerts, etc.).\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "consequences": {
+          "surfaces-and-foreground": {
             "count": 1,
-            "title": "Consequences",
+            "title": "Surfaces and foreground",
             "type": "paragraph"
           }
         }
@@ -9235,14 +11340,14 @@
     }
   },
   {
-    "search": "For example, the components queue, list, and fetch do not have a shadow DOM.\n",
+    "search": "Interactive controls expose a few extra theme-level tokens; prefer these over styling individual inputs from outside.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "consequences": {
+          "forms-only-if-you-customize-inputs-globally": {
             "count": 1,
-            "title": "Consequences",
+            "title": "Forms (only if you customize inputs globally)",
             "type": "paragraph"
           }
         }
@@ -9250,14 +11355,14 @@
     }
   },
   {
-    "search": "ℹ️ Note: Specifically in this case, it may be useful to set the display property to contents.\n",
+    "search": "Set tailwind.config.js to match concorde style token in your custom component.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Adding styles",
+        "title": "Customization",
         "hashes": {
-          "consequences": {
+          "tailwind-in-new-components-": {
             "count": 1,
-            "title": "Consequences",
+            "title": "Tailwind in new components ?",
             "type": "paragraph"
           }
         }