From 18c97cd44596057d46689c7ef4a73ce0bdb6de05 Mon Sep 17 00:00:00 2001 From: shen Date: Thu, 29 Oct 2026 20:00:31 +0800 Subject: [PATCH] refactor: clarify CSS cascade conversion and archive resource processing --- docs/architecture.md | 8 ++ mdhelper/editor_assets.py | 2 +- mdhelper/export_check.py | 1 - mdhelper/export_workflow.py | 1 - mdhelper/main_window.py | 8 +- mdhelper/mhtml_archive.py | 157 ++++++++++++++----------- mdhelper/style_sync.py | 227 +++++++++++++++++++++--------------- 7 files changed, 229 insertions(+), 175 deletions(-) diff --git a/docs/architecture.md b/docs/architecture.md index da79830..b4cc7d0 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -37,6 +37,14 @@ `FileWatchService` 管理监听路径、变更签名和合并刷新计时器,通过 `WatchContext` 请求界面刷新。它不访问标签控件。内部保存完成后更新监听签名;切换或关闭项目会清理待处理事件和计时器。编辑中的内容仍由窗口的文档会话规则保护,不被磁盘刷新覆盖。 +## CSS 与离线归档 + +CSS 同步按三个步骤处理:`_collect_cascade` 决定生效的声明,`_CoreRuleReader` 转换可表达的字体和段落属性,`analyze_css` 汇总结果。无法映射的 CSS 继续保留原文,不改写级联规则或 Word 的支持范围。 + +MHTML 的浏览器加载与归档转换分开。`mhtml_archive.py` 分别处理资源标识、CSS 依赖、HTML 引用和 MIME 编码;入口 `portable_archive` 只组织这些步骤,保留原有本地字体嵌入与缺失资源检查。 + ## 验证约定 每个重构阶段独立提交。运行单元测试,并按改动范围运行 `gui_smoke.py`、`improvements_smoke.py` 和 `reliability_smoke.py`。涉及浏览器生命周期的调整必须检查欢迎页、首次打开文件、标签切换以及预览滚动;涉及保存的调整必须检查保存失败、取消、另存为和后台标签。 + +`startup_smoke.py` 验证从启动到首次打开文件只有一次主窗口显示、没有隐藏或窗口句柄变化,阅读器保持固定父容器。设置 `MDHELPER_SMOKE_NATIVE=1` 可在真实 Windows 窗口后端执行。`pdf_export_smoke.py` 检查实际 PDF 输出。 diff --git a/mdhelper/editor_assets.py b/mdhelper/editor_assets.py index 5e791a6..133b533 100644 --- a/mdhelper/editor_assets.py +++ b/mdhelper/editor_assets.py @@ -46,7 +46,7 @@ def image_markdown(mime: object, document: Path) -> str | None: if files: return "\n".join(store_image(document, p.read_bytes(), p.suffix, p.stem) for p in files) if mime.hasImage(): - from PySide6.QtCore import QBuffer, QByteArray, QIODevice + from PySide6.QtCore import QBuffer, QIODevice from PySide6.QtGui import QImage, QPixmap data = mime.imageData() picture = data.toImage() if isinstance(data, QPixmap) else QImage(data) diff --git a/mdhelper/export_check.py b/mdhelper/export_check.py index b73c052..4f06b00 100644 --- a/mdhelper/export_check.py +++ b/mdhelper/export_check.py @@ -1,7 +1,6 @@ """Content-aware export checks; code examples are never scanned as links.""" from __future__ import annotations -import re from dataclasses import dataclass from pathlib import Path from urllib.parse import urlsplit diff --git a/mdhelper/export_workflow.py b/mdhelper/export_workflow.py index 2e3b498..42fd6fb 100644 --- a/mdhelper/export_workflow.py +++ b/mdhelper/export_workflow.py @@ -1,7 +1,6 @@ """Export UI: immutable editor snapshots, review, and cancellable jobs.""" from __future__ import annotations -import json from dataclasses import asdict, dataclass from pathlib import Path diff --git a/mdhelper/main_window.py b/mdhelper/main_window.py index 0a2bbee..6b2ad3a 100644 --- a/mdhelper/main_window.py +++ b/mdhelper/main_window.py @@ -10,7 +10,6 @@ import re import shutil from pathlib import Path from dataclasses import fields, asdict -from urllib.parse import unquote, urlsplit from PySide6.QtCore import QEventLoop, QFile, QPoint, QProcess, QSettings, QSignalBlocker, QSize, QThreadPool, QTimer, QUrl, Qt, Slot from PySide6.QtGui import ( @@ -38,10 +37,8 @@ from .code_structure import extract_code_headings from .document_tree import ( DEFAULT_DOCUMENT_FILE_GROUPS, DocumentEntry, - code_language_for_path, document_extensions_for_groups, is_code_document, - normalized_document_file_groups, ) from .history import HistoryItem, NavigationHistory from .markdown_utils import Heading, extract_headings, extract_headings_from_text @@ -49,7 +46,8 @@ from .markdown_editor import MarkdownEditorDialog as RichMarkdownEditorDialog from .markdown_renderer import MarkdownRenderer from .media import is_markdown_url, is_qt_video_player_url, is_webpage_url, media_kind, media_mime_type from .settings_dialog import AppPreferences, SettingsDialog -from .style_dialog import DocumentStyleEditorDialog, build_document_style_css +from .style_dialog import DocumentStyleEditorDialog +from .document_style import build_document_style_css from .style_sync import normalize_payload, render_css from .text_io import DEFAULT_TEXT_PREVIEW_BYTES, read_text_with_fallback from .startup_scan import StartupScan @@ -59,7 +57,7 @@ from .export_workflow import ExportController, ExportContext, ExportSnapshot from .render_options import RenderOptions, render_document from .preferences import ReaderPreferences, ApplicationConfiguration, ConfigurationStore, normalize_custom_styles from .document_session import DocumentStore, DraftStore, DocumentCloseController, CloseChoice -from .document_resources import analyze_document, resolve_local_reference +from .document_resources import analyze_document from .tab_controller import TabController, document_path from .reader_widgets import ReaderPage, ReaderBridge, ReaderView, ReaderTabHost, CompactTreeDelegate from .video_player import VideoPlayerWidget diff --git a/mdhelper/mhtml_archive.py b/mdhelper/mhtml_archive.py index 555d7ab..2bd9857 100644 --- a/mdhelper/mhtml_archive.py +++ b/mdhelper/mhtml_archive.py @@ -1,4 +1,4 @@ -"""Save a rendered, self-contained browser archive without a visible browser.""" +"""Pure MIME, HTML and CSS transformations for a portable browser archive.""" from __future__ import annotations import base64 @@ -10,21 +10,12 @@ from email.parser import BytesParser from html import escape, unescape from html.parser import HTMLParser from pathlib import Path -from urllib.parse import urljoin +from urllib.parse import urljoin, urlsplit +import tinycss2 from .document_resources import resolve_local_reference -from urllib.parse import urlsplit - -def portable_archive(data: bytes) -> bytes: - """Use archive IDs instead of file URLs, and embed CSS font dependencies. - - Chromium can block file: subresources even when present in an MHTML archive. - Native page saving also omits local fonts that were not painted on the page. - """ - import tinycss2 - message = BytesParser(policy=policy.default).parsebytes(data) - parts = [p for p in message.walk() if not p.is_multipart()] +def _assign_content_ids(parts) -> dict[str, str]: aliases = {} for part in parts: location = part.get("Content-Location", "") @@ -35,13 +26,19 @@ def portable_archive(data: bytes) -> bytes: else: part["Content-ID"] = f"<{identifier}>" aliases[location] = "cid:" + identifier + return aliases - def css_resource(url, base): + +class _ArchiveResources: + def __init__(self, aliases: dict[str, str]): + self.aliases = aliases + + def css_resource(self, url: str, base: str) -> str: if url.startswith(("#", "data:", "cid:")): return url absolute = urljoin(base, url) - if absolute in aliases: - return aliases[absolute] + if absolute in self.aliases: + return self.aliases[absolute] scheme = urlsplit(absolute).scheme if scheme == "file": path = resolve_local_reference(Path.cwd(), absolute) @@ -54,65 +51,85 @@ def portable_archive(data: bytes) -> bytes: raise ValueError("以下样式资源未能包含在离线归档中,请改用本地资源后重试:" + absolute) return absolute - def css_text(text, base): + def css_text(self, text: str, base: str) -> str: tokens = tinycss2.parse_stylesheet(text) - def visit(items): - for token in items: - if token.type == "url": - value = css_resource(token.value, base) - token.value = value - token.representation = 'url("' + value.replace('"', '%22') + '")' - elif token.type == "function" and token.lower_name == "url": - arguments = [item for item in token.arguments if item.type not in {"whitespace", "comment"}] - value = arguments[0].value if len(arguments) == 1 and arguments[0].type == "string" else tinycss2.serialize(token.arguments).strip() - token.arguments = tinycss2.parse_component_value_list('"' + css_resource(value, base).replace('"', '%22') + '"') - else: - if token.type == "at-rule" and token.lower_at_keyword == "import": - for value in token.prelude: - if value.type == "string": - value.value = css_resource(value.value, base) - value.representation = '"' + value.value + '"' - for name in ("content", "prelude", "arguments"): - if getattr(token, name, None): - visit(getattr(token, name)) - visit(tokens) + self._visit_css(tokens, base) return tinycss2.serialize(tokens) - class HtmlResources(HTMLParser): - def __init__(self, text): - super().__init__(convert_charrefs=False) - self.changes = [] - self.offsets = [0] + [m.end() for m in re.finditer("\n", text)] - self.feed(text) + def _visit_css(self, items, base): + for token in items: + if token.type == "url": + value = self.css_resource(token.value, base) + token.value = value + token.representation = 'url("' + value.replace('"', '%22') + '")' + elif token.type == "function" and token.lower_name == "url": + arguments = [item for item in token.arguments if item.type not in {"whitespace", "comment"}] + if len(arguments) == 1 and arguments[0].type == "string": + value = arguments[0].value + else: + value = tinycss2.serialize(token.arguments).strip() + quoted = '"' + self.css_resource(value, base).replace('"', '%22') + '"' + token.arguments = tinycss2.parse_component_value_list(quoted) + else: + if token.type == "at-rule" and token.lower_at_keyword == "import": + for value in token.prelude: + if value.type == "string": + value.value = self.css_resource(value.value, base) + value.representation = '"' + value.value + '"' + for name in ("content", "prelude", "arguments"): + if getattr(token, name, None): + self._visit_css(getattr(token, name), base) - def handle_starttag(self, tag, attrs): - raw = self.get_starttag_text() - line, column = self.getpos() - offset = self.offsets[line - 1] + column - for match in re.finditer(r'''\b(?:src|href|poster)\s*=\s*(["'])(.*?)\1''', raw, re.S): - value = unescape(match[2]) - if value in aliases: - self.changes.append((offset + match.start(2), offset + match.end(2), escape(aliases[value], quote=True))) +class _HtmlResources(HTMLParser): + def __init__(self, text, aliases): + super().__init__(convert_charrefs=False) + self.aliases = aliases + self.changes = [] + self.offsets = [0] + [m.end() for m in re.finditer("\n", text)] + self.feed(text) + + def handle_starttag(self, tag, attrs): + raw = self.get_starttag_text() + line, column = self.getpos() + offset = self.offsets[line - 1] + column + for match in re.finditer(r'''\b(?:src|href|poster)\s*=\s*(["'])(.*?)\1''', raw, re.S): + value = unescape(match[2]) + if value in self.aliases: + self.changes.append((offset + match.start(2), offset + match.end(2), escape(self.aliases[value], quote=True))) + + +def _rewrite_text_part(part, resources: _ArchiveResources) -> None: + kind = part.get_content_type() + if kind not in {"text/html", "text/css"}: + return + text = part.get_payload(decode=True).decode(part.get_content_charset() or "utf-8") + if kind == "text/css": + text = resources.css_text(text, part.get("Content-Location", "")) + else: + chunks, offset = [], 0 + for start, end, replacement in _HtmlResources(text, resources.aliases).changes: + chunks.extend((text[offset:start], replacement)) + offset = end + chunks.append(text[offset:]) + text = "".join(chunks) + if "Content-Transfer-Encoding" in part: + del part["Content-Transfer-Encoding"] + part.set_param("charset", "utf-8") + part.set_payload(text.encode("utf-8")) + encoders.encode_base64(part) + + +def portable_archive(data: bytes) -> bytes: + """Use archive IDs instead of file URLs and embed CSS font dependencies. + + Chromium can block file: subresources even when present in an MHTML archive. + Native page saving also omits local fonts that were not painted on the page. + """ + message = BytesParser(policy=policy.default).parsebytes(data) + parts = [part for part in message.walk() if not part.is_multipart()] + resources = _ArchiveResources(_assign_content_ids(parts)) for part in parts: - kind = part.get_content_type() - if kind not in {"text/html", "text/css"}: - continue - text = part.get_payload(decode=True).decode(part.get_content_charset() or "utf-8") - if kind == "text/css": - text = css_text(text, part.get("Content-Location", "")) - else: - chunks, offset = [], 0 - for start, end, replacement in HtmlResources(text).changes: - chunks.extend((text[offset:start], replacement)); offset = end - chunks.append(text[offset:]) - text = "".join(chunks) - if "Content-Transfer-Encoding" in part: - del part["Content-Transfer-Encoding"] - part.set_param("charset", "utf-8") - part.set_payload(text.encode("utf-8")) - encoders.encode_base64(part) + _rewrite_text_part(part, resources) # Chromium expects literal Content-Location values, not RFC 2047 folded URLs. return message.as_bytes(policy=policy.SMTP.clone(max_line_length=0, refold_source="none", utf8=True)) - - diff --git a/mdhelper/style_sync.py b/mdhelper/style_sync.py index 6b068f4..ab8ccdc 100644 --- a/mdhelper/style_sync.py +++ b/mdhelper/style_sync.py @@ -202,12 +202,8 @@ def _font_names(value): return names -def analyze_css(source: str, font_size_px: float = 16) -> Analysis: - result = Analysis() - balance = _balanced(source) - if balance: - result.errors.append(balance) - return result +def _collect_cascade(source: str, result: Analysis): + """Choose core declarations by importance, specificity and source order.""" winners = {target: {} for target in SELECTORS} for order, node in enumerate(css.parse_stylesheet(source, skip_comments=False, skip_whitespace=False)): if node.type == "error": @@ -254,100 +250,137 @@ def analyze_css(source: str, font_size_px: float = 16) -> Analysis: rank = (declaration.important, specificity, order, position) if prop not in winners[target] or rank >= winners[target][prop][0]: winners[target][prop] = (rank, _text(declaration.value)) - for target, entries in winners.items(): - props = {key: value[1] for key, value in entries.items()} - rule = {} - def read(prop, convert): - if prop not in props or props[prop].lower() in ("inherit", "unset", "revert"): - return - try: - convert(props[prop]) - except (ValueError, KeyError, TypeError): - result.notes.append(f"{LABELS[target]}的 {prop}: {props[prop]} 仅保留为 CSS") - def choice(prop, key, options): - read(prop, lambda value: rule.update({key: options[value.lower()]})) - def sized(value): - amount, unit = _length(value, ("pt", "px")) - if not 0 < amount <= 200: - raise ValueError - rule.update(font_size=amount, font_size_unit=unit) - read("font-size", sized) - def families(value): - if re.sub(r"\s+", "", value) == re.sub(r"\s+", "", FONT_EXPRESSION): - for key, variable in FONT_VARIABLES.items(): - if variable in props: - rule[key] = _font_names(props[variable])[0] - else: - names = _font_names(value) - rule.update(english_font_family=names[0], chinese_font_family=names[1] if len(names) > 1 and names[1] not in ("serif", "sans-serif", "monospace") else names[0]) - read("font-family", families) - choice("font-weight", "bold", {"bold": True, "700": True, "normal": False, "400": False}) - choice("font-style", "italic", {"italic": True, "normal": False}) - choice("text-align", "alignment", {name: name for name in ("left", "center", "right", "justify")}) - def color(value): - if value.lower() in ("currentcolor", "var(--reader-text-color, #23272f)"): - rule["font_color"] = "auto" - return - rgba = parse_color(value) - if rgba is None or isinstance(rgba, str) or rgba.alpha != 1: - raise ValueError - rule["font_color"] = "#" + "".join(f"{round(v * 255):02x}" for v in rgba[:3]) - read("color", color) - def tracking(value): - amount, unit = (0, "pt") if value == "normal" else _length(value, ("pt", "px"), negative=True) - amount *= .75 if unit == "px" else 1 - if abs(amount) > 100: - raise ValueError - rule["letter_spacing"] = amount - read("letter-spacing", tracking) - def line(value): - if value == "normal": - amount, mode = 1, "multiple" - elif re.fullmatch(r"(?:\d+(?:\.\d*)?|\.\d+)%?", value): - amount = float(value.rstrip("%")) / (100 if value.endswith("%") else 1) - mode = "multiple" - else: - amount, unit = _length(value, ("pt", "px")) - amount *= .75 if unit == "px" else 1 - mode = "at_least" if props.get("--mdhelper-line-spacing-mode") == "at-least" else "exact" - if not .1 <= amount <= 500: - raise ValueError - rule.update(line_height_value=amount, line_spacing_mode=mode) - read("line-height", line) - for side, prefix in (("left", "left_indent"), ("right", "right_indent"), ("top", "space_before"), ("bottom", "space_after")): - def margin(value, prefix=prefix): - amount, unit = _length(value, ("em", "pt", "px", "cm") if "indent" in prefix else ("em", "pt", "px", "lh", "cm")) - if unit == "px": - amount, unit = amount * .75, "pt" - if unit == "cm" and "indent" not in prefix: - amount, unit = amount * 72 / 2.54, "pt" - if amount > (200 if "indent" in prefix else 1000): - raise ValueError - rule.update({prefix + "_value": amount, prefix + "_unit": "line" if unit == "lh" else unit}) - read("margin-" + side, margin) - def indent(value): - amount, unit = _length(value, ("em", "pt", "px"), negative=True) - if unit != "em": - points = font_points({**resolved_rules({}, font_size_px=font_size_px)[target], **rule}) - amount = amount * (.75 if unit == "px" else 1) / points - if abs(amount) > 100: - raise ValueError - rule.update(indent_mode="none" if not amount else "first" if amount > 0 else "hanging", indent_value=abs(amount)) - read("text-indent", indent) - for field, modern, legacy, yes in (("keep_with_next", "break-after", "page-break-after", ("avoid", "avoid-page")), - ("keep_lines_together", "break-inside", "page-break-inside", ("avoid", "avoid-page")), - ("page_break_before", "break-before", "page-break-before", ("page", "always"))): - candidates = [name for name in (modern, legacy) if name in entries] + return winners + + +class _CoreRuleReader: + """Convert one target's winning CSS values to editable/Word style fields.""" + def __init__(self, target, entries, result, font_size_px): + self.target, self.entries, self.result = target, entries, result + self.font_size_px = font_size_px + self.props = {key: value[1] for key, value in entries.items()} + self.rule = {} + + def parse(self): + self.read('font-size', self.sized) + self.read('font-family', self.families) + self.choice('font-weight', 'bold', {'bold': True, '700': True, 'normal': False, '400': False}) + self.choice('font-style', 'italic', {'italic': True, 'normal': False}) + self.choice('text-align', 'alignment', {name: name for name in ('left', 'center', 'right', 'justify')}) + self.read('color', self.color) + self.read('letter-spacing', self.tracking) + self.read('line-height', self.line) + for side, prefix in (('left', 'left_indent'), ('right', 'right_indent'), ('top', 'space_before'), ('bottom', 'space_after')): + self.read('margin-' + side, lambda value, prefix=prefix: self.margin(value, prefix)) + self.read('text-indent', self.indent) + self.pagination() + self.choice('--mdhelper-contextual-spacing', 'contextual_spacing', {'true': True, 'false': False}) + return self.rule + + def pagination(self): + breaks = ( + ('keep_with_next', 'break-after', 'page-break-after', ('avoid', 'avoid-page')), + ('keep_lines_together', 'break-inside', 'page-break-inside', ('avoid', 'avoid-page')), + ('page_break_before', 'break-before', 'page-break-before', ('page', 'always')), + ) + for field, modern, legacy, yes in breaks: + candidates = [name for name in (modern, legacy) if name in self.entries] if candidates: - prop = max(candidates, key=lambda name: entries[name][0]) - choice(prop, field, {**{v: True for v in yes}, "auto": False}) - widow_values = [props[p] for p in ("widows", "orphans") if p in props] + prop = max(candidates, key=lambda name: self.entries[name][0]) + self.choice(prop, field, {**{v: True for v in yes}, 'auto': False}) + widow_values = [self.props[p] for p in ('widows', 'orphans') if p in self.props] if widow_values: - if all(v == "1" for v in widow_values) or all(v == "2" for v in widow_values): - rule["widow_control"] = widow_values[0] == "2" + if all((v == '1' for v in widow_values)) or all((v == '2' for v in widow_values)): + self.rule['widow_control'] = widow_values[0] == '2' else: - result.notes.append(f"{LABELS[target]}的 widows/orphans 仅保留为 CSS") - choice("--mdhelper-contextual-spacing", "contextual_spacing", {"true": True, "false": False}) + self.result.notes.append(f'{LABELS[self.target]}的 widows/orphans 仅保留为 CSS') + + def read(self, prop, convert): + if prop not in self.props or self.props[prop].lower() in ('inherit', 'unset', 'revert'): + return + try: + convert(self.props[prop]) + except (ValueError, KeyError, TypeError): + self.result.notes.append(f'{LABELS[self.target]}的 {prop}: {self.props[prop]} 仅保留为 CSS') + + def choice(self, prop, key, options): + self.read(prop, lambda value: self.rule.update({key: options[value.lower()]})) + + def sized(self, value): + amount, unit = _length(value, ('pt', 'px')) + if not 0 < amount <= 200: + raise ValueError + self.rule.update(font_size=amount, font_size_unit=unit) + + def families(self, value): + if re.sub('\\s+', '', value) == re.sub('\\s+', '', FONT_EXPRESSION): + for key, variable in FONT_VARIABLES.items(): + if variable in self.props: + self.rule[key] = _font_names(self.props[variable])[0] + else: + names = _font_names(value) + chinese = names[1] if len(names) > 1 and names[1] not in ('serif', 'sans-serif', 'monospace') else names[0] + self.rule.update(english_font_family=names[0], chinese_font_family=chinese) + + def color(self, value): + if value.lower() in ('currentcolor', 'var(--reader-text-color, #23272f)'): + self.rule['font_color'] = 'auto' + return + rgba = parse_color(value) + if rgba is None or isinstance(rgba, str) or rgba.alpha != 1: + raise ValueError + self.rule['font_color'] = '#' + ''.join((f'{round(v * 255):02x}' for v in rgba[:3])) + + def tracking(self, value): + amount, unit = (0, 'pt') if value == 'normal' else _length(value, ('pt', 'px'), negative=True) + amount *= 0.75 if unit == 'px' else 1 + if abs(amount) > 100: + raise ValueError + self.rule['letter_spacing'] = amount + + def line(self, value): + if value == 'normal': + amount, mode = (1, 'multiple') + elif re.fullmatch('(?:\\d+(?:\\.\\d*)?|\\.\\d+)%?', value): + amount = float(value.rstrip('%')) / (100 if value.endswith('%') else 1) + mode = 'multiple' + else: + amount, unit = _length(value, ('pt', 'px')) + amount *= 0.75 if unit == 'px' else 1 + mode = 'at_least' if self.props.get('--mdhelper-line-spacing-mode') == 'at-least' else 'exact' + if not 0.1 <= amount <= 500: + raise ValueError + self.rule.update(line_height_value=amount, line_spacing_mode=mode) + + def indent(self, value): + amount, unit = _length(value, ('em', 'pt', 'px'), negative=True) + if unit != 'em': + points = font_points({**resolved_rules({}, font_size_px=self.font_size_px)[self.target], **self.rule}) + amount = amount * (0.75 if unit == 'px' else 1) / points + if abs(amount) > 100: + raise ValueError + self.rule.update(indent_mode='none' if not amount else 'first' if amount > 0 else 'hanging', indent_value=abs(amount)) + + def margin(self, value, prefix): + amount, unit = _length(value, ('em', 'pt', 'px', 'cm') if 'indent' in prefix else ('em', 'pt', 'px', 'lh', 'cm')) + if unit == 'px': + amount, unit = (amount * 0.75, 'pt') + if unit == 'cm' and 'indent' not in prefix: + amount, unit = (amount * 72 / 2.54, 'pt') + if amount > (200 if 'indent' in prefix else 1000): + raise ValueError + self.rule.update({prefix + '_value': amount, prefix + '_unit': 'line' if unit == 'lh' else unit}) + + +def analyze_css(source: str, font_size_px: float = 16) -> Analysis: + result = Analysis() + balance = _balanced(source) + if balance: + result.errors.append(balance) + return result + winners = _collect_cascade(source, result) + for target, entries in winners.items(): + rule = _CoreRuleReader(target, entries, result, font_size_px).parse() if rule: result.rules[target] = rule result.notes = list(dict.fromkeys(result.notes))