@firebase-oss/ui-styles 0.0.1

package/README.md

@@ -0,0 +1,42 @@
+# @firebase-oss/ui-styles
+
+This package contains the styles for the FirebaseUI components.
+
+## Installation
+
+### With tailwind
+
+If you are using Tailwind CSS in your project, you can import the source files directly into your project.
+
+```css
+@import "tailwindcss";
+@import "@firebase-oss/ui-styles/tailwind";
+```
+
+### With CSS
+
+Alternatively, you can import fully compiled CSS files into your project. This output contains both the tailwind styles and the FirebaseUI styles.
+
+```jsx
+import "@firebase-oss/ui-styles";
+```
+
+## Themes
+
+The packages also exports themes which overrides the CSS variables with preset colors. These can be imported from your CSS:
+
+```css
+@import "tailwindcss";
+@import "@firebase-oss/ui-styles/tailwind";
+@import "@firebase-oss/ui-styles/themes/brualist";
+```
+
+## Building
+
+To build the styles into a single CSS file, run the following command:
+
+```bash
+pnpm build
+```
+
+This command will source the `src.css` file and output the compiled CSS to the `dist.css` file.

package/dist.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.1.16 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-space-y-reverse:0;--tw-border-style:solid;--tw-font-weight:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-translate-x:0;--tw-translate-y:0;--tw-translate-z:0}}}@layer theme{:root,:host{--color-red-500:oklch(63.7% .237 25.331);--color-gray-200:oklch(92.8% .006 264.531);--color-gray-300:oklch(87.2% .01 258.338);--color-gray-800:oklch(27.8% .033 256.848);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-md:28rem;--text-xs:.75rem;--text-xs--line-height:calc(1/.75);--text-sm:.875rem;--text-sm--line-height:calc(1.25/.875);--text-lg:1.125rem;--text-lg--line-height:calc(1.75/1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75/1.25);--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--radius-sm:.25rem;--radius-xl:.75rem;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4,0,.2,1);--radius:var(--fui-radius);--color-primary:var(--fui-primary);--color-primary-hover:var(--fui-primary-hover);--color-primary-surface:var(--fui-primary-surface);--color-text:var(--fui-text);--color-text-muted:var(--fui-text-muted);--color-background:var(--fui-background);--color-border:var(--fui-border);--color-input:var(--fui-input);--color-error:var(--fui-error);--radius-card:var(--fui-radius-card)}:root{--fui-primary:var(--color-black);--fui-primary-hover:var(--fui-primary)}@supports (color:color-mix(in lab, red, red)){:root{--fui-primary-hover:color-mix(in oklab,var(--fui-primary)85%,transparent)}}:root{--fui-primary-surface:var(--color-white);--fui-text:var(--color-black);--fui-text-muted:var(--color-gray-800);--fui-background:var(--color-white);--fui-border:var(--color-gray-200);--fui-input:var(--color-gray-300);--fui-error:var(--color-red-500);--fui-radius:var(--radius-sm);--fui-radius-card:var(--radius-xl)}@media (prefers-color-scheme:dark){:root{--fui-primary:var(--color-white);--fui-primary-hover:var(--fui-primary)}@supports (color:color-mix(in lab, red, red)){:root{--fui-primary-hover:color-mix(in oklab,var(--fui-primary)85%,transparent)}}:root{--fui-primary-surface:var(--color-black);--fui-text:var(--color-white);--fui-text-muted:var(--color-gray-200);--fui-background:var(--color-black);--fui-border:var(--color-gray-200);--fui-input:var(--color-gray-300);--fui-error:var(--color-red-500);--fui-radius:var(--radius-sm);--fui-radius-card:var(--radius-xl)}}}@layer components{:where(.fui-screen){max-width:var(--container-md);padding-top:calc(var(--spacing)*24);margin-inline:auto}:where(:where(.fui-screen .fui-screen__children)>:not(:last-child)),:where(:where(.fui-content)>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*2)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*2)*calc(1 - var(--tw-space-y-reverse)))}:where(:where(.fui-card)>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*6)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*6)*calc(1 - var(--tw-space-y-reverse)))}:where(.fui-card){border-radius:var(--radius-card);border-style:var(--tw-border-style);border-width:1px;border-color:var(--color-border);background-color:var(--color-background);padding:calc(var(--spacing)*10)}:where(:where(.fui-card__header)>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*1)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*1)*calc(1 - var(--tw-space-y-reverse)))}:where(.fui-card__header){text-align:center}:where(.fui-card__title){font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height));--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold);color:var(--color-text)}:where(.fui-card__subtitle){font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height));color:var(--color-text-muted)}:where(:where(.fui-form)>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing)*6)*var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing)*6)*calc(1 - var(--tw-space-y-reverse)))}:where(.fui-form fieldset),:where(.fui-form fieldset label){gap:calc(var(--spacing)*2);color:var(--color-text);flex-direction:column;display:flex}:where(.fui-form fieldset label div[data-input-label]){gap:calc(var(--spacing)*3);font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height));--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium);display:flex}:where(.fui-form fieldset label div[data-input-label]>div:first-child){flex-grow:1}:where(.fui-form .fui-form__action){padding-inline:calc(var(--spacing)*1);font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height));color:var(--color-text-muted)}@media (hover:hover){:where(.fui-form .fui-form__action):hover{text-decoration-line:underline}}:where(.fui-form fieldset label input){border-radius:var(--radius);border-style:var(--tw-border-style);border-width:1px;border-color:var(--color-input);width:100%;padding-inline:calc(var(--spacing)*2);padding-block:calc(var(--spacing)*2);font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height));--tw-shadow:0 1px 2px 0 var(--tw-shadow-color,#0000000d);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow);background-color:#0000}:where(.fui-form fieldset label input):focus{outline-style:var(--tw-outline-style);outline-width:2px;outline-color:var(--color-primary)}:where(.fui-form fieldset label input[aria-invalid=true]){border-color:var(--color-error);outline-style:var(--tw-outline-style);outline-width:2px;outline-color:var(--color-error)}:where(.fui-form fieldset label div[data-input-group]){align-items:center;gap:calc(var(--spacing)*2);display:flex}:where(.fui-form .fui-form__error){text-align:left;font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height));color:var(--color-error)}:where(.fui-success){text-align:center;font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}:where(.fui-button){justify-content:center;align-items:center;gap:calc(var(--spacing)*3);border-radius:var(--radius);background-color:var(--color-primary);width:100%;padding-inline:calc(var(--spacing)*4);padding-block:calc(var(--spacing)*2);font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height));--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium);color:var(--color-primary-surface);--tw-shadow:0 1px 2px 0 var(--tw-shadow-color,#0000000d);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow);transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration));display:flex}@media (hover:hover){:where(.fui-button):hover{cursor:pointer;background-color:var(--color-primary-hover)}}:where(.fui-button):disabled{cursor:not-allowed;opacity:.5}:where(.fui-button--secondary){border-style:var(--tw-border-style);border-width:1px;border-color:var(--color-input);color:var(--color-text);background-color:#0000}@media (hover:hover){:where(.fui-button--secondary):hover{border-color:var(--color-primary);background-color:var(--color-background)}}:where(.fui-button.fui-provider__button){border-style:var(--tw-border-style);border-width:1px;border-color:var(--color-border)}:where(.fui-provider__button>svg,.fui-provider__button>img){height:calc(var(--spacing)*5);width:calc(var(--spacing)*5)}:where(.fui-divider){margin-block:calc(var(--spacing)*4);align-items:center;gap:calc(var(--spacing)*3);display:flex}:where(.fui-divider__line){background-color:var(--color-border);flex:1;height:1px}:where(.fui-divider__text){font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height));color:var(--color-text-muted)}:where(.fui-phone-input){align-items:center;gap:calc(var(--spacing)*2);display:flex}:where(.fui-phone-input__number-input){border-radius:var(--radius);border-style:var(--tw-border-style);border-width:1px;border-color:var(--color-input);padding-inline:calc(var(--spacing)*2);padding-block:calc(var(--spacing)*2);font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height));--tw-shadow:0 1px 2px 0 var(--tw-shadow-color,#0000000d);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow);background-color:#0000;flex:1}:where(.fui-phone-input__number-input):focus{outline-style:var(--tw-outline-style);outline-width:2px;outline-color:var(--color-primary)}:where(.fui-phone-input__number-input[aria-invalid=true]){outline-style:var(--tw-outline-style);outline-width:2px;outline-color:var(--color-error)}:where(.fui-country-selector){width:120px;display:inline-block;position:relative}:where(.fui-country-selector__wrapper){border-radius:var(--radius);outline-style:var(--tw-outline-style);outline-width:1px;outline-color:var(--color-input);background-color:#0000;align-items:center;display:flex;position:relative;overflow:hidden}:where(.fui-country-selector__flag){pointer-events:none;left:calc(var(--spacing)*2);font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height));position:absolute}:where(.fui-country-selector select){cursor:pointer;appearance:none;width:100%;padding-block:calc(var(--spacing)*2);padding-right:calc(var(--spacing)*2);padding-left:calc(var(--spacing)*8);font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height));color:#0000;--tw-shadow:0 1px 2px 0 var(--tw-shadow-color,#0000000d);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow);background-color:#0000}:where(.fui-country-selector select):focus{outline-style:var(--tw-outline-style);outline-width:2px;outline-color:var(--color-primary)}:where(.fui-country-selector__dial-code){pointer-events:none;top:50%;left:calc(var(--spacing)*8);--tw-translate-y:calc(calc(1/2*100%)*-1);translate:var(--tw-translate-x)var(--tw-translate-y);font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height));color:var(--color-text);position:absolute}:where(.fui-form fieldset label div[data-input-group]:has(input[aria-invalid=true]) .fui-country-selector),:where(.fui-form fieldset label div[data-input-group]:has(input[aria-invalid=true]) .fui-country-selector .fui-country-selector__wrapper){border-radius:var(--radius);outline-style:var(--tw-outline-style);outline-width:2px;outline-color:var(--color-error)}:where(.fui-policies){text-align:center;font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height));color:var(--color-text-muted)}:where(.fui-policies a,.fui-policies button){--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}@media (hover:hover){:where(.fui-policies a,.fui-policies button):hover{text-decoration-line:underline}}.fui-provider__button[data-provider=google\.com][data-themed=true]{--google-primary:#131314;--color-primary:var(--google-primary);--color-primary-hover:var(--google-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=google\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--google-primary)85%,transparent)}}.fui-provider__button[data-provider=google\.com][data-themed=true]{--color-primary-surface:#fff;--color-border:var(--google-primary)}.fui-provider__button[data-provider=google\.com][data-themed=neutral]{--google-primary:#f2f2f2;--color-primary:var(--google-primary);--color-primary-hover:var(--google-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=google\.com][data-themed=neutral]{--color-primary-hover:color-mix(in oklab,var(--google-primary)85%,transparent)}}.fui-provider__button[data-provider=google\.com][data-themed=neutral]{--color-primary-surface:#1f1f1f;--color-border:transparent}@media (prefers-color-scheme:dark){.fui-provider__button[data-provider=google\.com][data-themed=true]{--google-primary:#fff;--color-primary:var(--google-primary);--color-primary-hover:var(--google-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=google\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--google-primary)85%,transparent)}}.fui-provider__button[data-provider=google\.com][data-themed=true]{--color-primary-surface:#1f1f1f;--color-border:#747775}}.fui-provider__button[data-provider=facebook\.com][data-themed=true]{--facebook-primary:#1877f2;--color-primary:var(--facebook-primary);--color-primary-hover:var(--facebook-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=facebook\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--facebook-primary)85%,transparent)}}.fui-provider__button[data-provider=facebook\.com][data-themed=true]{--color-primary-surface:var(--color-white);--color-border:var(--facebook-primary)}.fui-provider__button[data-provider=apple\.com][data-themed=true]{--apple-primary:#000;--color-primary:var(--apple-primary);--color-primary-hover:var(--apple-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=apple\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--apple-primary)85%,transparent)}}.fui-provider__button[data-provider=apple\.com][data-themed=true]{--color-primary-surface:#fff;--color-border:var(--apple-primary)}@media (prefers-color-scheme:dark){.fui-provider__button[data-provider=apple\.com][data-themed=true]{--apple-primary:var(--color-white);--color-primary:var(--apple-primary);--color-primary-hover:var(--apple-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=apple\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--apple-primary)85%,transparent)}}.fui-provider__button[data-provider=apple\.com][data-themed=true]{--color-primary-surface:var(--color-black);--color-border:var(--color-white)}}.fui-provider__button[data-provider=github\.com][data-themed=true]{--github-primary:#000;--color-primary:var(--github-primary);--color-primary-hover:var(--github-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=github\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--github-primary)85%,transparent)}}.fui-provider__button[data-provider=github\.com][data-themed=true]{--color-primary-surface:#fff;--color-border:var(--github-primary)}@media (prefers-color-scheme:dark){.fui-provider__button[data-provider=github\.com][data-themed=true]{--github-primary:var(--color-white);--color-primary:var(--github-primary);--color-primary-hover:var(--github-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=github\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--github-primary)85%,transparent)}}.fui-provider__button[data-provider=github\.com][data-themed=true]{--color-primary-surface:var(--color-black);--color-border:var(--color-white)}}.fui-provider__button[data-provider=microsoft\.com][data-themed=true]{--microsoft-primary:#2f2f2f;--color-primary:var(--microsoft-primary);--color-primary-hover:var(--microsoft-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=microsoft\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--microsoft-primary)85%,transparent)}}.fui-provider__button[data-provider=microsoft\.com][data-themed=true]{--color-primary-surface:#fff;--color-border:var(--microsoft-primary)}@media (prefers-color-scheme:dark){.fui-provider__button[data-provider=microsoft\.com][data-themed=true]{--microsoft-primary:var(--color-white);--color-primary:var(--microsoft-primary);--color-primary-hover:var(--microsoft-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=microsoft\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--microsoft-primary)85%,transparent)}}.fui-provider__button[data-provider=microsoft\.com][data-themed=true]{--color-primary-surface:#5e5e5e;--color-border:var(--color-white)}}.fui-provider__button[data-provider=twitter\.com][data-themed=true]{--twitter-primary:#1da1f2;--color-primary:var(--twitter-primary);--color-primary-hover:var(--twitter-primary)}@supports (color:color-mix(in lab, red, red)){.fui-provider__button[data-provider=twitter\.com][data-themed=true]{--color-primary-hover:color-mix(in oklab,var(--twitter-primary)85%,transparent)}}.fui-provider__button[data-provider=twitter\.com][data-themed=true]{--color-primary-surface:#fff;--color-border:var(--twitter-primary)}}@layer utilities;@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-y{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-z{syntax:"*";inherits:false;initial-value:0}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@firebase-oss/ui-styles",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "style": "./dist.css",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./dist.css": "./dist.css",
+    "./tailwind": "./src/base.css",
+    "./themes/*": "./src/themes/*.css"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist.css",
+    "src"
+  ],
+  "scripts": {
+    "prepare": "pnpm run build",
+    "build": "tsup && pnpm run build:css",
+    "build:css": "pnpm dlx @tailwindcss/cli -i ./src.css -o ./dist.css --minify",
+    "build:local": "pnpm run build && pnpm pack",
+    "lint": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "clean": "rimraf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "publish:tags": "sh -c 'TAG=\"${npm_package_name}@${npm_package_version}\"; git tag --list \"$TAG\" | grep . || git tag \"$TAG\"; git push origin \"$TAG\"'",
+    "release": "pnpm run build && pnpm pack --pack-destination ../../releases/"
+  },
+  "devDependencies": {
+    "rimraf": "catalog:",
+    "tailwindcss": "catalog:",
+    "tsup": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  },
+  "dependencies": {
+    "cva": "1.0.0-beta.4"
+  }
+}

package/src/base.css

@@ -0,0 +1,319 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@layer theme {
+  :root {
+    /* The primary color is used for the button and link colors */
+    --fui-primary: var(--color-black);
+    /* The primary hover color is used for the button and link colors when hovered */
+    --fui-primary-hover: --alpha(var(--fui-primary) / 85%);
+    /* The primary surface color is used for the button text color */
+    --fui-primary-surface: var(--color-white);
+    /* The text color used for body text */
+    --fui-text: var(--color-black);
+    /* The muted text color used for body text, such as subtitles */
+    --fui-text-muted: var(--color-gray-800);
+    /* The background color of the cards */
+    --fui-background: var(--color-white);
+    /* The border color used for none input fields */
+    --fui-border: var(--color-gray-200);
+    /* The input color used for input fields */
+    --fui-input: var(--color-gray-300);
+    /* The error color used for error messages */
+    --fui-error: var(--color-red-500);
+    /* The radius used for the input fields */
+    --fui-radius: var(--radius-sm);
+    /* The radius used for the cards */
+    --fui-radius-card: var(--radius-xl);
+  }
+
+  /* Apply dark mode styles when the dark variant is applied */
+  /* See https://tailwindcss.com/docs/dark-mode */
+  @variant dark {
+    :root {
+      --fui-primary: var(--color-white);
+      --fui-primary-hover: --alpha(var(--fui-primary) / 85%);
+      --fui-primary-surface: var(--color-black);
+      --fui-text: var(--color-white);
+      --fui-text-muted: var(--color-gray-200);
+      --fui-background: var(--color-black);
+      --fui-border: var(--color-gray-200);
+      --fui-input: var(--color-gray-300);
+      --fui-error: var(--color-red-500);
+      --fui-radius: var(--radius-sm);
+      --fui-radius-card: var(--radius-xl);
+    }
+  }
+}
+
+@theme {
+  --color-primary: var(--fui-primary);
+  --color-primary-hover: var(--fui-primary-hover);
+  --color-primary-surface: var(--fui-primary-surface);
+  --color-text: var(--fui-text);
+  --color-text-muted: var(--fui-text-muted);
+  --color-background: var(--fui-background);
+  --color-border: var(--fui-border);
+  --color-input: var(--fui-input);
+  --color-error: var(--fui-error);
+  --radius: var(--fui-radius);
+  --radius-card: var(--fui-radius-card);
+}
+
+@layer components {
+  /* Using :where() to reduce CSS specificity - allows users to easily override with their own Tailwind classes */
+  :where(.fui-screen) {
+    @apply pt-24 max-w-md mx-auto;
+  }
+
+  :where(.fui-screen .fui-screen__children) {
+    @apply space-y-2;
+  }
+
+  :where(.fui-content) {
+    @apply space-y-2;
+    
+  }
+
+  :where(.fui-card) {
+    @apply bg-background p-10 border border-border rounded-card space-y-6;
+  }
+
+  :where(.fui-card__header) {
+    @apply text-center space-y-1;
+  }
+
+  :where(.fui-card__title) {
+    @apply text-xl font-bold text-text;
+  }
+
+  :where(.fui-card__subtitle) {
+    @apply text-sm text-text-muted;
+  }
+
+  :where(.fui-form) {
+    @apply space-y-6;
+  }
+
+  :where(.fui-form fieldset),
+  :where(.fui-form fieldset label) {
+    @apply flex flex-col gap-2 text-text;
+  }
+
+  :where(.fui-form fieldset label div[data-input-label]) {
+    @apply flex gap-3 text-sm font-medium;
+  }
+
+  :where(.fui-form fieldset label div[data-input-label] > div:first-child) {
+    @apply grow;
+  }
+
+  :where(.fui-form .fui-form__action) {
+    @apply px-1 hover:underline text-xs text-text-muted;
+  }
+
+  :where(.fui-form fieldset label input) {
+    @apply w-full border border-input rounded px-2 py-2 text-sm focus:outline-2 focus:outline-primary shadow-xs bg-transparent;
+  }
+
+  :where(.fui-form fieldset label input[aria-invalid="true"]) {
+    @apply border-error outline-error outline-2;
+  }
+
+  :where(.fui-form fieldset label div[data-input-group]) {
+    @apply flex items-center gap-2;
+  }
+
+  :where(.fui-form .fui-form__error) {
+    @apply text-error text-left text-xs;
+  }
+
+  :where(.fui-success) {
+    @apply text-center text-xs;
+  }
+
+  :where(.fui-button) {
+    @apply w-full flex items-center justify-center gap-3 px-4 py-2 rounded text-sm font-medium shadow-xs bg-primary text-primary-surface transition hover:bg-primary-hover hover:cursor-pointer disabled:opacity-50 disabled:cursor-not-allowed;
+  }
+
+  :where(.fui-button--secondary) {
+    @apply bg-transparent text-text border border-input hover:bg-background hover:border-primary;
+  }
+
+  :where(.fui-button.fui-provider__button) {
+    @apply border border-border;
+  }
+
+  :where(.fui-provider__button > svg, .fui-provider__button > img) {
+    @apply w-5 h-5;
+  }
+
+  :where(.fui-divider) {
+    @apply flex items-center gap-3 my-4;
+  }
+
+  :where(.fui-divider__line) {
+    @apply flex-1 h-px bg-border;
+  }
+
+  :where(.fui-divider__text) {
+    @apply text-text-muted text-xs;
+  }
+
+  :where(.fui-phone-input) {
+    @apply flex gap-2 items-center;
+  }
+
+  :where(.fui-phone-input__number-input) {
+    @apply border-1 border-input rounded px-2 py-2 text-sm focus:outline-2 focus:outline-primary shadow-xs bg-transparent flex-1;
+  }
+
+  :where(.fui-phone-input__number-input[aria-invalid="true"]) {
+    @apply outline-error outline-2;
+  }
+
+  :where(.fui-country-selector) {
+    @apply relative inline-block w-[120px];
+  }
+
+  :where(.fui-country-selector__wrapper) {
+    @apply relative flex items-center outline-1 outline-input rounded bg-transparent overflow-hidden;
+  }
+
+  :where(.fui-country-selector__flag) {
+    @apply absolute left-2 text-lg pointer-events-none;
+  }
+
+  :where(.fui-country-selector select) {
+    @apply w-full pl-8 pr-2 py-2 text-sm focus:outline-2 focus:outline-primary shadow-xs bg-transparent appearance-none cursor-pointer text-transparent;
+  }
+
+  :where(.fui-country-selector__dial-code) {
+    @apply absolute left-8 top-1/2 -translate-y-1/2 text-sm pointer-events-none text-text;
+  }
+
+  :where(.fui-form fieldset label div[data-input-group]:has(input[aria-invalid="true"]) .fui-country-selector) {
+    @apply outline-error outline-2 rounded;
+  }
+
+  :where(.fui-form fieldset label div[data-input-group]:has(input[aria-invalid="true"]) .fui-country-selector .fui-country-selector__wrapper) {
+    @apply outline-error outline-2 rounded;
+  }
+  
+  :where(.fui-policies) {
+    @apply text-text-muted text-center text-xs;
+  }
+
+  :where(.fui-policies a, .fui-policies button) {
+    @apply hover:underline font-semibold;
+  }
+
+  .fui-provider__button[data-provider="google.com"][data-themed="true"] {
+    --google-primary: #131314;
+    --color-primary: var(--google-primary);
+    --color-primary-hover: --alpha(var(--google-primary) / 85%);
+    --color-primary-surface: #FFFFFF;
+    --color-border: var(--google-primary);
+  }
+
+  .fui-provider__button[data-provider="google.com"][data-themed="neutral"] {
+    --google-primary: #F2F2F2;
+    --color-primary: var(--google-primary);
+    --color-primary-hover: --alpha(var(--google-primary) / 85%);
+    --color-primary-surface: #1F1F1F;
+    --color-border: transparent;
+  }
+
+  @variant dark {
+    .fui-provider__button[data-provider="google.com"][data-themed="true"] {
+      --google-primary: #FFFFFF;
+      --color-primary: var(--google-primary);
+      --color-primary-hover: --alpha(var(--google-primary) / 85%);
+      --color-primary-surface: #1F1F1F;
+      --color-border: #747775;
+    }
+  }
+
+  .fui-provider__button[data-provider="facebook.com"][data-themed="true"] {
+    --facebook-primary: #1877F2;
+    --color-primary: var(--facebook-primary);
+    --color-primary-hover: --alpha(var(--facebook-primary) / 85%);
+    --color-primary-surface: var(--color-white);
+    --color-border: var(--facebook-primary);
+  }
+
+  .fui-provider__button[data-provider="apple.com"][data-themed="true"] {
+    --apple-primary: #000000;
+    --color-primary: var(--apple-primary);
+    --color-primary-hover: --alpha(var(--apple-primary) / 85%);
+    --color-primary-surface: #FFFFFF;
+    --color-border: var(--apple-primary);
+  }
+
+  @variant dark {
+    .fui-provider__button[data-provider="apple.com"][data-themed="true"] {
+      --apple-primary: var(--color-white);
+      --color-primary: var(--apple-primary);
+      --color-primary-hover: --alpha(var(--apple-primary) / 85%);
+      --color-primary-surface: var(--color-black);
+      --color-border: var(--color-white);
+    }
+  }
+
+  .fui-provider__button[data-provider="github.com"][data-themed="true"] {
+    --github-primary: #000000;
+    --color-primary: var(--github-primary);
+    --color-primary-hover: --alpha(var(--github-primary) / 85%);
+    --color-primary-surface: #FFFFFF;
+    --color-border: var(--github-primary);
+  }
+
+  @variant dark {
+    .fui-provider__button[data-provider="github.com"][data-themed="true"] {
+      --github-primary: var(--color-white);
+      --color-primary: var(--github-primary);
+      --color-primary-hover: --alpha(var(--github-primary) / 85%);
+      --color-primary-surface: var(--color-black);
+      --color-border: var(--color-white);
+    }
+  }
+
+  .fui-provider__button[data-provider="microsoft.com"][data-themed="true"] {
+    --microsoft-primary: #2F2F2F;
+    --color-primary: var(--microsoft-primary);
+    --color-primary-hover: --alpha(var(--microsoft-primary) / 85%);
+    --color-primary-surface: #FFFFFF;
+    --color-border: var(--microsoft-primary);
+  }
+
+  @variant dark {
+    .fui-provider__button[data-provider="microsoft.com"][data-themed="true"] {
+      --microsoft-primary: var(--color-white);
+      --color-primary: var(--microsoft-primary);
+      --color-primary-hover: --alpha(var(--microsoft-primary) / 85%);
+      --color-primary-surface: #5E5E5E;
+      --color-border: var(--color-white);
+    }
+  }
+  
+  .fui-provider__button[data-provider="twitter.com"][data-themed="true"] {
+    --twitter-primary: #1DA1F2;
+    --color-primary: var(--twitter-primary);
+    --color-primary-hover: --alpha(var(--twitter-primary) / 85%);
+    --color-primary-surface: #FFFFFF;
+    --color-border: var(--twitter-primary);
+  }
+}

package/src/base.test.ts

@@ -0,0 +1,319 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+
+/**
+ * CSS Specificity Test Suite
+ *
+ * This test suite verifies that our :where() pseudo-class implementation
+ * correctly reduces CSS specificity, allowing users to easily override
+ * component styles with their own Tailwind classes.
+ */
+
+describe("Tailwind :where() pseudo-class", () => {
+  let testContainer: HTMLDivElement;
+  let styleElement: HTMLStyleElement;
+
+  beforeEach(() => {
+    // Create a test container
+    testContainer = document.createElement("div");
+    document.body.appendChild(testContainer);
+
+    // Create a style element to inject our CSS
+    styleElement = document.createElement("style");
+    document.head.appendChild(styleElement);
+  });
+
+  afterEach(() => {
+    // Clean up
+    document.body.removeChild(testContainer);
+    document.head.removeChild(styleElement);
+  });
+
+  /**
+   * Helper function to get computed styles for an element
+   */
+  function getComputedStyleValue(element: HTMLElement, property: string): string {
+    return window.getComputedStyle(element).getPropertyValue(property);
+  }
+
+  /**
+   * Helper function to create a test element with specific classes
+   */
+  function createTestElement(classes: string): HTMLElement {
+    const element = document.createElement("div");
+    element.className = classes;
+    testContainer.appendChild(element);
+    return element;
+  }
+
+  describe("Basic :where() specificity test", () => {
+    it("should demonstrate that :where() has zero specificity", () => {
+      // Create CSS that shows specificity difference
+      styleElement.textContent = `
+        /* Regular class selector (specificity: 0,0,1,0) */
+        .regular-class {
+          color: red;
+        }
+        
+        /* :where() pseudo-class (specificity: 0,0,0,0) */
+        :where(.where-class) {
+          color: blue;
+        }
+        
+        /* User class (specificity: 0,0,1,0) */
+        .user-override {
+          color: green;
+        }
+      `;
+
+      // Test regular class vs user override
+      const regularElement = createTestElement("regular-class user-override");
+      expect(getComputedStyleValue(regularElement, "color")).toBe("rgb(0, 128, 0)"); // green wins
+
+      // Test :where() class vs user override
+      const whereElement = createTestElement("where-class user-override");
+      expect(getComputedStyleValue(whereElement, "color")).toBe("rgb(0, 128, 0)"); // green wins easily
+    });
+
+    it("should allow user classes to override :where() styles", () => {
+      // Inject CSS with :where() pseudo-class
+      styleElement.textContent = `
+        :where(.fui-screen) {
+          padding-top: 6rem;
+          max-width: 28rem;
+          margin-left: auto;
+          margin-right: auto;
+        }
+        
+        /* User override classes */
+        .pt-32 { padding-top: 8rem !important; }
+        .max-w-lg { max-width: 32rem !important; }
+      `;
+
+      // Create element with both fui-screen and user override classes
+      const element = createTestElement("fui-screen pt-32 max-w-lg");
+
+      // User classes should override the :where() styles
+      expect(getComputedStyleValue(element, "padding-top")).toBe("8rem"); // pt-32 overrides pt-24
+      expect(getComputedStyleValue(element, "max-width")).toBe("32rem"); // max-w-lg overrides max-w-md
+    });
+
+    it("should maintain :where() styles when no user overrides are present", () => {
+      styleElement.textContent = `
+        :where(.fui-screen) {
+          padding-top: 6rem;
+          max-width: 28rem;
+          margin-left: auto;
+          margin-right: auto;
+        }
+      `;
+
+      const element = createTestElement("fui-screen");
+
+      // Should maintain original styles
+      expect(getComputedStyleValue(element, "padding-top")).toBe("6rem");
+      expect(getComputedStyleValue(element, "max-width")).toBe("28rem");
+    });
+  });
+
+  describe("Complex selectors with :where()", () => {
+    it("should handle nested selectors with :where() correctly", () => {
+      styleElement.textContent = `
+        :where(.fui-form fieldset > label > input) {
+          border: 1px solid #d1d5db;
+          border-radius: 0.25rem;
+          padding: 0.5rem;
+          font-size: 0.875rem;
+          background-color: transparent;
+        }
+        
+        /* User override classes */
+        .border-red-500 { border-color: rgb(239, 68, 68) !important; }
+        .rounded-lg { border-radius: 0.5rem !important; }
+        .p-3 { padding: 0.75rem !important; }
+      `;
+
+      // Create nested structure
+      const form = document.createElement("div");
+      form.className = "fui-form";
+      const fieldset = document.createElement("fieldset");
+      const label = document.createElement("label");
+      const input = document.createElement("input");
+
+      fieldset.appendChild(label);
+      label.appendChild(input);
+      form.appendChild(fieldset);
+      testContainer.appendChild(form);
+
+      // Add user override classes
+      input.className = "border-red-500 rounded-lg p-3";
+
+      // User classes should override
+      expect(getComputedStyleValue(input, "border-color")).toBe("rgb(239, 68, 68)"); // border-red-500
+      expect(getComputedStyleValue(input, "border-radius")).toBe("0.5rem"); // rounded-lg
+      expect(getComputedStyleValue(input, "padding")).toBe("0.75rem"); // p-3
+    });
+  });
+
+  describe("Edge cases", () => {
+    it("should handle empty :where() selectors gracefully", () => {
+      styleElement.textContent = `
+        :where() {
+          color: red;
+        }
+      `;
+
+      const element = createTestElement("test-class");
+      // Should not apply any styles (empty selector)
+      expect(getComputedStyleValue(element, "color")).not.toBe("rgb(255, 0, 0)");
+    });
+
+    it("should handle :where() with attribute selectors", () => {
+      styleElement.textContent = `
+        :where(.fui-form fieldset > label > input[aria-invalid="true"]) {
+          outline: 2px solid red;
+        }
+        
+        /* User override classes */
+        .outline-blue-500 { outline-color: rgb(59, 130, 246) !important; }
+        .outline-4 { outline-width: 4px !important; }
+      `;
+
+      const form = document.createElement("div");
+      form.className = "fui-form";
+      const fieldset = document.createElement("fieldset");
+      const label = document.createElement("label");
+      const input = document.createElement("input");
+      input.setAttribute("aria-invalid", "true");
+
+      fieldset.appendChild(label);
+      label.appendChild(input);
+      form.appendChild(fieldset);
+      testContainer.appendChild(form);
+
+      // Add user override
+      input.className = "outline-blue-500 outline-4";
+
+      // User classes should override
+      expect(getComputedStyleValue(input, "outline-color")).toBe("rgb(59, 130, 246)"); // outline-blue-500
+      expect(getComputedStyleValue(input, "outline-width")).toBe("4px"); // outline-4
+    });
+  });
+
+  describe("Component integration tests", () => {
+    it("should verify layout components (screen, card) styles can be overridden", () => {
+      styleElement.textContent = `
+        /* Base component styles with :where() for zero specificity */
+        :where(.fui-screen) { padding-top: 6rem; max-width: 28rem; }
+        :where(.fui-card) { background-color: white; padding: 2.5rem; }
+        
+        /* User Tailwind override classes */
+        .pt-8 { padding-top: 2rem !important; }
+        .max-w-lg { max-width: 32rem !important; }
+        .p-6 { padding: 1.5rem !important; }
+        .bg-gray-50 { background-color: rgb(249, 250, 251) !important; }
+      `;
+
+      const screenElement = createTestElement("fui-screen pt-8 max-w-lg");
+      const cardElement = createTestElement("fui-card p-6 bg-gray-50");
+
+      expect(getComputedStyleValue(screenElement, "padding-top")).toBe("2rem");
+      expect(getComputedStyleValue(cardElement, "background-color")).toBe("rgb(249, 250, 251)");
+    });
+
+    it("should verify button components styles can be overridden", () => {
+      styleElement.textContent = `
+        /* Base component styles with :where() for zero specificity */
+        :where(.fui-button) { background-color: black; color: white; padding: 0.5rem 1rem; }
+        :where(.fui-button--secondary) { background-color: transparent; border: 1px solid rgb(209, 213, 219); }
+        
+        /* User Tailwind override classes */
+        .bg-blue-500 { background-color: rgb(59, 130, 246) !important; }
+        .px-6 { padding-left: 1.5rem !important; padding-right: 1.5rem !important; }
+        .bg-gray-100 { background-color: rgb(243, 244, 246) !important; }
+      `;
+
+      const primaryButton = createTestElement("fui-button bg-blue-500 px-6");
+      const secondaryButton = createTestElement("fui-button--secondary bg-gray-100");
+
+      expect(getComputedStyleValue(primaryButton, "background-color")).toBe("rgb(59, 130, 246)");
+      expect(getComputedStyleValue(secondaryButton, "background-color")).toBe("rgb(243, 244, 246)");
+    });
+
+    it("should verify form components styles can be overridden", () => {
+      styleElement.textContent = `
+        /* Base component styles with :where() for zero specificity */
+        :where(.fui-form fieldset > label > input) { border: 1px solid rgb(209, 213, 219); padding: 0.5rem; }
+        :where(.fui-form .fui-form__error) { color: rgb(239, 68, 68); }
+        
+        /* User Tailwind override classes */
+        .border-gray-300 { border-color: rgb(209, 213, 219) !important; }
+        .px-3 { padding-left: 0.75rem !important; padding-right: 0.75rem !important; }
+        .text-red-600 { color: rgb(220, 38, 38) !important; }
+      `;
+
+      const inputElement = createTestElement("border-gray-300 px-3");
+      const errorElement = createTestElement("fui-form__error text-red-600");
+
+      expect(getComputedStyleValue(inputElement, "border-color")).toBe("rgb(209, 213, 219)");
+      expect(getComputedStyleValue(errorElement, "color")).toBe("rgb(220, 38, 38)");
+    });
+
+    it("should verify utility components (divider, success) styles can be overridden", () => {
+      styleElement.textContent = `
+        /* Base component styles with :where() for zero specificity */
+        :where(.fui-divider) { display: flex; gap: 0.75rem; }
+        :where(.fui-divider__line) { background-color: rgb(229, 231, 235); }
+        :where(.fui-success) { text-align: center; font-size: 0.75rem; }
+        
+        /* User Tailwind override classes */
+        .gap-2 { gap: 0.5rem !important; }
+        .bg-gray-300 { background-color: rgb(209, 213, 219) !important; }
+        .text-left { text-align: left !important; }
+        .text-sm { font-size: 0.875rem !important; }
+      `;
+
+      const dividerElement = createTestElement("fui-divider gap-2");
+      const lineElement = createTestElement("fui-divider__line bg-gray-300");
+      const successElement = createTestElement("fui-success text-left text-sm");
+
+      expect(getComputedStyleValue(dividerElement, "gap")).toBe("0.5rem");
+      expect(getComputedStyleValue(lineElement, "background-color")).toBe("rgb(209, 213, 219)");
+      expect(getComputedStyleValue(successElement, "text-align")).toBe("left");
+    });
+
+    it("should verify complex input components (phone, country) styles can be overridden", () => {
+      styleElement.textContent = `
+        /* Base component styles with :where() for zero specificity */
+        :where(.fui-phone-input) { display: flex; gap: 0.5rem; }
+        :where(.fui-country-selector) { width: 80px; }
+        
+        /* User Tailwind override classes */
+        .gap-2 { gap: 0.5rem !important; }
+        .w-24 { width: 6rem !important; }
+        .bg-gray-50 { background-color: rgb(249, 250, 251) !important; }
+      `;
+
+      const phoneElement = createTestElement("fui-phone-input gap-2");
+      const countryElement = createTestElement("fui-country-selector w-24 bg-gray-50");
+
+      expect(getComputedStyleValue(phoneElement, "gap")).toBe("0.5rem");
+      expect(getComputedStyleValue(countryElement, "width")).toBe("6rem");
+    });
+  });
+});

package/src/index.test.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE/2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { describe, it, expect } from "vitest";
+import { buttonVariant, type ButtonVariant } from "./index";
+
+describe("buttonVariant", () => {
+  it("should return base class when no variant is provided", () => {
+    const result = buttonVariant();
+    expect(result).toBe("fui-button");
+  });
+
+  it("should return base class with primary variant (default)", () => {
+    const result = buttonVariant({ variant: "primary" });
+    expect(result).toBe("fui-button");
+  });
+
+  it("should return base class with secondary variant", () => {
+    const result = buttonVariant({ variant: "secondary" });
+    expect(result).toBe("fui-button fui-button--secondary");
+  });
+
+  it("should handle empty variant object", () => {
+    const result = buttonVariant({});
+    expect(result).toBe("fui-button");
+  });
+
+  it("should handle undefined variant", () => {
+    const result = buttonVariant({ variant: undefined });
+    expect(result).toBe("fui-button");
+  });
+});
+
+describe("ButtonVariant type", () => {
+  it("should accept valid variant values", () => {
+    const primaryVariant: ButtonVariant = "primary";
+    const secondaryVariant: ButtonVariant = "secondary";
+
+    expect(primaryVariant).toBe("primary");
+    expect(secondaryVariant).toBe("secondary");
+  });
+
+  it("should work with buttonVariant function", () => {
+    const variants: ButtonVariant[] = ["primary", "secondary"];
+
+    variants.forEach((variant) => {
+      const result = buttonVariant({ variant });
+      expect(typeof result).toBe("string");
+      expect(result).toContain("fui-button");
+    });
+  });
+});

package/src/index.ts

@@ -0,0 +1,16 @@
+import { cva, type VariantProps } from "cva";
+
+export const buttonVariant = cva({
+  base: "fui-button",
+  variants: {
+    variant: {
+      primary: "",
+      secondary: "fui-button--secondary",
+    },
+  },
+  defaultVariants: {
+    variant: "primary",
+  },
+});
+
+export type ButtonVariant = VariantProps<typeof buttonVariant>["variant"];

package/src/themes/brutalist.css

@@ -0,0 +1,30 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@layer theme {
+  :root {
+    --fui-primary: black;
+    --fui-primary-surface: yellow;
+    --fui-text: black;
+    --fui-text-muted: black;
+    --fui-background: yellow;
+    --fui-border: green;
+    --fui-input: green;
+    --fui-error: blue;
+    --fui-radius: 0;
+    --fui-radius-card: 0;
+  }
+}

package/src/themes/dark.css

@@ -0,0 +1,31 @@
+/**
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@layer theme {
+  :root {
+    --fui-primary: var(--color-white);
+    --fui-primary-hover: --alpha(var(--fui-primary) / 85%);
+    --fui-primary-surface: var(--color-black);
+    --fui-text: var(--color-white);
+    --fui-text-muted: var(--color-gray-200);
+    --fui-background: var(--color-black);
+    --fui-border: var(--color-gray-200);
+    --fui-input: var(--color-gray-300);
+    --fui-error: var(--color-red-500);
+    --fui-radius: var(--radius-sm);
+    --fui-radius-card: var(--radius-xl);
+  }
+}