📄 File detail

components/StructuredDiff/colorDiff.ts

🧩 .ts📏 38 lines💾 1,137 bytes📝 text

🎯 Use case

This file lives under “components/”, which covers shared React UI pieces. On the API surface it exposes ColorModuleUnavailableReason, getColorModuleUnavailableReason, expectColorDiff, expectColorFile, and getSyntaxTheme — mainly functions, hooks, or classes. Dependencies touch color-diff-napi. It composes internal code from utils (relative imports).

Generated from folder role, exports, dependency roots, and inline comments — not hand-reviewed for every path.

🧠 Inline summary

import { ColorDiff, ColorFile, getSyntaxTheme as nativeGetSyntaxTheme, type SyntaxTheme,

📤 Exports (heuristic)

ColorModuleUnavailableReason
getColorModuleUnavailableReason
expectColorDiff
expectColorFile
getSyntaxTheme

📚 External import roots

Package roots from from "…" (relative paths omitted).

color-diff-napi

🖥️ Source preview

import {
  ColorDiff,
  ColorFile,
  getSyntaxTheme as nativeGetSyntaxTheme,
  type SyntaxTheme,
} from 'color-diff-napi'
import { isEnvDefinedFalsy } from '../../utils/envUtils.js'

export type ColorModuleUnavailableReason = 'env'

/**
 * Returns a static reason why the color-diff module is unavailable, or null if available.
 * 'env' = disabled via CLAUDE_CODE_SYNTAX_HIGHLIGHT
 *
 * The TS port of color-diff works in all build modes, so the only way to
 * disable it is via the env var.
 */
export function getColorModuleUnavailableReason(): ColorModuleUnavailableReason | null {
  if (isEnvDefinedFalsy(process.env.CLAUDE_CODE_SYNTAX_HIGHLIGHT)) {
    return 'env'
  }
  return null
}

export function expectColorDiff(): typeof ColorDiff | null {
  return getColorModuleUnavailableReason() === null ? ColorDiff : null
}

export function expectColorFile(): typeof ColorFile | null {
  return getColorModuleUnavailableReason() === null ? ColorFile : null
}

export function getSyntaxTheme(themeName: string): SyntaxTheme | null {
  return getColorModuleUnavailableReason() === null
    ? nativeGetSyntaxTheme(themeName)
    : null
}