@supersoniks/concorde 5.1.0 → 5.1.2

package/src/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./components.ts","./concorde-loaded.ts","./css.d.ts","./dataprovider.ts","./decorators.ts","./directives.ts","./index.ts","./mixins.ts","./utils.ts","./core/core.ts","./core/_types/endpoint.ts","./core/_types/key.ts","./core/_types/types.ts","./core/components/functional/functional.ts","./core/components/functional/date/date.ts","./core/components/functional/example/example.ts","./core/components/functional/fetch/fetch.ts","./core/components/functional/if/if.test.ts","./core/components/functional/if/if.ts","./core/components/functional/jsonata/jsonata.spec.ts","./core/components/functional/jsonata/jsonata.ts","./core/components/functional/list/list.demo.ts","./core/components/functional/list/list.spec.ts","./core/components/functional/list/list.ts","./core/components/functional/mix/mix.ts","./core/components/functional/queue/queue.demo.ts","./core/components/functional/queue/queue.ts","./core/components/functional/router/redirect.ts","./core/components/functional/router/router.demo.ts","./core/components/functional/router/router.spec.ts","./core/components/functional/router/router.ts","./core/components/functional/sdui/SDUIDescriptorTransformer.ts","./core/components/functional/sdui/component-catalog.spec.ts","./core/components/functional/sdui/sdui-action.spec.ts","./core/components/functional/sdui/sdui-dom-snapshot.ts","./core/components/functional/sdui/sdui-incremental.spec.ts","./core/components/functional/sdui/sdui-partial.spec.ts","./core/components/functional/sdui/sdui-partial.ts","./core/components/functional/sdui/sdui-safe.spec.ts","./core/components/functional/sdui/sdui-safe.ts","./core/components/functional/sdui/sdui-utils.ts","./core/components/functional/sdui/sdui.regression.spec.ts","./core/components/functional/sdui/sdui.ts","./core/components/functional/sdui/types.ts","./core/components/functional/sdui/__fixtures__/descriptors.ts","./core/components/functional/sonic-scope/sonic-scope.ts","./core/components/functional/states/states.demo.ts","./core/components/functional/states/states.spec.ts","./core/components/functional/states/states.ts","./core/components/functional/submit/submit.ts","./core/components/functional/subscriber/subscriber.ts","./core/components/functional/translation/translation.ts","./core/components/functional/value/value.ts","./core/components/ui/ui.ts","./core/components/ui/_css/align.ts","./core/components/ui/_css/rounded.ts","./core/components/ui/_css/scroll.ts","./core/components/ui/_css/shadow.ts","./core/components/ui/_css/size.ts","./core/components/ui/_css/type.ts","./core/components/ui/_i18n/ui-aria-labels.ts","./core/components/ui/alert/alert.spec.ts","./core/components/ui/alert/alert.ts","./core/components/ui/alert-messages/alert-messages.ts","./core/components/ui/badge/badge.ts","./core/components/ui/button/button.ts","./core/components/ui/captcha/altchaStyles.ts","./core/components/ui/captcha/captcha.ts","./core/components/ui/card/card-footer.ts","./core/components/ui/card/card-header-descripton.ts","./core/components/ui/card/card-header.ts","./core/components/ui/card/card-main.ts","./core/components/ui/card/card.ts","./core/components/ui/divider/divider.ts","./core/components/ui/form/checkbox/checkbox.ts","./core/components/ui/form/css/form-control.ts","./core/components/ui/form/fieldset/fieldset.ts","./core/components/ui/form/fieldset/legend-description.ts","./core/components/ui/form/fieldset/legend.ts","./core/components/ui/form/form-actions/form-actions.ts","./core/components/ui/form/form-layout/form-layout.ts","./core/components/ui/form/input/input.ts","./core/components/ui/form/input/password-helper.ts","./core/components/ui/form/input/same-value-helper.ts","./core/components/ui/form/input-autocomplete/input-autocomplete.ts","./core/components/ui/form/radio/radio.ts","./core/components/ui/form/select/select.ts","./core/components/ui/form/switch/switch.ts","./core/components/ui/form/textarea/textarea.ts","./core/components/ui/group/group.ts","./core/components/ui/icon/icon.stories.ts","./core/components/ui/icon/icon.ts","./core/components/ui/icon/icons.ts","./core/components/ui/image/image.ts","./core/components/ui/link/link.ts","./core/components/ui/loader/loader.stories.ts","./core/components/ui/loader/loader.ts","./core/components/ui/loader/styles/fixed.ts","./core/components/ui/loader/styles/inline.ts","./core/components/ui/menu/menu-item.ts","./core/components/ui/menu/menu.ts","./core/components/ui/modal/modal-actions.ts","./core/components/ui/modal/modal-close.ts","./core/components/ui/modal/modal-content.ts","./core/components/ui/modal/modal-subtitle.ts","./core/components/ui/modal/modal-title.ts","./core/components/ui/modal/modal-utils.ts","./core/components/ui/modal/modal.ts","./core/components/ui/pop/pop.ts","./core/components/ui/progress/progress.ts","./core/components/ui/table/table-caption.ts","./core/components/ui/table/table-tbody.ts","./core/components/ui/table/table-td.ts","./core/components/ui/table/table-tfoot.ts","./core/components/ui/table/table-th.ts","./core/components/ui/table/table-thead.ts","./core/components/ui/table/table-tr.ts","./core/components/ui/table/table.ts","./core/components/ui/theme/theme.ts","./core/components/ui/theme/theme-collection/auto.ts","./core/components/ui/theme/theme-collection/core-variables.ts","./core/components/ui/theme/theme-collection/dark.ts","./core/components/ui/theme/theme-collection/light.ts","./core/components/ui/toast/dismissed.ts","./core/components/ui/toast/message-subscriber.ts","./core/components/ui/toast/render-content.ts","./core/components/ui/toast/toast-item.ts","./core/components/ui/toast/toast.ts","./core/components/ui/toast/types.ts","./core/components/ui/tooltip/tooltip.ts","./core/decorators/Subscriber.ts","./core/decorators/api.post.spec.ts","./core/decorators/api.spec.ts","./core/decorators/api.ts","./core/decorators/lifecycle.ts","./core/decorators/subscriber/ancestorAttribute.spec.ts","./core/decorators/subscriber/ancestorAttribute.ts","./core/decorators/subscriber/autoFill.ts","./core/decorators/subscriber/autoSubscribe.ts","./core/decorators/subscriber/bind.ts","./core/decorators/subscriber/common.ts","./core/decorators/subscriber/derive.ts","./core/decorators/subscriber/dynamicPath.spec.ts","./core/decorators/subscriber/dynamicPath.ts","./core/decorators/subscriber/dynamicPropertyWatch.spec.ts","./core/decorators/subscriber/dynamicPropertyWatch.ts","./core/decorators/subscriber/handle.disambig.spec.ts","./core/decorators/subscriber/handle.skip.spec.ts","./core/decorators/subscriber/handle.ts","./core/decorators/subscriber/onAssign.ts","./core/decorators/subscriber/publish.spec.ts","./core/decorators/subscriber/publish.ts","./core/decorators/subscriber/publisherPath.ts","./core/decorators/subscriber/subscribe.spec.ts","./core/decorators/subscriber/subscribe.ts","./core/directives/DataProvider.sub.spec.ts","./core/directives/DataProvider.ts","./core/directives/Wording.ts","./core/mixins/Fetcher.ts","./core/mixins/FormCheckable.ts","./core/mixins/FormElement.ts","./core/mixins/FormInput.ts","./core/mixins/Subscriber.ts","./core/mixins/TemplatesContainer.ts","./core/mixins/mixins.ts","./core/utils/AncestorAttributeObserver.ts","./core/utils/Arrays.ts","./core/utils/DataBindObserver.ts","./core/utils/Electron.ts","./core/utils/Format.ts","./core/utils/HTML.ts","./core/utils/LocationHandler.ts","./core/utils/Objects.ts","./core/utils/PublisherProxy.ts","./core/utils/SafariScrollGuard.ts","./core/utils/Utils.ts","./core/utils/aesCrypto.ts","./core/utils/api.spec.ts","./core/utils/api.ts","./core/utils/dataProviderKey.spec.ts","./core/utils/dataProviderKey.ts","./core/utils/derive.spec.ts","./core/utils/derive.ts","./core/utils/dismissed.ts","./core/utils/dpOptions.spec.ts","./core/utils/endpoint.spec.ts","./core/utils/endpoint.ts","./core/utils/jsonataHelpers.ts","./core/utils/jsonataRuntime.ts","./core/utils/positioning.spec.ts","./core/utils/positioning.ts","./core/utils/publisherPathKey.spec.ts","./core/utils/route.spec.ts","./core/utils/route.ts","./core/utils/url-pattern.ts","./test-utils/TestUtils.ts"],"version":"5.9.2"}
+{"root":["./components.ts","./concorde-loaded.ts","./dataprovider.ts","./decorators.ts","./directives.ts","./index.ts","./mixins.ts","./utils.ts","./core/core.ts","./core/_types/endpoint.ts","./core/_types/key.ts","./core/_types/types.ts","./core/components/functional/functional.ts","./core/components/functional/date/date.ts","./core/components/functional/example/example.ts","./core/components/functional/fetch/fetch.ts","./core/components/functional/if/if.test.ts","./core/components/functional/if/if.ts","./core/components/functional/jsonata/jsonata.spec.ts","./core/components/functional/jsonata/jsonata.ts","./core/components/functional/list/list.demo.ts","./core/components/functional/list/list.spec.ts","./core/components/functional/list/list.ts","./core/components/functional/mix/mix.ts","./core/components/functional/queue/queue.demo.ts","./core/components/functional/queue/queue.ts","./core/components/functional/router/redirect.ts","./core/components/functional/router/router.demo.ts","./core/components/functional/router/router.spec.ts","./core/components/functional/router/router.ts","./core/components/functional/sdui/SDUIDescriptorTransformer.ts","./core/components/functional/sdui/component-catalog.spec.ts","./core/components/functional/sdui/sdui-action.spec.ts","./core/components/functional/sdui/sdui-dom-snapshot.ts","./core/components/functional/sdui/sdui-incremental.spec.ts","./core/components/functional/sdui/sdui-partial.spec.ts","./core/components/functional/sdui/sdui-partial.ts","./core/components/functional/sdui/sdui-safe.spec.ts","./core/components/functional/sdui/sdui-safe.ts","./core/components/functional/sdui/sdui-utils.ts","./core/components/functional/sdui/sdui.regression.spec.ts","./core/components/functional/sdui/sdui.ts","./core/components/functional/sdui/types.ts","./core/components/functional/sdui/__fixtures__/descriptors.ts","./core/components/functional/sonic-scope/sonic-scope.ts","./core/components/functional/states/states.demo.ts","./core/components/functional/states/states.spec.ts","./core/components/functional/states/states.ts","./core/components/functional/submit/submit.ts","./core/components/functional/subscriber/subscriber.ts","./core/components/functional/translation/translation.ts","./core/components/functional/value/value.ts","./core/components/ui/ui.ts","./core/components/ui/_css/align.ts","./core/components/ui/_css/rounded.ts","./core/components/ui/_css/scroll.ts","./core/components/ui/_css/shadow.ts","./core/components/ui/_css/size.ts","./core/components/ui/_css/type.ts","./core/components/ui/_i18n/ui-aria-labels.ts","./core/components/ui/alert/alert.spec.ts","./core/components/ui/alert/alert.ts","./core/components/ui/alert-messages/alert-messages.ts","./core/components/ui/badge/badge.ts","./core/components/ui/button/button.ts","./core/components/ui/captcha/altchaStyles.ts","./core/components/ui/captcha/captcha.ts","./core/components/ui/card/card-footer.ts","./core/components/ui/card/card-header-descripton.ts","./core/components/ui/card/card-header.ts","./core/components/ui/card/card-main.ts","./core/components/ui/card/card.ts","./core/components/ui/divider/divider.ts","./core/components/ui/form/checkbox/checkbox.ts","./core/components/ui/form/css/form-control.ts","./core/components/ui/form/fieldset/fieldset.ts","./core/components/ui/form/fieldset/legend-description.ts","./core/components/ui/form/fieldset/legend.ts","./core/components/ui/form/form-actions/form-actions.ts","./core/components/ui/form/form-layout/form-layout.ts","./core/components/ui/form/input/input.ts","./core/components/ui/form/input/password-helper.ts","./core/components/ui/form/input/same-value-helper.ts","./core/components/ui/form/input-autocomplete/input-autocomplete.ts","./core/components/ui/form/radio/radio.ts","./core/components/ui/form/select/select.ts","./core/components/ui/form/switch/switch.ts","./core/components/ui/form/textarea/textarea.ts","./core/components/ui/group/group.ts","./core/components/ui/icon/icon.stories.ts","./core/components/ui/icon/icon.ts","./core/components/ui/icon/icons.ts","./core/components/ui/image/image.ts","./core/components/ui/link/link.ts","./core/components/ui/loader/loader.stories.ts","./core/components/ui/loader/loader.ts","./core/components/ui/loader/styles/fixed.ts","./core/components/ui/loader/styles/inline.ts","./core/components/ui/menu/menu-item.ts","./core/components/ui/menu/menu.ts","./core/components/ui/modal/modal-actions.ts","./core/components/ui/modal/modal-close.ts","./core/components/ui/modal/modal-content.ts","./core/components/ui/modal/modal-subtitle.ts","./core/components/ui/modal/modal-title.ts","./core/components/ui/modal/modal-utils.ts","./core/components/ui/modal/modal.ts","./core/components/ui/pop/pop.ts","./core/components/ui/progress/progress.ts","./core/components/ui/table/table-caption.ts","./core/components/ui/table/table-tbody.ts","./core/components/ui/table/table-td.ts","./core/components/ui/table/table-tfoot.ts","./core/components/ui/table/table-th.ts","./core/components/ui/table/table-thead.ts","./core/components/ui/table/table-tr.ts","./core/components/ui/table/table.ts","./core/components/ui/theme/theme.ts","./core/components/ui/theme/theme-collection/auto.ts","./core/components/ui/theme/theme-collection/core-variables.ts","./core/components/ui/theme/theme-collection/dark.ts","./core/components/ui/theme/theme-collection/light.ts","./core/components/ui/toast/dismissed.ts","./core/components/ui/toast/message-subscriber.ts","./core/components/ui/toast/render-content.ts","./core/components/ui/toast/toast-item.ts","./core/components/ui/toast/toast.ts","./core/components/ui/toast/types.ts","./core/components/ui/tooltip/tooltip.ts","./core/decorators/Subscriber.ts","./core/decorators/api.post.spec.ts","./core/decorators/api.spec.ts","./core/decorators/api.ts","./core/decorators/lifecycle.ts","./core/decorators/subscriber/ancestorAttribute.spec.ts","./core/decorators/subscriber/ancestorAttribute.ts","./core/decorators/subscriber/autoFill.ts","./core/decorators/subscriber/autoSubscribe.ts","./core/decorators/subscriber/bind.ts","./core/decorators/subscriber/common.ts","./core/decorators/subscriber/derive.ts","./core/decorators/subscriber/dynamicPath.spec.ts","./core/decorators/subscriber/dynamicPath.ts","./core/decorators/subscriber/dynamicPropertyWatch.spec.ts","./core/decorators/subscriber/dynamicPropertyWatch.ts","./core/decorators/subscriber/handle.disambig.spec.ts","./core/decorators/subscriber/handle.skip.spec.ts","./core/decorators/subscriber/handle.ts","./core/decorators/subscriber/onAssign.ts","./core/decorators/subscriber/publish.spec.ts","./core/decorators/subscriber/publish.ts","./core/decorators/subscriber/publisherPath.ts","./core/decorators/subscriber/subscribe.spec.ts","./core/decorators/subscriber/subscribe.ts","./core/directives/DataProvider.sub.spec.ts","./core/directives/DataProvider.ts","./core/directives/Wording.ts","./core/mixins/Fetcher.ts","./core/mixins/FormCheckable.ts","./core/mixins/FormElement.ts","./core/mixins/FormInput.ts","./core/mixins/Subscriber.ts","./core/mixins/TemplatesContainer.ts","./core/mixins/mixins.ts","./core/utils/AncestorAttributeObserver.ts","./core/utils/Arrays.ts","./core/utils/DataBindObserver.ts","./core/utils/Electron.ts","./core/utils/Format.ts","./core/utils/HTML.ts","./core/utils/LocationHandler.ts","./core/utils/Objects.ts","./core/utils/PublisherProxy.ts","./core/utils/SafariScrollGuard.ts","./core/utils/Utils.ts","./core/utils/aesCrypto.ts","./core/utils/api.spec.ts","./core/utils/api.ts","./core/utils/dataProviderKey.spec.ts","./core/utils/dataProviderKey.ts","./core/utils/derive.spec.ts","./core/utils/derive.ts","./core/utils/dismissed.ts","./core/utils/dpOptions.spec.ts","./core/utils/endpoint.spec.ts","./core/utils/endpoint.ts","./core/utils/jsonataHelpers.ts","./core/utils/jsonataRuntime.ts","./core/utils/positioning.spec.ts","./core/utils/positioning.ts","./core/utils/publisherPathKey.spec.ts","./core/utils/route.spec.ts","./core/utils/route.ts","./core/utils/url-pattern.ts","./test-utils/TestUtils.ts"],"version":"5.9.2"}

package/tailwind.config.js

@@ -202,17 +202,21 @@ module.exports = {
             "pre code::after": {
               content: "none",
             },
+            /* technical-manual headings: heavy grotesk, tight, a 2px ink bar under each section */
             h1: {
-              fontWeight: "500",
+              fontWeight: "800",
+              letterSpacing: "-0.045em",
+              lineHeight: "0.95",
               marginBottom: "1rem",
             },
             h2: {
-              fontWeight: "500",
+              fontWeight: "800",
+              letterSpacing: "-0.03em",
               borderBottom: "var(--sc-border-width) solid",
-              paddingBottom: "0.1em",
+              paddingBottom: "0.15em",
             },
             h3: {
-              fontWeight: "500",
+              fontWeight: "600",
             },
             h4: {
               fontWeight: "500",

package/vite.config.mts

@@ -7,6 +7,7 @@ import { configDefaults } from "vitest/config";
 import path from "path";
 import fs from "fs";
 import { docsMockApiVitePlugin } from "./scripts/docs-mock-api-vite-plugin";
+import { docsMarkdownVitePlugin } from "./scripts/docs-markdown-vite-plugin";
 import { docsOpenInEditorPlugin } from "./scripts/docs-open-in-editor-plugin";
 
 function CustomHmr() {
@@ -90,7 +91,11 @@ export default defineConfig({
       },
     },
   },
-  base: "./",
+  // Docs SPA uses pathname routes (`/docs/...`); relative `./` breaks asset URLs on deep paths.
+  base:
+    libName === "docs" || process.env.npm_lifecycle_event === "dev"
+      ? "/"
+      : "./",
   test: {
     globals: true,
     environment: "jsdom",
@@ -129,7 +134,11 @@ export default defineConfig({
       include: ["src/**/*.css", "src/**/*.css?*"],
     }),
     ...(enableDocsMockApi
-      ? [docsMockApiVitePlugin(), docsOpenInEditorPlugin()]
+      ? [
+          docsMarkdownVitePlugin(),
+          docsMockApiVitePlugin(),
+          docsOpenInEditorPlugin(),
+        ]
       : []),
   ],
 });

package/.agents/skills/concorde-component-docs/SKILL.md

@@ -1,194 +0,0 @@
----
-name: concorde-component-docs
-description: >-
-  Writes and edits Concorde UI component documentation pages (*.md) in English
-  with consistent structure, tone, sonic-code examples, and API tables. Use when
-  creating or updating component docs under src/core/components/ui/, when
-  uniformizing documentation, or when the user references alert.md-style docs.
----
-
-# Concorde component documentation
-
-Apply this skill when **creating** or **editing** a component doc page (typically `src/core/components/ui/<component>/<component>.md`).
-
-Canonical examples: `alert.md`, `badge.md`, `link.md`, `image.md`.
-
-## Workflow
-
-### Creating a new page
-
-1. Read the component implementation (`.ts` / props, slots, reflected attributes, defaults).
-2. Draft the **intro** (what it does, when to use it, 1–2 critical APIs).
-3. Add **feature sections** in order of reader need (basic → variants → composition → edge cases → a11y).
-4. Add one **`<sonic-code>`** example per section; group enum variants in a single demo when practical.
-5. End with **`## API reference`** (attributes table, slots table if any).
-6. Run the [quality checklist](#quality-checklist).
-
-### Editing an existing page
-
-1. Preserve working examples; only change prose/structure to match this guide.
-2. Do not duplicate `## API reference` blocks—merge into one.
-3. Align intro tone and section titles with sibling docs; add missing API rows from source.
-4. Keep demo markup valid; avoid unrelated refactors in examples.
-
-## Page structure
-
-```markdown
-# ComponentName
-
-[Intro paragraph: 1–3 sentences. Purpose, primary use case, key props/slots.]
-
-## Basic example
-[or first topical section, e.g. ## Type, ## Href, ## Rounded]
-
-[Optional short prose before the example.]
-
-<sonic-code>
-  <template>
-    ...
-  </template>
-</sonic-code>
-
-## [Feature or variant name]
-
-...
-
-## API reference
-
-| Attribute | Values | Description |
-|----------|---------|-------------|
-| ... | ... | ... |
-
-| Slot | Description |
-|------|-------------|
-| ... | ... |
-```
-
-### Title (`#`)
-
-- Singular component name, Title Case: `# Alert`, `# Badge`, `# Link`, `# Image`.
-- Match the public tag name conceptually (`sonic-alert` → Alert).
-
-### Intro (required for new-style docs)
-
-One tight paragraph immediately after the title:
-
-- State **what** the component does and **when** to choose it.
-- Call out **defaults** and **constraints** only if they prevent misuse.
-- Formatting:
-  - **Bold** for emphasis on behavior (not for every noun).
-  - API names and tags in backticks; when listing several, **do not put commas between inline-code spans** (rendered as adjacent `<code>`). Join with **`/`**, **`and`**, or separate clauses—e.g. `` `label` `` / `` `text` ``, not `` `label` ``, `` `text` ``.
-  - Cross-link related components in prose: “aligned with **`sonic-button`**”, “pair with **`ratio="1/1"`**”.
-
-Avoid marketing fluff, long tutorials, and repeating the API table in the intro.
-
-### Section headings (`##` / `###`)
-
-- **Sentence case** or short Title Case; be consistent within one file.
-- Name sections after **one concern**: `Status`, `Size`, `Dismissible`, `Accessibility (\`announce\`)`, `Prefix and suffix slots`.
-- Use `###` for sub-variants of the same feature (e.g. `### AutoActive Strict vs partial`).
-- Put **`## API reference`** last—never in the middle.
-
-Suggested order (omit what does not apply):
-
-1. Basic example / primary API
-2. Visual variants (`type` / `status` / `variant` / `size` / …)
-3. Content model (slots, `label` / `text`, rich content)
-4. Composition patterns (inside buttons, with links, …)
-5. Behavioral flags (`dismissible` / `announce` / `cover` / …)
-6. Accessibility (dedicated section when non-obvious)
-7. API reference
-
-### Prose before examples
-
-- **Default first**: “With no `status`, behavior is `default`.” “Default **`loading`** is `lazy`.”
-- **Enums inline** when short: `` `outline` `` — border and text in the `type` color.
-- **Requirements**: stable `` `id` `` required for `dismissForever`; parent must constrain width for `ellipsis`.
-- **Implementation notes** only when they change usage: `localStorage`; `role="alert"`; remount to replay transitions.
-- Length: 0–4 sentences per section; longer only for accessibility or non-obvious behavior.
-
-## Live examples (`<sonic-code>`)
-
-Wrap all demos:
-
-```html
-<sonic-code>
-  <template>
-    <!-- demo markup -->
-  </template>
-</sonic-code>
-```
-
-Conventions:
-
-- Use Tailwind layout utilities already used in the design system docs: `grid gap-4` / `flex flex-wrap gap-2` / `items-center`.
-- Show **all enum values** in one row/grid when demonstrating `type`, `status`, or `size`.
-- Label variants in the UI (badge text, caption `<p class="mt-2">`) when comparison matters.
-- Prefer realistic copy over “Lorem ipsum” unless demonstrating truncation or length.
-- Interactive demos (buttons that mutate DOM) are allowed when they teach behavior—add one sentence explaining what to click.
-- Do not wrap API tables or long prose inside `<sonic-code>`.
-
-## API reference
-
-### Attributes table
-
-```markdown
-| Attribute | Values | Description |
-|----------|---------|-------------|
-| `name` | `a` · `b` (default `a`) | One line: behavior + default + interaction with other props |
-```
-
-- Column headers exactly: **Attribute**, **Values**, **Description**.
-- **Values**: list allowed literals separated by **middle dot (` · `)** or **`…`** for ranges (`2xs` … `2xl`)—**never commas between backtick spans**. Put **(default `…`)** in this column or in Description—be consistent within the file.
-- **Description**: imperative, factual; mention side effects (`removes from DOM`, `ignored when \`cover\` is set`).
-- Document boolean attributes as boolean in the table; no need to say “true/false” unless ambiguous.
-
-### Slots table
-
-```markdown
-| Slot | Description |
-|------|-------------|
-| *(default)* | Main label / message body |
-| `icon` | Replaces the default `sonic-icon` |
-```
-
-- If the component has **no slots**, state it in prose under the attributes table (see `image.md`).
-- Use *(default)* for the unnamed slot.
-
-### Single API block
-
-One `## API reference` section per file. If the source doc has duplicates, consolidate without losing rows.
-
-## Voice and language
-
-- **English only** for user-facing doc text.
-- Present tense, second person avoided; address the integrator (“Set **`announce`** when…”).
-- Prefer precise verbs: surface, navigate, truncate, persist, intercept.
-- Do not document internal CSS class names unless the doc already uses them for styling hooks (`[&[active]]:text-success` in examples is OK).
-
-## Quality checklist
-
-Before finishing, verify:
-
-- [ ] `#` title + intro paragraph present (for new or modernized pages).
-- [ ] Every `##` section (except API) has a `<sonic-code>` example unless it is pure sub-prose under a parent demo.
-- [ ] Defaults and required attributes are stated in prose or API table.
-- [ ] Accessibility called out where behavior affects AT (roles, `alt`, decorative icons).
-- [ ] Exactly one `## API reference`; attributes and slots match the component source.
-- [ ] No duplicate sections; heading levels skip only when using `###` under `##`.
-- [ ] Attribute/slot names match the implementation (camelCase in docs).
-- [ ] No comma-separated lists of inline-code terms in prose or API **Values** cells.
-
-## Anti-patterns
-
-- Long narrative guides, installation steps, or changelog in component `.md` files.
-- Examples without `<sonic-code>` wrappers.
-- API tables at the top of the page.
-- Mixing French and English in the same page.
-- Vague intros (“This component is very useful”) without API hints.
-- Separate micro-sections per enum value when one grid demo suffices.
-- Comma chains of inline code: `` `a` ``, `` `b` ``, and `` `c` `` (use `/`, ` · `, or `and` instead).
-
-## Reference template
-
-See [template.md](template.md) for a copy-paste skeleton.

package/.github/workflows/ci.yml

@@ -1,21 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [master, main]
-  pull_request:
-    branches: [master, main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "22"
-          cache: yarn
-
-      - run: yarn install --frozen-lockfile
-      - run: yarn test:ci

package/.github-export-ignore

@@ -1,30 +0,0 @@
-# Arborescence exclue du miroir public GitHub (GitLab reste complet).
-# Syntaxe : une entrée par ligne, # = commentaire.
-
-# Site doc
-index.html
-src/docs.ts
-src/docs/
-docs/
-img/
-scripts/create-search.js
-scripts/post-build-docs.js
-scripts/docs-mock-api-vite-plugin.ts
-scripts/docs-open-in-editor-plugin.ts
-public/docs-mock-api-sw.js
-public/docs-mock-api-sw.js.map
-
-# Captcha (dépend de altcha.supersoniks.org)
-src/core/components/ui/captcha/
-
-# Démos intégrées à la doc
-**/*.demo.ts
-
-# CI / infra interne
-gitlab/
-
-# Artefacts locaux
-dist/
-build-infos.json
-concorde-core.bundle.js
-concorde-core.es.js

package/CONTRIBUTING.md

@@ -1,59 +0,0 @@
-# Contribuer à Concorde
-
-Merci de votre intérêt pour `@supersoniks/concorde` !
-
-## Modèle de contribution (phase 1)
-
-Concorde utilise un dépôt **GitLab interne** comme source complète, avec un **export public filtré** sur GitHub (librairie uniquement — pas le site doc, pas le composant captcha lié à l’infra Supersoniks).
-
-| Qui | Où | Comment |
-|-----|-----|---------|
-| Équipe Supersoniks | GitLab | Branche + **Merge Request** vers `master` |
-| Contributeurs externes | GitHub | **Issues** pour signaler bugs ou proposer des améliorations |
-| Contributeurs externes (code) | GitHub / email | Décrire le changement dans une issue, ou proposer un patch que l'équipe intègre sur GitLab |
-
-> Les Pull Requests sur le dépôt GitHub public **ne sont pas mergées directement** : le miroir GitLab → GitHub écraserait ces changements. Ouvrez une issue pour discuter avant d'investir du temps.
-
-## Prérequis
-
-- Node.js 20+ (22 recommandé)
-- Yarn 1.22 (`packageManager` dans `package.json`)
-
-## Workflow développeur interne
-
-```bash
-git checkout -b ma-branche
-yarn install
-# … modifications …
-yarn test:ci
-# Ouvrir une Merge Request vers master sur GitLab
-```
-
-## Tests
-
-```bash
-yarn test       # watch (développement)
-yarn test:ci    # exécution unique (CI)
-```
-
-## Build
-
-```bash
-yarn build        # librairie → dist/
-yarn build-docs   # documentation statique → docs/
-yarn dev          # serveur de doc local (https://localhost:3000)
-```
-
-## Conventions
-
-- Suivre les patterns existants (Lit, décorateurs, DataProviderKey).
-- Pas de `console.log` oubliés (bloqué par `prepublishOnly`).
-- Documentation : fichiers `.md` colocalisés avec les composants dans `src/`.
-
-## Signaler un problème de sécurité
-
-Ne pas ouvrir d'issue publique. Contacter l'équipe Supersoniks directement.
-
-## Évolution prévue
-
-Si des contributions externes deviennent fréquentes, le dépôt GitHub pourra devenir la source canonique (modèle inversé). En attendant, GitLab reste le point d'entrée pour le code.

package/DEV.md

@@ -1,54 +0,0 @@
-# Développement local — consommer Concorde depuis un autre projet
-
-## Recommandé : `file:` (sans `yarn link`)
-
-Dans le projet consommateur (la-billetterie, etc.) :
-
-```bash
-yarn add @supersoniks/concorde@file:../../concorde
-```
-
-- Pas de `yarn link` / `yarn unlink` à gérer
-- Comportement proche d’un install registry
-- Après modification de Concorde : `yarn build` dans concorde (génère `dist/js/` + `dist/types/`), puis rebuild du consommateur
-
-## Alternative : `yarn link`
-
-Toujours supporté. Dans Concorde :
-
-```bash
-yarn link
-```
-
-Dans le consommateur :
-
-```bash
-yarn link @supersoniks/concorde
-```
-
-### Pourquoi `vite-config` exclut Concorde du pre-bundle
-
-Dans `vite/config.js`, quand un `tsconfig` est passé :
-
-```js
-optimizeDeps: {
-  exclude: ["@supersoniks/concorde"],
-  // ...
-}
-```
-
-**Toujours utile** avec `yarn link` ou `file:` : Vite ne met pas Concorde en cache dans `node_modules/.vite`, donc les changements dans `dist/js/` (après `yarn build` dans Concorde) sont pris en compte au prochain HMR / rebuild.
-
-Les exports npm pointent vers `dist/js/` (runtime) et `dist/types/` (types) — le source `src/` sert au développement de Concorde lui-même.
-
-## Types (`.d.ts`) et runtime (`.js`)
-
-`yarn build` exécute `prebuild` (exports) → bundle Vite → `postbuild` (génération de `dist/types/` + `dist/js/`).
-
-`yarn build:types` / `yarn build:js` restent disponibles pour régénérer uniquement les déclarations ou le JS.
-
-## Scripts la-billetterie
-
-`link:concorde` / `unlink:concorde` dans `la-billetterie/concorde/package.json` restent valides.
-
-`test:concorde-lib` pointe vers un fichier `resolvePublisher.spec.ts` **supprimé** — script obsolète à nettoyer côté billetterie.

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) Supersoniks
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/OPEN_SOURCE_CHECKPOINT.md

@@ -1,133 +0,0 @@
-# Point d'étape — Open Source Concorde
-
-> Modèle retenu (phase 1) : **GitLab = source complète**, **GitHub = export filtré** (librairie seule).
-
-Dernière mise à jour : juin 2025.
-
----
-
-## ✅ Fait (dans ce dépôt GitLab)
-
-| Élément | Fichier / action |
-|---------|------------------|
-| Licence MIT | `LICENSE` |
-| Retrait Typekit inutilisé | `index.html` |
-| Métadonnées npm (repo, homepage, bugs) | `package.json` |
-| README mis à jour | `README.md` |
-| Guide contributeurs | `CONTRIBUTING.md` |
-| CI GitHub Actions | `.github/workflows/ci.yml` |
-| **Liste d'exclusion GitHub** | `.github-export-ignore` |
-| **Script d'export filtré** | `scripts/github-export.mjs` |
-| **Job CI miroir GitHub** | `gitlab/job_github_mirror.sh` |
-
-### Ce qui reste sur GitLab uniquement (pas sur GitHub)
-
-| Exclu | Raison |
-|-------|--------|
-| `index.html`, `src/docs/`, `src/docs.ts` | Site doc → [concorde.supersoniks.org](https://concorde.supersoniks.org/) |
-| `src/core/components/ui/captcha/` | Dépend de `altcha.supersoniks.org` |
-| `**/*.demo.ts` | Démos intégrées à la doc |
-| `gitlab/` | CI / infra interne |
-
-Le script retire aussi l'import captcha dans `ui.ts` et filtre les `exports` npm liés à la doc/captcha.
-
----
-
-## ⏳ À faire de votre côté
-
-### 1. Merger ces changements sur GitLab
-
-```bash
-git add LICENSE README.md CONTRIBUTING.md OPEN_SOURCE_CHECKPOINT.md \
-        .github-export-ignore scripts/github-export.mjs \
-        .github/workflows/ci.yml .gitlab-ci.yml \
-        gitlab/job_github_mirror.sh package.json index.html
-git commit -m "Open source : export GitHub filtré (sans doc ni captcha)"
-# MR vers master
-```
-
-### 2. Créer le dépôt GitHub public
-
-1. https://github.com/organizations/supersoniks → **New repository** → `concorde`
-2. **Public**, sans README initial
-
-### 3. Variables CI GitLab
-
-**Settings → CI/CD → Variables** (masquées) :
-
-| Variable | Exemple |
-|----------|---------|
-| `GITHUB_REPO_URL` | `https://github.com/supersoniks/concorde.git` |
-| `GITHUB_TOKEN` | PAT GitHub scope `repo` |
-
-### 4. Premier export (manuel ou CI)
-
-**En local :**
-
-```bash
-node scripts/github-export.mjs /tmp/concorde-github
-cd /tmp/concorde-github
-git init && git add -A && git commit -m "Initial export lib"
-git remote add origin git@github.com:supersoniks/concorde.git
-git push -u origin master
-```
-
-**Via GitLab CI** (après merge sur `master`) :
-
-- Lancer le job manuel **`github-mirror`** dans la pipeline
-
-> **Ne pas** utiliser le push mirror GitLab natif (il enverrait tout, doc + captcha inclus).
-
-### 5. Vérifier GitHub
-
-```bash
-git clone https://github.com/supersoniks/concorde.git
-cd concorde
-yarn install && yarn test:ci
-```
-
-- Pas de `index.html`, pas de `src/docs/`, pas de `captcha.ts`
-- Pas de référence à `cdn.supersoniks.com` ni `altcha.supersoniks.org` dans le tree
-
-### 6. npm
-
-```bash
-yarn build
-npm publish --access public
-```
-
-(idéalement depuis l'export filtré ou après avoir aligné `files` / `exports` npm)
-
-### 7. Documentation en ligne
-
-Doc hébergée sur **https://concorde.supersoniks.org/** (build depuis GitLab, pas depuis GitHub).
-
----
-
-## Schéma
-
-```
-┌──────────────────────────────────────────┐
-│  GitLab (interne) — tout le dépôt         │
-│  doc + captcha + dev (yarn dev) + CI      │
-└──────────────────┬───────────────────────┘
-                   │ scripts/github-export.mjs
-                   │ (job github-mirror)
-                   ▼
-┌──────────────────────────────────────────┐
-│  GitHub (public) — librairie seule        │
-│  src/core, décorateurs, tests, CI Actions │
-└──────────────────────────────────────────┘
-
-Doc en ligne : concorde.supersoniks.org  (déployée depuis GitLab)
-```
-
----
-
-## Checklist finale
-
-- [ ] Export GitHub sans `cdn.supersoniks` / `altcha.supersoniks`
-- [ ] `yarn test:ci` OK sur clone GitHub
-- [ ] Job `github-mirror` configuré
-- [ ] npm `@supersoniks/concorde` publié
-- [ ] Doc accessible sur concorde.supersoniks.org