sunday-serif 0.0.0-stage → 0.2.0

package/OFL.txt

@@ -0,0 +1,94 @@
+Copyright 2026 The Sunday Serif Project Authors (https://github.com/kkratterf/sunday-serif), with Reserved Font Name "Sunday Serif".
+Copyright 2014-2023 Adobe (http://www.adobe.com/), with Reserved Font Name "Source".
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/README.md

@@ -1,3 +1,94 @@
-# Temporary Holding Version
+# sunday-serif
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**A soft serif for slow days.** Free and open-source, with print effects on variable axes.
+
+Webfonts for [Sunday Serif](https://sunday-serif.kkratter.com): a weight axis (400–600) and three effects: Light Burn (`BURN`), Ink Bleed (`INKB`) and
+Worn Print (`WORN`). Desktop fonts (TTF, OTF) are on the
+[GitHub releases](https://github.com/kkratterf/sunday-serif/releases/latest).
+
+```bash
+pnpm add sunday-serif
+```
+
+| Import | Family | What | Size |
+| --- | --- | --- | --- |
+| `sunday-serif/text.css` | `Sunday Serif` | Weight only, effects at their default. For all text | ~45 KB per style |
+| `sunday-serif/fx.css` | `Sunday Serif FX` | Weight plus the three effect axes. Only where effects show | ~500 KB per style |
+| `sunday-serif/grain.css` | `Sunday Serif Grain` | Display cut with the Grain Blur axis (`GRAN`), Regular and Italic | ~1.5 MB per style |
+
+## Next.js
+
+```tsx
+// app/layout.tsx
+import { SundaySerif, SundaySerifFX } from "sunday-serif/next";
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en" className={`${SundaySerif.variable} ${SundaySerifFX.variable}`}>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+
+```css
+body {
+  font-family: var(--font-sunday-serif);
+}
+.headline {
+  font-family: var(--font-sunday-serif-fx);
+  font-weight: 600;
+  font-variation-settings: "BURN" 40, "INKB" 30, "WORN" 0;
+}
+```
+
+`SundaySerif` is preloaded; `SundaySerifFX` is not, so it only downloads
+on pages that use it.
+
+## Any bundler
+
+```js
+import "sunday-serif/text.css";
+import "sunday-serif/fx.css"; // only if you use the effects
+import "sunday-serif/grain.css"; // only if you use Grain Blur
+```
+
+Then use `font-family: "Sunday Serif"`, `"Sunday Serif FX"` and `"Sunday Serif Grain"`.
+
+## Effects
+
+`font-variation-settings` replaces the whole list each time it is set, so set all three
+effects together, for example through custom properties:
+
+```css
+.with-effects {
+  font-family: "Sunday Serif FX", "Sunday Serif", serif;
+  font-variation-settings: "BURN" var(--burn, 0), "INKB" var(--ink, 0), "WORN" var(--worn, 0);
+}
+```
+
+| Axis | Tag | Range | Default |
+| --- | --- | --- | --- |
+| Weight | `wght` | 400–600 | 400 |
+| Light Burn | `BURN` | 0–100 | 0 |
+| Ink Bleed | `INKB` | 0–100 | 0 |
+| Worn Print | `WORN` | 0–100 | 0 |
+
+## Grain Blur
+
+Sunday Serif Grain is a separate display cut: a blur made of grain, like a dithered photo.
+At 0 the letters are plain; towards 100 a cloud of ink dots spreads out from every edge.
+Spacing never changes.
+
+```css
+.grainy {
+  font-family: "Sunday Serif Grain", "Sunday Serif", serif;
+  font-variation-settings: "GRAN" 80;
+}
+```
+
+`SundaySerifGrain` in `sunday-serif/next` sets `--font-sunday-serif-grain`.
+
+## License
+
+[SIL Open Font License 1.1](OFL.txt), with Reserved Font Name "Sunday Serif".

package/fx.css

@@ -0,0 +1,16 @@
+/* Sunday Serif FX: weight plus the BURN, INKB and WORN effect axes (~500 KB per style).
+   Browsers download it only for text that uses the "Sunday Serif FX" family. */
+@font-face {
+  font-family: "Sunday Serif FX";
+  src: url("./fonts/SundaySerif-Variable.woff2") format("woff2");
+  font-weight: 400 600;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Sunday Serif FX";
+  src: url("./fonts/SundaySerif-Italic-Variable.woff2") format("woff2");
+  font-weight: 400 600;
+  font-style: italic;
+  font-display: swap;
+}

package/grain.css

@@ -0,0 +1,16 @@
+/* Sunday Serif Grain: the Grain Blur axis (GRAN 0...100), Regular and Italic (~1.5 MB per style).
+   A display cut: browsers download it only for text that uses the "Sunday Serif Grain" family. */
+@font-face {
+  font-family: "Sunday Serif Grain";
+  src: url("./fonts/SundaySerifGrain-Variable.woff2") format("woff2");
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Sunday Serif Grain";
+  src: url("./fonts/SundaySerifGrain-Italic-Variable.woff2") format("woff2");
+  font-weight: 400;
+  font-style: italic;
+  font-display: swap;
+}

package/next.d.ts

@@ -0,0 +1,8 @@
+import type { NextFontWithVariable } from "next/dist/compiled/@next/font";
+
+/** Text cut: weight 400-600, preloaded. CSS variable `--font-sunday-serif`. */
+export declare const SundaySerif: NextFontWithVariable;
+/** Weight plus BURN, INKB and WORN, not preloaded. CSS variable `--font-sunday-serif-fx`. */
+export declare const SundaySerifFX: NextFontWithVariable;
+/** Display cut with the Grain Blur axis (GRAN), not preloaded. CSS variable `--font-sunday-serif-grain`. */
+export declare const SundaySerifGrain: NextFontWithVariable;

package/next.js

@@ -0,0 +1,39 @@
+// next/font/local resolves these paths at build time, relative to this file.
+import localFont from "next/font/local";
+
+export const SundaySerif = localFont({
+  src: [
+    { path: "./fonts/SundaySerifText-Variable.woff2", weight: "400 600", style: "normal" },
+    { path: "./fonts/SundaySerifText-Italic-Variable.woff2", weight: "400 600", style: "italic" },
+  ],
+  variable: "--font-sunday-serif",
+  display: "swap",
+  fallback: ["Georgia", "serif"],
+  adjustFontFallback: "Times New Roman",
+});
+
+// Not preloaded: only pages that render text in this family download it.
+export const SundaySerifFX = localFont({
+  src: [
+    { path: "./fonts/SundaySerif-Variable.woff2", weight: "400 600", style: "normal" },
+    { path: "./fonts/SundaySerif-Italic-Variable.woff2", weight: "400 600", style: "italic" },
+  ],
+  variable: "--font-sunday-serif-fx",
+  display: "swap",
+  preload: false,
+  fallback: ["Georgia", "serif"],
+  adjustFontFallback: "Times New Roman",
+});
+
+// Display cut with the Grain Blur axis (GRAN), not preloaded.
+export const SundaySerifGrain = localFont({
+  src: [
+    { path: "./fonts/SundaySerifGrain-Variable.woff2", weight: "400", style: "normal" },
+    { path: "./fonts/SundaySerifGrain-Italic-Variable.woff2", weight: "400", style: "italic" },
+  ],
+  variable: "--font-sunday-serif-grain",
+  display: "swap",
+  preload: false,
+  fallback: ["Georgia", "serif"],
+  adjustFontFallback: "Times New Roman",
+});

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "sunday-serif",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "A soft serif for slow days. Free and open-source, with print effects on variable axes: webfonts, CSS and next/font helpers.",
+  "keywords": [
+    "font",
+    "webfont",
+    "variable-font",
+    "serif",
+    "woff2",
+    "next-font"
+  ],
+  "homepage": "https://sunday-serif.kkratter.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkratterf/sunday-serif.git",
+    "directory": "npm"
+  },
+  "bugs": "https://github.com/kkratterf/sunday-serif/issues",
+  "license": "OFL-1.1",
+  "author": "Federico Kratter Thaler",
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "files": [
+    "fonts",
+    "*.css",
+    "next.js",
+    "next.d.ts",
+    "OFL.txt"
+  ],
+  "exports": {
+    "./text.css": "./text.css",
+    "./fx.css": "./fx.css",
+    "./grain.css": "./grain.css",
+    "./next": {
+      "types": "./next.d.ts",
+      "default": "./next.js"
+    },
+    "./fonts/*": "./fonts/*",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "next": ">=13.2"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  }
+}

package/text.css

@@ -0,0 +1,15 @@
+/* Sunday Serif, text cut: weight 400-600 only, effects at their default (~45 KB per style). */
+@font-face {
+  font-family: "Sunday Serif";
+  src: url("./fonts/SundaySerifText-Variable.woff2") format("woff2");
+  font-weight: 400 600;
+  font-style: normal;
+  font-display: swap;
+}
+@font-face {
+  font-family: "Sunday Serif";
+  src: url("./fonts/SundaySerifText-Italic-Variable.woff2") format("woff2");
+  font-weight: 400 600;
+  font-style: italic;
+  font-display: swap;
+}