@supersoniks/concorde 5.1.1 → 5.1.3

package/docs/src/core/components/functional/router/router.md

@@ -0,0 +1,93 @@
+# Router
+
+**`sonic-router`** watches the location (pathname + hash) and renders the views whose route matches. From Lit, pass a `.routes` map of path patterns to render functions; use **`sonic-redirect`** to navigate when a value appears in a data provider.
+
+## Static routes
+
+Each key is tested against the pathname + hash, first as a RegExp, then as a [url-pattern](https://www.npmjs.com/package/url-pattern). Every matching route renders; the `fallback` key renders when none does. The demo links append a second hash so the doc page itself stays loaded.
+
+<docs-lit-demo for="docs-router-basic-demo"></docs-lit-demo>
+
+Set `.routes` as a **property** binding: render functions cannot go through an HTML attribute.
+
+## Route parameters
+
+A url-pattern key such as `#flights/:code` passes an object (`{ code }`) to its render function. A RegExp key passes its capturing groups as an array, in order.
+
+<docs-lit-demo for="docs-router-params-demo"></docs-lit-demo>
+
+## Base path
+
+By default, url-pattern keys accept any leading slashes and RegExp keys are not anchored. Set `basePath` to require a prefix: it is prepended to every url-pattern key, and to RegExp keys after `^`.
+
+<sonic-code language="html" noPreview>
+  <template>
+&lt;sonic-router basePath="/app"&gt;&lt;/sonic-router&gt;
+&lt;!-- "/fleet" now matches /app/fleet only --&gt;
+  </template>
+</sonic-code>
+
+## HTML templates
+
+Without Lit, declare `<template data-route>` children. A `title` attribute sets `document.title` and `data-fallback` marks the template shown when nothing matches. `dataProviderExpression` wraps the content in an element whose `dataProvider` is built from the route (`$1` or `:name`), as in [States](/core/components/functional/states).
+
+<sonic-code language="html" noPreview>
+  <template>
+&lt;sonic-router fallBackRoute="/departures"&gt;
+  &lt;template data-route="/departures" title="Departures"&gt;…&lt;/template&gt;
+  &lt;template data-route="/flights/:code" dataProviderExpression="flights/:code"&gt;
+    &lt;sonic-value key="status"&gt;&lt;/sonic-value&gt;
+  &lt;/template&gt;
+&lt;/sonic-router&gt;
+  </template>
+</sonic-code>
+
+`fallBackRoute` navigates to its URL when no route matches, even if a `data-fallback` template exists. A `routes.fallback` function prevents it.
+
+## Redirect on data
+
+**`sonic-redirect`** navigates to `to` once the value at `onData` (dot path) in its data provider is set and truthy. Here, checking in sends the passenger to the boarding page.
+
+<sonic-code language="html" noPreview>
+  <template>
+&lt;sonic-redirect to="#boarding" dataProvider="checkin" onData="checkedIn"&gt;&lt;/sonic-redirect&gt;
+&lt;div formDataProvider="checkin"&gt;
+  &lt;sonic-button radio name="checkedIn" value="yes"&gt;Check in&lt;/sonic-button&gt;
+&lt;/div&gt;
+  </template>
+</sonic-code>
+
+Objects do not trigger the redirect: point `onData` at a scalar such as `passenger.id`.
+
+## API reference
+
+`sonic-router`
+
+| Attribute | Values | Description |
+|-----------|--------|-------------|
+| `routes` | object (property) | Render functions keyed by RegExp or url-pattern, plus `fallback` |
+| `basePath` | string | Prefix required before every route. Default: any leading slashes for url-pattern, no anchor for RegExp |
+| `fallBackRoute` | string | URL to navigate to when no route matches and `routes.fallback` is not set |
+
+| Template attribute | Description |
+|--------------------|-------------|
+| `data-route` | RegExp or url-pattern matched against the location |
+| `data-fallback` | Template shown when no route matches |
+| `title` | Sets `document.title` when the template renders |
+| `dataProviderExpression` | Builds the `dataProvider` of a wrapper around the content from `$1`… or `:name` |
+
+| Slot | Description |
+|------|-------------|
+| *(default)* | `<template data-route>` children |
+
+`sonic-redirect`
+
+| Attribute | Values | Description |
+|-----------|--------|-------------|
+| `to` | string | Destination. A value starting with `#` only changes the hash |
+| `dataProvider` | string | Provider to watch. Inherited from the closest ancestor when omitted |
+| `onData` | string (required) | Dot path of the value that triggers the redirect when truthy |
+| `onAdded` | boolean | Redirects as soon as the element renders, without waiting for data |
+| `pushState` · `replaceState` | boolean | Navigates with `history.pushState` or `history.replaceState` instead of a full load. Ignored for `#` destinations |
+
+No slots.

package/docs/src/core/components/functional/sdui/component-catalog.gaps.json

@@ -0,0 +1,511 @@
+{
+  "version": 1,
+  "generatedAt": "2026-10-27T09:09:14.532Z",
+  "count": 66,
+  "items": [
+    {
+      "tag": "sonic-alert",
+      "module": "src/core/components/ui/alert/alert.ts",
+      "reasons": [
+        "5 prop(s) sans description (noIcon, size, dismissible, background, status)"
+      ]
+    },
+    {
+      "tag": "sonic-alert-messages",
+      "module": "src/core/components/ui/alert-messages/alert-messages.ts",
+      "reasons": [
+        "pas de description de classe",
+        "4 prop(s) sans description (size, background, noIcon, messages)"
+      ]
+    },
+    {
+      "tag": "sonic-badge",
+      "module": "src/core/components/ui/badge/badge.ts",
+      "reasons": [
+        "1 prop(s) sans description (ellipsis)"
+      ]
+    },
+    {
+      "tag": "sonic-button",
+      "module": "src/core/components/ui/button/button.ts",
+      "reasons": [
+        "15 prop(s) sans description (download, hasPrefix, hasSuffix, prefixes, suffixes, …)"
+      ]
+    },
+    {
+      "tag": "sonic-captcha",
+      "module": "src/core/components/ui/captcha/captcha.ts",
+      "reasons": [
+        "6 prop(s) sans description (key, action, zIndex, formPublisher, maxNumber, …)"
+      ]
+    },
+    {
+      "tag": "sonic-caption",
+      "module": "src/core/components/ui/table/table-caption.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-card",
+      "module": "src/core/components/ui/card/card.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-card-footer",
+      "module": "src/core/components/ui/card/card-footer.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-card-header",
+      "module": "src/core/components/ui/card/card-header.ts",
+      "reasons": [
+        "pas de description de classe",
+        "2 prop(s) sans description (label, description)"
+      ]
+    },
+    {
+      "tag": "sonic-card-header-description",
+      "module": "src/core/components/ui/card/card-header-descripton.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-card-main",
+      "module": "src/core/components/ui/card/card-main.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-checkbox",
+      "module": "src/core/components/ui/form/checkbox/checkbox.ts",
+      "reasons": [
+        "8 prop(s) sans description (touched, iconName, indeterminateIconName, showAsIndeterminate, hasDescription, …)"
+      ]
+    },
+    {
+      "tag": "sonic-date",
+      "module": "src/core/components/functional/date/date.ts",
+      "reasons": [
+        "pas de description de classe",
+        "24 prop(s) sans description (pageLanguage, wording_billet_periode_validite, designMode, time_zone, date, …)"
+      ]
+    },
+    {
+      "tag": "sonic-divider",
+      "module": "src/core/components/ui/divider/divider.ts",
+      "reasons": [
+        "pas de description de classe",
+        "8 prop(s) sans description (slotNodes, hasText, label, size, align, …)"
+      ]
+    },
+    {
+      "tag": "sonic-example",
+      "module": "src/core/components/functional/example/example.ts",
+      "reasons": [
+        "pas de description de classe",
+        "3 prop(s) sans description (limit, geoCommunesPayload, geoCommunesResult)"
+      ]
+    },
+    {
+      "tag": "sonic-fetch",
+      "module": "src/core/components/functional/fetch/fetch.ts",
+      "reasons": [
+        "1 prop(s) sans description (loader)"
+      ]
+    },
+    {
+      "tag": "sonic-fieldset",
+      "module": "src/core/components/ui/form/fieldset/fieldset.ts",
+      "reasons": [
+        "pas de description de classe",
+        "9 prop(s) sans description (disabled, form, label, description, iconName, …)"
+      ]
+    },
+    {
+      "tag": "sonic-form-actions",
+      "module": "src/core/components/ui/form/form-actions/form-actions.ts",
+      "reasons": [
+        "pas de description de classe",
+        "3 prop(s) sans description (direction, justify, alignItems)"
+      ]
+    },
+    {
+      "tag": "sonic-form-layout",
+      "module": "src/core/components/ui/form/form-layout/form-layout.ts",
+      "reasons": [
+        "pas de description de classe",
+        "2 prop(s) sans description (slottedElements, _oneFormElement)"
+      ]
+    },
+    {
+      "tag": "sonic-group",
+      "module": "src/core/components/ui/group/group.ts",
+      "reasons": [
+        "pas de description de classe",
+        "7 prop(s) sans description (alignItems, label, description, slotLabelNodes, slotDescriptionNodes, …)"
+      ]
+    },
+    {
+      "tag": "sonic-icon",
+      "module": "src/core/components/ui/icon/icon.ts",
+      "reasons": [
+        "3 prop(s) sans description (iconText, customIconLibraryPath, customIconDefaultPrefix)"
+      ]
+    },
+    {
+      "tag": "sonic-image",
+      "module": "src/core/components/ui/image/image.ts",
+      "reasons": [
+        "pas de description de classe",
+        "9 prop(s) sans description (rounded, src, alt, loading, transition, …)"
+      ]
+    },
+    {
+      "tag": "sonic-input",
+      "module": "src/core/components/ui/form/input/input.ts",
+      "reasons": [
+        "pas de description de classe",
+        "29 prop(s) sans description (inputmode, list, placeholder, pattern, min, …)"
+      ]
+    },
+    {
+      "tag": "sonic-input-autocomplete",
+      "module": "src/core/components/ui/form/input-autocomplete/input-autocomplete.ts",
+      "reasons": [
+        "15 prop(s) sans description (size, placeholder, filteredFields, readonly, dataProviderExpression, …)"
+      ]
+    },
+    {
+      "tag": "sonic-jsonata",
+      "module": "src/core/components/functional/jsonata/jsonata.ts",
+      "reasons": [
+        "2 prop(s) sans description (expression, outputSchema)"
+      ]
+    },
+    {
+      "tag": "sonic-legend",
+      "module": "src/core/components/ui/form/fieldset/legend.ts",
+      "reasons": [
+        "pas de description de classe",
+        "8 prop(s) sans description (forceAutoFill, _description, description, _label, label, …)"
+      ]
+    },
+    {
+      "tag": "sonic-legend-description",
+      "module": "src/core/components/ui/form/fieldset/legend-description.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-link",
+      "module": "src/core/components/ui/link/link.ts",
+      "reasons": [
+        "pas de description de classe",
+        "4 prop(s) sans description (href, location, ariaLabel, target)",
+        "1 prop(s) sans type (target)"
+      ]
+    },
+    {
+      "tag": "sonic-list",
+      "module": "src/core/components/functional/list/list.ts",
+      "reasons": [
+        "pas de description de classe",
+        "9 prop(s) sans description (itemPropertyMap, loader, limit, offset, _items, …)",
+        "1 prop(s) sans type (limit)"
+      ]
+    },
+    {
+      "tag": "sonic-loader",
+      "module": "src/core/components/ui/loader/loader.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-menu",
+      "module": "src/core/components/ui/menu/menu.ts",
+      "reasons": [
+        "pas de description de classe",
+        "14 prop(s) sans description (direction, align, shadow, moreShape, scrollable, …)"
+      ]
+    },
+    {
+      "tag": "sonic-mix",
+      "module": "src/core/components/functional/mix/mix.ts",
+      "reasons": [
+        "pas de description de classe",
+        "2 prop(s) sans description (composition, listeners)",
+        "1 prop(s) sans type (composition)"
+      ]
+    },
+    {
+      "tag": "sonic-modal",
+      "module": "src/core/components/ui/modal/modal.ts",
+      "reasons": [
+        "pas de description de classe",
+        "21 prop(s) sans description (forceAction, noCloseButton, removeOnHide, removeHashOnHide, align, …)"
+      ]
+    },
+    {
+      "tag": "sonic-modal-actions",
+      "module": "src/core/components/ui/modal/modal-actions.ts",
+      "reasons": [
+        "pas de description de classe",
+        "1 prop(s) sans description (buttons)"
+      ]
+    },
+    {
+      "tag": "sonic-modal-close",
+      "module": "src/core/components/ui/modal/modal-close.ts",
+      "reasons": [
+        "pas de description de classe",
+        "3 prop(s) sans description (translation, reset, type)"
+      ]
+    },
+    {
+      "tag": "sonic-modal-content",
+      "module": "src/core/components/ui/modal/modal-content.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-modal-subtitle",
+      "module": "src/core/components/ui/modal/modal-subtitle.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-modal-title",
+      "module": "src/core/components/ui/modal/modal-title.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-password-helper",
+      "module": "src/core/components/ui/form/input/password-helper.ts",
+      "reasons": [
+        "pas de description de classe",
+        "15 prop(s) sans description (name, minChars, hasNoChar, hasEnoughChars, hasMinuscule, …)"
+      ]
+    },
+    {
+      "tag": "sonic-pop",
+      "module": "src/core/components/ui/pop/pop.ts",
+      "reasons": [
+        "pas de description de classe",
+        "10 prop(s) sans description (open, popBtn, popContent, noToggle, inline, …)"
+      ]
+    },
+    {
+      "tag": "sonic-progress",
+      "module": "src/core/components/ui/progress/progress.ts",
+      "reasons": [
+        "pas de description de classe",
+        "4 prop(s) sans description (value, max, type, size)"
+      ]
+    },
+    {
+      "tag": "sonic-queue",
+      "module": "src/core/components/functional/queue/queue.ts",
+      "reasons": [
+        "27 prop(s) sans description (templates, items, noItems, skeleton, lastRequestTime, …)"
+      ]
+    },
+    {
+      "tag": "sonic-redirect",
+      "module": "src/core/components/functional/router/redirect.ts",
+      "reasons": [
+        "1 prop(s) sans description (udpateCallBack)"
+      ]
+    },
+    {
+      "tag": "sonic-router",
+      "module": "src/core/components/functional/router/router.ts",
+      "reasons": [
+        "pas de description de classe",
+        "5 prop(s) sans description (templateValueAttribute, fallBackRoute, routes, basePath, location)",
+        "1 prop(s) sans type (location)"
+      ]
+    },
+    {
+      "tag": "sonic-same-value-helper",
+      "module": "src/core/components/ui/form/input/same-value-helper.ts",
+      "reasons": [
+        "pas de description de classe",
+        "7 prop(s) sans description (name, sameValueAs, descriptionWhenEqual, descriptionWhenNotEqual, areEqual, …)"
+      ]
+    },
+    {
+      "tag": "sonic-scope",
+      "module": "src/core/components/functional/sonic-scope/sonic-scope.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-sdui",
+      "module": "src/core/components/functional/sdui/sdui.ts",
+      "reasons": [
+        "2 prop(s) sans description (sduiKey, messagesKey)"
+      ]
+    },
+    {
+      "tag": "sonic-select",
+      "module": "src/core/components/ui/form/select/select.ts",
+      "reasons": [
+        "23 prop(s) sans description (valueKey, wordingKey, multiple, size, selectSize, …)",
+        "1 prop(s) sans type (options)"
+      ]
+    },
+    {
+      "tag": "sonic-states",
+      "module": "src/core/components/functional/states/states.ts",
+      "reasons": [
+        "pas de description de classe",
+        "5 prop(s) sans description (state, inverted, states, statePath, statePublisher)"
+      ]
+    },
+    {
+      "tag": "sonic-submit",
+      "module": "src/core/components/functional/submit/submit.ts",
+      "reasons": [
+        "7 prop(s) sans description (submitResultKey, disabled, endPoint, name, value, …)"
+      ]
+    },
+    {
+      "tag": "sonic-subscriber",
+      "module": "src/core/components/functional/subscriber/subscriber.ts",
+      "reasons": [
+        "1 prop(s) sans description (noAutofill)"
+      ]
+    },
+    {
+      "tag": "sonic-t",
+      "module": "src/core/components/functional/translation/translation.ts",
+      "reasons": [
+        "pas de description de classe",
+        "2 prop(s) sans description (key, unsafeHTML)"
+      ]
+    },
+    {
+      "tag": "sonic-table",
+      "module": "src/core/components/ui/table/table.ts",
+      "reasons": [
+        "pas de description de classe",
+        "5 prop(s) sans description (size, bordered, rounded, noCustomScroll, maxHeight)"
+      ]
+    },
+    {
+      "tag": "sonic-tbody",
+      "module": "src/core/components/ui/table/table-tbody.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-td",
+      "module": "src/core/components/ui/table/table-td.ts",
+      "reasons": [
+        "pas de description de classe",
+        "7 prop(s) sans description (colSpan, rowSpan, align, vAlign, minWidth, …)"
+      ]
+    },
+    {
+      "tag": "sonic-textarea",
+      "module": "src/core/components/ui/form/textarea/textarea.ts",
+      "reasons": [
+        "pas de description de classe",
+        "13 prop(s) sans description (size, rows, cols, maxlength, minlength, …)"
+      ]
+    },
+    {
+      "tag": "sonic-tfoot",
+      "module": "src/core/components/ui/table/table-tfoot.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-th",
+      "module": "src/core/components/ui/table/table-th.ts",
+      "reasons": [
+        "pas de description de classe",
+        "6 prop(s) sans description (colSpan, rowSpan, align, minWidth, maxWidth, …)"
+      ]
+    },
+    {
+      "tag": "sonic-thead",
+      "module": "src/core/components/ui/table/table-thead.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    },
+    {
+      "tag": "sonic-theme",
+      "module": "src/core/components/ui/theme/theme.ts",
+      "reasons": [
+        "pas de description de classe",
+        "3 prop(s) sans description (theme, color, font)"
+      ]
+    },
+    {
+      "tag": "sonic-toast",
+      "module": "src/core/components/ui/toast/toast.ts",
+      "reasons": [
+        "pas de description de classe",
+        "1 prop(s) sans description (toasts)"
+      ]
+    },
+    {
+      "tag": "sonic-toast-item",
+      "module": "src/core/components/ui/toast/toast-item.ts",
+      "reasons": [
+        "pas de description de classe",
+        "11 prop(s) sans description (label, id, text, status, ghost, …)"
+      ]
+    },
+    {
+      "tag": "sonic-toast-message-subscriber",
+      "module": "src/core/components/ui/toast/message-subscriber.ts",
+      "reasons": [
+        "pas de description de classe",
+        "2 prop(s) sans description (_messages, messages)",
+        "1 prop(s) sans type (messages)"
+      ]
+    },
+    {
+      "tag": "sonic-tooltip",
+      "module": "src/core/components/ui/tooltip/tooltip.ts",
+      "reasons": [
+        "pas de description de classe",
+        "4 prop(s) sans description (label, placement, disabled, focusable)"
+      ]
+    },
+    {
+      "tag": "sonic-tr",
+      "module": "src/core/components/ui/table/table-tr.ts",
+      "reasons": [
+        "pas de description de classe",
+        "4 prop(s) sans description (_metadata_, even, odd, last)"
+      ]
+    },
+    {
+      "tag": "sonic-value",
+      "module": "src/core/components/functional/value/value.ts",
+      "reasons": [
+        "pas de description de classe"
+      ]
+    }
+  ]
+}