Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

5.2 KB
Raw Blame
/**
 * 外部主题导入的纯函数入口(无 IO)。main 侧只负责选文件、读字节、落盘。
 *
 * 详细设计见 `palette.ts`(模板来源)、`vscode.ts` / `obsidian.ts`(抽取规则)、
 * `protected-tokens.ts`(语义豁免族)。
 */

import { buildThemeColorsFromPalette } from './palette';
import { UnsupportedThemePaletteError } from './errors';
import { stripProtectedTokens } from './protected-tokens';
import type {
  ConvertedTheme,
  ThemeConversionResult,
  ThemeImportSource,
} from './types';
import { collectObsidianVars, extractObsidianPalette } from './obsidian';
import { extractVsCodePalette, parseVsCodeThemeJson } from './vscode';

export type { ConvertedTheme, ThemeConversionResult } from './types';
export { UnsupportedThemePaletteError };
export { TEMPLATE_TOKEN_IDS, buildThemeColorsFromPalette } from './palette';
export { isProtectedToken, stripProtectedTokens } from './protected-tokens';

/** 色板角色总数——报告里 "命中 N/13" 的分母。 */
export const PALETTE_ROLE_COUNT = 13;

const WINDOWS_RESERVED_RE = /^(con|prn|aux|nul|com[0-9]|lpt[0-9])$/i;

// Maximum slug length. Filesystem limit is 255 bytes; we need room for:
// `-dark` (5) + `-99` (3) + `-local` (6) + `.json` (5) = 19 chars overhead.
const MAX_SLUG_LENGTH = 200;

function toSlug(name: string): string {
  let slug = name
    .trim()
    .toLowerCase()
    .replace(/[^a-z0-9]+/g, '-')
    .replace(/^-+|-+$/g, '');
  if (slug.length === 0) return 'imported-theme';
  if (WINDOWS_RESERVED_RE.test(slug)) slug = `theme-${slug}`;
  if (slug.length > MAX_SLUG_LENGTH) {
    slug = slug.slice(0, MAX_SLUG_LENGTH).replace(/-+$/, '');
  }
  return slug;
}

/**
 * 展示名 → slug。既用作单产物的落盘 baseId,也用作双态产物的 family 键
 * (writer 侧还会再消毒一次并处理文件重名)。
 */
export function themeFamilyId(name: string): string {
  return toSlug(name);
}

/** VSCode 颜色主题 JSON → 转换结果。不是可用主题时返回 null。 */
export function convertVsCodeTheme(
  raw: string,
  fallbackName: string,
): ThemeConversionResult | null {
  const parsed = parseVsCodeThemeJson(raw);
  if (!parsed) return null;
  const extracted = extractVsCodePalette(parsed, fallbackName);
  if (!extracted) {
    // 识别为主题 JSON 但无法抽取色板——可能通过 `include` 继承背景。
    // 报告继承限制而非静默失败。
    if (parsed.include) {
      return {
        themes: [],
        report: {
          source: 'vscode',
          resolvedRoles: 0,
          derivedRoles: [],
          unresolved: [`include:${parsed.include}`],
          skippedProtected: 0,
        },
      };
    }
    return null;
  }
  const built = buildThemeColorsFromPalette(
    extracted.palette,
    extracted.type,
    extracted.markdown,
  );
  const { colors, skipped } = stripProtectedTokens(built);
  return {
    themes: [{ name: extracted.name, type: extracted.type, colors }],
    report: {
      source: 'vscode',
      resolvedRoles: extracted.resolvedRoles,
      derivedRoles: extracted.derivedRoles,
      unresolved: extracted.unresolved,
      skippedProtected: skipped.length,
    },
  };
}

/** Obsidian theme.css → 转换结果(双态 CSS 会产出 light + dark 两个主题)。 */
export function convertObsidianTheme(
  css: string,
  name: string,
): ThemeConversionResult | null {
  const modes = collectObsidianVars(css);
  if (modes.length === 0) return null;

  const themes: ConvertedTheme[] = [];
  const derivedRoles: string[] = [];
  const unresolved: string[] = [];
  const skippedIds = new Set<string>();
  let resolvedRoles = 0;

  for (const mode of modes) {
    const extracted = extractObsidianPalette(mode);
    if (!extracted) {
      // Mode advertised by the stylesheet but background unresolvable — report it.
      unresolved.push(`mode:${mode.type}`);
      continue;
    }
    let built: Record<string, string>;
    try {
      built = buildThemeColorsFromPalette(
        extracted.palette,
        extracted.type,
        extracted.markdown,
      );
    } catch (error) {
      if (!(error instanceof UnsupportedThemePaletteError)) throw error;
      unresolved.push(`mode:${mode.type}`);
      continue;
    }
    const { colors, skipped } = stripProtectedTokens(built);
    themes.push({ name, type: extracted.type, colors });
    resolvedRoles = Math.max(resolvedRoles, extracted.resolvedRoles);
    for (const id of skipped) skippedIds.add(id);
    for (const role of extracted.derivedRoles) {
      if (!derivedRoles.includes(role)) derivedRoles.push(role);
    }
    for (const item of extracted.unresolved) {
      if (!unresolved.includes(item)) unresolved.push(item);
    }
  }

  if (themes.length === 0) return null;
  return {
    themes,
    report: {
      source: 'obsidian',
      resolvedRoles,
      derivedRoles,
      unresolved,
      skippedProtected: skippedIds.size,
    },
  };
}

/** 按扩展名判定源格式;`.css` → Obsidian,`.json`/`.jsonc` → VSCode。 */
export function detectImportSource(fileName: string): ThemeImportSource | null {
  const lower = fileName.toLowerCase();
  if (lower.endsWith('.css')) return 'obsidian';
  if (lower.endsWith('.json') || lower.endsWith('.jsonc')) return 'vscode';
  return null;
}