ft-paper and ft-paper-night for VS Code

One extension with two color themes, generated from the published palettes of camillehdl.dev:

• ft-paper, a light theme from the day palette.
• ft-paper-night, a dark theme from the night palette.

Existing installations receive both themes through the same extension update.

The night screenshot shows VS Code with an isolated profile and the packaged theme.

Install

• Marketplace: search for ft-paper in the Extensions view, or code --install-extension CamilleHodoul.ft-paper.
• From a local package: code --install-extension ft-paper-0.3.1.vsix.

Run Preferences: Color Theme, then select ft-paper or ft-paper-night.

Colors

Both palette pages list hex values, terminal ANSI slots, and contrast ratios. The themes use the same syntax roles with each palette's colors.

Syntax

The syntax roles follow the code colors of camillehdl.dev (see the Code roles on the palette page).

Semantic highlighting is enabled with the same roles.

Interface

VS Code requires translucent colors for diff, search, and merge backgrounds. Both themes use the published recipe hues. Night recipes mix day accents over night paper. Night diff lines and conflict contents reproduce fill-add, fill-remove and fill-change within one RGB step. Incoming conflict headers and changed merge words reproduce fill-change-focus after stacking. Diff gutters use the same recipes as their lines. Ordinary editor and terminal search washes reproduce fill-match and fill-target, with ink match text.

In vs-dark, editor selections retain their syntax colors; editor.selectionForeground only applies to high contrast themes. The night editor uses a 65% surface-2 selection to improve text contrast while keeping selections visible through the published fills. Other occurrences of the selected text have an oxford border. Changed diff words have colored borders.

Text without selection stays at least 4.5:1 on the checked night fills, including stacked words and conflict headers. Selected syntax on diffs and conflicts has an explicit exception: at least 3:1, currently 3.92:1 in the worst case. With the published fill-change-focus, a lighter selection distinct enough to meet the 1.10 visibility threshold cannot retain 4.5:1 for every syntax color. The checker reports each selected diff or conflict below 4.5:1 and fails below 3:1. All other checked night selections retain the 4.5:1 threshold.

Opacities are rounded to 8-bit alpha values. List matches retain claret text; search editor and peek code decorations retain syntax colors.

Build

Requires Node.js 18 or later. The generator has no npm dependencies. Package verification also requires unzip.

npm run palette   # refresh both palettes from their published pages
npm run build     # generate both themes from scripts/theme.mjs
npm run check     # off-palette colors, contrast, unknown keys
npm run package   # package without dependency detection, then verify the VSIX

• palette/ft-paper.json: the structured data published on the palette page (<script id="ft-paper-palette">), committed as published.
• palette/ft-paper-night.json: the night page's JSON (#ft-paper-night-palette). The build reads both committed palettes without fetching them.
• scripts/theme.mjs: the theme specification, written in palette roles, never in hex.
• themes/*-color-theme.json: generated; do not edit by hand.
• npm run check exits with code 1 if:
  • a theme contribution has the wrong name, path, or light/dark type;
  • either theme JSON differs from a fresh build;
  • an opaque color is not a palette color or a derived fill;
  • a translucent color has no palette or published recipe base, or no written reason;
  • a required translucent background is opaque, or a night overlay exceeds 60% opacity;
  • night selection visibility under a checked overlay is below a 1.10 contrast ratio;
  • selected night text is below 4.5:1 under the checked overlays, except syntax selected on diffs or conflicts, which fails below 3:1;
  • night diff lines, gutters or conflict fills differ from their published recipes, or common ancestor content has less than 1.10 contrast with the editor background;
  • a night diff word or conflict header has less than 1.05 contrast with its content;
  • body text, comments, line numbers or any syntax color is below 4.5:1 on the editor, hover or peek background;
  • interface content text, including ghost text and ignored files, is below 4.5:1;
  • night syntax is below 4.5:1 on the checked selection, suggestion, diff, search, peek match, list filter, or merge backgrounds;
  • syntax roles, cursor colors, or ANSI slots differ from their palette roles;
  • any night ANSI color is below 4.5:1 on the terminal background;
  • a key is missing from the theme color reference (skipped when offline).

Packaging runs the build and checks through vscode:prepublish. npm run package uses --no-dependencies for this extension without dependencies, then checks the actual archive. The packaged version and contributions must match package.json, both theme files must match the generated files, and the README and license must be present. You can repeat that check with node scripts/check-package.mjs ft-paper-0.3.1.vsix.

Known limits

• The day theme is unchanged from 0.2.0. Some syntax colors on selection, diff, search, and merge backgrounds remain below 4.5:1. Body text stays above 6:1. The check reports these exceptions. The published day ANSI colors also include contrasts below 4.5:1 and remain unchanged.
• Night syntax selected over diff or conflict fills can fall below 4.5:1. The checker enforces 3:1 for these combinations only. The fills retain their published colors and the selection remains visible.
• Disabled text uses ink-disabled and is exempt from the content text checks. Ignored files and ghost text use ink-muted and pass.
• ANSI contrast is checked on the terminal background. ANSI text on colored application backgrounds or terminal selections can have lower contrast.
• Keys not set by a theme fall back to VS Code's corresponding light or dark defaults. The check covers explicit text/background pairs, not every extension or combination of overlapping decorations.

License

0BSD.