@supersoniks/concorde 5.1.1 → 5.1.3-immutable.1

package/src/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"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"}
+{"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-immutable.spec.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.spec.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.spec.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/deepReadonly.spec.ts","./core/utils/deepReadonly.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/immutableValue.spec.ts","./core/utils/immutableValue.ts","./core/utils/jsonataHelpers.ts","./core/utils/jsonataRuntime.ts","./core/utils/nestedDotForm.spec.ts","./core/utils/positioning.spec.ts","./core/utils/positioning.ts","./core/utils/publisherImmutable.spec.ts","./core/utils/publisherPathKey.spec.ts","./core/utils/route.spec.ts","./core/utils/route.ts","./core/utils/strictGet.spec.ts","./core/utils/strictGet.ts","./core/utils/url-pattern.ts","./test-utils/TestUtils.ts"],"version":"5.9.2"}

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.