@lark-apaas/coding-steering 0.1.18-dev.ac6c20c → 0.1.18-dev.c17a349

package/steering/design-html/skills/pptx-style-extract/scripts/test_layout_css.py

@@ -0,0 +1,127 @@
+#!/usr/bin/env python3
+"""Regression tests for the consumer-facing layout slot CSS contract."""
+import os
+import sys
+import tempfile
+import unittest
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from check_v2 import Pack, rule_v2_16  # noqa: E402
+from draft import emit_layouts, slot_style  # noqa: E402
+from package import FONTSIZE_RE, build_layouts_md, split_top_blocks  # noqa: E402
+
+
+class LayoutCssTest(unittest.TestCase):
+    def test_text_slot_emits_rendering_style_as_css_only(self):
+        shape = {
+            'text': {
+                'bodyPr': {
+                    'anchor': 'ctr',
+                    'insets_px': {'lIns': 12, 'tIns': 8, 'rIns': 10, 'bIns': 6},
+                    'rot': '900000',
+                },
+                'lstStyle': {
+                    'lvl1pPr': {
+                        'sz_px': 48,
+                        'weight': 600,
+                        'italic': True,
+                        'underline': 'sng',
+                        'strike': 'sngStrike',
+                        'spc_px': 1.5,
+                        'color': {'resolved': '#123456'},
+                        'algn': 'ctr',
+                        'lnSpc': {'mult': 1.0},
+                    },
+                },
+                'paragraphs': [],
+            },
+        }
+        slot = {
+            'role': 'title',
+            'type': 'title',
+            'box': [100, 80, 800, 160],
+            'sz': 48,
+            'txt': '标题',
+        }
+        slot.update(slot_style(shape))
+        archetype = {
+            'name': 'layout-1',
+            'zh': '标题页',
+            'role': 'content',
+            'bg': None,
+            'slots': [slot],
+            'decor': [],
+            'pages': [1],
+            'rep': 1,
+            'pic_n': 0,
+            'confidence': 'high',
+        }
+
+        with tempfile.TemporaryDirectory() as output_dir:
+            emit_layouts([archetype], output_dir)
+            with open(os.path.join(output_dir, 'layouts.yaml'), encoding='utf-8') as stream:
+                layouts_yaml = stream.read()
+            layouts_md = build_layouts_md(split_top_blocks(layouts_yaml), (1920, 1080))
+
+        self.assertIn(
+            'css: "box-sizing: border-box; padding: 8px 10px 6px 12px; '
+            'font-size: 48px; font-weight: 600; font-style: italic; '
+            'text-decoration: underline line-through; letter-spacing: 1.5px; color: #123456; '
+            'text-align: center; line-height: 1.2; display: flex; '
+            'flex-direction: column; justify-content: center; rotate: 15deg"',
+            layouts_md,
+        )
+        for legacy_key in ('size', 'weight', 'color', 'align', 'valign', 'insets_px'):
+            self.assertNotRegex(layouts_md, rf'[,{{]\s*{legacy_key}:')
+        self.assertEqual(FONTSIZE_RE.findall(layouts_md), ['48'])
+
+    def test_layout_gate_rejects_legacy_slot_style_keys(self):
+        with tempfile.TemporaryDirectory() as pack_dir:
+            with open(os.path.join(pack_dir, 'design.md'), 'w', encoding='utf-8') as stream:
+                stream.write('---\nversion: alpha\nlayouts: layouts.md\n---\n\nRead layouts.md.\n')
+            with open(os.path.join(pack_dir, 'layouts.md'), 'w', encoding='utf-8') as stream:
+                stream.write(
+                    '---\ncanvas: 1920x1080\nlayouts:\n  cover:\n    role: cover\n'
+                    '    slots:\n      - {role: title, type: title, box: [0, 0, 800, 100], '
+                    'size: 48, align: center}\n    confidence: high\n---\n'
+                )
+
+            result = rule_v2_16(Pack(pack_dir))
+
+        self.assertEqual(result.level, 'FAIL')
+        self.assertEqual(len(result.fails), 1)
+        self.assertIn('旧样式键 align/size', result.fails[0])
+
+    def test_normautofit_fontscale_shrinks_emitted_font_size(self):
+        # 章节大号数字：160px 字号靠 normAutofit fontScale 0.9 装进 144px 的框。
+        # 不乘 fontScale，消费端拿到 160px，字比框高，渐变裁切把底部切成透明。
+        shape = {
+            'text': {
+                'bodyPr': {'anchor': 't', 'font_scale': 0.9, 'ln_spc_reduction': 0.1},
+                'lstStyle': {'lvl1pPr': {'sz_px': 160, 'lnSpc': {'mult': 1.0}}},
+                'paragraphs': [{'runs': [{'text': '01.'}]}],
+            },
+        }
+        style = slot_style(shape)
+        self.assertIn('font-size: 144px', style['css'])
+        self.assertNotIn('font-size: 160px', style['css'])
+        # lnSpcReduction 0.1 把 1.0*1.2 的行高压到 1.08
+        self.assertIn('line-height: 1.08', style['css'])
+
+    def test_missing_autofit_leaves_font_size_untouched(self):
+        # 无 normAutofit（或无 fontScale）时零影响：字号原样、行高不缩。
+        shape = {
+            'text': {
+                'bodyPr': {'anchor': 't'},
+                'lstStyle': {'lvl1pPr': {'sz_px': 160, 'lnSpc': {'mult': 1.0}}},
+                'paragraphs': [{'runs': [{'text': '01.'}]}],
+            },
+        }
+        style = slot_style(shape)
+        self.assertIn('font-size: 160px', style['css'])
+        self.assertIn('line-height: 1.2', style['css'])
+
+
+if __name__ == '__main__':
+    unittest.main()

package/steering/design-html/skills/pptx-style-extract/scripts/test_rounded_contract.py

@@ -0,0 +1,112 @@
+#!/usr/bin/env python3
+"""Regression tests for preserving per-container radii."""
+import os
+import tempfile
+import unittest
+
+from draft import emit_body, emit_frontmatter
+from query import _recipe_css
+
+
+def render_frontmatter(radii):
+    data = {
+        'radii_census': radii,
+        'spacing_candidates': {},
+    }
+    tokens = [('surface', {'hex': '#FFFFFF'})]
+
+    with tempfile.TemporaryDirectory() as output_dir:
+        emit_frontmatter(
+            data,
+            tokens,
+            [],
+            {},
+            [],
+            [],
+            output_dir,
+        )
+        with open(os.path.join(output_dir, 'frontmatter.yaml'), encoding='utf-8') as stream:
+            return stream.read()
+
+
+def render_body():
+    data = {
+        'canvas': {'px': [1920, 1080]},
+        'form_hint': {'form': 2},
+        'counts': {'slides': 1},
+    }
+
+    with tempfile.TemporaryDirectory() as output_dir:
+        emit_body(
+            data,
+            [],
+            [],
+            {},
+            [],
+            [],
+            [],
+            {},
+            output_dir,
+        )
+        with open(os.path.join(output_dir, 'body.md'), encoding='utf-8') as stream:
+            return stream.read()
+
+
+class RoundedContractTest(unittest.TestCase):
+    def test_multiple_radius_tiers_are_not_collapsed_into_one_card_token(self):
+        frontmatter = render_frontmatter(
+            [
+                {'px': 6.9, 'n': 2},
+                {'px': 11.9, 'n': 2},
+                {'px': 14.4, 'n': 3},
+            ]
+        )
+
+        self.assertNotIn('rounded:', frontmatter)
+
+    def test_single_radius_tier_can_remain_a_global_token(self):
+        frontmatter = render_frontmatter([{'px': 12, 'n': 9}])
+
+        self.assertIn('rounded:\n  card: 12px', frontmatter)
+
+    def test_rare_rounded_exceptions_do_not_override_a_zero_radius_majority(self):
+        frontmatter = render_frontmatter(
+            [
+                {'px': 0, 'n': 241},
+                {'px': 3.4, 'n': 4},
+                {'px': 6.9, 'n': 3},
+                {'px': 50.5, 'n': 1},
+            ]
+        )
+
+        self.assertNotIn('rounded:', frontmatter)
+
+    def test_generated_usage_defaults_unspecified_container_radius_to_zero(self):
+        body = render_body()
+
+        self.assertIn('没有 `border-radius` 就按 `0`', body)
+        self.assertIn('不得自行补圆角', body)
+
+    def test_recipe_does_not_promote_one_rounded_exception_to_the_whole_group(self):
+        css = _recipe_css(
+            {'type': 'solid', 'color': {'hex': '#FFFFFF'}},
+            None,
+            [0] * 70 + [50.5],
+            None,
+        )
+
+        self.assertFalse(any('border-radius' in declaration for declaration in css))
+
+    def test_recipe_keeps_a_radius_shared_by_the_whole_group(self):
+        css = _recipe_css(
+            {'type': 'solid', 'color': {'hex': '#FFFFFF'}},
+            None,
+            [6.9] * 17,
+            None,
+        )
+
+        self.assertIn('border-radius: 6.9px', css)
+
+
+if __name__ == '__main__':
+    unittest.main()

package/steering/design-html/skills/pptx-style-extract/scripts/test_text_role_contract.py

@@ -0,0 +1,168 @@
+#!/usr/bin/env python3
+"""Regression tests for inherited layout text and model-decided text roles."""
+import json
+import os
+import sys
+import tempfile
+import unittest
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from draft import draft_layouts, emit_layouts, inherited_text_shapes
+from package import build_layouts_md, split_top_blocks
+
+
+def text_shape(part, layer, shape_id, box, text, placeholder):
+    return {
+        'part': part,
+        'layer': layer,
+        'id': shape_id,
+        'kind': 'sp',
+        'name': 'Text Placeholder',
+        'ph': placeholder,
+        'box': box,
+        'text': {
+            'bodyPr': {},
+            'lstStyle': {
+                'lvl1pPr': {
+                    'sz_px': 48,
+                    'weight': 600,
+                    'color': {'resolved': '#C41230'},
+                },
+            },
+            'paragraphs': [
+                {
+                    'runs': [{'text': text}],
+                },
+            ] if text else [],
+        },
+    }
+
+
+class TextRoleContractTest(unittest.TestCase):
+    def test_empty_non_placeholder_layout_shape_is_not_a_text_slot(self):
+        layout_part = 'ppt/slideLayouts/slideLayout2.xml'
+        decorative_shape = text_shape(
+            layout_part,
+            'layout',
+            '9',
+            {'x': 0, 'y': 0, 'w': 1920, 'h': 24},
+            '',
+            None,
+        )
+        decorative_shape['name'] = 'Decorative bar'
+
+        self.assertEqual(inherited_text_shapes([decorative_shape], []), [])
+
+    def test_empty_slide_inherits_text_slot_and_css_from_its_layout(self):
+        layout_part = 'ppt/slideLayouts/slideLayout2.xml'
+        slide_part = 'ppt/slides/slide1.xml'
+        shapes = [
+            text_shape(
+                layout_part,
+                'layout',
+                '10',
+                {'x': 120, 'y': 80, 'w': 840, 'h': 120},
+                'Example heading',
+                {'type': 'body', 'idx': '10'},
+            ),
+            text_shape(
+                slide_part,
+                'slide',
+                '2',
+                None,
+                '',
+                {'type': 'body', 'idx': '10'},
+            ),
+        ]
+        data = {
+            'canvas': {'px': [1920, 1080]},
+            'form_hint': {'form': 0},
+            'slides': [
+                {
+                    'part': slide_part,
+                    'layout': layout_part,
+                    'background': None,
+                },
+            ],
+            'background_composites': {},
+        }
+
+        with tempfile.TemporaryDirectory() as output_dir:
+            os.makedirs(os.path.join(output_dir, 'ref'))
+            with open(
+                os.path.join(output_dir, 'ref', 'shapes.json'),
+                'w',
+                encoding='utf-8',
+            ) as stream:
+                json.dump({'shapes': shapes}, stream)
+            archetypes, _, _ = draft_layouts(data, output_dir)
+
+        self.assertEqual(len(archetypes), 1)
+        self.assertEqual(len(archetypes[0]['slots']), 1)
+        slot = archetypes[0]['slots'][0]
+        self.assertEqual(slot['box'], [120, 80, 840, 120])
+        self.assertEqual(slot['txt'], 'Example heading')
+        self.assertEqual(slot['role'], 'body')
+        self.assertEqual(slot['type'], 'body')
+        self.assertTrue(slot['_needs_role'])
+        self.assertIn('font-size: 48px', slot['css'])
+        self.assertIn('font-weight: 600', slot['css'])
+        self.assertIn('color: #C41230', slot['css'])
+
+    def test_text_role_judgement_changes_semantics_without_dropping_slot(self):
+        archetype = {
+            'name': 'layout-1',
+            'zh': None,
+            'role': 'content',
+            'bg': None,
+            'slots': [
+                {
+                    'role': 'body',
+                    'type': 'body',
+                    'box': [120, 80, 840, 120],
+                    'sz': 48,
+                    'txt': 'Example heading',
+                    'css': 'font-size: 48px; color: #C41230',
+                    '_needs_role': True,
+                    '_source_layer': 'layout',
+                    '_placeholder': 'body/10',
+                },
+            ],
+            'decor': [],
+            'pages': [1],
+            'rep': 1,
+            'pic_n': 0,
+            'confidence': 'low',
+        }
+
+        with tempfile.TemporaryDirectory() as output_dir:
+            emit_layouts([archetype], output_dir)
+            path = os.path.join(output_dir, 'layouts.yaml')
+            with open(path, encoding='utf-8') as stream:
+                draft = stream.read()
+
+        self.assertIn('text_roles:', draft)
+        self.assertIn(
+            'layout-1-text-1: TODO文本角色',
+            draft,
+        )
+        self.assertEqual(draft.count('box: [120, 80, 840, 120]'), 1)
+
+        decided = draft.replace(
+            'layout-1-text-1: TODO文本角色',
+            'layout-1-text-1: title',
+        )
+        layouts_md = build_layouts_md(split_top_blocks(decided), (1920, 1080))
+
+        self.assertNotIn('text_roles:', layouts_md)
+        self.assertEqual(layouts_md.count('box: [120, 80, 840, 120]'), 1)
+        self.assertIn(
+            'role: title, box: [120, 80, 840, 120], type: title',
+            layouts_md,
+        )
+        self.assertIn('css: "font-size: 48px; color: #C41230"', layouts_md)
+
+
+if __name__ == '__main__':
+    unittest.main()

package/steering/design-html/skills/pptx-style-extract/scripts/verify_font.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python3
+"""字体镜像可加载性验证（L4 固定流程的脚本形态）。
+
+    python3 verify_font.py "Noto Sans SC" [--wght "400;500;600;700"] [--repeat 2]
+
+对 https://miaoda.feishu.cn/fonts/css2 请求 N 次（镜像多字重响应不稳定，默认复测 2 次），
+解析每次返回的 @font-face font-weight 集合，输出：
+
+  run 1: 400,500,600,700
+  run 2: 400
+  verdict: usable=400  unstable=500,600,700
+
+usable = 每次都返回的字重（可放心用）；unstable = 时有时无（按浏览器合成加粗处理并记 gaps）；
+全部请求失败 = 该族不可加载，走 font-fallback.yaml 降级。exit 0 = 至少一档 usable。
+"""
+import argparse
+import re
+import sys
+import urllib.parse
+import urllib.request
+
+MIRROR = 'https://miaoda.feishu.cn/fonts/css2'
+UA = ('Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 '
+      '(KHTML, like Gecko) Chrome/120.0 Safari/537.36')
+
+
+def fetch_weights(family, wght):
+    spec = family.replace(' ', '+') + (':wght@' + wght if wght else '')
+    url = '%s?%s&display=swap' % (MIRROR, urllib.parse.quote('family=' + spec, safe='=+&:;@'))
+    req = urllib.request.Request(url, headers={'User-Agent': UA})
+    with urllib.request.urlopen(req, timeout=15) as r:
+        css = r.read().decode('utf-8', 'replace')
+    if '@font-face' not in css:
+        return None
+    return sorted(set(re.findall(r'font-weight:\s*(\d+)', css)), key=int)
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('family')
+    ap.add_argument('--wght', default='400;500;600;700')
+    ap.add_argument('--repeat', type=int, default=2)
+    a = ap.parse_args()
+
+    runs = []
+    for i in range(a.repeat):
+        try:
+            w = fetch_weights(a.family, a.wght)
+        except Exception as exc:
+            w = None
+            print('run %d: 请求失败（%s）' % (i + 1, exc.__class__.__name__))
+            runs.append(set())
+            continue
+        print('run %d: %s' % (i + 1, ','.join(w) if w else '无 @font-face'))
+        runs.append(set(w or []))
+
+    usable = set.intersection(*runs) if runs else set()
+    unstable = set.union(*runs) - usable if runs else set()
+    if usable:
+        print('verdict: usable=%s%s' % (','.join(sorted(usable, key=int)),
+              '  unstable=' + ','.join(sorted(unstable, key=int)) if unstable else ''))
+        return 0
+    print('verdict: 不可加载 —— 查 font-fallback.yaml 降级，原始名留栈首 + 记 gaps')
+    return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())