@qovira/theme 0.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 OMNILIUM ADVANCED CYBERNETICS SRL
+
+   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.

package/README.md

@@ -0,0 +1,246 @@
+# @qovira/theme
+
+Qovira's visual foundation as a distributable package: **Tailwind v4 tokens**,
+**self-hosted fonts**, and a small **framework-agnostic theming runtime**. It is
+the single source of color, type, spacing, radius, elevation, motion, and the two
+themes — **Daylight** and **Evening** — shared by every Qovira surface (the
+product web app and the [qovira.ai](http://qovira.ai) marketing site), so the
+brand stays identical across them without copy-paste.
+
+The package is the _foundation_ a component library is built on — it ships only
+tokens, fonts, and a tiny runtime, and has **no framework dependency**.
+
+> Status: early development. Tokens, fonts, runtime, and utilities are being
+> filled in; some entry points still resolve to placeholders.
+
+## Install
+
+This package requires [Tailwind CSS v4](https://tailwindcss.com) in the consumer
+(both consumers use the `@tailwindcss/vite` plugin). The package manager is
+**pnpm**.
+
+```sh
+pnpm add @qovira/theme
+```
+
+## Usage
+
+### 1. Tokens + fonts — `app.css`
+
+Import order matters: bring in `tailwindcss` **first** so the package's `@theme`
+blocks _extend_ the Tailwind defaults rather than precede them.
+
+```css
+@import "tailwindcss";
+@import "@qovira/theme"; /* tokens + semantic layer + @theme inline */
+@import "@qovira/theme/fonts"; /* self-hosted @font-face (no CDN) */
+```
+
+The fonts are bundled in the package and referenced with relative URLs; Vite
+fingerprints them and serves them from your own origin — no external request.
+
+### 2. Pre-paint theme (no flash) — app shell `<head>`
+
+Inline the boot snippet in the document `<head>` **before any stylesheet** so
+`data-theme` is set on `<html>` before first paint. It resolves the theme as
+`localStorage` → `prefers-color-scheme` → `evening`.
+
+```js
+import { boot } from "@qovira/theme/boot"; // the raw snippet, as a string
+// inject `boot` into a synchronous <script> in <head>
+```
+
+> **SvelteKit:** the boot string must go in `src/app.html` inside `<head>`, **not**
+> a layout — `%sveltekit.head%` runs too late to prevent a flash.
+
+### 3. Toggle / persist — `@qovira/theme/runtime`
+
+```ts
+import {
+  getTheme,
+  setTheme,
+  toggleTheme,
+  subscribe,
+} from "@qovira/theme/runtime";
+```
+
+Framework-agnostic get/set/persist with cross-tab sync. A Svelte store/rune
+wrapper, and the three-state Daylight/Evening/System control, are the app's
+concern — built on `subscribe`.
+
+## Entry points
+
+| Import                  | Resolves to       | Contents                                  |
+| ----------------------- | ----------------- | ----------------------------------------- |
+| `@qovira/theme`         | `dist/theme.css`  | tokens + semantic layer + `@theme inline` |
+| `@qovira/theme/fonts`   | `dist/fonts.css`  | `@font-face` + bundled woff2              |
+| `@qovira/theme/runtime` | `dist/runtime.js` | get/set/persist toggle API                |
+| `@qovira/theme/boot`    | `dist/boot.js`    | the raw pre-paint string, for inlining    |
+
+## Component recipes
+
+These are **reference patterns, not shipped components.** `@qovira/theme` has no
+framework dependency and ships only tokens, utilities, and fonts — a component
+library is built _on top_ of it, separately, in app code. The class strings
+below are copy-pasteable and built entirely from the semantic layer, so **one
+recipe is correct in both Daylight and Evening** with no per-theme edits — the
+`data-theme` attribute on `<html>` does the switching.
+
+### Headings
+
+Pair a family utility with a role size token (font-family isn't carried by the
+`text-*` tokens):
+
+```
+font-display text-h1
+font-display text-h2
+font-sans text-h4
+```
+
+Body copy uses `text-body`, caps measure at `max-w-[70ch]`, and always uses
+`text-text` (never `text-text-muted`).
+
+### Button
+
+Shared base (all variants). Touch contexts bump `h-10` → `h-11` (≥44px):
+
+```
+inline-flex items-center justify-center gap-2 rounded-md text-button h-10 px-4
+select-none transition-[background,box-shadow,transform] duration-micro ease-qovira
+focus-ring disabled:opacity-50 disabled:pointer-events-none
+```
+
+Primary — espresso (Daylight) ↔ honey (Evening), automatic via `--btn-primary`:
+
+```
+bg-btn-primary text-btn-primary-fg hover:bg-btn-primary-hover active:bg-btn-primary-active active:scale-[.99]
+```
+
+Key-CTA — the single most important action; raw honey in both themes. Only
+**one** per view (the ≤10% accent rule):
+
+```
+bg-accent text-warm-900 hover:bg-honey-600 active:bg-honey-700
+```
+
+Secondary — hairline-bordered:
+
+```
+bg-transparent text-text border border-border hover:bg-surface-raised active:bg-warm-200/40
+```
+
+Ghost — text-only:
+
+```
+bg-transparent text-link hover:bg-link/8 active:bg-link/12
+```
+
+Destructive — pair with a confirm for irreversible actions:
+
+```
+bg-error text-white hover:brightness-95 active:brightness-90
+```
+
+### Input
+
+```
+flex h-10 w-full rounded-md px-3 text-body bg-surface-raised text-text border border-border
+placeholder:text-text-muted focus-ring aria-[invalid=true]:border-error disabled:opacity-50
+```
+
+Label uses `text-label text-text-muted`; helper/error text uses `text-small`,
+with the error message in:
+
+```
+text-small text-error-text
+```
+
+Never rely on the red border alone — set `aria-invalid` and show the message.
+
+### Card / panel
+
+```
+rounded-lg bg-surface-raised border border-border p-6 shadow-[var(--shadow-sm)]
+```
+
+Interactive cards add:
+
+```
+focus-ring hover:shadow-[var(--shadow-md)] transition-shadow duration-base ease-qovira
+```
+
+Modals / dialogs use:
+
+```
+rounded-xl shadow-[var(--shadow-lg)]
+```
+
+### Focus
+
+Every interactive element gets the brand's non-negotiable ring. Never removed,
+never a bare `outline: none`:
+
+```
+focus-ring
+```
+
+### Lamp-glow
+
+The signature honey motif — focus emphasis, loaders, special moments; **never**
+general elevation. Static halo:
+
+```
+lamp-glow
+```
+
+As a loader, drive the pulse on a honey radial-gradient. Always provide a
+static / `aria-live` fallback so meaning isn't trapped in animation (the pulse is
+collapsed under `prefers-reduced-motion`):
+
+```
+lamp-glow-pulse
+```
+
+### Chip / pill
+
+```
+inline-flex items-center gap-1 rounded-sm h-7 px-2.5 text-small bg-surface-raised text-text-muted border border-border
+```
+
+Status chips swap to the matching tint/text **with an icon** — never color
+alone:
+
+```
+bg-success-tint text-success-text
+```
+
+Use `rounded-full` only for true pills, toggles, and avatars.
+
+### Guardrails
+
+- **Accent discipline.** Honey covers ≤ ~10% of any screen. Primary actions are
+  espresso (Daylight) / honey (Evening); raw honey is reserved for the one
+  Key-CTA, focus, and highlights.
+- **Accent never signals status.** Status uses the semantic colors only — honey
+  and warning-amber stay distinct so "heads up" never reads as "brand".
+- **Never color alone.** Every status pairs color with an icon or text label;
+  error inputs get `aria-invalid` + a message, not just a red border.
+- **Focus is never removed.** Always the visible 2px honey ring via `focus-ring`;
+  no bare `outline: none`.
+- **Type.** Body copy always uses `text-text`, never `text-text-muted` (muted is
+  for genuinely secondary text — timestamps, counts, hints).
+- **Hit targets.** ≥40px desktop (`h-10`), ≥44px touch (`h-11`).
+
+## Development
+
+```sh
+pnpm install
+pnpm build       # tsup → dist/{runtime,boot}.js + copy CSS/fonts → dist/
+pnpm typecheck   # tsc --noEmit
+pnpm lint        # eslint + prettier --check
+pnpm test        # vitest run
+```
+
+## License
+
+[Apache-2.0](./LICENSE) © OMNILIUM ADVANCED CYBERNETICS SRL

package/dist/boot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pre-paint boot snippet.
+ *
+ * A tiny synchronous IIFE shipped as a STRING so consumers can inline it
+ * verbatim in `<head>` — before any stylesheet — and have `data-theme` set on
+ * `<html>` before first paint (no flash on reload).
+ *
+ * Resolution order, matching the toggle API:
+ *   1. stored choice — localStorage["qovira-theme"], if "daylight" | "evening"
+ *   2. system preference — prefers-color-scheme: dark → "evening", else "daylight"
+ *   3. default — "evening" (also the fallback if anything throws)
+ *
+ * The localStorage key is duplicated here as a literal because this snippet is
+ * standalone (it cannot import from the runtime); a test asserts the two agree.
+ *
+ * SvelteKit: inline this in `src/app.html` inside `<head>`, NOT a layout —
+ * `%sveltekit.head%` runs too late to prevent a flash.
+ */
+declare const boot = "(function () {\n  try {\n    var s = localStorage.getItem(\"qovira-theme\");\n    var t =\n      s === \"daylight\" || s === \"evening\"\n        ? s\n        : matchMedia(\"(prefers-color-scheme: dark)\").matches\n          ? \"evening\"\n          : \"daylight\";\n    document.documentElement.setAttribute(\"data-theme\", t);\n  } catch (e) {\n    document.documentElement.setAttribute(\"data-theme\", \"evening\");\n  }\n})();";
+
+export { boot };

package/dist/boot.js

@@ -0,0 +1,18 @@
+// src/runtime/boot.ts
+var boot = `(function () {
+  try {
+    var s = localStorage.getItem("qovira-theme");
+    var t =
+      s === "daylight" || s === "evening"
+        ? s
+        : matchMedia("(prefers-color-scheme: dark)").matches
+          ? "evening"
+          : "daylight";
+    document.documentElement.setAttribute("data-theme", t);
+  } catch (e) {
+    document.documentElement.setAttribute("data-theme", "evening");
+  }
+})();`;
+export {
+  boot
+};

package/dist/fonts/figtree-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2022 The Figtree Project Authors (https://github.com/erikdkennedy/figtree) Figtree-Italic[wght].ttf: Copyright 2022 The Figtree Project Authors (https://github.com/erikdkennedy/figtree)
+
+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:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+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.

package/dist/fonts/fraunces-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Fraunces Project Authors (github.com/undercasetype/Fraunces) Fraunces-Italic[SOFT,WONK,opsz,wght].ttf: Copyright 2020 The Fraunces Project Authors (github.com/undercasetype/Fraunces)
+
+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:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+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.

package/dist/fonts/jetbrains-mono-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono) JetBrainsMono-Italic[wght].ttf: Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+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:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+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.

package/dist/fonts.css

@@ -0,0 +1,45 @@
+/*
+ * @qovira/theme/fonts — self-hosted @font-face.
+ *
+ * The three brand families ship as variable woff2 bundled in this package under
+ * `fonts/` and referenced with RELATIVE urls, so there is no font-CDN and no
+ * external request (the privacy-and-offline ethos). A consumer's Vite build
+ * fingerprints these files and serves them from the consumer's own origin.
+ *
+ * `font-display: swap` renders the fallback stack immediately, then swaps to the
+ * web font once loaded — the fallback stacks live on the `--font-*` tokens
+ * (Fraunces→Georgia→serif, Figtree→system-ui→sans-serif,
+ * JetBrains Mono→ui-monospace→monospace), so layout holds before the swap.
+ *
+ * Each is a single variable file spanning the weight axis. Fraunces also carries
+ * its optical-size, SOFT and WONK axes — `font-optical-sizing: auto` (the CSS
+ * default) drives opsz automatically; SOFT/WONK can be tuned per use via
+ * `font-variation-settings` (the brand default is gentle SOFT, WONK off).
+ *
+ * Fonts are licensed under the SIL Open Font License 1.1; see the per-family
+ * OFL texts alongside the woff2 in `fonts/`.
+ */
+
+@font-face {
+  font-family: "Fraunces";
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 900;
+  src: url("./fonts/fraunces-variable.woff2") format("woff2");
+}
+
+@font-face {
+  font-family: "Figtree";
+  font-style: normal;
+  font-display: swap;
+  font-weight: 300 900;
+  src: url("./fonts/figtree-variable.woff2") format("woff2");
+}
+
+@font-face {
+  font-family: "JetBrains Mono";
+  font-style: normal;
+  font-display: swap;
+  font-weight: 100 800;
+  src: url("./fonts/jetbrains-mono-variable.woff2") format("woff2");
+}

package/dist/runtime.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Theme runtime — framework-agnostic get/set/persist for the active theme.
+ *
+ * The active theme is the `data-theme` attribute on `<html>`, always one of
+ * `daylight` | `evening`; everything visual keys off it through the semantic
+ * layer. This module reads and writes that attribute and the `qovira-theme`
+ * localStorage key, and notifies subscribers — including across tabs via the
+ * `storage` event. Pre-paint application is the boot snippet's job (`./boot`);
+ * a Svelte store/rune wrapper and the theme-control UI are the app's concern.
+ */
+type Theme = "daylight" | "evening";
+type Listener = (theme: Theme) => void;
+/** The current theme — the `data-theme` attribute, or the resolved default. */
+declare function getTheme(): Theme;
+/**
+ * Apply and persist a theme. `setTheme(null)` clears the stored choice and
+ * re-resolves from the system preference (i.e. follow system again).
+ */
+declare function setTheme(theme: Theme | null): void;
+/** Flip between the two themes and return the new value. */
+declare function toggleTheme(): Theme;
+/**
+ * Subscribe to theme changes (this tab via set/toggle, other tabs via the
+ * `storage` event). Returns an unsubscribe function.
+ */
+declare function subscribe(callback: Listener): () => void;
+
+export { type Theme, getTheme, setTheme, subscribe, toggleTheme };

package/dist/runtime.js

@@ -0,0 +1,72 @@
+// src/runtime/theme.ts
+var STORAGE_KEY = "qovira-theme";
+var listeners = /* @__PURE__ */ new Set();
+var storageBound = false;
+function isTheme(value) {
+  return value === "daylight" || value === "evening";
+}
+function resolve() {
+  try {
+    const stored = localStorage.getItem(STORAGE_KEY);
+    if (isTheme(stored)) return stored;
+    return matchMedia("(prefers-color-scheme: dark)").matches ? "evening" : "daylight";
+  } catch {
+    return "evening";
+  }
+}
+function apply(theme) {
+  document.documentElement.setAttribute("data-theme", theme);
+}
+function emit(theme) {
+  for (const listener of listeners) listener(theme);
+}
+function bindStorage() {
+  if (storageBound) return;
+  storageBound = true;
+  window.addEventListener("storage", (event) => {
+    if (event.key !== STORAGE_KEY) return;
+    const next = resolve();
+    apply(next);
+    emit(next);
+  });
+}
+function getTheme() {
+  const attr = document.documentElement.getAttribute("data-theme");
+  return isTheme(attr) ? attr : resolve();
+}
+function setTheme(theme) {
+  if (theme === null) {
+    try {
+      localStorage.removeItem(STORAGE_KEY);
+    } catch {
+    }
+    const next = resolve();
+    apply(next);
+    emit(next);
+    return;
+  }
+  try {
+    localStorage.setItem(STORAGE_KEY, theme);
+  } catch {
+  }
+  apply(theme);
+  emit(theme);
+}
+function toggleTheme() {
+  const next = getTheme() === "evening" ? "daylight" : "evening";
+  setTheme(next);
+  return next;
+}
+function subscribe(callback) {
+  listeners.add(callback);
+  bindStorage();
+  return () => {
+    listeners.delete(callback);
+  };
+}
+export {
+  getTheme,
+  setTheme,
+  subscribe,
+  toggleTheme
+};

package/dist/theme.css

@@ -0,0 +1,347 @@
+/*
+ * @qovira/theme — token entry.
+ *
+ * Three-layer token architecture:
+ *   - Layer 1 — @theme primitives (this file, theme-agnostic)
+ *   - Layer 2 — semantic [data-theme] aliases (theme-aware)
+ *   - Layer 3 — @theme inline exposure of the semantic layer
+ *   - utilities (focus-ring, lamp-glow, duration-*) + the motion guard
+ *
+ * Consumers import this AFTER `@import "tailwindcss";` so these @theme blocks
+ * EXTEND the Tailwind defaults rather than precede them.
+ *
+ * All values are transcribed verbatim from Brand & Design (design doc §5).
+ */
+
+/* ─────────────────────────────────────────────────────────────────────────
+ * Layer 1 — Primitives (theme-agnostic; identical in Daylight and Evening).
+ * Declared in @theme so Tailwind generates the usual utilities
+ * (bg-honey-500, text-warm-700, rounded-md, font-display, text-h1, ease-qovira).
+ * ──────────────────────────────────────────────────────────────────────── */
+@theme {
+  /* Warm neutrals — espresso ↔ cream ramp */
+  --color-warm-50: #faf6ef;
+  --color-warm-100: #f1e9dc;
+  --color-warm-200: #e6dac8;
+  --color-warm-300: #d4c4ad;
+  --color-warm-400: #b09a7e;
+  --color-warm-500: #8a745b;
+  --color-warm-600: #6b563f;
+  --color-warm-700: #4a3a2a;
+  --color-warm-800: #2c2118;
+  --color-warm-900: #1e1712;
+
+  /* Honey accent ramp — 500 = brand honey; 600 = hover/press; 800 = AA text/link
+   * on cream (the semantic --link). 700 is AA-large only on cream, so it is not
+   * used for normal-size text. */
+  --color-honey-50: #fcf3e4;
+  --color-honey-100: #f8e6c8;
+  --color-honey-200: #f1d199;
+  --color-honey-300: #ebbe74;
+  --color-honey-400: #e5b063;
+  --color-honey-500: #e0a458;
+  --color-honey-600: #c9883c;
+  --color-honey-700: #a66b28;
+  --color-honey-800: #7e4f1c;
+  --color-honey-900: #573514;
+
+  /* Clay secondary ramp */
+  --color-clay-400: #d08c66;
+  --color-clay-500: #c2754c;
+  --color-clay-600: #a85f3a;
+  --color-clay-700: #8a4b2c;
+
+  /* Status base colors — reserved for meaning, never decoration.
+   * Per-theme tint/text aliases live in the semantic layer. */
+  --color-success: #2f9e6b;
+  --color-warning: #e08a1e;
+  --color-error: #d6452e;
+  --color-info: #3b72c0;
+
+  /* Font families. font-family is intentionally NOT carried by the --text-*
+   * tokens below; headings pair the size token with a family utility, e.g.
+   * `font-display text-h1` (see the component recipes in the README). */
+  --font-display: "Fraunces", Georgia, serif;
+  --font-sans: "Figtree", system-ui, sans-serif;
+  --font-mono: "JetBrains Mono", ui-monospace, monospace;
+
+  /* Radius — overrides Tailwind's defaults; md (10px) is the default for
+   * buttons and inputs. Brand owns these names. */
+  --radius-sm: 8px;
+  --radius-md: 10px;
+  --radius-lg: 14px;
+  --radius-xl: 18px;
+  --radius-full: 999px;
+
+  /* Type scale — role tokens carrying size + line-height + letter-spacing +
+   * weight via the v4 modifier syntax. (text-label additionally pairs with the
+   * `uppercase` utility in recipes; text-transform is not expressible on a
+   * --text-* token.) */
+  --text-display: 3.25rem;
+  --text-display--line-height: 1.05;
+  --text-display--letter-spacing: -0.01em;
+  --text-display--font-weight: 500;
+
+  --text-h1: 2.375rem;
+  --text-h1--line-height: 1.1;
+  --text-h1--letter-spacing: -0.01em;
+  --text-h1--font-weight: 500;
+
+  --text-h2: 1.75rem;
+  --text-h2--line-height: 1.18;
+  --text-h2--letter-spacing: -0.005em;
+  --text-h2--font-weight: 500;
+
+  --text-h3: 1.375rem;
+  --text-h3--line-height: 1.25;
+  --text-h3--font-weight: 600;
+
+  --text-h4: 1.125rem;
+  --text-h4--line-height: 1.3;
+  --text-h4--font-weight: 600;
+
+  --text-lead: 1.125rem;
+  --text-lead--line-height: 1.6;
+  --text-lead--font-weight: 400;
+
+  --text-body: 1rem;
+  --text-body--line-height: 1.6;
+  --text-body--font-weight: 400;
+
+  --text-small: 0.875rem;
+  --text-small--line-height: 1.55;
+  --text-small--font-weight: 400;
+
+  --text-button: 0.875rem;
+  --text-button--letter-spacing: 0.005em;
+  --text-button--font-weight: 500;
+
+  --text-label: 0.75rem;
+  --text-label--letter-spacing: 0.08em;
+  --text-label--font-weight: 600;
+
+  --text-code: 0.875rem;
+  --text-code--line-height: 1.6;
+  --text-code--font-weight: 400;
+
+  /* Motion — easing in the --ease-* namespace so `ease-qovira` generates
+   * natively. (Duration shorthands `duration-micro|base|overlay` are defined as
+   * @utility rules alongside the other utilities; the raw values live below.) */
+  --ease-qovira: cubic-bezier(0.2, 0.8, 0.2, 1);
+}
+
+/* ─────────────────────────────────────────────────────────────────────────
+ * Plain custom properties — NOT Tailwind utility namespaces, so they emit as
+ * regular CSS variables (no utilities generated).
+ *   - durations: consumed by the duration-* @utility shorthands
+ *   - z-index (spec addition): referenced via arbitrary values, e.g.
+ *     `z-[var(--z-modal)]`
+ * ──────────────────────────────────────────────────────────────────────── */
+:root {
+  --duration-micro: 140ms;
+  --duration-base: 200ms;
+  --duration-overlay: 280ms;
+
+  --z-base: 0;
+  --z-dropdown: 1000;
+  --z-sticky: 1100;
+  --z-overlay: 1200;
+  --z-modal: 1300;
+  --z-toast: 1400;
+}
+
+/* ─────────────────────────────────────────────────────────────────────────
+ * Layer 2 — Semantic aliases (theme-aware). Plain custom properties carrying
+ * MEANING, redeclared per theme so they resolve to the right value for the
+ * active `data-theme`. This is the only place a color is tied to a role and the
+ * only place the two themes diverge. Kept OUTSIDE @theme so they can be
+ * redeclared under the attribute selector.
+ *
+ * `:root` always matches <html>, so the daylight block is the default; the
+ * evening block follows it (equal specificity) and wins when data-theme=evening.
+ * ──────────────────────────────────────────────────────────────────────── */
+:root,
+[data-theme="daylight"] {
+  --bg: #f1e9dc; /* app background */
+  --surface: #f1e9dc; /* default surface */
+  --surface-raised: #faf6ef; /* raised cards, input fill */
+  --text: #1e1712; /* primary text (body always uses this) */
+  --text-muted: #5c4a37; /* secondary only — timestamps, counts, hints */
+  --border-hairline: #e6dac8;
+  --accent: #e0a458; /* honey — key CTA, highlights */
+  --link: #7e4f1c; /* honey-800 — AA on cream (5.8:1); honey-700 #a66b28 is AA-large only */
+  --accent-clay: #8a4b2c; /* clay secondary emphasis / links */
+
+  --btn-primary: #1e1712; /* espresso fill */
+  --btn-primary-fg: #f1e9dc;
+  --btn-primary-hover: #2c2118; /* warm-800 */
+  --btn-primary-active: #15100c;
+
+  --focus-ring: #e0a458; /* honey, both themes */
+
+  --shadow-sm:
+    0 1px 2px rgba(30, 24, 18, 0.1), 0 1px 1px rgba(30, 24, 18, 0.06);
+  --shadow-md:
+    0 2px 4px rgba(30, 24, 18, 0.08), 0 8px 20px rgba(30, 24, 18, 0.18);
+  --shadow-lg:
+    0 4px 8px rgba(30, 24, 18, 0.1), 0 20px 48px rgba(30, 24, 18, 0.26);
+  --lamp-glow: 0 0 22px rgba(224, 164, 88, 0.5);
+
+  /* Status tint/text — meaning only, never decoration. */
+  --success-tint: #e2f1ea;
+  --success-text: #1e7a50;
+  --warning-tint: #fbebd2;
+  --warning-text: #855400; /* darkened from #97600f to clear AA (5.5:1 on tint) */
+  --error-tint: #fbe6e1;
+  --error-text: #a8331f;
+  --info-tint: #e5eef9;
+  --info-text: #285699;
+}
+
+[data-theme="evening"] {
+  --bg: #15100c;
+  --surface: #1e1712;
+  --surface-raised: #241b12;
+  --text: #f3ecdf;
+  --text-muted: #b7a892;
+  --border-hairline: #2c2118;
+  --accent: #e0a458;
+  --link: #ebbe74; /* lifted for contrast on dark */
+  --accent-clay: #d08c66;
+
+  --btn-primary: #e0a458; /* honey fill */
+  --btn-primary-fg: #1e1712;
+  --btn-primary-hover: #c9883c; /* honey-600 */
+  --btn-primary-active: #a66b28; /* honey-700 */
+
+  --focus-ring: #e0a458;
+
+  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.24), 0 1px 1px rgba(0, 0, 0, 0.16);
+  --shadow-md: 0 2px 4px rgba(0, 0, 0, 0.28), 0 8px 20px rgba(0, 0, 0, 0.45);
+  --shadow-lg: 0 4px 8px rgba(0, 0, 0, 0.35), 0 20px 48px rgba(0, 0, 0, 0.55);
+  --lamp-glow: 0 0 22px rgba(224, 164, 88, 0.5);
+
+  /* Status tint/text — derived for the dark surface; AA-verified. */
+  --success-tint: #16271e;
+  --success-text: #6fd3a1;
+  --warning-tint: #2a2012;
+  --warning-text: #e9b25e;
+  --error-tint: #2e1813;
+  --error-text: #f0917f;
+  --info-tint: #16213a;
+  --info-text: #8fb4e8;
+}
+
+/* ─────────────────────────────────────────────────────────────────────────
+ * Layer 3 — Tailwind exposure. Re-export the semantic vars as Tailwind theme
+ * tokens. `inline` is the key: it emits `var(--surface)` INTO each utility
+ * instead of freezing the value, so `bg-surface`, `text-text`, `bg-success-tint`
+ * etc. automatically track whichever theme is on <html>.
+ *
+ * Shadows and the lamp glow stay as raw `var(--shadow-*)` / `var(--lamp-glow)`
+ * in recipes — they are not color utilities. `--focus-ring` is consumed directly
+ * by the focus-ring utility, and the status BASE colors come from layer 1.
+ * ──────────────────────────────────────────────────────────────────────── */
+@theme inline {
+  --color-surface: var(--surface);
+  --color-surface-raised: var(--surface-raised);
+  --color-text: var(--text);
+  --color-text-muted: var(--text-muted);
+  --color-border: var(--border-hairline);
+  --color-accent: var(--accent);
+  --color-link: var(--link);
+
+  --color-btn-primary: var(--btn-primary);
+  --color-btn-primary-fg: var(--btn-primary-fg);
+  --color-btn-primary-hover: var(--btn-primary-hover);
+  --color-btn-primary-active: var(--btn-primary-active);
+
+  --color-success-tint: var(--success-tint);
+  --color-success-text: var(--success-text);
+  --color-warning-tint: var(--warning-tint);
+  --color-warning-text: var(--warning-text);
+  --color-error-tint: var(--error-tint);
+  --color-error-text: var(--error-text);
+  --color-info-tint: var(--info-tint);
+  --color-info-text: var(--info-text);
+}
+
+/* ─────────────────────────────────────────────────────────────────────────
+ * Utilities + motion guard. A few `@utility` definitions so components don't
+ * reinvent them, plus the global reduced-motion reset. These consume the
+ * primitive (`--ease-qovira`, `--duration-*`) and semantic (`--surface`,
+ * `--focus-ring`, `--lamp-glow`) tokens.
+ *
+ * `ease-qovira` is NOT defined here — it generates natively from the
+ * `--ease-qovira` primitive in the `--ease-*` namespace.
+ * ──────────────────────────────────────────────────────────────────────── */
+
+/* The brand's non-negotiable focus ring: a 2px surface gap then a 2px honey
+ * ring. Applied to every interactive element; never removed. */
+@utility focus-ring {
+  &:focus-visible {
+    outline: none;
+    box-shadow:
+      0 0 0 2px var(--surface),
+      0 0 0 4px var(--focus-ring);
+  }
+}
+
+/* The signature lamp glow — a soft honey halo for focus emphasis, loaders, and
+ * special moments (never general elevation). */
+@utility lamp-glow {
+  box-shadow: var(--lamp-glow);
+}
+
+/* Loader form: a ~1200ms pulse driving the `qovira-pulse` keyframe. Pair with a
+ * honey radial-gradient background and a static / aria-live fallback so meaning
+ * is never trapped in animation. Collapsed by the reduced-motion guard below. */
+@utility lamp-glow-pulse {
+  animation: qovira-pulse 1200ms var(--ease-qovira) infinite;
+}
+
+@keyframes qovira-pulse {
+  0%,
+  100% {
+    opacity: 0.55;
+    transform: scale(0.92);
+  }
+  50% {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+/* Duration shorthands — v4 has no duration theme namespace, so these expose the
+ * `--duration-*` custom properties as `transition-duration` utilities. */
+@utility duration-micro {
+  transition-duration: var(--duration-micro);
+}
+@utility duration-base {
+  transition-duration: var(--duration-base);
+}
+@utility duration-overlay {
+  transition-duration: var(--duration-overlay);
+}
+
+/* Global reduced-motion guard — one reset so consumers don't each reinvent it.
+ * Meaning is never trapped in animation. */
+@media (prefers-reduced-motion: reduce) {
+  *,
+  ::before,
+  ::after {
+    animation-duration: 0.01ms !important;
+    transition-duration: 0.01ms !important;
+  }
+}
+
+/* For the rare genuine structural (non-color) theme branch — most differences
+ * should be absorbed by the semantic layer, not this variant. */
+@custom-variant evening (&:where([data-theme="evening"] *));
+
+/*
+ * Spacing is intentionally NOT redefined. Brand's 4px base = 0.25rem = Tailwind
+ * v4's default --spacing step exactly, so the brand scale
+ * (4·8·12·16·20·24·32·40·48·64) maps 1:1 to p-1 p-2 p-3 p-4 p-5 p-6 p-8 p-10
+ * p-12 p-16. Rule: no off-grid spacing values — always use the scale steps.
+ */

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@qovira/theme",
+  "version": "0.0.0",
+  "description": "Qovira's visual foundation — Tailwind v4 tokens, self-hosted fonts, and a framework-agnostic theming runtime.",
+  "keywords": [
+    "qovira",
+    "design-tokens",
+    "tailwindcss",
+    "theme",
+    "css"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qovira/theme.git"
+  },
+  "homepage": "https://github.com/qovira/theme#readme",
+  "bugs": "https://github.com/qovira/theme/issues",
+  "type": "module",
+  "packageManager": "pnpm@11.3.0",
+  "engines": {
+    "node": ">=22.18"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "exports": {
+    ".": "./dist/theme.css",
+    "./fonts": "./dist/fonts.css",
+    "./runtime": "./dist/runtime.js",
+    "./boot": "./dist/boot.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/copy-assets.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . && prettier --check .",
+    "format": "prettier --write .",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "tailwindcss": "^4.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@fontsource-variable/figtree": "^5.2.10",
+    "@fontsource-variable/fraunces": "^5.2.9",
+    "@fontsource-variable/jetbrains-mono": "^5.2.8",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@tsconfig/strictest": "^2.0.8",
+    "@types/node": "^25.9.2",
+    "eslint": "^10.4.1",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.6.0",
+    "happy-dom": "^20.10.2",
+    "postcss": "^8.5.15",
+    "prettier": "^3.8.3",
+    "tailwindcss": "^4.3.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.60.1",
+    "vitest": "^4.1.8"
+  }
+}