feat: Aura theme foundation (#10142)

jouni · web-flow · commit f235b39c94ac · 2025-09-09T16:57:01.000+03:00
diff --git a/dev/aura.html b/dev/aura.html
@@ -0,0 +1,21 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8" />
+  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Aura</title>
+  <link rel="stylesheet" href="../packages/aura/aura.css" />
+</head>
+<body>
+
+  <h1>Aura</h1>
+  <h2>Aura</h2>
+  <h3>Aura</h3>
+  <h4>Aura</h4>
+  <h5>Aura</h5>
+  <h6>Aura</h6>
+
+</body>
+</html>
diff --git a/packages/aura/aura.css b/packages/aura/aura.css
@@ -1,3 +1,8 @@
-html {
-  /* Global custom properties */
+@import './src/color.css';
+@import './src/palette.css';
+@import './src/size.css';
+@import './src/typography.css';
+
+:where(html) {
+  cursor: default;
 }
diff --git a/packages/aura/package.json b/packages/aura/package.json
@@ -19,6 +19,7 @@
   "main": "aura.css",
   "type": "module",
   "files": [
+    "src",
     "*.css"
   ],
   "keywords": [
diff --git a/packages/aura/src/color.css b/packages/aura/src/color.css
@@ -0,0 +1,103 @@
+:where(html) {
+  --aura-contrast: 1;
+
+  --aura-accent-light: hsl(220, 80%, 47%);
+  --aura-accent-dark: hsl(220, 75%, 55%);
+
+  --_color-base: light-dark(
+    oklch(from var(--aura-background-light) 0.1 calc(c / 2 + c * (1 - c)) h),
+    oklch(from var(--aura-background-dark) 1 c h)
+  );
+  --vaadin-color: light-dark(
+    color-mix(in srgb, var(--_color-base) calc(90% + 5% * var(--aura-contrast)), transparent),
+    color-mix(in srgb, #fff calc(90% + 5% * var(--aura-contrast)), transparent)
+  );
+  --vaadin-color-subtle: light-dark(
+    color-mix(in srgb, var(--_color-base) calc(55% + 10% * var(--aura-contrast)), transparent),
+    color-mix(in srgb, var(--_color-base) calc(57% + 10% * var(--aura-contrast)), transparent)
+  );
+  --vaadin-color-disabled: color-mix(in srgb, var(--_color-base) calc(30% + 10% * var(--aura-contrast)), transparent);
+
+  --_border-color-base: light-dark(
+    oklch(from var(--aura-background-light) 0.1 c h),
+    oklch(from var(--aura-background-dark) 0.85 c h)
+  );
+  --vaadin-border-color: color-mix(
+    in srgb,
+    var(--_border-color-base) calc(14% + 6% * var(--aura-contrast)),
+    transparent
+  );
+  --vaadin-border-color-subtle: light-dark(
+    color-mix(in srgb, var(--_border-color-base) max(5%, 5% + 3% * var(--aura-contrast)), transparent),
+    color-mix(in srgb, var(--_border-color-base) max(6%, 5% + 5% * var(--aura-contrast)), transparent)
+  );
+
+  --aura-background-light: oklch(from var(--aura-accent-light) min(1, l + (1 - l) * 0.9) calc(c * 0.05) h);
+  --aura-background-dark: oklch(from var(--aura-accent-dark) max(0, l/2 - (1 - l) * 0.2) calc(c * 0.05) h);
+  --aura-background: light-dark(var(--aura-background-light), var(--aura-background-dark));
+
+  --_bg-alt: oklch(
+    from var(--aura-background) calc(l + c) min(c, c * 2 - l/20) calc(h + 180 * var(--_safari-17-deg, 1deg) * l * c * 4)
+  );
+  --_bg-accent: radial-gradient(
+    circle at 0% 0%,
+    light-dark(
+      oklch(from var(--aura-background-light) min(1, l + c * 3) min(c, c * 3 - l/20) h),
+      oklch(from var(--aura-background-dark) min(1, l + c) clamp(0, c * 1.5, 0.4) h)
+    ),
+    transparent 30%
+  );
+  --aura-app-background:
+    var(--_bg-accent), radial-gradient(circle at 25% 0% in xyz, var(--aura-background) 33%, var(--_bg-alt));
+
+  --aura-accent-color: light-dark(var(--aura-accent-light), var(--aura-accent-dark));
+  --vaadin-focus-ring-color: var(--aura-accent-color);
+  accent-color: var(--aura-accent-color);
+  /* Workaround Safari 17 limitation and compute these separately for light and dark */
+  --aura-accent-contrast: light-dark(
+    oklch(from var(--aura-accent-light) clamp(0, (0.62 - l) * 1000, 1) 0 0),
+    oklch(from var(--aura-accent-dark) clamp(0, (0.62 - l) * 1000, 1) 0 0)
+  );
+
+  --aura-accent-text-light: color-mix(
+    in srgb,
+    var(--aura-accent-light) calc(70% - 15% * var(--aura-contrast)),
+    var(--vaadin-color)
+  );
+  --aura-accent-text-dark: color-mix(
+    in srgb,
+    var(--aura-accent-dark) calc(70% - 15% * var(--aura-contrast)),
+    var(--vaadin-color)
+  );
+  --aura-accent-text: light-dark(var(--aura-accent-text-light), var(--aura-accent-text-dark));
+
+  /* TODO probably broken for Safari 17 */
+  --vaadin-user-color: var(--aura-accent-color);
+
+  --vaadin-background-container: color-mix(
+    in srgb,
+    var(--_color-base) calc(3% + min(3%, 1% * var(--aura-contrast))),
+    transparent
+  );
+
+  --vaadin-background-container-strong: color-mix(
+    in srgb,
+    var(--_color-base) calc(7% + min(8%, 1.5% * var(--aura-contrast))),
+    transparent
+  );
+
+  color: var(--vaadin-color);
+  background: var(--aura-app-background);
+  background-size: 100vw 100vh;
+  background-attachment: fixed;
+}
+
+@supports (color: hsl(0 0 0)) {
+  :where(html) {
+    --_safari-17-deg: 1;
+  }
+}
+
+:where(h1, h2, h3, h4, h5, h6) {
+  color: var(--vaadin-color);
+}
diff --git a/packages/aura/src/fonts/InstrumentSans/InstrumentSans.css b/packages/aura/src/fonts/InstrumentSans/InstrumentSans.css
@@ -0,0 +1,13 @@
+/*
+Copyright 2022 The Instrument Sans Project Authors (https://github.com/Instrument/instrument-sans)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is included in the LICENSE.txt file, and is also available with a FAQ at: https://openfontlicense.org
+*/
+@font-face {
+  font-family: 'Instrument Sans';
+  src: url(./InstrumentSans.woff2) format('woff2');
+  font-display: swap;
+  font-style: normal;
+  font-weight: 400 700;
+}
diff --git a/packages/aura/src/fonts/InstrumentSans/InstrumentSans.woff2 b/packages/aura/src/fonts/InstrumentSans/InstrumentSans.woff2
diff --git a/packages/aura/src/fonts/InstrumentSans/LICENSE.txt b/packages/aura/src/fonts/InstrumentSans/LICENSE.txt
@@ -0,0 +1,93 @@
+Copyright 2022 The Instrument Sans Project Authors (https://github.com/Instrument/instrument-sans)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
diff --git a/packages/aura/src/palette.css b/packages/aura/src/palette.css
@@ -0,0 +1,45 @@
+:where(html) {
+  --aura-red: light-dark(
+    oklch(from var(--aura-accent-light) 0.55 c calc(clamp(380 - rem(h, 6), h + 20, 420 - rem(h, 6)) + 20)),
+    oklch(from var(--aura-accent-dark) 0.7 c calc(clamp(380 - rem(h, 6), h + 20, 420 - rem(h, 6)) + 20))
+  );
+  --aura-orange: light-dark(
+    oklch(from var(--aura-accent-light) 0.8 min(c + 0.1, 0.4) clamp(80 - rem(h, 6), h, 90 + rem(h, 6))),
+    oklch(from var(--aura-accent-dark) 0.75 min(c + 0.1, 0.4) clamp(80 - rem(h, 6), h, 90 + rem(h, 6)))
+  );
+  --aura-yellow: light-dark(
+    oklch(from var(--aura-accent-light) 0.9 min(c + 0.1, 0.4) clamp(100 - rem(h, 6), h, 105 - rem(h, 6))),
+    oklch(from var(--aura-accent-dark) 0.85 min(c + 0.1, 0.4) clamp(100 - rem(h, 6), h, 105 - rem(h, 6)))
+  );
+  --aura-green: light-dark(
+    oklch(from var(--aura-accent-light) 0.5 min(c + 0.05, 0.4) clamp(130 - rem(h, 6), h, 160 - rem(h, 6))),
+    oklch(from var(--aura-accent-dark) 0.7 min(c + 0.05, 0.4) clamp(130 - rem(h, 6), h, 160 - rem(h, 6)))
+  );
+  --aura-blue: light-dark(
+    oklch(from var(--aura-accent-light) 0.55 min(c + 0.05, 0.4) clamp(220 - rem(h, 6), h, 260 - rem(h, 6))),
+    oklch(from var(--aura-accent-dark) 0.7 min(c + 0.05, 0.4) clamp(220 - rem(h, 6), h, 260 - rem(h, 6)))
+  );
+  --aura-purple: light-dark(
+    oklch(from var(--aura-accent-light) 0.55 min(c + 0.05, 0.4) clamp(280 - rem(h, 6), h, 350 - rem(h, 6))),
+    oklch(from var(--aura-accent-dark) 0.7 min(c + 0.05, 0.4) clamp(280 - rem(h, 6), h, 350 - rem(h, 6)))
+  );
+
+  --aura-red-text: color-mix(in srgb, var(--aura-red) calc(70% - 15% * var(--aura-contrast)), var(--vaadin-color));
+  --aura-orange-text: color-mix(
+    in srgb,
+    var(--aura-orange) calc(60% - 15% * var(--aura-contrast)),
+    var(--vaadin-color)
+  );
+  --aura-yellow-text: color-mix(
+    in srgb,
+    var(--aura-yellow) calc(55% - 15% * var(--aura-contrast)),
+    var(--vaadin-color)
+  );
+  --aura-green-text: color-mix(in srgb, var(--aura-green) calc(70% - 15% * var(--aura-contrast)), var(--vaadin-color));
+  --aura-blue-text: color-mix(in srgb, var(--aura-blue) calc(70% - 15% * var(--aura-contrast)), var(--vaadin-color));
+  --aura-purple-text: color-mix(
+    in srgb,
+    var(--aura-purple) calc(70% - 15% * var(--aura-contrast)),
+    var(--vaadin-color)
+  );
+}
diff --git a/packages/aura/src/size.css b/packages/aura/src/size.css
@@ -0,0 +1,44 @@
+:where(html) {
+  --aura-base-size: 16;
+  --_size-ref: 16;
+  --aura-base-radius: 3;
+  --vaadin-radius-s: min(0.25lh, round(var(--aura-base-radius) * 1px + 2px, 1px));
+  --vaadin-radius-m: round(var(--aura-base-radius) * 2px + 3px, 1px);
+  --vaadin-radius-l: round(var(--aura-base-radius) * 1.5px + 10px, 1px);
+}
+
+:where(html, [theme]) {
+  --vaadin-padding-xs: round(
+    var(--aura-base-size) * 0.25 * pow(var(--aura-base-size) / var(--_size-ref), 0.5) * 1px,
+    1px
+  );
+  --vaadin-padding-s: round(
+    var(--aura-base-size) * 0.5 * pow(var(--aura-base-size) / var(--_size-ref), 0.75) * 1px,
+    1px
+  );
+  --vaadin-padding-m: round(
+    var(--aura-base-size) * 0.75 * pow(var(--aura-base-size) / var(--_size-ref), 0.3) * 1px,
+    1px
+  );
+
+  --vaadin-padding-l: calc(var(--aura-base-size) * 1px);
+  --vaadin-padding-xl: round(
+    var(--aura-base-size) * 1.5 * pow(var(--aura-base-size) / var(--_size-ref), 0.1) * 1px,
+    1px
+  );
+
+  --vaadin-padding-container: round(var(--vaadin-padding-s) / 1.4, 1px)
+    max(var(--vaadin-padding-s), round(var(--vaadin-radius-m) / 2, 1px));
+
+  --vaadin-gap-xs: var(--vaadin-padding-xs);
+  --vaadin-gap-s: var(--vaadin-padding-s);
+  --vaadin-gap-m: var(--vaadin-padding-m);
+  --vaadin-gap-l: var(--vaadin-padding-l);
+  --vaadin-gap-xl: var(--vaadin-padding-xl);
+}
+
+@media (pointer: coarse) {
+  :where(html) {
+    --aura-base-size: 19;
+  }
+}
diff --git a/packages/aura/src/typography.css b/packages/aura/src/typography.css
