Files
phelex 0d171915d7 Add Site Studio themes and Theme Manager
Support categorized fragments, theme presets, block widths, and server-backed theme editing with onboarding and preview.

Include Site Studio, design sources, specification and verification reports; remove the legacy studio-site example.
2026-11-13 14:04:49 +03:00

113 lines
5.4 KiB
Python

#!/usr/bin/env python3
"""Validate sample site file graph and generated preview; not a production schema validator."""
from pathlib import Path
from html.parser import HTMLParser
import re
import yaml
ROOT=Path(__file__).resolve().parents[1]
load=lambda p:yaml.safe_load(p.read_text(encoding='utf-8'))
def front(p):
raw=p.read_text(encoding='utf8')
if not raw.startswith('---\n'):raise ValueError('No YAML front matter '+str(p))
return yaml.safe_load(raw[4:].split('\n---\n',1)[0])
errors=[];warnings=[]
def err(message):errors.append(message)
def validate_yaml():
yaml_files=list(ROOT.rglob('*.yaml'))
for p in yaml_files:
try: load(p)
except Exception as ex:err(f'Invalid YAML {p.relative_to(ROOT)}: {ex}')
print('YAML files:',len(yaml_files))
return yaml_files
frags={};layout_ids=set()
for p in ROOT.glob('fragments/*/*/fragment.yaml'):
f=load(p)
frags[f['id']]=p
if not (p.parent/'template.html.j2').is_file():err('Fragment template missing: '+str(p))
for p in ROOT.glob('layouts/*/layout.yaml'):
obj=load(p);layout_ids.add(obj['id'])
if not (p.parent/'layout.html.j2').is_file():err('Layout template missing: '+str(p))
routes={}
for p in ROOT.glob('pages/**/*.md'):
f=front(p)
if f.get('route') in routes:err('Duplicate route '+f['route'])
routes[f['route']]=p
if f.get('layout') not in layout_ids:err('Unknown layout '+str(f['layout']))
allowed=next((set(r['allow']) for r in load(ROOT/'layouts'/f['layout']/'layout.yaml')['regions'] if r['id']=='main'),set())
ids=set()
for b in f.get('regions',{}).get('main',[]):
if b['id'] in ids:err(f'Duplicate block ID {b["id"]} in {p}')
ids.add(b['id'])
if b['fragment'] not in frags:err(f'Unknown Fragment {b["fragment"]} in {p}')
if b['fragment'] not in allowed:err(f'Disallowed Fragment {b["fragment"]} in {p}')
props=b.get('props',{})
for k in ('buttonUrl',):
if props.get(k) and props[k] not in routes:pass # check after all files collected
if b['fragment']=='form' and not (ROOT/'forms'/f"{props['form_id']}.yaml").is_file():err('Missing form '+props['form_id'])
if p.name=='index.md' and len(f.get('regions',{}).get('main',[]))==0:err('Empty index')
entries={}
for p in ROOT.glob('content/*/*.md'):
f=front(p)
key=p.parent.name+'/'+f['slug']
if key in entries:err('Duplicate Entry '+key)
entries[key]=f
if not (ROOT/'collections'/f'{p.parent.name}.yaml').is_file():err('Missing collection '+p.parent.name)
if not (ROOT/'display'/f'{p.parent.name}.yaml').is_file():err('Missing display '+p.parent.name)
if not f.get('title'):err('Missing Entry.title '+key)
for fk in ('hero_asset',):
asset=f.get(fk)
if asset and not (ROOT/asset).is_file():
if f['status']=='draft':warnings.append(f'Expected draft warning: {key} -> {asset}')
else:err('Missing published asset '+asset)
for fk,target in [('related_scenarios','scenarios'),('related_services','services')]:
for slug in f.get(fk,[]):
if not (ROOT/f'content/{target}/{slug}.md').is_file():err(f'Missing Entry reference {key} -> {target}/{slug}')
for p in ROOT.glob('pages/**/*.md'):
f=front(p)
for b in f.get('regions',{}).get('main',[]):
props=b.get('props',{})
for key in ('buttonUrl',):
link=props.get(key)
if link and link not in routes:err(f'Broken link {link} from {p}')
for key in ('asset','background'):
asset=props.get(key)
if asset and not (ROOT/asset).is_file():err(f'Missing page asset {asset} in {p}')
if b['fragment']=='collection_list' and not (ROOT/'collections'/f"{props.get('collection')}.yaml").is_file():err(f'Missing query collection {props.get("collection")}')
if b['fragment']=='entry_card' and props.get('entry') not in entries:err('Missing entry_card ref '+str(props.get('entry')))
for p in ROOT.glob('menus/*.yaml'):
for item in load(p)['items']:
if item.get('enabled',True) and item.get('page') not in routes:err(f'Menu target not found: {item.get("page")} in {p}')
for asset in load(ROOT/'assets/manifest.yaml')['files']:
if not (ROOT/asset['path']).is_file():err('Asset manifest path missing: '+asset['path'])
class Links(HTMLParser):
def __init__(self):super().__init__();self.refs=[]
def handle_starttag(self,tag,attrs):
d=dict(attrs)
if tag in ('a','link','script','img'):
val=d.get('href') or d.get('src')
if val:self.refs.append(val)
html_docs=list((ROOT/'preview-dist').rglob('*.html'))
for p in html_docs:
links=Links();links.feed(p.read_text(encoding='utf8'))
for ref in links.refs:
if ref.startswith(('#','http:','https:','mailto:','tel:','data:')):continue
r=(p.parent/ref.split('#',1)[0]).resolve()
if not r.is_relative_to((ROOT/'preview-dist').resolve()):err(f'Preview link outside root {p}: {ref}')
elif not r.is_file():err(f'Broken preview href/src {p.relative_to(ROOT)} -> {ref}')
if len(html_docs)<12:err(f'Expected 12+ rendered pages, got {len(html_docs)}')
print('Pages:',len(routes),'Entries:',len(entries),'Fragments:',len(frags),'Layouts:',len(layout_ids),'Static HTML:',len(html_docs))
print('Warnings:',*warnings,sep='\n ')
if errors:
print('ERRORS:',*errors,sep='\n - ')
raise SystemExit(1)
print('PASS: YAML, file paths, entry refs, block IDs, layouts, menus, HTML links')