@bastani/atomic 0.9.29 → 0.9.30-alpha.2

package/dist/modes/interactive/theme/theme-tokens.d.ts

@@ -0,0 +1,262 @@
+export interface ThemeTokenDescriptor {
+    slot: "foreground" | "background";
+    description: string;
+    /** Token in the same slot that supplies this token's color when a theme omits it. */
+    fallback?: string;
+}
+export type ThemeTokenDescriptors = Readonly<Record<string, ThemeTokenDescriptor>>;
+/**
+ * Theme token metadata in the same order used by theme files and the published JSON Schema.
+ * A token with a `fallback` is optional: a theme written before the token existed keeps validating and
+ * keeps rendering with the fallback token's color.
+ */
+export declare const THEME_TOKENS: {
+    readonly accent: {
+        readonly slot: "foreground";
+        readonly description: "Primary accent color (logo, selected items, cursor)";
+    };
+    readonly border: {
+        readonly slot: "foreground";
+        readonly description: "Normal borders";
+    };
+    readonly borderAccent: {
+        readonly slot: "foreground";
+        readonly description: "Highlighted borders";
+    };
+    readonly borderMuted: {
+        readonly slot: "foreground";
+        readonly description: "Subtle borders";
+    };
+    readonly success: {
+        readonly slot: "foreground";
+        readonly description: "Success states";
+    };
+    readonly error: {
+        readonly slot: "foreground";
+        readonly description: "Error states";
+    };
+    readonly warning: {
+        readonly slot: "foreground";
+        readonly description: "Warning states";
+    };
+    readonly muted: {
+        readonly slot: "foreground";
+        readonly description: "Secondary/dimmed text";
+    };
+    readonly dim: {
+        readonly slot: "foreground";
+        readonly description: "Very dimmed text (more subtle than muted)";
+    };
+    readonly text: {
+        readonly slot: "foreground";
+        readonly description: "Default text color (usually empty string)";
+    };
+    readonly thinkingText: {
+        readonly slot: "foreground";
+        readonly description: "Thinking block text color";
+    };
+    readonly selectedBg: {
+        readonly slot: "background";
+        readonly description: "Selected item background";
+    };
+    readonly scrollbarThumb: {
+        readonly slot: "background";
+        readonly description: "Fullscreen scrollbar thumb background (falls back to selectedBg when omitted)";
+        readonly fallback: "selectedBg";
+    };
+    readonly searchMatchBg: {
+        readonly slot: "background";
+        readonly description: "Transcript search match background and current-match text (falls back to selectedBg when omitted)";
+        readonly fallback: "selectedBg";
+    };
+    readonly searchMatchText: {
+        readonly slot: "foreground";
+        readonly description: "Transcript search match text and current-match background (falls back to text when omitted)";
+        readonly fallback: "text";
+    };
+    readonly userMessageBg: {
+        readonly slot: "background";
+        readonly description: "User message background";
+    };
+    readonly userMessageText: {
+        readonly slot: "foreground";
+        readonly description: "User message text color";
+    };
+    readonly customMessageBg: {
+        readonly slot: "background";
+        readonly description: "Custom message background (hook-injected messages)";
+    };
+    readonly customMessageText: {
+        readonly slot: "foreground";
+        readonly description: "Custom message text color";
+    };
+    readonly customMessageLabel: {
+        readonly slot: "foreground";
+        readonly description: "Custom message type label color";
+    };
+    readonly toolPendingBg: {
+        readonly slot: "background";
+        readonly description: "Tool execution box (pending state)";
+    };
+    readonly toolSuccessBg: {
+        readonly slot: "background";
+        readonly description: "Tool execution box (success state)";
+    };
+    readonly toolErrorBg: {
+        readonly slot: "background";
+        readonly description: "Tool execution box (error state)";
+    };
+    readonly toolTitle: {
+        readonly slot: "foreground";
+        readonly description: "Tool execution box title color";
+    };
+    readonly toolOutput: {
+        readonly slot: "foreground";
+        readonly description: "Tool execution box output text color";
+    };
+    readonly mdHeading: {
+        readonly slot: "foreground";
+        readonly description: "Markdown heading text";
+    };
+    readonly mdLink: {
+        readonly slot: "foreground";
+        readonly description: "Markdown link text";
+    };
+    readonly mdLinkUrl: {
+        readonly slot: "foreground";
+        readonly description: "Markdown link URL";
+    };
+    readonly mdCode: {
+        readonly slot: "foreground";
+        readonly description: "Markdown inline code";
+    };
+    readonly mdCodeBlock: {
+        readonly slot: "foreground";
+        readonly description: "Markdown code block content";
+    };
+    readonly mdCodeBlockBorder: {
+        readonly slot: "foreground";
+        readonly description: "Markdown code block fences";
+    };
+    readonly mdQuote: {
+        readonly slot: "foreground";
+        readonly description: "Markdown blockquote text";
+    };
+    readonly mdQuoteBorder: {
+        readonly slot: "foreground";
+        readonly description: "Markdown blockquote border";
+    };
+    readonly mdHr: {
+        readonly slot: "foreground";
+        readonly description: "Markdown horizontal rule";
+    };
+    readonly mdListBullet: {
+        readonly slot: "foreground";
+        readonly description: "Markdown list bullets/numbers";
+    };
+    readonly toolDiffAdded: {
+        readonly slot: "foreground";
+        readonly description: "Added lines in tool diffs";
+    };
+    readonly toolDiffRemoved: {
+        readonly slot: "foreground";
+        readonly description: "Removed lines in tool diffs";
+    };
+    readonly toolDiffContext: {
+        readonly slot: "foreground";
+        readonly description: "Context lines in tool diffs";
+    };
+    readonly syntaxComment: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: comments";
+    };
+    readonly syntaxKeyword: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: keywords";
+    };
+    readonly syntaxFunction: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: function names";
+    };
+    readonly syntaxVariable: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: variable names";
+    };
+    readonly syntaxString: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: string literals";
+    };
+    readonly syntaxNumber: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: number literals";
+    };
+    readonly syntaxType: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: type names";
+    };
+    readonly syntaxOperator: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: operators";
+    };
+    readonly syntaxPunctuation: {
+        readonly slot: "foreground";
+        readonly description: "Syntax highlighting: punctuation";
+    };
+    readonly thinkingOff: {
+        readonly slot: "foreground";
+        readonly description: "Thinking level border: off";
+    };
+    readonly thinkingMinimal: {
+        readonly slot: "foreground";
+        readonly description: "Thinking level border: minimal";
+    };
+    readonly thinkingLow: {
+        readonly slot: "foreground";
+        readonly description: "Thinking level border: low";
+    };
+    readonly thinkingMedium: {
+        readonly slot: "foreground";
+        readonly description: "Thinking level border: medium";
+    };
+    readonly thinkingHigh: {
+        readonly slot: "foreground";
+        readonly description: "Thinking level border: high";
+    };
+    readonly thinkingXhigh: {
+        readonly slot: "foreground";
+        readonly description: "Thinking level border: xhigh (OpenAI codex-max only)";
+    };
+    readonly bashMode: {
+        readonly slot: "foreground";
+        readonly description: "Editor border color in bash mode";
+    };
+};
+export type ThemeToken = keyof typeof THEME_TOKENS;
+export type ThemeColor = {
+    [K in ThemeToken]: (typeof THEME_TOKENS)[K]["slot"] extends "foreground" ? K : never;
+}[ThemeToken];
+export type ThemeBg = Exclude<ThemeToken, ThemeColor>;
+type OptionalToken = {
+    [K in ThemeToken]: (typeof THEME_TOKENS)[K] extends {
+        fallback: string;
+    } ? K : never;
+}[ThemeToken];
+type RequiredToken = Exclude<ThemeToken, OptionalToken>;
+export type ThemeColorValues<Value> = {
+    [K in RequiredToken]: Value;
+} & {
+    [K in OptionalToken]?: Value;
+};
+export type ResolvedThemeColorValues<Value> = Record<ThemeToken, Value>;
+/** Fill omitted optional tokens from their fallback tokens. */
+export declare function withThemeTokenFallbacks<Value>(values: ThemeColorValues<Value>): ResolvedThemeColorValues<Value>;
+/**
+ * Split resolved token values into the foreground and background slots. Generated system themes also carry
+ * palette entries that theme files cannot set; those are not tokens and are left out.
+ */
+export declare function splitThemeColors(colors: ResolvedThemeColorValues<string | number>): {
+    fgColors: Record<ThemeColor, string | number>;
+    bgColors: Record<ThemeBg, string | number>;
+};
+export {};
+//# sourceMappingURL=theme-tokens.d.ts.map

package/dist/modes/interactive/theme/theme-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-tokens.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/theme/theme-tokens.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAgBnF;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEvB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC;AACnD,MAAM,MAAM,UAAU,GAAG;KACvB,CAAC,IAAI,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,YAAY,GAAG,CAAC,GAAG,KAAK;CACpF,CAAC,UAAU,CAAC,CAAC;AACd,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAEtD,KAAK,aAAa,GAAG;KACnB,CAAC,IAAI,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK;CACpF,CAAC,UAAU,CAAC,CAAC;AAEd,KAAK,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAExD,MAAM,MAAM,gBAAgB,CAAC,KAAK,IAAI;KACpC,CAAC,IAAI,aAAa,GAAG,KAAK;CAC3B,GAAG;KACF,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,KAAK;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAExE,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAc/G;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,wBAAwB,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG;IACpF,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC3C,CAaA"}

package/dist/modes/interactive/theme/theme-tokens.js

@@ -0,0 +1,126 @@
+function defineThemeTokens(tokens) {
+    for (const [name, descriptor] of Object.entries(tokens)) {
+        if (descriptor.fallback === undefined)
+            continue;
+        const fallback = tokens[descriptor.fallback];
+        if (fallback === undefined) {
+            throw new Error(`Theme token ${name} has unknown fallback ${descriptor.fallback}`);
+        }
+        if (fallback.slot !== descriptor.slot) {
+            throw new Error(`Theme token ${name} has fallback ${descriptor.fallback} in a different color slot`);
+        }
+    }
+    return tokens;
+}
+/**
+ * Theme token metadata in the same order used by theme files and the published JSON Schema.
+ * A token with a `fallback` is optional: a theme written before the token existed keeps validating and
+ * keeps rendering with the fallback token's color.
+ */
+export const THEME_TOKENS = defineThemeTokens({
+    accent: { slot: "foreground", description: "Primary accent color (logo, selected items, cursor)" },
+    border: { slot: "foreground", description: "Normal borders" },
+    borderAccent: { slot: "foreground", description: "Highlighted borders" },
+    borderMuted: { slot: "foreground", description: "Subtle borders" },
+    success: { slot: "foreground", description: "Success states" },
+    error: { slot: "foreground", description: "Error states" },
+    warning: { slot: "foreground", description: "Warning states" },
+    muted: { slot: "foreground", description: "Secondary/dimmed text" },
+    dim: { slot: "foreground", description: "Very dimmed text (more subtle than muted)" },
+    text: { slot: "foreground", description: "Default text color (usually empty string)" },
+    thinkingText: { slot: "foreground", description: "Thinking block text color" },
+    selectedBg: { slot: "background", description: "Selected item background" },
+    scrollbarThumb: {
+        slot: "background",
+        description: "Fullscreen scrollbar thumb background (falls back to selectedBg when omitted)",
+        fallback: "selectedBg",
+    },
+    searchMatchBg: {
+        slot: "background",
+        description: "Transcript search match background and current-match text (falls back to selectedBg when omitted)",
+        fallback: "selectedBg",
+    },
+    searchMatchText: {
+        slot: "foreground",
+        description: "Transcript search match text and current-match background (falls back to text when omitted)",
+        fallback: "text",
+    },
+    userMessageBg: { slot: "background", description: "User message background" },
+    userMessageText: { slot: "foreground", description: "User message text color" },
+    customMessageBg: { slot: "background", description: "Custom message background (hook-injected messages)" },
+    customMessageText: { slot: "foreground", description: "Custom message text color" },
+    customMessageLabel: { slot: "foreground", description: "Custom message type label color" },
+    toolPendingBg: { slot: "background", description: "Tool execution box (pending state)" },
+    toolSuccessBg: { slot: "background", description: "Tool execution box (success state)" },
+    toolErrorBg: { slot: "background", description: "Tool execution box (error state)" },
+    toolTitle: { slot: "foreground", description: "Tool execution box title color" },
+    toolOutput: { slot: "foreground", description: "Tool execution box output text color" },
+    mdHeading: { slot: "foreground", description: "Markdown heading text" },
+    mdLink: { slot: "foreground", description: "Markdown link text" },
+    mdLinkUrl: { slot: "foreground", description: "Markdown link URL" },
+    mdCode: { slot: "foreground", description: "Markdown inline code" },
+    mdCodeBlock: { slot: "foreground", description: "Markdown code block content" },
+    mdCodeBlockBorder: { slot: "foreground", description: "Markdown code block fences" },
+    mdQuote: { slot: "foreground", description: "Markdown blockquote text" },
+    mdQuoteBorder: { slot: "foreground", description: "Markdown blockquote border" },
+    mdHr: { slot: "foreground", description: "Markdown horizontal rule" },
+    mdListBullet: { slot: "foreground", description: "Markdown list bullets/numbers" },
+    toolDiffAdded: { slot: "foreground", description: "Added lines in tool diffs" },
+    toolDiffRemoved: { slot: "foreground", description: "Removed lines in tool diffs" },
+    toolDiffContext: { slot: "foreground", description: "Context lines in tool diffs" },
+    syntaxComment: { slot: "foreground", description: "Syntax highlighting: comments" },
+    syntaxKeyword: { slot: "foreground", description: "Syntax highlighting: keywords" },
+    syntaxFunction: { slot: "foreground", description: "Syntax highlighting: function names" },
+    syntaxVariable: { slot: "foreground", description: "Syntax highlighting: variable names" },
+    syntaxString: { slot: "foreground", description: "Syntax highlighting: string literals" },
+    syntaxNumber: { slot: "foreground", description: "Syntax highlighting: number literals" },
+    syntaxType: { slot: "foreground", description: "Syntax highlighting: type names" },
+    syntaxOperator: { slot: "foreground", description: "Syntax highlighting: operators" },
+    syntaxPunctuation: { slot: "foreground", description: "Syntax highlighting: punctuation" },
+    thinkingOff: { slot: "foreground", description: "Thinking level border: off" },
+    thinkingMinimal: { slot: "foreground", description: "Thinking level border: minimal" },
+    thinkingLow: { slot: "foreground", description: "Thinking level border: low" },
+    thinkingMedium: { slot: "foreground", description: "Thinking level border: medium" },
+    thinkingHigh: { slot: "foreground", description: "Thinking level border: high" },
+    thinkingXhigh: { slot: "foreground", description: "Thinking level border: xhigh (OpenAI codex-max only)" },
+    bashMode: { slot: "foreground", description: "Editor border color in bash mode" },
+});
+/** Fill omitted optional tokens from their fallback tokens. */
+export function withThemeTokenFallbacks(values) {
+    const resolved = { ...values };
+    for (const [rawName, descriptor] of Object.entries(THEME_TOKENS)) {
+        if (!("fallback" in descriptor))
+            continue;
+        const name = rawName;
+        if (resolved[name] !== undefined)
+            continue;
+        const fallback = descriptor.fallback;
+        const fallbackValue = resolved[fallback];
+        if (fallbackValue === undefined) {
+            throw new Error(`Theme token ${rawName} has unresolved fallback ${descriptor.fallback}`);
+        }
+        resolved[name] = fallbackValue;
+    }
+    return resolved;
+}
+/**
+ * Split resolved token values into the foreground and background slots. Generated system themes also carry
+ * palette entries that theme files cannot set; those are not tokens and are left out.
+ */
+export function splitThemeColors(colors) {
+    const fgColors = {};
+    const bgColors = {};
+    for (const [key, value] of Object.entries(colors)) {
+        const token = THEME_TOKENS[key];
+        if (token === undefined)
+            continue;
+        if (token.slot === "background") {
+            bgColors[key] = value;
+        }
+        else {
+            fgColors[key] = value;
+        }
+    }
+    return { fgColors, bgColors };
+}
+//# sourceMappingURL=theme-tokens.js.map

package/dist/modes/interactive/theme/theme-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-tokens.js","sourceRoot":"","sources":["../../../../src/modes/interactive/theme/theme-tokens.ts"],"names":[],"mappings":"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","sourcesContent":["export interface ThemeTokenDescriptor {\n\tslot: \"foreground\" | \"background\";\n\tdescription: string;\n\t/** Token in the same slot that supplies this token's color when a theme omits it. */\n\tfallback?: string;\n}\n\nexport type ThemeTokenDescriptors = Readonly<Record<string, ThemeTokenDescriptor>>;\n\nfunction defineThemeTokens<const T extends ThemeTokenDescriptors>(tokens: T): T {\n\tfor (const [name, descriptor] of Object.entries(tokens)) {\n\t\tif (descriptor.fallback === undefined) continue;\n\t\tconst fallback = tokens[descriptor.fallback];\n\t\tif (fallback === undefined) {\n\t\t\tthrow new Error(`Theme token ${name} has unknown fallback ${descriptor.fallback}`);\n\t\t}\n\t\tif (fallback.slot !== descriptor.slot) {\n\t\t\tthrow new Error(`Theme token ${name} has fallback ${descriptor.fallback} in a different color slot`);\n\t\t}\n\t}\n\treturn tokens;\n}\n\n/**\n * Theme token metadata in the same order used by theme files and the published JSON Schema.\n * A token with a `fallback` is optional: a theme written before the token existed keeps validating and\n * keeps rendering with the fallback token's color.\n */\nexport const THEME_TOKENS = defineThemeTokens({\n\taccent: { slot: \"foreground\", description: \"Primary accent color (logo, selected items, cursor)\" },\n\tborder: { slot: \"foreground\", description: \"Normal borders\" },\n\tborderAccent: { slot: \"foreground\", description: \"Highlighted borders\" },\n\tborderMuted: { slot: \"foreground\", description: \"Subtle borders\" },\n\tsuccess: { slot: \"foreground\", description: \"Success states\" },\n\terror: { slot: \"foreground\", description: \"Error states\" },\n\twarning: { slot: \"foreground\", description: \"Warning states\" },\n\tmuted: { slot: \"foreground\", description: \"Secondary/dimmed text\" },\n\tdim: { slot: \"foreground\", description: \"Very dimmed text (more subtle than muted)\" },\n\ttext: { slot: \"foreground\", description: \"Default text color (usually empty string)\" },\n\tthinkingText: { slot: \"foreground\", description: \"Thinking block text color\" },\n\tselectedBg: { slot: \"background\", description: \"Selected item background\" },\n\tscrollbarThumb: {\n\t\tslot: \"background\",\n\t\tdescription: \"Fullscreen scrollbar thumb background (falls back to selectedBg when omitted)\",\n\t\tfallback: \"selectedBg\",\n\t},\n\tsearchMatchBg: {\n\t\tslot: \"background\",\n\t\tdescription: \"Transcript search match background and current-match text (falls back to selectedBg when omitted)\",\n\t\tfallback: \"selectedBg\",\n\t},\n\tsearchMatchText: {\n\t\tslot: \"foreground\",\n\t\tdescription: \"Transcript search match text and current-match background (falls back to text when omitted)\",\n\t\tfallback: \"text\",\n\t},\n\tuserMessageBg: { slot: \"background\", description: \"User message background\" },\n\tuserMessageText: { slot: \"foreground\", description: \"User message text color\" },\n\tcustomMessageBg: { slot: \"background\", description: \"Custom message background (hook-injected messages)\" },\n\tcustomMessageText: { slot: \"foreground\", description: \"Custom message text color\" },\n\tcustomMessageLabel: { slot: \"foreground\", description: \"Custom message type label color\" },\n\ttoolPendingBg: { slot: \"background\", description: \"Tool execution box (pending state)\" },\n\ttoolSuccessBg: { slot: \"background\", description: \"Tool execution box (success state)\" },\n\ttoolErrorBg: { slot: \"background\", description: \"Tool execution box (error state)\" },\n\ttoolTitle: { slot: \"foreground\", description: \"Tool execution box title color\" },\n\ttoolOutput: { slot: \"foreground\", description: \"Tool execution box output text color\" },\n\tmdHeading: { slot: \"foreground\", description: \"Markdown heading text\" },\n\tmdLink: { slot: \"foreground\", description: \"Markdown link text\" },\n\tmdLinkUrl: { slot: \"foreground\", description: \"Markdown link URL\" },\n\tmdCode: { slot: \"foreground\", description: \"Markdown inline code\" },\n\tmdCodeBlock: { slot: \"foreground\", description: \"Markdown code block content\" },\n\tmdCodeBlockBorder: { slot: \"foreground\", description: \"Markdown code block fences\" },\n\tmdQuote: { slot: \"foreground\", description: \"Markdown blockquote text\" },\n\tmdQuoteBorder: { slot: \"foreground\", description: \"Markdown blockquote border\" },\n\tmdHr: { slot: \"foreground\", description: \"Markdown horizontal rule\" },\n\tmdListBullet: { slot: \"foreground\", description: \"Markdown list bullets/numbers\" },\n\ttoolDiffAdded: { slot: \"foreground\", description: \"Added lines in tool diffs\" },\n\ttoolDiffRemoved: { slot: \"foreground\", description: \"Removed lines in tool diffs\" },\n\ttoolDiffContext: { slot: \"foreground\", description: \"Context lines in tool diffs\" },\n\tsyntaxComment: { slot: \"foreground\", description: \"Syntax highlighting: comments\" },\n\tsyntaxKeyword: { slot: \"foreground\", description: \"Syntax highlighting: keywords\" },\n\tsyntaxFunction: { slot: \"foreground\", description: \"Syntax highlighting: function names\" },\n\tsyntaxVariable: { slot: \"foreground\", description: \"Syntax highlighting: variable names\" },\n\tsyntaxString: { slot: \"foreground\", description: \"Syntax highlighting: string literals\" },\n\tsyntaxNumber: { slot: \"foreground\", description: \"Syntax highlighting: number literals\" },\n\tsyntaxType: { slot: \"foreground\", description: \"Syntax highlighting: type names\" },\n\tsyntaxOperator: { slot: \"foreground\", description: \"Syntax highlighting: operators\" },\n\tsyntaxPunctuation: { slot: \"foreground\", description: \"Syntax highlighting: punctuation\" },\n\tthinkingOff: { slot: \"foreground\", description: \"Thinking level border: off\" },\n\tthinkingMinimal: { slot: \"foreground\", description: \"Thinking level border: minimal\" },\n\tthinkingLow: { slot: \"foreground\", description: \"Thinking level border: low\" },\n\tthinkingMedium: { slot: \"foreground\", description: \"Thinking level border: medium\" },\n\tthinkingHigh: { slot: \"foreground\", description: \"Thinking level border: high\" },\n\tthinkingXhigh: { slot: \"foreground\", description: \"Thinking level border: xhigh (OpenAI codex-max only)\" },\n\tbashMode: { slot: \"foreground\", description: \"Editor border color in bash mode\" },\n});\n\nexport type ThemeToken = keyof typeof THEME_TOKENS;\nexport type ThemeColor = {\n\t[K in ThemeToken]: (typeof THEME_TOKENS)[K][\"slot\"] extends \"foreground\" ? K : never;\n}[ThemeToken];\nexport type ThemeBg = Exclude<ThemeToken, ThemeColor>;\n\ntype OptionalToken = {\n\t[K in ThemeToken]: (typeof THEME_TOKENS)[K] extends { fallback: string } ? K : never;\n}[ThemeToken];\n\ntype RequiredToken = Exclude<ThemeToken, OptionalToken>;\n\nexport type ThemeColorValues<Value> = {\n\t[K in RequiredToken]: Value;\n} & {\n\t[K in OptionalToken]?: Value;\n};\n\nexport type ResolvedThemeColorValues<Value> = Record<ThemeToken, Value>;\n\n/** Fill omitted optional tokens from their fallback tokens. */\nexport function withThemeTokenFallbacks<Value>(values: ThemeColorValues<Value>): ResolvedThemeColorValues<Value> {\n\tconst resolved = { ...values } as Partial<ResolvedThemeColorValues<Value>>;\n\tfor (const [rawName, descriptor] of Object.entries(THEME_TOKENS)) {\n\t\tif (!(\"fallback\" in descriptor)) continue;\n\t\tconst name = rawName as ThemeToken;\n\t\tif (resolved[name] !== undefined) continue;\n\t\tconst fallback = descriptor.fallback as ThemeToken;\n\t\tconst fallbackValue = resolved[fallback];\n\t\tif (fallbackValue === undefined) {\n\t\t\tthrow new Error(`Theme token ${rawName} has unresolved fallback ${descriptor.fallback}`);\n\t\t}\n\t\tresolved[name] = fallbackValue;\n\t}\n\treturn resolved as ResolvedThemeColorValues<Value>;\n}\n\n/**\n * Split resolved token values into the foreground and background slots. Generated system themes also carry\n * palette entries that theme files cannot set; those are not tokens and are left out.\n */\nexport function splitThemeColors(colors: ResolvedThemeColorValues<string | number>): {\n\tfgColors: Record<ThemeColor, string | number>;\n\tbgColors: Record<ThemeBg, string | number>;\n} {\n\tconst fgColors = {} as Record<ThemeColor, string | number>;\n\tconst bgColors = {} as Record<ThemeBg, string | number>;\n\tfor (const [key, value] of Object.entries(colors)) {\n\t\tconst token: ThemeTokenDescriptor | undefined = THEME_TOKENS[key as ThemeToken];\n\t\tif (token === undefined) continue;\n\t\tif (token.slot === \"background\") {\n\t\t\tbgColors[key as ThemeBg] = value;\n\t\t} else {\n\t\t\tfgColors[key as ThemeColor] = value;\n\t\t}\n\t}\n\treturn { fgColors, bgColors };\n}\n"]}

package/docs/compaction/reference.md

@@ -259,7 +259,7 @@ Configure compaction in `~/.atomic/agent/settings.json` or `<project-dir>/.atomi
 | `enabled` | `true` | Enable automatic Verbatim Compaction. |
 | `reserveTokens` | `16384` | Tokens to reserve for the next LLM response; threshold auto-compaction starts when completed-response usage or a prospective post-tool context exceeds the model's effective input budget minus this reserve. It is an **input-side** reserve only and never caps planner output. |
 
-The top-level `compactionModel` setting defaults to `"auto"`, using the session model. An exact registered chat-model, classifier, or compactor ID selects a separate compactor. Project settings may not select `morph/*`. See [Compaction model](/compaction#compaction-model).
+The top-level `compactionModel` setting defaults to `"auto"`, using the session model. An exact registered chat-model, classifier, or compactor ID selects a separate compactor. See [Compaction model](/compaction#compaction-model).
 
 Fallback borrowing reuses `settings.fallbackModels`, the same ordered `provider/model[:thinkingLevel]` list used for chat fallback. It skips entries equal to the selected compaction model. A policy refusal from any chat compaction model, including `auto`, explicit chat-model IDs, and borrowed fallback entries, first tries pi's summary compaction on the same model. Classifier and Morph refusals skip summary fallback and advance directly to the next configured model. Other failures and failed summaries also advance to the next configured model. Only load-bearing recovery may clear older context after all attempts fail.
 

package/docs/compaction.md

@@ -100,13 +100,13 @@ You can also set `compactionModel` in `~/.atomic/agent/settings.json` or a trust
 }
 ```
 
-The default, `auto`, or an empty value uses the current session model, including Anthropic models. An exact registered chat-model ID selects that model just for compaction. Registered classifiers and Morph compactors are also selectable. Project settings cannot select `morph/*`; choose Morph globally instead.
+The default, `auto`, or an empty value uses the current session model, including Anthropic models. An exact registered chat-model ID selects that model just for compaction. Registered classifiers and Morph compactors are also selectable, in global or trusted project settings.
 
 An explicit compaction model can send the compactable transcript to a different provider, using that provider's credentials. Choose only providers permitted to receive your conversation. Changing `compactionModel` does not affect branch summaries. SDK and extension code can pick a model for a single run with `session.compact({ compactionModel })` or `ctx.compact({ compactionModel })`, which leaves the setting unchanged.
 
 For classifier compaction, log in with `/login typesafe`, then set `"compactionModel": "typesafe/jev-latest"`. The classifier scores groups of transcript lines; Atomic removes lower-scored groups without rewriting the rest. Protected lines and the recent tail are not sent for scoring. If scoring fails, Atomic tries your fallback models. Group boundaries can make the retained fraction differ from the requested compression ratio.
 
-For Morph compaction, use `/login morph` or set `MORPH_API_KEY`, then choose `morph/morph-compactor` in the global selector or settings file. Without a credential, the selector marks Morph as `requires /login morph`. Morph receives the compactable transcript, including serialized thinking, but not the recent tail. Atomic reconstructs surviving lines from the originals and preserves `<keepContext>` spans. Morph is not a chat-model choice.
+For Morph compaction, use `/login morph` or set `MORPH_API_KEY`, then choose `morph/morph-compactor` in the selector or a settings file. Without a credential, the selector marks Morph as `requires /login morph`. Morph receives the compactable transcript, including serialized thinking, but not the recent tail. Atomic reconstructs surviving lines from the originals and preserves `<keepContext>` spans. Morph is not a chat-model choice.
 
 The compaction card shows the backend and model that produced the result, such as `classifier · typesafe/jev-latest` or `morph · morph/morph-compactor`. A policy-refusal summary appears as `summary (pi fallback)`.
 

package/docs/keybindings.md

@@ -8,6 +8,8 @@ Older configs using pre-namespaced ids such as `cursorUp` or `expandTools` are m
 
 After editing `keybindings.json`, run `/reload` in Atomic to apply the changes without restarting the session.
 
+For editor completion of every action id and validation of key syntax, add `"$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/schemas/keybindings.schema.json"` to `keybindings.json`. Atomic ignores `$schema` when it loads your bindings.
+
 ## Workflow widget scrolling
 
 `app.workflows.scrollUp` defaults to `["alt+k", "alt+pageUp"]`; `app.workflows.scrollDown` defaults to `["alt+j", "alt+pageDown"]`. These scroll the main-chat workflow list without leaving the editor. Any other configured editor binding takes precedence, including the Vim Alt+J/K cursor bindings. Alt+Up remains available for queued messages.

package/docs/models.md

@@ -15,6 +15,8 @@ If refresh times out or fails, the selector reports that it is using cached mode
 
 A complete `defaultProvider`/`defaultModel` pair in `settings.json` is resolved after built-in, configured, and extension providers register. If the provider remains unsupported, interactive mode reports a generic saved-configuration warning and leaves model selection open instead of routing the session to a different provider. Print and JSON modes write that diagnostic to stderr and exit nonzero before prompting, keeping JSON stdout JSONL-clean. RPC rejects `prompt` with the same correlated diagnostic until an explicit successful `set_model` selects an available model or an explicit model cycle returns a different available model. A null or unchanged cycle result does not clear the condition. If the provider is supported but the model is unknown or lacks authentication, normal automatic selection of an available authenticated model continues. Valid custom- and extension-provider defaults resolve once their provider registration is available. See [Settings](/settings#model-&-thinking).
 
+For editor completion and validation of providers, models, and `compat` fields, add `"$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/schemas/models.schema.json"` to `models.json`.
+
 ## Where to go next
 
 This page shows minimal and full `models.json` examples you can copy. Every field, override, derived variant, and API compatibility contract lives in the [Model configuration reference](/models/reference).

package/docs/providers.md

@@ -626,7 +626,7 @@ Use `/login morph` to save a Morph API key under `morph` in `~/.atomic/agent/aut
 
 Then choose `morph/morph-compactor` through `/settings` → **Compaction model**, or set `"compactionModel": "morph/morph-compactor"` in global settings. Without credentials, the selector marks it as `requires /login morph`. Morph receives the compactable transcript, including serialized thinking; the preserved recent tail is not sent. Atomic retains the original surviving lines and enforces `<keepContext>` protection. Choose Morph only if it is permitted to receive your transcript.
 
-Morph is a compactor, not a chat model. It does not appear in `/model` or automatic model routing. Project settings cannot select `morph/*`. Missing credentials, HTTP errors, policy refusals, or unusable results advance directly to your configured fallback models without a Morph summary request. `/logout morph` removes the saved credential; an environment key remains active until you unset it. See [Compaction model](/compaction#compaction-model).
+Morph is a compactor, not a chat model. It does not appear in `/model` or automatic model routing. Missing credentials, HTTP errors, policy refusals, or unusable results advance directly to your configured fallback models without a Morph summary request. `/logout morph` removes the saved credential; an environment key remains active until you unset it. See [Compaction model](/compaction#compaction-model).
 
 ## Custom Providers
 

package/docs/settings.md

@@ -9,6 +9,8 @@ Atomic uses JSON settings files with project settings overriding global settings
 
 Edit directly or use `/settings` for common options. Choosing a model or thinking level with `/model`, `/thinking`, or their cycling shortcuts automatically saves it as the startup default. Thinking choices also update the active model's saved thinking level. `/scoped-models` saves cycle-list changes automatically. SDK calls, session restoration, and automatic fallbacks do not overwrite these defaults unless persistence is explicitly requested. Atomic also reads legacy `~/.pi/agent/settings.json` and `.pi/settings.json` as compatibility fallbacks, with `.atomic` paths taking precedence.
 
+For editor completion and validation, add `"$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/schemas/settings.schema.json"` to `settings.json`. Atomic preserves `$schema` and settings it does not recognize, such as extension settings, when it saves.
+
 Saving an Atomic setting applies only the changed fields to the corresponding `.atomic` file; it does not copy untouched fallback fields out of `.pi`. To intentionally override an inherited array such as `packages`, set it in `.atomic`, including an explicit empty array (`"packages": []`) when the inherited list should be disabled.
 
 ## On this page and its guide

package/docs/themes/reference.md

@@ -9,7 +9,7 @@ description: Theme file format, every color token, and accepted color values.
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/schemas/theme.schema.json",
   "name": "my-theme",
   "vars": {
     "blue": "#0066cc",
@@ -40,7 +40,7 @@ description: Theme file format, every color token, and accepted color values.
   - When an index from 0 through 15 seeds an omitted tone, Atomic mixes from its built-in approximation of the common ANSI RGB value. The terminal still controls the explicit index's actual appearance.
   - Both explicit and derived tones update on theme hot reload.
 
-The `$schema` field enables editor auto-completion and validation.
+The `$schema` field enables editor auto-completion and validation against the [theme JSON schema](https://github.com/bastani-inc/atomic/blob/main/packages/coding-agent/schemas/theme.schema.json). Atomic itself rejects theme files with unknown top-level fields or unknown properties under `colors`, `workingIndicator`, or `export`; define reusable custom colors under `vars` instead.
 
 ## Color Tokens
 

package/docs/themes.md

@@ -80,7 +80,7 @@ vim ~/.atomic/agent/themes/my-theme.json
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/schemas/theme.schema.json",
   "name": "my-theme",
   "vars": {
     "primary": "#00aaff",
@@ -147,6 +147,8 @@ vim ~/.atomic/agent/themes/my-theme.json
 
 Atomic automatically reloads the active custom theme when you edit its file, so you can see changes immediately.
 
+Theme files are strict. Atomic accepts only the documented top-level fields and color tokens; custom keys under `colors`, `workingIndicator`, or `export` and extra top-level metadata make the theme invalid. Define reusable custom colors under `vars`. The [theme JSON schema](https://github.com/bastani-inc/atomic/blob/main/packages/coding-agent/schemas/theme.schema.json) lists every accepted property, the required colors, and the accepted value types. Atomic reports invalid theme files during startup and `/reload`.
+
 ## Theme Format
 
 Moved to [Theme reference](/themes/reference#theme-format).

package/examples/extensions/dynamic-resources/dynamic.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"$schema": "https://raw.githubusercontent.com/bastani-inc/atomic/main/packages/coding-agent/schemas/theme.schema.json",
 	"name": "dynamic-resources",
 	"vars": {
 		"cyan": "#00d7ff",