@skerbis/nativecss 0.0.0-stage → 1.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 (192) hide show
  1. package/CHANGELOG.md +38 -0
  2. package/LICENSE +28 -0
  3. package/README.md +144 -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 +528 -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 +117 -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 +28 -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
package/CHANGELOG.md ADDED
@@ -0,0 +1,38 @@
1
+ # Changelog
2
+
3
+ Alle nennenswerten Änderungen an NativeCSS. Versionierung nach [Semantic Versioning](https://semver.org/lang/de/).
4
+
5
+ ## [1.1.0] - 2026-11-20
6
+
7
+ ### Neu
8
+
9
+ - **Scroll-Effekte:** Curtain-Sektionen, Horizontal-Scroll (Tastaturfokus scrollt mit), Text-Reveal, Scrollytelling `<ncss-scrolly>`, Count-up, Marquee, Reveal-Formen (Kreis, Wipe, Split, Zoom, Expand …), Reveal-Pin und Morphing beim Scrollen (großes Bild/Video schrumpft an den Rand und macht Platz für Text, auch als Karte oder Kreis) - nativ über `view()`-Timelines, kleine JS-Fallbacks nur wo nötig.
10
+ - **Moderne UI:** Bento-Raster, Spotlight, Vorher/Nachher-Vergleich `<ncss-compare>`, Aufklapp-Panels, Befehlspalette `<ncss-command-palette>`, Hovercards `<ncss-hovercard>`, Benachrichtigungen `<ncss-toast-region>` / `ncss.notify()` mit gestapeltem Modus, Aurora- und Mesh-Hintergründe.
11
+ - **Video & Audio:** `<ncss-video-player>` und `<ncss-audio-player>` aus einem Guss (Kapitel, Playlist, Untertitel, Geschwindigkeit, Bild-in-Bild, Media Session, Tastatur), scroll-gesteuertes Video `<ncss-scroll-video>` und Bildsequenz `<ncss-scroll-frames>`, Hintergrundvideo für beliebige Sektionen (mit Pause-Knopf, WCAG 2.2.2), Video im Text, Mini-Player `<ncss-video-float>`, Vorschau-Karten.
12
+ - **Karten** `<ncss-map>` (MapLibre GL): Proxy-Adressen für Stil, Kacheln, Schriften und Symbole (Präfix oder `{url}`-Vorlage) - Besucher haben keinen Kontakt zu Dritten; Zwei-Klick-Modus, lädt erst in Sichtweite, Fallback ohne JS, Dunkelmodus, 3D-Ansicht.
13
+ - **Karten-Komponente ausgebaut:** ganze Karte als Link (innere Buttons bleiben bedienbar), Bild-Overlay, Seitenverhältnisse, Zoom, Auswahl-Karten (Radio/Checkbox), hervorgehobene, deaktivierte und Akzent-Karten, Kopf mit Aktionen, Meta-Zeile, Karten-Raster mit Subgrid, Lade-Skelett.
14
+ - **Morphing beim Scrollen** `.ncss-morph`: großes Bild/Video schrumpft zur Seite und macht Platz für Text (auch umgekehrt, Karte, Kreis) - reines CSS, statisches Endbild als Fallback.
15
+ - **Neue Bausteine:** Dropdown/Aktionsmenü `<ncss-dropdown>` (APG Menu Button oder Link-Liste), Tabellen-Sortierung `<ncss-table-sort>`, sortierbare Liste `<ncss-sortable>` (Maus, Touch, Tastatur, Hoch/Runter-Knöpfe), Slideshow-Pfeile und -Punkte (nativ per `::scroll-button`/`::scroll-marker`, sonst `<ncss-slideshow>`), Filter-Raster `.ncss-filter` (reines CSS, optional `<ncss-filter>`), Scroll-Schatten `.ncss-scroll-shadow`, Zeitleiste und Stepper, Kundenstimmen und Preistabellen, Leader-Linien, Kommentare, Pillen-Gruppe `.ncss-pill-group`, Toolbar `<ncss-toolbar>` mit Split-Button, Modus-Umschalter `.ncss-segmented--pill`.
16
+ - **Animationen:** Tabs mit gleitendem Unterstrich, Pillen und Panel-Übergängen (`animate="fade slide scale height"`), gleitende Auswahl in `.ncss-segmented--slide`; alles aus bei reduzierter Bewegung.
17
+ - **Buttons:** `--pill`, `--ghost`.
18
+ - **Akzent-Balken** statt dicker Randkanten an abgerundeten Karten, Hinweisen und Kommentaren.
19
+ - **Darstellungs-Einstellungen** `<ncss-preferences>`: Besucher wählen Farbschema, Kontrast, Bewegung, Schriftgröße, Textabstände, Link-Unterstreichung, Fokus-Rahmen und lesbare Schriften (Atkinson Hyperlegible Next, Lexend, OpenDyslexic, selbst gehostet) - kein „Overlay“, sondern Anpassung einer bereits barrierefreien Seite.
20
+ - **Icons:** 52 Kern-Icons per Klasse, alle Phosphor-Icons per `<ncss-icon>`, Sprite-Builder.
21
+ - **Dialoge** schließen standardmäßig beim Klick daneben (`closedby="any"`, abschaltbar).
22
+ - **Abschnitts-Navigation** (`subnav`): klebende „Auf dieser Seite“-Leiste mit automatischer Hervorhebung.
23
+ - **Neu-Markierung** `.ncss-badge-dot`.
24
+
25
+ ### Website & Werkzeuge
26
+
27
+ - Website komplett neu: eine generierte Shell für Start, Handbuch und Beispiele, Suche (⌘K), Code-Inspektor mit Erklärungen, Live-Beispiele direkt im Handbuch, neue Beispiel-Websites (Gemeinde, Hotel, ImmoDesk-Backend), Tour durch alle Funktionen, Impressum und Datenschutz, „Unterstützen“ in der Kopfleiste.
28
+ - Lokaler Entwicklungs-Router `docs-src/dev-router.php` mit Range-Support für Video/Audio.
29
+ - Veröffentlichung bei npm (`npm i @skerbis/nativecss`) zusätzlich zu Kopieren und CDN - weiterhin ohne Build-Schritt nutzbar.
30
+
31
+ ### Konventionen
32
+
33
+ - Eigene Events heißen einheitlich `ncss-<komponente>-<aktion>`.
34
+ - Jede neue Komponente ist einzeln einbindbar (nur `colors`/`tokens`/`reset`/`base` nötig).
35
+
36
+ ## [1.0.0]
37
+
38
+ Erster öffentlicher Stand von NativeCSS.
package/LICENSE ADDED
@@ -0,0 +1,28 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Thomas Skerbis (https://github.com/skerbis)
4
+ Contributors: KLXM Crossmedia GmbH (https://klxm.de)
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in all
14
+ copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.
23
+
24
+ ---
25
+
26
+ This project bundles third-party assets under their own licenses:
27
+ - vendor/fontawesome/ - Font Awesome Free (see vendor/fontawesome/LICENSE.txt)
28
+ - vendor/webawesome/ - Web Awesome (see vendor/webawesome/LICENSE.md)
package/README.md CHANGED
@@ -1,3 +1,145 @@
1
- # Temporary Holding Version
1
+ <picture>
2
+ <source media="(prefers-color-scheme: dark)" srcset="demo/assets/brand/banner-dark.webp">
3
+ <img src="demo/assets/brand/banner-light.webp" alt="NativeCSS – CSS, das der Browser schon kann. Designsystem aus reinem, modernem CSS, barrierefrei von Grund auf." width="1280">
4
+ </picture>
2
5
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
6
+ # NativeCSS
7
+
8
+ *(Klassen-Präfix im Code: `ncss`)*
9
+
10
+ Ein natives CSS-Designsystem ohne Build-Schritt. Kein LESS/Sass, kein Bundler, kein
11
+ Preprocessor. `@import` und CSS Cascade Layers regeln die Ladereihenfolge, ein einziges
12
+ Token-System ist die Quelle aller Werte. Typografie und Abstände sind **fließend**
13
+ (`clamp()`), Komponenten reagieren über **Container Queries** auf ihren Platz statt auf
14
+ Viewport-Breakpoints. **Barrierefreiheit ist in jedem Baustein eingebaut**, nicht nachgerüstet.
15
+
16
+ **[Website](https://skerbis.github.io/nativecss/) · [Handbuch](https://skerbis.github.io/nativecss/docs/de/index.html) · [Tour durch alle Funktionen](https://skerbis.github.io/nativecss/demo/showcase/index.html) · [Beispiele](https://skerbis.github.io/nativecss/docs/de/examples.html) · [Changelog](CHANGELOG.md)**
17
+
18
+ ## Worum es geht
19
+
20
+ Die meisten CSS-Frameworks lösen Probleme, die der Browser inzwischen selbst löst.
21
+ NativeCSS baut konsequent auf diese Plattform-Fähigkeiten, statt sie nachzubauen:
22
+
23
+ - **Cascade Layers statt Spezifitäts-Kämpfe.** Eine `@layer`-Deklaration legt die
24
+ Reihenfolge fest - kein `!important`-Wettrüsten.
25
+ - **Container Queries statt Breakpoint-Wildwuchs.** Eine Komponente sieht in einer
26
+ Seitenleiste und im Hauptbereich jeweils passend aus.
27
+ - **`light-dark()` statt zweitem Dark-Stylesheet.** Ein Wert pro Token für Hell und Dunkel.
28
+ - **Native Elemente statt JS-Nachbauten:** `<dialog>`, `<details>`, Popover API, Anchor
29
+ Positioning, Scroll-driven Animations, View Transitions.
30
+ - **Web Components nur, wo Verhalten nötig ist** - als Light-DOM-Elemente
31
+ (`<ncss-video-player>`, `<ncss-tabs>`, `<ncss-map>` …), ohne Abhängigkeiten, in jedem
32
+ Framework nutzbar.
33
+ - **Cherry-Picking.** Jede Komponente ist eine eigene Datei und braucht nur die Basis
34
+ (Farben, Tokens, Reset, Base) - nicht benötigte `@import`-Zeilen einfach löschen.
35
+
36
+ ## Barrierefreiheit
37
+
38
+ Grundlage für Websites nach WCAG 2.2 AA (und damit für das BFSG):
39
+
40
+ - sichtbarer Fokus überall, Tastaturbedienung nach dem WAI-ARIA Authoring Practices Guide,
41
+ - kontrastsichere Farb-Tokens in Hell und Dunkel,
42
+ - Nutzer-Einstellungen werden respektiert: reduzierte Bewegung, mehr Kontrast, Forced Colors,
43
+ 200 % Zoom und Textabstände,
44
+ - **`<ncss-preferences>`**: Besucher stellen Farbschema, Kontrast, Bewegung, Schriftgröße
45
+ und lesbare Schriften (Atkinson Hyperlegible Next, Lexend, OpenDyslexic, selbst gehostet)
46
+ selbst ein - kein „Overlay“, das Fehler überdeckt, sondern Anpassung einer bereits
47
+ barrierefreien Seite,
48
+ - funktioniert ohne JavaScript - Skripte verbessern nur.
49
+
50
+ NativeCSS hilft, barrierefreie Websites zu bauen; konform wird eine Website erst durch
51
+ Inhalt und Umsetzung. Das Handbuch enthält dazu Kapitel zu Tastatur, Screenreadern,
52
+ Formularen, Medien, Tests, eine WCAG-Checkliste und eine Vorlage für die
53
+ Barrierefreiheitserklärung.
54
+
55
+ ## Was drin ist
56
+
57
+ - **Grundlagen:** Tokens, Farben mit Stufen, fließende Typografie, Icons (52 Kern-Icons
58
+ per Klasse, alle Phosphor-Icons per `<ncss-icon>`, Sprite-Builder).
59
+ - **Layout:** Container, Stack, Cluster, Grid, Bento, Masonry, Ausbrechen (Bleed), Float,
60
+ Sticky, Landingpage-Bausteine (Split, Tile, Preistabellen, Kundenstimmen).
61
+ - **Inhalt:** Karten (Overlay, Auswahl-Karten, Raster mit Subgrid, Skelett), Listen,
62
+ Leader-Linien, Tabellen (sortierbar, Scroll-Schatten), Zeitleiste, Stepper, Kommentare,
63
+ Hinweise, Badges.
64
+ - **Navigation:** Kopfleiste, Off-Canvas, Priority-Nav, Drilldown, Breadcrumb, Tabs (mit
65
+ Animationen), Pagination, Abschnitts-Navigation, Befehlspalette, Dropdown/Aktionsmenü,
66
+ Pillen-Gruppe, Toolbar mit Split-Button.
67
+ - **Formulare:** alle Feldtypen, Validierung, Floating Labels, Segmented (auch als
68
+ gleitender Modus-Umschalter), Bewertung, Dropzone, Combobox.
69
+ - **Overlays:** Dialoge (schließen beim Klick daneben, abschaltbar), Popover, Tooltip,
70
+ Hovercard, Benachrichtigungen.
71
+ - **Medien:** Video- und Audio-Player aus einem Guss (Kapitel, Playlist, Untertitel),
72
+ Hintergrundvideo, Slideshow mit Pfeilen und Punkten, Lightbox, Karten `<ncss-map>`
73
+ (MapLibre, Proxy-fähig, Zwei-Klick-Modus).
74
+ - **Scroll-Effekte:** Reveal, Morphing, Text-Reveal, Scrollytelling, Count-up, Marquee,
75
+ Curtain, Horizontal-Scroll, scroll-gesteuertes Video - nativ per `view()`-Timelines,
76
+ bei reduzierter Bewegung aus.
77
+ - **Filter-Raster**, sortierbare Listen, Countdown, Empty States und weitere App-Bausteine.
78
+
79
+ ## Schnellstart
80
+
81
+ ```html
82
+ <link rel="stylesheet" href="ncss.css">
83
+ <link rel="stylesheet" href="theme.css">
84
+ ```
85
+
86
+ `ncss.css` importiert alles Weitere in der richtigen Layer-Reihenfolge, `theme.css` ist die
87
+ Stelle für eigene Markenwerte (Farben, Schriften, Radien). Scripts liegen einzeln in
88
+ `dist/js/` und werden nur dort eingebunden, wo die Komponente vorkommt.
89
+
90
+ **Bezugswege** - alle gleichwertig, keiner braucht einen Build-Schritt:
91
+
92
+ | Weg | So geht's |
93
+ |---|---|
94
+ | Release-ZIP | [Neuestes Release](https://github.com/skerbis/nativecss/releases/latest) herunterladen, `dist/` ins Projekt kopieren |
95
+ | Git | `git clone https://github.com/skerbis/nativecss.git` und `dist/` nehmen |
96
+ | npm | `npm i @skerbis/nativecss`, dann `import "@skerbis/nativecss"` (= `dist/ncss.css`) |
97
+ | CDN | `https://cdn.jsdelivr.net/npm/@skerbis/nativecss@1/dist/ncss.css` |
98
+
99
+ Komponenten mit externen Dateien (Phosphor-Icons für `<ncss-icon>`, MapLibre für
100
+ `<ncss-map>`) liegen in `vendor/` - im ZIP und per Git enthalten, bei npm per
101
+ `vendor`-Attribut auf eine eigene Kopie zeigen.
102
+
103
+ ## Integration
104
+
105
+ - **REDAXO 6 + [fluid](https://github.com/KLXM/fluid):** fertiges NativeCSS-Kit - Blöcke,
106
+ Design-Einstellungen, Darstellungs-Knopf für Besucher, lädt pro Seite nur, was gebraucht wird.
107
+ - **KLXM Studio:** NativeCSS-Kit demnächst.
108
+ - **REDAXO 5, WordPress, TYPO3, Contao, Kirby** und **Laravel, Symfony, Astro, Eleventy,
109
+ React, Vue, Svelte, htmx** - Anleitungen im Handbuch unter „Integration“.
110
+
111
+ ## Werkzeuge
112
+
113
+ - **Code-Inspektor** auf allen Seiten der Website: Element anklicken → HTML, Erklärung und
114
+ die passenden `@import`-Zeilen.
115
+ - **UIkit → NativeCSS-Konverter** (Browser und Kommandozeile) für bestehende Templates.
116
+ - **VS-Code-Unterstützung** (Klassen-Vervollständigung, Snippets) und ein **LLM-Paket**
117
+ (`llms.txt`, Klassen-Index, Hook) für KI-Assistenten.
118
+
119
+ ## Browser
120
+
121
+ Ausgelegt auf die Browser der letzten zwei Jahre (Chrome/Edge, Safari, Firefox). Neuere
122
+ Features werden schrittweise eingesetzt: Wo ein Browser etwas nicht kann, bleibt die
123
+ Darstellung vollständig nutzbar - nur ohne den Effekt.
124
+
125
+ ## Mitmachen
126
+
127
+ Fehler gefunden, eine Komponente verbessert, Doku ergänzt? **Pull Requests und
128
+ [Issues](https://github.com/skerbis/nativecss/issues) sind herzlich willkommen.**
129
+ Die Website entsteht aus `docs-src/` (`node docs-src/build.mjs`, danach
130
+ `node docs-src/sync-demo.mjs`); lokal mit Video-Unterstützung:
131
+ `php -S 127.0.0.1:8770 -t . docs-src/dev-router.php`.
132
+
133
+ ## Unterstützen
134
+
135
+ NativeCSS ist frei (MIT) und entsteht in freier Zeit. Wenn es dir oder deinen Projekten
136
+ hilft, freue ich mich über Unterstützung via
137
+ **[GitHub Sponsors](https://github.com/sponsors/skerbis)** - das finanziert Pflege,
138
+ Barrierefreiheit und neue Komponenten.
139
+
140
+ ## Lizenz
141
+
142
+ [MIT](LICENSE) © 2026 [Thomas Skerbis](https://github.com/skerbis).
143
+ Contributors: [KLXM Crossmedia](https://github.com/klxm). Mitgelieferte Schriften (SIL OFL), Icons und
144
+ Bibliotheken in `vendor/` stehen unter ihren eigenen Lizenzen - siehe die jeweiligen
145
+ Lizenzdateien und das [Impressum](https://skerbis.github.io/nativecss/docs/de/impressum.html).
package/dist/base.css ADDED
@@ -0,0 +1,225 @@
1
+ /**
2
+ * ncss - Base (Layer "base"): alle gängigen HTML-Tags sauber gestylt, ausschließlich über
3
+ * die Tokens aus tokens.css. Kein Markup-spezifisches Klassen-Styling hier - das ist
4
+ * Aufgabe von helpers/ und components/. Logical Properties (margin-block/-inline statt
5
+ * -top/-left) durchgängig, damit RTL-Sprachen ohne Zusatzaufwand funktionieren.
6
+ */
7
+
8
+ /* :host: dieselbe Baseline gilt für den Wurzelknoten eines Shadow-DOM-Baums, wenn
9
+ base.css dort geladen wird (siehe js/ncss-container.js) - :host matcht sonst
10
+ nirgends, wirkungslos für jede normale Seite ohne Shadow DOM. */
11
+ body, :host {
12
+ font-family: var(--ncss-font-family-base);
13
+ font-size: var(--ncss-font-size-base);
14
+ font-weight: var(--ncss-font-weight-body);
15
+ color: var(--ncss-color-text);
16
+ background-color: var(--ncss-color-bg);
17
+ /* Passt Strichstärke/Proportionen automatisch an die aktuelle Schriftgröße an - nur
18
+ wirksam bei Schriften mit "optical size"-Achse (z.B. viele moderne Variable Fonts),
19
+ sonst folgenlos. Global sicher, da reine Verbesserung ohne Nachteil bei fehlender
20
+ Achse - siehe helpers/typography.css für den Variable-Font-Gewichts-Mechanismus. */
21
+ font-optical-sizing: auto;
22
+ }
23
+
24
+ /* --- Überschriften ------------------------------------------------------------------ */
25
+ h1, h2, h3, h4, h5, h6 {
26
+ font-family: var(--ncss-font-family-heading);
27
+ line-height: var(--ncss-line-height-tight);
28
+ font-weight: var(--ncss-font-weight-heading);
29
+ text-wrap: balance; /* verhindert hässliche Ein-Wort-Zeilenumbrüche in Überschriften */
30
+ margin-block-end: var(--ncss-space-2xs);
31
+ /* text-box-trim: schneidet den unsichtbaren Leerraum weg, den Schriften oberhalb der
32
+ Versalhöhe/unterhalb der Grundlinie mitbringen (Font-Metrik-Reserve für Akzente,
33
+ Unterlängen etc.) - das jahrelange "meine margin/padding stimmt optisch nie ganz"-
34
+ Problem bei Überschriften. "cap alphabetic" = oben bis Versalhöhe, unten bis
35
+ Grundlinie, der für Überschriften übliche Fall. Seit August 2026 in allen großen
36
+ Browsern (Chrome/Edge 133+, Safari 18.2+, Firefox 154+) - @supports trotzdem als
37
+ günstige Absicherung für ältere Firefox-Versionen im Feld. */
38
+ }
39
+ @supports (text-box-trim: trim-both) {
40
+ h1, h2, h3, h4, h5, h6 {
41
+ text-box-trim: trim-both;
42
+ text-box-edge: cap alphabetic;
43
+ }
44
+ }
45
+
46
+ h1 { font-size: var(--ncss-font-size-2xl); }
47
+ h2 { font-size: var(--ncss-font-size-xl); }
48
+ h3 { font-size: var(--ncss-font-size-lg); }
49
+ h4 { font-size: var(--ncss-font-size-md); }
50
+ h5, h6 { font-size: var(--ncss-font-size-base); }
51
+
52
+ /* --- Fließtext ------------------------------------------------------------------------ */
53
+ p, ul, ol, dl, blockquote, figure, pre, table, hr, details {
54
+ margin-block-end: var(--ncss-space-md);
55
+ }
56
+
57
+ /* Einseitige Margin-Konvention: NUR margin-block-END, nie -START (klassisches "single
58
+ direction margin"-Prinzip). Frühere Version nutzte das "Lobotomized Owl"-Pattern
59
+ (Top-Margin auf nachfolgenden Geschwistern via "* + p" etc.) - das brach aber bei
60
+ gefloateten Elementen (siehe helpers/float.css): ein <p> nach einem Float bekam trotzdem
61
+ die geschwister-basierte Top-Margin, was sich mit dem Textumfluss nicht sauber vertrug
62
+ (per echtem Test/Beobachtung gefunden). Reines margin-bottom hat dieses Problem nicht -
63
+ und ergibt für normale, nicht gefloatete Inhalte dieselben Abstände, weil vertikale
64
+ Geschwister-Margins ohnehin kollabieren (der größere Wert gewinnt): der Abstand zwischen
65
+ zwei Elementen kommt jetzt einfach vom margin-bottom des VORANGEHENDEN Elements, kein
66
+ Zusammenspiel zweier Regeln mehr nötig. */
67
+
68
+ ul, ol {
69
+ padding-inline-start: var(--ncss-space-md);
70
+ }
71
+ li > ul, li > ol {
72
+ margin-block: var(--ncss-space-2xs);
73
+ }
74
+ /* Aufzählungszeichen/Nummern OHNE eigenen Marker-Token - bewusst derselbe
75
+ --ncss-color-text-muted wie gedämpfter Fließtext (auch von .ncss-text-lead genutzt),
76
+ kein zweiter, eigens für ::marker gepflegter Wert. Läuft dadurch automatisch über
77
+ theme.css mit, ganz ohne dass theme.css etwas Eigenes dafür bräuchte - reiner Browser-
78
+ Default (volle Textfarbe) sonst ungestylt, ohne diese Regel. */
79
+ ::marker {
80
+ color: var(--ncss-color-text-muted);
81
+ }
82
+
83
+ a {
84
+ color: var(--ncss-color-brand);
85
+ text-underline-offset: 0.15em;
86
+ /* Unterstreichung springt über Unterlängen (g, y, p, ...) statt sie zu durchqueren -
87
+ seit Langem UA-Default in den meisten Browsern, hier explizit statt implizit. */
88
+ text-decoration-skip-ink: auto;
89
+ }
90
+ a:hover {
91
+ text-decoration-thickness: 0.1em;
92
+ }
93
+
94
+ strong, b { font-weight: var(--ncss-font-weight-bold); }
95
+ em, i { font-style: italic; }
96
+ small { font-size: var(--ncss-font-size-sm); }
97
+ mark {
98
+ background-color: color-mix(in srgb, var(--ncss-color-warning) 35%, transparent);
99
+ color: inherit;
100
+ border-radius: var(--ncss-radius-sm);
101
+ padding-inline: 0.2em;
102
+ }
103
+ abbr[title] {
104
+ text-decoration: underline dotted;
105
+ cursor: help;
106
+ }
107
+
108
+ /* --- Code ------------------------------------------------------------------------------ */
109
+ code, kbd, samp {
110
+ font-family: var(--ncss-font-family-mono);
111
+ font-size: 0.9em;
112
+ /* currentColor-relativ statt fixem --ncss-color-bg-subtle-Token: Inline-Code kann auf
113
+ JEDER Hintergrundfarbe landen (dunkle Sektion, farbiges Band, .ncss-modal--dark, ...),
114
+ nicht nur der normalen Seite - ein fest verdrahteter heller Ton bricht dort (per echtem
115
+ Test gefunden: kaum lesbar auf einem dunkelblauen .ncss-full-bleed-Band). Ein
116
+ transluzenter Tint relativ zur jeweils aktiven Textfarbe bleibt dagegen überall
117
+ kontrastreich, ganz ohne zu wissen, auf welchem Hintergrund er gerade sitzt. */
118
+ background-color: color-mix(in oklch, currentColor 12%, transparent);
119
+ border-radius: var(--ncss-radius-sm);
120
+ padding-inline: 0.35em;
121
+ padding-block: 0.1em;
122
+ /* Langer INLINE-Code (z.B. ein komplettes Markup-Beispiel in <code> statt <pre><code>)
123
+ hat sonst keine Umbruch-Gelegenheit und sprengt schmale Viewports - <pre> hat dafür
124
+ bereits eigenes overflow-x:auto, nacktes <code> nicht (per echtem Test bei 375px
125
+ gefunden). break-word statt dem älteren word-break:break-all: bricht nur, wenn ein
126
+ Wort wirklich nicht in eine eigene Zeile passt, nicht bei jeder Gelegenheit. */
127
+ overflow-wrap: break-word;
128
+ }
129
+ pre {
130
+ font-family: var(--ncss-font-family-mono);
131
+ background-color: var(--ncss-color-bg-subtle);
132
+ border-radius: var(--ncss-radius-md);
133
+ padding: var(--ncss-space-sm);
134
+ overflow-x: auto;
135
+ }
136
+ pre code {
137
+ background: none;
138
+ padding: 0;
139
+ }
140
+
141
+ /* --- Zitate/Trenner --------------------------------------------------------------------- */
142
+ blockquote {
143
+ border-inline-start: 0.25rem solid var(--ncss-color-border);
144
+ padding-inline-start: var(--ncss-space-sm);
145
+ color: var(--ncss-color-text-muted);
146
+ }
147
+ /* Attribution (<footer>/<cite> innerhalb <blockquote>, Standard-HTML-Muster laut MDN) -
148
+ bislang unstyled (Browser-Default: <cite> nur kursiv). Eigene Zeile, dezent kleiner/
149
+ heller als das Zitat selbst. "-"-Präfix per generiertem Inhalt (::before) statt hart im
150
+ Markup getippt - bleibt so für Screenreader unsichtbar (kein "Minus Quelle" vorgelesen),
151
+ optisch aber identisch.
152
+ Markup: <blockquote><p>Zitat.</p><footer><cite>Quelle</cite></footer></blockquote> */
153
+ blockquote footer {
154
+ margin-block-start: var(--ncss-space-2xs);
155
+ font-size: var(--ncss-font-size-sm);
156
+ color: var(--ncss-color-text-muted);
157
+ }
158
+ blockquote footer::before {
159
+ content: "\2014\00A0";
160
+ }
161
+ blockquote cite {
162
+ font-style: normal;
163
+ font-weight: var(--ncss-font-weight-semibold);
164
+ }
165
+ hr {
166
+ border: none;
167
+ border-block-start: var(--ncss-border-width) solid var(--ncss-color-border);
168
+ }
169
+ figcaption {
170
+ font-size: var(--ncss-font-size-sm);
171
+ color: var(--ncss-color-text-muted);
172
+ margin-block-start: var(--ncss-space-2xs);
173
+ }
174
+
175
+ /* --- Tabellen -------------------------------------------------------------------------- */
176
+ table {
177
+ width: 100%;
178
+ border-collapse: collapse;
179
+ font-variant-numeric: tabular-nums;
180
+ }
181
+ th, td {
182
+ text-align: start;
183
+ padding: var(--ncss-space-2xs) var(--ncss-space-xs);
184
+ border-block-end: var(--ncss-border-width) solid var(--ncss-color-border);
185
+ }
186
+ th {
187
+ font-weight: var(--ncss-font-weight-bold);
188
+ }
189
+
190
+ /* --- Native interaktive Elemente (bewusst nativ statt eigenem JS/CSS-Nachbau, siehe
191
+ ncss-Prinzip "was per HTML/CSS geht, geht ohne Web Awesome") ----------------------------
192
+ Bewusst NUR das absolut Neutrale hier (reset.css-Prinzip konsequent zu Ende gedacht: der
193
+ Reset bleibt "dumm", aber auch base.css darf für <details> keine Meinung erzwingen, die
194
+ andere Komponenten mit demselben nativen Element (z.B. components/nav.css' Dropdown)
195
+ erst wieder wegresetten müssten). Die "boxed FAQ"-Optik (Rahmen/Padding/fettes Summary)
196
+ ist stattdessen components/disclosure.css - explizit opt-in per .ncss-disclosure, statt
197
+ jedem <details> aufgezwungen. */
198
+ details > summary {
199
+ cursor: pointer;
200
+ }
201
+
202
+ /* Bewusst NUR das absolut Neutrale/Korrigierende hier, keine "so soll ein Dialog
203
+ aussehen"-Meinung (dieselbe Überlegung wie bei <details> oben - Modal/Lightbox/
204
+ Off-Canvas wollen jeweils komplett unterschiedliches Aussehen, jedes hätte eine
205
+ base.css-Meinung erst wieder wegresetten müssen, wie es lightbox.css/off-canvas.css
206
+ bislang tatsächlich taten). Die "weiße Karte mit Schatten"-Optik ist jetzt explizit
207
+ components/modal.css (.ncss-modal). */
208
+ /* Das UA-Stylesheet zentriert <dialog> im Modal-Zustand normalerweise per
209
+ "margin: auto" - reset.css' globales "* { margin: 0; }" schlägt das aber, da
210
+ Autor-Styles (auch layered) immer über dem UA-Stylesheet stehen. Ohne diese Regel
211
+ landet der Dialog oben links statt zentriert. Das ist eine KORREKTUR (native
212
+ Grundfunktion wiederherstellen), keine neue Meinung - bleibt daher hier, nicht in
213
+ modal.css (components/off-canvas.css setzt es für seinen Fall gezielt wieder zurück).
214
+ :modal trifft nur den Zustand nach showModal() (Top-Layer) - ein per [open]-Attribut
215
+ nur normal eingebettetes <dialog> bleibt bewusst im normalen Fluss, ohne erzwungene
216
+ Zentrierung. */
217
+ dialog:modal {
218
+ margin: auto;
219
+ }
220
+
221
+ /* --- Selektion/Fokus-Feinschliff -------------------------------------------------------- */
222
+ ::selection {
223
+ background-color: var(--ncss-color-brand);
224
+ color: var(--ncss-color-brand-contrast);
225
+ }
@@ -0,0 +1,32 @@
1
+ /**
2
+ * ncss - Browser-spezifische Fixes (eigener Layer, ALLERLETZTE Priorität - siehe
3
+ * ncss.css/@layer-Reihenfolge). Eigene Datei statt verstreuter @supports/@-moz-/-webkit--
4
+ * Hacks in den Komponenten-Dateien: so bleibt sofort sichtbar, WAS ein Workaround für einen
5
+ * konkreten Browser-Bug ist (mit Quelle/Datum) und WANN er wieder entfernt werden kann,
6
+ * statt sich in normalem Komponenten-CSS zu verstecken.
7
+ *
8
+ * Jeder Eintrag hier braucht: den genauen Bug, die Quelle, und (wenn möglich) eine
9
+ * @supports/Feature-Query-Eingrenzung statt globalem Browser-Sniffing.
10
+ */
11
+
12
+ /**
13
+ * --- WebKit/Safari: <dialog>-Dismiss verwechselt Slot-Ownership seitenweit ------------------
14
+ * Dokumentierter WebKit-Bug (github.com/shoelace-style/webawesome/issues/1771, per Recherche
15
+ * bestätigt, nicht angenommen): schließt sich IRGENDEIN <dialog> auf der Seite, kann Safari
16
+ * dabei Slot-Inhalte in ANDEREN offenen Shadow-DOM-Komponenten (z.B. Web Awesomes eigene
17
+ * <wa-drawer>/<wa-accordion-item>) kurzzeitig unstyled/leer rendern - genau das Symptom
18
+ * "Dropdown/Modal blinkt beim Schließen ungestaltet auf".
19
+ *
20
+ * WICHTIG: Per eigenem Test (Chromium + Playwright-WebKit, Video-Aufnahme framegenau
21
+ * ausgewertet) ließ sich das für ncss' EIGENE native <details>/<dialog> (kein Shadow DOM,
22
+ * keine <slot>-Elemente) NICHT reproduzieren - die betreffen laut Bug-Report spezifisch
23
+ * Shadow-DOM-Slots. Der offiziell von den Web-Awesome-Maintainern genannte Fix
24
+ * ("slot { display: inline; }" statt dem UA-Default "display: contents") lässt sich von
25
+ * AUSSEN nicht anwenden - Shadow-DOM-Kapselung verhindert, dass Seiten-CSS in eine fremde
26
+ * Komponente hineinstylt, das kann nur Web Awesome selbst in seinen eigenen Styles fixen.
27
+ *
28
+ * Wenn der Effekt weiterhin auftritt (z.B. auf einer Seite, die zusätzlich Web-Awesome-
29
+ * Komponenten lädt): bitte genaue Wiederholungsschritte + Safari-Version melden, damit
30
+ * gezielt nachgetestet werden kann statt weiter zu raten - siehe Kommentar in
31
+ * .claude/skills/ncss/SKILL.md, Fallstrick-Liste.
32
+ */