@supersoniks/concorde 5.1.1 → 5.1.3-immutable.1

package/docs/llms.txt

@@ -0,0 +1,98 @@
+# Concorde
+
+> Web components framework (Lit, DataProvider, decorators).
+
+Documentation for AI indexers lives under `/crawl/` as **HTML** (`.html`), not Markdown.
+Example: https://concorde.supersoniks.org/crawl/docs/_decorators/post.html
+Do not fetch `/crawl/**/*.md` (does not exist) nor `/src/docs/**/*.md` (SPA source only).
+
+Full text: https://concorde.supersoniks.org/llms-full.txt
+
+## Topic hubs (start here for RAG)
+
+- [Concorde decorators reference](https://concorde.supersoniks.org/crawl/hubs/decorators.html) (hubs/decorators, 12 pages)
+- [Fetching remote data in Concorde](https://concorde.supersoniks.org/crawl/hubs/remote-data.html) (hubs/remote-data, 11 pages)
+- [Concorde form components](https://concorde.supersoniks.org/crawl/hubs/form-components.html) (hubs/form-components, 10 pages)
+
+## Docs
+
+- [Date](https://concorde.supersoniks.org/crawl/core/components/functional/date/date.html) (core/components/functional/date/date): Nothing is displayed.
+- [Fetch](https://concorde.supersoniks.org/crawl/core/components/functional/fetch/fetch.html) (core/components/functional/fetch/fetch): > New apps: prefer @get for a typed GET on a component, or List / Queue with fetch for collections. Use Local API demos (serviceURL="/docs-mock-api") to try examples offline.
+- [if](https://concorde.supersoniks.org/crawl/core/components/functional/if/if.html) (core/components/functional/if/if): The sonic-if component shows its slot when .condition is true. In Lit, bind .condition from store-driven state (@subscribe on a formDataProvider field) — live preview and TypeScript source are the sam
+- [Jsonata](https://concorde.supersoniks.org/crawl/core/components/functional/jsonata/jsonata.html) (core/components/functional/jsonata/jsonata): sonic-jsonata : 1 input → expression → 1 output (readonly).
+- [List](https://concorde.supersoniks.org/crawl/core/components/functional/list/list.html) (core/components/functional/list/list): > Try offline: serviceURL="/docs-mock-api" and dataProvider="api/users" with key="data" — see Local API demos. Recommended patterns: Data flow.
+- [Mix](https://concorde.supersoniks.org/crawl/core/components/functional/mix/mix.html) (core/components/functional/mix/mix): Mix allows you to mix several subsets of dataProvider in a new key/value structure which is itself associated with a new dataProvider. The data update is then bidirectional.
+- [Queue](https://concorde.supersoniks.org/crawl/core/components/functional/queue/queue.html) (core/components/functional/queue/queue): > Try offline: serviceURL="/docs-mock-api" — see Local API demos. Row rendering: Data flow (.items property binding).
+- [Router](https://concorde.supersoniks.org/crawl/core/components/functional/router/router.html) (core/components/functional/router/router): sonic-router watches document.location (pathname + hash) and renders the matching view.
+- [SDUI — points d’extension publics](https://concorde.supersoniks.org/crawl/core/components/functional/sdui/sdui-extension-points.html) (core/components/functional/sdui/sdui-extension-points): Aide-mémoire pour les dépôts externes (adaptateurs, shells).
+- [SDUI](https://concorde.supersoniks.org/crawl/core/components/functional/sdui/sdui.html) (core/components/functional/sdui/sdui): SDUI stands for Server Driven User Interfaces.
+- [States](https://concorde.supersoniks.org/crawl/core/components/functional/states/states.html) (core/components/functional/states/states): * It loops over its child templates and tests if the regexp contained in the *data-value* attribute matches the value of the property
+- [Submit](https://concorde.supersoniks.org/crawl/core/components/functional/submit/submit.html) (core/components/functional/submit/submit): > Live demos: <docs-lit-demo> + src/docs/example/docs-submit-demos.ts. Use Local API demos (serviceURL="/docs-mock-api").
+- [Subscriber](https://concorde.supersoniks.org/crawl/core/components/functional/subscriber/subscriber.html) (core/components/functional/subscriber/subscriber): La mixin Subscriber permet lier un composant à un publisher.
+- [Value](https://concorde.supersoniks.org/crawl/core/components/functional/value/value.html) (core/components/functional/value/value): Simply shows a value from a data provider.
+- [Alert messages](https://concorde.supersoniks.org/crawl/core/components/ui/alert-messages/alert-messages.html) (core/components/ui/alert-messages/alert-messages): 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 ty
+- [Alert](https://concorde.supersoniks.org/crawl/core/components/ui/alert/alert.html) (core/components/ui/alert/alert): 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 messa
+- [Badge](https://concorde.supersoniks.org/crawl/core/components/ui/badge/badge.html) (core/components/ui/badge/badge): 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
+- [Button](https://concorde.supersoniks.org/crawl/core/components/ui/button/button.html) (core/components/ui/button/button): The length of the button depends on the size of its content
+- [Captcha](https://concorde.supersoniks.org/crawl/core/components/ui/captcha/captcha.html) (core/components/ui/captcha/captcha): 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 vali
+- [Card](https://concorde.supersoniks.org/crawl/core/components/ui/card/card.html) (core/components/ui/card/card): 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 marku
+- [Divider](https://concorde.supersoniks.org/crawl/core/components/ui/divider/divider.html) (core/components/ui/divider/divider): 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 
+- [Checkbox](https://concorde.supersoniks.org/crawl/core/components/ui/form/checkbox/checkbox.html) (core/components/ui/form/checkbox/checkbox): >Already checked checkbox
+- [Fieldset](https://concorde.supersoniks.org/crawl/core/components/ui/form/fieldset/fieldset.html) (core/components/ui/form/fieldset/fieldset): 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
+- [Form actions](https://concorde.supersoniks.org/crawl/core/components/ui/form/form-actions/form-actions.html) (core/components/ui/form/form-actions/form-actions): 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 en
+- [Form layout](https://concorde.supersoniks.org/crawl/core/components/ui/form/form-layout/form-layout.html) (core/components/ui/form/form-layout/form-layout): 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 ho
+- [Input-autocomplete](https://concorde.supersoniks.org/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html) (core/components/ui/form/input-autocomplete/input-autocomplete): Champ formulaire + suggestions via queue. Valeur via formDataProvider + name ; la recherche filtre la queue (store interne).
+- [Input](https://concorde.supersoniks.org/crawl/core/components/ui/form/input/input.html) (core/components/ui/form/input/input): Native attributes list
+- [Radio](https://concorde.supersoniks.org/crawl/core/components/ui/form/radio/radio.html) (core/components/ui/form/radio/radio): >Already checked radio
+- [Select](https://concorde.supersoniks.org/crawl/core/components/ui/form/select/select.html) (core/components/ui/form/select/select): {"value":"dark", "wording":"dark (set by \"attribute\")", "selected" : "true"}, {"value":"auto", "wording":"auto"}
+- [Switch](https://concorde.supersoniks.org/crawl/core/components/ui/form/switch/switch.html) (core/components/ui/form/switch/switch): >Already checked switch
+- [Textarea](https://concorde.supersoniks.org/crawl/core/components/ui/form/textarea/textarea.html) (core/components/ui/form/textarea/textarea): Native attributes list
+- [Group](https://concorde.supersoniks.org/crawl/core/components/ui/group/group.html) (core/components/ui/group/group): 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 fol
+- [Icon](https://concorde.supersoniks.org/crawl/core/components/ui/icon/icon.html) (core/components/ui/icon/icon): 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 def
+- [Image](https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html) (core/components/ui/image/image): 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
+- [Link](https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html) (core/components/ui/link/link): 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 
+- [Loader](https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html) (core/components/ui/loader/loader): 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 sho
+- [Menu](https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html) (core/components/ui/menu/menu): 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
+- [Modal](https://concorde.supersoniks.org/crawl/core/components/ui/modal/modal.html) (core/components/ui/modal/modal): sonic-modal presents focused content in a <dialog> overlay with backdrop, enter/exit animation, and a built-in close control. Compose sonic-modal-title / sonic-modal-subtitle / sonic-modal-content / s
+- [Pop](https://concorde.supersoniks.org/crawl/core/components/ui/pop/pop.html) (core/components/ui/pop/pop): sonic-pop anchors floating panels to a trigger: put the control in the default slot and the panel in slot="content" (menus, forms, custom markup). Click toggles open/closed unless manual is set; defau
+- [Progress](https://concorde.supersoniks.org/crawl/core/components/ui/progress/progress.html) (core/components/ui/progress/progress): 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 remaini
+- [Table](https://concorde.supersoniks.org/crawl/core/components/ui/table/table.html) (core/components/ui/table/table): 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
+- [Theme](https://concorde.supersoniks.org/crawl/core/components/ui/theme/theme.html) (core/components/ui/theme/theme): 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 ap
+- [Toast](https://concorde.supersoniks.org/crawl/core/components/ui/toast/toast.html) (core/components/ui/toast/toast): 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 automaticall
+- [Tooltip](https://concorde.supersoniks.org/crawl/core/components/ui/tooltip/tooltip.html) (core/components/ui/tooltip/tooltip): 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). A
+- [Data flow](https://concorde.supersoniks.org/crawl/docs/_core-concept/dataFlow.html) (docs/_core-concept/dataFlow): Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, data lives in a DataProvider store (legacy Publisher API: Legacy: Sharing data).
+- [lit + tailwind + vite](https://concorde.supersoniks.org/crawl/docs/_core-concept/overview.html) (docs/_core-concept/overview): Some notes for an overview of Concorde's functioning
+- [Legacy: Subscriber mixin](https://concorde.supersoniks.org/crawl/docs/_core-concept/subscriber.html) (docs/_core-concept/subscriber): > New app components: My first component and Data flow — extend LitElement with decorators (@subscribe, @ancestorAttribute, …). This mixin remains in core components (sonic-list, sonic-fetch, …) and l
+- [@ancestorAttribute](https://concorde.supersoniks.org/crawl/docs/_decorators/ancestor-attribute.html) (docs/_decorators/ancestor-attribute): The @ancestorAttribute decorator automatically injects the value of an ancestor's attribute into a class property at the time of connectedCallback.
+- [@autoSubscribe](https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html) (docs/_decorators/auto-subscribe): > Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases.
+- [@bind](https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html) (docs/_decorators/bind): Binds a class property to a path in a publisher. The property updates when publisher data changes.
+- [@get](https://concorde.supersoniks.org/crawl/docs/_decorators/get.html) (docs/_decorators/get): @get loads data and stores the result in an optional ApiResult<T> property.
+- [@handle](https://concorde.supersoniks.org/crawl/docs/_decorators/handle.html) (docs/_decorators/handle): Typed callback on one or more DataProviderKey<T> paths: invokes the decorated method when a publisher assigns a value (calculations, side effects, updating other @state properties, etc.).
+- [@onAssign](https://concorde.supersoniks.org/crawl/docs/_decorators/on-assign.html) (docs/_decorators/on-assign): > New apps: use @handle with DataProviderKey (Data flow). @onAssign uses untyped string paths; it remains documented for existing codebases — see Migrating to @handle below.
+- [@patch](https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html) (docs/_decorators/patch): @patch applies a partial update with the body from a publisher. It uses the
+- [@post](https://concorde.supersoniks.org/crawl/docs/_decorators/post.html) (docs/_decorators/post): @post sends the contents of a publisher and stores the response in an
+- [@publish](https://concorde.supersoniks.org/crawl/docs/_decorators/publish.html) (docs/_decorators/publish): Write-only binding: assigning to the property publishes to the DataProviderKey path. No read subscription (inverse of @subscribe).
+- [@put](https://concorde.supersoniks.org/crawl/docs/_decorators/put.html) (docs/_decorators/put): @put replaces a resource with the body from a publisher. It uses exactly the
+- [@subscribe](https://concorde.supersoniks.org/crawl/docs/_decorators/subscribe.html) (docs/_decorators/subscribe): Keeps a Lit property in sync with a read-only slice of the DataProvider store. You pass a DataProviderKey; when that path changes, the property updates and the component re-renders.
+- [@awaitConnectedAncestors and @dispatchConnectedEvent](https://concorde.supersoniks.org/crawl/docs/_decorators/wait-for-ancestors.html) (docs/_decorators/wait-for-ancestors): The @awaitConnectedAncestors and @dispatchConnectedEvent decorators delay a web component's initialization until its matching ancestors have executed their connectedCallback. This is when contextual e
+- [sub()](https://concorde.supersoniks.org/crawl/docs/_directives/sub.html) (docs/_directives/sub): Read-only Lit directive: displays the current DataProvider value and updates whenever it is assigned.
+- [AI agents (skills & AGENTS.md)](https://concorde.supersoniks.org/crawl/docs/_getting-started/ai-agents.html) (docs/_getting-started/ai-agents): Concorde ships skills, rules, and a root AGENTS.md so Cursor, JetBrains AI Assistant, and other coding agents follow framework patterns (DataProvider, decorators, short imports, scope, theme, migratio
+- [Manual installation (Vite)](https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-manual-install.html) (docs/_getting-started/concorde-manual-install): > Legacy — for brownfield apps or custom stacks. New projects should use the starter.
+- [Installation](https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html) (docs/_getting-started/concorde-outside): The following command creates a new Vite project in TypeScript mode with Tailwind and an example component to get started.
+- [Creating components](https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html) (docs/_getting-started/create-a-component): > New app components: start with My first component and Data flow. The Subscriber mixin below is legacy.
+- [My first component](https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html) (docs/_getting-started/my-first-component): Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync.
+- [Legacy: My first subscriber component](https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html) (docs/_getting-started/my-first-subscriber): > New projects: use My first component (@ancestorAttribute, @subscribe + DataProviderKey, .items on lists) and Data flow. This page documents the Subscriber mixin used by older apps and core component
+- [Legacy: Sharing data](https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html) (docs/_getting-started/pubsub): > New apps: Data flow (get / set / DataProviderKey, decorators). This page documents the historical Publisher proxy API (PublisherManager, publisher.set, onAssign, …).
+- [Introduction](https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html) (docs/_getting-started/start): Based on lit.dev, Concorde is a collection of web components for shared apps and websites.
+- [Customization](https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html) (docs/_getting-started/theming): Concorde components ship with default styles (fallback values in each component and in <sonic-theme>).
+- [API configuration](https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html) (docs/_misc/api-configuration): APIConfiguration is the object built by HTML.getApiConfiguration from ancestor attributes on the DOM (or from a typed publisher — see @get / @post configuration key). It is passed to API by fetchers, 
+- [DataProviderKey](https://concorde.supersoniks.org/crawl/docs/_misc/dataProviderKey.html) (docs/_misc/dataProviderKey): The DataProviderKey<T> utility provides type-safe navigation through composite data structures. Each property or index access extends the path, and the final key can be retrieved via toString() or the
+- [Local API demos (offline)](https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html) (docs/_misc/docs-mock-api): The Concorde doc site does not call fragile third-party APIs during yarn dev. A Service Worker and the Vite dev middleware serve /docs-mock-api/* on the same origin.
+- [Dynamic path placeholders](https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html) (docs/_misc/dynamic-path): Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:
+- [Endpoint](https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html) (docs/_misc/endpoint): Endpoint<T, U> describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.
+- [FormElement without Subscriber (REDMINE-79569)](https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html) (docs/_misc/formelement-subscriber-removal): Form fields (sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete) no longer inherit the Subscriber mixin.
+- [HTML integration (no Lit)](https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html) (docs/_misc/html-integration): Some hosts (legacy PHP pages, static HTML) embed Concorde components without a Lit build step. They can use HTML attributes such as data-bind, dataProvider, and formDataProvider on tags directly in th
+
+## Optional
+
+- [Full index](https://concorde.supersoniks.org/crawl/index.html)

package/docs/sitemap.xml

@@ -0,0 +1,243 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/index.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/hubs/decorators.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/hubs/remote-data.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/hubs/form-components.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/date/date.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/fetch/fetch.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/if/if.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/jsonata/jsonata.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/list/list.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/mix/mix.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/queue/queue.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/router/router.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/sdui/sdui-extension-points.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/sdui/sdui.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/states/states.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/submit/submit.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/subscriber/subscriber.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/value/value.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/alert-messages/alert-messages.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/alert/alert.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/badge/badge.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/button/button.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/captcha/captcha.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/card/card.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/divider/divider.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/checkbox/checkbox.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/fieldset/fieldset.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/form-actions/form-actions.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/form-layout/form-layout.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/input/input.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/radio/radio.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/select/select.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/switch/switch.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/textarea/textarea.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/group/group.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/icon/icon.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/modal/modal.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/pop/pop.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/progress/progress.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/table/table.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/theme/theme.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/toast/toast.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/tooltip/tooltip.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_core-concept/dataFlow.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_core-concept/overview.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_core-concept/subscriber.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/ancestor-attribute.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/get.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/handle.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/on-assign.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/post.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/publish.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/put.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/subscribe.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/wait-for-ancestors.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_directives/sub.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/ai-agents.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-manual-install.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/dataProviderKey.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html</loc>
+  </url>
+</urlset>

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

@@ -0,0 +1,290 @@
+# Date
+
+## No attribute
+
+**Nothing** is displayed.
+
+<sonic-code>
+  <template>
+    <sonic-date></sonic-date>
+  </template>
+</sonic-code>
+
+## Now
+
+Displays the **current date**.
+
+<sonic-code>
+  <template>
+    <sonic-date now></sonic-date>
+  </template>
+</sonic-code>
+
+
+## Date  
+
+Displays a date from a **timestamp**.
+
+<sonic-code>
+  <template>
+    <sonic-date date= "1640265629"></sonic-date>
+  </template>
+</sonic-code>
+
+## Date_string  
+
+Displays a date from a **string**.
+
+<sonic-code>
+  <template>
+    <sonic-date date_string="July 20, 69 20:17:40 GMT+00:00"></sonic-date>
+  </template>
+</sonic-code>
+
+## Start_date / end_date  
+
+Displays a period of time **from start_date to end_date**.  
+When by itself **start_date** will act as **date**  
+if a **start_date is not specified** it will be set by the **current date**.  
+if the **end_date is anterior** to start date date it will be **used as the start_date**. 
+
+<sonic-code>
+  <template>
+    <!-- from start_date to end_date -->
+    <sonic-date start_date="1640265629" end_date= "1640365629"></sonic-date>
+    <br>
+    <!-- start_date is not specified -->
+    <sonic-date end_date= "2640365629"></sonic-date>
+    <br>
+    <!-- end_date is anterior -->
+    <sonic-date end_date= "640365629"></sonic-date>
+  </template>
+</sonic-code>
+
+
+## Start_date_string / end_date_string
+
+<sonic-code>
+  <template>
+    <!-- from start_date to end_date -->
+    <sonic-date date_string="July 20, 90 20:17:40 GMT+00:00" end_date_string= "June 20, 94 20:17:40 GMT+00:00"></sonic-date>
+    <br>
+    <!-- start_date is not specified -->
+    <sonic-date end_date_string= "May 20, 34 20:17:40 GMT+00:00"></sonic-date>
+    <br>
+    <!-- end_date is anterior -->
+    <sonic-date end_date_string= "April 20, 06 20:17:40 GMT+00:00"></sonic-date>
+  </template>
+</sonic-code>
+
+## Wording_billet_periode_validite
+
+<sonic-code>
+  <template>
+    <sonic-date wording_billet_periode_validite= "À partir du %s jusqu'au %s" start_date="1640265629" end_date= "1640365629"></sonic-date>
+  </template>
+</sonic-code>
+
+
+## Weekday
+
+<sonic-code>
+  <template>
+    <b>narrow : </b>
+    <sonic-date weekday="narrow" now></sonic-date>
+    <br>
+    <b>short (default) : </b>
+    <sonic-date weekday="short" now></sonic-date>
+    <br>
+    <b>long : </b>
+    <sonic-date weekday="long" now></sonic-date>
+    <br>
+    <b>hidden : </b>
+    <sonic-date weekday="hidden" now></sonic-date>
+  </template>
+</sonic-code>
+
+## Day
+
+<sonic-code>
+  <template>
+    <b>numeric : </b>
+    <sonic-date day="numeric" date_string="July 01, 69"></sonic-date>
+    <br>
+    <b>2-digit (default) : </b>
+    <sonic-date day="2-digit" date_string="July 01, 69"></sonic-date>
+  </template>
+</sonic-code>
+
+## Month
+
+<sonic-code>
+  <template>
+    <b>numeric : </b>
+    <sonic-date month="numeric" now></sonic-date>
+    <br>
+    <b>2-digit : </b>
+    <sonic-date month="2-digit" now></sonic-date>
+    <br>
+    <b>narrow : </b>
+    <sonic-date month="narrow" now></sonic-date>
+    <br>
+    <b>short (default) : </b>
+    <sonic-date month="short" now></sonic-date>
+    <br>
+    <b>long : </b>
+    <sonic-date month="long" now></sonic-date>
+  </template>
+</sonic-code>
+
+## Year
+
+<sonic-code>
+  <template>
+    <b>numeric (default) : </b>
+    <sonic-date year="numeric" now></sonic-date>
+    <br>
+    <b>2-digit : </b>
+    <sonic-date year="2-digit" now></sonic-date>
+  </template>
+</sonic-code>
+
+## Hour
+
+<sonic-code>
+  <template>
+    <b>numeric : </b>
+    <sonic-date hour="numeric" date_string= "June 20, 04 02:06:02 GMT+00:00"></sonic-date>
+    <br>
+    <b>2-digit (default) : </b>
+    <sonic-date hour="2-digit" date_string= "June 20, 04 02:06:02 GMT+00:00"></sonic-date>
+    <br>
+    <b>hidden : </b>
+    <sonic-date hour="hidden" date_string= "June 20, 04 02:06:02 GMT+00:00"></sonic-date>
+  </template>
+</sonic-code>
+
+## Minute
+
+<sonic-code>
+  <template>
+    <b>numeric : </b>
+    <sonic-date minute="numeric" date_string= "June 20, 04 02:06:02 GMT+00:00"></sonic-date>
+    <br>
+    <b>2-digit (default) : </b>
+    <sonic-date minute="2-digit" date_string= "June 20, 04 02:06:02 GMT+00:00"></sonic-date>
+    <br>
+    <b>hidden : </b>
+    <sonic-date minute="hidden" date_string= "June 20, 04 02:06:02 GMT+00:00"></sonic-date>
+  </template>
+</sonic-code>
+
+## Language  
+
+<sonic-button href="https://www.w3schools.com/tags/ref_language_codes.asp" target="_blank" type="info" size="sm">ISO 639-1 Language Codes</sonic-button>
+
+<sonic-code>
+  <template>
+    <b>fr : </b>
+    <sonic-date language="fr" now></sonic-date>
+    <br>
+    <b>en : </b>
+    <sonic-date language="en" now></sonic-date>
+    <br>
+    <b>zh : </b>
+    <sonic-date language="zh" now></sonic-date>
+    <br>
+    <b>ja : </b>
+    <sonic-date language="ja" now></sonic-date>
+  </template>
+</sonic-code>
+
+## Time_zone
+
+For the list of supported timeZones, run <b class="text-info">Intl.supportedValuesOf('timeZone')</b> in the console
+
+<sonic-code>
+  <template>
+    <b>Europe/London : </b>
+    <sonic-date time_zone="Europe/London" now></sonic-date>
+    <br>
+    <b>Europe/Paris : </b>
+    <sonic-date time_zone="Europe/Paris" now></sonic-date>
+    <br>
+    <b>America/Tijuana : </b>
+    <sonic-date time_zone="America/Tijuana" now></sonic-date>
+  </template>
+</sonic-code>
+
+## Era  
+
+<sonic-code>
+  <template>
+    <b>narrow : </b>
+    <sonic-date era="narrow" now></sonic-date>
+    <br>
+    <b>short : </b>
+    <sonic-date era="short" now></sonic-date>
+    <br>
+    <b>long : </b>
+    <sonic-date era="long" now></sonic-date>
+  </template>
+</sonic-code>
+
+## .renderIf  
+
+<sonic-alert status="error" background>Deprecated</sonic-alert>
+
+<sonic-code>
+  <template>
+    <b>True statement : </b>
+    <sonic-date data-bind ::render-if="|10>2" now></sonic-date>
+    <br>
+    <b>False statement : </b>
+    <sonic-date data-bind ::render-if="|10<2" now></sonic-date>
+  </template>
+</sonic-code>
+
+## DesignMode  
+
+<sonic-code>
+  <template>
+    <div class="relative max-w-lg rounded-lg overflow-hidden">
+      <div class="absolute top-0 h-1/2 w-full bg-gradient-to-b from-[rgba(0,0,10,.2)] z-10 "></div>
+      <sonic-date
+        designMode
+        noShadowDom
+        start_date= "1640265629"
+        end_date= "1640365629"
+        language= "fr"
+        wording_billet_periode_validite= "Du %s au %s"
+        year= "numeric"
+        month= "short"
+        weekday= "short"
+        hour= "2-digit"
+        minute= "2-digit"
+        class="py-4 drop-shadow-lg text-contrast-content p-4 inline-block text-center absolute left-0 z-20 text-sm"
+      >
+        <template data-value="weekday">
+          <span class="hidden"></span>
+        </template>
+        <template data-value="day">
+          <span class="text-4xl block uppercase leading-none font-bold"></span>
+        </template>
+        <template data-value="month">
+          <span class="text-xl block uppercase leading-tight font-bold"></span>
+        </template>
+        <template data-value="year">
+          <span class="text-lg  mb-1 font-bold  block uppercase leading-tight "></span>
+        </template>
+        <template data-value="to">
+          <span class="font-medium block my-1 text-3xl leading-none">↓</span>
+        </template>
+      </sonic-date>
+      <sonic-image 
+      ratio="1/1" src="https://picsum.photos/id/237/700/700">
+      </sonic-image>
+    </div>
+  </template>
+</sonic-code>
+