cms-SiteForge/tests/test_theme_registry.py

"""Theme discovery must be a single source of truth."""
import json
from pathlib import Path
from app import core, theme_pro, theme_store
from test_factory_v2 import factory, site  # noqa: F401 -- fixture + helper reused by trade-pro tests

ROOT = Path(core.__file__).resolve().parent.parent

def test_discover_returns_builtin_themes_with_manifests():
    ids = core.discover_themes()
    for tid in ('automotive', 'industrial', 'corporate', 'minimal'):
        assert tid in ids
    for tid in ids:
        manifest = json.loads((ROOT / 'themes' / tid / 'manifest.json').read_text(encoding='utf-8'))
        assert manifest.get('id') == tid

def test_three_whitelists_agree():
    # Tripwire: the three names must stay the same object. Fails only if someone
    # reintroduces a hardcoded copy of the list anywhere.
    assert set(core.THEMES) == set(theme_pro.THEMES) == set(theme_store.BUILTIN)
    assert isinstance(core.THEMES, tuple)

def test_discover_skips_broken_theme_dirs(tmp_path, monkeypatch):
    themes = tmp_path / 'themes'
    good = themes / 'good-one'; good.mkdir(parents=True)
    (good / 'manifest.json').write_text(json.dumps({'id': 'good-one'}), encoding='utf-8')
    broken = themes / 'broken'; broken.mkdir()
    (broken / 'manifest.json').write_text('{not json', encoding='utf-8')
    mismatch = themes / 'mismatch'; mismatch.mkdir()
    (mismatch / 'manifest.json').write_text(json.dumps({'id': 'other-name'}), encoding='utf-8')
    no_manifest = themes / 'no-manifest'; no_manifest.mkdir()
    underscore = themes / '_shared'; underscore.mkdir()
    monkeypatch.setattr(core, 'ROOT', tmp_path)
    assert core.discover_themes() == ('good-one',)

def test_discover_fails_fast_when_themes_dir_missing(tmp_path, monkeypatch):
    monkeypatch.setattr(core, 'ROOT', tmp_path)
    import pytest
    with pytest.raises(RuntimeError, match='themes directory missing'):
        core.discover_themes()

def test_env_for_theme_prefers_theme_dir_then_shared_root():
    from app import theme_pro
    env = theme_pro.env_for('industrial')
    paths = [str(p).replace('\\', '/') for p in env.loader.searchpath]
    assert paths[0].endswith('themes/industrial')
    assert paths[1].endswith('themes')
    # 共享宏库必须仍可解析（回落路径）
    assert env.get_template('_professional_components.html') is not None

def test_env_for_is_cached_per_theme():
    from app import theme_pro
    assert theme_pro.env_for('industrial') is theme_pro.env_for('industrial')

def test_env_for_pro_template_loads_unprefixed():
    from app import theme_pro
    assert theme_pro.env_for('industrial').get_template('pro.html') is not None

def test_env_for_rejects_unknown_theme():
    import pytest
    from app import theme_pro
    with pytest.raises(ValueError):
        theme_pro.env_for('../../etc')
    with pytest.raises(ValueError):
        theme_pro.env_for('no-such-theme')

def test_env_for_theme_macro_shadows_shared_root(tmp_path, monkeypatch):
    # The core mechanism: a theme-local _professional_components.html wins over
    # the shared one at themes/ root.
    from app import theme_pro
    themes = tmp_path / 'themes'
    for sub, marker in (('industrial', 'theme-local'), ('_root_macros', None)):
        d = themes / sub
        d.mkdir(parents=True)
    (themes / '_professional_components.html').write_text('SHARED', encoding='utf-8')
    (themes / 'industrial' / '_professional_components.html').write_text('THEME-LOCAL', encoding='utf-8')
    monkeypatch.setattr(theme_pro, 'ROOT', tmp_path)
    monkeypatch.setattr(theme_pro, '_ENVS', {})
    tpl = theme_pro.env_for('industrial').get_template('_professional_components.html')
    assert tpl.render().strip() == 'THEME-LOCAL'

def test_env_for_degraded_branch_not_cached_and_single_path(tmp_path, monkeypatch):
    from app import theme_pro
    themes = tmp_path / 'themes'
    themes.mkdir(parents=True)
    monkeypatch.setattr(theme_pro, 'ROOT', tmp_path)
    monkeypatch.setattr(theme_pro, '_ENVS', {})
    core.THEMES = ('industrial',)  # whitelist a theme whose dir does not exist
    try:
        env = theme_pro.env_for('industrial')
        assert [str(p) for p in env.loader.searchpath] == [str(themes)]
        assert 'industrial' not in theme_pro._ENVS
    finally:
        core.THEMES = core.discover_themes()

def test_trade_pro_registered_and_compatible():
    assert 'trade-pro' in core.THEMES
    result = theme_store.compatibility('trade-pro')
    assert result['valid'], result['errors']
    assert not result['errors']

def test_trade_pro_builds_real_site(factory):
    sid = site(factory)
    assert factory.post(f'/api/factory/sites/{sid}/bootstrap').status_code == 200
    selected = factory.put(f'/api/factory/sites/{sid}/theme', json={'theme': 'trade-pro', 'version': '1.0.0'})
    assert selected.status_code == 200, selected.text
    result = factory.post(f'/api/sites/{sid}/builds', json={})
    assert result.status_code == 200, result.text
    bid = result.json()['version']
    home = factory.get(f'/preview/{sid}/{bid}/')
    assert home.status_code == 200, home.text[:400]
    assert 'lang="en"' in home.text
    assert '>Products<' in home.text  # English fallback nav actually rendered
    assert '>首页<' not in home.text
    assert '<meta name="theme-color" content="#0b3d91"' in home.text

def test_trade_pro_theme_css_ports_token_system():
    from pathlib import Path
    css = (Path(__file__).resolve().parent.parent / 'themes' / 'trade-pro' / 'theme.css').read_text(encoding='utf-8')
    # 令牌覆盖：cms tokens.css 的核心令牌语义都应有对应 --sf-tp-* 变量
    for token in ('primary', 'accent', 'bg', 'text', 'muted', 'radius', 'font'):
        assert f'--sf-tp-{token}' in css, token
    # 移植覆盖：cms 语义令牌以 --sf-tp- 前缀保留语义名（tokens.css 各组取样）
    for token in ('color-brand-primary', 'color-brand-secondary', 'color-neutral-900', 'color-text-primary',
                  'color-surface-page', 'color-border-default', 'font-family-sans', 'font-size-display',
                  'font-weight-bold', 'line-height-normal', 'space-4', 'space-section-y', 'container-page-max',
                  'breakpoint-tablet', 'radius-full', 'shadow-md', 'button-height-md', 'input-border-radius',
                  'card-padding-md', 'duration-fast', 'easing-standard', 'z-modal', 'focus-outline-color', 'icon-size-md'):
        assert f'--sf-tp-{token}' in css, token
    # 基础样式：base.css 元素基线、按钮体系与响应式断点已移植
    for fragment in ('box-sizing', '.sf-tp-btn--lg', '.sf-tp-btn--ghost', '@media (max-width: 620px)',
                     'prefers-reduced-motion'):
        assert fragment in css, fragment
    # 样式隔离红线：不得出现平台按钮选择器
    import re
    for sel in ('.btn{', '.primary{', '.request{', '.button{', '.nav-btn{'):
        assert sel not in css, sel

def test_trade_pro_build_contains_tokens(factory):
    # 构建产物 assets/theme.css 含 --sf-tp- 变量（复用 test_trade_pro_builds_real_site 的构建流程）
    sid = site(factory)
    assert factory.post(f'/api/factory/sites/{sid}/bootstrap').status_code == 200
    selected = factory.put(f'/api/factory/sites/{sid}/theme', json={'theme': 'trade-pro', 'version': '1.0.0'})
    assert selected.status_code == 200, selected.text
    result = factory.post(f'/api/sites/{sid}/builds', json={})
    assert result.status_code == 200, result.text
    bid = result.json()['version']
    home = factory.get(f'/preview/{sid}/{bid}/')
    assert home.status_code == 200, home.text[:400]
    assert 'assets/theme.css' in home.text  # 首页 HTML 确实链接主题样式表
    css = factory.get(f'/preview/{sid}/{bid}/assets/theme.css')
    assert css.status_code == 200, css.text[:200]
    assert '--sf-tp-primary' in css.text  # Phase 2 短令牌别名随构建分发
    assert '--sf-tp-color-brand-primary' in css.text  # cms 令牌全集随构建分发

def test_frontend_entries_include_trade_pro():
    from pathlib import Path
    base = Path(__file__).resolve().parent.parent
    for rel, needle in [
        ('app/templates/admin.html', 'value="trade-pro"'),
        ('app/templates/workspace.html', 'value="trade-pro"'),
        ('app/templates/theme-gallery.html', 'value="trade-pro"'),
        ('app/static/workspace.js', "'trade-pro'"),
        ('app/static/admin.js', "'trade-pro'"),
        ('app/static/factory-v2.js', "'trade-pro'"),
    ]:
        assert needle in (base / rel).read_text(encoding='utf-8'), rel

def test_theme_color_map_covers_trade_pro():
    # theme_pro 渲染上下文经映射表输出 trade-pro 的 theme-color（pro.html 已改回变量）
    from app import theme_pro
    src = (Path(theme_pro.__file__).resolve().parent.parent / 'themes' / 'trade-pro' / 'pro.html').read_text(encoding='utf-8')
    assert '{{theme_color}}' in src  # 不再写死
    # 运行时断言：轻量直渲（不经 fixture 构建），映射表 + 变量路径输出 #0b3d91。
    # 全量构建路径由 test_trade_pro_builds_real_site 的既有 meta 断言持续覆盖。
    html = theme_pro.render('trade-pro', {'theme': 'trade-pro', 'name': 'Go Global'},
                            {'title': 'Home', 'route': '/'}, [], mode='home')
    assert '<meta name="theme-color" content="#0b3d91"' in html

def test_theme_blocks_css_overrides_platform(tmp_path):
    from app import builder
    dist = tmp_path / 'assets'; dist.mkdir()
    theme_dir = tmp_path / 'theme'; theme_dir.mkdir()
    (theme_dir / 'blocks.css').write_text('/* theme version */', encoding='utf-8')
    builder.copy_blocks_css(theme_dir, dist)
    assert (dist / 'blocks.css').read_text(encoding='utf-8') == '/* theme version */'
    # 无主题版时回落平台版（精确断言内容一致）
    dist2 = tmp_path / 'assets2'; dist2.mkdir()
    builder.copy_blocks_css(tmp_path / 'nonexistent', dist2)
    platform = (builder.ROOT / 'app' / 'static' / 'blocks.css').read_text(encoding='utf-8')
    assert (dist2 / 'blocks.css').read_text(encoding='utf-8') == platform