@supersoniks/concorde 5.0.5 → 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. package/.github/workflows/ci.yml +21 -0
  2. package/.github-export-ignore +30 -0
  3. package/.tmp-cem/custom-elements.json +13705 -0
  4. package/CONTRIBUTING.md +59 -0
  5. package/DEV.md +54 -0
  6. package/LICENSE +21 -0
  7. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  8. package/build-infos.json +1 -1
  9. package/concorde-3d.bundle.js +3960 -0
  10. package/concorde-3d.es.js +33433 -0
  11. package/concorde-core.bundle.js +196 -196
  12. package/concorde-core.es.js +3685 -3405
  13. package/concorde-hugging-face-infer.bundle.js +32 -0
  14. package/concorde-hugging-face-infer.es.js +2952 -0
  15. package/concorde-interactive.bundle.js +1157 -0
  16. package/concorde-interactive.es.js +10734 -0
  17. package/concorde-shader.bundle.js +116 -0
  18. package/concorde-shader.es.js +8353 -0
  19. package/concorde-webgpu.bundle.js +307 -0
  20. package/concorde-webgpu.es.js +8627 -0
  21. package/custom-elements-manifest.config.mjs +14 -0
  22. package/dist/concorde-core.bundle.js +196 -196
  23. package/dist/concorde-core.es.js +3685 -3405
  24. package/docs/assets/{index-wVZpLVYW.js → index-D8MVWqY6.js} +1351 -1222
  25. package/docs/assets/index-DiD0qYvE.css +1 -0
  26. package/docs/crawl/core/components/ui/alert/alert.html +71 -172
  27. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +5 -113
  28. package/docs/crawl/core/components/ui/badge/badge.html +79 -157
  29. package/docs/crawl/core/components/ui/button/button.html +0 -1
  30. package/docs/crawl/core/components/ui/captcha/captcha.html +8 -90
  31. package/docs/crawl/core/components/ui/card/card.html +68 -222
  32. package/docs/crawl/core/components/ui/divider/divider.html +31 -117
  33. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +101 -232
  34. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +52 -95
  35. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +38 -97
  36. package/docs/crawl/core/components/ui/form/input/input.html +3 -3
  37. package/docs/crawl/core/components/ui/form/textarea/textarea.html +3 -3
  38. package/docs/crawl/core/components/ui/group/group.html +38 -60
  39. package/docs/crawl/core/components/ui/icon/icon.html +47 -136
  40. package/docs/crawl/core/components/ui/image/image.html +56 -244
  41. package/docs/crawl/core/components/ui/link/link.html +9 -67
  42. package/docs/crawl/core/components/ui/loader/loader.html +23 -97
  43. package/docs/crawl/core/components/ui/menu/menu.html +90 -162
  44. package/docs/crawl/core/components/ui/modal/modal.html +50 -275
  45. package/docs/crawl/core/components/ui/pop/pop.html +66 -260
  46. package/docs/crawl/core/components/ui/progress/progress.html +30 -103
  47. package/docs/crawl/core/components/ui/table/table.html +171 -303
  48. package/docs/crawl/core/components/ui/toast/toast.html +59 -170
  49. package/docs/crawl/core/components/ui/tooltip/tooltip.html +29 -90
  50. package/docs/crawl/docs/_decorators/ancestor-attribute.html +2 -3
  51. package/docs/crawl/docs/_getting-started/concorde-outside.html +3 -3
  52. package/docs/crawl/docs/_getting-started/start.html +1 -1
  53. package/docs/crawl/docs/_getting-started/theming.html +63 -311
  54. package/docs/crawl/hubs/form-components.html +53 -75
  55. package/docs/crawl/index.html +6 -7
  56. package/docs/docs-mock-api-sw.js +0 -2
  57. package/docs/docs-mock-api-sw.js.map +2 -2
  58. package/docs/index.html +7 -9
  59. package/docs/llms-full.txt +456 -1703
  60. package/docs/llms.txt +32 -25
  61. package/docs/sitemap.xml +0 -3
  62. package/docs/src/core/components/functional/fetch/fetch.md +0 -0
  63. package/docs/src/core/components/functional/if/if.md +0 -0
  64. package/docs/src/core/components/functional/list/list.md +0 -0
  65. package/docs/src/core/components/functional/router/router.md +0 -0
  66. package/docs/src/core/components/functional/sdui/sdui.md +0 -0
  67. package/docs/src/core/components/functional/states/states.md +0 -0
  68. package/docs/src/core/components/functional/submit/submit.md +0 -0
  69. package/docs/src/core/components/ui/alert/alert.md +72 -147
  70. package/docs/src/core/components/ui/alert-messages/alert-messages.md +0 -85
  71. package/docs/src/core/components/ui/badge/badge.md +80 -141
  72. package/docs/src/core/components/ui/button/button.md +0 -1
  73. package/docs/src/core/components/ui/captcha/captcha.md +6 -65
  74. package/docs/src/core/components/ui/card/card.md +65 -183
  75. package/docs/src/core/components/ui/divider/divider.md +13 -107
  76. package/docs/src/core/components/ui/form/fieldset/fieldset.md +99 -175
  77. package/docs/src/core/components/ui/form/form-actions/form-actions.md +52 -75
  78. package/docs/src/core/components/ui/form/form-layout/form-layout.md +34 -109
  79. package/docs/src/core/components/ui/form/input/input.md +1 -1
  80. package/docs/src/core/components/ui/form/radio/radio.md +0 -0
  81. package/docs/src/core/components/ui/form/select/select.md +0 -0
  82. package/docs/src/core/components/ui/form/switch/switch.md +0 -0
  83. package/docs/src/core/components/ui/form/textarea/textarea.md +1 -1
  84. package/docs/src/core/components/ui/group/group.md +36 -36
  85. package/docs/src/core/components/ui/icon/icon.md +43 -132
  86. package/docs/src/core/components/ui/image/image.md +53 -179
  87. package/docs/src/core/components/ui/link/link.md +7 -45
  88. package/docs/src/core/components/ui/loader/loader.md +22 -79
  89. package/docs/src/core/components/ui/menu/menu.md +92 -133
  90. package/docs/src/core/components/ui/modal/modal.md +47 -163
  91. package/docs/src/core/components/ui/pop/pop.md +64 -262
  92. package/docs/src/core/components/ui/progress/progress.md +30 -76
  93. package/docs/src/core/components/ui/table/table.md +171 -147
  94. package/docs/src/core/components/ui/toast/toast.md +58 -108
  95. package/docs/src/core/components/ui/tooltip/tooltip.md +26 -68
  96. package/docs/src/docs/_core-concept/subscriber.md +0 -0
  97. package/docs/src/docs/_decorators/ancestor-attribute.md +2 -3
  98. package/docs/src/docs/_getting-started/concorde-outside.md +3 -3
  99. package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -0
  100. package/docs/src/docs/_getting-started/pubsub.md +0 -0
  101. package/docs/src/docs/_getting-started/start.md +1 -1
  102. package/docs/src/docs/_getting-started/theming.md +61 -223
  103. package/docs/src/docs/search/docs-search.json +348 -3083
  104. package/docs/src/tsconfig.declarations.json +22 -0
  105. package/docs/src/tsconfig.emit.json +23 -0
  106. package/docs/src/tsconfig.json +3 -63
  107. package/gitlab/job_github_mirror.sh +39 -0
  108. package/package.json +36 -2
  109. package/scripts/generate-sdui-catalog.mjs +250 -0
  110. package/scripts/generate-sdui-catalog.spec.ts +91 -0
  111. package/scripts/github-export.mjs +150 -0
  112. package/scripts/post-build-docs.js +0 -0
  113. package/scripts/post-build.mjs +0 -0
  114. package/scripts/pre-build.mjs +15 -0
  115. package/src/core/components/functional/fetch/fetch.md +0 -0
  116. package/src/core/components/functional/if/if.md +0 -0
  117. package/src/core/components/functional/if/if.ts +0 -0
  118. package/src/core/components/functional/list/list.demo.ts +0 -0
  119. package/src/core/components/functional/list/list.md +0 -0
  120. package/src/core/components/functional/router/router.md +0 -0
  121. package/src/core/components/functional/router/router.ts +0 -0
  122. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +5 -5
  123. package/src/core/components/functional/sdui/__fixtures__/descriptors.ts +251 -0
  124. package/src/core/components/functional/sdui/__snapshots__/sdui-action.spec.ts.snap +73 -0
  125. package/src/core/components/functional/sdui/__snapshots__/sdui-incremental.spec.ts.snap +50 -0
  126. package/src/core/components/functional/sdui/__snapshots__/sdui-partial.spec.ts.snap +50 -0
  127. package/src/core/components/functional/sdui/__snapshots__/sdui.regression.spec.ts.snap +461 -0
  128. package/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  129. package/src/core/components/functional/sdui/component-catalog.json +3103 -0
  130. package/src/core/components/functional/sdui/component-catalog.spec.ts +23 -0
  131. package/src/core/components/functional/sdui/sdui-action.spec.ts +99 -0
  132. package/src/core/components/functional/sdui/sdui-dom-snapshot.ts +61 -0
  133. package/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  134. package/src/core/components/functional/sdui/sdui-incremental.spec.ts +137 -0
  135. package/src/core/components/functional/sdui/sdui-partial.spec.ts +83 -0
  136. package/src/core/components/functional/sdui/sdui-partial.ts +19 -0
  137. package/src/core/components/functional/sdui/sdui-safe.spec.ts +188 -0
  138. package/src/core/components/functional/sdui/sdui-safe.ts +100 -0
  139. package/src/core/components/functional/sdui/sdui.md +122 -0
  140. package/src/core/components/functional/sdui/sdui.regression.spec.ts +64 -0
  141. package/src/core/components/functional/sdui/sdui.ts +442 -34
  142. package/src/core/components/functional/sdui/types.ts +49 -0
  143. package/src/core/components/functional/states/states.md +0 -0
  144. package/src/core/components/functional/submit/submit.md +0 -0
  145. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  146. package/src/core/components/functional/value/value.ts +0 -0
  147. package/src/core/components/ui/_css/size.ts +0 -0
  148. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  149. package/src/core/components/ui/form/radio/radio.md +0 -0
  150. package/src/core/components/ui/form/select/select.md +0 -0
  151. package/src/core/components/ui/form/switch/switch.md +0 -0
  152. package/src/core/mixins/Subscriber.ts +0 -0
  153. package/src/core/utils/DataBindObserver.ts +0 -0
  154. package/src/core/utils/Objects.ts +0 -0
  155. package/src/core/utils/route.ts +0 -0
  156. package/src/css.d.ts +19 -0
  157. package/src/docs/_core-concept/subscriber.md +0 -0
  158. package/src/docs/_getting-started/my-first-subscriber.md +0 -0
  159. package/src/docs/_getting-started/pubsub.md +0 -0
  160. package/src/docs/example/users.ts +0 -0
  161. package/src/docs/search/page.ts +0 -0
  162. package/src/tsconfig.declarations.json +22 -0
  163. package/src/tsconfig.emit.json +23 -0
  164. package/src/tsconfig.json +90 -0
  165. package/src/tsconfig.tsbuildinfo +1 -1
  166. package/docs/assets/index-CD4WyL6o.css +0 -1
  167. package/docs/crawl/core/components/ui/theme/theme.html +0 -131
  168. package/docs/src/core/components/ui/theme/theme.md +0 -122
@@ -4,8 +4,8 @@
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
6
  <title>Image — Concorde</title>
7
- <meta name="description" content="sonic-image wraps a responsive &lt;img&gt; with aspect ratio, object-fit: cover, optional rounded corners, and load transitions. The host shows a placeholder background (--sc-placeholder-bg) until the asset">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/ui/image/image, image, Image, UI component, sonic-image, web component, , object-fit: cover, --sc-placeholder-bg, loading, lazy, loading=&quot;eager&quot;, rounded, --sc-rounded">
7
+ <meta name="description" content="src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/image/image, image, Image, UI component, sonic-image, web component">
9
9
  <meta name="concorde-doc-id" content="core/components/ui/image/image">
10
10
  <link rel="canonical" href="https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html">
11
11
  </head>
@@ -15,282 +15,94 @@
15
15
  </header>
16
16
  <main>
17
17
  <article>
18
- <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Image</strong>. sonic-image wraps a responsive &lt;img&gt; with aspect ratio, object-fit: cover, optional rounded corners, and load transitions. The host shows a placeholder background (--sc-placeholder-bg) until the asset <span>Doc ID: <code>core/components/ui/image/image</code>. Keywords: Concorde, supersoniks, core/components/ui/image/image, image, Image, UI component, sonic-image, web component, , object-fit: cover, --sc-placeholder-bg, loading, lazy, loading=&quot;eager&quot;, rounded, --sc-rounded. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html">https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html</a>.</span></p>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Image</strong>. src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot; <span>Doc ID: <code>core/components/ui/image/image</code>. Keywords: Concorde, supersoniks, core/components/ui/image/image, image, Image, UI component, sonic-image, web component. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html">https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html</a>.</span></p>
19
19
  <h1 id="image">Image</h1>
20
- <p><strong><code>sonic-image</code></strong> wraps a responsive <strong><code>&lt;img&gt;</code></strong> with aspect ratio, <code>object-fit: cover</code>, optional rounded corners, and load transitions. The host shows a placeholder background (<code>--sc-placeholder-bg</code>) until the asset loads. Default <strong><code>loading</code></strong> is <code>lazy</code>; use <strong><code>loading=&quot;eager&quot;</code></strong> for above-the-fold heroes.</p>
21
20
  <h2 id="rounded">Rounded</h2>
22
- <p>Omit <code>rounded</code> for square corners. Boolean <strong><code>rounded</code></strong> uses the theme token <code>--sc-rounded</code>. Sizes: <strong><code>sm</code></strong>, <strong><code>md</code></strong>, <strong><code>lg</code></strong>, <strong><code>xl</code></strong>, <strong><code>full</code></strong> (circle — pair with <code>ratio=&quot;1/1&quot;</code>), <strong><code>none</code></strong> (explicit reset).</p>
23
- <pre><code>&lt;div class=&quot;grid gap-6 grid-cols-3 lg:grid-cols-4 items-end text-center text-xs &quot;&gt;
24
- &lt;div&gt;
25
- &lt;sonic-image
26
- ratio=&quot;1/1&quot;
27
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
28
- &gt;&lt;/sonic-image&gt;
29
- &lt;p class=&quot;mt-2&quot;&gt;default&lt;/p&gt;
30
- &lt;/div&gt;
31
- &lt;div&gt;
32
- &lt;sonic-image
33
- rounded=&quot;sm&quot;
34
- ratio=&quot;1/1&quot;
35
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
36
- &gt;&lt;/sonic-image&gt;
37
- &lt;p class=&quot;mt-2&quot;&gt;sm&lt;/p&gt;
38
- &lt;/div&gt;
39
- &lt;div&gt;
40
- &lt;sonic-image
41
- rounded
42
- ratio=&quot;1/1&quot;
43
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
44
- &gt;&lt;/sonic-image&gt;
45
- &lt;p class=&quot;mt-2&quot;&gt;rounded&lt;/p&gt;
46
- &lt;/div&gt;
47
- &lt;div&gt;
48
- &lt;sonic-image
49
- rounded=&quot;md&quot;
50
- ratio=&quot;1/1&quot;
51
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
52
- &gt;&lt;/sonic-image&gt;
53
- &lt;p class=&quot;mt-2&quot;&gt;md&lt;/p&gt;
54
- &lt;/div&gt;
55
- &lt;div&gt;
56
- &lt;sonic-image
57
- rounded=&quot;lg&quot;
58
- ratio=&quot;1/1&quot;
59
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
60
- &gt;&lt;/sonic-image&gt;
61
- &lt;p class=&quot;mt-2&quot;&gt;lg&lt;/p&gt;
62
- &lt;/div&gt;
63
- &lt;div&gt;
64
- &lt;sonic-image
65
- rounded=&quot;xl&quot;
66
- ratio=&quot;1/1&quot;
67
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
68
- &gt;&lt;/sonic-image&gt;
69
- &lt;p class=&quot;mt-2&quot;&gt;xl&lt;/p&gt;
70
- &lt;/div&gt;
71
- &lt;div &gt;
72
- &lt;div &gt;
73
- &lt;sonic-image
74
- rounded=&quot;full&quot;
75
- ratio=&quot;1/1&quot;
76
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
77
- &gt;&lt;/sonic-image&gt;
78
- &lt;p class=&quot;mt-2&quot;&gt;full&lt;/p&gt;
79
- &lt;/div&gt;
80
- &lt;/div&gt;
21
+ <pre><code>&lt;div class=&quot;grid gap-8 grid-cols-3 items-center&quot;&gt;
22
+ &lt;sonic-image
23
+ src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
24
+ ratio=&quot;1/1&quot;
25
+ &gt;
26
+ &lt;/sonic-image&gt;
27
+ &lt;sonic-image
28
+ rounded=&quot;sm&quot;
29
+ ratio=&quot;1/1&quot;
30
+ src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
31
+ &gt;
32
+ &lt;/sonic-image&gt;
33
+ &lt;sonic-image
34
+ rounded
35
+ ratio=&quot;1/1&quot;
36
+ src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
37
+ &gt;
38
+ &lt;/sonic-image&gt;
39
+ &lt;sonic-image
40
+ rounded=&quot;md&quot;
41
+ ratio=&quot;1/1&quot;
42
+ src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
43
+ &gt;
44
+ &lt;/sonic-image&gt;
45
+ &lt;sonic-image
46
+ rounded=&quot;lg&quot;
47
+ ratio=&quot;1/1&quot;
48
+ src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
49
+ &gt;
50
+ &lt;/sonic-image&gt;
51
+ &lt;sonic-image
52
+ rounded=&quot;full&quot;
53
+ ratio=&quot;1/1&quot;
54
+ src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
55
+ &gt;
56
+ &lt;/sonic-image&gt;
81
57
  &lt;/div&gt;
82
58
  </code></pre>
83
- <h2 id="aspect-ratio">Aspect ratio</h2>
84
- <p><strong><code>ratio</code></strong> sets CSS <code>aspect-ratio</code> on the image (default <strong><code>auto</code></strong>). The image still fills the host width (<code>width: 100%</code>).</p>
59
+ <h2 id="ratio">Ratio</h2>
85
60
  <pre><code>&lt;div class=&quot;grid gap-8 grid-cols-2 items-center&quot;&gt;
86
61
  &lt;sonic-image
87
62
  src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
88
- &gt;&lt;/sonic-image&gt;
63
+ &gt;
64
+ &lt;/sonic-image&gt;
89
65
  &lt;sonic-image
90
66
  ratio=&quot;16/9&quot;
91
67
  src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
92
- &gt;&lt;/sonic-image&gt;
68
+ &gt;
69
+ &lt;/sonic-image&gt;
93
70
  &lt;sonic-image
94
71
  ratio=&quot;1/1&quot;
95
72
  src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
96
- &gt;&lt;/sonic-image&gt;
73
+ &gt;
74
+ &lt;/sonic-image&gt;
97
75
  &lt;sonic-image
98
76
  ratio=&quot;2/3&quot;
99
77
  src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
100
- &gt;&lt;/sonic-image&gt;
78
+ &gt;
79
+ &lt;/sonic-image&gt;
101
80
  &lt;/div&gt;
102
81
  </code></pre>
103
82
  <h2 id="object-position">Object position</h2>
104
- <p><strong><code>objectPosition</code></strong> maps to CSS <code>object-position</code> (default <strong><code>center center</code></strong>). Useful on wide crops when the subject sits off-center.</p>
105
83
  <pre><code>&lt;div class=&quot;grid gap-8 grid-cols-2 items-center&quot;&gt;
106
84
  &lt;sonic-image
107
- ratio=&quot;11/4&quot;
108
85
  src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
109
- &gt;&lt;/sonic-image&gt;
86
+ ratio=&quot;11/4&quot;
87
+ &gt;
88
+ &lt;/sonic-image&gt;
110
89
  &lt;sonic-image
111
90
  objectPosition=&quot;center top&quot;
112
- ratio=&quot;11/4&quot;
113
91
  src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
114
- &gt;&lt;/sonic-image&gt;
92
+ ratio=&quot;11/4&quot;
93
+ &gt;
94
+ &lt;/sonic-image&gt;
115
95
  &lt;/div&gt;
116
96
  </code></pre>
117
97
  <h2 id="cover">Cover</h2>
118
- <p><strong><code>cover</code></strong> stretches the image to fill a <strong>positioned</strong> parent (<code>position: relative</code> + fixed height or inset). Aspect ratio on the host is ignored while <code>cover</code> is set.</p>
119
- <pre><code>&lt;div class=&quot;h-96 relative rounded-lg overflow-hidden&quot;&gt;
98
+ <pre><code>&lt;div class=&quot;h-96 relative&quot;&gt;
120
99
  &lt;sonic-image
121
100
  cover
122
101
  src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
123
- &gt;&lt;/sonic-image&gt;
124
- &lt;/div&gt;
125
- </code></pre>
126
- <h2 id="load-transition">Load transition</h2>
127
- <p>Set <strong><code>transition</code></strong> to <strong><code>fade</code></strong> (default when the attribute is present) or <strong><code>fade-scale-out</code></strong>. The image stays at <code>opacity: 0</code> until the browser fires <strong><code>load</code></strong>, then the <strong><code>loaded</code></strong> class runs the animation. Changing <code>src</code> on an existing element does not replay the effect — mount a new <code>sonic-image</code> when you need another entrance (galleries, infinite scroll).</p>
128
- <p>Click <strong>Add image</strong> to append small thumbnails and replay the transition. <strong>Clear</strong> resets the row.</p>
129
- <pre><code>&lt;div class=&quot;flex flex-wrap gap-2 mb-4&quot;&gt;
130
- &lt;sonic-button
131
- size=&quot;sm&quot;
132
- onclick=&quot;(function () {
133
- var host = document.getElementById(&#39;sonic-image-transition-host&#39;);
134
- var img = document.createElement(&#39;sonic-image&#39;);
135
- img.transition = &#39;fade&#39;;
136
- img.ratio = &#39;1/1&#39;;
137
- img.rounded = &#39;md&#39;;
138
- img.loading = &#39;eager&#39;;
139
- img.style.width = &#39;8rem&#39;;
140
- img.src = &#39;https://picsum.photos/seed/&#39; + Date.now() + &#39;/120/120&#39;;
141
- host.appendChild(img);
142
- })()&quot;
143
- &gt;
144
- Add image (fade)
145
- &lt;/sonic-button&gt;
146
- &lt;sonic-button
147
- size=&quot;sm&quot;
148
- variant=&quot;outline&quot;
149
- onclick=&quot;(function () {
150
- var host = document.getElementById(&#39;sonic-image-transition-host&#39;);
151
- var img = document.createElement(&#39;sonic-image&#39;);
152
- img.transition = &#39;fade-scale-out&#39;;
153
- img.ratio = &#39;1/1&#39;;
154
- img.rounded = &#39;md&#39;;
155
- img.loading = &#39;eager&#39;;
156
- img.style.width = &#39;8rem&#39;;
157
- img.src = &#39;https://picsum.photos/seed/&#39; + Date.now() + &#39;/120/120&#39;;
158
- host.appendChild(img);
159
- })()&quot;
160
102
  &gt;
161
- Add image (fade-scale-out)
162
- &lt;/sonic-button&gt;
163
- &lt;sonic-button
164
- size=&quot;sm&quot;
165
- variant=&quot;ghost&quot;
166
- onclick=&quot;document.getElementById(&#39;sonic-image-transition-host&#39;).replaceChildren()&quot;
167
- &gt;
168
- Clear
169
- &lt;/sonic-button&gt;
103
+ &lt;/sonic-image&gt;
170
104
  &lt;/div&gt;
171
- &lt;div id=&quot;sonic-image-transition-host&quot; class=&quot;flex flex-wrap gap-2 min-h-[5rem]&quot;&gt;&lt;/div&gt;
172
- </code></pre>
173
- <h2 id="accessibility-and-parts">Accessibility and parts</h2>
174
- <p>Always set meaningful <strong><code>alt</code></strong> text (empty string only for decorative images). </p>
175
- <pre><code>&lt;sonic-image
176
- rounded=&quot;md&quot;
177
- ratio=&quot;16/9&quot;
178
- alt=&quot;Concorde aircraft in flight&quot;
179
- src=&quot;https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg&quot;
180
- &gt;&lt;/sonic-image&gt;
181
105
  </code></pre>
182
- <h2 id="api-reference">API reference</h2>
183
- <table>
184
- <thead>
185
- <tr>
186
- <th>Attribute</th>
187
- <th>Values</th>
188
- <th>Description</th>
189
- </tr>
190
- </thead>
191
- <tbody><tr>
192
- <td><code>src</code></td>
193
- <td>URL</td>
194
- <td>Image URL passed to <code>&lt;img src&gt;</code></td>
195
- </tr>
196
- <tr>
197
- <td><code>alt</code></td>
198
- <td>string</td>
199
- <td>Accessible description; use <code>&quot;&quot;</code> only for decorative images</td>
200
- </tr>
201
- <tr>
202
- <td><code>loading</code></td>
203
- <td><code>lazy</code> (default), <code>eager</code></td>
204
- <td>Native lazy loading</td>
205
- </tr>
206
- <tr>
207
- <td><code>ratio</code></td>
208
- <td>CSS ratio, <code>auto</code> (default)</td>
209
- <td>Host <code>aspect-ratio</code> on the image (ignored when <code>cover</code> is set)</td>
210
- </tr>
211
- <tr>
212
- <td><code>rounded</code></td>
213
- <td><code>none</code> (default), boolean, <code>base</code>, <code>sm</code>, <code>md</code>, <code>lg</code>, <code>xl</code>, <code>full</code></td>
214
- <td>Corner radius from theme tokens; <code>full</code> is a circle (often with <code>ratio=&quot;1/1&quot;</code>)</td>
215
- </tr>
216
- <tr>
217
- <td><code>objectPosition</code></td>
218
- <td>CSS position</td>
219
- <td>Maps to <code>object-position</code> (default <code>center center</code>)</td>
220
- </tr>
221
- <tr>
222
- <td><code>imageRendering</code></td>
223
- <td>CSS value</td>
224
- <td>Maps to <code>image-rendering</code> (default <code>auto</code>)</td>
225
- </tr>
226
- <tr>
227
- <td><code>cover</code></td>
228
- <td>boolean</td>
229
- <td>Absolutely fills a positioned parent; host aspect ratio is ignored</td>
230
- </tr>
231
- <tr>
232
- <td><code>transition</code></td>
233
- <td><code>fade</code>, <code>fade-scale-out</code></td>
234
- <td>Opacity (and scale) animation after <code>load</code>; remount to replay on <code>src</code> change</td>
235
- </tr>
236
- </tbody></table>
237
- <p>No slots — content is driven entirely by attributes on the inner <code>&lt;img&gt;</code>.</p>
238
- <h2 id="api-reference-1">API reference</h2>
239
- <table>
240
- <thead>
241
- <tr>
242
- <th>Attribute</th>
243
- <th>Values</th>
244
- <th>Description</th>
245
- </tr>
246
- </thead>
247
- <tbody><tr>
248
- <td><code>src</code></td>
249
- <td>URL</td>
250
- <td>Image URL passed to <code>&lt;img src&gt;</code></td>
251
- </tr>
252
- <tr>
253
- <td><code>alt</code></td>
254
- <td>string</td>
255
- <td>Accessible description; use <code>&quot;&quot;</code> only for decorative images</td>
256
- </tr>
257
- <tr>
258
- <td><code>loading</code></td>
259
- <td><code>lazy</code> (default), <code>eager</code></td>
260
- <td>Native lazy loading</td>
261
- </tr>
262
- <tr>
263
- <td><code>ratio</code></td>
264
- <td>CSS ratio, <code>auto</code> (default)</td>
265
- <td>Host <code>aspect-ratio</code> on the image (ignored when <code>cover</code> is set)</td>
266
- </tr>
267
- <tr>
268
- <td><code>rounded</code></td>
269
- <td><code>none</code> (default), boolean, <code>base</code>, <code>sm</code>, <code>md</code>, <code>lg</code>, <code>xl</code>, <code>full</code></td>
270
- <td>Corner radius from theme tokens; <code>full</code> is a circle (often with <code>ratio=&quot;1/1&quot;</code>)</td>
271
- </tr>
272
- <tr>
273
- <td><code>objectPosition</code></td>
274
- <td>CSS position</td>
275
- <td>Maps to <code>object-position</code> (default <code>center center</code>)</td>
276
- </tr>
277
- <tr>
278
- <td><code>imageRendering</code></td>
279
- <td>CSS value</td>
280
- <td>Maps to <code>image-rendering</code> (default <code>auto</code>)</td>
281
- </tr>
282
- <tr>
283
- <td><code>cover</code></td>
284
- <td>boolean</td>
285
- <td>Absolutely fills a positioned parent; host aspect ratio is ignored</td>
286
- </tr>
287
- <tr>
288
- <td><code>transition</code></td>
289
- <td><code>fade</code>, <code>fade-scale-out</code></td>
290
- <td>Opacity (and scale) animation after <code>load</code>; remount to replay on <code>src</code> change</td>
291
- </tr>
292
- </tbody></table>
293
- <p>No slots — content is driven entirely by attributes on the inner <code>&lt;img&gt;</code>.</p>
294
106
 
295
107
  </article>
296
108
  </main>
@@ -4,8 +4,8 @@
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
6
  <title>Link — Concorde</title>
7
- <meta name="description" content="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 ">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/ui/link/link, link, Link, UI component, sonic-link, web component, href, pushstate, autoActive, active, target=&quot;_blank&quot;, rel=&quot;noopener noreferrer&quot;, partial">
7
+ <meta name="description" content="Link: Basic link with href attibute">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/link/link, link, Link, UI component, sonic-link, web component">
9
9
  <meta name="concorde-doc-id" content="core/components/ui/link/link">
10
10
  <link rel="canonical" href="https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html">
11
11
  </head>
@@ -15,84 +15,26 @@
15
15
  </header>
16
16
  <main>
17
17
  <article>
18
- <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Link</strong>. 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 <span>Doc ID: <code>core/components/ui/link/link</code>. Keywords: Concorde, supersoniks, core/components/ui/link/link, link, Link, UI component, sonic-link, web component, href, pushstate, autoActive, active, target=&quot;_blank&quot;, rel=&quot;noopener noreferrer&quot;, partial. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html">https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html</a>.</span></p>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Link</strong>. Link: Basic link with href attibute <span>Doc ID: <code>core/components/ui/link/link</code>. Keywords: Concorde, supersoniks, core/components/ui/link/link, link, Link, UI component, sonic-link, web component. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html">https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html</a>.</span></p>
19
19
  <h1 id="link">Link</h1>
20
- <p>Links <strong>navigate</strong> with inherited typography: internal routes, anchors, or external URLs. The default slot is the anchor label. For in-app routing, pair <strong><code>href</code></strong> with <strong><code>pushstate</code></strong>; use <strong><code>autoActive</code></strong> to reflect the current URL on the host (<code>active</code>).</p>
21
- <h2 id="basic-example">Basic example</h2>
22
- <pre><code>&lt;sonic-link href=&quot;/&quot;&gt;Basic link with href attribute&lt;/sonic-link&gt;
20
+ <h2 id="href">Href</h2>
21
+ <pre><code>&lt;sonic-link href=&quot;/&quot;&gt;Basic link with href attibute&lt;/sonic-link&gt;
23
22
  </code></pre>
24
23
  <h2 id="target">Target</h2>
25
- <p><strong><code>target=&quot;_blank&quot;</code></strong> opens a new browsing context and sets <strong><code>rel=&quot;noopener noreferrer&quot;</code></strong>.</p>
26
- <pre><code>&lt;sonic-link href=&quot;/&quot; target=&quot;_blank&quot;&gt;Link with target attribute&lt;/sonic-link&gt;
27
- </code></pre>
28
- <h2 id="pushstate">Pushstate</h2>
29
- <p>Set <strong><code>pushstate</code></strong> on same-origin <strong><code>href</code></strong> values to intercept clicks and navigate through Concorde’s client router without a full reload.</p>
30
- <pre><code>&lt;sonic-link href=&quot;/#core/components&quot; pushstate&gt;Client navigation (pushstate)&lt;/sonic-link&gt;
24
+ <pre><code>&lt;sonic-link href=&quot;/&quot; target=&quot;_blank&quot;&gt;Link with target attibute&lt;/sonic-link&gt;
31
25
  </code></pre>
32
26
  <h2 id="autoactive">AutoActive</h2>
33
- <p>Default <strong><code>autoActive</code></strong> is <strong><code>partial</code></strong>: the host gets <strong><code>active</code></strong> when the current URL starts with <strong><code>href</code></strong>. Style with <strong><code>[&amp;[active]]:</code></strong> utilities or host selectors.</p>
34
- <pre><code>&lt;sonic-link href=&quot;/#core/components&quot; class=&quot;[&amp;[active]]:text-success&quot;&gt;autoActive partial (default)&lt;/sonic-link&gt;
27
+ <pre><code>&lt;sonic-link href=&quot;/#core/components&quot; class=&quot;[&amp;[active]]:text-success&quot;&gt;autoActive partial (default)&lt;/sonic-link&gt;
35
28
  </code></pre>
36
- <h3 id="autoactive-strict-vs-partial">AutoActive strict vs partial</h3>
37
- <p><strong><code>strict</code></strong> requires pathname, search, and hash to match. <strong><code>strict-path-only</code></strong> matches pathname and hash but ignores search.</p>
29
+ <h3 id="autoactive-strict-vs-partial">AutoActive Strict vs partial</h3>
38
30
  <pre><code>&lt;div class=&quot;grid gap-3&quot;&gt;
39
31
  &lt;sonic-link href=&quot;/#core&quot; autoActive=&quot;strict&quot; class=&quot;[&amp;[active]]:text-success&quot;&gt;autoActive strict&lt;/sonic-link&gt;
40
- &lt;sonic-link href=&quot;/./link.html#link&quot; autoActive=&quot;strict&quot; class=&quot;[&amp;[active]]:text-success&quot;&gt;autoActive strict (long href)&lt;/sonic-link&gt;
41
- &lt;sonic-link href=&quot;/#core/components&quot; autoActive=&quot;strict-path-only&quot; class=&quot;[&amp;[active]]:text-success&quot;&gt;autoActive strict-path-only&lt;/sonic-link&gt;
32
+ &lt;sonic-link href=&quot;/./link.html#link&quot; autoActive=&quot;strict&quot; class=&quot;[&amp;[active]]:text-success&quot;&gt;autoActive strict&lt;/sonic-link&gt;
42
33
  &lt;/div&gt;
43
34
  </code></pre>
44
35
  <h3 id="autoactive-disabled">AutoActive disabled</h3>
45
36
  <pre><code>&lt;sonic-link href=&quot;/./link.html#link&quot; autoActive=&quot;disabled&quot; class=&quot;[&amp;[active]]:text-success&quot;&gt;autoActive disabled&lt;/sonic-link&gt;
46
37
  </code></pre>
47
- <h2 id="accessibility">Accessibility</h2>
48
- <p>The inner <strong><code>&lt;a&gt;</code></strong> uses <strong><code>focus-visible</code></strong> outline styling. Set <strong><code>data-aria-label</code></strong> when the slot text is not sufficient on its own.</p>
49
- <h2 id="api-reference">API reference</h2>
50
- <table>
51
- <thead>
52
- <tr>
53
- <th>Attribute</th>
54
- <th>Values</th>
55
- <th>Description</th>
56
- </tr>
57
- </thead>
58
- <tbody><tr>
59
- <td><code>href</code></td>
60
- <td>URL</td>
61
- <td>Link target; without <strong><code>href</code></strong>, only the slot is rendered (no <strong><code>&lt;a&gt;</code></strong>)</td>
62
- </tr>
63
- <tr>
64
- <td><code>target</code></td>
65
- <td>e.g. <code>_blank</code></td>
66
- <td>Navigation target; <strong><code>_blank</code></strong> adds <strong><code>rel=&quot;noopener noreferrer&quot;</code></strong></td>
67
- </tr>
68
- <tr>
69
- <td><code>pushstate</code></td>
70
- <td>boolean</td>
71
- <td>Intercepts click for Concorde client navigation without reload</td>
72
- </tr>
73
- <tr>
74
- <td><code>autoActive</code></td>
75
- <td><code>partial</code> (default) · <code>strict</code> · <code>strict-path-only</code> · <code>disabled</code></td>
76
- <td>When the host gets the <strong><code>active</code></strong> attribute (same-origin <strong><code>href</code></strong> only)</td>
77
- </tr>
78
- <tr>
79
- <td><code>data-aria-label</code></td>
80
- <td>string</td>
81
- <td>Accessible <strong><code>aria-label</code></strong> when the slot text is not enough</td>
82
- </tr>
83
- </tbody></table>
84
- <table>
85
- <thead>
86
- <tr>
87
- <th>Slot</th>
88
- <th>Description</th>
89
- </tr>
90
- </thead>
91
- <tbody><tr>
92
- <td><em>(default)</em></td>
93
- <td>Link content (text, icons)</td>
94
- </tr>
95
- </tbody></table>
96
38
 
97
39
  </article>
98
40
  </main>
@@ -4,8 +4,8 @@
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
6
  <title>Loader — Concorde</title>
7
- <meta name="description" content="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">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/ui/loader/loader, loader, Loader, UI component, sonic-loader, web component, mode, fixed, inline, noDelay, sonic-fetch, sonic-list, currentColor">
7
+ <meta name="description" content="import {Loader} from &quot;@supersoniks/concorde/core/components/ui/loader/loader&quot;;">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/loader/loader, loader, Loader, UI component, sonic-loader, web component">
9
9
  <meta name="concorde-doc-id" content="core/components/ui/loader/loader">
10
10
  <link rel="canonical" href="https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html">
11
11
  </head>
@@ -15,108 +15,34 @@
15
15
  </header>
16
16
  <main>
17
17
  <article>
18
- <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Loader</strong>. 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 <span>Doc ID: <code>core/components/ui/loader/loader</code>. Keywords: Concorde, supersoniks, core/components/ui/loader/loader, loader, Loader, UI component, sonic-loader, web component, mode, fixed, inline, noDelay, sonic-fetch, sonic-list, currentColor. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html">https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html</a>.</span></p>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Loader</strong>. import {Loader} from &quot;@supersoniks/concorde/core/components/ui/loader/loader&quot;; <span>Doc ID: <code>core/components/ui/loader/loader</code>. Keywords: Concorde, supersoniks, core/components/ui/loader/loader, loader, Loader, UI component, sonic-loader, web component. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html">https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html</a>.</span></p>
19
19
  <h1 id="loader">Loader</h1>
20
- <p><strong><code>sonic-loader</code></strong> shows a loading animation in the page or as a viewport overlay. Default <strong><code>mode</code></strong> is <strong><code>fixed</code></strong> (centered overlay). Use <strong><code>inline</code></strong> inside lists and fetch placeholders. Pair <strong><code>noDelay</code></strong> when the spinner should appear without the default fade-in wait. For <strong><code>sonic-fetch</code></strong> / <strong><code>sonic-list</code></strong>, set the parent <strong><code>loader</code></strong> attribute instead of embedding a tag manually.</p>
21
- <h2 id="basic-example">Basic example</h2>
22
- <p>Inline loaders fit content areas; they use the theme primary color unless <strong><code>currentColor</code></strong> is set.</p>
20
+ <h2 id="inline-mode">Inline mode</h2>
23
21
  <pre><code>&lt;sonic-loader mode=&quot;inline&quot;&gt;&lt;/sonic-loader&gt;
24
22
  </code></pre>
25
- <h2 id="mode">Mode</h2>
26
- <p><strong><code>inline</code></strong> — ellipsis animation in the document flow. <strong><code>fixed</code></strong> — centered overlay (<code>position: fixed</code>); default when the tag is omitted.</p>
27
- <pre><code>&lt;sonic-loader mode=&quot;inline&quot;&gt;&lt;/sonic-loader&gt;
28
- </code></pre>
29
- <p>Use the checkbox below to toggle a <strong><code>fixed</code></strong> loader over the page (default <strong><code>mode</code></strong> on <strong><code>sonic-loader</code></strong>).</p>
30
- <p><docs-lit-demo for="docs-toggle-loader-demo"></docs-lit-demo></p>
31
- <h2 id="inline-alignment-and-color">Inline alignment and color</h2>
32
- <p><strong><code>align</code></strong> only affects <strong><code>mode=&quot;inline&quot;</code></strong>: <strong><code>left</code></strong> · <strong><code>center</code></strong> (default) · <strong><code>right</code></strong>. Set <strong><code>currentColor</code></strong> so dots follow the host <code>color</code> (for example on a purple parent).</p>
33
- <pre><code>&lt;div class=&quot;grid gap-4&quot;&gt;
34
- &lt;sonic-loader mode=&quot;inline&quot; currentColor style=&quot;color: purple;&quot;&gt;&lt;/sonic-loader&gt;
35
- &lt;div class=&quot;flex flex-col gap-2&quot;&gt;
36
- &lt;sonic-loader mode=&quot;inline&quot; align=&quot;left&quot;&gt;&lt;/sonic-loader&gt;
37
- &lt;sonic-loader mode=&quot;inline&quot; align=&quot;center&quot;&gt;&lt;/sonic-loader&gt;
38
- &lt;sonic-loader mode=&quot;inline&quot; align=&quot;right&quot;&gt;&lt;/sonic-loader&gt;
39
- &lt;/div&gt;
40
- &lt;/div&gt;
41
- </code></pre>
42
- <h2 id="nodelay"><code>noDelay</code></h2>
43
- <p>By default <strong><code>mode=&quot;fixed&quot;</code></strong> waits briefly before fading in. <strong><code>mode=&quot;inline&quot;</code></strong> already skips that wait. Set <strong><code>noDelay</code></strong> on <strong><code>fixed</code></strong> (or pass <strong><code>noDelay: true</code></strong> to <strong><code>Loader.show()</code></strong>) to appear immediately.</p>
44
- <pre><code>&lt;sonic-loader mode=&quot;inline&quot; noDelay&gt;&lt;/sonic-loader&gt;
23
+ <h2 id="currentcolor">CurrentColor</h2>
24
+ <pre><code>&lt;sonic-loader mode=&quot;inline&quot; currentColor style=&quot;color:purple;&quot;&gt;&lt;/sonic-loader&gt;
45
25
  </code></pre>
46
- <h2 id="accessibility-announce">Accessibility (<code>announce</code>)</h2>
47
- <p>The animation is <strong><code>aria-hidden</code></strong> by default so screen readers are not spammed on every fetch. Set <strong><code>announce</code></strong> when the loader is injected <strong>after</strong> user action (for example a global overlay): the host gets <strong><code>role=&quot;status&quot;</code></strong>, <strong><code>aria-live=&quot;polite&quot;</code></strong>, and a localized <strong><code>aria-label</code></strong> (“Loading” / “Chargement en cours”, …). For in-button loading, prefer <strong><code>sonic-button</code></strong> <strong><code>loading</code></strong> and <strong><code>aria-busy</code></strong> on the control—not on the loader.</p>
48
- <pre><code>&lt;sonic-loader mode=&quot;inline&quot; announce&gt;&lt;/sonic-loader&gt;
26
+ <h2 id="align">Align</h2>
27
+ <pre><code>&lt;sonic-loader mode=&quot;inline&quot; align=&quot;left&quot;&gt;&lt;/sonic-loader&gt;
28
+ &lt;sonic-loader mode=&quot;inline&quot; align=&quot;center&quot;&gt;&lt;/sonic-loader&gt;
29
+ &lt;sonic-loader mode=&quot;inline&quot; align=&quot;right&quot;&gt;&lt;/sonic-loader&gt;
49
30
  </code></pre>
50
- <h2 id="show-and-hide-programmatically">Show and hide programmatically</h2>
51
- <p>Import <strong><code>Loader</code></strong> and call <strong><code>Loader.show()</code></strong> / <strong><code>Loader.hide()</code></strong>. <strong><code>hide()</code></strong> is reference-counted: call it once per <strong><code>show()</code></strong>. With no <strong><code>container</code></strong>, the loader is appended to the theme pop container and <strong><code>mode</code></strong> is always <strong><code>fixed</code></strong>. Pass <strong><code>container</code></strong> and <strong><code>mode: &quot;inline&quot;</code></strong> to mount an inline instance in a specific element.</p>
52
- <pre><code class="language-javascript">import { Loader } from &quot;@supersoniks/concorde/core/components/ui/loader/loader&quot;;
53
-
54
- Loader.show({
55
- mode: &quot;fixed&quot;,
56
- noDelay: false,
57
- announce: true,
58
- container: document.querySelector(&quot;#foo&quot;),
59
- });
60
-
61
- Loader.hide();
31
+ <h2 id="fixed-mode">Fixed mode</h2>
32
+ <p><docs-lit-demo for="docs-toggle-loader-demo"></docs-lit-demo></p>
33
+ <h2 id="loading-button">Loading button</h2>
34
+ <pre><code>&lt;sonic-button loading&gt;A loading button&lt;/sonic-button&gt;
62
35
  </code></pre>
63
- <h2 id="composition">Composition</h2>
64
- <p><strong><code>sonic-button</code></strong> <strong><code>loading</code></strong> shows an icon spinner and sets <strong><code>aria-busy</code></strong> on the button. <strong><code>sonic-fetch</code></strong> and <strong><code>sonic-list</code></strong> render <strong><code>sonic-loader</code></strong> when their <strong><code>loader</code></strong> attribute is set: <strong><code>true</code></strong> or an empty string maps to <strong><code>fixed</code></strong>; otherwise use <strong><code>inline</code></strong> or <strong><code>fixed</code></strong>.</p>
65
- <pre><code>&lt;sonic-button loading&gt;Save changes&lt;/sonic-button&gt;
36
+ <h2 id="hide--show-programmatically">Hide / show programmatically</h2>
37
+ <pre><code class="language-javascript">import {Loader} from &quot;@supersoniks/concorde/core/components/ui/loader/loader&quot;;
38
+ // Show
39
+ Loader.show({
40
+ mode:&quot;fixed&quot; // optional : fixed | inline
41
+ container : document.querySelector(&#39;#foo&#39;) // optional, default : parent sonic-theme || document.body
42
+ });
43
+ // Hide
44
+ Loader.hide();
66
45
  </code></pre>
67
- <h2 id="api-reference">API reference</h2>
68
- <table>
69
- <thead>
70
- <tr>
71
- <th>Attribute</th>
72
- <th>Values</th>
73
- <th>Description</th>
74
- </tr>
75
- </thead>
76
- <tbody><tr>
77
- <td><code>mode</code></td>
78
- <td><code>inline</code> · <code>fixed</code> (default <code>fixed</code>)</td>
79
- <td>Layout: in-flow ellipsis vs viewport-centered overlay</td>
80
- </tr>
81
- <tr>
82
- <td><code>noDelay</code></td>
83
- <td>boolean</td>
84
- <td>Skips the initial fade-in delay before the animation appears</td>
85
- </tr>
86
- <tr>
87
- <td><code>announce</code></td>
88
- <td>boolean</td>
89
- <td><strong><code>role=&quot;status&quot;</code></strong> and <strong><code>aria-live=&quot;polite&quot;</code></strong> with localized loading label when the loader should be announced</td>
90
- </tr>
91
- <tr>
92
- <td><code>align</code></td>
93
- <td><code>left</code> · <code>center</code> · <code>right</code></td>
94
- <td>Horizontal alignment for <strong><code>mode=&quot;inline&quot;</code></strong> only (attribute selector; default centered)</td>
95
- </tr>
96
- <tr>
97
- <td><code>currentColor</code></td>
98
- <td>boolean</td>
99
- <td>Uses <code>currentColor</code> for dot fill instead of <strong><code>--sc-primary</code></strong></td>
100
- </tr>
101
- </tbody></table>
102
- <p>This component has <strong>no slots</strong>. The animation markup is internal.</p>
103
- <h3 id="static-methods">Static methods</h3>
104
- <table>
105
- <thead>
106
- <tr>
107
- <th>Method</th>
108
- <th>Description</th>
109
- </tr>
110
- </thead>
111
- <tbody><tr>
112
- <td><code>Loader.show(conf?)</code></td>
113
- <td>Mounts the shared loader instance. <strong><code>conf.mode</code></strong>, <strong><code>conf.noDelay</code></strong>, <strong><code>conf.announce</code></strong>, optional <strong><code>conf.container</code></strong>. Without <strong><code>container</code></strong>, uses the theme pop container and forces <strong><code>fixed</code></strong>.</td>
114
- </tr>
115
- <tr>
116
- <td><code>Loader.hide()</code></td>
117
- <td>Decrements the show counter and removes the instance from the DOM when it reaches zero.</td>
118
- </tr>
119
- </tbody></table>
120
46
 
121
47
  </article>
122
48
  </main>