@arcforge/theme 2.0.166

package/README.md

@@ -0,0 +1,29 @@
+# @arcforge/theme
+
+The shared palette and syntax theme for the [Axon](https://axon.arclabs.it) agent runtime.
+
+One source of truth for Arcnight — the Shiki-compatible TextMate theme — and the Axon UI
+colour palette. Consumed by the terminal's highlighter, the Fleet extension's webviews,
+and every other surface that has to look like Axon.
+
+A theme is data, not a stylesheet: it ships as plain objects, so a consumer can hand it
+to Shiki, read individual tokens for its own chrome, or render the same colours in a
+terminal that has never heard of CSS.
+
+```bash
+npm install @arcforge/theme
+```
+
+Most people never install this directly. It arrives as a dependency of the Axon
+framework when you scaffold an agent with `axon init`.
+
+## Documentation
+
+Full documentation is at **[axon.arclabs.it/docs/v2](https://axon.arclabs.it/docs/v2)**.
+
+- [What is Axon?](https://axon.arclabs.it/docs/v2)
+- [The TUI](https://axon.arclabs.it/docs/v2/tui)
+
+## License
+
+Proprietary. © ArcLabs

package/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "@arcforge/theme",
+    "version": "2.0.166",
+    "type": "module",
+    "main": "./src/index.ts",
+    "exports": {
+        ".": "./src/index.ts"
+    },
+    "files": [
+        "src"
+    ],
+    "devDependencies": {
+        "@types/bun": "latest",
+        "typescript": "^5"
+    },
+    "dependencies": {
+        "@arcforge/types": "2.0.166"
+    }
+}

package/src/index.ts

@@ -0,0 +1,113 @@
+/**
+ * @arcforge/theme — shared syntax highlighting theme and UI palette.
+ *
+ * Source of truth for the Arcnight Shiki theme and the Axon UI color palette.
+ * Consumed by VTerm's highlighter, the debugger webview, and any future
+ * surface that needs consistent Axon styling.
+ */
+
+// ── Arcnight — Shiki-compatible TextMate theme ──────────────────────────────
+
+export const arcnight = {
+    name: "arcnight",
+    type: "dark" as const,
+    colors: {
+        "editor.background": "#070b10",
+        "editor.foreground": "#c7eaff",
+    },
+    tokenColors: [
+        {
+            scope: [
+                "variable",
+                "variable.other",
+                "variable.other.property",
+                "variable.other.object.property",
+                "variable.other.readwrite",
+                "meta.object-literal.key",
+                "support.variable.property",
+            ],
+            settings: { foreground: "#7cceff" },
+        },
+        {
+            scope: [
+                "keyword",
+                "keyword.control",
+                "keyword.other",
+                "storage",
+                "storage.type",
+                "storage.modifier",
+            ],
+            settings: { foreground: "#345a94" },
+        },
+        {
+            scope: ["constant.numeric", "number"],
+            settings: { foreground: "#326396" },
+        },
+        {
+            scope: ["entity.name.type", "entity.name.class", "constant", "support.type"],
+            settings: { foreground: "#3caed5" },
+        },
+        {
+            scope: ["entity.name.function", "support.function", "meta.function-call"],
+            settings: { foreground: "#3caed5" },
+        },
+        {
+            scope: ["string", "string.quoted", "string.template"],
+            settings: { foreground: "#4c6696" },
+        },
+        {
+            scope: ["keyword.operator", "punctuation.accessor"],
+            settings: { foreground: "#7cceff" },
+        },
+        {
+            scope: ["comment", "comment.line", "comment.block"],
+            settings: { foreground: "#585858", fontStyle: "italic" },
+        },
+        // ── AIR format scopes ────────────────────────────────────────────────
+        { scope: ["punctuation.definition.tag.air"],  settings: { foreground: "#2a4a6a" } },
+        { scope: ["entity.name.tag.section.air"],     settings: { foreground: "#345a94" } }, // meta, env, timeline
+        { scope: ["entity.name.tag.turn.air"],        settings: { foreground: "#3caed5" } }, // agent, user
+        { scope: ["entity.name.tag.execute.air"],     settings: { foreground: "#00B4D8" } }, // typescript, shell
+        { scope: ["entity.name.tag.stdout.air"],      settings: { foreground: "#4c6696" } }, // stdout
+        { scope: ["entity.name.tag.prose.air"],       settings: { foreground: "#7cceff" } }, // text, thinking
+        { scope: ["entity.name.tag.signal.air"],      settings: { foreground: "#3caed5" } }, // done
+        { scope: ["entity.name.tag.env.air"],         settings: { foreground: "#345a94" } }, // process, subagent
+        { scope: ["entity.name.tag.system.air"],      settings: { foreground: "#b43c3c" } }, // error, note
+        { scope: ["entity.name.tag.state.air"],       settings: { foreground: "#585858" } }, // unknown tags
+        { scope: ["entity.other.attribute-name.air"], settings: { foreground: "#4c6696" } }, // attr names
+        { scope: ["string.quoted.double.air"],        settings: { foreground: "#326396" } }, // attr values
+        { scope: ["constant.character.entity.air"],   settings: { foreground: "#4c6696" } }, // < etc
+    ],
+}
+
+// ── UI Palette — non-syntax colors used across Axon surfaces ────────────────
+
+export const palette = {
+    primary:       "#00B4D8",
+    userText:      "#c8c8c8",
+    agentText:     "#d2d2d2",
+    thinkingText:  "#646464",
+    thinkingGlyph: "#3c3c3c",
+    toolLabel:     "#828282",
+    output:        "#505050",
+    railDim:       "#3c3c3c",
+    railBright:    "#505050",
+    omitted:       "#3c3c3c",
+    error:         "#b43c3c",
+    errorBright:   "#f14c4c",
+    waiting:       "#a07828",
+    denied:        "#a03c3c",
+    codeLine:      "#3c3c3c",
+} as const
+
+// ── Themes — the seven tokens every Axon surface draws from ─────────────────
+export {
+    arcnightTheme,
+    BUILTIN_THEMES,
+    themeVariables,
+    type Theme,
+    type ThemeTokens,
+    type ThemeColor,
+    type ColorName,
+    type BundledSyntax,
+} from "./themes"

package/src/themes.ts

@@ -0,0 +1,90 @@
+/**
+ * Themes — the seven tokens every Axon surface draws from.
+ *
+ * ── Why seven, and why closed ───────────────────────────────────────────────
+ *
+ * The TUI reached ~30 distinct hard-coded colours: four greys that nobody chose
+ * deliberately, five reds, two blues. Most of that variety is accidental rather
+ * than meaningful, and a theme API with a field per call site would preserve
+ * the accident forever — a "theme" would then mean thirty decisions, and no two
+ * themes would agree on what any of them were for.
+ *
+ * So the set is closed. A theme picks seven colours; every surface derives from
+ * them. That is what makes a theme portable: whatever an author writes, it
+ * lands on the same things in the same way.
+ */
+
+/**
+ * Re-exported, not redefined.
+ *
+ * These types are the EXTENSION CONTRACT — a user's `theme.create()` is typed
+ * against the copy in `@arcforge/types/tui.ts`, which `axon prepare` writes
+ * into their frame. A second definition here would be the same shape twice,
+ * and the day they disagreed a theme would typecheck in a user's editor and be
+ * rejected by the terminal that loaded it.
+ *
+ * `BundledSyntax` in particular is generated from Shiki's own bundle, so
+ * duplicating it would mean duplicating the generator too.
+ */
+export type { ThemeColor, ColorName, ThemeTokens, Theme, BundledSyntax } from "@arcforge/types"
+
+import type { Theme, ThemeTokens } from "@arcforge/types"
+
+/**
+ * Arcnight — the default, and the palette every Axon surface was built against.
+ *
+ * `primary` is the cyan the input rule, palette selection and header already
+ * use; `dim` is the grey that most secondary text collapsed to; `error` is the
+ * red the timeline's error rows use. Those three were already consistent —
+ * the rest of the variety is what this set replaces.
+ */
+export const arcnightTheme: Theme = {
+    name: "arcnight",
+    primary: "#00B4D8",
+    background: "transparent",
+    text: "#a8a8a8",
+    dim: "#6e6e6e",
+    warn: "#dca05a",
+    error: "#dc7878",
+    syntax: "arcnight",
+}
+
+/**
+ * The themes Axon ships. A user's config adds to these; it never replaces them.
+ *
+ * ── Exactly one, deliberately ───────────────────────────────────────────────
+ *
+ * There was a second built-in — `ember` — added "purely so switching is
+ * testable: one theme cannot demonstrate that anything is actually themed."
+ * That reason expired the moment themes became installable: switching is now
+ * demonstrated by any published theme, and the built-in was doing nothing but
+ * occupying a name.
+ *
+ * And occupying a name is not free. `theme.create()` throws on a duplicate,
+ * and an extension registers at module scope — so a built-in squatting an
+ * obvious name does not merely shadow one theme, it throws partway through the
+ * file and costs every theme declared after it. `@axon/ember-theme` hit exactly
+ * that: the package could not register its own primary theme.
+ *
+ * So the rule this list follows: Axon ships the ONE theme it is designed
+ * around, and every other name belongs to whoever publishes it. A built-in
+ * added here is a name permanently taken from the ecosystem.
+ */
+export const BUILTIN_THEMES: readonly Theme[] = [arcnightTheme]
+
+/**
+ * Tokens as the CSS variables a stylesheet references.
+ *
+ * `syntax` is deliberately absent: it is a Shiki theme, not a colour, and is
+ * applied through the highlighter rather than by any `var()`.
+ */
+export function themeVariables(theme: ThemeTokens): Record<string, string> {
+    return {
+        primary: String(theme.primary),
+        background: String(theme.background),
+        text: String(theme.text),
+        dim: String(theme.dim),
+        warn: String(theme.warn),
+        error: String(theme.error),
+    }
+}