@docpod/themes 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Integritis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @docpod/themes
+
+The four preset themes for [docpod](https://github.com/integritis/docpod).
+All share a quiet, WCAG AA-validated light/dark base and differ in their accent
+colors:
+
+| id         | Mood                             |
+| ---------- | -------------------------------- |
+| `slate`    | Achromatic, editorial — default  |
+| `indigo`   | Calm indigo, engineering-leaning |
+| `sapphire` | Cool blue                        |
+| `ember`    | Warm amber                       |
+
+In `docpod.config.ts` you normally just name one (`theme: "indigo"`), or
+extend one with partial overrides:
+
+```ts
+export default {
+  theme: { extends: "slate", colors: { light: { accent: "#7A1F1F" } } },
+};
+```
+
+Programmatic use:
+
+```ts
+import { presets, getPreset } from "@docpod/themes";
+import indigo from "@docpod/themes/indigo";
+```
+
+MIT © docpod

package/dist/base.d.ts

@@ -0,0 +1,28 @@
+import type { ColorTokens, Theme } from "@docpod/theme-schema";
+/**
+ * Shared structural / text / state / code tokens. Presets differ only in their
+ * accent trio (accent, accentHover, accentSoft), focus ring and selection — the
+ * "quiet by default" surface stays identical across the family.
+ */
+export declare const lightBase: Omit<ColorTokens, "accent" | "accentHover" | "accentSoft" | "fgOnAccent" | "focusRing" | "selectionBg">;
+export declare const darkBase: Omit<ColorTokens, "accent" | "accentHover" | "accentSoft" | "fgOnAccent" | "focusRing" | "selectionBg">;
+export type AccentSpec = {
+    accent: string;
+    accentHover: string;
+    accentSoft: string;
+    fgOnAccent: string;
+    selectionBg: string;
+};
+/** Assemble a full preset from the shared bases + per-mode accent specs. */
+export declare function makeTheme(args: {
+    id: string;
+    name: string;
+    description: string;
+    light: AccentSpec;
+    dark: AccentSpec;
+    preview: NonNullable<Theme["preview"]>;
+    code?: {
+        light: string;
+        dark: string;
+    };
+}): Theme;

package/dist/base.js

@@ -0,0 +1,84 @@
+//#region src/base.ts
+/**
+* Shared structural / text / state / code tokens. Presets differ only in their
+* accent trio (accent, accentHover, accentSoft), focus ring and selection — the
+* "quiet by default" surface stays identical across the family.
+*/
+const lightBase = {
+	bg: "#FAFAF7",
+	bgElevated: "#FFFFFF",
+	bgSubtle: "#F1F1EC",
+	border: "#E4E4DE",
+	borderStrong: "#C9C9C1",
+	fg: "#0F0F10",
+	fgMuted: "#55555A",
+	fgSubtle: "#6E6E74",
+	success: "#1F7A46",
+	warning: "#9A5B00",
+	danger: "#B42318",
+	info: "#1E5FB4",
+	codeBg: "#F6F6F1",
+	codeBorder: "#E4E4DE",
+	codeInlineBg: "#EEEEE8",
+	kbdBg: "#FFFFFF",
+	kbdBorder: "#D6D6CE"
+};
+const darkBase = {
+	bg: "#0B0B0D",
+	bgElevated: "#16161A",
+	bgSubtle: "#121216",
+	border: "#26262C",
+	borderStrong: "#3A3A42",
+	fg: "#E8E8EA",
+	fgMuted: "#A0A0A8",
+	fgSubtle: "#87878F",
+	success: "#4ED08A",
+	warning: "#E8B765",
+	danger: "#FF8A7A",
+	info: "#7FB2FF",
+	codeBg: "#121216",
+	codeBorder: "#26262C",
+	codeInlineBg: "#1B1B20",
+	kbdBg: "#1B1B20",
+	kbdBorder: "#3A3A42"
+};
+/** Assemble a full preset from the shared bases + per-mode accent specs. */
+function makeTheme(args) {
+	return {
+		$schema: "https://docpod.dev/schema/theme/v1.json",
+		id: args.id,
+		name: args.name,
+		description: args.description,
+		version: "0.1.0",
+		author: "docpod",
+		license: "MIT",
+		colors: {
+			light: {
+				...lightBase,
+				...args.light,
+				focusRing: args.light.accent
+			},
+			dark: {
+				...darkBase,
+				...args.dark,
+				focusRing: args.dark.accent
+			}
+		},
+		fonts: {
+			sans: "IBM Plex Sans",
+			mono: "IBM Plex Mono",
+			serif: "Source Serif 4"
+		},
+		motion: {
+			enabled: true,
+			intensity: "subtle"
+		},
+		code: {
+			light: args.code?.light ?? "github-light",
+			dark: args.code?.dark ?? "github-dark-dimmed"
+		},
+		preview: args.preview
+	};
+}
+//#endregion
+export { makeTheme as t };

package/dist/ember.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from "@docpod/theme-schema";
+/** Docpod Ember — warm, friendly. For libraries that want some temperature. */
+declare const ember: Theme;
+export default ember;

package/dist/ember.js

@@ -0,0 +1,28 @@
+import { t as makeTheme } from "./base.js";
+//#region src/ember.ts
+/** Docpod Ember — warm, friendly. For libraries that want some temperature. */
+const ember = makeTheme({
+	id: "docpod-ember",
+	name: "Docpod Ember",
+	description: "Warm ember tone for friendly, approachable docs.",
+	light: {
+		accent: "#A8521F",
+		accentHover: "#8A4318",
+		accentSoft: "#F7E9DF",
+		fgOnAccent: "#FFFFFF",
+		selectionBg: "#F3DCC9"
+	},
+	dark: {
+		accent: "#FFB07A",
+		accentHover: "#FFC59A",
+		accentSoft: "#2A1C12",
+		fgOnAccent: "#0B0B0D",
+		selectionBg: "#3A2618"
+	},
+	preview: {
+		accent: "#A8521F",
+		mood: ["warm", "friendly"]
+	}
+});
+//#endregion
+export { ember as default };

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { Theme } from "@docpod/theme-schema";
+import slate from "./slate.js";
+import indigo from "./indigo.js";
+import sapphire from "./sapphire.js";
+import ember from "./ember.js";
+export { slate, indigo, sapphire, ember };
+/** Preset id (the short form accepted in config: `theme: "slate"`). */
+export type PresetId = "slate" | "indigo" | "sapphire" | "ember";
+/** Registry keyed by the short id used in `docpod.config.ts`. */
+export declare const presets: Record<PresetId, Theme>;
+export declare const presetList: Theme[];
+/** Resolve a short id (or the long `docpod-*` id) to a preset, or undefined. */
+export declare function getPreset(id: string): Theme | undefined;

package/dist/index.js

@@ -0,0 +1,25 @@
+import ember from "./ember.js";
+import slate from "./slate.js";
+import indigo from "./indigo.js";
+import sapphire from "./sapphire.js";
+//#region src/index.ts
+/** Registry keyed by the short id used in `docpod.config.ts`. */
+const presets = {
+	slate,
+	indigo,
+	sapphire,
+	ember
+};
+const presetList = [
+	slate,
+	indigo,
+	sapphire,
+	ember
+];
+/** Resolve a short id (or the long `docpod-*` id) to a preset, or undefined. */
+function getPreset(id) {
+	if (id in presets) return presets[id];
+	return presetList.find((t) => t.id === id);
+}
+//#endregion
+export { ember, getPreset, indigo, presetList, presets, sapphire, slate };

package/dist/indigo.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from "@docpod/theme-schema";
+/** Docpod Indigo — calm, engineering-leaning. */
+declare const indigo: Theme;
+export default indigo;

package/dist/indigo.js

@@ -0,0 +1,28 @@
+import { t as makeTheme } from "./base.js";
+//#region src/indigo.ts
+/** Docpod Indigo — calm, engineering-leaning. */
+const indigo = makeTheme({
+	id: "docpod-indigo",
+	name: "Docpod Indigo",
+	description: "Calm indigo with a technical edge.",
+	light: {
+		accent: "#3D3D7A",
+		accentHover: "#2E2E60",
+		accentSoft: "#E9E9F4",
+		fgOnAccent: "#FFFFFF",
+		selectionBg: "#DEDEF2"
+	},
+	dark: {
+		accent: "#9B9BFF",
+		accentHover: "#B4B4FF",
+		accentSoft: "#1E1E2C",
+		fgOnAccent: "#0B0B0D",
+		selectionBg: "#262640"
+	},
+	preview: {
+		accent: "#3D3D7A",
+		mood: ["tech", "calm"]
+	}
+});
+//#endregion
+export { indigo as default };

package/dist/sapphire.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from "@docpod/theme-schema";
+/** Docpod Sapphire — clear, general-purpose blue. Good for API/SDK docs. */
+declare const sapphire: Theme;
+export default sapphire;

package/dist/sapphire.js

@@ -0,0 +1,32 @@
+import { t as makeTheme } from "./base.js";
+//#region src/sapphire.ts
+/** Docpod Sapphire — clear, general-purpose blue. Good for API/SDK docs. */
+const sapphire = makeTheme({
+	id: "docpod-sapphire",
+	name: "Docpod Sapphire",
+	description: "Clear, general-purpose sapphire blue.",
+	light: {
+		accent: "#1E4F8F",
+		accentHover: "#173E72",
+		accentSoft: "#E3ECF7",
+		fgOnAccent: "#FFFFFF",
+		selectionBg: "#D5E4F5"
+	},
+	dark: {
+		accent: "#6FA6FF",
+		accentHover: "#92BCFF",
+		accentSoft: "#142235",
+		fgOnAccent: "#0B0B0D",
+		selectionBg: "#1C3147"
+	},
+	preview: {
+		accent: "#1E4F8F",
+		mood: [
+			"clear",
+			"neutral",
+			"tech"
+		]
+	}
+});
+//#endregion
+export { sapphire as default };

package/dist/slate.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from "@docpod/theme-schema";
+/** Docpod Slate — achromatic, the quietest preset. The default. */
+declare const slate: Theme;
+export default slate;

package/dist/slate.js

@@ -0,0 +1,32 @@
+import { t as makeTheme } from "./base.js";
+//#region src/slate.ts
+/** Docpod Slate — achromatic, the quietest preset. The default. */
+const slate = makeTheme({
+	id: "docpod-slate",
+	name: "Docpod Slate",
+	description: "Achromatic and quiet. The default — quiet by default, made literal.",
+	light: {
+		accent: "#1F1F22",
+		accentHover: "#38383C",
+		accentSoft: "#ECECE6",
+		fgOnAccent: "#FAFAF7",
+		selectionBg: "#E2E2DA"
+	},
+	dark: {
+		accent: "#E8E8EA",
+		accentHover: "#FFFFFF",
+		accentSoft: "#222228",
+		fgOnAccent: "#0B0B0D",
+		selectionBg: "#2A2A30"
+	},
+	preview: {
+		accent: "#1F1F22",
+		mood: [
+			"neutral",
+			"quiet",
+			"editorial"
+		]
+	}
+});
+//#endregion
+export { slate as default };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@docpod/themes",
+  "version": "0.1.0",
+  "description": "docpod preset themes: slate, indigo, sapphire, ember.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/integritis/docpod.git",
+    "directory": "packages/themes"
+  },
+  "homepage": "https://github.com/integritis/docpod#readme",
+  "bugs": "https://github.com/integritis/docpod/issues",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./slate": {
+      "types": "./dist/slate.d.ts",
+      "import": "./dist/slate.js"
+    },
+    "./indigo": {
+      "types": "./dist/indigo.d.ts",
+      "import": "./dist/indigo.js"
+    },
+    "./sapphire": {
+      "types": "./dist/sapphire.d.ts",
+      "import": "./dist/sapphire.js"
+    },
+    "./ember": {
+      "types": "./dist/ember.d.ts",
+      "import": "./dist/ember.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@docpod/theme-schema": "^0.1.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.12.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  }
+}