@skerbis/nativecss 0.0.0-stage → 1.2.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 (192) hide show
  1. package/CHANGELOG.md +61 -0
  2. package/LICENSE +28 -0
  3. package/README.md +145 -2
  4. package/dist/base.css +225 -0
  5. package/dist/browser-fixes.css +32 -0
  6. package/dist/colors.css +288 -0
  7. package/dist/components/accordion-split.css +269 -0
  8. package/dist/components/alert.css +179 -0
  9. package/dist/components/app-shell.css +266 -0
  10. package/dist/components/audio-player.css +697 -0
  11. package/dist/components/audio.css +35 -0
  12. package/dist/components/aurora.css +132 -0
  13. package/dist/components/avatar.css +102 -0
  14. package/dist/components/back-to-top.css +120 -0
  15. package/dist/components/backdrop.css +94 -0
  16. package/dist/components/badge.css +95 -0
  17. package/dist/components/breadcrumb.css +58 -0
  18. package/dist/components/card.css +721 -0
  19. package/dist/components/code-block.css +234 -0
  20. package/dist/components/combobox.css +103 -0
  21. package/dist/components/command-palette.css +351 -0
  22. package/dist/components/comments.css +243 -0
  23. package/dist/components/compare.css +218 -0
  24. package/dist/components/count-up.css +140 -0
  25. package/dist/components/countdown.css +74 -0
  26. package/dist/components/cover.css +45 -0
  27. package/dist/components/curtain.css +116 -0
  28. package/dist/components/dialog-close.css +44 -0
  29. package/dist/components/disclosure.css +37 -0
  30. package/dist/components/downloads.css +47 -0
  31. package/dist/components/dropdown.css +260 -0
  32. package/dist/components/dropzone.css +181 -0
  33. package/dist/components/effects.css +236 -0
  34. package/dist/components/empty-state.css +74 -0
  35. package/dist/components/events.css +165 -0
  36. package/dist/components/expand-panels.css +220 -0
  37. package/dist/components/filter.css +179 -0
  38. package/dist/components/floating-label.css +69 -0
  39. package/dist/components/footer.css +56 -0
  40. package/dist/components/hero.css +139 -0
  41. package/dist/components/hovercard.css +146 -0
  42. package/dist/components/input-group.css +67 -0
  43. package/dist/components/kbd.css +44 -0
  44. package/dist/components/leaders.css +99 -0
  45. package/dist/components/lightbox.css +165 -0
  46. package/dist/components/lists.css +221 -0
  47. package/dist/components/livesearch.css +106 -0
  48. package/dist/components/map.css +245 -0
  49. package/dist/components/marginnote.css +109 -0
  50. package/dist/components/marquee.css +119 -0
  51. package/dist/components/modal.css +385 -0
  52. package/dist/components/morph.css +317 -0
  53. package/dist/components/nav-drilldown.css +190 -0
  54. package/dist/components/nav-priority.css +157 -0
  55. package/dist/components/nav.css +600 -0
  56. package/dist/components/notification.css +290 -0
  57. package/dist/components/off-canvas.css +107 -0
  58. package/dist/components/overlay.css +122 -0
  59. package/dist/components/pagination.css +139 -0
  60. package/dist/components/pill-group.css +143 -0
  61. package/dist/components/placeholder.css +28 -0
  62. package/dist/components/preferences-fonts.css +65 -0
  63. package/dist/components/preferences.css +283 -0
  64. package/dist/components/pricing.css +220 -0
  65. package/dist/components/rating.css +121 -0
  66. package/dist/components/reveal-pin.css +165 -0
  67. package/dist/components/roadmap.css +173 -0
  68. package/dist/components/scroll-frames.css +97 -0
  69. package/dist/components/scroll-horizontal.css +141 -0
  70. package/dist/components/scroll-progress.css +63 -0
  71. package/dist/components/scroll-stack.css +363 -0
  72. package/dist/components/scroll-video.css +172 -0
  73. package/dist/components/scrolly.css +190 -0
  74. package/dist/components/search.css +52 -0
  75. package/dist/components/segmented.css +209 -0
  76. package/dist/components/select.css +186 -0
  77. package/dist/components/slideshow.css +441 -0
  78. package/dist/components/sortable.css +186 -0
  79. package/dist/components/sparkline.css +50 -0
  80. package/dist/components/spinner.css +50 -0
  81. package/dist/components/split.css +85 -0
  82. package/dist/components/spotlight.css +111 -0
  83. package/dist/components/stat.css +82 -0
  84. package/dist/components/stepper.css +217 -0
  85. package/dist/components/subnav.css +151 -0
  86. package/dist/components/table-sort.css +111 -0
  87. package/dist/components/tabs.css +304 -0
  88. package/dist/components/tag.css +130 -0
  89. package/dist/components/testimonial.css +188 -0
  90. package/dist/components/text-reveal.css +141 -0
  91. package/dist/components/theme-toggle.css +62 -0
  92. package/dist/components/tile.css +53 -0
  93. package/dist/components/timeline.css +211 -0
  94. package/dist/components/toolbar.css +139 -0
  95. package/dist/components/tooltip.css +89 -0
  96. package/dist/components/topbar.css +92 -0
  97. package/dist/components/video-bg.css +176 -0
  98. package/dist/components/video-card.css +145 -0
  99. package/dist/components/video-float.css +142 -0
  100. package/dist/components/video-player.css +1116 -0
  101. package/dist/components/video-text.css +91 -0
  102. package/dist/components/video.css +65 -0
  103. package/dist/fonts/README.md +29 -0
  104. package/dist/fonts/atkinson-hyperlegible-next/OFL.txt +93 -0
  105. package/dist/fonts/atkinson-hyperlegible-next/atkinson-hyperlegible-next.woff2 +0 -0
  106. package/dist/fonts/lexend/OFL.txt +93 -0
  107. package/dist/fonts/lexend/lexend.woff2 +0 -0
  108. package/dist/fonts/opendyslexic/OFL.txt +94 -0
  109. package/dist/fonts/opendyslexic/OpenDyslexic-Bold.woff2 +0 -0
  110. package/dist/fonts/opendyslexic/OpenDyslexic-Regular.woff2 +0 -0
  111. package/dist/helpers/a11y.css +71 -0
  112. package/dist/helpers/animations.css +206 -0
  113. package/dist/helpers/elevation.css +87 -0
  114. package/dist/helpers/float.css +135 -0
  115. package/dist/helpers/forms.css +503 -0
  116. package/dist/helpers/icons.css +130 -0
  117. package/dist/helpers/layout.css +549 -0
  118. package/dist/helpers/media.css +77 -0
  119. package/dist/helpers/reveal.css +172 -0
  120. package/dist/helpers/scroll-shadow.css +129 -0
  121. package/dist/helpers/scroll.css +163 -0
  122. package/dist/helpers/surfaces.css +87 -0
  123. package/dist/helpers/tables.css +85 -0
  124. package/dist/helpers/typography.css +347 -0
  125. package/dist/helpers/visibility.css +134 -0
  126. package/dist/integrations/fontawesome-font-display-fix.css +67 -0
  127. package/dist/integrations/webawesome-bridge.css +195 -0
  128. package/dist/js/audio-player.js +942 -0
  129. package/dist/js/backdrop.js +119 -0
  130. package/dist/js/code-block.js +238 -0
  131. package/dist/js/combobox.js +382 -0
  132. package/dist/js/command-fallback.js +35 -0
  133. package/dist/js/command-palette.js +477 -0
  134. package/dist/js/compare.js +73 -0
  135. package/dist/js/content-observer.js +82 -0
  136. package/dist/js/count-up.js +150 -0
  137. package/dist/js/countdown.js +185 -0
  138. package/dist/js/dialog-light-dismiss.js +123 -0
  139. package/dist/js/dismiss.js +144 -0
  140. package/dist/js/downloads.js +181 -0
  141. package/dist/js/dropdown.js +300 -0
  142. package/dist/js/dropzone.js +304 -0
  143. package/dist/js/events.js +501 -0
  144. package/dist/js/filter.js +177 -0
  145. package/dist/js/hero-video-motion.js +37 -0
  146. package/dist/js/hide-on-scroll-fallback.js +102 -0
  147. package/dist/js/hovercard.js +228 -0
  148. package/dist/js/icon.js +166 -0
  149. package/dist/js/ics.js +290 -0
  150. package/dist/js/lightbox.js +144 -0
  151. package/dist/js/livesearch.js +253 -0
  152. package/dist/js/map.js +625 -0
  153. package/dist/js/marquee.js +108 -0
  154. package/dist/js/modal-router.js +298 -0
  155. package/dist/js/nav-drilldown.js +250 -0
  156. package/dist/js/nav-priority.js +221 -0
  157. package/dist/js/nav.js +242 -0
  158. package/dist/js/ncss-container.js +117 -0
  159. package/dist/js/notification.js +372 -0
  160. package/dist/js/page-transitions-quiet.js +44 -0
  161. package/dist/js/preferences-early.js +51 -0
  162. package/dist/js/preferences.js +346 -0
  163. package/dist/js/reveal.js +79 -0
  164. package/dist/js/scroll-frames.js +284 -0
  165. package/dist/js/scroll-horizontal.js +121 -0
  166. package/dist/js/scroll-stack-fallback.js +250 -0
  167. package/dist/js/scroll-video.js +332 -0
  168. package/dist/js/scrolly.js +109 -0
  169. package/dist/js/slideshow.js +416 -0
  170. package/dist/js/sortable.js +530 -0
  171. package/dist/js/sparkline.js +199 -0
  172. package/dist/js/spotlight.js +104 -0
  173. package/dist/js/subnav.js +163 -0
  174. package/dist/js/table-sort.js +312 -0
  175. package/dist/js/tabs.js +243 -0
  176. package/dist/js/text-reveal.js +108 -0
  177. package/dist/js/theme-toggle-early.js +28 -0
  178. package/dist/js/theme-toggle.js +135 -0
  179. package/dist/js/toolbar.js +130 -0
  180. package/dist/js/tooltip.js +214 -0
  181. package/dist/js/video-bg.js +193 -0
  182. package/dist/js/video-card.js +80 -0
  183. package/dist/js/video-float.js +119 -0
  184. package/dist/js/video-player.js +1267 -0
  185. package/dist/js/view-transitions.js +118 -0
  186. package/dist/js/wa-close-on-scroll.js +56 -0
  187. package/dist/ncss.css +165 -0
  188. package/dist/page-transitions.css +150 -0
  189. package/dist/reset.css +196 -0
  190. package/dist/theme.css +112 -0
  191. package/dist/tokens.css +238 -0
  192. package/package.json +52 -4
@@ -0,0 +1,347 @@
1
+ /**
2
+ * ncss - Typografie-Helper (Layer "helpers"). Ergänzt base.css um Klassen für Fälle, in
3
+ * denen ein Tag allein nicht reicht (z.B. Text in einer Komponente, der wie h3 aussehen
4
+ * soll, ohne semantisch eine Überschrift zu sein).
5
+ */
6
+
7
+ .ncss-text-sm { font-size: var(--ncss-font-size-sm); }
8
+ .ncss-text-base { font-size: var(--ncss-font-size-base); }
9
+ .ncss-text-md { font-size: var(--ncss-font-size-md); }
10
+ .ncss-text-lg { font-size: var(--ncss-font-size-lg); }
11
+ .ncss-text-xl { font-size: var(--ncss-font-size-xl); }
12
+
13
+ /* Teaser-/Lead-Absatz (der erste, etwas größere Absatz unter einer Überschrift/einem
14
+ Artikel-Intro) - bislang in jeder Demo lokal neu erfunden (.demo-lead in magazine.html,
15
+ .landing-hero-lead in landing.html jeweils nur font-size/max-width, ohne die passende
16
+ Textfarbe) - jetzt eine Klasse, die beides zusammen richtig setzt. */
17
+ .ncss-text-lead {
18
+ font-size: var(--ncss-font-size-md);
19
+ line-height: var(--ncss-line-height-base);
20
+ color: var(--ncss-color-text-muted);
21
+ }
22
+
23
+ /* Derselbe linke Akzent-Rahmen + Einzug wie <blockquote> (base.css), als ZUSÄTZLICHE
24
+ Klasse statt eigenem Element - für einen Lead-Absatz, der optisch wie ein Zitat wirken
25
+ soll, aber KEIN echtes Zitat ist (ein <blockquote> wäre hier semantisch falsch, siehe
26
+ MDN). Rahmenfarbe folgt currentColor statt einem festen Token, passt sich dadurch
27
+ automatisch an jede Textfarbe an, in der sie gerade verwendet wird (auch auf farbigen
28
+ Flächen, siehe index.html). Meist mit .ncss-text-lead kombiniert: class="ncss-text-lead
29
+ ncss-lead-quote". */
30
+ .ncss-lead-quote {
31
+ border-inline-start: 0.25rem solid color-mix(in srgb, currentColor 55%, transparent);
32
+ padding-inline-start: var(--ncss-space-sm);
33
+ }
34
+
35
+ /* `-on-soft` statt der rohen Basisfarbe (User-Report: Lighthouse-Kontrast-Warnung,
36
+ diesmal an einer Vergleichstabelle auf product.html - "grüne Schrift auf grau",
37
+ `.ncss-text-success` um ein `<code>` in einer Tabellenzelle auf `.landing-section--
38
+ tinted`/`--ncss-color-bg-subtle`). Dieselbe Diagnose wie bei `.ncss-eyebrow` und den
39
+ Prism-`.token.*`-Farben (siehe dortige Kommentare für die ausführliche Begründung):
40
+ eine Basisfarbe ist nur in IHRER kalibrierten Kombination sicher kontrastreich, nicht
41
+ automatisch auch als freistehender Text auf einer hellen Fläche. Diese sechs Klassen
42
+ sind laut eigener Doku (siehe `.ncss-text-inherit` direkt darunter) für GENAU diesen
43
+ Fall gedacht - Text auf einer normalen Seiten-/Karten-Fläche, NICHT auf einer bereits
44
+ farbigen Surface (dafür gibt es `.ncss-surface--*` + `.ncss-text-inherit`) - `-on-soft`
45
+ ist also nicht nur ein Kontrast-Patch, sondern das eigentlich zu dieser Verwendung
46
+ passende Token. */
47
+ .ncss-text-muted { color: var(--ncss-color-text-muted); }
48
+ .ncss-text-brand { color: var(--ncss-color-brand-on-soft); }
49
+ .ncss-text-brand-2 { color: var(--ncss-color-brand-2-on-soft); }
50
+ .ncss-text-neutral { color: var(--ncss-color-neutral-on-soft); }
51
+ .ncss-text-success { color: var(--ncss-color-success-on-soft); }
52
+ .ncss-text-warning { color: var(--ncss-color-warning-on-soft); }
53
+ .ncss-text-danger { color: var(--ncss-color-danger-on-soft); }
54
+ /* Für Text auf einer farbigen Fläche (z.B. .ncss-surface--brand) - übernimmt die dort
55
+ bereits passend gesetzte Kontrastfarbe, statt sie ein zweites Mal zu benennen. */
56
+ .ncss-text-inherit { color: inherit; }
57
+
58
+ /* --- Erzwungener heller/dunkler Text (UIkit uk-light/uk-dark-Pendant) ----------------------
59
+ Für Text auf einer Fläche, deren Farbe NICHT über ncss' Theme-Tokens läuft (Foto,
60
+ Video-Poster, ein beliebiger fester Hintergrund) - anders als .ncss-scheme-dark/-light
61
+ (helpers/surfaces.css), die das GESAMTE light-dark()-Tokensystem für einen Teilbaum
62
+ umschalten (color-scheme + alle davon abhängigen Tokens), setzt diese Familie NUR die
63
+ Textfarbe fest auf Weiß/Schwarz, unabhängig vom Theme der restlichen Seite.
64
+
65
+ -100/-300/-700/-900 folgen derselben Richtung wie die Farbskala in colors.css (100 =
66
+ dezent, 900 = kräftig) - hier als Deckkraft-Stufen von Weiß/Schwarz statt als Farbton-
67
+ Mischung, weil Weiß/Schwarz selbst schon die hellst-/dunkelstmögliche Stufe sind (kein
68
+ "helleres Weiß" denkbar, wie es color-mix() gegen weiß bei den Marken-Skalen erreicht).
69
+ Bare .ncss-text-light/-dark (ohne Zahl) = die volle, deckende Stufe (== -900) - der
70
+ Alltagsfall, keine Zahl nötig.
71
+
72
+ .ncss-text-light/-dark (NUR die beiden Basis-Klassen, nicht die Zwischenstufen - die
73
+ umschließen in der Praxis keine ganzen Formulare) sind zusätzlich an
74
+ webawesome-bridge.css angebunden ("Formular-Text auf farbigen Flächen") - ein
75
+ <wa-input> INNERHALB eines .ncss-text-light-Elements zeigt Label/Wert/Hinweistext
76
+ ebenfalls korrekt hell, nicht nur gewöhnlicher Light-DOM-Text (Shadow DOM erbt
77
+ color:#fff sonst nicht, siehe Bridge-Kommentar für die Details). */
78
+ .ncss-text-light,
79
+ .ncss-text-light-900 {
80
+ color: #fff;
81
+ }
82
+ .ncss-text-light-700 {
83
+ color: color-mix(in srgb, #fff 85%, transparent);
84
+ }
85
+ .ncss-text-light-300 {
86
+ color: color-mix(in srgb, #fff 60%, transparent);
87
+ }
88
+ .ncss-text-light-100 {
89
+ color: color-mix(in srgb, #fff 35%, transparent);
90
+ }
91
+
92
+ .ncss-text-dark,
93
+ .ncss-text-dark-900 {
94
+ color: #000;
95
+ }
96
+ .ncss-text-dark-700 {
97
+ color: color-mix(in srgb, #000 85%, transparent);
98
+ }
99
+ .ncss-text-dark-300 {
100
+ color: color-mix(in srgb, #000 60%, transparent);
101
+ }
102
+ .ncss-text-dark-100 {
103
+ color: color-mix(in srgb, #000 35%, transparent);
104
+ }
105
+
106
+ .ncss-text-center { text-align: center; }
107
+ .ncss-text-start { text-align: start; }
108
+ .ncss-text-end { text-align: end; }
109
+ /* Blocksatz - in der Praxis fast immer mit .ncss-hyphenate kombinieren, sonst reißt
110
+ Justify-Text in schmalen Spalten hässliche Wortzwischenräume auf. */
111
+ .ncss-text-justify { text-align: justify; }
112
+
113
+ .ncss-text-balance { text-wrap: balance; }
114
+ .ncss-text-pretty { text-wrap: pretty; }
115
+
116
+ /* --- Laufweite (letter-spacing, "tracking") ----------------------------------------------
117
+ em-basierte Tokens (tokens.css) statt fixer px-Werte - skaliert automatisch mit der
118
+ jeweiligen Schriftgröße statt bei großen Überschriften zu eng oder bei kleinem Text zu
119
+ weit zu wirken. -tight eignet sich meist nur für große, fette Headlines (in Fließtext auf
120
+ Kosten der Lesbarkeit), -wide/-wider klassisch für SCHMALE VERSALIEN-Kapitälchen/Eyebrows. */
121
+ .ncss-tracking-tight { letter-spacing: var(--ncss-tracking-tight); }
122
+ .ncss-tracking-normal { letter-spacing: var(--ncss-tracking-normal); }
123
+ .ncss-tracking-wide { letter-spacing: var(--ncss-tracking-wide); }
124
+ .ncss-tracking-wider { letter-spacing: var(--ncss-tracking-wider); }
125
+ .ncss-tracking-widest { letter-spacing: var(--ncss-tracking-widest); }
126
+
127
+ /* Eyebrow/Kicker - das kleine, versal gesetzte Label ÜBER einer Überschrift ("Typografie"
128
+ über "Fließtext, der mitdenkt", siehe demo/magazine.html). War bislang nur eine
129
+ Kombination aus drei Klassen + einer lokalen font-weight-Regel pro Demo (.demo-eyebrow)
130
+ - hier als EINE Klasse, die für sich allein reicht.
131
+ `--ncss-color-brand-on-soft` statt der rohen `--ncss-color-brand` (User-Report samt
132
+ Lighthouse-Befund: "Background and foreground colors do not have a sufficient
133
+ contrast ratio") - die rohe Markenfarbe ist nur GARANTIERT kontrastreich in DER
134
+ Kombination, für die ein Projekt sie kalibriert (typischerweise heller Text AUF der
135
+ Markenfarbe als Fläche, siehe theme.css) - als kleiner, semibold gesetzter TEXT auf
136
+ einer hellen Fläche ist das eine andere, ungeprüfte Kombination. Per echtem Test auf
137
+ diesem Projekt selbst gefunden: dessen eigene, bewusst zurückhaltende Grau-Markenfarbe
138
+ (`#6f6f6e`, siehe theme.css - kalibriert für Weiß-auf-Marke, nicht Marke-auf-Weiß) lag
139
+ als `.ncss-eyebrow`-Text auf `--ncss-color-bg-subtle` bei 4.49:1 - hauchdünn UNTER der
140
+ 4.5:1-Grenze für normalen Fließtext. `-on-soft` ist genau für diesen Fall gedacht
141
+ (siehe colors.css: eine automatisch abgeleitete, dunklere -700-Stufe im Light Mode) -
142
+ kein Problem der Komponente an sich, sondern das falsche der mehreren vorhandenen
143
+ Marken-Farbtokens für einen freistehenden Text-auf-Fläche-Fall. */
144
+ .ncss-eyebrow {
145
+ display: block;
146
+ font-size: var(--ncss-font-size-sm);
147
+ font-weight: var(--ncss-font-weight-semibold);
148
+ text-transform: uppercase;
149
+ letter-spacing: var(--ncss-tracking-wider);
150
+ color: var(--ncss-color-brand-on-soft);
151
+ }
152
+
153
+ .ncss-truncate {
154
+ overflow: hidden;
155
+ text-overflow: ellipsis;
156
+ white-space: nowrap;
157
+ }
158
+
159
+ /* Mehrzeiliges Abschneiden - modernes CSS statt JS-Line-Clamping. */
160
+ .ncss-clamp-lines {
161
+ display: -webkit-box;
162
+ -webkit-box-orient: vertical;
163
+ -webkit-line-clamp: var(--ncss-clamp-lines, 3);
164
+ overflow: hidden;
165
+ }
166
+
167
+ /* --- Silbentrennung ---------------------------------------------------------------------
168
+ Braucht ein korrektes lang-Attribut (z.B. <html lang="de">) - der Browser wählt danach
169
+ das passende Trennwörterbuch. Bewusst opt-in statt globaler Default: sinnvoll für
170
+ schmale Spalten/Justify-Text, in normal breitem Fließtext meist unnötig/störend. */
171
+ .ncss-hyphenate {
172
+ hyphens: auto;
173
+ overflow-wrap: break-word;
174
+ }
175
+
176
+ /* --- Ziffern-Varianten (font-variant-numeric) --------------------------------------------
177
+ Wirkt nur, wenn die aktive Schrift die jeweilige OpenType-Feature unterstützt (tabular
178
+ figures / oldstyle figures) - sonst folgenlos, kein Fallback nötig. tabular-nums lohnt
179
+ sich für nebeneinander stehende Zahlen (Tabellen, Kennzahlen-Vergleiche), die sonst je
180
+ nach Ziffer unterschiedlich breit sind und "wackeln". */
181
+ .ncss-nums-tabular { font-variant-numeric: tabular-nums; }
182
+ .ncss-nums-oldstyle { font-variant-numeric: oldstyle-nums; }
183
+
184
+ /* --- Drop Cap (initial-letter) ------------------------------------------------------------
185
+ NICHT Baseline - Firefox hat es (Stand 2026) nie ausgeliefert (nur ein offenes
186
+ Implementation-Ticket). Chrome/Edge unterstützen die unpräfixte Eigenschaft seit 110,
187
+ Safari dagegen historisch nur -webkit-initial-letter - MDNs eigenes Beispiel deklariert
188
+ deshalb bewusst BEIDE Schreibweisen nebeneinander, das übernehmen wir hier genauso.
189
+ @supports prüft ebenfalls beide Varianten, sonst bliebe echtes Safari (das nur die
190
+ präfixte Eigenschaft kennt) fälschlich außen vor. Ohne jede Unterstützung (Firefox)
191
+ bleibt der erste Buchstabe schlicht normal groß, keine kaputte Darstellung, daher kein
192
+ extra Fallback-Code nötig. */
193
+ @supports (initial-letter: 3) or (-webkit-initial-letter: 3) {
194
+ .ncss-drop-cap::first-letter {
195
+ -webkit-initial-letter: 3;
196
+ initial-letter: 3;
197
+ font-weight: 700;
198
+ margin-inline-end: 0.1em;
199
+ }
200
+ /* Container-Intelligenz statt fixer Größe: in einem breiten Magazin-Layout darf der
201
+ Drop Cap deutlich größer/dramatischer wirken, in einer schmalen Sidebar/einem Embed
202
+ bleibt er zurückhaltender - reagiert auf den ELTERN-Container (nicht den Viewport,
203
+ dieselbe Konvention wie überall sonst in ncss), also auch korrekt in einer schmalen
204
+ Spalte innerhalb eines an sich breiten Viewports. */
205
+ /* -- ncss container-query: drop-cap-large (40rem) -- */
206
+ @container ncss-container (min-width: 40rem) {
207
+ .ncss-drop-cap::first-letter {
208
+ -webkit-initial-letter: 4;
209
+ initial-letter: 4;
210
+ }
211
+ }
212
+
213
+ /* --- Drop-Cap-Varianten ----------------------------------------------------------------
214
+ Zusätzlich zu .ncss-drop-cap, nicht statt dessen - z.B.
215
+ class="ncss-drop-cap ncss-drop-cap--sm ncss-drop-cap--light". Gleiche Selektor-
216
+ Spezifität wie die Basisregel, gewinnt also rein durch Deklarationsreihenfolge (steht
217
+ im Quelltext danach) - Kombinationsklassen statt eigenständiger Ersatzklassen, damit
218
+ Größe, Schnitt und Farbe unabhängig voneinander mischbar bleiben. */
219
+ .ncss-drop-cap--sm::first-letter {
220
+ -webkit-initial-letter: 2;
221
+ initial-letter: 2;
222
+ }
223
+ @container ncss-container (min-width: 40rem) {
224
+ .ncss-drop-cap--sm::first-letter {
225
+ -webkit-initial-letter: 3;
226
+ initial-letter: 3;
227
+ }
228
+ }
229
+ .ncss-drop-cap--lg::first-letter {
230
+ -webkit-initial-letter: 4;
231
+ initial-letter: 4;
232
+ }
233
+ @container ncss-container (min-width: 40rem) {
234
+ .ncss-drop-cap--lg::first-letter {
235
+ -webkit-initial-letter: 5;
236
+ initial-letter: 5;
237
+ }
238
+ }
239
+ /* Dünnere Schrift statt der fetten Standard-Initiale - z.B. für ein zurückhaltenderes,
240
+ eher serifenlos-elegantes statt plakatives Magazin-Layout. */
241
+ .ncss-drop-cap--light::first-letter {
242
+ font-weight: var(--ncss-font-weight-normal);
243
+ }
244
+ .ncss-drop-cap--brand::first-letter {
245
+ color: var(--ncss-color-brand);
246
+ }
247
+ }
248
+
249
+ /* --- Mehrspaltiger Fließtext (CSS Multicol) ------------------------------------------------
250
+ column-width statt fixer column-count - dieselbe "breakpointless"-Idee wie .ncss-masonry
251
+ (helpers/layout.css): die Spaltenzahl ergibt sich automatisch aus der verfügbaren Breite
252
+ DES ELEMENTS (nicht des Viewports - Multicol war schon immer "container-aware", ganz ohne
253
+ @container nötig), kein fester Umschaltpunkt. Override pro Instanz z.B. via
254
+ style="--ncss-columns-width: 16rem" für schmalere/mehr Spalten.
255
+ Markup: <div class="ncss-columns"><p>...</p><p>...</p></div> */
256
+ .ncss-columns {
257
+ column-width: var(--ncss-columns-width);
258
+ column-gap: var(--ncss-space-xl);
259
+ column-rule: var(--ncss-border-width) solid var(--ncss-color-border);
260
+ }
261
+ /* Überschriften/Pull-Quotes sollen über die volle Breite reichen, nicht in eine einzelne
262
+ schmale Spalte gequetscht werden - column-span:all ist dafür extra vorgesehen. */
263
+ .ncss-columns > h2,
264
+ .ncss-columns > h3,
265
+ .ncss-columns > .ncss-pull-quote {
266
+ column-span: all;
267
+ }
268
+ /* BEWUSST KEIN break-inside:avoid auf <p> - das war eine erste Fassung dieser Regel, per
269
+ echtem Screenshot als Fehler entlarvt: erzwingt es, dass ein Absatz NIE zwischen zwei
270
+ Spalten zerrissen wird, findet der Balance-Algorithmus oft keine gleich hohen Spalten
271
+ mehr (ein Absatz, der nicht mehr in den Rest einer Spalte passt, rutscht komplett in die
272
+ nächste - sichtbare Lücke am Ende der vorherigen Spalte, genau das Gegenteil von
273
+ "sauber"). Echte Zeitungs-/Magazin-Typografie lässt Absätze im Gegenteil ganz normal
274
+ über die Spaltengrenze laufen - vermieden wird dort nur eine einzelne verwaiste Zeile
275
+ (Schusterjunge/Hurenkind), nicht der Absatzbruch an sich. Das übernehmen `orphans`/
276
+ `widows` (Browser-Default meist bereits 2) von selbst, ohne dass wir hier eingreifen
277
+ müssen. */
278
+
279
+ /* --- Pull-Quote (auffällig hervorgehobenes Zitat, "Magazin"-Stil) --------------------------
280
+ Eigenständig nutzbar (nicht nur innerhalb .ncss-columns) - dort zusätzlich column-span:all
281
+ (siehe oben). Nutzt denselben Fließtext-Fluss wie <blockquote> in base.css, hier bewusst
282
+ deutlich größer/prominenter statt der dezenten Standard-Zitat-Optik. */
283
+ .ncss-pull-quote {
284
+ font-family: var(--ncss-font-family-heading);
285
+ font-size: var(--ncss-font-size-lg);
286
+ font-weight: 700;
287
+ line-height: var(--ncss-line-height-tight);
288
+ text-wrap: balance;
289
+ border-inline-start: none;
290
+ border-block: var(--ncss-border-width) solid var(--ncss-color-border);
291
+ padding-block: var(--ncss-space-sm);
292
+ margin-block: var(--ncss-space-md);
293
+ color: var(--ncss-color-text);
294
+ }
295
+
296
+ /* --- Variable Fonts -----------------------------------------------------------------------
297
+ ncss lädt standardmäßig KEINEN Variable Font (system-ui-Stack, siehe tokens.css) - dieser
298
+ Mechanismus ist die Vorbereitung für den Moment, wo pro Projekt einer eingebunden wird:
299
+ eine Custom Property statt einer festen font-weight-Zahl erlaubt Zwischenwerte (z.B. 550)
300
+ UND animierbare Gewichts-Übergänge (z.B. bei :hover) - mit normalem "font-weight" ist
301
+ Interpolation zwischen zwei Gewichten nicht möglich, mit font-variation-settings schon. */
302
+ .ncss-font-variable {
303
+ font-variation-settings: "wght" var(--ncss-font-weight-variable);
304
+ }
305
+
306
+ /* --- Geboxter Text (box-decoration-break) --------------------------------------------------
307
+ "Textmarker"-Optik über mehrere Zeilen hinweg, OHNE einen <span> pro Zeile - box-
308
+ decoration-break:clone lässt jede umgebrochene Zeile ihre EIGENE Hintergrund/Radius/
309
+ Padding-Box bekommen, statt einer einzigen Box um den ganzen (mehrzeiligen) Textblock.
310
+ Braucht display:inline (das Element muss selbst umbrechen können wie ein <span> in
311
+ Fließtext, nicht als eigener Block) - direkt auf eine Überschrift gesetzt reicht, kein
312
+ zusätzlicher Wrapper nötig, auch nicht pro Zeile.
313
+ NICHT Baseline: Safari unterstützt box-decoration-break für INLINE-Elemente (genau der
314
+ hier gebrauchte Fall) zuverlässig, aber nur mit der -webkit-Vorsilbe (per Recherche
315
+ geprüft, Chrome/Firefox unpräfixt) - deshalb beide Schreibweisen. Ohne jede Unterstützung
316
+ bleibt der Text normal lesbar, nur als EINE durchgehende Box statt einer Box pro Zeile -
317
+ kein kaputter Zustand.
318
+ line-height bewusst UNITLESS (nicht in rem/px) - skaliert automatisch mit der jeweiligen
319
+ Schriftgröße mit, bleibt so auch mit ncss' fluiden clamp()-Schriftgrößen korrekt (ein
320
+ fixer rem-Wert wäre nur für genau eine Schriftgröße richtig bemessen).
321
+ Default-Optik bewusst dunkel/theme-unabhängig (wie eine feste Marker-Farbe, ähnlich
322
+ .ncss-modal--dark) - für eine farbige Variante stattdessen mit .ncss-surface--brand/
323
+ -brand-2/-neutral kombinieren (überschreibt nur background-color/color, keine eigene
324
+ Farbvarianten-Matrix nötig).
325
+ ACHTUNG - NICHT als direktes Kind eines Flex-/Grid-Containers (z.B. .ncss-stack/
326
+ .ncss-cluster/.ncss-grid) einsetzen: Flex-/Grid-Items werden per Spec automatisch
327
+ "blockifiziert" - ein deklariertes display:inline wird dort zu display:block
328
+ umgerechnet (unabhängig von dieser Regel hier), box-decoration-break greift dann nicht
329
+ mehr sichtbar (eine einzige durchgehende Box statt einer pro Zeile, per echtem Test
330
+ bestätigt). In einem eigenen, nicht-flex/grid Wrapper (z.B. <div>) oder direkt in
331
+ normalem Fließtext-Kontext verwenden.
332
+ Markup: <div><h2 class="ncss-text-boxed">Zeile eins<br>Zeile zwei</h2></div> */
333
+ .ncss-text-boxed {
334
+ display: inline;
335
+ margin: 0;
336
+ -webkit-box-decoration-break: clone;
337
+ box-decoration-break: clone;
338
+ padding: 0.15em 0.4em;
339
+ border-radius: var(--ncss-radius-sm);
340
+ line-height: 1.4;
341
+ background-color: rgb(0 0 0 / 75%);
342
+ color: #fff;
343
+ }
344
+
345
+ /* Listen-Varianten (Punkt/Gedankenstrich/Icon/geteilt/Schritte/Definitionslisten) sind eine
346
+ eigene Komponente, nicht Teil dieser Typografie-Helper-Datei - siehe
347
+ components/lists.css. */
@@ -0,0 +1,134 @@
1
+ /**
2
+ * ncss - Sichtbarkeits-Helper (Layer "helpers"). Eigenständig statt in layout.css
3
+ * versteckt - das hier ist "zeig/verstecke dieses Element", kein Seiten-Layout. Für
4
+ * "für Screenreader unsichtbar, aber vorlesbar" siehe stattdessen helpers/a11y.css
5
+ * (.ncss-visually-hidden) - das ist konzeptionell etwas anderes als hier.
6
+ *
7
+ * Jedes display:none hier ist bewusst !important - die Layer-konforme Lösung, kein
8
+ * Spezifitäts-Kampf: eine Komponente/ein Helper mit eigenem display (.ncss-btn aus
9
+ * helpers/forms.css lädt im SELBEN Layer später, .ncss-card/.ncss-nav liegen im höheren
10
+ * Layer "components") gewann bisher gegen .ncss-hide-below-md & Co. (per Demo-Test
11
+ * gefunden: <a class="ncss-btn ncss-hide-below-md"> blieb mobil sichtbar). Wichtige
12
+ * Deklarationen kehren die Layer-Reihenfolge um - ein !important im Layer "helpers"
13
+ * schlägt jede normale Regel aller Layer und jede wichtige Regel der späteren Layer.
14
+ * Ein Verstecken-Helper soll genau das: immer verstecken, egal welche Komponente das
15
+ * Element sonst ist. Funktioniert identisch, wenn diese Datei einzeln (Cherry-Picking) in
16
+ * einem beliebigen Layer oder unlayered eingebunden wird - keine Abhängigkeit von der
17
+ * Layer-Reihenfolge in ncss.css. Gilt NUR für display:none, nicht für .ncss-invisible/
18
+ * .ncss-reveal-on-hover (opacity/visibility, kein Konflikt mit Komponenten-display).
19
+ */
20
+
21
+ .ncss-hidden {
22
+ display: none !important;
23
+ }
24
+
25
+ /* Nimmt weiterhin Platz im Layout ein (anders als .ncss-hidden) - für Fälle, in denen
26
+ Auf-/Zuklappen keinen Sprung im umgebenden Layout verursachen soll. */
27
+ .ncss-invisible {
28
+ visibility: hidden;
29
+ }
30
+
31
+ /* Nur beim Drucken sichtbar/unsichtbar. Bewusst KEIN "display: revert/revert-layer" zum
32
+ Wiederherstellen (unvorhersehbarer UA-Display-Default je nach Elementtyp - dieselbe
33
+ Begründung wie beim Breakpoint-Escape-Hatch in helpers/layout.css). Stattdessen je
34
+ Klasse nur EIN display:none in der jeweils GEGENTEILIGEN Medienbedingung - im
35
+ "sichtbaren" Medium greift einfach das normale display des Elements/der Komponente
36
+ (früher erzwang print display:block, das machte ein inline/flex-Element beim Drucken
37
+ zum Block). */
38
+ @media not print {
39
+ .ncss-print-only {
40
+ display: none !important;
41
+ }
42
+ }
43
+ @media print {
44
+ .ncss-screen-only {
45
+ display: none !important;
46
+ }
47
+ }
48
+
49
+ /* Nur bei :hover/:focus-within des Elternelements sichtbar (z.B. Card-Aktionen, die erst
50
+ bei Interaktion erscheinen) - opacity statt display, damit Transition + Tastatur-Fokus
51
+ (:focus-within statt nur :hover) funktionieren. */
52
+ .ncss-reveal-on-hover {
53
+ opacity: 0;
54
+ transition: opacity var(--ncss-motion-duration) var(--ncss-motion-easing);
55
+ pointer-events: none;
56
+ }
57
+ :hover > .ncss-reveal-on-hover,
58
+ :focus-within > .ncss-reveal-on-hover {
59
+ opacity: 1;
60
+ pointer-events: auto;
61
+ }
62
+ /* Reine Hover-Geräte (Maus/Trackpad): bei Touch bliebe .ncss-reveal-on-hover sonst
63
+ dauerhaft unsichtbar, da es dort kein echtes :hover gibt - ohne diese Abfrage würde das
64
+ Element auf Touch-Geräten nie erreichbar. */
65
+ @media (hover: none) {
66
+ .ncss-reveal-on-hover {
67
+ opacity: 1;
68
+ pointer-events: auto;
69
+ }
70
+ }
71
+
72
+ /**
73
+ * --- Klassischer Escape Hatch: feste Viewport-Breakpoints (siehe tokens.css für die
74
+ * Werte) --------------------------------------------------------------------------------
75
+ * Nur benutzen, wenn ein echter, fester Sprung nötig ist (z.B. Navigation), nicht als
76
+ * Standardweg für responsive Layouts - dafür immer zuerst .ncss-grid/Container Queries
77
+ * (helpers/layout.css) erwägen.
78
+ */
79
+ /* Bewusst KEIN "display: revert" zum Zurücksetzen (unterschiedliche UA-Display-Defaults
80
+ je Element, hier nicht vorhersehbar - siehe uikit_theme_builder diese Session, wo genau
81
+ das per echtem Playwright-Test als unsicher bestätigt wurde). Stattdessen zwei
82
+ eigenständige Klassen, je eine pro Richtung. */
83
+ /* -- ncss breakpoint: md (768px) -- */
84
+ @media (max-width: 767px) {
85
+ .ncss-hide-below-md {
86
+ display: none !important;
87
+ }
88
+ }
89
+ @media (min-width: 768px) {
90
+ .ncss-hide-from-md {
91
+ display: none !important;
92
+ }
93
+ }
94
+
95
+ /* --- Container-basierte Sichtbarkeit ----------------------------------------------------
96
+ Wie .ncss-hide-below-md/-from-md oben, aber reagiert auf die Breite des ELTERN-CONTAINERS
97
+ (nächster Vorfahre mit container-name: ncss-container, siehe .ncss-container in
98
+ layout.css), nicht auf den Viewport - dieselbe Karte zeigt/versteckt ein Element je
99
+ nach eigener Spaltenbreite, unabhängig davon, wie breit der Bildschirm gerade ist (z.B.
100
+ eine Sidebar-Variante vs. Hauptspalten-Variante derselben Komponente). Dieselben vier
101
+ Schwellenwerte wie .ncss-grid--cols-2/3/4/6 (24/36/48/56rem) - ein Projekt, das sich an
102
+ diese Zahlen schon gewöhnt hat, muss sich keine zweite Reihe merken. Genau dasselbe
103
+ Zwei-Klassen-Muster wie beim Viewport-Pendant oben (KEIN "revert" zum Zurücksetzen,
104
+ unvorhersehbarer UA-Display-Default je Elementtyp) - zwei eigenständige Klassen, je
105
+ Richtung, jede nur innerhalb ihrer eigenen @container-Bedingung unconditional
106
+ display:none, nie ein- und wieder ausgeschaltet. */
107
+ /* -- ncss container-query: ncss-container, sm (24rem) -- */
108
+ @container ncss-container (max-width: 23.99rem) {
109
+ .ncss-hide-below-container-sm { display: none !important; }
110
+ }
111
+ @container ncss-container (min-width: 24rem) {
112
+ .ncss-hide-from-container-sm { display: none !important; }
113
+ }
114
+ /* -- ncss container-query: ncss-container, md (36rem) -- */
115
+ @container ncss-container (max-width: 35.99rem) {
116
+ .ncss-hide-below-container-md { display: none !important; }
117
+ }
118
+ @container ncss-container (min-width: 36rem) {
119
+ .ncss-hide-from-container-md { display: none !important; }
120
+ }
121
+ /* -- ncss container-query: ncss-container, lg (48rem) -- */
122
+ @container ncss-container (max-width: 47.99rem) {
123
+ .ncss-hide-below-container-lg { display: none !important; }
124
+ }
125
+ @container ncss-container (min-width: 48rem) {
126
+ .ncss-hide-from-container-lg { display: none !important; }
127
+ }
128
+ /* -- ncss container-query: ncss-container, xl (56rem) -- */
129
+ @container ncss-container (max-width: 55.99rem) {
130
+ .ncss-hide-below-container-xl { display: none !important; }
131
+ }
132
+ @container ncss-container (min-width: 56rem) {
133
+ .ncss-hide-from-container-xl { display: none !important; }
134
+ }
@@ -0,0 +1,67 @@
1
+ /**
2
+ * NativeCSS - Font-Display-Fix für Font Awesome (vendor/fontawesome/, NICHT selbst
3
+ * angefasst - siehe unten für die Begründung). Eigene, OPT-IN Datei (wie theme.css/
4
+ * page-transitions.css) - NACH vendor/fontawesome/css/all.min.css laden.
5
+ *
6
+ * Lighthouse-Audit "Ensure text remains visible during webfont load" (User-Report):
7
+ * Font Awesomes eigene @font-face-Regeln setzen `font-display: block` - kein FEHLENDER
8
+ * Wert (der Default wäre `auto`, von Lighthouse ebenfalls bemängelt), sondern eine
9
+ * BEWUSSTE Entscheidung der Bibliothek selbst, nur eben eine, die Lighthouse als
10
+ * suboptimal einstuft. `swap`/`optional` sind Lighthouses eigene Empfehlung.
11
+ *
12
+ * `swap` NICHT gewählt: für ein Icon-Font ist ein sofortiger Fallback-Glyph oft eine
13
+ * FALSCHE/fehlende Glyphe (kein Icon oder ein Tofu-Kästchen) für die Dauer des Ladens,
14
+ * bis der echte Font eintrifft ("Flash of wrong/missing icon") - schlechter als das
15
+ * kurze Unsichtbar-Fenster von `block`. `optional` stattdessen: kurzes Lade-Fenster
16
+ * (~100ms Spec-Minimum), danach entweder der fertige Font ODER der Browser gibt auf und
17
+ * zeigt dauerhaft den Fallback, OHNE beliebig lang auf ein langsames Netz zu warten -
18
+ * bei einem bereits gecachten Font (jeder wiederkehrende Besuch) macht das ohnehin
19
+ * keinen Unterschied, der Font steht sofort bereit.
20
+ *
21
+ * ERSTER Versuch (verworfen): dieselben drei @font-face-Deskriptoren (Familie/Gewicht/
22
+ * Quelle) unter IDENTISCHEM Namen erneut deklarieren, nur mit anderem font-display -
23
+ * per Recherche widerlegt, BEVOR es ausgeliefert wurde: zwei @font-face-Regeln mit
24
+ * exakt gleicher Familie/Gewicht/Stil bilden KEIN "letzte Regel gewinnt"-Override,
25
+ * sondern eine "Composite Face" - der Browser wählt zwischen den Kandidaten anhand der
26
+ * tatsächlichen Zeichenabdeckung (unicode-range), nicht per Ladereihenfolge. Per echtem
27
+ * Playwright-Test bestätigt: `document.fonts` enthielt danach BEIDE Einträge
28
+ * gleichzeitig (den alten `block`- UND den neuen `optional`-Eintrag) - welcher davon
29
+ * tatsächlich das Lade-Timing bestimmt, ist damit nicht zuverlässig steuerbar.
30
+ *
31
+ * ENDGÜLTIGER Fix: Font Awesomes eigene CSS setzt `font-family` nie hart, sondern über
32
+ * die Custom Properties `--fa-family-classic`/`--fa-family-brands` (per Sichtprüfung im
33
+ * Vendor-Code bestätigt: `.fas,.fa-classic{--fa-family:var(--fa-family-classic)}` usw.,
34
+ * die eigentliche Regel konsumiert das über `font-family:var(--_fa-family)`). Hier
35
+ * werden GENAU diese beiden Custom Properties auf zwei neue, ausschließlich von dieser
36
+ * Datei definierte Familiennamen umgebogen - jeweils NUR EIN @font-face pro Familie/
37
+ * Gewicht, keine Namenskollision mit Font Awesomes eigenen Regeln, dadurch auch keine
38
+ * Composite-Face-Mehrdeutigkeit mehr möglich. Unlayered (wie theme.css) gewinnt
39
+ * automatisch gegen die gelayerte Vendor-CSS, kein !important/höhere Spezifität nötig.
40
+ */
41
+ @font-face {
42
+ font-family: "NativeCSS Font Awesome Brands";
43
+ font-style: normal;
44
+ font-weight: 400;
45
+ font-display: optional;
46
+ src: url("../../vendor/fontawesome/webfonts/fa-brands-400.woff2") format("woff2");
47
+ }
48
+ @font-face {
49
+ font-family: "NativeCSS Font Awesome Classic";
50
+ font-style: normal;
51
+ font-weight: 400;
52
+ font-display: optional;
53
+ src: url("../../vendor/fontawesome/webfonts/fa-regular-400.woff2") format("woff2");
54
+ }
55
+ @font-face {
56
+ font-family: "NativeCSS Font Awesome Classic";
57
+ font-style: normal;
58
+ font-weight: 900;
59
+ font-display: optional;
60
+ src: url("../../vendor/fontawesome/webfonts/fa-solid-900.woff2") format("woff2");
61
+ }
62
+
63
+ :root,
64
+ :host {
65
+ --fa-family-classic: "NativeCSS Font Awesome Classic";
66
+ --fa-family-brands: "NativeCSS Font Awesome Brands";
67
+ }