headreel 1.4.0 → 1.6.0

package/README.md

@@ -5,7 +5,7 @@
 [![CI](https://github.com/arifszn/headreel/actions/workflows/ci.yml/badge.svg)](https://github.com/arifszn/headreel/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
-An animated banner for your GitHub profile, made from your GitHub activity.
+Animated banners for your GitHub profile, made from your GitHub activity.
 
 ![Contribution City banner](https://raw.githubusercontent.com/arifszn/headreel/main/docs/samples/contribution-city.gif)
 
@@ -18,8 +18,7 @@ Pick one way to make your banner:
 
 The Action is on the [GitHub Marketplace](https://github.com/marketplace/actions/headreel).
 
-1. Open your profile repository. This is the public repository with the same name as your username, for example `octocat/octocat`.
-2. Add `.github/workflows/headreel.yml`:
+1. Add `.github/workflows/headreel.yml` to your repository:
 
    ```yaml
    name: headreel
@@ -45,8 +44,8 @@ The Action is on the [GitHub Marketplace](https://github.com/marketplace/actions
              website: https://example.com
    ```
 
-3. Run the workflow once from the **Actions** tab. It adds `headreel.gif` to the `headreel` branch.
-4. Add the image line to your `README.md`. The workflow run page shows it, ready to copy. It looks like this:
+2. Run the workflow once from the **Actions** tab. It adds `headreel.gif` to the `headreel` branch.
+3. Add the image line to your `README.md`. The workflow run page shows it, ready to copy. It looks like this:
 
    ```markdown
    ![My GitHub activity](https://raw.githubusercontent.com/octocat/octocat/headreel/headreel.gif)
@@ -68,7 +67,7 @@ Run this command. Replace `octocat` with your GitHub username.
 npx headreel --style contribution-city --user octocat --tagline "Open source maintainer" --website https://example.com
 ```
 
-The command saves `headreel.gif` in the current folder. Add the file to your profile repository, and add `![My GitHub activity](headreel.gif)` to its `README.md`.
+The command saves `headreel.gif` in the current folder. Add the file to your repository, and add `![My GitHub activity](headreel.gif)` to its `README.md`.
 
 You need:
 
@@ -99,6 +98,10 @@ Empty settings do not show on the banner. Your name comes from your GitHub profi
 
 Set the style with `style: <name>` in the Action, or `--style <name>` in the command. Set an option with `options: 'accent: green'` in the Action, or `--option accent=green` in the command. For more than one option in the Action, put each on its own line.
 
+<table>
+<tr>
+<td>
+
 ### Contribution City
 
 `contribution-city`: each day of the last 12 months is one building. A taller building means more contributions. Beacons glow on your busiest days.
@@ -109,6 +112,14 @@ Set the style with `style: <name>` in the Action, or `--style <name>` in the com
 | -------- | ------- | --------------------------------------------------------------------------------------------- |
 | `accent` | `cyan`  | Color of the roofs, windows, lights and links: `cyan`, `cobalt`, `green`, `violet` or `pink`. |
 
+</td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td>
+
 ### Highlights Reel
 
 `highlights-reel`: a few profile facts, each on its own card, filmed by one camera. The camera travels between the cards, pushes into your busiest week, and ends on a wide shot of the whole reel.
@@ -120,6 +131,14 @@ Set the style with `style: <name>` in the Action, or `--style <name>` in the com
 | `theme`  | `light`  | `light` or `dark`. Use `dark` if your profile is mostly viewed in GitHub dark mode.    |
 | `accent` | `cobalt` | Color of the bars, numbers and links: `cobalt`, `green`, `violet`, `orange` or `pink`. |
 
+</td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td>
+
 ### Now Playing
 
 `now-playing`: a cassette deck playing the repository you committed to most in the last 30 days. The label names its language, your commit messages on it scroll across the deck's display as lyrics, and the level meter shows the month day by day. When nothing was committed in the last 30 days, the deck shows the repository you pushed to last as `LAST PLAYED`.
@@ -132,6 +151,52 @@ Set the style with `style: <name>` in the Action, or `--style <name>` in the com
 | `accent`  | `cyan`  | Display color, meter and links: `cyan`, `green` or `orange`.                                        |
 | `exclude` | empty   | Comma-separated repositories never picked, for example your profile repository: `exclude: octocat`. |
 
+</td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td>
+
+### Receipt
+
+`receipt`: a thermal printer feeds out your last 12 months as a till receipt: repositories as items, contribution counts as the totals, streaks and your best day printed below, and a barcode encoding your activity week by week. The paper prints line by line, tears off, and the next receipt starts.
+
+![Receipt banner](https://raw.githubusercontent.com/arifszn/headreel/main/docs/samples/receipt.gif)
+
+| Option   | Default  | Description                                                                     |
+| -------- | -------- | ------------------------------------------------------------------------------- |
+| `theme`  | `dark`   | `dark` or `light`. Use `light` if your profile is mostly viewed in light mode.  |
+| `accent` | `cobalt` | Prompt, cursor, tagline and LED: `cobalt`, `green`, `violet`, `orange`, `pink`. |
+| `items`  | `5`      | Repositories printed as line items, `0` to `5`.                                 |
+
+</td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td>
+
+### Trail Profile
+
+`trail-profile`: your last 12 months as a hiking trail's elevation profile on printed survey paper. Each week's contributions are the trail's elevation, drawn as a profile line with contour strata and engraved relief below it. A hiker marker walks the trail to your busiest week, the summit, and holds on its flag.
+
+![Trail Profile banner](https://raw.githubusercontent.com/arifszn/headreel/main/docs/samples/trail-profile.gif)
+
+| Option   | Default  | Description                                                                                    |
+| -------- | -------- | ---------------------------------------------------------------------------------------------- |
+| `accent` | `sienna` | Profile line, strata and links: `sienna`, `cobalt`, `green` or `violet`. The paper stays buff. |
+
+</td>
+</tr>
+</table>
+
+<table>
+<tr>
+<td>
+
 ### Repo Galaxy
 
 `repo-galaxy`: your most starred repositories orbit a sun. A bigger planet has more stars, and its color is the repository's main language. Repositories you pushed to recently orbit closer to the sun.
@@ -144,6 +209,10 @@ Set the style with `style: <name>` in the Action, or `--style <name>` in the com
 | `include_forks` | `false` | Show forked repositories too.                                         |
 | `labels`        | `top3`  | `top3` names the three most starred repositories. `none` hides names. |
 
+</td>
+</tr>
+</table>
+
 ## Troubleshooting
 
 | Problem                          | Fix                                                      |

package/dist/core/camera.js

@@ -0,0 +1,68 @@
+/**
+ * One camera over one world: a key list `{ frame, x, y, z }` interpolated with
+ * a single travel curve, so almost all motion happens in the middle third of a
+ * move (Highlights Reel's camera, shared with Trail Profile).
+ *
+ * Zoom travels in log space, so leaving a deep push-in pulls back as fast as it
+ * pans. A long move dips its zoom at the midpoint and pushes in to land; short
+ * hops stay flat. Held shots are still, and `frameFloat` wraps so `t = 1` snaps
+ * bitwise to `t = 0`, closing the loop to the pixel.
+ */
+/** The default travel curve: almost all motion happens in the middle third. */
+export const easeQuartic = (t) => t < 0.5 ? 8 * t ** 4 : 1 - (-2 * t + 2) ** 4 / 2;
+/** A gentler cruise, used for long flights: cubic in-out. */
+export const easeCubic = (t) => (t < 0.5 ? 4 * t ** 3 : 1 - (-2 * t + 2) ** 3 / 2);
+const clamp01 = (v) => Math.min(1, Math.max(0, v));
+/** The camera between keys: one curve, with a zoom dip on long moves. */
+export function shotAt(keys, frame, opts) {
+    const ease = opts.ease ?? easeQuartic;
+    if (frame <= keys[0].frame) {
+        return { x: keys[0].x, y: keys[0].y, z: keys[0].z };
+    }
+    const last = keys[keys.length - 1];
+    if (frame >= last.frame) {
+        return { x: last.x, y: last.y, z: last.z };
+    }
+    let index = 0;
+    while (index < keys.length - 2 && keys[index + 1].frame <= frame) {
+        index++;
+    }
+    const from = keys[index];
+    const to = keys[index + 1];
+    const t = clamp01((frame - from.frame) / (to.frame - from.frame));
+    const travelled = ease(t);
+    const distance = Math.hypot(to.x - from.x, to.y - from.y);
+    const dip = distance > opts.travel
+        ? 1 - 0.22 * Math.sin(Math.PI * t) * Math.min(1, distance / opts.span)
+        : 1;
+    return {
+        x: from.x + (to.x - from.x) * travelled,
+        y: from.y + (to.y - from.y) * travelled,
+        z: from.z * (to.z / from.z) ** travelled * dip,
+    };
+}
+/**
+ * The camera at a moment of the loop. Held shots are still: any drift, even in
+ * whole-pixel steps, reads as the scene stepping or the type vibrating.
+ */
+export function cameraAt(keys, frameFloat, frames, opts) {
+    // t = 1 snaps to 0, so the last frame is bit-identical to the first.
+    const t = frameFloat >= frames ? 0 : (((frameFloat / frames) % 1) + 1) % 1;
+    return shotAt(keys, t * frames, opts);
+}
+/** How fast the frame is moving, in screen pixels, zoom included. */
+export function speedAt(keys, frameFloat, frames, opts) {
+    const now = cameraAt(keys, frameFloat, frames, opts);
+    const before = cameraAt(keys, frameFloat - 1, frames, opts);
+    return ((Math.hypot(now.x - before.x, now.y - before.y) + Math.abs(now.z - before.z) * 700) * now.z);
+}
+/**
+ * Applies the world transform, snapped to whole screen pixels. At a fixed zoom
+ * the drift then moves the scene in 1 px steps instead of resampling every
+ * glyph each frame at a new sub-pixel offset, which reads as vibrating type.
+ * `(cx, cy)` is the viewport's centre in screen space.
+ */
+export function applyCamera(ctx, cam, cx, cy) {
+    ctx.translate(Math.round(cx - cam.x * cam.z), Math.round(cy - cam.y * cam.z));
+    ctx.scale(cam.z, cam.z);
+}

package/dist/core/data/receipt.js

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+import { contributionWindow } from './contributions.js';
+// One query for the whole receipt: the 365-day calendar (TOTAL, the streaks,
+// the best day and the barcode), the per-type contribution counts, and the
+// repositories the user committed to (the line items). Field names checked
+// against the live GraphQL schema (2026-09-19).
+const QUERY = /* GraphQL */ `
+  query Receipt($login: String!, $from: DateTime!, $to: DateTime!) {
+    user(login: $login) {
+      contributionsCollection(from: $from, to: $to) {
+        contributionCalendar {
+          totalContributions
+          weeks {
+            contributionDays {
+              date
+              contributionCount
+            }
+          }
+        }
+        totalCommitContributions
+        totalPullRequestContributions
+        totalPullRequestReviewContributions
+        totalIssueContributions
+        totalRepositoryContributions
+        restrictedContributionsCount
+        commitContributionsByRepository(maxRepositories: 25) {
+          repository {
+            name
+            owner {
+              login
+            }
+            isPrivate
+            primaryLanguage {
+              name
+              color
+            }
+          }
+          contributions {
+            totalCount
+          }
+        }
+      }
+    }
+  }
+`;
+/** Line items printed, at most. */
+export const MAX_ITEMS = 5;
+/** Days in the contribution window: 364 back plus the run date. */
+export const WINDOW_DAYS = 365;
+const languageSchema = z
+    .object({
+    name: z.string().min(1),
+    /** Linguist color; null when the repo has no language or color. */
+    color: z
+        .string()
+        .regex(/^#[0-9a-fA-F]{6}$/)
+        .nullable(),
+})
+    .nullable();
+export const receiptSchema = z.object({
+    /** Fetch date (= window end), YYYY-MM-DD (UTC). */
+    asOf: z.iso.date(),
+    from: z.iso.date(),
+    to: z.iso.date(),
+    /** The calendar's total, the number the profile shows. */
+    total: z.number().int().min(0),
+    commits: z.number().int().min(0),
+    pullRequests: z.number().int().min(0),
+    reviews: z.number().int().min(0),
+    issues: z.number().int().min(0),
+    newRepos: z.number().int().min(0),
+    /** Private contributions the token could see, without any repository named. */
+    restricted: z.number().int().min(0),
+    /** Public repositories committed to, most commits first. */
+    items: z
+        .array(z.object({
+        /** A repository the user does not own prints as `owner/name`. */
+        name: z.string().min(1),
+        language: languageSchema,
+        commits: z.number().int().min(1),
+    }))
+        .max(MAX_ITEMS),
+    /** Commits summed over the private repositories, never named. */
+    privateCommits: z.number().int().min(0),
+    /** Daily counts over the window, oldest first. */
+    days: z.array(z.number().int().min(0)).length(WINDOW_DAYS),
+});
+/**
+ * The line items: public repositories by commits in the window, ties by name.
+ * Private repositories are dropped here, before ranking; their commits are
+ * summed into `privateCommits` and never named.
+ */
+export function selectItems(entries, login, cap = MAX_ITEMS) {
+    const items = [];
+    let privateCommits = 0;
+    for (const entry of entries) {
+        const { repository } = entry;
+        if (repository.isPrivate) {
+            privateCommits += entry.contributions.totalCount;
+            continue;
+        }
+        items.push({
+            name: repository.owner.login === login
+                ? repository.name
+                : `${repository.owner.login}/${repository.name}`,
+            language: repository.primaryLanguage
+                ? { name: repository.primaryLanguage.name, color: repository.primaryLanguage.color }
+                : null,
+            commits: entry.contributions.totalCount,
+        });
+    }
+    items.sort((a, b) => b.commits - a.commits || a.name.localeCompare(b.name));
+    return { items: items.slice(0, cap), privateCommits };
+}
+export async function fetchReceipt(client, login, now) {
+    const { from, to } = contributionWindow(now);
+    const { user } = await client(QUERY, {
+        login,
+        from: `${from}T00:00:00Z`,
+        to: `${to}T23:59:59Z`,
+    });
+    const cc = user.contributionsCollection;
+    // Calendar weeks are padded to full weeks; keep only the window's days.
+    const days = cc.contributionCalendar.weeks
+        .flatMap((week) => week.contributionDays)
+        .filter((day) => day.date >= from && day.date <= to)
+        .map((day) => day.contributionCount);
+    const { items, privateCommits } = selectItems(cc.commitContributionsByRepository, login);
+    return {
+        asOf: to,
+        from,
+        to,
+        total: cc.contributionCalendar.totalContributions,
+        commits: cc.totalCommitContributions,
+        pullRequests: cc.totalPullRequestContributions,
+        reviews: cc.totalPullRequestReviewContributions,
+        issues: cc.totalIssueContributions,
+        newRepos: cc.totalRepositoryContributions,
+        restricted: cc.restrictedContributionsCount,
+        items,
+        privateCommits,
+        days,
+    };
+}

package/dist/core/streaks.js

@@ -0,0 +1,38 @@
+/**
+ * Streaks and peaks over a flat array of daily contribution counts, oldest
+ * first. Shared by Highlights Reel and Receipt.
+ */
+/** Longest run of consecutive days with at least one contribution. */
+export function longestStreak(days) {
+    let best = 0;
+    let run = 0;
+    for (const count of days) {
+        run = count > 0 ? run + 1 : 0;
+        if (run > best)
+            best = run;
+    }
+    return best;
+}
+/**
+ * Consecutive active days ending on the last day, or on the day before it
+ * when the last day is still empty: a scheduled run often happens before the
+ * day's work.
+ */
+export function currentStreak(days) {
+    let end = days.length - 1;
+    if (days[end] <= 0)
+        end--;
+    let run = 0;
+    for (let i = end; i >= 0 && days[i] > 0; i--)
+        run++;
+    return run;
+}
+/** The day with the highest count, or null when every day is empty. */
+export function bestDay(days) {
+    let best = null;
+    days.forEach((count, index) => {
+        if (count > 0 && (best === null || count >= best.count))
+            best = { index, count };
+    });
+    return best;
+}

package/dist/styles/highlights-reel/palette.js

@@ -2,8 +2,9 @@ const AMBER = [232, 163, 61];
 /**
  * Accent presets, [light, dark]. Each passes 4.5:1 against its theme's desk,
  * the lowest background its small type sits on (see SPEC, Highlights Reel).
+ * Receipt shares them: its counter is this desk.
  */
-const ACCENT_VALUES = {
+export const ACCENT_VALUES = {
     cobalt: [
         [53, 88, 232],
         [123, 147, 255],

package/dist/styles/highlights-reel/reel.js

@@ -1,3 +1,4 @@
+import { longestStreak as coreLongestStreak } from '../../core/streaks.js';
 import { paletteOf } from './palette.js';
 /**
  * Where the reel lives: four cards on one desk, filmed by one camera.
@@ -54,16 +55,7 @@ const NEUTRAL = { light: [102, 106, 124], dark: [140, 146, 168] };
 const CARD_ORDER = ['contributions', 'top_repo', 'pull_requests', 'languages'];
 /** Longest run of consecutive days with at least one contribution. */
 export function longestStreak(contributions) {
-    let best = 0;
-    let run = 0;
-    for (const week of contributions.weeks) {
-        for (const day of week) {
-            run = day.count > 0 ? run + 1 : 0;
-            if (run > best)
-                best = run;
-        }
-    }
-    return best;
+    return coreLongestStreak(contributions.weeks.flat().map((day) => day.count));
 }
 /** "2026-03-28" .. "2026-04-03" -> "Mar 28 to Apr 3". */
 function dateRange(from, to) {

package/dist/styles/highlights-reel/sketch.js

@@ -1,3 +1,4 @@
+import { applyCamera, cameraAt, speedAt } from '../../core/camera.js';
 import { fitIdentity } from '../../core/text.js';
 import { FRAMES, LAYOUT, plateAt, stationOf, } from './reel.js';
 /**
@@ -26,8 +27,8 @@ const TAU = Math.PI * 2;
 export const IDENTITY_COLUMN = 440 - 48;
 const clamp01 = (v) => Math.min(1, Math.max(0, v));
 const easeOutCubic = (t) => 1 - (1 - t) ** 3;
-/** The one travel curve: almost all motion happens in the middle third. */
-const travelEase = (t) => (t < 0.5 ? 8 * t ** 4 : 1 - (-2 * t + 2) ** 4 / 2);
+/** Camera tuning: moves longer than `travel` dip their zoom, scaled to `span`. */
+const CAMERA = { travel: LAYOUT.travel, span: 2400 };
 function smoothstep(e0, e1, x) {
     const t = clamp01((x - e0) / (e1 - e0));
     return t * t * (3 - 2 * t);
@@ -88,51 +89,10 @@ export function createReelSketch(reel, identity) {
         website: identity.website && `↗ ${displayUrl(identity.website)}`,
     }, IDENTITY_COLUMN);
     // --- camera ---------------------------------------------------------------
-    /** The camera between keys: one curve, with a zoom dip on long moves. */
-    function rawShot(frame) {
-        const keys = reel.plan.keys;
-        if (frame <= keys[0].frame) {
-            return { x: keys[0].x, y: keys[0].y, z: keys[0].z };
-        }
-        const last = keys[keys.length - 1];
-        if (frame >= last.frame) {
-            return { x: last.x, y: last.y, z: last.z };
-        }
-        let index = 0;
-        while (index < keys.length - 2 && keys[index + 1].frame <= frame) {
-            index++;
-        }
-        const from = keys[index];
-        const to = keys[index + 1];
-        const t = clamp01((frame - from.frame) / (to.frame - from.frame));
-        const travelled = travelEase(t);
-        const distance = Math.hypot(to.x - from.x, to.y - from.y);
-        // Zoom travels in log space, so leaving a deep push-in pulls back as fast
-        // as it pans. A long move also dips at its midpoint and pushes in to land.
-        const dip = distance > LAYOUT.travel
-            ? 1 - 0.22 * Math.sin(Math.PI * t) * Math.min(1, distance / 2400)
-            : 1;
-        return {
-            x: from.x + (to.x - from.x) * travelled,
-            y: from.y + (to.y - from.y) * travelled,
-            z: from.z * (to.z / from.z) ** travelled * dip,
-        };
-    }
-    /**
-     * The camera at a moment of the loop. Held shots are still: any drift, even
-     * in whole-pixel steps, reads as the cards stepping or the type vibrating.
-     */
-    function camera(frameFloat) {
-        // t = 1 snaps to 0, so the last frame is bit-identical to the first.
-        const t = frameFloat >= FRAMES ? 0 : (((frameFloat / FRAMES) % 1) + 1) % 1;
-        return rawShot(t * FRAMES);
-    }
+    /** The camera at a moment of the loop (see `core/camera.ts`). */
+    const camera = (frameFloat) => cameraAt(reel.plan.keys, frameFloat, FRAMES, CAMERA);
     /** How fast the frame is moving, in screen pixels, zoom included. */
-    function speedOf(frameFloat) {
-        const now = camera(frameFloat);
-        const before = camera(frameFloat - 1);
-        return ((Math.hypot(now.x - before.x, now.y - before.y) + Math.abs(now.z - before.z) * 700) * now.z);
-    }
+    const speedOf = (frameFloat) => speedAt(reel.plan.keys, frameFloat, FRAMES, CAMERA);
     /** A card builds while the camera arrives; an empty window means already finished. */
     function buildAt(window, frameFloat) {
         if (window.end <= window.start)
@@ -535,11 +495,10 @@ export function createReelSketch(reel, identity) {
         setFill(ctx, PALETTE.desk);
         ctx.fillRect(0, 0, W, H);
         ctx.save();
-        // Snap the world to whole screen pixels. At a fixed zoom the drift then
-        // moves the cards in 1 px steps instead of resampling every glyph each
-        // frame at a new sub-pixel offset, which reads as vibrating type.
-        ctx.translate(Math.round(W / 2 - cam.x * cam.z), Math.round(H / 2 - cam.y * cam.z));
-        ctx.scale(cam.z, cam.z);
+        // Snap the world to whole screen pixels (see `applyCamera`): at a fixed
+        // zoom the drift then moves the cards in 1 px steps instead of resampling
+        // every glyph each frame at a new sub-pixel offset.
+        applyCamera(ctx, cam, W / 2, H / 2);
         drawDots(ctx, cam, speed);
         for (let i = 0; i < reel.cards.length; i++)
             drawMarks(ctx, i);

package/dist/styles/index.js

@@ -1,11 +1,15 @@
 import { contributionCity } from './contribution-city/index.js';
 import { highlightsReel } from './highlights-reel/index.js';
 import { nowPlaying } from './now-playing/index.js';
+import { receipt } from './receipt/index.js';
 import { repoGalaxy } from './repo-galaxy/index.js';
+import { trailProfile } from './trail-profile/index.js';
 /** Built-in styles, keyed by id. */
 export const styles = {
     [contributionCity.id]: contributionCity,
     [highlightsReel.id]: highlightsReel,
     [nowPlaying.id]: nowPlaying,
+    [receipt.id]: receipt,
     [repoGalaxy.id]: repoGalaxy,
+    [trailProfile.id]: trailProfile,
 };

package/dist/styles/receipt/index.js

@@ -0,0 +1,16 @@
+import { fetchReceipt, receiptSchema } from '../../core/data/receipt.js';
+import { buildReceipt, FRAMES } from './receipt.js';
+import { options } from './options.js';
+import { paletteOf, pinnedOf } from './palette.js';
+import { createReceiptSketch } from './sketch.js';
+export const receipt = {
+    id: 'receipt',
+    fps: 25,
+    frames: FRAMES,
+    pinned: (options) => pinnedOf(paletteOf(options)),
+    data: { name: 'receipt', schema: receiptSchema, fetch: fetchReceipt },
+    options,
+    createSketch({ data, login, options, identity, rng }) {
+        return createReceiptSketch(buildReceipt(data, login, identity, options, paletteOf(options), rng), identity);
+    },
+};

package/dist/styles/receipt/options.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { MAX_ITEMS } from '../../core/data/receipt.js';
+export const THEMES = ['dark', 'light'];
+export const ACCENTS = ['cobalt', 'green', 'violet', 'orange', 'pink'];
+export const options = z
+    .object({
+    /** The counter and the printer: dark slate, or the light desk. */
+    theme: z.enum(THEMES).default('dark'),
+    /** Prompt, cursor, tagline, website and the printer LED, as Highlights Reel. */
+    accent: z.enum(ACCENTS).default('cobalt'),
+    /** Line items printed, most commits first. 0 prints the totals only. */
+    items: z.coerce.number().int().min(0).max(MAX_ITEMS).default(MAX_ITEMS),
+})
+    .strict();

package/dist/styles/receipt/palette.js

@@ -0,0 +1,48 @@
+import { ACCENT_VALUES } from '../highlights-reel/palette.js';
+const PAPER = {
+    paper: [250, 249, 245],
+    ink: [30, 30, 34],
+    fadedInk: [106, 106, 112],
+};
+const BASE = {
+    dark: {
+        ...PAPER,
+        counter: [13, 15, 23],
+        body: [28, 31, 41],
+        slot: [5, 6, 10],
+        bevel: [58, 61, 74],
+        identityInk: [238, 240, 246],
+        identityMuted: [140, 146, 168],
+        paperBorder: null,
+        shadow: 0,
+    },
+    light: {
+        ...PAPER,
+        counter: [236, 237, 241],
+        body: [201, 204, 211],
+        slot: [42, 45, 53],
+        bevel: [246, 247, 249],
+        identityInk: [11, 12, 20],
+        identityMuted: [102, 106, 124],
+        paperBorder: [11, 12, 20],
+        shadow: 0.09,
+    },
+};
+export function paletteOf(options) {
+    const [light, dark] = ACCENT_VALUES[options.accent];
+    return {
+        ...BASE[options.theme],
+        accent: options.theme === 'light' ? light : dark,
+    };
+}
+/** Flat colors the encoder keeps exact and undithered. */
+export function pinnedOf(palette) {
+    return [
+        palette.counter,
+        palette.paper,
+        palette.ink,
+        palette.fadedInk,
+        palette.body,
+        palette.accent,
+    ];
+}